@gpc-cli/core 0.9.39 → 0.9.40

package/dist/index.d.ts

@@ -160,6 +160,7 @@ declare function uploadRelease(client: PlayApiClient, packageName: string, fileP
 }): Promise<UploadResult | DryRunUploadResult>;
 declare function getReleasesStatus(client: PlayApiClient, packageName: string, trackFilter?: string): Promise<ReleaseStatusResult[]>;
 declare function promoteRelease(client: PlayApiClient, packageName: string, fromTrack: string, toTrack: string, options?: {
+    status?: string;
     userFraction?: number;
     releaseNotes?: {
         language: string;
@@ -425,6 +426,7 @@ interface ReviewsFilterOptions {
     maxResults?: number;
     limit?: number;
     nextPage?: string;
+    all?: boolean;
 }
 interface ReviewExportOptions extends ReviewsFilterOptions {
     format?: "json" | "csv";
@@ -529,6 +531,8 @@ declare function refundSubscriptionV2(client: PlayApiClient, packageName: string
 interface ListVoidedOptions {
     startTime?: string;
     endTime?: string;
+    type?: number;
+    includeQuantityBasedPartialRefund?: boolean;
     maxResults?: number;
     limit?: number;
     nextPage?: string;
@@ -1204,4 +1208,49 @@ declare function fetchChangelog(options?: FetchChangelogOptions): Promise<Change
  */
 declare function formatChangelogEntry(entry: ChangelogEntry): string;
 
-export { ApiError, type AppInfo, type AppStatus, type AuditEntry, type BatchSyncResult, type BundleAnalysis, type BundleComparison, type BundleEntry, type BundleSizeCheckResult, type BundleSizeConfig, type ChangelogEntry, type CommandContext, ConfigError, DEFAULT_LIMITS, DEFAULT_PREFLIGHT_CONFIG, type DiffToken, type DiscoverPluginsOptions, type DryRunPublishResult, type DryRunResult, type DryRunUploadResult, type ExportImagesOptions, type ExportImagesSummary, type FastlaneDetection, type FastlaneLane, type FetchChangelogOptions, type FieldLintResult, type FileValidationResult, type FindingSeverity, GOOGLE_PLAY_LANGUAGES, type GetAppStatusOptions, type GitNotesOptions, type GitReleaseNotes, GpcError, type ImageValidationResult, type InitOptions, type InitResult, type InternalSharingUploadResult, type ListIapOptions, type ListSubscriptionsOptions, type ListUsersOptions, type ListVoidedOptions, type ListingDiff, type ListingFieldLimits, type ListingLintResult, type ListingsResult, type LoadedPlugin, type MigrationResult, NetworkError, type OneTimeProductDiff, PERMISSION_PROPAGATION_WARNING, type ParsedManifest, type ParsedMonth, PluginManager, type PreflightConfig, type PreflightFinding, type PreflightOptions, type PreflightResult, type PreflightScanner, type PublishOptions, type PublishResult, type PushResult, type QuotaUsage, type ReleaseDiff, type ReleaseNotesValidation, type ReleaseStatusResult, type ReviewAnalysis, type ReviewExportOptions, type ReviewsFilterOptions, SENSITIVE_ARG_KEYS, SENSITIVE_KEYS, SEVERITY_ORDER, type ScaffoldOptions, type ScaffoldResult, type Spinner, type StatusDiff, type StatusRelease, type StatusReviews, type StatusVitalMetric, type SubscriptionAnalytics, type SubscriptionDiff, type SyncResult, type ThresholdResult, type TrainConfig, type TrainState, type UploadResult, type ValidateCheck, type ValidateOptions, type ValidateResult, type VersionVitalsComparison, type VersionVitalsRow, type VitalsOverview, type VitalsQueryOptions, type VitalsTrendComparison, type WatchOptions, type WatchVitalsOptions, type WebhookPayload, abortTrain, acknowledgeProductPurchase, activateBasePlan, activateOffer, activatePurchaseOption, addRecoveryTargeting, addTesters, advanceTrain, analyzeBundle, analyzeRemoteListings, analyzeReviews, batchGetOrders, batchSyncInAppProducts, cancelRecoveryAction, cancelSubscriptionPurchase, cancelSubscriptionV2, checkBundleSize, checkThreshold, clearAuditLog, compareBundles, compareVersionVitals, compareVitalsTrend, computeStatusDiff, consumeProductPurchase, convertRegionPrices, createAuditEntry, createDeviceTier, createEnterpriseApp, createExternalTransaction, createGrant, createInAppProduct, createOffer, createOneTimeOffer, createOneTimeProduct, createPurchaseOption, createRecoveryAction, createSpinner, createSubscription, createTrack, deactivateBasePlan, deactivateOffer, deactivatePurchaseOption, deferSubscriptionPurchase, deferSubscriptionV2, deleteBasePlan, deleteGrant, deleteImage, deleteInAppProduct, deleteListing, deleteOffer, deleteOneTimeOffer, deleteOneTimeProduct, deleteSubscription, deployRecoveryAction, detectFastlane, detectOutputFormat, diffListings, diffListingsCommand, diffListingsEnhanced, diffOneTimeProduct, diffReleases, diffSubscription, discoverPlugins, downloadGeneratedApk, downloadReport, exportDataSafety, exportImages, exportReviews, fetchChangelog, fetchReleaseNotes, formatChangelogEntry, formatCustomPayload, formatDiscordPayload, formatJunit, formatOutput, formatSlackPayload, formatStatusDiff, formatStatusSummary, formatStatusTable, formatWordDiff, generateMigrationPlan, generateNotesFromGit, getAllScannerNames, getAppInfo, getAppStatus, getCountryAvailability, getDataSafety, getDeviceTier, getExternalTransaction, getInAppProduct, getListings, getOffer, getOneTimeOffer, getOneTimeProduct, getOrderDetails, getProductPurchase, getProductPurchaseV2, getPurchaseOption, getQuotaUsage, getReleasesStatus, getReview, getSubscription, getSubscriptionAnalytics, getSubscriptionPurchase, getTrainStatus, getUser, getVitalsAnomalies, getVitalsAnr, getVitalsBattery, getVitalsCrashes, getVitalsLmk, getVitalsMemory, getVitalsOverview, getVitalsRendering, getVitalsStartup, importDataSafety, importTestersFromCsv, initAudit, initProject, inviteUser, isFinancialReportType, isStatsReportType, isValidBcp47, isValidReportType, isValidStatsDimension, lintListing, lintListings, lintLocalListings, listAchievements, listAuditEvents, listDeviceTiers, listEnterpriseApps, listEvents, listGeneratedApks, listGrants, listImages, listInAppProducts, listLeaderboards, listOffers, listOneTimeOffers, listOneTimeProducts, listPurchaseOptions, listRecoveryActions, listReports, listReviews, listSubscriptions, listTesters, listTracks, listUsers, listVoidedPurchases, loadPreflightConfig, loadStatusCache, maybePaginate, migratePrices, parseAppfile, parseFastfile, parseGrantArg, parseMonth, pauseTrain, promoteRelease, publish, pullListings, pushListings, readListingsFromDir, readReleaseNotesFromDir, redactAuditArgs, redactSensitive, refundExternalTransaction, refundOrder, refundSubscriptionV2, relativeTime, removeTesters, removeUser, replyToReview, revokeSubscriptionPurchase, runPreflight, runWatchLoop, safePath, safePathWithin, saveStatusCache, scaffoldPlugin, searchAuditEvents, searchVitalsErrors, sendNotification, sendWebhook, sortResults, startTrain, statusHasBreach, syncInAppProducts, topFiles, trackBreachState, updateAppDetails, updateDataSafety, updateGrant, updateInAppProduct, updateListing, updateOffer, updateOneTimeOffer, updateOneTimeProduct, updateRollout, updateSubscription, updateTrackConfig, updateUser, uploadExternallyHosted, uploadImage, uploadInternalSharing, uploadRelease, validateImage, validateLanguageCode, validatePackageName, validatePreSubmission, validateReleaseNotes, validateSku, validateTrackName, validateUploadFile, validateVersionCode, watchVitalsWithAutoHalt, wordDiff, writeAuditLog, writeListingsToDir, writeMigrationOutput };
+interface RtdnStatus {
+    topicName: string | null;
+    enabled: boolean;
+}
+interface DecodedNotification {
+    version: string;
+    packageName: string;
+    eventTimeMillis: string;
+    subscriptionNotification?: {
+        version: string;
+        notificationType: number;
+        purchaseToken: string;
+        subscriptionId: string;
+    };
+    oneTimeProductNotification?: {
+        version: string;
+        notificationType: number;
+        purchaseToken: string;
+        sku: string;
+    };
+    voidedPurchaseNotification?: {
+        purchaseToken: string;
+        orderId: string;
+        productType: number;
+        refundType?: number;
+    };
+    testNotification?: {
+        version: string;
+    };
+}
+/**
+ * Get RTDN status by reading the app's notification topic configuration.
+ * Uses the monetization settings endpoint if available, otherwise returns defaults.
+ */
+declare function getRtdnStatus(client: PlayApiClient, packageName: string): Promise<RtdnStatus>;
+/**
+ * Decode a base64-encoded RTDN notification payload.
+ * Pub/Sub messages from Google Play are base64-encoded JSON.
+ */
+declare function decodeNotification(base64Payload: string): DecodedNotification;
+/**
+ * Format a decoded notification into a human-readable summary.
+ */
+declare function formatNotification(notification: DecodedNotification): Record<string, unknown>;
+
+export { ApiError, type AppInfo, type AppStatus, type AuditEntry, type BatchSyncResult, type BundleAnalysis, type BundleComparison, type BundleEntry, type BundleSizeCheckResult, type BundleSizeConfig, type ChangelogEntry, type CommandContext, ConfigError, DEFAULT_LIMITS, DEFAULT_PREFLIGHT_CONFIG, type DecodedNotification, type DiffToken, type DiscoverPluginsOptions, type DryRunPublishResult, type DryRunResult, type DryRunUploadResult, type ExportImagesOptions, type ExportImagesSummary, type FastlaneDetection, type FastlaneLane, type FetchChangelogOptions, type FieldLintResult, type FileValidationResult, type FindingSeverity, GOOGLE_PLAY_LANGUAGES, type GetAppStatusOptions, type GitNotesOptions, type GitReleaseNotes, GpcError, type ImageValidationResult, type InitOptions, type InitResult, type InternalSharingUploadResult, type ListIapOptions, type ListSubscriptionsOptions, type ListUsersOptions, type ListVoidedOptions, type ListingDiff, type ListingFieldLimits, type ListingLintResult, type ListingsResult, type LoadedPlugin, type MigrationResult, NetworkError, type OneTimeProductDiff, PERMISSION_PROPAGATION_WARNING, type ParsedManifest, type ParsedMonth, PluginManager, type PreflightConfig, type PreflightFinding, type PreflightOptions, type PreflightResult, type PreflightScanner, type PublishOptions, type PublishResult, type PushResult, type QuotaUsage, type ReleaseDiff, type ReleaseNotesValidation, type ReleaseStatusResult, type ReviewAnalysis, type ReviewExportOptions, type ReviewsFilterOptions, type RtdnStatus, SENSITIVE_ARG_KEYS, SENSITIVE_KEYS, SEVERITY_ORDER, type ScaffoldOptions, type ScaffoldResult, type Spinner, type StatusDiff, type StatusRelease, type StatusReviews, type StatusVitalMetric, type SubscriptionAnalytics, type SubscriptionDiff, type SyncResult, type ThresholdResult, type TrainConfig, type TrainState, type UploadResult, type ValidateCheck, type ValidateOptions, type ValidateResult, type VersionVitalsComparison, type VersionVitalsRow, type VitalsOverview, type VitalsQueryOptions, type VitalsTrendComparison, type WatchOptions, type WatchVitalsOptions, type WebhookPayload, abortTrain, acknowledgeProductPurchase, activateBasePlan, activateOffer, activatePurchaseOption, addRecoveryTargeting, addTesters, advanceTrain, analyzeBundle, analyzeRemoteListings, analyzeReviews, batchGetOrders, batchSyncInAppProducts, cancelRecoveryAction, cancelSubscriptionPurchase, cancelSubscriptionV2, checkBundleSize, checkThreshold, clearAuditLog, compareBundles, compareVersionVitals, compareVitalsTrend, computeStatusDiff, consumeProductPurchase, convertRegionPrices, createAuditEntry, createDeviceTier, createEnterpriseApp, createExternalTransaction, createGrant, createInAppProduct, createOffer, createOneTimeOffer, createOneTimeProduct, createPurchaseOption, createRecoveryAction, createSpinner, createSubscription, createTrack, deactivateBasePlan, deactivateOffer, deactivatePurchaseOption, decodeNotification, deferSubscriptionPurchase, deferSubscriptionV2, deleteBasePlan, deleteGrant, deleteImage, deleteInAppProduct, deleteListing, deleteOffer, deleteOneTimeOffer, deleteOneTimeProduct, deleteSubscription, deployRecoveryAction, detectFastlane, detectOutputFormat, diffListings, diffListingsCommand, diffListingsEnhanced, diffOneTimeProduct, diffReleases, diffSubscription, discoverPlugins, downloadGeneratedApk, downloadReport, exportDataSafety, exportImages, exportReviews, fetchChangelog, fetchReleaseNotes, formatChangelogEntry, formatCustomPayload, formatDiscordPayload, formatJunit, formatNotification, formatOutput, formatSlackPayload, formatStatusDiff, formatStatusSummary, formatStatusTable, formatWordDiff, generateMigrationPlan, generateNotesFromGit, getAllScannerNames, getAppInfo, getAppStatus, getCountryAvailability, getDataSafety, getDeviceTier, getExternalTransaction, getInAppProduct, getListings, getOffer, getOneTimeOffer, getOneTimeProduct, getOrderDetails, getProductPurchase, getProductPurchaseV2, getPurchaseOption, getQuotaUsage, getReleasesStatus, getReview, getRtdnStatus, getSubscription, getSubscriptionAnalytics, getSubscriptionPurchase, getTrainStatus, getUser, getVitalsAnomalies, getVitalsAnr, getVitalsBattery, getVitalsCrashes, getVitalsLmk, getVitalsMemory, getVitalsOverview, getVitalsRendering, getVitalsStartup, importDataSafety, importTestersFromCsv, initAudit, initProject, inviteUser, isFinancialReportType, isStatsReportType, isValidBcp47, isValidReportType, isValidStatsDimension, lintListing, lintListings, lintLocalListings, listAchievements, listAuditEvents, listDeviceTiers, listEnterpriseApps, listEvents, listGeneratedApks, listGrants, listImages, listInAppProducts, listLeaderboards, listOffers, listOneTimeOffers, listOneTimeProducts, listPurchaseOptions, listRecoveryActions, listReports, listReviews, listSubscriptions, listTesters, listTracks, listUsers, listVoidedPurchases, loadPreflightConfig, loadStatusCache, maybePaginate, migratePrices, parseAppfile, parseFastfile, parseGrantArg, parseMonth, pauseTrain, promoteRelease, publish, pullListings, pushListings, readListingsFromDir, readReleaseNotesFromDir, redactAuditArgs, redactSensitive, refundExternalTransaction, refundOrder, refundSubscriptionV2, relativeTime, removeTesters, removeUser, replyToReview, revokeSubscriptionPurchase, runPreflight, runWatchLoop, safePath, safePathWithin, saveStatusCache, scaffoldPlugin, searchAuditEvents, searchVitalsErrors, sendNotification, sendWebhook, sortResults, startTrain, statusHasBreach, syncInAppProducts, topFiles, trackBreachState, updateAppDetails, updateDataSafety, updateGrant, updateInAppProduct, updateListing, updateOffer, updateOneTimeOffer, updateOneTimeProduct, updateRollout, updateSubscription, updateTrackConfig, updateUser, uploadExternallyHosted, uploadImage, uploadInternalSharing, uploadRelease, validateImage, validateLanguageCode, validatePackageName, validatePreSubmission, validateReleaseNotes, validateSku, validateTrackName, validateUploadFile, validateVersionCode, watchVitalsWithAutoHalt, wordDiff, writeAuditLog, writeListingsToDir, writeMigrationOutput };

package/dist/index.js

@@ -564,6 +564,7 @@ async function getAppInfo(client, packageName) {
 
 // src/commands/releases.ts
 import { stat as stat2 } from "fs/promises";
+import { extname as extname2 } from "path";
 import { PlayApiError } from "@gpc-cli/api";
 
 // src/utils/file-validation.ts
@@ -671,6 +672,15 @@ async function withRetryOnConflict(client, packageName, operation) {
     }
   }
 }
+var _consoleEditWarningShown = false;
+function warnAboutConcurrentEdits() {
+  if (_consoleEditWarningShown) return;
+  _consoleEditWarningShown = true;
+  process.emitWarning?.(
+    "If the Play Console has pending changes, they may be discarded when this edit is committed. Avoid making changes in the Play Console while CLI operations are in progress.",
+    "ConcurrentEditWarning"
+  );
+}
 function warnIfEditExpiring(edit) {
   if (!edit.expiryTimeSeconds) return;
   const expiryMs = Number(edit.expiryTimeSeconds) * 1e3;
@@ -735,14 +745,17 @@ ${validation.errors.join("\n")}`,
   if (options.onProgress) options.onProgress(0, fileSize);
   const edit = await client.edits.insert(packageName);
   warnIfEditExpiring(edit);
+  warnAboutConcurrentEdits();
   try {
-    const bundle = await client.bundles.upload(packageName, edit.id, filePath, {
+    const isApk = extname2(filePath).toLowerCase() === ".apk";
+    const uploadOpts = {
       ...options.uploadOptions,
       onProgress: (event) => {
         if (options.onProgress) options.onProgress(event.bytesUploaded, event.totalBytes);
         if (options.onUploadProgress) options.onUploadProgress(event);
       }
-    });
+    };
+    const bundle = isApk ? await client.apks.upload(packageName, edit.id, filePath, uploadOpts) : await client.bundles.upload(packageName, edit.id, filePath, uploadOpts);
     if (options.mappingFile) {
       await client.deobfuscation.upload(
         packageName,
@@ -820,7 +833,7 @@ async function promoteRelease(client, packageName, fromTrack, toTrack, options)
     }
     const release = {
       versionCodes: currentRelease.versionCodes,
-      status: options?.userFraction ? "inProgress" : "completed",
+      status: options?.status || (options?.userFraction ? "inProgress" : "completed"),
       ...options?.userFraction && { userFraction: options.userFraction },
       releaseNotes: options?.releaseNotes || currentRelease.releaseNotes || []
     };
@@ -1139,7 +1152,7 @@ function isValidBcp47(tag) {
 
 // src/utils/image-validation.ts
 import { stat as stat3 } from "fs/promises";
-import { extname as extname2 } from "path";
+import { extname as extname3 } from "path";
 var IMAGE_SIZE_LIMITS = {
   icon: { maxBytes: 1024 * 1024, label: "1 MB" },
   featureGraphic: { maxBytes: 1024 * 1024, label: "1 MB" },
@@ -1155,7 +1168,7 @@ var LARGE_IMAGE_THRESHOLD = 2 * 1024 * 1024;
 async function validateImage(filePath, imageType) {
   const errors = [];
   const warnings = [];
-  const ext = extname2(filePath).toLowerCase();
+  const ext = extname3(filePath).toLowerCase();
   if (!VALID_EXTENSIONS.has(ext)) {
     errors.push(`Unsupported image format "${ext}". Use PNG or JPEG.`);
   }
@@ -1993,7 +2006,7 @@ function validateSku(sku) {
 
 // src/utils/release-notes.ts
 import { readdir as readdir3, readFile as readFile3, stat as stat5 } from "fs/promises";
-import { extname as extname3, basename, join as join3 } from "path";
+import { extname as extname4, basename, join as join3 } from "path";
 var MAX_NOTES_LENGTH = 500;
 async function readReleaseNotesFromDir(dir) {
   let entries;
@@ -2009,7 +2022,7 @@ async function readReleaseNotesFromDir(dir) {
   }
   const notes = [];
   for (const entry of entries) {
-    if (extname3(entry) !== ".txt") continue;
+    if (extname4(entry) !== ".txt") continue;
     const language = basename(entry, ".txt");
     const filePath = join3(dir, entry);
     const stats = await stat5(filePath);
@@ -2042,6 +2055,7 @@ function validateReleaseNotes(notes) {
 import { stat as stat6 } from "fs/promises";
 var STANDARD_TRACKS = /* @__PURE__ */ new Set([
   "internal",
+  "qa",
   "alpha",
   "beta",
   "production",
@@ -2061,7 +2075,11 @@ var STANDARD_TRACKS = /* @__PURE__ */ new Set([
   "android_xr:internal",
   "android_xr:alpha",
   "android_xr:beta",
-  "android_xr:production"
+  "android_xr:production",
+  "google_play_games_pc:internal",
+  "google_play_games_pc:alpha",
+  "google_play_games_pc:beta",
+  "google_play_games_pc:production"
 ]);
 var TRACK_PATTERN = /^[a-zA-Z0-9][a-zA-Z0-9_:-]*$/;
 async function validatePreSubmission(options) {
@@ -2404,11 +2422,27 @@ function analyzeReviews(reviews) {
 
 // src/commands/reviews.ts
 async function listReviews(client, packageName, options) {
-  const apiOptions = {};
-  if (options?.translationLanguage) apiOptions.translationLanguage = options.translationLanguage;
-  if (options?.maxResults) apiOptions.maxResults = options.maxResults;
-  const response = await client.reviews.list(packageName, apiOptions);
-  let reviews = response.reviews || [];
+  let reviews;
+  if (options?.all) {
+    const { items } = await paginateAll(async (pageToken) => {
+      const apiOptions = { token: pageToken };
+      if (options?.translationLanguage) apiOptions.translationLanguage = options.translationLanguage;
+      if (options?.maxResults) apiOptions.maxResults = options.maxResults;
+      const response = await client.reviews.list(packageName, apiOptions);
+      return {
+        items: response.reviews || [],
+        nextPageToken: response.tokenPagination?.nextPageToken
+      };
+    }, { limit: options?.limit });
+    reviews = items;
+  } else {
+    const apiOptions = {};
+    if (options?.translationLanguage) apiOptions.translationLanguage = options.translationLanguage;
+    if (options?.maxResults) apiOptions.maxResults = options.maxResults;
+    if (options?.nextPage) apiOptions.token = options.nextPage;
+    const response = await client.reviews.list(packageName, apiOptions);
+    reviews = response.reviews || [];
+  }
   if (options?.stars !== void 0) {
     reviews = reviews.filter((r) => {
       const userComment = r.comments?.[0]?.userComment;
@@ -3286,6 +3320,8 @@ async function listVoidedPurchases(client, packageName, options) {
         const resp = await client.purchases.listVoided(packageName, {
           startTime: options?.startTime,
           endTime: options?.endTime,
+          type: options?.type,
+          includeQuantityBasedPartialRefund: options?.includeQuantityBasedPartialRefund,
           maxResults: options?.maxResults,
           token: pageToken
         });
@@ -4755,13 +4791,19 @@ function extractComponents(appElement, tagName) {
 }
 
 // src/preflight/aab-reader.ts
-var MANIFEST_PATH = "base/manifest/AndroidManifest.xml";
+var AAB_MANIFEST_PATH = "base/manifest/AndroidManifest.xml";
+var APK_MANIFEST_PATH = "AndroidManifest.xml";
+function detectManifestPath(filePath) {
+  return filePath.toLowerCase().endsWith(".apk") ? APK_MANIFEST_PATH : AAB_MANIFEST_PATH;
+}
 async function readAab(aabPath) {
-  const { zipfile, entries, manifestBuf } = await openAndScan(aabPath);
+  const manifestPath = detectManifestPath(aabPath);
+  const { zipfile, entries, manifestBuf } = await openAndScan(aabPath, manifestPath);
   zipfile.close();
   if (!manifestBuf) {
+    const fileType = aabPath.toLowerCase().endsWith(".apk") ? "APK" : "AAB";
     throw new Error(
-      `AAB is missing ${MANIFEST_PATH}. This does not appear to be a valid Android App Bundle.`
+      `${fileType} is missing ${manifestPath}. This does not appear to be a valid Android ${fileType === "APK" ? "application package" : "App Bundle"}.`
     );
   }
   let manifest;
@@ -4793,7 +4835,7 @@ function createFallbackManifest() {
     providers: []
   };
 }
-function openAndScan(aabPath) {
+function openAndScan(aabPath, manifestPath = AAB_MANIFEST_PATH) {
   return new Promise((resolve2, reject) => {
     yauzlOpen(aabPath, { lazyEntries: true, autoClose: false }, (err, zipfile) => {
       if (err || !zipfile) {
@@ -4821,7 +4863,7 @@ function openAndScan(aabPath) {
             uncompressedSize: entry.uncompressedSize
           });
         }
-        if (path === MANIFEST_PATH) {
+        if (path === manifestPath) {
           zipfile.openReadStream(entry, (streamErr, stream) => {
             if (streamErr || !stream) {
               fail(streamErr ?? new Error("Failed to read manifest entry"));
@@ -5413,7 +5455,7 @@ import { readFile as readFile11 } from "fs/promises";
 
 // src/preflight/scan-files.ts
 import { readdir as readdir6, stat as stat9 } from "fs/promises";
-import { join as join9, extname as extname4 } from "path";
+import { join as join9, extname as extname5 } from "path";
 var DEFAULT_SKIP_DIRS = /* @__PURE__ */ new Set([
   ".git",
   "node_modules",
@@ -5443,7 +5485,7 @@ async function collectSourceFiles(dir, extensions, skipDirs = DEFAULT_SKIP_DIRS,
       const sub = await collectSourceFiles(fullPath, extensions, skipDirs, maxDepth - 1);
       files.push(...sub);
     } else if (s.isFile()) {
-      const ext = extname4(entry).toLowerCase();
+      const ext = extname5(entry).toLowerCase();
       if (extensions.has(ext) || entry.endsWith(".gradle.kts")) {
         files.push(fullPath);
       }
@@ -6283,7 +6325,7 @@ async function sendWebhook(config, payload, target) {
 }
 
 // src/commands/internal-sharing.ts
-import { extname as extname5 } from "path";
+import { extname as extname6 } from "path";
 async function uploadInternalSharing(client, packageName, filePath, fileType) {
   const resolvedType = fileType ?? detectFileType(filePath);
   const validation = await validateUploadFile(filePath);
@@ -6310,7 +6352,7 @@ ${validation.errors.join("\n")}`,
   };
 }
 function detectFileType(filePath) {
-  const ext = extname5(filePath).toLowerCase();
+  const ext = extname6(filePath).toLowerCase();
   if (ext === ".aab") return "bundle";
   if (ext === ".apk") return "apk";
   throw new GpcError(
@@ -7000,7 +7042,12 @@ function formatStatusDiff(diff, since) {
 }
 async function runWatchLoop(opts) {
   if (opts.intervalSeconds < 10) {
-    throw new Error("--watch interval must be at least 10 seconds");
+    throw new GpcError(
+      "--watch interval must be at least 10 seconds",
+      "STATUS_USAGE_ERROR",
+      2,
+      "Use --watch 10 or higher."
+    );
   }
   let running = true;
   const cleanup = () => {
@@ -7135,6 +7182,99 @@ function formatChangelogEntry(entry) {
   lines.push(`Full notes: ${entry.url}`);
   return lines.join("\n");
 }
+
+// src/commands/rtdn.ts
+var SUBSCRIPTION_NOTIFICATION_TYPES = {
+  1: "SUBSCRIPTION_RECOVERED",
+  2: "SUBSCRIPTION_RENEWED",
+  3: "SUBSCRIPTION_CANCELED",
+  4: "SUBSCRIPTION_PURCHASED",
+  5: "SUBSCRIPTION_ON_HOLD",
+  6: "SUBSCRIPTION_IN_GRACE_PERIOD",
+  7: "SUBSCRIPTION_RESTARTED",
+  8: "SUBSCRIPTION_PRICE_CHANGE_CONFIRMED",
+  9: "SUBSCRIPTION_DEFERRED",
+  10: "SUBSCRIPTION_PAUSED",
+  11: "SUBSCRIPTION_PAUSE_SCHEDULE_CHANGED",
+  12: "SUBSCRIPTION_REVOKED",
+  13: "SUBSCRIPTION_EXPIRED",
+  20: "SUBSCRIPTION_PENDING_PURCHASE_CANCELED"
+};
+var OTP_NOTIFICATION_TYPES = {
+  1: "ONE_TIME_PRODUCT_PURCHASED",
+  2: "ONE_TIME_PRODUCT_CANCELED"
+};
+async function getRtdnStatus(client, packageName) {
+  try {
+    const edit = await client.edits.insert(packageName);
+    try {
+      const details = await client.details.get(packageName, edit.id);
+      return {
+        topicName: null,
+        enabled: false
+      };
+    } finally {
+      await client.edits.delete(packageName, edit.id).catch(() => {
+      });
+    }
+  } catch {
+    return { topicName: null, enabled: false };
+  }
+}
+function decodeNotification(base64Payload) {
+  try {
+    const json = Buffer.from(base64Payload, "base64").toString("utf-8");
+    return JSON.parse(json);
+  } catch {
+    throw new GpcError(
+      "Failed to decode notification payload. Expected base64-encoded JSON.",
+      "RTDN_DECODE_ERROR",
+      1,
+      "Ensure the payload is a valid base64-encoded Pub/Sub message from Google Play."
+    );
+  }
+}
+function formatNotification(notification) {
+  const base = {
+    packageName: notification.packageName,
+    eventTime: notification.eventTimeMillis ? new Date(Number(notification.eventTimeMillis)).toISOString() : "-",
+    version: notification.version
+  };
+  if (notification.subscriptionNotification) {
+    const n = notification.subscriptionNotification;
+    return {
+      ...base,
+      type: "subscription",
+      event: SUBSCRIPTION_NOTIFICATION_TYPES[n.notificationType] || `UNKNOWN(${n.notificationType})`,
+      subscriptionId: n.subscriptionId,
+      purchaseToken: n.purchaseToken.slice(0, 16) + "..."
+    };
+  }
+  if (notification.oneTimeProductNotification) {
+    const n = notification.oneTimeProductNotification;
+    return {
+      ...base,
+      type: "one-time-product",
+      event: OTP_NOTIFICATION_TYPES[n.notificationType] || `UNKNOWN(${n.notificationType})`,
+      sku: n.sku,
+      purchaseToken: n.purchaseToken.slice(0, 16) + "..."
+    };
+  }
+  if (notification.voidedPurchaseNotification) {
+    const n = notification.voidedPurchaseNotification;
+    return {
+      ...base,
+      type: "voided-purchase",
+      event: "VOIDED_PURCHASE",
+      orderId: n.orderId,
+      purchaseToken: n.purchaseToken.slice(0, 16) + "..."
+    };
+  }
+  if (notification.testNotification) {
+    return { ...base, type: "test", event: "TEST_NOTIFICATION" };
+  }
+  return { ...base, type: "unknown" };
+}
 export {
   ApiError,
   ConfigError,
@@ -7190,6 +7330,7 @@ export {
   deactivateBasePlan,
   deactivateOffer,
   deactivatePurchaseOption,
+  decodeNotification,
   deferSubscriptionPurchase,
   deferSubscriptionV2,
   deleteBasePlan,
@@ -7222,6 +7363,7 @@ export {
   formatCustomPayload,
   formatDiscordPayload,
   formatJunit,
+  formatNotification,
   formatOutput,
   formatSlackPayload,
   formatStatusDiff,
@@ -7249,6 +7391,7 @@ export {
   getQuotaUsage,
   getReleasesStatus,
   getReview,
+  getRtdnStatus,
   getSubscription,
   getSubscriptionAnalytics,
   getSubscriptionPurchase,