Files
clawdbot/src/infra/runtime-guard.ts
Peter Steinberger c379191f80 chore: migrate to oxlint and oxfmt
Co-authored-by: Christoph Nakazawa <christoph.pojer@gmail.com>
2026-01-14 15:02:19 +00:00

87 lines
2.4 KiB
TypeScript

import process from "node:process";
import { defaultRuntime, type RuntimeEnv } from "../runtime.js";
export type RuntimeKind = "node" | "unknown";
type Semver = {
major: number;
minor: number;
patch: number;
};
const MIN_NODE: Semver = { major: 22, minor: 0, patch: 0 };
export type RuntimeDetails = {
kind: RuntimeKind;
version: string | null;
execPath: string | null;
pathEnv: string;
};
const SEMVER_RE = /(\d+)\.(\d+)\.(\d+)/;
export function parseSemver(version: string | null): Semver | null {
if (!version) return null;
const match = version.match(SEMVER_RE);
if (!match) return null;
const [, major, minor, patch] = match;
return {
major: Number.parseInt(major, 10),
minor: Number.parseInt(minor, 10),
patch: Number.parseInt(patch, 10),
};
}
export function isAtLeast(version: Semver | null, minimum: Semver): boolean {
if (!version) return false;
if (version.major !== minimum.major) return version.major > minimum.major;
if (version.minor !== minimum.minor) return version.minor > minimum.minor;
return version.patch >= minimum.patch;
}
export function detectRuntime(): RuntimeDetails {
const kind: RuntimeKind = process.versions?.node ? "node" : "unknown";
const version = process.versions?.node ?? null;
return {
kind,
version,
execPath: process.execPath ?? null,
pathEnv: process.env.PATH ?? "(not set)",
};
}
export function runtimeSatisfies(details: RuntimeDetails): boolean {
const parsed = parseSemver(details.version);
if (details.kind === "node") return isAtLeast(parsed, MIN_NODE);
return false;
}
export function isSupportedNodeVersion(version: string | null): boolean {
return isAtLeast(parseSemver(version), MIN_NODE);
}
export function assertSupportedRuntime(
runtime: RuntimeEnv = defaultRuntime,
details: RuntimeDetails = detectRuntime(),
): void {
if (runtimeSatisfies(details)) return;
const versionLabel = details.version ?? "unknown";
const runtimeLabel =
details.kind === "unknown" ? "unknown runtime" : `${details.kind} ${versionLabel}`;
const execLabel = details.execPath ?? "unknown";
runtime.error(
[
"clawdbot requires Node >=22.0.0.",
`Detected: ${runtimeLabel} (exec: ${execLabel}).`,
`PATH searched: ${details.pathEnv}`,
"Install Node: https://nodejs.org/en/download",
"Upgrade Node and re-run clawdbot.",
].join("\n"),
);
runtime.exit(1);
}