@openlivesync/server 1.0.2

package/dist/connection.js

@@ -0,0 +1,170 @@
+/**
+ * Wraps a WebSocket: parse messages, throttle presence, dispatch to room.
+ */
+import { MSG_JOIN_ROOM, MSG_LEAVE_ROOM, MSG_UPDATE_PRESENCE, MSG_BROADCAST_EVENT, MSG_SEND_CHAT, MSG_ERROR, } from "./protocol.js";
+import { decodeAccessToken } from "./auth/index.js";
+function isClientMessage(msg) {
+    if (msg === null || typeof msg !== "object" || !("type" in msg))
+        return false;
+    const t = msg.type;
+    return [
+        MSG_JOIN_ROOM,
+        MSG_LEAVE_ROOM,
+        MSG_UPDATE_PRESENCE,
+        MSG_BROADCAST_EVENT,
+        MSG_SEND_CHAT,
+    ].includes(t);
+}
+function send(ws, msg) {
+    if (ws.readyState !== ws.OPEN)
+        return;
+    ws.send(JSON.stringify(msg));
+}
+export class Connection {
+    ws;
+    connectionId;
+    userId;
+    userName;
+    userEmail;
+    provider;
+    presenceThrottleMs;
+    roomManager;
+    auth;
+    currentRoomId = null;
+    lastPresenceUpdate = 0;
+    closed = false;
+    constructor(ws, options) {
+        this.ws = ws;
+        this.connectionId = options.connectionId;
+        this.userId = options.userId;
+        this.userName = options.userName;
+        this.userEmail = options.userEmail;
+        this.provider = options.provider;
+        this.presenceThrottleMs = options.presenceThrottleMs;
+        this.roomManager = options.roomManager;
+        this.auth = options.auth;
+        this.ws.on("message", (data) => this.handleMessage(data));
+        this.ws.on("close", () => this.handleClose());
+    }
+    send(msg) {
+        send(this.ws, msg);
+    }
+    handleMessage(data) {
+        if (this.closed)
+            return;
+        let msg;
+        try {
+            const raw = typeof data === "string" ? data : data.toString("utf8");
+            msg = JSON.parse(raw);
+        }
+        catch {
+            this.send({
+                type: MSG_ERROR,
+                payload: { code: "INVALID_JSON", message: "Invalid JSON" },
+            });
+            return;
+        }
+        if (!isClientMessage(msg)) {
+            this.send({
+                type: MSG_ERROR,
+                payload: { code: "INVALID_MESSAGE", message: "Unknown or invalid message type" },
+            });
+            return;
+        }
+        this.dispatch(msg).catch((err) => {
+            this.send({
+                type: MSG_ERROR,
+                payload: {
+                    code: "SERVER_ERROR",
+                    message: err instanceof Error ? err.message : String(err),
+                },
+            });
+        });
+    }
+    async dispatch(clientMsg) {
+        switch (clientMsg.type) {
+            case MSG_JOIN_ROOM: {
+                const { roomId, presence, accessToken } = clientMsg.payload;
+                if (accessToken && this.userId === undefined) {
+                    const decoded = await decodeAccessToken(accessToken, this.auth);
+                    if (decoded) {
+                        this.userId = decoded.sub;
+                        this.userName = decoded.name;
+                        this.userEmail = decoded.email;
+                        this.provider = decoded.provider;
+                    }
+                }
+                if (this.currentRoomId) {
+                    const room = this.roomManager.get(this.currentRoomId);
+                    if (room)
+                        room.leave(this.connectionId);
+                    this.roomManager.removeIfEmpty(this.currentRoomId);
+                }
+                this.currentRoomId = roomId;
+                const room = this.roomManager.getOrCreate(roomId);
+                const handle = {
+                    connectionId: this.connectionId,
+                    userId: this.userId,
+                    name: this.userName,
+                    email: this.userEmail,
+                    provider: this.provider,
+                    presence: {},
+                    send: (m) => this.send(m),
+                };
+                await room.join(handle, presence);
+                break;
+            }
+            case MSG_LEAVE_ROOM: {
+                const roomId = clientMsg.payload?.roomId ?? this.currentRoomId;
+                if (roomId && this.currentRoomId === roomId) {
+                    const room = this.roomManager.get(roomId);
+                    if (room)
+                        room.leave(this.connectionId);
+                    this.roomManager.removeIfEmpty(roomId);
+                    this.currentRoomId = null;
+                }
+                break;
+            }
+            case MSG_UPDATE_PRESENCE: {
+                const now = Date.now();
+                if (now - this.lastPresenceUpdate < this.presenceThrottleMs)
+                    return;
+                this.lastPresenceUpdate = now;
+                if (!this.currentRoomId)
+                    return;
+                const room = this.roomManager.get(this.currentRoomId);
+                if (room)
+                    room.updatePresence(this.connectionId, clientMsg.payload.presence);
+                break;
+            }
+            case MSG_BROADCAST_EVENT: {
+                if (!this.currentRoomId)
+                    return;
+                const room = this.roomManager.get(this.currentRoomId);
+                if (room) {
+                    room.broadcastEvent(this.connectionId, clientMsg.payload.event, clientMsg.payload.payload, this.userId);
+                }
+                break;
+            }
+            case MSG_SEND_CHAT: {
+                if (!this.currentRoomId)
+                    return;
+                const room = this.roomManager.get(this.currentRoomId);
+                if (room) {
+                    await room.sendChat(this.connectionId, clientMsg.payload.message, clientMsg.payload.metadata, this.userId);
+                }
+                break;
+            }
+        }
+    }
+    handleClose() {
+        this.closed = true;
+        if (this.currentRoomId) {
+            const room = this.roomManager.get(this.currentRoomId);
+            if (room)
+                room.leave(this.connectionId);
+            this.roomManager.removeIfEmpty(this.currentRoomId);
+        }
+    }
+}
+//# sourceMappingURL=connection.js.map

package/dist/connection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection.js","sourceRoot":"","sources":["../src/connection.ts"],"names":[],"mappings":"AAAA;;GAEG;AAQH,OAAO,EACL,aAAa,EACb,cAAc,EACd,mBAAmB,EACnB,mBAAmB,EACnB,aAAa,EACb,SAAS,GACV,MAAM,eAAe,CAAC;AAGvB,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAGpD,SAAS,eAAe,CAAC,GAAY;IACnC,IAAI,GAAG,KAAK,IAAI,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,CAAC,CAAC,MAAM,IAAI,GAAG,CAAC;QAAE,OAAO,KAAK,CAAC;IAC9E,MAAM,CAAC,GAAI,GAAwB,CAAC,IAAI,CAAC;IACzC,OAAO;QACL,aAAa;QACb,cAAc;QACd,mBAAmB;QACnB,mBAAmB;QACnB,aAAa;KACd,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;AAChB,CAAC;AAED,SAAS,IAAI,CAAC,EAAa,EAAE,GAAkB;IAC7C,IAAI,EAAE,CAAC,UAAU,KAAK,EAAE,CAAC,IAAI;QAAE,OAAO;IACtC,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC;AAC/B,CAAC;AAaD,MAAM,OAAO,UAAU;IACJ,EAAE,CAAY;IACd,YAAY,CAAS;IAC9B,MAAM,CAAqB;IAC3B,QAAQ,CAAqB;IAC7B,SAAS,CAAqB;IAC9B,QAAQ,CAAqB;IACpB,kBAAkB,CAAS;IAC3B,WAAW,CAAc;IACzB,IAAI,CAA0B;IACvC,aAAa,GAAkB,IAAI,CAAC;IACpC,kBAAkB,GAAG,CAAC,CAAC;IACvB,MAAM,GAAG,KAAK,CAAC;IAEvB,YAAY,EAAa,EAAE,OAA0B;QACnD,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC;QACb,IAAI,CAAC,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC;QACzC,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;QAC7B,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;QACjC,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC;QACnC,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;QACjC,IAAI,CAAC,kBAAkB,GAAG,OAAO,CAAC,kBAAkB,CAAC;QACrD,IAAI,CAAC,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC;QACvC,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;QAEzB,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC,SAAS,EAAE,CAAC,IAAqB,EAAE,EAAE,CAAC,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC;QAC3E,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;IAChD,CAAC;IAEO,IAAI,CAAC,GAAkB;QAC7B,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC;IACrB,CAAC;IAEO,aAAa,CAAC,IAAqB;QACzC,IAAI,IAAI,CAAC,MAAM;YAAE,OAAO;QACxB,IAAI,GAAY,CAAC;QACjB,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;YACpE,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAY,CAAC;QACnC,CAAC;QAAC,MAAM,CAAC;YACP,IAAI,CAAC,IAAI,CAAC;gBACR,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,EAAE,IAAI,EAAE,cAAc,EAAE,OAAO,EAAE,cAAc,EAAE;aAC3D,CAAC,CAAC;YACH,OAAO;QACT,CAAC;QACD,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,EAAE,CAAC;YAC1B,IAAI,CAAC,IAAI,CAAC;gBACR,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,EAAE,IAAI,EAAE,iBAAiB,EAAE,OAAO,EAAE,iCAAiC,EAAE;aACjF,CAAC,CAAC;YACH,OAAO;QACT,CAAC;QACD,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;YAC/B,IAAI,CAAC,IAAI,CAAC;gBACR,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE;oBACP,IAAI,EAAE,cAAc;oBACpB,OAAO,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;iBAC1D;aACF,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC;IAEO,KAAK,CAAC,QAAQ,CAAC,SAAwB;QAC7C,QAAQ,SAAS,CAAC,IAAI,EAAE,CAAC;YACvB,KAAK,aAAa,CAAC,CAAC,CAAC;gBACnB,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,WAAW,EAAE,GAAG,SAAS,CAAC,OAAO,CAAC;gBAC5D,IAAI,WAAW,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;oBAC7C,MAAM,OAAO,GAAG,MAAM,iBAAiB,CAAC,WAAW,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;oBAChE,IAAI,OAAO,EAAE,CAAC;wBACZ,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC;wBAC1B,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;wBAC7B,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,KAAK,CAAC;wBAC/B,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;oBACnC,CAAC;gBACH,CAAC;gBACD,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;oBACvB,MAAM,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;oBACtD,IAAI,IAAI;wBAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;oBACxC,IAAI,CAAC,WAAW,CAAC,aAAa,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;gBACrD,CAAC;gBACD,IAAI,CAAC,aAAa,GAAG,MAAM,CAAC;gBAC5B,MAAM,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;gBAClD,MAAM,MAAM,GAAyB;oBACnC,YAAY,EAAE,IAAI,CAAC,YAAY;oBAC/B,MAAM,EAAE,IAAI,CAAC,MAAM;oBACnB,IAAI,EAAE,IAAI,CAAC,QAAQ;oBACnB,KAAK,EAAE,IAAI,CAAC,SAAS;oBACrB,QAAQ,EAAE,IAAI,CAAC,QAAQ;oBACvB,QAAQ,EAAE,EAAE;oBACZ,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;iBAC1B,CAAC;gBACF,MAAM,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;gBAClC,MAAM;YACR,CAAC;YACD,KAAK,cAAc,CAAC,CAAC,CAAC;gBACpB,MAAM,MAAM,GAAG,SAAS,CAAC,OAAO,EAAE,MAAM,IAAI,IAAI,CAAC,aAAa,CAAC;gBAC/D,IAAI,MAAM,IAAI,IAAI,CAAC,aAAa,KAAK,MAAM,EAAE,CAAC;oBAC5C,MAAM,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;oBAC1C,IAAI,IAAI;wBAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;oBACxC,IAAI,CAAC,WAAW,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;oBACvC,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC;gBAC5B,CAAC;gBACD,MAAM;YACR,CAAC;YACD,KAAK,mBAAmB,CAAC,CAAC,CAAC;gBACzB,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;gBACvB,IAAI,GAAG,GAAG,IAAI,CAAC,kBAAkB,GAAG,IAAI,CAAC,kBAAkB;oBAAE,OAAO;gBACpE,IAAI,CAAC,kBAAkB,GAAG,GAAG,CAAC;gBAC9B,IAAI,CAAC,IAAI,CAAC,aAAa;oBAAE,OAAO;gBAChC,MAAM,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;gBACtD,IAAI,IAAI;oBAAE,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,YAAY,EAAE,SAAS,CAAC,OAAO,CAAC,QAAoB,CAAC,CAAC;gBACzF,MAAM;YACR,CAAC;YACD,KAAK,mBAAmB,CAAC,CAAC,CAAC;gBACzB,IAAI,CAAC,IAAI,CAAC,aAAa;oBAAE,OAAO;gBAChC,MAAM,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;gBACtD,IAAI,IAAI,EAAE,CAAC;oBACT,IAAI,CAAC,cAAc,CACjB,IAAI,CAAC,YAAY,EACjB,SAAS,CAAC,OAAO,CAAC,KAAK,EACvB,SAAS,CAAC,OAAO,CAAC,OAAO,EACzB,IAAI,CAAC,MAAM,CACZ,CAAC;gBACJ,CAAC;gBACD,MAAM;YACR,CAAC;YACD,KAAK,aAAa,CAAC,CAAC,CAAC;gBACnB,IAAI,CAAC,IAAI,CAAC,aAAa;oBAAE,OAAO;gBAChC,MAAM,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;gBACtD,IAAI,IAAI,EAAE,CAAC;oBACT,MAAM,IAAI,CAAC,QAAQ,CACjB,IAAI,CAAC,YAAY,EACjB,SAAS,CAAC,OAAO,CAAC,OAAO,EACzB,SAAS,CAAC,OAAO,CAAC,QAAQ,EAC1B,IAAI,CAAC,MAAM,CACZ,CAAC;gBACJ,CAAC;gBACD,MAAM;YACR,CAAC;QACH,CAAC;IACH,CAAC;IAEO,WAAW;QACjB,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;QACnB,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;YACvB,MAAM,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;YACtD,IAAI,IAAI;gBAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;YACxC,IAAI,CAAC,WAAW,CAAC,aAAa,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QACrD,CAAC;IACH,CAAC;CACF"}

package/dist/index.d.ts

@@ -0,0 +1,19 @@
+/**
+ * @openlivesync/server - Node.js package for collaboration, presence, and chat.
+ * Export all public API and protocol types for use in a Node.js backend.
+ */
+export { createServer, createWebSocketServer, createWebSocketHandler, type ServerOptions, type WebSocketServerOptions, type ChatOptions, } from "./server.js";
+export type { Presence, UserInfo, ClientMessage, ServerMessage, JoinRoomPayload, LeaveRoomPayload, UpdatePresencePayload, BroadcastEventPayload, SendChatPayload, PresenceEntry, RoomJoinedPayload, PresenceUpdatedPayload, BroadcastEventRelayPayload, ChatMessagePayload, StoredChatMessage, ErrorPayload, ChatMessageInput, } from "./protocol.js";
+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, } from "./protocol.js";
+export { decodeAccessToken, createTokenAuth } from "./auth/index.js";
+export type { AuthOptions, AuthGoogleConfig, AuthMicrosoftConfig, AuthCustomConfig, CreateTokenAuthOptions, DecodedToken, } from "./auth/index.js";
+export type { ChatStorage } from "./storage/chat-storage.js";
+export { createInMemoryChatStorage } from "./storage/in-memory.js";
+export type { InMemoryChatStorageOptions } from "./storage/in-memory.js";
+export { createPostgresChatStorage } from "./storage/postgres.js";
+export type { PostgresChatStorageOptions, PostgresConnectionConfig, } from "./storage/postgres.js";
+export { createMySQLChatStorage } from "./storage/mysql.js";
+export type { MySQLChatStorageOptions, MySQLConnectionConfig, } from "./storage/mysql.js";
+export { createSQLiteChatStorage } from "./storage/sqlite.js";
+export type { SQLiteChatStorageOptions, SQLiteConnectionConfig, } from "./storage/sqlite.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EACL,YAAY,EACZ,qBAAqB,EACrB,sBAAsB,EACtB,KAAK,aAAa,EAClB,KAAK,sBAAsB,EAC3B,KAAK,WAAW,GACjB,MAAM,aAAa,CAAC;AAGrB,YAAY,EACV,QAAQ,EACR,QAAQ,EACR,aAAa,EACb,aAAa,EACb,eAAe,EACf,gBAAgB,EAChB,qBAAqB,EACrB,qBAAqB,EACrB,eAAe,EACf,aAAa,EACb,iBAAiB,EACjB,sBAAsB,EACtB,0BAA0B,EAC1B,kBAAkB,EAClB,iBAAiB,EACjB,YAAY,EACZ,gBAAgB,GACjB,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,aAAa,EACb,cAAc,EACd,mBAAmB,EACnB,mBAAmB,EACnB,aAAa,EACb,eAAe,EACf,oBAAoB,EACpB,yBAAyB,EACzB,gBAAgB,EAChB,SAAS,GACV,MAAM,eAAe,CAAC;AAGvB,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AACrE,YAAY,EACV,WAAW,EACX,gBAAgB,EAChB,mBAAmB,EACnB,gBAAgB,EAChB,sBAAsB,EACtB,YAAY,GACb,MAAM,iBAAiB,CAAC;AAGzB,YAAY,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAC7D,OAAO,EAAE,yBAAyB,EAAE,MAAM,wBAAwB,CAAC;AACnE,YAAY,EAAE,0BAA0B,EAAE,MAAM,wBAAwB,CAAC;AAGzE,OAAO,EAAE,yBAAyB,EAAE,MAAM,uBAAuB,CAAC;AAClE,YAAY,EACV,0BAA0B,EAC1B,wBAAwB,GACzB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAC5D,YAAY,EACV,uBAAuB,EACvB,qBAAqB,GACtB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AAC9D,YAAY,EACV,wBAAwB,EACxB,sBAAsB,GACvB,MAAM,qBAAqB,CAAC"}

package/dist/index.js

@@ -0,0 +1,15 @@
+/**
+ * @openlivesync/server - Node.js package for collaboration, presence, and chat.
+ * Export all public API and protocol types for use in a Node.js backend.
+ */
+// Server API
+export { createServer, createWebSocketServer, createWebSocketHandler, } from "./server.js";
+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, } from "./protocol.js";
+// Auth (decode/verify access tokens; Google, Microsoft, custom OAuth)
+export { decodeAccessToken, createTokenAuth } from "./auth/index.js";
+export { createInMemoryChatStorage } from "./storage/in-memory.js";
+// Optional DB adapters (require pg / mysql2 / better-sqlite3 to be installed)
+export { createPostgresChatStorage } from "./storage/postgres.js";
+export { createMySQLChatStorage } from "./storage/mysql.js";
+export { createSQLiteChatStorage } from "./storage/sqlite.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,aAAa;AACb,OAAO,EACL,YAAY,EACZ,qBAAqB,EACrB,sBAAsB,GAIvB,MAAM,aAAa,CAAC;AAsBrB,OAAO,EACL,aAAa,EACb,cAAc,EACd,mBAAmB,EACnB,mBAAmB,EACnB,aAAa,EACb,eAAe,EACf,oBAAoB,EACpB,yBAAyB,EACzB,gBAAgB,EAChB,SAAS,GACV,MAAM,eAAe,CAAC;AAEvB,sEAAsE;AACtE,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAYrE,OAAO,EAAE,yBAAyB,EAAE,MAAM,wBAAwB,CAAC;AAGnE,8EAA8E;AAC9E,OAAO,EAAE,yBAAyB,EAAE,MAAM,uBAAuB,CAAC;AAKlE,OAAO,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAK5D,OAAO,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/protocol.d.ts

@@ -0,0 +1,135 @@
+/**
+ * Wire protocol types for @openlivesync.
+ * Shared between server and client; server handles these message types.
+ */
+/** Generic presence payload (cursor, name, color, etc.). Server does not interpret. */
+export type Presence = Record<string, unknown>;
+/** User/session info attached by server from auth (optional). */
+export interface UserInfo {
+    userId?: string;
+    name?: string;
+    email?: string;
+    provider?: string;
+    [key: string]: unknown;
+}
+export declare const MSG_JOIN_ROOM = "join_room";
+export declare const MSG_LEAVE_ROOM = "leave_room";
+export declare const MSG_UPDATE_PRESENCE = "update_presence";
+export declare const MSG_BROADCAST_EVENT = "broadcast_event";
+export declare const MSG_SEND_CHAT = "send_chat";
+export interface JoinRoomPayload {
+    roomId: string;
+    presence?: Presence;
+    /** Optional OAuth/OpenID access token; server decodes to get name, email, provider. */
+    accessToken?: string;
+}
+export interface LeaveRoomPayload {
+    roomId?: string;
+}
+export interface UpdatePresencePayload {
+    presence: Presence;
+}
+export interface BroadcastEventPayload {
+    event: string;
+    payload?: unknown;
+}
+export interface SendChatPayload {
+    message: string;
+    /** Optional application-defined metadata */
+    metadata?: Record<string, unknown>;
+}
+export 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;
+};
+export declare const MSG_ROOM_JOINED = "room_joined";
+export declare const MSG_PRESENCE_UPDATED = "presence_updated";
+export declare const MSG_BROADCAST_EVENT_RELAY = "broadcast_event";
+export declare const MSG_CHAT_MESSAGE = "chat_message";
+export declare const MSG_ERROR = "error";
+export interface PresenceEntry {
+    connectionId: string;
+    userId?: string;
+    name?: string;
+    email?: string;
+    provider?: string;
+    presence: Presence;
+}
+export interface RoomJoinedPayload {
+    roomId: string;
+    connectionId: string;
+    presence: Record<string, PresenceEntry>;
+    chatHistory?: StoredChatMessage[];
+}
+export interface PresenceUpdatedPayload {
+    roomId: string;
+    joined?: PresenceEntry[];
+    left?: string[];
+    updated?: PresenceEntry[];
+}
+export interface BroadcastEventRelayPayload {
+    roomId: string;
+    connectionId: string;
+    userId?: string;
+    event: string;
+    payload?: unknown;
+}
+export interface ChatMessagePayload {
+    roomId: string;
+    connectionId: string;
+    userId?: string;
+    message: string;
+    metadata?: Record<string, unknown>;
+    id?: string;
+    createdAt?: number;
+}
+export interface StoredChatMessage {
+    id: string;
+    roomId: string;
+    connectionId: string;
+    userId?: string;
+    message: string;
+    metadata?: Record<string, unknown>;
+    createdAt: number;
+}
+export interface ErrorPayload {
+    code: string;
+    message: string;
+}
+export 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). */
+export interface ChatMessageInput {
+    roomId: string;
+    connectionId: string;
+    userId?: string;
+    message: string;
+    metadata?: Record<string, unknown>;
+}
+//# sourceMappingURL=protocol.d.ts.map

package/dist/protocol.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.d.ts","sourceRoot":"","sources":["../src/protocol.ts"],"names":[],"mappings":"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"}

package/dist/protocol.js

@@ -0,0 +1,17 @@
+/**
+ * Wire protocol types for @openlivesync.
+ * Shared between server and client; server handles these message types.
+ */
+// ----- Client → Server message types -----
+export const MSG_JOIN_ROOM = "join_room";
+export const MSG_LEAVE_ROOM = "leave_room";
+export const MSG_UPDATE_PRESENCE = "update_presence";
+export const MSG_BROADCAST_EVENT = "broadcast_event";
+export const MSG_SEND_CHAT = "send_chat";
+// ----- Server → Client message types -----
+export const MSG_ROOM_JOINED = "room_joined";
+export const MSG_PRESENCE_UPDATED = "presence_updated";
+export const MSG_BROADCAST_EVENT_RELAY = "broadcast_event";
+export const MSG_CHAT_MESSAGE = "chat_message";
+export const MSG_ERROR = "error";
+//# sourceMappingURL=protocol.js.map

package/dist/protocol.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.js","sourceRoot":"","sources":["../src/protocol.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAcH,4CAA4C;AAE5C,MAAM,CAAC,MAAM,aAAa,GAAG,WAAW,CAAC;AACzC,MAAM,CAAC,MAAM,cAAc,GAAG,YAAY,CAAC;AAC3C,MAAM,CAAC,MAAM,mBAAmB,GAAG,iBAAiB,CAAC;AACrD,MAAM,CAAC,MAAM,mBAAmB,GAAG,iBAAiB,CAAC;AACrD,MAAM,CAAC,MAAM,aAAa,GAAG,WAAW,CAAC;AAmCzC,4CAA4C;AAE5C,MAAM,CAAC,MAAM,eAAe,GAAG,aAAa,CAAC;AAC7C,MAAM,CAAC,MAAM,oBAAoB,GAAG,kBAAkB,CAAC;AACvD,MAAM,CAAC,MAAM,yBAAyB,GAAG,iBAAiB,CAAC;AAC3D,MAAM,CAAC,MAAM,gBAAgB,GAAG,cAAc,CAAC;AAC/C,MAAM,CAAC,MAAM,SAAS,GAAG,OAAO,CAAC"}

package/dist/room-manager.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Manages rooms: get-or-create by roomId.
+ */
+import { Room } from "./room.js";
+import type { ChatStorage } from "./storage/chat-storage.js";
+export interface RoomManagerOptions {
+    chatStorage: ChatStorage;
+    historyLimit: number;
+}
+export declare class RoomManager {
+    private readonly options;
+    private readonly rooms;
+    constructor(options: RoomManagerOptions);
+    getOrCreate(roomId: string): Room;
+    get(roomId: string): Room | undefined;
+    /** Remove room when empty (optional cleanup). */
+    removeIfEmpty(roomId: string): void;
+}
+//# sourceMappingURL=room-manager.d.ts.map

package/dist/room-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"room-manager.d.ts","sourceRoot":"","sources":["../src/room-manager.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAE7D,MAAM,WAAW,kBAAkB;IACjC,WAAW,EAAE,WAAW,CAAC;IACzB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAqB;IAC7C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA2B;gBAErC,OAAO,EAAE,kBAAkB;IAIvC,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAajC,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS;IAIrC,iDAAiD;IACjD,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;CAMpC"}

package/dist/room-manager.js

@@ -0,0 +1,34 @@
+/**
+ * Manages rooms: get-or-create by roomId.
+ */
+import { Room } from "./room.js";
+export class RoomManager {
+    options;
+    rooms = new Map();
+    constructor(options) {
+        this.options = options;
+    }
+    getOrCreate(roomId) {
+        let room = this.rooms.get(roomId);
+        if (!room) {
+            room = new Room({
+                roomId,
+                chatStorage: this.options.chatStorage,
+                historyLimit: this.options.historyLimit,
+            });
+            this.rooms.set(roomId, room);
+        }
+        return room;
+    }
+    get(roomId) {
+        return this.rooms.get(roomId);
+    }
+    /** Remove room when empty (optional cleanup). */
+    removeIfEmpty(roomId) {
+        const room = this.rooms.get(roomId);
+        if (room && room.connectionCount === 0) {
+            this.rooms.delete(roomId);
+        }
+    }
+}
+//# sourceMappingURL=room-manager.js.map

package/dist/room-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"room-manager.js","sourceRoot":"","sources":["../src/room-manager.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAQjC,MAAM,OAAO,WAAW;IACL,OAAO,CAAqB;IAC5B,KAAK,GAAG,IAAI,GAAG,EAAgB,CAAC;IAEjD,YAAY,OAA2B;QACrC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAED,WAAW,CAAC,MAAc;QACxB,IAAI,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAClC,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,IAAI,GAAG,IAAI,IAAI,CAAC;gBACd,MAAM;gBACN,WAAW,EAAE,IAAI,CAAC,OAAO,CAAC,WAAW;gBACrC,YAAY,EAAE,IAAI,CAAC,OAAO,CAAC,YAAY;aACxC,CAAC,CAAC;YACH,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;QAC/B,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,GAAG,CAAC,MAAc;QAChB,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAChC,CAAC;IAED,iDAAiD;IACjD,aAAa,CAAC,MAAc;QAC1B,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACpC,IAAI,IAAI,IAAI,IAAI,CAAC,eAAe,KAAK,CAAC,EAAE,CAAC;YACvC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAC5B,CAAC;IACH,CAAC;CACF"}

package/dist/room.d.ts

@@ -0,0 +1,41 @@
+/**
+ * A single room: connections, presence map, broadcast, and chat.
+ */
+import type { Presence, ServerMessage } from "./protocol.js";
+import type { ChatStorage } from "./storage/chat-storage.js";
+/** Handle the room uses to send messages to a connection. */
+export interface RoomConnectionHandle {
+    connectionId: string;
+    userId?: string;
+    name?: string;
+    email?: string;
+    provider?: string;
+    presence: Presence;
+    send(msg: ServerMessage): void;
+}
+export interface RoomOptions {
+    roomId: string;
+    chatStorage: ChatStorage;
+    historyLimit: number;
+}
+export declare class Room {
+    private readonly roomId;
+    private readonly chatStorage;
+    private readonly historyLimit;
+    private readonly connections;
+    constructor(options: RoomOptions);
+    get connectionCount(): number;
+    /** Add connection to room; send room_joined to connection and presence_updated (joined) to others. */
+    join(handle: RoomConnectionHandle, initialPresence?: Presence): Promise<void>;
+    /** Remove connection and notify others. */
+    leave(connectionId: string): void;
+    /** Update presence for a connection and broadcast updated entry. */
+    updatePresence(connectionId: string, presence: Presence): void;
+    /** Relay collaboration event to other clients in the room. */
+    broadcastEvent(connectionId: string, event: string, payload: unknown, userId?: string): void;
+    /** Append chat message to storage and broadcast to all in room. */
+    sendChat(connectionId: string, message: string, metadata: Record<string, unknown> | undefined, userId?: string): Promise<void>;
+    private broadcast;
+    private broadcastExcept;
+}
+//# sourceMappingURL=room.d.ts.map

package/dist/room.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"room.d.ts","sourceRoot":"","sources":["../src/room.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EACV,QAAQ,EAER,aAAa,EAEd,MAAM,eAAe,CAAC;AAOvB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAE7D,6DAA6D;AAC7D,MAAM,WAAW,oBAAoB;IACnC,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,QAAQ,CAAC;IACnB,IAAI,CAAC,GAAG,EAAE,aAAa,GAAG,IAAI,CAAC;CAChC;AAED,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,WAAW,CAAC;IACzB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,qBAAa,IAAI;IACf,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAc;IAC1C,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA2C;gBAE3D,OAAO,EAAE,WAAW;IAMhC,IAAI,eAAe,IAAI,MAAM,CAE5B;IAED,sGAAsG;IAChG,IAAI,CACR,MAAM,EAAE,oBAAoB,EAC5B,eAAe,GAAE,QAAa,GAC7B,OAAO,CAAC,IAAI,CAAC;IAyDhB,2CAA2C;IAC3C,KAAK,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI;IAWjC,oEAAoE;IACpE,cAAc,CAAC,YAAY,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,GAAG,IAAI;IAsB9D,8DAA8D;IAC9D,cAAc,CACZ,YAAY,EAAE,MAAM,EACpB,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,OAAO,EAChB,MAAM,CAAC,EAAE,MAAM,GACd,IAAI;IAaP,mEAAmE;IAC7D,QAAQ,CACZ,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,EAC7C,MAAM,CAAC,EAAE,MAAM,GACd,OAAO,CAAC,IAAI,CAAC;IAqBhB,OAAO,CAAC,SAAS;IAMjB,OAAO,CAAC,eAAe;CAOxB"}

package/dist/room.js

@@ -0,0 +1,150 @@
+/**
+ * A single room: connections, presence map, broadcast, and chat.
+ */
+import { MSG_CHAT_MESSAGE, MSG_PRESENCE_UPDATED, MSG_ROOM_JOINED, MSG_BROADCAST_EVENT_RELAY, } from "./protocol.js";
+export class Room {
+    roomId;
+    chatStorage;
+    historyLimit;
+    connections = new Map();
+    constructor(options) {
+        this.roomId = options.roomId;
+        this.chatStorage = options.chatStorage;
+        this.historyLimit = options.historyLimit;
+    }
+    get connectionCount() {
+        return this.connections.size;
+    }
+    /** Add connection to room; send room_joined to connection and presence_updated (joined) to others. */
+    async join(handle, initialPresence = {}) {
+        const entry = {
+            ...handle,
+            presence: { ...initialPresence },
+        };
+        this.connections.set(handle.connectionId, entry);
+        const presenceMap = {};
+        for (const [, c] of this.connections) {
+            presenceMap[c.connectionId] = {
+                connectionId: c.connectionId,
+                userId: c.userId,
+                name: c.name,
+                email: c.email,
+                provider: c.provider,
+                presence: c.presence,
+            };
+        }
+        let chatHistory;
+        try {
+            chatHistory = await this.chatStorage.getHistory(this.roomId, this.historyLimit);
+        }
+        catch {
+            chatHistory = [];
+        }
+        handle.send({
+            type: MSG_ROOM_JOINED,
+            payload: {
+                roomId: this.roomId,
+                connectionId: handle.connectionId,
+                presence: presenceMap,
+                chatHistory,
+            },
+        });
+        this.broadcastExcept(handle.connectionId, {
+            type: MSG_PRESENCE_UPDATED,
+            payload: {
+                roomId: this.roomId,
+                joined: [
+                    {
+                        connectionId: handle.connectionId,
+                        userId: handle.userId,
+                        name: handle.name,
+                        email: handle.email,
+                        provider: handle.provider,
+                        presence: entry.presence,
+                    },
+                ],
+            },
+        });
+    }
+    /** Remove connection and notify others. */
+    leave(connectionId) {
+        this.connections.delete(connectionId);
+        this.broadcast({
+            type: MSG_PRESENCE_UPDATED,
+            payload: {
+                roomId: this.roomId,
+                left: [connectionId],
+            },
+        });
+    }
+    /** Update presence for a connection and broadcast updated entry. */
+    updatePresence(connectionId, presence) {
+        const conn = this.connections.get(connectionId);
+        if (!conn)
+            return;
+        conn.presence = { ...presence };
+        this.broadcastExcept(connectionId, {
+            type: MSG_PRESENCE_UPDATED,
+            payload: {
+                roomId: this.roomId,
+                updated: [
+                    {
+                        connectionId: conn.connectionId,
+                        userId: conn.userId,
+                        name: conn.name,
+                        email: conn.email,
+                        provider: conn.provider,
+                        presence: conn.presence,
+                    },
+                ],
+            },
+        });
+    }
+    /** Relay collaboration event to other clients in the room. */
+    broadcastEvent(connectionId, event, payload, userId) {
+        this.broadcastExcept(connectionId, {
+            type: MSG_BROADCAST_EVENT_RELAY,
+            payload: {
+                roomId: this.roomId,
+                connectionId,
+                userId,
+                event,
+                payload,
+            },
+        });
+    }
+    /** Append chat message to storage and broadcast to all in room. */
+    async sendChat(connectionId, message, metadata, userId) {
+        await this.chatStorage.append(this.roomId, {
+            roomId: this.roomId,
+            connectionId,
+            userId,
+            message,
+            metadata,
+        });
+        const payload = {
+            roomId: this.roomId,
+            connectionId,
+            userId,
+            message,
+            metadata,
+        };
+        this.broadcast({
+            type: MSG_CHAT_MESSAGE,
+            payload,
+        });
+    }
+    broadcast(msg) {
+        for (const conn of this.connections.values()) {
+            conn.send(msg);
+        }
+    }
+    broadcastExcept(exceptConnectionId, msg) {
+        for (const conn of this.connections.values()) {
+            if (conn.connectionId !== exceptConnectionId) {
+                conn.send(msg);
+            }
+        }
+    }
+}
+//# sourceMappingURL=room.js.map

package/dist/room.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"room.js","sourceRoot":"","sources":["../src/room.ts"],"names":[],"mappings":"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"}