@sap-ux/adp-tooling 0.13.22 → 0.13.25

package/dist/{client/target-systems.js → source/systems.js}

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.TargetSystems = exports.transformBackendSystem = void 0;
+exports.SystemLookup = exports.transformBackendSystem = void 0;
 exports.getEndpointNames = getEndpointNames;
 const store_1 = require("@sap-ux/store");
 const btp_utils_1 = require("@sap-ux/btp-utils");
@@ -38,7 +38,7 @@ exports.transformBackendSystem = transformBackendSystem;
  * Service class to manage and retrieve information about system systems,
  * including their names, authentication requirements, and specific details.
  */
-class TargetSystems {
+class SystemLookup {
     logger;
     systems;
     /**
@@ -120,5 +120,5 @@ class TargetSystems {
         }
     }
 }
-exports.TargetSystems = TargetSystems;
-//# sourceMappingURL=target-systems.js.map
+exports.SystemLookup = SystemLookup;
+//# sourceMappingURL=systems.js.map

package/dist/translations/adp-tooling.i18n.json

@@ -67,7 +67,8 @@
         "errorDuplicateNamesOData": "OData Service Name must be different from OData Annotation Data Source Name",
         "errorInputInvalidValuePrefix": "{{value}} should start with '{{prefix}}'",
         "errorCustomerEmptyValue": "{{value}} should contain at least one character in addition to '{{prefix}}'",
-        "errorInvalidDataSourceURI": "Invalid URI. Should start and end with '/' and contain no spaces"
+        "errorInvalidDataSourceURI": "Invalid URI. The URI must start and end with '/' and contain no spaces.",
+        "appDoesNotSupportManifest": "The selected application is not supported by the adaptation project. Select a different application. For more information, see SAPUI5 Adaptation Project documentation."
     },
     "choices": {
         "true": "true",

package/dist/types.d.ts

@@ -11,10 +11,6 @@ export interface DescriptorVariant {
     namespace: string;
     content: DescriptorVariantContent[];
 }
-export type PackageJson = {
-    name: string;
-    version: string;
-};
 export interface DescriptorVariantContent {
     changeType: string;
     content: Record<string, unknown>;
@@ -94,9 +90,9 @@ export interface ConfigAnswers {
     system: string;
     username: string;
     password: string;
-    application: TargetApplication;
+    application: SourceApplication;
 }
-export interface TargetApplication {
+export interface SourceApplication {
     id: string;
     title: string;
     ach: string;
@@ -105,6 +101,19 @@ export interface TargetApplication {
     bspUrl: string;
     bspName: string;
 }
+export interface FlexUISupportedSystem {
+    isUIFlex: boolean;
+    isOnPremise: boolean;
+}
+export interface UI5Version {
+    latest: VersionDetail;
+    [key: string]: VersionDetail;
+}
+export interface VersionDetail {
+    version: string;
+    support: string;
+    lts: boolean;
+}
 export interface Endpoint extends Partial<Destination> {
     Name: string;
     Url?: string;

package/dist/ui5/fetch.d.ts

@@ -0,0 +1,16 @@
+import type { UI5Version } from '../types';
+/**
+ * Fetches public UI5 version data from the SAP CDN.
+ *
+ * @returns {Promise<UI5Version>} A promise that resolves to the UI5 version data object.
+ * @throws Will throw an error if the fetch fails.
+ */
+export declare function fetchPublicVersions(): Promise<UI5Version>;
+/**
+ * Fetches internal UI5 versions from the Neo CDN and maps them to formatted version strings.
+ *
+ * @param {string} latestVersion - The latest public UI5 version.
+ * @returns {Promise<string[]>} A promise that resolves to an array of formatted internal version strings.
+ */
+export declare function fetchInternalVersions(latestVersion: string): Promise<string[]>;
+//# sourceMappingURL=fetch.d.ts.map

package/dist/ui5/fetch.js

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.fetchPublicVersions = fetchPublicVersions;
+exports.fetchInternalVersions = fetchInternalVersions;
+const constants_1 = require("../base/constants");
+/**
+ * Fetches public UI5 version data from the SAP CDN.
+ *
+ * @returns {Promise<UI5Version>} A promise that resolves to the UI5 version data object.
+ * @throws Will throw an error if the fetch fails.
+ */
+async function fetchPublicVersions() {
+    const response = await fetch(constants_1.UI5_VERSIONS_CDN_URL);
+    if (!response.ok) {
+        throw new Error(`Failed to fetch public UI5 versions. Status: ${response.status}`);
+    }
+    return response.json();
+}
+/**
+ * Fetches internal UI5 versions from the Neo CDN and maps them to formatted version strings.
+ *
+ * @param {string} latestVersion - The latest public UI5 version.
+ * @returns {Promise<string[]>} A promise that resolves to an array of formatted internal version strings.
+ */
+async function fetchInternalVersions(latestVersion) {
+    const response = await fetch(constants_1.UI5_VERSIONS_NEO_CDN_URL);
+    const data = await response.json();
+    return data?.routes?.map((route) => {
+        return route.target.version === latestVersion
+            ? `${route.target.version} ${constants_1.LATEST_VERSION}`
+            : route.target.version;
+    });
+}
+//# sourceMappingURL=fetch.js.map

package/dist/ui5/format.d.ts

@@ -0,0 +1,80 @@
+/**
+ * Gets the official base URL for SAP UI5 resources based on the version information.
+ * If the version includes 'snapshot', it returns a preview URL; otherwise, it returns the main SAP UI5 CDN URL.
+ *
+ * @param {string} version - The UI5 version string, which may include qualifiers like 'snapshot'.
+ * @returns {string} The base URL for UI5 resources appropriate to the specified version.
+ */
+export declare function getOfficialBaseUI5VersionUrl(version: string): string;
+/**
+ * Formats a UI5 version string by removing extraneous information and adjusting the format of snapshot versions.
+ * Snapshot versions are reformatted from '1.96.0-snapshot' to 'snapshot-1.96'.
+ *
+ * @param {string} version - The original version string which may include additional descriptors like 'snapshot'.
+ * @returns {string} A cleaned-up and, if applicable, restructured version string.
+ */
+export declare function getFormattedVersion(version: string): string;
+/**
+ * Constructs a string representing the current system version with appropriate labels.
+ *
+ * @param {string} formattedVersion - The version string with timestamps removed.
+ * @param {string} snapshotLabel - The snapshot label computed for the version.
+ * @param {string} latestLabel - The label for the latest version if applicable.
+ * @returns {string} The constructed version string.
+ */
+export declare function buildSystemVersionLabel(formattedVersion: string, snapshotLabel: string, latestLabel: string): string;
+/**
+ * Removes parenthetical information from a version string, typically used to clean up annotations such as "(latest)".
+ *
+ * @param {string} version - The version string which may include parenthetical information.
+ * @returns {string} The version string without the parenthetical content.
+ */
+export declare function removeBracketsFromVersion(version: string): string;
+/**
+ * Removes the micro part of a version string, simplifying it to include only the major and minor version numbers.
+ * For example, it transforms a version string from '1.87.3' to '1.87'.
+ *
+ * @param {string} version - The full version string that may include major, minor, and micro version numbers.
+ * @returns {string} The version string consisting of only the major and minor version numbers.
+ */
+export declare function removeMicroPart(version: string): string;
+/**
+ * Removes the timestamp part from a version string, typically used to clean up snapshot versions that include a timestamp.
+ * Converts a version string like '1.95.0.34566363464' to '1.95.0'.
+ *
+ * @param {string} version - The version string that may include a timestamp as part of a snapshot version.
+ * @returns {string} The version string without the timestamp, including only the major, minor, and micro version numbers.
+ */
+export declare function removeTimestampFromVersion(version: string): string;
+/**
+ * Conditionally appends a '-snapshot' suffix to a version string if certain criteria are met.
+ * The suffix is added only if the version string includes an unreleased snapshot version.
+ * For example, it adds '-snapshot' if the version from the system includes a timestamp and differs from the latest released version.
+ *
+ * @param {string} version - The original version string that may include a timestamp.
+ * @param {string} latestVersion - The most recently released version string, used for comparison.
+ * @returns {string} The '-snapshot' suffix if applicable; otherwise, an empty string.
+ */
+export declare function addSnapshot(version: string, latestVersion: string): string;
+/**
+ * Function that parse the UI5 version. Returns NaN for snapshot or snapshot-untested. eturns x.xx for snapshot-x.xx.xx.
+ *
+ * @param {string} version the UI5 version to parse
+ * @returns The major, the minor and the patch version, e.g. 1.86.11
+ */
+export declare function parseUI5Version(version: string): {
+    major: number;
+    minor: number;
+    patch: number;
+};
+/**
+ * Determines if a specific feature, introduced in a given version, is supported in the current or specified version.
+ * This function checks if the provided version is greater than or equal to the feature introduction version.
+ * It also handles edge cases where versions might include 'snapshot' or 'snapshot-untested' strings.
+ *
+ * @param {string} featureVersion - The version string from which the feature is available (e.g., "1.125.3").
+ * @param {string} [version] - The current version string of the application; if not provided, the feature is assumed unsupported.
+ * @returns {boolean} - Returns true if the current version supports the feature, false otherwise.
+ */
+export declare function isFeatureSupportedVersion(featureVersion: string, version?: string): boolean;
+//# sourceMappingURL=format.d.ts.map

package/dist/ui5/format.js

@@ -0,0 +1,135 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getOfficialBaseUI5VersionUrl = getOfficialBaseUI5VersionUrl;
+exports.getFormattedVersion = getFormattedVersion;
+exports.buildSystemVersionLabel = buildSystemVersionLabel;
+exports.removeBracketsFromVersion = removeBracketsFromVersion;
+exports.removeMicroPart = removeMicroPart;
+exports.removeTimestampFromVersion = removeTimestampFromVersion;
+exports.addSnapshot = addSnapshot;
+exports.parseUI5Version = parseUI5Version;
+exports.isFeatureSupportedVersion = isFeatureSupportedVersion;
+const constants_1 = require("../base/constants");
+/**
+ * Gets the official base URL for SAP UI5 resources based on the version information.
+ * If the version includes 'snapshot', it returns a preview URL; otherwise, it returns the main SAP UI5 CDN URL.
+ *
+ * @param {string} version - The UI5 version string, which may include qualifiers like 'snapshot'.
+ * @returns {string} The base URL for UI5 resources appropriate to the specified version.
+ */
+function getOfficialBaseUI5VersionUrl(version) {
+    if (version.toLowerCase().includes('snapshot')) {
+        return constants_1.SNAPSHOT_CDN_URL;
+    }
+    return constants_1.UI5_CDN_URL;
+}
+/**
+ * Formats a UI5 version string by removing extraneous information and adjusting the format of snapshot versions.
+ * Snapshot versions are reformatted from '1.96.0-snapshot' to 'snapshot-1.96'.
+ *
+ * @param {string} version - The original version string which may include additional descriptors like 'snapshot'.
+ * @returns {string} A cleaned-up and, if applicable, restructured version string.
+ */
+function getFormattedVersion(version) {
+    version = removeBracketsFromVersion(version);
+    return version.toLowerCase().includes('-snapshot') ? `snapshot-${removeMicroPart(version)}` : version;
+}
+/**
+ * Constructs a string representing the current system version with appropriate labels.
+ *
+ * @param {string} formattedVersion - The version string with timestamps removed.
+ * @param {string} snapshotLabel - The snapshot label computed for the version.
+ * @param {string} latestLabel - The label for the latest version if applicable.
+ * @returns {string} The constructed version string.
+ */
+function buildSystemVersionLabel(formattedVersion, snapshotLabel, latestLabel) {
+    return `${formattedVersion}${snapshotLabel} ${constants_1.CURRENT_SYSTEM_VERSION}${latestLabel}`;
+}
+/**
+ * Removes parenthetical information from a version string, typically used to clean up annotations such as "(latest)".
+ *
+ * @param {string} version - The version string which may include parenthetical information.
+ * @returns {string} The version string without the parenthetical content.
+ */
+function removeBracketsFromVersion(version) {
+    if (version.indexOf('(') !== -1) {
+        const versionParts = version.split('(');
+        return versionParts[0].trim();
+    }
+    return version;
+}
+/**
+ * Removes the micro part of a version string, simplifying it to include only the major and minor version numbers.
+ * For example, it transforms a version string from '1.87.3' to '1.87'.
+ *
+ * @param {string} version - The full version string that may include major, minor, and micro version numbers.
+ * @returns {string} The version string consisting of only the major and minor version numbers.
+ */
+function removeMicroPart(version) {
+    const versionParts = version.split('.');
+    return `${versionParts[0]}.${versionParts[1]}`;
+}
+/**
+ * Removes the timestamp part from a version string, typically used to clean up snapshot versions that include a timestamp.
+ * Converts a version string like '1.95.0.34566363464' to '1.95.0'.
+ *
+ * @param {string} version - The version string that may include a timestamp as part of a snapshot version.
+ * @returns {string} The version string without the timestamp, including only the major, minor, and micro version numbers.
+ */
+function removeTimestampFromVersion(version) {
+    const versionParts = version.split('.');
+    return `${versionParts[0]}.${versionParts[1]}.${versionParts[2]}`;
+}
+/**
+ * Conditionally appends a '-snapshot' suffix to a version string if certain criteria are met.
+ * The suffix is added only if the version string includes an unreleased snapshot version.
+ * For example, it adds '-snapshot' if the version from the system includes a timestamp and differs from the latest released version.
+ *
+ * @param {string} version - The original version string that may include a timestamp.
+ * @param {string} latestVersion - The most recently released version string, used for comparison.
+ * @returns {string} The '-snapshot' suffix if applicable; otherwise, an empty string.
+ */
+function addSnapshot(version, latestVersion) {
+    const versionParts = version.split('.');
+    return versionParts[3] && removeTimestampFromVersion(version) != latestVersion ? '-snapshot' : '';
+}
+/**
+ * Function that parse the UI5 version. Returns NaN for snapshot or snapshot-untested. eturns x.xx for snapshot-x.xx.xx.
+ *
+ * @param {string} version the UI5 version to parse
+ * @returns The major, the minor and the patch version, e.g. 1.86.11
+ */
+function parseUI5Version(version) {
+    const versionParts = version ? version.replace(/snapshot-untested|snapshot-|snapshot/, '').split('.') : [];
+    const major = parseInt(versionParts[0], 10);
+    const minor = parseInt(versionParts[1], 10);
+    const patch = parseInt(versionParts[2], 10);
+    return { major, minor, patch };
+}
+/**
+ * Determines if a specific feature, introduced in a given version, is supported in the current or specified version.
+ * This function checks if the provided version is greater than or equal to the feature introduction version.
+ * It also handles edge cases where versions might include 'snapshot' or 'snapshot-untested' strings.
+ *
+ * @param {string} featureVersion - The version string from which the feature is available (e.g., "1.125.3").
+ * @param {string} [version] - The current version string of the application; if not provided, the feature is assumed unsupported.
+ * @returns {boolean} - Returns true if the current version supports the feature, false otherwise.
+ */
+function isFeatureSupportedVersion(featureVersion, version) {
+    if (!version || !featureVersion) {
+        return false;
+    }
+    const { major: featMajorVersion, minor: featMinorVersion, patch: featPatchVersion } = parseUI5Version(featureVersion);
+    const { major, minor, patch } = parseUI5Version(version);
+    if (isNaN(major) && isNaN(minor) && isNaN(patch)) {
+        return true;
+    }
+    if (major > featMajorVersion) {
+        return true;
+    }
+    else if (minor < featMinorVersion) {
+        return false;
+    }
+    return patch >= featPatchVersion;
+}
+//# sourceMappingURL=format.js.map

package/dist/ui5/index.d.ts

@@ -0,0 +1,4 @@
+export * from './version-info';
+export * from './format';
+export * from './fetch';
+//# sourceMappingURL=index.d.ts.map

package/dist/ui5/index.js

@@ -0,0 +1,20 @@
+"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("./version-info"), exports);
+__exportStar(require("./format"), exports);
+__exportStar(require("./fetch"), exports);
+//# sourceMappingURL=index.js.map

package/dist/ui5/version-info.d.ts

@@ -0,0 +1,106 @@
+import { FlexLayer } from '../types';
+import type { UI5Version } from '../types';
+/**
+ * Service class for handling SAP UI5 version information.
+ * This class provides methods to fetch and validate UI5 versions, retrieve public and internal versions,
+ * and format or modify version strings as per specific requirements like snapshots.
+ *
+ * @class UI5VersionInfo
+ */
+export declare class UI5VersionInfo {
+    /** Singleton instance */
+    private static instance;
+    /** Public UI5 version data fetched from CDN */
+    private publicVersions;
+    /** All available internal UI5 versions (fetched once and cached) */
+    private releasedVersions;
+    /** Indicates if a valid UI5 version was detected on the system */
+    isVersionDetected: boolean;
+    /** System-detected UI5 version */
+    systemVersion?: string;
+    /** Whether the project is CUSTOMER_BASE layer */
+    private readonly isCustomerBase;
+    /**
+     * Private constructor to enforce singleton pattern.
+     *
+     * @param {FlexLayer} layer - Flex layer (used once to configure instance).
+     */
+    private constructor();
+    /**
+     * Returns the singleton instance of UI5VersionManager.
+     *
+     * @param {FlexLayer} layer - Used only during first initialization.
+     * @returns {UI5VersionManager} Instance.
+     */
+    static getInstance(layer: FlexLayer): UI5VersionInfo;
+    /**
+     * Retrieves the latest version from the available public versions.
+     *
+     * @returns The latest available version.
+     */
+    getLatestVersion(): string;
+    /**
+     * Fetches public versions from the UI5 CDN.
+     *
+     * @returns {Promise<UI5Version>} An object containing version details fetched from the UI5 CDN.
+     */
+    getPublicVersions(): Promise<UI5Version>;
+    /**
+     * Retrieves and filters internal UI5 versions.
+     *
+     * If the versions have not been cached, it calls fetchInternalVersions() to retrieve and cache them.
+     * It then filters the versions based on the minimum supported version.
+     *
+     * @param {string} latestVersion - The latest available version.
+     * @returns {Promise<string[]>} A promise that resolves to an array of supported internal UI5 version strings.
+     */
+    private getInternalVersions;
+    /**
+     * Determines the appropriate UI5 version to use based on the provided version string and customer base status.
+     * This function handles scenarios where a 'snapshot' version might be in use while in external mode,
+     * or when the environment specifically requires using the latest public version, such as for S4HANA Cloud.
+     *
+     * @param {string} version - The current version string, which may include qualifiers like 'snapshot'.
+     * @param {boolean} isCustomerBase - Flag indicating whether the current mode is based on a customer base.
+     * @returns {string} The version string to be used.
+     * @example
+     * // returns '1.80.2'
+     * getVersionToBeUsed('1.80.2', false);
+     * @example
+     * // returns 'latestVersion' property value from class if 'version' contains 'snapshot'
+     * getVersionToBeUsed('1.84.6 snapshot', true);
+     */
+    getVersionToBeUsed(version: string, isCustomerBase: boolean): string;
+    /**
+     * Computes version labels based on the provided version.
+     *
+     * @param {string} version - The original version string.
+     * @returns {VersionLabels} An object with the formatted version, snapshot label, and latest label.
+     */
+    private getVersionLabels;
+    /**
+     * Determines if the provided version follows the standard version format.
+     *
+     * @param {string | undefined} version - The version string to be checked.
+     * @returns {string | undefined} A system version or undefined.
+     */
+    private checkSystemVersionPattern;
+    /**
+     * Gets versions relevant based on the system or user type.
+     * For internal users, all available versions are returned.
+     * For external users, only versions higher than the current system version are shown.
+     *
+     * @param {string} [systemVersion] - The current system version.
+     * @returns {Promise<string[]>} An array of relevant version strings.
+     * If the version is not detected, returns the latest released version.
+     */
+    getRelevantVersions(systemVersion?: string): Promise<string[]>;
+    /**
+     * Fetches versions that are higher than a specified version.
+     *
+     * @param {string} version - The baseline version to compare against.
+     * @returns {Promise<string[]>} An array of versions higher than the specified version.
+     */
+    private getHigherVersions;
+}
+//# sourceMappingURL=version-info.d.ts.map

package/dist/ui5/version-info.js

@@ -0,0 +1,193 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UI5VersionInfo = void 0;
+const fetch_1 = require("./fetch");
+const format_1 = require("./format");
+const constants_1 = require("../base/constants");
+/**
+ * Service class for handling SAP UI5 version information.
+ * This class provides methods to fetch and validate UI5 versions, retrieve public and internal versions,
+ * and format or modify version strings as per specific requirements like snapshots.
+ *
+ * @class UI5VersionInfo
+ */
+class UI5VersionInfo {
+    /** Singleton instance */
+    static instance;
+    /** Public UI5 version data fetched from CDN */
+    publicVersions;
+    /** All available internal UI5 versions (fetched once and cached) */
+    releasedVersions;
+    /** Indicates if a valid UI5 version was detected on the system */
+    isVersionDetected;
+    /** System-detected UI5 version */
+    systemVersion;
+    /** Whether the project is CUSTOMER_BASE layer */
+    isCustomerBase;
+    /**
+     * Private constructor to enforce singleton pattern.
+     *
+     * @param {FlexLayer} layer - Flex layer (used once to configure instance).
+     */
+    constructor(layer) {
+        this.isCustomerBase = layer === "CUSTOMER_BASE" /* FlexLayer.CUSTOMER_BASE */;
+    }
+    /**
+     * Returns the singleton instance of UI5VersionManager.
+     *
+     * @param {FlexLayer} layer - Used only during first initialization.
+     * @returns {UI5VersionManager} Instance.
+     */
+    static getInstance(layer) {
+        if (!UI5VersionInfo.instance) {
+            UI5VersionInfo.instance = new UI5VersionInfo(layer);
+        }
+        return UI5VersionInfo.instance;
+    }
+    /**
+     * Retrieves the latest version from the available public versions.
+     *
+     * @returns The latest available version.
+     */
+    getLatestVersion() {
+        return this.publicVersions?.latest?.version;
+    }
+    /**
+     * Fetches public versions from the UI5 CDN.
+     *
+     * @returns {Promise<UI5Version>} An object containing version details fetched from the UI5 CDN.
+     */
+    async getPublicVersions() {
+        if (!this.publicVersions) {
+            this.publicVersions = await (0, fetch_1.fetchPublicVersions)();
+        }
+        return this.publicVersions;
+    }
+    /**
+     * Retrieves and filters internal UI5 versions.
+     *
+     * If the versions have not been cached, it calls fetchInternalVersions() to retrieve and cache them.
+     * It then filters the versions based on the minimum supported version.
+     *
+     * @param {string} latestVersion - The latest available version.
+     * @returns {Promise<string[]>} A promise that resolves to an array of supported internal UI5 version strings.
+     */
+    async getInternalVersions(latestVersion) {
+        if (!this.releasedVersions) {
+            this.releasedVersions = await (0, fetch_1.fetchInternalVersions)(latestVersion);
+        }
+        return this.releasedVersions.filter(format_1.isFeatureSupportedVersion.bind(this, '1.71.0'));
+    }
+    /**
+     * Determines the appropriate UI5 version to use based on the provided version string and customer base status.
+     * This function handles scenarios where a 'snapshot' version might be in use while in external mode,
+     * or when the environment specifically requires using the latest public version, such as for S4HANA Cloud.
+     *
+     * @param {string} version - The current version string, which may include qualifiers like 'snapshot'.
+     * @param {boolean} isCustomerBase - Flag indicating whether the current mode is based on a customer base.
+     * @returns {string} The version string to be used.
+     * @example
+     * // returns '1.80.2'
+     * getVersionToBeUsed('1.80.2', false);
+     * @example
+     * // returns 'latestVersion' property value from class if 'version' contains 'snapshot'
+     * getVersionToBeUsed('1.84.6 snapshot', true);
+     */
+    getVersionToBeUsed(version, isCustomerBase) {
+        if (!version || (isCustomerBase && version.includes('snapshot'))) {
+            return this.getLatestVersion();
+        }
+        return version;
+    }
+    /**
+     * Computes version labels based on the provided version.
+     *
+     * @param {string} version - The original version string.
+     * @returns {VersionLabels} An object with the formatted version, snapshot label, and latest label.
+     */
+    getVersionLabels(version) {
+        let formattedVersion = '';
+        let systemSnapshotLabel = '';
+        let systemLatestLabel = '';
+        if (version) {
+            const latestVersion = this.getLatestVersion();
+            formattedVersion = (0, format_1.removeTimestampFromVersion)(version);
+            this.systemVersion = formattedVersion;
+            systemSnapshotLabel = (0, format_1.addSnapshot)(version, latestVersion);
+            systemLatestLabel = formattedVersion === latestVersion ? constants_1.LATEST_VERSION : '';
+        }
+        return { formattedVersion, systemSnapshotLabel, systemLatestLabel };
+    }
+    /**
+     * Determines if the provided version follows the standard version format.
+     *
+     * @param {string | undefined} version - The version string to be checked.
+     * @returns {string | undefined} A system version or undefined.
+     */
+    checkSystemVersionPattern(version) {
+        const pattern = /^[1-9]\.\d{1,3}\.\d{1,2}\.*/;
+        if (version) {
+            this.isVersionDetected = pattern.test(version);
+        }
+        this.systemVersion = this.isVersionDetected ? version : undefined;
+        return this.systemVersion;
+    }
+    /**
+     * Gets versions relevant based on the system or user type.
+     * For internal users, all available versions are returned.
+     * For external users, only versions higher than the current system version are shown.
+     *
+     * @param {string} [systemVersion] - The current system version.
+     * @returns {Promise<string[]>} An array of relevant version strings.
+     * If the version is not detected, returns the latest released version.
+     */
+    async getRelevantVersions(systemVersion) {
+        const version = this.checkSystemVersionPattern(systemVersion);
+        const publicVersions = await this.getPublicVersions();
+        const latestVersion = publicVersions?.latest?.version;
+        let versions;
+        const { formattedVersion, systemSnapshotLabel, systemLatestLabel } = this.getVersionLabels(version);
+        if (!this.isCustomerBase) {
+            versions = await this.getInternalVersions(latestVersion);
+            if (version) {
+                const regex = new RegExp(`${formattedVersion} `, 'g');
+                versions = versions.map((v) => v.replace(regex, `${formattedVersion}${systemSnapshotLabel} ${constants_1.CURRENT_SYSTEM_VERSION}`));
+                versions.unshift((0, format_1.buildSystemVersionLabel)(formattedVersion, systemSnapshotLabel, systemLatestLabel));
+            }
+            versions.unshift(constants_1.SNAPSHOT_VERSION, constants_1.SNAPSHOT_UNTESTED_VERSION);
+        }
+        else if (version && systemSnapshotLabel === '') {
+            versions = await this.getHigherVersions(formattedVersion);
+            versions.unshift((0, format_1.buildSystemVersionLabel)(formattedVersion, systemSnapshotLabel, systemLatestLabel));
+        }
+        else {
+            versions = [`${latestVersion} ${constants_1.LATEST_VERSION}`];
+        }
+        return [...new Set(versions)];
+    }
+    /**
+     * Fetches versions that are higher than a specified version.
+     *
+     * @param {string} version - The baseline version to compare against.
+     * @returns {Promise<string[]>} An array of versions higher than the specified version.
+     */
+    async getHigherVersions(version) {
+        const publicVersions = await this.getPublicVersions();
+        const latestVersion = publicVersions?.latest?.version;
+        const radix = 10;
+        const [_, baselineMinor, baselineMicro] = version.split('.').map((part) => parseInt(part, radix));
+        const higherVersions = Object.keys(publicVersions)
+            .filter((key) => key !== 'latest') // Exclude 'latest' key from the iteration
+            .map((key) => publicVersions[key]['version'])
+            .filter((ver) => {
+            const [, minor, micro] = ver.split('.').map((part) => parseInt(part, radix));
+            return minor > baselineMinor || (minor === baselineMinor && micro > baselineMicro);
+        });
+        const result = higherVersions
+            .map((ver) => (ver === latestVersion ? `${ver} ${constants_1.LATEST_VERSION}` : ver))
+            .reverse();
+        return result;
+    }
+}
+exports.UI5VersionInfo = UI5VersionInfo;
+//# sourceMappingURL=version-info.js.map