Merge branch 'main' into feature/tez/improve-session-info-desc

Author: tezpark

.gitignore

@@ -2,7 +2,12 @@
 **/dist
 **/.vite
 **/deps
+**/.pnpm-store
+**/pnpm-lock.yaml
+**/playwright-report/**
+**/test-results
 .idea
+CLAUDE.md
 
 ### Xcode ###
 ## User settings
@@ -24,4 +29,4 @@ xcuserdata/
 **/*.xcuserdatad
 **/Package.resolved
 
-# End of https://www.toptal.com/developers/gitignore/api/xcode
+# End of https://www.toptal.com/developers/gitignore/api/xcode

README.md

@@ -31,13 +31,36 @@ To integrate Sendbird AI Agent into your application, follow these steps:
 
 ## Repository Structure
 
-This repository contains platform-specific implementations of the Sendbird AI Agent:
+This repository contains platform-specific implementations and customer guides for the Sendbird AI Agent:
 
-- **iOS**: Located in the `ios` directory, this includes the Swift Package Manager (SPM) compatible SDK for integrating the AI agent into iOS applications.
+- **JavaScript**: Located in the `js` directory, includes:
+  - Documentation guides for React and CDN integration  
+  - Interactive live examples
+  - Downloadable sample projects for local development
 
-- **Android**: Located in the `android` directory, this includes the necessary components for Android integration.
+- **iOS**: Located in the `ios` directory, includes Swift integration guides and sample applications.
 
-- **Web**: Located in the `js` directory, this includes JavaScript components for web integration.
+- **Android**: Located in the `android` directory, includes Android integration documentation.
+
+### JavaScript Sample Projects
+
+Each JavaScript platform directory contains a ready-to-run sample project:
+
+- **`js/react/sample/`**: Vite + TypeScript + React sample with full AI Agent integration
+- **`js/cdn/sample/`**: Vite + Vanilla JavaScript sample using CDN integration
+
+Both samples demonstrate:
+- Basic AI Agent Messenger integration
+- User authentication and session handling
+- Context configuration
+- Manual messenger controls
+
+To run the samples locally:
+```bash
+cd js/react/sample    # or js/cdn/sample
+npm install
+npm run dev
+```
 
 Each platform-specific directory contains its own README with detailed integration instructions.
 

android/README.md

@@ -181,7 +181,31 @@ Now that you have installed and initialized the AI Agent SDK, follow the steps b
 ### Manage user sessions
 
 To use the SDK, session information is required.
-Before using `AIAgentMessenger`, you must set the session information for the application user issued by Sendbird.
+The SDK supports two types of user sessions: **Manual Session** for authenticated users and **Anonymous Session** for temporary users.
+
+#### Session Types
+
+**1. Manual Session (ManualSessionInfo):**
+Use this when you have an authenticated user with a specific user ID and session token.
+
+```kotlin
+val manualSessionInfo = ManualSessionInfo(
+    userId = "your_user_id",
+    sessionToken = "your_session_token", 
+    sessionHandler = YourSessionHandler()
+)
+AIAgentMessenger.updateSessionInfo(manualSessionInfo)
+```
+
+**2. Anonymous Session (AnonymousSessionInfo):**
+Use this for temporary users when you don't have user authentication. The server will automatically create a temporary user.
+
+```kotlin
+val anonymousSessionInfo = AnonymousSessionInfo()
+AIAgentMessenger.updateSessionInfo(anonymousSessionInfo)
+```
+
+> **⚠️ Important Note for Anonymous Sessions:** Since anonymous users are temporary and generated by the server, conversation history may not persist across different app sessions. Users might not see their previous conversations when they reconnect.
 
 #### When to set the session information:
 
@@ -191,17 +215,15 @@ Since there is no session information for the user at the first login, it should
 2. **For already logged-in users:**
 If the user is already logged in, the session should be registered immediately after SDK initialization.
 
-    ```kotlin
-    val userSessionInfo = UserSessionInfo(userId, authToken, AbstractSessionHandler())
-    AIAgentMessenger.updateSessionInfo(userSessionInfo)
-    ```
-    > SessionHandler is the handler used when a session expires or needs to be renewed. See [next guide](#handle-session-expiration) for instructions on how to use it.
+> SessionHandler is the handler used when a session expires or needs to be renewed (only applicable for ManualSessionInfo). See [next guide](#handle-session-expiration) for instructions on how to use it.
 
 ### Handle session expiration
 
-When registering a session information, the provided session handler must handle the case where the session information expires.
+When using `ManualSessionInfo`, the provided session handler must handle the case where the session information expires.
 Follow the code below to refresh and provide a new session token in the session handler callback.
 
+> **Note:** Session expiration handling is only applicable when using `ManualSessionInfo`. `AnonymousSessionInfo` does not require session token management.
+
 #### How to handle session expiration:
 
 1. Detect session expiration in the session handler callback.
@@ -256,7 +278,20 @@ To add the MessengerLauncher to your screen, simply call the `attach()` function
 MessengerLauncher(context, "your_ai_agent_id").attach()
 ```
 
-- `LauncherLayoutParams` allows you to configure the MessengerLauncher’s behavior and appearance:
+- **`entryPoint`**: Controls which screen is displayed first when the MessengerLauncher is clicked:
+
+```kotlin
+val entryPoint = MessengerEntryPoint.CONVERSATION // or MessengerEntryPoint.CONVERSATION_LIST
+MessengerLauncher(this, "your_ai_agent_id", LauncherSettingsParams(entryPoint = entryPoint)).attach()
+```
+
+Available options:
+- `MessengerEntryPoint.CONVERSATION`: Opens directly to the conversation screen (default)
+- `MessengerEntryPoint.CONVERSATION_LIST`: Opens to the conversation list screen
+
+Use `CONVERSATION` for single AI agent conversations, or `CONVERSATION_LIST` when multiple conversation channels are available.
+
+- `LauncherLayoutParams` allows you to configure the MessengerLauncher's behavior and appearance:
     - **`launchMode`**:
         - `EXPANDED`: Opens the messenger in full-screen mode with predefined margins.
         - `ANCHORED`: Opens the messenger anchored near the launcher button, with adjustable positioning.

ios/README.md

@@ -25,6 +25,13 @@ The **Sendbird AI Agent Messenger** allows seamless integration of chatbot featu
     - [Unregister for push notifications](#unregister-for-push-notifications)
   - [Advanced features](#advanced-features)
     - [Customize launcher mode](#customize-launcher-mode)
+    - [Entry Point Advanced Configuration Guide](#entry-point-advanced-configuration-guide)
+      - [Entry Point Types](#entry-point-types)
+      - [Launcher-based Entry Point Configuration](#launcher-based-entry-point-configuration)
+        - [Basic Setup](#basic-setup)
+      - [Direct ViewController Presentation](#direct-viewcontroller-presentation)
+        - [Present Conversation](#present-conversation)
+        - [Present Conversation List](#present-conversation-list)
     - [Update SDK Theme](#update-sdk-theme)
     - [Deauthenticate and clear session](#deauthenticate-and-clear-session)
     - [Passing context object to Agent](#passing-context-object-to-agent)
@@ -155,6 +162,8 @@ extension MyViewController: SessionDelegate {
         // Refresh token from your server
         AuthService.refreshToken { newToken in
             if let token = newToken {
+                // When success completion is called, updateSessionInfo is called internally,
+                // which causes the SDK to update the token.
                 success(token)
             } else {
                 fail()
@@ -191,7 +200,7 @@ Display a floating launcher button:
 
 ```swift
 AIAgentMessenger.attachLauncher(
-    aiAgentId: self.aiAgentId
+    aiAgentId: {AIAgentId}
 )
 ```
 
@@ -276,6 +285,70 @@ AIAgentMessenger.attachLauncher(
 }
 ```
 
+### Entry Point Advanced Configuration Guide
+
+This guide covers advanced entry point configuration options for the Sendbird AI Agent iOS SDK.
+
+#### Entry Point Types
+
+The SDK supports two entry point types:
+
+```swift
+public enum SBAEntryPoint {
+    case conversation      // Direct to chat conversation (default)
+    case conversationList  // Show conversation list first
+}
+```
+
+- **`.conversation`**: Opens directly to the chat conversation interface
+- **`.conversationList`**: Shows a list of existing conversations first
+
+#### Launcher-based Entry Point Configuration
+
+##### Basic Setup
+
+Configure entry point through launcher options:
+
+```swift
+AIAgentMessenger.attachLauncher(
+    aiAgentId: {AIAgentId}"
+) { params in
+    params.options = SBALauncherOptions(
+        entryPoint: .conversationList, // or .conversation (default)
+        layout: .default,
+        displayStyle: .overlay()
+    )
+}
+```
+
+#### Direct ViewController Presentation
+
+##### Present Conversation
+
+Use `presentConversation()` when you want to show the chat interface directly:
+
+```swift
+AIAgentMessenger.presentConversation(
+    aiAgentId: {AIAgentId}
+) { params in
+    params.parent = self
+    params.presentationStyle = .fullScreen
+}
+```
+
+##### Present Conversation List
+
+Use `presentConversationList()` to show the conversation list:
+
+```swift
+AIAgentMessenger.presentConversationList(
+    aiAgentId: {AIAgentId}
+) { params in
+    params.parent = self
+    params.presentationStyle = .fullScreen
+}
+```
+
 ### Update SDK Theme
 
 You can customize the SDK’s color scheme to match your app's theme as shown below.
@@ -307,7 +380,7 @@ This allows for a more personalized and context-aware interaction experience.
 ```swift
 // Case: Attach launcher
 AIAgentMessenger.attachLauncher(
-    aiAgentId: TestConfig.aiAgentId
+    aiAgentId: {AIAgentId}
 ) { params in
     params.language = "en" // (opt)default: Locale.preferredLanguages.first
     params.countryCode = "US" // (opt)default: Locale.current.regionCode
@@ -318,7 +391,7 @@ AIAgentMessenger.attachLauncher(
 ```swift
 // Case:
 AIAgentMessenger.presentConversation(
-    aiAgentId: TestConfig.aiAgentId
+    aiAgentId: {AIAgentId}
 ) { params in
     params.language = "en" // (opt)default: Locale.preferredLanguages.first
     params.countryCode = "US" // (opt)default: Locale.current.regionCode

ios/sample/QuickStart.xcodeproj/project.pbxproj

@@ -24,6 +24,7 @@
 		7C71E7DA9216F9F86D741BB4 /* AppDelegate.swift in Sources */ = {isa = PBXBuildFile; fileRef = 6AA91801860324BF877C2336 /* AppDelegate.swift */; };
 		812695A5C4C90FF7E4A3AB9B /* AIAgentStarterKit+Utils.swift in Sources */ = {isa = PBXBuildFile; fileRef = 2A7036E74B93599B2C6902A6 /* AIAgentStarterKit+Utils.swift */; };
 		86EC93CA51BEB68AF7312F70 /* ExtendedSDKBridge+UIKit.swift in Sources */ = {isa = PBXBuildFile; fileRef = 4615C5A09D614DDB39BE743B /* ExtendedSDKBridge+UIKit.swift */; };
+		A41581E47D6F1E1336A9CF7E /* Splash in Frameworks */ = {isa = PBXBuildFile; productRef = BD5090BE228A912E78D3193F /* Splash */; };
 		A5B4456ED545348FC3E7A084 /* ExtendedSDKBridge.swift in Sources */ = {isa = PBXBuildFile; fileRef = 6D8BFB011EB64C4DE076D77E /* ExtendedSDKBridge.swift */; };
 		C1761DEEDB4CB13BBDA9D9F6 /* ViewController.swift in Sources */ = {isa = PBXBuildFile; fileRef = AD615656F26260F609F3E19B /* ViewController.swift */; };
 		DF4E553ADFAE538E35089963 /* ViewController.xib in Resources */ = {isa = PBXBuildFile; fileRef = 6D418B3D75969A462EC6516A /* ViewController.xib */; };
@@ -64,6 +65,7 @@
 			buildActionMask = 2147483647;
 			files = (
 				05EF3B883F179441278AD591 /* SendbirdAIAgentMessenger in Frameworks */,
+				A41581E47D6F1E1336A9CF7E /* Splash in Frameworks */,
 				E9134545B3A6C96D0326C579 /* UserNotifications.framework in Frameworks */,
 			);
 			runOnlyForDeploymentPostprocessing = 0;
@@ -174,13 +176,6 @@
 			path = ExtendedSDK;
 			sourceTree = "<group>";
 		};
-		"TEMP_E7192467-2C5D-4027-A17F-704A6E71EF68" /* Customization */ = {
-			isa = PBXGroup;
-			children = (
-			);
-			path = Customization;
-			sourceTree = "<group>";
-		};
 /* End PBXGroup section */
 
 /* Begin PBXNativeTarget section */
@@ -199,6 +194,7 @@
 			name = QuickStart;
 			packageProductDependencies = (
 				691283789AB5ADF115CAE086 /* SendbirdAIAgentMessenger */,
+				BD5090BE228A912E78D3193F /* Splash */,
 			);
 			productName = QuickStart;
 			productReference = 504F1132070E1B91DFDF8DBA /* AIAgent.app */;
@@ -253,6 +249,7 @@
 			minimizedProjectReferenceProxies = 1;
 			packageReferences = (
 				802787721279F86457E913BE /* XCRemoteSwiftPackageReference "sendbird-ai-agent-messenger-ios" */,
+				675F8C38FD2AE3D8230AF692 /* XCRemoteSwiftPackageReference "Splash" */,
 			);
 			preferredProjectObjectVersion = 77;
 			projectDirPath = "";
@@ -352,7 +349,7 @@
 					"@loader_path/Frameworks",
 				);
 				LLVM_LTO = YES;
-				MARKETING_VERSION = 0.10.1;
+				MARKETING_VERSION = 0.10.9;
 				MTL_ENABLE_DEBUG_INFO = INCLUDE_SOURCE;
 				MTL_FAST_MATH = YES;
 				OTHER_SWIFT_FLAGS = "-Xfrontend -no-serialize-debugging-options";
@@ -393,7 +390,7 @@
 					"@executable_path/Frameworks",
 					"@loader_path/Frameworks",
 				);
-				MARKETING_VERSION = 0.10.1;
+				MARKETING_VERSION = 0.10.9;
 				MTL_ENABLE_DEBUG_INFO = INCLUDE_SOURCE;
 				MTL_FAST_MATH = YES;
 				OTHER_SWIFT_FLAGS = "-DDEBUG";
@@ -549,7 +546,7 @@
 					"@loader_path/Frameworks",
 				);
 				LLVM_LTO = YES;
-				MARKETING_VERSION = 0.10.1;
+				MARKETING_VERSION = 0.10.9;
 				MTL_ENABLE_DEBUG_INFO = INCLUDE_SOURCE;
 				MTL_FAST_MATH = YES;
 				OTHER_SWIFT_FLAGS = "-Xfrontend -no-serialize-debugging-options";
@@ -591,7 +588,7 @@
 					"@executable_path/Frameworks",
 					"@loader_path/Frameworks",
 				);
-				MARKETING_VERSION = 0.10.1;
+				MARKETING_VERSION = 0.10.9;
 				MTL_ENABLE_DEBUG_INFO = INCLUDE_SOURCE;
 				MTL_FAST_MATH = YES;
 				OTHER_SWIFT_FLAGS = "-DDEBUG";
@@ -641,12 +638,20 @@
 /* End XCConfigurationList section */
 
 /* Begin XCRemoteSwiftPackageReference section */
+		675F8C38FD2AE3D8230AF692 /* XCRemoteSwiftPackageReference "Splash" */ = {
+			isa = XCRemoteSwiftPackageReference;
+			repositoryURL = "https://github.com/JohnSundell/Splash";
+			requirement = {
+				kind = upToNextMajorVersion;
+				minimumVersion = 0.16.0;
+			};
+		};
 		802787721279F86457E913BE /* XCRemoteSwiftPackageReference "sendbird-ai-agent-messenger-ios" */ = {
 			isa = XCRemoteSwiftPackageReference;
 			repositoryURL = "https://github.com/sendbird/sendbird-ai-agent-messenger-ios";
 			requirement = {
 				kind = upToNextMajorVersion;
-				minimumVersion = 0.10.4;
+				minimumVersion = 0.10.9;
 			};
 		};
 /* End XCRemoteSwiftPackageReference section */
@@ -657,6 +662,11 @@
 			package = 802787721279F86457E913BE /* XCRemoteSwiftPackageReference "sendbird-ai-agent-messenger-ios" */;
 			productName = SendbirdAIAgentMessenger;
 		};
+		BD5090BE228A912E78D3193F /* Splash */ = {
+			isa = XCSwiftPackageProductDependency;
+			package = 675F8C38FD2AE3D8230AF692 /* XCRemoteSwiftPackageReference "Splash" */;
+			productName = Splash;
+		};
 /* End XCSwiftPackageProductDependency section */
 	};
 	rootObject = 7F2D84C08194A453C686D4F4 /* Project object */;