.

Bumps [axios](https://github.com/axios/axios) from 1.3.1 to 1.3.2.
- [Release notes](https://github.com/axios/axios/releases)
- [Changelog](https://github.com/axios/axios/blob/v1.x/CHANGELOG.md)
- [Commits](https://github.com/axios/axios/compare/v1.3.1...v1.3.2)

---
updated-dependencies:
- dependency-name: axios
  dependency-type: direct:development
  update-type: version-update:semver-patch
...

Signed-off-by: dependabot[bot] <support@github.com>

.eslint/index.js

@@ -0,0 +1,15 @@
+const cds = require("@sap/eslint-plugin-cds");
+
+module.exports = {
+  configs: {
+    recommended: {
+      plugins: ["cloud-cap-samples"],
+      rules: {
+        "cloud-cap-samples/no-open-services": ["error", "show"]
+      }
+    }
+  },
+  rules: {
+    "no-open-services": cds.createRule(require("./rules/no-open-services")),
+  }
+};

.eslint/package.json

@@ -0,0 +1,5 @@
+{
+    "name": "eslint-plugin-cloud-cap-samples",
+    "description": "Contains shareable custom lint rules for this repository",
+    "version": "1.0.0"
+}

.eslint/rules/no-open-services.js

@@ -0,0 +1,29 @@
+module.exports = {
+    meta: {
+      docs: {
+        description: "Service without `@requires/restrict` should not expose fields with personal data.",
+        version: "1.0.0"
+      },
+      fixable: "code",
+      model: "inferred"
+    },
+    create: function (context) {
+      const services = context.getModel() ? context.getModel().services : [];
+      const unprotectedServices = services.filter(s => !s["@requires"] && !s["@restrict"]).map(s => s.name)
+      return { entity: checkForExposedFields };
+
+      function checkForExposedFields(entity) {
+        const entityInUnprotectedService = unprotectedServices.some(service => entity.name.includes(service))
+        if (entityInUnprotectedService) {
+          const elements = Object.keys(entity.elements).filter((name) => ["createdBy", "modifiedBy"].includes(name))
+          for (let element of elements) {
+            context.report({
+              message: `Field '${element}' in '${entity.name}' exposes personal data. Remove field or add \`@restrict/requires\`.`,
+              node: context.getNode(entity),
+              file: entity.$location.file
+            })
+          }
+        }
+      }
+    }
+  }

.eslintrc

@@ -1,16 +1,23 @@
 {
-    "extends": "eslint:recommended",
+    "extends": [
+        "eslint:recommended",
+        "plugin:@sap/cds/recommended",
+        "plugin:cloud-cap-samples/recommended"
+    ],
+    "plugins": [
+        "cloud-cap-samples"
+    ],
     "env": {
+        "browser": true,
+        "es2022": true,
         "node": true,
-        "es6": true,
+        "jest": true,
-        "jest": true
+        "mocha": true
-    },
-    "parserOptions": {
-        "ecmaVersion": 2018
     },
     "globals": {
         "SELECT": true,
         "INSERT": true,
+        "UPSERT": true,
         "UPDATE": true,
         "DELETE": true,
         "CREATE": true,
@@ -19,6 +26,8 @@
     },
     "rules": {
         "no-console": "off",
-        "require-atomic-updates": "off"
+        "require-atomic-updates": "off",
+        "require-await": "warn",
+        "no-unused-vars": ["warn", { "argsIgnorePattern": "_" }]
     }
-}
+}

.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,5 @@
+blank_issues_enabled: false
+contact_links:
+  - name: This channel is CLOSED. 
+    about: Use SAP community instead
+    url: https://answers.sap.com/tags/9f13aee1-834c-4105-8e43-ee442775e5ce

.github/dependabot.yml

@@ -0,0 +1,8 @@
+version: 2
+
+updates:
+- package-ecosystem: npm
+  directory: /
+  versioning-strategy: increase-if-necessary
+  schedule:
+    interval: daily

.github/workflows/node.js.yml

@@ -0,0 +1,29 @@
+# This workflow will do a clean install of node dependencies, build the source code and run tests across different versions of node
+# For more information see: https://help.github.com/actions/language-and-framework-guides/using-nodejs-with-github-actions
+
+name: CI
+
+on:
+  push:
+    branches: [ main ]
+  pull_request:
+    branches: [ main ]
+
+jobs:
+  build:
+
+    runs-on: ubuntu-latest
+
+    strategy:
+      matrix:
+        node-version: [16.x, 14.x]
+
+    steps:
+    - uses: actions/checkout@v2
+    - name: Use Node.js ${{ matrix.node-version }}
+      uses: actions/setup-node@v1
+      with:
+        node-version: ${{ matrix.node-version }}
+    - run: npm i -g npm@8
+    - run: npm ci
+    - run: npm test

.gitignore

@@ -12,4 +12,11 @@ target/
 *.mtar
 connection.properties
 default-env.json
+.cdsrc-private.json
 packages/messageBox
+reviews/msg-box
+reviews/db/test.db
+
+*.openapi3.json
+*.sqlite
+*.db

.npmrc

@@ -0,0 +1,3 @@
+# Ensure we always use public packages, i.e. avoid using local registries from ~/.npmrc
+@sap:registry=https://registry.npmjs.org/
+registry=https://registry.npmjs.org/

.reuse/dep5

@@ -0,0 +1,29 @@
+Format: https://www.debian.org/doc/packaging-manuals/copyright-format/1.0/
+Upstream-Name: cloud-cap-samples
+Upstream-Contact: <Christian Georgi (christian.georgi@sap.com)>
+Source: https://github.com/SAP-samples/cloud-cap-samples
+Disclaimer: The code in this project may include calls to APIs (“API Calls”) of
+ SAP or third-party products or services developed outside of this project
+ (“External Products”).
+ “APIs” means application programming interfaces, as well as their respective
+ specifications and implementing code that allows software to communicate with
+ other software.
+ API Calls to External Products are not licensed under the open source license
+ that governs this project. The use of such API Calls and related External
+ Products are subject to applicable additional agreements with the relevant
+ provider of the External Products. In no event shall the open source license
+ that governs this project grant any rights in or to any External Products,or
+ alter, expand or supersede any terms of the applicable additional agreements.
+ If you have a valid license agreement with SAP for the use of a particular SAP
+ External Product, then you may make use of any API Calls included in this
+ project’s code for that SAP External Product, subject to the terms of such
+ license agreement. If you do not have a valid license agreement for the use of
+ a particular SAP External Product, then you may only make use of any API Calls
+ in this project for that SAP External Product for your internal, non-productive
+ and non-commercial test and evaluation of such API Calls. Nothing herein grants
+ you any rights to use or access any SAP External Product, or provide any third
+ parties the right to use of access any SAP External Product, through API Calls.
+
+Files: *
+Copyright: 2019-2020 SAP SE or an SAP affiliate company and cap-cloud-samples
+License: Apache-2.0

.tours/db-native.tour

@@ -0,0 +1,117 @@
+{
+  "$schema": "https://aka.ms/codetour-schema",
+  "title": "Database Functions",
+  "steps": [
+    {
+      "title": "Introduction",
+      "description": "### Database Functions in CDS Models\n\nIn this tour, you'll learn how to add database-specific functions to CDS models in your application."
+    },
+    {
+      "file": "bookshop/db/schema.cds",
+      "description": "#### Basic Schema\n\nWe want to add two fields to the `Authors` entity, one for the author's age and one for the span of years that she or he lived.\n\nThese two fields can be computed out of the existing `dateOfBirth` and `dateOfDeath` fields.",
+      "selection": {
+        "start": {
+          "line": 19,
+          "character": 1
+        },
+        "end": {
+          "line": 21,
+          "character": 1
+        }
+      },
+      "title": "Base fields in Author"
+    },
+    {
+      "file": "bookshop/srv/admin-service.cds",
+      "description": "This is how the `Authors` entity gets exposed in an OData or REST service.\n\nIn the next step, you'll see how we extend this projection.",
+      "selection": {
+        "start": {
+          "line": 4,
+          "character": 1
+        },
+        "end": {
+          "line": 5,
+          "character": 1
+        }
+      },
+      "title": "Authors service"
+    },
+    {
+      "file": "fiori/db/sqlite/index.cds",
+      "description": "#### SQLite Implementation\n\nHere's the first implementation for SQLite.  It computes the two fields `age` and `lifetime` through SQLite's [strftime](https://sqlite.org/lang_datefunc.html) function.\n\nThrough the [`extend projection`](https://cap.cloud.sap/docs/cds/cdl#extend-view) clause you can add additional fields to projection entities.  These are deployed as database views, which is why we can integrate the database functions in the first place.\n",
+      "selection": {
+        "start": {
+          "line": 7,
+          "character": 1
+        },
+        "end": {
+          "line": 11,
+          "character": 1
+        }
+      },
+      "title": "SQLite implementation"
+    },
+    {
+      "file": "fiori/db/hana/index.cds",
+      "description": "#### SAP HANA Implementation\n\nThis is the second implementation for SAP HANA.  It computes the same two fields `age` and `lifetime` through the [YEARS_BETWEEN](https://help.sap.com/viewer/7c78579ce9b14a669c1f3295b0d8ca16/Cloud/en-US/7c0d2c161ea34def86de3f5eadd6a0af.html) and [YEAR](https://help.sap.com/viewer/7c78579ce9b14a669c1f3295b0d8ca16/Cloud/en-US/20f5fac6751910148dabd3c6821f907d.html) functions of SAP HANA.\n\n#### File Layout and Code Structure\n\nNote the path of the `.cds` file we are in: it's in a subfolder of `db`, so that it's _not_ automatically picked up when we start the application.  The same is true for the SQLite implementation: it's in a separate `db/sqlite/` folder as well.  In the next step, you'll see how these files are loaded.\n\nAlso, we choose to implement all of that as an extension of the original bookshop here in the _fiori_ package.  See the first [CAP Samples] code tour for more details on the different packages of this repository.",
+      "selection": {
+        "start": {
+          "line": 7,
+          "character": 1
+        },
+        "end": {
+          "line": 11,
+          "character": 1
+        }
+      },
+      "title": "SAP HANA implementation"
+    },
+    {
+      "file": "fiori/package.json",
+      "description": "#### Configuration\n\nThe `cds.requires` section in `package.json` is a place to configure which of the `db/sqlite` and `db/hana` folders are used for which database.\n\nWe use [Node.js profiles](https://cap.cloud.sap/docs/node.js/cds-env#profiles) to separate the configuration.\nIn the `development` profile, you can see that `db/sqlite` is set as the model, while the `db/hana` folder is configured in the `production` profile.  `db-ext` is a pseudo datasource, its name doesn't matter.\n\nSee [`cds.resolve`](https://cap.cloud.sap/docs/node.js/cds-compile#cds-resolve) to learn more about how models are found.",
+      "selection": {
+        "start": {
+          "line": 41,
+          "character": 1
+        },
+        "end": {
+          "line": 48,
+          "character": 1
+        }
+      },
+      "title": "Configuration"
+    },
+    {
+      "file": "fiori/package.json",
+      "description": "#### Run with SQLite\n\nTo run with `development` and an in-memory SQLite database, you don't need to do anything special, because it's activated by default.  Just run:\n\n>> cds watch fiori\n\nThen open [http://localhost:4004/admin/Authors](http://localhost:4004/admin/Authors) to see the two new fields.\n",
+      "line": 43,
+      "title": "Run with SQLite"
+    },
+    {
+      "file": "fiori/package.json",
+      "description": "#### Deploy the CDS Model to SAP HANA\n\nTo 'activate' SAP HANA through the `production` profile, you can use the global `--production` flag:\n\n>> cd fiori; cds deploy --to hana --production\n\n[Learn more about SAP HANA deployment](https://cap.cloud.sap/docs/guides/databases#get-hana)\n\n#### Run the Application\n\n>> cd fiori; cds watch --production\n\nThe service on [http://localhost:4004/admin/Authors](http://localhost:4004/admin/Authors) is the same as before, but this time the `Authors` entity is backed by a database view with an SAP HANA function.\n\n#### More\n\nIf you don't see data, you can add some in the next step.",
+      "line": 46,
+      "title": "Run with SAP HANA"
+    },
+    {
+      "file": "fiori/test/requests.http",
+      "description": "### Add More Data\n\nOptionally you can add some `Authors` data by clicking on the _Send Request_ link (provided by the [REST client](https://marketplace.visualstudio.com/items?itemName=humao.rest-client) extension).",
+      "line": 72,
+      "selection": {
+        "start": {
+          "line": 67,
+          "character": 1
+        },
+        "end": {
+          "line": 73,
+          "character": 1
+        }
+      },
+      "title": "Add Data"
+    },
+    {
+      "title": "Wrap-up",
+      "description": "### Summary\n\nThat's it!  You have seen: \n- How to integrate database-specific functions in a CDS model.\n- How to switch between the two implementations for SQLite and SAP HANA."
+    }
+  ]
+}

.tours/samples.tour

@@ -0,0 +1,139 @@
+{
+  "$schema": "https://aka.ms/codetour-schema",
+  "title": "CAP Samples",
+  "steps": [
+    {
+      "title": "Welcome",
+      "file": "README.md",
+      "description": "### Welcome to CAP Samples!\n\nThis tour leads you through a collection of samples for the [SAP Cloud Application Programming Model (CAP)](https://cap.cloud.sap).\nYou will learn which features of the programming model are demonstrated in which sample.\n\nLet's start!",
+      "line": 2,
+      "selection": {
+        "start": {
+          "line": 1,
+          "character": 1
+        },
+        "end": {
+          "line": 3,
+          "character": 108
+        }
+      }
+    },
+    {
+      "file": "hello/srv/world.cds",
+      "description": "### Hello World!\n\nThis is a simplistic [Hello World](https://cap.cloud.sap/docs/get-started/hello-world) service using [CDS](https://cap.cloud.sap/docs/cds/) and [cds.services](https://cap.cloud.sap/docs/node.js/api#services-api).",
+      "line": 2,
+      "selection": {
+        "start": {
+          "line": 1,
+          "character": 1
+        },
+        "end": {
+          "line": 4,
+          "character": 1
+        }
+      },
+      "title": "Hello World!"
+    },
+    {
+      "file": "bookshop/db/schema.cds",
+      "description": "### A Bookshop!\n\nIntroduces:\n- [Project Setup](https://cap.cloud.sap/docs/get-started/) and [Layouts](https://cap.cloud.sap/docs/get-started/projects)\n- [Domain Modeling](https://cap.cloud.sap/docs/guides/domain-models)\n- [Defining Services](https://cap.cloud.sap/docs/guides/providing-services)\n- [Generic Providers](https://cap.cloud.sap/docs/guides/generic-providers)\n- [Adding Custom Logic](https://cap.cloud.sap/docs/guides/service-impl)\n- [Using Databases](https://cap.cloud.sap/docs/guides/databases)\n",
+      "line": 1,
+      "selection": {
+        "start": {
+          "line": 1,
+          "character": 1
+        },
+        "end": {
+          "line": 32,
+          "character": 1
+        }
+      },
+      "title": "Bookshop"
+    },
+    {
+      "file": "common/index.cds",
+      "description": "### Extend and Reuse\n\nShowcases how to extend [@sap/cds/common](https://cap.cloud.sap/docs/cds/common) thereby covering:\n- Building [extension packages](https://cap.cloud.sap/docs/guides/domain-models#aspects-extensibility)\n- Providing [reuse packages](https://cap.cloud.sap/docs/get-started/projects#sharing-and-reusing-content)\n- [Verticalization](https://cap.cloud.sap/docs/cds/common#adapting-to-your-needs)\n- Using [Aspects](https://cap.cloud.sap/docs/cds/cdl#aspects)\n- Used in the [fiori app sample](#fiori)\n",
+      "line": 1,
+      "selection": {
+        "start": {
+          "line": 1,
+          "character": 1
+        },
+        "end": {
+          "line": 46,
+          "character": 1
+        }
+      },
+      "title": "Common"
+    },
+    {
+      "file": "orders/db/schema.cds",
+      "description": "### Orders - Compositions and Serving Documents\n\nA standalone orders management service, demonstrating:\n- Using [Compositions](https://cap.cloud.sap/docs/cds/cdl#compositions) in [Domain Models](https://cap.cloud.sap/docs/guides/domain-models), along with\n- [Serving deeply nested documents](https://cap.cloud.sap/docs/guides/generic-providers#serving-structured-data)\n",
+      "line": 1,
+      "selection": {
+        "start": {
+          "line": 1,
+          "character": 1
+        },
+        "end": {
+          "line": 27,
+          "character": 1
+        }
+      },
+      "title": "Orders"
+    },
+    {
+      "file": "reviews/db/schema.cds",
+      "description": "### Reviews - More Modularity\n\nShows how to implement a modular service to manage product reviews, including:\n- Consuming other services synchronously and asynchronously\n- Serving requests synchronously\n- Emitting events asynchronously\n- Grow as you go, with:\n- Mocking app services\n- Running service meshes\n- Late-cut Micro Services\n- As well as managed data, input validations, and authorization\n",
+      "line": 1,
+      "selection": {
+        "start": {
+          "line": 1,
+          "character": 1
+        },
+        "end": {
+          "line": 39,
+          "character": 1
+        }
+      },
+      "title": "Reviews"
+    },
+    {
+      "title": "Bookstore",
+      "description": "### Bookstore - Reuse and UI\n\n- A [composite app, reusing and combining](https://cap.cloud.sap/docs/guides/reuse-and-compose) these packages:\n  - [@capire/bookshop](bookshop)\n  - [@capire/reviews](reviews)\n  - [@capire/orders](orders)\n  - [@capire/common](common)\n- [The Vue.js app](bookshop/app/vue) imported from bookshop is served as well\n- [The Vue.js app](reviews/app/vue) imported from reviews is served as well\n- [The Fiori app](orders/app) imported from orders is served as well\n- [OpenAPI export + Swagger UI](https://cap.cloud.sap/docs/advanced/openapi)"
+    },
+    {
+      "file": "fiori/app/services.cds",
+      "description": "### Annotations for SAP Fiori Elements\n\nAdds an SAP Fiori elements application to bookstore, thereby introducing:\n- OData Annotations in `.cds` files\n- Support for Fiori Draft\n- Support for Value Helps\n- Serving SAP Fiori apps locally\n\nSee the [Serving Fiori UIs](https://cap.cloud.sap/docs/advanced/fiori) documentation for more information.",
+      "line": 1,
+      "selection": {
+        "start": {
+          "line": 1,
+          "character": 1
+        },
+        "end": {
+          "line": 13,
+          "character": 1
+        }
+      },
+      "title": "Fiori"
+    },
+    {
+      "file": "package.json",
+      "description": "### All-in-one Monorepo\n\nEach sample sub directory essentially is a standard npm package, some with standard npm dependencies to other samples. The root folder's [package.json](package.json) has local links to the sub folders, such that an `npm install` populates a local `node_modules` folder acts like a local npm registry to the individual sample packages.\n",
+      "selection": {
+        "start": {
+          "line": 8,
+          "character": 1
+        },
+        "end": {
+          "line": 16,
+          "character": 1
+        }
+      },
+      "title": "Packages"
+    }
+  ],
+  "isPrimary": true,
+  "description": "Overview of CAP Samples for Node.js"
+}

.vscode/extensions.json

@@ -0,0 +1,21 @@
+{
+	// See https://go.microsoft.com/fwlink/?LinkId=827846 to learn about workspace recommendations.
+	// Extension identifier format: ${publisher}.${name}. Example: vscode.csharp
+
+	// List of extensions which should be recommended for users of this workspace.
+	"recommendations": [
+		"sapse.vscode-cds",
+		"dbaeumer.vscode-eslint",
+		"esbenp.prettier-vscode",
+		"mechatroner.rainbow-csv",
+		"humao.rest-client",
+		"alexcvzz.vscode-sqlite",
+		"hbenl.vscode-mocha-test-adapter",
+		"sdras.night-owl",
+		"vsls-contrib.codetour"
+	],
+	// List of extensions recommended by VS Code that should not be recommended for users of this workspace.
+	"unwantedRecommendations": [
+
+	]
+}

.vscode/launch.json

@@ -5,32 +5,52 @@
   "version": "0.2.0",
   "configurations": [
     {
-      "name": "bookshop", "request": "launch", "type": "node", "runtimeExecutable": "npx", "runtimeArgs": [ "-n" ],
+      "name": "bookshop",
-      "args": [ "--", "cds", "run", "--in-memory" ],
+      "command": "npx cds watch bookshop",
-      "cwd": "${workspaceFolder}/packages/bookshop",
+      "type": "node-terminal",
-      "console": "integratedTerminal",
+      "request": "launch",
-      "skipFiles": ["<node_internals>/**"]
+      "skipFiles": [
+        "<node_internals>/**",
+        "**/node_modules/**",
+        "**/cds/lib/lazy.js",
+        "**/cds/lib/req/cds-context.js",
+        "**/odata-v4/okra/**"
+      ]
     },
     {
-      "name": "cds run ...", "request": "launch", "type": "node", "runtimeExecutable": "npx", "runtimeArgs": [ "-n" ],
+      "name": "Fiori App",
-      "args": [ "--", "cds", "run", "--with-mocks", "--in-memory?" ],
+      "command": "npx cds watch fiori",
-      "cwd": "${workspaceFolder}/packages/${input:service}",
+      "type": "node-terminal",
-      "console": "integratedTerminal",
+      "request": "launch",
-      "skipFiles": ["<node_internals>/**"]
+      "skipFiles": [
-    }
+        "<node_internals>/**",
+        "**/node_modules/**",
+        "**/cds/lib/lazy.js",
+        "**/cds/lib/req/cds-context.js",
+        "**/odata-v4/okra/**"
+      ]
+    },
+    {
+      "name": "Debug Mocha Tests",
+      "type": "node",
+      "request": "attach",
+      "port": 9229,
+      "continueOnAttach": true,
+      "skipFiles": [
+        "<node_internals>/**",
+        "**/node_modules/**",
+        "**/cds/lib/lazy.js",
+        "**/cds/lib/req/cds-context.js",
+        "**/odata-v4/okra/**",
+      ]
+    },
   ],
   "inputs": [
     {
       "type": "pickString",
-      "id": "service",
+      "id": "sample",
-      "description": "Which service do you want to start?",
+      "description": "Which sample do you want to start?",
-      "options": [
+      "options": [ "bookshop", "fiori", "reviews", "reviews" ],
-        "bookshop",
-        "bookstore",
-        "media-server",
-        "office-supplies",
-        "reviews-service"
-      ],
       "default": "bookshop"
     }
   ]

.vscode/settings.json

@@ -1,6 +1,27 @@
 {
   "files.exclude": {
+    ".reuse/**": true,
     "**/.gitignore": true,
-    "**/.vscode": true
+    "**/.vscode": true,
-  }
+    "LICENSES/**": true
+  },
+  "debug.javascript.terminalOptions": {
+    "skipFiles": [
+      "<node_internals>/**",
+      "**/node_modules/**",
+      "**/cds/lib/lazy.js",
+      "**/cds/lib/req/cds-context.js",
+      "**/odata-v4/okra/**"
+    ]
+  },
+  "mochaExplorer.debuggerConfig": "Debug Mocha Tests",
+  "mochaExplorer.parallel": true,
+  "eslint.validate": [
+    "cds",
+    "csn",
+    "csv",
+    "csv (semicolon)",
+    "tsv",
+    "tab"
+  ],
 }

.vscode/tasks.json

@@ -1,17 +1,15 @@
 {
-    // See https://go.microsoft.com/fwlink/?LinkId=733558
+  // See https://go.microsoft.com/fwlink/?LinkId=733558
-    // for the documentation about the tasks.json format
+  // for the documentation about the tasks.json format
-    "version": "2.0.0",
+  "version": "2.0.0",
-    "tasks": [
+  "tasks": [
-        {
+    {
-            "type": "npm", "script": "watch", "path": "packages/bookshop/",
+      "type": "npm",
-            "options": { "env": { "PORT": "4004" }},
+      "script": "jest",
-            "presentation": { "group": "A" }
+      "group": {
-        },
+        "kind": "test",
-        {
+        "isDefault": true
-            "type": "npm", "script": "watch", "path": "packages/reviews-service/",
+      }
-            "options": { "env": { "PORT": "5005" }},
+    }
-            "presentation": { "group": "A" }
+  ]
-        }
-    ]
 }

LICENSE

@@ -1,190 +1,201 @@
-SAP SAMPLE CODE LICENSE AGREEMENT
+                                  Apache License
-
+                           Version 2.0, January 2004
-Please scroll down and read the following SAP Sample Code License Agreement
+                        http://www.apache.org/licenses/
-carefully ("Agreement"). By downloading, installing, or otherwise using the
+
-SAP sample code or any materials that accompany the sample code documentation
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
-(collectively, the "Sample Code"), You agree that this Agreement forms a legally
+
-binding agreement between You ("You" or "Your") and SAP SE, for and on behalf
+   1. Definitions.
-of itself and its subsidiaries and affiliates (as defined in Section 15 of the
+
-German Stock Corporation Act), and You agree to be bound by all of the terms
+      "License" shall mean the terms and conditions for use, reproduction,
-and conditions stated in this Agreement. If You are trying to access or download
+      and distribution as defined by Sections 1 through 9 of this document.
-the Sample Code on behalf of Your employer or as a consultant or agent of a
+
-third party (either "Your Company"), You represent and warrant that You have
+      "Licensor" shall mean the copyright owner or entity authorized by
-the authority to act on behalf of and bind Your Company to the terms of this
+      the copyright owner that is granting the License.
-Agreement and everywhere in this Agreement that refers to 'You' or 'Your' shall
+
-also include Your Company. If You do not agree to these terms, do not attempt
+      "Legal Entity" shall mean the union of the acting entity and all
-to access or use the Sample Code.
+      other entities that control, are controlled by, or are under common
-
+      control with that entity. For the purposes of this definition,
-1. LICENSE: Subject to the terms of this Agreement, SAP grants You a nonexclusive,
+      "control" means (i) the power, direct or indirect, to cause the
-non-transferable, non-sublicensable, revocable, royalty-free,
+      direction or management of such entity, whether by contract or
-limited license to use, copy, and modify the Sample Code solely for Your internal
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
-business purposes.
+      outstanding shares, or (iii) beneficial ownership of such entity.
-
+
-2. RESTRICTIONS: You must not use the Sample Code to: (a) impair, degrade or
+      "You" (or "Your") shall mean an individual or Legal Entity
-reduce the performance or security of any SAP products, services or related
+      exercising permissions granted by this License.
-technology (collectively, "SAP Products"); (b) enable the bypassing or
+
-circumventing of SAP's license restrictions and/or provide users with access to
+      "Source" form shall mean the preferred form for making modifications,
-the SAP Products to which such users are not licensed; or (c) permit mass data
+      including but not limited to software source code, documentation
-extraction from an SAP Product to a non-SAP Product, including use,
+      source, and configuration files.
-modification, saving or other processing of such data in the non-SAP Product.
+
-Further, You must not: (i) provide or make the Sample Code available to any
+      "Object" form shall mean any form resulting from mechanical
-third party other than your authorized employees, contractors and agents
+      transformation or translation of a Source form, including but
-(collectively, “Representatives”) and solely to be used by Your Representatives
+      not limited to compiled object code, generated documentation,
-for Your own internal business purposes; ii) remove or modify any marks or
+      and conversions to other media types.
-proprietary notices from the Sample Code; iii) assign this Agreement, or any
+
-interest therein, to any third party; (iv) use any SAP name, trademark or logo
+      "Work" shall mean the work of authorship, whether in Source or
-without the prior written authorization of SAP; or (v) use the Sample Code to
+      Object form, made available under the License, as indicated by a
-modify an SAP Product or decompile, disassemble or reverse engineer an SAP
+      copyright notice that is included in or attached to the work
-Product (except to the extent permitted by applicable law). You are responsible
+      (an example is provided in the Appendix below).
-for any breach of the terms of this Agreement by You or Your Representatives.
+
-
+      "Derivative Works" shall mean any work, whether in Source or Object
-3. INTELLECTUAL PROPERTY: SAP or its licensors retain all ownership and
+      form, that is based on (or derived from) the Work and for which the
-intellectual property rights in and to the Sample Code and SAP Products. In
+      editorial revisions, annotations, elaborations, or other modifications
-exchange for the right to use, copy and modify the Sample Code provided under
+      represent, as a whole, an original work of authorship. For the purposes
-this Agreement, You covenant not to assert any intellectual property rights in
+      of this License, Derivative Works shall not include works that remain
-or to any of Your products, services, or related technology that are based on
+      separable from, or merely link (or bind by name) to the interfaces of,
-or incorporate the Sample Code against any individual or entity in respect of
+      the Work and Derivative Works thereof.
-any current or future SAP Products.
+
-
+      "Contribution" shall mean any work of authorship, including
-4. SAP AND THIRD PARTY APIS: The Sample Code may include API (application
+      the original version of the Work and any modifications or additions
-programming interface) calls to SAP and third-party products or services. The
+      to that Work or Derivative Works thereof, that is intentionally
-access or use of the third-party products and services to which the API calls
+      submitted to Licensor for inclusion in the Work by the copyright owner
-are directed may be subject to additional terms and conditions between you and
+      or by an individual or Legal Entity authorized to submit on behalf of
-SAP or such third parties. You (and not SAP) are solely responsible for
+      the copyright owner. For the purposes of this definition, "submitted"
-understanding and complying with any additional terms and conditions that apply
+      means any form of electronic, verbal, or written communication sent
-to the access or use of those APIs and/or third-party products and services.
+      to the Licensor or its representatives, including but not limited to
-SAP does not grant You any rights in or to these APIs, products or services
+      communication on electronic mailing lists, source code control systems,
-under this Agreement.
+      and issue tracking systems that are managed by, or on behalf of, the
-
+      Licensor for the purpose of discussing and improving the Work, but
-5. FREE AND OPEN SOURCE COMPONENTS: The Sample Code may include third party
+      excluding communication that is conspicuously marked or otherwise
-free or open source components ("FOSS Components"). You may have additional
+      designated in writing by the copyright owner as "Not a Contribution."
-rights in such FOSS Components that are provided by the third party licensors
+
-of those components.
+      "Contributor" shall mean Licensor and any individual or Legal Entity
-6. THIRD PARTY DEPENDENCIES: The Sample Code may require third party software
+      on behalf of whom a Contribution has been received by Licensor and
-dependencies ("Dependencies") for the use or operation of the Sample Code. These
+      subsequently incorporated within the Work.
-Dependencies may be identified by SAP in Maven POM files, documentation or by
+
-other means. SAP does not grant You any rights in or to such Dependencies under
+   2. Grant of Copyright License. Subject to the terms and conditions of
-this Agreement. You are solely responsible for the acquisition, installation
+      this License, each Contributor hereby grants to You a perpetual,
-and use of such Dependencies.
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
-7. WARRANTY:
+      copyright license to reproduce, prepare Derivative Works of,
-a) If You are located outside the US or Canada: AS THE SAMPLE CODE IS PROVIDED
+      publicly display, publicly perform, sublicense, and distribute the
-TO YOU FREE OF CHARGE, SAP DOES NOT GUARANTEE OR WARRANT ANY FEATURES OR
+      Work and such Derivative Works in Source or Object form.
-QUALITIES OF THE SAMPLE CODE OR GIVE ANY UNDERTAKING WITH REGARD TO ANY OTHER
+
-QUALITY. NO SUCH WARRANTY OR UNDERTAKING SHALL BE IMPLIED BY YOU FROM ANY
+   3. Grant of Patent License. Subject to the terms and conditions of
-DESCRIPTION IN THE SAMPLE CODE OR ANY OTHER MATERIALS, COMMUNICATION OR
+      this License, each Contributor hereby grants to You a perpetual,
-ADVERTISEMENT. IN PARTICULAR, SAP DOES NOT WARRANT THAT THE SAMPLE CODE WILL BE
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
-AVAILABLE UNINTERRUPTED, ERROR FREE, OR PERMANENTLY AVAILABLE. ALL WARRANTY
+      (except as stated in this section) patent license to make, have made,
-CLAIMS RESPECTING THE SAMPLE CODE ARE SUBJECT TO THE LIMITATION OF LIABILITY
+      use, offer to sell, sell, import, and otherwise transfer the Work,
-STIPULATED IN SECTION 8 BELOW.
+      where such license applies only to those patent claims licensable
-b) If You are located in the US or Canada: THE SAMPLE CODE IS LICENSED TO YOU
+      by such Contributor that are necessarily infringed by their
-"AS IS", WITHOUT ANY WARRANTY, ESCROW, TRAINING, MAINTENANCE, OR SERVICE
+      Contribution(s) alone or by combination of their Contribution(s)
-OBLIGATIONS WHATSOEVER ON THE PART OF SAP. SAP MAKES NO EXPRESS OR IMPLIED
+      with the Work to which such Contribution(s) was submitted. If You
-WARRANTIES OR CONDITIONS OF SALE OF ANY TYPE WHATSOEVER, INCLUDING BUT NOT
+      institute patent litigation against any entity (including a
-LIMITED TO IMPLIED WARRANTIES OF MERCHANTABILITY AND OF FITNESS FOR A PARTICULAR
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
-PURPOSE. IN PARTICULAR, SAP DOES NOT WARRANT THAT THE SAMPLE CODE WILL BE
+      or a Contribution incorporated within the Work constitutes direct
-AVAILABLE UNINTERRUPTED, ERROR FREE, OR PERMANENTLY AVAILABLE. YOU ASSUME ALL
+      or contributory patent infringement, then any patent licenses
-RISKS ASSOCIATED WITH THE USE OF THE SAMPLE CODE, INCLUDING WITHOUT LIMITATION
+      granted to You under this License for that Work shall terminate
-RISKS RELATING TO QUALITY, AVAILABILITY, PERFORMANCE, DATA LOSS, AND UTILITY IN
+      as of the date such litigation is filed.
-A PRODUCTION ENVIRONMENT.
+
-c) For all locations: SAP DOES NOT MAKE ANY REPRESENTATIONS OR WARRANTIES IN
+   4. Redistribution. You may reproduce and distribute copies of the
-RESPECT OF THIRD PARTY DEPENDENCIES, APIS, PRODUCTS AND SERVICES, INCLUDING BUT
+      Work or Derivative Works thereof in any medium, with or without
-NOT LIMITED TO IMPLIED WARRANTIES OF MERCHANTABILITY AND OF FITNESS FOR A
+      modifications, and in Source or Object form, provided that You
-PARTICULAR PURPOSE. IN PARTICULAR, SAP DOES NOT WARRANT THAT THIRDPARTY
+      meet the following conditions:
-DEPENDENCIES, APIS, PRODUCTS AND SERVICES WILL BE AVAILABLE, ERROR FREE,
+
-INTEROPERABLE WITH THE SAMPLE CODE, SUITABLE FOR ANY PARTICULAR PURPOSE OR NONINFRINGING.
+      (a) You must give any other recipients of the Work or
-YOU ASSUME ALL RISKS ASSOCIATED WITH THE USE OF THIRD
+          Derivative Works a copy of this License; and
-PARTY DEPENDENCIES, APIS, PRODUCTS AND SERVICES, INCLUDING WITHOUT LIMITATION
+
-RISKS RELATING TO QUALITY, AVAILABILITY, PERFORMANCE, DATA LOSS, UTILITY IN A
+      (b) You must cause any modified files to carry prominent notices
-PRODUCTION ENVIRONMENT, AND NON-INFRINGEMENT. IN NO EVENT WILL SAP BE LIABLE
+          stating that You changed the files; and
-DIRECTLY OR INDIRECTLY IN RESPECT OF ANY USE OF THIRD PARTY DEPENDENCIES, APIS,
+
-PRODUCTS AND SERVICES BY YOU.
+      (c) You must retain, in the Source form of any Derivative Works
-
+          that You distribute, all copyright, patent, trademark, and
-8. LIMITATION OF LIABILITY:
+          attribution notices from the Source form of the Work,
-a) If You are located outside the US or Canada: IRRESPECTIVE OF THE LEGAL
+          excluding those notices that do not pertain to any part of
-REASONS, SAP SHALL ONLY BE LIABLE FOR DAMAGES UNDER THIS AGREEMENT IF SUCH
+          the Derivative Works; and
-DAMAGE (I) CAN BE CLAIMED UNDER THE GERMAN PRODUCT LIABILITY ACT OR (II) IS
+
-CAUSED BY INTENTIONAL MISCONDUCT OF SAP OR (III) CONSISTS OF PERSONAL INJURY.
+      (d) If the Work includes a "NOTICE" text file as part of its
-IN ALL OTHER CASES, NEITHER SAP NOR ITS EMPLOYEES, AGENTS AND SUBCONTRACTORS
+          distribution, then any Derivative Works that You distribute must
-SHALL BE LIABLE FOR ANY KIND OF DAMAGE OR CLAIMS HEREUNDER.
+          include a readable copy of the attribution notices contained
-b) If You are located in the US or Canada: IN NO EVENT SHALL SAP BE LIABLE TO
+          within such NOTICE file, excluding those notices that do not
-YOU, YOUR COMPANY OR TO ANY THIRD PARTY FOR ANY DAMAGES IN AN AMOUNT IN EXCESS
+          pertain to any part of the Derivative Works, in at least one
-OF $100 ARISING IN CONNECTION WITH YOUR USE OF OR INABILITY TO USE THE SAMPLE
+          of the following places: within a NOTICE text file distributed
-CODE OR IN CONNECTION WITH SAP'S PROVISION OF OR FAILURE TO PROVIDE SERVICES 
+          as part of the Derivative Works; within the Source form or
-PERTAINING TO THE SAMPLE CODE, OR AS A RESULT OF ANY DEFECT IN THE SAMPLE COED.
+          documentation, if provided along with the Derivative Works; or,
-THIS DISCLAIMER OF LIABILITY SHALL APPLY REGARDLESS OF THE FORM OF ACTION THAT
+          within a display generated by the Derivative Works, if and
-MAY BE BROUGHT AGAINST SAP, WHETHER IN CONTRACT OR TORT, INCLUDING WITHOUT
+          wherever such third-party notices normally appear. The contents
-LIMITATION ANY ACTION FOR NEGLIGENCE. YOUR SOLE REMEDY IN THE EVENT OF BREACH
+          of the NOTICE file are for informational purposes only and
-OF THIS AGREEMENT BY SAP OR FOR ANY OTHER CLAIM RELATED TO THE SAMPLE CODE SHALL
+          do not modify the License. You may add Your own attribution
-BE TERMINATION OF THIS AGREEMENT. NOTWITHSTANDING ANYTHING TO THE CONTRARY
+          notices within Derivative Works that You distribute, alongside
-HEREIN, UNDER NO CIRCUMSTANCES SHALL SAP OR ITS LICENSORS BE LIABLE TO YOU OR
+          or as an addendum to the NOTICE text from the Work, provided
-ANY OTHER PERSON OR ENTITY FOR ANY SPECIAL, INCIDENTAL, CONSEQUENTIAL, OR
+          that such additional attribution notices cannot be construed
-INDIRECT DAMAGES, LOSS OF GOOD WILL OR BUSINESS PROFITS, WORK STOPPAGE, DATA
+          as modifying the License.
-LOSS, COMPUTER FAILURE OR MALFUNCTION, ANY AND ALL OTHER COMMERCIAL DAMAGES OR
+
-LOSS, OR EXEMPLARY OR PUNITIVE DAMAGES.
+      You may add Your own copyright statement to Your modifications and
-
+      may provide additional or different license terms and conditions
-9. INDEMNITY: You will fully indemnify, hold harmless and defend SAP against
+      for use, reproduction, or distribution of Your modifications, or
-law suits based on any claim: (a) that any of Your products, services or related
+      for any such Derivative Works as a whole, provided Your use,
-technology that are based on or incorporate the Sample Code infringes or
+      reproduction, and distribution of the Work otherwise complies with
-misappropriates any patent, copyright, trademark, trade secrets, or other
+      the conditions stated in this License.
-proprietary rights of a third party, or (b) related to Your alleged violation
+
-of the terms of this Agreement.
+   5. Submission of Contributions. Unless You explicitly state otherwise,
-
+      any Contribution intentionally submitted for inclusion in the Work
-10. EXPORT: The Sample Code is subject to German, EU and US export control
+      by You to the Licensor shall be under the terms and conditions of
-regulations. You confirm that: a) You will not use the Sample Code for, and
+      this License, without any additional terms or conditions.
-will not allow the Sample Code to be used for, any purposes prohibited by
+      Notwithstanding the above, nothing herein shall supersede or modify
-German, EU and US law, including, without limitation, for the development,
+      the terms of any separate license agreement you may have executed
-design, manufacture or production of nuclear, chemical or biological weapons of
+      with Licensor regarding such Contributions.
-mass destruction; b) You are not located in Cuba, Iran, Sudan, Iraq, North
+
-Korea, Syria, nor any other country to which the United States has prohibited
+   6. Trademarks. This License does not grant permission to use the trade
-export or that has been designated by the U.S. Government as a "terrorist
+      names, trademarks, service marks, or product names of the Licensor,
-supporting" country (any, an "US Embargoed Country"); c) You are not a citizen,
+      except as required for reasonable and customary use in describing the
-national or resident of, and are not under the control of, a US Embargoed
+      origin of the Work and reproducing the content of the NOTICE file.
-Country; d) You will not download or otherwise export or re-export the Sample
+
-Code, directly or indirectly, to a US Embargoed Country nor to citizens,
+   7. Disclaimer of Warranty. Unless required by applicable law or
-nationals or residents of a US Embargoed Country; e) You are not listed on the
+      agreed to in writing, Licensor provides the Work (and each
-United States Department of Treasury lists of Specially Designated Nationals,
+      Contributor provides its Contributions) on an "AS IS" BASIS,
-Specially Designated Terrorists, and Specially Designated Narcotic Traffickers,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
-nor listed on the United States Department of Commerce Table of Denial Orders
+      implied, including, without limitation, any warranties or conditions
-or any other U.S. government list of prohibited or restricted parties and f)
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
-You will not download or otherwise export or re-export the Sample Code, directly
+      PARTICULAR PURPOSE. You are solely responsible for determining the
-or indirectly, to persons on the above-mentioned lists.
+      appropriateness of using or redistributing the Work and assume any
-
+      risks associated with Your exercise of permissions under this License.
-11. SUPPORT: SAP does not offer support for the Sample Code.
+
-
+   8. Limitation of Liability. In no event and under no legal theory,
-12. TERM AND TERMINATION: You may terminate this Agreement by destroying all
+      whether in tort (including negligence), contract, or otherwise,
-copies of the Sample Code in Your possession or control. SAP may terminate Your
+      unless required by applicable law (such as deliberate and grossly
-license to use the Sample Code immediately if You fail to comply with any of
+      negligent acts) or agreed to in writing, shall any Contributor be
-the terms of this Agreement, or, for SAP's convenience by providing you with
+      liable to You for damages, including any direct, indirect, special,
-ten (10) days written notice of termination. In case of termination or
+      incidental, or consequential damages of any character arising as a
-expiration of this Agreement, You must immediately destroy all copies of the
+      result of this License or out of the use or inability to use the
-Sample Code in your possession or control. In the event Your Company is acquired
+      Work (including but not limited to damages for loss of goodwill,
-(by merger, purchase of stock, assets or intellectual property or exclusive
+      work stoppage, computer failure or malfunction, or any and all
-license), or You become employed, by a direct competitor of SAP, then this
+      other commercial damages or losses), even if such Contributor
-Agreement and all licenses granted to You in this Agreement shall immediately
+      has been advised of the possibility of such damages.
-terminate upon the date of such acquisition or change of employment.
+
-
+   9. Accepting Warranty or Additional Liability. While redistributing
-13. LAW/VENUE:
+      the Work or Derivative Works thereof, You may choose to offer,
-a) If You are located outside the US or Canada: This Agreement is governed by
+      and charge a fee for, acceptance of support, warranty, indemnity,
-and construed in accordance with the laws of Germany without reference to its
+      or other liability obligations and/or rights consistent with this
-conflicts of law principles. You and SAP agree to submit to the exclusive 
+      License. However, in accepting such obligations, You may act only
-jurisdiction of, and venue in, the courts located in Karlsruhe, Germany in any
+      on Your own behalf and on Your sole responsibility, not on behalf
-dispute arising out of or relating to this Agreement or the Sample Code. The
+      of any other Contributor, and only if You agree to indemnify,
-United Nations Convention on Contracts for the International Sale of Goods shall
+      defend, and hold each Contributor harmless for any liability
-not apply to this Agreement.
+      incurred by, or claims asserted against, such Contributor by reason
-b) If You are located in the US or Canada: This Agreement shall be governed by
+      of your accepting any such warranty or additional liability.
-and construed in accordance with the laws of the State of New York, USA without
+
-reference to its conflicts of law principles. You and SAP agree to submit to
+   END OF TERMS AND CONDITIONS
-the exclusive jurisdiction of, and venue in, the courts located in New York,
+
-New York, USA in any dispute arising out of or relating to this Agreement or
+   APPENDIX: How to apply the Apache License to your work.
-the Sample Code. The United Nations Convention on Contracts for the
+
-International Sale of Goods shall not apply to this Agreement.
+      To apply the Apache License to your work, attach the following
-
+      boilerplate notice, with the fields enclosed by brackets "[]"
-14. MISCELLANEOUS: This Agreement is the complete agreement between the parties
+      replaced with your own identifying information. (Don't include
-respecting the Sample Code. This Agreement supersedes all prior or
+      the brackets!)  The text should be enclosed in the appropriate
-contemporaneous agreements or representations with regards to the Sample Code.
+      comment syntax for the file format. We also recommend that a
-If any term of this Agreement is found to be invalid or unenforceable, the
+      file or class name and description of purpose be included on the
-surviving provisions shall remain effective. SAP's failure to enforce any right
+      same "printed page" as the copyright notice for easier
-or provisions stipulated in this Agreement will not constitute a waiver of such
+      identification within third-party archives.
-provision, or any other provision of this Agreement.
+
-
+   Copyright [yyyy] [name of copyright owner]
-v1.0-071618 
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

LICENSES/Apache-2.0.txt

@@ -0,0 +1,73 @@
+Apache License
+Version 2.0, January 2004
+http://www.apache.org/licenses/
+
+TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+1. Definitions.
+
+"License" shall mean the terms and conditions for use, reproduction, and distribution as defined by Sections 1 through 9 of this document.
+
+"Licensor" shall mean the copyright owner or entity authorized by the copyright owner that is granting the License.
+
+"Legal Entity" shall mean the union of the acting entity and all other entities that control, are controlled by, or are under common control with that entity. For the purposes of this definition, "control" means (i) the power, direct or indirect, to cause the direction or management of such entity, whether by contract or otherwise, or (ii) ownership of fifty percent (50%) or more of the outstanding shares, or (iii) beneficial ownership of such entity.
+
+"You" (or "Your") shall mean an individual or Legal Entity exercising permissions granted by this License.
+
+"Source" form shall mean the preferred form for making modifications, including but not limited to software source code, documentation source, and configuration files.
+
+"Object" form shall mean any form resulting from mechanical transformation or translation of a Source form, including but not limited to compiled object code, generated documentation, and conversions to other media types.
+
+"Work" shall mean the work of authorship, whether in Source or Object form, made available under the License, as indicated by a copyright notice that is included in or attached to the work (an example is provided in the Appendix below).
+
+"Derivative Works" shall mean any work, whether in Source or Object form, that is based on (or derived from) the Work and for which the editorial revisions, annotations, elaborations, or other modifications represent, as a whole, an original work of authorship. For the purposes of this License, Derivative Works shall not include works that remain separable from, or merely link (or bind by name) to the interfaces of, the Work and Derivative Works thereof.
+
+"Contribution" shall mean any work of authorship, including the original version of the Work and any modifications or additions to that Work or Derivative Works thereof, that is intentionally submitted to Licensor for inclusion in the Work by the copyright owner or by an individual or Legal Entity authorized to submit on behalf of the copyright owner. For the purposes of this definition, "submitted" means any form of electronic, verbal, or written communication sent to the Licensor or its representatives, including but not limited to communication on electronic mailing lists, source code control systems, and issue tracking systems that are managed by, or on behalf of, the Licensor for the purpose of discussing and improving the Work, but excluding communication that is conspicuously marked or otherwise designated in writing by the copyright owner as "Not a Contribution."
+
+"Contributor" shall mean Licensor and any individual or Legal Entity on behalf of whom a Contribution has been received by Licensor and subsequently incorporated within the Work.
+
+2. Grant of Copyright License. Subject to the terms and conditions of this License, each Contributor hereby grants to You a perpetual, worldwide, non-exclusive, no-charge, royalty-free, irrevocable copyright license to reproduce, prepare Derivative Works of, publicly display, publicly perform, sublicense, and distribute the Work and such Derivative Works in Source or Object form.
+
+3. Grant of Patent License. Subject to the terms and conditions of this License, each Contributor hereby grants to You a perpetual, worldwide, non-exclusive, no-charge, royalty-free, irrevocable (except as stated in this section) patent license to make, have made, use, offer to sell, sell, import, and otherwise transfer the Work, where such license applies only to those patent claims licensable by such Contributor that are necessarily infringed by their Contribution(s) alone or by combination of their Contribution(s) with the Work to which such Contribution(s) was submitted. If You institute patent litigation against any entity (including a cross-claim or counterclaim in a lawsuit) alleging that the Work or a Contribution incorporated within the Work constitutes direct or contributory patent infringement, then any patent licenses granted to You under this License for that Work shall terminate as of the date such litigation is filed.
+
+4. Redistribution. You may reproduce and distribute copies of the Work or Derivative Works thereof in any medium, with or without modifications, and in Source or Object form, provided that You meet the following conditions:
+
+     (a) You must give any other recipients of the Work or Derivative Works a copy of this License; and
+
+     (b) You must cause any modified files to carry prominent notices stating that You changed the files; and
+
+     (c) You must retain, in the Source form of any Derivative Works that You distribute, all copyright, patent, trademark, and attribution notices from the Source form of the Work, excluding those notices that do not pertain to any part of the Derivative Works; and
+
+     (d) If the Work includes a "NOTICE" text file as part of its distribution, then any Derivative Works that You distribute must include a readable copy of the attribution notices contained within such NOTICE file, excluding those notices that do not pertain to any part of the Derivative Works, in at least one of the following places: within a NOTICE text file distributed as part of the Derivative Works; within the Source form or documentation, if provided along with the Derivative Works; or, within a display generated by the Derivative Works, if and wherever such third-party notices normally appear. The contents of the NOTICE file are for informational purposes only and do not modify the License. You may add Your own attribution notices within Derivative Works that You distribute, alongside or as an addendum to the NOTICE text from the Work, provided that such additional attribution notices cannot be construed as modifying the License.
+
+     You may add Your own copyright statement to Your modifications and may provide additional or different license terms and conditions for use, reproduction, or distribution of Your modifications, or for any such Derivative Works as a whole, provided Your use, reproduction, and distribution of the Work otherwise complies with the conditions stated in this License.
+
+5. Submission of Contributions. Unless You explicitly state otherwise, any Contribution intentionally submitted for inclusion in the Work by You to the Licensor shall be under the terms and conditions of this License, without any additional terms or conditions. Notwithstanding the above, nothing herein shall supersede or modify the terms of any separate license agreement you may have executed with Licensor regarding such Contributions.
+
+6. Trademarks. This License does not grant permission to use the trade names, trademarks, service marks, or product names of the Licensor, except as required for reasonable and customary use in describing the origin of the Work and reproducing the content of the NOTICE file.
+
+7. Disclaimer of Warranty. Unless required by applicable law or agreed to in writing, Licensor provides the Work (and each Contributor provides its Contributions) on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied, including, without limitation, any warranties or conditions of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A PARTICULAR PURPOSE. You are solely responsible for determining the appropriateness of using or redistributing the Work and assume any risks associated with Your exercise of permissions under this License.
+
+8. Limitation of Liability. In no event and under no legal theory, whether in tort (including negligence), contract, or otherwise, unless required by applicable law (such as deliberate and grossly negligent acts) or agreed to in writing, shall any Contributor be liable to You for damages, including any direct, indirect, special, incidental, or consequential damages of any character arising as a result of this License or out of the use or inability to use the Work (including but not limited to damages for loss of goodwill, work stoppage, computer failure or malfunction, or any and all other commercial damages or losses), even if such Contributor has been advised of the possibility of such damages.
+
+9. Accepting Warranty or Additional Liability. While redistributing the Work or Derivative Works thereof, You may choose to offer, and charge a fee for, acceptance of support, warranty, indemnity, or other liability obligations and/or rights consistent with this License. However, in accepting such obligations, You may act only on Your own behalf and on Your sole responsibility, not on behalf of any other Contributor, and only if You agree to indemnify, defend, and hold each Contributor harmless for any liability incurred by, or claims asserted against, such Contributor by reason of your accepting any such warranty or additional liability.
+
+END OF TERMS AND CONDITIONS
+
+APPENDIX: How to apply the Apache License to your work.
+
+To apply the Apache License to your work, attach the following boilerplate notice, with the fields enclosed by brackets "[]" replaced with your own identifying information. (Don't include the brackets!)  The text should be enclosed in the appropriate comment syntax for the file format. We also recommend that a file or class name and description of purpose be included on the same "printed page" as the copyright notice for easier identification within third-party archives.
+
+Copyright [yyyy] [name of copyright owner]
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.

NOTICE

@@ -1 +0,0 @@
-Copyright (c) 2019 SAP SE or an SAP affiliate company. All rights reserved.

README.md

@@ -1,73 +1,87 @@
-# cloud-cap-samples
+# Welcome to cap/samples
 
-This is a monorepository for sample projects on [SAP Cloud Application Programming Model](https://cap.cloud.sap).
+Find here a collection of samples for the [SAP Cloud Application Programming Model](https://cap.cloud.sap) organized in a simplistic [monorepo setup](samples.md#all-in-one-monorepo). → See [**Overview** of contained samples](samples.md)
 
-## Description
+![](https://github.com/SAP-samples/cloud-cap-samples/workflows/CI/badge.svg)
+[![REUSE status](https://api.reuse.software/badge/github.com/SAP-samples/cloud-cap-samples)](https://api.reuse.software/info/github.com/SAP-samples/cloud-cap-samples)
 
-This repository provides a list of samples and reusable packages created based on SAP Cloud Application Programming Model.
+### Preliminaries
-The SAP Cloud Application Programming Model enables you to quickly create business applications by allowing you to focus on your domain logic. It offers a consistent end-to-end programming model that includes languages, libraries and APIs tailored for full-stack development on SAP Cloud Platform.
 
-The samples provided can be run in a local setup on SQLite Database.
+1. Ensure you have the latest LTS version of Node.js installed (see [Getting Started](https://cap.cloud.sap/docs/get-started/))
+2. Install [**@sap/cds-dk**](https://cap.cloud.sap/docs/get-started/) globally:
 
+   ```sh
+   npm i -g @sap/cds-dk
+   ```
 
-## Requirements
+3. _Optional:_ [Use Visual Studio Code](https://cap.cloud.sap/docs/get-started/tools#vscode)
-* [Node.js](https://nodejs.org/en/) v8 or higher
-* [Git](https://git-scm.com)
-* [SQLite DB](https://www.sqlite.org/download.html) (Windows only; pre-installed on Mac/Linux)
 
-#### Optional (if you want to import the code into an editor)
+### Download
-* [VS Code](https://code.visualstudio.com)
-* [Add CDS extension to VS](https://cap.cloud.sap/docs/get-started/in-vscode#add-cds-editor)
 
-## Download and Installation
+If you've [Git](https://git-scm.com/downloads) installed, clone this repo as shown below, otherwise [download as ZIP file](archive/main.zip).
 
-#### Install `cds` development kit
 ```sh
-# sets the registry for `@sap` packages
+git clone https://github.com/sap-samples/cloud-cap-samples samples
-npm set @sap:registry=https://npm.sap.com
+cd samples
-
-npm install -g @sap/cds-dk
-cds  #> test-run it
 ```
-Got issues?  Check out the [documentation](https://cap.cloud.sap/docs/get-started/).
 
-#### Clone and build the application
+### Setup
-`git clone https://github.com/SAP-samples/cloud-cap-samples samples && cd samples && npm i`
 
-#### Run the samples
+In the samples folder run:
 
-With that you're ready to run the samples, e.g. start the [_bookshop_](./packages/bookshop) sample as follows:
+```sh
+npm install
+```
 
-`npm run bookshop`
+### Run
 
-## Test
+With that you're ready to run the samples, for example:
 
-For example, try these links in your browser:
+```sh
-- <http://localhost:4004> to test with generic index page.
+cds watch bookshop
-- <http://localhost:4004/fiori.html> to test with Fiori sandbox.
+```
+
+After that open this link in your browser: [http://localhost:4004](http://localhost:4004)
+
+When asked to log in, type `alice` as user and leave the password field blank, which is the [default user](https://cap.cloud.sap/docs/node.js/authentication#mocked).
+
+### Testing
+
+Run the provided tests with [_jest_](http://jestjs.io) or [_mocha_](http://mochajs.org), for example:
+
+```sh
+npx jest
+```
+> While mocha is a bit smaller and faster, jest runs tests in parallel and isolation, which allows to run all tests.
 
 
-## Debug
+### Serve `npm`
 
-For example, in [VS Code](https://code.visualstudio.com) switch to _Debug_ view and launch one of the prepared _cds run_ launch configurations.
+We've included a simple npm registry mock, which allows you to do an `npm install @capire/<package>` locally. Use it as follows:
+
+1. Start the @capire registry:
+```sh
+npm run registry
+```
+> While running this will have `@capire:registry=http://localhost:4444` set with npmrc.
+
+2. Install one of the @capire packages wherever you like, for example:
+
+```sh
+npm add @capire/common @capire/bookshop
+```
 
 
-## Limitations
+## Code Tours
 
-None
+Take one of the [guided tours](.tours) in VS Code through our CAP samples and learn which CAP features are showcased by the different parts of the repository. Just install the [CodeTour extension](https://marketplace.visualstudio.com/items?itemName=vsls-contrib.codetour) for VS Code. We'll add more code tours in the future. Stay tuned!
 
-## Known Issues
+## Get Support
 
-None
+Check out the documentation at [https://cap.cloud.sap](https://cap.cloud.sap). <br>
+In case you've a question, find a bug, or otherwise need support, use our [community](https://answers.sap.com/tags/9f13aee1-834c-4105-8e43-ee442775e5ce) to get more visibility.
 
-## How to obtain support
-
-Check out the documentation on https://cap.cloud.sap.  In case you find a bug, or you need additional support, please open an issue [here](https://github.com/SAP-samples/cloud-cap-samples/issues/new) in GitHub.
-
-## To-Do (upcoming changes)
-
-None
 
 ## License
 
-Copyright (c) 2019 SAP SE or an SAP affiliate company. All rights reserved. This file is licensed under SAP Sample Code License Agreement, except as noted otherwise in the [LICENSE](/LICENSE) file.
+Copyright (c) 2022 SAP SE or an SAP affiliate company. All rights reserved. This file is licensed under the Apache Software License, version 2.0 except as noted otherwise in the [LICENSE](LICENSE) file.

bookshop/.vscode/launch.json

@@ -0,0 +1,25 @@
+{
+  // Use IntelliSense to learn about possible attributes.
+  // Hover to view descriptions of existing attributes.
+  // For more information, visit: https://go.microsoft.com/fwlink/?linkid=830387
+  "version": "0.2.0",
+  "configurations": [
+    {
+      "name": "Attach to...",
+      "type": "node",
+      "request": "attach",
+      "processId": "${command:PickProcess}",
+      "skipFiles": ["<node_internals>/**"]
+    },
+    {
+      "name": "cds run",
+      "type": "node",
+      "request": "launch",
+      "runtimeExecutable": "npx",
+      "runtimeArgs": ["-n"],
+      "args": ["--", "cds", "run", "--with-mocks", "--in-memory?"],
+      "console": "integratedTerminal",
+      "skipFiles": ["<node_internals>/**"]
+    }
+  ]
+}

bookshop/app/vue/app.js

@@ -0,0 +1,89 @@
+/* global Vue axios */ //> from vue.html
+const $ = sel => document.querySelector(sel)
+const GET = (url) => axios.get('/browse'+url)
+const POST = (cmd,data) => axios.post('/browse'+cmd,data)
+
+const books = Vue.createApp ({
+
+    data() {
+      return {
+        list: [],
+        book: undefined,
+        order: { quantity:1, succeeded:'', failed:'' },
+        user: undefined
+      }
+    },
+
+    methods: {
+
+        search: ({target:{value:v}}) => books.fetch(v && '&$search='+v),
+
+        async fetch (etc='') {
+            const {data} = await GET(`/ListOfBooks?$expand=genre,currency${etc}`)
+            books.list = data.value
+        },
+
+        async inspect (eve) {
+            const book = books.book = books.list [eve.currentTarget.rowIndex-1]
+            const res = await GET(`/Books/${book.ID}?$select=descr,stock,image`)
+            Object.assign (book, res.data)
+            books.order = { quantity:1 }
+            setTimeout (()=> $('form > input').focus(), 111)
+        },
+
+        async submitOrder () {
+            const {book,order} = books, quantity = parseInt (order.quantity) || 1 // REVISIT: Okra should be less strict
+            try {
+                const res = await POST(`/submitOrder`, { quantity, book: book.ID })
+                book.stock = res.data.stock
+                books.order = { quantity, succeeded: `Successfully ordered ${quantity} item(s).` }
+            } catch (e) {
+                books.order = { quantity, failed: e.response.data.error ? e.response.data.error.message : e.response.data }
+            }
+        },
+
+        async login() {
+            try {
+                const { data:user } = await axios.post('/user/login',{})
+                if (user.id !== 'anonymous') books.user = user
+            } catch (err) { books.user = { id: err.message } }
+        },
+
+        async getUserInfo() {
+            try {
+                const { data:user } = await axios.get('/user/me')
+                if (user.id !== 'anonymous') books.user = user
+            } catch (err) { books.user = { id: err.message } }
+        },
+    }
+}).mount('#app')
+
+books.getUserInfo()
+books.fetch() // initially fill list of books
+
+document.addEventListener('keydown', (event) => {
+    // hide user info on request
+    if (event.key === 'u')  books.user = undefined
+})
+
+axios.interceptors.request.use(csrfToken)
+function csrfToken (request) {
+    if (request.method === 'head' || request.method === 'get') return request
+    if ('csrfToken' in document) {
+        request.headers['x-csrf-token'] = document.csrfToken
+        return request
+    }
+    return fetchToken().then(token => {
+        document.csrfToken = token
+        request.headers['x-csrf-token'] = document.csrfToken
+        return request
+    }).catch(_ => {
+        document.csrfToken = null // set mark to not try again
+        return request
+    })
+
+    function fetchToken() {
+        return axios.get('/', { headers: { 'x-csrf-token': 'fetch' } })
+        .then(res => res.headers['x-csrf-token'])
+    }
+}

bookshop/app/vue/index.html

@@ -0,0 +1,78 @@
+<!DOCTYPE html>
+<html>
+
+<head>
+    <title> Capire Books </title>
+    <link rel="stylesheet" href="https://unpkg.com/primitive-ui/dist/css/main.css">
+    <script src="https://cdn.jsdelivr.net/npm/axios/dist/axios.min.js"></script>
+    <script src="https://cdn.jsdelivr.net/npm/vue@3/dist/vue.global.prod.js"></script>
+    <style>
+        .hovering tr:hover td { color:cyan; background: #123; cursor: pointer; }
+        .rating-stars { color:teal }
+        .succeeded { color:teal }
+        .failed { color:red }
+        .user {text-align: end; color: grey;}
+    </style>
+</head>
+
+<body class="small-container", style="margin-top: 70px;">
+<div id='app'>
+
+    <form class="user" @submit.prevent="login">
+        <div v-if="user">
+            <div v-if="user.tenant">Tenant: {{ user.tenant }}</div>
+            <div> User: {{ user.id }}</div>
+            <div>Locale: {{ user.locale }}</div>
+        </div>
+        <div v-else>
+            <input type="submit" value="Login" class="muted-button">
+            <!-- <a href="/user/login()">Login</a> -->
+        </div>
+    </form>
+
+    <h1> Capire Books </h1>
+
+    <input type="text" placeholder="Search..." @input="search">
+
+    <table id='books' class="hovering">
+        <thead>
+            <th> Book </th>
+            <th> Author </th>
+            <th> Genre </th>
+            <th> Rating </th>
+            <th> Price </th>
+        </thead>
+        <tr v-for="book in list" v-bind:id="book.ID" v-on:click="inspect">
+            <td>{{ book.title }}</td>
+            <td>{{ book.author }}</td>
+            <td>{{ book.genre.name }}</td>
+            <td class="rating-stars">
+                {{ ('★'.repeat(Math.round(book.rating))+'☆☆☆☆☆').slice(0,5) }} ({{ book.numberOfReviews }})
+            </td>
+            <td>{{ book.currency && book.currency.symbol }} {{ book.price }}</td>
+        </tr>
+    </table>
+
+    <div v-if="book">
+        <img v-bind:src="book.image" alt=""/>
+        <label style="text-align:right">
+            <span class="succeeded"> {{ order.succeeded }} </span>
+            <span class="failed"> {{ order.failed }} </span>
+            &nbsp;&nbsp; {{ book.stock }} in stock
+        </label>
+        <form @submit.prevent="submitOrder" style="float:right; display:flex; flex-direction:row-reverse">
+            <input type="number" v-model="order.quantity" v-bind:class="{ failed: order.failed }" style="width:5em">
+            <input type="submit" value="Order:" class="muted-button">
+        </form>
+        <h4> {{ book.title }} </h4>
+        <p> {{ book.descr }} </p>
+    </div>
+    <div v-else>
+        ( click on a row to see details... )
+    </div>
+
+</div>
+</body>
+
+<script src="app.js"></script>
+</html>