@daemux/store-automator 0.10.37 → 0.10.39

package/.claude-plugin/marketplace.json

@@ -5,15 +5,20 @@
   },
   "metadata": {
     "description": "App Store & Google Play automation for Flutter apps",
-    "version": "0.10.37"
+    "version": "0.10.39"
   },
   "plugins": [
     {
       "name": "store-automator",
       "source": "./plugins/store-automator",
       "description": "3 agents for app store publishing: reviewer, meta-creator, media-designer",
-      "version": "0.10.37",
-      "keywords": ["flutter", "app-store", "google-play", "fastlane"]
+      "version": "0.10.39",
+      "keywords": [
+        "flutter",
+        "app-store",
+        "google-play",
+        "fastlane"
+      ]
     }
   ]
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@daemux/store-automator",
-  "version": "0.10.37",
+  "version": "0.10.39",
   "description": "Full App Store & Google Play automation for Flutter apps with Claude Code agents",
   "type": "module",
   "bin": {

package/plugins/store-automator/.claude-plugin/plugin.json

@@ -1,9 +1,16 @@
 {
   "name": "store-automator",
-  "version": "0.10.3",
+  "version": "0.10.39",
   "description": "App Store & Google Play automation agents for Flutter app publishing",
   "author": {
     "name": "Daemux"
   },
-  "keywords": ["flutter", "app-store", "google-play", "fastlane", "screenshots", "metadata"]
+  "keywords": [
+    "flutter",
+    "app-store",
+    "google-play",
+    "fastlane",
+    "screenshots",
+    "metadata"
+  ]
 }

package/plugins/store-automator/agents/appstore-meta-creator.md

@@ -43,11 +43,11 @@ You are a senior ASO (App Store Optimization) specialist and localization expert
 | full_description.txt | 4000 chars | Keyword-rich naturally, first 250 chars most important, no keyword stuffing |
 | changelogs/default.txt | 500 chars | What is new in this version |
 
-### Shared (fastlane/metadata/ios/)
+### Shared (fastlane/metadata/)
 
 | File | Content |
 |------|---------|
-| copyright.txt | "Copyright {YEAR} {COMPANY_NAME}" |
+| copyright.txt | "Copyright {YEAR} {COMPANY_NAME}" — placed at metadata root, NOT inside locale dirs |
 
 ### Age Rating Config (fastlane/app_rating_config.json)
 
@@ -241,6 +241,7 @@ fastlane/
   app_rating_config.json
   data_safety.csv
   metadata/
+    copyright.txt
     review_information/
       first_name.txt
       last_name.txt
@@ -250,7 +251,6 @@ fastlane/
       demo_password.txt
       notes.txt
     ios/
-      copyright.txt
       en-US/
         name.txt
         subtitle.txt

package/templates/CLAUDE.md.template

@@ -58,6 +58,11 @@ IAP and subscription configuration. Durations: ONE_WEEK to ONE_YEAR. Intro offer
 ### fastlane/screenshots/
 Store screenshots by platform and device size. Generated by app-designer via Stitch MCP.
 
+### App Privacy (Manual Step)
+App Privacy declarations must be set manually by an Admin in the App Store Connect web interface.
+This is a one-time setup per app (not per release). Go to App Store Connect > Your App > App Privacy.
+Apple requires this before the first submission. It cannot be automated via API or fastlane.
+
 ### App Icon Setup
 The app icon must be set before the first release. Flutter creates projects with a default icon that MUST be replaced.
 

package/templates/ci.config.yaml.template

@@ -31,6 +31,7 @@ ios:
   price_tier: 0
   submit_for_review: true
   automatic_release: true
+  content_rights_third_party: false  # true if app uses third-party content requiring rights
 
 # === ANDROID SETTINGS ===
 android:

package/templates/github/workflows/ios-release.yml

@@ -52,6 +52,9 @@ jobs:
         id: sync-iap
         run: scripts/ci/ios/sync-iap.sh
 
+      - name: Setup App Info
+        run: scripts/ci/ios/setup-app-info.sh
+
       - name: Save .ci-state
         if: success()
         uses: actions/cache/save@v4

package/templates/scripts/asc_app_setup.py

@@ -0,0 +1,277 @@
+#!/usr/bin/env python3
+"""
+App Store Connect app setup: content rights and pricing.
+
+Sets the content rights declaration and configures free (or paid) pricing
+via the App Store Connect API.
+
+Required env vars:
+  APP_STORE_CONNECT_KEY_IDENTIFIER  - Key ID from App Store Connect
+  APP_STORE_CONNECT_ISSUER_ID       - Issuer ID from App Store Connect
+  APP_STORE_CONNECT_PRIVATE_KEY     - Contents of the P8 key file
+  BUNDLE_ID                         - App bundle identifier
+
+Optional env vars:
+  PRICE_TIER                        - Price tier (default: "0" for free)
+  CONTENT_RIGHTS_THIRD_PARTY        - "true" if app uses third-party content (default: "false")
+
+Exit codes:
+  0 - Setup completed successfully
+  1 - Any failure (missing env vars, API error, etc.)
+"""
+import os
+import sys
+import time
+
+try:
+    import jwt
+    import requests
+except ImportError:
+    import subprocess
+    subprocess.check_call(
+        [sys.executable, "-m", "pip", "install", "--break-system-packages", "PyJWT", "cryptography", "requests"],
+        stdout=subprocess.DEVNULL,
+    )
+    import jwt
+    import requests
+
+BASE_URL = "https://api.appstoreconnect.apple.com/v1"
+TIMEOUT = (10, 30)
+
+
+def get_jwt_token(key_id: str, issuer_id: str, private_key: str) -> str:
+    """Generate a signed JWT for App Store Connect API authentication."""
+    now = int(time.time())
+    payload = {
+        "iss": issuer_id,
+        "iat": now,
+        "exp": now + 1200,
+        "aud": "appstoreconnect-v1",
+    }
+    return jwt.encode(payload, private_key, algorithm="ES256", headers={"kid": key_id})
+
+
+def get_app_id(headers: dict, bundle_id: str) -> str:
+    """Look up the App Store Connect app ID for the given bundle identifier."""
+    resp = requests.get(
+        f"{BASE_URL}/apps",
+        params={"filter[bundleId]": bundle_id},
+        headers=headers,
+        timeout=TIMEOUT,
+    )
+    resp.raise_for_status()
+    data = resp.json().get("data", [])
+    if not data:
+        print(f"ERROR: No app found for bundle ID '{bundle_id}'", file=sys.stderr)
+        sys.exit(1)
+    return data[0]["id"]
+
+
+def print_api_errors(resp, action: str) -> None:
+    """Print human-readable API error messages."""
+    try:
+        errors = resp.json().get("errors", [])
+        for err in errors:
+            detail = err.get("detail", err.get("title", "Unknown error"))
+            print(f"ERROR ({action}): {detail}", file=sys.stderr)
+    except (ValueError, KeyError):
+        print(f"ERROR ({action}): HTTP {resp.status_code} - {resp.text[:200]}", file=sys.stderr)
+
+
+def set_content_rights(headers: dict, app_id: str, uses_third_party: bool) -> None:
+    """Set the content rights declaration on the app."""
+    desired = "USES_THIRD_PARTY_CONTENT" if uses_third_party else "DOES_NOT_USE_THIRD_PARTY_CONTENT"
+
+    resp = requests.get(f"{BASE_URL}/apps/{app_id}", headers=headers, timeout=TIMEOUT)
+    resp.raise_for_status()
+    current = resp.json()["data"]["attributes"].get("contentRightsDeclaration")
+
+    if current == desired:
+        print(f"  Content rights already set to '{desired}', skipping.")
+        return
+
+    patch_resp = requests.patch(
+        f"{BASE_URL}/apps/{app_id}",
+        json={
+            "data": {
+                "type": "apps",
+                "id": app_id,
+                "attributes": {"contentRightsDeclaration": desired},
+            }
+        },
+        headers=headers,
+        timeout=TIMEOUT,
+    )
+    if not patch_resp.ok:
+        print_api_errors(patch_resp, "set content rights")
+        sys.exit(1)
+    print(f"  Content rights set to '{desired}'.")
+
+
+def get_app_price_points(headers: dict, app_id: str, territory: str = "USA") -> list:
+    """Fetch all price points for the app in the given territory, with pagination."""
+    url = f"{BASE_URL}/apps/{app_id}/appPricePoints"
+    params = {"filter[territory]": territory, "limit": 200}
+    all_points = []
+
+    while url:
+        resp = requests.get(url, params=params, headers=headers, timeout=TIMEOUT)
+        resp.raise_for_status()
+        body = resp.json()
+        all_points.extend(body.get("data", []))
+        url = body.get("links", {}).get("next")
+        params = None
+
+    return all_points
+
+
+def find_price_point_for_tier(price_points: list, tier: int = 0) -> str:
+    """Find the price point ID matching the given tier. Tier 0 = free."""
+    if tier == 0:
+        for pp in price_points:
+            price = pp.get("attributes", {}).get("customerPrice", "")
+            if price in ("0", "0.0", "0.00"):
+                return pp["id"]
+        print("ERROR: Could not find a free (tier 0) price point.", file=sys.stderr)
+        sys.exit(1)
+
+    for pp in price_points:
+        price = pp.get("attributes", {}).get("customerPrice", "")
+        try:
+            if float(price) > 0 and pp.get("attributes", {}).get("priceTier") == str(tier):
+                return pp["id"]
+        except (ValueError, TypeError):
+            continue
+    print(f"ERROR: Could not find price point for tier {tier}.", file=sys.stderr)
+    sys.exit(1)
+
+
+def _is_pricing_set(headers: dict, app_id: str, price_tier: int) -> bool:
+    """Check if the app already has pricing set for the given tier."""
+    schedule_resp = requests.get(
+        f"{BASE_URL}/apps/{app_id}/appPriceSchedule",
+        params={"include": "manualPrices,baseTerritory"},
+        headers=headers,
+        timeout=TIMEOUT,
+    )
+    if not schedule_resp.ok:
+        return False
+
+    included = schedule_resp.json().get("included", [])
+    for item in included:
+        if item.get("type") == "appPrices":
+            existing_price = item.get("attributes", {}).get("customerPrice", "")
+            if price_tier == 0 and existing_price in ("0", "0.0", "0.00"):
+                return True
+    return False
+
+
+def _create_price_schedule(headers: dict, app_id: str, price_point_id: str) -> requests.Response:
+    """POST a new app price schedule and return the response."""
+    price_ref_id = "${price-usa}"
+    return requests.post(
+        f"{BASE_URL}/appPriceSchedules",
+        json={
+            "data": {
+                "type": "appPriceSchedules",
+                "relationships": {
+                    "app": {"data": {"type": "apps", "id": app_id}},
+                    "baseTerritory": {"data": {"type": "territories", "id": "USA"}},
+                    "manualPrices": {"data": [{"type": "appPrices", "id": price_ref_id}]},
+                },
+            },
+            "included": [
+                {
+                    "type": "appPrices",
+                    "id": price_ref_id,
+                    "attributes": {"startDate": None},
+                    "relationships": {
+                        "appPricePoint": {
+                            "data": {"type": "appPricePoints", "id": price_point_id}
+                        }
+                    },
+                }
+            ],
+        },
+        headers=headers,
+        timeout=TIMEOUT,
+    )
+
+
+def set_app_pricing(headers: dict, app_id: str, price_tier: int = 0) -> None:
+    """Set the app price schedule. Handles idempotency via pre-check and 409 Conflict."""
+    if _is_pricing_set(headers, app_id, price_tier):
+        print("  Pricing already set to free, skipping.")
+        return
+
+    print(f"  Fetching price points for USA territory...")
+    price_points = get_app_price_points(headers, app_id, territory="USA")
+    if not price_points:
+        print("ERROR: No price points returned for USA territory.", file=sys.stderr)
+        sys.exit(1)
+
+    pp_id = find_price_point_for_tier(price_points, tier=price_tier)
+    print(f"  Found price point ID: {pp_id}")
+
+    post_resp = _create_price_schedule(headers, app_id, pp_id)
+    tier_label = "Free" if price_tier == 0 else f"Tier {price_tier}"
+
+    if post_resp.status_code == 409:
+        print(f"  Pricing already set ({tier_label}), skipping (409 Conflict).")
+        return
+    if not post_resp.ok:
+        print_api_errors(post_resp, "set app pricing")
+        sys.exit(1)
+    print(f"  Pricing set to {tier_label}.")
+
+
+def main() -> None:
+    key_id = os.environ.get("APP_STORE_CONNECT_KEY_IDENTIFIER", "")
+    issuer_id = os.environ.get("APP_STORE_CONNECT_ISSUER_ID", "")
+    private_key = os.environ.get("APP_STORE_CONNECT_PRIVATE_KEY", "")
+    bundle_id = os.environ.get("BUNDLE_ID", "")
+    price_tier_str = os.environ.get("PRICE_TIER", "0")
+    third_party_str = os.environ.get("CONTENT_RIGHTS_THIRD_PARTY", "false")
+
+    missing = []
+    if not key_id:
+        missing.append("APP_STORE_CONNECT_KEY_IDENTIFIER")
+    if not issuer_id:
+        missing.append("APP_STORE_CONNECT_ISSUER_ID")
+    if not private_key:
+        missing.append("APP_STORE_CONNECT_PRIVATE_KEY")
+    if not bundle_id:
+        missing.append("BUNDLE_ID")
+    if missing:
+        print(f"ERROR: Missing required environment variables: {', '.join(missing)}", file=sys.stderr)
+        sys.exit(1)
+
+    try:
+        price_tier = int(price_tier_str)
+    except ValueError:
+        print(f"ERROR: PRICE_TIER must be an integer, got '{price_tier_str}'", file=sys.stderr)
+        sys.exit(1)
+
+    uses_third_party = third_party_str.lower() == "true"
+
+    token = get_jwt_token(key_id, issuer_id, private_key)
+    headers = {
+        "Authorization": f"Bearer {token}",
+        "Content-Type": "application/json",
+    }
+
+    print(f"Looking up app for bundle ID '{bundle_id}'...")
+    app_id = get_app_id(headers, bundle_id)
+    print(f"Found app ID: {app_id}")
+
+    print("Setting content rights declaration...")
+    set_content_rights(headers, app_id, uses_third_party)
+
+    print("Setting app pricing...")
+    set_app_pricing(headers, app_id, price_tier)
+
+    print("App setup complete.")
+
+
+if __name__ == "__main__":
+    main()

package/templates/scripts/ci/common/read-config.sh

@@ -53,6 +53,9 @@ export PRICE_TIER=$(yq '.ios.price_tier // ""' "$CONFIG")
 export SUBMIT_FOR_REVIEW=$(yq '.ios.submit_for_review // "false"' "$CONFIG")
 export AUTOMATIC_RELEASE=$(yq '.ios.automatic_release // "false"' "$CONFIG")
 
+# App Info settings
+export CONTENT_RIGHTS_THIRD_PARTY=$(yq '.ios.content_rights_third_party // "false"' "$CONFIG")
+
 # Android Play Store settings
 export TRACK=$(yq '.android.track // "internal"' "$CONFIG")
 export ROLLOUT_FRACTION=$(yq '.android.rollout_fraction // ""' "$CONFIG")

package/templates/scripts/ci/ios/setup-app-info.sh

@@ -0,0 +1,43 @@
+#!/usr/bin/env bash
+# Sets up App Store Connect app info (content rights, age rating, categories) via ASC API.
+# Requires read-config.sh to have been sourced (provides PROJECT_ROOT, credentials, etc.).
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+source "$SCRIPT_DIR/../common/read-config.sh"
+source "$SCRIPT_DIR/../common/ci-notify.sh"
+
+echo "=== App Store Connect App Info Setup ==="
+
+# --- Validate ASC credentials ---
+if [ -z "${APPLE_KEY_ID:-}" ] || [ -z "${APPLE_ISSUER_ID:-}" ]; then
+  ci_skip "ASC credentials not configured"
+fi
+
+# --- Set up App Store Connect API credentials ---
+P8_FULL_PATH="$PROJECT_ROOT/$P8_KEY_PATH"
+if [ ! -f "$P8_FULL_PATH" ]; then
+  echo "ERROR: P8 key file not found at $P8_FULL_PATH" >&2
+  exit 1
+fi
+
+export APP_STORE_CONNECT_KEY_IDENTIFIER="$APPLE_KEY_ID"
+export APP_STORE_CONNECT_ISSUER_ID="$APPLE_ISSUER_ID"
+export APP_STORE_CONNECT_PRIVATE_KEY="$(cat "$P8_FULL_PATH")"
+export BUNDLE_ID="$BUNDLE_ID"
+export PROJECT_ROOT="$PROJECT_ROOT"
+
+echo "ASC API key configured (Key ID: $APPLE_KEY_ID)"
+
+# --- Run app setup via Python ---
+SETUP_SCRIPT="$PROJECT_ROOT/scripts/asc_app_setup.py"
+
+if [ ! -f "$SETUP_SCRIPT" ]; then
+  echo "ERROR: asc_app_setup.py not found at $SETUP_SCRIPT" >&2
+  exit 1
+fi
+
+echo "Setting up App Store Connect app info..."
+python3 "$SETUP_SCRIPT"
+
+ci_done "App Store Connect app info configured"