@hagicode/hagiscript 0.1.6 → 0.1.7

package/dist/runtime/pm2-manager.js

@@ -0,0 +1,260 @@
+import { access } from "node:fs/promises";
+import { basename, extname, join } from "node:path";
+import process from "node:process";
+import { runCommand } from "./command-launch.js";
+import { buildManagedRuntimeEnvironment, } from "./runtime-executor.js";
+import { getRuntimeExecutablePaths } from "./node-verify.js";
+import { loadRuntimeManifest } from "./runtime-manifest.js";
+import { getComponentConfigDirectory, getComponentManagedRoot, getComponentPm2Home, getComponentRuntimeDataHome, resolveManagedPath, resolveRuntimePaths } from "./runtime-paths.js";
+export const supportedPm2Services = ["omniroute", "code-server"];
+export class ManagedPm2Error extends Error {
+    constructor(message, options) {
+        super(message, options);
+        this.name = "ManagedPm2Error";
+    }
+}
+export async function runManagedPm2Command(options) {
+    const manifest = await loadRuntimeManifest({ manifestPath: options.manifestPath });
+    const paths = resolveRuntimePaths(manifest, { runtimeRoot: options.runtimeRoot });
+    const definition = await resolveManagedPm2ServiceDefinition(manifest, paths, options.service);
+    const runner = options.runner ?? runCommand;
+    switch (options.action) {
+        case "start":
+            await runPm2(definition, buildPm2StartArgs(definition), runner);
+            return readManagedPm2Status(definition, "start", runner);
+        case "stop":
+            await runPm2(definition, ["stop", definition.appName], runner);
+            return readManagedPm2Status(definition, "stop", runner);
+        case "status":
+            return readManagedPm2Status(definition, "status", runner);
+    }
+}
+export async function resolveManagedPm2ServiceDefinition(manifest, paths, service) {
+    assertSupportedPm2Service(service);
+    const component = manifest.componentMap.get(service);
+    if (!component) {
+        throw new ManagedPm2Error(`Runtime manifest does not define the ${service} service.`);
+    }
+    const componentRoot = getComponentManagedRoot(paths, component.name);
+    const runtimeDataHome = getComponentRuntimeDataHome(paths, component.name, component.runtimeDataDir);
+    const componentConfigDir = getComponentConfigDirectory(paths, component.name, component.runtimeDataDir);
+    const pm2Home = getComponentPm2Home(paths, component.name, component.runtimeDataDir, component.pm2?.pm2Home);
+    const script = resolveManagedPath(component.pm2?.script ?? defaultPm2Script(component.name), componentRoot);
+    const cwd = resolveManagedPath(component.pm2?.cwd ?? ".", componentRoot);
+    const nodePath = getRuntimeExecutablePaths(paths.nodeRuntime).nodePath;
+    const pm2Entrypoint = getManagedPm2Entrypoint(paths.npmPrefix);
+    await Promise.all([
+        validateManagedPath(script, `Managed launcher for ${service} is missing`),
+        validateManagedPath(cwd, `Managed working directory for ${service} is missing`),
+        validateManagedPath(pm2Entrypoint, "Managed PM2 binary is missing. Install the runtime npm-packages component first."),
+        validateManagedPath(nodePath, "Managed Node runtime is missing. Install the runtime node component first.")
+    ]);
+    return {
+        service,
+        component,
+        manifestDir: manifest.manifestDir,
+        paths,
+        appName: component.pm2?.appName ?? `hagicode-${component.name}`,
+        cwd,
+        script,
+        args: component.pm2?.args ?? [],
+        env: component.pm2?.env ?? {},
+        runtimeHome: paths.runtimeHome,
+        runtimeDataHome,
+        componentRoot,
+        componentConfigDir,
+        pm2Home,
+        pm2Binary: pm2Entrypoint,
+        nodePath
+    };
+}
+export function renderManagedPm2StatusText(result) {
+    return [
+        `Service: ${result.service}`,
+        `Action: ${result.action}`,
+        `App: ${result.appName}`,
+        `Status: ${result.status}`,
+        `Runtime home: ${result.runtimeHome}`,
+        `Runtime data home: ${result.runtimeDataHome}`,
+        `PM2 home: ${result.pm2Home}`,
+        `Script: ${result.script}`,
+        `Working directory: ${result.cwd}`,
+        `PM2 binary: ${result.pm2Binary}`,
+        `PID: ${result.pid ?? "n/a"}`
+    ].join("\n");
+}
+function assertSupportedPm2Service(service) {
+    if (supportedPm2Services.includes(service)) {
+        return;
+    }
+    throw new ManagedPm2Error(`Unsupported managed PM2 service "${service}". Supported services: ${supportedPm2Services.join(", ")}.`);
+}
+async function readManagedPm2Status(definition, action, runner) {
+    const result = await runPm2(definition, ["jlist"], runner);
+    const statusEntry = parsePm2Status(result, definition.appName);
+    return {
+        service: definition.service,
+        action,
+        appName: definition.appName,
+        cwd: definition.cwd,
+        script: definition.script,
+        runtimeHome: definition.runtimeHome,
+        runtimeDataHome: definition.runtimeDataHome,
+        pm2Home: definition.pm2Home,
+        pm2Binary: definition.pm2Binary,
+        exists: statusEntry !== null,
+        status: statusEntry?.status ?? "missing",
+        pid: statusEntry?.pid ?? null,
+        stdout: result.stdout,
+        stderr: result.stderr
+    };
+}
+async function runPm2(definition, args, runner) {
+    const env = buildManagedRuntimeEnvironment({
+        component: definition.component,
+        manifest: { manifestDir: definition.manifestDir },
+        paths: definition.paths,
+        componentRoot: definition.componentRoot,
+        componentConfigDir: definition.componentConfigDir,
+        componentDataHome: definition.runtimeDataHome,
+        pm2Home: definition.pm2Home,
+        scriptBasename: basename(definition.script)
+    }, { ...process.env, ...definition.env });
+    return runner(definition.nodePath, [definition.pm2Binary, ...args], {
+        cwd: definition.cwd,
+        env,
+        maxBuffer: 10 * 1024 * 1024
+    });
+}
+function parsePm2Status(result, appName) {
+    const parsed = parsePm2ProcessList(result);
+    if (!Array.isArray(parsed)) {
+        throw new ManagedPm2Error(`Managed PM2 status returned an unexpected payload for ${appName}.`);
+    }
+    const entry = parsed.find((value) => isPm2ProcessRecord(value) && value.name === appName);
+    if (!entry || !isPm2ProcessRecord(entry)) {
+        return null;
+    }
+    return {
+        status: normalizePm2Status(entry.pm2_env?.status),
+        pid: typeof entry.pid === "number" ? entry.pid : null
+    };
+}
+function parsePm2ProcessList(result) {
+    const directCandidates = [result.stdout.trim(), `${result.stdout}\n${result.stderr}`.trim()].filter(Boolean);
+    for (const candidate of directCandidates) {
+        const direct = tryParseJson(candidate);
+        if (Array.isArray(direct)) {
+            return direct;
+        }
+        const extracted = extractPm2JsonArray(candidate);
+        if (Array.isArray(extracted)) {
+            return extracted;
+        }
+    }
+    throw new ManagedPm2Error(`Managed PM2 status returned invalid JSON: ${summarizePm2Output(result)}`);
+}
+function extractPm2JsonArray(output) {
+    for (let index = 0; index < output.length; index += 1) {
+        if (output[index] !== "[") {
+            continue;
+        }
+        const nextNonWhitespace = output.slice(index + 1).match(/\S/u)?.[0];
+        if (nextNonWhitespace !== "{" && nextNonWhitespace !== "]") {
+            continue;
+        }
+        const parsed = tryParseJson(output.slice(index));
+        if (Array.isArray(parsed)) {
+            return parsed;
+        }
+    }
+    return null;
+}
+function tryParseJson(value) {
+    try {
+        return JSON.parse(value);
+    }
+    catch {
+        return null;
+    }
+}
+function summarizePm2Output(result) {
+    return [result.stdout.trim(), result.stderr.trim()]
+        .filter(Boolean)
+        .join(" | ")
+        .slice(0, 400);
+}
+function normalizePm2Status(value) {
+    switch (value) {
+        case "online":
+            return "online";
+        case "stopped":
+            return "stopped";
+        case "errored":
+            return "errored";
+        default:
+            return "unknown";
+    }
+}
+function isPm2ProcessRecord(value) {
+    return typeof value === "object" && value !== null;
+}
+function defaultPm2Script(componentName) {
+    switch (componentName) {
+        case "omniroute":
+            return "current/omniroute-launcher.mjs";
+        case "code-server":
+            return "current/code-server-launcher.mjs";
+        default:
+            throw new ManagedPm2Error(`Unsupported PM2 component ${componentName}.`);
+    }
+}
+function toPm2Args(args) {
+    return args.length > 0 ? ["--", ...args] : [];
+}
+function buildPm2StartArgs(definition) {
+    if (isNodeLauncherScript(definition.script)) {
+        return [
+            "start",
+            "node",
+            "--name",
+            definition.appName,
+            "--cwd",
+            definition.cwd,
+            "--interpreter",
+            "none",
+            "--update-env",
+            "--",
+            definition.script,
+            ...definition.args
+        ];
+    }
+    return [
+        "start",
+        definition.script,
+        "--name",
+        definition.appName,
+        "--cwd",
+        definition.cwd,
+        "--update-env",
+        ...toPm2Args(definition.args)
+    ];
+}
+function isNodeLauncherScript(scriptPath) {
+    const extension = extname(scriptPath).toLowerCase();
+    return extension === ".js" || extension === ".mjs" || extension === ".cjs";
+}
+function getManagedPm2Entrypoint(npmPrefix) {
+    return process.platform === "win32"
+        ? join(npmPrefix, "node_modules", "pm2", "bin", "pm2")
+        : join(npmPrefix, "lib", "node_modules", "pm2", "bin", "pm2");
+}
+async function validateManagedPath(pathValue, message) {
+    try {
+        await access(pathValue);
+    }
+    catch (error) {
+        throw new ManagedPm2Error(message, error instanceof Error ? { cause: error } : undefined);
+    }
+}
+//# sourceMappingURL=pm2-manager.js.map

package/dist/runtime/pm2-manager.js.map

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

package/dist/runtime/runtime-executor.d.ts

@@ -0,0 +1,45 @@
+import type { CommandRunner } from "./command-launch.js";
+import type { LoadedRuntimeManifest, RuntimeComponentDefinition, RuntimeLifecyclePhase } from "./runtime-manifest.js";
+import type { ResolvedRuntimePaths } from "./runtime-paths.js";
+export interface RuntimeScriptExecutionContext {
+    component: RuntimeComponentDefinition;
+    phase: RuntimeLifecyclePhase;
+    manifest: LoadedRuntimeManifest;
+    paths: ResolvedRuntimePaths;
+    componentRoot: string;
+    componentConfigDir: string;
+    logFilePath?: string;
+    purge?: boolean;
+    verbose?: boolean;
+    runner?: CommandRunner;
+}
+export interface ManagedRuntimeEnvironmentContext {
+    component: Pick<RuntimeComponentDefinition, "name" | "type" | "version" | "runtimeDataDir">;
+    manifest: Pick<LoadedRuntimeManifest, "manifestDir">;
+    paths: ResolvedRuntimePaths;
+    componentRoot: string;
+    componentConfigDir: string;
+    componentDataHome?: string;
+    componentLogsDir?: string;
+    pm2Home?: string;
+    phase?: string;
+    purge?: boolean;
+    verbose?: boolean;
+    scriptBasename?: string;
+}
+export interface RuntimeScriptExecutionResult {
+    command: string;
+    args: string[];
+    stdout: string;
+    stderr: string;
+}
+export declare function executeRuntimeScript(scriptPath: string, context: RuntimeScriptExecutionContext): Promise<RuntimeScriptExecutionResult>;
+export declare function writeRuntimeLog(logFilePath: string, content: string): Promise<void>;
+export declare function getRuntimeScriptLaunch(scriptPath: string): {
+    command: string;
+    args: string[];
+};
+export declare function buildManagedRuntimeEnvironment(context: ManagedRuntimeEnvironmentContext, baseEnv?: NodeJS.ProcessEnv): NodeJS.ProcessEnv;
+export declare function prependPathEntries(env: NodeJS.ProcessEnv, pathEntries: readonly string[]): NodeJS.ProcessEnv;
+export declare function getManagedRuntimePathEntries(paths: ResolvedRuntimePaths): string[];
+export declare function getManagedNpmBinDirectory(npmPrefix: string): string;

package/dist/runtime/runtime-executor.js

@@ -0,0 +1,135 @@
+import { appendFile, mkdir } from "node:fs/promises";
+import { basename, dirname, extname } from "node:path";
+import process from "node:process";
+import { runCommand } from "./command-launch.js";
+import { getRuntimeExecutablePaths } from "./node-verify.js";
+import { getComponentLogsDirectory, getComponentPm2Home, getComponentRuntimeDataHome } from "./runtime-paths.js";
+export async function executeRuntimeScript(scriptPath, context) {
+    const runner = context.runner ?? runCommand;
+    const { command, args } = getRuntimeScriptLaunch(scriptPath);
+    const result = await runner(command, args, {
+        cwd: context.manifest.manifestDir,
+        env: buildRuntimeScriptEnvironment(context),
+        maxBuffer: 10 * 1024 * 1024
+    });
+    if (context.logFilePath) {
+        await writeRuntimeLog(context.logFilePath, [
+            `# ${context.phase}:${context.component.name}`,
+            `$ ${command} ${args.join(" ")}`,
+            result.stdout ? `stdout:\n${result.stdout}` : "",
+            result.stderr ? `stderr:\n${result.stderr}` : ""
+        ]
+            .filter(Boolean)
+            .join("\n"));
+    }
+    return {
+        command,
+        args,
+        stdout: result.stdout,
+        stderr: result.stderr
+    };
+}
+export async function writeRuntimeLog(logFilePath, content) {
+    await mkdir(dirname(logFilePath), { recursive: true });
+    await appendFile(logFilePath, `${content}\n`, "utf8");
+}
+export function getRuntimeScriptLaunch(scriptPath) {
+    const extension = extname(scriptPath).toLowerCase();
+    if (extension === ".mjs" || extension === ".js" || extension === ".cjs") {
+        return {
+            command: process.execPath,
+            args: [scriptPath]
+        };
+    }
+    return {
+        command: scriptPath,
+        args: []
+    };
+}
+function buildRuntimeScriptEnvironment(context) {
+    return buildManagedRuntimeEnvironment({
+        component: context.component,
+        manifest: context.manifest,
+        paths: context.paths,
+        componentRoot: context.componentRoot,
+        componentConfigDir: context.componentConfigDir,
+        componentDataHome: getComponentRuntimeDataHome(context.paths, context.component.name, context.component.runtimeDataDir),
+        componentLogsDir: getComponentLogsDirectory(context.paths, context.component.name, context.component.runtimeDataDir),
+        pm2Home: getComponentPm2Home(context.paths, context.component.name, context.component.runtimeDataDir, context.component.pm2?.pm2Home),
+        phase: context.phase,
+        purge: context.purge,
+        verbose: context.verbose,
+        scriptBasename: basename(scriptPathForEnv(context.component, context.phase))
+    });
+}
+export function buildManagedRuntimeEnvironment(context, baseEnv = process.env) {
+    const componentDataHome = context.componentDataHome ??
+        getComponentRuntimeDataHome(context.paths, context.component.name, context.component.runtimeDataDir);
+    const componentLogsDir = context.componentLogsDir ??
+        getComponentLogsDirectory(context.paths, context.component.name, context.component.runtimeDataDir);
+    const pm2Home = context.pm2Home ??
+        getComponentPm2Home(context.paths, context.component.name, context.component.runtimeDataDir, undefined);
+    return prependPathEntries({
+        ...baseEnv,
+        HAGICODE_RUNTIME_HOME: context.paths.runtimeHome,
+        HAGICODE_RUNTIME_DATA_HOME: componentDataHome,
+        PM2_HOME: pm2Home,
+        HAGISCRIPT_RUNTIME_ROOT: context.paths.root,
+        HAGISCRIPT_RUNTIME_BIN_DIR: context.paths.bin,
+        HAGISCRIPT_RUNTIME_CONFIG_DIR: context.paths.config,
+        HAGISCRIPT_RUNTIME_LOGS_DIR: context.paths.logs,
+        HAGISCRIPT_RUNTIME_DATA_DIR: context.paths.data,
+        HAGISCRIPT_RUNTIME_STATE_PATH: context.paths.stateFile,
+        HAGISCRIPT_RUNTIME_TEMPLATE_DIR: `${context.manifest.manifestDir}/templates`,
+        HAGISCRIPT_RUNTIME_COMPONENT_NAME: context.component.name,
+        HAGISCRIPT_RUNTIME_COMPONENT_TYPE: context.component.type,
+        HAGISCRIPT_RUNTIME_COMPONENT_VERSION: context.component.version ?? "",
+        HAGISCRIPT_RUNTIME_COMPONENT_ROOT: context.componentRoot,
+        HAGISCRIPT_RUNTIME_COMPONENT_CONFIG_DIR: context.componentConfigDir,
+        HAGISCRIPT_RUNTIME_COMPONENT_DATA_DIR: componentDataHome,
+        HAGISCRIPT_RUNTIME_COMPONENT_LOGS_DIR: componentLogsDir,
+        HAGISCRIPT_RUNTIME_COMPONENT_PM2_HOME: pm2Home,
+        ...(context.phase ? { HAGISCRIPT_RUNTIME_PHASE: context.phase } : {}),
+        ...(context.purge !== undefined
+            ? { HAGISCRIPT_RUNTIME_PURGE: context.purge ? "1" : "0" }
+            : {}),
+        ...(context.verbose !== undefined
+            ? { HAGISCRIPT_RUNTIME_VERBOSE: context.verbose ? "1" : "0" }
+            : {}),
+        ...(context.scriptBasename
+            ? { HAGISCRIPT_RUNTIME_SCRIPT_BASENAME: context.scriptBasename }
+            : {})
+    }, getManagedRuntimePathEntries(context.paths));
+}
+export function prependPathEntries(env, pathEntries) {
+    const pathKey = process.platform === "win32" ? "Path" : "PATH";
+    const currentPath = env[pathKey] ?? env.PATH ?? "";
+    return {
+        ...env,
+        [pathKey]: [...pathEntries, currentPath]
+            .filter(Boolean)
+            .join(process.platform === "win32" ? ";" : ":")
+    };
+}
+export function getManagedRuntimePathEntries(paths) {
+    const nodeExecutables = getRuntimeExecutablePaths(paths.nodeRuntime);
+    return [
+        dirname(nodeExecutables.nodePath),
+        getManagedNpmBinDirectory(paths.npmPrefix),
+        paths.bin
+    ];
+}
+export function getManagedNpmBinDirectory(npmPrefix) {
+    return process.platform === "win32" ? npmPrefix : `${npmPrefix}/bin`;
+}
+function scriptPathForEnv(component, phase) {
+    switch (phase) {
+        case "install":
+            return component.scripts.install;
+        case "remove":
+            return component.scripts.remove ?? component.scripts.install;
+        case "update":
+            return component.scripts.update ?? component.scripts.install;
+    }
+}
+//# sourceMappingURL=runtime-executor.js.map

package/dist/runtime/runtime-executor.js.map

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

package/dist/runtime/runtime-manager.d.ts

@@ -0,0 +1,79 @@
+import { type LoadedRuntimeManifest, type RuntimeLifecyclePhase } from "./runtime-manifest.js";
+import { type ResolvedRuntimePaths } from "./runtime-paths.js";
+import { type RuntimeComponentStatus, type RuntimeState } from "./runtime-state.js";
+export interface RuntimeLifecycleOptions {
+    manifestPath?: string;
+    runtimeRoot?: string;
+    components?: readonly string[];
+    dryRun?: boolean;
+    force?: boolean;
+    purge?: boolean;
+    checkOnly?: boolean;
+    verbose?: boolean;
+    logger?: (message: string) => void;
+    now?: () => Date;
+}
+export interface RuntimePlannedAction {
+    componentName: string;
+    phase: RuntimeLifecyclePhase;
+    strategy: "builtin" | "script" | "fallback-install" | "fallback-cleanup";
+    scriptPath?: string;
+    reason?: string;
+}
+export interface RuntimeLifecycleResult {
+    manifest: LoadedRuntimeManifest;
+    paths: ResolvedRuntimePaths;
+    state: RuntimeState;
+    plan: RuntimePlannedAction[];
+    skipped: {
+        componentName: string;
+        reason: string;
+    }[];
+    changedComponents: string[];
+    logFilePath?: string;
+}
+export interface RuntimeStateReport {
+    runtime: {
+        name: string;
+        version: string;
+        manifestPath: string;
+    };
+    managedRoot: string;
+    managedPaths: ResolvedRuntimePaths;
+    layout: {
+        separated: boolean;
+        runtimeHome: string;
+        runtimeDataRoot: string;
+        programRoots: string[];
+        externalDataRoots: string[];
+    };
+    ready: boolean;
+    components: Array<{
+        name: string;
+        type: string;
+        status: RuntimeComponentStatus;
+        version: string | null;
+        runtimeDataHome: string | null;
+        pm2Home: string | null;
+        programPaths: string[];
+        externalDataPaths: string[];
+        managedPaths: string[];
+    }>;
+    lastOperation: RuntimeState["lastOperation"];
+}
+export declare class RuntimeLifecycleError extends Error {
+    constructor(message: string, options?: ErrorOptions);
+}
+export declare function installRuntime(options?: RuntimeLifecycleOptions): Promise<RuntimeLifecycleResult>;
+export declare function removeRuntime(options?: RuntimeLifecycleOptions): Promise<RuntimeLifecycleResult>;
+export declare function updateRuntime(options?: RuntimeLifecycleOptions): Promise<RuntimeLifecycleResult>;
+export declare function runRuntimeLifecycle(phase: RuntimeLifecyclePhase, options?: RuntimeLifecycleOptions): Promise<RuntimeLifecycleResult>;
+export declare function queryRuntimeState(options: Pick<RuntimeLifecycleOptions, "manifestPath" | "runtimeRoot">): Promise<RuntimeStateReport>;
+export declare function renderRuntimeStateText(report: RuntimeStateReport): string;
+export declare function planRuntimeLifecycle(phase: RuntimeLifecyclePhase, manifest: LoadedRuntimeManifest, state: RuntimeState, options?: RuntimeLifecycleOptions): {
+    plan: RuntimePlannedAction[];
+    skipped: {
+        componentName: string;
+        reason: string;
+    }[];
+};