@hagicode/hagiscript 0.1.6 → 0.1.8

package/dist/runtime/runtime-executor.js

@@ -0,0 +1,153 @@
+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, platform = process.platform) {
+    const pathKey = platform === "win32" ? "Path" : "PATH";
+    const currentPath = getPathValue(env, platform);
+    const environmentWithoutPath = stripPathKeys(env, platform);
+    return {
+        ...environmentWithoutPath,
+        [pathKey]: [...pathEntries, currentPath]
+            .filter(Boolean)
+            .join(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 getPathValue(env, platform) {
+    if (platform !== "win32") {
+        return env.PATH ?? "";
+    }
+    for (const [key, value] of Object.entries(env)) {
+        if (key.toLowerCase() === "path" && typeof value === "string") {
+            return value;
+        }
+    }
+    return "";
+}
+function stripPathKeys(env, platform) {
+    if (platform !== "win32") {
+        return { ...env };
+    }
+    return Object.fromEntries(Object.entries(env).filter(([key]) => key.toLowerCase() !== "path"));
+}
+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;
+    }[];
+};