pabal-store-api-mcp 1.3.10 → 1.3.13

package/dist/src/core/services/app-store-service.d.ts

@@ -7,6 +7,10 @@ interface AppStoreAppInfo {
     name?: string;
     supportedLocales?: string[];
 }
+export declare function resolveAppStoreLocales(allLocales: string[], requestedLocales?: string[]): {
+    localesToPush: string[];
+    missingLocales: string[];
+};
 /**
  * App Store-facing service layer that wraps client creation and common operations.
  * Keeps MCP tools independent from client factories and SDK details.
@@ -26,12 +30,14 @@ export declare class AppStoreService {
     updateReleaseNotes(bundleId: string, releaseNotes: Record<string, string>, versionId?: string, supportedLocales?: string[]): Promise<ServiceResult<UpdatedReleaseNotesResult>>;
     pullReleaseNotes(bundleId: string): Promise<ServiceResult<AppStoreReleaseNote[]>>;
     createVersion(bundleId: string, versionString: string, autoIncrement?: boolean): Promise<ServiceResult<CreatedAppStoreVersion>>;
-    pushAsoData({ config, bundleId, localAsoData, appStoreDataPath, uploadImages, slug, }: {
+    pushAsoData({ config, bundleId, localAsoData, appStoreDataPath, uploadImages, locales, imageUploadTimeoutMs, slug, }: {
         config: EnvConfig;
         bundleId?: string;
         localAsoData: AsoData;
         appStoreDataPath: string;
         uploadImages?: boolean;
+        locales?: string[];
+        imageUploadTimeoutMs?: number;
         slug?: string;
     }): Promise<PushAsoResult>;
     verifyAuth(expirationSeconds?: number): Promise<VerifyAuthResult<{

package/dist/src/core/services/app-store-service.js

@@ -6,6 +6,16 @@ import { verifyAppStoreAuth } from "../../packages/stores/app-store/verify-auth.
 import { createAppStoreClient } from "../../core/clients/app-store-factory.js";
 import { parseAppStoreScreenshots, hasScreenshots, APP_STORE_DEVICE_TYPES, } from "../../core/helpers/screenshot-helpers.js";
 import { checkPushPrerequisites, serviceFailure, toServiceResult, updateRegisteredLocales, } from "./service-helpers.js";
+export function resolveAppStoreLocales(allLocales, requestedLocales) {
+    if (!requestedLocales?.length) {
+        return { localesToPush: allLocales, missingLocales: [] };
+    }
+    const requested = new Set(requestedLocales);
+    return {
+        localesToPush: allLocales.filter((locale) => requested.has(locale)),
+        missingLocales: requestedLocales.filter((locale) => !allLocales.includes(locale)),
+    };
+}
 /**
  * App Store-facing service layer that wraps client creation and common operations.
  * Keeps MCP tools independent from client factories and SDK details.
@@ -163,7 +173,7 @@ export class AppStoreService {
             return serviceFailure(AppError.wrap(error, HTTP_STATUS.INTERNAL_SERVER_ERROR, ERROR_CODES.APP_STORE_CREATE_VERSION_FAILED, "Failed to create App Store version"));
         }
     }
-    async pushAsoData({ config, bundleId, localAsoData, appStoreDataPath, uploadImages = false, slug, }) {
+    async pushAsoData({ config, bundleId, localAsoData, appStoreDataPath, uploadImages = false, locales, imageUploadTimeoutMs, slug, }) {
         const skip = checkPushPrerequisites({
             storeLabel: "App Store",
             configured: Boolean(config.appStore),
@@ -181,9 +191,20 @@ export class AppStoreService {
         console.error(`[MCP]     Bundle ID: ${bundleId}`);
         try {
             // Push locale data (supportUrl/marketingUrl already set by prepareAsoDataForPush)
-            const localesToPush = Object.keys(appStoreData.locales);
+            const allLocales = Object.keys(appStoreData.locales);
+            const { localesToPush, missingLocales } = resolveAppStoreLocales(allLocales, locales);
+            if (missingLocales.length) {
+                console.error(`[AppStore]   ⚠️  Requested locale(s) not found in local ASO data: ${missingLocales.join(", ")}`);
+            }
+            if (localesToPush.length === 0) {
+                return {
+                    success: false,
+                    error: AppError.validation(ERROR_CODES.APP_STORE_ASO_DATA_EMPTY, "No matching App Store locales found to push"),
+                };
+            }
             const failedFieldsList = [];
-            for (const [locale, localeData] of Object.entries(appStoreData.locales)) {
+            for (const locale of localesToPush) {
+                const localeData = appStoreData.locales[locale];
                 console.error(`[AppStore]   📤 Pushing ${locale}...`);
                 const localeResult = await client.pushAsoData(localeData);
                 if (localeResult.failedFields && localeResult.failedFields.length > 0) {
@@ -279,6 +300,7 @@ export class AppStoreService {
                         const uploadResult = await client.uploadScreenshotsForLocale({
                             locale,
                             screenshots: screenshotsToUpload,
+                            imageUploadTimeoutMs,
                         });
                         if (uploadResult.failed > 0) {
                             throw new Error(`Screenshot upload reported ${uploadResult.failed} failed files`);
@@ -335,7 +357,6 @@ export class AppStoreService {
                     const version = await client.createNewVersionWithAutoIncrement();
                     const versionId = version.id;
                     const versionString = version.attributes?.versionString ?? "";
-                    const locales = Object.keys(appStoreData.locales);
                     console.error(`[AppStore]   ✅ New version ${versionString} created.`);
                     return {
                         success: false,
@@ -344,7 +365,7 @@ export class AppStoreService {
                         versionInfo: {
                             versionId,
                             versionString,
-                            locales,
+                            locales: Object.keys(appStoreData.locales),
                         },
                     };
                 }

package/dist/src/core/services/google-play-service.d.ts

@@ -6,6 +6,14 @@ interface GooglePlayAppInfo {
     name?: string;
     supportedLocales?: string[];
 }
+export declare function resolveGooglePlayLocales(allLocales: string[], requestedLocales?: string[]): {
+    localesToPush: string[];
+    missingLocales: string[];
+};
+export declare function shouldPushGooglePlayAppDetails({ hasContactDetails, requestedLocales, }: {
+    hasContactDetails: boolean;
+    requestedLocales?: string[];
+}): boolean;
 /**
  * Google Play-facing service layer that wraps client creation and common operations.
  * Keeps MCP tools independent from client factories and SDK details.
@@ -21,12 +29,14 @@ export declare class GooglePlayService {
     updateReleaseNotes(packageName: string, releaseNotes: Record<string, string>, track?: string, supportedLocales?: string[]): Promise<ServiceResult<UpdatedReleaseNotesResult>>;
     pullReleaseNotes(packageName: string): Promise<ServiceResult<GooglePlayReleaseNote[]>>;
     createVersion(packageName: string, versionString: string, versionCodes: number[]): Promise<ServiceResult<CreatedGooglePlayVersion>>;
-    pushAsoData({ config, packageName, localAsoData, googlePlayDataPath, uploadImages, slug, }: {
+    pushAsoData({ config, packageName, localAsoData, googlePlayDataPath, uploadImages, locales, imageUploadTimeoutMs, slug, }: {
         config: EnvConfig;
         packageName?: string;
         localAsoData: AsoData;
         googlePlayDataPath: string;
         uploadImages?: boolean;
+        locales?: string[];
+        imageUploadTimeoutMs?: number;
         slug?: string;
     }): Promise<PushAsoResult>;
     verifyAuth(): Promise<VerifyAuthResult<{

package/dist/src/core/services/google-play-service.js

@@ -6,6 +6,20 @@ import { verifyPlayStoreAuth } from "../../packages/stores/play-store/verify-aut
 import { createGooglePlayClient } from "../../core/clients/google-play-factory.js";
 import { parseGooglePlayScreenshots, hasScreenshots, } from "../../core/helpers/screenshot-helpers.js";
 import { checkPushPrerequisites, serviceFailure, toServiceResult, updateRegisteredLocales, } from "./service-helpers.js";
+const GOOGLE_PLAY_SCREENSHOT_LOCALE_BATCH_SIZE = 5;
+export function resolveGooglePlayLocales(allLocales, requestedLocales) {
+    if (!requestedLocales?.length) {
+        return { localesToPush: allLocales, missingLocales: [] };
+    }
+    const requested = new Set(requestedLocales);
+    return {
+        localesToPush: allLocales.filter((locale) => requested.has(locale)),
+        missingLocales: requestedLocales.filter((locale) => !allLocales.includes(locale)),
+    };
+}
+export function shouldPushGooglePlayAppDetails({ hasContactDetails, requestedLocales, }) {
+    return hasContactDetails && !requestedLocales?.length;
+}
 /**
  * Google Play-facing service layer that wraps client creation and common operations.
  * Keeps MCP tools independent from client factories and SDK details.
@@ -148,7 +162,7 @@ export class GooglePlayService {
             return serviceFailure(AppError.wrap(error, HTTP_STATUS.INTERNAL_SERVER_ERROR, ERROR_CODES.GOOGLE_PLAY_CREATE_VERSION_FAILED, "Failed to create Google Play version"));
         }
     }
-    async pushAsoData({ config, packageName, localAsoData, googlePlayDataPath, uploadImages = false, slug, }) {
+    async pushAsoData({ config, packageName, localAsoData, googlePlayDataPath, uploadImages = false, locales, imageUploadTimeoutMs, slug, }) {
         const skip = checkPushPrerequisites({
             storeLabel: "Google Play",
             configured: Boolean(config.playStore),
@@ -165,14 +179,35 @@ export class GooglePlayService {
         console.error(`[MCP]   📤 Pushing to Google Play...`);
         console.error(`[MCP]     Package: ${packageName}`);
         try {
-            const localesToPush = Object.keys(googlePlayData.locales);
+            const allLocales = Object.keys(googlePlayData.locales);
+            const { localesToPush, missingLocales } = resolveGooglePlayLocales(allLocales, locales);
+            if (missingLocales.length) {
+                console.error(`[GooglePlay]   ⚠️  Requested locale(s) not found in local ASO data: ${missingLocales.join(", ")}`);
+            }
+            if (localesToPush.length === 0) {
+                return {
+                    success: false,
+                    error: AppError.validation(ERROR_CODES.GOOGLE_PLAY_ASO_DATA_EMPTY, "No matching Google Play locales found to push"),
+                };
+            }
             for (const locale of localesToPush) {
                 console.error(`[GooglePlay]   📤 Preparing locale: ${locale}`);
             }
             // Push locale data as-is from aso-data.json
-            await client.pushMultilingualAsoData(googlePlayData);
-            // Push app-level contact information
-            if (googlePlayData.contactEmail || googlePlayData.contactWebsite) {
+            await client.pushMultilingualAsoData({
+                ...googlePlayData,
+                locales: Object.fromEntries(localesToPush.map((locale) => [
+                    locale,
+                    googlePlayData.locales[locale],
+                ])),
+            });
+            // Push app-level contact information once for full pushes. Partial locale
+            // pushes are commonly batched, and repeating details edits can invalidate
+            // otherwise-successful listing commits on Google Play.
+            if (shouldPushGooglePlayAppDetails({
+                hasContactDetails: Boolean(googlePlayData.contactEmail || googlePlayData.contactWebsite),
+                requestedLocales: locales,
+            })) {
                 console.error(`[GooglePlay]   📤 Pushing app details...`);
                 await client.pushAppDetails({
                     contactEmail: googlePlayData.contactEmail,
@@ -180,6 +215,9 @@ export class GooglePlayService {
                 });
                 console.error(`[GooglePlay]   ✅ App details uploaded successfully`);
             }
+            else if (locales?.length) {
+                console.error(`[GooglePlay]   ⏭️  Skipping app details for partial locale push`);
+            }
             // Upload screenshots if enabled
             if (uploadImages && slug) {
                 console.error(`[GooglePlay]   📤 Uploading screenshots...`);
@@ -188,6 +226,7 @@ export class GooglePlayService {
                 const uploadedLocales = [];
                 const skippedLocales = [];
                 const failedLocales = [];
+                const screenshotUploadOptions = [];
                 for (const locale of localesToPush) {
                     try {
                         const localeData = googlePlayData.locales[locale];
@@ -245,25 +284,40 @@ export class GooglePlayService {
                             skippedLocales.push(locale);
                             continue;
                         }
-                        console.error(`[GooglePlay]   📤 Uploading screenshots for ${locale} (batch mode - will replace existing)...`);
+                        console.error(`[GooglePlay]   📋 Queued screenshots for ${locale} (batch mode - will replace existing)...`);
                         // Google Play upload strategy:
                         // - phone → uploads to phoneScreenshots AND sevenInchScreenshots (both use same images)
                         // - tablet → uploads to tenInchScreenshots only
-                        const uploadResult = await client.uploadScreenshotsForLocale({
+                        screenshotUploadOptions.push({
                             language: locale,
                             phoneScreenshots: screenshots.phone,
                             sevenInchScreenshots: screenshots.phone,
                             tenInchScreenshots: screenshots.tablet,
                             featureGraphic: screenshots.featureGraphic || undefined,
+                            imageUploadTimeoutMs,
                         });
-                        console.error(`[GooglePlay]   ✅ Images uploaded for ${locale}: ${uploadResult.uploaded.phoneScreenshots} phone, ${uploadResult.uploaded.sevenInchScreenshots} 7-inch, ${uploadResult.uploaded.tenInchScreenshots} 10-inch, feature graphic ${uploadResult.uploaded.featureGraphic ? "yes" : "no"}`);
-                        uploadedLocales.push(locale);
                     }
                     catch (error) {
                         console.error(`[GooglePlay]   ❌ Failed to upload screenshots for ${locale}: ${error instanceof Error ? error.message : String(error)}`);
                         failedLocales.push(locale);
                     }
                 }
+                for (let offset = 0; offset < screenshotUploadOptions.length; offset += GOOGLE_PLAY_SCREENSHOT_LOCALE_BATCH_SIZE) {
+                    const batch = screenshotUploadOptions.slice(offset, offset + GOOGLE_PLAY_SCREENSHOT_LOCALE_BATCH_SIZE);
+                    try {
+                        console.error(`[GooglePlay]   📤 Uploading screenshots for ${batch.length} locale(s) in one edit...`);
+                        const uploadResults = await client.uploadScreenshotsForLocales(batch);
+                        for (const uploadResult of uploadResults) {
+                            console.error(`[GooglePlay]   ✅ Images uploaded for ${uploadResult.language}: ${uploadResult.uploaded.phoneScreenshots} phone, ${uploadResult.uploaded.sevenInchScreenshots} 7-inch, ${uploadResult.uploaded.tenInchScreenshots} 10-inch, feature graphic ${uploadResult.uploaded.featureGraphic ? "yes" : "no"}`);
+                            uploadedLocales.push(uploadResult.language);
+                        }
+                    }
+                    catch (error) {
+                        const failedBatchLocales = batch.map((option) => option.language);
+                        console.error(`[GooglePlay]   ❌ Batch screenshot upload failed for ${failedBatchLocales.join(", ")}: ${error instanceof Error ? error.message : String(error)}`);
+                        failedLocales.push(...failedBatchLocales);
+                    }
+                }
                 console.error(`[GooglePlay]   📊 Screenshot upload summary: ${uploadedLocales.length} succeeded, ${skippedLocales.length} skipped, ${failedLocales.length} failed`);
                 if (uploadedLocales.length > 0) {
                     console.error(`[GooglePlay]     ✅ Uploaded: ${uploadedLocales.join(", ")}`);
@@ -272,7 +326,9 @@ export class GooglePlayService {
                     console.error(`[GooglePlay]     ⏭️  Skipped: ${skippedLocales.join(", ")}`);
                 }
                 if (failedLocales.length > 0) {
-                    console.error(`[GooglePlay]     ❌ Failed: ${failedLocales.join(", ")}`);
+                    const uniqueFailedLocales = [...new Set(failedLocales)];
+                    console.error(`[GooglePlay]     ❌ Failed: ${uniqueFailedLocales.join(", ")}`);
+                    throw new Error(`Screenshot upload failed for locales: ${uniqueFailedLocales.join(", ")}`);
                 }
             }
             try {

package/dist/src/index.js

@@ -195,6 +195,16 @@ registerToolWithInfo("aso-push", {
             .boolean()
             .optional()
             .describe("Whether to upload images as well"),
+        locales: z
+            .array(z.string())
+            .optional()
+            .describe("Optional locale allowlist to push (e.g. ['en-US', 'ko-KR'])"),
+        imageUploadTimeoutMs: z
+            .number()
+            .int()
+            .positive()
+            .optional()
+            .describe("Per-image upload timeout in milliseconds"),
         dryRun: z
             .boolean()
             .optional()

package/dist/src/packages/common/errors/error-codes.d.ts

@@ -42,6 +42,7 @@ export declare const ERROR_CODES: {
     readonly APP_STORE_PULL_RELEASE_NOTES_FAILED: "APP_STORE_PULL_RELEASE_NOTES_FAILED";
     readonly APP_STORE_CREATE_VERSION_FAILED: "APP_STORE_CREATE_VERSION_FAILED";
     readonly APP_STORE_PUSH_FAILED: "APP_STORE_PUSH_FAILED";
+    readonly APP_STORE_ASO_DATA_EMPTY: "APP_STORE_ASO_DATA_EMPTY";
     readonly APP_STORE_STATE_ERROR: "APP_STORE_STATE_ERROR";
     readonly APP_STORE_CREATE_VERSION_FOR_STATE_ERROR_FAILED: "APP_STORE_CREATE_VERSION_FOR_STATE_ERROR_FAILED";
     readonly APP_STORE_VERIFY_AUTH_FAILED: "APP_STORE_VERIFY_AUTH_FAILED";
@@ -53,6 +54,7 @@ export declare const ERROR_CODES: {
     readonly GOOGLE_PLAY_PULL_RELEASE_NOTES_FAILED: "GOOGLE_PLAY_PULL_RELEASE_NOTES_FAILED";
     readonly GOOGLE_PLAY_CREATE_VERSION_FAILED: "GOOGLE_PLAY_CREATE_VERSION_FAILED";
     readonly GOOGLE_PLAY_PUSH_FAILED: "GOOGLE_PLAY_PUSH_FAILED";
+    readonly GOOGLE_PLAY_ASO_DATA_EMPTY: "GOOGLE_PLAY_ASO_DATA_EMPTY";
     readonly GOOGLE_PLAY_VERIFY_AUTH_FAILED: "GOOGLE_PLAY_VERIFY_AUTH_FAILED";
     readonly ASO_GOOGLE_PLAY_DATA_PARSE_FAILED: "ASO_GOOGLE_PLAY_DATA_PARSE_FAILED";
     readonly ASO_APP_STORE_DATA_PARSE_FAILED: "ASO_APP_STORE_DATA_PARSE_FAILED";

package/dist/src/packages/common/errors/error-codes.js

@@ -49,6 +49,7 @@ export const ERROR_CODES = {
     APP_STORE_PULL_RELEASE_NOTES_FAILED: "APP_STORE_PULL_RELEASE_NOTES_FAILED",
     APP_STORE_CREATE_VERSION_FAILED: "APP_STORE_CREATE_VERSION_FAILED",
     APP_STORE_PUSH_FAILED: "APP_STORE_PUSH_FAILED",
+    APP_STORE_ASO_DATA_EMPTY: "APP_STORE_ASO_DATA_EMPTY",
     APP_STORE_STATE_ERROR: "APP_STORE_STATE_ERROR",
     APP_STORE_CREATE_VERSION_FOR_STATE_ERROR_FAILED: "APP_STORE_CREATE_VERSION_FOR_STATE_ERROR_FAILED",
     APP_STORE_VERIFY_AUTH_FAILED: "APP_STORE_VERIFY_AUTH_FAILED",
@@ -61,6 +62,7 @@ export const ERROR_CODES = {
     GOOGLE_PLAY_PULL_RELEASE_NOTES_FAILED: "GOOGLE_PLAY_PULL_RELEASE_NOTES_FAILED",
     GOOGLE_PLAY_CREATE_VERSION_FAILED: "GOOGLE_PLAY_CREATE_VERSION_FAILED",
     GOOGLE_PLAY_PUSH_FAILED: "GOOGLE_PLAY_PUSH_FAILED",
+    GOOGLE_PLAY_ASO_DATA_EMPTY: "GOOGLE_PLAY_ASO_DATA_EMPTY",
     GOOGLE_PLAY_VERIFY_AUTH_FAILED: "GOOGLE_PLAY_VERIFY_AUTH_FAILED",
     // ASO data/files
     ASO_GOOGLE_PLAY_DATA_PARSE_FAILED: "ASO_GOOGLE_PLAY_DATA_PARSE_FAILED",

package/dist/src/packages/stores/app-store/client.d.ts

@@ -82,6 +82,7 @@ export declare class AppStoreClient {
         imagePath: string;
         screenshotDisplayType: string;
         locale: string;
+        imageUploadTimeoutMs?: number;
     }): Promise<void>;
     /**
      * Find or create Screenshot Set for a specific display type
@@ -124,6 +125,7 @@ export declare class AppStoreClient {
             displayType: string;
             filename: string;
         }>;
+        imageUploadTimeoutMs?: number;
     }): Promise<{
         uploaded: number;
         deleted: number;

package/dist/src/packages/stores/app-store/client.js

@@ -577,7 +577,7 @@ export class AppStoreClient {
      * 4. Commit upload operation
      */
     async uploadScreenshot(options) {
-        const { imagePath, screenshotDisplayType, locale } = options;
+        const { imagePath, screenshotDisplayType, locale, imageUploadTimeoutMs } = options;
         try {
             // Get app and version info
             const appId = await this.findAppId();
@@ -611,7 +611,7 @@ export class AppStoreClient {
             if (screenshot.uploadOperations &&
                 screenshot.uploadOperations.length > 0) {
                 const uploadOp = screenshot.uploadOperations[0];
-                await this.uploadFileToUrl(uploadOp.url, fileBuffer, uploadOp.method);
+                await this.uploadFileToUrl(uploadOp.url, fileBuffer, uploadOp.method, imageUploadTimeoutMs);
             }
             // Step 4: Commit screenshot
             await this.commitAppScreenshot(screenshot.id);
@@ -703,7 +703,7 @@ export class AppStoreClient {
     /**
      * Upload file to reserved URL
      */
-    async uploadFileToUrl(url, fileBuffer, method = "PUT") {
+    async uploadFileToUrl(url, fileBuffer, method = "PUT", timeoutMs) {
         const https = await import("node:https");
         const { URL } = await import("node:url");
         return new Promise((resolve, reject) => {
@@ -727,6 +727,11 @@ export class AppStoreClient {
                 }
             });
             req.on("error", reject);
+            if (timeoutMs) {
+                req.setTimeout(timeoutMs, () => {
+                    req.destroy(new Error(`Upload timed out after ${timeoutMs}ms`));
+                });
+            }
             req.write(fileBuffer);
             req.end();
         });
@@ -776,6 +781,10 @@ export class AppStoreClient {
         const screenshots = screenshotsResponse.data || [];
         let deletedCount = 0;
         for (const screenshot of screenshots) {
+            if (screenshot.type !== "appScreenshots") {
+                console.error(`[AppStore]       Skipping non-screenshot asset ${screenshot.id}`);
+                continue;
+            }
             await this.deleteScreenshot(screenshot.id);
             deletedCount++;
         }
@@ -853,7 +862,7 @@ export class AppStoreClient {
      * 3. Upload new screenshots in order
      */
     async uploadScreenshotsForLocale(options) {
-        const { locale, screenshots } = options;
+        const { locale, screenshots, imageUploadTimeoutMs } = options;
         const result = { uploaded: 0, deleted: 0, failed: 0 };
         if (screenshots.length === 0) {
             return result;
@@ -914,7 +923,7 @@ export class AppStoreClient {
                             if (screenshotData.uploadOperations &&
                                 screenshotData.uploadOperations.length > 0) {
                                 const uploadOp = screenshotData.uploadOperations[0];
-                                await this.uploadFileToUrl(uploadOp.url, fileBuffer, uploadOp.method);
+                                await this.uploadFileToUrl(uploadOp.url, fileBuffer, uploadOp.method, imageUploadTimeoutMs);
                             }
                             // Commit screenshot
                             await this.commitAppScreenshot(screenshotData.id);

package/dist/src/packages/stores/play-store/client.d.ts

@@ -55,6 +55,9 @@ export declare class GooglePlayClient {
      * Deletes existing screenshots before uploading new ones
      */
     uploadScreenshotsForLocale(options: BatchUploadScreenshotsOptions): Promise<BatchUploadScreenshotsResult>;
+    uploadScreenshotsForLocales(optionsList: BatchUploadScreenshotsOptions[]): Promise<BatchUploadScreenshotsResult[]>;
+    private uploadScreenshotsInSession;
+    private uploadImageWithOptionalTimeout;
     private getTrack;
     private updateTrack;
     private listTracks;

package/dist/src/packages/stores/play-store/client.js

@@ -620,7 +620,6 @@ export class GooglePlayClient {
      * Deletes existing screenshots before uploading new ones
      */
     async uploadScreenshotsForLocale(options) {
-        const { language, phoneScreenshots = [], sevenInchScreenshots = [], tenInchScreenshots = [], featureGraphic, } = options;
         const authClient = await this.auth.getClient();
         const editResponse = await this.createEdit(authClient, this.packageName);
         const editId = editResponse.data.id;
@@ -629,6 +628,61 @@ export class GooglePlayClient {
             packageName: this.packageName,
             editId,
         };
+        try {
+            const result = await this.uploadScreenshotsInSession(session, options);
+            // Commit all changes
+            console.error(`[GooglePlayClient] Committing screenshots for ${options.language}...`);
+            await this.commitEdit(session);
+            console.error(`[GooglePlayClient] ✅ Screenshots committed for ${options.language}`);
+            return result;
+        }
+        catch (error) {
+            console.error(`[GooglePlayClient] Rolling back screenshot upload for ${options.language}...`);
+            try {
+                await this.deleteEdit(session);
+            }
+            catch {
+                // Ignore deletion failure
+            }
+            throw error;
+        }
+    }
+    async uploadScreenshotsForLocales(optionsList) {
+        if (optionsList.length === 0)
+            return [];
+        const authClient = await this.auth.getClient();
+        const editResponse = await this.createEdit(authClient, this.packageName);
+        const editId = editResponse.data.id;
+        const session = {
+            auth: authClient,
+            packageName: this.packageName,
+            editId,
+        };
+        try {
+            const results = [];
+            for (const options of optionsList) {
+                console.error(`[GooglePlayClient] Preparing screenshots for ${options.language}...`);
+                const result = await this.uploadScreenshotsInSession(session, options);
+                results.push(result);
+            }
+            console.error(`[GooglePlayClient] Committing screenshots for ${optionsList.length} locale(s)...`);
+            await this.commitEdit(session);
+            console.error(`[GooglePlayClient] ✅ Screenshots committed for ${optionsList.length} locale(s)`);
+            return results;
+        }
+        catch (error) {
+            console.error(`[GooglePlayClient] Rolling back batch screenshot upload...`);
+            try {
+                await this.deleteEdit(session);
+            }
+            catch {
+                // Ignore deletion failure
+            }
+            throw error;
+        }
+    }
+    async uploadScreenshotsInSession(session, options) {
+        const { language, phoneScreenshots = [], sevenInchScreenshots = [], tenInchScreenshots = [], featureGraphic, imageUploadTimeoutMs, } = options;
         const result = {
             language,
             uploaded: {
@@ -638,155 +692,107 @@ export class GooglePlayClient {
                 featureGraphic: false,
             },
         };
-        try {
-            // Delete existing screenshots before uploading
-            if (phoneScreenshots.length > 0) {
-                console.error(`[GooglePlayClient] Deleting existing phone screenshots for ${language}...`);
-                try {
-                    await this.deleteAllImages(session, language, "phoneScreenshots");
-                }
-                catch (e) {
-                    // Ignore if no images exist
-                    if (e.code !== 404) {
-                        console.error(`[GooglePlayClient] Warning: Failed to delete phone screenshots: ${e.message}`);
-                    }
-                }
+        if (phoneScreenshots.length > 0) {
+            console.error(`[GooglePlayClient] Deleting existing phone screenshots for ${language}...`);
+            try {
+                await this.deleteAllImages(session, language, "phoneScreenshots");
             }
-            if (sevenInchScreenshots.length > 0) {
-                console.error(`[GooglePlayClient] Deleting existing 7-inch screenshots for ${language}...`);
-                try {
-                    await this.deleteAllImages(session, language, "sevenInchScreenshots");
-                }
-                catch (e) {
-                    if (e.code !== 404) {
-                        console.error(`[GooglePlayClient] Warning: Failed to delete 7-inch screenshots: ${e.message}`);
-                    }
+            catch (e) {
+                // Ignore if no images exist
+                if (e.code !== 404) {
+                    console.error(`[GooglePlayClient] Warning: Failed to delete phone screenshots: ${e.message}`);
                 }
             }
-            if (tenInchScreenshots.length > 0) {
-                console.error(`[GooglePlayClient] Deleting existing 10-inch screenshots for ${language}...`);
-                try {
-                    await this.deleteAllImages(session, language, "tenInchScreenshots");
-                }
-                catch (e) {
-                    if (e.code !== 404) {
-                        console.error(`[GooglePlayClient] Warning: Failed to delete 10-inch screenshots: ${e.message}`);
-                    }
-                }
+        }
+        if (sevenInchScreenshots.length > 0) {
+            console.error(`[GooglePlayClient] Deleting existing 7-inch screenshots for ${language}...`);
+            try {
+                await this.deleteAllImages(session, language, "sevenInchScreenshots");
             }
-            if (featureGraphic) {
-                console.error(`[GooglePlayClient] Deleting existing feature graphic for ${language}...`);
-                try {
-                    await this.deleteAllImages(session, language, "featureGraphic");
-                }
-                catch (e) {
-                    if (e.code !== 404) {
-                        console.error(`[GooglePlayClient] Warning: Failed to delete feature graphic: ${e.message}`);
-                    }
+            catch (e) {
+                if (e.code !== 404) {
+                    console.error(`[GooglePlayClient] Warning: Failed to delete 7-inch screenshots: ${e.message}`);
                 }
             }
-            // Upload phone screenshots
-            for (let i = 0; i < phoneScreenshots.length; i++) {
-                const imagePath = phoneScreenshots[i];
-                if (!existsSync(imagePath)) {
-                    console.error(`[GooglePlayClient] Warning: Phone screenshot not found: ${imagePath}`);
-                    continue;
-                }
-                const imageBuffer = readFileSync(imagePath);
-                const fileName = imagePath.split("/").pop() || `phone-${i + 1}.png`;
-                await this.androidPublisher.edits.images.upload({
-                    auth: session.auth,
-                    packageName: session.packageName,
-                    editId: session.editId,
-                    language,
-                    imageType: "phoneScreenshots",
-                    media: {
-                        mimeType: "image/png",
-                        body: imageBuffer,
-                    },
-                });
-                console.error(`[GooglePlayClient]   ✅ Uploaded ${fileName}`);
-                result.uploaded.phoneScreenshots++;
-            }
-            // Upload 7-inch tablet screenshots
-            for (let i = 0; i < sevenInchScreenshots.length; i++) {
-                const imagePath = sevenInchScreenshots[i];
-                if (!existsSync(imagePath)) {
-                    console.error(`[GooglePlayClient] Warning: 7-inch screenshot not found: ${imagePath}`);
-                    continue;
-                }
-                const imageBuffer = readFileSync(imagePath);
-                const fileName = imagePath.split("/").pop() || `tablet7-${i + 1}.png`;
-                await this.androidPublisher.edits.images.upload({
-                    auth: session.auth,
-                    packageName: session.packageName,
-                    editId: session.editId,
-                    language,
-                    imageType: "sevenInchScreenshots",
-                    media: {
-                        mimeType: "image/png",
-                        body: imageBuffer,
-                    },
-                });
-                console.error(`[GooglePlayClient]   ✅ Uploaded ${fileName}`);
-                result.uploaded.sevenInchScreenshots++;
-            }
-            // Upload 10-inch tablet screenshots
-            for (let i = 0; i < tenInchScreenshots.length; i++) {
-                const imagePath = tenInchScreenshots[i];
-                if (!existsSync(imagePath)) {
-                    console.error(`[GooglePlayClient] Warning: 10-inch screenshot not found: ${imagePath}`);
-                    continue;
+        }
+        if (tenInchScreenshots.length > 0) {
+            console.error(`[GooglePlayClient] Deleting existing 10-inch screenshots for ${language}...`);
+            try {
+                await this.deleteAllImages(session, language, "tenInchScreenshots");
+            }
+            catch (e) {
+                if (e.code !== 404) {
+                    console.error(`[GooglePlayClient] Warning: Failed to delete 10-inch screenshots: ${e.message}`);
                 }
-                const imageBuffer = readFileSync(imagePath);
-                const fileName = imagePath.split("/").pop() || `tablet10-${i + 1}.png`;
-                await this.androidPublisher.edits.images.upload({
-                    auth: session.auth,
-                    packageName: session.packageName,
-                    editId: session.editId,
-                    language,
-                    imageType: "tenInchScreenshots",
-                    media: {
-                        mimeType: "image/png",
-                        body: imageBuffer,
-                    },
-                });
-                console.error(`[GooglePlayClient]   ✅ Uploaded ${fileName}`);
-                result.uploaded.tenInchScreenshots++;
-            }
-            // Upload feature graphic
-            if (featureGraphic && existsSync(featureGraphic)) {
-                const imageBuffer = readFileSync(featureGraphic);
-                await this.androidPublisher.edits.images.upload({
-                    auth: session.auth,
-                    packageName: session.packageName,
-                    editId: session.editId,
-                    language,
-                    imageType: "featureGraphic",
-                    media: {
-                        mimeType: "image/png",
-                        body: imageBuffer,
-                    },
-                });
-                console.error(`[GooglePlayClient]   ✅ Uploaded feature-graphic.png`);
-                result.uploaded.featureGraphic = true;
             }
-            // Commit all changes
-            console.error(`[GooglePlayClient] Committing screenshots for ${language}...`);
-            await this.commitEdit(session);
-            console.error(`[GooglePlayClient] ✅ Screenshots committed for ${language}`);
-            return result;
         }
-        catch (error) {
-            console.error(`[GooglePlayClient] Rolling back screenshot upload for ${language}...`);
+        if (featureGraphic) {
+            console.error(`[GooglePlayClient] Deleting existing feature graphic for ${language}...`);
             try {
-                await this.deleteEdit(session);
+                await this.deleteAllImages(session, language, "featureGraphic");
             }
-            catch {
-                // Ignore deletion failure
+            catch (e) {
+                if (e.code !== 404) {
+                    console.error(`[GooglePlayClient] Warning: Failed to delete feature graphic: ${e.message}`);
+                }
             }
-            throw error;
         }
+        for (let i = 0; i < phoneScreenshots.length; i++) {
+            const imagePath = phoneScreenshots[i];
+            if (!existsSync(imagePath)) {
+                console.error(`[GooglePlayClient] Warning: Phone screenshot not found: ${imagePath}`);
+                continue;
+            }
+            const imageBuffer = readFileSync(imagePath);
+            const fileName = imagePath.split("/").pop() || `phone-${i + 1}.png`;
+            await this.uploadImageWithOptionalTimeout(session, language, "phoneScreenshots", imageBuffer, imageUploadTimeoutMs);
+            console.error(`[GooglePlayClient]   ✅ Uploaded ${fileName}`);
+            result.uploaded.phoneScreenshots++;
+        }
+        for (let i = 0; i < sevenInchScreenshots.length; i++) {
+            const imagePath = sevenInchScreenshots[i];
+            if (!existsSync(imagePath)) {
+                console.error(`[GooglePlayClient] Warning: 7-inch screenshot not found: ${imagePath}`);
+                continue;
+            }
+            const imageBuffer = readFileSync(imagePath);
+            const fileName = imagePath.split("/").pop() || `tablet7-${i + 1}.png`;
+            await this.uploadImageWithOptionalTimeout(session, language, "sevenInchScreenshots", imageBuffer, imageUploadTimeoutMs);
+            console.error(`[GooglePlayClient]   ✅ Uploaded ${fileName}`);
+            result.uploaded.sevenInchScreenshots++;
+        }
+        for (let i = 0; i < tenInchScreenshots.length; i++) {
+            const imagePath = tenInchScreenshots[i];
+            if (!existsSync(imagePath)) {
+                console.error(`[GooglePlayClient] Warning: 10-inch screenshot not found: ${imagePath}`);
+                continue;
+            }
+            const imageBuffer = readFileSync(imagePath);
+            const fileName = imagePath.split("/").pop() || `tablet10-${i + 1}.png`;
+            await this.uploadImageWithOptionalTimeout(session, language, "tenInchScreenshots", imageBuffer, imageUploadTimeoutMs);
+            console.error(`[GooglePlayClient]   ✅ Uploaded ${fileName}`);
+            result.uploaded.tenInchScreenshots++;
+        }
+        if (featureGraphic && existsSync(featureGraphic)) {
+            const imageBuffer = readFileSync(featureGraphic);
+            await this.uploadImageWithOptionalTimeout(session, language, "featureGraphic", imageBuffer, imageUploadTimeoutMs);
+            console.error(`[GooglePlayClient]   ✅ Uploaded feature-graphic.png`);
+            result.uploaded.featureGraphic = true;
+        }
+        return result;
+    }
+    async uploadImageWithOptionalTimeout(session, language, imageType, imageBuffer, timeoutMs) {
+        await this.androidPublisher.edits.images.upload({
+            auth: session.auth,
+            packageName: session.packageName,
+            editId: session.editId,
+            language,
+            imageType,
+            media: {
+                mimeType: "image/png",
+                body: imageBuffer,
+            },
+        }, timeoutMs ? { timeout: timeoutMs } : undefined);
     }
     async getTrack(session, track) {
         const response = await this.androidPublisher.edits.tracks.get({

package/dist/src/packages/stores/play-store/types.d.ts

@@ -119,6 +119,7 @@ export interface BatchUploadScreenshotsOptions {
     sevenInchScreenshots?: string[];
     tenInchScreenshots?: string[];
     featureGraphic?: string;
+    imageUploadTimeoutMs?: number;
 }
 /**
  * Batch Upload Screenshots Result

package/dist/src/tools/aso/push.d.ts

@@ -5,6 +5,8 @@ interface AsoPushOptions {
     bundleId?: string;
     store?: StoreType;
     uploadImages?: boolean;
+    locales?: string[];
+    imageUploadTimeoutMs?: number;
     dryRun?: boolean;
 }
 export declare function handleAsoPush(options: AsoPushOptions): Promise<{

package/dist/src/tools/aso/push.js

@@ -9,7 +9,7 @@ const appResolutionService = new AppResolutionService();
 const appStoreService = new AppStoreService();
 const googlePlayService = new GooglePlayService();
 export async function handleAsoPush(options) {
-    const { store = "both", uploadImages = false, dryRun = false } = options;
+    const { store = "both", uploadImages = false, locales, imageUploadTimeoutMs, dryRun = false, } = options;
     const resolved = appResolutionService.resolve({
         slug: options.app,
         packageName: options.packageName,
@@ -34,6 +34,11 @@ export async function handleAsoPush(options) {
     if (bundleId)
         console.error(`[MCP]   Bundle ID: ${bundleId}`);
     console.error(`[MCP]   Upload Images: ${uploadImages ? "Yes" : "No"}`);
+    if (locales?.length)
+        console.error(`[MCP]   Locales: ${locales.join(", ")}`);
+    if (imageUploadTimeoutMs) {
+        console.error(`[MCP]   Image Upload Timeout: ${imageUploadTimeoutMs}ms`);
+    }
     console.error(`[MCP]   Mode: ${dryRun ? "Dry run" : "Actual push"}`);
     let config;
     try {
@@ -136,6 +141,8 @@ export async function handleAsoPush(options) {
                 localAsoData: configData,
                 googlePlayDataPath,
                 uploadImages,
+                locales,
+                imageUploadTimeoutMs,
                 slug,
             });
             results.push(formatPushResult("Google Play", result));
@@ -153,6 +160,8 @@ export async function handleAsoPush(options) {
                 localAsoData: configData,
                 appStoreDataPath,
                 uploadImages,
+                locales,
+                imageUploadTimeoutMs,
                 slug,
             });
             results.push(formatPushResult("App Store", appStoreResult));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pabal-store-api-mcp",
-  "version": "1.3.10",
+  "version": "1.3.13",
   "description": "MCP server for App Store / Play Store ASO workflows",
   "main": "dist/src/index.js",
   "types": "dist/src/index.d.ts",