Pabal MCP

Instructions

Implementation Reference

• src/tools/aso/push.ts:32-259 (handler)

  Main handler function that orchestrates ASO push: resolves app, loads and prepares local ASO data from cache, optionally pushes to App Store/Google Play services, supports dry-run.

  export async function handleAsoPush(options: AsoPushOptions) {
    const { store = "both", uploadImages = false, dryRun = false } = options;
  
    const resolved = appResolutionService.resolve({
      slug: options.app,
      packageName: options.packageName,
      bundleId: options.bundleId,
    });
  
    if (!resolved.success) {
      return {
        content: [
          {
            type: "text" as const,
            text: resolved.error.message,
          },
        ],
      };
    }
  
    const { slug, packageName, bundleId, hasAppStore, hasGooglePlay } =
      resolved.data;
  
    console.error(`[MCP] 📤 Pushing ASO data`);
    console.error(`[MCP]   Store: ${store}`);
    console.error(`[MCP]   App: ${slug}`);
    if (packageName) console.error(`[MCP]   Package Name: ${packageName}`);
    if (bundleId) console.error(`[MCP]   Bundle ID: ${bundleId}`);
    console.error(`[MCP]   Upload Images: ${uploadImages ? "Yes" : "No"}`);
    console.error(`[MCP]   Mode: ${dryRun ? "Dry run" : "Actual push"}`);
  
    let config;
    try {
      config = loadConfig();
    } catch (error) {
      const message = error instanceof Error ? error.message : String(error);
      return {
        content: [
          { type: "text" as const, text: `❌ Failed to load config: ${message}` },
        ],
        isError: true,
      };
    }
  
    // Load local data from ASO directory
    const asoDir = getAsoPushDir();
    const { googlePlay: googlePlayDataPath, appStore: appStoreDataPath } =
      getAsoDataPaths(slug, asoDir);
  
    console.error(`[MCP]   📁 ASO Directory: ${asoDir}`);
    console.error(`[MCP]   📁 Base ASO Dir: ${getAsoDir()}`);
    console.error(`[MCP]   🔍 Checking data files...`);
    console.error(`[MCP]     Google Play: ${googlePlayDataPath}`);
    console.error(
      `[MCP]       Exists: ${existsSync(googlePlayDataPath) ? "✅ Yes" : "❌ No"}`
    );
    console.error(`[MCP]     App Store: ${appStoreDataPath}`);
    console.error(
      `[MCP]       Exists: ${existsSync(appStoreDataPath) ? "✅ Yes" : "❌ No"}`
    );
  
    let configData;
    try {
      configData = loadAsoData(slug, { asoDir });
    } catch (error) {
      const message = error instanceof Error ? error.message : String(error);
      return {
        content: [
          {
            type: "text" as const,
            text: `❌ Failed to load ASO data: ${message}`,
          },
        ],
        isError: true,
      };
    }
  
    console.error(`[MCP]   📊 Loaded data status:`);
    console.error(
      `[MCP]     Google Play: ${
        configData.googlePlay ? "✅ Loaded" : "❌ Not found"
      }`
    );
    if (configData.googlePlay) {
      const gpData = configData.googlePlay;
      if (isGooglePlayMultilingual(gpData)) {
        const locales = Object.keys(gpData.locales);
        console.error(
          `[MCP]       Locales: ${locales.join(", ")} (${locales.length} total)`
        );
      } else {
        console.error(
          `[MCP]       Language: ${gpData.defaultLanguage || "unknown"}`
        );
      }
    }
    console.error(
      `[MCP]     App Store: ${configData.appStore ? "✅ Loaded" : "❌ Not found"}`
    );
    if (configData.appStore) {
      const asData = configData.appStore;
      if (isAppStoreMultilingual(asData)) {
        const locales = Object.keys(asData.locales);
        console.error(
          `[MCP]       Locales: ${locales.join(", ")} (${locales.length} total)`
        );
      } else {
        console.error(`[MCP]       Locale: ${asData.locale || "unknown"}`);
      }
    }
  
    if (!configData.googlePlay && !configData.appStore) {
      const errorDetails = `❌ No ASO data found for ${slug}.
  
  📁 Expected paths:
     Google Play: ${googlePlayDataPath}
     App Store: ${appStoreDataPath}
  
  💡 To fix this:
     1. Run \`aso-pull\` to fetch data from stores
     2. Or ensure data exists at the paths above
     3. Check that data directory is set correctly (current: ${getAsoDir()})`;
  
      console.error(`[MCP]   ${errorDetails}`);
      return {
        content: [{ type: "text" as const, text: errorDetails }],
      };
    }
  
    // Prepare data for push
    console.error(`[MCP]   🔄 Preparing data for push...`);
    const localAsoData = prepareAsoDataForPush(slug, configData);
  
    console.error(`[MCP]   📊 Prepared data status:`);
    console.error(
      `[MCP]     Google Play: ${
        localAsoData.googlePlay ? "✅ Ready" : "❌ Not available"
      }`
    );
    if (localAsoData.googlePlay) {
      const gpData = localAsoData.googlePlay;
      if (isGooglePlayMultilingual(gpData)) {
        const locales = Object.keys(gpData.locales);
        console.error(
          `[MCP]       Locales to push: ${locales.join(", ")} (${
            locales.length
          } total)`
        );
      }
    }
    console.error(
      `[MCP]     App Store: ${
        localAsoData.appStore ? "✅ Ready" : "❌ Not available"
      }`
    );
    if (localAsoData.appStore) {
      const asData = localAsoData.appStore;
      if (isAppStoreMultilingual(asData)) {
        const locales = Object.keys(asData.locales);
        console.error(
          `[MCP]       Locales to push: ${locales.join(", ")} (${
            locales.length
          } total)`
        );
      }
    }
  
    if (dryRun) {
      return {
        content: [
          {
            type: "text" as const,
            text: `📋 Dry run - Data that would be pushed:\n${JSON.stringify(
              localAsoData,
              null,
              2
            )}`,
          },
        ],
      };
    }
  
    // Save to ASO directory before pushing
    if (localAsoData.googlePlay || localAsoData.appStore) {
      saveAsoData(slug, localAsoData, { asoDir });
    }
  
    const results: string[] = [];
  
    // Push to Google Play
    if (store === "googlePlay" || store === "both") {
      if (!hasGooglePlay) {
        results.push(`⏭️  Skipping Google Play (not registered for Google Play)`);
      } else {
        const result = await googlePlayService.pushAsoData({
          config,
          packageName,
          localAsoData,
          googlePlayDataPath,
        });
        results.push(formatPushResult("Google Play", result));
      }
    }
  
    // Push to App Store
    if (store === "appStore" || store === "both") {
      if (!hasAppStore) {
        results.push(`⏭️  Skipping App Store (not registered for App Store)`);
      } else {
        const appStoreResult = await appStoreService.pushAsoData({
          config,
          bundleId,
          localAsoData,
          appStoreDataPath,
        });
        results.push(formatPushResult("App Store", appStoreResult));
      }
    }
  
    return {
      content: [
        {
          type: "text" as const,
          text: `📤 ASO Push Results:\n${results.join("\n")}`,
        },
      ],
    };
  }

• src/index.ts:257-278 (registration)

  Registers the 'aso-push' tool with the MCP server, providing description, input schema validation using Zod, and linking to the handleAsoPush handler.

  registerToolWithInfo(
    "aso-push",
    {
      description: "Push ASO data from local cache to App Store/Google Play.",
      inputSchema: z.object({
        app: z.string().optional().describe("Registered app slug"),
        packageName: z.string().optional().describe("Google Play package name"),
        bundleId: z.string().optional().describe("App Store bundle ID"),
        store: storeSchema.describe("Target store (default: both)"),
        uploadImages: z
          .boolean()
          .optional()
          .describe("Whether to upload images as well"),
        dryRun: z
          .boolean()
          .optional()
          .describe("If true, only outputs result without actually pushing"),
      }),
    },
    handleAsoPush,
    "ASO Data Sync"
  );

• src/tools/aso/push.ts:23-30 (schema)

  TypeScript interface defining input options for the handler, matching the Zod schema.

  interface AsoPushOptions {
    app?: string; // Registered app slug
    packageName?: string; // For Google Play
    bundleId?: string; // For App Store
    store?: StoreType;
    uploadImages?: boolean;
    dryRun?: boolean;
  }