@wayq/beekon-rn 0.0.1

package/ios/BeekonRn.swift

@@ -0,0 +1,211 @@
+import Foundation
+import BeekonKit
+
+/// Swift impl of the Beekon RN TurboModule. Bridges the actor-based native
+/// SDK (`BeekonKit.Beekon.shared`) to the ObjC TurboModule conformance in
+/// `BeekonRn.mm`. All public-facing methods take ObjC-compatible callbacks
+/// (resolver/rejecter) and dictionaries so they can be invoked from `.mm`.
+///
+/// Event delivery: `BeekonRn.mm` constructs this with two closures that call
+/// the codegen-generated `emitOnState:` / `emitOnPosition:` ObjC methods on
+/// the spec; the closures are invoked from the per-stream `Task`s started
+/// during `initialize`.
+@objc public final class BeekonRnImpl: NSObject {
+
+  private let onStateCb: (NSDictionary) -> Void
+  private let onPositionCb: (NSDictionary) -> Void
+
+  private var stateTask: Task<Void, Never>?
+  private var positionsTask: Task<Void, Never>?
+
+  @objc public init(
+    onState: @escaping (NSDictionary) -> Void,
+    onPosition: @escaping (NSDictionary) -> Void
+  ) {
+    self.onStateCb = onState
+    self.onPositionCb = onPosition
+    super.init()
+  }
+
+  // MARK: - Lifecycle
+
+  @objc public func initializeWithResolver(
+    _ resolve: @escaping (Any?) -> Void,
+    rejecter reject: @escaping (String?, String?, Error?) -> Void
+  ) {
+    Task { [weak self] in
+      guard let self = self else { return }
+      do {
+        try await Beekon.shared.initialize()
+        // Idempotent: cancel any prior collectors before starting new ones.
+        self.stateTask?.cancel()
+        self.positionsTask?.cancel()
+        self.stateTask = Task { [weak self] in
+          guard let self = self else { return }
+          for await state in await Beekon.shared.state {
+            self.onStateCb(self.stateToWire(state))
+          }
+        }
+        self.positionsTask = Task { [weak self] in
+          guard let self = self else { return }
+          for await pos in await Beekon.shared.positions {
+            self.onPositionCb(self.positionToWire(pos))
+          }
+        }
+        resolve(nil)
+      } catch {
+        reject(self.errorCode(error), error.localizedDescription, error)
+      }
+    }
+  }
+
+  @objc public func configure(
+    _ config: NSDictionary,
+    resolver resolve: @escaping RCTPromiseResolveBlock,
+    rejecter reject: @escaping RCTPromiseRejectBlock
+  ) {
+    Task { [weak self] in
+      guard let self = self else { return }
+      do {
+        let cfg = try self.wireToConfig(config)
+        await Beekon.shared.configure(cfg)
+        resolve(nil)
+      } catch {
+        reject(self.errorCode(error), error.localizedDescription, error)
+      }
+    }
+  }
+
+  @objc public func startWithResolver(
+    _ resolve: @escaping (Any?) -> Void,
+    rejecter reject: @escaping (String?, String?, Error?) -> Void
+  ) {
+    Task { [weak self] in
+      guard let self = self else { return }
+      do {
+        try await Beekon.shared.start()
+        resolve(nil)
+      } catch {
+        reject(self.errorCode(error), error.localizedDescription, error)
+      }
+    }
+  }
+
+  @objc public func stopWithResolver(
+    _ resolve: @escaping (Any?) -> Void,
+    rejecter reject: @escaping (String?, String?, Error?) -> Void
+  ) {
+    Task { [weak self] in
+      guard let self = self else { return }
+      await Beekon.shared.stop()
+      resolve(nil)
+    }
+  }
+
+  @objc public func shutdownWithResolver(
+    _ resolve: @escaping (Any?) -> Void,
+    rejecter reject: @escaping (String?, String?, Error?) -> Void
+  ) {
+    Task { [weak self] in
+      guard let self = self else { return }
+      self.stateTask?.cancel()
+      self.positionsTask?.cancel()
+      await Beekon.shared.shutdown()
+      resolve(nil)
+    }
+  }
+
+  @objc public func historyFromMs(
+    _ fromMs: Double,
+    toMs: Double,
+    resolver resolve: @escaping RCTPromiseResolveBlock,
+    rejecter reject: @escaping RCTPromiseRejectBlock
+  ) {
+    Task { [weak self] in
+      guard let self = self else { return }
+      do {
+        let from = Date(timeIntervalSince1970: fromMs / 1000.0)
+        let to = Date(timeIntervalSince1970: toMs / 1000.0)
+        let positions = try await Beekon.shared.history(from: from, to: to)
+        let arr = positions.map { self.positionToWire($0) }
+        resolve(arr)
+      } catch {
+        reject(self.errorCode(error), error.localizedDescription, error)
+      }
+    }
+  }
+
+  // MARK: - Mappers
+
+  private func wireToConfig(_ d: NSDictionary) throws -> BeekonConfig {
+    let presetStr = (d["preset"] as? String) ?? "balanced"
+    let preset: Preset
+    switch presetStr {
+    case "saver": preset = .saver
+    case "precision": preset = .precision
+    default: preset = .balanced
+    }
+
+    let distanceFilterMeters = d["distanceFilterMeters"] as? Double
+    // JS sends millis; iOS BeekonConfig wants seconds. Normalize here.
+    let intervalSeconds: Double?
+    if let ms = d["intervalMillis"] as? Double {
+      intervalSeconds = ms / 1000.0
+    } else {
+      intervalSeconds = nil
+    }
+    let licenseKey = d["licenseKey"] as? String
+
+    return BeekonConfig(
+      preset: preset,
+      distanceFilterMeters: distanceFilterMeters,
+      intervalSeconds: intervalSeconds,
+      licenseKey: licenseKey
+    )
+  }
+
+  private func positionToWire(_ p: Position) -> NSDictionary {
+    return [
+      "lat": p.lat,
+      "lng": p.lng,
+      "accuracy": p.accuracy,
+      "speed": p.speed,
+      "bearing": p.bearing,
+      "altitude": p.altitude,
+      "timestampMs": p.timestamp.timeIntervalSince1970 * 1000.0,
+    ]
+  }
+
+  private func stateToWire(_ s: BeekonState) -> NSDictionary {
+    switch s {
+    case .idle: return ["type": "idle"]
+    case .starting: return ["type": "starting"]
+    case .tracking: return ["type": "tracking"]
+    case .stopped: return ["type": "stopped"]
+    case .paused(let reason):
+      let r: String
+      switch reason {
+      case .permissionRevoked: r = "permissionRevoked"
+      case .locationDisabled: r = "locationDisabled"
+      case .unknown: r = "unknown"
+      }
+      return ["type": "paused", "pauseReason": r]
+    }
+  }
+
+  /// Maps native `BeekonError` cases to stable string codes shared with
+  /// Android. JS-side error handling can switch on these without per-platform
+  /// branches.
+  private func errorCode(_ e: Error) -> String {
+    if let be = e as? BeekonError {
+      switch be {
+      case .permissionDenied: return "PERMISSION_DENIED"
+      case .locationServicesDisabled: return "LOCATION_SERVICES_DISABLED"
+      case .notConfigured: return "NOT_CONFIGURED"
+      case .notInitialised: return "NOT_INITIALISED"
+      case .internalError: return "INTERNAL_ERROR"
+      }
+    }
+    return "INTERNAL_ERROR"
+  }
+}

package/ios/Frameworks/BeekonKit.xcframework/Info.plist

@@ -0,0 +1,44 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+	<key>AvailableLibraries</key>
+	<array>
+		<dict>
+			<key>BinaryPath</key>
+			<string>BeekonKit.framework/BeekonKit</string>
+			<key>LibraryIdentifier</key>
+			<string>ios-arm64_x86_64-simulator</string>
+			<key>LibraryPath</key>
+			<string>BeekonKit.framework</string>
+			<key>SupportedArchitectures</key>
+			<array>
+				<string>arm64</string>
+				<string>x86_64</string>
+			</array>
+			<key>SupportedPlatform</key>
+			<string>ios</string>
+			<key>SupportedPlatformVariant</key>
+			<string>simulator</string>
+		</dict>
+		<dict>
+			<key>BinaryPath</key>
+			<string>BeekonKit.framework/BeekonKit</string>
+			<key>LibraryIdentifier</key>
+			<string>ios-arm64</string>
+			<key>LibraryPath</key>
+			<string>BeekonKit.framework</string>
+			<key>SupportedArchitectures</key>
+			<array>
+				<string>arm64</string>
+			</array>
+			<key>SupportedPlatform</key>
+			<string>ios</string>
+		</dict>
+	</array>
+	<key>CFBundlePackageType</key>
+	<string>XFWK</string>
+	<key>XCFrameworkFormatVersion</key>
+	<string>1.0</string>
+</dict>
+</plist>

package/ios/Frameworks/BeekonKit.xcframework/LICENSE.txt

@@ -0,0 +1,14 @@
+Beekon SDK
+Copyright (c) 2026 wayqteam. All rights reserved.
+
+This software is licensed for evaluation use only. No production deployment,
+redistribution, sublicensing, or commercial use is permitted without a separate
+written agreement with wayqteam.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
+FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
+COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY ARISING
+FROM USE OF THE SOFTWARE.
+
+For licensing inquiries: contact wayqteam.

package/ios/Frameworks/BeekonKit.xcframework/_CodeSignature/CodeResources

@@ -0,0 +1,233 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+	<key>files</key>
+	<dict>
+		<key>LICENSE.txt</key>
+		<data>
+		Cd50llceWtwBPWNSIAJRdTfQQiE=
+		</data>
+		<key>ios-arm64/BeekonKit.framework/BeekonKit</key>
+		<data>
+		SyrIBjwS5o/8csiCfKIXmBtvzio=
+		</data>
+		<key>ios-arm64/BeekonKit.framework/Info.plist</key>
+		<data>
+		3d/2OPEwv55L8dW+0woT9NRCNi0=
+		</data>
+		<key>ios-arm64/BeekonKit.framework/PrivacyInfo.xcprivacy</key>
+		<data>
+		+Hzj9e+o3dYoDboCDA7ofM2a0kc=
+		</data>
+		<key>ios-arm64/BeekonKit.framework/_CodeSignature/CodeResources</key>
+		<data>
+		iZuijJG0soEo1jfi0V3NeqZXX4s=
+		</data>
+		<key>ios-arm64_x86_64-simulator/BeekonKit.framework/BeekonKit</key>
+		<data>
+		cEmeEm6qJLQueaJja0nxBKt+nEA=
+		</data>
+		<key>ios-arm64_x86_64-simulator/BeekonKit.framework/Info.plist</key>
+		<data>
+		w9rsPHfS6nhyFAFD48jpWHGzYuc=
+		</data>
+		<key>ios-arm64_x86_64-simulator/BeekonKit.framework/PrivacyInfo.xcprivacy</key>
+		<data>
+		+Hzj9e+o3dYoDboCDA7ofM2a0kc=
+		</data>
+		<key>ios-arm64_x86_64-simulator/BeekonKit.framework/_CodeSignature/CodeResources</key>
+		<data>
+		hbmbyZ85ag/7tawlrdWmUyumzVo=
+		</data>
+	</dict>
+	<key>files2</key>
+	<dict>
+		<key>LICENSE.txt</key>
+		<dict>
+			<key>hash</key>
+			<data>
+			Cd50llceWtwBPWNSIAJRdTfQQiE=
+			</data>
+			<key>hash2</key>
+			<data>
+			PDylgJZfZxoKTHUmgv6aK1hRYtMtH4titPlIb7e5iRY=
+			</data>
+		</dict>
+		<key>ios-arm64/BeekonKit.framework/BeekonKit</key>
+		<dict>
+			<key>hash</key>
+			<data>
+			SyrIBjwS5o/8csiCfKIXmBtvzio=
+			</data>
+			<key>hash2</key>
+			<data>
+			sJNDsLwayhdCOxwHz2nvh5hWAy7aH+1xYTklkXYLTVo=
+			</data>
+		</dict>
+		<key>ios-arm64/BeekonKit.framework/Info.plist</key>
+		<dict>
+			<key>hash</key>
+			<data>
+			3d/2OPEwv55L8dW+0woT9NRCNi0=
+			</data>
+			<key>hash2</key>
+			<data>
+			pwRHyHj1JmPCiUn+GAAwVdCWQOj+rrrs7WDjyfqTwcE=
+			</data>
+		</dict>
+		<key>ios-arm64/BeekonKit.framework/PrivacyInfo.xcprivacy</key>
+		<dict>
+			<key>hash</key>
+			<data>
+			+Hzj9e+o3dYoDboCDA7ofM2a0kc=
+			</data>
+			<key>hash2</key>
+			<data>
+			E3plr2RiT1CPWdLg5VfDUw1k7yShykpszuDqfKG4YYw=
+			</data>
+		</dict>
+		<key>ios-arm64/BeekonKit.framework/_CodeSignature/CodeResources</key>
+		<dict>
+			<key>hash</key>
+			<data>
+			iZuijJG0soEo1jfi0V3NeqZXX4s=
+			</data>
+			<key>hash2</key>
+			<data>
+			qgFb+LKTIRzW2w+dr7F9VFD6m1FpP0HSjHBtgwKpkxk=
+			</data>
+		</dict>
+		<key>ios-arm64_x86_64-simulator/BeekonKit.framework/BeekonKit</key>
+		<dict>
+			<key>hash</key>
+			<data>
+			cEmeEm6qJLQueaJja0nxBKt+nEA=
+			</data>
+			<key>hash2</key>
+			<data>
+			1OteRVaQF1w/938f/tCgu7XydD6pJkclY8MQ8rUpc4c=
+			</data>
+		</dict>
+		<key>ios-arm64_x86_64-simulator/BeekonKit.framework/Info.plist</key>
+		<dict>
+			<key>hash</key>
+			<data>
+			w9rsPHfS6nhyFAFD48jpWHGzYuc=
+			</data>
+			<key>hash2</key>
+			<data>
+			Yr1G0VwEkAQ7fULqXaAcgXxuiXyV2ANn7hepvYQTcDo=
+			</data>
+		</dict>
+		<key>ios-arm64_x86_64-simulator/BeekonKit.framework/PrivacyInfo.xcprivacy</key>
+		<dict>
+			<key>hash</key>
+			<data>
+			+Hzj9e+o3dYoDboCDA7ofM2a0kc=
+			</data>
+			<key>hash2</key>
+			<data>
+			E3plr2RiT1CPWdLg5VfDUw1k7yShykpszuDqfKG4YYw=
+			</data>
+		</dict>
+		<key>ios-arm64_x86_64-simulator/BeekonKit.framework/_CodeSignature/CodeResources</key>
+		<dict>
+			<key>hash</key>
+			<data>
+			hbmbyZ85ag/7tawlrdWmUyumzVo=
+			</data>
+			<key>hash2</key>
+			<data>
+			wi0JVImM9cRW0rzNqoJGY96gS/irH4VrWsZvyoVDhZE=
+			</data>
+		</dict>
+	</dict>
+	<key>rules</key>
+	<dict>
+		<key>^.*</key>
+		<true/>
+		<key>^.*\.lproj/</key>
+		<dict>
+			<key>optional</key>
+			<true/>
+			<key>weight</key>
+			<real>1000</real>
+		</dict>
+		<key>^.*\.lproj/locversion.plist$</key>
+		<dict>
+			<key>omit</key>
+			<true/>
+			<key>weight</key>
+			<real>1100</real>
+		</dict>
+		<key>^Base\.lproj/</key>
+		<dict>
+			<key>weight</key>
+			<real>1010</real>
+		</dict>
+		<key>^version.plist$</key>
+		<true/>
+	</dict>
+	<key>rules2</key>
+	<dict>
+		<key>.*\.dSYM($|/)</key>
+		<dict>
+			<key>weight</key>
+			<real>11</real>
+		</dict>
+		<key>^(.*/)?\.DS_Store$</key>
+		<dict>
+			<key>omit</key>
+			<true/>
+			<key>weight</key>
+			<real>2000</real>
+		</dict>
+		<key>^.*</key>
+		<true/>
+		<key>^.*\.lproj/</key>
+		<dict>
+			<key>optional</key>
+			<true/>
+			<key>weight</key>
+			<real>1000</real>
+		</dict>
+		<key>^.*\.lproj/locversion.plist$</key>
+		<dict>
+			<key>omit</key>
+			<true/>
+			<key>weight</key>
+			<real>1100</real>
+		</dict>
+		<key>^Base\.lproj/</key>
+		<dict>
+			<key>weight</key>
+			<real>1010</real>
+		</dict>
+		<key>^Info\.plist$</key>
+		<dict>
+			<key>omit</key>
+			<true/>
+			<key>weight</key>
+			<real>20</real>
+		</dict>
+		<key>^PkgInfo$</key>
+		<dict>
+			<key>omit</key>
+			<true/>
+			<key>weight</key>
+			<real>20</real>
+		</dict>
+		<key>^embedded\.provisionprofile$</key>
+		<dict>
+			<key>weight</key>
+			<real>20</real>
+		</dict>
+		<key>^version\.plist$</key>
+		<dict>
+			<key>weight</key>
+			<real>20</real>
+		</dict>
+	</dict>
+</dict>
+</plist>

package/ios/Frameworks/BeekonKit.xcframework/ios-arm64/BeekonKit.framework/PrivacyInfo.xcprivacy

@@ -0,0 +1,77 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<!--
+  Beekon iOS SDK Privacy Manifest
+
+  Source of truth: this file. Included two ways:
+    1. SwiftPM resource via Package.swift `.copy("PrivacyInfo.xcprivacy")`.
+    2. Copied to each BeekonKit.framework/ root by scripts/build-xcframework.sh
+       so binary consumers of the xcframework find it at the Apple-required
+       location.
+
+  Required by Apple for SDKs distributed via SwiftPM since mid-2024. Validated
+  at App Store submission time when consumers archive an app embedding Beekon.
+
+  See https://developer.apple.com/documentation/bundleresources/privacy_manifest_files
+-->
+<plist version="1.0">
+<dict>
+    <!-- We do not track users across apps or websites. -->
+    <key>NSPrivacyTracking</key>
+    <false/>
+    <key>NSPrivacyTrackingDomains</key>
+    <array/>
+
+    <!--
+      Collected data. Beekon collects precise location for the host app's own
+      functionality (live tracking + history). Data is stored locally in the
+      host app's container (GRDB SQLite) and is not linked to user identity
+      from the SDK's perspective. The host app may link it to a user; that's
+      the host's call to declare in its own manifest.
+    -->
+    <key>NSPrivacyCollectedDataTypes</key>
+    <array>
+        <dict>
+            <key>NSPrivacyCollectedDataType</key>
+            <string>NSPrivacyCollectedDataTypePreciseLocation</string>
+            <key>NSPrivacyCollectedDataTypeLinked</key>
+            <false/>
+            <key>NSPrivacyCollectedDataTypeTracking</key>
+            <false/>
+            <key>NSPrivacyCollectedDataTypePurposes</key>
+            <array>
+                <string>NSPrivacyCollectedDataTypePurposeAppFunctionality</string>
+            </array>
+        </dict>
+    </array>
+
+    <!--
+      Required-Reason APIs we use:
+        - UserDefaults (CA92.1): StateHolder/TrackingPersistence stores the
+          last-known tracking config in the com.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.
+      Reason codes per https://developer.apple.com/documentation/bundleresources/privacy_manifest_files/describing_use_of_required_reason_api
+    -->
+    <key>NSPrivacyAccessedAPITypes</key>
+    <array>
+        <dict>
+            <key>NSPrivacyAccessedAPIType</key>
+            <string>NSPrivacyAccessedAPICategoryUserDefaults</string>
+            <key>NSPrivacyAccessedAPITypeReasons</key>
+            <array>
+                <string>CA92.1</string>
+            </array>
+        </dict>
+        <dict>
+            <key>NSPrivacyAccessedAPIType</key>
+            <string>NSPrivacyAccessedAPICategoryFileTimestamp</string>
+            <key>NSPrivacyAccessedAPITypeReasons</key>
+            <array>
+                <string>3B52.1</string>
+            </array>
+        </dict>
+    </array>
+</dict>
+</plist>