hagiscript-sdk 0.2.9-dev.1780142424.1.dedbfb7

package/dist/src/runtime/dotnet-installer.js

@@ -0,0 +1,282 @@
+import { access, chmod, mkdtemp, rm, writeFile } from "node:fs/promises";
+import { dirname, join, resolve } from "node:path";
+import { copyDirectoryFromCache, isDownloadCacheEnabled, resolveDownloadCacheDirectory, storeDirectoryInCache } from "./download-cache.js";
+import { assertTargetIsEmptyOrMissing, moveExtractedRootToTarget } from "./node-extract.js";
+import { CommandExecutionError, runCommand } from "./command-launch.js";
+const managedDotnetRuntimeNames = [
+    "Microsoft.NETCore.App",
+    "Microsoft.AspNetCore.App"
+];
+const windowsPowerShellCommands = ["pwsh", "powershell.exe", "powershell"];
+export async function installManagedDotnetRuntime(options) {
+    const targetDirectory = resolve(options.targetDirectory);
+    const version = normalizeRequiredVersion(options.version);
+    const runner = options.runner ?? runCommand;
+    const platform = options.platform ?? process.platform;
+    const architecture = mapDotnetArchitecture(options.architecture ?? process.arch);
+    const stagingRoot = await mkdtemp(join(dirname(targetDirectory), ".hagiscript-dotnet-"));
+    const stagedRuntimeDirectory = join(stagingRoot, "runtime");
+    const installerScriptPath = join(stagingRoot, platform === "win32" ? "dotnet-install.ps1" : "dotnet-install.sh");
+    const cacheRuntimeDirectory = isDownloadCacheEnabled(options.downloadCacheEnabled)
+        ? join(resolveDownloadCacheDirectory(options.downloadCacheDirectory), "dotnet", version, `${platform}-${architecture}`)
+        : undefined;
+    await assertTargetIsEmptyOrMissing(targetDirectory);
+    try {
+        if (cacheRuntimeDirectory) {
+            const restoredFromCache = await copyDirectoryFromCache(cacheRuntimeDirectory, stagedRuntimeDirectory);
+            if (restoredFromCache) {
+                const cachedVerification = await verifyManagedDotnetRuntime({
+                    targetDirectory: stagedRuntimeDirectory,
+                    version,
+                    runner,
+                    platform,
+                    timeoutMs: options.timeoutMs
+                });
+                if (cachedVerification.valid) {
+                    await moveExtractedRootToTarget(stagedRuntimeDirectory, targetDirectory);
+                    return {
+                        ...cachedVerification,
+                        valid: true,
+                        targetDirectory
+                    };
+                }
+                await rm(cacheRuntimeDirectory, { recursive: true, force: true }).catch(() => undefined);
+                await rm(stagedRuntimeDirectory, { recursive: true, force: true }).catch(() => undefined);
+            }
+        }
+        await downloadDotnetInstallScript(installerScriptPath, {
+            platform,
+            scriptBaseUrl: options.scriptBaseUrl,
+            fetchImpl: options.fetchImpl
+        });
+        for (const runtimeKind of ["dotnet", "aspnetcore"]) {
+            const invocation = buildDotnetInstallInvocation({
+                installerScriptPath,
+                installDirectory: stagedRuntimeDirectory,
+                version,
+                runtime: runtimeKind,
+                platform,
+                architecture,
+                verbose: options.verbose
+            });
+            await runDotnetInstallInvocation(runner, invocation, {
+                timeoutMs: options.timeoutMs,
+                env: {
+                    ...process.env,
+                    DOTNET_CLI_TELEMETRY_OPTOUT: "1",
+                    DOTNET_NOLOGO: "1",
+                    DOTNET_SKIP_FIRST_TIME_EXPERIENCE: "1"
+                }
+            });
+        }
+        const verification = await verifyManagedDotnetRuntime({
+            targetDirectory: stagedRuntimeDirectory,
+            version,
+            runner,
+            platform,
+            timeoutMs: options.timeoutMs
+        });
+        if (!verification.valid) {
+            throw new Error(`Installed .NET runtime failed verification: ${verification.failureReason ?? "unknown failure"}`);
+        }
+        if (cacheRuntimeDirectory) {
+            await storeDirectoryInCache(stagedRuntimeDirectory, cacheRuntimeDirectory);
+        }
+        await moveExtractedRootToTarget(stagedRuntimeDirectory, targetDirectory);
+        return {
+            ...verification,
+            valid: true,
+            targetDirectory
+        };
+    }
+    finally {
+        await rm(stagingRoot, { recursive: true, force: true }).catch(() => undefined);
+    }
+}
+export async function verifyManagedDotnetRuntime(options) {
+    const targetDirectory = resolve(options.targetDirectory);
+    const version = normalizeRequiredVersion(options.version);
+    const platform = options.platform ?? process.platform;
+    const runner = options.runner ?? runCommand;
+    const dotnetPath = getManagedDotnetExecutablePath(targetDirectory, platform);
+    try {
+        await access(dotnetPath);
+    }
+    catch (error) {
+        return {
+            valid: false,
+            targetDirectory,
+            dotnetPath,
+            installedRuntimes: {},
+            requiredVersion: version,
+            failureReason: error instanceof Error
+                ? `Managed dotnet executable is missing: ${error.message}`
+                : "Managed dotnet executable is missing."
+        };
+    }
+    try {
+        const [infoResult, listRuntimesResult] = await Promise.all([
+            runner(dotnetPath, ["--info"], {
+                timeoutMs: options.timeoutMs
+            }),
+            runner(dotnetPath, ["--list-runtimes"], {
+                timeoutMs: options.timeoutMs
+            })
+        ]);
+        const installedRuntimes = parseInstalledDotnetRuntimes(listRuntimesResult.stdout);
+        for (const runtimeName of managedDotnetRuntimeNames) {
+            if (!installedRuntimes[runtimeName]?.includes(version)) {
+                return {
+                    valid: false,
+                    targetDirectory,
+                    dotnetPath,
+                    installedRuntimes,
+                    requiredVersion: version,
+                    infoOutput: infoResult.stdout,
+                    listRuntimesOutput: listRuntimesResult.stdout,
+                    failureReason: `Missing required runtime ${runtimeName} ${version}.`
+                };
+            }
+        }
+        return {
+            valid: true,
+            targetDirectory,
+            dotnetPath,
+            installedRuntimes,
+            requiredVersion: version,
+            infoOutput: infoResult.stdout,
+            listRuntimesOutput: listRuntimesResult.stdout
+        };
+    }
+    catch (error) {
+        return {
+            valid: false,
+            targetDirectory,
+            dotnetPath,
+            installedRuntimes: {},
+            requiredVersion: version,
+            failureReason: error instanceof Error ? error.message : "Failed to execute managed dotnet verification."
+        };
+    }
+}
+export function getManagedDotnetExecutablePath(targetDirectory, platform = process.platform) {
+    return join(resolve(targetDirectory), platform === "win32" ? "dotnet.exe" : "dotnet");
+}
+export function parseInstalledDotnetRuntimes(output) {
+    const runtimes = {};
+    for (const line of output.split(/\r?\n/u)) {
+        const match = /^(?<name>\S+)\s+(?<version>\S+)\s+\[[^\]]+\]$/u.exec(line.trim());
+        if (!match?.groups?.name || !match.groups.version) {
+            continue;
+        }
+        const versions = (runtimes[match.groups.name] ??= []);
+        versions.push(match.groups.version);
+    }
+    return runtimes;
+}
+export function mapDotnetArchitecture(architecture) {
+    switch (architecture) {
+        case "x64":
+            return "x64";
+        case "arm64":
+        case "aarch64":
+            return "arm64";
+        default:
+            throw new Error(`Unsupported .NET runtime architecture: ${architecture}`);
+    }
+}
+function normalizeRequiredVersion(version) {
+    const normalized = version.trim();
+    if (!normalized) {
+        throw new Error("Managed .NET runtime version must be a non-empty string.");
+    }
+    return normalized;
+}
+async function downloadDotnetInstallScript(destinationPath, options) {
+    const fetchImpl = options.fetchImpl ?? globalThis.fetch;
+    if (typeof fetchImpl !== "function") {
+        throw new Error("Global fetch is unavailable for downloading the .NET installer.");
+    }
+    const url = buildDotnetInstallScriptUrl(options.platform, options.scriptBaseUrl);
+    const response = await fetchImpl(url);
+    if (!response.ok) {
+        throw new Error(`Failed to download .NET installer ${url}: HTTP ${response.status}`);
+    }
+    const scriptContents = await response.text();
+    await writeFile(destinationPath, scriptContents, "utf8");
+    if (options.platform !== "win32") {
+        await chmod(destinationPath, 0o755);
+    }
+}
+export function buildDotnetInstallScriptUrl(platform, scriptBaseUrl = "https://dot.net/v1") {
+    const normalizedBaseUrl = scriptBaseUrl.replace(/\/+$/u, "");
+    return `${normalizedBaseUrl}/${platform === "win32" ? "dotnet-install.ps1" : "dotnet-install.sh"}`;
+}
+function buildDotnetInstallInvocation(options) {
+    if (options.platform === "win32") {
+        return {
+            commands: windowsPowerShellCommands,
+            args: [
+                "-NoLogo",
+                "-NoProfile",
+                "-NonInteractive",
+                "-ExecutionPolicy",
+                "Bypass",
+                "-File",
+                options.installerScriptPath,
+                "-InstallDir",
+                options.installDirectory,
+                "-Version",
+                options.version,
+                "-Runtime",
+                options.runtime,
+                "-Architecture",
+                options.architecture,
+                "-NoPath",
+                ...(options.verbose ? ["-Verbose"] : [])
+            ]
+        };
+    }
+    return {
+        commands: ["bash"],
+        args: [
+            options.installerScriptPath,
+            "--install-dir",
+            options.installDirectory,
+            "--version",
+            options.version,
+            "--runtime",
+            options.runtime,
+            "--architecture",
+            options.architecture,
+            "--no-path",
+            ...(options.verbose ? ["--verbose"] : [])
+        ]
+    };
+}
+async function runDotnetInstallInvocation(runner, invocation, options) {
+    const failures = [];
+    for (const command of invocation.commands) {
+        try {
+            await runner(command, invocation.args, options);
+            return;
+        }
+        catch (error) {
+            failures.push(formatDotnetInstallFailure(command, invocation.args, error));
+        }
+    }
+    throw new Error(`Failed to execute .NET installer. Attempts:\n${failures.map((failure) => `- ${failure}`).join("\n")}`);
+}
+function formatDotnetInstallFailure(command, args, error) {
+    const commandLine = `${command} ${args.join(" ")}`;
+    if (error instanceof CommandExecutionError) {
+        const details = [
+            error.context.shortMessage || error.message,
+            error.context.stderr.trim() ? `stderr: ${error.context.stderr.trim()}` : "",
+            error.context.stdout.trim() ? `stdout: ${error.context.stdout.trim()}` : ""
+        ].filter(Boolean);
+        return `${commandLine} => ${details.join(" | ")}`;
+    }
+    return `${commandLine} => ${error instanceof Error ? error.message : String(error)}`;
+}
+//# sourceMappingURL=dotnet-installer.js.map

package/dist/src/runtime/dotnet-installer.js.map

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

package/dist/src/runtime/download-cache.d.ts

@@ -0,0 +1,7 @@
+export declare function isDownloadCacheEnabled(enabled: boolean | undefined): boolean;
+export declare function getDefaultDownloadCacheDirectory(): string;
+export declare function resolveDownloadCacheDirectory(directory?: string): string;
+export declare function copyFileFromCache(cachePath: string, destinationPath: string): Promise<number | undefined>;
+export declare function copyDirectoryFromCache(cachePath: string, destinationPath: string): Promise<boolean>;
+export declare function storeFileInCache(sourcePath: string, cachePath: string): Promise<void>;
+export declare function storeDirectoryInCache(sourcePath: string, cachePath: string): Promise<void>;

package/dist/src/runtime/download-cache.js

@@ -0,0 +1,110 @@
+import { copyFile, cp, mkdir, rename, rm, stat } from "node:fs/promises";
+import { dirname, join, resolve } from "node:path";
+import { homedir } from "node:os";
+export function isDownloadCacheEnabled(enabled) {
+    return enabled ?? true;
+}
+export function getDefaultDownloadCacheDirectory() {
+    return join(homedir(), ".hagiscript", "download-cache");
+}
+export function resolveDownloadCacheDirectory(directory) {
+    const normalized = directory?.trim();
+    return resolve(normalized && normalized.length > 0
+        ? normalized
+        : getDefaultDownloadCacheDirectory());
+}
+export async function copyFileFromCache(cachePath, destinationPath) {
+    try {
+        const cachedFile = await stat(cachePath);
+        await mkdir(dirname(destinationPath), { recursive: true });
+        await copyFile(cachePath, destinationPath);
+        return cachedFile.size;
+    }
+    catch (error) {
+        if (isMissingPathError(error)) {
+            return undefined;
+        }
+        throw error;
+    }
+}
+export async function copyDirectoryFromCache(cachePath, destinationPath) {
+    try {
+        await stat(cachePath);
+        await mkdir(dirname(destinationPath), { recursive: true });
+        await cp(cachePath, destinationPath, {
+            recursive: true,
+            force: false,
+            errorOnExist: true
+        });
+        return true;
+    }
+    catch (error) {
+        if (isMissingPathError(error)) {
+            return false;
+        }
+        throw error;
+    }
+}
+export async function storeFileInCache(sourcePath, cachePath) {
+    try {
+        await stat(cachePath);
+        return;
+    }
+    catch (error) {
+        if (!isMissingPathError(error)) {
+            throw error;
+        }
+    }
+    const temporaryPath = getTemporaryCachePath(cachePath);
+    await mkdir(dirname(cachePath), { recursive: true });
+    await copyFile(sourcePath, temporaryPath);
+    await moveIntoCache(temporaryPath, cachePath);
+}
+export async function storeDirectoryInCache(sourcePath, cachePath) {
+    try {
+        await stat(cachePath);
+        return;
+    }
+    catch (error) {
+        if (!isMissingPathError(error)) {
+            throw error;
+        }
+    }
+    const temporaryPath = getTemporaryCachePath(cachePath);
+    await mkdir(dirname(cachePath), { recursive: true });
+    await cp(sourcePath, temporaryPath, {
+        recursive: true,
+        force: false,
+        errorOnExist: true
+    });
+    await moveIntoCache(temporaryPath, cachePath);
+}
+function getTemporaryCachePath(cachePath) {
+    return `${cachePath}.tmp-${process.pid}-${Date.now()}-${Math.random()
+        .toString(16)
+        .slice(2)}`;
+}
+async function moveIntoCache(temporaryPath, cachePath) {
+    try {
+        await rename(temporaryPath, cachePath);
+    }
+    catch (error) {
+        if (!isAlreadyCachedError(error)) {
+            throw error;
+        }
+    }
+    finally {
+        await rm(temporaryPath, { recursive: true, force: true }).catch(() => undefined);
+    }
+}
+function isMissingPathError(error) {
+    return (error instanceof Error &&
+        "code" in error &&
+        (error.code === "ENOENT" || error.code === "ENOTDIR"));
+}
+function isAlreadyCachedError(error) {
+    return (error instanceof Error &&
+        "code" in error &&
+        (error.code === "EEXIST" || error.code === "ENOTEMPTY"));
+}
+//# sourceMappingURL=download-cache.js.map

package/dist/src/runtime/download-cache.js.map

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

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

@@ -0,0 +1,57 @@
+import { type LoadedRuntimeManifest } from "./runtime-manifest.js";
+export interface RuntimeManifestPathUpdates {
+    runtimeRoot?: string;
+    runtimeHome?: string;
+    runtimeDataRoot?: string;
+    serverProgramRoot?: string;
+    serverDataRoot?: string;
+}
+export interface RuntimeManifestNpmPackageUpdate {
+    packageName: string;
+    version: string;
+    target?: string;
+}
+export interface RuntimeManifestMutationOptions {
+    manifestPath: string;
+    pathUpdates?: RuntimeManifestPathUpdates;
+    npmPackageUpdates?: readonly RuntimeManifestNpmPackageUpdate[];
+    serverActiveVersion?: string;
+}
+export interface InitRuntimeManifestOptions extends RuntimeManifestMutationOptions {
+    force?: boolean;
+}
+export interface RuntimeManifestMutationResult {
+    manifestPath: string;
+    manifest: LoadedRuntimeManifest;
+    changedFields: string[];
+}
+export interface RuntimeManifestSummary {
+    manifestPath: string;
+    runtime: {
+        name: string;
+        version: string;
+        hagicodeInstance?: string;
+    };
+    paths: RuntimeManifestPathUpdates & {
+        runtimeRoot: string;
+        runtimeHome: string;
+        runtimeDataRoot: string;
+        serverProgramRoot?: string;
+        serverDataRoot?: string;
+        npmPrefix?: string;
+    };
+    serverActiveVersion?: string;
+    components: string[];
+    npmPackages: Array<{
+        packageName: string;
+        version?: string;
+        target?: string;
+    }>;
+}
+export declare class RuntimeManifestMutationError extends Error {
+    constructor(message: string);
+}
+export declare function initRuntimeManifest(options?: InitRuntimeManifestOptions): Promise<RuntimeManifestMutationResult>;
+export declare function updateRuntimeManifest(options: RuntimeManifestMutationOptions): Promise<RuntimeManifestMutationResult>;
+export declare function readRuntimeManifestSummary(manifestPath?: string): Promise<RuntimeManifestSummary>;
+export declare function renderRuntimeManifestSummaryText(summary: RuntimeManifestSummary): string;

package/dist/src/runtime/manifest-manager.js

@@ -0,0 +1,188 @@
+import { access, mkdir, readFile, writeFile } from "node:fs/promises";
+import { dirname, resolve } from "node:path";
+import { parse, stringify } from "yaml";
+import { getDefaultRuntimeManifestPath, loadRuntimeManifest } from "./runtime-manifest.js";
+const DEFAULT_INIT_MANIFEST_PATH = "hagiscript.manifest.yaml";
+export class RuntimeManifestMutationError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "RuntimeManifestMutationError";
+    }
+}
+export async function initRuntimeManifest(options = { manifestPath: DEFAULT_INIT_MANIFEST_PATH }) {
+    const manifestPath = resolve(options.manifestPath || DEFAULT_INIT_MANIFEST_PATH);
+    if (!(options.force ?? false) && (await fileExists(manifestPath))) {
+        throw new RuntimeManifestMutationError(`Manifest already exists: ${manifestPath}. Use --force to overwrite it.`);
+    }
+    const defaultManifestPath = getDefaultRuntimeManifestPath();
+    const manifestObject = await readRuntimeManifestObject(defaultManifestPath);
+    const changedFields = applyRuntimeManifestUpdates(manifestObject, {
+        pathUpdates: options.pathUpdates,
+        npmPackageUpdates: options.npmPackageUpdates,
+        serverActiveVersion: options.serverActiveVersion
+    });
+    await writeRuntimeManifestObject(manifestPath, manifestObject);
+    const manifest = await loadRuntimeManifest({ manifestPath });
+    return {
+        manifestPath,
+        manifest,
+        changedFields
+    };
+}
+export async function updateRuntimeManifest(options) {
+    const manifestPath = resolve(options.manifestPath);
+    const manifestObject = await readRuntimeManifestObject(manifestPath);
+    const changedFields = applyRuntimeManifestUpdates(manifestObject, options);
+    if (changedFields.length === 0) {
+        throw new RuntimeManifestMutationError("No manifest changes requested.");
+    }
+    await writeRuntimeManifestObject(manifestPath, manifestObject);
+    const manifest = await loadRuntimeManifest({ manifestPath });
+    return {
+        manifestPath,
+        manifest,
+        changedFields
+    };
+}
+export async function readRuntimeManifestSummary(manifestPath) {
+    const manifest = await loadRuntimeManifest({ manifestPath });
+    const serverComponent = manifest.componentMap.get("server");
+    const packages = readManifestNpmPackages(manifest.npmSync);
+    return {
+        manifestPath: manifest.manifestPath,
+        runtime: {
+            name: manifest.runtime.name,
+            version: manifest.runtime.version,
+            hagicodeInstance: manifest.runtime.hagicodeInstance
+        },
+        paths: {
+            runtimeRoot: manifest.paths.runtimeRoot,
+            runtimeHome: manifest.paths.runtimeHome,
+            runtimeDataRoot: manifest.paths.runtimeDataRoot,
+            serverProgramRoot: manifest.paths.serverProgramRoot,
+            serverDataRoot: manifest.paths.serverDataRoot,
+            npmPrefix: manifest.paths.npmPrefix
+        },
+        serverActiveVersion: serverComponent?.releasedService?.activeVersion,
+        components: manifest.components.map((component) => component.name),
+        npmPackages: packages
+    };
+}
+export function renderRuntimeManifestSummaryText(summary) {
+    return [
+        "Manifest.",
+        `Path: ${summary.manifestPath}`,
+        `Runtime: ${summary.runtime.name}@${summary.runtime.version}`,
+        `Instance: ${summary.runtime.hagicodeInstance ?? "(none)"}`,
+        "Paths:",
+        `  runtimeRoot: ${summary.paths.runtimeRoot}`,
+        `  runtimeHome: ${summary.paths.runtimeHome}`,
+        `  runtimeDataRoot: ${summary.paths.runtimeDataRoot}`,
+        `  serverProgramRoot: ${summary.paths.serverProgramRoot ?? "(default)"}`,
+        `  serverDataRoot: ${summary.paths.serverDataRoot ?? "(default)"}`,
+        `  npmPrefix: ${summary.paths.npmPrefix ?? "(default)"}`,
+        `Server active version: ${summary.serverActiveVersion ?? "(none)"}`,
+        `Components: ${summary.components.join(", ") || "(none)"}`,
+        ...(summary.npmPackages.length === 0
+            ? ["Managed npm packages: (none)"]
+            : [
+                "Managed npm packages:",
+                ...summary.npmPackages.map((entry) => `  - ${entry.packageName} version=${entry.version ?? "(unspecified)"} target=${entry.target ?? entry.version ?? "(unspecified)"}`)
+            ])
+    ].join("\n");
+}
+async function readRuntimeManifestObject(manifestPath) {
+    let parsed;
+    try {
+        parsed = parse(await readFile(manifestPath, "utf8"));
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        throw new RuntimeManifestMutationError(`Failed to read manifest ${manifestPath}: ${message}`);
+    }
+    if (!isRecord(parsed)) {
+        throw new RuntimeManifestMutationError(`Manifest ${manifestPath} must be a YAML object.`);
+    }
+    return parsed;
+}
+async function writeRuntimeManifestObject(manifestPath, manifestObject) {
+    await mkdir(dirname(manifestPath), { recursive: true });
+    await writeFile(manifestPath, stringify(manifestObject), "utf8");
+}
+function applyRuntimeManifestUpdates(manifestObject, options) {
+    const changedFields = [];
+    const pathsObject = ensureObject(manifestObject, "paths");
+    for (const [key, value] of Object.entries(options.pathUpdates ?? {})) {
+        if (!value) {
+            continue;
+        }
+        pathsObject[key] = value;
+        changedFields.push(`paths.${key}`);
+    }
+    for (const update of options.npmPackageUpdates ?? []) {
+        const npmSyncObject = ensureObject(manifestObject, "npmSync");
+        const packagesObject = ensureObject(npmSyncObject, "packages");
+        const packageObject = ensureObject(packagesObject, update.packageName);
+        packageObject.version = update.version;
+        packageObject.target = update.target ?? update.version;
+        changedFields.push(`npmSync.packages.${update.packageName}`);
+    }
+    if (options.serverActiveVersion) {
+        const serverComponent = findNamedComponent(manifestObject, "server");
+        const releasedServiceObject = ensureObject(serverComponent, "releasedService");
+        releasedServiceObject.activeVersion = options.serverActiveVersion;
+        changedFields.push("components.server.releasedService.activeVersion");
+    }
+    return changedFields;
+}
+function findNamedComponent(manifestObject, componentName) {
+    const components = manifestObject.components;
+    if (!Array.isArray(components)) {
+        throw new RuntimeManifestMutationError("Manifest components must be an array.");
+    }
+    for (const component of components) {
+        if (isRecord(component) && component.name === componentName) {
+            return component;
+        }
+    }
+    throw new RuntimeManifestMutationError(`Manifest does not define a ${componentName} component.`);
+}
+function ensureObject(owner, key) {
+    const current = owner[key];
+    if (isRecord(current)) {
+        return current;
+    }
+    const next = {};
+    owner[key] = next;
+    return next;
+}
+function readManifestNpmPackages(npmSync) {
+    const packages = npmSync?.packages;
+    if (!isRecord(packages)) {
+        return [];
+    }
+    return Object.entries(packages)
+        .flatMap(([packageName, value]) => isRecord(value)
+        ? [
+            {
+                packageName,
+                version: typeof value.version === "string" ? value.version : undefined,
+                target: typeof value.target === "string" ? value.target : undefined
+            }
+        ]
+        : [])
+        .sort((left, right) => left.packageName.localeCompare(right.packageName));
+}
+async function fileExists(filePath) {
+    try {
+        await access(filePath);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+//# sourceMappingURL=manifest-manager.js.map