@sap/cds-dk 7.4.0 → 7.5.0

package/lib/build/provider/java/index.js

@@ -6,6 +6,7 @@ const { OUTPUT_MODE, OUTPUT_MODE_RESULT, FILE_EXT_CDS, CONTENT_LANGUAGE_BUNDLES,
     OUTPUT_MODE_FILESYSTEM, FLAVOR_LOCALIZED_EDMX, CONTENT_EDMX, CONTENT_LOCALIZED_EDMX } = require('../../constants')
 const { getI18nDefaultFolder } = require('../../util')
 const DEFAULT_COMPILE_DEST_FOLDER = path.normalize('src/main/resources/edmx')
+const DEBUG = cds.debug('cli|build')
 
 class JavaBuildPlugin extends EdmxBuildPlugin {
     init() {
@@ -49,7 +50,7 @@ class JavaBuildPlugin extends EdmxBuildPlugin {
         if (this.isStagingBuild()) {
             return super.clean()
         }
-        this.logger._debug && this.logger.debug(`Deleting build target folder ${this.task.options.compileDest}`)
+        DEBUG?.(`Deleting build target folder ${this.task.options.compileDest}`)
         await fs.promises.rm(this.task.options.compileDest, { force: true, recursive: true })
     }
 

package/lib/build/provider/mtx-extension/index.js

@@ -1,11 +1,11 @@
 const path = require('path')
 const fs = require('fs')
 const cds = require('../../../cds')
-
 const InternalBuildPlugin = require('../internalBuildPlugin')
 const { FOLDER_GEN, EXTENSION_POINT_VALIDATION } = require('../../constants')
 const ResourcesTarBuilder = require('../mtx/resourcesTarBuilder')
 const { BuildError, BuildMessage } = require('../../util')
+const DEBUG = cds.debug('cli|build')
 
 class MtxExtensionBuildPlugin extends InternalBuildPlugin {
     init() {
@@ -37,12 +37,14 @@ class MtxExtensionBuildPlugin extends InternalBuildPlugin {
                 extModel.requires.length = 0
             }
 
-            // !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
-            // perform all model operations before the linter is called as the linter 
+            // IMPORTANT NOTE: perform all model operations before the linter is called as the linter
             // will modify the model causing the creation of 'unresolved' associations
             await this.compileToJson(extModel, path.join(destExt, 'extension.csn'))
             await this.collectLanguageBundles(extModel, path.join(destExt, 'i18n'))
 
+            // perform SQL backend validation to prevent extension deployment problems later on
+            cds.compile.to.sql(model)
+
             const files = Object.keys(await cds.deploy.resources(model))
             if (files.length > 0) {
                 const dataDest = path.join(destExt, 'data')
@@ -54,11 +56,12 @@ class MtxExtensionBuildPlugin extends InternalBuildPlugin {
                         })
                 )
             }
+
             if (!this.hasBuildOption(EXTENSION_POINT_VALIDATION, false)) {
                 try {
                     // throws error in case of linting errors
                     this._lintExtModel(extModel, model)
-                } catch(error) {
+                } catch (error) {
                     // cleanup existing files in case of an error
                     await fs.promises.rm(this.task.dest, { recursive: true })
                     throw error
@@ -105,7 +108,7 @@ class MtxExtensionBuildPlugin extends InternalBuildPlugin {
             return
         }
         const env = cds.env.for('cds', path.join(this.task.src, this._getAppPackageFolder()))
-        this.logger._debug && this.logger.debug(`Saas extension point restrictions:\n${env.requires?.['cds.xt.ExtensibilityService']}`)
+        DEBUG?.(`Saas extension point restrictions:\n${env.requires?.['cds.xt.ExtensibilityService']}`)
 
         const messages = linter.lint(extModel, model, env)
         if (messages.length) {

package/lib/build/provider/mtx-sidecar/index.js

@@ -6,6 +6,7 @@ const NodejsBuildPlugin = require('../nodejs')
 const ResourcesTarProvider = require('../mtx/resourcesTarBuilder')
 const { ERROR } = NodejsBuildPlugin
 const { relativePaths, BuildError, resolveRequiredSapModels, getI18nDefaultFolder } = require('../../util')
+const DEBUG = cds.debug('cli|build')
 
 const DEFAULT_MAIN_FOLDER = "_main"
 
@@ -114,7 +115,7 @@ class MtxSidecarBuildPlugin extends NodejsBuildPlugin {
             if (!modelFilePaths || modelFilePaths.length === 0) {
                 throw new BuildError("No CDS models found in MTX sidecar. Make sure up-to-date versions of the required npm modules are installed.")
             }
-            this._logger._debug && this._logger.debug(`sidecar model: ${relativePaths(cds.root, modelFilePaths).join(", ")}`)
+            DEBUG?.(`sidecar model: ${relativePaths(cds.root, modelFilePaths).join(", ")}`)
 
             // check whether all models belonging to the @sap namespace can be resolved
             const unresolved = resolveRequiredSapModels(modelPaths)

package/lib/build/provider/nodejs/index.js

@@ -3,10 +3,11 @@ const path = require('path')
 const cds = require('../../../cds')
 const cmd = require('../../../util/command');
 const EdmxBuildPlugin = require('../edmxBuildPlugin')
-const { BuildError, pathExists } = require('../../util')
+const { BuildError } = require('../../util')
 const { OUTPUT_MODE, OUTPUT_MODE_FILESYSTEM, ODATA_VERSION_V2, FOLDER_GEN, CONTENT_EDMX, CONTENT_PACKAGELOCK_JSON,
     CONTENT_NPMRC, CONTENT_CDSRC_JSON, CONTENT_ENV, CONTENT_DEFAULT_ENV_JSON, FLAVOR_LOCALIZED_EDMX } = require('../../constants')
 const { WARNING } = EdmxBuildPlugin
+const DEBUG = cds.debug('cli|build')
 
 class NodejsBuildPlugin extends EdmxBuildPlugin {
     init() {
@@ -67,7 +68,7 @@ class NodejsBuildPlugin extends EdmxBuildPlugin {
         if (cds.env.build.target === '.') {
             // delete the entire 'task.dest' folder otherwise, for details see #constructor
             // - the value of the folder 'src' has been appended to the origin 'task.dest' dir
-            this.logger._debug && this.logger.debug(`Deleting build target folder ${this.destSrv}`)
+            DEBUG?.(`Deleting build target folder ${this.destSrv}`)
             await fs.promises.rm(this.isStagingBuild() ? this.task.dest : this.destSrv, { force: true, recursive: true })
         }
     }
@@ -159,74 +160,79 @@ class NodejsBuildPlugin extends EdmxBuildPlugin {
     }
 
     async _addWorkspaceDependencies(dest) {
-        let packageDescriptors
-        try {
-             packageDescriptors = await this._execNpmPack(dest)
-        } catch (e) {
-            this.logger.debug(e)
-            throw new BuildError(`Failed to package npm workspace dependencies\n${e.message}`)
+        const wsRoot = this._findWorkspaceRoot(cds.root)
+        const appPkg = require(path.join(dest, 'package.json'))
+        let workspaces
+        if (this.task.options?.workspaces) {
+            workspaces = Array.isArray(this.task.options.workspaces) ? this.task.options.workspaces : [this.task.options.workspaces]
         }
-        if (packageDescriptors?.length) {
-            const packageJson = require(path.join(dest, 'package.json'))
-            const dependencies = packageJson.dependencies
-            const devDependencies = packageJson.devDependencies
-            let changed
-            const promises = []
-            for (const packageDescriptor of packageDescriptors) {
-                const {name, filename: fileName} = packageDescriptor
-                const filePath = path.join(dest, fileName)                        
-                if (dependencies?.[name] === '*' || devDependencies?.[name] === '*') {
-                    if (dependencies?.[name] === '*') {
-                        dependencies[name] = `file:${fileName}`
-                    } else {
-                        devDependencies[name] = `file:${fileName}`
-                    }
-                    this.pushFile(filePath)
-                    changed |= true
-                } else {
-                    if (await pathExists(filePath)) {
-                        promises.push(fs.promises.rm(filePath))
+        if (!workspaces) {
+            workspaces = []
+            for (const name in appPkg.dependencies) {
+                if (appPkg.dependencies[name] === '*') {
+                    try {
+                        const pkg = require.resolve(path.join(name, 'package.json'), { paths: [wsRoot] })
+                        workspaces.push(path.dirname(path.relative(wsRoot, pkg)))
+                    } catch(e) {
+                        if (e.code === 'MODULE_NOT_FOUND') {
+                            throw new BuildError(`Workspace packaging failed - module '${name}' not found. Make sure that configured npm workspaces are installed.`)
+                        }
+                        throw e
                     }
                 }
             }
-            if (changed) {
-                promises.push(this.write(JSON.stringify(packageJson, 0, 2)).to(path.join(dest, 'package.json')))
-            } else {
-                throw new BuildError('No matching workspaces found!')
-            }
-            await Promise.all(promises)
         }
-    }
-    
-    async _execNpmPack(dest) {
-        function findWorkspaceRoot(dir) {
-            if(fs.existsSync(path.join(dir, 'package.json'))) {
-                if(require(path.join(dir, 'package.json')).workspaces) {
-                    return dir
-                }
+        if (workspaces.length) {
+            let pkgDescriptors
+            try {
+                pkgDescriptors = await this._execNpmPack(dest, wsRoot, workspaces)
+            } catch (e) {
+                DEBUG?.(e)
+                throw new BuildError(`Failed to package npm workspace dependencies\n${e.message}`)
             }
-            if(fs.existsSync(path.join(dir, '.gitmodules')) || fs.existsSync(path.join(dir, 'node_modules'))) {
-                return // project root reached
+            if (pkgDescriptors?.length) {
+                let changed
+                for (const pkgDescriptor of pkgDescriptors) {
+                    const {name, filename: fileName} = pkgDescriptor
+                    const filePath = path.join(dest, fileName)                        
+                    if (appPkg.dependencies?.[name] === '*') {
+                        appPkg.dependencies[name] = `file:${fileName}`
+                        this.pushFile(filePath)
+                        changed |= true
+                    }
+                }
+                if (changed) {
+                    await this.write(JSON.stringify(appPkg, 0, 2)).to(path.join(dest, 'package.json'))
+                } else {
+                    throw new BuildError('No matching workspaces found!')
+                }
             }
-            if (path.dirname(dir) !== dir) {
-                return findWorkspaceRoot(path.dirname(dir))
+        }
+    }
+
+    _findWorkspaceRoot(dir) {
+        try {
+            if(require(path.join(dir, 'package.json')).workspaces) {
+              return dir
             }
+        } catch(err) {
+            // ignore
         }
-        const wsRoot = findWorkspaceRoot(cds.root)
-        if (!wsRoot) {
-            throw new BuildError('No workspace configuration found!')
+        if(fs.existsSync(path.join(dir, '.gitmodules')) || fs.existsSync(path.join(dir, 'node_modules'))) {
+            return // project root reached
         }
-        const args = ['pack', '-ws', '--json', `--pack-destination=${dest}`]
-        if (this.task.options?.workspaces) {
-            let {workspaces} = this.task.options
-            workspaces = Array.isArray(workspaces) ? workspaces : [workspaces]
-            workspaces.forEach(w => args.push(`-w=${w}`))
+        if (path.dirname(dir) !== dir) {
+            return this._findWorkspaceRoot(path.dirname(dir))
         }
-        this.logger._debug && this.logger.debug(`execute command: npm ${args}`)
-
-        const result = await cmd.spawnCommand( 'npm', args, { cwd: wsRoot || cds.root }, true, !!this.logger._debug)
+    }
+    
+    async _execNpmPack(dest, wsRoot, workspaces) {
+        const args = ['pack', '-ws', '--json', `--pack-destination=${dest}`]
+        workspaces.forEach(w => args.push(`-w=${w}`))
 
-        this.logger._debug && this.logger.debug(result)
+        DEBUG?.(`execute command: npm ${args}`)
+        const result = await cmd.spawnCommand( 'npm', args, { cwd: wsRoot }, true, !!DEBUG)
+        DEBUG?.(result)
         return JSON.parse(result)
     }
 }

package/lib/compile/openapi/csdl2openapi.js

@@ -77,8 +77,18 @@ module.exports.csdl2openapi = function (
     preProcess(csdl, boundOverloads, derivedTypes, alias, namespace, namespaceUrl, voc);
 
     const entityContainer = csdl.$EntityContainer ? modelElement(csdl.$EntityContainer) : {};
+    if (csdl.$EntityContainer) {
+        let serviceName = nameParts(csdl.$EntityContainer).qualifier;
+        Object.keys(entityContainer).forEach(element => {
+            if (entityContainer[element].$Type) {
+                let type = nameParts(entityContainer[element].$Type).name;
+                if (csdl[serviceName]?.[type]?.['@cds.autoexpose'] || csdl[serviceName]?.[type]?.['@cds.autoexposed']) 
+                    entityContainer[element]['$cds.autoexpose'] = true;
+                }
+        });
+    }
+
     const keyAsSegment = entityContainer ? entityContainer[voc.Capabilities.KeyAsSegmentSupported] : {};
-    const deepUpdate = entityContainer ? entityContainer[voc.Capabilities.DeepUpdateSupport] && entityContainer[voc.Capabilities.DeepUpdateSupport].Supported : {};
 
     const openapi = {
         openapi: '3.0.2',
@@ -534,7 +544,7 @@ module.exports.csdl2openapi = function (
         if (prefixParameters.length > 0) pathItem.parameters = prefixParameters;
 
         operationRead(pathItem, element, name, sourceName, targetName, target, level, restrictions, false, nonExpandable);
-        if (element.$Collection && (element.$ContainsTarget || level < 2 && target)) {
+        if (!root['$cds.autoexpose'] && element.$Collection && (element.$ContainsTarget || level < 2 && target)) {
             operationCreate(pathItem, element, name, sourceName, targetName, target, level, restrictions);
         }
         pathItemsForBoundOperations(paths, prefix, prefixParameters, element, sourceName);
@@ -544,9 +554,11 @@ module.exports.csdl2openapi = function (
                 if (level < maxLevels)
                     pathItemsWithKey(paths, prefix, prefixParameters, element, root, sourceName, targetName, target, level, navigationPath, restrictions, nonExpandable);
             } else {
-                operationUpdate(pathItem, element, name, sourceName, target, level, restrictions);
-                if (element.$Nullable) {
-                    operationDelete(pathItem, element, name, sourceName, target, level, restrictions);
+                if (!root['$cds.autoexpose']) {
+                    operationUpdate(pathItem, element, name, sourceName, target, level, restrictions);
+                    if (element.$Nullable) {
+                        operationDelete(pathItem, element, name, sourceName, target, level, restrictions);
+                    }
                 }
                 pathItemsForBoundOperations(paths, prefix, prefixParameters, element, sourceName);
                 pathItemsWithNavigation(paths, prefix, prefixParameters, type, root, sourceName, level, navigationPath);
@@ -616,8 +628,10 @@ module.exports.csdl2openapi = function (
                 paths[path] = pathItem;
 
                 operationRead(pathItem, element, name, sourceName, targetName, target, level, restrictions, true, nonExpandable);
-                operationUpdate(pathItem, element, name, sourceName, target, level, restrictions, true);
-                operationDelete(pathItem, element, name, sourceName, target, level, restrictions, true);
+                if (!root['$cds.autoexpose']) {
+                    operationUpdate(pathItem, element, name, sourceName, target, level, restrictions, true);
+                    operationDelete(pathItem, element, name, sourceName, target, level, restrictions, true);
+                }
                 if (Object.keys(pathItem).filter((i) => i !== "parameters").length === 0)
                     delete paths[path];
 
@@ -1773,7 +1787,7 @@ see [Expand](http://docs.oasis-open.org/odata/odata/v4.01/odata-v4.01-part1-prot
             title: name,
             enum: members
         };
-        const description = type[voc.Core.Description];
+        const description = type[voc.Core.LongDescription];
         if (description) s.description = description;
         schemas[qualifier + '.' + name] = s;
     }
@@ -1789,7 +1803,7 @@ see [Expand](http://docs.oasis-open.org/odata/odata/v4.01/odata-v4.01-part1-prot
     function schemaForTypeDefinition(schemas, qualifier, name, type) {
         const s = getSchema(Object.assign({ $Type: type.$UnderlyingType }, type));
         s.title = name;
-        const description = type[voc.Core.Description];
+        const description = type[voc.Core.LongDescription];
         if (description) s.description = description;
         schemas[qualifier + '.' + name] = s;
     }
@@ -1825,11 +1839,11 @@ see [Expand](http://docs.oasis-open.org/odata/odata/v4.01/odata-v4.01-part1-prot
                 if (property.$Collection && suffix === "" && isCount === true) {
                     schemaProperties[`${iName}@${csdl.$Version === '4.0' ? 'odata.' : ''}count`] = ref('count');
                 }
-                if (property[voc.Core.Permissions] != "Read" && !property[voc.Core.Computed] && property.$ContainsTarget) {
+                if (property[voc.Core.Permissions] != "Read" && !property[voc.Core.Computed] && ( property.$ContainsTarget || property.$OnDelete === 'Cascade') ) {
                     if (suffix === SUFFIX.create)
                         schemaProperties[iName] = getSchema(property, SUFFIX.create);
-                    if (suffix === SUFFIX.update && deepUpdate)
-                        schemaProperties[iName] = getSchema(property, SUFFIX.create);
+                    if (suffix === SUFFIX.update)
+                        schemaProperties[iName] = getSchema(property, SUFFIX.update);
                 }
             } else {
                 if (property[voc.Core.Permissions] === "Read" || property[voc.Core.Computed]) {
@@ -1858,7 +1872,7 @@ see [Expand](http://docs.oasis-open.org/odata/odata/v4.01/odata-v4.01-part1-prot
         if (suffix === SUFFIX.create && required.length > 0)
             schemas[schemaName].required = [...new Set(required)];
 
-        const description = type[voc.Core.Description];
+        const description = type[voc.Core.LongDescription];
         if (description) {
             schemas[schemaName].description = description;
         }
@@ -2248,9 +2262,9 @@ see [Expand](http://docs.oasis-open.org/odata/odata/v4.01/odata-v4.01-part1-prot
             };
         }
 
-        if (!forParameter && element[voc.Core.Description]) {
+        if (!forParameter && element[voc.Core.LongDescription]) {
             if (s.$ref) s = { allOf: [s] };
-            s.description = element[voc.Core.Description];
+            s.description = element[voc.Core.LongDescription];
         }
 
         return s;

package/lib/compile/openapi/index.js

@@ -2,9 +2,13 @@ const csdl2openapi = require('./csdl2openapi')
 const cds = require('../../cds')
 
 module.exports = function processor(csn, options = {}) {
+    const edmOptions = Object.assign({
+        odataOpenapiHints: true, // hint to compiler
+        to: 'openapi' // hint to cds.compile.to.edm (usually set by CLI, but also do this in programmatic usages)
+    }, options)
 
     // must not be part of function* otherwise thrown errors are swallowed
-    const csdl = cds.compile.to.edm(csn, options);
+    const csdl = cds.compile.to.edm(csn, edmOptions);
 
     if (csdl[Symbol.iterator]) { // generator function means multiple services
         return _iterate(csdl, csn, options)
@@ -12,10 +16,6 @@ module.exports = function processor(csn, options = {}) {
         const openApiOptions = toOpenApiOptions(csdl, csn, options)
         return _getOpenApi(csdl, openApiOptions);
     }
-
-    // const file = csdl.$EntityContainer.replace(/\.[^.]+$/, '');
-    // yield [openapi, { file }]; // add file to avoid relative path in filename
-    // return openapi;
 }
 
 function* _iterate(csdl, csn, options) {
@@ -57,6 +57,6 @@ function servicePath(csdl, csn) {
     if (csdl.$EntityContainer) {
         const serviceName = csdl.$EntityContainer.replace(/\.[^.]+$/, '')
         const service = csn.definitions[serviceName]
-        return cds.service.path4 ? cds.service.path4(service) : cds.serve.path4(service)
+        return cds.service.path4?.(service) || cds.serve.path4(service)
     }
 }

package/lib/deploy/to-hana/hana.js

@@ -10,8 +10,8 @@ const { build } = require('../../build');
 const buildConstants = require('../../build/constants');
 
 const hdiDeployUtil = require('./hdiDeployUtil');
-const cfUtil = require('../../util/cfUtil');
-const gitUtil = require('../../util/gitUtil');
+const cfUtil = require('../../util/cf');
+const gitUtil = require('../../util/git');
 const mtaUtil = require('./mtaUtil');
 
 const { bold, info } = require('../../util/term');
@@ -48,7 +48,9 @@ class HanaDeployer {
     let { model, serviceName, tunnelAddress, vcapFile, undeployWhitelist, hdiOptions, dry } = options;
 
     if (model) {
-      throw 'Specifying a model for hana deployment is not supported.';
+      throw `Specifying a CDS model for HANA deployment is not supported.
+'cds deploy --to hana' performs 'cds build --for hana' which in turn uses the configured HANA build task.
+Therefore, specifying the CDS model is not required when calling 'cds deploy'.`;
     }
 
     if (dry) {

package/lib/env/schema.js

@@ -1,5 +1,4 @@
-const { join } = require('path')
-const { mergeJSON } = require('../init/util/merge')
+const { merge } = require('../init/merge')
 const { readJSON } = require('../util/fs')
 
 module.exports = async function overlay4(schemaName, cwd = process.cwd()) {
@@ -26,7 +25,7 @@ module.exports = async function overlay4(schemaName, cwd = process.cwd()) {
 
     // optional, don't throw if file not found
     try {
-        await mergeJSON(result, join(__dirname, 'schemas', schemaName))
+        await merge(__dirname, 'schemas', schemaName).into(result)
         result.description = result.description + ' - overlaid'
     } catch (err) {
         if (err.code !== 'ENOENT') throw err

package/lib/index.js

@@ -1,33 +1,73 @@
+/** @type { import('./cds') & CdsDk & CdsDkAdd & CdsDkBuild} */
 const cds = module.exports = require('./cds')
-cds.extend (cds.constructor) .with (class {
-  get import() { return super.import = require('./import/importapi') }
-})
-
-cds.extend (cds.compile.to.constructor) .with (class {
-  get asyncapi() { return super.asyncapi = require('./compile/asyncapi') }
-  get openapi() { return super.openapi = require('./compile/openapi') }
-  get xsuaa(){ return super.xsuaa = require('./compile/to-xsuaa') }
-  'edmx-v2'(csn,o) { return cds.compile.to.edmx(csn,{...o,flavor:'v2'}) }
-  'edmx-v4'(csn,o) { return cds.compile.to.edmx(csn,{...o,flavor:'v4'}) }
-  'edmx-w4'(csn,o) { return cds.compile.to.edmx(csn,{...o,flavor:'w4'}) }
-  'edmx-x4'(csn,o) { return cds.compile.to.edmx(csn,{...o,flavor:'x4'}) }
-})
-
-// Compat to cds <=6. Esp. BAS tools need it, see cap/issues#13918
-// TODO remove compat w/ cds-dk 8
-if (cds.compile.to.constructor.name === 'Object') { // not a class as in cds 7
-  cds.compile.to.xsuaa = require('./compile/to-xsuaa')
+
+class CdsDk {
+
+  get import() {
+    return super.import = require('./import/importapi')
+  }
+
+  get compile() {
+    let compile = require(_local('@sap/cds/lib/compile/cds-compile'))
+    cds.extend (compile.to.constructor) .with (class {
+      get asyncapi() { return super.asyncapi = require('./compile/asyncapi') }
+      get openapi() { return super.openapi = require('./compile/openapi') }
+      get xsuaa(){ return super.xsuaa = require('./compile/to-xsuaa') }
+      'edmx-v2'(csn,o) { return cds.compile.to.edmx(csn,{...o,flavor:'v2'}) }
+      'edmx-v4'(csn,o) { return cds.compile.to.edmx(csn,{...o,flavor:'v4'}) }
+      'edmx-w4'(csn,o) { return cds.compile.to.edmx(csn,{...o,flavor:'w4'}) }
+      'edmx-x4'(csn,o) { return cds.compile.to.edmx(csn,{...o,flavor:'x4'}) }
+    })
+    // Compat to cds <=6. Esp. BAS tools need it, see cap/issues#13918
+    // TODO remove compat w/ cds-dk 8
+    if (compile.to.constructor.name === 'Object') { // not a class as in cds 7
+      compile.to.xsuaa = require('./compile/to-xsuaa')
+    }
+    return super.compile = compile
+  }
+
+  // add overlay4 method to cds.schema to retrieve schema with cds-dk features
+  // schema is cds version specific; add cds-dk parts not present in cds, e.g. build
+  // failsafe for legacy cds without schema.constructor
+  get schema() {
+    let schema = require(_local('@sap/cds/lib/env/schemas'))
+    cds.extend(schema.constructor) .with (class {
+      get overlay4() { return super.overlay4 = require('./env/schema') }
+    })
+    return super.schema = schema
+  }
 }
 
-// add overlay4 method to cds.schema to retrieve schema with cds-dk features
-// schema is cds version specific; add cds-dk parts not present in cds, e.g. build
-// failsafe for legacy cds without schema.constructor
-cds.extend(cds.schema?.constructor || {}).with(class {
-  get overlay4() { return super.overlay4 = require('./env/schema') }
-})
+cds.extend (cds.constructor) .with (CdsDk)
 
-// set build API, potentially removing the old API facade from sap/cds 7
-// delete cds.__proto__?.build //> not required, as its overriden below anyways
-cds.extend (cds.constructor) .with (class {
+class CdsDkAdd {
+  get add() { return super.add = require('./init/add') }
+}
+class CdsDkBuild {
   get build() { return super.build = require('./build') }
-})
+}
+if (process.argv[2] in { 'add':1, 'init':1 }) {
+  cds.extend (cds.constructor) .with (CdsDkAdd)
+} else if (process.argv[2] in { 'build':1, 'deploy':1, 'push':1 }) {
+  cds.extend (cds.constructor) .with (CdsDkBuild)
+}
+
+const MIN_SUPPORTED_CDS_VERSION = 6
+const [cdsVersion] = cds.version.split('.')
+if (parseInt(cdsVersion) < MIN_SUPPORTED_CDS_VERSION) {
+  const [dkVersion] = require('../package.json').version.split('.')
+  console.error(`
+  This application uses '@sap/cds' version ${cdsVersion}, which is not compatible with the installed '@sap/cds-dk' version ${dkVersion}.
+  You can either:
+  - update '@sap/cds' to the latest version (recommended)
+  - downgrade '@sap/cds-dk' to version ${MIN_SUPPORTED_CDS_VERSION}
+`)
+  process.exit(1)
+}
+
+function _local (id) {
+  return require.resolve (id, {paths:[
+    process.cwd(), // project-local module is preferred
+    __dirname      // otherwise from our own dependencies
+  ]})
+}

package/lib/init/add.js

@@ -0,0 +1,17 @@
+const registered = new Map
+
+module.exports = {
+  Plugin: require('./plugin'),
+  merge: require('./merge').merge, // fluent API
+  readProject: require('./projectReader').readProject,
+  mvn: {
+    add: require('./mvn').add
+  },
+  registries: {
+    mta: require('./registries/mta')
+  },
+  register: (name, plugin) => {
+    registered.set(name, plugin)
+  },
+  registered
+}

package/lib/init/constants.js

@@ -4,7 +4,7 @@ module.exports = {
     COMMAND_INIT: 'init',
     COMMAND_ADD: 'add',
 
-    MAVEN_ARCHETYPE_VERSION: '2.4.0',
+    MAVEN_ARCHETYPE_VERSION: '2.4.1',
 
     OPTIONS: Object.freeze({
         JAVA: 'java',
@@ -15,6 +15,8 @@ module.exports = {
         TINY_SAMPLE: 'tiny-sample',
         SAMPLE: 'sample',
         PIPELINE: 'pipeline',
+        HELM_UNIFIED_RUNTIME: 'helm-unified-runtime',
+        HELM: 'helm',
         MTA: 'mta',
         CONNECTIVITY: 'connectivity',
         CF_MANIFEST: 'cf-manifest',
@@ -27,6 +29,7 @@ module.exports = {
         POSTGRES: 'postgres',
         SQLITE: 'sqlite',
         H2: 'h2',
+        LIQUIBASE: 'liquibase',
         LOCAL_MESSAGING: 'local-messaging',
         FILE_BASED_MESSAGING: 'file-based-messaging',
         ENTERPRISE_MESSAGING: 'enterprise-messaging',
@@ -35,11 +38,10 @@ module.exports = {
         APPROUTER: 'approuter',
         DESTINATION: 'destination',
         DATA: 'data',
-        KIBANA: 'kibana',
+        APPLICATION_LOGGING: 'application-logging',
         LINT: 'lint',
         LINT_GLOBAL: 'lint:global',
         LINT_DEV: 'lint:dev',
-        HELM: 'helm',
         TYPER: 'typer',
         HTML5_REPO: 'html5-repo',
         NOTIFICATIONS: 'notifications'