@openlivesync/client 1.0.2 → 1.0.3

package/README.md

@@ -27,9 +27,10 @@ const client = createLiveSyncClient({
 });
 
 client.connect();
-client.joinRoom("room1", { name: "Alice", color: "#00f" });
-// Optional: pass access token so server can decode name/email (OAuth)
-// client.joinRoom("room1", { name: "Alice" }, accessToken);
+// Join with manual name/email (no token)
+client.joinRoom("room1", { color: "#00f" }, { name: "Alice", email: "alice@example.com" });
+// Or join with an access token so the server decodes name/email/provider (OAuth / OpenID)
+// client.joinRoom("room1", { color: "#00f" }, { accessToken });
 client.subscribe((state) => console.log(state.presence));
 
 client.updatePresence({ cursor: { x: 10, y: 20 } });
@@ -97,14 +98,23 @@ client.connect();
 ### Core (`@openlivesync/client`)
 
 - **`createLiveSyncClient(config)`** — Returns a client. Options: `url`, `reconnect?`, `reconnectIntervalMs?`, `maxReconnectIntervalMs?`, `getAuthToken?`, `presenceThrottleMs?`.
-- **Client methods**: `connect()`, `disconnect()`, `joinRoom(roomId, presence?, accessToken?)`, `leaveRoom(roomId?)`, `updatePresence(presence)`, `broadcastEvent(event, payload?)`, `sendChat(message, metadata?)`, `getState()`, `subscribe(listener)`. If you pass `accessToken`, the server (when configured with `auth`) decodes it and attaches name/email to your connection; other clients see them in presence. **Authenticate once at connect:** use only `getAuthToken` in config (token is sent in the URL at connect) and do **not** pass `accessToken` to `joinRoom` or `useRoom`; the server will recognize you for the connection lifetime.
+- **Client methods**: `connect()`, `disconnect()`, `joinRoom(roomId, presence?, identity?)`, `leaveRoom(roomId?)`, `updatePresence(presence)`, `broadcastEvent(event, payload?)`, `sendChat(message, metadata?)`, `getState()`, `subscribe(listener)`.
+  - **`identity`** is `{ accessToken?, name?, email? }`.
+    - If you pass an **`accessToken`**, the server (when configured with `auth`) decodes it and attaches `name`, `email`, and `provider` to your connection; other clients see them in presence.
+    - If you pass only **`name`/`email`** (no token), the server uses those values directly and shares them with other participants via `PresenceEntry`.
+    - If you pass both, the token takes priority (decoded claims win); if decoding fails, the server falls back to the provided `name`/`email`.
+  - **Authenticate once at connect (recommended):** use only `getAuthToken` in config (token is sent in the URL at connect) and do **not** pass `accessToken` to `joinRoom` or `useRoom`; the server will recognize you for the connection lifetime.
 
 ### React (`@openlivesync/client/react`)
 
 - **`LiveSyncProvider`** — Props: `client?` or `url?` (+ optional reconnect/auth/presence options). If `url` is provided, the provider creates the client and connects on mount.
 - **`useLiveSyncClient()`** — Returns the client from context.
 - **`useConnectionStatus()`** — Returns `"connecting" | "open" | "closing" | "closed"`.
-- **`useRoom(roomId, options?)`** — Returns `{ join, leave, updatePresence, broadcastEvent, presence, connectionId, isInRoom, currentRoomId }`. Options: `initialPresence?`, `autoJoin?`, `accessToken?`, `getAccessToken?`. With `autoJoin: true` (default), joins when `roomId` is set (using `accessToken` or `getAccessToken()` if provided) and leaves on unmount or when `roomId` changes. `join(roomId, presence?, accessToken?)` for manual join. For connect-only auth (token sent once at connect via provider's `getAuthToken`), omit `accessToken` and `getAccessToken` here.
+- **`useRoom(roomId, options?)`** — Returns `{ join, leave, updatePresence, broadcastEvent, presence, connectionId, isInRoom, currentRoomId }`.
+  - **Options**: `initialPresence?`, `autoJoin?`, `accessToken?`, `getAccessToken?`, `name?`, `email?`.
+    - With `autoJoin: true` (default), joins when `roomId` is set using an identity built from `{ accessToken (or getAccessToken()), name, email }` and leaves on unmount or when `roomId` changes.
+    - `join(roomId, presence?, identity?)` for manual join, where `identity` is `{ accessToken?, name?, email? }`.
+    - For connect-only auth (token sent once at connect via provider's `getAuthToken`), omit `accessToken`, `getAccessToken`, and `identity.accessToken` here and rely on the connection identity established at upgrade.
 - **`usePresence(roomId)`** — Returns the presence map for the current room.
 - **`useChat(roomId)`** — Returns `{ messages, sendMessage }`.
 

package/dist/{chunk-MINJGWLX.js → chunk-TAMQSVU2.js}

@@ -40,6 +40,7 @@ function createLiveSyncClient(config) {
   let intentionalClose = false;
   let lastPresenceUpdate = 0;
   let pendingPresence = null;
+  let lastJoinIdentity = null;
   const state = {
     connectionStatus: "closed",
     currentRoomId: null,
@@ -159,7 +160,13 @@ function createLiveSyncClient(config) {
     const roomId = state.currentRoomId;
     if (!roomId) return;
     const presence = pendingPresence ?? (state.connectionId ? state.presence[state.connectionId]?.presence : void 0);
-    send({ type: MSG_JOIN_ROOM, payload: { roomId, presence } });
+    const identity = lastJoinIdentity;
+    const payload = { roomId };
+    if (presence !== void 0) payload.presence = presence;
+    if (identity?.accessToken !== void 0) payload.accessToken = identity.accessToken;
+    if (identity?.name !== void 0) payload.name = identity.name;
+    if (identity?.email !== void 0) payload.email = identity.email;
+    send({ type: MSG_JOIN_ROOM, payload });
   }
   function connect() {
     if (ws?.readyState === WebSocket.OPEN || ws?.readyState === WebSocket.CONNECTING) {
@@ -226,7 +233,7 @@ function createLiveSyncClient(config) {
     }
     setStatus("closed");
   }
-  function joinRoom(roomId, presence, accessToken) {
+  function joinRoom(roomId, presence, identity) {
     if (state.currentRoomId) {
       send({ type: MSG_LEAVE_ROOM, payload: { roomId: state.currentRoomId } });
     }
@@ -234,9 +241,12 @@ function createLiveSyncClient(config) {
     state.presence = {};
     state.chatMessages = [];
     pendingPresence = presence ?? null;
+    lastJoinIdentity = identity ?? null;
     const payload = { roomId };
     if (presence !== void 0) payload.presence = presence;
-    if (accessToken !== void 0) payload.accessToken = accessToken;
+    if (identity?.accessToken !== void 0) payload.accessToken = identity.accessToken;
+    if (identity?.name !== void 0) payload.name = identity.name;
+    if (identity?.email !== void 0) payload.email = identity.email;
     send({ type: MSG_JOIN_ROOM, payload });
     emit();
   }
@@ -308,4 +318,4 @@ export {
   MSG_ERROR,
   createLiveSyncClient
 };
-//# sourceMappingURL=chunk-MINJGWLX.js.map
+//# sourceMappingURL=chunk-TAMQSVU2.js.map

package/dist/chunk-TAMQSVU2.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/protocol.ts","../src/client.ts"],"sourcesContent":["/**\n * Wire protocol types for @openlivesync/client.\n * Must stay in sync with @openlivesync/server protocol (same message types and payload shapes).\n */\n\n/** Generic presence payload (cursor, name, color, etc.). Server does not interpret. */\nexport type Presence = Record<string, unknown>;\n\n/** User/session info attached by server from auth (optional). */\nexport interface UserInfo {\n  userId?: string;\n  name?: string;\n  email?: string;\n  provider?: string;\n  [key: string]: unknown;\n}\n\n// ----- Client → Server message types -----\n\nexport const MSG_JOIN_ROOM = \"join_room\";\nexport const MSG_LEAVE_ROOM = \"leave_room\";\nexport const MSG_UPDATE_PRESENCE = \"update_presence\";\nexport const MSG_BROADCAST_EVENT = \"broadcast_event\";\nexport const MSG_SEND_CHAT = \"send_chat\";\n\nexport interface JoinRoomPayload {\n  roomId: string;\n  presence?: Presence;\n  /** Optional OAuth/OpenID access token; server decodes to get name, email, provider. */\n  accessToken?: string;\n  /** Optional display name if not using accessToken. */\n  name?: string;\n  /** Optional email if not using accessToken. */\n  email?: string;\n}\n\nexport interface LeaveRoomPayload {\n  roomId?: string;\n}\n\nexport interface UpdatePresencePayload {\n  presence: Presence;\n}\n\nexport interface BroadcastEventPayload {\n  event: string;\n  payload?: unknown;\n}\n\nexport interface SendChatPayload {\n  message: string;\n  /** Optional application-defined metadata */\n  metadata?: Record<string, unknown>;\n}\n\nexport type ClientMessage =\n  | { type: typeof MSG_JOIN_ROOM; payload: JoinRoomPayload }\n  | { type: typeof MSG_LEAVE_ROOM; payload?: LeaveRoomPayload }\n  | { type: typeof MSG_UPDATE_PRESENCE; payload: UpdatePresencePayload }\n  | { type: typeof MSG_BROADCAST_EVENT; payload: BroadcastEventPayload }\n  | { type: typeof MSG_SEND_CHAT; payload: SendChatPayload };\n\n// ----- Server → Client message types -----\n\nexport const MSG_ROOM_JOINED = \"room_joined\";\nexport const MSG_PRESENCE_UPDATED = \"presence_updated\";\nexport const MSG_BROADCAST_EVENT_RELAY = \"broadcast_event\";\nexport const MSG_CHAT_MESSAGE = \"chat_message\";\nexport const MSG_ERROR = \"error\";\n\nexport interface PresenceEntry {\n  connectionId: string;\n  userId?: string;\n  name?: string;\n  email?: string;\n  provider?: string;\n  presence: Presence;\n}\n\nexport interface RoomJoinedPayload {\n  roomId: string;\n  connectionId: string;\n  presence: Record<string, PresenceEntry>;\n  chatHistory?: StoredChatMessage[];\n}\n\nexport interface PresenceUpdatedPayload {\n  roomId: string;\n  joined?: PresenceEntry[];\n  left?: string[];\n  updated?: PresenceEntry[];\n}\n\nexport interface BroadcastEventRelayPayload {\n  roomId: string;\n  connectionId: string;\n  userId?: string;\n  event: string;\n  payload?: unknown;\n}\n\nexport interface ChatMessagePayload {\n  roomId: string;\n  connectionId: string;\n  userId?: string;\n  message: string;\n  metadata?: Record<string, unknown>;\n  id?: string;\n  createdAt?: number;\n}\n\nexport interface StoredChatMessage {\n  id: string;\n  roomId: string;\n  connectionId: string;\n  userId?: string;\n  message: string;\n  metadata?: Record<string, unknown>;\n  createdAt: number;\n}\n\nexport interface ErrorPayload {\n  code: string;\n  message: string;\n}\n\nexport type ServerMessage =\n  | { type: typeof MSG_ROOM_JOINED; payload: RoomJoinedPayload }\n  | { type: typeof MSG_PRESENCE_UPDATED; payload: PresenceUpdatedPayload }\n  | { type: typeof MSG_BROADCAST_EVENT_RELAY; payload: BroadcastEventRelayPayload }\n  | { type: typeof MSG_CHAT_MESSAGE; payload: ChatMessagePayload }\n  | { type: typeof MSG_ERROR; payload: ErrorPayload };\n\n/** Chat message as provided when appending (before storage adds id/createdAt). */\nexport interface ChatMessageInput {\n  roomId: string;\n  connectionId: string;\n  userId?: string;\n  message: string;\n  metadata?: Record<string, unknown>;\n}\n","/**\n * Core WebSocket client for @openlivesync.\n * Connects to @openlivesync/server, manages room/presence/chat state, and notifies subscribers.\n */\n\nimport type {\n  ClientMessage,\n  ServerMessage,\n  Presence,\n  PresenceEntry,\n  StoredChatMessage,\n  JoinRoomPayload,\n} from \"./protocol.js\";\nimport {\n  MSG_JOIN_ROOM,\n  MSG_LEAVE_ROOM,\n  MSG_UPDATE_PRESENCE,\n  MSG_BROADCAST_EVENT,\n  MSG_SEND_CHAT,\n  MSG_ROOM_JOINED,\n  MSG_PRESENCE_UPDATED,\n  MSG_BROADCAST_EVENT_RELAY,\n  MSG_CHAT_MESSAGE,\n  MSG_ERROR,\n} from \"./protocol.js\";\n\nexport type ConnectionStatus = \"connecting\" | \"open\" | \"closing\" | \"closed\";\n\nexport interface LiveSyncClientState {\n  connectionStatus: ConnectionStatus;\n  currentRoomId: string | null;\n  connectionId: string | null;\n  presence: Record<string, PresenceEntry>;\n  chatMessages: StoredChatMessage[];\n  lastError: { code: string; message: string } | null;\n}\n\nexport interface JoinRoomIdentity {\n  /** Optional display name if not using accessToken. */\n  name?: string;\n  /** Optional email if not using accessToken. */\n  email?: string;\n  /** Optional OAuth/OpenID access token; server decodes to get name, email, provider. */\n  accessToken?: string;\n}\n\nexport interface LiveSyncClientConfig {\n  /** WebSocket URL (e.g. wss://host/live). */\n  url: string;\n  /** Auto-reconnect on close (default true). */\n  reconnect?: boolean;\n  /** Initial reconnect delay in ms (default 1000). */\n  reconnectIntervalMs?: number;\n  /** Max reconnect delay in ms (default 30000). */\n  maxReconnectIntervalMs?: number;\n  /** Optional: return token for auth; appended as query param (e.g. ?access_token=). */\n  getAuthToken?: () => string | Promise<string>;\n  /** Throttle presence updates in ms (default 100, match server). */\n  presenceThrottleMs?: number;\n}\n\nconst DEFAULT_RECONNECT_INTERVAL_MS = 1000;\nconst DEFAULT_MAX_RECONNECT_INTERVAL_MS = 30000;\nconst DEFAULT_PRESENCE_THROTTLE_MS = 100;\n\nfunction isServerMessage(msg: unknown): msg is ServerMessage {\n  if (msg === null || typeof msg !== \"object\" || !(\"type\" in msg)) return false;\n  const t = (msg as { type: string }).type;\n  return [\n    MSG_ROOM_JOINED,\n    MSG_PRESENCE_UPDATED,\n    MSG_BROADCAST_EVENT_RELAY,\n    MSG_CHAT_MESSAGE,\n    MSG_ERROR,\n  ].includes(t);\n}\n\nexport interface LiveSyncClient {\n  connect(): void;\n  disconnect(): void;\n  joinRoom(roomId: string, presence?: Presence, identity?: JoinRoomIdentity): void;\n  leaveRoom(roomId?: string): void;\n  updatePresence(presence: Presence): void;\n  broadcastEvent(event: string, payload?: unknown): void;\n  sendChat(message: string, metadata?: Record<string, unknown>): void;\n  getConnectionStatus(): ConnectionStatus;\n  getPresence(): Record<string, PresenceEntry>;\n  getChatMessages(): StoredChatMessage[];\n  getCurrentRoomId(): string | null;\n  getState(): LiveSyncClientState;\n  subscribe(listener: (state: LiveSyncClientState) => void): () => void;\n}\n\nexport function createLiveSyncClient(config: LiveSyncClientConfig): LiveSyncClient {\n  const {\n    url: baseUrl,\n    reconnect: reconnectEnabled = true,\n    reconnectIntervalMs = DEFAULT_RECONNECT_INTERVAL_MS,\n    maxReconnectIntervalMs = DEFAULT_MAX_RECONNECT_INTERVAL_MS,\n    getAuthToken,\n    presenceThrottleMs = DEFAULT_PRESENCE_THROTTLE_MS,\n  } = config;\n\n  let ws: WebSocket | null = null;\n  let reconnectTimeoutId: ReturnType<typeof setTimeout> | null = null;\n  let nextReconnectMs = reconnectIntervalMs;\n  let intentionalClose = false;\n  let lastPresenceUpdate = 0;\n  let pendingPresence: Presence | null = null;\n  let lastJoinIdentity: JoinRoomIdentity | null = null;\n\n  const state: LiveSyncClientState = {\n    connectionStatus: \"closed\",\n    currentRoomId: null,\n    connectionId: null,\n    presence: {},\n    chatMessages: [],\n    lastError: null,\n  };\n\n  const listeners = new Set<(s: LiveSyncClientState) => void>();\n\n  function emit() {\n    const snapshot: LiveSyncClientState = {\n      connectionStatus: state.connectionStatus,\n      currentRoomId: state.currentRoomId,\n      connectionId: state.connectionId,\n      presence: { ...state.presence },\n      chatMessages: [...state.chatMessages],\n      lastError: state.lastError ? { ...state.lastError } : null,\n    };\n    listeners.forEach((cb) => cb(snapshot));\n  }\n\n  function setStatus(status: ConnectionStatus) {\n    state.connectionStatus = status;\n    emit();\n  }\n\n  function send(msg: ClientMessage) {\n    if (!ws || ws.readyState !== WebSocket.OPEN) return;\n    ws.send(JSON.stringify(msg));\n  }\n\n  function clearReconnect() {\n    if (reconnectTimeoutId !== null) {\n      clearTimeout(reconnectTimeoutId);\n      reconnectTimeoutId = null;\n    }\n    nextReconnectMs = reconnectIntervalMs;\n  }\n\n  function scheduleReconnect() {\n    if (!reconnectEnabled || intentionalClose) return;\n    clearReconnect();\n    reconnectTimeoutId = setTimeout(() => {\n      reconnectTimeoutId = null;\n      nextReconnectMs = Math.min(\n        nextReconnectMs * 2,\n        maxReconnectIntervalMs\n      );\n      connect();\n    }, nextReconnectMs);\n  }\n\n  function applyPresenceUpdated(\n    joined?: PresenceEntry[],\n    left?: string[],\n    updated?: PresenceEntry[]\n  ) {\n    if (joined) {\n      for (const e of joined) state.presence[e.connectionId] = e;\n    }\n    if (left) {\n      for (const id of left) delete state.presence[id];\n    }\n    if (updated) {\n      for (const e of updated) state.presence[e.connectionId] = e;\n    }\n    emit();\n  }\n\n  function handleMessage(data: string) {\n    let msg: unknown;\n    try {\n      msg = JSON.parse(data) as unknown;\n    } catch {\n      state.lastError = { code: \"INVALID_JSON\", message: \"Invalid JSON from server\" };\n      emit();\n      return;\n    }\n    if (!isServerMessage(msg)) {\n      state.lastError = { code: \"UNKNOWN_MESSAGE\", message: \"Unknown message type\" };\n      emit();\n      return;\n    }\n    switch (msg.type) {\n      case MSG_ROOM_JOINED: {\n        const { roomId, connectionId, presence, chatHistory } = msg.payload;\n        state.currentRoomId = roomId;\n        state.connectionId = connectionId;\n        state.presence = presence ?? {};\n        state.chatMessages = chatHistory ?? [];\n        state.lastError = null;\n        emit();\n        break;\n      }\n      case MSG_PRESENCE_UPDATED: {\n        const { joined, left, updated } = msg.payload;\n        applyPresenceUpdated(joined, left, updated);\n        break;\n      }\n      case MSG_BROADCAST_EVENT_RELAY:\n        // Application can subscribe to custom events if we add an event emitter; for now we only update state for presence/chat.\n        break;\n      case MSG_CHAT_MESSAGE: {\n        const p = msg.payload;\n        const stored: StoredChatMessage = {\n          id: p.id ?? `${p.connectionId}-${p.createdAt ?? Date.now()}`,\n          roomId: p.roomId,\n          connectionId: p.connectionId,\n          userId: p.userId,\n          message: p.message,\n          metadata: p.metadata,\n          createdAt: p.createdAt ?? Date.now(),\n        };\n        if (state.currentRoomId === p.roomId) {\n          state.chatMessages = [...state.chatMessages, stored];\n          emit();\n        }\n        break;\n      }\n      case MSG_ERROR: {\n        state.lastError = msg.payload;\n        emit();\n        break;\n      }\n    }\n  }\n\n  function reconnectAndRejoin() {\n    const roomId = state.currentRoomId;\n    if (!roomId) return;\n    const presence = pendingPresence ?? (state.connectionId ? state.presence[state.connectionId]?.presence : undefined);\n    const identity = lastJoinIdentity;\n    const payload: JoinRoomPayload = { roomId };\n    if (presence !== undefined) payload.presence = presence;\n    if (identity?.accessToken !== undefined) payload.accessToken = identity.accessToken;\n    if (identity?.name !== undefined) payload.name = identity.name;\n    if (identity?.email !== undefined) payload.email = identity.email;\n    send({ type: MSG_JOIN_ROOM, payload });\n  }\n\n  function connect() {\n    if (ws?.readyState === WebSocket.OPEN || ws?.readyState === WebSocket.CONNECTING) {\n      return;\n    }\n    intentionalClose = false;\n    setStatus(\"connecting\");\n\n    (async () => {\n      let url = baseUrl;\n      if (getAuthToken) {\n        try {\n          const token = await getAuthToken();\n          if (token) {\n            const sep = baseUrl.includes(\"?\") ? \"&\" : \"?\";\n            url = `${baseUrl}${sep}access_token=${encodeURIComponent(token)}`;\n          }\n        } catch (e) {\n          state.lastError = {\n            code: \"AUTH_ERROR\",\n            message: e instanceof Error ? e.message : String(e),\n          };\n          setStatus(\"closed\");\n          emit();\n          return;\n        }\n      }\n\n      ws = new WebSocket(url);\n\n      ws.onopen = () => {\n        setStatus(\"open\");\n        nextReconnectMs = reconnectIntervalMs;\n        reconnectAndRejoin();\n      };\n\n      ws.onmessage = (event) => {\n        const data = typeof event.data === \"string\" ? event.data : event.data.toString();\n        handleMessage(data);\n      };\n\n      ws.onclose = () => {\n        ws = null;\n        setStatus(\"closed\");\n        if (!intentionalClose) {\n          scheduleReconnect();\n        } else {\n          clearReconnect();\n        }\n      };\n\n      ws.onerror = () => {\n        state.lastError = { code: \"WEBSOCKET_ERROR\", message: \"WebSocket error\" };\n        emit();\n      };\n    })();\n  }\n\n  function disconnect() {\n    intentionalClose = true;\n    clearReconnect();\n    state.currentRoomId = null;\n    state.connectionId = null;\n    state.presence = {};\n    state.chatMessages = [];\n    pendingPresence = null;\n    if (ws) {\n      setStatus(\"closing\");\n      ws.close();\n      ws = null;\n    }\n    setStatus(\"closed\");\n  }\n\n  function joinRoom(roomId: string, presence?: Presence, identity?: JoinRoomIdentity) {\n    if (state.currentRoomId) {\n      send({ type: MSG_LEAVE_ROOM, payload: { roomId: state.currentRoomId } });\n    }\n    state.currentRoomId = roomId;\n    state.presence = {};\n    state.chatMessages = [];\n    pendingPresence = presence ?? null;\n    lastJoinIdentity = identity ?? null;\n    const payload: JoinRoomPayload = { roomId };\n    if (presence !== undefined) payload.presence = presence;\n    if (identity?.accessToken !== undefined) payload.accessToken = identity.accessToken;\n    if (identity?.name !== undefined) payload.name = identity.name;\n    if (identity?.email !== undefined) payload.email = identity.email;\n    send({ type: MSG_JOIN_ROOM, payload });\n    emit();\n  }\n\n  function leaveRoom(roomId?: string) {\n    const target = roomId ?? state.currentRoomId;\n    if (target) {\n      send({ type: MSG_LEAVE_ROOM, payload: { roomId: target } });\n      if (target === state.currentRoomId) {\n        state.currentRoomId = null;\n        state.connectionId = null;\n        state.presence = {};\n        state.chatMessages = [];\n        pendingPresence = null;\n      }\n      emit();\n    }\n  }\n\n  function updatePresence(presence: Presence) {\n    pendingPresence = presence;\n    const now = Date.now();\n    if (now - lastPresenceUpdate < presenceThrottleMs) return;\n    lastPresenceUpdate = now;\n    send({ type: MSG_UPDATE_PRESENCE, payload: { presence } });\n  }\n\n  function broadcastEvent(event: string, payload?: unknown) {\n    send({ type: MSG_BROADCAST_EVENT, payload: { event, payload } });\n  }\n\n  function sendChat(message: string, metadata?: Record<string, unknown>) {\n    send({ type: MSG_SEND_CHAT, payload: { message, metadata } });\n  }\n\n  function subscribe(listener: (state: LiveSyncClientState) => void): () => void {\n    listeners.add(listener);\n    return () => listeners.delete(listener);\n  }\n\n  return {\n    connect,\n    disconnect,\n    joinRoom,\n    leaveRoom,\n    updatePresence,\n    broadcastEvent,\n    sendChat,\n    getConnectionStatus: () => state.connectionStatus,\n    getPresence: () => ({ ...state.presence }),\n    getChatMessages: () => [...state.chatMessages],\n    getCurrentRoomId: () => state.currentRoomId,\n    getState: () => ({\n      connectionStatus: state.connectionStatus,\n      currentRoomId: state.currentRoomId,\n      connectionId: state.connectionId,\n      presence: { ...state.presence },\n      chatMessages: [...state.chatMessages],\n      lastError: state.lastError ? { ...state.lastError } : null,\n    }),\n    subscribe,\n  };\n}\n"],"mappings":"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","names":[]}

package/dist/index-HY9A86VV.d.ts

@@ -0,0 +1,196 @@
+/**
+ * Wire protocol types for @openlivesync/client.
+ * Must stay in sync with @openlivesync/server protocol (same message types and payload shapes).
+ */
+/** Generic presence payload (cursor, name, color, etc.). Server does not interpret. */
+type Presence = Record<string, unknown>;
+/** User/session info attached by server from auth (optional). */
+interface UserInfo {
+    userId?: string;
+    name?: string;
+    email?: string;
+    provider?: string;
+    [key: string]: unknown;
+}
+declare const MSG_JOIN_ROOM = "join_room";
+declare const MSG_LEAVE_ROOM = "leave_room";
+declare const MSG_UPDATE_PRESENCE = "update_presence";
+declare const MSG_BROADCAST_EVENT = "broadcast_event";
+declare const MSG_SEND_CHAT = "send_chat";
+interface JoinRoomPayload {
+    roomId: string;
+    presence?: Presence;
+    /** Optional OAuth/OpenID access token; server decodes to get name, email, provider. */
+    accessToken?: string;
+    /** Optional display name if not using accessToken. */
+    name?: string;
+    /** Optional email if not using accessToken. */
+    email?: string;
+}
+interface LeaveRoomPayload {
+    roomId?: string;
+}
+interface UpdatePresencePayload {
+    presence: Presence;
+}
+interface BroadcastEventPayload {
+    event: string;
+    payload?: unknown;
+}
+interface SendChatPayload {
+    message: string;
+    /** Optional application-defined metadata */
+    metadata?: Record<string, unknown>;
+}
+type ClientMessage = {
+    type: typeof MSG_JOIN_ROOM;
+    payload: JoinRoomPayload;
+} | {
+    type: typeof MSG_LEAVE_ROOM;
+    payload?: LeaveRoomPayload;
+} | {
+    type: typeof MSG_UPDATE_PRESENCE;
+    payload: UpdatePresencePayload;
+} | {
+    type: typeof MSG_BROADCAST_EVENT;
+    payload: BroadcastEventPayload;
+} | {
+    type: typeof MSG_SEND_CHAT;
+    payload: SendChatPayload;
+};
+declare const MSG_ROOM_JOINED = "room_joined";
+declare const MSG_PRESENCE_UPDATED = "presence_updated";
+declare const MSG_BROADCAST_EVENT_RELAY = "broadcast_event";
+declare const MSG_CHAT_MESSAGE = "chat_message";
+declare const MSG_ERROR = "error";
+interface PresenceEntry {
+    connectionId: string;
+    userId?: string;
+    name?: string;
+    email?: string;
+    provider?: string;
+    presence: Presence;
+}
+interface RoomJoinedPayload {
+    roomId: string;
+    connectionId: string;
+    presence: Record<string, PresenceEntry>;
+    chatHistory?: StoredChatMessage[];
+}
+interface PresenceUpdatedPayload {
+    roomId: string;
+    joined?: PresenceEntry[];
+    left?: string[];
+    updated?: PresenceEntry[];
+}
+interface BroadcastEventRelayPayload {
+    roomId: string;
+    connectionId: string;
+    userId?: string;
+    event: string;
+    payload?: unknown;
+}
+interface ChatMessagePayload {
+    roomId: string;
+    connectionId: string;
+    userId?: string;
+    message: string;
+    metadata?: Record<string, unknown>;
+    id?: string;
+    createdAt?: number;
+}
+interface StoredChatMessage {
+    id: string;
+    roomId: string;
+    connectionId: string;
+    userId?: string;
+    message: string;
+    metadata?: Record<string, unknown>;
+    createdAt: number;
+}
+interface ErrorPayload {
+    code: string;
+    message: string;
+}
+type ServerMessage = {
+    type: typeof MSG_ROOM_JOINED;
+    payload: RoomJoinedPayload;
+} | {
+    type: typeof MSG_PRESENCE_UPDATED;
+    payload: PresenceUpdatedPayload;
+} | {
+    type: typeof MSG_BROADCAST_EVENT_RELAY;
+    payload: BroadcastEventRelayPayload;
+} | {
+    type: typeof MSG_CHAT_MESSAGE;
+    payload: ChatMessagePayload;
+} | {
+    type: typeof MSG_ERROR;
+    payload: ErrorPayload;
+};
+/** Chat message as provided when appending (before storage adds id/createdAt). */
+interface ChatMessageInput {
+    roomId: string;
+    connectionId: string;
+    userId?: string;
+    message: string;
+    metadata?: Record<string, unknown>;
+}
+
+/**
+ * Core WebSocket client for @openlivesync.
+ * Connects to @openlivesync/server, manages room/presence/chat state, and notifies subscribers.
+ */
+
+type ConnectionStatus = "connecting" | "open" | "closing" | "closed";
+interface LiveSyncClientState {
+    connectionStatus: ConnectionStatus;
+    currentRoomId: string | null;
+    connectionId: string | null;
+    presence: Record<string, PresenceEntry>;
+    chatMessages: StoredChatMessage[];
+    lastError: {
+        code: string;
+        message: string;
+    } | null;
+}
+interface JoinRoomIdentity {
+    /** Optional display name if not using accessToken. */
+    name?: string;
+    /** Optional email if not using accessToken. */
+    email?: string;
+    /** Optional OAuth/OpenID access token; server decodes to get name, email, provider. */
+    accessToken?: string;
+}
+interface LiveSyncClientConfig {
+    /** WebSocket URL (e.g. wss://host/live). */
+    url: string;
+    /** Auto-reconnect on close (default true). */
+    reconnect?: boolean;
+    /** Initial reconnect delay in ms (default 1000). */
+    reconnectIntervalMs?: number;
+    /** Max reconnect delay in ms (default 30000). */
+    maxReconnectIntervalMs?: number;
+    /** Optional: return token for auth; appended as query param (e.g. ?access_token=). */
+    getAuthToken?: () => string | Promise<string>;
+    /** Throttle presence updates in ms (default 100, match server). */
+    presenceThrottleMs?: number;
+}
+interface LiveSyncClient {
+    connect(): void;
+    disconnect(): void;
+    joinRoom(roomId: string, presence?: Presence, identity?: JoinRoomIdentity): void;
+    leaveRoom(roomId?: string): void;
+    updatePresence(presence: Presence): void;
+    broadcastEvent(event: string, payload?: unknown): void;
+    sendChat(message: string, metadata?: Record<string, unknown>): void;
+    getConnectionStatus(): ConnectionStatus;
+    getPresence(): Record<string, PresenceEntry>;
+    getChatMessages(): StoredChatMessage[];
+    getCurrentRoomId(): string | null;
+    getState(): LiveSyncClientState;
+    subscribe(listener: (state: LiveSyncClientState) => void): () => void;
+}
+declare function createLiveSyncClient(config: LiveSyncClientConfig): LiveSyncClient;
+
+export { type BroadcastEventPayload as B, type ChatMessageInput as C, type ErrorPayload as E, type JoinRoomIdentity as J, type LiveSyncClient as L, MSG_BROADCAST_EVENT as M, type Presence as P, type RoomJoinedPayload as R, type StoredChatMessage as S, type UpdatePresencePayload as U, type PresenceEntry as a, type LiveSyncClientState as b, type BroadcastEventRelayPayload as c, type ChatMessagePayload as d, type ClientMessage as e, type ConnectionStatus as f, type JoinRoomPayload as g, type LeaveRoomPayload as h, type LiveSyncClientConfig as i, MSG_BROADCAST_EVENT_RELAY as j, MSG_CHAT_MESSAGE as k, MSG_ERROR as l, MSG_JOIN_ROOM as m, MSG_LEAVE_ROOM as n, MSG_PRESENCE_UPDATED as o, MSG_ROOM_JOINED as p, MSG_SEND_CHAT as q, MSG_UPDATE_PRESENCE as r, type PresenceUpdatedPayload as s, type SendChatPayload as t, type ServerMessage as u, type UserInfo as v, createLiveSyncClient as w };

package/dist/index.d.ts

@@ -1,184 +1 @@
-/**
- * Wire protocol types for @openlivesync/client.
- * Must stay in sync with @openlivesync/server protocol (same message types and payload shapes).
- */
-/** Generic presence payload (cursor, name, color, etc.). Server does not interpret. */
-type Presence = Record<string, unknown>;
-/** User/session info attached by server from auth (optional). */
-interface UserInfo {
-    userId?: string;
-    name?: string;
-    email?: string;
-    provider?: string;
-    [key: string]: unknown;
-}
-declare const MSG_JOIN_ROOM = "join_room";
-declare const MSG_LEAVE_ROOM = "leave_room";
-declare const MSG_UPDATE_PRESENCE = "update_presence";
-declare const MSG_BROADCAST_EVENT = "broadcast_event";
-declare const MSG_SEND_CHAT = "send_chat";
-interface JoinRoomPayload {
-    roomId: string;
-    presence?: Presence;
-    /** Optional OAuth/OpenID access token; server decodes to get name, email, provider. */
-    accessToken?: string;
-}
-interface LeaveRoomPayload {
-    roomId?: string;
-}
-interface UpdatePresencePayload {
-    presence: Presence;
-}
-interface BroadcastEventPayload {
-    event: string;
-    payload?: unknown;
-}
-interface SendChatPayload {
-    message: string;
-    /** Optional application-defined metadata */
-    metadata?: Record<string, unknown>;
-}
-type ClientMessage = {
-    type: typeof MSG_JOIN_ROOM;
-    payload: JoinRoomPayload;
-} | {
-    type: typeof MSG_LEAVE_ROOM;
-    payload?: LeaveRoomPayload;
-} | {
-    type: typeof MSG_UPDATE_PRESENCE;
-    payload: UpdatePresencePayload;
-} | {
-    type: typeof MSG_BROADCAST_EVENT;
-    payload: BroadcastEventPayload;
-} | {
-    type: typeof MSG_SEND_CHAT;
-    payload: SendChatPayload;
-};
-declare const MSG_ROOM_JOINED = "room_joined";
-declare const MSG_PRESENCE_UPDATED = "presence_updated";
-declare const MSG_BROADCAST_EVENT_RELAY = "broadcast_event";
-declare const MSG_CHAT_MESSAGE = "chat_message";
-declare const MSG_ERROR = "error";
-interface PresenceEntry {
-    connectionId: string;
-    userId?: string;
-    name?: string;
-    email?: string;
-    provider?: string;
-    presence: Presence;
-}
-interface RoomJoinedPayload {
-    roomId: string;
-    connectionId: string;
-    presence: Record<string, PresenceEntry>;
-    chatHistory?: StoredChatMessage[];
-}
-interface PresenceUpdatedPayload {
-    roomId: string;
-    joined?: PresenceEntry[];
-    left?: string[];
-    updated?: PresenceEntry[];
-}
-interface BroadcastEventRelayPayload {
-    roomId: string;
-    connectionId: string;
-    userId?: string;
-    event: string;
-    payload?: unknown;
-}
-interface ChatMessagePayload {
-    roomId: string;
-    connectionId: string;
-    userId?: string;
-    message: string;
-    metadata?: Record<string, unknown>;
-    id?: string;
-    createdAt?: number;
-}
-interface StoredChatMessage {
-    id: string;
-    roomId: string;
-    connectionId: string;
-    userId?: string;
-    message: string;
-    metadata?: Record<string, unknown>;
-    createdAt: number;
-}
-interface ErrorPayload {
-    code: string;
-    message: string;
-}
-type ServerMessage = {
-    type: typeof MSG_ROOM_JOINED;
-    payload: RoomJoinedPayload;
-} | {
-    type: typeof MSG_PRESENCE_UPDATED;
-    payload: PresenceUpdatedPayload;
-} | {
-    type: typeof MSG_BROADCAST_EVENT_RELAY;
-    payload: BroadcastEventRelayPayload;
-} | {
-    type: typeof MSG_CHAT_MESSAGE;
-    payload: ChatMessagePayload;
-} | {
-    type: typeof MSG_ERROR;
-    payload: ErrorPayload;
-};
-/** Chat message as provided when appending (before storage adds id/createdAt). */
-interface ChatMessageInput {
-    roomId: string;
-    connectionId: string;
-    userId?: string;
-    message: string;
-    metadata?: Record<string, unknown>;
-}
-
-/**
- * Core WebSocket client for @openlivesync.
- * Connects to @openlivesync/server, manages room/presence/chat state, and notifies subscribers.
- */
-
-type ConnectionStatus = "connecting" | "open" | "closing" | "closed";
-interface LiveSyncClientState {
-    connectionStatus: ConnectionStatus;
-    currentRoomId: string | null;
-    connectionId: string | null;
-    presence: Record<string, PresenceEntry>;
-    chatMessages: StoredChatMessage[];
-    lastError: {
-        code: string;
-        message: string;
-    } | null;
-}
-interface LiveSyncClientConfig {
-    /** WebSocket URL (e.g. wss://host/live). */
-    url: string;
-    /** Auto-reconnect on close (default true). */
-    reconnect?: boolean;
-    /** Initial reconnect delay in ms (default 1000). */
-    reconnectIntervalMs?: number;
-    /** Max reconnect delay in ms (default 30000). */
-    maxReconnectIntervalMs?: number;
-    /** Optional: return token for auth; appended as query param (e.g. ?access_token=). */
-    getAuthToken?: () => string | Promise<string>;
-    /** Throttle presence updates in ms (default 100, match server). */
-    presenceThrottleMs?: number;
-}
-interface LiveSyncClient {
-    connect(): void;
-    disconnect(): void;
-    joinRoom(roomId: string, presence?: Presence, accessToken?: string): void;
-    leaveRoom(roomId?: string): void;
-    updatePresence(presence: Presence): void;
-    broadcastEvent(event: string, payload?: unknown): void;
-    sendChat(message: string, metadata?: Record<string, unknown>): void;
-    getConnectionStatus(): ConnectionStatus;
-    getPresence(): Record<string, PresenceEntry>;
-    getChatMessages(): StoredChatMessage[];
-    getCurrentRoomId(): string | null;
-    getState(): LiveSyncClientState;
-    subscribe(listener: (state: LiveSyncClientState) => void): () => void;
-}
-declare function createLiveSyncClient(config: LiveSyncClientConfig): LiveSyncClient;
-
-export { type BroadcastEventPayload, type BroadcastEventRelayPayload, type ChatMessageInput, type ChatMessagePayload, type ClientMessage, type ConnectionStatus, type ErrorPayload, type JoinRoomPayload, type LeaveRoomPayload, type LiveSyncClient, type LiveSyncClientConfig, type LiveSyncClientState, MSG_BROADCAST_EVENT, MSG_BROADCAST_EVENT_RELAY, MSG_CHAT_MESSAGE, MSG_ERROR, MSG_JOIN_ROOM, MSG_LEAVE_ROOM, MSG_PRESENCE_UPDATED, MSG_ROOM_JOINED, MSG_SEND_CHAT, MSG_UPDATE_PRESENCE, type Presence, type PresenceEntry, type PresenceUpdatedPayload, type RoomJoinedPayload, type SendChatPayload, type ServerMessage, type StoredChatMessage, type UpdatePresencePayload, type UserInfo, createLiveSyncClient };
+export { B as BroadcastEventPayload, c as BroadcastEventRelayPayload, C as ChatMessageInput, d as ChatMessagePayload, e as ClientMessage, f as ConnectionStatus, E as ErrorPayload, g as JoinRoomPayload, h as LeaveRoomPayload, L as LiveSyncClient, i as LiveSyncClientConfig, b as LiveSyncClientState, M as MSG_BROADCAST_EVENT, j as MSG_BROADCAST_EVENT_RELAY, k as MSG_CHAT_MESSAGE, l as MSG_ERROR, m as MSG_JOIN_ROOM, n as MSG_LEAVE_ROOM, o as MSG_PRESENCE_UPDATED, p as MSG_ROOM_JOINED, q as MSG_SEND_CHAT, r as MSG_UPDATE_PRESENCE, P as Presence, a as PresenceEntry, s as PresenceUpdatedPayload, R as RoomJoinedPayload, t as SendChatPayload, u as ServerMessage, S as StoredChatMessage, U as UpdatePresencePayload, v as UserInfo, w as createLiveSyncClient } from './index-HY9A86VV.js';

package/dist/index.js

@@ -10,7 +10,7 @@ import {
   MSG_SEND_CHAT,
   MSG_UPDATE_PRESENCE,
   createLiveSyncClient
-} from "./chunk-MINJGWLX.js";
+} from "./chunk-TAMQSVU2.js";
 export {
   MSG_BROADCAST_EVENT,
   MSG_BROADCAST_EVENT_RELAY,

package/dist/react-entry.d.ts

@@ -1,5 +1,5 @@
 import React, { ReactNode } from 'react';
-import { LiveSyncClient, StoredChatMessage, Presence, PresenceEntry, LiveSyncClientState } from './index.js';
+import { L as LiveSyncClient, S as StoredChatMessage, P as Presence, J as JoinRoomIdentity, a as PresenceEntry, b as LiveSyncClientState } from './index-HY9A86VV.js';
 
 /**
  * React bindings for @openlivesync/client.
@@ -35,9 +35,13 @@ interface UseRoomOptions {
     accessToken?: string;
     /** Optional getter for access token (e.g. refreshed token); used when auto-joining. */
     getAccessToken?: () => string | Promise<string>;
+    /** Optional display name if not using accessToken. */
+    name?: string;
+    /** Optional email if not using accessToken. */
+    email?: string;
 }
 interface UseRoomReturn {
-    join: (roomId: string, presence?: Presence, accessToken?: string) => void;
+    join: (roomId: string, presence?: Presence, identity?: JoinRoomIdentity) => void;
     leave: (roomId?: string) => void;
     updatePresence: (presence: Presence) => void;
     broadcastEvent: (event: string, payload?: unknown) => void;

package/dist/react-entry.js

@@ -1,6 +1,6 @@
 import {
   createLiveSyncClient
-} from "./chunk-MINJGWLX.js";
+} from "./chunk-TAMQSVU2.js";
 
 // src/react-entry.tsx
 import React, {
@@ -67,17 +67,28 @@ function useConnectionStatus() {
   return useClientState().connectionStatus;
 }
 function useRoom(roomId, options = {}) {
-  const { initialPresence, autoJoin = true, accessToken, getAccessToken } = options;
+  const {
+    initialPresence,
+    autoJoin = true,
+    accessToken,
+    getAccessToken,
+    name,
+    email
+  } = options;
   const client = useLiveSyncClient();
   const state = useClientState();
   const joinedRef = useRef(null);
   const join = useCallback(
-    (id, presence, token) => {
-      const t = token ?? accessToken;
-      client.joinRoom(id, presence ?? initialPresence, t);
+    (id, presence, identity) => {
+      const effectiveIdentity = identity ?? {
+        accessToken,
+        name,
+        email
+      };
+      client.joinRoom(id, presence ?? initialPresence, effectiveIdentity);
       joinedRef.current = id;
     },
-    [client, initialPresence, accessToken]
+    [client, initialPresence, accessToken, name, email]
   );
   const leave = useCallback(
     (id) => {
@@ -92,7 +103,12 @@ function useRoom(roomId, options = {}) {
     (async () => {
       const token = accessToken ?? (getAccessToken ? await getAccessToken() : void 0);
       if (!cancelled) {
-        client.joinRoom(roomId, initialPresence, token);
+        const identity = {
+          accessToken: token,
+          name,
+          email
+        };
+        client.joinRoom(roomId, initialPresence, identity);
         joinedRef.current = roomId;
       }
     })();

package/dist/react-entry.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/react-entry.tsx"],"sourcesContent":["/**\n * React bindings for @openlivesync/client.\n * Provider + hooks; import from \"@openlivesync/client/react\".\n */\n\nimport React, {\n  createContext,\n  useCallback,\n  useContext,\n  useEffect,\n  useMemo,\n  useRef,\n  useState,\n  type ReactNode,\n} from \"react\";\nimport {\n  createLiveSyncClient,\n  type LiveSyncClient,\n  type LiveSyncClientConfig,\n  type LiveSyncClientState,\n} from \"./client.js\";\nimport type { Presence, PresenceEntry, StoredChatMessage } from \"./protocol.js\";\n\nconst LiveSyncContext = createContext<LiveSyncClient | null>(null);\n\nexport interface LiveSyncProviderProps {\n  children: ReactNode;\n  /** Pre-created client (call createLiveSyncClient yourself). */\n  client?: LiveSyncClient;\n  /** Or pass config and the provider will create the client and connect on mount. */\n  url?: string;\n  reconnect?: boolean;\n  reconnectIntervalMs?: number;\n  maxReconnectIntervalMs?: number;\n  getAuthToken?: () => string | Promise<string>;\n  presenceThrottleMs?: number;\n}\n\n/**\n * Provides the LiveSync client to the tree. Pass either `client` or config (`url`, etc.).\n * If config is passed, the client is created on mount and connect() is called; disconnect on unmount.\n */\nexport function LiveSyncProvider(props: LiveSyncProviderProps) {\n  const { children, client: clientProp } = props;\n  const configRef = useRef<LiveSyncClientConfig | null>(null);\n  if (!configRef.current && !clientProp && props.url) {\n    configRef.current = {\n      url: props.url,\n      reconnect: props.reconnect,\n      reconnectIntervalMs: props.reconnectIntervalMs,\n      maxReconnectIntervalMs: props.maxReconnectIntervalMs,\n      getAuthToken: props.getAuthToken,\n      presenceThrottleMs: props.presenceThrottleMs,\n    };\n  }\n  const config = configRef.current;\n\n  const clientFromConfig = useMemo(() => {\n    if (clientProp || !config) return null;\n    return createLiveSyncClient(config);\n  }, [clientProp, config?.url]);\n\n  const client = clientProp ?? clientFromConfig;\n\n  useEffect(() => {\n    if (!client) return;\n    if (!clientProp && config) {\n      client.connect();\n      return () => client.disconnect();\n    }\n  }, [client, clientProp, config]);\n\n  if (!client) {\n    throw new Error(\n      \"LiveSyncProvider: pass either `client` or config (e.g. `url`) to create the client.\"\n    );\n  }\n\n  return React.createElement(LiveSyncContext.Provider, { value: client }, children);\n}\n\nexport function useLiveSyncClient(): LiveSyncClient {\n  const client = useContext(LiveSyncContext);\n  if (!client) {\n    throw new Error(\"useLiveSyncClient must be used within LiveSyncProvider\");\n  }\n  return client;\n}\n\nfunction useClientState(): LiveSyncClientState {\n  const client = useLiveSyncClient();\n  const [state, setState] = useState<LiveSyncClientState>(() =>\n    client.getState()\n  );\n  useEffect(() => {\n    return client.subscribe(setState);\n  }, [client]);\n  return state;\n}\n\n/** Returns current connection status and triggers re-renders when it changes. */\nexport function useConnectionStatus(): LiveSyncClientState[\"connectionStatus\"] {\n  return useClientState().connectionStatus;\n}\n\nexport interface UseRoomOptions {\n  /** Initial presence when joining (optional). */\n  initialPresence?: Presence;\n  /** If true, join the room when roomId is set and leave on cleanup or when roomId changes. */\n  autoJoin?: boolean;\n  /** Optional access token sent with join_room (server can decode for name/email). */\n  accessToken?: string;\n  /** Optional getter for access token (e.g. refreshed token); used when auto-joining. */\n  getAccessToken?: () => string | Promise<string>;\n}\n\nexport interface UseRoomReturn {\n  join: (roomId: string, presence?: Presence, accessToken?: string) => void;\n  leave: (roomId?: string) => void;\n  updatePresence: (presence: Presence) => void;\n  broadcastEvent: (event: string, payload?: unknown) => void;\n  presence: Record<string, PresenceEntry>;\n  connectionId: string | null;\n  isInRoom: boolean;\n  currentRoomId: string | null;\n}\n\n/**\n * Subscribe to room state and get methods to join/leave/update presence/broadcast.\n * If autoJoin is true (default), joining happens when roomId is set and leaving on unmount or roomId change.\n */\nexport function useRoom(\n  roomId: string | null,\n  options: UseRoomOptions = {}\n): UseRoomReturn {\n  const { initialPresence, autoJoin = true, accessToken, getAccessToken } = options;\n  const client = useLiveSyncClient();\n  const state = useClientState();\n  const joinedRef = useRef<string | null>(null);\n\n  const join = useCallback(\n    (id: string, presence?: Presence, token?: string) => {\n      const t = token ?? accessToken;\n      client.joinRoom(id, presence ?? initialPresence, t);\n      joinedRef.current = id;\n    },\n    [client, initialPresence, accessToken]\n  );\n\n  const leave = useCallback(\n    (id?: string) => {\n      client.leaveRoom(id);\n      if (!id || id === joinedRef.current) joinedRef.current = null;\n    },\n    [client]\n  );\n\n  useEffect(() => {\n    if (!autoJoin || roomId === null) return;\n    let cancelled = false;\n    (async () => {\n      const token = accessToken ?? (getAccessToken ? await getAccessToken() : undefined);\n      if (!cancelled) {\n        client.joinRoom(roomId, initialPresence, token);\n        joinedRef.current = roomId;\n      }\n    })();\n    return () => {\n      cancelled = true;\n      leave(roomId);\n    };\n  }, [autoJoin, roomId, initialPresence, accessToken, getAccessToken, client, leave]);\n\n  const updatePresence = useCallback(\n    (presence: Presence) => client.updatePresence(presence),\n    [client]\n  );\n\n  const broadcastEvent = useCallback(\n    (event: string, payload?: unknown) => client.broadcastEvent(event, payload),\n    [client]\n  );\n\n  const isInRoom =\n    state.currentRoomId !== null && state.currentRoomId === roomId;\n\n  return {\n    join,\n    leave,\n    updatePresence,\n    broadcastEvent,\n    presence: roomId && isInRoom ? state.presence : {},\n    connectionId: isInRoom ? state.connectionId : null,\n    isInRoom,\n    currentRoomId: state.currentRoomId,\n  };\n}\n\n/** Returns presence map for the current room (or empty if not in room). */\nexport function usePresence(roomId: string | null): Record<string, PresenceEntry> {\n  useLiveSyncClient(); // ensure we're inside provider\n  const state = useClientState();\n  const isInRoom =\n    roomId !== null &&\n    state.currentRoomId === roomId;\n  return isInRoom ? state.presence : {};\n}\n\nexport interface UseChatReturn {\n  messages: StoredChatMessage[];\n  sendMessage: (message: string, metadata?: Record<string, unknown>) => void;\n}\n\n/** Returns chat messages for the given room and sendMessage. Ensure the room is joined (e.g. via useRoom). */\nexport function useChat(roomId: string | null): UseChatReturn {\n  const client = useLiveSyncClient();\n  const state = useClientState();\n  const isInRoom =\n    roomId !== null && state.currentRoomId === roomId;\n  const messages = isInRoom ? state.chatMessages : [];\n\n  const sendMessage = useCallback(\n    (message: string, metadata?: Record<string, unknown>) => {\n      client.sendChat(message, metadata);\n    },\n    [client]\n  );\n\n  return { messages, sendMessage };\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/react-entry.tsx"],"sourcesContent":["/**\n * React bindings for @openlivesync/client.\n * Provider + hooks; import from \"@openlivesync/client/react\".\n */\n\nimport React, {\n  createContext,\n  useCallback,\n  useContext,\n  useEffect,\n  useMemo,\n  useRef,\n  useState,\n  type ReactNode,\n} from \"react\";\nimport {\n  createLiveSyncClient,\n  type LiveSyncClient,\n  type LiveSyncClientConfig,\n  type LiveSyncClientState,\n  type JoinRoomIdentity,\n} from \"./client.js\";\nimport type { Presence, PresenceEntry, StoredChatMessage } from \"./protocol.js\";\n\nconst LiveSyncContext = createContext<LiveSyncClient | null>(null);\n\nexport interface LiveSyncProviderProps {\n  children: ReactNode;\n  /** Pre-created client (call createLiveSyncClient yourself). */\n  client?: LiveSyncClient;\n  /** Or pass config and the provider will create the client and connect on mount. */\n  url?: string;\n  reconnect?: boolean;\n  reconnectIntervalMs?: number;\n  maxReconnectIntervalMs?: number;\n  getAuthToken?: () => string | Promise<string>;\n  presenceThrottleMs?: number;\n}\n\n/**\n * Provides the LiveSync client to the tree. Pass either `client` or config (`url`, etc.).\n * If config is passed, the client is created on mount and connect() is called; disconnect on unmount.\n */\nexport function LiveSyncProvider(props: LiveSyncProviderProps) {\n  const { children, client: clientProp } = props;\n  const configRef = useRef<LiveSyncClientConfig | null>(null);\n  if (!configRef.current && !clientProp && props.url) {\n    configRef.current = {\n      url: props.url,\n      reconnect: props.reconnect,\n      reconnectIntervalMs: props.reconnectIntervalMs,\n      maxReconnectIntervalMs: props.maxReconnectIntervalMs,\n      getAuthToken: props.getAuthToken,\n      presenceThrottleMs: props.presenceThrottleMs,\n    };\n  }\n  const config = configRef.current;\n\n  const clientFromConfig = useMemo(() => {\n    if (clientProp || !config) return null;\n    return createLiveSyncClient(config);\n  }, [clientProp, config?.url]);\n\n  const client = clientProp ?? clientFromConfig;\n\n  useEffect(() => {\n    if (!client) return;\n    if (!clientProp && config) {\n      client.connect();\n      return () => client.disconnect();\n    }\n  }, [client, clientProp, config]);\n\n  if (!client) {\n    throw new Error(\n      \"LiveSyncProvider: pass either `client` or config (e.g. `url`) to create the client.\"\n    );\n  }\n\n  return React.createElement(LiveSyncContext.Provider, { value: client }, children);\n}\n\nexport function useLiveSyncClient(): LiveSyncClient {\n  const client = useContext(LiveSyncContext);\n  if (!client) {\n    throw new Error(\"useLiveSyncClient must be used within LiveSyncProvider\");\n  }\n  return client;\n}\n\nfunction useClientState(): LiveSyncClientState {\n  const client = useLiveSyncClient();\n  const [state, setState] = useState<LiveSyncClientState>(() =>\n    client.getState()\n  );\n  useEffect(() => {\n    return client.subscribe(setState);\n  }, [client]);\n  return state;\n}\n\n/** Returns current connection status and triggers re-renders when it changes. */\nexport function useConnectionStatus(): LiveSyncClientState[\"connectionStatus\"] {\n  return useClientState().connectionStatus;\n}\n\nexport interface UseRoomOptions {\n  /** Initial presence when joining (optional). */\n  initialPresence?: Presence;\n  /** If true, join the room when roomId is set and leave on cleanup or when roomId changes. */\n  autoJoin?: boolean;\n  /** Optional access token sent with join_room (server can decode for name/email). */\n  accessToken?: string;\n  /** Optional getter for access token (e.g. refreshed token); used when auto-joining. */\n  getAccessToken?: () => string | Promise<string>;\n  /** Optional display name if not using accessToken. */\n  name?: string;\n  /** Optional email if not using accessToken. */\n  email?: string;\n}\n\nexport interface UseRoomReturn {\n  join: (roomId: string, presence?: Presence, identity?: JoinRoomIdentity) => void;\n  leave: (roomId?: string) => void;\n  updatePresence: (presence: Presence) => void;\n  broadcastEvent: (event: string, payload?: unknown) => void;\n  presence: Record<string, PresenceEntry>;\n  connectionId: string | null;\n  isInRoom: boolean;\n  currentRoomId: string | null;\n}\n\n/**\n * Subscribe to room state and get methods to join/leave/update presence/broadcast.\n * If autoJoin is true (default), joining happens when roomId is set and leaving on unmount or roomId change.\n */\nexport function useRoom(\n  roomId: string | null,\n  options: UseRoomOptions = {}\n): UseRoomReturn {\n  const {\n    initialPresence,\n    autoJoin = true,\n    accessToken,\n    getAccessToken,\n    name,\n    email,\n  } = options;\n  const client = useLiveSyncClient();\n  const state = useClientState();\n  const joinedRef = useRef<string | null>(null);\n\n  const join = useCallback(\n    (id: string, presence?: Presence, identity?: JoinRoomIdentity) => {\n      const effectiveIdentity: JoinRoomIdentity = identity ?? {\n        accessToken,\n        name,\n        email,\n      };\n      client.joinRoom(id, presence ?? initialPresence, effectiveIdentity);\n      joinedRef.current = id;\n    },\n    [client, initialPresence, accessToken, name, email]\n  );\n\n  const leave = useCallback(\n    (id?: string) => {\n      client.leaveRoom(id);\n      if (!id || id === joinedRef.current) joinedRef.current = null;\n    },\n    [client]\n  );\n\n  useEffect(() => {\n    if (!autoJoin || roomId === null) return;\n    let cancelled = false;\n    (async () => {\n      const token = accessToken ?? (getAccessToken ? await getAccessToken() : undefined);\n      if (!cancelled) {\n        const identity: JoinRoomIdentity = {\n          accessToken: token,\n          name,\n          email,\n        };\n        client.joinRoom(roomId, initialPresence, identity);\n        joinedRef.current = roomId;\n      }\n    })();\n    return () => {\n      cancelled = true;\n      leave(roomId);\n    };\n  }, [autoJoin, roomId, initialPresence, accessToken, getAccessToken, client, leave]);\n\n  const updatePresence = useCallback(\n    (presence: Presence) => client.updatePresence(presence),\n    [client]\n  );\n\n  const broadcastEvent = useCallback(\n    (event: string, payload?: unknown) => client.broadcastEvent(event, payload),\n    [client]\n  );\n\n  const isInRoom =\n    state.currentRoomId !== null && state.currentRoomId === roomId;\n\n  return {\n    join,\n    leave,\n    updatePresence,\n    broadcastEvent,\n    presence: roomId && isInRoom ? state.presence : {},\n    connectionId: isInRoom ? state.connectionId : null,\n    isInRoom,\n    currentRoomId: state.currentRoomId,\n  };\n}\n\n/** Returns presence map for the current room (or empty if not in room). */\nexport function usePresence(roomId: string | null): Record<string, PresenceEntry> {\n  useLiveSyncClient(); // ensure we're inside provider\n  const state = useClientState();\n  const isInRoom =\n    roomId !== null &&\n    state.currentRoomId === roomId;\n  return isInRoom ? state.presence : {};\n}\n\nexport interface UseChatReturn {\n  messages: StoredChatMessage[];\n  sendMessage: (message: string, metadata?: Record<string, unknown>) => void;\n}\n\n/** Returns chat messages for the given room and sendMessage. Ensure the room is joined (e.g. via useRoom). */\nexport function useChat(roomId: string | null): UseChatReturn {\n  const client = useLiveSyncClient();\n  const state = useClientState();\n  const isInRoom =\n    roomId !== null && state.currentRoomId === roomId;\n  const messages = isInRoom ? state.chatMessages : [];\n\n  const sendMessage = useCallback(\n    (message: string, metadata?: Record<string, unknown>) => {\n      client.sendChat(message, metadata);\n    },\n    [client]\n  );\n\n  return { messages, sendMessage };\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openlivesync/client",
-  "version": "1.0.2",
+  "version": "1.0.3",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -18,16 +18,21 @@
   },
   "scripts": {
     "build": "tsup",
-    "clean": "rm -rf dist"
+    "clean": "rm -rf dist",
+    "test": "vitest",
+    "test:watch": "vitest --watch"
   },
   "peerDependencies": {
     "react": ">=18.0.0"
   },
   "devDependencies": {
+    "@testing-library/react": "^16.0.0",
     "@types/react": "^18.3.0",
     "react": "^18.3.0",
+    "react-dom": "^18.3.0",
     "tsup": "^8.3.5",
-    "typescript": "^5.6.3"
+    "typescript": "^5.6.3",
+    "vitest": "^2.1.4"
   },
   "repository": {
     "type": "git",

package/src/client.test.js

@@ -0,0 +1,147 @@
+import { describe, it, expect, vi, afterEach } from "vitest";
+import { createLiveSyncClient } from "./client.js";
+
+function createMockWebSocket() {
+  const listeners = {};
+  const sent = [];
+
+  const ws = {
+    readyState: 1,
+    OPEN: 1,
+    url: "",
+    onopen: null,
+    onmessage: null,
+    onclose: null,
+    onerror: null,
+    addEventListener(type, listener) {
+      listeners[type] = listeners[type] ?? [];
+      listeners[type].push(listener);
+    },
+    send(data) {
+      sent.push(data);
+    },
+    close() {
+      if (typeof ws.onclose === "function") {
+        ws.onclose({});
+      }
+      (listeners["close"] ?? []).forEach((l) => l({ data: "" }));
+    },
+    sent,
+  };
+
+  function emitOpen() {
+    if (typeof ws.onopen === "function") {
+      ws.onopen({});
+    }
+  }
+
+  function emitMessage(msg) {
+    const data = JSON.stringify(msg);
+    if (typeof ws.onmessage === "function") {
+      ws.onmessage({ data });
+    }
+    (listeners["message"] ?? []).forEach((l) => l({ data }));
+  }
+
+  return { ws, sent, emitOpen, emitMessage };
+}
+
+describe("createLiveSyncClient joinRoom identity", () => {
+  const OriginalWebSocket = globalThis.WebSocket;
+
+  afterEach(() => {
+    globalThis.WebSocket = OriginalWebSocket;
+    vi.restoreAllMocks();
+  });
+
+  it("sends join_room with manual name/email when identity has no accessToken", () => {
+    const mock = createMockWebSocket();
+    globalThis.WebSocket = vi.fn(() => mock.ws);
+
+    const client = createLiveSyncClient({ url: "ws://localhost/live", reconnect: false });
+    client.connect();
+    mock.emitOpen();
+
+    const presence = { cursor: { x: 1, y: 2 } };
+    const identity = { name: "Manual User", email: "manual@example.com" };
+
+    client.joinRoom("room1", presence, identity);
+
+    const raw = mock.sent[mock.sent.length - 1];
+    expect(raw).toBeTruthy();
+    const msg = JSON.parse(raw);
+    expect(msg.type).toBe("join_room");
+    expect(msg.payload).toMatchObject({
+      roomId: "room1",
+      presence,
+      name: "Manual User",
+      email: "manual@example.com",
+    });
+    expect(msg.payload.accessToken).toBeUndefined();
+  });
+
+  it("sends join_room with accessToken when identity has token only", () => {
+    const mock = createMockWebSocket();
+    globalThis.WebSocket = vi.fn(() => mock.ws);
+
+    const client = createLiveSyncClient({ url: "ws://localhost/live", reconnect: false });
+    client.connect();
+    mock.emitOpen();
+
+    const identity = { accessToken: "token-123" };
+    client.joinRoom("room1", undefined, identity);
+
+    const raw = mock.sent[mock.sent.length - 1];
+    expect(raw).toBeTruthy();
+    const msg = JSON.parse(raw);
+    expect(msg.type).toBe("join_room");
+    expect(msg.payload).toMatchObject({
+      roomId: "room1",
+      accessToken: "token-123",
+    });
+  });
+
+  it("reconnectAndRejoin reuses last identity", () => {
+    const mock = createMockWebSocket();
+    globalThis.WebSocket = vi.fn(() => mock.ws);
+
+    const client = createLiveSyncClient({ url: "ws://localhost/live", reconnect: false });
+    client.connect();
+    mock.emitOpen();
+
+    const identity = {
+      accessToken: "token-abc",
+      name: "Reconnect User",
+      email: "reconnect@example.com",
+    };
+
+    client.joinRoom("room-reconnect", { cursor: { x: 0 } }, identity);
+
+    // Simulate server confirming join so client state has currentRoomId set
+    mock.emitMessage({
+      type: "room_joined",
+      payload: {
+        roomId: "room-reconnect",
+        connectionId: "c1",
+        presence: {},
+      },
+    });
+
+    // Clear previous sends and trigger reconnectAndRejoin via connect() call again
+    mock.sent.length = 0;
+    client.connect();
+    mock.emitOpen();
+
+    const raw = mock.sent[mock.sent.length - 1];
+    expect(raw).toBeTruthy();
+    const msg = JSON.parse(raw);
+    expect(msg.type).toBe("join_room");
+    expect(msg.payload).toMatchObject({
+      roomId: "room-reconnect",
+      accessToken: "token-abc",
+      name: "Reconnect User",
+      email: "reconnect@example.com",
+    });
+  });
+});
+

package/src/client.ts

@@ -9,6 +9,7 @@ import type {
   Presence,
   PresenceEntry,
   StoredChatMessage,
+  JoinRoomPayload,
 } from "./protocol.js";
 import {
   MSG_JOIN_ROOM,
@@ -34,6 +35,15 @@ export interface LiveSyncClientState {
   lastError: { code: string; message: string } | null;
 }
 
+export interface JoinRoomIdentity {
+  /** Optional display name if not using accessToken. */
+  name?: string;
+  /** Optional email if not using accessToken. */
+  email?: string;
+  /** Optional OAuth/OpenID access token; server decodes to get name, email, provider. */
+  accessToken?: string;
+}
+
 export interface LiveSyncClientConfig {
   /** WebSocket URL (e.g. wss://host/live). */
   url: string;
@@ -68,7 +78,7 @@ function isServerMessage(msg: unknown): msg is ServerMessage {
 export interface LiveSyncClient {
   connect(): void;
   disconnect(): void;
-  joinRoom(roomId: string, presence?: Presence, accessToken?: string): void;
+  joinRoom(roomId: string, presence?: Presence, identity?: JoinRoomIdentity): void;
   leaveRoom(roomId?: string): void;
   updatePresence(presence: Presence): void;
   broadcastEvent(event: string, payload?: unknown): void;
@@ -97,6 +107,7 @@ export function createLiveSyncClient(config: LiveSyncClientConfig): LiveSyncClie
   let intentionalClose = false;
   let lastPresenceUpdate = 0;
   let pendingPresence: Presence | null = null;
+  let lastJoinIdentity: JoinRoomIdentity | null = null;
 
   const state: LiveSyncClientState = {
     connectionStatus: "closed",
@@ -231,7 +242,13 @@ export function createLiveSyncClient(config: LiveSyncClientConfig): LiveSyncClie
     const roomId = state.currentRoomId;
     if (!roomId) return;
     const presence = pendingPresence ?? (state.connectionId ? state.presence[state.connectionId]?.presence : undefined);
-    send({ type: MSG_JOIN_ROOM, payload: { roomId, presence } });
+    const identity = lastJoinIdentity;
+    const payload: JoinRoomPayload = { roomId };
+    if (presence !== undefined) payload.presence = presence;
+    if (identity?.accessToken !== undefined) payload.accessToken = identity.accessToken;
+    if (identity?.name !== undefined) payload.name = identity.name;
+    if (identity?.email !== undefined) payload.email = identity.email;
+    send({ type: MSG_JOIN_ROOM, payload });
   }
 
   function connect() {
@@ -307,7 +324,7 @@ export function createLiveSyncClient(config: LiveSyncClientConfig): LiveSyncClie
     setStatus("closed");
   }
 
-  function joinRoom(roomId: string, presence?: Presence, accessToken?: string) {
+  function joinRoom(roomId: string, presence?: Presence, identity?: JoinRoomIdentity) {
     if (state.currentRoomId) {
       send({ type: MSG_LEAVE_ROOM, payload: { roomId: state.currentRoomId } });
     }
@@ -315,9 +332,12 @@ export function createLiveSyncClient(config: LiveSyncClientConfig): LiveSyncClie
     state.presence = {};
     state.chatMessages = [];
     pendingPresence = presence ?? null;
-    const payload: { roomId: string; presence?: Presence; accessToken?: string } = { roomId };
+    lastJoinIdentity = identity ?? null;
+    const payload: JoinRoomPayload = { roomId };
     if (presence !== undefined) payload.presence = presence;
-    if (accessToken !== undefined) payload.accessToken = accessToken;
+    if (identity?.accessToken !== undefined) payload.accessToken = identity.accessToken;
+    if (identity?.name !== undefined) payload.name = identity.name;
+    if (identity?.email !== undefined) payload.email = identity.email;
     send({ type: MSG_JOIN_ROOM, payload });
     emit();
   }

package/src/protocol.ts

@@ -28,6 +28,10 @@ export interface JoinRoomPayload {
   presence?: Presence;
   /** Optional OAuth/OpenID access token; server decodes to get name, email, provider. */
   accessToken?: string;
+  /** Optional display name if not using accessToken. */
+  name?: string;
+  /** Optional email if not using accessToken. */
+  email?: string;
 }
 
 export interface LeaveRoomPayload {

package/src/react-entry.test.tsx

@@ -0,0 +1,39 @@
+import { describe, it, expect } from "vitest";
+import React, { type ReactNode } from "react";
+import { renderHook, act } from "@testing-library/react";
+import { LiveSyncProvider, useRoom } from "./react-entry.js";
+import { createLiveSyncClient, type JoinRoomIdentity } from "./client.js";
+
+describe("useRoom identity options", () => {
+  it("join uses identity from options when no explicit identity is passed", () => {
+    const joinSpy: { lastArgs?: [string, unknown, JoinRoomIdentity?] } = {};
+    const client = createLiveSyncClient({ url: "ws://localhost/live", reconnect: false });
+    // Monkey-patch joinRoom to capture calls
+    (client as unknown as {
+      joinRoom: (...args: [string, unknown, JoinRoomIdentity?]) => void;
+    }).joinRoom = (...args: [string, unknown, JoinRoomIdentity?]) => {
+      joinSpy.lastArgs = args;
+    };
+
+    const wrapper: React.FC<{ children: ReactNode }> = ({ children }) => (
+      <LiveSyncProvider client={client}>{children}</LiveSyncProvider>
+    );
+
+    const { result } = renderHook(
+      () => useRoom("room-hook", { name: "Hook User", email: "hook@example.com" }),
+      { wrapper }
+    );
+
+    act(() => {
+      result.current.join("room-hook");
+    });
+
+    expect(joinSpy.lastArgs).toBeDefined();
+    const [, , identity] = joinSpy.lastArgs!;
+    expect(identity).toMatchObject({
+      name: "Hook User",
+      email: "hook@example.com",
+    });
+  });
+});
+

package/src/react-entry.tsx

@@ -18,6 +18,7 @@ import {
   type LiveSyncClient,
   type LiveSyncClientConfig,
   type LiveSyncClientState,
+  type JoinRoomIdentity,
 } from "./client.js";
 import type { Presence, PresenceEntry, StoredChatMessage } from "./protocol.js";
 
@@ -112,10 +113,14 @@ export interface UseRoomOptions {
   accessToken?: string;
   /** Optional getter for access token (e.g. refreshed token); used when auto-joining. */
   getAccessToken?: () => string | Promise<string>;
+  /** Optional display name if not using accessToken. */
+  name?: string;
+  /** Optional email if not using accessToken. */
+  email?: string;
 }
 
 export interface UseRoomReturn {
-  join: (roomId: string, presence?: Presence, accessToken?: string) => void;
+  join: (roomId: string, presence?: Presence, identity?: JoinRoomIdentity) => void;
   leave: (roomId?: string) => void;
   updatePresence: (presence: Presence) => void;
   broadcastEvent: (event: string, payload?: unknown) => void;
@@ -133,18 +138,29 @@ export function useRoom(
   roomId: string | null,
   options: UseRoomOptions = {}
 ): UseRoomReturn {
-  const { initialPresence, autoJoin = true, accessToken, getAccessToken } = options;
+  const {
+    initialPresence,
+    autoJoin = true,
+    accessToken,
+    getAccessToken,
+    name,
+    email,
+  } = options;
   const client = useLiveSyncClient();
   const state = useClientState();
   const joinedRef = useRef<string | null>(null);
 
   const join = useCallback(
-    (id: string, presence?: Presence, token?: string) => {
-      const t = token ?? accessToken;
-      client.joinRoom(id, presence ?? initialPresence, t);
+    (id: string, presence?: Presence, identity?: JoinRoomIdentity) => {
+      const effectiveIdentity: JoinRoomIdentity = identity ?? {
+        accessToken,
+        name,
+        email,
+      };
+      client.joinRoom(id, presence ?? initialPresence, effectiveIdentity);
       joinedRef.current = id;
     },
-    [client, initialPresence, accessToken]
+    [client, initialPresence, accessToken, name, email]
   );
 
   const leave = useCallback(
@@ -161,7 +177,12 @@ export function useRoom(
     (async () => {
       const token = accessToken ?? (getAccessToken ? await getAccessToken() : undefined);
       if (!cancelled) {
-        client.joinRoom(roomId, initialPresence, token);
+        const identity: JoinRoomIdentity = {
+          accessToken: token,
+          name,
+          email,
+        };
+        client.joinRoom(roomId, initialPresence, identity);
         joinedRef.current = roomId;
       }
     })();

package/dist/chunk-MINJGWLX.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/protocol.ts","../src/client.ts"],"sourcesContent":["/**\n * Wire protocol types for @openlivesync/client.\n * Must stay in sync with @openlivesync/server protocol (same message types and payload shapes).\n */\n\n/** Generic presence payload (cursor, name, color, etc.). Server does not interpret. */\nexport type Presence = Record<string, unknown>;\n\n/** User/session info attached by server from auth (optional). */\nexport interface UserInfo {\n  userId?: string;\n  name?: string;\n  email?: string;\n  provider?: string;\n  [key: string]: unknown;\n}\n\n// ----- Client → Server message types -----\n\nexport const MSG_JOIN_ROOM = \"join_room\";\nexport const MSG_LEAVE_ROOM = \"leave_room\";\nexport const MSG_UPDATE_PRESENCE = \"update_presence\";\nexport const MSG_BROADCAST_EVENT = \"broadcast_event\";\nexport const MSG_SEND_CHAT = \"send_chat\";\n\nexport interface JoinRoomPayload {\n  roomId: string;\n  presence?: Presence;\n  /** Optional OAuth/OpenID access token; server decodes to get name, email, provider. */\n  accessToken?: string;\n}\n\nexport interface LeaveRoomPayload {\n  roomId?: string;\n}\n\nexport interface UpdatePresencePayload {\n  presence: Presence;\n}\n\nexport interface BroadcastEventPayload {\n  event: string;\n  payload?: unknown;\n}\n\nexport interface SendChatPayload {\n  message: string;\n  /** Optional application-defined metadata */\n  metadata?: Record<string, unknown>;\n}\n\nexport type ClientMessage =\n  | { type: typeof MSG_JOIN_ROOM; payload: JoinRoomPayload }\n  | { type: typeof MSG_LEAVE_ROOM; payload?: LeaveRoomPayload }\n  | { type: typeof MSG_UPDATE_PRESENCE; payload: UpdatePresencePayload }\n  | { type: typeof MSG_BROADCAST_EVENT; payload: BroadcastEventPayload }\n  | { type: typeof MSG_SEND_CHAT; payload: SendChatPayload };\n\n// ----- Server → Client message types -----\n\nexport const MSG_ROOM_JOINED = \"room_joined\";\nexport const MSG_PRESENCE_UPDATED = \"presence_updated\";\nexport const MSG_BROADCAST_EVENT_RELAY = \"broadcast_event\";\nexport const MSG_CHAT_MESSAGE = \"chat_message\";\nexport const MSG_ERROR = \"error\";\n\nexport interface PresenceEntry {\n  connectionId: string;\n  userId?: string;\n  name?: string;\n  email?: string;\n  provider?: string;\n  presence: Presence;\n}\n\nexport interface RoomJoinedPayload {\n  roomId: string;\n  connectionId: string;\n  presence: Record<string, PresenceEntry>;\n  chatHistory?: StoredChatMessage[];\n}\n\nexport interface PresenceUpdatedPayload {\n  roomId: string;\n  joined?: PresenceEntry[];\n  left?: string[];\n  updated?: PresenceEntry[];\n}\n\nexport interface BroadcastEventRelayPayload {\n  roomId: string;\n  connectionId: string;\n  userId?: string;\n  event: string;\n  payload?: unknown;\n}\n\nexport interface ChatMessagePayload {\n  roomId: string;\n  connectionId: string;\n  userId?: string;\n  message: string;\n  metadata?: Record<string, unknown>;\n  id?: string;\n  createdAt?: number;\n}\n\nexport interface StoredChatMessage {\n  id: string;\n  roomId: string;\n  connectionId: string;\n  userId?: string;\n  message: string;\n  metadata?: Record<string, unknown>;\n  createdAt: number;\n}\n\nexport interface ErrorPayload {\n  code: string;\n  message: string;\n}\n\nexport type ServerMessage =\n  | { type: typeof MSG_ROOM_JOINED; payload: RoomJoinedPayload }\n  | { type: typeof MSG_PRESENCE_UPDATED; payload: PresenceUpdatedPayload }\n  | { type: typeof MSG_BROADCAST_EVENT_RELAY; payload: BroadcastEventRelayPayload }\n  | { type: typeof MSG_CHAT_MESSAGE; payload: ChatMessagePayload }\n  | { type: typeof MSG_ERROR; payload: ErrorPayload };\n\n/** Chat message as provided when appending (before storage adds id/createdAt). */\nexport interface ChatMessageInput {\n  roomId: string;\n  connectionId: string;\n  userId?: string;\n  message: string;\n  metadata?: Record<string, unknown>;\n}\n","/**\n * Core WebSocket client for @openlivesync.\n * Connects to @openlivesync/server, manages room/presence/chat state, and notifies subscribers.\n */\n\nimport type {\n  ClientMessage,\n  ServerMessage,\n  Presence,\n  PresenceEntry,\n  StoredChatMessage,\n} from \"./protocol.js\";\nimport {\n  MSG_JOIN_ROOM,\n  MSG_LEAVE_ROOM,\n  MSG_UPDATE_PRESENCE,\n  MSG_BROADCAST_EVENT,\n  MSG_SEND_CHAT,\n  MSG_ROOM_JOINED,\n  MSG_PRESENCE_UPDATED,\n  MSG_BROADCAST_EVENT_RELAY,\n  MSG_CHAT_MESSAGE,\n  MSG_ERROR,\n} from \"./protocol.js\";\n\nexport type ConnectionStatus = \"connecting\" | \"open\" | \"closing\" | \"closed\";\n\nexport interface LiveSyncClientState {\n  connectionStatus: ConnectionStatus;\n  currentRoomId: string | null;\n  connectionId: string | null;\n  presence: Record<string, PresenceEntry>;\n  chatMessages: StoredChatMessage[];\n  lastError: { code: string; message: string } | null;\n}\n\nexport interface LiveSyncClientConfig {\n  /** WebSocket URL (e.g. wss://host/live). */\n  url: string;\n  /** Auto-reconnect on close (default true). */\n  reconnect?: boolean;\n  /** Initial reconnect delay in ms (default 1000). */\n  reconnectIntervalMs?: number;\n  /** Max reconnect delay in ms (default 30000). */\n  maxReconnectIntervalMs?: number;\n  /** Optional: return token for auth; appended as query param (e.g. ?access_token=). */\n  getAuthToken?: () => string | Promise<string>;\n  /** Throttle presence updates in ms (default 100, match server). */\n  presenceThrottleMs?: number;\n}\n\nconst DEFAULT_RECONNECT_INTERVAL_MS = 1000;\nconst DEFAULT_MAX_RECONNECT_INTERVAL_MS = 30000;\nconst DEFAULT_PRESENCE_THROTTLE_MS = 100;\n\nfunction isServerMessage(msg: unknown): msg is ServerMessage {\n  if (msg === null || typeof msg !== \"object\" || !(\"type\" in msg)) return false;\n  const t = (msg as { type: string }).type;\n  return [\n    MSG_ROOM_JOINED,\n    MSG_PRESENCE_UPDATED,\n    MSG_BROADCAST_EVENT_RELAY,\n    MSG_CHAT_MESSAGE,\n    MSG_ERROR,\n  ].includes(t);\n}\n\nexport interface LiveSyncClient {\n  connect(): void;\n  disconnect(): void;\n  joinRoom(roomId: string, presence?: Presence, accessToken?: string): void;\n  leaveRoom(roomId?: string): void;\n  updatePresence(presence: Presence): void;\n  broadcastEvent(event: string, payload?: unknown): void;\n  sendChat(message: string, metadata?: Record<string, unknown>): void;\n  getConnectionStatus(): ConnectionStatus;\n  getPresence(): Record<string, PresenceEntry>;\n  getChatMessages(): StoredChatMessage[];\n  getCurrentRoomId(): string | null;\n  getState(): LiveSyncClientState;\n  subscribe(listener: (state: LiveSyncClientState) => void): () => void;\n}\n\nexport function createLiveSyncClient(config: LiveSyncClientConfig): LiveSyncClient {\n  const {\n    url: baseUrl,\n    reconnect: reconnectEnabled = true,\n    reconnectIntervalMs = DEFAULT_RECONNECT_INTERVAL_MS,\n    maxReconnectIntervalMs = DEFAULT_MAX_RECONNECT_INTERVAL_MS,\n    getAuthToken,\n    presenceThrottleMs = DEFAULT_PRESENCE_THROTTLE_MS,\n  } = config;\n\n  let ws: WebSocket | null = null;\n  let reconnectTimeoutId: ReturnType<typeof setTimeout> | null = null;\n  let nextReconnectMs = reconnectIntervalMs;\n  let intentionalClose = false;\n  let lastPresenceUpdate = 0;\n  let pendingPresence: Presence | null = null;\n\n  const state: LiveSyncClientState = {\n    connectionStatus: \"closed\",\n    currentRoomId: null,\n    connectionId: null,\n    presence: {},\n    chatMessages: [],\n    lastError: null,\n  };\n\n  const listeners = new Set<(s: LiveSyncClientState) => void>();\n\n  function emit() {\n    const snapshot: LiveSyncClientState = {\n      connectionStatus: state.connectionStatus,\n      currentRoomId: state.currentRoomId,\n      connectionId: state.connectionId,\n      presence: { ...state.presence },\n      chatMessages: [...state.chatMessages],\n      lastError: state.lastError ? { ...state.lastError } : null,\n    };\n    listeners.forEach((cb) => cb(snapshot));\n  }\n\n  function setStatus(status: ConnectionStatus) {\n    state.connectionStatus = status;\n    emit();\n  }\n\n  function send(msg: ClientMessage) {\n    if (!ws || ws.readyState !== WebSocket.OPEN) return;\n    ws.send(JSON.stringify(msg));\n  }\n\n  function clearReconnect() {\n    if (reconnectTimeoutId !== null) {\n      clearTimeout(reconnectTimeoutId);\n      reconnectTimeoutId = null;\n    }\n    nextReconnectMs = reconnectIntervalMs;\n  }\n\n  function scheduleReconnect() {\n    if (!reconnectEnabled || intentionalClose) return;\n    clearReconnect();\n    reconnectTimeoutId = setTimeout(() => {\n      reconnectTimeoutId = null;\n      nextReconnectMs = Math.min(\n        nextReconnectMs * 2,\n        maxReconnectIntervalMs\n      );\n      connect();\n    }, nextReconnectMs);\n  }\n\n  function applyPresenceUpdated(\n    joined?: PresenceEntry[],\n    left?: string[],\n    updated?: PresenceEntry[]\n  ) {\n    if (joined) {\n      for (const e of joined) state.presence[e.connectionId] = e;\n    }\n    if (left) {\n      for (const id of left) delete state.presence[id];\n    }\n    if (updated) {\n      for (const e of updated) state.presence[e.connectionId] = e;\n    }\n    emit();\n  }\n\n  function handleMessage(data: string) {\n    let msg: unknown;\n    try {\n      msg = JSON.parse(data) as unknown;\n    } catch {\n      state.lastError = { code: \"INVALID_JSON\", message: \"Invalid JSON from server\" };\n      emit();\n      return;\n    }\n    if (!isServerMessage(msg)) {\n      state.lastError = { code: \"UNKNOWN_MESSAGE\", message: \"Unknown message type\" };\n      emit();\n      return;\n    }\n    switch (msg.type) {\n      case MSG_ROOM_JOINED: {\n        const { roomId, connectionId, presence, chatHistory } = msg.payload;\n        state.currentRoomId = roomId;\n        state.connectionId = connectionId;\n        state.presence = presence ?? {};\n        state.chatMessages = chatHistory ?? [];\n        state.lastError = null;\n        emit();\n        break;\n      }\n      case MSG_PRESENCE_UPDATED: {\n        const { joined, left, updated } = msg.payload;\n        applyPresenceUpdated(joined, left, updated);\n        break;\n      }\n      case MSG_BROADCAST_EVENT_RELAY:\n        // Application can subscribe to custom events if we add an event emitter; for now we only update state for presence/chat.\n        break;\n      case MSG_CHAT_MESSAGE: {\n        const p = msg.payload;\n        const stored: StoredChatMessage = {\n          id: p.id ?? `${p.connectionId}-${p.createdAt ?? Date.now()}`,\n          roomId: p.roomId,\n          connectionId: p.connectionId,\n          userId: p.userId,\n          message: p.message,\n          metadata: p.metadata,\n          createdAt: p.createdAt ?? Date.now(),\n        };\n        if (state.currentRoomId === p.roomId) {\n          state.chatMessages = [...state.chatMessages, stored];\n          emit();\n        }\n        break;\n      }\n      case MSG_ERROR: {\n        state.lastError = msg.payload;\n        emit();\n        break;\n      }\n    }\n  }\n\n  function reconnectAndRejoin() {\n    const roomId = state.currentRoomId;\n    if (!roomId) return;\n    const presence = pendingPresence ?? (state.connectionId ? state.presence[state.connectionId]?.presence : undefined);\n    send({ type: MSG_JOIN_ROOM, payload: { roomId, presence } });\n  }\n\n  function connect() {\n    if (ws?.readyState === WebSocket.OPEN || ws?.readyState === WebSocket.CONNECTING) {\n      return;\n    }\n    intentionalClose = false;\n    setStatus(\"connecting\");\n\n    (async () => {\n      let url = baseUrl;\n      if (getAuthToken) {\n        try {\n          const token = await getAuthToken();\n          if (token) {\n            const sep = baseUrl.includes(\"?\") ? \"&\" : \"?\";\n            url = `${baseUrl}${sep}access_token=${encodeURIComponent(token)}`;\n          }\n        } catch (e) {\n          state.lastError = {\n            code: \"AUTH_ERROR\",\n            message: e instanceof Error ? e.message : String(e),\n          };\n          setStatus(\"closed\");\n          emit();\n          return;\n        }\n      }\n\n      ws = new WebSocket(url);\n\n      ws.onopen = () => {\n        setStatus(\"open\");\n        nextReconnectMs = reconnectIntervalMs;\n        reconnectAndRejoin();\n      };\n\n      ws.onmessage = (event) => {\n        const data = typeof event.data === \"string\" ? event.data : event.data.toString();\n        handleMessage(data);\n      };\n\n      ws.onclose = () => {\n        ws = null;\n        setStatus(\"closed\");\n        if (!intentionalClose) {\n          scheduleReconnect();\n        } else {\n          clearReconnect();\n        }\n      };\n\n      ws.onerror = () => {\n        state.lastError = { code: \"WEBSOCKET_ERROR\", message: \"WebSocket error\" };\n        emit();\n      };\n    })();\n  }\n\n  function disconnect() {\n    intentionalClose = true;\n    clearReconnect();\n    state.currentRoomId = null;\n    state.connectionId = null;\n    state.presence = {};\n    state.chatMessages = [];\n    pendingPresence = null;\n    if (ws) {\n      setStatus(\"closing\");\n      ws.close();\n      ws = null;\n    }\n    setStatus(\"closed\");\n  }\n\n  function joinRoom(roomId: string, presence?: Presence, accessToken?: string) {\n    if (state.currentRoomId) {\n      send({ type: MSG_LEAVE_ROOM, payload: { roomId: state.currentRoomId } });\n    }\n    state.currentRoomId = roomId;\n    state.presence = {};\n    state.chatMessages = [];\n    pendingPresence = presence ?? null;\n    const payload: { roomId: string; presence?: Presence; accessToken?: string } = { roomId };\n    if (presence !== undefined) payload.presence = presence;\n    if (accessToken !== undefined) payload.accessToken = accessToken;\n    send({ type: MSG_JOIN_ROOM, payload });\n    emit();\n  }\n\n  function leaveRoom(roomId?: string) {\n    const target = roomId ?? state.currentRoomId;\n    if (target) {\n      send({ type: MSG_LEAVE_ROOM, payload: { roomId: target } });\n      if (target === state.currentRoomId) {\n        state.currentRoomId = null;\n        state.connectionId = null;\n        state.presence = {};\n        state.chatMessages = [];\n        pendingPresence = null;\n      }\n      emit();\n    }\n  }\n\n  function updatePresence(presence: Presence) {\n    pendingPresence = presence;\n    const now = Date.now();\n    if (now - lastPresenceUpdate < presenceThrottleMs) return;\n    lastPresenceUpdate = now;\n    send({ type: MSG_UPDATE_PRESENCE, payload: { presence } });\n  }\n\n  function broadcastEvent(event: string, payload?: unknown) {\n    send({ type: MSG_BROADCAST_EVENT, payload: { event, payload } });\n  }\n\n  function sendChat(message: string, metadata?: Record<string, unknown>) {\n    send({ type: MSG_SEND_CHAT, payload: { message, metadata } });\n  }\n\n  function subscribe(listener: (state: LiveSyncClientState) => void): () => void {\n    listeners.add(listener);\n    return () => listeners.delete(listener);\n  }\n\n  return {\n    connect,\n    disconnect,\n    joinRoom,\n    leaveRoom,\n    updatePresence,\n    broadcastEvent,\n    sendChat,\n    getConnectionStatus: () => state.connectionStatus,\n    getPresence: () => ({ ...state.presence }),\n    getChatMessages: () => [...state.chatMessages],\n    getCurrentRoomId: () => state.currentRoomId,\n    getState: () => ({\n      connectionStatus: state.connectionStatus,\n      currentRoomId: state.currentRoomId,\n      connectionId: state.connectionId,\n      presence: { ...state.presence },\n      chatMessages: [...state.chatMessages],\n      lastError: state.lastError ? { ...state.lastError } : null,\n    }),\n    subscribe,\n  };\n}\n"],"mappings":"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","names":[]}