@tailuge/messaging 1.0.0

package/README.md

@@ -0,0 +1,81 @@
+# Billiards Messaging Client
+
+A stateful messaging library for Nchan-powered real-time applications. This library handles presence, heartbeats, matchmaking (challenges), and game table communication.
+
+## Quick Start
+
+### 1. Install Dependencies
+```bash
+npm install
+```
+
+### 2. Run Nchan Server (Docker)
+The library requires an Nchan server for transport. You can start the local development server using:
+```bash
+npm run docker:nchan
+```
+To stop the server:
+```bash
+npm run docker:stop
+```
+
+### 3. Run the Example
+```bash
+npm run example
+```
+Then open [http://localhost:3000](http://localhost:3000) in multiple tabs to test presence and challenges.
+
+---
+
+## Testing
+
+The project includes three levels of testing:
+
+### 1. Unit & Integration Tests (Jest)
+Comprehensive tests for `MessagingClient`, `Lobby`, and `Table` logic. These use `testcontainers` to automatically spin up an Nchan instance.
+```bash
+npm run test
+```
+To debug leaks or hanging processes:
+```bash
+npx jest --config test/jest.config.js --detectOpenHandles --forceExit
+```
+
+### 2. Browser Connection Tests (Playwright)
+Verifies that the client correctly connects and communicates within a real browser environment.
+```bash
+npm run test:debug
+```
+
+### 3. Nchan Configuration Tests (Shell)
+A suite of `curl`-based tests to verify that the Nchan server endpoints and metadata enrichment are working correctly.
+```bash
+# Ensure local docker is running first
+npm run docker:nchan
+./docker/testnchan.sh
+```
+
+---
+
+## Building
+
+### Library & Example
+The example is bundled using `esbuild`:
+```bash
+npm run build:example
+```
+
+### Docker Image
+To rebuild the Nchan server image:
+```bash
+npm run docker:build
+```
+
+---
+
+## Development
+
+- **Linting**: `npm run lint`
+- **Formatting**: `npm run format`
+- **Specification**: See [MESSAGING_SPEC.md](./MESSAGING_SPEC.md) for the API contract and data models.
+- **Architectural Overview**: See [AGENTS.md](./AGENTS.md) for the design patterns used.

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export * from "./messagingclient";
+export * from "./lobby";
+export * from "./table";
+export * from "./types";
+export * from "./nchanclient";

package/dist/index.js

@@ -0,0 +1,6 @@
+export * from "./messagingclient";
+export * from "./lobby";
+export * from "./table";
+export * from "./types";
+export * from "./nchanclient";
+//# 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,cAAc,mBAAmB,CAAC;AAClC,cAAc,SAAS,CAAC;AACxB,cAAc,SAAS,CAAC;AACxB,cAAc,SAAS,CAAC;AACxB,cAAc,eAAe,CAAC"}

package/dist/lobby.d.ts

@@ -0,0 +1,87 @@
+import { NchanClient } from "./nchanclient";
+import { PresenceMessage, ChallengeMessage } from "./types";
+import { Table } from "./table";
+export interface LobbyOptions {
+    heartbeatInterval?: number;
+    pruneInterval?: number;
+    staleTtl?: number;
+}
+/**
+ * Manages the global lobby state, including real-time presence tracking and challenge flows.
+ */
+export declare class Lobby {
+    private nchan;
+    currentUser: PresenceMessage;
+    private users;
+    private listeners;
+    private challengeListeners;
+    private subscription;
+    private isJoined;
+    private heartbeatTimer?;
+    private pruneTimer?;
+    private readonly heartbeatInterval;
+    private readonly pruneInterval;
+    private readonly staleTtl;
+    constructor(nchan: NchanClient, currentUser: PresenceMessage, options?: LobbyOptions);
+    /**
+     * Initializes the lobby by subscribing to presence events and broadcasting "join".
+     */
+    join(): Promise<void>;
+    /**
+     * Pauses the heartbeat timer (e.g. when tab is hidden).
+     */
+    pauseHeartbeat(): void;
+    /**
+     * Resumes the heartbeat timer (e.g. when tab becomes visible).
+     */
+    resumeHeartbeat(): void;
+    private startHeartbeat;
+    private stopHeartbeat;
+    private startPruning;
+    private stopPruning;
+    /**
+     * Emits the current list of online users whenever it changes.
+     */
+    onUsersChange(callback: (users: PresenceMessage[]) => void): void;
+    /**
+     * Stop listening to user changes.
+     */
+    offUsersChange(callback: (users: PresenceMessage[]) => void): void;
+    /**
+     * Allows updating the current user's status (e.g. name or playing state).
+     */
+    updatePresence(update: Partial<PresenceMessage>): Promise<void>;
+    /**
+     * Challenge another user to a game.
+     * Returns the ID of the table created for the challenge.
+     */
+    challenge(userId: string, ruleType: string): Promise<string>;
+    /**
+     * Accept an incoming challenge.
+     * Returns the Table instance for the accepted game.
+     */
+    acceptChallenge(userId: string, ruleType: string, tableId: string): Promise<Table>;
+    /**
+     * Decline an incoming challenge.
+     */
+    declineChallenge(userId: string, ruleType: string): Promise<void>;
+    /**
+     * Cancel an outgoing challenge.
+     */
+    cancelChallenge(userId: string, ruleType: string): Promise<void>;
+    /**
+     * Subscribe to incoming challenges directed at the current user.
+     */
+    onChallenge(callback: (challenge: ChallengeMessage) => void): void;
+    /**
+     * Gracefully leaves the lobby.
+     */
+    leave(options?: {
+        isTeardown?: boolean;
+    }): Promise<void>;
+    private handleIncomingMessage;
+    private handlePresenceUpdate;
+    private handleChallenge;
+    private notifyListeners;
+    private getUsersList;
+}

package/dist/lobby.js

@@ -0,0 +1,243 @@
+import { parseMessage } from "./types";
+import { Table } from "./table";
+import { getUID } from "./utils/uid";
+/**
+ * Manages the global lobby state, including real-time presence tracking and challenge flows.
+ */
+export class Lobby {
+    nchan;
+    currentUser;
+    users = new Map();
+    listeners = [];
+    challengeListeners = [];
+    subscription = null;
+    isJoined = false;
+    heartbeatTimer;
+    pruneTimer;
+    heartbeatInterval;
+    pruneInterval;
+    staleTtl;
+    constructor(nchan, currentUser, options = {}) {
+        this.nchan = nchan;
+        this.currentUser = currentUser;
+        this.heartbeatInterval = options.heartbeatInterval || 30000;
+        this.pruneInterval = options.pruneInterval || 10000;
+        this.staleTtl = options.staleTtl || 90000;
+    }
+    /**
+     * Initializes the lobby by subscribing to presence events and broadcasting "join".
+     */
+    async join() {
+        if (this.isJoined)
+            return;
+        this.subscription = this.nchan.subscribePresence((data) => {
+            this.handleIncomingMessage(data);
+        });
+        await this.subscription.ready;
+        // Broadcast our own presence
+        await this.nchan.publishPresence(this.currentUser);
+        this.startHeartbeat();
+        this.startPruning();
+        this.isJoined = true;
+    }
+    /**
+     * Pauses the heartbeat timer (e.g. when tab is hidden).
+     */
+    pauseHeartbeat() {
+        this.stopHeartbeat();
+    }
+    /**
+     * Resumes the heartbeat timer (e.g. when tab becomes visible).
+     */
+    resumeHeartbeat() {
+        this.startHeartbeat();
+    }
+    startHeartbeat() {
+        this.stopHeartbeat();
+        this.heartbeatTimer = setInterval(async () => {
+            try {
+                await this.nchan.publishPresence({
+                    ...this.currentUser,
+                    type: "heartbeat",
+                });
+            }
+            catch (_e) {
+                console.error("Failed to send heartbeat:", _e);
+            }
+        }, this.heartbeatInterval);
+    }
+    stopHeartbeat() {
+        if (this.heartbeatTimer) {
+            clearInterval(this.heartbeatTimer);
+            this.heartbeatTimer = undefined;
+        }
+    }
+    startPruning() {
+        this.stopPruning();
+        this.pruneTimer = setInterval(() => {
+            const now = Date.now();
+            let changed = false;
+            for (const [userId, user] of this.users.entries()) {
+                if (userId === this.currentUser.userId)
+                    continue;
+                // Use lastSeen (ms) or fall back to current time if just joined
+                const lastSeen = user.lastSeen || now;
+                if (now - lastSeen > this.staleTtl) {
+                    this.users.delete(userId);
+                    changed = true;
+                }
+            }
+            if (changed) {
+                this.notifyListeners();
+            }
+        }, this.pruneInterval);
+    }
+    stopPruning() {
+        if (this.pruneTimer) {
+            clearInterval(this.pruneTimer);
+            this.pruneTimer = undefined;
+        }
+    }
+    /**
+     * Emits the current list of online users whenever it changes.
+     */
+    onUsersChange(callback) {
+        this.listeners.push(callback);
+        // Immediate emit of current state to the new listener
+        callback(this.getUsersList());
+    }
+    /**
+     * Stop listening to user changes.
+     */
+    offUsersChange(callback) {
+        this.listeners = this.listeners.filter((l) => l !== callback);
+    }
+    /**
+     * Allows updating the current user's status (e.g. name or playing state).
+     */
+    async updatePresence(update) {
+        this.currentUser = { ...this.currentUser, ...update };
+        await this.nchan.publishPresence(this.currentUser);
+    }
+    /**
+     * Challenge another user to a game.
+     * Returns the ID of the table created for the challenge.
+     */
+    async challenge(userId, ruleType) {
+        const tableId = getUID();
+        await this.nchan.publishChallenge({
+            type: "offer",
+            challengerId: this.currentUser.userId,
+            challengerName: this.currentUser.userName,
+            recipientId: userId,
+            ruleType,
+            tableId,
+        });
+        return tableId;
+    }
+    /**
+     * Accept an incoming challenge.
+     * Returns the Table instance for the accepted game.
+     */
+    async acceptChallenge(userId, ruleType, tableId) {
+        await this.nchan.publishChallenge({
+            type: "accept",
+            challengerId: this.currentUser.userId,
+            challengerName: this.currentUser.userName,
+            recipientId: userId,
+            ruleType,
+            tableId,
+        });
+        // Automatically update our presence to show we've joined the table
+        await this.updatePresence({ tableId });
+        const table = new Table(this.nchan, tableId, this.currentUser.userId, this);
+        await table.join();
+        return table;
+    }
+    /**
+     * Decline an incoming challenge.
+     */
+    async declineChallenge(userId, ruleType) {
+        await this.nchan.publishChallenge({
+            type: "decline",
+            challengerId: this.currentUser.userId,
+            challengerName: this.currentUser.userName,
+            recipientId: userId,
+            ruleType,
+        });
+    }
+    /**
+     * Cancel an outgoing challenge.
+     */
+    async cancelChallenge(userId, ruleType) {
+        await this.nchan.publishChallenge({
+            type: "cancel",
+            challengerId: this.currentUser.userId,
+            challengerName: this.currentUser.userName,
+            recipientId: userId,
+            ruleType,
+        });
+    }
+    /**
+     * Subscribe to incoming challenges directed at the current user.
+     */
+    onChallenge(callback) {
+        this.challengeListeners.push(callback);
+    }
+    /**
+     * Gracefully leaves the lobby.
+     */
+    async leave(options = {}) {
+        this.stopHeartbeat();
+        this.stopPruning();
+        this.subscription?.stop();
+        try {
+            await this.nchan.publishPresence({
+                ...this.currentUser,
+                type: "leave",
+            }, { keepalive: options.isTeardown });
+        }
+        catch (e) {
+            console.error("Error leaving lobby:", e);
+        }
+        this.users.clear();
+        this.notifyListeners();
+        this.isJoined = false;
+    }
+    handleIncomingMessage(data) {
+        const rawMsg = parseMessage(data);
+        if (!rawMsg)
+            return;
+        if (rawMsg.messageType === "presence") {
+            this.handlePresenceUpdate(rawMsg);
+        }
+        else if (rawMsg.messageType === "challenge") {
+            this.handleChallenge(rawMsg);
+        }
+    }
+    handlePresenceUpdate(msg) {
+        if (msg.type === "leave") {
+            this.users.delete(msg.userId);
+        }
+        else {
+            // Use local time for real-time pruning to avoid clock skew
+            msg.lastSeen = Date.now();
+            this.users.set(msg.userId, msg);
+        }
+        this.notifyListeners();
+    }
+    handleChallenge(msg) {
+        // Filter messages directed at us (or broadcasted ones)
+        if (msg.recipientId === this.currentUser.userId) {
+            this.challengeListeners.forEach((cb) => cb(msg));
+        }
+    }
+    notifyListeners() {
+        const list = this.getUsersList();
+        this.listeners.forEach((cb) => cb(list));
+    }
+    getUsersList() {
+        return Array.from(this.users.values());
+    }
+}
+//# sourceMappingURL=lobby.js.map

package/dist/lobby.js.map

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

package/dist/messagingclient.d.ts

@@ -0,0 +1,39 @@
+import { Lobby, LobbyOptions } from "./lobby";
+import { Table } from "./table";
+import { PresenceMessage } from "./types";
+/**
+ * The main messaging client library entry point.
+ * Encapsulates transport logic and provides access to lobby and table functionality.
+ */
+export declare class MessagingClient {
+    private nchan;
+    private activeLobbies;
+    private activeTables;
+    private lastLobbyConfig?;
+    private isStopping;
+    constructor(options: {
+        baseUrl: string;
+    });
+    /**
+     * Initializes the client and ensures connection readiness.
+     * In browser environments, attaches lifecycle event listeners.
+     */
+    start(): Promise<void>;
+    /**
+     * Stops all active connections and cleans up.
+     */
+    stop(options?: {
+        isTeardown?: boolean;
+    }): Promise<void>;
+    /**
+     * Enters the global lobby for presence broadcasting and tracking.
+     */
+    joinLobby(user: PresenceMessage, options?: LobbyOptions): Promise<Lobby>;
+    /**
+     * Joins a specific table for communication.
+     */
+    joinTable<T = any>(tableId: string, userId: string): Promise<Table<T>>;
+    private handlePageHide;
+    private handlePageShow;
+    private handleVisibilityChange;
+}

package/dist/messagingclient.js

@@ -0,0 +1,109 @@
+import { NchanClient } from "./nchanclient";
+import { Lobby } from "./lobby";
+import { Table } from "./table";
+/**
+ * The main messaging client library entry point.
+ * Encapsulates transport logic and provides access to lobby and table functionality.
+ */
+export class MessagingClient {
+    nchan;
+    activeLobbies = [];
+    activeTables = [];
+    lastLobbyConfig;
+    isStopping = false;
+    constructor(options) {
+        this.nchan = new NchanClient(options.baseUrl);
+    }
+    /**
+     * Initializes the client and ensures connection readiness.
+     * In browser environments, attaches lifecycle event listeners.
+     */
+    async start() {
+        if (typeof window !== "undefined") {
+            window.addEventListener("pagehide", this.handlePageHide);
+            window.addEventListener("pageshow", this.handlePageShow);
+            document.addEventListener("visibilitychange", this.handleVisibilityChange);
+        }
+    }
+    /**
+     * Stops all active connections and cleans up.
+     */
+    async stop(options = {}) {
+        if (this.isStopping)
+            return;
+        this.isStopping = true;
+        try {
+            if (typeof window !== "undefined") {
+                window.removeEventListener("pagehide", this.handlePageHide);
+                window.removeEventListener("pageshow", this.handlePageShow);
+                document.removeEventListener("visibilitychange", this.handleVisibilityChange);
+            }
+            const lobbies = [...this.activeLobbies];
+            this.activeLobbies = [];
+            await Promise.all(lobbies.map((lobby) => lobby.leave(options)));
+            const tables = [...this.activeTables];
+            this.activeTables = [];
+            // Use for loop to await each table leave
+            for (const table of tables) {
+                await table.leave(options);
+            }
+        }
+        finally {
+            this.isStopping = false;
+        }
+    }
+    /**
+     * Enters the global lobby for presence broadcasting and tracking.
+     */
+    async joinLobby(user, options) {
+        // Prevent duplicate joins if already in a lobby for this user
+        const existing = this.activeLobbies.find((l) => l.currentUser.userId === user.userId);
+        if (existing)
+            return existing;
+        this.lastLobbyConfig = { user, options };
+        const lobby = new Lobby(this.nchan, user, options);
+        await lobby.join();
+        this.activeLobbies.push(lobby);
+        return lobby;
+    }
+    /**
+     * Joins a specific table for communication.
+     */
+    async joinTable(tableId, userId) {
+        let table = this.activeTables.find((t) => t.tableId === tableId);
+        if (!table) {
+            const lobby = this.activeLobbies.find((l) => l.currentUser.userId === userId);
+            if (!lobby) {
+                throw new Error(`Cannot join table: No active lobby found for user ${userId}`);
+            }
+            table = new Table(this.nchan, tableId, userId, lobby);
+            await table.join();
+            this.activeTables.push(table);
+            await lobby.updatePresence({ tableId });
+        }
+        else {
+            await table.join();
+        }
+        return table;
+    }
+    handlePageHide = () => {
+        // Stop all connections on page hide (prevent ghosting)
+        // Non-blocking call because pagehide might terminate the process
+        this.stop({ isTeardown: true });
+    };
+    handlePageShow = (event) => {
+        // If returning via bfcache, restore connections
+        if (event.persisted && this.lastLobbyConfig) {
+            this.joinLobby(this.lastLobbyConfig.user, this.lastLobbyConfig.options);
+        }
+    };
+    handleVisibilityChange = () => {
+        if (document.hidden) {
+            this.activeLobbies.forEach((l) => l.pauseHeartbeat());
+        }
+        else {
+            this.activeLobbies.forEach((l) => l.resumeHeartbeat());
+        }
+    };
+}
+//# sourceMappingURL=messagingclient.js.map

package/dist/messagingclient.js.map

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

package/dist/nchanclient.d.ts

@@ -0,0 +1,24 @@
+import type { PresenceMessage, ChallengeMessage, TableMessage } from "./types";
+export type Subscription = {
+    stop: () => void;
+    ready: Promise<void>;
+};
+export declare class NchanClient {
+    private server;
+    constructor(server: string);
+    private getWsUrl;
+    private getHttpUrl;
+    private publish;
+    publishPresence(message: Omit<PresenceMessage, "messageType">, options?: {
+        keepalive?: boolean;
+    }): Promise<Response>;
+    publishChallenge(message: Omit<ChallengeMessage, "messageType">, options?: {
+        keepalive?: boolean;
+    }): Promise<Response>;
+    publishTable<T>(tableId: string, message: Omit<TableMessage<T>, "senderId">, senderId: string, options?: {
+        keepalive?: boolean;
+    }): Promise<Response>;
+    subscribePresence(onMessage: (data: string) => void): Subscription;
+    subscribeTable(tableId: string, onMessage: (data: string) => void): Subscription;
+    private subscribe;
+}

package/dist/nchanclient.js

@@ -0,0 +1,109 @@
+export class NchanClient {
+    server;
+    constructor(server) {
+        // Ensure server string doesn't end with a slash and starts with protocol if missing
+        this.server = server.replace(/\/$/, "");
+        if (!this.server.startsWith("http")) {
+            this.server = `http://${this.server}`;
+        }
+    }
+    getWsUrl(path) {
+        return this.server.replace(/^http/, "ws") + path;
+    }
+    getHttpUrl(path) {
+        return this.server + path;
+    }
+    async publish(path, message, options = {}) {
+        const url = this.getHttpUrl(path);
+        const response = await fetch(url, {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            body: JSON.stringify(message),
+            keepalive: options.keepalive,
+        });
+        if (!response.ok) {
+            throw new Error(`Publish failed: ${response.status}`);
+        }
+        return response;
+    }
+    // Publishing
+    async publishPresence(message, options) {
+        return this.publish("/publish/presence/lobby", {
+            ...message,
+            messageType: "presence",
+        }, options);
+    }
+    async publishChallenge(message, options) {
+        return this.publish("/publish/presence/lobby", {
+            ...message,
+            messageType: "challenge",
+        }, options);
+    }
+    async publishTable(tableId, message, senderId, options) {
+        return this.publish(`/publish/table/${tableId}`, {
+            ...message,
+            senderId,
+        }, options);
+    }
+    // Subscribing
+    subscribePresence(onMessage) {
+        return this.subscribe("/subscribe/presence/lobby", onMessage);
+    }
+    subscribeTable(tableId, onMessage) {
+        return this.subscribe(`/subscribe/table/${tableId}`, onMessage);
+    }
+    subscribe(path, onMessage) {
+        const url = this.getWsUrl(path);
+        let ws = null;
+        let stopped = false;
+        let reconnectAttempts = 0;
+        const maxReconnectDelay = 30000;
+        let reconnectTimer = null;
+        let resolveReady;
+        const ready = new Promise((r) => {
+            resolveReady = r;
+        });
+        const connect = () => {
+            if (stopped)
+                return;
+            if (ws && ws.readyState <= WebSocket.OPEN) {
+                resolveReady();
+                return;
+            }
+            ws = new globalThis.WebSocket(url);
+            ws.onmessage = (event) => {
+                onMessage(event.data);
+            };
+            ws.onopen = () => {
+                reconnectAttempts = 0;
+                resolveReady();
+            };
+            ws.onclose = () => {
+                if (!stopped) {
+                    const delay = Math.min(Math.pow(2, reconnectAttempts) * 1000, maxReconnectDelay);
+                    reconnectAttempts++;
+                    reconnectTimer = setTimeout(connect, delay);
+                }
+            };
+            ws.onerror = () => {
+                ws?.close();
+            };
+        };
+        connect();
+        return {
+            ready,
+            stop: () => {
+                stopped = true;
+                if (reconnectTimer) {
+                    clearTimeout(reconnectTimer);
+                    reconnectTimer = null;
+                }
+                if (ws) {
+                    ws.close();
+                    ws = null;
+                }
+            },
+        };
+    }
+}
+//# sourceMappingURL=nchanclient.js.map

package/dist/nchanclient.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nchanclient.js","sourceRoot":"","sources":["../src/nchanclient.ts"],"names":[],"mappings":"AAIA,MAAM,OAAO,WAAW;IACd,MAAM,CAAS;IAEvB,YAAY,MAAc;QACxB,oFAAoF;QACpF,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QACxC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;YACpC,IAAI,CAAC,MAAM,GAAG,UAAU,IAAI,CAAC,MAAM,EAAE,CAAC;QACxC,CAAC;IACH,CAAC;IAEO,QAAQ,CAAC,IAAY;QAC3B,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC,GAAG,IAAI,CAAC;IACnD,CAAC;IAEO,UAAU,CAAC,IAAY;QAC7B,OAAO,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;IAC5B,CAAC;IAEO,KAAK,CAAC,OAAO,CACnB,IAAY,EACZ,OAAgB,EAChB,UAAmC,EAAE;QAErC,MAAM,GAAG,GAAG,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;QAClC,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;YAChC,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;YAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC;YAC7B,SAAS,EAAE,OAAO,CAAC,SAAS;SAC7B,CAAC,CAAC;QACH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CAAC,mBAAmB,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;QACxD,CAAC;QACD,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,aAAa;IAEb,KAAK,CAAC,eAAe,CACnB,OAA6C,EAC7C,OAAiC;QAEjC,OAAO,IAAI,CAAC,OAAO,CACjB,yBAAyB,EACzB;YACE,GAAG,OAAO;YACV,WAAW,EAAE,UAAU;SACxB,EACD,OAAO,CACR,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,gBAAgB,CACpB,OAA8C,EAC9C,OAAiC;QAEjC,OAAO,IAAI,CAAC,OAAO,CACjB,yBAAyB,EACzB;YACE,GAAG,OAAO;YACV,WAAW,EAAE,WAAW;SACzB,EACD,OAAO,CACR,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,YAAY,CAChB,OAAe,EACf,OAA0C,EAC1C,QAAgB,EAChB,OAAiC;QAEjC,OAAO,IAAI,CAAC,OAAO,CACjB,kBAAkB,OAAO,EAAE,EAC3B;YACE,GAAG,OAAO;YACV,QAAQ;SACT,EACD,OAAO,CACR,CAAC;IACJ,CAAC;IAED,cAAc;IAEd,iBAAiB,CAAC,SAAiC;QACjD,OAAO,IAAI,CAAC,SAAS,CAAC,2BAA2B,EAAE,SAAS,CAAC,CAAC;IAChE,CAAC;IAED,cAAc,CAAC,OAAe,EAAE,SAAiC;QAC/D,OAAO,IAAI,CAAC,SAAS,CAAC,oBAAoB,OAAO,EAAE,EAAE,SAAS,CAAC,CAAC;IAClE,CAAC;IAEO,SAAS,CAAC,IAAY,EAAE,SAAiC;QAC/D,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QAChC,IAAI,EAAE,GAAqB,IAAI,CAAC;QAChC,IAAI,OAAO,GAAG,KAAK,CAAC;QACpB,IAAI,iBAAiB,GAAG,CAAC,CAAC;QAC1B,MAAM,iBAAiB,GAAG,KAAK,CAAC;QAChC,IAAI,cAAc,GAAQ,IAAI,CAAC;QAE/B,IAAI,YAAwB,CAAC;QAC7B,MAAM,KAAK,GAAG,IAAI,OAAO,CAAO,CAAC,CAAC,EAAE,EAAE;YACpC,YAAY,GAAG,CAAC,CAAC;QACnB,CAAC,CAAC,CAAC;QAEH,MAAM,OAAO,GAAG,GAAG,EAAE;YACnB,IAAI,OAAO;gBAAE,OAAO;YACpB,IAAI,EAAE,IAAI,EAAE,CAAC,UAAU,IAAI,SAAS,CAAC,IAAI,EAAE,CAAC;gBAC1C,YAAY,EAAE,CAAC;gBACf,OAAO;YACT,CAAC;YAED,EAAE,GAAG,IAAI,UAAU,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;YAEnC,EAAE,CAAC,SAAS,GAAG,CAAC,KAAK,EAAE,EAAE;gBACvB,SAAS,CAAC,KAAK,CAAC,IAAc,CAAC,CAAC;YAClC,CAAC,CAAC;YAEF,EAAE,CAAC,MAAM,GAAG,GAAG,EAAE;gBACf,iBAAiB,GAAG,CAAC,CAAC;gBACtB,YAAY,EAAE,CAAC;YACjB,CAAC,CAAC;YAEF,EAAE,CAAC,OAAO,GAAG,GAAG,EAAE;gBAChB,IAAI,CAAC,OAAO,EAAE,CAAC;oBACb,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,iBAAiB,CAAC,GAAG,IAAI,EAAE,iBAAiB,CAAC,CAAC;oBACjF,iBAAiB,EAAE,CAAC;oBACpB,cAAc,GAAG,UAAU,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;gBAC9C,CAAC;YACH,CAAC,CAAC;YAEF,EAAE,CAAC,OAAO,GAAG,GAAG,EAAE;gBAChB,EAAE,EAAE,KAAK,EAAE,CAAC;YACd,CAAC,CAAC;QACJ,CAAC,CAAC;QAEF,OAAO,EAAE,CAAC;QAEV,OAAO;YACL,KAAK;YACL,IAAI,EAAE,GAAG,EAAE;gBACT,OAAO,GAAG,IAAI,CAAC;gBACf,IAAI,cAAc,EAAE,CAAC;oBACnB,YAAY,CAAC,cAAc,CAAC,CAAC;oBAC7B,cAAc,GAAG,IAAI,CAAC;gBACxB,CAAC;gBACD,IAAI,EAAE,EAAE,CAAC;oBACP,EAAE,CAAC,KAAK,EAAE,CAAC;oBACX,EAAE,GAAG,IAAI,CAAC;gBACZ,CAAC;YACH,CAAC;SACF,CAAC;IACJ,CAAC;CACF"}

package/dist/table.d.ts

@@ -0,0 +1,51 @@
+import { NchanClient } from "./nchanclient";
+import { TableMessage, PresenceMessage } from "./types";
+import { Lobby } from "./lobby";
+/**
+ * Represents a specific communication channel for a 2-player/spectator scenario at a table.
+ */
+export declare class Table<T = any> {
+    private nchan;
+    readonly tableId: string;
+    private userId;
+    private lobby?;
+    private subscription;
+    private isJoined;
+    private messageListeners;
+    private spectatorListeners;
+    private opponentLeftListeners;
+    private lobbyUnsubscribe?;
+    opponentLeft: boolean;
+    private opponentSeen;
+    constructor(nchan: NchanClient, tableId: string, userId: string, lobby?: Lobby | undefined);
+    /**
+     * Initializes the table by subscribing to its specific channel.
+     */
+    join(): Promise<void>;
+    /**
+     * Broadcast an event to all participants at the table.
+     */
+    publish(type: string, data: T): Promise<void>;
+    /**
+     * Subscribe to events published by other participants.
+     */
+    onMessage(callback: (event: TableMessage<T>) => void): void;
+    /**
+     * Subscribe to opponent departure (explicit leave or timeout).
+     */
+    onOpponentLeft(callback: () => void): void;
+    /**
+     * Subscribe to changes in the spectator list.
+     * Note: In a real implementation, this would track presence messages on the table channel.
+     */
+    onSpectatorChange(callback: (spectators: PresenceMessage[]) => void): void;
+    /**
+     * Leave the table and stop all subscriptions.
+     */
+    leave(options?: {
+        isTeardown?: boolean;
+    }): Promise<void>;
+    private handleIncomingMessage;
+    private handleLobbyUsersChange;
+    private notifyOpponentLeft;
+}

package/dist/table.js

@@ -0,0 +1,126 @@
+import { parseMessage } from "./types";
+/**
+ * Represents a specific communication channel for a 2-player/spectator scenario at a table.
+ */
+export class Table {
+    nchan;
+    tableId;
+    userId;
+    lobby;
+    subscription = null;
+    isJoined = false;
+    messageListeners = [];
+    spectatorListeners = [];
+    opponentLeftListeners = [];
+    lobbyUnsubscribe;
+    opponentLeft = false;
+    opponentSeen = false;
+    constructor(nchan, tableId, userId, lobby) {
+        this.nchan = nchan;
+        this.tableId = tableId;
+        this.userId = userId;
+        this.lobby = lobby;
+        if (this.lobby) {
+            const handler = (users) => this.handleLobbyUsersChange(users);
+            this.lobby.onUsersChange(handler);
+            this.lobbyUnsubscribe = () => {
+                this.lobby?.offUsersChange(handler);
+            };
+        }
+    }
+    /**
+     * Initializes the table by subscribing to its specific channel.
+     */
+    async join() {
+        if (this.isJoined)
+            return;
+        this.subscription = this.nchan.subscribeTable(this.tableId, (data) => {
+            this.handleIncomingMessage(data);
+        });
+        await this.subscription.ready;
+        this.isJoined = true;
+    }
+    /**
+     * Broadcast an event to all participants at the table.
+     */
+    async publish(type, data) {
+        await this.nchan.publishTable(this.tableId, { type, data }, this.userId);
+    }
+    /**
+     * Subscribe to events published by other participants.
+     */
+    onMessage(callback) {
+        this.messageListeners.push(callback);
+    }
+    /**
+     * Subscribe to opponent departure (explicit leave or timeout).
+     */
+    onOpponentLeft(callback) {
+        this.opponentLeftListeners.push(callback);
+        if (this.opponentLeft) {
+            callback();
+        }
+    }
+    /**
+     * Subscribe to changes in the spectator list.
+     * Note: In a real implementation, this would track presence messages on the table channel.
+     */
+    onSpectatorChange(callback) {
+        this.spectatorListeners.push(callback);
+    }
+    /**
+     * Leave the table and stop all subscriptions.
+     */
+    async leave(options = {}) {
+        try {
+            // Explicitly notify the opponent we are leaving
+            await this.nchan.publishTable(this.tableId, { type: "SYSTEM_DISCONNECT", data: {} }, this.userId, { keepalive: options.isTeardown });
+            if (!options.isTeardown) {
+                // Small delay to ensure the message is dispatched before closing the socket
+                await new Promise((r) => setTimeout(r, 100));
+            }
+        }
+        catch (e) {
+            console.error("Error leaving table:", e);
+        }
+        // Clear lobby presence if we have one
+        if (this.lobby) {
+            await this.lobby.updatePresence({ tableId: undefined });
+        }
+        this.subscription?.stop();
+        this.messageListeners = [];
+        this.spectatorListeners = [];
+        this.opponentLeftListeners = [];
+        this.lobbyUnsubscribe?.();
+        this.isJoined = false;
+    }
+    handleIncomingMessage(data) {
+        const msg = parseMessage(data);
+        if (!msg || !msg.type)
+            return;
+        // Handle system messages internally
+        if (msg.type === "SYSTEM_DISCONNECT" && msg.senderId !== this.userId) {
+            this.notifyOpponentLeft();
+        }
+        // Notify message listeners
+        this.messageListeners.forEach((cb) => cb(msg));
+    }
+    handleLobbyUsersChange(users) {
+        const playersAtThisTable = users.filter((u) => u.tableId === this.tableId);
+        const opponent = playersAtThisTable.find((u) => u.userId !== this.userId);
+        if (opponent) {
+            this.opponentSeen = true;
+        }
+        // Watchdog trigger: Opponent was here, but now is gone.
+        if (this.opponentSeen && !opponent) {
+            this.notifyOpponentLeft();
+        }
+    }
+    notifyOpponentLeft() {
+        if (this.opponentLeft)
+            return; // Only notify once
+        this.opponentLeft = true;
+        this.opponentLeftListeners.forEach((cb) => cb());
+    }
+}
+//# sourceMappingURL=table.js.map

package/dist/table.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,85 @@
+/**
+ * Server-enriched metadata added to all messages by Nchan.
+ * This is the absolute source of truth for timing and origin.
+ */
+export interface _Meta {
+    ts: string;
+    locale: string;
+    ua: string;
+    ip: string;
+    origin: string;
+    host: string;
+    path: string;
+    method: string;
+}
+/**
+ * Seek object for table seeking in the lobby
+ */
+export interface Seek {
+    tableId: string;
+    ruleType?: string;
+}
+/**
+ * Presence-related messages (user join/leave/heartbeat)
+ */
+export interface PresenceMessage {
+    messageType: "presence";
+    type: "join" | "heartbeat" | "leave";
+    userId: string;
+    userName: string;
+    ruleType?: string;
+    opponentId?: string | null;
+    seek?: Seek;
+    lastSeen?: number;
+    _meta?: _Meta;
+    tableId?: string;
+}
+/**
+ * Peer-to-peer challenge request
+ */
+export interface ChallengeMessage {
+    messageType: "challenge";
+    type: "offer" | "accept" | "decline" | "cancel";
+    challengerId: string;
+    challengerName: string;
+    recipientId: string;
+    ruleType: string;
+    tableId?: string;
+    _meta?: _Meta;
+}
+/**
+ * Generic structure for table/game events
+ */
+export interface TableMessage<T = any> {
+    type: string;
+    senderId: string;
+    data: T;
+    _meta?: _Meta;
+}
+/**
+ * Lobby-level information about an active game table
+ */
+export interface TableInfo {
+    tableId: string;
+    ruleType: string;
+    players: {
+        id: string;
+        name: string;
+    }[];
+    spectatorCount: number;
+    status: "waiting" | "playing" | "finished";
+    createdAt: number;
+}
+/**
+ * Union type for messages received via the lobby channel
+ */
+export type LobbyIncomingMessage = PresenceMessage | ChallengeMessage;
+/**
+ * Type guards
+ */
+export declare function isPresenceMessage(msg: any): msg is PresenceMessage;
+export declare function isChallengeMessage(msg: any): msg is ChallengeMessage;
+/**
+ * Helper to parse incoming Nchan JSON strings
+ */
+export declare function parseMessage<T>(data: string): T | null;

package/dist/types.js

@@ -0,0 +1,24 @@
+/**
+ * Type guards
+ */
+export function isPresenceMessage(msg) {
+    return msg?.messageType === "presence";
+}
+export function isChallengeMessage(msg) {
+    return msg?.messageType === "challenge";
+}
+/**
+ * Helper to parse incoming Nchan JSON strings
+ */
+export function parseMessage(data) {
+    if (!data || data.trim() === "")
+        return null;
+    try {
+        return JSON.parse(data);
+    }
+    catch (e) {
+        console.error("Failed to parse Nchan message:", e);
+        return null;
+    }
+}
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAiFA;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,GAAQ;IACxC,OAAO,GAAG,EAAE,WAAW,KAAK,UAAU,CAAC;AACzC,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,GAAQ;IACzC,OAAO,GAAG,EAAE,WAAW,KAAK,WAAW,CAAC;AAC1C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAAI,IAAY;IAC1C,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE;QAAE,OAAO,IAAI,CAAC;IAC7C,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAM,CAAC;IAC/B,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,OAAO,CAAC,KAAK,CAAC,gCAAgC,EAAE,CAAC,CAAC,CAAC;QACnD,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/utils/uid.d.ts

@@ -0,0 +1 @@
+export declare function getUID(): string;

package/dist/utils/uid.js

@@ -0,0 +1,4 @@
+export function getUID() {
+    return "xxxxxxxx".replace(/x/g, () => Math.floor(Math.random() * 16).toString(16));
+}
+//# sourceMappingURL=uid.js.map

package/dist/utils/uid.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"uid.js","sourceRoot":"","sources":["../../src/utils/uid.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,MAAM;IACpB,OAAO,UAAU,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC;AACrF,CAAC"}

package/package.json

@@ -0,0 +1,61 @@
+{
+  "name": "@tailuge/messaging",
+  "version": "1.0.0",
+  "type": "module",
+  "description": "A stateful messaging library for Nchan-powered real-time applications.",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "test": "jest --config test/jest.config.cjs",
+    "coverage": "jest --config test/jest.config.cjs --coverage",
+    "playwright": "npx playwright test playwright/debug-connection.spec.ts",
+    "test:debug": "npm run playwright",
+    "lint": "tsc --noEmit && npx oxlint src test",
+    "prettify": "npx oxfmt src test",
+    "build": "tsc --declaration",
+    "release": "npm version minor --no-git-tag-version && npm run build",
+    "build:all": "bash scripts/docker-nchan.sh build",
+    "build:example": "npx esbuild example/src/client.ts --bundle --outfile=example/dist/client.js",
+    "example": "npm run build:example && npx http-server example -p 3000",
+    "docker:start": "bash scripts/docker-nchan.sh",
+    "docker:stop": "bash scripts/docker-nchan.sh stop",
+    "docker:build": "npm run build:all",
+    "deps": "npx npm-check"
+  },
+  "keywords": [
+    "messaging",
+    "nchan",
+    "real-time",
+    "presence",
+    "lobby"
+  ],
+  "author": "tailuge",
+  "license": "GPL-3.0",
+  "devDependencies": {
+    "@playwright/test": "1.58.2",
+    "@types/jest": "30.0.0",
+    "@types/ws": "^8.18.1",
+    "esbuild": "^0.27.3",
+    "http-server": "^14.1.1",
+    "jest": "30.3.0",
+    "oxlint": "^1.52.0",
+    "testcontainers": "^11.12.0",
+    "ts-jest": "^29.4.6",
+    "typescript": "5.9.3",
+    "ws": "^8.19.0"
+  },
+  "browserslist": [
+    "defaults",
+    "ios >= 12",
+    "safari >= 12"
+  ]
+}