cm: imagemanager: add imageunpacker itf

Signed-off-by: Mykola Solianko <[email protected]>

Author: Mykola Solianko

src/core/cm/imagemanager/CMakeLists.txt

@@ -20,7 +20,7 @@ set(SOURCES imagemanager.cpp)
 # Headers
 # ######################################################################################################################
 
-set(HEADERS itf/imagemanager.hpp itf/storage.hpp itf/statusnotifier.hpp imagemanager.hpp)
+set(HEADERS itf/imagemanager.hpp itf/imageunpacker.hpp itf/storage.hpp itf/statusnotifier.hpp imagemanager.hpp)
 
 # ######################################################################################################################
 # Libraries

src/core/cm/imagemanager/itf/imageunpacker.hpp

@@ -0,0 +1,49 @@
+/*
+ * Copyright (C) 2025 EPAM Systems, Inc.
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ */
+#ifndef AOS_CORE_CM_IMAGEMANAGER_ITF_IMAGEUNPACKER_HPP_
+#define AOS_CORE_CM_IMAGEMANAGER_ITF_IMAGEUNPACKER_HPP_
+
+#include <core/common/tools/string.hpp>
+
+namespace aos::cm::imagemanager {
+
+/** @addtogroup cm Communication Manager
+ *  @{
+ */
+
+/**
+ * Image unpacker interface.
+ */
+class ImageUnpackerItf {
+public:
+    /**
+     * Destructor.
+     */
+    virtual ~ImageUnpackerItf() = default;
+
+    /**
+     * Returns the size of the uncompressed file in the tar.
+     *
+     * @param tarPath path to the tar file.
+     * @param filePath path to the file in the tar.
+     * @return RetWithError<size_t>.
+     */
+    virtual RetWithError<size_t> GetUncompressedFileSizeInTar(const String& tarPath, const String& filePath) = 0;
+
+    /**
+     * Extracts a file from a tar.
+     *
+     * @param tarPath path to the tar file.
+     * @param filePath path to the file in the tar.
+     * @param outputPath path to the output file.
+     * @return Error.
+     */
+    virtual Error ExtractFileFromTar(const String& tarPath, const String& filePath, const String& outputPath) = 0;
+};
+
+} // namespace aos::cm::imagemanager
+
+#endif // AOS_CORE_CM_IMAGEMANAGER_ITF_IMAGEUNPACKER_HPP_

src/core/cm/imagemanager/tests/mocks/imageunpacker.hpp

@@ -0,0 +1,26 @@
+/*
+ * Copyright (C) 2025 EPAM Systems, Inc.
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+#ifndef AOS_CORE_CM_IMAGEMANAGER_TESTS_MOCKS_IMAGEUNPACKER_HPP_
+#define AOS_CORE_CM_IMAGEMANAGER_TESTS_MOCKS_IMAGEUNPACKER_HPP_
+
+#include <gmock/gmock.h>
+
+#include <core/cm/imagemanager/itf/imageunpacker.hpp>
+
+namespace aos::cm::imagemanager {
+
+class MockImageUnpacker : public ImageUnpackerItf {
+public:
+    MOCK_METHOD(RetWithError<size_t>, GetUncompressedFileSizeInTar, (const String& tarPath, const String& filePath),
+        (override));
+    MOCK_METHOD(Error, ExtractFileFromTar, (const String& tarPath, const String& filePath, const String& outputPath),
+        (override));
+};
+
+} // namespace aos::cm::imagemanager
+
+#endif