eas-cli 19.1.0 → 20.1.0

package/build/commands/go.d.ts

@@ -14,6 +14,7 @@ export default class Go extends EasCommand {
         loggedIn: import("../commandUtils/context/LoggedInContextField").default;
     };
     runAsync(): Promise<void>;
+    private selectSdkVersionAsync;
     private generateBundleId;
     private ensureEasProjectAsync;
     private setupCredentialsAsync;

package/build/commands/go.js

@@ -169,7 +169,10 @@ class Go extends EasCommand_1.default {
         if (detectedSdkVersion && !flags['sdk-version']) {
             log_1.default.log(`Current project using SDK ${detectedSdkVersion.split('.')[0]}. Auto-selected same version. To use a different version, pass --sdk-version.`);
         }
-        const sdkVersion = flags['sdk-version'] ?? detectedSdkVersion;
+        let sdkVersion = flags['sdk-version'] ?? detectedSdkVersion;
+        if (!sdkVersion) {
+            ({ sdkVersion } = await this.selectSdkVersionAsync(graphqlClient));
+        }
         const bundleId = flags['bundle-id'] ?? this.generateBundleId(actor);
         if (!(0, bundleIdentifier_1.isBundleIdentifierValid)(bundleId)) {
             throw new Error(`"${bundleId}" is not a valid iOS bundle identifier. ${bundleIdentifier_1.INVALID_BUNDLE_IDENTIFIER_MESSAGE} Pass a valid identifier with --bundle-id.`);
@@ -217,6 +220,31 @@ class Go extends EasCommand_1.default {
             await fs.remove(tmpDir);
         }
     }
+    async selectSdkVersionAsync(graphqlClient) {
+        let versions;
+        try {
+            versions = await WorkflowRunQuery_1.WorkflowRunQuery.expoGoSupportedSdkVersionsAsync(graphqlClient);
+        }
+        catch {
+            return { sdkVersion: undefined };
+        }
+        const selectable = versions.filter(v => !v.isDeprecated);
+        if (selectable.length === 0) {
+            return { sdkVersion: undefined };
+        }
+        const defaultVersion = selectable.find(v => v.isLatest) ?? selectable.at(-1);
+        return {
+            sdkVersion: await (0, prompts_1.selectAsync)('Select an Expo SDK version', selectable.map(v => {
+                const major = v.sdkVersion.split('.')[0];
+                const title = v.isLatest
+                    ? `SDK ${major} (latest)`
+                    : v.isBeta
+                        ? `SDK ${major} (beta)`
+                        : `SDK ${major}`;
+                return { title, value: v.sdkVersion };
+            }), { initial: defaultVersion?.sdkVersion }),
+        };
+    }
     generateBundleId(actor) {
         const username = (0, actions_1.ensureActorHasPrimaryAccount)(actor).name;
         const sanitizedUsername = username

package/build/commands/observe/events.d.ts

@@ -1,14 +1,15 @@
 import EasCommand from '../../commandUtils/EasCommand';
 export default class ObserveEvents extends EasCommand {
-    static hidden: boolean;
     static description: string;
     static args: {
-        metric: import("@oclif/core/lib/interfaces").Arg<string | undefined, Record<string, unknown>>;
+        eventName: import("@oclif/core/lib/interfaces").Arg<string | undefined, Record<string, unknown>>;
     };
     static flags: {
         json: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
         'non-interactive': import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
         'project-id': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'session-id': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'all-events': import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
         'update-id': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
         'app-version': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
         start: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
@@ -17,7 +18,6 @@ export default class ObserveEvents extends EasCommand {
         limit: import("@oclif/core/lib/interfaces").OptionFlag<number | undefined>;
         after: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
         platform: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
-        sort: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
     };
     static contextDefinition: {
         loggedIn: import("../../commandUtils/context/LoggedInContextField").default;

package/build/commands/observe/events.js

@@ -3,37 +3,27 @@ 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 errors_1 = require("../../commandUtils/errors");
 const flags_1 = require("../../commandUtils/flags");
 const pagination_1 = require("../../commandUtils/pagination");
 const log_1 = tslib_1.__importDefault(require("../../log"));
-const fetchEvents_1 = require("../../observe/fetchEvents");
+const ObserveQuery_1 = require("../../graphql/queries/ObserveQuery");
+const fetchCustomEvents_1 = require("../../observe/fetchCustomEvents");
 const flags_2 = require("../../observe/flags");
-const metricNames_1 = require("../../observe/metricNames");
-const formatEvents_1 = require("../../observe/formatEvents");
+const formatCustomEvents_1 = require("../../observe/formatCustomEvents");
 const platforms_1 = require("../../observe/platforms");
 const resolveProjectContext_1 = require("../../observe/resolveProjectContext");
 const startAndEndTime_1 = require("../../observe/startAndEndTime");
-const prompts_1 = require("../../prompts");
 const json_1 = require("../../utils/json");
 const DEFAULT_EVENTS_LIMIT = 10;
 class ObserveEvents extends EasCommand_1.default {
-    static hidden = true;
-    static description = 'display individual app performance events ordered by metric value';
+    static description = 'display individual events emitted by the app via `logEvent`, filtered by the event name in the argument. With no arguments, a list of the available event names and associated event counts is returned.';
     static args = {
-        metric: core_1.Args.string({
-            description: 'Metric to query (e.g. tti, cold_launch)',
+        eventName: core_1.Args.string({
+            description: 'Event name to filter by',
             required: false,
-            options: Object.keys(metricNames_1.METRIC_ALIASES),
         }),
     };
     static flags = {
-        sort: core_1.Flags.option({
-            description: 'Sort order for events',
-            options: Object.values(fetchEvents_1.EventsOrderPreset).map(s => s.toLowerCase()),
-            required: false,
-            default: fetchEvents_1.EventsOrderPreset.Oldest.valueOf().toLowerCase(),
-        })(),
         ...flags_2.ObservePlatformFlag,
         ...flags_2.ObserveAfterFlag,
         limit: (0, pagination_1.getLimitFlagWithCustomValues)({
@@ -43,6 +33,13 @@ class ObserveEvents extends EasCommand_1.default {
         ...flags_2.ObserveTimeRangeFlags,
         ...flags_2.ObserveAppVersionFlag,
         ...flags_2.ObserveUpdateIdFlag,
+        'session-id': core_1.Flags.string({
+            description: 'Filter by session ID',
+        }),
+        'all-events': core_1.Flags.boolean({
+            description: 'When no event name argument is provided, list all events across all event names instead of a summary of event names + counts.',
+            default: false,
+        }),
         ...flags_2.ObserveProjectIdFlag,
         ...flags_1.EasNonInteractiveAndJsonFlags,
     };
@@ -55,6 +52,9 @@ class ObserveEvents extends EasCommand_1.default {
     };
     async runAsync() {
         const { flags, args } = await this.parse(ObserveEvents);
+        if (args.eventName && flags['all-events']) {
+            throw new Error('--all-events cannot be combined with an event name argument. Pass an event name to filter by it, or pass --all-events to list all events across all event names.');
+        }
         const { projectId, graphqlClient } = await (0, resolveProjectContext_1.resolveObserveCommandContextAsync)({
             command: this,
             commandClass: ObserveEvents,
@@ -65,53 +65,71 @@ class ObserveEvents extends EasCommand_1.default {
         if (flags.json) {
             (0, json_1.enableJsonOutput)();
         }
-        else {
-            log_1.default.warn('EAS Observe is in preview and subject to breaking changes.');
-        }
-        let metricName;
-        if (args.metric) {
-            metricName = (0, metricNames_1.resolveMetricName)(args.metric);
-        }
-        else if (flags['non-interactive']) {
-            throw new errors_1.EasCommandError('A metric argument is required in non-interactive mode. Available metrics: ' +
-                Object.keys(metricNames_1.METRIC_ALIASES).join(', '));
-        }
-        else {
-            const choices = Object.entries(metricNames_1.METRIC_SHORT_NAMES).map(([fullName, displayName]) => ({
-                title: `${displayName} (${fullName})`,
-                value: fullName,
-            }));
-            metricName = await (0, prompts_1.selectAsync)('Select a metric', choices);
-        }
-        const orderBy = (0, fetchEvents_1.resolveOrderBy)(flags.sort);
         const { daysBack, startTime, endTime } = (0, startAndEndTime_1.resolveTimeRange)(flags);
         const platform = (0, platforms_1.appObservePlatformFromFlag)(flags.platform);
-        const platforms = (0, platforms_1.appPlatformsFromFlag)(flags.platform);
-        const [{ events, pageInfo }, totalEventCount] = await Promise.all([
-            (0, fetchEvents_1.fetchObserveEventsAsync)(graphqlClient, projectId, {
-                metricName,
-                orderBy,
-                limit: flags.limit ?? DEFAULT_EVENTS_LIMIT,
-                ...(flags.after && { after: flags.after }),
+        if (!args.eventName && !flags['all-events']) {
+            const { names, isTruncated } = await ObserveQuery_1.ObserveQuery.customEventNamesAsync(graphqlClient, {
+                appId: projectId,
+                startTime,
+                endTime,
+                platform,
+            });
+            if (flags.json) {
+                (0, json_1.printJsonOnlyOutput)((0, formatCustomEvents_1.buildObserveCustomEventNamesJson)(names, isTruncated));
+            }
+            else {
+                log_1.default.addNewLineIfNone();
+                log_1.default.log((0, formatCustomEvents_1.buildObserveCustomEventNamesTable)(names, {
+                    daysBack,
+                    startTime,
+                    endTime,
+                    isTruncated,
+                }));
+            }
+            return;
+        }
+        const { events, pageInfo } = await (0, fetchCustomEvents_1.fetchObserveCustomEventsAsync)(graphqlClient, projectId, {
+            eventName: args.eventName,
+            limit: flags.limit ?? DEFAULT_EVENTS_LIMIT,
+            ...(flags.after && { after: flags.after }),
+            startTime,
+            endTime,
+            platform,
+            appVersion: flags['app-version'],
+            updateId: flags['update-id'],
+            sessionId: flags['session-id'],
+        });
+        if (args.eventName && events.length === 0) {
+            const { names, isTruncated } = await ObserveQuery_1.ObserveQuery.customEventNamesAsync(graphqlClient, {
+                appId: projectId,
                 startTime,
                 endTime,
                 platform,
-                appVersion: flags['app-version'],
-                updateId: flags['update-id'],
-            }),
-            (0, fetchEvents_1.fetchTotalEventCountAsync)(graphqlClient, projectId, metricName, platforms, startTime, endTime),
-        ]);
+            });
+            if (flags.json) {
+                (0, json_1.printJsonOnlyOutput)((0, formatCustomEvents_1.buildObserveCustomEventsEmptyWithSuggestionsJson)(args.eventName, names, isTruncated));
+            }
+            else {
+                log_1.default.addNewLineIfNone();
+                log_1.default.log((0, formatCustomEvents_1.buildObserveCustomEventsEmptyWithSuggestionsTable)(args.eventName, names, {
+                    daysBack,
+                    startTime,
+                    endTime,
+                    isTruncated,
+                }));
+            }
+            return;
+        }
         if (flags.json) {
-            (0, json_1.printJsonOnlyOutput)((0, formatEvents_1.buildObserveEventsJson)(events, pageInfo));
+            (0, json_1.printJsonOnlyOutput)((0, formatCustomEvents_1.buildObserveCustomEventsJson)(events, pageInfo));
         }
         else {
             log_1.default.addNewLineIfNone();
-            log_1.default.log((0, formatEvents_1.buildObserveEventsTable)(events, pageInfo, {
-                metricName,
+            log_1.default.log((0, formatCustomEvents_1.buildObserveCustomEventsTable)(events, pageInfo, {
+                eventName: args.eventName,
                 daysBack,
                 startTime,
                 endTime,
-                totalEventCount,
             }));
         }
     }

package/build/commands/observe/{logs.d.ts → metrics-summary.d.ts}

@@ -1,23 +1,15 @@
 import EasCommand from '../../commandUtils/EasCommand';
-export default class ObserveLogs extends EasCommand {
-    static hidden: boolean;
+export default class ObserveMetricsSummary extends EasCommand {
     static description: string;
-    static args: {
-        eventName: import("@oclif/core/lib/interfaces").Arg<string | undefined, Record<string, unknown>>;
-    };
     static flags: {
         json: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
         'non-interactive': import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
         'project-id': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
-        'session-id': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
-        'all-events': import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
-        'update-id': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
-        'app-version': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
         start: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
         end: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
         days: import("@oclif/core/lib/interfaces").OptionFlag<number | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
-        limit: import("@oclif/core/lib/interfaces").OptionFlag<number | undefined>;
-        after: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        metric: import("@oclif/core/lib/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        stat: import("@oclif/core/lib/interfaces").OptionFlag<("min" | "max" | "median" | "average" | "p80" | "p90" | "p99" | "eventCount")[] | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
         platform: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
     };
     static contextDefinition: {

package/build/commands/observe/metrics-summary.js

@@ -0,0 +1,95 @@
+"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 log_1 = tslib_1.__importDefault(require("../../log"));
+const fetchMetrics_1 = require("../../observe/fetchMetrics");
+const flags_2 = require("../../observe/flags");
+const formatMetrics_1 = require("../../observe/formatMetrics");
+const metricNames_1 = require("../../observe/metricNames");
+const platforms_1 = require("../../observe/platforms");
+const resolveProjectContext_1 = require("../../observe/resolveProjectContext");
+const startAndEndTime_1 = require("../../observe/startAndEndTime");
+const json_1 = require("../../utils/json");
+const DEFAULT_METRICS = [
+    'expo.app_startup.cold_launch_time',
+    'expo.app_startup.warm_launch_time',
+    'expo.app_startup.tti',
+    'expo.app_startup.ttr',
+    'expo.app_startup.bundle_load_time',
+];
+const DEFAULT_STATS_TABLE = ['median', 'eventCount'];
+const DEFAULT_STATS_JSON = [
+    'min',
+    'median',
+    'max',
+    'average',
+    'p80',
+    'p90',
+    'p99',
+    'eventCount',
+];
+class ObserveMetricsSummary extends EasCommand_1.default {
+    static description = 'display aggregated performance metric statistics grouped by app version';
+    static flags = {
+        ...flags_2.ObservePlatformFlag,
+        metric: core_1.Flags.option({
+            description: 'Metric name to display (can be specified multiple times).',
+            multiple: true,
+            options: Object.keys(metricNames_1.METRIC_ALIASES),
+        })(),
+        stat: core_1.Flags.option({
+            description: 'Statistic to display per metric (can be specified multiple times)',
+            multiple: true,
+            options: DEFAULT_STATS_JSON,
+        })(),
+        ...flags_2.ObserveTimeRangeFlags,
+        ...flags_2.ObserveProjectIdFlag,
+        ...flags_1.EasNonInteractiveAndJsonFlags,
+    };
+    static contextDefinition = {
+        ...this.ContextOptions.ProjectId,
+        ...this.ContextOptions.LoggedIn,
+    };
+    static loggedInOnlyContextDefinition = {
+        ...this.ContextOptions.LoggedIn,
+    };
+    async runAsync() {
+        const { flags } = await this.parse(ObserveMetricsSummary);
+        const { projectId, graphqlClient } = await (0, resolveProjectContext_1.resolveObserveCommandContextAsync)({
+            command: this,
+            commandClass: ObserveMetricsSummary,
+            loggedInOnlyContextDefinition: ObserveMetricsSummary.loggedInOnlyContextDefinition,
+            projectIdOverride: flags['project-id'],
+            nonInteractive: flags['non-interactive'],
+        });
+        if (flags.json) {
+            (0, json_1.enableJsonOutput)();
+        }
+        const metricNames = flags.metric?.length
+            ? flags.metric.map(metricNames_1.resolveMetricName)
+            : DEFAULT_METRICS;
+        const { daysBack, startTime, endTime } = (0, startAndEndTime_1.resolveTimeRange)(flags);
+        const platforms = (0, platforms_1.appPlatformsFromFlag)(flags.platform);
+        const { metricsMap, buildNumbersMap, updateIdsMap, totalEventCounts } = await (0, fetchMetrics_1.fetchObserveMetricsAsync)(graphqlClient, projectId, metricNames, platforms, startTime, endTime);
+        const argumentsStat = flags.stat?.length
+            ? Array.from(new Set(flags.stat.map(formatMetrics_1.resolveStatKey)))
+            : undefined;
+        if (flags.json) {
+            const stats = argumentsStat ?? DEFAULT_STATS_JSON;
+            (0, json_1.printJsonOnlyOutput)((0, formatMetrics_1.buildObserveMetricsJson)(metricsMap, metricNames, stats, totalEventCounts, buildNumbersMap, updateIdsMap));
+        }
+        else {
+            const stats = argumentsStat ?? DEFAULT_STATS_TABLE;
+            log_1.default.addNewLineIfNone();
+            log_1.default.log((0, formatMetrics_1.buildObserveMetricsTable)(metricsMap, metricNames, stats, {
+                daysBack,
+                buildNumbersMap,
+                totalEventCounts,
+            }));
+        }
+    }
+}
+exports.default = ObserveMetricsSummary;

package/build/commands/observe/metrics.d.ts

@@ -1,17 +1,22 @@
 import EasCommand from '../../commandUtils/EasCommand';
 export default class ObserveMetrics extends EasCommand {
-    static hidden: boolean;
     static description: string;
+    static args: {
+        metric: import("@oclif/core/lib/interfaces").Arg<string | undefined, Record<string, unknown>>;
+    };
     static flags: {
         json: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
         'non-interactive': import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
         'project-id': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'update-id': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'app-version': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
         start: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
         end: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
         days: import("@oclif/core/lib/interfaces").OptionFlag<number | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
-        metric: import("@oclif/core/lib/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
-        stat: import("@oclif/core/lib/interfaces").OptionFlag<("min" | "max" | "median" | "average" | "p80" | "p90" | "p99" | "eventCount")[] | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        limit: import("@oclif/core/lib/interfaces").OptionFlag<number | undefined>;
+        after: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
         platform: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        sort: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
     };
     static contextDefinition: {
         loggedIn: import("../../commandUtils/context/LoggedInContextField").default;

package/build/commands/observe/metrics.js

@@ -3,50 +3,45 @@ 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 errors_1 = require("../../commandUtils/errors");
 const flags_1 = require("../../commandUtils/flags");
+const pagination_1 = require("../../commandUtils/pagination");
 const log_1 = tslib_1.__importDefault(require("../../log"));
-const fetchMetrics_1 = require("../../observe/fetchMetrics");
+const fetchEvents_1 = require("../../observe/fetchEvents");
 const flags_2 = require("../../observe/flags");
-const formatMetrics_1 = require("../../observe/formatMetrics");
 const metricNames_1 = require("../../observe/metricNames");
+const formatEvents_1 = require("../../observe/formatEvents");
 const platforms_1 = require("../../observe/platforms");
 const resolveProjectContext_1 = require("../../observe/resolveProjectContext");
 const startAndEndTime_1 = require("../../observe/startAndEndTime");
+const prompts_1 = require("../../prompts");
 const json_1 = require("../../utils/json");
-const DEFAULT_METRICS = [
-    'expo.app_startup.cold_launch_time',
-    'expo.app_startup.warm_launch_time',
-    'expo.app_startup.tti',
-    'expo.app_startup.ttr',
-    'expo.app_startup.bundle_load_time',
-];
-const DEFAULT_STATS_TABLE = ['median', 'eventCount'];
-const DEFAULT_STATS_JSON = [
-    'min',
-    'median',
-    'max',
-    'average',
-    'p80',
-    'p90',
-    'p99',
-    'eventCount',
-];
+const DEFAULT_EVENTS_LIMIT = 10;
 class ObserveMetrics extends EasCommand_1.default {
-    static hidden = true;
-    static description = 'display app performance metrics grouped by app version';
-    static flags = {
-        ...flags_2.ObservePlatformFlag,
-        metric: core_1.Flags.option({
-            description: 'Metric name to display (can be specified multiple times).',
-            multiple: true,
+    static description = 'display individual performance metric samples ordered by value';
+    static args = {
+        metric: core_1.Args.string({
+            description: 'Metric to query (e.g. tti, cold_launch)',
+            required: false,
             options: Object.keys(metricNames_1.METRIC_ALIASES),
+        }),
+    };
+    static flags = {
+        sort: core_1.Flags.option({
+            description: 'Sort order for events',
+            options: Object.values(fetchEvents_1.EventsOrderPreset).map(s => s.toLowerCase()),
+            required: false,
+            default: fetchEvents_1.EventsOrderPreset.Oldest.valueOf().toLowerCase(),
         })(),
-        stat: core_1.Flags.option({
-            description: 'Statistic to display per metric (can be specified multiple times)',
-            multiple: true,
-            options: DEFAULT_STATS_JSON,
-        })(),
+        ...flags_2.ObservePlatformFlag,
+        ...flags_2.ObserveAfterFlag,
+        limit: (0, pagination_1.getLimitFlagWithCustomValues)({
+            defaultTo: DEFAULT_EVENTS_LIMIT,
+            limit: 100,
+        }),
         ...flags_2.ObserveTimeRangeFlags,
+        ...flags_2.ObserveAppVersionFlag,
+        ...flags_2.ObserveUpdateIdFlag,
         ...flags_2.ObserveProjectIdFlag,
         ...flags_1.EasNonInteractiveAndJsonFlags,
     };
@@ -58,7 +53,7 @@ class ObserveMetrics extends EasCommand_1.default {
         ...this.ContextOptions.LoggedIn,
     };
     async runAsync() {
-        const { flags } = await this.parse(ObserveMetrics);
+        const { flags, args } = await this.parse(ObserveMetrics);
         const { projectId, graphqlClient } = await (0, resolveProjectContext_1.resolveObserveCommandContextAsync)({
             command: this,
             commandClass: ObserveMetrics,
@@ -69,29 +64,50 @@ class ObserveMetrics extends EasCommand_1.default {
         if (flags.json) {
             (0, json_1.enableJsonOutput)();
         }
+        let metricName;
+        if (args.metric) {
+            metricName = (0, metricNames_1.resolveMetricName)(args.metric);
+        }
+        else if (flags['non-interactive']) {
+            throw new errors_1.EasCommandError('A metric argument is required in non-interactive mode. Available metrics: ' +
+                Object.keys(metricNames_1.METRIC_ALIASES).join(', '));
+        }
         else {
-            log_1.default.warn('EAS Observe is in preview and subject to breaking changes.');
+            const choices = Object.entries(metricNames_1.METRIC_SHORT_NAMES).map(([fullName, displayName]) => ({
+                title: `${displayName} (${fullName})`,
+                value: fullName,
+            }));
+            metricName = await (0, prompts_1.selectAsync)('Select a metric', choices);
         }
-        const metricNames = flags.metric?.length
-            ? flags.metric.map(metricNames_1.resolveMetricName)
-            : DEFAULT_METRICS;
+        const orderBy = (0, fetchEvents_1.resolveOrderBy)(flags.sort);
         const { daysBack, startTime, endTime } = (0, startAndEndTime_1.resolveTimeRange)(flags);
+        const platform = (0, platforms_1.appObservePlatformFromFlag)(flags.platform);
         const platforms = (0, platforms_1.appPlatformsFromFlag)(flags.platform);
-        const { metricsMap, buildNumbersMap, updateIdsMap, totalEventCounts } = await (0, fetchMetrics_1.fetchObserveMetricsAsync)(graphqlClient, projectId, metricNames, platforms, startTime, endTime);
-        const argumentsStat = flags.stat?.length
-            ? Array.from(new Set(flags.stat.map(formatMetrics_1.resolveStatKey)))
-            : undefined;
+        const [{ events, pageInfo }, totalEventCount] = await Promise.all([
+            (0, fetchEvents_1.fetchObserveEventsAsync)(graphqlClient, projectId, {
+                metricName,
+                orderBy,
+                limit: flags.limit ?? DEFAULT_EVENTS_LIMIT,
+                ...(flags.after && { after: flags.after }),
+                startTime,
+                endTime,
+                platform,
+                appVersion: flags['app-version'],
+                updateId: flags['update-id'],
+            }),
+            (0, fetchEvents_1.fetchTotalEventCountAsync)(graphqlClient, projectId, metricName, platforms, startTime, endTime),
+        ]);
         if (flags.json) {
-            const stats = argumentsStat ?? DEFAULT_STATS_JSON;
-            (0, json_1.printJsonOnlyOutput)((0, formatMetrics_1.buildObserveMetricsJson)(metricsMap, metricNames, stats, totalEventCounts, buildNumbersMap, updateIdsMap));
+            (0, json_1.printJsonOnlyOutput)((0, formatEvents_1.buildObserveEventsJson)(events, pageInfo));
         }
         else {
-            const stats = argumentsStat ?? DEFAULT_STATS_TABLE;
             log_1.default.addNewLineIfNone();
-            log_1.default.log((0, formatMetrics_1.buildObserveMetricsTable)(metricsMap, metricNames, stats, {
+            log_1.default.log((0, formatEvents_1.buildObserveEventsTable)(events, pageInfo, {
+                metricName,
                 daysBack,
-                buildNumbersMap,
-                totalEventCounts,
+                startTime,
+                endTime,
+                totalEventCount,
             }));
         }
     }

package/build/commands/observe/routes.d.ts

@@ -1,6 +1,5 @@
 import EasCommand from '../../commandUtils/EasCommand';
 export default class ObserveRoutes extends EasCommand {
-    static hidden: boolean;
     static description: string;
     static flags: {
         json: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;

package/build/commands/observe/routes.js

@@ -19,7 +19,6 @@ const STAT_OPTIONS = ['median', 'med', 'p90', 'count', 'event_count', 'eventCoun
 const DEFAULT_STATS_TABLE = ['median', 'count'];
 const DEFAULT_STATS_JSON = ['median', 'p90', 'count'];
 class ObserveRoutes extends EasCommand_1.default {
-    static hidden = true;
     static description = 'display app navigation route metrics (Cold TTR, Warm TTR, TTI) grouped by route name';
     static flags = {
         ...flags_2.ObservePlatformFlag,
@@ -70,9 +69,6 @@ class ObserveRoutes extends EasCommand_1.default {
         if (flags.json) {
             (0, json_1.enableJsonOutput)();
         }
-        else {
-            log_1.default.warn('EAS Observe is in preview and subject to breaking changes.');
-        }
         const metricNames = flags.metric?.length
             ? Array.from(new Set(flags.metric.map(metricNames_1.resolveNavigationMetricName)))
             : formatNavigationRoutes_1.NAVIGATION_METRIC_NAMES;

package/build/commands/observe/versions.d.ts

@@ -1,6 +1,5 @@
 import EasCommand from '../../commandUtils/EasCommand';
 export default class ObserveVersions extends EasCommand {
-    static hidden: boolean;
     static description: string;
     static flags: {
         json: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;

package/build/commands/observe/versions.js

@@ -12,7 +12,6 @@ const resolveProjectContext_1 = require("../../observe/resolveProjectContext");
 const startAndEndTime_1 = require("../../observe/startAndEndTime");
 const json_1 = require("../../utils/json");
 class ObserveVersions extends EasCommand_1.default {
-    static hidden = true;
     static description = 'display app versions with build and update details';
     static flags = {
         ...flags_2.ObservePlatformFlag,
@@ -39,9 +38,6 @@ class ObserveVersions extends EasCommand_1.default {
         if (flags.json) {
             (0, json_1.enableJsonOutput)();
         }
-        else {
-            log_1.default.warn('EAS Observe is in preview and subject to breaking changes.');
-        }
         const { startTime, endTime } = (0, startAndEndTime_1.resolveTimeRange)(flags);
         const platforms = (0, platforms_1.appPlatformsFromFlag)(flags.platform);
         const results = await (0, fetchVersions_1.fetchObserveVersionsAsync)(graphqlClient, projectId, platforms, startTime, endTime);

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>;
+}