Merge branch 'main' of https://github.com/capire/docs

Author: renejeglinsky

.github/cli/grab-cli-texts.js

@@ -20,11 +20,14 @@ const toOutput = (str) => [
     `> ${cmd}`,
     '',
     str
-        .replace(/\n.*home.*[|:].*/g, '') // remove absolute cds home path as it's system-specific
+        .replace(/([\S]+)\/node_modules/g, '.../node_modules') // remove system-specific paths
+        .replace(/([\S]+)\/bin\/node/g, '.../bin/node')
+        .replace(/([\S]+)\/your-project/g, '.../your-project') // sample project path
         .replace(/\<(.*?)\>/g, '&lt;$1&gt;') // <foo> -> &lt;foo&gt;
-        .replace(/^\x1b\[1m(.*?)\x1b\[(:?0|39|49)m\n/gm, '<strong>$1</strong>') // bold at beginning of line -> strong
-        .replace(/(\s*)\x1b\[4m(.*?)\x1b\[(:?0|39|49)m/g, '$1<i>$2</i>') // underline -> i
-        .replace(/(\s*)\x1b\[\d+m(.*?)\x1b\[(:?0|39|49)m/g, '$1<em>$2</em>') // other colors -> em
+        .replace(/^\x1b\[1m(.*?)\x1b\[(?:0|39|49)m\n/gm, '<strong>$1</strong>') // bold at beginning of line -> strong
+        .replace(/(\s*)\x1b\[(?:2|4)m(.*?)\x1b\[(?:0|39|49)m/g, '$1<i>$2</i>') // underline or grey -> i
+        .replace(/(\s*)\x1b\[[1-9]+m(.*?)\x1b\[(?:0|32|33|39|49)m/g, '$1<em>$2</em>') // other colors -> em
+        .replace(/\x1b\[0m/g, '') // remove all remaining resets
     ,
     `</pre>`
 ].join('\n')

.github/cli/grab-cli-texts.sh

@@ -6,7 +6,7 @@ dir=`dirname -- "$0"`
 proj=/tmp/your-project
 rm -rf ${proj}
 mkdir -p `dirname ${proj}`
-pushd `dirname ${proj}` && cds init `basename ${proj}` && pushd `basename ${proj}` && npm i && popd && popd
+pushd `dirname ${proj}` && cds init `basename ${proj}` --nodejs && pushd `basename ${proj}` && npm i && popd && popd
 
 echo
 echo "Grabbing CLI texts..."

.github/workflows/PR-SAP.yml

@@ -2,7 +2,6 @@ name: PR Build (SAP)
 
 on:
   pull_request:
-    branches: [main]
   merge_group:
 
 concurrency:

.github/workflows/update-content.yml

@@ -16,12 +16,12 @@ jobs:
 
     steps:
       - name: Checkout repository
-        uses: actions/checkout@v4
+        uses: actions/checkout@v6
 
       - name: Set up Node.js
-        uses: actions/setup-node@v4
+        uses: actions/setup-node@v6
         with:
-          node-version: '22'
+          node-version: 24
 
       - name: Extract CLI texts
         run: |
@@ -51,12 +51,12 @@ jobs:
 
     steps:
       - name: Checkout repository
-        uses: actions/checkout@v4
+        uses: actions/checkout@v6
 
       - name: Set up Node.js
-        uses: actions/setup-node@v4
+        uses: actions/setup-node@v6
         with:
-          node-version: '22'
+          node-version: 24
 
       - name: Update Java Properties
         run: |

guides/protocols/odata.md

@@ -40,7 +40,7 @@ OData is an OASIS standard that enhances plain REST with standardized system que
 | [Parameters Aliases](https://docs.oasis-open.org/odata/odata/v4.01/os/part1-protocol/odata-v4.01-os-part1-protocol.html#sec_ParameterAliases) | Replace literal value in URL with parameter alias | <X/> | <X/> <sup>(4)</sup>   |
 
 - <sup>(1)</sup> The elements to be searched are specified with the [`@cds.search` annotation](../services/served-ootb#searching-data).
-- <sup>(2)</sup> Node.js only supports a limited subset in `$select` query option.
+- <sup>(2)</sup> Node.js only supports a limited subset.
 - <sup>(3)</sup> The navigation path identifying the collection can only contain one segment.
 - <sup>(4)</sup> Supported for key values and for parameters of functions only.
 

node.js/cds-ql.md

@@ -938,6 +938,12 @@ INSERT.into (Books) .columns (
    [ 252, 'Eleonora', 150, 234 ]
 )
 ```
+
+::: tip In Essence:
+
+[Managed fields](../guides/domain/index#managed-data) and [UUIDs](../guides/domain/index#prefer-uuids-for-keys) are automatically filled with `INSERT.entries()`, but not when using `INSERT.columns().values()` or `INSERT.columns().rows()`.
+:::
+
 ### from() {.method #from}
 
 

package-lock.json

@@ -70,9 +70,9 @@
 
       Overwrite all files in case the target files already exist.
 
-    <em>--package</em> &lt;name&gt;
+    <em>--package | -p</em> &lt;name&gt;
 
-      Pull a package from your npm registry.
+      Pull a package from your configured npm registry.
 
 
 <strong>FEATURE OPTIONS</strong>

tools/assets/help/cds-add.out.md

@@ -126,5 +126,5 @@
    <em>cds</em> compile model.cds
    <em>cds</em> c model.json --to sql
    <em>cds</em> srv -s all -l all -2 edmx -o out
-   <em>cds</em> compile srv -s sap.sample.TestService -2 asyncapi -o [0mout
+   <em>cds</em> compile srv -s sap.sample.TestService -2 asyncapi -o out
 </pre>

tools/assets/help/cds-compile.out.md

@@ -5,37 +5,49 @@
 <strong>SYNOPSIS</strong>
     <em>cds debug</em> [&lt;app&gt;]
 
-    Debug applications running locally or remotely on Cloud Foundry.
-    Local applications will be started in debug mode, while remote applications
-    are put into debug mode.
+    Debug applications running locally or remotely on Cloud Foundry or Kubernetes.
 
-    If &lt;app&gt; is given, it's assumed to be running on the currently logged-in
-    Cloud Foundry space (check with 'cf target').
-    SSH access to the app is required (check with 'cf ssh-enabled').
-    Chrome DevTools are opened automatically for Node.js applications.
+    If &lt;app&gt; is given, it's assumed to be running on a remote system. The command defaults
+    to Kubernetes if Helm deployment descriptors are present, otherwise Cloud Foundry.
+
+    For Cloud Foundry, the currently targeted space is used (check with 'cf target').
+    For Kubernetes, the current context and namespace are used (check with 'kubectl config get-contexts').
+
+    SSH access to the app is required (check with 'cf ssh-enabled' on Cloud Foundry).
 
     If no &lt;app&gt; is given, the app in the current working directory is started
     (with 'cds watch --debug' for Node.js and 'mvn spring-boot:run' for Java).
 
+    For Node.js, Chrome DevTools are opened automatically unless <em>--no-devtools</em> is set.
+
 <strong>OPTIONS</strong>
     <em>-h</em> | <em>--host</em>
 
-      the debug host (default: '127.0.0.1')
+      The debug host (default: '127.0.0.1').
 
     <em>-p</em> | <em>--port</em>
 
-      the debug port (default: '9229' for Node.js, '8000' for Java)
+      The debug port (default: '9229' for Node.js, '8000' for Java).
+
+    <em>--cf</em>
+
+      Force Cloud Foundry mode.
+
+    <em>--k8s</em>
+
+      Force Kubernetes mode. Use env vars KUBE_NAMESPACE or NAMESPACE to select a namespace.
 
     <em>--no-devtools</em>
 
-      don't open developer tools automatically
+      Don't open developer tools automatically (Node.js only).
 
     <em>-f</em> | <em>--force</em>
 
-      if necessary, automatically enable ssh for the app and restart it
+      If necessary, automatically enable SSH for the app and restart it.
 
 <strong>EXAMPLES</strong>
     <em>cds debug</em>
     <em>cds debug</em> bookshop-srv --port 8001
     <em>cds debug</em> bookshop-srv --host 0.0.0.0
+    <em>cds debug</em> --k8s bookshop-srv
 </pre>