Add JSON userData to enable attachements (and other parameters that perhaps exists)

liboai/components/chat.cpp

@@ -50,8 +50,8 @@ liboai::Conversation::Conversation(std::initializer_list<std::string_view> user_
 liboai::Conversation::Conversation(const std::vector<std::string>& user_data) {
 	this->_conversation["messages"] = nlohmann::json::array();
 
-	for (auto& data : user_data) {
-		auto result = this->AddUserData(data);
+	for (const std::string& data : user_data) {
+		auto result = this->AddUserData(static_cast<std::string_view>(data));
 	}
 }
 
@@ -151,6 +151,16 @@ bool liboai::Conversation::AddUserData(std::string_view data, std::string_view n
 	return false; // data is empty
 }
 
+bool liboai::Conversation::AddUserData(nlohmann::json data) & noexcept(false) {
+	// if data provided is non-empty
+	if (!data.empty()) {
+		EraseExtra();
+		this->_conversation["messages"].push_back(data);
+		return true; // user data added successfully
+	}
+	return false; // data is empty
+}
+
 bool liboai::Conversation::PopUserData() & noexcept(false) {
 	// if conversation is not empty
 	if (!this->_conversation["messages"].empty()) {

liboai/include/components/chat.h

@@ -603,6 +603,26 @@ namespace liboai {
 				std::string_view name
 			) & noexcept(false);
 
+			/*
+				@brief Adds JSON object user input to the conversation.
+					This method adds JSON user input to the conversation.
+					The user input is the user's input - such as a question
+					or a command, with evantually file attachments.
+
+					If using a system prompt, the user input should be
+					provided after the system prompt is set - i.e. after
+					SetSystemData() is called.
+
+				@param *data        The user input to add.
+
+				@returns True/False denoting whether the user input was
+					added successfully.
+			*/
+			[[nodiscard]]
+			LIBOAI_EXPORT bool AddUserData(
+				nlohmann::json data
+			) & noexcept(false);
+
 			/*
 				@brief Removes the last added user data.