@json-eval-rs/react-native 0.0.28

package/README.md

@@ -0,0 +1,455 @@
+# @json-eval-rs/react-native
+
+High-performance JSON Logic evaluator with schema validation for React Native.
+
+Built with Rust for maximum performance, with native Android (Kotlin + JNI) and iOS (Objective-C++) bindings. All operations run asynchronously on background threads to keep your UI responsive.
+
+## Features
+
+- 🚀 **Native Performance** - Built with Rust for iOS and Android
+- ✅ **Schema Validation** - Validate data against JSON schema rules
+- 🔄 **Dependency Tracking** - Auto-update dependent fields
+- 🎯 **Type Safe** - Full TypeScript support
+- ⚛️ **React Hooks** - Built-in `useJSONEval` hook
+- 📱 **Cross-Platform** - Works on iOS and Android
+- 🔥 **Fast** - Native performance, not JavaScript
+
+## Installation
+
+```bash
+yarn install @json-eval-rs/react-native
+```
+
+Or with Yarn:
+
+```bash
+yarn add @json-eval-rs/react-native
+```
+
+### iOS
+
+```bash
+cd ios && pod install
+```
+
+### Android
+
+No additional steps required. The library uses autolinking.
+
+## Quick Start
+
+### Basic Usage
+
+```typescript
+import { JSONEval } from '@json-eval-rs/react-native';
+
+const schema = {
+  type: 'object',
+  properties: {
+    user: {
+      type: 'object',
+      properties: {
+        name: {
+          type: 'string',
+          rules: {
+            required: { value: true, message: 'Name is required' },
+            minLength: { value: 3, message: 'Min 3 characters' }
+          }
+        },
+        age: {
+          type: 'number',
+          rules: {
+            minValue: { value: 18, message: 'Must be 18+' }
+          }
+        }
+      }
+    }
+  }
+};
+
+// Create evaluator
+const eval = new JSONEval({ schema });
+
+// Evaluate
+const data = { user: { name: 'John', age: 25 } };
+const result = await eval.evaluate({ data });
+console.log('Evaluated:', result);
+
+// Validate
+const validation = await eval.validate({ data });
+if (validation.hasError) {
+  validation.errors.forEach(error => {
+    console.error(`${error.path}: ${error.message}`);
+  });
+}
+
+// Clean up
+await eval.dispose();
+```
+
+### Using React Hook
+
+```typescript
+import React, { useState } from 'react';
+import { View, TextInput, Button, Text } from 'react-native';
+import { useJSONEval } from '@json-eval-rs/react-native';
+
+const schema = {
+  type: 'object',
+  properties: {
+    user: {
+      type: 'object',
+      properties: {
+        name: {
+          type: 'string',
+          rules: {
+            required: { value: true, message: 'Name is required' },
+            minLength: { value: 3, message: 'Min 3 characters' }
+          }
+        }
+      }
+    }
+  }
+};
+
+function MyForm() {
+  const eval = useJSONEval({ schema });
+  const [name, setName] = useState('');
+  const [errors, setErrors] = useState<string[]>([]);
+
+  const handleValidate = async () => {
+    if (!eval) return;
+    
+    const data = { user: { name } };
+    const validation = await eval.validate({ data });
+    
+    if (validation.hasError) {
+      setErrors(validation.errors.map(e => e.message));
+    } else {
+      setErrors([]);
+      console.log('Valid!');
+    }
+  };
+
+  return (
+    <View>
+      <TextInput
+        value={name}
+        onChangeText={setName}
+        placeholder="Enter name"
+      />
+      <Button title="Validate" onPress={handleValidate} />
+      
+      {errors.map((error, i) => (
+        <Text key={i} style={{ color: 'red' }}>{error}</Text>
+      ))}
+    </View>
+  );
+}
+```
+
+### Advanced: Dependent Fields
+
+```typescript
+import React, { useState, useEffect } from 'react';
+import { View, TextInput, Text } from 'react-native';
+import { useJSONEval } from '@json-eval-rs/react-native';
+
+const schema = {
+  type: 'object',
+  properties: {
+    quantity: { type: 'number' },
+    price: { type: 'number' },
+    total: {
+      type: 'number',
+      $evaluation: {
+        '*': [{ var: 'quantity' }, { var: 'price' }]
+      }
+    }
+  }
+};
+
+function Calculator() {
+  const eval = useJSONEval({ schema });
+  const [quantity, setQuantity] = useState(1);
+  const [price, setPrice] = useState(10);
+  const [total, setTotal] = useState(0);
+
+  useEffect(() => {
+    if (!eval) return;
+    
+    const updateTotal = async () => {
+      const data = { quantity, price };
+      const result = await eval.evaluateDependents({
+        changedPaths: ['quantity'],  // Array of changed field paths
+        data,
+        reEvaluate: false  // Optional: re-evaluate entire schema after dependents
+      });
+      
+      setTotal(result.total);
+    };
+    
+    updateTotal();
+  }, [eval, quantity, price]);
+
+  return (
+    <View>
+      <TextInput
+        value={String(quantity)}
+        onChangeText={(val) => setQuantity(Number(val))}
+        keyboardType="numeric"
+      />
+      <TextInput
+        value={String(price)}
+        onChangeText={(val) => setPrice(Number(val))}
+        keyboardType="numeric"
+      />
+      <Text>Total: {total}</Text>
+    </View>
+  );
+}
+```
+
+## API Reference
+
+### JSONEval Class
+
+#### Constructor
+
+```typescript
+constructor(options: {
+  schema: string | object;
+  context?: string | object;
+  data?: string | object;
+})
+```
+
+Creates a new evaluator instance.
+
+#### Methods
+
+##### evaluate(options)
+
+Evaluates the schema with provided data.
+
+```typescript
+async evaluate(options: {
+  data: string | object;
+  context?: string | object;
+}): Promise<any>
+```
+
+##### validate(options)
+
+Validates data against schema rules.
+
+```typescript
+async validate(options: {
+  data: string | object;
+  context?: string | object;
+}): Promise<ValidationResult>
+```
+
+Returns:
+```typescript
+interface ValidationResult {
+  hasError: boolean;
+  errors: ValidationError[];
+}
+
+interface ValidationError {
+  path: string;
+  ruleType: string;
+  message: string;
+}
+```
+
+##### evaluateDependents(options)
+
+Re-evaluates fields that depend on changed paths (processes transitively).
+
+```typescript
+async evaluateDependents(options: {
+  changedPaths: string[];      // Array of field paths that changed
+  data?: string | object;       // Optional updated data
+  context?: string | object;    // Optional context
+  reEvaluate?: boolean;         // If true, performs full evaluation after dependents
+}): Promise<any[]>
+```
+
+**Parameters:**
+- `changedPaths`: Array of field paths that changed (e.g., `['field1', 'nested.field2']`)
+- `data`: Optional JSON data (string or object). If provided, replaces current data
+- `context`: Optional context data
+- `reEvaluate`: If `true`, performs full schema evaluation after processing dependents (default: `false`)
+
+**Returns:** Array of dependent field change objects with `$ref`, `value`, `$field`, `$parentField`, and `transitive` properties.
+
+**Example:**
+```typescript
+// Update multiple fields and get their dependents
+const result = await eval.evaluateDependents({
+  changedPaths: ['illustration.insured.ins_dob', 'illustration.product_code'],
+  data: updatedData,
+  reEvaluate: true  // Re-run full evaluation after dependents
+});
+
+// Process the changes
+result.forEach(change => {
+  console.log(`Field ${change.$ref} changed:`, change.value);
+});
+```
+
+##### dispose()
+
+Frees native resources. Must be called when done.
+
+```typescript
+async dispose(): Promise<void>
+```
+
+##### static version()
+
+Gets the library version.
+
+```typescript
+static async version(): Promise<string>
+```
+
+### useJSONEval Hook
+
+React hook for automatic lifecycle management.
+
+```typescript
+function useJSONEval(options: JSONEvalOptions): JSONEval | null
+```
+
+Returns `null` until initialized, then returns the `JSONEval` instance.
+Automatically disposes on unmount.
+
+## Validation Rules
+
+Supported validation rules:
+
+- **required** - Field must have a value
+- **minLength** / **maxLength** - String/array length validation
+- **minValue** / **maxValue** - Numeric range validation
+- **pattern** - Regex pattern matching
+
+## Platform Support
+
+- **iOS**: 11.0+
+- **Android**: API 21+ (Android 5.0)
+- **React Native**: 0.64+
+
+## Performance
+
+Typical performance on modern devices:
+- Schema parsing: < 5ms
+- Evaluation: < 10ms for complex schemas
+- Validation: < 5ms
+
+Native performance beats JavaScript-only solutions by 10-50x.
+
+### Sequential Processing
+
+This library uses **sequential processing** by default, which is optimal for mobile devices. The Rust core supports an optional `parallel` feature using Rayon, but:
+- Mobile devices have limited cores and power constraints
+- Sequential processing is faster for typical mobile use cases (small to medium datasets)
+- Parallel overhead exceeds benefits for arrays < 1000 items
+- Battery life is better with sequential processing
+
+The default configuration is optimized for mobile performance and battery efficiency.
+
+## Error Handling
+
+All async methods can throw errors:
+
+```typescript
+try {
+  const result = await eval.evaluate({ data });
+} catch (error) {
+  console.error('Evaluation error:', error.message);
+}
+```
+
+## Memory Management
+
+Always dispose of instances when done:
+
+```typescript
+const eval = new JSONEval({ schema });
+try {
+  // Use eval
+} finally {
+  await eval.dispose(); // Important!
+}
+```
+
+Or use the hook for automatic management:
+
+```typescript
+function MyComponent() {
+  const eval = useJSONEval({ schema }); // Auto-disposed on unmount
+  // Use eval
+}
+```
+
+## TypeScript
+
+Full TypeScript support included. All types are exported:
+
+```typescript
+import type {
+  JSONEval,
+  ValidationError,
+  ValidationResult,
+  JSONEvalOptions,
+  EvaluateOptions,
+  EvaluateDependentsOptions
+} from '@json-eval-rs/react-native';
+```
+
+## Troubleshooting
+
+### iOS Build Errors
+
+If you encounter build errors on iOS:
+
+```bash
+cd ios
+rm -rf Pods Podfile.lock
+pod install --repo-update
+```
+
+### Android Build Errors
+
+If you encounter build errors on Android:
+
+```bash
+cd android
+./gradlew clean
+cd ..
+```
+
+Then rebuild your app.
+
+### "Module not found" Error
+
+Make sure you've:
+1. Installed the package
+2. Run `pod install` on iOS
+3. Rebuilt the app completely
+
+## Contributing
+
+See the [contributing guide](CONTRIBUTING.md) to learn how to contribute to the repository and the development workflow.
+
+## License
+
+MIT
+
+## Support
+
+- GitHub Issues: https://github.com/byrizki/json-eval-rs/issues
+- Documentation: https://github.com/byrizki/json-eval-rs

package/android/CMakeLists.txt

@@ -0,0 +1,78 @@
+cmake_minimum_required(VERSION 3.9.0)
+
+project(json-eval-rn)
+
+set(CMAKE_VERBOSE_MAKEFILE ON)
+set(CMAKE_CXX_STANDARD 17)
+
+# Find React Native
+find_package(ReactAndroid REQUIRED CONFIG)
+
+# Pre-built Rust library (bundled with npm package)
+# The library is located in src/main/jniLibs/[abi]/libjson_eval_rs.so
+set(RUST_PREBUILT_DIR ${CMAKE_SOURCE_DIR}/src/main/jniLibs/${ANDROID_ABI})
+set(RUST_LIB_PATH ${RUST_PREBUILT_DIR}/libjson_eval_rs.so)
+
+message(STATUS "Looking for pre-built Rust library at: ${RUST_LIB_PATH}")
+
+# Check if pre-built library exists
+if(NOT EXISTS ${RUST_LIB_PATH})
+    message(FATAL_ERROR 
+        "Pre-built Rust library not found at: ${RUST_LIB_PATH}\n"
+        "\nThis package requires pre-built native libraries.\n"
+        "If you're developing this package, build the libraries first:\n"
+        "  cd ${CMAKE_SOURCE_DIR}/../..\n"
+        "  ./build-android.sh all\n"
+        "\nIf you're a user and seeing this error, the package may be corrupted.\n"
+        "Try reinstalling: npm install @json-eval-rs/react-native\n"
+        "\nCurrent ANDROID_ABI: ${ANDROID_ABI}")
+endif()
+
+message(STATUS "Using pre-built Rust library: ${RUST_LIB_PATH}")
+
+# Add library search path for the Rust library
+link_directories(${RUST_PREBUILT_DIR})
+
+# C++ Bridge files
+add_library(
+  json_eval_rn
+  SHARED
+  src/main/cpp/json-eval-rn.cpp
+  ../cpp/json-eval-bridge.cpp
+)
+
+# Include directories
+target_include_directories(
+  json_eval_rn
+  PRIVATE
+  ../cpp
+  src/main/cpp
+)
+
+# Link libraries
+# Note: React Native provides JSI and other libraries at runtime
+# We link against them for compilation, but they should not be packaged
+target_link_libraries(
+  json_eval_rn
+  json_eval_rs
+  android
+  log
+  ReactAndroid::jsi
+  ReactAndroid::reactnativejni
+)
+
+# Modern React Native (0.71+) uses prefab which properly handles shared libraries
+# The libraries are marked as shared dependencies, not to be packaged in our module
+# If you still see duplicate library warnings, ensure your React Native version is up to date
+
+# Optimize binary size
+set_target_properties(json_eval_rn PROPERTIES
+  CXX_VISIBILITY_PRESET hidden
+  C_VISIBILITY_PRESET hidden
+  VISIBILITY_INLINES_HIDDEN ON
+)
+
+# Strip debug symbols in release builds
+if(CMAKE_BUILD_TYPE STREQUAL "Release")
+  target_link_options(json_eval_rn PRIVATE -Wl,--strip-all)
+endif()

package/android/build.gradle

@@ -0,0 +1,90 @@
+buildscript {
+    ext.kotlin_version = '1.8.0'
+    repositories {
+        google()
+        mavenCentral()
+    }
+    dependencies {
+        classpath 'com.android.tools.build:gradle:7.4.0'
+        classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:$kotlin_version"
+    }
+}
+
+apply plugin: 'com.android.library'
+apply plugin: 'kotlin-android'
+
+def reactNative = rootProject.allprojects
+    .find { it.name == 'ReactAndroid' }
+
+def safeExtGet(prop, fallback) {
+    rootProject.ext.has(prop) ? rootProject.ext.get(prop) : fallback
+}
+
+android {
+    compileSdkVersion safeExtGet('compileSdkVersion', 33)
+    
+    namespace "com.jsonevalrs"
+    
+    defaultConfig {
+        minSdkVersion safeExtGet('minSdkVersion', 21)
+        targetSdkVersion safeExtGet('targetSdkVersion', 33)
+        
+        externalNativeBuild {
+            cmake {
+                cppFlags "-std=c++17 -fexceptions -frtti"
+                arguments "-DANDROID_STL=c++_shared"
+                abiFilters 'armeabi-v7a', 'arm64-v8a', 'x86', 'x86_64'
+            }
+        }
+    }
+    
+    buildFeatures {
+        prefab true
+    }
+    
+    externalNativeBuild {
+        cmake {
+            path "CMakeLists.txt"
+        }
+    }
+    
+    buildTypes {
+        release {
+            minifyEnabled false
+        }
+    }
+    
+    sourceSets {
+        main {
+            java.srcDirs = ['src/main/java']
+            jniLibs.srcDirs = ['src/main/jniLibs']
+        }
+    }
+    
+    lintOptions {
+        abortOnError false
+    }
+
+    packagingOptions {
+        // Exclude React Native libraries - they're provided by the app
+        // This prevents duplicate .so files and eliminates the need for pickFirst in the app
+        exclude 'lib/**/libjsi.so'
+        exclude 'lib/**/libc++_shared.so'
+        exclude 'lib/**/libreactnativejni.so'
+        exclude 'lib/**/libfbjni.so'
+        
+        // Keep only our module's native library
+        // pickFirst is used as fallback for any remaining conflicts
+        pickFirst 'META-INF/**'
+    }
+}
+
+repositories {
+    google()
+    mavenCentral()
+}
+
+dependencies {
+    implementation "org.jetbrains.kotlin:kotlin-stdlib:$kotlin_version"
+    implementation 'com.facebook.react:react-native:+'
+}

package/android/src/main/AndroidManifest.xml

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