Update C-API [4.3.1 -> 5.0.0]

Author: greenrobot-team

dev-doc/updating-c-library.md

@@ -98,5 +98,5 @@ Then manually:
 - Commit as
 
 ```text
-Update C-API [4.3.0 -> 4.3.1]
+Update C-API [4.3.1 -> 5.0.0]
 ```

objectbox/lib/src/native/bindings/bindings.dart

@@ -96,14 +96,14 @@ ObjectBoxC? _tryObjectBoxLibFile() {
 // libraries.
 // Library                 | C API | Database
 // ------------------------|-------|-----------------
-// C library 4.3.1         | 4.3.1 | 4.3.1-2025-07-28
-// Android library 4.3.1   | 4.3.1 | 4.3.1-2025-08-02
-// macOS/iOS library 4.4.1 | 4.3.1 | 4.3.1-2025-08-02
-var _obxCminMajor = 4;
-var _obxCminMinor = 3;
-var _obxCminPatch = 1;
+// C library 5.0.0-rc      | 5.0.0 | 5.0.0-2025-09-27
+// Android library 5.0.1   | 5.0.0 | 5.0.0-2025-09-27
+// macOS/iOS library 5.0.0 | 5.0.0 | 5.0.0-2025-09-27
+var _obxCminMajor = 5;
+var _obxCminMinor = 0;
+var _obxCminPatch = 0;
 // Require minimum database version guaranteeing actual C API availability.
-var _obxDatabaseMinVersion = "4.3.1-2025-07-28";
+var _obxDatabaseMinVersion = "5.0.0-2025-09-27";
 
 bool _isSupportedVersion(ObjectBoxC obxc) {
   // Require a minimum C API version

objectbox/lib/src/native/bindings/objectbox-sync.h

@@ -34,7 +34,7 @@
 #include "objectbox.h"
 
 #if defined(static_assert) || defined(__cplusplus)
-static_assert(OBX_VERSION_MAJOR == 4 && OBX_VERSION_MINOR == 3 && OBX_VERSION_PATCH == 1,  // NOLINT
+static_assert(OBX_VERSION_MAJOR == 5 && OBX_VERSION_MINOR == 0 && OBX_VERSION_PATCH == 0,  // NOLINT
               "Versions of objectbox.h and objectbox-sync.h files do not match, please update");
 #endif
 
@@ -201,6 +201,20 @@ OBX_C_API OBX_sync* obx_sync_urls(OBX_store* store, const char* server_urls[], s
 /// Stops and closes (deletes) the sync client, freeing its resources.
 OBX_C_API obx_err obx_sync_close(OBX_sync* sync);
 
+/// Adds or replaces a sync filter variable value for the given name to the sync client.
+/// Eventually existing values for the same name are replaced.
+/// Client filter variables can be used in server-side sync filters to filter out objects that do not match the filter.
+/// Filter variables must be added before login, e.g. before obx_sync_start() or setting credentials.
+/// @param name non-NULL name of the filter variable
+/// @param value non-NULL value of the filter variable
+OBX_C_API obx_err obx_sync_filter_variables_put(OBX_sync* sync, const char* name, const char* value);
+
+/// Removes a previously added sync filter variable value.
+OBX_C_API obx_err obx_sync_filter_variables_remove(OBX_sync* sync, const char* name);
+
+/// Removes all previously added sync filter variable values.
+OBX_C_API obx_err obx_sync_filter_variables_remove_all(OBX_sync* sync);
+
 /// Sets credentials to authenticate the client with the server.
 /// Any credentials that were set before are replaced;
 /// if you want to pass multiple credentials, use obx_sync_credentials_add() instead.

objectbox/lib/src/native/bindings/objectbox.h

@@ -51,9 +51,9 @@ extern "C" {
 
 /// When using ObjectBox as a dynamic library, you should verify that a compatible version was linked using
 /// obx_version() or obx_version_is_at_least().
-#define OBX_VERSION_MAJOR 4
-#define OBX_VERSION_MINOR 3
-#define OBX_VERSION_PATCH 1  // values >= 100 are reserved for dev releases leading to the next minor/major increase
+#define OBX_VERSION_MAJOR 5
+#define OBX_VERSION_MINOR 0
+#define OBX_VERSION_PATCH 0  // values >= 100 are reserved for dev releases leading to the next minor/major increase
 
 //----------------------------------------------
 // Common types
@@ -179,6 +179,8 @@ typedef enum {
     /// This is a free trial version; only applies to server builds (no trial builds for database and Sync clients).
     OBXFeature_Trial = 18,
 
+    /// Server-side filters to return individual data for each sync user (user-specific data).
+    OBXFeature_SyncFilters = 19,
 
 } OBXFeature;
 
@@ -2121,7 +2123,7 @@ OBX_C_API obx_qb_cond obx_qb_less_or_equal_string(OBX_query_builder* builder, ob
 OBX_C_API obx_qb_cond obx_qb_in_strings(OBX_query_builder* builder, obx_schema_id property_id,
                                         const char* const values[], size_t count, bool case_sensitive);
 
-/// For OBXPropertyType_StringVector - matches if at least one vector item equals the given value.
+/// @deprecated Please use obx_qb_contains_element_string() instead.
 OBX_C_API obx_qb_cond obx_qb_any_equals_string(OBX_query_builder* builder, obx_schema_id property_id, const char* value,
                                                bool case_sensitive);
 

objectbox/lib/src/native/bindings/objectbox_c.dart

@@ -4935,7 +4935,7 @@ class ObjectBoxC {
       int Function(ffi.Pointer<OBX_query_builder>, int,
           ffi.Pointer<ffi.Pointer<ffi.Char>>, int, bool)>();
 
-  /// For OBXPropertyType_StringVector - matches if at least one vector item equals the given value.
+  /// @deprecated Please use obx_qb_contains_element_string() instead.
   int qb_any_equals_string(
     ffi.Pointer<OBX_query_builder> builder,
     int property_id,
@@ -8399,6 +8399,67 @@ class ObjectBoxC {
   late final _sync_close =
       _sync_closePtr.asFunction<int Function(ffi.Pointer<OBX_sync>)>();
 
+  /// Adds or replaces a sync filter variable value for the given name to the sync client.
+  /// Eventually existing values for the same name are replaced.
+  /// Client filter variables can be used in server-side sync filters to filter out objects that do not match the filter.
+  /// Filter variables must be added before login, e.g. before obx_sync_start() or setting credentials.
+  /// @param name non-NULL name of the filter variable
+  /// @param value non-NULL value of the filter variable
+  int sync_filter_variables_put(
+    ffi.Pointer<OBX_sync> sync1,
+    ffi.Pointer<ffi.Char> name,
+    ffi.Pointer<ffi.Char> value,
+  ) {
+    return _sync_filter_variables_put(
+      sync1,
+      name,
+      value,
+    );
+  }
+
+  late final _sync_filter_variables_putPtr = _lookup<
+      ffi.NativeFunction<
+          obx_err Function(ffi.Pointer<OBX_sync>, ffi.Pointer<ffi.Char>,
+              ffi.Pointer<ffi.Char>)>>('obx_sync_filter_variables_put');
+  late final _sync_filter_variables_put =
+      _sync_filter_variables_putPtr.asFunction<
+          int Function(ffi.Pointer<OBX_sync>, ffi.Pointer<ffi.Char>,
+              ffi.Pointer<ffi.Char>)>();
+
+  /// Removes a previously added sync filter variable value.
+  int sync_filter_variables_remove(
+    ffi.Pointer<OBX_sync> sync1,
+    ffi.Pointer<ffi.Char> name,
+  ) {
+    return _sync_filter_variables_remove(
+      sync1,
+      name,
+    );
+  }
+
+  late final _sync_filter_variables_removePtr = _lookup<
+      ffi.NativeFunction<
+          obx_err Function(ffi.Pointer<OBX_sync>,
+              ffi.Pointer<ffi.Char>)>>('obx_sync_filter_variables_remove');
+  late final _sync_filter_variables_remove = _sync_filter_variables_removePtr
+      .asFunction<int Function(ffi.Pointer<OBX_sync>, ffi.Pointer<ffi.Char>)>();
+
+  /// Removes all previously added sync filter variable values.
+  int sync_filter_variables_remove_all(
+    ffi.Pointer<OBX_sync> sync1,
+  ) {
+    return _sync_filter_variables_remove_all(
+      sync1,
+    );
+  }
+
+  late final _sync_filter_variables_remove_allPtr =
+      _lookup<ffi.NativeFunction<obx_err Function(ffi.Pointer<OBX_sync>)>>(
+          'obx_sync_filter_variables_remove_all');
+  late final _sync_filter_variables_remove_all =
+      _sync_filter_variables_remove_allPtr
+          .asFunction<int Function(ffi.Pointer<OBX_sync>)>();
+
   /// Sets credentials to authenticate the client with the server.
   /// Any credentials that were set before are replaced;
   /// if you want to pass multiple credentials, use obx_sync_credentials_add() instead.
@@ -10400,6 +10461,9 @@ abstract class OBXFeature {
 
   /// This is a free trial version; only applies to server builds (no trial builds for database and Sync clients).
   static const int Trial = 18;
+
+  /// Server-side filters to return individual data for each sync user (user-specific data).
+  static const int SyncFilters = 19;
 }
 
 /// Log level as passed to obx_log_callback.
@@ -11677,11 +11741,11 @@ class OBX_dart_finalizer extends ffi.Opaque {}
 typedef obx_dart_closer
     = ffi.NativeFunction<obx_err Function(ffi.Pointer<ffi.Void> native_object)>;
 
-const int OBX_VERSION_MAJOR = 4;
+const int OBX_VERSION_MAJOR = 5;
 
-const int OBX_VERSION_MINOR = 3;
+const int OBX_VERSION_MINOR = 0;
 
-const int OBX_VERSION_PATCH = 1;
+const int OBX_VERSION_PATCH = 0;
 
 const int OBX_ID_NEW = -1;