fedipod-server 0.29.0 → 0.31.0

package/web/admin/notices-bar.js

@@ -1,90 +0,0 @@
-// notices-bar.js — the notices bell in the bar, on every page of ours.
-//
-// Whoever runs the site writes notices (the /notices page, admin only); every
-// signed-in account sees the bell. This asks /api/notices once per page load,
-// hides the bell where the site has none to offer (a DeviceAgent's own pages
-// answer no such thing), lists the titles, and opens one notice at a time.
-// Which notices this browser has already opened is this browser's business
-// alone, so it lives in localStorage and nowhere else.
-//
-// Every element here is declared in the page's markup; this fills them.
-(() => {
-  const bell = document.getElementById('bar-notices');
-  const list = document.getElementById('notices-list');
-  const view = document.getElementById('notice-view');
-  if (!bell || !list || !view) return;
-  const $ = (id) => document.getElementById(id);
-  const SEEN = 'fedipod-notices-seen';
-  const readSeen = () => { try { return JSON.parse(localStorage.getItem(SEEN) || '[]'); } catch { return []; } };
-  const writeSeen = (ids) => { try { localStorage.setItem(SEEN, JSON.stringify(ids.slice(-200))); } catch { /* keeps no site data */ } };
-
-  const when = (iso) => { try { return new Date(iso).toLocaleDateString(undefined, { year: 'numeric', month: 'short', day: 'numeric' }); } catch { return ''; } };
-
-  // A notice's body is plain text: paragraphs at blank lines, and a bare
-  // https link becomes a link. Nothing in it is ever read as markup.
-  const renderBody = (el, text) => {
-    el.textContent = '';
-    for (const para of String(text || '').split(/\n\s*\n/u)) {
-      const p = document.createElement('p');
-      for (const part of para.split(/(https?:\/\/[^\s<>"']+)/u)) {
-        if (/^https?:\/\//u.test(part)) {
-          const a = document.createElement('a');
-          a.href = part; a.textContent = part; a.target = '_blank'; a.rel = 'noopener';
-          p.append(a);
-        } else p.append(part);
-      }
-      el.append(p);
-    }
-  };
-
-  let notices = [];
-  const render = () => {
-    const seen = new Set(readSeen());
-    const fresh = notices.filter((n) => !seen.has(n.id)).length;
-    $('bar-notices-count').textContent = fresh ? String(fresh) : '';
-    bell.dataset.new = String(fresh);
-    bell.setAttribute('aria-label', fresh ? `Notices, ${fresh} new` : 'Notices');
-    const ul = $('notices-items');
-    ul.textContent = '';
-    if (!notices.length) {
-      const p = document.createElement('p'); p.className = 'none'; p.textContent = 'No notices.';
-      ul.append(p);
-      return;
-    }
-    for (const n of notices) {
-      const li = document.createElement('li');
-      if (!seen.has(n.id)) li.classList.add('new');
-      const b = document.createElement('button');
-      b.type = 'button'; b.className = 'notice-open'; b.textContent = n.title;
-      b.addEventListener('click', () => open(n));
-      const w = document.createElement('span'); w.className = 'when'; w.textContent = when(n.at);
-      li.append(b, w);
-      ul.append(li);
-    }
-  };
-
-  const open = (n) => {
-    $('notice-view-title').textContent = n.title;
-    $('notice-view-when').textContent = when(n.at);
-    renderBody($('notice-view-body'), n.body);
-    const seen = readSeen();
-    if (!seen.includes(n.id)) { seen.push(n.id); writeSeen(seen); }
-    render();
-    list.close();
-    view.showModal();
-  };
-
-  bell.addEventListener('click', () => { render(); list.showModal(); });
-  $('notices-close').addEventListener('click', () => list.close());
-  $('notice-view-close').addEventListener('click', () => { view.close(); list.showModal(); });
-
-  fetch(location.origin + '/api/notices', { headers: { accept: 'application/json' } })
-    .then((r) => (r.ok ? r.json() : null))
-    .then((j) => {
-      if (!j || !Array.isArray(j.notices)) return;
-      notices = j.notices;
-      render();
-      bell.hidden = false;
-    })
-    .catch(() => { /* no site notices here; the bell stays hidden */ });
-})();

package/web/admin/oauth-signin.mjs

@@ -1,37 +0,0 @@
-// oauth-signin.mjs — a client asked this account to sign its owner in. The
-// owner signs in at their own pod, with the fediverse-account library, and the
-// page proves that sign-in to the account with one signed request; the account
-// then hands the client its code. No password of ours anywhere.
-import { fediLogin } from './fedi-login.mjs';
-
-const $ = (id) => document.getElementById(id);
-const say = (text, error = false) => { const s = $('signin-status'); s.textContent = text; s.setAttribute('role', error ? 'alert' : 'status'); };
-const webId = $('webid').href;
-const here = location.origin + location.pathname;
-const login = fediLogin({ dbName: 'fedipod-signin', clientName: 'FediPod sign-in', redirectUri: here });
-
-// Back from the pod: this finishes the sign-in and returns to the client's
-// request, which carries the client's own parameters.
-try { await login.resume(); } catch (e) { say(e.message, true); }
-
-async function prove() {
-  const s = await login.getSession();
-  if (!s) return false;
-  if (s.webId !== webId) { say(`You signed in as ${s.webId}, but this account belongs to ${webId}. Sign out there and sign in as the owner.`, true); return true; }
-  say('Signing you in…');
-  const res = await s.fetch(here, {
-    method: 'POST', headers: { 'content-type': 'application/x-www-form-urlencoded' },
-    body: location.search.replace(/^\?/u, ''),
-  });
-  const d = await res.json().catch(() => ({}));
-  if (res.ok && d.redirect) { location.href = d.redirect; return true; }
-  if (res.ok && d.code) { say(`Your authorization code: ${d.code}`); return true; }
-  say(d.error || `The account refused the sign-in (HTTP ${res.status}).`, true);
-  return true;
-}
-
-if (location.search.includes('client_id=') && !(await prove())) $('signin').hidden = false;
-$('signin').addEventListener('click', async () => {
-  say('Taking you to your pod…');
-  try { await login.login(webId, { returnTo: location.href, redirectUri: here }); } catch (e) { say(e.message, true); }
-});

package/web/admin/record.js

@@ -1,393 +0,0 @@
-// record.js — the record itself: what the page holds of the config, the
-// messages it says, every write, the load, the panels, and the rows of the
-// facts list with the identity rows and their controls.
-// admin.js — the record, as a page. Everything here is an existing admin
-// route; the CLI's own group commands are thin clients over the same ones.
-//
-// Two rules the routes enforce and this page respects: a write is a MERGE, so a
-// form that never mentions a field cannot delete it; and anything on the wire is
-// not real until the actor is republished, which POST /config does for itself.
-//
-// The UI password is deliberately not here — `fedipod passwd` sets it. It
-// only gates /oauth/authorize, so it does nothing for a loopback-only agent.
-
-let config = null;
-// Held, because render() moves it into a generated row and empties that row's
-// list on the next pass — after which getElementById would not find it again.
-const MODERATION = $('moderation');
-const STATUS = $('status-ctl');
-const STATUS_PICK = $('status-pick');   // held: getElementById can't see it mid-render
-const IDENT_CTL = $('ident-ctl');
-const FOLLOWS_CTL = $('follows-ctl');
-const FOLLOWS_PICK = $('follows-pick');
-const UPDATE_CTL = $('update-ctl');
-const UPDATE_WORD = $('update-word');
-const UPDATE_GO = $('update-go');
-
-// #say and #fatal live in the accessibility tree from load and hide by being
-// empty (see the stylesheet). Unhiding a live region and filling it in the same
-// task is the classic way to get no announcement at all.
-function say(text, cls = 'ok') {
-  const el = $('say');
-  el.className = cls;
-  // Clear first, then set on the next task: a live region that is handed the
-  // same text it already holds announces nothing, so two identical messages in
-  // a row ("nothing changed", "nothing changed") would be silent the second time.
-  el.textContent = '';
-  setTimeout(() => { el.textContent = text; }, 30);
-}
-
-// Every write goes through here, so nothing silently half-succeeds.
-async function write(path, body, done) {
-  const { status, json } = await postJson(path, body);
-  if (status >= 400) { say(json?.error || `refused (HTTP ${status})`, 'err'); return null; }
-  say(done);
-  return json;
-}
-
-UPDATE_GO.onclick = async () => {
-  UPDATE_GO.disabled = true;
-  const r = await write('/update', {}, 'updating — the agents restart when it finishes; reload in a moment');
-  if (!r) UPDATE_GO.disabled = false;
-};
-
-async function load() {
-  const { status, json } = await api('/config');
-  if (status === 409) {
-    $('fatal').textContent = 'This agent has no identity yet.';
-    const a = document.createElement('a');
-    a.href = '/admin/setup/';
-    a.textContent = ' Set it up.';
-    $('fatal').appendChild(a);
-    return;
-  }
-  // No agent answering on this browser: nobody is signed in here (the
-  // worker answers 503 with no session, and nothing answers at all before
-  // the worker exists). Say so, with the way on, rather than the reason.
-  if (status === 503 || status === 404) {
-    $('fatal').textContent = 'Not signed in on this browser. Sign in ';
-    const a = document.createElement('a');
-    a.href = '/';
-    a.textContent = 'here';
-    $('fatal').appendChild(a);
-    $('fatal').appendChild(document.createTextNode('.'));
-    return;
-  }
-  if (status !== 200 || !json) {
-    $('fatal').textContent = json?.error || `could not read the record (HTTP ${status})`;
-    return;
-  }
-  config = json;
-  render();
-  if (new URLSearchParams(location.search).has('new')) openNewActor();
-}
-
-// Every disclosure on the page — a form, the log, a lifecycle confirmation —
-// is a panel declared inside the floating window and shown by window.js. It
-// used to be an accordion at the foot of the page, which pushed whatever you
-// were reading out from under you and could only ever show one thing.
-//
-// The reset lives here rather than in window.js: the window knows how to show a
-// panel, not what any of them mean.
-function resetConfirm() {
-  pending = null;
-  for (const k of Object.keys(LIFECYCLE)) $(`warn-${k}`)?.hidden !== undefined && ($(`warn-${k}`).hidden = true);
-  $('confirm-handle').value = '';
-  $('confirm-handle-move').value = '';
-  $('confirm-handle-close').value = '';
-  $('move-target').value = '';
-}
-function closePanels(keep = null) {
-  if (!keep) solWindow.close();
-  if (keep !== 'output') outputSource = null;
-  if (keep !== 'confirm-form') resetConfirm();
-}
-// Closing it by the ✕ or by Escape has to clear the same state a Cancel does.
-document.getElementById('win').addEventListener('win:closed', () => {
-  outputSource = null;
-  resetConfirm();
-  $('bsky-password').value = '';        // never leave a secret in a closed panel
-});
-
-
-// One row per identity connected elsewhere, indented under the row that adds
-// them. Each carries its own way out: disconnecting one has nothing to do with
-// the others.
-function identityRows() {
-  const out = [];
-  const row = (label, ...nodes) => {
-    const dt = document.createElement('dt');
-    dt.className = 'under';
-    dt.textContent = label;
-    const dd = document.createElement('dd');
-    dd.append(...nodes);
-    out.push([dt, dd]);
-  };
-  // One descriptor shape for every connected account — Bluesky and each
-  // fediverse account — so the row and its Options menu build the same way.
-  const accounts = [];
-  if (config.atproto?.connected) accounts.push({
-    label: 'Bluesky', handle: `@${config.atproto.handle}`,
-    href: `https://bsky.app/profile/${config.atproto.handle}`,
-    storage: config.atproto.storage || null,
-    feedPaused: 'feedPaused' in config.atproto ? config.atproto.feedPaused : null,
-    crossPost: 'crossPost' in config.atproto ? config.atproto.crossPost : null,
-    feed: (paused) => ['/atproto', { feedPaused: paused }],
-    cross: (on) => ['/atproto', { crossPost: on }],
-    store: (w) => ['/atproto', { storage: w }],
-    off: () => ['/atproto/disconnect', {}],
-  });
-  for (const acct of config.fediAccounts || []) accounts.push({
-    label: acct.host,
-    handle: acct.needsReconnect ? `${acct.handle} — sign in again` : acct.handle,
-    warn: acct.needsReconnect,
-    storage: acct.storage || null,
-    feedPaused: !acct.enabled,
-    crossPost: null,
-    feed: (paused) => ['/fediacct', { id: acct.id, enabled: !paused }],
-    store: (w) => ['/fediacct', { id: acct.id, storage: w }],
-    off: () => ['/fediacct/disconnect', { id: acct.id }],
-  });
-  for (const acct of accounts) {
-    const name = document.createElement(acct.href ? 'a' : 'span');
-    name.textContent = acct.handle;
-    if (acct.href) { name.href = acct.href; name.target = '_blank'; name.rel = 'noopener'; name.title = '   Open this account elsewhere in a new tab'; }
-    if (acct.warn) name.className = 'warn';
-    // Where storage is a real choice (every browser-build account today), two
-    // dropdowns sit in the row itself. Where it isn't (the Node agent's
-    // Bluesky, which shows a cross-post toggle instead), the Options
-    // disclosure it always has is unchanged.
-    row(acct.label, name, ' ', ...(acct.storage ? connectionControls(acct) : [optionsMenu(acct)]));
-  }
-  return out;
-}
-
-// Connected, Paused or Disconnected, and where the key lives — one dropdown
-// each, in the row. Replaces the separate feed and connect dropdowns that used
-// to sit behind an Options disclosure; only reached where acct.storage is set.
-function connectionControls(acct) {
-  const send = async ([path, payload], msg) => { if (await write(path, payload, msg)) await load(); };
-  const pick = (opts, current, onChange, title) => {
-    const el = document.createElement('select');
-    if (title) el.title = title;
-    for (const [v, t] of opts) { const o = document.createElement('option'); o.value = v; o.textContent = t; o.selected = v === current; el.appendChild(o); }
-    el.addEventListener('change', () => onChange(el.value));
-    return el;
-  };
-  const conn = pick(
-    [['connected', 'Connected'], ['paused', 'Paused'], ['disconnected', 'Disconnected']],
-    acct.feedPaused ? 'paused' : 'connected',
-    (v) => (v === 'disconnected'
-      ? send(acct.off(), 'disconnected')
-      : send(acct.feed(v === 'paused'), v === 'paused' ? 'paused adding to your feed' : 'added to your home feed')),
-    '   Connected feeds this account into your home feed here; Paused keeps the account but stops adding its posts; Disconnected removes it.');
-  const storage = pick(
-    [['pod', 'Store key on Pod'], ['browser', 'Store key in Browser']],
-    acct.storage,
-    (v) => {
-      if (v === 'pod' && !confirm('Store this account on your pod?\n\nIt will follow you to any browser you sign in from — but a full-access token to that account then lives on your pod.')) { load(); return; }
-      send(acct.store(v), v === 'pod' ? 'stored on your pod' : 'stored in this browser');
-    },
-    '   On your pod the key follows you to any browser you sign in from, and a full-access token then lives there; in this browser the token never leaves this device.');
-  const wrap = document.createElement('span');
-  wrap.className = 'conn-controls';
-  wrap.append(conn, ' ', storage);
-  return [wrap];
-}
-
-// Every connected account without a storage choice carries an Options menu
-// instead: pause its feed, its cross-post toggle (the Node agent's Bluesky),
-// disconnect.
-function optionsMenu(acct) {
-  const d = document.createElement('details');
-  d.className = 'opts';
-  const sum = document.createElement('summary');
-  sum.textContent = 'Options';
-  d.appendChild(sum);
-  const body = document.createElement('div');
-  d.appendChild(body);
-
-  // Each control is one dropdown whose options ARE the states, so it needs no
-  // separate label — the chosen option reads as the current state.
-  const pick = (opts, current, onChange) => {
-    const el = document.createElement('select');
-    for (const [v, t] of opts) { const o = document.createElement('option'); o.value = v; o.textContent = t; o.selected = v === current; el.appendChild(o); }
-    el.addEventListener('change', () => onChange(el.value));
-    body.appendChild(el);
-  };
-  const send = async ([path, payload], msg) => { if (await write(path, payload, msg)) await load(); };
-
-  // Feed: shown in / hidden from the feed you read here.
-  if (acct.feedPaused !== null) {
-    pick([['show', 'Add to home feed'], ['hide', 'Pause adding to home feed']], acct.feedPaused ? 'hide' : 'show',
-      (v) => send(acct.feed(v === 'hide'), v === 'hide' ? 'paused adding to your feed' : 'added to your home feed'));
-  }
-  // Storage where the browser offers the choice; the Node agent's Bluesky shows
-  // its cross-post toggle in the same slot instead.
-  if (acct.storage) {
-    pick([['browser', 'Store key in Browser'], ['pod', 'Store key on Pod']], acct.storage, (v) => {
-      if (v === 'pod' && !confirm('Store this account on your pod?\n\nIt will follow you to any browser you sign in from — but a full-access token to that account then lives on your pod.')) { load(); return; }
-      send(acct.store(v), v === 'pod' ? 'stored on your pod' : 'stored in this browser');
-    });
-  } else if (acct.crossPost !== null) {
-    pick([['on', 'Cross-post On'], ['off', 'Cross-post Off']], acct.crossPost ? 'on' : 'off',
-      (v) => send(acct.cross(v === 'on'), ''));
-  }
-  // Connection: staying connected, or disconnecting.
-  pick([['connected', 'Connected'], ['disconnect', 'Disconnect']], 'connected',
-    (v) => { if (v === 'disconnect') send(acct.off(), 'disconnected'); else load(); });
-
-  // The storage consequence, at the bottom of the box under every dropdown.
-  if (acct.storage) {
-    const hint = document.createElement('p'); hint.className = 'opt-hint';
-    hint.textContent = acct.storage === 'pod'
-      ? 'Follows you to every browser you sign in from; a full-access token lives on your pod.'
-      : 'Stays in this browser; the token never leaves this device.';
-    body.appendChild(hint);
-  }
-  return d;
-}
-
-function render() {
-  // The bar names the actor, the same way on every page. Only the tab title is
-  // this page's own business.
-  document.title = `FediPod — ${config.handle}`;
-  const facts = $('facts');
-  facts.textContent = '';
-  // What this actor IS comes first. The handle is already in the address beside
-  // the heading; the pod, the issuer and the actor URL all read off the WebID;
-  // and where the private half sits is not something you act on from here.
-  const origins = config.origins || {};
-  // Two of these are addresses of things you can open, so they are links. The
-  // fediverse one goes to this actor's own page in the client, same origin, so
-  // it stays in the tab. The Solid one leaves for the pod, so it does not.
-  const rows = [
-    ['kind', config.kind ? config.kind[0].toUpperCase() + config.kind.slice(1) : config.kind],
-    // The value is the select itself — what it shows IS the state, and
-    // changing the word is the whole action, like the moderation controls.
-    ['status', 'ctl'],
-    ['Fediverse identity', config.address || `@${config.handle} — no resolvable address`,
-      config.accountId && config.address ? { href: `/admin/client/#/a/${config.accountId}` } : null],
-    ['Solid identity', config.webId, config.remotePod ? { href: config.remotePod, blank: true } : null],
-    // Where on the pod the account's data lives: the container its owner chose.
-    ['stored at', config.remotePod && config.root ? config.remotePod + config.root : null,
-      config.remotePod && config.root ? { href: config.remotePod + config.root, blank: true } : null],
-    ['Other identities', 'ctl'],
-    ['local store', config.home],
-    // The address you actually open, not the bare number — the named origin when
-    // there is one, since that is what the client and the OAuth redirect use. An
-    // agent with no local host of its own (embedded in a pod server, or in a
-    // browser) sends none, and then there is no row rather than a bare number.
-    ['local host', (origins.named || origins.loopback || '').replace(/\/$/, '') || null],
-  ];
-  if (config.version || config.update || config.pendingUpgrade?.length) rows.push(['software', 'ctl']);
-  rows.push(['gateway', 'ctl']);
-  if (config.quiescedAt) rows.push(['parked since', config.quiescedAt]);
-  if (config.movedTo) rows.push(['moved to', config.movedTo]);
-  // A person gates followers here; a group's gate is the joins control on its
-  // kind row, so the row would be a second switch for the same thing.
-  if (config.kind !== 'group') rows.splice(2, 0, ['new followers', 'ctl']);
-  // Rows that belong under the one being written, appended after it.
-  let kids = null;
-  for (const [k, v, link] of rows) {
-    if (!v) continue;
-    const dt = document.createElement('dt');
-    dt.textContent = k;
-    const dd = document.createElement('dd');
-    if (link) {
-      const a = document.createElement('a');
-      a.href = link.href;
-      a.textContent = v;
-      if (link.blank) {
-        a.target = '_blank';
-        // noopener because the pod is another origin: without it the page we
-        // open gets a handle on this one through window.opener.
-        a.rel = 'noopener';
-        a.title = `   Open ${link.href} in a new tab`;
-      } else {
-        a.title = `   This actor's page in our client`;
-      }
-      dd.appendChild(a);
-    } else {
-      dd.textContent = v;
-    }
-    // What a group can be moderated into is a property of BEING a group, so the
-    // controls sit on the row that says so. Moved rather than built here: the
-    // page still declares them, and `facts` is emptied on every render.
-    if (k === 'kind' && config.kind === 'group') dd.append(MODERATION);
-    if (k === 'status') {
-      dd.textContent = '';
-      dd.append(STATUS);
-      STATUS.hidden = false;
-      renderStatus();
-    }
-    if (k === 'new followers') {
-      dd.textContent = '';
-      dd.append(FOLLOWS_CTL);
-      FOLLOWS_CTL.hidden = false;
-      FOLLOWS_PICK.value = config.autoAcceptFollows ? 'auto' : 'approve';
-    }
-    if (k === 'gateway') {
-      dd.textContent = '';
-      dd.append(GATEWAY_CTL);
-      refreshGateway();
-    }
-    if (k === 'software') {
-      dd.textContent = '';
-      dd.append(UPDATE_CTL);
-      UPDATE_CTL.hidden = false;
-      const u = config.update;
-      // The version this agent is running, never the one sitting in the
-      // checkout — saying otherwise would name a version nobody is serving.
-      const running = config.version || u?.current || null;
-      const words = [];
-      if (running) words.push(u?.available ? `FediPod ${running} — ${u.latest} available` : `FediPod ${running}`);
-      if (config.versionOnDisk && running && config.versionOnDisk !== running)
-        words.push(`${config.versionOnDisk} is on disk — restart to run it`);
-      if (config.pendingUpgrade?.length) words.push('older data layout — run `fedipod upgrade` in a terminal');
-      UPDATE_WORD.textContent = words.join('; ');
-      UPDATE_GO.hidden = !u?.available;
-    }
-    // The way to add one. Each account already connected is a row of its own
-    // underneath, so this row stays the action and never becomes a list.
-    if (k === 'Other identities') {
-      dd.textContent = '';
-      dd.append(IDENT_CTL);
-      IDENT_CTL.hidden = false;
-      kids = identityRows();
-    }
-    facts.append(dt, dd);
-    if (kids) {
-      for (const [ckt, ckd] of kids) facts.append(ckt, ckd);
-      kids = null;
-    }
-  }
-  if (!config.address) {
-    const p = document.createElement('p');
-    p.className = 'warn';
-    p.textContent = `${config.remotePod} is a suffixed pod, so this actor cannot be `
-      + 'discovered as a handle by other servers. Posting and reading still work.';
-    $('pane-identity').appendChild(p);
-  }
-
-  // pane-others carries the create control too, so it appears even when this is
-  // the only actor and even if /profiles cannot be read.
-  for (const id of ['pane-others', 'pane-identity', 'rail']) $(id).hidden = false;
-  renderAliases();
-  renderOthers();
-  renderInbox();
-  if (config.kind === 'group') {
-    // Its lists have no bound, so this page scrolls — see body.group in the CSS.
-    document.body.classList.add('group');
-    $('pane-group').hidden = false;
-    MODERATION.hidden = false;           // only a group has any
-    renderGroupToggles();
-    refreshGroup();
-  } else {
-    // A person has a follow-request queue too now: nothing binds an inbound
-    // Follow to the actor it names, so one that cannot be verified waits here
-    // rather than being accepted on the strength of who it claims to be.
-    refreshRequests();
-  }
-}
-