@gpc-cli/api 1.0.27 → 1.0.29

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 — 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.
+215 endpoints across edits, releases, tracks, listings, subscriptions, in-app products, purchases, reviews, vitals, reports, users, and testers. Built-in rate limiting, retry logic, and pagination.
 
 ## Install
 
@@ -19,204 +19,53 @@ import { resolveAuth } from "@gpc-cli/auth";
 const auth = await resolveAuth({
   serviceAccountPath: "./service-account.json",
 });
-
 const client = createApiClient({ auth });
 
-// List all tracks
 const edit = await client.edits.insert("com.example.app");
 const tracks = await client.tracks.list("com.example.app", edit.id);
 console.log(tracks);
-
 await client.edits.delete("com.example.app", edit.id);
 ```
 
 ## Client Factories
 
-| Factory                          | Purpose                                                            |
-| -------------------------------- | ------------------------------------------------------------------ |
-| `createApiClient(options)`       | Core Play API -- apps, releases, listings, monetization, purchases |
-| `createReportingClient(options)` | Vitals, crash rates, ANR, error reporting                          |
-| `createUsersClient(options)`     | Developer account users and permission grants                      |
-| `createHttpClient(options)`      | Low-level HTTP with auth, retry, and rate limiting                 |
-
-All factories accept `ApiClientOptions`:
+| Factory                          | Purpose                                                          |
+| -------------------------------- | ---------------------------------------------------------------- |
+| `createApiClient(options)`       | Core Play API: apps, releases, listings, monetization, purchases |
+| `createReportingClient(options)` | Vitals, crash rates, ANR, error reporting                        |
+| `createUsersClient(options)`     | Developer account users and permission grants                    |
+| `createHttpClient(options)`      | Low-level HTTP with auth, retry, and rate limiting               |
 
 ```typescript
-import type { ApiClientOptions } from "@gpc-cli/api";
-
 const options: ApiClientOptions = {
   auth, // Required: { getAccessToken(): Promise<string> }
   maxRetries: 3, // Default retry count
   timeout: 30_000, // Request timeout in ms
-  rateLimiter: undefined, // Optional custom rate limiter
-  onRetry: (entry) => console.warn(`Retry #${entry.attempt}: ${entry.error}`),
+  onRetry: (entry) => console.warn(`Retry #${entry.attempt}`),
 };
 ```
 
-## API Modules
-
-### Edits
-
-Every modification to app metadata, tracks, or listings requires an edit session.
-
-```typescript
-const edit = await client.edits.insert("com.example.app");
-
-// ... make changes within the edit ...
+## Common Workflows
 
-await client.edits.validate("com.example.app", edit.id);
-await client.edits.commit("com.example.app", edit.id);
-```
-
-### Bundles
+### Upload and release
 
 ```typescript
 const edit = await client.edits.insert("com.example.app");
-const bundle = await client.bundles.upload("com.example.app", edit.id, "./app.aab");
-const bundles = await client.bundles.list("com.example.app", edit.id);
-await client.edits.commit("com.example.app", edit.id);
-```
-
-### Tracks & Releases
-
-```typescript
-const edit = await client.edits.insert("com.example.app");
-
-const tracks = await client.tracks.list("com.example.app", edit.id);
-const production = await client.tracks.get("com.example.app", edit.id, "production");
-
-await client.tracks.update("com.example.app", edit.id, "production", {
+await client.bundles.upload("com.example.app", edit.id, "./app.aab");
+await client.tracks.update("com.example.app", edit.id, "beta", {
   versionCodes: ["42"],
-  status: "inProgress",
-  userFraction: 0.1,
+  status: "completed",
   releaseNotes: [{ language: "en-US", text: "Bug fixes" }],
 });
-
-await client.edits.commit("com.example.app", edit.id);
-```
-
-### Listings
-
-```typescript
-const edit = await client.edits.insert("com.example.app");
-
-const listings = await client.listings.list("com.example.app", edit.id);
-const en = await client.listings.get("com.example.app", edit.id, "en-US");
-
-await client.listings.update("com.example.app", edit.id, "en-US", {
-  title: "My App",
-  shortDescription: "A great app",
-  fullDescription: "Full description here...",
-});
-
-await client.edits.commit("com.example.app", edit.id);
-```
-
-### Images
-
-```typescript
-const edit = await client.edits.insert("com.example.app");
-
-const screenshots = await client.images.list(
-  "com.example.app",
-  edit.id,
-  "en-US",
-  "phoneScreenshots",
-);
-
-await client.images.upload("com.example.app", edit.id, "en-US", "featureGraphic", "./feature.png");
-
-await client.images.deleteAll("com.example.app", edit.id, "en-US", "phoneScreenshots");
 await client.edits.commit("com.example.app", edit.id);
 ```
 
-Image types: `phoneScreenshots`, `sevenInchScreenshots`, `tenInchScreenshots`, `tvScreenshots`, `wearScreenshots`, `icon`, `featureGraphic`, `tvBanner`.
-
-### Subscriptions
-
-```typescript
-const { subscriptions } = await client.subscriptions.list("com.example.app");
-const sub = await client.subscriptions.get("com.example.app", "premium_monthly");
-
-await client.subscriptions.activateBasePlan("com.example.app", "premium_monthly", "p1m");
-await client.subscriptions.deactivateBasePlan("com.example.app", "premium_monthly", "p1m");
-```
-
-### Subscription Offers
-
-```typescript
-const { subscriptionOffers } = await client.subscriptions.listOffers(
-  "com.example.app",
-  "premium_monthly",
-  "p1m",
-);
-
-const offer = await client.subscriptions.getOffer(
-  "com.example.app",
-  "premium_monthly",
-  "p1m",
-  "intro_offer",
-);
-
-await client.subscriptions.activateOffer(
-  "com.example.app",
-  "premium_monthly",
-  "p1m",
-  "intro_offer",
-);
-```
-
-### In-App Products
-
-```typescript
-const { inappproduct } = await client.inappproducts.list("com.example.app");
-const product = await client.inappproducts.get("com.example.app", "coins_100");
-
-await client.inappproducts.create("com.example.app", {
-  sku: "coins_500",
-  status: "active",
-  purchaseType: "managedUser",
-  defaultPrice: { currencyCode: "USD", units: "4", nanos: 990_000_000 },
-});
-```
-
-### Purchases
-
-```typescript
-// Verify a product purchase
-const purchase = await client.purchases.getProduct("com.example.app", "coins_100", purchaseToken);
-
-// Acknowledge it
-await client.purchases.acknowledgeProduct("com.example.app", "coins_100", purchaseToken);
-
-// Verify a subscription (v2)
-const sub = await client.purchases.getSubscriptionV2("com.example.app", purchaseToken);
-
-// List voided purchases
-const { voidedPurchases } = await client.purchases.listVoided("com.example.app", {
-  startTime: "1700000000000",
-  maxResults: 100,
-});
-```
-
-### Reviews
-
-```typescript
-const { reviews } = await client.reviews.list("com.example.app", { maxResults: 50 });
-const review = await client.reviews.get("com.example.app", reviewId);
-await client.reviews.reply("com.example.app", reviewId, "Thanks for the feedback!");
-```
-
-### Vitals & Error Reporting
-
-Uses a separate client that targets the Play Developer Reporting API.
+### Query crash rates
 
 ```typescript
 import { createReportingClient } from "@gpc-cli/api";
 
 const reporting = createReportingClient({ auth });
-
-// Query crash rate
 const crashes = await reporting.queryMetricSet("com.example.app", "crashRateMetricSet", {
   metrics: ["crashRate", "userPerceivedCrashRate"],
   timelineSpec: {
@@ -225,75 +74,52 @@ const crashes = await reporting.queryMetricSet("com.example.app", "crashRateMetr
     endTime: { year: 2026, month: 3, day: 1 },
   },
 });
-
-// Detect anomalies
-const { anomalies } = await reporting.getAnomalies("com.example.app");
-
-// Search error issues
-const { errorIssues } = await reporting.searchErrorIssues("com.example.app");
-```
-
-Available metric sets: `crashRateMetricSet`, `anrRateMetricSet`, `excessiveWakeupRateMetricSet`, `stuckBackgroundWakelockRateMetricSet`, `slowStartRateMetricSet`, `slowRenderingRateMetricSet`, `errorCountMetricSet`.
-
-### Reports
-
-```typescript
-const { reports } = await client.reports.list("com.example.app", "earnings", 2026, 2);
 ```
 
-Report types: `earnings`, `sales`, `estimated_sales`, `installs`, `crashes`, `ratings`, `reviews`, `store_performance`, `subscriptions`, `play_balance`.
-
-### Users & Grants
-
-Uses a separate client for developer account management.
+### Manage subscriptions
 
 ```typescript
-import { createUsersClient } from "@gpc-cli/api";
-
-const users = createUsersClient({ auth });
-
-const { users: devUsers } = await users.list(developerId);
-const user = await users.get(developerId, userId);
-
-await users.create(developerId, {
-  email: "dev@example.com",
-  developerAccountPermission: ["CAN_MANAGE_PUBLIC_APKS", "CAN_REPLY_TO_REVIEWS"],
-});
-```
-
-### Testers
-
-```typescript
-const edit = await client.edits.insert("com.example.app");
-const testers = await client.testers.get("com.example.app", edit.id, "internal");
-
-await client.testers.update("com.example.app", edit.id, "internal", {
-  googleGroups: ["testers@example.com"],
-});
-
-await client.edits.commit("com.example.app", edit.id);
-```
-
-### Monetization
-
-```typescript
-const { convertedRegionPrices } = await client.monetization.convertRegionPrices("com.example.app", {
-  price: { currencyCode: "USD", units: "9", nanos: 990_000_000 },
-});
+const { subscriptions } = await client.subscriptions.list("com.example.app");
+await client.subscriptions.activateBasePlan("com.example.app", "premium_monthly", "p1m");
 ```
 
-### Deobfuscation
-
-```typescript
-const edit = await client.edits.insert("com.example.app");
-await client.deobfuscation.upload("com.example.app", edit.id, 42, "./mapping.txt");
-await client.edits.commit("com.example.app", edit.id);
-```
+### Verify purchases
+
+```typescript
+const purchase = await client.purchases.getProduct("com.example.app", "coins_100", token);
+await client.purchases.acknowledgeProduct("com.example.app", "coins_100", token);
+```
+
+## All API Modules
+
+| Module                        | Methods                                                                                   |
+| ----------------------------- | ----------------------------------------------------------------------------------------- |
+| `client.edits`                | insert, get, validate, commit, delete                                                     |
+| `client.bundles`              | upload, list                                                                              |
+| `client.tracks`               | list, get, update                                                                         |
+| `client.listings`             | list, get, update, delete, deleteAll                                                      |
+| `client.images`               | list, upload, delete, deleteAll                                                           |
+| `client.subscriptions`        | list, get, create, patch, archive, activate/deactivate base plans and offers              |
+| `client.inappproducts`        | list, get, create, update, delete, batchGet, batchUpdate, batchDelete                     |
+| `client.oneTimeProducts`      | list, get, create, patch, delete, batchGet, batchUpdate, batchDelete                      |
+| `client.purchases`            | getProduct, acknowledgeProduct, getSubscriptionV2, revokeSubscription, refund, listVoided |
+| `client.reviews`              | list, get, reply                                                                          |
+| `client.testers`              | get, update                                                                               |
+| `client.reports`              | list                                                                                      |
+| `client.monetization`         | convertRegionPrices                                                                       |
+| `client.deobfuscation`        | upload                                                                                    |
+| `client.expansionFiles`       | get, update, patch, upload                                                                |
+| `client.dataSafety`           | get, update                                                                               |
+| `client.deviceTiers`          | list, get, create                                                                         |
+| `client.internalSharing`      | uploadBundle, uploadApk                                                                   |
+| `client.generatedApks`        | list, download                                                                            |
+| `client.externalTransactions` | create, get, refund                                                                       |
+| `client.appRecovery`          | create, deploy, cancel, list                                                              |
+| `reporting.*`                 | queryMetricSet, getAnomalies, searchErrorIssues, searchErrorReports                       |
+| `users.*`                     | list, get, create, patch, delete, listGrants, createGrant, patchGrant, deleteGrant        |
 
 ## Pagination
 
-Built-in helpers for paginated endpoints:
-
 ```typescript
 import { paginateAll } from "@gpc-cli/api";
 
@@ -309,9 +135,27 @@ const allReviews = await paginateAll(async (pageToken) => {
 });
 ```
 
+## Error Handling
+
+API errors throw `ApiError` with a code, HTTP status, and actionable suggestion. Retries are automatic for 429 and 5xx with exponential backoff and jitter.
+
+```typescript
+import { ApiError } from "@gpc-cli/api";
+
+try {
+  await client.tracks.get("com.example.app", editId, "production");
+} catch (error) {
+  if (error instanceof ApiError) {
+    console.error(error.code); // "API_NOT_FOUND"
+    console.error(error.statusCode); // 404
+    console.error(error.suggestion); // actionable fix
+  }
+}
+```
+
 ## Type Exports
 
-All Google Play API types are exported for use in your own code:
+All Google Play API types are exported:
 
 ```typescript
 import type {
@@ -342,31 +186,11 @@ import type {
 } from "@gpc-cli/api";
 ```
 
-## Error Handling
-
-API errors throw `ApiError` with a code, HTTP status, and actionable suggestion:
-
-```typescript
-import { ApiError } from "@gpc-cli/api";
-
-try {
-  await client.tracks.get("com.example.app", editId, "production");
-} catch (error) {
-  if (error instanceof ApiError) {
-    console.error(error.code); // e.g. "API_NOT_FOUND"
-    console.error(error.statusCode); // e.g. 404
-    console.error(error.suggestion); // actionable fix
-    console.error(error.toJSON()); // structured error object
-  }
-}
-```
-
-Retries are automatic for 429 (rate limit) and 5xx errors with exponential backoff and jitter.
-
 ## Documentation
 
 - [Full documentation](https://yasserstudio.github.io/gpc/)
-- [SDK usage guide](https://yasserstudio.github.io/gpc/advanced/sdk-usage.html)
+- [SDK usage guide](https://yasserstudio.github.io/gpc/advanced/sdk-usage)
+- [API coverage map](https://yasserstudio.github.io/gpc/reference/api-coverage)
 
 ## License
 

package/dist/index.d.ts

@@ -395,6 +395,27 @@ interface BasePlanMigratePricesRequest {
     };
     latencyTolerance?: ProductUpdateLatencyTolerance;
 }
+interface BatchMigratePricesRequest {
+    requests: {
+        packageName: string;
+        productId: string;
+        basePlanId: string;
+        regionalPriceMigrations: {
+            regionCode: string;
+            oldestAllowedPriceVersionTime?: string;
+            priceIncreaseType?: string;
+        }[];
+        regionsVersion?: {
+            version?: string;
+        };
+        latencyTolerance?: ProductUpdateLatencyTolerance;
+    }[];
+}
+interface BatchMigratePricesResponse {
+    responses: {
+        subscription?: Subscription;
+    }[];
+}
 interface SubscriptionOfferPhase {
     recurrenceCount: number;
     duration: string;
@@ -888,14 +909,26 @@ interface TaxAndComplianceSettings {
 interface OneTimeOffer {
     packageName: string;
     productId: string;
+    purchaseOptionId: string;
     offerId: string;
-    regionalConfigs: Record<string, OneTimeOfferRegionalConfig>;
+    state?: "DRAFT" | "ACTIVE" | "CANCELLED" | "INACTIVE";
+    regionalPricingAndAvailabilityConfigs?: Record<string, OneTimeOfferRegionalConfig>;
+    /** @deprecated Use regionalPricingAndAvailabilityConfigs instead */
+    regionalConfigs?: Record<string, OneTimeOfferRegionalConfig>;
     otherRegionsConfig?: {
         usdPrice: {
             units: string;
             nanos?: number;
         };
     };
+    offerTags?: Array<{
+        tag: string;
+    }>;
+    regionsVersion?: {
+        version: string;
+    };
+    preOrderOffer?: Record<string, unknown>;
+    discountedOffer?: Record<string, unknown>;
 }
 interface OneTimeOfferRegionalConfig {
     price: {
@@ -910,25 +943,25 @@ interface OneTimeProductsListResponse {
     nextPageToken?: string;
 }
 interface OneTimeOffersListResponse {
-    oneTimeOffers: OneTimeOffer[];
+    oneTimeProductOffers?: OneTimeOffer[];
+    /** @deprecated Use oneTimeProductOffers */
+    oneTimeOffers?: OneTimeOffer[];
     nextPageToken?: string;
 }
-interface PurchaseOption {
-    packageName: string;
-    productId: string;
-    purchaseOptionId: string;
-    stateInfo?: {
-        activeState?: Record<string, unknown>;
-        inactiveState?: Record<string, unknown>;
-    };
-    listings?: Record<string, {
-        title: string;
-        description?: string;
-    }>;
+interface SystemApkDeviceSpec {
+    supportedAbis?: string[];
+    supportedLocales?: string[];
+    screenDensity?: number;
 }
-interface PurchaseOptionsListResponse {
-    purchaseOptions: PurchaseOption[];
-    nextPageToken?: string;
+interface SystemApkOptions {
+    uncompressedNativeLibraries?: boolean;
+    uncompressedDexFiles?: boolean;
+    rotated?: boolean;
+}
+interface SystemApkVariant {
+    variantId?: number;
+    deviceSpec?: SystemApkDeviceSpec;
+    options?: SystemApkOptions;
 }
 interface InAppProductsBatchUpdateRequest {
     requests: {
@@ -972,7 +1005,7 @@ interface ReleaseSummary {
     activeArtifacts?: {
         versionCode: number;
     }[];
-    releaseLifecycleState?: 'RELEASE_LIFECYCLE_STATE_UNSPECIFIED' | 'DRAFT' | 'NOT_SENT_FOR_REVIEW' | 'IN_REVIEW' | 'APPROVED_NOT_PUBLISHED' | 'NOT_APPROVED' | 'PUBLISHED';
+    releaseLifecycleState?: "RELEASE_LIFECYCLE_STATE_UNSPECIFIED" | "DRAFT" | "NOT_SENT_FOR_REVIEW" | "IN_REVIEW" | "APPROVED_NOT_PUBLISHED" | "NOT_APPROVED" | "PUBLISHED";
 }
 interface ReleasesListResponse {
     releases: ReleaseSummary[];
@@ -1085,6 +1118,7 @@ interface PlayApiClient {
         deactivateBasePlan(packageName: string, productId: string, basePlanId: string): Promise<Subscription>;
         deleteBasePlan(packageName: string, productId: string, basePlanId: string): Promise<void>;
         migratePrices(packageName: string, productId: string, basePlanId: string, body: BasePlanMigratePricesRequest): Promise<Subscription>;
+        batchMigratePrices(packageName: string, productId: string, body: BatchMigratePricesRequest): Promise<BatchMigratePricesResponse>;
         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, regionsVersion?: string): Promise<SubscriptionOffer>;
@@ -1138,6 +1172,10 @@ interface PlayApiClient {
             autoConvertMissingPrices?: boolean;
             allowMissing?: boolean;
         }): Promise<InAppProduct>;
+        patch(packageName: string, sku: string, data: Partial<InAppProduct>, options?: {
+            autoConvertMissingPrices?: boolean;
+            latencyTolerance?: string;
+        }): Promise<InAppProduct>;
         delete(packageName: string, sku: string): Promise<void>;
         batchUpdate(packageName: string, requests: InAppProductsBatchUpdateRequest): Promise<InAppProductsBatchUpdateResponse>;
         batchGet(packageName: string, skus: string[]): Promise<InAppProduct[]>;
@@ -1157,7 +1195,6 @@ interface PlayApiClient {
             developerPayload?: string;
         }): Promise<void>;
         revokeSubscriptionV2(packageName: string, token: string): Promise<void>;
-        refundSubscriptionV2(packageName: string, token: string): Promise<void>;
         /** V2 cancel with cancellationType support. (Sep 2025) */
         cancelSubscriptionV2(packageName: string, token: string, body?: SubscriptionsV2CancelRequest): Promise<void>;
         /** V2 defer for subscriptions with add-ons. (Jan 2026) */
@@ -1191,6 +1228,7 @@ interface PlayApiClient {
     testers: {
         get(packageName: string, editId: string, track: string): Promise<Testers>;
         update(packageName: string, editId: string, track: string, testers: Testers): Promise<Testers>;
+        patch(packageName: string, editId: string, track: string, testers: Partial<Testers>): Promise<Testers>;
     };
     deobfuscation: {
         upload(packageName: string, editId: string, versionCode: number, filePath: string, fileType?: DeobfuscationFileType): Promise<DeobfuscationFile>;
@@ -1221,11 +1259,11 @@ interface PlayApiClient {
         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, 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>;
+        listOffers(packageName: string, productId: string, purchaseOptionId?: string): Promise<OneTimeOffersListResponse>;
+        getOffer(packageName: string, productId: string, purchaseOptionId: string, offerId: string): Promise<OneTimeOffer>;
+        createOffer(packageName: string, productId: string, purchaseOptionId: string, offer: OneTimeOffer, regionsVersion?: string): Promise<OneTimeOffer>;
+        updateOffer(packageName: string, productId: string, purchaseOptionId: string, offerId: string, offer: Partial<OneTimeOffer>, updateMask?: string, regionsVersion?: string, options?: MutationOptions): Promise<OneTimeOffer>;
+        deleteOffer(packageName: string, productId: string, purchaseOptionId: string, offerId: string): Promise<void>;
         batchGet(packageName: string, productIds: string[]): Promise<OneTimeProduct[]>;
         batchUpdate(packageName: string, requests: {
             requests: Array<{
@@ -1237,13 +1275,63 @@ interface PlayApiClient {
             oneTimeProducts: OneTimeProduct[];
         }>;
         batchDelete(packageName: string, productIds: string[]): Promise<void>;
-    };
-    purchaseOptions: {
-        list(packageName: string): Promise<PurchaseOptionsListResponse>;
-        get(packageName: string, purchaseOptionId: string): Promise<PurchaseOption>;
-        create(packageName: string, data: PurchaseOption): Promise<PurchaseOption>;
-        activate(packageName: string, purchaseOptionId: string): Promise<PurchaseOption>;
-        deactivate(packageName: string, purchaseOptionId: string): Promise<PurchaseOption>;
+        batchDeletePurchaseOptions(packageName: string, productId: string, requests: Array<{
+            packageName: string;
+            productId: string;
+            purchaseOptionId: string;
+            force?: boolean;
+            latencyTolerance?: string;
+        }>): Promise<void>;
+        batchUpdatePurchaseOptionStates(packageName: string, productId: string, requests: Array<{
+            activatePurchaseOptionRequest?: {
+                packageName: string;
+                productId: string;
+                purchaseOptionId: string;
+                latencyTolerance?: string;
+            };
+            deactivatePurchaseOptionRequest?: {
+                packageName: string;
+                productId: string;
+                purchaseOptionId: string;
+                latencyTolerance?: string;
+            };
+        }>): Promise<{
+            oneTimeProducts: OneTimeProduct[];
+        }>;
+        cancelOffer(packageName: string, productId: string, purchaseOptionId: string, offerId: string, latencyTolerance?: string): Promise<OneTimeOffer>;
+        batchGetOffers(packageName: string, productId: string, purchaseOptionId: string, requests: Array<{
+            packageName: string;
+            productId: string;
+            purchaseOptionId: string;
+            offerId: string;
+        }>): Promise<{
+            oneTimeProductOffers: OneTimeOffer[];
+        }>;
+        batchUpdateOffers(packageName: string, productId: string, purchaseOptionId: string, requests: Array<{
+            oneTimeProductOffer: Partial<OneTimeOffer>;
+            updateMask?: string;
+            regionsVersion?: {
+                version: string;
+            };
+            allowMissing?: boolean;
+            latencyTolerance?: string;
+        }>): Promise<{
+            oneTimeProductOffers: OneTimeOffer[];
+        }>;
+        batchUpdateOfferStates(packageName: string, productId: string, purchaseOptionId: string, requests: Array<{
+            activateOneTimeProductOfferRequest?: Record<string, unknown>;
+            deactivateOneTimeProductOfferRequest?: Record<string, unknown>;
+            cancelOneTimeProductOfferRequest?: Record<string, unknown>;
+        }>): Promise<{
+            oneTimeProductOffers: OneTimeOffer[];
+        }>;
+        batchDeleteOffers(packageName: string, productId: string, purchaseOptionId: string, requests: Array<{
+            packageName: string;
+            productId: string;
+            purchaseOptionId: string;
+            offerId: string;
+            latencyTolerance?: string;
+        }>): Promise<void>;
     };
     internalAppSharing: {
         uploadBundle(packageName: string, bundlePath: string): Promise<InternalAppSharingArtifact>;
@@ -1253,6 +1341,14 @@ interface PlayApiClient {
         list(packageName: string, versionCode: number): Promise<GeneratedApk[]>;
         download(packageName: string, versionCode: number, id: string): Promise<ArrayBuffer>;
     };
+    systemApks: {
+        create(packageName: string, versionCode: number, variant: SystemApkVariant): Promise<SystemApkVariant>;
+        list(packageName: string, versionCode: number): Promise<{
+            variants: SystemApkVariant[];
+        }>;
+        get(packageName: string, versionCode: number, variantId: number): Promise<SystemApkVariant>;
+        download(packageName: string, versionCode: number, variantId: number): Promise<ArrayBuffer>;
+    };
 }
 declare function createApiClient(options: ApiClientOptions): PlayApiClient;
 
@@ -1273,11 +1369,11 @@ interface UsersApiClient {
         pageToken?: string;
         pageSize?: number;
     }): Promise<UsersListResponse>;
-    get(developerId: string, userId: string): Promise<User>;
     create(developerId: string, user: Partial<User>): Promise<User>;
     update(developerId: string, userId: string, user: Partial<User>, updateMask?: string): Promise<User>;
     delete(developerId: string, userId: string): Promise<void>;
     grants: {
+        /** Not in official API reference but may work as an undocumented endpoint. */
         list(developerId: string, email: string): Promise<GrantsListResponse>;
         create(developerId: string, email: string, grant: Partial<Grant>): Promise<Grant>;
         patch(developerId: string, email: string, packageName: string, grant: Partial<Grant>, updateMask?: string): Promise<Grant>;
@@ -1429,4 +1525,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 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 };
+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 BatchMigratePricesRequest, type BatchMigratePricesResponse, 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, 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 SystemApkDeviceSpec, type SystemApkOptions, type SystemApkVariant, 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 };