coms/client/public/data.js

// coms/client/public/data.js
// Data module: holds the in‐memory threads, notices and reply state

// Map of all messages and notices by ID
// Client’s own session ID
let myId = null;
const threads = new Map();

// Map of connected users by unique ID
const users = new Map();

// Ordered list of root‐level IDs (messages and notices)
const rootIds = [];

// Negative counter to generate unique IDs for notices
let noticeCounter = -1;

// ID of the message we’re currently replying to (or null)
let replyTo = null;

// ID of the message currently focused for navigation (or null)
let focusedId = null;

/**
 * Set the focused message ID (or null to clear).
 * @param {number|null} id
 */
function setFocused(id) {
  focusedId = id;
}
/**
 * Get the currently focused message ID.
 * @returns {number|null}
 */
function getFocused() {
  return focusedId;
}
/**
 * Clear the current focus.
 */
function clearFocused() {
  focusedId = null;
}

// -- User management API ---

/**
 * Register a user with their unique ID.
 * @param {number} id
 * @param {string} name
 */
function addUser(id, name) {
  users.set(id, name);
}

/**
 * Remove a user by their ID.
 * @param {number} id
 */
function removeUser(id) {
  users.delete(id);
}

/**
 * Update a user’s name.
 * @param {number} id
 * @param {string} name
 */
function updateUser(id, name) {
  users.set(id, name);
}

/**
 * Get a list of {id, name} objects for all users.
 * @returns {{id:number, name:string}[]}
 */
function getUsers() {
  return Array.from(users.entries()).map(([id, name]) => ({ id, name }));
}

/**
 * Get grouped display strings: e.g. ["Anon (3x)", "Alice (1x)"]
 * @returns {string[]}
 */
function getGroupedUsers() {
  const counts = {};
  for (const name of users.values()) {
    counts[name] = (counts[name] || 0) + 1;
  }
  return Object.entries(counts).map(([name, count]) => {
    const nameSpan = `<span class="name">${new Option(name).innerHTML}</span>`;
    return count > 1 ? `${nameSpan} (${count}x)` : nameSpan;
  });
}

/**
 * Add a new chat message to the thread structure.
 * @param {{id: number, username: string, content: string, ts: number, parent?: number}} msg
 */
function addMessage({ id, username, content, ts, parent = null }) {
  threads.set(id, { id, username, content, ts, parent, children: [] });
  if (parent !== null && threads.has(parent)) {
    threads.get(parent).children.push(id);
  } else {
    rootIds.push(id);
  }
}

/**
 * Insert a system notice as a root‐level thread item.
 * @param {string} content — HTML or plain text for the notice
 */
function addNotice(content) {
  const ts = Math.floor(Date.now() / 1000);
  const id = noticeCounter--;
  threads.set(id, {
    id,
    username: "",
    content,
    ts,
    parent: null,
    children: [],
  });
  rootIds.push(id);
}

/**
 * Reset all data (useful for unit tests or full re‐initialization).
 */
function clearData() {
  threads.clear();
  rootIds.length = 0;
  noticeCounter = -1;
  replyTo = null;
}

/** @returns {Map<number,object>} The threads map. */
function getThreads() {
  return threads;
}

/** @returns {number[]} The ordered list of root‐level IDs. */
function getRootIds() {
  return rootIds;
}

/**
 * Set this client’s own session ID.
 * @param {number} id
 */
function setMyId(id) {
  myId = id;
}

/**
 * Get this client’s own session ID.
 * @returns {number|null}
 */
function getMyId() {
  return myId;
}

/** @returns {number|null} The current reply‐to ID. */
function getReplyTo() {
  return replyTo;
}

/** @param {number|null} id — Set the current reply‐to ID. */
function setReplyTo(id) {
  replyTo = id;
}

export {
  threads,
  rootIds,
  users,
  addMessage,
  addNotice,
  addUser,
  removeUser,
  updateUser,
  getUsers,
  getGroupedUsers,
  clearData,
  getThreads,
  getRootIds,
  getReplyTo,
  setReplyTo,
  getFocused,
  setFocused,
  clearFocused,
  setMyId,
  getMyId,
};