spotny-sdk 1.0.0 → 1.0.2

package/README.md

@@ -68,7 +68,7 @@ export default function App() {
     initialize({
       token: 'YOUR_SDK_TOKEN', // from your Spotny dashboard
       apiKey: 'your-brand-key', // identifies your app/brand
-      userId: currentUser.id, // your authenticated user ID
+      identifierId: currentUser.id, // your authenticated user ID
       maxDetectionDistance: 10,
     });
 
@@ -110,23 +110,23 @@ export default function App() {
 
 **Must be called before any other SDK function.** Authenticates with the Spotny backend and obtains a session JWT that is automatically used for all subsequent API calls.
 
-| Option                     | Type     | Default      | Description                                                                                                                                |
-| -------------------------- | -------- | ------------ | ------------------------------------------------------------------------------------------------------------------------------------------ |
-| `token`                    | `string` | **required** | SDK token issued by Spotny for your app. Verified against the backend — rejects with `UNAUTHORIZED` if invalid.                            |
-| `apiKey`                   | `string` | **required** | Identifies your brand or app (e.g. `'nike'`). Sent to the backend during verification.                                                     |
-| `userId`                   | `string` | **required** | ID of the authenticated user (e.g. database UUID, hashed email). Embedded in the session JWT so all tracking events are tied to this user. |
-| `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.                                            |
+| `apiKey`                   | `string` | **required** | Identifies your brand or app (e.g. `'nike'`). Sent to the backend during verification.                                                                     |
+| `identifierId`             | `string` | **required** | Unique identifier for the authenticated user (e.g. database UUID, hashed email). Embedded in the session JWT so all tracking events are tied to this user. |
+| `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>`. **Rejects** if any required field is missing, the token is invalid, or the network request fails — handle the error before calling `startScanner()`.
 
-> **Note:** The SDK is designed for authenticated (logged-in) users. Call `initialize()` after the user has signed in so their `userId` is available.
+> **Note:** The SDK is designed for authenticated (logged-in) users. Call `initialize()` after the user has signed in so their `identifierId` is available.
 
 ```ts
 await initialize({
   token: 'YOUR_SDK_TOKEN',
   apiKey: 'nike',
-  userId: currentUser.id,
+  identifierId: currentUser.id,
   maxDetectionDistance: 10,
   distanceCorrectionFactor: 0.5,
 });
@@ -274,7 +274,7 @@ Returns `Promise<Object>`.
 5. `IMPRESSION_HEARTBEAT` events are sent every 10 s when the user is within 2 m of an active campaign.
 6. On exit, `PROXIMITY_EXIT` is sent and all state is cleaned up.
 
-All events are tied to the authenticated `userId` supplied during `initialize()` — no additional identity calls are required.
+All events are tied to the authenticated `identifierId` supplied during `initialize()` — no additional identity calls are required.
 
 ---
 

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

@@ -38,12 +38,13 @@ class SpotnySdkModule(private val reactContext: ReactApplicationContext) :
 
   // ── Session state ─────────────────────────────────────────────────────────
   @Volatile private var scanning       = false
-  /** Authenticated user ID — required at initialize(). Embedded in JWT via /api/app/sdk/verify. */
-  private var userId: String? = null
+  /** Authenticated identifier — required at initialize(). Embedded in JWT via /api/app/sdk/verify. */
+  private var identifierId: String? = null
 
   // ── Configuration ─────────────────────────────────────────────────────────
-  // backendURL is fixed — not overridable by consumers.
+  // backendURL and apiBasePath are fixed — not overridable by consumers.
   private val backendURL            = "https://api.spotny.app"
+  private val apiBasePath           = "/api/app/sdk"
   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
@@ -101,7 +102,7 @@ class SpotnySdkModule(private val reactContext: ReactApplicationContext) :
     sdkToken      = prefs.getString("jwt", null)
     sdkCredential = prefs.getString("sdkCredential", null)
     apiKey        = prefs.getString("sdkApiKey", null)
-    userId        = prefs.getString("sdkUserId", null)
+    identifierId  = prefs.getString("sdkIdentifierId", null)
     val expiry    = prefs.getLong("jwtExpiry", -1L).takeIf { it > 0 }
     if (expiry != null) sdkTokenExpiry = expiry
     Log.d(TAG, "Resuming session (device: ${getDeviceId()})")
@@ -161,17 +162,17 @@ class SpotnySdkModule(private val reactContext: ReactApplicationContext) :
       promise.reject("MISSING_API_KEY", "initialize() requires an apiKey")
       return
     }
-    config?.getString("userId")?.takeIf { it.isNotBlank() }?.let { userId = it }
-    val uid = userId?.takeIf { it.isNotBlank() }
+    config?.getString("identifierId")?.takeIf { it.isNotBlank() }?.let { identifierId = it }
+    val uid = identifierId?.takeIf { it.isNotBlank() }
     if (uid == null) {
-      promise.reject("MISSING_USER_ID", "initialize() requires a userId")
+      promise.reject("MISSING_IDENTIFIER_ID", "initialize() requires an identifierId")
       return
     }
 
-    // Send token + apiKey + userId to backend — response returns a JWT used for all subsequent calls
+    // Send token + apiKey + identifierId to backend — response returns a JWT used for all subsequent calls
     // sdkToken is null here so no Authorization header is injected on this call
     val verifyPayload = mapOf("token" to token, "api_key" to key, "user_id" to uid)
-    post("/api/app/sdk/verify", verifyPayload) { status, body ->
+    post("$apiBasePath/verify", verifyPayload) { status, body ->
       when {
         status in 200..299 -> {
           val verifyJson = try { parseJsonObject(body) } catch (_: Exception) { null }
@@ -438,7 +439,7 @@ class SpotnySdkModule(private val reactContext: ReactApplicationContext) :
     sdkToken?.let       { prefs.putString("jwt",           it) }
     sdkCredential?.let  { prefs.putString("sdkCredential", it) }
     apiKey?.let         { prefs.putString("sdkApiKey",     it) }
-    userId?.let         { prefs.putString("sdkUserId",     it) }
+    identifierId?.let   { prefs.putString("sdkIdentifierId", it) }
     sdkTokenExpiry?.let { prefs.putLong("jwtExpiry",      it) }
     prefs.apply()
   }
@@ -448,14 +449,14 @@ class SpotnySdkModule(private val reactContext: ReactApplicationContext) :
     val credential = sdkCredential ?: return false
     val key        = apiKey        ?: return false
     return try {
-      val conn = (URL("$backendURL/api/app/sdk/verify").openConnection() as HttpURLConnection).apply {
+      val conn = (URL("$backendURL$apiBasePath/verify").openConnection() as HttpURLConnection).apply {
         requestMethod = "POST"
         setRequestProperty("Content-Type", "application/json")
         connectTimeout = 10_000
         readTimeout    = 10_000
         doOutput = true
       }
-      conn.outputStream.use { it.write(buildJsonString(mapOf("token" to credential, "api_key" to key, "user_id" to (userId ?: ""))).toByteArray()) }
+      conn.outputStream.use { it.write(buildJsonString(mapOf("token" to credential, "api_key" to key, "user_id" to (identifierId ?: ""))).toByteArray()) }
       val status   = conn.responseCode
       val response = try { conn.inputStream.bufferedReader().readText() }
                      catch (_: Exception) { conn.errorStream?.bufferedReader()?.readText() ?: "" }
@@ -485,7 +486,7 @@ class SpotnySdkModule(private val reactContext: ReactApplicationContext) :
   ) {
     ioExecutor.execute {
       // Auto-refresh JWT before every call except verify itself
-      if (endpoint != "/api/app/sdk/verify" && isTokenExpired()) {
+      if (endpoint != "$apiBasePath/verify" && isTokenExpired()) {
         if (!refreshJWTBlocking()) {
           reactContext.runOnUiQueueThread { completion(-1, "") }
           return@execute
@@ -547,7 +548,7 @@ class SpotnySdkModule(private val reactContext: ReactApplicationContext) :
 
     val payload = mutableMapOf<String, Any?>("beacon_id" to key)
 
-    post("/api/app/campaigns/beacon", payload) { status, body ->
+    post("$apiBasePath/distribute", payload) { status, body ->
       fetchInProgress[key] = false
       if (status != 200) {
         Log.w(TAG, "Campaign fetch status $status for beacon $key")
@@ -639,10 +640,10 @@ class SpotnySdkModule(private val reactContext: ReactApplicationContext) :
   }
 
   private fun sendProximity(eventType: String, key: String, distance: Double) =
-    sendTracking(eventType, key, distance, "/api/app/impressions/proximity")
+    sendTracking(eventType, key, distance, "$apiBasePath/proximity")
 
   private fun sendImpression(key: String, distance: Double) =
-    sendTracking("IMPRESSION_HEARTBEAT", key, distance, "/api/app/impressions/track")
+    sendTracking("IMPRESSION_HEARTBEAT", key, distance, "$apiBasePath/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

@@ -42,8 +42,8 @@ public class SpotnyBeaconScanner: NSObject {
 
   // ── Session state ─────────────────────────────────────────────────────────
   private var scanning: Bool = false
-  /// Authenticated user ID — required at initialize(). Embedded in the JWT via /api/app/sdk/verify.
-  private var userId: String?
+  /// Authenticated identifier — required at initialize(). Embedded in the JWT via /api/app/sdk/verify.
+  private var identifierId: String?
 
   // ── JS event deduplication ─────────────────────────────────────────
   /// Signature of the last emitted `onBeaconsRanged` payload (sorted major_minor_proximity).
@@ -54,6 +54,7 @@ public class SpotnyBeaconScanner: NSObject {
   // ── Configuration ────────────────────────────────────────────────────────────
   // backendURL and kontaktAPIKey are fixed — not overridable by consumers.
   private let backendURL: String = "https://api.spotny.app"
+  private let apiBasePath: String = "/api/app/sdk"
   private let kontaktAPIKey: String = "mgrz08TOKNHafeY02cWIs9mxUHbynNQJ"
   private var maxDetectionDistance: Double = 8.0
   /// Multiplier applied to raw RSSI-derived distance to compensate for low TX power.
@@ -141,7 +142,7 @@ public class SpotnyBeaconScanner: NSObject {
     sdkToken      = keychainRead(key: "SpotnySDK_jwt")
     sdkCredential = keychainRead(key: "SpotnySDK_sdkCredential")
     apiKey        = keychainRead(key: "SpotnySDK_apiKey")
-    userId        = keychainRead(key: "SpotnySDK_userId")
+    identifierId  = keychainRead(key: "SpotnySDK_identifierId")
     if let expiryStr = keychainRead(key: "SpotnySDK_jwtExpiry"), let ts = Double(expiryStr) {
       sdkTokenExpiry = Date(timeIntervalSince1970: ts)
     }
@@ -226,8 +227,8 @@ public class SpotnyBeaconScanner: NSObject {
       distanceCorrectionFactor = factor
       print("⚙️ SpotnySDK: distanceCorrectionFactor = \(factor)")
     }
-    if let uid = config["userId"] as? String, !uid.isEmpty {
-      userId = uid
+    if let uid = config["identifierId"] as? String, !uid.isEmpty {
+      identifierId = uid
     }
     guard let token = config["token"] as? String, !token.isEmpty else {
       reject("MISSING_TOKEN", "initialize() requires a token", nil)
@@ -237,15 +238,15 @@ public class SpotnyBeaconScanner: NSObject {
       reject("MISSING_API_KEY", "initialize() requires an apiKey", nil)
       return
     }
-    guard let uid = userId, !uid.isEmpty else {
-      reject("MISSING_USER_ID", "initialize() requires a userId", nil)
+    guard let uid = identifierId, !uid.isEmpty else {
+      reject("MISSING_IDENTIFIER_ID", "initialize() requires an identifierId", nil)
       return
     }
 
-    // Send token + apiKey + userId to backend — response returns a JWT used for all subsequent calls
+    // Send token + apiKey + identifierId to backend — response returns a JWT used for all subsequent calls
     // sdkToken is nil here so no Authorization header is injected on this call
-    let verifyPayload: [String: Any] = ["token": token, "api_key": key, "user_id": uid]
-    post(endpoint: "/api/app/sdk/verify", payload: verifyPayload) { [weak self] result in
+    let verifyPayload: [String: Any] = ["token": token, "api_key": key, "identifier_id": uid]
+    post(endpoint: "\(apiBasePath)/verify", payload: verifyPayload) { [weak self] result in
       guard let self = self else { return }
       switch result {
       case .success(let (status, data)):
@@ -483,7 +484,7 @@ public class SpotnyBeaconScanner: NSObject {
     if let exp  = sdkTokenExpiry { keychainWrite(key: "SpotnySDK_jwtExpiry",     value: String(exp.timeIntervalSince1970)) }
     if let cred = sdkCredential  { keychainWrite(key: "SpotnySDK_sdkCredential", value: cred) }
     if let key  = apiKey         { keychainWrite(key: "SpotnySDK_apiKey",        value: key)  }
-    if let uid  = userId         { keychainWrite(key: "SpotnySDK_userId",        value: uid)  }
+    if let uid  = identifierId   { keychainWrite(key: "SpotnySDK_identifierId",  value: uid)  }
   }
 
   /// Refresh the JWT. Concurrent callers are queued and flushed together when the single
@@ -499,8 +500,8 @@ public class SpotnyBeaconScanner: NSObject {
       return
     }
     jwtRefreshInProgress = true
-    let refreshPayload: [String: Any] = ["token": credential, "api_key": key, "user_id": userId ?? ""]
-    performPost(endpoint: "/api/app/sdk/verify", payload: refreshPayload) { [weak self] result in
+    let refreshPayload: [String: Any] = ["token": credential, "api_key": key, "identifier_id": identifierId ?? ""]
+    performPost(endpoint: "\(apiBasePath)/verify", payload: refreshPayload) { [weak self] result in
       guard let self = self else { return }
       let flush: (Error?) -> Void = { err in
         let queue = self.jwtRefreshQueue
@@ -542,7 +543,7 @@ public class SpotnyBeaconScanner: NSObject {
     payload: [String: Any],
     completion: @escaping (Result<(Int, Data), Error>) -> Void
   ) {
-    guard endpoint == "/api/app/sdk/verify" || !isTokenExpired() else {
+    guard endpoint == "\(apiBasePath)/verify" || !isTokenExpired() else {
       refreshJWT { [weak self] error in
         if let error = error { completion(.failure(error)); return }
         self?.performPost(endpoint: endpoint, payload: payload, completion: completion)
@@ -615,7 +616,7 @@ public class SpotnyBeaconScanner: NSObject {
 
     let payload: [String: Any] = ["beacon_id": key]
 
-    post(endpoint: "/api/app/campaigns/beacon", payload: payload) { [weak self] result in
+    post(endpoint: "\(apiBasePath)/distribute", payload: payload) { [weak self] result in
       guard let self = self else { return }
       defer { self.fetchInProgress[key] = false }
 
@@ -726,12 +727,12 @@ public class SpotnyBeaconScanner: NSObject {
 
   private func sendProximity(eventType: String, key: String, distance: Double) {
     sendTracking(eventType: eventType, key: key, distance: distance,
-                 endpoint: "/api/app/impressions/proximity")
+                 endpoint: "\(apiBasePath)/proximity")
   }
 
   private func sendImpression(key: String, distance: Double) {
     sendTracking(eventType: "IMPRESSION_HEARTBEAT", key: key, distance: distance,
-                 endpoint: "/api/app/impressions/track")
+                 endpoint: "\(apiBasePath)/track")
   }
 
   // MARK: - State Cleanup

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

@@ -34,10 +34,10 @@ export type SpotnySdkConfig = {
      */
     apiKey: string;
     /**
-     * ID of the authenticated user (e.g. database UUID, hashed email).
+     * Unique identifier for the authenticated user (e.g. database UUID, hashed email).
      * Embedded in the JWT so all tracking events are tied to this user. Required.
      */
-    userId: string;
+    identifierId: string;
     /** Maximum BLE detection distance in metres (default: 8.0) */
     maxDetectionDistance?: number;
     /**

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;;;OAGG;IACH,KAAK,EAAE,MAAM,CAAC;IACd;;;OAGG;IACH,MAAM,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,MAAM,EAAE,MAAM,CAAC;IACf,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,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;;;OAGG;IACH,MAAM,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,YAAY,EAAE,MAAM,CAAC;IACrB,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,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": "1.0.0",
+  "version": "1.0.2",
   "description": "Beacon Scanner",
   "main": "./lib/module/index.js",
   "types": "./lib/typescript/src/index.d.ts",

package/src/index.tsx

@@ -44,10 +44,10 @@ export type SpotnySdkConfig = {
    */
   apiKey: string;
   /**
-   * ID of the authenticated user (e.g. database UUID, hashed email).
+   * Unique identifier for the authenticated user (e.g. database UUID, hashed email).
    * Embedded in the JWT so all tracking events are tied to this user. Required.
    */
-  userId: string;
+  identifierId: string;
   /** Maximum BLE detection distance in metres (default: 8.0) */
   maxDetectionDistance?: number;
   /**