Release March 2025 (#1755)

Author: renejeglinsky

.devcontainer/devcontainer.json

@@ -1,11 +1,15 @@
 {
-    "image":"mcr.microsoft.com/devcontainers/universal:2",
+    "image":"mcr.microsoft.com/vscode/devcontainers/javascript-node:22",
     "customizations": {
         "vscode": {
             "extensions": [
                 "fcrespo82.markdown-table-formatter",
                 "vue.volar"
             ]
         }
-    }
+    },
+    "runArgs": [
+        // disable IPv6, see https://github.com/vitejs/vite/issues/16522
+        "--sysctl", "net.ipv6.conf.all.disable_ipv6=1"
+    ]
 }

.github/etc/create-review.cjs

@@ -71,7 +71,7 @@ module.exports = async ({ github, require, exec, core }) => {
     const diffs = {}
     data.filter(obj => extname(obj.filename) === '.md')
         .forEach(obj => {
-            diffs[obj.filename.replace('./', '')] = obj.patch.split('\n')
+            diffs[obj.filename.replace('./', '')] = obj.patch?.split('\n') ?? []
         })
 
     if (existsSync(markdownlintLogFile)) {

.vitepress/config.js

@@ -5,6 +5,9 @@ const base =  process.env.GH_BASE || '/docs/'
 import { defineConfig } from 'vitepress'
 import languages from './languages'
 import path from 'node:path'
+import { Menu } from './menu.js'
+
+const menu = await Menu.from ('./menu.md')
 
 const config = defineConfig({
 
@@ -35,6 +38,8 @@ const config = defineConfig({
   },
 
   themeConfig: {
+    sidebar: menu.items,
+    nav: menu.navbar,
     logo: '/cap-logo.svg',
     outline: [2,3],
     socialLinks: [
@@ -101,8 +106,8 @@ config.rewrites = rewrites
 // Add custom capire info to the theme config
 config.themeConfig.capire = {
   versions: {
-    java_services: '3.8.0',
-    java_cds4j: '3.8.0'
+    java_services: '3.9.0',
+    java_cds4j: '3.9.0'
   },
   gotoLinks: [],
   maven_host_base: 'https://repo1.maven.org/maven2'

.vitepress/theme/components/ConfigInspect.vue

@@ -83,7 +83,7 @@
   const slots = useSlots()
   const slotVal = slots.default?.().at(0)?.children?.toString().trim() ?? 'error: provide <Config>your_key:value</Config>'
 
-  const [key, val] = slotVal.split(/\s*[:=]\s*/)
+  const [key, val] = slotVal.split(/\s*[:=]\s*(.*)/) // split on first `:` or `=`
   const label = labelProp || `${keyOnly ? key: slotVal}`
 
   const cfgKey = ref()
@@ -117,7 +117,7 @@
     const pkg = toJson(key, jsonVal ?? value)
 
     pkgStr.value = JSON.stringify(pkg, null, 2)
-    rcJsonStr.value = JSON.stringify(pkg.cds, null, 2)
+    rcJsonStr.value = JSON.stringify(pkg.cds??{}, null, 2)
     rcJsStr.value = 'module.exports = ' + rcJsonStr.value.replace(/"(\w*?)":/g, '$1:')
     rcYmlStr.value = yaml.stringify(pkg.cds)
     propStr.value = `${key}=${jsonVal ? JSON.stringify(jsonVal) : value}`

.vitepress/theme/styles.scss

@@ -57,7 +57,8 @@
     --vp-c-text-1: rgba(255, 255, 245, 0.86);
 
     /* brightness fine-tuned to turn #fff into --vp-c-bg */
-    img, svg.adapt-dark {
+    img, svg.adapt-dark,
+    video.bright { // assuming videos are usually dark, only darken them if marked as bright
       filter: brightness(.884) invert(1) hue-rotate(177deg)
     }
     img.mute-dark {

CONTRIBUTING.md

@@ -26,7 +26,7 @@ npm run docs:dev
 
 Which usually starts a dev server on http://localhost:5173/ like this:
 
-```
+```sh
   vitepress v1.0.0...
 
   ➜  Local:   http://localhost:5173/

README.md

@@ -35,7 +35,7 @@ npm run start
 ```
 
 This will respond with:
-```
+```sh
   vitepress v1...
 
   ➜  Local:   http://localhost:5173/docs/

about/best-practices.md

@@ -928,7 +928,7 @@ Whenever you have to integrate external services, you should follow the Calesi p
        requires: {
          'audit-log': {
            "[development]": { impl: ".../audit-log-mock.js" },
-           "[production]":  { impl: ".../the-reasl-audit-log-srv.js" },
+           "[production]":  { impl: ".../the-real-audit-log-srv.js" },
          }
        }
      }

about/features.md

@@ -178,15 +178,15 @@ Following is an index of the features currently covered by CAP, with status and
 
 ### Events / Messaging
 
-|                                                                                                                                                             |  CDS  |   Node.js    | Java |
-|-------------------------------------------------------------------------------------------------------------------------------------------------------------|:-----:|:------------:|:----:|
-| [Declared Events in CDS](../cds/cdl#events)                                                                                                                 | <X/>  |     <X/>     | <X/> |
-| Mock Broker (to speed up local dev) [[Node.js](../node.js/messaging#file-based)\|[Java](../java/messaging#local-testing)]                                   | <Na/> |     <X/>     | <X/> |
-| SAP Event Mesh (For single-tenant apps) [[Node.js](../node.js/messaging#event-mesh-shared)\|[Java](../java/messaging#configuring-sap-event-mesh-support)]   | <Na/> |     <X/>     | <X/> |
-| SAP Cloud Application Event Hub (For single-tenant apps) [[Node.js](../node.js/messaging#event-broker)]                                                     | <Na/> | <X/><br>beta | <D/> |
-| Composite Messaging (routing by configuration) [[Node.js](../node.js/messaging#composite-messaging)\|[Java](../java/messaging#composite-messaging-service)] | <Na/> |     <X/>     | <X/> |
-| Import AsyncAPI                                                                                                                                             | <O/>  |              |      |
-| Export AsyncAPI                                                                                                                                             | <X/>  |              |      |
+|                                                                                                                                                             | CDS   | Node.js                   | Java                      |
+|-------------------------------------------------------------------------------------------------------------------------------------------------------------|:-----:|:-------------------------:|:-------------------------:|
+| [Declared Events in CDS](../cds/cdl#events)                                                                                                                 | <X/>  | <X/>                      | <X/>                      |
+| Mock Broker (to speed up local dev) [[Node.js](../node.js/messaging#file-based)\|[Java](../java/messaging#local-testing)]                                   | <Na/> | <X/>                      | <X/>                      |
+| [SAP Cloud Application Event Hub](../guides/messaging/event-broker)                                                                                            | <Na/> | <X/><br><sup>plugin</sup> | <X/><br><sup>plugin</sup> |
+| [SAP Event Mesh](../guides/messaging/event-mesh)                                                                                                            | <Na/> | <X/>                      | <X/>                      |
+| Composite Messaging (routing by configuration) [[Node.js](../node.js/messaging#composite-messaging)\|[Java](../java/messaging#composite-messaging-service)] | <Na/> | <X/>                      | <X/>                      |
+| Import AsyncAPI                                                                                                                                             | <O/>  |                           |                           |
+| Export AsyncAPI                                                                                                                                             | <X/>  |                           |                           |
 
 <span id="events-messaging-more" />
 

about/index.md

@@ -85,7 +85,7 @@ CAP provides mocked variants for several platform services out of the box, which
 | Database         | SQLite, H2 in-memory | SAP HANA, PostgreSQL             |
 | Authentication   | Mocked Auth          | SAP Identity Services            |
 | App Gateway      | None                 | SAP App Router                   |
-| Messaging        | File-based Queues    | SAP Event Hub, Kafka, Redis, ... |
+| Messaging        | File-based Queues    | SAP Cloud Appl. Event Hub, Kafka, Redis, ... |
 
 > [!tip]
 >
@@ -159,7 +159,7 @@ The CAP runtimes in Node.js and Java provide many generic implementations for re
 
 - [Serving CRUD Requests](../guides/providing-services#generic-providers)
 - [Serving Nested Documents](../guides/providing-services#deep-reads-and-writes)
-- [Serving Variable Data](../releases/oct24#basic-support-for-cds-map) <Alpha/>
+- [Serving Variable Data](../releases/archive/2024/oct24#basic-support-for-cds-map) <Alpha/>
 - [Serving (Fiori) Drafts](../advanced/fiori#draft-support)
 - [Serving Media Data](../guides/providing-services#serving-media-data)
 - [Searching Data](../guides/providing-services#searching-data)
@@ -223,7 +223,7 @@ That initiative happened to be successful, and gave a boost to a steadily **grow
 - [Open Telemetry → SAP Cloud Logging, Dynatrace, ...](../plugins/#telemetry)
 - [Attachments → SAP Object Store /S3](../plugins/#attachments)
 - [Attachments → SAP Document Management Service](../plugins/#@cap-js/sdm)
-- [Messaging → SAP Cloud Application Event Hub](../plugins/#event-broker-plugin)
+- [Messaging → SAP Cloud Application Event Hub](../plugins/#event-hub)
 - [Change Tracking](../plugins/#change-tracking)
 - [Notifications](../plugins/#notifications)
 - [Audit Logging → SAP Audit Logging](../plugins/#audit-logging)