react-native-sdk-pianoio 0.3.4 → 0.3.6

package/README.md

@@ -1,28 +1,13 @@
-# 🎹 React Native SDK for Piano.io
+# React Native SDK for Piano.io
 
-[![npm version](https://img.shields.io/npm/v/react-native-sdk-pianoio.svg)](https://www.npmjs.com/package/react-native-sdk-pianoio)
-[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
-
-A React Native SDK for integrating Piano.io's digital monetization platform into your mobile applications. This SDK provides seamless integration with Piano's paywall, subscription, and content monetization features.
+A React Native SDK for integrating Piano.io's digital monetization platform into your mobile applications. This SDK provides seamless, cross-platform integration with Piano's paywall, subscription, and content monetization features.
 
 ## ✨ Features
 
-### 🚀 Core Functionality
-- **Piano Composer Integration**: Full integration with Piano's Composer API
-- **OAuth Authentication**: User authentication and token management
-- **Experience Execution**: Execute Piano experiences with custom configurations
-- **Cross-Platform**: Works on both iOS and Android (Android fully implemented)
-
-### 📱 Platform Support
-- ✅ **Android**: Fully implemented and tested (91% test coverage)
-- 🚧 **iOS**: Basic implementation (needs feature parity)
-
-### 🔧 Configuration Options
-- **Tags Management**: Add/remove tags for content categorization
-- **Zone Configuration**: Set zone IDs for targeted experiences
-- **Custom Variables**: Add custom data to experiences
-- **User Tokens**: Manage user authentication tokens
-- **URL Configuration**: Set referrer and target URLs
+- **Full Piano Composer Integration**: Execute experiences, manage content access, and handle paywalls
+- **Piano ID Authentication**: Complete user authentication and token management for both platforms
+- **Cross-Platform Parity**: A single, unified API for both iOS and Android
+- **Flexible Configuration**: Manage tags, zone IDs, custom variables, user tokens, and more
 
 ## 📦 Installation
 
@@ -36,7 +21,7 @@ yarn add react-native-sdk-pianoio
 
 ### 1. Initialize the SDK
 
-```typescript
+```javascript
 import { PianoComposer } from 'react-native-sdk-pianoio';
 
 // Initialize with your Piano Application ID
@@ -45,44 +30,42 @@ const composer = await PianoComposer.create('YOUR_PIANO_AID');
 
 ### 2. Configure the Experience
 
-```typescript
-// Add tags for content categorization
-await composer.addTag('premium');
-await composer.addTags(['article', 'featured']);
+```javascript
+// Set the required parameters for the experience
+await composer.setUrl('https://www.your-website.com/premium-article');
+await composer.setZoneId('your_zone_id'); // e.g., 'default'
+await composer.setReferrer('https://www.your-website.com/');
 
-// Set zone ID for targeted experiences
-await composer.setZoneId('Zone1');
-
-// Add custom variables
+// Add optional parameters
+await composer.addTag('premium-content');
 await composer.setCustomVariable('article_id', '12345');
-
-// Set user token for authentication
-await composer.setUserToken('user_token_123');
 ```
 
 ### 3. Execute the Experience
 
-```typescript
-// Execute with basic configuration
-const result = await composer.executeExperience();
-
-// Execute with advanced configuration
-const result = await composer.executeExperienceWithConfig(true, true);
+```javascript
+try {
+  const result = await composer.executeExperience();
+  console.log('Experience result:', result);
+  // Handle the event data from the Piano backend
+} catch (error) {
+  console.error('Failed to execute experience:', error);
+}
 ```
 
 ### 4. Handle Authentication
 
-```typescript
-// Sign in user
+```javascript
+// Sign in a user
 const user = await composer.signIn();
 
-// Check authentication status
+// Check if a user is authenticated
 const isAuthenticated = await composer.isAuthenticated();
 
-// Get current user
+// Get the current user's details
 const currentUser = await composer.getCurrentUser();
 
-// Sign out user
+// Sign out the user
 await composer.signOut();
 ```
 
@@ -90,95 +73,48 @@ await composer.signOut();
 
 ### Core Methods
 
-#### `PianoComposer.create(aid: string)`
-Creates and initializes a new PianoComposer instance.
-
-#### `composer.addTag(tag: string)`
-Adds a single tag to the experience.
-
-#### `composer.addTags(tags: string[])`
-Adds multiple tags to the experience.
-
-#### `composer.setZoneId(zoneId: string)`
-Sets the zone ID for targeted experiences.
-
-#### `composer.setCustomVariable(key: string, value: string)`
-Adds a custom variable to the experience.
-
-#### `composer.executeExperience()`
-Executes the Piano experience with current configuration.
-
-### Authentication Methods
-
-#### `composer.signIn()`
-Signs in the user with Piano OAuth.
-
-#### `composer.signOut()`
-Signs out the current user.
-
-#### `composer.getCurrentUser()`
-Gets information about the current authenticated user.
-
-#### `composer.isAuthenticated()`
-Checks if a user is currently authenticated.
-
-### Advanced Methods
-
-#### `composer.executeExperienceWithConfig(includeUserData: boolean, debug: boolean)`
-Executes experience with advanced configuration options.
-
-#### `composer.createExperienceRequest(includeUserData?: boolean, debug?: boolean)`
-Creates an experience request with custom parameters.
-
-#### `composer.getStatus()`
-Gets the current status of the composer.
-
-#### `composer.testExecutionFlow()`
-Tests the complete execution flow.
-
-## 🧪 Testing
-
-The SDK includes comprehensive test coverage:
-
-```bash
-# Run all tests
-npm test
-
-# Run tests with coverage
-npm run test:coverage
-
-# Run Android-specific tests
-cd android && ./test.sh
-```
-
-### Test Results
-- ✅ **91% Test Coverage** on Android implementation
-- ✅ **67/73 tests passing**
-- ✅ **All core functionality tested**
+- `PianoComposer.create(aid: string)` - Creates and initializes a new PianoComposer instance
+- `composer.executeExperience()` - Executes the Piano experience with the current configuration
+- `composer.signIn()` - Initiates the user sign-in flow
+- `composer.signOut()` - Signs out the current user
+
+### Configuration Methods
+
+- `addTag(tag: string)`
+- `addTags(tags: string[])`
+- `setZoneId(zoneId: string)`
+- `setReferrer(referrer: string)`
+- `setUrl(url: string)`
+- `setUserToken(token: string)`
+- `addCustomVariable(key: string, value: string)`
+- `setCustomVariables(variables: { [key: string]: string })`
+
+### Utility Methods
+
+- `getCurrentUser()`
+- `isAuthenticated()`
+- `getStatus()`
+- `clearConfiguration()`
+- `removeTag(tag: string)`
+- `removeCustomVariable(key: string)`
+- `clearTags()`
+- `clearCustomVariables()`
 
 ## 📱 Platform Status
 
-### Android ✅
-- **Status**: Fully implemented and tested
-- **Coverage**: 91% test coverage
-- **Features**: All core features implemented
-- **Dependencies**: React Native 0.78.1 compatible
-
-### iOS 🚧
-- **Status**: Basic implementation
-- **Coverage**: Needs feature parity with Android
-- **Features**: Core methods implemented
-- **Next Steps**: Implement advanced features and authentication
+- ✅ **Android**: Fully implemented and aligned with the official Piano Android SDK
+- ✅ **iOS**: Fully implemented and aligned with the official Piano iOS SDK
 
 ## 🔧 Development
 
 ### Prerequisites
+
 - Node.js 18+
-- React Native 0.78.1
+- React Native
 - Android Studio (for Android development)
-- Xcode (for iOS development)
+- Xcode & CocoaPods (for iOS development)
 
-### Setup Development Environment
+### Setup
 
 ```bash
 # Clone the repository
@@ -187,67 +123,60 @@ git clone https://github.com/HexagonSwiss/hex-react-native-sdk-pianoio.git
 # Install dependencies
 npm install
 
-# Run tests
-npm test
-
 # Build the library
 npm run build
 ```
 
 ### Project Structure
+
 ```
-├── android/                 # Android native implementation
-│   ├── src/main/java/      # Kotlin source files
-│   └── src/test/java/      # Android tests
-├── ios/                    # iOS native implementation
-├── src/                    # TypeScript source
-│   ├── index.tsx          # Main entry point
-│   ├── PianoComposer.tsx  # Main SDK class
-│   └── NativeSdkPianoio.ts # Native module interface
-├── example/               # Example React Native app
-└── lib/                   # Built library files
+├── android/      # Android native implementation
+├── ios/          # iOS native implementation
+├── src/          # TypeScript source (JS bridge)
+└── ...
 ```
 
-## 🎯 Example App
-
-The repository includes a comprehensive example app demonstrating all SDK features:
+## 🎯 How to install
 
-```bash
-# Navigate to example directory
-cd example
+```
+# In your expo projet's app.json file, make sure to have:
+
+  "plugins": [
+    [
+      "expo-build-properties",
+      {
+        "android": {
+          "buildToolsVersion": "35.0.0",
+          "compileSdkVersion": 34,
+          "minSdkVersion": 24,
+          "targetSdkVersion": 34
+        },
+        "ios": {
+           "deploymentTarget": "15.1",
+           "useFrameworks": "static"
+         }
+      }
+    ]
+      ...other plugins...
+  ],
 
 # Install dependencies
-npm install
+npm install react-native-sdk-pianoio
 
 # Run on Android
-npx react-native run-android
+npx expo run:android
 
 # Run on iOS
-npx react-native run-ios
+npx expo run:ios
 ```
 
-The example app includes:
-- ✅ Basic configuration testing
-- ✅ Authentication flow testing
-- ✅ Advanced configuration options
-- ✅ Experience execution
-- ✅ Real-time logging
-
 ## 🤝 Contributing
 
-We welcome contributions! Please see our [Contributing Guide](CONTRIBUTING.md) for details.
-
-### Development Workflow
-1. Fork the repository
-2. Create a feature branch
-3. Make your changes
-4. Add tests for new functionality
-5. Ensure all tests pass
-6. Submit a pull request
+We welcome contributions! Please see our Contributing Guide for details.
 
 ## 📄 License
 
-This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
+This project is licensed under the MIT License - see the LICENSE file for details.
 
 ## 🆘 Support
 
@@ -255,10 +184,6 @@ This project is licensed under the MIT License - see the [LICENSE](LICENSE) file
 - 🐛 **Issues**: [GitHub Issues](https://github.com/HexagonSwiss/hex-react-native-sdk-pianoio/issues)
 - 📖 **Documentation**: [Piano.io Documentation](https://docs.piano.io/)
 
-## 🔄 Changelog
-
-See [CHANGELOG.md](CHANGELOG.md) for a detailed history of changes.
-
 ---
 
-**Made with ❤️ by [HexagonSwiss](https://hexagonswiss.ch)**
+Made with ❤️ by HexagonSwiss

package/android/src/main/java/com/sdkpianoio/ComposerPianoImpl.kt

@@ -26,40 +26,24 @@ class ComposerPianoImpl {
 
     // MARK: - Properties
 
-    /** The Piano SDK's Composer instance */
     private var composer: Composer? = null
-
-    /** The Piano ID Token Service instance */
     internal var tokenService: TokenService? = null
 
-    /** The Piano Application ID */
     companion object {
         var aid: String = ""
     }
 
     // MARK: - Configuration Properties
 
-    /** Configured tags for the composer */
     private val tags = mutableListOf<String>()
-
-    /** Configured Zone ID */
     private var zoneId: String? = null
-
-    /** Configured referrer */
     private var referrer: String? = null
-
-    /** Configured URL */
     private var url: String? = null
-
-    /** Configured user token */
     private var userToken: String? = null
-
-    /** Configured custom variables */
     private val customVariables = mutableMapOf<String, String>()
 
     // MARK: - Initialization
 
-    /** Public class constructor Initializes the instance with default values */
     constructor() {
         println("ComposerPianoImpl: Constructor initialized")
     }
@@ -103,24 +87,48 @@ class ComposerPianoImpl {
         }
     }
 
-    // MARK: - Configuration Methods
+    // MARK: - State Methods (Getters)
+
+    fun getAid(): String {
+        return ComposerPianoImpl.aid
+    }
+
+    fun getTags(): List<String> {
+        return this.tags.toList()
+    }
+
+    fun getZoneId(): String {
+        return this.zoneId ?: ""
+    }
+
+    fun getReferrer(): String {
+        return referrer ?: ""
+    }
+
+    fun getUrl(): String {
+        return url ?: ""
+    }
+
+    fun getUserToken(): String {
+        return userToken ?: ""
+    }
+
+    fun getComposer(): Composer? {
+        return composer
+    }
+
+    fun getCustomVariables(): Map<String, String> {
+        return customVariables.toMap()
+    }
+
+    // MARK: - Configuration Methods (Setters)
 
-    /**
-     * Adds a tag to the composer
-     *
-     * @param tag The tag to be added
-     */
     fun addTag(tag: String) {
         if (!this.tags.contains(tag)) {
             this.tags.add(tag)
         }
     }
 
-    /**
-     * Adds multiple tags to the composer
-     *
-     * @param tags The list of tags to be added
-     */
     fun addTags(tags: List<String>) {
         for (tag in tags) {
             if (!this.tags.contains(tag)) {
@@ -129,166 +137,57 @@ class ComposerPianoImpl {
         }
     }
 
-    /**
-     * Sets the Zone ID for the composer
-     *
-     * @param zoneId The Zone ID to be configured
-     */
     fun setZoneId(zoneId: String) {
         this.zoneId = zoneId
     }
 
-    /**
-     * Sets the referrer for the composer
-     *
-     * @param referrer The referrer to be configured
-     */
     fun setReferrer(referrer: String) {
         this.referrer = referrer
     }
 
-    /**
-     * Sets the URL for the composer
-     *
-     * @param url The URL to be configured
-     */
     fun setUrl(url: String) {
         this.url = url
     }
 
-    /**
-     * Sets the user token on the Composer instance.
-     *
-     * @param token The user's access token.
-     */
     fun setUserToken(token: String) {
         this.userToken = token
-        // Call the official SDK method to set the token
         composer?.userToken(token)
     }
 
-    /**
-     * Adds a custom variable.
-     *
-     * @param key The variable's key
-     * @param value The variable's value
-     */
     fun addCustomVariable(key: String, value: String) {
         this.customVariables[key] = value
     }
 
-    // MARK: - Advanced Configuration Methods
-
-    /**
-     * Sets multiple custom variables at once.
-     *
-     * @param variables A map of custom variables.
-     */
     fun setCustomVariables(variables: Map<String, String>) {
         this.customVariables.clear()
         this.customVariables.putAll(variables)
     }
 
-    /** Removes all configured tags. */
+    // MARK: - Cleanup Methods
+
     fun clearTags() {
         this.tags.clear()
     }
 
-    /** Removes all custom variables. */
     fun clearCustomVariables() {
         this.customVariables.clear()
     }
 
-    /**
-     * Removes a specific tag.
-     *
-     * @param tag The tag to be removed.
-     */
     fun removeTag(tag: String) {
         this.tags.remove(tag)
     }
 
-    /**
-     * Removes a specific custom variable.
-     *
-     * @param key The key of the variable to be removed.
-     */
     fun removeCustomVariable(key: String) {
         this.customVariables.remove(key)
     }
 
-    // MARK: - State Methods (Getters)
-
-    /**
-     * Gets the Application ID.
-     *
-     * @return The current Application ID.
-     */
-    fun getAid(): String {
-        return ComposerPianoImpl.aid
-    }
-
-    /**
-     * Gets the configured tags.
-     *
-     * @return A list of configured tags.
-     */
-    fun getTags(): List<String> {
-        return this.tags.toList()
-    }
-
-    /**
-     * Gets the configured Zone ID.
-     *
-     * @return The current Zone ID.
-     */
-    fun getZoneId(): String {
-        return this.zoneId ?: ""
-    }
-
-    /**
-     * Gets the configured referrer.
-     *
-     * @return The current referrer.
-     */
-    fun getReferrer(): String {
-        return referrer ?: ""
-    }
-
-    /**
-     * Gets the configured URL.
-     *
-     * @return The current URL.
-     */
-    fun getUrl(): String {
-        return url ?: ""
-    }
-
-    /**
-     * Gets the user token.
-     *
-     * @return The current user token.
-     */
-    fun getUserToken(): String {
-        return userToken ?: ""
-    }
-
-    /**
-     * Gets the composer instance.
-     *
-     * @return The Composer instance, or null if not initialized.
-     */
-    fun getComposer(): Composer? {
-        return composer
-    }
-
-    /**
-     * Gets the configured custom variables.
-     *
-     * @return A map of the custom variables.
-     */
-    fun getCustomVariables(): Map<String, String> {
-        return customVariables.toMap()
+    fun clearConfiguration() {
+        this.clearTags()
+        this.clearCustomVariables()
+        this.zoneId = null
+        this.referrer = null
+        this.url = null
+        this.userToken = null
     }
 
     // MARK: - Execution Methods

package/android/src/main/java/com/sdkpianoio/TokenService.kt

@@ -54,20 +54,10 @@ class TokenService {
 
     // MARK: - Authentication Methods
 
-    /**
-     * Caches the token received from a successful sign-in.
-     *
-     * @param token The token to cache. Can be null to clear it.
-     */
     fun setToken(token: PianoIdToken?) {
         this.cachedToken = token
     }
 
-    /**
-     * Launches the Piano ID sign-in flow.
-     *
-     * @param authResultLauncher The ActivityResultLauncher from the calling Activity/Fragment.
-     */
     fun signIn(authResultLauncher: ActivityResultLauncher<PianoIdClient.SignInContext>) {
         val localClient = client
         if (localClient == null) {
@@ -79,11 +69,6 @@ class TokenService {
         authResultLauncher.launch(request)
     }
 
-    /**
-     * Signs the user out.
-     *
-     * @param callback The callback to be invoked with the result (true for success, false for failure).
-     */
     fun signOut(callback: (Boolean) -> Unit) {
         val localClient = client
         if (localClient == null) {
@@ -113,11 +98,6 @@ class TokenService {
 
     // MARK: - User Information Methods
 
-    /**
-     * Gets the current user's information.
-     *
-     * @return A User object if authenticated, otherwise null.
-     */
     fun getCurrentUser(): User? {
         val token = this.cachedToken ?: return null
         // Construct a user from the token information using the getInfoField method.
@@ -128,11 +108,6 @@ class TokenService {
         )
     }
 
-    /**
-     * Checks if a user is currently authenticated.
-     *
-     * @return true if a valid token exists, false otherwise.
-     */
     fun isAuthenticated(): Boolean {
         return this.cachedToken != null
     }

package/ios/ComposerPianoImpl.swift

@@ -3,15 +3,13 @@ import PianoComposer
 import PianoOAuth
 import React
 
-/**
- * ComposerPianoImpl - Main implementation class for the Piano SDK on iOS.
- *
- * This class is responsible for:
- * - Managing the Piano SDK's Composer instance.
- * - Configuring the experience request using a fluent builder pattern.
- * - Executing Piano experiences and handling results via a delegate.
- * - Managing React Native promises across asynchronous callbacks.
- */
+/// ComposerPianoImpl - Main implementation class for the Piano SDK on iOS.
+///
+/// This class is responsible for:
+/// - Managing the Piano SDK's Composer instance.
+/// - Configuring the experience request using a fluent builder pattern.
+/// - Executing Piano experiences and handling results via a delegate.
+/// - Managing React Native promises across asynchronous callbacks.
 @objcMembers public class ComposerPianoImpl: NSObject {
 
     // MARK: - Properties
@@ -20,15 +18,14 @@ import React
     private var tokenService: TokenService?
     private var delegate: MyComposerDelegate?
 
-    // Promises to communicate results of async operations back to React Native
     var experienceResolver: RCTPromiseResolveBlock?
     var experienceRejecter: RCTPromiseRejectBlock?
 
-    // Stored configuration properties
     private var tags: [String] = []
     private var zoneId: String?
     private var referrer: String?
     private var url: String?
+    private var userToken: String?
     private var customVariables: [String: String] = [:]
 
     // MARK: - Initialization
@@ -56,7 +53,33 @@ import React
         print("ComposerPianoImpl: Delegate initialized and set")
     }
 
-    // MARK: - Configuration Methods
+    // MARK: - State Methods (Getters)
+
+    public func getTags() -> [String] {
+        return self.tags
+    }
+
+    public func getZoneId() -> String {
+        return self.zoneId ?? ""
+    }
+
+    public func getReferrer() -> String {
+        return self.referrer ?? ""
+    }
+
+    public func getUrl() -> String {
+        return self.url ?? ""
+    }
+
+    public func getUserToken() -> String {
+        return self.composer?.userToken ?? ""
+    }
+
+    public func getCustomVariables() -> [String: String] {
+        return self.customVariables
+    }
+
+    // MARK: - Configuration Methods (Setters)
 
     public func addTag(_ tag: String) {
         self.tags.append(tag)
@@ -78,23 +101,47 @@ import React
         self.url = url
     }
 
-    public func setCustomVariable(_ name: String, value: String) {
+    public func setCustomVariables(_ variables: [String: String]) {
+        self.customVariables = variables
+    }
+
+    public func addCustomVariable(_ name: String, value: String) {
         self.customVariables[name] = value
     }
 
     public func setUserToken(_ token: String) {
-        // The iOS SDK requires setting the user token on the composer instance directly
         _ = self.composer?.userToken(token)
     }
 
+    // MARK: - Cleanup Methods
+
+    public func clearTags() {
+        self.tags.removeAll()
+    }
+
+    public func clearCustomVariables() {
+        self.customVariables.removeAll()
+    }
+
+    public func removeTag(_ tag: String) {
+        self.tags.removeAll { $0 == tag }
+    }
+
+    public func removeCustomVariable(key: String) {
+        self.customVariables.removeValue(forKey: key)
+    }
+
+    public func clearConfiguration() {
+        self.clearTags()
+        self.clearCustomVariables()
+        self.zoneId = nil
+        self.referrer = nil
+        self.url = nil
+        self.userToken = nil
+    }
+
     // MARK: - Execution Method
 
-    /**
-     * Executes the Piano experience with the current configuration.
-     *
-     * @param resolver The promise resolver from React Native.
-     * @param rejecter The promise rejecter from React Native.
-     */
     public func executeExperience(
         resolver: @escaping RCTPromiseResolveBlock,
         rejecter: @escaping RCTPromiseRejectBlock
@@ -104,47 +151,20 @@ import React
             return
         }
 
-        print("ComposerPianoImpl: Executing experience")
-
-        // Store the promise functions to be called by the delegate later
         self.experienceResolver = resolver
         self.experienceRejecter = rejecter
 
-        // Configure the composer instance using the fluent interface
-        _ = composer
+        _ =
+            composer
             .tags(self.tags)
-            .zoneId(self.zoneId ?? "") // Safely unwrap optionals
-            .referrer(self.referrer ?? "") // Safely unwrap optionals
-            .url(self.url ?? "") // Safely unwrap optionals
+            .zoneId(self.zoneId ?? "")
+            .referrer(self.referrer ?? "")
+            .url(self.url ?? "")
 
         for (key, value) in self.customVariables {
             _ = composer.customVariable(name: key, value: value)
         }
 
-        // Execute the experience. The result will be handled by the delegate.
         composer.execute()
     }
-    
-    // MARK: - State Methods (Getters)
-    
-    public func getTags() -> [String] {
-        return self.tags
-    }
-    
-    public func getZoneId() -> String {
-        return self.zoneId ?? ""
-    }
-    
-    public func getReferrer() -> String {
-        return self.referrer ?? ""
-    }
-    
-    public func getUrl() -> String {
-        return self.url ?? ""
-    }
-    
-    public func getUserToken() -> String {
-        // User token is write-only to the composer instance, so we return the stored value if needed.
-        return self.composer?.userToken ?? ""
-    }
 }

package/ios/SdkPianoio.swift

@@ -1,11 +1,9 @@
 import Foundation
 import React
 
-/**
- * SdkPianoio - The main React Native bridge module for the Piano SDK.
- *
- * This class exposes the functionality of the ComposerPianoImpl to JavaScript.
- */
+/// SdkPianoio - The main React Native bridge module for the Piano SDK.
+///
+/// This class exposes the functionality of the ComposerPianoImpl to JavaScript.
 @objc(SdkPianoio)
 class SdkPianoio: NSObject {
 
@@ -18,7 +16,10 @@ class SdkPianoio: NSObject {
     }
 
     @objc(initialize:resolver:rejecter:)
-    func initialize(aid: String, resolver: @escaping RCTPromiseResolveBlock, rejecter: @escaping RCTPromiseRejectBlock) {
+    func initialize(
+        aid: String, resolver: @escaping RCTPromiseResolveBlock,
+        rejecter: @escaping RCTPromiseRejectBlock
+    ) {
         moduleImpl?.initialize(aid: aid)
         resolver(true)
     }
@@ -26,51 +27,123 @@ class SdkPianoio: NSObject {
     // MARK: - Configuration Methods
 
     @objc(addTag:resolver:rejecter:)
-    func addTag(tag: String, resolver: @escaping RCTPromiseResolveBlock, rejecter: @escaping RCTPromiseRejectBlock) {
+    func addTag(
+        tag: String, resolver: @escaping RCTPromiseResolveBlock,
+        rejecter: @escaping RCTPromiseRejectBlock
+    ) {
         moduleImpl?.addTag(tag)
         resolver(true)
     }
 
     @objc(addTags:resolver:rejecter:)
-    func addTags(tags: [String], resolver: @escaping RCTPromiseResolveBlock, rejecter: @escaping RCTPromiseRejectBlock) {
+    func addTags(
+        tags: [String], resolver: @escaping RCTPromiseResolveBlock,
+        rejecter: @escaping RCTPromiseRejectBlock
+    ) {
         moduleImpl?.addTags(tags)
         resolver(true)
     }
 
     @objc(setZoneId:resolver:rejecter:)
-    func setZoneId(zoneId: String, resolver: @escaping RCTPromiseResolveBlock, rejecter: @escaping RCTPromiseRejectBlock) {
+    func setZoneId(
+        zoneId: String, resolver: @escaping RCTPromiseResolveBlock,
+        rejecter: @escaping RCTPromiseRejectBlock
+    ) {
         moduleImpl?.setZoneId(zoneId)
         resolver(true)
     }
 
     @objc(setReferrer:resolver:rejecter:)
-    func setReferrer(referrer: String, resolver: @escaping RCTPromiseResolveBlock, rejecter: @escaping RCTPromiseRejectBlock) {
+    func setReferrer(
+        referrer: String, resolver: @escaping RCTPromiseResolveBlock,
+        rejecter: @escaping RCTPromiseRejectBlock
+    ) {
         moduleImpl?.setReferrer(referrer)
         resolver(true)
     }
 
     @objc(setUrl:resolver:rejecter:)
-    func setUrl(url: String, resolver: @escaping RCTPromiseResolveBlock, rejecter: @escaping RCTPromiseRejectBlock) {
+    func setUrl(
+        url: String, resolver: @escaping RCTPromiseResolveBlock,
+        rejecter: @escaping RCTPromiseRejectBlock
+    ) {
         moduleImpl?.setUrl(url)
         resolver(true)
     }
 
     @objc(setUserToken:resolver:rejecter:)
-    func setUserToken(token: String, resolver: @escaping RCTPromiseResolveBlock, rejecter: @escaping RCTPromiseRejectBlock) {
+    func setUserToken(
+        token: String, resolver: @escaping RCTPromiseResolveBlock,
+        rejecter: @escaping RCTPromiseRejectBlock
+    ) {
         moduleImpl?.setUserToken(token)
         resolver(true)
     }
 
-    @objc(setCustomVariable:value:resolver:rejecter:)
-    func setCustomVariable(name: String, value: String, resolver: @escaping RCTPromiseResolveBlock, rejecter: @escaping RCTPromiseRejectBlock) {
-        moduleImpl?.setCustomVariable(name, value: value)
+    @objc(addCustomVariable:value:resolver:rejecter:)
+    func addCustomVariable(
+        name: String, value: String, resolver: @escaping RCTPromiseResolveBlock,
+        rejecter: @escaping RCTPromiseRejectBlock
+    ) {
+        moduleImpl?.addCustomVariable(name, value: value)
+        resolver(true)
+    }
+
+    @objc(setCustomVariables:resolver:rejecter:)
+    func setCustomVariables(
+        variables: [String: String], resolver: @escaping RCTPromiseResolveBlock,
+        rejecter: @escaping RCTPromiseRejectBlock
+    ) {
+        moduleImpl.setCustomVariables(variables)
         resolver(true)
     }
 
     // MARK: - Execution Method
 
     @objc(executeExperience:rejecter:)
-    func executeExperience(resolver: @escaping RCTPromiseResolveBlock, rejecter: @escaping RCTPromiseRejectBlock) {
+    func executeExperience(
+        resolver: @escaping RCTPromiseResolveBlock, rejecter: @escaping RCTPromiseRejectBlock
+    ) {
         moduleImpl?.executeExperience(resolver: resolver, rejecter: rejecter)
     }
+
+    // MARK: - Authentication Methods
+
+    @objc(signIn:rejecter:)
+    func signIn(
+        resolver: @escaping RCTPromiseResolveBlock, rejecter: @escaping RCTPromiseRejectBlock
+    ) {
+        moduleImpl.signIn(resolver: resolver, rejecter: rejecter)
+    }
+
+    @objc(signOut:rejecter:)
+    func signOut(
+        resolver: @escaping RCTPromiseResolveBlock, rejecter: @escaping RCTPromiseRejectBlock
+    ) {
+        moduleImpl.signOut(resolver: resolver, rejecter: rejecter)
+    }
+
+    @objc(getCurrentUser:rejecter:)
+    func getCurrentUser(
+        resolver: @escaping RCTPromiseResolveBlock, rejecter: @escaping RCTPromiseRejectBlock
+    ) {
+        moduleImpl.getCurrentUser(resolver: resolver, rejecter: rejecter)
+    }
+
+    @objc(isAuthenticated:rejecter:)
+    func isAuthenticated(
+        resolver: @escaping RCTPromiseResolveBlock, rejecter: @escaping RCTPromiseRejectBlock
+    ) {
+        moduleImpl.isAuthenticated(resolver: resolver, rejecter: rejecter)
+    }
+
+    // MARK: - Helper and Cleanup Methods
+
+    @objc(clearConfiguration:rejecter:)
+    func clearConfiguration(
+        resolver: @escaping RCTPromiseResolveBlock, rejecter: @escaping RCTPromiseRejectBlock
+    ) {
+        moduleImpl.clearConfiguration()
+        resolver(true)
+    }
 }

package/ios/SdkPianoioBridge.m

@@ -35,19 +35,37 @@ RCT_EXTERN_METHOD(setUserToken:(NSString *)token
                   resolver:(RCTPromiseResolveBlock)resolve
                   rejecter:(RCTPromiseRejectBlock)reject)
 
-RCT_EXTERN_METHOD(setCustomVariable:(NSString *)name
+RCT_EXTERN_METHOD(addCustomVariable:(NSString *)name
                   value:(NSString *)value
                   resolver:(RCTPromiseResolveBlock)resolve
                   rejecter:(RCTPromiseRejectBlock)reject)
 
+RCT_EXTERN_METHOD(setCustomVariables:(NSDictionary *)variables
+                  resolver:(RCTPromiseResolveBlock)resolve
+                  rejecter:(RCTPromiseRejectBlock)reject)
+
 // MARK: - Execution Method
 
 RCT_EXTERN_METHOD(executeExperience:(RCTPromiseResolveBlock)resolve
                   rejecter:(RCTPromiseRejectBlock)reject)
 
-// Note: Authentication methods (signIn, signOut, etc.) would be added here
-// if they were exposed from SdkPianoio.swift. Since they are handled internally
-// by the Composer/TokenService interaction, they don't need to be exposed directly
-// unless you add them to the SdkPianoio.swift class.
+// MARK: - Authentication Methods
+
+RCT_EXTERN_METHOD(signIn:(RCTPromiseResolveBlock)resolve
+                  rejecter:(RCTPromiseRejectBlock)reject)
+
+RCT_EXTERN_METHOD(signOut:(RCTPromiseResolveBlock)resolve
+                  rejecter:(RCTPromiseRejectBlock)reject)
+
+RCT_EXTERN_METHOD(getCurrentUser:(RCTPromiseResolveBlock)resolve
+                  rejecter:(RCTPromiseRejectBlock)reject)
+
+RCT_EXTERN_METHOD(isAuthenticated:(RCTPromiseResolveBlock)resolve
+                  rejecter:(RCTPromiseRejectBlock)reject)
+
+// MARK: - Helper and Cleanup Methods
+
+RCT_EXTERN_METHOD(clearConfiguration:(RCTPromiseResolveBlock)resolve
+                  rejecter:(RCTPromiseRejectBlock)reject)
 
 @end

package/ios/TokenService.swift

@@ -16,7 +16,7 @@ public class User {
         self.accessToken = accessToken
     }
 }
-
+ 
 /**
  * TokenService - Manages OAuth tokens and authentication with the Piano ID SDK.
  *
@@ -40,11 +40,6 @@ public class TokenService: NSObject, PianoIDDelegate {
 
     // MARK: - Initialization
 
-    /**
-     * Initializes the TokenService and configures the PianoID singleton.
-     *
-     * @param aid The Piano Application ID.
-     */
     public func initialize(aid: String) {
         if isInitialized {
             return
@@ -61,12 +56,8 @@ public class TokenService: NSObject, PianoIDDelegate {
 
     // MARK: - Authentication Methods
 
-    /**
-     * Starts the sign-in process.
-     *
-     * @param resolver The promise resolver from React Native.
-     * @param rejecter The promise rejecter from React Native.
-     */
+     // Missing set tokens no?
+
     public func signIn(resolver: @escaping (Any?) -> Void, rejecter: @escaping (String?, String?, Error?) -> Void) {
         if !isInitialized {
             print("TokenService: Not initialized. Call initialize() first.")
@@ -79,12 +70,7 @@ public class TokenService: NSObject, PianoIDDelegate {
         PianoID.shared.signIn()
     }
 
-    /**
-     * Starts the sign-out process.
-     *
-     * @param resolver The promise resolver from React Native.
-     * @param rejecter The promise rejecter from React Native.
-     */
+
     public func signOut(resolver: @escaping (Any?) -> Void, rejecter: @escaping (String?, String?, Error?) -> Void) {
         if !isInitialized {
             print("TokenService: Not initialized.")
@@ -105,11 +91,6 @@ public class TokenService: NSObject, PianoIDDelegate {
 
     // MARK: - User Information Methods
 
-    /**
-     * Gets the current user's information.
-     *
-     * @return A User object if authenticated, otherwise null.
-     */
     public func getCurrentUser() -> User? {
         guard let token = self.cachedToken else {
             return nil
@@ -129,11 +110,6 @@ public class TokenService: NSObject, PianoIDDelegate {
         )
     }
 
-    /**
-     * Checks if a user is currently authenticated.
-     *
-     * @return true if a valid token exists, false otherwise.
-     */
     public func isAuthenticated() -> Bool {
         return self.cachedToken != nil
     }
@@ -157,7 +133,7 @@ public class TokenService: NSObject, PianoIDDelegate {
             print("TokenService: Sign in failed: \(e.localizedDescription)")
             self.signInRejecter?("SIGNIN_ERROR", e.localizedDescription, e)
         }
-        // Clean up promises
+
         self.signInResolver = nil
         self.signInRejecter = nil
     }
@@ -188,12 +164,6 @@ public class TokenService: NSObject, PianoIDDelegate {
     
     // MARK: - Helper Methods
     
-    /**
-     * Decodes the payload of a JWT.
-     *
-     * @param jwt The JSON Web Token string.
-     * @return A dictionary of claims, or nil if decoding fails.
-     */
     private func decode(jwtToken jwt: String) -> [String: Any]? {
         let segments = jwt.components(separatedBy: ".")
         guard segments.count > 1 else {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-native-sdk-pianoio",
-  "version": "0.3.4",
+  "version": "0.3.6",
   "description": "Piano io sdk integration",
   "source": "./src/index.tsx",
   "main": "./lib/commonjs/index.js",