Rename to lockTimeout.

Author: rkistner

lib/src/sqlite_open_factory.dart

@@ -29,9 +29,10 @@ class DefaultSqliteOpenFactory implements SqliteOpenFactory {
   List<String> pragmaStatements(SqliteOpenOptions options) {
     List<String> statements = [];
 
-    if (sqliteOptions.busyTimeout != null) {
+    if (sqliteOptions.lockTimeout != null) {
+      // May be replaced by a Dart-level retry mechanism in the future
       statements.add(
-          'PRAGMA busy_timeout = ${sqliteOptions.busyTimeout!.inMilliseconds}');
+          'PRAGMA busy_timeout = ${sqliteOptions.lockTimeout!.inMilliseconds}');
     }
 
     if (options.primaryConnection && sqliteOptions.journalMode != null) {

lib/src/sqlite_options.dart

@@ -11,22 +11,22 @@ class SqliteOptions {
   /// attempt to truncate the file afterwards.
   final int? journalSizeLimit;
 
-  /// Timeout waiting for locks to be released by other write connections.
+  /// Timeout waiting for locks to be released by other connections.
   /// Defaults to 30 seconds.
-  /// Set to 0 to fail immediately when the database is locked.
-  final Duration? busyTimeout;
+  /// Set to null or [Duration.zero] to fail immediately when the database is locked.
+  final Duration? lockTimeout;
 
   const SqliteOptions.defaults()
       : journalMode = SqliteJournalMode.wal,
         journalSizeLimit = 6 * 1024 * 1024, // 1.5x the default checkpoint size
         synchronous = SqliteSynchronous.normal,
-        busyTimeout = const Duration(seconds: 30);
+        lockTimeout = const Duration(seconds: 30);
 
   const SqliteOptions(
       {this.journalMode = SqliteJournalMode.wal,
       this.journalSizeLimit = 6 * 1024 * 1024,
       this.synchronous = SqliteSynchronous.normal,
-      this.busyTimeout = const Duration(seconds: 30)});
+      this.lockTimeout = const Duration(seconds: 30)});
 }
 
 /// SQLite journal mode. Set on the primary connection.