refactor(ci): standardize workflows and add retry mechanisms and centralized config

.github/browserstack-devices.json

@@ -0,0 +1,127 @@
+{
+  "android-cpp": {
+    "devices": ["Google Pixel 7-13.0"]
+  },
+  "android-java": {
+    "devices": [
+      "Google Pixel 8-14.0",
+      "Samsung Galaxy S23-13.0",
+      "Google Pixel 6-12.0",
+      "OnePlus 9-11.0"
+    ]
+  },
+  "android-kotlin": {
+    "devices": [
+      "Google Pixel 8-14.0",
+      "Samsung Galaxy S23-13.0",
+      "Google Pixel 6-12.0",
+      "OnePlus 9-11.0"
+    ]
+  },
+  "flutter": {
+    "android": {
+      "devices": [
+        "Google Pixel 7-13.0",
+        "Samsung Galaxy S23-13.0",
+        "Google Pixel 6-12.0"
+      ]
+    },
+    "ios": {
+      "devices": [
+        "iPhone 13-15",
+        "iPhone 14-16",
+        "iPhone 12-17"
+      ]
+    }
+  },
+  "kotlin-multiplatform": {
+    "android": {
+      "devices": [
+        "Google Pixel 8-14.0",
+        "Samsung Galaxy S23-13.0"
+      ]
+    }
+  },
+  "react-native": {
+    "android": {
+      "devices": [
+        "Samsung Galaxy S22-12.0",
+        "Google Pixel 7-13.0"
+      ]
+    },
+    "ios": {
+      "devices": [
+        "iPhone 15-17.0",
+        "iPhone 14-16.0"
+      ]
+    }
+  },
+  "react-native-expo": {
+    "android": {
+      "devices": [
+        "Samsung Galaxy S22-12.0",
+        "Google Pixel 7-13.0"
+      ]
+    },
+    "ios": {
+      "devices": [
+        "iPhone 15-17.0",
+        "iPhone 14-16.0"
+      ]
+    }
+  },
+  "dotnet-maui": {
+    "android": {
+      "devices": [
+        "Google Pixel 8-14.0",
+        "Samsung Galaxy S23-13.0"
+      ]
+    },
+    "ios": {
+      "devices": [
+        "iPhone 15-17.0",
+        "iPhone 14-16.0"
+      ]
+    }
+  },
+  "swift": {
+    "devices": ["iPhone 15 Pro-17"]
+  },
+  "java-spring": {
+    "platforms": [
+      {
+        "os": "Windows",
+        "osVersion": "11",
+        "browserName": "Chrome",
+        "browserVersion": "latest"
+      }
+    ]
+  },
+  "javascript-web": {
+    "browsers": [
+      {
+        "browser": "Chrome",
+        "browser_version": "120.0",
+        "os": "Windows",
+        "os_version": "11"
+      },
+      {
+        "browser": "Firefox",
+        "browser_version": "121.0",
+        "os": "Windows",
+        "os_version": "11"
+      }
+    ]
+  },
+  "_metadata": {
+    "description": "Centralized BrowserStack device configuration organized by SDK/app",
+    "last_updated": "2025-10-03",
+    "structure": "Each SDK has its own configuration. Multi-platform SDKs have nested android/ios objects.",
+    "device_format_docs": {
+      "mobile_devices": "https://www.browserstack.com/docs/app-automate/api-reference/appium/devices",
+      "desktop_browsers": "https://www.browserstack.com/docs/automate/api-reference/selenium/list-of-browsers-and-platforms",
+      "format_mobile": "Device Name-OS Version (e.g., 'Google Pixel 7-13.0', 'iPhone 15-17')",
+      "format_desktop": "Separate fields: os, osVersion, browserName, browserVersion"
+    }
+  }
+}

.github/scripts/browserstack-test.py

@@ -64,8 +64,8 @@ def run_test(browser_config):
         "os": browser_config["os"],
         "osVersion": browser_config["os_version"],
         "sessionName": f"Ditto Tasks Test - {browser_config['browser']} {browser_config['browser_version']}",
-        "buildName": f"Ditto JavaScript Web Build #{os.environ.get('GITHUB_RUN_NUMBER', '0')}",
-        "projectName": "Ditto JavaScript Web",
+        "buildName": f"CI Build #{os.environ.get('GITHUB_RUN_NUMBER', '0')}",
+        "projectName": "QuickStart JavaScript Web",
         "local": "true",
         "debug": "true",
         "video": "true",
@@ -125,7 +125,7 @@ def run_test(browser_config):
         time.sleep(3)
 
         # Check for GitHub test document
-        github_doc_id = os.environ.get("GITHUB_TEST_DOC_ID")
+        github_doc_id = os.environ.get("DITTO_CLOUD_TASK_TITLE")
         if github_doc_id:
             print(f"Checking for GitHub test document: {github_doc_id}")
             if wait_for_sync_document(driver, github_doc_id):
@@ -226,21 +226,13 @@ def run_test(browser_config):
 
 def main():
     """Main function to run all browser tests."""
-    # Browser configurations to test
-    browsers = [
-        {
-            "browser": "Chrome",
-            "browser_version": "120.0",
-            "os": "Windows",
-            "os_version": "11",
-        },
-        {
-            "browser": "Firefox",
-            "browser_version": "121.0",
-            "os": "Windows",
-            "os_version": "11",
-        },
-    ]
+    # Load browser configurations from centralized config
+    config_path = os.path.join(
+        os.path.dirname(__file__), "..", "browserstack-devices.json"
+    )
+    with open(config_path, "r") as f:
+        config = json.load(f)
+    browsers = config["javascript-web"]["browsers"]
 
     # Run tests on all browsers
     results = []