@expo-harmony/cli 55.0.26-harmony.1 → 55.0.26-harmony.3

package/build/prebuild/check.js

@@ -0,0 +1,139 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.checkAsync = checkAsync;
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_os_1 = __importDefault(require("node:os"));
+const node_path_1 = __importDefault(require("node:path"));
+const check_1 = require("@expo-harmony/prebuild-config/check");
+const errors_1 = require("../errors");
+const path_1 = require("../path");
+const process_1 = require("../process");
+const projectLock_1 = require("../projectLock");
+const tools_1 = require("../tools");
+const expo_1 = require("../expo");
+const template_1 = require("./template");
+const IgnoredProjectDirectories = new Set(['.expo', '.git', '.hvigor', '.yarn', 'node_modules']);
+const IgnoredHarmonyGeneratedDirectories = new Set([
+    '.cxx',
+    '.git',
+    '.hvigor',
+    'build',
+    'node_modules',
+    'oh_modules',
+]);
+function mirrorRoot(temp, project) {
+    const absolute = node_path_1.default.resolve(project);
+    const parsed = node_path_1.default.parse(absolute);
+    const volume = parsed.root.replace(/[^A-Za-z0-9]+/gu, '') || 'root';
+    const segments = absolute.slice(parsed.root.length).split(node_path_1.default.sep).filter(Boolean);
+    return node_path_1.default.join(temp, 'filesystem', volume, ...segments);
+}
+async function linkModulesAsync(source, target) {
+    await node_fs_1.default.promises.mkdir(target, { recursive: true });
+    for (const entry of await node_fs_1.default.promises.readdir(source, { withFileTypes: true })) {
+        const from = node_path_1.default.join(source, entry.name);
+        const to = node_path_1.default.join(target, entry.name);
+        if (entry.name.startsWith('@') && entry.isDirectory() && !entry.isSymbolicLink()) {
+            await node_fs_1.default.promises.mkdir(to);
+            for (const child of await node_fs_1.default.promises.readdir(from, { withFileTypes: true })) {
+                await node_fs_1.default.promises.symlink(node_path_1.default.join(from, child.name), node_path_1.default.join(to, child.name), process.platform === 'win32' && (child.isDirectory() || child.isSymbolicLink())
+                    ? 'junction'
+                    : child.isDirectory() ? 'dir' : 'file');
+            }
+            continue;
+        }
+        await node_fs_1.default.promises.symlink(from, to, process.platform === 'win32' && (entry.isDirectory() || entry.isSymbolicLink())
+            ? 'junction'
+            : entry.isDirectory() ? 'dir' : 'file');
+    }
+}
+function isAppLocalHarmonyPath(project, source) {
+    const segments = node_path_1.default.relative(project, source).split(node_path_1.default.sep);
+    return segments.length >= 3
+        && segments[0] === 'modules'
+        && segments[1] !== ''
+        && segments[2] === 'harmony';
+}
+function shouldCopyPrebuildCheckPath(project, source, plan) {
+    const relative = node_path_1.default.relative(project, source);
+    if (!relative)
+        return true;
+    const segments = relative.split(node_path_1.default.sep);
+    if (IgnoredProjectDirectories.has(segments[0]))
+        return false;
+    const nativeRoot = (0, path_1.isInside)(plan.harmonyRoot, source)
+        ? plan.harmonyRoot
+        : isAppLocalHarmonyPath(project, source)
+            ? node_path_1.default.join(project, ...segments.slice(0, 3))
+            : null;
+    if (nativeRoot) {
+        const native = node_path_1.default.relative(nativeRoot, source).split(node_path_1.default.sep);
+        if (native.some(segment => IgnoredHarmonyGeneratedDirectories.has(segment)))
+            return false;
+    }
+    return source !== plan.exportPaths.bundle;
+}
+async function copyAsync(project, target, plan, temp = node_path_1.default.dirname(target)) {
+    await node_fs_1.default.promises.cp(project, target, {
+        recursive: true,
+        filter: source => shouldCopyPrebuildCheckPath(project, source, plan),
+    });
+    const modules = node_path_1.default.join(project, 'node_modules');
+    if (!node_fs_1.default.existsSync(modules)) {
+        throw new errors_1.HarmonyCliError('ERR_HARMONY_DEPENDENCIES_MISSING', 'node_modules is required for --check.', {
+            operation: 'check',
+        });
+    }
+    // Keep a real node_modules directory in the isolated project and link its
+    // entries. Dependency scanners then retain the isolated lexical package path
+    // (including scoped packages) instead of collapsing the entire node_modules
+    // root to the source project's realpath. The packages remain read-only and
+    // are never copied or modified by --check.
+    await linkModulesAsync(modules, node_path_1.default.join(target, 'node_modules'));
+    await (0, check_1.stageAsync)(project, target, temp);
+}
+async function checkUnlockedAsync(project, options) {
+    project = node_path_1.default.resolve(project);
+    const plan = await (0, tools_1.resolveHarmonyBuildPlanAsync)(project);
+    const temp = await node_fs_1.default.promises.mkdtemp(node_path_1.default.join(node_os_1.default.tmpdir(), 'expo-harmony-check-'));
+    const expected = mirrorRoot(temp, project);
+    let packed;
+    try {
+        await copyAsync(project, expected, plan, temp);
+        packed = await (0, template_1.packAsync)(project);
+        const expo = (0, expo_1.resolveExpoCli)(project);
+        const result = await (0, process_1.spawnAsync)(process.execPath, [
+            expo.cliPath,
+            'prebuild',
+            expected,
+            '--platform', 'harmony',
+            '--template', packed.tarball,
+            '--no-install',
+        ], {
+            capture: true,
+            cwd: expected,
+            env: {
+                ...(0, tools_1.createHarmonyToolchainEnv)(),
+                ...packed.env,
+                ...(options.buildType ? { EXPO_HARMONY_BUILD_TYPE: options.buildType } : {}),
+                EXPO_HARMONY_CHECK_MIRROR_ROOT: temp,
+            },
+            operation: 'check-prebuild',
+        });
+        if (result.code !== 0) {
+            throw new errors_1.HarmonyCliError('ERR_HARMONY_MANIFEST_DRIFT', `Isolated Expo prebuild failed:\n${result.stderr || result.stdout}`, { exitCode: result.code, operation: 'check-prebuild' });
+        }
+        return (0, check_1.compareAsync)(project, expected);
+    }
+    finally {
+        if (packed)
+            await packed.cleanup();
+        await node_fs_1.default.promises.rm(temp, { recursive: true, force: true });
+    }
+}
+async function checkAsync(project, options = {}) {
+    return (0, projectLock_1.withHarmonyProjectLockAsync)(project, 'prebuild-check', () => checkUnlockedAsync(project, options));
+}

package/build/prebuild/clean.d.ts

@@ -0,0 +1,2 @@
+declare function assertSafeCleanTarget(projectRoot: any): Promise<string>;
+export { assertSafeCleanTarget };

package/build/prebuild/clean.js

@@ -0,0 +1,50 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.assertSafeCleanTarget = assertSafeCleanTarget;
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_path_1 = __importDefault(require("node:path"));
+const build_descriptor_1 = require("@expo-harmony/prebuild-config/build-descriptor");
+const errors_1 = require("../errors");
+const path_1 = require("../path");
+const tools_1 = require("../tools");
+async function assertSafeCleanTarget(projectRoot) {
+    const root = await node_fs_1.default.promises.realpath(projectRoot);
+    const plan = await (0, tools_1.resolveHarmonyBuildPlanIfPresentAsync)(root);
+    const target = plan?.harmonyRoot ?? node_path_1.default.join(root, build_descriptor_1.HarmonyPlatformDirectory);
+    let stat;
+    try {
+        stat = await node_fs_1.default.promises.lstat(target);
+    }
+    catch (error) {
+        if (error.code === 'ENOENT')
+            return target;
+        throw new errors_1.HarmonyCliError(error.code || 'ERR_HARMONY_CLEAN_TARGET', error.message || `Cannot inspect the Harmony clean target: ${target}. Please delete it manually.`, { cause: error, exitCode: error.exitCode, operation: error.operation });
+    }
+    if (!plan) {
+        throw new errors_1.HarmonyCliError('ERR_HARMONY_CLEAN_TARGET', `Refusing to clean ${target} because its CNG manifest is missing. Please delete it manually or run prebuild without --clean.`, { operation: 'clean' });
+    }
+    if (!stat.isDirectory() || stat.isSymbolicLink()) {
+        throw new errors_1.HarmonyCliError('ERR_HARMONY_CLEAN_TARGET', `Refusing to clean a non-directory or symlink: ${target}. Please delete it manually.`, {
+            operation: 'clean',
+        });
+    }
+    const real = await node_fs_1.default.promises.realpath(target);
+    if (real !== target || !(0, path_1.isInside)(root, real) || real === root || real === node_path_1.default.parse(real).root) {
+        throw new errors_1.HarmonyCliError('ERR_HARMONY_CLEAN_TARGET', `Unsafe Harmony clean target: ${real}. Please delete it manually.`, { operation: 'clean' });
+    }
+    const marker = plan.projectFiles.templateMarker;
+    let markerStat;
+    try {
+        markerStat = await node_fs_1.default.promises.lstat(marker);
+    }
+    catch (cause) {
+        throw new errors_1.HarmonyCliError('ERR_HARMONY_CLEAN_TARGET', `Refusing to clean ${real} because its template marker cannot be inspected. Please delete it manually.`, { cause, operation: 'clean' });
+    }
+    if (!(0, path_1.isInside)(real, marker) || !markerStat.isFile() || markerStat.isSymbolicLink()) {
+        throw new errors_1.HarmonyCliError('ERR_HARMONY_CLEAN_TARGET', `Refusing to clean ${real} because its template marker is unsafe. Please delete it manually.`, { operation: 'clean' });
+    }
+    return real;
+}

package/build/prebuild/options.d.ts

@@ -0,0 +1,10 @@
+declare function parsePrebuildArgs(argv: string[], options?: {
+    allowProject?: boolean;
+}): {
+    check: boolean;
+    clean: boolean;
+    help: boolean;
+    passthrough: string[];
+    project: string;
+};
+export { parsePrebuildArgs };

package/build/prebuild/options.js

@@ -0,0 +1,50 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parsePrebuildArgs = parsePrebuildArgs;
+const errors_1 = require("../errors");
+const args_1 = require("../args");
+const PrebuildOptions = {
+    ...args_1.CommonOptions,
+    'bun': { type: 'boolean' },
+    'check': { type: 'boolean' },
+    'clean': { type: 'boolean' },
+    'no-install': { type: 'boolean' },
+    'npm': { type: 'boolean' },
+    'platform': { short: 'p', type: 'string' },
+    'pnpm': { type: 'boolean' },
+    'skip-dependency-update': { type: 'string' },
+    'template': { short: 't', type: 'string' },
+    'yarn': { type: 'boolean' },
+};
+function parsePrebuildArgs(argv, options = {}) {
+    const { positionals, values } = (0, args_1.parseArgs)(PrebuildOptions, argv);
+    if (values.platform !== undefined) {
+        throw new errors_1.HarmonyCliError('ERR_HARMONY_CONFIG_INVALID', '--platform is fixed to harmony by expo-harmony.', { operation: 'parse-arguments' });
+    }
+    if (values.template !== undefined) {
+        throw new errors_1.HarmonyCliError('ERR_HARMONY_CONFIG_INVALID', '--template is managed by expo-harmony.', { operation: 'parse-arguments' });
+    }
+    if (positionals.length > (options.allowProject ? 1 : 0)) {
+        const unexpected = positionals[options.allowProject ? 1 : 0];
+        throw new errors_1.HarmonyCliError('ERR_HARMONY_CONFIG_INVALID', `Unexpected prebuild positional argument: ${unexpected}`, { operation: 'parse-arguments' });
+    }
+    const packageManagerFlags = ['npm', 'yarn', 'pnpm', 'bun'].filter(name => values[name]);
+    if (packageManagerFlags.length > 1) {
+        throw new errors_1.HarmonyCliError('ERR_HARMONY_CONFIG_INVALID', 'Choose at most one package manager: --npm, --yarn, --pnpm, or --bun.', { operation: 'parse-arguments' });
+    }
+    const passthrough = [];
+    for (const name of ['clean', 'npm', 'yarn', 'pnpm', 'bun', 'no-install']) {
+        if (values[name])
+            passthrough.push(`--${name}`);
+    }
+    if (values['skip-dependency-update'] !== undefined) {
+        passthrough.push('--skip-dependency-update', values['skip-dependency-update']);
+    }
+    return {
+        check: Boolean(values.check),
+        clean: Boolean(values.clean),
+        help: Boolean(values.help),
+        passthrough,
+        project: positionals[0],
+    };
+}

package/build/prebuild/prebuild.d.ts

@@ -0,0 +1,6 @@
+interface PrebuildOptions {
+    buildType?: 'debug' | 'release';
+    capture?: boolean;
+}
+declare function prebuildParsedAsync(projectRoot: string, passthrough: string[], options?: PrebuildOptions): Promise<import("../process").ProcessResult>;
+export { prebuildParsedAsync };

package/build/prebuild/prebuild.js

@@ -0,0 +1,62 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.prebuildParsedAsync = prebuildParsedAsync;
+const node_fs_1 = __importDefault(require("node:fs"));
+const errors_1 = require("../errors");
+const process_1 = require("../process");
+const projectLock_1 = require("../projectLock");
+const expo_1 = require("../expo");
+const tools_1 = require("../tools");
+const clean_1 = require("./clean");
+const template_1 = require("./template");
+async function prebuildParsedUnlockedAsync(projectRoot, passthrough, options = {}) {
+    if (passthrough.includes('--clean'))
+        await (0, clean_1.assertSafeCleanTarget)(projectRoot);
+    const expo = (0, expo_1.resolveExpoCli)(projectRoot);
+    const packed = await (0, template_1.packAsync)(projectRoot);
+    try {
+        const result = await (0, process_1.spawnAsync)(process.execPath, [
+            expo.cliPath,
+            'prebuild', projectRoot,
+            '--platform', 'harmony',
+            '--template', packed.tarball,
+            ...passthrough,
+        ], {
+            capture: Boolean(options.capture),
+            cwd: projectRoot,
+            env: {
+                ...(0, tools_1.createHarmonyToolchainEnv)(),
+                ...packed.env,
+                ...(options.buildType ? { EXPO_HARMONY_BUILD_TYPE: options.buildType } : {}),
+            },
+            operation: 'expo-prebuild',
+            outputLimit: 4 * 1024 * 1024,
+        });
+        if (result.code !== 0) {
+            const diagnostics = options.capture ? (0, process_1.formatDiagnostics)(result) : '';
+            throw new errors_1.HarmonyCliError('ERR_HARMONY_PREBUILD_FAILED', `Expo prebuild exited with code ${result.code}.${diagnostics ? `\n${diagnostics}` : ''}`, {
+                exitCode: result.code,
+                operation: 'expo-prebuild',
+            });
+        }
+        try {
+            const plan = await (0, tools_1.resolveHarmonyBuildPlanAsync)(projectRoot, {
+                buildMode: options.buildType,
+            });
+            await node_fs_1.default.promises.access(plan.projectFiles.templateMarker, node_fs_1.default.constants.R_OK);
+        }
+        catch (cause) {
+            throw new errors_1.HarmonyCliError('ERR_HARMONY_TEMPLATE_INVALID', 'Expo prebuild exited successfully but the Harmony marker or CNG manifest is invalid.', { cause, operation: 'verify-prebuild' });
+        }
+        return result;
+    }
+    finally {
+        await packed.cleanup();
+    }
+}
+async function prebuildParsedAsync(projectRoot, passthrough, options = {}) {
+    return (0, projectLock_1.withHarmonyProjectLockAsync)(projectRoot, 'prebuild', () => prebuildParsedUnlockedAsync(projectRoot, passthrough, options));
+}

package/build/prebuild/template.d.ts

@@ -0,0 +1,8 @@
+declare function packAsync(project: string): Promise<{
+    tarball: string;
+    env: {
+        [x: string]: string;
+    };
+    cleanup(): Promise<void>;
+}>;
+export { packAsync, };

package/build/prebuild/template.js

@@ -0,0 +1,86 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.packAsync = packAsync;
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_module_1 = require("node:module");
+const node_os_1 = __importDefault(require("node:os"));
+const node_path_1 = __importDefault(require("node:path"));
+const errors_1 = require("../errors");
+const process_1 = require("../process");
+function resolve(project) {
+    const load = (0, node_module_1.createRequire)(node_path_1.default.join(project, 'package.json'));
+    let api;
+    try {
+        api = load('@expo-harmony/prebuild-config/template');
+    }
+    catch (cause) {
+        throw new errors_1.HarmonyCliError('ERR_HARMONY_TEMPLATE_INVALID', 'Cannot load @expo-harmony/prebuild-config/template from the project. Update the project-local prebuild config to a compatible version.', { cause, operation: 'resolve-template' });
+    }
+    if (typeof api?.ROOT_ENV !== 'string' || typeof api.resolveBundled !== 'function') {
+        throw new errors_1.HarmonyCliError('ERR_HARMONY_TEMPLATE_INVALID', 'The project-local @expo-harmony/prebuild-config template API is invalid.', { operation: 'resolve-template' });
+    }
+    let template;
+    try {
+        template = api.resolveBundled();
+    }
+    catch (cause) {
+        throw new errors_1.HarmonyCliError('ERR_HARMONY_TEMPLATE_INVALID', 'Cannot resolve the Harmony template declared by the project-local prebuild config.', { cause, operation: 'resolve-template' });
+    }
+    if (!template
+        || typeof template.root !== 'string'
+        || !node_path_1.default.isAbsolute(template.root)
+        || typeof template.version !== 'string'
+        || !template.version) {
+        throw new errors_1.HarmonyCliError('ERR_HARMONY_TEMPLATE_INVALID', 'The project-local @expo-harmony/prebuild-config returned an invalid template descriptor.', { operation: 'resolve-template' });
+    }
+    return {
+        env: { [api.ROOT_ENV]: template.root },
+        root: template.root,
+    };
+}
+async function packAsync(project) {
+    const template = resolve(project);
+    const temp = await node_fs_1.default.promises.mkdtemp(node_path_1.default.join(node_os_1.default.tmpdir(), 'expo-harmony-template-'));
+    const result = await (0, process_1.spawnAsync)('npm', [
+        'pack',
+        '--json',
+        '--ignore-scripts',
+        '--cache', node_path_1.default.join(temp, '.npm-cache'),
+        '--pack-destination', temp,
+        template.root,
+    ], { capture: true, cwd: project, operation: 'pack-template' });
+    if (result.code !== 0) {
+        await node_fs_1.default.promises.rm(temp, { recursive: true, force: true });
+        throw new errors_1.HarmonyCliError('ERR_HARMONY_TEMPLATE_INVALID', `npm pack failed: ${result.stderr.trim()}`, {
+            exitCode: result.code,
+            operation: 'pack-template',
+        });
+    }
+    let packs;
+    try {
+        packs = JSON.parse(result.stdout);
+    }
+    catch (cause) {
+        await node_fs_1.default.promises.rm(temp, { recursive: true, force: true });
+        throw new errors_1.HarmonyCliError('ERR_HARMONY_TEMPLATE_INVALID', 'npm pack returned invalid JSON.', {
+            cause,
+            operation: 'pack-template',
+        });
+    }
+    const filename = packs?.[0]?.filename;
+    const tarball = filename && node_path_1.default.join(temp, filename);
+    if (!tarball || !node_fs_1.default.existsSync(tarball)) {
+        await node_fs_1.default.promises.rm(temp, { recursive: true, force: true });
+        throw new errors_1.HarmonyCliError('ERR_HARMONY_TEMPLATE_INVALID', 'npm pack did not create a template tarball.', { operation: 'pack-template' });
+    }
+    return {
+        tarball,
+        env: template.env,
+        async cleanup() {
+            await node_fs_1.default.promises.rm(temp, { recursive: true, force: true });
+        },
+    };
+}

package/build/process.d.ts

@@ -0,0 +1,31 @@
+export interface ProcessOptions {
+    capture?: boolean;
+    cwd?: string;
+    env?: NodeJS.ProcessEnv;
+    onStderr?: (chunk: Uint8Array) => void;
+    onStdout?: (chunk: Uint8Array) => void;
+    operation?: string;
+    outputLimit?: number;
+    signal?: AbortSignal;
+    stdio?: 'inherit' | 'pipe';
+    stopGraceMs?: number;
+    timeoutMs?: number;
+}
+export interface ProcessResult {
+    code: number;
+    signal: NodeJS.Signals | null;
+    stderr: string;
+    stdout: string;
+    timedOut: boolean;
+}
+declare function formatDiagnostics(result: Pick<ProcessResult, 'stderr' | 'stdout'>, limit?: number): string;
+declare function spawnAsync(command: string, args: string[], options?: ProcessOptions): Promise<ProcessResult>;
+declare function startManagedProcess(command: string, args: string[], options?: ProcessOptions): {
+    child: any;
+    completion: Promise<ProcessResult>;
+    getStderr: () => string;
+    getStdout: () => string;
+    stop: (signal?: NodeJS.Signals, graceMs?: number) => Promise<any>;
+    wasStopped: () => boolean;
+};
+export { formatDiagnostics, spawnAsync, startManagedProcess };