@openlivesync/client 1.0.0

package/README.md

@@ -0,0 +1,111 @@
+# @openlivesync/client
+
+Browser client for **OpenLiveSync**: connect to an `@openlivesync/server` over WebSocket for **presence**, **broadcast events**, and **chat**. Use the core API or the optional React hooks.
+
+## Installation
+
+```bash
+npm install @openlivesync/client
+```
+
+For React hooks (optional):
+
+```bash
+npm install @openlivesync/client react
+```
+
+## Core usage
+
+Create a client, connect, and join a room. Subscribe to state updates:
+
+```ts
+import { createLiveSyncClient } from "@openlivesync/client";
+
+const client = createLiveSyncClient({
+  url: "wss://localhost:3000/live",
+  reconnect: true,
+});
+
+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);
+client.subscribe((state) => console.log(state.presence));
+
+client.updatePresence({ cursor: { x: 10, y: 20 } });
+client.broadcastEvent("cursor_move", { x: 10, y: 20 });
+client.sendChat("Hello!");
+client.leaveRoom();
+client.disconnect();
+```
+
+## React usage
+
+Wrap your app in `LiveSyncProvider` (pass a pre-created `client` or config like `url`), then use hooks:
+
+```tsx
+import { LiveSyncProvider, useRoom, useChat, useConnectionStatus } from "@openlivesync/client/react";
+
+// With config (provider creates client and connects on mount)
+function App() {
+  return (
+    <LiveSyncProvider url="wss://localhost:3000/live">
+      <RoomUI roomId="room1" />
+    </LiveSyncProvider>
+  );
+}
+
+function RoomUI({ roomId }: { roomId: string }) {
+  const status = useConnectionStatus();
+  const { presence, join, leave, broadcastEvent } = useRoom(roomId);
+  const { messages, sendMessage } = useChat(roomId);
+
+  return (
+    <div>
+      <p>Status: {status}</p>
+      <button onClick={() => leave()}>Leave</button>
+      <ul>
+        {Object.entries(presence).map(([id, e]) => (
+          <li key={id}>{String(e.presence?.name ?? id)}</li>
+        ))}
+      </ul>
+      {messages.map((m) => (
+        <p key={m.id}>{m.message}</p>
+      ))}
+      <button onClick={() => sendMessage("Hi!")}>Send</button>
+    </div>
+  );
+}
+```
+
+Or pass a pre-created client:
+
+```tsx
+import { createLiveSyncClient } from "@openlivesync/client";
+import { LiveSyncProvider } from "@openlivesync/client/react";
+
+const client = createLiveSyncClient({ url: "wss://localhost:3000/live" });
+client.connect();
+
+<LiveSyncProvider client={client}>
+  <App />
+</LiveSyncProvider>
+```
+
+## API
+
+### 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.
+
+### 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.
+- **`usePresence(roomId)`** — Returns the presence map for the current room.
+- **`useChat(roomId)`** — Returns `{ messages, sendMessage }`.
+
+Protocol types and `MSG_*` constants are exported from the main entry for typing or custom handling.

package/dist/chunk-MINJGWLX.js

@@ -0,0 +1,311 @@
+// src/protocol.ts
+var MSG_JOIN_ROOM = "join_room";
+var MSG_LEAVE_ROOM = "leave_room";
+var MSG_UPDATE_PRESENCE = "update_presence";
+var MSG_BROADCAST_EVENT = "broadcast_event";
+var MSG_SEND_CHAT = "send_chat";
+var MSG_ROOM_JOINED = "room_joined";
+var MSG_PRESENCE_UPDATED = "presence_updated";
+var MSG_BROADCAST_EVENT_RELAY = "broadcast_event";
+var MSG_CHAT_MESSAGE = "chat_message";
+var MSG_ERROR = "error";
+
+// src/client.ts
+var DEFAULT_RECONNECT_INTERVAL_MS = 1e3;
+var DEFAULT_MAX_RECONNECT_INTERVAL_MS = 3e4;
+var DEFAULT_PRESENCE_THROTTLE_MS = 100;
+function isServerMessage(msg) {
+  if (msg === null || typeof msg !== "object" || !("type" in msg)) return false;
+  const t = msg.type;
+  return [
+    MSG_ROOM_JOINED,
+    MSG_PRESENCE_UPDATED,
+    MSG_BROADCAST_EVENT_RELAY,
+    MSG_CHAT_MESSAGE,
+    MSG_ERROR
+  ].includes(t);
+}
+function createLiveSyncClient(config) {
+  const {
+    url: baseUrl,
+    reconnect: reconnectEnabled = true,
+    reconnectIntervalMs = DEFAULT_RECONNECT_INTERVAL_MS,
+    maxReconnectIntervalMs = DEFAULT_MAX_RECONNECT_INTERVAL_MS,
+    getAuthToken,
+    presenceThrottleMs = DEFAULT_PRESENCE_THROTTLE_MS
+  } = config;
+  let ws = null;
+  let reconnectTimeoutId = null;
+  let nextReconnectMs = reconnectIntervalMs;
+  let intentionalClose = false;
+  let lastPresenceUpdate = 0;
+  let pendingPresence = null;
+  const state = {
+    connectionStatus: "closed",
+    currentRoomId: null,
+    connectionId: null,
+    presence: {},
+    chatMessages: [],
+    lastError: null
+  };
+  const listeners = /* @__PURE__ */ new Set();
+  function emit() {
+    const snapshot = {
+      connectionStatus: state.connectionStatus,
+      currentRoomId: state.currentRoomId,
+      connectionId: state.connectionId,
+      presence: { ...state.presence },
+      chatMessages: [...state.chatMessages],
+      lastError: state.lastError ? { ...state.lastError } : null
+    };
+    listeners.forEach((cb) => cb(snapshot));
+  }
+  function setStatus(status) {
+    state.connectionStatus = status;
+    emit();
+  }
+  function send(msg) {
+    if (!ws || ws.readyState !== WebSocket.OPEN) return;
+    ws.send(JSON.stringify(msg));
+  }
+  function clearReconnect() {
+    if (reconnectTimeoutId !== null) {
+      clearTimeout(reconnectTimeoutId);
+      reconnectTimeoutId = null;
+    }
+    nextReconnectMs = reconnectIntervalMs;
+  }
+  function scheduleReconnect() {
+    if (!reconnectEnabled || intentionalClose) return;
+    clearReconnect();
+    reconnectTimeoutId = setTimeout(() => {
+      reconnectTimeoutId = null;
+      nextReconnectMs = Math.min(
+        nextReconnectMs * 2,
+        maxReconnectIntervalMs
+      );
+      connect();
+    }, nextReconnectMs);
+  }
+  function applyPresenceUpdated(joined, left, updated) {
+    if (joined) {
+      for (const e of joined) state.presence[e.connectionId] = e;
+    }
+    if (left) {
+      for (const id of left) delete state.presence[id];
+    }
+    if (updated) {
+      for (const e of updated) state.presence[e.connectionId] = e;
+    }
+    emit();
+  }
+  function handleMessage(data) {
+    let msg;
+    try {
+      msg = JSON.parse(data);
+    } catch {
+      state.lastError = { code: "INVALID_JSON", message: "Invalid JSON from server" };
+      emit();
+      return;
+    }
+    if (!isServerMessage(msg)) {
+      state.lastError = { code: "UNKNOWN_MESSAGE", message: "Unknown message type" };
+      emit();
+      return;
+    }
+    switch (msg.type) {
+      case MSG_ROOM_JOINED: {
+        const { roomId, connectionId, presence, chatHistory } = msg.payload;
+        state.currentRoomId = roomId;
+        state.connectionId = connectionId;
+        state.presence = presence ?? {};
+        state.chatMessages = chatHistory ?? [];
+        state.lastError = null;
+        emit();
+        break;
+      }
+      case MSG_PRESENCE_UPDATED: {
+        const { joined, left, updated } = msg.payload;
+        applyPresenceUpdated(joined, left, updated);
+        break;
+      }
+      case MSG_BROADCAST_EVENT_RELAY:
+        break;
+      case MSG_CHAT_MESSAGE: {
+        const p = msg.payload;
+        const stored = {
+          id: p.id ?? `${p.connectionId}-${p.createdAt ?? Date.now()}`,
+          roomId: p.roomId,
+          connectionId: p.connectionId,
+          userId: p.userId,
+          message: p.message,
+          metadata: p.metadata,
+          createdAt: p.createdAt ?? Date.now()
+        };
+        if (state.currentRoomId === p.roomId) {
+          state.chatMessages = [...state.chatMessages, stored];
+          emit();
+        }
+        break;
+      }
+      case MSG_ERROR: {
+        state.lastError = msg.payload;
+        emit();
+        break;
+      }
+    }
+  }
+  function reconnectAndRejoin() {
+    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 } });
+  }
+  function connect() {
+    if (ws?.readyState === WebSocket.OPEN || ws?.readyState === WebSocket.CONNECTING) {
+      return;
+    }
+    intentionalClose = false;
+    setStatus("connecting");
+    (async () => {
+      let url = baseUrl;
+      if (getAuthToken) {
+        try {
+          const token = await getAuthToken();
+          if (token) {
+            const sep = baseUrl.includes("?") ? "&" : "?";
+            url = `${baseUrl}${sep}access_token=${encodeURIComponent(token)}`;
+          }
+        } catch (e) {
+          state.lastError = {
+            code: "AUTH_ERROR",
+            message: e instanceof Error ? e.message : String(e)
+          };
+          setStatus("closed");
+          emit();
+          return;
+        }
+      }
+      ws = new WebSocket(url);
+      ws.onopen = () => {
+        setStatus("open");
+        nextReconnectMs = reconnectIntervalMs;
+        reconnectAndRejoin();
+      };
+      ws.onmessage = (event) => {
+        const data = typeof event.data === "string" ? event.data : event.data.toString();
+        handleMessage(data);
+      };
+      ws.onclose = () => {
+        ws = null;
+        setStatus("closed");
+        if (!intentionalClose) {
+          scheduleReconnect();
+        } else {
+          clearReconnect();
+        }
+      };
+      ws.onerror = () => {
+        state.lastError = { code: "WEBSOCKET_ERROR", message: "WebSocket error" };
+        emit();
+      };
+    })();
+  }
+  function disconnect() {
+    intentionalClose = true;
+    clearReconnect();
+    state.currentRoomId = null;
+    state.connectionId = null;
+    state.presence = {};
+    state.chatMessages = [];
+    pendingPresence = null;
+    if (ws) {
+      setStatus("closing");
+      ws.close();
+      ws = null;
+    }
+    setStatus("closed");
+  }
+  function joinRoom(roomId, presence, accessToken) {
+    if (state.currentRoomId) {
+      send({ type: MSG_LEAVE_ROOM, payload: { roomId: state.currentRoomId } });
+    }
+    state.currentRoomId = roomId;
+    state.presence = {};
+    state.chatMessages = [];
+    pendingPresence = presence ?? null;
+    const payload = { roomId };
+    if (presence !== void 0) payload.presence = presence;
+    if (accessToken !== void 0) payload.accessToken = accessToken;
+    send({ type: MSG_JOIN_ROOM, payload });
+    emit();
+  }
+  function leaveRoom(roomId) {
+    const target = roomId ?? state.currentRoomId;
+    if (target) {
+      send({ type: MSG_LEAVE_ROOM, payload: { roomId: target } });
+      if (target === state.currentRoomId) {
+        state.currentRoomId = null;
+        state.connectionId = null;
+        state.presence = {};
+        state.chatMessages = [];
+        pendingPresence = null;
+      }
+      emit();
+    }
+  }
+  function updatePresence(presence) {
+    pendingPresence = presence;
+    const now = Date.now();
+    if (now - lastPresenceUpdate < presenceThrottleMs) return;
+    lastPresenceUpdate = now;
+    send({ type: MSG_UPDATE_PRESENCE, payload: { presence } });
+  }
+  function broadcastEvent(event, payload) {
+    send({ type: MSG_BROADCAST_EVENT, payload: { event, payload } });
+  }
+  function sendChat(message, metadata) {
+    send({ type: MSG_SEND_CHAT, payload: { message, metadata } });
+  }
+  function subscribe(listener) {
+    listeners.add(listener);
+    return () => listeners.delete(listener);
+  }
+  return {
+    connect,
+    disconnect,
+    joinRoom,
+    leaveRoom,
+    updatePresence,
+    broadcastEvent,
+    sendChat,
+    getConnectionStatus: () => state.connectionStatus,
+    getPresence: () => ({ ...state.presence }),
+    getChatMessages: () => [...state.chatMessages],
+    getCurrentRoomId: () => state.currentRoomId,
+    getState: () => ({
+      connectionStatus: state.connectionStatus,
+      currentRoomId: state.currentRoomId,
+      connectionId: state.connectionId,
+      presence: { ...state.presence },
+      chatMessages: [...state.chatMessages],
+      lastError: state.lastError ? { ...state.lastError } : null
+    }),
+    subscribe
+  };
+}
+
+export {
+  MSG_JOIN_ROOM,
+  MSG_LEAVE_ROOM,
+  MSG_UPDATE_PRESENCE,
+  MSG_BROADCAST_EVENT,
+  MSG_SEND_CHAT,
+  MSG_ROOM_JOINED,
+  MSG_PRESENCE_UPDATED,
+  MSG_BROADCAST_EVENT_RELAY,
+  MSG_CHAT_MESSAGE,
+  MSG_ERROR,
+  createLiveSyncClient
+};
+//# sourceMappingURL=chunk-MINJGWLX.js.map

package/dist/chunk-MINJGWLX.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}\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":[]}

package/dist/index.d.ts

@@ -0,0 +1,184 @@
+/**
+ * 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 };

package/dist/index.js

@@ -0,0 +1,27 @@
+import {
+  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,
+  createLiveSyncClient
+} from "./chunk-MINJGWLX.js";
+export {
+  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,
+  createLiveSyncClient
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}