@sap/cds-dk 7.3.0 → 7.3.1

package/bin/add.js

@@ -33,7 +33,7 @@ module.exports = Object.assign(add, {
 
     *redis-messaging*       - add support for Redis messaging
 
-    *kibana-logging*        - add support for Kibana formatting
+    *kibana*                - add support for Kibana formatting
 
     *mta*                   - add support for MTA-based deployment
 

package/bin/extend.js

@@ -1,5 +1,5 @@
 module.exports = Object.assign(extend, {
-    options: ['--directory', '--subdomain', '--passcode', '--username', '--clientid', '--tagRule'],
+    options: ['--directory', '--subdomain', '--passcode', '--username', '--clientid', '--tagRule', '--defaultTag'],
     flags: ['--wsdl', '--templates', '--force', '--download-migrated-projects'],
     shortcuts: ['-d', '-s', '-p', '-u', '-c'],
     help: `
@@ -58,6 +58,10 @@ module.exports = Object.assign(extend, {
 
         Rule used to split up migrated extension projects into separate projects (please check migration documentation for more).
 
+    *--defaultTag*
+
+        Default tag used for migrated extension projects, default is 'migrated' (please check migration documentation for more).
+
 # SEE ALSO
 
     *cds activate* to activate an extension project.

package/bin/init.js

@@ -22,56 +22,51 @@ module.exports = Object.assign(init, {
         Add one or more features while creating the project.
         <feature> can be one of the following:
 
-        *nodejs*        - prepares as a Node.js-based project, cannot be used with *java*
+        *nodejs*                - creates as a Node.js-based project
 
-        *java*          - prepares as a Java-based project, cannot be used with *nodejs*
+        *java*                  - creates as a Java-based project
 
-                          This feature uses a Java Maven archetype to create a
-                          project using the *Java* programming language.
+        *hana*                  - add support for SAP HANA
 
-        *hana*          - adds configuration for SAP HANA databases
+        *sqlite*                - add support for SQLite databases
 
-        *sqlite*        - adds configuration for SQLite databases
+        *xsuaa*                 - add support for authentication via XSUAA
 
-        *xsuaa*         - adds configuration for authentication via XSUAA
+        *multitenancy*          - add support for multitenancy
 
-        *multitenancy*  - adds configuration for multitenancy
+        *toggles*               - add support for feature toggles
 
-        *toggles*       - adds configuration for feature toggles
+        *extensibility*         - add support for extensibility
 
-        *extensibility* - adds configuration for extensibility
+        *approuter*             - add support for application routing
 
-        *mtx*           - adds configuration for multitenancy, feature toggles and
-                          extensibility
+        *file-based-messaging*  - add support for file-based messaging
 
-        *approuter*     - adds configuration for the Cloud Foundry approuter
+        *enterprise-messaging*  - add support for SAP Event Mesh
 
-        *mta*           - adds an _mta.yaml_ file for MTA-based SAP Business
-                          Technology Platform deployment
+        *redis-messaging*       - add support for Redis messaging
 
-        *cf-manifest*   - adds _manifest.yml_ and _services-manifest.yml_ files for
-                          Cloud Foundry native deployment
+        *kibana*                - add support for Kibana formatting
 
-                          This approach makes use of the 'Create-Service-Push
-                          Plugin' that has to be installed separately using
-                          _cf install-plugin Create-Service-Push_.
-                          _cf create-service-push_ creates the service(s) and pushes
-                          the application(s) to the SAP Business Technology
-                          Platform.
+        *mta*                   - add support for MTA-based deployment
 
-        *pipeline*      - adds files for CI/CD pipeline integration
+        *cf-manifest*           - add support for CF-native deployment
 
-        *sample*        - adds sample files including Fiori UI
+        *helm*                  - add support for Helm-based Kyma deployment
 
-        *sample-tiny*   - adds minimal sample files
+        *html5-repo*            - add support for the HTML5 repository
 
-        *data*          - adds data content for CSN model entities (as csv files)
+        *pipeline*              - add files for CI/CD pipeline integration
 
-        *helm*          - adds helm chart folder that contains the files needed to
-                          deploy the application using Kyma.
+        *tiny-sample*           - add minimal sample files
 
-        *html5-repo*    - adds configuration for HTML5 Application Deployer to Helm
-                          Chart (Kyma Only).
+        *sample*                - add sample files including Fiori UI
+
+        *data*                  - add CSV headers for modeled entities
+
+        *typer*                 - add type generation for CDS models
+
+        *lint*                  - add support for CDS Lint
 
     *--java:mvn* <Comma separated maven archetype specific parameters>
 
@@ -85,16 +80,15 @@ module.exports = Object.assign(init, {
 
 # EXAMPLES
 
-    *cds init* test
-    *cds init* test --add java
-    *cds init* test --add java,hana
-    *cds init* --add mta
-    *cds init* --add cf-manifest
+    *cds init* bookshop
+    *cds init* bookshop --add java
+    *cds init* bookshop --add java,hana
+    *cds init* bookshop --add multitenancy,mta
     *cds init* --add java --java:mvn groupId=myGroup,artifactId=newId,package=my.company
 
 # SEE ALSO
 
-    *cds add* as shortcut for _cds init --add_.
+    *cds add* - to augment your projects later on
 
 `})
 

package/bin/repl.js

@@ -12,62 +12,42 @@ module.exports = Object.assign (repl, { options: [], help: `
     *cds eval*  to evaluate and execute JavaScript.
 `})
 
-function repl (_, options={}) {
-
-  // enable `await` statement for Node.js < 16
-  if (!process.env['CDS_REPL_SPAWNED'] && process.version.split('.')[0].slice(1) < '16') {
-    process.env['CDS_REPL_SPAWNED'] = true
-    return require('child_process').spawn('node',['--experimental-repl-await',
-      ...process.argv.slice(1) ], {stdio:'inherit'}
-    )
-  }
+async function repl (_, options={}) {
 
   const cds = require('../lib/cds')
-  const path = require('path')
-  const {inspect} = require('util')
+  console.log('\x1b[32m\x1b[1m'+'Welcome to cds repl v', cds.version, '\x1b[0m')
+
+  await cds.plugins
+
+  const { inspect } = require('util')
+  inspect.defaultOptions.colors = true
+  inspect.defaultOptions.depth = 11
 
-  const colors = options.colors !== false
-  const log = options.log || console.log
-  const info = colors ? require('../lib/util/term').info : s => s
-  log(info('Welcome to cds repl v'+ cds.version))
 
-  const cdsr = require('repl').start ({...options, writer:_writer, ignoreUndefined:true })
-  Object.defineProperty (cds,'repl',{value:cdsr})
+  const repl = require('repl').start ({
+    ...options, ignoreUndefined: true,
+    writer: o => {
+      if (!o || typeof o !== 'object') return o
+      return inspect(o).replace(/\[Object: null prototype\] /g, '')
+    }
+  })
 
-  cds.lazify (Object.assign (cdsr.context,{ cds,
+  Object.defineProperty (cds,'repl',{value:repl})
+  cds.lazify (Object.assign (repl.context,{ cds,
     Foo: lazy => new cds.entity ({name:'Foo'}),
     Bar: lazy => new cds.entity ({name:'Bar'}),
   }))
 
-  // cosmetics: don't show cds.env when inspecting cds
-  if (Reflect.getOwnPropertyDescriptor(cds,'env')) {
-    Reflect.defineProperty (cds,'env',{ value:cds.env, enumerable:false })
-  }
-
-  inspect.defaultOptions.colors = true
-  inspect.defaultOptions.depth = 11
-  function _writer (o) {
-    if (!o || typeof o !== 'object') return o
-    return inspect(o).replace(/\[Object: null prototype\] /g, '')
-  }
-
+  repl.history = new Array(222)
   const home = process.env.HOME || process.env.USERPROFILE
-  const history = path.join(home,'.cds-repl-history')
-  if (cdsr.setupHistory) {  // since Node.js 11
-    cdsr.setupHistory (history,()=>{})
-  } else {
-    const fs = require('fs')
-    const historySize = 111
-    fs.readFile(history, 'utf-8', (e, txt) => e || (cdsr.history = txt.split('\n')))
-    cdsr.on('exit', () => {
-      if (cdsr.history)  fs.writeFile(history, cdsr.history.slice(-historySize).join('\n'), () => {})
-    })
-  }
-
+  const history = require('path').join(home,'.cds-repl-history')
+  const fs = require('fs')
+  fs.readFile(history, 'utf-8', (e, txt) => e || Object.assign(repl.history, txt.split('\n')))
+  repl.on('exit', () => fs.writeFile(history, repl.history.join('\n'), () => {}))
 
   process.on('uncaughtException', console.error)
   process.on('unhandledRejection', console.error)
 
 }
-/* eslint no-console:0 */
+
 if (!module.parent) repl()

package/bin/watch.js

@@ -59,8 +59,7 @@ const t = module.exports.codes = {
   orange: colors ? '\x1b[38;2;255;140;0m' : '' // darker orange, works with bright and dark background
 }
 const extDefaults = 'cds,csn,csv,ts,mjs,cjs,js,json,properties,edmx,xml,env'
-const fioriIncludes = /_?(change|variant)$/ // according to fiori: change,variant,ctrl_variant,ctrl_variant_change,ctrl_variant_management_change.
-const ignore = RegExp(`(node_modules\\${sep}|app(\\${sep}.+)?\\${sep}((webapp|dist|target)\\${sep}|\\.cds-services\\.json$|tsconfig\\.json$|.*\\.tsbuildinfo$))`)
+const ignore = RegExp(`(node_modules\\${sep}|@cds-models\\${sep}|@types\\${sep}|app(\\${sep}.+)?\\${sep}((webapp|dist|target)\\${sep}|\\.cds-services\\.json$|tsconfig\\.json$|.*\\.tsbuildinfo$))`)
 
 async function watch ([cwd], {
   args = ['serve', 'all'],
@@ -88,16 +87,14 @@ async function watch ([cwd], {
   env.NODE_PATH = [...paths(cwd||process.cwd()), ...paths(__dirname)].join(delimiter)
 
   if (typeof ext !== 'string')  ext = extDefaults
+  const delay = parseInt(process.env.CDS_WATCH_DELAY) || 200
 
-  let includes
   let liveReload //= ...
   let firstTime = true
   if (!/false|no/.test(options['livereload']) && cds.env.for('cds', cwd||process.cwd()).livereload !== false) {
-    ext += ',css,gif,html,jpg,png,svg'
-    includes = fioriIncludes
     liveReload = new (require ('../lib/watch/livereload-server'))
     env.CDS_LIVERELOAD_PATH = require.resolve ('../lib/watch/livereload-connect')
-    env.CDS_LIVERELOAD_URL = await liveReload.start (options['livereload'])
+    env.CDS_LIVERELOAD_URL = await liveReload.start (options['livereload'], cwd, delay)
       .catch(err => { console.log(`Error starting live reload: ${err.message}`); liveReload = null })
   }
 
@@ -113,7 +110,6 @@ async function watch ([cwd], {
   log ()
   log (`${t.bold}cds ${args.join(' ')}`)
   DEBUG && log (process.pid, 'watching:', ext, '...')
-  includes && DEBUG && log (`also watching: ${includes.source}`)
   DEBUG && log ('ignoring:', ignore.source)
   if (liveReload) log (`live reload enabled for browsers`)
 
@@ -124,8 +120,8 @@ async function watch ([cwd], {
 
   const nodemon = require('../lib/watch/node-watch')
   const watcher = nodemon ({
-    script: resolve(__dirname,'watched'), cwd, env, ext, includes, ignore,
-    delay: parseInt(process.env.CDS_WATCH_DELAY) || 200,
+    script: resolve(__dirname,'watched'), cwd, env, ext, ignore,
+    delay,
     options
   }).on('restart', (files)=>{
     log (`\n${t.bold}        ___________________________\n`)

package/lib/bind/bindingResolver.js

@@ -1,10 +1,11 @@
 const cds = require('../cds');
+const path = require('path');
 const { platformText, bindingText, logger } = require('./bindingUtil');
 
 class BindingResolver {
     getUnresolvedBindings({ cwd = process.cwd(), env } = {}) {
         if (!env) {
-            env = cds.env.for('cds', cwd) // REVISIT: This might load cds.env too early!
+            env = cds.env.for('cds', path.resolve(cwd)) // REVISIT: This might load cds.env too early!
         }
         const bindings = {}
         const requires = env.requires || {}

package/lib/bind/index.js

@@ -101,7 +101,7 @@ function runCmd(profile, isJavaProject) {
     profile = parseProfile(profile);
     if (isJavaProject) {
         const p = profile === 'hybrid' ? '' : ` --profile ${profile}`;
-        return `cds bind exec${p} mvn spring-boot:run`;
+        return `cds bind --exec${p} mvn spring-boot:run`;
     } else {
         const p = profile === 'development' ? '' : ` --profile ${profile}`;
         return `cds watch${p}`;

package/lib/build/buildPlugin.js

@@ -3,7 +3,7 @@ const fs = require('fs').promises
 const cds = require('../cds')
 
 const { OUTPUT_MODE, OUTPUT_MODE_FILESYSTEM, SEVERITY_INFO, SEVERITY_WARNING, SEVERITY_ERROR } = require('./constants')
-const { hasOptionValue, getProperty, relativePaths, BuildMessage } = require('./util')
+const { hasOptionValue, getProperty, relativePaths, BuildMessage, pathExists } = require('./util')
 
 /**
  * The build plugin creates the build output for a dedicated build task. It is uniquely identified
@@ -27,6 +27,9 @@ class BuildPlugin {
         this._written = new Set()
         this._messages = []
     }
+    static hasTask() {
+        return true
+    }
     static get INFO() {
         return SEVERITY_INFO
     }
@@ -86,7 +89,11 @@ class BuildPlugin {
      * Called by the framework immediately after this instance has been created.
      * The instance has already been fully initialized.
      */
-    init() { }
+    init() {
+        if (cds.env.build.target === '.') {
+            this.task.dest = path.join(this.task.dest, 'gen')
+        }
+    }
 
     /**
      * @abstract
@@ -96,13 +103,21 @@ class BuildPlugin {
     }
 
     /**
-     * @abstract
      * Called by the framework immediately before 'build' to delete any output created by this build plugin.
      * <p>
      * Note: The <code>BuildTaskEngine</code> is cleaning the common generation target folder if the build is
      * executed in staging mode, e.g. build.target: "gen".
      */
     async clean() {
+        function isSubDirectory(parent, child) {
+            return !path.relative(parent, child).startsWith('..')
+        }
+        if (cds.env.build.target === '.'
+            && this.task.src !== this.task.dest
+            && !isSubDirectory(this.task.dest, this.task.src)
+            && await pathExists(this.task.dest)) {
+            return fs.rm(this.task.dest, { force: true, recursive: true })
+        }
     }
 
     /**

package/lib/build/buildTaskEngine.js

@@ -219,7 +219,8 @@ class BuildTaskEngine {
         // log all generated files
         const files = BuildTaskEngine._getOutput(plugins)
         if (files.length > 0) {
-            this.logger.log(`done > wrote output to:\n   ${files.join("\n   ")}\n`)
+            const term = require('../util/term')
+            this.logger.log(`done > wrote output to:\n   ${term.secondary(files.join("\n   "))}\n`)
         }
     }
 

package/lib/build/buildTaskFactory.js

@@ -4,6 +4,7 @@ const cds = require('../cds')
 const BuildTaskProviderFactory = require('./buildTaskProviderFactory')
 const { hasJavaNature, getProperty, redactCredentials, flatten, getDefaultModelOptions } = require('./util')
 const { FILE_EXT_CDS, BUILD_TASK_JAVA_CF, BUILD_TASK_JAVA } = require("./constants")
+const term = require('../util/term')
 
 class BuildTaskFactory {
     constructor(options) {
@@ -27,12 +28,11 @@ class BuildTaskFactory {
         const tasks = await this._createTasks()
 
         // log build tasks
-        this.logger.log(`the following build tasks will be executed`)
-        let tasksOutput = "   {\n     \"build\": {\n       \"target\": \"" + cds.env.build.target + "\",\n       \"tasks\": ["
+        let tasksOutput = "{\n  build: {\n    target: " + term.info("'" + cds.env.build.target + "'") + ",\n    tasks: [\n"
         for (let i = 0; i < tasks.length; i++) {
-            tasksOutput += "\n         " + BuildTaskFactory._stringifyTask(tasks[i]) + (i + 1 < tasks.length ? "," : "")
+            tasksOutput += "      " + BuildTaskFactory._stringifyTask(tasks[i]) + (i + 1 < tasks.length ? ",\n" : "\n")
         }
-        tasksOutput += "\n       ]\n     }\n   }\n"
+        tasksOutput += "    ]\n  }\n}\n"
         this.logger.log(tasksOutput)
 
         // for testing purposes
@@ -196,12 +196,36 @@ class BuildTaskFactory {
     static _stringifyTask(task) {
         // ensures identical order of properties
         const order = ["for", "use", "src", "dest", "options"]
-        const keys = Object.keys(task).sort((a, b) => order.indexOf(a) - order.indexOf(b))
+        const keys = Object.keys(task).filter(key => order.includes(key)).sort((a, b) => order.indexOf(a) - order.indexOf(b))
 
-        return keys.reduce((acc, key, idx) => {
-            // render either "for" OR "use" value
-            return acc + (!key.match("^_") ? (key !== "use" || keys[idx - 1] !== "for" ? (acc !== "{" ? ", " : "") + JSON.stringify(key) + ":" + JSON.stringify(task[key]) : "") : "")
-        }, "{") + "}"
+        return keys.reduce((acc, key, i) => {
+            const prefix = acc !== '{' ? ', ' : (i === 0 ? ' ' : '')
+            if (!key.startsWith('_')) {
+              // render either "for" OR "use" value
+              if (key in { src: 1, for: 1 } || (!task.for && key === 'use')) {
+                return `${acc}${prefix}${key}: ${term.info(`'${task[key]}'`)}`
+              } else if (key === 'options') {
+                const options = Object.entries(task.options)
+                  .map(([key, value]) => {
+                    if (Array.isArray(value)) {
+                      return `${key}: [${value.map(v => term.info(`'${v}'`)).join(', ')}]`
+                    } else if (typeof value === 'object') {
+                      const nested = Object.entries(value)
+                        .map(([key, value]) => `${key}: ${term.info(`'${value}'`)}`)
+                        .join(', ')
+                      return `${key}: { ${nested} }`
+                    } else {
+                      return `${key}: ${term.info(`'${value}'`)}`
+                    }
+                  })
+                  .join(', ')
+                return `${acc}${prefix}${key}: { ${options} }`
+              } else if (key !== 'use') {
+                return `${acc}${prefix}${key}: ${term.info(`'${task[key]}'`)}`
+              }
+            }
+            return acc
+          }, '{') + '}'
     }
 
     static _scanTaskOptionParams(optsParams) {

package/lib/build/buildTaskProvider.js

@@ -14,7 +14,7 @@ module.exports = class BuildTaskProvider {
     /**
      * @param {object} task 
      */
-    loadPlugin(task) { }
+    getPluginClass(task) { }
     /**
      * @param {Array} tasks 
      * @param {boolean} dependencies 

package/lib/build/buildTaskProviderFactory.js

@@ -1,7 +1,7 @@
 const fs = require('fs')
 const path = require('path')
 const cds = require('../cds')
-const { LOG_MODULE_NAMES, OUTPUT_MODE_FILESYSTEM } = require('./constants')
+const { LOG_MODULE_NAMES, OUTPUT_MODE_FILESYSTEM, DEFAULT_SRC_FOLDER } = require('./constants')
 const InternalBuildTaskProvider = require('./provider/internalBuildTaskProvider')
 const BuildTaskProvider = require('./buildTaskProvider')
 const { BuildError } = require('./util')
@@ -74,11 +74,14 @@ class BuildTaskProviderFactory {
      * @param {*} task
      */
     createPlugin(task) {
-        const BuildPluginClass = this.loadPlugin(task)
+        const BuildPluginClass = this.getPluginClass(task)
         const resolvedTask = this._resolveTask(task)
         this.logger._debug && this.logger.debug(`loaded build plugin [${resolvedTask.use}]`)
 
         const plugin = new BuildPluginClass()
+        if (!(plugin instanceof BuildPlugin)) {
+            throw new Error(`Invalid Build plugin type ${task.for}`)
+        }
         plugin._task = resolvedTask
         plugin._logger = this.logger
         plugin._context = this.context
@@ -93,10 +96,10 @@ class BuildTaskProviderFactory {
      * 'use' defines the fully qualified module name of custom build plugins implementations.
      * @param {object} task
      */
-    loadPlugin(task) {
+    getPluginClass(task) {
         const provider = this._getProvider(task)
         try {
-            return provider.loadPlugin(task)
+            return provider.getPluginClass(task)
         } catch (e) {
             this.logger.error(`Provider failed to load build plugin class - provider: ${provider.constructor.name}, task: ${task.for || task.use} :\n` + e)
             throw e
@@ -113,9 +116,6 @@ class BuildTaskProviderFactory {
      * @param {*} task
      */
     _resolveTask(task) {
-        // first validate plugin implementation
-        this.loadPlugin(task)
-
         // second validate src path
         const resolvedTask = JSON.parse(JSON.stringify(task))
 
@@ -181,7 +181,7 @@ class DefaultBuildTaskProvider extends BuildTaskProvider {
         return !!key.use
     }
 
-    loadPlugin(task) {
+    getPluginClass(task) {
         try {
             return require(require.resolve(task.use, { paths: [cds.root] }))
         } catch (e) {
@@ -192,36 +192,14 @@ class DefaultBuildTaskProvider extends BuildTaskProvider {
 
 /**
  * Default provider implementation handling fully qualified custom build task declarations.
- * Has to be the last entry in the providers list. // REVISIT: Above it says DefaultBuildTaskProvider should be last entry? -> clarify
  */
 class PluginBuildTaskProvider extends BuildTaskProvider {
     constructor(logger) {
         super()
         this._logger = logger
-        const plugins = new Map()
-
-        // REVISIT: Remove once fetch mechanism is removed
-        function _local (id) {
-            return require(require.resolve (id, {paths:[
-                process.cwd(), // project-local module is preferred
-                __dirname      // otherwise from our own dependencies
-            ]}))
-        }
-
-        const cdsPlugins = _local('@sap/cds/lib/plugins').fetch?.() // REVISIT: Get rid of fetch mechanism
-        const buildPlugins = cds.env.build.plugins // REVISIT: Compat to old plugin mechanism, remove if possible
-
-        for (const [id, plugin] of Object.entries({ ...cdsPlugins, ...buildPlugins })) {
-            try {
-                const clazz = this._loadPlugin(id, plugin)
-                if (!clazz) continue
-                plugins.set(id, { id: id, impl: plugin.impl, class: clazz })
-            } catch (e) {
-                this._logger.error(`Skipping build plugin '${id}', it cannot be loaded.\n` + e + '\n') // REVISIT: why not throw? seems like an error one should fix, not exit with code 0
-            }
-        }
-        this._plugins = plugins
+        this._plugins = require('./plugins').getPlugins()
     }
+
     get plugins() {
         return this._plugins
     }
@@ -230,8 +208,8 @@ class PluginBuildTaskProvider extends BuildTaskProvider {
         return this.plugins.has(key.for)
     }
 
-    loadPlugin(task) {
-        return this._loadPlugin(task.for, this.plugins.get(task.for))
+    getPluginClass(task) {
+        return this.plugins.get(task.for).class
     }
 
     async lookupTasks(tasks, dependencies) {
@@ -258,35 +236,11 @@ class PluginBuildTaskProvider extends BuildTaskProvider {
     }
 
     getTask(key) {
-        const task = this.plugins.get(key.for).class.getTaskDefaults() ?? key
-        task.src ??= '.'
-        if (task.src) {
-            task.src = task.src.replace(/\/$/, '')
-        }
+        const task = this.plugins.get(key.for).taskDefaults
         task.for = key.for
+        task.src ??= DEFAULT_SRC_FOLDER
+        task.src = task.src.replace(/\/$/, '')
         return task
     }
-
-    _loadPlugin(id, plugin) {
-        let pluginClass
-        try {
-            pluginClass = require(require.resolve(plugin.impl, { paths: [cds.root] }))
-            const inheritsFrom = (child, parent) => {
-                let proto = Object.getPrototypeOf(child)
-                while (proto) {
-                  if (proto === parent) return true
-                  proto = Object.getPrototypeOf(proto)
-                }
-                return false
-            }
-            if (!inheritsFrom(pluginClass, BuildPlugin)) return // REVISIT: better way to check if plugin is build-enabled than traversing prototype chain?
-        } catch (e) {
-            throw new Error(`Custom build plugin implementation '${plugin.impl}' for '${id}' cannot be loaded:\n` + e)
-        }
-        if (!pluginClass.hasTask || !pluginClass.getTaskDefaults) {
-            throw new Error(`Custom build plugin '${id}' must implement 'hasTask' and 'getTaskDefaults' methods`)
-        }
-        return pluginClass
-    }
 }
 module.exports = BuildTaskProviderFactory

package/lib/build/constants.js

@@ -3,6 +3,7 @@ exports.OUTPUT_MODE_NONE = 0x0
 exports.OUTPUT_MODE_FILESYSTEM = 0x1
 exports.OUTPUT_MODE_RESULT = 0x2
 
+exports.DEFAULT_SRC_FOLDER = '.'
 exports.BUILD_TASK_NPM_SCOPE = "@sap"
 exports.BUILD_TASK_PREFIX = exports.BUILD_TASK_NPM_SCOPE + "/cds/build"
 exports.BUILD_TASK_JAVA = "java"
@@ -23,6 +24,7 @@ exports.CONTENT_LANGUAGE_BUNDLES = "contentLanguageBundles"     // create i18n.j
 exports.CONTENT_DEFAULT_CSN = "contentDefaultCsn"               // create default CSN format flavor: "inferred"
 exports.FLAVOR_LOCALIZED_EDMX = "flavorLocalizedEdmx"           // create localized EDMX languages based on existing properties files
 exports.CONTENT_EDMX = "contentEdmx"                            // create EDMX for required languages - ENABLED by default
+exports.CONTENT_LOCALIZED_EDMX = "contentLocalizedEdmx"         // create EDMX for required languages - ENABLED for Java by default
 exports.CONTENT_PACKAGE_JSON = "contentPackageJson"             // create package.json file if not existing, or modify existing package.json - ENABLED by default
 exports.CONTENT_PACKAGELOCK_JSON = "contentPackageLockJson"     // copy package-lock.json file if existing into deployment folder - ENABLED by default
 exports.CONTENT_HDBTABLEDATA = "contentHdbtabledata"            // create .hdbtabledata files for .csv files if not existing - ENABLED by default

package/lib/build/index.js

@@ -1,11 +1,10 @@
 const fs = require('fs')
 const cds = require('../cds')
 const BuildTaskEngine = require('./buildTaskEngine')
-const BuildTaskFactory = require('./buildTaskFactory')
 const BuildPlugin = require('./buildPlugin')
 const { BuildError } = require('./util')
 
-module.exports = { build, BuildTaskFactory, BuildTaskEngine, BuildPlugin, BuildError }
+module.exports = { build, register, BuildPlugin }
 
 /**
  * Executes cds build in the directory defined by cds.root.
@@ -28,4 +27,8 @@ async function build(options = {}) {
         }
         throw e
     }
+}
+
+function register(id, options) {
+    return require('./plugins').register(id, options)
 }

package/lib/build/plugins.js

@@ -0,0 +1,35 @@
+const cds = require('../cds')
+
+module.exports = new (class BuildPlugins {
+    constructor() {
+        this._plugins = new Map()
+    }
+    getPlugins() {
+        return this._plugins
+    }
+    getPlugin(id) {
+        return this._plugins.get(id)
+    }
+    register(id, options) {
+        if (!id || !options?.impl) {
+            throw Error("Invalid build plugin parameter")
+        }
+        if (this._plugins.has(id)) {
+            throw Error(`Build plugin ${id} already registered`)
+        }
+        this._plugins.set(id, {
+            id,
+            class: this._loadPlugin(id, options.impl),
+            description: options.description,
+            taskDefaults: options.taskDefaults ?? {}
+        })
+    }
+    _loadPlugin(id, impl) {
+        try {
+            // project-local module is preferred - otherwise from our own dependencies
+            return require(require.resolve(impl, { paths: [cds.root, __dirname] })) 
+        } catch (e) {
+            throw new Error(`Custom build plugin implementation '${impl}' for '${id}' cannot be loaded:\n` + e)
+        }
+    }
+})