Add Swift queue implementation alongside existing queue

Changes:
- Added modern Swift-based BranchRequestQueue (actor pattern with NSOperationQueue)
- Added BranchRequestOperation for async request processing
- Added ConfigurationController for operational metrics
- Updated Package.swift to Swift 5.9 with dual-target architecture (BranchSDK + BranchSwiftSDK)
- Restored BNCServerRequestQueue files temporarily for compatibility
- Added BNCServerRequest.h imports to BranchQRCode.m and BranchEvent.h
- Restored BNCServerRequestQueue.h import in Branch.m

Current state:
- Both old (BNCServerRequestQueue) and new (BranchRequestQueue) implementations coexist
- Framework builds successfully
- Next step: Migrate Branch.m to use BranchRequestQueueBridge, then remove old queue

Author: wpinho-branch

BranchSDK.xcodeproj/project.pbxproj

@@ -99,6 +99,9 @@
 		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 */; };
@@ -242,6 +245,9 @@
 		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, ); }; };
@@ -578,6 +584,7 @@
 		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>"; };
@@ -628,6 +635,7 @@
 		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>"; };
@@ -865,6 +873,7 @@
 				5FCDD3F32B7AC6A100EAF29F /* BNCServerAPI.m */,
 				5FCDD3902B7AC6A100EAF29F /* BNCServerInterface.m */,
 				5FCDD3802B7AC6A100EAF29F /* BNCServerRequest.m */,
+				5FCDD3742B7AC6A100EAF29F /* BNCServerRequestQueue.m */,
 				5FCDD3F72B7AC6A100EAF29F /* BNCServerResponse.m */,
 				5FCDD3EB2B7AC6A100EAF29F /* BNCSKAdNetwork.m */,
 				5FCDD3F22B7AC6A100EAF29F /* BNCSpotlightService.m */,
@@ -924,6 +933,7 @@
 				5FCDD3B32B7AC6A100EAF29F /* BNCProductCategory.h */,
 				5FCDD3B22B7AC6A100EAF29F /* BNCServerInterface.h */,
 				5FCDD3AD2B7AC6A100EAF29F /* BNCServerRequest.h */,
+				5FCDD3AA2B7AC6A100EAF29F /* BNCServerRequestQueue.h */,
 				5FCDD3A32B7AC6A100EAF29F /* BNCServerResponse.h */,
 				5FCDD3A22B7AC6A100EAF29F /* Branch.h */,
 				5FCDD39C2B7AC6A100EAF29F /* BranchActivityItemProvider.h */,
@@ -1034,6 +1044,7 @@
 				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 */,
@@ -1117,6 +1128,7 @@
 				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 */,
@@ -1201,6 +1213,7 @@
 				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 */,
@@ -1645,6 +1658,7 @@
 				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 */,
@@ -1752,6 +1766,7 @@
 				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 */,
@@ -1823,6 +1838,7 @@
 				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 */,

Sources/BranchSDK/BNCServerRequestQueue.m

@@ -0,0 +1,159 @@
+//
+//  BNCServerRequestQueue.m
+//  Branch-SDK
+//
+//  Created by Qinwei Gong on 9/6/14.
+//  Copyright (c) 2014 Branch Metrics. All rights reserved.
+//
+
+
+#import "BNCServerRequestQueue.h"
+#import "BNCPreferenceHelper.h"
+
+// Analytics requests
+#import "BranchInstallRequest.h"
+#import "BranchOpenRequest.h"
+#import "BranchEvent.h"
+
+#import "BranchLogger.h"
+
+@interface BNCServerRequestQueue()
+@property (strong, nonatomic) NSMutableArray<BNCServerRequest *> *queue;
+@end
+
+
+@implementation BNCServerRequestQueue
+
+- (instancetype)init {
+    self = [super init];
+    if (!self) return self;
+
+    self.queue = [NSMutableArray<BNCServerRequest *> new];
+    return self;
+}
+
+- (void)enqueue:(BNCServerRequest *)request {
+    @synchronized (self) {
+        if (request) {
+            [self.queue addObject:request];
+        }
+    }
+}
+
+- (void)insert:(BNCServerRequest *)request at:(NSUInteger)index {
+    @synchronized (self) {
+        if (index > self.queue.count) {
+            [[BranchLogger shared] logError:@"Invalid queue operation: index out of bound!" error:nil];
+            return;
+        }
+        if (request) {
+            [self.queue insertObject:request atIndex:index];
+        }
+    }
+}
+
+- (BNCServerRequest *)dequeue {
+    @synchronized (self) {
+        BNCServerRequest *request = nil;
+        if (self.queue.count > 0) {
+            request = [self.queue objectAtIndex:0];
+            [self.queue removeObjectAtIndex:0];
+        }
+        return request;
+    }
+}
+
+- (BNCServerRequest *)removeAt:(NSUInteger)index {
+    @synchronized (self) {
+        BNCServerRequest *request = nil;
+        if (index >= self.queue.count) {
+            [[BranchLogger shared] logError:@"Invalid queue operation: index out of bound!" error:nil];
+            return nil;
+        }
+        request = [self.queue objectAtIndex:index];
+        [self.queue removeObjectAtIndex:index];
+        return request;
+    }
+}
+
+- (void)remove:(BNCServerRequest *)request {
+    @synchronized (self) {
+        [self.queue removeObject:request];
+    }
+}
+
+- (BNCServerRequest *)peek {
+    @synchronized (self) {
+        return [self peekAt:0];
+    }
+}
+
+- (BNCServerRequest *)peekAt:(NSUInteger)index {
+    @synchronized (self) {
+        if (index >= self.queue.count) {
+            [[BranchLogger shared] logError:@"Invalid queue operation: index out of bound!" error:nil];
+            return nil;
+        }
+        BNCServerRequest *request = nil;
+        request = [self.queue objectAtIndex:index];
+        return request;
+    }
+}
+
+- (NSInteger)queueDepth {
+    @synchronized (self) {
+        return (NSInteger) self.queue.count;
+    }
+}
+
+- (NSString *)description {
+    @synchronized(self) {
+        return [self.queue description];
+    }
+}
+
+- (void)clearQueue {
+    @synchronized (self) {
+        [self.queue removeAllObjects];
+    }
+}
+
+- (BOOL)containsInstallOrOpen {
+    @synchronized (self) {
+        for (NSUInteger i = 0; i < self.queue.count; i++) {
+            BNCServerRequest *req = [self.queue objectAtIndex:i];
+            // Install extends open, so only need to check open.
+            if ([req isKindOfClass:[BranchOpenRequest class]]) {
+                return YES;
+            }
+        }
+        return NO;
+    }
+}
+
+- (BranchOpenRequest *)findExistingInstallOrOpen {
+    @synchronized (self) {
+        for (NSUInteger i = 0; i < self.queue.count; i++) {
+            BNCServerRequest *request = [self.queue objectAtIndex:i];
+
+            // Install subclasses open, so only need to check open
+            // Request should not be the one added from archived queue
+            if ([request isKindOfClass:[BranchOpenRequest class]] && !((BranchOpenRequest *)request).isFromArchivedQueue) {
+                return (BranchOpenRequest *)request;
+            }
+        }
+        return nil;
+    }
+}
+
+
++ (instancetype)getInstance {
+    static BNCServerRequestQueue *sharedQueue = nil;
+    static dispatch_once_t onceToken = 0;
+    dispatch_once(&onceToken, ^ {
+        sharedQueue = [[BNCServerRequestQueue alloc] init];
+    });
+    return sharedQueue;
+}
+
+@end

Sources/BranchSDK/Branch.m

@@ -15,6 +15,7 @@
 #import "BNCNetworkService.h"
 #import "BNCPreferenceHelper.h"
 #import "BNCServerRequest.h"
+#import "BNCServerRequestQueue.h"
 #import "BNCServerResponse.h"
 #import "BNCSystemObserver.h"
 #import "BranchConstants.h"

Sources/BranchSDK/BranchQRCode.m

@@ -8,6 +8,7 @@
 #import <LinkPresentation/LPLinkMetadata.h>
 #import "BranchQRCode.h"
 #import "Branch.h"
+#import "BNCServerRequest.h"
 #import "BNCQRCodeCache.h"
 #import "BNCConfig.h"
 #import "BranchConstants.h"

Sources/BranchSDK/Public/BNCServerRequestQueue.h

@@ -0,0 +1,29 @@
+//
+//  BNCServerRequestQueue.h
+//  Branch-SDK
+//
+//  Created by Qinwei Gong on 9/6/14.
+//  Copyright (c) 2014 Branch Metrics. All rights reserved.
+//
+
+#import "BNCServerRequest.h"
+@class BranchOpenRequest;
+
+@interface BNCServerRequestQueue : NSObject
+
+- (void)enqueue:(BNCServerRequest *)request;
+- (BNCServerRequest *)dequeue;
+- (BNCServerRequest *)peek;
+- (BNCServerRequest *)peekAt:(NSUInteger)index;
+- (void)insert:(BNCServerRequest *)request at:(NSUInteger)index;
+- (BNCServerRequest *)removeAt:(NSUInteger)index;
+- (void)remove:(BNCServerRequest *)request;
+- (void)clearQueue;
+- (NSInteger)queueDepth;
+
+- (BOOL)containsInstallOrOpen;
+
+- (BranchOpenRequest *)findExistingInstallOrOpen;
+
++ (id)getInstance;
+@end

Sources/BranchSDK/Public/BranchEvent.h

@@ -7,6 +7,7 @@
 //
 
 #import "Branch.h"
+#import "BNCServerRequest.h"
 #import "BranchUniversalObject.h"
 #import <StoreKit/StoreKit.h>