@jonathanyee/devtunnel-ctl 0.0.0-stage → 0.2.0

package/dist/host-worker.js

@@ -0,0 +1,80 @@
+import { record, safeFault, bounded, Fault } from "./core.js";
+import { validateHost } from "./host.js";
+import { runHostSdk } from "./host-sdk.js";
+const life = new AbortController();
+let started = false, pending = 0;
+let endpointAck;
+const send = (message) => {
+    if (!process.connected || (pending > 0 && message.kind === 'heartbeat'))
+        return;
+    if (pending >= 32) {
+        life.abort();
+        throw new Fault('protocol', 'Host worker IPC backlog exceeded its limit.');
+    }
+    pending++;
+    process.send?.(message, error => {
+        pending--;
+        if (error)
+            life.abort();
+    });
+};
+const report = (message) => {
+    if (message.kind !== 'endpoint') {
+        send(message);
+        return;
+    }
+    return bounded(() => new Promise((resolve, reject) => {
+        if (endpointAck) {
+            reject(new Fault('protocol'));
+            return;
+        }
+        endpointAck = { id: message.id, resolve };
+        send(message);
+    }), 2000, life.signal).finally(() => { endpointAck = undefined; });
+};
+const disconnected = () => life.abort();
+process.once('disconnect', disconnected);
+process.once('SIGTERM', disconnected);
+process.once('SIGINT', disconnected);
+const initial = setTimeout(() => { life.abort(); process.disconnect?.(); }, 5000);
+process.on('message', value => {
+    if (!record(value)) {
+        life.abort();
+        return;
+    }
+    if (value.kind === 'stop') {
+        life.abort();
+        return;
+    }
+    if (value.kind === 'endpoint-recorded' && value.id === endpointAck?.id) {
+        endpointAck?.resolve();
+        return;
+    }
+    if (value.kind !== 'start' || started) {
+        life.abort();
+        return;
+    }
+    started = true;
+    clearTimeout(initial);
+    let options;
+    try {
+        options = validateHost(value.options);
+    }
+    catch {
+        send({ kind: 'fault', code: 'invalid-config', retryAfterMs: 0 });
+        process.disconnect?.();
+        return;
+    }
+    const heartbeat = setInterval(() => send({ kind: 'heartbeat' }), 1000);
+    void runHostSdk(options, report, life.signal).catch(error => {
+        const fault = safeFault(error);
+        send({ kind: 'fault', code: fault.code, retryAfterMs: fault.retryAfterMs });
+    }).finally(() => {
+        clearInterval(heartbeat);
+        if (process.connected)
+            process.disconnect();
+    });
+});
+if (!process.send)
+    throw new Fault('invalid-config', 'The host worker requires a supervisor IPC channel.');
+//# sourceMappingURL=host-worker.js.map

package/dist/host-worker.js.map

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

package/dist/host.d.ts

@@ -0,0 +1,43 @@
+import type { Clock, FaultCode } from './core.ts';
+export interface HostOptions {
+    tunnelId: string;
+    clusterId?: string;
+    helperPath: string;
+    probePorts: number[];
+}
+export interface HostStatus {
+    kind: 'status';
+    state: 'connecting' | 'connected' | 'verified' | 'degraded';
+    relayConnected: boolean;
+    ports: number[];
+    localUnavailable: number[];
+    verifiedPorts: number[];
+    probeFault?: FaultCode;
+}
+export type HostMessage = HostStatus | {
+    kind: 'heartbeat';
+} | {
+    kind: 'endpoint';
+    id: string;
+    tunnelId: string;
+    clusterId: string;
+} | {
+    kind: 'fault';
+    code: FaultCode;
+    retryAfterMs: number;
+} | {
+    kind: 'retry';
+    attempt: number;
+    nextRetryAt: number;
+};
+export declare function validateHost(value: unknown): HostOptions;
+export declare function parseHostMessage(value: unknown): HostMessage | undefined;
+export interface HostDependencies {
+    worker(options: HostOptions, emit: (message: HostMessage) => void, signal: AbortSignal): Promise<void>;
+    report(message: HostMessage): void;
+    clock?: Clock;
+    random?: () => number;
+    sleep?(ms: number, signal: AbortSignal): Promise<void>;
+}
+export declare function sleep(ms: number, signal: AbortSignal): Promise<void>;
+export declare function superviseHost(options: HostOptions, deps: HostDependencies, signal: AbortSignal): Promise<void>;

package/dist/host.js

@@ -0,0 +1,158 @@
+import { isAbsolute } from 'node:path';
+import { bounded, clock, Fault, isFaultCode, record, safeFault } from "./core.js";
+const port = (v) => Number.isInteger(v) && Number(v) > 0 && Number(v) <= 65535;
+const id = /^[a-z0-9][a-z0-9-]{0,62}$/i;
+const terminal = (code) => ['login-required', 'access-denied', 'invalid-config', 'host-superseded', 'host-cleanup-failed'].includes(code);
+export function validateHost(value) {
+    if (!record(value) || typeof value.tunnelId !== 'string' ||
+        typeof value.helperPath !== 'string' || !isAbsolute(value.helperPath) ||
+        /[\0\r\n]/.test(value.helperPath) || !Array.isArray(value.probePorts) ||
+        value.probePorts.length > 16 || !value.probePorts.every(port) ||
+        new Set(value.probePorts).size !== value.probePorts.length)
+        throw new Fault('invalid-config', 'Invalid host options or probe ports.');
+    const [tunnelId, suffix, extra] = value.tunnelId.split('.');
+    const clusterId = value.clusterId ?? suffix;
+    if (!tunnelId || !id.test(tunnelId) || extra !== undefined ||
+        (clusterId !== undefined && (typeof clusterId !== 'string' || !id.test(clusterId))) ||
+        (suffix !== undefined && value.clusterId !== undefined && suffix !== value.clusterId)) {
+        throw new Fault('invalid-config', 'Invalid host tunnel or cluster ID.');
+    }
+    return { tunnelId, ...(clusterId ? { clusterId: String(clusterId) } : {}),
+        helperPath: value.helperPath, probePorts: [...value.probePorts] };
+}
+export function parseHostMessage(value) {
+    if (!record(value))
+        return;
+    if (value.kind === 'heartbeat')
+        return { kind: 'heartbeat' };
+    if (value.kind === 'retry' && Number.isSafeInteger(value.attempt) && Number(value.attempt) > 0 &&
+        typeof value.nextRetryAt === 'number' && Number.isFinite(value.nextRetryAt) && value.nextRetryAt >= 0) {
+        return { kind: 'retry', attempt: Number(value.attempt), nextRetryAt: value.nextRetryAt };
+    }
+    if (value.kind === 'endpoint' && typeof value.id === 'string' && /^[a-f0-9-]{36}-relay$/.test(value.id) &&
+        typeof value.tunnelId === 'string' && id.test(value.tunnelId) && typeof value.clusterId === 'string' && id.test(value.clusterId)) {
+        return { kind: 'endpoint', id: value.id, tunnelId: value.tunnelId, clusterId: value.clusterId };
+    }
+    if (value.kind === 'fault' && isFaultCode(value.code) && typeof value.retryAfterMs === 'number' &&
+        Number.isFinite(value.retryAfterMs) && value.retryAfterMs >= 0 && value.retryAfterMs <= 86400000) {
+        return { kind: 'fault', code: value.code, retryAfterMs: value.retryAfterMs };
+    }
+    if (value.kind !== 'status' || !['connecting', 'connected', 'verified', 'degraded'].includes(String(value.state)) ||
+        typeof value.relayConnected !== 'boolean' || (value.probeFault !== undefined && !isFaultCode(value.probeFault)))
+        return;
+    const arrays = [value.ports, value.localUnavailable, value.verifiedPorts];
+    if (!arrays.every(a => Array.isArray(a) && a.length <= 1024 && a.every(port) && new Set(a).size === a.length))
+        return;
+    const ports = value.ports, localUnavailable = value.localUnavailable, verifiedPorts = value.verifiedPorts;
+    if (localUnavailable.some(p => !ports.includes(p)) || verifiedPorts.some(p => !ports.includes(p) || localUnavailable.includes(p)) ||
+        (verifiedPorts.length > 0 && !value.relayConnected) || (value.state === 'verified' && (!value.relayConnected || !verifiedPorts.length)))
+        return;
+    return { kind: 'status', state: value.state, relayConnected: value.relayConnected,
+        ports: [...ports], localUnavailable: [...localUnavailable], verifiedPorts: [...verifiedPorts],
+        ...(isFaultCode(value.probeFault) ? { probeFault: value.probeFault } : {}) };
+}
+export function sleep(ms, signal) {
+    return new Promise((resolve, reject) => {
+        if (signal.aborted) {
+            reject(new Fault('aborted'));
+            return;
+        }
+        const aborted = () => { clearTimeout(timer); reject(new Fault('aborted')); };
+        const timer = setTimeout(() => { signal.removeEventListener('abort', aborted); resolve(); }, ms);
+        signal.addEventListener('abort', aborted, { once: true });
+    });
+}
+export async function superviseHost(options, deps, signal) {
+    const timer = deps.clock ?? clock;
+    let attempt = 0;
+    while (!signal.aborted) {
+        const life = new AbortController();
+        const parentAbort = () => life.abort();
+        signal.addEventListener('abort', parentAbort, { once: true });
+        const started = timer.now();
+        let lastHeartbeat = started, established = false, failure;
+        let cancelWatch = () => { };
+        const watch = () => {
+            if (timer.now() - lastHeartbeat > 15000 || (!established && timer.now() - started > 45000)) {
+                failure ??= new Fault('timeout');
+                life.abort();
+                return;
+            }
+            cancelWatch = timer.later(1000, watch);
+        };
+        watch();
+        let cancelAbort = () => { };
+        const aborted = new Promise(resolve => {
+            const abort = () => resolve();
+            life.signal.addEventListener('abort', abort, { once: true });
+            cancelAbort = () => life.signal.removeEventListener('abort', abort);
+        });
+        const work = Promise.resolve().then(() => {
+            if (signal.aborted)
+                life.abort();
+            return deps.worker(options, message => {
+                if (life.signal.aborted)
+                    return;
+                if (message.kind === 'heartbeat') {
+                    lastHeartbeat = timer.now();
+                    return;
+                }
+                if (message.kind === 'fault') {
+                    failure = new Fault(message.code, undefined, message.retryAfterMs);
+                    life.abort();
+                }
+                else if (message.kind === 'status') {
+                    established ||= message.relayConnected;
+                    if ((message.state === 'verified' && options.probePorts.every(p => message.verifiedPorts.includes(p))) ||
+                        (!options.probePorts.length && message.relayConnected))
+                        attempt = 0;
+                    deps.report(message);
+                }
+            }, life.signal);
+        });
+        try {
+            await Promise.race([work, aborted]);
+        }
+        catch (error) {
+            failure ??= safeFault(error);
+        }
+        finally {
+            life.abort();
+            cancelWatch();
+            cancelAbort();
+            signal.removeEventListener('abort', parentAbort);
+        }
+        // A replacement cannot overlap a worker that has not confirmed its exit.
+        try {
+            await bounded(() => work.catch(error => {
+                const fault = safeFault(error);
+                if (!failure || terminal(fault.code))
+                    failure = fault;
+            }), 25000, undefined, undefined, timer);
+        }
+        catch {
+            throw new Fault('internal', 'Host worker exit could not be confirmed; refusing overlapping hosts.');
+        }
+        if (signal.aborted) {
+            if (failure?.code === 'host-cleanup-failed') {
+                deps.report({ kind: 'fault', code: failure.code, retryAfterMs: failure.retryAfterMs });
+            }
+            return;
+        }
+        failure ??= new Fault('retrying');
+        deps.report({ kind: 'fault', code: failure.code, retryAfterMs: failure.retryAfterMs });
+        if (terminal(failure.code))
+            return;
+        const backoff = Math.min(15000, 1000 * 2 ** Math.min(attempt++, 5));
+        const delay = Math.max(failure.retryAfterMs, Math.round(backoff * (0.5 + (deps.random ?? Math.random)() * 0.5)));
+        deps.report({ kind: 'retry', attempt, nextRetryAt: timer.now() + delay });
+        try {
+            await (deps.sleep ?? sleep)(delay, signal);
+        }
+        catch (error) {
+            if (!signal.aborted)
+                throw error;
+        }
+    }
+}
+//# sourceMappingURL=host.js.map

package/dist/host.js.map

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

package/dist/launchd.d.ts

@@ -0,0 +1,15 @@
+import type { Store } from './config.ts';
+interface AgentPaths {
+    label: string;
+    node: string;
+    entry: string;
+    state: string;
+}
+export declare const xml: (value: string) => string;
+export declare function launchAgent(paths: AgentPaths): string;
+export declare function launchctl(args: string[], allowAbsent?: boolean): Promise<{
+    loaded: boolean;
+    pid?: number;
+}>;
+export declare function service(action: string, store: Store, entry: string): Promise<unknown>;
+export {};

package/dist/launchd.js

@@ -0,0 +1,135 @@
+import { isAbsolute, join } from 'node:path';
+import { homedir } from 'node:os';
+import { realpath, mkdir, writeFile, lstat, unlink } from 'node:fs/promises';
+import { createHash } from 'node:crypto';
+import { spawn } from 'node:child_process';
+import { bounded, Fault } from "./core.js";
+import { DaemonLock } from "./lock.js";
+import { request } from "./rpc.js";
+import { executable } from "./paths.js";
+export const xml = (value) => value.replace(/[<>&"']/g, ch => ({ '<': '&lt;', '>': '&gt;', '&': '&amp;', '"': '&quot;', "'": '&apos;' })[ch]);
+export function launchAgent(paths) {
+    if (![paths.node, paths.entry, paths.state].every(p => isAbsolute(p) && !/[\0\r\n]/.test(p))) {
+        throw new Fault('invalid-config', 'launchd requires absolute runtime, entrypoint and state paths.');
+    }
+    return `<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0"><dict>
+<key>Label</key><string>${xml(paths.label)}</string>
+<key>ProgramArguments</key><array>${[paths.node, paths.entry, '--state-dir', paths.state, 'daemon'].map(arg => `<string>${xml(arg)}</string>`).join('')}</array>
+<key>RunAtLoad</key><true/>
+<key>KeepAlive</key><true/>
+<key>ThrottleInterval</key><integer>15</integer>
+<key>ProcessType</key><string>Background</string>
+<key>StandardOutPath</key><string>/dev/null</string>
+<key>StandardErrorPath</key><string>/dev/null</string>
+</dict></plist>
+`;
+}
+export async function launchctl(args, allowAbsent = false) {
+    return bounded(signal => new Promise((resolve, reject) => {
+        const child = spawn('/bin/launchctl', args, { shell: false, stdio: ['ignore', 'pipe', 'pipe'] });
+        let bytes = 0, stdout = '';
+        const abort = () => { child.kill('SIGKILL'); };
+        signal.addEventListener('abort', abort, { once: true });
+        child.stdout.on('data', b => { bytes += b.length; if (bytes > 65536)
+            abort();
+        else
+            stdout += b.toString(); });
+        child.stderr.on('data', b => { bytes += b.length; if (bytes > 65536)
+            abort(); });
+        child.on('error', () => { signal.removeEventListener('abort', abort); reject(new Fault('internal', 'Cannot execute launchctl.')); });
+        child.on('close', code => {
+            signal.removeEventListener('abort', abort);
+            if (code === 0) {
+                const pid = /^\s*pid = ([1-9][0-9]*)\s*$/m.exec(stdout)?.[1];
+                resolve({ loaded: true, ...(pid ? { pid: Number(pid) } : {}) });
+            }
+            else if (allowAbsent && code === 113)
+                resolve({ loaded: false });
+            else
+                reject(new Fault('internal', 'launchctl failed. Check the service registration with launchctl print gui/$(id -u)/LABEL; no persistent action is assumed successful.'));
+        });
+    }), 5000);
+}
+export async function service(action, store, entry) {
+    if (process.platform !== 'darwin' || process.getuid?.() === 0)
+        throw new Fault('invalid-config', 'Service management requires a non-root macOS user.');
+    const label = `local.devtunnel-ctl.${createHash('sha256').update(store.dir).digest('hex').slice(0, 12)}`;
+    const directory = join(homedir(), 'Library', 'LaunchAgents');
+    const path = join(directory, label + '.plist');
+    const target = `gui/${process.getuid()}`;
+    if (action === 'install') {
+        const lock = new DaemonLock(store.dir);
+        await lock.acquire();
+        try {
+            const config = await store.load();
+            const node = await executable(process.execPath), main = await realpath(entry), helper = await executable(config.helperPath);
+            await mkdir(directory, { recursive: true, mode: 0o700 });
+            try {
+                await writeFile(path, launchAgent({ label, node, entry: main, state: store.dir }), { flag: 'wx', mode: 0o600 });
+            }
+            catch (error) {
+                if (error instanceof Error && 'code' in error && error.code === 'EEXIST') {
+                    throw new Fault('invalid-config', 'Service is already installed. Stop and uninstall it before reinstalling paths.');
+                }
+                throw error;
+            }
+            try {
+                await store.save({ ...config, helperPath: helper });
+            }
+            catch (error) {
+                await unlink(path);
+                throw error;
+            }
+            return { installed: true, loaded: false, label, path, node, entry: main, helper };
+        }
+        finally {
+            await lock.release();
+        }
+    }
+    if (action === 'status') {
+        let installed = true;
+        try {
+            await lstat(path);
+        }
+        catch (error) {
+            if (error instanceof Error && 'code' in error && error.code === 'ENOENT')
+                installed = false;
+            else
+                throw error;
+        }
+        const result = await launchctl(['print', `${target}/${label}`], true);
+        if (!result.loaded)
+            return { label, installed, loaded: false, responsive: false };
+        try {
+            const status = await request(join(store.dir, 'control.sock'), { v: 1, command: 'status' });
+            return { label, installed, loaded: true, responsive: true, status };
+        }
+        catch {
+            return { label, installed, loaded: true, responsive: false,
+                detail: 'Registered service is unresponsive. Stop it, then run daemon in a terminal to see its sanitized startup error.' };
+        }
+    }
+    const info = await lstat(path);
+    if (!info.isFile() || info.isSymbolicLink() || info.uid !== process.getuid?.() || (info.mode & 0o077)) {
+        throw new Fault('invalid-config', 'Service plist is not a private owned file.');
+    }
+    if (action === 'start') {
+        await launchctl(['bootstrap', target, path]);
+        return { loaded: true, label };
+    }
+    if (action === 'stop') {
+        await launchctl(['bootout', `${target}/${label}`]);
+        return { loaded: false, label };
+    }
+    if (action === 'uninstall') {
+        const result = await launchctl(['print', `${target}/${label}`], true);
+        if (result.loaded)
+            await launchctl(['bootout', `${target}/${label}`]);
+        await unlink(path);
+        return { installed: false, loaded: false, label };
+    }
+    throw new Fault('invalid-config', 'Use service install, start, stop, uninstall or status.');
+}
+//# sourceMappingURL=launchd.js.map

package/dist/launchd.js.map

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

package/dist/lock.d.ts

@@ -0,0 +1,10 @@
+export declare class DaemonLock {
+    private readonly path;
+    private readonly candidate;
+    private readonly nonce;
+    private owned;
+    constructor(dir: string);
+    acquire(): Promise<void>;
+    private reclaim;
+    release(): Promise<void>;
+}

package/dist/lock.js

@@ -0,0 +1,110 @@
+import { mkdir, writeFile, readFile, lstat, unlink, rmdir, rename, readdir } from 'node:fs/promises';
+import { join } from 'node:path';
+import { randomUUID } from 'node:crypto';
+import { Fault, record } from "./core.js";
+import { privatePath } from "./paths.js";
+export class DaemonLock {
+    path;
+    candidate;
+    nonce = randomUUID();
+    owned = false;
+    constructor(dir) {
+        this.path = join(dir, 'daemon.lock');
+        this.candidate = join(dir, `.daemon-lock-${this.nonce}`);
+    }
+    async acquire() {
+        await mkdir(this.candidate, { mode: 0o700 });
+        const marker = `owner-${this.nonce}.json`;
+        try {
+            await writeFile(join(this.candidate, marker), JSON.stringify({ pid: process.pid, nonce: this.nonce }), { flag: 'wx', mode: 0o600 });
+            for (let attempt = 0; attempt < 5; attempt++) {
+                try {
+                    // A populated candidate atomically replaces only an absent or empty directory.
+                    await rename(this.candidate, this.path);
+                    this.owned = true;
+                    return;
+                }
+                catch (error) {
+                    if (!(error instanceof Error && 'code' in error &&
+                        (error.code === 'ENOTEMPTY' || error.code === 'EEXIST')))
+                        throw error;
+                }
+                if (!await this.reclaim())
+                    throw new Fault('daemon-unavailable', 'A live daemon owns the state lock.');
+            }
+            throw new Fault('daemon-unavailable', 'Daemon lock is changing; retry after the other starter finishes.');
+        }
+        finally {
+            if (!this.owned) {
+                await unlink(join(this.candidate, marker));
+                await rmdir(this.candidate);
+            }
+        }
+    }
+    async reclaim() {
+        try {
+            await privatePath(this.path, true);
+            const names = await readdir(this.path);
+            if (!names.length)
+                return true;
+            if (names.length !== 1 || !/^owner-[a-z0-9-]{1,64}\.json$/.test(names[0])) {
+                throw new Fault('daemon-unavailable', 'Unrecognized daemon lock contents; refusing automatic cleanup.');
+            }
+            const marker = join(this.path, names[0]);
+            await privatePath(marker);
+            if ((await lstat(marker)).size > 1024)
+                throw new Fault('daemon-unavailable', 'Invalid daemon lock record.');
+            const owner = JSON.parse(await readFile(marker, 'utf8'));
+            if (!record(owner) || !Number.isSafeInteger(owner.pid) || Number(owner.pid) <= 0 ||
+                typeof owner.nonce !== 'string' || names[0] !== `owner-${owner.nonce}.json`) {
+                throw new Fault('daemon-unavailable', 'Invalid daemon lock record.');
+            }
+            try {
+                process.kill(Number(owner.pid), 0);
+                return false;
+            }
+            catch (error) {
+                if (!(error instanceof Error && 'code' in error && error.code === 'ESRCH'))
+                    return false;
+            }
+            // Unique marker names keep a racing reclaimer from deleting a new owner's record.
+            await unlink(marker);
+            try {
+                await rmdir(this.path);
+            }
+            catch (error) {
+                if (!(error instanceof Error && 'code' in error &&
+                    (error.code === 'ENOENT' || error.code === 'ENOTEMPTY' || error.code === 'EEXIST')))
+                    throw error;
+            }
+            return true;
+        }
+        catch (error) {
+            if (error instanceof Error && 'code' in error && error.code === 'ENOENT')
+                return true;
+            throw error;
+        }
+    }
+    async release() {
+        if (!this.owned)
+            return;
+        const owner = join(this.path, `owner-${this.nonce}.json`);
+        const info = await lstat(owner);
+        if (info.isSymbolicLink() || !info.isFile())
+            throw new Fault('internal', 'Daemon lock ownership changed.');
+        const value = JSON.parse(await readFile(owner, 'utf8'));
+        if (value.nonce !== this.nonce)
+            throw new Fault('internal', 'Daemon lock ownership changed.');
+        await unlink(owner);
+        try {
+            await rmdir(this.path);
+        }
+        catch (error) {
+            if (!(error instanceof Error && 'code' in error &&
+                (error.code === 'ENOENT' || error.code === 'ENOTEMPTY' || error.code === 'EEXIST')))
+                throw error;
+        }
+        this.owned = false;
+    }
+}
+//# sourceMappingURL=lock.js.map

package/dist/lock.js.map

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

package/dist/log.d.ts

@@ -0,0 +1,26 @@
+export interface LogEntry {
+    event: string;
+    profile?: string;
+    state?: string;
+    message?: string;
+    attempt?: number;
+    relayConnected?: boolean;
+    lastHealthyAt?: number;
+    nextRetryAt?: number;
+}
+export declare class Log {
+    private readonly dir;
+    private readonly maxBytes;
+    private pending;
+    private tail;
+    private sequence;
+    private readonly recent;
+    constructor(dir: string, maxBytes?: number);
+    init(): Promise<void>;
+    write(entry: LogEntry): Promise<void>;
+    flush(): Promise<void>;
+    snapshot(): {
+        sequence: number;
+        line: string;
+    }[];
+}