feat: Harness tests

.github/workflows/test-harness-android.yml

@@ -0,0 +1,58 @@
+name: Test Harness Android
+
+on:
+  pull_request:
+    paths:
+      - ".github/workflows/test-harness-android.yml"
+      - "example/android/**"
+      - "example/src/tests/**"
+      - "example/tests/**"
+      - "example/rn-harness.config.mjs"
+      - "example/jest.config.js"
+      - "package/cpp/**"
+      - "package/android/**"
+      - "**/bun.lock"
+      - "**/react-native.config.js"
+      - "**/nitro.json"
+
+env:
+  TARGET_ANDROID_ARCH: x86_64
+
+jobs:
+  test:
+    name: Harness Tests (Android)
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v6
+      - uses: oven-sh/setup-bun@v2
+
+      - name: Setup JDK 17
+        uses: actions/setup-java@v5
+        with:
+          distribution: "zulu"
+          java-version: 17
+
+      - name: Enable KVM group perms
+        run: |
+          echo 'KERNEL=="kvm", GROUP="kvm", MODE="0666", OPTIONS+="static_node=kvm"' | sudo tee /etc/udev/rules.d/99-kvm4all.rules
+          sudo udevadm control --reload-rules
+          sudo udevadm trigger --name-match=kvm
+
+      - name: Install dependencies (bun)
+        run: bun install
+
+      - name: Build Android app
+        working-directory: example/android
+        run: >-
+          ./gradlew :app:assembleDebug --no-daemon
+          -PreactNativeArchitectures=${{ env.TARGET_ANDROID_ARCH }}
+
+      - name: Run react-native-harness on Android
+        uses: callstackincubator/react-native-harness@v1.2.0
+        with:
+          app: android/app/build/outputs/apk/debug/app-debug.apk
+          runner: android
+          projectRoot: example
+          packageManager: bun
+          cacheAvd: false

.github/workflows/test-harness-ios.yml

@@ -0,0 +1,71 @@
+name: Test Harness iOS
+
+on:
+  pull_request:
+    paths:
+      - ".github/workflows/test-harness-ios.yml"
+      - "example/ios/**"
+      - "example/src/tests/**"
+      - "example/tests/**"
+      - "example/rn-harness.config.mjs"
+      - "example/jest.config.js"
+      - "package/cpp/**"
+      - "package/ios/**"
+      - "**/Podfile.lock"
+      - "**/*.podspec"
+      - "**/react-native.config.js"
+      - "**/nitro.json"
+      - "**/bun.lock"
+
+jobs:
+  test:
+    name: Harness Tests (iOS)
+    runs-on: macOS-26
+    env:
+      IOS_SIMULATOR_NAME: iPhone 17 Pro
+      IOS_SIMULATOR_OS: "26.2"
+
+    steps:
+      - uses: actions/checkout@v6
+      - uses: oven-sh/setup-bun@v2
+
+      - name: Install dependencies (bun)
+        run: bun install
+
+      - name: Setup Ruby (bundle)
+        uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: 3.3.0
+          bundler-cache: true
+          working-directory: example
+
+      - name: Select Xcode 26.2
+        run: sudo xcode-select -s "/Applications/Xcode_26.2.app/Contents/Developer"
+
+      - name: Install Pods
+        working-directory: example
+        run: bun pods
+
+      - name: Build debug app
+        working-directory: example/ios
+        run: |
+          set -euo pipefail
+
+          xcodebuild \
+            CC=clang CPLUSPLUS=clang++ LD=clang LDPLUSPLUS=clang++ \
+            -derivedDataPath build -UseModernBuildSystem=YES \
+            -workspace NitroSQLiteExample.xcworkspace \
+            -scheme NitroSQLiteExample \
+            -sdk iphonesimulator \
+            -configuration Debug \
+            -destination "generic/platform=iOS Simulator" \
+            build \
+            CODE_SIGNING_ALLOWED=NO
+
+      - name: Run react-native-harness on iOS
+        uses: callstackincubator/react-native-harness@v1.2.0
+        with:
+          app: ios/build/Build/Products/Debug-iphonesimulator/NitroSQLiteExample.app
+          runner: ios
+          projectRoot: example
+          packageManager: bun

example/babel.config.js

@@ -10,8 +10,12 @@ module.exports = {
         extensions: ['.tsx', '.ts', '.js', '.json'],
         alias: {
           [pak.name]: path.join(__dirname, '../package', pak.source),
-          'stream': 'stream-browserify',
+          'crypto': 'react-native-quick-crypto',
+          'stream': 'readable-stream',
+          'buffer': 'react-native-quick-crypto',
           'react-native-sqlite-storage': 'react-native-nitro-sqlite',
+          '^@/(.+)': './src/\\1',
+          '^@tests/(.+)': './tests/\\1',
         },
       },
     ],

example/ios/Podfile.lock

@@ -26,6 +26,32 @@ PODS:
     - ReactCommon/turbomodule/core
     - ReactNativeDependencies
     - Yoga
+  - OpenSSL-Universal (3.6.2000)
+  - QuickCrypto (1.1.5):
+    - hermes-engine
+    - NitroModules
+    - OpenSSL-Universal (~> 3.6.2000)
+    - RCTRequired
+    - RCTTypeSafety
+    - React-callinvoker
+    - React-Core
+    - React-Core-prebuilt
+    - React-debug
+    - React-Fabric
+    - React-featureflags
+    - React-graphics
+    - React-ImageManager
+    - React-jsi
+    - React-NativeModulesApple
+    - React-RCTFabric
+    - React-renderercss
+    - React-rendererdebug
+    - React-utils
+    - ReactCodegen
+    - ReactCommon/turbomodule/bridging
+    - ReactCommon/turbomodule/core
+    - ReactNativeDependencies
+    - Yoga
   - RCTDeprecation (0.85.0-rc.0)
   - RCTRequired (0.85.0-rc.0)
   - RCTSwiftUI (0.85.0-rc.0)
@@ -1384,6 +1410,28 @@ PODS:
     - React-RCTFBReactNativeSpec
     - ReactCommon/turbomodule/core
     - ReactNativeDependencies
+  - react-native-quick-base64 (3.0.0):
+    - hermes-engine
+    - RCTRequired
+    - RCTTypeSafety
+    - React-Core
+    - React-Core-prebuilt
+    - React-debug
+    - React-Fabric
+    - React-featureflags
+    - React-graphics
+    - React-ImageManager
+    - React-jsi
+    - React-NativeModulesApple
+    - React-RCTFabric
+    - React-renderercss
+    - React-rendererdebug
+    - React-utils
+    - ReactCodegen
+    - ReactCommon/turbomodule/bridging
+    - ReactCommon/turbomodule/core
+    - ReactNativeDependencies
+    - Yoga
   - react-native-safe-area-context (5.6.2):
     - hermes-engine
     - RCTRequired
@@ -1936,6 +1984,7 @@ DEPENDENCIES:
   - FBLazyVector (from `../../node_modules/react-native/Libraries/FBLazyVector`)
   - hermes-engine (from `../../node_modules/react-native/sdks/hermes-engine/hermes-engine.podspec`)
   - NitroModules (from `../../node_modules/react-native-nitro-modules`)
+  - QuickCrypto (from `../../node_modules/react-native-quick-crypto`)
   - RCTDeprecation (from `../../node_modules/react-native/ReactApple/Libraries/RCTFoundation/RCTDeprecation`)
   - RCTRequired (from `../../node_modules/react-native/Libraries/Required`)
   - RCTSwiftUI (from `../../node_modules/react-native/ReactApple/RCTSwiftUI`)
@@ -1973,6 +2022,7 @@ DEPENDENCIES:
   - React-logger (from `../../node_modules/react-native/ReactCommon/logger`)
   - React-Mapbuffer (from `../../node_modules/react-native/ReactCommon`)
   - React-microtasksnativemodule (from `../../node_modules/react-native/ReactCommon/react/nativemodule/microtasks`)
+  - react-native-quick-base64 (from `../../node_modules/react-native-quick-base64`)
   - react-native-safe-area-context (from `../../node_modules/react-native-safe-area-context`)
   - React-NativeModulesApple (from `../../node_modules/react-native/ReactCommon/react/nativemodule/core/platform/ios`)
   - React-networking (from `../../node_modules/react-native/ReactCommon/react/networking`)
@@ -2013,6 +2063,10 @@ DEPENDENCIES:
   - RNScreens (from `../../node_modules/react-native-screens`)
   - Yoga (from `../../node_modules/react-native/ReactCommon/yoga`)
 
+SPEC REPOS:
+  trunk:
+    - OpenSSL-Universal
+
 EXTERNAL SOURCES:
   FBLazyVector:
     :path: "../../node_modules/react-native/Libraries/FBLazyVector"
@@ -2021,6 +2075,8 @@ EXTERNAL SOURCES:
     :tag: hermes-v250829098.0.10
   NitroModules:
     :path: "../../node_modules/react-native-nitro-modules"
+  QuickCrypto:
+    :path: "../../node_modules/react-native-quick-crypto"
   RCTDeprecation:
     :path: "../../node_modules/react-native/ReactApple/Libraries/RCTFoundation/RCTDeprecation"
   RCTRequired:
@@ -2093,6 +2149,8 @@ EXTERNAL SOURCES:
     :path: "../../node_modules/react-native/ReactCommon"
   React-microtasksnativemodule:
     :path: "../../node_modules/react-native/ReactCommon/react/nativemodule/microtasks"
+  react-native-quick-base64:
+    :path: "../../node_modules/react-native-quick-base64"
   react-native-safe-area-context:
     :path: "../../node_modules/react-native-safe-area-context"
   React-NativeModulesApple:
@@ -2176,6 +2234,8 @@ SPEC CHECKSUMS:
   FBLazyVector: 4ee5f665093abe339f4b579fc3d59f65c8af196c
   hermes-engine: 56e1f8e0c324283e1cc2c35f56dc6037c141f67d
   NitroModules: 587af3c2bc93f5c9f9b39aec315eb29509a7c537
+  OpenSSL-Universal: ecee7b138fa75a74ecf00d7ffd248fb584739b9e
+  QuickCrypto: 790e6537bb81a11d036a24ce3248b51f66857ceb
   RCTDeprecation: b73940ea69ab57c2c59f845b37b09e1d8b0d0588
   RCTRequired: f3a52c914af5f19f04d02b2091d83e43cf71676c
   RCTSwiftUI: 6dea7b613e8930a973b723c121aa8646374ee694
@@ -2212,6 +2272,7 @@ SPEC CHECKSUMS:
   React-logger: dbf8f36688ca7ccdb14cd2c2a9a738162fa87fbd
   React-Mapbuffer: 82c344b9a3dc807a40aefece0714587be25d7718
   React-microtasksnativemodule: c6299f5e04ba84779dc08f884caf8f42f370e9da
+  react-native-quick-base64: 740f0799082262a4f0a0001647288840bc54a3c4
   react-native-safe-area-context: 4b3960e27c8a3ca0c1523348f97513e27f8509b7
   React-NativeModulesApple: f8da6e477ffca7ad38869d16d7fd0b4289771f6a
   React-networking: 3b027fd335be928ee4ac5172937fe96729a6eb27

example/jest.config.js

@@ -0,0 +1,9 @@
+module.exports = {
+  projects: [
+    {
+      displayName: 'react-native-harness',
+      preset: 'react-native-harness',
+      testMatch: ['**/tests/**/*.harness.(js|jsx|ts|tsx)'],
+    },
+  ],
+}

example/metro.config.js

@@ -1,39 +1,10 @@
-const fs = require('fs')
 const path = require('path')
 const { getDefaultConfig, mergeConfig } = require('@react-native/metro-config')
 const pak = require('../package.json')
 
 const root = path.resolve(__dirname, '..')
 const modules = Object.keys({ ...pak.peerDependencies })
 
-function getPackageNames(nodeModulesPath) {
-  if (!fs.existsSync(nodeModulesPath)) {
-    return []
-  }
-
-  const allFiles = fs.readdirSync(nodeModulesPath)
-
-  // Filter out only directories (package names)
-  const packageNames = allFiles.filter((file) => {
-    const filePath = path.join(nodeModulesPath, file)
-    return fs.statSync(filePath).isDirectory()
-  })
-
-  // Handle scoped packages (e.g., @scope/package)
-  const scopedPackages = packageNames
-    .filter((pkg) => pkg.startsWith('@'))
-    .flatMap((scope) => {
-      const scopePath = path.join(nodeModulesPath, scope)
-      const scopedFiles = fs.readdirSync(scopePath)
-      return scopedFiles.map((scopedFile) => `${scope}/${scopedFile}`)
-    })
-
-  // Return both regular and scoped package names
-  return packageNames
-    .filter((pkg) => !pkg.startsWith('@'))
-    .concat(scopedPackages)
-}
-
 const config = {
   projectRoot: __dirname,
   watchFolders: [root],

example/package.json

@@ -10,10 +10,13 @@
     "pods": "cd ios && bundle exec pod install",
     "typecheck": "tsc --noEmit",
     "lint": "eslint \"**/*.{js,ts,tsx}\" --fix",
-    "codegen": "bun react-native codegen"
+    "codegen": "bun react-native codegen",
+    "test:harness": "react-native-harness",
+    "test:harness:android": "react-native-harness --harnessRunner android",
+    "test:harness:ios": "react-native-harness --harnessRunner ios"
   },
   "dependencies": {
-    "@craftzdog/react-native-buffer": "^6.0.5",
+    "@craftzdog/react-native-buffer": "^6.1.2",
     "@react-native-clipboard/clipboard": "^1.16.3",
     "@react-navigation/native": "^7.1.19",
     "@react-navigation/native-stack": "^7.6.2",
@@ -25,6 +28,8 @@
     "react-native": "0.85.0-rc.0",
     "react-native-nitro-modules": "*",
     "react-native-nitro-sqlite": "9.6.0",
+    "react-native-quick-base64": "^3.0.0",
+    "react-native-quick-crypto": "^1.1.5",
     "react-native-safe-area-context": "^5.5.2",
     "react-native-screens": "^4.18.0",
     "reflect-metadata": "^0.1.13",
@@ -50,6 +55,11 @@
     "@types/node": "^22.7.4",
     "@types/react": "^19.1.1",
     "@types/react-test-renderer": "^19.1.0",
+    "@react-native-harness/cli": "1.2.0",
+    "@react-native-harness/jest": "1.2.0",
+    "@react-native-harness/platform-android": "1.2.0",
+    "@react-native-harness/platform-apple": "1.2.0",
+    "react-native-harness": "1.2.0",
     "mocha": "^10.1.0",
     "postinstall-postinstall": "^2.1.0",
     "react-test-renderer": "19.1.1"