feat(sqlite-vec): vector search (#285)

* feat(sqlite-vec): vector search via statically-linked sqlite-vec

Add react-native-nitro-sqlite-vec: a companion package vendoring the
sqlite-vec v0.1.9 amalgamation. Its native sources compile INTO the core
react-native-nitro-sqlite library's single sqlite3 build and register via
sqlite3_auto_extension — no second sqlite3, no runtime extension loading.
Vector search runs through the core's existing execute() API (vec0 +
vec_* functions); thin typed helpers (vecVersion/createVectorTable/
knnSearch) are included.

Core integration:
- Android: CMakeLists/build.gradle flag-gated compilation of the
  companion's sqlite-vec.c (-DSQLITE_CORE -DSQLITE_VEC_STATIC), enabled
  in the example via gradle.properties `nitroSqliteVec=true`.
- iOS: companion RNNitroSqliteVec.podspec, static-linked into the core's
  single sqlite3 through the core podspec.
- operations.cpp registers the extension once in sqliteOpenDb
  (#ifdef NITRO_SQLITE_VEC); bindStatement binds whole-number JS values
  as INTEGER (vec0 rowid/pk/partition require INTEGER); sqliteExecuteBatch
  fixes a double-rollback that masked the real batch error.

Testing: on-device React Native Harness spec
(example/tests/harness/sqlite-vec.harness.ts) covering vec_* scalar
functions, distance metrics, vec0 KNN (float32/int8/bit), metadata
filtering, partition keys, auxiliary columns, and UPDATE/DELETE.

* fix: comments

* fix: prettier

* chore: update `Podfile.lock`

* fix: enable sqlite-vec in example project

---------

Co-authored-by: Christoph Pader <chris@margelo.com>

Author: riteshshukla04

.claude/settings.local.json

@@ -1,8 +1,5 @@
 {
   "permissions": {
-    "allow": [
-      "Bash(find:*)",
-      "Bash(grep:*)"
-    ]
+    "allow": ["Bash(find:*)", "Bash(grep:*)"]
   }
 }

bun.lock

@@ -42,3 +42,6 @@ hermesEnabled=true
 # This allows your app to draw behind system bars for an immersive UI.
 # Note: Only works with ReactActivity and should not be used with custom Activity.
 edgeToEdgeEnabled=false
+
+# Compile react-native-nitro-sqlite-vec into the core library (opt-in).
+nitroSqliteVec=true

example/android/gradle.properties

@@ -1,5 +1,6 @@
 ENV['RCT_NEW_ARCH_ENABLED'] = '1'
 ENV['USE_FRAMEWORKS'] = "static"
+ENV['NITRO_SQLITE_VEC'] = '1'
 
 # Resolve react_native_pods.rb with node to allow for hoisting
 require Pod::Executable.execute_command('node', ['-p',

example/ios/Podfile

@@ -1931,6 +1931,8 @@ PODS:
     - ReactCommon/turbomodule/core
     - ReactNativeDependencies
     - Yoga
+  - RNNitroSqliteVec (9.6.0):
+    - RNNitroSQLite
   - RNScreens (4.18.0):
     - hermes-engine
     - RCTRequired
@@ -2060,6 +2062,7 @@ DEPENDENCIES:
   - ReactNativeDependencies (from `../../node_modules/react-native/third-party-podspecs/ReactNativeDependencies.podspec`)
   - "RNCClipboard (from `../../node_modules/@react-native-clipboard/clipboard`)"
   - RNNitroSQLite (from `../../packages/react-native-nitro-sqlite`)
+  - RNNitroSqliteVec (from `../../node_modules/react-native-nitro-sqlite-vec`)
   - RNScreens (from `../../node_modules/react-native-screens`)
   - Yoga (from `../../node_modules/react-native/ReactCommon/yoga`)
 
@@ -2225,6 +2228,8 @@ EXTERNAL SOURCES:
     :path: "../../node_modules/@react-native-clipboard/clipboard"
   RNNitroSQLite:
     :path: "../../packages/react-native-nitro-sqlite"
+  RNNitroSqliteVec:
+    :path: "../../node_modules/react-native-nitro-sqlite-vec"
   RNScreens:
     :path: "../../node_modules/react-native-screens"
   Yoga:
@@ -2309,10 +2314,11 @@ SPEC CHECKSUMS:
   ReactCommon: 7525e252c88d254545e3fdaea0000d1959dfbf20
   ReactNativeDependencies: 0cdc5c6985700a9d8f654762fa702169ef9cef9b
   RNCClipboard: 7a7d4557bfd3370b35c99dfecd92ae7b9fc4948a
-  RNNitroSQLite: d4dcda5cae90531900839746ca2009e1db222793
+  RNNitroSQLite: bad203a8435c5d843534398dc4822b3e80fbbd81
+  RNNitroSqliteVec: cca5db2aec2a31f4e26a911bda7cac8fc2cdc2e2
   RNScreens: dd5c879d56b543c7ff8e593739eeb66093d60263
   Yoga: d68c8a4bde0af9c17b15540fffa330d26398d150
 
-PODFILE CHECKSUM: efa901d259f2a40103bc359243a7632881296bf1
+PODFILE CHECKSUM: 6933dbd8b4eea93df54a57c95e03351734e37a5b
 
 COCOAPODS: 1.15.2

example/ios/Podfile.lock

@@ -28,6 +28,7 @@
     "react-native": "0.85.0-rc.0",
     "react-native-nitro-modules": "*",
     "react-native-nitro-sqlite": "9.6.0",
+    "react-native-nitro-sqlite-vec": "*",
     "react-native-quick-base64": "^3.0.0",
     "react-native-quick-crypto": "^1.1.5",
     "react-native-safe-area-context": "^5.5.2",

example/package.json

@@ -2,14 +2,22 @@ import React, { useEffect, useState } from 'react'
 import { FlatList, StyleSheet, Text } from 'react-native'
 import type { MochaTestResult } from '@tests/MochaSetup'
 import { runTests } from '@tests/MochaSetup'
-import { registerUnitTests, registerTypeORMUnitTests } from '@tests/unit'
+import {
+  registerUnitTests,
+  registerTypeORMUnitTests,
+  registerSqliteVecUnitTests,
+} from '@tests/unit'
 
 export function UnitTestScreen() {
   const [results, setResults] = useState<MochaTestResult[]>([])
 
   useEffect(() => {
     setResults([])
-    runTests(registerUnitTests, registerTypeORMUnitTests).then(setResults)
+    runTests(
+      registerUnitTests,
+      registerTypeORMUnitTests,
+      registerSqliteVecUnitTests,
+    ).then(setResults)
   }, [])
 
   return (

example/src/screens/UnitTestScreen.tsx

@@ -0,0 +1,6 @@
+import '@/initGlobals'
+import { registerSqliteVecUnitTests } from '@tests/unit'
+import init from './init'
+
+init()
+registerSqliteVecUnitTests()

example/tests/harness/sqlite-vec.harness.ts

@@ -5,6 +5,7 @@ import registerTransactionUnitTests from './specs/operations/transaction.spec'
 import registerExecuteBatchUnitTests from './specs/operations/executeBatch.spec'
 import registerTypeORMUnitTestsSpecs from './specs/typeorm.spec'
 import registerDatabaseQueueUnitTests from './specs/DatabaseQueue.spec'
+import registerSqliteVecUnitTestsSpecs from './specs/sqlite-vec.spec'
 
 export function registerUnitTests() {
   beforeEach(setupTestDb)
@@ -21,3 +22,7 @@ export function registerUnitTests() {
 export function registerTypeORMUnitTests() {
   registerTypeORMUnitTestsSpecs()
 }
+
+export function registerSqliteVecUnitTests() {
+  registerSqliteVecUnitTestsSpecs()
+}