feat(kv-ir): Add utilities for kv-pair IR stream search.

components/core/CMakeLists.txt

@@ -457,6 +457,9 @@ set(SOURCE_FILES_unitTest
         src/clp/ffi/ir_stream/search/ErrorCode.hpp
         src/clp/ffi/ir_stream/search/NewProjectedSchemaTreeNodeCallbackReq.hpp
         src/clp/ffi/ir_stream/search/QueryHandler.hpp
+        src/clp/ffi/ir_stream/search/test/test_utils.cpp
+        src/clp/ffi/ir_stream/search/utils.cpp
+        src/clp/ffi/ir_stream/search/utils.hpp
         src/clp/ffi/ir_stream/utils.cpp
         src/clp/ffi/ir_stream/utils.hpp
         src/clp/ffi/KeyValuePairLogEvent.cpp

components/core/src/clp/ffi/ir_stream/search/ErrorCode.cpp

@@ -17,6 +17,12 @@ auto ErrorCategory::name() const noexcept -> char const* {
 template <>
 auto ErrorCategory::message(ErrorCodeEnum error_enum) const -> std::string {
     switch (error_enum) {
+        case ErrorCodeEnum::EncodedTextAstDecodingFailure:
+            return "Failed to decode the given encoded text AST.";
+        case ErrorCodeEnum::LiteralTypeUnexpected:
+            return "Unexpected literal type.";
+        case ErrorCodeEnum::LiteralTypeUnsupported:
+            return "Unsupported literal type.";
         case ErrorCodeEnum::MethodNotImplemented:
             return "The requested method is not implemented.";
         default:

components/core/src/clp/ffi/ir_stream/search/ErrorCode.hpp

@@ -10,6 +10,9 @@ namespace clp::ffi::ir_stream::search {
  * Represents all possible error codes related to KV-pair IR stream search.
  */
 enum class ErrorCodeEnum : uint8_t {
+    EncodedTextAstDecodingFailure,
+    LiteralTypeUnexpected,
+    LiteralTypeUnsupported,
     MethodNotImplemented,
 };