pabal-web-mcp 0.1.6 → 1.1.0

package/dist/index.d.ts

@@ -1,3 +1,6 @@
+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
@@ -70,21 +73,32 @@ 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 {
-    title: string;
-    shortDescription: string;
-    fullDescription: string;
-    screenshots: {
-        phone: string[];
-        tablet?: string[];
-        tablet7?: string[];
-        tablet10?: string[];
-        tv?: string[];
-        wear?: string[];
-    };
+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;
@@ -99,59 +113,57 @@ interface GooglePlayAsoData {
 /**
  * Google Play release notes (per version)
  */
-interface GooglePlayReleaseNote {
-    versionCode: number;
-    versionName: string;
-    releaseNotes: {
-        [language: string]: string;
-    };
-    track: string;
-    status: string;
-    releaseDate?: string;
-}
+type GooglePlayReleaseNote = androidpublisher_v3.Schema$TrackRelease;
 /**
  * App Store release notes (per version)
  */
-interface AppStoreReleaseNote {
-    versionString: string;
-    releaseNotes: {
-        [locale: string]: string;
-    };
-    platform: string;
+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[];
+    ipadPro129?: string[];
+    ipadPro11?: string[];
+    ipad105?: string[];
+    ipad97?: string[];
+    appleWatch?: string[];
 }
 /**
  * App Store ASO data
  */
 interface AppStoreAsoData {
-    name: string;
-    subtitle?: string;
-    description: string;
-    keywords?: string;
-    promotionalText?: string;
-    screenshots: {
-        iphone65?: string[];
-        iphone61?: string[];
-        iphone58?: string[];
-        iphone55?: string[];
-        iphone47?: string[];
-        iphone40?: string[];
-        ipadPro129?: string[];
-        ipadPro11?: string[];
-        ipad105?: string[];
-        ipad97?: string[];
-        appleWatch?: string[];
-    };
+    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?: string;
-    marketingUrl?: string;
-    privacyPolicyUrl?: string;
+    supportUrl?: AppStoreVersionLocalization["supportUrl"];
+    marketingUrl?: AppStoreVersionLocalization["marketingUrl"];
+    privacyPolicyUrl?: AppStoreInfoLocalization["privacyPolicyUrl"];
     bundleId: string;
-    locale: string;
-    whatsNew?: string;
+    locale: NonNullable<AppStoreVersionLocalization["locale"]>;
+    whatsNew?: AppStoreVersionLocalization["whatsNew"];
 }
 /**
  * Multilingual Google Play ASO data
@@ -354,6 +366,86 @@ interface ProductLocale {
     landing?: LandingPageLocale;
 }
 
+/**
+ * Types for the create-blog-html MCP tool
+ */
+interface BlogMeta {
+    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
+     */
+    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 (default en-US). Ignored when locales[] is provided.
+     */
+    locale?: string;
+    /**
+     * Optional list of locales to generate. Each gets its own HTML file.
+     */
+    locales?: 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, BlogMeta>;
+}
+
 /**
  * Locale conversion utilities for ASO platforms
  * Handles conversion between unified locales and platform-specific locale codes
@@ -609,4 +701,4 @@ declare function getPublicDir(): string;
  */
 declare function getProductsDir(): string;
 
-export { APP_STORE_TO_UNIFIED, type AppMetaLinks, type AppPageData, type AppStoreAsoData, type AppStoreLocale, type AppStoreMultilingualAsoData, type AppStoreReleaseNote, type AsoData, type AsoLocaleContent, type AsoTemplate, DEFAULT_LOCALE, type DeepPartial, type FeatureItem, GOOGLE_PLAY_TO_UNIFIED, type GooglePlayAsoData, type GooglePlayLocale, type GooglePlayMultilingualAsoData, type GooglePlayReleaseNote, type ImageAsset, type LandingCta, type LandingFeatures, type LandingHero, type LandingPage, type LandingPageLocale, type LandingReviews, type LandingScreenshots, type LayoutColors, type ProductConfig, type ProductContent, type ProductLocale, type ProductMetadata, type ProductScreenshots, type SupportedLocale, type Testimonial, UNIFIED_LOCALES, UNIFIED_TO_APP_STORE, UNIFIED_TO_GOOGLE_PLAY, type UnifiedLocale, appStoreToGooglePlay, appStoreToUnified, appStoreToUnifiedBatch, convertObjectFromAppStore, convertObjectFromGooglePlay, convertObjectToAppStore, convertObjectToGooglePlay, getAsoDataDir, getProductsDir, getPublicDir, getPullDataDir, getPushDataDir, googlePlayToAppStore, googlePlayToUnified, googlePlayToUnifiedBatch, isAppStoreLocale, isAppStoreMultilingual, isGooglePlayLocale, isGooglePlayMultilingual, isSupportedLocale, loadAsoFromConfig, saveAsoToAsoDir, saveAsoToConfig, unifiedToAppStore, unifiedToAppStoreBatch, unifiedToBothPlatforms, unifiedToGooglePlay, unifiedToGooglePlayBatch };
+export { APP_STORE_TO_UNIFIED, type AppMetaLinks, type AppPageData, type AppStoreAsoData, type AppStoreInfoLocalization, type AppStoreLocale, type AppStoreMultilingualAsoData, type AppStoreReleaseNote, type AppStoreScreenshotDisplayType, type AppStoreScreenshots, type AppStoreVersionLocalization, type AsoData, type AsoLocaleContent, type AsoTemplate, type BlogMeta, type CreateBlogHtmlInput, type CreateBlogHtmlResult, DEFAULT_LOCALE, type DeepPartial, type FeatureItem, GOOGLE_PLAY_TO_UNIFIED, type GeneratedBlogFile, type GooglePlayAsoData, type GooglePlayImageType, type GooglePlayListing, type GooglePlayLocale, type GooglePlayMultilingualAsoData, type GooglePlayReleaseNote, type GooglePlayScreenshotType, type GooglePlayScreenshots, type ImageAsset, type LandingCta, type LandingFeatures, type LandingHero, type LandingPage, type LandingPageLocale, type LandingReviews, type LandingScreenshots, type LayoutColors, type ProductConfig, type ProductContent, type ProductLocale, type ProductMetadata, type ProductScreenshots, type SupportedLocale, type Testimonial, UNIFIED_LOCALES, UNIFIED_TO_APP_STORE, UNIFIED_TO_GOOGLE_PLAY, type UnifiedLocale, appStoreToGooglePlay, appStoreToUnified, appStoreToUnifiedBatch, convertObjectFromAppStore, convertObjectFromGooglePlay, convertObjectToAppStore, convertObjectToGooglePlay, getAsoDataDir, getProductsDir, getPublicDir, getPullDataDir, getPushDataDir, googlePlayToAppStore, googlePlayToUnified, googlePlayToUnifiedBatch, isAppStoreLocale, isAppStoreMultilingual, isGooglePlayLocale, isGooglePlayMultilingual, isSupportedLocale, loadAsoFromConfig, saveAsoToAsoDir, saveAsoToConfig, unifiedToAppStore, unifiedToAppStoreBatch, unifiedToBothPlatforms, unifiedToGooglePlay, unifiedToGooglePlayBatch };

package/dist/index.js

@@ -33,7 +33,7 @@ import {
   unifiedToBothPlatforms,
   unifiedToGooglePlay,
   unifiedToGooglePlayBatch
-} from "./chunk-YPDLNPLX.js";
+} from "./chunk-OCOFNMN2.js";
 export {
   APP_STORE_TO_UNIFIED,
   DEFAULT_LOCALE,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pabal-web-mcp",
-  "version": "0.1.6",
+  "version": "1.1.0",
   "type": "module",
   "description": "MCP server for ASO data management with shared types and utilities",
   "author": "skyu",
@@ -39,7 +39,9 @@
     "prepublishOnly": "npm run build"
   },
   "dependencies": {
+    "@googleapis/androidpublisher": "^33.2.0",
     "@modelcontextprotocol/sdk": "^1.22.0",
+    "appstore-connect-sdk": "^1.3.2",
     "zod": "^3.25.76",
     "zod-to-json-schema": "^3.25.0"
   },