Merge branch 'develop' into feature/RDKEMW-6331

Author: smanes0213

.github/workflows/component-release.yml

@@ -32,7 +32,7 @@ jobs:
       - name: Clone the project and start release
         run: |
           set -e
-          git clone https://x-access-token:${{ secrets.GITHUB_TOKEN }}@github.com/${{ github.repository }} project
+          git clone https://x-access-token:${{ secrets.RDKCM_RDKE }}@github.com/${{ github.repository }} project
           cd project
           git fetch --all
           git checkout main || git checkout -b main origin/main
@@ -51,7 +51,7 @@ jobs:
           # Extract version from PR description
           PR_DESC="${{ github.event.pull_request.body }}"
           # Get top tag from CHANGELOG.md
-          TOP_TAG=$(grep -m 1 -oP '^#### \[\K[^\]]+' CHANGELOG.md)
+          TOP_TAG=$(grep -m 1 -oP '^##\s+\K[0-9]+\.[0-9]+\.[0-9]+' CHANGELOG.md)
           if [[ -z "$TOP_TAG" ]]; then
             echo "No version found in CHANGELOG.md!"
             exit 1

CHANGELOG.md

@@ -4,9 +4,29 @@ All notable changes to this project will be documented in this file. Dates are d
 
 Generated by [`auto-changelog`](https://github.com/CookPete/auto-changelog).
 
+#### [1.15.4](https://github.com/rdkcentral/entservices-apis/compare/1.15.3...1.15.4)
+
+- RDKEMW-4778 : Update the regex for getting the latest tag [`#489`](https://github.com/rdkcentral/entservices-apis/pull/489)
+- Update component-release.yml [`#488`](https://github.com/rdkcentral/entservices-apis/pull/488)
+- Merge tag '1.15.3' into develop [`352f37f`](https://github.com/rdkcentral/entservices-apis/commit/352f37f98ea69ffb6eee6e036cfa7788ee45c64e)
+
+#### [1.15.3](https://github.com/rdkcentral/entservices-apis/compare/1.15.2...1.15.3)
+
+> 29 August 2025
+
+- RDKEMW-3796: IPackageManager.h Interface header not following coding [`#457`](https://github.com/rdkcentral/entservices-apis/pull/457)
+- RDKEMW-6924: Create documentation for StorageManager [`#470`](https://github.com/rdkcentral/entservices-apis/pull/470)
+- RDKEMW-6941: Update Xcast API documentation [`#473`](https://github.com/rdkcentral/entservices-apis/pull/473)
+- 1.15.3 release changelog updates [`e15616e`](https://github.com/rdkcentral/entservices-apis/commit/e15616e6ea81946cd97f782c38496cd08b320e9a)
+- Merge tag '1.15.2' into develop [`e42222a`](https://github.com/rdkcentral/entservices-apis/commit/e42222aef3cd014dbbcd63402f937bdda5a7673c)
+- RDKEMW-3796: IPackageManager.h Interface header not following coding guidelines [`435d65f`](https://github.com/rdkcentral/entservices-apis/commit/435d65fcf1b467ac909097d40e8928d46a2a188c)
+
 #### [1.15.2](https://github.com/rdkcentral/entservices-apis/compare/1.15.1...1.15.2)
 
+> 20 August 2025
+
 - RDKEMW-6451: Improve robustness in PowerManager Plugin [`#449`](https://github.com/rdkcentral/entservices-apis/pull/449)
+- 1.15.2 release change log updates [`7fd27bd`](https://github.com/rdkcentral/entservices-apis/commit/7fd27bda42ff6fa0b0e2448592528a4bffafed82)
 - Merge tag '1.15.1' into develop [`9e68cdc`](https://github.com/rdkcentral/entservices-apis/commit/9e68cdce0875b7986a65de5fe0d8e86fda324a8a)
 
 #### [1.15.1](https://github.com/rdkcentral/entservices-apis/compare/1.15.0...1.15.1)

apis/PackageManager/IPackageManager.h

@@ -27,38 +27,47 @@
 namespace WPEFramework {
 namespace Exchange {
 
-    /* @json */
+    // @json 1.0.0 @text:keep
     struct EXTERNAL IPackageManager : virtual public Core::IUnknown {
 
         using IStringIterator = RPC::IIteratorType<string, RPC::ID_STRINGITERATOR>;
 
         enum { ID = ID_PACKAGEMANAGER };
 
-        /* @brief Download the application bundle. */
-        virtual uint32_t Install(const string& type,
+        /** Install an application bundle */
+        // @text install
+        // @brief Downloads and installs an application bundle.
+        virtual Core::hresult Install(const string& type,
                 const string& id,
                 const string& version,
                 const string& url,
                 const string& appName,
                 const string& category,
                 string& handle /* @out */) = 0;
 
-        /* @brief Uninstall the application. */
-        virtual uint32_t Uninstall(const string& type,
+        /** Uninstall an application */
+        // @text uninstall
+        // @brief Uninstalls an application.
+        virtual Core::hresult Uninstall(const string& type,
                 const string& id,
                 const string& version,
                 const string& uninstallType,
                 string& handle /* @out */) = 0;
-        /* @brief Download arbitrary application's resource file. */
-        virtual uint32_t Download(const string& type,
+
+        /** Download a resource for an app */
+        // @text download
+        // @brief Downloads a resource file for an application.
+        virtual Core::hresult Download(const string& type,
                 const string& id,
                 const string& version,
                 const string& resKey,
                 const string& url,
                 string& handle /* @out */) = 0;
 
-        /* @brief Delete persistent data stored locally. */
-        virtual uint32_t Reset(const string& type,
+        /** Reset application state */
+        // @text reset
+        // @brief Deletes all persistent local data of the application.
+        virtual Core::hresult Reset(const string& type,
                 const string& id,
                 const string& version,
                 const string& resetType) = 0;
@@ -76,8 +85,10 @@ namespace Exchange {
                 StorageDetails persistent;
         };
 
-        /* @brief Information on the storage usage. */
-        virtual uint32_t GetStorageDetails(const string& type,
+        /** Get application storage usage */
+        // @text getStorageDetails
+        // @brief Retrieves details about app and persistent storage usage.
+        virtual Core::hresult GetStorageDetails(const string& type,
                 const string& id,
                 const string& version,
                 StorageInfo& storageinfo /* @out */) const = 0;
@@ -95,45 +106,58 @@ namespace Exchange {
             string url;
         };
 
-        /* @brief Set an arbitrary metadata. */
-        virtual uint32_t SetAuxMetadata(const string& type,
+        /** Set custom metadata */
+        // @text setAuxMetadata
+        // @brief Sets a key-value pair of metadata for the application.
+        virtual Core::hresult SetAuxMetadata(const string& type,
                 const string& id,
                 const string& version,
                 const string& key,
                 const string& value) = 0;
 
-        /* @brief Clears an arbitrary metadata. */
-        virtual uint32_t ClearAuxMetadata(const string& type,
+        /** Clear custom metadata */
+        // @text clearAuxMetadata
+        // @brief Clears the specified metadata key.
+        virtual Core::hresult ClearAuxMetadata(const string& type,
                 const string& id,
                 const string& version,
                 const string& key) = 0;
 
-        /* @brief Get application metadata. */
-        virtual uint32_t GetMetadata(const string& type,
+        /** Get all metadata and resources */
+        // @text getMetadata
+        // @brief Retrieves metadata and auxiliary resource list for an application.
+        virtual Core::hresult GetMetadata(const string& type,
                 const string& id,
                 const string& version,
                 MetadataPayload& metadata /* @out */,
                 IPackageManager::IKeyValueIterator*& resources /* @out */,
                 IPackageManager::IKeyValueIterator*& auxMetadata /* @out */) const = 0;
 
-        /* @brief Cancel asynchronous request. */
-        virtual uint32_t Cancel(const string& handle) = 0;
+        /** Cancel an ongoing operation */
+        // @text cancel
+        // @brief Cancels a previously issued asynchronous request.
+        virtual Core::hresult Cancel(const string& handle) = 0;
 
-        /* @brief Estimated progress of a request. */
-        virtual uint32_t GetProgress(const string& handle, uint32_t& progress /* @out */) const = 0;
+        /** Get progress of an operation */
+        // @text getProgress
+        // @brief Provides the current progress of an ongoing operation.
+        virtual Core::hresult GetProgress(const string& handle, uint32_t& progress /* @out */) const = 0;
 
         /* @event */
         struct EXTERNAL INotification : virtual public Core::IUnknown {
 
             enum {ID = ID_PACKAGEMANAGER_NOTIFICATION};
 
-            /* @brief Completion of asynchronous operation. */
+            // @text operationStatus
+            // @brief Notifies completion of an asynchronous operation.
             virtual void OperationStatus(const string& handle, const string& operation, const string& type, const string& id,
                                          const string& version, const string& status, const string& details) = 0;
         };
 
-        virtual uint32_t Register(IPackageManager::INotification* notification) = 0;
-        virtual uint32_t Unregister(IPackageManager::INotification* notification) = 0;
+        /** Register for notifications */
+        virtual Core::hresult Register(IPackageManager::INotification* notification) = 0;
+        /** Unregister from notifications */
+        virtual Core::hresult Unregister(IPackageManager::INotification* notification) = 0;
 
         struct EXTERNAL PackageKey {            
             string id;
@@ -142,34 +166,42 @@ namespace Exchange {
 
         using IPackageKeyIterator = RPC::IIteratorType<PackageKey, ID_PACKAGEMANAGER_PACKAGE_KEY_ITERATOR>;
 
-        /* @brief List installed applications. */
-        virtual uint32_t GetList(
+        /** List installed apps */
+        // @text getList
+        // @brief Retrieves list of installed apps matching given filters.
+        virtual Core::hresult GetList(
                 const string& type,
                 const string& id,
                 const string& version,
                 const string& appName,
                 const string& category,
                 IPackageKeyIterator*& installedIds /* @out */) const = 0; 
 
-        /* @brief Lock the application. Preventing uninstallation. */
-        virtual uint32_t Lock(const string& type,
+        /** Lock application from uninstalling */
+        // @text lock
+        // @brief Locks an application to prevent uninstallation.
+        virtual Core::hresult Lock(const string& type,
                 const string& id,
                 const string& version,
                 const string& reason,
                 const string& owner,
                 string& handle /* @out */) = 0;
 
 
-        /* @brief Unlock application. */
-        virtual uint32_t Unlock(const string& handle) = 0;
+        /** Unlock application */
+        // @text unlock
+        // @brief Unlocks a previously locked application.
+        virtual Core::hresult Unlock(const string& handle) = 0;
 
         struct LockInfo {
             string reason;
             string owner;
         };
 
-        /* @brief Get lock info. */
-        virtual uint32_t GetLockInfo(const string& type,
+        /** Get lock details */
+        // @text getLockInfo
+        // @brief Provides lock reason and owner for an app.
+        virtual Core::hresult GetLockInfo(const string& type,
                 const string& id,
                 const string& version,
                 LockInfo& result /* @out */) const = 0;
@@ -180,8 +212,8 @@ namespace Exchange {
 
                 enum { ID = ID_PACKAGEMANAGER_BROKER };
 
-                virtual uint32_t Offer(IPackageManager* packagemanager) = 0;
-                virtual uint32_t Revoke(const IPackageManager* packagemanager) = 0;
+                virtual Core::hresult Offer(IPackageManager* packagemanager) = 0;
+                virtual Core::hresult Revoke(const IPackageManager* packagemanager) = 0;
 
     };
 
@@ -193,6 +225,5 @@ namespace Exchange {
                                          const string& version, const string& status, const string& details) = 0;
 
     };
-
 }
 }