react-native-nitro-sqlite-vec 9.7.0

package/cpp/sqlite-vec/sqlite-vec.h

@@ -0,0 +1,41 @@
+#ifndef SQLITE_VEC_H
+#define SQLITE_VEC_H
+
+#ifndef SQLITE_CORE
+#include "sqlite3ext.h"
+#else
+#include "sqlite3.h"
+#endif
+
+#ifdef SQLITE_VEC_STATIC
+  #define SQLITE_VEC_API
+#else
+  #ifdef _WIN32
+    #define SQLITE_VEC_API __declspec(dllexport)
+  #else
+    #define SQLITE_VEC_API
+  #endif
+#endif
+
+#define SQLITE_VEC_VERSION "v0.1.9"
+// TODO rm
+#define SQLITE_VEC_DATE "2026-03-31T08:01:41Z+0000"
+#define SQLITE_VEC_SOURCE "e9f598abfa0c06b328d8fe5da9c3760cce74be10"
+
+
+#define SQLITE_VEC_VERSION_MAJOR 0
+#define SQLITE_VEC_VERSION_MINOR 1
+#define SQLITE_VEC_VERSION_PATCH 9
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+SQLITE_VEC_API int sqlite3_vec_init(sqlite3 *db, char **pzErrMsg,
+                  const sqlite3_api_routines *pApi);
+
+#ifdef __cplusplus
+}  /* end of the 'extern "C"' block */
+#endif
+
+#endif /* ifndef SQLITE_VEC_H */

package/package.json

@@ -0,0 +1,75 @@
+{
+  "name": "react-native-nitro-sqlite-vec",
+  "version": "9.7.0",
+  "description": "Vector search (sqlite-vec) for react-native-nitro-sqlite. Native sqlite-vec is statically linked into the core's single sqlite3 — no second SQLite, no runtime extension loading.",
+  "source": "./src/index",
+  "react-native": "./src/index",
+  "main": "./src/index",
+  "types": "./src/index",
+  "files": [
+    "src",
+    "cpp",
+    "RNNitroSqliteVec.podspec",
+    "react-native.config.js",
+    "README.md"
+  ],
+  "scripts": {
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint \"**/*.{js,ts,tsx}\" --fix",
+    "release": "release-it",
+    "prepublishOnly": "bun typecheck"
+  },
+  "keywords": [
+    "react-native",
+    "sqlite",
+    "sqlite-vec",
+    "vector",
+    "vector-search",
+    "nitro-modules",
+    "ios",
+    "android"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/margelo/react-native-nitro-sqlite.git"
+  },
+  "license": "MIT",
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/",
+    "access": "public"
+  },
+  "peerDependencies": {
+    "react-native-nitro-sqlite": ">=9.0.0"
+  },
+  "devDependencies": {
+    "react-native-nitro-sqlite": "9.7.0",
+    "typescript": "^5.8.3"
+  },
+  "release-it": {
+    "npm": {
+      "publish": true,
+      "skipChecks": true,
+      "versionArgs": [
+        "--allow-same-version"
+      ]
+    },
+    "git": false,
+    "github": {
+      "release": false
+    },
+    "hooks": {
+      "before:init": "bun typecheck"
+    },
+    "plugins": {
+      "@release-it/bumper": {
+        "out": {
+          "file": "package.json",
+          "path": [
+            "version",
+            "devDependencies.react-native-nitro-sqlite"
+          ]
+        }
+      }
+    }
+  }
+}

package/react-native.config.js

@@ -0,0 +1,9 @@
+// Android compiles these sources via the core's CMake, so autolink iOS only.
+module.exports = {
+  dependency: {
+    platforms: {
+      ios: {},
+      android: null,
+    },
+  },
+}

package/src/index.ts

@@ -0,0 +1,81 @@
+import type { NitroSQLiteConnection } from 'react-native-nitro-sqlite'
+
+/** Optional typed helpers over react-native-nitro-sqlite's execute() for sqlite-vec. */
+
+export type VectorColumnType = 'float' | 'int8' | 'bit'
+export type VectorDistanceMetric = 'L2' | 'cosine' | 'L1'
+
+/** A KNN result row: always `rowid` + `distance`, plus any selected columns. */
+export interface KnnMatch {
+  rowid: number
+  distance: number
+  [column: string]: unknown
+}
+
+export interface CreateVectorTableOptions {
+  /** Number of dimensions of the vector column. */
+  dimensions: number
+  /** Vector storage type. Defaults to `'float'` (float32). */
+  type?: VectorColumnType
+  /** Distance metric. Defaults to sqlite-vec's default (L2). */
+  distanceMetric?: VectorDistanceMetric
+  /** Vector column name. Defaults to `'embedding'`. */
+  column?: string
+}
+
+export interface KnnSearchOptions {
+  /** Vector column name. Defaults to `'embedding'`. */
+  column?: string
+}
+
+function firstValue<T>(db: NitroSQLiteConnection, sql: string): T {
+  const row = db.execute(sql).rows?._array?.[0]
+  return row?.value as T
+}
+
+/** Returns the linked sqlite-vec version string, e.g. `"v0.1.9"`. */
+export function vecVersion(db: NitroSQLiteConnection): string {
+  return firstValue<string>(db, 'SELECT vec_version() AS value')
+}
+
+/** True if sqlite-vec is linked into the active build (vector flag enabled). */
+export function isVecAvailable(db: NitroSQLiteConnection): boolean {
+  try {
+    vecVersion(db)
+    return true
+  } catch {
+    return false
+  }
+}
+
+/** Creates a `vec0` virtual table for the given vector column. */
+export function createVectorTable(
+  db: NitroSQLiteConnection,
+  table: string,
+  options: CreateVectorTableOptions,
+): void {
+  const column = options.column ?? 'embedding'
+  const type = options.type ?? 'float'
+  const metric = options.distanceMetric
+  const metricClause = metric ? ` distance_metric=${metric}` : ''
+  db.execute(
+    `CREATE VIRTUAL TABLE IF NOT EXISTS ${table} USING vec0(${column} ${type}[${options.dimensions}]${metricClause});`,
+  )
+}
+
+/** Runs a KNN search; `query` is a JSON string `'[0.1,0.2]'` or a numeric array. */
+export function knnSearch(
+  db: NitroSQLiteConnection,
+  table: string,
+  query: string | number[],
+  k: number,
+  options?: KnnSearchOptions,
+): KnnMatch[] {
+  const column = options?.column ?? 'embedding'
+  const vector = typeof query === 'string' ? query : JSON.stringify(query)
+  const result = db.execute(
+    `SELECT rowid, distance FROM ${table} WHERE ${column} MATCH ? AND k = ? ORDER BY distance`,
+    [vector, k],
+  )
+  return (result.rows?._array ?? []) as unknown as KnnMatch[]
+}