@mindrove/mindrovesdk

Standalone React Native package for integrating MindRove native libraries into React Native applications.

Current scope

• BoardController-first JavaScript API.
• React Native wrapper contract aligned with the existing nodejs_package BoardShim semantics.
• Package-local unit tests and CI entry points.
• Android and iOS native packaging scaffolding will live in this folder.

Current status

This package now contains the JavaScript contract, tests, and packaging skeleton. The native bridge currently focuses on project structure and API shape so the repository can add Android and iOS build jobs without coupling them to the desktop packages.

Commands

npm install
npm run validate:native
npm run lint
npm run typecheck
npm test
npm run build:android:native
npm run build:android
npm run build:ios:native
npm run build:ios
npm pack

API goals

• BoardShim mirrors the session lifecycle from the existing native packages.
• MindRoveInputParams preserves the JSON contract expected by BoardController.
• The native module interface is designed so the real BoardController C API can be wired in behind the current wrapper without changing the JavaScript call surface.
• Android packaging produces an AAR from the local android/ project.
• iOS validation runs through CocoaPods and packages the pod sources from this folder.

Native packaging notes

• Android packaging is self-contained under react_native_package/android.
• iOS packaging is driven by MindroveBoardController.podspec and scripts/build-ios-package.sh.
• Android now calls the exported BoardController C API through JNA and expects staged .so files in android/src/main/jniLibs.
• iOS now resolves BoardController symbols dynamically when the native library is linked into the host app or packaged framework.

Local native prerequisites

• Android native staging requires ANDROID_NDK_ROOT or ANDROID_NDK_HOME and bash.
• Android AAR assembly requires Gradle, either as a global gradle installation or a wrapper under react_native_package/android.
• npm run build:android will stage native libraries automatically when the Android NDK is configured.
• iOS native staging requires both cmake and xcodebuild.
• npm run build:ios:native builds device and simulator slices and creates ios/MindroveBoardController.xcframework.
• npm run build:ios will build the XCFramework automatically when Xcode and CMake are available, unless MINDROVE_SKIP_IOS_NATIVE_BUILD=1 is set.