checkpoint api feature support to align with tdb v8.3.2+

CMakeLists.txt

@@ -1,5 +1,5 @@
 cmake_minimum_required(VERSION 3.16)
-project(tidesdb_cpp VERSION 2.3.0 LANGUAGES CXX)
+project(tidesdb_cpp VERSION 2.3.1 LANGUAGES CXX)
 
 set(CMAKE_CXX_STANDARD 17)
 set(CMAKE_CXX_STANDARD_REQUIRED ON)

include/tidesdb/tidesdb.hpp

@@ -598,6 +598,12 @@ class TidesDB
      */
     void backup(const std::string& dir);
 
+    /**
+     * @brief Create a lightweight checkpoint of the database using hard links
+     * @param dir Checkpoint directory (must be empty or non-existent)
+     */
+    void checkpoint(const std::string& dir);
+
     /**
      * @brief Get default database configuration
      * @return Default Config struct

src/tidesdb.cpp

@@ -744,6 +744,12 @@ void TidesDB::backup(const std::string& dir)
     checkResult(result, "failed to create backup");
 }
 
+void TidesDB::checkpoint(const std::string& dir)
+{
+    int result = tidesdb_checkpoint(db_, dir.c_str());
+    checkResult(result, "failed to create checkpoint");
+}
+
 Config TidesDB::defaultConfig()
 {
     tidesdb_config_t cConfig = tidesdb_default_config();

tests/tidesdb_test.cpp

@@ -683,6 +683,49 @@ TEST_F(TidesDBTest, Backup)
     fs::remove_all(backupPath);
 }
 
+TEST_F(TidesDBTest, Checkpoint)
+{
+    std::string checkpointPath = testDbPath_ + "_checkpoint";
+    fs::remove_all(checkpointPath);
+
+    {
+        tidesdb::TidesDB db(getConfig());
+
+        auto cfConfig = tidesdb::ColumnFamilyConfig::defaultConfig();
+        db.createColumnFamily("test_cf", cfConfig);
+
+        auto cf = db.getColumnFamily("test_cf");
+        {
+            auto txn = db.beginTransaction();
+            txn.put(cf, "checkpoint_key", "checkpoint_value", -1);
+            txn.commit();
+        }
+
+        db.checkpoint(checkpointPath);
+    }
+
+    ASSERT_TRUE(fs::exists(checkpointPath));
+
+    {
+        tidesdb::Config config;
+        config.dbPath = checkpointPath;
+        config.numFlushThreads = 2;
+        config.numCompactionThreads = 2;
+        config.logLevel = tidesdb::LogLevel::Info;
+        config.blockCacheSize = 64 * 1024 * 1024;
+        config.maxOpenSSTables = 256;
+
+        tidesdb::TidesDB checkpointDb(config);
+        auto cf = checkpointDb.getColumnFamily("test_cf");
+        auto txn = checkpointDb.beginTransaction();
+        auto value = txn.get(cf, "checkpoint_key");
+        std::string valueStr(value.begin(), value.end());
+        ASSERT_EQ(valueStr, "checkpoint_value");
+    }
+
+    fs::remove_all(checkpointPath);
+}
+
 TEST_F(TidesDBTest, ExtendedStats)
 {
     tidesdb::TidesDB db(getConfig());