cheatchat 1.0.0

package/bin/chat.js

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+
+import "../src/index.js";

package/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "cheatchat",
+  "version": "1.0.0",
+  "description": "",
+  "bin": {
+    "chat": "./bin/chat.js"
+  },
+  "type": "module",
+  "main": "index.js",
+  "scripts": {
+    "test": "echo \"Error: no test specified\" && exit 1"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ramoliyaYug/cheatChat.git"
+  },
+  "author": "yug",
+  "license": "ISC",
+  "bugs": {
+    "url": "https://github.com/ramoliyaYug/cheatChat/issues"
+  },
+  "homepage": "https://github.com/ramoliyaYug/cheatChat#readme",
+  "dependencies": {
+    "axios": "^1.18.1",
+    "boxen": "^8.0.1",
+    "chalk": "^5.6.2",
+    "cli-table3": "^0.6.5",
+    "commander": "^15.0.0",
+    "dotenv": "^17.4.2",
+    "inquirer": "^14.0.2",
+    "ora": "^9.4.1",
+    "ws": "^8.21.0"
+  }
+}

package/src/auth/login.js

@@ -0,0 +1,48 @@
+import inquirer from "inquirer";
+import { login as apiLogin } from "../services/api.js";
+import { saveAuth } from "../config/config.js";
+import { createSpinner } from "../ui/spinner.js";
+import { printSuccess, printError, printBlank } from "../ui/printer.js";
+import { brand, muted, whiteBold } from "../ui/color.js";
+
+/**
+ * Interactive login flow.
+ */
+export async function loginFlow() {
+  printBlank();
+  console.log(`  ${whiteBold("Login to CheatChat")}`);
+  printBlank();
+
+  const answers = await inquirer.prompt([
+    {
+      type: "input",
+      name: "username",
+      message: brand("Username:"),
+      validate: (input) => input.trim().length > 0 || "Username is required",
+    },
+    {
+      type: "password",
+      name: "password",
+      message: brand("Password:"),
+      mask: "•",
+      validate: (input) => input.length > 0 || "Password is required",
+    },
+  ]);
+
+  const spinner = createSpinner("Authenticating...");
+  spinner.start();
+
+  const result = await apiLogin(answers.username, answers.password);
+
+  if (result.success) {
+    saveAuth(result.username, result.token);
+    spinner.succeed(`Welcome back, ${brand(result.username)}!`);
+    printBlank();
+    console.log(`  ${muted("Run")} ${brand("chat connect")} ${muted("to start chatting")}`);
+  } else {
+    spinner.fail("Login failed");
+    printError(result.error || "Invalid username or password");
+  }
+
+  printBlank();
+}

package/src/auth/logout.js

@@ -0,0 +1,19 @@
+import { clearAuth, loadAuth } from "../config/config.js";
+import { printSuccess, printWarning, printBlank } from "../ui/printer.js";
+
+/**
+ * Logout — clear stored credentials.
+ */
+export function logoutFlow() {
+  printBlank();
+
+  const auth = loadAuth();
+  if (!auth) {
+    printWarning("You are not logged in.");
+  } else {
+    clearAuth();
+    printSuccess(`Logged out. Goodbye, ${auth.username}!`);
+  }
+
+  printBlank();
+}

package/src/auth/signup.js

@@ -0,0 +1,65 @@
+import inquirer from "inquirer";
+import { signup as apiSignup } from "../services/api.js";
+import { saveAuth } from "../config/config.js";
+import { createSpinner } from "../ui/spinner.js";
+import { printSuccess, printError, printBlank } from "../ui/printer.js";
+import { validateUsername, validatePassword } from "../utils/validator.js";
+import { brand, muted, whiteBold } from "../ui/color.js";
+
+/**
+ * Interactive signup flow.
+ */
+export async function signupFlow() {
+  printBlank();
+  console.log(`  ${whiteBold("Create your CheatChat account")}`);
+  printBlank();
+
+  const answers = await inquirer.prompt([
+    {
+      type: "input",
+      name: "username",
+      message: brand("Username:"),
+      validate: (input) => {
+        const { valid, message } = validateUsername(input);
+        return valid || message;
+      },
+    },
+    {
+      type: "password",
+      name: "password",
+      message: brand("Password:"),
+      mask: "•",
+      validate: (input) => {
+        const { valid, message } = validatePassword(input);
+        return valid || message;
+      },
+    },
+    {
+      type: "password",
+      name: "confirmPassword",
+      message: brand("Confirm Password:"),
+      mask: "•",
+      validate: (input, answers) => {
+        if (input !== answers.password) return "Passwords do not match";
+        return true;
+      },
+    },
+  ]);
+
+  const spinner = createSpinner("Creating your account...");
+  spinner.start();
+
+  const result = await apiSignup(answers.username, answers.password);
+
+  if (result.success) {
+    saveAuth(result.username, result.token);
+    spinner.succeed(`Account created! Welcome, ${brand(result.username)}`);
+    printBlank();
+    console.log(`  ${muted("Run")} ${brand("chat connect")} ${muted("to start chatting")}`);
+  } else {
+    spinner.fail("Signup failed");
+    printError(result.error || "Unknown error");
+  }
+
+  printBlank();
+}

package/src/auth/whoami.js

@@ -0,0 +1,35 @@
+import { loadAuth } from "../config/config.js";
+import { getMe } from "../services/api.js";
+import { createSpinner } from "../ui/spinner.js";
+import { printError, printWarning, printBlank } from "../ui/printer.js";
+import { printUserTable } from "../ui/tables.js";
+import { brand, whiteBold } from "../ui/color.js";
+
+/**
+ * Display current user info.
+ */
+export async function whoamiFlow() {
+  printBlank();
+
+  const auth = loadAuth();
+  if (!auth) {
+    printWarning("You are not logged in. Run: chat login");
+    printBlank();
+    return;
+  }
+
+  const spinner = createSpinner("Fetching profile...");
+  spinner.start();
+
+  const result = await getMe(auth.token);
+
+  if (result.success) {
+    spinner.succeed(`Logged in as ${brand(result.user.username)}`);
+    printUserTable(result.user);
+  } else {
+    spinner.fail("Failed to fetch profile");
+    printError(result.error || "Session may have expired. Try: chat login");
+  }
+
+  printBlank();
+}

package/src/commands/connect.js

@@ -0,0 +1,205 @@
+import readline from "node:readline";
+import { loadAuth } from "../config/config.js";
+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 { showChatHeader } from "../ui/banner.js";
+import {
+  printChatHelp,
+  printModeSwitch,
+  printError,
+  printWarning,
+  printSystem,
+  printBlank,
+} from "../ui/printer.js";
+import { brand, accent, muted, prompt as promptColor } from "../ui/color.js";
+import { CHAT_MODE } from "../utils/constants.js";
+
+/**
+ * Main connect command — enters interactive chat mode.
+ */
+export async function connectCommand() {
+  printBlank();
+
+  // ─── Check Authentication ────────────────────────────────────────────
+
+  const auth = loadAuth();
+  if (!auth) {
+    printWarning("You are not logged in.");
+    console.log(`  ${muted("Run")} ${brand("chat login")} ${muted("or")} ${brand("chat signup")} ${muted("first")}`);
+    printBlank();
+    return;
+  }
+
+  const { username, token } = auth;
+
+  // ─── Chat State ──────────────────────────────────────────────────────
+
+  let chatMode = CHAT_MODE.GLOBAL;
+  let dmTarget = null;
+  let ws = null;
+  let rl = null;
+  let isExiting = false;
+
+  // ─── Prompt Helper ───────────────────────────────────────────────────
+
+  function getPromptString() {
+    if (chatMode === CHAT_MODE.GLOBAL) {
+      return `  ${accent("🌍")} ${promptColor("›")} `;
+    }
+    return `  ${accent("🔒")} ${brand(dmTarget)} ${promptColor("›")} `;
+  }
+
+  function refreshPrompt() {
+    if (rl) {
+      rl.setPrompt(getPromptString());
+      rl.prompt();
+    }
+  }
+
+  // ─── Handle Incoming Messages ────────────────────────────────────────
+
+  function onMessage(data) {
+    // Clear the current prompt line before printing message
+    readline.clearLine(process.stdout, 0);
+    readline.cursorTo(process.stdout, 0);
+
+    handleIncomingMessage(data, username);
+
+    // Re-display the prompt
+    refreshPrompt();
+  }
+
+  // ─── Handle Connection Close ─────────────────────────────────────────
+
+  function onClose(code, reason) {
+    if (!isExiting) {
+      printBlank();
+      printSystem("Connection lost. You have been disconnected.");
+      printBlank();
+      cleanup();
+      process.exit(0);
+    }
+  }
+
+  // ─── Cleanup ─────────────────────────────────────────────────────────
+
+  function cleanup() {
+    isExiting = true;
+    if (rl) {
+      rl.close();
+      rl = null;
+    }
+  }
+
+  // ─── Connect ─────────────────────────────────────────────────────────
+
+  try {
+    ws = await connectWebSocket(token, onMessage, onClose);
+  } catch (err) {
+    printError("Could not connect. Check your credentials or try: chat login");
+    printBlank();
+    return;
+  }
+
+  // ─── Show Chat UI ────────────────────────────────────────────────────
+
+  printBlank();
+  showChatHeader(username, chatMode, dmTarget);
+  printBlank();
+  printSystem("You are in Global Chat. Type a message or /help for commands.");
+  printBlank();
+
+  // ─── Start Interactive Readline ──────────────────────────────────────
+
+  rl = readline.createInterface({
+    input: process.stdin,
+    output: process.stdout,
+    prompt: getPromptString(),
+    terminal: true,
+  });
+
+  rl.prompt();
+
+  rl.on("line", (input) => {
+    const line = input.trim();
+
+    if (!line) {
+      rl.prompt();
+      return;
+    }
+
+    // ─── Chat Commands ─────────────────────────────────────────────
+
+    if (line.startsWith("/")) {
+      const parts = line.split(/\s+/);
+      const cmd = parts[0].toLowerCase();
+
+      switch (cmd) {
+        case "/global":
+          chatMode = CHAT_MODE.GLOBAL;
+          dmTarget = null;
+          printModeSwitch("global");
+          refreshPrompt();
+          return;
+
+        case "/dm": {
+          const target = parts[1];
+          if (!target) {
+            printError("Usage: /dm <username>");
+            rl.prompt();
+            return;
+          }
+          if (target === username) {
+            printError("You cannot DM yourself.");
+            rl.prompt();
+            return;
+          }
+          chatMode = CHAT_MODE.PRIVATE;
+          dmTarget = target;
+          printModeSwitch("private", target);
+          refreshPrompt();
+          return;
+        }
+
+        case "/help":
+          printChatHelp();
+          rl.prompt();
+          return;
+
+        case "/exit":
+          disconnectWebSocket(ws);
+          cleanup();
+          process.exit(0);
+          return;
+
+        default:
+          printError(`Unknown command: ${cmd}. Type /help for available commands.`);
+          rl.prompt();
+          return;
+      }
+    }
+
+    // ─── Send Message ──────────────────────────────────────────────
+
+    sendMessage(ws, chatMode, line, dmTarget);
+    rl.prompt();
+  });
+
+  rl.on("close", () => {
+    if (!isExiting) {
+      disconnectWebSocket(ws);
+      cleanup();
+      process.exit(0);
+    }
+  });
+
+  // ─── Handle process signals ──────────────────────────────────────────
+
+  process.on("SIGINT", () => {
+    disconnectWebSocket(ws);
+    cleanup();
+    process.exit(0);
+  });
+}

package/src/commands/help.js

@@ -0,0 +1,39 @@
+import { brand, muted, accent, whiteBold } from "../ui/color.js";
+import { printBlank } from "../ui/printer.js";
+import { APP_NAME } from "../utils/constants.js";
+
+export function helpCommand() {
+  printBlank();
+  console.log(`  ${whiteBold(`${APP_NAME} — Command Reference`)}`);
+  printBlank();
+
+  const commands = [
+    ["chat signup", "Create a new account"],
+    ["chat login", "Login to your account"],
+    ["chat logout", "Logout and clear credentials"],
+    ["chat whoami", "Show current user info"],
+    ["chat connect", "Connect to chat"],
+    ["chat help", "Show this help menu"],
+  ];
+
+  for (const [cmd, desc] of commands) {
+    console.log(`  ${brand(cmd.padEnd(20))} ${muted(desc)}`);
+  }
+
+  printBlank();
+  console.log(`  ${whiteBold("Inside Chat:")}`);
+  printBlank();
+
+  const chatCommands = [
+    ["/global", "Switch to global chat"],
+    ["/dm <username>", "Switch to private messaging"],
+    ["/help", "Show chat commands"],
+    ["/exit", "Disconnect and exit"],
+  ];
+
+  for (const [cmd, desc] of chatCommands) {
+    console.log(`  ${accent(cmd.padEnd(20))} ${muted(desc)}`);
+  }
+
+  printBlank();
+}

package/src/commands/login.js

@@ -0,0 +1,5 @@
+import { loginFlow } from "../auth/login.js";
+
+export async function loginCommand() {
+  await loginFlow();
+}

package/src/commands/logout.js

@@ -0,0 +1,5 @@
+import { logoutFlow } from "../auth/logout.js";
+
+export function logoutCommand() {
+  logoutFlow();
+}

package/src/commands/signup.js

@@ -0,0 +1,5 @@
+import { signupFlow } from "../auth/signup.js";
+
+export async function signupCommand() {
+  await signupFlow();
+}

package/src/config/config.js

@@ -0,0 +1,71 @@
+import fs from "node:fs";
+import path from "node:path";
+import os from "node:os";
+
+// ─── Config Path ─────────────────────────────────────────────────────────────
+
+const CONFIG_DIR = path.join(os.homedir(), ".cheatchat");
+const CONFIG_FILE = path.join(CONFIG_DIR, "config.json");
+
+// ─── Helpers ─────────────────────────────────────────────────────────────────
+
+function ensureConfigDir() {
+  if (!fs.existsSync(CONFIG_DIR)) {
+    fs.mkdirSync(CONFIG_DIR, { recursive: true });
+  }
+}
+
+function readConfig() {
+  ensureConfigDir();
+  if (!fs.existsSync(CONFIG_FILE)) {
+    return {};
+  }
+  try {
+    const raw = fs.readFileSync(CONFIG_FILE, "utf-8");
+    return JSON.parse(raw);
+  } catch {
+    return {};
+  }
+}
+
+function writeConfig(data) {
+  ensureConfigDir();
+  fs.writeFileSync(CONFIG_FILE, JSON.stringify(data, null, 2), "utf-8");
+}
+
+// ─── Public API ──────────────────────────────────────────────────────────────
+
+/**
+ * Save authentication credentials to disk.
+ */
+export function saveAuth(username, token) {
+  writeConfig({ username, token });
+}
+
+/**
+ * Load stored authentication credentials.
+ * Returns { username, token } or null if not logged in.
+ */
+export function loadAuth() {
+  const config = readConfig();
+  if (config.username && config.token) {
+    return { username: config.username, token: config.token };
+  }
+  return null;
+}
+
+/**
+ * Remove stored authentication credentials (logout).
+ */
+export function clearAuth() {
+  if (fs.existsSync(CONFIG_FILE)) {
+    fs.unlinkSync(CONFIG_FILE);
+  }
+}
+
+/**
+ * Check if the user is currently authenticated.
+ */
+export function isLoggedIn() {
+  return loadAuth() !== null;
+}

package/src/index.js

@@ -0,0 +1,77 @@
+import { Command } from "commander";
+import { showBanner } from "./ui/banner.js";
+import { signupCommand } from "./commands/signup.js";
+import { loginCommand } from "./commands/login.js";
+import { logoutCommand } from "./commands/logout.js";
+import { helpCommand } from "./commands/help.js";
+import { connectCommand } from "./commands/connect.js";
+import { whoamiFlow } from "./auth/whoami.js";
+import { APP_NAME, APP_VERSION, APP_DESCRIPTION } from "./utils/constants.js";
+
+// ─── CLI Program ─────────────────────────────────────────────────────────────
+
+const program = new Command();
+
+program
+  .name("chat")
+  .version(APP_VERSION)
+  .description(APP_DESCRIPTION);
+
+// ─── Commands ────────────────────────────────────────────────────────────────
+
+program
+  .command("signup")
+  .description("Create a new CheatChat account")
+  .action(async () => {
+    showBanner();
+    await signupCommand();
+  });
+
+program
+  .command("login")
+  .description("Login to your CheatChat account")
+  .action(async () => {
+    showBanner();
+    await loginCommand();
+  });
+
+program
+  .command("logout")
+  .description("Logout and clear stored credentials")
+  .action(() => {
+    showBanner();
+    logoutCommand();
+  });
+
+program
+  .command("whoami")
+  .description("Show current logged-in user")
+  .action(async () => {
+    showBanner();
+    await whoamiFlow();
+  });
+
+program
+  .command("connect")
+  .description("Connect to CheatChat and start messaging")
+  .action(async () => {
+    showBanner();
+    await connectCommand();
+  });
+
+program
+  .command("help")
+  .description("Show all available commands")
+  .action(() => {
+    showBanner();
+    helpCommand();
+  });
+
+// ─── Default (no command) ────────────────────────────────────────────────────
+
+if (process.argv.length <= 2) {
+  showBanner();
+  helpCommand();
+} else {
+  program.parse(process.argv);
+}

package/src/services/api.js

@@ -0,0 +1,67 @@
+import axios from "axios";
+import { REST_API_URL } from "../utils/constants.js";
+import { logError } from "../utils/logger.js";
+
+// ─── Axios Instance ──────────────────────────────────────────────────────────
+
+const api = axios.create({
+  baseURL: REST_API_URL,
+  timeout: 15000,
+  headers: { "Content-Type": "application/json" },
+});
+
+// ─── Auth Endpoints ──────────────────────────────────────────────────────────
+
+/**
+ * Register a new user.
+ * Returns { success, username, token, message, error }
+ */
+export async function signup(username, password) {
+  try {
+    const { data } = await api.post("/auth/signup", { username, password });
+    return data;
+  } catch (err) {
+    return extractError(err);
+  }
+}
+
+/**
+ * Authenticate an existing user.
+ * Returns { success, username, token, message, error }
+ */
+export async function login(username, password) {
+  try {
+    const { data } = await api.post("/auth/login", { username, password });
+    return data;
+  } catch (err) {
+    return extractError(err);
+  }
+}
+
+/**
+ * Get the current authenticated user's profile.
+ * Returns { success, user, error }
+ */
+export async function getMe(token) {
+  try {
+    const { data } = await api.get("/auth/me", {
+      headers: { Authorization: `Bearer ${token}` },
+    });
+    return data;
+  } catch (err) {
+    return extractError(err);
+  }
+}
+
+// ─── Error Extraction ────────────────────────────────────────────────────────
+
+function extractError(err) {
+  if (err.response?.data) {
+    return err.response.data;
+  }
+  logError("api", err);
+  return {
+    success: false,
+    error: err.message || "Network error — please check your connection",
+  };
+}

package/src/services/socket.js

@@ -0,0 +1,79 @@
+import WebSocket from "ws";
+import { WS_API_URL } from "../utils/constants.js";
+import { logError, debug } from "../utils/logger.js";
+
+/**
+ * Create and return a WebSocket connection.
+ * @param {string} token - JWT auth token
+ * @param {object} handlers - { onOpen, onMessage, onClose, onError }
+ * @returns {WebSocket}
+ */
+export function createSocket(token, handlers = {}) {
+  const url = `${WS_API_URL}?token=${token}`;
+  debug("Connecting to WebSocket:", url);
+
+  const ws = new WebSocket(url);
+
+  ws.on("open", () => {
+    debug("WebSocket connected");
+    handlers.onOpen?.();
+  });
+
+  ws.on("message", (raw) => {
+    try {
+      const data = JSON.parse(raw.toString());
+      debug("WS message:", data);
+      handlers.onMessage?.(data);
+    } catch (err) {
+      logError("ws-parse", err);
+    }
+  });
+
+  ws.on("close", (code, reason) => {
+    debug("WebSocket closed:", code, reason?.toString());
+    handlers.onClose?.(code, reason?.toString());
+  });
+
+  ws.on("error", (err) => {
+    logError("ws-error", err);
+    handlers.onError?.(err);
+  });
+
+  return ws;
+}
+
+/**
+ * Send a global message through the WebSocket.
+ */
+export function sendGlobalMessage(ws, text) {
+  if (ws.readyState !== WebSocket.OPEN) return false;
+  ws.send(JSON.stringify({
+    action: "message",
+    type: "global",
+    text,
+  }));
+  return true;
+}
+
+/**
+ * Send a private message through the WebSocket.
+ */
+export function sendPrivateMessage(ws, to, text) {
+  if (ws.readyState !== WebSocket.OPEN) return false;
+  ws.send(JSON.stringify({
+    action: "message",
+    type: "private",
+    to,
+    text,
+  }));
+  return true;
+}
+
+/**
+ * Close the WebSocket connection gracefully.
+ */
+export function closeSocket(ws) {
+  if (ws && ws.readyState === WebSocket.OPEN) {
+    ws.close();
+  }
+}

package/src/ui/banner.js

@@ -0,0 +1,58 @@
+import boxen from "boxen";
+import { brand, accent, muted, whiteBold } from "./color.js";
+import { APP_NAME, APP_VERSION, APP_DESCRIPTION } from "../utils/constants.js";
+
+// ─── ASCII Art Logo ──────────────────────────────────────────────────────────
+
+const LOGO = `
+ ██████╗██╗  ██╗███████╗ █████╗ ████████╗
+██╔════╝██║  ██║██╔════╝██╔══██╗╚══██╔══╝
+██║     ███████║█████╗  ███████║   ██║   
+██║     ██╔══██║██╔══╝  ██╔══██║   ██║   
+╚██████╗██║  ██║███████╗██║  ██║   ██║   
+ ╚═════╝╚═╝  ╚═╝╚══════╝╚═╝  ╚═╝   ╚═╝   
+ ██████╗██╗  ██╗ █████╗ ████████╗
+██╔════╝██║  ██║██╔══██╗╚══██╔══╝
+██║     ███████║███████║   ██║   
+██║     ██╔══██║██╔══██║   ██║   
+╚██████╗██║  ██║██║  ██║   ██║   
+ ╚═════╝╚═╝  ╚═╝╚═╝  ╚═╝   ╚═╝`;
+
+/**
+ * Display the welcome banner.
+ */
+export function showBanner() {
+  const logo = brand(LOGO);
+  const tagline = `\n  ${whiteBold(APP_NAME)} ${muted(`v${APP_VERSION}`)}`;
+  const desc = `  ${accent(APP_DESCRIPTION)}`;
+
+  const box = boxen(`${logo}\n${tagline}\n${desc}`, {
+    padding: { top: 0, bottom: 1, left: 2, right: 2 },
+    borderColor: "#6C63FF",
+    borderStyle: "round",
+    dimBorder: false,
+  });
+
+  console.log(box);
+  console.log();
+}
+
+/**
+ * Display a compact header for chat mode.
+ */
+export function showChatHeader(username, mode, target) {
+  const modeLabel = mode === "global"
+    ? accent("🌍 Global Chat")
+    : accent(`🔒 DM → ${whiteBold(target)}`);
+
+  const box = boxen(
+    `${whiteBold(APP_NAME)} ${muted("•")} ${muted("logged in as")} ${brand(username)} ${muted("•")} ${modeLabel}`,
+    {
+      padding: { top: 0, bottom: 0, left: 1, right: 1 },
+      borderColor: "#6C63FF",
+      borderStyle: "round",
+    }
+  );
+
+  console.log(box);
+}

package/src/ui/color.js

@@ -0,0 +1,34 @@
+import chalk from "chalk";
+
+// ─── Brand Colors ────────────────────────────────────────────────────────────
+
+export const brand = chalk.hex("#6C63FF");        // Primary purple
+export const brandBold = chalk.hex("#6C63FF").bold;
+export const accent = chalk.hex("#00D9FF");        // Cyan accent
+export const accentBold = chalk.hex("#00D9FF").bold;
+export const success = chalk.hex("#00E676");       // Green
+export const warning = chalk.hex("#FFD600");       // Yellow
+export const danger = chalk.hex("#FF5252");        // Red
+export const muted = chalk.hex("#888888");         // Gray
+export const subtle = chalk.hex("#555555");        // Darker gray
+export const white = chalk.white;
+export const whiteBold = chalk.white.bold;
+export const dim = chalk.dim;
+
+// ─── Message Colors ─────────────────────────────────────────────────────────
+
+export const globalTag = chalk.bgHex("#6C63FF").white.bold;
+export const privateTag = chalk.bgHex("#FF6B6B").white.bold;
+export const systemTag = chalk.bgHex("#FFD600").black.bold;
+export const errorTag = chalk.bgHex("#FF5252").white.bold;
+
+export const senderSelf = chalk.hex("#00E676").bold;
+export const senderOther = chalk.hex("#00D9FF").bold;
+export const timestamp = chalk.hex("#666666");
+export const messageText = chalk.white;
+
+// ─── UI Elements ─────────────────────────────────────────────────────────────
+
+export const separator = chalk.hex("#333333");
+export const prompt = chalk.hex("#6C63FF").bold;
+export const inputArrow = chalk.hex("#6C63FF")("›");

package/src/ui/printer.js

@@ -0,0 +1,119 @@
+import {
+  globalTag,
+  privateTag,
+  systemTag,
+  errorTag,
+  senderSelf,
+  senderOther,
+  timestamp as tsColor,
+  messageText,
+  muted,
+  success,
+  danger,
+  warning,
+  accent,
+  brand,
+  whiteBold,
+  dim,
+} from "./color.js";
+
+// ─── Formatters ──────────────────────────────────────────────────────────────
+
+function formatTime(ts) {
+  const d = ts ? new Date(ts) : new Date();
+  return d.toLocaleTimeString("en-US", {
+    hour: "2-digit",
+    minute: "2-digit",
+    hour12: true,
+  });
+}
+
+// ─── Message Printers ────────────────────────────────────────────────────────
+
+/**
+ * Print a global chat message.
+ */
+export function printGlobalMessage(sender, text, ts, currentUser) {
+  const time = tsColor(formatTime(ts));
+  const tag = globalTag(" GLOBAL ");
+  const name = sender === currentUser ? senderSelf(sender) : senderOther(sender);
+  console.log(`  ${tag} ${time} ${name}: ${messageText(text)}`);
+}
+
+/**
+ * Print a private/DM message.
+ */
+export function printPrivateMessage(sender, text, ts, currentUser) {
+  const time = tsColor(formatTime(ts));
+  const tag = privateTag(" DM ");
+  const name = sender === currentUser ? senderSelf("You") : senderOther(sender);
+  console.log(`  ${tag} ${time} ${name}: ${messageText(text)}`);
+}
+
+/**
+ * Print a system notification.
+ */
+export function printSystem(text) {
+  console.log(`  ${systemTag(" SYS ")} ${muted(text)}`);
+}
+
+/**
+ * Print an error message.
+ */
+export function printError(text) {
+  console.log(`  ${errorTag(" ERR ")} ${danger(text)}`);
+}
+
+/**
+ * Print a success message.
+ */
+export function printSuccess(text) {
+  console.log(`  ${success("✓")} ${success(text)}`);
+}
+
+/**
+ * Print a warning.
+ */
+export function printWarning(text) {
+  console.log(`  ${warning("⚠")} ${warning(text)}`);
+}
+
+/**
+ * Print info.
+ */
+export function printInfo(text) {
+  console.log(`  ${accent("ℹ")} ${accent(text)}`);
+}
+
+/**
+ * Print the in-chat help menu.
+ */
+export function printChatHelp() {
+  console.log();
+  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("/help")}            ${muted("Show this help menu")}`);
+  console.log(`  ${brand("/exit")}            ${muted("Disconnect and exit")}`);
+  console.log();
+}
+
+/**
+ * Print current chat mode indicator.
+ */
+export function printModeSwitch(mode, target) {
+  console.log();
+  if (mode === "global") {
+    printSystem(`Switched to ${accent("🌍 Global Chat")} — messages go to everyone`);
+  } else {
+    printSystem(`Switched to ${accent(`🔒 DM → ${whiteBold(target)}`)} — messages are private`);
+  }
+  console.log();
+}
+
+/**
+ * Print a blank line.
+ */
+export function printBlank() {
+  console.log();
+}

package/src/ui/spinner.js

@@ -0,0 +1,12 @@
+import ora from "ora";
+
+/**
+ * Create a styled spinner with consistent branding.
+ */
+export function createSpinner(text) {
+  return ora({
+    text,
+    color: "magenta",
+    spinner: "dots",
+  });
+}

package/src/ui/tables.js

@@ -0,0 +1,20 @@
+import { muted } from "./color.js";
+
+/**
+ * Print a simple table for user profile info.
+ */
+export function printUserTable(user) {
+  const rows = [
+    ["Username", user.username],
+    ["Created", new Date(user.createdAt).toLocaleString()],
+    ["Last Seen", new Date(user.lastSeen).toLocaleString()],
+  ];
+
+  const maxKey = Math.max(...rows.map((r) => r[0].length));
+
+  console.log();
+  for (const [key, value] of rows) {
+    console.log(`  ${muted(key.padEnd(maxKey + 2))} ${value}`);
+  }
+  console.log();
+}

package/src/utils/constants.js

@@ -0,0 +1,17 @@
+// ─── API Configuration ───────────────────────────────────────────────────────
+
+export const REST_API_URL = "https://bwkwmpi8ek.execute-api.ap-south-1.amazonaws.com/dev";
+export const WS_API_URL = "wss://lhyew4zkm2.execute-api.ap-south-1.amazonaws.com/dev/";
+
+// ─── App Metadata ────────────────────────────────────────────────────────────
+
+export const APP_NAME = "CheatChat";
+export const APP_VERSION = "1.0.0";
+export const APP_DESCRIPTION = "A minimal terminal chat app powered by AWS.";
+
+// ─── Chat Modes ──────────────────────────────────────────────────────────────
+
+export const CHAT_MODE = {
+  GLOBAL: "global",
+  PRIVATE: "private",
+};

package/src/utils/conversation.js

@@ -0,0 +1,7 @@
+/**
+ * Generate a deterministic conversation ID from two usernames.
+ * Matches the backend logic — always sorted alphabetically.
+ */
+export function makeConversationId(userA, userB) {
+  return [userA, userB].sort().join("#");
+}

package/src/utils/logger.js

@@ -0,0 +1,18 @@
+import { muted } from "../ui/color.js";
+
+/**
+ * Simple logger for debug output (disabled by default).
+ */
+const DEBUG = process.env.CHEATCHAT_DEBUG === "true";
+
+export function debug(...args) {
+  if (DEBUG) {
+    console.log(muted("[DEBUG]"), ...args);
+  }
+}
+
+export function logError(context, err) {
+  if (DEBUG) {
+    console.error(muted(`[ERROR:${context}]`), err);
+  }
+}

package/src/utils/validator.js

@@ -0,0 +1,31 @@
+/**
+ * Validate a username string.
+ * Returns { valid, message }
+ */
+export function validateUsername(input) {
+  const trimmed = input.trim();
+  if (trimmed.length < 3) {
+    return { valid: false, message: "Username must be at least 3 characters" };
+  }
+  if (trimmed.length > 20) {
+    return { valid: false, message: "Username must be at most 20 characters" };
+  }
+  if (!/^[a-zA-Z0-9_]+$/.test(trimmed)) {
+    return { valid: false, message: "Username can only contain letters, numbers, and underscores" };
+  }
+  return { valid: true, message: null };
+}
+
+/**
+ * Validate a password string.
+ * Returns { valid, message }
+ */
+export function validatePassword(input) {
+  if (input.length < 6) {
+    return { valid: false, message: "Password must be at least 6 characters" };
+  }
+  if (input.length > 128) {
+    return { valid: false, message: "Password must be at most 128 characters" };
+  }
+  return { valid: true, message: null };
+}

package/src/websocket/connect.js

@@ -0,0 +1,41 @@
+import { createSocket } from "../services/socket.js";
+import { createSpinner } from "../ui/spinner.js";
+
+/**
+ * Establish a WebSocket connection and return a promise that resolves
+ * with the connected WebSocket, or rejects on failure.
+ * @param {string} token - JWT auth token
+ * @param {function} onMessage - Handler for incoming messages
+ * @param {function} onClose - Handler for connection close
+ * @returns {Promise<WebSocket>}
+ */
+export function connectWebSocket(token, onMessage, onClose) {
+  return new Promise((resolve, reject) => {
+    const spinner = createSpinner("Connecting to CheatChat...");
+    spinner.start();
+
+    const ws = createSocket(token, {
+      onOpen: () => {
+        spinner.succeed("Connected to CheatChat!");
+        resolve(ws);
+      },
+      onMessage,
+      onClose: (code, reason) => {
+        onClose?.(code, reason);
+      },
+      onError: (err) => {
+        spinner.fail("Connection failed");
+        reject(err);
+      },
+    });
+
+    // Timeout after 10 seconds
+    setTimeout(() => {
+      if (ws.readyState !== 1) {
+        spinner.fail("Connection timed out");
+        ws.close();
+        reject(new Error("Connection timed out"));
+      }
+    }, 10000);
+  });
+}

package/src/websocket/disconnect.js

@@ -0,0 +1,13 @@
+import { closeSocket } from "../services/socket.js";
+import { printSystem, printBlank } from "../ui/printer.js";
+
+/**
+ * Gracefully disconnect from the WebSocket.
+ */
+export function disconnectWebSocket(ws) {
+  printBlank();
+  printSystem("Disconnecting...");
+  closeSocket(ws);
+  printSystem("Goodbye! 👋");
+  printBlank();
+}

package/src/websocket/receiver.js

@@ -0,0 +1,26 @@
+import { printGlobalMessage, printPrivateMessage, printError, printSystem } from "../ui/printer.js";
+
+/**
+ * Handle incoming WebSocket messages and dispatch to the appropriate printer.
+ * @param {object} data - Parsed JSON message from the server
+ * @param {string} currentUser - The local user's username
+ */
+export function handleIncomingMessage(data, currentUser) {
+  switch (data.event) {
+    case "global_message":
+      printGlobalMessage(data.sender, data.text, data.timestamp, currentUser);
+      break;
+
+    case "private_message":
+      printPrivateMessage(data.sender, data.text, data.timestamp, currentUser);
+      break;
+
+    case "error":
+      printError(data.message || "Unknown server error");
+      break;
+
+    default:
+      printSystem(`Unknown event: ${data.event}`);
+      break;
+  }
+}

package/src/websocket/sender.js

@@ -0,0 +1,25 @@
+import { sendGlobalMessage, sendPrivateMessage } from "../services/socket.js";
+import { printError } from "../ui/printer.js";
+
+/**
+ * Send a message based on the current chat mode.
+ * @param {WebSocket} ws - Active WebSocket connection
+ * @param {string} mode - "global" or "private"
+ * @param {string} text - Message text
+ * @param {string} [dmTarget] - Target username for private messages
+ */
+export function sendMessage(ws, mode, text, dmTarget) {
+  if (!text.trim()) return;
+
+  if (mode === "global") {
+    const ok = sendGlobalMessage(ws, text);
+    if (!ok) printError("Not connected. Message not sent.");
+  } else if (mode === "private") {
+    if (!dmTarget) {
+      printError("No DM target set. Use /dm <username>");
+      return;
+    }
+    const ok = sendPrivateMessage(ws, dmTarget, text);
+    if (!ok) printError("Not connected. Message not sent.");
+  }
+}