@banou/ripple 0.0.14 → 0.0.16

package/README.md

@@ -136,6 +136,77 @@ instead.
 | `npx vp lint` | oxlint, type aware | ~1s |
 | `npm run test:download` | the download page against a real torrent, end to end | ~30s |
 | `npm run test:e2e` | the engine against real swarms | minutes, headful |
+| `npm run test:e2e:rig` | the whole chain against a local swarm, see below | ~90s, headful under Xvfb |
 
 The playwright suites run headful on purpose: headless Chromium stalls the engine at a flat 0 B/s in
 every topology, which makes anything torrent-shaped unmeasurable rather than merely slow.
+
+### The swarm rig
+
+`e2e:rig` downloads a torrent that exists only on this machine. The seeders are transmission daemons
+on `127.0.0.2` and up, the relay is a local webvpn build, and the broker is a local fkn-client web
+build, so the only source of a byte is the fleet the magnet names. The public swarm cannot give that:
+byte-identical code measured 14.7 s to 73.4 s to first frame there.
+
+| piece | where | port |
+| --- | --- | --- |
+| broker (fkn-client `web`, development build) | `http://localhost:5234/api` | 5234 |
+| relay (webvpn release build) | WebTransport, HTTP, WebSocket on `127.0.0.1` | 5433, 5434, 5443 |
+| ripple (`build/`, served) | `http://localhost:5460` | 5460 |
+| seeders (transmission 4) | `127.0.0.2:52600` and up, rpc `9400` and up | |
+
+None of it overlaps fkn/local's rig (1234, 3000, 4433, 4560, 8443), so the two run side by side. The
+ports live in `tests/swarm-rig/topology.json`.
+
+It needs three checkouts, and an fkn-client worktree of its own, because the rig rewrites that
+checkout's `.env.local` files and build output:
+
+```sh
+git -C ~/dev/horionsoftware/fkn-client worktree add --detach ~/dev/fkn-client-rig origin/main
+(cd ~/dev/horionsoftware/webvpn && cargo build --release)
+
+export RIPPLE_RIG_FKN_CLIENT=~/dev/fkn-client-rig
+export RIPPLE_RIG_WEBVPN=~/dev/horionsoftware/webvpn
+export RIPPLE_RIG_LOCAL=~/dev/horionsoftware/local
+export RIPPLE_CHROME=$(command -v google-chrome-stable)
+export RIG_TRANSMISSION=$(nix build --no-link --print-out-paths 'nixpkgs#transmission_4')
+
+nix shell nixpkgs#xvfb-run -c env -u WAYLAND_DISPLAY -u NIXOS_OZONE_WL \
+  xvfb-run -a -s "-screen 0 1280x720x24" npm run test:e2e:rig
+```
+
+`test:e2e:rig` runs three steps:
+
+1. `scripts/rig-prepare.mjs` builds `@fkn/lib` with `VITE_WEB_ORIGIN=http://localhost:5234` and the
+   web app as the broker, then checks what each build baked in. It refuses a main worktree.
+2. `npm run build`, which sees `RIPPLE_RIG_FKN_CLIENT` and resolves `@fkn/lib` to that local build
+   (the published lib has `https://fkn.app` baked in, and no setting of ripple's can move it). The
+   build warns when it does this. Afterwards `build/` points at the rig's broker, so rebuild without
+   the variable before serving it for anything else.
+3. `playwright.rig.config.ts` starts the relay (the environment `byo.sh webvpn --export` prints, moved
+   to the rig's ports, with a fresh certificate and `FREE_RATE_BYTES_PER_SEC` at 1 GiB/s), the broker
+   and ripple, then runs `tests/swarm-rig.spec.ts`.
+
+The spec has three tests, run in order:
+
+- **Configuration.** The relay answers. The RUNNING relay's environment allows private targets and
+  carries the raised rate. `/api` serves the broker's own document, not the SPA fallback.
+- **The swarm arm.** It makes a 60 s 720p fixture with ffmpeg (no private flag, which would stop
+  seeders serving metadata to a magnet). It starts N seeders with staggered adds and opens `/watch`
+  for the magnet in a fresh regular profile. It then asserts that the engine held the whole file,
+  that OPFS holds it piece for piece and by SHA-256, that a frame was painted, and that the seeders
+  uploaded at least the file. It prints time to first byte, first frame and completion from the add.
+- **The control.** The same fleet comes up and goes down, and the same visit runs for 30 s. It must
+  see 0 bytes in the engine and in OPFS, and the swarm arm's own assertion must FAIL on it.
+
+The seeders run under a shell that kills them when the test process is gone, so a run killed
+outright leaves nothing on their addresses. Without that shell, all four outlived a SIGKILL.
+
+Knobs: `RIPPLE_RIG_SEEDERS` (default 4), `RIPPLE_RIG_BUDGET_MS` (swarm arm, 120000),
+`RIPPLE_RIG_CONTROL_MS` (30000), `RIPPLE_RIG_STATE` (fixture and seeder state, default
+`$TMPDIR/ripple-swarm-rig`). The config refuses to start when `WAYLAND_DISPLAY` or `NIXOS_OZONE_WL`
+is set, because the Nix Chrome wrapper then opens a real window even under `xvfb-run`.
+
+The engine's DHT is on, and it announces the infohash through the relay. So the control can see a
+stray peer (1 peer in two of three runs, 0 bytes each time). This is why the seeders' own upload
+count is part of the claim.

package/api-DIgTslNb-BSzu7eku.js

@@ -0,0 +1,374 @@
+import { a as e } from "./build-JdIfVZn7.js";
+//#region node_modules/@fkn/lib/api-DIgTslNb.js
+var t = 1e4, n = 16, r = (e) => {
+	let t;
+	try {
+		t = e.contentWindow;
+	} catch {
+		return !0;
+	}
+	if (!t) return !0;
+	try {
+		let e = t.location.href;
+		return e !== "" && e !== "about:blank";
+	} catch {
+		return !0;
+	}
+}, i = (e, i = t) => new Promise((t) => {
+	if (r(e)) return t();
+	let a = () => {
+		clearInterval(o), clearTimeout(s), e.removeEventListener("load", a), t();
+	}, o = setInterval(() => {
+		r(e) && a();
+	}, n), s = setTimeout(a, i);
+	e.addEventListener("load", a);
+}), a = 32, o = 8, s = 120, c = typeof CSS < "u" && CSS.supports("clip-path", "path('M0 0H1V1H0Z')"), l = typeof CSS < "u" && CSS.supports("clip-path", "polygon(nonzero, 0px 0px, 1px 0px, 1px 1px)"), u = (e) => {
+	let t = e.style;
+	t.setProperty("display", "block", "important"), t.setProperty("position", "fixed", "important"), t.setProperty("top", "0", "important"), t.setProperty("left", "0", "important"), t.setProperty("width", "100%", "important"), t.setProperty("height", "100%", "important"), t.setProperty("border", "none", "important"), t.setProperty("padding", "0", "important"), t.setProperty("box-sizing", "border-box", "important"), t.setProperty("clip-path", "inset(100%)", "important"), t.setProperty("background", "transparent"), t.setProperty("color-scheme", "normal"), t.setProperty("z-index", "2147483647"), e.setAttribute("title", "FKN");
+}, d = ({ x: e, y: t, width: n, height: r, radius: i }) => {
+	if (!i) return `M${e} ${t}h${n}v${r}h${-n}Z`;
+	let a = Math.min(n, r) / 2, [o, s, c, l] = i.map((e) => Math.max(0, Math.min(e, a)));
+	return `M${e + o} ${t}h${n - o - s}a${s} ${s} 0 0 1 ${s} ${s}v${r - s - c}a${c} ${c} 0 0 1 ${-c} ${c}h${-(n - c - l)}a${l} ${l} 0 0 1 ${-l} ${-l}v${-(r - l - o)}a${o} ${o} 0 0 1 ${o} ${-o}Z`;
+}, f = () => c && l, p = ({ x: e, y: t, width: n, height: r }) => [
+	[e, t],
+	[e + n, t],
+	[e + n, t + r],
+	[e, t + r],
+	[e, t]
+], m = (e) => {
+	let t = e[0];
+	if (!t) return [];
+	let n = p(t)[0], r = [];
+	return e.forEach((t, i) => {
+		r.push(...p(t)), i > 0 && i < e.length - 1 && r.push(n);
+	}), r;
+}, h = (e) => `polygon(nonzero, ${m(e).map(([e, t]) => `${e}px ${t}px`).join(", ")})`, g = ({ x: e, y: t, width: n, height: r, radius: i }, a) => {
+	let o = `${t}px ${a.width - e - n}px ${a.height - t - r}px ${e}px`;
+	return i ? `inset(${o} round ${i.map((e) => `${e}px`).join(" ")})` : `inset(${o})`;
+}, ee = (e, t, n) => {
+	if (t) return "none";
+	if (e.length === 0) return "inset(100%)";
+	let r = e.length === 1 ? e[0] : void 0;
+	return r ? g(r, n) : l && e.length <= 5 && !e.some((e) => e.radius) ? h(e) : `path('${e.map(d).join("")}')`;
+}, te = (e) => {
+	if (e.length < 2) return null;
+	let t = Math.min(...e.map((e) => e.x)), n = Math.min(...e.map((e) => e.y));
+	return {
+		x: t,
+		y: n,
+		width: Math.max(...e.map((e) => e.x + e.width)) - t,
+		height: Math.max(...e.map((e) => e.y + e.height)) - n
+	};
+}, ne = (e, t, n) => t >= e.x && t < e.x + e.width && n >= e.y && n < e.y + e.height, re = 16, _ = (e, t, n) => t === 1 ? e * re : t === 2 ? e * n : e, ie = (e, t, n) => {
+	let r = getComputedStyle(e);
+	return n !== 0 && /auto|scroll/.test(r.overflowY) && e.scrollHeight > e.clientHeight ? !0 : t !== 0 && /auto|scroll/.test(r.overflowX) && e.scrollWidth > e.clientWidth;
+}, v = (e, t, n) => {
+	for (let r = e; r; r = r.parentElement) if (ie(r, t, n)) return r;
+	return document.scrollingElement;
+}, y = null, b = null, x = (e) => ({
+	width: e.offsetWidth || window.innerWidth,
+	height: e.offsetHeight || window.innerHeight
+}), S = (e) => {
+	if (!b || !y || !ne(b, e.clientX, e.clientY)) return;
+	let t = document.elementFromPoint(e.clientX, e.clientY);
+	if (!t || t === y) return;
+	let n = _(e.deltaX, e.deltaMode, window.innerWidth), r = _(e.deltaY, e.deltaMode, window.innerHeight), i = v(t, n, r);
+	i && (i.scrollBy({
+		left: n,
+		top: r,
+		behavior: "instant"
+	}), e.cancelable && e.preventDefault());
+}, ae = (e) => {
+	let t = b !== null;
+	b = e, t !== (e !== null) && (e ? window.addEventListener("wheel", S, {
+		capture: !0,
+		passive: !1
+	}) : window.removeEventListener("wheel", S, { capture: !0 }));
+}, C = 0, w = (e) => {
+	if (e === C) return;
+	C = e;
+	let t = document.documentElement.style;
+	e > 0 ? (t.setProperty("margin-top", `${e}px`, "important"), t.setProperty("--fkn-inset-top", `${e}px`)) : (t.removeProperty("margin-top"), t.removeProperty("--fkn-inset-top"));
+}, T = (e, { modal: t, rects: n, inset: r }, i) => {
+	if (w(r), !c) {
+		let r = t || n.length > 0;
+		e.style.setProperty("pointer-events", r ? "auto" : "none", "important"), e.style.setProperty("visibility", r ? "visible" : "hidden", "important");
+		return;
+	}
+	let a = ee(n, t, i), o = a === "none" || CSS.supports("clip-path", a) ? a : "inset(100%)";
+	e.style.setProperty("clip-path", o, "important"), ae(t || o !== a ? null : te(n));
+}, oe = (e) => {
+	if (typeof e != "object" || !e) return 0;
+	let { top: t } = e;
+	return typeof t != "number" || !Number.isFinite(t) || t <= 0 ? 0 : Math.min(Math.round(t), s);
+}, se = (e) => {
+	if (Array.isArray(e) && e.length === 4 && e.every((e) => typeof e == "number" && Number.isFinite(e) && e >= 0)) return e.some((e) => e > 0) ? e : void 0;
+}, ce = (e, t) => {
+	if (typeof e != "object" || !e) return null;
+	let { x: n, y: r, width: i, height: a } = e;
+	if (![
+		n,
+		r,
+		i,
+		a
+	].every((e) => typeof e == "number" && Number.isFinite(e))) return null;
+	let o = t.width, s = t.height, c = Math.max(0, Math.min(Math.round(n), o)), l = Math.max(0, Math.min(Math.round(r), s)), u = Math.max(c, Math.min(Math.round(n + i), o)), d = Math.max(l, Math.min(Math.round(r + a), s)), f = se(e.radius);
+	return {
+		x: c,
+		y: l,
+		width: u - c,
+		height: d - l,
+		...f ? { radius: f } : {}
+	};
+}, E = {
+	"not-rendered": "this page is not painting it at all, so it or an ancestor is display:none, or the frame was moved out of the layout",
+	clipped: "it is clipped away or positioned outside the viewport",
+	"not-shown": "it is rendered but would not be seen, so either something is drawn over it, or it or an ancestor has opacity below 1, visibility:hidden, or a filter"
+}, D = (e) => Array.isArray(e) ? e.slice(0, o).flatMap((e) => {
+	if (typeof e != "object" || !e) return [];
+	let { kind: t, cause: n, level: r } = e;
+	return typeof t != "string" || t.length > 40 || typeof n != "string" || !(n in E) || r !== "full" && r !== "liveness" ? [] : [{
+		kind: t,
+		cause: n,
+		level: r
+	}];
+}) : [], O = /* @__PURE__ */ new Set(), le = (e) => {
+	for (let { kind: t, cause: n, level: r } of e) O.has(t) || (O.add(t), console.error(`[FKN] The FKN ${JSON.stringify(t)} is not visible on this page: ${E[n]}. Nobody using this page can see or answer it.
+@fkn/lib draws its UI inside <iframe title="FKN"> and sets display, position, top, left, width, height, border, padding, box-sizing, clip-path and z-index on that element. Leave those as they are, then check for an ancestor with opacity, visibility, display or a clipping transform, and for an element stacked above it.` + (r === "liveness" ? "\nThis browser reports limited detail, so the cause above is a best guess." : "")));
+}, k = (e, t) => {
+	if (typeof e != "object" || !e) return null;
+	let n = e, r = (Array.isArray(n.rects) ? n.rects.slice(0, a) : []).map((e) => ce(e, t)).filter((e) => e !== null && e.width > 0 && e.height > 0);
+	return {
+		modal: n.modal === !0,
+		rects: r,
+		hidden: D(n.hidden),
+		inset: oe(n.inset)
+	};
+}, ue = () => y !== null, A = null, j = null, de = () => {
+	if (!y || A === null) return;
+	let e = x(y), t = k(A, e);
+	t && T(y, t, e);
+}, fe = (e) => {
+	typeof ResizeObserver < "u" && (j ??= new ResizeObserver(de), j.disconnect(), j.observe(e));
+}, pe = (e) => {
+	u(e), T(e, {
+		modal: !1,
+		rects: [],
+		hidden: [],
+		inset: 0
+	}, x(e)), y = e, fe(e);
+}, me = (e) => {
+	if (!y) return;
+	let t = x(y), n = k(e, t);
+	n && (A = e, T(y, n, t), le(n.hidden));
+}, he = [
+	"fkn.app",
+	"fkn.dev",
+	"sdbx.app"
+], ge = (e) => e.replace(/\.+$/, ""), _e = (e) => {
+	let t = ge(e);
+	return he.some((e) => t === e || t.endsWith(`.${e}`));
+}, M = (e) => {
+	let t = typeof e == "string" ? e : e instanceof URL ? e.href : e.url, n;
+	try {
+		n = new URL(t);
+	} catch {
+		return;
+	}
+	if (_e(n.hostname)) throw Error(`fetch refuses FKN platform domains (${n.hostname})`);
+}, N = /* @__PURE__ */ "autoplay.fullscreen.picture-in-picture.encrypted-media.screen-wake-lock.speaker-selection.captured-surface-control.camera.microphone.display-capture.geolocation.midi.usb.serial.hid.bluetooth.gamepad.keyboard-map.xr-spatial-tracking.accelerometer.gyroscope.magnetometer.ambient-light-sensor.compute-pressure.clipboard-read.clipboard-write.storage-access.window-management.local-fonts.idle-detection.web-share.sync-xhr.unload.payment.publickey-credentials-get.publickey-credentials-create.otp-credentials.identity-credentials-get.digital-credentials-get.local-network.local-network-access.loopback-network".split("."), P = () => {
+	try {
+		let e = globalThis.document?.featurePolicy?.features?.();
+		return e === void 0 ? void 0 : new Set(e);
+	} catch {
+		return;
+	}
+}, F = (e = !0, t = P()) => [...N, ...e ? ["cross-origin-isolated"] : []].filter((e) => t === void 0 || t.has(e)).join("; "), I = "https://fkn.app", L = typeof globalThis < "u" && globalThis.document ? globalThis.document : void 0, R = typeof globalThis < "u" && globalThis.crossOriginIsolated === !0, z = `${I}/api${R ? "?coi=1" : ""}`, ve = "fkn-api-port", ye = "fkn-api-port-ack", be = 2e3, xe = () => {
+	if (!L || typeof window > "u" || window.parent === window) return Promise.resolve(void 0);
+	let e;
+	try {
+		e = window.parent;
+	} catch {
+		return Promise.resolve(void 0);
+	}
+	let t = new MessageChannel();
+	return new Promise((n) => {
+		let r = (e) => {
+			if (clearTimeout(a), t.port1.removeEventListener("message", i), !e) try {
+				t.port1.close();
+			} catch {}
+			n(e);
+		}, i = (e) => {
+			e.data?.type === ye && r(t.port1);
+		}, a = setTimeout(() => r(void 0), be);
+		t.port1.addEventListener("message", i), t.port1.start();
+		try {
+			e.postMessage({ type: ve }, I, [t.port2]);
+		} catch {
+			r(void 0);
+		}
+	});
+}, B, Se = () => {
+	if (B || !L) return B;
+	let e = L.querySelector(`iframe[src="${z}"]`);
+	if (e) B = e;
+	else {
+		let e = L.createElement("iframe");
+		e.setAttribute("allow", F(R)), e.src = z, L.body.appendChild(e), B = e;
+	}
+	return pe(B), B;
+}, V = (async () => {
+	if (!L) return;
+	let e = await xe();
+	if (e) return {
+		receive: e,
+		emit: e
+	};
+	let t = Se();
+	if (!t) return;
+	await i(t);
+	let n = t.contentWindow;
+	return n ? {
+		receive: window,
+		emit: n
+	} : void 0;
+})(), Ce = (e, { boundRetired: t = (e) => e } = {}) => {
+	let n, r = 0, i = !1, a = () => {}, o = () => new Promise((e) => {
+		a = e;
+	}), s = o(), c = s, l = /* @__PURE__ */ new Set(), u = /* @__PURE__ */ new Set(), d = 0, f = 0, p = () => {
+		let e = [...u];
+		u.clear();
+		let t = /* @__PURE__ */ Error("FKN: the broker was replaced while this call was pending; retry it");
+		for (let n of e) try {
+			n(t);
+		} catch {}
+	};
+	(async () => {
+		for await (let t of e) {
+			let e = ++r;
+			n = {
+				remote: t,
+				epoch: e
+			};
+			let i = a;
+			s = o(), i(t), p();
+			for (let n of [...l]) try {
+				n(t, e);
+			} catch {}
+		}
+	})().catch(() => {});
+	let m = async (e, r) => {
+		let a = n?.remote ?? await (i ? t(s) : s);
+		for (let t of e.slice(0, -1)) a = a[t];
+		let o = a[e[e.length - 1] ?? ""];
+		d = Date.now(), f += 1;
+		let c = () => {}, l = new Promise((e, t) => {
+			c = t;
+		});
+		u.add(c);
+		try {
+			return await Promise.race([Promise.resolve(o.apply(a, r)), l]);
+		} finally {
+			--f, u.delete(c), d = Date.now();
+		}
+	}, h = /* @__PURE__ */ new Map(), g = (e) => {
+		let t = e.join("\0"), r = h.get(t);
+		if (r) return r;
+		let i = new Proxy(function() {}, {
+			get: (t, r) => {
+				if (typeof r != "string" || r === "then") return;
+				let i = n;
+				if (i) {
+					let t = i.remote;
+					for (let n of e) t = t?.[n];
+					if (t?.[r] === void 0) return;
+				}
+				return g([...e, r]);
+			},
+			apply: (t, n, r) => m(e, r)
+		});
+		return h.set(t, i), i;
+	};
+	return {
+		facade: g([]),
+		first: c.then(() => {}),
+		current: () => n,
+		onEpoch: (e) => {
+			if (l.add(e), n) try {
+				e(n.remote, n.epoch);
+			} catch {}
+			return () => {
+				l.delete(e);
+			};
+		},
+		lastCall: () => d,
+		inFlight: () => f,
+		routable: () => n ? Promise.resolve() : s.then(() => {}),
+		retire: () => {
+			i = !0, n = void 0, p();
+		}
+	};
+}, H = !1, U = /* @__PURE__ */ new Set(), W = () => H, we = () => {
+	if (!H) {
+		H = !0;
+		for (let e of [...U]) try {
+			e();
+		} catch {}
+		U.clear();
+	}
+}, G = (e) => {
+	H ? e() : U.add(e);
+}, Te = typeof window < "u" || typeof self < "u", Ee = async () => {
+	if (typeof window < "u") return V;
+	if (typeof self < "u") return {
+		receive: self,
+		emit: self
+	};
+}, De = "fkn-api", Oe = "fkn-api-window", K = Ce({ async *[Symbol.asyncIterator]() {
+	let t = await Ee();
+	if (!t) {
+		await new Promise(() => {});
+		return;
+	}
+	if (!W()) {
+		let n = new AbortController();
+		G(() => n.abort());
+		for await (let r of e({}, {
+			key: De,
+			transport: t,
+			unregisterSignal: n.signal
+		})) {
+			if (n.signal.aborted) break;
+			yield r;
+		}
+	}
+	yield* e({}, {
+		key: Oe,
+		transport: t
+	});
+} }, { boundRetired: (e) => Q(e, () => new Z()) });
+G(() => K.retire());
+var q = Promise.race([K.first, new Promise((e) => G(e))]).then(() => K.facade), J = 8e3, ke = 1e3, Y = !1, X = class extends Error {
+	constructor(e, t) {
+		super(`@fkn/lib: no broker connection within ${t}ms, so ${e} could not be requested`), this.name = "BrokerUnreachableError";
+	}
+}, Z = class extends Error {
+	constructor() {
+		super("FKN @fkn/lib: this page relays its FKN channel to a worker, and the FKN page it reached predates a channel of the page's own; reload"), this.name = "OwnChannelUnavailableError";
+	}
+}, Q = (e, t) => {
+	let n = Y ? ke : J;
+	return Promise.race([e, new Promise((e, r) => setTimeout(() => {
+		Y = !0, r(t(n));
+	}, n))]);
+}, Ae = (e) => W() ? Q(K.routable().then(() => K.facade), () => new Z()) : Q(q, (t) => new X(e, t));
+G(() => {
+	let e = setTimeout(() => console.error(new Z()), J);
+	K.routable().then(() => clearTimeout(e));
+});
+var $ = K.onEpoch, je = K.current;
+K.lastCall, K.inFlight, $((e) => {
+	ue() && e.overlay.setHost(me, { exactClips: f() }).catch(() => {});
+});
+//#endregion
+export { M as a, X as c, q as d, we as f, J as i, Z as l, Ae as n, Te as o, F as r, V as s, $ as t, je as u };

package/api-d5i206BT.js

@@ -0,0 +1,2 @@
+import { d as e, t } from "./api-DIgTslNb-BSzu7eku.js";
+export { e as apiPromise, t as onApiEpoch };