@sap/cds 9.3.1 → 9.4.2

package/_i18n/messages_zh_CN.properties

@@ -0,0 +1,194 @@
+# Input Validation
+
+#XMSG: Enter a value between 0 and 100. // Implementation still provides 3 values
+ASSERT_RANGE=\u8F93\u5165\u4E00\u4E2A\u4ECB\u4E8E {1} \u548C {2} \u4E4B\u95F4\u7684\u503C\u3002
+#XMSG: Enter a valuematching the pattern /^abc/.
+ASSERT_FORMAT=\u8F93\u5165\u4E00\u4E2A\u7B26\u5408\u6A21\u5F0F {1} \u7684\u503C\u3002
+#XMSG: Enter one of the allowed values: High,Medium,Low. // Implementation still provides 2 values
+ASSERT_ENUM=\u8F93\u5165\u5176\u4E2D\u4E00\u4E2A\u5141\u8BB8\u7684\u503C\uFF1A{1}\u3002
+#XMSG: Provide the missing value. // Error text displayed on a field, in case a mandatory value is not set.
+ASSERT_MANDATORY=\u63D0\u4F9B\u7F3A\u5C11\u7684\u503C\u3002
+#XMSG: Target with this key doesn't exist.
+ASSERT_TARGET=\u5177\u6709\u6B64\u952E\u503C\u7684\u76EE\u6807\u4E0D\u5B58\u5728\u3002
+
+# Aggregating Error
+
+#XMSG
+MULTIPLE_ERRORS=\u51FA\u73B0\u591A\u4E2A\u9519\u8BEF\uFF0C\u8BF7\u53C2\u9605\u4E0B\u9762\u7684\u8BE6\u7EC6\u4FE1\u606F\u3002
+
+# Input format
+
+#NOTR
+ASSERT_VALID_ELEMENT=Element is not valid
+#NOTR
+ASSERT_DATA_TYPE=Value {0} is not a valid {1}
+#NOTR
+ASSERT_ARRAY=Value must be an array
+
+# Status Codes
+
+#NOTR
+400=Bad Request
+#NOTR
+401=Unauthorized
+#NOTR
+403=Forbidden
+#NOTR
+404=Not Found
+#NOTR
+405=Method Not Allowed
+#NOTR
+406=Not Acceptable
+#NOTR
+407=Proxy Authentication Required
+#NOTR
+408=Request Timeout
+#NOTR
+409=Conflict
+#NOTR
+410=Gone
+#NOTR
+411=Length Required
+#NOTR
+412=Precondition Failed
+#NOTR
+413=Payload Too Large
+#NOTR
+414=URI Too Long
+#NOTR
+415=Unsupported Media Type
+#NOTR
+416=Range Not Satisfiable
+#NOTR
+417=Expectation Failed
+#NOTR
+422=Unprocessable Content
+#NOTR
+424=Failed Dependency
+#NOTR
+428=Precondition Required
+#NOTR
+429=Too Many Requests
+#NOTR
+431=Request Header Fields Too Large
+#NOTR
+451=Unavailable For Legal Reasons
+#NOTR
+500=Internal Server Error
+#NOTR
+501=The server does not support the functionality required to fulfill the request
+#NOTR
+502=Bad Gateway
+#NOTR
+503=Service Unavailable
+#NOTR
+504=Gateway Timeout
+
+# fragments
+
+#NOTR
+ENTITY=entity
+#NOTR
+TYPE=type
+#NOTR
+FUNCTION=function
+#NOTR
+ACTION=action
+
+# db
+
+#NOTR
+NO_DATABASE_CONNECTION=No database connection
+#NOTR
+ENTITY_ALREADY_EXISTS=Entity already exists
+#NOTR
+ENTITY_LOCKED=Entity locked
+#NOTR
+UNIQUE_CONSTRAINT_VIOLATION=Unique constraint violation
+#NOTR
+FK_CONSTRAINT_VIOLATION=Foreign key constraint violation
+
+# remote
+
+#NOTR
+INVALID_CONTENT_TYPE_ONLY_JSON=Invalid content type. Only "application/json" is supported.
+
+# access control
+
+#NOTR
+INSERTABLE=insertable
+#NOTR
+READABLE=readable
+#NOTR
+UPDATABLE=updatable
+#NOTR
+DELETABLE=deletable
+#NOTR
+ENTITY_IS_INSERT_ONLY=Entity "{0}" is insert-only
+#NOTR
+ENTITY_IS_READ_ONLY=Entity "{0}" is read-only
+#NOTR
+ENTITY_IS_NOT_CRUD=Entity "{0}" is not {1}
+#NOTR
+ENTITY_IS_NOT_CRUD_VIA_NAVIGATION=Entity "{0}" is not {1} via navigation "{2}"
+#NOTR
+ENTITY_IS_AUTOEXPOSED=Entity "{0}" is not explicitly exposed as part of the service
+#NOTR
+ENTITY_IS_AUTOEXPOSE_READONLY=Entity "{0}" is explicitly exposed as readonly
+#NOTR
+EXPAND_IS_RESTRICTED=Navigation property "{0}" is not allowed for expand operation
+
+# rest protocol adapter
+
+#NOTR
+INVALID_RESOURCE="{0}" is not a valid resource
+#NOTR
+INVALID_PARAMETER="{0}" is not a valid parameter
+#NOTR
+INVALID_PARAMETER_VALUE_TYPE=Parameter value for "{0}" must be of type "{1}"
+#NOTR
+INVALID_OPERATION_FOR_ENTITY=Entity "{0}" has no {1} "{2}"
+#NOTR
+NO_MATCHING_RESOURCE=The server has not found a resource matching the requested URI
+#NOTR
+INVALID_POST=POST is only allowed on resource collections and actions
+#NOTR
+INVALID_PUT=PUT is only allowed on a specific resource
+#NOTR
+INVALID_PATCH=PATCH is only allowed on a specific resource
+#NOTR
+INVALID_DELETE=DELETE is only supported on a specific resource
+#NOTR
+CRUD_VIA_NAVIGATION_NOT_SUPPORTED=CRUD via navigations is not yet supported
+
+# OData protocol adapter
+
+#NOTR
+BATCH_TOO_MANY_REQ=Batch request contains too many requests
+
+# draft
+
+#NOTR
+DRAFT_LOCKED_BY_ANOTHER_USER=The entity is locked by user "{0}"
+#NOTR
+DRAFT_ALREADY_EXISTS=A draft for this entity already exists
+#NOTR
+DRAFT_NOT_EXISTING=No draft for this entity exists
+#NOTR
+DRAFT_MODIFICATION_ONLY_VIA_ROOT=A draft-enabled entity can only be modified via its root entity
+#NOTR
+ACTIVE_MODIFICATION_VIA_DRAFT=Active entities cannot be modified via draft request
+#NOTR
+DRAFT_ACTIVE_DELETE_FORBIDDEN_DRAFT_EXISTS=Entity cannot be deleted because a draft exists
+
+# singleton
+
+#NOTR
+SINGLETON_NOT_NULLABLE=The singleton entity is not nullable
+
+# flows
+
+#XMSG: Action "acceptTravel" requires "travelStatus" to be "Open".
+INVALID_FLOW_TRANSITION_SINGLE=\u64CD\u4F5C "{0}" \u8981\u6C42 "{1}" \u5FC5\u987B\u4E3A "{2}"\u3002
+#XMSG: Action "cancelTravel" requires "travelStatus" to be one of the following values: Open,Accepted.
+INVALID_FLOW_TRANSITION_MULTI=\u64CD\u4F5C "{0}" \u8981\u6C42 "{1}" \u5FC5\u987B\u4E3A\u4EE5\u4E0B\u503C\u4E4B\u4E00\uFF1A{2}\u3002

package/_i18n/messages_zh_TW.properties

@@ -0,0 +1,194 @@
+# Input Validation
+
+#XMSG: Enter a value between 0 and 100. // Implementation still provides 3 values
+ASSERT_RANGE=\u8ACB\u8F38\u5165\u4ECB\u65BC {1} \u5230 {2} \u4E4B\u9593\u7684\u503C\u3002
+#XMSG: Enter a valuematching the pattern /^abc/.
+ASSERT_FORMAT=\u8ACB\u8F38\u5165\u7B26\u5408\u6A21\u5F0F {1} \u7684\u503C\u3002
+#XMSG: Enter one of the allowed values: High,Medium,Low. // Implementation still provides 2 values
+ASSERT_ENUM=\u8ACB\u8F38\u5165\u5176\u4E2D\u4E00\u500B\u5141\u8A31\u7684\u503C\uFF1A{1}\u3002
+#XMSG: Provide the missing value. // Error text displayed on a field, in case a mandatory value is not set.
+ASSERT_MANDATORY=\u8ACB\u63D0\u4F9B\u7F3A\u5C11\u7684\u503C\u3002
+#XMSG: Target with this key doesn't exist.
+ASSERT_TARGET=\u542B\u6709\u6B64\u9375\u503C\u7684\u76EE\u6A19\u4E0D\u5B58\u5728\u3002
+
+# Aggregating Error
+
+#XMSG
+MULTIPLE_ERRORS=\u767C\u751F\u591A\u500B\u932F\u8AA4\uFF0C\u8ACB\u67E5\u770B\u4E0B\u65B9\u8A73\u7D30\u8CC7\u6599\u3002
+
+# Input format
+
+#NOTR
+ASSERT_VALID_ELEMENT=Element is not valid
+#NOTR
+ASSERT_DATA_TYPE=Value {0} is not a valid {1}
+#NOTR
+ASSERT_ARRAY=Value must be an array
+
+# Status Codes
+
+#NOTR
+400=Bad Request
+#NOTR
+401=Unauthorized
+#NOTR
+403=Forbidden
+#NOTR
+404=Not Found
+#NOTR
+405=Method Not Allowed
+#NOTR
+406=Not Acceptable
+#NOTR
+407=Proxy Authentication Required
+#NOTR
+408=Request Timeout
+#NOTR
+409=Conflict
+#NOTR
+410=Gone
+#NOTR
+411=Length Required
+#NOTR
+412=Precondition Failed
+#NOTR
+413=Payload Too Large
+#NOTR
+414=URI Too Long
+#NOTR
+415=Unsupported Media Type
+#NOTR
+416=Range Not Satisfiable
+#NOTR
+417=Expectation Failed
+#NOTR
+422=Unprocessable Content
+#NOTR
+424=Failed Dependency
+#NOTR
+428=Precondition Required
+#NOTR
+429=Too Many Requests
+#NOTR
+431=Request Header Fields Too Large
+#NOTR
+451=Unavailable For Legal Reasons
+#NOTR
+500=Internal Server Error
+#NOTR
+501=The server does not support the functionality required to fulfill the request
+#NOTR
+502=Bad Gateway
+#NOTR
+503=Service Unavailable
+#NOTR
+504=Gateway Timeout
+
+# fragments
+
+#NOTR
+ENTITY=entity
+#NOTR
+TYPE=type
+#NOTR
+FUNCTION=function
+#NOTR
+ACTION=action
+
+# db
+
+#NOTR
+NO_DATABASE_CONNECTION=No database connection
+#NOTR
+ENTITY_ALREADY_EXISTS=Entity already exists
+#NOTR
+ENTITY_LOCKED=Entity locked
+#NOTR
+UNIQUE_CONSTRAINT_VIOLATION=Unique constraint violation
+#NOTR
+FK_CONSTRAINT_VIOLATION=Foreign key constraint violation
+
+# remote
+
+#NOTR
+INVALID_CONTENT_TYPE_ONLY_JSON=Invalid content type. Only "application/json" is supported.
+
+# access control
+
+#NOTR
+INSERTABLE=insertable
+#NOTR
+READABLE=readable
+#NOTR
+UPDATABLE=updatable
+#NOTR
+DELETABLE=deletable
+#NOTR
+ENTITY_IS_INSERT_ONLY=Entity "{0}" is insert-only
+#NOTR
+ENTITY_IS_READ_ONLY=Entity "{0}" is read-only
+#NOTR
+ENTITY_IS_NOT_CRUD=Entity "{0}" is not {1}
+#NOTR
+ENTITY_IS_NOT_CRUD_VIA_NAVIGATION=Entity "{0}" is not {1} via navigation "{2}"
+#NOTR
+ENTITY_IS_AUTOEXPOSED=Entity "{0}" is not explicitly exposed as part of the service
+#NOTR
+ENTITY_IS_AUTOEXPOSE_READONLY=Entity "{0}" is explicitly exposed as readonly
+#NOTR
+EXPAND_IS_RESTRICTED=Navigation property "{0}" is not allowed for expand operation
+
+# rest protocol adapter
+
+#NOTR
+INVALID_RESOURCE="{0}" is not a valid resource
+#NOTR
+INVALID_PARAMETER="{0}" is not a valid parameter
+#NOTR
+INVALID_PARAMETER_VALUE_TYPE=Parameter value for "{0}" must be of type "{1}"
+#NOTR
+INVALID_OPERATION_FOR_ENTITY=Entity "{0}" has no {1} "{2}"
+#NOTR
+NO_MATCHING_RESOURCE=The server has not found a resource matching the requested URI
+#NOTR
+INVALID_POST=POST is only allowed on resource collections and actions
+#NOTR
+INVALID_PUT=PUT is only allowed on a specific resource
+#NOTR
+INVALID_PATCH=PATCH is only allowed on a specific resource
+#NOTR
+INVALID_DELETE=DELETE is only supported on a specific resource
+#NOTR
+CRUD_VIA_NAVIGATION_NOT_SUPPORTED=CRUD via navigations is not yet supported
+
+# OData protocol adapter
+
+#NOTR
+BATCH_TOO_MANY_REQ=Batch request contains too many requests
+
+# draft
+
+#NOTR
+DRAFT_LOCKED_BY_ANOTHER_USER=The entity is locked by user "{0}"
+#NOTR
+DRAFT_ALREADY_EXISTS=A draft for this entity already exists
+#NOTR
+DRAFT_NOT_EXISTING=No draft for this entity exists
+#NOTR
+DRAFT_MODIFICATION_ONLY_VIA_ROOT=A draft-enabled entity can only be modified via its root entity
+#NOTR
+ACTIVE_MODIFICATION_VIA_DRAFT=Active entities cannot be modified via draft request
+#NOTR
+DRAFT_ACTIVE_DELETE_FORBIDDEN_DRAFT_EXISTS=Entity cannot be deleted because a draft exists
+
+# singleton
+
+#NOTR
+SINGLETON_NOT_NULLABLE=The singleton entity is not nullable
+
+# flows
+
+#XMSG: Action "acceptTravel" requires "travelStatus" to be "Open".
+INVALID_FLOW_TRANSITION_SINGLE=\u52D5\u4F5C "{0}" \u9700\u8981 "{1}" \u662F "{2}"\u3002
+#XMSG: Action "cancelTravel" requires "travelStatus" to be one of the following values: Open,Accepted.
+INVALID_FLOW_TRANSITION_MULTI=\u52D5\u4F5C "{0}" \u9700\u8981 "{1}" \u662F\u4E0B\u5217\u5176\u4E2D\u4E00\u500B\u503C\uFF1A{2}\u3002

package/bin/serve.js

@@ -8,7 +8,7 @@ module.exports = exports = Object.assign ( serve, {
         '--project', '--projects',
         '--in-memory', '--in-memory?',
         '--mocked', '--with-mocks', '--with-bindings', '--resolve-bindings',
-        '--watch',
+        '--watch', '--with-mtx',
     ],
     shortcuts: [ '-s', undefined, '-2', '-a', '-w', undefined, undefined, '-p' ],
     help: `
@@ -75,6 +75,10 @@ module.exports = exports = Object.assign ( serve, {
         You can use *cds watch* as shortcut, which is equivalent to:
         *cds serve --with-mocks --in-memory? --watch --project ...*
 
+    *--with-mtx*
+
+        A shortcut for _--profile with-mtx_ to enable MTX features.
+
     *--workers* <number> | true
 
         Spawns <number> of worker processes in a cluster to handle incoming requests.
@@ -168,6 +172,10 @@ async function serve (all=[], o={}) {
   // let plugins know about the CLI
   cds.cli = { command: 'serve', argv: all, options: o }
 
+  // Enable mtx features also in dev mode, if asked to
+  if (o['with-mtx'])
+    process.env.CDS_ENV = process.env.CDS_ENV ? process.env.CDS_ENV + ',with-mtx' : 'with-mtx'
+
   // Ensure loading plugins before calling cds.env!
   await cds.plugins
 

package/common.cds

@@ -96,6 +96,15 @@ context sap.common {
   aspect TextsAspect {
     key locale: Locale;
   }
+
+  aspect FlowHistory {
+    transitions_ : Composition of many {
+      key timestamp : managed:createdAt;
+          user      : managed:createdBy;
+          status    : String;
+          comment   : String;
+    }
+  }
 }
 
 
@@ -130,7 +139,6 @@ aspect temporal {
   validTo   : Timestamp @cds.valid.to;
 }
 
-
 /**
  * Canonical user ID
  */

package/lib/compile/cds-compile.js

@@ -7,6 +7,7 @@ const compile = module.exports = Object.assign (cds_compile, {
     get java(){ return super.java = require('./for/java') }
     get nodejs() { return super.nodejs = require('./for/nodejs') }
     get lean_drafts() { return super.lean_drafts = require('./for/lean_drafts') }
+    get flows() { return super.flows = require('./for/flows') }
     get odata() { return super.odata = require('./for/odata') }
     get sql() { return super.sql = require('./for/sql') }
   },

package/lib/compile/etc/properties.js

@@ -40,4 +40,5 @@ function string4 (raw) {
   return raw
   .replace(/''/g,"'") .replace(/^"(.*)"$/,"$1") .replace(/^'(.*)'$/,"$1")
   .replace(/\\u[\dA-F]{4}/gi, (match) => String.fromCharCode(parseInt(match.replace(/\\u/g, ''), 16)))
+  .replace(/\\(.)/g, (_, seq) => ({ n: '\n', r: '\r', t: '\t', f: '\f' }[seq] ?? seq))
 }

package/lib/compile/for/flows.js

@@ -8,17 +8,20 @@ const TO = '@to'
 // backwards compat
 const FLOW_FROM = '@flow.from'
 const FLOW_TO = '@flow.to'
+const FLOW_PREVIOUS = '$flow.previous'
 
 const getFrom = action => {
   let from = action[FROM] ?? action[FLOW_FROM]
-  from = Array.isArray(from) ? from : [from]
-  return from.map(f => f['#'] ?? f['='] ?? f)
+  return Array.isArray(from) ? from : [from]
 }
 
 function addOperationAvailableToActions(actions, statusEnum, statusElementName) {
   for (const action of Object.values(actions)) {
     const fromList = getFrom(action)
-    const conditions = fromList.map(from => `$self.${statusElementName} = '${statusEnum[from].val ?? from}'`)
+    const conditions = fromList.map(from => {
+      const value = from['#'] ? statusEnum[from['#']]?.val ?? statusEnum[from['#']]['$path'].at(-1) : from
+      return `$self.${statusElementName} = ${typeof value === 'string' ? `'${value}'` : value}`
+    })
     const condition = `(${conditions.join(' OR ')})`
     const parsedXpr = cds.parse.expr(condition)
     action['@Core.OperationAvailable'] ??= {
@@ -99,4 +102,67 @@ function enhanceCSNwithFlowAnnotations4FE(csn) {
   }
 }
 
-module.exports = { enhanceCSNwithFlowAnnotations4FE, getFrom }
+module.exports = function cds_compile_for_flows(csn) {
+  let flowHistory
+
+  for (const name in csn.definitions) {
+    const def = csn.definitions[name]
+
+    if (!def.kind || def.kind !== 'entity' || !def.actions || def.elements?.transitions_) continue
+
+    let history
+    if (cds.env.features.history_for_flows === 'all') {
+      for (const each in def.elements) {
+        if (def.elements[each]['@flow.status']) {
+          history = true
+          break
+        }
+      }
+    } else {
+      for (const each in def.actions) {
+        const action = def.actions[each]
+        if (action && (action[TO]?.['='] === FLOW_PREVIOUS || action[FLOW_TO]?.['='] === FLOW_PREVIOUS)) {
+          history = true
+          break
+        }
+      }
+    }
+    if (!history) continue
+
+    flowHistory ??= csn.definitions['sap.common.FlowHistory']
+    if (!flowHistory) cds.error('Cannot find definition sap.common.FlowHistory')
+
+    const { elements: aspectElements } = flowHistory.elements.transitions_.targetAspect
+
+    def.includes ??= []
+    def.includes.push('sap.common.FlowHistory')
+    def.elements.transitions_ = JSON.parse(`{
+      "type": "cds.Composition",
+      "cardinality": { "max": "*" },
+      "targetAspect": { "elements": ${JSON.stringify(aspectElements)} },
+      "target": "${name}.transitions_",
+      "on": [{ "ref": ["transitions_", "up_"] }, "=", { "ref": ["$self"] }]
+    }`)
+
+    const def_keys = Object.keys(def.elements)
+      .filter(k => def.elements[k].key)
+      .map(k => ({ ref: [k] }))
+    csn.definitions[`${name}.transitions_`] = JSON.parse(`{
+      "kind": "entity",
+      "elements": {
+        "up_": {
+          "key": true,
+          "type": "cds.Association",
+          "cardinality": { "min": 1, "max": 1 },
+          "target": "${name}",
+          "keys": ${JSON.stringify(def_keys)},
+          "notNull": true
+        },
+        ${JSON.stringify(aspectElements).slice(1, -1)}
+      }
+    }`)
+  }
+}
+
+module.exports.enhanceCSNwithFlowAnnotations4FE = enhanceCSNwithFlowAnnotations4FE
+module.exports.getFrom = getFrom

package/lib/compile/for/nodejs.js

@@ -8,7 +8,7 @@ function _compile_for_nodejs (csn, o) {
   let dsn = cds.compile.for.odata(min, o) //> creates a partial copy -> avoid any cds.linked() before
   dsn = unfold_csn(dsn)
   dsn = cds.linked(dsn)
-  cds.compile.for.lean_drafts(dsn, o)
+  cds.compile.for.lean_drafts(dsn)
 
   // @Common.Text → @cds.search
   text_to_search: for (const name in dsn.definitions) {