cheatchat 1.0.0 → 1.1.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cheatchat",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "description": "",
   "bin": {
     "chat": "./bin/chat.js"

package/src/commands/connect.js

@@ -4,6 +4,7 @@ import { connectWebSocket } from "../websocket/connect.js";
 import { disconnectWebSocket } from "../websocket/disconnect.js";
 import { handleIncomingMessage } from "../websocket/receiver.js";
 import { sendMessage } from "../websocket/sender.js";
+import { requestHistory, requestOnline, requestUsers } from "../services/socket.js";
 import { showChatHeader } from "../ui/banner.js";
 import {
   printChatHelp,
@@ -109,8 +110,13 @@ export async function connectCommand() {
   showChatHeader(username, chatMode, dmTarget);
   printBlank();
   printSystem("You are in Global Chat. Type a message or /help for commands.");
+  printSystem("Loading chat history...");
   printBlank();
 
+  // ─── Auto-load global history on connect ─────────────────────────────
+
+  requestHistory(ws, "global");
+
   // ─── Start Interactive Readline ──────────────────────────────────────
 
   rl = readline.createInterface({
@@ -141,6 +147,8 @@ export async function connectCommand() {
           chatMode = CHAT_MODE.GLOBAL;
           dmTarget = null;
           printModeSwitch("global");
+          // Auto-load global history on mode switch
+          requestHistory(ws, "global");
           refreshPrompt();
           return;
 
@@ -159,10 +167,31 @@ export async function connectCommand() {
           chatMode = CHAT_MODE.PRIVATE;
           dmTarget = target;
           printModeSwitch("private", target);
+          // Auto-load private history when switching to DM
+          requestHistory(ws, "private", target);
           refreshPrompt();
           return;
         }
 
+        case "/history":
+          if (chatMode === CHAT_MODE.GLOBAL) {
+            requestHistory(ws, "global");
+          } else if (chatMode === CHAT_MODE.PRIVATE && dmTarget) {
+            requestHistory(ws, "private", dmTarget);
+          }
+          rl.prompt();
+          return;
+
+        case "/online":
+          requestOnline(ws);
+          rl.prompt();
+          return;
+
+        case "/users":
+          requestUsers(ws);
+          rl.prompt();
+          return;
+
         case "/help":
           printChatHelp();
           rl.prompt();

package/src/commands/help.js

@@ -27,6 +27,9 @@ export function helpCommand() {
   const chatCommands = [
     ["/global", "Switch to global chat"],
     ["/dm <username>", "Switch to private messaging"],
+    ["/history", "Load message history"],
+    ["/online", "Show online users"],
+    ["/users", "Show all registered users"],
     ["/help", "Show chat commands"],
     ["/exit", "Disconnect and exit"],
   ];

package/src/services/socket.js

@@ -69,6 +69,37 @@ export function sendPrivateMessage(ws, to, text) {
   return true;
 }
 
+/**
+ * Request chat history (global or private).
+ */
+export function requestHistory(ws, type, withUser, limit = 50) {
+  if (ws.readyState !== WebSocket.OPEN) return false;
+  const payload = { action: "history", type, limit };
+  if (type === "private" && withUser) {
+    payload.with = withUser;
+  }
+  ws.send(JSON.stringify(payload));
+  return true;
+}
+
+/**
+ * Request the list of currently online users.
+ */
+export function requestOnline(ws) {
+  if (ws.readyState !== WebSocket.OPEN) return false;
+  ws.send(JSON.stringify({ action: "online" }));
+  return true;
+}
+
+/**
+ * Request the list of all registered users.
+ */
+export function requestUsers(ws) {
+  if (ws.readyState !== WebSocket.OPEN) return false;
+  ws.send(JSON.stringify({ action: "users" }));
+  return true;
+}
+
 /**
  * Close the WebSocket connection gracefully.
  */

package/src/ui/printer.js

@@ -13,6 +13,7 @@ import {
   warning,
   accent,
   brand,
+  white,
   whiteBold,
   dim,
 } from "./color.js";
@@ -93,6 +94,9 @@ export function printChatHelp() {
   console.log(`  ${whiteBold("Chat Commands:")}`);
   console.log(`  ${brand("/global")}          ${muted("Switch to global chat")}`);
   console.log(`  ${brand("/dm <username>")}   ${muted("Switch to private messaging")}`);
+  console.log(`  ${brand("/history")}         ${muted("Load message history for current chat")}`);
+  console.log(`  ${brand("/online")}          ${muted("Show currently connected users")}`);
+  console.log(`  ${brand("/users")}           ${muted("Show all registered users")}`);
   console.log(`  ${brand("/help")}            ${muted("Show this help menu")}`);
   console.log(`  ${brand("/exit")}            ${muted("Disconnect and exit")}`);
   console.log();
@@ -111,6 +115,66 @@ export function printModeSwitch(mode, target) {
   console.log();
 }
 
+/**
+ * Print a history header.
+ */
+export function printHistoryHeader(type, target) {
+  console.log();
+  const sep = muted("─".repeat(50));
+  console.log(`  ${sep}`);
+  if (type === "global") {
+    console.log(`  ${systemTag(" HISTORY ")} ${accent("🌍 Global Chat History")}`);
+  } else {
+    console.log(`  ${systemTag(" HISTORY ")} ${accent(`🔒 DM History with ${whiteBold(target)}`)}`);
+  }
+  console.log(`  ${sep}`);
+}
+
+/**
+ * Print a history footer.
+ */
+export function printHistoryFooter(count) {
+  const sep = muted("─".repeat(50));
+  console.log(`  ${sep}`);
+  console.log(`  ${muted(`${count} message${count !== 1 ? "s" : ""} loaded`)}`);
+  console.log(`  ${sep}`);
+  console.log();
+}
+
+/**
+ * Print online users list.
+ */
+export function printOnlineUsers(users) {
+  console.log();
+  console.log(`  ${whiteBold("Online Users")} ${muted(`(${users.length})`)}`);
+  console.log(`  ${muted("─".repeat(30))}`);
+  if (users.length === 0) {
+    console.log(`  ${muted("No users online")}`);
+  } else {
+    for (const u of users) {
+      console.log(`  ${success("●")} ${accent(u)}`);
+    }
+  }
+  console.log();
+}
+
+/**
+ * Print all registered users list.
+ */
+export function printRegisteredUsers(users) {
+  console.log();
+  console.log(`  ${whiteBold("Registered Users")} ${muted(`(${users.length})`)}`);
+  console.log(`  ${muted("─".repeat(30))}`);
+  if (users.length === 0) {
+    console.log(`  ${muted("No users found")}`);
+  } else {
+    for (const u of users) {
+      console.log(`  ${brand("•")} ${white(u)}`);
+    }
+  }
+  console.log();
+}
+
 /**
  * Print a blank line.
  */

package/src/websocket/receiver.js

@@ -1,4 +1,13 @@
-import { printGlobalMessage, printPrivateMessage, printError, printSystem } from "../ui/printer.js";
+import {
+  printGlobalMessage,
+  printPrivateMessage,
+  printError,
+  printSystem,
+  printHistoryHeader,
+  printHistoryFooter,
+  printOnlineUsers,
+  printRegisteredUsers,
+} from "../ui/printer.js";
 
 /**
  * Handle incoming WebSocket messages and dispatch to the appropriate printer.
@@ -15,6 +24,18 @@ export function handleIncomingMessage(data, currentUser) {
       printPrivateMessage(data.sender, data.text, data.timestamp, currentUser);
       break;
 
+    case "history":
+      renderHistory(data, currentUser);
+      break;
+
+    case "online":
+      printOnlineUsers(data.users || []);
+      break;
+
+    case "users":
+      printRegisteredUsers(data.users || []);
+      break;
+
     case "error":
       printError(data.message || "Unknown server error");
       break;
@@ -24,3 +45,28 @@ export function handleIncomingMessage(data, currentUser) {
       break;
   }
 }
+
+/**
+ * Render a history response (global or private).
+ */
+function renderHistory(data, currentUser) {
+  const messages = data.messages || [];
+  const type = data.type;
+  const target = data.with;
+
+  printHistoryHeader(type, target);
+
+  if (messages.length === 0) {
+    printSystem("No messages yet. Start the conversation!");
+  } else {
+    for (const msg of messages) {
+      if (type === "global") {
+        printGlobalMessage(msg.sender, msg.text, msg.timestamp, currentUser);
+      } else {
+        printPrivateMessage(msg.sender, msg.text, msg.timestamp, currentUser);
+      }
+    }
+  }
+
+  printHistoryFooter(messages.length);
+}