feat: add reset() and deprecate removeUserId() (#35)

Co-authored-by: 박건우 <gunwoo@baggeon-uui-MacBookPro.local>

Author: gunoooo

CHANGELOG.md

@@ -4,6 +4,16 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.9.0] - 2026-02-19
+
+### Added
+
+- `reset()` method to clear all local SDK state including device ID
+
+### Deprecated
+
+- `removeUserId()` — use `reset()` instead
+
 ## [1.8.1] - 2026-02-13
 
 ### Added

Clix.podspec

@@ -1,7 +1,7 @@
 Pod::Spec.new do |spec|
   spec.name             = 'Clix'
   # Don't modify below line - it's automatically updated by scripts/update-version.sh
-  spec.version          = '1.8.1' # Don't modify this line - it's automatically updated by scripts/update-version.sh
+  spec.version          = '1.9.0' # Don't modify this line - it's automatically updated by scripts/update-version.sh
   spec.summary          = 'Clix iOS SDK for push notifications and analytics'
   spec.description      = <<-DESC
 Clix iOS SDK provides push notification and analytics capabilities for iOS apps.

README.md

@@ -8,7 +8,7 @@ Clix iOS SDK is a powerful tool for managing push notifications and user events
 
 ```swift
 dependencies: [
-    .package(url: "https://github.com/clix-so/clix-ios-sdk.git", from: "1.8.1")
+    .package(url: "https://github.com/clix-so/clix-ios-sdk.git", from: "1.9.0")
 ]
 ```
 

Sources/Core/Clix.swift

@@ -242,24 +242,15 @@ public final class Clix {
     }
   }
 
-  /// Removes the user ID (async version - recommended)
-  ///
-  /// This async version ensures the operation completes before returning.
-  /// Use this when you can await the operation in an async context.
-  ///
-  /// - Throws: ClixError if the operation fails
+  /// Removes the user ID (async version)
+  @available(*, deprecated, message: "Use reset() instead")
   public static func removeUserId() async throws {
     await shared.initCoordinator.waitForInitialization()
     try await shared.get(\.deviceService).removeProjectUserId()
   }
 
   /// Removes the user ID (synchronous version)
-  ///
-  /// This synchronous version returns immediately while the operation continues in the background.
-  /// Consider using the async version for guaranteed operation completion.
-  ///
-  /// - Note: An async version is available that ensures the operation completes before returning.
-  ///         Use `try await Clix.removeUserId()` for better control over operation timing.
+  @available(*, deprecated, message: "Use reset() instead")
   public static func removeUserId() {
     Task.detached(priority: .userInitiated) {
       do {
@@ -270,6 +261,31 @@ public final class Clix {
     }
   }
 
+  /// Resets all local SDK state including device ID.
+  ///
+  /// After calling this method, you must call `initialize()` again before using the SDK.
+  /// Use this when a user logs out and you want to start fresh with a new device identity.
+  public static func reset() async throws {
+    await shared.initCoordinator.waitForInitialization()
+    let notificationService = try shared.get(\.notificationService)
+    let storageService = try shared.get(\.storageService)
+    await notificationService.reset()
+    await storageService.remove("clix_device_id")
+    await storageService.remove("clix_session_last_activity")
+    await shared.initCoordinator.reset()
+  }
+
+  /// Resets all local SDK state including device ID (synchronous version)
+  public static func reset() {
+    Task.detached(priority: .userInitiated) {
+      do {
+        try await reset()
+      } catch {
+        ClixLogger.error("Failed to reset: \(error)")
+      }
+    }
+  }
+
   /// Sets a user property (async version - recommended)
   ///
   /// This async version ensures the operation completes before returning.
@@ -524,6 +540,10 @@ public final class Clix {
       }
     }
 
+    internal func reset() {
+      isInitialized = false
+    }
+
     nonisolated internal func waitAndGet<T>(_ getter: @escaping () -> T?) -> T? {
       let semaphore = DispatchSemaphore(value: 0)
       var result: T?

Sources/Core/ClixVersion.swift

@@ -2,5 +2,5 @@ import Foundation
 
 internal struct ClixVersion {
   // Don't modify below line - it's automatically updated by scripts/update-version.sh
-  internal static let current: String = "1.8.1"
+  internal static let current: String = "1.9.0"
 }