trm-core 9.10.5 → 10.0.0

package/dist/actions/checkPackageDependencies/index.d.ts

@@ -1,15 +1,38 @@
 import { TrmPackage } from "../../trmPackage";
 import { IActionContext } from "../commons";
 import { TrmManifest, TrmManifestDependency } from "../../manifest";
+/** Input used to compare a manifest's dependencies with packages installed in SAP. */
 export interface CheckPackageDependenciesActionInput {
+    /**
+     * Optional context data.
+     */
     contextData?: {
+        /**
+         * Snapshot of packages installed on the target system. When omitted, the action
+         * queries the connected system.
+         */
         systemPackages?: TrmPackage[];
     };
+    /**
+     * Data related to the package being checked.
+     */
     packageData: {
+        /**
+         * Manifest whose `dependencies` collection will be checked.
+         */
         manifest: TrmManifest;
     };
+    /**
+     * Print options.
+     */
     printOptions?: {
+        /**
+         * Print the per-dependency status table. Defaults to `false`.
+         */
         dependencyStatus?: boolean;
+        /**
+         * Print informational summary messages. Defaults to `false`.
+         */
         information?: boolean;
     };
 }
@@ -19,17 +42,50 @@ type WorkflowRuntime = {
         badVersion: TrmManifestDependency[];
     };
 };
+/**
+ * Outcome of a single dependency check.
+ *
+ * - `ok`: installed and its version satisfies the range.
+ * - `versionMismatch`: installed, but its version does not satisfy the range.
+ * - `notFound`: not installed on the system.
+ * - `manifestUnreadable`: installed, but its manifest or version could not be read.
+ */
+export type DependencyCheckStatus = 'ok' | 'versionMismatch' | 'notFound' | 'manifestUnreadable';
+/** Dependency compatibility report returned by {@link checkPackageDependencies}. */
 export type CheckPackageDependenciesActionOutput = {
+    /** Dependencies copied from the supplied manifest, or an empty array. */
     dependencies: TrmManifestDependency[];
+    /** One result per dependency; `match` is true when an installed version satisfies its range. */
     dependencyStatus: {
+        /** Manifest dependency that was evaluated. */
         dependency: TrmManifestDependency;
+        /** Whether a matching installed package was found at a compatible version. */
         match: boolean;
+        /** Detailed outcome; distinguishes a missing package from one whose manifest is unreadable. */
+        status: DependencyCheckStatus;
+        /** Version on the system; set for `ok` and `versionMismatch`. */
+        installedVersion?: string;
     }[];
 };
+/** Internal state shared by the dependency-check workflow steps. */
 export interface CheckPackageDependenciesWorkflowContext extends IActionContext {
+    /** Original action input. */
     rawInput: CheckPackageDependenciesActionInput;
+    /** Intermediate classification of matching and non-matching dependencies. */
     runtime?: WorkflowRuntime;
+    /** Report assembled by the workflow. */
     output?: CheckPackageDependenciesActionOutput;
 }
+/**
+ * Checks whether installed TRM packages satisfy every dependency in a manifest.
+ *
+ * Dependency identity includes its registry. Version compatibility follows semantic-version
+ * range rules. This action reports mismatches in its output rather than throwing for them.
+ *
+ * @param inputData Manifest, optional installed-package snapshot, and print settings.
+ * @returns The manifest dependencies and their installed-version match status.
+ * @throws When installed packages cannot be read, a dependency is declared twice, or a dependency
+ * version range is not a valid semantic-version range.
+ */
 export declare function checkPackageDependencies(inputData: CheckPackageDependenciesActionInput): Promise<CheckPackageDependenciesActionOutput>;
 export {};

package/dist/actions/checkPackageDependencies/index.js

@@ -8,19 +8,24 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
         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.checkPackageDependencies = checkPackageDependencies;
-const sammarksworkflow_1 = __importDefault(require("@simonegaffurini/sammarksworkflow"));
-const util_1 = require("util");
-const trm_commons_1 = require("trm-commons");
 const commons_1 = require("../commons");
 const init_1 = require("./init");
 const analyze_1 = require("./analyze");
 ;
 const WORKFLOW_NAME = 'check-dependencies';
+/**
+ * Checks whether installed TRM packages satisfy every dependency in a manifest.
+ *
+ * Dependency identity includes its registry. Version compatibility follows semantic-version
+ * range rules. This action reports mismatches in its output rather than throwing for them.
+ *
+ * @param inputData Manifest, optional installed-package snapshot, and print settings.
+ * @returns The manifest dependencies and their installed-version match status.
+ * @throws When installed packages cannot be read, a dependency is declared twice, or a dependency
+ * version range is not a valid semantic-version range.
+ */
 function checkPackageDependencies(inputData) {
     return __awaiter(this, void 0, void 0, function* () {
         const workflow = [
@@ -28,11 +33,9 @@ function checkPackageDependencies(inputData) {
             commons_1.setSystemPackages,
             analyze_1.analyze
         ];
-        trm_commons_1.Logger.log(`Ready to execute workflow ${WORKFLOW_NAME}, input data: ${(0, util_1.inspect)(inputData, { breakLength: Infinity, compact: true })}`, true);
-        const result = yield (0, sammarksworkflow_1.default)(WORKFLOW_NAME, workflow, {
+        const result = yield (0, commons_1.executeWorkflow)(WORKFLOW_NAME, workflow, {
             rawInput: inputData
-        });
-        trm_commons_1.Logger.log(`Workflow ${WORKFLOW_NAME} result: ${(0, util_1.inspect)(result, { breakLength: Infinity, compact: true })}`, true);
+        }, commons_1.workflowCallbacks);
         return result.output;
     });
 }

package/dist/actions/checkPackageDependencies/init.d.ts

@@ -1,3 +1,11 @@
 import { Step } from "@simonegaffurini/sammarksworkflow";
 import { CheckPackageDependenciesWorkflowContext } from ".";
+/**
+ * Workflow step that initializes dependency-check output and normalizes optional input.
+ *
+ * 1- set dependencies (read manifest)
+ *
+ * 2- fill missing input data
+ *
+*/
 export declare const init: Step<CheckPackageDependenciesWorkflowContext>;

package/dist/actions/checkPackageDependencies/init.js

@@ -10,11 +10,19 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.init = void 0;
-const trm_commons_1 = require("trm-commons");
+const registry_1 = require("../../registry");
+const manifest_1 = require("../../manifest");
+/**
+ * Workflow step that initializes dependency-check output and normalizes optional input.
+ *
+ * 1- set dependencies (read manifest)
+ *
+ * 2- fill missing input data
+ *
+*/
 exports.init = {
     name: 'init',
     run: (context) => __awaiter(void 0, void 0, void 0, function* () {
-        trm_commons_1.Logger.log('Init step', true);
         context.output = {
             dependencies: [],
             dependencyStatus: []
@@ -25,7 +33,21 @@ exports.init = {
                 badVersion: []
             }
         };
+        //1- set dependencies
         context.output.dependencies = context.rawInput.packageData.manifest.dependencies || [];
+        const dependencyKeys = new Set();
+        for (const dependency of context.output.dependencies) {
+            const registry = dependency.registry || registry_1.PUBLIC_RESERVED_KEYWORD;
+            const key = `${dependency.name}\u0000${registry}`;
+            if (dependencyKeys.has(key)) {
+                throw new Error(`Duplicate dependency "${dependency.name}" for registry "${registry}".`);
+            }
+            dependencyKeys.add(key);
+            if (!manifest_1.Manifest.isValidDependencyRange(dependency.version)) {
+                throw new Error(`Invalid version range "${dependency.version}" for dependency "${dependency.name}".`);
+            }
+        }
+        //2- fill missing input data
         if (!context.rawInput.printOptions) {
             context.rawInput.printOptions = {};
         }

package/dist/actions/checkSapEntries/analyze.d.ts

@@ -1,3 +1,15 @@
 import { Step } from "@simonegaffurini/sammarksworkflow";
 import { CheckSapEntriesWorkflowContext } from ".";
+/**
+ * Workflow step that queries required SAP tables and builds a per-entry status report.
+ *
+ * 1- build required tables fields
+ *
+ * 2- check entries
+ *
+ * 3- print tables
+ *
+ * 4- build output data
+ *
+*/
 export declare const analyze: Step<CheckSapEntriesWorkflowContext>;

package/dist/actions/checkSapEntries/analyze.js

@@ -12,6 +12,18 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.analyze = void 0;
 const trm_commons_1 = require("trm-commons");
 const systemConnector_1 = require("../../systemConnector");
+/**
+ * Workflow step that queries required SAP tables and builds a per-entry status report.
+ *
+ * 1- build required tables fields
+ *
+ * 2- check entries
+ *
+ * 3- print tables
+ *
+ * 4- build output data
+ *
+*/
 exports.analyze = {
     name: 'analyze',
     filter: (context) => __awaiter(void 0, void 0, void 0, function* () {
@@ -24,8 +36,8 @@ exports.analyze = {
         }
     }),
     run: (context) => __awaiter(void 0, void 0, void 0, function* () {
-        trm_commons_1.Logger.log('Analyze step', true);
         var logTable = [];
+        //1- build required tables fields
         var entriesCount = 0;
         var tableFields = [];
         Object.keys(context.output.sapEntries).forEach(tableName => {
@@ -47,21 +59,34 @@ exports.analyze = {
         if (entriesCount === 0) {
             return;
         }
+        //2- check entries
         for (const table of Object.keys(context.output.sapEntries)) {
-            var tableExists;
+            var tableExists = false;
             try {
-                tableExists = yield systemConnector_1.SystemConnector.checkSapEntryExists('TADIR', {
-                    pgmid: 'R3TR',
-                    object: 'TABL',
-                    obj_name: table
-                });
+                for (const object of ['TABL', 'VIEW']) {
+                    tableExists = yield systemConnector_1.SystemConnector.checkSapEntryExists('TADIR', {
+                        pgmid: 'R3TR',
+                        object,
+                        obj_name: table.trim().toUpperCase()
+                    });
+                    if (tableExists) {
+                        break;
+                    }
+                }
             }
             catch (e) {
-                tableExists = false;
+                const reason = e instanceof Error ? e.message : String(e);
+                throw new Error(`Unable to check whether required SAP table "${table}" exists: ${reason}`);
             }
             if (!tableExists) {
                 context.runtime.missingTables.push(table);
-                trm_commons_1.Logger.error(`Required ${context.output.sapEntries[table].length} entries in ${table}, but table was not found`, !context.rawInput.printOptions.information);
+                context.output.sapEntries[table].forEach(tableEntry => {
+                    context.runtime.entriesStatus.bad.push({
+                        table,
+                        tableEntry
+                    });
+                });
+                trm_commons_1.Logger.error(`Required ${context.output.sapEntries[table].length} entries in ${table}, but table or view was not found`, { debug: !context.rawInput.printOptions.information, important: true });
             }
             else {
                 var printTableHead = ['Table name'];
@@ -71,37 +96,28 @@ exports.analyze = {
                 printTableHead.push('Status');
                 for (const tableEntry of context.output.sapEntries[table]) {
                     tableData = [table];
-                    var entryStatus;
+                    var exists;
                     try {
-                        const exists = yield systemConnector_1.SystemConnector.checkSapEntryExists(table, tableEntry);
-                        if (exists) {
-                            entryStatus = `OK`;
-                            context.runtime.entriesStatus.good.push({
-                                table,
-                                tableEntry
-                            });
-                        }
-                        else {
-                            entryStatus = `NOT FOUND`;
-                            context.runtime.entriesStatus.bad.push({
-                                table,
-                                tableEntry
-                            });
-                        }
+                        exists = yield systemConnector_1.SystemConnector.checkSapEntryExists(table, tableEntry);
                     }
                     catch (e) {
-                        trm_commons_1.Logger.error(e.toString(), true);
-                        trm_commons_1.Logger.error(`Error during check of SAP entry ${JSON.stringify(tableEntry)}`, true);
-                        entryStatus = `Unknown`;
+                        const reason = e instanceof Error ? e.message : String(e);
+                        throw new Error(`Unable to check required SAP entry ${JSON.stringify(tableEntry)} in table "${table}": ${reason}`);
+                    }
+                    if (exists) {
+                        context.runtime.entriesStatus.good.push({
+                            table,
+                            tableEntry
+                        });
+                    }
+                    else {
                         context.runtime.entriesStatus.bad.push({
                             table,
                             tableEntry
                         });
                     }
-                    Object.keys(tableEntry).forEach(field => {
-                        const pushIndex = printTableHead.findIndex(headerName => headerName === field);
-                        tableData.splice(pushIndex, 0, tableEntry[field]);
-                    });
+                    const entryStatus = exists ? `OK` : `NOT FOUND`;
+                    tableData = tableData.concat(printTableHead.slice(1, -1).map(field => { var _a; return (_a = tableEntry[field]) !== null && _a !== void 0 ? _a : ''; }));
                     tableData.push(entryStatus);
                     printTableData.push(tableData);
                 }
@@ -111,26 +127,26 @@ exports.analyze = {
                 });
             }
         }
+        //3- print tables
         logTable.forEach(t => {
             trm_commons_1.Logger.table(t.header, t.data, !context.rawInput.printOptions.entriesStatus);
         });
-        context.output.sapEntriesStatus = {};
-        context.runtime.entriesStatus.good.forEach(o => {
-            if (!context.output.sapEntriesStatus[o.table]) {
-                context.output.sapEntriesStatus[o.table] = [];
-            }
-            context.output.sapEntriesStatus[o.table].push({
-                status: true,
-                entry: o.tableEntry
-            });
-        });
+        //4- build output data (declaration order)
+        const badEntries = new Map();
         context.runtime.entriesStatus.bad.forEach(o => {
-            if (!context.output.sapEntriesStatus[o.table]) {
-                context.output.sapEntriesStatus[o.table] = [];
+            if (!badEntries.has(o.table)) {
+                badEntries.set(o.table, new Set());
             }
-            context.output.sapEntriesStatus[o.table].push({
-                status: false,
-                entry: o.tableEntry
+            badEntries.get(o.table).add(o.tableEntry);
+        });
+        context.output.sapEntriesStatus = {};
+        Object.keys(context.output.sapEntries).forEach(table => {
+            context.output.sapEntriesStatus[table] = context.output.sapEntries[table].map(entry => {
+                var _a;
+                return ({
+                    status: !((_a = badEntries.get(table)) === null || _a === void 0 ? void 0 : _a.has(entry)),
+                    entry
+                });
             });
         });
     })

package/dist/actions/checkSapEntries/index.d.ts

@@ -1,10 +1,26 @@
 import { TrmManifest } from "../../manifest";
+/** Input used to verify a manifest's required SAP table entries. */
 export interface CheckSapEntriesActionInput {
+    /**
+     * Data related to the package being checked.
+     */
     packageData: {
+        /**
+         * Manifest whose `sapEntries` map will be checked against the connected system.
+         */
         manifest: TrmManifest;
     };
+    /**
+     * Print options.
+     */
     printOptions?: {
+        /**
+         * Print tables containing each required entry and its status. Defaults to `false`.
+         */
         entriesStatus?: boolean;
+        /**
+         * Print informational summary messages. Defaults to `false`.
+         */
         information?: boolean;
     };
 }
@@ -21,20 +37,39 @@ type WorkflowRuntime = {
     };
     missingTables: string[];
 };
+/** Status map keyed by SAP table name. */
 export type SapEntriesStatus = {
     [key: string]: {
+        /** Whether the required row exists in the target table. */
         status: boolean;
+        /** Field/value object used to identify the required row. */
         entry: any;
     }[];
 };
+/** SAP-entry report returned by {@link checkSapEntries}. */
 export type CheckSapEntriesActionOutput = {
+    /** Required entries copied from `manifest.sapEntries`, keyed by table name. */
     sapEntries: any;
+    /** Existence result for each required entry, keyed by table name. */
     sapEntriesStatus: SapEntriesStatus;
 };
+/** Internal state shared by the SAP-entry-check workflow steps. */
 export interface CheckSapEntriesWorkflowContext {
+    /** Original action input. */
     rawInput: CheckSapEntriesActionInput;
+    /** Intermediate entry classifications and missing table names. */
     runtime?: WorkflowRuntime;
+    /** Report assembled by the workflow. */
     output?: CheckSapEntriesActionOutput;
 }
+/**
+ * Checks whether the connected SAP system contains the table rows required by a manifest.
+ *
+ * Missing tables and rows are represented with failed statuses in the returned report.
+ *
+ * @param inputData Manifest and optional print settings.
+ * @returns The required SAP entries and an existence result for each one.
+ * @throws When the connected system cannot be queried for reasons other than a missing table or row.
+ */
 export declare function checkSapEntries(inputData: CheckSapEntriesActionInput): Promise<CheckSapEntriesActionOutput>;
 export {};

package/dist/actions/checkSapEntries/index.js

@@ -8,29 +8,31 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
         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.checkSapEntries = checkSapEntries;
-const sammarksworkflow_1 = __importDefault(require("@simonegaffurini/sammarksworkflow"));
-const util_1 = require("util");
-const trm_commons_1 = require("trm-commons");
 const init_1 = require("./init");
 const analyze_1 = require("./analyze");
+const commons_1 = require("../commons");
 ;
 const WORKFLOW_NAME = 'check-sap-entries';
+/**
+ * Checks whether the connected SAP system contains the table rows required by a manifest.
+ *
+ * Missing tables and rows are represented with failed statuses in the returned report.
+ *
+ * @param inputData Manifest and optional print settings.
+ * @returns The required SAP entries and an existence result for each one.
+ * @throws When the connected system cannot be queried for reasons other than a missing table or row.
+ */
 function checkSapEntries(inputData) {
     return __awaiter(this, void 0, void 0, function* () {
         const workflow = [
             init_1.init,
             analyze_1.analyze
         ];
-        trm_commons_1.Logger.log(`Ready to execute workflow ${WORKFLOW_NAME}, input data: ${(0, util_1.inspect)(inputData, { breakLength: Infinity, compact: true })}`, true);
-        const result = yield (0, sammarksworkflow_1.default)(WORKFLOW_NAME, workflow, {
+        const result = yield (0, commons_1.executeWorkflow)(WORKFLOW_NAME, workflow, {
             rawInput: inputData
-        });
-        trm_commons_1.Logger.log(`Workflow ${WORKFLOW_NAME} result: ${(0, util_1.inspect)(result, { breakLength: Infinity, compact: true })}`, true);
+        }, commons_1.workflowCallbacks);
         return result.output;
     });
 }

package/dist/actions/checkSapEntries/init.d.ts

@@ -1,3 +1,11 @@
 import { Step } from "@simonegaffurini/sammarksworkflow";
 import { CheckSapEntriesWorkflowContext } from ".";
+/**
+ * Workflow step that initializes SAP-entry-check state from the supplied manifest.
+ *
+ * 1- set sap entries  (read manifest)
+ *
+ * 2- fill missing input data
+ *
+*/
 export declare const init: Step<CheckSapEntriesWorkflowContext>;

package/dist/actions/checkSapEntries/init.js

@@ -10,11 +10,17 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.init = void 0;
-const trm_commons_1 = require("trm-commons");
+/**
+ * Workflow step that initializes SAP-entry-check state from the supplied manifest.
+ *
+ * 1- set sap entries  (read manifest)
+ *
+ * 2- fill missing input data
+ *
+*/
 exports.init = {
     name: 'init',
     run: (context) => __awaiter(void 0, void 0, void 0, function* () {
-        trm_commons_1.Logger.log('Init step', true);
         context.output = {
             sapEntries: {},
             sapEntriesStatus: {}
@@ -26,7 +32,9 @@ exports.init = {
             },
             missingTables: []
         };
+        //1- set sap entries
         context.output.sapEntries = context.rawInput.packageData.manifest.sapEntries || {};
+        //2- fill missing input data
         if (!context.rawInput.printOptions) {
             context.rawInput.printOptions = {};
         }

package/dist/actions/commons/IActionContext.d.ts

@@ -1,8 +1,18 @@
 import { TrmPackage } from "../../trmPackage";
+/** Shared minimum context accepted by reusable action workflow steps. */
 export interface IActionContext {
+    /** Input supplied to the parent action. */
     rawInput: {
+        /** Optional values shared by workflows that inspect the target SAP system. */
         contextData?: {
+            /**
+             * Packages already installed on the target system.
+             *
+             * Supplying this value avoids querying the connected system and is useful when
+             * several actions share the same snapshot.
+             */
             systemPackages?: TrmPackage[];
+            /** Disable interactive prompts. Missing required choices then cause an error. */
             noInquirer?: boolean;
         };
     };

package/dist/actions/commons/checkServerAuth.d.ts

@@ -1,2 +1,9 @@
 import { Step } from "@simonegaffurini/sammarksworkflow";
+/**
+ * Workflow step that verifies the connected user may call the TRM server APIs.
+ *
+ * Place this before steps that read or mutate the SAP system. The step fails closed: it throws
+ * the connector's `ClientError` when authorization is denied, and propagates any other error
+ * raised while checking it.
+ */
 export declare const checkServerAuth: Step<any>;

package/dist/actions/commons/checkServerAuth.js

@@ -10,16 +10,21 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.checkServerAuth = void 0;
-const trm_commons_1 = require("trm-commons");
 const systemConnector_1 = require("../../systemConnector");
-const client_1 = require("../../client");
+/**
+ * Workflow step that verifies the connected user may call the TRM server APIs.
+ *
+ * Place this before steps that read or mutate the SAP system. The step fails closed: it throws
+ * the connector's `ClientError` when authorization is denied, and propagates any other error
+ * raised while checking it.
+ */
 exports.checkServerAuth = {
     name: 'check-server-auth',
     run: () => __awaiter(void 0, void 0, void 0, function* () {
-        trm_commons_1.Logger.log('Check server auth step', true);
+        //1- check auth
         const auth = yield systemConnector_1.SystemConnector.isServerApisAllowed();
-        if (auth instanceof client_1.ClientError) {
-            throw auth;
+        if (auth !== true) {
+            throw auth instanceof Error ? auth : new Error(`TRM server APIs authorization check failed.`);
         }
     })
 };

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

@@ -1,4 +1,4 @@
 export * from "./IActionContext";
 export * from "./setSystemPackages";
 export * from "./checkServerAuth";
-export * from "./trmServerPa";
+export * from "./workflowCallbacks";

package/dist/actions/commons/index.js

@@ -17,4 +17,4 @@ Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./IActionContext"), exports);
 __exportStar(require("./setSystemPackages"), exports);
 __exportStar(require("./checkServerAuth"), exports);
-__exportStar(require("./trmServerPa"), exports);
+__exportStar(require("./workflowCallbacks"), exports);

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

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

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

@@ -15,3 +15,4 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./setTransportTarget"), exports);
+__exportStar(require("./setLandscapeTarget"), exports);

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

@@ -0,0 +1,14 @@
+import { TARSYSTEM } from "../../../client";
+/**
+ * Resolves the landscape target system that receives the transports generated by an action.
+ *
+ * When the connected system has no transport targets and none was supplied, it is treated
+ * as the final system of the landscape and `undefined` is returned.
+ *
+ * @param noInquirer Disable interactive target selection.
+ * @param userInput Explicit target to validate and use.
+ * @param inquirerMessage Prompt label used when interactive selection is required.
+ * @param skippedMessage Warning logged when no target is available, e.g. `Install transport won't be generated.`
+ * @returns The selected, valid transport target, or `undefined` for the final system.
+ */
+export declare function setLandscapeTarget(noInquirer: boolean, userInput: TARSYSTEM | undefined, inquirerMessage: string, skippedMessage: string): Promise<TARSYSTEM | undefined>;