waterplane 0.0.1 → 0.1.6

package/node_modules/@waterplane/shared/dist/netfuse.js

@@ -0,0 +1,99 @@
+/**
+ * The fuse on an HTTP request that never answers.
+ *
+ * A dead Tailscale path does not refuse a connection, it SWALLOWS it: the
+ * socket stays open, no bytes come back, and `fetch` waits for as long as the
+ * platform allows — minutes on Android, indefinitely in some WebViews. That
+ * failure mode is indistinguishable from a slow request, and everything the
+ * client does about being offline hangs off the fetch REJECTING: the reader's
+ * cached transcript, the slash cache, the gallery's stale rows. With no fuse
+ * those fallbacks are unreachable code exactly when they are the whole point —
+ * the observed symptom was a reader parked on "loading transcript…" for as
+ * long as anyone cared to watch, with a perfectly good cached document one
+ * IndexedDB read away.
+ *
+ * Deliberately a wall-clock cap rather than `pull.ts`'s stall detector: these
+ * are small JSON responses that arrive in one chunk, so "no answer within N
+ * seconds" is the entire signal. Streaming transfers (auto-download, the speed
+ * test) keep their own progress-based rules, and uploads run on XHR.
+ *
+ * Lives in `shared` for the same reason `queue.ts` and `promptid.ts` do: node
+ * has `fetch`, so the rules can be PINNED by an e2e script against a real
+ * server that hangs, instead of trusted to a comment.
+ */
+/** Generic budget for a JSON call. Long enough that a bad-but-alive link still
+ *  completes, short enough that a dead one is reported while someone is still
+ *  looking at the screen. */
+export const FETCH_TIMEOUT_MS = 20000;
+/** The reader polls, so its fuse is shorter than the generic one: a poll still
+ *  pending when the next is due has already failed. */
+export const TRANSCRIPT_TIMEOUT_MS = 12000;
+/** Endpoints that run a real command against a repo (push over a slow uplink,
+ *  checkout in a big tree) legitimately take minutes. The fuse exists to stop a
+ *  DEAD link hanging forever, not to cap honest work — cutting a push at 20 s
+ *  would report failure for something the host then completes, which is worse
+ *  than the hang it replaced. */
+export const SLOW_OP_TIMEOUT_MS = 180000;
+export class TimeoutError extends Error {
+    url;
+    ms;
+    constructor(url, ms) {
+        super(`timed out after ${Math.round(ms / 1000)}s`);
+        this.name = "TimeoutError";
+        this.url = url;
+        this.ms = ms;
+    }
+}
+/**
+ * True for the failures that mean "the host never answered", as opposed to a
+ * status code. Callers use it to say "offline" where they would otherwise print
+ * a stack trace at someone whose tunnel is down — the difference between
+ * "TimeoutError: timed out after 12s" and "can't reach the host".
+ * A 404/500 is NOT offline: the host answered, and the answer was no.
+ */
+export function isOffline(e) {
+    if (e instanceof TimeoutError)
+        return true;
+    if (e instanceof TypeError)
+        return true; // fetch's transport failure
+    const s = String(e);
+    return s.includes("Failed to fetch") || s.includes("NetworkError") || s.includes("fetch failed");
+}
+/**
+ * `fetch` that rejects with a `TimeoutError` if the host has not answered in
+ * `ms`. Composes with a caller-supplied `signal` (uploads, cancel buttons):
+ * an abort THEY caused stays their own error, so a cancel is never mislabelled
+ * as a dead link. The timer is always cleared, so a phone holding a screen open
+ * for an hour isn't holding a thousand live timers.
+ *
+ * The budget covers the RESPONSE HEADERS, which is what `fetch` resolves on —
+ * a slow body that is actually streaming is not this function's problem.
+ */
+export async function timedFetch(url, init, ms = FETCH_TIMEOUT_MS, doFetch = fetch) {
+    const ac = new AbortController();
+    const outer = init?.signal;
+    const onOuterAbort = () => ac.abort();
+    if (outer) {
+        if (outer.aborted)
+            ac.abort();
+        else
+            outer.addEventListener("abort", onOuterAbort, { once: true });
+    }
+    // The reason is the `TimeoutError` itself, so a layer UNDER this one (the
+    // phone's stall record, `web/link/linkStalls.ts`) can tell the fuse from a
+    // caller's cancel. What this function throws is unchanged either way.
+    const timer = setTimeout(() => ac.abort(new TimeoutError(url, ms)), ms);
+    try {
+        return await doFetch(url, { ...init, signal: ac.signal });
+    }
+    catch (e) {
+        if (ac.signal.aborted && !outer?.aborted)
+            throw new TimeoutError(url, ms);
+        throw e;
+    }
+    finally {
+        clearTimeout(timer);
+        outer?.removeEventListener("abort", onOuterAbort);
+    }
+}
+//# sourceMappingURL=netfuse.js.map

package/node_modules/@waterplane/shared/dist/netfuse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"netfuse.js","sourceRoot":"","sources":["../src/netfuse.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH;;6BAE6B;AAC7B,MAAM,CAAC,MAAM,gBAAgB,GAAG,KAAK,CAAC;AACtC;uDACuD;AACvD,MAAM,CAAC,MAAM,qBAAqB,GAAG,KAAK,CAAC;AAC3C;;;;iCAIiC;AACjC,MAAM,CAAC,MAAM,kBAAkB,GAAG,MAAM,CAAC;AAEzC,MAAM,OAAO,YAAa,SAAQ,KAAK;IAC5B,GAAG,CAAS;IACZ,EAAE,CAAS;IACpB,YAAY,GAAW,EAAE,EAAU;QACjC,KAAK,CAAC,mBAAmB,IAAI,CAAC,KAAK,CAAC,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC;QACnD,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;QAC3B,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;QACf,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC;IACf,CAAC;CACF;AAED;;;;;;GAMG;AACH,MAAM,UAAU,SAAS,CAAC,CAAU;IAClC,IAAI,CAAC,YAAY,YAAY;QAAE,OAAO,IAAI,CAAC;IAC3C,IAAI,CAAC,YAAY,SAAS;QAAE,OAAO,IAAI,CAAC,CAAiB,4BAA4B;IACrF,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;IACpB,OAAO,CAAC,CAAC,QAAQ,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC;AACnG,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,GAAW,EACX,IAAkB,EAClB,KAAa,gBAAgB,EAC7B,UAAwB,KAAK;IAE7B,MAAM,EAAE,GAAG,IAAI,eAAe,EAAE,CAAC;IACjC,MAAM,KAAK,GAAG,IAAI,EAAE,MAAM,CAAC;IAC3B,MAAM,YAAY,GAAG,GAAG,EAAE,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC;IACtC,IAAI,KAAK,EAAE,CAAC;QACV,IAAI,KAAK,CAAC,OAAO;YAAE,EAAE,CAAC,KAAK,EAAE,CAAC;;YACzB,KAAK,CAAC,gBAAgB,CAAC,OAAO,EAAE,YAAY,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;IACrE,CAAC;IACD,0EAA0E;IAC1E,2EAA2E;IAC3E,sEAAsE;IACtE,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,YAAY,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IACxE,IAAI,CAAC;QACH,OAAO,MAAM,OAAO,CAAC,GAAG,EAAE,EAAE,GAAG,IAAI,EAAE,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC,CAAC;IAC5D,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,IAAI,EAAE,CAAC,MAAM,CAAC,OAAO,IAAI,CAAC,KAAK,EAAE,OAAO;YAAE,MAAM,IAAI,YAAY,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;QAC1E,MAAM,CAAC,CAAC;IACV,CAAC;YAAS,CAAC;QACT,YAAY,CAAC,KAAK,CAAC,CAAC;QACpB,KAAK,EAAE,mBAAmB,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;IACpD,CAAC;AACH,CAAC"}

package/node_modules/@waterplane/shared/dist/netstall.d.ts

@@ -0,0 +1,163 @@
+/**
+ * HTTP stalls, as the phone saw them — the evidence for WHY a request hung.
+ *
+ * Observed on the APK (plain HTTP/1.1 to `100.x:8770`): requests sat for
+ * minutes while the one WebSocket answered pings in 14–52 ms. Two stories fit
+ * that and they need different fixes:
+ *
+ *   (a) a HALF-OPEN keep-alive socket reused after Doze or a network change —
+ *       the evidence is the WS healthy, few requests in flight, and the stall
+ *       starting right after the page became visible again;
+ *   (b) Chromium's six-sockets-per-host HTTP/1.1 pool FILLED by slow calls
+ *       (180 s git/stats fuses, pulls, uploads), queueing everything behind
+ *       them — the evidence is six or more requests in flight at the stall.
+ *       A WebSocket does not count toward that pool, which is why it stays fine.
+ *
+ * So every stall records what was true at that moment: how many requests were
+ * in flight and which, the socket's last pong, visibility, `navigator.onLine`,
+ * and whether bytes had moved. This file is the shape, the ring, the merge and
+ * the summary — pure, so both ends read one definition and node pins it.
+ *
+ * **Absent means nobody measured.** Every context field is optional and is
+ * omitted, never zeroed, when the phone could not know it; the summary's shares
+ * are absent when no event carried the fact they divide by. Diagnostics only:
+ * nothing here changes how a request is made.
+ */
+/** Past this age an in-flight request is a stall — `NetActivity`'s chip says
+ *  "the connection may be down" at the same moment. */
+export declare const NET_STALL_MS = 12000;
+/** Events kept per device, on the phone and in `netstats.json` alike. */
+export declare const STALL_RING_CAP = 50;
+/** Other requests listed beside a stall (the count is uncapped). */
+export declare const STALL_PEERS_CAP = 8;
+/** Chromium's HTTP/1.1 connections per host. At or past this many in flight, a
+ *  new request queues inside the browser before it reaches any socket. */
+export declare const HTTP1_POOL_PER_HOST = 6;
+/** A socket whose last pong is younger than this is healthy: the heartbeat is
+ *  12 s, so two missed beats plus slack. */
+export declare const WS_HEALTHY_PONG_MS = 30000;
+/** A stall that began within this long of the page becoming visible is a
+ *  stall "after wake" — the Doze/network-change story. */
+export declare const AFTER_WAKE_MS = 30000;
+/**
+ * How a stalled request ended.
+ *  - `timeout` — its own fuse fired (`TimeoutError`, the upload's silence fuse,
+ *    a JSON body that never finished).
+ *  - `late`    — it got an answer (any status), after `NET_STALL_MS`.
+ *  - `failed`  — a transport error or a caller's abort, after `NET_STALL_MS`.
+ *  - `open`    — still in flight when the report was made.
+ */
+export type StallOutcome = "timeout" | "late" | "failed" | "open";
+export declare const STALL_OUTCOMES: readonly StallOutcome[];
+export interface StallPeer {
+    label: string;
+    ageMs: number;
+}
+/** The socket at the stall. `open` alone is known whenever there is a socket. */
+export interface StallWs {
+    open: boolean;
+    /** Since the newest heartbeat pong. Absent: no pong yet on this page. */
+    pongAgeMs?: number;
+    /** That pong's round trip. */
+    rttMs?: number;
+}
+export interface StallEvent {
+    /** Unique per event (`<page>.<seq>`), so a re-sent ring merges idempotently. */
+    k: string;
+    /** Epoch ms the context below was read — the stall's onset where a timer
+     *  could fire, else the moment it ended. */
+    at: number;
+    /** `labelForUrl`'s words for the request. */
+    label: string;
+    method: string;
+    /** `fetch` or `xhr`. */
+    via?: "fetch" | "xhr";
+    /** Only for a JSON body that stalled after its headers. */
+    phase?: "body";
+    /** How old the request was when it ended (or at the report, for `open`). */
+    ageMs: number;
+    /** The fuse that was armed, when known. */
+    fuseMs?: number;
+    outcome: StallOutcome;
+    /** HTTP requests in flight at `at`, this one included. */
+    inflight?: number;
+    /** The others, oldest first, capped at `STALL_PEERS_CAP`. */
+    peers?: StallPeer[];
+    ws?: StallWs;
+    visible?: boolean;
+    /** How long the page had been in its current visibility at `at`. Absent
+     *  until the first visibility change on this page — a load is not a wake. */
+    visForMs?: number;
+    online?: boolean;
+    /** Uploads: request-body bytes sent and expected. */
+    sent?: number;
+    total?: number;
+}
+/** What a phone sends over the socket (`net.stalls`). */
+export interface StallReport {
+    /** Finished stalls, newest last. Re-sent whole; the host merges on `k`. */
+    events: StallEvent[];
+    /** Requests stalled right now. Replaces the previous list, never merged. */
+    open?: StallEvent[];
+}
+/** Per device in `netstats.json`: `clients[id].stalls`. */
+export interface StallSummary {
+    /** Newest event or open-list update. */
+    updatedAt: number;
+    /** Every distinct event ever merged in this window, by outcome — counts
+     *  outlive the ring. */
+    counts: Partial<Record<Exclude<StallOutcome, "open">, number>>;
+    /** Stalled right now (from the newest report). */
+    openNow: number;
+    /** Over the ring: */
+    ageP95Ms?: number;
+    maxInflight?: number;
+    /** Of the events that carried `inflight`: share at or past the HTTP/1.1 pool. */
+    poolFullShare?: number;
+    /** Of the events that carried `ws`: share with the socket healthy. */
+    wsHealthyShare?: number;
+    /** Of the events that carried `visForMs` while visible: share within `AFTER_WAKE_MS` of becoming visible. */
+    afterWakeShare?: number;
+    /** Of the uploads that carried `sent`: share where no byte had left. */
+    zeroBytesShare?: number;
+    /** How many events the shares are over. */
+    sampled: number;
+}
+export interface ClientStalls extends StallSummary {
+    open: StallEvent[];
+    events: StallEvent[];
+}
+/** Push onto a bounded ring, dropping the oldest. Mutates and returns it. */
+export declare function pushRing<T>(ring: T[], v: T, cap?: number): T[];
+/**
+ * The outcome of a request that ended, or null when it was not a stall.
+ * A fuse that fired is always a stall, even under `NET_STALL_MS` (a 10 s fuse
+ * is still a request that never answered); anything else must have been old.
+ */
+export declare function classifyStall(o: {
+    ageMs: number;
+    fuseFired: boolean;
+    answered: boolean;
+}): StallOutcome | null;
+/** Healthy socket: open, with a pong younger than `WS_HEALTHY_PONG_MS`.
+ *  Null when that cannot be told (open, but no pong measured yet). */
+export declare function wsHealthy(ws: StallWs | undefined): boolean | null;
+/** The shares and maxima over a set of events. Each share is absent when no
+ *  event carried the fact it needs — never a zero standing in for "unknown". */
+export declare function stallStats(events: readonly StallEvent[]): Omit<StallSummary, "updatedAt" | "counts" | "openNow">;
+/**
+ * One event, REBUILT from the fields it names — a field nobody named here is
+ * dropped, which is the point: the file is read by people and agents, and a
+ * client must not be able to grow it. Null when the event cannot say what it
+ * is (no key, no label, no outcome, no age).
+ */
+export declare function cleanStallEvent(raw: unknown): StallEvent | null;
+/**
+ * Fold one report into what the host holds for a device. Idempotent on `k`:
+ * the phone re-sends its whole ring, and a repeat neither duplicates a row nor
+ * counts twice. `open` replaces. The ring keeps the newest `STALL_RING_CAP`.
+ */
+export declare function mergeStalls(prev: ClientStalls | undefined, raw: unknown, now: number): ClientStalls;
+/** One line per device for the CLI readout (`scripts/netstalls.mjs`). Says
+ *  only what the summary holds; an absent share is not printed. */
+export declare function stallSummaryLines(id: string, st: ClientStalls): string[];

package/node_modules/@waterplane/shared/dist/netstall.js

@@ -0,0 +1,241 @@
+/**
+ * HTTP stalls, as the phone saw them — the evidence for WHY a request hung.
+ *
+ * Observed on the APK (plain HTTP/1.1 to `100.x:8770`): requests sat for
+ * minutes while the one WebSocket answered pings in 14–52 ms. Two stories fit
+ * that and they need different fixes:
+ *
+ *   (a) a HALF-OPEN keep-alive socket reused after Doze or a network change —
+ *       the evidence is the WS healthy, few requests in flight, and the stall
+ *       starting right after the page became visible again;
+ *   (b) Chromium's six-sockets-per-host HTTP/1.1 pool FILLED by slow calls
+ *       (180 s git/stats fuses, pulls, uploads), queueing everything behind
+ *       them — the evidence is six or more requests in flight at the stall.
+ *       A WebSocket does not count toward that pool, which is why it stays fine.
+ *
+ * So every stall records what was true at that moment: how many requests were
+ * in flight and which, the socket's last pong, visibility, `navigator.onLine`,
+ * and whether bytes had moved. This file is the shape, the ring, the merge and
+ * the summary — pure, so both ends read one definition and node pins it.
+ *
+ * **Absent means nobody measured.** Every context field is optional and is
+ * omitted, never zeroed, when the phone could not know it; the summary's shares
+ * are absent when no event carried the fact they divide by. Diagnostics only:
+ * nothing here changes how a request is made.
+ */
+/** Past this age an in-flight request is a stall — `NetActivity`'s chip says
+ *  "the connection may be down" at the same moment. */
+export const NET_STALL_MS = 12000;
+/** Events kept per device, on the phone and in `netstats.json` alike. */
+export const STALL_RING_CAP = 50;
+/** Other requests listed beside a stall (the count is uncapped). */
+export const STALL_PEERS_CAP = 8;
+/** Chromium's HTTP/1.1 connections per host. At or past this many in flight, a
+ *  new request queues inside the browser before it reaches any socket. */
+export const HTTP1_POOL_PER_HOST = 6;
+/** A socket whose last pong is younger than this is healthy: the heartbeat is
+ *  12 s, so two missed beats plus slack. */
+export const WS_HEALTHY_PONG_MS = 30000;
+/** A stall that began within this long of the page becoming visible is a
+ *  stall "after wake" — the Doze/network-change story. */
+export const AFTER_WAKE_MS = 30000;
+export const STALL_OUTCOMES = ["timeout", "late", "failed", "open"];
+/** Push onto a bounded ring, dropping the oldest. Mutates and returns it. */
+export function pushRing(ring, v, cap = STALL_RING_CAP) {
+    ring.push(v);
+    if (ring.length > cap)
+        ring.splice(0, ring.length - cap);
+    return ring;
+}
+/**
+ * The outcome of a request that ended, or null when it was not a stall.
+ * A fuse that fired is always a stall, even under `NET_STALL_MS` (a 10 s fuse
+ * is still a request that never answered); anything else must have been old.
+ */
+export function classifyStall(o) {
+    if (o.fuseFired)
+        return "timeout";
+    if (!(o.ageMs >= NET_STALL_MS))
+        return null;
+    return o.answered ? "late" : "failed";
+}
+/** Healthy socket: open, with a pong younger than `WS_HEALTHY_PONG_MS`.
+ *  Null when that cannot be told (open, but no pong measured yet). */
+export function wsHealthy(ws) {
+    if (!ws)
+        return null;
+    if (!ws.open)
+        return false;
+    if (ws.pongAgeMs == null)
+        return null;
+    return ws.pongAgeMs <= WS_HEALTHY_PONG_MS;
+}
+function pct(arr, p) {
+    if (!arr.length)
+        return undefined;
+    const s = [...arr].sort((a, b) => a - b);
+    return s[Math.min(s.length - 1, Math.floor((s.length - 1) * p))];
+}
+function share(hits, of) {
+    return of > 0 ? Math.round((hits / of) * 1000) / 1000 : undefined;
+}
+/** The shares and maxima over a set of events. Each share is absent when no
+ *  event carried the fact it needs — never a zero standing in for "unknown". */
+export function stallStats(events) {
+    const inflight = events.filter((e) => e.inflight != null);
+    let wsKnown = 0, wsOk = 0;
+    for (const e of events) {
+        const h = wsHealthy(e.ws);
+        if (h == null)
+            continue;
+        wsKnown++;
+        if (h)
+            wsOk++;
+    }
+    const woke = events.filter((e) => e.visible === true && e.visForMs != null);
+    const ups = events.filter((e) => e.sent != null);
+    const out = { sampled: events.length };
+    const p95 = pct(events.map((e) => e.ageMs), 0.95);
+    if (p95 != null)
+        out.ageP95Ms = p95;
+    if (inflight.length)
+        out.maxInflight = Math.max(...inflight.map((e) => e.inflight));
+    const pool = share(inflight.filter((e) => e.inflight >= HTTP1_POOL_PER_HOST).length, inflight.length);
+    if (pool != null)
+        out.poolFullShare = pool;
+    const ws = share(wsOk, wsKnown);
+    if (ws != null)
+        out.wsHealthyShare = ws;
+    const wake = share(woke.filter((e) => e.visForMs <= AFTER_WAKE_MS).length, woke.length);
+    if (wake != null)
+        out.afterWakeShare = wake;
+    const zero = share(ups.filter((e) => e.sent === 0).length, ups.length);
+    if (zero != null)
+        out.zeroBytesShare = zero;
+    return out;
+}
+// ── cleaning (the host's way IN) ────────────────────────────────────────────
+function n(v, max) {
+    if (typeof v !== "number" || !Number.isFinite(v))
+        return undefined;
+    return Math.max(0, Math.min(max, Math.round(v)));
+}
+function s(v, max) {
+    return typeof v === "string" && v ? v.slice(0, max) : undefined;
+}
+const DAY = 86_400_000;
+/**
+ * One event, REBUILT from the fields it names — a field nobody named here is
+ * dropped, which is the point: the file is read by people and agents, and a
+ * client must not be able to grow it. Null when the event cannot say what it
+ * is (no key, no label, no outcome, no age).
+ */
+export function cleanStallEvent(raw) {
+    if (!raw || typeof raw !== "object")
+        return null;
+    const r = raw;
+    const k = s(r.k, 40);
+    const label = s(r.label, 60);
+    const outcome = STALL_OUTCOMES.includes(r.outcome) ? r.outcome : undefined;
+    const ageMs = n(r.ageMs, DAY);
+    const at = n(r.at, 9e15);
+    if (!k || !label || !outcome || ageMs == null || at == null)
+        return null;
+    const e = { k, at, label, method: s(r.method, 10)?.toUpperCase() ?? "GET", ageMs, outcome };
+    if (r.via === "fetch" || r.via === "xhr")
+        e.via = r.via;
+    if (r.phase === "body")
+        e.phase = "body";
+    const fuse = n(r.fuseMs, DAY);
+    if (fuse != null)
+        e.fuseMs = fuse;
+    const inf = n(r.inflight, 10_000);
+    if (inf != null)
+        e.inflight = inf;
+    if (Array.isArray(r.peers)) {
+        const peers = [];
+        for (const p of r.peers.slice(0, STALL_PEERS_CAP)) {
+            const pl = s(p?.label, 60);
+            const pa = n(p?.ageMs, DAY);
+            if (pl && pa != null)
+                peers.push({ label: pl, ageMs: pa });
+        }
+        if (peers.length)
+            e.peers = peers;
+    }
+    if (r.ws && typeof r.ws === "object") {
+        const w = r.ws;
+        if (typeof w.open === "boolean") {
+            const ws = { open: w.open };
+            const pong = n(w.pongAgeMs, DAY);
+            if (pong != null)
+                ws.pongAgeMs = pong;
+            const rtt = n(w.rttMs, 600_000);
+            if (rtt != null)
+                ws.rttMs = rtt;
+            e.ws = ws;
+        }
+    }
+    if (typeof r.visible === "boolean")
+        e.visible = r.visible;
+    const vis = n(r.visForMs, 30 * DAY);
+    if (vis != null)
+        e.visForMs = vis;
+    if (typeof r.online === "boolean")
+        e.online = r.online;
+    const sent = n(r.sent, 1e10);
+    if (sent != null)
+        e.sent = sent;
+    const total = n(r.total, 1e10);
+    if (total != null)
+        e.total = total;
+    return e;
+}
+/**
+ * Fold one report into what the host holds for a device. Idempotent on `k`:
+ * the phone re-sends its whole ring, and a repeat neither duplicates a row nor
+ * counts twice. `open` replaces. The ring keeps the newest `STALL_RING_CAP`.
+ */
+export function mergeStalls(prev, raw, now) {
+    const r = (raw ?? {});
+    const known = new Map();
+    for (const e of prev?.events ?? [])
+        known.set(e.k, e);
+    const counts = { ...(prev?.counts ?? {}) };
+    const incoming = Array.isArray(r.events) ? r.events.slice(-STALL_RING_CAP * 2) : [];
+    for (const x of incoming) {
+        const e = cleanStallEvent(x);
+        if (!e || e.outcome === "open" || known.has(e.k))
+            continue;
+        known.set(e.k, e);
+        counts[e.outcome] = (counts[e.outcome] ?? 0) + 1;
+    }
+    const events = [...known.values()].sort((a, b) => a.at - b.at).slice(-STALL_RING_CAP);
+    const open = Array.isArray(r.open)
+        ? r.open.slice(0, STALL_RING_CAP).map(cleanStallEvent).filter((e) => !!e).map((e) => ({ ...e, outcome: "open" }))
+        : (prev?.open ?? []);
+    return { updatedAt: now, counts, openNow: open.length, ...stallStats(events), open, events };
+}
+/** One line per device for the CLI readout (`scripts/netstalls.mjs`). Says
+ *  only what the summary holds; an absent share is not printed. */
+export function stallSummaryLines(id, st) {
+    const c = st.counts ?? {};
+    const pc = (v) => (v == null ? null : `${Math.round(v * 100)}%`);
+    const sec = (ms) => (ms == null ? null : `${Math.round(ms / 1000)}s`);
+    const parts = [
+        `timeout ${c.timeout ?? 0}`, `late ${c.late ?? 0}`, `failed ${c.failed ?? 0}`, `open now ${st.openNow ?? 0}`,
+    ];
+    const facts = [
+        sec(st.ageP95Ms) && `age p95 ${sec(st.ageP95Ms)}`,
+        st.maxInflight != null && `max in flight ${st.maxInflight}`,
+        pc(st.poolFullShare) && `>=${HTTP1_POOL_PER_HOST} in flight ${pc(st.poolFullShare)}`,
+        pc(st.wsHealthyShare) && `ws healthy ${pc(st.wsHealthyShare)}`,
+        pc(st.afterWakeShare) && `after wake ${pc(st.afterWakeShare)}`,
+        pc(st.zeroBytesShare) && `uploads with 0 B sent ${pc(st.zeroBytesShare)}`,
+    ].filter(Boolean);
+    return [
+        `${id}: ${parts.join(" · ")}`,
+        facts.length ? `  over the last ${st.sampled}: ${facts.join(" · ")}` : `  no events in the ring`,
+    ];
+}
+//# sourceMappingURL=netstall.js.map

package/node_modules/@waterplane/shared/dist/netstall.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"netstall.js","sourceRoot":"","sources":["../src/netstall.ts"],"names":[],"mappings":"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"}

package/node_modules/@waterplane/shared/dist/nodemin.d.ts

@@ -0,0 +1,18 @@
+/**
+ * The oldest Node the host runs on — ONE number, so the root `package.json`
+ * `engines`, the doctor's `node` row and the early refusal in `env.ts` /
+ * `cli/index.ts` cannot disagree (`packages/host/test/nodepin.test.mjs` holds
+ * `engines` to it, and `.nvmrc` to `deploy/node-version`'s major).
+ *
+ * 20.12 because the host reads `.env` files with `util.parseEnv` (20.12) and
+ * reads `import.meta.dirname` at import (`env.ts`, `cli/index.ts`,
+ * `webbundle.ts`; 20.11): before that the daemon dies in `path.resolve` before
+ * the doctor could say why. `envfiles.ts` imports `node:util` as a namespace so
+ * an older Node still LINKS and reaches the refusal. Everything newer the host
+ * uses (`node:sqlite`, 22.5) degrades to an absent reader.
+ */
+export declare const NODE_MIN = "20.12.0";
+/** True when `version` (`process.versions.node`, a leading `v` allowed) is at least `NODE_MIN`. Unparseable ⇒ false. */
+export declare function nodeMeetsMin(version: string, min?: string): boolean;
+/** The one sentence a too-old Node is refused with, before anything else runs. */
+export declare function nodeTooOldSentence(version: string): string;

package/node_modules/@waterplane/shared/dist/nodemin.js

@@ -0,0 +1,35 @@
+/**
+ * The oldest Node the host runs on — ONE number, so the root `package.json`
+ * `engines`, the doctor's `node` row and the early refusal in `env.ts` /
+ * `cli/index.ts` cannot disagree (`packages/host/test/nodepin.test.mjs` holds
+ * `engines` to it, and `.nvmrc` to `deploy/node-version`'s major).
+ *
+ * 20.12 because the host reads `.env` files with `util.parseEnv` (20.12) and
+ * reads `import.meta.dirname` at import (`env.ts`, `cli/index.ts`,
+ * `webbundle.ts`; 20.11): before that the daemon dies in `path.resolve` before
+ * the doctor could say why. `envfiles.ts` imports `node:util` as a namespace so
+ * an older Node still LINKS and reaches the refusal. Everything newer the host
+ * uses (`node:sqlite`, 22.5) degrades to an absent reader.
+ */
+export const NODE_MIN = "20.12.0";
+/** True when `version` (`process.versions.node`, a leading `v` allowed) is at least `NODE_MIN`. Unparseable ⇒ false. */
+export function nodeMeetsMin(version, min = NODE_MIN) {
+    const parse = (v) => {
+        const m = /^v?(\d+)\.(\d+)\.(\d+)/.exec(v.trim());
+        return m ? [Number(m[1]), Number(m[2]), Number(m[3])] : null;
+    };
+    const a = parse(version);
+    const b = parse(min);
+    if (!a || !b)
+        return false;
+    for (let i = 0; i < 3; i++)
+        if (a[i] !== b[i])
+            return a[i] > b[i];
+    return true;
+}
+/** The one sentence a too-old Node is refused with, before anything else runs. */
+export function nodeTooOldSentence(version) {
+    return `Node ${version} is too old: this host needs Node ${NODE_MIN} or newer (it uses util.parseEnv and import.meta.dirname). ` +
+        `Install a current Node (the release installer pins one) and run it again.`;
+}
+//# sourceMappingURL=nodemin.js.map

package/node_modules/@waterplane/shared/dist/nodemin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nodemin.js","sourceRoot":"","sources":["../src/nodemin.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,SAAS,CAAC;AAElC,wHAAwH;AACxH,MAAM,UAAU,YAAY,CAAC,OAAe,EAAE,MAAc,QAAQ;IAClE,MAAM,KAAK,GAAG,CAAC,CAAS,EAAmB,EAAE;QAC3C,MAAM,CAAC,GAAG,wBAAwB,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;QAClD,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAC/D,CAAC,CAAC;IACF,MAAM,CAAC,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC;IACzB,MAAM,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC;IACrB,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC;QAAE,OAAO,KAAK,CAAC;IAC3B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE;QAAE,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;YAAE,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IAClE,OAAO,IAAI,CAAC;AACd,CAAC;AAED,kFAAkF;AAClF,MAAM,UAAU,kBAAkB,CAAC,OAAe;IAChD,OAAO,QAAQ,OAAO,qCAAqC,QAAQ,6DAA6D;QAC9H,2EAA2E,CAAC;AAChF,CAAC"}