eas-cli 20.0.0 → 20.2.0

package/build/commands/simulator/exec.d.ts

@@ -0,0 +1,12 @@
+import EasCommand from '../../commandUtils/EasCommand';
+export default class SimulatorExec extends EasCommand {
+    static hidden: boolean;
+    static description: string;
+    static strict: boolean;
+    static contextDefinition: {
+        projectDir: import("../../commandUtils/context/ProjectDirContextField").default;
+    };
+    private isRunningSubprocess;
+    runAsync(): Promise<void>;
+    protected catch(err: Error): Promise<any>;
+}

package/build/commands/simulator/exec.js

@@ -0,0 +1,42 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+const spawn_async_1 = tslib_1.__importDefault(require("@expo/spawn-async"));
+const EasCommand_1 = tslib_1.__importDefault(require("../../commandUtils/EasCommand"));
+const env_1 = require("../../simulator/env");
+class SimulatorExec extends EasCommand_1.default {
+    static hidden = true;
+    static description = `[EXPERIMENTAL] execute a simulator command with ${env_1.SIMULATOR_DOTENV_FILE_NAME} environment loaded`;
+    static strict = false;
+    static contextDefinition = {
+        ...this.ContextOptions.ProjectDir,
+    };
+    isRunningSubprocess = false;
+    async runAsync() {
+        const rawArgv = [...this.argv];
+        // Required to avoid `Warning: Command exec did not parse its arguments. Did you forget to call 'this.parse'?`
+        await this.parse(SimulatorExec, []);
+        const [command, ...args] = rawArgv;
+        if (typeof command !== 'string' || command.length === 0) {
+            throw new Error('No command provided. Run `eas simulator:exec <command> [args...]`.');
+        }
+        const { projectDir } = await this.getContextAsync(SimulatorExec, {
+            nonInteractive: true,
+        });
+        await (0, env_1.loadSimulatorEnvAsync)(projectDir);
+        this.isRunningSubprocess = true;
+        await (0, spawn_async_1.default)(command, args, {
+            stdio: 'inherit',
+            env: process.env,
+        });
+    }
+    catch(err) {
+        // Propagate wrapped command from spawnAsync rejection
+        if (this.isRunningSubprocess) {
+            process.exitCode = process.exitCode ?? err.status ?? 1;
+            return Promise.resolve();
+        }
+        return super.catch(err);
+    }
+}
+exports.default = SimulatorExec;

package/build/commands/simulator/get.d.ts

@@ -5,9 +5,10 @@ export default class SimulatorGet extends EasCommand {
     static flags: {
         json: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
         'non-interactive': import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
-        id: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+        id: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
     };
     static contextDefinition: {
+        projectDir: import("../../commandUtils/context/ProjectDirContextField").default;
         loggedIn: import("../../commandUtils/context/LoggedInContextField").default;
     };
     runAsync(): Promise<void>;

package/build/commands/simulator/get.js

@@ -9,6 +9,7 @@ const generated_1 = require("../../graphql/generated");
 const DeviceRunSessionQuery_1 = require("../../graphql/queries/DeviceRunSessionQuery");
 const log_1 = tslib_1.__importStar(require("../../log"));
 const ora_1 = require("../../ora");
+const env_1 = require("../../simulator/env");
 const utils_1 = require("../../simulator/utils");
 const json_1 = require("../../utils/json");
 class SimulatorGet extends EasCommand_1.default {
@@ -16,13 +17,13 @@ class SimulatorGet extends EasCommand_1.default {
     static description = '[EXPERIMENTAL] get info about a remote simulator session on EAS by its device run session ID';
     static flags = {
         id: core_1.Flags.string({
-            description: 'Device run session ID',
-            required: true,
+            description: `Device run session ID. Defaults to ${env_1.SIMULATOR_DOTENV_FILE_NAME}.`,
         }),
         ...flags_1.EasNonInteractiveAndJsonFlags,
     };
     static contextDefinition = {
         ...this.ContextOptions.LoggedIn,
+        ...this.ContextOptions.ProjectDir,
     };
     async runAsync() {
         const { flags } = await this.parse(SimulatorGet);
@@ -30,17 +31,22 @@ class SimulatorGet extends EasCommand_1.default {
         if (jsonFlag) {
             (0, json_1.enableJsonOutput)();
         }
-        const { loggedIn: { graphqlClient }, } = await this.getContextAsync(SimulatorGet, {
+        const { projectDir, loggedIn: { graphqlClient }, } = await this.getContextAsync(SimulatorGet, {
             nonInteractive,
         });
-        const fetchSpinner = (0, ora_1.ora)(`Fetching device run session ${flags.id}`).start();
+        await (0, env_1.loadSimulatorEnvAsync)(projectDir);
+        const flagId = flags.id || process.env[env_1.EAS_SIMULATOR_SESSION_ID];
+        if (!flagId) {
+            throw new Error(`No simulator session ID provided. Pass --id, or run \`eas simulator:start\` first to write ${env_1.SIMULATOR_DOTENV_FILE_NAME}.`);
+        }
+        const fetchSpinner = (0, ora_1.ora)(`Fetching device run session ${flagId}`).start();
         let session;
         try {
-            session = await DeviceRunSessionQuery_1.DeviceRunSessionQuery.byIdAsync(graphqlClient, flags.id);
+            session = await DeviceRunSessionQuery_1.DeviceRunSessionQuery.byIdAsync(graphqlClient, flagId);
             fetchSpinner.succeed(`Fetched device run session ${session.id}`);
         }
         catch (err) {
-            fetchSpinner.fail(`Failed to fetch device run session ${flags.id}`);
+            fetchSpinner.fail(`Failed to fetch device run session ${flagId}`);
             throw err;
         }
         const jobRunUrl = session.turtleJobRun
@@ -64,7 +70,7 @@ class SimulatorGet extends EasCommand_1.default {
         if (session.status === generated_1.DeviceRunSessionStatus.InProgress) {
             log_1.default.newLine();
             if (session.remoteConfig) {
-                log_1.default.log((0, utils_1.formatRemoteSessionInstructions)(session.remoteConfig));
+                log_1.default.log((0, utils_1.formatRemoteSessionInstructions)(session.remoteConfig, 'env'));
             }
             else {
                 log_1.default.log('⏳ Session is starting up — remote config is not available yet. Re-run this command in a moment.');

package/build/commands/simulator/start.d.ts

@@ -8,9 +8,13 @@ export default class SimulatorStart extends EasCommand {
         platform: import("@oclif/core/lib/interfaces").OptionFlag<"android" | "ios", import("@oclif/core/lib/interfaces").CustomOptions>;
         type: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
         'package-version': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'max-duration-minutes': import("@oclif/core/lib/interfaces").OptionFlag<number | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        force: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        'out-config-type': import("@oclif/core/lib/interfaces").OptionFlag<"env" | "dotenv", import("@oclif/core/lib/interfaces").CustomOptions>;
     };
     static contextDefinition: {
         loggedIn: import("../../commandUtils/context/LoggedInContextField").default;
+        projectDir: import("../../commandUtils/context/ProjectDirContextField").default;
         projectId: import("../../commandUtils/context/ProjectIdContextField").ProjectIdContextField;
     };
     runAsync(): Promise<void>;

package/build/commands/simulator/start.js

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 const tslib_1 = require("tslib");
 const core_1 = require("@oclif/core");
+const nullthrows_1 = tslib_1.__importDefault(require("nullthrows"));
 const url_1 = require("../../build/utils/url");
 const EasCommand_1 = tslib_1.__importDefault(require("../../commandUtils/EasCommand"));
 const flags_1 = require("../../commandUtils/flags");
@@ -10,12 +11,16 @@ const DeviceRunSessionMutation_1 = require("../../graphql/mutations/DeviceRunSes
 const DeviceRunSessionQuery_1 = require("../../graphql/queries/DeviceRunSessionQuery");
 const log_1 = tslib_1.__importStar(require("../../log"));
 const ora_1 = require("../../ora");
+const env_1 = require("../../simulator/env");
 const utils_1 = require("../../simulator/utils");
 const json_1 = require("../../utils/json");
 const promise_1 = require("../../utils/promise");
-const nullthrows_1 = tslib_1.__importDefault(require("nullthrows"));
 const POLL_INTERVAL_MS = 5_000; // 5 seconds
 const POLL_TIMEOUT_MS = 15 * 60 * 1_000; // 15 minutes
+const OUT_CONFIG_TYPE_VALUES = {
+    Env: 'env',
+    Dotenv: 'dotenv',
+};
 class SimulatorStart extends EasCommand_1.default {
     static hidden = true;
     static description = '[EXPERIMENTAL] start a remote simulator session on EAS and get instructions to connect to it';
@@ -33,10 +38,25 @@ class SimulatorStart extends EasCommand_1.default {
         'package-version': core_1.Flags.string({
             description: 'Version of the package backing the device run session (e.g. "0.1.3-alpha.3"). Defaults to "latest" when omitted.',
         }),
+        'max-duration-minutes': core_1.Flags.integer({
+            description: 'Maximum duration of the device run session in minutes before it is automatically stopped. Only customizable on paid plans. Defaults to a value derived from the job run priority when omitted.',
+            min: 0,
+        }),
+        force: core_1.Flags.boolean({
+            description: '[default: true] Create a new device session even when an existing simulator session is present in the environment.',
+            default: true,
+            allowNo: true,
+        }),
+        'out-config-type': core_1.Flags.option({
+            description: `How to output simulator connection configuration. Use "env" to print shell exports, or "dotenv" to write ${env_1.SIMULATOR_DOTENV_FILE_NAME}.`,
+            options: Object.values(OUT_CONFIG_TYPE_VALUES),
+            default: OUT_CONFIG_TYPE_VALUES.Dotenv,
+        })(),
         ...flags_1.EasNonInteractiveAndJsonFlags,
     };
     static contextDefinition = {
         ...this.ContextOptions.ProjectId,
+        ...this.ContextOptions.ProjectDir,
         ...this.ContextOptions.LoggedIn,
     };
     async runAsync() {
@@ -45,9 +65,20 @@ class SimulatorStart extends EasCommand_1.default {
         if (jsonFlag) {
             (0, json_1.enableJsonOutput)();
         }
-        const { projectId, loggedIn: { graphqlClient }, } = await this.getContextAsync(SimulatorStart, {
+        const { projectId, projectDir, loggedIn: { graphqlClient }, } = await this.getContextAsync(SimulatorStart, {
             nonInteractive,
         });
+        await (0, env_1.loadSimulatorEnvAsync)(projectDir);
+        const existingDeviceRunSessionId = process.env[env_1.EAS_SIMULATOR_SESSION_ID];
+        if (existingDeviceRunSessionId && !flags.force) {
+            throw new Error(`Existing simulator session in environment. Use --force to create a new device session.`);
+        }
+        if (existingDeviceRunSessionId) {
+            log_1.default.warn(`  Overwriting previous simulator session (id: ${existingDeviceRunSessionId}). ` +
+                `The previous remote session will continue running until stopped. ` +
+                `To stop it, run: eas simulator:stop --id ${existingDeviceRunSessionId}`);
+            log_1.default.newLine();
+        }
         const platform = flags.platform === 'android' ? generated_1.AppPlatform.Android : generated_1.AppPlatform.Ios;
         const createSpinner = (0, ora_1.ora)('🚀 Creating device run session').start();
         let deviceRunSessionId;
@@ -58,11 +89,17 @@ class SimulatorStart extends EasCommand_1.default {
                 platform,
                 type: utils_1.DEVICE_RUN_SESSION_TYPE_BY_FLAG_VALUE[flags.type],
                 packageVersion: flags['package-version'],
+                maxRunTimeMinutes: flags['max-duration-minutes'],
             });
             deviceRunSessionId = session.id;
             const jobRunId = (0, nullthrows_1.default)(session.turtleJobRun?.id, 'Expected device run session to start');
             jobRunUrl = (0, url_1.getBareJobRunUrl)(session.app.ownerAccount.name, session.app.slug, jobRunId);
-            createSpinner.succeed(`Device run session created (id: ${deviceRunSessionId}) ${(0, log_1.link)(jobRunUrl)}`);
+            const simulatorEnvWritten = !jsonFlag && flags['out-config-type'] === OUT_CONFIG_TYPE_VALUES.Dotenv
+                ? await writeSimulatorEnvSafelyAsync(projectDir, {
+                    [env_1.EAS_SIMULATOR_SESSION_ID]: deviceRunSessionId,
+                })
+                : false;
+            createSpinner.succeed(`Device run session created (id: ${deviceRunSessionId}${simulatorEnvWritten ? `, saved to ${env_1.SIMULATOR_DOTENV_FILE_NAME}` : ''}) ${(0, log_1.link)(jobRunUrl)}`);
         }
         catch (err) {
             createSpinner.fail('Failed to create device run session');
@@ -102,6 +139,12 @@ class SimulatorStart extends EasCommand_1.default {
             await ensureDeviceRunSessionStoppedSafelyAsync(graphqlClient, deviceRunSessionId);
             throw new Error(`Timed out after ${Math.round(POLL_TIMEOUT_MS / 1000)}s waiting for ${flags.type} session to be ready. ${(0, log_1.link)(jobRunUrl)}`);
         }
+        if (flags['out-config-type'] === OUT_CONFIG_TYPE_VALUES.Dotenv) {
+            await writeSimulatorEnvSafelyAsync(projectDir, {
+                ...(0, utils_1.getRemoteSessionEnvironmentVariables)(remoteConfig),
+                [env_1.EAS_SIMULATOR_SESSION_ID]: deviceRunSessionId,
+            });
+        }
         if (jsonFlag) {
             (0, json_1.printJsonOnlyOutput)({
                 id: deviceRunSessionId,
@@ -112,7 +155,7 @@ class SimulatorStart extends EasCommand_1.default {
             return;
         }
         log_1.default.newLine();
-        log_1.default.log((0, utils_1.formatRemoteSessionInstructions)(remoteConfig));
+        log_1.default.log((0, utils_1.formatRemoteSessionInstructions)(remoteConfig, flags['out-config-type']));
         log_1.default.newLine();
         if (nonInteractive) {
             log_1.default.log(`When you are done, stop the session with: eas simulator:stop --id ${deviceRunSessionId}`);
@@ -122,11 +165,22 @@ class SimulatorStart extends EasCommand_1.default {
             graphqlClient,
             deviceRunSessionId,
             jobRunUrl,
+            projectDir,
         });
     }
 }
 exports.default = SimulatorStart;
-async function waitForSessionEndOrInterruptAsync({ graphqlClient, deviceRunSessionId, jobRunUrl, }) {
+async function writeSimulatorEnvSafelyAsync(projectDir, environmentVariables) {
+    try {
+        await (0, env_1.writeSimulatorEnvAsync)(projectDir, environmentVariables);
+        return true;
+    }
+    catch (err) {
+        log_1.default.warn(`Failed to write simulator environment variables to ${env_1.SIMULATOR_DOTENV_FILE_NAME}: ${err instanceof Error ? err.message : String(err)}`);
+        return false;
+    }
+}
+async function waitForSessionEndOrInterruptAsync({ graphqlClient, deviceRunSessionId, jobRunUrl, projectDir, }) {
     const spinner = (0, ora_1.ora)(`Device run session active — press Ctrl+C to stop, or run \`eas simulator:stop --id ${deviceRunSessionId}\` from another shell`).start();
     const abortController = new AbortController();
     const { signal } = abortController;
@@ -166,6 +220,7 @@ async function waitForSessionEndOrInterruptAsync({ graphqlClient, deviceRunSessi
                 jobRunStatus === generated_1.JobRunStatus.Canceled ||
                 jobRunStatus === generated_1.JobRunStatus.Finished) {
                 spinner.succeed(`Device run session ended. ${(0, log_1.link)(jobRunUrl)}`);
+                await resetSimulatorEnvVerboseAsync(projectDir);
                 return;
             }
             await Promise.race([(0, promise_1.sleepAsync)(POLL_INTERVAL_MS), abortPromise]);
@@ -174,6 +229,7 @@ async function waitForSessionEndOrInterruptAsync({ graphqlClient, deviceRunSessi
         const stopped = await ensureDeviceRunSessionStoppedSafelyAsync(graphqlClient, deviceRunSessionId);
         if (stopped) {
             spinner.succeed('Device run session stopped');
+            await resetSimulatorEnvVerboseAsync(projectDir);
         }
         else {
             spinner.fail(`Could not confirm the device run session was stopped. Run \`eas simulator:stop --id ${deviceRunSessionId}\` to terminate it and avoid unexpected charges.`);
@@ -183,6 +239,15 @@ async function waitForSessionEndOrInterruptAsync({ graphqlClient, deviceRunSessi
         process.removeListener('SIGINT', sigintHandler);
     }
 }
+async function resetSimulatorEnvVerboseAsync(projectDir) {
+    try {
+        await (0, env_1.resetSimulatorEnvAsync)(projectDir);
+    }
+    catch (err) {
+        log_1.default.error(`Failed to clean up ${env_1.SIMULATOR_DOTENV_FILE_NAME}`);
+        throw err;
+    }
+}
 async function ensureDeviceRunSessionStoppedSafelyAsync(graphqlClient, deviceRunSessionId) {
     try {
         await DeviceRunSessionMutation_1.DeviceRunSessionMutation.ensureDeviceRunSessionStoppedAsync(graphqlClient, deviceRunSessionId);

package/build/commands/simulator/stop.d.ts

@@ -5,9 +5,10 @@ export default class SimulatorStop extends EasCommand {
     static flags: {
         json: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
         'non-interactive': import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
-        id: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+        id: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
     };
     static contextDefinition: {
+        projectDir: import("../../commandUtils/context/ProjectDirContextField").default;
         loggedIn: import("../../commandUtils/context/LoggedInContextField").default;
     };
     runAsync(): Promise<void>;

package/build/commands/simulator/stop.js

@@ -6,19 +6,20 @@ const EasCommand_1 = tslib_1.__importDefault(require("../../commandUtils/EasComm
 const flags_1 = require("../../commandUtils/flags");
 const DeviceRunSessionMutation_1 = require("../../graphql/mutations/DeviceRunSessionMutation");
 const ora_1 = require("../../ora");
+const env_1 = require("../../simulator/env");
 const json_1 = require("../../utils/json");
 class SimulatorStop extends EasCommand_1.default {
     static hidden = true;
     static description = '[EXPERIMENTAL] stop a remote simulator session on EAS by its device run session ID';
     static flags = {
         id: core_1.Flags.string({
-            description: 'Device run session ID',
-            required: true,
+            description: `Device run session ID. Defaults to ${env_1.SIMULATOR_DOTENV_FILE_NAME}.`,
         }),
         ...flags_1.EasNonInteractiveAndJsonFlags,
     };
     static contextDefinition = {
         ...this.ContextOptions.LoggedIn,
+        ...this.ContextOptions.ProjectDir,
     };
     async runAsync() {
         const { flags } = await this.parse(SimulatorStop);
@@ -26,21 +27,27 @@ class SimulatorStop extends EasCommand_1.default {
         if (jsonFlag) {
             (0, json_1.enableJsonOutput)();
         }
-        const { loggedIn: { graphqlClient }, } = await this.getContextAsync(SimulatorStop, {
+        const { projectDir, loggedIn: { graphqlClient }, } = await this.getContextAsync(SimulatorStop, {
             nonInteractive,
         });
-        const stopSpinner = (0, ora_1.ora)(`🛑 Stopping device run session ${flags.id}`).start();
+        await (0, env_1.loadSimulatorEnvAsync)(projectDir);
+        const flagId = flags.id || process.env[env_1.EAS_SIMULATOR_SESSION_ID];
+        if (!flagId) {
+            throw new Error(`No simulator session ID provided. Pass --id, or run \`eas simulator:start\` first to write ${env_1.SIMULATOR_DOTENV_FILE_NAME}.`);
+        }
+        const stopSpinner = (0, ora_1.ora)(`🛑 Stopping device run session ${flagId}`).start();
+        let session;
         try {
-            const session = await DeviceRunSessionMutation_1.DeviceRunSessionMutation.ensureDeviceRunSessionStoppedAsync(graphqlClient, flags.id);
+            session = await DeviceRunSessionMutation_1.DeviceRunSessionMutation.ensureDeviceRunSessionStoppedAsync(graphqlClient, flagId);
             stopSpinner.succeed(`🎉 Device run session ${session.id} is ${session.status.toLowerCase()}`);
-            if (jsonFlag) {
-                (0, json_1.printJsonOnlyOutput)({ id: session.id, status: session.status });
-            }
         }
         catch (err) {
-            stopSpinner.fail(`Failed to stop device run session ${flags.id}`);
+            stopSpinner.fail(`Failed to stop device run session ${flagId}`);
             throw err;
         }
+        if (jsonFlag) {
+            (0, json_1.printJsonOnlyOutput)({ id: session.id, status: session.status });
+        }
     }
 }
 exports.default = SimulatorStop;

package/build/commands/update/embedded/delete.d.ts

@@ -0,0 +1,15 @@
+import EasCommand from '../../../commandUtils/EasCommand';
+export default class UpdateEmbeddedDelete extends EasCommand {
+    static description: string;
+    static args: {
+        id: import("@oclif/core/lib/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static flags: {
+        json: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        'non-interactive': import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+    };
+    static contextDefinition: {
+        loggedIn: import("../../../commandUtils/context/LoggedInContextField").default;
+    };
+    runAsync(): Promise<void>;
+}

package/build/commands/update/embedded/delete.js

@@ -0,0 +1,55 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+const core_1 = require("@oclif/core");
+const EasCommand_1 = tslib_1.__importDefault(require("../../../commandUtils/EasCommand"));
+const flags_1 = require("../../../commandUtils/flags");
+const EmbeddedUpdateMutation_1 = require("../../../graphql/mutations/EmbeddedUpdateMutation");
+const log_1 = tslib_1.__importDefault(require("../../../log"));
+const prompts_1 = require("../../../prompts");
+const json_1 = require("../../../utils/json");
+class UpdateEmbeddedDelete extends EasCommand_1.default {
+    static description = 'delete an embedded update registered with EAS Update';
+    static args = {
+        id: core_1.Args.string({
+            required: true,
+            description: 'The ID of the embedded update (manifest UUID from app.manifest).',
+        }),
+    };
+    static flags = {
+        ...flags_1.EasNonInteractiveAndJsonFlags,
+    };
+    static contextDefinition = {
+        ...this.ContextOptions.LoggedIn,
+    };
+    async runAsync() {
+        const { args: { id: embeddedUpdateId }, flags, } = await this.parse(UpdateEmbeddedDelete);
+        const { json: jsonFlag, nonInteractive } = (0, flags_1.resolveNonInteractiveAndJsonFlags)(flags);
+        const { loggedIn: { graphqlClient }, } = await this.getContextAsync(UpdateEmbeddedDelete, { nonInteractive });
+        if (jsonFlag) {
+            (0, json_1.enableJsonOutput)();
+        }
+        if (!nonInteractive) {
+            log_1.default.log(`You are about to permanently delete embedded update: "${embeddedUpdateId}". ` +
+                `Diff patches already generated against this bundle keep serving, but new diffs ` +
+                `can't be generated until you re-upload it.`);
+            log_1.default.newLine();
+            const confirmed = await (0, prompts_1.toggleConfirmAsync)({ message: 'Are you sure you wish to proceed?' });
+            if (!confirmed) {
+                log_1.default.error(`Canceled deletion of embedded update: "${embeddedUpdateId}".`);
+                process.exit(1);
+            }
+        }
+        // Best-effort delete on the server: deleting an unknown id succeeds (idempotent),
+        // so we don't need a not-found branch here.
+        await EmbeddedUpdateMutation_1.EmbeddedUpdateMutation.deleteEmbeddedUpdateAsync(graphqlClient, {
+            id: embeddedUpdateId,
+        });
+        if (jsonFlag) {
+            (0, json_1.printJsonOnlyOutput)({ id: embeddedUpdateId });
+            return;
+        }
+        log_1.default.withTick(`Deleted embedded update ${embeddedUpdateId}`);
+    }
+}
+exports.default = UpdateEmbeddedDelete;

package/build/commands/update/embedded/list.d.ts

@@ -0,0 +1,19 @@
+import { Platform } from '@expo/eas-build-job';
+import EasCommand from '../../../commandUtils/EasCommand';
+export default class UpdateEmbeddedList extends EasCommand {
+    static description: string;
+    static flags: {
+        json: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        'non-interactive': import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        platform: import("@oclif/core/lib/interfaces").OptionFlag<Platform | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'runtime-version': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        channel: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        limit: import("@oclif/core/lib/interfaces").OptionFlag<number | undefined>;
+        'after-cursor': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+    };
+    static contextDefinition: {
+        loggedIn: import("../../../commandUtils/context/LoggedInContextField").default;
+        projectId: import("../../../commandUtils/context/ProjectIdContextField").ProjectIdContextField;
+    };
+    runAsync(): Promise<void>;
+}

package/build/commands/update/embedded/list.js

@@ -0,0 +1,132 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+const eas_build_job_1 = require("@expo/eas-build-job");
+const core_1 = require("@oclif/core");
+const chalk_1 = tslib_1.__importDefault(require("chalk"));
+const EasCommand_1 = tslib_1.__importDefault(require("../../../commandUtils/EasCommand"));
+const flags_1 = require("../../../commandUtils/flags");
+const pagination_1 = require("../../../commandUtils/pagination");
+const ChannelQuery_1 = require("../../../graphql/queries/ChannelQuery");
+const EmbeddedUpdateQuery_1 = require("../../../graphql/queries/EmbeddedUpdateQuery");
+const AppPlatform_1 = require("../../../graphql/types/AppPlatform");
+const log_1 = tslib_1.__importDefault(require("../../../log"));
+const prompts_1 = require("../../../prompts");
+const date_1 = require("../../../utils/date");
+const formatFields_1 = tslib_1.__importDefault(require("../../../utils/formatFields"));
+const json_1 = require("../../../utils/json");
+const DEFAULT_LIMIT = 25;
+const MAX_LIMIT = 50;
+const CHANNELS_LIMIT = 50;
+class UpdateEmbeddedList extends EasCommand_1.default {
+    static description = 'list embedded updates registered with EAS Update for this project';
+    static flags = {
+        platform: core_1.Flags.option({
+            char: 'p',
+            description: 'Filter by platform',
+            options: [eas_build_job_1.Platform.IOS, eas_build_job_1.Platform.ANDROID],
+        })(),
+        'runtime-version': core_1.Flags.string({
+            description: 'Filter by runtime version',
+        }),
+        channel: core_1.Flags.string({
+            description: 'Filter by channel name (pass "all" to skip the channel prompt)',
+        }),
+        limit: (0, pagination_1.getLimitFlagWithCustomValues)({ defaultTo: DEFAULT_LIMIT, limit: MAX_LIMIT }),
+        'after-cursor': core_1.Flags.string({
+            description: 'Return items after this cursor (for pagination)',
+        }),
+        ...flags_1.EasNonInteractiveAndJsonFlags,
+    };
+    static contextDefinition = {
+        ...this.ContextOptions.ProjectId,
+        ...this.ContextOptions.LoggedIn,
+    };
+    async runAsync() {
+        const { flags } = await this.parse(UpdateEmbeddedList);
+        const { json: jsonFlag, nonInteractive } = (0, flags_1.resolveNonInteractiveAndJsonFlags)(flags);
+        const { projectId, loggedIn: { graphqlClient }, } = await this.getContextAsync(UpdateEmbeddedList, { nonInteractive });
+        if (jsonFlag) {
+            (0, json_1.enableJsonOutput)();
+        }
+        const platform = flags.platform
+            ? (0, AppPlatform_1.toAppPlatform)(flags.platform)
+            : undefined;
+        // Resolve channel filter:
+        // - `--channel <name>`: use it
+        // - `--channel all` (or no flag in non-interactive / json): no channel filter
+        // - no flag in interactive: prompt with the project's channels + "All channels"
+        let channel;
+        if (flags.channel) {
+            channel = flags.channel.toLowerCase() === 'all' ? undefined : flags.channel;
+        }
+        else if (!nonInteractive && !jsonFlag) {
+            channel = await promptForChannelAsync(graphqlClient, projectId);
+        }
+        const filter = platform || flags['runtime-version'] || channel
+            ? {
+                platform,
+                runtimeVersion: flags['runtime-version'],
+                channel,
+            }
+            : undefined;
+        const limit = flags.limit ?? DEFAULT_LIMIT;
+        const connection = await EmbeddedUpdateQuery_1.EmbeddedUpdateQuery.viewPaginatedAsync(graphqlClient, {
+            appId: projectId,
+            filter,
+            first: limit,
+            after: flags['after-cursor'],
+        });
+        const embeddedUpdates = connection.edges.map(e => e.node);
+        if (jsonFlag) {
+            (0, json_1.printJsonOnlyOutput)({
+                embeddedUpdates,
+                pageInfo: connection.pageInfo,
+            });
+            return;
+        }
+        if (embeddedUpdates.length === 0) {
+            log_1.default.log('No embedded updates found.');
+            return;
+        }
+        log_1.default.addNewLineIfNone();
+        log_1.default.log(chalk_1.default.bold(`Embedded updates (${embeddedUpdates.length}${connection.pageInfo.hasNextPage ? '+' : ''}):`));
+        log_1.default.newLine();
+        log_1.default.log(embeddedUpdates.map(formatEmbeddedUpdateRow).join(`\n\n${chalk_1.default.dim('———')}\n\n`));
+        if (connection.pageInfo.hasNextPage && connection.pageInfo.endCursor) {
+            log_1.default.newLine();
+            log_1.default.log(chalk_1.default.dim(`Showing ${embeddedUpdates.length}. For the next page, run with --after-cursor ${connection.pageInfo.endCursor}`));
+        }
+    }
+}
+exports.default = UpdateEmbeddedList;
+// Sentinel for the "All channels" option. We can't use `undefined` here because
+// the underlying `prompts` library substitutes a choice's index when its value
+// is undefined, which then leaks into the GraphQL filter.
+const ALL_CHANNELS = '__embedded_update_list__all_channels__';
+async function promptForChannelAsync(graphqlClient, projectId) {
+    const channels = await ChannelQuery_1.ChannelQuery.viewUpdateChannelsOnAppAsync(graphqlClient, {
+        appId: projectId,
+        offset: 0,
+        limit: CHANNELS_LIMIT,
+    });
+    if (channels.length === 0) {
+        // Nothing to choose from — fall back to listing everything.
+        return undefined;
+    }
+    const selected = await (0, prompts_1.selectAsync)('Filter embedded updates by which channel?', [
+        { title: 'All channels', value: ALL_CHANNELS },
+        ...channels.map(c => ({ title: c.name, value: c.name })),
+    ]);
+    return selected === ALL_CHANNELS ? undefined : selected;
+}
+function formatEmbeddedUpdateRow(embeddedUpdate) {
+    const createdAt = new Date(embeddedUpdate.createdAt);
+    return (0, formatFields_1.default)([
+        { label: 'ID', value: embeddedUpdate.id },
+        { label: 'Platform', value: embeddedUpdate.platform.toLowerCase() },
+        { label: 'Runtime version', value: embeddedUpdate.runtimeVersion },
+        { label: 'Channel', value: embeddedUpdate.channel },
+        { label: 'Created', value: `${(0, date_1.fromNow)(createdAt)} ago` },
+    ]);
+}

package/build/commands/update/embedded/view.d.ts

@@ -0,0 +1,17 @@
+import EasCommand from '../../../commandUtils/EasCommand';
+import { EmbeddedUpdateFragment } from '../../../graphql/queries/EmbeddedUpdateQuery';
+export default class UpdateEmbeddedView extends EasCommand {
+    static description: string;
+    static args: {
+        id: import("@oclif/core/lib/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static flags: {
+        json: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+    };
+    static contextDefinition: {
+        loggedIn: import("../../../commandUtils/context/LoggedInContextField").default;
+        projectId: import("../../../commandUtils/context/ProjectIdContextField").ProjectIdContextField;
+    };
+    runAsync(): Promise<void>;
+}
+export declare function formatEmbeddedUpdate(embeddedUpdate: EmbeddedUpdateFragment): string;