@sap/cds-dk 6.7.1 → 6.8.0

package/lib/init/constants.js

@@ -1,6 +1,6 @@
 const os = require('os');
 
-const MAVEN_ARCHETYPE_VERSION = '1.33.1';
+const MAVEN_ARCHETYPE_VERSION = '1.34.0';
 
 const constants = {
     IS_WIN: (os.platform() === 'win32'),
@@ -13,6 +13,7 @@ const constants = {
     OPTION_NODEJS: 'nodejs',
     OPTION_JAVA: 'java',
     OPTION_HANA: 'hana',
+    OPTION_SQLITE: 'sqlite',
     OPTION_XSUAA: 'xsuaa',
     OPTION_DESTINATIONS: 'destinations',
     OPTION_MTA: 'mta',
@@ -22,6 +23,9 @@ const constants = {
     OPTION_EXTENSIBILITY: 'extensibility',
     OPTION_AUDITLOG: 'auditlog',
     OPTION_ENTERPRISE_MESSAGING: 'enterprise-messaging',
+    OPTION_ENTERPRISE_MESSAGING_SHARED: 'enterprise-messaging-shared',
+    OPTION_FILE_BASED_MESSAGING: 'file-based-messaging',
+    OPTION_REDIS_MESSAGING: 'redis-messaging',
     OPTION_APPROUTER: 'approuter',
     OPTION_KIBANA_LOGGING: 'kibana-logging',
     OPTION_CF_MANIFEST: 'cf-manifest',
@@ -36,10 +40,9 @@ const constants = {
     OPTION_JAVA_MVN: 'java:mvn',
     OPTION_HELM: 'helm',
 
-    // node enum
     PROJECT_TYPE: Object.freeze({ nodejs: 1, java: 2, unknown: 3 }),
 
-    PYTHON_VENV_NAME: ".cap-jupyter-nb",
+    PYTHON_VENV_NAME: '.cap-jupyter-nb',
 
     REGEX_JAVA_PACKAGE: /^[a-z_][a-z0-9_]*(\.[a-z_][a-z0-9_]*)*$/g,
     REGEX_PROJECT_NAME: /[^0-9a-zA-Z_-]/g,
@@ -78,8 +81,12 @@ constants.OPTIONS_PRIORITY = [
     constants.OPTION_EXTENSIBILITY,
     constants.OPTION_XSUAA,
     constants.OPTION_HANA,
+    constants.OPTION_SQLITE,
     constants.OPTION_AUDITLOG,
     constants.OPTION_ENTERPRISE_MESSAGING,
+    constants.OPTION_ENTERPRISE_MESSAGING_SHARED,
+    constants.OPTION_FILE_BASED_MESSAGING,
+    constants.OPTION_REDIS_MESSAGING,
     constants.OPTION_APPROUTER,
     constants.OPTION_DESTINATIONS,
     constants.OPTION_SAMPLES,

package/lib/init/template/_merging/registry-mta.js

@@ -1,6 +1,6 @@
 // Registry of sequence matchers in mta.yaml files
 
-const srvNode = path => ({
+const srvNode4 = path => ({
     in: 'modules',
     where: [{
         property: 'type',
@@ -11,7 +11,7 @@ const srvNode = path => ({
     }],
 })
 
-const srvJava = path => ({
+const srvJava4 = path => ({
     in: 'modules',
     where: [{
         property: 'type',
@@ -55,6 +55,17 @@ const auditlog = {
     }]
 }
 
+const redis = {
+    in: 'resources',
+    where: [{
+        property: 'type',
+        isEqualTo: 'org.cloudfoundry.managed-service',
+    }, {
+        property: 'parameters.service',
+        isEqualTo: 'redis-cache',
+    }]
+}
+
 const enterpriseMessaging = {
     in: 'resources',
     where: [{
@@ -121,7 +132,7 @@ const saasRegistry = {
     }]
 }
 
-const srvAPI = srv => ({
+const srvApi4 = srv => ({
     in: [srv, 'provides'],
     where: [{
         property: 'name',
@@ -143,7 +154,7 @@ const mtxSidecar4 = path => ({
     }]
 })
 
-const providedMtxAPISidecar4 = mtxSidecar => ({
+const providedMtxApiSidecar4 = mtxSidecar => ({
     in: [mtxSidecar, 'provides'],
     where: [{
         property: 'name',
@@ -154,7 +165,7 @@ const providedMtxAPISidecar4 = mtxSidecar => ({
     }]
 })
 
-const requiredMtxAPI = {
+const requiredMtxApi = {
     in: [approuter, 'requires'],
     where: [{
         property: 'properties.name',
@@ -165,7 +176,7 @@ const requiredMtxAPI = {
     }]
 }
 
-const providedAppAPI = {
+const providedAppApi = {
     in: [approuter, 'provides'],
     where: [{
         property: 'name',
@@ -179,7 +190,7 @@ const providedAppAPI = {
     }],
 }
 
-const requiredAppAPI = module => ({
+const requiredAppApi4 = module => ({
     in: [module, 'requires'],
     where: [{
         property: 'name',
@@ -190,7 +201,7 @@ const requiredAppAPI = module => ({
     }]
 })
 
-const requiredMtxSidecarAPI = srv => ({
+const requiredMtxSidecarApi4 = srv => ({
     in: [srv, 'requires'],
     where: [{
         property: 'properties.CDS_MULTITENANCY_SIDECAR_URL',
@@ -198,7 +209,7 @@ const requiredMtxSidecarAPI = srv => ({
     }]
 })
 
-const requiredJavaApprouterAPI = srv => ({
+const providedJavaApprouterApi4 = srv => ({
     in: [srv, 'requires'],
     where: [{
         property: 'properties.CDS_MULTITENANCY_APPUI_URL',
@@ -206,7 +217,7 @@ const requiredJavaApprouterAPI = srv => ({
     }]
 })
 
-const providedJavaApprouterAPI = {
+const providedJavaApprouterApi = {
     in: [approuter, 'requires'],
     where: [{
         property: 'properties.url',
@@ -228,23 +239,9 @@ const approuterExtensibility = {
     }]
 }
 
-const approuterExtensibilityJava = {
-    in: 'routes',
-    where: [{
-        property: 'source',
-        isEqualTo: '^/-/cds/.*'
-    }, {
-        property: 'destination',
-        isEqualTo: 'mtx-api',
-    }, {
-        property: 'authenticationType',
-        isEqualTo: 'none',
-    }]
-}
-
 module.exports = {
-    srvNode,
-    srvJava,
+    srvNode4,
+    srvJava4,
     approuter,
     xsuaa,
     auditlog,
@@ -253,16 +250,16 @@ module.exports = {
     hdiContainer,
     serviceManager,
     saasRegistry,
-    srvAPI,
+    redis,
+    srvApi4,
     mtxSidecar4,
-    providedMtxAPISidecar4,
-    requiredMtxAPI,
-    requiredMtxSidecarAPI,
-    providedAppAPI,
-    requiredAppAPI,
-    requiredJavaApprouterAPI,
-    providedJavaApprouterAPI,
+    providedMtxApiSidecar4,
+    requiredMtxApi,
+    requiredMtxSidecarApi4,
+    providedAppApi,
+    requiredAppApi4,
+    providedJavaApprouterApi4,
+    providedJavaApprouterApi,
     kibanaLogging,
-    approuterExtensibility,
-    approuterExtensibilityJava
+    approuterExtensibility
 }

package/lib/init/template/approuter/files/mtxs-configmap-java.yaml

@@ -0,0 +1,20 @@
+# Please do not modify this file. This file may be overwritten.
+
+{{- $approuterDeployment := .Values.approuter }}
+{{- $ := merge (dict "name" "approuter" "deployment" .Values.approuter ) . }}
+{{- $approuterUrl := (include "cap.deploymentHostFull" $ )}}
+
+{{- $sidecarDeployment := .Values.sidecar }}
+{{- $ = merge (dict "name" "sidecar" "deployment" .Values.sidecar ) . }}
+{{- $sidecarUrl := (include "cap.deploymentHostFull" $ )}}
+
+apiVersion: v1
+kind: ConfigMap
+metadata:
+  name: "{{ .Release.Name }}-mtxs-configmap"
+  namespace: "{{ .Release.Namespace }}"
+data:
+  CDS_MULTITENANCY_APPUI_TENANTSEPARATOR: "-"
+  CDS_MULTITENANCY_APPUI_URL: {{ printf "https://%s" $approuterUrl }}
+  CDS_MULTITENANCY_MTXS_ENABLED: "true"
+  CDS_MULTITENANCY_SIDECAR_URL: {{ printf "https://%s" $sidecarUrl }}

package/lib/init/template/approuter/files/mtxs-configmap-nodejs.yaml

@@ -0,0 +1,12 @@
+# Please do not modify this file. This file may be overwritten.
+
+{{- $ := merge (dict "name" "approuter" "deployment" .Values.approuter ) . }}
+{{- $approuterUrl := (include "cap.deploymentHostFull" $ )}}
+
+apiVersion: v1
+kind: ConfigMap
+metadata:
+  name: "{{ .Release.Name }}-mtxs-configmap"
+  namespace: "{{ .Release.Namespace }}"
+data:
+  SUBSCRIPTION_URL: {{ printf "https://${tenant_subdomain}-%s" $approuterUrl }}

package/lib/init/template/approuter/index.js

@@ -1,20 +1,22 @@
+const cds = require('../../../cds')
+const { exists } = cds.utils
 const { join } = require('path')
 const { readProject } = require('../../util/projectReader')
 const { mergeJSON, mergeYAML, sortDependencies } = require('../../util/merge')
-const { OPTION_XSUAA, PROJECT_TYPE } = require('../../constants')
+const { OPTION_XSUAA } = require('../../constants')
 const {
-    srvNode, srvJava, mtxSidecar4, approuter, // Modules
+    srvNode4, srvJava4, mtxSidecar4, approuter, // Modules
     xsuaa, // BTP Services
-    requiredMtxAPI, requiredJavaApprouterAPI, providedJavaApprouterAPI, // APIs
-    requiredAppAPI, providedAppAPI,
-    approuterExtensibility, approuterExtensibilityJava // xs-app.json config
+    requiredMtxApi, providedJavaApprouterApi4, providedJavaApprouterApi, // APIs
+    requiredAppApi4, providedAppApi,
+    approuterExtensibility // xs-app.json config
 } = require('../_merging/registry-mta')
-const { copyAndTrack, parseMd5File, writeMd5File } = require('../../util/md5Tracking')
+const { copyAndTrack, parseMd5File, writeMd5File } = require('../../util/md5')
 
 module.exports = class ApprouterTemplate extends require('../templateBase') {
 
     static hasFacet(env) {
-        return !!env.requires?.approuter
+        return exists(join(env.folders.app, 'xs-app.json'))
     }
 
     getDependencies() {
@@ -23,31 +25,11 @@ module.exports = class ApprouterTemplate extends require('../templateBase') {
 
     async run() {
         const projectDescriptor = await readProject(this.options)
-        const { for: forProfile } = projectDescriptor.cap
         const appPath = projectDescriptor.ui.appPath ?? 'app'
         const appPackageJSONPath = join(appPath, 'package.json')
-
         await mergeJSON(appPackageJSONPath, join(__dirname, 'files', 'package.json'))
         await sortDependencies(appPackageJSONPath)
-
         await mergeJSON(join(appPath, 'default-env.json'), join(__dirname, 'files', 'default-env.json'))
-
-        const projectType = this.getProjectType()
-        switch (projectType) {
-            case PROJECT_TYPE.java: {
-                const cdsTemplateFile = forProfile ? 'cds.cdsrc.json.hbs' : 'cds.cdsrc.json'
-                const cdsPackageJSONPath = join(__dirname, 'files', cdsTemplateFile)
-                await mergeJSON('.cdsrc.json', cdsPackageJSONPath, projectDescriptor)
-                break
-            }
-            case PROJECT_TYPE.nodejs: {
-                const cdsTemplateFile = forProfile ? 'cds.package.json.hbs' : 'cds.package.json'
-                const cdsPackageJSONPath = join(__dirname, 'files', cdsTemplateFile)
-                await mergeJSON('package.json', cdsPackageJSONPath, projectDescriptor)
-                break
-            }
-        }
-
         await this.runDependentMerging()
     }
 
@@ -56,11 +38,11 @@ module.exports = class ApprouterTemplate extends require('../templateBase') {
         const { isNodejs, isJava, isExtensible, isMultitenant, hasMta, hasHelm, srvPath } = projectDescriptor.cap
 
         if (hasMta) {
-            const srv = (isNodejs ? srvNode : srvJava)(srvPath)
-            const apis = isJava ? [requiredJavaApprouterAPI(srv), providedJavaApprouterAPI] : []
+            const srv = (isNodejs ? srvNode4 : srvJava4)(srvPath)
+            const apis = isJava ? [providedJavaApprouterApi4(srv), providedJavaApprouterApi] : []
             const mtxSidecar = mtxSidecar4(isJava ? 'mtx/sidecar' : 'gen/mtx/sidecar')
-            if (isNodejs && isMultitenant) apis.push(requiredMtxAPI, requiredAppAPI(mtxSidecar), providedAppAPI)
-            if (isJava && isMultitenant) apis.push(requiredMtxAPI)
+            if (isNodejs && isMultitenant) apis.push(requiredMtxApi, requiredAppApi4(mtxSidecar), providedAppApi)
+            if (isJava && isMultitenant) apis.push(requiredMtxApi)
             const modules = [srv, approuter]
             if (isMultitenant) modules.push(mtxSidecar)
             const additions = [...modules, xsuaa, ...apis]
@@ -119,12 +101,21 @@ module.exports = class ApprouterTemplate extends require('../templateBase') {
                 { force: true }
             )
 
+            if(isMultitenant) {
+                const mtxsConfigMapFileName = isNodejs ? 'mtxs-configmap-nodejs.yaml' : 'mtxs-configmap-java.yaml';
+                await copyAndTrack(
+                    join(__dirname, 'files', mtxsConfigMapFileName),
+                    join('chart', 'templates', 'mtxs-configmap.yaml'),
+                    context,
+                    { force: true }
+                )
+            }
+
             if (isIndependentCommand) await writeMd5File(join('chart', '.cds-add-helm-files.md5'), context.newTrackingData);
         }
 
         const xsAppPath = join(projectDescriptor.ui.appPath ?? 'app', 'xs-app.json')
-        const additions = isExtensible && isJava ? [{ ...approuterExtensibilityJava, at: 0 }] :
-                          isExtensible && isNodejs ? [{ ...approuterExtensibility, at: 0 }] : []
+        const additions = isExtensible ? [{ ...approuterExtensibility, at: 0 }] : []
         await mergeJSON(xsAppPath, join(__dirname, 'files', 'xs-app.json.hbs'), projectDescriptor, { additions })
     }
 }

package/lib/init/template/auditlog/files/package.json.hbs

@@ -0,0 +1,27 @@
+{
+  {{#cap.isNodejs}}
+  "dependencies": {
+      "@sap/audit-logging": "^5"
+  },
+  "cds": {
+  {{/cap.isNodejs}}
+    "requires": {
+      {{#cap.for}}
+      "[{{cap.for}}]": {
+      {{/cap.for}}
+      {{#cap.shortcut}}
+        "audit-log": "service"
+      {{/cap.shortcut}}
+      {{^cap.shortcut}}
+        "audit-log": {
+          "kind": "service"
+        }
+      {{/cap.shortcut}}
+      {{#cap.for}}
+      }
+      {{/cap.for}}
+    }
+  {{#cap.isNodejs}}
+  }
+  {{/cap.isNodejs}}
+}

package/lib/init/template/auditlog/index.js

@@ -1,16 +1,22 @@
+const cds = require('../../../cds')
+const { read } = cds.utils
 const { join } = require('path')
 const { readProject } = require('../../util/projectReader')
-const { mergeYAML } = require('../../util/merge')
-const { parseMd5File, writeMd5File } = require('../../util/md5Tracking')
-const { srvNode, srvJava, auditlog } = require('../_merging/registry-mta')
+const { mergeJSON, mergeYAML } = require('../../util/merge')
+const { parseMd5File, writeMd5File } = require('../../util/md5')
+const { srvNode4, srvJava4, auditlog } = require('../_merging/registry-mta')
 
 module.exports = class AuditlogTemplate extends require('../templateBase') {
 
-    static hasFacet() {
-        return false // TODO: Need a `cds.requires.auditlog` or some other way to detect if enabled.
+    static hasFacet(env) {
+        return env.requires?.['audit-log']
     }
 
     async run() {
+        const projectDescriptor = await readProject(this.options)
+        const { configFile } = projectDescriptor.cap
+        projectDescriptor.cap.shortcut = !(await read(configFile)).cds?.requires?.['audit-log']?.kind
+        await mergeJSON(configFile, join(__dirname, 'files', 'package.json.hbs'), projectDescriptor)
         await this.runDependentMerging()
     }
 
@@ -19,7 +25,7 @@ module.exports = class AuditlogTemplate extends require('../templateBase') {
         const { isNodejs, hasMta, hasHelm, srvPath } = projectDescriptor.cap
 
         if (hasMta) {
-            const srv = (isNodejs ? srvNode : srvJava)(srvPath)
+            const srv = (isNodejs ? srvNode4 : srvJava4)(srvPath)
             await mergeYAML(
                 'mta.yaml',
                 join(__dirname, 'files', 'mta.yaml.hbs'),

package/lib/init/template/cf-manifest/index.js

@@ -2,7 +2,7 @@ const { join } = require('path')
 const cds = require('../../../cds')
 const { exists } = require('../../../cds').utils
 const { readProject } = require('../../util/projectReader')
-const { copyFiles } = require('../../util/templateUtil')
+const { copyFiles } = require('../../util/template')
 const MANIFEST_FILE = 'manifest.yml'
 const SERVICES_MANIFEST_FILE = 'services-manifest.yml'
 

package/lib/init/template/connectivity/index.js

@@ -1,7 +1,7 @@
 const { join } = require('path')
 const { readProject } = require('../../util/projectReader')
 const { mergeYAML } = require('../../util/merge')
-const { copyAndTrack, parseMd5File, writeMd5File } = require('../../util/md5Tracking')
+const { copyAndTrack, parseMd5File, writeMd5File } = require('../../util/md5')
 
 module.exports = class ConnectivityTemplate extends require('../templateBase') {
 

package/lib/init/template/destinations/index.js

@@ -1,7 +1,7 @@
 const { join } = require('path')
 const { readProject } = require('../../util/projectReader')
 const { mergeYAML } = require('../../util/merge')
-const { parseMd5File, writeMd5File } = require('../../util/md5Tracking')
+const { parseMd5File, writeMd5File } = require('../../util/md5')
 
 module.exports = class DestinationsTemplate extends require('../templateBase') {
 
@@ -16,7 +16,9 @@ module.exports = class DestinationsTemplate extends require('../templateBase') {
 
     static hasFacet(env) {
         const kinds = { odata: 1, 'odata-v2': 1, 'odata-v4': 1, rest: 1 }
-        return Object.entries(env.requires).some(([service, require]) => !kinds[service] && kinds[require.kind])
+        const mtxServices = { 'cds.xt.SaasProvisioningService': 1, 'cds.xt.DeploymentService': 1, 'cds.xt.ModelProviderService': 1, 'cds.xt.ExtensibilityService': 1 }
+        const _fromMtx = service => service in mtxServices
+        return Object.entries(env.requires).some(([service, require]) => !_fromMtx(service) && !kinds[service] && kinds[require.kind])
     }
 
     async run() {

package/lib/init/template/enterprise-messaging/files/package.json.hbs

@@ -0,0 +1,19 @@
+{
+  {{#cap.isNodejs}}
+  "cds": {
+  {{/cap.isNodejs}}
+    "requires": {
+      {{#cap.for}}
+      "[{{cap.for}}]": {
+      {{/cap.for}}
+        "messaging": {
+          "kind": "enterprise-messaging"
+        }
+      {{#cap.for}}
+      }
+      {{/cap.for}}
+    }
+  {{#cap.isNodejs}}
+  }
+  {{/cap.isNodejs}}
+}

package/lib/init/template/enterprise-messaging/index.js

@@ -1,11 +1,19 @@
 const { join } = require('path')
+const cds = require('../../../cds')
+const { read } = cds.utils
 const { readProject } = require('../../util/projectReader')
 const { mergeJSON, mergeYAML } = require('../../util/merge')
-const { parseMd5File, writeMd5File } = require('../../util/md5Tracking')
-const { srvNode, srvJava, enterpriseMessaging } = require('../_merging/registry-mta')
+const { parseMd5File, writeMd5File } = require('../../util/md5')
+const { srvNode4, srvJava4, enterpriseMessaging } = require('../_merging/registry-mta')
 
 module.exports = class EnterpriseMessagingTemplate extends require('../templateBase') {
 
+  async canRun() {
+    const projectDescriptor = await readProject(this.options)
+    const { isJava } = projectDescriptor.cap
+    if (isJava) throw `'cds add enterprise-messaging' is not available for Java yet`
+    return true
+  }
 
   static hasFacet(env) {
     return env.requires?.messaging?.kind === 'enterprise-messaging-http'
@@ -13,12 +21,9 @@ module.exports = class EnterpriseMessagingTemplate extends require('../templateB
 
   async run() {
     const projectDescriptor = await readProject(this.options)
-    const { for: forProfile, isNodejs } = projectDescriptor.cap
-    const templatePath = join(__dirname, 'files')
-    const cdsTemplateFile = (isNodejs ? 'cds.package.json' : 'cdsrc.json') + (forProfile ? '.hbs' : '')
-    const cdsTemplatePath = join(templatePath, cdsTemplateFile)
-    const configPath = isNodejs ? 'package.json' : '.cdsrc.json'
-    await mergeJSON(configPath, cdsTemplatePath, projectDescriptor)
+    const { configFile } = projectDescriptor.cap
+    projectDescriptor.cap.shortcut = !(await read(configFile)).cds?.requires?.messaging?.kind
+    await mergeJSON(configFile, join(__dirname, 'files', 'package.json.hbs'), projectDescriptor)
     await mergeJSON('event-mesh.json', join(__dirname, 'files', 'event-mesh.json.hbs'), projectDescriptor)
     await this.runDependentMerging()
   }
@@ -28,7 +33,7 @@ module.exports = class EnterpriseMessagingTemplate extends require('../templateB
     const { hasHelm, hasMta, isNodejs, srvPath } = projectDescriptor.cap
 
     if (hasMta) {
-      const srv = (isNodejs ? srvNode : srvJava)(srvPath)
+      const srv = (isNodejs ? srvNode4 : srvJava4)(srvPath)
       await mergeYAML(
           'mta.yaml',
           join(__dirname, 'files', 'mta.yaml.hbs'),
@@ -51,10 +56,7 @@ module.exports = class EnterpriseMessagingTemplate extends require('../templateB
           context.oldTrackingData = context.newTrackingData = await parseMd5File(join('chart', '.cds-add-helm-files.md5'))
       }
 
-      await mergeYAML(
-        join('chart', 'values.yaml'),
-        join(__dirname, 'files', 'values.yaml')
-      )
+      await mergeYAML(join('chart', 'values.yaml'), join(__dirname, 'files', 'values.yaml'))
 
       // copy service instance chart if it is not present
       const HelmTemplate = require(`../helm`);

package/lib/init/template/enterprise-messaging-shared/files/event-mesh.json.hbs

@@ -0,0 +1,31 @@
+{
+  "emname": "{{cap.appName}}-emname",
+  "version": "1.1.0",
+  "namespace": "default/sap.myapp/1",
+  "options": {
+    "management": true,
+    "messagingrest": true,
+    "messaging": true
+  },
+  "rules": {
+    "topicRules": {
+      "publishFilter": [
+        "${namespace}/sample"
+      ],
+      "subscribeFilter": [
+        "*"
+      ]
+    },
+    "queueRules": {
+      "publishFilter": [
+          "${namespace}/*"
+      ],
+      "subscribeFilter": [
+          "${namespace}/*"
+      ]
+    }
+  },
+  "authorities": [
+    "$ACCEPT_GRANTED_AUTHORITIES"
+  ]
+}

package/lib/init/template/enterprise-messaging-shared/files/mta.yaml.hbs

@@ -0,0 +1,15 @@
+---
+modules:
+ - name: {{cap.appName}}-srv
+   type: {{cap.language}}
+   path: {{& cap.srvPath}}
+   requires:
+    - name: {{cap.appName}}-messaging
+
+resources:
+  - name: {{cap.appName}}-messaging
+    type: org.cloudfoundry.managed-service
+    parameters:
+      service: enterprise-messaging
+      service-plan: default
+      path: ./event-mesh.json

package/lib/init/template/enterprise-messaging-shared/files/package.json.hbs

@@ -0,0 +1,22 @@
+{
+  {{#cap.isNodejs}}
+  "dependencies": {
+    "@sap/xb-msg-amqp-v100": "^0"
+  },
+  "cds": {
+  {{/cap.isNodejs}}
+    "requires": {
+      {{#cap.for}}
+      "[{{cap.for}}]": {
+      {{/cap.for}}
+        "messaging": {
+          "kind": "enterprise-messaging-shared"
+        }
+      {{#cap.for}}
+      }
+      {{/cap.for}}
+    }
+  {{#cap.isNodejs}}
+  }
+  {{/cap.isNodejs}}
+}

package/lib/init/template/enterprise-messaging-shared/files/values.yaml

@@ -0,0 +1,7 @@
+srv:
+  bindings:
+    messaging:
+      serviceInstanceName: event-mesh
+event-mesh:
+  serviceOfferingName: enterprise-messaging
+  servicePlanName: default

package/lib/init/template/enterprise-messaging-shared/index.js

@@ -0,0 +1,51 @@
+const { join } = require('path')
+const cds = require('../../../cds')
+const { read } = cds.utils
+const { readProject } = require('../../util/projectReader')
+const { mergeJSON, mergeYAML } = require('../../util/merge')
+const { srvNode4, srvJava4, enterpriseMessaging } = require('../_merging/registry-mta')
+
+module.exports = class EnterpriseMessagingSharedTemplate extends require('../templateBase') {
+
+  async canRun() {
+    const projectDescriptor = await readProject(this.options)
+    const { hasMta, hasHelm, isJava } = projectDescriptor.cap
+    if (isJava)             throw `'cds add enterprise-messaging-shared' is not available for Java yet`
+    if (hasHelm && !hasMta) throw `'cds add enterprise-messaging-shared' is not available for Kyma yet`
+    return true
+  }
+
+  static hasFacet(env) {
+    return env.requires?.messaging?.kind === 'enterprise-messaging-shared'
+  }
+
+  async run() {
+    const projectDescriptor = await readProject(this.options)
+    const { configFile } = projectDescriptor.cap
+    projectDescriptor.cap.shortcut = !(await read(configFile)).cds?.requires?.messaging?.kind
+    await mergeJSON(configFile, join(__dirname, 'files', 'package.json.hbs'), projectDescriptor)
+    await mergeJSON('event-mesh.json', join(__dirname, 'files', 'event-mesh.json.hbs'), projectDescriptor)
+    await this.runDependentMerging()
+  }
+
+  async runDependentMerging() {
+    const projectDescriptor = await readProject(this.options)
+    const { hasMta, isNodejs, srvPath } = projectDescriptor.cap
+
+    if (hasMta) {
+      const srv = (isNodejs ? srvNode4 : srvJava4)(srvPath)
+      await mergeYAML(
+          'mta.yaml',
+          join(__dirname, 'files', 'mta.yaml.hbs'),
+          projectDescriptor,
+          {
+              additions: [srv, enterpriseMessaging],
+              relationships: [{
+                  insert: [enterpriseMessaging, 'name'],
+                  into: [srv, 'requires', 'name']
+              }]
+          }
+      )
+    }
+  }
+}