@sap/cds-compiler 2.7.0 → 2.11.2

package/CHANGELOG.md

@@ -7,6 +7,173 @@
 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 2.11.2 - 2021-12-06
+
+### Fixed
+
+- to.sql/hdi/hdbcds:
+  + No foreign key constraint will be rendered for managed `composition of one` if annotated with `@assert.integrity: false`
+  + Correctly handle managed associations with other managed associations as foreign keys in conjunction with `exists`
+
+## Version 2.11.0 - 2021-12-02
+
+### Added
+
+- Option `defaultBinaryLength` to set a `length` type facet for all definitions with type `cds.Binary`. This option
+  overrides the default binary length in the database backends and is also used as `MaxLength` attribute in Odata.
+- If doc-comments are ignored by the compiler, an info message is now emitted.  A doc-comment is ignored,
+  if it can't be assigned to an artifact.  For example for two subsequent doc-comments, the first doc-comment
+  is ignored.  To suppress these info messages, explicitly set option `docComment` to `false`.
+- `cdsc`:
+  - `cdsc explain list` can now be used to get a list of message IDs with explanation texts.
+  - `cdsc` now respects the environment variable `NO_COLOR`. If set, no ANSI escape codes will be used.
+    Can be overwritten by `cdsc --color always`.
+- to.sql/hdi: Support SQL Window Functions
+- to.sql/hdi/hdbcds:
+  + Support configuration of `$session` and `$user` via option `variableReplacements`.
+  + Restricted support for SQL foreign key constraints if option `assertIntegrityType` is set to `"DB"`.
+    The behavior of this feature might change in the future.
+
+### Changed
+
+- Updated OData vocabularies 'Common' and 'UI'.
+- to.sql/hdi/hdbcds: The default length of `cds.Binary` is set to `5000` similar to `cds.String`.
+
+### Removed
+
+- to.hdbcds: Doc comments on view columns are not rendered anymore. Doc comments on string literals will make the deployment fail
+  as the SAP HANA CDS compiler concatenates the doc comment with the string literal. Besides that, doc comments on view columns
+  are not transported to the database by SAP HANA CDS.
+- to.hdbcds/sql/hdi: Forbid associations in filters after `exists` (except for nested `exists`), as the final behavior is not yet specified.
+
+### Fixed
+
+- CSN parser: doc-comment extensions are no longer ignored.
+- Properly check for duplicate annotation definitions.
+- Correctly apply annotations on inherited enum symbols.
+- Correctly apply annotations on elements in an inherited structure array.
+- Fix a bug in API `defaultStringLength` value evaluation.
+- Fix crash if named arguments are used in a function that's inside a `CASE` statement.
+- to.sql/hdi/hdbcds:
+  + Properly flatten ad-hoc defined elements in `returns` / `params` of `actions` and `functions`.
+  + Correctly handle `*` in non-first position.
+  + Correctly handle action return types
+  + Correctly handle mixin association named `$self`
+- to.cdl: doc-comments are no longer rendered twice.
+- to.edm(x):
+  + Fix a bug in V2/V4 partner ship calculation.
+  + Remove warning of unknown types for Open Types in `@Core.Dictionary`.
+  + An empty CSN no longer results in a JavaScript type error
+
+## Version 2.10.4 - 2021-11-05
+
+### Fixed
+
+- to.sql/hdi/hdbcds:
+  + Correctly complain about `exists` in conjunction with non-associations/compositions
+  + Don't resolve types in action returns, as this causes issues with $self-resolution
+
+- to.edm(x): Be robust against transitively untyped keys in stacked view hierarchies
+
+## Version 2.10.2 - 2021-10-29
+
+### Fixed
+
+- to.sql/hdi/hdbcds: Correctly handle `exists` in conjunction with mixin-associations
+
+## Version 2.10.0 - 2021-10-28
+
+### Added
+
+- Support arbitrary paths after `$user` - similar to `$session`.
+- Support scale `floating` and `variable` for `cds.Decimal` in CDL and CSN. Backend specific handling is descibed in their sections.
+- Allow select item wildcard (`*`) in a `select`/`projection` at any position, not just the first.
+
+- to.edm(x):
+  + In Odata V4 generate transitive navigation property binding paths along containment hierarchies and terminate on the
+    first non-containment association. The association target is either an explicit Edm.EntitySet in the same EntityContainer
+    or in a referred EntityContainer (cross service references) or an implicit EntitySet identified by the containment path
+    originating from an explicit EntitySet. This enhancement has an observable effect only in structured format with containment
+    turned on.
+  + Support for scales `variable` and `floating`:
+    + V4: `variable` and `floating` are rendered as `Scale="variable"`. Since V4 does not support `floating`, it is aproximated as `variable`.
+    + V2: `variable` and `floating` are announced via property annotation `sap:variable-scale="true"`
+  
+- to.sql/hdi/hdbcds:
+  + Reject scale `floating` and `variable`.
+  + Reject arbitrary `$user` or `$session` paths that cannot be translated to valid SQL.
+  + Following a valid `exists`, further `exists` can be used inside of the filter-expression: `exists assoc[exists another[1=1]]`
+  + `exists` can now be followed by more than one association step.
+  `exists assoc.anotherassoc.moreassoc` is semantically equivalent to `exists assoc[exists anotherassoc[exists moreassoc]]`
+
+### Changed
+
+- to.odata: Inform when overwriting draft action annotations like `@Common.DraftRoot.ActivationAction`.
+
+## Version 2.9.0 - 2021-10-15
+
+### Changed
+
+- to.edm(x): Raise `odata-spec-violation-type` to a downgradable error.
+
+### Fixed
+
+- to.edm(x):
+  + Fix a bug in annotation propagation to foreign keys.
+  + Don't render annotations for not rendered stream element in V2.
+- to.hdi:
+  + for naming mode "hdbcds" and "quoted" parameter definitions are not quoted anymore.
+- to.hdi/sql/hdbcds:
+  + Correctly handle explicit and implicit alias during flattening.
+  + Raise an error for `@odata.draft.enabled` artifacts with elements without types - instead of crashing with internal assertions.
+
+## Version 2.8.0 - 2021-10-07
+
+### Added
+
+- Allow defining unmanaged associations in anonymous aspects of compositions.
+- Enable extensions of anonymous aspects for managed compositions of aspects.
+- When the option `addTextsLanguageAssoc` is set to true and
+  the model contains an entity `sap.common.Languages` with an element `code`,
+  all generated texts entities additionally contain an element `language`
+  which is an association to `sap.common.Languages` using element `local`.
+- for.odata:
+  + In `--odata-format=flat`, structured view parameters are flattened like elements.
+- to.hdbcds
+  + Use "smart quotes" for naming mode "plain" - automatically quote identifier which are reserved keywords or non-regular.
+
+### Changed
+
+- for.odata:
+  + In `--data-format=structured`, anonymous sub elements of primary keys and parameters are set to `notNull:true`,
+    an existing `notNull` attribute is _not_ overwritten. Referred named types are _not_ modified.
+- to.edm(x):
+  + Improve specification violation checks of (nested) keys:
+    + All (sub-)elements must be `Nullable: false` (error).
+    + Must represent a single value (error).
+    + In V4 must be a specification compliant Edm.PrimitiveType (warning).
+- to.hdi/hdbcds/sql: $user.\<xy\> now has \<xy\> added as alias - "$user.\<xy\> as \<xy\>"
+
+### Fixed
+
+- Properly generate auto-exposed entities for associations in parameters.
+- Correctly apply extensions to anonymous array item types.
+- Correctly apply/render annotations to anonymous action return types.
+- With CSN flavor `plain` (`gensrc`), correctly render annotations on elements
+  of referred structure types as `annotate` statements in the CSN's `extensions` property.
+- to.cdl:
+  + Correctly render extensions on array item types
+  + Correctly render annotations on action return types
+- to/for: Correctly handle CSN input where the prototype of objects is not the "default"
+- to.hdi:
+  + for naming mode "hdbcds" and "quoted" parameter definitions are now quoted.
+  + for naming mode "plain", smart quotation is applied to parameter definitions if they are reserved words.
+- to.hdi/hdbcds/sql:
+  + Ensure that cdl-style casts to localized types do not lose their localized property
+  + Fix a small memory leak during rendering of SQL/HDBCDS.
+- to.edm(x): Remove ambiguous `Partner` attribute from `NavigationProperty`. A forward association referred
+  to by multiple backlinks (`$self` comparisons) is no longer partner to an arbitrary backlink.
+
 ## Version 2.7.0 - 2021-09-22
 
 ### Added

package/bin/cdsc.js

@@ -26,8 +26,10 @@ const path = require('path');
 const { reveal } = require('../lib/model/revealInternalProperties');
 const enrichCsn = require('../lib/model/enrichCsn');
 const { optionProcessor } = require('../lib/optionProcessor');
-const { explainMessage, hasMessageExplanation, sortMessages } = require('../lib/base/messages');
-const term = require('../lib/utils/term');
+const {
+  explainMessage, hasMessageExplanation, sortMessages, messageIdsWithExplanation,
+} = require('../lib/base/messages');
+const { term } = require('../lib/utils/term');
 const { splitLines } = require('../lib/utils/file');
 const { addLocalizationViews } = require('../lib/transform/localized');
 const { availableBetaFlags } = require('../lib/base/model');
@@ -52,9 +54,11 @@ function remapCmdOptions(options, cmdOptions) {
         options.sqlMapping = value;
         break;
       case 'user':
-        if (!options.magicVars)
-          options.magicVars = {};
-        options.magicVars.user = value;
+        if (!options.variableReplacements)
+          options.variableReplacements = {};
+        if (!options.variableReplacements.$user)
+          options.variableReplacements.$user = {};
+        options.variableReplacements.$user.id = value;
         break;
       case 'dialect':
         options.sqlDialect = value;
@@ -63,9 +67,11 @@ function remapCmdOptions(options, cmdOptions) {
         options.odataVersion = value;
         break;
       case 'locale':
-        if (!options.magicVars)
-          options.magicVars = {};
-        options.magicVars.locale = value;
+        if (!options.variableReplacements)
+          options.variableReplacements = {};
+        if (!options.variableReplacements.$user)
+          options.variableReplacements.$user = {};
+        options.variableReplacements.$user.locale = value;
         break;
       default:
         options[key] = value;
@@ -124,8 +130,6 @@ try {
       global.cds = {};
     global.cds.home = cmdLine.options.cdsHome;
   }
-  // Default color mode is 'auto'
-  term.useColor(cmdLine.options.color || 'auto');
 
   // Set default command if required
   cmdLine.command = cmdLine.command || 'toCsn';
@@ -137,10 +141,7 @@ try {
   if (cmdLine.command === 'parseCdl') {
     cmdLine.command = 'toCsn';
     cmdLine.options.parseCdl = true;
-    if (cmdLine.args.files.length > 1) {
-      const err = `'parseCdl' expects exactly one file! ${cmdLine.args.files.length} provided.`;
-      displayUsage(err, optionProcessor.commands.parseCdl.helpText, 2);
-    }
+    cmdLine.args.files = [ cmdLine.args.file ];
   }
 
   if (cmdLine.options.directBackend)
@@ -155,6 +156,14 @@ try {
     });
   }
 
+  // remap string values for `assertIntegrity` option to boolean
+  if (cmdLine.options.assertIntegrity &&
+      cmdLine.options.assertIntegrity === 'true' ||
+      cmdLine.options.assertIntegrity === 'false'
+  )
+    cmdLine.options.assertIntegrity = Boolean(cmdLine.options.assertIntegrity);
+
+
   // Enable all beta-flags if betaMode is set to true
   if (cmdLine.options.betaMode)
     cmdLine.options.beta = availableBetaFlags;
@@ -231,6 +240,8 @@ function executeCommandLine(command, options, args) {
   if (options.out && options.out !== '-' && !fs.existsSync(options.out))
     fs.mkdirSync(options.out);
 
+  // Default color mode is 'auto'
+  const colorTerm = term(options.color || 'auto');
 
   // Add implementation functions corresponding to commands here
   const commands = {
@@ -393,14 +404,15 @@ function executeCommandLine(command, options, args) {
   }
 
   function explain() {
-    if (args.length !== 1)
-      displayUsage('Command \'explain\' expects exactly one message-id.', optionProcessor.commands.explain.helpText, 2);
+    if (args.messageId === 'list') {
+      console.log(messageIdsWithExplanation().join('\n'));
+      throw new ProcessExitError(0);
+    }
 
-    const id = args.files[0];
-    if (!hasMessageExplanation(id))
-      console.error(`Message '${id}' does not have an explanation!`);
+    if (!hasMessageExplanation(args.messageId))
+      console.error(`Message '${args.messageId}' does not have an explanation!`);
     else
-      console.log(explainMessage(id));
+      console.log(explainMessage(args.messageId));
   }
 
   // Display error messages in `err` resulting from a compilation.  Also set
@@ -464,16 +476,20 @@ function executeCommandLine(command, options, args) {
         hasAtLeastOneExplanation = hasAtLeastOneExplanation || main.hasMessageExplanation(msg.messageId);
         const name = msg.location && msg.location.file;
         const fullFilePath = name ? path.resolve('', name) : undefined;
-        const context = fullFilePath && sourceLines(fullFilePath);
+        const context = fullFilePath ? sourceLines(fullFilePath) : [];
         log(main.messageStringMultiline(msg, {
-          normalizeFilename, noMessageId: !options.showMessageId, withLineSpacer: true, hintExplanation: true,
+          normalizeFilename,
+          noMessageId: !options.showMessageId,
+          withLineSpacer: true,
+          hintExplanation: true,
+          color: options.color,
         }));
         if (context)
-          log(main.messageContext(context, msg));
+          log(main.messageContext(context, msg, { color: options.color }));
         log(); // newline
       });
       if (options.showMessageId && hasAtLeastOneExplanation)
-        log(`${term.help('help')}: Messages marked with '…' have an explanation text. Use \`cdsc explain <message-id>\` for a more detailed error description.`);
+        log(`${colorTerm.help('help')}: Messages marked with '…' have an explanation text. Use \`cdsc explain <message-id>\` for a more detailed error description.`);
     }
     return model;
   }
@@ -549,10 +565,11 @@ function executeCommandLine(command, options, args) {
   }
 
   function catchErrors(err) {
+    // @ts-ignore
     if (err instanceof Error && err.hasBeenReported)
       return;
     console.error( '' );
-    console.error( 'INTERNAL ERROR: %s', err );
+    console.error( 'INTERNAL ERROR:' );
     console.error( util.inspect(err, false, null) );
     console.error( '' );
     process.exitCode = 70;

package/bin/cdsse.js

@@ -11,6 +11,7 @@
 // Planned are: gotoDefinition, highlight (for syntax highighting).
 
 /* eslint no-console:off */
+// @ts-nocheck
 
 'use strict';
 

package/doc/CHANGELOG_BETA.md

@@ -8,6 +8,16 @@ 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 2.11.0
+
+### Removed `foreignKeyConstraints`
+
+## Version 2.10.4
+
+### Fixed `nestedProjections`
+
+- to.sql/hdi/hdbcds: Correctly handle a `*` at the not-first place in the query
+
 ## Version 2.6.0
 
 ### Removed `pretransformedCSN`

package/lib/api/.eslintrc.json

@@ -14,6 +14,8 @@
     "jsdoc"
   ],
   "rules": {
+    // Does not recognize TS types
+    "jsdoc/no-undefined-types": "off",
     // eslint-plugin-jsdoc warning
     "jsdoc/require-property": 0,
     // =airbnb, >eslint:

package/lib/api/main.js

@@ -14,7 +14,7 @@ const { toSqlDdl } = require('../render/toSql');
 const { compareModels } = require('../modelCompare/compare');
 const sortViews = require('../model/sortViews');
 const { getResultingName } = require('../model/csnUtils');
-const timetrace = require('../utils/timetrace');
+const { timetrace } = require('../utils/timetrace');
 const { transformForHanaWithCsn } = require('../transform/forHanaNew');
 
 /**
@@ -135,7 +135,7 @@ function odataInternal(csn, internalOptions) {
  * Return a odata-transformed CSN
  *
  * @param {CSN.Model} csn Clean input CSN
- * @param {oDataOptions} [options={}] Options
+ * @param {ODataOptions} [options={}] Options
  * @returns {oDataCSN} Return an oData-pre-processed CSN
  */
 function odata(csn, options = {}) {
@@ -454,7 +454,7 @@ function hdbcds(csn, options = {}) {
  * Generate a edm document for the given service
  *
  * @param {CSN|oDataCSN} csn Clean input CSN or a pre-transformed CSN
- * @param {oDataOptions} [options={}] Options
+ * @param {ODataOptions} [options={}] Options
  * @returns {edm} The JSON representation of the service
  */
 function edm(csn, options = {}) {
@@ -484,7 +484,7 @@ edm.all = edmall;
  * Generate edm documents for all services
  *
  * @param {CSN|oDataCSN} csn Clean input CSN or a pre-transformed CSN
- * @param {oDataOptions} [options={}] Options
+ * @param {ODataOptions} [options={}] Options
  * @returns {edms} { <service>:<JSON representation>, ...}
  */
 function edmall(csn, options = {}) {
@@ -494,19 +494,17 @@ function edmall(csn, options = {}) {
   if (internalOptions.version === 'v2')
     error(null, null, 'OData JSON output is not available for OData V2');
 
-  let servicesAll;
-
   const result = {};
+  let oDataCsn = csn;
 
-  if (isPreTransformed(csn, 'odata')) {
+  if (isPreTransformed(csn, 'odata'))
     checkPreTransformedCsn(csn, internalOptions, relevantOdataOptions, warnAboutMismatchOdata, 'for.odata');
-    servicesAll = backends.preparedCsnToEdmAll(csn, internalOptions);
-  }
-  else {
-    const oDataCsn = odataInternal(csn, internalOptions);
-    servicesAll = backends.preparedCsnToEdmAll(oDataCsn, internalOptions);
-  }
-  const services = servicesAll.edmj;
+
+  else
+    oDataCsn = odataInternal(csn, internalOptions);
+
+  const servicesJson = backends.preparedCsnToEdmAll(oDataCsn, internalOptions);
+  const services = servicesJson.edmj;
   for (const serviceName in services) {
     const lEdm = services[serviceName];
     // FIXME: Why only metadata_json - isn't this rather a 'combined_json' ? If so, rename it!
@@ -518,7 +516,7 @@ function edmall(csn, options = {}) {
  * Generate a edmx document for the given service
  *
  * @param {CSN|oDataCSN} csn Clean input CSN or a pre-transformed CSN
- * @param {oDataOptions} [options={}] Options
+ * @param {ODataOptions} [options={}] Options
  * @returns {edmx} The XML representation of the service
  */
 function edmx(csn, options = {}) {
@@ -549,7 +547,7 @@ edmx.all = edmxall;
  * Generate edmx documents for all services
  *
  * @param {CSN|oDataCSN} csn Clean input CSN or a pre-transformed CSN
- * @param {oDataOptions} [options={}] Options
+ * @param {ODataOptions} [options={}] Options
  * @returns {edmxs} { <service>:<XML representation>, ...}
  */
 function edmxall(csn, options = {}) {
@@ -711,20 +709,6 @@ function publishCsnProcessor( processor, _name ) {
  * @property {Array} [messages] Allows collecting all messages in the options instead of printing them to stderr.
  */
 
-/**
- * Options available for all oData-based functions
- *
- * @typedef {object} oDataOptions
- * @property {object} [beta] Enable experimental features - not for productive use!
- * @property {boolean} [longAutoexposed=false] Deprecated: Produce long names (with underscores) for autoexposed entities
- * @property {Map<string, number>} [severities={}] Map of message-id and severity that allows setting the severity for the given message
- * @property {Array} [messages] Allows collecting all messages in the options instead of printing them to stderr.
- * @property {oDataVersion} [odataVersion='v4'] Odata version to use
- * @property {oDataFormat} [odataFormat='flat'] Wether to generate oData as flat or as structured. Structured only with v4.
- * @property {NamingMode} [sqlMapping='plain'] Naming mode to use
- * @property {string} [service] If a single service is to be rendered
- */
-
 /**
  * Options available for to.hdi
  *
@@ -755,9 +739,9 @@ function publishCsnProcessor( processor, _name ) {
  * @typedef {object} sqlOptions
  * @property {NamingMode} [sqlMapping='plain'] Naming mode to use
  * @property {SQLDialect} [sqlDialect='sqlite'] SQL dialect to use
- * @property {object} [magicVars] Object containing values for magic variables like "$user"
- * @property {string} [magicVars.locale] Value for the "$user.locale" in "sqlite" dialect
- * @property {string} [magicVars.user] Value for the "$user" variable in "sqlite" dialect
+ * @property {object} [variableReplacements] Object containing values for magic variables like "$user"
+ * @property {string} [variableReplacements.$user.locale] Value for the "$user.locale" variable
+ * @property {string} [variableReplacements.$user.id] Value for the "$userid" variable
  * @property {object} [beta] Enable experimental features - not for productive use!
  * @property {boolean} [longAutoexposed=false] Deprecated: Produce long names (with underscores) for autoexposed entities
  * @property {Map<string, number>} [severities={}] Map of message-id and severity that allows setting the severity for the given message

package/lib/api/options.js

@@ -10,18 +10,22 @@ const publicOptionsNewAPI = [
   // GENERAL
   'beta',
   'deprecated',
+  'addTextsLanguageAssoc',
   'localizedLanguageFallback',  // why can't I define the option type here?
   'severities',
   'messages',
   'withLocations',
+  'defaultBinaryLength',
   'defaultStringLength',
+  'csnFlavor',
   // DB
   'sqlDialect',
   'sqlMapping',
   'sqlChangeMode',
   'allowCsnDowngrade',
   'joinfk',
-  'magicVars',
+  'magicVars', // deprecated
+  'variableReplacements',
   // ODATA
   'odataVersion',
   'odataFormat',
@@ -45,9 +49,10 @@ const privateOptions = [
   'traceParserAmb',
   'testMode',
   'testSortCsn',
-  'constraintsNotEnforced',
-  'constraintsNotValidated',
-  'skipDbConstraints',
+  'integrityNotEnforced',
+  'integrityNotValidated',
+  'assertIntegrity',
+  'assertIntegrityType',
   'noRecompile',
   'internalMsg',
   'disableHanaComments',      // in case of issues with hana comment rendering
@@ -68,10 +73,11 @@ const overallOptions = publicOptionsNewAPI.concat(privateOptions);
  * @param {FlatOptions} [hardRequire={}] Hard requirements to enforce
  * @param {object} [customValidators] Custom validations to run instead of defaults
  * @param {string[]} [combinationValidators] Option combinations to validate
+ * @param {string} moduleName The called module, e.g. 'for.odata', 'to.hdi'. Needed to initialize the message functions
  * @returns {TranslatedOptions} General cds options
  */
 function translateOptions(input = {}, defaults = {}, hardRequire = {},
-                          customValidators = {}, combinationValidators = []) {
+                          customValidators = {}, combinationValidators = [], moduleName = '') {
   const options = Object.assign({}, defaults);
   const inputOptionNames = Object.keys(input);
   for (const name of overallOptions) {
@@ -90,6 +96,7 @@ function translateOptions(input = {}, defaults = {}, hardRequire = {},
   // Validate the filtered input options
   // only "new-style" options are here
   validate(options,
+           moduleName,
            // TODO: is there a better place to specify the type of option values?
            Object.assign( {
              localizedLanguageFallback: generateStringValidator([ 'none', 'coalesce' ]),
@@ -105,6 +112,10 @@ function translateOptions(input = {}, defaults = {}, hardRequire = {},
     mapToOldNames(optionName, optionValue);
   }
 
+  // Convenience for $user -> $user.id replacement
+  if (options.variableReplacements && options.variableReplacements.$user && typeof options.variableReplacements.$user === 'string')
+    options.variableReplacements.$user = { id: options.variableReplacements.$user };
+
   /**
    * Map a new-style option to it's old format
    *
@@ -126,6 +137,7 @@ function translateOptions(input = {}, defaults = {}, hardRequire = {},
       case 'sqlMapping':
         options.names = optionValue;
         break;
+      // No need to remap variableReplacements here - we use the new mechanism with that directly
       case 'magicVars':
         if (optionValue.user)
           options.user = optionValue.user;
@@ -141,11 +153,11 @@ function translateOptions(input = {}, defaults = {}, hardRequire = {},
 
 module.exports = {
   to: {
-    cdl: options => translateOptions(options),
+    cdl: options => translateOptions(options, undefined, undefined, undefined, undefined, 'to.cdl'),
     sql: (options) => {
       const hardOptions = { src: 'sql' };
       const defaultOptions = { sqlMapping: 'plain', sqlDialect: 'plain' };
-      const processed = translateOptions(options, defaultOptions, hardOptions, undefined, [ 'sql-dialect-and-naming' ]);
+      const processed = translateOptions(options, defaultOptions, hardOptions, undefined, [ 'sql-dialect-and-naming' ], 'to.sql');
 
       const result = Object.assign({}, processed);
       result.toSql = Object.assign({}, processed);
@@ -155,7 +167,7 @@ module.exports = {
     hdi: (options) => {
       const hardOptions = { src: 'hdi' };
       const defaultOptions = { sqlMapping: 'plain', sqlDialect: 'hana' };
-      const processed = translateOptions(options, defaultOptions, hardOptions, { sqlDialect: generateStringValidator([ 'hana' ]) });
+      const processed = translateOptions(options, defaultOptions, hardOptions, { sqlDialect: generateStringValidator([ 'hana' ]) }, undefined, 'to.hdi');
 
       const result = Object.assign({}, processed);
       result.toSql = Object.assign({}, processed);
@@ -164,7 +176,7 @@ module.exports = {
     },
     hdbcds: (options) => {
       const defaultOptions = { sqlMapping: 'plain', sqlDialect: 'hana' };
-      const processed = translateOptions(options, defaultOptions, {}, { sqlDialect: generateStringValidator([ 'hana' ]) });
+      const processed = translateOptions(options, defaultOptions, {}, { sqlDialect: generateStringValidator([ 'hana' ]) }, undefined, 'to.hdbcds');
 
       const result = Object.assign({}, processed);
       result.forHana = Object.assign({}, processed);
@@ -174,7 +186,7 @@ module.exports = {
     edm: (options) => {
       const hardOptions = { json: true, combined: true };
       const defaultOptions = { odataVersion: 'v4', odataFormat: 'flat' };
-      const processed = translateOptions(options, defaultOptions, hardOptions, { odataVersion: generateStringValidator([ 'v4' ]) }, [ 'valid-structured' ]);
+      const processed = translateOptions(options, defaultOptions, hardOptions, { odataVersion: generateStringValidator([ 'v4' ]) }, [ 'valid-structured' ], 'to.edm');
 
       const result = Object.assign({}, processed);
       result.toOdata = Object.assign({}, processed);
@@ -186,7 +198,7 @@ module.exports = {
       const defaultOptions = {
         odataVersion: 'v4', odataFormat: 'flat',
       };
-      const processed = translateOptions(options, defaultOptions, hardOptions, undefined, [ 'valid-structured' ]);
+      const processed = translateOptions(options, defaultOptions, hardOptions, undefined, [ 'valid-structured' ], 'to.edmx');
 
       const result = Object.assign({}, processed);
       result.toOdata = Object.assign({}, processed);
@@ -198,7 +210,7 @@ module.exports = {
 
     odata: (options) => {
       const defaultOptions = { odataVersion: 'v4', odataFormat: 'flat' };
-      const processed = translateOptions(options, defaultOptions, undefined, undefined, [ 'valid-structured' ]);
+      const processed = translateOptions(options, defaultOptions, undefined, undefined, [ 'valid-structured' ], 'for.odata');
 
       const result = Object.assign({}, processed);
       result.toOdata = Object.assign({}, processed);
@@ -208,7 +220,7 @@ module.exports = {
     },
     hana: (options) => {
       const defaultOptions = { sqlMapping: 'plain', sqlDialect: 'hana' };
-      const processed = translateOptions(options, defaultOptions);
+      const processed = translateOptions(options, defaultOptions, undefined, undefined, undefined, 'for.hana');
 
       const result = Object.assign({}, processed);
       result.forHana = Object.assign({}, processed);