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

package/build/process.js

@@ -0,0 +1,324 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatDiagnostics = formatDiagnostics;
+exports.runCheckedAsync = runCheckedAsync;
+exports.spawnAsync = spawnAsync;
+exports.startManagedProcess = startManagedProcess;
+const cross_spawn_1 = __importDefault(require("cross-spawn"));
+const tool_command_1 = require("@expo-harmony/expo-modules-autolinking/tool-command");
+const errors_1 = require("./errors");
+const DefaultOutputLimit = 1024 * 1024;
+const DefaultStopGraceMs = 3_000;
+class BoundedCapture {
+    limit;
+    buffers = [];
+    head = 0;
+    length = 0;
+    constructor(limit) {
+        this.limit = limit;
+    }
+    append(value) {
+        const buffer = typeof value === 'string' ? new TextEncoder().encode(value) : Uint8Array.from(value);
+        if (buffer.length >= this.limit) {
+            this.buffers = [buffer.subarray(buffer.length - this.limit)];
+            this.head = 0;
+            this.length = this.limit;
+            return;
+        }
+        while (this.length + buffer.length > this.limit && this.head < this.buffers.length) {
+            const first = this.buffers[this.head];
+            const excess = this.length + buffer.length - this.limit;
+            if (first.length > excess) {
+                this.buffers[this.head] = first.subarray(excess);
+                this.length -= excess;
+                break;
+            }
+            this.length -= first.length;
+            this.head += 1;
+        }
+        this.buffers.push(buffer);
+        this.length += buffer.length;
+        if (this.head > 128 && this.head * 2 > this.buffers.length) {
+            this.buffers = this.buffers.slice(this.head);
+            this.head = 0;
+        }
+    }
+    toString() {
+        return Buffer.concat(this.buffers.slice(this.head), this.length).toString('utf8');
+    }
+}
+function formatDiagnostics(result, limit = 4_000) {
+    return (result.stderr || result.stdout || '').slice(-limit).trim();
+}
+function spawnAsync(command, args, options = {}) {
+    return new Promise((resolve, reject) => {
+        if (options.signal?.aborted) {
+            throw new errors_1.HarmonyCliError('ERR_HARMONY_PROCESS_FAILED', `Cannot run ${command}: operation aborted.`, {
+                cause: options.signal.reason,
+                operation: options.operation || 'spawn',
+            });
+        }
+        const piped = Boolean(options.capture || options.onStdout || options.onStderr);
+        const limit = options.outputLimit || DefaultOutputLimit;
+        const child = (0, cross_spawn_1.default)(command, args, {
+            cwd: options.cwd,
+            env: options.env || process.env,
+            shell: false,
+            stdio: piped ? ['ignore', 'pipe', 'pipe'] : 'inherit',
+            windowsHide: true,
+        });
+        const stdout = new BoundedCapture(limit);
+        const stderr = new BoundedCapture(limit);
+        let timedOut = false;
+        let settled = false;
+        let escalation = null;
+        let stopping;
+        if (piped) {
+            child.stdout.on('data', (chunk) => {
+                stdout.append(chunk);
+                options.onStdout?.(chunk);
+            });
+            child.stderr.on('data', (chunk) => {
+                stderr.append(chunk);
+                options.onStderr?.(chunk);
+            });
+        }
+        const stop = (signal = 'SIGTERM') => {
+            if (stopping || settled)
+                return;
+            stopping = Promise.resolve().then(() => (0, tool_command_1.terminateProcess)(child, signal));
+            if (process.platform === 'win32') {
+                void finish(null, signal);
+            }
+            else {
+                stopping.catch((cause) => {
+                    void finish(null, null, cause);
+                });
+                escalation = setTimeout(() => {
+                    stopping = (0, tool_command_1.terminateProcess)(child, 'SIGKILL');
+                    stopping.catch((cause) => {
+                        void finish(null, null, cause);
+                    });
+                }, options.stopGraceMs || DefaultStopGraceMs);
+                escalation.unref?.();
+            }
+        };
+        const interrupt = () => stop('SIGINT');
+        const terminate = () => stop('SIGTERM');
+        process.once('SIGINT', interrupt);
+        process.once('SIGTERM', terminate);
+        const timeout = options.timeoutMs
+            ? setTimeout(() => {
+                timedOut = true;
+                stop('SIGTERM');
+            }, options.timeoutMs)
+            : null;
+        timeout?.unref?.();
+        const cleanup = () => {
+            if (timeout)
+                clearTimeout(timeout);
+            if (escalation)
+                clearTimeout(escalation);
+            process.removeListener('SIGINT', interrupt);
+            process.removeListener('SIGTERM', terminate);
+            options.signal?.removeEventListener('abort', abort);
+        };
+        const finish = async (code, signal, cause) => {
+            try {
+                await stopping;
+            }
+            catch (error) {
+                cause = error;
+            }
+            if (settled)
+                return;
+            settled = true;
+            cleanup();
+            if (cause)
+                reject(new errors_1.HarmonyCliError('ERR_HARMONY_PROCESS_FAILED', `Cannot run ${command}: ${cause.message}`, {
+                    cause,
+                    operation: options.operation || 'spawn',
+                }));
+            else
+                resolve({
+                    code: code === null ? 1 : code,
+                    signal,
+                    stderr: stderr.toString(),
+                    stdout: stdout.toString(),
+                    timedOut,
+                });
+        };
+        child.once('error', (cause) => {
+            void finish(null, null, cause);
+        });
+        child.once('close', (code, signal) => {
+            void finish(code, signal);
+        });
+        const abort = () => stop('SIGTERM');
+        options.signal?.addEventListener('abort', abort, { once: true });
+        if (options.signal?.aborted)
+            abort();
+    });
+}
+function startManagedProcess(command, args, options = {}) {
+    if (options.signal?.aborted) {
+        throw new errors_1.HarmonyCliError('ERR_HARMONY_PROCESS_FAILED', `Cannot launch ${command}: operation aborted.`, {
+            cause: options.signal.reason,
+            operation: options.operation || 'spawn',
+        });
+    }
+    const limit = options.outputLimit || DefaultOutputLimit;
+    const piped = options.stdio !== 'inherit';
+    const child = (0, cross_spawn_1.default)(command, args, {
+        cwd: options.cwd,
+        env: options.env || process.env,
+        shell: false,
+        stdio: piped ? ['ignore', 'pipe', 'pipe'] : 'inherit',
+        windowsHide: true,
+    });
+    const stdout = new BoundedCapture(limit);
+    const stderr = new BoundedCapture(limit);
+    let failure = null;
+    let closed = false;
+    let stopped = false;
+    let stopping;
+    let stopPromise;
+    let finish;
+    if (piped) {
+        child.stdout.on('data', (chunk) => {
+            stdout.append(chunk);
+            options.onStdout?.(chunk);
+        });
+        child.stderr.on('data', (chunk) => {
+            stderr.append(chunk);
+            options.onStderr?.(chunk);
+        });
+    }
+    const interrupt = () => {
+        void stop('SIGINT').catch(() => { });
+    };
+    const terminate = () => {
+        void stop('SIGTERM').catch(() => { });
+    };
+    const abort = () => {
+        void stop('SIGTERM').catch(() => { });
+    };
+    const cleanup = () => {
+        process.removeListener('SIGINT', interrupt);
+        process.removeListener('SIGTERM', terminate);
+        options.signal?.removeEventListener('abort', abort);
+    };
+    const completion = new Promise((resolve, reject) => {
+        child.once('error', (cause) => {
+            failure = new errors_1.HarmonyCliError('ERR_HARMONY_PROCESS_FAILED', `Cannot launch ${command}: ${cause.message}`, {
+                cause,
+                operation: options.operation || 'spawn',
+            });
+        });
+        finish = async (code, signal) => {
+            try {
+                await stopping;
+            }
+            catch (cause) {
+                failure = new errors_1.HarmonyCliError('ERR_HARMONY_PROCESS_FAILED', `Cannot stop ${command}: ${cause.message}`, {
+                    cause, operation: options.operation || 'spawn',
+                });
+            }
+            if (closed)
+                return;
+            closed = true;
+            cleanup();
+            if (failure)
+                reject(failure);
+            else
+                resolve({
+                    code: code === null ? 1 : code,
+                    signal,
+                    stderr: stderr.toString(),
+                    stdout: stdout.toString(),
+                    timedOut: false,
+                });
+        };
+        child.once('close', (code, signal) => {
+            void finish(code, signal);
+        });
+    });
+    // A readiness probe may be the first consumer. Keep early spawn failures from
+    // becoming unhandled rejections while the probe is still polling.
+    completion.catch(() => { });
+    async function stop(signal = 'SIGTERM', graceMs = DefaultStopGraceMs) {
+        if (stopPromise)
+            return stopPromise;
+        if (closed)
+            return completion;
+        stopped = true;
+        stopping = Promise.resolve().then(() => (0, tool_command_1.terminateProcess)(child, signal));
+        stopPromise = (async () => {
+            if (process.platform === 'win32') {
+                void finish(null, signal);
+                return completion;
+            }
+            try {
+                await stopping;
+            }
+            catch {
+                await finish(null, signal);
+                return completion;
+            }
+            let timer;
+            await Promise.race([
+                completion.catch(() => undefined),
+                new Promise((resolve) => {
+                    timer = setTimeout(resolve, graceMs);
+                    timer.unref?.();
+                }),
+            ]);
+            if (timer)
+                clearTimeout(timer);
+            if (!closed) {
+                stopping = (0, tool_command_1.terminateProcess)(child, 'SIGKILL');
+                try {
+                    await stopping;
+                }
+                catch {
+                    await finish(null, signal);
+                }
+            }
+            return completion.catch(() => undefined);
+        })();
+        stopPromise.catch(() => { });
+        return stopPromise;
+    }
+    process.once('SIGINT', interrupt);
+    process.once('SIGTERM', terminate);
+    if (options.signal?.aborted)
+        abort();
+    else
+        options.signal?.addEventListener('abort', abort, { once: true });
+    return {
+        child,
+        completion,
+        getStderr: () => stderr.toString(),
+        getStdout: () => stdout.toString(),
+        stop,
+        wasStopped: () => stopped,
+    };
+}
+async function runCheckedAsync(command, args, options) {
+    const result = await spawnAsync(command, args, {
+        capture: true,
+        cwd: options.cwd,
+        env: options.env,
+        operation: options.operation,
+        outputLimit: options.outputLimit || 2 * 1024 * 1024,
+        timeoutMs: options.timeoutMs,
+    });
+    if (result.code !== 0 || result.timedOut) {
+        const diagnostics = formatDiagnostics(result);
+        throw new errors_1.HarmonyCliError(options.code, `${options.message} exited with code ${result.code}${result.timedOut ? ' after timing out' : ''}.${diagnostics ? `\n${diagnostics}` : ''}`, { exitCode: result.code || 1, operation: options.operation });
+    }
+    return result;
+}

package/build/profile.d.ts

@@ -0,0 +1 @@
+export declare function timedAsync<T>(steps: Record<string, number>, name: string, operation: () => Promise<T> | T): Promise<T>;

package/build/profile.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.timedAsync = timedAsync;
+async function timedAsync(steps, name, operation) {
+    const started = performance.now();
+    try {
+        return await operation();
+    }
+    finally {
+        steps[name] = Math.max(0, Math.round(performance.now() - started));
+    }
+}

package/build/project.d.ts

@@ -0,0 +1,2 @@
+declare function resolveProject(start?: string): string;
+export { resolveProject };

package/build/project.js

@@ -0,0 +1,23 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveProject = resolveProject;
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_path_1 = __importDefault(require("node:path"));
+const errors_1 = require("./errors");
+function resolveProject(start = process.cwd()) {
+    let current = node_path_1.default.resolve(start);
+    if (node_fs_1.default.existsSync(current) && node_fs_1.default.statSync(current).isFile())
+        current = node_path_1.default.dirname(current);
+    while (true) {
+        if (node_fs_1.default.existsSync(node_path_1.default.join(current, 'package.json')))
+            return node_fs_1.default.realpathSync(current);
+        const parent = node_path_1.default.dirname(current);
+        if (parent === current)
+            break;
+        current = parent;
+    }
+    throw new errors_1.HarmonyCliError('ERR_HARMONY_CONFIG_INVALID', `No package.json was found from ${start}.`, { operation: 'resolve-project' });
+}

package/build/projectLock.d.ts

@@ -0,0 +1,2 @@
+declare function withHarmonyProjectLockAsync<T>(projectRoot: string, operation: string, callback: () => Promise<T> | T): Promise<T>;
+export { withHarmonyProjectLockAsync };

package/build/projectLock.js

@@ -0,0 +1,185 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.withHarmonyProjectLockAsync = withHarmonyProjectLockAsync;
+const node_async_hooks_1 = require("node:async_hooks");
+const node_crypto_1 = __importDefault(require("node:crypto"));
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_path_1 = __importDefault(require("node:path"));
+const errors_1 = require("./errors");
+const DefaultMalformedLockGraceMs = 30_000;
+const DefaultPollIntervalMs = 100;
+const DefaultWaitTimeoutMs = 5_000;
+const LockRelativePath = '.expo/harmony/native-operation.lock';
+const ActiveLock = new node_async_hooks_1.AsyncLocalStorage();
+async function canonicalProjectRootAsync(projectRoot) {
+    try {
+        return await node_fs_1.default.promises.realpath(node_path_1.default.resolve(projectRoot));
+    }
+    catch (cause) {
+        throw new errors_1.HarmonyCliError('ERR_HARMONY_PROJECT_LOCK', 'Cannot resolve the application project before acquiring its Harmony native operation lock.', { cause, operation: 'project-lock' });
+    }
+}
+function projectLockPath(projectRoot) {
+    return node_path_1.default.join(projectRoot, ...LockRelativePath.split('/'));
+}
+async function processIsAliveAsync(pid) {
+    if (!Number.isInteger(pid) || Number(pid) <= 0)
+        return false;
+    try {
+        process.kill(Number(pid), 0);
+        return true;
+    }
+    catch (cause) {
+        return cause?.code !== 'ESRCH';
+    }
+}
+async function readLockOwnerAsync(lockPath) {
+    try {
+        const candidate = JSON.parse(await node_fs_1.default.promises.readFile(lockPath, 'utf8'));
+        if (!candidate
+            || typeof candidate !== 'object'
+            || !Number.isInteger(candidate.pid)
+            || candidate.pid <= 0
+            || typeof candidate.createdAt !== 'string'
+            || typeof candidate.operation !== 'string'
+            || typeof candidate.projectRoot !== 'string'
+            || typeof candidate.token !== 'string') {
+            return null;
+        }
+        return candidate;
+    }
+    catch (_cause) {
+        return null;
+    }
+}
+async function removeStaleProjectLockAsync(lockPath) {
+    let observed;
+    try {
+        observed = await node_fs_1.default.promises.lstat(lockPath);
+    }
+    catch (_cause) {
+        return false;
+    }
+    if (!observed.isFile() || observed.isSymbolicLink())
+        return false;
+    const owner = await readLockOwnerAsync(lockPath);
+    if (owner) {
+        if (await processIsAliveAsync(owner.pid))
+            return false;
+    }
+    else if (Date.now() - observed.mtimeMs < DefaultMalformedLockGraceMs) {
+        return false;
+    }
+    try {
+        const current = await node_fs_1.default.promises.lstat(lockPath);
+        if (!current.isFile() || current.isSymbolicLink()
+            || current.dev !== observed.dev
+            || current.ino !== observed.ino
+            || current.mtimeMs !== observed.mtimeMs
+            || current.size !== observed.size) {
+            return false;
+        }
+        await node_fs_1.default.promises.unlink(lockPath);
+        return true;
+    }
+    catch (_cause) {
+        return false;
+    }
+}
+async function releaseOwnedLockAsync(handle, lockPath, owned) {
+    await handle.close().catch(() => { });
+    if (!owned)
+        return false;
+    try {
+        const current = await node_fs_1.default.promises.lstat(lockPath);
+        if (!current.isFile() || current.isSymbolicLink()
+            || current.dev !== owned.dev || current.ino !== owned.ino) {
+            return false;
+        }
+        await node_fs_1.default.promises.unlink(lockPath);
+        return true;
+    }
+    catch (_cause) {
+        return false;
+    }
+}
+function delayAsync(milliseconds) {
+    return new Promise(resolve => setTimeout(resolve, milliseconds));
+}
+async function acquireHarmonyProjectLockAsync(projectRoot, operation) {
+    const canonicalRoot = await canonicalProjectRootAsync(projectRoot);
+    const lockPath = projectLockPath(canonicalRoot);
+    const deadline = Date.now() + DefaultWaitTimeoutMs;
+    await node_fs_1.default.promises.mkdir(node_path_1.default.dirname(lockPath), { recursive: true });
+    while (true) {
+        try {
+            const handle = await node_fs_1.default.promises.open(lockPath, 'wx', 0o600);
+            let owned;
+            const owner = {
+                createdAt: new Date().toISOString(),
+                operation,
+                pid: process.pid,
+                projectRoot: canonicalRoot,
+                token: node_crypto_1.default.randomUUID(),
+            };
+            try {
+                owned = await handle.stat();
+                await handle.writeFile(`${JSON.stringify(owner)}\n`);
+                await handle.sync();
+            }
+            catch (cause) {
+                await releaseOwnedLockAsync(handle, lockPath, owned);
+                throw new errors_1.HarmonyCliError('ERR_HARMONY_PROJECT_LOCK', 'Cannot initialize the Harmony native operation lock.', { cause, operation: 'project-lock' });
+            }
+            let released = false;
+            return {
+                async releaseAsync() {
+                    if (released)
+                        return;
+                    released = true;
+                    if (await releaseOwnedLockAsync(handle, lockPath, owned))
+                        return;
+                    throw new errors_1.HarmonyCliError('ERR_HARMONY_PROJECT_LOCK', 'The Harmony native operation lock changed before it could be released safely.', { operation: 'project-lock' });
+                },
+            };
+        }
+        catch (cause) {
+            if (cause instanceof errors_1.HarmonyCliError) {
+                throw new errors_1.HarmonyCliError(cause.code, cause.message, {
+                    cause,
+                    exitCode: cause.exitCode,
+                    operation: cause.operation,
+                });
+            }
+            if (cause?.code !== 'EEXIST') {
+                throw new errors_1.HarmonyCliError('ERR_HARMONY_PROJECT_LOCK', 'Cannot acquire the Harmony native operation lock.', { cause, operation: 'project-lock' });
+            }
+            if (await removeStaleProjectLockAsync(lockPath))
+                continue;
+            if (Date.now() >= deadline) {
+                const owner = await readLockOwnerAsync(lockPath);
+                const detail = owner?.operation ? ` (${owner.operation}, pid ${owner.pid})` : '';
+                throw new errors_1.HarmonyCliError('ERR_HARMONY_PROJECT_BUSY', `Another Harmony native operation is using this project${detail}. Retry after it finishes.`, { operation });
+            }
+            await delayAsync(Math.min(DefaultPollIntervalMs, Math.max(1, deadline - Date.now())));
+        }
+    }
+}
+async function withHarmonyProjectLockAsync(projectRoot, operation, callback) {
+    const canonicalRoot = await canonicalProjectRootAsync(projectRoot);
+    const active = ActiveLock.getStore();
+    if (active?.projectRoot === canonicalRoot && !active.released)
+        return await callback();
+    const lease = await acquireHarmonyProjectLockAsync(canonicalRoot, operation);
+    const context = { projectRoot: canonicalRoot, released: false };
+    try {
+        return await ActiveLock.run(context, callback);
+    }
+    finally {
+        context.released = true;
+        await lease.releaseAsync();
+    }
+}

package/build/run/devices.d.ts

@@ -0,0 +1,29 @@
+import { type HarmonyTool } from '../native/toolchain';
+interface Device {
+    aliases: string[];
+    connectTool: string | null;
+    id: string;
+    location: string | null;
+    state: string;
+    transport: string;
+}
+interface HdcOptions {
+    allowFailure?: boolean;
+    code?: string;
+    cwd?: string;
+    devicePort?: number;
+    message?: string;
+    operation?: string;
+    outputLimit?: number;
+    timeoutMs?: number;
+}
+interface DeviceSelectionOptions extends HdcOptions {
+    emulator?: HarmonyTool;
+    emulatorLogFile?: string;
+    onProgress?: (message: string) => void;
+}
+declare function selectDeviceAsync(hdc: HarmonyTool, requested?: string, options?: DeviceSelectionOptions): Promise<Device>;
+declare function installHapAsync(hdc: HarmonyTool, device: Device, hap: string, options?: HdcOptions): Promise<void>;
+declare function configureMetroPortAsync(hdc: HarmonyTool, device: Device, port: number, options?: HdcOptions): Promise<void>;
+declare function launchAppAsync(hdc: HarmonyTool, device: Device, bundleName: string, abilityName: string, options?: HdcOptions): Promise<void>;
+export { configureMetroPortAsync, installHapAsync, launchAppAsync, selectDeviceAsync, };