expo-sqlite 58.0.5 → 58.0.6

package/ios/Benchmarks/StatementBenchmarks.swift

@@ -0,0 +1,179 @@
+// Copyright 2026-present 650 Industries. All rights reserved.
+
+import ExpoModulesTestCore
+import Testing
+
+@testable import ExpoModulesCore
+@testable import ExpoSQLite
+
+/// SQLite copies a bound text before `bind` returns, as the module does for every text parameter.
+private let sqliteTransient = unsafeBitCast(OpaquePointer(bitPattern: -1), to: sqlite3_destructor_type.self)
+
+/// Native-only benchmarks: the raw SQLite C API on one side, the Swift members of `NativeDatabase`
+/// and `NativeStatement` on the other. Reading them side by side isolates the cost the Swift layer
+/// adds (string bridging, the statement semaphore, error checks) from the cost of SQLite itself.
+extension Benchmarks {
+  /// Opens a seeded in-memory database through the C API and wraps it the way the module does.
+  /// Setup failures stop the case, so a broken handle is never timed.
+  private func openDatabase() throws -> NativeDatabase {
+    var pointer: OpaquePointer?
+    try #require(exsqlite3_open(":memory:", &pointer) == SQLITE_OK)
+    try #require(exsqlite3_exec(pointer, BenchmarkSchema.setup(), nil, nil, nil) == SQLITE_OK)
+    return NativeDatabase(pointer, databasePath: ":memory:", openOptions: OpenDatabaseOptions())
+  }
+
+  private func prepare(_ source: String, in database: NativeDatabase) throws -> OpaquePointer? {
+    var statement: OpaquePointer?
+    try #require(exsqlite3_prepare_v2(database.pointer, source, -1, &statement, nil) == SQLITE_OK)
+    return statement
+  }
+
+  /// Touches every column of the current row the way `getColumnValue` does, without allocating.
+  private func readRow(_ statement: OpaquePointer?) {
+    for column in 0..<Int32(BenchmarkSchema.columnCount) {
+      switch exsqlite3_column_type(statement, column) {
+      case SQLITE_INTEGER:
+        _ = exsqlite3_column_int64(statement, column)
+      case SQLITE_FLOAT:
+        _ = exsqlite3_column_double(statement, column)
+      case SQLITE_TEXT:
+        _ = exsqlite3_column_text(statement, column)
+        _ = exsqlite3_column_bytes(statement, column)
+      default:
+        break
+      }
+    }
+  }
+
+  // MARK: - SQLite floor
+
+  @Test
+  func `raw C: select one row by id`() async throws {
+    try await sqliteBenchmarkCase { appContext in
+      let database = try openDatabase()
+      let runtime = try appContext.runtime
+      let statement = try prepare("SELECT \(BenchmarkSchema.selectColumns) FROM t WHERE id = ?", in: database)
+      benchmark("raw C: select 1 row by id", runtime: runtime) { iterations in
+        for i in 0..<iterations {
+          exsqlite3_bind_int64(statement, 1, Int64(i % BenchmarkSchema.rowCount) + 1)
+          _ = exsqlite3_step(statement)
+          readRow(statement)
+          exsqlite3_reset(statement)
+        }
+      }
+      exsqlite3_finalize(statement)
+      exsqlite3_close(database.pointer)
+    }
+  }
+
+  @Test
+  func `raw C: select 100 rows`() async throws {
+    try await sqliteBenchmarkCase { appContext in
+      let database = try openDatabase()
+      let runtime = try appContext.runtime
+      let statement = try prepare("SELECT \(BenchmarkSchema.selectColumns) FROM t WHERE id <= 100", in: database)
+      benchmark("raw C: select 100 rows, read every cell", runtime: runtime) { iterations in
+        for _ in 0..<iterations {
+          while exsqlite3_step(statement) == SQLITE_ROW {
+            readRow(statement)
+          }
+          exsqlite3_reset(statement)
+        }
+      }
+      exsqlite3_finalize(statement)
+      exsqlite3_close(database.pointer)
+    }
+  }
+
+  @Test
+  func `raw C: insert with bound parameters`() async throws {
+    try await sqliteBenchmarkCase { appContext in
+      let database = try openDatabase()
+      let runtime = try appContext.runtime
+      let statement = try prepare(
+        "INSERT INTO t (int_value, real_value, text_value, null_value) VALUES (?, ?, ?, ?)",
+        in: database
+      )
+      benchmark("raw C: insert with 4 bound parameters", runtime: runtime) { iterations in
+        for i in 0..<iterations {
+          exsqlite3_bind_int64(statement, 1, Int64(i))
+          exsqlite3_bind_double(statement, 2, 1.5)
+          exsqlite3_bind_text(statement, 3, "row", -1, sqliteTransient)
+          exsqlite3_bind_null(statement, 4)
+          _ = exsqlite3_step(statement)
+          exsqlite3_reset(statement)
+          exsqlite3_clear_bindings(statement)
+        }
+      }
+      exsqlite3_finalize(statement)
+      exsqlite3_close(database.pointer)
+    }
+  }
+
+  @Test
+  func `raw C: prepare and finalize`() async throws {
+    try await sqliteBenchmarkCase { appContext in
+      let database = try openDatabase()
+      let runtime = try appContext.runtime
+      let source = "SELECT \(BenchmarkSchema.selectColumns) FROM t WHERE id = 1"
+      benchmark("raw C: prepare + finalize", runtime: runtime) { iterations in
+        for _ in 0..<iterations {
+          var statement: OpaquePointer?
+          exsqlite3_prepare_v2(database.pointer, source, -1, &statement, nil)
+          exsqlite3_finalize(statement)
+        }
+      }
+      exsqlite3_close(database.pointer)
+    }
+  }
+
+  // MARK: - Swift members
+
+  @Test
+  func `Swift: prepare and finalize through the shared objects`() async throws {
+    try await sqliteBenchmarkCase { appContext in
+      let database = try openDatabase()
+      let runtime = try appContext.runtime
+      let source = "SELECT \(BenchmarkSchema.selectColumns) FROM t WHERE id = 1"
+      try benchmark("Swift: prepareSync + finalizeSync", runtime: runtime) { iterations in
+        for _ in 0..<iterations {
+          let statement = NativeStatement()
+          try database.prepareSync(statement: statement, source: source)
+          try statement.finalizeSync(database: database)
+        }
+      }
+      exsqlite3_close(database.pointer)
+    }
+  }
+
+  @Test
+  func `Swift: column names of a prepared statement`() async throws {
+    try await sqliteBenchmarkCase { appContext in
+      let database = try openDatabase()
+      let runtime = try appContext.runtime
+      let statement = NativeStatement()
+      try database.prepareSync(statement: statement, source: "SELECT \(BenchmarkSchema.selectColumns) FROM t")
+      try benchmark("Swift: getColumnNamesSync (5 columns)", runtime: runtime) { iterations in
+        for _ in 0..<iterations {
+          _ = try statement.getColumnNamesSync()
+        }
+      }
+      try statement.finalizeSync(database: database)
+      exsqlite3_close(database.pointer)
+    }
+  }
+
+  @Test
+  func `Swift: exec a trivial statement`() async throws {
+    try await sqliteBenchmarkCase { appContext in
+      let database = try openDatabase()
+      let runtime = try appContext.runtime
+      try benchmark("Swift: execSync('SELECT 1')", runtime: runtime) { iterations in
+        for _ in 0..<iterations {
+          try database.execSync(source: "SELECT 1")
+        }
+      }
+      exsqlite3_close(database.pointer)
+    }
+  }
+}

package/ios/ExpoSQLite.podspec

@@ -71,7 +71,7 @@ Pod::Spec.new do |s|
     'OTHER_SWIFT_FLAGS' => '$(inherited) ' + swift_flags,
   }
   s.source_files = "**/*.{c,h,m,swift}"
-  s.exclude_files = 'Tests'
+  s.exclude_files = ['Tests', 'Benchmarks']
 
   s.test_spec 'Tests' do |test_spec|
     test_spec.source_files = 'Tests'
@@ -81,6 +81,16 @@ Pod::Spec.new do |s|
     }
   end
 
+  # Performance benchmarks, run with `et native-unit-tests --benchmarks`. A separate spec, so unit
+  # test runs neither build nor run them.
+  s.test_spec 'Benchmarks' do |test_spec|
+    test_spec.dependency 'ExpoModulesTestCore'
+    test_spec.source_files = 'Benchmarks'
+    test_spec.pod_target_xcconfig = {
+      'OTHER_LDFLAGS' => '-lc++'
+    }
+  end
+
   vendored_frameworks = []
   if podfile_properties['expo.sqlite.withSQLiteVecExtension'] == 'true'
     vendored_frameworks << 'vec.xcframework'

package/local-maven-repo/host/exp/exponent/expo.modules.sqlite/58.0.6/expo.modules.sqlite-58.0.6.aar.md5

@@ -0,0 +1 @@
+9f080a8e1988c421d1a8b4924f22d9e7

package/local-maven-repo/host/exp/exponent/expo.modules.sqlite/58.0.6/expo.modules.sqlite-58.0.6.aar.sha1

@@ -0,0 +1 @@
+fb36d4e50b96cfa380e237fa8928ef37f43c803d

package/local-maven-repo/host/exp/exponent/expo.modules.sqlite/58.0.6/expo.modules.sqlite-58.0.6.aar.sha256

@@ -0,0 +1 @@
+266464ed51aaf1540662e2899733dd20a685ae8d76e3c565080c7877f0afbe63

package/local-maven-repo/host/exp/exponent/expo.modules.sqlite/58.0.6/expo.modules.sqlite-58.0.6.aar.sha512

@@ -0,0 +1 @@
+90ae6801b8ad8f297e08d7e680dc986ec7abefd25c1818f27e41eea17a68d1c4f7f7d249f161ac80d30deb9b2a1e7cca957b41a83dcb7ca49927fb28d741d5e4

package/local-maven-repo/host/exp/exponent/expo.modules.sqlite/{58.0.5/expo.modules.sqlite-58.0.5.module → 58.0.6/expo.modules.sqlite-58.0.6.module}

@@ -3,7 +3,7 @@
   "component": {
     "group": "host.exp.exponent",
     "module": "expo.modules.sqlite",
-    "version": "58.0.5",
+    "version": "58.0.6",
     "attributes": {
       "org.gradle.status": "release"
     }
@@ -24,13 +24,13 @@
       },
       "files": [
         {
-          "name": "expo.modules.sqlite-58.0.5.aar",
-          "url": "expo.modules.sqlite-58.0.5.aar",
+          "name": "expo.modules.sqlite-58.0.6.aar",
+          "url": "expo.modules.sqlite-58.0.6.aar",
           "size": 3960770,
-          "sha512": "01dbc41973b2ebae1772a5edc24e2e80ebbc3fef8f43a49a0c6d525d06af00dc2cf46c5e104387a2f59f252b632756f7c0e4dc05f231c91ec43676df88ef56f1",
-          "sha256": "66e4488bd02141346b04a8bc40fd3880143470b69d1f12b2897b6ab9e90650e9",
-          "sha1": "124eae424bb185c8a6c6f9ad3d808337ffa285c1",
-          "md5": "d952f01aa0c2b9341bd46b742afea2f3"
+          "sha512": "90ae6801b8ad8f297e08d7e680dc986ec7abefd25c1818f27e41eea17a68d1c4f7f7d249f161ac80d30deb9b2a1e7cca957b41a83dcb7ca49927fb28d741d5e4",
+          "sha256": "266464ed51aaf1540662e2899733dd20a685ae8d76e3c565080c7877f0afbe63",
+          "sha1": "fb36d4e50b96cfa380e237fa8928ef37f43c803d",
+          "md5": "9f080a8e1988c421d1a8b4924f22d9e7"
         }
       ]
     },
@@ -61,19 +61,19 @@
           "group": "io.github.expo.pika",
           "module": "pika-api",
           "version": {
-            "requires": "1.0.0"
+            "requires": "1.1.0"
           }
         }
       ],
       "files": [
         {
-          "name": "expo.modules.sqlite-58.0.5.aar",
-          "url": "expo.modules.sqlite-58.0.5.aar",
+          "name": "expo.modules.sqlite-58.0.6.aar",
+          "url": "expo.modules.sqlite-58.0.6.aar",
           "size": 3960770,
-          "sha512": "01dbc41973b2ebae1772a5edc24e2e80ebbc3fef8f43a49a0c6d525d06af00dc2cf46c5e104387a2f59f252b632756f7c0e4dc05f231c91ec43676df88ef56f1",
-          "sha256": "66e4488bd02141346b04a8bc40fd3880143470b69d1f12b2897b6ab9e90650e9",
-          "sha1": "124eae424bb185c8a6c6f9ad3d808337ffa285c1",
-          "md5": "d952f01aa0c2b9341bd46b742afea2f3"
+          "sha512": "90ae6801b8ad8f297e08d7e680dc986ec7abefd25c1818f27e41eea17a68d1c4f7f7d249f161ac80d30deb9b2a1e7cca957b41a83dcb7ca49927fb28d741d5e4",
+          "sha256": "266464ed51aaf1540662e2899733dd20a685ae8d76e3c565080c7877f0afbe63",
+          "sha1": "fb36d4e50b96cfa380e237fa8928ef37f43c803d",
+          "md5": "9f080a8e1988c421d1a8b4924f22d9e7"
         }
       ]
     },
@@ -87,8 +87,8 @@
       },
       "files": [
         {
-          "name": "expo.modules.sqlite-58.0.5-sources.jar",
-          "url": "expo.modules.sqlite-58.0.5-sources.jar",
+          "name": "expo.modules.sqlite-58.0.6-sources.jar",
+          "url": "expo.modules.sqlite-58.0.6-sources.jar",
           "size": 11821,
           "sha512": "7584658ab5c9dd4f06e3445b056b83007c6fc6162cdda3b3df67bb9b7ec45e17d686903a37feae801ee8b966ed1bd36de9386d739c783bbaec65391dbaa6dc65",
           "sha256": "a4b537cf4b334950fc82e5d251599ed7b3bc6d5c2410a3fdca38b81650fe27c2",

package/local-maven-repo/host/exp/exponent/expo.modules.sqlite/58.0.6/expo.modules.sqlite-58.0.6.module.md5

@@ -0,0 +1 @@
+834aa428493119ef46f7e1586dc7c917

package/local-maven-repo/host/exp/exponent/expo.modules.sqlite/58.0.6/expo.modules.sqlite-58.0.6.module.sha1

@@ -0,0 +1 @@
+608893dd534f1b20bb25be3f72957c1689b2aa81

package/local-maven-repo/host/exp/exponent/expo.modules.sqlite/58.0.6/expo.modules.sqlite-58.0.6.module.sha256

@@ -0,0 +1 @@
+b564b0cea268984f0de3a5623b684066f579231c816b69c4400c17760dbf88ba

package/local-maven-repo/host/exp/exponent/expo.modules.sqlite/58.0.6/expo.modules.sqlite-58.0.6.module.sha512

@@ -0,0 +1 @@
+9e6186b07489ddf47b29a232edd70de19e5cd85f0d12f4dd4365fe36275973db4aaa29ae1b1921a7110fe319d5f1c420a654abbe9ce3f90cd659ae050da9ebb4

package/local-maven-repo/host/exp/exponent/expo.modules.sqlite/{58.0.5/expo.modules.sqlite-58.0.5.pom → 58.0.6/expo.modules.sqlite-58.0.6.pom}

@@ -9,7 +9,7 @@
   <modelVersion>4.0.0</modelVersion>
   <groupId>host.exp.exponent</groupId>
   <artifactId>expo.modules.sqlite</artifactId>
-  <version>58.0.5</version>
+  <version>58.0.6</version>
   <packaging>aar</packaging>
   <name>expo.modules.sqlite</name>
   <url>https://github.com/expo/expo</url>
@@ -52,7 +52,7 @@
     <dependency>
       <groupId>io.github.expo.pika</groupId>
       <artifactId>pika-api</artifactId>
-      <version>1.0.0</version>
+      <version>1.1.0</version>
       <scope>runtime</scope>
     </dependency>
   </dependencies>

package/local-maven-repo/host/exp/exponent/expo.modules.sqlite/58.0.6/expo.modules.sqlite-58.0.6.pom.md5

@@ -0,0 +1 @@
+1fee310e178f1cb39871e47dde6f398c

package/local-maven-repo/host/exp/exponent/expo.modules.sqlite/58.0.6/expo.modules.sqlite-58.0.6.pom.sha1

@@ -0,0 +1 @@
+9ea6a502d3d51d66598a07c2f62d21ebb50718c2

package/local-maven-repo/host/exp/exponent/expo.modules.sqlite/58.0.6/expo.modules.sqlite-58.0.6.pom.sha256

@@ -0,0 +1 @@
+da6ffa008ecf889ceccba8fcb89c57904a1ed081145c38f9193023d63ed7f9b3

package/local-maven-repo/host/exp/exponent/expo.modules.sqlite/58.0.6/expo.modules.sqlite-58.0.6.pom.sha512

@@ -0,0 +1 @@
+cef7c7d2ad409cc57ca6b94a41b1936f17bf0129da56ccd3dbd838f5d4806f8fbca5f294076a28921d2bba407860504670cff9527f974ca025cef78dae9cd0d0

package/local-maven-repo/host/exp/exponent/expo.modules.sqlite/maven-metadata.xml

@@ -3,11 +3,11 @@
   <groupId>host.exp.exponent</groupId>
   <artifactId>expo.modules.sqlite</artifactId>
   <versioning>
-    <latest>58.0.5</latest>
-    <release>58.0.5</release>
+    <latest>58.0.6</latest>
+    <release>58.0.6</release>
     <versions>
-      <version>58.0.5</version>
+      <version>58.0.6</version>
     </versions>
-    <lastUpdated>20260923154051</lastUpdated>
+    <lastUpdated>20260925081301</lastUpdated>
   </versioning>
 </metadata>

package/local-maven-repo/host/exp/exponent/expo.modules.sqlite/maven-metadata.xml.md5

@@ -1 +1 @@
-3f54b2575a7c6a0e36224bc210e94607
+ad20fede4a2356940cad82ee6018e26c

package/local-maven-repo/host/exp/exponent/expo.modules.sqlite/maven-metadata.xml.sha1

@@ -1 +1 @@
-b113211e3e2dc200852368e8b5bb226c709a8ac3
+e89fdb8d4ec5ee2c55e7479e234df8b2bc3f61f0

package/local-maven-repo/host/exp/exponent/expo.modules.sqlite/maven-metadata.xml.sha256

@@ -1 +1 @@
-0386c4a4644ff3a2ebfbf91ba3c54af9f1554d3b9c3d1189105f236c5ffea511
+be15405366c5203e1bc0fd22397f78ea304ed00cbedeeec10f01b3e8a77a4a90

package/local-maven-repo/host/exp/exponent/expo.modules.sqlite/maven-metadata.xml.sha512

@@ -1 +1 @@
-b460eea8589b53b7416c6431def8a0fb4fa5deeda88b80fb3da09d951e57f2788c2baf4ca56f5220b3bc0316a774841af9f18c142348b7223ec46e63f095c9d7
+bd5aee16d6c557fa59fe0f94c04c3981044d83c09a15a5b899bb922086aa8c2af3cff2c7e39c4e730d51e370ce2e56f2097426da43f6d559c9e3b00ba929eea6

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "expo-sqlite",
-  "version": "58.0.5",
+  "version": "58.0.6",
   "description": "Provides access to a database using SQLite (https://www.sqlite.org/). The database is persisted across restarts of your app.",
   "keywords": [
     "async-storage",
@@ -55,7 +55,7 @@
     "@types/jest": "^29.2.1",
     "@types/node": "^22.14.0",
     "@types/react": "~19.3.0",
-    "expo": "58.0.0-preview.6",
+    "expo": "58.0.0-preview.7",
     "expo-module-scripts": "56.0.3",
     "react-error-boundary": "^4.0.11",
     "tar": "^7.5.22"
@@ -68,7 +68,7 @@
   "jest": {
     "preset": "expo-module-scripts"
   },
-  "gitHead": "8aeb4368d396d2d71a2fc8c652c4d1d4d53ed858",
+  "gitHead": "ad41d067bd3df6dd12f1788acc6b54a68e7a650d",
   "scripts": {
     "build": "pnpm run build:lib && pnpm run build:plugin",
     "build:lib": "expo-build src",

package/spm.config.json

@@ -39,6 +39,7 @@
           "name": "ExpoSQLite",
           "path": "ios",
           "pattern": "**/*.swift",
+          "exclude": ["Benchmarks/**"],
           "dependencies": [
             "ReactNativeDependencies",
             "React",