pabal-store-api-mcp 1.1.0

package/dist/src/packages/stores/app-store/generated-types.js

@@ -0,0 +1,5 @@
+/**
+ * This file was auto-generated by openapi-typescript.
+ * Do not make direct changes to the file.
+ */
+export {};

package/dist/src/packages/stores/app-store/types.d.ts

@@ -0,0 +1,39 @@
+/**
+ * App Store Connect API Types
+ *
+ * Type definitions for App Store Connect operations.
+ * Response types are from OpenAPI, Request attribute types are extracted.
+ *
+ * @see https://developer.apple.com/documentation/appstoreconnectapi
+ */
+import type { App as AppModel, AppInfo as AppInfoModel, AppInfoLocalization as AppInfoLocalizationModel, AppScreenshot as AppScreenshotModel, AppScreenshotSet as AppScreenshotSetModel, AppStoreVersion as AppStoreVersionModel, AppStoreVersionLocalization as AppStoreVersionLocalizationModel, AppStoreVersionLocalizationUpdateRequestDataAttributes, AppInfoLocalizationUpdateRequestDataAttributes } from "appstore-connect-sdk/openapi";
+export interface AppStoreClientConfig {
+    issuerId: string;
+    keyId: string;
+    privateKey: string;
+    bundleId: string;
+}
+export interface ApiResponse<T> {
+    data: T;
+    links?: {
+        self?: string;
+        next?: string;
+    };
+}
+export type AppStoreApp = AppModel;
+export type AppInfo = AppInfoModel;
+export type AppInfoLocalization = AppInfoLocalizationModel;
+export type AppStoreVersion = AppStoreVersionModel;
+export type AppStoreLocalization = AppStoreVersionLocalizationModel;
+export type AppStoreScreenshotSet = AppScreenshotSetModel;
+export type AppStoreScreenshot = AppScreenshotModel;
+/**
+ * App Info Localization Update Request Attributes
+ * @see https://developer.apple.com/documentation/appstoreconnectapi/appinfolocalizationupdaterequest/data/attributes
+ */
+export type AppInfoLocalizationUpdateAttributes = AppInfoLocalizationUpdateRequestDataAttributes;
+/**
+ * App Store Version Localization Update Request Attributes
+ * @see https://developer.apple.com/documentation/appstoreconnectapi/appstoreversionlocalizationupdaterequest/data/attributes
+ */
+export type AppStoreVersionLocalizationUpdateAttributes = AppStoreVersionLocalizationUpdateRequestDataAttributes;

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

@@ -0,0 +1,9 @@
+/**
+ * App Store Connect API Types
+ *
+ * Type definitions for App Store Connect operations.
+ * Response types are from OpenAPI, Request attribute types are extracted.
+ *
+ * @see https://developer.apple.com/documentation/appstoreconnectapi
+ */
+export {};

package/dist/src/packages/stores/app-store/verify-auth.d.ts

@@ -0,0 +1,16 @@
+export interface VerifyAppStoreAuthResult {
+    success: boolean;
+    error?: string;
+    data?: {
+        header: Record<string, unknown>;
+        payload: Record<string, unknown>;
+    };
+}
+/**
+ * Verify App Store Connect authentication configuration and generate JWT token for validation.
+ * @param expirationSeconds JWT token expiration time (seconds). Default: 300 seconds
+ * @returns Authentication verification result
+ */
+export declare function verifyAppStoreAuth({ expirationSeconds, }?: {
+    expirationSeconds?: number;
+}): Promise<VerifyAppStoreAuthResult>;

package/dist/src/packages/stores/app-store/verify-auth.js

@@ -0,0 +1,34 @@
+import { loadConfig } from "../../../packages/configs/secrets-config/config.js";
+import { createAppStoreJWT, decodeJwt } from "../../../packages/stores/app-store/auth.js";
+/**
+ * Verify App Store Connect authentication configuration and generate JWT token for validation.
+ * @param expirationSeconds JWT token expiration time (seconds). Default: 300 seconds
+ * @returns Authentication verification result
+ */
+export async function verifyAppStoreAuth({ expirationSeconds = 300, } = {}) {
+    try {
+        const cfg = loadConfig().appStore;
+        if (!cfg) {
+            return {
+                success: false,
+                error: "App Store configuration not found in ~/.config/pabal-mcp/config.json file.",
+            };
+        }
+        const token = await createAppStoreJWT(cfg, { expirationSeconds });
+        const decoded = decodeJwt(token);
+        return {
+            success: true,
+            data: {
+                header: decoded.header,
+                payload: decoded.payload,
+            },
+        };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        return {
+            success: false,
+            error: `App Store authentication verification failed: ${message}`,
+        };
+    }
+}

package/dist/src/packages/stores/play-store/api-converters.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Google Play Console API Data Converters
+ *
+ * Data transformation logic between API responses and internal types
+ */
+import type { GooglePlayAsoData, GooglePlayMultilingualAsoData, GooglePlayReleaseNote } from "../../../packages/configs/aso-config/types.js";
+import type { ScreenshotUrls, ListingUpdateAttributes, AppDetailsUpdateAttributes, LatestReleaseInfo, ImageType } from "./types.js";
+/**
+ * Convert API image responses to screenshot URLs structure
+ */
+export declare function fetchScreenshotsAndFeatureGraphic(fetchImagesFunc: (imageType: ImageType) => Promise<any>, language: string): Promise<{
+    screenshots: ScreenshotUrls;
+    featureGraphic: string | undefined;
+}>;
+/**
+ * Convert API listing response to GooglePlayAsoData
+ */
+export declare function convertToAsoData(listingData: any, appDetailsData: any, screenshots: ScreenshotUrls, featureGraphic: string | undefined, packageName: string, defaultLanguage: string): GooglePlayAsoData;
+/**
+ * Convert API listing to locale-specific ASO data
+ */
+export declare function convertToLocaleAsoData(listingData: any, appDetailsData: any, screenshots: ScreenshotUrls, featureGraphic: string | undefined, packageName: string, language: string): GooglePlayAsoData;
+/**
+ * Convert multiple locales data to multilingual ASO data structure
+ */
+export declare function convertToMultilingualAsoData(locales: Record<string, GooglePlayAsoData>, defaultLocale?: string): GooglePlayMultilingualAsoData;
+/**
+ * Build request body for listing update (only defined values)
+ */
+export declare function buildListingRequestBody(data: {
+    title?: string;
+    shortDescription?: string;
+    fullDescription?: string;
+}): ListingUpdateAttributes;
+/**
+ * Build request body for app details update (only defined values)
+ */
+export declare function buildDetailsRequestBody(data: {
+    contactEmail?: string;
+    contactPhone?: string;
+    contactWebsite?: string;
+    defaultLanguage?: string;
+}): AppDetailsUpdateAttributes;
+/**
+ * Convert track release data to GooglePlayReleaseNote
+ */
+export declare function convertToReleaseNote(release: any, versionCode: string | number, trackName: string): GooglePlayReleaseNote | null;
+/**
+ * Convert release notes map to API format
+ */
+export declare function convertReleaseNotesToApiFormat(releaseNotes: Record<string, string>): Array<{
+    language: string;
+    text: string;
+}>;
+/**
+ * Extract latest release from track releases
+ */
+export declare function extractLatestRelease(releases: any[]): LatestReleaseInfo | null;

package/dist/src/packages/stores/play-store/api-converters.js

@@ -0,0 +1,209 @@
+/**
+ * Google Play Console API Data Converters
+ *
+ * Data transformation logic between API responses and internal types
+ */
+import { DEFAULT_LOCALE } from "../../../packages/configs/aso-config/constants.js";
+import { IMAGE_TYPES } from "./constants.js";
+/**
+ * Convert API image responses to screenshot URLs structure
+ */
+export async function fetchScreenshotsAndFeatureGraphic(fetchImagesFunc, language) {
+    const screenshots = {
+        phone: [],
+        tablet7: [],
+        tablet10: [],
+        tv: [],
+        wear: [],
+    };
+    let featureGraphic;
+    for (const imageType of IMAGE_TYPES) {
+        try {
+            const imagesResponse = await fetchImagesFunc(imageType);
+            const images = imagesResponse.data.images || [];
+            if (imageType === "featureGraphic") {
+                featureGraphic = images[0]?.url;
+            }
+            else {
+                const urls = images
+                    .map((img) => img.url)
+                    .filter(Boolean);
+                if (imageType === "phoneScreenshots") {
+                    screenshots.phone.push(...urls);
+                }
+                else if (imageType === "sevenInchScreenshots") {
+                    screenshots.tablet7.push(...urls);
+                }
+                else if (imageType === "tenInchScreenshots") {
+                    screenshots.tablet10.push(...urls);
+                }
+                else if (imageType === "tvScreenshots") {
+                    screenshots.tv.push(...urls);
+                }
+                else if (imageType === "wearScreenshots") {
+                    screenshots.wear.push(...urls);
+                }
+            }
+        }
+        catch (error) {
+            const err = error;
+            if (err.code !== 404) {
+                console.warn(`⚠️  Failed to fetch ${imageType} images for ${language}:`, err.message);
+            }
+        }
+    }
+    return { screenshots, featureGraphic };
+}
+/**
+ * Convert API listing response to GooglePlayAsoData
+ */
+export function convertToAsoData(listingData, appDetailsData, screenshots, featureGraphic, packageName, defaultLanguage) {
+    return {
+        title: listingData.title || "",
+        shortDescription: listingData.shortDescription || "",
+        fullDescription: listingData.fullDescription || "",
+        screenshots,
+        featureGraphic,
+        category: appDetailsData.category || "",
+        packageName,
+        defaultLanguage,
+        contactEmail: appDetailsData.contactEmail ?? undefined,
+        contactPhone: appDetailsData.contactPhone ?? undefined,
+        contactWebsite: appDetailsData.contactWebsite ?? undefined,
+    };
+}
+/**
+ * Convert API listing to locale-specific ASO data
+ */
+export function convertToLocaleAsoData(listingData, appDetailsData, screenshots, featureGraphic, packageName, language) {
+    return {
+        title: listingData.title || "",
+        shortDescription: listingData.shortDescription || "",
+        fullDescription: listingData.fullDescription || "",
+        screenshots,
+        featureGraphic,
+        category: appDetailsData.category || "",
+        packageName,
+        defaultLanguage: language,
+        contactEmail: appDetailsData.contactEmail ?? undefined,
+        contactPhone: appDetailsData.contactPhone ?? undefined,
+        contactWebsite: appDetailsData.contactWebsite ?? undefined,
+    };
+}
+/**
+ * Convert multiple locales data to multilingual ASO data structure
+ */
+export function convertToMultilingualAsoData(locales, defaultLocale) {
+    let finalDefaultLocale = defaultLocale;
+    if (!finalDefaultLocale && Object.keys(locales).length > 0) {
+        // Try to find DEFAULT_LOCALE
+        if (locales[DEFAULT_LOCALE]) {
+            finalDefaultLocale = DEFAULT_LOCALE;
+        }
+        else {
+            // Use first available locale
+            finalDefaultLocale = Object.keys(locales)[0];
+        }
+    }
+    return {
+        locales,
+        defaultLocale: finalDefaultLocale || DEFAULT_LOCALE,
+    };
+}
+/**
+ * Build request body for listing update (only defined values)
+ */
+export function buildListingRequestBody(data) {
+    const body = {};
+    if (data.title)
+        body.title = data.title;
+    if (data.shortDescription)
+        body.shortDescription = data.shortDescription;
+    if (data.fullDescription)
+        body.fullDescription = data.fullDescription;
+    return body;
+}
+/**
+ * Build request body for app details update (only defined values)
+ */
+export function buildDetailsRequestBody(data) {
+    const body = {};
+    if (data.defaultLanguage)
+        body.defaultLanguage = data.defaultLanguage;
+    if (data.contactEmail)
+        body.contactEmail = data.contactEmail;
+    if (data.contactPhone)
+        body.contactPhone = data.contactPhone;
+    if (data.contactWebsite)
+        body.contactWebsite = data.contactWebsite;
+    return body;
+}
+/**
+ * Convert track release data to GooglePlayReleaseNote
+ */
+export function convertToReleaseNote(release, versionCode, trackName) {
+    const releaseNotesMap = {};
+    if (release.releaseNotes) {
+        for (const rn of release.releaseNotes) {
+            if (rn.language && rn.text) {
+                releaseNotesMap[rn.language] = rn.text;
+            }
+        }
+    }
+    if (Object.keys(releaseNotesMap).length === 0) {
+        return null;
+    }
+    const releaseDate = release.releaseDate?.seconds
+        ? new Date(Number(release.releaseDate.seconds) * 1000).toISOString()
+        : undefined;
+    return {
+        versionCode: Number(versionCode),
+        versionName: versionCode.toString(),
+        releaseNotes: releaseNotesMap,
+        track: trackName,
+        status: release.status || "draft",
+        releaseDate,
+    };
+}
+/**
+ * Convert release notes map to API format
+ */
+export function convertReleaseNotesToApiFormat(releaseNotes) {
+    return Object.entries(releaseNotes).map(([language, text]) => ({
+        language,
+        text,
+    }));
+}
+/**
+ * Extract latest release from track releases
+ */
+export function extractLatestRelease(releases) {
+    if (releases.length === 0) {
+        return null;
+    }
+    let latestRelease = null;
+    let latestVersionCode = 0;
+    for (const release of releases) {
+        const versionCodes = (release.versionCodes || []).map((code) => Number(code));
+        const maxVersionCode = versionCodes.reduce((max, code) => Math.max(max, code), 0);
+        if (!latestRelease || maxVersionCode > latestVersionCode) {
+            latestRelease = release;
+            latestVersionCode = maxVersionCode;
+        }
+    }
+    if (!latestRelease) {
+        return null;
+    }
+    const releaseDate = latestRelease.releaseDate?.seconds
+        ? new Date(Number(latestRelease.releaseDate.seconds) * 1000).toISOString()
+        : undefined;
+    return {
+        versionCodes: (latestRelease.versionCodes || []).map((code) => Number(code)),
+        status: latestRelease.status
+            ? latestRelease.status
+            : undefined,
+        versionName: latestRelease.name ? String(latestRelease.name) : undefined,
+        releaseName: latestRelease.name ? String(latestRelease.name) : undefined,
+        releaseDate,
+    };
+}

package/dist/src/packages/stores/play-store/api-endpoints.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Google Play Console API Endpoints
+ *
+ * Centralized API endpoint management for androidpublisher v3 API
+ */
+import type { androidpublisher_v3 } from "googleapis";
+import type { EditSession, ListingUpdateAttributes, AppDetailsUpdateAttributes, TrackUpdateAttributes, ImageType, AppEdit, AppDetails, Listing, Image, Track, ListingsListResponse, ImagesListResponse, TracksListResponse } from "./types.js";
+export declare class GooglePlayApiEndpoints {
+    private androidPublisher;
+    constructor(androidPublisher: androidpublisher_v3.Androidpublisher);
+    /**
+     * Edit Operations
+     */
+    createEdit(auth: EditSession["auth"], packageName: string): Promise<{
+        data: AppEdit;
+    }>;
+    deleteEdit(session: EditSession): Promise<{
+        data: void;
+    }>;
+    commitEdit(session: EditSession): Promise<{
+        data: AppEdit;
+    }>;
+    /**
+     * App Details Operations
+     */
+    getAppDetails(session: EditSession): Promise<{
+        data: AppDetails;
+    }>;
+    updateAppDetails(session: EditSession, requestBody: AppDetailsUpdateAttributes): Promise<{
+        data: AppDetails;
+    }>;
+    /**
+     * Listing Operations
+     */
+    listListings(session: EditSession): Promise<{
+        data: ListingsListResponse;
+    }>;
+    getListing(session: EditSession, language: string): Promise<{
+        data: Listing;
+    }>;
+    updateListing(session: EditSession, language: string, requestBody: ListingUpdateAttributes): Promise<{
+        data: Listing;
+    }>;
+    /**
+     * Image Operations
+     */
+    listImages(session: EditSession, language: string, imageType: ImageType): Promise<{
+        data: ImagesListResponse;
+    }>;
+    uploadImage(session: EditSession, language: string, imageType: ImageType, media: {
+        mimeType: string;
+        body: Buffer;
+    }): Promise<{
+        data: Image;
+    }>;
+    /**
+     * Track Operations
+     */
+    getTrack(session: EditSession, track: string): Promise<{
+        data: Track;
+    }>;
+    updateTrack(session: EditSession, track: string, requestBody: TrackUpdateAttributes): Promise<{
+        data: Track;
+    }>;
+    listTracks(session: EditSession): Promise<{
+        data: TracksListResponse;
+    }>;
+}

package/dist/src/packages/stores/play-store/api-endpoints.js

@@ -0,0 +1,145 @@
+/**
+ * Google Play Console API Endpoints
+ *
+ * Centralized API endpoint management for androidpublisher v3 API
+ */
+export class GooglePlayApiEndpoints {
+    androidPublisher;
+    constructor(androidPublisher) {
+        this.androidPublisher = androidPublisher;
+    }
+    /**
+     * Edit Operations
+     */
+    async createEdit(auth, packageName) {
+        const response = await this.androidPublisher.edits.insert({
+            auth,
+            packageName,
+        });
+        return { data: response.data };
+    }
+    async deleteEdit(session) {
+        await this.androidPublisher.edits.delete({
+            auth: session.auth,
+            packageName: session.packageName,
+            editId: session.editId,
+        });
+        return { data: undefined };
+    }
+    async commitEdit(session) {
+        const response = await this.androidPublisher.edits.commit({
+            auth: session.auth,
+            packageName: session.packageName,
+            editId: session.editId,
+        });
+        return { data: response.data };
+    }
+    /**
+     * App Details Operations
+     */
+    async getAppDetails(session) {
+        const response = await this.androidPublisher.edits.details.get({
+            auth: session.auth,
+            packageName: session.packageName,
+            editId: session.editId,
+        });
+        return { data: response.data };
+    }
+    async updateAppDetails(session, requestBody) {
+        const response = await this.androidPublisher.edits.details.update({
+            auth: session.auth,
+            packageName: session.packageName,
+            editId: session.editId,
+            requestBody,
+        });
+        return { data: response.data };
+    }
+    /**
+     * Listing Operations
+     */
+    async listListings(session) {
+        const response = await this.androidPublisher.edits.listings.list({
+            auth: session.auth,
+            packageName: session.packageName,
+            editId: session.editId,
+        });
+        return { data: response.data };
+    }
+    async getListing(session, language) {
+        const response = await this.androidPublisher.edits.listings.get({
+            auth: session.auth,
+            packageName: session.packageName,
+            editId: session.editId,
+            language,
+        });
+        return { data: response.data };
+    }
+    async updateListing(session, language, requestBody) {
+        const response = await this.androidPublisher.edits.listings.update({
+            auth: session.auth,
+            packageName: session.packageName,
+            editId: session.editId,
+            language,
+            requestBody,
+        });
+        return { data: response.data };
+    }
+    /**
+     * Image Operations
+     */
+    async listImages(session, language, imageType) {
+        const response = await this.androidPublisher.edits.images.list({
+            auth: session.auth,
+            packageName: session.packageName,
+            editId: session.editId,
+            language,
+            imageType,
+        });
+        return { data: response.data };
+    }
+    async uploadImage(session, language, imageType, media) {
+        const response = await this.androidPublisher.edits.images.upload({
+            auth: session.auth,
+            packageName: session.packageName,
+            editId: session.editId,
+            language,
+            imageType,
+            media,
+        });
+        const uploadData = response.data;
+        if (!uploadData?.image) {
+            throw new Error("Image upload failed: no image data returned");
+        }
+        return { data: uploadData.image };
+    }
+    /**
+     * Track Operations
+     */
+    async getTrack(session, track) {
+        const response = await this.androidPublisher.edits.tracks.get({
+            auth: session.auth,
+            packageName: session.packageName,
+            editId: session.editId,
+            track,
+        });
+        return { data: response.data };
+    }
+    async updateTrack(session, track, requestBody) {
+        const response = await this.androidPublisher.edits.tracks.update({
+            auth: session.auth,
+            packageName: session.packageName,
+            editId: session.editId,
+            track,
+            requestBody,
+        });
+        return { data: response.data };
+    }
+    async listTracks(session) {
+        const response = await this.androidPublisher.edits.tracks.list({
+            auth: session.auth,
+            packageName: session.packageName,
+            editId: session.editId,
+        });
+        return { data: response.data };
+    }
+}

package/dist/src/packages/stores/play-store/client.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Google Play Console API Client
+ *
+ * Authentication: Service account JSON key file required
+ * API Documentation: https://developers.google.com/android-publisher
+ */
+import type { GooglePlayAsoData, GooglePlayMultilingualAsoData, GooglePlayReleaseNote } from "../../../packages/configs/aso-config/types.js";
+import type { GooglePlayClientConfig, AppAccessInfo, LatestReleaseInfo, ReleaseUpdateResult, CreateReleaseOptions, UploadScreenshotOptions, UpdateReleaseNotesOptions, AppDetailsData } from "./types.js";
+export declare class GooglePlayClient {
+    private auth;
+    private androidPublisher;
+    private packageName;
+    constructor(config: GooglePlayClientConfig);
+    /**
+     * Verify app access (returns app information)
+     * Google Play API does not support listing apps, so only verifies access by package name
+     */
+    verifyAppAccess(): Promise<AppAccessInfo>;
+    pullAllLanguagesAsoData(): Promise<GooglePlayMultilingualAsoData>;
+    pullAsoData(): Promise<GooglePlayAsoData>;
+    pushAsoData(data: Partial<GooglePlayAsoData>): Promise<void>;
+    /**
+     * Push multilingual ASO data in a single edit session
+     * This prevents backendError from rapid successive commits
+     */
+    pushMultilingualAsoData(data: GooglePlayMultilingualAsoData): Promise<void>;
+    /**
+     * Push app details (contactEmail, contactPhone, contactWebsite) in a separate edit session
+     * This must be called separately from pushMultilingualAsoData due to Google Play API limitations
+     * NOTE: defaultLanguage is required - it will be fetched from current app details if not provided
+     */
+    pushAppDetails(details: AppDetailsData): Promise<void>;
+    uploadScreenshot(options: UploadScreenshotOptions): Promise<void>;
+    getLatestProductionRelease(): Promise<LatestReleaseInfo | null>;
+    createProductionRelease(options: CreateReleaseOptions): Promise<void>;
+    /**
+     * Update release notes for production track
+     */
+    updateReleaseNotes(options: UpdateReleaseNotesOptions): Promise<ReleaseUpdateResult>;
+    pullReleaseNotes(): Promise<GooglePlayReleaseNote[]>;
+    pullProductionReleaseNotes(): Promise<GooglePlayReleaseNote[]>;
+    private createEdit;
+    private deleteEdit;
+    private commitEdit;
+    private getAppDetails;
+    private updateAppDetails;
+    private listListings;
+    private getListing;
+    private updateListing;
+    private listImages;
+    private uploadImage;
+    private getTrack;
+    private updateTrack;
+    private listTracks;
+}