waterplane 0.0.1 → 0.1.6

package/packages/host/dist/updates/apply.js

@@ -0,0 +1,362 @@
+/**
+ * Applying an update, on a tap and nothing else (CLAUDE.md: nothing applies itself): install a plugin,
+ * update one the manager installed, update or roll back waterplane itself, restart the desktop.
+ *
+ * ONE apply at a time (`busy`): a second gets "another update is running". Every refusal is a
+ * sentence the phone shows verbatim and leaves the machine as it was — a rejected install removes
+ * its temp dir, a rejected update checks the previous commit back out, a failed self update never
+ * switched versions (`cli/selfupdate.ts` ran with `noRestart`; THIS file restarts, under the
+ * supervisor rule shared with `routes/apihost.ts`).
+ *
+ * Plugins are cloned into `<plugins>/.incoming-<rand>` (a dot-dir the loader skips, held inside the
+ * plugins dir by `contained`), validated there, and only then renamed to `<plugins>/<id>`.
+ * Zero dependencies only: no `npm ci` anywhere in this feature.
+ */
+import { existsSync, mkdirSync, readFileSync, readdirSync, renameSync, rmSync, appendFileSync } from "node:fs";
+import { randomBytes } from "node:crypto";
+import { dirname, join, resolve } from "node:path";
+import { BRAND, newerVersion } from "@waterplane/shared";
+import { applyInProcess } from "../cli/selfupdate.js";
+import { contained } from "../paths.js";
+import { readPluginDir } from "../plugins/pluginloader.js";
+import { realGit, refOk, resolveUrl, urlProblem } from "./gitops.js";
+import { INSTALL_RECORD, readInstallRecord, writeInstallRecord } from "./installrecord.js";
+import { repoLabel } from "./remote.js";
+import { canRestartSelf, restartSelf } from "./restart.js";
+export const BUSY_SENTENCE = "another update is running";
+const fail = (message, restart = "none") => ({ ok: false, message, restart });
+const errText = (e) => (e instanceof Error ? e.message : String(e)).replace(/\.+$/, "");
+export class UpdateApplier {
+    d;
+    running = false;
+    git;
+    restart;
+    supervised;
+    constructor(d) {
+        this.d = d;
+        this.git = d.git ?? realGit;
+        this.restart = d.restart ?? restartSelf;
+        this.supervised = d.supervised ?? canRestartSelf;
+        this.sweepIncoming(); // a host killed mid-clone leaves its temp dir behind
+    }
+    /**
+     * Remove every `<plugins>/.incoming-*` (a clone a killed host never cleaned up). Only called when no
+     * apply runs (boot, or the start of an install, which holds `busy`); each path goes through
+     * `contained`, so nothing outside the plugins folder is ever touched. Returns how many went.
+     */
+    sweepIncoming() {
+        let n = 0;
+        try {
+            for (const name of readdirSync(this.d.pluginsDir)) {
+                if (!name.startsWith(".incoming-"))
+                    continue;
+                const p = contained(this.d.pluginsDir, name);
+                if (!p)
+                    continue;
+                try {
+                    rmSync(p, { recursive: true, force: true });
+                    n++;
+                }
+                catch { /* next boot tries again */ }
+            }
+        }
+        catch { /* no plugins folder yet */ }
+        return n;
+    }
+    /** True while an apply runs. The route asks this BEFORE `apply`, so the refusal is synchronous. */
+    get busy() { return this.running; }
+    async apply(target) {
+        if (this.running)
+            return fail(BUSY_SENTENCE);
+        this.running = true;
+        let result;
+        try {
+            switch (target?.kind) {
+                case "plugin-install":
+                    result = await this.install(target.repo, target.url);
+                    break;
+                case "plugin-update":
+                    result = await this.updatePlugin(target.id);
+                    break;
+                case "self":
+                    result = await this.self("update");
+                    break;
+                case "self-rollback":
+                    result = await this.self("rollback");
+                    break;
+                case "restart":
+                    result = this.restartDesktop();
+                    break;
+                default: result = fail("This device asked for an update this desktop does not know.");
+            }
+        }
+        catch (e) {
+            result = fail(`The update stopped: ${errText(e)}. Nothing else was changed.`);
+        }
+        finally {
+            this.running = false;
+        }
+        // Kept (and broadcast with the status) so a phone whose link dropped mid-apply still reads the outcome.
+        // A refusal for an unknown target shape stores nothing a client could not have sent.
+        if (target && typeof target === "object")
+            this.d.checker.setLastApply({ target, ...result });
+        else
+            this.d.checker.refresh();
+        return result;
+    }
+    // ── restart ───────────────────────────────────────────────────────────
+    restartDesktop() {
+        if (!this.supervised())
+            return fail("This desktop is not run by a service, so it cannot restart itself. Restart it by hand.", "manual");
+        this.restart("restarting the desktop");
+        return { ok: true, message: "Restarting the desktop.", restart: "restarting" };
+    }
+    // ── waterplane itself ─────────────────────────────────────────────────
+    async self(what) {
+        const info = this.d.checker.status().self;
+        if (!info.canApply) {
+            return fail(`${info.why ?? "This install cannot update itself."}${info.command ? ` Run: ${info.command}` : ""}`);
+        }
+        const logs = [], errors = [];
+        const run = this.d.selfApply ?? applyInProcess;
+        const auto = this.supervised();
+        // A rollback also restores the older state: in-process that only happens in the shutdown path of a
+        // SUPERVISED restart (`deferRestore`); unsupervised, applyInProcess refuses it in words.
+        const r = await run(what, { log: (m) => logs.push(m), error: (m) => errors.push(m) }, undefined, { deferRestore: auto });
+        const warn = r.warning ? ` ${r.warning}` : "";
+        const stateNotRestored = logs.concat(errors).some((l) => l.includes("NOT restored"));
+        if (r.code !== 0 || stateNotRestored) {
+            const message = (errors.join(" ").trim() || logs.at(-1) || `The ${what} failed and nothing was switched.`) + (stateNotRestored ? " The older state was not restored; no restart was made." : "");
+            this.d.checker.setLastResult({ ok: false, message });
+            return fail(message);
+        }
+        const v = r.version ?? "";
+        if (!v || v === info.current) {
+            const message = (what === "update" ? `${info.current} is already the newest version.` : `Nothing to roll back to from ${info.current}.`) + warn;
+            this.d.checker.setLastResult({ ok: true, message });
+            return { ok: true, message, restart: "none" };
+        }
+        // The receipt is written BEFORE the restart: the phone reads it after it reconnects.
+        const message = (auto
+            ? (what === "update" ? `updated to ${v}` : (logs.find((l) => l.startsWith("Rolled back")) ?? `rolled back to ${v}`))
+            : (what === "update" ? `installed ${v}, restart the desktop to switch` : `${logs.find((l) => l.startsWith("Rolled back")) ?? `rolled back to ${v}`} Restart the desktop to switch.`)) + warn;
+        this.d.checker.setLastResult({ ok: true, message });
+        if (auto)
+            this.restart(what === "update" ? `updating ${BRAND.slug} to ${v}` : `rolling ${BRAND.slug} back to ${v}`);
+        return { ok: true, message, restart: auto ? "restarting" : "manual" };
+    }
+    // ── plugin install ────────────────────────────────────────────────────
+    async install(repo, rawUrl) {
+        let url;
+        let want = null;
+        if (typeof repo === "string" && repo) {
+            const row = this.d.checker.status().catalog.find((c) => c.repo === repo);
+            if (!row)
+                return fail(`${repo} is not in the list of plugins. Check for updates to refresh the list, or paste its address instead.`);
+            if (row.problems.length)
+                return fail(`${row.name} cannot be installed: ${row.problems.join("; ")}.`);
+            if (row.installed)
+                return fail(`${row.name} is already installed.`);
+            if (!row.latest)
+                return fail(`${row.name} has nothing to install yet.`);
+            url = row.url;
+            want = { kind: row.latest.kind, ref: row.latest.ref };
+        }
+        else {
+            url = typeof rawUrl === "string" ? rawUrl.trim() : "";
+        }
+        const bad = urlProblem(url);
+        if (bad)
+            return fail(`${bad} Nothing was installed.`);
+        mkdirSync(this.d.pluginsDir, { recursive: true });
+        this.sweepIncoming();
+        const tmpName = `.incoming-${randomBytes(6).toString("hex")}`;
+        const tmp = contained(this.d.pluginsDir, tmpName);
+        if (!tmp)
+            return fail("The plugins folder could not be used safely. Nothing was installed.");
+        try {
+            if (!want) {
+                try {
+                    want = await resolveUrl(this.git, url);
+                }
+                catch (e) {
+                    return fail(`Could not read ${url}: ${errText(e)}. Nothing was installed.`);
+                }
+            }
+            if (want.ref && !refOk(want.ref))
+                return fail(`The version name "${want.ref}" is not one this desktop will pass to git. Nothing was installed.`);
+            try {
+                await this.git(["clone", "--depth", "1", ...(want.ref ? ["--branch", want.ref] : []), "--", url, tmp]);
+            }
+            catch (e) {
+                return fail(`Could not download ${url}: ${errText(e)}. Nothing was installed.`);
+            }
+            const dir = readPluginDir(tmp, tmp);
+            if (dir.problems.length)
+                return fail(`That repository is not an installable plugin: ${dir.problems.join("; ")}. Nothing was installed.`);
+            const id = dir.manifest.id;
+            const depsProblem = dependenciesProblem(tmp, id);
+            if (depsProblem)
+                return fail(`${depsProblem} Nothing was installed.`);
+            if (this.d.plugins.entries.some((e) => e.manifest.id === id))
+                return fail(`A plugin with the id "${id}" is already installed, so ${url} was not installed.`);
+            const dest = contained(this.d.pluginsDir, id);
+            if (!dest)
+                return fail(`The id "${id}" is not a safe folder name. Nothing was installed.`);
+            if (existsSync(dest))
+                return fail(`The plugins folder already has a folder named "${id}", so nothing was installed.`);
+            let commit;
+            let ref = want.ref;
+            try {
+                commit = (await this.git(["rev-parse", "HEAD"], tmp)).trim() || undefined;
+                if (!ref)
+                    ref = (await this.git(["rev-parse", "--abbrev-ref", "HEAD"], tmp)).trim();
+            }
+            catch { /* a record without a commit still names the url and ref */ }
+            if (!ref)
+                ref = "HEAD";
+            renameSync(tmp, dest);
+            const label = `${dir.manifest.name} ${want.kind === "tag" ? ref : `(${ref}, untagged)`}`;
+            let bootErr;
+            try {
+                try {
+                    appendFileSync(join(dest, ".git", "info", "exclude"), `\n${INSTALL_RECORD}\n`);
+                }
+                catch { /* a dirty-tree check also skips the record */ }
+                writeInstallRecord(dest, { url, kind: want.kind, ref, ...(commit ? { commit } : {}), installedAt: Date.now() });
+                bootErr = await this.d.plugins.loadOne(dest);
+            }
+            catch (e) {
+                // Past the rename the folder exists: take it out again and say so, never "nothing was changed".
+                let removed = true;
+                try {
+                    rmSync(dest, { recursive: true, force: true });
+                }
+                catch {
+                    removed = false;
+                }
+                return fail(`${label} could not be started: ${errText(e)}. ${removed ? "It was removed again; nothing is installed." : `Its folder ${dest} could not be removed; delete it by hand.`}`);
+            }
+            if (bootErr)
+                return fail(`${label} is installed but not running: ${bootErr}.`);
+            return { ok: true, message: `Installed ${label}.`, restart: "none" };
+        }
+        finally {
+            rmSync(tmp, { recursive: true, force: true }); // gone after a rename; the leftover of any refusal
+        }
+    }
+    // ── plugin update ─────────────────────────────────────────────────────
+    async updatePlugin(id) {
+        const entry = typeof id === "string" ? this.d.plugins.byId(id) : null;
+        if (!entry || entry.builtin)
+            return fail(`No plugin "${String(id)}" is installed.`);
+        const name = entry.manifest.name;
+        const rec = readInstallRecord(entry.dir);
+        if (!rec)
+            return fail(`${name} was put on this desktop by hand, so ${"the updates view"} does not update it. Update it where it came from.`);
+        if (resolve(dirname(entry.dir)) !== resolve(this.d.pluginsDir))
+            return fail(`${name} does not live in the plugins folder, so it is not updated from here.`);
+        const dir = entry.dir;
+        if (!existsSync(join(dir, ".git")))
+            return fail(`${name} has no git checkout in ${dir}, so it cannot be updated from here. Reinstall it.`);
+        let dirty;
+        try {
+            dirty = await this.git(["status", "--porcelain"], dir);
+        }
+        catch (e) {
+            return fail(`Could not read the state of ${dir}: ${errText(e)}. Nothing was changed.`);
+        }
+        if (dirty.split("\n").some((l) => l.trim() && !l.endsWith(INSTALL_RECORD))) {
+            return fail(`${name} has changes of its own in ${dir}. Commit or discard them first; nothing was changed.`);
+        }
+        const row = this.d.checker.status().catalog.find((c) => c.installed?.id === id);
+        if (row?.latest && row.problems.length)
+            return fail(`${name} cannot be updated from here: ${row.problems.join("; ")}. Nothing was changed.`);
+        if (row?.latest && row.repo.toLowerCase() !== repoLabel(rec.url).toLowerCase())
+            return fail(`${name} was installed from ${rec.url}, not ${row.repo}, so it is not updated from that list. Nothing was changed.`);
+        let want;
+        if (row?.latest)
+            want = { kind: row.latest.kind, ref: row.latest.ref };
+        else {
+            try {
+                want = await resolveUrl(this.git, rec.url);
+            }
+            catch (e) {
+                return fail(`Could not read ${rec.url}: ${errText(e)}. Nothing was changed.`);
+            }
+            if (want.kind === "branch" && !want.ref)
+                want = { kind: "branch", ref: rec.kind === "branch" ? rec.ref : "" };
+        }
+        if (!want.ref || !refOk(want.ref))
+            return fail(`There is no version of ${name} to update to. Nothing was changed.`);
+        if (want.kind === "tag" && rec.kind === "tag") {
+            if (want.ref === rec.ref)
+                return fail(`${name} is already at ${rec.ref}.`);
+            if (!isNewerTag(rec.ref, want.ref))
+                return fail(`${want.ref} is not newer than ${rec.ref}, so ${name} stays at ${rec.ref}.`);
+        }
+        let before;
+        try {
+            before = (await this.git(["rev-parse", "HEAD"], dir)).trim();
+        }
+        catch (e) {
+            return fail(`Could not read ${dir}: ${errText(e)}. Nothing was changed.`);
+        }
+        const back = async () => { try {
+            await this.git(["checkout", "--detach", before], dir);
+        }
+        catch { /* best effort: the record still names the old version */ } };
+        try {
+            if (want.kind === "tag") {
+                await this.git(["fetch", "--depth", "1", "origin", "tag", want.ref], dir);
+                await this.git(["checkout", "--detach", `refs/tags/${want.ref}`], dir);
+            }
+            else {
+                await this.git(["fetch", "--depth", "1", "origin", want.ref], dir);
+                await this.git(["checkout", "--detach", "FETCH_HEAD"], dir);
+            }
+        }
+        catch (e) {
+            await back();
+            return fail(`Could not download ${want.ref} of ${name}: ${errText(e)}. It is still at ${rec.ref}.`);
+        }
+        const read = readPluginDir(dir, dir);
+        const why = read.problems.length ? read.problems.join("; ")
+            : read.manifest.id !== id ? `the new version has the id "${read.manifest.id}" instead of "${id}"`
+                : dependenciesProblem(dir, id);
+        if (why) {
+            await back();
+            return fail(`${want.ref} of ${name} was refused: ${why}. It is still at ${rec.ref}.`);
+        }
+        let commit;
+        try {
+            commit = (await this.git(["rev-parse", "HEAD"], dir)).trim() || undefined;
+        }
+        catch { /* record without a commit */ }
+        writeInstallRecord(dir, { url: rec.url, kind: want.kind, ref: want.ref, ...(commit ? { commit } : {}), installedAt: Date.now() });
+        // ESM cannot import the same path twice, so the new code runs after a restart of the daemon.
+        return { ok: true, message: `Updated ${name} to ${want.ref}. Restart the desktop to run it.`, restart: this.supervised() ? "offer" : "manual" };
+    }
+}
+/** The refusal for a plugin whose package.json lists dependencies (or cannot be read), else null. */
+function dependenciesProblem(dir, id) {
+    const p = join(dir, "package.json");
+    if (!existsSync(p))
+        return null;
+    try {
+        const deps = JSON.parse(readFileSync(p, "utf8")).dependencies;
+        const names = deps && typeof deps === "object" ? Object.keys(deps) : [];
+        if (names.length)
+            return `${id} has dependencies (${names.slice(0, 4).join(", ")}${names.length > 4 ? ", …" : ""}); only plugins without dependencies can be installed.`;
+        return null;
+    }
+    catch {
+        return `${id}'s package.json is not valid JSON.`;
+    }
+}
+/** Both versions read as numbers ⇒ `to` must be newer; names that do not parse as versions only have to differ. */
+function isNewerTag(from, to) {
+    const num = (x) => /^v?\d+\.\d+\.\d+/.test(x);
+    return num(from) && num(to) ? newerVersion(from, to) : from !== to;
+}
+//# sourceMappingURL=apply.js.map

package/packages/host/dist/updates/apply.js.map

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

package/packages/host/dist/updates/catalog.d.ts

@@ -0,0 +1,11 @@
+import type { CatalogEntry } from "@waterplane/shared";
+import type { InstalledWithUrl } from "./installrecord.js";
+/** A catalogue row before it is joined with what is installed; `id` is the manifest's, when readable. */
+export type RawCatalogEntry = Omit<CatalogEntry, "installed" | "fromOrg"> & {
+    id?: string;
+};
+export declare const orgRepoUrl: (fullName: string) => string;
+/** Read the org. Throws `GithubError` on any transport or rate-limit failure. */
+export declare function fetchCatalog(org?: string, prev?: readonly RawCatalogEntry[]): Promise<RawCatalogEntry[]>;
+/** Join with what is installed: by manifest id, else by the install record's URL. Cheap and pure — redone on every read. */
+export declare function joinInstalled(raw: readonly RawCatalogEntry[], installed: readonly InstalledWithUrl[]): CatalogEntry[];

package/packages/host/dist/updates/catalog.js

@@ -0,0 +1,123 @@
+/**
+ * The plugin catalogue: the `BRAND.githubOrg` repos that carry the `PLUGIN_TOPIC` topic, each read
+ * at its newest release (or its default branch when it has none) — a read, never an install.
+ *
+ * Calls per check: one org list, then per matching repo the latest release (+ the branch head when
+ * untagged), the manifest and `package.json` — about four a repo against 60 an hour on a first read, one (two when untagged) while a repo's release is unchanged since the cached check, three repos at a time. A repo the
+ * manager cannot install gets its refusals in WORDS in `problems`; a transport failure (offline,
+ * rate limit, 5xx) throws instead, so the caller keeps its previous catalogue — never a wrong row.
+ */
+import { BRAND, PLUGIN_TOPIC, manifestProblems, pluginMaturity } from "@waterplane/shared";
+import { GithubError, ghJson, ghRaw } from "./github.js";
+import { isOrgUrl } from "./remote.js";
+const isPublic = (r) => r.private !== true && (r.visibility === undefined || r.visibility === "public");
+async function tryJson(path) {
+    try {
+        return await ghJson(path);
+    }
+    catch (e) {
+        if (e instanceof GithubError && e.status === 404)
+            return null;
+        throw e;
+    }
+}
+/** The clone address is derived from the org + repo NAME, never taken from GitHub's `html_url`. */
+const SAFE_NAME = /^[A-Za-z0-9._-]+$/;
+export const orgRepoUrl = (fullName) => `https://github.com/${fullName}.git`;
+async function readRepo(r, prev) {
+    const problems = [];
+    let latest = null;
+    const rel = await tryJson(`/repos/${r.full_name}/releases/latest`);
+    if (rel?.tag_name) {
+        latest = { kind: "tag", ref: rel.tag_name, ...(rel.body ? { notes: rel.body } : {}) };
+    }
+    else if (r.default_branch) {
+        const head = await tryJson(`/repos/${r.full_name}/commits/${encodeURIComponent(r.default_branch)}`);
+        if (head?.sha)
+            latest = { kind: "branch", ref: r.default_branch, commit: head.sha };
+    }
+    // The same release (or branch head) as the cached check: the manifest and package.json are not read again.
+    if (prev && latest && prev.latest && prev.latest.kind === latest.kind && prev.latest.ref === latest.ref && prev.latest.commit === latest.commit && !prev.problems.some((p) => p.startsWith("no "))) {
+        return { ...prev, url: orgRepoUrl(r.full_name), latest: { ...latest }, ...(prev.description === "" && r.description ? { description: r.description } : {}) };
+    }
+    let id;
+    let name = r.name, description = r.description ?? "";
+    let maturity = pluginMaturity(null).level;
+    if (!latest) {
+        problems.push("the repo has no release and no readable default branch");
+    }
+    else {
+        const ref = latest.ref;
+        const mtext = await ghRaw(r.full_name, ref, BRAND.pluginManifest);
+        if (mtext === null) {
+            problems.push(`no ${BRAND.pluginManifest} at ${ref}`);
+        }
+        else {
+            let m = null;
+            try {
+                m = JSON.parse(mtext);
+            }
+            catch {
+                problems.push(`${BRAND.pluginManifest} at ${ref} is not valid JSON`);
+            }
+            if (m) {
+                problems.push(...manifestProblems(m));
+                const o = m;
+                if (typeof o.id === "string")
+                    id = o.id;
+                if (typeof o.name === "string" && o.name.trim())
+                    name = o.name;
+                if (typeof o.description === "string" && o.description)
+                    description = o.description;
+                maturity = pluginMaturity(o).level;
+            }
+        }
+        const ptext = await ghRaw(r.full_name, ref, "package.json");
+        if (ptext !== null) {
+            try {
+                const deps = JSON.parse(ptext).dependencies;
+                const names = deps && typeof deps === "object" ? Object.keys(deps) : [];
+                if (names.length)
+                    problems.push(`it has dependencies (${names.slice(0, 4).join(", ")}${names.length > 4 ? ", …" : ""}); only plugins without dependencies can be installed`);
+            }
+            catch {
+                problems.push("package.json is not valid JSON");
+            }
+        }
+    }
+    return { repo: r.full_name, url: orgRepoUrl(r.full_name), name, description, maturity, latest, problems, ...(id ? { id } : {}) };
+}
+/** Read the org. Throws `GithubError` on any transport or rate-limit failure. */
+export async function fetchCatalog(org = BRAND.githubOrg, prev = []) {
+    const repos = await ghJson(`/orgs/${encodeURIComponent(org)}/repos?per_page=100&type=public`);
+    if (!Array.isArray(repos))
+        throw new GithubError("GitHub sent a repo list this host does not understand", null);
+    const mine = repos.filter((x) => isPublic(x) && Array.isArray(x.topics) && x.topics.includes(PLUGIN_TOPIC)
+        && typeof x.full_name === "string" && x.full_name.startsWith(`${org}/`) && SAFE_NAME.test(x.full_name.slice(org.length + 1)));
+    // A small pool: the sequential walk was ~4 calls a repo one after the other; three at a time keeps the
+    // check short without a burst against the 60-an-hour allowance.
+    const out = new Array(mine.length);
+    let next = 0;
+    const worker = async () => { for (let i = next++; i < mine.length; i = next++)
+        out[i] = await readRepo(mine[i], prev.find((p) => p.repo === mine[i].full_name)); };
+    await Promise.all(Array.from({ length: Math.min(3, mine.length) }, worker));
+    return out.sort((a, b) => a.name.localeCompare(b.name));
+}
+const repoSlug = (url) => url.replace(/^https?:\/\/github\.com\//i, "").replace(/\.git$/, "").replace(/\/+$/, "").toLowerCase();
+/** Join with what is installed: by manifest id, else by the install record's URL. Cheap and pure — redone on every read. */
+export function joinInstalled(raw, installed) {
+    return raw.map(({ id, ...e }) => {
+        const hit = installed.find((i) => (id !== undefined && i.id === id)) ?? installed.find((i) => i.url && repoSlug(i.url) === e.repo.toLowerCase());
+        const problems = [...e.problems];
+        let inst = null;
+        if (hit) {
+            const { url: _u, ...rest } = hit;
+            inst = rest;
+            if (hit.source === "manager" && hit.url && repoSlug(hit.url) !== e.repo.toLowerCase()) {
+                problems.push(`the id "${hit.id}" is already installed from ${repoSlug(hit.url)}`);
+            }
+        }
+        return { ...e, problems, installed: inst, fromOrg: isOrgUrl(e.url) };
+    });
+}
+//# sourceMappingURL=catalog.js.map

package/packages/host/dist/updates/catalog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog.js","sourceRoot":"","sources":["../../src/updates/catalog.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAE,KAAK,EAAE,YAAY,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAE3F,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAEzD,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAUvC,MAAM,QAAQ,GAAG,CAAC,CAAU,EAAW,EAAE,CAAC,CAAC,CAAC,OAAO,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,UAAU,KAAK,SAAS,IAAI,CAAC,CAAC,UAAU,KAAK,QAAQ,CAAC,CAAC;AAE1H,KAAK,UAAU,OAAO,CAAI,IAAY;IACpC,IAAI,CAAC;QAAC,OAAO,MAAM,MAAM,CAAI,IAAI,CAAC,CAAC;IAAC,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QAAC,IAAI,CAAC,YAAY,WAAW,IAAI,CAAC,CAAC,MAAM,KAAK,GAAG;YAAE,OAAO,IAAI,CAAC;QAAC,MAAM,CAAC,CAAC;IAAC,CAAC;AAC7H,CAAC;AAED,mGAAmG;AACnG,MAAM,SAAS,GAAG,mBAAmB,CAAC;AACtC,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,QAAgB,EAAU,EAAE,CAAC,sBAAsB,QAAQ,MAAM,CAAC;AAE7F,KAAK,UAAU,QAAQ,CAAC,CAAU,EAAE,IAAsB;IACxD,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,IAAI,MAAM,GAAyB,IAAI,CAAC;IACxC,MAAM,GAAG,GAAG,MAAM,OAAO,CAA8C,UAAU,CAAC,CAAC,SAAS,kBAAkB,CAAC,CAAC;IAChH,IAAI,GAAG,EAAE,QAAQ,EAAE,CAAC;QAClB,MAAM,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,CAAC,QAAQ,EAAE,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;IACxF,CAAC;SAAM,IAAI,CAAC,CAAC,cAAc,EAAE,CAAC;QAC5B,MAAM,IAAI,GAAG,MAAM,OAAO,CAAmB,UAAU,CAAC,CAAC,SAAS,YAAY,kBAAkB,CAAC,CAAC,CAAC,cAAc,CAAC,EAAE,CAAC,CAAC;QACtH,IAAI,IAAI,EAAE,GAAG;YAAE,MAAM,GAAG,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC,CAAC,cAAc,EAAE,MAAM,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC;IACtF,CAAC;IACD,2GAA2G;IAC3G,IAAI,IAAI,IAAI,MAAM,IAAI,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,MAAM,CAAC,IAAI,KAAK,MAAM,CAAC,IAAI,IAAI,IAAI,CAAC,MAAM,CAAC,GAAG,KAAK,MAAM,CAAC,GAAG,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,KAAK,MAAM,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC;QACnM,OAAO,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,EAAE,GAAG,MAAM,EAAE,EAAE,GAAG,CAAC,IAAI,CAAC,WAAW,KAAK,EAAE,IAAI,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;IAC/J,CAAC;IACD,IAAI,EAAsB,CAAC;IAC3B,IAAI,IAAI,GAAG,CAAC,CAAC,IAAI,EAAE,WAAW,GAAG,CAAC,CAAC,WAAW,IAAI,EAAE,CAAC;IACrD,IAAI,QAAQ,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC;IAC1C,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,QAAQ,CAAC,IAAI,CAAC,wDAAwD,CAAC,CAAC;IAC1E,CAAC;SAAM,CAAC;QACN,MAAM,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC;QACvB,MAAM,KAAK,GAAG,MAAM,KAAK,CAAC,CAAC,CAAC,SAAS,EAAE,GAAG,EAAE,KAAK,CAAC,cAAc,CAAC,CAAC;QAClE,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;YACnB,QAAQ,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,cAAc,OAAO,GAAG,EAAE,CAAC,CAAC;QACxD,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,GAAY,IAAI,CAAC;YACtB,IAAI,CAAC;gBAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YAAC,CAAC;YAAC,MAAM,CAAC;gBAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,cAAc,OAAO,GAAG,oBAAoB,CAAC,CAAC;YAAC,CAAC;YAC9G,IAAI,CAAC,EAAE,CAAC;gBACN,QAAQ,CAAC,IAAI,CAAC,GAAG,gBAAgB,CAAC,CAAC,CAAC,CAAC,CAAC;gBACtC,MAAM,CAAC,GAAG,CAA4B,CAAC;gBACvC,IAAI,OAAO,CAAC,CAAC,EAAE,KAAK,QAAQ;oBAAE,EAAE,GAAG,CAAC,CAAC,EAAE,CAAC;gBACxC,IAAI,OAAO,CAAC,CAAC,IAAI,KAAK,QAAQ,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE;oBAAE,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC;gBAC/D,IAAI,OAAO,CAAC,CAAC,WAAW,KAAK,QAAQ,IAAI,CAAC,CAAC,WAAW;oBAAE,WAAW,GAAG,CAAC,CAAC,WAAW,CAAC;gBACpF,QAAQ,GAAG,cAAc,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;YACrC,CAAC;QACH,CAAC;QACD,MAAM,KAAK,GAAG,MAAM,KAAK,CAAC,CAAC,CAAC,SAAS,EAAE,GAAG,EAAE,cAAc,CAAC,CAAC;QAC5D,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;YACnB,IAAI,CAAC;gBACH,MAAM,IAAI,GAAI,IAAI,CAAC,KAAK,CAAC,KAAK,CAAgC,CAAC,YAAY,CAAC;gBAC5E,MAAM,KAAK,GAAG,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;gBACxE,IAAI,KAAK,CAAC,MAAM;oBAAE,QAAQ,CAAC,IAAI,CAAC,wBAAwB,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,uDAAuD,CAAC,CAAC;YAC/K,CAAC;YAAC,MAAM,CAAC;gBAAC,QAAQ,CAAC,IAAI,CAAC,gCAAgC,CAAC,CAAC;YAAC,CAAC;QAC9D,CAAC;IACH,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,SAAS,EAAE,GAAG,EAAE,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;AACnI,CAAC;AAED,iFAAiF;AACjF,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,MAAc,KAAK,CAAC,SAAS,EAAE,OAAmC,EAAE;IACrG,MAAM,KAAK,GAAG,MAAM,MAAM,CAAY,SAAS,kBAAkB,CAAC,GAAG,CAAC,iCAAiC,CAAC,CAAC;IACzG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,MAAM,IAAI,WAAW,CAAC,uDAAuD,EAAE,IAAI,CAAC,CAAC;IAChH,MAAM,IAAI,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,YAAY,CAAC;WACrG,OAAO,CAAC,CAAC,SAAS,KAAK,QAAQ,IAAI,CAAC,CAAC,SAAS,CAAC,UAAU,CAAC,GAAG,GAAG,GAAG,CAAC,IAAI,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IAChI,uGAAuG;IACvG,gEAAgE;IAChE,MAAM,GAAG,GAAsB,IAAI,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACtD,IAAI,IAAI,GAAG,CAAC,CAAC;IACb,MAAM,MAAM,GAAG,KAAK,IAAI,EAAE,GAAG,KAAK,IAAI,CAAC,GAAG,IAAI,EAAE,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,GAAG,IAAI,EAAE;QAAE,GAAG,CAAC,CAAC,CAAC,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAE,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC,CAAE,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACrK,MAAM,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC,CAAC;IAC5E,OAAO,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;AAC1D,CAAC;AAED,MAAM,QAAQ,GAAG,CAAC,GAAW,EAAU,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,4BAA4B,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;AAEhJ,4HAA4H;AAC5H,MAAM,UAAU,aAAa,CAAC,GAA+B,EAAE,SAAsC;IACnG,OAAO,GAAG,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,GAAG,CAAC,EAAE,EAAE,EAAE;QAC9B,MAAM,GAAG,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,SAAS,IAAI,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,IAAI,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,IAAI,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;QACjJ,MAAM,QAAQ,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC;QACjC,IAAI,IAAI,GAA2B,IAAI,CAAC;QACxC,IAAI,GAAG,EAAE,CAAC;YACR,MAAM,EAAE,GAAG,EAAE,EAAE,EAAE,GAAG,IAAI,EAAE,GAAG,GAAG,CAAC;YACjC,IAAI,GAAG,IAAI,CAAC;YACZ,IAAI,GAAG,CAAC,MAAM,KAAK,SAAS,IAAI,GAAG,CAAC,GAAG,IAAI,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;gBACtF,QAAQ,CAAC,IAAI,CAAC,WAAW,GAAG,CAAC,EAAE,+BAA+B,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YACrF,CAAC;QACH,CAAC;QACD,OAAO,EAAE,GAAG,CAAC,EAAE,QAAQ,EAAE,SAAS,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC;IACvE,CAAC,CAAC,CAAC;AACL,CAAC"}

package/packages/host/dist/updates/checker.d.ts

@@ -0,0 +1,73 @@
+import type { CatalogLatest, UpdatesLastApply, UpdatesStatus } from "@waterplane/shared";
+import type { RawCatalogEntry } from "./catalog.js";
+import type { InstalledWithUrl } from "./installrecord.js";
+import type { SelfDeps } from "./self.js";
+export declare const CHECK_FLOOR_MS: number;
+/** After a FAILED attempt the floor is short: a person who fixed their network and taps "check now" gets a real check. */
+export declare const CHECK_FLOOR_FAILED_MS = 30000;
+export declare const CHECK_EVERY_MS: number;
+export declare const FIRST_CHECK_DELAY_MS: number;
+export declare const UPDATES_FILE = "updates.json";
+export interface CheckerDeps {
+    /** `hostStateDir(root)`: the cache lives at `<stateDir>/updates.json`. */
+    stateDir: string;
+    installed: () => InstalledWithUrl[];
+    /** The synced `updates.autoCheck` setting (default on). */
+    autoCheck: () => boolean;
+    onChange: (status: UpdatesStatus) => void;
+    /** `prev` = the cached catalogue, so an unchanged release is not re-read. */
+    fetchCatalog?: (prev: readonly RawCatalogEntry[]) => Promise<RawCatalogEntry[]>;
+    /** Newest at a repo outside the org catalogue; default `remote.ts`. */
+    remoteLatest?: (url: string) => Promise<CatalogLatest>;
+    self?: SelfDeps;
+    now?: () => number;
+    firstDelayMs?: number;
+}
+export declare const OFF_SENTENCE: string;
+/** `WATERPLANE_UPDATE_CHECK=0` forces every check off, the daily one and a tap alike. */
+export declare const checkForcedOff: () => boolean;
+/** The synced setting's stored string → on/off; anything unreadable is the default, on. */
+export declare function autoCheckFrom(raw: unknown): boolean;
+export declare class UpdatesChecker {
+    private deps;
+    private cache;
+    private timer;
+    private running;
+    private readonly path;
+    private readonly self;
+    private readonly now;
+    constructor(deps: CheckerDeps);
+    /** The cached reading, with "installed" joined fresh. Never touches the network. */
+    status(): UpdatesStatus;
+    /** When a manual check is next allowed, or null when it is allowed now. A failed attempt waits less than an ok one. */
+    private nextManualCheckAt;
+    /**
+     * The org catalogue joined with what is installed, plus one row for every manager install that is
+     * NOT in it (installed by URL): `source: "manager"`, its `latest` from the cached remote check, or
+     * null with a sentence saying why.
+     */
+    private catalogRows;
+    /** Daily timer: the first run a few minutes after boot (later if the cache is fresh), then every 24 h. */
+    start(): void;
+    stop(): void;
+    /** Broadcast `status()` again (an apply changed what is installed; no network, no floor). */
+    refresh(): void;
+    /** Record the receipt of an apply/rollback (P3), kept across a restart. */
+    setLastResult(r: {
+        ok: boolean;
+        message: string;
+    }): void;
+    /** Record the outcome of ANY apply (plugin install/update, self, restart); persisted and broadcast with the status. */
+    setLastApply(r: Omit<UpdatesLastApply, "at">): void;
+    /**
+     * Check now. Resolves true when a check RAN (its outcome was broadcast through `onChange`), false
+     * when none did — switched off, inside the floor (10 min after an ok attempt, 30 s after a failed one; manual only), or one already running —
+     * so the caller can answer the asker from `status()` itself.
+     */
+    check(opts?: {
+        timer?: boolean;
+    }): Promise<boolean>;
+    /** Each URL-installed plugin the org catalogue does not hold: one failure is that row's sentence, never the check's. */
+    private checkRemotes;
+    private persist;
+}