@sap/cds-compiler 4.4.4 → 4.6.0

package/CHANGELOG.md

@@ -7,6 +7,79 @@
 Note: `beta` fixes, changes and features are usually not listed in this ChangeLog but [here](doc/CHANGELOG_BETA.md).
 The compiler behavior concerning `beta` features can change at any time without notice.
 
+
+## Version 4.6.0 - 2024-01-26
+
+### Added
+
+- compiler: Events can now be projections on other structured events and types.
+- to.cdl: `parseCdl` and `gensrc` style CSN (a.k.a. `inferred` and `xtended`) is now supported as input.
+
+### Changed
+
+- Update OData vocabularies: 'Aggregation', 'Validation'
+- to.sql/hdi/hdbcds: Removed warnings for number and type of keys in draft-enabled entities.
+
+### Fixed
+
+- compiler:
+  + ON-conditions of associations with filters in calculated elements were incorrectly rewritten when included
+    in other entities, and the filter was applied twice in some scenarios.
+  + redirecting an association with filter did not rewrite paths relative to the redirection target.
+  + Unknown type references with an explicit named type argument such as `Unknown(length: 10)` crashed.
+- to.edm(x):
+  + `@Core.IsURL` is not rendered in combination with `@Core.MediaType` (V4 only).
+  + No 'odata-navigation' warning for association targets annotated with `@cds.autoexpose: false`.
+  + No empty annotation in API, when a non-existent base annotation is annotated  
+    (eg. `@Common.Label.@Core.Description` without `@Common.Label`).
+  + Don't crash if value for `$Type` is not a string.
+  + Generated foreign keys of type `cds.UUID` that are also primary key are not annotated with
+    `@Core.ComputedDefaultValue`. This is a follow up correction to [4.5.0](#version-450---2023-12-08)
+
+
+## Version 4.5.0 - 2023-12-08
+
+### Added
+
+- compiler/parser
+  + Annotations can have any expressions as value, like `@Anno: ( ref + 1 )`.
+    References are checked to be valid element references,
+    inherited values might become invalid due to element renaming.
+    This feature is still experimental, and
+    might not be supported by all backends or runtimes at the moment.
+  + A single `annotate` statement can now be used to annotate parameters, elements and
+    bound actions in one statement.
+- to.edm(x): Key elements of type `cds.UUID` are annotated with `@Core.ComputedDefaultValue` if they are
+  defined directly in the entity. Elements of type `cds.UUID` that are defined in a named structured type
+  and used to define a key element are not annotated, instead a warning is raised if such elements are
+  not annotated with `@Core.ComputedDefaultValue`.
+- to.sql|hdi: Add option `withHanaAssociations` which, for sqlDialect `hana`, allows suppressing
+  the generation of the `WITH ASSOCIATIONS`.
+
+### Changed
+
+- Update OData Vocabulary: 'Common'.
+- api: Reject CSN as input in backends, if it is a CSN in flavor `parsed` with a non-empty `requires` array.
+  Reason being that the model is not considered a "full" CSN, as dependencies were not resolved.
+
+### Fixed
+
+- compiler:
+  + Fix false positives of cyclic dependencies for calculated elements.
+  + Fix cardinality on source associations when publishing them with a filter (+ different cardinality)
+    in a projection.  The cardinality was incorrectly changed on the source as well.
+- CDL parser:
+  + More numbers that would lose relevant digits due to precision loss are
+    stored as strings in CSN (i.e. `{ "literal":"number", "val": "1.0000000000000001" }`).
+  + Nested table expressions and queries in the FROM clause (with surrounding parentheses)
+    could cause some constructs such as `virtual` to be not properly parsed.
+- to.hdi.migration: Don't drop-create the primary key when only a doc-comment has changed.
+- to.cdl: Fix edge case where `@A.![B#]` was not rendered correctly.
+
+### Removed
+
+- to.edm(x): Remove option `--odata-open-type` introduced with [4.4.0](#version-440---2023-11-09).
+
 ## Version 4.4.4 - 2023-11-24
 
 ### Fixed
@@ -311,6 +384,7 @@ The compiler behavior concerning `beta` features can change at any time without
     we avoid unexpected name resolution effects in combination with built-in `$`-variables.
   + A semicolon is now required after a type definition like `type T : many {} null`.
   + Message ID `duplicate-autoexposed` was changed to `def-duplicate-autoexposed`.
+  + Bare `$projection` are rejected. Use `$self` instead.
 - Update OData vocabularies 'Common', 'UI'.
 - to.sql:
   + Change default `length` for `cds.String` for all SQL dialects except `hana` to 255.
@@ -361,6 +435,20 @@ The compiler behavior concerning `beta` features can change at any time without
     are removed, because since - `Entity.myElement` could also be a definition,
     creating ambiguities. This did not work always, anyway.
 
+## Version 3.9.12 - 2023-12-06
+
+### Fixed
+
+- compiler:
+  + SQL function `STDDEV(*)` was not parsable.
+  + Numbers in scientific notation `-1e1` were sometimes not recognized via CSN input.
+- for.odata: Fix crash when using a projection with associations as action parameter type.
+- for.hana: Fix a bug in association to join translation, expect ON condition operand to be a function without arguments.
+- to.edm(x):
+  + Omit `EntitySet` attribute on `Edm.FunctionImport` and `Edm.ActionImport` that return a singleton.
+  + Don't render `Scale: variable` for `cds.Decimal(scale:0)`.
+- to.sql/hdi/hdbcds: consider `having` predicate for `exists` expansion
+
 ## Version 3.9.10 - 2023-08-25
 
 ### Fixed

package/bin/cdsc.js

@@ -27,10 +27,12 @@ const { reveal } = require('../lib/model/revealInternalProperties');
 const enrichCsn = require('../lib/model/enrichCsn');
 const { optionProcessor } = require('../lib/optionProcessor');
 const {
-  explainMessage, hasMessageExplanation, sortMessages, messageIdsWithExplanation,
+  explainMessage, hasMessageExplanation, sortMessages,
+  messageIdsWithExplanation, makeMessageFunction,
 } = require('../lib/base/messages');
 const { term } = require('../lib/utils/term');
 const { addLocalizationViews } = require('../lib/transform/localized');
+const { addTenantFields } = require('../lib/transform/addTenantFields');
 const { availableBetaFlags } = require('../lib/base/model');
 const { alterConstraintsWithCsn } = require('../lib/render/manageConstraints');
 
@@ -63,17 +65,13 @@ function remapCmdOptions( options, command ) {
   for (const [ key, value ] of Object.entries(options[command])) {
     switch (key) {
       case 'user':
-        if (!options.variableReplacements)
-          options.variableReplacements = {};
-        if (!options.variableReplacements.$user)
-          options.variableReplacements.$user = {};
+        options.variableReplacements ??= {};
+        options.variableReplacements.$user ??= {};
         options.variableReplacements.$user.id = value;
         break;
       case 'locale':
-        if (!options.variableReplacements)
-          options.variableReplacements = {};
-        if (!options.variableReplacements.$user)
-          options.variableReplacements.$user = {};
+        options.variableReplacements ??= {};
+        options.variableReplacements.$user ??= {};
         options.variableReplacements.$user.locale = value;
         break;
       case 'serviceNames':
@@ -391,7 +389,8 @@ function executeCommandLine( command, options, args ) {
   // / DO NOT DELETE THIS TORENAME FUNCTIONALITY!!
   function toRename( model ) {
     const csn = options.directBackend ? model : compactModel(model, options);
-    const renameResult = _toRename(csn, options);
+    const messageFunctions = makeMessageFunction(csn, options, 'to.rename');
+    const renameResult = _toRename(csn, options, messageFunctions);
     let storedProcedure = `PROCEDURE RENAME_${renameResult.options.sqlMapping.toUpperCase()}_TO_PLAIN LANGUAGE SQLSCRIPT AS BEGIN\n`;
     for (const name in renameResult.rename) {
       storedProcedure += `  --\n  -- ${name}\n  --\n`;
@@ -406,7 +405,8 @@ function executeCommandLine( command, options, args ) {
   function manageConstraints( model ) {
     const csn = options.directBackend ? model : compactModel(model, options);
     const { src } = options || {};
-    const alterConstraintsResult = alterConstraintsWithCsn(csn, options);
+    const messageFunctions = makeMessageFunction(csn, options, 'alterConstraints');
+    const alterConstraintsResult = alterConstraintsWithCsn(csn, options, messageFunctions);
     Object.keys(alterConstraintsResult).forEach((id) => {
       const renderedConstraintStatement = alterConstraintsResult[id];
       if (src === 'hdi')
@@ -419,6 +419,11 @@ function executeCommandLine( command, options, args ) {
   // Execute the command line option '--to-sql' and display the results.
   // Return the original model (for chaining)
   function toSql( model ) {
+    if (options.withoutHanaAssociations) {
+      options.withHanaAssociations = false;
+      delete options.withoutHanaAssociations;
+    }
+
     const csn = options.directBackend ? model : compactModel(model, options);
     if (options.src === 'hdi') {
       if (options.csn) {
@@ -554,6 +559,8 @@ function executeCommandLine( command, options, args ) {
     }
     else if (!options.parseOnly) { // no output if parseOnly but not rawOutput
       const csn = compactModel(xsn, options);
+      if (command === 'toCsn' && options.tenantAsColumn)
+        addTenantFields(csn, options);
       if (command === 'toCsn' && options.withLocalized)
         addLocalizationViews(csn, options);
       if (options.enrichCsn)

package/bin/cdsv2m.js

@@ -2,14 +2,14 @@
 
 'use strict';
 
-// Very simple command-line interface to support model migration from compiler
-// v1 to v2.  (If our client command processor would have been not as difficult
-// as after #2629, we could have a cdsc commend "migrate...)
+// Very simple command-line interface to support model migration
+// from compiler v1 to v2.
 
 const commands = {
   ria,
 };
 const compiler = require('../lib/compiler');
+const { smartId } = require('../lib/render/toCdl');
 
 const { argv } = process;
 const cmd = commands[argv[2]];
@@ -42,6 +42,8 @@ function ria() {
       annotates[name.slice( 1, -1 )] = true;
     } );
   }
-  for (const name in annotates)
-    console.log( `annotate ${name} with @cds.redirection.target: false;`);
+  for (const name in annotates) {
+    const escaped = name.split('.').map(part => smartId(part)).join('.');
+    console.log(`annotate ${escaped} with @cds.redirection.target: false;`);
+  }
 }

package/doc/CHANGELOG_BETA.md

@@ -8,6 +8,28 @@ Note: `beta` fixes, changes and features are listed in this ChangeLog just for i
 The compiler behavior concerning `beta` features can change at any time without notice.
 **Don't use `beta` fixes, changes and features in productive mode.**
 
+## Version 4.6.0 - 2024-01-26
+
+### Added `vectorType`
+
+Using this beta flag, the new type `cds.Vector` is available for modeling.
+
+## Version 4.5.0 - 2023-12-08
+
+### Added `odataAnnotationExpressions`
+
+This flag allows to use expressions as annotation values, e.g.
+`@anno: (1+2)` and to enable OData specific transformations on those expressions.
+
+### Added `tenantVariable`
+
+If this beta flag is enabled, variable `$tenant` can be used without explicit replacement value.
+
+### Added feature "associations as direct calculated element values"
+
+This beta feature does not require a flag.  It is now possible to use associations with
+filters as direct values of calculated elements (on-read), e.g. `calc = assoc[ID = 1]`.
+
 ## Version 4.3.0 - 2023-09-29
 
 ### Removed `associationDefault`