Rename Anonymous to Unknown User throughout iOS SDK

- Renamed classes: AnonymousUserManager → UnknownUserManager, etc.
- Updated config properties: enableAnonActivation → enableUnknownUserActivation
- Migrated storage keys: itbl_anonymous* → itbl_unknown_user*
- Updated API endpoints: anonymoususer/* → unknownuser/*
- Fixed Xcode project references and dependencies
- All builds and functionality preserved

Author: sumeruchat

.claude/settings.local.json

@@ -0,0 +1,9 @@
+{
+  "permissions": {
+    "allow": [
+      "Bash(ln:*)",
+      "Bash(xcodebuild build:*)"
+    ],
+    "deny": []
+  }
+}

mac_llm_build.sh

@@ -0,0 +1,51 @@
+#!/bin/bash
+
+# This script is to be used by LLMs and AI agents to build the Iterable Swift SDK on macOS.
+# It uses xcpretty to format the build output and only shows errors.
+# It also checks if the build is successful and exits with the correct status.
+
+# Check if running on macOS
+if [[ "$(uname)" != "Darwin" ]]; then
+    echo "❌ This script requires macOS to run Xcode builds"
+    exit 1
+fi
+
+# Make sure xcpretty is installed
+if ! command -v xcpretty &> /dev/null; then
+    echo "xcpretty not found, installing via gem..."
+    gem install xcpretty
+fi
+
+echo "Building Iterable Swift SDK..."
+
+# Create a temporary file for the build output
+TEMP_OUTPUT=$(mktemp)
+
+# Run the build and capture all output
+xcodebuild \
+    -project swift-sdk.xcodeproj \
+    -scheme "swift-sdk" \
+    -configuration Debug \
+    -sdk iphonesimulator \
+    build > $TEMP_OUTPUT 2>&1
+
+# Check the exit status
+BUILD_STATUS=$?
+
+# Show errors and warnings if build failed
+if [ $BUILD_STATUS -eq 0 ]; then
+    echo "✅ Iterable SDK build succeeded!"
+else
+    echo "❌ Iterable SDK build failed with status $BUILD_STATUS"
+    echo ""
+    echo "🔍 Build errors:"
+    grep -E 'error:|fatal:' $TEMP_OUTPUT | head -10
+    echo ""
+    echo "⚠️  Build warnings:"
+    grep -E 'warning:' $TEMP_OUTPUT | head -5
+fi
+
+# Remove the temporary file
+rm $TEMP_OUTPUT
+
+exit $BUILD_STATUS 

sample-apps/swift-sample-app/swift-sample-app/AppDelegate.swift

@@ -43,8 +43,8 @@ class AppDelegate: UIResponder, UIApplicationDelegate, IterableAuthDelegate {
         config.customActionDelegate = self
         config.urlDelegate = self
         config.inAppDisplayInterval = 1
-        config.anonUserDelegate = self
-        config.enableAnonTracking = true
+        config.unknownUserHandler = self
+        config.enableUnknownUserActivation = true
         config.authDelegate = self
         IterableAPI.initialize(apiKey: iterableApiKey,
                                launchOptions: launchOptions,
@@ -175,9 +175,9 @@ extension AppDelegate: IterableURLDelegate {
     }
 }
 
-extension AppDelegate: IterableAnonUserDelegate {
-    func onAnonUserCreated(userId: String) {
-        print("UserId Created from anonsession: \(userId)")
+extension AppDelegate: IterableUnknownUserHandler {
+    func onUnknownUserCreated(userId: String) {
+        print("UserId Created from unknown user session: \(userId)")
     }
 }
 

sample-apps/swift-sample-app/swift-sample-app/Base.lproj/Main.storyboard

@@ -35,7 +35,7 @@
                                     <segue destination="Ez8-MY-tka" kind="show" identifier="showCoffeeSegue" id="pgY-3d-VNl"/>
                                 </connections>
                             </tableViewCell>
-                            <tableViewCell clipsSubviews="YES" contentMode="scaleToFill" preservesSuperviewLayoutMargins="YES" selectionStyle="default" accessoryType="checkmark" indentationWidth="10" reuseIdentifier="anonymousUsageTrackCell" id="nSd-28-WlN">
+                            <tableViewCell clipsSubviews="YES" contentMode="scaleToFill" preservesSuperviewLayoutMargins="YES" selectionStyle="default" accessoryType="checkmark" indentationWidth="10" reuseIdentifier="unknownUserUsageTrackCell" id="nSd-28-WlN">
                                 <rect key="frame" x="0.0" y="93.5" width="375" height="43.5"/>
                                 <autoresizingMask key="autoresizingMask"/>
                                 <tableViewCellContentView key="contentView" opaque="NO" clipsSubviews="YES" multipleTouchEnabled="YES" contentMode="center" preservesSuperviewLayoutMargins="YES" insetsLayoutMarginsFromSafeArea="NO" tableViewCell="nSd-28-WlN" id="4YR-d9-FwM">

sample-apps/swift-sample-app/swift-sample-app/CoffeeListTableViewController.swift

@@ -73,10 +73,10 @@ class CoffeeListTableViewController: UITableViewController {
     }
     override func tableView(_ tableView: UITableView, cellForRowAt indexPath: IndexPath) -> UITableViewCell {
         if indexPath.section == 0 {
-            let cell = tableView.dequeueReusableCell(withIdentifier: "anonymousUsageTrackCell", for: indexPath)
-            cell.textLabel?.text = IterableAPI.getAnonymousUsageTracked() ? "Tap to disable Anonymous Usage Track" : "Tap to enable Anonymous Usage Track"
+            let cell = tableView.dequeueReusableCell(withIdentifier: "unknownUserUsageTrackCell", for: indexPath)
+            cell.textLabel?.text = IterableAPI.getUnknownUserUsageTracked() ? "Tap to disable Unknown User Usage Track" : "Tap to enable Unknown User Usage Track"
             cell.textLabel?.numberOfLines = 0
-            cell.accessoryType = IterableAPI.getAnonymousUsageTracked() ? .checkmark : .none
+            cell.accessoryType = IterableAPI.getUnknownUserUsageTracked() ? .checkmark : .none
             return cell
         } else {
             let cell = tableView.dequeueReusableCell(withIdentifier: "coffeeCell", for: indexPath)
@@ -90,8 +90,8 @@ class CoffeeListTableViewController: UITableViewController {
 
     override func tableView(_ tableView: UITableView, didSelectRowAt indexPath: IndexPath) {
         if indexPath.section == 0 {
-            let permissionToTrack = IterableAPI.getAnonymousUsageTracked()
-            IterableAPI.setAnonymousUsageTracked(isAnonymousUsageTracked: !permissionToTrack)
+                    let permissionToTrack = IterableAPI.getUnknownUserUsageTracked()
+        IterableAPI.setUnknownUserUsageTracked(isUnknownUserUsageTracked: !permissionToTrack)
             self.tableView.reloadData()
         }
     }

swift-sdk.xcodeproj/project.pbxproj

@@ -428,10 +428,10 @@
 		DF7302152C2C176E0002633A /* AnonymousUserComplexCriteriaMatchTests.swift in Sources */ = {isa = PBXBuildFile; fileRef = DF7302142C2C176E0002633A /* AnonymousUserComplexCriteriaMatchTests.swift */; };
 		DF97D12B2C2D4A060034D38C /* AnonymousUserCriteriaIsSetTests.swift in Sources */ = {isa = PBXBuildFile; fileRef = DF97D12A2C2D4A060034D38C /* AnonymousUserCriteriaIsSetTests.swift */; };
 		DFFD62392C3681B900010883 /* UserMergeScenariosTests.swift in Sources */ = {isa = PBXBuildFile; fileRef = DFFD62382C3681B900010883 /* UserMergeScenariosTests.swift */; };
-		E9EA7C9F2C1EDE5800A9D6FB /* AnonymousUserManager+Functions.swift in Sources */ = {isa = PBXBuildFile; fileRef = E9EA7C9B2C1EDE5800A9D6FB /* AnonymousUserManager+Functions.swift */; };
-		E9EA7CA02C1EDE5800A9D6FB /* AnonymousUserMerge.swift in Sources */ = {isa = PBXBuildFile; fileRef = E9EA7C9C2C1EDE5800A9D6FB /* AnonymousUserMerge.swift */; };
-		E9EA7CA12C1EDE5800A9D6FB /* AnonymousUserManagerProtocol.swift in Sources */ = {isa = PBXBuildFile; fileRef = E9EA7C9D2C1EDE5800A9D6FB /* AnonymousUserManagerProtocol.swift */; };
-		E9EA7CA22C1EDE5800A9D6FB /* AnonymousUserManager.swift in Sources */ = {isa = PBXBuildFile; fileRef = E9EA7C9E2C1EDE5800A9D6FB /* AnonymousUserManager.swift */; };
+		E9EA7C9F2C1EDE5800A9D6FB /* UnknownUserManager+Functions.swift in Sources */ = {isa = PBXBuildFile; fileRef = E9EA7C9B2C1EDE5800A9D6FB /* UnknownUserManager+Functions.swift */; };
+		E9EA7CA02C1EDE5800A9D6FB /* UnknownUserMerge.swift in Sources */ = {isa = PBXBuildFile; fileRef = E9EA7C9C2C1EDE5800A9D6FB /* UnknownUserMerge.swift */; };
+		E9EA7CA12C1EDE5800A9D6FB /* UnknownUserManagerProtocol.swift in Sources */ = {isa = PBXBuildFile; fileRef = E9EA7C9D2C1EDE5800A9D6FB /* UnknownUserManagerProtocol.swift */; };
+		E9EA7CA22C1EDE5800A9D6FB /* UnknownUserManager.swift in Sources */ = {isa = PBXBuildFile; fileRef = E9EA7C9E2C1EDE5800A9D6FB /* UnknownUserManager.swift */; };
 		E9EA7CA82C1EE3BA00A9D6FB /* AnonymousUserCriteriaMatchTests.swift in Sources */ = {isa = PBXBuildFile; fileRef = E9EA7CA62C1EE3BA00A9D6FB /* AnonymousUserCriteriaMatchTests.swift */; };
 /* End PBXBuildFile section */
 
@@ -870,10 +870,10 @@
 		DF7302142C2C176E0002633A /* AnonymousUserComplexCriteriaMatchTests.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = AnonymousUserComplexCriteriaMatchTests.swift; sourceTree = "<group>"; };
 		DF97D12A2C2D4A060034D38C /* AnonymousUserCriteriaIsSetTests.swift */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.swift; path = AnonymousUserCriteriaIsSetTests.swift; sourceTree = "<group>"; };
 		DFFD62382C3681B900010883 /* UserMergeScenariosTests.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = UserMergeScenariosTests.swift; sourceTree = "<group>"; };
-		E9EA7C9B2C1EDE5800A9D6FB /* AnonymousUserManager+Functions.swift */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.swift; path = "AnonymousUserManager+Functions.swift"; sourceTree = "<group>"; };
-		E9EA7C9C2C1EDE5800A9D6FB /* AnonymousUserMerge.swift */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.swift; path = AnonymousUserMerge.swift; sourceTree = "<group>"; };
-		E9EA7C9D2C1EDE5800A9D6FB /* AnonymousUserManagerProtocol.swift */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.swift; path = AnonymousUserManagerProtocol.swift; sourceTree = "<group>"; };
-		E9EA7C9E2C1EDE5800A9D6FB /* AnonymousUserManager.swift */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.swift; path = AnonymousUserManager.swift; sourceTree = "<group>"; };
+		E9EA7C9B2C1EDE5800A9D6FB /* UnknownUserManager+Functions.swift */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.swift; path = "UnknownUserManager+Functions.swift"; sourceTree = "<group>"; };
+		E9EA7C9C2C1EDE5800A9D6FB /* UnknownUserMerge.swift */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.swift; path = UnknownUserMerge.swift; sourceTree = "<group>"; };
+		E9EA7C9D2C1EDE5800A9D6FB /* UnknownUserManagerProtocol.swift */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.swift; path = UnknownUserManagerProtocol.swift; sourceTree = "<group>"; };
+		E9EA7C9E2C1EDE5800A9D6FB /* UnknownUserManager.swift */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.swift; path = UnknownUserManager.swift; sourceTree = "<group>"; };
 		E9EA7CA62C1EE3BA00A9D6FB /* AnonymousUserCriteriaMatchTests.swift */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.swift; path = AnonymousUserCriteriaMatchTests.swift; sourceTree = "<group>"; };
 /* End PBXFileReference section */
 
@@ -1708,10 +1708,10 @@
 			isa = PBXGroup;
 			children = (
 				9F0616402C9CA9D200FE2E6A /* IterableIdentityResolution.swift */,
-				E9EA7C9E2C1EDE5800A9D6FB /* AnonymousUserManager.swift */,
-				E9EA7C9B2C1EDE5800A9D6FB /* AnonymousUserManager+Functions.swift */,
-				E9EA7C9D2C1EDE5800A9D6FB /* AnonymousUserManagerProtocol.swift */,
-				E9EA7C9C2C1EDE5800A9D6FB /* AnonymousUserMerge.swift */,
+				E9EA7C9E2C1EDE5800A9D6FB /* UnknownUserManager.swift */,
+				E9EA7C9B2C1EDE5800A9D6FB /* UnknownUserManager+Functions.swift */,
+				E9EA7C9D2C1EDE5800A9D6FB /* UnknownUserManagerProtocol.swift */,
+				E9EA7C9C2C1EDE5800A9D6FB /* UnknownUserMerge.swift */,
 			);
 			name = AnonymousTracking;
 			sourceTree = "<group>";
@@ -2326,10 +2326,10 @@
 				5B88BC482805D09D004016E5 /* (null) in Sources */,
 				9F0616412C9CA9D400FE2E6A /* IterableIdentityResolution.swift in Sources */,
 				18E5B5D12CC77BCE00A558EC /* IterableTokenGenerator.swift in Sources */,
-				E9EA7C9F2C1EDE5800A9D6FB /* AnonymousUserManager+Functions.swift in Sources */,
-				E9EA7CA22C1EDE5800A9D6FB /* AnonymousUserManager.swift in Sources */,
-				E9EA7CA02C1EDE5800A9D6FB /* AnonymousUserMerge.swift in Sources */,
-				E9EA7CA12C1EDE5800A9D6FB /* AnonymousUserManagerProtocol.swift in Sources */,
+				E9EA7C9F2C1EDE5800A9D6FB /* UnknownUserManager+Functions.swift in Sources */,
+				E9EA7CA22C1EDE5800A9D6FB /* UnknownUserManager.swift in Sources */,
+				E9EA7CA02C1EDE5800A9D6FB /* UnknownUserMerge.swift in Sources */,
+				E9EA7CA12C1EDE5800A9D6FB /* UnknownUserManagerProtocol.swift in Sources */,
 			);
 			runOnlyForDeploymentPostprocessing = 0;
 		};

swift-sdk/Core/Constants.swift

@@ -52,8 +52,8 @@ enum Const {
         static let updateSubscriptions = "users/updateSubscriptions"
         static let getRemoteConfiguration = "mobile/getRemoteConfiguration"
         static let mergeUser = "users/merge";
-        static let getCriteria = "anonymoususer/list";
-        static let trackAnonSession = "anonymoususer/events/session";
+        static let getCriteria = "unknownuser/list";
+        static let trackUnknownUserSession = "unknownuser/events/session";
         static let getEmbeddedMessages = "embedded-messaging/messages"
         static let embeddedMessageReceived = "embedded-messaging/events/received"
         static let embeddedMessageClick = "embedded-messaging/events/click"
@@ -71,13 +71,13 @@ enum Const {
         static let deviceId = "itbl_device_id"
         static let sdkVersion = "itbl_sdk_version"
         static let offlineMode = "itbl_offline_mode"
-        static let anonymousUserEvents = "itbl_anonymous_user_events"
-        static let anonymousUserUpdate = "itbl_anonymous_user_update"
+        static let unknownUserEvents = "itbl_unknown_user_events"
+        static let unknownUserUpdate = "itbl_unknown_user_update"
         static let criteriaData = "itbl_criteria_data"
-        static let anonymousSessions = "itbl_anon_sessions"
+        static let unknownUserSessions = "itbl_unknown_user_sessions"
         static let matchedCriteria = "itbl_matched_criteria"
         static let eventList = "itbl_event_list"
-        static let anonymousUsageTrack = "itbl_anonymous_usage_track"
+        static let unknownUserUsageTrack = "itbl_unknown_user_usage_track"
         static let isNotificationsEnabled = "itbl_isNotificationsEnabled"
         static let hasStoredNotificationSetting = "itbl_hasStoredNotificationSetting"
 
@@ -90,7 +90,7 @@ enum Const {
         enum Key {
             static let email = "itbl_email"
             static let userId = "itbl_userid"
-            static let userIdAnnon = "itbl_userid_annon"
+            static let userIdUnknownUser = "itbl_userid_unknown_user"
             static let authToken = "itbl_auth_token"
         }
     }

swift-sdk/Internal/AnonymousUserManagerProtocol.swift

@@ -12,15 +12,15 @@ struct Auth {
     let userId: String?
     let email: String?
     let authToken: String?
-    let userIdAnon: String?
+    let userIdUnknownUser: String?
 
     var emailOrUserId: EmailOrUserId {
         if let email = email {
             return .email(email)
         } else if let userId = userId {
             return .userId(userId)
-        } else if let userIdAnon = userIdAnon {
-            return .userIdAnon(userIdAnon)
+        } else if let userIdUnknownUser = userIdUnknownUser {
+            return .userIdUnknownUser(userIdUnknownUser)
         } else {
             return .none
         }
@@ -29,7 +29,7 @@ struct Auth {
     enum EmailOrUserId {
         case email(String)
         case userId(String)
-        case userIdAnon(String)
+        case userIdUnknownUser(String)
         case none
     }
 }

swift-sdk/Internal/Auth.swift

@@ -90,10 +90,10 @@ class AuthManager: IterableAuthManagerProtocol {
 
         clearRefreshTimer()
 
-        if localStorage.email != nil || localStorage.userId != nil || localStorage.userIdAnnon != nil {
-            localStorage.anonymousUserEvents = nil
-            localStorage.anonymousSessions = nil
-            localStorage.anonymousUserUpdate = nil
+        if localStorage.email != nil || localStorage.userId != nil || localStorage.userIdUnknownUser != nil {
+            localStorage.unknownUserEvents = nil
+            localStorage.unknownUserSessions = nil
+            localStorage.unknownUserUpdate = nil
         }
 
         isLastAuthTokenValid = false