@gpc-cli/api 1.0.25 → 1.0.27

package/dist/index.js

@@ -549,6 +549,31 @@ function enhanceApiError(status, body) {
       ].join("\n")
     };
   }
+  if ((status === 403 || status === 400) && (errorMsg.includes("changes not sent for review") || errorMsg.includes("changesnotsentforreview") || errorMsg.includes("review") && errorMsg.includes("rejected"))) {
+    return {
+      code: "API_CHANGES_NOT_SENT_FOR_REVIEW",
+      message: "This app has a rejected update. The API requires explicit acknowledgement before committing changes.",
+      suggestion: [
+        "Add --changes-not-sent-for-review to your command:",
+        "  gpc releases upload app.aab --track internal --changes-not-sent-for-review",
+        "",
+        "This applies your changes without sending them for review.",
+        "You must manually send for review from the Google Play Console when ready."
+      ].join("\n")
+    };
+  }
+  if (status === 400 && (errorMsg.includes("changes_already_in_review") || errorMsg.includes("already in review"))) {
+    return {
+      code: "API_CHANGES_ALREADY_IN_REVIEW",
+      message: "Changes are already in review. Committing this edit would cancel the existing review.",
+      suggestion: [
+        "Wait for the current review to complete, or re-run without --error-if-in-review",
+        "to cancel the existing review and submit new changes.",
+        "",
+        "To prevent accidental review cancellation in CI, keep --error-if-in-review."
+      ].join("\n")
+    };
+  }
   return void 0;
 }
 function mapStatusToError(status, body) {
@@ -733,7 +758,8 @@ function createHttpClient(options) {
     return Math.max(timeout, 3e4 + Math.ceil(sizeMb) * 1e3);
   }
   async function uploadRequest(path, filePath, contentType, baseUrl = UPLOAD_BASE_URL) {
-    const url = `${baseUrl}${path}`;
+    const separator = path.includes("?") ? "&" : "?";
+    const url = `${baseUrl}${path}${separator}uploadType=media`;
     const safeFilePath = validateFilePath(filePath);
     const fileBuffer = await readFile(safeFilePath);
     const effectiveTimeout = computeUploadTimeout(fileBuffer.byteLength);
@@ -942,13 +968,104 @@ function createHttpClient(options) {
   };
 }
 
+// src/rate-limiter.ts
+var RATE_LIMIT_BUCKETS = {
+  edits: { name: "edits", maxTokens: 3e3, refillRate: 3e3, refillIntervalMs: 6e4 },
+  purchases: { name: "purchases", maxTokens: 3e3, refillRate: 3e3, refillIntervalMs: 6e4 },
+  reviews: { name: "reviews", maxTokens: 3e3, refillRate: 3e3, refillIntervalMs: 6e4 },
+  reporting: { name: "reporting", maxTokens: 3e3, refillRate: 3e3, refillIntervalMs: 6e4 },
+  monetization: { name: "monetization", maxTokens: 3e3, refillRate: 3e3, refillIntervalMs: 6e4 },
+  default: { name: "default", maxTokens: 3e3, refillRate: 3e3, refillIntervalMs: 6e4 }
+};
+function resolveBucket(path) {
+  if (path.includes("/edits/") || path.includes("/edits:")) return "edits";
+  if (path.includes("/purchases/") || path.includes("/orders")) return "purchases";
+  if (path.includes("/reviews")) return "reviews";
+  if (path.includes("playdeveloperreporting") || path.includes("MetricSet") || path.includes("anomalies")) return "reporting";
+  if (path.includes("/inappproducts") || path.includes("/oneTimeProducts") || path.includes("/subscriptions") || path.includes("/monetization")) return "monetization";
+  return "default";
+}
+function createRateLimiter(buckets) {
+  const states = /* @__PURE__ */ new Map();
+  const effectiveBuckets = buckets ?? Object.values(RATE_LIMIT_BUCKETS);
+  for (const bucket of effectiveBuckets) {
+    states.set(bucket.name, {
+      tokens: bucket.maxTokens,
+      lastRefillTime: Date.now(),
+      config: bucket
+    });
+  }
+  return {
+    async acquire(bucket) {
+      const state = states.get(bucket);
+      if (!state) return;
+      const now = Date.now();
+      const elapsed = now - state.lastRefillTime;
+      const refill = Math.floor(
+        elapsed / state.config.refillIntervalMs * state.config.refillRate
+      );
+      if (refill > 0) {
+        state.tokens = Math.min(state.config.maxTokens, state.tokens + refill);
+        state.lastRefillTime = now;
+      }
+      if (state.tokens > 0) {
+        state.tokens--;
+        return;
+      }
+      const tokensNeeded = 1;
+      const waitMs = Math.ceil(
+        tokensNeeded / state.config.refillRate * state.config.refillIntervalMs
+      );
+      await new Promise((r) => setTimeout(r, waitMs));
+      const afterWait = Date.now();
+      const totalElapsed = afterWait - state.lastRefillTime;
+      const newTokens = Math.floor(
+        totalElapsed / state.config.refillIntervalMs * state.config.refillRate
+      );
+      state.tokens = Math.max(0, Math.min(state.config.maxTokens, newTokens) - 1);
+      state.lastRefillTime = afterWait;
+    }
+  };
+}
+
 // src/client.ts
-async function rateLimit(limiter, bucket) {
-  if (limiter) await limiter.acquire(bucket);
+var DEFAULT_REGIONS_VERSION = "2022/02";
+function applyMutationOptions(params, options) {
+  if (options?.allowMissing) params["allowMissing"] = "true";
+  if (options?.latencyTolerance) params["latencyTolerance"] = options.latencyTolerance;
+}
+async function autoRateLimit(limiter, path) {
+  if (!limiter) return;
+  const bucket = resolveBucket(path);
+  await limiter.acquire(bucket);
 }
 function createApiClient(options) {
-  const http = createHttpClient(options);
-  const limiter = options.rateLimiter || void 0;
+  const rawHttp = createHttpClient(options);
+  const defaultLimiter = createRateLimiter();
+  const limiter = options.rateLimiter || defaultLimiter;
+  const http = {
+    ...rawHttp,
+    async get(path, params) {
+      await autoRateLimit(limiter, path);
+      return rawHttp.get(path, params);
+    },
+    async post(path, body) {
+      await autoRateLimit(limiter, path);
+      return rawHttp.post(path, body);
+    },
+    async put(path, body) {
+      await autoRateLimit(limiter, path);
+      return rawHttp.put(path, body);
+    },
+    async patch(path, body) {
+      await autoRateLimit(limiter, path);
+      return rawHttp.patch(path, body);
+    },
+    async delete(path) {
+      await autoRateLimit(limiter, path);
+      return rawHttp.delete(path);
+    }
+  };
   return {
     edits: {
       async insert(packageName) {
@@ -963,8 +1080,15 @@ function createApiClient(options) {
         const { data } = await http.post(`/${packageName}/edits/${editId}:validate`);
         return data;
       },
-      async commit(packageName, editId) {
-        const { data } = await http.post(`/${packageName}/edits/${editId}:commit`);
+      async commit(packageName, editId, options2) {
+        let path = `/${packageName}/edits/${editId}:commit`;
+        if (options2?.changesNotSentForReview || options2?.changesInReviewBehavior) {
+          const params = new URLSearchParams();
+          if (options2.changesNotSentForReview) params.set("changesNotSentForReview", "true");
+          if (options2.changesInReviewBehavior) params.set("changesInReviewBehavior", options2.changesInReviewBehavior);
+          path += `?${params.toString()}`;
+        }
+        const { data } = await http.post(path);
         return data;
       },
       async delete(packageName, editId) {
@@ -998,9 +1122,13 @@ function createApiClient(options) {
         );
         return data.bundles;
       },
-      async upload(packageName, editId, filePath, uploadOptions) {
+      async upload(packageName, editId, filePath, uploadOptions, deviceTierConfigId) {
+        let bundlePath = `/${packageName}/edits/${editId}/bundles`;
+        if (deviceTierConfigId) {
+          bundlePath += `?${new URLSearchParams({ deviceTierConfigId }).toString()}`;
+        }
         const { data } = await http.uploadResumable(
-          `/${packageName}/edits/${editId}/bundles`,
+          bundlePath,
           filePath,
           "application/octet-stream",
           uploadOptions
@@ -1057,6 +1185,29 @@ function createApiClient(options) {
       }
     },
     apks: {
+      async list(packageName, editId) {
+        const { data } = await http.get(
+          `/${packageName}/edits/${editId}/apks`
+        );
+        return data.apks || [];
+      },
+      async upload(packageName, editId, filePath, uploadOptions) {
+        const { data } = await http.uploadResumable(
+          `/${packageName}/edits/${editId}/apks`,
+          filePath,
+          "application/vnd.android.package-archive",
+          uploadOptions
+        );
+        if (!data || !data.versionCode) {
+          throw new PlayApiError(
+            "Upload succeeded but no APK data returned",
+            "API_EMPTY_RESPONSE",
+            200,
+            "This is unexpected. Retry the upload or contact Google Play support if the issue persists."
+          );
+        }
+        return data;
+      },
       async addExternallyHosted(packageName, editId, apkData) {
         const { data } = await http.post(
           `/${packageName}/edits/${editId}/apks/externallyHosted`,
@@ -1134,6 +1285,36 @@ function createApiClient(options) {
         return data.deleted || [];
       }
     },
+    expansionFiles: {
+      async get(packageName, editId, apkVersionCode, expansionFileType) {
+        const { data } = await http.get(
+          `/${packageName}/edits/${editId}/apks/${apkVersionCode}/expansionFiles/${expansionFileType}`
+        );
+        return data;
+      },
+      async update(packageName, editId, apkVersionCode, expansionFileType, body) {
+        const { data } = await http.put(
+          `/${packageName}/edits/${editId}/apks/${apkVersionCode}/expansionFiles/${expansionFileType}`,
+          body
+        );
+        return data;
+      },
+      async patch(packageName, editId, apkVersionCode, expansionFileType, body) {
+        const { data } = await http.patch(
+          `/${packageName}/edits/${editId}/apks/${apkVersionCode}/expansionFiles/${expansionFileType}`,
+          body
+        );
+        return data;
+      },
+      async upload(packageName, editId, apkVersionCode, expansionFileType, filePath) {
+        const { data } = await http.upload(
+          `/${packageName}/edits/${editId}/apks/${apkVersionCode}/expansionFiles/${expansionFileType}`,
+          filePath,
+          "application/octet-stream"
+        );
+        return data.expansionFile;
+      }
+    },
     countryAvailability: {
       async get(packageName, editId, track) {
         const { data } = await http.get(
@@ -1154,10 +1335,10 @@ function createApiClient(options) {
     },
     reviews: {
       async list(packageName, options2) {
-        await rateLimit(limiter, "reviewsGet");
         const params = {};
         if (options2?.token) params["token"] = options2.token;
         if (options2?.maxResults) params["maxResults"] = String(options2.maxResults);
+        if (options2?.startIndex !== void 0) params["startIndex"] = String(options2.startIndex);
         if (options2?.translationLanguage)
           params["translationLanguage"] = options2.translationLanguage;
         const hasParams = Object.keys(params).length > 0;
@@ -1168,7 +1349,6 @@ function createApiClient(options) {
         return data;
       },
       async get(packageName, reviewId, translationLanguage) {
-        await rateLimit(limiter, "reviewsGet");
         const params = {};
         if (translationLanguage) params["translationLanguage"] = translationLanguage;
         const hasParams = Object.keys(params).length > 0;
@@ -1179,7 +1359,6 @@ function createApiClient(options) {
         return data;
       },
       async reply(packageName, reviewId, replyText) {
-        await rateLimit(limiter, "reviewsPost");
         const body = { replyText };
         const { data } = await http.post(
           `/${packageName}/reviews/${reviewId}:reply`,
@@ -1204,18 +1383,19 @@ function createApiClient(options) {
         const { data } = await http.get(`/${packageName}/subscriptions/${productId}`);
         return data;
       },
-      async create(packageName, body, productId) {
+      async create(packageName, body, productId, regionsVersion) {
         const params = {};
         if (productId) params["productId"] = productId;
-        params["regionsVersion.version"] = "2022/02";
+        params["regionsVersion.version"] = regionsVersion || DEFAULT_REGIONS_VERSION;
         const path = `/${packageName}/subscriptions?${new URLSearchParams(params).toString()}`;
         const { data } = await http.post(path, body);
         return data;
       },
-      async update(packageName, productId, body, updateMask, regionsVersion) {
+      async update(packageName, productId, body, updateMask, regionsVersion, options2) {
         const params = {};
         if (updateMask) params["updateMask"] = updateMask;
-        params["regionsVersion.version"] = regionsVersion || "2022/02";
+        params["regionsVersion.version"] = regionsVersion || DEFAULT_REGIONS_VERSION;
+        applyMutationOptions(params, options2);
         const path = `/${packageName}/subscriptions/${productId}?${new URLSearchParams(params).toString()}`;
         const { data } = await http.patch(path, body);
         return data;
@@ -1271,18 +1451,19 @@ function createApiClient(options) {
         );
         return data;
       },
-      async createOffer(packageName, productId, basePlanId, body, offerId) {
+      async createOffer(packageName, productId, basePlanId, body, offerId, regionsVersion) {
         const params = {};
         if (offerId) params["offerId"] = offerId;
-        params["regionsVersion.version"] = "2022/02";
+        params["regionsVersion.version"] = regionsVersion || DEFAULT_REGIONS_VERSION;
         const path = `/${packageName}/subscriptions/${productId}/basePlans/${basePlanId}/offers?${new URLSearchParams(params).toString()}`;
         const { data } = await http.post(path, body);
         return data;
       },
-      async updateOffer(packageName, productId, basePlanId, offerId, body, updateMask, regionsVersion) {
+      async updateOffer(packageName, productId, basePlanId, offerId, body, updateMask, regionsVersion, options2) {
         const params = {};
         if (updateMask) params["updateMask"] = updateMask;
-        params["regionsVersion.version"] = regionsVersion || "2022/02";
+        params["regionsVersion.version"] = regionsVersion || DEFAULT_REGIONS_VERSION;
+        applyMutationOptions(params, options2);
         const path = `/${packageName}/subscriptions/${productId}/basePlans/${basePlanId}/offers/${offerId}?${new URLSearchParams(params).toString()}`;
         const { data } = await http.patch(path, body);
         return data;
@@ -1303,6 +1484,34 @@ function createApiClient(options) {
           `/${packageName}/subscriptions/${productId}/basePlans/${basePlanId}/offers/${offerId}:deactivate`
         );
         return data;
+      },
+      async batchUpdateBasePlanStates(packageName, productId, requests) {
+        const { data } = await http.post(
+          `/${packageName}/subscriptions/${productId}/basePlans:batchUpdateStates`,
+          requests
+        );
+        return data;
+      },
+      async batchGetOffers(packageName, productId, basePlanId, offerIds) {
+        const { data } = await http.post(
+          `/${packageName}/subscriptions/${productId}/basePlans/${basePlanId}/offers:batchGet`,
+          { requests: offerIds.map((id) => ({ offerId: id })) }
+        );
+        return data;
+      },
+      async batchUpdateOffers(packageName, productId, basePlanId, requests) {
+        const { data } = await http.post(
+          `/${packageName}/subscriptions/${productId}/basePlans/${basePlanId}/offers:batchUpdate`,
+          requests
+        );
+        return data;
+      },
+      async batchUpdateOfferStates(packageName, productId, basePlanId, requests) {
+        const { data } = await http.post(
+          `/${packageName}/subscriptions/${productId}/basePlans/${basePlanId}/offers:batchUpdateStates`,
+          requests
+        );
+        return data;
       }
     },
     inappproducts: {
@@ -1443,11 +1652,11 @@ function createApiClient(options) {
         return data;
       },
       async listVoided(packageName, options2) {
-        await rateLimit(limiter, "voidedBurst");
-        await rateLimit(limiter, "voidedDaily");
         const params = {};
         if (options2?.startTime) params["startTime"] = options2.startTime;
         if (options2?.endTime) params["endTime"] = options2.endTime;
+        if (options2?.type !== void 0) params["type"] = String(options2.type);
+        if (options2?.includeQuantityBasedPartialRefund) params["includeQuantityBasedPartialRefund"] = "true";
         if (options2?.maxResults) params["maxResults"] = String(options2.maxResults);
         if (options2?.token) params["token"] = options2.token;
         const hasParams = Object.keys(params).length > 0;
@@ -1510,9 +1719,10 @@ function createApiClient(options) {
       }
     },
     deobfuscation: {
-      async upload(packageName, editId, versionCode, filePath) {
+      async upload(packageName, editId, versionCode, filePath, fileType) {
+        const deobType = fileType || "proguard";
         const { data } = await http.upload(
-          `/${packageName}/edits/${editId}/apks/${versionCode}/deobfuscationFiles/proguard`,
+          `/${packageName}/edits/${editId}/apks/${versionCode}/deobfuscationFiles/${deobType}`,
           filePath,
           "application/octet-stream"
         );
@@ -1603,9 +1813,14 @@ function createApiClient(options) {
       }
     },
     oneTimeProducts: {
-      async list(packageName) {
+      async list(packageName, options2) {
+        const params = {};
+        if (options2?.pageToken) params["pageToken"] = options2.pageToken;
+        if (options2?.pageSize) params["pageSize"] = String(options2.pageSize);
+        const hasParams = Object.keys(params).length > 0;
         const { data } = await http.get(
-          `/${packageName}/oneTimeProducts`
+          `/${packageName}/oneTimeProducts`,
+          hasParams ? params : void 0
         );
         return data;
       },
@@ -1615,18 +1830,19 @@ function createApiClient(options) {
         );
         return data;
       },
-      async create(packageName, body) {
-        const params = new URLSearchParams({ "regionsVersion.version": "2022/02" });
+      async create(packageName, body, regionsVersion) {
+        const params = new URLSearchParams({ "regionsVersion.version": regionsVersion || DEFAULT_REGIONS_VERSION });
         const { data } = await http.post(
           `/${packageName}/oneTimeProducts?${params.toString()}`,
           body
         );
         return data;
       },
-      async update(packageName, productId, body, updateMask, regionsVersion) {
+      async update(packageName, productId, body, updateMask, regionsVersion, options2) {
         const params = {};
         if (updateMask) params["updateMask"] = updateMask;
-        params["regionsVersion.version"] = regionsVersion || "2022/02";
+        params["regionsVersion.version"] = regionsVersion || DEFAULT_REGIONS_VERSION;
+        applyMutationOptions(params, options2);
         const path = `/${packageName}/oneTimeProducts/${productId}?${new URLSearchParams(params).toString()}`;
         const { data } = await http.patch(path, body);
         return data;
@@ -1646,23 +1862,45 @@ function createApiClient(options) {
         );
         return data;
       },
-      async createOffer(packageName, productId, body) {
+      async createOffer(packageName, productId, body, regionsVersion) {
+        const params = new URLSearchParams({ "regionsVersion.version": regionsVersion || DEFAULT_REGIONS_VERSION });
         const { data } = await http.post(
-          `/${packageName}/oneTimeProducts/${productId}/offers`,
+          `/${packageName}/oneTimeProducts/${productId}/offers?${params.toString()}`,
           body
         );
         return data;
       },
-      async updateOffer(packageName, productId, offerId, body, updateMask, regionsVersion) {
+      async updateOffer(packageName, productId, offerId, body, updateMask, regionsVersion, options2) {
         const params = {};
         if (updateMask) params["updateMask"] = updateMask;
-        params["regionsVersion.version"] = regionsVersion || "2022/02";
+        params["regionsVersion.version"] = regionsVersion || DEFAULT_REGIONS_VERSION;
+        applyMutationOptions(params, options2);
         const path = `/${packageName}/oneTimeProducts/${productId}/offers/${offerId}?${new URLSearchParams(params).toString()}`;
         const { data } = await http.patch(path, body);
         return data;
       },
       async deleteOffer(packageName, productId, offerId) {
         await http.delete(`/${packageName}/oneTimeProducts/${productId}/offers/${offerId}`);
+      },
+      async batchGet(packageName, productIds) {
+        const params = productIds.map((id) => `productIds=${encodeURIComponent(id)}`).join("&");
+        const { data } = await http.get(
+          `/${packageName}/oneTimeProducts:batchGet?${params}`
+        );
+        return data.oneTimeProducts || [];
+      },
+      async batchUpdate(packageName, requests) {
+        const { data } = await http.post(
+          `/${packageName}/oneTimeProducts:batchUpdate`,
+          requests
+        );
+        return data;
+      },
+      async batchDelete(packageName, productIds) {
+        await http.post(
+          `/${packageName}/oneTimeProducts:batchDelete`,
+          { requests: productIds.map((id) => ({ productId: id })) }
+        );
       }
     },
     purchaseOptions: {
@@ -1727,69 +1965,6 @@ function createApiClient(options) {
   };
 }
 
-// src/rate-limiter.ts
-var RATE_LIMIT_BUCKETS = {
-  default: { name: "default", maxTokens: 200, refillRate: 200, refillIntervalMs: 1e3 },
-  reviewsGet: { name: "reviewsGet", maxTokens: 200, refillRate: 200, refillIntervalMs: 36e5 },
-  reviewsPost: {
-    name: "reviewsPost",
-    maxTokens: 2e3,
-    refillRate: 2e3,
-    refillIntervalMs: 864e5
-  },
-  voidedBurst: { name: "voidedBurst", maxTokens: 30, refillRate: 30, refillIntervalMs: 3e4 },
-  voidedDaily: {
-    name: "voidedDaily",
-    maxTokens: 6e3,
-    refillRate: 6e3,
-    refillIntervalMs: 864e5
-  },
-  reporting: { name: "reporting", maxTokens: 10, refillRate: 10, refillIntervalMs: 1e3 }
-};
-function createRateLimiter(buckets) {
-  const states = /* @__PURE__ */ new Map();
-  if (buckets) {
-    for (const bucket of buckets) {
-      states.set(bucket.name, {
-        tokens: bucket.maxTokens,
-        lastRefillTime: Date.now(),
-        config: bucket
-      });
-    }
-  }
-  return {
-    async acquire(bucket) {
-      const state = states.get(bucket);
-      if (!state) return;
-      const now = Date.now();
-      const elapsed = now - state.lastRefillTime;
-      const refill = Math.floor(
-        elapsed / state.config.refillIntervalMs * state.config.refillRate
-      );
-      if (refill > 0) {
-        state.tokens = Math.min(state.config.maxTokens, state.tokens + refill);
-        state.lastRefillTime = now;
-      }
-      if (state.tokens > 0) {
-        state.tokens--;
-        return;
-      }
-      const tokensNeeded = 1;
-      const waitMs = Math.ceil(
-        tokensNeeded / state.config.refillRate * state.config.refillIntervalMs
-      );
-      await new Promise((r) => setTimeout(r, waitMs));
-      const afterWait = Date.now();
-      const totalElapsed = afterWait - state.lastRefillTime;
-      const newTokens = Math.floor(
-        totalElapsed / state.config.refillIntervalMs * state.config.refillRate
-      );
-      state.tokens = Math.min(state.config.maxTokens, newTokens) - 1;
-      state.lastRefillTime = afterWait;
-    }
-  };
-}
-
 // src/reporting-client.ts
 var REPORTING_BASE_URL = "https://playdeveloperreporting.googleapis.com/v1beta1";
 function createReportingClient(options) {
@@ -2038,6 +2213,7 @@ export {
   createUsersClient,
   paginate,
   paginateAll,
-  paginateParallel
+  paginateParallel,
+  resolveBucket
 };
 //# sourceMappingURL=index.js.map