eas-cli 19.0.8 → 20.0.0

package/build/build/createContext.d.ts

@@ -9,7 +9,7 @@ import { ExpoGraphqlClient } from '../commandUtils/context/contextUtils/createGr
 import { CustomBuildConfigMetadata } from '../project/customBuildConfig';
 import { Actor } from '../user/User';
 import { Client } from '../vcs/vcs';
-export declare function createBuildContextAsync<T extends Platform>({ buildProfileName, buildProfile, easJsonCliConfig, clearCache, localBuildOptions, nonInteractive, noWait, platform, projectDir, resourceClassFlag, message, actor, graphqlClient, analytics, vcsClient, getDynamicPrivateProjectConfigAsync, customBuildConfigMetadata, buildLoggerLevel, freezeCredentials, isVerboseLoggingEnabled, whatToTest, env, }: {
+export declare function createBuildContextAsync<T extends Platform>({ buildProfileName, buildProfile, easJsonCliConfig, clearCache, localBuildOptions, nonInteractive, noWait, platform, projectDir, resourceClassFlag, message, actor, graphqlClient, analytics, vcsClient, getDynamicPrivateProjectConfigAsync, customBuildConfigMetadata, buildLoggerLevel, freezeCredentials, refreshAdHocProvisioningProfile: refreshAdHocProvisioningProfileFlag, isVerboseLoggingEnabled, whatToTest, env, }: {
     buildProfileName: string;
     buildProfile: BuildProfile<T>;
     easJsonCliConfig: EasJson['cli'];
@@ -29,6 +29,7 @@ export declare function createBuildContextAsync<T extends Platform>({ buildProfi
     customBuildConfigMetadata?: CustomBuildConfigMetadata;
     buildLoggerLevel?: LoggerLevel;
     freezeCredentials: boolean;
+    refreshAdHocProvisioningProfile?: boolean;
     isVerboseLoggingEnabled: boolean;
     whatToTest?: string;
     env: Record<string, string>;

package/build/build/createContext.js

@@ -16,7 +16,7 @@ const AnalyticsManager_1 = require("../analytics/AnalyticsManager");
 const context_1 = require("../credentials/context");
 const projectUtils_1 = require("../project/projectUtils");
 const workflow_1 = require("../project/workflow");
-async function createBuildContextAsync({ buildProfileName, buildProfile, easJsonCliConfig, clearCache = false, localBuildOptions, nonInteractive, noWait, platform, projectDir, resourceClassFlag, message, actor, graphqlClient, analytics, vcsClient, getDynamicPrivateProjectConfigAsync, customBuildConfigMetadata, buildLoggerLevel, freezeCredentials, isVerboseLoggingEnabled, whatToTest, env, }) {
+async function createBuildContextAsync({ buildProfileName, buildProfile, easJsonCliConfig, clearCache = false, localBuildOptions, nonInteractive, noWait, platform, projectDir, resourceClassFlag, message, actor, graphqlClient, analytics, vcsClient, getDynamicPrivateProjectConfigAsync, customBuildConfigMetadata, buildLoggerLevel, freezeCredentials, refreshAdHocProvisioningProfile: refreshAdHocProvisioningProfileFlag, isVerboseLoggingEnabled, whatToTest, env, }) {
     const { exp, projectId } = await getDynamicPrivateProjectConfigAsync({
         env,
     });
@@ -33,6 +33,7 @@ async function createBuildContextAsync({ buildProfileName, buildProfile, easJson
             : buildProfile?.buildConfiguration === 'Debug') ??
         false;
     const requiredPackageManager = (0, package_manager_1.resolvePackageManager)(projectDir);
+    const refreshAdHocProvisioningProfile = refreshAdHocProvisioningProfileFlag ?? false;
     const credentialsCtx = new context_1.CredentialsContext({
         projectInfo: { exp, projectId },
         nonInteractive,
@@ -44,6 +45,7 @@ async function createBuildContextAsync({ buildProfileName, buildProfile, easJson
         easJsonCliConfig,
         vcsClient,
         freezeCredentials,
+        refreshAdHocProvisioningProfile,
     });
     const devClientProperties = getDevClientEventProperties({
         platform,

package/build/build/ios/credentials.js

@@ -11,13 +11,17 @@ async function ensureIosCredentialsAsync(buildCtx, targets) {
     if (!shouldProvideCredentials(buildCtx)) {
         return;
     }
+    const { credentialsSource } = buildCtx.buildProfile;
+    if (buildCtx.credentialsCtx.refreshAdHocProvisioningProfile &&
+        credentialsSource === 'local') {
+        throw new Error('--refresh-ad-hoc-provisioning-profile cannot be used with credentialsSource "local". Use remote credentials or omit the flag.');
+    }
     const provider = new IosCredentialsProvider_1.default(buildCtx.credentialsCtx, {
         app: await (0, BuildCredentialsUtils_1.getAppFromContextAsync)(buildCtx.credentialsCtx),
         targets,
         distribution: buildCtx.buildProfile.distribution ?? 'store',
         enterpriseProvisioning: buildCtx.buildProfile.enterpriseProvisioning,
     });
-    const { credentialsSource } = buildCtx.buildProfile;
     (0, credentials_1.logCredentialsSource)(credentialsSource, eas_build_job_1.Platform.IOS);
     return {
         credentials: await provider.getCredentialsAsync(credentialsSource),

package/build/build/ios/prepareJob.js

@@ -91,6 +91,9 @@ async function prepareJobAsync(ctx, jobData) {
         // See: https://github.com/expo/eas-build/pull/454
         appId: ctx.projectId,
         initiatingUserId: ctx.user.id,
+        ...(ctx.credentialsCtx.refreshAdHocProvisioningProfile && {
+            refreshAdHocProvisioningProfile: true,
+        }),
     };
     return (0, eas_build_job_1.sanitizeBuildJob)(job);
 }

package/build/build/runBuildAndSubmit.d.ts

@@ -25,6 +25,7 @@ export interface BuildFlags {
     message?: string;
     buildLoggerLevel?: LoggerLevel;
     freezeCredentials: boolean;
+    refreshAdHocProvisioningProfile?: boolean;
     isVerboseLoggingEnabled?: boolean;
     whatToTest?: string;
     simulator?: SimulatorRunTarget;

package/build/build/runBuildAndSubmit.js

@@ -243,6 +243,7 @@ async function prepareAndStartBuildAsync({ projectDir, flags, moreBuilds, buildP
         customBuildConfigMetadata,
         buildLoggerLevel: flags.buildLoggerLevel ?? (log_1.default.isDebug ? logger_1.LoggerLevel.DEBUG : undefined),
         freezeCredentials: flags.freezeCredentials,
+        refreshAdHocProvisioningProfile: flags.refreshAdHocProvisioningProfile,
         isVerboseLoggingEnabled: flags.isVerboseLoggingEnabled ?? false,
         whatToTest: flags.whatToTest,
         env,

package/build/build/types.d.ts

@@ -31,4 +31,5 @@ export interface BuildFlags {
     message?: string;
     buildLoggerLevel?: LoggerLevel;
     freezeCredentials: boolean;
+    refreshAdHocProvisioningProfile?: boolean;
 }

package/build/commands/build/index.d.ts

@@ -21,6 +21,7 @@ export default class Build extends EasCommand {
         message: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
         'build-logger-level': import("@oclif/core/lib/interfaces").OptionFlag<LoggerLevel | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
         'freeze-credentials': import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        'refresh-ad-hoc-provisioning-profile': import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
         'verbose-logs': import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
     };
     static contextDefinition: {

package/build/commands/build/index.js

@@ -92,6 +92,10 @@ class Build extends EasCommand_1.default {
             default: false,
             description: 'Prevent the build from updating credentials in non-interactive mode',
         }),
+        'refresh-ad-hoc-provisioning-profile': core_1.Flags.boolean({
+            default: false,
+            description: 'Refresh managed ad-hoc provisioning profiles from App Store Connect before gathering build credentials',
+        }),
         'verbose-logs': core_1.Flags.boolean({
             default: false,
             description: 'Use verbose logs for the build process',
@@ -138,6 +142,14 @@ class Build extends EasCommand_1.default {
     }
     sanitizeFlags(flags) {
         const { json, nonInteractive } = (0, flags_1.resolveNonInteractiveAndJsonFlags)(flags);
+        if (flags['refresh-ad-hoc-provisioning-profile']) {
+            if (!nonInteractive) {
+                core_1.Errors.error('--refresh-ad-hoc-provisioning-profile can only be used in non-interactive mode.', { exit: 1 });
+            }
+            if (flags['freeze-credentials']) {
+                core_1.Errors.error('Cannot use --refresh-ad-hoc-provisioning-profile with --freeze-credentials.', { exit: 1 });
+            }
+        }
         if (!flags.local && flags.output) {
             core_1.Errors.error('--output is allowed only for local builds', { exit: 1 });
         }
@@ -185,6 +197,7 @@ class Build extends EasCommand_1.default {
             message,
             buildLoggerLevel: flags['build-logger-level'],
             freezeCredentials: flags['freeze-credentials'],
+            refreshAdHocProvisioningProfile: flags['refresh-ad-hoc-provisioning-profile'],
             isVerboseLoggingEnabled: flags['verbose-logs'],
             whatToTest: flags['what-to-test'],
         };

package/build/commands/build/internal.d.ts

@@ -12,6 +12,7 @@ export default class BuildInternal extends EasCommand {
         profile: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
         'auto-submit': import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
         'auto-submit-with-profile': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'refresh-ad-hoc-provisioning-profile': import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
     };
     static contextDefinition: {
         vcsClient: import("../../commandUtils/context/VcsClientContextField").default;

package/build/commands/build/internal.js

@@ -37,6 +37,10 @@ class BuildInternal extends EasCommand_1.default {
             helpValue: 'PROFILE_NAME',
             exclusive: ['auto-submit'],
         }),
+        'refresh-ad-hoc-provisioning-profile': core_1.Flags.boolean({
+            default: false,
+            description: 'Refresh managed ad-hoc provisioning profiles from App Store Connect before gathering build credentials',
+        }),
     };
     static contextDefinition = {
         ...this.ContextOptions.LoggedIn,
@@ -70,6 +74,7 @@ class BuildInternal extends EasCommand_1.default {
                 profile: flags.profile,
                 nonInteractive: true,
                 freezeCredentials: false,
+                refreshAdHocProvisioningProfile: flags['refresh-ad-hoc-provisioning-profile'],
                 wait: false,
                 clearCache: false,
                 json: true,

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;