@saltware/fidbek-react-native 0.1.0

package/README.md

@@ -0,0 +1,181 @@
+# @saltware/fidbek-react-native
+
+Fidbek SDK bridge for React Native with TurboModule (New Architecture / JSI).
+
+## Features
+
+- React Native CLI support
+- Expo support (development builds via `expo prebuild` / `expo run`)
+- New Architecture only (TurboModule/JSI)
+- API parity with native and Flutter wrappers:
+  - `configure({ token, shakeToOpenEnabled })`
+  - `open()`
+  - `shutdown()`
+
+## Install
+
+```bash
+npm install @saltware/fidbek-react-native
+# or
+yarn add @saltware/fidbek-react-native
+```
+
+## Local Development (Package Path)
+
+If your app uses a local package path (for example `file:../fidbek-react-native`), keep the import as:
+
+```ts
+import Fidbek from '@saltware/fidbek-react-native';
+```
+
+Do not import by file-system path in app code.
+
+### React Native CLI local setup
+
+1. Install from local path in your app `package.json`:
+
+```json
+{
+  "dependencies": {
+    "@saltware/fidbek-react-native": "file:../fidbek-react-native"
+  }
+}
+```
+
+2. Add Metro config (`metro.config.js`) so symlinked package resolution works:
+
+```js
+const path = require('path');
+const {getDefaultConfig, mergeConfig} = require('@react-native/metro-config');
+
+const projectRoot = __dirname;
+const packageRoot = path.resolve(projectRoot, '../fidbek-react-native');
+
+const config = {
+  watchFolders: [packageRoot],
+  resolver: {
+    unstable_enableSymlinks: true,
+    nodeModulesPaths: [path.resolve(projectRoot, 'node_modules')],
+    extraNodeModules: {
+      '@saltware/fidbek-react-native': packageRoot,
+    },
+  },
+};
+
+module.exports = mergeConfig(getDefaultConfig(projectRoot), config);
+```
+
+3. If iOS build fails on `[CP] Embed Pods Frameworks` with symlink/codesign errors, patch your `ios/Podfile` `post_install` to replace `--links` with `--copy-links` in `Pods-<App>-frameworks.sh`:
+
+```rb
+post_install do |installer|
+  react_native_post_install(installer, config[:reactNativePath], :mac_catalyst_enabled => false)
+
+  frameworks_script_path = File.join(
+    installer.sandbox.root,
+    'Target Support Files',
+    'Pods-YourAppName',
+    'Pods-YourAppName-frameworks.sh'
+  )
+
+  if File.exist?(frameworks_script_path)
+    content = File.read(frameworks_script_path)
+    patched = content.gsub('--links --filter "- CVS/"', '--copy-links --filter "- CVS/"')
+    File.write(frameworks_script_path, patched) if patched != content
+  end
+end
+```
+
+### Expo local setup
+
+1. Install from local path in your Expo app:
+
+```json
+{
+  "dependencies": {
+    "@saltware/fidbek-react-native": "file:../fidbek-react-native"
+  }
+}
+```
+
+2. Add Metro config (`metro.config.js`) for local package resolution:
+
+```js
+const path = require('path');
+const { getDefaultConfig } = require('expo/metro-config');
+
+const projectRoot = __dirname;
+const packageRoot = path.resolve(projectRoot, '../fidbek-react-native');
+
+const config = getDefaultConfig(projectRoot);
+
+config.watchFolders = [packageRoot];
+config.resolver.unstable_enableSymlinks = true;
+config.resolver.nodeModulesPaths = [path.resolve(projectRoot, 'node_modules')];
+config.resolver.extraNodeModules = {
+  ...(config.resolver.extraNodeModules || {}),
+  '@saltware/fidbek-react-native': packageRoot,
+};
+
+module.exports = config;
+```
+
+## Architecture Support
+
+- Supported: React Native New Architecture (`newArchEnabled=true`)
+- Not supported: Old Architecture (legacy bridge)
+
+## React Native CLI
+
+### iOS
+
+```bash
+cd ios && pod install
+```
+
+### Android
+
+No manual step is required after autolinking.
+
+## Expo
+
+This package contains custom native code. Use an Expo development build:
+
+```bash
+npx expo prebuild
+npx expo run:ios
+npx expo run:android
+```
+
+`Expo Go` is not supported because the module includes native binaries.
+
+Optional `app.json` plugin entry:
+
+```json
+{
+  "expo": {
+    "plugins": ["@saltware/fidbek-react-native"]
+  }
+}
+```
+
+## Usage
+
+```ts
+import Fidbek from '@saltware/fidbek-react-native';
+
+await Fidbek.configure({
+  token: 'YOUR_PUBLIC_TOKEN',
+  shakeToOpenEnabled: true,
+});
+
+await Fidbek.open();
+
+await Fidbek.shutdown();
+```
+
+## Requirements
+
+- iOS 13+
+- Android minSdk 24+
+- React Native 0.75+ with New Architecture enabled

package/android/build.gradle

@@ -0,0 +1,75 @@
+buildscript {
+  ext.kotlin_version = "1.9.24"
+  repositories {
+    google()
+    mavenCentral()
+  }
+
+  dependencies {
+    classpath "com.android.tools.build:gradle:8.5.2"
+    classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:$kotlin_version"
+  }
+}
+
+def safeExtGet(prop, fallback) {
+  rootProject.ext.has(prop) ? rootProject.ext.get(prop) : fallback
+}
+
+def isNewArchitectureEnabled() {
+  return project.hasProperty("newArchEnabled") && project.newArchEnabled == "true"
+}
+
+if (!isNewArchitectureEnabled()) {
+  throw new GradleException(
+    "@saltware/fidbek-react-native requires React Native New Architecture. " +
+      "Set newArchEnabled=true in android/gradle.properties."
+  )
+}
+
+apply plugin: "com.android.library"
+apply plugin: "kotlin-android"
+apply plugin: "com.facebook.react"
+
+android {
+  namespace "com.fidbek.reactnative"
+  compileSdkVersion safeExtGet("compileSdkVersion", 34)
+
+  defaultConfig {
+    minSdkVersion safeExtGet("minSdkVersion", 24)
+  }
+
+  sourceSets {
+    main {
+      java.srcDirs += ["src/main/java", "src/newarch"]
+    }
+  }
+
+  compileOptions {
+    sourceCompatibility JavaVersion.VERSION_17
+    targetCompatibility JavaVersion.VERSION_17
+  }
+
+  kotlinOptions {
+    jvmTarget = "17"
+  }
+}
+
+repositories {
+  google()
+  mavenCentral()
+}
+
+dependencies {
+  implementation files("libs/fidbek-android.aar")
+  implementation "com.facebook.react:react-android"
+  implementation "androidx.core:core-ktx:1.13.1"
+  implementation "androidx.appcompat:appcompat:1.7.0"
+  implementation "com.google.android.material:material:1.12.0"
+  implementation "com.squareup.okhttp3:okhttp:4.12.0"
+}
+
+react {
+  jsRootDir = file("../")
+  libraryName = "FidbekReactNative"
+  codegenJavaPackageName = "com.fidbek.reactnative"
+}

package/android/src/main/AndroidManifest.xml

@@ -0,0 +1 @@
+<manifest xmlns:android="http://schemas.android.com/apk/res/android" />

package/android/src/main/java/com/fidbek/reactnative/FidbekBridge.kt

@@ -0,0 +1,39 @@
+package com.fidbek.reactnative
+
+import android.app.Application
+import com.facebook.react.bridge.Promise
+import com.facebook.react.bridge.ReactApplicationContext
+import com.fidbek.sdk.Fidbek
+
+internal object FidbekBridge {
+    fun configure(
+        reactContext: ReactApplicationContext,
+        token: String,
+        shakeToOpenEnabled: Boolean,
+        promise: Promise
+    ) {
+        if (token.isBlank()) {
+            promise.reject("ERR_INVALID_ARGUMENT", "token is required")
+            return
+        }
+
+        val application = reactContext.applicationContext as? Application
+        if (application == null) {
+            promise.reject("ERR_NO_APPLICATION", "Application context is unavailable")
+            return
+        }
+
+        Fidbek.initialize(application, token, shakeToOpenEnabled)
+        promise.resolve(null)
+    }
+
+    fun open(promise: Promise) {
+        Fidbek.open()
+        promise.resolve(null)
+    }
+
+    fun shutdown(promise: Promise) {
+        Fidbek.shutdown()
+        promise.resolve(null)
+    }
+}

package/android/src/newarch/com/fidbek/reactnative/FidbekReactNativeModule.kt

@@ -0,0 +1,28 @@
+package com.fidbek.reactnative
+
+import com.facebook.react.bridge.Promise
+import com.facebook.react.bridge.ReactApplicationContext
+import com.facebook.react.module.annotations.ReactModule
+
+@ReactModule(name = FidbekReactNativeModule.NAME)
+class FidbekReactNativeModule(
+    private val reactContext: ReactApplicationContext
+) : NativeFidbekReactNativeSpec(reactContext) {
+    override fun getName(): String = NAME
+
+    override fun configure(token: String, shakeToOpenEnabled: Boolean, promise: Promise) {
+        FidbekBridge.configure(reactContext, token, shakeToOpenEnabled, promise)
+    }
+
+    override fun open(promise: Promise) {
+        FidbekBridge.open(promise)
+    }
+
+    override fun shutdown(promise: Promise) {
+        FidbekBridge.shutdown(promise)
+    }
+
+    companion object {
+        const val NAME = "FidbekReactNative"
+    }
+}

package/android/src/newarch/com/fidbek/reactnative/FidbekReactNativePackage.kt

@@ -0,0 +1,82 @@
+package com.fidbek.reactnative
+
+import com.facebook.react.TurboReactPackage
+import com.facebook.react.bridge.NativeModule
+import com.facebook.react.bridge.ReactApplicationContext
+import com.facebook.react.module.model.ReactModuleInfo
+import com.facebook.react.module.model.ReactModuleInfoProvider
+
+class FidbekReactNativePackage : TurboReactPackage() {
+    override fun getModule(name: String, reactContext: ReactApplicationContext): NativeModule? {
+        return if (name == FidbekReactNativeModule.NAME) {
+            FidbekReactNativeModule(reactContext)
+        } else {
+            null
+        }
+    }
+
+    override fun getReactModuleInfoProvider(): ReactModuleInfoProvider {
+        return ReactModuleInfoProvider {
+            val moduleInfos = HashMap<String, ReactModuleInfo>()
+            moduleInfos[FidbekReactNativeModule.NAME] = createReactModuleInfo(
+                name = FidbekReactNativeModule.NAME,
+                className = FidbekReactNativeModule::class.java.name,
+                canOverrideExistingModule = false,
+                needsEagerInit = false,
+                hasConstants = false,
+                isCxxModule = false,
+                isTurboModule = true
+            )
+            moduleInfos
+        }
+    }
+
+    private fun createReactModuleInfo(
+        name: String,
+        className: String,
+        canOverrideExistingModule: Boolean,
+        needsEagerInit: Boolean,
+        hasConstants: Boolean,
+        isCxxModule: Boolean,
+        isTurboModule: Boolean
+    ): ReactModuleInfo {
+        return try {
+            val constructor = ReactModuleInfo::class.java.getDeclaredConstructor(
+                String::class.java,
+                String::class.java,
+                Boolean::class.javaPrimitiveType,
+                Boolean::class.javaPrimitiveType,
+                Boolean::class.javaPrimitiveType,
+                Boolean::class.javaPrimitiveType,
+                Boolean::class.javaPrimitiveType
+            )
+            constructor.newInstance(
+                name,
+                className,
+                canOverrideExistingModule,
+                needsEagerInit,
+                hasConstants,
+                isCxxModule,
+                isTurboModule
+            )
+        } catch (_: NoSuchMethodException) {
+            val constructor = ReactModuleInfo::class.java.getDeclaredConstructor(
+                String::class.java,
+                String::class.java,
+                Boolean::class.javaPrimitiveType,
+                Boolean::class.javaPrimitiveType,
+                Boolean::class.javaPrimitiveType,
+                Boolean::class.javaPrimitiveType
+            )
+            @Suppress("DEPRECATION")
+            constructor.newInstance(
+                name,
+                className,
+                canOverrideExistingModule,
+                needsEagerInit,
+                isCxxModule,
+                isTurboModule
+            )
+        }
+    }
+}

package/app.plugin.js

@@ -0,0 +1,5 @@
+function withFidbek(config) {
+  return config;
+}
+
+module.exports = withFidbek;

package/fidbek-react-native.podspec

@@ -0,0 +1,30 @@
+require "json"
+
+package = JSON.parse(File.read(File.join(__dir__, "package.json")))
+
+Pod::Spec.new do |s|
+  s.name         = "fidbek-react-native"
+  s.version      = package["version"]
+  s.summary      = package["description"]
+  s.homepage     = package["homepage"]
+  s.license      = "UNLICENSED"
+  s.authors      = { "Fidbek" => "support@fidbek.com" }
+  s.source       = { :git => package.dig("repository", "url"), :tag => s.version }
+
+  s.platforms    = { :ios => "13.0" }
+  s.swift_version = "5.9"
+  s.static_framework = true
+
+  s.source_files = "ios/**/*.{h,m,mm,swift}"
+  s.vendored_frameworks = "ios/FidbekSDK.xcframework"
+
+  if respond_to?(:install_modules_dependencies, true)
+    install_modules_dependencies(s)
+  else
+    s.dependency "React-Core"
+  end
+
+  s.pod_target_xcconfig = {
+    "DEFINES_MODULE" => "YES"
+  }
+end

package/ios/FidbekReactNative.h

@@ -0,0 +1,10 @@
+#import <React/RCTBridgeModule.h>
+
+#ifdef RCT_NEW_ARCH_ENABLED
+#import "RNFidbekReactNativeSpec.h"
+@interface FidbekReactNative : NSObject <NativeFidbekReactNativeSpec>
+#else
+@interface FidbekReactNative : NSObject <RCTBridgeModule>
+#endif
+
+@end

package/ios/FidbekReactNative.mm

@@ -0,0 +1,57 @@
+#import "FidbekReactNative.h"
+#import <memory>
+
+#if __has_include(<fidbek_react_native/fidbek_react_native-Swift.h>)
+#import <fidbek_react_native/fidbek_react_native-Swift.h>
+#else
+#import "fidbek_react_native-Swift.h"
+#endif
+
+#ifndef RCT_NEW_ARCH_ENABLED
+#error "@saltware/fidbek-react-native requires React Native New Architecture (TurboModules)."
+#endif
+
+@implementation FidbekReactNative
+
+RCT_EXPORT_MODULE()
+
++ (BOOL)requiresMainQueueSetup
+{
+  return NO;
+}
+
+RCT_EXPORT_METHOD(configure:(NSString *)token
+                  shakeToOpenEnabled:(BOOL)shakeToOpenEnabled
+                  resolve:(RCTPromiseResolveBlock)resolve
+                  reject:(RCTPromiseRejectBlock)reject)
+{
+  if (token == nil || token.length == 0) {
+    reject(@"ERR_INVALID_ARGUMENT", @"token is required", nil);
+    return;
+  }
+
+  [FidbekReactNativeBridge configureWithToken:token shakeToOpenEnabled:shakeToOpenEnabled];
+  resolve(nil);
+}
+
+RCT_EXPORT_METHOD(open:(RCTPromiseResolveBlock)resolve
+                  reject:(RCTPromiseRejectBlock)reject)
+{
+  [FidbekReactNativeBridge presentWidget];
+  resolve(nil);
+}
+
+RCT_EXPORT_METHOD(shutdown:(RCTPromiseResolveBlock)resolve
+                  reject:(RCTPromiseRejectBlock)reject)
+{
+  [FidbekReactNativeBridge stopWidget];
+  resolve(nil);
+}
+
+- (std::shared_ptr<facebook::react::TurboModule>)getTurboModule:
+    (const facebook::react::ObjCTurboModule::InitParams &)params
+{
+  return std::make_shared<facebook::react::NativeFidbekReactNativeSpecJSI>(params);
+}
+
+@end

package/ios/FidbekReactNativeBridge.swift

@@ -0,0 +1,20 @@
+import Foundation
+import FidbekSDK
+
+@objc(FidbekReactNativeBridge)
+public final class FidbekReactNativeBridge: NSObject {
+  @objc
+  public static func configure(token: String, shakeToOpenEnabled: Bool) {
+    Fidbek.shared.configure(token: token, shakeToOpenEnabled: shakeToOpenEnabled)
+  }
+
+  @objc
+  public static func presentWidget() {
+    Fidbek.shared.present()
+  }
+
+  @objc
+  public static func stopWidget() {
+    Fidbek.shared.stop()
+  }
+}

package/ios/FidbekSDK.xcframework/Info.plist

@@ -0,0 +1,44 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+	<key>AvailableLibraries</key>
+	<array>
+		<dict>
+			<key>BinaryPath</key>
+			<string>FidbekSDK.framework/FidbekSDK</string>
+			<key>LibraryIdentifier</key>
+			<string>ios-arm64</string>
+			<key>LibraryPath</key>
+			<string>FidbekSDK.framework</string>
+			<key>SupportedArchitectures</key>
+			<array>
+				<string>arm64</string>
+			</array>
+			<key>SupportedPlatform</key>
+			<string>ios</string>
+		</dict>
+		<dict>
+			<key>BinaryPath</key>
+			<string>FidbekSDK.framework/FidbekSDK</string>
+			<key>LibraryIdentifier</key>
+			<string>ios-arm64_x86_64-simulator</string>
+			<key>LibraryPath</key>
+			<string>FidbekSDK.framework</string>
+			<key>SupportedArchitectures</key>
+			<array>
+				<string>arm64</string>
+				<string>x86_64</string>
+			</array>
+			<key>SupportedPlatform</key>
+			<string>ios</string>
+			<key>SupportedPlatformVariant</key>
+			<string>simulator</string>
+		</dict>
+	</array>
+	<key>CFBundlePackageType</key>
+	<string>XFWK</string>
+	<key>XCFrameworkFormatVersion</key>
+	<string>1.0</string>
+</dict>
+</plist>