pabal-resource-mcp 1.10.8 → 1.10.9

package/dist/bin/mcp-server.js

@@ -14,7 +14,7 @@ import {
   getPushDataDir,
   loadAsoFromConfig,
   saveAsoToAsoDir
-} from "../chunk-H4MYWLFK.js";
+} from "../chunk-REQG4DR7.js";
 import {
   DEFAULT_LOCALE,
   appStoreToUnified,
@@ -896,17 +896,17 @@ async function downloadScreenshotsToAsoDir(slug, asoData) {
         relativeDir,
         "iphone65"
       );
-      const ipadPro129Paths = await downloadScreenshotArray(
-        localeData.screenshots?.ipadPro129,
+      const ipad13Paths = await downloadScreenshotArray(
+        localeData.screenshots?.ipad13 ?? localeData.screenshots?.ipadPro129,
         asoDir,
         relativeDir,
-        "ipadPro129"
+        "ipad13"
       );
-      const hasDownloadedScreenshots = iphone65Paths.length > 0 || ipadPro129Paths.length > 0;
+      const hasDownloadedScreenshots = iphone65Paths.length > 0 || ipad13Paths.length > 0;
       if (hasDownloadedScreenshots) {
         localeData.screenshots = {
           iphone65: iphone65Paths,
-          ipadPro129: ipadPro129Paths
+          ipad13: ipad13Paths
         };
       }
     }

package/dist/browser.d.ts

@@ -1,4 +1,4 @@
-export { A as APP_STORE_TO_UNIFIED, Y as AppIconConfig, X as AppIconStyleConfig, F as AppMetaLinks, H as AppPageData, t as AppStoreAsoData, p as AppStoreInfoLocalization, d as AppStoreLocale, v as AppStoreMultilingualAsoData, o as AppStoreReleaseNote, r as AppStoreScreenshotDisplayType, s as AppStoreScreenshots, q as AppStoreVersionLocalization, w as AsoData, a1 as AsoLocaleContent, a0 as AsoTemplate, C as BlogArticle, z as BlogMeta, B as BlogMetaBlock, ac as BlogMetaOutput, E as BlogSummary, ad as CreateBlogHtmlInput, af as CreateBlogHtmlResult, D as DEFAULT_LOCALE, R as DeepPartial, M as FeatureItem, G as GOOGLE_PLAY_TO_UNIFIED, ae as GeneratedBlogFile, m as GooglePlayAsoData, j as GooglePlayImageType, h as GooglePlayListing, e as GooglePlayLocale, u as GooglePlayMultilingualAsoData, n as GooglePlayReleaseNote, k as GooglePlayScreenshotType, l as GooglePlayScreenshots, I as ImageAsset, P as LandingCta, N as LandingFeatures, J as LandingHero, Q as LandingPage, V as LandingPageLocale, O as LandingReviews, K as LandingScreenshots, L as LayoutColors, a7 as LocaleDisplayInfo, $ as ProductConfig, _ as ProductContent, a2 as ProductLocale, Z as ProductMetadata, W as ProductScreenshots, ab as ResolvedWorkData, a5 as ScreenshotGeneratorConfig, a4 as ScreenshotGeneratorSlideConfig, a3 as ScreenshotGeneratorThemeTokens, a6 as SiteConfig, a8 as SiteData, S as SupportedLocale, T as Testimonial, U as UNIFIED_LOCALES, a as UNIFIED_TO_APP_STORE, b as UNIFIED_TO_GOOGLE_PLAY, c as UnifiedLocale, a9 as WorkItem, aa as WorkLocaleData, ap as appStoreToGooglePlay, aj as appStoreToUnified, an as appStoreToUnifiedBatch, at as convertObjectFromAppStore, au as convertObjectFromGooglePlay, ar as convertObjectToAppStore, as as convertObjectToGooglePlay, aq as googlePlayToAppStore, ak as googlePlayToUnified, ao as googlePlayToUnifiedBatch, f as isAppStoreLocale, y as isAppStoreMultilingual, g as isGooglePlayLocale, x as isGooglePlayMultilingual, i as isSupportedLocale, ag as unifiedToAppStore, al as unifiedToAppStoreBatch, ai as unifiedToBothPlatforms, ah as unifiedToGooglePlay, am as unifiedToGooglePlayBatch } from './locale-converter-CTItgoKU.js';
+export { A as APP_STORE_TO_UNIFIED, Y as AppIconConfig, X as AppIconStyleConfig, F as AppMetaLinks, H as AppPageData, t as AppStoreAsoData, p as AppStoreInfoLocalization, d as AppStoreLocale, v as AppStoreMultilingualAsoData, o as AppStoreReleaseNote, r as AppStoreScreenshotDisplayType, s as AppStoreScreenshots, q as AppStoreVersionLocalization, w as AsoData, a1 as AsoLocaleContent, a0 as AsoTemplate, C as BlogArticle, z as BlogMeta, B as BlogMetaBlock, ac as BlogMetaOutput, E as BlogSummary, ad as CreateBlogHtmlInput, af as CreateBlogHtmlResult, D as DEFAULT_LOCALE, R as DeepPartial, M as FeatureItem, G as GOOGLE_PLAY_TO_UNIFIED, ae as GeneratedBlogFile, m as GooglePlayAsoData, j as GooglePlayImageType, h as GooglePlayListing, e as GooglePlayLocale, u as GooglePlayMultilingualAsoData, n as GooglePlayReleaseNote, k as GooglePlayScreenshotType, l as GooglePlayScreenshots, I as ImageAsset, P as LandingCta, N as LandingFeatures, J as LandingHero, Q as LandingPage, V as LandingPageLocale, O as LandingReviews, K as LandingScreenshots, L as LayoutColors, a7 as LocaleDisplayInfo, $ as ProductConfig, _ as ProductContent, a2 as ProductLocale, Z as ProductMetadata, W as ProductScreenshots, ab as ResolvedWorkData, a5 as ScreenshotGeneratorConfig, a4 as ScreenshotGeneratorSlideConfig, a3 as ScreenshotGeneratorThemeTokens, a6 as SiteConfig, a8 as SiteData, S as SupportedLocale, T as Testimonial, U as UNIFIED_LOCALES, a as UNIFIED_TO_APP_STORE, b as UNIFIED_TO_GOOGLE_PLAY, c as UnifiedLocale, a9 as WorkItem, aa as WorkLocaleData, ap as appStoreToGooglePlay, aj as appStoreToUnified, an as appStoreToUnifiedBatch, at as convertObjectFromAppStore, au as convertObjectFromGooglePlay, ar as convertObjectToAppStore, as as convertObjectToGooglePlay, aq as googlePlayToAppStore, ak as googlePlayToUnified, ao as googlePlayToUnifiedBatch, f as isAppStoreLocale, y as isAppStoreMultilingual, g as isGooglePlayLocale, x as isGooglePlayMultilingual, i as isSupportedLocale, ag as unifiedToAppStore, al as unifiedToAppStoreBatch, ai as unifiedToBothPlatforms, ah as unifiedToGooglePlay, am as unifiedToGooglePlayBatch } from './locale-converter-CzWIV3a-.js';
 import '@googleapis/androidpublisher';
 import 'appstore-connect-sdk/openapi';
 

package/dist/chunk-REQG4DR7.js

@@ -0,0 +1,418 @@
+import {
+  DEFAULT_LOCALE,
+  isAppStoreLocale,
+  isGooglePlayLocale,
+  isSupportedLocale
+} from "./chunk-BOWRBVVV.js";
+
+// src/utils/config.util.ts
+import fs from "fs";
+import path from "path";
+import os from "os";
+function getAsoDataDir() {
+  const configPath = path.join(
+    os.homedir(),
+    ".config",
+    "pabal-mcp",
+    "config.json"
+  );
+  if (!fs.existsSync(configPath)) {
+    throw new Error(
+      `Config file not found at ${configPath}. Please create the config file and set the 'dataDir' property to specify the ASO data directory.`
+    );
+  }
+  try {
+    const configContent = fs.readFileSync(configPath, "utf-8");
+    const config = JSON.parse(configContent);
+    if (!config.dataDir) {
+      throw new Error(
+        `'dataDir' property is not set in ${configPath}. Please set 'dataDir' to specify the ASO data directory.`
+      );
+    }
+    if (path.isAbsolute(config.dataDir)) {
+      return config.dataDir;
+    }
+    return path.resolve(os.homedir(), config.dataDir);
+  } catch (error) {
+    if (error instanceof Error && error.message.includes("dataDir")) {
+      throw error;
+    }
+    throw new Error(
+      `Failed to read config from ${configPath}: ${error instanceof Error ? error.message : String(error)}`
+    );
+  }
+}
+function getPullDataDir() {
+  return path.join(getAsoDataDir(), ".aso", "pullData");
+}
+function getPushDataDir() {
+  return path.join(getAsoDataDir(), ".aso", "pushData");
+}
+function getPublicDir() {
+  return path.join(getAsoDataDir(), "public");
+}
+function getKeywordResearchDir() {
+  return path.join(getAsoDataDir(), ".aso", "keywordResearch");
+}
+function getProductsDir() {
+  return path.join(getPublicDir(), "products");
+}
+function loadConfig() {
+  const configPath = path.join(
+    os.homedir(),
+    ".config",
+    "pabal-mcp",
+    "config.json"
+  );
+  if (!fs.existsSync(configPath)) {
+    return {};
+  }
+  try {
+    const configContent = fs.readFileSync(configPath, "utf-8");
+    return JSON.parse(configContent);
+  } catch {
+    return {};
+  }
+}
+function getGeminiApiKey() {
+  const config = loadConfig();
+  if (config.gemini?.apiKey) {
+    return config.gemini.apiKey;
+  }
+  const envKey = process.env.GEMINI_API_KEY || process.env.GOOGLE_API_KEY;
+  if (envKey) {
+    return envKey;
+  }
+  throw new Error(
+    `Gemini API key not found. Set it in ~/.config/pabal-mcp/config.json under "gemini.apiKey" or use GEMINI_API_KEY environment variable.`
+  );
+}
+
+// src/utils/aso-converter.ts
+import fs2 from "fs";
+import path2 from "path";
+function generateFullDescription(localeData, metadata = {}) {
+  const { aso, landing } = localeData;
+  const template = aso?.template;
+  if (!template) {
+    return "";
+  }
+  const landingFeatures = landing?.features?.items || [];
+  const landingScreenshots = landing?.screenshots?.images || [];
+  const keyHeading = template.keyFeaturesHeading || "Key Features";
+  const featuresHeading = template.featuresHeading || "Additional Features";
+  const parts = [template.intro];
+  if (landingFeatures.length > 0) {
+    parts.push(
+      "",
+      keyHeading,
+      "",
+      ...landingFeatures.map(
+        (feature) => [`\u25B6\uFE0E ${feature.title}`, feature.body || ""].filter(Boolean).join("\n")
+      )
+    );
+  }
+  if (landingScreenshots.length > 0) {
+    parts.push("", featuresHeading, "");
+    parts.push(
+      ...landingScreenshots.map(
+        (screenshot) => [`\u25B6\uFE0E ${screenshot.title}`, screenshot.description || ""].filter(Boolean).join("\n")
+      )
+    );
+  }
+  parts.push("", template.outro);
+  const includeSupport = template.includeSupportLinks ?? true;
+  if (includeSupport) {
+    const contactLines = [
+      metadata.instagram ? `Instagram: ${metadata.instagram}` : null,
+      metadata.contactEmail ? `Email: ${metadata.contactEmail}` : null,
+      metadata.termsUrl ? `- Terms of Use: ${metadata.termsUrl}` : null,
+      metadata.privacyUrl ? `- Privacy Policy: ${metadata.privacyUrl}` : null
+    ].filter((line) => line !== null);
+    if (contactLines.length > 0) {
+      parts.push("", "[Contact & Support]", "", ...contactLines);
+    }
+  }
+  return parts.join("\n");
+}
+function loadAsoFromConfig(slug) {
+  const productsDir = getProductsDir();
+  const configPath = path2.join(productsDir, slug, "config.json");
+  console.debug(`[loadAsoFromConfig] Looking for ${slug}:`);
+  console.debug(`  - productsDir: ${productsDir}`);
+  console.debug(`  - configPath: ${configPath}`);
+  console.debug(`  - configPath exists: ${fs2.existsSync(configPath)}`);
+  if (!fs2.existsSync(configPath)) {
+    console.warn(`[loadAsoFromConfig] Config file not found at ${configPath}`);
+    return {};
+  }
+  try {
+    const configContent = fs2.readFileSync(configPath, "utf-8");
+    const config = JSON.parse(configContent);
+    const localesDir = path2.join(productsDir, slug, "locales");
+    console.debug(`  - localesDir: ${localesDir}`);
+    console.debug(`  - localesDir exists: ${fs2.existsSync(localesDir)}`);
+    if (!fs2.existsSync(localesDir)) {
+      console.warn(
+        `[loadAsoFromConfig] Locales directory not found at ${localesDir}`
+      );
+      return {};
+    }
+    const localeFiles = fs2.readdirSync(localesDir).filter((f) => f.endsWith(".json"));
+    const locales = {};
+    for (const file of localeFiles) {
+      const localeCode = file.replace(".json", "");
+      const localePath = path2.join(localesDir, file);
+      const localeContent = fs2.readFileSync(localePath, "utf-8");
+      locales[localeCode] = JSON.parse(localeContent);
+    }
+    console.debug(
+      `  - Found ${Object.keys(locales).length} locale file(s): ${Object.keys(
+        locales
+      ).join(", ")}`
+    );
+    if (Object.keys(locales).length === 0) {
+      console.warn(
+        `[loadAsoFromConfig] No locale files found in ${localesDir}`
+      );
+    }
+    const defaultLocale = config.content?.defaultLocale || DEFAULT_LOCALE;
+    const asoData = {};
+    if (config.packageName) {
+      const googlePlayLocales = {};
+      const metadata = config.metadata || {};
+      const screenshots = metadata.screenshots || {};
+      for (const [locale, localeData] of Object.entries(locales)) {
+        if (!isSupportedLocale(locale)) {
+          console.debug(
+            `Skipping locale ${locale} - not a valid unified locale`
+          );
+          continue;
+        }
+        if (!isGooglePlayLocale(locale)) {
+          console.debug(
+            `Skipping locale ${locale} - not supported by Google Play`
+          );
+          continue;
+        }
+        const aso = localeData.aso || {};
+        if (!aso || !aso.title && !aso.shortDescription) {
+          console.warn(
+            `Locale ${locale} has no ASO data (title or shortDescription)`
+          );
+        }
+        const screenshotsDir = path2.join(
+          productsDir,
+          slug,
+          "screenshots",
+          locale
+        );
+        const phoneDir = path2.join(screenshotsDir, "phone");
+        const tabletDir = path2.join(screenshotsDir, "tablet");
+        const featureGraphicPath = path2.join(
+          screenshotsDir,
+          "feature-graphic.png"
+        );
+        const hasPhoneScreenshots = fs2.existsSync(phoneDir);
+        const hasTabletScreenshots = fs2.existsSync(tabletDir);
+        const hasFeatureGraphic = fs2.existsSync(featureGraphicPath);
+        const localeScreenshots = {
+          phone: hasPhoneScreenshots ? screenshots.phone?.map(
+            (p) => p.replace(/\/screenshots\/[^/]+\//, `/screenshots/${locale}/`)
+          ) : void 0,
+          tablet: hasTabletScreenshots ? screenshots.tablet?.map(
+            (p) => p.replace(/\/screenshots\/[^/]+\//, `/screenshots/${locale}/`)
+          ) : void 0
+        };
+        googlePlayLocales[locale] = {
+          title: aso.title || "",
+          shortDescription: aso.shortDescription || "",
+          fullDescription: generateFullDescription(localeData, metadata),
+          packageName: config.packageName,
+          defaultLanguage: locale,
+          screenshots: {
+            phone: localeScreenshots.phone || [],
+            tablet: localeScreenshots.tablet
+          },
+          featureGraphic: hasFeatureGraphic ? `/products/${slug}/screenshots/${locale}/feature-graphic.png` : metadata.featureGraphic
+        };
+      }
+      const googleLocaleKeys = Object.keys(googlePlayLocales);
+      if (googleLocaleKeys.length > 0) {
+        const hasConfigDefault = isGooglePlayLocale(defaultLocale) && Boolean(googlePlayLocales[defaultLocale]);
+        const resolvedDefault = hasConfigDefault ? defaultLocale : googlePlayLocales[DEFAULT_LOCALE] ? DEFAULT_LOCALE : googleLocaleKeys[0];
+        asoData.googlePlay = {
+          locales: googlePlayLocales,
+          defaultLocale: resolvedDefault,
+          // App-level contact information
+          contactEmail: metadata.contactEmail,
+          contactWebsite: metadata.supportUrl,
+          youtubeUrl: metadata.youtubeUrl
+        };
+      }
+    }
+    if (config.bundleId) {
+      const appStoreLocales = {};
+      const metadata = config.metadata || {};
+      const screenshots = metadata.screenshots || {};
+      for (const [locale, localeData] of Object.entries(locales)) {
+        if (!isSupportedLocale(locale)) {
+          console.debug(
+            `Skipping locale ${locale} - not a valid unified locale`
+          );
+          continue;
+        }
+        if (!isAppStoreLocale(locale)) {
+          console.debug(
+            `Skipping locale ${locale} - not supported by App Store`
+          );
+          continue;
+        }
+        const aso = localeData.aso || {};
+        if (!aso || !aso.title && !aso.shortDescription) {
+          console.warn(
+            `Locale ${locale} has no ASO data (title or shortDescription)`
+          );
+        }
+        const screenshotsDir = path2.join(
+          productsDir,
+          slug,
+          "screenshots",
+          locale
+        );
+        const phoneDir = path2.join(screenshotsDir, "phone");
+        const tabletDir = path2.join(screenshotsDir, "tablet");
+        const hasPhoneScreenshots = fs2.existsSync(phoneDir);
+        const hasTabletScreenshots = fs2.existsSync(tabletDir);
+        const localeScreenshots = {
+          phone: hasPhoneScreenshots ? screenshots.phone?.map(
+            (p) => p.replace(/\/screenshots\/[^/]+\//, `/screenshots/${locale}/`)
+          ) : void 0,
+          tablet: hasTabletScreenshots ? screenshots.tablet?.map(
+            (p) => p.replace(/\/screenshots\/[^/]+\//, `/screenshots/${locale}/`)
+          ) : void 0
+        };
+        appStoreLocales[locale] = {
+          name: aso.title || "",
+          subtitle: aso.subtitle,
+          description: generateFullDescription(localeData, metadata),
+          keywords: Array.isArray(aso.keywords) ? aso.keywords.join(",") : aso.keywords,
+          promotionalText: void 0,
+          bundleId: config.bundleId,
+          locale,
+          screenshots: {
+            // Map phone screenshots to iphone65
+            iphone65: localeScreenshots.phone || [],
+            // Map tablet screenshots to iPad 13"
+            ipad13: localeScreenshots.tablet
+          }
+        };
+      }
+      const appStoreLocaleKeys = Object.keys(appStoreLocales);
+      if (appStoreLocaleKeys.length > 0) {
+        const hasConfigDefault = isAppStoreLocale(defaultLocale) && Boolean(appStoreLocales[defaultLocale]);
+        const resolvedDefault = hasConfigDefault ? defaultLocale : appStoreLocales[DEFAULT_LOCALE] ? DEFAULT_LOCALE : appStoreLocaleKeys[0];
+        asoData.appStore = {
+          locales: appStoreLocales,
+          defaultLocale: resolvedDefault,
+          // App-level contact information
+          contactEmail: metadata.contactEmail,
+          supportUrl: metadata.supportUrl,
+          marketingUrl: metadata.marketingUrl,
+          privacyPolicyUrl: metadata.privacyUrl,
+          termsUrl: metadata.termsUrl
+        };
+      }
+    }
+    const hasGooglePlay = !!asoData.googlePlay;
+    const hasAppStore = !!asoData.appStore;
+    console.debug(`[loadAsoFromConfig] Result for ${slug}:`);
+    console.debug(
+      `  - Google Play data: ${hasGooglePlay ? "found" : "not found"}`
+    );
+    console.debug(`  - App Store data: ${hasAppStore ? "found" : "not found"}`);
+    if (!hasGooglePlay && !hasAppStore) {
+      console.warn(`[loadAsoFromConfig] No ASO data generated for ${slug}`);
+    }
+    return asoData;
+  } catch (error) {
+    console.error(
+      `[loadAsoFromConfig] Failed to load ASO data from config for ${slug}:`,
+      error
+    );
+    return {};
+  }
+}
+function saveAsoToConfig(slug, config) {
+  const productsDir = getProductsDir();
+  const configPath = path2.join(productsDir, slug, "config.json");
+  fs2.writeFileSync(configPath, JSON.stringify(config, null, 2) + "\n", "utf-8");
+}
+function saveAsoToAsoDir(slug, asoData) {
+  const rootDir = getPushDataDir();
+  if (asoData.googlePlay) {
+    const asoPath = path2.join(
+      rootDir,
+      "products",
+      slug,
+      "store",
+      "google-play",
+      "aso-data.json"
+    );
+    const dir = path2.dirname(asoPath);
+    if (!fs2.existsSync(dir)) {
+      fs2.mkdirSync(dir, { recursive: true });
+    }
+    const googlePlayData = asoData.googlePlay;
+    const multilingualData = "locales" in googlePlayData ? googlePlayData : {
+      locales: {
+        [googlePlayData.defaultLanguage || DEFAULT_LOCALE]: googlePlayData
+      },
+      defaultLocale: googlePlayData.defaultLanguage || DEFAULT_LOCALE
+    };
+    fs2.writeFileSync(
+      asoPath,
+      JSON.stringify({ googlePlay: multilingualData }, null, 2) + "\n",
+      "utf-8"
+    );
+  }
+  if (asoData.appStore) {
+    const asoPath = path2.join(
+      rootDir,
+      "products",
+      slug,
+      "store",
+      "app-store",
+      "aso-data.json"
+    );
+    const dir = path2.dirname(asoPath);
+    if (!fs2.existsSync(dir)) {
+      fs2.mkdirSync(dir, { recursive: true });
+    }
+    const appStoreData = asoData.appStore;
+    const multilingualData = "locales" in appStoreData ? appStoreData : {
+      locales: {
+        [appStoreData.locale || DEFAULT_LOCALE]: appStoreData
+      },
+      defaultLocale: appStoreData.locale || DEFAULT_LOCALE
+    };
+    fs2.writeFileSync(
+      asoPath,
+      JSON.stringify({ appStore: multilingualData }, null, 2) + "\n",
+      "utf-8"
+    );
+  }
+}
+
+export {
+  getAsoDataDir,
+  getPullDataDir,
+  getPushDataDir,
+  getPublicDir,
+  getKeywordResearchDir,
+  getProductsDir,
+  getGeminiApiKey,
+  loadAsoFromConfig,
+  saveAsoToConfig,
+  saveAsoToAsoDir
+};

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { w as AsoData, $ as ProductConfig } from './locale-converter-CTItgoKU.js';
-export { A as APP_STORE_TO_UNIFIED, Y as AppIconConfig, X as AppIconStyleConfig, F as AppMetaLinks, H as AppPageData, t as AppStoreAsoData, p as AppStoreInfoLocalization, d as AppStoreLocale, v as AppStoreMultilingualAsoData, o as AppStoreReleaseNote, r as AppStoreScreenshotDisplayType, s as AppStoreScreenshots, q as AppStoreVersionLocalization, a1 as AsoLocaleContent, a0 as AsoTemplate, C as BlogArticle, z as BlogMeta, B as BlogMetaBlock, ac as BlogMetaOutput, E as BlogSummary, ad as CreateBlogHtmlInput, af as CreateBlogHtmlResult, D as DEFAULT_LOCALE, R as DeepPartial, M as FeatureItem, G as GOOGLE_PLAY_TO_UNIFIED, ae as GeneratedBlogFile, m as GooglePlayAsoData, j as GooglePlayImageType, h as GooglePlayListing, e as GooglePlayLocale, u as GooglePlayMultilingualAsoData, n as GooglePlayReleaseNote, k as GooglePlayScreenshotType, l as GooglePlayScreenshots, I as ImageAsset, P as LandingCta, N as LandingFeatures, J as LandingHero, Q as LandingPage, V as LandingPageLocale, O as LandingReviews, K as LandingScreenshots, L as LayoutColors, a7 as LocaleDisplayInfo, _ as ProductContent, a2 as ProductLocale, Z as ProductMetadata, W as ProductScreenshots, ab as ResolvedWorkData, a5 as ScreenshotGeneratorConfig, a4 as ScreenshotGeneratorSlideConfig, a3 as ScreenshotGeneratorThemeTokens, a6 as SiteConfig, a8 as SiteData, S as SupportedLocale, T as Testimonial, U as UNIFIED_LOCALES, a as UNIFIED_TO_APP_STORE, b as UNIFIED_TO_GOOGLE_PLAY, c as UnifiedLocale, a9 as WorkItem, aa as WorkLocaleData, ap as appStoreToGooglePlay, aj as appStoreToUnified, an as appStoreToUnifiedBatch, at as convertObjectFromAppStore, au as convertObjectFromGooglePlay, ar as convertObjectToAppStore, as as convertObjectToGooglePlay, aq as googlePlayToAppStore, ak as googlePlayToUnified, ao as googlePlayToUnifiedBatch, f as isAppStoreLocale, y as isAppStoreMultilingual, g as isGooglePlayLocale, x as isGooglePlayMultilingual, i as isSupportedLocale, ag as unifiedToAppStore, al as unifiedToAppStoreBatch, ai as unifiedToBothPlatforms, ah as unifiedToGooglePlay, am as unifiedToGooglePlayBatch } from './locale-converter-CTItgoKU.js';
+import { w as AsoData, $ as ProductConfig } from './locale-converter-CzWIV3a-.js';
+export { A as APP_STORE_TO_UNIFIED, Y as AppIconConfig, X as AppIconStyleConfig, F as AppMetaLinks, H as AppPageData, t as AppStoreAsoData, p as AppStoreInfoLocalization, d as AppStoreLocale, v as AppStoreMultilingualAsoData, o as AppStoreReleaseNote, r as AppStoreScreenshotDisplayType, s as AppStoreScreenshots, q as AppStoreVersionLocalization, a1 as AsoLocaleContent, a0 as AsoTemplate, C as BlogArticle, z as BlogMeta, B as BlogMetaBlock, ac as BlogMetaOutput, E as BlogSummary, ad as CreateBlogHtmlInput, af as CreateBlogHtmlResult, D as DEFAULT_LOCALE, R as DeepPartial, M as FeatureItem, G as GOOGLE_PLAY_TO_UNIFIED, ae as GeneratedBlogFile, m as GooglePlayAsoData, j as GooglePlayImageType, h as GooglePlayListing, e as GooglePlayLocale, u as GooglePlayMultilingualAsoData, n as GooglePlayReleaseNote, k as GooglePlayScreenshotType, l as GooglePlayScreenshots, I as ImageAsset, P as LandingCta, N as LandingFeatures, J as LandingHero, Q as LandingPage, V as LandingPageLocale, O as LandingReviews, K as LandingScreenshots, L as LayoutColors, a7 as LocaleDisplayInfo, _ as ProductContent, a2 as ProductLocale, Z as ProductMetadata, W as ProductScreenshots, ab as ResolvedWorkData, a5 as ScreenshotGeneratorConfig, a4 as ScreenshotGeneratorSlideConfig, a3 as ScreenshotGeneratorThemeTokens, a6 as SiteConfig, a8 as SiteData, S as SupportedLocale, T as Testimonial, U as UNIFIED_LOCALES, a as UNIFIED_TO_APP_STORE, b as UNIFIED_TO_GOOGLE_PLAY, c as UnifiedLocale, a9 as WorkItem, aa as WorkLocaleData, ap as appStoreToGooglePlay, aj as appStoreToUnified, an as appStoreToUnifiedBatch, at as convertObjectFromAppStore, au as convertObjectFromGooglePlay, ar as convertObjectToAppStore, as as convertObjectToGooglePlay, aq as googlePlayToAppStore, ak as googlePlayToUnified, ao as googlePlayToUnifiedBatch, f as isAppStoreLocale, y as isAppStoreMultilingual, g as isGooglePlayLocale, x as isGooglePlayMultilingual, i as isSupportedLocale, ag as unifiedToAppStore, al as unifiedToAppStoreBatch, ai as unifiedToBothPlatforms, ah as unifiedToGooglePlay, am as unifiedToGooglePlayBatch } from './locale-converter-CzWIV3a-.js';
 import '@googleapis/androidpublisher';
 import 'appstore-connect-sdk/openapi';
 

package/dist/index.js

@@ -9,7 +9,7 @@ import {
   loadAsoFromConfig,
   saveAsoToAsoDir,
   saveAsoToConfig
-} from "./chunk-H4MYWLFK.js";
+} from "./chunk-REQG4DR7.js";
 import {
   APP_STORE_TO_UNIFIED,
   DEFAULT_LOCALE,

package/dist/locale-converter-CzWIV3a-.d.ts

@@ -0,0 +1,884 @@
+import { androidpublisher_v3 } from '@googleapis/androidpublisher';
+import { AppStoreVersionAttributes, AppStoreVersionLocalizationAttributes, AppInfoLocalizationAttributes, ScreenshotDisplayType } from 'appstore-connect-sdk/openapi';
+
+/**
+ * Unified locale system for ASO (App Store Optimization)
+ * Consolidates App Store Connect and Google Play Console locale codes
+ */
+/**
+ * Unified locale codes used across the application
+ * These codes are used in /locales directory structure
+ */
+declare const UNIFIED_LOCALES: readonly ["af", "am", "ar", "az-AZ", "be", "bg-BG", "bn-BD", "ca-ES", "cs-CZ", "da-DK", "de-DE", "el-GR", "en-AU", "en-CA", "en-GB", "en-IN", "en-SG", "en-US", "en-ZA", "es-419", "es-ES", "es-US", "et-EE", "eu-ES", "fa", "fa-AE", "fa-AF", "fa-IR", "fi-FI", "fil", "fr-CA", "fr-FR", "gl-ES", "gu", "he-IL", "hi-IN", "hr-HR", "hu-HU", "hy-AM", "id-ID", "is-IS", "it-IT", "ja-JP", "ka-GE", "kk", "km-KH", "kn-IN", "ko-KR", "ky-KG", "lo-LA", "lt-LT", "lv-LV", "mk-MK", "ml-IN", "mn-MN", "mr-IN", "ms", "ms-MY", "my-MM", "ne-NP", "nl-NL", "no-NO", "pa", "pl-PL", "pt-BR", "pt-PT", "rm", "ro-RO", "ru-RU", "si-LK", "sk-SK", "sl-SI", "sq", "sr-RS", "sv-SE", "sw", "ta-IN", "te-IN", "th-TH", "tr-TR", "uk-UA", "ur", "vi-VN", "zh-HK", "zh-Hans", "zh-Hant", "zu"];
+type UnifiedLocale = (typeof UNIFIED_LOCALES)[number];
+/**
+ * Default locale (for fallback)
+ */
+declare const DEFAULT_LOCALE: UnifiedLocale;
+/**
+ * Unified locale to App Store Connect locale mapping
+ * Maps our unified locale codes to App Store Connect API codes
+ */
+declare const UNIFIED_TO_APP_STORE: Record<UnifiedLocale, string | null>;
+/**
+ * Unified locale to Google Play Console locale mapping
+ * Maps our unified locale codes to Google Play Console API codes
+ */
+declare const UNIFIED_TO_GOOGLE_PLAY: Record<UnifiedLocale, string | null>;
+/**
+ * App Store Connect locale to unified locale mapping
+ * Reverse mapping for converting App Store codes to our unified system
+ */
+declare const APP_STORE_TO_UNIFIED: Record<string, UnifiedLocale>;
+/**
+ * Google Play Console locale to unified locale mapping
+ * Reverse mapping for converting Google Play codes to our unified system
+ */
+declare const GOOGLE_PLAY_TO_UNIFIED: Record<string, UnifiedLocale>;
+/**
+ * Locales supported by App Store Connect
+ */
+declare const APP_STORE_SUPPORTED_LOCALES: ("af" | "am" | "ar" | "az-AZ" | "be" | "bg-BG" | "bn-BD" | "ca-ES" | "cs-CZ" | "da-DK" | "de-DE" | "el-GR" | "en-AU" | "en-CA" | "en-GB" | "en-IN" | "en-SG" | "en-US" | "en-ZA" | "es-419" | "es-ES" | "es-US" | "et-EE" | "eu-ES" | "fa" | "fa-AE" | "fa-AF" | "fa-IR" | "fi-FI" | "fil" | "fr-CA" | "fr-FR" | "gl-ES" | "gu" | "he-IL" | "hi-IN" | "hr-HR" | "hu-HU" | "hy-AM" | "id-ID" | "is-IS" | "it-IT" | "ja-JP" | "ka-GE" | "kk" | "km-KH" | "kn-IN" | "ko-KR" | "ky-KG" | "lo-LA" | "lt-LT" | "lv-LV" | "mk-MK" | "ml-IN" | "mn-MN" | "mr-IN" | "ms" | "ms-MY" | "my-MM" | "ne-NP" | "nl-NL" | "no-NO" | "pa" | "pl-PL" | "pt-BR" | "pt-PT" | "rm" | "ro-RO" | "ru-RU" | "si-LK" | "sk-SK" | "sl-SI" | "sq" | "sr-RS" | "sv-SE" | "sw" | "ta-IN" | "te-IN" | "th-TH" | "tr-TR" | "uk-UA" | "ur" | "vi-VN" | "zh-HK" | "zh-Hans" | "zh-Hant" | "zu")[];
+/**
+ * Locales supported by Google Play Console
+ */
+declare const GOOGLE_PLAY_SUPPORTED_LOCALES: ("af" | "am" | "ar" | "az-AZ" | "be" | "bg-BG" | "bn-BD" | "ca-ES" | "cs-CZ" | "da-DK" | "de-DE" | "el-GR" | "en-AU" | "en-CA" | "en-GB" | "en-IN" | "en-SG" | "en-US" | "en-ZA" | "es-419" | "es-ES" | "es-US" | "et-EE" | "eu-ES" | "fa" | "fa-AE" | "fa-AF" | "fa-IR" | "fi-FI" | "fil" | "fr-CA" | "fr-FR" | "gl-ES" | "gu" | "he-IL" | "hi-IN" | "hr-HR" | "hu-HU" | "hy-AM" | "id-ID" | "is-IS" | "it-IT" | "ja-JP" | "ka-GE" | "kk" | "km-KH" | "kn-IN" | "ko-KR" | "ky-KG" | "lo-LA" | "lt-LT" | "lv-LV" | "mk-MK" | "ml-IN" | "mn-MN" | "mr-IN" | "ms" | "ms-MY" | "my-MM" | "ne-NP" | "nl-NL" | "no-NO" | "pa" | "pl-PL" | "pt-BR" | "pt-PT" | "rm" | "ro-RO" | "ru-RU" | "si-LK" | "sk-SK" | "sl-SI" | "sq" | "sr-RS" | "sv-SE" | "sw" | "ta-IN" | "te-IN" | "th-TH" | "tr-TR" | "uk-UA" | "ur" | "vi-VN" | "zh-HK" | "zh-Hans" | "zh-Hant" | "zu")[];
+
+/**
+ * ASO (App Store Optimization) data type definitions
+ */
+
+/**
+ * Unified locale type used across the application
+ * This type represents the unified locale codes used in /locales directory
+ */
+type SupportedLocale = UnifiedLocale;
+/**
+ * App Store Connect specific locale type
+ */
+type AppStoreLocale = (typeof APP_STORE_SUPPORTED_LOCALES)[number];
+/**
+ * Google Play Console specific locale type
+ */
+type GooglePlayLocale = (typeof GOOGLE_PLAY_SUPPORTED_LOCALES)[number];
+/**
+ * Check if locale is supported by our unified system
+ */
+declare function isSupportedLocale(locale: string): locale is SupportedLocale;
+/**
+ * Check if locale is supported by App Store
+ */
+declare function isAppStoreLocale(locale: string): locale is AppStoreLocale;
+/**
+ * Check if locale is supported by Google Play
+ */
+declare function isGooglePlayLocale(locale: string): locale is GooglePlayLocale;
+/**
+ * Google Play Android Publisher base types
+ */
+type GooglePlayListing = androidpublisher_v3.Schema$Listing;
+type GooglePlayImageType = NonNullable<androidpublisher_v3.Params$Resource$Edits$Images$List["imageType"]>;
+type GooglePlayScreenshotType = Extract<GooglePlayImageType, "phoneScreenshots" | "sevenInchScreenshots" | "tenInchScreenshots" | "tvScreenshots" | "wearScreenshots">;
+/**
+ * Google Play screenshots keyed by Android Publisher imageType
+ * Includes legacy aliases for existing data structures
+ */
+interface GooglePlayScreenshots extends Partial<Record<GooglePlayScreenshotType, string[]>> {
+    phone?: string[];
+    tablet?: string[];
+    tablet7?: string[];
+    tablet10?: string[];
+    tv?: string[];
+    wear?: string[];
+}
+/**
+ * Google Play Store ASO data
+ */
+interface GooglePlayAsoData extends Pick<GooglePlayListing, "video" | "language"> {
+    title: NonNullable<GooglePlayListing["title"]>;
+    shortDescription: NonNullable<GooglePlayListing["shortDescription"]>;
+    fullDescription: NonNullable<GooglePlayListing["fullDescription"]>;
+    screenshots: GooglePlayScreenshots;
+    featureGraphic?: string;
+    promoGraphic?: string;
+    category?: string;
+    contentRating?: string;
+    keywords?: string[];
+    contactEmail?: string;
+    contactPhone?: string;
+    contactWebsite?: string;
+    packageName: string;
+    defaultLanguage: string;
+}
+/**
+ * Google Play release notes (per version)
+ */
+type GooglePlayReleaseNote = androidpublisher_v3.Schema$TrackRelease;
+/**
+ * App Store release notes (per version)
+ */
+type AppStoreReleaseNote = Pick<AppStoreVersionAttributes, "versionString" | "platform"> & {
+    releaseNotes: Record<string, NonNullable<AppStoreVersionLocalizationAttributes["whatsNew"]>>;
+    releaseDate?: string;
+};
+/**
+ * App Store Connect base types
+ */
+type AppStoreInfoLocalization = AppInfoLocalizationAttributes;
+type AppStoreVersionLocalization = AppStoreVersionLocalizationAttributes;
+type AppStoreScreenshotDisplayType = ScreenshotDisplayType;
+/**
+ * App Store screenshots keyed by official display type
+ * Includes legacy aliases used in existing data structures
+ */
+interface AppStoreScreenshots extends Partial<Record<AppStoreScreenshotDisplayType, string[]>> {
+    iphone65?: string[];
+    iphone61?: string[];
+    iphone58?: string[];
+    iphone55?: string[];
+    iphone47?: string[];
+    iphone40?: string[];
+    ipad13?: string[];
+    ipadPro129?: string[];
+    ipadPro11?: string[];
+    ipad105?: string[];
+    ipad97?: string[];
+    appleWatch?: string[];
+}
+/**
+ * App Store ASO data
+ */
+interface AppStoreAsoData {
+    name: NonNullable<AppStoreInfoLocalization["name"]>;
+    subtitle?: AppStoreInfoLocalization["subtitle"];
+    description: NonNullable<AppStoreVersionLocalization["description"]>;
+    keywords?: AppStoreVersionLocalization["keywords"];
+    promotionalText?: AppStoreVersionLocalization["promotionalText"];
+    screenshots: AppStoreScreenshots;
+    appPreview?: string[];
+    primaryCategory?: string;
+    secondaryCategory?: string;
+    contentRightId?: string;
+    supportUrl?: AppStoreVersionLocalization["supportUrl"];
+    marketingUrl?: AppStoreVersionLocalization["marketingUrl"];
+    privacyPolicyUrl?: AppStoreInfoLocalization["privacyPolicyUrl"];
+    termsUrl?: string;
+    bundleId: string;
+    locale: NonNullable<AppStoreVersionLocalization["locale"]>;
+    whatsNew?: AppStoreVersionLocalization["whatsNew"];
+}
+/**
+ * Multilingual Google Play ASO data
+ */
+interface GooglePlayMultilingualAsoData {
+    locales: {
+        [locale: string]: GooglePlayAsoData;
+    };
+    defaultLocale?: string;
+    contactEmail?: string;
+    contactWebsite?: string;
+    youtubeUrl?: string;
+}
+/**
+ * Multilingual App Store ASO data
+ */
+interface AppStoreMultilingualAsoData {
+    locales: {
+        [locale: string]: AppStoreAsoData;
+    };
+    defaultLocale?: string;
+    contactEmail?: string;
+    supportUrl?: string;
+    marketingUrl?: string;
+    privacyPolicyUrl?: string;
+    termsUrl?: string;
+}
+/**
+ * Unified ASO data (format stored in local config.json)
+ * Supports single language (legacy compatible) or multilingual structure
+ */
+interface AsoData {
+    googlePlay?: GooglePlayAsoData | GooglePlayMultilingualAsoData;
+    appStore?: AppStoreAsoData | AppStoreMultilingualAsoData;
+    lastSynced?: {
+        googlePlay?: string;
+        appStore?: string;
+    };
+}
+/**
+ * Check if Google Play data is multilingual structure
+ */
+declare function isGooglePlayMultilingual(data: GooglePlayAsoData | GooglePlayMultilingualAsoData | undefined): data is GooglePlayMultilingualAsoData;
+/**
+ * Check if App Store data is multilingual structure
+ */
+declare function isAppStoreMultilingual(data: AppStoreAsoData | AppStoreMultilingualAsoData | undefined): data is AppStoreMultilingualAsoData;
+
+/**
+ * Blog type definitions
+ * Used by both MCP tools and web application
+ */
+/**
+ * Blog Meta Block (raw from HTML comment)
+ * All fields are optional as they may be parsed from HTML or defaults
+ */
+interface BlogMetaBlock {
+    title: string;
+    description: string;
+    appSlug: string;
+    slug: string;
+    locale?: string;
+    coverImage?: string;
+    publishedAt?: string;
+    modifiedAt?: string;
+    tags?: string[];
+}
+/**
+ * Blog Meta (resolved with UnifiedLocale)
+ * Used by web application after normalization
+ */
+interface BlogMeta extends BlogMetaBlock {
+    locale: UnifiedLocale;
+    coverImage?: string;
+    publishedAt?: string;
+    modifiedAt?: string;
+}
+/**
+ * Blog Article (complete parsed article with HTML content)
+ */
+interface BlogArticle {
+    appSlug: string;
+    slug: string;
+    locale: UnifiedLocale;
+    html: string;
+    meta: BlogMeta;
+    filePath: string;
+}
+/**
+ * Blog Summary (aggregated metadata across locales)
+ */
+interface BlogSummary {
+    appSlug: string;
+    slug: string;
+    title: string;
+    description: string;
+    coverImage?: string;
+    publishedAt?: string;
+    modifiedAt?: string;
+    locales: UnifiedLocale[];
+    defaultLocale: UnifiedLocale;
+}
+
+interface ImageAsset {
+    src: string;
+    alt: string;
+    width?: number;
+    height?: number;
+    srcDark?: string;
+}
+interface LandingHero {
+    brand?: string;
+    logoPath?: string;
+    title?: string;
+    titleHighlight?: string;
+    description: string;
+}
+interface LandingScreenshots {
+    title?: string;
+    images: Array<{
+        imageSrc: string;
+        width?: number;
+        height?: number;
+        title: string;
+        description: string;
+    }>;
+}
+interface FeatureItem {
+    title: string;
+    body: string;
+    iconPath?: string;
+    iconName?: string;
+    media?: ImageAsset;
+    badge?: string;
+}
+interface LandingFeatures {
+    title: string;
+    items: FeatureItem[];
+}
+interface Testimonial {
+    authorName: string;
+    handle?: string;
+    avatarPath?: string;
+    quote: string;
+    rating?: number;
+}
+interface LandingReviews {
+    title?: string;
+    description?: string;
+    testimonials: Testimonial[];
+    icons?: string[];
+    rating?: number;
+}
+interface LandingCta {
+    headline: string;
+    icons?: string[];
+    rating?: number;
+    description?: string;
+}
+interface LandingPage {
+    hero: LandingHero;
+    screenshots: LandingScreenshots;
+    features: LandingFeatures;
+    reviews: LandingReviews;
+    cta: LandingCta;
+}
+type DeepPartial<T> = T extends (infer U)[] ? Array<DeepPartial<U>> : T extends object ? {
+    [P in keyof T]?: DeepPartial<T[P]>;
+} : T;
+type LandingPageLocale = DeepPartial<LandingPage>;
+
+/**
+ * Product Config JSON file type definitions
+ * Structure for public/products/{slug}/config.json
+ */
+/**
+ * Screenshot metadata
+ */
+interface ProductScreenshots {
+    /**
+     * When true, the first screenshot is a marketing cover.
+     * Detail pages may use it in the hero while excluding it from feature galleries.
+     */
+    hasCover?: boolean;
+    phone?: string[];
+    tablet?: string[];
+}
+/**
+ * App Icon style configuration
+ */
+interface AppIconStyleConfig {
+    backgroundColor?: string;
+    alignment?: "center" | "left" | "right" | "top" | "bottom" | "top-left" | "top-right" | "bottom-left" | "bottom-right";
+}
+/**
+ * App Icon configuration
+ */
+interface AppIconConfig {
+    /** Default background color for app icons (hex format, e.g., "#FFFFFF") */
+    defaultBackgroundColor?: string;
+    /** Default logo alignment */
+    defaultAlignment?: "center" | "left" | "right" | "top" | "bottom" | "top-left" | "top-right" | "bottom-left" | "bottom-right";
+    /** Style-specific configurations (e.g., christmas, halloween) */
+    styles?: Record<string, AppIconStyleConfig>;
+}
+/**
+ * Product Metadata (store-common metadata)
+ */
+interface ProductMetadata {
+    category?: string;
+    contactEmail?: string;
+    instagram?: string;
+    supportUrl?: string;
+    marketingUrl?: string;
+    termsUrl?: string;
+    privacyUrl?: string;
+    youtubeUrl?: string;
+    screenshots?: ProductScreenshots;
+    featureGraphic?: string;
+    /** Background color for screenshot resizing (hex format, e.g., "#FFFFFF") */
+    screenshotBgColor?: string;
+}
+/**
+ * Product Content settings
+ */
+interface ProductContent {
+    defaultLocale?: string;
+}
+/**
+ * Product Config (complete config.json structure)
+ *
+ * Based on actual config.json file structure,
+ * includes additional fields used by existing code.
+ */
+interface ProductConfig {
+    slug: string;
+    order?: number;
+    appStoreAppId?: string;
+    packageName?: string;
+    bundleId?: string;
+    isHiddenAtHomepage?: boolean;
+    isHiddenOnHome?: boolean;
+    layoutColors?: LayoutColors;
+    metadata?: ProductMetadata;
+    content?: ProductContent;
+    appIcon?: AppIconConfig;
+    extraPaths?: string[];
+    name?: string;
+    tagline?: string;
+    webUrl?: string;
+    hasDetailPage?: boolean;
+    isDarkIcon?: boolean;
+    landing?: LandingPage;
+}
+
+interface LayoutColors {
+    bg?: string;
+    fg?: string;
+    fgMuted?: string;
+    muted?: string;
+    accentGrad?: string;
+}
+interface AppMetaLinks {
+    privacyPath: string;
+    termsPath: string;
+    backPath: string;
+}
+interface AppPageData {
+    product?: ProductConfig;
+    links: AppMetaLinks;
+    privacy: string;
+    terms: string;
+    layoutColors?: LayoutColors;
+    landing?: LandingPage;
+}
+
+interface AsoTemplate {
+    intro: string;
+    keyFeaturesHeading?: string;
+    featuresHeading?: string;
+    outro: string;
+    includeSupportLinks?: boolean;
+}
+interface AsoLocaleContent {
+    title?: string;
+    subtitle?: string;
+    shortDescription?: string;
+    keywords?: string[] | string;
+    template?: AsoTemplate;
+}
+interface ProductLocale {
+    aso?: AsoLocaleContent;
+    landing?: LandingPageLocale;
+}
+
+/**
+ * Screenshot generator configuration types
+ * Structure for public/products/{slug}/screenshot-generator.config.json
+ */
+interface ScreenshotGeneratorThemeTokens {
+    backgroundStart: string;
+    backgroundEnd: string;
+    panel: string;
+    textPrimary: string;
+    textSecondary: string;
+    accent: string;
+}
+interface ScreenshotGeneratorSlideConfig {
+    fileName: string;
+    badge?: string;
+    headline?: string;
+}
+interface ScreenshotGeneratorConfig {
+    title?: string;
+    subtitle?: string;
+    statusLabel?: string;
+    layoutVariant?: "showcase-dark" | "clean-light";
+    accentGradient?: string;
+    theme?: Partial<ScreenshotGeneratorThemeTokens>;
+    slides?: ScreenshotGeneratorSlideConfig[];
+}
+
+/**
+ * Site data type definitions
+ * Structure for public/site/ directory
+ * - config.json: Site configuration (supported locales, default locale)
+ * - contacts.json: Contact information
+ * - locales/en-US.json: Localized content (meta, hero, developer)
+ */
+
+/**
+ * Site configuration for locale support
+ * Stored in public/site/config.json
+ */
+interface SiteConfig {
+    /** List of locales supported by this site */
+    supportedLocales: UnifiedLocale[];
+    /** Default locale for fallback */
+    defaultLocale: UnifiedLocale;
+}
+/**
+ * Locale display information for UI components
+ */
+interface LocaleDisplayInfo {
+    /** Locale code (e.g., "en-US", "ko-KR") */
+    code: UnifiedLocale;
+    /** English name of the language */
+    name: string;
+    /** Native name of the language */
+    nativeName: string;
+    /** Flag emoji */
+    flag: string;
+}
+interface SiteData {
+    meta: {
+        title: string;
+        description: string;
+    };
+    hero: {
+        brand: string;
+        tagline: string;
+        subtitle: string;
+    };
+    contacts: {
+        id: string;
+        label: string;
+        icon: string;
+        value: string;
+    }[];
+    developer: {
+        name: string;
+        heading: string;
+        role: string;
+        bio: string;
+        principles: string[];
+        stack: string[];
+        now: string;
+        availability: string;
+        likes: string[];
+        location?: string;
+        timezone?: string;
+        visited: {
+            countries: {
+                code: string;
+                name: string;
+                flagEmoji: string;
+                cities: string[];
+            }[];
+        };
+    };
+}
+
+interface WorkItem {
+    id: string;
+    title: string;
+    summary: string;
+    period?: string;
+    screenshotUrl?: string;
+    techStack?: string[];
+    tags?: string[];
+    links?: string[];
+    order?: number;
+}
+interface WorkLocaleData {
+    items: WorkItem[];
+}
+interface ResolvedWorkData {
+    items: WorkItem[];
+    usedLocale: string;
+}
+
+/**
+ * Types for the create-blog-html MCP tool
+ */
+/**
+ * BlogMetaOutput for MCP tool output
+ * All fields are required (resolved values)
+ * Note: This is separate from blog.types.ts BlogMeta which uses UnifiedLocale
+ */
+interface BlogMetaOutput {
+    title: string;
+    description: string;
+    appSlug: string;
+    slug: string;
+    locale: string;
+    publishedAt: string;
+    modifiedAt: string;
+    coverImage: string;
+    tags: string[];
+}
+interface CreateBlogHtmlInput {
+    /**
+     * Product/app slug used for paths and CTAs.
+     * Defaults to "developer-journal" when not provided.
+     */
+    appSlug: string;
+    /**
+     * English title used for slug creation and H1
+     */
+    title?: string;
+    /**
+     * Topic/angle to cover inside the article body
+     */
+    topic: string;
+    /**
+     * Single locale to generate (REQUIRED). Ignored when locales[] is provided.
+     */
+    locale: string;
+    /**
+     * Optional list of locales to generate. Each gets its own HTML file.
+     */
+    locales?: string[];
+    /**
+     * HTML content for the blog body. REQUIRED. The LLM must generate this based on the topic and locale.
+     * Structure should follow public/en-US.html pattern.
+     */
+    content: string;
+    /**
+     * Meta description override. If absent, a locale-aware summary is generated from topic/appSlug.
+     */
+    description?: string;
+    /**
+     * Optional tags for BLOG_META. If absent, tags are derived from topic and appSlug.
+     */
+    tags?: string[];
+    /**
+     * Optional cover image. Relative paths are rewritten to /blogs/<app>/<slug>/...
+     */
+    coverImage?: string;
+    /**
+     * Include a relative image example in the body (./images/hero.png by default).
+     */
+    includeRelativeImageExample?: boolean;
+    /**
+     * Override the relative image path used when includeRelativeImageExample is true.
+     */
+    relativeImagePath?: string;
+    /**
+     * Publish date (YYYY-MM-DD). Defaults to today.
+     */
+    publishedAt?: string;
+    /**
+     * Last modified date (YYYY-MM-DD). Defaults to publishedAt.
+     */
+    modifiedAt?: string;
+    /**
+     * Overwrite existing HTML files when true (default false).
+     */
+    overwrite?: boolean;
+}
+interface GeneratedBlogFile {
+    locale: string;
+    path: string;
+}
+interface CreateBlogHtmlResult {
+    slug: string;
+    baseDir: string;
+    files: GeneratedBlogFile[];
+    coverImage: string;
+    metaByLocale: Record<string, BlogMetaOutput>;
+}
+
+/**
+ * Locale conversion utilities for ASO platforms
+ * Handles conversion between unified locales and platform-specific locale codes
+ */
+
+/**
+ * Convert unified locale to App Store Connect locale
+ * Returns null if the locale is not supported by App Store
+ *
+ * @param locale - Unified locale code (e.g., "ar", "zh-Hans")
+ * @returns App Store locale code (e.g., "ar-SA", "zh-Hans") or null
+ *
+ * @example
+ * unifiedToAppStore("ar") // Returns "ar-SA"
+ * unifiedToAppStore("zh-Hans") // Returns "zh-Hans"
+ * unifiedToAppStore("en-IN") // Returns null (not supported)
+ */
+declare function unifiedToAppStore(locale: UnifiedLocale): string | null;
+/**
+ * Convert unified locale to Google Play Console locale
+ * Returns null if the locale is not supported by Google Play
+ *
+ * @param locale - Unified locale code (e.g., "ar", "zh-Hans")
+ * @returns Google Play locale code (e.g., "ar-SA", "zh-CN") or null
+ *
+ * @example
+ * unifiedToGooglePlay("ar") // Returns "ar-SA"
+ * unifiedToGooglePlay("zh-Hans") // Returns "zh-CN"
+ * unifiedToGooglePlay("bg-BG") // Returns "bg-BG"
+ */
+declare function unifiedToGooglePlay(locale: UnifiedLocale): string | null;
+/**
+ * Convert unified locale to both platforms
+ * Returns an object with App Store and Google Play locale codes
+ *
+ * @param locale - Unified locale code
+ * @returns Object with appStore and googlePlay locale codes (or null if not supported)
+ *
+ * @example
+ * unifiedToBothPlatforms("ar")
+ * // Returns { appStore: "ar-SA", googlePlay: "ar-SA" }
+ *
+ * unifiedToBothPlatforms("zh-Hans")
+ * // Returns { appStore: "zh-Hans", googlePlay: "zh-CN" }
+ */
+declare function unifiedToBothPlatforms(locale: UnifiedLocale): {
+    appStore: string | null;
+    googlePlay: string | null;
+};
+/**
+ * Convert App Store Connect locale to unified locale
+ * Returns the default locale if the App Store locale is not recognized
+ *
+ * @param locale - App Store locale code (e.g., "ar-SA", "zh-Hans")
+ * @returns Unified locale code (e.g., "ar", "zh-Hans")
+ *
+ * @example
+ * appStoreToUnified("ar-SA") // Returns "ar"
+ * appStoreToUnified("zh-Hans") // Returns "zh-Hans"
+ * appStoreToUnified("es-MX") // Returns "es-419"
+ */
+declare function appStoreToUnified(locale: string): UnifiedLocale;
+/**
+ * Convert Google Play Console locale to unified locale
+ * Returns the default locale if the Google Play locale is not recognized
+ *
+ * @param locale - Google Play locale code (e.g., "ar-SA", "zh-CN")
+ * @returns Unified locale code (e.g., "ar", "zh-Hans")
+ *
+ * @example
+ * googlePlayToUnified("ar-SA") // Returns "ar"
+ * googlePlayToUnified("zh-CN") // Returns "zh-Hans"
+ * googlePlayToUnified("zh-TW") // Returns "zh-Hant"
+ */
+declare function googlePlayToUnified(locale: string): UnifiedLocale;
+/**
+ * Convert multiple unified locales to App Store locales
+ * Filters out locales not supported by App Store
+ *
+ * @param locales - Array of unified locale codes
+ * @returns Array of App Store locale codes (excluding unsupported locales)
+ *
+ * @example
+ * unifiedToAppStoreBatch(["ar", "zh-Hans", "en-IN"])
+ * // Returns ["ar-SA", "zh-Hans"] (en-IN is not supported by App Store)
+ */
+declare function unifiedToAppStoreBatch(locales: UnifiedLocale[]): string[];
+/**
+ * Convert multiple unified locales to Google Play locales
+ * Filters out locales not supported by Google Play
+ *
+ * @param locales - Array of unified locale codes
+ * @returns Array of Google Play locale codes (excluding unsupported locales)
+ *
+ * @example
+ * unifiedToGooglePlayBatch(["ar", "zh-Hans", "bg-BG"])
+ * // Returns ["ar-SA", "zh-CN", "bg-BG"]
+ */
+declare function unifiedToGooglePlayBatch(locales: UnifiedLocale[]): string[];
+/**
+ * Convert multiple App Store locales to unified locales
+ *
+ * @param locales - Array of App Store locale codes
+ * @returns Array of unified locale codes
+ *
+ * @example
+ * appStoreToUnifiedBatch(["ar-SA", "zh-Hans", "es-MX"])
+ * // Returns ["ar", "zh-Hans", "es-419"]
+ */
+declare function appStoreToUnifiedBatch(locales: string[]): UnifiedLocale[];
+/**
+ * Convert multiple Google Play locales to unified locales
+ *
+ * @param locales - Array of Google Play locale codes
+ * @returns Array of unified locale codes
+ *
+ * @example
+ * googlePlayToUnifiedBatch(["ar-SA", "zh-CN", "zh-TW"])
+ * // Returns ["ar", "zh-Hans", "zh-Hant"]
+ */
+declare function googlePlayToUnifiedBatch(locales: string[]): UnifiedLocale[];
+/**
+ * Convert App Store locale to Google Play locale
+ * Goes through unified locale as intermediate step
+ *
+ * @param locale - App Store locale code
+ * @returns Google Play locale code or null if conversion not possible
+ *
+ * @example
+ * appStoreToGooglePlay("ar-SA") // Returns "ar-SA"
+ * appStoreToGooglePlay("zh-Hans") // Returns "zh-CN"
+ * appStoreToGooglePlay("es-MX") // Returns "es-419"
+ */
+declare function appStoreToGooglePlay(locale: string): string | null;
+/**
+ * Convert Google Play locale to App Store locale
+ * Goes through unified locale as intermediate step
+ *
+ * @param locale - Google Play locale code
+ * @returns App Store locale code or null if conversion not possible
+ *
+ * @example
+ * googlePlayToAppStore("ar-SA") // Returns "ar-SA"
+ * googlePlayToAppStore("zh-CN") // Returns "zh-Hans"
+ * googlePlayToAppStore("zh-TW") // Returns "zh-Hant"
+ * googlePlayToAppStore("en-IN") // Returns null (not supported by App Store)
+ */
+declare function googlePlayToAppStore(locale: string): string | null;
+/**
+ * Convert an object with unified locale keys to App Store locale keys
+ * Useful for converting locale-based data structures
+ *
+ * @param data - Object with unified locale keys
+ * @returns Object with App Store locale keys (excluding unsupported locales)
+ *
+ * @example
+ * convertObjectToAppStore({
+ *   "ar": "مرحبا",
+ *   "zh-Hans": "你好",
+ *   "en-IN": "Hello"
+ * })
+ * // Returns { "ar-SA": "مرحبا", "zh-Hans": "你好" }
+ */
+declare function convertObjectToAppStore<T>(data: Record<UnifiedLocale, T>): Record<string, T>;
+/**
+ * Convert an object with unified locale keys to Google Play locale keys
+ * Useful for converting locale-based data structures
+ *
+ * @param data - Object with unified locale keys
+ * @returns Object with Google Play locale keys (excluding unsupported locales)
+ *
+ * @example
+ * convertObjectToGooglePlay({
+ *   "ar": "مرحبا",
+ *   "zh-Hans": "你好",
+ *   "zh-Hant": "你好"
+ * })
+ * // Returns { "ar-SA": "مرحبا", "zh-CN": "你好", "zh-TW": "你好" }
+ */
+declare function convertObjectToGooglePlay<T>(data: Record<UnifiedLocale, T>): Record<string, T>;
+/**
+ * Convert an object with App Store locale keys to unified locale keys
+ * Useful for converting locale-based data structures from App Store
+ *
+ * @param data - Object with App Store locale keys
+ * @returns Object with unified locale keys
+ *
+ * @example
+ * convertObjectFromAppStore({
+ *   "ar-SA": "مرحبا",
+ *   "zh-Hans": "你好",
+ *   "es-MX": "Hola"
+ * })
+ * // Returns { "ar": "مرحبا", "zh-Hans": "你好", "es-419": "Hola" }
+ */
+declare function convertObjectFromAppStore<T>(data: Record<string, T>): Record<UnifiedLocale, T>;
+/**
+ * Convert an object with Google Play locale keys to unified locale keys
+ * Useful for converting locale-based data structures from Google Play
+ *
+ * @param data - Object with Google Play locale keys
+ * @returns Object with unified locale keys
+ *
+ * @example
+ * convertObjectFromGooglePlay({
+ *   "ar-SA": "مرحبا",
+ *   "zh-CN": "你好",
+ *   "zh-TW": "你好"
+ * })
+ * // Returns { "ar": "مرحبا", "zh-Hans": "你好", "zh-Hant": "你好" }
+ */
+declare function convertObjectFromGooglePlay<T>(data: Record<string, T>): Record<UnifiedLocale, T>;
+
+export { type ProductConfig as $, APP_STORE_TO_UNIFIED as A, type BlogMetaBlock as B, type BlogArticle as C, DEFAULT_LOCALE as D, type BlogSummary as E, type AppMetaLinks as F, GOOGLE_PLAY_TO_UNIFIED as G, type AppPageData as H, type ImageAsset as I, type LandingHero as J, type LandingScreenshots as K, type LayoutColors as L, type FeatureItem as M, type LandingFeatures as N, type LandingReviews as O, type LandingCta as P, type LandingPage as Q, type DeepPartial as R, type SupportedLocale as S, type Testimonial as T, UNIFIED_LOCALES as U, type LandingPageLocale as V, type ProductScreenshots as W, type AppIconStyleConfig as X, type AppIconConfig as Y, type ProductMetadata as Z, type ProductContent as _, UNIFIED_TO_APP_STORE as a, type AsoTemplate as a0, type AsoLocaleContent as a1, type ProductLocale as a2, type ScreenshotGeneratorThemeTokens as a3, type ScreenshotGeneratorSlideConfig as a4, type ScreenshotGeneratorConfig as a5, type SiteConfig as a6, type LocaleDisplayInfo as a7, type SiteData as a8, type WorkItem as a9, type WorkLocaleData as aa, type ResolvedWorkData as ab, type BlogMetaOutput as ac, type CreateBlogHtmlInput as ad, type GeneratedBlogFile as ae, type CreateBlogHtmlResult as af, unifiedToAppStore as ag, unifiedToGooglePlay as ah, unifiedToBothPlatforms as ai, appStoreToUnified as aj, googlePlayToUnified as ak, unifiedToAppStoreBatch as al, unifiedToGooglePlayBatch as am, appStoreToUnifiedBatch as an, googlePlayToUnifiedBatch as ao, appStoreToGooglePlay as ap, googlePlayToAppStore as aq, convertObjectToAppStore as ar, convertObjectToGooglePlay as as, convertObjectFromAppStore as at, convertObjectFromGooglePlay as au, UNIFIED_TO_GOOGLE_PLAY as b, type UnifiedLocale as c, type AppStoreLocale as d, type GooglePlayLocale as e, isAppStoreLocale as f, isGooglePlayLocale as g, type GooglePlayListing as h, isSupportedLocale as i, type GooglePlayImageType as j, type GooglePlayScreenshotType as k, type GooglePlayScreenshots as l, type GooglePlayAsoData as m, type GooglePlayReleaseNote as n, type AppStoreReleaseNote as o, type AppStoreInfoLocalization as p, type AppStoreVersionLocalization as q, type AppStoreScreenshotDisplayType as r, type AppStoreScreenshots as s, type AppStoreAsoData as t, type GooglePlayMultilingualAsoData as u, type AppStoreMultilingualAsoData as v, type AsoData as w, isGooglePlayMultilingual as x, isAppStoreMultilingual as y, type BlogMeta as z };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pabal-resource-mcp",
-  "version": "1.10.8",
+  "version": "1.10.9",
   "type": "module",
   "description": "MCP server for ASO data management with shared types and utilities",
   "author": "skyu",