@offline-protocol/mesh-sdk 0.2.0

package/scripts/build-uniffi-android.sh

@@ -0,0 +1,139 @@
+#!/usr/bin/env bash
+
+# Build UniFFI Android libraries and generate Kotlin bindings
+# This script builds the Rust UniFFI library for Android and generates Kotlin bindings
+# Compatible with bash 3.2+ (macOS default)
+
+set -e
+
+echo "Building UniFFI Android libraries and generating Kotlin bindings..."
+
+# Navigate to the Rust project root
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PROJECT_ROOT="$(cd "$SCRIPT_DIR/../../.." && pwd)"
+UNIFFI_DIR="$PROJECT_ROOT/crates/offline-protocol-uniffi"
+OUTPUT_DIR="$SCRIPT_DIR/../android/src/main/jniLibs"
+GENERATED_DIR="$SCRIPT_DIR/../android/src/main/java"
+
+cd "$PROJECT_ROOT"
+
+# Android ABIs and their Rust targets (bash 3.2 compatible)
+ABIS=("arm64-v8a" "armeabi-v7a" "x86_64" "x86")
+TARGETS=("aarch64-linux-android" "armv7-linux-androideabi" "x86_64-linux-android" "i686-linux-android")
+
+# Check if NDK is available
+if [ -z "$ANDROID_NDK_HOME" ] && [ -z "$NDK_HOME" ]; then
+  echo "Warning: ANDROID_NDK_HOME or NDK_HOME not set."
+  echo "Please set one of these environment variables to your Android NDK path."
+  echo "Example: export ANDROID_NDK_HOME=/Users/\$USER/Library/Android/sdk/ndk/25.1.8937393"
+  echo ""
+  echo "Attempting to find NDK in common locations..."
+  
+  # Try to find NDK in common locations
+  POSSIBLE_NDKS=(
+    "$HOME/Library/Android/sdk/ndk"
+    "$HOME/Android/Sdk/ndk"
+    "/opt/android-ndk"
+  )
+  
+  for ndk_path in "${POSSIBLE_NDKS[@]}"; do
+    if [ -d "$ndk_path" ]; then
+      # Use the first (usually latest) version found
+      NDK_VERSION=$(ls -1 "$ndk_path" | sort -V | tail -1)
+      if [ -n "$NDK_VERSION" ]; then
+        export ANDROID_NDK_HOME="$ndk_path/$NDK_VERSION"
+        echo "Found NDK at: $ANDROID_NDK_HOME"
+        break
+      fi
+    fi
+  done
+  
+  if [ -z "$ANDROID_NDK_HOME" ]; then
+    echo "Error: Could not find Android NDK. Please install it or set ANDROID_NDK_HOME."
+    exit 1
+  fi
+fi
+
+# Add NDK toolchain to PATH
+NDK_TOOLCHAIN="$ANDROID_NDK_HOME/toolchains/llvm/prebuilt/darwin-x86_64/bin"
+if [ ! -d "$NDK_TOOLCHAIN" ]; then
+  # Try alternate path for Apple Silicon
+  NDK_TOOLCHAIN="$ANDROID_NDK_HOME/toolchains/llvm/prebuilt/darwin-aarch64/bin"
+fi
+
+if [ -d "$NDK_TOOLCHAIN" ]; then
+  export PATH="$NDK_TOOLCHAIN:$PATH"
+  echo "Added NDK toolchain to PATH: $NDK_TOOLCHAIN"
+else
+  echo "Warning: Could not find NDK toolchain directory"
+fi
+
+# Ensure targets are installed
+echo "Installing Android targets..."
+for target in "${TARGETS[@]}"; do
+  rustup target add "$target"
+done
+
+# Build for each ABI
+echo "Building UniFFI library for Android ABIs..."
+for i in "${!ABIS[@]}"; do
+  abi="${ABIS[$i]}"
+  target="${TARGETS[$i]}"
+  echo "Building for $abi ($target)..."
+  
+  cargo build --release --target "$target" --package offline-protocol-uniffi
+  
+  # Create output directory for this ABI
+  mkdir -p "$OUTPUT_DIR/$abi"
+  
+  # Copy library to jniLibs
+  # UniFFI generates code that looks for "uniffi_offline_protocol" which JNA converts to "libuniffi_offline_protocol.so"
+  cp "$PROJECT_ROOT/target/$target/release/liboffline_protocol_uniffi.so" \
+     "$OUTPUT_DIR/$abi/libuniffi_offline_protocol.so"
+  
+  echo "✅ Built and copied library for $abi"
+done
+
+echo ""
+echo "Android libraries built and copied to $OUTPUT_DIR"
+
+# Print library info
+echo ""
+echo "Library sizes:"
+for abi in "${ABIS[@]}"; do
+  lib_path="$OUTPUT_DIR/$abi/liboffline_protocol_uniffi.so"
+  if [ -f "$lib_path" ]; then
+    size=$(du -h "$lib_path" | cut -f1)
+    echo "  $abi: $size"
+  fi
+done
+
+# Generate Kotlin bindings
+echo ""
+echo "Generating Kotlin bindings..."
+
+if command -v uniffi-bindgen &> /dev/null; then
+  mkdir -p "$GENERATED_DIR"
+  cd "$UNIFFI_DIR"
+  
+  uniffi-bindgen generate \
+    src/offline_protocol.udl \
+    --language kotlin \
+    --out-dir "$GENERATED_DIR"
+  
+  echo "✅ Kotlin bindings generated in $GENERATED_DIR"
+else
+  echo "⚠️  uniffi-bindgen not found!"
+  echo "Install it with: cargo install uniffi --version 0.30.0 --features cli"
+  echo ""
+  echo "For now, the native libraries are built, but you'll need to"
+  echo "generate Kotlin bindings manually when uniffi-bindgen is available."
+  echo ""
+  echo "To generate bindings later, run:"
+  echo "  cd $UNIFFI_DIR"
+  echo "  uniffi-bindgen generate src/offline_protocol.udl --language kotlin --out-dir $GENERATED_DIR"
+fi
+
+echo ""
+echo "✅ Android UniFFI build complete!"
+

package/scripts/build-uniffi-ios.sh

@@ -0,0 +1,96 @@
+#!/bin/bash
+
+# Build UniFFI iOS library and generate Swift bindings
+# This script builds the Rust UniFFI library for iOS and generates Swift bindings
+
+set -e
+
+echo "Building UniFFI iOS library and generating Swift bindings..."
+
+# Navigate to the Rust project root
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PROJECT_ROOT="$(cd "$SCRIPT_DIR/../../.." && pwd)"
+UNIFFI_DIR="$PROJECT_ROOT/crates/offline-protocol-uniffi"
+OUTPUT_DIR="$SCRIPT_DIR/../ios/libs"
+GENERATED_DIR="$SCRIPT_DIR/../ios/Generated"
+
+cd "$PROJECT_ROOT"
+
+# iOS architectures
+IOS_ARCHS=(
+  "aarch64-apple-ios"           # iOS devices (ARM64)
+  "aarch64-apple-ios-sim"       # iOS simulator on Apple Silicon
+  "x86_64-apple-ios"            # iOS simulator on Intel
+)
+
+# Ensure targets are installed
+echo "Installing iOS targets..."
+for arch in "${IOS_ARCHS[@]}"; do
+  rustup target add "$arch"
+done
+
+# Build for each architecture
+echo "Building UniFFI library for iOS architectures..."
+for arch in "${IOS_ARCHS[@]}"; do
+  echo "Building for $arch..."
+  cargo build --release --target "$arch" --package offline-protocol-uniffi
+done
+
+# Create output directories
+mkdir -p "$OUTPUT_DIR"
+mkdir -p "$GENERATED_DIR"
+
+echo "Creating universal libraries..."
+
+# Create universal library for devices
+echo "Creating device library..."
+cp "$PROJECT_ROOT/target/aarch64-apple-ios/release/liboffline_protocol_uniffi.a" \
+   "$OUTPUT_DIR/liboffline_protocol_uniffi_device.a"
+
+# Create universal library for simulators (both Intel and Apple Silicon)
+echo "Creating simulator library..."
+lipo -create \
+  "$PROJECT_ROOT/target/aarch64-apple-ios-sim/release/liboffline_protocol_uniffi.a" \
+  "$PROJECT_ROOT/target/x86_64-apple-ios/release/liboffline_protocol_uniffi.a" \
+  -output "$OUTPUT_DIR/liboffline_protocol_uniffi_sim.a"
+
+echo "iOS libraries created:"
+echo "  Device: $OUTPUT_DIR/liboffline_protocol_uniffi_device.a"
+echo "  Simulator: $OUTPUT_DIR/liboffline_protocol_uniffi_sim.a"
+
+# Generate Swift bindings
+echo ""
+echo "Generating Swift bindings..."
+
+if command -v uniffi-bindgen &> /dev/null; then
+  cd "$UNIFFI_DIR"
+  
+  uniffi-bindgen generate \
+    src/offline_protocol.udl \
+    --language swift \
+    --out-dir "$GENERATED_DIR"
+  
+  echo "✅ Swift bindings generated in $GENERATED_DIR"
+else
+  echo "⚠️  uniffi-bindgen not found!"
+  echo "Install it with: cargo install uniffi --version 0.30.0 --features cli"
+  echo ""
+  echo "For now, the native libraries are built, but you'll need to"
+  echo "generate Swift bindings manually when uniffi-bindgen is available."
+  echo ""
+  echo "To generate bindings later, run:"
+  echo "  cd $UNIFFI_DIR"
+  echo "  uniffi-bindgen generate src/offline_protocol.udl --language swift --out-dir $GENERATED_DIR"
+fi
+
+# Print library info
+echo ""
+echo "Library info:"
+echo "Device library:"
+lipo -info "$OUTPUT_DIR/liboffline_protocol_uniffi_device.a"
+echo "Simulator library:"
+lipo -info "$OUTPUT_DIR/liboffline_protocol_uniffi_sim.a"
+
+echo ""
+echo "✅ iOS UniFFI build complete!"
+

package/scripts/generate-bindings.sh

@@ -0,0 +1,64 @@
+#!/bin/bash
+
+# Generate UniFFI bindings only (without building native libraries)
+# Useful when you just need to regenerate bindings from UDL changes
+
+set -e
+
+echo "Generating UniFFI bindings for Swift and Kotlin..."
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PROJECT_ROOT="$(cd "$SCRIPT_DIR/../../.." && pwd)"
+UNIFFI_DIR="$PROJECT_ROOT/crates/offline-protocol-uniffi"
+SWIFT_OUT="$SCRIPT_DIR/../ios/Generated"
+KOTLIN_OUT="$SCRIPT_DIR/../android/src/main/java"
+
+# Check if uniffi-bindgen is installed
+if ! command -v uniffi-bindgen &> /dev/null; then
+  echo "❌ Error: uniffi-bindgen not found!"
+  echo ""
+  echo "Install it with:"
+  echo "  cargo install uniffi --version 0.30.0 --features cli"
+  echo ""
+  exit 1
+fi
+
+cd "$UNIFFI_DIR"
+
+# Create output directories
+mkdir -p "$SWIFT_OUT"
+mkdir -p "$KOTLIN_OUT"
+
+# Generate Swift bindings
+echo "Generating Swift bindings..."
+uniffi-bindgen generate \
+  src/offline_protocol.udl \
+  --language swift \
+  --out-dir "$SWIFT_OUT"
+
+echo "✅ Swift bindings generated in $SWIFT_OUT"
+
+# Generate Kotlin bindings
+echo "Generating Kotlin bindings..."
+uniffi-bindgen generate \
+  src/offline_protocol.udl \
+  --language kotlin \
+  --out-dir "$KOTLIN_OUT"
+
+echo "✅ Kotlin bindings generated in $KOTLIN_OUT"
+
+echo ""
+echo "========================================="
+echo "✅ All bindings generated successfully!"
+echo "========================================="
+echo ""
+echo "Generated files:"
+echo "  Swift:   $SWIFT_OUT"
+echo "  Kotlin:  $KOTLIN_OUT"
+echo ""
+echo "Next steps:"
+echo "  1. Review the generated bindings"
+echo "  2. Update your Swift/Kotlin modules to use them"
+echo "  3. Build and test your app"
+echo ""
+

package/scripts/prepare-npm.sh

@@ -0,0 +1,87 @@
+#!/bin/bash
+
+# Prepare for npm publish
+# Validates that all required binaries are present before publishing
+
+set -e
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+RN_DIR="$SCRIPT_DIR/.."
+
+echo "Validating pre-built binaries for npm package..."
+echo ""
+
+# Check iOS library
+IOS_LIB="$RN_DIR/ios/libs/liboffline_protocol_uniffi_device.a"
+IOS_SIM_LIB="$RN_DIR/ios/libs/liboffline_protocol_uniffi_sim.a"
+if [ -f "$IOS_LIB" ]; then
+  echo "✅ iOS library found: $IOS_LIB"
+  echo "   Size: $(du -h "$IOS_LIB" | cut -f1)"
+  echo "   Architectures: $(lipo -info "$IOS_LIB" | cut -d: -f3)"
+else
+  echo "❌ iOS library missing: $IOS_LIB"
+  echo "   Run: npm run build:ios"
+  exit 1
+fi
+
+echo ""
+
+# Check Android libraries
+ANDROID_DIR="$RN_DIR/android/src/main/jniLibs"
+ANDROID_ABIS=("arm64-v8a" "armeabi-v7a" "x86_64" "x86")
+MISSING_ABIS=()
+
+for abi in "${ANDROID_ABIS[@]}"; do
+  lib_path="$ANDROID_DIR/$abi/liboffline_protocol_uniffi.so"
+  if [ -f "$lib_path" ]; then
+    echo "✅ Android $abi library found"
+    echo "   Size: $(du -h "$lib_path" | cut -f1)"
+  else
+    echo "❌ Android $abi library missing: $lib_path"
+    MISSING_ABIS+=("$abi")
+  fi
+done
+
+if [ ${#MISSING_ABIS[@]} -gt 0 ]; then
+  echo ""
+  echo "Missing Android ABIs: ${MISSING_ABIS[*]}"
+  echo "Run: npm run build:android"
+  exit 1
+fi
+
+echo ""
+
+# Check TypeScript files
+if [ ! -f "$RN_DIR/src/index.ts" ] || [ ! -f "$RN_DIR/src/types.ts" ]; then
+  echo "❌ TypeScript source files missing"
+  exit 1
+fi
+
+echo "✅ TypeScript source files found"
+echo ""
+
+# Check native module files
+if [ ! -f "$RN_DIR/ios/OfflineProtocolModule.swift" ]; then
+  echo "❌ iOS native module missing"
+  exit 1
+fi
+
+if [ ! -f "$RN_DIR/android/src/main/java/com/offlineprotocol/OfflineProtocolModule.kt" ]; then
+  echo "❌ Android native module missing"
+  exit 1
+fi
+
+echo "✅ Native module files found"
+echo ""
+echo "========================================="
+echo "✅ All required files are present!"
+echo "========================================="
+echo ""
+echo "Package is ready for publishing:"
+echo "  npm publish"
+echo ""
+echo "Package size estimate:"
+TOTAL_SIZE=$(du -sh "$RN_DIR" | cut -f1)
+echo "  Total: $TOTAL_SIZE"
+echo ""
+

package/src/constants.ts

@@ -0,0 +1,25 @@
+/**
+ * Constants used throughout the Offline Protocol React Native bindings.
+ */
+
+/**
+ * Error message shown when the native module is not properly linked.
+ */
+export const LINKING_ERROR =
+  `The package '@offline-protocol/mesh-sdk' doesn't seem to be linked. Make sure: \n\n` +
+  '- You have run pod install (iOS)\n' +
+  '- You rebuilt the app after installing the package\n' +
+  '- You are not using Expo Go\n';
+
+/**
+ * Default delay in milliseconds before refreshing runtime state after protocol start.
+ * This gives the protocol time to fully initialize before querying state.
+ */
+export const PROTOCOL_START_DELAY_MS = 500;
+
+/**
+ * Maximum number of events to keep in memory for the event history.
+ * Older events are automatically removed to prevent unbounded memory growth.
+ */
+export const MAX_EVENT_HISTORY = 200;
+