Merge branch '159-database-and-sync-version-apis' into 'main'

Add getters for Sync protocol, database version

See merge request objectbox/objectbox-dart!117

Author: greenrobot-team

objectbox/lib/src/native/store.dart

@@ -498,6 +498,13 @@ class Store implements Finalizable {
         detach: this, externalSize: 200 * 1024);
   }
 
+  /// Returns the version and features of the platform-specific ObjectBox
+  /// database library.
+  ///
+  /// The format may change in any future release, only use this for
+  /// informational purposes.
+  static String databaseVersion() => dartStringFromC(C.version_core_string());
+
   /// Returns if an open store (i.e. opened before and not yet closed) was found
   /// for the given [directoryPath].
   ///

objectbox/lib/src/native/sync.dart

@@ -238,6 +238,13 @@ class SyncClient {
   /// Returns if this sync client is closed and can no longer be used.
   bool isClosed() => _cSync.address == 0;
 
+  /// Returns the protocol version this client uses.
+  static int protocolVersion() => C.sync_protocol_version();
+
+  /// Returns the protocol version of the server after a connection is
+  /// established (or attempted), zero otherwise.
+  int protocolVersionServer() => C.sync_protocol_version_server(_ptr);
+
   /// Gets the current sync client state.
   SyncState state() {
     final state = C.sync_state(_ptr);

objectbox_test/test/basics_test.dart

@@ -1,6 +1,7 @@
 import 'dart:ffi' as ffi;
 
 import 'package:objectbox/internal.dart';
+import 'package:objectbox/objectbox.dart';
 import 'package:objectbox/src/native/bindings/bindings.dart';
 import 'package:objectbox/src/native/bindings/helpers.dart';
 import 'package:objectbox/src/native/version.dart';
@@ -14,7 +15,8 @@ void main() {
     expect(atLeastDart("999.0.0"), false);
   });
 
-  print("Testing basics of ObjectBox using C lib V${libraryVersion()}");
+  print("Testing basics of ObjectBox using C lib V${libraryVersion()} "
+      "with database version ${Store.databaseVersion()}");
 
   // Prior to Dart 2.6, the exception wasn't accessible and may have crashed.
   // Similarly, this occured in Fluter for Linux (desktop).

objectbox_test/test/sync_test.dart

@@ -99,6 +99,7 @@ void main() {
 
   if (Sync.isAvailable()) {
     // TESTS to run when SYNC is available
+    print("Testing Sync with protocol version ${SyncClient.protocolVersion()}");
 
     test('SyncClient lifecycle', () {
       expect(store.syncClient(), isNull);
@@ -210,6 +211,9 @@ void main() {
       SyncClient c = createClient(store);
       expect(c.isClosed(), isFalse);
 
+      expect(SyncClient.protocolVersion(), greaterThanOrEqualTo(7));
+      expect(c.protocolVersionServer(), 0);
+
       c.setCredentials(SyncCredentials.none());
       c.setCredentials(SyncCredentials.googleAuthString('secret'));
       c.setCredentials(SyncCredentials.sharedSecretString('secret'));