six-degrees 0.6.0 → 0.8.0

package/.next/standalone/lib/galaxy-lab.js

@@ -9,6 +9,9 @@
 
 import { keyFor, score } from './separation.js';
 import { warmthOf } from './linkedin-export.js';
+import { LAYOUT_KEYS, cleanLayouts } from './galaxy-layouts.js';
+import { saveSettings } from './settings-client.js';
+import { reconcileSaved } from './synced-setting.js';
 
 const KEY = 'six-degrees-galaxy-lab';
 const LAYOUTS_KEY = 'six-degrees-galaxy-layouts';
@@ -34,9 +37,6 @@ export const LAB_DEFAULTS = Object.freeze({
   v: 2,             // which defaults a saved setting was made under (2: the branch starts off)
 });
 
-/** The slider settings a saved layout keeps (not whether the lab is on, nor the names switch). */
-const LAYOUT_KEYS = ['gravity', 'rings', 'push', 'pull', 'distance', 'orbit', 'dotSize', 'lines', 'sizeBy', 'names', 'branch', 'colourBy', 'speed', 'loop'];
-
 /** The forces a layout sets, and the ones the Galaxy re-settles for when they change. */
 export const FORCE_KEYS = ['gravity', 'rings', 'push', 'pull', 'distance'];
 
@@ -105,7 +105,10 @@ export function watchLab(f) {
 /** What the Galaxy should use: the sliders while the lab is on, today's layout otherwise (with the names switch). */
 export const effectiveLab = (lab) => (lab.on ? lab : lab.labels === LAB_DEFAULTS.labels ? LAB_DEFAULTS : { ...LAB_DEFAULTS, labels: lab.labels });
 
-// Saved layouts: your own named slider settings, in this browser.
+// Saved layouts: your own named slider settings (lib/galaxy-layouts.js), saved
+// with the network's settings so they travel with a backup or a restore, and
+// copied in this browser to show before the server has answered
+// (lib/synced-setting.js, app/components/ThemeLoader.js).
 let layoutsCache = null;
 const layoutListeners = new Set();
 export function layoutsNow() {
@@ -115,10 +118,21 @@ export function layoutsNow() {
   }
   return layoutsCache;
 }
-function writeLayouts(list) {
+function writeLayouts(list, { save = true } = {}) {
   layoutsCache = list;
   try { localStorage.setItem(LAYOUTS_KEY, JSON.stringify(list)); } catch {}
   layoutListeners.forEach((f) => f());
+  if (save) saveSettings({ galaxyLayouts: list });
+}
+/** The layouts saved with the network (GET /api/settings 'galaxyLayouts'), once the page has them. */
+export function adoptSavedLayouts(saved) {
+  const cached = cleanLayouts(layoutsNow());
+  const { use, save, changed } = reconcileSaved({
+    saved: saved == null ? null : cleanLayouts(saved), cached,
+    isDefault: (list) => list.length === 0, same: (a, b) => JSON.stringify(a) === JSON.stringify(b),
+  });
+  if (save) saveSettings({ galaxyLayouts: cached });
+  if (changed) writeLayouts(use, { save: false });
 }
 export function watchLayouts(f) { layoutListeners.add(f); return () => layoutListeners.delete(f); }
 export function saveLayout(name) {

package/.next/standalone/lib/galaxy-layouts.js

@@ -0,0 +1,43 @@
+// The Galaxy's saved layouts (Physics → Save layout): your own named slider
+// settings. Kept with the network's settings (lib/settings.js), so they travel
+// with a backup, an export and a restore; the browser keeps a copy to read
+// before the page has asked the server (lib/galaxy-lab.js). No imports: the
+// server checks a saved list with the same rules the browser keeps it by.
+
+/** The slider settings a saved layout keeps (not whether the lab is on, nor the names switch). */
+export const LAYOUT_KEYS = ['gravity', 'rings', 'push', 'pull', 'distance', 'orbit', 'dotSize', 'lines', 'sizeBy', 'names', 'branch', 'colourBy', 'speed', 'loop'];
+
+/** More than anyone names by hand, and a bound on what a stray request can store. */
+export const MAX_LAYOUTS = 50;
+
+const fine = (v) => (typeof v === 'boolean')
+  || (typeof v === 'number' && Number.isFinite(v) && Math.abs(v) <= 1000)
+  || (typeof v === 'string' && /^[a-z]{1,20}$/i.test(v));
+
+/**
+ * A saved list made safe: each layout a name (1 to 40 characters) and only the
+ * slider settings a layout keeps, each a plain number, word or switch. A name
+ * saved twice keeps its last settings, where the first one stood.
+ */
+export function cleanLayouts(raw) {
+  if (!Array.isArray(raw)) return [];
+  const byName = new Map();
+  for (const item of raw) {
+    const name = typeof item?.name === 'string' ? item.name.trim().slice(0, 40) : '';
+    if (!name || !item.settings || typeof item.settings !== 'object' || Array.isArray(item.settings)) continue;
+    const settings = {};
+    for (const k of LAYOUT_KEYS) if (Object.hasOwn(item.settings, k) && fine(item.settings[k])) settings[k] = item.settings[k];
+    byName.set(name, { name, settings });
+  }
+  return [...byName.values()].slice(0, MAX_LAYOUTS);
+}
+
+/** In lib/settings.js: null until a list is saved on this network, so a browser's own list is saved once. */
+export const GALAXY_LAYOUTS_SETTING = {
+  default: null,
+  parse(value) {
+    if (value === null) return null;
+    if (!Array.isArray(value)) throw new Error('Saved layouts must be a list.');
+    return cleanLayouts(value);
+  },
+};

package/.next/standalone/lib/gate.js

@@ -8,10 +8,13 @@
 // /api/update changes the code that will run next, both of which are more power
 // than any of the others, so they sit behind the same gate.
 //
-// The four under /api/data are Settings → Your data: export hands over the
-// whole network in one file, import replaces it, restart stops the server, and
-// reveal starts a process. Reading /api/data itself (sizes, the folder's path)
-// changes nothing and stays open, like every other read.
+// The six under /api/data are Settings → Your data: export hands over the
+// whole network in one file, import replaces it, restart stops the server,
+// reveal starts a process, backup writes the whole network to a file, and
+// restore replaces it with a backup. Reading /api/data itself (sizes, the
+// folder's path, the backups) changes nothing and stays open, like every other read.
+// /api/data/csv keeps, replaces, hands over and removes a CSV import kept in
+// the data folder.
 export const DESTRUCTIVE_ROUTES = [
   '/api/admin-delete',
   '/api/admin-update',
@@ -23,6 +26,9 @@ export const DESTRUCTIVE_ROUTES = [
   '/api/data/import',
   '/api/data/restart',
   '/api/data/reveal',
+  '/api/data/backup',
+  '/api/data/restore',
+  '/api/data/csv',
 ];
 
 const LOOPBACK = new Set(['127.0.0.1', '::1', 'localhost']);

package/.next/standalone/lib/in-progress.js

@@ -0,0 +1,46 @@
+// What the app says about a circle scan that stopped partway. Blake,
+// 2026-10-03: "if someone was scanned but not finished it needs to show that in
+// their profile card if clicked showing resume scanner in that actual card as we
+// need to have some sort of in progress ones in the scanner as well to see all
+// the ones they stopped and would like to resume".
+//
+// The person card (app/components/Sidebar.js) and the Scan page's In progress
+// card (app/components/LinkedInLimits.js PausedList) both word it from here, so
+// the two never say it differently. Who is stopped partway, and where Resume
+// carries on, is lib/paused.js's to decide; this only says it. No Node imports:
+// the browser loads it.
+
+/** The scan box's heading on a person card: a read that stopped partway says so first. */
+export function scanBoxTitle({ resume, hasCluster }) {
+  if (resume) return 'SCAN IN PROGRESS';
+  return hasCluster ? 'CLUSTER ACTIVE' : 'CREATE CLUSTER';
+}
+
+/**
+ * The line by their name on the card, from GET /api/scraper?resume=<id>
+ * ({ nextPage, pagesRead, legacy }). null when there is nothing to carry on with.
+ */
+export function stoppedLine(resume) {
+  if (!resume) return null;
+  const read = Number(resume.pagesRead) || 0;
+  return read > 0 ? `Scan stopped after page ${read}` : 'Scan stopped before its first page';
+}
+
+/**
+ * The In progress card's line on the Scan page, from the status answer's
+ * `paused` (lib/paused.js pausedList). null when nobody is. People mapped
+ * before 0.1.6 kept notes (`legacy`) were read to page 10 and no further, which
+ * is why they're here at all, so it says so.
+ */
+export function inProgressSummary(paused = []) {
+  const list = Array.isArray(paused) ? paused : [];
+  const n = list.length;
+  if (!n) return null;
+  const legacy = list.filter((p) => p?.legacy).length;
+  const line = n === 1
+    ? '1 person stopped partway. Resume carries on from the page they stopped at.'
+    : `${n} people stopped partway. Resume carries on from the page each one stopped at.`;
+  if (!legacy) return line;
+  const old = n === 1 ? 'Their list was' : legacy === 1 ? '1 of them was' : `${legacy} of them were`;
+  return `${line} ${old} read to page 10, before whole lists were read.`;
+}

package/.next/standalone/lib/ingest.js

@@ -89,7 +89,7 @@ export function refreshNotifications({ added = [], checked = 0, tierOf = () => n
   if (!added.length) {
     return [{
       user_id, type: 'refresh_summary', title: 'Network up to date',
-      message: `Checked ${checked} connections — no new additions`, icon: '✓',
+      message: `Checked ${checked} connections: no new additions`, icon: '✓',
     }];
   }
   const out = [{