@cap-js/cds-typer 0.32.0 → 0.33.0

package/cds-plugin.js

@@ -4,10 +4,10 @@ const cds = require('@sap/cds')
 const util = require('util')
 const exec = util.promisify(require('child_process').exec)
 const typer = require('./lib/compile')
-
 const { fs, path } = cds.utils
 const DEBUG = cds.debug('cli|build')
 const BUILD_CONFIG = 'tsconfig.cdsbuild.json'
+const { configuration } = require('./lib/config')
 
 /**
  * Check if the project is a TypeScript project by looking for a dependency on TypeScript.
@@ -52,93 +52,103 @@ const rmFiles = async (dir, exts) => fs.existsSync(dir)
     )
     : undefined
 
-// FIXME: remove once cds7 has been phased out
-if (!cds?.version || cds.version < '8.0.0') {
-    DEBUG?.('typescript build task requires @sap/cds-dk version >= 8.0.0, skipping registration')
-    return
-}
-
-// requires @sap/cds-dk version >= 7.5.0
-cds.build?.register?.('typescript', class extends cds.build.Plugin {
-    static taskDefaults = { src: '.' }
-    static hasTask() { return isTypeScriptProject() }
-
-    // lower priority than the nodejs task
-    get priority() { return -1 }
-
-    get #appFolder () { return cds?.env?.folders?.app ?? 'app' }
-
-    /**
-     * cds.env > tsconfig.compilerOptions.paths > '@cds-models' (default)
-     */
-    get #modelDirectoryName () {
-        const outputDirectory = cds.env.typer?.outputDirectory
-        if (outputDirectory) return outputDirectory
-        try {
-            // expected format: { '#cds-models/*': [ './@cds-models/*' ] }
-            //                                          ^^^^^^^^^^^
-            //                             relevant part - may be changed by user
-            const config = JSON.parse(fs.readFileSync ('tsconfig.json', 'utf8'))
-            const alias = config.compilerOptions.paths['#cds-models/*'][0]
-            const directory = alias.match(/(?:\.\/)?(.*)\/\*/)[1]
-            return normalize(directory)  // could contain forward slashes in tsconfig.json
-        } catch {
-            DEBUG?.('tsconfig.json not found, not parsable, or inconclusive. Using default model directory name')
-        }
-        return '@cds-models'
+// IIFE to be able to return early
+;(() => {
+    // FIXME: remove once cds7 has been phased out
+    if (!cds?.version || cds.version < '8.0.0') {
+        DEBUG?.('typescript build task requires @sap/cds-dk version >= 8.0.0, skipping registration')
+        return
     }
 
-    init() {
-        this.task.dest = path.join(cds.root, cds.env.build.target, cds.env.folders.srv)
+    // by checking configuration instead of cds.env, we make sure the user can set
+    // this configuration in both camelCase and snake_case.
+    if (configuration.buildTask === false) {  // unset is considered true
+        DEBUG?.('skipping typescript build task registration based on configuration option')
+        return
     }
 
-    async #runCdsTyper () {
-        DEBUG?.('running cds-typer')
-        cds.env.typer ??= {}
-        cds.env.typer.outputDirectory ??= this.#modelDirectoryName
-        await typer.compileFromFile('*')
-    }
+    // requires @sap/cds-dk version >= 7.5.0
+    cds.build?.register?.('typescript', class extends cds.build.Plugin {
+        static taskDefaults = { src: '.' }
+        static hasTask() { return isTypeScriptProject() }
+
+        // lower priority than the nodejs task
+        get priority() { return -1 }
+
+        get #appFolder () { return cds?.env?.folders?.app ?? 'app' }
+
+        /**
+         * cds.env > tsconfig.compilerOptions.paths > '@cds-models' (default)
+         */
+        get #modelDirectoryName () {
+            const outputDirectory = cds.env.typer?.outputDirectory
+            if (outputDirectory) return outputDirectory
+            try {
+                // expected format: { '#cds-models/*': [ './@cds-models/*' ] }
+                //                                          ^^^^^^^^^^^
+                //                             relevant part - may be changed by user
+                const config = JSON.parse(fs.readFileSync ('tsconfig.json', 'utf8'))
+                const alias = config.compilerOptions.paths['#cds-models/*'][0]
+                const directory = alias.match(/(?:\.\/)?(.*)\/\*/)[1]
+                return normalize(directory)  // could contain forward slashes in tsconfig.json
+            } catch {
+                DEBUG?.('tsconfig.json not found, not parsable, or inconclusive. Using default model directory name')
+            }
+            return '@cds-models'
+        }
 
-    async #buildWithConfig () {
-    // possibly referencing their tsconfig.json via "extends", specifying the "compilerOptions.outDir" and
-    // manually adding irrelevant folders (read: gen/ and app/) to the "exclude" array.
-        DEBUG?.(`building with config ${BUILD_CONFIG}`)
-        return exec(`npx tsc --project ${BUILD_CONFIG}`)
-    }
+        init() {
+            this.task.dest = path.join(cds.root, cds.env.build.target, cds.env.folders.srv)
+        }
 
-    async #buildWithoutConfig () {
-        DEBUG?.('building without config')
-        // this will include gen/ that was created by the nodejs task
-        // _within_ the project directory. So we need to remove it afterwards.
-        await exec(`npx tsc --outDir "${this.task.dest.replace(/\\/g, '/')}"`) // see https://github.com/cap-js/cds-typer/issues/374
-        rmDirIfExists(path.join(this.task.dest, cds.env.build.target))
-        rmDirIfExists(path.join(this.task.dest, this.#appFolder))
-    }
+        async #runCdsTyper () {
+            DEBUG?.('running cds-typer')
+            cds.env.typer ??= {}
+            cds.env.typer.outputDirectory ??= this.#modelDirectoryName
+            await typer.compileFromFile('*')
+        }
 
-    async #copyCleanModel (buildDirCdsModels) {
-    // copy models again, to revert transpilation thereof.
-    // We only need the index.js files in un-transpiled form.
-        await this.copy(this.#modelDirectoryName).to(buildDirCdsModels)
-        await rmFiles(buildDirCdsModels, ['.ts'])
-    }
+        async #buildWithConfig () {
+        // possibly referencing their tsconfig.json via "extends", specifying the "compilerOptions.outDir" and
+        // manually adding irrelevant folders (read: gen/ and app/) to the "exclude" array.
+            DEBUG?.(`building with config ${BUILD_CONFIG}`)
+            return exec(`npx tsc --project ${BUILD_CONFIG}`)
+        }
 
-    async build() {
-        await this.#runCdsTyper()
-        const buildDirCdsModels = path.join(this.task.dest, this.#modelDirectoryName)
-        // remove the js files generated by the nodejs buildtask,
-        // leaving only json, cds, and other static files
-        await rmFiles(this.task.dest, ['.js', '.ts'])
-
-        try {
-            await (buildConfigExists()
-                ? this.#buildWithConfig()
-                : this.#buildWithoutConfig()
-            )
-        } catch (error) {
-            throw error.stdout
-                ? new Error(error.stdout)
-                : error
+        async #buildWithoutConfig () {
+            DEBUG?.('building without config')
+            // this will include gen/ that was created by the nodejs task
+            // _within_ the project directory. So we need to remove it afterwards.
+            await exec(`npx tsc --outDir "${this.task.dest.replace(/\\/g, '/')}"`) // see https://github.com/cap-js/cds-typer/issues/374
+            rmDirIfExists(path.join(this.task.dest, cds.env.build.target))
+            rmDirIfExists(path.join(this.task.dest, this.#appFolder))
         }
-        this.#copyCleanModel(buildDirCdsModels)
-    }
-})
+
+        async #copyCleanModel (buildDirCdsModels) {
+        // copy models again, to revert transpilation thereof.
+        // We only need the index.js files in un-transpiled form.
+            await this.copy(this.#modelDirectoryName).to(buildDirCdsModels)
+            await rmFiles(buildDirCdsModels, ['.ts'])
+        }
+
+        async build() {
+            await this.#runCdsTyper()
+            const buildDirCdsModels = path.join(this.task.dest, this.#modelDirectoryName)
+            // remove the js files generated by the nodejs buildtask,
+            // leaving only json, cds, and other static files
+            await rmFiles(this.task.dest, ['.js', '.ts'])
+
+            try {
+                await (buildConfigExists()
+                    ? this.#buildWithConfig()
+                    : this.#buildWithoutConfig()
+                )
+            } catch (error) {
+                throw error.stdout
+                    ? new Error(error.stdout)
+                    : error
+            }
+            this.#copyCleanModel(buildDirCdsModels)
+        }
+    })
+})()

package/lib/cli.js

@@ -182,7 +182,7 @@ const flags = enrichFlagSchema({
     inlineDeclarations: {
         desc: `Whether to resolve inline type declarations${EOL}flat: (x_a, x_b, ...)${EOL}or structured: (x: {a, b}).`,
         allowed: ['flat', 'structured'],
-        default: 'structured'
+        default: 'flat'
     },
     propertiesOptional: parameterTypes.boolean({
         desc: `If set to true, properties in entities are${EOL}always generated as optional (a?: T).`,
@@ -192,11 +192,19 @@ const flags = enrichFlagSchema({
         desc: `If set to true, floating point properties are generated${EOL}as IEEE754 compatible '(number | string)' instead of 'number'.`,
         default: 'false'
     }),
+    legacyBinaryTypes: parameterTypes.boolean({
+        desc: `If set to true, Binary and LargeBinary are generated${EOL}as strings.`,
+        default: 'false'
+    }),
     targetModuleType: {
         desc: `Output format for generated .js files.${EOL}Setting it to auto tries to derive the module type from${EOL}the package.json and falls back to CJS.`,
         allowed: ['esm', 'cjs', 'auto'],
         default: 'auto'
-    }
+    },
+    buildTask: parameterTypes.boolean({
+        desc: `If set to true, the typescript build task will not be registered/ executed.${EOL}This value must be set in your project configuration.${EOL}Passing it as parameter to the cds-typer CLI has no effect.`,
+        default: 'true'
+    })
 })
 
 const hint = () => 'Missing or invalid parameter(s). Call with --help for more details.'

package/lib/components/basedefs.js

@@ -81,6 +81,8 @@ export type CdsTime = ${timeRegex};
  * @see {@link CdsDate}
  */
 export type CdsTimestamp = string;
+
+export type CdsMap = { [key: string]: unknown };
 `)
 
 module.exports = { baseDefinitions }

package/lib/file.js

@@ -420,10 +420,6 @@ class SourceFile extends File {
      */
     getImports() {
         const buffer = new Buffer()
-        if (this.services.names.length) {
-            // currently only needed to extend cds.Service and would trigger unused-variable-errors in strict configs
-            buffer.add('import cds from \'@sap/cds\'') // TODO should go to visitor#printService, but can't express this as Path
-        }
         const file = configuration.targetModuleType === 'esm'
             ? '/index.js'
             : ''

package/lib/resolution/builtin.js

@@ -6,9 +6,9 @@ class BuiltinResolver {
     #builtins = {
         UUID: 'string',
         String: 'string',
-        Binary: 'string',
+        Binary: 'Buffer',
         LargeString: 'string',
-        LargeBinary: 'Buffer | string | {value: import("stream").Readable, $mediaContentType: string, $mediaContentDispositionFilename?: string, $mediaContentDispositionType?: string}',
+        LargeBinary: 'import("stream").Readable',
         Vector: 'string',
         Integer: 'number',
         UInt8: 'number',
@@ -21,6 +21,7 @@ class BuiltinResolver {
         Float: 'number',
         Double: 'number',
         Boolean: 'boolean',
+        Map: '__.CdsMap',
         // note: the date-related types are strings on purpose, which reflects their runtime behaviour
         Date: '__.CdsDate',  // yyyy-mm-dd
         DateTime: '__.CdsDateTime', // yyyy-mm-dd + time + TZ (precision: seconds)
@@ -34,14 +35,19 @@ class BuiltinResolver {
     /**
      * @param {object} options - additional resolution options
      * @param {boolean} [options.IEEE754Compatible] - if true, the Decimal, DecimalFloat, Float, and Double types are also allowed to be strings
+     * @param {boolean} [options.legacyBinaryTypes] - if true, the Binary and LargeBinary types are strings
      */
-    constructor ({ IEEE754Compatible } = {}) {
+    constructor ({ IEEE754Compatible, legacyBinaryTypes } = {}) {
         if (IEEE754Compatible) {
             this.#builtins.Decimal = '(number | string)'
             this.#builtins.DecimalFloat = '(number | string)'
             this.#builtins.Float = '(number | string)'
             this.#builtins.Double = '(number | string)'
         }
+        if (legacyBinaryTypes) {
+            this.#builtins.Binary = 'string'
+            this.#builtins.LargeBinary = 'Buffer | string | {value: import("stream").Readable, $mediaContentType: string, $mediaContentDispositionFilename?: string, $mediaContentDispositionType?: string}'
+        }
         this.#builtins = Object.freeze(this.#builtins)
     }
 

package/lib/resolution/resolver.js

@@ -32,7 +32,7 @@ class Resolver {
         this.visitor = visitor
 
         /** @type {BuiltinResolver} */
-        this.builtinResolver = new BuiltinResolver({ IEEE754Compatible: configuration.IEEE754Compatible })
+        this.builtinResolver = new BuiltinResolver({ IEEE754Compatible: configuration.IEEE754Compatible, legacyBinaryTypes: configuration.legacyBinaryTypes })
 
         /** @type {Library[]} */
         this.libraries = [new Library(require.resolve('../../library/cds.hana.ts'))]
@@ -288,6 +288,8 @@ class Resolver {
         const typeInfo = this.resolveType(element, file, options)
         const cardinality = getMaxCardinality(element)
 
+        /** @type {string|undefined} */
+        let typeNamespaceIdent = undefined
         let typeName = typeInfo.plainName ?? typeInfo.type
 
         // only applies to builtin types, because the association/ composition _themselves_ are the (builtin) types we are checking, not their generic parameter!
@@ -333,9 +335,10 @@ class Resolver {
                 if (!parent.isCwd(file.path.asDirectory())) {
                     file.addImport(parent)
                     // prepend namespace
-                    typeName = `${parent.asIdentifier()}.${typeName}`
-                    typeInfo.inflection.singular = `${parent.asIdentifier()}.${typeInfo.inflection.singular}`
-                    typeInfo.inflection.plural = `${parent.asIdentifier()}.${typeInfo.inflection.plural}`
+                    typeNamespaceIdent = parent.asIdentifier()
+                    typeName = [typeNamespaceIdent, typeName].join('.')
+                    typeInfo.inflection.singular = [typeNamespaceIdent, typeInfo.inflection.singular].join('.')
+                    typeInfo.inflection.plural = [typeNamespaceIdent, typeInfo.inflection.plural].join('.')
                 }
 
                 if (element.type.ref?.length > 1) {
@@ -362,12 +365,23 @@ class Resolver {
         // handle typeof (unless it has already been handled above)
         const target = element.target?.name ?? element.type?.ref?.join('.') ?? element.type
         if (target && !typeInfo.isDeepRequire) {
-            const { propertyAccess, scope } =  this.visitor.entityRepository.getByFq(target) ?? {}
-            if (scope?.length) {
+            const { propertyAccess, scope } = this.visitor.entityRepository.getByFq(target) ?? {}
+            if (scope?.length && typeInfo.inflection) {
+                let { singular, plural } = typeInfo.inflection
+                // remove already added namespace, so the scope is added after the namespace
+                // i.e. _common.Book.texts instead of Book._common.texts
+                if (typeNamespaceIdent) {
+                    if (singular.startsWith(typeNamespaceIdent)) {
+                        singular = singular.substring(typeNamespaceIdent.length+1)
+                    }
+                    if (plural.startsWith(typeNamespaceIdent)) {
+                        plural = plural.substring(typeNamespaceIdent.length+1)
+                    }
+                }
                 // update inflections with proper prefix, e.g. Books.text, Books.texts
                 typeInfo.inflection = {
-                    singular: [...scope, typeInfo.inflection?.singular].join('.'),
-                    plural: [...scope, typeInfo.inflection?.plural].join('.')
+                    singular: [typeNamespaceIdent, ...scope, singular].filter(Boolean).join('.'),
+                    plural: [typeNamespaceIdent,...scope, plural].filter(Boolean).join('.')
                 }
             } else if (propertyAccess?.length) {
                 const element = target.slice(0, -propertyAccess.join('.').length - 1)

package/lib/typedefs.d.ts

@@ -206,6 +206,10 @@ export module config {
          */
         IEEE754Compatible: boolean
         targetModuleType: 'cjs' | 'esm' | 'auto'
+        /**
+         * `legacyBinaryTypes = true` -> Binary and LargeBinary are generated as `string` and a union type respectively
+         */
+        legacyBinaryTypes: boolean
     }
 }
 

package/lib/visitor.js

@@ -531,17 +531,21 @@ class Visitor {
         const { namespace } = this.entityRepository.getByFqOrThrow(fq)
         const file = this.fileRepository.getNamespaceFile(namespace)
         const buffer = file.services.buffer
-        const serviceNameSimple = service.name.split('.').pop()
 
         docify(service.doc).forEach(d => { buffer.add(d) })
         // file.addImport(new Path(['cds'], '')) TODO make sap/cds import work
-        buffer.addIndentedBlock(`export class ${serviceNameSimple} extends cds.Service {`, () => {
+        buffer.addIndentedBlock('export default class {', () => {
             Object.entries(service.operations ?? {}).forEach(([name, {doc}]) => {
                 buffer.add(docify(doc))
-                buffer.add(`declare ${name}: typeof ${name}`)
+                buffer.add(createMember({
+                    name,
+                    type: `typeof ${name}`,
+                    isStatic: true,
+                    isReadonly: true,
+                    isDeclare: true,
+                }))
             })
         }, '}')
-        buffer.add(`export default ${serviceNameSimple}`)
         buffer.blankLine()
         file.addService(service.name)
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cap-js/cds-typer",
-  "version": "0.32.0",
+  "version": "0.33.0",
   "description": "Generates .ts files for a CDS model to receive code completion in VS Code",
   "main": "index.js",
   "repository": "github:cap-js/cds-typer",
@@ -11,12 +11,12 @@
     "CLI"
   ],
   "author": "SAP SE (https://www.sap.com)",
-  "license": "SEE LICENSE IN LICENSE",
+  "license": "Apache-2.0",
   "scripts": {
-    "test:unit": "jest --projects test/unit.jest.config.js",
-    "test:integration": "jest --projects test/int.jest.config.js",
-    "test:smoke": "jest --projects test/smoke.jest.config.js",
-    "test:all": "jest",
+    "test:unit": "node test/testRunner.js ./test/unit ./test/unit/setup.mjs",
+    "test:integration": "node test/testRunner.js ./test/integration ./test/integration/setup.mjs",
+    "test:smoke": "node test/testRunner.js ./test/smoke ./test/smoke/setup.mjs",
+    "test:all": "npm run test:smoke && npm run test:unit",
     "test": "npm run test:smoke && npm run test:unit",
     "lint": "npx eslint .",
     "lint:fix": "npx eslint . --fix",
@@ -31,9 +31,7 @@
   "files": [
     "lib/",
     "library",
-    "CHANGELOG.md",
     "index.js",
-    "LICENSE",
     "README.md",
     "cds-plugin.js"
   ],
@@ -48,27 +46,21 @@
   "devDependencies": {
     "@cap-js/cds-types": "^0",
     "@sap/cds": "^8",
-    "@stylistic/eslint-plugin-js": "^2.7.2",
+    "@stylistic/eslint-plugin-js": "^3.0.0",
     "acorn": "^8.10.0",
     "eslint": "^9",
     "eslint-plugin-jsdoc": "^50.2.2",
     "globals": "^15.0.0",
-    "jest": "^29",
     "typescript": ">=4.6.4"
   },
-  "jest": {
-    "projects": [
-      "test/smoke.jest.config.js",
-      "test/unit.jest.config.js"
-    ]
-  },
   "cds": {
     "typer": {
       "output_directory": "@cds-models",
       "inline_declarations": "flat",
       "target_module_type": "auto",
       "properties_optional": true,
-      "use_entities_proxy": false
+      "use_entities_proxy": false,
+      "build_task": true
     },
     "schema": {
       "buildTaskType": {
@@ -119,7 +111,7 @@
                 "flat",
                 "structured"
               ],
-              "default": "structured"
+              "default": "flat"
             },
             "properties_optional": {
               "type": "boolean",
@@ -131,6 +123,11 @@
               "description": "If set to true, floating point properties are generated\nas IEEE754 compatible '(number | string)' instead of 'number'.",
               "default": false
             },
+            "legacy_binary_types": {
+              "type": "boolean",
+              "description": "If set to true, Binary and LargeBinary are generated\nas strings.",
+              "default": false
+            },
             "target_module_type": {
               "type": "string",
               "description": "Output format for generated .js files.\nSetting it to auto tries to derive the module type from\nthe package.json and falls back to CJS.",
@@ -140,6 +137,11 @@
                 "auto"
               ],
               "default": "auto"
+            },
+            "build_task": {
+              "type": "boolean",
+              "description": "If set to true, the typescript build task will not be registered/ executed.\nThis value must be set in your project configuration.\nPassing it as parameter to the cds-typer CLI has no effect.",
+              "default": true
             }
           }
         }

package/CHANGELOG.md

@@ -1,382 +0,0 @@
-# Changelog
-
-All notable changes to this project will be documented in this file.
-
-## [Unreleased]
-
-### Added
-### Changed
-### Deprecated
-### Removed
-### Fixed
-### Security
-
-## [0.32.0] - 2025-01-14
-
-### Added
-- dedicated classes for inline compositions
-- dedicated text-classes for entities with `localized` elements
-
-### Changed
-- prefixed builtin types like `Promise` and `Record` with `globalThis.`, to allow using names of builtin types for entities without collisions
-- bumped peer-dependency to `@cap-js/cds-types` to `>=0.9`
-### Deprecated
-### Removed
-### Fixed
-- referencing another entity's property of type `cds.String` in an enum will now properly quote the generated values
-### Security
-
-## [0.31.0] - 2024-12-16
-### Fixed
-- type-referencing a property that is a key no longer breaks the referring property
-- when targeting ESM, all imports within the generated types now add a `/index.js`-suffix to conform to modern module resolution mechanisms
-- leaving `target_module_type` at `'auto'` now properly acts on a detected `"type":"module"`
-
-### Added
-- cds aspects now generate a synthetic plural type too, to be used in `composition of many`
-
-## [0.30.0] - 2024-12-02
-
-### Changed
-- [breaking] when running cds-typer in a CAP project, the default for the `outputDirectory` option will be `./@cds-models` instead of `./`. This default takes the lowest precedence after setting it in the project's `cds.env`, or explicitly as CLI argument.
-
-### Fixed
-- cds-typer no longer ignores the selected `outputDirectory`, which would also cause an issue during build
-
-## [0.29.0] - 2024-11-20
-### Added
-- [breaking] cds-typer now tries to automatically detect whether it has to generate ESM or CommonJS in the emitted _index.js_ files. This behaviour can be overridden via the `--targetModuleType` option. _If you rely on these generated index.js files to be CJS despite your project being of ESM type, you need to manually tell cds-typer to generate CJS files!_
-
-### Fixed
-- The static `.keys` property now properly reels in key types from inherited classes.
-
-## [0.28.1] - 2024-11-07
-### Fixed
-- `cds build` no longer fails on Windows with an `EINVAL` error.
-- `cds build` also supports custom model paths in `tsconfig.json` that do not end with `/index.ts`.  This is the case for projects running with `tsx`.
-
-## [0.28.0] - 24-10-24
-### Added
-- Schema definition for `cds.typer` options in `package.json` and `.cdsrc-*.json` files
-- Added a static `elements` property to all entities, which allows access to the `LinkedDefinitions` instance of an entity's elements
-- Schema definition for `typescript` cds build task.
-- `.drafts` property of any entity `E` is now of type `DraftOf<E>`, or `DraftsOf<E>` for plurals, respectively. This type exposes dditional properties that are available on drafts during runtime.
-
-### Fixed
-- Entity elements of named structured types are flattened when using the option `--inlineDeclarations flat`
-- `override` modifier on `.kind` property is now only generated if the property is actually inherited, satisfying strict `tsconfig.json`s
-- Properly support mandatory (`not null`) action parameters with `array of` types
-- Static property `.drafts` is only create for entity classes that are actually draft enabled
-
-## [0.27.0] - 2024-10-02
-### Changed
-- Any configuration variable (via CLI or `cds.env`) can now be passed in snake_case in addition to camelCase
-- Action parameters are now generated as optional by default, which is how the runtime treats them. Mandatory parameters have to be marked as `not null` in CDS/CDL, or `notNull` in CSN.
-
-### Fixed
-- Fix build task for projects with spaces
-- Fix a bug where cds-typer would produce redundant type declarations when the model contains an associations to another entity's property
-- Reintroduce default value `'.'` for `--outputDirectory`
-
-## [0.26.0] - 2024-09-11
-### Added
-- Added a static `.keys` property in all entities. That property is dictionary which holds all properties as keys that are marked as `key` in CDS
-- Added a CLI option `--useEntitiesProxy`. When set to `true`, all entities are wrapped into `Proxy` objects during runtime, allowing top level imports of entity types.
-- Added a static `.kind` property for entities and types, which contains `'entity'` or `'type'` respectively
-- Apps need to provide `@sap/cds` version `8.2` or higher.
-- Apps need to provide `@cap-js/cds-types` version `0.6.4` or higher.
-- Typed methods are now generated for calls of unbound actions. Named and positional call styles are supported, e.g. `service.action({one, two})` and `service.action(one, two)`.
-- Action parameters can be optional in the named call style (`service.action({one:1, ...})`).
-- Actions for ABAP RFC modules cannot be called with positional parameters, but only with named ones. They have 'parameter categories' (import/export/changing/tables) that cannot be called in a flat order.
-- Services now have their own export (named like the service itself). The current default export is not usable in some scenarios from CommonJS modules.
-- Enums and operation parameters can have doc comments
-
-## [0.25.0] - 2024-08-13
-### Added
-- Declaring a type alias on an enum in cds now also exports it on value level in the resulting type
-
-### Fixed
-- Classes representing views and projections will no longer carry ancestry to avoid clashes thereof with aliases fields
-
-### Changed
-- All properties are now preceeded with the `declare` modifier to pass strict tsconfigs using `useDefineForClassFields` or `noImplicitOverride`
-- The static `actions` property of generated classes now includes the types from all inherited classes to also suggest actions defined in a base entity/aspect/type.
-
-## [0.24.0] - 2024-07-18
-### Fixed
-- Suppressed an error that would incorrectly point out naming clashes when an entity was named in singular inflection in the model
-- CDS aspects now also generate a aspect-function in singular inflection, similar to how entities do
-
-### Changed
-- Aspects generate named classes again so that tooltips will show more meaningful provenance for properties
-- The TypeScript task for `cds build` no longer looks for tsconfig.json to determine if the project has TS nature and instead checks the dependencies in the project's package.json for an occurrence of `typescript`
-
-## [0.23.0] - 2024-07-04
-
-### Fixed
-- Plurals no longer have `is_singular` attached in the resulting .js files
-- Properties are properly propagated beyond just one level of inheritance
-
-## [0.22.0] - 2024-06-20
-
-### Fixed
-- Fixed a bug where keys would sometimes inconsistently become nullable
-
-### Changed
-- Logging now internally uses `cds.log` and pipes output into the `cds-typer` logger, which can be configured via `cds.env` in addition to explicitly passing a `--logLevel` parameter to CLI. Users now have to use the levels defined in [`cds.log.levels`](https://cap.cloud.sap/docs/node.js/cds-log#log-levels). The formerly valid levels `WARNING`, `CRITICAL`, and `NONE` are now deprecated and automatically mapped to valid levels for now.
-
-## [0.21.2] - 2024-06-06
-### Fixed
-- The typescript build task will no longer attempt to run unless at least cds 8 is installed
-
-## [0.21.1] - 2024-06-03
-### Fixed
-- Added missing _cds-plugin.js_ to exported files to properly enable calling `cds build --for typescript`
-
-## [0.21.0] - 2024-05-31
-### Added
-- Added `IEEE754Compatible` flag which, when set to `true`, generates decimal fields as `(number | string)` instead of `number`. This flag will be removed in the long run
-- Added plugin to `cds build` TypeScript projects. Can be explicitly called using `cds build --for typescript`
-
-### Changed
-- Types representing CDS events are now only `declare`d to avoid having to make their properties optional
-- Singular forms in generated _index.js_ files now contain a `.is_singular` property as marker for distinguished handling of singular and plural in the runtime
-- Parameters passed to the CLI now take precedence over configuration contained in the `typer` section of `cds.env`
-
-### Fixed
-- Entities ending with an "s" are no longer incorrectly truncated within `extends`-clauses
-- Entity names prefixed with their own namespace (e.g. `Name.Name`, `Name.NameAttachments`) are not stripped of their name prefix
-
-## [0.20.2] - 2024-04-29
-### Fixed
-- Referring to a property's type in a function/ action parameter no longer refers to the enclosing entity
-
-## [0.20.1] - 2024-04-24
-### Fixed
-- Void actions no longer crash the type generation process
-
-## [0.20.0] - 2024-04-23
-### Added
-- Types for actions and functions now expose a `.kind` property which holds the string `'function'` or `'action'` respectively
-- Added the `CdsDate`, `CdsDateTime`, `CdsTime`, `CdsTimestamp` types, which are each represented as a `string`.
-- Plural types can now also contain an optional numeric `$count` property
-
-### Changed
-- Empty `.actions` properties and operations without parameters are now typed as `Record<never, never>` to make it clear they contain nothing and also to satisfy overzealous linters
-
-### Fixed
-- Composition of aspects now properly resolve implicit `typeof` references in their properties
-- Importing an enum into a service will now generate an alias to the original enum, instead of incorrectly duplicating the definition
-- Returning entities from actions/ functions and using them as parameters will now properly use the singular inflection instead of returning an array thereof
-- Aspects are now consistently named and called in their singular form
-- Only detect inflection clash if singular and plural share the same namespace. This also no longer reports `sap.common` as erroneous during type creation
-
-## [0.19.0] - 2024-03-28
-### Added
-- Support for `cds.Vector`, which will be represented as `string`
-
-## [0.18.2] - 2024-03-21
-### Fixed
-- Resolving `@sap/cds` will now look in the CWD first to ensure a consistent use the same CDS version across different setups
-- Types of function parameters starting with `cds.` are not automatically considered builtin anymore and receive a more thorough check against an allow-list
-
-
-## [0.18.1] - 2024-03-13
-### Fix
-- Remove faulty plural for CDS `type` definitions from the generated _index.js_ files
-
-## [0.18.0] - 2024-03-12
-### Added
-- Improved support for projections, including projections on inline definitions, and on views, as well as support for explicit exclusion and selection of properties
-
-### Changed
-- [breaking] CDS `type` definitions will not be inflected. Whatever inflection you define them in will be assumed treated as a singular form and will not receive a plural form anymore
-
-## [0.17.0] - 2024-03-05
-### Fixed
-- Fixed a bug where refering to an externally defined enum via the `typeof` syntax would crash the type generation
-
-## [0.16.0] - 2024-02-01
-### Changed
-- Changed default log level from `NONE` to `ERROR`. See the doc to manually pass in another log level for cds-typer runs
-- Name collisions between automatically generated foreign key fields (`.…_ID`, `.…_code`, etc.) with explicitly named fields will now raise an error
-- Generate CDS types that are actually structured types as if they were entities. This allows the correct representation of mixing aspects and types in CDS inheritance, and also fixes issues with inline enums in such types
-
-### Fixed
-- Externally defined enums can now be used as parameter types in actions
-
-## [0.15.0] - 2023-12-21
-### Added
-- Support for [scoped entities](https://cap.cloud.sap/docs/cds/cdl#scoped-names)
-- Support for [delimited identifiers](https://cap.cloud.sap/docs/cds/cdl#delimited-identifiers)
-
-### Fixed
-- Inline enums are now available during runtime as well
-- Inline enums can now be used as action parameter types as well. These enums will not have a runtime representation, but will only assert type safety!
-- Arrays of inline enum values can now be used as action parameters too. But they will only be represented by their enclosing type for now, i.e. `string`, `number`, etc.
-- Foreign keys of projection entities are now propagated as well
-
-## [0.14.0] - 2023-12-13
-### Added
-- Entities that are database views now also receive typings
-
-## [0.13.0] - 2023-12-06
-### Changed
-- Enums are now generated ecplicitly in the respective _index.js_ files and don't have to extract their values from the model at runtime anymore
-
-### Added
-- The `excluding` clause in projections now actually excludes the specified properties in the generated types
-
-## [0.12.0] - 2023-11-23
-
-### Changed
-- Generate `cds.LargeBinary` as string, buffer, _or readable_ in the case of media content
-
-### Added
-- Added support for the `not null` modifier
-
-### Fixed
-- Now using names of enum values in generated _index.js_ files if no explicit value is present
-
-## [0.11.1] - 2023-10-12
-
-### Changed
-
-### Added
-### Fixed
-- Fixed how service names are exported as default export
-
-## [0.11.0] - 2023-10-10
-
-### Changed
-
-### Added
-- Autoexposed entities in services are now also generated
-- Each generated class now contains their original fully qualified name in a static `.name` property
-- Inline enums that are defined as literal type of properties are now supported as well (note: this feature is experimental. The location to which enums are generated might change in the future!)
-
-### Fixed
-- Fixed an error when an entity uses `type of` on a property they have inherited from another entity
-- Fixed an error during draftability propagation when defining compositions on types that are declared inline
-
-### Removed
-- `compileFromCSN` is no longer part of the package's API
-
-## [0.10.0] - 2023-09-21
-
-### Changed
-- Actions and functions are now attached to a static `.actions` property of each generated class. This reflects the runtime behaviour better than the former way of generating instance methods
-
-### Added
-
-### Fixed
-
-## [0.9.0] - 2023-09-08
-
-### Changed
-
-### Added
-- Support for drafts via `@odata.draft.enabled` annotation
-
-### Fixed
-- Foreign keys are now propagated more than one level (think: `x_ID_ID_ID`)
-
-## [0.8.0] - 2023-09-05
-
-### Changed
-
-### Added
-
-### Fixed
-- Foreign keys that are inherited via aspects are now also generated in addition to the resolved property (see 0.7.0)
-- Explicitly annotated `@singular` and `@plural` names are now properly used in generated _index.js_ files
-
-## [0.7.0] - 2023-08-22
-
-### Changed
-
-### Added
-- Support for `[many] $self` syntax in bound action parameters
-- Foreign keys are now present in the generated types in addition to the resolved property
-
-### Fixed
-## [0.6.1] - 2023-08-10
-
-### Changed
-
-### Added
-
-### Fixed
-- Removed a warning about circular imports
-
-## [0.6.0] - 2023-08-07
-
-### Added
-- Support for `event` syntax
-
-### Fixed
-- Initialise bound actions with stubs to support `"strict":true` in _tsconfig.json_
-- Add leading underscore to appease `noUnusedParameters` in strict tsconfigs
-- No longer inflect `type` definitions when they are referenced within entities or other type definitions
-
-## [0.5.0] - 2023-07-25
-
-### Changed
-- Facilitate strict property checks. Note: `checkJs: true` must be present in the project's _jsconfig.json_ or _tsconfig.json_ respectively for this feature to become effective
-
-### Added
-- Support for `array of` syntax
-
-### Fixed
-- Generate `string` type for date-related types in CDS definitions
-- Generate `Buffer | string` type for the CDS type `LargeBinary`
-
-## [0.4.0] - 2023-07-06
-### Added
-- Support for enums when they are defined separately (not inline in the property type of an entity)
-
-## [0.3.0] - 2023-06-26
-### Added
-- Support `function` definitions (apart from `action`s)
-### Changed
-- Bump version to next minor
-
-### Fixed
-- Properly import CDS `type` definitions when they are referenced elsewhere
-
-## [0.2.5-beta.1] - 2023-06-13
-
-### Changed
-- Bump version
-
-## [0.2.4] - 2023-06-12
-- Enable use of annotated singular/ plural names in associations/ compositions
-- Rename package from `@sap/cds-dts-generator` to `@cap-js/cds-typer`
-
-## [0.2.3] - 2023-05-17
-- Add missing library files
-
-## [0.2.2] - 2023-05-17
-- Make class hierarchy flatter
-
-## [0.2.1] - 2023-05-16
-- Add missing files
-
-## [0.2.0] - 2023-05-15
-- use native Typescript AST in unit tests
-- add `propertiesOptional` flag
-- support flat, as well as nested inline declarations
-- support `typeof` syntax
-- read rudimentary configuration from cds.env
-- export bound and unbound actions
-- allow inline type definitions within compositions
-- enable use of additional type libraries (HANA types available as first library)
-- provide proper JSDoc for all modules
-- export entity types for singular variants alongside plural types
-
-## [0.1.1] - 2023-01-26
-- add TL;DR section to README
-- allow multiple positional arguments
-
-## [0.1.0] - 2023-01-01
-- initial code base