trm-core 8.5.3 → 9.0.0

package/README.md

@@ -4,26 +4,32 @@
 [![Core License](https://img.shields.io/github/license/RegestaItalia/trm-core)](https://github.com/RegestaItalia/trm-core)
 [![Core Latest version](https://img.shields.io/npm/v/trm-core)](https://www.npmjs.com/package/trm-core)
 [![Core Installs](https://img.shields.io/npm/dt/trm-core)](https://www.npmjs.com/package/trm-core)
+[![View Code Wiki](https://assets.codewiki.google/readme-badge/static.svg)](https://codewiki.google/github.com/regestaitalia/trm-docs)
 
 | 🚀 This project is funded and maintained by 🏦 | 🔗                                                             |
 |-------------------------------------------------|----------------------------------------------------------------|
 | Regesta S.p.A.                                  | [https://www.regestaitalia.eu/](https://www.regestaitalia.eu/) |
 | Clarex S.r.l.                                   | [https://www.clarex.it/](https://www.clarex.it/)               |
 
-This module contains the core functionalities of [TRM (Transport Request Manager)](https://trmregistry.com/).
+[trm-core](https://www.npmjs.com/package/trm-core) is the server-side component of TRM.
 
-TRM is a software designed to make transports between SAP ECC/S4 systems easy.
+🚚 **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.
 
 # Requirements
 
 - [Node >=22.12.0](https://github.com/nodejs/node/releases/tag/v22.12.0)
 
-# Documentation <!-- {docsify-remove} -->
+# Documentation
 
 Full documentation can be seen at [https://docs.trmregistry.com/](https://docs.trmregistry.com).
 
-# Contributing <!-- {docsify-remove} -->
-
+# Contributing
 Like every other TRM open-source projects, contributions are always welcomed ❤️.
 
 Make sure to open an issue first.

package/changelog.txt

@@ -8,6 +8,17 @@ Legend
 + : added
 - : removed
 
+2026-04-14 v9.0.0
+-------------------
+! moved to namespace /ATRM/
+! trm-commons ^3.7.1
+* polling progress bar
+* transport icon
+! release check before TADIR transport (in publish)
+- sap entries in transport documentation
+! release on transport install
+! multiple customizing transports allowed
+
 2026-03-11 v8.5.3
 -------------------
 + refresh transport text in cg3z

package/dist/actions/commons/prompts/index.d.ts

@@ -0,0 +1 @@
+export * from "./setTransportTarget";

package/dist/actions/commons/prompts/index.js

@@ -0,0 +1,17 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./setTransportTarget"), exports);

package/dist/actions/commons/prompts/setTransportTarget.d.ts

@@ -0,0 +1,2 @@
+import { TARSYSTEM } from "../../../client";
+export declare function setTransportTarget(noInquirer: boolean, systemTargets: TARSYSTEM[], userInput?: TARSYSTEM, inquirerMessage?: string): Promise<TARSYSTEM>;

package/dist/actions/commons/prompts/setTransportTarget.js

@@ -0,0 +1,63 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.setTransportTarget = setTransportTarget;
+const trm_commons_1 = require("trm-commons");
+const chalk_1 = __importDefault(require("chalk"));
+const validators_1 = require("../../../validators");
+function setTransportTarget(noInquirer, systemTargets, userInput, inquirerMessage) {
+    return __awaiter(this, void 0, void 0, function* () {
+        var needsValidation;
+        var transportTarget = userInput;
+        if (transportTarget === undefined) {
+            if (systemTargets.length === 1) {
+                transportTarget = systemTargets[0];
+                trm_commons_1.Logger.info(`Target system automatically set to ${chalk_1.default.bold(transportTarget)}`);
+            }
+            else {
+                if (!noInquirer) {
+                    transportTarget = (yield trm_commons_1.Inquirer.prompt({
+                        type: "list",
+                        message: inquirerMessage || 'Transport target',
+                        name: "transportTarget",
+                        validate: (input) => __awaiter(this, void 0, void 0, function* () {
+                            return yield (0, validators_1.validateTransportTarget)(input, systemTargets);
+                        }),
+                        choices: systemTargets.map(o => {
+                            return {
+                                name: o,
+                                value: o
+                            };
+                        })
+                    })).transportTarget;
+                }
+                else {
+                    throw new Error(`Transport target was not declared.`);
+                }
+            }
+            needsValidation = false;
+        }
+        else {
+            needsValidation = true;
+        }
+        if (needsValidation) {
+            const validate = yield (0, validators_1.validateTransportTarget)(transportTarget, systemTargets);
+            if (validate && validate !== true) {
+                throw new Error(validate);
+            }
+            trm_commons_1.Logger.info(`Target system: ${chalk_1.default.bold(transportTarget)}`);
+        }
+        return transportTarget;
+    });
+}

package/dist/actions/install/{migrate.d.ts → checkObjectsLock.d.ts}

@@ -1,3 +1,3 @@
 import { Step } from "@simonegaffurini/sammarksworkflow";
 import { InstallWorkflowContext } from ".";
-export declare const migrate: Step<InstallWorkflowContext>;
+export declare const checkObjectsLock: Step<InstallWorkflowContext>;

package/dist/actions/install/checkObjectsLock.js

@@ -0,0 +1,52 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.checkObjectsLock = void 0;
+const trm_commons_1 = require("trm-commons");
+const systemConnector_1 = require("../../systemConnector");
+exports.checkObjectsLock = {
+    name: 'check-objects-lock',
+    filter: (context) => __awaiter(void 0, void 0, void 0, function* () {
+        if (context.rawInput.installData.installTransport.create) {
+            return true;
+        }
+        else {
+            trm_commons_1.Logger.log(`Skipping objects lock (user input, no install transport)`, true);
+            return false;
+        }
+    }),
+    run: (context) => __awaiter(void 0, void 0, void 0, function* () {
+        trm_commons_1.Logger.log('Check objects lock step', true);
+        const devclass = context.runtime.generatedData.devclass.map(d => {
+            return {
+                PGMID: 'R3TR',
+                OBJECT: 'DEVC',
+                OBJ_NAME: d
+            };
+        });
+        const locks = yield systemConnector_1.SystemConnector.getObjectsLocks(devclass.concat(context.runtime.packageTransportsData.e071.map(o => {
+            return {
+                PGMID: o.pgmid,
+                OBJECT: o.object,
+                OBJ_NAME: o.objName
+            };
+        })));
+        if (locks.length > 0) {
+            locks.forEach(l => {
+                trm_commons_1.Logger.error(`${l.pgmid} ${l.object} ${l.objName} is currently locked in transport ${l.trkorr}`);
+            });
+            throw new Error(`To generate install transports, all objects must be released`);
+        }
+        else {
+            trm_commons_1.Logger.log(`All objects released, continue`, true);
+        }
+    })
+};

package/dist/actions/install/checkTransports.js

@@ -83,9 +83,7 @@ exports.checkTransports = {
                 }
                 context.runtime.packageTransports.lang.binaries = aLangTransports[0];
                 trm_commons_1.Logger.log(`LANG transport is ${context.runtime.packageTransports.lang.binaries.trkorr}.`, true);
-                if (!context.rawInput.installData.import.noLang) {
-                    checkExistance.push(context.runtime.packageTransports.lang.binaries.trkorr);
-                }
+                checkExistance.push(context.runtime.packageTransports.lang.binaries.trkorr);
                 const langE071 = (0, commons_1.normalize)(yield context.runtime.r3trans.getTableEntries(context.runtime.packageTransports.lang.binaries.binaries.data, 'E071'));
                 trm_commons_1.Logger.log(`LANG E071: ${JSON.stringify(langE071)}`, true);
                 context.runtime.packageTransportsData.e071 = context.runtime.packageTransportsData.e071.concat(langE071);
@@ -97,22 +95,23 @@ exports.checkTransports = {
                     context.rawInput.installData.import.noCust = !(yield trm_commons_2.Inquirer.prompt({
                         type: `confirm`,
                         name: `noCust`,
-                        message: `Import customizing transport?`,
+                        message: `Import ${aCustTransports.length} customizing transport(s)?`,
                         default: true,
                     })).noCust;
                 }
             }
             if (!context.rawInput.installData.import.noCust) {
-                if (aCustTransports.length !== 1) {
-                    trm_commons_1.Logger.error(`Multiple CUST transports found`, true);
-                    throw new Error(`Unexpected content in package.`);
-                }
-                context.runtime.packageTransports.cust.binaries = aCustTransports[0];
-                trm_commons_1.Logger.log(`CUST transport is ${context.runtime.packageTransports.cust.binaries.trkorr}.`, true);
-                if (!context.rawInput.installData.import.noCust) {
-                    checkExistance.push(context.runtime.packageTransports.cust.binaries.trkorr);
+                context.runtime.packageTransports.cust = aCustTransports.map(o => {
+                    return {
+                        binaries: o
+                    };
+                });
+                trm_commons_1.Logger.log(`CUST transport are ${context.runtime.packageTransports.cust.map(o => o.binaries.trkorr)}.`, true);
+                checkExistance = checkExistance.concat(context.runtime.packageTransports.cust.map(o => o.binaries.trkorr));
+                var custE071 = [];
+                for (const transport of context.runtime.packageTransports.cust) {
+                    custE071 = custE071.concat((0, commons_1.normalize)(yield context.runtime.r3trans.getTableEntries(transport.binaries.binaries.data, 'E071')));
                 }
-                const custE071 = (0, commons_1.normalize)(yield context.runtime.r3trans.getTableEntries(context.runtime.packageTransports.cust.binaries.binaries.data, 'E071'));
                 trm_commons_1.Logger.log(`CUST E071: ${JSON.stringify(custE071)}`, true);
                 context.runtime.packageTransportsData.e071 = context.runtime.packageTransportsData.e071.concat(custE071);
             }
@@ -134,6 +133,7 @@ exports.checkTransports = {
             const oTransport = new transport_1.Transport(trkorr);
             const e070 = yield oTransport.getE070();
             if (e070) {
+                var rewrite = false;
                 trm_commons_1.Logger.warning(`${trkorr} already exists in system!`, true);
                 const trmRelevant = yield oTransport.isTrmRelevant();
                 const linkedPackage = yield oTransport.getLinkedPackage();
@@ -141,47 +141,51 @@ exports.checkTransports = {
                     trm_commons_1.Logger.log(`${trkorr} package is ${linkedPackage.packageName}`, true);
                     if (linkedPackage.compareName(context.runtime.remotePackageData.manifest.name) && linkedPackage.compareRegistry(context.runtime.registry)) {
                         trm_commons_1.Logger.log(`${trkorr} same package (updating?)`, true);
+                        context.runtime.generatedData.tmsTxtRefresh.push(oTransport);
                     }
                     else {
                         trm_commons_1.Logger.log(`${trkorr} is linked to another package, will later be migrated`, true);
-                        context.runtime.generatedData.migrations.push(oTransport);
+                        rewrite = true;
                     }
-                    context.runtime.generatedData.tmsTxtRefresh.push(oTransport);
                 }
                 else if (trmRelevant) {
-                    trm_commons_1.Logger.log(`${trkorr} is TRM relevant but no linked package (could be DEVC, LANG etc..). No migration, just tms refresh`, true);
+                    trm_commons_1.Logger.log(`${trkorr} is TRM relevant but no linked package (could be DEVC, LANG etc..).`, true);
                     context.runtime.generatedData.tmsTxtRefresh.push(oTransport);
                 }
                 else {
                     if (yield oTransport.isReleased()) {
-                        trm_commons_1.Logger.warning(`Transport ${trkorr} already exists in target system ${systemConnector_1.SystemConnector.getDest()}`);
-                        trm_commons_1.Logger.warning(`If you continue, TRM will replace the content of transport ${trkorr} with the content of the transport with the same number of package "${context.runtime.remotePackageData.manifest.name}".`);
-                        trm_commons_1.Logger.warning(`All of the content of the existing transport will remain untouched, however you need to manually create a new transport if you want to use it again in the future.`);
-                        if (!context.rawInput.installData.import.replaceExistingTransports) {
-                            var continueInstall;
-                            if (!context.rawInput.contextData.noInquirer) {
-                                continueInstall = (yield trm_commons_2.Inquirer.prompt({
-                                    name: `continue`,
-                                    message: `Continue install?`,
-                                    type: `confirm`,
-                                    default: true
-                                })).continue;
-                            }
-                            else {
-                                continueInstall = false;
-                            }
-                            if (continueInstall) {
-                                context.runtime.generatedData.tmsTxtRefresh.push(oTransport);
-                            }
-                            else {
-                                throw new Error(`Transport ${trkorr} already exists in target system ${systemConnector_1.SystemConnector.getDest()} and transport rewrite was denied.`);
-                            }
-                        }
+                        rewrite = true;
                     }
                     else {
                         throw new Error(`Transport ${trkorr} already exists in target system ${systemConnector_1.SystemConnector.getDest()} and is not released.`);
                     }
                 }
+                if (rewrite) {
+                    trm_commons_1.Logger.warning(`Transport ${trkorr} already exists in target system ${systemConnector_1.SystemConnector.getDest()}`);
+                    trm_commons_1.Logger.warning(`If you continue, TRM will replace the content of transport ${trkorr} with the content of the transport with the same number of package "${context.runtime.remotePackageData.manifest.name}".`);
+                    trm_commons_1.Logger.warning(`All of its original content (objects or customizing) will remain untouched, however you may need to manually create a new transport for it.`);
+                    trm_commons_1.Logger.warning(`Consider doing a copy now before the install will replace it.`);
+                    if (!context.rawInput.installData.import.replaceExistingTransports) {
+                        var continueInstall;
+                        if (!context.rawInput.contextData.noInquirer) {
+                            continueInstall = (yield trm_commons_2.Inquirer.prompt({
+                                name: `continue`,
+                                message: `Continue install?`,
+                                type: `confirm`,
+                                default: true
+                            })).continue;
+                        }
+                        else {
+                            continueInstall = false;
+                        }
+                        if (continueInstall) {
+                            context.runtime.generatedData.tmsTxtRefresh.push(oTransport);
+                        }
+                        else {
+                            throw new Error(`Transport ${trkorr} already exists in target system ${systemConnector_1.SystemConnector.getDest()} and transport rewrite was denied.`);
+                        }
+                    }
+                }
             }
             else {
                 trm_commons_1.Logger.success(`${trkorr} does not exist in system.`, true);

package/dist/actions/install/executePostActivities.js

@@ -12,7 +12,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.executePostActivities = void 0;
 const trm_commons_1 = require("trm-commons");
 const manifest_1 = require("../../manifest");
-const commons_1 = require("../../commons");
+const transport_1 = require("../../transport");
 exports.executePostActivities = {
     name: 'execute-post-activities',
     filter: (context) => __awaiter(void 0, void 0, void 0, function* () {
@@ -22,13 +22,7 @@ exports.executePostActivities = {
         }
         else {
             if (context.runtime.remotePackageData.manifest.postActivities && context.runtime.remotePackageData.manifest.postActivities.length > 0) {
-                if (commons_1.TrmServerUpgrade.getInstance().executePostActivities()) {
-                    return true;
-                }
-                else {
-                    trm_commons_1.Logger.warning(`Coudln't execute post activities! After trm-server upgrade, run them manually!`, true);
-                    return false;
-                }
+                return true;
             }
             else {
                 trm_commons_1.Logger.log(`Skipping post activities (none defined)`, true);
@@ -46,12 +40,20 @@ exports.executePostActivities = {
                 if (Array.isArray(data.parameters)) {
                     data.parameters.forEach(param => {
                         switch (param.value) {
-                            case '&INSTALL_TRANSPORT&':
+                            case '&INSTALL_WB_TRANSPORT&':
+                                try {
+                                    param.value = context.runtime.installData.transports.find(o => o.type === transport_1.TrmTransportIdentifier.TADIR).transport.trkorr;
+                                }
+                                catch (x) {
+                                    throw new Error(`Cannot find install workbench transport number`);
+                                }
+                                break;
+                            case '&INSTALL_CUST_TRANSPORT&':
                                 try {
-                                    param.value = context.runtime.installData.transport.trkorr;
+                                    param.value = context.runtime.installData.transports.find(o => o.type === transport_1.TrmTransportIdentifier.CUST).transport.trkorr;
                                 }
                                 catch (x) {
-                                    throw new Error(`Cannot find install transport number`);
+                                    throw new Error(`Cannot find install customizing transport number`);
                                 }
                                 break;
                         }

package/dist/actions/install/generateDevclass.js

@@ -13,7 +13,6 @@ exports.generateDevclass = void 0;
 const trm_commons_1 = require("trm-commons");
 const commons_1 = require("../../commons");
 const systemConnector_1 = require("../../systemConnector");
-const TrmServerUpgradeService_1 = require("../../commons/TrmServerUpgradeService");
 const stopWarning_1 = require("../stopWarning");
 exports.generateDevclass = {
     name: 'generate-devclass',
@@ -110,12 +109,7 @@ exports.generateDevclass = {
                 const installParentCl = (_b = context.rawInput.installData.installDevclass.replacements.find(o => o.originalDevclass === originalParentCl)) === null || _b === void 0 ? void 0 : _b.installDevclass;
                 if (installParentCl) {
                     if (!installRoot) {
-                        try {
-                            yield systemConnector_1.SystemConnector.setPackageSuperpackage(packageReplacement.installDevclass, installParentCl);
-                        }
-                        catch (e) {
-                            TrmServerUpgradeService_1.TrmServerUpgrade.getInstance().throwError(e);
-                        }
+                        yield systemConnector_1.SystemConnector.setPackageSuperpackage(packageReplacement.installDevclass, installParentCl);
                     }
                 }
             }