@sap/cds-dk 9.9.2 → 10.0.3

package/node_modules/@sap/cds/lib/env/cds-requires.js

@@ -0,0 +1,315 @@
+const _runtime = '@sap/cds/libx/_runtime'
+
+exports = module.exports = {
+
+  middlewares: true, // REVISIT: odata-v2-adapter uses this
+  db: undefined,            "[schevo]": { db: { schema_evolution: 'auto' }, },
+  messaging: undefined,
+  multitenancy: undefined,
+  extensibility: undefined,
+  toggles: undefined,
+  queue: true,
+  scheduling: true,
+
+  auth: {
+    '[development]': { kind: 'mocked-auth' },
+    '[production]': { kind: 'jwt-auth' }
+  },
+
+  /**
+   * This is the implementation for `cds.requires` which is `cds.env.requires`
+   * plus additional entries for all cds.required.<name>.service
+   * @returns {import('./cds-requires')}
+   */
+  _resolved() {
+    const requires = { __proto__: this }
+    for (let [name,e] of Object.entries(this)) if (e.service) {
+      if (!(e.service in requires) || e.override || e.service !== name) requires[e.service] = { ...e, name }
+      else throw new Error (`Config 'cds.requires.${name}.service = ${e.service}' conflicts with 'cds.requires.${e.service}'`)
+    }
+    return requires
+  }
+}
+
+
+const admin = [ 'admin' ]
+const builder = [ 'cds.ExtensionDeveloper' ]
+const _authentication_strategies = {
+
+  "basic-auth": {
+    kind: 'basic',
+    users: {},
+    tenants: {}
+  },
+  "mocked-auth": {
+    restrict_all_services: false,
+    kind: 'mocked',
+    users: {
+      alice: { tenant: 't1', roles: [ ...admin ] },
+      bob:   { tenant: 't1', roles: [ ...builder ] },
+      carol: { tenant: 't1', roles: [ ...admin, ...builder ] },
+      dave:  { tenant: 't1', roles: [ ...admin ], features: [] },
+      erin:  { tenant: 't2', roles: [ ...admin, ...builder ] },
+      fred:  { tenant: 't2', features: ['isbn'] },
+      me:    { tenant: 't1', features: ['*'] },
+      yves:  { roles: ['internal-user'] },
+      '*': true
+    },
+    tenants: {
+      t1: { features: [ 'isbn' ], }, // tenant-specific features
+      t2: { features: '*', },
+    }
+  },
+  "jwt-auth": {
+    kind: 'jwt',
+    vcap: { label: 'xsuaa' }
+  },
+  "ias-auth": {
+    kind: 'ias',
+    vcap: { label: 'identity' }
+  },
+  "xsuaa-auth": {
+    kind: 'xsuaa',
+    vcap: { label: 'xsuaa' }
+  },
+  "dummy-auth": {
+    kind: 'dummy',
+  },
+
+}
+
+for (let each of Object.values(_authentication_strategies)) {
+  Object.defineProperty (each, 'strategy', {get() {
+    return { jwt: 'JWT', mocked: 'mock' }[this.kind] || this.kind
+  }})
+}
+
+// enable credentials lookup for xsuaa fallback
+_authentication_strategies.xsuaa = { vcap: { label: 'xsuaa' } }
+
+const _services = {
+
+  "app-service": {
+    // this is the default implementation used for provided services
+    impl: `@sap/cds/srv/app-service.js`,
+  },
+  "rest": {
+    impl: `@sap/cds/srv/remote-service.js`,
+    external: true
+  },
+  "hcql": {
+    impl: `@sap/cds/srv/remote-service.js`,
+    external: true
+  },
+  "odata": {
+    impl: `@sap/cds/srv/remote-service.js`,
+    external: true
+  },
+  "odata-v2": { // REVISIT: we should introduce .version
+    impl: `@sap/cds/srv/remote-service.js`,
+    external: true
+  },
+  "odata-v4": { // REVISIT: we should introduce .version
+    impl: `@sap/cds/srv/remote-service.js`,
+    external: true
+  },
+  "graphql": { // REVISIT: we should introduce .version
+    impl: `@sap/cds/srv/remote-service.js`,
+    external: true
+  },
+
+}
+
+const _db_data = {
+  '[development]': { data: [ 'db/data', 'db/csv', 'test/data' ] },
+  '[production]': { data: [ 'db/data', 'db/csv' ] },
+}
+
+const _databases = {
+
+  "db-defaults": { kind: 'sql', ..._db_data }, //> applied only for cds.requires.db: true 
+  
+  "sql": {
+    '[development]': { kind: 'sqlite', credentials: { url: ':memory:' } },
+    '[production]': { kind: 'hana' },
+  },
+
+  "sqlite": {
+    impl: '@cap-js/sqlite', credentials: { url: 'db.sqlite' },
+    ..._db_data,
+  },
+  "hana": {
+    impl: '@cap-js/hana',
+    ..._db_data,
+  },
+  "hana-cloud": {
+    kind: 'hana', "deploy-format": "hdbtable",
+  },
+  "sql-mt": { // For compatibility only
+    '[development]': { kind: 'sqlite' },
+    '[production]': { kind: 'hana-mt' },
+  },
+  "hana-mt": { // For compatibility only
+    kind: 'hana', "deploy-format": "hdbtable",
+    "vcap": {
+      "label": "service-manager"
+    }
+  },
+}
+
+
+const _queue = {
+  queue: "persistent-queue",
+  "in-memory-queue": {},
+  "persistent-queue": {
+    model: "@sap/cds/srv/outbox",
+    maxAttempts: 10,
+    timeout: '1h',
+    // deprecated!
+    legacyLocking: false,
+    // internal!
+    chunkSize: 10,
+    parallel: true,
+    // REVISIT: streamline context to serialize with Java and remove this
+    _ignoredContext: ['user', 'http', 'model', 'timestamp', '_locale', '_features']
+  },
+  // legacy
+  "in-memory-outbox": "in-memory-queue",
+  "persistent-outbox": "persistent-queue",
+}
+
+
+const _scheduling = {
+  "scheduling": {
+    impl: '@sap/cds/libx/queue/SchedulingService.js',
+    queued: true,
+    // internal!
+    silent: true,
+    markerInterval: '1h',
+    flushInterval: '1h',
+    _optimisticMarkers: true,
+  },
+}
+
+
+const _messaging = {
+
+  "messaging-defaults": {
+    "[development]": { kind: "file-based-messaging" },
+    "[production]": { kind: "enterprise-messaging" },
+    "[hybrid]": { kind: "enterprise-messaging-amqp" },
+  },
+
+  "default-messaging": {
+    "[development]": { kind: "local-messaging" },
+    "[hybrid]": { kind: "enterprise-messaging-amqp" },
+    "[production]": {
+      kind: "enterprise-messaging-amqp",
+      "[multitenant]": { kind: "enterprise-messaging-http" }
+    }
+  },
+
+  "local-messaging": {
+    impl: `${_runtime}/messaging/service.js`,
+    local: true
+  },
+  "file-based-messaging": {
+    impl: `${_runtime}/messaging/file-based.js`,
+    file:'~/.cds-msg-box',
+    outboxed: true
+  },
+
+  "event-mesh": {
+    kind: "enterprise-messaging-http",
+    vcap: { label: "event-mesh-message-client" },
+    managementBasePath: "/sap-event-mesh/rest/api/v1",
+  },
+  "event-mesh-shared": {
+    kind: "enterprise-messaging-amqp",
+    vcap: { label: "event-mesh-message-client" },
+    managementBasePath: "/sap-event-mesh/rest/api/v1",
+  },
+  "enterprise-messaging": {
+    kind: "enterprise-messaging-http",
+  },
+  "enterprise-messaging-shared": {
+    kind: "enterprise-messaging-amqp",
+  },
+  "enterprise-messaging-http": {
+    deployForProvider: true,
+    impl: `${_runtime}/messaging/enterprise-messaging.js`,
+    vcap: { label: "enterprise-messaging" },
+    outboxed: true
+  },
+  "enterprise-messaging-amqp": {
+    impl: `${_runtime}/messaging/enterprise-messaging-shared.js`,
+    vcap: { label: "enterprise-messaging" },
+    outboxed: true
+  },
+  'message-queuing': {
+    impl: `${_runtime}/messaging/message-queuing.js`,
+    outboxed: true
+  },
+  'kafka': {
+    impl: `${_runtime}/messaging/kafka.js`,
+    topic: 'cds.default',
+    outboxed: true,
+    local: false
+  },
+  "composite-messaging": {
+    impl: `${_runtime}/messaging/composite.js`
+  },
+  "mtx-messaging": {
+    kind: "local-messaging",
+    "[production]": {
+      kind: "redis-messaging"
+    }
+  },
+  "redis-messaging": {
+    impl: `${_runtime}/messaging/redis-messaging.js`,
+    vcap: { label: "redis-cache" },
+    outboxed: true
+  }
+
+}
+
+
+const _platform_services = {
+
+  ucl: {
+    model: '@sap/cds/srv/ucl-service.cds',
+    // REVISIT: how to configure such that a cds.connect.to('ucl') returns the already initialized UCLService?
+    // service: 'UCLService',
+    // impl: `${_runtime}/ucl/Service.js`,
+    // REVISIT: remove default as only needed for push mode
+    vcap: { label: 'xsuaa' }
+  },
+
+  destinations: {
+    vcap: {
+      label: 'destination'
+    }
+  },
+  connectivity: {
+    vcap: {
+      label: 'connectivity'
+    }
+  },
+
+  approuter: undefined,
+
+}
+
+
+exports.kinds = {
+  ..._authentication_strategies,
+  ..._databases,
+  ..._services,
+  ..._queue,
+  ..._scheduling,
+  ..._messaging,
+  ..._platform_services,
+}
+
+// This is to hide that method in the output of cds env
+Object.defineProperty(exports,'_resolved',{value:exports._resolved,enumerable:false}) // hide it in outputs

package/node_modules/@sap/cds/lib/env/compat.js

@@ -0,0 +1,95 @@
+module.exports = function (conf) {
+
+  const _ = Object.defineProperties (conf, {
+
+    'log-level': {
+      get() { return _.log.levels.cli },
+      set(x) { _.log.levels.cli = x },
+    },
+
+    data: {value:{
+      get model(){
+        const db = _.requires.db;  if (!db)  return undefined
+        return db.model
+      },
+      set model(v){
+        const db = _.requires.db || (_.requires.db={})
+        db.model = v
+        _.folders.db = v
+      },
+      get driver(){
+        const db = _.requires.db;  if (!db)  return undefined
+        return db.kind
+      },
+      set driver(v){
+        const db = _.requires.db || (_.requires.db={})
+        db.kind = v
+      },
+      get url(){
+        const db = _.requires.db;  if (!db)  return undefined
+        const cred = db.credentials; if (!cred)  return undefined
+        return cred.url || cred.database
+      },
+      set url(v) {
+        const isUrl = /.+:\/\/.+/.test(v) // e.g. 'foo://bar'
+        const db = _.requires.db || (_.requires.db={})
+        const cred = db.credentials || (db.credentials={})
+        if (isUrl) {
+          cred.url = v // HANA
+        } else {
+          cred.database = v // sqlite
+        }
+      },
+      get database(){
+        const db = _.requires.db;  if (!db)  return undefined
+        const cred = db.credentials; if (!cred)  return undefined
+        return cred.database
+      },
+      set database(v){
+        const db = _.requires.db || (_.requires.db={})
+        const cred = db.credentials || (db.credentials={})
+        cred.database = v
+      },
+      get sql_mapping(){ return _.sql.names },
+      set sql_mapping(v){ _.sql.names = v },
+    }},
+    service: {value:{
+      get model() { return _.folders.srv },
+      set model(v){ _.folders.srv = v },
+      get odata(){ return _.odata },
+      set odata(v){ _.odata = v },
+    }},
+    sql_mapping: {
+      get() { return _.sql.names },
+      set(v) { _.sql.names = v },
+    },
+    deploy: {value:{
+      _compat: true,
+      get models() { return Object.values (_.folders) .concat ([ 'schema', 'services' ]) }
+    }}
+  })
+
+  const _hana = Object.defineProperties(conf.hana, {
+    syntax: {
+      get() {
+        const format = _hana['deploy-format']
+        return format === 'hdbtable' ? 'hdi' : format
+      },
+      set(v) {
+        _hana['deploy-format'] = (v === 'hdi' ? 'hdbtable' : v)
+      }
+    }
+  })
+
+  Object.defineProperties (conf.features, {
+    fiori_preview: {
+      get: ()=> _.fiori.preview,
+      set: (v) => { _.fiori.preview = v },
+    },
+    fiori_routes: {
+      get: ()=> _.fiori.routes,
+      set: (v) => { _.fiori.routes = v },
+    },
+  })
+
+}

package/node_modules/@sap/cds/lib/env/defaults.js

@@ -0,0 +1,227 @@
+const production = process.env.NODE_ENV === 'production'
+
+module.exports = exports = {
+
+  production,
+
+  requires: require('./cds-requires'),
+
+  runtime: {
+    patch_as_upsert: false,
+    put_as_upsert: true,
+    put_as_replace: false,
+  },
+
+  server: {
+    shutdown_on_uncaught_errors: true,
+    exit_on_multi_install: true,
+    force_exit_timeout: 1111,
+    body_parser: undefined, // Allows to configure all body parser options, e.g. limit
+    cors:  !production, // CORS middleware is off in production
+    index: !production, // index page is off in production
+    port: 4004,
+  },
+
+  protocols: {
+    'odata-v4' : { path: '/odata/v4' },
+    'odata-v2' : { path: '/odata/v2' },
+    'rest' : { path: '/rest' },
+    'hcql' : { path: '/hcql' },
+    'data.product' : null, // data products are not http-served protocols
+  },
+
+  features: {
+    folders: 'fts/*', // where to find feature toggles -> switch on by default when released
+    sql_simple_queries: 0,
+    pre_compile_edmxs: false,
+    live_reload: !production,
+    in_memory_db: !production,
+    test_data: !production,
+    test_mocks: !production,
+    with_mocks: !production,
+    mocked_bindings: !production,
+    // skip_unused: 'all',
+    skip_unused: true,
+    deploy_data_onconflict: 'insert',
+    deploy_via_upserts: undefined,
+    assert_integrity: false,
+    precise_timestamps: false,
+    ieee754compatible: true,
+    compat_clone_appends: false, //> remove with cds^11
+    count_as_string: undefined,
+    compat_srv_getters: false, //> remove with cds^11
+    compat_texts_entities: false, //> remove with cds^11
+    legacy_srv_results: false, //> remove with cds^11
+    legacy_db_results: true, //> switch default with cds^11?
+    bulk_inserts_via_rest: true, //> remove with cds^11
+    annotate_for_flows: true,
+    history_for_flows: true,
+    compile_for_assert: undefined,
+  },
+
+  fiori: {
+    preview: !production,
+    routes: !production,
+    lean_draft: true,
+    wrap_multiple_errors: true,
+    draft_lock_timeout: true,
+    draft_deletion_timeout: true,
+    draft_messages: true,
+    draft_new_action: false,
+    bypass_draft: true,
+  },
+
+  ql: {
+  },
+
+  log: {
+    Logger: undefined, //> use default
+    '[development]': { format: 'plain' },
+    '[production]': { format: 'json' },
+    levels: {
+      compile: 'warn',
+      cli:    'warn'
+    },
+    service: false,
+    // the rest is only applicable for the json formatter
+    user: false,
+    mask_headers: ['/authorization/i', '/cookie/i', '/cert/i', '/ssl/i', '/api-key/i'],
+    aspects: ['./aspects/cf', './aspects/als', './aspects/cls'], //> EXPERIMENTAL!!!
+    // adds custom fields in kibana's error rendering (unknown fields are ignored); key: index
+    // note: custom fields are a feature of Application Logging Service (ALS) and not Kibana per se
+    als_custom_fields: {
+      // sql
+      query: 0,
+      // generic validations
+      target: 1, details: 2,
+      // errors
+      reason: 3
+    },
+    cls_custom_fields: [
+      // sql
+      'query',
+      // generic validations
+      'target', 'details',
+      // errors
+      'reason'
+    ]
+  },
+
+  folders: { // IMPORTANT: order is significant for cds.load('*')
+    db: 'db/',
+    srv: 'srv/',
+    app: 'app/',
+    apps: 'app/*',
+  },
+
+  i18n: {
+    file: 'i18n', // file basename w/o extension
+    folders: [ '_i18n', 'i18n' ],
+    languages: 'all', // or ['en','de',...]
+    default_language: 'en',
+    preserved_locales: [
+      // IMPORTANT: Never, never modify this list, as that would break existing projects !!!!
+      // Projects can and have to override if they want something different.
+      'en_GB',
+      'es_CO',
+      'es_MX',
+      'fr_CA',
+      'pt_PT',
+      'zh_CN',
+      'zh_HK',
+      'zh_TW'
+    ],
+    /** @deprecated */ fallback_bundle: '',
+    /** @deprecated */ fatjson: false, // REVISIT: remove in cds^11
+  },
+
+  odata: {
+    flavors: {
+      v2: {
+        version: 'v2',
+        // containment:false,
+        // structs:false,
+        // refs:false, //> proxies:false,
+      },
+      v4: {
+        version: 'v4',
+        // containment:false,
+        // structs:false,
+        // refs:false, //> proxies:false,
+      },
+      w4: { // for ODM with Fiori clients
+        version: 'v4',
+        containment:true,
+        structs:true,
+        refs:false, //> proxies:false,
+        xrefs:false,
+      },
+      x4: { // for A2X APIs
+        version: 'v4',
+        containment:true,
+        structs:true,
+        refs:true, //> proxies:true,
+        xrefs:true,
+      },
+    },
+    version: 'v4', // following is to support code completion only...
+    structs: undefined,
+    refs: undefined,
+    proxies: undefined,
+    containment: undefined,
+    context_with_columns: false,
+    max_batch_header_size: '64KiB', // instead of node's 16KiB
+    max_batch_parallelization: 1,
+  },
+
+  sql: {
+    native_hana_associations: undefined,
+    names: 'plain', // or 'quoted', or 'hdbcds'
+    dialect: 'sqlite' // or 'plain' or 'hana'
+    // dialect: undefined, // or 'sqlite', 'hana', 'postgres', 'h2', ...
+  },
+
+  hana: {
+    'deploy-format': 'hdbtable',
+    journal:  {
+      'change-mode': 'alter'
+    },
+    table_data: {
+      column_mapping: {
+        LargeBinary: 'decodeBase64'
+      }
+    }
+  },
+
+  build: {
+    target: 'gen',
+    '[java]': {
+      target: '.'
+    }
+  },
+
+  cdsc: {
+    moduleLookupDirectories: ['node_modules/'],
+    '[java]': {
+      betterSqliteSessionVariables: true,
+      moduleLookupDirectories: ['node_modules/', 'target/cds/'],
+    }
+    // cv2: {
+    //   _localized_entries: true,
+    //   _texts_entries: true,
+    // }
+    // toSql: { associations: 'joins' },
+    // newCsn: true,
+  },
+
+  query: {
+    limit: {
+      max: 1000
+    }
+  },
+
+  remote: {
+    native_fetch: undefined,
+  },
+
+}

package/node_modules/@sap/cds/lib/env/schemas/cds-package.js

@@ -0,0 +1,27 @@
+const cds = require('../../index')
+
+module.exports = {
+  _version: cds.version,
+
+  // base schema file for package.json
+  // includes cdsRoot schema from cds-rc.js to enforce cds configuration only in cds section
+  // and not in the root of the package.json
+
+  title: 'JSON schema for CDS configuration in package.json',
+  $schema: 'https://json-schema.org/draft-07/schema',
+  description: 'This is a JSON schema representation of the CDS project configuration inside a project root level package.json',
+  type: 'object',
+  properties: {
+    extends: {
+      description: 'Name of the application that shall be extended',
+      type: 'string'
+    },
+    cds: {
+      type: 'object',
+      additionalProperties: true,
+      $ref: 'cdsjsonschema://schemas/cds-rc.json#/$defs/cdsRoot',
+      description: 'CDS configuration root',
+      default: {}
+    }
+  }
+}