craft-native 0.0.368 → 0.0.374

package/dist/ios/templates/CraftBluetooth.swift

@@ -1,4 +1,6 @@
+#if CRAFT_PERMISSION_BLUETOOTH
 import CoreBluetooth
+#endif
 import Foundation
 
 struct CraftBluetoothError: Error {
@@ -7,6 +9,7 @@ struct CraftBluetoothError: Error {
 }
 
 /// One explicitly chosen GATT channel. Scanning is user initiated; no vendor API.
+#if CRAFT_PERMISSION_BLUETOOTH
 final class CraftBluetooth: NSObject, CBCentralManagerDelegate, CBPeripheralDelegate {
     typealias Completion = (Result<Any, CraftBluetoothError>) -> Void
     static let shared = CraftBluetooth()
@@ -327,3 +330,12 @@ final class CraftBluetooth: NSObject, CBCentralManagerDelegate, CBPeripheralDele
         peripheral = nil; writer = nil; notifier = nil; connected = false
     }
 }
+#else
+final class CraftBluetooth {
+    typealias Completion = (Result<Any, CraftBluetoothError>) -> Void
+    static let shared = CraftBluetooth()
+    func perform(method: String, args: [Any], completion: @escaping Completion) {
+        completion(.failure(CraftBluetoothError(message: "Bluetooth was not enabled when this app was built", code: "CAPABILITY_DISABLED")))
+    }
+}
+#endif

package/dist/ios/templates/CraftHealth.swift

@@ -1,3 +1,4 @@
+#if CRAFT_PERMISSION_HEALTH
 import CoreLocation
 import Foundation
 import HealthKit
@@ -127,6 +128,8 @@ final class CraftHealth {
             resumeWorkout(completion: completion)
         case "endWorkout":
             endWorkout(completion: completion)
+        case "discardWorkout":
+            discardWorkout(completion: completion)
         default:
             completion(.failure(CraftHealthError(message: "Unsupported Health method", code: "UNKNOWN_ACTION")))
         }
@@ -925,7 +928,13 @@ final class CraftHealth {
         do {
             let session = try HKWorkoutSession(healthStore: healthStore, configuration: configuration)
             let builder = session.associatedWorkoutBuilder()
-            let delegate = CraftHealthWorkoutDelegate(id: { [weak self] in self?.liveWorkoutID ?? "" }) { [weak self] detail in self?.sendWorkout(detail) }
+            let id = UUID().uuidString.lowercased()
+            let delegate = CraftHealthWorkoutDelegate(id: { id }) { [weak self] detail in
+                self?.onMain { [weak self] in
+                    guard let self, self.liveWorkoutID == id else { return }
+                    self.sendWorkout(detail)
+                }
+            }
             let metricsDelegate = CraftHealthWorkoutBuilderDelegate(owner: self)
             session.delegate = delegate
             builder.delegate = metricsDelegate
@@ -935,15 +944,18 @@ final class CraftHealth {
             liveWorkoutBuilder = builder
             liveWorkoutDelegate = delegate
             liveWorkoutBuilderDelegate = metricsDelegate
-            liveWorkoutID = UUID().uuidString.lowercased()
+            liveWorkoutID = id
             liveWorkoutType = type
             liveWorkoutStart = Date()
-            let id = liveWorkoutID!
             let start = liveWorkoutStart!
             session.startActivity(with: start)
             builder.beginCollection(withStart: start) { [weak self] success, error in
                 DispatchQueue.main.async {
                     guard let self else { return }
+                    guard self.liveWorkoutID == id else {
+                        completion(.failure(CraftHealthError(message: "Live workout was discarded while starting", code: "WORKOUT_CANCELLED")))
+                        return
+                    }
                     guard success else {
                         self.clearLiveWorkout()
                         completion(.failure(CraftHealthError(message: error?.localizedDescription ?? "Live workout could not start")))
@@ -980,16 +992,24 @@ final class CraftHealth {
 
     func endWorkout(completion rawCompletion: @escaping Completion) {
         let completion = completeOnMain(rawCompletion)
+        guard !liveWorkoutEnding else {
+            completion(.failure(CraftHealthError(message: "Live workout is already being saved", code: "WORKOUT_ENDING")))
+            return
+        }
         guard #available(iOS 26.0, *), let session = liveWorkoutSession as? HKWorkoutSession, let builder = liveWorkoutBuilder as? HKLiveWorkoutBuilder, let id = liveWorkoutID else {
             completion(.failure(CraftHealthError(message: "No live workout is running", code: "NO_WORKOUT")))
             return
         }
         let end = Date()
+        liveWorkoutEnding = true
         session.end()
         builder.endCollection(withEnd: end) { [weak self] success, error in
             guard let self else { return }
             guard success else {
-                DispatchQueue.main.async { completion(.failure(CraftHealthError(message: error?.localizedDescription ?? "Live workout could not end"))) }
+                DispatchQueue.main.async {
+                    self.liveWorkoutEnding = false
+                    completion(.failure(CraftHealthError(message: error?.localizedDescription ?? "Live workout could not end")))
+                }
                 return
             }
             builder.finishWorkout { [weak self] workout, finishError in
@@ -1011,18 +1031,39 @@ final class CraftHealth {
         }
     }
 
+    /// Stops collection without calling finishWorkout (which saves a workout).
+    /// It does not delete health samples already persisted by HealthKit.
+    func discardWorkout(completion rawCompletion: @escaping Completion) {
+        let completion = completeOnMain(rawCompletion)
+        guard !liveWorkoutEnding else {
+            completion(.failure(CraftHealthError(message: "Live workout is already being saved", code: "WORKOUT_ENDING")))
+            return
+        }
+        guard let id = liveWorkoutID, discardLiveWorkout(expectedID: id) else {
+            completion(.failure(CraftHealthError(message: "No live workout is running", code: "NO_WORKOUT")))
+            return
+        }
+        completion(.success(true))
+    }
+
     /// Only the Live Activity that started this runtime can release it. HQ
     /// persists its own final result, so collecting here must not duplicate it.
     func discardActivityWorkout(expectedID: String) {
-        guard #available(iOS 26.0, *), liveWorkoutID == expectedID,
+        _ = discardLiveWorkout(expectedID: expectedID)
+    }
+
+    private func discardLiveWorkout(expectedID: String) -> Bool {
+        guard #available(iOS 26.0, *), !liveWorkoutEnding, liveWorkoutID == expectedID,
               let session = liveWorkoutSession as? HKWorkoutSession,
-              let builder = liveWorkoutBuilder as? HKLiveWorkoutBuilder else { return }
+              let builder = liveWorkoutBuilder as? HKLiveWorkoutBuilder else { return false }
         session.end()
         builder.discardWorkout()
         clearLiveWorkout()
+        return true
     }
 
     private func clearLiveWorkout() {
+        liveWorkoutEnding = false
         liveWorkoutSession = nil
         liveWorkoutBuilder = nil
         liveWorkoutDelegate = nil
@@ -1034,7 +1075,7 @@ final class CraftHealth {
 
     @available(iOS 26.0, *)
     fileprivate func emitLiveWorkoutMetrics(_ builder: HKLiveWorkoutBuilder) {
-        guard let id = liveWorkoutID else { return }
+        guard let id = liveWorkoutID, builder === liveWorkoutBuilder else { return }
         var detail: [String: Any] = ["id": id, "event": "metrics", "date": Date().timeIntervalSince1970 * 1000]
         let bpm = HKUnit.count().unitDivided(by: .minute())
         if let type = HKQuantityType.quantityType(forIdentifier: .heartRate),
@@ -1049,7 +1090,10 @@ final class CraftHealth {
            let value = builder.statistics(for: type)?.sumQuantity()?.doubleValue(for: .meter()), value.isFinite {
             detail["distanceMeters"] = value
         }
-        onMain { [weak self] in self?.sendWorkout(detail) }
+        onMain { [weak self] in
+            guard let self, self.liveWorkoutID == id else { return }
+            self.sendWorkout(detail)
+        }
     }
 
     private static func workoutActivity(_ type: String) -> HKWorkoutActivityType? {
@@ -1090,6 +1134,7 @@ final class CraftHealth {
     // iOS 16.2; concrete HealthKit types are only touched behind the iOS 26
     // availability checks below.
     private var liveWorkoutSession: AnyObject?
+    private var liveWorkoutEnding = false
     private var liveWorkoutBuilder: AnyObject?
     private var liveWorkoutDelegate: AnyObject?
     private var liveWorkoutBuilderDelegate: AnyObject?
@@ -1238,3 +1283,74 @@ final class CraftHealth {
     }
     #endif
 }
+#else
+import Foundation
+struct CraftHealthError: Error {
+    let message: String
+    var code: String = "CAPABILITY_DISABLED"
+}
+final class CraftHealth {
+    typealias Completion = (Result<Any, CraftHealthError>) -> Void
+    static let shared = CraftHealth()
+    var pageSink: (([String: Any]) -> Bool)?
+    var workoutSink: (([String: Any]) -> Bool)?
+    func perform(method: String, args: [Any], completion rawCompletion: @escaping Completion) {
+        rawCompletion(.failure(CraftHealthError(message: "Health was not enabled when this app was built")))
+    }
+    func requestAuthorization(types: [String], readOnly: Bool = false, completion rawCompletion: @escaping Completion) {
+        rawCompletion(.failure(CraftHealthError(message: "Health was not enabled when this app was built")))
+    }
+    func getData(type: String, startDate: Double?, endDate: Double?, completion rawCompletion: @escaping Completion) {
+        rawCompletion(.failure(CraftHealthError(message: "Health was not enabled when this app was built")))
+    }
+    func saveData(type: String, value: Double, options: [String: Any], completion rawCompletion: @escaping Completion) {
+        rawCompletion(.failure(CraftHealthError(message: "Health was not enabled when this app was built")))
+    }
+    func saveWorkout(body: [String: Any], completion rawCompletion: @escaping Completion) {
+        rawCompletion(.failure(CraftHealthError(message: "Health was not enabled when this app was built")))
+    }
+    func getWorkouts(startDate: Double?, endDate: Double?, limit: Int?, completion rawCompletion: @escaping Completion) {
+        rawCompletion(.failure(CraftHealthError(message: "Health was not enabled when this app was built")))
+    }
+    func getDailyStatistics(type: String, startDate: Double?, endDate: Double?, completion rawCompletion: @escaping Completion) {
+        rawCompletion(.failure(CraftHealthError(message: "Health was not enabled when this app was built")))
+    }
+    func getHeartRateSamples(startDate: Double?, endDate: Double?, limit: Int?, completion rawCompletion: @escaping Completion) {
+        rawCompletion(.failure(CraftHealthError(message: "Health was not enabled when this app was built")))
+    }
+    func getSamples(type: String, startDate: Double?, endDate: Double?, limit: Int?, completion rawCompletion: @escaping Completion) {
+        rawCompletion(.failure(CraftHealthError(message: "Health was not enabled when this app was built")))
+    }
+    func getSleepIntervals(startDate: Double?, endDate: Double?, completion rawCompletion: @escaping Completion) {
+        rawCompletion(.failure(CraftHealthError(message: "Health was not enabled when this app was built")))
+    }
+    func saveMindfulSession(body: [String: Any], completion rawCompletion: @escaping Completion) {
+        rawCompletion(.failure(CraftHealthError(message: "Health was not enabled when this app was built")))
+    }
+    func getMindfulSessions(startDate: Double?, endDate: Double?, limit: Int?, completion rawCompletion: @escaping Completion) {
+        rawCompletion(.failure(CraftHealthError(message: "Health was not enabled when this app was built")))
+    }
+    func startWorkout(body: [String: Any], completion rawCompletion: @escaping Completion) {
+        rawCompletion(.failure(CraftHealthError(message: "Health was not enabled when this app was built")))
+    }
+    func pauseWorkout(completion rawCompletion: @escaping Completion) {
+        rawCompletion(.failure(CraftHealthError(message: "Health was not enabled when this app was built")))
+    }
+    func resumeWorkout(completion rawCompletion: @escaping Completion) {
+        rawCompletion(.failure(CraftHealthError(message: "Health was not enabled when this app was built")))
+    }
+    func endWorkout(completion rawCompletion: @escaping Completion) {
+        rawCompletion(.failure(CraftHealthError(message: "Health was not enabled when this app was built")))
+    }
+    func discardWorkout(completion rawCompletion: @escaping Completion) {
+        rawCompletion(.failure(CraftHealthError(message: "Health was not enabled when this app was built")))
+    }
+    func startHeartRateUpdates(since: Double?, completion rawCompletion: @escaping Completion) {
+        rawCompletion(.failure(CraftHealthError(message: "Health was not enabled when this app was built")))
+    }
+    func stopHeartRateUpdates(completion rawCompletion: @escaping Completion) {
+        rawCompletion(.failure(CraftHealthError(message: "Health was not enabled when this app was built")))
+    }
+    func discardActivityWorkout(expectedID: String) {}
+}
+#endif

package/dist/ios/templates/CraftHeartRate.swift

@@ -1,4 +1,6 @@
+#if CRAFT_PERMISSION_BLUETOOTH
 import CoreBluetooth
+#endif
 import Foundation
 import UIKit
 
@@ -120,6 +122,7 @@ struct CraftHeartRateMeasurement: Equatable {
 ///
 /// Everything runs on main: the central manager delivers there, and every
 /// caller hops there first.
+#if CRAFT_PERMISSION_BLUETOOTH
 final class CraftHeartRate: NSObject, CBCentralManagerDelegate, CBPeripheralDelegate {
     typealias Completion = (Result<Any, CraftHeartRateError>) -> Void
 
@@ -930,3 +933,13 @@ final class CraftHeartRate: NSObject, CBCentralManagerDelegate, CBPeripheralDele
         }
     }
 }
+#else
+final class CraftHeartRate {
+    typealias Completion = (Result<Any, CraftHeartRateError>) -> Void
+    static let shared = CraftHeartRate()
+    var pageSink: (([String: Any]) -> Bool)?
+    func perform(method: String, args: [Any], completion: @escaping Completion) {
+        completion(.failure(CraftHeartRateError(message: "Bluetooth was not enabled when this app was built", code: "CAPABILITY_DISABLED")))
+    }
+}
+#endif

package/dist/ios/templates/CraftHybrid.swift

@@ -1115,6 +1115,8 @@ final class CraftHybridController: UITabBarController, UITabBarControllerDelegat
     private var synchronizingTabs = false
     private var accessoryModel: CraftChrome.Tab?
     private let accessoryButton = UIButton(type: .system)
+    private let accessoryBadge = UILabel()
+    private let accessoryGlass = UIVisualEffectView(effect: UIBlurEffect(style: .systemMaterial))
     private static let tabPictures = NSCache<NSURL, UIImage>()
     private var requestedTabPictures = Set<URL>()
     /// The path each native entry opened at.
@@ -1173,7 +1175,7 @@ final class CraftHybridController: UITabBarController, UITabBarControllerDelegat
         delegate = self
         if #available(iOS 18.0, *) { mode = .tabBar }
 #if compiler(>=6.2)
-        if #available(iOS 26.0, *) { tabBarMinimizeBehavior = .onScrollDown }
+        if #available(iOS 26.0, *) { tabBarMinimizeBehavior = .never }
 #endif
         accessoryButton.accessibilityIdentifier = "craft-tab-accessory"
         accessoryButton.addTarget(self, action: #selector(openTabAccessory), for: .touchUpInside)
@@ -1327,28 +1329,59 @@ final class CraftHybridController: UITabBarController, UITabBarControllerDelegat
         if let model {
             var configuration = UIButton.Configuration.plain()
             configuration.image = UIImage(systemName: model.symbol)
-            configuration.title = model.displayTitle
-            configuration.subtitle = model.badge
-            configuration.imagePadding = 8
+            configuration.title = model.iconOnly ? nil : model.displayTitle
+            configuration.subtitle = model.iconOnly ? nil : model.badge
+            configuration.imagePadding = model.iconOnly ? 0 : 8
             accessoryButton.configuration = configuration
             accessoryButton.accessibilityLabel = model.accessibilityLabel ?? model.displayTitle
             accessoryButton.accessibilityValue = model.badge
             accessoryButton.accessibilityTraits = chrome.accessorySelected ? [.button, .selected] : [.button]
         }
 #if compiler(>=6.2)
-        if #available(iOS 26.0, *) {
+        if #available(iOS 26.0, *), model?.iconOnly != true {
+            if accessoryGlass.superview != nil {
+                accessoryGlass.removeFromSuperview()
+                accessoryBadge.removeFromSuperview()
+                accessoryButton.removeFromSuperview()
+            }
             if (model == nil) != (bottomAccessory == nil) {
                 bottomAccessory = model.map { _ in UITabAccessory(contentView: accessoryButton) }
             }
             accessoryModel = model
+            for nav in stacks.values { nav.additionalSafeAreaInsets.bottom = 0 }
             return
         }
 #endif
         // Older systems have no bottom-accessory container. Keep the action
         // available above the system bar, without recreating the tab control.
-        if model != nil, accessoryButton.superview == nil { view.addSubview(accessoryButton) }
+#if compiler(>=6.2)
+        if #available(iOS 26.0, *) {
+            bottomAccessory = nil
+            accessoryGlass.effect = UIGlassEffect()
+        }
+#endif
+        if model != nil, accessoryButton.superview !== view {
+            accessoryButton.removeFromSuperview()
+            view.addSubview(accessoryGlass)
+            view.addSubview(accessoryButton)
+            view.addSubview(accessoryBadge)
+        }
         accessoryButton.isHidden = model == nil
-        accessoryButton.backgroundColor = config.resolvedBackgroundColor
+        accessoryGlass.isHidden = model == nil
+        accessoryGlass.isUserInteractionEnabled = false
+        accessoryGlass.layer.cornerRadius = 24
+        accessoryGlass.clipsToBounds = true
+        accessoryButton.backgroundColor = .clear
+        accessoryButton.layer.cornerRadius = 24
+        accessoryBadge.text = model?.badge
+        accessoryBadge.isHidden = model?.badge == nil || model?.iconOnly != true
+        accessoryBadge.font = .systemFont(ofSize: 11, weight: .bold)
+        accessoryBadge.textColor = .white
+        accessoryBadge.backgroundColor = .systemRed
+        accessoryBadge.textAlignment = .center
+        accessoryBadge.layer.cornerRadius = 9
+        accessoryBadge.clipsToBounds = true
+        accessoryBadge.isAccessibilityElement = false
         accessoryModel = model
         for nav in stacks.values { nav.additionalSafeAreaInsets.bottom = safeAreaForTabBar() }
         view.setNeedsLayout()
@@ -1362,7 +1395,7 @@ final class CraftHybridController: UITabBarController, UITabBarControllerDelegat
         super.viewDidLayoutSubviews()
         guard hybrid.controller === self else { return }
 #if compiler(>=6.2)
-        if #available(iOS 26.0, *) {
+        if #available(iOS 26.0, *), accessoryModel?.iconOnly != true {
             // UIKit already supplies the native safe area. This measurement is
             // only the web CSS contract, not another native bottom inset.
             let top = bottomAccessory.map { $0.contentView.convert($0.contentView.bounds, to: view).minY } ?? tabBar.frame.minY
@@ -1370,8 +1403,15 @@ final class CraftHybridController: UITabBarController, UITabBarControllerDelegat
             return
         }
 #endif
-        accessoryButton.frame = CGRect(x: 16, y: tabBar.frame.minY - 44, width: max(0, view.bounds.width - 32), height: 44)
-        CraftChrome.shared.layoutChanged(tabBar.isHidden ? 0 : max(0, view.bounds.maxY - tabBar.frame.minY) + (accessoryModel == nil ? 0 : 44))
+        let iconOnly = accessoryModel?.iconOnly == true
+        let height: CGFloat = iconOnly ? 48 : 44
+        let width: CGFloat = iconOnly ? 48 : max(0, view.bounds.width - 32)
+        let x = iconOnly ? view.bounds.maxX - view.safeAreaInsets.right - width - 20 : 16
+        accessoryButton.frame = CGRect(x: x, y: tabBar.frame.minY - height - (iconOnly ? 8 : 0), width: width, height: height)
+        accessoryGlass.frame = accessoryButton.frame
+        let badgeWidth = max(18, accessoryBadge.intrinsicContentSize.width + 8)
+        accessoryBadge.frame = CGRect(x: accessoryButton.frame.maxX - badgeWidth + 4, y: accessoryButton.frame.minY - 3, width: badgeWidth, height: 18)
+        CraftChrome.shared.layoutChanged(tabBar.isHidden ? 0 : max(0, view.bounds.maxY - tabBar.frame.minY) + (accessoryModel == nil ? 0 : (iconOnly ? 56 : 44)))
     }
 
     private var webAttached = false
@@ -2235,10 +2275,11 @@ final class CraftHybridController: UITabBarController, UITabBarControllerDelegat
     private func safeAreaForTabBar() -> CGFloat {
         // UIKit supplies the bar (and on iOS 26, its accessory) inset. Only
         // the older-system accessory above that bar needs an extra inset.
+        let chrome = CraftChrome.shared
+        if chrome.tabBarVisible && !chrome.tabs.isEmpty && chrome.tabAccessory?.iconOnly == true { return 56 }
 #if compiler(>=6.2)
         if #available(iOS 26.0, *) { return 0 }
 #endif
-        let chrome = CraftChrome.shared
         return chrome.tabBarVisible && !chrome.tabs.isEmpty && chrome.tabAccessory != nil ? 44 : 0
     }
 

package/dist/ios/templates/CraftLiveActivities.swift

@@ -106,6 +106,7 @@ enum CraftLiveActivities {
     /// final workout once. Never stop an unrelated HealthKit session.
     @available(iOS 16.2, *)
     @MainActor private static func startWorkout(_ activity: Activity<CraftActivityAttributes>, body: [String: Any], enabled: Bool) {
+        #if CRAFT_PERMISSION_HEALTH
         guard enabled, #available(iOS 26.0, *), let type = body["workoutType"] as? String,
               workoutOwner == nil, startingWorkout == nil,
               HKHealthStore().authorizationStatus(for: .workoutType()) == .sharingAuthorized else { return }
@@ -123,6 +124,7 @@ enum CraftLiveActivities {
                 if activity.content.state.paused == true { CraftHealth.shared.pauseWorkout { _ in } }
             }
         }
+        #endif
     }
 
     @MainActor private static func stopWorkout(_ key: String) {

package/dist/ios/templates/CraftMusic.swift

@@ -1,3 +1,4 @@
+#if CRAFT_APPLE_MUSIC
 import AVFoundation
 import Foundation
 import MediaPlayer
@@ -422,3 +423,25 @@ final class CraftFakeMusicPlayer: CraftMusicPlayer {
         DispatchQueue.main.async { self.onChange?() }
     }
 }
+#else
+import Foundation
+
+// Keep the bridge callable without linking the permission-dependent player.
+// Runtime config changes cannot turn an API back on after it was compiled out.
+struct CraftMusicError: Error {
+    let message: String
+    var code: String = "CAPABILITY_DISABLED"
+}
+
+final class CraftMusic {
+    typealias Listener = ([String: Any]) -> Void
+    static let shared = CraftMusic()
+    var authorization: String { "unsupported" }
+    func requestAuthorization(completion: @escaping (String) -> Void) { completion("unsupported") }
+    func snapshot() -> [String: Any] { ["available": false, "authorization": "unsupported"] }
+    func observe(_ listener: Listener?) {}
+    func control(_ command: String, restartAfter: Double?, completion: @escaping (Result<[String: Any], CraftMusicError>) -> Void) {
+        completion(.failure(CraftMusicError(message: "Apple Music was not enabled when this app was built")))
+    }
+}
+#endif

package/dist/ios/templates/CraftNativeActions.swift

@@ -1,6 +1,8 @@
 import Foundation
 import AuthenticationServices
+#if CRAFT_PERMISSION_BIOMETRIC
 import LocalAuthentication
+#endif
 import PassKit
 import SQLite3
 import Security
@@ -27,7 +29,9 @@ enum CraftNativeActions {
     private static let databaseQueue = DispatchQueue(label: "dev.craft.native.database")
     private static let cancellationLock = NSLock()
     private static var cancelledRequests = Set<String>()
+    #if CRAFT_PERMISSION_BIOMETRIC
     private static var biometricContexts = [String: LAContext]()
+    #endif
     private static var fetchTasks = [String: URLSessionTask]()
     private static let fetchSession: URLSession = {
         let configuration = URLSessionConfiguration.default
@@ -248,7 +252,7 @@ enum CraftNativeActions {
             }
             return
         case ("Biometrics", "isAvailable"):
-            sync = config.enableBiometric ? .success(biometricContext().canEvaluatePolicy(.deviceOwnerAuthenticationWithBiometrics, error: nil)) : failure("CAPABILITY_DISABLED", "Biometric authentication is disabled")
+            sync = config.enableBiometric ? .success(biometricAvailable()) : failure("CAPABILITY_DISABLED", "Biometric authentication is disabled")
         case ("Biometrics", "getBiometricType"):
             sync = config.enableBiometric ? .success(biometricType()) : failure("CAPABILITY_DISABLED", "Biometric authentication is disabled")
         case ("Biometrics", "authenticate"):
@@ -268,19 +272,19 @@ enum CraftNativeActions {
             // A person picks, so the bridge never times it out.
             let options = args.first as? [String: Any] ?? [:]
             DispatchQueue.main.async {
-                CraftNativeFiles.pickImage(options, cameraEnabled: config.enableCamera) { complete(requestToken, $0, completion) }
+                CraftNativeFiles.pickImage(options, cameraEnabled: config.enableCamera) { completeFile(requestToken, $0, completion) }
             }
             return
         case ("Files", "pickVideo"):
             let options = args.first as? [String: Any] ?? [:]
             DispatchQueue.main.async {
-                CraftNativeFiles.pickVideo(options) { complete(requestToken, $0, completion) }
+                CraftNativeFiles.pickVideo(options) { completeFile(requestToken, $0, completion) }
             }
             return
         case ("Files", "pickFile"):
             let options = args.first as? [String: Any] ?? [:]
             DispatchQueue.main.async {
-                CraftNativeFiles.pickFile(options) { complete(requestToken, $0, completion) }
+                CraftNativeFiles.pickFile(options) { completeFile(requestToken, $0, completion) }
             }
             return
         case ("Files", "download"):
@@ -293,7 +297,7 @@ enum CraftNativeActions {
             let data = args.count > 1 ? args[1] : nil
             let options = args.count > 2 ? args[2] as? [String: Any] ?? [:] : [:]
             DispatchQueue.global(qos: .userInitiated).async {
-                complete(requestToken, CraftNativeFiles.write(name: name, data: data, options: options), completion)
+                completeFile(requestToken, CraftNativeFiles.write(name: name, data: data, options: options), completion)
             }
             return
         case ("Files", "remove"):
@@ -699,10 +703,14 @@ enum CraftNativeActions {
     static func cancel(requestToken: String) {
         cancellationLock.lock()
         cancelledRequests.insert(requestToken)
+        #if CRAFT_PERMISSION_BIOMETRIC
         let context = biometricContexts.removeValue(forKey: requestToken)
+        #endif
         let task = fetchTasks.removeValue(forKey: requestToken)
         cancellationLock.unlock()
+        #if CRAFT_PERMISSION_BIOMETRIC
         context?.invalidate()
+        #endif
         task?.cancel()
         CraftNativePasskeys.shared.cancel(requestToken: requestToken)
     }
@@ -861,7 +869,7 @@ enum CraftNativeActions {
                 complete(requestToken, .success(CraftNativeFiles.refusedDownload(at: location, response: http)), completion)
                 return
             }
-            complete(requestToken, CraftNativeFiles.keepDownload(at: location, response: http, name: name), completion)
+            completeFile(requestToken, CraftNativeFiles.keepDownload(at: location, response: http, name: name), completion)
         }
         cancellationLock.lock()
         let alreadyCancelled = cancelledRequests.contains(requestToken)
@@ -949,16 +957,36 @@ enum CraftNativeActions {
         return url
     }
 
-    private static func complete(
+    /// Delivery boundary for newly owned files from pickers, writes and downloads.
+    static func completeFile(
         _ requestToken: String,
         _ result: Result<Any, CraftNativeActionError>,
         _ completion: @escaping (Result<Any, CraftNativeActionError>) -> Void
+    ) {
+        complete(requestToken, result, completion, onCancel: {
+            // A cancelled caller never receives these descriptors and cannot
+            // remove them itself. Only discard newly created, app-owned files;
+            // persistent media-cache results use the ordinary completion path.
+            guard case .success(let value) = result else { return }
+            let files = (value as? [[String: Any]]) ?? (value as? [String: Any]).map { [$0] } ?? []
+            for file in files {
+                if let path = file["path"] as? String { CraftNativeFiles.remove(path) }
+            }
+        })
+    }
+
+    private static func complete(
+        _ requestToken: String,
+        _ result: Result<Any, CraftNativeActionError>,
+        _ completion: @escaping (Result<Any, CraftNativeActionError>) -> Void,
+        onCancel: (() -> Void)? = nil
     ) {
         DispatchQueue.main.async {
             cancellationLock.lock()
             let cancelled = cancelledRequests.remove(requestToken) != nil
             cancellationLock.unlock()
-            if !cancelled { completion(result) }
+            if cancelled { onCancel?() }
+            else { completion(result) }
         }
     }
 
@@ -1093,13 +1121,24 @@ enum CraftNativeActions {
         }
     }
 
+    #if CRAFT_PERMISSION_BIOMETRIC
     private static func biometricContext() -> LAContext {
         let context = LAContext()
         context.localizedCancelTitle = "Cancel"
         return context
     }
+    #endif
+
+    private static func biometricAvailable() -> Bool {
+        #if CRAFT_PERMISSION_BIOMETRIC
+        return biometricContext().canEvaluatePolicy(.deviceOwnerAuthenticationWithBiometrics, error: nil)
+        #else
+        return false
+        #endif
+    }
 
     private static func biometricType() -> String {
+        #if CRAFT_PERMISSION_BIOMETRIC
         let context = biometricContext()
         _ = context.canEvaluatePolicy(.deviceOwnerAuthenticationWithBiometrics, error: nil)
         switch context.biometryType {
@@ -1107,6 +1146,9 @@ enum CraftNativeActions {
         case .touchID: return "touchId"
         default: return "none"
         }
+        #else
+        return "none"
+        #endif
     }
 
     private static func authenticate(
@@ -1115,6 +1157,7 @@ enum CraftNativeActions {
         completion: @escaping (Result<Any, CraftNativeActionError>) -> Void
     ) {
         let reason = (args.first as? String).flatMap { $0.isEmpty ? nil : $0 } ?? "Authenticate to continue"
+        #if CRAFT_PERMISSION_BIOMETRIC
         let context = biometricContext()
         cancellationLock.lock()
         biometricContexts[requestToken] = context
@@ -1126,6 +1169,9 @@ enum CraftNativeActions {
             if result { complete(requestToken, .success(true), completion) }
             else { complete(requestToken, failure("AUTHENTICATION_FAILED", error?.localizedDescription ?? "Biometric authentication failed"), completion) }
         }
+        #else
+        complete(requestToken, failure("CAPABILITY_DISABLED", "Biometrics were not enabled when this app was built"), completion)
+        #endif
     }
 
     private static func database(method: String, args: [Any]) -> Result<Any, CraftNativeActionError> {

package/dist/ios/templates/CraftNativeFiles.swift

@@ -133,6 +133,7 @@ enum CraftNativeFiles {
         }
 
         if source == "camera" {
+            #if CRAFT_PERMISSION_CAMERA
             guard cameraEnabled else {
                 done(.failure(CraftNativeActionError(code: "CAPABILITY_DISABLED", message: "The camera is disabled")))
                 return
@@ -150,6 +151,9 @@ enum CraftNativeFiles {
                 activePicker = nil
                 done(.failure(CraftNativeActionError(code: "PICKER_ERROR", message: "Unable to present the camera")))
             }
+            #else
+            done(.failure(CraftNativeActionError(code: "CAPABILITY_DISABLED", message: "The camera was not enabled when this app was built")))
+            #endif
             return
         }
         guard source == "library" else {
@@ -247,6 +251,7 @@ enum CraftNativeFiles {
         }
     }
 
+    #if CRAFT_PERMISSION_CAMERA
     private final class CameraDelegate: NSObject, UIImagePickerControllerDelegate, UINavigationControllerDelegate {
         let maxPixels: Int
         let quality: Double
@@ -287,6 +292,8 @@ enum CraftNativeFiles {
         }
     }
 
+    #endif
+
     // MARK: Picking a video
 
     /// System pickers grant access to just the selected video. Copy it while