@wayq/beekon-rn 0.0.1 → 0.0.5

package/ios/Frameworks/BeekonKit.xcframework/ios-arm64_x86_64-simulator/BeekonKit.framework/Modules/BeekonKit.swiftmodule/x86_64-apple-ios-simulator.swiftinterface

@@ -0,0 +1,236 @@
+// swift-interface-format-version: 1.0
+// swift-compiler-version: Apple Swift version 6.3.1 (swiftlang-6.3.1.1.2 clang-2100.0.123.102)
+// swift-module-flags: -target x86_64-apple-ios17.0-simulator -enable-objc-interop -enable-library-evolution -swift-version 6 -O -enable-experimental-feature DebugDescriptionMacro -module-name BeekonKit -package-name beekon_ios
+// swift-module-flags-ignorable: -no-verify-emitted-module-interface -no-verify-emitted-module-interface -formal-cxx-interoperability-mode=off -interface-compiler-version 6.3.1
+@preconcurrency import BackgroundTasks
+import Compression
+@preconcurrency import CoreLocation
+import CoreMotion
+import Darwin
+import Foundation
+import Foundation/*.Bundle*/
+import Foundation/*.ProcessInfo*/
+import Foundation/*.URL*/
+import Network
+import Swift
+@preconcurrency import UIKit
+import _Concurrency
+import _StringProcessing
+import _SwiftConcurrencyShims
+import os
+public enum AccuracyMode : Swift.String, Swift.Sendable, Swift.Equatable, Swift.Hashable, Swift.Codable {
+  case high
+  case balanced
+  case low
+  public init?(rawValue: Swift.String)
+  public typealias RawValue = Swift.String
+  public var rawValue: Swift.String {
+    get
+  }
+}
+public enum ActivityType : Swift.String, Swift.Sendable, Swift.Equatable, Swift.Hashable, Swift.Codable {
+  case stationary
+  case walking
+  case running
+  case cycling
+  case automotive
+  case unknown
+  public init?(rawValue: Swift.String)
+  public typealias RawValue = Swift.String
+  public var rawValue: Swift.String {
+    get
+  }
+}
+@_hasMissingDesignatedInitializers public actor Beekon {
+  public static let shared: BeekonKit.Beekon
+  nonisolated public static func registerBackgroundTasks()
+  public func configure(_ config: BeekonKit.BeekonConfig) async
+  public func start() async
+  public func stop() async
+  public func resumeIfNeeded() async
+  public func getLocations(from: Foundation.Date, to: Foundation.Date) async throws -> [BeekonKit.Location]
+  public func deleteLocations(before: Foundation.Date?) async throws -> Swift.Int
+  public func pendingUploadCount() async throws -> Swift.Int
+  public func sync()
+  public func setExtras(_ extras: [Swift.String : Swift.String])
+  public func addGeofences(_ geofences: [BeekonKit.BeekonGeofence]) async throws
+  public func removeGeofences(ids: [Swift.String]) async
+  public func listGeofences() async -> [BeekonKit.BeekonGeofence]
+  public var locations: _Concurrency.AsyncStream<BeekonKit.Location> {
+    get
+  }
+  public var state: _Concurrency.AsyncStream<BeekonKit.BeekonState> {
+    get
+  }
+  public var geofenceEvents: _Concurrency.AsyncStream<BeekonKit.GeofenceEvent> {
+    get
+  }
+  public var syncStatus: _Concurrency.AsyncStream<BeekonKit.SyncStatus> {
+    get
+  }
+  @objc deinit
+  @available(iOS 13.0, tvOS 13.0, watchOS 6.0, macOS 10.15, *)
+  @_semantics("defaultActor") nonisolated final public var unownedExecutor: _Concurrency.UnownedSerialExecutor {
+    get
+  }
+}
+public struct BeekonConfig : Swift.Sendable, Swift.Equatable, Swift.Codable {
+  public var minTimeBetweenLocationsSeconds: Foundation.TimeInterval
+  public var minDistanceBetweenLocationsMeters: Swift.Double
+  public var accuracyMode: BeekonKit.AccuracyMode
+  public var whenStationary: BeekonKit.StationaryMode
+  public var stationaryRadiusMeters: Swift.Double
+  public var detectActivity: Swift.Bool
+  public var sync: BeekonKit.SyncConfig?
+  public static let minimumLocationIntervalSeconds: Swift.Double
+  public static let minimumStationaryRadiusMeters: Swift.Double
+  public init(minTimeBetweenLocationsSeconds: Foundation.TimeInterval = 30, minDistanceBetweenLocationsMeters: Swift.Double = 100, accuracyMode: BeekonKit.AccuracyMode = .balanced, whenStationary: BeekonKit.StationaryMode = .pause, stationaryRadiusMeters: Swift.Double = 5, detectActivity: Swift.Bool = false, sync: BeekonKit.SyncConfig? = nil)
+  public init(from decoder: any Swift.Decoder) throws
+  public func encode(to encoder: any Swift.Encoder) throws
+  public static func == (a: BeekonKit.BeekonConfig, b: BeekonKit.BeekonConfig) -> Swift.Bool
+}
+public struct SyncConfig : Swift.Sendable, Swift.Equatable, Swift.Codable {
+  public var url: Foundation.URL
+  public var headers: [Swift.String : Swift.String]
+  public var intervalSeconds: Foundation.TimeInterval
+  public var batchSize: Swift.Int
+  public init(url: Foundation.URL, headers: [Swift.String : Swift.String] = [:], intervalSeconds: Foundation.TimeInterval = 300, batchSize: Swift.Int = 100)
+  public static func == (a: BeekonKit.SyncConfig, b: BeekonKit.SyncConfig) -> Swift.Bool
+  public func encode(to encoder: any Swift.Encoder) throws
+  public init(from decoder: any Swift.Decoder) throws
+}
+public enum BeekonError : Swift.Error, Swift.Sendable, Swift.Equatable {
+  case invalidGeofence(reason: Swift.String)
+  case storage(reason: Swift.String)
+  public static func == (a: BeekonKit.BeekonError, b: BeekonKit.BeekonError) -> Swift.Bool
+}
+public struct BeekonGeofence : Swift.Sendable, Swift.Equatable, Swift.Codable {
+  public var id: Swift.String
+  public var latitude: Swift.Double
+  public var longitude: Swift.Double
+  public var radiusMeters: Swift.Double
+  public var notifyOnEntry: Swift.Bool
+  public var notifyOnExit: Swift.Bool
+  public init(id: Swift.String, latitude: Swift.Double, longitude: Swift.Double, radiusMeters: Swift.Double, notifyOnEntry: Swift.Bool = true, notifyOnExit: Swift.Bool = true)
+  public static func == (a: BeekonKit.BeekonGeofence, b: BeekonKit.BeekonGeofence) -> Swift.Bool
+  public func encode(to encoder: any Swift.Encoder) throws
+  public init(from decoder: any Swift.Decoder) throws
+}
+public enum BeekonState : Swift.Sendable, Swift.Equatable {
+  case idle
+  case tracking
+  case stopped(BeekonKit.StopReason)
+  public static func == (a: BeekonKit.BeekonState, b: BeekonKit.BeekonState) -> Swift.Bool
+}
+public enum StopReason : Swift.String, Swift.Sendable, Swift.Equatable, Swift.Hashable, Swift.Codable {
+  case user
+  case permissionDenied
+  case locationServicesDisabled
+  case locationUnavailable
+  case system
+  public init?(rawValue: Swift.String)
+  public typealias RawValue = Swift.String
+  public var rawValue: Swift.String {
+    get
+  }
+}
+public struct GeofenceEvent : Swift.Sendable, Swift.Equatable {
+  public let id: Swift.String
+  public let geofenceId: Swift.String
+  public let type: BeekonKit.Transition
+  public let timestamp: Foundation.Date
+  public init(id: Swift.String, geofenceId: Swift.String, type: BeekonKit.Transition, timestamp: Foundation.Date)
+  public static func == (a: BeekonKit.GeofenceEvent, b: BeekonKit.GeofenceEvent) -> Swift.Bool
+}
+public struct Location : Swift.Sendable, Swift.Equatable {
+  public let id: Swift.String
+  public let latitude: Swift.Double
+  public let longitude: Swift.Double
+  public let timestamp: Foundation.Date
+  public let accuracy: Swift.Double?
+  public let speed: Swift.Double?
+  public let bearing: Swift.Double?
+  public let altitude: Swift.Double?
+  public let quality: BeekonKit.LocationQuality
+  public let trigger: BeekonKit.LocationTrigger
+  public let motion: BeekonKit.MotionState
+  public let activity: BeekonKit.ActivityType?
+  public let isMock: Swift.Bool
+  public init(id: Swift.String, latitude: Swift.Double, longitude: Swift.Double, timestamp: Foundation.Date, accuracy: Swift.Double? = nil, speed: Swift.Double? = nil, bearing: Swift.Double? = nil, altitude: Swift.Double? = nil, quality: BeekonKit.LocationQuality = .ok, trigger: BeekonKit.LocationTrigger = .interval, motion: BeekonKit.MotionState = .unknown, activity: BeekonKit.ActivityType? = nil, isMock: Swift.Bool = false)
+  public static func == (a: BeekonKit.Location, b: BeekonKit.Location) -> Swift.Bool
+}
+public enum LocationQuality : Swift.String, Swift.Sendable, Swift.Equatable, Swift.Hashable, Swift.Codable {
+  case ok
+  case lowAccuracy
+  case implausibleSpeed
+  public init?(rawValue: Swift.String)
+  public typealias RawValue = Swift.String
+  public var rawValue: Swift.String {
+    get
+  }
+}
+public enum LocationTrigger : Swift.String, Swift.Sendable, Swift.Equatable, Swift.Hashable, Swift.Codable {
+  case interval
+  case motion
+  case checkIn
+  case geofence
+  case manual
+  public init?(rawValue: Swift.String)
+  public typealias RawValue = Swift.String
+  public var rawValue: Swift.String {
+    get
+  }
+}
+public enum MotionState : Swift.String, Swift.Sendable, Swift.Equatable, Swift.Hashable, Swift.Codable {
+  case moving
+  case stationary
+  case unknown
+  public init?(rawValue: Swift.String)
+  public typealias RawValue = Swift.String
+  public var rawValue: Swift.String {
+    get
+  }
+}
+public enum StationaryMode : Swift.String, Swift.Sendable, Swift.Equatable, Swift.Hashable, Swift.Codable {
+  case keepTracking
+  case pause
+  case pauseWithCheckIns
+  public init?(rawValue: Swift.String)
+  public typealias RawValue = Swift.String
+  public var rawValue: Swift.String {
+    get
+  }
+}
+public enum SyncStatus : Swift.Sendable, Swift.Equatable {
+  case idle
+  case pending
+  case failed(BeekonKit.SyncFailure)
+  public static func == (a: BeekonKit.SyncStatus, b: BeekonKit.SyncStatus) -> Swift.Bool
+}
+public enum SyncFailure : Swift.String, Swift.Sendable, Swift.Equatable, Swift.Hashable, Swift.Codable {
+  case auth
+  case rejected
+  public init?(rawValue: Swift.String)
+  public typealias RawValue = Swift.String
+  public var rawValue: Swift.String {
+    get
+  }
+}
+public enum Transition : Swift.String, Swift.Sendable, Swift.Equatable, Swift.Hashable, Swift.Codable {
+  case enter
+  case exit
+  public init?(rawValue: Swift.String)
+  public typealias RawValue = Swift.String
+  public var rawValue: Swift.String {
+    get
+  }
+}
+extension BeekonKit.AccuracyMode : Swift.RawRepresentable {}
+extension BeekonKit.ActivityType : Swift.RawRepresentable {}
+extension BeekonKit.StopReason : Swift.RawRepresentable {}
+extension BeekonKit.LocationQuality : Swift.RawRepresentable {}
+extension BeekonKit.LocationTrigger : Swift.RawRepresentable {}
+extension BeekonKit.MotionState : Swift.RawRepresentable {}
+extension BeekonKit.StationaryMode : Swift.RawRepresentable {}
+extension BeekonKit.SyncFailure : Swift.RawRepresentable {}
+extension BeekonKit.Transition : Swift.RawRepresentable {}

package/ios/Frameworks/BeekonKit.xcframework/ios-arm64_x86_64-simulator/BeekonKit.framework/PrivacyInfo.xcprivacy

@@ -48,7 +48,7 @@
     <!--
       Required-Reason APIs we use:
         - UserDefaults (CA92.1): StateHolder/TrackingPersistence stores the
-          last-known tracking config in the com.wayq.beekon UserDefaults suite
+          last-known tracking config in the in.wayq.beekon UserDefaults suite
           so SLC-driven relaunches can auto-restore tracking.
         - File timestamp (3B52.1): GRDB queries timestamps on its own SQLite
           database file inside the host app's container.

package/ios/Frameworks/BeekonKit.xcframework/ios-arm64_x86_64-simulator/BeekonKit.framework/_CodeSignature/CodeResources

@@ -6,23 +6,11 @@
 	<dict>
 		<key>Info.plist</key>
 		<data>
-		w9rsPHfS6nhyFAFD48jpWHGzYuc=
-		</data>
-		<key>PrivacyInfo.xcprivacy</key>
-		<data>
-		+Hzj9e+o3dYoDboCDA7ofM2a0kc=
+		O1peKZ+DrU3WFwjRILn7rOtdq/4=
 		</data>
 	</dict>
 	<key>files2</key>
-	<dict>
-		<key>PrivacyInfo.xcprivacy</key>
-		<dict>
-			<key>hash2</key>
-			<data>
-			E3plr2RiT1CPWdLg5VfDUw1k7yShykpszuDqfKG4YYw=
-			</data>
-		</dict>
-	</dict>
+	<dict/>
 	<key>rules</key>
 	<dict>
 		<key>^.*</key>

package/lib/module/NativeBeekonRn.js

@@ -1,16 +1,31 @@
 "use strict";
 
 /**
- * Codegen TurboModule spec — DO NOT export Wire* types from `src/index.tsx`.
- * The public TS API in `src/beekon.ts` and `src/types/` is what consumers use;
- * mappers in `src/internal/mappers.ts` convert between the two.
+ * Codegen TurboModule spec — the single source React Native's Codegen reads to
+ * generate the native interface. **DO NOT export Wire* types from
+ * `src/index.tsx`.** The public TS API in `src/beekon.ts` and `src/types/` is
+ * what consumers use; mappers in `src/internal/mappers.ts` convert between the
+ * two.
  *
- * Wire types are flat (primitives + nested flat objects) because Codegen's
- * TS-to-Kotlin/ObjC type derivation has limited support for unions and
- * recursive structures. State variants are encoded as a `type` discriminator
- * string with sibling fields nullable per variant.
+ * Wire types are deliberately **flat** (primitives + flat nested objects +
+ * arrays) because Codegen's TS→Kotlin/ObjC derivation has no support for unions
+ * or recursive structures:
+ *
+ * - **Enums travel as plain `string`** (e.g. `accuracyMode`, `quality`); the
+ *   mappers translate to/from the public string-literal unions with a defensive
+ *   fallback, so an unknown value never crashes a subscriber.
+ * - **Sum types** (`WireState`, `WireSyncStatus`) are a `type` discriminator
+ *   string plus sibling fields nullable per variant.
+ * - **String maps** (`headers`, `extras`) travel as `WireKeyValue[]` pairs —
+ *   Codegen has no portable dictionary type.
+ * - **Timestamps** are epoch-milliseconds; intervals are seconds.
  */
 
 import { TurboModuleRegistry } from 'react-native';
+
+/** A single string map entry — see `headers` / `setExtras`. */
+
+/** Android-only foreground-service notification overrides. iOS ignores it. */
+
 export default TurboModuleRegistry.getEnforcing('BeekonRn');
 //# sourceMappingURL=NativeBeekonRn.js.map

package/lib/module/NativeBeekonRn.js.map

@@ -1 +1 @@
-{"version":3,"names":["TurboModuleRegistry","getEnforcing"],"sourceRoot":"../../src","sources":["NativeBeekonRn.ts"],"mappings":";;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA,SAASA,mBAAmB,QAAQ,cAAc;AAoDlD,eAAeA,mBAAmB,CAACC,YAAY,CAAO,UAAU,CAAC","ignoreList":[]}
+{"version":3,"names":["TurboModuleRegistry","getEnforcing"],"sourceRoot":"../../src","sources":["NativeBeekonRn.ts"],"mappings":";;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA,SAASA,mBAAmB,QAAQ,cAAc;;AAElD;;AAaA;;AAiHA,eAAeA,mBAAmB,CAACC,YAAY,CAAO,UAAU,CAAC","ignoreList":[]}

package/lib/module/beekon.js

@@ -1,106 +1,255 @@
 "use strict";
 
 import NativeBeekon from "./NativeBeekonRn.js";
-import { configToWire, wireToPosition, wireToState } from "./internal/mappers.js";
+import { configToWire, geofenceToWire, recordToEntries, rethrowAsBeekonError, wireToGeofence, wireToGeofenceEvent, wireToLocation, wireToState, wireToSyncStatus } from "./internal/mappers.js";
+/**
+ * Fans the four native EventEmitters out to multiple JS subscribers and adds
+ * replay-1 semantics for `state` / `syncStatus` (RN EventEmitters don't replay,
+ * so we cache the latest value and hand it to new subscribers immediately —
+ * matching the native StateFlow / AsyncStream contract). `location` /
+ * `geofenceEvent` are plain fan-out with no replay.
+ *
+ * Native subscriptions are opened once, on first use, and kept for the app
+ * lifetime — the native module collects its flows continuously regardless, so
+ * this only keeps the JS cache warm.
+ */
+class EventHub {
+  subscribed = false;
+  stateListeners = new Set();
+  locationListeners = new Set();
+  geofenceListeners = new Set();
+  syncListeners = new Set();
+  /** Idempotent: opens the native subscriptions the first time it is called. */
+  ensureSubscribed() {
+    if (this.subscribed) return;
+    this.subscribed = true;
+    NativeBeekon.onState(w => {
+      const s = wireToState(w);
+      this.lastState = s;
+      this.stateListeners.forEach(cb => cb(s));
+    });
+    NativeBeekon.onLocation(w => {
+      const l = wireToLocation(w);
+      this.locationListeners.forEach(cb => cb(l));
+    });
+    NativeBeekon.onGeofenceEvent(w => {
+      const g = wireToGeofenceEvent(w);
+      this.geofenceListeners.forEach(cb => cb(g));
+    });
+    NativeBeekon.onSyncStatus(w => {
+      const s = wireToSyncStatus(w);
+      this.lastSyncStatus = s;
+      this.syncListeners.forEach(cb => cb(s));
+    });
+  }
+  onState(cb) {
+    this.ensureSubscribed();
+    this.stateListeners.add(cb);
+    if (this.lastState !== undefined) cb(this.lastState);
+    return () => {
+      this.stateListeners.delete(cb);
+    };
+  }
+  onLocation(cb) {
+    this.ensureSubscribed();
+    this.locationListeners.add(cb);
+    return () => {
+      this.locationListeners.delete(cb);
+    };
+  }
+  onGeofenceEvent(cb) {
+    this.ensureSubscribed();
+    this.geofenceListeners.add(cb);
+    return () => {
+      this.geofenceListeners.delete(cb);
+    };
+  }
+  onSyncStatus(cb) {
+    this.ensureSubscribed();
+    this.syncListeners.add(cb);
+    if (this.lastSyncStatus !== undefined) cb(this.lastSyncStatus);
+    return () => {
+      this.syncListeners.delete(cb);
+    };
+  }
+}
 
 /**
- * Public facade for the Beekon SDK. Mirrors the native APIs:
+ * Public facade for the Beekon SDK — a 1:1 mirror of the native APIs:
  *
- * - Android: `com.wayq.beekon.Beekon` (object)
- * - iOS:     `Beekon.shared` (actor)
+ * - Android: `in.wayq.beekon.Beekon` (object)
+ * - iOS:     `BeekonKit.Beekon.shared` (actor)
  *
- * Lifecycle: `init()` once → `configure(config)` → `start()` → ... →
- * `stop()` (idempotent) or `shutdown()` (final teardown). Subscribe to
- * `onState` / `onPosition` for live updates; query `history(from, to)` for
- * persisted points.
+ * There is **no `initialize()`** — the native SDKs auto-initialize. Lifecycle:
+ * `configure(config)` (optional; defaults 30s / 100m) → `start()` → … →
+ * `stop()`. `start()` / `stop()` **never throw** — `onState` is the single
+ * source of truth for whether tracking is active and why it stopped.
  *
- * **Threading:** Methods are safe to call from any JS context. Subscribers'
+ * **Threading:** methods are safe to call from any JS context; subscriber
  * callbacks fire on the JS thread.
  *
- * **Persistence invariant:** the SDK persists every gated position natively;
- * JS is a passive observer. In background, the JS engine is not guaranteed to
- * be alive — for past points, use `history()`.
+ * **Persistence invariant:** the SDK persists every gated fix natively; JS is a
+ * passive observer that is not guaranteed to be alive in the background. For
+ * past fixes use `getLocations()`.
  */
 class BeekonImpl {
+  hub = new EventHub();
+
   /**
-   * Initialize the SDK. Idempotent; safe to call more than once. Must be
-   * called once before `configure()`.
-   *
-   * Errors:
-   * - `NO_GMS_AVAILABLE` (Android) — Google Play Services missing.
+   * Set tracking parameters. Optional — `start()` falls back to the previously
+   * persisted config, or the SDK defaults if never configured. While tracking,
+   * gate thresholds take effect on the next admitted fix without restarting the
+   * location subscription; `accuracyMode` applies on the next `start()`.
    */
-  async init() {
-    return NativeBeekon.initialize();
+  async configure(config) {
+    this.hub.ensureSubscribed();
+    await NativeBeekon.configure(configToWire(config));
   }
 
   /**
-   * Set sampling and platform-specific config. Replaces any previous config.
-   * Must be called before `start()`.
+   * Begin tracking. Never throws — observe `onState` for the outcome
+   * (`stopped(reason)` on a permission / services / system problem). Beekon
+   * ships no permission API: request permissions in the host app, then observe
+   * `onState`.
+   */
+  async start() {
+    this.hub.ensureSubscribed();
+    await NativeBeekon.start();
+  }
+
+  /** Stop tracking. Idempotent. Registered geofences keep firing. */
+  async stop() {
+    this.hub.ensureSubscribed();
+    await NativeBeekon.stop();
+  }
+
+  /**
+   * Resume tracking if a session was active before the app was terminated. A
+   * no-op if the user explicitly stopped. Call early in app startup.
    *
-   * Errors:
-   * - `NOT_INITIALISED` — `init()` was not called first.
-   * - `NOT_CONFIGURED` — Android only, `androidNotification` was missing.
+   * Note: on a background relaunch the JS engine may not be running, so true
+   * cold-launch resume also requires native host wiring (Android: call
+   * `Beekon.start()` from `Application.onCreate`; iOS: `registerBackgroundTasks`
+   * in the AppDelegate). See the README.
    */
-  async configure(config) {
-    return NativeBeekon.configure(configToWire(config));
+  async resumeIfNeeded() {
+    this.hub.ensureSubscribed();
+    await NativeBeekon.resumeIfNeeded();
   }
 
   /**
-   * Begin tracking. Transitions state from `idle` → `starting` → `tracking`.
+   * Read persisted fixes in the inclusive range `[from, to]`, oldest first.
+   * Reads come from the SDK's local storage (Room on Android, GRDB on iOS) — the
+   * source of truth even when JS was asleep. With sync enabled, rows are deleted
+   * locally once the server accepts them, so this returns only un-uploaded fixes.
    *
-   * Errors:
-   * - `PERMISSION_DENIED` — location permission not granted.
-   * - `LOCATION_SERVICES_DISABLED` (iOS) — system location services off.
-   * - `SERVICE_FAILED` — native service couldn't start.
+   * Throws `BeekonError` with kind `'storage'` on a database read failure.
    */
-  async start() {
-    return NativeBeekon.start();
+  async getLocations(from, to) {
+    try {
+      const wires = await NativeBeekon.getLocations(from.getTime(), to.getTime());
+      return wires.map(wireToLocation);
+    } catch (e) {
+      rethrowAsBeekonError(e);
+    }
   }
 
-  /** Stop tracking. Idempotent. State → `stopped`. */
-  async stop() {
-    return NativeBeekon.stop();
+  /**
+   * Delete stored locations captured at or before `before` (all of them when
+   * `before` is omitted). Returns the number of rows removed. Throws
+   * `BeekonError` with kind `'storage'` on a failure.
+   */
+  async deleteLocations(before) {
+    try {
+      // Negative is the wire sentinel for "delete all" (see NativeBeekonRn.ts).
+      return await NativeBeekon.deleteLocations(before ? before.getTime() : -1);
+    } catch (e) {
+      rethrowAsBeekonError(e);
+    }
   }
 
   /**
-   * Final teardown — releases native resources. Most apps don't need this;
-   * `stop()` is sufficient between sessions.
+   * The number of stored locations not yet uploaded. Throws `BeekonError` with
+   * kind `'storage'` on a failure.
    */
-  async shutdown() {
-    return NativeBeekon.shutdown();
+  async pendingUploadCount() {
+    try {
+      return await NativeBeekon.pendingUploadCount();
+    } catch (e) {
+      rethrowAsBeekonError(e);
+    }
   }
 
   /**
-   * Read persisted positions in the time range [from, to]. Returns positions
-   * in chronological order. Reads come from the SDK's local storage (Room on
-   * Android, GRDB on iOS) — the source of truth even when JS was asleep.
-   *
-   * Retention: positions older than 7 days OR beyond the most recent 100K are
-   * pruned automatically.
+   * Request an immediate upload. Best-effort and self-retrying; a no-op when
+   * sync is not configured.
    */
-  async history(from, to) {
-    const wires = await NativeBeekon.history(from.getTime(), to.getTime());
-    return wires.map(wireToPosition);
+  async sync() {
+    await NativeBeekon.sync();
+  }
+
+  /** Set custom key/value fields (e.g. `user_id`) included with every upload. */
+  async setExtras(extras) {
+    await NativeBeekon.setExtras(recordToEntries(extras));
+  }
+
+  /**
+   * Register geofences. Re-adding an `id` replaces the existing one. Throws
+   * `BeekonError` with kind `'invalidGeofence'` if any entry fails validation —
+   * none are added when one is invalid.
+   */
+  async addGeofences(geofences) {
+    try {
+      await NativeBeekon.addGeofences(geofences.map(geofenceToWire));
+    } catch (e) {
+      rethrowAsBeekonError(e);
+    }
+  }
+
+  /** Unregister geofences by id. Unknown ids are ignored. */
+  async removeGeofences(ids) {
+    await NativeBeekon.removeGeofences(ids);
+  }
+
+  /** The currently registered geofences. */
+  async listGeofences() {
+    const wires = await NativeBeekon.listGeofences();
+    return wires.map(wireToGeofence);
   }
 
   /**
-   * Subscribe to state transitions. Returns an unsubscribe function. The
-   * current state is delivered to new subscribers immediately (replay-1
-   * semantics, matching the native `state` flow).
+   * Subscribe to tracking-state transitions (`idle` / `tracking` /
+   * `stopped(reason)`). The current state is delivered to new subscribers
+   * immediately (replay-1). Returns an unsubscribe function.
    */
   onState(cb) {
-    const subscription = NativeBeekon.onState(wire => cb(wireToState(wire)));
-    return () => subscription.remove();
+    return this.hub.onState(cb);
+  }
+
+  /**
+   * Subscribe to gated locations as they arrive. Broadcast (no replay) — only
+   * delivers while the JS engine is alive. For fixes emitted while JS was
+   * asleep, use `getLocations()`. Returns an unsubscribe function.
+   */
+  onLocation(cb) {
+    return this.hub.onLocation(cb);
+  }
+
+  /**
+   * Subscribe to geofence enter / exit crossings. Broadcast (no replay).
+   * Returns an unsubscribe function.
+   */
+  onGeofenceEvent(cb) {
+    return this.hub.onGeofenceEvent(cb);
   }
 
   /**
-   * Subscribe to gated positions as they arrive. Returns an unsubscribe
-   * function. Broadcast (no replay) — only delivers while the JS engine is
-   * alive. For points emitted while JS was asleep, use `history()`.
+   * Subscribe to upload health (`idle` / `pending` / `failed(reason)`). The
+   * current status is delivered to new subscribers immediately (replay-1).
+   * Returns an unsubscribe function.
    */
-  onPosition(cb) {
-    const subscription = NativeBeekon.onPosition(wire => cb(wireToPosition(wire)));
-    return () => subscription.remove();
+  onSyncStatus(cb) {
+    return this.hub.onSyncStatus(cb);
   }
 }
 export const Beekon = new BeekonImpl();

package/lib/module/beekon.js.map

@@ -1 +1 @@
-{"version":3,"names":["NativeBeekon","configToWire","wireToPosition","wireToState","BeekonImpl","init","initialize","configure","config","start","stop","shutdown","history","from","to","wires","getTime","map","onState","cb","subscription","wire","remove","onPosition","Beekon"],"sourceRoot":"../../src","sources":["beekon.ts"],"mappings":";;AAAA,OAAOA,YAAY,MAAM,qBAAkB;AAI3C,SAASC,YAAY,EAAEC,cAAc,EAAEC,WAAW,QAAQ,uBAAoB;;AAE9E;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,MAAMC,UAAU,CAAC;EACf;AACF;AACA;AACA;AACA;AACA;AACA;EACE,MAAMC,IAAIA,CAAA,EAAkB;IAC1B,OAAOL,YAAY,CAACM,UAAU,CAAC,CAAC;EAClC;;EAEA;AACF;AACA;AACA;AACA;AACA;AACA;AACA;EACE,MAAMC,SAASA,CAACC,MAAoB,EAAiB;IACnD,OAAOR,YAAY,CAACO,SAAS,CAACN,YAAY,CAACO,MAAM,CAAC,CAAC;EACrD;;EAEA;AACF;AACA;AACA;AACA;AACA;AACA;AACA;EACE,MAAMC,KAAKA,CAAA,EAAkB;IAC3B,OAAOT,YAAY,CAACS,KAAK,CAAC,CAAC;EAC7B;;EAEA;EACA,MAAMC,IAAIA,CAAA,EAAkB;IAC1B,OAAOV,YAAY,CAACU,IAAI,CAAC,CAAC;EAC5B;;EAEA;AACF;AACA;AACA;EACE,MAAMC,QAAQA,CAAA,EAAkB;IAC9B,OAAOX,YAAY,CAACW,QAAQ,CAAC,CAAC;EAChC;;EAEA;AACF;AACA;AACA;AACA;AACA;AACA;AACA;EACE,MAAMC,OAAOA,CAACC,IAAU,EAAEC,EAAQ,EAAuB;IACvD,MAAMC,KAAK,GAAG,MAAMf,YAAY,CAACY,OAAO,CAACC,IAAI,CAACG,OAAO,CAAC,CAAC,EAAEF,EAAE,CAACE,OAAO,CAAC,CAAC,CAAC;IACtE,OAAOD,KAAK,CAACE,GAAG,CAACf,cAAc,CAAC;EAClC;;EAEA;AACF;AACA;AACA;AACA;EACEgB,OAAOA,CAACC,EAA4B,EAAc;IAChD,MAAMC,YAAY,GAAGpB,YAAY,CAACkB,OAAO,CAAEG,IAAI,IAAKF,EAAE,CAAChB,WAAW,CAACkB,IAAI,CAAC,CAAC,CAAC;IAC1E,OAAO,MAAMD,YAAY,CAACE,MAAM,CAAC,CAAC;EACpC;;EAEA;AACF;AACA;AACA;AACA;EACEC,UAAUA,CAACJ,EAAyB,EAAc;IAChD,MAAMC,YAAY,GAAGpB,YAAY,CAACuB,UAAU,CAAEF,IAAI,IAChDF,EAAE,CAACjB,cAAc,CAACmB,IAAI,CAAC,CACzB,CAAC;IACD,OAAO,MAAMD,YAAY,CAACE,MAAM,CAAC,CAAC;EACpC;AACF;AAEA,OAAO,MAAME,MAAM,GAAG,IAAIpB,UAAU,CAAC,CAAC","ignoreList":[]}
+{"version":3,"names":["NativeBeekon","configToWire","geofenceToWire","recordToEntries","rethrowAsBeekonError","wireToGeofence","wireToGeofenceEvent","wireToLocation","wireToState","wireToSyncStatus","EventHub","subscribed","stateListeners","Set","locationListeners","geofenceListeners","syncListeners","ensureSubscribed","onState","w","s","lastState","forEach","cb","onLocation","l","onGeofenceEvent","g","onSyncStatus","lastSyncStatus","add","undefined","delete","BeekonImpl","hub","configure","config","start","stop","resumeIfNeeded","getLocations","from","to","wires","getTime","map","e","deleteLocations","before","pendingUploadCount","sync","setExtras","extras","addGeofences","geofences","removeGeofences","ids","listGeofences","Beekon"],"sourceRoot":"../../src","sources":["beekon.ts"],"mappings":"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","ignoreList":[]}