spotny-sdk 0.5.5 → 0.6.2

package/README.md

@@ -65,12 +65,18 @@ import {
 export default function App() {
   useEffect(() => {
     // 1. Initialize once before anything else
-    initialize({ source: 'nike', maxDetectionDistance: 10 });
+    initialize({
+      token: 'YOUR_SDK_TOKEN', // required — from your Spotny dashboard
+      source: 'nike',
+      maxDetectionDistance: 10,
+    });
 
     // 2. Listen for nearby beacons
     const beaconSub = addBeaconsRangedListener(({ beacons, region }) => {
       beacons.forEach((b) =>
-        console.log(`${b.major}/${b.minor} — ${b.distance.toFixed(1)}m (${b.proximity})`)
+        console.log(
+          `${b.major}/${b.minor} — ${b.distance.toFixed(1)}m (${b.proximity})`
+        )
       );
     });
 
@@ -103,16 +109,18 @@ export default function App() {
 
 **Must be called before any other SDK function.** Configures the SDK with your brand settings.
 
-| Option                    | Type     | Default | Description                                                    |
-| ------------------------- | -------- | ------- | -------------------------------------------------------------- |
-| `source`                  | `string` | –       | Your brand or app identifier (e.g. `'nike'`). Sent with every tracking event. |
-| `maxDetectionDistance`    | `number` | `8.0`   | Maximum detection radius in metres. Beacons beyond this are ignored. |
-| `distanceCorrectionFactor`| `number` | `0.5`   | Multiplier applied to raw RSSI distance. Tune for your beacon TX power. |
+| Option                     | Type     | Default      | Description                                                                                                     |
+| -------------------------- | -------- | ------------ | --------------------------------------------------------------------------------------------------------------- |
+| `token`                    | `string` | **required** | SDK token issued by Spotny for your app. Verified against the backend — rejects with `UNAUTHORIZED` if invalid. |
+| `source`                   | `string` | –            | Your brand or app identifier (e.g. `'nike'`). Sent with every tracking event.                                   |
+| `maxDetectionDistance`     | `number` | `8.0`        | Maximum detection radius in metres. Beacons beyond this are ignored.                                            |
+| `distanceCorrectionFactor` | `number` | `0.5`        | Multiplier applied to raw RSSI distance. Tune for your beacon TX power.                                         |
 
-Returns `Promise<string>`.
+Returns `Promise<string>`. **Rejects** if the token is missing, invalid, or the network request fails — handle the error before calling `startScanner()`.
 
 ```ts
 await initialize({
+  token: 'YOUR_SDK_TOKEN',
   source: 'nike',
   maxDetectionDistance: 10,
   distanceCorrectionFactor: 0.5,
@@ -179,13 +187,13 @@ sub.remove(); // call on cleanup
 
 Each beacon in the array:
 
-| Field       | Type     | Description                                                     |
-| ----------- | -------- | --------------------------------------------------------------- |
-| `uuid`      | `string` | Beacon proximity UUID                                           |
-| `major`     | `number` | Beacon major value                                              |
-| `minor`     | `number` | Beacon minor value                                              |
-| `distance`  | `number` | Estimated distance in metres (after correction factor applied)   |
-| `rssi`      | `number` | Raw signal strength in dBm                                      |
+| Field       | Type     | Description                                                    |
+| ----------- | -------- | -------------------------------------------------------------- |
+| `uuid`      | `string` | Beacon proximity UUID                                          |
+| `major`     | `number` | Beacon major value                                             |
+| `minor`     | `number` | Beacon minor value                                             |
+| `distance`  | `number` | Estimated distance in metres (after correction factor applied) |
+| `rssi`      | `number` | Raw signal strength in dBm                                     |
 | `proximity` | `string` | `'immediate'` \| `'near'` \| `'far'` \| `'unknown'`            |
 
 ---
@@ -196,8 +204,8 @@ Fires when the user enters or exits a beacon region. Works in foreground, backgr
 
 ```ts
 const sub = addBeaconRegionListener(({ event, region, state }) => {
-  if (event === 'enter')      console.log('Entered region', region);
-  if (event === 'exit')       console.log('Left region', region);
+  if (event === 'enter') console.log('Entered region', region);
+  if (event === 'exit') console.log('Left region', region);
   if (event === 'determined') console.log('State for', region, '→', state);
 });
 

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

@@ -49,6 +49,8 @@ class SpotnySdkModule(private val reactContext: ReactApplicationContext) :
   private var distanceCorrectionFactor = 0.5
   /** Company/brand name identifying the SDK consumer (e.g. "nike"). */
   private var source: String?       = null
+  /** Bearer token used to authorise all API calls. Set during initialize(). */
+  private var sdkToken: String?     = null
 
   // ── Timing constants ──────────────────────────────────────────────────────
   private var campaignFetchCooldown         = 5_000L  // ms
@@ -139,8 +141,32 @@ class SpotnySdkModule(private val reactContext: ReactApplicationContext) :
     config?.getDouble("distanceCorrectionFactor")
       .takeIf { config?.hasKey("distanceCorrectionFactor") == true && it > 0 }
       ?.let { distanceCorrectionFactor = it; Log.d(TAG, "distanceCorrectionFactor = $it") }
-    Log.d(TAG, "SDK initialized")
-    promise.resolve("SDK initialized")
+    val token = config?.getString("token")?.takeIf { it.isNotBlank() }
+    if (token == null) {
+      promise.reject("MISSING_TOKEN", "initialize() requires a token")
+      return
+    }
+    sdkToken = token
+
+    // Verify the token — device_id and source are sent as headers automatically
+    post("/api/app/sdk/verify", emptyMap()) { status, _ ->
+      when {
+        status in 200..299 -> {
+          Log.d(TAG, "SDK initialized and authorized (source: $source)")
+          promise.resolve("SDK initialized")
+        }
+        status == 401 || status == 403 -> {
+          sdkToken = null
+          Log.w(TAG, "Token unauthorized ($status)")
+          promise.reject("UNAUTHORIZED", "Invalid or expired SDK token")
+        }
+        else -> {
+          sdkToken = null
+          Log.w(TAG, "Verification failed ($status)")
+          promise.reject("VERIFY_FAILED", "SDK verification returned status $status")
+        }
+      }
+    }
   }
 
   override fun requestNotificationPermissions(promise: Promise) {
@@ -173,9 +199,7 @@ class SpotnySdkModule(private val reactContext: ReactApplicationContext) :
 
   override fun identify(userId: String, promise: Promise) {
     identifiedUserId = userId
-    val payload = mutableMapOf<String, Any?>("device_id" to getDeviceId(), "user_id" to userId)
-    source?.let { payload["source"] = it }
-    post("/api/app/users/identify", payload) { status, _ ->
+    post("/api/app/users/identify", mapOf("user_id" to userId)) { status, _ ->
       if (status in 200..299) {
         Log.d(TAG, "Identified user $userId")
         promise.resolve("User identified")
@@ -220,7 +244,6 @@ class SpotnySdkModule(private val reactContext: ReactApplicationContext) :
   // ── Range notifier ────────────────────────────────────────────────────────
 
   private val rangeNotifier = RangeNotifier { beacons, region ->
-    val deviceId = getDeviceId()
     val now = System.currentTimeMillis()
 
     // JS event payload
@@ -260,13 +283,13 @@ class SpotnySdkModule(private val reactContext: ReactApplicationContext) :
       if (activeCampaigns.containsKey(key)) {
         val isFirst = !lastProximityEventSent.containsKey(key)
         if (isFirst) {
-          sendProximity("NEARBY", key, distance, deviceId)
+          sendProximity("NEARBY", key, distance)
           lastProximityDistance[key] = distance
           lastProximityEventSent[key] = now
         } else if (distance >= 1.0) {
           val lastDist = lastProximityDistance[key] ?: 0.0
           if (abs(distance - lastDist) >= proximityDistanceThreshold) {
-            sendProximity("NEARBY", key, distance, deviceId)
+            sendProximity("NEARBY", key, distance)
             lastProximityDistance[key] = distance
             lastProximityEventSent[key] = now
           }
@@ -275,12 +298,12 @@ class SpotnySdkModule(private val reactContext: ReactApplicationContext) :
         if (campaign?.campaignId != null && campaign.inQueue == false && distance <= impressionDistance) {
           val lastImp = lastImpressionEventSent[key]
           if (lastImp == null || now - lastImp >= impressionEventInterval) {
-            sendImpression(key, distance, deviceId)
+            sendImpression(key, distance)
             lastImpressionEventSent[key] = now
           }
         }
       } else {
-        fetchCampaign(major, minor, deviceId)
+        fetchCampaign(major, minor)
       }
     }
   }
@@ -305,9 +328,8 @@ class SpotnySdkModule(private val reactContext: ReactApplicationContext) :
         putString("event",  "exit")
       }
       sendEvent("onBeaconRegionEvent", payload)
-      val deviceId = getDeviceId()
       for (key in activeCampaigns.keys.toList()) {
-        cleanupBeacon(key, deviceId)
+        cleanupBeacon(key)
       }
       try { beaconManager.stopRangingBeaconsInRegion(region) } catch (_: RemoteException) {}
     }
@@ -362,8 +384,8 @@ class SpotnySdkModule(private val reactContext: ReactApplicationContext) :
 
   // ── State cleanup ─────────────────────────────────────────────────────────
 
-  private fun cleanupBeacon(key: String, deviceId: String) {
-    sendProximity("PROXIMITY_EXIT", key, 0.0, deviceId)
+  private fun cleanupBeacon(key: String) {
+    sendProximity("PROXIMITY_EXIT", key, 0.0)
     activeCampaigns.remove(key)
     lastProximityEventSent.remove(key)
     lastProximityDistance.remove(key)
@@ -376,12 +398,11 @@ class SpotnySdkModule(private val reactContext: ReactApplicationContext) :
   }
 
   private fun cleanupAllState() {
-    val deviceId = getDeviceId()
     // 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)
+        cleanupBeacon(key)
       }, index * 300L)
     }
   }
@@ -398,6 +419,9 @@ class SpotnySdkModule(private val reactContext: ReactApplicationContext) :
         val conn = (URL("$backendURL$endpoint").openConnection() as HttpURLConnection).apply {
           requestMethod = "POST"
           setRequestProperty("Content-Type", "application/json")
+          setRequestProperty("X-Device-ID", getDeviceId())
+          sdkToken?.let { setRequestProperty("Authorization", "Bearer $it") }
+          source?.let   { setRequestProperty("X-Source", it) }
           connectTimeout = 10_000
           readTimeout    = 10_000
           doOutput = true
@@ -436,7 +460,7 @@ class SpotnySdkModule(private val reactContext: ReactApplicationContext) :
 
   // ── Campaign fetching ─────────────────────────────────────────────────────
 
-  private fun fetchCampaign(major: Int, minor: Int, deviceId: String) {
+  private fun fetchCampaign(major: Int, minor: Int) {
     val key = beaconKey(major, minor)
     if (activeCampaigns.containsKey(key)) return
     if (fetchInProgress[key] == true) return
@@ -447,9 +471,8 @@ class SpotnySdkModule(private val reactContext: ReactApplicationContext) :
     lastCampaignFetchAttempt[key] = System.currentTimeMillis()
     fetchInProgress[key] = true
 
-    val payload = mutableMapOf<String, Any?>("beacon_id" to key, "device_id" to deviceId)
+    val payload = mutableMapOf<String, Any?>("beacon_id" to key)
     identifiedUserId?.let { payload["user_id"] = it }
-    source?.let           { payload["source"]  = it }
 
     post("/api/app/campaigns/beacon", payload) { status, body ->
       fetchInProgress[key] = false
@@ -487,7 +510,6 @@ class SpotnySdkModule(private val reactContext: ReactApplicationContext) :
     eventType: String,
     key: String,
     distance: Double,
-    deviceId: String,
     endpoint: String
   ) {
     val isImpression = eventType == "IMPRESSION_HEARTBEAT"
@@ -509,14 +531,12 @@ class SpotnySdkModule(private val reactContext: ReactApplicationContext) :
 
     val payload = mutableMapOf<String, Any?>(
       "event_type" to eventType,
-      "device_id"  to deviceId,
       "distance"   to distance,
       "screen_id"  to campaign.screenId
     )
     campaign.campaignId?.let { payload["campaign_id"] = it }
     campaign.sessionId?.let  { payload["session_id"]  = it }
     identifiedUserId?.let    { payload["user_id"]     = it }
-    source?.let              { payload["source"]      = it }
 
     post(endpoint, payload) { status, body ->
       if (status in 200..299) {
@@ -546,11 +566,11 @@ class SpotnySdkModule(private val reactContext: ReactApplicationContext) :
     }
   }
 
-  private fun sendProximity(eventType: String, key: String, distance: Double, deviceId: String) =
-    sendTracking(eventType, key, distance, deviceId, "/api/app/impressions/proximity")
+  private fun sendProximity(eventType: String, key: String, distance: Double) =
+    sendTracking(eventType, key, distance, "/api/app/impressions/proximity")
 
-  private fun sendImpression(key: String, distance: Double, deviceId: String) =
-    sendTracking("IMPRESSION_HEARTBEAT", key, distance, deviceId, "/api/app/impressions/track")
+  private fun sendImpression(key: String, distance: Double) =
+    sendTracking("IMPRESSION_HEARTBEAT", key, distance, "/api/app/impressions/track")
 
   // ── Minimal JSON parser (avoids org.json / GSON dependency) ──────────────
   // Only handles flat and one-level-deep objects. For this SDK, that is enough.

package/ios/SpotnyBeaconScanner.swift

@@ -61,6 +61,8 @@ public class SpotnyBeaconScanner: NSObject {
   private var distanceCorrectionFactor: Double = 0.5
   /// Company/brand name that identifies the SDK consumer (e.g. "nike").
   private var source: String?
+  /// Bearer token used to authorise all API calls. Set during initialize().
+  private var sdkToken: String?
 
   // ── Session TTL ────────────────────────────────────────────────────────────
   /// Sessions older than this when the app resumes are considered stale (crash / force-quit).
@@ -196,6 +198,7 @@ public class SpotnyBeaconScanner: NSObject {
     resolve: @escaping (Any?) -> Void,
     reject: @escaping (String?, String?, Error?) -> Void
   ) {
+    // Apply config values
     if let dist = config["maxDetectionDistance"] as? Double {
       maxDetectionDistance = dist
       print("⚙️ SpotnySDK: maxDetectionDistance = \(dist)m")
@@ -208,8 +211,35 @@ public class SpotnyBeaconScanner: NSObject {
       distanceCorrectionFactor = factor
       print("⚙️ SpotnySDK: distanceCorrectionFactor = \(factor)")
     }
-    print("✅ SpotnySDK: Initialized")
-    resolve("SDK initialized")
+    guard let token = config["token"] as? String, !token.isEmpty else {
+      reject("MISSING_TOKEN", "initialize() requires a token", nil)
+      return
+    }
+    sdkToken = token
+
+    // Verify the token — device_id and source are sent as headers automatically
+    post(endpoint: "/api/app/sdk/verify", payload: [:]) { [weak self] result in
+      guard let self = self else { return }
+      switch result {
+      case .success(let (status, _)):
+        if 200...299 ~= status {
+          print("✅ SpotnySDK: Initialized and authorized (source: \(self.source ?? "none"))")
+          resolve("SDK initialized")
+        } else if status == 401 || status == 403 {
+          self.sdkToken = nil
+          print("❌ SpotnySDK: Token unauthorized (\(status))")
+          reject("UNAUTHORIZED", "Invalid or expired SDK token", nil)
+        } else {
+          self.sdkToken = nil
+          print("❌ SpotnySDK: Verification failed (\(status))")
+          reject("VERIFY_FAILED", "SDK verification returned status \(status)", nil)
+        }
+      case .failure(let error):
+        self.sdkToken = nil
+        print("❌ SpotnySDK: Verification network error — \(error.localizedDescription)")
+        reject("VERIFY_ERROR", error.localizedDescription, error)
+      }
+    }
   }
 
   @objc
@@ -260,8 +290,7 @@ public class SpotnyBeaconScanner: NSObject {
     reject: @escaping (String?, String?, Error?) -> Void
   ) {
     identifiedUserId = userId
-    var payload: [String: Any] = ["device_id": getDeviceId(), "user_id": userId]
-    if let src = source { payload["source"] = src }
+    let payload: [String: Any] = ["user_id": userId]
     post(endpoint: "/api/app/users/identify", payload: payload) { result in
       switch result {
       case .success(let (status, _)):
@@ -444,6 +473,10 @@ public class SpotnyBeaconScanner: NSObject {
     var req = URLRequest(url: url)
     req.httpMethod = "POST"
     req.setValue("application/json", forHTTPHeaderField: "Content-Type")
+    if let token = sdkToken { req.setValue("Bearer \(token)", forHTTPHeaderField: "Authorization") }
+    // device_id and source injected on every request — backend can verify without parsing the body
+    req.setValue(getDeviceId(), forHTTPHeaderField: "X-Device-ID")
+    if let src = source { req.setValue(src, forHTTPHeaderField: "X-Source") }
     req.timeoutInterval = 10.0
 
     var bg: UIBackgroundTaskIdentifier = .invalid
@@ -478,7 +511,7 @@ public class SpotnyBeaconScanner: NSObject {
     return campaignFetchCooldown * pow(3.0, Double(min(retries, 3)))
   }
 
-  private func fetchCampaign(major: Int, minor: Int, deviceId: String) {
+  private func fetchCampaign(major: Int, minor: Int) {
     let key = beaconKey(major: major, minor: minor)
     guard activeCampaigns[key] == nil else { return }
     guard fetchInProgress[key] != true else { return }
@@ -491,9 +524,8 @@ public class SpotnyBeaconScanner: NSObject {
     lastCampaignFetchAttempt[key] = Date()
     fetchInProgress[key] = true
 
-    var payload: [String: Any] = ["beacon_id": key, "device_id": deviceId]
+    var payload: [String: Any] = ["beacon_id": key]
     if let uid = identifiedUserId { payload["user_id"] = uid }
-    if let src = source           { payload["source"]  = src }
 
     post(endpoint: "/api/app/campaigns/beacon", payload: payload) { [weak self] result in
       guard let self = self else { return }
@@ -541,7 +573,6 @@ public class SpotnyBeaconScanner: NSObject {
     eventType: String,
     key: String,
     distance: Double,
-    deviceId: String,
     endpoint: String
   ) {
     let isImpression = eventType == "IMPRESSION_HEARTBEAT"
@@ -564,14 +595,12 @@ public class SpotnyBeaconScanner: NSObject {
 
     var payload: [String: Any] = [
       "event_type": eventType,
-      "device_id":  deviceId,
       "distance":   distance,
       "screen_id":  campaign.screenId
     ]
     if let cid = campaign.campaignId { payload["campaign_id"] = cid }
     if let sid = campaign.sessionId  { payload["session_id"]  = sid }
     if let uid = identifiedUserId    { payload["user_id"]     = uid }
-    if let src = source              { payload["source"]      = src }
 
     post(endpoint: endpoint, payload: payload) { [weak self] result in
       guard let self = self else { return }
@@ -608,20 +637,20 @@ public class SpotnyBeaconScanner: NSObject {
     }
   }
 
-  private func sendProximity(eventType: String, key: String, distance: Double, deviceId: String) {
+  private func sendProximity(eventType: String, key: String, distance: Double) {
     sendTracking(eventType: eventType, key: key, distance: distance,
-                 deviceId: deviceId, endpoint: "/api/app/impressions/proximity")
+                 endpoint: "/api/app/impressions/proximity")
   }
 
-  private func sendImpression(key: String, distance: Double, deviceId: String) {
+  private func sendImpression(key: String, distance: Double) {
     sendTracking(eventType: "IMPRESSION_HEARTBEAT", key: key, distance: distance,
-                 deviceId: deviceId, endpoint: "/api/app/impressions/track")
+                 endpoint: "/api/app/impressions/track")
   }
 
   // MARK: - State Cleanup
 
-  private func cleanupBeacon(_ key: String, deviceId: String, distance: Double = 0) {
-    sendProximity(eventType: "PROXIMITY_EXIT", key: key, distance: distance, deviceId: deviceId)
+  private func cleanupBeacon(_ key: String, distance: Double = 0) {
+    sendProximity(eventType: "PROXIMITY_EXIT", key: key, distance: distance)
     activeCampaigns.removeValue(forKey: key)
     lastProximityEventSent.removeValue(forKey: key)
     lastProximityDistance.removeValue(forKey: key)
@@ -635,12 +664,11 @@ public class SpotnyBeaconScanner: NSObject {
   }
 
   private func cleanupAllProximityState() {
-    let deviceId = getDeviceId()
     // 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)
+        self?.cleanupBeacon(key)
       }
     }
   }
@@ -669,7 +697,6 @@ extension SpotnyBeaconScanner: KTKBeaconManagerDelegate {
     didRangeBeacons beacons: [CLBeacon],
     in region: KTKBeaconRegion
   ) {
-    let deviceId = getDeviceId()
     let now = Date()
 
     // Refresh session heartbeat every 60 s to prevent TTL expiry on a live session
@@ -724,13 +751,13 @@ extension SpotnyBeaconScanner: KTKBeaconManagerDelegate {
         let isFirst = lastProximityEventSent[key] == nil
 
         if isFirst {
-          sendProximity(eventType: "NEARBY", key: key, distance: distance, deviceId: deviceId)
+          sendProximity(eventType: "NEARBY", key: key, distance: distance)
           lastProximityDistance[key] = distance
           lastProximityEventSent[key] = now
         } else if distance >= 1.0,
                   let lastDist = lastProximityDistance[key],
                   abs(distance - lastDist) >= proximityDistanceThreshold {
-          sendProximity(eventType: "NEARBY", key: key, distance: distance, deviceId: deviceId)
+          sendProximity(eventType: "NEARBY", key: key, distance: distance)
           lastProximityDistance[key] = distance
           lastProximityEventSent[key] = now
         }
@@ -739,16 +766,16 @@ extension SpotnyBeaconScanner: KTKBeaconManagerDelegate {
         if let _ = campaign.campaignId, !campaign.inQueue, distance <= impressionDistance {
           if let last = lastImpressionEventSent[key] {
             if now.timeIntervalSince(last) >= impressionEventInterval {
-              sendImpression(key: key, distance: distance, deviceId: deviceId)
+              sendImpression(key: key, distance: distance)
               lastImpressionEventSent[key] = now
             }
           } else {
-            sendImpression(key: key, distance: distance, deviceId: deviceId)
+            sendImpression(key: key, distance: distance)
             lastImpressionEventSent[key] = now
           }
         }
       } else {
-        fetchCampaign(major: major, minor: minor, deviceId: deviceId)
+        fetchCampaign(major: major, minor: minor)
       }
     }
   }
@@ -773,7 +800,7 @@ extension SpotnyBeaconScanner: KTKBeaconManagerDelegate {
       lastCampaignFetchAttempt.removeValue(forKey: key)
       fetchRetryCount.removeValue(forKey: key)
       if activeCampaigns[key] == nil {
-        fetchCampaign(major: major, minor: minor, deviceId: getDeviceId())
+        fetchCampaign(major: major, minor: minor)
       }
     }
   }
@@ -792,7 +819,7 @@ extension SpotnyBeaconScanner: KTKBeaconManagerDelegate {
 
     let parts = region.identifier.components(separatedBy: "_")
     if parts.count == 3, let major = Int(parts[1]), let minor = Int(parts[2]) {
-      cleanupBeacon(beaconKey(major: major, minor: minor), deviceId: getDeviceId())
+      cleanupBeacon(beaconKey(major: major, minor: minor))
     }
 
     beaconManager.stopRangingBeacons(in: region)

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","stopScanner","isScanning","initialize","config","identify","userId","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,OAAO,SAASC,YAAYA,CAAA,EAAoB;EAC9C,OAAON,eAAe,CAACM,YAAY,CAAC,CAAC;AACvC;;AAEA;AACA,OAAO,SAASC,WAAWA,CAAA,EAAoB;EAC7C,OAAOP,eAAe,CAACO,WAAW,CAAC,CAAC;AACtC;;AAEA;AACA,OAAO,SAASC,UAAUA,CAAA,EAAqB;EAC7C,OAAOR,eAAe,CAACQ,UAAU,CAAC,CAAC;AACrC;;AAEA;;AAEA;AACA;AACA;AACA,OAAO,SAASC,UAAUA,CAACC,MAAuB,EAAmB;EACnE,OAAOV,eAAe,CAACS,UAAU,CAACC,MAAgB,CAAC;AACrD;;AAEA;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,QAAQA,CAACC,MAAc,EAAmB;EACxD,OAAOZ,eAAe,CAACW,QAAQ,CAACC,MAAM,CAAC;AACzC;;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","stopScanner","isScanning","initialize","config","identify","userId","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;;AA0CA;AACA,MAAMC,YAAY,GAAG,IAAIN,kBAAkB,CAACC,aAAa,CAACM,SAAS,CAAC;;AAEpE;;AAEA;AACA,OAAO,SAASC,YAAYA,CAAA,EAAoB;EAC9C,OAAON,eAAe,CAACM,YAAY,CAAC,CAAC;AACvC;;AAEA;AACA,OAAO,SAASC,WAAWA,CAAA,EAAoB;EAC7C,OAAOP,eAAe,CAACO,WAAW,CAAC,CAAC;AACtC;;AAEA;AACA,OAAO,SAASC,UAAUA,CAAA,EAAqB;EAC7C,OAAOR,eAAe,CAACQ,UAAU,CAAC,CAAC;AACrC;;AAEA;;AAEA;AACA;AACA;AACA,OAAO,SAASC,UAAUA,CAACC,MAAuB,EAAmB;EACnE,OAAOV,eAAe,CAACS,UAAU,CAACC,MAAgB,CAAC;AACrD;;AAEA;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,QAAQA,CAACC,MAAc,EAAmB;EACxD,OAAOZ,eAAe,CAACW,QAAQ,CAACC,MAAM,CAAC;AACzC;;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

@@ -23,10 +23,15 @@ export type BeaconRegionEvent = {
     state?: 'inside' | 'outside' | 'unknown';
 };
 export type SpotnySdkConfig = {
-    /** Maximum BLE detection distance in metres (default: 8.0) */
-    maxDetectionDistance?: number;
+    /**
+     * SDK token issued by Spotny for your app.
+     * Verified against the backend during initialize(). Required.
+     */
+    token: string;
     /** Identifier for your brand or app (e.g. 'nike'). */
     source?: string;
+    /** Maximum BLE detection distance in metres (default: 8.0) */
+    maxDetectionDistance?: number;
     /**
      * Multiplier applied to raw RSSI-derived distance to compensate for device
      * TX power variance (default: 0.5, tuned for Kontakt.io -12 dBm beacons).

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;IAChB;;;OAGG;IACH,wBAAwB,CAAC,EAAE,MAAM,CAAC;CACnC,CAAC;AAOF,6BAA6B;AAC7B,wBAAgB,YAAY,IAAI,OAAO,CAAC,MAAM,CAAC,CAE9C;AAED,mDAAmD;AACnD,wBAAgB,WAAW,IAAI,OAAO,CAAC,MAAM,CAAC,CAE7C;AAED,uDAAuD;AACvD,wBAAgB,UAAU,IAAI,OAAO,CAAC,OAAO,CAAC,CAE7C;AAID;;GAEG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC,CAEnE;AAID;;;;;;;;GAQG;AACH,wBAAgB,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAExD;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;;;OAGG;IACH,KAAK,EAAE,MAAM,CAAC;IACd,sDAAsD;IACtD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,8DAA8D;IAC9D,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B;;;OAGG;IACH,wBAAwB,CAAC,EAAE,MAAM,CAAC;CACnC,CAAC;AAOF,6BAA6B;AAC7B,wBAAgB,YAAY,IAAI,OAAO,CAAC,MAAM,CAAC,CAE9C;AAED,mDAAmD;AACnD,wBAAgB,WAAW,IAAI,OAAO,CAAC,MAAM,CAAC,CAE7C;AAED,uDAAuD;AACvD,wBAAgB,UAAU,IAAI,OAAO,CAAC,OAAO,CAAC,CAE7C;AAID;;GAEG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC,CAEnE;AAID;;;;;;;;GAQG;AACH,wBAAgB,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAExD;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.5.5",
+  "version": "0.6.2",
   "description": "Beacon Scanner",
   "main": "./lib/module/index.js",
   "types": "./lib/typescript/src/index.d.ts",

package/src/index.tsx

@@ -33,10 +33,15 @@ export type BeaconRegionEvent = {
 };
 
 export type SpotnySdkConfig = {
-  /** Maximum BLE detection distance in metres (default: 8.0) */
-  maxDetectionDistance?: number;
+  /**
+   * SDK token issued by Spotny for your app.
+   * Verified against the backend during initialize(). Required.
+   */
+  token: string;
   /** Identifier for your brand or app (e.g. 'nike'). */
   source?: string;
+  /** Maximum BLE detection distance in metres (default: 8.0) */
+  maxDetectionDistance?: number;
   /**
    * Multiplier applied to raw RSSI-derived distance to compensate for device
    * TX power variance (default: 0.5, tuned for Kontakt.io -12 dBm beacons).