@gpc-cli/api 1.0.25 → 1.0.27

package/README.md

@@ -2,7 +2,7 @@
 
 Typed Google Play Developer API v3 client for TypeScript. Part of [GPC](https://github.com/yasserstudio/gpc).
 
-The entire Google Play Developer API in one typed client — 187 endpoints covering edits, releases, tracks, listings, images, subscriptions, in-app products, purchases, reviews, vitals, reports, users, and testers. Built-in rate limiting, retry logic, and pagination. Works with your existing service account — no new credentials required.
+The entire Google Play Developer API in one typed client — 204 endpoints covering edits, releases, tracks, listings, images, subscriptions, in-app products, purchases, reviews, vitals, reports, users, and testers. Built-in rate limiting, retry logic, and pagination. Works with your existing service account — no new credentials required.
 
 ## Install
 

package/dist/index.d.ts

@@ -7,7 +7,20 @@ interface RateLimitBucket {
 interface RateLimiter {
     acquire(bucket: string): Promise<void>;
 }
+/**
+ * Google Play Developer API quota model (as of 2025):
+ * - 200,000 queries per day total
+ * - 6 independent per-minute buckets at 3,000 queries/min each
+ *
+ * The per-minute buckets are the practical constraint for CLI usage.
+ * Daily limits are tracked locally via gpc quota.
+ */
 declare const RATE_LIMIT_BUCKETS: Record<string, RateLimitBucket>;
+/**
+ * Map an API path to the appropriate rate-limit bucket.
+ * Google's quota is structured by resource type.
+ */
+declare function resolveBucket(path: string): string;
 declare function createRateLimiter(buckets?: RateLimitBucket[]): RateLimiter;
 
 interface RetryLogEntry {
@@ -52,6 +65,22 @@ interface AppEdit {
     id: string;
     expiryTimeSeconds: string;
 }
+type ChangesInReviewBehavior = "CANCEL_IN_REVIEW_AND_SUBMIT" | "ERROR_IF_IN_REVIEW";
+interface EditCommitOptions {
+    changesNotSentForReview?: boolean;
+    changesInReviewBehavior?: ChangesInReviewBehavior;
+}
+type DeobfuscationFileType = "proguard" | "nativeCode";
+type ProductUpdateLatencyTolerance = "PRODUCT_UPDATE_LATENCY_TOLERANCE_UNSPECIFIED" | "PRODUCT_UPDATE_LATENCY_TOLERANCE_LATENCY_SENSITIVE" | "PRODUCT_UPDATE_LATENCY_TOLERANCE_LATENCY_TOLERANT";
+interface MutationOptions {
+    allowMissing?: boolean;
+    latencyTolerance?: ProductUpdateLatencyTolerance;
+}
+interface ExpansionFile {
+    referencesVersion?: number;
+    fileSize?: string;
+}
+type ExpansionFileType = "main" | "patch";
 interface Track {
     track: string;
     releases: Release[];
@@ -63,6 +92,10 @@ interface Release {
     userFraction?: number;
     releaseNotes?: ReleaseNote[];
     inAppUpdatePriority?: number;
+    countryTargeting?: {
+        countries: string[];
+        includeRestOfWorld: boolean;
+    };
 }
 type ReleaseStatus = "completed" | "draft" | "halted" | "inProgress";
 interface ReleaseNote {
@@ -127,6 +160,10 @@ interface ApkInfo {
         sha256: string;
     };
 }
+interface ApksListResponse {
+    apks: ApkInfo[];
+    kind?: string;
+}
 interface DeobfuscationFile {
     symbolType: string;
 }
@@ -180,6 +217,7 @@ interface ReviewReplyResponse {
 interface ReviewsListOptions {
     token?: string;
     maxResults?: number;
+    startIndex?: number;
     translationLanguage?: string;
 }
 type VitalsMetricSet = "crashRateMetricSet" | "anrRateMetricSet" | "excessiveWakeupRateMetricSet" | "stuckBackgroundWakelockRateMetricSet" | "slowStartRateMetricSet" | "slowRenderingRateMetricSet" | "errorCountMetricSet";
@@ -352,6 +390,10 @@ interface BasePlanMigratePricesRequest {
         oldestAllowedPriceVersionTime?: string;
         priceIncreaseType?: string;
     }[];
+    regionsVersion?: {
+        version?: string;
+    };
+    latencyTolerance?: ProductUpdateLatencyTolerance;
 }
 interface SubscriptionOfferPhase {
     recurrenceCount: number;
@@ -508,12 +550,14 @@ interface SubscriptionDeferResponse {
     newExpiryTimeMillis: string;
 }
 interface VoidedPurchase {
+    kind?: string;
     purchaseToken: string;
     purchaseTimeMillis: string;
     voidedTimeMillis: string;
     orderId: string;
     voidedSource: number;
     voidedReason: number;
+    voidedQuantity?: number;
 }
 interface VoidedPurchasesListResponse {
     voidedPurchases: VoidedPurchase[];
@@ -967,7 +1011,7 @@ interface PlayApiClient {
         insert(packageName: string): Promise<AppEdit>;
         get(packageName: string, editId: string): Promise<AppEdit>;
         validate(packageName: string, editId: string): Promise<AppEdit>;
-        commit(packageName: string, editId: string): Promise<AppEdit>;
+        commit(packageName: string, editId: string, options?: EditCommitOptions): Promise<AppEdit>;
         delete(packageName: string, editId: string): Promise<void>;
     };
     details: {
@@ -977,7 +1021,7 @@ interface PlayApiClient {
     };
     bundles: {
         list(packageName: string, editId: string): Promise<Bundle[]>;
-        upload(packageName: string, editId: string, filePath: string, uploadOptions?: ResumableUploadOptions): Promise<Bundle>;
+        upload(packageName: string, editId: string, filePath: string, uploadOptions?: ResumableUploadOptions, deviceTierConfigId?: string): Promise<Bundle>;
     };
     tracks: {
         list(packageName: string, editId: string): Promise<Track[]>;
@@ -990,6 +1034,8 @@ interface PlayApiClient {
         list(packageName: string, track: string): Promise<ReleaseSummary[]>;
     };
     apks: {
+        list(packageName: string, editId: string): Promise<ApkInfo[]>;
+        upload(packageName: string, editId: string, filePath: string, uploadOptions?: ResumableUploadOptions): Promise<ApkInfo>;
         addExternallyHosted(packageName: string, editId: string, data: ExternallyHostedApk): Promise<ExternallyHostedApkResponse>;
     };
     listings: {
@@ -1006,6 +1052,12 @@ interface PlayApiClient {
         delete(packageName: string, editId: string, language: string, imageType: ImageType, imageId: string): Promise<void>;
         deleteAll(packageName: string, editId: string, language: string, imageType: ImageType): Promise<Image[]>;
     };
+    expansionFiles: {
+        get(packageName: string, editId: string, apkVersionCode: number, expansionFileType: ExpansionFileType): Promise<ExpansionFile>;
+        update(packageName: string, editId: string, apkVersionCode: number, expansionFileType: ExpansionFileType, data: ExpansionFile): Promise<ExpansionFile>;
+        patch(packageName: string, editId: string, apkVersionCode: number, expansionFileType: ExpansionFileType, data: Partial<ExpansionFile>): Promise<ExpansionFile>;
+        upload(packageName: string, editId: string, apkVersionCode: number, expansionFileType: ExpansionFileType, filePath: string): Promise<ExpansionFile>;
+    };
     countryAvailability: {
         get(packageName: string, editId: string, track: string): Promise<CountryAvailability>;
     };
@@ -1024,8 +1076,8 @@ interface PlayApiClient {
             pageSize?: number;
         }): Promise<SubscriptionsListResponse>;
         get(packageName: string, productId: string): Promise<Subscription>;
-        create(packageName: string, data: Subscription, productId?: string): Promise<Subscription>;
-        update(packageName: string, productId: string, data: Subscription, updateMask?: string, regionsVersion?: string): Promise<Subscription>;
+        create(packageName: string, data: Subscription, productId?: string, regionsVersion?: string): Promise<Subscription>;
+        update(packageName: string, productId: string, data: Subscription, updateMask?: string, regionsVersion?: string, options?: MutationOptions): Promise<Subscription>;
         delete(packageName: string, productId: string): Promise<void>;
         batchGet(packageName: string, productIds: string[]): Promise<Subscription[]>;
         batchUpdate(packageName: string, requests: SubscriptionsBatchUpdateRequest): Promise<SubscriptionsBatchUpdateResponse>;
@@ -1035,11 +1087,43 @@ interface PlayApiClient {
         migratePrices(packageName: string, productId: string, basePlanId: string, body: BasePlanMigratePricesRequest): Promise<Subscription>;
         listOffers(packageName: string, productId: string, basePlanId: string): Promise<OffersListResponse>;
         getOffer(packageName: string, productId: string, basePlanId: string, offerId: string): Promise<SubscriptionOffer>;
-        createOffer(packageName: string, productId: string, basePlanId: string, data: SubscriptionOffer, offerId?: string): Promise<SubscriptionOffer>;
-        updateOffer(packageName: string, productId: string, basePlanId: string, offerId: string, data: SubscriptionOffer, updateMask?: string, regionsVersion?: string): Promise<SubscriptionOffer>;
+        createOffer(packageName: string, productId: string, basePlanId: string, data: SubscriptionOffer, offerId?: string, regionsVersion?: string): Promise<SubscriptionOffer>;
+        updateOffer(packageName: string, productId: string, basePlanId: string, offerId: string, data: SubscriptionOffer, updateMask?: string, regionsVersion?: string, options?: MutationOptions): Promise<SubscriptionOffer>;
         deleteOffer(packageName: string, productId: string, basePlanId: string, offerId: string): Promise<void>;
         activateOffer(packageName: string, productId: string, basePlanId: string, offerId: string): Promise<SubscriptionOffer>;
         deactivateOffer(packageName: string, productId: string, basePlanId: string, offerId: string): Promise<SubscriptionOffer>;
+        batchUpdateBasePlanStates(packageName: string, productId: string, requests: {
+            requests: Array<{
+                activateBasePlanRequest?: {
+                    basePlanId: string;
+                };
+                deactivateBasePlanRequest?: {
+                    basePlanId: string;
+                };
+            }>;
+        }): Promise<Subscription>;
+        batchGetOffers(packageName: string, productId: string, basePlanId: string, offerIds: string[]): Promise<{
+            subscriptionOffers: SubscriptionOffer[];
+        }>;
+        batchUpdateOffers(packageName: string, productId: string, basePlanId: string, requests: {
+            requests: Array<{
+                subscriptionOffer: Partial<SubscriptionOffer>;
+                updateMask?: string;
+                regionsVersion?: string;
+            }>;
+        }): Promise<{
+            subscriptionOffers: SubscriptionOffer[];
+        }>;
+        batchUpdateOfferStates(packageName: string, productId: string, basePlanId: string, requests: {
+            requests: Array<{
+                activateSubscriptionOfferRequest?: {
+                    offerId: string;
+                };
+                deactivateSubscriptionOfferRequest?: {
+                    offerId: string;
+                };
+            }>;
+        }): Promise<Subscription>;
     };
     inappproducts: {
         list(packageName: string, options?: {
@@ -1083,6 +1167,8 @@ interface PlayApiClient {
         listVoided(packageName: string, options?: {
             startTime?: string;
             endTime?: string;
+            type?: number;
+            includeQuantityBasedPartialRefund?: boolean;
             maxResults?: number;
             token?: string;
         }): Promise<VoidedPurchasesListResponse>;
@@ -1107,7 +1193,7 @@ interface PlayApiClient {
         update(packageName: string, editId: string, track: string, testers: Testers): Promise<Testers>;
     };
     deobfuscation: {
-        upload(packageName: string, editId: string, versionCode: number, filePath: string): Promise<DeobfuscationFile>;
+        upload(packageName: string, editId: string, versionCode: number, filePath: string, fileType?: DeobfuscationFileType): Promise<DeobfuscationFile>;
     };
     appRecovery: {
         list(packageName: string, versionCode?: number): Promise<AppRecoveryAction[]>;
@@ -1127,16 +1213,30 @@ interface PlayApiClient {
         create(packageName: string, config: DeviceTierConfig): Promise<DeviceTierConfig>;
     };
     oneTimeProducts: {
-        list(packageName: string): Promise<OneTimeProductsListResponse>;
+        list(packageName: string, options?: {
+            pageToken?: string;
+            pageSize?: number;
+        }): Promise<OneTimeProductsListResponse>;
         get(packageName: string, productId: string): Promise<OneTimeProduct>;
-        create(packageName: string, product: OneTimeProduct): Promise<OneTimeProduct>;
-        update(packageName: string, productId: string, product: Partial<OneTimeProduct>, updateMask?: string, regionsVersion?: string): Promise<OneTimeProduct>;
+        create(packageName: string, product: OneTimeProduct, regionsVersion?: string): Promise<OneTimeProduct>;
+        update(packageName: string, productId: string, product: Partial<OneTimeProduct>, updateMask?: string, regionsVersion?: string, options?: MutationOptions): Promise<OneTimeProduct>;
         delete(packageName: string, productId: string): Promise<void>;
         listOffers(packageName: string, productId: string): Promise<OneTimeOffersListResponse>;
         getOffer(packageName: string, productId: string, offerId: string): Promise<OneTimeOffer>;
-        createOffer(packageName: string, productId: string, offer: OneTimeOffer): Promise<OneTimeOffer>;
-        updateOffer(packageName: string, productId: string, offerId: string, offer: Partial<OneTimeOffer>, updateMask?: string, regionsVersion?: string): Promise<OneTimeOffer>;
+        createOffer(packageName: string, productId: string, offer: OneTimeOffer, regionsVersion?: string): Promise<OneTimeOffer>;
+        updateOffer(packageName: string, productId: string, offerId: string, offer: Partial<OneTimeOffer>, updateMask?: string, regionsVersion?: string, options?: MutationOptions): Promise<OneTimeOffer>;
         deleteOffer(packageName: string, productId: string, offerId: string): Promise<void>;
+        batchGet(packageName: string, productIds: string[]): Promise<OneTimeProduct[]>;
+        batchUpdate(packageName: string, requests: {
+            requests: Array<{
+                oneTimeProduct: Partial<OneTimeProduct>;
+                updateMask?: string;
+                regionsVersion?: string;
+            }>;
+        }): Promise<{
+            oneTimeProducts: OneTimeProduct[];
+        }>;
+        batchDelete(packageName: string, productIds: string[]): Promise<void>;
     };
     purchaseOptions: {
         list(packageName: string): Promise<PurchaseOptionsListResponse>;
@@ -1329,4 +1429,4 @@ declare class PlayApiError extends Error {
 /** Files below this threshold use simple upload instead. */
 declare const RESUMABLE_THRESHOLD: number;
 
-export { type Achievement, type Anomaly, type AnomalyDetectionResponse, type ApiClientOptions, type ApiResponse, type ApkInfo, type AppDetails, type AppEdit, type AppRecoveriesListResponse, type AppRecoveryAction, type AppRecoveryTargeting, type BasePlan, type BasePlanMigratePricesRequest, type BatchGetOrdersResponse, type Bundle, type BundleListResponse, type ConvertRegionPricesRequest, type ConvertRegionPricesResponse, type ConvertedRegionPrice, type CountryAvailability, type CreateAppRecoveryActionRequest, type CustomApp, type CustomAppsListResponse, type DataSafety, type DataSafetyDataType, type DataSafetyPurpose, type DeobfuscationFile, type DeobfuscationUploadResponse, type DeveloperComment, type DeveloperPermission, type DeviceGroup, type DeviceSelector, type DeviceTier, type DeviceTierConfig, type DeviceTierConfigsListResponse, type EnterpriseApiClient, type ErrorIssue, type ErrorIssuesResponse, type ErrorReport, type ErrorReportsResponse, type ExternalTransaction, type ExternalTransactionAmount, type ExternalTransactionRefund, type ExternallyHostedApk, type ExternallyHostedApkResponse, type GameEvent, type GamesApiClient, type GeneratedApk, type GeneratedApksPerVersion, type Grant, type GrantsListResponse, type HttpClient, type Image, type ImageType, type ImageUploadResponse, type ImagesDeleteAllResponse, type ImagesListResponse, type InAppProduct, type InAppProductListing, type InAppProductsBatchDeleteRequest, type InAppProductsBatchGetRequest, type InAppProductsBatchUpdateRequest, type InAppProductsBatchUpdateResponse, type InAppProductsListResponse, type InternalAppSharingArtifact, type Leaderboard, type LeaderboardScore, type Listing, type ListingsListResponse, type MetricRow, type MetricSetQuery, type MetricSetResponse, type Money, type OffersListResponse, type OneTimeOffer, type OneTimeOfferRegionalConfig, type OneTimeOffersListResponse, type OneTimeProduct, type OneTimeProductListing, type OneTimeProductsListResponse, type Order, type OrderLineItem, type PagedResponse, type PaginateOptions, type PlayApiClient, PlayApiError, type ProductPurchase, type ProductPurchaseLineItem, type ProductPurchaseV2, type PurchaseOption, type PurchaseOptionsListResponse, RATE_LIMIT_BUCKETS, RESUMABLE_THRESHOLD, type RateLimitBucket, type RateLimiter, type RegionalBasePlanConfig, type Release, type ReleaseNote, type ReleaseStatus, type ReleaseSummary, type ReleasesListResponse, type ReportBucket, type ReportType, type ReportingAggregation, type ReportingApiClient, type ReportingDimension, type ReportsListResponse, type ResumableUploadOptions, type RetryLogEntry, type Review, type ReviewComment, type ReviewReplyRequest, type ReviewReplyResponse, type ReviewsListOptions, type ReviewsListResponse, type StatsDimension, type Subscription, type SubscriptionDeferRequest, type SubscriptionDeferResponse, type SubscriptionListing, type SubscriptionOffer, type SubscriptionOfferPhase, type SubscriptionPurchase, type SubscriptionPurchaseLineItem, type SubscriptionPurchaseV2, type SubscriptionsBatchGetRequest, type SubscriptionsBatchGetResponse, type SubscriptionsBatchUpdateRequest, type SubscriptionsBatchUpdateResponse, type SubscriptionsListResponse, type SubscriptionsV2CancelRequest, type SubscriptionsV2DeferRequest, type SubscriptionsV2DeferResponse, type TaxAndComplianceSettings, type Testers, type TokenPagination, type Track, type TrackListResponse, type UploadProgressEvent, type UploadResponse, type User, type UserComment, type UsersApiClient, type UsersListResponse, type VitalsMetricSet, type VoidedPurchase, type VoidedPurchasesListResponse, createApiClient, createEnterpriseClient, createGamesClient, createHttpClient, createRateLimiter, createReportingClient, createUsersClient, paginate, paginateAll, paginateParallel };
+export { type Achievement, type Anomaly, type AnomalyDetectionResponse, type ApiClientOptions, type ApiResponse, type ApkInfo, type ApksListResponse, type AppDetails, type AppEdit, type AppRecoveriesListResponse, type AppRecoveryAction, type AppRecoveryTargeting, type BasePlan, type BasePlanMigratePricesRequest, type BatchGetOrdersResponse, type Bundle, type BundleListResponse, type ChangesInReviewBehavior, type ConvertRegionPricesRequest, type ConvertRegionPricesResponse, type ConvertedRegionPrice, type CountryAvailability, type CreateAppRecoveryActionRequest, type CustomApp, type CustomAppsListResponse, type DataSafety, type DataSafetyDataType, type DataSafetyPurpose, type DeobfuscationFile, type DeobfuscationFileType, type DeobfuscationUploadResponse, type DeveloperComment, type DeveloperPermission, type DeviceGroup, type DeviceSelector, type DeviceTier, type DeviceTierConfig, type DeviceTierConfigsListResponse, type EditCommitOptions, type EnterpriseApiClient, type ErrorIssue, type ErrorIssuesResponse, type ErrorReport, type ErrorReportsResponse, type ExpansionFile, type ExpansionFileType, type ExternalTransaction, type ExternalTransactionAmount, type ExternalTransactionRefund, type ExternallyHostedApk, type ExternallyHostedApkResponse, type GameEvent, type GamesApiClient, type GeneratedApk, type GeneratedApksPerVersion, type Grant, type GrantsListResponse, type HttpClient, type Image, type ImageType, type ImageUploadResponse, type ImagesDeleteAllResponse, type ImagesListResponse, type InAppProduct, type InAppProductListing, type InAppProductsBatchDeleteRequest, type InAppProductsBatchGetRequest, type InAppProductsBatchUpdateRequest, type InAppProductsBatchUpdateResponse, type InAppProductsListResponse, type InternalAppSharingArtifact, type Leaderboard, type LeaderboardScore, type Listing, type ListingsListResponse, type MetricRow, type MetricSetQuery, type MetricSetResponse, type Money, type MutationOptions, type OffersListResponse, type OneTimeOffer, type OneTimeOfferRegionalConfig, type OneTimeOffersListResponse, type OneTimeProduct, type OneTimeProductListing, type OneTimeProductsListResponse, type Order, type OrderLineItem, type PagedResponse, type PaginateOptions, type PlayApiClient, PlayApiError, type ProductPurchase, type ProductPurchaseLineItem, type ProductPurchaseV2, type ProductUpdateLatencyTolerance, type PurchaseOption, type PurchaseOptionsListResponse, RATE_LIMIT_BUCKETS, RESUMABLE_THRESHOLD, type RateLimitBucket, type RateLimiter, type RegionalBasePlanConfig, type Release, type ReleaseNote, type ReleaseStatus, type ReleaseSummary, type ReleasesListResponse, type ReportBucket, type ReportType, type ReportingAggregation, type ReportingApiClient, type ReportingDimension, type ReportsListResponse, type ResumableUploadOptions, type RetryLogEntry, type Review, type ReviewComment, type ReviewReplyRequest, type ReviewReplyResponse, type ReviewsListOptions, type ReviewsListResponse, type StatsDimension, type Subscription, type SubscriptionDeferRequest, type SubscriptionDeferResponse, type SubscriptionListing, type SubscriptionOffer, type SubscriptionOfferPhase, type SubscriptionPurchase, type SubscriptionPurchaseLineItem, type SubscriptionPurchaseV2, type SubscriptionsBatchGetRequest, type SubscriptionsBatchGetResponse, type SubscriptionsBatchUpdateRequest, type SubscriptionsBatchUpdateResponse, type SubscriptionsListResponse, type SubscriptionsV2CancelRequest, type SubscriptionsV2DeferRequest, type SubscriptionsV2DeferResponse, type TaxAndComplianceSettings, type Testers, type TokenPagination, type Track, type TrackListResponse, type UploadProgressEvent, type UploadResponse, type User, type UserComment, type UsersApiClient, type UsersListResponse, type VitalsMetricSet, type VoidedPurchase, type VoidedPurchasesListResponse, createApiClient, createEnterpriseClient, createGamesClient, createHttpClient, createRateLimiter, createReportingClient, createUsersClient, paginate, paginateAll, paginateParallel, resolveBucket };