spotny-sdk 0.4.0 → 0.4.1

package/android/src/main/java/com/spotnysdk/SpotnySdkModule.kt

@@ -45,6 +45,8 @@ class SpotnySdkModule(private val reactContext: ReactApplicationContext) :
   // backendURL is fixed — not overridable by consumers.
   private val backendURL            = "https://api.spotny.app"
   private var maxDetectionDistance  = 8.0  // metres
+  /** Multiplier applied to raw BLE distance. Default 0.5 matches Kontakt.io -12 dBm beacons. */
+  private var distanceCorrectionFactor = 0.5
   /** Company/brand name identifying the SDK consumer (e.g. "nike"). */
   private var source: String?       = null
 
@@ -140,6 +142,9 @@ class SpotnySdkModule(private val reactContext: ReactApplicationContext) :
     config?.getDouble("maxDetectionDistance").takeIf { config?.hasKey("maxDetectionDistance") == true }
       ?.let { maxDetectionDistance = it; Log.d(TAG, "maxDetectionDistance = $it m") }
     config?.getString("source")?.let { source = it; Log.d(TAG, "source = $it") }
+    config?.getDouble("distanceCorrectionFactor")
+      .takeIf { config?.hasKey("distanceCorrectionFactor") == true && it > 0 }
+      ?.let { distanceCorrectionFactor = it; Log.d(TAG, "distanceCorrectionFactor = $it") }
     promise.resolve("Configuration updated")
   }
 
@@ -210,7 +215,7 @@ class SpotnySdkModule(private val reactContext: ReactApplicationContext) :
     val jsBeacons = WritableNativeArray()
     for (beacon in beacons) {
       val raw = beacon.distance
-      val adjusted = raw * 0.5
+      val adjusted = raw * distanceCorrectionFactor
       if (adjusted <= 0 || adjusted > maxDetectionDistance) continue
 
       val b = WritableNativeMap().apply {
@@ -236,7 +241,7 @@ class SpotnySdkModule(private val reactContext: ReactApplicationContext) :
       val major    = beacon.id2?.toInt() ?: continue
       val minor    = beacon.id3?.toInt() ?: continue
       val key      = beaconKey(major, minor)
-      val distance = beacon.distance * 0.5
+      val distance = beacon.distance * distanceCorrectionFactor
 
       if (distance <= 0 || distance > maxDetectionDistance) continue
 
@@ -360,7 +365,13 @@ class SpotnySdkModule(private val reactContext: ReactApplicationContext) :
 
   private fun cleanupAllState() {
     val deviceId = getDeviceId()
-    activeCampaigns.keys.toList().forEach { cleanupBeacon(it, deviceId) }
+    // Stagger exit events to avoid firing N simultaneous network requests
+    val keys = activeCampaigns.keys.toList()
+    keys.forEachIndexed { index, key ->
+      android.os.Handler(android.os.Looper.getMainLooper()).postDelayed({
+        cleanupBeacon(key, deviceId)
+      }, index * 300L)
+    }
   }
 
   // ── Backend API ───────────────────────────────────────────────────────────

package/ios/SpotnyBeaconScanner.swift

@@ -50,9 +50,17 @@ public class SpotnyBeaconScanner: NSObject {
   private let backendURL: String = "https://api.spotny.app"
   private let kontaktAPIKey: String = "mgrz08TOKNHafeY02cWIs9mxUHbynNQJ"
   private var maxDetectionDistance: Double = 8.0
+  /// Multiplier applied to raw RSSI-derived distance to compensate for low TX power.
+  /// Overridable via configure(). Default 0.5 matches Kontakt.io -12 dBm beacons.
+  private var distanceCorrectionFactor: Double = 0.5
   /// Company/brand name that identifies the SDK consumer (e.g. "nike").
   private var source: String?
 
+  // ── Session TTL ────────────────────────────────────────────────────────────
+  /// Sessions older than this when the app resumes are considered stale (crash / force-quit).
+  private let sessionTTL: TimeInterval = 24 * 3600  // 24 hours
+  private var lastSessionHeartbeat: Date = .distantPast
+
   // ── Beacon UUID (standard Kontakt.io default) ─────────────────────────────
   private let beaconUUID = UUID(uuidString: "f7826da6-4fa2-4e98-8024-bc5b71e0893e")!
 
@@ -107,6 +115,15 @@ public class SpotnyBeaconScanner: NSObject {
 
   private func resumeStoredSession() {
     guard let stored = UserDefaults.standard.string(forKey: "SpotnySDK_userUUID") else { return }
+    // Discard sessions older than sessionTTL — stale after a crash / force-quit
+    if let ts = UserDefaults.standard.object(forKey: "SpotnySDK_sessionTimestamp") as? Double {
+      let age = Date().timeIntervalSince1970 - ts
+      if age > sessionTTL {
+        print("⚠️ SpotnySDK: Stale session (\(Int(age / 3600))h old) — discarding")
+        clearStoredSession()
+        return
+      }
+    }
     currentUserUUID = stored
     userId = UserDefaults.standard.object(forKey: "SpotnySDK_userId") as? Int
     print("🔄 SpotnySDK: Resuming session for UUID: \(stored)")
@@ -114,6 +131,13 @@ public class SpotnyBeaconScanner: NSObject {
     scanning = true
   }
 
+  private func clearStoredSession() {
+    UserDefaults.standard.removeObject(forKey: "SpotnySDK_userUUID")
+    UserDefaults.standard.removeObject(forKey: "SpotnySDK_userId")
+    UserDefaults.standard.removeObject(forKey: "SpotnySDK_sessionTimestamp")
+    UserDefaults.standard.synchronize()
+  }
+
   // MARK: - ObjC-Exposed Methods (called from SpotnySdk.mm)
 
   @objc
@@ -137,6 +161,7 @@ public class SpotnyBeaconScanner: NSObject {
     } else {
       UserDefaults.standard.removeObject(forKey: "SpotnySDK_userId")
     }
+    UserDefaults.standard.set(Date().timeIntervalSince1970, forKey: "SpotnySDK_sessionTimestamp")
     UserDefaults.standard.synchronize()
 
     let status = locationManager.authorizationStatus
@@ -159,9 +184,7 @@ public class SpotnyBeaconScanner: NSObject {
     beaconManager.stopRangingBeaconsInAllRegions()
     cleanupAllProximityState()
 
-    UserDefaults.standard.removeObject(forKey: "SpotnySDK_userUUID")
-    UserDefaults.standard.removeObject(forKey: "SpotnySDK_userId")
-    UserDefaults.standard.synchronize()
+    clearStoredSession()
 
     scanning = false
     currentUserUUID = nil
@@ -193,6 +216,10 @@ public class SpotnyBeaconScanner: NSObject {
       source = src
       print("⚙️ SpotnySDK: source = \(src)")
     }
+    if let factor = config["distanceCorrectionFactor"] as? Double, factor > 0 {
+      distanceCorrectionFactor = factor
+      print("⚙️ SpotnySDK: distanceCorrectionFactor = \(factor)")
+    }
     resolve("Configuration updated")
   }
 
@@ -578,7 +605,13 @@ public class SpotnyBeaconScanner: NSObject {
 
   private func cleanupAllProximityState() {
     let deviceId = getDeviceId()
-    for key in activeCampaigns.keys { cleanupBeacon(key, deviceId: deviceId) }
+    // Stagger exit events to avoid firing N simultaneous network requests
+    let keys = Array(activeCampaigns.keys)
+    for (index, key) in keys.enumerated() {
+      DispatchQueue.main.asyncAfter(deadline: .now() + Double(index) * 0.3) { [weak self] in
+        self?.cleanupBeacon(key, deviceId: deviceId)
+      }
+    }
   }
 }
 
@@ -608,10 +641,16 @@ extension SpotnyBeaconScanner: KTKBeaconManagerDelegate {
     let deviceId = getDeviceId()
     let now = Date()
 
+    // Refresh session heartbeat every 60 s to prevent TTL expiry on a live session
+    if now.timeIntervalSince(lastSessionHeartbeat) >= 60 {
+      UserDefaults.standard.set(now.timeIntervalSince1970, forKey: "SpotnySDK_sessionTimestamp")
+      lastSessionHeartbeat = now
+    }
+
     // Build the JS event payload for ALL ranged beacons
     let beaconPayload: [[String: Any]] = beacons.compactMap { beacon in
       let raw = beacon.accuracy
-      let adjusted = raw * 0.5  // compensate for low TX power (-12 dBm)
+      let adjusted = raw * distanceCorrectionFactor
       guard adjusted > 0 && adjusted <= maxDetectionDistance else { return nil }
       return [
         "uuid":      beacon.proximityUUID.uuidString,
@@ -633,7 +672,7 @@ extension SpotnyBeaconScanner: KTKBeaconManagerDelegate {
       let minor     = beacon.minor.intValue
       let key       = beaconKey(major: major, minor: minor)
       let raw       = beacon.accuracy
-      let distance  = raw * 0.5
+      let distance  = raw * distanceCorrectionFactor
 
       guard distance > 0 && distance <= maxDetectionDistance else { continue }
 
@@ -678,8 +717,6 @@ extension SpotnyBeaconScanner: KTKBeaconManagerDelegate {
     var bg: UIBackgroundTaskIdentifier = .invalid
     bg = UIApplication.shared.beginBackgroundTask { UIApplication.shared.endBackgroundTask(bg); bg = .invalid }
 
-    beaconManager.startRangingBeacons(in: region)
-
     // Parse major/minor from named regions (e.g. "SpotnySDK_52885_35127")
     let parts = region.identifier.components(separatedBy: "_")
     if parts.count == 3, let major = Int(parts[1]), let minor = Int(parts[2]) {

package/lib/module/index.js.map

@@ -1 +1 @@
-{"version":3,"names":["NativeEventEmitter","NativeModules","NativeSpotnySdk","SpotnyEvents","ON_BEACONS_RANGED","ON_BEACON_REGION_EVENT","eventEmitter","SpotnySdk","startScanner","userUUID","userId","stopScanner","isScanning","configure","config","requestNotificationPermissions","getDebugLogs","clearDebugLogs","setDebounceInterval","interval","clearDebounceCache","getDebounceStatus","addBeaconsRangedListener","callback","addListener","addBeaconRegionListener"],"sourceRoot":"../../src","sources":["index.tsx"],"mappings":";;AAAA,SAASA,kBAAkB,EAAEC,aAAa,QAAQ,cAAc;AAChE,OAAOC,eAAe,MAAM,sBAAmB;;AAE/C;AACA,OAAO,MAAMC,YAAY,GAAG;EAC1BC,iBAAiB,EAAE,iBAAiB;EACpCC,sBAAsB,EAAE;AAC1B,CAAU;;AAEV;;AAgCA;AACA,MAAMC,YAAY,GAAG,IAAIN,kBAAkB,CAACC,aAAa,CAACM,SAAS,CAAC;;AAEpE;;AAEA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,YAAYA,CAC1BC,QAAgB,EAChBC,MAAsB,EACL;EACjB,OAAOR,eAAe,CAACM,YAAY,CAACC,QAAQ,EAAEC,MAAM,IAAI,IAAI,CAAC;AAC/D;;AAEA;AACA,OAAO,SAASC,WAAWA,CAAA,EAAoB;EAC7C,OAAOT,eAAe,CAACS,WAAW,CAAC,CAAC;AACtC;;AAEA;AACA,OAAO,SAASC,UAAUA,CAAA,EAAqB;EAC7C,OAAOV,eAAe,CAACU,UAAU,CAAC,CAAC;AACrC;;AAEA;;AAEA;AACA;AACA;AACA;AACA,OAAO,SAASC,SAASA,CAACC,MAAuB,EAAmB;EAClE,OAAOZ,eAAe,CAACW,SAAS,CAACC,MAAgB,CAAC;AACpD;;AAEA;;AAEA;AACA,OAAO,SAASC,8BAA8BA,CAAA,EAAoB;EAChE,OAAOb,eAAe,CAACa,8BAA8B,CAAC,CAAC;AACzD;;AAEA;;AAEA;AACA,OAAO,SAASC,YAAYA,CAAA,EAAoB;EAC9C,OAAOd,eAAe,CAACc,YAAY,CAAC,CAAC;AACvC;;AAEA;AACA,OAAO,SAASC,cAAcA,CAAA,EAAoB;EAChD,OAAOf,eAAe,CAACe,cAAc,CAAC,CAAC;AACzC;;AAEA;;AAEA;AACA,OAAO,SAASC,mBAAmBA,CAACC,QAAgB,EAAmB;EACrE,OAAOjB,eAAe,CAACgB,mBAAmB,CAACC,QAAQ,CAAC;AACtD;;AAEA;AACA,OAAO,SAASC,kBAAkBA,CAAA,EAAoB;EACpD,OAAOlB,eAAe,CAACkB,kBAAkB,CAAC,CAAC;AAC7C;;AAEA;AACA,OAAO,SAASC,iBAAiBA,CAAA,EAAoB;EACnD,OAAOnB,eAAe,CAACmB,iBAAiB,CAAC,CAAC;AAC5C;;AAEA;;AAEA;AACA;AACA;AACA;AACA,OAAO,SAASC,wBAAwBA,CACtCC,QAA4C,EAC5C;EACA,OAAOjB,YAAY,CAACkB,WAAW,CAC7BrB,YAAY,CAACC,iBAAiB,EAC9BmB,QACF,CAAC;AACH;;AAEA;AACA;AACA;AACA;AACA,OAAO,SAASE,uBAAuBA,CACrCF,QAA4C,EAC5C;EACA,OAAOjB,YAAY,CAACkB,WAAW,CAC7BrB,YAAY,CAACE,sBAAsB,EACnCkB,QACF,CAAC;AACH","ignoreList":[]}
+{"version":3,"names":["NativeEventEmitter","NativeModules","NativeSpotnySdk","SpotnyEvents","ON_BEACONS_RANGED","ON_BEACON_REGION_EVENT","eventEmitter","SpotnySdk","startScanner","userUUID","userId","stopScanner","isScanning","configure","config","requestNotificationPermissions","getDebugLogs","clearDebugLogs","setDebounceInterval","interval","clearDebounceCache","getDebounceStatus","addBeaconsRangedListener","callback","addListener","addBeaconRegionListener"],"sourceRoot":"../../src","sources":["index.tsx"],"mappings":";;AAAA,SAASA,kBAAkB,EAAEC,aAAa,QAAQ,cAAc;AAChE,OAAOC,eAAe,MAAM,sBAAmB;;AAE/C;AACA,OAAO,MAAMC,YAAY,GAAG;EAC1BC,iBAAiB,EAAE,iBAAiB;EACpCC,sBAAsB,EAAE;AAC1B,CAAU;;AAEV;;AAqCA;AACA,MAAMC,YAAY,GAAG,IAAIN,kBAAkB,CAACC,aAAa,CAACM,SAAS,CAAC;;AAEpE;;AAEA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,YAAYA,CAC1BC,QAAgB,EAChBC,MAAsB,EACL;EACjB,OAAOR,eAAe,CAACM,YAAY,CAACC,QAAQ,EAAEC,MAAM,IAAI,IAAI,CAAC;AAC/D;;AAEA;AACA,OAAO,SAASC,WAAWA,CAAA,EAAoB;EAC7C,OAAOT,eAAe,CAACS,WAAW,CAAC,CAAC;AACtC;;AAEA;AACA,OAAO,SAASC,UAAUA,CAAA,EAAqB;EAC7C,OAAOV,eAAe,CAACU,UAAU,CAAC,CAAC;AACrC;;AAEA;;AAEA;AACA;AACA;AACA;AACA,OAAO,SAASC,SAASA,CAACC,MAAuB,EAAmB;EAClE,OAAOZ,eAAe,CAACW,SAAS,CAACC,MAAgB,CAAC;AACpD;;AAEA;;AAEA;AACA,OAAO,SAASC,8BAA8BA,CAAA,EAAoB;EAChE,OAAOb,eAAe,CAACa,8BAA8B,CAAC,CAAC;AACzD;;AAEA;;AAEA;AACA,OAAO,SAASC,YAAYA,CAAA,EAAoB;EAC9C,OAAOd,eAAe,CAACc,YAAY,CAAC,CAAC;AACvC;;AAEA;AACA,OAAO,SAASC,cAAcA,CAAA,EAAoB;EAChD,OAAOf,eAAe,CAACe,cAAc,CAAC,CAAC;AACzC;;AAEA;;AAEA;AACA,OAAO,SAASC,mBAAmBA,CAACC,QAAgB,EAAmB;EACrE,OAAOjB,eAAe,CAACgB,mBAAmB,CAACC,QAAQ,CAAC;AACtD;;AAEA;AACA,OAAO,SAASC,kBAAkBA,CAAA,EAAoB;EACpD,OAAOlB,eAAe,CAACkB,kBAAkB,CAAC,CAAC;AAC7C;;AAEA;AACA,OAAO,SAASC,iBAAiBA,CAAA,EAAoB;EACnD,OAAOnB,eAAe,CAACmB,iBAAiB,CAAC,CAAC;AAC5C;;AAEA;;AAEA;AACA;AACA;AACA;AACA,OAAO,SAASC,wBAAwBA,CACtCC,QAA4C,EAC5C;EACA,OAAOjB,YAAY,CAACkB,WAAW,CAC7BrB,YAAY,CAACC,iBAAiB,EAC9BmB,QACF,CAAC;AACH;;AAEA;AACA;AACA;AACA;AACA,OAAO,SAASE,uBAAuBA,CACrCF,QAA4C,EAC5C;EACA,OAAOjB,YAAY,CAACkB,WAAW,CAC7BrB,YAAY,CAACE,sBAAsB,EACnCkB,QACF,CAAC;AACH","ignoreList":[]}

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

@@ -27,6 +27,11 @@ export type SpotnySdkConfig = {
     maxDetectionDistance?: number;
     /** Identifier for your brand or app (e.g. 'nike'). */
     source?: string;
+    /**
+     * Multiplier applied to raw RSSI-derived distance to compensate for device
+     * TX power variance (default: 0.5, tuned for Kontakt.io -12 dBm beacons).
+     */
+    distanceCorrectionFactor?: number;
 };
 /**
  * Start beacon scanning.

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.tsx"],"names":[],"mappings":"AAIA,eAAO,MAAM,YAAY;;;CAGf,CAAC;AAIX,MAAM,MAAM,UAAU,GAAG;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,mCAAmC;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,+CAA+C;IAC/C,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,OAAO,EAAE,UAAU,EAAE,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,sCAAsC;IACtC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,YAAY,CAAC;IACvC,KAAK,CAAC,EAAE,QAAQ,GAAG,SAAS,GAAG,SAAS,CAAC;CAC1C,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,8DAA8D;IAC9D,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,sDAAsD;IACtD,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAOF;;;;GAIG;AACH,wBAAgB,YAAY,CAC1B,QAAQ,EAAE,MAAM,EAChB,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,GACrB,OAAO,CAAC,MAAM,CAAC,CAEjB;AAED,mDAAmD;AACnD,wBAAgB,WAAW,IAAI,OAAO,CAAC,MAAM,CAAC,CAE7C;AAED,uDAAuD;AACvD,wBAAgB,UAAU,IAAI,OAAO,CAAC,OAAO,CAAC,CAE7C;AAID;;;GAGG;AACH,wBAAgB,SAAS,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC,CAElE;AAID,gEAAgE;AAChE,wBAAgB,8BAA8B,IAAI,OAAO,CAAC,MAAM,CAAC,CAEhE;AAID,yCAAyC;AACzC,wBAAgB,YAAY,IAAI,OAAO,CAAC,MAAM,CAAC,CAE9C;AAED,2CAA2C;AAC3C,wBAAgB,cAAc,IAAI,OAAO,CAAC,MAAM,CAAC,CAEhD;AAID,gEAAgE;AAChE,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAErE;AAED,2DAA2D;AAC3D,wBAAgB,kBAAkB,IAAI,OAAO,CAAC,MAAM,CAAC,CAEpD;AAED,kEAAkE;AAClE,wBAAgB,iBAAiB,IAAI,OAAO,CAAC,MAAM,CAAC,CAEnD;AAID;;;GAGG;AACH,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,CAAC,KAAK,EAAE,iBAAiB,KAAK,IAAI,4CAM7C;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,CAAC,KAAK,EAAE,iBAAiB,KAAK,IAAI,4CAM7C"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.tsx"],"names":[],"mappings":"AAIA,eAAO,MAAM,YAAY;;;CAGf,CAAC;AAIX,MAAM,MAAM,UAAU,GAAG;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,mCAAmC;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,+CAA+C;IAC/C,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,OAAO,EAAE,UAAU,EAAE,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,sCAAsC;IACtC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,YAAY,CAAC;IACvC,KAAK,CAAC,EAAE,QAAQ,GAAG,SAAS,GAAG,SAAS,CAAC;CAC1C,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,8DAA8D;IAC9D,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,sDAAsD;IACtD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,wBAAwB,CAAC,EAAE,MAAM,CAAC;CACnC,CAAC;AAOF;;;;GAIG;AACH,wBAAgB,YAAY,CAC1B,QAAQ,EAAE,MAAM,EAChB,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,GACrB,OAAO,CAAC,MAAM,CAAC,CAEjB;AAED,mDAAmD;AACnD,wBAAgB,WAAW,IAAI,OAAO,CAAC,MAAM,CAAC,CAE7C;AAED,uDAAuD;AACvD,wBAAgB,UAAU,IAAI,OAAO,CAAC,OAAO,CAAC,CAE7C;AAID;;;GAGG;AACH,wBAAgB,SAAS,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC,CAElE;AAID,gEAAgE;AAChE,wBAAgB,8BAA8B,IAAI,OAAO,CAAC,MAAM,CAAC,CAEhE;AAID,yCAAyC;AACzC,wBAAgB,YAAY,IAAI,OAAO,CAAC,MAAM,CAAC,CAE9C;AAED,2CAA2C;AAC3C,wBAAgB,cAAc,IAAI,OAAO,CAAC,MAAM,CAAC,CAEhD;AAID,gEAAgE;AAChE,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAErE;AAED,2DAA2D;AAC3D,wBAAgB,kBAAkB,IAAI,OAAO,CAAC,MAAM,CAAC,CAEpD;AAED,kEAAkE;AAClE,wBAAgB,iBAAiB,IAAI,OAAO,CAAC,MAAM,CAAC,CAEnD;AAID;;;GAGG;AACH,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,CAAC,KAAK,EAAE,iBAAiB,KAAK,IAAI,4CAM7C;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,CAAC,KAAK,EAAE,iBAAiB,KAAK,IAAI,4CAM7C"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "spotny-sdk",
-  "version": "0.4.0",
+  "version": "0.4.1",
   "description": "Beacon Scanner",
   "main": "./lib/module/index.js",
   "types": "./lib/typescript/src/index.d.ts",

package/src/index.tsx

@@ -37,6 +37,11 @@ export type SpotnySdkConfig = {
   maxDetectionDistance?: number;
   /** Identifier for your brand or app (e.g. 'nike'). */
   source?: string;
+  /**
+   * Multiplier applied to raw RSSI-derived distance to compensate for device
+   * TX power variance (default: 0.5, tuned for Kontakt.io -12 dBm beacons).
+   */
+  distanceCorrectionFactor?: number;
 };
 
 // ── Internal event emitter ───────────────────────────────────────────────────