Preparing 5.3.1 release

greenrobot · greenrobot · commit be985377b497 · 2026-03-26T11:33:33.000+01:00
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -1,8 +1,16 @@
 ObjectBox C and C++ API Changelog
 =================================
 
+5.3.1 (2026-03-26)
+------------------
+* Critical fix for sync clock handling without preset clock values (null)
+* Helper functions to extract timestamps from sync clock values 
+
 5.3.0 (2026-03-23)
 ------------------
+**Warning:** Do not use sync clock properties in this version; use 5.3.1 instead!
+When putting an object with a sync clock that had no value set (e.g., "null"), it triggered a severe bug.  
+
 * Change log level at runtime, i.e. `obx_log_level_set()`/`obx_log_level_get()`
 * New log level "trace" for most internal details
 * Log level "verbose" can now be enabled (debug log builds only)
diff --git a/CMakeLists.txt b/CMakeLists.txt
@@ -55,7 +55,7 @@ else ()
 
     function(defineObjectBoxLib VARIANT)
         # Configuration updated for each release
-        set(DL_VERSION 5.3.0)
+        set(DL_VERSION 5.3.1)
 
         # Platform detection and other setup
         set(DL_URL https://github.com/objectbox/objectbox-c/releases/download)
diff --git a/README.md b/README.md
@@ -18,7 +18,7 @@ box.put({.text = "Buy milk"});
 
 See [ObjectBox C and C++ docs](https://cpp.objectbox.io/) for API details.
 
-**Latest version: 5.3.0** (2026-03-23).
+**Latest version: 5.3.1** (2026-03-26).
 See [changelog](CHANGELOG.md) for more details.
 
 ## Table of Contents:
diff --git a/download.sh b/download.sh
@@ -44,7 +44,7 @@ tty -s || quiet=true
 
 # Note: optional arguments like "--quiet" shifts argument positions in the case block above
 
-version=${1:-5.3.0}
+version=${1:-5.3.1}
 os=${2:-$(uname)}
 arch=${3:-$(uname -m)}
 echo "Base config: OS ${os} and architecture ${arch}"
diff --git a/doxygen/Changelog.md b/doxygen/Changelog.md
@@ -3,8 +3,16 @@
 ObjectBox C and C++ API Changelog
 =================================
 
+5.3.1 (2026-03-26)
+------------------
+* Critical fix for sync clock handling without preset clock values (null)
+* Helper functions to extract timestamps from sync clock values 
+
 5.3.0 (2026-03-23)
 ------------------
+**Warning:** Do not use sync clock properties in this version; use 5.3.1 instead!
+When putting an object with a sync clock that had no value set (e.g., "null"), it triggered a severe bug.  
+
 * Change log level at runtime, i.e. `obx_log_level_set()`/`obx_log_level_get()`
 * New log level "trace" for most internal details
 * Log level "verbose" can now be enabled (debug log builds only)
diff --git a/doxygen/Doxyfile b/doxygen/Doxyfile
@@ -38,7 +38,7 @@ PROJECT_NAME           = "ObjectBox C and C++ API"
 # could be handy for archiving the generated documentation or if some version
 # control system is used.
 
-PROJECT_NUMBER         = "5.3.0"
+PROJECT_NUMBER         = "5.3.1"
 
 # Using the PROJECT_BRIEF tag one can provide an optional one line description
 # for a project that appears at the top of each page and should give viewer a
diff --git a/examples/c-tasks-lowlevel/CMakeLists.txt b/examples/c-tasks-lowlevel/CMakeLists.txt
@@ -17,7 +17,7 @@ if (NOT TARGET objectbox) # Using "if" in case a (potential) parent project alre
     FetchContent_Declare(
             objectbox
             GIT_REPOSITORY https://github.com/objectbox/objectbox-c.git
-            GIT_TAG v5.3.0 # For latest versions, check https://github.com/objectbox/objectbox-c/releases
+            GIT_TAG v5.3.1 # For latest versions, check https://github.com/objectbox/objectbox-c/releases
     )
     FetchContent_MakeAvailable(objectbox)
 
diff --git a/examples/c-tasks/CMakeLists.txt b/examples/c-tasks/CMakeLists.txt
@@ -17,7 +17,7 @@ if (NOT TARGET objectbox) # Using "if" in case a (potential) parent project alre
     FetchContent_Declare(
             objectbox
             GIT_REPOSITORY https://github.com/objectbox/objectbox-c.git
-            GIT_TAG v5.3.0 # For latest versions, check https://github.com/objectbox/objectbox-c/releases
+            GIT_TAG v5.3.1 # For latest versions, check https://github.com/objectbox/objectbox-c/releases
     )
     FetchContent_MakeAvailable(objectbox)
 
diff --git a/examples/tasks/CMakeLists.txt b/examples/tasks/CMakeLists.txt
@@ -17,7 +17,7 @@ if (NOT TARGET objectbox) # Using "if" in case a (potential) parent project alre
     FetchContent_Declare(
             objectbox
             GIT_REPOSITORY https://github.com/objectbox/objectbox-c.git
-            GIT_TAG v5.3.0 # For latest versions, check https://github.com/objectbox/objectbox-c/releases
+            GIT_TAG v5.3.1 # For latest versions, check https://github.com/objectbox/objectbox-c/releases
     )
     FetchContent_MakeAvailable(objectbox)
 
diff --git a/examples/vectorsearch-cities/CMakeLists.txt b/examples/vectorsearch-cities/CMakeLists.txt
@@ -17,7 +17,7 @@ if (NOT TARGET objectbox) # Using "if" in case a (potential) parent project alre
     FetchContent_Declare(
             objectbox
             GIT_REPOSITORY https://github.com/objectbox/objectbox-c.git
-            GIT_TAG v5.3.0 # For latest versions, check https://github.com/objectbox/objectbox-c/releases
+            GIT_TAG v5.3.1 # For latest versions, check https://github.com/objectbox/objectbox-c/releases
     )
     FetchContent_MakeAvailable(objectbox)
 
diff --git a/include/objectbox-sync.h b/include/objectbox-sync.h
@@ -1,5 +1,5 @@
 /*
- * Copyright 2018-2025 ObjectBox Ltd. All rights reserved.
+ * Copyright 2018-2026 ObjectBox Ltd. All rights reserved.
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -34,7 +34,7 @@
 #include "objectbox.h"
 
 #if defined(static_assert) || defined(__cplusplus)
-static_assert(OBX_VERSION_MAJOR == 5 && OBX_VERSION_MINOR == 3 && OBX_VERSION_PATCH == 0,  // NOLINT
+static_assert(OBX_VERSION_MAJOR == 5 && OBX_VERSION_MINOR == 3 && OBX_VERSION_PATCH == 1,  // NOLINT
               "Versions of objectbox.h and objectbox-sync.h files do not match, please update");
 #endif
 
@@ -1098,6 +1098,19 @@ OBX_C_API obx_err obx_custom_msg_client_set_state(uint64_t client_id, OBXCustomM
 /// @returns OBX_ERROR_* in case the operation encountered an exceptional issue
 OBX_C_API obx_err obx_custom_msg_client_trigger_reconnect(uint64_t client_id);
 
+//---------------------------------------------------------------------------
+//  Misc (e.g. Sync clock)
+//---------------------------------------------------------------------------
+
+/// Gets the "raw" timestamp (milliseconds since epoch) from the given sync clock value.
+/// Note that sync clock values are assigned by ObjectBox and are not to be interpreted on their own.
+OBX_C_API int64_t obx_sync_clock_timestamp(uint64_t sync_clock_value);
+
+/// Gets the corrected timestamp (milliseconds since epoch) from the given sync clock value.
+/// Like obx_cync_clock_timestamp(), but applies any time correction if present in the sync clock value.
+/// However, for most cases, it will return the same value as obx_cync_clock_timestamp().
+OBX_C_API int64_t obx_sync_clock_timestamp_corrected(uint64_t sync_clock_value);
+
 // NOLINTEND(modernize-use-using)
 
 #ifdef __cplusplus
diff --git a/include/objectbox-sync.hpp b/include/objectbox-sync.hpp
@@ -21,7 +21,7 @@
 #include "objectbox-sync.h"
 #include "objectbox.hpp"
 
-static_assert(OBX_VERSION_MAJOR == 5 && OBX_VERSION_MINOR == 3 && OBX_VERSION_PATCH == 0,  // NOLINT
+static_assert(OBX_VERSION_MAJOR == 5 && OBX_VERSION_MINOR == 3 && OBX_VERSION_PATCH == 1,  // NOLINT
               "Versions of objectbox.h and objectbox-sync.hpp files do not match, please update");
 
 namespace obx {
diff --git a/include/objectbox.h b/include/objectbox.h
@@ -53,7 +53,7 @@ extern "C" {
 /// obx_version() or obx_version_is_at_least().
 #define OBX_VERSION_MAJOR 5
 #define OBX_VERSION_MINOR 3
-#define OBX_VERSION_PATCH 0  // values >= 100 are reserved for dev releases leading to the next minor/major increase
+#define OBX_VERSION_PATCH 1  // values >= 100 are reserved for dev releases leading to the next minor/major increase
 
 //----------------------------------------------
 // Common types
diff --git a/include/objectbox.hpp b/include/objectbox.hpp
@@ -36,7 +36,7 @@
 #include <optional>
 #endif
 
-static_assert(OBX_VERSION_MAJOR == 5 && OBX_VERSION_MINOR == 3 && OBX_VERSION_PATCH == 0,  // NOLINT
+static_assert(OBX_VERSION_MAJOR == 5 && OBX_VERSION_MINOR == 3 && OBX_VERSION_PATCH == 1,  // NOLINT
               "Versions of objectbox.h and objectbox.hpp files do not match, please update");
 
 #ifdef __clang__

Original file line number	Diff line number	Diff line change
`@@ -17,7 +17,7 @@ if (NOT TARGET objectbox) # Using "if" in case a (potential) parent project alre`
`17`	`17`	`FetchContent_Declare(`
`18`	`18`	`objectbox`
`19`	`19`	`GIT_REPOSITORY https://github.com/objectbox/objectbox-c.git`
`20`		`- GIT_TAG v5.3.0 # For latest versions, check https://github.com/objectbox/objectbox-c/releases`
	`20`	`+ GIT_TAG v5.3.1 # For latest versions, check https://github.com/objectbox/objectbox-c/releases`
`21`	`21`	`)`
`22`	`22`	`FetchContent_MakeAvailable(objectbox)`
`23`	`23`