@wayq/beekon-rn 0.0.1 → 0.0.3

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

@@ -0,0 +1,85 @@
+// swift-interface-format-version: 1.0
+// swift-compiler-version: Apple Swift version 6.2.3 (swiftlang-6.2.3.3.21 clang-1700.6.3.2)
+// swift-module-flags: -target x86_64-apple-ios17.0-simulator -enable-objc-interop -enable-library-evolution -swift-version 6 -enforce-exclusivity=checked -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.2.3
+import CoreLocation
+import Foundation
+import Foundation/*.Bundle*/
+import Foundation/*.ProcessInfo*/
+import Foundation/*.URL*/
+import Swift
+import _Concurrency
+import _StringProcessing
+import _SwiftConcurrencyShims
+import os
+@_hasMissingDesignatedInitializers public actor Beekon {
+  public static let shared: BeekonKit.Beekon
+  public func configure(_ config: BeekonKit.BeekonConfig)
+  public func start() async throws
+  public func stop() async
+  public func locations(from: Foundation.Date, to: Foundation.Date) async throws -> [BeekonKit.Location]
+  public var state: _Concurrency.AsyncStream<BeekonKit.BeekonState> {
+    get
+  }
+  public var locations: _Concurrency.AsyncStream<BeekonKit.Location> {
+    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.Hashable {
+  public var intervalSeconds: Foundation.TimeInterval
+  public var distanceMeters: Swift.Double
+  public static let `default`: BeekonKit.BeekonConfig
+  public init(intervalSeconds: Foundation.TimeInterval = 30, distanceMeters: Swift.Double = 100)
+  public static func == (a: BeekonKit.BeekonConfig, b: BeekonKit.BeekonConfig) -> Swift.Bool
+  public func hash(into hasher: inout Swift.Hasher)
+  public var hashValue: Swift.Int {
+    get
+  }
+}
+public enum BeekonError : Swift.Error, Swift.Sendable {
+  case permissionDenied
+  case locationServicesDisabled
+  case storageFailure(any Swift.Error)
+}
+public enum BeekonState : Swift.Sendable, Swift.Equatable, Swift.Hashable {
+  case idle
+  case tracking
+  case stopped(reason: BeekonKit.StopReason)
+  public static func == (a: BeekonKit.BeekonState, b: BeekonKit.BeekonState) -> Swift.Bool
+  public func hash(into hasher: inout Swift.Hasher)
+  public var hashValue: Swift.Int {
+    get
+  }
+}
+public enum StopReason : Swift.Sendable, Swift.Equatable, Swift.Hashable {
+  case user
+  case permissionDenied
+  case locationServicesDisabled
+  public static func == (a: BeekonKit.StopReason, b: BeekonKit.StopReason) -> Swift.Bool
+  public func hash(into hasher: inout Swift.Hasher)
+  public var hashValue: Swift.Int {
+    get
+  }
+}
+public struct Location : Swift.Sendable, Swift.Equatable, Swift.Hashable {
+  public let lat: Swift.Double
+  public let lng: Swift.Double
+  public let accuracy: Swift.Double?
+  public let speed: Swift.Double?
+  public let bearing: Swift.Double?
+  public let altitude: Swift.Double?
+  public let timestamp: Foundation.Date
+  #if compiler(>=5.3) && $NonescapableTypes
+  public init(lat: Swift.Double, lng: Swift.Double, timestamp: Foundation.Date, accuracy: Swift.Double? = nil, speed: Swift.Double? = nil, bearing: Swift.Double? = nil, altitude: Swift.Double? = nil)
+  #endif
+  public static func == (a: BeekonKit.Location, b: BeekonKit.Location) -> Swift.Bool
+  public func hash(into hasher: inout Swift.Hasher)
+  public var hashValue: Swift.Int {
+    get
+  }
+}

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,20 +6,86 @@
 	<dict>
 		<key>Info.plist</key>
 		<data>
-		w9rsPHfS6nhyFAFD48jpWHGzYuc=
+		uIBZEl29bIa6BD82AJqNnqxItQ8=
+		</data>
+		<key>Modules/BeekonKit.swiftmodule/arm64-apple-ios-simulator.abi.json</key>
+		<data>
+		VX3G5xWaHufjuctExyD3KxnvPKo=
+		</data>
+		<key>Modules/BeekonKit.swiftmodule/arm64-apple-ios-simulator.swiftdoc</key>
+		<data>
+		N69rpbNFqxF9nC3LxN0wVnxXtGI=
+		</data>
+		<key>Modules/BeekonKit.swiftmodule/arm64-apple-ios-simulator.swiftinterface</key>
+		<data>
+		OwWAJveN4oSVFdX/aWzFdGsMh5s=
+		</data>
+		<key>Modules/BeekonKit.swiftmodule/x86_64-apple-ios-simulator.abi.json</key>
+		<data>
+		VX3G5xWaHufjuctExyD3KxnvPKo=
+		</data>
+		<key>Modules/BeekonKit.swiftmodule/x86_64-apple-ios-simulator.swiftdoc</key>
+		<data>
+		jNcXtOMMcpL2++xWcYLei9tqS5w=
+		</data>
+		<key>Modules/BeekonKit.swiftmodule/x86_64-apple-ios-simulator.swiftinterface</key>
+		<data>
+		aX58esTNE/RvDF6suImnsEDQMTM=
 		</data>
 		<key>PrivacyInfo.xcprivacy</key>
 		<data>
-		+Hzj9e+o3dYoDboCDA7ofM2a0kc=
+		9ZHPJ6MUYP0Ios5LKP+bfuWVxJk=
 		</data>
 	</dict>
 	<key>files2</key>
 	<dict>
+		<key>Modules/BeekonKit.swiftmodule/arm64-apple-ios-simulator.abi.json</key>
+		<dict>
+			<key>hash2</key>
+			<data>
+			9WWtJ/SunDN+RNh+QhuE+dUtw0x58nNbt9gYBn3XlBE=
+			</data>
+		</dict>
+		<key>Modules/BeekonKit.swiftmodule/arm64-apple-ios-simulator.swiftdoc</key>
+		<dict>
+			<key>hash2</key>
+			<data>
+			kiW5NMFrXxi4aekbMu1hT1jL4NsFbUsT5gwvjIUim48=
+			</data>
+		</dict>
+		<key>Modules/BeekonKit.swiftmodule/arm64-apple-ios-simulator.swiftinterface</key>
+		<dict>
+			<key>hash2</key>
+			<data>
+			v/Cfl3tF13LG5nhjGFypVGQvacvwZ+VAdyy0Iy6c994=
+			</data>
+		</dict>
+		<key>Modules/BeekonKit.swiftmodule/x86_64-apple-ios-simulator.abi.json</key>
+		<dict>
+			<key>hash2</key>
+			<data>
+			9WWtJ/SunDN+RNh+QhuE+dUtw0x58nNbt9gYBn3XlBE=
+			</data>
+		</dict>
+		<key>Modules/BeekonKit.swiftmodule/x86_64-apple-ios-simulator.swiftdoc</key>
+		<dict>
+			<key>hash2</key>
+			<data>
+			GMOMoBM3ikrulB6x4+R3kPTTGUXqZ5eueJPYsJ4NkaU=
+			</data>
+		</dict>
+		<key>Modules/BeekonKit.swiftmodule/x86_64-apple-ios-simulator.swiftinterface</key>
+		<dict>
+			<key>hash2</key>
+			<data>
+			cP2NWEZSOyc/7TF6zwN7la0671FBm2P9UHwb1WLWAog=
+			</data>
+		</dict>
 		<key>PrivacyInfo.xcprivacy</key>
 		<dict>
 			<key>hash2</key>
 			<data>
-			E3plr2RiT1CPWdLg5VfDUw1k7yShykpszuDqfKG4YYw=
+			KNi008FJ9ZF/nLOH4DadbEUqysKXh/HjMAmdLdidn4c=
 			</data>
 		</dict>
 	</dict>

package/lib/module/NativeBeekonRn.js

@@ -7,8 +7,8 @@
  *
  * 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.
+ * recursive structures. The state variants are encoded as a `type`
+ * discriminator string with sibling fields nullable per variant.
  */
 
 import { TurboModuleRegistry } from 'react-native';

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;;AAEA,SAASA,mBAAmB,QAAQ,cAAc;AAgDlD,eAAeA,mBAAmB,CAACC,YAAY,CAAO,UAAU,CAAC","ignoreList":[]}

package/lib/module/beekon.js

@@ -1,92 +1,89 @@
 "use strict";
 
 import NativeBeekon from "./NativeBeekonRn.js";
-import { configToWire, wireToPosition, wireToState } from "./internal/mappers.js";
+import { configToWire, wireToLocation, wireToState, rethrowAsBeekonError } from "./internal/mappers.js";
 
 /**
  * Public facade for the Beekon SDK. Mirrors 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.
+ * Lifecycle: `configure(config)` → `start()` → ... → `stop()` (idempotent).
+ * Subscribe to `onState` / `onLocation` for live updates; query
+ * `history(from, to)` for persisted fixes.
  *
  * **Threading:** Methods are safe to call from any JS context. Subscribers'
  * 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. In background, the JS engine is not guaranteed to be
+ * alive — for past fixes, use `history()`.
  */
 class BeekonImpl {
   /**
-   * Initialize the SDK. Idempotent; safe to call more than once. Must be
-   * called once before `configure()`.
+   * Set tracking parameters. Optional — `start()` falls back to the previously
+   * persisted config or the SDK default (30s / 100m) if never configured.
    *
-   * Errors:
-   * - `NO_GMS_AVAILABLE` (Android) — Google Play Services missing.
-   */
-  async init() {
-    return NativeBeekon.initialize();
-  }
-
-  /**
-   * Set sampling and platform-specific config. Replaces any previous config.
-   * Must be called before `start()`.
-   *
-   * Errors:
-   * - `NOT_INITIALISED` — `init()` was not called first.
-   * - `NOT_CONFIGURED` — Android only, `androidNotification` was missing.
+   * While tracking, the new gate values take effect on the next admitted fix
+   * without restarting the underlying location subscription.
    */
   async configure(config) {
-    return NativeBeekon.configure(configToWire(config));
+    try {
+      await NativeBeekon.configure(configToWire(config));
+    } catch (e) {
+      rethrowAsBeekonError(e);
+    }
   }
 
   /**
-   * Begin tracking. Transitions state from `idle` → `starting` → `tracking`.
+   * Begin tracking. State transitions to `tracking`.
    *
-   * Errors:
-   * - `PERMISSION_DENIED` — location permission not granted.
-   * - `LOCATION_SERVICES_DISABLED` (iOS) — system location services off.
-   * - `SERVICE_FAILED` — native service couldn't start.
+   * Throws a `BeekonError` with kind:
+   * - `'permissionDenied'` — location permission not granted.
+   * - `'locationServicesDisabled'` — system location services off (or GMS
+   *   unavailable on Android).
    */
   async start() {
-    return NativeBeekon.start();
+    try {
+      await NativeBeekon.start();
+    } catch (e) {
+      rethrowAsBeekonError(e);
+    }
   }
 
-  /** Stop tracking. Idempotent. State → `stopped`. */
+  /** Stop tracking. Idempotent. State transitions to `stopped(user)`. */
   async stop() {
-    return NativeBeekon.stop();
+    try {
+      await NativeBeekon.stop();
+    } catch (e) {
+      rethrowAsBeekonError(e);
+    }
   }
 
   /**
-   * Final teardown — releases native resources. Most apps don't need this;
-   * `stop()` is sufficient between sessions.
-   */
-  async shutdown() {
-    return NativeBeekon.shutdown();
-  }
-
-  /**
-   * Read persisted positions in the time range [from, to]. Returns positions
-   * in chronological order. Reads come from the SDK's local storage (Room on
+   * Read persisted fixes in the time range [from, to]. Returns fixes 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
+   * Retention: fixes older than 7 days OR beyond the most recent 100K are
    * pruned automatically.
+   *
+   * Throws `BeekonError` with kind `'storageFailure'` on database read failure.
    */
   async history(from, to) {
-    const wires = await NativeBeekon.history(from.getTime(), to.getTime());
-    return wires.map(wireToPosition);
+    try {
+      const wires = await NativeBeekon.history(from.getTime(), to.getTime());
+      return wires.map(wireToLocation);
+    } catch (e) {
+      rethrowAsBeekonError(e);
+    }
   }
 
   /**
    * 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).
+   * semantics, matching the native `state` flow / AsyncStream).
    */
   onState(cb) {
     const subscription = NativeBeekon.onState(wire => cb(wireToState(wire)));
@@ -94,12 +91,12 @@ class BeekonImpl {
   }
 
   /**
-   * Subscribe to gated positions as they arrive. Returns an unsubscribe
+   * Subscribe to gated locations 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()`.
+   * alive. For fixes emitted while JS was asleep, use `history()`.
    */
-  onPosition(cb) {
-    const subscription = NativeBeekon.onPosition(wire => cb(wireToPosition(wire)));
+  onLocation(cb) {
+    const subscription = NativeBeekon.onLocation(wire => cb(wireToLocation(wire)));
     return () => subscription.remove();
   }
 }

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","wireToLocation","wireToState","rethrowAsBeekonError","BeekonImpl","configure","config","e","start","stop","history","from","to","wires","getTime","map","onState","cb","subscription","wire","remove","onLocation","Beekon"],"sourceRoot":"../../src","sources":["beekon.ts"],"mappings":";;AAAA,OAAOA,YAAY,MAAM,qBAAkB;AAI3C,SACEC,YAAY,EACZC,cAAc,EACdC,WAAW,EACXC,oBAAoB,QACf,uBAAoB;;AAE3B;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,SAASA,CAACC,MAAoB,EAAiB;IACnD,IAAI;MACF,MAAMP,YAAY,CAACM,SAAS,CAACL,YAAY,CAACM,MAAM,CAAC,CAAC;IACpD,CAAC,CAAC,OAAOC,CAAC,EAAE;MACVJ,oBAAoB,CAACI,CAAC,CAAC;IACzB;EACF;;EAEA;AACF;AACA;AACA;AACA;AACA;AACA;AACA;EACE,MAAMC,KAAKA,CAAA,EAAkB;IAC3B,IAAI;MACF,MAAMT,YAAY,CAACS,KAAK,CAAC,CAAC;IAC5B,CAAC,CAAC,OAAOD,CAAC,EAAE;MACVJ,oBAAoB,CAACI,CAAC,CAAC;IACzB;EACF;;EAEA;EACA,MAAME,IAAIA,CAAA,EAAkB;IAC1B,IAAI;MACF,MAAMV,YAAY,CAACU,IAAI,CAAC,CAAC;IAC3B,CAAC,CAAC,OAAOF,CAAC,EAAE;MACVJ,oBAAoB,CAACI,CAAC,CAAC;IACzB;EACF;;EAEA;AACF;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;EACE,MAAMG,OAAOA,CAACC,IAAU,EAAEC,EAAQ,EAAuB;IACvD,IAAI;MACF,MAAMC,KAAK,GAAG,MAAMd,YAAY,CAACW,OAAO,CAACC,IAAI,CAACG,OAAO,CAAC,CAAC,EAAEF,EAAE,CAACE,OAAO,CAAC,CAAC,CAAC;MACtE,OAAOD,KAAK,CAACE,GAAG,CAACd,cAAc,CAAC;IAClC,CAAC,CAAC,OAAOM,CAAC,EAAE;MACVJ,oBAAoB,CAACI,CAAC,CAAC;IACzB;EACF;;EAEA;AACF;AACA;AACA;AACA;EACES,OAAOA,CAACC,EAA4B,EAAc;IAChD,MAAMC,YAAY,GAAGnB,YAAY,CAACiB,OAAO,CAAEG,IAAI,IAAKF,EAAE,CAACf,WAAW,CAACiB,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,GAAGnB,YAAY,CAACsB,UAAU,CAAEF,IAAI,IAChDF,EAAE,CAAChB,cAAc,CAACkB,IAAI,CAAC,CACzB,CAAC;IACD,OAAO,MAAMD,YAAY,CAACE,MAAM,CAAC,CAAC;EACpC;AACF;AAEA,OAAO,MAAME,MAAM,GAAG,IAAIlB,UAAU,CAAC,CAAC","ignoreList":[]}

package/lib/module/index.js

@@ -1,4 +1,5 @@
 "use strict";
 
 export { Beekon } from "./beekon.js";
+export { BeekonError } from "./types/error.js";
 //# sourceMappingURL=index.js.map

package/lib/module/index.js.map

@@ -1 +1 @@
-{"version":3,"names":["Beekon"],"sourceRoot":"../../src","sources":["index.tsx"],"mappings":";;AAAA,SAASA,MAAM,QAAQ,aAAU","ignoreList":[]}
+{"version":3,"names":["Beekon","BeekonError"],"sourceRoot":"../../src","sources":["index.tsx"],"mappings":";;AAAA,SAASA,MAAM,QAAQ,aAAU;AAIjC,SAASC,WAAW,QAA8B,kBAAe","ignoreList":[]}

package/lib/module/internal/mappers.js

@@ -1,15 +1,16 @@
 "use strict";
 
+import { BeekonError } from "../types/error.js";
+const DEFAULT_INTERVAL_SECONDS = 30;
+const DEFAULT_DISTANCE_METERS = 100;
 export function configToWire(config) {
   return {
-    preset: config.preset ?? 'balanced',
-    distanceFilterMeters: config.distanceFilterMeters,
-    intervalMillis: config.intervalMillis,
-    androidNotification: config.androidNotification,
-    licenseKey: config.licenseKey
+    intervalSeconds: config.intervalSeconds ?? DEFAULT_INTERVAL_SECONDS,
+    distanceMeters: config.distanceMeters ?? DEFAULT_DISTANCE_METERS,
+    androidNotification: config.androidNotification
   };
 }
-export function wireToPosition(w) {
+export function wireToLocation(w) {
   return {
     lat: w.lat,
     lng: w.lng,
@@ -20,9 +21,17 @@ export function wireToPosition(w) {
     timestamp: new Date(w.timestampMs)
   };
 }
-function toPauseReason(s) {
-  if (s === 'permissionRevoked' || s === 'locationDisabled') return s;
-  return 'unknown';
+function toStopReason(s) {
+  switch (s) {
+    case 'user':
+    case 'permissionDenied':
+    case 'locationServicesDisabled':
+    case 'system':
+      return s;
+    default:
+      // Defensive — native should never emit an unknown reason.
+      return 'user';
+  }
 }
 export function wireToState(w) {
   switch (w.type) {
@@ -30,29 +39,48 @@ export function wireToState(w) {
       return {
         kind: 'idle'
       };
-    case 'starting':
-      return {
-        kind: 'starting'
-      };
     case 'tracking':
       return {
         kind: 'tracking'
       };
-    case 'paused':
-      return {
-        kind: 'paused',
-        reason: toPauseReason(w.pauseReason)
-      };
     case 'stopped':
       return {
-        kind: 'stopped'
+        kind: 'stopped',
+        reason: toStopReason(w.stopReason)
       };
     default:
-      // Defensive fallback. Native should never emit an unknown state, but
-      // forward-compat: treat as idle rather than throwing.
+      // Forward-compat: treat unknown as idle rather than throwing.
       return {
         kind: 'idle'
       };
   }
 }
+
+/**
+ * Re-throw a native promise rejection as a typed `BeekonError`. Native modules
+ * encode the kind in the error code string (`PERMISSION_DENIED`,
+ * `LOCATION_SERVICES_DISABLED`, `STORAGE_FAILURE`); anything else falls
+ * through as the original error.
+ */
+export function rethrowAsBeekonError(e) {
+  const code = e?.code;
+  const message = e?.message ?? String(e);
+  const kind = codeToKind(code);
+  if (kind) {
+    throw new BeekonError(kind, message);
+  }
+  throw e;
+}
+function codeToKind(code) {
+  switch (code) {
+    case 'PERMISSION_DENIED':
+      return 'permissionDenied';
+    case 'LOCATION_SERVICES_DISABLED':
+      return 'locationServicesDisabled';
+    case 'STORAGE_FAILURE':
+      return 'storageFailure';
+    default:
+      return undefined;
+  }
+}
 //# sourceMappingURL=mappers.js.map

package/lib/module/internal/mappers.js.map

@@ -1 +1 @@
-{"version":3,"names":["configToWire","config","preset","distanceFilterMeters","intervalMillis","androidNotification","licenseKey","wireToPosition","w","lat","lng","accuracy","speed","bearing","altitude","timestamp","Date","timestampMs","toPauseReason","s","wireToState","type","kind","reason","pauseReason"],"sourceRoot":"../../../src","sources":["internal/mappers.ts"],"mappings":";;AAKA,OAAO,SAASA,YAAYA,CAACC,MAAoB,EAAc;EAC7D,OAAO;IACLC,MAAM,EAAED,MAAM,CAACC,MAAM,IAAI,UAAU;IACnCC,oBAAoB,EAAEF,MAAM,CAACE,oBAAoB;IACjDC,cAAc,EAAEH,MAAM,CAACG,cAAc;IACrCC,mBAAmB,EAAEJ,MAAM,CAACI,mBAAmB;IAC/CC,UAAU,EAAEL,MAAM,CAACK;EACrB,CAAC;AACH;AAEA,OAAO,SAASC,cAAcA,CAACC,CAAe,EAAY;EACxD,OAAO;IACLC,GAAG,EAAED,CAAC,CAACC,GAAG;IACVC,GAAG,EAAEF,CAAC,CAACE,GAAG;IACVC,QAAQ,EAAEH,CAAC,CAACG,QAAQ;IACpBC,KAAK,EAAEJ,CAAC,CAACI,KAAK;IACdC,OAAO,EAAEL,CAAC,CAACK,OAAO;IAClBC,QAAQ,EAAEN,CAAC,CAACM,QAAQ;IACpBC,SAAS,EAAE,IAAIC,IAAI,CAACR,CAAC,CAACS,WAAW;EACnC,CAAC;AACH;AAEA,SAASC,aAAaA,CAACC,CAAqB,EAAe;EACzD,IAAIA,CAAC,KAAK,mBAAmB,IAAIA,CAAC,KAAK,kBAAkB,EAAE,OAAOA,CAAC;EACnE,OAAO,SAAS;AAClB;AAEA,OAAO,SAASC,WAAWA,CAACZ,CAAY,EAAe;EACrD,QAAQA,CAAC,CAACa,IAAI;IACZ,KAAK,MAAM;MACT,OAAO;QAAEC,IAAI,EAAE;MAAO,CAAC;IACzB,KAAK,UAAU;MACb,OAAO;QAAEA,IAAI,EAAE;MAAW,CAAC;IAC7B,KAAK,UAAU;MACb,OAAO;QAAEA,IAAI,EAAE;MAAW,CAAC;IAC7B,KAAK,QAAQ;MACX,OAAO;QAAEA,IAAI,EAAE,QAAQ;QAAEC,MAAM,EAAEL,aAAa,CAACV,CAAC,CAACgB,WAAW;MAAE,CAAC;IACjE,KAAK,SAAS;MACZ,OAAO;QAAEF,IAAI,EAAE;MAAU,CAAC;IAC5B;MACE;MACA;MACA,OAAO;QAAEA,IAAI,EAAE;MAAO,CAAC;EAC3B;AACF","ignoreList":[]}
+{"version":3,"names":["BeekonError","DEFAULT_INTERVAL_SECONDS","DEFAULT_DISTANCE_METERS","configToWire","config","intervalSeconds","distanceMeters","androidNotification","wireToLocation","w","lat","lng","accuracy","speed","bearing","altitude","timestamp","Date","timestampMs","toStopReason","s","wireToState","type","kind","reason","stopReason","rethrowAsBeekonError","e","code","message","String","codeToKind","undefined"],"sourceRoot":"../../../src","sources":["internal/mappers.ts"],"mappings":";;AAGA,SAASA,WAAW,QAA8B,mBAAgB;AAGlE,MAAMC,wBAAwB,GAAG,EAAE;AACnC,MAAMC,uBAAuB,GAAG,GAAG;AAEnC,OAAO,SAASC,YAAYA,CAACC,MAAoB,EAAc;EAC7D,OAAO;IACLC,eAAe,EAAED,MAAM,CAACC,eAAe,IAAIJ,wBAAwB;IACnEK,cAAc,EAAEF,MAAM,CAACE,cAAc,IAAIJ,uBAAuB;IAChEK,mBAAmB,EAAEH,MAAM,CAACG;EAC9B,CAAC;AACH;AAEA,OAAO,SAASC,cAAcA,CAACC,CAAe,EAAY;EACxD,OAAO;IACLC,GAAG,EAAED,CAAC,CAACC,GAAG;IACVC,GAAG,EAAEF,CAAC,CAACE,GAAG;IACVC,QAAQ,EAAEH,CAAC,CAACG,QAAQ;IACpBC,KAAK,EAAEJ,CAAC,CAACI,KAAK;IACdC,OAAO,EAAEL,CAAC,CAACK,OAAO;IAClBC,QAAQ,EAAEN,CAAC,CAACM,QAAQ;IACpBC,SAAS,EAAE,IAAIC,IAAI,CAACR,CAAC,CAACS,WAAW;EACnC,CAAC;AACH;AAEA,SAASC,YAAYA,CAACC,CAAqB,EAAc;EACvD,QAAQA,CAAC;IACP,KAAK,MAAM;IACX,KAAK,kBAAkB;IACvB,KAAK,0BAA0B;IAC/B,KAAK,QAAQ;MACX,OAAOA,CAAC;IACV;MACE;MACA,OAAO,MAAM;EACjB;AACF;AAEA,OAAO,SAASC,WAAWA,CAACZ,CAAY,EAAe;EACrD,QAAQA,CAAC,CAACa,IAAI;IACZ,KAAK,MAAM;MACT,OAAO;QAAEC,IAAI,EAAE;MAAO,CAAC;IACzB,KAAK,UAAU;MACb,OAAO;QAAEA,IAAI,EAAE;MAAW,CAAC;IAC7B,KAAK,SAAS;MACZ,OAAO;QAAEA,IAAI,EAAE,SAAS;QAAEC,MAAM,EAAEL,YAAY,CAACV,CAAC,CAACgB,UAAU;MAAE,CAAC;IAChE;MACE;MACA,OAAO;QAAEF,IAAI,EAAE;MAAO,CAAC;EAC3B;AACF;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASG,oBAAoBA,CAACC,CAAU,EAAS;EACtD,MAAMC,IAAI,GAAID,CAAC,EAAoCC,IAAI;EACvD,MAAMC,OAAO,GAAIF,CAAC,EAAuCE,OAAO,IAAIC,MAAM,CAACH,CAAC,CAAC;EAC7E,MAAMJ,IAAI,GAAGQ,UAAU,CAACH,IAAI,CAAC;EAC7B,IAAIL,IAAI,EAAE;IACR,MAAM,IAAIvB,WAAW,CAACuB,IAAI,EAAEM,OAAO,CAAC;EACtC;EACA,MAAMF,CAAC;AACT;AAEA,SAASI,UAAUA,CAACH,IAAwB,EAA+B;EACzE,QAAQA,IAAI;IACV,KAAK,mBAAmB;MACtB,OAAO,kBAAkB;IAC3B,KAAK,4BAA4B;MAC/B,OAAO,0BAA0B;IACnC,KAAK,iBAAiB;MACpB,OAAO,gBAAgB;IACzB;MACE,OAAOI,SAAS;EACpB;AACF","ignoreList":[]}

package/lib/module/types/config.js

@@ -1,4 +1,2 @@
 "use strict";
-
-export {};
 //# sourceMappingURL=config.js.map

package/lib/module/types/error.js

@@ -0,0 +1,19 @@
+"use strict";
+
+/**
+ * Error kinds thrown from `Beekon.start()` / `Beekon.history()`. Match the
+ * native `BeekonError` cases byte-for-byte.
+ */
+
+/**
+ * Typed error surfaced from the bridge. The native module rejects promises
+ * with the kind encoded as the error code; the facade re-wraps into this.
+ */
+export class BeekonError extends Error {
+  constructor(kind, message) {
+    super(message);
+    this.name = 'BeekonError';
+    this.kind = kind;
+  }
+}
+//# sourceMappingURL=error.js.map

package/lib/module/types/error.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["BeekonError","Error","constructor","kind","message","name"],"sourceRoot":"../../../src","sources":["types/error.ts"],"mappings":";;AAAA;AACA;AACA;AACA;;AAMA;AACA;AACA;AACA;AACA,OAAO,MAAMA,WAAW,SAASC,KAAK,CAAC;EAGrCC,WAAWA,CAACC,IAAqB,EAAEC,OAAe,EAAE;IAClD,KAAK,CAACA,OAAO,CAAC;IACd,IAAI,CAACC,IAAI,GAAG,aAAa;IACzB,IAAI,CAACF,IAAI,GAAGA,IAAI;EAClB;AACF","ignoreList":[]}

package/lib/module/types/location.js

@@ -0,0 +1,2 @@
+"use strict";
+//# sourceMappingURL=location.js.map

package/lib/module/types/{position.js.map → location.js.map}

@@ -1 +1 @@
-{"version":3,"names":[],"sourceRoot":"../../../src","sources":["types/position.ts"],"mappings":"","ignoreList":[]}
+{"version":3,"names":[],"sourceRoot":"../../../src","sources":["types/location.ts"],"mappings":"","ignoreList":[]}

package/lib/typescript/src/NativeBeekonRn.d.ts

@@ -5,53 +5,49 @@
  *
  * 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.
+ * recursive structures. The state variants are encoded as a `type`
+ * discriminator string with sibling fields nullable per variant.
  */
 import type { CodegenTypes, TurboModule } from 'react-native';
 export type WireAndroidNotification = {
-    channelId: string;
-    channelName: string;
-    notificationId: number;
-    title: string;
-    text: string;
-    smallIconResName: string;
+    title?: string;
+    text?: string;
+    smallIconResName?: string;
 };
 export type WireConfig = {
-    /** One of: 'saver' | 'balanced' | 'precision'. */
-    preset: string;
-    distanceFilterMeters?: number;
-    intervalMillis?: number;
+    /** Required at the wire level — the TS facade applies defaults (30 / 100). */
+    intervalSeconds: number;
+    /** Required at the wire level — the TS facade applies defaults (30 / 100). */
+    distanceMeters: number;
+    /** Android-only. iOS native module ignores. */
     androidNotification?: WireAndroidNotification;
-    licenseKey?: string;
 };
-export type WirePosition = {
+export type WireLocation = {
     lat: number;
     lng: number;
-    accuracy: number;
-    speed: number;
-    bearing: number;
-    altitude: number;
     timestampMs: number;
+    /** `null` when the OS did not report a value (e.g. low-confidence fix). */
+    accuracy: number | null;
+    speed: number | null;
+    bearing: number | null;
+    altitude: number | null;
 };
 export type WireState = {
-    /** One of: 'idle' | 'starting' | 'tracking' | 'paused' | 'stopped'. */
+    /** One of: 'idle' | 'tracking' | 'stopped'. */
     type: string;
     /**
-     * Only populated when `type === 'paused'`. One of:
-     * 'permissionRevoked' | 'locationDisabled' | 'unknown'.
+     * Only populated when `type === 'stopped'`. One of:
+     * 'user' | 'permissionDenied' | 'locationServicesDisabled' | 'system'.
      */
-    pauseReason?: string;
+    stopReason?: string;
 };
 export interface Spec extends TurboModule {
-    initialize(): Promise<void>;
     configure(config: WireConfig): Promise<void>;
     start(): Promise<void>;
     stop(): Promise<void>;
-    shutdown(): Promise<void>;
-    history(fromMs: number, toMs: number): Promise<WirePosition[]>;
+    history(fromMs: number, toMs: number): Promise<WireLocation[]>;
     readonly onState: CodegenTypes.EventEmitter<WireState>;
-    readonly onPosition: CodegenTypes.EventEmitter<WirePosition>;
+    readonly onLocation: CodegenTypes.EventEmitter<WireLocation>;
 }
 declare const _default: Spec;
 export default _default;

package/lib/typescript/src/NativeBeekonRn.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"NativeBeekonRn.d.ts","sourceRoot":"","sources":["../../../src/NativeBeekonRn.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAG9D,MAAM,MAAM,uBAAuB,GAAG;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,gBAAgB,EAAE,MAAM,CAAC;CAC1B,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG;IACvB,kDAAkD;IAClD,MAAM,EAAE,MAAM,CAAC;IACf,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,mBAAmB,CAAC,EAAE,uBAAuB,CAAC;IAC9C,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,SAAS,GAAG;IACtB,uEAAuE;IACvE,IAAI,EAAE,MAAM,CAAC;IACb;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,MAAM,WAAW,IAAK,SAAQ,WAAW;IACvC,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5B,SAAS,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACtB,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1B,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;IAE/D,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC;IACvD,QAAQ,CAAC,UAAU,EAAE,YAAY,CAAC,YAAY,CAAC,YAAY,CAAC,CAAC;CAC9D;;AAED,wBAAkE"}
+{"version":3,"file":"NativeBeekonRn.d.ts","sourceRoot":"","sources":["../../../src/NativeBeekonRn.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAG9D,MAAM,MAAM,uBAAuB,GAAG;IACpC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG;IACvB,8EAA8E;IAC9E,eAAe,EAAE,MAAM,CAAC;IACxB,8EAA8E;IAC9E,cAAc,EAAE,MAAM,CAAC;IACvB,+CAA+C;IAC/C,mBAAmB,CAAC,EAAE,uBAAuB,CAAC;CAC/C,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,EAAE,MAAM,CAAC;IACpB,2EAA2E;IAC3E,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB,CAAC;AAEF,MAAM,MAAM,SAAS,GAAG;IACtB,+CAA+C;IAC/C,IAAI,EAAE,MAAM,CAAC;IACb;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,MAAM,WAAW,IAAK,SAAQ,WAAW;IACvC,SAAS,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACtB,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;IAE/D,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC;IACvD,QAAQ,CAAC,UAAU,EAAE,YAAY,CAAC,YAAY,CAAC,YAAY,CAAC,CAAC;CAC9D;;AAED,wBAAkE"}