tracelet_ios

• FEAT: iOS 14+ reduced accuracy detection — engine logs warnings when approximate location is active and tracks authorization transitions.
• FEAT: Add reducedAccuracy flag to each location fix — true when iOS grants only approximate location (~5 km).
• FEAT: Improved locationSource classification — under reduced accuracy, source is classified as cell since iOS returns coarse fixes.
• CHORE: Update tracelet_platform_interface dependency constraint to ^1.4.4.

• FEAT: Add locationSource classification to every location fix (gps, wifi, cell, unknown) based on horizontalAccuracy heuristic.
• CHORE: Update tracelet_platform_interface dependency constraint to ^1.4.3.

• FIX: activateDeadReckoning() now retries via timer instead of silently returning when lastLocation is nil.
• FIX: Add debug logging to GPS-loss timer and dead reckoning activation flow.
• CHORE: Update tracelet_platform_interface dependency constraint to ^1.4.2.

• FEAT: Dead reckoning — full IMU sensor fusion implementation (DeadReckoningEngine). Uses CMDeviceMotion (fused accelerometer + gyroscope + magnetometer) for heading and step detection. Vehicle mode with acceleration integration.
• FEAT: Auto-activation on GPS loss after configurable delay, auto-deactivation on GPS recovery or max duration.
• CHORE: Add dead reckoning config getters to ConfigManager.
• CHORE: Update tracelet_platform_interface dependency constraint to ^1.4.1.

• FEAT: Encrypted SQLite — database encryption via iOS Data Protection API (NSFileProtectionComplete).
• FEAT: Device attestation — App Attest (DCAppAttestService) integration with challenge generation, token caching, and periodic refresh (DeviceAttestor).
• FEAT: Remote config — fetch remote configuration via HTTPS with ETag caching and config-change event streaming.
• FEAT: Dead reckoning — getDeadReckoningState() stub for future accelerometer/gyroscope-based position estimation.
• FEAT: Carbon estimator — getCarbonReport() returns CO₂ estimates from tracked locations using EU average emission factors.
• CHORE: Add DeviceCheck framework dependency.
• CHORE: Update tracelet_platform_interface dependency constraint to ^1.4.0.

• FIX: getLocations() now honors SQLQuery.start and SQLQuery.end timestamp filtering.
• FIX: getCount() now accepts optional SQLQuery for time-bounded counting.
• CHORE: Update cross-package dependency constraints to ^1.3.6.

• FIX: Fix Unable to find module dependency: 'TraceletCore' Swift compiler error by consolidating SPM targets into a single module and removing invalid cross-module imports.
• FIX: Add missing AVFoundation, AudioToolbox, and Network framework linker settings in Package.swift.

• CHORE: Update tracelet_platform_interface dependency constraint to ^1.3.3.

• FIX: Bundle TraceletCore Swift source files directly inside the plugin package instead of depending on an unpublished local CocoaPod. Fixes unresolved import TraceletCore when installed from pub.dev.

• PERF: Replace Foundation UUID() with C-level uuid_generate_random/uuid_unparse_lower in LocationEngine and TraceletDatabase (I-M6).

• FIX: getPersistenceExtras() now reads distinct persistenceExtras config key with backward-compatible fallback.
• PERF: markSynced() uses chunked SQL statements (500 UUIDs/chunk) instead of unbounded placeholder lists.

• FIX: getState() always returned enabled: false on iOS — StateManager.toMap() flat-merged the config dictionary into the state dictionary, causing config keys (enabled from audit section, isMoving from motion section) to overwrite runtime state values. Config is now correctly nested under a "config" key, matching the Android implementation and the Dart State.fromMap() contract (#26).

• CHORE: Version bump for federation consistency with tracelet_platform_interface 1.2.0 (new NotificationPriority and HashAlgorithm enums).

New Features

• FEAT: Add native DeltaEncoder (Swift) for delta-compressed HTTP sync payloads — mirrors the Dart implementation exactly for platform consistency. Encodes only field deltas between consecutive locations using shortened keys (la, lo, t, s, h, a, al, b), achieving 60–80% bandwidth reduction. Uses Foundation's ISO8601DateFormatter with fractional seconds fallback for robust timestamp handling.
• FEAT: ConfigManager now reads and applies the following new configuration fields from Dart: batteryBudgetPerHour (adaptive battery budget target), enableSparseUpdates, sparseDistanceThreshold, sparseMaxIdleSeconds (app-level deduplication), enableDeadReckoning, deadReckoningActivationDelay, deadReckoningMaxDuration (inertial navigation when GPS lost), enableDeltaCompression, deltaCoordinatePrecision (HTTP delta encoding), and disableAutoSyncOnCellular (WiFi-only sync).
• FEAT: HttpSyncManager now supports disableAutoSyncOnCellular — skips auto-sync when device is on cellular network, syncing only on WiFi. Also conditionally applies DeltaEncoder.encode() to multi-location batches before HTTP upload when enableDeltaCompression is enabled, reducing upload size by 60–80%.

• FIX: handleReset() unconditionally removed geofence registrations from CLLocationManager even when stopOnTerminate: false was configured with trackingMode=1 (geofence mode). Geofences now survive the reset call so CLLocationManager continues monitoring regions after app termination (#23).

• FIX: HTTP auto-sync never triggered from automatic location tracking — onLocationInserted() was only called from the manual insertLocation handler, not from LocationEngine.persistLocationIfAllowed() (#21).
• FIX: ConfigManager.getHttpMethod() cast Int as String, silently ignoring HttpMethod.put — now correctly maps 0 → POST, 1 → PUT.
• FIX: ConfigManager.getHttpHeaders() strict [String: String] cast could drop headers when platform channel delivers [String: Any] — now coerces values to strings.
• FIX: maxBatchSize default corrected from 100 to 250 to match Dart and Android defaults.

🎉 Stable Release

• FEAT: First stable release of tracelet_ios.
• REFACTOR: Remove third-party company name references.
• All native iOS APIs are finalized and production-ready.

Performance Audit — 22 iOS issues resolved

• PERF: Cache ISO8601DateFormatter as static instance (I-C1, I-C2).
• PERF: Call UIDevice.isBatteryMonitoringEnabled once at plugin initialization (I-C3).
• PERF: Add serial stateQueue for thread-safe sync flag access (I-C4).
• PERF: Use BackgroundTaskHelper.shared.begin() with proper expiration handler (I-C5).
• PERF: Reduce accelerometer to 10 Hz and deliver on background queue (I-H1).
• PERF: Set timer tolerance to 10% for iOS energy coalescing (I-H2).
• PERF: Use SQLite transactions for batch geofence inserts (I-H3).
• PERF: Throttle DB pruning to every 100 inserts (I-H4, I-H6).
• PERF: Move JSON serialization outside DB queue lock (I-H5).
• PERF: Default pausesLocationUpdatesAutomatically to true (I-M1).
• PERF: Make activityType configurable via getActivityType() mapping (I-M2).
• PERF: Reuse URLSession — getAllTasks cancel instead of invalidateAndCancel (I-M3).
• PERF: Defer BGAppRefreshTask.setTaskCompleted until async location fix returns (I-M4).
• PERF: Find monitored region by identifier instead of creating dummy CLCircularRegion (I-M5).
• PERF: Add in-memory privacy zone cache with CRUD invalidation (I-M7).
• PERF: Add in-memory geofence cache with CRUD invalidation (I-M8).
• PERF: Lazy-init CMMotionActivityManager and CMPedometer for accelerometer-only mode (I-L1).
• PERF: Remove duplicate haversine() from GeofenceManager, call module-level function (I-L3).
• PERF: Remove dead @available(iOS 14) self-assign no-op (I-L4).
• REFACTOR: Remove trivial isMoreRestrictive() wrapper, inline isActionMoreRestrictive() call (I-L5).
• CHORE: Add CoreLocation import to ConfigManager.swift for CLActivityType.

• FIX: Revert over-aggressive allowsBackgroundLocationUpdates and significant-location guards — When In Use permission now works correctly for foreground and background tracking. iOS enforces permission at the OS level; only the killed-state entry point (autoResumeTracking) requires Always authorization.

• FIX: Add .authorizedAlways guard to autoResumeTracking() — prevents "When In Use" permission from triggering tracking after app is relaunched from killed state via significant-location-change.
• FIX: Guard allowsBackgroundLocationUpdates in configureLocationManager() and performPeriodicFix() — only set to true when Always authorization is granted.

• CHORE: Tighten tracelet_platform_interface constraint to ^0.11.2.

• FIX: Set event: "periodic" in all didUpdateLocations code paths for periodic tracking (was empty string).
• FEAT: Add canScheduleExactAlarms (returns true) and openExactAlarmSettings (returns false) method channel stubs.
• CHORE: Add NSLog diagnostic logging to startPeriodic() and performPeriodicFix().
• CHORE: Bump platform interface to 0.11.1.

• FEAT: AuditTrailManager — SHA-256 hash chain with SQLite persistence and UserDefaults chain state.
• FEAT: PrivacyZoneManager — Haversine distance-based zone evaluation with exclude, degrade, and event-only actions.
• FEAT: Privacy zones database table with CRUD operations.
• FEAT: Audit trail database table with hash chain linkage.
• FEAT: ConfigManager getters for audit and privacy zone configuration.
• CHORE: Bump tracelet_platform_interface to ^0.11.0.

• FEAT: Periodic mode — GPS-friendly interval tracking via startPeriodic(). Timer-based scheduling with background location toggling per fix.
• FEAT: ConfigManager periodic config getters for interval, accuracy, foreground service, and exact alarms.
• FIX: ConfigManager.swift escaped string literals causing Swift compilation failure.
• CHORE: Bump tracelet_platform_interface to ^0.10.0.

• FIX: Safe optional unwrap of UIBackgroundTaskIdentifier in HttpSyncManager.syncNextBatch() — fixes Swift compiler error.

• FEAT: HTTP sync retry engine — configurable retry with exponential backoff for transient 5xx, 429, and timeout failures. Defers sync on connectivity loss via NWPathMonitor. Batch continuation loop.
• FEAT: Configurable motion sensitivity — MotionDetector reads shakeThreshold, stillThreshold, stillSampleCount from ConfigManager at runtime (auto-converts m/s² to g-force).
• CHORE: Bump tracelet_platform_interface to ^0.9.0.

• FEAT: Proximity-based geofence auto-load/unload — only geofences within geofenceProximityRadius are registered with CLLocationManager, sorted by distance, capped at 20 (iOS limit). Enables monitoring thousands of geofences.
• FEAT: GeofenceManager.updateProximity() — re-evaluates which geofences to monitor on every location update, dynamically swapping region registrations as the device moves.
• FEAT: geofencesChange event fires with on/off arrays when geofences are activated/deactivated from proximity monitoring.
• FEAT: maxMonitoredGeofences config respected — caps simultaneously monitored regions below the platform limit.
• CHORE: Bump tracelet_platform_interface to ^0.8.3.

• DOCS: Improve README visuals with combined Android & iOS demo image.

• FEAT: BackgroundTaskHelper — central thread-safe utility wrapping UIApplication.beginBackgroundTask for safe background execution of native operations.
• FEAT: iOS 17+ CLBackgroundActivitySession support via BackgroundActivitySessionManager — extends background runtime for location-tracking apps.
• FEAT: iOS 18+ CLServiceSession support via ServiceSessionManager — maintains authorization state during background execution.
• PERF: Wrap LocationEngine.didUpdateLocations in background task — protects persist + dispatch chain from iOS suspension.
• PERF: Wrap HttpSyncManager.sync() in background task — protects entire HTTP upload + DB cleanup cycle.
• PERF: Wrap HeadlessRunner.dispatchEvent() engine boot in background task — ensures Dart engine starts fully before iOS reclaims resources.
• PERF: Wrap all TraceletIosPlugin lifecycle transitions (handleStop, handleReset, onStopRequested, handleScheduleStop, stopAfterElapsedTimer) in background tasks.
• FIX: preventSuspendManager.start() now called in startGeofences() — was missing, causing audio keep-alive to not activate in geofence-only mode.
• FIX: preventSuspendManager.stop() now called in all stop paths (reset, stopOnStationary, scheduleStop, stopAfterElapsed) — was only called in handleStop().
• FIX: setConfig() now toggles preventSuspendManager mid-session when preventSuspend changes.
• FIX: reset() now calls cancelStopAfterElapsedTimer() — was leaving stale timer running after reset.
• FIX: iOS 17+/18+ session managers wired into all lifecycle paths (start, stop, startGeofences, reset, scheduleStart/Stop, stopOnStationary, stopAfterElapsed).

• FEAT: OEM compatibility stubs — getSettingsHealth returns isAggressiveOem: false (iOS has no OEM power management issues), openOemSettings returns false.
• DOCS: Update README with OEM compatibility note and documentation link.
• CHORE: Bump tracelet_platform_interface to ^0.8.0.

• DOCS: Add mock location detection feature to README with platform-specific detection details.
• CHORE: Bump tracelet_platform_interface to ^0.7.1.

• FEAT: Mock location detection — isLocationMock() uses CLLocationSourceInformation (iOS 15+) to detect simulated locations.
• FEAT: Heuristic mock detection (level 2) — timestamp drift check (> 10s between location timestamp and system time = suspicious).
• FEAT: buildLocationMap() includes mock flag and mockHeuristics metadata map (timestampDriftMs, platformFlagMock).
• FEAT: Native-level mock rejection — when rejectMockLocations is enabled, drops mocked locations before sending to Dart and fires ProviderChangeEvent.mockLocationsDetected.
• FEAT: ConfigManager.getMockDetectionLevel() and getRejectMockLocations() getters.
• CHORE: Bump tracelet_platform_interface to ^0.7.0.

• REFACTOR: Remove 6 dead ConfigManager methods for filtering migrated to Dart in 0.6.0 (getDisableElasticity, getElasticityMultiplier, getFilterPolicy, getMaxImpliedSpeed, getTrackingAccuracyThreshold, getUseKalmanFilter).
• REFACTOR: Remove dead EventDispatcher.sendTrip() and "trip" channel registration — trip events now from Dart TripManager.
• CHORE: Bump tracelet_platform_interface to ^0.6.1.

• REFACTOR: Remove duplicate location filtering from LocationEngine.didUpdateLocations() — elasticity, distance filter, accuracy filter, and speed filter now handled by shared Dart LocationProcessor.
• REFACTOR: Replace GeofenceManager.evaluateHighAccuracyProximity() with no-op stub — proximity evaluation moved to shared Dart GeofenceEvaluator.
• CHORE: Bump tracelet_platform_interface to ^0.6.0.

• FIX: onSchedule event now sends full state map (via stateManager.toMap()) instead of partial ["state": "on", "enabled": true] — fixes State.fromMap() crash on schedule events.

• FIX: Heartbeat event now wraps location data in {"location": ...} to match HeartbeatEvent.fromMap() — fixes heartbeat always returning zero coordinates.
• FIX: Heartbeat falls back to last known location (via buildLocationMap()) when getCurrentPosition returns null.

• CHORE: Bump tracelet_platform_interface to ^0.5.3.

• FEAT: Accelerometer-only motion detection mode — when disableMotionActivityUpdates is true, uses CMMotionManager raw accelerometer for permission-free stationary↔moving detection (no NSMotionUsageDescription required).
• FEAT: getMotionAuthorizationStatus() / requestMotionPermission() return 3 (granted) immediately in accelerometer-only mode — no OS dialog shown.
• PERF: Reuse shared CMMotionManager instance for sensor queries instead of creating throwaway instances.
• FIX: Auto-fallback to accelerometer-only when CMMotionActivityManager.isActivityAvailable() returns false.

• DOCS: Rewrite README with proper description, setup guide link, and related packages table.

• CHORE: Bump tracelet_platform_interface to ^0.5.0.
• CHORE: Bump version to 0.5.0.

• FEAT: getMotionPermissionStatus() / requestMotionPermission() — CMMotionActivityManager authorization check.
• FIX: Speed always zero in motionchange events — track lastEffectiveSpeed in LocationEngine.
• FIX: "Upgrade to Always" dialog not appearing — fix handleStart isMoving initialization.
• FIX: MotionDetector motion state bugs — proper accelerometer + activity recognition lifecycle.
• CHORE: Bump tracelet_platform_interface to ^0.4.0.

• FEAT: One-shot location via getCurrentPosition() with persist, samples, maximumAge, and extras parameters.
• FEAT: Multi-sample collection with distanceFilter = kCLDistanceFilterNone and DispatchQueue timeout guard.
• FEAT: getLastKnownLocation() — prefers own cached location, falls back to CLLocationManager.location.
• FEAT: ForegroundServiceConfig.enabled support.
• FIX: Add CLAuthorizationStatus guard in getCurrentPosition() — returns nil if not authorized instead of hanging.
• FIX: Single-sample path now sets desiredAccuracy = kCLLocationAccuracyBest before requestLocation().
• BREAKING: Requires tracelet_platform_interface: ^0.3.0.

• Fix LICENSE file format for proper SPDX detection on pub.dev.

• Fix ConfigManager.setConfig() — flatten nested section sub-maps (geo, app, http, etc.) sent by Dart before processing. Fixes all user config values being silently ignored in favor of defaults.

• Fix duplicate keys in ConfigManager.defaultConfig() dictionary literal causing runtime crash.

• Version bump for coordinated release.

• Add Swift Package Manager support.
• Fix podspec homepage URL.
• Fix podspec source_files and resource_bundles paths for SPM layout.
• Add SPDX license: Apache-2.0 identifier for pub.dev scoring.

• Initial release.
• CLLocationManager-based location tracking.
• CoreMotion activity recognition.
• SQLite3 persistence.
• HTTP auto-sync with URLSession.
• CLCircularRegion geofencing.
• Headless FlutterEngine execution.
• BGTaskScheduler integration.
• Significant-change monitoring support.