SDK-216 BCIT App configured for deep link handling

.github/workflows/bcit-integration-test-deep-linking.yml

@@ -0,0 +1,106 @@
+name: BCIT Deep Linking Integration Test
+permissions:
+  contents: read
+
+on:
+  pull_request:
+    types: [opened, synchronize, reopened, labeled]
+  workflow_dispatch:
+    inputs:
+      ref:
+        description: 'Branch or commit to test (leave empty for current branch)'
+        required: false
+        type: string
+
+jobs:
+  deep-linking-test:
+    name: BCIT Deep Linking Integration Test
+    runs-on: macos-latest
+    timeout-minutes: 30
+    env:
+      XCODE_VERSION: '16.4'
+    if: >
+      github.event_name == 'workflow_dispatch' ||
+      (
+        github.event_name == 'pull_request' && (
+          contains(github.event.pull_request.labels.*.name, 'bcit') ||
+          contains(github.event.pull_request.labels.*.name, 'BCIT') ||
+          contains(github.event.pull_request.labels.*.name, 'bcit-deeplink') ||
+          contains(github.event.pull_request.labels.*.name, 'BCIT-DEEPLINK') ||
+          contains(github.event.pull_request.labels.*.name, 'bcit-deep-linking') ||
+          contains(github.event.pull_request.labels.*.name, 'BCIT-DEEP-LINKING') ||
+          contains(github.event.pull_request.labels.*.name, 'Bcit') ||
+          contains(github.event.pull_request.labels.*.name, 'Bcit-Deeplink') ||
+          startsWith(github.event.pull_request.head.ref, 'release/')
+        )
+      )
+
+    steps:
+    - name: Checkout Repository
+      uses: actions/checkout@v4
+      with:
+        ref: ${{ github.event.inputs.ref || github.ref }}
+
+    - name: Setup Xcode
+      uses: maxim-lobanov/setup-xcode@v1
+      with:
+        xcode-version: ${{ env.XCODE_VERSION }}
+
+    - name: Validate Xcode Version
+      run: |
+        echo "🔍 Validating Xcode version and environment..."
+        echo "DEVELOPER_DIR: $DEVELOPER_DIR"
+        
+        # Check xcodebuild version
+        echo "🔍 Checking xcodebuild version..."
+        ACTUAL_XCODE_VERSION=$(xcodebuild -version | head -n 1 | awk '{print $2}')
+        echo "Xcode version: $ACTUAL_XCODE_VERSION"
+        echo "Expected version: $XCODE_VERSION"
+        
+        # Check xcodebuild path
+        XCODEBUILD_PATH=$(which xcodebuild)
+        echo "xcodebuild path: $XCODEBUILD_PATH"
+        
+        # Verify we're using the correct Xcode version
+        if echo "$ACTUAL_XCODE_VERSION" | grep -q "$XCODE_VERSION"; then
+          echo "✅ Using correct Xcode version: $ACTUAL_XCODE_VERSION"
+        else
+          echo "❌ Incorrect Xcode version!"
+          echo "Current: $ACTUAL_XCODE_VERSION"
+          echo "Expected: $XCODE_VERSION"
+          exit 1
+        fi
+
+    - name: Setup Local Environment
+      working-directory: tests/business-critical-integration
+      run: |
+        echo "🚀 Setting up local environment for integration tests..."
+        
+        # Run setup script with parameters from repository secrets
+        ./scripts/setup-local-environment.sh \
+          "${{ secrets.BCIT_TEST_PROJECT_ID }}" \
+          "${{ secrets.BCIT_ITERABLE_SERVER_KEY }}" \
+          "${{ secrets.BCIT_ITERABLE_API_KEY }}"
+
+    - name: Validate Setup
+      working-directory: tests/business-critical-integration
+      run: |
+        echo "🔍 Validating environment setup..."
+        ./scripts/validate-setup.sh
+
+    - name: Run Deep Linking Tests
+      working-directory: tests/business-critical-integration
+      run: |
+        echo "🧪 Running deep linking integration tests..."
+        CI=true ./scripts/run-tests.sh deeplink
+
+    - name: Upload Test Results
+      if: always()
+      uses: actions/upload-artifact@v4
+      with:
+        name: deep-linking-test-results
+        path: |
+          tests/business-critical-integration/reports/
+          tests/business-critical-integration/screenshots/
+          tests/business-critical-integration/logs/
+        retention-days: 7

tests/business-critical-integration/AGENT_README.md

@@ -155,6 +155,77 @@ CI=1 ./scripts/run-tests.sh
 - Updates JSON configuration automatically with date-prefixed email
 - Maintains backward compatibility with existing test infrastructure
 
+## Deep Link Integration Tests (SDK-292)
+
+### Overview
+Comprehensive deep link routing test infrastructure for validating URL delegate and custom action delegate callbacks.
+
+### What's Tested
+1. **URL Delegate Registration & Callbacks**
+   - Delegate registration during SDK initialization
+   - URL parameter extraction and validation
+   - `tester://` scheme handling for test deep links
+
+2. **Custom Action Delegate Registration & Callbacks**
+   - Delegate registration and method invocation
+   - Custom action type and data parameter validation
+
+3. **Deep Link Integration Flows**
+   - Deep link routing from push notifications
+   - Deep link routing from in-app messages
+   - Deep link routing from embedded messages
+
+4. **Alert-Based Validation**
+   - Alert content validation for deep link callbacks
+   - Expected vs actual URL comparison
+   - Multiple alert sequence handling
+
+### Key Files
+- `DeepLinkingIntegrationTests.swift`: Main test suite with 8 comprehensive test methods
+- `DeepLinkHelpers.swift`: Alert validation, URL extraction, and comparison utilities  
+- `MockDelegates.swift`: Mock URL and custom action delegates with verification helpers
+- `AppDelegate.swift`: Production delegates implementation (lines 334-392)
+- `AppDelegate+IntegrationTest.swift`: Delegate wiring during SDK init (lines 79-80)
+
+### Test Infrastructure
+- **Mock Delegates**: Full verification support with call history tracking
+- **Alert Helpers**: `AlertExpectation` for declarative alert validation
+- **URL Validation**: Component-by-component URL comparison utilities
+- **CI Support**: Uses simulated push notifications for deep link testing
+
+### Running Deep Link Tests
+
+#### Local Testing
+```bash
+./scripts/run-tests.sh deeplink
+```
+
+#### CI Testing  
+```bash
+CI=1 ./scripts/run-tests.sh deeplink
+```
+
+### GitHub Actions Workflow
+- **File**: `.github/workflows/bcit-integration-test-deep-linking.yml`
+- **Triggers**: PR labels (`bcit`, `bcit-deeplink`), workflow_dispatch, release branches
+- **Timeout**: 30 minutes
+- **Artifacts**: Test results, screenshots, logs (7-day retention)
+
+### Current Scope (Pre-Custom Domain)
+- ✅ Delegate registration and callback validation
+- ✅ Alert-based deep link verification  
+- ✅ Integration with push, in-app, and embedded messages
+- ✅ URL parameter and context validation
+- ⏸️ Wrapped link testing (requires custom domains)
+- ⏸️ External source simulation (requires custom domains)
+
+### Future Enhancements
+Once custom domains are configured:
+1. Wrapped universal link testing
+2. External source simulation (Reminders, Notes, Messages)
+3. End-to-end click tracking validation
+4. Cross-platform attribution testing
+
 ## Benefits
 - ✅ Push notification tests run successfully in CI
 - ✅ No changes to existing local testing workflow  
@@ -169,3 +240,5 @@ CI=1 ./scripts/run-tests.sh
 - ✅ **NEW**: Enhanced logging provides comprehensive visibility into push simulation process
 - ✅ **NEW**: Robust file-based communication between iOS test and macOS test runner
 - ✅ **NEW**: Daily test user creation with date-prefixed emails for fresh testing environment
+- ✅ **NEW**: Deep link routing test framework with comprehensive delegate validation
+- ✅ **NEW**: Alert-based verification system for non-domain-dependent deep link testing

tests/business-critical-integration/integration-test-app/IterableSDK-Integration-Tester.xcodeproj/project.pbxproj

@@ -35,13 +35,16 @@
 		8A24D3B12E4508F400B53850 /* PBXFileSystemSynchronizedBuildFileExceptionSet */ = {
 			isa = PBXFileSystemSynchronizedBuildFileExceptionSet;
 			membershipExceptions = (
+				Tests/DeepLinkingIntegrationTests.swift,
 				Tests/EmbeddedMessageIntegrationTests.swift,
 				Tests/InAppMessageIntegrationTests.swift,
 				Tests/IntegrationTestBase.swift,
 				Tests/PushNotificationIntegrationTests.swift,
 				Tests/Utilities/CampaignManager.swift,
+				Tests/Utilities/DeepLinkHelpers.swift,
 				Tests/Utilities/IterableAPIClient.swift,
 				Tests/Utilities/MetricsValidator.swift,
+				Tests/Utilities/MockDelegates.swift,
 				Tests/Utilities/PushNotificationSender.swift,
 				Tests/Utilities/ScreenshotCapture.swift,
 			);
@@ -51,14 +54,17 @@
 			isa = PBXFileSystemSynchronizedBuildFileExceptionSet;
 			membershipExceptions = (
 				SupportingFiles/Info.plist,
+				Tests/DeepLinkingIntegrationTests.swift,
 				Tests/EmbeddedMessageIntegrationTests.swift,
 				Tests/InAppMessageIntegrationTests.swift,
 				Tests/Incomplete/DeepLinkingIntegrationTests.swift,
 				Tests/IntegrationTestBase.swift,
 				Tests/PushNotificationIntegrationTests.swift,
 				Tests/Utilities/CampaignManager.swift,
+				Tests/Utilities/DeepLinkHelpers.swift,
 				Tests/Utilities/IterableAPIClient.swift,
 				Tests/Utilities/MetricsValidator.swift,
+				Tests/Utilities/MockDelegates.swift,
 				Tests/Utilities/PushNotificationSender.swift,
 				Tests/Utilities/ScreenshotCapture.swift,
 			);
@@ -87,6 +93,8 @@
 			isa = PBXFrameworksBuildPhase;
 			buildActionMask = 2147483647;
 			files = (
+				8A24D33A2E44F30600B53850 /* IterableAppExtensions in Frameworks */,
+				8A24D33C2E44F30600B53850 /* IterableSDK in Frameworks */,
 			);
 			runOnlyForDeploymentPostprocessing = 0;
 		};
@@ -167,6 +175,8 @@
 			);
 			name = "IterableSDK-Integration-TesterUITests";
 			packageProductDependencies = (
+				8A24D3392E44F30600B53850 /* IterableAppExtensions */,
+				8A24D33B2E44F30600B53850 /* IterableSDK */,
 			);
 			productName = "IterableSDK-Integration-TesterUITests";
 			productReference = 8AB716322E3119A3004AAB74 /* IterableSDK-Integration-TesterUITests.xctest */;

tests/business-critical-integration/integration-test-app/IterableSDK-Integration-Tester/App/AppDelegate.swift

@@ -86,10 +86,24 @@ class AppDelegate: UIResponder, UIApplicationDelegate {
         IterableAppIntegration.application(application, didReceiveRemoteNotification: userInfo, fetchCompletionHandler: completionHandler)
     }
 
-    // MARK: - Deep link
+    // MARK: - Deep link (Universal Links)
 
     func application(_ application: UIApplication, continue userActivity: NSUserActivity, restorationHandler: @escaping ([UIUserActivityRestoring]?) -> Void) -> Bool {
-        return true // No deep link handling in this test app
+        print("🔗 [APP] Universal link received via NSUserActivity")
+        print("🔗 [APP] Activity type: \(userActivity.activityType)")
+
+        // Handle universal links (e.g., from Reminders, Notes, Safari, etc.)
+        if userActivity.activityType == NSUserActivityTypeBrowsingWeb,
+           let url = userActivity.webpageURL {
+            print("🔗 [APP] Universal link URL: \(url.absoluteString)")
+
+            // Pass to Iterable SDK for unwrapping and handling
+            // The SDK will unwrap /a/ links and call the URL delegate with the destination URL
+            IterableAPI.handle(universalLink: url)
+            return true
+        }
+
+        return false
     }
 
     func application(_ app: UIApplication, open url: URL, options: [UIApplication.OpenURLOptionsKey : Any] = [:]) -> Bool {
@@ -336,12 +350,13 @@ extension AppDelegate: IterableURLDelegate {
     func handle(iterableURL url: URL, inContext context: IterableActionContext) -> Bool {
         print("🔗 BREAKPOINT HERE: IterableURLDelegate.handle called!")
         print("🔗 URL: \(url.absoluteString)")
-        print("🔗 Context: \(context)")
+        print("🔗 Context source: \(context.source)")
 
         // Set a breakpoint on the next line to see if this method gets called
         let urlScheme = url.scheme ?? "no-scheme"
         print("🔗 URL scheme: \(urlScheme)")
 
+        // Handle tester:// deep links (unwrapped destination URLs)
         if url.scheme == "tester" {
             print("✅ App is opened via Iterable deep link - tester://")
 
@@ -369,6 +384,23 @@ extension AppDelegate: IterableURLDelegate {
             return true // We handled this URL
         }
 
+        // Handle https:// links (could be unwrapped universal links)
+        if url.scheme == "https" {
+            print("🌐 HTTPS URL received in URL delegate: \(url.absoluteString)")
+
+            // Check if this is from our tracking domain (shouldn't happen if SDK unwrapped correctly)
+            if url.host == "links.tsetester.com" {
+                print("⚠️ Received wrapped tracking URL - SDK may not have unwrapped it")
+            }
+
+            // Show alert for HTTPS deep links
+            DispatchQueue.main.async {
+                self.showDeepLinkAlert(url: url)
+            }
+
+            return true
+        }
+
         print("🔗 URL scheme '\(url.scheme ?? "nil")' not handled by our app")
         return false // We didn't handle this URL
     }

tests/business-critical-integration/integration-test-app/IterableSDK-Integration-Tester/SupportingFiles/iterablesdk-integration-tester.entitlements

@@ -6,8 +6,7 @@
 	<string>development</string>
 	<key>com.apple.developer.associated-domains</key>
 	<array>
-		<string>applinks:example.com</string>
-		<string>applinks:links.example.com</string>
+		<string>applinks:links.tsetester.com</string>
 	</array>
 </dict>
 </plist>