terminay 4.2.0

package/dist/commands/pairing.js.map

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

package/dist/commands/uninstall.d.ts

@@ -0,0 +1,26 @@
+import type { DaemonOptions } from '../args.js';
+import type { CommandContext } from '../context.js';
+import { type PromptStreams } from '../prompt.js';
+/**
+ * `daemon uninstall` — remove the service, keep the data.
+ *
+ * The data root holds the host key, the paired device records, and whatever
+ * the operator's projects left behind. Removing it means every paired device
+ * has to pair again and anything not backed up is gone, so it survives an
+ * uninstall unless `--purge` asks for it and the operator confirms.
+ */
+export interface UninstallResult {
+    readonly removedVersions: boolean;
+    readonly removedDataRoot: boolean;
+}
+export declare class UninstallError extends Error {
+}
+export declare function runUninstall(options: DaemonOptions, context: CommandContext, streams?: PromptStreams): Promise<UninstallResult>;
+/**
+ * `daemon reset-identity` — rotate the host key and revoke every device.
+ *
+ * The server owns the rotation; the CLI only wraps it in the stop and start it
+ * requires. Confirmation is not politeness here: every paired device loses
+ * access the moment this completes.
+ */
+export declare function runResetIdentity(options: DaemonOptions, context: CommandContext, streams?: PromptStreams): Promise<boolean>;

package/dist/commands/uninstall.js

@@ -0,0 +1,70 @@
+import { rm } from 'node:fs/promises';
+import { confirm, defaultStreams, isInteractive, } from '../prompt.js';
+export class UninstallError extends Error {
+}
+export async function runUninstall(options, context, streams = defaultStreams()) {
+    const { layout, record, systemd, write } = context;
+    let purge = false;
+    if (options.purge) {
+        if (options.yes) {
+            purge = true;
+        }
+        else if (isInteractive(streams)) {
+            purge = await confirm(`Remove ${record.dataRoot} as well? Every paired device will have to pair again, and anything stored there is gone.`, streams);
+            if (!purge)
+                write('Keeping the data root.');
+        }
+        else {
+            throw new UninstallError('--purge removes the data root, so it needs --yes when there is no terminal to confirm on.');
+        }
+    }
+    // Stopped before the unit is removed, or systemd keeps supervising a
+    // service whose definition no longer exists.
+    await systemd.stop().catch(() => undefined);
+    await systemd.disable();
+    await rm(layout.unitPath, { force: true });
+    await systemd.daemonReload();
+    await systemd.resetFailed();
+    await rm(layout.versionsDirectory, { recursive: true, force: true });
+    await rm(layout.currentLink, { force: true });
+    await rm(layout.recordPath, { force: true });
+    await rm(layout.environmentFile, { force: true });
+    if (purge)
+        await rm(record.dataRoot, { recursive: true, force: true });
+    write('Terminay Server is uninstalled.');
+    write(purge
+        ? `Removed the data root at ${record.dataRoot}.`
+        : `Kept the data root at ${record.dataRoot}.`);
+    return Object.freeze({ removedVersions: true, removedDataRoot: purge });
+}
+/**
+ * `daemon reset-identity` — rotate the host key and revoke every device.
+ *
+ * The server owns the rotation; the CLI only wraps it in the stop and start it
+ * requires. Confirmation is not politeness here: every paired device loses
+ * access the moment this completes.
+ */
+export async function runResetIdentity(options, context, streams = defaultStreams()) {
+    const { record, systemd, write } = context;
+    if (!options.yes) {
+        if (!isInteractive(streams)) {
+            throw new UninstallError('resetting the identity unpairs every device, so it needs --yes when there is no terminal to confirm on.');
+        }
+        const confirmed = await confirm("Rotate this server's host key and revoke every paired device? They will all have to pair again.", streams);
+        if (!confirmed) {
+            write('Left the identity unchanged.');
+            return false;
+        }
+    }
+    await systemd.stop();
+    const { execFile } = await import('node:child_process');
+    const { promisify } = await import('node:util');
+    await promisify(execFile)(`${context.layout.currentLink}/bin/terminay-server`, ['reset-identity'], {
+        timeout: 120_000,
+        env: { ...process.env, TERMINAY_DATA_ROOT: record.dataRoot },
+    });
+    await systemd.start();
+    write('The host key is rotated and every device is revoked. Pair again with `terminay daemon qr-code`.');
+    return true;
+}
+//# sourceMappingURL=uninstall.js.map

package/dist/commands/uninstall.js.map

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

package/dist/commands/upgrade.d.ts

@@ -0,0 +1,30 @@
+import type { DaemonOptions } from '../args.js';
+import type { CommandContext } from '../context.js';
+/**
+ * `daemon upgrade` — follow the installed channel, and never leave the machine
+ * without a working server.
+ *
+ * The sequence is the one the release and update policy names: verify, stage
+ * beside the running version, stop, switch, start, wait for readiness, and on
+ * failure switch back and start what was working. The data root is never
+ * touched, so a rollback restores the previous version against the same state
+ * it was already running with.
+ */
+export interface UpgradeDependencies {
+    readonly repository?: string;
+    readonly apiBase?: string;
+    readonly webBase?: string;
+    readonly architecture?: 'x64' | 'arm64';
+    readonly readinessTimeoutMs?: number;
+    /** See `InstallDependencies.releasePublicKeyPem`: a test seam, not a bypass. */
+    readonly releasePublicKeyPem?: string;
+}
+export interface UpgradeResult {
+    readonly from: string;
+    readonly to: string;
+    readonly rolledBack: boolean;
+    readonly upToDate: boolean;
+}
+export declare class UpgradeError extends Error {
+}
+export declare function runUpgrade(ref: string | undefined, options: DaemonOptions, context: CommandContext, dependencies?: UpgradeDependencies): Promise<UpgradeResult>;

package/dist/commands/upgrade.js

@@ -0,0 +1,175 @@
+import { discardDownloads, downloadAsset, downloadBytes, downloadText, } from '../download.js';
+import { waitForReady } from '../health.js';
+import { activate, activeVersion, installArchive, retain } from '../install.js';
+import { stagedName, writeInstallRecord } from '../layout.js';
+import { hostArchitecture } from '../platform.js';
+import { resolveRef } from '../resolve.js';
+import { buildFromSource } from '../source.js';
+import { verifyArchive } from '../verify.js';
+export class UpgradeError extends Error {
+}
+/** Compare two release versions by semver precedence, ignoring prerelease tags. */
+function compareVersions(left, right) {
+    const parse = (value) => value.split(/[-+]/u, 1)[0]?.split('.').map(Number) ?? [];
+    const a = parse(left);
+    const b = parse(right);
+    for (let index = 0; index < 3; index += 1) {
+        const difference = (a[index] ?? 0) - (b[index] ?? 0);
+        if (difference !== 0)
+            return difference < 0 ? -1 : 1;
+    }
+    return 0;
+}
+export async function runUpgrade(ref, options, context, dependencies = {}) {
+    const { layout, record, systemd, write } = context;
+    // A source install has no ordering the CLI can trust — a branch tip moves
+    // without any version changing — so it must be told what to move to.
+    if (ref === undefined && record.channel === 'source') {
+        throw new UpgradeError('this server was built from source, which has no channel to follow. Name the branch, commit, or release to upgrade to.');
+    }
+    const target = ref ?? (record.channel === 'main' ? 'main' : undefined);
+    const architecture = dependencies.architecture ?? hostArchitecture();
+    const resolved = await resolveRef(target, {
+        architecture,
+        ...(dependencies.repository === undefined
+            ? {}
+            : { repository: dependencies.repository }),
+        ...(dependencies.apiBase === undefined
+            ? {}
+            : { apiBase: dependencies.apiBase }),
+        ...(dependencies.webBase === undefined
+            ? {}
+            : { webBase: dependencies.webBase }),
+    });
+    if (resolved.channel === 'tag' && record.channel === 'tag') {
+        const order = compareVersions(resolved.version, record.version);
+        if (order === 0) {
+            write(`Already on ${record.version}. Nothing to do.`);
+            return Object.freeze({
+                from: record.version,
+                to: record.version,
+                rolledBack: false,
+                upToDate: true,
+            });
+        }
+        if (order < 0 && !options.allowDowngrade) {
+            throw new UpgradeError(`refusing to move from ${record.version} down to ${resolved.version}. Pass --allow-downgrade if that is what you want.`);
+        }
+    }
+    if (resolved.channel === 'main' && record.channel === 'main') {
+        // The rolling channel reuses one version string, so the published time
+        // is the only ordering it has.
+        const published = resolved.publishedAt;
+        if (published !== undefined && record.publishedAt !== undefined) {
+            if (Date.parse(published) < Date.parse(record.publishedAt) &&
+                !options.allowDowngrade) {
+                throw new UpgradeError(`the ${resolved.channel} release published at ${published} is older than the installed one from ${record.publishedAt}. Pass --allow-downgrade to install it anyway.`);
+            }
+            if (Date.parse(published) === Date.parse(record.publishedAt)) {
+                write(`Already on the newest ${record.channel} build. Nothing to do.`);
+                return Object.freeze({
+                    from: record.version,
+                    to: record.version,
+                    rolledBack: false,
+                    upToDate: true,
+                });
+            }
+        }
+    }
+    const previous = (await activeVersion(layout)) ??
+        stagedName(record.channel, record.version, record.revision);
+    // Staged beside the running version: nothing below this point has stopped
+    // the service yet.
+    let archivePath;
+    if (resolved.channel === 'source') {
+        write(`Building ${resolved.sourceRef ?? resolved.version} from source. This takes a while.`);
+        const built = await buildFromSource({
+            ref: resolved.sourceRef ?? resolved.version,
+            ...(resolved.revision === undefined
+                ? {}
+                : { revision: resolved.revision }),
+            destination: layout.prefix,
+            write,
+        });
+        archivePath = built.archivePath;
+    }
+    else {
+        const assets = resolved.assets;
+        if (assets === undefined)
+            throw new UpgradeError('the resolved release names no archive to download');
+        write('Downloading and verifying …');
+        const asset = await downloadAsset(assets.archive, layout.prefix);
+        const [sidecar, signature] = await Promise.all([
+            downloadText(assets.sha256),
+            downloadBytes(assets.signature),
+        ]);
+        await verifyArchive({
+            archivePath: asset.path,
+            sidecar,
+            signature,
+            digest: asset.sha256,
+            ...(dependencies.releasePublicKeyPem === undefined
+                ? {}
+                : { publicKeyPem: dependencies.releasePublicKeyPem }),
+        });
+        archivePath = asset.path;
+    }
+    const installed = await installArchive({
+        layout,
+        archivePath,
+        channel: resolved.channel,
+        expected: {
+            channel: resolved.channel,
+            architecture,
+            ...(resolved.channel === 'tag' ? { version: resolved.version } : {}),
+            ...(resolved.revision === undefined
+                ? {}
+                : { revision: resolved.revision }),
+        },
+    });
+    await discardDownloads(layout.prefix);
+    if (installed.name === previous) {
+        write(`Already running ${installed.manifest.version}. Nothing to do.`);
+        return Object.freeze({
+            from: record.version,
+            to: installed.manifest.version,
+            rolledBack: false,
+            upToDate: true,
+        });
+    }
+    write(`Upgrading ${record.version} → ${installed.manifest.version} …`);
+    await systemd.stop();
+    await activate(layout, installed.name);
+    await systemd.start();
+    if ((await waitForReady(record.healthPort, dependencies.readinessTimeoutMs)) ===
+        undefined) {
+        write('The upgraded server did not report ready. Rolling back.');
+        await systemd.stop();
+        await activate(layout, previous);
+        await systemd.start();
+        const recovered = (await waitForReady(record.healthPort, dependencies.readinessTimeoutMs)) !== undefined;
+        write(await systemd.journal(20));
+        throw new UpgradeError(`the upgrade to ${installed.manifest.version} did not become ready, so ${record.version} was restored and ${recovered ? 'is running again' : 'was started, but has not reported ready either'}.`);
+    }
+    await writeInstallRecord(layout, {
+        ...record,
+        channel: resolved.channel,
+        version: installed.manifest.version,
+        revision: installed.manifest.revision,
+        ...(resolved.publishedAt === undefined
+            ? {}
+            : { publishedAt: resolved.publishedAt }),
+        installedAt: new Date().toISOString(),
+    });
+    const removed = await retain(layout, [installed.name, previous]);
+    write(`Upgraded to ${installed.manifest.version}. Kept ${previous} to roll back to.`);
+    if (removed.length > 0)
+        write(`Removed older versions: ${removed.join(', ')}.`);
+    return Object.freeze({
+        from: record.version,
+        to: installed.manifest.version,
+        rolledBack: false,
+        upToDate: false,
+    });
+}
+//# sourceMappingURL=upgrade.js.map

package/dist/commands/upgrade.js.map

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

package/dist/context.d.ts

@@ -0,0 +1,26 @@
+import type { DaemonOptions } from './args.js';
+import { type InstallLayout, type InstallRecord } from './layout.js';
+import { type Systemd } from './systemd.js';
+/**
+ * What every command after `install` needs: which installation it is acting
+ * on, and the record describing it.
+ *
+ * A machine can hold a system install and a user install at once, so a command
+ * with no scope flag looks for whichever one actually exists rather than
+ * guessing. Finding both without a flag is ambiguous and says so.
+ */
+export interface CommandContext {
+    readonly layout: InstallLayout;
+    readonly record: InstallRecord;
+    readonly systemd: Systemd;
+    readonly write: (line: string) => void;
+}
+export declare class NotInstalledError extends Error {
+}
+export interface ResolveContextOptions {
+    readonly options: DaemonOptions;
+    readonly home?: string;
+    readonly env?: Readonly<Record<string, string | undefined>>;
+    readonly write?: (line: string) => void;
+}
+export declare function resolveContext(options: ResolveContextOptions): Promise<CommandContext>;

package/dist/context.js

@@ -0,0 +1,37 @@
+import { homedir } from 'node:os';
+import { installLayout, readInstallRecord, } from './layout.js';
+import { createSystemd } from './systemd.js';
+export class NotInstalledError extends Error {
+}
+export async function resolveContext(options) {
+    const home = options.home ?? homedir();
+    const write = options.write ?? ((line) => process.stdout.write(`${line}\n`));
+    const requested = options.options.scope;
+    const candidates = requested === undefined ? ['system', 'user'] : [requested];
+    const found = [];
+    for (const scope of candidates) {
+        const layout = installLayout(scope, home);
+        const record = await readInstallRecord(layout).catch(() => undefined);
+        if (record !== undefined)
+            found.push({ layout, record });
+    }
+    if (found.length === 0) {
+        throw new NotInstalledError(requested === undefined
+            ? 'no Terminay Server is installed on this machine. Install one with `npx terminay daemon install`.'
+            : `no ${requested}-scope Terminay Server is installed on this machine.`);
+    }
+    if (found.length > 1) {
+        throw new NotInstalledError('both a system-wide and a user install exist here. Choose one with --system or --user.');
+    }
+    const [only] = found;
+    return Object.freeze({
+        layout: only.layout,
+        record: only.record,
+        systemd: createSystemd({
+            scope: only.layout.scope,
+            ...(options.env === undefined ? {} : { env: options.env }),
+        }),
+        write,
+    });
+}
+//# sourceMappingURL=context.js.map

package/dist/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAGlC,OAAO,EAGN,aAAa,EACb,iBAAiB,GACjB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,aAAa,EAAgB,MAAM,cAAc,CAAC;AAkB3D,MAAM,OAAO,iBAAkB,SAAQ,KAAK;CAAG;AAS/C,MAAM,CAAC,KAAK,UAAU,cAAc,CACnC,OAA8B;IAE9B,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,OAAO,EAAE,CAAC;IACvC,MAAM,KAAK,GACV,OAAO,CAAC,KAAK,IAAI,CAAC,CAAC,IAAY,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,IAAI,CAAC,CAAC,CAAC;IACxE,MAAM,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC;IAExC,MAAM,UAAU,GACf,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IAC5D,MAAM,KAAK,GAAuD,EAAE,CAAC;IACrE,KAAK,MAAM,KAAK,IAAI,UAAU,EAAE,CAAC;QAChC,MAAM,MAAM,GAAG,aAAa,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;QAC1C,MAAM,MAAM,GAAG,MAAM,iBAAiB,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;QACtE,IAAI,MAAM,KAAK,SAAS;YAAE,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IAC1D,CAAC;IAED,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxB,MAAM,IAAI,iBAAiB,CAC1B,SAAS,KAAK,SAAS;YACtB,CAAC,CAAC,kGAAkG;YACpG,CAAC,CAAC,MAAM,SAAS,sDAAsD,CACxE,CAAC;IACH,CAAC;IACD,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtB,MAAM,IAAI,iBAAiB,CAC1B,uFAAuF,CACvF,CAAC;IACH,CAAC;IAED,MAAM,CAAC,IAAI,CAAC,GAAG,KAA2D,CAAC;IAC3E,OAAO,MAAM,CAAC,MAAM,CAAC;QACpB,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,OAAO,EAAE,aAAa,CAAC;YACtB,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,KAAK;YACxB,GAAG,CAAC,OAAO,CAAC,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,CAAC;SAC1D,CAAC;QACF,KAAK;KACL,CAAC,CAAC;AACJ,CAAC"}

package/dist/download.d.ts

@@ -0,0 +1,11 @@
+export interface DownloadedAsset {
+    readonly path: string;
+    readonly sha256: string;
+    readonly bytes: number;
+}
+export declare function hashFile(path: string): Promise<string>;
+export declare function downloadAsset(url: string, prefix: string, name?: string): Promise<DownloadedAsset>;
+/** Sidecars are tiny, so they are read into memory rather than staged. */
+export declare function downloadText(url: string): Promise<string>;
+export declare function downloadBytes(url: string): Promise<Buffer>;
+export declare function discardDownloads(prefix: string): Promise<void>;

package/dist/download.js

@@ -0,0 +1,95 @@
+import { createHash } from 'node:crypto';
+import { createReadStream, createWriteStream } from 'node:fs';
+import { mkdir, rm, stat } from 'node:fs/promises';
+import { basename, join } from 'node:path';
+import { pipeline } from 'node:stream/promises';
+import { openStream, request } from './http.js';
+/**
+ * Fetching a release asset onto the operator's disk.
+ *
+ * The archive is around 90 MB, so it is streamed to a partial file and hashed
+ * by reading that file back rather than buffered in memory. A partial file
+ * that survives an interrupted install is resumed with a range request, and a
+ * download that fails for any other reason is deleted: a truncated archive
+ * that lingers would fail verification on the next attempt with a message
+ * about a bad signature rather than a bad download.
+ */
+const DOWNLOAD_DIRECTORY = '.downloads';
+const MAX_ASSET_BYTES = 512 * 1024 * 1024;
+export async function hashFile(path) {
+    const hash = createHash('sha256');
+    await pipeline(createReadStream(path), hash);
+    return hash.digest('hex');
+}
+async function sizeOf(path) {
+    const info = await stat(path).catch(() => undefined);
+    return info?.isFile() === true ? info.size : 0;
+}
+export async function downloadAsset(url, prefix, name = basename(new URL(url).pathname)) {
+    const directory = join(prefix, DOWNLOAD_DIRECTORY);
+    await mkdir(directory, { recursive: true, mode: 0o700 });
+    const target = join(directory, `${name}.part`);
+    const existing = await sizeOf(target);
+    try {
+        const response = await openStream(url, '*/*', undefined, existing > 0 ? { range: `bytes=${existing}-` } : undefined);
+        const status = response.statusCode ?? 0;
+        // 206 continues the partial file; 200 means the server ignored the range
+        // and is sending the whole asset, so the partial file is replaced.
+        const resuming = status === 206 && existing > 0;
+        if (status !== 200 && status !== 206) {
+            response.resume();
+            throw new Error(`downloading ${url} failed with status ${status}`);
+        }
+        const declared = Number(response.headers['content-length'] ?? '0');
+        if (Number.isFinite(declared) &&
+            declared + (resuming ? existing : 0) > MAX_ASSET_BYTES) {
+            response.resume();
+            throw new Error(`refusing to download ${url}: it is larger than the ${MAX_ASSET_BYTES}-byte limit`);
+        }
+        await pipeline(response, createWriteStream(target, resuming ? { flags: 'a' } : { flags: 'w', mode: 0o600 }));
+        const bytes = await sizeOf(target);
+        if (bytes === 0)
+            throw new Error(`downloading ${url} produced an empty file`);
+        if (bytes > MAX_ASSET_BYTES)
+            throw new Error(`${url} is larger than the ${MAX_ASSET_BYTES}-byte limit`);
+        return Object.freeze({
+            path: target,
+            sha256: await hashFile(target),
+            bytes,
+        });
+    }
+    catch (error) {
+        await rm(target, { force: true });
+        throw error;
+    }
+}
+/** Sidecars are tiny, so they are read into memory rather than staged. */
+export async function downloadText(url) {
+    const response = await request(url, '*/*');
+    if (response.status !== 200)
+        throw new Error(`downloading ${url} failed with status ${response.status}`);
+    return response.body;
+}
+export async function downloadBytes(url) {
+    const response = await openStream(url, '*/*');
+    const status = response.statusCode ?? 0;
+    if (status !== 200) {
+        response.resume();
+        throw new Error(`downloading ${url} failed with status ${status}`);
+    }
+    const chunks = [];
+    let total = 0;
+    for await (const chunk of response) {
+        total += chunk.length;
+        if (total > 64 * 1024) {
+            response.destroy();
+            throw new Error(`${url} is unexpectedly large for a signature`);
+        }
+        chunks.push(chunk);
+    }
+    return Buffer.concat(chunks);
+}
+export async function discardDownloads(prefix) {
+    await rm(join(prefix, DOWNLOAD_DIRECTORY), { recursive: true, force: true });
+}
+//# sourceMappingURL=download.js.map

package/dist/download.js.map

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

package/dist/health.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Waiting for the server to say it is ready.
+ *
+ * The health endpoint is loopback-only by design, so this is an operator-side
+ * check running on the same machine, never something a device reaches. An
+ * upgrade that cannot get a ready answer within the deadline is the signal to
+ * roll back, so the deadline is the whole point of this module.
+ */
+export declare const READINESS_TIMEOUT_MS = 60000;
+export interface HealthSnapshot {
+    readonly status: string;
+    readonly ready: boolean;
+    readonly phase?: string;
+    readonly serverId?: string;
+    readonly version?: string;
+}
+export declare function probeHealth(port: number, path?: '/readyz' | '/healthz'): Promise<HealthSnapshot | undefined>;
+export declare function waitForReady(port: number, timeoutMs?: number, now?: () => number): Promise<HealthSnapshot | undefined>;

package/dist/health.js

@@ -0,0 +1,61 @@
+import { get } from 'node:http';
+/**
+ * Waiting for the server to say it is ready.
+ *
+ * The health endpoint is loopback-only by design, so this is an operator-side
+ * check running on the same machine, never something a device reaches. An
+ * upgrade that cannot get a ready answer within the deadline is the signal to
+ * roll back, so the deadline is the whole point of this module.
+ */
+export const READINESS_TIMEOUT_MS = 60_000;
+const POLL_INTERVAL_MS = 500;
+const REQUEST_TIMEOUT_MS = 5_000;
+export function probeHealth(port, path = '/readyz') {
+    return new Promise((resolve) => {
+        const request = get({ host: '127.0.0.1', port, path, timeout: REQUEST_TIMEOUT_MS }, (response) => {
+            let body = '';
+            response.setEncoding('utf8');
+            response.on('data', (chunk) => {
+                body += chunk;
+                if (body.length > 64 * 1024)
+                    response.destroy();
+            });
+            response.on('end', () => {
+                try {
+                    const parsed = JSON.parse(body);
+                    resolve({
+                        status: String(parsed.status ?? 'unknown'),
+                        ready: parsed.ready === true,
+                        ...(typeof parsed.phase === 'string'
+                            ? { phase: parsed.phase }
+                            : {}),
+                        ...(typeof parsed.serverId === 'string'
+                            ? { serverId: parsed.serverId }
+                            : {}),
+                        ...(typeof parsed.version === 'string'
+                            ? { version: parsed.version }
+                            : {}),
+                    });
+                }
+                catch {
+                    resolve(undefined);
+                }
+            });
+        });
+        request.on('timeout', () => request.destroy());
+        request.on('error', () => resolve(undefined));
+    });
+}
+const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
+export async function waitForReady(port, timeoutMs = READINESS_TIMEOUT_MS, now = Date.now) {
+    const deadline = now() + timeoutMs;
+    for (;;) {
+        const snapshot = await probeHealth(port);
+        if (snapshot?.ready === true)
+            return snapshot;
+        if (now() >= deadline)
+            return undefined;
+        await sleep(POLL_INTERVAL_MS);
+    }
+}
+//# sourceMappingURL=health.js.map

package/dist/health.js.map

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

package/dist/http.d.ts

@@ -0,0 +1,11 @@
+import type { IncomingMessage } from 'node:http';
+/** Sentinel for `openStream`: return the redirect itself rather than follow it. */
+export declare const NO_REDIRECT = -1;
+export interface HttpResponse {
+    readonly status: number;
+    readonly headers: Readonly<Record<string, string | string[] | undefined>>;
+    readonly body: string;
+}
+export declare function openStream(url: string, accept?: string, redirectsLeft?: number, extraHeaders?: Readonly<Record<string, string>>): Promise<IncomingMessage>;
+export declare function request(url: string, accept?: string, followRedirects?: boolean): Promise<HttpResponse>;
+export declare function requestJson(url: string): Promise<unknown>;