Prepare to publish sqlite3 web

Author: simolus3

sqlite3_web/CHANGELOG.md

@@ -1,3 +1,7 @@
+## 0.2.0
+
+- Make `FileSystem` implementation functional, add `FileSystem.flush()`.
+
 ## 0.1.3
 
 - Support latest version of `package:web`.

sqlite3_web/lib/src/types.dart

@@ -75,9 +75,16 @@ final class RemoteException implements Exception {
   }
 }
 
+/// A virtual file system used by a worker to persist database files.
 abstract class FileSystem {
+  /// Returns whether a database file identified by its [type] exists.
   Future<bool> exists(FileType type);
+
+  /// Reads the database file (or its journal).
   Future<Uint8List> readFile(FileType type);
+
+  /// Replaces the database file (or its journal), creating the virtual file if
+  /// it doesn't exist.
   Future<void> writeFile(FileType type, Uint8List content);
 
   /// If the file system hosting the database in the worker is not synchronous,

sqlite3_web/pubspec.yaml

@@ -1,6 +1,6 @@
 name: sqlite3_web
 description: Utilities to simplify accessing sqlite3 on the web, with automated feature detection.
-version: 0.1.3
+version: 0.2.0
 homepage: https://github.com/simolus3/sqlite3.dart/tree/main/sqlite3_web
 repository: https://github.com/simolus3/sqlite3.dart
 

sqlite3_web/test/integration_test.dart

@@ -169,6 +169,7 @@ void main() {
           expect(await driver.countUpdateEvents(), 1);
 
           expect(await driver.assertFile(true), isPositive);
+          await driver.flush();
         });
       }
     });

sqlite3_web/tool/server.dart

@@ -194,4 +194,11 @@ class TestWebDriver {
       return null;
     }
   }
+
+  Future<void> flush() async {
+    final result = await driver.executeAsync('flush("", arguments[0])', []);
+    if (result != true) {
+      throw 'flush() failed: $result';
+    }
+  }
 }

sqlite3_web/web/main.dart

@@ -53,6 +53,11 @@ void main() {
 
     return true.toJS;
   });
+  _addCallbackForWebDriver('flush', (arg) async {
+    final vfs = database!.fileSystem;
+    await vfs.flush();
+    return true.toJS;
+  });
 
   document.getElementById('selfcheck')?.onClick.listen((event) async {
     print('starting');