@withbuddi/buddi 0.1.0-pre.40 → 0.1.0-pre.42

package/packages/install/dist/product-uninstall.js

@@ -0,0 +1,150 @@
+/**
+ * Uninstall from the product: Settings → System's "Remove buddi from this
+ * Mac" and buddi.app's buddi → Uninstall buddi…, as the supervisor serves it.
+ *
+ * Three verbs on the control socket:
+ *
+ *  - `GET /uninstall`: what goes, named for the owner (the data directory,
+ *    the keychain namespace, the background service, buddi.app).
+ *  - `POST /uninstall/backup`: the last backup, followed to the end, moved out
+ *    to `~/buddi-backups` with its envelope, and `<archive>.passphrase.txt`
+ *    (0600) written beside it. The job's report carries the six words, so the
+ *    page can show them, with Copy, before anything is deleted.
+ *  - `POST /uninstall`: the removal itself, once the owner ticked "I wrote it
+ *    down". It is `buddi uninstall --yes --no-backup --i-have-the-passphrase`
+ *    (the backup and the words are already taken care of) run by someone who
+ *    outlives this supervisor:
+ *      - buddi.app: the supervisor writes `<data>/uninstall.json` and exits
+ *        with `APP_UNINSTALL_EXIT`; the app runs the launcher's uninstall,
+ *        moves itself to the Trash and quits.
+ *      - npm: a detached launcher process (under `systemd-run --user` when
+ *        systemd runs this supervisor, so `disable --now` cannot take it with
+ *        the unit's cgroup), logging to `~/buddi-backups/uninstall-<stamp>.log`.
+ *
+ * Every effect is injected; the supervisor wires the real ones.
+ */
+import { randomUUID } from 'node:crypto';
+import path from 'node:path';
+import { passphraseFileFor, passphraseFileText } from '@buddi/core/uninstall';
+import { keptBackupsDir } from './uninstall.js';
+import { UNINSTALL_REQUEST_FILE } from './environment.js';
+/** buddi.app reads this exit status as "run the uninstall, trash yourself, quit". */
+export const APP_UNINSTALL_EXIT = 76;
+/** The file that tells buddi.app what the owner chose, beside `installation.json`. */
+export const UNINSTALL_REQUEST = UNINSTALL_REQUEST_FILE;
+/** How long a finished job keeps the six words for the page to show: as long as the plan's token. */
+export const PASSPHRASE_HELD_MS = 30 * 60_000;
+function stamp(now) {
+    return now.toISOString().replace(/[-:]/g, '').replace(/\..*$/, '').replace('T', '-');
+}
+export function createProductUninstall(deps) {
+    const jobs = new Map();
+    const sleep = deps.sleep ?? ((ms) => new Promise(resolve => setTimeout(resolve, ms)));
+    const now = deps.now ?? (() => new Date());
+    let running;
+    let removing = false;
+    const phase = (job, name, detail) => {
+        job.phase = name;
+        if (job.phases[job.phases.length - 1] !== name)
+            job.phases.push(name);
+        if (detail === undefined)
+            delete job.detail;
+        else
+            job.detail = detail;
+    };
+    const run = async (job) => {
+        const started = deps.backup.create(true);
+        if ('status' in started)
+            throw new Error(started.error);
+        for (;;) {
+            const state = deps.backup.job(started.id);
+            if (state === undefined)
+                throw new Error('the backup job went missing');
+            phase(job, 'backup', state.detail ?? state.phase);
+            if (state.finishedAt !== undefined) {
+                const name = state.report?.archive;
+                if (state.phase !== 'done' || typeof name !== 'string')
+                    throw new Error(`the last backup did not finish: ${state.error ?? 'no reason given'}`);
+                const archive = path.join(deps.backup.dir, name);
+                const kept = path.join(keptBackupsDir(deps.home), name);
+                phase(job, 'keeping', `moving it to ${keptBackupsDir(deps.home)}`);
+                await deps.move(archive, kept);
+                const envelope = archive.replace(/\.age$/, '.json');
+                if (envelope !== archive && deps.exists(envelope))
+                    await deps.move(envelope, kept.replace(/\.age$/, '.json'));
+                const report = { archive: kept };
+                if (kept.endsWith('.age')) {
+                    const phrase = await deps.backup.passphrase();
+                    const file = passphraseFileFor(kept);
+                    await deps.writePrivate(file, passphraseFileText(phrase, name));
+                    report.passphraseFile = file;
+                    report.passphrase = phrase;
+                }
+                job.report = report;
+                return;
+            }
+            await sleep(500);
+        }
+    };
+    /*
+     * The words live in a job's report only while the page needs them: until
+     * the removal starts, a new plan is asked for (the dialog opened again, or
+     * closed and reopened), or PASSPHRASE_HELD_MS after the job finished. They
+     * are in <archive>.passphrase.txt beside the archive after that.
+     */
+    const forgetWords = (job) => {
+        if (job.report?.passphrase !== undefined)
+            delete job.report.passphrase;
+    };
+    const forgetAllWords = () => { for (const job of jobs.values())
+        forgetWords(job); };
+    const expire = (job) => {
+        if (job.finishedAt !== undefined && now().getTime() - Date.parse(job.finishedAt) >= PASSPHRASE_HELD_MS)
+            forgetWords(job);
+        return job;
+    };
+    return {
+        plan() {
+            forgetAllWords();
+            return deps.plan();
+        },
+        busy: () => removing || (running !== undefined && running.finishedAt === undefined),
+        job: id => {
+            const job = jobs.get(id);
+            return job === undefined ? undefined : expire(job);
+        },
+        keepLast() {
+            if (removing)
+                return { status: 409, error: 'buddi is being removed.' };
+            if (running && running.finishedAt === undefined)
+                return running;
+            const job = { id: randomUUID(), kind: 'uninstall-backup', phase: 'starting', phases: ['starting'], startedAt: now().toISOString() };
+            jobs.set(job.id, job);
+            running = job;
+            void run(job).then(() => {
+                phase(job, 'done');
+                job.finishedAt = now().toISOString();
+                setTimeout(() => forgetWords(job), PASSPHRASE_HELD_MS).unref?.();
+            }, (error) => { job.error = error instanceof Error ? error.message : String(error); phase(job, 'failed'); job.finishedAt = now().toISOString(); });
+            return job;
+        },
+        start({ keepData }) {
+            if (removing)
+                return { status: 409, error: 'buddi is already being removed.' };
+            const kept = running?.phase === 'done' ? running.report : undefined;
+            if (kept === undefined)
+                return { status: 409, error: 'Take the last backup first: the passphrase has to be with you before anything is deleted.' };
+            removing = true;
+            forgetAllWords();
+            const args = ['uninstall', '--yes', '--no-backup', '--i-have-the-passphrase', ...(keepData ? ['--keep-data'] : [])];
+            if (deps.appFinishes) {
+                void deps.writeRequest({ keepData, at: now().toISOString() }).then(() => deps.exitForApp(), () => { removing = false; });
+            }
+            else {
+                deps.spawnUninstall(args, path.join(keptBackupsDir(deps.home), `uninstall-${stamp(now())}.log`));
+            }
+            return { status: 202 };
+        },
+    };
+}
+//# sourceMappingURL=product-uninstall.js.map

package/packages/install/dist/product-uninstall.js.map

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

package/packages/install/dist/supervisor.d.ts

@@ -1,4 +1,6 @@
 import type { Server } from 'node:http';
+import type { ProductUninstall } from './product-uninstall.js';
+import type { ShimOutcome } from './cli-shim.js';
 import type { InstallContext } from './environment.js';
 import type { BackupControl } from './backup.js';
 import type { UpgradeControl, UpgradeInProgress } from './upgrade.js';
@@ -18,6 +20,49 @@ export declare function restartDelay(failures: number): number;
  * made to. Long enough for an orderly exit, short enough that nobody notices.
  */
 export declare const HANDOVER_GRACE_MS = 5000;
+/**
+ * Set by `buddi uninstall` with the service stopped, to its own pid: the
+ * supervisor brings up the database and its control socket for the last
+ * backup, and nothing else — no gateway (no Telegram, no jobs), no scheduled
+ * backup, no version check. Any other value (a stray `1` in an env file or a
+ * plist) is ignored, so a normal service never runs without its gateway.
+ */
+export declare const BRIEF_SUPERVISOR_VAR = "BUDDI_SUPERVISE_BRIEFLY";
+/** How often a brief supervisor checks that the uninstall that started it is still there. */
+export declare const BRIEF_PARENT_POLL_MS = 3000;
+/** The longest a brief supervisor stays up, whatever happens to its parent. */
+export declare const BRIEF_MAX_MS: number;
+/**
+ * The uninstall a brief supervisor serves: the pid in `BUDDI_SUPERVISE_BRIEFLY`
+ * when it is this process's parent and alive, else undefined (a normal run).
+ */
+export declare function briefParent(env: NodeJS.ProcessEnv, ppid?: number, alive?: (pid: number) => boolean): number | undefined;
+/** `kill(pid, 0)`: is a process with this pid there (EPERM counts as there)? */
+export declare function pidAlive(pid: number): boolean;
+/**
+ * The environment `buddi uninstall` starts a brief supervisor with: its own
+ * pid as the brief marker, and without the app's command-line-tool marker,
+ * which would otherwise make the child refuse `supervise` (cli-shim.ts).
+ */
+export declare function briefSupervisorEnv(env: NodeJS.ProcessEnv, parentPid: number, shimVar: string): NodeJS.ProcessEnv;
+/**
+ * The brief supervisor's leash: every `pollMs` it asks whether the uninstall
+ * is still there, and calls `leave` once when it is gone or `maxMs` has
+ * passed — a Ctrl-C or a crash of `buddi uninstall` must not leave a database
+ * holding the lock. Returns the function that stops watching.
+ */
+export declare function watchBriefParent(options: {
+    parent: number;
+    leave: (why: string) => void;
+    alive?: (pid: number) => boolean;
+    pollMs?: number;
+    maxMs?: number;
+    now?: () => number;
+    every?: (fn: () => void, ms: number) => {
+        unref?: () => void;
+    } | number;
+    clear?: (handle: unknown) => void;
+}): () => void;
 /** What `/status` reports; the CLI prints it verbatim. */
 export interface SupervisorStatus {
     phase: string | undefined;
@@ -31,6 +76,8 @@ export interface SupervisorStatus {
     /** The installed product version, and whether it is being replaced. */
     current?: string;
     upgrading?: boolean;
+    /** A recorded port another program took, moved within the last day: the app says it once. */
+    portNotice?: string;
 }
 export interface ControlSocketOptions {
     status: () => SupervisorStatus;
@@ -41,6 +88,17 @@ export interface ControlSocketOptions {
     upgrade?: UpgradeControl | undefined;
     /** The data directory, for the one path clients may name: `<data>/incoming/`. */
     data?: string | undefined;
+    /** Uninstall from the product (product-uninstall.ts). */
+    uninstall?: ProductUninstall | undefined;
+    /** buddi.app's command line tool (cli-shim.ts); absent outside the app. */
+    cli?: {
+        status: () => {
+            available: boolean;
+            installed: string[];
+            reason?: string;
+        };
+        install: () => Promise<ShimOutcome>;
+    } | undefined;
 }
 /**
  * The maintenance API, served on a Unix domain socket in the data directory.
@@ -61,7 +119,7 @@ export interface ControlSocketOptions {
  * `<data>/incoming/`, and that is checked to be under that directory, resolved,
  * before it is passed on.
  */
-export declare function controlSocket({ status, action, backup, upgrade, data }: ControlSocketOptions): Server;
+export declare function controlSocket({ status, action, backup, upgrade, data, uninstall, cli }: ControlSocketOptions): Server;
 /**
  * Bind the control socket, replacing a stale file a killed supervisor left.
  *

package/packages/install/dist/supervisor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"supervisor.d.ts","sourceRoot":"","sources":["../src/supervisor.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAmB,MAAM,EAAkB,MAAM,WAAW,CAAC;AASzE,OAAO,KAAK,EAAE,cAAc,EAAgB,MAAM,kBAAkB,CAAC;AAErE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAIjD,OAAO,KAAK,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAMtE;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,iBAAiB,GAAG,SAAS,GAAG,iBAAiB,GAAG,SAAS,CAKnG;AAED,2EAA2E;AAC3E,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAErD;AAED,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAgE;AAEtH;;;GAGG;AACH,eAAO,MAAM,iBAAiB,OAAQ,CAAC;AAEvC,0DAA0D;AAC1D,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IACvC,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,uEAAuE;IACvE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,MAAM,gBAAgB,CAAC;IAC/B,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACxC,6EAA6E;IAC7E,MAAM,CAAC,EAAE,aAAa,GAAG,SAAS,CAAC;IACnC,0DAA0D;IAC1D,OAAO,CAAC,EAAE,cAAc,GAAG,SAAS,CAAC;IACrC,iFAAiF;IACjF,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC3B;AAiCD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,aAAa,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,oBAAoB,GAAG,MAAM,CAyKrG;AAWD;;;;;;GAMG;AACH,wBAAsB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAelF;AAED,wBAAsB,SAAS,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAsQlE"}
+{"version":3,"file":"supervisor.d.ts","sourceRoot":"","sources":["../src/supervisor.ts"],"names":[],"mappings":"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"}