@gpc-cli/core 0.9.18 → 0.9.20

package/dist/index.d.ts

@@ -493,8 +493,8 @@ interface ParsedMonth {
     month: number;
 }
 declare function parseMonth(monthStr: string): ParsedMonth;
-declare function listReports(client: PlayApiClient, packageName: string, reportType: ReportType, year: number, month: number): Promise<ReportBucket[]>;
-declare function downloadReport(client: PlayApiClient, packageName: string, reportType: ReportType, year: number, month: number): Promise<string>;
+declare function listReports(_client: PlayApiClient, _packageName: string, reportType: ReportType, _year: number, _month: number): Promise<ReportBucket[]>;
+declare function downloadReport(_client: PlayApiClient, _packageName: string, reportType: ReportType, _year: number, _month: number): Promise<string>;
 
 declare function listTesters(client: PlayApiClient, packageName: string, track: string): Promise<Testers>;
 declare function addTesters(client: PlayApiClient, packageName: string, track: string, groupEmails: string[]): Promise<Testers>;
@@ -629,6 +629,19 @@ declare function redactAuditArgs(entry: AuditEntry): AuditEntry;
  * Convenience: create an audit entry for a write command.
  */
 declare function createAuditEntry(command: string, args: Record<string, unknown>, app?: string): AuditEntry;
+declare function listAuditEvents(options?: {
+    limit?: number;
+    since?: string;
+    command?: string;
+}): Promise<AuditEntry[]>;
+declare function searchAuditEvents(query: string): Promise<AuditEntry[]>;
+declare function clearAuditLog(options?: {
+    before?: string;
+    dryRun?: boolean;
+}): Promise<{
+    deleted: number;
+    remaining: number;
+}>;
 
 interface WebhookPayload {
     command: string;
@@ -663,4 +676,4 @@ declare function createPurchaseOption(client: PlayApiClient, packageName: string
 declare function activatePurchaseOption(client: PlayApiClient, packageName: string, purchaseOptionId: string): Promise<PurchaseOption>;
 declare function deactivatePurchaseOption(client: PlayApiClient, packageName: string, purchaseOptionId: string): Promise<PurchaseOption>;
 
-export { ApiError, type AppInfo, type AuditEntry, type BatchSyncResult, type CommandContext, ConfigError, type DiscoverPluginsOptions, type DryRunPublishResult, type DryRunResult, type DryRunUploadResult, type ExportImagesOptions, type ExportImagesSummary, type FastlaneDetection, type FastlaneLane, type FileValidationResult, GOOGLE_PLAY_LANGUAGES, type GitNotesOptions, type GitReleaseNotes, GpcError, type ImageValidationResult, type InternalSharingUploadResult, type ListIapOptions, type ListSubscriptionsOptions, type ListUsersOptions, type ListVoidedOptions, type ListingDiff, type ListingsResult, type LoadedPlugin, type MigrationResult, NetworkError, type OneTimeProductDiff, PERMISSION_PROPAGATION_WARNING, type ParsedMonth, PluginManager, type PublishOptions, type PublishResult, type PushResult, type ReleaseDiff, type ReleaseNotesValidation, type ReleaseStatusResult, type ReviewExportOptions, type ReviewsFilterOptions, SENSITIVE_ARG_KEYS, SENSITIVE_KEYS, type ScaffoldOptions, type ScaffoldResult, type Spinner, type SubscriptionDiff, type SyncResult, type ThresholdResult, type UploadResult, type ValidateCheck, type ValidateOptions, type ValidateResult, type VitalsOverview, type VitalsQueryOptions, type VitalsTrendComparison, type WebhookPayload, acknowledgeProductPurchase, activateBasePlan, activateOffer, activatePurchaseOption, addRecoveryTargeting, addTesters, batchSyncInAppProducts, cancelRecoveryAction, cancelSubscriptionPurchase, checkThreshold, compareVitalsTrend, consumeProductPurchase, convertRegionPrices, createAuditEntry, createDeviceTier, createExternalTransaction, createInAppProduct, createOffer, createOneTimeOffer, createOneTimeProduct, createPurchaseOption, createRecoveryAction, createSpinner, createSubscription, createTrack, deactivateBasePlan, deactivateOffer, deactivatePurchaseOption, deferSubscriptionPurchase, deleteBasePlan, deleteImage, deleteInAppProduct, deleteListing, deleteOffer, deleteOneTimeOffer, deleteOneTimeProduct, deleteSubscription, deployRecoveryAction, detectFastlane, detectOutputFormat, diffListings, diffListingsCommand, diffOneTimeProduct, diffReleases, diffSubscription, discoverPlugins, downloadGeneratedApk, downloadReport, exportDataSafety, exportImages, exportReviews, formatCustomPayload, formatDiscordPayload, formatJunit, formatOutput, formatSlackPayload, generateMigrationPlan, generateNotesFromGit, getAppInfo, getCountryAvailability, getDataSafety, getDeviceTier, getExternalTransaction, getInAppProduct, getListings, getOffer, getOneTimeOffer, getOneTimeProduct, getProductPurchase, getPurchaseOption, getReleasesStatus, getReview, getSubscription, getSubscriptionPurchase, getUser, getVitalsAnomalies, getVitalsAnr, getVitalsBattery, getVitalsCrashes, getVitalsMemory, getVitalsOverview, getVitalsRendering, getVitalsStartup, importDataSafety, importTestersFromCsv, initAudit, inviteUser, isFinancialReportType, isStatsReportType, isValidBcp47, isValidReportType, isValidStatsDimension, listDeviceTiers, listGeneratedApks, listImages, listInAppProducts, listOffers, listOneTimeOffers, listOneTimeProducts, listPurchaseOptions, listRecoveryActions, listReports, listReviews, listSubscriptions, listTesters, listTracks, listUsers, listVoidedPurchases, migratePrices, parseAppfile, parseFastfile, parseGrantArg, parseMonth, promoteRelease, publish, pullListings, pushListings, readListingsFromDir, readReleaseNotesFromDir, redactAuditArgs, redactSensitive, refundExternalTransaction, refundOrder, removeTesters, removeUser, replyToReview, revokeSubscriptionPurchase, safePath, safePathWithin, scaffoldPlugin, searchVitalsErrors, sendWebhook, sortResults, syncInAppProducts, updateAppDetails, updateDataSafety, updateInAppProduct, updateListing, updateOffer, updateOneTimeOffer, updateOneTimeProduct, updateRollout, updateSubscription, updateTrackConfig, updateUser, uploadExternallyHosted, uploadImage, uploadInternalSharing, uploadRelease, validateImage, validateLanguageCode, validatePackageName, validatePreSubmission, validateReleaseNotes, validateSku, validateTrackName, validateUploadFile, validateVersionCode, writeAuditLog, writeListingsToDir, writeMigrationOutput };
+export { ApiError, type AppInfo, type AuditEntry, type BatchSyncResult, type CommandContext, ConfigError, type DiscoverPluginsOptions, type DryRunPublishResult, type DryRunResult, type DryRunUploadResult, type ExportImagesOptions, type ExportImagesSummary, type FastlaneDetection, type FastlaneLane, type FileValidationResult, GOOGLE_PLAY_LANGUAGES, type GitNotesOptions, type GitReleaseNotes, GpcError, type ImageValidationResult, type InternalSharingUploadResult, type ListIapOptions, type ListSubscriptionsOptions, type ListUsersOptions, type ListVoidedOptions, type ListingDiff, type ListingsResult, type LoadedPlugin, type MigrationResult, NetworkError, type OneTimeProductDiff, PERMISSION_PROPAGATION_WARNING, type ParsedMonth, PluginManager, type PublishOptions, type PublishResult, type PushResult, type ReleaseDiff, type ReleaseNotesValidation, type ReleaseStatusResult, type ReviewExportOptions, type ReviewsFilterOptions, SENSITIVE_ARG_KEYS, SENSITIVE_KEYS, type ScaffoldOptions, type ScaffoldResult, type Spinner, type SubscriptionDiff, type SyncResult, type ThresholdResult, type UploadResult, type ValidateCheck, type ValidateOptions, type ValidateResult, type VitalsOverview, type VitalsQueryOptions, type VitalsTrendComparison, type WebhookPayload, acknowledgeProductPurchase, activateBasePlan, activateOffer, activatePurchaseOption, addRecoveryTargeting, addTesters, batchSyncInAppProducts, cancelRecoveryAction, cancelSubscriptionPurchase, checkThreshold, clearAuditLog, compareVitalsTrend, consumeProductPurchase, convertRegionPrices, createAuditEntry, createDeviceTier, createExternalTransaction, createInAppProduct, createOffer, createOneTimeOffer, createOneTimeProduct, createPurchaseOption, createRecoveryAction, createSpinner, createSubscription, createTrack, deactivateBasePlan, deactivateOffer, deactivatePurchaseOption, deferSubscriptionPurchase, deleteBasePlan, deleteImage, deleteInAppProduct, deleteListing, deleteOffer, deleteOneTimeOffer, deleteOneTimeProduct, deleteSubscription, deployRecoveryAction, detectFastlane, detectOutputFormat, diffListings, diffListingsCommand, diffOneTimeProduct, diffReleases, diffSubscription, discoverPlugins, downloadGeneratedApk, downloadReport, exportDataSafety, exportImages, exportReviews, formatCustomPayload, formatDiscordPayload, formatJunit, formatOutput, formatSlackPayload, generateMigrationPlan, generateNotesFromGit, getAppInfo, getCountryAvailability, getDataSafety, getDeviceTier, getExternalTransaction, getInAppProduct, getListings, getOffer, getOneTimeOffer, getOneTimeProduct, getProductPurchase, getPurchaseOption, getReleasesStatus, getReview, getSubscription, getSubscriptionPurchase, getUser, getVitalsAnomalies, getVitalsAnr, getVitalsBattery, getVitalsCrashes, getVitalsMemory, getVitalsOverview, getVitalsRendering, getVitalsStartup, importDataSafety, importTestersFromCsv, initAudit, inviteUser, isFinancialReportType, isStatsReportType, isValidBcp47, isValidReportType, isValidStatsDimension, listAuditEvents, listDeviceTiers, listGeneratedApks, listImages, listInAppProducts, listOffers, listOneTimeOffers, listOneTimeProducts, listPurchaseOptions, listRecoveryActions, listReports, listReviews, listSubscriptions, listTesters, listTracks, listUsers, listVoidedPurchases, migratePrices, parseAppfile, parseFastfile, parseGrantArg, parseMonth, promoteRelease, publish, pullListings, pushListings, readListingsFromDir, readReleaseNotesFromDir, redactAuditArgs, redactSensitive, refundExternalTransaction, refundOrder, removeTesters, removeUser, replyToReview, revokeSubscriptionPurchase, safePath, safePathWithin, scaffoldPlugin, searchAuditEvents, searchVitalsErrors, sendWebhook, sortResults, syncInAppProducts, updateAppDetails, updateDataSafety, updateInAppProduct, updateListing, updateOffer, updateOneTimeOffer, updateOneTimeProduct, updateRollout, updateSubscription, updateTrackConfig, updateUser, uploadExternallyHosted, uploadImage, uploadInternalSharing, uploadRelease, validateImage, validateLanguageCode, validatePackageName, validatePreSubmission, validateReleaseNotes, validateSku, validateTrackName, validateUploadFile, validateVersionCode, writeAuditLog, writeListingsToDir, writeMigrationOutput };

package/dist/index.js

@@ -217,8 +217,8 @@ function toTestCases(data, commandName) {
   const cases = [];
   let failures = 0;
   if (Array.isArray(data)) {
-    for (const item of data) {
-      const tc = buildTestCase(item, commandName);
+    for (let i = 0; i < data.length; i++) {
+      const tc = buildTestCase(data[i], commandName, i);
       cases.push(tc.xml);
       if (tc.failed) failures++;
     }
@@ -233,7 +233,7 @@ function toTestCases(data, commandName) {
   }
   return { cases, failures };
 }
-function buildTestCase(item, commandName) {
+function buildTestCase(item, commandName, index = 0) {
   if (typeof item !== "object" || item === null) {
     const text = String(item);
     return {
@@ -243,7 +243,9 @@ function buildTestCase(item, commandName) {
   }
   const record = item;
   const name = escapeXml(
-    String(record["name"] ?? record["title"] ?? record["sku"] ?? record["id"] ?? JSON.stringify(item))
+    String(
+      record["name"] ?? record["title"] ?? record["sku"] ?? record["id"] ?? record["productId"] ?? record["packageName"] ?? record["trackId"] ?? record["region"] ?? record["languageCode"] ?? `item-${index + 1}`
+    )
   );
   const classname = `gpc.${escapeXml(commandName)}`;
   const breached = record["breached"];
@@ -1327,7 +1329,7 @@ var ALL_IMAGE_TYPES = [
   "tvBanner"
 ];
 async function exportImages(client, packageName, dir, options) {
-  const { mkdir: mkdir5, writeFile: writeFile6 } = await import("fs/promises");
+  const { mkdir: mkdir5, writeFile: writeFile7 } = await import("fs/promises");
   const { join: join7 } = await import("path");
   const edit = await client.edits.insert(packageName);
   try {
@@ -1364,7 +1366,7 @@ async function exportImages(client, packageName, dir, options) {
           const response = await fetch(task.url);
           const buffer = Buffer.from(await response.arrayBuffer());
           const filePath = join7(dirPath, `${task.index}.png`);
-          await writeFile6(filePath, buffer);
+          await writeFile7(filePath, buffer);
           return buffer.length;
         })
       );
@@ -1941,19 +1943,26 @@ function csvEscape(value) {
 }
 
 // src/commands/vitals.ts
-function buildQuery(options) {
+var METRIC_SET_METRICS = {
+  crashRateMetricSet: ["crashRate", "userPerceivedCrashRate", "distinctUsers"],
+  anrRateMetricSet: ["anrRate", "userPerceivedAnrRate", "distinctUsers"],
+  slowStartRateMetricSet: ["slowStartRate", "distinctUsers"],
+  slowRenderingRateMetricSet: ["slowRenderingRate", "distinctUsers"],
+  excessiveWakeupRateMetricSet: ["excessiveWakeupRate", "distinctUsers"],
+  stuckBackgroundWakelockRateMetricSet: ["stuckBackgroundWakelockRate", "distinctUsers"],
+  errorCountMetricSet: ["errorReportCount", "distinctUsers"]
+};
+function buildQuery(metricSet, options) {
+  const metrics = METRIC_SET_METRICS[metricSet] ?? ["errorReportCount", "distinctUsers"];
+  const days = options?.days ?? 30;
+  const end = /* @__PURE__ */ new Date();
+  end.setDate(end.getDate() - 1);
+  const start = new Date(end);
+  start.setDate(start.getDate() - days);
   const query = {
-    metrics: ["errorReportCount", "distinctUsers"]
-  };
-  if (options?.dimension) {
-    query.dimensions = [options.dimension];
-  }
-  if (options?.days) {
-    const end = /* @__PURE__ */ new Date();
-    const start = /* @__PURE__ */ new Date();
-    start.setDate(start.getDate() - options.days);
-    query.timelineSpec = {
-      aggregationPeriod: options.aggregation ?? "DAILY",
+    metrics,
+    timelineSpec: {
+      aggregationPeriod: options?.aggregation ?? "DAILY",
       startTime: {
         year: start.getFullYear(),
         month: start.getMonth() + 1,
@@ -1964,12 +1973,15 @@ function buildQuery(options) {
         month: end.getMonth() + 1,
         day: end.getDate()
       }
-    };
+    }
+  };
+  if (options?.dimension) {
+    query.dimensions = [options.dimension];
   }
   return query;
 }
 async function queryMetric(reporting, packageName, metricSet, options) {
-  const query = buildQuery(options);
+  const query = buildQuery(metricSet, options);
   return reporting.queryMetricSet(packageName, metricSet, query);
 }
 async function getVitalsOverview(reporting, packageName) {
@@ -1983,9 +1995,7 @@ async function getVitalsOverview(reporting, packageName) {
   ];
   const results = await Promise.allSettled(
     metricSets.map(
-      ([metric]) => reporting.queryMetricSet(packageName, metric, {
-        metrics: ["errorReportCount", "distinctUsers"]
-      })
+      ([metric]) => reporting.queryMetricSet(packageName, metric, buildQuery(metric))
     )
   );
   const overview = {};
@@ -2027,14 +2037,16 @@ async function searchVitalsErrors(reporting, packageName, options) {
 }
 async function compareVitalsTrend(reporting, packageName, metricSet, days = 7) {
   const now = /* @__PURE__ */ new Date();
+  now.setDate(now.getDate() - 1);
   const currentEnd = new Date(now);
   const currentStart = new Date(now);
   currentStart.setDate(currentStart.getDate() - days);
   const previousEnd = new Date(currentStart);
   const previousStart = new Date(previousEnd);
   previousStart.setDate(previousStart.getDate() - days);
+  const metrics = METRIC_SET_METRICS[metricSet] ?? ["errorReportCount", "distinctUsers"];
   const makeQuery = (start, end) => ({
-    metrics: ["errorReportCount", "distinctUsers"],
+    metrics,
     timelineSpec: {
       aggregationPeriod: "DAILY",
       startTime: { year: start.getFullYear(), month: start.getMonth() + 1, day: start.getDate() },
@@ -2610,39 +2622,21 @@ function parseMonth(monthStr) {
   }
   return { year, month };
 }
-async function listReports(client, packageName, reportType, year, month) {
-  const response = await client.reports.list(packageName, reportType, year, month);
-  return response.reports || [];
+async function listReports(_client, _packageName, reportType, _year, _month) {
+  throw new GpcError(
+    `Report listing for "${reportType}" is not available through the Google Play Developer API.`,
+    "REPORT_NOT_SUPPORTED",
+    1,
+    isFinancialReportType(reportType) ? "Financial reports are delivered via Google Cloud Storage. Access them from Play Console \u2192 Download reports \u2192 Financial." : "Stats reports are delivered via Google Cloud Storage. For real-time metrics, use 'gpc vitals' commands."
+  );
 }
-async function downloadReport(client, packageName, reportType, year, month) {
-  const reports = await listReports(client, packageName, reportType, year, month);
-  const monthPadded = String(month).padStart(2, "0");
-  if (reports.length === 0) {
-    throw new GpcError(
-      `No ${reportType} reports found for ${year}-${monthPadded}.`,
-      "REPORT_NOT_FOUND",
-      1,
-      `Reports may not be available yet for this period. Financial reports are typically available a few days after the month ends. Try a different month or report type.`
-    );
-  }
-  const bucket = reports[0];
-  if (!bucket) {
-    throw new GpcError(
-      `No ${reportType} reports found for ${year}-${monthPadded}.`,
-      "REPORT_NOT_FOUND",
-      1,
-      `Reports may not be available yet for this period. Try a different month or report type.`
-    );
-  }
-  const uri = bucket.uri;
-  const response = await fetch(uri);
-  if (!response.ok) {
-    throw new NetworkError(
-      `Failed to download report from signed URI: HTTP ${response.status}`,
-      "The signed download URL may have expired. Retry the command to generate a fresh URL."
-    );
-  }
-  return response.text();
+async function downloadReport(_client, _packageName, reportType, _year, _month) {
+  throw new GpcError(
+    `Report download for "${reportType}" is not available through the Google Play Developer API.`,
+    "REPORT_NOT_SUPPORTED",
+    1,
+    isFinancialReportType(reportType) ? "Financial reports are delivered via Google Cloud Storage. Access them from Play Console \u2192 Download reports \u2192 Financial." : "Stats reports are delivered via Google Cloud Storage. For real-time metrics, use 'gpc vitals' commands."
+  );
 }
 
 // src/commands/users.ts
@@ -3382,7 +3376,7 @@ describe("${pluginName}", () => {
 }
 
 // src/audit.ts
-import { appendFile, chmod, mkdir as mkdir4 } from "fs/promises";
+import { appendFile, chmod, mkdir as mkdir4, readFile as readFile8, writeFile as writeFile5 } from "fs/promises";
 import { join as join6 } from "path";
 var auditDir = null;
 function initAudit(configDir) {
@@ -3445,6 +3439,84 @@ function createAuditEntry(command, args, app) {
     args
   };
 }
+async function listAuditEvents(options) {
+  if (!auditDir) return [];
+  const logPath = join6(auditDir, "audit.log");
+  let content;
+  try {
+    content = await readFile8(logPath, "utf-8");
+  } catch {
+    return [];
+  }
+  const lines = content.trim().split("\n").filter(Boolean);
+  let entries = [];
+  for (const line of lines) {
+    try {
+      entries.push(JSON.parse(line));
+    } catch {
+    }
+  }
+  if (options?.since) {
+    const sinceDate = new Date(options.since).getTime();
+    entries = entries.filter((e) => new Date(e.timestamp).getTime() >= sinceDate);
+  }
+  if (options?.command) {
+    const cmd = options.command.toLowerCase();
+    entries = entries.filter((e) => e.command.toLowerCase().includes(cmd));
+  }
+  if (options?.limit) {
+    entries = entries.slice(-options.limit);
+  }
+  return entries;
+}
+async function searchAuditEvents(query) {
+  const all = await listAuditEvents();
+  const q = query.toLowerCase();
+  return all.filter((e) => {
+    const text = JSON.stringify(e).toLowerCase();
+    return text.includes(q);
+  });
+}
+async function clearAuditLog(options) {
+  if (!auditDir) return { deleted: 0, remaining: 0 };
+  const logPath = join6(auditDir, "audit.log");
+  let content;
+  try {
+    content = await readFile8(logPath, "utf-8");
+  } catch {
+    return { deleted: 0, remaining: 0 };
+  }
+  const lines = content.trim().split("\n").filter(Boolean);
+  if (!options?.before) {
+    const count = lines.length;
+    if (!options?.dryRun) {
+      await writeFile5(logPath, "", { encoding: "utf-8", mode: 384 });
+    }
+    return { deleted: count, remaining: 0 };
+  }
+  const beforeDate = new Date(options.before).getTime();
+  const keep = [];
+  const remove = [];
+  for (const line of lines) {
+    try {
+      const entry = JSON.parse(line);
+      if (new Date(entry.timestamp).getTime() < beforeDate) {
+        remove.push(line);
+      } else {
+        keep.push(line);
+      }
+    } catch {
+      keep.push(line);
+    }
+  }
+  if (!options?.dryRun) {
+    await writeFile5(logPath, keep.length > 0 ? keep.join("\n") + "\n" : "", {
+      encoding: "utf-8",
+      mode: 384
+    });
+  }
+  return { deleted: remove.length, remaining: keep.length };
+}
 
 // src/utils/webhooks.ts
 function formatSlackPayload(payload) {
@@ -3591,7 +3663,7 @@ function detectFileType(filePath) {
 }
 
 // src/commands/generated-apks.ts
-import { writeFile as writeFile5 } from "fs/promises";
+import { writeFile as writeFile6 } from "fs/promises";
 async function listGeneratedApks(client, packageName, versionCode) {
   if (!Number.isInteger(versionCode) || versionCode <= 0) {
     throw new GpcError(
@@ -3622,7 +3694,7 @@ async function downloadGeneratedApk(client, packageName, versionCode, apkId, out
   }
   const buffer = await client.generatedApks.download(packageName, versionCode, apkId);
   const bytes = new Uint8Array(buffer);
-  await writeFile5(outputPath, bytes);
+  await writeFile6(outputPath, bytes);
   return { path: outputPath, sizeBytes: bytes.byteLength };
 }
 
@@ -3707,6 +3779,7 @@ export {
   cancelRecoveryAction,
   cancelSubscriptionPurchase,
   checkThreshold,
+  clearAuditLog,
   compareVitalsTrend,
   consumeProductPurchase,
   convertRegionPrices,
@@ -3789,6 +3862,7 @@ export {
   isValidBcp47,
   isValidReportType,
   isValidStatsDimension,
+  listAuditEvents,
   listDeviceTiers,
   listGeneratedApks,
   listImages,
@@ -3827,6 +3901,7 @@ export {
   safePath,
   safePathWithin,
   scaffoldPlugin,
+  searchAuditEvents,
   searchVitalsErrors,
   sendWebhook,
   sortResults,