Prepare release

Author: simolus3

README.md

@@ -9,6 +9,9 @@ It can be used both in Flutter apps or in standalone Dart applications.
 The `sqlite3_flutter_libs` and `sqlcipher_flutter_libs` packages contain no Dart code at all. Flutter users can depend
 on one of them to include native libraries in their apps.
 
+An experimental alternative to `sqlite3_flutter_libs` based on [native assets](https://dart.dev/interop/c-interop#native-assets)
+is available with the `sqlite3_native_assets` package.
+
 `package:sqlite3_test` contains utilities that make integrating SQLite databases into Dart tests easier.
 In particular, they patch `CURRENT_TIMESTAMP` and related constructs to return the (potentially faked) time
 returned by `package:clock`.

sqlite3/lib/sqlite3_native_library.dart

@@ -0,0 +1,21 @@
+import 'dart:ffi';
+
+import 'package:meta/meta.dart';
+
+import 'ffi/api.dart';
+import 'ffi/implementation.dart';
+
+/// A version of [sqlite3] that uses FFI bindings backed by [native assets]
+/// instead of opening a [DynamicLibrary].
+///
+/// When used together with the `sqlite3_native_assets` package, using these
+/// bindings guarantees that a version of the SQLite library is included with
+/// your app. This means that `sqlite3_flutter_libs` is no longer required.
+/// Also, this build works on all Dart platforms and does not require Flutter.
+///
+/// Using these bindings is experimental (since native assets in Dart are an
+/// experimental feature).
+///
+/// [native assets](https://dart.dev/interop/c-interop#native-assets)
+@experimental
+final Sqlite3 sqlite3Native = FfiSqlite3.nativeAssets();

sqlite3/lib/src/sqlite3_native_library.dart

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Simon Binder
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

sqlite3_native_assets/LICENSE

@@ -1,3 +1,4 @@
+import 'dart:convert';
 import 'dart:io';
 
 import 'package:archive/archive.dart';
@@ -27,6 +28,7 @@ void main(List<String> args) async {
       name: 'sqlite3',
       assetName: 'sqlite3_native_assets.dart',
       sources: [source.toFilePath()],
+      defines: collectDefines(),
     );
 
     await builder.run(
@@ -55,3 +57,42 @@ final class _IgnoreSourceDependency extends BuildOutputBuilder {
     super.addDependencies(uris.where((e) => url.extension(e.path) != '.c'));
   }
 }
+
+// Note: Keep in sync with https://github.com/simolus3/sqlite-native-libraries/blob/master/sqlite3-native-library/cpp/CMakeLists.txt
+const _defines = '''
+  SQLITE_ENABLE_DBSTAT_VTAB
+  SQLITE_ENABLE_FTS5
+  SQLITE_ENABLE_RTREE
+  SQLITE_DQS=0
+  SQLITE_DEFAULT_MEMSTATUS=0
+  SQLITE_TEMP_STORE=2
+  SQLITE_MAX_EXPR_DEPTH=0
+  SQLITE_STRICT_SUBTYPE=1
+  SQLITE_OMIT_AUTHORIZATION
+  SQLITE_OMIT_DECLTYPE
+  SQLITE_OMIT_DEPRECATED
+  SQLITE_OMIT_PROGRESS_CALLBACK
+  SQLITE_OMIT_SHARED_CACHE
+  SQLITE_OMIT_TCL_VARIABLE
+  SQLITE_OMIT_TRACE
+  SQLITE_USE_ALLOCA
+  SQLITE_UNTESTABLE
+  SQLITE_HAVE_ISNAN
+  SQLITE_HAVE_LOCALTIME_R
+  SQLITE_HAVE_LOCALTIME_S
+  SQLITE_HAVE_MALLOC_USABLE_SIZE
+  SQLITE_HAVE_STRCHRNUL
+''';
+
+Map<String, String?> collectDefines() {
+  final entries = <String, String?>{};
+  for (final line in const LineSplitter().convert(_defines)) {
+    if (line.contains('=')) {
+      final [key, value] = line.trim().split('=');
+      entries[key] = value;
+    } else {
+      entries[line.trim()] = null;
+    }
+  }
+  return entries;
+}

sqlite3_native_assets/hook/build.dart

@@ -1 +1 @@
-export 'package:sqlite3/sqlite3_native_library.dart';
+export 'package:sqlite3/src/sqlite3_native_library.dart';

sqlite3_native_assets/lib/sqlite3_native_assets.dart

@@ -0,0 +1,28 @@
+import 'package:sqlite3/sqlite3.dart';
+import 'package:sqlite3_native_assets/sqlite3_native_assets.dart';
+import 'package:test/test.dart';
+
+void main() {
+  final sqlite3 = sqlite3Native;
+  late Database database;
+
+  setUp(() => database = sqlite3.openInMemory());
+  tearDown(() => database.dispose());
+
+  group('compiled sqlite3', () {
+    test('enables fts5', () {
+      database.execute('CREATE VIRTUAL TABLE foo USING fts5(a, b, c);');
+    });
+
+    test('enables rtree', () {
+      database.execute('CREATE VIRTUAL TABLE foo USING rtree(a, b, c);');
+    });
+
+    test('disables double-quoted string literals by default', () {
+      expect(
+        () => database.execute('SELECT "not a string";'),
+        throwsA(isA<SqliteException>()),
+      );
+    });
+  });
+}