Fix error and update packages

Author: nuzil

INSTALL.md

@@ -4,6 +4,7 @@
 
 - Node.js 18+
 - Adobe I/O CLI
+- For PaaS integration with Admin UI: Adobe Commerce Admin UI SDK v3+ (see [Installation Guide](https://developer.adobe.com/commerce/extensibility/admin-ui-sdk/installation/))
 
 ## Adobe Console preparation
 
@@ -31,9 +32,25 @@ To required environment add:
 
 1. Clone the repository
 2. Run `npm install` to install the dependencies
-3. Go to [Project](https://developer.adobe.com/console), select Environment and click on "Download All" button.
-4. Copy the env.dist file into .env file. `cp env.dist .env`
-4. Execute `aio app use <path-to-file>` with file you just downloaded. (Merge files if you already have .env file)
+3. Copy the env.dist file into .env file: `cp env.dist .env`
+4. Configure the project environment using one of the following methods:
+
+**Option A: Download configuration from Console**
+
+   - Go to [Adobe Developer Console](https://developer.adobe.com/console), select your Project and Environment
+   - Click on "Download All" button
+   - Execute `aio app use <path-to-downloaded-file>` (Merge files if you already have .env file)
+
+**Option B: Configure via CLI**
+
+   ```bash
+   aio login
+   aio console org select
+   aio console project select
+   aio console workspace select
+   aio app use
+   ```
+
 5. Edit `.env` file with your project details.
 Set following variables: 
 
@@ -64,9 +81,12 @@ COMMERCE_BASE_URL= // Commerce instance REST API Url
 
 In env.dist file you will find set of Auth parameters.
 
-**For Adobe Commerce PaaS:**
+**For Adobe Commerce (PaaS Only):**
 
-These values can be copied from the Integration Details under System > Integrations in your Adobe Commerce backend
+> [!NOTE]
+> For SaaS Installation those values are not needed and can be skipped.
+
+These values can be copied from the Integration Details under System > Integrations in your Adobe Commerce backend.
 
 ```
 COMMERCE_CONSUMER_KEY=
@@ -75,7 +95,7 @@ COMMERCE_ACCESS_TOKEN=
 COMMERCE_ACCESS_TOKEN_SECRET=
 ```
 
-**For Adobe Commerce SaaS:**
+**For Adobe Commerce (SaaS & PaaS):**
 
 Documentation how to get these values is available here: https://developer.adobe.com/developer-console/docs/guides/authentication/ServerToServerAuthentication/implementation
 
@@ -108,4 +128,32 @@ For Adobe Commerce SaaS, you can add the module to be available in your Commerce
 3. Click "Configure extensions" and choose respective Environment and Application.
 4. Save changes.
 
-For more information and troubleshooting please go to: https://developer.adobe.com/commerce/extensibility/admin-ui-sdk/configuration/
+For more information and troubleshooting please go to: https://developer.adobe.com/commerce/extensibility/admin-ui-sdk/configuration/
+
+## Adding to Adobe Admin UI (PaaS)
+
+For Adobe Commerce PaaS (On-Premise/Cloud), you need to install and configure the Admin UI SDK module.
+
+### Install the Admin UI SDK Module
+
+1. Install the module via Composer:
+
+```bash
+composer require "magento/commerce-backend-sdk": ">=3.0"
+```
+
+2. Enable the module (for On-premises installation):
+
+```bash
+bin/magento module:enable Magento_AdminUiSdk
+bin/magento setup:upgrade
+bin/magento cache:clean
+```
+
+### Configure the Admin UI SDK
+
+Follow the official Adobe documentation for configuration steps:
+- [Admin UI SDK Configuration](https://developer.adobe.com/commerce/extensibility/admin-ui-sdk/configuration/)
+
+For detailed installation instructions, please refer to:
+- [Admin UI SDK Installation](https://developer.adobe.com/commerce/extensibility/admin-ui-sdk/installation/)

README.md

@@ -8,6 +8,11 @@ Module compatible with both Adobe Commerce SaaS and PaaS.
 
 Please see [INSTALL.md](INSTALL.md) for more details.
 
+> [!IMPORTANT]
+> This application is designed to run within the Adobe Experience Cloud Shell or Adobe Commerce Admin UI. 
+> Viewing the deployed application directly via its URL outside of these environments will result in the UI not loading correctly.
+> Always access the application through the Experience Cloud Shell or via the Adobe Commerce Admin panel.
+
 ## Home page / Grid
 
 On the application home page you will see list of the feeds:
@@ -258,10 +263,10 @@ Add attributes.value is an Array of attributes, to get specific attribute, you c
 ```xml
 <item>
   <sku>{{sku}}</sku>
-  <weight>{{description}}</weight>
+  <description>{{description}}</description>
   <image>{{images.url count="2"}}</image>
   <color>{{attributes.value code='color'}}</color>
-  <color>{{attributes.value code='weight'}}</color>
+  <weight>{{attributes.value code='weight'}}</weight>
   <price>{{SimpleProductView||price.final.amount.value}} {{SimpleProductView||price.final.amount.currency}}</price>
 </item>
 ```

adobe-api/mesh/README.md

@@ -63,11 +63,11 @@ If Adobe Mesh Gql response fail need to check source URL (magento.host): SSL cer
         "handler": {
           "openapi": {
             "source": "https://magento.host/rest/schema?services=storeWebsiteRepositoryV1",
-             // can be updated to /rest/schema?services=all if we want to use all rest enpoint in mesh
+             // can be updated to /rest/schema?services=all if we want to use all rest endpoint in mesh
             
             "schemaHeaders": {
               "Authorization": "Bearer {context.headers['x-ac-api-token']}" 
-              // magento integration api token. Must be included to Headers in request to Mesh GQl enpoint 
+              // magento integration api token. Must be included to Headers in request to Mesh GQl endpoint 
             },
             "operationHeaders": {
               "Authorization": "Bearer {context.headers['x-ac-api-token']}",

install.yml

@@ -4,7 +4,6 @@ $id: https://adobe.io/schemas/app-builder-templates/1
 categories:
   - action
   - ui
-  - graphql-mesh
   - events
   - helper-template
 
@@ -17,6 +16,7 @@ apis:
   - code: AdobeIOManagementAPISDK
   - code: AdobeCommerceWithAdobeID
   - code: GraphQLServiceSDK
+  - code: ACCS-REST-API
 
 extensions:
   - extensionPointId: commerce/backend-ui/1