pabal-store-api-mcp 1.1.0

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

@@ -0,0 +1,71 @@
+export const ERROR_CODES = {
+    // Common
+    INTERNAL_ERROR: "INTERNAL_ERROR",
+    CLIENT_FACTORY_ERROR: "CLIENT_FACTORY_ERROR",
+    // Config/Secrets
+    CONFIG_ERROR: "CONFIG_ERROR",
+    CONFIG_NOT_FOUND: "CONFIG_NOT_FOUND",
+    CONFIG_AUTH_NOT_FOUND: "CONFIG_AUTH_NOT_FOUND",
+    CONFIG_READ_FAILED: "CONFIG_READ_FAILED",
+    REGISTERED_APPS_READ_FAILED: "REGISTERED_APPS_READ_FAILED",
+    REGISTERED_APPS_WRITE_FAILED: "REGISTERED_APPS_WRITE_FAILED",
+    REGISTERED_APP_DUPLICATE: "REGISTERED_APP_DUPLICATE",
+    REGISTERED_APP_NOT_FOUND: "REGISTERED_APP_NOT_FOUND",
+    REGISTERED_APP_STORE_INFO_MISSING: "REGISTERED_APP_STORE_INFO_MISSING",
+    // Service guards
+    CONFIG_NOT_FOUND_SKIP: "CONFIG_NOT_FOUND",
+    IDENTIFIER_MISSING: "IDENTIFIER_MISSING",
+    NO_DATA_FOUND: "NO_DATA_FOUND",
+    // App resolution
+    APP_IDENTIFIER_MISSING: "APP_IDENTIFIER_MISSING",
+    APP_NOT_FOUND: "APP_NOT_FOUND",
+    APP_RESOLUTION_FAILED: "APP_RESOLUTION_FAILED",
+    // App Store factory
+    APP_STORE_CLIENT_CONFIG_MISSING: "APP_STORE_CLIENT_CONFIG_MISSING",
+    APP_STORE_BUNDLE_ID_INVALID: "APP_STORE_BUNDLE_ID_INVALID",
+    APP_STORE_CONFIG_LOAD_FAILED: "APP_STORE_CONFIG_LOAD_FAILED",
+    APP_STORE_CONFIG_MISSING: "APP_STORE_CONFIG_MISSING",
+    APP_STORE_ISSUER_ID_INVALID: "APP_STORE_ISSUER_ID_INVALID",
+    APP_STORE_KEY_ID_INVALID: "APP_STORE_KEY_ID_INVALID",
+    APP_STORE_PRIVATE_KEY_INVALID: "APP_STORE_PRIVATE_KEY_INVALID",
+    APP_STORE_PRIVATE_KEY_FORMAT_INVALID: "APP_STORE_PRIVATE_KEY_FORMAT_INVALID",
+    APP_STORE_CLIENT_CREATE_FAILED: "APP_STORE_CLIENT_CREATE_FAILED",
+    // Google Play factory
+    GOOGLE_PLAY_CLIENT_CONFIG_MISSING: "GOOGLE_PLAY_CLIENT_CONFIG_MISSING",
+    GOOGLE_PLAY_PACKAGE_NAME_INVALID: "GOOGLE_PLAY_PACKAGE_NAME_INVALID",
+    GOOGLE_PLAY_CONFIG_LOAD_FAILED: "GOOGLE_PLAY_CONFIG_LOAD_FAILED",
+    GOOGLE_PLAY_CONFIG_MISSING: "GOOGLE_PLAY_CONFIG_MISSING",
+    GOOGLE_PLAY_SERVICE_ACCOUNT_JSON_INVALID: "GOOGLE_PLAY_SERVICE_ACCOUNT_JSON_INVALID",
+    GOOGLE_PLAY_SERVICE_ACCOUNT_JSON_FORMAT_INVALID: "GOOGLE_PLAY_SERVICE_ACCOUNT_JSON_FORMAT_INVALID",
+    GOOGLE_PLAY_SERVICE_ACCOUNT_JSON_PARSE_FAILED: "GOOGLE_PLAY_SERVICE_ACCOUNT_JSON_PARSE_FAILED",
+    GOOGLE_PLAY_CLIENT_CREATE_FAILED: "GOOGLE_PLAY_CLIENT_CREATE_FAILED",
+    // App Store service
+    APP_STORE_LIST_APPS_FAILED: "APP_STORE_LIST_APPS_FAILED",
+    APP_STORE_FETCH_APP_INFO_FAILED: "APP_STORE_FETCH_APP_INFO_FAILED",
+    APP_STORE_GET_LATEST_VERSION_FAILED: "APP_STORE_GET_LATEST_VERSION_FAILED",
+    APP_STORE_VERSION_NOT_EDITABLE: "APP_STORE_VERSION_NOT_EDITABLE",
+    APP_STORE_UPDATE_RELEASE_NOTES_PARTIAL: "APP_STORE_UPDATE_RELEASE_NOTES_PARTIAL",
+    APP_STORE_UPDATE_RELEASE_NOTES_FAILED: "APP_STORE_UPDATE_RELEASE_NOTES_FAILED",
+    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_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",
+    // Google Play service
+    GOOGLE_PLAY_FETCH_APP_INFO_FAILED: "GOOGLE_PLAY_FETCH_APP_INFO_FAILED",
+    GOOGLE_PLAY_GET_LATEST_RELEASE_FAILED: "GOOGLE_PLAY_GET_LATEST_RELEASE_FAILED",
+    GOOGLE_PLAY_RELEASE_NOTES_EMPTY: "GOOGLE_PLAY_RELEASE_NOTES_EMPTY",
+    GOOGLE_PLAY_UPDATE_RELEASE_NOTES_PARTIAL: "GOOGLE_PLAY_UPDATE_RELEASE_NOTES_PARTIAL",
+    GOOGLE_PLAY_UPDATE_RELEASE_NOTES_FAILED: "GOOGLE_PLAY_UPDATE_RELEASE_NOTES_FAILED",
+    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_VERIFY_AUTH_FAILED: "GOOGLE_PLAY_VERIFY_AUTH_FAILED",
+    // ASO data/files
+    ASO_GOOGLE_PLAY_DATA_PARSE_FAILED: "ASO_GOOGLE_PLAY_DATA_PARSE_FAILED",
+    ASO_APP_STORE_DATA_PARSE_FAILED: "ASO_APP_STORE_DATA_PARSE_FAILED",
+    ASO_DATA_SAVE_FAILED: "ASO_DATA_SAVE_FAILED",
+    ASO_IMAGE_DOWNLOAD_FAILED: "ASO_IMAGE_DOWNLOAD_FAILED",
+    ASO_LOCAL_ASSET_NOT_FOUND: "ASO_LOCAL_ASSET_NOT_FOUND",
+};

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

@@ -0,0 +1,10 @@
+export declare const HTTP_STATUS: {
+    readonly BAD_REQUEST: 400;
+    readonly UNAUTHORIZED: 401;
+    readonly FORBIDDEN: 403;
+    readonly NOT_FOUND: 404;
+    readonly CONFLICT: 409;
+    readonly UNPROCESSABLE_ENTITY: 422;
+    readonly INTERNAL_SERVER_ERROR: 500;
+};
+export type HttpStatusCode = (typeof HTTP_STATUS)[keyof typeof HTTP_STATUS];

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

@@ -0,0 +1,9 @@
+export const HTTP_STATUS = {
+    BAD_REQUEST: 400,
+    UNAUTHORIZED: 401,
+    FORBIDDEN: 403,
+    NOT_FOUND: 404,
+    CONFLICT: 409,
+    UNPROCESSABLE_ENTITY: 422,
+    INTERNAL_SERVER_ERROR: 500,
+};

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

@@ -0,0 +1,14 @@
+/**
+ * ASO (App Store Optimization) constants
+ */
+/**
+ * App Store Connect supported locale list
+ * Reference: https://developer.apple.com/documentation/appstoreconnectapi
+ */
+export declare const APP_STORE_SUPPORTED_LOCALES: readonly ["en-US", "en-AU", "en-CA", "en-GB", "ko-KR", "ja-JP", "zh-Hans", "zh-Hant", "zh-HK", "fr-FR", "fr-CA", "de-DE", "it-IT", "es-ES", "es-MX", "pt-BR", "pt-PT", "ru-RU", "ar-SA", "nl-NL", "sv-SE", "da-DK", "no-NO", "fi-FI", "pl-PL", "tr-TR", "vi-VN", "th-TH", "id-ID", "ms-MY", "hi-IN", "cs-CZ", "sk-SK", "hu-HU", "ro-RO", "uk-UA", "he-IL", "el-GR"];
+/**
+ * Google Play Console supported language list
+ * Reference: https://support.google.com/googleplay/android-developer/answer/9844778
+ */
+export declare const GOOGLE_PLAY_SUPPORTED_LANGUAGES: readonly ["en-US", "en-AU", "en-CA", "en-GB", "en-IN", "en-SG", "ko-KR", "ja-JP", "zh-CN", "zh-TW", "zh-HK", "fr-FR", "fr-CA", "de-DE", "it-IT", "es-ES", "es-419", "es-US", "pt-BR", "pt-PT", "ru-RU", "ar-SA", "nl-NL", "sv-SE", "da-DK", "no-NO", "fi-FI", "pl-PL", "tr-TR", "vi-VN", "th-TH", "id-ID", "ms-MY", "hi-IN", "cs-CZ", "sk-SK", "hu-HU", "ro-RO", "uk-UA", "he-IL", "el-GR", "bg-BG", "hr-HR", "sr-RS", "sl-SI", "et-EE", "lv-LV", "lt-LT"];
+export declare const DEFAULT_LOCALE: "en-US";

package/dist/src/packages/configs/aso-config/constants.js

@@ -0,0 +1,102 @@
+/**
+ * ASO (App Store Optimization) constants
+ */
+/**
+ * App Store Connect supported locale list
+ * Reference: https://developer.apple.com/documentation/appstoreconnectapi
+ */
+export const APP_STORE_SUPPORTED_LOCALES = [
+    "en-US",
+    "en-AU",
+    "en-CA",
+    "en-GB",
+    "ko-KR",
+    "ja-JP",
+    "zh-Hans",
+    "zh-Hant",
+    "zh-HK",
+    "fr-FR",
+    "fr-CA",
+    "de-DE",
+    "it-IT",
+    "es-ES",
+    "es-MX",
+    "pt-BR",
+    "pt-PT",
+    "ru-RU",
+    "ar-SA",
+    "nl-NL",
+    "sv-SE",
+    "da-DK",
+    "no-NO",
+    "fi-FI",
+    "pl-PL",
+    "tr-TR",
+    "vi-VN",
+    "th-TH",
+    "id-ID",
+    "ms-MY",
+    "hi-IN",
+    "cs-CZ",
+    "sk-SK",
+    "hu-HU",
+    "ro-RO",
+    "uk-UA",
+    "he-IL",
+    "el-GR",
+];
+/**
+ * Google Play Console supported language list
+ * Reference: https://support.google.com/googleplay/android-developer/answer/9844778
+ */
+export const GOOGLE_PLAY_SUPPORTED_LANGUAGES = [
+    "en-US",
+    "en-AU",
+    "en-CA",
+    "en-GB",
+    "en-IN",
+    "en-SG",
+    "ko-KR",
+    "ja-JP",
+    "zh-CN",
+    "zh-TW",
+    "zh-HK",
+    "fr-FR",
+    "fr-CA",
+    "de-DE",
+    "it-IT",
+    "es-ES",
+    "es-419",
+    "es-US",
+    "pt-BR",
+    "pt-PT",
+    "ru-RU",
+    "ar-SA",
+    "nl-NL",
+    "sv-SE",
+    "da-DK",
+    "no-NO",
+    "fi-FI",
+    "pl-PL",
+    "tr-TR",
+    "vi-VN",
+    "th-TH",
+    "id-ID",
+    "ms-MY",
+    "hi-IN",
+    "cs-CZ",
+    "sk-SK",
+    "hu-HU",
+    "ro-RO",
+    "uk-UA",
+    "he-IL",
+    "el-GR",
+    "bg-BG",
+    "hr-HR",
+    "sr-RS",
+    "sl-SI",
+    "et-EE",
+    "lv-LV",
+    "lt-LT",
+];
+export const DEFAULT_LOCALE = "en-US";

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

@@ -0,0 +1,3 @@
+import type { AppStoreLocale, GooglePlayLanguage } from "./types.js";
+export declare function isAppStoreLocale(locale: string): locale is AppStoreLocale;
+export declare function isGooglePlayLanguage(language: string): language is GooglePlayLanguage;

package/dist/src/packages/configs/aso-config/locale-guards.js

@@ -0,0 +1,7 @@
+import { APP_STORE_SUPPORTED_LOCALES, GOOGLE_PLAY_SUPPORTED_LANGUAGES, } from "./constants.js";
+export function isAppStoreLocale(locale) {
+    return APP_STORE_SUPPORTED_LOCALES.includes(locale);
+}
+export function isGooglePlayLanguage(language) {
+    return GOOGLE_PLAY_SUPPORTED_LANGUAGES.includes(language);
+}

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

@@ -0,0 +1,11 @@
+import type { StoreType } from "./types.js";
+export type StoreTargets = {
+    /** Normalized store value (defaults to "both") */
+    store: StoreType;
+    includeAppStore: boolean;
+    includeGooglePlay: boolean;
+};
+/**
+ * Normalize store selection and expose booleans for per-store handling.
+ */
+export declare function getStoreTargets(store?: StoreType): StoreTargets;

package/dist/src/packages/configs/aso-config/store.js

@@ -0,0 +1,11 @@
+/**
+ * Normalize store selection and expose booleans for per-store handling.
+ */
+export function getStoreTargets(store) {
+    const normalizedStore = store ?? "both";
+    return {
+        store: normalizedStore,
+        includeAppStore: normalizedStore === "appStore" || normalizedStore === "both",
+        includeGooglePlay: normalizedStore === "googlePlay" || normalizedStore === "both",
+    };
+}

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

@@ -0,0 +1,98 @@
+import { APP_STORE_SUPPORTED_LOCALES, GOOGLE_PLAY_SUPPORTED_LANGUAGES } from "./constants.js";
+export type AppStoreLocale = (typeof APP_STORE_SUPPORTED_LOCALES)[number];
+export type GooglePlayLanguage = (typeof GOOGLE_PLAY_SUPPORTED_LANGUAGES)[number];
+export type SupportedLocale = AppStoreLocale | GooglePlayLanguage;
+export interface GooglePlayScreenshots {
+    phone: string[];
+    tablet?: string[];
+    tablet7?: string[];
+    tablet10?: string[];
+    tv?: string[];
+    wear?: string[];
+}
+export interface GooglePlayAsoData {
+    title: string;
+    shortDescription: string;
+    fullDescription: string;
+    screenshots: GooglePlayScreenshots;
+    featureGraphic?: string;
+    promoGraphic?: string;
+    category?: string;
+    contentRating?: string;
+    keywords?: string[];
+    contactEmail?: string;
+    contactPhone?: string;
+    contactWebsite?: string;
+    packageName: string;
+    defaultLanguage: string;
+}
+export interface GooglePlayMultilingualAsoData {
+    locales: Record<string, GooglePlayAsoData>;
+    defaultLocale?: string;
+}
+export interface GooglePlayReleaseNote {
+    versionCode: number;
+    versionName: string;
+    releaseNotes: Record<string, string>;
+    track: string;
+    status: string;
+    releaseDate?: string;
+}
+export interface AppStoreScreenshots {
+    iphone65?: string[];
+    iphone61?: string[];
+    iphone58?: string[];
+    iphone55?: string[];
+    iphone47?: string[];
+    iphone40?: string[];
+    ipadPro129?: string[];
+    ipadPro11?: string[];
+    ipad105?: string[];
+    ipad97?: string[];
+    appleWatch?: string[];
+}
+export interface AppStoreAsoData {
+    name: string;
+    subtitle?: string;
+    description: string;
+    keywords?: string;
+    promotionalText?: string;
+    screenshots: AppStoreScreenshots;
+    appPreview?: string[];
+    primaryCategory?: string;
+    secondaryCategory?: string;
+    contentRightId?: string;
+    supportUrl?: string;
+    marketingUrl?: string;
+    privacyPolicyUrl?: string;
+    bundleId: string;
+    locale: string;
+    whatsNew?: string;
+}
+export interface AppStoreMultilingualAsoData {
+    locales: Record<string, AppStoreAsoData>;
+    defaultLocale?: string;
+}
+export interface AppStoreReleaseNote {
+    versionString: string;
+    releaseNotes: Record<string, string>;
+    platform: string;
+    releaseDate?: string;
+}
+export interface AsoData {
+    googlePlay?: GooglePlayAsoData | GooglePlayMultilingualAsoData;
+    appStore?: AppStoreAsoData | AppStoreMultilingualAsoData;
+    lastSynced?: {
+        googlePlay?: string;
+        appStore?: string;
+    };
+}
+export type StoreType = "googlePlay" | "appStore" | "both";
+export type SyncDirection = "pull" | "push" | "sync";
+export interface SyncOptions {
+    direction: SyncDirection;
+    productSlug: string;
+    store?: StoreType;
+    dryRun?: boolean;
+    uploadImages?: boolean;
+}

package/dist/src/packages/configs/aso-config/types.js

@@ -0,0 +1,2 @@
+export {};
+// Re-export StoreType for backward compatibility

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

@@ -0,0 +1,43 @@
+import { type AsoData, type GooglePlayAsoData, type GooglePlayMultilingualAsoData, type AppStoreAsoData, type AppStoreMultilingualAsoData } from "./types.js";
+export declare function getAsoDir(): string;
+export declare function getAsoPullDir(): string;
+export declare function getAsoPushDir(): string;
+export declare function getProductAsoDir(slug: string): string;
+export declare function getPullProductAsoDir(slug: string, baseDir?: string): string;
+export declare function getScreenshotDir(productStoreRoot: string, store: "google-play" | "app-store", locale: string): string;
+export declare function getScreenshotFilePath(screenshotDir: string, filename: string): string;
+export declare function getStoreDir(productStoreRoot: string, store: "google-play" | "app-store"): string;
+export declare function getReleaseNotesPath(storeDir: string): string;
+export declare function getAsoDataPaths(slug: string, asoDir?: string): {
+    googlePlay: string;
+    appStore: string;
+};
+export declare function ensureDir(dirPath: string): void;
+export interface PreparedAsoData {
+    googlePlay?: GooglePlayMultilingualAsoData;
+    appStore?: AppStoreMultilingualAsoData;
+}
+export declare function convertToMultilingual<T extends {
+    locale?: string;
+    defaultLanguage?: string;
+}>(data: T, locale?: string): {
+    locales: Record<string, T>;
+    defaultLocale: string;
+};
+export declare function isGooglePlayMultilingual(data: GooglePlayAsoData | GooglePlayMultilingualAsoData | undefined): data is GooglePlayMultilingualAsoData;
+export declare function isAppStoreMultilingual(data: AppStoreAsoData | AppStoreMultilingualAsoData | undefined): data is AppStoreMultilingualAsoData;
+export declare function prepareAsoDataForPush(slug: string, configData: AsoData, options?: {
+    baseUrl?: string;
+}): PreparedAsoData;
+export declare function saveAsoData(slug: string, asoData: Partial<AsoData>, options?: {
+    asoDir?: string;
+}): void;
+export declare function loadAsoData(slug: string, options?: {
+    asoDir?: string;
+}): AsoData;
+export declare function isLocalAssetPath(assetPath: string): boolean;
+export declare function resolveAppStoreImageUrl(templateUrl: string): string;
+export declare function downloadImage(url: string, outputPath: string): Promise<void>;
+export declare function copyLocalAssetToAso(assetPath: string, outputPath: string, options?: {
+    publicDir?: string;
+}): void;

package/dist/src/packages/configs/aso-config/utils.js

@@ -0,0 +1,223 @@
+import { existsSync, mkdirSync, readFileSync, writeFileSync, copyFileSync, } from "node:fs";
+import { dirname, join } from "node:path";
+import { AppError } from "../../../packages/common/errors/app-error.js";
+import { ERROR_CODES } from "../../../packages/common/errors/error-codes.js";
+import { HTTP_STATUS } from "../../../packages/common/errors/status-codes.js";
+import { getDataDir } from "../../../packages/configs/secrets-config/config.js";
+import { DEFAULT_LOCALE } from "./constants.js";
+// ============================================================================
+// ASO Directory Path Utilities
+// ============================================================================
+export function getAsoDir() {
+    return join(getDataDir(), ".aso");
+}
+export function getAsoPullDir() {
+    return join(getAsoDir(), "pullData");
+}
+export function getAsoPushDir() {
+    return join(getAsoDir(), "pushData");
+}
+export function getProductAsoDir(slug) {
+    return join(getAsoDir(), "products", slug, "store");
+}
+export function getPullProductAsoDir(slug, baseDir) {
+    return join(baseDir ?? getAsoPullDir(), "products", slug, "store");
+}
+export function getScreenshotDir(productStoreRoot, store, locale) {
+    return join(productStoreRoot, store, "screenshots", locale);
+}
+export function getScreenshotFilePath(screenshotDir, filename) {
+    return join(screenshotDir, filename);
+}
+export function getStoreDir(productStoreRoot, store) {
+    return join(productStoreRoot, store);
+}
+export function getReleaseNotesPath(storeDir) {
+    return join(storeDir, "release-notes.json");
+}
+export function getAsoDataPaths(slug, asoDir) {
+    const baseDir = asoDir ?? getAsoDir();
+    const productStoreDir = join(baseDir, "products", slug, "store");
+    return {
+        googlePlay: join(productStoreDir, "google-play", "aso-data.json"),
+        appStore: join(productStoreDir, "app-store", "aso-data.json"),
+    };
+}
+export function ensureDir(dirPath) {
+    if (!existsSync(dirPath)) {
+        mkdirSync(dirPath, { recursive: true });
+    }
+}
+export function convertToMultilingual(data, locale) {
+    const detectedLocale = locale || data.locale || data.defaultLanguage || DEFAULT_LOCALE;
+    return {
+        locales: { [detectedLocale]: data },
+        defaultLocale: detectedLocale,
+    };
+}
+export function isGooglePlayMultilingual(data) {
+    return data !== undefined && "locales" in data;
+}
+export function isAppStoreMultilingual(data) {
+    return data !== undefined && "locales" in data;
+}
+export function prepareAsoDataForPush(slug, configData, options) {
+    const storeData = {};
+    const baseUrl = options?.baseUrl ??
+        process.env.NEXT_PUBLIC_SITE_URL ??
+        "https://labs.quartz.best";
+    const detailPageUrl = `${baseUrl}/${slug}`;
+    if (configData.googlePlay) {
+        const googlePlayData = configData.googlePlay;
+        const locales = isGooglePlayMultilingual(googlePlayData)
+            ? googlePlayData.locales
+            : { [googlePlayData.defaultLanguage || DEFAULT_LOCALE]: googlePlayData };
+        const cleanedLocales = {};
+        for (const [locale, localeData] of Object.entries(locales)) {
+            const { screenshots, featureGraphic, ...rest } = localeData;
+            cleanedLocales[locale] = {
+                ...rest,
+                contactWebsite: detailPageUrl,
+            };
+        }
+        const gpDefaultLocale = isGooglePlayMultilingual(googlePlayData)
+            ? googlePlayData.defaultLocale
+            : googlePlayData.defaultLanguage;
+        storeData.googlePlay = {
+            locales: cleanedLocales,
+            defaultLocale: gpDefaultLocale || DEFAULT_LOCALE,
+        };
+    }
+    if (configData.appStore) {
+        const appStoreData = configData.appStore;
+        const locales = isAppStoreMultilingual(appStoreData)
+            ? appStoreData.locales
+            : { [appStoreData.locale || DEFAULT_LOCALE]: appStoreData };
+        const cleanedLocales = {};
+        for (const [locale, localeData] of Object.entries(locales)) {
+            const { screenshots, ...rest } = localeData;
+            cleanedLocales[locale] = {
+                ...rest,
+                marketingUrl: detailPageUrl,
+            };
+        }
+        const asDefaultLocale = isAppStoreMultilingual(appStoreData)
+            ? appStoreData.defaultLocale
+            : appStoreData.locale;
+        storeData.appStore = {
+            locales: cleanedLocales,
+            defaultLocale: asDefaultLocale || DEFAULT_LOCALE,
+        };
+    }
+    return storeData;
+}
+// ============================================================================
+// ASO Data Save/Load
+// ============================================================================
+export function saveAsoData(slug, asoData, options) {
+    const baseDir = options?.asoDir ?? getAsoDir();
+    const productStoreDir = join(baseDir, "products", slug, "store");
+    try {
+        if (asoData.googlePlay) {
+            const googlePlayDir = join(productStoreDir, "google-play");
+            ensureDir(googlePlayDir);
+            const filePath = join(googlePlayDir, "aso-data.json");
+            writeFileSync(filePath, JSON.stringify({ googlePlay: asoData.googlePlay }, null, 2));
+            console.log(`💾 Google Play data saved to ${filePath}`);
+        }
+        if (asoData.appStore) {
+            const appStoreDir = join(productStoreDir, "app-store");
+            ensureDir(appStoreDir);
+            const filePath = join(appStoreDir, "aso-data.json");
+            writeFileSync(filePath, JSON.stringify({ appStore: asoData.appStore }, null, 2));
+            console.log(`💾 App Store data saved to ${filePath}`);
+        }
+    }
+    catch (error) {
+        throw AppError.io(ERROR_CODES.ASO_DATA_SAVE_FAILED, `Failed to save ASO data for ${slug}`, { slug, baseDir, cause: error });
+    }
+}
+export function loadAsoData(slug, options) {
+    const baseDir = options?.asoDir ?? getAsoDir();
+    const asoData = {};
+    const googlePlayPath = join(baseDir, "products", slug, "store", "google-play", "aso-data.json");
+    if (existsSync(googlePlayPath)) {
+        try {
+            const content = readFileSync(googlePlayPath, "utf-8");
+            const data = JSON.parse(content);
+            if (data.googlePlay) {
+                asoData.googlePlay = isGooglePlayMultilingual(data.googlePlay)
+                    ? data.googlePlay
+                    : convertToMultilingual(data.googlePlay, data.googlePlay.defaultLanguage);
+            }
+        }
+        catch (error) {
+            throw AppError.validation(ERROR_CODES.ASO_GOOGLE_PLAY_DATA_PARSE_FAILED, `Failed to read Google Play ASO data for ${slug}`, { path: googlePlayPath, error });
+        }
+    }
+    const appStorePath = join(baseDir, "products", slug, "store", "app-store", "aso-data.json");
+    if (existsSync(appStorePath)) {
+        try {
+            const content = readFileSync(appStorePath, "utf-8");
+            const data = JSON.parse(content);
+            if (data.appStore) {
+                asoData.appStore = isAppStoreMultilingual(data.appStore)
+                    ? data.appStore
+                    : convertToMultilingual(data.appStore, data.appStore.locale);
+            }
+        }
+        catch (error) {
+            throw AppError.validation(ERROR_CODES.ASO_APP_STORE_DATA_PARSE_FAILED, `Failed to read App Store ASO data for ${slug}`, { path: appStorePath, error });
+        }
+    }
+    return asoData;
+}
+// ============================================================================
+// Image Utilities
+// ============================================================================
+export function isLocalAssetPath(assetPath) {
+    if (!assetPath)
+        return false;
+    const trimmed = assetPath.trim();
+    return !/^([a-z]+:)?\/\//i.test(trimmed);
+}
+export function resolveAppStoreImageUrl(templateUrl) {
+    if (!templateUrl.includes("{w}") && !templateUrl.includes("{h}")) {
+        return templateUrl;
+    }
+    const width = 2048;
+    const height = 2732;
+    const format = "png";
+    return templateUrl
+        .replace("{w}", width.toString())
+        .replace("{h}", height.toString())
+        .replace("{f}", format);
+}
+export async function downloadImage(url, outputPath) {
+    try {
+        const response = await fetch(url);
+        if (!response.ok) {
+            throw AppError.io(ERROR_CODES.ASO_IMAGE_DOWNLOAD_FAILED, `Image download failed: ${response.status} ${response.statusText}`, { url, status: response.status, statusText: response.statusText });
+        }
+        const arrayBuffer = await response.arrayBuffer();
+        const buffer = Buffer.from(arrayBuffer);
+        ensureDir(dirname(outputPath));
+        writeFileSync(outputPath, buffer);
+    }
+    catch (error) {
+        throw AppError.wrap(error, HTTP_STATUS.INTERNAL_SERVER_ERROR, ERROR_CODES.ASO_IMAGE_DOWNLOAD_FAILED, `Image download failed (${url})`);
+    }
+}
+export function copyLocalAssetToAso(assetPath, outputPath, options) {
+    const publicDir = options?.publicDir ?? join(getDataDir(), "public");
+    const trimmedPath = assetPath
+        .replace(/^\.\//, "")
+        .replace(/^public\//, "")
+        .replace(/^\/+/, "");
+    const sourcePath = join(publicDir, trimmedPath);
+    if (!existsSync(sourcePath)) {
+        throw AppError.fileNotFound(ERROR_CODES.ASO_LOCAL_ASSET_NOT_FOUND, `Local image not found: ${sourcePath}`, { sourcePath });
+    }
+    ensureDir(dirname(outputPath));
+    copyFileSync(sourcePath, outputPath);
+}

package/dist/src/packages/configs/secrets-config/config.d.ts

@@ -0,0 +1,12 @@
+import type { EnvConfig } from "./types.js";
+/**
+ * Get config directory path: ~/.config/pabal-mcp/
+ */
+export declare function getConfigDir(): string;
+/**
+ * Get config file path: ~/.config/pabal-mcp/config.json
+ */
+export declare function getConfigPath(): string;
+export declare function readConfigFile(): any;
+export declare function getDataDir(): string;
+export declare function loadConfig(): EnvConfig;