charness 3.3.1 → 3.4.0

package/dist/selfUpdate/selfCheck.js

@@ -0,0 +1,126 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.listImportableModules = listImportableModules;
+exports.runSelfCheck = runSelfCheck;
+exports.runSelfCheckCli = runSelfCheckCli;
+const child_process_1 = require("child_process");
+const fs = __importStar(require("fs"));
+const os = __importStar(require("os"));
+const path = __importStar(require("path"));
+/**
+ * `charness self-check [--expect <version>]` — what the updater runs on a NEW install before it switches to it: does this
+ * install start at all? It reads the package version, loads `node-pty`'s native binding, imports the whole built module graph
+ * (so a missing file or dependency fails here, not in the running bot) and syntax-checks the one module it cannot import —
+ * `bot.js` reads its settings at module scope and exits the process without them. Hidden: it is not in `--help`.
+ */
+/** Entry points: importing one starts something (the CLI, the bot, the install job). */
+const entryModules = new Set(['cli.js', 'index.js', 'bot.js', 'cli/botEntry.js', 'stt/sttInstallEntry.js']);
+const testsFolderName = '__tests__';
+const botModule = 'bot.js';
+const syntaxCheckTimeoutMs = 30 * 1000;
+/** @description The built modules a self-check imports: every `.js` under `dist/` except entry points and tests, relative paths. */
+function listImportableModules(distDirectory) {
+    return fs
+        .readdirSync(distDirectory, { recursive: true, encoding: 'utf8' })
+        .map((entry) => entry.split(path.sep).join('/'))
+        .filter((entry) => entry.endsWith('.js') && !entry.split('/').includes(testsFolderName) && !entryModules.has(entry))
+        .sort();
+}
+function readPackageVersion(packageRoot) {
+    const manifest = JSON.parse(fs.readFileSync(path.join(packageRoot, 'package.json'), 'utf8'));
+    return manifest.version;
+}
+/**
+ * @description Check the install at `packageRoot` (the folder holding `package.json` and `dist/`). Importing the modules
+ * may resolve paths under `DATA_DIR` at import time, so the check runs with a throwaway one and removes it.
+ * `loadNativeBinding` loads `node-pty` (a parameter so a test can make it fail).
+ */
+async function runSelfCheck(packageRoot, expectVersion, loadNativeBinding = () => Promise.resolve().then(() => __importStar(require('node-pty')))) {
+    const problems = [];
+    const version = readPackageVersion(packageRoot);
+    if (expectVersion !== null && version !== expectVersion) {
+        problems.push(`the package says ${version}, expected ${expectVersion}`);
+    }
+    try {
+        await loadNativeBinding();
+    }
+    catch (error) {
+        problems.push(`node-pty does not load: ${error instanceof Error ? error.message : String(error)}`);
+    }
+    const distDirectory = path.join(packageRoot, 'dist');
+    const botPath = path.join(distDirectory, botModule);
+    try {
+        (0, child_process_1.execFileSync)(process.execPath, ['--check', botPath], { stdio: 'pipe', timeout: syntaxCheckTimeoutMs });
+    }
+    catch (error) {
+        problems.push(`${botModule} does not pass node --check: ${error instanceof Error ? error.message : String(error)}`);
+    }
+    const throwawayDataDir = fs.mkdtempSync(path.join(os.tmpdir(), 'charness-selfcheck-'));
+    const previousDataDir = process.env.DATA_DIR;
+    process.env.DATA_DIR = throwawayDataDir;
+    try {
+        for (const modulePath of listImportableModules(distDirectory)) {
+            try {
+                require(path.join(distDirectory, modulePath));
+            }
+            catch (error) {
+                problems.push(`${modulePath} does not load: ${error instanceof Error ? error.message : String(error)}`);
+            }
+        }
+    }
+    finally {
+        if (previousDataDir === undefined)
+            delete process.env.DATA_DIR;
+        else
+            process.env.DATA_DIR = previousDataDir;
+        fs.rmSync(throwawayDataDir, { recursive: true, force: true });
+    }
+    return { version, problems };
+}
+/**
+ * @description The CLI face: version on stdout, every problem on stderr, exit 1 when there is one. `packageRoot` is the
+ * folder this module's own `dist/` belongs to.
+ */
+async function runSelfCheckCli(args, packageRoot) {
+    const expectIndex = args.indexOf('--expect');
+    const expectVersion = expectIndex === -1 ? null : (args[expectIndex + 1] ?? null);
+    const result = await runSelfCheck(packageRoot, expectVersion);
+    process.stdout.write(`${result.version}\n`);
+    for (const problem of result.problems)
+        process.stderr.write(`self-check: ${problem}\n`);
+    return result.problems.length === 0 ? 0 : 1;
+}
+//# sourceMappingURL=selfCheck.js.map

package/dist/selfUpdate/selfCheck.js.map

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

package/dist/selfUpdate/semver.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Just enough semver for the update decisions — parse, compare, and the range forms `engines.node` uses. No
+ * dependency: the full `semver` package is not one of ours, and none of these forms is exotic.
+ */
+export interface SemVer {
+    major: number;
+    minor: number;
+    patch: number;
+    prerelease: string[];
+}
+/** @description `3.4.0`, `v3.4.0`, `3.5.0-beta.1` → its parts; null for anything else (`3.4`, `latest`). */
+export declare function parseSemVer(text: string): SemVer | null;
+export declare function checkIsPrerelease(version: SemVer): boolean;
+/** @description -1 / 0 / 1; a prerelease sorts below its release, identifiers compare as semver says. */
+export declare function compareSemVer(left: SemVer, right: SemVer): number;
+/** @description `compareSemVer` on two version texts; null when either is not a version. */
+export declare function compareVersionTexts(left: string, right: string): number | null;
+/**
+ * @description Whether `version` satisfies an npm range: comparators (`>=22.12`, `<25`), `^`, `~`, `x` ranges
+ * (`22.x`), joined by spaces (and) and `||` (or). An empty range accepts everything; null when the range cannot be
+ * read, so the caller can tell "no" from "unknown" — a version is never refused over a range we cannot parse.
+ */
+export declare function checkSatisfiesRange(version: SemVer, range: string): boolean | null;
+//# sourceMappingURL=semver.d.ts.map

package/dist/selfUpdate/semver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"semver.d.ts","sourceRoot":"","sources":["../../src/selfUpdate/semver.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,MAAM;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAMD,4GAA4G;AAC5G,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CASvD;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAE1D;AAWD,yGAAyG;AACzG,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAajE;AAED,4FAA4F;AAC5F,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAI9E;AA8ED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI,CAiBlF"}

package/dist/selfUpdate/semver.js

@@ -0,0 +1,165 @@
+"use strict";
+/**
+ * Just enough semver for the update decisions — parse, compare, and the range forms `engines.node` uses. No
+ * dependency: the full `semver` package is not one of ours, and none of these forms is exotic.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseSemVer = parseSemVer;
+exports.checkIsPrerelease = checkIsPrerelease;
+exports.compareSemVer = compareSemVer;
+exports.compareVersionTexts = compareVersionTexts;
+exports.checkSatisfiesRange = checkSatisfiesRange;
+const versionPattern = /^v?(\d+)\.(\d+)\.(\d+)(?:-([0-9A-Za-z.-]+))?(?:\+[0-9A-Za-z.-]+)?$/;
+const comparatorPattern = /^(>=|<=|>|<|=|\^|~)?\s*v?(\d+|[xX*])(?:\.(\d+|[xX*]))?(?:\.(\d+|[xX*]))?(?:-([0-9A-Za-z.-]+))?$/;
+const wildcardPattern = /^[xX*]$/;
+/** @description `3.4.0`, `v3.4.0`, `3.5.0-beta.1` → its parts; null for anything else (`3.4`, `latest`). */
+function parseSemVer(text) {
+    const match = versionPattern.exec(text.trim());
+    if (!match)
+        return null;
+    return {
+        major: Number(match[1]),
+        minor: Number(match[2]),
+        patch: Number(match[3]),
+        prerelease: match[4] ? match[4].split('.') : [],
+    };
+}
+function checkIsPrerelease(version) {
+    return version.prerelease.length > 0;
+}
+function comparePrereleaseIdentifier(left, right) {
+    const isLeftNumeric = /^\d+$/.test(left);
+    const isRightNumeric = /^\d+$/.test(right);
+    if (isLeftNumeric && isRightNumeric)
+        return Math.sign(Number(left) - Number(right));
+    if (isLeftNumeric)
+        return -1;
+    if (isRightNumeric)
+        return 1;
+    return left < right ? -1 : left > right ? 1 : 0;
+}
+/** @description -1 / 0 / 1; a prerelease sorts below its release, identifiers compare as semver says. */
+function compareSemVer(left, right) {
+    for (const field of ['major', 'minor', 'patch']) {
+        if (left[field] !== right[field])
+            return Math.sign(left[field] - right[field]);
+    }
+    if (left.prerelease.length === 0 && right.prerelease.length === 0)
+        return 0;
+    if (left.prerelease.length === 0)
+        return 1;
+    if (right.prerelease.length === 0)
+        return -1;
+    const shared = Math.min(left.prerelease.length, right.prerelease.length);
+    for (let index = 0; index < shared; index += 1) {
+        const result = comparePrereleaseIdentifier(left.prerelease[index], right.prerelease[index]);
+        if (result !== 0)
+            return result;
+    }
+    return Math.sign(left.prerelease.length - right.prerelease.length);
+}
+/** @description `compareSemVer` on two version texts; null when either is not a version. */
+function compareVersionTexts(left, right) {
+    const leftVersion = parseSemVer(left);
+    const rightVersion = parseSemVer(right);
+    return leftVersion && rightVersion ? compareSemVer(leftVersion, rightVersion) : null;
+}
+function createVersion(major, minor, patch, prerelease = []) {
+    return { major, minor, patch, prerelease };
+}
+/** A comparator such as `^20.17`, `~22.1`, `22.x`, `>=22.12` as the bounds it means; null when unreadable. */
+function getComparatorBounds(text) {
+    const match = comparatorPattern.exec(text);
+    if (!match)
+        return null;
+    const [, operator = '', majorText, minorText, patchText, prerelease] = match;
+    if (wildcardPattern.test(majorText))
+        return operator === '' || operator === '=' ? [] : null;
+    const major = Number(majorText);
+    const isMinorOpen = minorText === undefined || wildcardPattern.test(minorText);
+    const minor = isMinorOpen ? 0 : Number(minorText);
+    const isPatchOpen = patchText === undefined || wildcardPattern.test(patchText);
+    const patch = isPatchOpen ? 0 : Number(patchText);
+    const base = createVersion(major, minor, patch, prerelease ? prerelease.split('.') : []);
+    switch (operator) {
+        case '>=':
+            return [{ op: '>=', version: base }];
+        case '>':
+            return isMinorOpen
+                ? [{ op: '>=', version: createVersion(major + 1, 0, 0) }]
+                : isPatchOpen
+                    ? [{ op: '>=', version: createVersion(major, minor + 1, 0) }]
+                    : [{ op: '>', version: base }];
+        case '<=':
+            return isMinorOpen
+                ? [{ op: '<', version: createVersion(major + 1, 0, 0) }]
+                : isPatchOpen
+                    ? [{ op: '<', version: createVersion(major, minor + 1, 0) }]
+                    : [{ op: '<=', version: base }];
+        case '<':
+            return [{ op: '<', version: base }];
+        case '^': {
+            // Same left-most non-zero part: ^1.2.3 → <2.0.0, ^0.2.3 → <0.3.0, ^0.0.3 → <0.0.4.
+            const upper = major > 0 || isMinorOpen
+                ? createVersion(major + 1, 0, 0)
+                : minor > 0 || isPatchOpen
+                    ? createVersion(0, minor + 1, 0)
+                    : createVersion(0, 0, patch + 1);
+            return [{ op: '>=', version: base }, { op: '<', version: upper }];
+        }
+        case '~': {
+            const upper = isMinorOpen ? createVersion(major + 1, 0, 0) : createVersion(major, minor + 1, 0);
+            return [{ op: '>=', version: base }, { op: '<', version: upper }];
+        }
+        default: {
+            if (isMinorOpen)
+                return [{ op: '>=', version: base }, { op: '<', version: createVersion(major + 1, 0, 0) }];
+            if (isPatchOpen)
+                return [{ op: '>=', version: base }, { op: '<', version: createVersion(major, minor + 1, 0) }];
+            return [{ op: '>=', version: base }, { op: '<=', version: base }];
+        }
+    }
+}
+function checkSatisfiesBound(version, bound) {
+    const result = compareSemVer(version, bound.version);
+    switch (bound.op) {
+        case '>=':
+            return result >= 0;
+        case '>':
+            return result > 0;
+        case '<=':
+            return result <= 0;
+        default:
+            return result < 0;
+    }
+}
+/** Joins a lone operator to the version that follows it (`>= 22.12` → `>=22.12`). */
+function splitComparators(clause) {
+    return clause.replace(/(>=|<=|>|<|=|\^|~)\s+/g, '$1').split(/\s+/).filter((part) => part !== '');
+}
+/**
+ * @description Whether `version` satisfies an npm range: comparators (`>=22.12`, `<25`), `^`, `~`, `x` ranges
+ * (`22.x`), joined by spaces (and) and `||` (or). An empty range accepts everything; null when the range cannot be
+ * read, so the caller can tell "no" from "unknown" — a version is never refused over a range we cannot parse.
+ */
+function checkSatisfiesRange(version, range) {
+    if (range.trim() === '')
+        return true;
+    let isUnreadable = false;
+    const isAnyClauseSatisfied = range.split('||').some((clause) => {
+        const bounds = [];
+        for (const comparator of splitComparators(clause.trim())) {
+            const comparatorBounds = getComparatorBounds(comparator);
+            if (comparatorBounds === null) {
+                isUnreadable = true;
+                return false;
+            }
+            bounds.push(...comparatorBounds);
+        }
+        return bounds.every((bound) => checkSatisfiesBound(version, bound));
+    });
+    if (isAnyClauseSatisfied)
+        return true;
+    return isUnreadable ? null : false;
+}
+//# sourceMappingURL=semver.js.map

package/dist/selfUpdate/semver.js.map

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

package/dist/selfUpdate/types.d.ts

@@ -0,0 +1,51 @@
+/** What the last check of the update engine saw — the raw observation `/update` and the policy are computed from. */
+export type UpdateObservation = {
+    kind: 'npm';
+    latestVersion: string;
+    engines: string | null;
+    isDeprecated: boolean;
+} | {
+    kind: 'git';
+    status: GitCheckStatus;
+    reason: GitSkipReason | null;
+    from: string;
+    to: string;
+    behind: number;
+    migrationGuides: string[];
+} | {
+    kind: 'error';
+    reason: string;
+};
+export type GitCheckStatus = 'upToDate' | 'behind' | 'skip';
+/** Why `self-update.sh --check` leaves a checkout alone. */
+export type GitSkipReason = 'dirty' | 'diverged' | 'noUpstream' | 'inProgress' | 'fetchFailed';
+export interface SelfUpdateLastResult {
+    /** Epoch ms of the check. */
+    at: number;
+    observation: UpdateObservation;
+}
+/**
+ * The update engine's bookkeeping, persisted in `state.json` (`selfUpdate`). Targets are an npm version or a
+ * checkout's target commit.
+ */
+export interface SelfUpdateRecord {
+    /** When the last check ran, so a restart does not multiply checks. */
+    lastCheckAt?: number;
+    /** npm: when this bot FIRST saw each version — the hold counts from it. */
+    firstSeenAt?: Record<string, number>;
+    /** Targets whose install failed: never retried by itself, a newer target is tried. */
+    failedTargets?: string[];
+    /** Targets already announced (notify, offer, "needs Node"): one message per target. */
+    notifiedTargets?: string[];
+    lastResult?: SelfUpdateLastResult;
+    /** True after a check failed and until one succeeds — so a failing registry is announced once. */
+    isCheckFailing?: boolean;
+    /** The one-time "Automatic updates are on" message was posted. */
+    isFeatureAnnounced?: boolean;
+}
+/** The version (and, for a checkout, the commit) the bot ran at its previous boot. */
+export interface LastRunVersion {
+    version: string;
+    commit: string | null;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/selfUpdate/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/selfUpdate/types.ts"],"names":[],"mappings":"AAAA,qHAAqH;AACrH,MAAM,MAAM,iBAAiB,GACzB;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,aAAa,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,YAAY,EAAE,OAAO,CAAA;CAAE,GACrF;IACE,IAAI,EAAE,KAAK,CAAC;IACZ,MAAM,EAAE,cAAc,CAAC;IACvB,MAAM,EAAE,aAAa,GAAG,IAAI,CAAC;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,eAAe,EAAE,MAAM,EAAE,CAAC;CAC3B,GACD;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAEtC,MAAM,MAAM,cAAc,GAAG,UAAU,GAAG,QAAQ,GAAG,MAAM,CAAC;AAE5D,4DAA4D;AAC5D,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,UAAU,GAAG,YAAY,GAAG,YAAY,GAAG,aAAa,CAAC;AAE/F,MAAM,WAAW,oBAAoB;IACnC,6BAA6B;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,iBAAiB,CAAC;CAChC;AAED;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,sEAAsE;IACtE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,2EAA2E;IAC3E,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACrC,sFAAsF;IACtF,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,uFAAuF;IACvF,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,UAAU,CAAC,EAAE,oBAAoB,CAAC;IAClC,kGAAkG;IAClG,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,kEAAkE;IAClE,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B;AAED,sFAAsF;AACtF,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB"}

package/dist/selfUpdate/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/selfUpdate/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/selfUpdate/types.ts"],"names":[],"mappings":""}

package/dist/selfUpdate/updateEngine.d.ts

@@ -0,0 +1,110 @@
+import { type GitSource } from './gitSource';
+import type { HostLock } from './hostLock';
+import { type ReexecTarget } from './restart';
+import type { HotSupervisorRecord, SupervisorSignalResult } from './hotSupervisor';
+import { type InstallKind } from './installKind';
+import { type NpmSource } from './npmSource';
+import type { LastRunVersion, SelfUpdateRecord, UpdateObservation } from './types';
+import type { UpdateMessage } from './updateMessages';
+import type { UpdateSettings } from './updateModes';
+import type { UpdatePendingMarker } from './updatePending';
+import { type IdleVerdict } from './updatePolicy';
+/** What `setTimer` hands back: a Node timer, or any number a fake clock uses. */
+export type TimerHandle = number | NodeJS.Timeout;
+export interface UpdateEngineDeps {
+    now: () => number;
+    setTimer: (callback: () => void, delayMs: number) => TimerHandle;
+    clearTimer: (handle: TimerHandle) => void;
+    log: (line: string) => void;
+    /** Read at every use: a hand edit of `settings.json` applies at the next check. */
+    getSettings: () => UpdateSettings;
+    state: {
+        getRecord: () => SelfUpdateRecord;
+        setRecord: (record: SelfUpdateRecord) => void;
+        getLastRun: () => LastRunVersion | undefined;
+        setLastRun: (lastRun: LastRunVersion) => Promise<void>;
+    };
+    /** The version (and commit, for a checkout) this process STARTED as. */
+    running: LastRunVersion;
+    runningNode: string;
+    installKind: InstallKind;
+    isHotMode: boolean;
+    npm: NpmSource | null;
+    git: GitSource | null;
+    hostLock: {
+        acquire: () => HostLock | null;
+    } | null;
+    /** The version `package.json` on disk says now — newer than `running` after a manual `npm i -g` or another instance's install. */
+    readInstalledVersion: () => string | null;
+    /** `CHANGELOG.md` of the installed package, for the what's-new list. */
+    readInstalledChangelog: () => string | null;
+    /** Commits `from`..`to` of a checkout, for "(12 commits)"; `null` when unknown. */
+    countCommits: (from: string, to: string) => Promise<number | null>;
+    getIdleVerdict: (isUserRequested: boolean) => IdleVerdict;
+    postToGeneral: (message: UpdateMessage) => Promise<void>;
+    /** The self-check of a new install, run as a child process of it. */
+    runSelfCheck: (expectVersion: string | null) => Promise<{
+        ok: boolean;
+        detail: string;
+    }>;
+    /** Replace this process with a fresh image of the same install; never returns on success. Throws when it cannot. */
+    restartInPlace: () => Promise<void>;
+    reexecTarget: ReexecTarget;
+    marker: {
+        read: () => UpdatePendingMarker | null;
+        write: (marker: UpdatePendingMarker) => void;
+        clear: () => void;
+    };
+    supervisor: {
+        readRecord: () => HotSupervisorRecord | null;
+        getStaleModules: (record: HotSupervisorRecord) => string[];
+        requestReexec: (record: HotSupervisorRecord) => SupervisorSignalResult;
+    };
+}
+export type UpdatePhase = 'idle' | 'waitingForIdle' | 'installing' | 'restartPending';
+/** What a new version is, for the `/update` screen. */
+export interface UpdateOffer {
+    /** The npm version or the checkout's target commit. */
+    target: string;
+    action: 'waitHold' | 'installWhenIdle' | 'notify' | 'offerMajor' | 'offerBreaking' | 'needsNode' | 'skipped';
+    /** `waitHold`: when the bot may install it by itself. */
+    until: number | null;
+    required: string | null;
+    skipReason: string | null;
+    /** Whether «Update to X now» makes sense: there is something to install and this install can install it. */
+    canInstallNow: boolean;
+}
+export interface UpdateStatus {
+    running: LastRunVersion;
+    installKind: InstallKind;
+    /** Run as a hot worker (`charness hot`): the watcher, not a restart, brings an update in. */
+    isHotMode: boolean;
+    runningNode: string;
+    settings: UpdateSettings;
+    lastCheckAt: number | null;
+    observation: UpdateObservation | null;
+    isCheckFailing: boolean;
+    offer: UpdateOffer | null;
+    phase: UpdatePhase;
+    /** The target being installed or waiting to restart onto. */
+    inProgressTarget: string | null;
+}
+/**
+ * `blocked`: an update exists but cannot be installed now (a checkout with local changes, a version that needs a newer Node) — the
+ * offer on the screen says why; unlike `alreadyUpToDate`, which is for nothing to install, or for a stale button.
+ */
+export type InstallRequestResult = 'started' | 'alreadyUpToDate' | 'busy' | 'cannotInstall' | 'blocked';
+export interface UpdateEngine {
+    /** Arm the hourly check. */
+    start: () => void;
+    stop: () => void;
+    /** What a boot does about updates; call once, when Telegram is about to launch. */
+    runBootStep: () => Promise<void>;
+    /** A check that posts nothing to General (the «Check now» button, the text form) — also with `autoUpdate: off`. */
+    checkNow: () => Promise<UpdateStatus>;
+    /** «Update to X now»: skips the hold and the quiet period, still waits for running work. */
+    requestInstall: (target: string) => Promise<InstallRequestResult>;
+    getStatus: () => UpdateStatus;
+}
+export declare function createUpdateEngine(deps: UpdateEngineDeps): UpdateEngine;
+//# sourceMappingURL=updateEngine.d.ts.map

package/dist/selfUpdate/updateEngine.d.ts.map

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