@sap/cds 8.9.4 → 9.0.2

package/libx/_runtime/cds-services/adapter/odata-v4/okra/odata-commons/edm/EdmEntityContainer.js

@@ -1,455 +0,0 @@
-'use strict'
-
-const EdmAnnotation = require('./EdmAnnotation')
-const EdmEntitySet = require('./EdmEntitySet')
-const EdmSingleton = require('./EdmSingleton')
-const EdmActionImport = require('./EdmActionImport')
-const EdmFunctionImport = require('./EdmFunctionImport')
-const validateThat = require('../validator/ParameterValidator').validateThat
-
-/**
- * <a href="./../ODataSpecification/odata-v4.0-errata03-os/complete/part3-csdl/odata-v4.0-errata03-os-part3-csdl-complete.html#_Toc453752597">
- *     OData CSDL # 13.1 Element edm:EntityContainer
- * </a>
- * @hideconstructor
- */
-class EdmEntityContainer {
-  /**
-   * Constructor
-   * Use factory method EdmEntityContainer.createWithFQN or
-   * EdmEntityContainer.createWithContainerInfo to create an entity container
-   *
-   * @param {Edm} edm The edm itself
-   * @param {CsdlProvider} provider Provider for the Csdl artifacts
-   * @param {CsdlEntityContainerInfo} [entityContainerInfo] Entity container info
-   * @param {FullQualifiedName} [fqn] Full qualified name
-   * @param {CsdlEntityContainer} [entityContainer]  Entity container
-   * @param {Object} [configuration]  Edm configuration object
-   */
-  constructor (edm, provider, entityContainerInfo, fqn, entityContainer, configuration = {}) {
-    validateThat('edm', edm).truthy()
-    validateThat('provider', provider).truthy()
-    if (!entityContainerInfo) {
-      validateThat('fqn', fqn).truthy()
-      validateThat('entityContainer', entityContainer).truthy()
-    }
-
-    /**
-     * @type {Edm}
-     * @private
-     */
-    this._edm = edm
-
-    /**
-     * @type {string}
-     * @private
-     */
-    this._name = null
-
-    /**
-     * @type {FullQualifiedName}
-     * @private
-     */
-    this._entityContainerName = null
-
-    /**
-     * @type {FullQualifiedName}
-     * @private
-     */
-    this._parentContainerName = null
-
-    /**
-     * @type {CsdlEntityContainer}
-     * @private
-     */
-    this._container = null
-
-    /**
-     * @type {CsdlProvider}
-     * @private
-     */
-    this._provider = provider
-
-    if (entityContainerInfo) {
-      this._name = entityContainerInfo.name.name
-      this._entityContainerName = entityContainerInfo.name
-      this._parentContainerName = entityContainerInfo.extends
-    } else {
-      this._name = fqn.name
-      this._container = entityContainer
-      this._entityContainerName = fqn
-      this._parentContainerName = entityContainer.extends
-    }
-
-    /**
-     * @type {EdmSingleton[]}
-     * @private
-     */
-    this._singletons = null
-
-    /**
-     * @type {Map.<string, EdmSingleton>}
-     * @private
-     */
-    this._singletonCache = new Map()
-
-    /**
-     * @type {EdmEntitySet[]}
-     * @private
-     */
-    this._entitySets = null
-
-    /**
-     * @type {Map.<string, EdmEntitySet>}
-     * @private
-     */
-    this._entitySetCache = new Map()
-
-    /**
-     * @type {EdmActionImport[]}
-     * @private
-     */
-    this._actionImports = null
-
-    /**
-     * @type {Map.<string, EdmActionImport>}
-     * @private
-     */
-    this._actionImportCache = new Map()
-
-    /**
-     * @type {EdmFunctionImport[]}
-     * @private
-     */
-    this._functionImports = null
-
-    /**
-     * @type {Map.<string, EdmFunctionImport>}
-     * @private
-     */
-    this._functionImportCache = new Map()
-
-    /**
-     * @type {EdmAnnotation[]}
-     * @private
-     */
-    this._annotations = null
-
-    this._configuration = configuration
-  }
-
-  /**
-   * Return Namespace.
-   * @returns {string} the namespace
-   */
-  getNamespace () {
-    return this._entityContainerName.namespace
-  }
-
-  /**
-   * Return name.
-   * @returns {string} the name
-   */
-  getName () {
-    return this._entityContainerName.name
-  }
-
-  /**
-   * Return full qualified name.
-   * @returns {FullQualifiedName} the full-qualified name
-   */
-  getFullQualifiedName () {
-    return this._entityContainerName
-  }
-
-  /**
-   * Get contained singleton by name.
-   * @param {string} singletonName Name of singleton, or null if not found
-   * @returns {?EdmSingleton} the singleton
-   */
-  getSingleton (singletonName) {
-    let singleton = this._singletonCache.get(singletonName) // EdmSingleton
-    if (!singleton) {
-      singleton = this._createSingleton(singletonName)
-      if (singleton) this._singletonCache.set(singletonName, singleton)
-    }
-    return singleton
-  }
-
-  /**
-   * Get contained entity set by name.
-   * @param {string} entitySetName Name of entity set, or null if not found
-   * @returns {?EdmEntitySet} the entity set
-   */
-  getEntitySet (entitySetName) {
-    let entitySet = this._entitySetCache.get(entitySetName)
-    if (!entitySet) {
-      entitySet = this._createEntitySet(entitySetName)
-      if (entitySet) this._entitySetCache.set(entitySetName, entitySet)
-    }
-    return entitySet
-  }
-
-  /**
-   * Get contained action import by name, or null if not found.
-   * @param {string} actionImportName Name of action import
-   * @returns {?EdmActionImport} the action import
-   */
-  getActionImport (actionImportName) {
-    let actionImport = this._actionImportCache.get(actionImportName)
-    if (!actionImport) {
-      actionImport = this._createActionImport(actionImportName)
-      if (actionImport) this._actionImportCache.set(actionImportName, actionImport)
-    }
-    return actionImport
-  }
-
-  /**
-   * Get contained function import by name.
-   * @param {string} functionImportName Name of function import
-   * @returns {?EdmFunctionImport} the function import
-   */
-  getFunctionImport (functionImportName) {
-    let functionImport = this._functionImportCache.get(functionImportName)
-    if (!functionImport) {
-      functionImport = this._createFunctionImport(functionImportName)
-      if (functionImport) this._functionImportCache.set(functionImportName, functionImport)
-    }
-    return functionImport
-  }
-
-  /**
-   * Returns all singletons.
-   * @returns {EdmSingleton[]} the singletons
-   */
-  getSingletons () {
-    if (!this._singletons) this._loadAllSingletons()
-    return this._singletons
-  }
-
-  /**
-   * Returns all entity sets.
-   * @returns {EdmEntitySet[]} the entity sets
-   */
-  getEntitySets () {
-    if (!this._entitySets) this._loadAllEntitySets()
-    return this._entitySets
-  }
-
-  /**
-   * Loads and returns all action imports.
-   * @returns {EdmActionImport[]} the action imports
-   */
-  getActionImports () {
-    if (!this._actionImports) this._loadAllActionImports()
-    return this._actionImports
-  }
-
-  /**
-   * Loads and returns all function imports.
-   * @returns {EdmFunctionImport[]} the function imports
-   */
-  getFunctionImports () {
-    if (!this._functionImports) this._loadAllFunctionImports()
-    return this._functionImports
-  }
-
-  /**
-   * Returns the {@link FullQualifiedName} of the parent container or null if no parent is specified.
-   * @returns {FullQualifiedName} the full.qualified name of the parent container
-   */
-  getParentContainerName () {
-    return this._parentContainerName
-  }
-
-  /**
-   * Creates a EdmSingleton instance using the CSDL provider.
-   * @param {string} singletonName Name of the singleton
-   * @returns {EdmSingleton} the singleton
-   * @private
-   */
-  _createSingleton (singletonName) {
-    const providerSingleton = this._provider.getSingleton(this._entityContainerName, singletonName)
-    const config = this._getArtifactConfiguration(this.getNamespace(), singletonName)
-
-    return providerSingleton ? new EdmSingleton(this._edm, this, providerSingleton, config) : null
-  }
-
-  /**
-   * Creates a EdmEntitySet instance using the CSDL provider.
-   * @param {string} entitySetName Name of the entity set
-   * @returns {EdmEntitySet} the entity set
-   * @private
-   */
-  _createEntitySet (entitySetName) {
-    const providerEntitySet = this._provider.getEntitySet(this._entityContainerName, entitySetName)
-    const config = this._getArtifactConfiguration(this.getNamespace(), entitySetName)
-
-    return providerEntitySet ? new EdmEntitySet(this._edm, this, providerEntitySet, config) : null
-  }
-
-  /**
-   * Creates a EdmActionImport instance using the CSDL provider.
-   * @param {string} actionImportName Name of the action import
-   * @returns {EdmActionImport} the action import
-   * @private
-   */
-  _createActionImport (actionImportName) {
-    const providerImport = this._provider.getActionImport(this._entityContainerName, actionImportName)
-    return providerImport ? new EdmActionImport(this._edm, this, providerImport) : null
-  }
-
-  /**
-   * Creates a EdmFunctionImport instance using the CSDL provider.
-   * @param {string} functionImportName Name of the function import
-   * @returns {EdmFunctionImport} the function import
-   * @private
-   */
-  _createFunctionImport (functionImportName) {
-    const providerImport = this._provider.getFunctionImport(this._entityContainerName, functionImportName)
-    return providerImport ? new EdmFunctionImport(this._edm, this, providerImport) : null
-  }
-
-  /**
-   * Load all singletons from the Csdl provider into the caches.
-   * @private
-   */
-  _loadAllSingletons () {
-    this._loadContainer()
-    const providerSingletons = this._container.singletons
-
-    this._singletons = []
-    if (providerSingletons) {
-      for (const csdlSingleton of providerSingletons) {
-        // CsdlSingleton
-        const config = this._getArtifactConfiguration(this.getNamespace(), csdlSingleton.name)
-        const singleton = new EdmSingleton(this._edm, this, csdlSingleton, config) // EdmSingletonImpl
-        this._singletonCache.set(csdlSingleton.name, singleton)
-        this._singletons.push(singleton)
-      }
-    }
-  }
-
-  /**
-   * Load all entity sets from the Csdl provider into the caches.
-   * @private
-   */
-  _loadAllEntitySets () {
-    this._loadContainer()
-    const providerEntitySets = this._container.entitySets // CsdlEntitySet
-
-    this._entitySets = []
-    if (providerEntitySets) {
-      for (const csdlEntitySet of providerEntitySets) {
-        const config = this._getArtifactConfiguration(this.getNamespace(), csdlEntitySet.name)
-        const entitySet = new EdmEntitySet(this._edm, this, csdlEntitySet, config)
-        this._entitySetCache.set(entitySet.getName(), entitySet)
-        this._entitySets.push(entitySet)
-      }
-    }
-  }
-
-  /**
-   * Load all action imports from the Csdl provider into the caches.
-   * @private
-   */
-  _loadAllActionImports () {
-    this._loadContainer()
-    const providerActionImports = this._container.actionImports
-
-    this._actionImports = []
-    if (providerActionImports) {
-      for (const csdlActionImport of providerActionImports) {
-        const actionImport = new EdmActionImport(this._edm, this, csdlActionImport)
-        this._actionImportCache.set(actionImport.name, actionImport)
-        this._actionImports.push(actionImport)
-      }
-    }
-  }
-
-  /**
-   * Load all function imports from the Csdl provider into the caches.
-   * @private
-   */
-  _loadAllFunctionImports () {
-    this._loadContainer()
-    const providerFunctionImports = this._container.functionImports
-
-    this._functionImports = []
-    if (providerFunctionImports) {
-      for (const csdlFunctionImport of providerFunctionImports) {
-        const functionImport = new EdmFunctionImport(this._edm, this, csdlFunctionImport)
-        this._functionImportCache.set(functionImport.name, functionImport)
-        this._functionImports.push(functionImport)
-      }
-    }
-  }
-
-  /**
-   * Load CsdlEntityContainer object from the Csdl provider if the EdmEntityContainer
-   * was created with an CsdlContainerInfo object.
-   * @private
-   */
-  _loadContainer () {
-    if (!this._container) {
-      /**
-       * @type {CsdlEntityContainer}
-       * @private
-       */
-      this._container = this._provider.getEntityContainer(this._entityContainerName)
-    }
-  }
-
-  /**
-   * Returns the annotations for this object.
-   * @returns {EdmAnnotation[]} the annotations
-   */
-  getAnnotations () {
-    this._loadContainer()
-
-    if (!this._annotations) {
-      this._annotations = this._container.annotations.map(item => new EdmAnnotation(this._edm, item))
-    }
-    return this._annotations
-  }
-
-  /**
-   * Creates a EdmEntityContainer instance from an ContainerInfo instance.
-   * @param {Edm} edm The edm itself
-   * @param {CsdlProvider} provider Provider for the Csdl artifacts
-   * @param {CsdlEntityContainerInfo} entityContainerInfo Entity container info
-   * @param {Object} configuration a configuration object
-   * @returns {EdmEntityContainer} the entity container
-   * @package
-   */
-  static createWithContainerInfo (edm, provider, entityContainerInfo, configuration) {
-    return new EdmEntityContainer(edm, provider, entityContainerInfo, null, null, configuration)
-  }
-
-  /**
-   * Creates a EdmEntityContainer instance from full qualified name and the CsdlEntityContainer.
-   * @param {Edm} edm The edm itself
-   * @param {CsdlProvider} provider Provider for the Csdl artifacts
-   * @param {FullQualifiedName} fqn Full qualified name of container
-   * @param {CsdlEntityContainer} entityContainer Entity container
-   * @param {Object} configuration a configuration object
-   * @returns {EdmEntityContainer} the entity container
-   * @package
-   */
-  static createWithFQN (edm, provider, fqn, entityContainer, configuration) {
-    return new EdmEntityContainer(edm, provider, null, fqn, entityContainer, configuration)
-  }
-
-  /**
-   * @param {string} namespace the namespace
-   * @param {string} name the name
-   * @returns {?Object} configuration the configuration
-   * @private
-   */
-  _getArtifactConfiguration (namespace, name) {
-    const nsConfig = this._configuration[namespace]
-    return nsConfig ? nsConfig[name] : undefined
-  }
-}
-
-module.exports = EdmEntityContainer

package/libx/_runtime/cds-services/adapter/odata-v4/okra/odata-commons/edm/EdmEntitySet.js

@@ -1,43 +0,0 @@
-'use strict'
-
-const AbstractEdmBindingTarget = require('./AbstractEdmBindingTarget')
-
-/**
- * <a href="./../ODataSpecification/odata-v4.0-errata03-os/complete/part3-csdl/odata-v4.0-errata03-os-part3-csdl-complete.html#_Toc453752600">
- *     OData CSDL # 13.2 Element edm:EntitySet
- * </a>
- *
- * @extends AbstractEdmBindingTarget
- * @hideconstructor
- */
-class EdmEntitySet extends AbstractEdmBindingTarget {
-  /**
-   * @param {Edm} edm The Edm itself
-   * @param {EdmEntityContainer} container Entity container
-   * @param {CsdlEntitySet} entitySet Csdl entity set
-   * @param {Object} configuration Configuration object with additional configuration properties
-   */
-  constructor (edm, container, entitySet, configuration) {
-    super(edm, container, entitySet, configuration)
-    this._entitySet = entitySet
-  }
-
-  /**
-   * Returns true if the entityset is included in the service document, otherwise false
-   * @returns {boolean} whether the entity set should appear in the service document
-   */
-  isIncludeInServiceDocument () {
-    return this._entitySet.includeInServiceDocument
-  }
-
-  /**
-   * Returns the maxPageSize for server driven paging if configured via edm configuration or null if not configured.
-   * @returns {?number} the configured maxPageSize or null if not configured
-   */
-  getMaxPageSize () {
-    const maxPageSize = this._configuration.maxPageSize
-    return Number.isInteger(maxPageSize) ? maxPageSize : null
-  }
-}
-
-module.exports = EdmEntitySet

package/libx/_runtime/cds-services/adapter/odata-v4/okra/odata-commons/edm/EdmEntityType.js

@@ -1,119 +0,0 @@
-'use strict'
-
-const AbstractEdmStructuredType = require('./AbstractEdmStructuredType')
-const EdmTypeKind = require('./EdmType').TypeKind
-const EdmKeyPropertyRef = require('./EdmKeyPropertyRef')
-const FeatureSupport = require('../FeatureSupport')
-
-/**
- * <a href="./../ODataSpecification/odata-v4.0-errata03-os/complete/part3-csdl/odata-v4.0-errata03-os-part3-csdl-complete.html#_Toc453752548">
- *     OData CSDL # 8. Element edm:EntityType
- * </a>
- *
- * @extends AbstractEdmStructuredType
- * @hideconstructor
- */
-class EdmEntityType extends AbstractEdmStructuredType {
-  /**
-   * Creates an instance of EdmEntityType.
-   * @param {Edm} edm The edm itself
-   * @param {FullQualifiedName} fqn The full qualified name of this entity type
-   * @param {CsdlEntityType} csdlEntityType The csdl entity type structure
-   * @param {Object} configuration Configuration object with additional configuration properties
-   * @param {string[]} configuration.customAggregates the custom aggregates defined for this type
-   */
-  constructor (edm, fqn, csdlEntityType, configuration) {
-    super(edm, fqn, EdmTypeKind.ENTITY, csdlEntityType, configuration)
-
-    if (csdlEntityType.hasStream) {
-      FeatureSupport.failUnsupported(FeatureSupport.features.AttributeHasStream)
-    }
-
-    /**
-     * @type {EdmEntityType}
-     * @private
-     */
-    this._edmBaseType = null
-
-    /**
-     * @type {Map.<string, EdmKeyPropertyRef>}
-     * @private
-     */
-    this._ownKeyPropertyRefs = null
-  }
-
-  /**
-   * Returns the base type. Null if no base type exists.
-   * @returns {?EdmEntityType} the base type
-   * @override
-   */
-  getBaseType () {
-    if (this._edmBaseType) return this._edmBaseType
-
-    if (!this.csdlStructuredType.baseType) return null
-
-    this._edmBaseType = this._edm.getEntityType(this.csdlStructuredType.baseType)
-
-    return this._edmBaseType
-  }
-
-  /**
-   * Returns a Map of key-property references.
-   * These properties define the key in this EDM type excluding those from the base type.
-   * @returns {Map.<string, EdmKeyPropertyRef>} the Map of key-property references
-   */
-  getOwnKeyPropertyRefs () {
-    if (this._ownKeyPropertyRefs) return this._ownKeyPropertyRefs
-
-    this._ownKeyPropertyRefs = new Map()
-    for (const property of this.csdlStructuredType.key) {
-      // property --> CsdlPropertyRef
-      const name = property.alias || property.name
-      const edmProp = new EdmKeyPropertyRef(this, property)
-      this._ownKeyPropertyRefs.set(name, edmProp)
-    }
-
-    return this._ownKeyPropertyRefs
-  }
-
-  /**
-   * Returns a Map of key-property references.
-   * An entity is uniquely identified within an entity set by its key.
-   * The key definition consists of its key-property reference objects.
-   *
-   * @returns {Map.<string, EdmKeyPropertyRef>} the Map of key-property references
-   */
-  getKeyPropertyRefs () {
-    if (this.getOwnKeyPropertyRefs().size > 0) {
-      return this.getOwnKeyPropertyRefs()
-    }
-    return this.getBaseType() ? this.getBaseType().getKeyPropertyRefs() : new Map()
-  }
-
-  /**
-   * Returns the key-property reference found by its name.
-   * @param {string} name Name of the requested key property
-   * @returns {EdmKeyPropertyRef} the key-property reference
-   */
-  getKeyPropertyRef (name) {
-    return this.getKeyPropertyRefs().get(name)
-  }
-
-  /**
-   * Returns true if this entity type has a stream. A value of true specifies that the entity
-   * type is a media entity. Media entities are entities that represent a media stream,
-   * such as a photo.
-   *
-   * @returns {boolean} whether this entity type is a media entity type
-   */
-  hasStream () {
-    if (this.csdlStructuredType.hasStream) return true
-    if (this.getBaseType() && this.getBaseType().hasStream()) return true
-    const streamProp = this.csdlStructuredType &&
-      this.csdlStructuredType.properties &&
-      this.csdlStructuredType.properties.find(prop => prop.type && prop.type.namespace + '.' + prop.type.name === 'Edm.Stream')
-    return !!streamProp
-  }
-}
-
-module.exports = EdmEntityType

package/libx/_runtime/cds-services/adapter/odata-v4/okra/odata-commons/edm/EdmEnumMember.js

@@ -1,69 +0,0 @@
-'use strict'
-
-const EdmAnnotation = require('./EdmAnnotation')
-const validateThat = require('../validator/ParameterValidator').validateThat
-
-/**
- * * * <a href="./../ODataSpecification/odata-v4.0-errata03-os/complete/part3-csdl/odata-v4.0-errata03-os-part3-csdl-complete.html#_Toc453752570">
- *     OData CSDL # 10.2 Element edm:Member
- * </a>
- * @hideconstructor
- */
-class EdmEnumMember {
-  /**
-   * Constructor
-   * @param {Edm} edm The edm itself
-   * @param {CsdlEnumMember} enumMember the CSDL enum member
-   */
-  constructor (edm, enumMember) {
-    validateThat('edm', edm).truthy()
-    validateThat('enumMember', enumMember).truthy()
-
-    /**
-     * @type {Edm}
-     * @private
-     */
-    this._edm = edm
-
-    /**
-     * @type {CsdlEnumMember}
-     * @private
-     */
-    this._enumMember = enumMember
-
-    /**
-     * @type {EdmAnnotation[]}
-     * @private
-     */
-    this._annotations = null
-  }
-
-  /**
-   * Returns the name.
-   * @returns {string} the name
-   */
-  getName () {
-    return this._enumMember.name
-  }
-
-  /**
-   * Returns the value.
-   * @returns {number} the value
-   */
-  getValue () {
-    return this._enumMember.value
-  }
-
-  /**
-   * Returns the annotations for this member.
-   * @returns {EdmAnnotation[]} the annotations
-   */
-  getAnnotations () {
-    if (!this._annotations) {
-      this._annotations = this._enumMember.annotations.map(item => new EdmAnnotation(this._edm, item))
-    }
-    return this._annotations
-  }
-}
-
-module.exports = EdmEnumMember