ci: add appium E2E infrastructure with smoke test

Add shared Appium testing setup for OneSignal SDK wrappers:
- WebDriverIO configs for iOS/Android (local + BrowserStack)
- Test helpers for app interaction, logging, and selectors
- GitHub Actions composite action for CI integration
- Smoke test placeholder to validate the pipeline

Made-with: Cursor

Author: fadi-george

.github/actions/appium-e2e/action.yml

@@ -0,0 +1,100 @@
+name: 'Appium E2E Tests'
+description: 'Run Appium E2E tests on BrowserStack App Automate'
+
+inputs:
+  platform:
+    description: 'Target platform: android or ios'
+    required: true
+  app-path:
+    description: 'Path to built APK or .app/.ipa bundle'
+    required: true
+  sdk-type:
+    description: 'SDK type: react-native, flutter, capacitor, ios-native, or android-native'
+    required: true
+  browserstack-username:
+    description: 'BrowserStack username'
+    required: true
+  browserstack-access-key:
+    description: 'BrowserStack access key'
+    required: true
+  device:
+    description: 'BrowserStack device name'
+    required: false
+  os-version:
+    description: 'Device OS version'
+    required: false
+  test-spec:
+    description: 'Glob for which specs to run'
+    required: false
+    default: 'tests/specs/**/*.spec.ts'
+  onesignal-app-id:
+    description: 'OneSignal App ID dedicated to E2E tests'
+    required: false
+  onesignal-api-key:
+    description: 'OneSignal API key dedicated to E2E tests'
+    required: false
+  build-name:
+    description: 'Label for the BrowserStack session'
+    required: false
+
+runs:
+  using: 'composite'
+  steps:
+    - name: Checkout sdk-shared (for test files)
+      uses: actions/checkout@v4
+      with:
+        repository: OneSignal/sdk-shared
+        path: _sdk-shared
+
+    - name: Setup Node.js
+      uses: actions/setup-node@v4
+      with:
+        node-version: '20'
+
+    - name: Upload app to BrowserStack
+      id: bs-upload
+      shell: bash
+      env:
+        BROWSERSTACK_USERNAME: ${{ inputs.browserstack-username }}
+        BROWSERSTACK_ACCESS_KEY: ${{ inputs.browserstack-access-key }}
+      run: |
+        RESPONSE=$(curl -s -u "$BROWSERSTACK_USERNAME:$BROWSERSTACK_ACCESS_KEY" \
+          -X POST "https://api-cloud.browserstack.com/app-automate/upload" \
+          -F "file=@${{ inputs.app-path }}")
+        APP_URL=$(echo "$RESPONSE" | jq -r '.app_url')
+        if [ "$APP_URL" = "null" ] || [ -z "$APP_URL" ]; then
+          echo "::error::Failed to upload app to BrowserStack: $RESPONSE"
+          exit 1
+        fi
+        echo "app-url=$APP_URL" >> "$GITHUB_OUTPUT"
+        echo "Uploaded app to BrowserStack: $APP_URL"
+
+    - name: Install test dependencies
+      shell: bash
+      working-directory: _sdk-shared/appium
+      run: npm ci
+
+    - name: Run Appium tests
+      shell: bash
+      working-directory: _sdk-shared/appium
+      env:
+        BROWSERSTACK_USERNAME: ${{ inputs.browserstack-username }}
+        BROWSERSTACK_ACCESS_KEY: ${{ inputs.browserstack-access-key }}
+        BROWSERSTACK_APP_URL: ${{ steps.bs-upload.outputs.app-url }}
+        SDK_TYPE: ${{ inputs.sdk-type }}
+        DEVICE: ${{ inputs.device }}
+        OS_VERSION: ${{ inputs.os-version }}
+        BUILD_NAME: ${{ inputs.build-name }}
+        ONESIGNAL_APP_ID: ${{ inputs.onesignal-app-id }}
+        ONESIGNAL_API_KEY: ${{ inputs.onesignal-api-key }}
+      run: |
+        npx wdio run wdio.${{ inputs.platform }}.conf.ts \
+          --spec '${{ inputs.test-spec }}'
+
+    - name: Upload test results
+      if: always()
+      uses: actions/upload-artifact@v4
+      with:
+        name: appium-results-${{ inputs.platform }}-${{ inputs.sdk-type }}
+        path: _sdk-shared/appium/results/
+        if-no-files-found: ignore

appium/.gitignore

@@ -0,0 +1,3 @@
+node_modules/
+dist/
+results/