update C-API to the latest dev version

Author: vaind

objectbox/CHANGELOG.md

@@ -1,7 +1,7 @@
 ## latest
 
 * Add `Query.findUnique()` to find a single object matching the query.
-* Add data `Browser`, see [docs](https://docs.objectbox.io/data-browser) for more details. 
+* Add ObjectBox Admin, see [docs](https://docs.objectbox.io/data-browser) for more details. 
 
 ## 1.1.1 (2021-07-09)
 

objectbox/lib/objectbox.dart

@@ -6,7 +6,7 @@ library objectbox;
 
 export 'src/annotations.dart';
 export 'src/box.dart' show Box, PutMode;
-export 'src/browser.dart' show Browser;
+export 'src/admin.dart' show Admin;
 export 'src/common.dart';
 export 'src/query.dart'
     show

objectbox/lib/src/admin.dart

@@ -0,0 +1 @@
+export 'native/admin.dart' if (dart.library.html) 'web/admin.dart';

objectbox/lib/src/browser.dart

@@ -0,0 +1,80 @@
+import 'dart:ffi';
+
+import 'bindings/bindings.dart';
+import 'bindings/helpers.dart';
+import 'store.dart';
+
+/// ObjectBox Admin allows you to explore the database in a regular web browser.
+///
+/// Admin runs directly on your device or on your development machine.
+/// Behind the scenes this works by bundling a simple HTTP server into ObjectBox
+/// when building your app. If triggered, it will then provide a basic web
+/// interface to the data and schema.
+class Admin {
+  late Pointer<OBX_admin> _cAdmin;
+  late final Pointer<OBX_dart_finalizer> _cFinalizer;
+
+  @pragma('vm:prefer-inline')
+  Pointer<OBX_admin> get _ptr => (_cAdmin.address != 0)
+      ? _cAdmin
+      : throw StateError('Admin already closed');
+
+  /// Whether the loaded ObjectBox native library supports Admin.
+  static bool isAvailable() => C.has_feature(OBXFeature.Admin);
+
+  /// Creates a sync client associated with the given store and options.
+  /// This does not initiate any connection attempts yet: call start() to do so.
+  Admin(Store store, {String bindUri = 'http://127.0.0.1:8090'}) {
+    if (!isAvailable()) {
+      throw UnsupportedError(
+          'Admin is not available in the loaded ObjectBox runtime library.');
+    }
+    initializeDartAPI();
+
+    final opt = checkObxPtr(C.admin_opt());
+    try {
+      checkObx(C.admin_opt_store(opt, InternalStoreAccess.ptr(store)));
+      checkObx(C.admin_opt_user_management(opt, false));
+      withNativeString(bindUri,
+          (Pointer<Int8> cStr) => checkObx(C.admin_opt_bind(opt, cStr)));
+    } catch (_) {
+      C.admin_opt_free(opt);
+      rethrow;
+    }
+
+    _cAdmin = C.admin(opt);
+
+    // Keep the finalizer so we can detach it when close() is called manually.
+    _cFinalizer = C.dartc_attach_finalizer(
+        this, native_admin_close, _cAdmin.cast(), 1024 * 1024);
+    if (_cFinalizer == nullptr) {
+      close();
+      throwLatestNativeError();
+    }
+  }
+
+  /// Closes and cleans up all resources used by this Admin.
+  void close() {
+    if (_cAdmin.address != 0) {
+      final errors = List.filled(2, 0);
+      if (_cFinalizer != nullptr) {
+        errors[0] = C.dartc_detach_finalizer(_cFinalizer, this);
+      }
+      errors[1] = C.admin_close(_cAdmin);
+      _cAdmin = nullptr;
+      errors.forEach(checkObx);
+    }
+  }
+
+  /// Returns if the admin is already closed and can no longer be used.
+  bool isClosed() => _cAdmin.address == 0;
+
+  /// Port the admin listens on. This is especially useful if the port was
+  /// assigned automatically (a "0" port was used in the [bindUri]).
+  late final int port = () {
+    final result = C.admin_port(_ptr);
+    reachabilityFence(this);
+    if (result == 0) throwLatestNativeError();
+    return result;
+  }();
+}

objectbox/lib/src/native/admin.dart

@@ -122,8 +122,8 @@ late final native_query_close =
     _lib!.lookup<NativeFunction<_native_close>>('obx_query_close');
 late final native_query_prop_close =
     _lib!.lookup<NativeFunction<_native_close>>('obx_query_prop_close');
-late final native_browser_close =
-    _lib!.lookup<NativeFunction<_native_close>>('obx_browser_close');
+late final native_admin_close =
+    _lib!.lookup<NativeFunction<_native_close>>('obx_admin_close');
 
 /// Keeps `this` alive until this call, preventing finalizers to run.
 /// Necessary for objects with a finalizer attached because the optimizer may