driftx 0.1.1 → 0.1.3

package/ios-companion/DriftxCompanion.xcodeproj/project.pbxproj

@@ -0,0 +1,376 @@
+// !$*UTF8*$!
+{
+	archiveVersion = 1;
+	classes = {
+	};
+	objectVersion = 56;
+	objects = {
+
+/* Begin PBXBuildFile section */
+		A10000000000000000000001 /* DriftxCompanionApp.swift in Sources */ = {isa = PBXBuildFile; fileRef = A20000000000000000000001 /* DriftxCompanionApp.swift */; };
+		A10000000000000000000002 /* DriftxCompanionUITests.swift in Sources */ = {isa = PBXBuildFile; fileRef = A20000000000000000000002 /* DriftxCompanionUITests.swift */; };
+		A10000000000000000000003 /* CompanionServer.swift in Sources */ = {isa = PBXBuildFile; fileRef = A20000000000000000000003 /* CompanionServer.swift */; };
+		A10000000000000000000004 /* Router.swift in Sources */ = {isa = PBXBuildFile; fileRef = A20000000000000000000004 /* Router.swift */; };
+		A10000000000000000000005 /* InteractionEndpoint.swift in Sources */ = {isa = PBXBuildFile; fileRef = A20000000000000000000005 /* InteractionEndpoint.swift */; };
+		A10000000000000000000006 /* HierarchyEndpoint.swift in Sources */ = {isa = PBXBuildFile; fileRef = A20000000000000000000006 /* HierarchyEndpoint.swift */; };
+		A10000000000000000000007 /* Network.framework in Frameworks */ = {isa = PBXBuildFile; fileRef = A20000000000000000000010 /* Network.framework */; };
+/* End PBXBuildFile section */
+
+/* Begin PBXContainerItemProxy section */
+		A30000000000000000000001 /* PBXContainerItemProxy */ = {
+			isa = PBXContainerItemProxy;
+			containerPortal = A50000000000000000000001 /* Project object */;
+			proxyType = 1;
+			remoteGlobalIDString = A40000000000000000000001;
+			remoteInfo = DriftxCompanion;
+		};
+/* End PBXContainerItemProxy section */
+
+/* Begin PBXFileReference section */
+		A20000000000000000000001 /* DriftxCompanionApp.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = DriftxCompanionApp.swift; sourceTree = "<group>"; };
+		A20000000000000000000002 /* DriftxCompanionUITests.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = DriftxCompanionUITests.swift; sourceTree = "<group>"; };
+		A20000000000000000000003 /* CompanionServer.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = CompanionServer.swift; sourceTree = "<group>"; };
+		A20000000000000000000004 /* Router.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = Router.swift; sourceTree = "<group>"; };
+		A20000000000000000000005 /* InteractionEndpoint.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = InteractionEndpoint.swift; sourceTree = "<group>"; };
+		A20000000000000000000006 /* HierarchyEndpoint.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = HierarchyEndpoint.swift; sourceTree = "<group>"; };
+		A20000000000000000000007 /* Info.plist */ = {isa = PBXFileReference; lastKnownFileType = text.plist.xml; path = Info.plist; sourceTree = "<group>"; };
+		A20000000000000000000008 /* Info.plist */ = {isa = PBXFileReference; lastKnownFileType = text.plist.xml; path = Info.plist; sourceTree = "<group>"; };
+		A20000000000000000000009 /* DriftxCompanion.app */ = {isa = PBXFileReference; explicitFileType = wrapper.application; includeInIndex = 0; path = DriftxCompanion.app; sourceTree = BUILT_PRODUCTS_DIR; };
+		A2000000000000000000000A /* DriftxCompanionUITests.xctest */ = {isa = PBXFileReference; explicitFileType = wrapper.cfbundle; includeInIndex = 0; path = DriftxCompanionUITests.xctest; sourceTree = BUILT_PRODUCTS_DIR; };
+		A20000000000000000000010 /* Network.framework */ = {isa = PBXFileReference; lastKnownFileType = wrapper.framework; name = Network.framework; path = System/Library/Frameworks/Network.framework; sourceTree = SDKROOT; };
+/* End PBXFileReference section */
+
+/* Begin PBXFrameworksBuildPhase section */
+		A60000000000000000000001 /* Frameworks */ = {
+			isa = PBXFrameworksBuildPhase;
+			buildActionMask = 2147483647;
+			files = (
+			);
+			runOnlyForDeploymentPostprocessing = 0;
+		};
+		A60000000000000000000002 /* Frameworks */ = {
+			isa = PBXFrameworksBuildPhase;
+			buildActionMask = 2147483647;
+			files = (
+				A10000000000000000000007 /* Network.framework in Frameworks */,
+			);
+			runOnlyForDeploymentPostprocessing = 0;
+		};
+/* End PBXFrameworksBuildPhase section */
+
+/* Begin PBXGroup section */
+		A70000000000000000000001 = {
+			isa = PBXGroup;
+			children = (
+				A70000000000000000000002 /* DriftxCompanion */,
+				A70000000000000000000003 /* DriftxCompanionUITests */,
+				A70000000000000000000005 /* Frameworks */,
+				A70000000000000000000004 /* Products */,
+			);
+			sourceTree = "<group>";
+		};
+		A70000000000000000000002 /* DriftxCompanion */ = {
+			isa = PBXGroup;
+			children = (
+				A20000000000000000000001 /* DriftxCompanionApp.swift */,
+				A20000000000000000000007 /* Info.plist */,
+			);
+			path = DriftxCompanion;
+			sourceTree = "<group>";
+		};
+		A70000000000000000000003 /* DriftxCompanionUITests */ = {
+			isa = PBXGroup;
+			children = (
+				A20000000000000000000002 /* DriftxCompanionUITests.swift */,
+				A20000000000000000000003 /* CompanionServer.swift */,
+				A20000000000000000000004 /* Router.swift */,
+				A20000000000000000000005 /* InteractionEndpoint.swift */,
+				A20000000000000000000006 /* HierarchyEndpoint.swift */,
+				A20000000000000000000008 /* Info.plist */,
+			);
+			path = DriftxCompanionUITests;
+			sourceTree = "<group>";
+		};
+		A70000000000000000000004 /* Products */ = {
+			isa = PBXGroup;
+			children = (
+				A20000000000000000000009 /* DriftxCompanion.app */,
+				A2000000000000000000000A /* DriftxCompanionUITests.xctest */,
+			);
+			name = Products;
+			sourceTree = "<group>";
+		};
+		A70000000000000000000005 /* Frameworks */ = {
+			isa = PBXGroup;
+			children = (
+				A20000000000000000000010 /* Network.framework */,
+			);
+			name = Frameworks;
+			sourceTree = "<group>";
+		};
+/* End PBXGroup section */
+
+/* Begin PBXNativeTarget section */
+		A40000000000000000000001 /* DriftxCompanion */ = {
+			isa = PBXNativeTarget;
+			buildConfigurationList = A90000000000000000000001 /* Build configuration list for PBXNativeTarget "DriftxCompanion" */;
+			buildPhases = (
+				A80000000000000000000001 /* Sources */,
+				A60000000000000000000001 /* Frameworks */,
+				AB0000000000000000000001 /* Resources */,
+			);
+			buildRules = (
+			);
+			dependencies = (
+			);
+			name = DriftxCompanion;
+			productName = DriftxCompanion;
+			productReference = A20000000000000000000009 /* DriftxCompanion.app */;
+			productType = "com.apple.product-type.application";
+		};
+		A40000000000000000000002 /* DriftxCompanionUITests */ = {
+			isa = PBXNativeTarget;
+			buildConfigurationList = A90000000000000000000002 /* Build configuration list for PBXNativeTarget "DriftxCompanionUITests" */;
+			buildPhases = (
+				A80000000000000000000002 /* Sources */,
+				A60000000000000000000002 /* Frameworks */,
+				AB0000000000000000000002 /* Resources */,
+			);
+			buildRules = (
+			);
+			dependencies = (
+				AC0000000000000000000001 /* PBXTargetDependency */,
+			);
+			name = DriftxCompanionUITests;
+			productName = DriftxCompanionUITests;
+			productReference = A2000000000000000000000A /* DriftxCompanionUITests.xctest */;
+			productType = "com.apple.product-type.bundle.ui-testing";
+		};
+/* End PBXNativeTarget section */
+
+/* Begin PBXProject section */
+		A50000000000000000000001 /* Project object */ = {
+			isa = PBXProject;
+			attributes = {
+				BuildIndependentTargetsInParallel = 1;
+				LastSwiftUpdateCheck = 1500;
+				LastUpgradeCheck = 1500;
+			};
+			buildConfigurationList = A90000000000000000000003 /* Build configuration list for PBXProject "DriftxCompanion" */;
+			compatibilityVersion = "Xcode 14.0";
+			developmentRegion = en;
+			hasScannedForEncodings = 0;
+			knownRegions = (
+				en,
+				Base,
+			);
+			mainGroup = A70000000000000000000001;
+			productRefGroup = A70000000000000000000004 /* Products */;
+			projectDirPath = "";
+			projectRoot = "";
+			targets = (
+				A40000000000000000000001 /* DriftxCompanion */,
+				A40000000000000000000002 /* DriftxCompanionUITests */,
+			);
+		};
+/* End PBXProject section */
+
+/* Begin PBXResourcesBuildPhase section */
+		AB0000000000000000000001 /* Resources */ = {
+			isa = PBXResourcesBuildPhase;
+			buildActionMask = 2147483647;
+			files = (
+			);
+			runOnlyForDeploymentPostprocessing = 0;
+		};
+		AB0000000000000000000002 /* Resources */ = {
+			isa = PBXResourcesBuildPhase;
+			buildActionMask = 2147483647;
+			files = (
+			);
+			runOnlyForDeploymentPostprocessing = 0;
+		};
+/* End PBXResourcesBuildPhase section */
+
+/* Begin PBXSourcesBuildPhase section */
+		A80000000000000000000001 /* Sources */ = {
+			isa = PBXSourcesBuildPhase;
+			buildActionMask = 2147483647;
+			files = (
+				A10000000000000000000001 /* DriftxCompanionApp.swift in Sources */,
+			);
+			runOnlyForDeploymentPostprocessing = 0;
+		};
+		A80000000000000000000002 /* Sources */ = {
+			isa = PBXSourcesBuildPhase;
+			buildActionMask = 2147483647;
+			files = (
+				A10000000000000000000002 /* DriftxCompanionUITests.swift in Sources */,
+				A10000000000000000000003 /* CompanionServer.swift in Sources */,
+				A10000000000000000000004 /* Router.swift in Sources */,
+				A10000000000000000000005 /* InteractionEndpoint.swift in Sources */,
+				A10000000000000000000006 /* HierarchyEndpoint.swift in Sources */,
+			);
+			runOnlyForDeploymentPostprocessing = 0;
+		};
+/* End PBXSourcesBuildPhase section */
+
+/* Begin PBXTargetDependency section */
+		AC0000000000000000000001 /* PBXTargetDependency */ = {
+			isa = PBXTargetDependency;
+			target = A40000000000000000000001 /* DriftxCompanion */;
+			targetProxy = A30000000000000000000001 /* PBXContainerItemProxy */;
+		};
+/* End PBXTargetDependency section */
+
+/* Begin XCBuildConfiguration section */
+		B10000000000000000000001 /* Debug */ = {
+			isa = XCBuildConfiguration;
+			buildSettings = {
+				ALWAYS_SEARCH_USER_PATHS = NO;
+				CLANG_ENABLE_MODULES = YES;
+				COPY_PHASE_STRIP = NO;
+				DEBUG_INFORMATION_FORMAT = dwarf;
+				ENABLE_STRICT_OBJC_MSGSEND = YES;
+				ENABLE_TESTABILITY = YES;
+				GCC_DYNAMIC_NO_PIC = NO;
+				GCC_OPTIMIZATION_LEVEL = 0;
+				GCC_PREPROCESSOR_DEFINITIONS = (
+					"DEBUG=1",
+					"$(inherited)",
+				);
+				IPHONEOS_DEPLOYMENT_TARGET = 16.0;
+				MTL_ENABLE_DEBUG_INFO = INCLUDE_SOURCE;
+				ONLY_ACTIVE_ARCH = YES;
+				SDKROOT = iphoneos;
+				SWIFT_ACTIVE_COMPILATION_CONDITIONS = DEBUG;
+				SWIFT_OPTIMIZATION_LEVEL = "-Onone";
+				SWIFT_VERSION = 5.0;
+			};
+			name = Debug;
+		};
+		B10000000000000000000002 /* Release */ = {
+			isa = XCBuildConfiguration;
+			buildSettings = {
+				ALWAYS_SEARCH_USER_PATHS = NO;
+				CLANG_ENABLE_MODULES = YES;
+				COPY_PHASE_STRIP = NO;
+				DEBUG_INFORMATION_FORMAT = "dwarf-with-dsym";
+				ENABLE_NS_ASSERTIONS = NO;
+				ENABLE_STRICT_OBJC_MSGSEND = YES;
+				IPHONEOS_DEPLOYMENT_TARGET = 16.0;
+				MTL_ENABLE_DEBUG_INFO = NO;
+				SDKROOT = iphoneos;
+				SWIFT_COMPILATION_MODE = wholemodule;
+				SWIFT_OPTIMIZATION_LEVEL = "-O";
+				SWIFT_VERSION = 5.0;
+				VALIDATE_PRODUCT = YES;
+			};
+			name = Release;
+		};
+		B10000000000000000000003 /* Debug */ = {
+			isa = XCBuildConfiguration;
+			buildSettings = {
+				CODE_SIGN_IDENTITY = "";
+				CODE_SIGNING_ALLOWED = NO;
+				INFOPLIST_FILE = DriftxCompanion/Info.plist;
+				LD_RUNPATH_SEARCH_PATHS = (
+					"$(inherited)",
+					"@executable_path/Frameworks",
+				);
+				PRODUCT_BUNDLE_IDENTIFIER = com.driftx.companion;
+				PRODUCT_NAME = "$(TARGET_NAME)";
+				SWIFT_VERSION = 5.0;
+				TARGETED_DEVICE_FAMILY = "1,2";
+			};
+			name = Debug;
+		};
+		B10000000000000000000004 /* Release */ = {
+			isa = XCBuildConfiguration;
+			buildSettings = {
+				CODE_SIGN_IDENTITY = "";
+				CODE_SIGNING_ALLOWED = NO;
+				INFOPLIST_FILE = DriftxCompanion/Info.plist;
+				LD_RUNPATH_SEARCH_PATHS = (
+					"$(inherited)",
+					"@executable_path/Frameworks",
+				);
+				PRODUCT_BUNDLE_IDENTIFIER = com.driftx.companion;
+				PRODUCT_NAME = "$(TARGET_NAME)";
+				SWIFT_VERSION = 5.0;
+				TARGETED_DEVICE_FAMILY = "1,2";
+			};
+			name = Release;
+		};
+		B10000000000000000000005 /* Debug */ = {
+			isa = XCBuildConfiguration;
+			buildSettings = {
+				CODE_SIGN_IDENTITY = "";
+				CODE_SIGNING_ALLOWED = NO;
+				INFOPLIST_FILE = DriftxCompanionUITests/Info.plist;
+				LD_RUNPATH_SEARCH_PATHS = (
+					"$(inherited)",
+					"@executable_path/Frameworks",
+					"@loader_path/Frameworks",
+				);
+				PRODUCT_BUNDLE_IDENTIFIER = com.driftx.companion.uitests;
+				PRODUCT_NAME = "$(TARGET_NAME)";
+				SWIFT_VERSION = 5.0;
+				TARGETED_DEVICE_FAMILY = "1,2";
+				TEST_TARGET_NAME = DriftxCompanion;
+			};
+			name = Debug;
+		};
+		B10000000000000000000006 /* Release */ = {
+			isa = XCBuildConfiguration;
+			buildSettings = {
+				CODE_SIGN_IDENTITY = "";
+				CODE_SIGNING_ALLOWED = NO;
+				INFOPLIST_FILE = DriftxCompanionUITests/Info.plist;
+				LD_RUNPATH_SEARCH_PATHS = (
+					"$(inherited)",
+					"@executable_path/Frameworks",
+					"@loader_path/Frameworks",
+				);
+				PRODUCT_BUNDLE_IDENTIFIER = com.driftx.companion.uitests;
+				PRODUCT_NAME = "$(TARGET_NAME)";
+				SWIFT_VERSION = 5.0;
+				TARGETED_DEVICE_FAMILY = "1,2";
+				TEST_TARGET_NAME = DriftxCompanion;
+			};
+			name = Release;
+		};
+/* End XCBuildConfiguration section */
+
+/* Begin XCConfigurationList section */
+		A90000000000000000000001 /* Build configuration list for PBXNativeTarget "DriftxCompanion" */ = {
+			isa = XCConfigurationList;
+			buildConfigurations = (
+				B10000000000000000000003 /* Debug */,
+				B10000000000000000000004 /* Release */,
+			);
+			defaultConfigurationIsVisible = 0;
+			defaultConfigurationName = Release;
+		};
+		A90000000000000000000002 /* Build configuration list for PBXNativeTarget "DriftxCompanionUITests" */ = {
+			isa = XCConfigurationList;
+			buildConfigurations = (
+				B10000000000000000000005 /* Debug */,
+				B10000000000000000000006 /* Release */,
+			);
+			defaultConfigurationIsVisible = 0;
+			defaultConfigurationName = Release;
+		};
+		A90000000000000000000003 /* Build configuration list for PBXProject "DriftxCompanion" */ = {
+			isa = XCConfigurationList;
+			buildConfigurations = (
+				B10000000000000000000001 /* Debug */,
+				B10000000000000000000002 /* Release */,
+			);
+			defaultConfigurationIsVisible = 0;
+			defaultConfigurationName = Release;
+		};
+/* End XCConfigurationList section */
+	};
+	rootObject = A50000000000000000000001 /* Project object */;
+}

package/ios-companion/DriftxCompanion.xcodeproj/xcshareddata/xcschemes/DriftxCompanionUITests.xcscheme

@@ -0,0 +1,109 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<Scheme
+   LastUpgradeVersion = "1500"
+   version = "1.7">
+   <BuildAction
+      parallelizeBuildables = "YES"
+      buildImplicitDependencies = "YES">
+      <BuildActionEntries>
+         <BuildActionEntry
+            buildForTesting = "YES"
+            buildForRunning = "YES"
+            buildForProfiling = "YES"
+            buildForArchiving = "YES"
+            buildForAnalyzing = "YES">
+            <BuildableReference
+               BuildableIdentifier = "primary"
+               BlueprintIdentifier = "A40000000000000000000001"
+               BuildableName = "DriftxCompanion.app"
+               BlueprintName = "DriftxCompanion"
+               ReferencedContainer = "container:DriftxCompanion.xcodeproj">
+            </BuildableReference>
+         </BuildActionEntry>
+         <BuildActionEntry
+            buildForTesting = "YES"
+            buildForRunning = "NO"
+            buildForProfiling = "NO"
+            buildForArchiving = "NO"
+            buildForAnalyzing = "NO">
+            <BuildableReference
+               BuildableIdentifier = "primary"
+               BlueprintIdentifier = "A40000000000000000000002"
+               BuildableName = "DriftxCompanionUITests.xctest"
+               BlueprintName = "DriftxCompanionUITests"
+               ReferencedContainer = "container:DriftxCompanion.xcodeproj">
+            </BuildableReference>
+         </BuildActionEntry>
+      </BuildActionEntries>
+   </BuildAction>
+   <TestAction
+      buildConfiguration = "Debug"
+      selectedDebuggerIdentifier = "Xcode.DebuggerFoundation.Debugger.LLDB"
+      selectedLauncherIdentifier = "Xcode.DebuggerFoundation.Launcher.LLDB"
+      shouldUseLaunchSchemeArgsEnv = "YES">
+      <Testables>
+         <TestableReference
+            skipped = "NO">
+            <BuildableReference
+               BuildableIdentifier = "primary"
+               BlueprintIdentifier = "A40000000000000000000002"
+               BuildableName = "DriftxCompanionUITests.xctest"
+               BlueprintName = "DriftxCompanionUITests"
+               ReferencedContainer = "container:DriftxCompanion.xcodeproj">
+            </BuildableReference>
+         </TestableReference>
+      </Testables>
+      <EnvironmentVariables>
+         <EnvironmentVariable
+            key = "DRIFTX_PORT"
+            value = ""
+            isEnabled = "NO">
+         </EnvironmentVariable>
+      </EnvironmentVariables>
+   </TestAction>
+   <LaunchAction
+      buildConfiguration = "Debug"
+      selectedDebuggerIdentifier = "Xcode.DebuggerFoundation.Debugger.LLDB"
+      selectedLauncherIdentifier = "Xcode.DebuggerFoundation.Launcher.LLDB"
+      launchStyle = "0"
+      useCustomWorkingDirectory = "NO"
+      ignoresPersistentStateOnLaunch = "NO"
+      debugDocumentVersioning = "YES"
+      debugServiceExtension = "internal"
+      allowLocationSimulation = "YES">
+      <BuildableProductRunnable
+         runnableDebuggingMode = "0">
+         <BuildableReference
+            BuildableIdentifier = "primary"
+            BlueprintIdentifier = "A40000000000000000000001"
+            BuildableName = "DriftxCompanion.app"
+            BlueprintName = "DriftxCompanion"
+            ReferencedContainer = "container:DriftxCompanion.xcodeproj">
+         </BuildableReference>
+      </BuildableProductRunnable>
+   </LaunchAction>
+   <ProfileAction
+      buildConfiguration = "Release"
+      shouldUseLaunchSchemeArgsEnv = "YES"
+      savedToolIdentifier = ""
+      useCustomWorkingDirectory = "NO"
+      debugDocumentVersioning = "YES">
+      <BuildableProductRunnable
+         runnableDebuggingMode = "0">
+         <BuildableReference
+            BuildableIdentifier = "primary"
+            BlueprintIdentifier = "A40000000000000000000001"
+            BuildableName = "DriftxCompanion.app"
+            BlueprintName = "DriftxCompanion"
+            ReferencedContainer = "container:DriftxCompanion.xcodeproj">
+         </BuildableReference>
+      </BuildableProductRunnable>
+   </ProfileAction>
+   <AnalyzeAction
+      buildConfiguration = "Debug">
+   </AnalyzeAction>
+   <ArchiveAction
+      buildConfiguration = "Release"
+      revealArchiveInOrganizer = "YES">
+   </ArchiveAction>
+</Scheme>

package/ios-companion/DriftxCompanionUITests/CompanionServer.swift

@@ -0,0 +1,176 @@
+import Foundation
+import Network
+import XCTest
+
+final class CompanionServer {
+    private let port: UInt16
+    private var app: XCUIApplication
+    private let router: Router
+    private var listener: NWListener?
+    private let queue = DispatchQueue(label: "com.driftx.companion.server", attributes: .concurrent)
+
+    init(port: UInt16, app: XCUIApplication) {
+        self.port = port
+        self.app = app
+        self.router = Router()
+        router.register(method: "GET", path: "/status") { _ in
+            return (200, Router.jsonResponse(["status": "ready"]))
+        }
+        router.register(method: "POST", path: "/configure") { [weak self] body in
+            guard let self = self,
+                  let json = parseJSONBody(body),
+                  let bundleId = json["bundleId"] as? String, !bundleId.isEmpty else {
+                return (400, Router.jsonResponse(["success": false, "error": "Missing bundleId"]))
+            }
+            DispatchQueue.main.sync {
+                let newApp = XCUIApplication(bundleIdentifier: bundleId)
+                newApp.activate()
+                self.app = newApp
+                InteractionEndpoint.register(on: self.router, app: newApp)
+                HierarchyEndpoint.register(on: self.router, app: newApp)
+            }
+            return (200, Router.jsonResponse(["success": true, "bundleId": bundleId]))
+        }
+        InteractionEndpoint.register(on: router, app: app)
+        HierarchyEndpoint.register(on: router, app: app)
+    }
+
+    func start() {
+        let params = NWParameters.tcp
+        params.allowLocalEndpointReuse = true
+
+        guard let nwPort = NWEndpoint.Port(rawValue: port) else {
+            fatalError("Invalid port: \(port)")
+        }
+
+        do {
+            listener = try NWListener(using: params, on: nwPort)
+        } catch {
+            fatalError("Failed to create listener: \(error)")
+        }
+
+        listener?.stateUpdateHandler = { state in
+            switch state {
+            case .ready:
+                print("[DriftxCompanion] Server listening on port \(self.port)")
+            case .failed(let error):
+                fatalError("[DriftxCompanion] Listener failed: \(error)")
+            default:
+                break
+            }
+        }
+
+        listener?.newConnectionHandler = { [weak self] connection in
+            self?.handleConnection(connection)
+        }
+
+        listener?.start(queue: queue)
+    }
+
+    func stop() {
+        listener?.cancel()
+        listener = nil
+    }
+
+    private func handleConnection(_ connection: NWConnection) {
+        connection.start(queue: queue)
+        receiveRequest(connection: connection, buffer: Data())
+    }
+
+    private func receiveRequest(connection: NWConnection, buffer: Data) {
+        connection.receive(minimumIncompleteLength: 1, maximumLength: 65536) { [weak self] content, _, isComplete, error in
+            guard let self = self else { return }
+
+            if let error = error {
+                print("[DriftxCompanion] Receive error: \(error)")
+                connection.cancel()
+                return
+            }
+
+            var accumulated = buffer
+            if let content = content {
+                accumulated.append(content)
+            }
+
+            if let request = self.parseHTTPRequest(accumulated) {
+                self.dispatch(request: request, connection: connection)
+            } else if isComplete {
+                connection.cancel()
+            } else {
+                self.receiveRequest(connection: connection, buffer: accumulated)
+            }
+        }
+    }
+
+    private struct HTTPRequest {
+        let method: String
+        let path: String
+        let headers: [String: String]
+        let body: Data?
+    }
+
+    private func parseHTTPRequest(_ data: Data) -> HTTPRequest? {
+        guard let str = String(data: data, encoding: .utf8) else { return nil }
+        guard let headerEnd = str.range(of: "\r\n\r\n") else { return nil }
+
+        let headerSection = String(str[str.startIndex..<headerEnd.lowerBound])
+        let lines = headerSection.components(separatedBy: "\r\n")
+        guard let requestLine = lines.first else { return nil }
+
+        let parts = requestLine.components(separatedBy: " ")
+        guard parts.count >= 2 else { return nil }
+
+        let method = parts[0]
+        let path = parts[1]
+
+        var headers: [String: String] = [:]
+        for line in lines.dropFirst() {
+            if let colonIndex = line.firstIndex(of: ":") {
+                let key = String(line[line.startIndex..<colonIndex]).trimmingCharacters(in: .whitespaces).lowercased()
+                let value = String(line[line.index(after: colonIndex)...]).trimmingCharacters(in: .whitespaces)
+                headers[key] = value
+            }
+        }
+
+        let bodyStart = str[headerEnd.upperBound...]
+        let bodyData = Data(bodyStart.utf8)
+
+        if let contentLengthStr = headers["content-length"], let contentLength = Int(contentLengthStr) {
+            if bodyData.count < contentLength {
+                return nil
+            }
+            return HTTPRequest(method: method, path: path, headers: headers, body: bodyData.prefix(contentLength))
+        }
+
+        return HTTPRequest(method: method, path: path, headers: headers, body: bodyData.isEmpty ? nil : bodyData)
+    }
+
+    private func dispatch(request: HTTPRequest, connection: NWConnection) {
+        let (statusCode, responseBody) = router.handle(method: request.method, path: request.path, body: request.body)
+        sendResponse(connection: connection, statusCode: statusCode, body: responseBody)
+    }
+
+    private func sendResponse(connection: NWConnection, statusCode: Int, body: Data) {
+        let statusText: String
+        switch statusCode {
+        case 200: statusText = "OK"
+        case 400: statusText = "Bad Request"
+        case 404: statusText = "Not Found"
+        case 500: statusText = "Internal Server Error"
+        default: statusText = "Unknown"
+        }
+
+        var response = "HTTP/1.1 \(statusCode) \(statusText)\r\n"
+        response += "Content-Type: application/json\r\n"
+        response += "Content-Length: \(body.count)\r\n"
+        response += "Connection: close\r\n"
+        response += "\r\n"
+
+        var responseData = Data(response.utf8)
+        responseData.append(body)
+
+        connection.send(content: responseData, completion: .contentProcessed { _ in
+            connection.cancel()
+        })
+    }
+}

package/ios-companion/DriftxCompanionUITests/DriftxCompanionUITests.swift

@@ -0,0 +1,15 @@
+import XCTest
+
+final class DriftxCompanionUITests: XCTestCase {
+    func testCompanionServer() throws {
+        let port = UInt16(ProcessInfo.processInfo.environment["DRIFTX_PORT"] ?? "8300") ?? 8300
+        let app = XCUIApplication(bundleIdentifier: "com.apple.springboard")
+
+        let server = CompanionServer(port: port, app: app)
+        server.start()
+
+        let exp = expectation(description: "Server running")
+        exp.isInverted = true
+        wait(for: [exp], timeout: 86400)
+    }
+}