@gpc-cli/api 1.0.22 → 1.0.24

package/dist/index.d.ts

@@ -415,18 +415,80 @@ interface SubscriptionPurchaseV2 {
     startTime?: string;
     subscriptionState: string;
     acknowledgementState?: string;
+    linkedPurchaseToken?: string;
+    /** Current offer phase: free trial, introductory price, proration, or base plan price. (Jan 2026) */
+    offerPhase?: string;
+    /** Resubscription context when purchase originates from Play Store. (Nov 2025) */
+    outOfAppPurchaseContext?: {
+        externalTransactionToken?: string;
+    };
+    /** Cancellation details: reason, survey result, time. */
+    canceledStateContext?: {
+        cancelTime?: string;
+        cancelSurveyResult?: {
+            reason?: number;
+            reasonUserInput?: string;
+        };
+        userInitiatedCancellation?: Record<string, unknown>;
+        systemInitiatedCancellation?: Record<string, unknown>;
+        developerInitiatedCancellation?: Record<string, unknown>;
+        replacementCancellation?: Record<string, unknown>;
+    };
+    testPurchase?: Record<string, unknown>;
+    signupPromotion?: {
+        promotionType?: string;
+        promotionCode?: string;
+    };
+    externalAccountIdentifiers?: {
+        externalAccountId?: string;
+        obfuscatedExternalAccountId?: string;
+        obfuscatedExternalProfileId?: string;
+    };
+    pausedStateContext?: {
+        autoResumeTime?: string;
+    };
+    subscribeWithGoogleInfo?: {
+        profileName?: string;
+        emailAddress?: string;
+        givenName?: string;
+        familyName?: string;
+        profileId?: string;
+    };
 }
 interface SubscriptionPurchaseLineItem {
     productId: string;
     expiryTime?: string;
     autoRenewingPlan?: {
         autoRenewEnabled?: boolean;
+        recurringPrice?: Money;
+        priceChangeDetails?: {
+            newPrice?: Money;
+            priceChangeState?: string;
+            expectedNewPriceChargeTime?: string;
+        };
+        /** Price step-up consent details. (Sep 2025) */
+        priceStepUpConsentDetails?: {
+            consentStatus?: string;
+            lastConsentTime?: string;
+        };
     };
     offerDetails?: {
         basePlanId?: string;
         offerId?: string;
         offerTags?: string[];
     };
+    /** Replaces deprecated latestOrderId. (May 2025) */
+    latestSuccessfulOrderId?: string;
+    /** Details about item being replaced, if applicable. (Nov 2025) */
+    itemReplacement?: {
+        productId?: string;
+        offerDetails?: {
+            basePlanId?: string;
+            offerId?: string;
+        };
+    };
+    /** Current offer phase identifier. (Jan 2026) */
+    offerPhase?: string;
 }
 interface SubscriptionPurchase {
     startTimeMillis: string;
@@ -457,6 +519,92 @@ interface VoidedPurchasesListResponse {
     voidedPurchases: VoidedPurchase[];
     tokenPagination?: TokenPagination;
 }
+interface Order {
+    orderId: string;
+    state: string;
+    purchaseToken?: string;
+    createTime?: string;
+    lastEventTime?: string;
+    total?: Money;
+    tax?: Money;
+    lineItems?: OrderLineItem[];
+    buyerAddress?: {
+        regionCode?: string;
+        postalCode?: string;
+    };
+    developerRevenueInBuyerCurrency?: Money;
+    orderHistory?: {
+        processedEvent?: {
+            eventTime?: string;
+        };
+        cancellationEvent?: {
+            eventTime?: string;
+        };
+        refundEvent?: {
+            eventTime?: string;
+            refundDetails?: {
+                tax?: Money;
+                refund?: Money;
+            };
+            refundReason?: string;
+        };
+        partialRefundEvents?: Array<{
+            createTime?: string;
+            processTime?: string;
+            state?: string;
+            refundDetails?: {
+                tax?: Money;
+                refund?: Money;
+            };
+        }>;
+    };
+    /** Offer phase details for prorated periods. (Nov 2025) */
+    offerPhaseDetails?: {
+        offerPhase?: string;
+    };
+}
+interface OrderLineItem {
+    productId?: string;
+    productType?: string;
+    quantity?: number;
+    price?: Money;
+}
+interface BatchGetOrdersResponse {
+    orders: Order[];
+}
+interface ProductPurchaseV2 {
+    kind?: string;
+    productLineItem?: ProductPurchaseLineItem[];
+    purchaseStateContext?: {
+        state?: string;
+    };
+    orderId?: string;
+    regionCode?: string;
+    purchaseCompletionTime?: string;
+    acknowledgementState?: string;
+    obfuscatedExternalAccountId?: string;
+    obfuscatedExternalProfileId?: string;
+    testPurchaseContext?: Record<string, unknown>;
+}
+interface ProductPurchaseLineItem {
+    productId?: string;
+    quantity?: number;
+    offerDetails?: {
+        offerId?: string;
+        offerTags?: string[];
+    };
+}
+interface SubscriptionsV2CancelRequest {
+    cancellationType?: string;
+}
+interface SubscriptionsV2DeferRequest {
+    deferralInfo: {
+        desiredExpiryTime: string;
+    };
+}
+interface SubscriptionsV2DeferResponse {
+    newExpiryTime: string;
+}
 interface ConvertRegionPricesRequest {
     price: Money;
 }
@@ -877,6 +1025,12 @@ interface PlayApiClient {
         deferSubscription(packageName: string, subscriptionId: string, token: string, body: SubscriptionDeferRequest): Promise<SubscriptionDeferResponse>;
         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) */
+        deferSubscriptionV2(packageName: string, token: string, body: SubscriptionsV2DeferRequest): Promise<SubscriptionsV2DeferResponse>;
+        /** V2 product purchase details for multi-offer OTPs. (Jun 2025) */
+        getProductV2(packageName: string, token: string): Promise<ProductPurchaseV2>;
         listVoided(packageName: string, options?: {
             startTime?: string;
             endTime?: string;
@@ -885,9 +1039,12 @@ interface PlayApiClient {
         }): Promise<VoidedPurchasesListResponse>;
     };
     orders: {
+        get(packageName: string, orderId: string): Promise<Order>;
+        batchGet(packageName: string, orderIds: string[]): Promise<Order[]>;
         refund(packageName: string, orderId: string, body?: {
             fullRefund?: boolean;
             proratedRefund?: boolean;
+            revoke?: boolean;
         }): Promise<void>;
     };
     monetization: {
@@ -1123,4 +1280,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 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 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 PagedResponse, type PaginateOptions, type PlayApiClient, PlayApiError, type ProductPurchase, type PurchaseOption, type PurchaseOptionsListResponse, RATE_LIMIT_BUCKETS, RESUMABLE_THRESHOLD, type RateLimitBucket, type RateLimiter, type RegionalBasePlanConfig, type Release, type ReleaseNote, type ReleaseStatus, 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 SubscriptionsListResponse, 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 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 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 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 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 };

package/dist/index.js

@@ -27,6 +27,10 @@ import { resolve, isAbsolute } from "path";
 // src/resumable-upload.ts
 import { open, stat } from "fs/promises";
 var CHUNK_ALIGNMENT = 256 * 1024;
+var GUPLOADER_NO_308_HEADER = "X-GUploader-No-308";
+function isResumeIncomplete(response) {
+  return response.headers.get("X-Http-Status-Code-Override") === "308";
+}
 var DEFAULT_CHUNK_SIZE = 8 * 1024 * 1024;
 var RESUMABLE_THRESHOLD = 5 * 1024 * 1024;
 function envInt(name) {
@@ -214,10 +218,13 @@ async function sendChunk(sessionUri, chunk, contentRange, ctx) {
       headers: {
         Authorization: `Bearer ${token}`,
         "Content-Length": String(chunk.byteLength),
-        "Content-Range": contentRange
+        "Content-Range": contentRange,
+        [GUPLOADER_NO_308_HEADER]: "yes"
       },
       body: chunk,
-      signal: controller.signal
+      signal: controller.signal,
+      redirect: "manual"
+      // Belt-and-suspenders: don't follow redirects even without the header
     });
   } catch {
     return void 0;
@@ -225,6 +232,10 @@ async function sendChunk(sessionUri, chunk, contentRange, ctx) {
     clearTimeout(timer);
   }
   if (response.status === 200 || response.status === 201) {
+    if (isResumeIncomplete(response)) {
+      await response.body?.cancel();
+      return { complete: false };
+    }
     const text = await response.text();
     let data;
     try {
@@ -280,11 +291,13 @@ async function fetchCompletionResponse(sessionUri, totalBytes, ctx) {
       headers: {
         Authorization: `Bearer ${token}`,
         "Content-Length": "0",
-        "Content-Range": `bytes */${totalBytes}`
+        "Content-Range": `bytes */${totalBytes}`,
+        [GUPLOADER_NO_308_HEADER]: "yes"
       },
-      signal: controller.signal
+      signal: controller.signal,
+      redirect: "manual"
     });
-    if (response.status === 200 || response.status === 201) {
+    if ((response.status === 200 || response.status === 201) && !isResumeIncomplete(response)) {
       const text = await response.text();
       let data;
       try {
@@ -313,14 +326,16 @@ async function queryProgress(sessionUri, totalBytes, ctx) {
       headers: {
         Authorization: `Bearer ${token}`,
         "Content-Length": "0",
-        "Content-Range": `bytes */${totalBytes}`
+        "Content-Range": `bytes */${totalBytes}`,
+        [GUPLOADER_NO_308_HEADER]: "yes"
       },
-      signal: controller.signal
+      signal: controller.signal,
+      redirect: "manual"
     });
   } finally {
     clearTimeout(timer);
   }
-  if (response.status === 308) {
+  if (response.status === 308 || isResumeIncomplete(response)) {
     await response.body?.cancel();
     const range = response.headers.get("Range");
     if (range) {
@@ -395,51 +410,183 @@ function envInt2(name) {
 function resolveOption(explicit, envName, fallback) {
   return explicit ?? envInt2(envName) ?? fallback;
 }
+function enhanceApiError(status, body) {
+  let errorMsg = "";
+  try {
+    const parsed = JSON.parse(body);
+    errorMsg = parsed?.error?.message?.toLowerCase() ?? "";
+  } catch {
+    errorMsg = body.toLowerCase();
+  }
+  if ((status === 400 || status === 403) && errorMsg.includes("version code") && errorMsg.includes("already been used")) {
+    const match = errorMsg.match(/version code (\d+)/);
+    const vc = match?.[1] ?? "?";
+    return {
+      code: "API_DUPLICATE_VERSION_CODE",
+      message: `Version code ${vc} has already been uploaded to this app.`,
+      suggestion: [
+        `Increment versionCode in your build.gradle (or build.gradle.kts) and rebuild.`,
+        `Check the current version with: gpc releases status --track production`
+      ].join("\n")
+    };
+  }
+  if ((status === 400 || status === 403) && errorMsg.includes("version code") && (errorMsg.includes("lower") || errorMsg.includes("not allowed") || errorMsg.includes("not greater"))) {
+    return {
+      code: "API_VERSION_CODE_TOO_LOW",
+      message: "Version code is lower than the current version on the target track.",
+      suggestion: [
+        "Google Play requires version codes to increase with each upload.",
+        "Check the current version with: gpc releases status --track <track>",
+        "Then set a higher versionCode in your build.gradle and rebuild."
+      ].join("\n")
+    };
+  }
+  if ((status === 400 || status === 403) && (errorMsg.includes("package name") || errorMsg.includes("applicationid")) && errorMsg.includes("does not match")) {
+    return {
+      code: "API_PACKAGE_NAME_MISMATCH",
+      message: "The package name in the uploaded bundle does not match the target app.",
+      suggestion: [
+        "Verify your applicationId in build.gradle matches the app you're uploading to.",
+        "Check the configured package with: gpc config show",
+        "Or specify explicitly with: --app com.example.yourapp"
+      ].join("\n")
+    };
+  }
+  if (status === 404 && (errorMsg.includes("applicationnotfound") || errorMsg.includes("no application was found") || errorMsg.includes("application not found"))) {
+    return {
+      code: "API_APP_NOT_FOUND",
+      message: "This app was not found in your Google Play developer account.",
+      suggestion: [
+        "Verify the package name is correct.",
+        "Ensure the app has been created in the Google Play Console.",
+        "List available apps with: gpc apps list"
+      ].join("\n")
+    };
+  }
+  if (status === 403 && (errorMsg.includes("permission") || errorMsg.includes("insufficient") || errorMsg.includes("caller does not have"))) {
+    return {
+      code: "API_INSUFFICIENT_PERMISSIONS",
+      message: "The service account does not have permission for this operation.",
+      suggestion: [
+        "In Google Play Console \u2192 Users and permissions \u2192 find your service account email.",
+        "Grant the required permissions (e.g., 'Release to production' for uploads).",
+        "Run gpc doctor to verify your credentials and permissions."
+      ].join("\n")
+    };
+  }
+  if (status === 409) {
+    return {
+      code: "API_EDIT_CONFLICT",
+      message: "An edit conflict occurred \u2014 another edit session is open for this app.",
+      suggestion: [
+        "This usually means another process has an open edit (CI pipeline, Play Console, or another gpc instance).",
+        "Wait a few minutes and retry \u2014 GPC will auto-retry once.",
+        "Or discard the stale edit in the Google Play Console."
+      ].join("\n")
+    };
+  }
+  if (status === 413 || (status === 400 || status === 403) && (errorMsg.includes("too large") || errorMsg.includes("exceeds") && errorMsg.includes("size"))) {
+    return {
+      code: "API_BUNDLE_TOO_LARGE",
+      message: "The uploaded file exceeds Google Play's size limit.",
+      suggestion: [
+        "AAB files must be under 2 GB, APK files under 1 GB.",
+        "Use Android App Bundles (AAB) instead of APK for smaller file sizes.",
+        "Run gpc preflight <file> to check bundle size before uploading."
+      ].join("\n")
+    };
+  }
+  if (status === 400 && (errorMsg.includes("invalid bundle") || errorMsg.includes("invalid apk") || errorMsg.includes("unable to parse") || errorMsg.includes("malformed apk") || errorMsg.includes("malformed bundle"))) {
+    return {
+      code: "API_INVALID_BUNDLE",
+      message: "Google Play rejected the uploaded file as invalid or malformed.",
+      suggestion: [
+        "Ensure the file is a properly signed AAB or APK.",
+        "Common causes: corrupted file, unsigned bundle, wrong file format.",
+        "Run gpc preflight <file> for offline validation.",
+        "Rebuild with: ./gradlew bundleRelease"
+      ].join("\n")
+    };
+  }
+  if (status === 404 && errorMsg.includes("track") && (errorMsg.includes("not found") || errorMsg.includes("does not exist"))) {
+    return {
+      code: "API_TRACK_NOT_FOUND",
+      message: "The specified track does not exist for this app.",
+      suggestion: [
+        "Built-in tracks: internal, alpha, beta, production.",
+        "List custom tracks with: gpc tracks list",
+        "Create a custom track with: gpc tracks create <name>"
+      ].join("\n")
+    };
+  }
+  if (status === 400 && errorMsg.includes("release notes") && (errorMsg.includes("too long") || errorMsg.includes("character limit"))) {
+    return {
+      code: "API_RELEASE_NOTES_TOO_LONG",
+      message: "Release notes exceed the 500-character limit.",
+      suggestion: [
+        "Shorten the release notes to 500 characters or fewer per language.",
+        "Preview current notes with: gpc releases notes get --track <track>"
+      ].join("\n")
+    };
+  }
+  if (status === 400 && (errorMsg.includes("cannot change rollout") || errorMsg.includes("release") && errorMsg.includes("already completed"))) {
+    return {
+      code: "API_ROLLOUT_ALREADY_COMPLETED",
+      message: "The release is already at full rollout (100%) and cannot be changed.",
+      suggestion: [
+        "A completed release cannot have its rollout percentage modified.",
+        "To deploy a new version: gpc releases upload --track <track>"
+      ].join("\n")
+    };
+  }
+  if (status === 400 && errorMsg.includes("edit") && (errorMsg.includes("expired") || errorMsg.includes("failed_precondition"))) {
+    return {
+      code: "API_EDIT_EXPIRED",
+      message: "The edit session has expired.",
+      suggestion: [
+        "Edit sessions last about 1 hour.",
+        "Retry the operation \u2014 GPC will open a fresh edit automatically."
+      ].join("\n")
+    };
+  }
+  return void 0;
+}
 function mapStatusToError(status, body) {
+  const enhanced = enhanceApiError(status, body);
+  if (enhanced) return enhanced;
   switch (status) {
-    case 400: {
-      try {
-        const parsed = JSON.parse(body);
-        if (parsed?.error?.status === "FAILED_PRECONDITION" && parsed.error.message?.toLowerCase().includes("edit")) {
-          return {
-            code: "API_EDIT_EXPIRED",
-            suggestion: "The edit session has expired. Retry the operation to open a fresh edit."
-          };
-        }
-      } catch {
-      }
+    case 400:
       return { code: "API_HTTP_400", suggestion: "Check request parameters and try again." };
-    }
     case 401:
       return {
         code: "API_UNAUTHORIZED",
-        suggestion: "Check that your access token is valid and not expired."
+        suggestion: "Check that your access token is valid and not expired. Run: gpc doctor"
       };
     case 403:
       return {
         code: "API_FORBIDDEN",
-        suggestion: "Ensure the service account has the required permissions for this operation."
+        suggestion: "Ensure the service account has the required permissions. Run: gpc doctor"
       };
     case 404:
       return {
         code: "API_NOT_FOUND",
-        suggestion: "Verify the package name and resource IDs are correct."
+        suggestion: "Verify the package name and resource IDs are correct. Run: gpc apps list"
       };
-    case 409:
+    case 413:
       return {
-        code: "API_EDIT_CONFLICT",
-        suggestion: "Another edit may be in progress. Delete the existing edit and retry."
+        code: "API_BUNDLE_TOO_LARGE",
+        suggestion: "The uploaded file is too large. AAB limit: 2 GB, APK limit: 1 GB."
       };
     case 429:
       return {
         code: "API_RATE_LIMITED",
-        suggestion: "Too many requests. The client will retry automatically."
+        suggestion: "Too many requests. GPC will retry automatically."
       };
     default:
       if (status >= 500) {
         return {
           code: "API_SERVER_ERROR",
-          suggestion: "Google Play API server error. The client will retry automatically."
+          suggestion: "Google Play API server error. GPC will retry automatically."
         };
       }
       return { code: `API_HTTP_${status}` };
@@ -498,12 +645,12 @@ function createHttpClient(options) {
           return { data, status: response.status };
         }
         const errorBody = await response.text();
-        const { code, suggestion } = mapStatusToError(response.status, errorBody);
+        const mapped = mapStatusToError(response.status, errorBody);
         const err = new PlayApiError(
-          `${method} ${path} failed with status ${response.status}: ${sanitizeErrorBody(errorBody)}`,
-          code,
+          mapped.message ?? `${method} ${path} failed with status ${response.status}: ${sanitizeErrorBody(errorBody)}`,
+          mapped.code,
           response.status,
-          suggestion
+          mapped.suggestion
         );
         if (isRetryable(response.status) && attempt < maxRetries) {
           lastError = err;
@@ -619,12 +766,12 @@ function createHttpClient(options) {
           return { data, status: response.status };
         }
         const errorBody = await response.text();
-        const { code, suggestion } = mapStatusToError(response.status, errorBody);
+        const mapped = mapStatusToError(response.status, errorBody);
         const err = new PlayApiError(
-          `POST upload ${path} failed with status ${response.status}: ${sanitizeErrorBody(errorBody)}`,
-          code,
+          mapped.message ?? `Upload failed with status ${response.status}: ${sanitizeErrorBody(errorBody)}`,
+          mapped.code,
           response.status,
-          suggestion
+          mapped.suggestion
         );
         if (isRetryable(response.status) && attempt < maxRetries) {
           lastError = err;
@@ -779,12 +926,12 @@ function createHttpClient(options) {
         });
         if (!response.ok) {
           const errorBody = await response.text();
-          const { code, suggestion } = mapStatusToError(response.status, errorBody);
+          const mapped = mapStatusToError(response.status, errorBody);
           throw new PlayApiError(
-            `GET ${path} failed with status ${response.status}: ${sanitizeErrorBody(errorBody)}`,
-            code,
+            mapped.message ?? `GET ${path} failed with status ${response.status}: ${sanitizeErrorBody(errorBody)}`,
+            mapped.code,
             response.status,
-            suggestion
+            mapped.suggestion
           );
         }
         return await response.arrayBuffer();
@@ -1235,6 +1382,25 @@ function createApiClient(options) {
       async refundSubscriptionV2(packageName, token) {
         await http.post(`/${packageName}/purchases/subscriptionsv2/tokens/${token}:refund`);
       },
+      async cancelSubscriptionV2(packageName, token, body) {
+        await http.post(
+          `/${packageName}/purchases/subscriptionsv2/tokens/${token}:cancel`,
+          body
+        );
+      },
+      async deferSubscriptionV2(packageName, token, body) {
+        const { data } = await http.post(
+          `/${packageName}/purchases/subscriptionsv2/tokens/${token}:defer`,
+          body
+        );
+        return data;
+      },
+      async getProductV2(packageName, token) {
+        const { data } = await http.get(
+          `/${packageName}/purchases/productsv2/tokens/${token}`
+        );
+        return data;
+      },
       async listVoided(packageName, options2) {
         await rateLimit(limiter, "voidedBurst");
         await rateLimit(limiter, "voidedDaily");
@@ -1252,6 +1418,19 @@ function createApiClient(options) {
       }
     },
     orders: {
+      async get(packageName, orderId) {
+        const { data } = await http.get(
+          `/${packageName}/orders/${orderId}`
+        );
+        return data;
+      },
+      async batchGet(packageName, orderIds) {
+        const { data } = await http.post(
+          `/${packageName}/orders:batchGet`,
+          { orderIds }
+        );
+        return data.orders || [];
+      },
       async refund(packageName, orderId, body) {
         await http.post(`/${packageName}/orders/${orderId}:refund`, body);
       }
@@ -1686,23 +1865,26 @@ function createUsersClient(options) {
 var GAMES_BASE_URL = "https://games.googleapis.com/games/v1";
 function createGamesClient(options) {
   const http = createHttpClient({ ...options, baseUrl: GAMES_BASE_URL });
+  function qs(params) {
+    return new URLSearchParams(params).toString();
+  }
   return {
     leaderboards: {
       async list(packageName) {
         const { data } = await http.get(
-          `/leaderboards?applicationId=${packageName}`
+          `/leaderboards?${qs({ applicationId: packageName })}`
         );
         return data;
       },
       async get(packageName, leaderboardId) {
         const { data } = await http.get(
-          `/leaderboards/${leaderboardId}?applicationId=${packageName}`
+          `/leaderboards/${encodeURIComponent(leaderboardId)}?${qs({ applicationId: packageName })}`
         );
         return data;
       },
       async getScores(packageName, leaderboardId, collection, timeSpan) {
         const { data } = await http.get(
-          `/leaderboards/${leaderboardId}/scores/${collection}?timeSpan=${timeSpan}&applicationId=${packageName}`
+          `/leaderboards/${encodeURIComponent(leaderboardId)}/scores/${encodeURIComponent(collection)}?${qs({ timeSpan, applicationId: packageName })}`
         );
         return data;
       }
@@ -1710,13 +1892,13 @@ function createGamesClient(options) {
     achievements: {
       async list(packageName) {
         const { data } = await http.get(
-          `/achievements?applicationId=${packageName}`
+          `/achievements?${qs({ applicationId: packageName })}`
         );
         return data;
       },
       async reveal(packageName, achievementId) {
         const { data } = await http.post(
-          `/achievements/${achievementId}/reveal?applicationId=${packageName}`,
+          `/achievements/${encodeURIComponent(achievementId)}/reveal?${qs({ applicationId: packageName })}`,
           {}
         );
         return data;
@@ -1725,7 +1907,7 @@ function createGamesClient(options) {
     events: {
       async list(packageName) {
         const { data } = await http.get(
-          `/events?applicationId=${packageName}`
+          `/events?${qs({ applicationId: packageName })}`
         );
         return data;
       }