fedipod-server 0.29.0 → 0.30.0

package/lib/gateway/directory.mjs

@@ -1,90 +0,0 @@
-// directory.mjs — the well-known door. Whichever running agent holds port
-// 8030 answers there with a redirect to its own record page, so opening
-// https://localhost:8030/ always reaches a page that lists every identity on
-// this machine, whatever ports they actually run on. Loopback only, https
-// only — like every listener this project starts. Held only by a CONFIGURED agent: an
-// unconfigured one's record page is a setup form with no identity list,
-// which strands whoever the door sends there.
-//
-// The door is held politely: it identifies itself at GET /__directory, and a
-// real owner of the port — an identity that recorded 8030 as its own — asks it
-// to step aside with POST /__directory/yield before binding. The holder frees
-// the port at once and stays off it for a minute. AP_DIRECTORY=0 disables the
-// whole mechanism (the test suite sets it, so throwaway agents do not fight
-// over a real machine's door).
-import https from 'node:https';
-import { localFetch } from '../client/localapi.mjs';
-
-export const DIRECTORY_PORT = 8030;
-
-// Answer for a running agent. No-op when this agent already IS the door, or
-// when the mechanism is switched off. `eligible` is asked before every claim
-// attempt — the 15 s retry means an agent that configures later takes the
-// door soon after, and one that never does never holds it.
-export function claimDirectory({ port, origin, log = () => {}, eligible = () => true, tls = null }) {
-  if (process.env.AP_DIRECTORY === '0' || port === DIRECTORY_PORT) {
-    return { stop: () => {} };
-  }
-  const servers = [];
-  let held = false;
-  let pausedUntil = 0;
-  const handler = (req, res) => {
-    const p = req.url || '/';
-    if (p === '/__directory') {
-      res.writeHead(200, { 'content-type': 'application/json' });
-      res.end(JSON.stringify({ directory: true, agent: origin() }) + '\n');
-      return;
-    }
-    if (req.method === 'POST' && p === '/__directory/yield') {
-      pausedUntil = Date.now() + 60_000;
-      res.writeHead(200, { 'content-type': 'application/json' });
-      res.end('{"ok":true}\n');
-      release();
-      log(`directory: yielded port ${DIRECTORY_PORT}`);
-      return;
-    }
-    res.writeHead(302, { location: origin().replace(/\/$/, '') + p });
-    res.end();
-  };
-  const release = () => {
-    for (const s of servers.splice(0)) { try { s.close(); } catch { /* already down */ } }
-    held = false;
-  };
-  const tryClaim = () => {
-    if (held || !eligible() || Date.now() < pausedUntil) return;
-    // Loopback both ways, like the agent's own listener: "localhost" resolves
-    // to ::1 first on many systems. IPv4 is the one that decides `held`.
-    if (!tls) return;   // no certificate, no door: this project serves https only
-    const tlsOpts = { key: tls.key, cert: tls.cert };
-    const s4 = https.createServer(tlsOpts, handler);
-    s4.on('error', () => { /* someone else holds the door — retry later */ });
-    s4.listen(DIRECTORY_PORT, '127.0.0.1', () => {
-      held = true;
-      servers.push(s4);
-      const s6 = https.createServer(tlsOpts, handler);
-      s6.on('error', () => { /* no IPv6 loopback here — IPv4 covers it */ });
-      s6.listen(DIRECTORY_PORT, '::1', () => servers.push(s6));
-      log(`directory: https://localhost:${DIRECTORY_PORT}/ now reaches ${origin()}`);
-    });
-  };
-  tryClaim();
-  const timer = setInterval(tryClaim, 15_000);
-  timer.unref();
-  return { stop: () => { clearInterval(timer); release(); } };
-}
-
-// Free `port` if what holds it is the directory door. Returns true when the
-// port is free afterwards. Quick and quiet on every other kind of holder.
-export async function yieldDirectory(port, { portFree, home = null } = {}) {
-  const probe = await localFetch(home, port, '/__directory', { timeout: 1000 })
-    .then(r => (r.ok ? r.json() : null)).catch(() => null);
-  if (!probe?.directory) return false;
-  await localFetch(home, port, '/__directory/yield', { method: 'POST', timeout: 1000 })
-    .catch(() => {});
-  if (!portFree) return true;
-  for (let i = 0; i < 10; i++) {
-    if (await portFree(port)) return true;
-    await new Promise(r => setTimeout(r, 100));
-  }
-  return false;
-}