eas-cli 18.6.0 → 18.8.0

package/build/graphql/queries/UpdateInsightsQuery.js

@@ -0,0 +1,53 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UpdateInsightsQuery = void 0;
+const tslib_1 = require("tslib");
+const graphql_tag_1 = tslib_1.__importDefault(require("graphql-tag"));
+const client_1 = require("../client");
+exports.UpdateInsightsQuery = {
+    async viewUpdateGroupInsightsAsync(graphqlClient, { groupId, startTime, endTime }) {
+        const data = await (0, client_1.withUpgradeRequiredErrorHandlingAsync)(graphqlClient
+            .query((0, graphql_tag_1.default) `
+            query ViewUpdateGroupInsights($groupId: ID!, $timespan: InsightsTimespan!) {
+              updatesByGroup(group: $groupId) {
+                id
+                platform
+                insights {
+                  id
+                  totalUniqueUsers(timespan: $timespan)
+                  cumulativeAverageMetrics {
+                    launchAssetCount
+                    averageUpdatePayloadBytes
+                  }
+                  cumulativeMetrics(timespan: $timespan) {
+                    metricsAtLastTimestamp {
+                      totalInstalls
+                      totalFailedInstalls
+                    }
+                    data {
+                      labels
+                      installsDataset {
+                        id
+                        label
+                        cumulative
+                        difference
+                      }
+                      failedInstallsDataset {
+                        id
+                        label
+                        cumulative
+                        difference
+                      }
+                    }
+                  }
+                }
+              }
+            }
+          `, { groupId, timespan: { start: startTime, end: endTime } }, { additionalTypenames: ['Update', 'UpdateInsights'] })
+            .toPromise(), { featureName: 'EAS Update insights' });
+        if (data.updatesByGroup.length === 0) {
+            throw new Error(`Could not find any updates with group ID: "${groupId}"`);
+        }
+        return data.updatesByGroup;
+    },
+};

package/build/graphql/types/Observe.js

@@ -35,6 +35,7 @@ exports.AppObserveEventFragmentNode = (0, graphql_tag_1.default) `
     countryCode
     sessionId
     easClientId
+    customParams
   }
 `;
 exports.AppObserveAppVersionFragmentNode = (0, graphql_tag_1.default) `

package/build/insights/formatTimespan.d.ts

@@ -0,0 +1,7 @@
+export interface InsightsTimespanFields {
+    startTime: string;
+    endTime: string;
+    daysBack?: number;
+}
+export declare function formatTimespan(timespan: InsightsTimespanFields): string;
+export declare function toDateOnly(isoTimestamp: string): string;

package/build/insights/formatTimespan.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatTimespan = formatTimespan;
+exports.toDateOnly = toDateOnly;
+const tslib_1 = require("tslib");
+const dateformat_1 = tslib_1.__importDefault(require("dateformat"));
+function formatTimespan(timespan) {
+    if (timespan.daysBack) {
+        return `last ${timespan.daysBack} day${timespan.daysBack === 1 ? '' : 's'}`;
+    }
+    return `${toDateOnly(timespan.startTime)} to ${toDateOnly(timespan.endTime)}`;
+}
+function toDateOnly(isoTimestamp) {
+    return (0, dateformat_1.default)(new Date(isoTimestamp), 'UTC:yyyy-mm-dd');
+}

package/build/insights/timeRange.d.ts

@@ -0,0 +1,10 @@
+export declare const INSIGHTS_DEFAULT_DAYS_BACK = 7;
+export declare function resolveInsightsTimeRange(flags: {
+    days?: number;
+    start?: string;
+    end?: string;
+}): {
+    daysBack?: number;
+    startTime: string;
+    endTime: string;
+};

package/build/insights/timeRange.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.INSIGHTS_DEFAULT_DAYS_BACK = void 0;
+exports.resolveInsightsTimeRange = resolveInsightsTimeRange;
+const startAndEndTime_1 = require("../observe/startAndEndTime");
+exports.INSIGHTS_DEFAULT_DAYS_BACK = 7;
+function resolveInsightsTimeRange(flags) {
+    const days = flags.days ?? (flags.start ? undefined : exports.INSIGHTS_DEFAULT_DAYS_BACK);
+    return (0, startAndEndTime_1.resolveTimeRange)({ ...flags, days });
+}

package/build/metadata/apple/tasks/previews.js

@@ -95,19 +95,45 @@ class PreviewsTask extends task_1.AppleTask {
         }
         for (const localeCode of locales) {
             const previews = config.getPreviews(localeCode);
-            if (!previews || Object.keys(previews).length === 0) {
-                continue;
-            }
+            const existingSets = context.previewSets.get(localeCode);
             const localization = context.versionLocales.find(l => l.attributes.locale === localeCode);
             if (!localization) {
                 log_1.default.warn((0, chalk_1.default) `{yellow Skipping video previews for ${localeCode} - locale not found}`);
                 continue;
             }
-            for (const [previewType, previewConfig] of Object.entries(previews)) {
-                if (!previewConfig) {
-                    continue;
+            // Upload/sync configured previews
+            if (previews) {
+                for (const [previewType, previewConfig] of Object.entries(previews)) {
+                    if (!previewConfig) {
+                        continue;
+                    }
+                    if (!apple_utils_1.ALL_PREVIEW_TYPES.includes(previewType)) {
+                        const strippedType = previewType.replace(/^APP_/, '');
+                        const suggestion = apple_utils_1.ALL_PREVIEW_TYPES.includes(strippedType)
+                            ? (0, chalk_1.default) ` Did you mean {bold ${strippedType}}? Preview types don't use the "APP_" prefix (that's only for screenshots).`
+                            : '';
+                        log_1.default.warn((0, chalk_1.default) `{yellow Unknown preview type {bold ${previewType}} for ${localeCode}, skipping.${suggestion}}`);
+                        log_1.default.warn((0, chalk_1.default) `{yellow Valid preview types: ${apple_utils_1.ALL_PREVIEW_TYPES.join(', ')}}`);
+                        continue;
+                    }
+                    await syncPreviewSetAsync(context.projectDir, localization, previewType, normalizePreviewConfig(previewConfig), existingSets);
+                }
+            }
+            // Delete remote previews for types no longer in config
+            if (existingSets) {
+                for (const [previewType, previewSet] of existingSets) {
+                    if (previews?.[previewType]) {
+                        continue;
+                    }
+                    const existingPreviews = previewSet.attributes.appPreviews || [];
+                    for (const preview of existingPreviews) {
+                        await (0, log_2.logAsync)(() => preview.deleteAsync(), {
+                            pending: `Deleting video preview ${chalk_1.default.bold(preview.attributes.fileName)} (${localeCode})...`,
+                            success: `Deleted video preview ${chalk_1.default.bold(preview.attributes.fileName)} (${localeCode})`,
+                            failure: `Failed deleting video preview ${chalk_1.default.bold(preview.attributes.fileName)} (${localeCode})`,
+                        });
+                    }
                 }
-                await syncPreviewSetAsync(context.projectDir, localization, previewType, normalizePreviewConfig(previewConfig), context.previewSets.get(localeCode));
             }
         }
     }
@@ -156,15 +182,15 @@ async function syncPreviewSetAsync(projectDir, localization, previewType, previe
         log_1.default.log((0, chalk_1.default) `{dim Preview ${fileName} already exists, skipping upload}`);
         return;
     }
-    // Delete existing previews that don't match
+    // Delete all existing previews before uploading the new one.
+    // Apple limits each set to 3 previews, and we manage one preview per set,
+    // so we need to clean up stale entries to avoid "Too many app previews" errors.
     for (const preview of existingPreviews) {
-        if (preview.attributes.fileName !== fileName) {
-            await (0, log_2.logAsync)(() => preview.deleteAsync(), {
-                pending: `Deleting old preview ${chalk_1.default.bold(preview.attributes.fileName)} (${locale})...`,
-                success: `Deleted old preview ${chalk_1.default.bold(preview.attributes.fileName)} (${locale})`,
-                failure: `Failed deleting old preview ${chalk_1.default.bold(preview.attributes.fileName)} (${locale})`,
-            });
-        }
+        await (0, log_2.logAsync)(() => preview.deleteAsync(), {
+            pending: `Deleting old preview ${chalk_1.default.bold(preview.attributes.fileName)} (${locale})...`,
+            success: `Deleted old preview ${chalk_1.default.bold(preview.attributes.fileName)} (${locale})`,
+            failure: `Failed deleting old preview ${chalk_1.default.bold(preview.attributes.fileName)} (${locale})`,
+        });
     }
     // Upload new preview
     await (0, log_2.logAsync)(() => apple_utils_1.AppPreview.uploadAsync(localization.context, {

package/build/observe/formatEvents.d.ts

@@ -13,6 +13,9 @@ export interface ObserveEventJson {
     sessionId: string | null;
     easClientId: string;
     timestamp: string;
+    customParams: {
+        [key: string]: any;
+    } | null;
 }
 export interface BuildEventsTableOptions {
     metricName: string;

package/build/observe/formatEvents.js

@@ -23,6 +23,9 @@ function formatDate(isoString) {
         day: 'numeric',
     });
 }
+function resolveCustomParams(event) {
+    return event.customParams ?? null;
+}
 function buildObserveEventsTable(events, pageInfo, options) {
     if (events.length === 0) {
         return chalk_1.default.yellow('No events found.');
@@ -90,6 +93,7 @@ function buildObserveEventsJson(events, pageInfo) {
             sessionId: event.sessionId ?? null,
             easClientId: event.easClientId,
             timestamp: event.timestamp,
+            customParams: resolveCustomParams(event),
         })),
         pageInfo: {
             hasNextPage: pageInfo.hasNextPage,

package/build/observe/formatMetrics.d.ts

@@ -22,17 +22,18 @@ export type MetricValuesJson = Partial<Record<StatisticKey, number | null>>;
 export interface ObserveMetricsVersionResult {
     appVersion: string;
     platform: AppPlatform;
+    buildNumbers: string[];
+    updateIds: string[];
     metrics: Record<string, MetricValuesJson>;
 }
 export interface ObserveMetricsJsonOutput {
     versions: ObserveMetricsVersionResult[];
     totalEventCounts: Record<string, Record<string, number>>;
 }
-export declare function buildObserveMetricsJson(metricsMap: ObserveMetricsMap, metricNames: string[], stats: StatisticKey[], totalEventCounts?: Map<string, number>): ObserveMetricsJsonOutput;
+export declare function buildObserveMetricsJson(metricsMap: ObserveMetricsMap, metricNames: string[], stats: StatisticKey[], totalEventCounts?: Map<string, number>, buildNumbersMap?: BuildNumbersMap, updateIdsMap?: UpdateIdsMap): ObserveMetricsJsonOutput;
 export declare function buildObserveMetricsTable(metricsMap: ObserveMetricsMap, metricNames: string[], stats: StatisticKey[], options?: {
     daysBack?: number;
     buildNumbersMap?: BuildNumbersMap;
-    updateIdsMap?: UpdateIdsMap;
     totalEventCounts?: Map<string, number>;
 }): string;
 export {};

package/build/observe/formatMetrics.js

@@ -9,6 +9,7 @@ const tslib_1 = require("tslib");
 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 metricNames_1 = require("./metricNames");
 exports.STAT_ALIASES = {
     min: 'min',
@@ -65,7 +66,7 @@ function parseMetricsKey(key) {
         platform: key.slice(lastColon + 1),
     };
 }
-function buildObserveMetricsJson(metricsMap, metricNames, stats, totalEventCounts) {
+function buildObserveMetricsJson(metricsMap, metricNames, stats, totalEventCounts, buildNumbersMap, updateIdsMap) {
     const versions = [];
     for (const [key, versionMetrics] of metricsMap) {
         const { appVersion, platform } = parseMetricsKey(key);
@@ -78,7 +79,13 @@ function buildObserveMetricsJson(metricsMap, metricNames, stats, totalEventCount
             }
             metrics[metricName] = statValues;
         }
-        versions.push({ appVersion, platform, metrics });
+        versions.push({
+            appVersion,
+            platform,
+            buildNumbers: buildNumbersMap?.get(key) ?? [],
+            updateIds: updateIdsMap?.get(key) ?? [],
+            metrics,
+        });
     }
     // Group total event counts by metric → platform
     const counts = {};
@@ -104,19 +111,6 @@ function buildTimeRangeDescription(daysBack) {
     }
     return '';
 }
-function renderTable(headers, rows, footerRow) {
-    const allRows = footerRow ? [...rows, footerRow] : rows;
-    const colWidths = headers.map((h, i) => Math.max(h.length, ...allRows.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 = [chalk_1.default.bold(headerLine), separatorLine, ...dataLines];
-    if (footerRow) {
-        lines.push(separatorLine);
-        lines.push(footerRow.map((cell, i) => cell.padEnd(colWidths[i])).join('  '));
-    }
-    return lines.join('\n');
-}
 function buildObserveMetricsTable(metricsMap, metricNames, stats, options) {
     const { versions: results } = buildObserveMetricsJson(metricsMap, metricNames, stats);
     if (results.length === 0) {
@@ -154,23 +148,18 @@ function buildObserveMetricsTable(metricsMap, metricNames, stats, options) {
             }
         }
     }
-    // Check if any version has updates
-    const hasUpdates = options?.updateIdsMap
-        ? Array.from(options.updateIdsMap.values()).some(ids => ids.length > 0)
-        : false;
-    const headers = ['App Version', ...(hasUpdates ? ['Updates'] : []), ...metricHeaders];
+    const headers = ['App Version', ...metricHeaders];
     const sections = [chalk_1.default.bold(summaryLine)];
     for (const [platform, platformResults] of byPlatform) {
         sections.push('');
         sections.push(chalk_1.default.bold(platform_1.appPlatformDisplayNames[platform]));
-        const rows = platformResults.map(result => {
+        const rows = [];
+        for (const result of platformResults) {
             const key = makeMetricsKey(result.appVersion, result.platform);
             const buildNumbers = options?.buildNumbersMap?.get(key);
             const versionLabel = buildNumbers?.length
                 ? `${result.appVersion} (${buildNumbers.join(', ')})`
                 : result.appVersion;
-            const updateIds = options?.updateIdsMap?.get(key);
-            const updatesLabel = updateIds?.length ? updateIds.join(', ') : '';
             const metricCells = [];
             for (const m of metricNames) {
                 const values = result.metrics[m];
@@ -187,8 +176,8 @@ function buildObserveMetricsTable(metricsMap, metricNames, stats, options) {
                     }
                 }
             }
-            return [versionLabel, ...(hasUpdates ? [updatesLabel] : []), ...metricCells];
-        });
+            rows.push([versionLabel, ...metricCells]);
+        }
         let footerRow;
         if (options?.totalEventCounts) {
             const countCells = [];
@@ -197,10 +186,10 @@ function buildObserveMetricsTable(metricsMap, metricNames, stats, options) {
                 countCells.push(count != null ? count.toLocaleString() : '-');
             }
             if (countCells.some(c => c !== '-')) {
-                footerRow = ['Total events', ...(hasUpdates ? [''] : []), ...countCells];
+                footerRow = ['Total events', ...countCells];
             }
         }
-        sections.push(renderTable(headers, rows, footerRow));
+        sections.push((0, renderTextTable_1.default)(headers, rows, footerRow));
     }
     return sections.join('\n');
 }

package/build/observe/formatVersions.js

@@ -5,6 +5,7 @@ exports.buildObserveVersionsTable = buildObserveVersionsTable;
 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', {
@@ -56,13 +57,6 @@ function buildObserveVersionsJson(results) {
     }
     return output;
 }
-function renderTable(headers, rows) {
-    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('  '));
-    return [chalk_1.default.bold(headerLine), separatorLine, ...dataLines].join('\n');
-}
 function buildObserveVersionsTable(results) {
     const hasAnyVersions = results.some(r => r.appVersions.length > 0);
     if (!hasAnyVersions) {
@@ -86,7 +80,7 @@ function buildObserveVersionsTable(results) {
             String(version.buildNumbers.length),
             String(version.updates.length),
         ]);
-        sections.push(renderTable(headers, rows));
+        sections.push((0, renderTextTable_1.default)(headers, rows));
     }
     return sections.join('\n');
 }

package/build/update/insights/formatInsights.d.ts

@@ -0,0 +1,34 @@
+import { UpdateWithInsightsObject } from '../../graphql/queries/UpdateInsightsQuery';
+export interface UpdateInsightsTimespan {
+    startTime: string;
+    endTime: string;
+    daysBack?: number;
+}
+export interface UpdateInsightsDailyEntry {
+    date: string;
+    installs: number;
+    failedInstalls: number;
+}
+export interface UpdateInsightsPlatformSummary {
+    platform: string;
+    updateId: string;
+    totalUniqueUsers: number;
+    totalInstalls: number;
+    totalFailedInstalls: number;
+    crashRatePercent: number;
+    launchAssetCount: number;
+    averageUpdatePayloadBytes: number;
+    daily: UpdateInsightsDailyEntry[];
+}
+export interface UpdateInsightsSummary {
+    groupId: string;
+    startTime: string;
+    endTime: string;
+    daysBack?: number;
+    platforms: UpdateInsightsPlatformSummary[];
+}
+export declare function toUpdateInsightsSummary(groupId: string, updates: UpdateWithInsightsObject[], timespan: UpdateInsightsTimespan): UpdateInsightsSummary;
+export declare function buildUpdateInsightsJson(summary: UpdateInsightsSummary): object;
+export declare function buildUpdateInsightsTable(summary: UpdateInsightsSummary): string;
+export declare function formatPercent(value: number): string;
+export declare function formatBytes(bytes: number): string;

package/build/update/insights/formatInsights.js

@@ -0,0 +1,128 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toUpdateInsightsSummary = toUpdateInsightsSummary;
+exports.buildUpdateInsightsJson = buildUpdateInsightsJson;
+exports.buildUpdateInsightsTable = buildUpdateInsightsTable;
+exports.formatPercent = formatPercent;
+exports.formatBytes = formatBytes;
+const tslib_1 = require("tslib");
+const chalk_1 = tslib_1.__importDefault(require("chalk"));
+const formatTimespan_1 = require("../../insights/formatTimespan");
+const formatFields_1 = tslib_1.__importDefault(require("../../utils/formatFields"));
+const renderTextTable_1 = tslib_1.__importDefault(require("../../utils/renderTextTable"));
+function toUpdateInsightsSummary(groupId, updates, timespan) {
+    const platforms = updates
+        .map(toPlatformSummary)
+        .sort((a, b) => a.platform.localeCompare(b.platform));
+    return {
+        groupId,
+        startTime: timespan.startTime,
+        endTime: timespan.endTime,
+        daysBack: timespan.daysBack,
+        platforms,
+    };
+}
+function toPlatformSummary(update) {
+    const { insights } = update;
+    const { totalInstalls, totalFailedInstalls } = insights.cumulativeMetrics.metricsAtLastTimestamp;
+    const denom = totalInstalls + totalFailedInstalls;
+    const crashRatePercent = denom === 0 ? 0 : (totalFailedInstalls / denom) * 100;
+    const { labels, installsDataset, failedInstallsDataset } = insights.cumulativeMetrics.data;
+    const daily = labels.map((date, i) => ({
+        date,
+        installs: installsDataset.difference[i] ?? 0,
+        failedInstalls: failedInstallsDataset.difference[i] ?? 0,
+    }));
+    return {
+        platform: update.platform,
+        updateId: update.id,
+        totalUniqueUsers: insights.totalUniqueUsers,
+        totalInstalls,
+        totalFailedInstalls,
+        crashRatePercent,
+        launchAssetCount: insights.cumulativeAverageMetrics.launchAssetCount,
+        averageUpdatePayloadBytes: insights.cumulativeAverageMetrics.averageUpdatePayloadBytes,
+        daily,
+    };
+}
+function buildUpdateInsightsJson(summary) {
+    return {
+        groupId: summary.groupId,
+        timespan: {
+            start: summary.startTime,
+            end: summary.endTime,
+            ...(summary.daysBack !== undefined ? { daysBack: summary.daysBack } : {}),
+        },
+        platforms: summary.platforms.map(p => ({
+            platform: p.platform,
+            updateId: p.updateId,
+            totals: {
+                uniqueUsers: p.totalUniqueUsers,
+                installs: p.totalInstalls,
+                failedInstalls: p.totalFailedInstalls,
+                crashRatePercent: p.crashRatePercent,
+            },
+            payload: {
+                launchAssetCount: p.launchAssetCount,
+                averageUpdatePayloadBytes: p.averageUpdatePayloadBytes,
+            },
+            daily: p.daily,
+        })),
+    };
+}
+function buildUpdateInsightsTable(summary) {
+    const sections = [];
+    sections.push(chalk_1.default.bold('Update group insights:'));
+    sections.push((0, formatFields_1.default)([
+        { label: 'Group ID', value: summary.groupId },
+        { label: 'Time range', value: (0, formatTimespan_1.formatTimespan)(summary) },
+        { label: 'Platforms', value: summary.platforms.map(p => p.platform).join(', ') || 'N/A' },
+    ]));
+    const dailyHeader = summary.daysBack ? ` (last ${summary.daysBack} days)` : '';
+    for (const platform of summary.platforms) {
+        sections.push('');
+        sections.push(chalk_1.default.bold(`${chalk_1.default.cyan(platform.platform)}:`));
+        sections.push((0, formatFields_1.default)([
+            { label: 'Update ID', value: platform.updateId },
+            { label: 'Launches', value: platform.totalInstalls.toLocaleString() },
+            { label: 'Failed launches', value: platform.totalFailedInstalls.toLocaleString() },
+            { label: 'Crash rate', value: formatPercent(platform.crashRatePercent) },
+            { label: 'Unique users', value: platform.totalUniqueUsers.toLocaleString() },
+            { label: 'Launch assets', value: platform.launchAssetCount.toLocaleString() },
+            { label: 'Avg payload size', value: formatBytes(platform.averageUpdatePayloadBytes) },
+        ]));
+        if (platform.daily.length > 0) {
+            sections.push('');
+            sections.push(chalk_1.default.bold(`  Daily breakdown${dailyHeader}:`));
+            sections.push('');
+            sections.push(indent(renderDailyTable(platform.daily), 2));
+        }
+    }
+    return sections.join('\n');
+}
+function formatPercent(value) {
+    return `${value.toFixed(2)}%`;
+}
+function formatBytes(bytes) {
+    if (bytes < 1024) {
+        return `${bytes} B`;
+    }
+    if (bytes < 1024 * 1024) {
+        return `${(bytes / 1024).toFixed(1)} KB`;
+    }
+    return `${(bytes / 1024 / 1024).toFixed(2)} MB`;
+}
+function renderDailyTable(rows) {
+    return (0, renderTextTable_1.default)(['Date', 'Launches', 'Crashes'], rows.map(r => [
+        (0, formatTimespan_1.toDateOnly)(r.date),
+        r.installs.toLocaleString(),
+        r.failedInstalls.toLocaleString(),
+    ]));
+}
+function indent(text, spaces) {
+    const pad = ' '.repeat(spaces);
+    return text
+        .split('\n')
+        .map(line => (line.length > 0 ? pad + line : line))
+        .join('\n');
+}

package/build/utils/renderTextTable.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Render a simple column-aligned text table with a bold header row, a dashed
+ * separator, the data rows, and an optional footer row (preceded by its own
+ * separator). Columns are padded to the widest cell in that column.
+ */
+export default function renderTextTable(headers: string[], rows: string[][], footerRow?: string[]): string;

package/build/utils/renderTextTable.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = renderTextTable;
+const tslib_1 = require("tslib");
+const chalk_1 = tslib_1.__importDefault(require("chalk"));
+/**
+ * Render a simple column-aligned text table with a bold header row, a dashed
+ * separator, the data rows, and an optional footer row (preceded by its own
+ * separator). Columns are padded to the widest cell in that column.
+ */
+function renderTextTable(headers, rows, footerRow) {
+    const allRows = footerRow ? [...rows, footerRow] : rows;
+    const colWidths = headers.map((h, i) => Math.max(h.length, ...allRows.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 = [chalk_1.default.bold(headerLine), separatorLine, ...dataLines];
+    if (footerRow) {
+        lines.push(separatorLine);
+        lines.push(footerRow.map((cell, i) => (cell ?? '').padEnd(colWidths[i])).join('  '));
+    }
+    return lines.join('\n');
+}