spotny-sdk 0.4.1 → 0.5.0

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

@@ -37,10 +37,14 @@ class SpotnySdkModule(private val reactContext: ReactApplicationContext) :
   private val ioExecutor = Executors.newCachedThreadPool()
 
   // ── Session state ─────────────────────────────────────────────────────────
-  private var currentUserUUID: String? = null
-  private var userId: Int?             = null
   @Volatile private var scanning       = false
 
+  // ── Identity (persisted in SharedPreferences) ────────────────────────
+  private var identifiedUserId: String? = null
+  private var profilePhone: String?     = null
+  private var profileEmail: String?     = null
+  private var profileName: String?      = null
+
   // ── Configuration ─────────────────────────────────────────────────────────
   // backendURL is fixed — not overridable by consumers.
   private val backendURL            = "https://api.spotny.app"
@@ -90,31 +94,30 @@ class SpotnySdkModule(private val reactContext: ReactApplicationContext) :
 
   private fun resumeStoredSession() {
     val prefs = reactContext.getSharedPreferences("SpotnySDK", Context.MODE_PRIVATE)
-    val stored = prefs.getString("userUUID", null) ?: return
-    currentUserUUID = stored
-    val uid = prefs.getInt("userId", -1).takeIf { it != -1 }
-    userId = uid
-    Log.d(TAG, "Resuming session for UUID: $stored")
+    // Reload identity
+    identifiedUserId = prefs.getString("userId", null)
+    profilePhone     = prefs.getString("profilePhone", null)
+    profileEmail     = prefs.getString("profileEmail", null)
+    profileName      = prefs.getString("profileName", null)
+    // Resume scanning only if a valid session was previously active
+    if (!prefs.getBoolean("sessionActive", false)) return
+    Log.d(TAG, "Resuming session (userId: ${identifiedUserId ?: "anonymous"})")
     startBeaconScanning()
     scanning = true
   }
 
   // ── Turbo Module methods ──────────────────────────────────────────────────
 
-  override fun startScanner(userUUID: String, userId: Double?, promise: Promise) {
+  override fun startScanner(promise: Promise) {
     if (scanning) { promise.resolve("Already scanning"); return }
 
-    currentUserUUID = userUUID
-    this.userId = userId?.toInt()
-
     val prefs = reactContext.getSharedPreferences("SpotnySDK", Context.MODE_PRIVATE).edit()
-    prefs.putString("userUUID", userUUID)
-    this.userId?.let { prefs.putInt("userId", it) } ?: prefs.remove("userId")
+    prefs.putBoolean("sessionActive", true)
     prefs.apply()
 
     startBeaconScanning()
     scanning = true
-    Log.d(TAG, "Started scanning for $userUUID")
+    Log.d(TAG, "Started scanning (userId: ${identifiedUserId ?: "anonymous"})")
     promise.resolve("Scanning started")
   }
 
@@ -129,9 +132,9 @@ class SpotnySdkModule(private val reactContext: ReactApplicationContext) :
     cleanupAllState()
 
     val prefs = reactContext.getSharedPreferences("SpotnySDK", Context.MODE_PRIVATE).edit()
-    prefs.remove("userUUID"); prefs.remove("userId"); prefs.apply()
+    prefs.remove("sessionActive"); prefs.apply()
 
-    scanning = false; currentUserUUID = null; userId = null
+    scanning = false
     Log.d(TAG, "Stopped scanning")
     promise.resolve("Scanning stopped")
   }
@@ -174,6 +177,51 @@ class SpotnySdkModule(private val reactContext: ReactApplicationContext) :
     promise.resolve("Debounce cache cleared")
   }
 
+  // ── Identity ──────────────────────────────────────────────────────────────
+
+  override fun identify(userId: String, promise: Promise) {
+    identifiedUserId = userId
+    val prefs = reactContext.getSharedPreferences("SpotnySDK", Context.MODE_PRIVATE).edit()
+    prefs.putString("userId", userId); prefs.apply()
+    Log.d(TAG, "Identified user $userId")
+    promise.resolve("User identified")
+  }
+
+  override fun updateProfile(profile: ReadableMap?, promise: Promise) {
+    val prefs = reactContext.getSharedPreferences("SpotnySDK", Context.MODE_PRIVATE).edit()
+    profile?.getString("phoneNumber")?.let { profilePhone = it; prefs.putString("profilePhone", it) }
+    profile?.getString("email")?.let       { profileEmail = it; prefs.putString("profileEmail", it) }
+    profile?.getString("name")?.let        { profileName  = it; prefs.putString("profileName",  it) }
+    prefs.apply()
+
+    val payload = mutableMapOf<String, Any?>("device_id" to getDeviceId())
+    identifiedUserId?.let { payload["user_id"] = it }
+    profilePhone?.let     { payload["phone"]   = it }
+    profileEmail?.let     { payload["email"]   = it }
+    profileName?.let      { payload["name"]    = it }
+    source?.let           { payload["source"]  = it }
+
+    post("/api/app/profiles/update", payload) { status, _ ->
+      if (status in 200..299) {
+        Log.d(TAG, "Profile updated")
+        promise.resolve("Profile updated")
+      } else {
+        Log.w(TAG, "Profile update failed — status $status")
+        promise.reject("PROFILE_UPDATE_FAILED", "Server returned status $status")
+      }
+    }
+  }
+
+  override fun resetIdentity(promise: Promise) {
+    identifiedUserId = null; profilePhone = null; profileEmail = null; profileName = null
+    val prefs = reactContext.getSharedPreferences("SpotnySDK", Context.MODE_PRIVATE).edit()
+    prefs.remove("userId"); prefs.remove("profilePhone")
+    prefs.remove("profileEmail"); prefs.remove("profileName")
+    prefs.apply()
+    Log.d(TAG, "Identity reset")
+    promise.resolve("Identity reset")
+  }
+
   override fun getDebounceStatus(promise: Promise) {
     val map = WritableNativeMap()
     for ((key, _) in activeCampaigns) {
@@ -436,8 +484,8 @@ class SpotnySdkModule(private val reactContext: ReactApplicationContext) :
     fetchInProgress[key] = true
 
     val payload = mutableMapOf<String, Any?>("beacon_id" to key, "device_id" to deviceId)
-    userId?.let  { payload["user_id"] = it }
-    source?.let  { payload["source"]  = it }
+    identifiedUserId?.let { payload["user_id"] = it }
+    source?.let           { payload["source"]  = it }
 
     post("/api/app/campaigns/beacon", payload) { status, body ->
       fetchInProgress[key] = false
@@ -503,8 +551,8 @@ class SpotnySdkModule(private val reactContext: ReactApplicationContext) :
     )
     campaign.campaignId?.let { payload["campaign_id"] = it }
     campaign.sessionId?.let  { payload["session_id"]  = it }
-    userId?.let              { payload["user_id"]      = it }
-    source?.let              { payload["source"]       = it }
+    identifiedUserId?.let    { payload["user_id"]     = it }
+    source?.let              { payload["source"]      = it }
 
     post(endpoint, payload) { status, body ->
       if (status in 200..299) {

package/ios/SpotnyBeaconScanner.swift

@@ -41,10 +41,14 @@ public class SpotnyBeaconScanner: NSObject {
   private var locationManager: CLLocationManager!
 
   // ── Session state ─────────────────────────────────────────────────────────
-  private var currentUserUUID: String?
-  private var userId: Int?
   private var scanning: Bool = false
 
+  // ── Identity (persisted in Keychain across sessions) ─────────────────────
+  private var identifiedUserId: String?
+  private var profilePhone: String?
+  private var profileEmail: String?
+  private var profileName: String?
+
   // ── Configuration ────────────────────────────────────────────────────────────
   // backendURL and kontaktAPIKey are fixed — not overridable by consumers.
   private let backendURL: String = "https://api.spotny.app"
@@ -114,26 +118,27 @@ 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
-      }
+    // Always reload identity from Keychain (persists across sessions)
+    identifiedUserId = keychainRead(key: "SpotnySDK_userId")
+    profilePhone     = keychainRead(key: "SpotnySDK_profilePhone")
+    profileEmail     = keychainRead(key: "SpotnySDK_profileEmail")
+    profileName      = keychainRead(key: "SpotnySDK_profileName")
+
+    // Resume scanning only if a valid session was previously active
+    guard let ts = UserDefaults.standard.object(forKey: "SpotnySDK_sessionTimestamp") as? Double else { return }
+    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)")
+    print("🔄 SpotnySDK: Resuming session (userId: \(identifiedUserId ?? "anonymous"))")
     startPersistentScanning()
     scanning = true
   }
 
   private func clearStoredSession() {
-    UserDefaults.standard.removeObject(forKey: "SpotnySDK_userUUID")
-    UserDefaults.standard.removeObject(forKey: "SpotnySDK_userId")
+    // Only clears the scanning session — identity (Keychain) is intentionally kept
     UserDefaults.standard.removeObject(forKey: "SpotnySDK_sessionTimestamp")
     UserDefaults.standard.synchronize()
   }
@@ -142,9 +147,7 @@ public class SpotnyBeaconScanner: NSObject {
 
   @objc
   public func startScanner(
-    withUserUUID userUUID: String,
-    userId: NSNumber?,
-    resolve: @escaping (Any?) -> Void,
+    withResolve resolve: @escaping (Any?) -> Void,
     reject: @escaping (String?, String?, Error?) -> Void
   ) {
     if scanning {
@@ -152,15 +155,6 @@ public class SpotnyBeaconScanner: NSObject {
       return
     }
 
-    currentUserUUID = userUUID
-    self.userId = userId?.intValue
-
-    UserDefaults.standard.set(userUUID, forKey: "SpotnySDK_userUUID")
-    if let uid = userId {
-      UserDefaults.standard.set(uid.intValue, forKey: "SpotnySDK_userId")
-    } else {
-      UserDefaults.standard.removeObject(forKey: "SpotnySDK_userId")
-    }
     UserDefaults.standard.set(Date().timeIntervalSince1970, forKey: "SpotnySDK_sessionTimestamp")
     UserDefaults.standard.synchronize()
 
@@ -171,7 +165,7 @@ public class SpotnyBeaconScanner: NSObject {
 
     startPersistentScanning()
     scanning = true
-    print("✅ SpotnySDK: Started scanning for \(userUUID)")
+    print("✅ SpotnySDK: Started scanning (userId: \(identifiedUserId ?? "anonymous"))")
     resolve("Scanning started")
   }
 
@@ -187,8 +181,6 @@ public class SpotnyBeaconScanner: NSObject {
     clearStoredSession()
 
     scanning = false
-    currentUserUUID = nil
-    userId = nil
 
     print("⏹️ SpotnySDK: Stopped scanning")
     resolve("Scanning stopped")
@@ -260,6 +252,80 @@ public class SpotnyBeaconScanner: NSObject {
     resolve("Debounce cache cleared")
   }
 
+  // MARK: - Identity
+
+  @objc
+  public func identify(
+    _ userId: String,
+    resolve: @escaping (Any?) -> Void,
+    reject: @escaping (String?, String?, Error?) -> Void
+  ) {
+    identifiedUserId = userId
+    keychainWrite(key: "SpotnySDK_userId", value: userId)
+    print("👤 SpotnySDK: Identified user \(userId)")
+    resolve("User identified")
+  }
+
+  @objc
+  public func updateProfile(
+    _ profile: NSDictionary,
+    resolve: @escaping (Any?) -> Void,
+    reject: @escaping (String?, String?, Error?) -> Void
+  ) {
+    if let phone = profile["phoneNumber"] as? String {
+      profilePhone = phone
+      keychainWrite(key: "SpotnySDK_profilePhone", value: phone)
+    }
+    if let email = profile["email"] as? String {
+      profileEmail = email
+      keychainWrite(key: "SpotnySDK_profileEmail", value: email)
+    }
+    if let name = profile["name"] as? String {
+      profileName = name
+      keychainWrite(key: "SpotnySDK_profileName", value: name)
+    }
+
+    var payload: [String: Any] = ["device_id": getDeviceId()]
+    if let uid = identifiedUserId   { payload["user_id"]      = uid }
+    if let ph  = profilePhone       { payload["phone"]        = ph  }
+    if let em  = profileEmail       { payload["email"]        = em  }
+    if let nm  = profileName        { payload["name"]         = nm  }
+    if let src = source             { payload["source"]       = src }
+
+    post(endpoint: "/api/app/profiles/update", payload: payload) { result in
+      switch result {
+      case .success(let (status, _)):
+        if 200...299 ~= status {
+          print("✅ SpotnySDK: Profile updated")
+          resolve("Profile updated")
+        } else {
+          print("❌ SpotnySDK: Profile update failed — status \(status)")
+          reject("PROFILE_UPDATE_FAILED", "Server returned status \(status)", nil)
+        }
+      case .failure(let error):
+        print("❌ SpotnySDK: Profile update error — \(error.localizedDescription)")
+        reject("PROFILE_UPDATE_ERROR", error.localizedDescription, error)
+      }
+    }
+  }
+
+  @objc
+  public func resetIdentity(
+    withResolve resolve: @escaping (Any?) -> Void,
+    reject: @escaping (String?, String?, Error?) -> Void
+  ) {
+    identifiedUserId = nil
+    profilePhone     = nil
+    profileEmail     = nil
+    profileName      = nil
+    keychainDelete(key: "SpotnySDK_userId")
+    keychainDelete(key: "SpotnySDK_profilePhone")
+    keychainDelete(key: "SpotnySDK_profileEmail")
+    keychainDelete(key: "SpotnySDK_profileName")
+    print("🔓 SpotnySDK: Identity reset")
+    resolve("Identity reset")
+  }
+
   @objc
   public func getDebounceStatus(
     withResolve resolve: @escaping (Any?) -> Void,
@@ -364,6 +430,15 @@ public class SpotnyBeaconScanner: NSObject {
     }
   }
 
+  private func keychainDelete(key: String) {
+    let query: [CFString: Any] = [
+      kSecClass:       kSecClassGenericPassword,
+      kSecAttrService: keychainService,
+      kSecAttrAccount: key
+    ]
+    SecItemDelete(query as CFDictionary)
+  }
+
   private func getDeviceId() -> String {
     let kcKey = "SpotnySDK_deviceId"
     // 1. Keychain — survives uninstall
@@ -464,8 +539,8 @@ public class SpotnyBeaconScanner: NSObject {
     fetchInProgress[key] = true
 
     var payload: [String: Any] = ["beacon_id": key, "device_id": deviceId]
-    if let uid = userId { payload["user_id"] = uid }
-    if let src = source  { payload["source"]  = src }
+    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 }
@@ -540,7 +615,7 @@ public class SpotnyBeaconScanner: NSObject {
     ]
     if let cid = campaign.campaignId  { payload["campaign_id"] = cid }
     if let sid = campaign.sessionId   { payload["session_id"]  = sid }
-    if let uid = userId               { payload["user_id"]     = uid }
+    if let uid = identifiedUserId     { payload["user_id"]     = uid }
     if let src = source               { payload["source"]      = src }
 
     post(endpoint: endpoint, payload: payload) { [weak self] result in

package/ios/SpotnySdk.mm

@@ -64,11 +64,9 @@ RCT_EXPORT_MODULE()
 
 // ── Method implementations ───────────────────────────────────────────────────
 
-- (void)startScanner:(NSString *)userUUID
-              userId:(NSNumber *)userId
-             resolve:(RCTPromiseResolveBlock)resolve
+- (void)startScanner:(RCTPromiseResolveBlock)resolve
               reject:(RCTPromiseRejectBlock)reject {
-  [_scanner startScannerWithUserUUID:userUUID userId:userId resolve:resolve reject:reject];
+  [_scanner startScannerWithResolve:resolve reject:reject];
 }
 
 - (void)stopScanner:(RCTPromiseResolveBlock)resolve
@@ -118,6 +116,23 @@ RCT_EXPORT_MODULE()
   [_scanner getDebounceStatusWithResolve:resolve reject:reject];
 }
 
+- (void)identify:(NSString *)userId
+         resolve:(RCTPromiseResolveBlock)resolve
+          reject:(RCTPromiseRejectBlock)reject {
+  [_scanner identify:userId resolve:resolve reject:reject];
+}
+
+- (void)updateProfile:(NSDictionary *)profile
+              resolve:(RCTPromiseResolveBlock)resolve
+               reject:(RCTPromiseRejectBlock)reject {
+  [_scanner updateProfile:profile resolve:resolve reject:reject];
+}
+
+- (void)resetIdentity:(RCTPromiseResolveBlock)resolve
+               reject:(RCTPromiseRejectBlock)reject {
+  [_scanner resetIdentityWithResolve:resolve reject:reject];
+}
+
 // ── TurboModule JSI bridge ───────────────────────────────────────────────────
 
 - (std::shared_ptr<facebook::react::TurboModule>)getTurboModule:

package/lib/module/NativeSpotnySdk.js.map

@@ -1 +1 @@
-{"version":3,"names":["TurboModuleRegistry","getEnforcing"],"sourceRoot":"../../src","sources":["NativeSpotnySdk.ts"],"mappings":";;AAAA,SAASA,mBAAmB,QAA0B,cAAc;AA4BpE,eAAeA,mBAAmB,CAACC,YAAY,CAAO,WAAW,CAAC","ignoreList":[]}
+{"version":3,"names":["TurboModuleRegistry","getEnforcing"],"sourceRoot":"../../src","sources":["NativeSpotnySdk.ts"],"mappings":";;AAAA,SAASA,mBAAmB,QAA0B,cAAc;AAiCpE,eAAeA,mBAAmB,CAACC,YAAY,CAAO,WAAW,CAAC","ignoreList":[]}

package/lib/module/index.js

@@ -16,13 +16,9 @@ const eventEmitter = new NativeEventEmitter(NativeModules.SpotnySdk);
 
 // ── Core scanning ────────────────────────────────────────────────────────────
 
-/**
- * Start beacon scanning.
- * @param userUUID  A unique string identifying this installation / user session.
- * @param userId    Optional authenticated user ID.
- */
-export function startScanner(userUUID, userId) {
-  return NativeSpotnySdk.startScanner(userUUID, userId ?? null);
+/** Start beacon scanning. Call `identify()` before this for attributed tracking. */
+export function startScanner() {
+  return NativeSpotnySdk.startScanner();
 }
 
 /** Stop beacon scanning and clean up all state. */
@@ -35,6 +31,35 @@ export function isScanning() {
   return NativeSpotnySdk.isScanning();
 }
 
+// ── Identity ─────────────────────────────────────────────────────────────────
+
+/**
+ * Identify the current user. Pass any opaque string your app uses — user ID,
+ * hashed email, hashed phone, etc. Stored in Keychain and sent with all
+ * subsequent tracking events.
+ *
+ * Call before `startScanner()` or at any point during an active session.
+ */
+export function identify(userId) {
+  return NativeSpotnySdk.identify(userId);
+}
+
+/**
+ * Update the user's profile on the Spotny backend.
+ * Fields are optional — pass only what you have.
+ */
+export function updateProfile(profile) {
+  return NativeSpotnySdk.updateProfile(profile);
+}
+
+/**
+ * Clear the stored identity (user ID + profile fields) from Keychain.
+ * Call on logout. The device ID is NOT affected.
+ */
+export function resetIdentity() {
+  return NativeSpotnySdk.resetIdentity();
+}
+
 // ── Configuration ────────────────────────────────────────────────────────────
 
 /**

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;;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":[]}
+{"version":3,"names":["NativeEventEmitter","NativeModules","NativeSpotnySdk","SpotnyEvents","ON_BEACONS_RANGED","ON_BEACON_REGION_EVENT","eventEmitter","SpotnySdk","startScanner","stopScanner","isScanning","identify","userId","updateProfile","profile","resetIdentity","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;;AA8CA;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;AACA;AACA;AACA;AACA,OAAO,SAASC,QAAQA,CAACC,MAAc,EAAmB;EACxD,OAAOV,eAAe,CAACS,QAAQ,CAACC,MAAM,CAAC;AACzC;;AAEA;AACA;AACA;AACA;AACA,OAAO,SAASC,aAAaA,CAACC,OAAsB,EAAmB;EACrE,OAAOZ,eAAe,CAACW,aAAa,CAACC,OAAiB,CAAC;AACzD;;AAEA;AACA;AACA;AACA;AACA,OAAO,SAASC,aAAaA,CAAA,EAAoB;EAC/C,OAAOb,eAAe,CAACa,aAAa,CAAC,CAAC;AACxC;;AAEA;;AAEA;AACA;AACA;AACA;AACA,OAAO,SAASC,SAASA,CAACC,MAAuB,EAAmB;EAClE,OAAOf,eAAe,CAACc,SAAS,CAACC,MAAgB,CAAC;AACpD;;AAEA;;AAEA;AACA,OAAO,SAASC,8BAA8BA,CAAA,EAAoB;EAChE,OAAOhB,eAAe,CAACgB,8BAA8B,CAAC,CAAC;AACzD;;AAEA;;AAEA;AACA,OAAO,SAASC,YAAYA,CAAA,EAAoB;EAC9C,OAAOjB,eAAe,CAACiB,YAAY,CAAC,CAAC;AACvC;;AAEA;AACA,OAAO,SAASC,cAAcA,CAAA,EAAoB;EAChD,OAAOlB,eAAe,CAACkB,cAAc,CAAC,CAAC;AACzC;;AAEA;;AAEA;AACA,OAAO,SAASC,mBAAmBA,CAACC,QAAgB,EAAmB;EACrE,OAAOpB,eAAe,CAACmB,mBAAmB,CAACC,QAAQ,CAAC;AACtD;;AAEA;AACA,OAAO,SAASC,kBAAkBA,CAAA,EAAoB;EACpD,OAAOrB,eAAe,CAACqB,kBAAkB,CAAC,CAAC;AAC7C;;AAEA;AACA,OAAO,SAASC,iBAAiBA,CAAA,EAAoB;EACnD,OAAOtB,eAAe,CAACsB,iBAAiB,CAAC,CAAC;AAC5C;;AAEA;;AAEA;AACA;AACA;AACA;AACA,OAAO,SAASC,wBAAwBA,CACtCC,QAA4C,EAC5C;EACA,OAAOpB,YAAY,CAACqB,WAAW,CAC7BxB,YAAY,CAACC,iBAAiB,EAC9BsB,QACF,CAAC;AACH;;AAEA;AACA;AACA;AACA;AACA,OAAO,SAASE,uBAAuBA,CACrCF,QAA4C,EAC5C;EACA,OAAOpB,YAAY,CAACqB,WAAW,CAC7BxB,YAAY,CAACE,sBAAsB,EACnCqB,QACF,CAAC;AACH","ignoreList":[]}

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

@@ -1,8 +1,11 @@
 import { type TurboModule } from 'react-native';
 export interface Spec extends TurboModule {
-    startScanner(userUUID: string, userId: number | null): Promise<string>;
+    startScanner(): Promise<string>;
     stopScanner(): Promise<string>;
     isScanning(): Promise<boolean>;
+    identify(userId: string): Promise<string>;
+    updateProfile(profile: Object): Promise<string>;
+    resetIdentity(): Promise<string>;
     configure(config: Object): Promise<string>;
     requestNotificationPermissions(): Promise<string>;
     getDebugLogs(): Promise<string>;

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

@@ -1 +1 @@
-{"version":3,"file":"NativeSpotnySdk.d.ts","sourceRoot":"","sources":["../../../src/NativeSpotnySdk.ts"],"names":[],"mappings":"AAAA,OAAO,EAAuB,KAAK,WAAW,EAAE,MAAM,cAAc,CAAC;AAErE,MAAM,WAAW,IAAK,SAAQ,WAAW;IAEvC,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACvE,WAAW,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IAC/B,UAAU,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAG/B,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAG3C,8BAA8B,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IAGlD,YAAY,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IAChC,cAAc,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IAGlC,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACvD,kBAAkB,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IACtC,iBAAiB,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IAGrC,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACtC;;AAED,wBAAmE"}
+{"version":3,"file":"NativeSpotnySdk.d.ts","sourceRoot":"","sources":["../../../src/NativeSpotnySdk.ts"],"names":[],"mappings":"AAAA,OAAO,EAAuB,KAAK,WAAW,EAAE,MAAM,cAAc,CAAC;AAErE,MAAM,WAAW,IAAK,SAAQ,WAAW;IAEvC,YAAY,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IAChC,WAAW,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IAC/B,UAAU,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAG/B,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC1C,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAChD,aAAa,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IAGjC,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAG3C,8BAA8B,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IAGlD,YAAY,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IAChC,cAAc,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IAGlC,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACvD,kBAAkB,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IACtC,iBAAiB,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IAGrC,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACtC;;AAED,wBAAmE"}

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

@@ -33,16 +33,38 @@ export type SpotnySdkConfig = {
      */
     distanceCorrectionFactor?: number;
 };
-/**
- * Start beacon scanning.
- * @param userUUID  A unique string identifying this installation / user session.
- * @param userId    Optional authenticated user ID.
- */
-export declare function startScanner(userUUID: string, userId?: number | null): Promise<string>;
+export type SpotnyProfile = {
+    /** Phone number (e.g. '+966501234567'). */
+    phoneNumber?: string;
+    /** Email address. */
+    email?: string;
+    /** Display name. */
+    name?: string;
+};
+/** Start beacon scanning. Call `identify()` before this for attributed tracking. */
+export declare function startScanner(): Promise<string>;
 /** Stop beacon scanning and clean up all state. */
 export declare function stopScanner(): Promise<string>;
 /** Returns `true` if the SDK is currently scanning. */
 export declare function isScanning(): Promise<boolean>;
+/**
+ * Identify the current user. Pass any opaque string your app uses — user ID,
+ * hashed email, hashed phone, etc. Stored in Keychain and sent with all
+ * subsequent tracking events.
+ *
+ * Call before `startScanner()` or at any point during an active session.
+ */
+export declare function identify(userId: string): Promise<string>;
+/**
+ * Update the user's profile on the Spotny backend.
+ * Fields are optional — pass only what you have.
+ */
+export declare function updateProfile(profile: SpotnyProfile): Promise<string>;
+/**
+ * Clear the stored identity (user ID + profile fields) from Keychain.
+ * Call on logout. The device ID is NOT affected.
+ */
+export declare function resetIdentity(): Promise<string>;
 /**
  * Override SDK configuration at runtime.
  * Must be called **before** `startScanner`.

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;;;;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;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,2CAA2C;IAC3C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,qBAAqB;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,oBAAoB;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AAOF,oFAAoF;AACpF,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;;;;;;GAMG;AACH,wBAAgB,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAExD;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC,CAErE;AAED;;;GAGG;AACH,wBAAgB,aAAa,IAAI,OAAO,CAAC,MAAM,CAAC,CAE/C;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.1",
+  "version": "0.5.0",
   "description": "Beacon Scanner",
   "main": "./lib/module/index.js",
   "types": "./lib/typescript/src/index.d.ts",

package/src/NativeSpotnySdk.ts

@@ -2,10 +2,15 @@ import { TurboModuleRegistry, type TurboModule } from 'react-native';
 
 export interface Spec extends TurboModule {
   // ── Core scanning ──────────────────────────────────────────────────────────
-  startScanner(userUUID: string, userId: number | null): Promise<string>;
+  startScanner(): Promise<string>;
   stopScanner(): Promise<string>;
   isScanning(): Promise<boolean>;
 
+  // ── Identity ───────────────────────────────────────────────────────────────
+  identify(userId: string): Promise<string>;
+  updateProfile(profile: Object): Promise<string>;
+  resetIdentity(): Promise<string>;
+
   // ── Configuration ──────────────────────────────────────────────────────────
   configure(config: Object): Promise<string>;
 

package/src/index.tsx

@@ -44,21 +44,23 @@ export type SpotnySdkConfig = {
   distanceCorrectionFactor?: number;
 };
 
+export type SpotnyProfile = {
+  /** Phone number (e.g. '+966501234567'). */
+  phoneNumber?: string;
+  /** Email address. */
+  email?: string;
+  /** Display name. */
+  name?: string;
+};
+
 // ── Internal event emitter ───────────────────────────────────────────────────
 const eventEmitter = new NativeEventEmitter(NativeModules.SpotnySdk);
 
 // ── Core scanning ────────────────────────────────────────────────────────────
 
-/**
- * Start beacon scanning.
- * @param userUUID  A unique string identifying this installation / user session.
- * @param userId    Optional authenticated user ID.
- */
-export function startScanner(
-  userUUID: string,
-  userId?: number | null
-): Promise<string> {
-  return NativeSpotnySdk.startScanner(userUUID, userId ?? null);
+/** Start beacon scanning. Call `identify()` before this for attributed tracking. */
+export function startScanner(): Promise<string> {
+  return NativeSpotnySdk.startScanner();
 }
 
 /** Stop beacon scanning and clean up all state. */
@@ -71,6 +73,35 @@ export function isScanning(): Promise<boolean> {
   return NativeSpotnySdk.isScanning();
 }
 
+// ── Identity ─────────────────────────────────────────────────────────────────
+
+/**
+ * Identify the current user. Pass any opaque string your app uses — user ID,
+ * hashed email, hashed phone, etc. Stored in Keychain and sent with all
+ * subsequent tracking events.
+ *
+ * Call before `startScanner()` or at any point during an active session.
+ */
+export function identify(userId: string): Promise<string> {
+  return NativeSpotnySdk.identify(userId);
+}
+
+/**
+ * Update the user's profile on the Spotny backend.
+ * Fields are optional — pass only what you have.
+ */
+export function updateProfile(profile: SpotnyProfile): Promise<string> {
+  return NativeSpotnySdk.updateProfile(profile as Object);
+}
+
+/**
+ * Clear the stored identity (user ID + profile fields) from Keychain.
+ * Call on logout. The device ID is NOT affected.
+ */
+export function resetIdentity(): Promise<string> {
+  return NativeSpotnySdk.resetIdentity();
+}
+
 // ── Configuration ────────────────────────────────────────────────────────────
 
 /**