@gpc-cli/core 0.10.6 → 0.10.7

package/README.md

@@ -13,34 +13,39 @@ npm install @gpc-cli/core
 ## Usage
 
 ```typescript
+import { resolveAuth } from "@gpc-cli/auth";
+import { createApiClient, createReportingClient } from "@gpc-cli/api";
 import {
   uploadRelease,
   promoteRelease,
-  getVitalsOverview,
+  getVitalsCrashes,
+  latestWorstValue,
   listReviews,
   analyzeBundle,
   formatOutput,
 } from "@gpc-cli/core";
 
-// Upload a release
-const result = await uploadRelease(context, {
-  file: "app.aab",
-  track: "internal",
-  validateOnly: true, // dry-run: server-side validation without committing
-});
-
-// Promote between tracks
-await promoteRelease(context, {
-  from: "internal",
-  to: "production",
-  rollout: 0.1,
-});
-
-// Check vitals
-const vitals = await getVitalsOverview(context);
-console.log(formatOutput(vitals, "table")); // also: "json", "csv", "tsv"
-
-// Analyze bundle size
+const auth = await resolveAuth({ serviceAccountPath: "./play-sa.json" });
+const client = createApiClient({ auth });
+const reporting = createReportingClient({ auth });
+const app = "com.example.app";
+
+// Upload a release (validateOnly: server-side validation without committing)
+await uploadRelease(client, app, "app.aab", { track: "internal", validateOnly: true });
+
+// Promote between tracks at a 10% staged rollout
+await promoteRelease(client, app, "internal", "production", { userFraction: 0.1 });
+
+// Gate on vitals: rates are fractions (0.02 = 2%)
+const crashes = await getVitalsCrashes(reporting, app, { days: 7 });
+const crashRate = latestWorstValue(crashes.rows, "crashRate");
+if (crashRate !== undefined && crashRate > 0.02) process.exitCode = 6;
+
+// Recent reviews as a table (also: "json", "csv", "tsv")
+const { reviews } = await listReviews(client, app);
+console.log(formatOutput(reviews, "table"));
+
+// Analyze bundle size offline
 const analysis = await analyzeBundle("./app.aab");
 ```
 
@@ -52,7 +57,7 @@ const analysis = await analyzeBundle("./app.aab");
 | **Listings**      | `getListings`, `updateListing`, `pullListings`, `pushListings`, `diffListings`                                                                                                             |
 | **Images**        | `listImages`, `uploadImage`, `deleteImage`                                                                                                                                                 |
 | **Reviews**       | `listReviews`, `getReview`, `replyToReview`, `exportReviews`                                                                                                                               |
-| **Vitals**        | `getVitalsOverview`, `getVitalsCrashes`, `getVitalsAnr`, `getVitalsStartup`, `compareVitalsTrend`, `checkThreshold`                                                                        |
+| **Vitals**        | `getVitalsOverview`, `getVitalsCrashes`, `getVitalsAnr`, `getVitalsStartup`, `compareVitalsTrend`, `checkThreshold`, `latestWorstValue`, `readMetricValue`                                 |
 | **Subscriptions** | `listSubscriptions`, `createSubscription`, `updateSubscription`, `deleteSubscription`, `listOffers`, `createOffer`                                                                         |
 | **IAP**           | `listInAppProducts`, `createInAppProduct`, `syncInAppProducts`                                                                                                                             |
 | **Purchases**     | `getProductPurchase`, `acknowledgeProductPurchase`, `refundOrder`                                                                                                                          |

package/dist/index.d.ts

@@ -720,12 +720,43 @@ interface VitalsOverview {
     slowRenderingRate?: MetricRow[];
     excessiveWakeupRate?: MetricRow[];
     stuckWakelockRate?: MetricRow[];
+    /** Metrics that could not be read, with the reason. Absent when every query succeeded. */
+    unavailable?: {
+        metric: string;
+        code: string;
+        reason: string;
+    }[];
 }
 interface ThresholdResult {
     breached: boolean;
     value: number | undefined;
     threshold: number;
 }
+/**
+ * Numeric value of `metric` in a row (the first metric when no name is given).
+ * Google returns `metrics` as an array of `{ metric, decimalValue }`; the
+ * `MetricRow` type describes a name-keyed map, so both shapes are read. A lookup
+ * by name on the array always missed, which left `gpc watch` blind.
+ */
+declare function readMetricValue(row: MetricRow | undefined, metric?: string): number | undefined;
+/**
+ * Worst (highest) value of `metric` on the most recent day in `rows`. Rows come
+ * one per day per slice (start type, report type, --dim value), so "the last
+ * row" is an arbitrary slice; a gate must compare the worst one.
+ */
+declare function latestWorstValue(rows: MetricRow[] | undefined, metric?: string): number | undefined;
+/**
+ * Average of `metric` over the window for each slice, then the worst slice. Without
+ * dimensions this is the plain average; with start types it reports the worst of
+ * cold, warm and hot instead of blending them.
+ */
+declare function worstSliceAverage(rows: MetricRow[] | undefined, metric?: string): number | undefined;
+/**
+ * Rejects a rate threshold that can never be reached. Google reports rates as
+ * fractions (0.02 = 2%), so 1 or more is almost always a percentage written by
+ * mistake, and it left the gate silently open.
+ */
+declare function assertRateThreshold(label: string, threshold: number): void;
 declare function getVitalsOverview(reporting: ReportingApiClient, packageName: string): Promise<VitalsOverview>;
 declare function getVitalsCrashes(reporting: ReportingApiClient, packageName: string, options?: VitalsQueryOptions): Promise<MetricSetResponse>;
 declare function getVitalsAnr(reporting: ReportingApiClient, packageName: string, options?: VitalsQueryOptions): Promise<MetricSetResponse>;
@@ -781,6 +812,8 @@ interface WatchVitalsOptions {
     onHalt?: (value: number) => Promise<void>;
     /** Called on each poll result (value may be undefined if no data). */
     onPoll?: (value: number | undefined, breached: boolean) => void;
+    /** Called when a poll fails; polling continues. */
+    onError?: (err: unknown) => void;
 }
 /**
  * Poll vitals on an interval; invoke onHalt if threshold is breached.
@@ -810,6 +843,8 @@ interface WatchVitalReading {
     value: number | undefined;
     threshold: number | undefined;
     breached: boolean;
+    /** Set when the metric could not be read this round (error code, or message). */
+    error?: string;
 }
 interface WatchEvent {
     round: number;
@@ -824,6 +859,10 @@ interface WatchSummary {
     durationMs: number;
     finalRollout: number | null;
     breachCount: number;
+    /** Rounds in which a metric with a threshold could not be read (games-only metrics excluded). */
+    unreadableRounds: number;
+    /** True when the last round had such an unreadable metric: the gate ended blind. */
+    lastRoundUnreadable: boolean;
     halted: boolean;
     events: WatchEvent[];
 }
@@ -2013,4 +2052,4 @@ declare function readinessBadgeColor(grade: ReadinessGrade): string;
 declare function readinessBadgeUrl(score: ReadinessScore): string;
 declare function readinessBadgeMarkdown(score: ReadinessScore): string;
 
-export { ApiError, type ApiSigningFingerprint, type AppInfo, type AppStatus, type ApplyReleaseNotesResult, type AuditEntry, type BatchSyncResult, type BundleAnalysis, type BundleComparison, type BundleEntry, type BundleSizeCheckResult, type BundleSizeConfig, type BundlesWaitOptions, type ChangelogEntry, type ChecklistInput, type ChecklistItem, type ChecklistResult, type CommandContext, type CommitCluster, type CommitResult, ConfigError, type CreateEnterpriseAppParams, DEFAULT_LIMITS, DEFAULT_MODELS, DEFAULT_PREFLIGHT_CONFIG, DEFAULT_WATCH_THRESHOLDS, type DecodedNotification, type DiffToken, type DiscoverPluginsOptions, type DiscoveredPlugin, type DryRunPublishResult, type DryRunResult, type DryRunUploadResult, type ErrorReason, type ExportImagesOptions, type ExportImagesSummary, type ExternalTransactionRefundOptions, type FastlaneDetection, type FastlaneLane, type FetchChangelogOptions, type FieldLintResult, type FileValidationResult, type FinancialReportDownload, type FindingSeverity, GOOGLE_PLAY_LANGUAGES, type GameConfigDiff, type GamesPushOptions, type GamesSyncResult, type GenerateOptions, type GeneratedChangelog, type GetAppStatusOptions, type GitNotesOptions, type GitReleaseNotes, type GitRunner, GpcError, type ImageSyncDetail, type ImageSyncOptions, type ImageSyncResult, type ImageValidationResult, type InitOptions, type InitResult, type InternalSharingUploadResult, type KeystoreFingerprint, type ListGamesConfigOptions, type ListIapOptions, type ListReportsResult, type ListSubscriptionsOptions, type ListUsersOptions, type ListVoidedOptions, type ListingDiff, type ListingFieldLimits, type ListingLintResult, type ListingsResult, type LoadedPlugin, type LocaleBundle, type LocaleEntry, type MigrationResult, NetworkError, type OneTimeProductDiff, type OutputMode, PERMISSION_PROPAGATION_WARNING, PLACEHOLDER_TEXT, PLAY_STORE_LIMIT, PROVIDER_WHITELIST, type ParsedCommit, type ParsedManifest, type ParsedMonth, type PlayStoreFormat, type PlayStoreRenderOptions, PluginManager, type PreflightConfig, type PreflightFinding, type PreflightOptions, type PreflightResult, type PreflightScanner, type Provider, type PublishOptions, type PublishResult, type PushResult, type QuotaUsage, RENDERERS, REVIEW_SORT_PRESETS, type RawCommit, type ReadinessBreakdownEntry, type ReadinessGrade, type ReadinessScore, type ReadinessSignal, type ReadinessSignalStatus, type RefundReviewPreference, type ReleaseDiff, type ReleaseNotesValidation, type ReleaseStatusResult, type Renderer, type ReportObject, type ReportsAuth, type ResolveAiConfigOptions, type ResolveLocalesOptions, type ReviewAnalysis, type ReviewExportOptions, type ReviewOrderRefundOptions, type ReviewOrderRefundResult, type ReviewSortPreset, type ReviewsFilterOptions, type RevocationRefundType, type RtdnStatus, SECTION_ORDER, SENSITIVE_ARG_KEYS, SENSITIVE_KEYS, SEVERITY_ORDER, type ScaffoldOptions, type ScaffoldResult, type SigningConsistencyResult, type SigningKeyComparison, type Spinner, type StatsReportDownload, type StatusDiff, type StatusRelease, type StatusReviews, type StatusVitalMetric, type SubscriptionAnalytics, type SubscriptionDiff, type SyncResult, type ThresholdResult, type TrainConfig, type TrainState, type TranslateBundleOptions, type TranslatedBundle, type TranslationFailure, type TranslationPath, type TranslationResult, type Translator, type TranslatorConfig, type UploadResult, VALID_WATCH_METRICS, type ValidateCheck, type ValidateOptions, type ValidateResult, type ValidatedPluginApproval, type VersionVitalsComparison, type VersionVitalsRow, type VitalsOverview, type VitalsQueryOptions, type VitalsTrendComparison, type WatchAction, type WatchCallbacks, type WatchConfig, type WatchEvent, type WatchMetric, type WatchOptions, type WatchRollout, type WatchSummary, type WatchVitalReading, type WatchVitalsOptions, type WebhookPayload, type ZipCsvEntry, abortTrain, acknowledgeProductPurchase, activateBasePlan, activateOffer, addRecoveryTargeting, addTesters, advanceTrain, analyzeBundle, analyzeRemoteListings, analyzeReviews, annotateListResult, applyReleaseNotes, assignRelease, batchGetOrders, batchSyncInAppProducts, buildChecklist, buildExternalTransactionRefund, buildLocaleBundle, bundleToReleaseNotes, cancelRecoveryAction, cancelSubscriptionPurchase, cancelSubscriptionV2, checkBundleSize, checkSigningConsistency, checkThreshold, classifyError, clearAuditLog, commitWithRescue, compareBundles, compareFingerprints, compareVersionVitals, compareVitalsTrend, computeStatusDiff, consumeProductPurchase, convertRegionPrices, createAchievementConfig, createAuditEntry, createDeviceTier, createEnterpriseApp, createExternalTransaction, createGrant, createInAppProduct, createLeaderboardConfig, createOffer, createOneTimeOffer, createOneTimeProduct, createRecoveryAction, createSpinner, createSubscription, createTrack, createTranslator, deactivateBasePlan, deactivateOffer, decodeCsvText, decodeNotification, decodeStatsCsv, defaultGitRunner, deferSubscriptionPurchase, deferSubscriptionV2, deleteAchievementConfig, deleteBasePlan, deleteGrant, deleteImage, deleteInAppProduct, deleteLeaderboardConfig, deleteListing, deleteOffer, deleteOneTimeOffer, deleteOneTimeProduct, deleteSubscription, deployRecoveryAction, detectFastlane, detectOutputFormat, diffAchievementConfig, diffLeaderboardConfig, diffListings, diffListingsCommand, diffListingsEnhanced, diffOneTimeProduct, diffReleases, diffSubscription, discoverPluginEntries, discoverPlugins, dispatchWebhook, downloadFinancialReport, downloadGeneratedApk, downloadReportObject, downloadStatsReport, exportImages, exportReviews, extractCsvEntriesFromZip, fetchAggregateCost, fetchChangelog, fetchReleaseNotes, findBundle, formatChangelogEntry, formatCustomPayload, formatDiscordPayload, formatJunit, formatMoney, formatNotification, formatOutput, formatPathLabel, formatSlackPayload, formatStatusDiff, formatStatusSummary, formatStatusTable, formatWordDiff, generateChangelog, generateMigrationPlan, generateNotesFromGit, getAchievementConfig, getAllScannerNames, getApiSigningFingerprint, getAppInfo, getAppStatus, getCountryAvailability, getDeviceTier, getExternalTransaction, getInAppProduct, getKeystoreFingerprint, getLeaderboardConfig, getListings, getOffer, getOneTimeOffer, getOneTimeProduct, getOrderDetails, getProductPurchase, getProductPurchaseV2, getQuotaUsage, getReleasesStatus, getReview, getRtdnStatus, getSubscription, getSubscriptionAnalytics, getSubscriptionPurchase, getTrainStatus, getUser, getVitalsAnomalies, getVitalsAnr, getVitalsBattery, getVitalsCrashes, getVitalsErrorCount, getVitalsLmk, getVitalsMemory, getVitalsMemoryBitmap, getVitalsMemoryRss, getVitalsOverview, getVitalsRendering, getVitalsStartup, gradeFromPercent, gunzipIfNeeded, handleBreach, importDataSafety, importTestersFromCsv, initAudit, initProject, inviteUser, isFinancialReportType, isGzip, isStatsReportType, isValidBcp47, isValidReportType, isValidStatsDimension, isVersionedNotesDir, isZip, lintListing, lintListings, lintLocalListings, listAchievementConfigs, listAchievements, listAuditEvents, listBundles, listDeviceTiers, listGeneratedApks, listGrants, listImages, listInAppProducts, listLeaderboardConfigs, listLeaderboards, listOffers, listOneTimeOffers, listOneTimeProducts, listRecoveryActions, listReportObjects, listReports, listReviews, listSubscriptions, listTesters, listTracks, listUsers, listVoidedPurchases, loadPreflightConfig, loadStatusCache, maybePaginate, migratePrices, monthToken, moreResultsFooter, normalizeFingerprint, parseAppfile, parseCommit, parseFastfile, parseGrantArg, parseKeytoolOutput, parseMonth, parseRemoteUrl, pauseTrain, promoteRelease, publish, publishEnterpriseApp, pullAchievementConfigs, pullLeaderboardConfigs, pullListings, pushAchievementConfigs, pushLeaderboardConfigs, pushListings, readListingsFromDir, readReleaseNotesForVersion, readReleaseNotesFromDir, readinessBadgeColor, readinessBadgeMarkdown, readinessBadgeUrl, redactAuditArgs, redactSensitive, refundExternalTransaction, refundOrder, relativeTime, removeTesters, removeUser, renderChecklistMarkdown, renderJson, renderMarkdown, renderPlayStore, renderPlayStoreJson, renderPlayStoreMd, renderPlayStorePrompt, renderPrompt, replyToReview, reportAccessDeniedError, reportBucketNotFoundError, reportObjectNotFoundError, reportPrefix, resolveAiConfig, resolveLocales, resolveReportsBucket, retryOnUploadNotComplete, reviewOrderRefund, revokeSubscriptionPurchase, runPreflight, runWatch, runWatchLoop, safePath, safePathWithin, saveStatusCache, scaffoldPlugin, scoreReadiness, searchAuditEvents, searchVitalsErrors, sendNotification, sendWebhook, setAchievementIcon, setLeaderboardIcon, sha256File, sortResults, sortReviews, startTrain, statusHasBreach, syncImages, syncInAppProducts, topFiles, trackBreachState, translateBundle, updateAchievementConfig, updateAppDetails, updateDataSafety, updateGrant, updateInAppProduct, updateLeaderboardConfig, updateListing, updateOffer, updateOneTimeOffer, updateOneTimeProduct, updateRollout, updateSubscription, updateTrackConfig, updateUser, uploadExternallyHosted, uploadImage, uploadInternalSharing, uploadRelease, validateAndCommit, validateBundleForApply, validateImage, validateLanguageCode, validatePackageName, validatePluginForApproval, validatePreSubmission, validateReleaseNotes, validateSku, validateTrackName, validateUploadFile, validateVersionCode, waitForBundle, waitForBundleProcessing, watchVitalsWithAutoHalt, wordDiff, writeAuditLog, writeListingsToDir, writeMigrationOutput };
+export { ApiError, type ApiSigningFingerprint, type AppInfo, type AppStatus, type ApplyReleaseNotesResult, type AuditEntry, type BatchSyncResult, type BundleAnalysis, type BundleComparison, type BundleEntry, type BundleSizeCheckResult, type BundleSizeConfig, type BundlesWaitOptions, type ChangelogEntry, type ChecklistInput, type ChecklistItem, type ChecklistResult, type CommandContext, type CommitCluster, type CommitResult, ConfigError, type CreateEnterpriseAppParams, DEFAULT_LIMITS, DEFAULT_MODELS, DEFAULT_PREFLIGHT_CONFIG, DEFAULT_WATCH_THRESHOLDS, type DecodedNotification, type DiffToken, type DiscoverPluginsOptions, type DiscoveredPlugin, type DryRunPublishResult, type DryRunResult, type DryRunUploadResult, type ErrorReason, type ExportImagesOptions, type ExportImagesSummary, type ExternalTransactionRefundOptions, type FastlaneDetection, type FastlaneLane, type FetchChangelogOptions, type FieldLintResult, type FileValidationResult, type FinancialReportDownload, type FindingSeverity, GOOGLE_PLAY_LANGUAGES, type GameConfigDiff, type GamesPushOptions, type GamesSyncResult, type GenerateOptions, type GeneratedChangelog, type GetAppStatusOptions, type GitNotesOptions, type GitReleaseNotes, type GitRunner, GpcError, type ImageSyncDetail, type ImageSyncOptions, type ImageSyncResult, type ImageValidationResult, type InitOptions, type InitResult, type InternalSharingUploadResult, type KeystoreFingerprint, type ListGamesConfigOptions, type ListIapOptions, type ListReportsResult, type ListSubscriptionsOptions, type ListUsersOptions, type ListVoidedOptions, type ListingDiff, type ListingFieldLimits, type ListingLintResult, type ListingsResult, type LoadedPlugin, type LocaleBundle, type LocaleEntry, type MigrationResult, NetworkError, type OneTimeProductDiff, type OutputMode, PERMISSION_PROPAGATION_WARNING, PLACEHOLDER_TEXT, PLAY_STORE_LIMIT, PROVIDER_WHITELIST, type ParsedCommit, type ParsedManifest, type ParsedMonth, type PlayStoreFormat, type PlayStoreRenderOptions, PluginManager, type PreflightConfig, type PreflightFinding, type PreflightOptions, type PreflightResult, type PreflightScanner, type Provider, type PublishOptions, type PublishResult, type PushResult, type QuotaUsage, RENDERERS, REVIEW_SORT_PRESETS, type RawCommit, type ReadinessBreakdownEntry, type ReadinessGrade, type ReadinessScore, type ReadinessSignal, type ReadinessSignalStatus, type RefundReviewPreference, type ReleaseDiff, type ReleaseNotesValidation, type ReleaseStatusResult, type Renderer, type ReportObject, type ReportsAuth, type ResolveAiConfigOptions, type ResolveLocalesOptions, type ReviewAnalysis, type ReviewExportOptions, type ReviewOrderRefundOptions, type ReviewOrderRefundResult, type ReviewSortPreset, type ReviewsFilterOptions, type RevocationRefundType, type RtdnStatus, SECTION_ORDER, SENSITIVE_ARG_KEYS, SENSITIVE_KEYS, SEVERITY_ORDER, type ScaffoldOptions, type ScaffoldResult, type SigningConsistencyResult, type SigningKeyComparison, type Spinner, type StatsReportDownload, type StatusDiff, type StatusRelease, type StatusReviews, type StatusVitalMetric, type SubscriptionAnalytics, type SubscriptionDiff, type SyncResult, type ThresholdResult, type TrainConfig, type TrainState, type TranslateBundleOptions, type TranslatedBundle, type TranslationFailure, type TranslationPath, type TranslationResult, type Translator, type TranslatorConfig, type UploadResult, VALID_WATCH_METRICS, type ValidateCheck, type ValidateOptions, type ValidateResult, type ValidatedPluginApproval, type VersionVitalsComparison, type VersionVitalsRow, type VitalsOverview, type VitalsQueryOptions, type VitalsTrendComparison, type WatchAction, type WatchCallbacks, type WatchConfig, type WatchEvent, type WatchMetric, type WatchOptions, type WatchRollout, type WatchSummary, type WatchVitalReading, type WatchVitalsOptions, type WebhookPayload, type ZipCsvEntry, abortTrain, acknowledgeProductPurchase, activateBasePlan, activateOffer, addRecoveryTargeting, addTesters, advanceTrain, analyzeBundle, analyzeRemoteListings, analyzeReviews, annotateListResult, applyReleaseNotes, assertRateThreshold, assignRelease, batchGetOrders, batchSyncInAppProducts, buildChecklist, buildExternalTransactionRefund, buildLocaleBundle, bundleToReleaseNotes, cancelRecoveryAction, cancelSubscriptionPurchase, cancelSubscriptionV2, checkBundleSize, checkSigningConsistency, checkThreshold, classifyError, clearAuditLog, commitWithRescue, compareBundles, compareFingerprints, compareVersionVitals, compareVitalsTrend, computeStatusDiff, consumeProductPurchase, convertRegionPrices, createAchievementConfig, createAuditEntry, createDeviceTier, createEnterpriseApp, createExternalTransaction, createGrant, createInAppProduct, createLeaderboardConfig, createOffer, createOneTimeOffer, createOneTimeProduct, createRecoveryAction, createSpinner, createSubscription, createTrack, createTranslator, deactivateBasePlan, deactivateOffer, decodeCsvText, decodeNotification, decodeStatsCsv, defaultGitRunner, deferSubscriptionPurchase, deferSubscriptionV2, deleteAchievementConfig, deleteBasePlan, deleteGrant, deleteImage, deleteInAppProduct, deleteLeaderboardConfig, deleteListing, deleteOffer, deleteOneTimeOffer, deleteOneTimeProduct, deleteSubscription, deployRecoveryAction, detectFastlane, detectOutputFormat, diffAchievementConfig, diffLeaderboardConfig, diffListings, diffListingsCommand, diffListingsEnhanced, diffOneTimeProduct, diffReleases, diffSubscription, discoverPluginEntries, discoverPlugins, dispatchWebhook, downloadFinancialReport, downloadGeneratedApk, downloadReportObject, downloadStatsReport, exportImages, exportReviews, extractCsvEntriesFromZip, fetchAggregateCost, fetchChangelog, fetchReleaseNotes, findBundle, formatChangelogEntry, formatCustomPayload, formatDiscordPayload, formatJunit, formatMoney, formatNotification, formatOutput, formatPathLabel, formatSlackPayload, formatStatusDiff, formatStatusSummary, formatStatusTable, formatWordDiff, generateChangelog, generateMigrationPlan, generateNotesFromGit, getAchievementConfig, getAllScannerNames, getApiSigningFingerprint, getAppInfo, getAppStatus, getCountryAvailability, getDeviceTier, getExternalTransaction, getInAppProduct, getKeystoreFingerprint, getLeaderboardConfig, getListings, getOffer, getOneTimeOffer, getOneTimeProduct, getOrderDetails, getProductPurchase, getProductPurchaseV2, getQuotaUsage, getReleasesStatus, getReview, getRtdnStatus, getSubscription, getSubscriptionAnalytics, getSubscriptionPurchase, getTrainStatus, getUser, getVitalsAnomalies, getVitalsAnr, getVitalsBattery, getVitalsCrashes, getVitalsErrorCount, getVitalsLmk, getVitalsMemory, getVitalsMemoryBitmap, getVitalsMemoryRss, getVitalsOverview, getVitalsRendering, getVitalsStartup, gradeFromPercent, gunzipIfNeeded, handleBreach, importDataSafety, importTestersFromCsv, initAudit, initProject, inviteUser, isFinancialReportType, isGzip, isStatsReportType, isValidBcp47, isValidReportType, isValidStatsDimension, isVersionedNotesDir, isZip, latestWorstValue, lintListing, lintListings, lintLocalListings, listAchievementConfigs, listAchievements, listAuditEvents, listBundles, listDeviceTiers, listGeneratedApks, listGrants, listImages, listInAppProducts, listLeaderboardConfigs, listLeaderboards, listOffers, listOneTimeOffers, listOneTimeProducts, listRecoveryActions, listReportObjects, listReports, listReviews, listSubscriptions, listTesters, listTracks, listUsers, listVoidedPurchases, loadPreflightConfig, loadStatusCache, maybePaginate, migratePrices, monthToken, moreResultsFooter, normalizeFingerprint, parseAppfile, parseCommit, parseFastfile, parseGrantArg, parseKeytoolOutput, parseMonth, parseRemoteUrl, pauseTrain, promoteRelease, publish, publishEnterpriseApp, pullAchievementConfigs, pullLeaderboardConfigs, pullListings, pushAchievementConfigs, pushLeaderboardConfigs, pushListings, readListingsFromDir, readMetricValue, readReleaseNotesForVersion, readReleaseNotesFromDir, readinessBadgeColor, readinessBadgeMarkdown, readinessBadgeUrl, redactAuditArgs, redactSensitive, refundExternalTransaction, refundOrder, relativeTime, removeTesters, removeUser, renderChecklistMarkdown, renderJson, renderMarkdown, renderPlayStore, renderPlayStoreJson, renderPlayStoreMd, renderPlayStorePrompt, renderPrompt, replyToReview, reportAccessDeniedError, reportBucketNotFoundError, reportObjectNotFoundError, reportPrefix, resolveAiConfig, resolveLocales, resolveReportsBucket, retryOnUploadNotComplete, reviewOrderRefund, revokeSubscriptionPurchase, runPreflight, runWatch, runWatchLoop, safePath, safePathWithin, saveStatusCache, scaffoldPlugin, scoreReadiness, searchAuditEvents, searchVitalsErrors, sendNotification, sendWebhook, setAchievementIcon, setLeaderboardIcon, sha256File, sortResults, sortReviews, startTrain, statusHasBreach, syncImages, syncInAppProducts, topFiles, trackBreachState, translateBundle, updateAchievementConfig, updateAppDetails, updateDataSafety, updateGrant, updateInAppProduct, updateLeaderboardConfig, updateListing, updateOffer, updateOneTimeOffer, updateOneTimeProduct, updateRollout, updateSubscription, updateTrackConfig, updateUser, uploadExternallyHosted, uploadImage, uploadInternalSharing, uploadRelease, validateAndCommit, validateBundleForApply, validateImage, validateLanguageCode, validatePackageName, validatePluginForApproval, validatePreSubmission, validateReleaseNotes, validateSku, validateTrackName, validateUploadFile, validateVersionCode, waitForBundle, waitForBundleProcessing, watchVitalsWithAutoHalt, wordDiff, worstSliceAverage, writeAuditLog, writeListingsToDir, writeMigrationOutput };

package/dist/index.js

@@ -2686,6 +2686,100 @@ var METRIC_SET_METRICS = {
   ],
   errorCountMetricSet: ["errorReportCount", "distinctUsers"]
 };
+var REQUIRED_DIMENSIONS = {
+  slowStartRateMetricSet: ["startType"],
+  errorCountMetricSet: ["reportType"]
+};
+function withRequiredDimensions(metricSet, query) {
+  const required = REQUIRED_DIMENSIONS[metricSet];
+  if (!required) return query;
+  const dimensions = [...required];
+  for (const dim2 of query.dimensions ?? []) {
+    if (!dimensions.includes(dim2)) dimensions.push(dim2);
+  }
+  return { ...query, dimensions };
+}
+function readMetricValue(row, metric) {
+  const metrics = row?.metrics;
+  if (!metrics || typeof metrics !== "object") return void 0;
+  let entry;
+  if (Array.isArray(metrics)) {
+    entry = metric ? metrics.find((m) => m?.metric === metric) : metrics[0];
+  } else {
+    const map = metrics;
+    const key = metric ?? Object.keys(map)[0];
+    entry = key ? map[key] : void 0;
+  }
+  const raw = entry?.decimalValue?.value;
+  if (raw === void 0) return void 0;
+  const value = Number(raw);
+  return Number.isFinite(value) ? value : void 0;
+}
+function rowDateKey(row) {
+  const t = row.startTime;
+  if (!t) return "";
+  const pad = (n) => String(n ?? 0).padStart(2, "0");
+  return `${t.year ?? 0}-${pad(t.month)}-${pad(t.day)}T${pad(t.hours)}`;
+}
+function rowSliceKey(row) {
+  const dims = row.dimensions;
+  if (!dims || typeof dims !== "object") return "";
+  const pairs = Array.isArray(dims) ? dims.map((d) => [d?.dimension ?? "", d?.stringValue ?? d?.int64Value ?? ""]) : Object.entries(dims).map(([k, d]) => [
+    k,
+    d?.stringValue ?? d?.int64Value ?? ""
+  ]);
+  return JSON.stringify(pairs.sort());
+}
+function latestWorstValue(rows, metric) {
+  if (!rows || rows.length === 0) return void 0;
+  const latest = rows.map(rowDateKey).reduce((a, b) => b > a ? b : a);
+  let worst;
+  for (const row of rows) {
+    if (rowDateKey(row) !== latest) continue;
+    const value = readMetricValue(row, metric);
+    if (value !== void 0 && (worst === void 0 || value > worst)) worst = value;
+  }
+  return worst;
+}
+function worstSliceAverage(rows, metric) {
+  const sums = /* @__PURE__ */ new Map();
+  for (const row of rows ?? []) {
+    const value = readMetricValue(row, metric);
+    if (value === void 0) continue;
+    const key = rowSliceKey(row);
+    const entry = sums.get(key) ?? { total: 0, count: 0 };
+    entry.total += value;
+    entry.count++;
+    sums.set(key, entry);
+  }
+  let worst;
+  for (const { total, count } of sums.values()) {
+    const avg = total / count;
+    if (worst === void 0 || avg > worst) worst = avg;
+  }
+  return worst;
+}
+function assertRateThreshold(label, threshold) {
+  if (!Number.isFinite(threshold) || threshold < 0) {
+    throw new GpcError(
+      `Invalid ${label} threshold: expected a fraction such as 0.02.`,
+      "THRESHOLD_INVALID",
+      2,
+      "Write rates as fractions: 0.02 means 2%."
+    );
+  }
+  if (threshold >= 1) {
+    throw new GpcError(
+      `${label} threshold ${threshold} can never be reached: rates are between 0 and 1.`,
+      "THRESHOLD_INVALID",
+      2,
+      `Write rates as fractions: ${threshold / 100} means ${threshold}%. Check vitals.thresholds in your config too.`
+    );
+  }
+}
+function isGamesOnlyMetricError(err) {
+  return err?.code === "API_METRIC_GAMES_ONLY";
+}
 async function getFreshnessEndDate(reporting, packageName, metricSet, aggregation = "DAILY") {
   try {
     const info = await reporting.getMetricSetFreshness(packageName, metricSet);
@@ -2699,12 +2793,16 @@ async function getFreshnessEndDate(reporting, packageName, metricSet, aggregatio
   }
   return void 0;
 }
+async function latestQueryableEndDate(reporting, packageName, metricSet) {
+  const fallback = new Date(Date.now() - 2 * 24 * 60 * 60 * 1e3);
+  const freshnessEnd = await getFreshnessEndDate(reporting, packageName, metricSet);
+  return freshnessEnd ?? fallback;
+}
 function buildQuery(metricSet, options, freshnessEnd) {
   const metrics = METRIC_SET_METRICS[metricSet] ?? ["errorReportCount", "distinctUsers"];
   const days = options?.days ?? 30;
   const DAY_MS = 24 * 60 * 60 * 1e3;
-  const yesterday = new Date(Date.now() - DAY_MS);
-  const end = freshnessEnd && freshnessEnd < yesterday ? freshnessEnd : yesterday;
+  const end = freshnessEnd ?? new Date(Date.now() - 2 * DAY_MS);
   const start = new Date(end.getTime() - days * DAY_MS);
   const query = {
     metrics,
@@ -2725,7 +2823,7 @@ function buildQuery(metricSet, options, freshnessEnd) {
   if (options?.dimension) {
     query.dimensions = [options.dimension];
   }
-  return query;
+  return withRequiredDimensions(metricSet, query);
 }
 async function queryMetric(reporting, packageName, metricSet, options) {
   const freshnessEnd = await getFreshnessEndDate(
@@ -2761,16 +2859,29 @@ async function getVitalsOverview(reporting, packageName) {
     })
   );
   const overview = {};
+  const unavailable = [];
+  let firstFailure;
+  let succeeded = 0;
   for (let i = 0; i < metricSets.length; i++) {
     const entry = metricSets[i];
-    if (!entry) continue;
-    const key = entry[1];
     const result = results[i];
-    if (!result) continue;
+    if (!entry || !result) continue;
+    const key = entry[1];
     if (result.status === "fulfilled") {
       overview[key] = result.value.rows || [];
+      succeeded++;
+      continue;
     }
+    const err = result.reason;
+    if (!isGamesOnlyMetricError(err)) firstFailure ??= result.reason;
+    unavailable.push({
+      metric: key,
+      code: typeof err?.code === "string" ? err.code : "UNKNOWN_ERROR",
+      reason: isGamesOnlyMetricError(err) ? "Only available for apps categorised as games." : typeof err?.message === "string" ? err.message : String(result.reason)
+    });
   }
+  if (succeeded === 0 && firstFailure !== void 0) throw firstFailure;
+  if (unavailable.length > 0) overview.unavailable = unavailable;
   return overview;
 }
 async function getVitalsCrashes(reporting, packageName, options) {
@@ -2780,8 +2891,7 @@ async function getVitalsAnr(reporting, packageName, options) {
   return queryMetric(reporting, packageName, "anrRateMetricSet", options);
 }
 async function getVitalsStartup(reporting, packageName, options) {
-  const opts = options?.dimension ? options : { ...options, dimension: "startType" };
-  return queryMetric(reporting, packageName, "slowStartRateMetricSet", opts);
+  return queryMetric(reporting, packageName, "slowStartRateMetricSet", options);
 }
 async function getVitalsRendering(reporting, packageName, options) {
   return queryMetric(reporting, packageName, "slowRenderingRateMetricSet", options);
@@ -2811,8 +2921,7 @@ async function getVitalsMemoryBitmap(reporting, packageName, options) {
   });
 }
 async function getVitalsErrorCount(reporting, packageName, options) {
-  const opts = options?.dimension ? options : { ...options, dimension: "reportType" };
-  return queryMetric(reporting, packageName, "errorCountMetricSet", opts);
+  return queryMetric(reporting, packageName, "errorCountMetricSet", options);
 }
 async function getVitalsAnomalies(reporting, packageName) {
   return reporting.getAnomalies(packageName);
@@ -2836,7 +2945,7 @@ async function compareVitalsTrend(reporting, packageName, metricSet, days = 7) {
     month: d.getUTCMonth() + 1,
     day: d.getUTCDate()
   });
-  const makeQuery = (start, end) => ({
+  const makeQuery = (start, end) => withRequiredDimensions(metricSet, {
     metrics,
     timelineSpec: {
       aggregationPeriod: "DAILY",
@@ -2940,7 +3049,8 @@ function watchVitalsWithAutoHalt(reporting, packageName, options) {
     threshold,
     metricSet = "crashRateMetricSet",
     onHalt,
-    onPoll
+    onPoll,
+    onError
   } = options;
   let stopped = false;
   let haltTriggered = false;
@@ -2948,16 +3058,15 @@ function watchVitalsWithAutoHalt(reporting, packageName, options) {
     if (stopped) return;
     try {
       const result = await queryMetric(reporting, packageName, metricSet, { days: 1 });
-      const latestRow = result.rows?.[result.rows.length - 1];
-      const firstMetric = latestRow?.metrics ? Object.keys(latestRow.metrics)[0] : void 0;
-      const value = firstMetric ? Number(latestRow?.metrics[firstMetric]?.decimalValue?.value) : void 0;
+      const value = latestWorstValue(result.rows, METRIC_SET_METRICS[metricSet]?.[0]);
       const breached = value !== void 0 && value > threshold;
       onPoll?.(value, breached);
       if (breached && !haltTriggered && onHalt) {
         haltTriggered = true;
         await onHalt(value);
       }
-    } catch {
+    } catch (err) {
+      onError?.(err);
     }
     if (!stopped) {
       timerId = setTimeout(poll, intervalMs);
@@ -3023,33 +3132,28 @@ var WARN_MARGIN = 0.2;
 function toApiDate(d) {
   return { year: d.getUTCFullYear(), month: d.getUTCMonth() + 1, day: d.getUTCDate() };
 }
-async function queryVitalForStatus(reporting, packageName, metricSet, days, offsetDays = 0) {
+async function queryVitalForStatus(reporting, packageName, metricSet, days, latestEnd, offsetDays = 0) {
   const DAY_MS = 24 * 60 * 60 * 1e3;
-  const baseMs = Date.now() - 2 * DAY_MS - offsetDays * DAY_MS;
+  const baseMs = latestEnd.getTime() - offsetDays * DAY_MS;
   const end = new Date(baseMs);
   const start = new Date(baseMs - days * DAY_MS);
   const metrics = METRIC_SET_METRICS2[metricSet] ?? ["distinctUsers"];
-  const query = {
+  const query = withRequiredDimensions(metricSet, {
     metrics,
     timelineSpec: {
       aggregationPeriod: "DAILY",
       startTime: toApiDate(start),
       endTime: toApiDate(end)
     }
-  };
+  });
   const result = await reporting.queryMetricSet(packageName, metricSet, query);
-  if (!result.rows || result.rows.length === 0) return void 0;
-  const values = result.rows.map((row) => {
-    const firstKey = Object.keys(row.metrics)[0];
-    return firstKey ? Number(row.metrics[firstKey]?.decimalValue?.value) : NaN;
-  }).filter((v) => !isNaN(v));
-  if (values.length === 0) return void 0;
-  return values.reduce((a, b) => a + b, 0) / values.length;
+  return worstSliceAverage(result.rows, metrics[0]);
 }
 async function queryVitalWithTrend(reporting, packageName, metricSet, days) {
+  const latestEnd = await latestQueryableEndDate(reporting, packageName, metricSet);
   const [current, previous] = await Promise.all([
-    queryVitalForStatus(reporting, packageName, metricSet, days, 0),
-    queryVitalForStatus(reporting, packageName, metricSet, days, days)
+    queryVitalForStatus(reporting, packageName, metricSet, days, latestEnd, 0),
+    queryVitalForStatus(reporting, packageName, metricSet, days, latestEnd, days)
   ]);
   let trend = null;
   if (current !== void 0 && previous !== void 0) {
@@ -3147,7 +3251,7 @@ async function getAppStatus(client, reporting, packageName, options = {}) {
   if (slowStartResult.status === "rejected")
     sectionErrors.push(`vitals/slowStarts: ${String(slowStartResult.reason)}`);
   const slowRender = slowRenderResult.status === "fulfilled" ? slowRenderResult.value : SKIPPED_VITAL;
-  if (slowRenderResult.status === "rejected")
+  if (slowRenderResult.status === "rejected" && !isGamesOnlyMetricError(slowRenderResult.reason))
     sectionErrors.push(`vitals/slowRender: ${String(slowRenderResult.reason)}`);
   const rawReviews = reviewsResult.status === "fulfilled" ? reviewsResult.value.reviews : [];
   if (reviewsResult.status === "rejected")
@@ -3528,31 +3632,34 @@ async function queryWatchMetric(reporting, packageName, metric) {
   const metricSet = METRIC_TO_SET[metric];
   const metricKey = METRIC_KEY[metric];
   const DAY_MS = 24 * 60 * 60 * 1e3;
-  const end = new Date(Date.now() - 2 * DAY_MS);
-  const start = new Date(end.getTime() - 7 * DAY_MS);
   const toDate = (d) => ({
     year: d.getUTCFullYear(),
     month: d.getUTCMonth() + 1,
     day: d.getUTCDate()
   });
   try {
-    const result = await reporting.queryMetricSet(packageName, metricSet, {
-      metrics: [metricKey, "distinctUsers"],
-      timelineSpec: {
-        aggregationPeriod: "DAILY",
-        startTime: toDate(start),
-        endTime: toDate(end)
-      }
-    });
-    if (!result.rows || result.rows.length === 0) return void 0;
-    const values = result.rows.map((row) => {
-      const val = row.metrics[metricKey]?.decimalValue?.value;
-      return val !== void 0 ? Number(val) : NaN;
-    }).filter((v) => !isNaN(v));
-    if (values.length === 0) return void 0;
-    return values.reduce((a, b) => a + b, 0) / values.length;
-  } catch {
-    return void 0;
+    const end = await latestQueryableEndDate(reporting, packageName, metricSet);
+    const start = new Date(end.getTime() - 7 * DAY_MS);
+    const result = await reporting.queryMetricSet(
+      packageName,
+      metricSet,
+      withRequiredDimensions(metricSet, {
+        metrics: [metricKey, "distinctUsers"],
+        timelineSpec: {
+          aggregationPeriod: "DAILY",
+          startTime: toDate(start),
+          endTime: toDate(end)
+        }
+      })
+    );
+    return { value: latestWorstValue(result.rows, metricKey) };
+  } catch (err) {
+    const code = err?.code;
+    return {
+      value: void 0,
+      error: typeof code === "string" ? code : err instanceof Error ? err.message : String(err),
+      gamesOnly: isGamesOnlyMetricError(err)
+    };
   }
 }
 async function fetchRollout(client, packageName, track) {
@@ -3631,12 +3738,17 @@ async function runWatch(client, reporting, config, callbacks) {
       "Watch interval must be at least 60 seconds",
       "WATCH_USAGE_ERROR",
       2,
-      "Use --interval 60 or higher. Google vitals data is delayed 24-48h, so frequent polling wastes API quota."
+      "Use --interval 60 or higher. Google vitals data is delayed 2-4 days, so frequent polling wastes API quota."
     );
   }
+  for (const [metric, threshold] of Object.entries(config.thresholds)) {
+    if (metric !== "errorCount" && threshold !== void 0) assertRateThreshold(metric, threshold);
+  }
   let running = true;
   const events = [];
   let breachCount = 0;
+  let unreadableRounds = 0;
+  let lastRoundUnreadable = false;
   let halted = false;
   const startTime = Date.now();
   const cleanup = () => {
@@ -3652,19 +3764,24 @@ async function runWatch(client, reporting, config, callbacks) {
       const vitals = {};
       const metricResults = await Promise.all(
         config.metrics.map(async (metric) => {
-          const value = await queryWatchMetric(reporting, config.packageName, metric);
-          return { metric, value };
+          const reading = await queryWatchMetric(reporting, config.packageName, metric);
+          return { metric, ...reading };
         })
       );
-      for (const { metric, value } of metricResults) {
+      let unreadable = false;
+      for (const { metric, value, error, gamesOnly } of metricResults) {
         const threshold = config.thresholds[metric];
+        if (error && threshold !== void 0 && !gamesOnly) unreadable = true;
         const result = threshold !== void 0 ? checkThreshold(value, threshold) : { breached: false };
         vitals[metric] = {
           value,
           threshold,
-          breached: result.breached
+          breached: result.breached,
+          ...error ? { error } : {}
         };
       }
+      if (unreadable) unreadableRounds++;
+      lastRoundUnreadable = unreadable;
       const breaches = Object.entries(vitals).filter(([, v]) => v.breached).map(([k]) => k);
       const event = {
         round,
@@ -3716,6 +3833,8 @@ async function runWatch(client, reporting, config, callbacks) {
     durationMs: Date.now() - startTime,
     finalRollout: events[events.length - 1]?.rollout?.userFraction ?? null,
     breachCount,
+    unreadableRounds,
+    lastRoundUnreadable,
     halted,
     events
   };
@@ -5411,10 +5530,9 @@ async function advanceTrain(apiClient, reportingClient, packageName) {
   if (state.gates) {
     if (state.gates.crashes?.max !== void 0) {
       const result = await getVitalsCrashes(reportingClient, packageName, { days: 1 });
-      const latestRow = result.rows?.[result.rows.length - 1];
-      const firstMetric = latestRow?.metrics ? Object.keys(latestRow.metrics)[0] : void 0;
-      const value = firstMetric ? Number(latestRow?.metrics[firstMetric]?.decimalValue?.value) : void 0;
-      if (value !== void 0 && value > state.gates.crashes.max / 100) {
+      const value = latestWorstValue(result.rows, "crashRate");
+      if (value === void 0) throw trainGateNoData("Crash", "crashes");
+      if (value > state.gates.crashes.max / 100) {
         state.status = "paused";
         state.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
         await writeTrainState(packageName, state);
@@ -5428,10 +5546,9 @@ async function advanceTrain(apiClient, reportingClient, packageName) {
     }
     if (state.gates.anr?.max !== void 0) {
       const result = await getVitalsAnr(reportingClient, packageName, { days: 1 });
-      const latestRow = result.rows?.[result.rows.length - 1];
-      const firstMetric = latestRow?.metrics ? Object.keys(latestRow.metrics)[0] : void 0;
-      const value = firstMetric ? Number(latestRow?.metrics[firstMetric]?.decimalValue?.value) : void 0;
-      if (value !== void 0 && value > state.gates.anr.max / 100) {
+      const value = latestWorstValue(result.rows, "anrRate");
+      if (value === void 0) throw trainGateNoData("ANR", "anr");
+      if (value > state.gates.anr.max / 100) {
         state.status = "paused";
         state.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
         await writeTrainState(packageName, state);
@@ -5463,6 +5580,14 @@ async function executeStage(apiClient, packageName, state, stageIndex) {
   state.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
   await writeTrainState(packageName, state);
 }
+function trainGateNoData(label, command) {
+  return new GpcError(
+    `${label} gate has no data to check, so the train was not advanced.`,
+    "TRAIN_GATE_NO_DATA",
+    6,
+    `Vitals data often lags 2-4 days. Run the train again later, or check with: gpc vitals ${command} --days 3`
+  );
+}
 
 // src/commands/games.ts
 import { mkdir as mkdir5, readdir as readdir4, readFile as readFile9, writeFile as writeFile5 } from "fs/promises";
@@ -10404,6 +10529,7 @@ export {
   analyzeReviews2 as analyzeReviews,
   annotateListResult,
   applyReleaseNotes,
+  assertRateThreshold,
   assignRelease,
   batchGetOrders,
   batchSyncInAppProducts,
@@ -10558,6 +10684,7 @@ export {
   isValidStatsDimension,
   isVersionedNotesDir,
   isZip,
+  latestWorstValue,
   lintListing,
   lintListings,
   lintLocalListings,
@@ -10609,6 +10736,7 @@ export {
   pushLeaderboardConfigs,
   pushListings,
   readListingsFromDir,
+  readMetricValue,
   readReleaseNotesForVersion,
   readReleaseNotesFromDir,
   readinessBadgeColor,
@@ -10698,6 +10826,7 @@ export {
   waitForBundleProcessing,
   watchVitalsWithAutoHalt,
   wordDiff,
+  worstSliceAverage,
   writeAuditLog,
   writeListingsToDir,
   writeMigrationOutput