pabal-resource-mcp 1.5.10 → 1.6.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -0,0 +1,807 @@
1
+ import { androidpublisher_v3 } from '@googleapis/androidpublisher';
2
+ import { AppStoreVersionAttributes, AppStoreVersionLocalizationAttributes, AppInfoLocalizationAttributes, ScreenshotDisplayType } from 'appstore-connect-sdk/openapi';
3
+
4
+ /**
5
+ * Unified locale system for ASO (App Store Optimization)
6
+ * Consolidates App Store Connect and Google Play Console locale codes
7
+ */
8
+ /**
9
+ * Unified locale codes used across the application
10
+ * These codes are used in /locales directory structure
11
+ */
12
+ 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"];
13
+ type UnifiedLocale = (typeof UNIFIED_LOCALES)[number];
14
+ /**
15
+ * Default locale (for fallback)
16
+ */
17
+ declare const DEFAULT_LOCALE: UnifiedLocale;
18
+ /**
19
+ * Unified locale to App Store Connect locale mapping
20
+ * Maps our unified locale codes to App Store Connect API codes
21
+ */
22
+ declare const UNIFIED_TO_APP_STORE: Record<UnifiedLocale, string | null>;
23
+ /**
24
+ * Unified locale to Google Play Console locale mapping
25
+ * Maps our unified locale codes to Google Play Console API codes
26
+ */
27
+ declare const UNIFIED_TO_GOOGLE_PLAY: Record<UnifiedLocale, string | null>;
28
+ /**
29
+ * App Store Connect locale to unified locale mapping
30
+ * Reverse mapping for converting App Store codes to our unified system
31
+ */
32
+ declare const APP_STORE_TO_UNIFIED: Record<string, UnifiedLocale>;
33
+ /**
34
+ * Google Play Console locale to unified locale mapping
35
+ * Reverse mapping for converting Google Play codes to our unified system
36
+ */
37
+ declare const GOOGLE_PLAY_TO_UNIFIED: Record<string, UnifiedLocale>;
38
+ /**
39
+ * Locales supported by App Store Connect
40
+ */
41
+ 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")[];
42
+ /**
43
+ * Locales supported by Google Play Console
44
+ */
45
+ 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")[];
46
+
47
+ /**
48
+ * ASO (App Store Optimization) data type definitions
49
+ */
50
+
51
+ /**
52
+ * Unified locale type used across the application
53
+ * This type represents the unified locale codes used in /locales directory
54
+ */
55
+ type SupportedLocale = UnifiedLocale;
56
+ /**
57
+ * App Store Connect specific locale type
58
+ */
59
+ type AppStoreLocale = (typeof APP_STORE_SUPPORTED_LOCALES)[number];
60
+ /**
61
+ * Google Play Console specific locale type
62
+ */
63
+ type GooglePlayLocale = (typeof GOOGLE_PLAY_SUPPORTED_LOCALES)[number];
64
+ /**
65
+ * Check if locale is supported by our unified system
66
+ */
67
+ declare function isSupportedLocale(locale: string): locale is SupportedLocale;
68
+ /**
69
+ * Check if locale is supported by App Store
70
+ */
71
+ declare function isAppStoreLocale(locale: string): locale is AppStoreLocale;
72
+ /**
73
+ * Check if locale is supported by Google Play
74
+ */
75
+ declare function isGooglePlayLocale(locale: string): locale is GooglePlayLocale;
76
+ /**
77
+ * Google Play Android Publisher base types
78
+ */
79
+ type GooglePlayListing = androidpublisher_v3.Schema$Listing;
80
+ type GooglePlayImageType = NonNullable<androidpublisher_v3.Params$Resource$Edits$Images$List["imageType"]>;
81
+ type GooglePlayScreenshotType = Extract<GooglePlayImageType, "phoneScreenshots" | "sevenInchScreenshots" | "tenInchScreenshots" | "tvScreenshots" | "wearScreenshots">;
82
+ /**
83
+ * Google Play screenshots keyed by Android Publisher imageType
84
+ * Includes legacy aliases for existing data structures
85
+ */
86
+ interface GooglePlayScreenshots extends Partial<Record<GooglePlayScreenshotType, string[]>> {
87
+ phone?: string[];
88
+ tablet?: string[];
89
+ tablet7?: string[];
90
+ tablet10?: string[];
91
+ tv?: string[];
92
+ wear?: string[];
93
+ }
94
+ /**
95
+ * Google Play Store ASO data
96
+ */
97
+ interface GooglePlayAsoData extends Pick<GooglePlayListing, "video" | "language"> {
98
+ title: NonNullable<GooglePlayListing["title"]>;
99
+ shortDescription: NonNullable<GooglePlayListing["shortDescription"]>;
100
+ fullDescription: NonNullable<GooglePlayListing["fullDescription"]>;
101
+ screenshots: GooglePlayScreenshots;
102
+ featureGraphic?: string;
103
+ promoGraphic?: string;
104
+ category?: string;
105
+ contentRating?: string;
106
+ keywords?: string[];
107
+ contactEmail?: string;
108
+ contactPhone?: string;
109
+ contactWebsite?: string;
110
+ packageName: string;
111
+ defaultLanguage: string;
112
+ }
113
+ /**
114
+ * Google Play release notes (per version)
115
+ */
116
+ type GooglePlayReleaseNote = androidpublisher_v3.Schema$TrackRelease;
117
+ /**
118
+ * App Store release notes (per version)
119
+ */
120
+ type AppStoreReleaseNote = Pick<AppStoreVersionAttributes, "versionString" | "platform"> & {
121
+ releaseNotes: Record<string, NonNullable<AppStoreVersionLocalizationAttributes["whatsNew"]>>;
122
+ releaseDate?: string;
123
+ };
124
+ /**
125
+ * App Store Connect base types
126
+ */
127
+ type AppStoreInfoLocalization = AppInfoLocalizationAttributes;
128
+ type AppStoreVersionLocalization = AppStoreVersionLocalizationAttributes;
129
+ type AppStoreScreenshotDisplayType = ScreenshotDisplayType;
130
+ /**
131
+ * App Store screenshots keyed by official display type
132
+ * Includes legacy aliases used in existing data structures
133
+ */
134
+ interface AppStoreScreenshots extends Partial<Record<AppStoreScreenshotDisplayType, string[]>> {
135
+ iphone65?: string[];
136
+ iphone61?: string[];
137
+ iphone58?: string[];
138
+ iphone55?: string[];
139
+ iphone47?: string[];
140
+ iphone40?: string[];
141
+ ipadPro129?: string[];
142
+ ipadPro11?: string[];
143
+ ipad105?: string[];
144
+ ipad97?: string[];
145
+ appleWatch?: string[];
146
+ }
147
+ /**
148
+ * App Store ASO data
149
+ */
150
+ interface AppStoreAsoData {
151
+ name: NonNullable<AppStoreInfoLocalization["name"]>;
152
+ subtitle?: AppStoreInfoLocalization["subtitle"];
153
+ description: NonNullable<AppStoreVersionLocalization["description"]>;
154
+ keywords?: AppStoreVersionLocalization["keywords"];
155
+ promotionalText?: AppStoreVersionLocalization["promotionalText"];
156
+ screenshots: AppStoreScreenshots;
157
+ appPreview?: string[];
158
+ primaryCategory?: string;
159
+ secondaryCategory?: string;
160
+ contentRightId?: string;
161
+ supportUrl?: AppStoreVersionLocalization["supportUrl"];
162
+ marketingUrl?: AppStoreVersionLocalization["marketingUrl"];
163
+ privacyPolicyUrl?: AppStoreInfoLocalization["privacyPolicyUrl"];
164
+ termsUrl?: string;
165
+ bundleId: string;
166
+ locale: NonNullable<AppStoreVersionLocalization["locale"]>;
167
+ whatsNew?: AppStoreVersionLocalization["whatsNew"];
168
+ }
169
+ /**
170
+ * Multilingual Google Play ASO data
171
+ */
172
+ interface GooglePlayMultilingualAsoData {
173
+ locales: {
174
+ [locale: string]: GooglePlayAsoData;
175
+ };
176
+ defaultLocale?: string;
177
+ contactEmail?: string;
178
+ contactWebsite?: string;
179
+ }
180
+ /**
181
+ * Multilingual App Store ASO data
182
+ */
183
+ interface AppStoreMultilingualAsoData {
184
+ locales: {
185
+ [locale: string]: AppStoreAsoData;
186
+ };
187
+ defaultLocale?: string;
188
+ contactEmail?: string;
189
+ supportUrl?: string;
190
+ marketingUrl?: string;
191
+ privacyPolicyUrl?: string;
192
+ termsUrl?: string;
193
+ }
194
+ /**
195
+ * Unified ASO data (format stored in local config.json)
196
+ * Supports single language (legacy compatible) or multilingual structure
197
+ */
198
+ interface AsoData {
199
+ googlePlay?: GooglePlayAsoData | GooglePlayMultilingualAsoData;
200
+ appStore?: AppStoreAsoData | AppStoreMultilingualAsoData;
201
+ lastSynced?: {
202
+ googlePlay?: string;
203
+ appStore?: string;
204
+ };
205
+ }
206
+ /**
207
+ * Check if Google Play data is multilingual structure
208
+ */
209
+ declare function isGooglePlayMultilingual(data: GooglePlayAsoData | GooglePlayMultilingualAsoData | undefined): data is GooglePlayMultilingualAsoData;
210
+ /**
211
+ * Check if App Store data is multilingual structure
212
+ */
213
+ declare function isAppStoreMultilingual(data: AppStoreAsoData | AppStoreMultilingualAsoData | undefined): data is AppStoreMultilingualAsoData;
214
+
215
+ /**
216
+ * Blog type definitions
217
+ * Used by both MCP tools and web application
218
+ */
219
+ /**
220
+ * Blog Meta Block (raw from HTML comment)
221
+ * All fields are optional as they may be parsed from HTML or defaults
222
+ */
223
+ interface BlogMetaBlock {
224
+ title: string;
225
+ description: string;
226
+ appSlug: string;
227
+ slug: string;
228
+ locale?: string;
229
+ coverImage?: string;
230
+ publishedAt?: string;
231
+ modifiedAt?: string;
232
+ tags?: string[];
233
+ }
234
+ /**
235
+ * Blog Meta (resolved with UnifiedLocale)
236
+ * Used by web application after normalization
237
+ */
238
+ interface BlogMeta extends BlogMetaBlock {
239
+ locale: UnifiedLocale;
240
+ coverImage?: string;
241
+ publishedAt?: string;
242
+ modifiedAt?: string;
243
+ }
244
+ /**
245
+ * Blog Article (complete parsed article with HTML content)
246
+ */
247
+ interface BlogArticle {
248
+ appSlug: string;
249
+ slug: string;
250
+ locale: UnifiedLocale;
251
+ html: string;
252
+ meta: BlogMeta;
253
+ filePath: string;
254
+ }
255
+ /**
256
+ * Blog Summary (aggregated metadata across locales)
257
+ */
258
+ interface BlogSummary {
259
+ appSlug: string;
260
+ slug: string;
261
+ title: string;
262
+ description: string;
263
+ coverImage?: string;
264
+ publishedAt?: string;
265
+ modifiedAt?: string;
266
+ locales: UnifiedLocale[];
267
+ defaultLocale: UnifiedLocale;
268
+ }
269
+
270
+ interface ImageAsset {
271
+ src: string;
272
+ alt: string;
273
+ width?: number;
274
+ height?: number;
275
+ srcDark?: string;
276
+ }
277
+ interface LandingHero {
278
+ brand?: string;
279
+ logoPath?: string;
280
+ title?: string;
281
+ titleHighlight?: string;
282
+ description: string;
283
+ }
284
+ interface LandingScreenshots {
285
+ title?: string;
286
+ images: Array<{
287
+ imageSrc: string;
288
+ width?: number;
289
+ height?: number;
290
+ title: string;
291
+ description: string;
292
+ }>;
293
+ }
294
+ interface FeatureItem {
295
+ title: string;
296
+ body: string;
297
+ iconPath?: string;
298
+ iconName?: string;
299
+ media?: ImageAsset;
300
+ badge?: string;
301
+ }
302
+ interface LandingFeatures {
303
+ title: string;
304
+ items: FeatureItem[];
305
+ }
306
+ interface Testimonial {
307
+ authorName: string;
308
+ handle?: string;
309
+ avatarPath?: string;
310
+ quote: string;
311
+ rating?: number;
312
+ }
313
+ interface LandingReviews {
314
+ title?: string;
315
+ description?: string;
316
+ testimonials: Testimonial[];
317
+ icons?: string[];
318
+ rating?: number;
319
+ }
320
+ interface LandingCta {
321
+ headline: string;
322
+ icons?: string[];
323
+ rating?: number;
324
+ description?: string;
325
+ }
326
+ interface LandingPage {
327
+ hero: LandingHero;
328
+ screenshots: LandingScreenshots;
329
+ features: LandingFeatures;
330
+ reviews: LandingReviews;
331
+ cta: LandingCta;
332
+ }
333
+ type DeepPartial<T> = T extends (infer U)[] ? Array<DeepPartial<U>> : T extends object ? {
334
+ [P in keyof T]?: DeepPartial<T[P]>;
335
+ } : T;
336
+ type LandingPageLocale = DeepPartial<LandingPage>;
337
+
338
+ /**
339
+ * Product Config JSON file type definitions
340
+ * Structure for public/products/{slug}/config.json
341
+ */
342
+ /**
343
+ * Screenshot metadata
344
+ */
345
+ interface ProductScreenshots {
346
+ phone?: string[];
347
+ tablet?: string[];
348
+ }
349
+ /**
350
+ * Product Metadata (store-common metadata)
351
+ */
352
+ interface ProductMetadata {
353
+ category?: string;
354
+ contactEmail?: string;
355
+ instagram?: string;
356
+ supportUrl?: string;
357
+ marketingUrl?: string;
358
+ termsUrl?: string;
359
+ privacyUrl?: string;
360
+ screenshots?: ProductScreenshots;
361
+ featureGraphic?: string;
362
+ }
363
+ /**
364
+ * Product Content settings
365
+ */
366
+ interface ProductContent {
367
+ defaultLocale?: string;
368
+ }
369
+ /**
370
+ * Product Config (complete config.json structure)
371
+ *
372
+ * Based on actual config.json file structure,
373
+ * includes additional fields used by existing code.
374
+ */
375
+ interface ProductConfig {
376
+ slug: string;
377
+ order?: number;
378
+ appStoreAppId?: string;
379
+ packageName?: string;
380
+ bundleId?: string;
381
+ isHiddenAtHomepage?: boolean;
382
+ layoutColors?: LayoutColors;
383
+ metadata?: ProductMetadata;
384
+ content?: ProductContent;
385
+ name?: string;
386
+ tagline?: string;
387
+ webUrl?: string;
388
+ hasDetailPage?: boolean;
389
+ isDarkIcon?: boolean;
390
+ landing?: LandingPage;
391
+ }
392
+
393
+ interface LayoutColors {
394
+ bg?: string;
395
+ fg?: string;
396
+ fgMuted?: string;
397
+ muted?: string;
398
+ accentGrad?: string;
399
+ }
400
+ interface AppMetaLinks {
401
+ privacyPath: string;
402
+ termsPath: string;
403
+ backPath: string;
404
+ }
405
+ interface AppPageData {
406
+ product?: ProductConfig;
407
+ links: AppMetaLinks;
408
+ privacy: string;
409
+ terms: string;
410
+ layoutColors?: LayoutColors;
411
+ landing?: LandingPage;
412
+ }
413
+
414
+ interface AsoTemplate {
415
+ intro: string;
416
+ keyFeaturesHeading?: string;
417
+ featuresHeading?: string;
418
+ outro: string;
419
+ includeSupportLinks?: boolean;
420
+ }
421
+ interface AsoLocaleContent {
422
+ title?: string;
423
+ subtitle?: string;
424
+ shortDescription?: string;
425
+ keywords?: string[] | string;
426
+ template?: AsoTemplate;
427
+ }
428
+ interface ProductLocale {
429
+ aso?: AsoLocaleContent;
430
+ landing?: LandingPageLocale;
431
+ }
432
+
433
+ /**
434
+ * Site data type definitions
435
+ * Structure for public/site/ directory
436
+ * - config.json: Site configuration (supported locales, default locale)
437
+ * - contacts.json: Contact information
438
+ * - locales/en-US.json: Localized content (meta, hero, developer)
439
+ */
440
+
441
+ /**
442
+ * Site configuration for locale support
443
+ * Stored in public/site/config.json
444
+ */
445
+ interface SiteConfig {
446
+ /** List of locales supported by this site */
447
+ supportedLocales: UnifiedLocale[];
448
+ /** Default locale for fallback */
449
+ defaultLocale: UnifiedLocale;
450
+ }
451
+ /**
452
+ * Locale display information for UI components
453
+ */
454
+ interface LocaleDisplayInfo {
455
+ /** Locale code (e.g., "en-US", "ko-KR") */
456
+ code: UnifiedLocale;
457
+ /** English name of the language */
458
+ name: string;
459
+ /** Native name of the language */
460
+ nativeName: string;
461
+ /** Flag emoji */
462
+ flag: string;
463
+ }
464
+ interface SiteData {
465
+ meta: {
466
+ title: string;
467
+ description: string;
468
+ };
469
+ hero: {
470
+ brand: string;
471
+ tagline: string;
472
+ subtitle: string;
473
+ };
474
+ contacts: {
475
+ id: string;
476
+ label: string;
477
+ icon: string;
478
+ value: string;
479
+ }[];
480
+ developer: {
481
+ name: string;
482
+ heading: string;
483
+ role: string;
484
+ bio: string;
485
+ principles: string[];
486
+ stack: string[];
487
+ now: string;
488
+ availability: string;
489
+ likes: string[];
490
+ location?: string;
491
+ timezone?: string;
492
+ visited: {
493
+ countries: {
494
+ code: string;
495
+ name: string;
496
+ flagEmoji: string;
497
+ cities: string[];
498
+ }[];
499
+ };
500
+ };
501
+ }
502
+
503
+ /**
504
+ * Types for the create-blog-html MCP tool
505
+ */
506
+ /**
507
+ * BlogMetaOutput for MCP tool output
508
+ * All fields are required (resolved values)
509
+ * Note: This is separate from blog.types.ts BlogMeta which uses UnifiedLocale
510
+ */
511
+ interface BlogMetaOutput {
512
+ title: string;
513
+ description: string;
514
+ appSlug: string;
515
+ slug: string;
516
+ locale: string;
517
+ publishedAt: string;
518
+ modifiedAt: string;
519
+ coverImage: string;
520
+ tags: string[];
521
+ }
522
+ interface CreateBlogHtmlInput {
523
+ /**
524
+ * Product/app slug used for paths and CTAs.
525
+ * Defaults to "developer" when not provided.
526
+ */
527
+ appSlug: string;
528
+ /**
529
+ * English title used for slug creation and H1
530
+ */
531
+ title?: string;
532
+ /**
533
+ * Topic/angle to cover inside the article body
534
+ */
535
+ topic: string;
536
+ /**
537
+ * Single locale to generate (REQUIRED). Ignored when locales[] is provided.
538
+ */
539
+ locale: string;
540
+ /**
541
+ * Optional list of locales to generate. Each gets its own HTML file.
542
+ */
543
+ locales?: string[];
544
+ /**
545
+ * HTML content for the blog body. REQUIRED. The LLM must generate this based on the topic and locale.
546
+ * Structure should follow public/en-US.html pattern.
547
+ */
548
+ content: string;
549
+ /**
550
+ * Meta description override. If absent, a locale-aware summary is generated from topic/appSlug.
551
+ */
552
+ description?: string;
553
+ /**
554
+ * Optional tags for BLOG_META. If absent, tags are derived from topic and appSlug.
555
+ */
556
+ tags?: string[];
557
+ /**
558
+ * Optional cover image. Relative paths are rewritten to /blogs/<app>/<slug>/...
559
+ */
560
+ coverImage?: string;
561
+ /**
562
+ * Include a relative image example in the body (./images/hero.png by default).
563
+ */
564
+ includeRelativeImageExample?: boolean;
565
+ /**
566
+ * Override the relative image path used when includeRelativeImageExample is true.
567
+ */
568
+ relativeImagePath?: string;
569
+ /**
570
+ * Publish date (YYYY-MM-DD). Defaults to today.
571
+ */
572
+ publishedAt?: string;
573
+ /**
574
+ * Last modified date (YYYY-MM-DD). Defaults to publishedAt.
575
+ */
576
+ modifiedAt?: string;
577
+ /**
578
+ * Overwrite existing HTML files when true (default false).
579
+ */
580
+ overwrite?: boolean;
581
+ }
582
+ interface GeneratedBlogFile {
583
+ locale: string;
584
+ path: string;
585
+ }
586
+ interface CreateBlogHtmlResult {
587
+ slug: string;
588
+ baseDir: string;
589
+ files: GeneratedBlogFile[];
590
+ coverImage: string;
591
+ metaByLocale: Record<string, BlogMetaOutput>;
592
+ }
593
+
594
+ /**
595
+ * Locale conversion utilities for ASO platforms
596
+ * Handles conversion between unified locales and platform-specific locale codes
597
+ */
598
+
599
+ /**
600
+ * Convert unified locale to App Store Connect locale
601
+ * Returns null if the locale is not supported by App Store
602
+ *
603
+ * @param locale - Unified locale code (e.g., "ar", "zh-Hans")
604
+ * @returns App Store locale code (e.g., "ar-SA", "zh-Hans") or null
605
+ *
606
+ * @example
607
+ * unifiedToAppStore("ar") // Returns "ar-SA"
608
+ * unifiedToAppStore("zh-Hans") // Returns "zh-Hans"
609
+ * unifiedToAppStore("en-IN") // Returns null (not supported)
610
+ */
611
+ declare function unifiedToAppStore(locale: UnifiedLocale): string | null;
612
+ /**
613
+ * Convert unified locale to Google Play Console locale
614
+ * Returns null if the locale is not supported by Google Play
615
+ *
616
+ * @param locale - Unified locale code (e.g., "ar", "zh-Hans")
617
+ * @returns Google Play locale code (e.g., "ar-SA", "zh-CN") or null
618
+ *
619
+ * @example
620
+ * unifiedToGooglePlay("ar") // Returns "ar-SA"
621
+ * unifiedToGooglePlay("zh-Hans") // Returns "zh-CN"
622
+ * unifiedToGooglePlay("bg-BG") // Returns "bg-BG"
623
+ */
624
+ declare function unifiedToGooglePlay(locale: UnifiedLocale): string | null;
625
+ /**
626
+ * Convert unified locale to both platforms
627
+ * Returns an object with App Store and Google Play locale codes
628
+ *
629
+ * @param locale - Unified locale code
630
+ * @returns Object with appStore and googlePlay locale codes (or null if not supported)
631
+ *
632
+ * @example
633
+ * unifiedToBothPlatforms("ar")
634
+ * // Returns { appStore: "ar-SA", googlePlay: "ar-SA" }
635
+ *
636
+ * unifiedToBothPlatforms("zh-Hans")
637
+ * // Returns { appStore: "zh-Hans", googlePlay: "zh-CN" }
638
+ */
639
+ declare function unifiedToBothPlatforms(locale: UnifiedLocale): {
640
+ appStore: string | null;
641
+ googlePlay: string | null;
642
+ };
643
+ /**
644
+ * Convert App Store Connect locale to unified locale
645
+ * Returns the default locale if the App Store locale is not recognized
646
+ *
647
+ * @param locale - App Store locale code (e.g., "ar-SA", "zh-Hans")
648
+ * @returns Unified locale code (e.g., "ar", "zh-Hans")
649
+ *
650
+ * @example
651
+ * appStoreToUnified("ar-SA") // Returns "ar"
652
+ * appStoreToUnified("zh-Hans") // Returns "zh-Hans"
653
+ * appStoreToUnified("es-MX") // Returns "es-419"
654
+ */
655
+ declare function appStoreToUnified(locale: string): UnifiedLocale;
656
+ /**
657
+ * Convert Google Play Console locale to unified locale
658
+ * Returns the default locale if the Google Play locale is not recognized
659
+ *
660
+ * @param locale - Google Play locale code (e.g., "ar-SA", "zh-CN")
661
+ * @returns Unified locale code (e.g., "ar", "zh-Hans")
662
+ *
663
+ * @example
664
+ * googlePlayToUnified("ar-SA") // Returns "ar"
665
+ * googlePlayToUnified("zh-CN") // Returns "zh-Hans"
666
+ * googlePlayToUnified("zh-TW") // Returns "zh-Hant"
667
+ */
668
+ declare function googlePlayToUnified(locale: string): UnifiedLocale;
669
+ /**
670
+ * Convert multiple unified locales to App Store locales
671
+ * Filters out locales not supported by App Store
672
+ *
673
+ * @param locales - Array of unified locale codes
674
+ * @returns Array of App Store locale codes (excluding unsupported locales)
675
+ *
676
+ * @example
677
+ * unifiedToAppStoreBatch(["ar", "zh-Hans", "en-IN"])
678
+ * // Returns ["ar-SA", "zh-Hans"] (en-IN is not supported by App Store)
679
+ */
680
+ declare function unifiedToAppStoreBatch(locales: UnifiedLocale[]): string[];
681
+ /**
682
+ * Convert multiple unified locales to Google Play locales
683
+ * Filters out locales not supported by Google Play
684
+ *
685
+ * @param locales - Array of unified locale codes
686
+ * @returns Array of Google Play locale codes (excluding unsupported locales)
687
+ *
688
+ * @example
689
+ * unifiedToGooglePlayBatch(["ar", "zh-Hans", "bg-BG"])
690
+ * // Returns ["ar-SA", "zh-CN", "bg-BG"]
691
+ */
692
+ declare function unifiedToGooglePlayBatch(locales: UnifiedLocale[]): string[];
693
+ /**
694
+ * Convert multiple App Store locales to unified locales
695
+ *
696
+ * @param locales - Array of App Store locale codes
697
+ * @returns Array of unified locale codes
698
+ *
699
+ * @example
700
+ * appStoreToUnifiedBatch(["ar-SA", "zh-Hans", "es-MX"])
701
+ * // Returns ["ar", "zh-Hans", "es-419"]
702
+ */
703
+ declare function appStoreToUnifiedBatch(locales: string[]): UnifiedLocale[];
704
+ /**
705
+ * Convert multiple Google Play locales to unified locales
706
+ *
707
+ * @param locales - Array of Google Play locale codes
708
+ * @returns Array of unified locale codes
709
+ *
710
+ * @example
711
+ * googlePlayToUnifiedBatch(["ar-SA", "zh-CN", "zh-TW"])
712
+ * // Returns ["ar", "zh-Hans", "zh-Hant"]
713
+ */
714
+ declare function googlePlayToUnifiedBatch(locales: string[]): UnifiedLocale[];
715
+ /**
716
+ * Convert App Store locale to Google Play locale
717
+ * Goes through unified locale as intermediate step
718
+ *
719
+ * @param locale - App Store locale code
720
+ * @returns Google Play locale code or null if conversion not possible
721
+ *
722
+ * @example
723
+ * appStoreToGooglePlay("ar-SA") // Returns "ar-SA"
724
+ * appStoreToGooglePlay("zh-Hans") // Returns "zh-CN"
725
+ * appStoreToGooglePlay("es-MX") // Returns "es-419"
726
+ */
727
+ declare function appStoreToGooglePlay(locale: string): string | null;
728
+ /**
729
+ * Convert Google Play locale to App Store locale
730
+ * Goes through unified locale as intermediate step
731
+ *
732
+ * @param locale - Google Play locale code
733
+ * @returns App Store locale code or null if conversion not possible
734
+ *
735
+ * @example
736
+ * googlePlayToAppStore("ar-SA") // Returns "ar-SA"
737
+ * googlePlayToAppStore("zh-CN") // Returns "zh-Hans"
738
+ * googlePlayToAppStore("zh-TW") // Returns "zh-Hant"
739
+ * googlePlayToAppStore("en-IN") // Returns null (not supported by App Store)
740
+ */
741
+ declare function googlePlayToAppStore(locale: string): string | null;
742
+ /**
743
+ * Convert an object with unified locale keys to App Store locale keys
744
+ * Useful for converting locale-based data structures
745
+ *
746
+ * @param data - Object with unified locale keys
747
+ * @returns Object with App Store locale keys (excluding unsupported locales)
748
+ *
749
+ * @example
750
+ * convertObjectToAppStore({
751
+ * "ar": "مرحبا",
752
+ * "zh-Hans": "你好",
753
+ * "en-IN": "Hello"
754
+ * })
755
+ * // Returns { "ar-SA": "مرحبا", "zh-Hans": "你好" }
756
+ */
757
+ declare function convertObjectToAppStore<T>(data: Record<UnifiedLocale, T>): Record<string, T>;
758
+ /**
759
+ * Convert an object with unified locale keys to Google Play locale keys
760
+ * Useful for converting locale-based data structures
761
+ *
762
+ * @param data - Object with unified locale keys
763
+ * @returns Object with Google Play locale keys (excluding unsupported locales)
764
+ *
765
+ * @example
766
+ * convertObjectToGooglePlay({
767
+ * "ar": "مرحبا",
768
+ * "zh-Hans": "你好",
769
+ * "zh-Hant": "你好"
770
+ * })
771
+ * // Returns { "ar-SA": "مرحبا", "zh-CN": "你好", "zh-TW": "你好" }
772
+ */
773
+ declare function convertObjectToGooglePlay<T>(data: Record<UnifiedLocale, T>): Record<string, T>;
774
+ /**
775
+ * Convert an object with App Store locale keys to unified locale keys
776
+ * Useful for converting locale-based data structures from App Store
777
+ *
778
+ * @param data - Object with App Store locale keys
779
+ * @returns Object with unified locale keys
780
+ *
781
+ * @example
782
+ * convertObjectFromAppStore({
783
+ * "ar-SA": "مرحبا",
784
+ * "zh-Hans": "你好",
785
+ * "es-MX": "Hola"
786
+ * })
787
+ * // Returns { "ar": "مرحبا", "zh-Hans": "你好", "es-419": "Hola" }
788
+ */
789
+ declare function convertObjectFromAppStore<T>(data: Record<string, T>): Record<UnifiedLocale, T>;
790
+ /**
791
+ * Convert an object with Google Play locale keys to unified locale keys
792
+ * Useful for converting locale-based data structures from Google Play
793
+ *
794
+ * @param data - Object with Google Play locale keys
795
+ * @returns Object with unified locale keys
796
+ *
797
+ * @example
798
+ * convertObjectFromGooglePlay({
799
+ * "ar-SA": "مرحبا",
800
+ * "zh-CN": "你好",
801
+ * "zh-TW": "你好"
802
+ * })
803
+ * // Returns { "ar": "مرحبا", "zh-Hans": "你好", "zh-Hant": "你好" }
804
+ */
805
+ declare function convertObjectFromGooglePlay<T>(data: Record<string, T>): Record<UnifiedLocale, T>;
806
+
807
+ export { type AsoLocaleContent 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 ProductMetadata as X, type ProductContent as Y, type ProductConfig as Z, type AsoTemplate as _, UNIFIED_TO_APP_STORE as a, type ProductLocale as a0, type SiteConfig as a1, type LocaleDisplayInfo as a2, type SiteData as a3, type BlogMetaOutput as a4, type CreateBlogHtmlInput as a5, type GeneratedBlogFile as a6, type CreateBlogHtmlResult as a7, unifiedToAppStore as a8, unifiedToGooglePlay as a9, unifiedToBothPlatforms as aa, appStoreToUnified as ab, googlePlayToUnified as ac, unifiedToAppStoreBatch as ad, unifiedToGooglePlayBatch as ae, appStoreToUnifiedBatch as af, googlePlayToUnifiedBatch as ag, appStoreToGooglePlay as ah, googlePlayToAppStore as ai, convertObjectToAppStore as aj, convertObjectToGooglePlay as ak, convertObjectFromAppStore as al, convertObjectFromGooglePlay as am, 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 };