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

components/core/CMakeLists.txt

@@ -457,6 +457,8 @@ 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/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
@@ -626,6 +628,7 @@ set(SOURCE_FILES_unitTest
         tests/test-clp_s-search.cpp
         tests/test-EncodedVariableInterpreter.cpp
         tests/test-encoding_methods.cpp
+        tests/test-ffi_ir_stream_search_utils.cpp
         tests/test-ffi_IrUnitHandlerInterface.cpp
         tests/test-ffi_KeyValuePairLogEvent.cpp
         tests/test-ffi_SchemaTree.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 "An unexpected literal type is reached.";
+        case ErrorCodeEnum::LiteralTypeUnsupported:
+            return "The given literal type is not supported.";
         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,
 };