@sap/cds-dk 7.9.5 → 8.0.2

package/lib/compile/openapi/csdl2openapi.js

@@ -1,2448 +0,0 @@
-/**
- * Converts OData CSDL JSON to OpenAPI 3.0.2
-*/
-
-var pluralize = require('pluralize')
-
-//TODO
-// - Core.Example for complex types
-// - reduce number of loops over schemas
-// - inject $$name into each model element to make parameter passing easier?
-// - allow passing additional files for referenced documents
-// - delta: headers Prefer and Preference-Applied
-// - inline definitions for Edm.* to make OpenAPI documents self-contained
-// - both "clickable" and freestyle $expand, $select, $orderby - does not work yet, open issue for OpenAPI UI
-// - system query options for actions/functions/imports depending on $Collection
-// - 200 response for PATCH
-// - ETag for GET / If-Match for PATCH and DELETE depending on @Core.OptimisticConcurrency
-// - CountRestrictions for GET collection-valued (containment) navigation - https://issues.oasis-open.org/browse/ODATA-1300
-// - InsertRestrictions/NonInsertableProperties
-// - InsertRestrictions/NonInsertableNavigationProperties
-// - see //TODO comments below
-
-const SUFFIX = {
-    read: "",
-    create: "-create",
-    update: "-update",
-};
-
-const TITLE_SUFFIX = {
-    "": "",
-    "-create": " (for create)",
-    "-update": " (for update)",
-};
-
-/**
- * ODM annotations in CDS that should be converted into OpenAPI.
- */
-const ODM_ANNOTATIONS = Object.freeze(
-    {
-        '@ODM.entityName': 'x-sap-odm-entity-name',
-        '@ODM.oid': 'x-sap-odm-oid'
-    });
-
-/**
- * Construct an OpenAPI description from a CSDL document
- * @param {object} csdl CSDL document
- * @param {object} options Optional parameters
- * @return {object} OpenAPI description
- */
-module.exports.csdl2openapi = function (
-    csdl,
-    {
-        url: serviceRoot,
-        servers: serversObject,
-        odataVersion: odataVersion,
-        scheme: scheme = 'https',
-        host: host = 'localhost',
-        basePath: basePath = '/service-root',
-        diagram: diagram = false,
-        maxLevels: maxLevels = 5
-    } = {}
-) {
-    // as preProcess below mutates the csdl, copy it before, to avoid side-effects on the caller side
-    csdl = JSON.parse(JSON.stringify(csdl))
-    csdl.$Version = odataVersion ? odataVersion : '4.01'
-    serviceRoot = serviceRoot || (scheme + '://' + host + basePath);
-    const queryOptionPrefix = csdl.$Version <= '4.01' ? '$' : '';
-    const typesToInline = {}; // filled in schema() and used in inlineTypes()
-    const boundOverloads = {};
-    const derivedTypes = {};
-    const alias = {};
-    const namespace = { 'Edm': 'Edm' };
-    const namespaceUrl = {};
-    const voc = {};
-    const requiredSchemas = { list: [], used: {} };
-
-    preProcess(csdl, boundOverloads, derivedTypes, alias, namespace, namespaceUrl, voc);
-
-    const entityContainer = csdl.$EntityContainer ? modelElement(csdl.$EntityContainer) : {};
-    if (csdl.$EntityContainer) {
-        let serviceName = nameParts(csdl.$EntityContainer).qualifier;
-        Object.keys(entityContainer).forEach(element => {
-            if (entityContainer[element].$Type) {
-                let type = nameParts(entityContainer[element].$Type).name;
-                if (csdl[serviceName]?.[type]?.['@cds.autoexpose'] || csdl[serviceName]?.[type]?.['@cds.autoexposed']) 
-                    entityContainer[element]['$cds.autoexpose'] = true;
-                }
-        });
-    }
-
-    const keyAsSegment = entityContainer ? entityContainer[voc.Capabilities.KeyAsSegmentSupported] : {};
-
-    const openapi = {
-        openapi: '3.0.2',
-        info: getInfo(csdl, entityContainer),
-        'x-sap-api-type': 'ODATAV4',
-        'x-odata-version': csdl.$Version,
-        'x-sap-shortText': getShortText(csdl, entityContainer),
-        servers: getServers(serviceRoot, serversObject),
-        tags: entityContainer ? getTags(entityContainer) : {},
-        paths: entityContainer ? getPaths(entityContainer) : {},
-        components: getComponents(csdl, entityContainer)
-    };
-    if (!csdl.$EntityContainer) {
-        delete openapi.servers;
-        delete openapi.tags;
-    }
-
-    security(openapi, entityContainer);
-
-    return openapi;
-
-
-    /**
-     * Collect model info for easier lookup
-     * @param {object} csdl CSDL document
-     * @param {object} boundOverloads Map of action/function names to bound overloads
-     * @param {object} derivedTypes Map of type names to derived types
-     * @param {object} alias Map of namespace or alias to alias
-     * @param {object} namespace Map of namespace or alias to namespace
-     * @param {object} namespaceUrl Map of namespace to reference URL
-     * @param {object} voc Map of vocabularies and terms
-     */
-    function preProcess(csdl, boundOverloads, derivedTypes, alias, namespace, namespaceUrl, voc) {
-        Object.keys(csdl.$Reference || {}).forEach(url => {
-            const reference = csdl.$Reference[url];
-            (reference.$Include || []).forEach(include => {
-                const qualifier = include.$Alias || include.$Namespace;
-                alias[include.$Namespace] = qualifier;
-                namespace[qualifier] = include.$Namespace;
-                namespace[include.$Namespace] = include.$Namespace;
-                namespaceUrl[include.$Namespace] = url;
-            });
-        });
-
-        getVocabularies(voc, alias);
-
-        Object.keys(csdl).filter(name => isIdentifier(name)).forEach(name => {
-            const schema = csdl[name];
-            const qualifier = schema.$Alias || name;
-            const isDefaultNamespace = schema[voc.Core.DefaultNamespace];
-
-            alias[name] = qualifier;
-            namespace[qualifier] = name;
-            namespace[name] = name;
-
-            Object.keys(schema).filter(iName => isIdentifier(iName)).forEach(iName2 => {
-                const qualifiedName = qualifier + '.' + iName2;
-                const element = schema[iName2];
-                if (Array.isArray(element)) {
-                    element.filter(overload => overload.$IsBound).forEach(overload => {
-                        const type = overload.$Parameter[0].$Type + (overload.$Parameter[0].$Collection ? '-c' : '');
-                        if (!boundOverloads[type]) boundOverloads[type] = [];
-                        boundOverloads[type].push({ name: (isDefaultNamespace ? iName2 : qualifiedName), overload: overload });
-                    });
-                } else if (element.$BaseType) {
-                    const base = namespaceQualifiedName(element.$BaseType);
-                    if (!derivedTypes[base]) derivedTypes[base] = [];
-                    derivedTypes[base].push(qualifiedName);
-                }
-            });
-
-            Object.keys(schema.$Annotations || {}).forEach(target => {
-                const annotations = schema.$Annotations[target];
-                const segments = target.split('/');
-                const open = segments[0].indexOf('(');
-                let element;
-                if (open == -1) {
-                    element = modelElement(segments[0]);
-                } else {
-                    element = modelElement(segments[0].substring(0, open));
-                    let args = segments[0].substring(open + 1, segments[0].length - 1);
-                    element = element.find(
-                        (overload) =>
-                            (overload.$Kind == "Action" &&
-                                overload.$IsBound != true &&
-                                args == "") ||
-                            (overload.$Kind == "Action" &&
-                                args ==
-                                (overload.$Parameter[0].$Collection
-                                    ? `Collection(${overload.$Parameter[0].$Type})`
-                                    : overload.$Parameter[0].$Type || "")) ||
-                            (overload.$Parameter || [])
-                                .map((p) => {
-                                    const type = p.$Type || "Edm.String";
-                                    return p.$Collection ? `Collection(${type})` : type;
-                                })
-                                .join(",") == args
-                    );
-                }
-                if (!element) {
-                    console.warn(`Invalid annotation target '${target}'`);
-                } else if (Array.isArray(element)) {
-                    //TODO: action or function:
-                    //- loop over all overloads
-                    //- if there are more segments, a parameter or the return type is targeted
-                } else {
-                    switch (segments.length) {
-                        case 1:
-                            Object.assign(element, annotations);
-                            break;
-                        case 2:
-                            if (['Action', 'Function'].includes(element.$Kind)) {
-                                if (segments[1] == '$ReturnType') {
-                                    if (element.$ReturnType)
-                                        Object.assign(element.$ReturnType, annotations);
-                                } else {
-                                    const parameter = element.$Parameter.find(p => p.$Name == segments[1]);
-                                    Object.assign(parameter, annotations);
-                                }
-                            } else {
-                                if (element[segments[1]]) {
-                                    Object.assign(element[segments[1]], annotations);
-                                } else {
-                                    // console.warn(`Invalid annotation target '${target}'`)
-                                }
-                            }
-                            break;
-                        default:
-                            console.warn('More than two annotation target path segments');
-                    }
-                }
-            });
-        });
-    }
-
-    /**
-     * Construct map of qualified term names
-     * @param {object} voc Map of vocabularies and terms
-     * @param {object} alias Map of namespace or alias to alias
-     */
-    function getVocabularies(voc, alias) {
-        const terms = {
-            Authorization: ['Authorizations', 'SecuritySchemes'],
-            Capabilities: ['BatchSupport', 'BatchSupported', 'ChangeTracking', 'CountRestrictions', 'DeleteRestrictions', 'DeepUpdateSupport', 'ExpandRestrictions',
-                'FilterRestrictions', 'IndexableByKey', 'InsertRestrictions', 'KeyAsSegmentSupported', 'NavigationRestrictions', 'OperationRestrictions',
-                'ReadRestrictions', 'SearchRestrictions', 'SelectSupport', 'SkipSupported', 'SortRestrictions', 'TopSupported', 'UpdateRestrictions'],
-            Core: ['AcceptableMediaTypes', 'Computed', 'DefaultNamespace', 'Description', 'Example', 'Immutable', 'LongDescription',
-                'OptionalParameter', 'Permissions', 'SchemaVersion'],
-            JSON: ['Schema'],
-            Validation: ['AllowedValues', 'Exclusive', 'Maximum', 'Minimum', 'Pattern']
-        };
-
-        Object.keys(terms).forEach(vocab => {
-            voc[vocab] = {};
-            terms[vocab].forEach(term => {
-                if (alias['Org.OData.' + vocab + '.V1'] != undefined)
-                    voc[vocab][term] = '@' + alias['Org.OData.' + vocab + '.V1'] + '.' + term;
-            });
-        });
-
-        voc.Common = {
-            Label: `@${alias['com.sap.vocabularies.Common.v1']}.Label`
-        }
-    }
-
-    /**
-     * Construct the Info Object
-     * @param {object} csdl CSDL document
-     * @param {object} entityContainer Entity Container object
-     * @return {object} Info Object
-     */
-    function getInfo(csdl, entityContainer) {
-        const namespace = csdl.$EntityContainer ? nameParts(csdl.$EntityContainer).qualifier : null;
-        const containerSchema = csdl.$EntityContainer ? csdl[namespace] : {};
-        let description;
-        if (entityContainer && entityContainer[voc.Core.LongDescription]) {
-            description = entityContainer[voc.Core.LongDescription];
-        }
-        else if (containerSchema && containerSchema[voc.Core.LongDescription]) {
-            description = containerSchema[voc.Core.LongDescription];
-        }
-        else {
-            description = ('This service is located at [' + serviceRoot + '/]('
-                + serviceRoot.replace(/\(/g, '%28').replace(/\)/g, '%29') + '/)');
-        }
-        description += (diagram ? getResourceDiagram(csdl, entityContainer) : '');
-        let title;
-        if (entityContainer && entityContainer[voc.Common.Label]) {
-            title = entityContainer[voc.Common.Label];
-        }
-        else if (entityContainer && entityContainer[voc.Core.Description]) {
-            title = entityContainer[voc.Core.Description];
-        }
-        else if (containerSchema && containerSchema[voc.Core.Description]) {
-            title = containerSchema[voc.Core.Description];
-        }
-        else if (csdl.$EntityContainer) {
-            title = 'Service for namespace ' + namespace;
-        }
-        else {
-            title = 'OData CSDL document';
-        }
-        return {
-            title: title,
-            description: csdl.$EntityContainer ? description : '',
-            version: containerSchema[voc.Core.SchemaVersion] || ''
-        };
-    }
-
-    /**
-     * Construct resource diagram using web service at https://yuml.me
-     * @param {object} csdl CSDL document
-     * @param {object} entityContainer Entity Container object
-     * @return {string} resource diagram
-     */
-    function getResourceDiagram(csdl, entityContainer) {
-        let diagram = '';
-        let comma = '';
-        //TODO: make colors configurable
-        let color = { resource: '{bg:lawngreen}', entityType: '{bg:lightslategray}', complexType: '', external: '{bg:whitesmoke}' }
-
-        Object.keys(csdl).filter(name => isIdentifier(name)).forEach(namespace => {
-            const schema = csdl[namespace];
-            Object.keys(schema).filter(name => isIdentifier(name) && ['EntityType', 'ComplexType'].includes(schema[name].$Kind))
-                .forEach(typeName => {
-                    const type = schema[typeName];
-                    diagram += comma
-                        + (type.$BaseType ? '[' + nameParts(type.$BaseType).name + ']^' : '')
-                        + '[' + typeName + (type.$Kind == 'EntityType' ? color.entityType : color.complexType) + ']';
-                    Object.keys(type).filter(name => isIdentifier(name)).forEach(propertyName => {
-                        const property = type[propertyName];
-                        const targetNP = nameParts(property.$Type || 'Edm.String');
-                        if (property.$Kind == 'NavigationProperty' || targetNP.qualifier != 'Edm') {
-                            const target = modelElement(property.$Type);
-                            const bidirectional = property.$Partner && target && target[property.$Partner] && target[property.$Partner].$Partner == propertyName;
-                            // Note: if the partner has the same name then it will also be depicted
-                            if (!bidirectional || propertyName <= property.$Partner) {
-                                diagram += ',[' + typeName + ']'
-                                    + ((property.$Kind != 'NavigationProperty' || property.$ContainsTarget) ? '++' : (bidirectional ? cardinality(target[property.$Partner]) : ''))
-                                    + '-'
-                                    + cardinality(property)
-                                    + ((property.$Kind != 'NavigationProperty' || bidirectional) ? '' : '>')
-                                    + '['
-                                    + (target ? targetNP.name : property.$Type + color.external)
-                                    + ']';
-                            }
-                        }
-                    });
-                    comma = ',';
-                });
-        });
-
-        Object.keys(entityContainer).filter(name => isIdentifier(name)).reverse().forEach(name => {
-            const resource = entityContainer[name];
-            if (resource.$Type) {
-                diagram += comma
-                    + '[' + name + '%20' + color.resource + ']' // additional space in case entity set and type have same name
-                    + '++-'
-                    + cardinality(resource)
-                    + '>[' + nameParts(resource.$Type).name + ']';
-            } else {
-                if (resource.$Action) {
-                    diagram += comma
-                        + '[' + name + color.resource + ']';
-                    const overload = modelElement(resource.$Action).find(pOverload => !pOverload.$IsBound);
-                    diagram += overloadDiagram(name, overload);
-                } else if (resource.$Function) {
-                    diagram += comma
-                        + '[' + name + color.resource + ']';
-                    const overloads = modelElement(resource.$Function);
-                    if (overloads) {
-                        const unbound = overloads.filter(overload => !overload.$IsBound);
-                        // TODO: loop over all overloads, add new source box after first arrow
-                        diagram += overloadDiagram(name, unbound[0]);
-                    }
-                }
-            }
-        });
-
-        if (diagram != '') {
-            diagram = '\n\n## Entity Data Model\n![ER Diagram](https://yuml.me/diagram/class/'
-                + diagram
-                + ')\n\n### Legend\n![Legend](https://yuml.me/diagram/plain;dir:TB;scale:60/class/[External.Type' + color.external
-                + '],[ComplexType' + color.complexType + '],[EntityType' + color.entityType
-                + '],[EntitySet/Singleton/Operation' + color.resource + '])';
-        }
-
-        return diagram;
-
-        /**
-         * Diagram representation of property cardinality
-         * @param {object} typedElement Typed model element, e.g. property
-         * @return {string} cardinality
-         */
-        function cardinality(typedElement) {
-            return typedElement.$Collection ? '*' : (typedElement.$Nullable ? '0..1' : '');
-        }
-
-        /**
-         * Diagram representation of action or function overload
-         * @param {string} name Name of action or function import
-         * @param {object} overload Action or function overload
-         * @return {string} diagram part
-         */
-        function overloadDiagram(name, overload) {
-            let diag = "";
-            if (overload.$ReturnType) {
-                const type = modelElement(overload.$ReturnType.$Type || "Edm.String");
-                if (type) {
-                    diag += "-" + cardinality(overload.$ReturnType) + ">[" + nameParts(overload.$ReturnType.$Type).name + "]";
-                }
-            }
-            for (const param of overload.$Parameter || []) {
-                const type = modelElement(param.$Type || "Edm.String");
-                if (type) {
-                    diag += comma + "[" + name + color.resource + "]in-" + cardinality(param.$Type) + ">[" + nameParts(param.$Type).name + "]";
-                }
-            }
-            return diag;
-        }
-    }
-
-    /**
-     * Find model element by qualified name
-     * @param {string} qname Qualified name of model element
-     * @return {object} Model element
-     */
-    function modelElement(qname) {
-        const q = nameParts(qname);
-        const schema = csdl[q.qualifier] || csdl[namespace[q.qualifier]];
-        return schema ? schema[q.name] : null;
-    }
-
-    /**
-     * Construct the short text
-     * @param {object} csdl CSDL document
-     * @param {object} entityContainer Entity Container object
-     * @return {string} short text
-     */
-    function getShortText(csdl, entityContainer) {
-        const namespace = csdl.$EntityContainer ? nameParts(csdl.$EntityContainer).qualifier : null;
-        const containerSchema = csdl.$EntityContainer ? csdl[namespace] : {};
-        let shortText;
-        if (entityContainer && entityContainer[voc.Core.Description]) {
-            shortText = entityContainer[voc.Core.Description];
-        }
-        else if (containerSchema && containerSchema[voc.Core.Description]) {
-            shortText = containerSchema[voc.Core.Description];
-        }
-        else if (csdl.$EntityContainer) {
-            shortText = 'Service for namespace ' + namespace;
-        }
-        else {
-            shortText = 'OData CSDL document';
-        }
-        return shortText;
-    }
-
-    /**
-     * Construct an array of Server Objects
-     * @param {object} serviceRoot The service root
-     * @param {object} serversObject Input servers object
-     * @return {Array} The list of servers
-     */
-    function getServers(serviceRoot, serversObject) {
-        let servers;
-
-        if (serversObject) {
-            try {
-                servers = JSON.parse(serversObject);
-            } catch (err) {
-                throw new Error(`The input server object is invalid.`);
-            }
-
-            if (!servers.length) {
-                throw new Error(`The input server object should be an array.`);
-            }
-        } else {
-            servers = [{ url: serviceRoot }];
-        }
-        return servers;
-    }
-
-    /**
-     * Construct an array of Tag Objects from the entity container
-     * @param {object} container The entity container
-     * @return {Array} The list of tags
-     */
-    function getTags(container) {
-        const tags = [];
-        // all entity sets and singletons
-        Object.keys(container).filter(name => isIdentifier(name) && container[name].$Type).forEach(child => {
-            const type = modelElement(container[child].$Type) || {};
-            const tag = {
-                name: type[voc.Common.Label] || child
-            };
-            const description = container[child][voc.Core.Description] || type[voc.Core.Description];
-            if (description) tag.description = description;
-            tags.push(tag);
-        })
-        return tags.sort(function (pre, next) { return pre.name.localeCompare(next.name) });
-    }
-
-    /**
-     * Construct the Paths Object from the entity container
-     * @param {object} container Entity container
-     * @return {object} Paths Object
-     */
-    function getPaths(container) {
-        const paths = {};
-        const resources = Object.keys(container).filter(name => isIdentifier(name));
-        resources.forEach(name => {
-            let child = container[name];
-            if (child.$Type) {
-                const type = modelElement(child.$Type);
-                const sourceName = (type && type[voc.Common.Label]) || name;
-                // entity sets and singletons are almost containment navigation properties
-                child.$ContainsTarget = true;
-                pathItems(paths, '/' + name, [], child, child, sourceName, sourceName, child, 0, '');
-            } else if (child.$Action) {
-                pathItemActionImport(paths, name, child);
-            } else if (child.$Function) {
-                pathItemFunctionImport(paths, name, child);
-            } else {
-                console.warn('Unrecognized entity container child: ' + name);
-            }
-        })
-        if (resources.length > 0) pathItemBatch(paths, container);
-        return Object.keys(paths).sort().reduce((p, c) => (p[c] = paths[c], p), {});
-    }
-
-    /**
-     * Add path and Path Item Object for a navigation segment
-     * @param {object} paths Paths Object to augment
-     * @param {string} prefix Prefix for path
-     * @param {Array} prefixParameters Parameter Objects for prefix
-     * @param {object} element Model element of navigation segment
-     * @param {object} root Root model element
-     * @param {string} sourceName Name of path source
-     * @param {string} targetName Name of path target
-     * @param {string} target Target container child of path
-     * @param {integer} level Number of navigation segments so far
-     * @param {string} navigationPath Path for finding navigation restrictions
-     */
-    function pathItems(paths, prefix, prefixParameters, element, root, sourceName, targetName, target, level, navigationPath) {
-        const name = prefix.substring(prefix.lastIndexOf('/') + 1);
-        const type = modelElement(element.$Type);
-        const pathItem = {};
-        const restrictions = navigationPropertyRestrictions(root, navigationPath);
-        const nonExpandable = nonExpandableProperties(root, navigationPath);
-
-        paths[prefix] = pathItem;
-        if (prefixParameters.length > 0) pathItem.parameters = prefixParameters;
-
-        operationRead(pathItem, element, name, sourceName, targetName, target, level, restrictions, false, nonExpandable);
-        if (!root['$cds.autoexpose'] && element.$Collection && (element.$ContainsTarget || level < 2 && target)) {
-            operationCreate(pathItem, element, name, sourceName, targetName, target, level, restrictions);
-        }
-        pathItemsForBoundOperations(paths, prefix, prefixParameters, element, sourceName);
-
-        if (element.$ContainsTarget) {
-            if (element.$Collection) {
-                if (level < maxLevels)
-                    pathItemsWithKey(paths, prefix, prefixParameters, element, root, sourceName, targetName, target, level, navigationPath, restrictions, nonExpandable);
-            } else {
-                if (!root['$cds.autoexpose']) {
-                    operationUpdate(pathItem, element, name, sourceName, target, level, restrictions);
-                    if (element.$Nullable) {
-                        operationDelete(pathItem, element, name, sourceName, target, level, restrictions);
-                    }
-                }
-                pathItemsForBoundOperations(paths, prefix, prefixParameters, element, sourceName);
-                pathItemsWithNavigation(paths, prefix, prefixParameters, type, root, sourceName, level, navigationPath);
-            }
-        }
-
-        if (Object.keys(pathItem).filter((i) => i !== "parameters").length === 0)
-            delete paths[prefix];
-    }
-
-    /**
-     * Find navigation restrictions for a navigation path
-     * @param {object} root Root model element
-     * @param {string} navigationPath Path for finding navigation restrictions
-     * @return Navigation property restrictions of navigation segment
-     */
-    function navigationPropertyRestrictions(root, navigationPath) {
-        const navigationRestrictions = root[voc.Capabilities.NavigationRestrictions] || {};
-        return (navigationRestrictions.RestrictedProperties || []).find(item => navigationPropertyPath(item.NavigationProperty) == navigationPath)
-            || {};
-    }
-
-    /**
-     * Find non-expandable properties for a navigation path
-     * @param {object} root Root model element
-     * @param {string} navigationPath Path for finding navigation restrictions
-     * @return Navigation property restrictions of navigation segment
-     */
-    function nonExpandableProperties(root, navigationPath) {
-        const expandRestrictions = root[voc.Capabilities.ExpandRestrictions] || {};
-        const prefix = navigationPath.length === 0 ? '' : navigationPath + '/'
-        const from = prefix.length
-        const nonExpandable = []
-        for (const path of (expandRestrictions.NonExpandableProperties || [])) {
-            if (path.startsWith(prefix)) {
-                nonExpandable.push(path.substring(from))
-            }
-        }
-        return nonExpandable;
-    }
-
-    /**
-     * Add path and Path Item Object for a navigation segment with key
-     * @param {object} paths Paths Object to augment
-     * @param {string} prefix Prefix for path
-     * @param {Array} prefixParameters Parameter Objects for prefix
-     * @param {object} element Model element of navigation segment
-     * @param {object} root Root model element
-     * @param {string} sourceName Name of path source
-     * @param {string} targetName Name of path target
-     * @param {string} target Target container child of path
-     * @param {integer} level Number of navigation segments so far
-     * @param {string} navigationPath Path for finding navigation restrictions
-     * @param {object} restrictions Navigation property restrictions of navigation segment
-     * @param {array} nonExpandable Non-expandable navigation properties
-     */
-    function pathItemsWithKey(paths, prefix, prefixParameters, element, root, sourceName, targetName, target, level, navigationPath, restrictions, nonExpandable) {
-        const targetIndexable = target == null || target[voc.Capabilities.IndexableByKey] != false;
-        if (restrictions.IndexableByKey == true || restrictions.IndexableByKey != false && targetIndexable) {
-            const name = prefix.substring(prefix.lastIndexOf('/') + 1);
-            const type = modelElement(element.$Type);
-            const key = entityKey(type, level);
-            if (key.parameters.length > 0) {
-                const path = prefix + key.segment;
-                const parameters = prefixParameters.concat(key.parameters);
-                const pathItem = { parameters: parameters };
-                paths[path] = pathItem;
-
-                operationRead(pathItem, element, name, sourceName, targetName, target, level, restrictions, true, nonExpandable);
-                if (!root['$cds.autoexpose']) {
-                    operationUpdate(pathItem, element, name, sourceName, target, level, restrictions, true);
-                    operationDelete(pathItem, element, name, sourceName, target, level, restrictions, true);
-                }
-                if (Object.keys(pathItem).filter((i) => i !== "parameters").length === 0)
-                    delete paths[path];
-
-                pathItemsForBoundOperations(paths, path, parameters, element, sourceName, true);
-                pathItemsWithNavigation(paths, path, parameters, type, root, sourceName, level, navigationPath);
-            }
-        }
-    }
-
-    /**
-     * Construct Operation Object for create
-     * @param {object} pathItem Path Item Object to augment
-     * @param {object} element Model element of navigation segment
-     * @param {string} name Name of navigation segment
-     * @param {string} sourceName Name of path source
-     * @param {string} targetName Name of path target
-     * @param {string} target Target container child of path
-     * @param {integer} level Number of navigation segments so far
-     * @param {object} restrictions Navigation property restrictions of navigation segment
-     */
-    function operationCreate(pathItem, element, name, sourceName, targetName, target, level, restrictions) {
-        const insertRestrictions = restrictions.InsertRestrictions || target && target[voc.Capabilities.InsertRestrictions] || {};
-        let countRestrictions = target && (target[voc.Capabilities.CountRestrictions]?.Countable === false); // count property will be added if CountRestrictions is false
-        if (insertRestrictions.Insertable !== false) {
-            const lname = pluralize.singular(splitName(name));
-            const type = modelElement(element.$Type);
-            pathItem.post = {
-                summary: insertRestrictions.Description || operationSummary('Creates', name, sourceName, level, true, true),
-                tags: [sourceName],
-                requestBody: {
-                    description: type && type[voc.Core.Description] || 'New ' + lname,
-                    required: true,
-                    content: {
-                        'application/json': {
-                            schema: ref(element.$Type, SUFFIX.create),
-                        }
-                    }
-                },
-                responses: response(201, 'Created ' + lname, { $Type: element.$Type }, insertRestrictions.ErrorResponses, !countRestrictions),
-            };
-            if (insertRestrictions.LongDescription) pathItem.post.description = insertRestrictions.LongDescription;
-            if (targetName && sourceName != targetName) pathItem.post.tags.push(targetName);
-            customParameters(pathItem.post, insertRestrictions);
-        }
-    }
-
-    /**
-     * Split camel-cased name into words
-     * @param {string} name Name to split
-     * @return {string} Split name
-     */
-    function splitName(name) {
-        return name.split(/(?=[A-Z])/g).join(' ').toLowerCase().replace(/ i d/g, ' id');
-    }
-
-    /**
-     * Construct operation summary
-     * @param {string} operation Operation (verb)
-     * @param {string} name Name of navigation segment
-     * @param {string} sourceName Name of path source
-     * @param {integer} level Number of navigation segments so far
-     * @param {boolean} collection Access a collection
-     * @param {boolean} byKey Access by key
-     * @return {string} Operation Text
-     */
-    function operationSummary(operation, name, sourceName, level, collection, byKey) {
-        let lname = splitName(name);
-        let sname = splitName(sourceName);
-
-        return operation + ' '
-            + (byKey ? 'a single ' : (collection ? 'a list of ' : ''))
-            + (byKey ? pluralize.singular(lname) : lname)
-            //TODO: suppress "a" for all singletons
-            + (level == 0 ? '' : (level == 1 && sname == 'me' ? ' of me' : ' of a ' + pluralize.singular(sname)))
-            + '.'
-    }
-
-    /**
-     * Construct Operation Object for read
-     * @param {object} pathItem Path Item Object to augment
-     * @param {object} element Model element of navigation segment
-     * @param {string} name Name of navigation segment
-     * @param {string} sourceName Name of path source
-     * @param {string} targetName Name of path target
-     * @param {string} target Target container child of path
-     * @param {integer} level Number of navigation segments so far
-     * @param {object} restrictions Navigation property restrictions of navigation segment
-     * @param {boolean} byKey Read by key
-     * @param {array} nonExpandable Non-expandable navigation properties
-     */
-    function operationRead(pathItem, element, name, sourceName, targetName, target, level, restrictions, byKey, nonExpandable) {
-        const targetRestrictions = target?.[voc.Capabilities.ReadRestrictions];
-        const readRestrictions = restrictions.ReadRestrictions || targetRestrictions || {};
-        const readByKeyRestrictions = readRestrictions.ReadByKeyRestrictions;
-        let readable = true;
-        let countRestrictions = target && (target[voc.Capabilities.CountRestrictions]?.Countable === false);
-        if (byKey && readByKeyRestrictions && readByKeyRestrictions.Readable !== undefined)
-            readable = readByKeyRestrictions.Readable;
-        else if (readRestrictions.Readable !== undefined)
-            readable = readRestrictions.Readable;
-
-        if (readable) {
-            let descriptions = (level == 0 ? targetRestrictions : restrictions.ReadRestrictions) || {};
-            if (byKey) descriptions = descriptions.ReadByKeyRestrictions || {};
-            const lname = splitName(name);
-            const collection = !byKey && element.$Collection;
-            const operation = {
-                summary: descriptions.Description || operationSummary('Retrieves', name, sourceName, level, element.$Collection, byKey),
-                tags: [sourceName],
-                parameters: [],
-                responses: response(200, 'Retrieved ' + (byKey ? pluralize.singular(lname) : lname), { $Type: element.$Type, $Collection: collection },
-                    byKey ? readByKeyRestrictions?.ErrorResponses : readRestrictions?.ErrorResponses, !countRestrictions)
-            };
-            const deltaSupported = element[voc.Capabilities.ChangeTracking] && element[voc.Capabilities.ChangeTracking].Supported;
-            if (!byKey && deltaSupported) {
-                operation.responses[200].content['application/json'].schema.properties['@odata.deltaLink'] = {
-                    type: 'string',
-                    example: basePath + '/' + name + '?$deltatoken=opaque server-generated token for fetching the delta'
-                }
-            }
-            if (descriptions.LongDescription) operation.description = descriptions.LongDescription;
-            if (target && sourceName != targetName) operation.tags.push(targetName);
-            customParameters(operation, byKey ? readByKeyRestrictions || readRestrictions : readRestrictions);
-
-            if (collection) {
-                optionTop(operation.parameters, target, restrictions);
-                optionSkip(operation.parameters, target, restrictions);
-                if (csdl.$Version >= '4.0') optionSearch(operation.parameters, target, restrictions);
-                optionFilter(operation.parameters, target, restrictions);
-                optionCount(operation.parameters, target);
-                optionOrderBy(operation.parameters, element, target, restrictions);
-            }
-
-            optionSelect(operation.parameters, element, target, restrictions);
-            optionExpand(operation.parameters, element, target, nonExpandable);
-
-            pathItem.get = operation;
-        }
-    }
-
-    /**
-     * Add custom headers and query options
-     * @param {object} operation Operation object to augment
-     * @param {object} restrictions Restrictions for operation
-     */
-    function customParameters(operation, restrictions) {
-        if (
-            !operation.parameters &&
-            (restrictions.CustomHeaders || restrictions.CustomQueryOptions)
-        )
-            operation.parameters = [];
-        for (const custom of restrictions.CustomHeaders || []) {
-            operation.parameters.push(customParameter(custom, "header"));
-        }
-
-        for (const custom of restrictions.CustomQueryOptions || []) {
-            operation.parameters.push(customParameter(custom, "query"));
-        }
-    }
-
-    /**
-     * Construct custom parameter
-     * @param {object} custom custom parameter in OData format
-     * @param {string} location "header" or "query"
-     */
-    function customParameter(custom, location) {
-        return {
-            name: custom.Name,
-            in: location,
-            required: custom.Required || false,
-            ...(custom.Description && { description: custom.Description }),
-            schema: {
-                type: "string",
-                ...(custom.DocumentationURL && {
-                    externalDocs: { url: custom.DocumentationURL },
-                }),
-                //TODO: Examples
-            },
-        };
-    }
-
-    /**
-     * Add parameter for query option $count
-     * @param {Array} parameters Array of parameters to augment
-     * @param {string} target Target container child of path
-     */
-    function optionCount(parameters, target) {
-        const targetRestrictions = target && target[voc.Capabilities.CountRestrictions];
-        const targetCountable = target == null
-            || targetRestrictions == null
-            || targetRestrictions.Countable !== false;
-
-        if (targetCountable) {
-            parameters.push({
-
-                $ref: '#/components/parameters/count'
-            });
-        }
-    }
-
-    /**
-     * Add parameter for query option $expand
-     * @param {Array} parameters Array of parameters to augment
-     * @param {object} element Model element of navigation segment
-     * @param {string} target Target container child of path
-     * @param {array} nonExpandable Non-expandable navigation properties
-     */
-    function optionExpand(parameters, element, target, nonExpandable) {
-        const targetRestrictions = target && target[voc.Capabilities.ExpandRestrictions];
-        const supported = targetRestrictions == null || targetRestrictions.Expandable != false;
-        if (supported) {
-            const expandItems = ['*'].concat(navigationPaths(element).filter(path => !nonExpandable.includes(path)));
-            if (expandItems.length > 1) {
-                parameters.push({
-                    name: queryOptionPrefix + 'expand',
-                    description: (targetRestrictions && targetRestrictions[voc.Core.Description])
-                        || 'The value of $expand query option is a comma-separated list of navigation property names, \
-stream property names, or $value indicating the stream content of a media-entity. \
-The corresponding related entities and stream values will be represented inline, \
-see [Expand](http://docs.oasis-open.org/odata/odata/v4.01/odata-v4.01-part1-protocol.html#sec_SystemQueryOptionexpand)',
-                    in: 'query',
-                    explode: false,
-                    schema: {
-                        type: 'array',
-                        uniqueItems: true,
-                        items: {
-                            type: 'string',
-                            enum: expandItems
-                        }
-                    }
-                });
-            }
-        }
-    }
-
-    /**
-     * Collect navigation paths of a navigation segment and its potentially structured components
-     * @param {object} element Model element of navigation segment
-     * @param {string} prefix Navigation prefix
-     * @param {integer} level Number of navigation segments so far
-     * @return {Array} Array of navigation property paths
-     */
-    function navigationPaths(element, prefix = '', level = 0) {
-        const paths = [];
-        const type = modelElement(element.$Type);
-        const properties = propertiesOfStructuredType(type);
-        Object.keys(properties).forEach(key => {
-            if (properties[key].$Kind == 'NavigationProperty') {
-                paths.push(prefix + key)
-            } else if (properties[key].$Type && level < maxLevels) {
-                paths.push(...navigationPaths(properties[key], prefix + key + '/', level + 1));
-            }
-        })
-        return paths;
-    }
-
-    /**
-     * Add parameter for query option $filter
-     * @param {Array} parameters Array of parameters to augment
-     * @param {string} target Target container child of path
-     * @param {object} restrictions Navigation property restrictions of navigation segment
-     */
-    function optionFilter(parameters, target, restrictions) {
-        const filterRestrictions = restrictions.FilterRestrictions || target && target[voc.Capabilities.FilterRestrictions] || {};
-
-        if (filterRestrictions.Filterable !== false) {
-            const filter = {
-                name: queryOptionPrefix + 'filter',
-                description: filterRestrictions[voc.Core.Description]
-                    || 'Filter items by property values, see [Filtering](http://docs.oasis-open.org/odata/odata/v4.01/odata-v4.01-part1-protocol.html#sec_SystemQueryOptionfilter)',
-                in: 'query',
-                schema: {
-                    type: 'string'
-                }
-            };
-            if (filterRestrictions.RequiresFilter)
-                filter.required = true;
-            if (filterRestrictions.RequiredProperties) {
-                filter.description += '\n\nRequired filter properties:';
-                filterRestrictions.RequiredProperties.forEach(
-                    item => filter.description += '\n- ' + propertyPath(item)
-                );
-            }
-            parameters.push(filter);
-        }
-    }
-
-    /**
-     * Add parameter for query option $orderby
-     * @param {Array} parameters Array of parameters to augment
-     * @param {object} element Model element of navigation segment
-     * @param {string} target Target container child of path
-     * @param {object} restrictions Navigation property restrictions of navigation segment
-     */
-    function optionOrderBy(parameters, element, target, restrictions) {
-        const sortRestrictions = restrictions.SortRestrictions || target && target[voc.Capabilities.SortRestrictions] || {};
-
-        if (sortRestrictions.Sortable !== false) {
-            const nonSortable = {};
-            (sortRestrictions.NonSortableProperties || []).forEach(name => {
-                nonSortable[propertyPath(name)] = true;
-            });
-            const orderbyItems = [];
-            primitivePaths(element).filter(property => !nonSortable[property]).forEach(property => {
-                orderbyItems.push(property);
-                orderbyItems.push(property + ' desc');
-            });
-            if (orderbyItems.length > 0) {
-                parameters.push({
-                    name: queryOptionPrefix + 'orderby',
-                    description: sortRestrictions[voc.Core.Description]
-                        || 'Order items by property values, see [Sorting](http://docs.oasis-open.org/odata/odata/v4.01/odata-v4.01-part1-protocol.html#sec_SystemQueryOptionorderby)',
-                    in: 'query',
-                    explode: false,
-                    schema: {
-                        type: 'array',
-                        uniqueItems: true,
-                        items: {
-                            type: 'string',
-                            enum: orderbyItems
-                        }
-                    }
-                });
-            }
-        }
-    }
-
-    /**
-     * Unpack EnumMember value if it uses CSDL JSON CS01 style, like CAP does
-     * @param {string or object} path Qualified name of referenced type
-     * @return {object} Reference Object
-     */
-    function enumMember(member) {
-        if (typeof member == 'string')
-            return member;
-        else if (typeof member == 'object')
-            return member.$EnumMember;
-    }
-
-    /**
-     * Unpack NavigationPropertyPath value if it uses CSDL JSON CS01 style, like CAP does
-     * @param {string or object} path Qualified name of referenced type
-     * @return {object} Reference Object
-     */
-    function navigationPropertyPath(path) {
-        if (typeof path == 'string')
-            return path;
-        else
-            return path.$NavigationPropertyPath;
-    }
-
-    /**
-     * Unpack PropertyPath value if it uses CSDL JSON CS01 style, like CAP does
-     * @param {string or object} path Qualified name of referenced type
-     * @return {object} Reference Object
-     */
-    function propertyPath(path) {
-        if (typeof path == 'string')
-            return path;
-        else
-            return path.$PropertyPath;
-    }
-
-    /**
-     * Collect primitive paths of a navigation segment and its potentially structured components
-     * @param {object} element Model element of navigation segment
-     * @param {string} prefix Navigation prefix
-     * @return {Array} Array of primitive property paths
-     */
-    function primitivePaths(element, prefix = '') {
-        const paths = [];
-        const elementType = modelElement(element.$Type);
-
-        if (!elementType) {
-            console.warn(`Unknown type for element: ${JSON.stringify(element)}`);
-            return paths;
-        }
-
-        const propsOfType = propertiesOfStructuredType(elementType);
-        const ignore = Object.entries(propsOfType)
-            .filter(entry => entry[1].$Kind !== 'NavigationProperty')
-            .filter(entry => entry[1].$Type)
-            .filter(entry => nameParts(entry[1].$Type).qualifier !== 'Edm')
-            .filter(entry => !modelElement(entry[1].$Type));
-
-        // Keep old logging
-        ignore.forEach(entry => console.warn(`Unknown type for element: ${JSON.stringify(entry)}`));
-
-        const properties = Object.entries(propsOfType)
-            .filter(entry => entry[1].$Kind !== 'NavigationProperty')
-            .filter(entry => !ignore.includes(entry))
-            .map(entryToProperty({ path: prefix, typeRefChain: [] }));
-
-        for (let i = 0; i < properties.length; i++) {
-            const property = properties[i];
-            if (!property.isComplex) {
-                paths.push(property.path);
-                continue;
-            }
-
-            const typeRefChainTail = property.typeRefChain[property.typeRefChain.length - 1];
-
-            // Allow full cycle to be shown (0) times
-            if (property.typeRefChain.filter(_type => _type === typeRefChainTail).length > 1) {
-                console.warn(`Cycle detected ${property.typeRefChain.join('->')}`);
-                continue;
-            }
-
-            const expanded = Object.entries(property.properties)
-                .filter(pProperty => pProperty[1].$Kind !== 'NavigationProperty')
-                .map(entryToProperty(property))
-            properties.splice(i + 1, 0, ...expanded);
-        }
-
-        return paths;
-    }
-
-    function entryToProperty(parent) {
-
-        return function (entry) {
-            const key = entry[0];
-            const property = entry[1];
-            const propertyType = property.$Type && modelElement(property.$Type);
-
-            if (propertyType && propertyType.$Kind && propertyType.$Kind === 'ComplexType') {
-                return {
-                    properties: propertiesOfStructuredType(propertyType),
-                    path: `${parent.path}${key}/`,
-                    typeRefChain: parent.typeRefChain.concat(property.$Type),
-                    isComplex: true
-                }
-            }
-
-            return {
-                properties: {},
-                path: `${parent.path}${key}`,
-                typeRefChain: [],
-                isComplex: false,
-            }
-        };
-    }
-
-    /**
-     * Add parameter for query option $search
-     * @param {Array} parameters Array of parameters to augment
-     * @param {string} target Target container child of path
-     * @param {object} restrictions Navigation property restrictions of navigation segment
-     */
-    function optionSearch(parameters, target, restrictions) {
-        const searchRestrictions = restrictions.SearchRestrictions || target && target[voc.Capabilities.SearchRestrictions] || {};
-
-        if (searchRestrictions.Searchable !== false) {
-            if (searchRestrictions[voc.Core.Description]) {
-                parameters.push({
-                    name: queryOptionPrefix + 'search',
-                    description: searchRestrictions[voc.Core.Description],
-                    in: 'query',
-                    schema: { type: 'string' }
-                });
-            } else {
-                parameters.push({ $ref: '#/components/parameters/search' });
-            }
-        }
-    }
-
-    /**
-     * Add parameter for query option $select
-     * @param {Array} parameters Array of parameters to augment
-     * @param {object} element Model element of navigation segment
-     * @param {string} target Target container child of path
-     * @param {object} restrictions Navigation property restrictions of navigation segment
-     */
-    function optionSelect(parameters, element, target, restrictions) {
-        const selectSupport = restrictions.SelectSupport || target && target[voc.Capabilities.SelectSupport] || {};
-
-        if (selectSupport.Supported !== false) {
-            const type = modelElement(element.$Type) || {};
-            const properties = propertiesOfStructuredType(type);
-            const selectItems = [];
-            Object.keys(properties).filter(key => properties[key].$Kind != 'NavigationProperty').forEach(
-                key => selectItems.push(key)
-            )
-            if (selectItems.length > 0) {
-                parameters.push({
-                    name: queryOptionPrefix + 'select',
-                    description: 'Select properties to be returned, see [Select](http://docs.oasis-open.org/odata/odata/v4.01/odata-v4.01-part1-protocol.html#sec_SystemQueryOptionselect)',
-                    in: 'query',
-                    explode: false,
-                    schema: {
-                        type: 'array',
-                        uniqueItems: true,
-                        items: {
-                            type: 'string',
-                            enum: selectItems
-                        }
-                    }
-                });
-            }
-        }
-    }
-
-    /**
-     * Add parameter for query option $skip
-     * @param {Array} parameters Array of parameters to augment
-     * @param {string} target Target container child of path
-     * @param {object} restrictions Navigation property restrictions of navigation segment
-     */
-    function optionSkip(parameters, target, restrictions) {
-        const supported = restrictions.SkipSupported !== undefined
-            ? restrictions.SkipSupported
-            : target == null || target[voc.Capabilities.SkipSupported] !== false;
-
-        if (supported) {
-            parameters.push({
-                $ref: '#/components/parameters/skip'
-            });
-        }
-    }
-
-    /**
-     * Add parameter for query option $top
-     * @param {Array} parameters Array of parameters to augment
-     * @param {string} target Target container child of path
-     * @param {object} restrictions Navigation property restrictions of navigation segment
-     */
-    function optionTop(parameters, target, restrictions) {
-        const supported = restrictions.TopSupported !== undefined
-            ? restrictions.TopSupported
-            : target == null || target[voc.Capabilities.TopSupported] !== false;
-
-        if (supported) {
-            parameters.push({
-                $ref: '#/components/parameters/top'
-            });
-        }
-    }
-
-    /**
-     * Construct Operation Object for update
-     * @param {object} pathItem Path Item Object to augment
-     * @param {object} element Model element of navigation segment
-     * @param {string} name Name of navigation segment
-     * @param {string} sourceName Name of path source
-     * @param {string} target Target container child of path
-     * @param {integer} level Number of navigation segments so far
-     * @param {object} restrictions Navigation property restrictions of navigation segment
-     * @param {boolean} byKey Update by key
-     */
-    function operationUpdate(pathItem, element, name, sourceName, target, level, restrictions, byKey) {
-        const updateRestrictions = restrictions.UpdateRestrictions || target && target[voc.Capabilities.UpdateRestrictions] || {};
-        let countRestrictions = target && (target[voc.Capabilities.CountRestrictions]?.Countable === false);
-        if (updateRestrictions.Updatable !== false) {
-            const type = modelElement(element.$Type);
-            const operation = {
-                summary: updateRestrictions.Description || operationSummary('Changes', name, sourceName, level, element.$Collection, byKey),
-                tags: [sourceName],
-                requestBody: {
-                    description: type && type[voc.Core.Description] || 'New property values',
-                    required: true,
-                    content: {
-                        'application/json': {
-                            schema: ref(element.$Type, SUFFIX.update),
-                        }
-                    }
-                },
-                responses: response(204, "Success", undefined, updateRestrictions.ErrorResponses, !countRestrictions),
-            };
-            if (updateRestrictions.LongDescription) operation.description = updateRestrictions.LongDescription;
-            customParameters(operation, updateRestrictions);
-            const updateMethod = updateRestrictions.UpdateMethod ? updateRestrictions.UpdateMethod.toLowerCase() : "patch";
-            pathItem[updateMethod] = operation;
-        }
-    }
-
-    /**
-     * Construct Operation Object for delete
-     * @param {object} pathItem Path Item Object to augment
-     * @param {object} element Model element of navigation segment
-     * @param {string} name Name of navigation segment
-     * @param {string} sourceName Name of path source
-     * @param {string} target Target container child of path
-     * @param {integer} level Number of navigation segments so far
-     * @param {object} restrictions Navigation property restrictions of navigation segment
-     * @param {boolean} byKey Delete by key
-     */
-    function operationDelete(pathItem, element, name, sourceName, target, level, restrictions, byKey) {
-        const deleteRestrictions = restrictions.DeleteRestrictions || target && target[voc.Capabilities.DeleteRestrictions] || {};
-        let countRestrictions = target && (target[voc.Capabilities.CountRestrictions]?.Countable === false);
-        if (deleteRestrictions.Deletable !== false) {
-            pathItem.delete = {
-                summary: deleteRestrictions.Description || operationSummary('Deletes', name, sourceName, level, element.$Collection, byKey),
-                tags: [sourceName],
-                responses: response(204, "Success", undefined, deleteRestrictions.ErrorResponses, !countRestrictions),
-            };
-            if (deleteRestrictions.LongDescription) pathItem.delete.description = deleteRestrictions.LongDescription;
-            customParameters(pathItem.delete, deleteRestrictions);
-        }
-    }
-
-    /**
-     * Add paths and Path Item Objects for navigation segments
-     * @param {object} paths The Paths Object to augment
-     * @param {string} prefix Prefix for path
-     * @param {Array} prefixParameters Parameter Objects for prefix
-     * @param {object} type Entity type object of navigation segment
-     * @param {string} sourceName Name of path source
-     * @param {integer} level Number of navigation segments so far
-     * @param {string} navigationPrefix Path for finding navigation restrictions
-     */
-    function pathItemsWithNavigation(paths, prefix, prefixParameters, type, root, sourceName, level, navigationPrefix) {
-        const navigationRestrictions = root[voc.Capabilities.NavigationRestrictions] || {};
-        const rootNavigable = level == 0 && enumMember(navigationRestrictions.Navigability) != 'None'
-            || level == 1 && enumMember(navigationRestrictions.Navigability) != 'Single'
-            || level > 1;
-
-        if (type && level < maxLevels) {
-            const properties = navigationPathMap(type);
-            Object.keys(properties).forEach(name => {
-                const parentRestrictions = navigationPropertyRestrictions(root, navigationPrefix);
-                if (enumMember(parentRestrictions.Navigability) == 'Single') return;
-
-                const navigationPath = navigationPrefix + (navigationPrefix.length > 0 ? '/' : '') + name;
-                const restrictions = navigationPropertyRestrictions(root, navigationPath);
-                if (['Recursive', 'Single'].includes(enumMember(restrictions.Navigability))
-                    || restrictions.Navigability == null && rootNavigable) {
-                    const targetSetName = root.$NavigationPropertyBinding && root.$NavigationPropertyBinding[navigationPath];
-                    const target = entityContainer[targetSetName];
-                    const targetType = target && modelElement(target.$Type);
-                    const targetName = (targetType && targetType[voc.Common.Label]) || targetSetName;
-                    pathItems(paths, prefix + '/' + name, prefixParameters, properties[name], root, sourceName, targetName, target, level + 1, navigationPath);
-                }
-            });
-        }
-    }
-
-    /**
-     * Collect navigation paths of a navigation segment and its potentially structured components
-     * @param {object} type Structured type
-     * @param {object} map Map of navigation property paths and their types
-     * @param {string} prefix Navigation prefix
-     * @param {integer} level Number of navigation segments so far
-     * @return {object} Map of navigation property paths and their types
-     */
-    function navigationPathMap(type, map = {}, prefix = '', level = 0) {
-        const properties = propertiesOfStructuredType(type);
-        Object.keys(properties).forEach(key => {
-            if (properties[key].$Kind == 'NavigationProperty') {
-                map[prefix + key] = properties[key];
-            } else if (properties[key].$Type && !properties[key].$Collection && level < maxLevels) {
-                navigationPathMap(modelElement(properties[key].$Type), map, prefix + key + '/', level + 1);
-            }
-        })
-        return map;
-    }
-
-    /**
-     * Construct map of key names for an entity type
-     * @param {object} type Entity type object
-     * @return {object} Map of key names
-     */
-    function keyMap(type) {
-        const map = {};
-        if (type.$Kind == 'EntityType') {
-            const keys = getKey(type) || [];
-            keys.forEach(key => {
-                if (typeof key == 'string')
-                    map[key] = true;
-            });
-        }
-        return map;
-    }
-
-    /**
-     * Key for path item
-     * @param {object} entityType Entity Type object
-     * @return {array} Key of entity type or null
-     */
-    function getKey(entityType) {
-        let type = entityType;
-        let keys = null;
-        while (type) {
-            keys = type.$Key;
-            if (keys || !type.$BaseType) break;
-            type = modelElement(type.$BaseType);
-        }
-        return keys;
-    }
-
-    /**
-     * Key for path item
-     * @param {object} entityType Entity Type object
-     * @param {integer} level Number of navigation segments so far
-     * @return {object} key: Key segment, parameters: key parameters
-     */
-    function entityKey(entityType, level) {
-        let segment = '';
-        const params = [];
-        const keys = getKey(entityType) || [];
-        const properties = propertiesOfStructuredType(entityType);
-
-        keys.forEach((key, index) => {
-            const suffix = level > 0 ? '_' + level : '';
-            if (keyAsSegment)
-                segment += '/';
-            else {
-                if (index > 0) segment += ',';
-                if (keys.length != 1) segment += key + '=';
-            }
-            let parameter;
-            let property = {};
-            if (typeof key == 'string') {
-                parameter = key;
-                property = properties[key];
-            } else {
-                parameter = Object.keys(key)[0];
-                const segments = key[parameter].split('/');
-                property = properties[segments[0]];
-                for (let i = 1; i < segments.length; i++) {
-                    const complexType = modelElement(property.$Type);
-                    const properties = propertiesOfStructuredType(complexType);
-                    property = properties[segments[i]];
-                }
-            }
-            const propertyType = property.$Type;
-            segment += pathValuePrefix(propertyType) + '{' + parameter + suffix + '}' + pathValueSuffix(propertyType);
-            const param = {
-                description: [property[voc.Core.Description], property[voc.Core.LongDescription]].filter(t => t).join('  \n')
-                    || 'key: ' + parameter,
-                in: 'path',
-                name: parameter + suffix,
-                required: true,
-                schema: getSchema(property, '', true)
-            };
-            params.push(param);
-        })
-        return { segment: (keyAsSegment ? '' : '(') + segment + (keyAsSegment ? '' : ')'), parameters: params };
-    }
-
-    /**
-      * Prefix for key value in key segment
-      * @param {typename} Qualified name of key property type
-      * @return {string} value prefix
-      */
-    function pathValuePrefix(typename) {
-        //TODO: handle other Edm types, enumeration types, and type definitions
-        if (['Edm.Int64', 'Edm.Int32', 'Edm.Int16', 'Edm.SByte', 'Edm.Byte',
-            'Edm.Double', 'Edm.Single', 'Edm.Date', 'Edm.DateTimeOffset', 'Edm.Guid'].includes(typename)) return '';
-        if (keyAsSegment) return '';
-        return `'`;
-    }
-
-    /**
-     * Suffix for key value in key segment
-     * @param {typename} Qualified name of key property type
-     * @return {string} value prefix
-     */
-    function pathValueSuffix(typename) {
-        //TODO: handle other Edm types, enumeration types, and type definitions
-        if (['Edm.Int64', 'Edm.Int32', 'Edm.Int16', 'Edm.SByte', 'Edm.Byte',
-            'Edm.Double', 'Edm.Single', 'Edm.Date', 'Edm.DateTimeOffset', 'Edm.Guid'].includes(typename)) return '';
-        if (keyAsSegment) return '';
-        return `'`;
-    }
-
-    /**
-     * Add path and Path Item Object for actions and functions bound to the element
-     * @param {object} paths Paths Object to augment
-     * @param {string} prefix Prefix for path
-     * @param {Array} prefixParameters Parameter Objects for prefix
-     * @param {object} element Model element the operations are bound to
-     * @param {string} sourceName Name of path source
-     * @param {boolean} byKey read by key
-     */
-    function pathItemsForBoundOperations(paths, prefix, prefixParameters, element, sourceName, byKey = false) {
-        const overloads = boundOverloads[element.$Type + (!byKey && element.$Collection ? '-c' : '')] || [];
-        overloads.forEach(item => {
-            if (item.overload.$Kind == 'Action')
-                pathItemAction(paths, prefix + '/' + item.name, prefixParameters, item.name, item.overload, sourceName);
-            else
-                pathItemFunction(paths, prefix + '/' + item.name, prefixParameters, item.name, item.overload, sourceName);
-        });
-    }
-
-    /**
-    * Add path and Path Item Object for an action import
-    * @param {object} paths Paths Object to augment
-    * @param {string} name Name of action import
-    * @param {object} child Action import object
-    */
-    function pathItemActionImport(paths, name, child) {
-        const overload = modelElement(child.$Action).find(pOverload => !pOverload.$IsBound);
-        pathItemAction(paths, '/' + name, [], child.$Action, overload, child.$EntitySet, child);
-    }
-
-    /**
-     * Add path and Path Item Object for action overload
-     * @param {object} paths Paths Object to augment
-     * @param {string} prefix Prefix for path
-     * @param {Array} prefixParameters Parameter Objects for prefix
-     * @param {string} actionName Qualified name of function
-     * @param {object} overload Function overload
-     * @param {string} sourceName Name of path source
-     * @param {string} actionImport Action import
-     */
-    function pathItemAction(paths, prefix, prefixParameters, actionName, overload, sourceName, actionImport = {}) {
-        const name = actionName.indexOf('.') === -1 ? actionName : nameParts(actionName).name;
-        const pathItem = {
-            post: {
-                summary: actionImport[voc.Core.Description] || overload[voc.Core.Description] || 'Invokes action ' + name,
-                tags: [overload[voc.Common.Label] || sourceName || 'Service Operations'],
-                responses: overload.$ReturnType ? response(200, "Success", overload.$ReturnType, overload[voc.Capabilities.OperationRestrictions]?.ErrorResponses)
-                    : response(204, "Success", undefined, overload[voc.Capabilities.OperationRestrictions]?.ErrorResponses),
-            }
-        };
-        const description = actionImport[voc.Core.LongDescription] || overload[voc.Core.LongDescription];
-        if (description) pathItem.post.description = description;
-        if (prefixParameters.length > 0) pathItem.post.parameters = [...prefixParameters];
-        let parameters = overload.$Parameter || [];
-        if (overload.$IsBound) parameters = parameters.slice(1);
-        if (parameters.length > 0) {
-            const requestProperties = {};
-            parameters.forEach(p => { requestProperties[p.$Name] = getSchema(p) });
-            pathItem.post.requestBody = {
-                description: 'Action parameters',
-                content: {
-                    'application/json': {
-                        schema: {
-                            type: 'object',
-                            properties: requestProperties
-                        }
-                    }
-                }
-            }
-        }
-        customParameters(pathItem.post, overload[voc.Capabilities.OperationRestrictions] || {});
-        paths[prefix] = pathItem;
-    }
-
-    /**
-     * Add path and Path Item Object for an action import
-     * @param {object} paths Paths Object to augment
-     * @param {string} name Name of function import
-     * @param {object} child Function import object
-     */
-    function pathItemFunctionImport(paths, name, child) {
-        const overloads = modelElement(child.$Function);
-        console.assert(overloads, 'Unknown function "' + child.$Function + '" in function import "' + name + '"');
-        overloads && overloads.filter(overload => !overload.$IsBound).forEach(overload => pathItemFunction(paths, '/' + name, [], child.$Function, overload, child.$EntitySet, child));
-    }
-
-    /**
-     * Add path and Path Item Object for function overload
-     * @param {object} paths Paths Object to augment
-     * @param {string} prefix Prefix for path
-     * @param {Array} prefixParameters Parameter Objects for prefix
-     * @param {string} functionName Qualified name of function
-     * @param {object} overload Function overload
-     * @param {string} sourceName Name of path source
-     * @param {object} functionImport Function Import
-     */
-    function pathItemFunction(paths, prefix, prefixParameters, functionName, overload, sourceName, functionImport = {}) {
-        const name = functionName.indexOf('.') === -1 ? functionName : nameParts(functionName).name;
-        let parameters = overload.$Parameter || [];
-        if (overload.$IsBound) parameters = parameters.slice(1);
-        const pathSegments = [];
-        const params = [];
-
-        const implicitAliases = csdl.$Version > '4.0' || parameters.some(p => p[voc.Core.OptionalParameter]);
-
-        parameters.forEach(p => {
-            const param = {
-                required: implicitAliases ? !p[voc.Core.OptionalParameter] : true
-            };
-            const description = [p[voc.Core.Description], p[voc.Core.LongDescription]].filter(t => t).join('  \n');
-            if (description) param.description = description;
-            const type = modelElement(p.$Type || 'Edm.String');
-            // TODO: check whether parameter or type definition of Edm.Stream is annotated with JSON.Schema
-            if (p.$Collection || p.$Type == 'Edm.Stream'
-                || type && ['ComplexType', 'EntityType'].includes(type.$Kind)
-                || type && type.$UnderlyingType == 'Edm.Stream') {
-                param.in = 'query';
-                if (implicitAliases) {
-                    param.name = p.$Name;
-                } else {
-                    pathSegments.push(p.$Name + '=@' + p.$Name);
-                    param.name = '@' + p.$Name;
-                }
-                param.schema = { type: 'string' };
-                if (description) param.description += '  \n'; else param.description = '';
-                param.description += 'This is '
-                    + (p.$Collection ? 'a ' : '')
-                    + 'URL-encoded JSON '
-                    + (p.$Collection ? 'array with items ' : '')
-                    + 'of type '
-                    + namespaceQualifiedName(p.$Type || 'Edm.String')
-                    + ', see [Complex and Collection Literals](https://docs.oasis-open.org/odata/odata/v4.01/odata-v4.01-part2-url-conventions.html#sec_ComplexandCollectionLiterals)';
-                param.example = p.$Collection ? '[]' : '{}';
-            } else {
-                if (implicitAliases) {
-                    param.in = 'query';
-                } else {
-                    pathSegments.push(p.$Name + "={" + p.$Name + "}");
-                    param.in = 'path';
-                }
-                param.name = p.$Name;
-                if (!p.$Type || p.$Type === "Edm.String" || (type && (!type.$Type || type.$Type === "Edm.String"))) {
-                    if (description) param.description += "  \n";
-                    else param.description = "";
-                    param.description += "String value needs to be enclosed in single quotes";
-                }
-                param.schema = getSchema(p, '', true, true);
-            }
-            params.push(param);
-        });
-
-        const pathParameters = implicitAliases ? '' : '(' + pathSegments.join(',') + ')';
-        const pathItem = {
-            get: {
-                summary: functionImport[voc.Core.Description] || overload[voc.Core.Description] || 'Invokes function ' + name,
-                tags: [overload[voc.Common.Label] || sourceName || 'Service Operations'],
-                parameters: prefixParameters.concat(params),
-                responses: response(200, "Success", overload.$ReturnType, overload[voc.Capabilities.OperationRestrictions]?.ErrorResponses),
-            }
-        };
-        const iDescription = functionImport[voc.Core.LongDescription] || overload[voc.Core.LongDescription];
-        if (iDescription) pathItem.get.description = iDescription;
-        customParameters(pathItem.get, overload[voc.Capabilities.OperationRestrictions] || {});
-        paths[prefix + pathParameters] = pathItem;
-    }
-
-    /**
-     * Add path and Path Item Object for batch requests
-     * @param {object} paths Paths Object to augment
-     * @param {object} container Entity container
-     */
-    function pathItemBatch(paths, container) {
-        const batchSupport = container[voc.Capabilities.BatchSupport] || {};
-        const supported = container[voc.Capabilities.BatchSupported] !== false && batchSupport.Supported !== false;
-        if (supported) {
-            const firstEntitySet = Object.keys(container).filter(child => isIdentifier(child) && container[child].$Collection)[0];
-            paths['/$batch'] = {
-                post: {
-                    summary: batchSupport[voc.Core.Description] || 'Sends a group of requests',
-                    description: (batchSupport[voc.Core.LongDescription] || 'Group multiple requests into a single request payload, see '
-                        + '[Batch Requests](http://docs.oasis-open.org/odata/odata/v4.01/odata-v4.01-part1-protocol.html#sec_BatchRequests).')
-                        + '\n\n*Please note that "Try it out" is not supported for this request.*',
-                    tags: ['Batch Requests'],
-                    requestBody: {
-                        required: true,
-                        description: 'Batch request',
-                        content: {
-                            'multipart/mixed;boundary=request-separator': {
-                                schema: {
-                                    type: 'string'
-                                },
-                                example: '--request-separator\n'
-                                    + 'Content-Type: application/http\n'
-                                    + 'Content-Transfer-Encoding: binary\n\n'
-                                    + 'GET ' + firstEntitySet + ' HTTP/1.1\n'
-                                    + 'Accept: application/json\n\n'
-                                    + '\n--request-separator--'
-                            }
-                        }
-                    },
-                    responses: {
-                        '4XX': {
-                            $ref: '#/components/responses/error'
-                        }
-                    }
-                }
-            };
-            paths['/$batch'].post.responses[csdl.$Version < '4.0' ? 202 : 200] = {
-                description: 'Batch response',
-                content: {
-                    'multipart/mixed': {
-                        schema: {
-                            type: 'string'
-                        },
-                        example: '--response-separator\n'
-                            + 'Content-Type: application/http\n\n'
-                            + 'HTTP/1.1 200 OK\n'
-                            + 'Content-Type: application/json\n\n'
-                            + '{...}'
-                            + '\n--response-separator--'
-                    }
-                }
-            };
-        }
-    }
-
-    /**
-     * Construct Responses Object
-     * @param {string} code HTTP response code
-     * @param {string} description Description
-     * @param {object} type Response type object
-     * @param {array} errors Array of operation-specific status codes with descriptions
-     */
-    function response(code, description, type, errors, isCount = true) {
-        const r = {};
-        r[code] = {
-            description: description
-        };
-        let CountPropertyObj = { [csdl.$Version > '4.0' ? '@count' : '@odata.count']: ref('count') };
-        if (code != 204) {
-            const s = getSchema(type);
-            r[code].content = {
-                'application/json': {
-                    schema: type.$Collection
-                        ? {
-                            type: 'object',
-                            title: 'Collection of ' + nameParts(type.$Type || 'Edm.String').name,
-                            properties: {
-                                ...(isCount && CountPropertyObj),
-                                value: s
-                            }
-                        }
-                        : s
-                }
-            };
-        }
-        if (errors) {
-            for (const e of errors) {
-                r[e.StatusCode] = {
-                    description: e.Description,
-                    content: {
-                        "application/json": {
-                            schema: { $ref: "#/components/schemas/error" },
-                        },
-                    },
-                };
-            }
-        } else {
-            r["4XX"] = {
-                $ref: "#/components/responses/error",
-            };
-        }
-        return r;
-    }
-
-    /**
-     * Construct the Components Object from the types of the CSDL document
-     * @param {object} csdl CSDL document
-     * @param {object} entityContainer Entity Container object
-     * @return {object} Components Object
-     */
-    function getComponents(csdl, entityContainer) {
-        const c = {
-            schemas: getSchemas(csdl)
-        };
-
-        if (csdl.$EntityContainer) {
-            c.parameters = getParameters();
-            c.responses = {
-                error: {
-                    description: 'Error',
-                    content: {
-                        'application/json': {
-                            schema: ref('error')
-                        }
-                    }
-                }
-            };
-        }
-
-        getSecuritySchemes(c, entityContainer)
-
-        return c;
-    }
-
-    /**
-     * Construct Schema Objects from the types of the CSDL document
-     * @param {object} csdl CSDL document
-     * @return {object} Map of Schema Objects
-     */
-    function getSchemas(csdl) {
-        const unordered = {};
-
-        for (const r of requiredSchemas.list) {
-            const type = modelElement(`${r.namespace}.${r.name}`);
-            if (!type) continue;
-            switch (type.$Kind) {
-                case "ComplexType":
-                case "EntityType":
-                    schemasForStructuredType(unordered, r.namespace, r.name, type, r.suffix);
-                    break;
-                case "EnumType":
-                    schemaForEnumerationType(unordered, r.namespace, r.name, type);
-                    break;
-                case "TypeDefinition":
-                    schemaForTypeDefinition(unordered, r.namespace, r.name, type);
-                    break;
-            }
-        }
-        const ordered = {};
-        for (const name of Object.keys(unordered).sort()) {
-            ordered[name] = unordered[name];
-        }
-
-        inlineTypes(ordered);
-
-        if (csdl.$EntityContainer) {
-            ordered.count = count();
-            ordered.error = error();
-        }
-
-        return ordered;
-    }
-
-    /**
-     * Construct Schema Objects from the types of the CSDL document
-     * @param {object} schemas Map of Schema Objects to augment
-     */
-    function inlineTypes(schemas) {
-        if (typesToInline.geoPoint) {
-            schemas.geoPoint = {
-                type: 'object',
-                properties: {
-                    coordinates: ref('geoPosition'),
-                    type: {
-                        type: 'string',
-                        enum: ['Point'],
-                        default: 'Point'
-                    }
-                },
-                required: ['type', 'coordinates']
-            };
-            schemas.geoPosition = {
-                type: 'array',
-                minItems: 2,
-                items: {
-                    type: 'number'
-                }
-            }
-        }
-    }
-
-    /**
-     * Construct Schema Objects for an enumeration type
-     * @param {object} schemas Map of Schema Objects to augment
-     * @param {string} qualifier Qualifier for structured type
-     * @param {string} name Simple name of structured type
-     * @param {object} type Structured type
-     * @return {object} Map of Schemas Objects
-     */
-    function schemaForEnumerationType(schemas, qualifier, name, type) {
-        const members = [];
-        Object.keys(type).filter(iName => isIdentifier(iName)).forEach(iName2 => {
-            members.push(iName2);
-        });
-
-        const s = {
-            type: 'string',
-            title: name,
-            enum: members
-        };
-        const description = type[voc.Core.LongDescription];
-        if (description) s.description = description;
-        schemas[qualifier + '.' + name] = s;
-    }
-
-    /**
-     * Construct Schema Objects for a type definition
-     * @param {object} schemas Map of Schema Objects to augment
-     * @param {string} qualifier Qualifier for structured type
-     * @param {string} name Simple name of structured type
-     * @param {object} type Structured type
-     * @return {object} Map of Schemas Objects
-     */
-    function schemaForTypeDefinition(schemas, qualifier, name, type) {
-        const s = getSchema(Object.assign({ $Type: type.$UnderlyingType }, type));
-        s.title = name;
-        const description = type[voc.Core.LongDescription];
-        if (description) s.description = description;
-        schemas[qualifier + '.' + name] = s;
-    }
-
-    /**
-     * Construct Schema Objects for a structured type
-     * @param {object} schemas Map of Schema Objects to augment
-     * @param {string} qualifier Qualifier for structured type
-     * @param {string} name Simple name of structured type
-     * @param {string} suffix Suffix for read/create/update
-     * @param {object} type Structured type
-     * @return {object} Map of Schemas Objects
-     */
-    function schemasForStructuredType(schemas, qualifier, name, type, suffix) {
-        const schemaName = qualifier + "." + name + suffix;
-        const baseName = qualifier + "." + name;
-        const isKey = keyMap(type);
-        const required = Object.keys(isKey);
-        const schemaProperties = {};
-        let isCount = true;
-        if (csdl[qualifier]?.$Annotations) {
-            const annotations = csdl[qualifier].$Annotations[`${qualifier}.EntityContainer/${name}`];
-            if (annotations && annotations[voc.Capabilities.CountRestrictions] && annotations[voc.Capabilities.CountRestrictions]?.Countable === false) {
-                isCount = false;
-            }
-        }
-        const properties = propertiesOfStructuredType(type);
-        Object.keys(properties).forEach(iName => {
-            const property = properties[iName];
-            if (suffix === SUFFIX.read) schemaProperties[iName] = getSchema(property);
-            if ((Object.prototype.hasOwnProperty.call(property, '@Common.FieldControl')) && property['@Common.FieldControl'] === 'Mandatory') { required.push(iName) }
-            if (property.$Kind == 'NavigationProperty') {
-                if (property.$Collection && suffix === "" && isCount === true) {
-                    schemaProperties[`${iName}@${csdl.$Version === '4.0' ? 'odata.' : ''}count`] = ref('count');
-                }
-                if (property[voc.Core.Permissions] != "Read" && !property[voc.Core.Computed] && ( property.$ContainsTarget || property.$OnDelete === 'Cascade') ) {
-                    if (suffix === SUFFIX.create)
-                        schemaProperties[iName] = getSchema(property, SUFFIX.create);
-                    if (suffix === SUFFIX.update)
-                        schemaProperties[iName] = getSchema(property, SUFFIX.create);
-                }
-            } else {
-                if (property[voc.Core.Permissions] === "Read" || property[voc.Core.Computed]) {
-                    let index = required.indexOf(iName);
-                    if (index != -1) required.splice(index, 1);
-                } else {
-                    if (suffix === SUFFIX.create)
-                        schemaProperties[iName] = getSchema(property, SUFFIX.create);
-                    if (suffix === SUFFIX.update && !isKey[iName] && !property[voc.Core.Immutable])
-                        schemaProperties[iName] = getSchema(property, SUFFIX.update);
-                }
-            }
-        });
-
-
-        schemas[schemaName] = {
-            title: (type[voc.Core.Description] || name) + TITLE_SUFFIX[suffix],
-            type: 'object'
-        };
-        if (Object.keys(schemaProperties).length > 0)
-            schemas[schemaName].properties = schemaProperties;
-
-        if (suffix === SUFFIX.read && type["@ODM.root"]) schemas[schemaName]["x-sap-root-entity"] = type["@ODM.root"]
-        odmExtensions(type, schemas[schemaName]);
-
-        if (suffix === SUFFIX.create && required.length > 0)
-            schemas[schemaName].required = [...new Set(required)];
-
-        const description = type[voc.Core.LongDescription];
-        if (description) {
-            schemas[schemaName].description = description;
-        }
-
-        if (derivedTypes[baseName]) {
-            schemas[schemaName].anyOf = [];
-            derivedTypes[baseName].forEach((derivedType) => {
-                schemas[schemaName].anyOf.push(ref(derivedType, suffix));
-            });
-            if (!type.$Abstract) schemas[schemaName].anyOf.push({});
-        }
-    }
-
-    /**
-     * Add ODM extensions to OpenAPI schema for a structured type
-     * @param {object} type Structured type
-     * @param {object} schema OpenAPI schema to augment
-     */
-    function odmExtensions(type, schema) {
-        for (const [annotation, openApiExtension] of Object.entries(ODM_ANNOTATIONS)) {
-            if (type[annotation]) schema[openApiExtension] = type[annotation];
-        }
-    }
-
-    /**
-     * Collect all properties of a structured type along the inheritance hierarchy
-     * @param {object} type Structured type
-     * @return {object} Map of properties
-     */
-    function propertiesOfStructuredType(type) {
-        const properties = (type && type.$BaseType) ? propertiesOfStructuredType(modelElement(type.$BaseType)) : {};
-        if (type) {
-            Object.keys(type).filter(name => isIdentifier(name)).forEach(name => {
-                properties[name] = type[name];
-            });
-        }
-        return properties;
-    }
-
-    /**
-     * Construct Parameter Objects for type-independent OData system query options
-     * @return {object} Map of Parameter Objects
-     */
-    function getParameters() {
-        const param = {
-            top: {
-                name: queryOptionPrefix + 'top',
-                in: 'query',
-                description: 'Show only the first n items, see [Paging - Top](http://docs.oasis-open.org/odata/odata/v4.01/odata-v4.01-part1-protocol.html#sec_SystemQueryOptiontop)',
-                schema: {
-                    type: 'integer',
-                    minimum: 0
-                },
-                example: 50
-            },
-            skip: {
-                name: queryOptionPrefix + 'skip',
-                in: 'query',
-                description: 'Skip the first n items, see [Paging - Skip](http://docs.oasis-open.org/odata/odata/v4.01/odata-v4.01-part1-protocol.html#sec_SystemQueryOptionskip)',
-                schema: {
-                    type: 'integer',
-                    minimum: 0
-                }
-            },
-            count: {
-                name: queryOptionPrefix + 'count',
-                in: 'query',
-                description: 'Include count of items, see [Count](http://docs.oasis-open.org/odata/odata/v4.01/odata-v4.01-part1-protocol.html#sec_SystemQueryOptioncount)',
-                schema: {
-                    type: 'boolean'
-                }
-            }
-        };
-
-        if (csdl.$Version >= '4.0') param.search = {
-            name: queryOptionPrefix + 'search',
-            in: 'query',
-            description: 'Search items by search phrases, see [Searching](http://docs.oasis-open.org/odata/odata/v4.01/odata-v4.01-part1-protocol.html#sec_SystemQueryOptionsearch)',
-            schema: {
-                type: 'string'
-            }
-        };
-
-        return param;
-    }
-
-    /**
-     * Construct OData error response
-     * @return {object} Error response schema
-     */
-    function error() {
-        const err = {
-            type: 'object',
-            required: ['error'],
-            properties: {
-                error: {
-                    type: 'object',
-                    required: ['code', 'message'],
-                    properties: {
-                        code: { type: 'string' },
-                        message: { type: 'string' },
-                        target: { type: 'string' },
-                        details: {
-                            type: 'array',
-                            items: {
-                                type: 'object',
-                                required: ['code', 'message'],
-                                properties: {
-                                    code: { type: 'string' },
-                                    message: { type: 'string' },
-                                    target: { type: 'string' }
-                                }
-                            }
-                        },
-                        innererror: {
-                            type: 'object',
-                            description: 'The structure of this object is service-specific'
-                        }
-                    }
-                }
-            }
-        };
-
-        if (csdl.$Version < '4.0') {
-            err.properties.error.properties.message = {
-                type: 'object',
-                properties: {
-                    lang: { type: 'string' },
-                    value: { type: 'string' }
-                },
-                required: ['lang', 'value']
-            };
-            delete err.properties.error.properties.details;
-            delete err.properties.error.properties.target;
-        }
-
-        return err;
-    }
-
-    /**
-     * Construct OData count response
-     * @return {object} Count response schema
-     */
-    function count() {
-        return {
-            anyOf: [
-                { type: 'number' },
-                { type: 'string' }
-            ],
-            description: 'The number of entities in the collection. Available when using the [$count](http://docs.oasis-open.org/odata/odata/v4.01/odata-v4.01-part1-protocol.html#sec_SystemQueryOptioncount) query option.',
-        };
-    }
-
-    /**
-     * Construct Schema Object for model object referencing a type
-     * @param {object} modelElement referencing a type
-     * @return {object} Schema Object
-     */
-    function getSchema(element, suffix = '', forParameter = false, forFunction = false) {
-        let s = {};
-        switch (element.$Type) {
-            case 'Edm.AnnotationPath':
-            case 'Edm.ModelElementPath':
-            case 'Edm.NavigationPropertyPath':
-            case 'Edm.PropertyPath':
-                s.type = 'string';
-                break;
-            case 'Edm.Binary':
-                s = {
-                    type: 'string',
-                    format: 'base64url'
-                };
-                if (element.$MaxLength) s.maxLength = Math.ceil(4 * element.$MaxLength / 3);
-                break;
-            case 'Edm.Boolean':
-                s.type = 'boolean';
-                break;
-            case 'Edm.Byte':
-                s = {
-                    type: 'integer',
-                    format: 'uint8'
-                };
-                break;
-            case 'Edm.Date':
-                s = {
-                    type: 'string',
-                    format: 'date',
-                    example: '2017-04-13'
-                };
-                break;
-            case 'Edm.DateTime':
-            case 'Edm.DateTimeOffset':
-                s = {
-                    type: 'string',
-                    format: 'date-time',
-                    example: '2017-04-13T15:51:04' + (isNaN(element.$Precision) || element.$Precision === 0 ? '' : '.' + '0'.repeat(element.$Precision)) + 'Z'
-                };
-                break;
-            case 'Edm.Decimal':
-                s = {
-                    anyOf: [{ type: 'number', format: 'decimal' }, { type: 'string' }],
-                    example: 0
-                };
-                if (!isNaN(element.$Precision)) s['x-sap-precision'] = element.$Precision;
-                if (!isNaN(element.$Scale)) s['x-sap-scale'] = element.$Scale;
-                // eslint-disable-next-line no-case-declarations
-                let scale = !isNaN(element.$Scale) ? element.$Scale : null;
-                if (scale !== null) {
-                    // Node.js 12.13.0 has problems with negative exponents, 10 ** -5 --> 0.000009999999999999999
-                    if (scale <= 0)
-                        s.anyOf[0].multipleOf = 10 ** -scale;
-                    else
-                        s.anyOf[0].multipleOf = 1 / 10 ** scale;
-                }
-                if (element.$Precision < 16) {
-                    let limit = 10 ** (element.$Precision - scale);
-                    let delta = 10 ** -scale;
-                    s.anyOf[0].maximum = limit - delta;
-                    s.anyOf[0].minimum = -s.anyOf[0].maximum;
-                }
-                break;
-            case 'Edm.Double':
-                s = {
-                    anyOf: [{ type: 'number', format: 'double' }, { type: 'string' }],
-                    example: 3.14
-                };
-                break;
-            case 'Edm.Duration':
-                s = {
-                    type: 'string',
-                    format: 'duration',
-                    example: 'P4DT15H51M04S'
-                };
-                break;
-            case 'Edm.GeographyPoint':
-            case 'Edm.GeometryPoint':
-                s = ref('geoPoint');
-                typesToInline.geoPoint = true;
-                break;
-            case 'Edm.Guid':
-                s = {
-                    type: 'string',
-                    format: 'uuid',
-                    example: '01234567-89ab-cdef-0123-456789abcdef'
-                };
-                break;
-            case 'Edm.Int16':
-                s = {
-                    type: 'integer',
-                    format: 'int16'
-                };
-                break;
-            case 'Edm.Int32':
-                s = {
-                    type: 'integer',
-                    format: 'int32'
-                };
-                break;
-            case 'Edm.Int64':
-                s = {
-                    anyOf: [{ type: 'integer', format: 'int64' }, { type: 'string' }],
-                    example: "42"
-                };
-                break;
-            case 'Edm.PrimitiveType':
-                s = {
-                    anyOf: [{ type: 'boolean' }, { type: 'number' }, { type: 'string' }]
-                };
-                break;
-            case 'Edm.SByte':
-                s = {
-                    type: 'integer',
-                    format: 'int8'
-                };
-                break;
-            case 'Edm.Single':
-                s = {
-                    anyOf: [{ type: 'number', format: 'float' }, { type: 'string' }],
-                    example: 3.14
-                };
-                break;
-            case 'Edm.Stream':
-                // eslint-disable-next-line no-case-declarations
-                let jsonSchema = element[voc.JSON.Schema];
-                if (jsonSchema) {
-                    if (typeof jsonSchema == 'string')
-                        s = JSON.parse(jsonSchema);
-                    else
-                        s = jsonSchema;
-                } else {
-                    s = {
-                        type: 'string',
-                        format: 'base64url'
-                    };
-                }
-                break;
-            case 'Edm.String':
-            case undefined:
-                s.type = 'string';
-                if (element.$MaxLength) s.maxLength = element.$MaxLength;
-                allowedValues(s, element);
-                getPattern(s, element);
-                break;
-            case 'Edm.TimeOfDay':
-                s = {
-                    type: 'string',
-                    format: 'time',
-                    example: '15:51:04'
-                };
-                break;
-            default:
-                if (element.$Type.startsWith('Edm.')) {
-                    console.warn('Unknown type: ' + element.$Type);
-                } else {
-                    let type = modelElement(element.$Type);
-                    let isStructured = type && ['ComplexType', 'EntityType'].includes(type.$Kind);
-                    s = ref(element.$Type, (isStructured ? suffix : ''));
-                    if (element.$MaxLength) {
-                        s = {
-                            allOf: [s],
-                            maxLength: element.$MaxLength
-                        };
-                    }
-                }
-        }
-
-        if (element.$Nullable) {
-            if (s.$ref) s = { allOf: [s] };
-            s.nullable = true;
-        }
-
-        if (element.$DefaultValue !== undefined) {
-            if (s.$ref) s = { allOf: [s] };
-            s.default = element.$DefaultValue;
-        }
-
-        if (element[voc.Core.Example]) {
-            if (s.$ref) s = { allOf: [s] };
-            s.example = element[voc.Core.Example].Value;
-        }
-
-        if (forFunction) {
-            if (s.example && typeof s.example === "string") {
-                s.example = `${pathValuePrefix(element.$Type)}${s.example
-                    }${pathValueSuffix(element.$Type)} `;
-            }
-            if (s.pattern) {
-                const pre = pathValuePrefix(element.$Type);
-                const suf = pathValueSuffix(element.$Type);
-                s.pattern = s.pattern.replace(/^\^/, `^ ${pre} (`);
-                s.pattern = s.pattern.replace(/\$$/, `)${suf} $`);
-            } else if (!element.$Type || element.$Type === "Edm.String") {
-                s.pattern = "^'([^']|'')*'$";
-            }
-            if (element.$Nullable) {
-                if (!s.anyOf && !s.allOf) s.type = "string";
-                if (s.format) s.format += ",null";
-                if (s.anyOf && s.anyOf[0].format) s.anyOf[0].format += ",null";
-                s.default = "null";
-                if (s.pattern) {
-                    s.pattern = s.pattern.replace(/^\^/, "^(null|");
-                    s.pattern = s.pattern.replace(/\$$/, ")$");
-                }
-            }
-        }
-
-        if (element[voc.Validation.Maximum] != undefined) {
-            if (s.$ref) s = { allOf: [s] };
-            if (s.anyOf) {
-                s.anyOf[0].maximum = element[voc.Validation.Maximum];
-            }
-            if (element[voc.Validation.Maximum + voc.Validation.Exclusive]) s.exclusiveMaximum = true;
-        }
-
-        if (element[voc.Validation.Minimum] != undefined) {
-            if (s.$ref) s = { allOf: [s] };
-            if (s.anyOf) {
-                s.anyOf[0].minimum = element[voc.Validation.Minimum];
-            }
-            if (element[voc.Validation.Minimum + voc.Validation.Exclusive]) s.exclusiveMinimum = true;
-        }
-
-        if (element.$Collection) {
-            s = {
-                type: 'array',
-                items: s
-            };
-        }
-
-        if (!forParameter && element[voc.Core.LongDescription]) {
-            if (s.$ref) s = { allOf: [s] };
-            s.description = element[voc.Core.LongDescription];
-        }
-
-        if (element['@ODM.oidReference']?.entityName) {
-            s['x-sap-odm-oid-reference-entity-name'] = element['@ODM.oidReference'].entityName
-        }
-
-        return s;
-    }
-
-    /**
-     * Add allowed values enum to Schema Object for string-like model element
-     * @param {object} schema Schema Object to augment
-     * @param {object} element Model element
-     */
-    function allowedValues(schema, element) {
-        const values = element[voc.Validation.AllowedValues];
-        if (values) schema.enum = values.map(record => record.Value);
-    }
-
-    /**
-     * Add pattern to Schema Object for string-like model element
-     * @param {object} schema Schema Object to augment
-     * @param {object} element Model element
-     */
-    function getPattern(schema, element) {
-        const pattern = element[voc.Validation.Pattern];
-        if (pattern) schema.pattern = pattern;
-    }
-
-    /**
-     * Construct Reference Object for a type
-     * @param {string} typename Qualified name of referenced type
-     * @param {string} suffix Optional suffix for referenced schema
-     * @return {object} Reference Object
-     */
-    function ref(typename, suffix = '') {
-        let name = typename;
-        let nsp = '';
-        let url = '';
-        if (typename.indexOf('.') != -1) {
-            let parts = nameParts(typename);
-            nsp = namespace[parts.qualifier];
-            name = nsp + '.' + parts.name;
-            url = namespaceUrl[nsp] || '';
-            if (url === "" && !requiredSchemas.used[name + suffix]) {
-                requiredSchemas.used[name + suffix] = true;
-                requiredSchemas.list.push({ namespace: nsp, name: parts.name, suffix });
-            }
-            //TODO: introduce better way than guessing
-            if (url.endsWith('.xml')) url = url.substring(0, url.length - 3) + "openapi3.json";
-        }
-        return {
-            $ref: url + '#/components/schemas/' + name + suffix
-        };
-    }
-
-    /**
-     * Augment Components Object with map of Security Scheme Objects
-     * @param {object} components Components Object to augment
-     * @param {object} entityContainer Entity Container object
-     */
-    function getSecuritySchemes(components, entityContainer) {
-        const authorizations = entityContainer && entityContainer[voc.Authorization.Authorizations] ? entityContainer[voc.Authorization.Authorizations] : [];
-        const schemes = {};
-        const location = { Header: 'header', QueryOption: 'query', Cookie: 'cookie' };
-        authorizations.forEach(auth => {
-            const scheme = {};
-            const flow = {};
-            if (auth.Description) scheme.description = auth.Description;
-            const qualifiedType = auth['@type'] || auth['@odata.type']
-            const type = qualifiedType.substring(qualifiedType.lastIndexOf(".") + 1);
-            let unknown = false
-            switch (type) {
-                case 'ApiKey':
-                    scheme.type = 'apiKey';
-                    scheme.name = auth.KeyName;
-                    scheme.in = location[auth.Location];
-                    break;
-                case 'Http':
-                    scheme.type = 'http';
-                    scheme.scheme = auth.Scheme;
-                    scheme.bearerFormat = auth.BearerFormat;
-                    break;
-                case 'OAuth2AuthCode':
-                    scheme.type = 'oauth2';
-                    scheme.flows = { authorizationCode: flow };
-                    flow.authorizationUrl = auth.AuthorizationUrl;
-                    flow.tokenUrl = auth.TokenUrl;
-                    if (auth.RefreshUrl) flow.refreshUrl = auth.RefreshUrl;
-                    flow.scopes = getScopes(auth);
-                    break;
-                case 'OAuth2ClientCredentials':
-                    scheme.type = 'oauth2';
-                    scheme.flows = { clientCredentials: flow };
-                    flow.tokenUrl = auth.TokenUrl;
-                    if (auth.RefreshUrl) flow.refreshUrl = auth.RefreshUrl;
-                    flow.scopes = getScopes(auth);
-                    break;
-                case 'OAuth2Implicit':
-                    scheme.type = 'oauth2';
-                    scheme.flows = { implicit: flow };
-                    flow.authorizationUrl = auth.AuthorizationUrl;
-                    if (auth.RefreshUrl) flow.refreshUrl = auth.RefreshUrl;
-                    flow.scopes = getScopes(auth);
-                    break;
-                case 'OAuth2Password':
-                    scheme.type = 'oauth2';
-                    scheme.flows = {};
-                    scheme.flows = { password: flow };
-                    flow.tokenUrl = auth.TokenUrl;
-                    if (auth.RefreshUrl) flow.refreshUrl = auth.RefreshUrl;
-                    flow.scopes = getScopes(auth);
-                    break;
-                case 'OpenIDConnect':
-                    scheme.type = 'openIdConnect';
-                    scheme.openIdConnectUrl = auth.IssuerUrl;
-                    break;
-                default:
-                    unknown = true
-                    console.warn('Unknown Authorization type ' + qualifiedType);
-            }
-            if (!unknown) schemes[auth.Name] = scheme;
-        });
-        if (Object.keys(schemes).length > 0) components.securitySchemes = schemes
-    }
-
-    function getScopes(authorization) {
-        const scopes = {};
-        authorization.Scopes.forEach(scope => { scopes[scope.Scope] = scope.Description });
-        return scopes;
-    }
-
-    /**
-     * Augment OpenAPI document with Security Requirements Object
-     * @param {object} openapi OpenAPI document to augment
-     * @param {object} entityContainer Entity Container object
-     */
-    function security(openapi, entityContainer) {
-        const securitySchemes = entityContainer && entityContainer[voc.Authorization.SecuritySchemes] ? entityContainer[voc.Authorization.SecuritySchemes] : [];
-        if (securitySchemes.length > 0) openapi.security = [];
-        securitySchemes.forEach(scheme => {
-            const s = {};
-            s[scheme.Authorization] = scheme.RequiredScopes || [];
-            openapi.security.push(s);
-        });
-    }
-
-    /**
-     * a qualified name consists of a namespace or alias, a dot, and a simple name
-     * @param {string} qualifiedName
-     * @return {string} namespace-qualified name
-     */
-    function namespaceQualifiedName(qualifiedName) {
-        let np = nameParts(qualifiedName);
-        return namespace[np.qualifier] + '.' + np.name;
-    }
-
-    /**
-     * a qualified name consists of a namespace or alias, a dot, and a simple name
-     * @param {string} qualifiedName
-     * @return {object} with components qualifier and name
-     */
-    function nameParts(qualifiedName) {
-        const pos = qualifiedName.lastIndexOf('.');
-        console.assert(pos > 0, 'Invalid qualified name ' + qualifiedName);
-        return {
-            qualifier: qualifiedName.substring(0, pos),
-            name: qualifiedName.substring(pos + 1)
-        };
-    }
-
-    /**
-     * an identifier does not start with $ and does not contain @
-     * @param {string} name
-     * @return {boolean} name is an identifier
-     */
-    function isIdentifier(name) {
-        return !name.startsWith('$') && !name.includes('@');
-    }
-
-};