AgentHub/server/routes/me.js

/**
 * @file me.js
 * @description `/api/me` — the signed-in account's own UI preferences and its
 * first-run setup (docs/plans/onboarding). The browser keeps these in
 * localStorage; this stores the same keys per ACCOUNT (`user_prefs`), so they
 * follow it to any browser and the setup wizard shows once per account.
 * Local mode is one account, `local`. Only the keys in `PREF_KEYS` are kept,
 * each a string of at most 8 KB — this is a preferences store, not a blob
 * store. Writes are same-origin and touch only the caller's own row.
 * `agenthub.chatUi` ("1") opens Claude/Codex sessions as a chat (`PaneChat`).
 *
 * S3 (one Linux user per account): an account's dark/light choice also becomes
 * the theme in their own Claude Code settings, written as them.
 * @author Nguyễn Ngọc Trí Vĩ <vinnt@smartgift.vn>
 */

const { Router } = require("express");
const { db } = require("../db");
const auth = require("../lib/auth");
const { sameOriginGuard } = require("../lib/same-origin");

const router = Router();

/** The localStorage keys an account's preferences are made of. */
const PREF_KEYS = [
  "theme",
  "agenthub.theme.dark",
  "agenthub.theme.light",
  "i18nextLng",
  "agenthub.terminal.font",
  "agenthub.pet",
  "agenthub.pet.size",
  "agent-dashboard-sagi-enabled",
  "agent-dashboard-sagi-muted",
  "agent-monitor-notifications",
  "agenthub.defaultTool",
  "agenthub.permissionMode",
  "agenthub.tour",
  "agenthub.chatUi",
];
const MAX_VALUE = 8 * 1024;

/** `u<id>` for a server-mode account, `local` in local mode, null when nobody is signed in. */
function userKey(req) {
  if (!auth.isServerMode()) return "local";
  const user = req.user || auth.userFromRequest(req);
  return user ? `u${user.id}` : null;
}

const getRow = db.prepare("SELECT prefs, onboarded_at FROM user_prefs WHERE user_key = ?");
const upsert = db.prepare(
  `INSERT INTO user_prefs (user_key, prefs) VALUES (?, ?)
   ON CONFLICT(user_key) DO UPDATE SET prefs = excluded.prefs,
     updated_at = strftime('%Y-%m-%dT%H:%M:%fZ', 'now')`
);
const markOnboarded = db.prepare(
  `INSERT INTO user_prefs (user_key, onboarded_at) VALUES (?, strftime('%Y-%m-%dT%H:%M:%fZ', 'now'))
   ON CONFLICT(user_key) DO UPDATE SET onboarded_at = COALESCE(onboarded_at, excluded.onboarded_at)`
);

function read(key) {
  const row = getRow.get(key);
  let prefs = {};
  try {
    prefs = row ? JSON.parse(row.prefs) : {};
  } catch {
    /* a damaged row reads as empty */
  }
  return { prefs, onboardedAt: row?.onboarded_at || null };
}

const unauth = (res) =>
  res.status(401).json({ error: { code: "EAUTH", message: "sign in first" } });

router.get("/prefs", (req, res) => {
  const key = userKey(req);
  if (!key) return unauth(res);
  res.json(read(key));
});

router.put("/prefs", sameOriginGuard, (req, res) => {
  const key = userKey(req);
  if (!key) return unauth(res);
  const patch = req.body?.prefs;
  if (!patch || typeof patch !== "object" || Array.isArray(patch)) {
    return res.status(400).json({ error: { code: "EBADPREFS", message: "prefs: an object" } });
  }
  const { prefs } = read(key);
  for (const [k, v] of Object.entries(patch)) {
    if (!PREF_KEYS.includes(k)) {
      return res.status(400).json({ error: { code: "EBADPREFS", message: `unknown key ${k}` } });
    }
    if (v === null) delete prefs[k];
    else if (typeof v === "string" && v.length <= MAX_VALUE) prefs[k] = v;
    else return res.status(400).json({ error: { code: "EBADPREFS", message: `${k}: a short string` } });
  }
  upsert.run(key, JSON.stringify(prefs));
  if ("theme" in patch) followClaudeTheme(req, patch.theme);
  res.json(read(key));
});

router.post("/onboarded", sameOriginGuard, (req, res) => {
  const key = userKey(req);
  if (!key) return unauth(res);
  markOnboarded.run(key);
  res.json(read(key));
});

/** S3: an account's dark/light mode becomes their Claude Code theme (best effort). */
function followClaudeTheme(req, mode) {
  if (mode !== "dark" && mode !== "light") return;
  try {
    const runAs = require("../lib/run-as");
    const acct = runAs.accountForUser(req.user?.username);
    if (acct) require("../lib/member-claude").setTheme(acct, mode);
  } catch (err) {
    console.warn("[me] Claude theme not written:", err.message);
  }
}

module.exports = router;
module.exports.PREF_KEYS = PREF_KEYS;