pabal-store-api-mcp 1.3.17 → 1.3.19

package/README.md

@@ -38,6 +38,14 @@ chmod 700 ~/.config/pabal-mcp
 
 <br>
 
+### Registered Apps
+
+Registered apps are stored locally in `~/.config/pabal-mcp/registered-apps.json`.
+It is usually created and updated by `apps-init` or `apps-add`, then used by tools such as `apps-search`, `aso-pull`, and release-note workflows.
+See the app management docs for the detailed format: [English](docs/en-US/apps.md) / [한국어](docs/ko-KR/apps.md).
+
+<br>
+
 ## Features
 
 - ✅ **ASO Data Sync**: Pull/push metadata from App Store and Google Play

package/dist/src/core/helpers/screenshot-helpers.d.ts

@@ -13,6 +13,7 @@ export declare const APP_STORE_DEVICE_TYPES: {
     readonly iphone55: "APP_IPHONE_55";
     readonly iphone47: "APP_IPHONE_47";
     readonly iphone40: "APP_IPHONE_40";
+    readonly ipad13: "APP_IPAD_PRO_3GEN_129";
     readonly ipadPro129: "APP_IPAD_PRO_3GEN_129";
     readonly ipadPro11: "APP_IPAD_PRO_11";
     readonly ipad105: "APP_IPAD_105";

package/dist/src/core/helpers/screenshot-helpers.js

@@ -14,6 +14,7 @@ export const APP_STORE_DEVICE_TYPES = {
     iphone55: "APP_IPHONE_55",
     iphone47: "APP_IPHONE_47",
     iphone40: "APP_IPHONE_40",
+    ipad13: "APP_IPAD_PRO_3GEN_129",
     ipadPro129: "APP_IPAD_PRO_3GEN_129",
     ipadPro11: "APP_IPAD_PRO_11",
     ipad105: "APP_IPAD_105",

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

@@ -253,6 +253,8 @@ export class AppStoreService {
                         const hasScreenshotsInJson = localeData?.screenshots &&
                             ((localeData.screenshots.iphone65 &&
                                 localeData.screenshots.iphone65.length > 0) ||
+                                (localeData.screenshots.ipad13 &&
+                                    localeData.screenshots.ipad13.length > 0) ||
                                 (localeData.screenshots.ipadPro129 &&
                                     localeData.screenshots.ipadPro129.length > 0));
                         let screenshotsToUpload = [];
@@ -270,13 +272,13 @@ export class AppStoreService {
                                     });
                                 }
                             }
-                            // Map ipadPro129 screenshots
-                            if (relativePaths.ipadPro129 &&
-                                relativePaths.ipadPro129.length > 0) {
-                                for (const relPath of relativePaths.ipadPro129) {
+                            // Map 13" iPad screenshots. ipadPro129 is kept as a legacy alias.
+                            const ipad13Paths = relativePaths.ipad13 ?? relativePaths.ipadPro129 ?? [];
+                            if (ipad13Paths.length > 0) {
+                                for (const relPath of ipad13Paths) {
                                     screenshotsToUpload.push({
                                         path: `${screenshotsBaseDir}/${relPath}`,
-                                        displayType: APP_STORE_DEVICE_TYPES.ipadPro129,
+                                        displayType: APP_STORE_DEVICE_TYPES.ipad13,
                                         filename: relPath.split("/").pop() || relPath,
                                     });
                                 }

package/dist/src/index.js

@@ -210,7 +210,7 @@ registerToolWithInfo("aso-push", {
             .int()
             .positive()
             .optional()
-            .describe("Google Play image locale batch size. Omit to upload all target locales in one edit commit"),
+            .describe("Google Play image locale batch size (default: 1 when uploadImages=true, replacing screenshots per locale while preserving videos)"),
         dryRun: z
             .boolean()
             .optional()

package/dist/src/packages/configs/aso-config/types.d.ts

@@ -49,6 +49,7 @@ export interface AppStoreScreenshots {
     iphone55?: string[];
     iphone47?: string[];
     iphone40?: string[];
+    ipad13?: string[];
     ipadPro129?: string[];
     ipadPro11?: string[];
     ipad105?: string[];

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

@@ -803,19 +803,29 @@ export class AppStoreClient {
         }
         const screenshotsResponse = await this.listScreenshots(screenshotSetId);
         const existingScreenshots = (screenshotsResponse.data || []).filter((screenshot) => screenshot.type === "appScreenshots");
+        const incompleteScreenshots = existingScreenshots.filter((screenshot) => {
+            const deliveryState = screenshot.attributes?.assetDeliveryState;
+            return deliveryState?.state && deliveryState.state !== "COMPLETE";
+        });
+        const completeScreenshots = existingScreenshots.filter((screenshot) => !incompleteScreenshots.includes(screenshot));
         const nonScreenshotCount = (screenshotsResponse.data || []).length - existingScreenshots.length;
         if (nonScreenshotCount > 0) {
             console.error(`[AppStore]       Ignoring ${nonScreenshotCount} non-screenshot asset(s) in screenshot set`);
         }
-        const slotsToFree = Math.max(0, existingScreenshots.length +
+        const deletedIncomplete = await this.deleteScreenshots(incompleteScreenshots);
+        if (deletedIncomplete > 0) {
+            console.error(`[AppStore]       Deleted ${deletedIncomplete} incomplete screenshot upload(s)`);
+        }
+        const slotsToFree = Math.max(0, completeScreenshots.length +
             incomingCount -
             APP_STORE_SCREENSHOT_SET_MAX_COUNT);
         // Preserve the first screenshots as long as possible. If the upload fails
         // after freeing slots, users are more likely to still see the primary
         // screenshots rather than the tail of the old set.
-        const screenshotsToDeleteBeforeUpload = slotsToFree > 0 ? existingScreenshots.slice(-slotsToFree) : [];
-        const screenshotsToDeleteAfterUpload = existingScreenshots.slice(0, existingScreenshots.length - slotsToFree);
-        const deletedBeforeUpload = await this.deleteScreenshots(screenshotsToDeleteBeforeUpload);
+        const screenshotsToDeleteBeforeUpload = slotsToFree > 0 ? completeScreenshots.slice(-slotsToFree) : [];
+        const screenshotsToDeleteAfterUpload = completeScreenshots.slice(0, completeScreenshots.length - slotsToFree);
+        const deletedBeforeUpload = deletedIncomplete +
+            (await this.deleteScreenshots(screenshotsToDeleteBeforeUpload));
         if (deletedBeforeUpload > 0) {
             console.error(`[AppStore]       Deleted ${deletedBeforeUpload} existing screenshots to free upload slots`);
         }

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

@@ -6,6 +6,7 @@ import { AppStoreService } from "../../core/services/app-store-service.js";
 import { GooglePlayService } from "../../core/services/google-play-service.js";
 import { formatPushResult } from "../../core/helpers/formatters.js";
 const DEFAULT_IMAGE_UPLOAD_TIMEOUT_MS = 10 * 60 * 1000;
+const DEFAULT_IMAGE_LOCALE_BATCH_SIZE = 1;
 const appResolutionService = new AppResolutionService();
 const appStoreService = new AppStoreService();
 const googlePlayService = new GooglePlayService();
@@ -13,6 +14,8 @@ export async function handleAsoPush(options) {
     const { store = "both", uploadImages = false, locales, dryRun = false, } = options;
     const imageUploadTimeoutMs = options.imageUploadTimeoutMs ??
         (uploadImages ? DEFAULT_IMAGE_UPLOAD_TIMEOUT_MS : undefined);
+    const imageLocaleBatchSize = options.imageLocaleBatchSize ??
+        (uploadImages ? DEFAULT_IMAGE_LOCALE_BATCH_SIZE : undefined);
     const resolved = appResolutionService.resolve({
         slug: options.app,
         packageName: options.packageName,
@@ -37,13 +40,16 @@ export async function handleAsoPush(options) {
     if (bundleId)
         console.error(`[MCP]   Bundle ID: ${bundleId}`);
     console.error(`[MCP]   Upload Images: ${uploadImages ? "Yes" : "No"}`);
+    if (uploadImages) {
+        console.error(`[MCP]   Image Upload Mode: overwrite screenshots only (videos preserved)`);
+    }
     if (locales?.length)
         console.error(`[MCP]   Locales: ${locales.join(", ")}`);
     if (imageUploadTimeoutMs) {
         console.error(`[MCP]   Image Upload Timeout: ${imageUploadTimeoutMs}ms`);
     }
-    if (options.imageLocaleBatchSize) {
-        console.error(`[MCP]   Image Locale Batch Size: ${options.imageLocaleBatchSize}`);
+    if (imageLocaleBatchSize) {
+        console.error(`[MCP]   Image Locale Batch Size: ${imageLocaleBatchSize}`);
     }
     console.error(`[MCP]   Mode: ${dryRun ? "Dry run" : "Actual push"}`);
     let config;
@@ -129,7 +135,9 @@ export async function handleAsoPush(options) {
             content: [
                 {
                     type: "text",
-                    text: `📋 Dry run - Data that would be pushed:\n${JSON.stringify(configData, null, 2)}`,
+                    text: `📋 Dry run - Data that would be pushed:\n${JSON.stringify(configData, null, 2)}${uploadImages
+                        ? "\n\nImage upload mode: overwrite screenshots only; videos/app previews are preserved."
+                        : ""}`,
                 },
             ],
         };
@@ -149,7 +157,7 @@ export async function handleAsoPush(options) {
                 uploadImages,
                 locales,
                 imageUploadTimeoutMs,
-                imageLocaleBatchSize: options.imageLocaleBatchSize,
+                imageLocaleBatchSize,
                 slug,
             });
             results.push(formatPushResult("Google Play", result));

package/package.json

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