From ab69accd5b36526d64d02908f0ac4e93ea39a741 Mon Sep 17 00:00:00 2001 From: BrigittaK307 Date: Fri, 6 Mar 2026 10:58:08 +0200 Subject: [PATCH 01/10] Updated cloud sdk diagram using mermaid --- docs-js/overview.mdx | 50 +++++++-- package-lock.json | 249 +++++++++++++++++++++++++++++++------------ 2 files changed, 220 insertions(+), 79 deletions(-) diff --git a/docs-js/overview.mdx b/docs-js/overview.mdx index 3b4773edb1d..d3a58011290 100644 --- a/docs-js/overview.mdx +++ b/docs-js/overview.mdx @@ -50,15 +50,47 @@ The image below shows the relationship between the individual core libraries. - +```mermaid +flowchart TB + subgraph openapiClientsGroup["OpenAPI Clients"] + openapiClients["OpenAPI clients"] + end + + subgraph odataClientsGroup["OData Clients"] + odataV2Clients["OData v2 clients"] + odataV4Clients["OData v4 clients"] + end + + subgraph generators["Generators"] + openapiGen["openapi-generator"] + generator["generator"] + end + + subgraph core["Core Libraries"] + openapi["openapi"] + odataV4["odata-v4"] + odataV2["odata-v2"] + end + + subgraph foundation["Foundation"] + httpClient["http-client"] + connectivity["connectivity"] + end + + openapiGen -.-> |generates| openapiClients + generator -.-> |generates| odataV2Clients + generator -.-> |generates| odataV4Clients + + openapi --> httpClient + odataV4 --> httpClient + odataV2 --> httpClient + + httpClient --> connectivity + + openapiClients --> openapi + odataV2Clients --> odataV2 + odataV4Clients --> odataV4 +``` diff --git a/package-lock.json b/package-lock.json index 5f653298419..2d361694dcc 100644 --- a/package-lock.json +++ b/package-lock.json @@ -4641,12 +4641,12 @@ } }, "node_modules/@mermaid-js/parser": { - "version": "0.6.3", - "resolved": "https://registry.npmjs.org/@mermaid-js/parser/-/parser-0.6.3.tgz", - "integrity": "sha512-lnjOhe7zyHjc+If7yT4zoedx2vo4sHaTmtkl1+or8BRTnCtDmcTpAjpzDSfCZrshM5bCoz0GyidzadJAH1xobA==", + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/@mermaid-js/parser/-/parser-1.0.0.tgz", + "integrity": "sha512-vvK0Hi/VWndxoh03Mmz6wa1KDriSPjS2XMZL/1l19HFwygiObEEoEwSDxOqyLzzAI6J2PU3261JjTMTO7x+BPw==", "license": "MIT", "dependencies": { - "langium": "3.3.1" + "langium": "^4.0.0" } }, "node_modules/@nodelib/fs.scandir": { @@ -5963,9 +5963,9 @@ } }, "node_modules/@typescript-eslint/typescript-estree/node_modules/minimatch": { - "version": "10.2.2", - "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-10.2.2.tgz", - "integrity": "sha512-+G4CpNBxa5MprY+04MbgOw1v7So6n5JY166pFi9KfYwT78fxScCeSNQSNzp6dpPSW2rONOps6Ocam1wFhCgoVw==", + "version": "10.2.4", + "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-10.2.4.tgz", + "integrity": "sha512-oRjTw/97aTBN0RHbYCdtF1MQfvusSIBQM0IZEgzl6426+8jSC0nF1a/GmnVLpfB9yyr6g6FTqWqiZVbxrtaCIg==", "dev": true, "license": "BlueOak-1.0.0", "dependencies": { @@ -6930,23 +6930,23 @@ } }, "node_modules/body-parser": { - "version": "1.20.3", - "resolved": "https://registry.npmjs.org/body-parser/-/body-parser-1.20.3.tgz", - "integrity": "sha512-7rAxByjUMqQ3/bHJy7D6OGXvx/MMc4IqBn/X0fcM1QUcAItpZrBEYhWGem+tzXH90c+G01ypMcYJBO9Y30203g==", + "version": "1.20.4", + "resolved": "https://registry.npmjs.org/body-parser/-/body-parser-1.20.4.tgz", + "integrity": "sha512-ZTgYYLMOXY9qKU/57FAo8F+HA2dGX7bqGc71txDRC1rS4frdFI5R7NhluHxH6M0YItAP0sHB4uqAOcYKxO6uGA==", "license": "MIT", "dependencies": { - "bytes": "3.1.2", + "bytes": "~3.1.2", "content-type": "~1.0.5", "debug": "2.6.9", "depd": "2.0.0", - "destroy": "1.2.0", - "http-errors": "2.0.0", - "iconv-lite": "0.4.24", - "on-finished": "2.4.1", - "qs": "6.13.0", - "raw-body": "2.5.2", + "destroy": "~1.2.0", + "http-errors": "~2.0.1", + "iconv-lite": "~0.4.24", + "on-finished": "~2.4.1", + "qs": "~6.14.0", + "raw-body": "~2.5.3", "type-is": "~1.6.18", - "unpipe": "1.0.0" + "unpipe": "~1.0.0" }, "engines": { "node": ">= 0.8", @@ -6971,12 +6971,41 @@ "ms": "2.0.0" } }, + "node_modules/body-parser/node_modules/http-errors": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/http-errors/-/http-errors-2.0.1.tgz", + "integrity": "sha512-4FbRdAX+bSdmo4AUFuS0WNiPz8NgFt+r8ThgNWmlrjQjt1Q7ZR9+zTlce2859x4KSXrwIsaeTqDoKQmtP8pLmQ==", + "license": "MIT", + "dependencies": { + "depd": "~2.0.0", + "inherits": "~2.0.4", + "setprototypeof": "~1.2.0", + "statuses": "~2.0.2", + "toidentifier": "~1.0.1" + }, + "engines": { + "node": ">= 0.8" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/express" + } + }, "node_modules/body-parser/node_modules/ms": { "version": "2.0.0", "resolved": "https://registry.npmjs.org/ms/-/ms-2.0.0.tgz", "integrity": "sha512-Tpp60P6IUJDTuOq/5Z8cdskzJujfwqfOTkrwIwj7IRISpnkJnT6SyJ4PCPnGMoFjC9ddhal5KVIYtAt97ix05A==", "license": "MIT" }, + "node_modules/body-parser/node_modules/statuses": { + "version": "2.0.2", + "resolved": "https://registry.npmjs.org/statuses/-/statuses-2.0.2.tgz", + "integrity": "sha512-DvEy55V3DB7uknRo+4iOGT5fP1slR8wQohVdknigZPMpMstaKJQWhwiYBACJE3Ul2pTnATihhBYnRhZQHGBiRw==", + "license": "MIT", + "engines": { + "node": ">= 0.8" + } + }, "node_modules/bonjour-service": { "version": "1.3.0", "resolved": "https://registry.npmjs.org/bonjour-service/-/bonjour-service-1.3.0.tgz", @@ -10434,21 +10463,6 @@ "integrity": "sha512-RA1GjUVMnvYFxuqovrEqZoxxW5NUZqbwKtYz/Tt7nXerk0LbLblQmrsgdeOxV5SFHf0UDggjS/bSeOZwt1pmEQ==", "license": "MIT" }, - "node_modules/express/node_modules/qs": { - "version": "6.14.0", - "resolved": "https://registry.npmjs.org/qs/-/qs-6.14.0.tgz", - "integrity": "sha512-YWWTjgABSKcvs/nWBi9PycY/JiPJqOD4JA6o9Sej2AtvSGarXxKC3OQSk4pAarbdQlKAh5D4FCQkJNkW+GAn3w==", - "license": "BSD-3-Clause", - "dependencies": { - "side-channel": "^1.1.0" - }, - "engines": { - "node": ">=0.6" - }, - "funding": { - "url": "https://github.com/sponsors/ljharb" - } - }, "node_modules/express/node_modules/range-parser": { "version": "1.2.1", "resolved": "https://registry.npmjs.org/range-parser/-/range-parser-1.2.1.tgz", @@ -12942,21 +12956,81 @@ } }, "node_modules/langium": { - "version": "3.3.1", - "resolved": "https://registry.npmjs.org/langium/-/langium-3.3.1.tgz", - "integrity": "sha512-QJv/h939gDpvT+9SiLVlY7tZC3xB2qK57v0J04Sh9wpMb6MP1q8gB21L3WIo8T5P1MSMg3Ep14L7KkDCFG3y4w==", + "version": "4.2.1", + "resolved": "https://registry.npmjs.org/langium/-/langium-4.2.1.tgz", + "integrity": "sha512-zu9QWmjpzJcomzdJQAHgDVhLGq5bLosVak1KVa40NzQHXfqr4eAHupvnPOVXEoLkg6Ocefvf/93d//SB7du4YQ==", "license": "MIT", "dependencies": { - "chevrotain": "~11.0.3", - "chevrotain-allstar": "~0.3.0", + "chevrotain": "~11.1.1", + "chevrotain-allstar": "~0.3.1", "vscode-languageserver": "~9.0.1", "vscode-languageserver-textdocument": "~1.0.11", - "vscode-uri": "~3.0.8" + "vscode-uri": "~3.1.0" }, "engines": { - "node": ">=16.0.0" + "node": ">=20.10.0", + "npm": ">=10.2.3" } }, + "node_modules/langium/node_modules/@chevrotain/cst-dts-gen": { + "version": "11.1.2", + "resolved": "https://registry.npmjs.org/@chevrotain/cst-dts-gen/-/cst-dts-gen-11.1.2.tgz", + "integrity": "sha512-XTsjvDVB5nDZBQB8o0o/0ozNelQtn2KrUVteIHSlPd2VAV2utEb6JzyCJaJ8tGxACR4RiBNWy5uYUHX2eji88Q==", + "license": "Apache-2.0", + "dependencies": { + "@chevrotain/gast": "11.1.2", + "@chevrotain/types": "11.1.2", + "lodash-es": "4.17.23" + } + }, + "node_modules/langium/node_modules/@chevrotain/gast": { + "version": "11.1.2", + "resolved": "https://registry.npmjs.org/@chevrotain/gast/-/gast-11.1.2.tgz", + "integrity": "sha512-Z9zfXR5jNZb1Hlsd/p+4XWeUFugrHirq36bKzPWDSIacV+GPSVXdk+ahVWZTwjhNwofAWg/sZg58fyucKSQx5g==", + "license": "Apache-2.0", + "dependencies": { + "@chevrotain/types": "11.1.2", + "lodash-es": "4.17.23" + } + }, + "node_modules/langium/node_modules/@chevrotain/regexp-to-ast": { + "version": "11.1.2", + "resolved": "https://registry.npmjs.org/@chevrotain/regexp-to-ast/-/regexp-to-ast-11.1.2.tgz", + "integrity": "sha512-nMU3Uj8naWer7xpZTYJdxbAs6RIv/dxYzkYU8GSwgUtcAAlzjcPfX1w+RKRcYG8POlzMeayOQ/znfwxEGo5ulw==", + "license": "Apache-2.0" + }, + "node_modules/langium/node_modules/@chevrotain/types": { + "version": "11.1.2", + "resolved": "https://registry.npmjs.org/@chevrotain/types/-/types-11.1.2.tgz", + "integrity": "sha512-U+HFai5+zmJCkK86QsaJtoITlboZHBqrVketcO2ROv865xfCMSFpELQoz1GkX5GzME8pTa+3kbKrZHQtI0gdbw==", + "license": "Apache-2.0" + }, + "node_modules/langium/node_modules/@chevrotain/utils": { + "version": "11.1.2", + "resolved": "https://registry.npmjs.org/@chevrotain/utils/-/utils-11.1.2.tgz", + "integrity": "sha512-4mudFAQ6H+MqBTfqLmU7G1ZwRzCLfJEooL/fsF6rCX5eePMbGhoy5n4g+G4vlh2muDcsCTJtL+uKbOzWxs5LHA==", + "license": "Apache-2.0" + }, + "node_modules/langium/node_modules/chevrotain": { + "version": "11.1.2", + "resolved": "https://registry.npmjs.org/chevrotain/-/chevrotain-11.1.2.tgz", + "integrity": "sha512-opLQzEVriiH1uUQ4Kctsd49bRoFDXGGSC4GUqj7pGyxM3RehRhvTlZJc1FL/Flew2p5uwxa1tUDWKzI4wNM8pg==", + "license": "Apache-2.0", + "dependencies": { + "@chevrotain/cst-dts-gen": "11.1.2", + "@chevrotain/gast": "11.1.2", + "@chevrotain/regexp-to-ast": "11.1.2", + "@chevrotain/types": "11.1.2", + "@chevrotain/utils": "11.1.2", + "lodash-es": "4.17.23" + } + }, + "node_modules/langium/node_modules/lodash-es": { + "version": "4.17.23", + "resolved": "https://registry.npmjs.org/lodash-es/-/lodash-es-4.17.23.tgz", + "integrity": "sha512-kVI48u3PZr38HdYz98UmfPnXl2DXrpdctLrFLCd3kOx1xUkOmpFPx7gCWWM5MPkL/fD8zb+Ph0QzjGFs4+hHWg==", + "license": "MIT" + }, "node_modules/latest-version": { "version": "7.0.0", "resolved": "https://registry.npmjs.org/latest-version/-/latest-version-7.0.0.tgz", @@ -13665,14 +13739,14 @@ } }, "node_modules/mermaid": { - "version": "11.12.2", - "resolved": "https://registry.npmjs.org/mermaid/-/mermaid-11.12.2.tgz", - "integrity": "sha512-n34QPDPEKmaeCG4WDMGy0OT6PSyxKCfy2pJgShP+Qow2KLrvWjclwbc3yXfSIf4BanqWEhQEpngWwNp/XhZt6w==", + "version": "11.12.3", + "resolved": "https://registry.npmjs.org/mermaid/-/mermaid-11.12.3.tgz", + "integrity": "sha512-wN5ZSgJQIC+CHJut9xaKWsknLxaFBwCPwPkGTSUYrTiHORWvpT8RxGk849HPnpUAQ+/9BPRqYb80jTpearrHzQ==", "license": "MIT", "dependencies": { "@braintree/sanitize-url": "^7.1.1", "@iconify/utils": "^3.0.1", - "@mermaid-js/parser": "^0.6.3", + "@mermaid-js/parser": "^1.0.0", "@types/d3": "^7.4.3", "cytoscape": "^3.29.3", "cytoscape-cose-bilkent": "^4.1.0", @@ -13684,7 +13758,7 @@ "dompurify": "^3.2.5", "katex": "^0.16.22", "khroma": "^2.1.0", - "lodash-es": "^4.17.21", + "lodash-es": "^4.17.23", "marked": "^16.2.1", "roughjs": "^4.6.6", "stylis": "^4.3.6", @@ -13692,6 +13766,12 @@ "uuid": "^11.1.0" } }, + "node_modules/mermaid/node_modules/lodash-es": { + "version": "4.17.23", + "resolved": "https://registry.npmjs.org/lodash-es/-/lodash-es-4.17.23.tgz", + "integrity": "sha512-kVI48u3PZr38HdYz98UmfPnXl2DXrpdctLrFLCd3kOx1xUkOmpFPx7gCWWM5MPkL/fD8zb+Ph0QzjGFs4+hHWg==", + "license": "MIT" + }, "node_modules/mermaid/node_modules/uuid": { "version": "11.1.0", "resolved": "https://registry.npmjs.org/uuid/-/uuid-11.1.0.tgz", @@ -15936,9 +16016,10 @@ "license": "ISC" }, "node_modules/minimatch": { - "version": "3.1.2", - "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-3.1.2.tgz", - "integrity": "sha512-J7p63hRiAjw1NDEww1W7i37+ByIrOWO5XQQAzZ3VOcL0PNybwpfmV/N05zFAzwQ9USyEcX6t3UO+K5aqBQOIHw==", + "version": "3.1.5", + "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-3.1.5.tgz", + "integrity": "sha512-VgjWUsnnT6n+NUk6eZq77zeFdpW2LWDzP6zFGrCbHXiYNul5Dzqk2HHQ5uFH2DNW5Xbp8+jVzaeNt94ssEEl4w==", + "license": "ISC", "dependencies": { "brace-expansion": "^1.1.7" }, @@ -18506,12 +18587,12 @@ } }, "node_modules/qs": { - "version": "6.13.0", - "resolved": "https://registry.npmjs.org/qs/-/qs-6.13.0.tgz", - "integrity": "sha512-+38qI9SOr8tfZ4QmJNplMUxqjbe7LKvvZgWdExBOmd+egZTtjLB67Gu0HRX3u/XOq7UU2Nx6nsjvS16Z9uwfpg==", + "version": "6.14.2", + "resolved": "https://registry.npmjs.org/qs/-/qs-6.14.2.tgz", + "integrity": "sha512-V/yCWTTF7VJ9hIh18Ugr2zhJMP01MY7c5kh4J870L7imm6/DIzBsNLTXzMwUA3yZ5b/KBqLx8Kp3uRvd7xSe3Q==", "license": "BSD-3-Clause", "dependencies": { - "side-channel": "^1.0.6" + "side-channel": "^1.1.0" }, "engines": { "node": ">=0.6" @@ -18569,15 +18650,15 @@ } }, "node_modules/raw-body": { - "version": "2.5.2", - "resolved": "https://registry.npmjs.org/raw-body/-/raw-body-2.5.2.tgz", - "integrity": "sha512-8zGqypfENjCIqGhgXToC8aB2r7YrBX+AQAfIPs/Mlk+BtPTztOvTS01NRW/3Eh60J+a48lt8qsCzirQ6loCVfA==", + "version": "2.5.3", + "resolved": "https://registry.npmjs.org/raw-body/-/raw-body-2.5.3.tgz", + "integrity": "sha512-s4VSOf6yN0rvbRZGxs8Om5CWj6seneMwK3oDb4lWDH0UPhWcxwOWw5+qk24bxq87szX1ydrwylIOp2uG1ojUpA==", "license": "MIT", "dependencies": { - "bytes": "3.1.2", - "http-errors": "2.0.0", - "iconv-lite": "0.4.24", - "unpipe": "1.0.0" + "bytes": "~3.1.2", + "http-errors": "~2.0.1", + "iconv-lite": "~0.4.24", + "unpipe": "~1.0.0" }, "engines": { "node": ">= 0.8" @@ -18592,6 +18673,35 @@ "node": ">= 0.8" } }, + "node_modules/raw-body/node_modules/http-errors": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/http-errors/-/http-errors-2.0.1.tgz", + "integrity": "sha512-4FbRdAX+bSdmo4AUFuS0WNiPz8NgFt+r8ThgNWmlrjQjt1Q7ZR9+zTlce2859x4KSXrwIsaeTqDoKQmtP8pLmQ==", + "license": "MIT", + "dependencies": { + "depd": "~2.0.0", + "inherits": "~2.0.4", + "setprototypeof": "~1.2.0", + "statuses": "~2.0.2", + "toidentifier": "~1.0.1" + }, + "engines": { + "node": ">= 0.8" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/express" + } + }, + "node_modules/raw-body/node_modules/statuses": { + "version": "2.0.2", + "resolved": "https://registry.npmjs.org/statuses/-/statuses-2.0.2.tgz", + "integrity": "sha512-DvEy55V3DB7uknRo+4iOGT5fP1slR8wQohVdknigZPMpMstaKJQWhwiYBACJE3Ul2pTnATihhBYnRhZQHGBiRw==", + "license": "MIT", + "engines": { + "node": ">= 0.8" + } + }, "node_modules/rc": { "version": "1.2.8", "resolved": "https://registry.npmjs.org/rc/-/rc-1.2.8.tgz", @@ -19687,15 +19797,15 @@ } }, "node_modules/serve-handler": { - "version": "6.1.6", - "resolved": "https://registry.npmjs.org/serve-handler/-/serve-handler-6.1.6.tgz", - "integrity": "sha512-x5RL9Y2p5+Sh3D38Fh9i/iQ5ZK+e4xuXRd/pGbM4D13tgo/MGwbttUk8emytcr1YYzBYs+apnUngBDFYfpjPuQ==", + "version": "6.1.7", + "resolved": "https://registry.npmjs.org/serve-handler/-/serve-handler-6.1.7.tgz", + "integrity": "sha512-CinAq1xWb0vR3twAv9evEU8cNWkXCb9kd5ePAHUKJBkOsUpR1wt/CvGdeca7vqumL1U5cSaeVQ6zZMxiJ3yWsg==", "license": "MIT", "dependencies": { "bytes": "3.0.0", "content-disposition": "0.5.2", "mime-types": "2.1.18", - "minimatch": "3.1.2", + "minimatch": "3.1.5", "path-is-inside": "1.0.2", "path-to-regexp": "3.3.0", "range-parser": "1.2.0" @@ -20545,15 +20655,14 @@ } }, "node_modules/terser-webpack-plugin": { - "version": "5.3.16", - "resolved": "https://registry.npmjs.org/terser-webpack-plugin/-/terser-webpack-plugin-5.3.16.tgz", - "integrity": "sha512-h9oBFCWrq78NyWWVcSwZarJkZ01c2AyGrzs1crmHZO3QUg9D61Wu4NPjBy69n7JqylFF5y+CsUZYmYEIZ3mR+Q==", + "version": "5.3.17", + "resolved": "https://registry.npmjs.org/terser-webpack-plugin/-/terser-webpack-plugin-5.3.17.tgz", + "integrity": "sha512-YR7PtUp6GMU91BgSJmlaX/rS2lGDbAF7D+Wtq7hRO+MiljNmodYvqslzCFiYVAgW+Qoaaia/QUIP4lGXufjdZw==", "license": "MIT", "dependencies": { "@jridgewell/trace-mapping": "^0.3.25", "jest-worker": "^27.4.5", "schema-utils": "^4.3.0", - "serialize-javascript": "^6.0.2", "terser": "^5.31.1" }, "engines": { @@ -21499,9 +21608,9 @@ "license": "MIT" }, "node_modules/vscode-uri": { - "version": "3.0.8", - "resolved": "https://registry.npmjs.org/vscode-uri/-/vscode-uri-3.0.8.tgz", - "integrity": "sha512-AyFQ0EVmsOZOlAnxoFOGOq1SQDWAB7C6aqMGS23svWAllfOaxbuFvcT8D1i8z3Gyn8fraVeZNNmN6e9bxxXkKw==", + "version": "3.1.0", + "resolved": "https://registry.npmjs.org/vscode-uri/-/vscode-uri-3.1.0.tgz", + "integrity": "sha512-/BpdSx+yCQGnCvecbyXdxHDkuk55/G3xwnC0GqY4gmQ3j+A+g8kzzgB4Nk/SINjqn6+waqw3EgbVF2QKExkRxQ==", "license": "MIT" }, "node_modules/watchpack": { From 1ecc1e733f074e4a0d7160c6b9aef970559f3398 Mon Sep 17 00:00:00 2001 From: BrigittaK307 Date: Fri, 6 Mar 2026 13:40:47 +0200 Subject: [PATCH 02/10] Adressed PR comments --- docs-js/overview.mdx | 30 +++++++++++++----------------- package-lock.json | 20 ++++++++++++++++++++ package.json | 1 + 3 files changed, 34 insertions(+), 17 deletions(-) diff --git a/docs-js/overview.mdx b/docs-js/overview.mdx index d3a58011290..2768f3f143f 100644 --- a/docs-js/overview.mdx +++ b/docs-js/overview.mdx @@ -51,6 +51,10 @@ The image below shows the relationship between the individual core libraries. ```mermaid +--- +config: + layout: elk +--- flowchart TB subgraph openapiClientsGroup["OpenAPI Clients"] openapiClients["OpenAPI clients"] @@ -61,23 +65,7 @@ flowchart TB odataV4Clients["OData v4 clients"] end - subgraph generators["Generators"] - openapiGen["openapi-generator"] - generator["generator"] - end - - subgraph core["Core Libraries"] - openapi["openapi"] - odataV4["odata-v4"] - odataV2["odata-v2"] - end - - subgraph foundation["Foundation"] - httpClient["http-client"] - connectivity["connectivity"] - end - - openapiGen -.-> |generates| openapiClients + openapiGenerator -.-> |generates| openapiClients generator -.-> |generates| odataV2Clients generator -.-> |generates| odataV4Clients @@ -90,6 +78,14 @@ flowchart TB openapiClients --> openapi odataV2Clients --> odataV2 odataV4Clients --> odataV4 + + click openapi "https://www.npmjs.com/package/@sap-cloud-sdk/openapi" "@sap-cloud-sdk/openapi" + click odataV4 "https://www.npmjs.com/package/@sap-cloud-sdk/odata-v4" "@sap-cloud-sdk/odata-v4" + click odataV2 "https://www.npmjs.com/package/@sap-cloud-sdk/odata-v2" "@sap-cloud-sdk/odata-v2" + click httpClient "https://www.npmjs.com/package/@sap-cloud-sdk/http-client" "@sap-cloud-sdk/http-client" + click connectivity "https://www.npmjs.com/package/@sap-cloud-sdk/connectivity" "@sap-cloud-sdk/connectivity" + click openapiGenerator "https://www.npmjs.com/package/@sap-cloud-sdk/openapi-generator" "@sap-cloud-sdk/openapi-generator" + click generator "https://www.npmjs.com/package/@sap-cloud-sdk/generator" "@sap-cloud-sdk/generator" ``` diff --git a/package-lock.json b/package-lock.json index 2d361694dcc..cc51c44cdb5 100644 --- a/package-lock.json +++ b/package-lock.json @@ -14,6 +14,7 @@ "@docusaurus/preset-classic": "^3.9.2", "@docusaurus/theme-common": "^3.2.1", "@docusaurus/theme-mermaid": "^3.9.2", + "@mermaid-js/layout-elk": "^0.1.7", "@tanstack/react-table": "^8.21.3", "buffer": "^6.0.3", "clsx": "^2.1.1", @@ -4640,6 +4641,19 @@ "react": ">=16" } }, + "node_modules/@mermaid-js/layout-elk": { + "version": "0.1.9", + "resolved": "https://registry.npmjs.org/@mermaid-js/layout-elk/-/layout-elk-0.1.9.tgz", + "integrity": "sha512-HuvaqFZBr6yT9PpWYockvKAZPJVd89yn/UjOYPxhzbZxlybL2v+2BjVCg7MVH6vRs1irUohb/s42HEdec1CCZw==", + "license": "MIT", + "dependencies": { + "d3": "^7.9.0", + "elkjs": "^0.9.3" + }, + "peerDependencies": { + "mermaid": "^11.0.2" + } + }, "node_modules/@mermaid-js/parser": { "version": "1.0.0", "resolved": "https://registry.npmjs.org/@mermaid-js/parser/-/parser-1.0.0.tgz", @@ -9374,6 +9388,12 @@ "integrity": "sha512-9tfDXhJ4RKFNerfjdCcZfufu49vg620741MNs26a9+bhLThdB+plgMeou98CAaHu/WATj2iHOOHTp1hWtABj2A==", "license": "ISC" }, + "node_modules/elkjs": { + "version": "0.9.3", + "resolved": "https://registry.npmjs.org/elkjs/-/elkjs-0.9.3.tgz", + "integrity": "sha512-f/ZeWvW/BCXbhGEf1Ujp29EASo/lk1FDnETgNKwJrsVvGZhUWCZyg3xLJjAsxfOmt8KjswHmI5EwCQcPMpOYhQ==", + "license": "EPL-2.0" + }, "node_modules/emoji-regex": { "version": "9.2.2", "resolved": "https://registry.npmjs.org/emoji-regex/-/emoji-regex-9.2.2.tgz", diff --git a/package.json b/package.json index 43bc06f7194..1138118b1da 100644 --- a/package.json +++ b/package.json @@ -18,6 +18,7 @@ }, "dependencies": { "@docusaurus/core": "^3.9.2", + "@mermaid-js/layout-elk": "^0.1.7", "@docusaurus/plugin-client-redirects": "^3.9.2", "@docusaurus/plugin-content-docs": "^3.9.2", "@docusaurus/preset-classic": "^3.9.2", From 545efd0f1eff041f853ca408ad79e5b52a7fd9b6 Mon Sep 17 00:00:00 2001 From: BrigittaK307 Date: Fri, 6 Mar 2026 17:02:52 +0200 Subject: [PATCH 03/10] Update package.json Co-authored-by: David Knaack --- package.json | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/package.json b/package.json index 1138118b1da..413f27a92d3 100644 --- a/package.json +++ b/package.json @@ -18,7 +18,7 @@ }, "dependencies": { "@docusaurus/core": "^3.9.2", - "@mermaid-js/layout-elk": "^0.1.7", + "@mermaid-js/layout-elk": "^0.2.0", "@docusaurus/plugin-client-redirects": "^3.9.2", "@docusaurus/plugin-content-docs": "^3.9.2", "@docusaurus/preset-classic": "^3.9.2", From 8158ce8a58b8f971542a0f6e627c89cddc188a73 Mon Sep 17 00:00:00 2001 From: BrigittaK307 Date: Fri, 6 Mar 2026 17:20:18 +0200 Subject: [PATCH 04/10] Solved dependency issue --- package-lock.json | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/package-lock.json b/package-lock.json index cc51c44cdb5..a96b801ce16 100644 --- a/package-lock.json +++ b/package-lock.json @@ -14,7 +14,7 @@ "@docusaurus/preset-classic": "^3.9.2", "@docusaurus/theme-common": "^3.2.1", "@docusaurus/theme-mermaid": "^3.9.2", - "@mermaid-js/layout-elk": "^0.1.7", + "@mermaid-js/layout-elk": "^0.2.0", "@tanstack/react-table": "^8.21.3", "buffer": "^6.0.3", "clsx": "^2.1.1", @@ -4642,9 +4642,9 @@ } }, "node_modules/@mermaid-js/layout-elk": { - "version": "0.1.9", - "resolved": "https://registry.npmjs.org/@mermaid-js/layout-elk/-/layout-elk-0.1.9.tgz", - "integrity": "sha512-HuvaqFZBr6yT9PpWYockvKAZPJVd89yn/UjOYPxhzbZxlybL2v+2BjVCg7MVH6vRs1irUohb/s42HEdec1CCZw==", + "version": "0.2.0", + "resolved": "https://registry.npmjs.org/@mermaid-js/layout-elk/-/layout-elk-0.2.0.tgz", + "integrity": "sha512-vjjYGnCCjYlIA/rR7M//eFi0rHM6dsMyN1JQKfckpt30DTC/esrw36hcrvA2FNPHaqh3Q/SyBWzddyaky8EtUQ==", "license": "MIT", "dependencies": { "d3": "^7.9.0", From 54a5847d3bb52721db244aaced25ba07b7b59c28 Mon Sep 17 00:00:00 2001 From: BrigittaK307 Date: Mon, 9 Mar 2026 10:53:52 +0200 Subject: [PATCH 05/10] Downgraded mermaid-js/layout-elk because of dependency issue --- package.json | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/package.json b/package.json index 413f27a92d3..1bec44b3281 100644 --- a/package.json +++ b/package.json @@ -18,7 +18,7 @@ }, "dependencies": { "@docusaurus/core": "^3.9.2", - "@mermaid-js/layout-elk": "^0.2.0", + "@mermaid-js/layout-elk": "^0.1.9", "@docusaurus/plugin-client-redirects": "^3.9.2", "@docusaurus/plugin-content-docs": "^3.9.2", "@docusaurus/preset-classic": "^3.9.2", From 671e18be88990191992854032c5598e1c98bd009 Mon Sep 17 00:00:00 2001 From: BrigittaK307 Date: Mon, 9 Mar 2026 10:58:06 +0200 Subject: [PATCH 06/10] Updated package-lock.json --- package-lock.json | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/package-lock.json b/package-lock.json index a96b801ce16..6f0eeda310a 100644 --- a/package-lock.json +++ b/package-lock.json @@ -14,7 +14,7 @@ "@docusaurus/preset-classic": "^3.9.2", "@docusaurus/theme-common": "^3.2.1", "@docusaurus/theme-mermaid": "^3.9.2", - "@mermaid-js/layout-elk": "^0.2.0", + "@mermaid-js/layout-elk": "^0.1.9", "@tanstack/react-table": "^8.21.3", "buffer": "^6.0.3", "clsx": "^2.1.1", @@ -4642,9 +4642,9 @@ } }, "node_modules/@mermaid-js/layout-elk": { - "version": "0.2.0", - "resolved": "https://registry.npmjs.org/@mermaid-js/layout-elk/-/layout-elk-0.2.0.tgz", - "integrity": "sha512-vjjYGnCCjYlIA/rR7M//eFi0rHM6dsMyN1JQKfckpt30DTC/esrw36hcrvA2FNPHaqh3Q/SyBWzddyaky8EtUQ==", + "version": "0.1.9", + "resolved": "https://registry.npmjs.org/@mermaid-js/layout-elk/-/layout-elk-0.1.9.tgz", + "integrity": "sha512-HuvaqFZBr6yT9PpWYockvKAZPJVd89yn/UjOYPxhzbZxlybL2v+2BjVCg7MVH6vRs1irUohb/s42HEdec1CCZw==", "license": "MIT", "dependencies": { "d3": "^7.9.0", From 84d4477e52a18af0ea7b6298c9fdc39909f97672 Mon Sep 17 00:00:00 2001 From: BrigittaK307 Date: Tue, 10 Mar 2026 15:53:22 +0200 Subject: [PATCH 07/10] Adressed PR comments --- docs-js/overview.mdx | 23 ++++++++++++----------- docusaurus.config.js | 3 +++ 2 files changed, 15 insertions(+), 11 deletions(-) diff --git a/docs-js/overview.mdx b/docs-js/overview.mdx index 2768f3f143f..f6ed0602ab1 100644 --- a/docs-js/overview.mdx +++ b/docs-js/overview.mdx @@ -65,19 +65,20 @@ flowchart TB odataV4Clients["OData v4 clients"] end - openapiGenerator -.-> |generates| openapiClients - generator -.-> |generates| odataV2Clients - generator -.-> |generates| odataV4Clients + openapiClients --- openapi + odataV2Clients --- odataV2 + odataV4Clients --- odataV4 + - openapi --> httpClient - odataV4 --> httpClient - odataV2 --> httpClient + openapi --- httpClient + odataV4 --- httpClient + odataV2 --- httpClient - httpClient --> connectivity + openapiGenerator -.-> |generates| openapiClients + odataGenerator -.-> |generates| odataV2Clients + odataGenerator -.-> |generates| odataV4Clients - openapiClients --> openapi - odataV2Clients --> odataV2 - odataV4Clients --> odataV4 + httpClient --- connectivity click openapi "https://www.npmjs.com/package/@sap-cloud-sdk/openapi" "@sap-cloud-sdk/openapi" click odataV4 "https://www.npmjs.com/package/@sap-cloud-sdk/odata-v4" "@sap-cloud-sdk/odata-v4" @@ -85,7 +86,7 @@ flowchart TB click httpClient "https://www.npmjs.com/package/@sap-cloud-sdk/http-client" "@sap-cloud-sdk/http-client" click connectivity "https://www.npmjs.com/package/@sap-cloud-sdk/connectivity" "@sap-cloud-sdk/connectivity" click openapiGenerator "https://www.npmjs.com/package/@sap-cloud-sdk/openapi-generator" "@sap-cloud-sdk/openapi-generator" - click generator "https://www.npmjs.com/package/@sap-cloud-sdk/generator" "@sap-cloud-sdk/generator" + click odataGenerator "https://www.npmjs.com/package/@sap-cloud-sdk/generator" "@sap-cloud-sdk/generator" ``` diff --git a/docusaurus.config.js b/docusaurus.config.js index 4662524c678..b76d12bce94 100644 --- a/docusaurus.config.js +++ b/docusaurus.config.js @@ -31,6 +31,9 @@ module.exports = { }, themes: ['@docusaurus/theme-mermaid'], themeConfig: { + mermaid: { + theme: { light: 'neutral', dark: 'dark' } + }, colorMode: { respectPrefersColorScheme: true, disableSwitch: true From eb90cb4e23bdf32df880ed8201e80e55887d573b Mon Sep 17 00:00:00 2001 From: BrigittaK307 Date: Tue, 10 Mar 2026 15:54:45 +0200 Subject: [PATCH 08/10] Renamed nodes --- docs-js/overview.mdx | 26 +++++++++++++------------- 1 file changed, 13 insertions(+), 13 deletions(-) diff --git a/docs-js/overview.mdx b/docs-js/overview.mdx index f6ed0602ab1..bdd102be244 100644 --- a/docs-js/overview.mdx +++ b/docs-js/overview.mdx @@ -61,32 +61,32 @@ flowchart TB end subgraph odataClientsGroup["OData Clients"] - odataV2Clients["OData v2 clients"] - odataV4Clients["OData v4 clients"] + odata-v2Clients["OData v2 clients"] + odata-v4Clients["OData v4 clients"] end openapiClients --- openapi - odataV2Clients --- odataV2 - odataV4Clients --- odataV4 + odata-v2Clients --- odata-v2 + odata-v4Clients --- odata-v4 openapi --- httpClient - odataV4 --- httpClient - odataV2 --- httpClient + odata-v4 --- httpClient + odata-v2 --- httpClient - openapiGenerator -.-> |generates| openapiClients - odataGenerator -.-> |generates| odataV2Clients - odataGenerator -.-> |generates| odataV4Clients + openapi-generator -.-> |generates| openapiClients + generator -.-> |generates| odata-v2Clients + generator -.-> |generates| odata-v4Clients httpClient --- connectivity click openapi "https://www.npmjs.com/package/@sap-cloud-sdk/openapi" "@sap-cloud-sdk/openapi" - click odataV4 "https://www.npmjs.com/package/@sap-cloud-sdk/odata-v4" "@sap-cloud-sdk/odata-v4" - click odataV2 "https://www.npmjs.com/package/@sap-cloud-sdk/odata-v2" "@sap-cloud-sdk/odata-v2" + click odata-v4 "https://www.npmjs.com/package/@sap-cloud-sdk/odata-v4" "@sap-cloud-sdk/odata-v4" + click odata-v2 "https://www.npmjs.com/package/@sap-cloud-sdk/odata-v2" "@sap-cloud-sdk/odata-v2" click httpClient "https://www.npmjs.com/package/@sap-cloud-sdk/http-client" "@sap-cloud-sdk/http-client" click connectivity "https://www.npmjs.com/package/@sap-cloud-sdk/connectivity" "@sap-cloud-sdk/connectivity" - click openapiGenerator "https://www.npmjs.com/package/@sap-cloud-sdk/openapi-generator" "@sap-cloud-sdk/openapi-generator" - click odataGenerator "https://www.npmjs.com/package/@sap-cloud-sdk/generator" "@sap-cloud-sdk/generator" + click openapi-generator "https://www.npmjs.com/package/@sap-cloud-sdk/openapi-generator" "@sap-cloud-sdk/openapi-generator" + click generator "https://www.npmjs.com/package/@sap-cloud-sdk/generator" "@sap-cloud-sdk/generator" ``` From 5334cebaf536bbafde219e5cf8646fbaf5a81187 Mon Sep 17 00:00:00 2001 From: BrigittaK307 Date: Thu, 12 Mar 2026 12:04:01 +0200 Subject: [PATCH 09/10] Added updated svgs instead of mermaid flowchart --- docs-js/overview.mdx | 47 +++++++---------------------------- static/img/packages_dark.svg | 2 +- static/img/packages_light.svg | 2 +- 3 files changed, 11 insertions(+), 40 deletions(-) diff --git a/docs-js/overview.mdx b/docs-js/overview.mdx index bdd102be244..3b4773edb1d 100644 --- a/docs-js/overview.mdx +++ b/docs-js/overview.mdx @@ -50,44 +50,15 @@ The image below shows the relationship between the individual core libraries. -```mermaid ---- -config: - layout: elk ---- -flowchart TB - subgraph openapiClientsGroup["OpenAPI Clients"] - openapiClients["OpenAPI clients"] - end - - subgraph odataClientsGroup["OData Clients"] - odata-v2Clients["OData v2 clients"] - odata-v4Clients["OData v4 clients"] - end - - openapiClients --- openapi - odata-v2Clients --- odata-v2 - odata-v4Clients --- odata-v4 - - - openapi --- httpClient - odata-v4 --- httpClient - odata-v2 --- httpClient - - openapi-generator -.-> |generates| openapiClients - generator -.-> |generates| odata-v2Clients - generator -.-> |generates| odata-v4Clients - - httpClient --- connectivity - - click openapi "https://www.npmjs.com/package/@sap-cloud-sdk/openapi" "@sap-cloud-sdk/openapi" - click odata-v4 "https://www.npmjs.com/package/@sap-cloud-sdk/odata-v4" "@sap-cloud-sdk/odata-v4" - click odata-v2 "https://www.npmjs.com/package/@sap-cloud-sdk/odata-v2" "@sap-cloud-sdk/odata-v2" - click httpClient "https://www.npmjs.com/package/@sap-cloud-sdk/http-client" "@sap-cloud-sdk/http-client" - click connectivity "https://www.npmjs.com/package/@sap-cloud-sdk/connectivity" "@sap-cloud-sdk/connectivity" - click openapi-generator "https://www.npmjs.com/package/@sap-cloud-sdk/openapi-generator" "@sap-cloud-sdk/openapi-generator" - click generator "https://www.npmjs.com/package/@sap-cloud-sdk/generator" "@sap-cloud-sdk/generator" -``` + diff --git a/static/img/packages_dark.svg b/static/img/packages_dark.svg index d7e0cbd0fd8..208a253db18 100644 --- a/static/img/packages_dark.svg +++ b/static/img/packages_dark.svg @@ -1 +1 @@ -http-clientodata-v2odata-v4openapigeneratoropenapi-generatorgeneratesgeneratesOpenAPIclientOpenAPIclientOpenAPIclientsOpenAPIclientOpenAPIclientOData v2 clientsOpenAPIclientOpenAPIclientOData v4 clientsconnectivitymail-client \ No newline at end of file +connectivityhttp-clientodata-v2odata-v4openapigeneratoropenapi-generatorgeneratesgeneratesOpenAPIclientOpenAPIclientOpenAPIclientsOpenAPIclientOpenAPIclientOData v2 clientsOpenAPIclientOpenAPIclientOData v4 clients \ No newline at end of file diff --git a/static/img/packages_light.svg b/static/img/packages_light.svg index 38acedeec46..00bfbfaa501 100644 --- a/static/img/packages_light.svg +++ b/static/img/packages_light.svg @@ -1 +1 @@ -http-clientodata-v2odata-v4openapigeneratoropenapi-generatorgeneratesgeneratesOpenAPIclientOpenAPIclientOpenAPIclientsOpenAPIclientOpenAPIclientOData v2 clientsOpenAPIclientOpenAPIclientOData v4 clientsconnectivitymail-client \ No newline at end of file +http-clientodata-v2odata-v4openapigeneratoropenapi-generatorgeneratesgeneratesOpenAPIclientOpenAPIclientOpenAPIclientsOpenAPIclientOpenAPIclientOData v2 clientsOpenAPIclientOpenAPIclientOData v4 clientsconnectivity \ No newline at end of file From aa505f5a80cacd85a0a19ba318b11866eeae8bb2 Mon Sep 17 00:00:00 2001 From: BrigittaK307 Date: Thu, 12 Mar 2026 12:24:26 +0200 Subject: [PATCH 10/10] Removed unused dependency --- package-lock.json | 1 - package.json | 1 - 2 files changed, 2 deletions(-) diff --git a/package-lock.json b/package-lock.json index 6f0eeda310a..410fb7cf874 100644 --- a/package-lock.json +++ b/package-lock.json @@ -14,7 +14,6 @@ "@docusaurus/preset-classic": "^3.9.2", "@docusaurus/theme-common": "^3.2.1", "@docusaurus/theme-mermaid": "^3.9.2", - "@mermaid-js/layout-elk": "^0.1.9", "@tanstack/react-table": "^8.21.3", "buffer": "^6.0.3", "clsx": "^2.1.1", diff --git a/package.json b/package.json index 1bec44b3281..43bc06f7194 100644 --- a/package.json +++ b/package.json @@ -18,7 +18,6 @@ }, "dependencies": { "@docusaurus/core": "^3.9.2", - "@mermaid-js/layout-elk": "^0.1.9", "@docusaurus/plugin-client-redirects": "^3.9.2", "@docusaurus/plugin-content-docs": "^3.9.2", "@docusaurus/preset-classic": "^3.9.2",