pabal-store-api-mcp 1.3.9 → 1.3.11

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,10 @@ interface GooglePlayAppInfo {
     name?: string;
     supportedLocales?: string[];
 }
+export declare function resolveGooglePlayLocales(allLocales: string[], requestedLocales?: string[]): {
+    localesToPush: string[];
+    missingLocales: string[];
+};
 /**
  * Google Play-facing service layer that wraps client creation and common operations.
  * Keeps MCP tools independent from client factories and SDK details.
@@ -21,12 +25,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,16 @@ 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";
+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)),
+    };
+}
 /**
  * Google Play-facing service layer that wraps client creation and common operations.
  * Keeps MCP tools independent from client factories and SDK details.
@@ -148,7 +158,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,12 +175,28 @@ 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);
+            await client.pushMultilingualAsoData({
+                ...googlePlayData,
+                locales: Object.fromEntries(localesToPush.map((locale) => [
+                    locale,
+                    googlePlayData.locales[locale],
+                ])),
+            });
             // Push app-level contact information
             if (googlePlayData.contactEmail || googlePlayData.contactWebsite) {
                 console.error(`[GooglePlay]   📤 Pushing app details...`);
@@ -191,14 +217,15 @@ export class GooglePlayService {
                 for (const locale of localesToPush) {
                     try {
                         const localeData = googlePlayData.locales[locale];
-                        // Check if screenshots are defined in aso-data.json
-                        const hasScreenshotsInJson = localeData?.screenshots &&
-                            ((localeData.screenshots.phone &&
-                                localeData.screenshots.phone.length > 0) ||
-                                (localeData.screenshots.tablet &&
-                                    localeData.screenshots.tablet.length > 0));
+                        // Check if images are defined in aso-data.json
+                        const hasImagesInJson = Boolean(localeData?.featureGraphic) ||
+                            Boolean(localeData?.screenshots &&
+                                ((localeData.screenshots.phone &&
+                                    localeData.screenshots.phone.length > 0) ||
+                                    (localeData.screenshots.tablet &&
+                                        localeData.screenshots.tablet.length > 0)));
                         let screenshots;
-                        if (hasScreenshotsInJson) {
+                        if (hasImagesInJson) {
                             // Use screenshots from aso-data.json (relative paths)
                             console.error(`[GooglePlay]   📋 Using screenshots from aso-data.json for ${locale}`);
                             const relativePaths = localeData.screenshots;
@@ -230,10 +257,17 @@ export class GooglePlayService {
                                 featureGraphic: fsScreenshots.featureGraphic,
                             };
                         }
-                        // Google Play requires minimum 2 phone screenshots
+                        // Google Play requires minimum 2 phone screenshots for that image type.
                         const phoneCount = screenshots.phone.length;
-                        if (phoneCount < 2) {
-                            console.error(`[GooglePlay]   ⚠️  Skipping ${locale} - needs at least 2 phone screenshots (found ${phoneCount})`);
+                        if (phoneCount > 0 && phoneCount < 2) {
+                            console.error(`[GooglePlay]   ⚠️  Skipping phone screenshots for ${locale} - needs at least 2 (found ${phoneCount})`);
+                            screenshots.phone = [];
+                        }
+                        const hasImagesToUpload = screenshots.phone.length > 0 ||
+                            screenshots.tablet.length > 0 ||
+                            Boolean(screenshots.featureGraphic);
+                        if (!hasImagesToUpload) {
+                            console.error(`[GooglePlay]   ⏭️  Skipping ${locale} - no uploadable images found`);
                             skippedLocales.push(locale);
                             continue;
                         }
@@ -247,8 +281,9 @@ export class GooglePlayService {
                             sevenInchScreenshots: screenshots.phone,
                             tenInchScreenshots: screenshots.tablet,
                             featureGraphic: screenshots.featureGraphic || undefined,
+                            imageUploadTimeoutMs,
                         });
-                        console.error(`[GooglePlay]   ✅ Screenshots uploaded for ${locale}: ${uploadResult.uploaded.phoneScreenshots} phone, ${uploadResult.uploaded.sevenInchScreenshots} 7-inch, ${uploadResult.uploaded.tenInchScreenshots} 10-inch`);
+                        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) {

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();
         });
@@ -853,7 +858,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 +919,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,7 @@ export declare class GooglePlayClient {
      * Deletes existing screenshots before uploading new ones
      */
     uploadScreenshotsForLocale(options: BatchUploadScreenshotsOptions): Promise<BatchUploadScreenshotsResult>;
+    private uploadImageWithOptionalTimeout;
     private getTrack;
     private updateTrack;
     private listTracks;

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

@@ -620,7 +620,7 @@ export class GooglePlayClient {
      * Deletes existing screenshots before uploading new ones
      */
     async uploadScreenshotsForLocale(options) {
-        const { language, phoneScreenshots = [], sevenInchScreenshots = [], tenInchScreenshots = [], featureGraphic, } = options;
+        const { language, phoneScreenshots = [], sevenInchScreenshots = [], tenInchScreenshots = [], featureGraphic, imageUploadTimeoutMs, } = options;
         const authClient = await this.auth.getClient();
         const editResponse = await this.createEdit(authClient, this.packageName);
         const editId = editResponse.data.id;
@@ -694,17 +694,7 @@ export class GooglePlayClient {
                 }
                 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,
-                    },
-                });
+                await this.uploadImageWithOptionalTimeout(session, language, "phoneScreenshots", imageBuffer, imageUploadTimeoutMs);
                 console.error(`[GooglePlayClient]   ✅ Uploaded ${fileName}`);
                 result.uploaded.phoneScreenshots++;
             }
@@ -717,17 +707,7 @@ export class GooglePlayClient {
                 }
                 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,
-                    },
-                });
+                await this.uploadImageWithOptionalTimeout(session, language, "sevenInchScreenshots", imageBuffer, imageUploadTimeoutMs);
                 console.error(`[GooglePlayClient]   ✅ Uploaded ${fileName}`);
                 result.uploaded.sevenInchScreenshots++;
             }
@@ -740,34 +720,14 @@ export class GooglePlayClient {
                 }
                 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,
-                    },
-                });
+                await this.uploadImageWithOptionalTimeout(session, language, "tenInchScreenshots", imageBuffer, imageUploadTimeoutMs);
                 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,
-                    },
-                });
+                await this.uploadImageWithOptionalTimeout(session, language, "featureGraphic", imageBuffer, imageUploadTimeoutMs);
                 console.error(`[GooglePlayClient]   ✅ Uploaded feature-graphic.png`);
                 result.uploaded.featureGraphic = true;
             }
@@ -788,6 +748,19 @@ export class GooglePlayClient {
             throw error;
         }
     }
+    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({
             auth: session.auth,

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.9",
+  "version": "1.3.11",
   "description": "MCP server for App Store / Play Store ASO workflows",
   "main": "dist/src/index.js",
   "types": "dist/src/index.d.ts",