server.js

// DaisyChain-Infer signaling + static host.
//
// Deliberately tiny. What it does NOT do is the point: it introduces peers and
// relays WebRTC handshakes, and never sees a weight, an activation, a prompt,
// or a generated token. Those move directly between the devices in the ring,
// and weights come from the Hugging Face CDN straight to each browser.
//
// The one exception is the OAuth code exchange below, which by construction
// has to handle an access token for a few milliseconds. That is called out
// rather than glossed: see the comment on /auth/callback.
//
// Only dependency: `ws`.  Run:  npm install && npm start
const http = require("http");
const fs = require("fs");
const path = require("path");
const crypto = require("crypto");
const { WebSocketServer } = require("ws");

// ---- rooms -------------------------------------------------------------------
// Snapdrop-style grouping: same public IP -> same room, so devices on your own
// network find each other with no code. ?room=CODE crosses networks, gated by
// host approval.
function clientIP(req) {
  const xff = req.headers["x-forwarded-for"];
  if (xff) return xff.split(",")[0].trim();
  return (req.socket.remoteAddress || "unknown").replace(/^::ffff:/, "");
}
function roomFor(req) {
  const u = new URL(req.url, "http://x");
  const code = u.searchParams.get("room");
  if (code) return "room:" + code;
  const h = crypto.createHash("sha256").update(clientIP(req)).digest("hex").slice(0, 10);
  return "net:" + h;
}

const PORT = process.env.PORT || 8788;
const PUB = path.join(__dirname, "public");
const TYPES = { ".html": "text/html", ".js": "text/javascript",
                ".css": "text/css", ".json": "application/json" };

// ---- OAuth (hosted deployments) ----------------------------------------------
// On a Hugging Face Space with `hf_oauth: true`, these are injected by the
// platform. When they are absent — a local run — OAuth is simply off and the
// page falls back to asking for a token directly, which is safe there because
// the page is served from the user's own machine.
const OA = {
  clientId: process.env.OAUTH_CLIENT_ID,
  clientSecret: process.env.OAUTH_CLIENT_SECRET,
  scopes: process.env.OAUTH_SCOPES || "read-repos",
  provider: (process.env.OPENID_PROVIDER_URL || "https://huggingface.co").replace(/\/$/, ""),
  spaceHost: process.env.SPACE_HOST || "",
};
const oauthOn = !!(OA.clientId && OA.clientSecret);

// One-time `state` values, so a callback cannot be replayed or forged. Short
// TTL, and consumed on use.
const states = new Map();                 // state -> expiry ms
function newState() {
  const s = crypto.randomBytes(24).toString("base64url");
  states.set(s, Date.now() + 10 * 60 * 1000);
  return s;
}
function takeState(s) {
  const exp = states.get(s);
  if (exp === undefined) return false;
  states.delete(s);                       // single use
  return exp > Date.now();
}
setInterval(() => {
  const now = Date.now();
  for (const [s, exp] of states) if (exp <= now) states.delete(s);
}, 60000);

function redirectUri(req) {
  const host = OA.spaceHost || req.headers.host;
  const proto = OA.spaceHost || /^(localhost|127\.|\[::1\])/.test(host || "") === false ? "https" : "http";
  return `${proto}://${host}/auth/callback`;
}

function oauthLogin(req, res) {
  const state = newState();
  const u = new URL(OA.provider + "/oauth/authorize");
  u.searchParams.set("client_id", OA.clientId);
  u.searchParams.set("redirect_uri", redirectUri(req));
  u.searchParams.set("response_type", "code");
  u.searchParams.set("scope", OA.scopes);
  u.searchParams.set("state", state);
  res.writeHead(302, { Location: u.toString() });
  res.end();
}

// The token exchange needs the client secret, so it MUST happen here rather
// than in the browser — which means this server briefly holds an access token.
// It is never written to disk, never logged, and never kept: it is handed to
// the browser in the URL *fragment*, which browsers do not send to servers and
// which the page strips from history immediately on arrival. That is the
// smallest exposure the OAuth flow allows; it is not zero, and the Space's
// README says so.
async function oauthCallback(req, res, url) {
  const code = url.searchParams.get("code");
  const state = url.searchParams.get("state");
  const err = url.searchParams.get("error");
  const bail = (msg) => {
    res.writeHead(302, { Location: "/#oauth_error=" + encodeURIComponent(msg) });
    res.end();
  };
  if (err) return bail(err);
  if (!code || !state) return bail("missing code or state");
  if (!takeState(state)) return bail("state was not recognised — start the sign-in again");
  try {
    const body = new URLSearchParams({
      grant_type: "authorization_code",
      code,
      redirect_uri: redirectUri(req),
      client_id: OA.clientId,
      client_secret: OA.clientSecret,
    });
    const r = await fetch(OA.provider + "/oauth/token", {
      method: "POST",
      headers: { "Content-Type": "application/x-www-form-urlencoded", Accept: "application/json" },
      body,
    });
    if (!r.ok) return bail(`token exchange failed (HTTP ${r.status})`);
    const j = await r.json();
    if (!j.access_token) return bail("no access token in the response");
    res.writeHead(302, { Location: "/#hf=" + encodeURIComponent(j.access_token) });
    res.end();
  } catch (e) {
    bail("token exchange error");                 // deliberately not e.message
  }
}

// keepalive: proxies close idle WebSockets, and a ring can sit idle between
// prompts far longer than a training run ever does
setInterval(() => {
  for (const room of rooms.values())
    for (const [, v] of room.peers) {
      if (v.ws.isAlive === false) { v.ws.terminate(); continue; }
      v.ws.isAlive = false;
      send(v.ws, { type: "ping" });
    }
}, 30000);

const server = http.createServer((req, res) => {
  const url = new URL(req.url, "http://x");
  let p = decodeURIComponent(url.pathname);

  if (p === "/mode") {
    let rtc = null;
    try { if (process.env.DAISY_RTC_CONFIG) rtc = JSON.parse(process.env.DAISY_RTC_CONFIG); } catch (e) {}
    res.writeHead(200, { "Content-Type": "application/json", "Cache-Control": "no-store" });
    return res.end(JSON.stringify({
      // DAISY_FORCE_ROOMS=1 (set on the hosted Space): no LAN auto-grouping, so
      // strangers who happen to share a public IP — same CGNAT, same campus,
      // same office — are never put in one ring. Each visitor makes their own
      // room and invites devices by link.
      forceRooms: !!process.env.DAISY_FORCE_ROOMS,
      // When OAuth is available the page does not offer a paste-a-token box at
      // all: on a deployment the user does not control, signing in is the only
      // credential path offered.
      oauth: oauthOn,
      rtc,
    }));
  }
  if (p === "/auth/login" || p === "/oauth/login") {
    if (!oauthOn) { res.writeHead(404); return res.end("oauth is not configured"); }
    return oauthLogin(req, res);
  }
  // HF registers /auth/callback for Spaces; the alias costs nothing and saves a
  // broken deploy if the platform ever hands back the other spelling.
  if (p === "/auth/callback" || p === "/oauth/callback") {
    if (!oauthOn) { res.writeHead(404); return res.end("oauth is not configured"); }
    return void oauthCallback(req, res, url);
  }

  if (p === "/") p = "/index.html";
  const file = path.join(PUB, path.normalize(p));
  if (!file.startsWith(PUB)) { res.writeHead(403); return res.end(); }
  fs.readFile(file, (err, data) => {
    if (err) { res.writeHead(404); return res.end("not found"); }
    res.writeHead(200, { "Content-Type": TYPES[path.extname(file)] || "application/octet-stream" });
    res.end(data);
  });
});

const wss = new WebSocketServer({ server });
const rooms = new Map();
let nextId = 1;
function send(ws, obj) { if (ws.readyState === 1) ws.send(JSON.stringify(obj)); }

wss.on("connection", (ws, req) => {
  const roomId = roomFor(req);
  const name = (new URL(req.url, "http://x").searchParams.get("name") || "").slice(0, 40) || ("p" + nextId);
  const id = "p" + (nextId++);
  ws.peerId = id; ws.roomId = roomId;
  if (!rooms.has(roomId)) rooms.set(roomId, { peers: new Map(), host: null, pending: new Map() });
  const room = rooms.get(roomId);
  const isPrivate = roomId.startsWith("room:");

  function admit(pid, peer) {
    const roster = [...room.peers.entries()].map(([qid, v]) => ({ id: qid, name: v.name }));
    send(peer.ws, { type: "welcome", id: pid, room: roomId, peers: roster, host: room.host === pid });
    for (const [, v] of room.peers) send(v.ws, { type: "peer-joined", id: pid, name: peer.name });
    room.peers.set(pid, peer);
  }

  if (isPrivate && room.peers.size === 0) room.host = id;
  if (isPrivate && room.host !== id) {
    room.pending.set(id, { ws, name });
    send(ws, { type: "waiting" });
    const h = room.peers.get(room.host);
    if (h) send(h.ws, { type: "join-request", id, name });
  } else {
    admit(id, { ws, name });
  }

  ws.on("message", (buf) => {
    let msg; try { msg = JSON.parse(buf); } catch { return; }
    if (msg.type === "signal" && msg.to && room.peers.has(id)) {
      const target = room.peers.get(msg.to);
      if (target) send(target.ws, { type: "signal", from: id, data: msg.data });
    } else if (msg.type === "pong") {
      ws.isAlive = true;
    } else if (msg.type === "relay" && msg.to && room.peers.has(id)) {
      // last-resort path when two devices cannot form a direct WebRTC route.
      // Note this DOES put activations through the server — the UI says so.
      const target = room.peers.get(msg.to);
      if (target) send(target.ws, { type: "relay", from: id, data: msg.data });
    } else if (msg.type === "admit" && id === room.host) {
      const p = room.pending.get(msg.id);
      if (!p) return;
      room.pending.delete(msg.id);
      if (msg.allow) admit(msg.id, p);
      else { send(p.ws, { type: "denied" }); p.ws.close(); }
    }
  });

  ws.on("close", () => {
    room.pending.delete(id);
    if (room.peers.delete(id))
      for (const [, v] of room.peers) send(v.ws, { type: "peer-left", id });
    if (room.host === id) {
      room.host = room.peers.keys().next().value ?? null;
      const h = room.peers.get(room.host);
      if (h) {
        send(h.ws, { type: "host" });
        for (const [pid, p] of room.pending) send(h.ws, { type: "join-request", id: pid, name: p.name });
      }
    }
    if (room.peers.size === 0 && room.pending.size === 0) rooms.delete(roomId);
  });
});

server.listen(PORT, () =>
  console.log(`DaisyChain-Infer on http://localhost:${PORT}` +
              (oauthOn ? " (HF OAuth enabled)" : "") +
              (process.env.DAISY_FORCE_ROOMS ? " (rooms forced)" : "")));