@sap/cds-compiler 5.5.2 → 5.7.0

package/CHANGELOG.md

@@ -7,6 +7,48 @@
 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 5.7.0 - 2025-01-24
+
+### Added
+
+- Analyze enum symbols like `#ENUM_SYMB`; support starts at the following places:
+  + used as sole `default` value or `select` column expression
+    if the element/column has a specified enum type, or
+  + used as sole value (in parentheses) of an annotation assignment
+    if there is a definition for that annotation having an enum type;
+  + effects in compiler: complain if enum symbol is undefined
+  + effects in the IDE with an upcoming version of cds-lsp when compiler option `newParser` is set:
+    offer code completion and hover information,
+  + effects in backends like `to.sql` (and potentially runtimes): enum symbol
+    is replaced by corresponding string/integer value when appropriate.
+- for.seal: Process foreign key annotations similar to to.edm(x)
+
+### Changed
+
+- CDL parser: it is now recommended to set the option `newParser` to make the compiler
+  use a CDL parser with a significantly smaller footprint (among other things).
+  New features might only work if this option is set, see above.
+
+### Fixed
+
+- CDL parser: doc comment parser was susceptible to ReDos
+- to.sql/hdi: Paths inside calculated elements that are simple functions were not properly rewritten.
+- for.odata: Re-add foreign keys in property `targetAspect` in the OData CSN.
+- to.edm(x): In annotation translation, by default map `SemanticObjectMappingAbstract` to `SemanticObjectMappingType` to avoid regreessions.
+- to.cdl: Fix quoting of identifier `many` in `Composition of`/`Association to`
+- for.seal: Allow annotation paths to end in `many`-elements, not just scalar, liek we allow in for.odata
+
+## Version 5.6.0 - 2024-12-12
+
+### Added
+
+- Allow to refer to draft state element `HasActiveEntity` and `HasDraftEntity` via variable `$draft` in annotation path expressions.
+- for.odata|to.edm(x): Introduce annotating the generated foreign keys
+
+### Changed
+
+- Update OData vocabularies: 'Common', 'EntityRelationship', 'UI'
+
 ## Version 5.5.2 - 2024-12-02
 
 ### Fixed
@@ -131,7 +173,7 @@ The compiler behavior concerning `beta` features can change at any time without
 ### Added
 
 - cdsc: Option `--stdin` was added to support input via standard input, e.g. `cat file.cds | cdsc --stdin`
-- Allow to refer to draft state element `IsActiveEntity` via magic variable `$draft.IsActiveEntity` in annotation path expressions.
+- Allow to refer to draft state element `IsActiveEntity` via variable `$draft.IsActiveEntity` in annotation path expressions.
   + for.odata: During draft augmentation `$draft.IsActiveEntity` is rewritten to `$self.IsActiveEntity` for all draft enabled
     entities (root and sub nodes but not for named types or entity parameters).
   + to.edm(x): (V4 only) Allow to refer to an entity element in a bound action via `$self` and not only via explicit binding parameter

package/bin/cdsse.js

@@ -158,6 +158,9 @@ function tokensAt( buf, _offset, col, symbol ) {
     else if (/^[A-Z_]+$/.test( n )) {
       console.log( n.toLowerCase(), 'keyword' );
     }
+    else if (n === 'Boolean') {
+      console.log( 'true keyword\nfalse keyword' );
+    }
     else if (n !== 'Identifier') {
       console.log( n, 'unknown' );
     }
@@ -185,6 +188,7 @@ function offset( buf, alsoSuffix ) { // for line and column
       return false;
   }
   let cursor = pos + column - 1;
+  // eslint-disable-next-line sonarjs/slow-regex
   const prefix = /[a-z_0-9$]*$/i.exec( buf.substring( pos, cursor ) ).index + pos;
   const col = column + prefix - cursor;
   if (alsoSuffix)

package/bin/cdsv2m.js

@@ -37,7 +37,8 @@ function ria() {
   // 'Choose via $(ANNO) one of $(SORTED_ARTS) as redirection target for $(TARGET) in … $(ART) otherwise'
   // NOTE: regex match on message text not for productive code!
   for (const msgObj of msgs) {
-    const matches = msgObj.message.match( /["“][^"”]+["”]/g );
+    // eslint-disable-next-line sonarjs/slow-regex
+    const matches = msgObj.message.match( /["“][^"”]+["”]/ug );
     matches.slice( 1, -2 ).forEach( (name) => {
       annotates[name.slice( 1, -1 )] = true;
     } );

package/doc/Versioning.md

@@ -19,9 +19,9 @@ expect from version updates.
 ## Public API
 
 According to [§1] of SemVer, a public API must be made available.  Our public
-API is available through `lib/main.js` which can be used by
-`const compiler = require('@sap/cds-compiler');` in NodeJS or, if you use
-ES modules, with `import compiler from "@sap/cds-compiler";`
+API is available through `lib/main.js` which can be used via
+`const compiler = require('@sap/cds-compiler');` in Node.js or, if you use
+ES modules, via `import compiler from "@sap/cds-compiler";`
 
 Furthermore, any exported property in `lib/main.js` whose name starts with `$`
 is _not_ part of the public API.
@@ -48,7 +48,7 @@ only later upgraded to errors.
 “patch versions” can be applied.
 
 We may introduce new compiler-checks that might make your compilation fail if
-we detect invalid CDS code.
+we detect invalid CDS code.  OData vocabularies may be updated.
 
 ## Beta Flags
 

package/lib/api/options.js

@@ -32,6 +32,7 @@ const publicOptionsNewAPI = [
   'betterSqliteSessionVariables',
   'fewerLocalizedViews',
   'withHanaAssociations',
+  'standardDatabaseFunctions',
   // ODATA
   'odataOpenapiHints',
   'edm4OpenAPI',

package/lib/base/builtins.js

@@ -29,7 +29,7 @@ const propagationRules = {
   '@sql.append': 'never',
   '@sql.prepend': 'never',
   '@sql.replace': 'never',
-}
+};
 
 /**
  * Checks whether the given absolute path is inside a reserved namespace.
@@ -105,4 +105,4 @@ module.exports = {
   isBuiltinType,
   isMagicVariable,
   isAnnotationExpression,
-}
+};

package/lib/base/dictionaries.js

@@ -84,9 +84,8 @@ function dictAddArray( dict, name, entry, messageCallback ) {
 function dictFirst( dict ) {
   if (!dict)
     return dict;
-  for (const name in dict) {
+  for (const name in dict)
     return dict[name];
-  }
   return undefined;
 }
 

package/lib/base/keywords.js

@@ -1,5 +1,7 @@
 'use strict';
 
+/* eslint @stylistic/js/no-multi-spaces: 0 */
+
 const { functionsWithoutParentheses, cdlKeywords } = require('../parsers/identifiers');
 
 module.exports = {
@@ -713,7 +715,7 @@ module.exports = {
     'SYSTIME',            'SYSTIMESTAMP',      'SYSUUID',
     'TOP',                'TRAILING',          'UNION',
     'USING',              'VALUES',            'WHEN',
-    'WHERE',              'WHILE',             'WITH'
+    'WHERE',              'WHILE',             'WITH',
   ],
   // Postgres keywords, used for smart quoting in to-sql.plain.postgres
   // Taken from https://www.postgresql.org/docs/current/sql-keywords-appendix.html

package/lib/base/lazyload.js

@@ -22,7 +22,7 @@ function createLazyload( callingModule ) {
         return module[name];
       },
     });
-  }
+  };
 }
 
 module.exports = createLazyload;