@kispi/chat 0.1.0 → 0.1.1

package/dist/index.cjs

@@ -782,6 +782,8 @@ var ChatClient = class extends Emitter {
   nextFrameId = 0;
   opening;
   rest;
+  /** Registered DOM event listener cleanups (visibilitychange, online). */
+  teardowns = [];
   /**
    * Room handles this client has handed out, keyed by how they were
    * asked for. Nothing is ever removed: a handle a consumer holds has to
@@ -818,6 +820,57 @@ var ChatClient = class extends Emitter {
       token: async () => this.lastToken,
       fetch: options.fetch ?? globalThis.fetch.bind(globalThis)
     });
+    this.setupLifecycle();
+  }
+  setupLifecycle() {
+    if (typeof document !== "undefined" && typeof document.addEventListener === "function") {
+      const onVisibilityChange = () => {
+        if (document.visibilityState === "visible") {
+          void this.resume();
+        }
+      };
+      document.addEventListener("visibilitychange", onVisibilityChange);
+      this.teardowns.push(() => document.removeEventListener("visibilitychange", onVisibilityChange));
+    }
+    if (typeof window !== "undefined" && typeof window.addEventListener === "function") {
+      const onOnline = () => {
+        void this.resume();
+      };
+      window.addEventListener("online", onOnline);
+      this.teardowns.push(() => window.removeEventListener("online", onOnline));
+    }
+  }
+  /**
+   * Resumes the connection and syncs all active room subscriptions.
+   *
+   * Called automatically in browsers on `visibilitychange` (tab returning
+   * from background) and `online` (network reconnected), or manually by
+   * consumers when waking from sleep.
+   *
+   * - If closed by caller: does nothing.
+   * - If disconnected or reconnecting: cancels any backoff delay and
+   *   reconnects immediately.
+   * - If already open: sends a ping frame to detect dead sockets, and
+   *   triggers `resume()` on every room handle so missed messages are
+   *   gap-filled via REST.
+   */
+  async resume() {
+    if (this.closedByCaller) return;
+    if (this.state !== "open" || this.socket === void 0) {
+      this.clearTimers();
+      return this.connect();
+    }
+    try {
+      this.socket.send(JSON.stringify({ type: "ping", id: `p${++this.nextFrameId}` }));
+    } catch {
+      this.clearTimers();
+      return this.connect();
+    }
+    for (const room of this.handles.values()) {
+      void room.resume().catch((err) => {
+        room.emit("error", err instanceof Error ? err : new Error(String(err)));
+      });
+    }
   }
   /** The account-level routes: the rooms this user is in, and unread. */
   get rooms() {
@@ -926,6 +979,13 @@ var ChatClient = class extends Emitter {
    */
   async close() {
     this.closedByCaller = true;
+    this.teardowns.forEach((t) => {
+      try {
+        t();
+      } catch {
+      }
+    });
+    this.teardowns.length = 0;
     this.clearTimers();
     const socket = this.socket;
     this.socket = void 0;

package/dist/index.d.cts

@@ -119,6 +119,16 @@ type Message = {
         lastSeq?: number;
     };
 };
+type ReactionUser = {
+    userId?: string;
+    name?: string;
+    emoji: string;
+    withdrawn?: boolean;
+};
+type ReactionsPage = {
+    reactions: ReactionUser[];
+    cursor: string;
+};
 type SendInput = {
     text?: string;
     attachments?: unknown[];
@@ -336,7 +346,7 @@ declare class Room extends Emitter<RoomEvents> {
         emoji?: string;
         cursor?: string;
         limit?: number;
-    }): Promise<unknown>;
+    }): Promise<ReactionsPage>;
     /**
      * Re-subscribes after a reconnect. Called by the client.
      *
@@ -459,6 +469,8 @@ declare class ChatClient extends Emitter<ChatClientEvents> {
     private nextFrameId;
     private opening;
     private readonly rest;
+    /** Registered DOM event listener cleanups (visibilitychange, online). */
+    private readonly teardowns;
     /**
      * Room handles this client has handed out, keyed by how they were
      * asked for. Nothing is ever removed: a handle a consumer holds has to
@@ -480,6 +492,22 @@ declare class ChatClient extends Emitter<ChatClientEvents> {
     /** True once a socket has reached `hello`, so the next one is a return. */
     private everOpened;
     constructor(options: ChatClientOptions);
+    private setupLifecycle;
+    /**
+     * Resumes the connection and syncs all active room subscriptions.
+     *
+     * Called automatically in browsers on `visibilitychange` (tab returning
+     * from background) and `online` (network reconnected), or manually by
+     * consumers when waking from sleep.
+     *
+     * - If closed by caller: does nothing.
+     * - If disconnected or reconnecting: cancels any backoff delay and
+     *   reconnects immediately.
+     * - If already open: sends a ping frame to detect dead sockets, and
+     *   triggers `resume()` on every room handle so missed messages are
+     *   gap-filled via REST.
+     */
+    resume(): Promise<void>;
     /** The account-level routes: the rooms this user is in, and unread. */
     get rooms(): {
         list: (options?: {
@@ -803,4 +831,4 @@ declare class Timeline {
 }
 declare function createTimeline(options: TimelineOptions): Timeline;
 
-export { type AuthUser, ChatClient, type ChatClientEvents, type ChatClientOptions, ChatError, type ConnectionState, type FetchRange, type Frame, type Hello, type Message, type PublishAck, Room, type RoomEvents, type SendInput, type SendOptions, Timeline, type TimelineOptions, type WebSocketFactory, type WebSocketLike, createChatClient, createTimeline };
+export { type AuthUser, ChatClient, type ChatClientEvents, type ChatClientOptions, ChatError, type ConnectionState, type FetchRange, type Frame, type Hello, type Message, type PublishAck, type ReactionUser, type ReactionsPage, Room, type RoomEvents, type SendInput, type SendOptions, Timeline, type TimelineOptions, type WebSocketFactory, type WebSocketLike, createChatClient, createTimeline };

package/dist/index.d.ts

@@ -119,6 +119,16 @@ type Message = {
         lastSeq?: number;
     };
 };
+type ReactionUser = {
+    userId?: string;
+    name?: string;
+    emoji: string;
+    withdrawn?: boolean;
+};
+type ReactionsPage = {
+    reactions: ReactionUser[];
+    cursor: string;
+};
 type SendInput = {
     text?: string;
     attachments?: unknown[];
@@ -336,7 +346,7 @@ declare class Room extends Emitter<RoomEvents> {
         emoji?: string;
         cursor?: string;
         limit?: number;
-    }): Promise<unknown>;
+    }): Promise<ReactionsPage>;
     /**
      * Re-subscribes after a reconnect. Called by the client.
      *
@@ -459,6 +469,8 @@ declare class ChatClient extends Emitter<ChatClientEvents> {
     private nextFrameId;
     private opening;
     private readonly rest;
+    /** Registered DOM event listener cleanups (visibilitychange, online). */
+    private readonly teardowns;
     /**
      * Room handles this client has handed out, keyed by how they were
      * asked for. Nothing is ever removed: a handle a consumer holds has to
@@ -480,6 +492,22 @@ declare class ChatClient extends Emitter<ChatClientEvents> {
     /** True once a socket has reached `hello`, so the next one is a return. */
     private everOpened;
     constructor(options: ChatClientOptions);
+    private setupLifecycle;
+    /**
+     * Resumes the connection and syncs all active room subscriptions.
+     *
+     * Called automatically in browsers on `visibilitychange` (tab returning
+     * from background) and `online` (network reconnected), or manually by
+     * consumers when waking from sleep.
+     *
+     * - If closed by caller: does nothing.
+     * - If disconnected or reconnecting: cancels any backoff delay and
+     *   reconnects immediately.
+     * - If already open: sends a ping frame to detect dead sockets, and
+     *   triggers `resume()` on every room handle so missed messages are
+     *   gap-filled via REST.
+     */
+    resume(): Promise<void>;
     /** The account-level routes: the rooms this user is in, and unread. */
     get rooms(): {
         list: (options?: {
@@ -803,4 +831,4 @@ declare class Timeline {
 }
 declare function createTimeline(options: TimelineOptions): Timeline;
 
-export { type AuthUser, ChatClient, type ChatClientEvents, type ChatClientOptions, ChatError, type ConnectionState, type FetchRange, type Frame, type Hello, type Message, type PublishAck, Room, type RoomEvents, type SendInput, type SendOptions, Timeline, type TimelineOptions, type WebSocketFactory, type WebSocketLike, createChatClient, createTimeline };
+export { type AuthUser, ChatClient, type ChatClientEvents, type ChatClientOptions, ChatError, type ConnectionState, type FetchRange, type Frame, type Hello, type Message, type PublishAck, type ReactionUser, type ReactionsPage, Room, type RoomEvents, type SendInput, type SendOptions, Timeline, type TimelineOptions, type WebSocketFactory, type WebSocketLike, createChatClient, createTimeline };

package/dist/index.js

@@ -727,6 +727,8 @@ var ChatClient = class extends Emitter {
   nextFrameId = 0;
   opening;
   rest;
+  /** Registered DOM event listener cleanups (visibilitychange, online). */
+  teardowns = [];
   /**
    * Room handles this client has handed out, keyed by how they were
    * asked for. Nothing is ever removed: a handle a consumer holds has to
@@ -763,6 +765,57 @@ var ChatClient = class extends Emitter {
       token: async () => this.lastToken,
       fetch: options.fetch ?? globalThis.fetch.bind(globalThis)
     });
+    this.setupLifecycle();
+  }
+  setupLifecycle() {
+    if (typeof document !== "undefined" && typeof document.addEventListener === "function") {
+      const onVisibilityChange = () => {
+        if (document.visibilityState === "visible") {
+          void this.resume();
+        }
+      };
+      document.addEventListener("visibilitychange", onVisibilityChange);
+      this.teardowns.push(() => document.removeEventListener("visibilitychange", onVisibilityChange));
+    }
+    if (typeof window !== "undefined" && typeof window.addEventListener === "function") {
+      const onOnline = () => {
+        void this.resume();
+      };
+      window.addEventListener("online", onOnline);
+      this.teardowns.push(() => window.removeEventListener("online", onOnline));
+    }
+  }
+  /**
+   * Resumes the connection and syncs all active room subscriptions.
+   *
+   * Called automatically in browsers on `visibilitychange` (tab returning
+   * from background) and `online` (network reconnected), or manually by
+   * consumers when waking from sleep.
+   *
+   * - If closed by caller: does nothing.
+   * - If disconnected or reconnecting: cancels any backoff delay and
+   *   reconnects immediately.
+   * - If already open: sends a ping frame to detect dead sockets, and
+   *   triggers `resume()` on every room handle so missed messages are
+   *   gap-filled via REST.
+   */
+  async resume() {
+    if (this.closedByCaller) return;
+    if (this.state !== "open" || this.socket === void 0) {
+      this.clearTimers();
+      return this.connect();
+    }
+    try {
+      this.socket.send(JSON.stringify({ type: "ping", id: `p${++this.nextFrameId}` }));
+    } catch {
+      this.clearTimers();
+      return this.connect();
+    }
+    for (const room of this.handles.values()) {
+      void room.resume().catch((err) => {
+        room.emit("error", err instanceof Error ? err : new Error(String(err)));
+      });
+    }
   }
   /** The account-level routes: the rooms this user is in, and unread. */
   get rooms() {
@@ -871,6 +924,13 @@ var ChatClient = class extends Emitter {
    */
   async close() {
     this.closedByCaller = true;
+    this.teardowns.forEach((t) => {
+      try {
+        t();
+      } catch {
+      }
+    });
+    this.teardowns.length = 0;
     this.clearTimers();
     const socket = this.socket;
     this.socket = void 0;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kispi/chat",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Client SDK for the chat server: one WebSocket, many rooms, ordered history.",
   "license": "MIT",
   "type": "module",