From ff3b2314bf227856522f3b8e26e8e05a1c72a17b Mon Sep 17 00:00:00 2001
From: "Scott E. Graves" <scott.e.graves@protonmail.com>
Date: Sat, 30 Aug 2025 15:36:15 -0500
Subject: [PATCH] Implement secure key via KDF for transparent data
 encryption/decryption #60

---
 .../include/file_manager/file_manager.hpp     |  4 ++
 .../include/file_manager/i_file_manager.hpp   |  4 ++
 .../include/providers/base_provider.hpp       |  8 +++
 .../providers/encrypt/encrypt_provider.hpp    |  4 ++
 .../include/providers/i_provider.hpp          |  4 ++
 .../include/rpc/client/client.hpp             |  2 +
 .../include/rpc/server/full_server.hpp        |  3 +
 repertory/librepertory/include/types/rpc.hpp  |  1 +
 .../librepertory/include/utils/cli_utils.hpp  |  2 +
 .../src/file_manager/file_manager.cpp         | 14 +++++
 .../src/providers/base_provider.cpp           | 48 ++++++++++++++++
 .../providers/encrypt/encrypt_provider.cpp    | 32 +++++++++++
 .../librepertory/src/rpc/client/client.cpp    | 29 ++++++++++
 .../src/rpc/server/full_server.cpp            | 19 +++++++
 repertory/repertory/include/cli/actions.hpp   |  3 +
 .../include/cli/get_directory_items.hpp       |  2 +-
 .../repertory/include/cli/get_item_info.hpp   | 56 +++++++++++++++++++
 repertory/repertory/include/cli/help.hpp      |  4 ++
 .../include/mocks/mock_provider.hpp           |  4 ++
 19 files changed, 242 insertions(+), 1 deletion(-)
 create mode 100644 repertory/repertory/include/cli/get_item_info.hpp

diff --git a/repertory/librepertory/include/file_manager/file_manager.hpp b/repertory/librepertory/include/file_manager/file_manager.hpp
index 1c2b0f98..26732e49 100644
--- a/repertory/librepertory/include/file_manager/file_manager.hpp
+++ b/repertory/librepertory/include/file_manager/file_manager.hpp
@@ -135,6 +135,10 @@ public:
 
   [[nodiscard]] auto evict_file(const std::string &api_path) -> bool override;
 
+  [[nodiscard]] auto get_directory_item(const std::string &api_path,
+                                        directory_item &item) const
+      -> api_error override;
+
   [[nodiscard]] auto get_directory_items(const std::string &api_path) const
       -> directory_item_list override;
 
diff --git a/repertory/librepertory/include/file_manager/i_file_manager.hpp b/repertory/librepertory/include/file_manager/i_file_manager.hpp
index 2cab28cf..c8fc81c2 100644
--- a/repertory/librepertory/include/file_manager/i_file_manager.hpp
+++ b/repertory/librepertory/include/file_manager/i_file_manager.hpp
@@ -34,6 +34,10 @@ public:
   [[nodiscard]] virtual auto evict_file(const std::string &api_path)
       -> bool = 0;
 
+  [[nodiscard]] virtual auto get_directory_item(const std::string &api_path,
+                                                directory_item &item) const
+      -> api_error = 0;
+
   [[nodiscard]] virtual auto
   get_directory_items(const std::string &api_path) const
       -> directory_item_list = 0;
diff --git a/repertory/librepertory/include/providers/base_provider.hpp b/repertory/librepertory/include/providers/base_provider.hpp
index f698fa3d..d82f36a7 100644
--- a/repertory/librepertory/include/providers/base_provider.hpp
+++ b/repertory/librepertory/include/providers/base_provider.hpp
@@ -110,6 +110,10 @@ protected:
 
   [[nodiscard]] auto get_db() const -> const i_meta_db & { return *db3_; }
 
+  [[nodiscard]] virtual auto
+  get_directory_item_impl(const std::string &api_path, bool directory,
+                          directory_item &item) const -> api_error;
+
   [[nodiscard]] virtual auto
   get_directory_items_impl(const std::string &api_path,
                            directory_item_list &list) const -> api_error = 0;
@@ -147,6 +151,10 @@ public:
                                               std::string &api_path) const
       -> api_error override;
 
+  [[nodiscard]] auto get_directory_item(const std::string &api_path,
+                                        directory_item &item) const
+      -> api_error override;
+
   [[nodiscard]] auto get_directory_items(const std::string &api_path,
                                          directory_item_list &list) const
       -> api_error override;
diff --git a/repertory/librepertory/include/providers/encrypt/encrypt_provider.hpp b/repertory/librepertory/include/providers/encrypt/encrypt_provider.hpp
index d104aefb..d26dbf5c 100644
--- a/repertory/librepertory/include/providers/encrypt/encrypt_provider.hpp
+++ b/repertory/librepertory/include/providers/encrypt/encrypt_provider.hpp
@@ -118,6 +118,10 @@ public:
   [[nodiscard]] auto get_directory_item_count(const std::string &api_path) const
       -> std::uint64_t override;
 
+  [[nodiscard]] auto get_directory_item(const std::string &api_path,
+                                        directory_item &item) const
+      -> api_error override;
+
   [[nodiscard]] auto get_directory_items(const std::string &api_path,
                                          directory_item_list &list) const
       -> api_error override;
diff --git a/repertory/librepertory/include/providers/i_provider.hpp b/repertory/librepertory/include/providers/i_provider.hpp
index d1b5f616..d1205f94 100644
--- a/repertory/librepertory/include/providers/i_provider.hpp
+++ b/repertory/librepertory/include/providers/i_provider.hpp
@@ -55,6 +55,10 @@ public:
   get_directory_item_count(const std::string &api_path) const
       -> std::uint64_t = 0;
 
+  [[nodiscard]] virtual auto get_directory_item(const std::string &api_path,
+                                                directory_item &list) const
+      -> api_error = 0;
+
   [[nodiscard]] virtual auto
   get_directory_items(const std::string &api_path,
                       directory_item_list &list) const -> api_error = 0;
diff --git a/repertory/librepertory/include/rpc/client/client.hpp b/repertory/librepertory/include/rpc/client/client.hpp
index e07df4cf..a9cea483 100644
--- a/repertory/librepertory/include/rpc/client/client.hpp
+++ b/repertory/librepertory/include/rpc/client/client.hpp
@@ -44,6 +44,8 @@ public:
   [[nodiscard]] auto get_directory_items(const std::string &api_path)
       -> rpc_response;
 
+  [[nodiscard]] auto get_item_info(const std::string &api_path) -> rpc_response;
+
   [[nodiscard]] auto get_open_files() -> rpc_response;
 
   [[nodiscard]] auto get_pinned_files() -> rpc_response;
diff --git a/repertory/librepertory/include/rpc/server/full_server.hpp b/repertory/librepertory/include/rpc/server/full_server.hpp
index 99176efe..cbe935dc 100644
--- a/repertory/librepertory/include/rpc/server/full_server.hpp
+++ b/repertory/librepertory/include/rpc/server/full_server.hpp
@@ -43,6 +43,9 @@ private:
   void handle_get_directory_items(const httplib::Request &req,
                                   httplib::Response &res);
 
+  void handle_get_item_info(const httplib::Request &req,
+                            httplib::Response &res);
+
   void handle_get_drive_information(const httplib::Request &req,
                                     httplib::Response &res);
 
diff --git a/repertory/librepertory/include/types/rpc.hpp b/repertory/librepertory/include/types/rpc.hpp
index c7a37663..f7ed6f61 100644
--- a/repertory/librepertory/include/types/rpc.hpp
+++ b/repertory/librepertory/include/types/rpc.hpp
@@ -45,6 +45,7 @@ namespace rpc_method {
 const std::string get_config = "get_config";
 const std::string get_config_value_by_name = "get_config_value_by_name";
 const std::string get_directory_items = "get_directory_items";
+const std::string get_item_info = "get_item_info";
 const std::string get_drive_information = "get_drive_information";
 const std::string get_open_files = "get_open_files";
 const std::string get_pinned_files = "get_pinned_files";
diff --git a/repertory/librepertory/include/utils/cli_utils.hpp b/repertory/librepertory/include/utils/cli_utils.hpp
index 8f2a8c0c..3152e0e7 100644
--- a/repertory/librepertory/include/utils/cli_utils.hpp
+++ b/repertory/librepertory/include/utils/cli_utils.hpp
@@ -39,6 +39,7 @@ inline const option generate_config_option = {"-gc", "--generate_config"};
 inline const option get_option = {"-get", "--get"};
 inline const option get_directory_items_option = {"-gdi",
                                                   "--get_directory_items"};
+inline const option get_item_info_option = {"-gi", "--get_item_info"};
 inline const option get_pinned_files_option = {"-gpf", "--get_pinned_files"};
 inline const option help_option = {"-h", "--help"};
 inline const option hidden_option = {"-hidden", "--hidden"};
@@ -69,6 +70,7 @@ inline const std::vector<option> option_list = {
     generate_config_option,
     get_option,
     get_directory_items_option,
+    get_item_info_option,
     get_pinned_files_option,
     help_option,
     hidden_option,
diff --git a/repertory/librepertory/src/file_manager/file_manager.cpp b/repertory/librepertory/src/file_manager/file_manager.cpp
index 27f647e4..106c7f8a 100644
--- a/repertory/librepertory/src/file_manager/file_manager.cpp
+++ b/repertory/librepertory/src/file_manager/file_manager.cpp
@@ -223,6 +223,20 @@ auto file_manager::get_directory_items(const std::string &api_path) const
   return list;
 }
 
+auto file_manager::get_directory_item(const std::string &api_path,
+                                      directory_item &item) const -> api_error {
+  REPERTORY_USES_FUNCTION_NAME();
+
+  auto ret = provider_.get_directory_item(api_path, item);
+  if (ret == api_error::success) {
+    return ret;
+  }
+
+  utils::error::raise_api_path_error(function_name, api_path, ret,
+                                     "failed to get directory item");
+  return ret;
+}
+
 auto file_manager::get_next_handle() -> std::uint64_t {
   if (++next_handle_ == 0U) {
     ++next_handle_;
diff --git a/repertory/librepertory/src/providers/base_provider.cpp b/repertory/librepertory/src/providers/base_provider.cpp
index e8b268a5..9ab0d556 100644
--- a/repertory/librepertory/src/providers/base_provider.cpp
+++ b/repertory/librepertory/src/providers/base_provider.cpp
@@ -275,6 +275,54 @@ auto base_provider::get_api_path_from_source(const std::string &source_path,
   return db3_->get_api_path(source_path, api_path);
 }
 
+auto base_provider::get_directory_item_impl(const std::string &api_path,
+                                            bool directory,
+                                            directory_item &item) const
+    -> api_error {
+  filesystem_item fsi{};
+  auto ret = get_filesystem_item(api_path, directory, fsi);
+  if (ret != api_error::success) {
+    return ret;
+  }
+
+  api_meta_map meta;
+  ret = get_item_meta(api_path, meta);
+  if (ret != api_error::success) {
+    return ret;
+  }
+
+  item = {
+      .api_path = fsi.api_path,
+      .api_parent = fsi.api_parent,
+      .directory = fsi.directory,
+      .size = fsi.size,
+      .meta = meta,
+  };
+
+  return ret;
+}
+
+auto base_provider::get_directory_item(const std::string &api_path,
+                                       directory_item &item) const
+    -> api_error {
+  REPERTORY_USES_FUNCTION_NAME();
+
+  try {
+    bool directory{};
+    auto ret = is_directory(api_path, directory);
+    if (ret != api_error::success) {
+      return ret;
+    }
+
+    return get_directory_item_impl(api_path, directory, item);
+  } catch (const std::exception &e) {
+    utils::error::raise_api_path_error(function_name, api_path, e,
+                                       "failed to get directory items");
+  }
+
+  return api_error::error;
+}
+
 auto base_provider::get_directory_items(const std::string &api_path,
                                         directory_item_list &list) const
     -> api_error {
diff --git a/repertory/librepertory/src/providers/encrypt/encrypt_provider.cpp b/repertory/librepertory/src/providers/encrypt/encrypt_provider.cpp
index 864edf8b..f79a1975 100644
--- a/repertory/librepertory/src/providers/encrypt/encrypt_provider.cpp
+++ b/repertory/librepertory/src/providers/encrypt/encrypt_provider.cpp
@@ -199,6 +199,38 @@ auto encrypt_provider::get_directory_item_count(
   return count;
 }
 
+auto encrypt_provider::get_directory_item(const std::string &api_path,
+                                          directory_item &item) const
+    -> api_error {
+  bool directory{};
+  auto ret = is_directory(api_path, directory);
+  if (ret != api_error::success) {
+    return ret;
+  }
+
+  filesystem_item fsi{};
+  ret = get_filesystem_item(api_path, directory, fsi);
+  if (ret != api_error::success) {
+    return ret;
+  }
+
+  api_meta_map meta;
+  ret = get_item_meta(api_path, meta);
+  if (ret != api_error::success) {
+    return ret;
+  }
+
+  item = {
+      .api_path = fsi.api_path,
+      .api_parent = fsi.api_parent,
+      .directory = fsi.directory,
+      .size = fsi.size,
+      .meta = meta,
+  };
+
+  return ret;
+}
+
 auto encrypt_provider::get_directory_items(const std::string &api_path,
                                            directory_item_list &list) const
     -> api_error {
diff --git a/repertory/librepertory/src/rpc/client/client.cpp b/repertory/librepertory/src/rpc/client/client.cpp
index 9b638659..e010346d 100644
--- a/repertory/librepertory/src/rpc/client/client.cpp
+++ b/repertory/librepertory/src/rpc/client/client.cpp
@@ -142,6 +142,35 @@ auto client::get_directory_items(const std::string &api_path) -> rpc_response {
   };
 }
 
+auto client::get_item_info(const std::string &api_path) -> rpc_response {
+  auto base_url =
+      "http://" + host_info_.host + ":" + std::to_string(host_info_.port);
+
+  httplib::Params params{{"api_path", api_path}};
+  httplib::Client cli{base_url};
+  cli.set_basic_auth(host_info_.user,
+                     rpc::create_password_hash(host_info_.password));
+
+  auto resp = cli.Get("/api/v1/" + rpc_method::get_item_info, params, {});
+  if (resp.error() != httplib::Error::Success) {
+    return rpc_response{
+        .response_type = rpc_response_type::http_error,
+        .data = {{"error", httplib::to_string(resp.error())}},
+    };
+  }
+  if (resp->status != http_error_codes::ok) {
+    return rpc_response{
+        .response_type = rpc_response_type::http_error,
+        .data = {{"error", std::to_string(resp->status)}},
+    };
+  }
+
+  return rpc_response{
+      .response_type = rpc_response_type::success,
+      .data = json::parse(resp->body),
+  };
+}
+
 auto client::get_open_files() -> rpc_response {
   auto base_url =
       "http://" + host_info_.host + ":" + std::to_string(host_info_.port);
diff --git a/repertory/librepertory/src/rpc/server/full_server.cpp b/repertory/librepertory/src/rpc/server/full_server.cpp
index a58b3c30..90473e61 100644
--- a/repertory/librepertory/src/rpc/server/full_server.cpp
+++ b/repertory/librepertory/src/rpc/server/full_server.cpp
@@ -50,6 +50,20 @@ void full_server::handle_get_directory_items(const httplib::Request &req,
   res.status = http_error_codes::ok;
 }
 
+void full_server::handle_get_item_info(const httplib::Request &req,
+                                       httplib::Response &res) {
+  auto api_path = utils::path::create_api_path(req.get_param_value("api_path"));
+  directory_item item;
+  auto ret = fm_.get_directory_item(api_path, item);
+  if (ret == api_error::success) {
+    res.set_content(json(item).dump(), "application/json");
+    res.status = http_error_codes::ok;
+    return;
+  }
+
+  res.status = http_error_codes::not_found;
+}
+
 void full_server::handle_get_drive_information(const httplib::Request & /*req*/,
                                                httplib::Response &res) {
   res.set_content(
@@ -178,6 +192,11 @@ void full_server::initialize(httplib::Server &inst) {
              handle_get_directory_items(std::forward<decltype(req)>(req),
                                         std::forward<decltype(res)>(res));
            });
+  inst.Get("/api/v1/" + rpc_method::get_item_info,
+           [this](auto &&req, auto &&res) {
+             handle_get_item_info(std::forward<decltype(req)>(req),
+                                  std::forward<decltype(res)>(res));
+           });
   inst.Get("/api/v1/" + rpc_method::get_drive_information,
            [this](auto &&req, auto &&res) {
              handle_get_drive_information(std::forward<decltype(req)>(req),
diff --git a/repertory/repertory/include/cli/actions.hpp b/repertory/repertory/include/cli/actions.hpp
index a59bc7f3..5597f09c 100644
--- a/repertory/repertory/include/cli/actions.hpp
+++ b/repertory/repertory/include/cli/actions.hpp
@@ -27,6 +27,7 @@
 #include "cli/drive_information.hpp"
 #include "cli/get.hpp"
 #include "cli/get_directory_items.hpp"
+#include "cli/get_item_info.hpp"
 #include "cli/get_pinned_files.hpp"
 #include "cli/get_version.hpp"
 #include "cli/help.hpp"
@@ -62,6 +63,8 @@ inline const std::unordered_map<utils::cli::option, action, option_hasher>
          cli::actions::drive_information},
         {utils::cli::options::get_directory_items_option,
          cli::actions::get_directory_items},
+        {utils::cli::options::get_item_info_option,
+         cli::actions::get_item_info},
         {utils::cli::options::get_option, cli::actions::get},
         {utils::cli::options::get_pinned_files_option,
          cli::actions::get_pinned_files},
diff --git a/repertory/repertory/include/cli/get_directory_items.hpp b/repertory/repertory/include/cli/get_directory_items.hpp
index fc65b26f..6537ed43 100644
--- a/repertory/repertory/include/cli/get_directory_items.hpp
+++ b/repertory/repertory/include/cli/get_directory_items.hpp
@@ -54,4 +54,4 @@ get_directory_items(std::vector<const char *> args,
 }
 } // namespace repertory::cli::actions
 
-#endif // REPERTORY_INCLUDE_CLI_GETDIRECTORYITEMS_HPP_
+#endif // REPERTORY_INCLUDE_CLI_GET_DIRECTORY_ITEMS_HPP_
diff --git a/repertory/repertory/include/cli/get_item_info.hpp b/repertory/repertory/include/cli/get_item_info.hpp
new file mode 100644
index 00000000..32ff5479
--- /dev/null
+++ b/repertory/repertory/include/cli/get_item_info.hpp
@@ -0,0 +1,56 @@
+/*
+  Copyright <2018-2025> <scott.e.graves@protonmail.com>
+
+  Permission is hereby granted, free of charge, to any person obtaining a copy
+  of this software and associated documentation files (the "Software"), to deal
+  in the Software without restriction, including without limitation the rights
+  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+  copies of the Software, and to permit persons to whom the Software is
+  furnished to do so, subject to the following conditions:
+
+  The above copyright notice and this permission notice shall be included in all
+  copies or substantial portions of the Software.
+
+  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+  SOFTWARE.
+*/
+#ifndef REPERTORY_INCLUDE_CLI_GET_ITEM_INFO_HPP_
+#define REPERTORY_INCLUDE_CLI_GET_ITEM_INFO_HPP_
+
+#include "cli/common.hpp"
+
+namespace repertory::cli::actions {
+[[nodiscard]] inline auto
+get_item_info(std::vector<const char *> args, const std::string &data_directory,
+              provider_type prov, const std::string & /* unique_id */,
+              std::string user, std::string password) -> exit_code {
+  std::string data;
+  auto ret = utils::cli::parse_string_option(
+      args, repertory::utils::cli::options::get_item_info_option, data);
+  if (ret == exit_code::success) {
+    auto port = app_config::default_api_port(prov);
+    utils::cli::get_api_authentication_data(user, password, port, prov,
+                                            data_directory);
+    auto response = client({.host = "localhost",
+                            .password = password,
+                            .port = port,
+                            .user = user})
+                        .get_item_info(data);
+    if (response.response_type == rpc_response_type::success) {
+      std::cout << response.data.dump(2) << std::endl;
+    } else {
+      std::cerr << response.data.dump(2) << std::endl;
+      ret = exit_code::export_failed;
+    }
+  }
+
+  return ret;
+}
+} // namespace repertory::cli::actions
+
+#endif // REPERTORY_INCLUDE_CLI_GET_ITEM_INFO_HPP_
diff --git a/repertory/repertory/include/cli/help.hpp b/repertory/repertory/include/cli/help.hpp
index 176443bb..3a6a5235 100644
--- a/repertory/repertory/include/cli/help.hpp
+++ b/repertory/repertory/include/cli/help.hpp
@@ -52,6 +52,10 @@ template <typename drive> inline void help(std::vector<const char *> args) {
                "json format"
             << std::endl
             << "       [API path]" << std::endl;
+  std::cout << "    -gi,--get_item_info        Get item information in "
+               "json format"
+            << std::endl
+            << "       [API path]" << std::endl;
   std::cout
       << "    -gpf,--get_pinned_files           Get a list of all pinned files"
       << std::endl;
diff --git a/repertory/repertory_test/include/mocks/mock_provider.hpp b/repertory/repertory_test/include/mocks/mock_provider.hpp
index 98b2a05a..3dddb698 100644
--- a/repertory/repertory_test/include/mocks/mock_provider.hpp
+++ b/repertory/repertory_test/include/mocks/mock_provider.hpp
@@ -57,6 +57,10 @@ public:
   MOCK_METHOD(std::uint64_t, get_directory_item_count,
               (const std::string &api_path), (const, override));
 
+  MOCK_METHOD(api_error, get_directory_item,
+              (const std::string &api_path, directory_item &item),
+              (const, override));
+
   MOCK_METHOD(api_error, get_directory_items,
               (const std::string &api_path, directory_item_list &list),
               (const, override));