@gpc-cli/core 0.9.41 → 0.9.43

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 import { OutputFormat, ResolvedConfig, WebhookConfig } from '@gpc-cli/config';
 import { AuthClient } from '@gpc-cli/auth';
 import { GpcPlugin, PluginManifest, CommandEvent, CommandResult, PluginError, RequestEvent, ResponseEvent, PluginCommand } from '@gpc-cli/plugin-sdk';
-import { PlayApiClient, Track, ExternallyHostedApk, ExternallyHostedApkResponse, UploadProgressEvent, ResumableUploadOptions, Listing, ImageType, CountryAvailability, Image, AppDetails, Review, ReviewReplyResponse, Subscription, SubscriptionOffer, OffersListResponse, BasePlanMigratePricesRequest, InAppProduct, Order, SubscriptionDeferResponse, SubscriptionsV2DeferResponse, ProductPurchase, ProductPurchaseV2, SubscriptionPurchaseV2, VoidedPurchase, UsersApiClient, User, DeveloperPermission, Grant, MetricRow, ReportingDimension, ReportingAggregation, VitalsMetricSet, ReportingApiClient, AnomalyDetectionResponse, MetricSetResponse, ErrorIssuesResponse, ConvertRegionPricesResponse, ReportType, StatsDimension, ReportBucket, Testers, AppRecoveryTargeting, AppRecoveryAction, CreateAppRecoveryActionRequest, DataSafety, ExternalTransaction, ExternalTransactionRefund, DeviceTierConfig, OneTimeOffer, OneTimeProduct, OneTimeOffersListResponse, OneTimeProductsListResponse, GamesApiClient, Achievement, GameEvent, Leaderboard, EnterpriseApiClient, CustomApp, GeneratedApk, PurchaseOption, PurchaseOptionsListResponse } from '@gpc-cli/api';
+import { PlayApiClient, EditCommitOptions, Track, ExternallyHostedApk, ExternallyHostedApkResponse, DeobfuscationFileType, UploadProgressEvent, ResumableUploadOptions, Listing, ImageType, CountryAvailability, Image, AppDetails, Review, ReviewReplyResponse, Subscription, SubscriptionOffer, OffersListResponse, BasePlanMigratePricesRequest, InAppProduct, Order, SubscriptionDeferResponse, SubscriptionsV2DeferResponse, ProductPurchase, ProductPurchaseV2, SubscriptionPurchaseV2, VoidedPurchase, UsersApiClient, User, DeveloperPermission, Grant, MetricRow, ReportingDimension, ReportingAggregation, VitalsMetricSet, ReportingApiClient, AnomalyDetectionResponse, MetricSetResponse, ErrorIssuesResponse, ConvertRegionPricesResponse, ReportType, StatsDimension, ReportBucket, Testers, AppRecoveryTargeting, AppRecoveryAction, CreateAppRecoveryActionRequest, DataSafety, ExternalTransaction, ExternalTransactionRefund, DeviceTierConfig, OneTimeOffer, OneTimeProduct, OneTimeOffersListResponse, OneTimeProductsListResponse, GamesApiClient, Achievement, GameEvent, Leaderboard, EnterpriseApiClient, CustomApp, GeneratedApk, PurchaseOption, PurchaseOptionsListResponse } from '@gpc-cli/api';
 
 declare class GpcError extends Error {
     readonly code: string;
@@ -153,10 +153,13 @@ declare function uploadRelease(client: PlayApiClient, packageName: string, fileP
     }[];
     releaseName?: string;
     mappingFile?: string;
+    mappingFileType?: DeobfuscationFileType;
     dryRun?: boolean;
     onProgress?: (uploaded: number, total: number) => void;
     onUploadProgress?: (event: UploadProgressEvent) => void;
     uploadOptions?: Pick<ResumableUploadOptions, "chunkSize" | "resumeSessionUri" | "maxResumeAttempts">;
+    deviceTierConfigId?: string;
+    commitOptions?: EditCommitOptions;
 }): 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?: {
@@ -166,11 +169,12 @@ declare function promoteRelease(client: PlayApiClient, packageName: string, from
         language: string;
         text: string;
     }[];
+    commitOptions?: EditCommitOptions;
 }): Promise<ReleaseStatusResult>;
-declare function updateRollout(client: PlayApiClient, packageName: string, track: string, action: "increase" | "halt" | "resume" | "complete", userFraction?: number): Promise<ReleaseStatusResult>;
+declare function updateRollout(client: PlayApiClient, packageName: string, track: string, action: "increase" | "halt" | "resume" | "complete", userFraction?: number, commitOptions?: EditCommitOptions): Promise<ReleaseStatusResult>;
 declare function listTracks(client: PlayApiClient, packageName: string): Promise<Track[]>;
-declare function createTrack(client: PlayApiClient, packageName: string, trackName: string): Promise<Track>;
-declare function updateTrackConfig(client: PlayApiClient, packageName: string, trackName: string, config: Record<string, unknown>): Promise<Track>;
+declare function createTrack(client: PlayApiClient, packageName: string, trackName: string, commitOptions?: EditCommitOptions): Promise<Track>;
+declare function updateTrackConfig(client: PlayApiClient, packageName: string, trackName: string, config: Record<string, unknown>, commitOptions?: EditCommitOptions): Promise<Track>;
 /**
  * Fetch release notes from the latest active release on a given track.
  * Opens and discards an edit — read-only, no mutations.
@@ -189,7 +193,7 @@ declare function diffReleases(client: PlayApiClient, packageName: string, fromTr
     toTrack: string;
     diffs: ReleaseDiff[];
 }>;
-declare function uploadExternallyHosted(client: PlayApiClient, packageName: string, data: ExternallyHostedApk): Promise<ExternallyHostedApkResponse>;
+declare function uploadExternallyHosted(client: PlayApiClient, packageName: string, data: ExternallyHostedApk, commitOptions?: EditCommitOptions): Promise<ExternallyHostedApkResponse>;
 
 interface ListingDiff {
     language: string;
@@ -255,8 +259,8 @@ interface DryRunResult {
     diffs: ListingDiff[];
 }
 declare function getListings(client: PlayApiClient, packageName: string, language?: string): Promise<Listing[]>;
-declare function updateListing(client: PlayApiClient, packageName: string, language: string, data: Partial<Omit<Listing, "language">>): Promise<Listing>;
-declare function deleteListing(client: PlayApiClient, packageName: string, language: string): Promise<void>;
+declare function updateListing(client: PlayApiClient, packageName: string, language: string, data: Partial<Omit<Listing, "language">>, commitOptions?: EditCommitOptions): Promise<Listing>;
+declare function deleteListing(client: PlayApiClient, packageName: string, language: string, commitOptions?: EditCommitOptions): Promise<void>;
 declare function pullListings(client: PlayApiClient, packageName: string, dir: string): Promise<ListingsResult>;
 /** Lint local listing directory against Play Store character limits (no API call). */
 declare function lintLocalListings(dir: string): Promise<ListingLintResult[]>;
@@ -275,10 +279,11 @@ declare function diffListingsEnhanced(client: PlayApiClient, packageName: string
 declare function pushListings(client: PlayApiClient, packageName: string, dir: string, options?: {
     dryRun?: boolean;
     force?: boolean;
+    commitOptions?: EditCommitOptions;
 }): Promise<PushResult | DryRunResult>;
 declare function listImages(client: PlayApiClient, packageName: string, language: string, imageType: ImageType): Promise<Image[]>;
-declare function uploadImage(client: PlayApiClient, packageName: string, language: string, imageType: ImageType, filePath: string): Promise<Image>;
-declare function deleteImage(client: PlayApiClient, packageName: string, language: string, imageType: ImageType, imageId: string): Promise<void>;
+declare function uploadImage(client: PlayApiClient, packageName: string, language: string, imageType: ImageType, filePath: string, commitOptions?: EditCommitOptions): Promise<Image>;
+declare function deleteImage(client: PlayApiClient, packageName: string, language: string, imageType: ImageType, imageId: string, commitOptions?: EditCommitOptions): Promise<void>;
 declare function diffListingsCommand(client: PlayApiClient, packageName: string, dir: string): Promise<ListingDiff[]>;
 declare function getCountryAvailability(client: PlayApiClient, packageName: string, track: string): Promise<CountryAvailability>;
 interface ExportImagesOptions {
@@ -291,7 +296,7 @@ interface ExportImagesSummary {
     totalSize: number;
 }
 declare function exportImages(client: PlayApiClient, packageName: string, dir: string, options?: ExportImagesOptions): Promise<ExportImagesSummary>;
-declare function updateAppDetails(client: PlayApiClient, packageName: string, details: Partial<AppDetails>): Promise<AppDetails>;
+declare function updateAppDetails(client: PlayApiClient, packageName: string, details: Partial<AppDetails>, commitOptions?: EditCommitOptions): Promise<AppDetails>;
 
 interface FastlaneDetection {
     hasFastfile: boolean;
@@ -382,7 +387,10 @@ interface PublishOptions {
     notesDir?: string;
     releaseName?: string;
     mappingFile?: string;
+    mappingFileType?: DeobfuscationFileType;
+    deviceTierConfigId?: string;
     dryRun?: boolean;
+    commitOptions?: EditCommitOptions;
 }
 interface PublishResult {
     validation: ValidateResult;
@@ -670,9 +678,9 @@ declare function updateGrant(client: UsersApiClient, developerId: string, email:
 declare function deleteGrant(client: UsersApiClient, developerId: string, email: string, packageName: string): Promise<void>;
 
 declare function listTesters(client: PlayApiClient, packageName: string, track: string): Promise<Testers>;
-declare function addTesters(client: PlayApiClient, packageName: string, track: string, groupEmails: string[]): Promise<Testers>;
-declare function removeTesters(client: PlayApiClient, packageName: string, track: string, groupEmails: string[]): Promise<Testers>;
-declare function importTestersFromCsv(client: PlayApiClient, packageName: string, track: string, csvPath: string): Promise<{
+declare function addTesters(client: PlayApiClient, packageName: string, track: string, groupEmails: string[], commitOptions?: EditCommitOptions): Promise<Testers>;
+declare function removeTesters(client: PlayApiClient, packageName: string, track: string, groupEmails: string[], commitOptions?: EditCommitOptions): Promise<Testers>;
+declare function importTestersFromCsv(client: PlayApiClient, packageName: string, track: string, csvPath: string, commitOptions?: EditCommitOptions): Promise<{
     added: number;
     testers: Testers;
 }>;

package/dist/index.js

@@ -755,13 +755,14 @@ ${validation.errors.join("\n")}`,
         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);
+    const bundle = isApk ? await client.apks.upload(packageName, edit.id, filePath, uploadOpts) : await client.bundles.upload(packageName, edit.id, filePath, uploadOpts, options.deviceTierConfigId);
     if (options.mappingFile) {
       await client.deobfuscation.upload(
         packageName,
         edit.id,
         bundle.versionCode,
-        options.mappingFile
+        options.mappingFile,
+        options.mappingFileType
       );
     }
     const release = {
@@ -772,8 +773,10 @@ ${validation.errors.join("\n")}`,
       ...options.releaseName && { name: options.releaseName }
     };
     await client.tracks.update(packageName, edit.id, options.track, release);
-    await client.edits.validate(packageName, edit.id);
-    await client.edits.commit(packageName, edit.id);
+    if (!options.commitOptions?.changesNotSentForReview) {
+      await client.edits.validate(packageName, edit.id);
+    }
+    await client.edits.commit(packageName, edit.id, options.commitOptions);
     return {
       versionCode: bundle.versionCode,
       track: options.track,
@@ -838,8 +841,10 @@ async function promoteRelease(client, packageName, fromTrack, toTrack, options)
       releaseNotes: options?.releaseNotes || currentRelease.releaseNotes || []
     };
     await client.tracks.update(packageName, edit.id, toTrack, release);
-    await client.edits.validate(packageName, edit.id);
-    await client.edits.commit(packageName, edit.id);
+    if (!options?.commitOptions?.changesNotSentForReview) {
+      await client.edits.validate(packageName, edit.id);
+    }
+    await client.edits.commit(packageName, edit.id, options?.commitOptions);
     return {
       track: toTrack,
       status: release.status,
@@ -848,7 +853,7 @@ async function promoteRelease(client, packageName, fromTrack, toTrack, options)
     };
   });
 }
-async function updateRollout(client, packageName, track, action, userFraction) {
+async function updateRollout(client, packageName, track, action, userFraction, commitOptions) {
   const edit = await client.edits.insert(packageName);
   try {
     const trackData = await client.tracks.get(packageName, edit.id, track);
@@ -905,8 +910,10 @@ async function updateRollout(client, packageName, track, action, userFraction) {
       releaseNotes: currentRelease.releaseNotes || []
     };
     await client.tracks.update(packageName, edit.id, track, release);
-    await client.edits.validate(packageName, edit.id);
-    await client.edits.commit(packageName, edit.id);
+    if (!commitOptions?.changesNotSentForReview) {
+      await client.edits.validate(packageName, edit.id);
+    }
+    await client.edits.commit(packageName, edit.id, commitOptions);
     return {
       track,
       status: newStatus,
@@ -931,7 +938,7 @@ async function listTracks(client, packageName) {
     throw error;
   }
 }
-async function createTrack(client, packageName, trackName) {
+async function createTrack(client, packageName, trackName, commitOptions) {
   if (!trackName || trackName.trim().length === 0) {
     throw new GpcError(
       "Track name must not be empty",
@@ -943,8 +950,10 @@ async function createTrack(client, packageName, trackName) {
   const edit = await client.edits.insert(packageName);
   try {
     const track = await client.tracks.create(packageName, edit.id, trackName);
-    await client.edits.validate(packageName, edit.id);
-    await client.edits.commit(packageName, edit.id);
+    if (!commitOptions?.changesNotSentForReview) {
+      await client.edits.validate(packageName, edit.id);
+    }
+    await client.edits.commit(packageName, edit.id, commitOptions);
     return track;
   } catch (error) {
     await client.edits.delete(packageName, edit.id).catch(() => {
@@ -952,7 +961,7 @@ async function createTrack(client, packageName, trackName) {
     throw error;
   }
 }
-async function updateTrackConfig(client, packageName, trackName, config) {
+async function updateTrackConfig(client, packageName, trackName, config, commitOptions) {
   if (!trackName || trackName.trim().length === 0) {
     throw new GpcError(
       "Track name must not be empty",
@@ -977,8 +986,10 @@ async function updateTrackConfig(client, packageName, trackName, config) {
       release.name = config["name"];
     }
     const track = await client.tracks.update(packageName, edit.id, trackName, release);
-    await client.edits.validate(packageName, edit.id);
-    await client.edits.commit(packageName, edit.id);
+    if (!commitOptions?.changesNotSentForReview) {
+      await client.edits.validate(packageName, edit.id);
+    }
+    await client.edits.commit(packageName, edit.id, commitOptions);
     return track;
   } catch (error) {
     await client.edits.delete(packageName, edit.id).catch(() => {
@@ -1031,7 +1042,7 @@ async function diffReleases(client, packageName, fromTrack, toTrack) {
     throw error;
   }
 }
-async function uploadExternallyHosted(client, packageName, data) {
+async function uploadExternallyHosted(client, packageName, data, commitOptions) {
   if (!data.externallyHostedUrl) {
     throw new GpcError(
       "externallyHostedUrl is required",
@@ -1051,8 +1062,10 @@ async function uploadExternallyHosted(client, packageName, data) {
   const edit = await client.edits.insert(packageName);
   try {
     const result = await client.apks.addExternallyHosted(packageName, edit.id, data);
-    await client.edits.validate(packageName, edit.id);
-    await client.edits.commit(packageName, edit.id);
+    if (!commitOptions?.changesNotSentForReview) {
+      await client.edits.validate(packageName, edit.id);
+    }
+    await client.edits.commit(packageName, edit.id, commitOptions);
     return result;
   } catch (error) {
     await client.edits.delete(packageName, edit.id).catch(() => {
@@ -1397,13 +1410,15 @@ async function getListings(client, packageName, language) {
     throw error;
   }
 }
-async function updateListing(client, packageName, language, data) {
+async function updateListing(client, packageName, language, data, commitOptions) {
   validateLanguage(language);
   const edit = await client.edits.insert(packageName);
   try {
     const listing = await client.listings.patch(packageName, edit.id, language, data);
-    await client.edits.validate(packageName, edit.id);
-    await client.edits.commit(packageName, edit.id);
+    if (!commitOptions?.changesNotSentForReview) {
+      await client.edits.validate(packageName, edit.id);
+    }
+    await client.edits.commit(packageName, edit.id, commitOptions);
     return listing;
   } catch (error) {
     await client.edits.delete(packageName, edit.id).catch(() => {
@@ -1411,13 +1426,15 @@ async function updateListing(client, packageName, language, data) {
     throw error;
   }
 }
-async function deleteListing(client, packageName, language) {
+async function deleteListing(client, packageName, language, commitOptions) {
   validateLanguage(language);
   const edit = await client.edits.insert(packageName);
   try {
     await client.listings.delete(packageName, edit.id, language);
-    await client.edits.validate(packageName, edit.id);
-    await client.edits.commit(packageName, edit.id);
+    if (!commitOptions?.changesNotSentForReview) {
+      await client.edits.validate(packageName, edit.id);
+    }
+    await client.edits.commit(packageName, edit.id, commitOptions);
   } catch (error) {
     await client.edits.delete(packageName, edit.id).catch(() => {
     });
@@ -1540,8 +1557,10 @@ ${details}`,
       const { language, ...data } = listing;
       await client.listings.update(packageName, edit.id, language, data);
     }
-    await client.edits.validate(packageName, edit.id);
-    await client.edits.commit(packageName, edit.id);
+    if (!options?.commitOptions?.changesNotSentForReview) {
+      await client.edits.validate(packageName, edit.id);
+    }
+    await client.edits.commit(packageName, edit.id, options?.commitOptions);
     return {
       updated: localListings.length,
       languages: localListings.map((l) => l.language)
@@ -1565,7 +1584,7 @@ async function listImages(client, packageName, language, imageType) {
     throw error;
   }
 }
-async function uploadImage(client, packageName, language, imageType, filePath) {
+async function uploadImage(client, packageName, language, imageType, filePath, commitOptions) {
   validateLanguage(language);
   const imageCheck = await validateImage(filePath, imageType);
   if (!imageCheck.valid) {
@@ -1582,8 +1601,10 @@ async function uploadImage(client, packageName, language, imageType, filePath) {
   const edit = await client.edits.insert(packageName);
   try {
     const image = await client.images.upload(packageName, edit.id, language, imageType, filePath);
-    await client.edits.validate(packageName, edit.id);
-    await client.edits.commit(packageName, edit.id);
+    if (!commitOptions?.changesNotSentForReview) {
+      await client.edits.validate(packageName, edit.id);
+    }
+    await client.edits.commit(packageName, edit.id, commitOptions);
     return image;
   } catch (error) {
     await client.edits.delete(packageName, edit.id).catch(() => {
@@ -1591,13 +1612,15 @@ async function uploadImage(client, packageName, language, imageType, filePath) {
     throw error;
   }
 }
-async function deleteImage(client, packageName, language, imageType, imageId) {
+async function deleteImage(client, packageName, language, imageType, imageId, commitOptions) {
   validateLanguage(language);
   const edit = await client.edits.insert(packageName);
   try {
     await client.images.delete(packageName, edit.id, language, imageType, imageId);
-    await client.edits.validate(packageName, edit.id);
-    await client.edits.commit(packageName, edit.id);
+    if (!commitOptions?.changesNotSentForReview) {
+      await client.edits.validate(packageName, edit.id);
+    }
+    await client.edits.commit(packageName, edit.id, commitOptions);
   } catch (error) {
     await client.edits.delete(packageName, edit.id).catch(() => {
     });
@@ -1706,12 +1729,14 @@ async function exportImages(client, packageName, dir, options) {
     throw error;
   }
 }
-async function updateAppDetails(client, packageName, details) {
+async function updateAppDetails(client, packageName, details, commitOptions) {
   const edit = await client.edits.insert(packageName);
   try {
     const result = await client.details.patch(packageName, edit.id, details);
-    await client.edits.validate(packageName, edit.id);
-    await client.edits.commit(packageName, edit.id);
+    if (!commitOptions?.changesNotSentForReview) {
+      await client.edits.validate(packageName, edit.id);
+    }
+    await client.edits.commit(packageName, edit.id, commitOptions);
     return result;
   } catch (error) {
     await client.edits.delete(packageName, edit.id).catch(() => {
@@ -2186,7 +2211,10 @@ async function publish(client, packageName, filePath, options) {
     userFraction: options.rolloutPercent ? options.rolloutPercent / 100 : void 0,
     releaseNotes,
     releaseName: options.releaseName,
-    mappingFile: options.mappingFile
+    mappingFile: options.mappingFile,
+    mappingFileType: options.mappingFileType,
+    deviceTierConfigId: options.deviceTierConfigId,
+    commitOptions: options.commitOptions
   });
   return { validation, upload };
 }
@@ -3554,7 +3582,7 @@ async function listTesters(client, packageName, track) {
     await client.edits.delete(packageName, edit.id);
   }
 }
-async function addTesters(client, packageName, track, groupEmails) {
+async function addTesters(client, packageName, track, groupEmails, commitOptions) {
   const edit = await client.edits.insert(packageName);
   try {
     const current = await client.testers.get(packageName, edit.id, track);
@@ -3565,8 +3593,10 @@ async function addTesters(client, packageName, track, groupEmails) {
     const updated = await client.testers.update(packageName, edit.id, track, {
       googleGroups: [...existing]
     });
-    await client.edits.validate(packageName, edit.id);
-    await client.edits.commit(packageName, edit.id);
+    if (!commitOptions?.changesNotSentForReview) {
+      await client.edits.validate(packageName, edit.id);
+    }
+    await client.edits.commit(packageName, edit.id, commitOptions);
     return updated;
   } catch (error) {
     await client.edits.delete(packageName, edit.id).catch(() => {
@@ -3574,7 +3604,7 @@ async function addTesters(client, packageName, track, groupEmails) {
     throw error;
   }
 }
-async function removeTesters(client, packageName, track, groupEmails) {
+async function removeTesters(client, packageName, track, groupEmails, commitOptions) {
   const edit = await client.edits.insert(packageName);
   try {
     const current = await client.testers.get(packageName, edit.id, track);
@@ -3583,8 +3613,10 @@ async function removeTesters(client, packageName, track, groupEmails) {
     const updated = await client.testers.update(packageName, edit.id, track, {
       googleGroups: filtered
     });
-    await client.edits.validate(packageName, edit.id);
-    await client.edits.commit(packageName, edit.id);
+    if (!commitOptions?.changesNotSentForReview) {
+      await client.edits.validate(packageName, edit.id);
+    }
+    await client.edits.commit(packageName, edit.id, commitOptions);
     return updated;
   } catch (error) {
     await client.edits.delete(packageName, edit.id).catch(() => {
@@ -3592,7 +3624,7 @@ async function removeTesters(client, packageName, track, groupEmails) {
     throw error;
   }
 }
-async function importTestersFromCsv(client, packageName, track, csvPath) {
+async function importTestersFromCsv(client, packageName, track, csvPath, commitOptions) {
   const content = await readFile5(csvPath, "utf-8");
   const emails = content.split(/[,\n\r]+/).map((e) => e.trim()).filter((e) => e.length > 0 && e.includes("@"));
   if (emails.length === 0) {
@@ -3603,7 +3635,7 @@ async function importTestersFromCsv(client, packageName, track, csvPath) {
       "The CSV file must contain email addresses separated by commas or newlines. Each email must contain an @ symbol."
     );
   }
-  const testers = await addTesters(client, packageName, track, emails);
+  const testers = await addTesters(client, packageName, track, emails, commitOptions);
   return { added: emails.length, testers };
 }