@octopus-community/react-native 1.0.0

package/LICENSE.md

@@ -0,0 +1,143 @@
+# Octopus Community Mobile SDK License Agreement
+
+**By downloading, installing, accessing, or otherwise using the SDK, Licensee acknowledges that it has read this Agreement, understands it, and agrees to be bound by its terms.**
+
+This Mobile SDK License Agreement (the “**Agreement**”) is entered into by and between Octopus Community SAS (“**Licensor**”) and you or the entity you represent (“**Licensee**”). By downloading, accessing, or using the Octopus Community Mobile SDK (“**SDK**”), Licensee agrees to be bound by this Agreement.
+
+## 1. Definitions
+
+1.1 **“API”** means the application programming interface made available by Licensor, including any accompanying or related documentation, source code, executable applications, and other materials provided by Licensor for use in conjunction with the SDK.
+
+1.2 **“SaaS Service”** means the proprietary software-as-a-service platform provided by Licensor, which is accessed via the API.
+
+1.3 **“Authorized Application”** means a software application developed by Licensee using the SDK solely for interacting with the SaaS Service.
+
+1.4 **“Confidential Information”** means any information disclosed by Licensor to Licensee that is identified as confidential or proprietary, or that would otherwise reasonably be understood to be confidential in nature, including but not limited to source code, trade secrets, and non-public business information.
+
+## 2. Grant of License
+
+2.1 **License Grant**
+
+Subject to Licensee’s compliance with this Agreement, Licensor grants Licensee a limited, non-exclusive, non-transferable, non-sublicensable, revocable license to:
+
+- Download, install, and use the SDK in source or binary form **solely** to develop and test Authorized Applications that interface with and depend on Licensor’s SaaS Service via the API.
+
+2.2 **Access to Source Code**
+
+Licensor may provide the SDK source code for reference, debugging, and integration purposes. **This provision does not constitute an open-source license**; rather, it grants Licensee the right to view and compile the provided source code only as necessary for development of Authorized Applications in conjunction with the SaaS Service.
+
+## 3. License Restrictions
+
+3.1 **Permitted Use**
+
+Licensee may use the SDK **only** to develop Authorized Applications that exclusively interact with the SaaS Service via the API. Any other use, including use with any third-party services or products, is prohibited unless expressly authorized in writing by Licensor.
+
+3.2 **Modifications**
+
+Licensee shall not modify, translate, adapt, arrange, or create derivative works of the SDK, in whole or in part, for any purpose other than (a) debug or integration efforts necessary for the Authorized Application to properly interface with the SaaS Service, and (b) as otherwise expressly permitted by Licensor in writing. **Under no circumstances** shall any modifications be used independently of the SaaS Service or for any other commercial or non-commercial use.
+
+3.3 **Distribution**
+
+Licensee may distribute the SDK (in compiled or other form) **only** as embedded or integrated in the Authorized Application, **solely** for the purpose of enabling end users to connect to and use the SaaS Service. Licensee is prohibited from redistributing the SDK as a standalone product or library.
+
+3.4 **Prohibitions**
+
+Licensee shall not:
+
+- Sell, license, lease, rent, loan, resell, or otherwise distribute the SDK except as expressly set forth herein.
+- Remove, alter, or obscure any copyright notices, trademarks, or other proprietary notices or legends from the SDK.
+- Use the SDK in any manner that infringes, misappropriates, or violates any intellectual property, publicity, privacy, or other right of any third party.
+- Disassemble, decompile, or reverse engineer the SDK, or attempt to discover any source code therein (except to the extent that the SDK is provided in source form or as otherwise permitted under applicable law).
+
+3.5 **No Competitive Use**
+
+Licensee shall not use the SDK (in whole or in part) to develop or assist in the development of any product or service that competes with Licensor’s SaaS Service or any other product or service offered by Licensor. Additionally, Licensee shall not use the SDK to replicate or replace the core functionality of the SaaS Service.
+
+## 4. Intellectual Property Rights
+
+4.1 **Reservation of Rights**
+
+All rights not expressly granted in this Agreement are reserved by Licensor. Licensor retains all right, title, and interest, including all intellectual property rights, in and to the SDK, the SaaS Service, the API, and any associated documentation or materials.
+
+4.2 **Feedback**
+
+If Licensee provides any suggestions, feedback, or comments regarding the SDK or the SaaS Service (collectively, “**Feedback**”), Licensor shall be free to use, disclose, reproduce, license, or otherwise distribute and exploit the Feedback without any obligation or restriction, provided that such Feedback does not include Licensee’s Confidential Information.
+
+## 5. Confidentiality
+
+5.1 **Obligation**
+
+Licensee shall maintain the Confidential Information in strict confidence and shall use the same standard of care used to protect its own confidential or proprietary information of a similar nature, but not less than a reasonable standard of care, to prevent unauthorized access to or disclosure of the Confidential Information.
+
+5.2 **Exceptions**
+
+Licensee’s obligations under Section 5.1 do not apply to information that:
+
+- Is already known to Licensee without obligation of confidentiality.
+- Becomes publicly available without Licensee’s breach of any obligation owed to Licensor.
+- Is rightfully received from a third party without breach of any obligation owed to Licensor.
+- Is independently developed by Licensee without use of or reference to the Confidential Information.
+
+## 6. Term and Termination
+
+6.1 **Term**
+
+This Agreement is effective as of the Effective Date and will continue until terminated as provided herein.
+
+6.2 **Termination by Licensor**
+
+Licensor may terminate this Agreement immediately if Licensee breaches any provision of this Agreement and fails to cure such breach within ten (10) days after receiving written notice.
+
+6.3 **Effect of Termination**
+
+Upon termination of this Agreement for any reason:
+
+- All licenses granted hereunder shall immediately terminate, and Licensee shall cease using the SDK.
+- Licensee shall return or destroy (at Licensor’s option) all copies of the SDK, including any Confidential Information.
+- Sections 3, 4, 5, 7, 8, and 9 shall survive termination.
+
+## 7. Disclaimer of Warranties
+
+TO THE MAXIMUM EXTENT PERMITTED BY APPLICABLE LAW, THE SDK IS PROVIDED “AS IS” AND “AS AVAILABLE,” WITH ALL FAULTS AND WITHOUT WARRANTY OF ANY KIND. LICENSOR EXPRESSLY DISCLAIMS ALL WARRANTIES, WHETHER EXPRESS, IMPLIED, OR STATUTORY, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, AND NON-INFRINGEMENT. LICENSOR DOES NOT WARRANT THAT THE SDK OR THE SAAS SERVICE WILL MEET LICENSEE’S REQUIREMENTS, THAT THE OPERATION OF THE SDK OR THE SAAS SERVICE WILL BE UNINTERRUPTED OR ERROR-FREE, OR THAT DEFECTS IN THE SDK CAN OR WILL BE CORRECTED.
+
+## 8. Limitation of Liability
+
+TO THE MAXIMUM EXTENT PERMITTED BY APPLICABLE LAW, IN NO EVENT SHALL LICENSOR BE LIABLE FOR ANY INDIRECT, INCIDENTAL, SPECIAL, CONSEQUENTIAL, OR EXEMPLARY DAMAGES (INCLUDING, BUT NOT LIMITED TO, DAMAGES FOR LOSS OF PROFITS, GOODWILL, OR DATA) ARISING OUT OF OR IN CONNECTION WITH THIS AGREEMENT, EVEN IF LICENSOR HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. IN NO EVENT SHALL LICENSOR’S TOTAL CUMULATIVE LIABILITY FOR ALL CLAIMS ARISING FROM OR RELATING TO THIS AGREEMENT EXCEED THE GREATER OF (A) ONE HUNDRED U.S. DOLLARS ($100), OR (B) THE AMOUNT ACTUALLY PAID BY LICENSEE TO LICENSOR UNDER THIS AGREEMENT IN THE SIX (6) MONTH PERIOD PRECEDING THE CLAIM.
+
+## 9. General Provisions
+
+9.1 **Governing Law**
+
+This Agreement shall be governed by and construed in accordance with the laws of France, without regard to its conflict-of-laws principles. Any dispute arising out of or relating to this Agreement shall be brought exclusively in the courts of France, and the parties hereby consent to the personal jurisdiction and venue therein.
+
+9.2 **Entire Agreement**
+
+This Agreement constitutes the entire agreement between the parties with respect to the subject matter hereof and supersedes all prior understandings and agreements, whether written or oral, regarding such subject matter.
+
+9.3 **Amendment**
+
+No amendment, modification, or supplement to this Agreement shall be binding unless it is in writing and signed by both parties.
+
+9.4 **Assignment**
+
+Licensee may not assign or transfer this Agreement, in whole or in part, without Licensor’s prior written consent. Any attempt to assign or transfer in violation of this Section shall be null and void.
+
+9.5 **Severability**
+
+If any provision of this Agreement is held to be invalid or unenforceable, that provision shall be deemed modified to the least extent necessary to make it valid or enforceable, and the remaining provisions of this Agreement shall remain in full force and effect.
+
+9.6 **Waiver**
+
+No waiver of any provision of this Agreement shall be effective unless it is in writing and signed by the party granting the waiver. The failure of Licensor to enforce any provision of this Agreement shall not be construed as a waiver of such provision or any other provision hereof.
+
+9.7 **Independent Contractors**
+
+The parties are independent contractors. Nothing in this Agreement shall be construed to create a partnership, joint venture, agency, or any other relationship between the parties.
+
+9.8 **Notices**
+
+All notices under this Agreement shall be in writing and sent to the addresses designated by the parties from time to time.
+
+---
+
+**By downloading, installing, accessing, or otherwise using the SDK, Licensee acknowledges that it has read this Agreement, understands it, and agrees to be bound by its terms.**

package/OctopusReactNativeSdk.podspec

@@ -0,0 +1,33 @@
+require "json"
+
+package = JSON.parse(File.read(File.join(__dir__, "package.json")))
+octopus_version = '~> 1.5.1'
+
+Pod::Spec.new do |s|
+  s.name         = "OctopusReactNativeSdk"
+  s.version      = package["version"]
+  s.summary      = package["description"]
+  s.homepage     = package["homepage"]
+  s.license      = package["license"]
+  s.authors      = package["author"]
+
+  s.platforms    = { :ios => min_ios_version_supported }
+  s.source       = { :git => "https://github.com/Octopus-Community/octopus-sdk-react-native.git", :tag => "#{s.version}" }
+
+  s.source_files = "ios/**/*.{h,m,mm,swift}"
+
+# Use install_modules_dependencies helper to install the dependencies if React Native version >=0.71.0.
+# See https://github.com/facebook/react-native/blob/febf6b7f33fdb4904669f99d795eba4c0f95d7bf/scripts/cocoapods/new_architecture.rb#L79.
+if respond_to?(:install_modules_dependencies, true)
+  install_modules_dependencies(s)
+else
+  s.dependency "React-Core"
+end
+
+  s.dependency 'OctopusCommunity', octopus_version
+  s.dependency 'OctopusCommunityUI', octopus_version
+  s.dependency 'OctopusCommunityCore', octopus_version
+  s.dependency 'OctopusCommunityRemoteClient', octopus_version
+  s.dependency 'OctopusCommunityGrpcModels', octopus_version
+  s.dependency 'OctopusCommunityDependencyInjection', octopus_version
+end

package/README.md

@@ -0,0 +1,161 @@
+# @octopus-community/react-native
+
+React Native module for the Octopus Community [Android](https://github.com/Octopus-Community/octopus-sdk-android) and [Swift](https://github.com/Octopus-Community/octopus-sdk-swift) SDKs
+
+- [Installation](#installation)
+  - [iOS setup](#ios-setup)
+  - [Compatibility table](#compatibility-table)
+- [Usage](#usage)
+  - [Initialization](#initialization)
+  - [Show the UI](#show-the-ui)
+  - [API docs](./docs/api/README.md)
+  - [Example app](./example)
+- [Troubleshooting](#troubleshooting)
+
+## Installation
+
+```sh
+npm install @octopus-community/react-native
+```
+
+### iOS setup
+
+Make sure to `use_frameworks` in your `Podfile`.
+
+```ruby
+# Podfile
+linkage = :static # or :dynamic
+if linkage != nil
+  Pod::UI.puts "Configuring Pod with #{linkage}ally linked Frameworks".green
+  use_frameworks! :linkage => linkage.to_sym
+end
+```
+
+Due to a bug in XCode 15, you might need to set `ENABLE_USER_SCRIPT_SANDBOXING` to YES and then to NO in order to compile (see [this issue](https://github.com/CocoaPods/CocoaPods/issues/11946#issuecomment-1948423786)).
+
+### Compatibility table
+
+| React Native version(s) | Android | iOS   | Old arch | New arch      | Supporting version(s) |
+|-------------------------| ------- |-------| -------- | ------------- | --------------------- |
+| v0.78+                  | 5.0+    | 14.0+ | ✅       | Interop layer | v1+                   |
+
+* Older React Native versions might be supported but were untested
+* New arch is currently supported with the interoperability layer
+* Other requirements for current version:
+  * Android
+    * Kotlin version 2
+  * iOS
+    * XCode 16.0+
+
+### Expo
+
+An expo plugin will be available shortly.
+
+## Usage
+
+### Initialization
+
+Initialize the SDK with your API key with [`initialize`](./docs/api/functions/initialize.md).
+
+Choose whether your app or Octopus handles user authentification:
+
+#### Octopus-handled authentification
+
+```ts
+import { initialize } from '@octopus-community/react-native';
+
+await initialize({
+  apiKey: 'YOUR_OCTOPUS_API_KEY',
+  connectionMode: { type: 'octopus' }
+});
+```
+
+#### Single Sign-On (SSO)
+
+For SSO mode:
+
+* your app manages user authentication and certain profile fields. You specify which profile fields your app will handle directly
+* you need to provide a token provider function that returns a valid JWT token for the authenticated user.
+  * use the `useUserTokenProvider` hook in React components:
+
+```ts
+import {
+  initialize,
+  addEditUserListener,
+  addLoginRequiredListener,
+  connectUser,
+  disconnectUser,
+  useUserTokenProvider,
+  closeUI,
+} from '@octopus-community/react-native';
+
+// Initialize with SSO mode
+await initialize({
+  apiKey: 'YOUR_OCTOPUS_API_KEY',
+  connectionMode: {
+    type: 'sso',
+    appManagedFields: ['username', 'profilePicture', 'biography']
+  }
+});
+
+// Listen for when authentication is required
+const loginRequiredSubscription = addLoginRequiredListener(() => {
+  // Navigate to your app's login screen
+  console.log('User needs to log in');
+  closeUI();
+});
+
+// Listen for when users want to edit their profile
+const editUserSubscription = addEditUserListener(({ fieldToEdit }) => {
+  // Navigate to your app's profile editing screen
+  // for the specific field (username, profilePicture, etc.)
+  console.log(`User wants to edit: ${fieldToEdit}`);
+  closeUI();
+});
+
+// Set up token provider (in a React component)
+useUserTokenProvider(async () => {
+  const token = await refreshUserToken();
+  return token;
+});
+
+// Connect a user after they log in
+await connectUser({
+  userId: 'unique-user-id',
+  profile: {
+    username: 'john_doe',
+    profilePicture: 'https://example.com/avatar.jpg',
+    biography: 'Software developer',
+    legalAgeReached: true,
+  },
+});
+
+// Disconnect the user when they log out
+await disconnectUser();
+
+// Cleanup listeners when appropriate (eg. in return of a useEffect)
+loginRequiredSubscription.remove();
+editUserSubscription.remove();
+```
+
+### Show the UI
+
+Show the Octopus home screen with the [`openUI()`](./docs/api/functions/openUI.md) method.
+
+Future versions of this React Native module will let you show the UI in your React components. Please reach out if you need this prioritized.
+
+### API docs
+
+For details about the Typescript API, head to the [API docs](./docs/api/README.md).
+
+### Example app
+
+Take a look at our [example app](./example/src/App.tsx).
+
+## Troubleshooting
+
+Any error that might be intercepted by the React Native module will be rejected in the methods you call. If it cannot be intercepted, you may see the underlying SDK's logs in your native logs.
+
+## Contributing
+
+See the [contributing guide](CONTRIBUTING.md) to learn how to contribute to the repository and the development workflow.

package/android/build.gradle

@@ -0,0 +1,92 @@
+buildscript {
+  ext.getExtOrDefault = {name ->
+    return rootProject.ext.has(name) ? rootProject.ext.get(name) : project.properties['OctopusReactNativeSdk_' + name]
+  }
+
+  repositories {
+    google()
+    mavenCentral()
+  }
+
+  dependencies {
+    classpath "com.android.tools.build:gradle:8.7.2"
+    // noinspection DifferentKotlinGradleVersion
+    classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:${getExtOrDefault('kotlinVersion')}"
+    classpath "org.jetbrains.kotlin:compose-compiler-gradle-plugin:${getExtOrDefault('kotlinVersion')}"
+  }
+}
+
+apply plugin: "com.android.library"
+apply plugin: "kotlin-android"
+apply plugin: "org.jetbrains.kotlin.plugin.compose"
+
+def getExtOrIntegerDefault(name) {
+  return rootProject.ext.has(name) ? rootProject.ext.get(name) : (project.properties["OctopusReactNativeSdk_" + name]).toInteger()
+}
+
+def supportsNamespace() {
+  def parsed = com.android.Version.ANDROID_GRADLE_PLUGIN_VERSION.tokenize('.')
+  def major = parsed[0].toInteger()
+  def minor = parsed[1].toInteger()
+
+  // Namespace support was added in 7.3.0
+  return (major == 7 && minor >= 3) || major >= 8
+}
+
+android {
+  if (supportsNamespace()) {
+    namespace "com.octopuscommunity.octopusreactnativesdk"
+
+    sourceSets {
+      main {
+        manifest.srcFile "src/main/AndroidManifestNew.xml"
+      }
+    }
+  }
+
+  compileSdkVersion getExtOrIntegerDefault("compileSdkVersion")
+
+  defaultConfig {
+    minSdkVersion getExtOrIntegerDefault("minSdkVersion")
+    targetSdkVersion getExtOrIntegerDefault("targetSdkVersion")
+  }
+
+  buildTypes {
+    release {
+      minifyEnabled false
+    }
+  }
+
+  lintOptions {
+    disable "GradleCompatible"
+  }
+
+  buildFeatures {
+    compose true
+  }
+
+  compileOptions {
+    sourceCompatibility JavaVersion.VERSION_1_8
+    targetCompatibility JavaVersion.VERSION_1_8
+  }
+}
+
+repositories {
+  mavenCentral()
+  google()
+}
+
+def kotlin_version = getExtOrDefault("kotlinVersion")
+def octopus_community_version = getExtOrDefault("octopusCommunityVersion")
+def compose_bom_version = getExtOrDefault("composeBomVersion")
+def android_x_navigation_version = getExtOrDefault("androidXNavigationVersion")
+
+dependencies {
+  implementation "com.facebook.react:react-android"
+  implementation "org.jetbrains.kotlin:kotlin-stdlib:$kotlin_version"
+  implementation platform("androidx.compose:compose-bom:$compose_bom_version")
+  implementation "androidx.navigation:navigation-compose:$android_x_navigation_version"
+
+  api "com.octopuscommunity:octopus-sdk:$octopus_community_version"
+  api "com.octopuscommunity:octopus-sdk-ui:$octopus_community_version"
+}

package/android/gradle.properties

@@ -0,0 +1,9 @@
+OctopusReactNativeSdk_kotlinVersion=2.1.10
+OctopusReactNativeSdk_minSdkVersion=24
+OctopusReactNativeSdk_targetSdkVersion=34
+OctopusReactNativeSdk_compileSdkVersion=35
+OctopusReactNativeSdk_ndkVersion=27.1.12297006
+OctopusReactNativeSdk_composeBomVersion=2025.06.01
+OctopusReactNativeSdk_androidXNavigationVersion=2.9.0
+
+OctopusReactNativeSdk_octopusCommunityVersion=1.5.0

package/android/src/main/AndroidManifest.xml

@@ -0,0 +1,9 @@
+<manifest xmlns:android="http://schemas.android.com/apk/res/android"
+          package="com.octopuscommunity.octopusreactnativesdk">
+  <application>
+    <activity
+      android:name=".OctopusUIActivity"
+      android:exported="false"
+      android:theme="@style/Theme.AppCompat.DayNight.NoActionBar"/>
+  </application>
+</manifest>

package/android/src/main/AndroidManifestNew.xml

@@ -0,0 +1,8 @@
+<manifest xmlns:android="http://schemas.android.com/apk/res/android">
+  <application>
+    <activity
+      android:name=".OctopusUIActivity"
+      android:exported="false"
+      android:theme="@style/Theme.AppCompat.DayNight.NoActionBar"/>
+  </application>
+</manifest>

package/android/src/main/java/com/octopuscommunity/octopusreactnativesdk/OctopusEventEmitter.kt

@@ -0,0 +1,48 @@
+package com.octopuscommunity.octopusreactnativesdk
+
+import com.facebook.react.bridge.Arguments
+import com.facebook.react.bridge.ReactContext
+import com.facebook.react.bridge.WritableMap
+import com.facebook.react.modules.core.DeviceEventManagerModule
+import com.octopuscommunity.sdk.domain.model.ProfileField
+
+class OctopusEventEmitter(private val reactContext: ReactContext) {
+
+  private var listenerCount = 0
+
+  fun addListener(eventName: String) {
+    listenerCount += 1
+  }
+
+  fun removeListeners(count: Int) {
+    listenerCount -= count
+  }
+
+  fun emitLoginRequired() {
+    sendEvent("loginRequired", null)
+  }
+
+  fun emitEditUser(profileField: ProfileField?) {
+    val params = Arguments.createMap()
+    params.putString("fieldToEdit", ProfileFieldMapper.toReactNativeString(profileField))
+    sendEvent("editUser", params)
+  }
+
+  fun emitUserTokenRequest(requestId: String) {
+    val params = Arguments.createMap()
+    params.putString("requestId", requestId)
+    sendEvent("userTokenRequest", params)
+  }
+
+  private fun sendEvent(eventName: String, params: WritableMap?) {
+    if (listenerCount > 0) {
+      reactContext
+        .getJSModule(DeviceEventManagerModule.RCTDeviceEventEmitter::class.java)
+        .emit(eventName, params)
+    }
+  }
+
+  companion object {
+    var instance: OctopusEventEmitter? = null
+  }
+}

package/android/src/main/java/com/octopuscommunity/octopusreactnativesdk/OctopusReactNativeSdkModule.kt

@@ -0,0 +1,73 @@
+package com.octopuscommunity.octopusreactnativesdk
+
+import com.facebook.react.bridge.ReactApplicationContext
+import com.facebook.react.bridge.ReactContextBaseJavaModule
+import com.facebook.react.bridge.ReactMethod
+import com.facebook.react.bridge.Promise
+import com.facebook.react.bridge.ReadableMap
+
+class OctopusReactNativeSdkModule(reactContext: ReactApplicationContext) :
+  ReactContextBaseJavaModule(reactContext) {
+
+  private val sdkInitializer = OctopusSDKInitializer()
+  private val eventEmitter = OctopusEventEmitter(reactContext)
+  private val uiController = OctopusUIController(reactContext)
+  private val ssoAuthenticator = OctopusSSOAuthenticator(eventEmitter)
+
+  override fun getName(): String = NAME
+
+  @ReactMethod
+  fun initialize(options: ReadableMap, promise: Promise) {
+    sdkInitializer.initialize(reactApplicationContext, options, promise)
+  }
+
+  @ReactMethod
+  fun openUI(promise: Promise) {
+    uiController.openUI(promise)
+  }
+
+  @ReactMethod
+  fun closeUI(promise: Promise) {
+    uiController.closeUI(promise)
+  }
+
+  @ReactMethod
+  fun connectUser(params: ReadableMap, promise: Promise) {
+    ssoAuthenticator.connectUser(params, promise)
+  }
+
+  @ReactMethod
+  fun disconnectUser(promise: Promise) {
+    ssoAuthenticator.disconnectUser(promise)
+  }
+
+  @ReactMethod
+  fun completeUserTokenRequest(requestId: String, token: String, promise: Promise) {
+    ssoAuthenticator.completeTokenRequest(requestId, token)
+    promise.resolve(null)
+  }
+
+  @ReactMethod
+  fun cancelUserTokenRequest(requestId: String, promise: Promise) {
+    ssoAuthenticator.cancelTokenRequest(requestId)
+    promise.resolve(null)
+  }
+
+  @ReactMethod
+  fun addListener(eventName: String) {
+    eventEmitter.addListener(eventName)
+  }
+
+  @ReactMethod
+  fun removeListeners(count: Int) {
+    eventEmitter.removeListeners(count)
+  }
+
+  companion object {
+    const val NAME = "OctopusReactNativeSdk"
+  }
+
+  init {
+    OctopusEventEmitter.instance = eventEmitter
+  }
+}

package/android/src/main/java/com/octopuscommunity/octopusreactnativesdk/OctopusReactNativeSdkPackage.kt

@@ -0,0 +1,17 @@
+package com.octopuscommunity.octopusreactnativesdk
+
+import com.facebook.react.ReactPackage
+import com.facebook.react.bridge.NativeModule
+import com.facebook.react.bridge.ReactApplicationContext
+import com.facebook.react.uimanager.ViewManager
+
+
+class OctopusReactNativeSdkPackage : ReactPackage {
+  override fun createNativeModules(reactContext: ReactApplicationContext): List<NativeModule> {
+    return listOf(OctopusReactNativeSdkModule(reactContext))
+  }
+
+  override fun createViewManagers(reactContext: ReactApplicationContext): List<ViewManager<*, *>> {
+    return emptyList()
+  }
+}

package/android/src/main/java/com/octopuscommunity/octopusreactnativesdk/OctopusSDKInitializer.kt

@@ -0,0 +1,55 @@
+package com.octopuscommunity.octopusreactnativesdk
+
+import com.facebook.react.bridge.Promise
+import com.facebook.react.bridge.ReactApplicationContext
+import com.facebook.react.bridge.ReadableMap
+import com.octopuscommunity.sdk.OctopusSDK
+import com.octopuscommunity.sdk.domain.model.ConnectionMode
+
+class OctopusSDKInitializer {
+
+  fun initialize(context: ReactApplicationContext, options: ReadableMap, promise: Promise) {
+    val apiKey = options.getString("apiKey")
+    if (apiKey == null) {
+      promise.reject("INITIALIZE_ERROR", "Missing API key")
+      return
+    }
+
+    try {
+      val connectionMode = parseConnectionMode(options)
+      OctopusSDK.initialize(
+        context = context,
+        apiKey = apiKey,
+        connectionMode = connectionMode
+      )
+      promise.resolve(null)
+    } catch (e: InvalidConnectionModeException) {
+      promise.reject("INITIALIZE_ERROR", e.message, e)
+    } catch (e: Exception) {
+      promise.reject("INITIALIZE_ERROR", "Failed to initialize Octopus SDK", e)
+    }
+  }
+
+  private fun parseConnectionMode(options: ReadableMap): ConnectionMode {
+    val connectionModeMap = options.getMap("connectionMode")
+    return when (val connectionModeType = connectionModeMap?.getString("type")) {
+      "sso" -> {
+        ConnectionMode.SSO(
+          appManagedFields = ProfileFieldMapper.fromReactNativeArray(
+            connectionModeMap.getArray("appManagedFields")
+          )
+        )
+      }
+
+      "octopus" -> {
+        ConnectionMode.Octopus
+      }
+
+      else -> {
+        throw InvalidConnectionModeException("Invalid connection mode type: $connectionModeType")
+      }
+    }
+  }
+
+  private class InvalidConnectionModeException(message: String) : Exception(message)
+}