@gpc-cli/core 0.9.68 → 0.9.70

package/dist/index.d.ts

@@ -30,6 +30,26 @@ declare class NetworkError extends GpcError {
 
 declare function detectOutputFormat(): OutputFormat;
 declare function formatOutput(data: unknown, format: OutputFormat, redact?: boolean): string;
+/**
+ * Annotate a list command's --json envelope with a consistent shape: a
+ * `meta.count`, a `nextPageToken` (null when absent so the field is always
+ * present), and a `message` when the result set is empty. The descriptive items
+ * key (e.g. `users`, `reviews`) is preserved as-is.
+ */
+declare function annotateListResult(result: object, itemsKey: string, emptyMessage: string): Record<string, unknown>;
+/**
+ * Footer line shown after a human-readable list table when more results are
+ * available. Returns undefined when there is no continuation token.
+ */
+declare function moreResultsFooter(nextPageToken?: string | null): string | undefined;
+/**
+ * Format a Google Money amount (`units` + `nanos`) honoring the currency's ISO
+ * 4217 minor-unit count (JPY has 0 decimals, KWD/BHD/OMR have 3, most have 2)
+ * rather than assuming 2. The currency code is used only to pick the precision;
+ * it is not appended -- callers place the code where they need it. `nanos` are
+ * billionths of a unit; the leading digits are truncated to match prior output.
+ */
+declare function formatMoney(units: string | number | undefined, nanos: number | undefined, currencyCode?: string): string;
 declare const SENSITIVE_KEYS: Set<string>;
 /** Recursively redact sensitive fields from data before output. */
 declare function redactSensitive(data: unknown): unknown;
@@ -485,7 +505,10 @@ interface ReviewsFilterOptions {
 interface ReviewExportOptions extends ReviewsFilterOptions {
     format?: "json" | "csv";
 }
-declare function listReviews(client: PlayApiClient, packageName: string, options?: ReviewsFilterOptions): Promise<Review[]>;
+declare function listReviews(client: PlayApiClient, packageName: string, options?: ReviewsFilterOptions): Promise<{
+    reviews: Review[];
+    nextPageToken?: string;
+}>;
 declare function getReview(client: PlayApiClient, packageName: string, reviewId: string, translationLanguage?: string): Promise<Review>;
 declare function replyToReview(client: PlayApiClient, packageName: string, reviewId: string, replyText: string): Promise<ReviewReplyResponse>;
 declare function exportReviews(client: PlayApiClient, packageName: string, options?: ReviewExportOptions): Promise<string>;
@@ -504,8 +527,8 @@ declare function listSubscriptions(client: PlayApiClient, packageName: string, o
     nextPageToken?: string;
 }>;
 declare function getSubscription(client: PlayApiClient, packageName: string, productId: string): Promise<Subscription>;
-declare function createSubscription(client: PlayApiClient, packageName: string, data: Subscription): Promise<Subscription>;
-declare function updateSubscription(client: PlayApiClient, packageName: string, productId: string, data: Subscription, updateMask?: string): Promise<Subscription>;
+declare function createSubscription(client: PlayApiClient, packageName: string, data: Subscription, regionsVersion?: string): Promise<Subscription>;
+declare function updateSubscription(client: PlayApiClient, packageName: string, productId: string, data: Subscription, updateMask?: string, regionsVersion?: string): Promise<Subscription>;
 declare function deleteSubscription(client: PlayApiClient, packageName: string, productId: string): Promise<void>;
 declare function activateBasePlan(client: PlayApiClient, packageName: string, productId: string, basePlanId: string): Promise<Subscription>;
 declare function deactivateBasePlan(client: PlayApiClient, packageName: string, productId: string, basePlanId: string): Promise<Subscription>;
@@ -513,8 +536,8 @@ declare function deleteBasePlan(client: PlayApiClient, packageName: string, prod
 declare function migratePrices(client: PlayApiClient, packageName: string, productId: string, basePlanId: string, data: BasePlanMigratePricesRequest): Promise<void>;
 declare function listOffers(client: PlayApiClient, packageName: string, productId: string, basePlanId: string): Promise<OffersListResponse>;
 declare function getOffer(client: PlayApiClient, packageName: string, productId: string, basePlanId: string, offerId: string): Promise<SubscriptionOffer>;
-declare function createOffer(client: PlayApiClient, packageName: string, productId: string, basePlanId: string, data: SubscriptionOffer): Promise<SubscriptionOffer>;
-declare function updateOffer(client: PlayApiClient, packageName: string, productId: string, basePlanId: string, offerId: string, data: SubscriptionOffer, updateMask?: string): Promise<SubscriptionOffer>;
+declare function createOffer(client: PlayApiClient, packageName: string, productId: string, basePlanId: string, data: SubscriptionOffer, regionsVersion?: string): Promise<SubscriptionOffer>;
+declare function updateOffer(client: PlayApiClient, packageName: string, productId: string, basePlanId: string, offerId: string, data: SubscriptionOffer, updateMask?: string, regionsVersion?: string): Promise<SubscriptionOffer>;
 declare function deleteOffer(client: PlayApiClient, packageName: string, productId: string, basePlanId: string, offerId: string): Promise<void>;
 declare function activateOffer(client: PlayApiClient, packageName: string, productId: string, basePlanId: string, offerId: string): Promise<SubscriptionOffer>;
 interface SubscriptionDiff {
@@ -814,13 +837,13 @@ declare function createDeviceTier(client: PlayApiClient, packageName: string, co
 
 declare function listOneTimeProducts(client: PlayApiClient, packageName: string): Promise<OneTimeProductsListResponse>;
 declare function getOneTimeProduct(client: PlayApiClient, packageName: string, productId: string): Promise<OneTimeProduct>;
-declare function createOneTimeProduct(client: PlayApiClient, packageName: string, data: OneTimeProduct): Promise<OneTimeProduct>;
-declare function updateOneTimeProduct(client: PlayApiClient, packageName: string, productId: string, data: Partial<OneTimeProduct>, updateMask?: string): Promise<OneTimeProduct>;
+declare function createOneTimeProduct(client: PlayApiClient, packageName: string, data: OneTimeProduct, regionsVersion?: string): Promise<OneTimeProduct>;
+declare function updateOneTimeProduct(client: PlayApiClient, packageName: string, productId: string, data: Partial<OneTimeProduct>, updateMask?: string, regionsVersion?: string): Promise<OneTimeProduct>;
 declare function deleteOneTimeProduct(client: PlayApiClient, packageName: string, productId: string): Promise<void>;
 declare function listOneTimeOffers(client: PlayApiClient, packageName: string, productId: string, purchaseOptionId?: string): Promise<OneTimeOffersListResponse>;
 declare function getOneTimeOffer(client: PlayApiClient, packageName: string, productId: string, offerId: string, purchaseOptionId?: string): Promise<OneTimeOffer>;
-declare function createOneTimeOffer(client: PlayApiClient, packageName: string, productId: string, data: OneTimeOffer, purchaseOptionId?: string): Promise<OneTimeOffer>;
-declare function updateOneTimeOffer(client: PlayApiClient, packageName: string, productId: string, offerId: string, data: Partial<OneTimeOffer>, updateMask?: string, purchaseOptionId?: string): Promise<OneTimeOffer>;
+declare function createOneTimeOffer(client: PlayApiClient, packageName: string, productId: string, data: OneTimeOffer, purchaseOptionId?: string, regionsVersion?: string): Promise<OneTimeOffer>;
+declare function updateOneTimeOffer(client: PlayApiClient, packageName: string, productId: string, offerId: string, data: Partial<OneTimeOffer>, updateMask?: string, purchaseOptionId?: string, regionsVersion?: string): Promise<OneTimeOffer>;
 interface OneTimeProductDiff {
     field: string;
     local: string;
@@ -1651,4 +1674,4 @@ interface ChecklistInput {
 declare function buildChecklist(input: ChecklistInput): ChecklistResult;
 declare function renderChecklistMarkdown(result: ChecklistResult, accountEmail: string): 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 DryRunPublishResult, type DryRunResult, type DryRunUploadResult, type ErrorReason, type ExportImagesOptions, type ExportImagesSummary, type FastlaneDetection, type FastlaneLane, type FetchChangelogOptions, type FieldLintResult, type FileValidationResult, type FindingSeverity, GOOGLE_PLAY_LANGUAGES, 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 ListIapOptions, 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, type RawCommit, type ReleaseDiff, type ReleaseNotesValidation, type ReleaseStatusResult, type Renderer, type ResolveAiConfigOptions, type ResolveLocalesOptions, type ReviewAnalysis, type ReviewExportOptions, 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 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 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, abortTrain, acknowledgeProductPurchase, activateBasePlan, activateOffer, addRecoveryTargeting, addTesters, advanceTrain, analyzeBundle, analyzeRemoteListings, analyzeReviews, applyReleaseNotes, assignRelease, batchGetOrders, batchSyncInAppProducts, buildChecklist, buildLocaleBundle, bundleToReleaseNotes, cancelRecoveryAction, cancelSubscriptionPurchase, cancelSubscriptionV2, checkBundleSize, checkSigningConsistency, checkThreshold, classifyError, clearAuditLog, commitWithRescue, compareBundles, compareFingerprints, compareVersionVitals, compareVitalsTrend, computeStatusDiff, consumeProductPurchase, convertRegionPrices, createAuditEntry, createDeviceTier, createEnterpriseApp, createExternalTransaction, createGrant, createInAppProduct, createOffer, createOneTimeOffer, createOneTimeProduct, createRecoveryAction, createSpinner, createSubscription, createTrack, createTranslator, deactivateBasePlan, deactivateOffer, decodeNotification, defaultGitRunner, deferSubscriptionPurchase, deferSubscriptionV2, deleteBasePlan, deleteGrant, deleteImage, deleteInAppProduct, deleteListing, deleteOffer, deleteOneTimeOffer, deleteOneTimeProduct, deleteSubscription, deployRecoveryAction, detectFastlane, detectOutputFormat, diffListings, diffListingsCommand, diffListingsEnhanced, diffOneTimeProduct, diffReleases, diffSubscription, discoverPlugins, dispatchWebhook, downloadGeneratedApk, downloadReport, exportImages, exportReviews, fetchAggregateCost, fetchChangelog, fetchReleaseNotes, findBundle, formatChangelogEntry, formatCustomPayload, formatDiscordPayload, formatJunit, formatNotification, formatOutput, formatPathLabel, formatSlackPayload, formatStatusDiff, formatStatusSummary, formatStatusTable, formatWordDiff, generateChangelog, generateMigrationPlan, generateNotesFromGit, getAllScannerNames, getApiSigningFingerprint, getAppInfo, getAppStatus, getCountryAvailability, getDeviceTier, getExternalTransaction, getInAppProduct, getKeystoreFingerprint, getListings, getOffer, getOneTimeOffer, getOneTimeProduct, getOrderDetails, getProductPurchase, getProductPurchaseV2, getQuotaUsage, getReleasesStatus, getReview, getRtdnStatus, getSubscription, getSubscriptionAnalytics, getSubscriptionPurchase, getTrainStatus, getUser, getVitalsAnomalies, getVitalsAnr, getVitalsBattery, getVitalsCrashes, getVitalsErrorCount, getVitalsLmk, getVitalsMemory, getVitalsOverview, getVitalsRendering, getVitalsStartup, handleBreach, importDataSafety, importTestersFromCsv, initAudit, initProject, inviteUser, isFinancialReportType, isStatsReportType, isValidBcp47, isValidReportType, isValidStatsDimension, isVersionedNotesDir, lintListing, lintListings, lintLocalListings, listAchievements, listAuditEvents, listBundles, listDeviceTiers, listEvents, listGeneratedApks, listGrants, listImages, listInAppProducts, listLeaderboards, listOffers, listOneTimeOffers, listOneTimeProducts, listRecoveryActions, listReports, listReviews, listSubscriptions, listTesters, listTracks, listUsers, listVoidedPurchases, loadPreflightConfig, loadStatusCache, maybePaginate, migratePrices, normalizeFingerprint, parseAppfile, parseCommit, parseFastfile, parseGrantArg, parseKeytoolOutput, parseMonth, parseRemoteUrl, pauseTrain, promoteRelease, publish, publishEnterpriseApp, pullListings, pushListings, readListingsFromDir, readReleaseNotesForVersion, readReleaseNotesFromDir, redactAuditArgs, redactSensitive, refundExternalTransaction, refundOrder, relativeTime, removeTesters, removeUser, renderChecklistMarkdown, renderJson, renderMarkdown, renderPlayStore, renderPlayStoreJson, renderPlayStoreMd, renderPlayStorePrompt, renderPrompt, replyToReview, resolveAiConfig, resolveLocales, retryOnUploadNotComplete, revokeSubscriptionPurchase, runPreflight, runWatch, runWatchLoop, safePath, safePathWithin, saveStatusCache, scaffoldPlugin, searchAuditEvents, searchVitalsErrors, sendNotification, sendWebhook, sha256File, sortResults, startTrain, statusHasBreach, syncImages, syncInAppProducts, topFiles, trackBreachState, translateBundle, updateAppDetails, updateDataSafety, updateGrant, updateInAppProduct, updateListing, updateOffer, updateOneTimeOffer, updateOneTimeProduct, updateRollout, updateSubscription, updateTrackConfig, updateUser, uploadExternallyHosted, uploadImage, uploadInternalSharing, uploadRelease, validateAndCommit, validateBundleForApply, validateImage, validateLanguageCode, validatePackageName, 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 DryRunPublishResult, type DryRunResult, type DryRunUploadResult, type ErrorReason, type ExportImagesOptions, type ExportImagesSummary, type FastlaneDetection, type FastlaneLane, type FetchChangelogOptions, type FieldLintResult, type FileValidationResult, type FindingSeverity, GOOGLE_PLAY_LANGUAGES, 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 ListIapOptions, 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, type RawCommit, type ReleaseDiff, type ReleaseNotesValidation, type ReleaseStatusResult, type Renderer, type ResolveAiConfigOptions, type ResolveLocalesOptions, type ReviewAnalysis, type ReviewExportOptions, 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 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 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, abortTrain, acknowledgeProductPurchase, activateBasePlan, activateOffer, addRecoveryTargeting, addTesters, advanceTrain, analyzeBundle, analyzeRemoteListings, analyzeReviews, annotateListResult, applyReleaseNotes, assignRelease, batchGetOrders, batchSyncInAppProducts, buildChecklist, buildLocaleBundle, bundleToReleaseNotes, cancelRecoveryAction, cancelSubscriptionPurchase, cancelSubscriptionV2, checkBundleSize, checkSigningConsistency, checkThreshold, classifyError, clearAuditLog, commitWithRescue, compareBundles, compareFingerprints, compareVersionVitals, compareVitalsTrend, computeStatusDiff, consumeProductPurchase, convertRegionPrices, createAuditEntry, createDeviceTier, createEnterpriseApp, createExternalTransaction, createGrant, createInAppProduct, createOffer, createOneTimeOffer, createOneTimeProduct, createRecoveryAction, createSpinner, createSubscription, createTrack, createTranslator, deactivateBasePlan, deactivateOffer, decodeNotification, defaultGitRunner, deferSubscriptionPurchase, deferSubscriptionV2, deleteBasePlan, deleteGrant, deleteImage, deleteInAppProduct, deleteListing, deleteOffer, deleteOneTimeOffer, deleteOneTimeProduct, deleteSubscription, deployRecoveryAction, detectFastlane, detectOutputFormat, diffListings, diffListingsCommand, diffListingsEnhanced, diffOneTimeProduct, diffReleases, diffSubscription, discoverPlugins, dispatchWebhook, downloadGeneratedApk, downloadReport, exportImages, exportReviews, fetchAggregateCost, fetchChangelog, fetchReleaseNotes, findBundle, formatChangelogEntry, formatCustomPayload, formatDiscordPayload, formatJunit, formatMoney, formatNotification, formatOutput, formatPathLabel, formatSlackPayload, formatStatusDiff, formatStatusSummary, formatStatusTable, formatWordDiff, generateChangelog, generateMigrationPlan, generateNotesFromGit, getAllScannerNames, getApiSigningFingerprint, getAppInfo, getAppStatus, getCountryAvailability, getDeviceTier, getExternalTransaction, getInAppProduct, getKeystoreFingerprint, getListings, getOffer, getOneTimeOffer, getOneTimeProduct, getOrderDetails, getProductPurchase, getProductPurchaseV2, getQuotaUsage, getReleasesStatus, getReview, getRtdnStatus, getSubscription, getSubscriptionAnalytics, getSubscriptionPurchase, getTrainStatus, getUser, getVitalsAnomalies, getVitalsAnr, getVitalsBattery, getVitalsCrashes, getVitalsErrorCount, getVitalsLmk, getVitalsMemory, getVitalsOverview, getVitalsRendering, getVitalsStartup, handleBreach, importDataSafety, importTestersFromCsv, initAudit, initProject, inviteUser, isFinancialReportType, isStatsReportType, isValidBcp47, isValidReportType, isValidStatsDimension, isVersionedNotesDir, lintListing, lintListings, lintLocalListings, listAchievements, listAuditEvents, listBundles, listDeviceTiers, listEvents, listGeneratedApks, listGrants, listImages, listInAppProducts, listLeaderboards, listOffers, listOneTimeOffers, listOneTimeProducts, listRecoveryActions, listReports, listReviews, listSubscriptions, listTesters, listTracks, listUsers, listVoidedPurchases, loadPreflightConfig, loadStatusCache, maybePaginate, migratePrices, moreResultsFooter, normalizeFingerprint, parseAppfile, parseCommit, parseFastfile, parseGrantArg, parseKeytoolOutput, parseMonth, parseRemoteUrl, pauseTrain, promoteRelease, publish, publishEnterpriseApp, pullListings, pushListings, readListingsFromDir, readReleaseNotesForVersion, readReleaseNotesFromDir, redactAuditArgs, redactSensitive, refundExternalTransaction, refundOrder, relativeTime, removeTesters, removeUser, renderChecklistMarkdown, renderJson, renderMarkdown, renderPlayStore, renderPlayStoreJson, renderPlayStoreMd, renderPlayStorePrompt, renderPrompt, replyToReview, resolveAiConfig, resolveLocales, retryOnUploadNotComplete, revokeSubscriptionPurchase, runPreflight, runWatch, runWatchLoop, safePath, safePathWithin, saveStatusCache, scaffoldPlugin, searchAuditEvents, searchVitalsErrors, sendNotification, sendWebhook, sha256File, sortResults, startTrain, statusHasBreach, syncImages, syncInAppProducts, topFiles, trackBreachState, translateBundle, updateAppDetails, updateDataSafety, updateGrant, updateInAppProduct, updateListing, updateOffer, updateOneTimeOffer, updateOneTimeProduct, updateRollout, updateSubscription, updateTrackConfig, updateUser, uploadExternallyHosted, uploadImage, uploadInternalSharing, uploadRelease, validateAndCommit, validateBundleForApply, validateImage, validateLanguageCode, validatePackageName, validatePreSubmission, validateReleaseNotes, validateSku, validateTrackName, validateUploadFile, validateVersionCode, waitForBundle, waitForBundleProcessing, watchVitalsWithAutoHalt, wordDiff, writeAuditLog, writeListingsToDir, writeMigrationOutput };

package/dist/index.js

@@ -71,6 +71,55 @@ function formatOutput(data, format, redact = true) {
       return formatJson(safe);
   }
 }
+function annotateListResult(result, itemsKey, emptyMessage) {
+  const source = result;
+  const items = Array.isArray(source[itemsKey]) ? source[itemsKey] : [];
+  const annotated = {
+    ...source,
+    nextPageToken: source["nextPageToken"] ?? null,
+    meta: { count: items.length }
+  };
+  if (items.length === 0) annotated["message"] = emptyMessage;
+  return annotated;
+}
+function moreResultsFooter(nextPageToken) {
+  if (!nextPageToken) return void 0;
+  return dim(`More results available. Re-run this command with --next-page ${nextPageToken}`);
+}
+var CURRENCY_DECIMALS = {
+  // Zero-decimal currencies
+  JPY: 0,
+  KRW: 0,
+  VND: 0,
+  CLP: 0,
+  ISK: 0,
+  XAF: 0,
+  XOF: 0,
+  XPF: 0,
+  BIF: 0,
+  DJF: 0,
+  GNF: 0,
+  KMF: 0,
+  RWF: 0,
+  UGX: 0,
+  VUV: 0,
+  PYG: 0,
+  // Three-decimal currencies
+  BHD: 3,
+  IQD: 3,
+  JOD: 3,
+  KWD: 3,
+  LYD: 3,
+  OMR: 3,
+  TND: 3
+};
+function formatMoney(units, nanos, currencyCode) {
+  const decimals = currencyCode ? CURRENCY_DECIMALS[currencyCode.toUpperCase()] ?? 2 : 2;
+  const whole = String(units ?? "0");
+  if (decimals === 0) return whole;
+  const frac = String(Math.abs(nanos ?? 0)).padStart(9, "0").slice(0, decimals);
+  return `${whole}.${frac}`;
+}
 var SENSITIVE_KEYS = /* @__PURE__ */ new Set([
   "private_key",
   "privateKey",
@@ -238,10 +287,11 @@ ${separator}
 ${body}`;
 }
 function escapeCsvField(val) {
-  if (val.includes(",") || val.includes('"') || val.includes("\n") || val.includes("\r")) {
-    return `"${val.replace(/"/g, '""')}"`;
+  let out = /^[=+\-@\t\r]/.test(val) ? `'${val}` : val;
+  if (out.includes(",") || out.includes('"') || out.includes("\n") || out.includes("\r")) {
+    out = `"${out.replace(/"/g, '""')}"`;
   }
-  return val;
+  return out;
 }
 function formatCsv(data) {
   const rows = toRows(data);
@@ -262,7 +312,10 @@ function formatTsv(data) {
   if (!firstRow) return "";
   const keys = Object.keys(firstRow);
   if (keys.length === 0) return "";
-  const escape = (val) => val.replace(/\t/g, "\\t").replace(/\r/g, "\\r").replace(/\n/g, "\\n");
+  const escape = (val) => {
+    const guarded = /^[=+\-@]/.test(val) ? `'${val}` : val;
+    return guarded.replace(/\t/g, "\\t").replace(/\r/g, "\\r").replace(/\n/g, "\\n");
+  };
   const header = keys.join("	");
   const body = rows.map((row) => keys.map((key) => escape(cellValue(row[key]))).join("	")).join("\n");
   return `${header}
@@ -1933,8 +1986,9 @@ function analyzeReviews(reviews) {
 // src/commands/reviews.ts
 async function listReviews(client, packageName, options) {
   let reviews;
+  let nextPageToken;
   if (options?.all) {
-    const { items } = await paginateAll(
+    const { items, nextPageToken: token } = await paginateAll(
       async (pageToken) => {
         const apiOptions = { token: pageToken };
         if (options?.translationLanguage)
@@ -1949,6 +2003,7 @@ async function listReviews(client, packageName, options) {
       { limit: options?.limit }
     );
     reviews = items;
+    nextPageToken = token;
   } else {
     const apiOptions = {};
     if (options?.translationLanguage) apiOptions.translationLanguage = options.translationLanguage;
@@ -1956,6 +2011,7 @@ async function listReviews(client, packageName, options) {
     if (options?.nextPage) apiOptions.token = options.nextPage;
     const response = await client.reviews.list(packageName, apiOptions);
     reviews = response.reviews || [];
+    nextPageToken = response.tokenPagination?.nextPageToken;
   }
   if (options?.stars !== void 0) {
     reviews = reviews.filter((r) => {
@@ -1976,7 +2032,7 @@ async function listReviews(client, packageName, options) {
       return userComment && Number(userComment.lastModified.seconds) >= sinceTime;
     });
   }
-  return reviews;
+  return { reviews, nextPageToken };
 }
 async function getReview(client, packageName, reviewId, translationLanguage) {
   return client.reviews.get(packageName, reviewId, translationLanguage);
@@ -2065,7 +2121,7 @@ function csvEscape(value) {
   return safe;
 }
 async function analyzeReviews2(client, packageName, options) {
-  const reviews = await listReviews(client, packageName, options);
+  const { reviews } = await listReviews(client, packageName, options);
   const items = reviews.map((r) => {
     const uc = r.comments?.[0]?.userComment;
     return {
@@ -2206,23 +2262,23 @@ async function getSubscription(client, packageName, productId) {
   validateSku(productId);
   return client.subscriptions.get(packageName, productId);
 }
-async function createSubscription(client, packageName, data) {
+async function createSubscription(client, packageName, data, regionsVersion) {
   validatePackageName(packageName);
   validateSubscriptionData(data);
   const sanitized = sanitizeSubscription(data);
-  return client.subscriptions.create(packageName, sanitized, data.productId);
+  return client.subscriptions.create(packageName, sanitized, data.productId, regionsVersion);
 }
 var SUBSCRIPTION_ID_FIELDS = /* @__PURE__ */ new Set(["productId", "packageName"]);
 function deriveSubscriptionUpdateMask(data) {
   return Object.keys(data).filter((k) => !SUBSCRIPTION_ID_FIELDS.has(k)).join(",");
 }
-async function updateSubscription(client, packageName, productId, data, updateMask) {
+async function updateSubscription(client, packageName, productId, data, updateMask, regionsVersion) {
   validatePackageName(packageName);
   validateSku(productId);
   validateSubscriptionData(data);
   const sanitized = sanitizeSubscription(data);
   const mask = updateMask || deriveSubscriptionUpdateMask(data);
-  return client.subscriptions.update(packageName, productId, sanitized, mask);
+  return client.subscriptions.update(packageName, productId, sanitized, mask, regionsVersion);
 }
 async function deleteSubscription(client, packageName, productId) {
   validatePackageName(packageName);
@@ -2259,7 +2315,7 @@ async function getOffer(client, packageName, productId, basePlanId, offerId) {
   validateSku(productId);
   return client.subscriptions.getOffer(packageName, productId, basePlanId, offerId);
 }
-async function createOffer(client, packageName, productId, basePlanId, data) {
+async function createOffer(client, packageName, productId, basePlanId, data, regionsVersion) {
   validatePackageName(packageName);
   validateSku(productId);
   const sanitized = sanitizeOffer(data);
@@ -2268,14 +2324,15 @@ async function createOffer(client, packageName, productId, basePlanId, data) {
     productId,
     basePlanId,
     sanitized,
-    data.offerId
+    data.offerId,
+    regionsVersion
   );
 }
 var OFFER_ID_FIELDS = /* @__PURE__ */ new Set(["productId", "basePlanId", "offerId"]);
 function deriveOfferUpdateMask(data) {
   return Object.keys(data).filter((k) => !OFFER_ID_FIELDS.has(k)).join(",");
 }
-async function updateOffer(client, packageName, productId, basePlanId, offerId, data, updateMask) {
+async function updateOffer(client, packageName, productId, basePlanId, offerId, data, updateMask, regionsVersion) {
   validatePackageName(packageName);
   validateSku(productId);
   const sanitized = sanitizeOffer(data);
@@ -2286,7 +2343,8 @@ async function updateOffer(client, packageName, productId, basePlanId, offerId,
     basePlanId,
     offerId,
     sanitized,
-    mask
+    mask,
+    regionsVersion
   );
 }
 async function deleteOffer(client, packageName, productId, basePlanId, offerId) {
@@ -2832,7 +2890,7 @@ async function getAppStatus(client, reporting, packageName, options = {}) {
     sections.has("vitals") ? queryVitalWithTrend(reporting, packageName, "anrRateMetricSet", days) : Promise.resolve(SKIPPED_VITAL),
     sections.has("vitals") ? queryVitalWithTrend(reporting, packageName, "slowStartRateMetricSet", days) : Promise.resolve(SKIPPED_VITAL),
     sections.has("vitals") ? queryVitalWithTrend(reporting, packageName, "slowRenderingRateMetricSet", days) : Promise.resolve(SKIPPED_VITAL),
-    sections.has("reviews") ? listReviews(client, packageName, { maxResults: 500 }) : Promise.resolve([])
+    sections.has("reviews") ? listReviews(client, packageName, { maxResults: 500 }) : Promise.resolve({ reviews: [] })
   ]);
   const sectionErrors = [];
   const rawReleases = releasesResult.status === "fulfilled" ? releasesResult.value : [];
@@ -2856,7 +2914,7 @@ async function getAppStatus(client, reporting, packageName, options = {}) {
   const slowRender = slowRenderResult.status === "fulfilled" ? slowRenderResult.value : SKIPPED_VITAL;
   if (slowRenderResult.status === "rejected")
     sectionErrors.push(`vitals/slowRender: ${String(slowRenderResult.reason)}`);
-  const rawReviews = reviewsResult.status === "fulfilled" ? reviewsResult.value : [];
+  const rawReviews = reviewsResult.status === "fulfilled" ? reviewsResult.value.reviews : [];
   if (reviewsResult.status === "rejected")
     sectionErrors.push(`reviews: ${String(reviewsResult.reason)}`);
   const reviews = computeReviewSentiment(rawReviews, reviewDays);
@@ -3606,7 +3664,7 @@ async function listVoidedPurchases(client, packageName, options) {
   if (options?.limit || options?.nextPage) {
     const result = await paginateAll4(
       async (pageToken) => {
-        const resp = await client.purchases.listVoided(packageName, {
+        const resp2 = await client.purchases.listVoided(packageName, {
           startTime: options?.startTime,
           endTime: options?.endTime,
           type: options?.type,
@@ -3615,15 +3673,19 @@ async function listVoidedPurchases(client, packageName, options) {
           token: pageToken
         });
         return {
-          items: resp.voidedPurchases || [],
-          nextPageToken: resp.tokenPagination?.nextPageToken
+          items: resp2.voidedPurchases || [],
+          nextPageToken: resp2.tokenPagination?.nextPageToken
         };
       },
       { limit: options.limit, startPageToken: options.nextPage }
     );
     return { voidedPurchases: result.items, nextPageToken: result.nextPageToken };
   }
-  return client.purchases.listVoided(packageName, options);
+  const resp = await client.purchases.listVoided(packageName, options);
+  return {
+    voidedPurchases: resp.voidedPurchases || [],
+    nextPageToken: resp.tokenPagination?.nextPageToken
+  };
 }
 async function refundOrder(client, packageName, orderId, options) {
   validatePackageName(packageName);
@@ -4173,9 +4235,9 @@ async function getOneTimeProduct(client, packageName, productId) {
     );
   }
 }
-async function createOneTimeProduct(client, packageName, data) {
+async function createOneTimeProduct(client, packageName, data, regionsVersion) {
   try {
-    return await client.oneTimeProducts.create(packageName, data);
+    return await client.oneTimeProducts.create(packageName, data, regionsVersion);
   } catch (error) {
     throw new GpcError(
       `Failed to create one-time product: ${error instanceof Error ? error.message : String(error)}`,
@@ -4193,10 +4255,10 @@ var OTP_OFFER_ID_FIELDS = /* @__PURE__ */ new Set(["packageName", "productId", "
 function deriveOtpOfferUpdateMask(data) {
   return Object.keys(data).filter((k) => !OTP_OFFER_ID_FIELDS.has(k)).join(",");
 }
-async function updateOneTimeProduct(client, packageName, productId, data, updateMask) {
+async function updateOneTimeProduct(client, packageName, productId, data, updateMask, regionsVersion) {
   try {
     const mask = updateMask || deriveOtpUpdateMask(data);
-    return await client.oneTimeProducts.update(packageName, productId, data, mask);
+    return await client.oneTimeProducts.update(packageName, productId, data, mask, regionsVersion);
   } catch (error) {
     throw new GpcError(
       `Failed to update one-time product "${productId}": ${error instanceof Error ? error.message : String(error)}`,
@@ -4242,9 +4304,15 @@ async function getOneTimeOffer(client, packageName, productId, offerId, purchase
     );
   }
 }
-async function createOneTimeOffer(client, packageName, productId, data, purchaseOptionId = "-") {
+async function createOneTimeOffer(client, packageName, productId, data, purchaseOptionId = "-", regionsVersion) {
   try {
-    return await client.oneTimeProducts.createOffer(packageName, productId, purchaseOptionId, data);
+    return await client.oneTimeProducts.createOffer(
+      packageName,
+      productId,
+      purchaseOptionId,
+      data,
+      regionsVersion
+    );
   } catch (error) {
     throw new GpcError(
       `Failed to create offer for product "${productId}": ${error instanceof Error ? error.message : String(error)}`,
@@ -4254,7 +4322,7 @@ async function createOneTimeOffer(client, packageName, productId, data, purchase
     );
   }
 }
-async function updateOneTimeOffer(client, packageName, productId, offerId, data, updateMask, purchaseOptionId = "-") {
+async function updateOneTimeOffer(client, packageName, productId, offerId, data, updateMask, purchaseOptionId = "-", regionsVersion) {
   try {
     const mask = updateMask || deriveOtpOfferUpdateMask(data);
     return await client.oneTimeProducts.updateOffer(
@@ -4263,7 +4331,8 @@ async function updateOneTimeOffer(client, packageName, productId, offerId, data,
       purchaseOptionId,
       offerId,
       data,
-      mask
+      mask,
+      regionsVersion
     );
   } catch (error) {
     throw new GpcError(
@@ -8864,6 +8933,7 @@ export {
   analyzeBundle,
   analyzeRemoteListings,
   analyzeReviews2 as analyzeReviews,
+  annotateListResult,
   applyReleaseNotes,
   assignRelease,
   batchGetOrders,
@@ -8939,6 +9009,7 @@ export {
   formatCustomPayload,
   formatDiscordPayload,
   formatJunit,
+  formatMoney,
   formatNotification,
   formatOutput,
   formatPathLabel,
@@ -9025,6 +9096,7 @@ export {
   loadStatusCache,
   maybePaginate,
   migratePrices,
+  moreResultsFooter,
   normalizeFingerprint,
   parseAppfile,
   parseCommit,