chore: TSLocationManager 4.0.31 (url + checksum)

Author: christocracy

CHANGELOG.md

@@ -1,5 +1,40 @@
 # CHANGELOG
 
+## 4.0.31 — 2026-04-02
+- Update panel images
+- docs: rewrite README with setup, build, test, publish sections
+- remove Pods from version control
+- Migrate isPowerSaveMode -> new DeviceSettings class
+- feat(State): add isFirstBoot property
+- chore: pod install (regenerate Pods from Podfile.lock)
+- feat(Geofence): add entryState, stateUpdatedAt, hits from TSGeofence
+- refactor(Geofence): remove unnecessary dict initializer
+- Revert "feat(Geofence): make dict initializer public"
+- feat(Geofence): make dict initializer public
+- feat(GeofenceEvent): add geofence: BGGeo.Geofence property; add dict init to Geofence
+- feat(LocationEvent): add GeofenceTrigger nested struct and mock property
+- Add typed State struct, remove getStationaryLocation()
+- Rename ConnectivityChangeEvent.hasConnection → isConnected
+- Align Swift API naming with Kotlin for cross-platform parity
+- Type GeofenceEvent.location as LocationEvent instead of raw dictionary
+- Add age and extras properties to LocationEvent
+- Add uuid property to LocationEvent
+- Add resetOdometer(), type authorization returns with CoreLocation enums
+- Move DocsExamplesCompileTest to DemoApp2Tests target
+- Add query params to Logger.getLog/emailLog, add uploadLog method
+- Update CHANGELOG for 4.0.30
+- Remove dead BackgroundGeolocationPlugin class name check
+- Add retry to asset checksum verification in publish-ios.sh
+- Update CHANGELOG for 4.0.29
+- Set framework IPHONEOS_DEPLOYMENT_TARGET to 13.0 to match podspec
+- Update CHANGELOG for 4.0.27
+- Remove CocoaPods Swift subspec -- SwiftInterface is SPM-only
+- Add --local flag to build-ios.sh for local SPM testing
+- Don't commit version wtih --bump and --dry-run
+- Update CHANGELOG for 4.0.24
+- Clean stale entries from Unreleased section
+- Add changelog generation to publish script
+
 ## 4.0.30 — 2026-03-26
 - Fix Capacitor validation
 - Add retry to asset checksum verification in publish-ios.sh

Package.swift

@@ -25,8 +25,8 @@ let package = Package(
     targets: [
         .binaryTarget(
             name: "TSLocationManager",
-            url: "https://github.com/transistorsoft/native-background-geolocation/releases/download/4.0.30/TSLocationManager.xcframework.zip",
-            checksum: "d1add09b4f2fa3c933b16cb2b0277a18bae2704210f15a2e7f5c18b2a7a9994a"
+            url: "https://github.com/transistorsoft/native-background-geolocation/releases/download/4.0.31/TSLocationManager.xcframework.zip",
+            checksum: "78c0401b40e2e7fa17b0df25a8fbfc4375f2e68f4d468e62f6a33959cd752d70"
         ),
 
         // Swift overlay that reexports the binary + TSBackgroundFetch

Sources/BackgroundGeolocation/SwiftInterface/App.swift

@@ -12,16 +12,12 @@ extension BGGeo {
 
         init() {}
 
-        public func createBackgroundTask() -> UIBackgroundTaskIdentifier {
+        public func startBackgroundTask() -> UIBackgroundTaskIdentifier {
             manager.createBackgroundTask()
         }
 
         public func stopBackgroundTask(_ taskId: UIBackgroundTaskIdentifier) {
             manager.stopBackgroundTask(taskId)
         }
-
-        public var isPowerSaveMode: Bool {
-            manager.isPowerSaveMode()
-        }
     }
 }

Sources/BackgroundGeolocation/SwiftInterface/Authorization.swift

@@ -4,6 +4,7 @@
 //
 
 import Foundation
+import CoreLocation
 import TSLocationManager
 
 extension BGGeo {
@@ -16,10 +17,13 @@ extension BGGeo {
             BGGeo.ProviderChangeEvent(manager.getProviderState())
         }
 
-        public func requestPermission() async throws -> Int {
+        public func requestPermission() async throws -> CLAuthorizationStatus {
             try await withCheckedThrowingContinuation { continuation in
                 manager.requestPermission(
-                    { status in continuation.resume(returning: status.intValue) },
+                    { status in
+                        let authStatus = CLAuthorizationStatus(rawValue: status.int32Value) ?? .notDetermined
+                        continuation.resume(returning: authStatus)
+                    },
                     failure: { status in
                         continuation.resume(throwing: NSError(
                             domain: "BGGeo", code: status.intValue,
@@ -30,10 +34,13 @@ extension BGGeo {
             }
         }
 
-        public func requestTemporaryFullAccuracy(purpose: String) async throws -> Int {
+        public func requestTemporaryFullAccuracy(purpose: String) async throws -> CLAccuracyAuthorization {
             try await withCheckedThrowingContinuation { continuation in
                 manager.requestTemporaryFullAccuracy(purpose,
-                    success: { continuation.resume(returning: Int($0)) },
+                    success: {
+                        let accuracy = CLAccuracyAuthorization(rawValue: Int($0)) ?? .reducedAccuracy
+                        continuation.resume(returning: accuracy)
+                    },
                     failure: { continuation.resume(throwing: $0) }
                 )
             }

Sources/BackgroundGeolocation/SwiftInterface/BGGeo.swift

@@ -35,7 +35,7 @@ public class BGGeo {
     ///   - transistorAuthorizationToken: Optional token from ``TransistorAuthorizationService``.
     ///            When provided, auto-configures `http.url` and `authorization` for the Transistor demo server.
     ///            Always applied regardless of `reset`, since tokens may refresh between launches.
-    ///   - configure: Closure to set config properties. Executed inside a `batchUpdate`.
+    ///   - configure: Closure to set config properties. Executed inside a `config.edit`.
     ///
     /// ```swift
     /// // Standard: apply config every launch
@@ -61,20 +61,20 @@ public class BGGeo {
 
         if tsConfig.isFirstBoot() {
             // First install: always apply config regardless of reset flag
-            config.batchUpdate(configure)
+            config.edit(configure)
         } else if reset {
             // Subsequent launch + reset: wipe persisted config, re-apply from closure
             tsConfig.resetConfig(true)
-            config.batchUpdate(configure)
+            config.edit(configure)
         }
         // else: subsequent launch + reset:false → skip closure, use persisted config
 
         // Token rewrite: always applies (even when reset:false skips the closure),
         // since tokens may refresh between launches.
         if let token {
-            config.batchUpdate { config in
+            config.edit { config in
                 config.http.url = token.apiUrl
-                config.authorization.strategy = "jwt"
+                config.authorization.strategy = .jwt
                 config.authorization.accessToken = token.accessToken
                 config.authorization.refreshToken = token.refreshToken
                 config.authorization.refreshUrl = token.refreshUrl
@@ -119,8 +119,23 @@ public class BGGeo {
         manager.changePace(isMoving)
     }
 
-    public var enabled: Bool {
-        manager.enabled
+    // MARK: - State
+
+    /// Read-only snapshot of the SDK's current runtime state.
+    public var state: State {
+        let tsConfig = TSConfig.sharedInstance()
+        let odometer = TSOdometer.sharedInstance()
+        return State(
+            enabled: tsConfig.enabled,
+            isMoving: tsConfig.isMoving,
+            trackingMode: TrackingMode(tsConfig.trackingMode),
+            odometer: odometer.odometer,
+            odometerError: odometer.odometerError,
+            schedulerEnabled: tsConfig.schedulerEnabled,
+            didDeviceReboot: tsConfig.didDeviceReboot(),
+            didLaunchInBackground: tsConfig.didLaunchInBackground,
+            isFirstBoot: tsConfig.isFirstBoot()
+        )
     }
 
     // MARK: - Geolocation
@@ -178,8 +193,20 @@ public class BGGeo {
         }
     }
 
-    public var odometer: CLLocationDistance {
-        manager.getOdometer()
+    /// Reset the odometer to zero.
+    ///
+    /// Convenience for `setOdometer(0)`.
+    public func resetOdometer(
+        timeout: TimeInterval = 10,
+        desiredAccuracy: CLLocationAccuracy = kCLLocationAccuracyBest,
+        maximumAge: Int = 5000,
+        samples: Int = 3,
+        persist: Bool = true,
+        extras: [String: Any]? = nil
+    ) async throws -> LocationEvent {
+        try await setOdometer(0, timeout: timeout, desiredAccuracy: desiredAccuracy,
+                              maximumAge: maximumAge, samples: samples,
+                              persist: persist, extras: extras)
     }
 
     public func watchPosition(
@@ -205,10 +232,6 @@ public class BGGeo {
         manager.stopWatchPosition(watchId)
     }
 
-    public func getStationaryLocation() -> [String: Any]? {
-        manager.getStationaryLocation() as? [String: Any]
-    }
-
     // MARK: - Event Listeners
 
     @discardableResult

Sources/BackgroundGeolocation/SwiftInterface/Config/AuthorizationConfig.swift

@@ -7,13 +7,23 @@ import Foundation
 import TSLocationManager
 
 extension BGGeo {
+    public enum AuthorizationStrategy: String {
+        case jwt = "JWT"
+        case sas = "SAS"
+
+        init?(_ value: String?) {
+            guard let value else { return nil }
+            self.init(rawValue: value.uppercased())
+        }
+    }
+
     public class AuthorizationConfig {
         private let module: TSAuthorizationConfig
         init(_ module: TSAuthorizationConfig) { self.module = module }
 
-        public var strategy: String? {
-            get { module.strategy }
-            set { module.strategy = newValue }
+        public var strategy: AuthorizationStrategy? {
+            get { AuthorizationStrategy(module.strategy) }
+            set { module.strategy = newValue?.rawValue }
         }
         public var accessToken: String? {
             get { module.accessToken }

Sources/BackgroundGeolocation/SwiftInterface/Config/Config.swift

@@ -38,21 +38,13 @@ extension BGGeo {
             logger = BGGeo.LoggerConfig(c.logger)
         }
 
-        // MARK: - State
-
-        public var enabled: Bool { tsConfig.enabled }
-        public var isMoving: Bool { tsConfig.isMoving }
-        public var trackingMode: TrackingMode { TrackingMode(tsConfig.trackingMode) }
-        public var schedulerEnabled: Bool { tsConfig.schedulerEnabled }
-
         // MARK: - Query
 
-        public var isLocationTrackingMode: Bool { tsConfig.isLocationTrackingMode() }
         public var isFirstBoot: Bool { tsConfig.isFirstBoot() }
 
-        // MARK: - Batch Update
+        // MARK: - Edit
 
-        public func batchUpdate(_ block: @escaping (Config) -> Void) {
+        public func edit(_ block: @escaping (Config) -> Void) {
             tsConfig.batchUpdate { _ in block(self) }
         }
 

Sources/BackgroundGeolocation/SwiftInterface/DeviceSettings.swift

@@ -0,0 +1,21 @@
+//
+//  DeviceSettings.swift
+//  TSLocationManager
+//
+
+import TSLocationManager
+
+extension BGGeo {
+    public class DeviceSettings {
+        private let manager = BackgroundGeolocation.sharedInstance()
+
+        init() {}
+
+        /// Returns `true` if the device is currently in Low Power Mode.
+        ///
+        /// Low Power Mode is a device-wide setting, independent of any individual app.
+        public var isPowerSaveMode: Bool {
+            manager.isPowerSaveMode()
+        }
+    }
+}

Sources/BackgroundGeolocation/SwiftInterface/Events/GeofenceEvent.swift

@@ -15,40 +15,35 @@ extension BGGeo {
         public let identifier: String
         public let action: String
         public let timestamp: Date
-        public let location: [String: Any]
+        public let location: BGGeo.LocationEvent
+        public let geofence: BGGeo.Geofence
         public let extras: [String: Any]?
 
-        // Geofence center & radius (MEC for polygons)
-        public let latitude: Double
-        public let longitude: Double
-        public let radius: Double
-        public var center: CLLocationCoordinate2D {
-            CLLocationCoordinate2D(latitude: latitude, longitude: longitude)
-        }
-
-        // Trigger coordinate extracted from location dict
+        // Trigger coordinate extracted from location coords
         public let triggerCoordinate: CLLocationCoordinate2D?
         public let triggerHeading: Double?
 
         public init(_ obj: TSGeofenceEvent) {
             self.identifier = obj.identifier
             self.action = obj.action
             self.timestamp = obj.timestamp
-            self.location = obj.location as? [String: Any] ?? [:]
+            let locationDict = obj.location as? [String: Any] ?? [:]
+            let coordsDict = locationDict["coords"] as? [String: Any]
+            let clLocation = CLLocation(
+                latitude: (coordsDict?["latitude"] as? NSNumber)?.doubleValue ?? 0,
+                longitude: (coordsDict?["longitude"] as? NSNumber)?.doubleValue ?? 0
+            )
+            self.location = BGGeo.LocationEvent(TSLocationEvent(locationDictionary: obj.location, location: clLocation))
+            self.geofence = BGGeo.Geofence(obj.geofence)
             self.extras = obj.extras as? [String: Any]
 
-            self.latitude = obj.geofence.latitude
-            self.longitude = obj.geofence.longitude
-            self.radius = obj.geofence.radius
-
-            let coords = self.location["coords"] as? [String: Any]
-            if let lat = coords?["latitude"] as? Double,
-               let lng = coords?["longitude"] as? Double {
+            if let lat = coordsDict?["latitude"] as? Double,
+               let lng = coordsDict?["longitude"] as? Double {
                 self.triggerCoordinate = CLLocationCoordinate2D(latitude: lat, longitude: lng)
             } else {
                 self.triggerCoordinate = nil
             }
-            let heading = (coords?["heading"] as? NSNumber)?.doubleValue
+            let heading = (coordsDict?["heading"] as? NSNumber)?.doubleValue
             self.triggerHeading = (heading != nil && heading! >= 0) ? heading : nil
         }
     }

Sources/BackgroundGeolocation/SwiftInterface/Events/LocationEvent.swift

@@ -36,28 +36,44 @@ extension BGGeo {
             public let confidence: Int?
         }
 
+        public struct GeofenceTrigger {
+            public let identifier: String?
+            public let action: String?
+            public let timestamp: String?
+            public let extras: [String: Any]?
+        }
+
         public let timestamp: Date?
         public let timestampString: String
 
         public let data: [String: Any]
         public let location: CLLocation
+        public let uuid: String?
         public let event: String?
         public let isMoving: Bool
+        public let mock: Bool?
         public let sample: Bool
+        public let age: Int?
+        public let extras: [String: Any]?
         public let odometer: Double?
         public let odometerError: Double?
 
         public let coords: Coords?
         public let battery: Battery?
         public let activity: Activity?
+        public let geofence: GeofenceTrigger?
 
         public init(_ obj: TSLocationEvent) {
             self.timestampString = obj.timestamp
             self.timestamp = ISO8601DateFormatter.fullParsing.date(from: obj.timestamp)
             self.data = obj.toDictionary() as? [String: Any] ?? [:]
             self.location = obj.location
+            self.uuid = data["uuid"] as? String
             self.isMoving = obj.isMoving
+            self.mock = data["mock"] as? Bool
             self.sample = data.keys.contains("sample")
+            self.age = data.intOpt("age")
+            self.extras = data["extras"] as? [String: Any]
             self.odometer = data["odometer"] as? Double
             self.odometerError = data["odometer_error"] as? Double
             self.event = obj.event
@@ -97,6 +113,17 @@ extension BGGeo {
             } else {
                 activity = nil
             }
+
+            if let g = data["geofence"] as? [String: Any] {
+                geofence = GeofenceTrigger(
+                    identifier: g["identifier"] as? String,
+                    action:     g["action"] as? String,
+                    timestamp:  g["timestamp"] as? String,
+                    extras:     g["extras"] as? [String: Any]
+                )
+            } else {
+                geofence = nil
+            }
         }
     }
 }