@sap-ux/project-access 1.19.6 → 1.19.7

package/dist/index.d.ts

@@ -2,4 +2,5 @@ export { FileName, DirName } from './constants';
 export { getFilePaths } from './file';
 export { createApplicationAccess, createProjectAccess, findAllApps, findCapProjects, findFioriArtifacts, findProjectRoot, getAppRootFromWebappPath, getAppProgrammingLanguage, getAppType, getCapCustomPaths, getCapEnvironment, getCapModelAndServices, getCapProjectType, getCdsFiles, getCdsRoots, getCdsServices, getCapI18nFolderNames, getI18nPropertiesPaths, getMtaPath, getNodeModulesPath, getProject, getProjectType, getWebappPath, isCapProject, isCapJavaProject, isCapNodeJsProject, loadModuleFromProject, readCapServiceMetadataEdmx, readUi5Yaml, toReferenceUri } from './project';
 export * from './types';
+export * from './library';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -52,4 +52,5 @@ Object.defineProperty(exports, "readCapServiceMetadataEdmx", { enumerable: true,
 Object.defineProperty(exports, "readUi5Yaml", { enumerable: true, get: function () { return project_1.readUi5Yaml; } });
 Object.defineProperty(exports, "toReferenceUri", { enumerable: true, get: function () { return project_1.toReferenceUri; } });
 __exportStar(require("./types"), exports);
+__exportStar(require("./library"), exports);
 //# sourceMappingURL=index.js.map

package/dist/library/constants.d.ts

@@ -0,0 +1,2 @@
+export declare const ui5Libs: string[];
+//# sourceMappingURL=constants.d.ts.map

package/dist/library/constants.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ui5Libs = void 0;
+exports.ui5Libs = [
+    'sap.apf',
+    'sap.base',
+    'sap.chart',
+    'sap.collaboration',
+    'sap.f',
+    'sap.fe',
+    'sap.fileviewer',
+    'sap.gantt',
+    'sap.landvisz',
+    'sap.m',
+    'sap.ndc',
+    'sap.ovp',
+    'sap.rules',
+    'sap.suite',
+    'sap.tnt',
+    'sap.ui',
+    'sap.uiext',
+    'sap.ushell',
+    'sap.uxap',
+    'sap.viz',
+    'sap.webanalytics',
+    'sap.zen'
+];
+//# sourceMappingURL=constants.js.map

package/dist/library/helpers.d.ts

@@ -0,0 +1,48 @@
+import type { LibraryResults, Manifest } from '../types';
+import { type ReuseLib } from './types';
+/**
+ * Returns an array of the reuse libraries found in the folders.
+ *
+ * @param libs - array of libraries found in the workspace folders.
+ * @returns list of reuse library
+ */
+export declare const getReuseLibs: (libs?: LibraryResults[]) => Promise<ReuseLib[]>;
+/**
+ * Checks for missing dependencies in the selected reuse libraries.
+ *
+ * @param answers - reuse libraries selected by the user
+ * @param reuseLibs - all available reuse libraries
+ * @returns a string with the missing dependencies
+ */
+export declare function checkDependencies(answers: ReuseLib[], reuseLibs: ReuseLib[]): string;
+/**
+ * Returns the library description.
+ *
+ * @param library - library object
+ * @param projectPath - project path
+ * @returns library description
+ */
+export declare function getLibraryDesc(library: any, projectPath: string): Promise<string>;
+/**
+ * Returns the library dependencies.
+ *
+ * @param library - library object
+ * @returns array of dependencies
+ */
+export declare function getLibraryDependencies(library: any): string[];
+/**
+ * Returns the manifest description.
+ *
+ * @param manifest - manifest object
+ * @param manifestPath - manifestPath path
+ * @returns manifest description
+ */
+export declare function getManifestDesc(manifest: Manifest, manifestPath: string): Promise<string>;
+/**
+ * Returns the manifest dependencies.
+ *
+ * @param manifest - manifest object
+ * @returns array of dependencies
+ */
+export declare function getManifestDependencies(manifest: Manifest): string[];
+//# sourceMappingURL=helpers.d.ts.map

package/dist/library/helpers.js

@@ -0,0 +1,284 @@
+"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.getManifestDependencies = exports.getManifestDesc = exports.getLibraryDependencies = exports.getLibraryDesc = exports.checkDependencies = exports.getReuseLibs = void 0;
+const path_1 = require("path");
+const constants_1 = require("./constants");
+const file_1 = require("../file");
+const constants_2 = require("../constants");
+const fs_1 = require("fs");
+const fast_xml_parser_1 = require("fast-xml-parser");
+const i18n_1 = require("../project/i18n");
+const i18n_2 = require("@sap-ux/i18n");
+/**
+ * Reads the manifest file and returns the reuse library.
+ *
+ * @param manifest - manifest file content
+ * @param manifestPath - path to the manifest file
+ * @param reuseLibs - existing reuse libraries
+ * @param projectRoot - root of the project
+ * @returns reuse library or undefined
+ */
+const getLibraryFromManifest = (manifest, manifestPath, reuseLibs, projectRoot) => __awaiter(void 0, void 0, void 0, function* () {
+    var _a, _b, _c;
+    let reuseLib;
+    const manifestType = (_a = manifest['sap.app']) === null || _a === void 0 ? void 0 : _a.type;
+    if ((manifestType === 'component' || manifestType === 'library') && manifestPath) {
+        const reuseType = getReuseType(manifestPath);
+        const libDeps = getManifestDependencies(manifest);
+        const description = yield getManifestDesc(manifest, manifestPath);
+        const libIndex = reuseLibs.findIndex((reuseLib) => reuseLib.name === (manifest === null || manifest === void 0 ? void 0 : manifest['sap.app'].id));
+        if (libIndex === -1) {
+            reuseLib = {
+                name: `${manifest['sap.app'].id}`,
+                path: manifestPath,
+                type: reuseType,
+                uri: (_c = (_b = manifest['sap.platform.abap']) === null || _b === void 0 ? void 0 : _b.uri) !== null && _c !== void 0 ? _c : '',
+                dependencies: libDeps,
+                libRoot: projectRoot,
+                description
+            };
+        }
+    }
+    return reuseLib;
+});
+/**
+ * Reads library file and returns a reuse lib object.
+ *
+ * @param library - library file content
+ * @param libraryPath - path to the library file
+ * @param projectRoot - root of the project
+ * @returns reuse library or undefined
+ */
+const getLibraryFromLibraryFile = (library, libraryPath, projectRoot) => __awaiter(void 0, void 0, void 0, function* () {
+    var _d, _e, _f, _g, _h;
+    let libEntry;
+    const parsedFile = new fast_xml_parser_1.XMLParser({ removeNSPrefix: true }).parse(library, false);
+    if ((_d = parsedFile === null || parsedFile === void 0 ? void 0 : parsedFile.library) === null || _d === void 0 ? void 0 : _d.name) {
+        const manifestType = (parsedFile === null || parsedFile === void 0 ? void 0 : parsedFile.library) ? 'library' : 'component';
+        if (manifestType === 'component' || manifestType === 'library') {
+            const reuseType = getReuseType(libraryPath);
+            const libDeps = getLibraryDependencies(parsedFile);
+            const description = yield getLibraryDesc(parsedFile, libraryPath);
+            libEntry = {
+                name: `${parsedFile.library.name}`,
+                path: libraryPath,
+                type: reuseType,
+                uri: ((_h = (_g = (_f = (_e = parsedFile.library) === null || _e === void 0 ? void 0 : _e.appData) === null || _f === void 0 ? void 0 : _f.manifest) === null || _g === void 0 ? void 0 : _g['sap.platform.abap']) === null || _h === void 0 ? void 0 : _h.uri) || '',
+                dependencies: libDeps,
+                libRoot: projectRoot,
+                description
+            };
+        }
+    }
+    return libEntry;
+});
+/**
+ * Updates the library options with the new library.
+ *
+ * @param reuseLibs - existing library options
+ * @param reuseLib - new library
+ */
+const updateLibOptions = (reuseLibs, reuseLib) => {
+    if (reuseLib) {
+        const libIndex = reuseLibs.findIndex((lib) => lib.name === reuseLib.name);
+        if (libIndex >= 0) {
+            // replace
+            reuseLibs[libIndex] = reuseLib;
+        }
+        else {
+            reuseLibs.push(reuseLib);
+        }
+    }
+};
+/**
+ * Returns an array of the reuse libraries found in the folders.
+ *
+ * @param libs - array of libraries found in the workspace folders.
+ * @returns list of reuse library
+ */
+const getReuseLibs = (libs) => __awaiter(void 0, void 0, void 0, function* () {
+    const reuseLibs = [];
+    if (libs) {
+        for (const lib of libs) {
+            const excludeFolders = ['.git', 'node_modules', 'dist'];
+            const manifestPaths = yield (0, file_1.findFiles)('manifest.json', lib.projectRoot, excludeFolders);
+            const libraryPaths = yield (0, file_1.findFiles)('library.js', lib.projectRoot, excludeFolders);
+            for (const manifestPath of manifestPaths) {
+                const manifest = JSON.parse(yield fs_1.promises.readFile((0, path_1.join)(manifestPath, constants_2.FileName.Manifest), { encoding: 'utf8' }));
+                const library = yield getLibraryFromManifest(manifest, (0, path_1.join)(manifestPath, constants_2.FileName.Manifest), reuseLibs, lib.projectRoot);
+                if (library) {
+                    reuseLibs.push(library);
+                }
+            }
+            for (const libraryPath of libraryPaths) {
+                const library = (yield fs_1.promises.readFile((0, path_1.join)(libraryPath, constants_2.FileName.Library), { encoding: 'utf8' })).toString();
+                const libFile = yield getLibraryFromLibraryFile(library, libraryPath, lib.projectRoot);
+                updateLibOptions(reuseLibs, libFile);
+            }
+        }
+    }
+    return reuseLibs;
+});
+exports.getReuseLibs = getReuseLibs;
+/**
+ * Gets the type of reuse library.
+ *
+ * @param libraryPath - path to the reuse library
+ * @returns the type of reuse library
+ */
+function getReuseType(libraryPath) {
+    return (0, fs_1.existsSync)((0, path_1.join)(libraryPath, '/library.js')) || (0, fs_1.existsSync)((0, path_1.join)(libraryPath, '/library.ts'))
+        ? "library" /* ReuseLibType.Library */
+        : "component" /* ReuseLibType.Component */;
+}
+/**
+ * Checks for missing dependencies in the selected reuse libraries.
+ *
+ * @param answers - reuse libraries selected by the user
+ * @param reuseLibs - all available reuse libraries
+ * @returns a string with the missing dependencies
+ */
+function checkDependencies(answers, reuseLibs) {
+    const missingDeps = [];
+    answers.forEach((answer) => {
+        const dependencies = answer.dependencies;
+        if (dependencies === null || dependencies === void 0 ? void 0 : dependencies.length) {
+            dependencies.forEach((dependency) => {
+                if (!reuseLibs.some((lib) => {
+                    return dependency === lib.name;
+                })) {
+                    missingDeps.push(dependency);
+                }
+            });
+        }
+    });
+    return missingDeps.join();
+}
+exports.checkDependencies = checkDependencies;
+/**
+ * Returns the library description.
+ *
+ * @param library - library object
+ * @param projectPath - project path
+ * @returns library description
+ */
+function getLibraryDesc(library, projectPath) {
+    var _a, _b, _c, _d, _e;
+    return __awaiter(this, void 0, void 0, function* () {
+        let libraryDesc = (_a = library === null || library === void 0 ? void 0 : library.library) === null || _a === void 0 ? void 0 : _a.documentation;
+        if (typeof libraryDesc === 'string' && libraryDesc.startsWith('{{')) {
+            const key = libraryDesc.substring(2, libraryDesc.length - 2);
+            libraryDesc = yield geti18nPropertyValue((0, path_1.join)(projectPath, (_e = (_d = (_c = (_b = library.library) === null || _b === void 0 ? void 0 : _b.appData) === null || _c === void 0 ? void 0 : _c.manifest) === null || _d === void 0 ? void 0 : _d.i18n) === null || _e === void 0 ? void 0 : _e.toString()), key);
+        }
+        return libraryDesc.toString();
+    });
+}
+exports.getLibraryDesc = getLibraryDesc;
+/**
+ * Returns the library dependencies.
+ *
+ * @param library - library object
+ * @returns array of dependencies
+ */
+function getLibraryDependencies(library) {
+    var _a, _b;
+    const result = [];
+    if ((_b = (_a = library === null || library === void 0 ? void 0 : library.library) === null || _a === void 0 ? void 0 : _a.dependencies) === null || _b === void 0 ? void 0 : _b.dependency) {
+        let deps = library.library.dependencies.dependency;
+        if (!Array.isArray(deps)) {
+            deps = [deps];
+        }
+        deps.forEach((lib) => {
+            // ignore libs that start with SAPUI5 delivered namespaces
+            if (!constants_1.ui5Libs.some((substring) => {
+                return lib.libraryName === substring || lib.libraryName.startsWith(substring + '.');
+            })) {
+                result.push(lib.libraryName);
+            }
+        });
+    }
+    return result;
+}
+exports.getLibraryDependencies = getLibraryDependencies;
+/**
+ * Returns the i18n property value.
+ *
+ * @param i18nPath - i18n path
+ * @param key - property key
+ * @returns i18n property value
+ */
+function geti18nPropertyValue(i18nPath, key) {
+    return __awaiter(this, void 0, void 0, function* () {
+        let value = '';
+        try {
+            const bundle = yield (0, i18n_2.getPropertiesI18nBundle)(i18nPath);
+            const node = bundle[key].find((i) => i.key.value === key);
+            if (node) {
+                value = node.value.value;
+            }
+        }
+        catch (e) {
+            // ignore exception
+        }
+        return value;
+    });
+}
+/**
+ * Returns the manifest description.
+ *
+ * @param manifest - manifest object
+ * @param manifestPath - manifestPath path
+ * @returns manifest description
+ */
+function getManifestDesc(manifest, manifestPath) {
+    var _a;
+    return __awaiter(this, void 0, void 0, function* () {
+        let manifestDesc = (_a = manifest['sap.app']) === null || _a === void 0 ? void 0 : _a.description;
+        if (typeof manifestDesc === 'string' && manifestDesc.startsWith('{{')) {
+            const key = manifestDesc.substring(2, manifestDesc.length - 2);
+            const { 'sap.app': i18nPath } = yield (0, i18n_1.getI18nPropertiesPaths)(manifestPath, manifest);
+            manifestDesc = yield geti18nPropertyValue(i18nPath, key);
+        }
+        const x = (manifestDesc !== null && manifestDesc !== void 0 ? manifestDesc : '').toString();
+        return x;
+    });
+}
+exports.getManifestDesc = getManifestDesc;
+/**
+ * Returns the manifest dependencies.
+ *
+ * @param manifest - manifest object
+ * @returns array of dependencies
+ */
+function getManifestDependencies(manifest) {
+    const result = [];
+    Object.values(['libs', 'components']).forEach((reuseType) => {
+        var _a, _b, _c, _d;
+        const dependencies = (_b = (_a = manifest['sap.ui5']) === null || _a === void 0 ? void 0 : _a.dependencies) === null || _b === void 0 ? void 0 : _b[reuseType];
+        if (dependencies) {
+            const libs = (_d = (_c = manifest === null || manifest === void 0 ? void 0 : manifest['sap.ui5']) === null || _c === void 0 ? void 0 : _c.dependencies) === null || _d === void 0 ? void 0 : _d.libs;
+            if (libs) {
+                Object.keys(libs).forEach((manifestLibKey) => {
+                    // ignore libs that start with SAPUI5 delivered namespaces
+                    if (!constants_1.ui5Libs.some((substring) => {
+                        return manifestLibKey === substring || manifestLibKey.startsWith(substring + '.');
+                    })) {
+                        result.push(manifestLibKey);
+                    }
+                });
+            }
+        }
+    });
+    return result;
+}
+exports.getManifestDependencies = getManifestDependencies;
+//# sourceMappingURL=helpers.js.map

package/dist/library/index.d.ts

@@ -0,0 +1,3 @@
+export * from './types';
+export { getReuseLibs, checkDependencies } from './helpers';
+//# sourceMappingURL=index.d.ts.map

package/dist/library/index.js

@@ -0,0 +1,22 @@
+"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 });
+exports.checkDependencies = exports.getReuseLibs = void 0;
+__exportStar(require("./types"), exports);
+var helpers_1 = require("./helpers");
+Object.defineProperty(exports, "getReuseLibs", { enumerable: true, get: function () { return helpers_1.getReuseLibs; } });
+Object.defineProperty(exports, "checkDependencies", { enumerable: true, get: function () { return helpers_1.checkDependencies; } });
+//# sourceMappingURL=index.js.map

package/dist/library/types.d.ts

@@ -0,0 +1,17 @@
+export declare const enum ReuseLibType {
+    Library = "library",
+    Component = "component"
+}
+/**
+ * Reuse library
+ */
+export interface ReuseLib {
+    name: string;
+    path: string;
+    type: ReuseLibType;
+    uri: string;
+    dependencies: string[];
+    libRoot: string;
+    description?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/library/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/project/cap.d.ts

@@ -44,8 +44,8 @@ export declare function getCapCustomPaths(capProjectPath: string): Promise<CapCu
 /**
  * Return the CAP model and all services. The cds.root will be set to the provided project root path.
  *
- * @param projectRoot - CAP project root where package.json resides or object specifying project root and optional logger to log additonal info
- * @returns {*}  {Promise<{ model: csn; services: ServiceInfo[] }>} - CAP Model and Services
+ * @param projectRoot - CAP project root where package.json resides or object specifying project root and optional logger to log additional info
+ * @returns {Promise<{ model: csn; services: ServiceInfo[] }>} - CAP Model and Services
  */
 export declare function getCapModelAndServices(projectRoot: string | {
     projectRoot: string;
@@ -112,5 +112,9 @@ export declare const toAbsoluteUri: (projectRoot: string, relativeUri: string) =
  * @returns {Promise<string>} - reference uri
  */
 export declare const toReferenceUri: (projectRoot: string, relativeUriFrom: string, relativeUriTo: string) => Promise<string>;
+/**
+ * Clear cache of path to global cds module.
+ */
+export declare function clearGlobalCdsPathCache(): void;
 export {};
 //# sourceMappingURL=cap.d.ts.map

package/dist/project/cap.js

@@ -9,7 +9,7 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
     });
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.toReferenceUri = exports.toAbsoluteUri = exports.getCapEnvironment = exports.readCapServiceMetadataEdmx = exports.getCdsServices = exports.getCdsRoots = exports.getCdsFiles = exports.getCapModelAndServices = exports.getCapCustomPaths = exports.isCapProject = exports.getCapProjectType = exports.isCapJavaProject = exports.isCapNodeJsProject = void 0;
+exports.clearGlobalCdsPathCache = exports.toReferenceUri = exports.toAbsoluteUri = exports.getCapEnvironment = exports.readCapServiceMetadataEdmx = exports.getCdsServices = exports.getCdsRoots = exports.getCdsFiles = exports.getCapModelAndServices = exports.getCapCustomPaths = exports.isCapProject = exports.getCapProjectType = exports.isCapJavaProject = exports.isCapNodeJsProject = void 0;
 const child_process_1 = require("child_process");
 const path_1 = require("path");
 const constants_1 = require("../constants");
@@ -113,8 +113,8 @@ exports.getCapCustomPaths = getCapCustomPaths;
 /**
  * Return the CAP model and all services. The cds.root will be set to the provided project root path.
  *
- * @param projectRoot - CAP project root where package.json resides or object specifying project root and optional logger to log additonal info
- * @returns {*}  {Promise<{ model: csn; services: ServiceInfo[] }>} - CAP Model and Services
+ * @param projectRoot - CAP project root where package.json resides or object specifying project root and optional logger to log additional info
+ * @returns {Promise<{ model: csn; services: ServiceInfo[] }>} - CAP Model and Services
  */
 function getCapModelAndServices(projectRoot) {
     var _a;
@@ -128,7 +128,7 @@ function getCapModelAndServices(projectRoot) {
         else {
             _projectRoot = projectRoot;
         }
-        const cds = yield loadCdsModuleFromProject(_projectRoot);
+        const cds = yield loadCdsModuleFromProject(_projectRoot, true);
         const capProjectPaths = yield getCapCustomPaths(_projectRoot);
         const modelPaths = [
             (0, path_1.join)(_projectRoot, capProjectPaths.app),
@@ -349,12 +349,13 @@ exports.getCapEnvironment = getCapEnvironment;
 /**
  * Load CAP CDS module. First attempt loads @sap/cds for a project based on its root.
  * Second attempt loads @sap/cds from global installed @sap/cds-dk.
- * Throws error if module could not be loaded.
+ * Throws error if module could not be loaded or strict mode is true and there is a version mismatch.
  *
  * @param capProjectPath - project root of a CAP project
+ * @param [strict] - optional, when set true an error is thrown, if global loaded cds version does not match the cds version from package.json dependency. Default is false.
  * @returns - CAP CDS module for a CAP project
  */
-function loadCdsModuleFromProject(capProjectPath) {
+function loadCdsModuleFromProject(capProjectPath, strict = false) {
     return __awaiter(this, void 0, void 0, function* () {
         let module;
         let loadProjectError;
@@ -379,6 +380,16 @@ function loadCdsModuleFromProject(capProjectPath) {
             throw Error(`Could not load cds module. Attempt to load module @sap/cds from project threw error '${loadProjectError}', attempt to load module @sap/cds from @sap/cds-dk threw error '${loadError}'`);
         }
         const cds = 'default' in module ? module.default : module;
+        // In case strict is true and there was a fallback to global cds installation for a project that has a cds dependency, check if major versions match
+        if (strict && loadProjectError) {
+            const cdsDependencyVersion = yield getCdsVersionFromPackageJson((0, path_1.join)(capProjectPath, constants_1.FileName.Package));
+            if (typeof cdsDependencyVersion === 'string') {
+                const globalCdsVersion = cds.version;
+                if (getMajorVersion(cdsDependencyVersion) !== getMajorVersion(globalCdsVersion)) {
+                    throw Error(`The @sap/cds major version (${cdsDependencyVersion}) specified in your CAP project is different to the @sap/cds version you have installed globally (${globalCdsVersion}). Please run 'npm install' on your CAP project to ensure that the correct CDS version is loaded.`);
+                }
+            }
+        }
         // Fix when switching cds versions dynamically
         if (global) {
             global.cds = cds;
@@ -503,6 +514,13 @@ function loadGlobalCdsModule() {
         return (0, module_loader_1.loadModuleFromProject)(globalCdsPathCache, '@sap/cds');
     });
 }
+/**
+ * Clear cache of path to global cds module.
+ */
+function clearGlobalCdsPathCache() {
+    globalCdsPathCache = '';
+}
+exports.clearGlobalCdsPathCache = clearGlobalCdsPathCache;
 /**
  * Get cds information, which includes versions and also the home path of cds module.
  *
@@ -536,4 +554,36 @@ function getCdsVersionInfo(cwd) {
         });
     });
 }
+/**
+ * Read the version string of the @sap/cds module from the package.json file.
+ *
+ * @param packageJsonPath - path to package.json
+ * @returns - version of @sap/cds from package.json or undefined
+ */
+function getCdsVersionFromPackageJson(packageJsonPath) {
+    var _a;
+    return __awaiter(this, void 0, void 0, function* () {
+        let version;
+        try {
+            if (yield (0, file_1.fileExists)(packageJsonPath)) {
+                const packageJson = yield (0, file_1.readJSON)(packageJsonPath);
+                version = (_a = packageJson === null || packageJson === void 0 ? void 0 : packageJson.dependencies) === null || _a === void 0 ? void 0 : _a['@sap/cds'];
+            }
+        }
+        catch (_b) {
+            // If we can't read or parse the package.json we return undefined
+        }
+        return version;
+    });
+}
+/**
+ * Get major version from version string.
+ *
+ * @param versionString - version string
+ * @returns - major version as number
+ */
+function getMajorVersion(versionString) {
+    var _a, _b;
+    return parseInt((_b = (_a = /\d+/.exec(versionString.split('.')[0])) === null || _a === void 0 ? void 0 : _a[0]) !== null && _b !== void 0 ? _b : '0', 10);
+}
 //# sourceMappingURL=cap.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sap-ux/project-access",
-  "version": "1.19.6",
+  "version": "1.19.7",
   "description": "Library to access SAP Fiori tools projects",
   "repository": {
     "type": "git",
@@ -23,6 +23,7 @@
     "node": ">=18.x"
   },
   "dependencies": {
+    "fast-xml-parser": "4.2.7",
     "findit2": "2.2.3",
     "mem-fs": "2.1.0",
     "mem-fs-editor": "9.4.0",