@revrag-ai/embed-react-native 1.0.5

package/LICENSE

@@ -0,0 +1,20 @@
+MIT License
+
+Copyright (c) 2025 revragai
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/Onwid.podspec

@@ -0,0 +1,20 @@
+require "json"
+
+package = JSON.parse(File.read(File.join(__dir__, "package.json")))
+
+Pod::Spec.new do |s|
+  s.name         = "Onwid"
+  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/RevRag-ai.git", :tag => "#{s.version}" }
+
+  s.source_files = "ios/**/*.{h,m,mm,cpp}"
+  s.private_header_files = "ios/**/*.h"
+
+ install_modules_dependencies(s)
+end

package/README.md

@@ -0,0 +1,402 @@
+# @revrag-ai/embed-react-native
+
+[![npm version](https://badge.fury.io/js/%40revrag-ai%2Fembed-react-native.svg)](https://badge.fury.io/js/%40revrag-ai%2Fembed-react-native)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+A powerful Voice Agent SDK for React Native that enables AI-powered voice communication with real-time speech processing. Built with LiveKit for seamless voice interactions.
+
+## 🚀 Features
+
+- **Real-time Voice Communication**: High-quality voice chat powered by LiveKit
+- **AI Voice Agent Integration**: Seamless integration with AI voice assistants
+- **Cross-platform Support**: Works on both iOS and Android
+- **TypeScript Support**: Full TypeScript definitions included
+- **Event-driven Architecture**: Flexible event system for custom integrations
+- **Secure API Communication**: Protected API calls with automatic initialization
+- **Easy Integration**: Simple hooks and components for quick setup
+
+## 📦 Installation
+
+```bash
+npm install @revrag-ai/embed-react-native
+# or
+yarn add @revrag-ai/embed-react-native
+```
+
+### Peer Dependencies
+
+Make sure you have the following peer dependencies installed:
+
+```bash
+npm install @livekit/react-native @livekit/react-native-webrtc @react-native-async-storage/async-storage lottie-react-native react-native-gesture-handler react-native-linear-gradient react-native-reanimated react-native-safe-area-context
+```
+
+### Important: React Native Reanimated Setup
+
+**This library requires `react-native-reanimated` to be properly installed and configured.** If you encounter errors like "Cannot read property 'makeMutable' of undefined", follow these steps:
+
+1. **Install react-native-reanimated:**
+   ```bash
+   npm install react-native-reanimated
+   # or
+   yarn add react-native-reanimated
+   ```
+
+2. **Add Reanimated's babel plugin to your `babel.config.js`:**
+   ```javascript
+   module.exports = {
+     presets: ['module:@react-native/babel-preset'],
+     plugins: [
+       'react-native-reanimated/plugin',
+     ],
+   };
+   ```
+
+3. **For iOS:** Run `cd ios && pod install`
+
+4. **For Android:** Add the following to `android/app/src/main/java/.../MainApplication.java`:
+   ```java
+   import com.swmansion.reanimated.ReanimatedPackage;
+   
+   @Override
+   protected List<ReactPackage> getPackages() {
+     return Arrays.<ReactPackage>asList(
+       new MainReactPackage(),
+       new ReanimatedPackage() // Add this line
+     );
+   }
+   ```
+
+5. **Clean and rebuild your project:**
+   ```bash
+   # For React Native CLI
+   npx react-native run-android
+   npx react-native run-ios
+   
+   # For Expo (if using)
+   expo run:android
+   expo run:ios
+   ```
+
+For more detailed instructions, visit: https://docs.swmansion.com/react-native-reanimated/docs/fundamentals/getting-started
+
+### Setup Verification
+
+After installation, you can verify your setup by running:
+
+```bash
+npx @revrag-ai/embed-react-native verify-setup
+```
+
+This will check if all dependencies are properly installed and configured.
+
+## 🛠️ Setup
+
+### iOS Setup
+
+Add the following to your `ios/Podfile`:
+
+```ruby
+pod 'RNFS', :path => '../node_modules/react-native-fs'
+```
+
+### Android Setup
+
+Add the following permissions to your `android/app/src/main/AndroidManifest.xml`:
+
+```xml
+<uses-permission android:name="android.permission.RECORD_AUDIO" />
+<uses-permission android:name="android.permission.INTERNET" />
+<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
+```
+
+## 🔧 Troubleshooting
+
+### "Cannot read property 'makeMutable' of undefined"
+
+This error occurs when `react-native-reanimated` is not properly installed or configured. Follow these steps:
+
+1. **Ensure react-native-reanimated is installed:**
+   ```bash
+   npm list react-native-reanimated
+   ```
+
+2. **Check your babel.config.js includes the reanimated plugin:**
+   ```javascript
+   module.exports = {
+     presets: ['module:@react-native/babel-preset'],
+     plugins: [
+       'react-native-reanimated/plugin', // <- This line is crucial
+     ],
+   };
+   ```
+
+3. **Clear Metro cache and rebuild:**
+   ```bash
+   npx react-native start --reset-cache
+   npx react-native run-android  # or run-ios
+   ```
+
+4. **For iOS, ensure pods are installed:**
+   ```bash
+   cd ios && pod install && cd ..
+   ```
+
+### Component Not Rendering
+
+If the OnwidButton component doesn't appear or crashes:
+
+- Ensure all peer dependencies are installed
+- Check that your app has proper permissions for microphone access
+- Verify your API key and server URL are correct
+
+### Voice Connection Issues
+
+If voice connection fails:
+
+- Check your network connection
+- Verify your API key is valid
+- Ensure microphone permissions are granted
+- Check the console for detailed error messages
+
+## 🎯 Quick Start
+
+### 1. Initialize the SDK
+
+```tsx
+import { useInitialize } from '@revrag-ai/embed-react-native';
+
+function App() {
+  useInitialize({
+    apiKey: 'your-api-key',
+    onwidUrl: 'https://your-onwid-server.com',
+    metadata: {
+      config: {
+        // Your configuration
+      }
+    }
+  });
+
+  return (
+    // Your app content
+  );
+}
+```
+
+### 2. Use the Voice Agent
+
+```tsx
+import { useVoiceAgent } from '@revrag-ai/embed-react-native';
+
+function VoiceComponent() {
+  const {
+    initializeVoiceAgent,
+    endCall,
+    muteMic,
+    unmuteMic,
+    isMicMuted,
+    connectionState,
+    isLoading,
+    error
+  } = useVoiceAgent();
+
+  const startVoiceCall = async () => {
+    try {
+      await initializeVoiceAgent();
+    } catch (error) {
+      console.error('Failed to start voice call:', error);
+    }
+  };
+
+  return (
+    <View>
+      <Button title="Start Voice Call" onPress={startVoiceCall} />
+      <Button title="End Call" onPress={endCall} />
+      <Button 
+        title={isMicMuted ? "Unmute" : "Mute"} 
+        onPress={isMicMuted ? unmuteMic : muteMic} 
+      />
+      <Text>Status: {connectionState}</Text>
+      {isLoading && <Text>Loading...</Text>}
+      {error && <Text>Error: {error}</Text>}
+    </View>
+  );
+}
+```
+
+### 3. Handle Events
+
+```tsx
+import { onwid, EventKeys } from '@revrag-ai/embed-react-native';
+
+// Send user data
+await onwid.Event(EventKeys.USER_DATA, {
+  app_user_id: 'user123',
+  name: 'John Doe',
+  preferences: {
+    language: 'en'
+  }
+});
+
+// Send screen state
+await onwid.Event(EventKeys.SCREEN_STATE, {
+  screen: 'home',
+  timestamp: Date.now()
+});
+```
+
+### 4. TypeScript Usage
+
+For TypeScript projects, you can import types for better type safety:
+
+```tsx
+import { 
+  OnwidButton, 
+  useInitialize, 
+  useVoiceAgent,
+  type UseInitializeProps,
+  type UseVoiceAgentReturn,
+  type ApiResponse,
+  EventKeys 
+} from '@revrag-ai/embed-react-native';
+
+// Type-safe initialization
+const initProps: UseInitializeProps = {
+  apiKey: 'your-api-key',
+  onwidUrl: 'https://your-onwid-server.com',
+  metadata: {
+    config: {
+      theme: 'dark'
+    }
+  }
+};
+
+function MyVoiceComponent() {
+  useInitialize(initProps);
+  
+  const voiceAgent: UseVoiceAgentReturn = useVoiceAgent();
+  
+  const handleStartCall = async (): Promise<void> => {
+    try {
+      await voiceAgent.initializeVoiceAgent();
+    } catch (error) {
+      console.error('Failed to start call:', error);
+    }
+  };
+
+  return (
+    <View>
+      <OnwidButton />
+      <Button title="Start Call" onPress={handleStartCall} />
+    </View>
+  );
+}
+```
+
+### 5. Use the OnWid Button Component
+
+```tsx
+import { OnwidButton } from '@revrag-ai/embed-react-native';
+
+function MyComponent() {
+  return (
+    <View>
+      <OnwidButton />
+    </View>
+  );
+}
+```
+
+## 📚 API Reference
+
+### Hooks
+
+#### `useInitialize(props: UseInitializeProps)`
+
+Initializes the OnWid SDK with your configuration.
+
+**Props:**
+- `apiKey: string` - Your OnWid API key
+- `onwidUrl: string` - Your OnWid server URL
+- `metadata?: object` - Optional metadata configuration
+
+#### `useVoiceAgent(): UseVoiceAgentReturn`
+
+Provides voice agent functionality.
+
+**Returns:**
+- `initializeVoiceAgent: () => Promise<void>` - Start voice agent
+- `endCall: () => Promise<void>` - End the voice call
+- `muteMic: () => void` - Mute microphone
+- `unmuteMic: () => void` - Unmute microphone
+- `isMicMuted: boolean` - Microphone mute state
+- `connectionState: ConnectionState` - Current connection state
+- `isLoading: boolean` - Loading state
+- `error: string | null` - Error message if any
+
+### Components
+
+#### `OnwidButton`
+
+A customizable button component with built-in voice agent functionality.
+
+### Classes
+
+#### `APIService`
+
+Singleton service for API communication.
+
+```tsx
+import { APIService } from '@revrag-ai/embed-react-native';
+
+const apiService = APIService.getInstance();
+await apiService.initialize();
+```
+### Events
+
+#### `EventKeys`
+
+Available event types:
+- `USER_DATA` - User information events
+- `SCREEN_STATE` - Screen state events
+
+## 🔒 Security
+
+The OnWid SDK includes built-in security features:
+
+- Automatic API key management
+- Secure token handling
+- Protected API endpoints
+- Integrity checks
+
+## 🤝 Contributing
+
+We welcome contributions! Please see our [Contributing Guide](CONTRIBUTING.md) for details.
+
+## 📄 License
+
+This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
+
+## 🆘 Support
+
+- 📧 Email: contact@revrag.ai
+- 🐛 Issues: [GitHub Issues](https://github.com/RevRag-ai/embed-react-native/issues)
+- 📖 Documentation: [Integration Guide](INTEGRATION_GUIDE.md)
+
+## 🏷️ Version History
+
+### 1.0.3
+- Enhanced APIService with singleton pattern
+- Improved error handling and initialization
+- Better TypeScript support
+- Fixed voice component compatibility
+
+### 1.0.2
+- Initial stable release
+- Core voice agent functionality
+- Event system implementation
+
+---
+
+Made with ❤️ by [RevRag AI](https://www.revrag.ai)
+

package/android/build.gradle

@@ -0,0 +1,83 @@
+  buildscript {
+    ext.getExtOrDefault = {name ->
+      return rootProject.ext.has(name) ? rootProject.ext.get(name) : project.properties['Onwid_' + 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')}"
+    }
+  }
+
+
+apply plugin: "com.android.library"
+apply plugin: "kotlin-android"
+
+apply plugin: "com.facebook.react"
+
+def getExtOrIntegerDefault(name) {
+  return rootProject.ext.has(name) ? rootProject.ext.get(name) : (project.properties["Onwid_" + name]).toInteger()
+}
+
+android {
+  namespace "com.onwid"
+
+  compileSdkVersion getExtOrIntegerDefault("compileSdkVersion")
+
+  defaultConfig {
+    minSdkVersion getExtOrIntegerDefault("minSdkVersion")
+    targetSdkVersion getExtOrIntegerDefault("targetSdkVersion")
+  }
+
+  buildFeatures {
+    buildConfig true
+  }
+
+  buildTypes {
+    release {
+      minifyEnabled false
+    }
+  }
+
+  lintOptions {
+    disable "GradleCompatible"
+  }
+
+  compileOptions {
+    sourceCompatibility JavaVersion.VERSION_1_8
+    targetCompatibility JavaVersion.VERSION_1_8
+  }
+
+  sourceSets {
+    main {
+      java.srcDirs += [
+        "generated/java",
+        "generated/jni"
+      ]
+    }
+  }
+}
+
+repositories {
+  mavenCentral()
+  google()
+}
+
+def kotlin_version = getExtOrDefault("kotlinVersion")
+
+dependencies {
+  implementation "com.facebook.react:react-android"
+  implementation "org.jetbrains.kotlin:kotlin-stdlib:$kotlin_version"
+}
+
+react {
+  jsRootDir = file("../src/")
+  libraryName = "Onwid"
+  codegenJavaPackageName = "com.onwid"
+}

package/android/gradle.properties

@@ -0,0 +1,5 @@
+Onwid_kotlinVersion=2.0.21
+Onwid_minSdkVersion=24
+Onwid_targetSdkVersion=34
+Onwid_compileSdkVersion=35
+Onwid_ndkVersion=27.1.12297006

package/ios/Onwid.h

@@ -0,0 +1,5 @@
+#import <OnwidSpec/OnwidSpec.h>
+
+@interface Onwid : NSObject <NativeOnwidSpec>
+
+@end

package/ios/Onwid.mm

@@ -0,0 +1,18 @@
+#import "Onwid.h"
+
+@implementation Onwid
+RCT_EXPORT_MODULE()
+
+- (NSNumber *)multiply:(double)a b:(double)b {
+    NSNumber *result = @(a * b);
+
+    return result;
+}
+
+- (std::shared_ptr<facebook::react::TurboModule>)getTurboModule:
+    (const facebook::react::ObjCTurboModule::InitParams &)params
+{
+    return std::make_shared<facebook::react::NativeOnwidSpecJSI>(params);
+}
+
+@end

package/lib/index.d.ts

@@ -0,0 +1,77 @@
+/**
+ * @file index.d.ts
+ * @description TypeScript declarations for the Onwid React Native library.
+ */
+
+import { ConnectionState, Room } from 'livekit-client';
+import { RefObject } from 'react';
+
+// Component declarations
+export declare function OnwidButton(): JSX.Element;
+
+// Hook type declarations
+export interface UseInitializeProps {
+  apiKey: string;
+  agentId?: string;
+  onwidUrl?: string;
+  metadata?: any;
+}
+
+export interface UseVoiceAgentReturn {
+  initializeVoiceAgent: () => Promise<void>;
+  isLoading: boolean;
+  error: string | null;
+  tokenDetails: any;
+  endCall: () => Promise<void>;
+  room: Room;
+  roomRef: RefObject<Room>;
+  isMicMuted: boolean;
+  muteMic: () => void;
+  unmuteMic: () => void;
+  connectionState: ConnectionState;
+  cleanup: () => void;
+}
+
+// Hook declarations
+export declare const useInitialize: (props: UseInitializeProps) => void;
+export declare const useVoiceAgent: () => UseVoiceAgentReturn;
+
+// API type declarations
+export interface ApiResponse<T> {
+  success: boolean;
+  data?: T;
+  error?: string;
+}
+
+export interface RegisterRequest {
+  apiKey: string;
+  onwidUrl: string;
+  metadata?: Record<string, any>;
+}
+
+export interface TokenDetails {
+  token: string;
+  expiresAt: number;
+  apiKey: string;
+  config: Record<string, any>;
+  server_url: string;
+}
+
+export interface UpdateDataRequest {
+  eventKey: string;
+  data: Record<string, any>;
+}
+
+// Event system declarations
+export enum EventKeys {
+  USER_DATA = 'user_data',
+  SCREEN_STATE = 'state_data',
+}
+
+export declare class OnWid {
+  Event(eventKey: string, data: any): Promise<void>;
+  on(eventKey: EventKeys, callback: (data: any) => void): void;
+}
+
+export declare const onwid: OnWid;
+export declare const registerAgent: any; 

package/lib/module/Event/onwid.js

@@ -0,0 +1,74 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EventKeys = void 0;
+const store_key_1 = require("../store.key");
+const api_1 = require("../onwidApi/api");
+// Predefined event keys
+var EventKeys;
+(function (EventKeys) {
+    EventKeys["USER_DATA"] = "user_data";
+    EventKeys["SCREEN_STATE"] = "state_data";
+})(EventKeys || (exports.EventKeys = EventKeys = {}));
+class OnWid {
+    constructor() {
+        this.events = {};
+    }
+    // Automatically adds a default listener if none exists
+    ensureDefaultListener(eventKey) {
+        if (!this.events[eventKey]) {
+            this.events[eventKey] = [
+                (data) => {
+                    console.log(`[Default] Event handled for ${eventKey}:`, data);
+                },
+            ];
+        }
+    }
+    async Event(eventKey, data) {
+        var _a;
+        if (!Object.values(EventKeys).includes(eventKey)) {
+            console.error(`Invalid event key: ${eventKey}`);
+            throw new Error(`Invalid event key: ${eventKey}. Must be one of: ${Object.values(EventKeys).join(', ')}`);
+        }
+        const key = eventKey;
+        if (key !== EventKeys.USER_DATA) {
+            const userIdentity = await (0, store_key_1.getAgentData)(EventKeys.USER_DATA);
+            if (userIdentity) {
+                data.app_user_id = userIdentity.app_user_id;
+            }
+            else {
+                throw new Error('User identity not found');
+            }
+        }
+        // Ensure a default listener is registered if not already
+        this.ensureDefaultListener(key);
+        console.log('response,updateUserDatniuioioioa');
+        // Trigger API call
+        try {
+            const apiService = api_1.APIService.getInstance();
+            const response = await apiService.updateUserData({
+                eventKey: key,
+                data,
+            });
+            console.log('response,updateUserData', response);
+            if (!response.success) {
+                console.error('Failed to trigger API for event:', eventKey);
+            }
+            (0, store_key_1.setAgentData)(data, key);
+        }
+        catch (error) {
+            console.error('Error triggering API:', error);
+        }
+        // Trigger event listeners
+        (_a = this.events[key]) === null || _a === void 0 ? void 0 : _a.forEach((callback) => callback(data));
+    }
+    // Still allow custom listeners (optional)
+    on(eventKey, callback) {
+        var _a;
+        if (!this.events[eventKey]) {
+            this.events[eventKey] = [];
+        }
+        (_a = this.events[eventKey]) === null || _a === void 0 ? void 0 : _a.push(callback);
+    }
+}
+const onwid = new OnWid();
+exports.default = onwid;