feat: make WAL and busy_timeout configurable for drift connections

Author: SERDUN

packages/data/app_database/lib/src/connection/native.dart

@@ -4,7 +4,13 @@ import 'package:drift/drift.dart';
 import 'package:drift/native.dart';
 import 'package:path/path.dart' show join;
 
-DatabaseConnection createAppDatabaseConnection(String? path, String name, {bool logStatements = false}) {
+DatabaseConnection createAppDatabaseConnection(
+  String? path,
+  String name, {
+  bool logStatements = false,
+  bool isWalEnabled = true,
+  int? busyTimeoutMilliseconds = 5000,
+}) {
   return DatabaseConnection.delayed(
     Future.sync(() async {
       final databasePath = join(path ?? '', name);
@@ -15,15 +21,14 @@ DatabaseConnection createAppDatabaseConnection(String? path, String name, {bool
         setup: (database) {
           // Enables Write-Ahead Logging (WAL) mode.
           // In default mode (DELETE journal), readers block writers and writers block readers.
-          // WAL allows simultaneous readers and writers, which is crucial for
-          // concurrent access from the UI isolate and Background isolate.
-          database.execute('PRAGMA journal_mode=WAL;');
+          if (isWalEnabled) {
+            database.execute('PRAGMA journal_mode=WAL;');
+          }
 
           // Sets a timeout (in milliseconds) for waiting when the database is locked.
-          // By default, SQLite throws an error immediately if the DB is busy (SQLITE_BUSY).
-          // Setting a timeout allows the driver to automatically retry the operation
-          // for up to 5 seconds before failing, handling short-lived locks gracefully.
-          database.execute('PRAGMA busy_timeout=5000;');
+          if (busyTimeoutMilliseconds != null) {
+            database.execute('PRAGMA busy_timeout=$busyTimeoutMilliseconds;');
+          }
         },
       );
 

packages/data/app_database/lib/src/connection/unsupported.dart

@@ -1,5 +1,11 @@
 import 'package:drift/drift.dart';
 
-DatabaseConnection createAppDatabaseConnection(String? path, String name, {bool logStatements = false}) {
+DatabaseConnection createAppDatabaseConnection(
+  String? path,
+  String name, {
+  bool logStatements = false,
+  bool isWalEnabled = true,
+  int? busyTimeoutMilliseconds = 5000,
+}) {
   throw UnsupportedError('No suitable database connection implementation was found on this platform.');
 }

packages/data/app_database/lib/src/connection/web.dart

@@ -1,7 +1,13 @@
 import 'package:drift/drift.dart';
 import 'package:drift/wasm.dart';
 
-DatabaseConnection createAppDatabaseConnection(String? path, String name, {bool logStatements = false}) {
+DatabaseConnection createAppDatabaseConnection(
+  String? path,
+  String name, {
+  bool logStatements = false,
+  bool isWalEnabled = true,
+  int? busyTimeoutMilliseconds = 5000,
+}) {
   assert(path == null || path.isEmpty, 'path is not supported on web');
 
   return DatabaseConnection.delayed(