trm-client 7.6.0 → 7.7.1

package/README.md

@@ -12,22 +12,195 @@
 
 [trm-client](https://www.npmjs.com/package/trm-client) is the CLI implementation of the core functionalities of TRM.
 
-**TRM (Transport Request Manager)** is a package manager inspired solution built leveraging CTS that simplifies SAP ABAP transports.
+🚚 **TRM (Transport Request Manager)** is a package manager inspired solution built leveraging CTS that simplifies SAP ABAP transports.
+
+<p align="center">
+  <img src="https://docs.trmregistry.com/logo.png" alt="TRM Logo" />
+</p>
+
+TRM introduces **package-based software delivery** to the SAP ecosystem, bringing with it semantic versioning, dependency management, and automated deployment activities.
+
+---
+
+# What is TRM?
+
+TRM is a software that transforms how custom ABAP developments are published, installed, and maintained across SAP landscapes.
+Inspired by modern package managers, TRM introduces a declarative, version-controlled, and automated way to manage your SAP transports.
+
+With TRM, you can:
+
+- **Define a manifest** for each ABAP package (similar to `package.json` with Node.js or `pom.xml` with Maven)
+- **Version your products** ([SemVer](https://semver.org/) compliance)
+- **Declare dependencies** (to other TRM packages, SAP standard objects, or customizing data)
+- **Automate post-install activities**, such as client dependant customizing, cache invalidation etc.
+- **Validate system requirements** prior to installation
+- **Compare versions** of the same product across multiple SAP systems (in or outside the same landscape)
+- **Distribute** your product release to the public or to a restricted number of users:
+  - Registry (e.g., [trmregistry.com](https://trmregistry.com) or private registry)
+  - Local `.trm` files for offline installations
+
+## Modern approach for ABAP
+
+- Publish ABAP packages from a **central development system**
+- Deliver packages to target systems (outside of the original landscape e.g. customers development system) using a single CLI command (or in a pipeline)
+- Full support for **workbench objects**, **customizing**, and **translations**
+
+## Structured Manifest
+
+Each package includes a `manifest.json` that declares:
+
+- Version and metadata
+- System requirements
+- Dependencies
+- Post-install scripts
 
 # Documentation
 
-You can find the full documentation at [docs.trmregistry.com](https://docs.trmregistry.com).
+Full documentation can be seen at [https://docs.trmregistry.com/](https://docs.trmregistry.com).
+
+---
+
+<!-- START OF SETUP.MD -->
+
+# Dockerized version (Recommended)
+
+If you are using [Docker](https://www.docker.com/), the recommended approach is to use [trm-docker](https://github.com/RegestaItalia/trm-docker).
+
+## Download Docker Run Script
+
+This script is a small utility used to run TRM inside Docker. After installing the required SAP proprietary tools, the script can be moved into a directory included in your `PATH` so that it can be executed from anywhere.
+
+1. Go to the [trm-docker repository](https://github.com/RegestaItalia/trm-docker)
+2. Download the script corresponding to your operating system:
+   - **Windows**: download [win.cmd](https://raw.githubusercontent.com/RegestaItalia/trm-docker/refs/heads/main/win.cmd) and rename it to `trm.cmd`
+   - **macOS / Linux**: download [macos](https://raw.githubusercontent.com/RegestaItalia/trm-docker/refs/heads/main/macos), rename it to `trm`, and make it executable:
+     ```bash
+     chmod +x trm
+     ```
+3. In the same directory where you placed the script, create a folder named `init`.
+
+This `init` folder will later contain the SAP proprietary files required by TRM.
+
+## Download SAPCAR and SAPEXE and Extract Required Files
+
+SAPCAR is used to extract `.SAR` archives downloaded from SAP Software Center.
+
+### Download SAPCAR
+
+1. Log in to the [SAP Software Center](https://me.sap.com/softwarecenter)
+2. Click **SUPPORT PACKAGES & PATCHES**
+3. Expand **By Alphabetical Index (A–Z)** and select **S**
+4. Click **SAPCAR**
+5. Choose the **latest version**
+6. On the download page select your operating system:
+   - **WINDOWS ON X64 64BIT**
+   - **MACOS ON ARM64BIT**
+   - **MACOS X 64-BIT**
+7. Download:
+   - **Windows** → latest `.EXE`
+   - **macOS** → latest `.ZIP`
+8. If using macOS, extract the archive and make the binary executable:
+   ```bash
+   chmod +x SAPCAR
+   ```
+
+### Download SAP Kernel Files
+
+1. Go back to **SUPPORT PACKAGES & PATCHES**
+2. Expand **By Alphabetical Index (A–Z)** and select **K**
+3. Click **SAP KERNEL 64-BIT**
+4. Choose the **latest version**
+5. On the download page select **LINUX ON X86_64 64BIT**
+6. Download the latest **SAPEXE** archive  
+   (file name similar to `SAPEXE_###-########.SAR`)
+
+### Extract the Required Files
+
+1. Place the downloaded `SAPEXE_*.SAR` file in the same directory as `SAPCAR`.
+2. Extract it:
+
+   **Windows**
+   ```bash
+   SAPCAR -xvf SAPEXE_###-########.SAR
+   ```
+
+   **macOS / Linux**
+   ```bash
+   ./SAPCAR -xvf SAPEXE_###-########.SAR
+   ```
+
+3. After extraction, move the following files into the previously created `init` folder:
+
+   ```
+   R3trans
+   libicudata##.so
+   libicui18n##.so
+   libicuuc##.so
+   ```
+
+4. *(Optional)* If you want RFC functionality available in TRM, also move the following files into the `init` folder:
+
+   ```
+   startrfc
+   rfcexec
+   libsapnwrfc.so
+   libsapucum.so
+   ```
+
+## Pull docker image
+
+Execute this command to pull the latest docker image
+
+```bash
+docker pull --platform=linux/amd64 abaptrm/docker
+```
+
+## Initial Installation via Script
+
+Once the `init` folder is populated and the `trm` script is ready, run the script from the directory where it is located.
+
+**Windows**
+```bash
+trm
+```
+
+**macOS / Linux**
+```bash
+./trm
+```
+
+The first execution performs the initial setup of the Docker environment.\
+After the installation completes, you may move the script to a directory included in your system `PATH` so it can be executed from anywhere.
+
+**Windows**
+```
+C:\Windows\System32
+```
+
+**macOS / Linux**
+```
+/usr/local/bin
+```
+
+After this step, you can simply run:
+
+```bash
+trm
+```
+
+from any directory.
+
+---
 
-- [Setup](/docs/setup.md)
-- [Publish and install](https://docs.trmregistry.com/#/examples/1_publish_and_install)
+# Install via Npm
 
-## Install
+With [Node.js and npm](https://nodejs.org/en/download) installed, you can install [trm-client](https://www.npmjs.com/package/trm-client) via npm, as it is distributed as a Node.js package.
 
-First, make sure you have all the [requirements installed](/docs/setup.md).
+## TODO
 
-You can then install the CLI via npm:
+<!-- END OF SETUP.MD -->
 
-`npm install trm-client -g`
+---
 
 # Contributing
 

package/changelog.txt

@@ -8,6 +8,14 @@ Legend
 + : added
 - : removed
 
+2026-03-23 v7.7.1
+-------------------
+* sapgui connections
+
+2026-03-23 v7.7.0
+-------------------
+* pack command usage
+
 2026-03-11 v7.6.0
 -------------------
 * show subcommands in --help

package/dist/command/implementations/Publish.js

@@ -26,9 +26,9 @@ class Publish extends AbstractCommand_1.AbstractCommand {
         this.registerOpts.requiresTrmDependencies = true;
         if (this.name === 'pack') {
             this.command.description(`Export a package to local file.`);
+            this.command.argument(`<package>`, `Name of the package`);
+            this.command.argument(`<version>`, `Version of the release`);
             this.command.argument(`[filename]`, `Name (or path) of the output file.`);
-            this.command.option(`--package <package>`, `Name of the package`);
-            this.command.option(`--version <version>`, `Version of the release`);
         }
         else {
             this.registerOpts.requiresRegistry = true;

package/dist/utils/getSapLogonConnections.js

@@ -53,8 +53,8 @@ function getSapLogonConnections() {
         if (sapLandscape) {
             const sXml = fs.readFileSync(GlobalContext_1.GlobalContext.getInstance().getSettings().sapLandscape, { encoding: 'utf8', flag: 'r' });
             const result = yield (0, xml2js_1.xml2js)(sXml);
-            try {
-                result.Landscape.Services[0].Service.forEach((xmlObj) => {
+            result.Landscape.Services[0].Service.forEach((xmlObj) => {
+                try {
                     var obj = xmlObj['$'];
                     var addrMatches = obj.server.match(/(.*)\:(\d*)$/);
                     var ashost = addrMatches[1];
@@ -75,9 +75,9 @@ function getSapLogonConnections() {
                         ashost,
                         saprouter
                     });
-                });
-            }
-            catch (_a) { }
+                }
+                catch (_a) { }
+            });
         }
         return systems;
     });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "trm-client",
-  "version": "7.6.0",
+  "version": "7.7.1",
   "description": "TRM (Transport Request Manager) Client",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",