feat: ContextBuilder::c2pa_context_builder to get underlying FFI context builder

CMakeLists.txt

@@ -14,7 +14,7 @@
 cmake_minimum_required(VERSION 3.27)
 
 # This is the current version of this C++ project
-project(c2pa-c VERSION 0.19.1)
+project(c2pa-c VERSION 0.19.2)
 
 # Set the version of the c2pa_rs library used
 set(C2PA_VERSION "0.78.6")

include/c2pa.hpp

@@ -317,6 +317,10 @@ namespace c2pa
             /// @note This consumes the builder. After calling this, is_valid() returns false.
             [[nodiscard]] Context create_context();
 
+            /// @brief Get the underlying C2paContextBuilder pointer.
+            /// @return Pointer to the C2paContextBuilder object, or nullptr if moved from.
+            C2paContextBuilder* c2pa_context_builder() const noexcept;
+
         private:
             C2paContextBuilder* context_builder;
         };

src/c2pa_context.cpp

@@ -154,6 +154,10 @@ namespace c2pa
         return *this;
     }
 
+    C2paContextBuilder* Context::ContextBuilder::c2pa_context_builder() const noexcept {
+        return context_builder;
+    }
+
     Context Context::ContextBuilder::create_context() {
         if (!is_valid()) {
             throw C2paException("ContextBuilder is invalid (moved from)");