eas-cli 18.10.0 → 18.12.0

package/build/graphql/queries/DeviceRunSessionQuery.js

@@ -13,10 +13,17 @@ exports.DeviceRunSessionQuery = {
                 byId(deviceRunSessionId: $deviceRunSessionId) {
                   id
                   status
+                  type
+                  remoteConfig {
+                    __typename
+                    ... on AgentDeviceRunSessionRemoteConfig {
+                      url
+                      token
+                    }
+                  }
                   turtleJobRun {
                     id
                     status
-                    logFileUrls
                   }
                 }
               }

package/build/graphql/queries/ObserveQuery.d.ts

@@ -1,5 +1,5 @@
 import { ExpoGraphqlClient } from '../../commandUtils/context/contextUtils/createGraphqlClient';
-import { AppObserveAppVersion, AppObserveEvent, AppObserveEventsFilter, AppObserveEventsOrderBy, AppObservePlatform, AppObserveTimeSeriesStatistics, PageInfo } from '../generated';
+import { AppObserveAppVersion, AppObserveCustomEvent, AppObserveCustomEventListFilter, AppObserveCustomEventName, AppObserveEvent, AppObserveEventsFilter, AppObserveEventsOrderBy, AppObservePlatform, AppObserveTimeSeriesStatistics, PageInfo } from '../generated';
 export type AppObserveTimeSeriesResult = {
     appVersionMarkers: AppObserveAppVersion[];
     eventCount: number;
@@ -12,6 +12,12 @@ type AppObserveEventsQueryVariables = {
     after?: string;
     orderBy?: AppObserveEventsOrderBy;
 };
+type AppObserveCustomEventListQueryVariables = {
+    appId: string;
+    filter?: AppObserveCustomEventListFilter;
+    first?: number;
+    after?: string;
+};
 export declare const ObserveQuery: {
     timeSeriesAsync(graphqlClient: ExpoGraphqlClient, { appId, metricName, platform, startTime, endTime, }: {
         appId: string;
@@ -31,5 +37,19 @@ export declare const ObserveQuery: {
         events: AppObserveEvent[];
         pageInfo: PageInfo;
     }>;
+    customEventListAsync(graphqlClient: ExpoGraphqlClient, variables: AppObserveCustomEventListQueryVariables): Promise<{
+        events: AppObserveCustomEvent[];
+        pageInfo: PageInfo;
+    }>;
+    customEventNamesAsync(graphqlClient: ExpoGraphqlClient, { appId, startTime, endTime, platform, environment, }: {
+        appId: string;
+        startTime: string;
+        endTime: string;
+        platform?: AppObservePlatform;
+        environment?: string;
+    }): Promise<{
+        names: AppObserveCustomEventName[];
+        isTruncated: boolean;
+    }>;
 };
 export {};

package/build/graphql/queries/ObserveQuery.js

@@ -106,4 +106,84 @@ exports.ObserveQuery = {
             pageInfo,
         };
     },
+    async customEventListAsync(graphqlClient, variables) {
+        const data = await (0, client_1.withErrorHandlingAsync)(graphqlClient
+            .query((0, graphql_tag_1.default) `
+            query AppObserveCustomEventList(
+              $appId: String!
+              $filter: AppObserveCustomEventListFilter
+              $first: Int
+              $after: String
+            ) {
+              app {
+                byId(appId: $appId) {
+                  id
+                  observe {
+                    customEventList(filter: $filter, first: $first, after: $after) {
+                      pageInfo {
+                        hasNextPage
+                        hasPreviousPage
+                        endCursor
+                      }
+                      edges {
+                        cursor
+                        node {
+                          id
+                          ...AppObserveCustomEventFragment
+                        }
+                      }
+                    }
+                  }
+                }
+              }
+            }
+            ${(0, graphql_1.print)(Observe_1.AppObserveCustomEventFragmentNode)}
+          `, variables)
+            .toPromise());
+        const { edges, pageInfo } = data.app.byId.observe.customEventList;
+        return {
+            events: edges.map(edge => edge.node),
+            pageInfo,
+        };
+    },
+    async customEventNamesAsync(graphqlClient, { appId, startTime, endTime, platform, environment, }) {
+        const data = await (0, client_1.withErrorHandlingAsync)(graphqlClient
+            .query((0, graphql_tag_1.default) `
+            query AppObserveCustomEventNames(
+              $appId: String!
+              $startTime: DateTime!
+              $endTime: DateTime!
+              $platform: AppObservePlatform
+              $environment: String
+            ) {
+              app {
+                byId(appId: $appId) {
+                  id
+                  observe {
+                    customEventNames(
+                      startTime: $startTime
+                      endTime: $endTime
+                      platform: $platform
+                      environment: $environment
+                    ) {
+                      isTruncated
+                      names {
+                        eventName
+                        count
+                      }
+                    }
+                  }
+                }
+              }
+            }
+          `, {
+            appId,
+            startTime,
+            endTime,
+            ...(platform && { platform }),
+            ...(environment && { environment }),
+        })
+            .toPromise());
+        return data.app.byId.observe.customEventNames;
+    },
 };

package/build/graphql/types/ConvexTeamConnection.d.ts

@@ -1,5 +1,5 @@
 import { ConvexProject, ConvexTeamConnection, SetupConvexProjectResult } from '../generated';
-export type ConvexTeamConnectionData = Pick<ConvexTeamConnection, 'id' | 'convexTeamIdentifier' | 'convexTeamName' | 'convexTeamSlug' | 'createdAt' | 'updatedAt' | 'invitedAt' | 'invitedEmail'>;
+export type ConvexTeamConnectionData = Pick<ConvexTeamConnection, 'id' | 'convexTeamIdentifier' | 'convexTeamName' | 'convexTeamSlug' | 'hasBeenClaimed' | 'createdAt' | 'updatedAt' | 'invitedAt' | 'invitedEmail'>;
 export type ConvexProjectData = Pick<ConvexProject, 'id' | 'convexProjectIdentifier' | 'convexProjectName' | 'convexProjectSlug' | 'createdAt' | 'updatedAt'> & {
     convexTeamConnection: ConvexTeamConnectionData;
 };

package/build/graphql/types/ConvexTeamConnection.js

@@ -9,6 +9,7 @@ exports.ConvexTeamConnectionFragmentNode = (0, graphql_tag_1.default) `
     convexTeamIdentifier
     convexTeamName
     convexTeamSlug
+    hasBeenClaimed
     createdAt
     updatedAt
     invitedAt

package/build/graphql/types/Observe.d.ts

@@ -1,3 +1,4 @@
 export declare const AppObserveTimeSeriesFragmentNode: import("graphql").DocumentNode;
+export declare const AppObserveCustomEventFragmentNode: import("graphql").DocumentNode;
 export declare const AppObserveEventFragmentNode: import("graphql").DocumentNode;
 export declare const AppObserveAppVersionFragmentNode: import("graphql").DocumentNode;

package/build/graphql/types/Observe.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.AppObserveAppVersionFragmentNode = exports.AppObserveEventFragmentNode = exports.AppObserveTimeSeriesFragmentNode = void 0;
+exports.AppObserveAppVersionFragmentNode = exports.AppObserveEventFragmentNode = exports.AppObserveCustomEventFragmentNode = exports.AppObserveTimeSeriesFragmentNode = void 0;
 const tslib_1 = require("tslib");
 const graphql_tag_1 = tslib_1.__importDefault(require("graphql-tag"));
 exports.AppObserveTimeSeriesFragmentNode = (0, graphql_tag_1.default) `
@@ -20,6 +20,31 @@ exports.AppObserveTimeSeriesFragmentNode = (0, graphql_tag_1.default) `
     }
   }
 `;
+exports.AppObserveCustomEventFragmentNode = (0, graphql_tag_1.default) `
+  fragment AppObserveCustomEventFragment on AppObserveCustomEvent {
+    id
+    eventName
+    timestamp
+    sessionId
+    severityNumber
+    severityText
+    properties {
+      key
+      value
+      type
+    }
+    appVersion
+    appBuildNumber
+    appUpdateId
+    appEasBuildId
+    deviceOs
+    deviceOsVersion
+    deviceModel
+    environment
+    easClientId
+    countryCode
+  }
+`;
 exports.AppObserveEventFragmentNode = (0, graphql_tag_1.default) `
   fragment AppObserveEventFragment on AppObserveEvent {
     id

package/build/observe/fetchCustomEvents.d.ts

@@ -0,0 +1,19 @@
+import { ExpoGraphqlClient } from '../commandUtils/context/contextUtils/createGraphqlClient';
+import { AppObserveCustomEvent, AppObservePlatform, PageInfo } from '../graphql/generated';
+interface FetchCustomEventsOptions {
+    eventName?: string;
+    limit: number;
+    after?: string;
+    startTime: string;
+    endTime: string;
+    platform?: AppObservePlatform;
+    appVersion?: string;
+    updateId?: string;
+    sessionId?: string;
+}
+interface FetchCustomEventsResult {
+    events: AppObserveCustomEvent[];
+    pageInfo: PageInfo;
+}
+export declare function fetchObserveCustomEventsAsync(graphqlClient: ExpoGraphqlClient, appId: string, options: FetchCustomEventsOptions): Promise<FetchCustomEventsResult>;
+export {};

package/build/observe/fetchCustomEvents.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.fetchObserveCustomEventsAsync = fetchObserveCustomEventsAsync;
+const ObserveQuery_1 = require("../graphql/queries/ObserveQuery");
+async function fetchObserveCustomEventsAsync(graphqlClient, appId, options) {
+    const filter = {
+        startTime: options.startTime,
+        endTime: options.endTime,
+        ...(options.eventName && { eventName: options.eventName }),
+        ...(options.platform && { platform: options.platform }),
+        ...(options.appVersion && { appVersion: options.appVersion }),
+        ...(options.updateId && { appUpdateId: options.updateId }),
+        ...(options.sessionId && { sessionId: options.sessionId }),
+    };
+    return await ObserveQuery_1.ObserveQuery.customEventListAsync(graphqlClient, {
+        appId,
+        filter,
+        first: options.limit,
+        ...(options.after && { after: options.after }),
+    });
+}

package/build/observe/formatCustomEvents.d.ts

@@ -0,0 +1,70 @@
+import { AppObserveCustomEvent, AppObserveCustomEventName, PageInfo } from '../graphql/generated';
+export interface ObserveCustomEventPropertyJson {
+    key: string;
+    value: string;
+    type: string;
+}
+export interface ObserveCustomEventJson {
+    id: string;
+    eventName: string;
+    timestamp: string;
+    sessionId: string | null;
+    severityNumber: number | null;
+    severityText: string | null;
+    properties: ObserveCustomEventPropertyJson[];
+    appVersion: string;
+    appBuildNumber: string;
+    appUpdateId: string | null;
+    appEasBuildId: string | null;
+    deviceModel: string;
+    deviceOs: string;
+    deviceOsVersion: string;
+    countryCode: string | null;
+    environment: string | null;
+    easClientId: string;
+}
+export interface BuildCustomEventsTableOptions {
+    eventName?: string;
+    daysBack?: number;
+    startTime?: string;
+    endTime?: string;
+    totalEventCount?: number;
+}
+export declare function buildObserveCustomEventsTable(events: AppObserveCustomEvent[], pageInfo: PageInfo, options?: BuildCustomEventsTableOptions): string;
+export declare function buildObserveCustomEventsJson(events: AppObserveCustomEvent[], pageInfo: PageInfo): {
+    events: ObserveCustomEventJson[];
+    pageInfo: {
+        hasNextPage: boolean;
+        endCursor: string | null;
+    };
+};
+export interface BuildEmptyCustomEventsWithSuggestionsOptions {
+    daysBack?: number;
+    startTime?: string;
+    endTime?: string;
+    isTruncated?: boolean;
+}
+export declare function buildObserveCustomEventsEmptyWithSuggestionsTable(eventName: string, names: AppObserveCustomEventName[], options?: BuildEmptyCustomEventsWithSuggestionsOptions): string;
+export declare function buildObserveCustomEventsEmptyWithSuggestionsJson(eventName: string, names: AppObserveCustomEventName[], isTruncated: boolean): {
+    filteredEventName: string;
+    events: [];
+    availableEventNames: Array<{
+        eventName: string;
+        count: number;
+    }>;
+    availableEventNamesIsTruncated: boolean;
+};
+export interface BuildCustomEventNamesTableOptions {
+    daysBack?: number;
+    startTime?: string;
+    endTime?: string;
+    isTruncated?: boolean;
+}
+export declare function buildObserveCustomEventNamesTable(names: AppObserveCustomEventName[], options?: BuildCustomEventNamesTableOptions): string;
+export declare function buildObserveCustomEventNamesJson(names: AppObserveCustomEventName[], isTruncated: boolean): {
+    names: Array<{
+        eventName: string;
+        count: number;
+    }>;
+    isTruncated: boolean;
+};

package/build/observe/formatCustomEvents.js

@@ -0,0 +1,140 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildObserveCustomEventsTable = buildObserveCustomEventsTable;
+exports.buildObserveCustomEventsJson = buildObserveCustomEventsJson;
+exports.buildObserveCustomEventsEmptyWithSuggestionsTable = buildObserveCustomEventsEmptyWithSuggestionsTable;
+exports.buildObserveCustomEventsEmptyWithSuggestionsJson = buildObserveCustomEventsEmptyWithSuggestionsJson;
+exports.buildObserveCustomEventNamesTable = buildObserveCustomEventNamesTable;
+exports.buildObserveCustomEventNamesJson = buildObserveCustomEventNamesJson;
+const tslib_1 = require("tslib");
+const chalk_1 = tslib_1.__importDefault(require("chalk"));
+const renderTextTable_1 = tslib_1.__importDefault(require("../utils/renderTextTable"));
+const formatUtils_1 = require("./formatUtils");
+function formatSeverity(event) {
+    if (event.severityText) {
+        return event.severityText;
+    }
+    if (event.severityNumber != null) {
+        return String(event.severityNumber);
+    }
+    return '-';
+}
+function buildObserveCustomEventsTable(events, pageInfo, options) {
+    if (events.length === 0) {
+        return chalk_1.default.yellow('No custom events found.');
+    }
+    const showEventName = !options?.eventName;
+    const hasSeverity = events.some(e => e.severityText != null || e.severityNumber != null);
+    const headers = [
+        'Timestamp',
+        ...(showEventName ? ['Event'] : []),
+        ...(hasSeverity ? ['Severity'] : []),
+        'App Version',
+        'Platform',
+        'Device',
+        'Country',
+    ];
+    const rows = events.map(event => [
+        (0, formatUtils_1.formatLogTimestamp)(event.timestamp),
+        ...(showEventName ? [event.eventName] : []),
+        ...(hasSeverity ? [formatSeverity(event)] : []),
+        `${event.appVersion} (${event.appBuildNumber})`,
+        `${event.deviceOs} ${event.deviceOsVersion}`,
+        event.deviceModel,
+        event.countryCode ?? '-',
+    ]);
+    const lines = [];
+    if (options) {
+        const timeDesc = (0, formatUtils_1.buildTimeRangeDescription)(options);
+        const totalDesc = options.totalEventCount != null
+            ? ` — ${options.totalEventCount.toLocaleString()} total events`
+            : '';
+        const subject = options.eventName ? `${options.eventName} events` : 'Custom events';
+        lines.push(chalk_1.default.bold(`${subject} ${timeDesc}${totalDesc}`.trim()), '');
+    }
+    lines.push((0, renderTextTable_1.default)(headers, rows));
+    if (pageInfo.hasNextPage && pageInfo.endCursor) {
+        lines.push('', `Next page: --after ${pageInfo.endCursor}`);
+    }
+    return lines.join('\n');
+}
+function buildObserveCustomEventsJson(events, pageInfo) {
+    return {
+        events: events.map(event => ({
+            id: event.id,
+            eventName: event.eventName,
+            timestamp: event.timestamp,
+            sessionId: event.sessionId ?? null,
+            severityNumber: event.severityNumber ?? null,
+            severityText: event.severityText ?? null,
+            properties: event.properties.map(p => ({
+                key: p.key,
+                value: p.value,
+                type: p.type,
+            })),
+            appVersion: event.appVersion,
+            appBuildNumber: event.appBuildNumber,
+            appUpdateId: event.appUpdateId ?? null,
+            appEasBuildId: event.appEasBuildId ?? null,
+            deviceModel: event.deviceModel,
+            deviceOs: event.deviceOs,
+            deviceOsVersion: event.deviceOsVersion,
+            countryCode: event.countryCode ?? null,
+            environment: event.environment ?? null,
+            easClientId: event.easClientId,
+        })),
+        pageInfo: {
+            hasNextPage: pageInfo.hasNextPage,
+            endCursor: pageInfo.endCursor ?? null,
+        },
+    };
+}
+function buildObserveCustomEventsEmptyWithSuggestionsTable(eventName, names, options) {
+    const lines = [];
+    const timeDesc = options ? (0, formatUtils_1.buildTimeRangeDescription)(options) : '';
+    lines.push(chalk_1.default.yellow(`No events found matching "${eventName}" ${timeDesc}.`.trim()));
+    if (names.length === 0) {
+        lines.push('', chalk_1.default.yellow('No custom event names found in this time range.'));
+        return lines.join('\n');
+    }
+    lines.push('', 'Available event names in this time range:', '');
+    const headers = ['Event Name', 'Count'];
+    const rows = names.map(n => [n.eventName, n.count.toLocaleString()]);
+    lines.push((0, renderTextTable_1.default)(headers, rows));
+    if (options?.isTruncated) {
+        lines.push('', chalk_1.default.yellow('Result is truncated; not all event names are shown.'));
+    }
+    return lines.join('\n');
+}
+function buildObserveCustomEventsEmptyWithSuggestionsJson(eventName, names, isTruncated) {
+    return {
+        filteredEventName: eventName,
+        events: [],
+        availableEventNames: names.map(n => ({ eventName: n.eventName, count: n.count })),
+        availableEventNamesIsTruncated: isTruncated,
+    };
+}
+function buildObserveCustomEventNamesTable(names, options) {
+    if (names.length === 0) {
+        return chalk_1.default.yellow('No custom event names found.');
+    }
+    const headers = ['Event Name', 'Count'];
+    const rows = names.map(n => [n.eventName, n.count.toLocaleString()]);
+    const lines = [];
+    if (options) {
+        const timeDesc = (0, formatUtils_1.buildTimeRangeDescription)(options);
+        const subject = 'Custom event names';
+        lines.push(chalk_1.default.bold(`${subject} ${timeDesc}`.trim()), '');
+    }
+    lines.push((0, renderTextTable_1.default)(headers, rows));
+    if (options?.isTruncated) {
+        lines.push('', chalk_1.default.yellow('Result is truncated; not all event names are shown.'));
+    }
+    return lines.join('\n');
+}
+function buildObserveCustomEventNamesJson(names, isTruncated) {
+    return {
+        names: names.map(n => ({ eventName: n.eventName, count: n.count })),
+        isTruncated,
+    };
+}

package/build/observe/formatEvents.js

@@ -4,25 +4,9 @@ exports.buildObserveEventsTable = buildObserveEventsTable;
 exports.buildObserveEventsJson = buildObserveEventsJson;
 const tslib_1 = require("tslib");
 const chalk_1 = tslib_1.__importDefault(require("chalk"));
+const renderTextTable_1 = tslib_1.__importDefault(require("../utils/renderTextTable"));
+const formatUtils_1 = require("./formatUtils");
 const metricNames_1 = require("./metricNames");
-function formatTimestamp(isoString) {
-    const date = new Date(isoString);
-    return date.toLocaleDateString('en-US', {
-        year: 'numeric',
-        month: 'short',
-        day: 'numeric',
-        hour: '2-digit',
-        minute: '2-digit',
-    });
-}
-function formatDate(isoString) {
-    const date = new Date(isoString);
-    return date.toLocaleDateString('en-US', {
-        year: 'numeric',
-        month: 'short',
-        day: 'numeric',
-    });
-}
 function resolveCustomParams(event) {
     return event.customParams ?? null;
 }
@@ -47,31 +31,18 @@ function buildObserveEventsTable(events, pageInfo, options) {
         `${event.deviceOs} ${event.deviceOsVersion}`,
         event.deviceModel,
         event.countryCode ?? '-',
-        formatTimestamp(event.timestamp),
+        (0, formatUtils_1.formatTimestamp)(event.timestamp),
     ]);
-    const colWidths = headers.map((h, i) => Math.max(h.length, ...rows.map(r => r[i].length)));
-    const headerLine = headers.map((h, i) => h.padEnd(colWidths[i])).join('  ');
-    const separatorLine = colWidths.map(w => '-'.repeat(w)).join('  ');
-    const dataLines = rows.map(row => row.map((cell, i) => cell.padEnd(colWidths[i])).join('  '));
     const lines = [];
     if (options) {
         const metricDisplay = (0, metricNames_1.getMetricDisplayName)(options.metricName);
-        let timeDesc;
-        if (options.daysBack) {
-            timeDesc = `for the last ${options.daysBack} days`;
-        }
-        else if (options.startTime && options.endTime) {
-            timeDesc = `from ${formatDate(options.startTime)} to ${formatDate(options.endTime)}`;
-        }
-        else {
-            timeDesc = '';
-        }
+        const timeDesc = (0, formatUtils_1.buildTimeRangeDescription)(options);
         const totalDesc = options.totalEventCount != null
             ? ` — ${options.totalEventCount.toLocaleString()} total events`
             : '';
         lines.push(chalk_1.default.bold(`${metricDisplay} events ${timeDesc}${totalDesc}`.trim()), '');
     }
-    lines.push(chalk_1.default.bold(headerLine), separatorLine, ...dataLines);
+    lines.push((0, renderTextTable_1.default)(headers, rows));
     if (pageInfo.hasNextPage && pageInfo.endCursor) {
         lines.push('', `Next page: --after ${pageInfo.endCursor}`);
     }

package/build/observe/formatMetrics.js

@@ -10,6 +10,7 @@ const chalk_1 = tslib_1.__importDefault(require("chalk"));
 const errors_1 = require("../commandUtils/errors");
 const platform_1 = require("../platform");
 const renderTextTable_1 = tslib_1.__importDefault(require("../utils/renderTextTable"));
+const formatUtils_1 = require("./formatUtils");
 const metricNames_1 = require("./metricNames");
 exports.STAT_ALIASES = {
     min: 'min',
@@ -105,12 +106,6 @@ function buildObserveMetricsJson(metricsMap, metricNames, stats, totalEventCount
 function buildStatsDescription(displayStats) {
     return displayStats.map(s => exports.STAT_DISPLAY_NAMES[s]).join(', ');
 }
-function buildTimeRangeDescription(daysBack) {
-    if (daysBack) {
-        return `for the last ${daysBack} days`;
-    }
-    return '';
-}
 function buildObserveMetricsTable(metricsMap, metricNames, stats, options) {
     const { versions: results } = buildObserveMetricsJson(metricsMap, metricNames, stats);
     if (results.length === 0) {
@@ -120,7 +115,7 @@ function buildObserveMetricsTable(metricsMap, metricNames, stats, options) {
     const hasEventCount = stats.includes('eventCount');
     // Build summary header
     const statsDesc = displayStats.length > 0 ? buildStatsDescription(displayStats) : 'Event count';
-    const timeDesc = buildTimeRangeDescription(options?.daysBack);
+    const timeDesc = (0, formatUtils_1.buildTimeRangeDescription)({ daysBack: options?.daysBack });
     const countSuffix = hasEventCount && displayStats.length > 0 ? ' (event count)' : '';
     const summaryLine = `${statsDesc} values${countSuffix}${timeDesc ? ` ${timeDesc}` : ''}`;
     // Group results by platform

package/build/observe/formatUtils.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Format an ISO timestamp for display in event tables (minute precision).
+ * Uses the runtime's default locale.
+ */
+export declare function formatTimestamp(isoString: string): string;
+/**
+ * Format an ISO timestamp for display in log tables (millisecond precision).
+ * Use this instead of formatTimestamp when the table represents individual
+ * log entries where sub-minute resolution matters. Uses the runtime's
+ * default locale.
+ */
+export declare function formatLogTimestamp(isoString: string): string;
+/**
+ * Format an ISO timestamp for display as a date only (no time). Uses the
+ * runtime's default locale.
+ */
+export declare function formatDate(isoString: string): string;
+/**
+ * Build the time-range fragment used in summary headers, e.g.
+ * "for the last 7 days" or "from Jan 1, 2025 to Feb 1, 2025".
+ * Returns an empty string when no range information is provided.
+ */
+export declare function buildTimeRangeDescription(options: {
+    daysBack?: number;
+    startTime?: string;
+    endTime?: string;
+}): string;

package/build/observe/formatUtils.js

@@ -0,0 +1,64 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatTimestamp = formatTimestamp;
+exports.formatLogTimestamp = formatLogTimestamp;
+exports.formatDate = formatDate;
+exports.buildTimeRangeDescription = buildTimeRangeDescription;
+/**
+ * Format an ISO timestamp for display in event tables (minute precision).
+ * Uses the runtime's default locale.
+ */
+function formatTimestamp(isoString) {
+    const date = new Date(isoString);
+    return date.toLocaleDateString(undefined, {
+        year: 'numeric',
+        month: 'short',
+        day: 'numeric',
+        hour: '2-digit',
+        minute: '2-digit',
+    });
+}
+/**
+ * Format an ISO timestamp for display in log tables (millisecond precision).
+ * Use this instead of formatTimestamp when the table represents individual
+ * log entries where sub-minute resolution matters. Uses the runtime's
+ * default locale.
+ */
+function formatLogTimestamp(isoString) {
+    const date = new Date(isoString);
+    return date.toLocaleDateString(undefined, {
+        year: 'numeric',
+        month: 'short',
+        day: 'numeric',
+        hour: '2-digit',
+        minute: '2-digit',
+        second: '2-digit',
+        fractionalSecondDigits: 3,
+    });
+}
+/**
+ * Format an ISO timestamp for display as a date only (no time). Uses the
+ * runtime's default locale.
+ */
+function formatDate(isoString) {
+    const date = new Date(isoString);
+    return date.toLocaleDateString(undefined, {
+        year: 'numeric',
+        month: 'short',
+        day: 'numeric',
+    });
+}
+/**
+ * Build the time-range fragment used in summary headers, e.g.
+ * "for the last 7 days" or "from Jan 1, 2025 to Feb 1, 2025".
+ * Returns an empty string when no range information is provided.
+ */
+function buildTimeRangeDescription(options) {
+    if (options.daysBack) {
+        return `for the last ${options.daysBack} days`;
+    }
+    if (options.startTime && options.endTime) {
+        return `from ${formatDate(options.startTime)} to ${formatDate(options.endTime)}`;
+    }
+    return '';
+}

package/build/observe/formatVersions.js

@@ -6,14 +6,7 @@ const tslib_1 = require("tslib");
 const chalk_1 = tslib_1.__importDefault(require("chalk"));
 const platform_1 = require("../platform");
 const renderTextTable_1 = tslib_1.__importDefault(require("../utils/renderTextTable"));
-function formatDate(isoString) {
-    const date = new Date(isoString);
-    return date.toLocaleDateString('en-US', {
-        year: 'numeric',
-        month: 'short',
-        day: 'numeric',
-    });
-}
+const formatUtils_1 = require("./formatUtils");
 function mapEasBuilds(easBuilds) {
     return easBuilds.map(b => ({
         easBuildId: b.easBuildId,
@@ -74,7 +67,7 @@ function buildObserveVersionsTable(results) {
         sections.push(chalk_1.default.bold(platform_1.appPlatformDisplayNames[platform]));
         const rows = appVersions.map(version => [
             version.appVersion,
-            formatDate(version.firstSeenAt),
+            (0, formatUtils_1.formatDate)(version.firstSeenAt),
             String(version.eventCount),
             String(version.uniqueUserCount),
             String(version.buildNumbers.length),