cm: imagemanager: add initial image manager interfaces and doc

Signed-off-by: Oleksandr Grytsov <[email protected]>

Author: al1img

src/core/cm/imagemanager/CMakeLists.txt

@@ -14,7 +14,7 @@ set(TARGET_NAME imagemanager)
 # Headers
 # ######################################################################################################################
 
-set(HEADERS imageprovider.hpp)
+set(HEADERS itf/updateitemlisterner.hpp)
 
 # ######################################################################################################################
 # Target

src/core/cm/imagemanager/imagemanager.md

@@ -0,0 +1,88 @@
+# Image manager
+
+Image manager stores update item images and provide update item image info for other modules.
+
+It implements the following interfaces:
+
+* [aos::cm::updatemanager::UpdateItemManagerItf]() - update item manager for [updatemanager]() module;
+* [aos::cm::launcher::UpdateItemProviderItf]() - update item provider for [launcher]() module;
+* [aos::cm::smcontroller::UpdateImageProviderItf]() - update image provider for [smcontroller]() module;
+* [aos::cm::imagemanager::UpdateItemNotifierItf]() - update item notifier to notify other modules about update items
+  action.
+
+It requires the following interfaces:
+
+* ...
+
+```mermaid
+classDiagram
+    class ImageManager["aos::cm::imagemanager::ImageManager"] {
+    }
+
+    class UpdateItemManagerItf["aos::cm::updatemanager::UpdateItemManagerItf"] {
+        <<interface>>
+    }
+
+    class UpdateItemProviderItf ["aos::cm::launcher::UpdateItemProviderItf"] {
+        <<interface>>
+    }
+    
+    class UpdateImageProviderItf ["aos::cm::smcontroller::UpdateImageProviderItf"] {
+        <<interface>>
+    }
+
+    class UpdateItemNotifierItf ["aos::cm::imagemanager::UpdateItemNotifierItf"] {
+        <<interface>>
+    }
+
+    ImageManager <|.. UpdateItemManagerItf
+    ImageManager <|.. UpdateItemProviderItf
+    ImageManager <|.. UpdateImageProviderItf
+    ImageManager <|.. UpdateItemNotifierItf
+```
+
+## aos::cm::updatemanager::UpdateItemManagerItf
+
+### GetUpdateItemsStatuses
+
+Returns currently installed images statuses for each update item.
+
+### InstallUpdateItem
+
+Installs update item images.
+
+### UninstallUpdateItem
+
+Uninstalls update item images.
+
+### RevertUpdateItem
+
+Reverts update item images.
+
+## aos::cm::launcher::UpdateItemProviderItf
+
+### GetServiceNetworkData
+
+Returns network data for specified service.
+
+### GetUpdateItemVersion
+
+Returns currently installed update item version.
+
+## aos::cm::smcontroller::UpdateImageProviderItf
+
+### GetUpdateImageInfo
+
+Returns update image info for specified platform.
+
+## aos::cm::imagemanager::UpdateItemNotifierItf
+
+Notifies subscribers about changing update item states.
+
+### SubscribeListener
+
+Subscribes to changing update item states.
+
+### UnsubscribeListener
+
+Unsubscribes from changing update item states.

src/core/cm/imagemanager/imageprovider.hpp

@@ -0,0 +1,60 @@
+/*
+ * Copyright (C) 2025 EPAM Systems, Inc.
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+#ifndef AOS_CORE_CM_IMAGEMANAGER_ITF_UPDATEITEMLISTENER_HPP_
+#define AOS_CORE_CM_IMAGEMANAGER_ITF_UPDATEITEMLISTENER_HPP_
+
+#include <core/common/cloudprotocol/common.hpp>
+
+namespace aos::cm::imagemanager {
+
+/**
+ * Interface for receiving notification about update items states.
+ */
+class UpdateItemListenerItf {
+public:
+    /**
+     * Destructor.
+     */
+    virtual ~UpdateItemListenerItf() = default;
+
+    /**
+     * Notifies about update item removal.
+     *
+     * @param identifier identifier of the removed update item.
+     */
+    virtual void OnUpdateItemRemoved(const cloudprotocol::Identifier& identifier) = 0;
+};
+
+/**
+ * Interface for notifying about update item states.
+ */
+class UpdateItemNotifierItf {
+    /**
+     * Destructor.
+     */
+    virtual ~UpdateItemNotifierItf() = default;
+
+    /**
+     * Subscribes update item notifications.
+     *
+     * @param listener update item listener.
+     * @return Error.
+     */
+    virtual Error SubscribeListener(UpdateItemListenerItf& listener) = 0;
+
+    /**
+     * Unsubscribes from update item notifications.
+     *
+     * @param listener update item listener.
+     * @return Error.
+     */
+    virtual Error UnsubscribeListener(UpdateItemListenerItf& listener) = 0;
+};
+
+} // namespace aos::cm::imagemanager
+
+#endif