slowlane 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Alexander Fenster
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,106 @@
+# slowlane
+
+A simple CLI for managing App Store and Google Play metadata.
+
+Fastlane is powerful but complex to set up. Slowlane focuses on one thing: making it easy to update localized metadata (titles, descriptions, keywords) across multiple languages. Screenshots, builds, and submitting for review are left to the respective console UIs.
+
+## Setup
+
+### Apple App Store Connect
+
+1. Go to [App Store Connect > Users and Access > Integrations > App Store Connect API](https://appstoreconnect.apple.com/access/integrations/api)
+2. Generate a new API key with "App Manager" role
+3. Download the `.p8` private key file
+4. Note the Key ID and Issuer ID
+
+### Google Play Console
+
+1. Go to [Google Cloud Console](https://console.cloud.google.com/)
+2. Create a project (or use existing)
+3. Enable both APIs:
+   - **Google Play Developer Reporting API** (for listing apps)
+   - **Google Play Android Developer API** (for metadata operations)
+4. Create a Service Account with a JSON key
+5. In [Google Play Console > Setup > API access](https://play.google.com/console/developers/api-access), link the service account and grant "Release to production" permission
+
+### Configuration
+
+Create `slowlane.toml` in your project directory:
+
+```toml
+[appstore_connect]
+issuer_id = "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
+key_id = "XXXXXXXXXX"
+private_key_path = "./AuthKey_XXXXXXXXXX.p8"
+
+[google_play]
+service_account_path = "./your-service-account.json"
+```
+
+Add sensitive files to `.gitignore`:
+
+```
+slowlane.toml
+*.p8
+*-service-account.json
+```
+
+## Usage
+
+### Apple App Store Connect
+
+```bash
+# List all apps
+npx slowlane apple list-apps
+
+# View metadata for all languages (from editable version)
+npx slowlane apple get-metadata com.example.app
+
+# View full metadata for a specific language
+npx slowlane apple get-metadata com.example.app en-US
+
+# Save metadata from live version to JSON
+npx slowlane apple get-metadata com.example.app --from live --json > metadata.json
+
+# Create a new version
+npx slowlane apple create-version com.example.app 2.0.0
+
+# Update metadata from JSON file
+npx slowlane apple set-metadata com.example.app -f metadata.json
+```
+
+### Google Play
+
+```bash
+# List all apps
+npx slowlane google list-apps
+
+# View metadata for all languages
+npx slowlane google get-metadata com.example.app
+
+# View full metadata for a specific language
+npx slowlane google get-metadata com.example.app en-US
+
+# Save metadata to JSON
+npx slowlane google get-metadata com.example.app --json > metadata.json
+
+# Update metadata from JSON (staged, not sent for review)
+npx slowlane google set-metadata com.example.app -f metadata.json
+
+# Update and send for review immediately
+npx slowlane google set-metadata com.example.app -f metadata.json --send-for-review
+```
+
+## Typical Workflow
+
+1. **Export current metadata** from the live version as a starting point
+2. **Edit the JSON** file to update descriptions, keywords, etc.
+3. **Create a new version** (Apple only - Google doesn't require this for metadata)
+4. **Import the updated metadata** from the JSON file
+5. **Review and submit** in the respective console UI
+
+## Author
+
+Alexander Fenster, slowlane@fenster.name
+
+100% vibe coded with [Claude Code](https://claude.ai/code)

package/build/src/appstoreconnect.d.ts

@@ -0,0 +1,155 @@
+export interface AppStoreConnectConfig {
+    issuer_id: string;
+    key_id: string;
+    private_key_path: string;
+}
+export interface GooglePlayConfig {
+    service_account_path: string;
+    packages?: string[];
+}
+export interface SlowlaneConfig {
+    appstore_connect?: AppStoreConnectConfig;
+    google_play?: GooglePlayConfig;
+}
+interface ResourceLinks {
+    self: string;
+}
+interface AppAttributes {
+    name: string;
+    bundleId: string;
+    sku: string;
+    primaryLocale: string;
+    isOrEverWasMadeForKids: boolean;
+    subscriptionStatusUrl?: string;
+    subscriptionStatusUrlVersion?: string;
+    subscriptionStatusUrlForSandbox?: string;
+    subscriptionStatusUrlVersionForSandbox?: string;
+    contentRightsDeclaration?: string;
+    streamlinedPurchasingEnabled: boolean;
+}
+interface AppRelationships {
+    appStoreVersions?: {
+        links: ResourceLinks;
+    };
+    builds?: {
+        links: ResourceLinks;
+    };
+    betaAppLocalizations?: {
+        links: ResourceLinks;
+    };
+    betaGroups?: {
+        links: ResourceLinks;
+    };
+    preReleaseVersions?: {
+        links: ResourceLinks;
+    };
+}
+export interface App {
+    type: 'apps';
+    id: string;
+    attributes: AppAttributes;
+    relationships?: AppRelationships;
+    links: ResourceLinks;
+}
+interface AppInfoAttributes {
+    appStoreState: string;
+    appStoreAgeRating?: string;
+    brazilAgeRating?: string;
+    brazilAgeRatingV2?: string;
+    kidsAgeBand?: string;
+    state: string;
+}
+interface AppInfo {
+    type: 'appInfos';
+    id: string;
+    attributes: AppInfoAttributes;
+    links: ResourceLinks;
+}
+interface AppInfoLocalizationAttributes {
+    locale: string;
+    name?: string;
+    subtitle?: string;
+    privacyPolicyUrl?: string;
+    privacyChoicesUrl?: string;
+    privacyPolicyText?: string;
+}
+export interface AppInfoLocalization {
+    type: 'appInfoLocalizations';
+    id: string;
+    attributes: AppInfoLocalizationAttributes;
+    links: ResourceLinks;
+}
+interface AppStoreVersionLocalizationAttributes {
+    locale: string;
+    description?: string;
+    keywords?: string;
+    marketingUrl?: string;
+    promotionalText?: string;
+    supportUrl?: string;
+    whatsNew?: string;
+}
+export interface AppStoreVersionLocalization {
+    type: 'appStoreVersionLocalizations';
+    id: string;
+    attributes: AppStoreVersionLocalizationAttributes;
+    links: ResourceLinks;
+}
+export type Platform = 'IOS' | 'MAC_OS' | 'TV_OS' | 'VISION_OS';
+interface AppStoreVersionAttributes {
+    platform: Platform;
+    versionString: string;
+    appStoreState: string;
+    appVersionState: string;
+    copyright?: string;
+    releaseType?: string;
+    earliestReleaseDate?: string;
+    downloadable: boolean;
+    createdDate: string;
+}
+export interface AppStoreVersion {
+    type: 'appStoreVersions';
+    id: string;
+    attributes: AppStoreVersionAttributes;
+    links: ResourceLinks;
+}
+export interface AppMetadata {
+    app: App;
+    appInfo: AppInfo;
+    liveVersion?: AppStoreVersion;
+    editableVersion?: AppStoreVersion;
+    localizations: LocalizedMetadata[];
+}
+export interface LocalizedMetadata {
+    locale: string;
+    name?: string;
+    subtitle?: string;
+    description?: string;
+    keywords?: string;
+    whatsNew?: string;
+    promotionalText?: string;
+    marketingUrl?: string;
+    supportUrl?: string;
+    privacyPolicyUrl?: string;
+}
+export declare class AppStoreConnectClient {
+    private readonly issuerId;
+    private readonly keyId;
+    private readonly privateKey;
+    private readonly baseUrl;
+    constructor(config: AppStoreConnectConfig, configDir: string);
+    private generateToken;
+    private request;
+    listApps(): Promise<App[]>;
+    getAppByBundleId(bundleId: string): Promise<App | null>;
+    getAppMetadata(bundleId: string, fromVersion?: 'live' | 'editable'): Promise<AppMetadata>;
+    getLatestVersion(bundleId: string): Promise<AppStoreVersion | null>;
+    createVersion(bundleId: string, versionString: string, platform?: Platform): Promise<AppStoreVersion>;
+    setMetadata(bundleId: string, localizations: LocalizedMetadata[]): Promise<SetMetadataResult>;
+}
+export interface SetMetadataResult {
+    appInfoLocalizationsUpdated: string[];
+    appInfoLocalizationsCreated: string[];
+    versionLocalizationsUpdated: string[];
+    versionLocalizationsCreated: string[];
+}
+export {};