WIP: Phase 2 - Remove bridging code and add Swift implementations

Work in progress on removing legacy Objective-C bridging code and adding modern Swift implementations to the 4.0.0-alpha.0 branch.

Changes:
- Added Swift implementations from PR #1533:
  - BranchRequestQueue.swift (Actor-based queue with Swift Concurrency)
  - BranchRequestOperation.swift (Modern operation implementation)
  - ConfigurationController.swift (Configuration management)

- Updated Package.swift:
  - Upgraded swift-tools-version to 5.9
  - Added BranchSwiftSDK target
  - Updated paths and dependencies

- Removed bridging files:
  - Deleted BNCServerRequestQueue.m and BNCServerRequestQueue.h
  - Removed 16 references from Xcode project

- Updated Branch.m:
  - Removed import of BNCServerRequestQueue.h
  - Commented out legacy error handling code that used remove: and peekAt: methods
    (These methods are incompatible with NSOperationQueue implementation)

- Updated Branch.h:
  - Removed import of BNCServerRequestQueue.h
  - Added forward declarations for BNCServerRequestQueue and BNCServerRequest

STATUS: Build currently failing with compilation errors. Additional work needed to:
1. Fix remaining compilation errors in dependent files
2. Implement proper error handling for NSOperationQueue-based request queue
3. Test framework and app builds
4. Complete migration to Swift implementations

This is part of the broader effort to modernize the iOS Branch SDK with Swift Concurrency patterns (async/await, actors) while maintaining backward compatibility.

Author: wpinho-branch

BranchSDK.xcodeproj/project.pbxproj

@@ -99,9 +99,6 @@
 		5FCDD4142B7AC6A100EAF29F /* NSMutableDictionary+Branch.m in Sources */ = {isa = PBXBuildFile; fileRef = 5FCDD3732B7AC6A100EAF29F /* NSMutableDictionary+Branch.m */; };
 		5FCDD4152B7AC6A100EAF29F /* NSMutableDictionary+Branch.m in Sources */ = {isa = PBXBuildFile; fileRef = 5FCDD3732B7AC6A100EAF29F /* NSMutableDictionary+Branch.m */; };
 		5FCDD4162B7AC6A100EAF29F /* NSMutableDictionary+Branch.m in Sources */ = {isa = PBXBuildFile; fileRef = 5FCDD3732B7AC6A100EAF29F /* NSMutableDictionary+Branch.m */; };
-		5FCDD4172B7AC6A100EAF29F /* BNCServerRequestQueue.m in Sources */ = {isa = PBXBuildFile; fileRef = 5FCDD3742B7AC6A100EAF29F /* BNCServerRequestQueue.m */; };
-		5FCDD4182B7AC6A100EAF29F /* BNCServerRequestQueue.m in Sources */ = {isa = PBXBuildFile; fileRef = 5FCDD3742B7AC6A100EAF29F /* BNCServerRequestQueue.m */; };
-		5FCDD4192B7AC6A100EAF29F /* BNCServerRequestQueue.m in Sources */ = {isa = PBXBuildFile; fileRef = 5FCDD3742B7AC6A100EAF29F /* BNCServerRequestQueue.m */; };
 		5FCDD41A2B7AC6A100EAF29F /* BNCUrlQueryParameter.m in Sources */ = {isa = PBXBuildFile; fileRef = 5FCDD3752B7AC6A100EAF29F /* BNCUrlQueryParameter.m */; };
 		5FCDD41B2B7AC6A100EAF29F /* BNCUrlQueryParameter.m in Sources */ = {isa = PBXBuildFile; fileRef = 5FCDD3752B7AC6A100EAF29F /* BNCUrlQueryParameter.m */; };
 		5FCDD41C2B7AC6A100EAF29F /* BNCUrlQueryParameter.m in Sources */ = {isa = PBXBuildFile; fileRef = 5FCDD3752B7AC6A100EAF29F /* BNCUrlQueryParameter.m */; };
@@ -245,9 +242,6 @@
 		5FCDD4B32B7AC6A200EAF29F /* BNCNetworkServiceProtocol.h in Headers */ = {isa = PBXBuildFile; fileRef = 5FCDD3A92B7AC6A100EAF29F /* BNCNetworkServiceProtocol.h */; settings = {ATTRIBUTES = (Public, ); }; };
 		5FCDD4B42B7AC6A200EAF29F /* BNCNetworkServiceProtocol.h in Headers */ = {isa = PBXBuildFile; fileRef = 5FCDD3A92B7AC6A100EAF29F /* BNCNetworkServiceProtocol.h */; settings = {ATTRIBUTES = (Public, ); }; };
 		5FCDD4B52B7AC6A200EAF29F /* BNCNetworkServiceProtocol.h in Headers */ = {isa = PBXBuildFile; fileRef = 5FCDD3A92B7AC6A100EAF29F /* BNCNetworkServiceProtocol.h */; settings = {ATTRIBUTES = (Public, ); }; };
-		5FCDD4B62B7AC6A200EAF29F /* BNCServerRequestQueue.h in Headers */ = {isa = PBXBuildFile; fileRef = 5FCDD3AA2B7AC6A100EAF29F /* BNCServerRequestQueue.h */; settings = {ATTRIBUTES = (Public, ); }; };
-		5FCDD4B72B7AC6A200EAF29F /* BNCServerRequestQueue.h in Headers */ = {isa = PBXBuildFile; fileRef = 5FCDD3AA2B7AC6A100EAF29F /* BNCServerRequestQueue.h */; settings = {ATTRIBUTES = (Public, ); }; };
-		5FCDD4B82B7AC6A200EAF29F /* BNCServerRequestQueue.h in Headers */ = {isa = PBXBuildFile; fileRef = 5FCDD3AA2B7AC6A100EAF29F /* BNCServerRequestQueue.h */; settings = {ATTRIBUTES = (Public, ); }; };
 		5FCDD4B92B7AC6A200EAF29F /* BranchPasteControl.h in Headers */ = {isa = PBXBuildFile; fileRef = 5FCDD3AB2B7AC6A100EAF29F /* BranchPasteControl.h */; settings = {ATTRIBUTES = (Public, ); }; };
 		5FCDD4BA2B7AC6A200EAF29F /* BranchPasteControl.h in Headers */ = {isa = PBXBuildFile; fileRef = 5FCDD3AB2B7AC6A100EAF29F /* BranchPasteControl.h */; settings = {ATTRIBUTES = (Public, ); }; };
 		5FCDD4BB2B7AC6A200EAF29F /* BranchPasteControl.h in Headers */ = {isa = PBXBuildFile; fileRef = 5FCDD3AB2B7AC6A100EAF29F /* BranchPasteControl.h */; settings = {ATTRIBUTES = (Public, ); }; };
@@ -584,7 +578,6 @@
 		5FCDD3712B7AC6A100EAF29F /* BNCApplication.m */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.objc; path = BNCApplication.m; sourceTree = "<group>"; };
 		5FCDD3722B7AC6A100EAF29F /* BNCDeviceSystem.m */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.objc; path = BNCDeviceSystem.m; sourceTree = "<group>"; };
 		5FCDD3732B7AC6A100EAF29F /* NSMutableDictionary+Branch.m */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.objc; path = "NSMutableDictionary+Branch.m"; sourceTree = "<group>"; };
-		5FCDD3742B7AC6A100EAF29F /* BNCServerRequestQueue.m */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.objc; path = BNCServerRequestQueue.m; sourceTree = "<group>"; };
 		5FCDD3752B7AC6A100EAF29F /* BNCUrlQueryParameter.m */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.objc; path = BNCUrlQueryParameter.m; sourceTree = "<group>"; };
 		5FCDD3762B7AC6A100EAF29F /* BNCDeepLinkViewControllerInstance.m */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.objc; path = BNCDeepLinkViewControllerInstance.m; sourceTree = "<group>"; };
 		5FCDD3772B7AC6A100EAF29F /* BranchScene.m */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.objc; path = BranchScene.m; sourceTree = "<group>"; };
@@ -635,7 +628,6 @@
 		5FCDD3A72B7AC6A100EAF29F /* BNCInitSessionResponse.h */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.h; path = BNCInitSessionResponse.h; sourceTree = "<group>"; };
 		5FCDD3A82B7AC6A100EAF29F /* BranchEvent.h */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.h; path = BranchEvent.h; sourceTree = "<group>"; };
 		5FCDD3A92B7AC6A100EAF29F /* BNCNetworkServiceProtocol.h */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.h; path = BNCNetworkServiceProtocol.h; sourceTree = "<group>"; };
-		5FCDD3AA2B7AC6A100EAF29F /* BNCServerRequestQueue.h */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.h; path = BNCServerRequestQueue.h; sourceTree = "<group>"; };
 		5FCDD3AB2B7AC6A100EAF29F /* BranchPasteControl.h */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.h; path = BranchPasteControl.h; sourceTree = "<group>"; };
 		5FCDD3AC2B7AC6A100EAF29F /* BranchUniversalObject.h */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.h; path = BranchUniversalObject.h; sourceTree = "<group>"; };
 		5FCDD3AD2B7AC6A100EAF29F /* BNCServerRequest.h */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.h; path = BNCServerRequest.h; sourceTree = "<group>"; };
@@ -873,7 +865,6 @@
 				5FCDD3F32B7AC6A100EAF29F /* BNCServerAPI.m */,
 				5FCDD3902B7AC6A100EAF29F /* BNCServerInterface.m */,
 				5FCDD3802B7AC6A100EAF29F /* BNCServerRequest.m */,
-				5FCDD3742B7AC6A100EAF29F /* BNCServerRequestQueue.m */,
 				5FCDD3F72B7AC6A100EAF29F /* BNCServerResponse.m */,
 				5FCDD3EB2B7AC6A100EAF29F /* BNCSKAdNetwork.m */,
 				5FCDD3F22B7AC6A100EAF29F /* BNCSpotlightService.m */,
@@ -933,7 +924,6 @@
 				5FCDD3B32B7AC6A100EAF29F /* BNCProductCategory.h */,
 				5FCDD3B22B7AC6A100EAF29F /* BNCServerInterface.h */,
 				5FCDD3AD2B7AC6A100EAF29F /* BNCServerRequest.h */,
-				5FCDD3AA2B7AC6A100EAF29F /* BNCServerRequestQueue.h */,
 				5FCDD3A32B7AC6A100EAF29F /* BNCServerResponse.h */,
 				5FCDD3A22B7AC6A100EAF29F /* Branch.h */,
 				5FCDD39C2B7AC6A100EAF29F /* BranchActivityItemProvider.h */,
@@ -1044,7 +1034,6 @@
 				5FCDD4922B7AC6A100EAF29F /* BranchLinkProperties.h in Headers */,
 				5FCDD4C82B7AC6A200EAF29F /* BranchScene.h in Headers */,
 				5FCDD4A72B7AC6A200EAF29F /* BranchShareLink.h in Headers */,
-				5FCDD4B62B7AC6A200EAF29F /* BNCServerRequestQueue.h in Headers */,
 				5FCDD4982B7AC6A100EAF29F /* BNCCurrency.h in Headers */,
 				5FCDD4C52B7AC6A200EAF29F /* BranchPluginSupport.h in Headers */,
 				5FCDD4BC2B7AC6A200EAF29F /* BranchUniversalObject.h in Headers */,
@@ -1128,7 +1117,6 @@
 				5FCDD4932B7AC6A100EAF29F /* BranchLinkProperties.h in Headers */,
 				5FCDD4C92B7AC6A200EAF29F /* BranchScene.h in Headers */,
 				5FCDD4A82B7AC6A200EAF29F /* BranchShareLink.h in Headers */,
-				5FCDD4B72B7AC6A200EAF29F /* BNCServerRequestQueue.h in Headers */,
 				5FCDD4992B7AC6A100EAF29F /* BNCCurrency.h in Headers */,
 				5FCDD4C62B7AC6A200EAF29F /* BranchPluginSupport.h in Headers */,
 				5FCDD4BD2B7AC6A200EAF29F /* BranchUniversalObject.h in Headers */,
@@ -1213,7 +1201,6 @@
 				5FCDD4942B7AC6A100EAF29F /* BranchLinkProperties.h in Headers */,
 				5FCDD4CA2B7AC6A200EAF29F /* BranchScene.h in Headers */,
 				5FCDD4A92B7AC6A200EAF29F /* BranchShareLink.h in Headers */,
-				5FCDD4B82B7AC6A200EAF29F /* BNCServerRequestQueue.h in Headers */,
 				5FCDD49A2B7AC6A100EAF29F /* BNCCurrency.h in Headers */,
 				5FCDD4C72B7AC6A200EAF29F /* BranchPluginSupport.h in Headers */,
 				5FCDD4BE2B7AC6A200EAF29F /* BranchUniversalObject.h in Headers */,
@@ -1658,7 +1645,6 @@
 				5FCDD43E2B7AC6A100EAF29F /* BNCNetworkInterface.m in Sources */,
 				5FCDD4592B7AC6A100EAF29F /* BNCNetworkService.m in Sources */,
 				5FCDD5942B7AC6A400EAF29F /* UIViewController+Branch.m in Sources */,
-				5FCDD4172B7AC6A100EAF29F /* BNCServerRequestQueue.m in Sources */,
 				E52E5B0A2CC79E5C00F553EE /* BranchFileLogger.m in Sources */,
 				5FCDD5A32B7AC6A400EAF29F /* BranchOpenRequest.m in Sources */,
 				5FCDD5672B7AC6A300EAF29F /* BNCLinkData.m in Sources */,
@@ -1766,7 +1752,6 @@
 				5FCDD43F2B7AC6A100EAF29F /* BNCNetworkInterface.m in Sources */,
 				5FCDD45A2B7AC6A100EAF29F /* BNCNetworkService.m in Sources */,
 				5FCDD5952B7AC6A400EAF29F /* UIViewController+Branch.m in Sources */,
-				5FCDD4182B7AC6A100EAF29F /* BNCServerRequestQueue.m in Sources */,
 				E52E5B0B2CC79E5C00F553EE /* BranchFileLogger.m in Sources */,
 				5FCDD5A42B7AC6A400EAF29F /* BranchOpenRequest.m in Sources */,
 				5FCDD5682B7AC6A400EAF29F /* BNCLinkData.m in Sources */,
@@ -1838,7 +1823,6 @@
 				5FCDD4402B7AC6A100EAF29F /* BNCNetworkInterface.m in Sources */,
 				5FCDD45B2B7AC6A100EAF29F /* BNCNetworkService.m in Sources */,
 				5FCDD5962B7AC6A400EAF29F /* UIViewController+Branch.m in Sources */,
-				5FCDD4192B7AC6A100EAF29F /* BNCServerRequestQueue.m in Sources */,
 				5FCDD5A52B7AC6A400EAF29F /* BranchOpenRequest.m in Sources */,
 				5FCDD5692B7AC6A400EAF29F /* BNCLinkData.m in Sources */,
 				5FCDD44C2B7AC6A100EAF29F /* BranchContentDiscoveryManifest.m in Sources */,

Package.swift

@@ -1,4 +1,4 @@
-// swift-tools-version:5.3
+// swift-tools-version:5.9
 // The swift-tools-version declares the minimum version of Swift required to build this package.
 import PackageDescription
 
@@ -9,25 +9,23 @@ let package = Package(
         .tvOS(.v12),
     ],
     products: [
+        // Main product that clients will import
         .library(
             name: "BranchSDK",
-            targets: ["BranchSDK"]),
+            targets: ["BranchSDK", "BranchSwiftSDK"]),
     ],
     dependencies: [
     ],
     targets: [
+        // Main Objective-C SDK target
         .target(
             name: "BranchSDK",
-            path: "Sources",
-            sources: [
-                "BranchSDK/"
-            ],
-            resources: [
-                .copy("Resources/PrivacyInfo.xcprivacy"),
-            ],
-            publicHeadersPath: "BranchSDK/Public/",
+            dependencies: [],
+            path: "Sources/BranchSDK",
+            publicHeadersPath: "Public",
             cSettings: [
-                .headerSearchPath("BranchSDK/Private"),
+                .headerSearchPath("Private"),
+                .define("SWIFT_PACKAGE")
             ],
             linkerSettings: [
                 .linkedFramework("CoreServices"),
@@ -37,5 +35,14 @@ let package = Package(
                 .linkedFramework("AdServices", .when(platforms: [.iOS]))
             ]
         ),
+        // Swift Concurrency layer (depends on main SDK)
+        .target(
+            name: "BranchSwiftSDK",
+            dependencies: ["BranchSDK"],
+            path: "Sources/BranchSwiftSDK",
+            swiftSettings: [
+                .define("SWIFT_PACKAGE")
+            ]
+        )
     ]
 )

Sources/BranchSDK/BNCServerRequestQueue.m

@@ -15,7 +15,6 @@
 #import "BNCNetworkService.h"
 #import "BNCPreferenceHelper.h"
 #import "BNCServerRequest.h"
-#import "BNCServerRequestQueue.h"
 #import "BNCServerResponse.h"
 #import "BNCSystemObserver.h"
 #import "BranchConstants.h"
@@ -1895,6 +1894,11 @@ - (void) processRequest:(BNCServerRequest*)req
                response:(BNCServerResponse*)response
                   error:(NSError*)error {
 
+    // DEPRECATED: This method is being phased out in favor of NSOperationQueue-based request handling
+    // The remove: and peekAt: methods are incompatible with NSOperationQueue implementation
+    // TODO: Implement proper error handling for NSOperationQueue-based request queue
+
+    /* Legacy error handling code - commented out due to NSOperationQueue migration
     // If the request was successful, or was a bad user request, continue processing.
     if (!error ||
         error.code == BNCTrackingDisabledError ||
@@ -1950,7 +1954,7 @@ - (void) processRequest:(BNCServerRequest*)req
                 }
             });
         }
-    }
+    }*/
 }
 
 - (BOOL)isReplayableRequest:(BNCServerRequest *)request {

Sources/BranchSDK/Branch.m

@@ -37,7 +37,6 @@
 #import "BNCLinkCache.h"
 #import "BNCPreferenceHelper.h"
 #import "BNCServerInterface.h"
-#import "BNCServerRequestQueue.h"
 
 #import "BranchLogger.h"
 // Not used by Branch singleton public API
@@ -151,6 +150,10 @@ extern NSString * __nonnull const BNCShareCompletedEvent;
 // Spotlight Constant
 extern NSString * __nonnull const BNCSpotlightFeature;
 
+// Forward declarations for types used in testing APIs
+@class BNCServerRequestQueue;
+@class BNCServerRequest;
+
 #pragma mark - BranchLink
 
 @interface BranchLink : NSObject