{"ref":"artifact:cap-js-cds-types","page":"/artifacts/cap-js-cds-types","json":"/artifacts/cap-js-cds-types.json","generated":"2026-10-26","drafted_with_ai":true,"entity":{"id":"cap-js-cds-types","name":"@cap-js/cds-types","artifact_type":"package","ecosystem":"cap","domain":"operations-and-runtime","origin_ring":"sap-official","description":{"one_line":"Type definitions for the CAP Node.js SDK.","short":"Type definitions for the CAP Node.js SDK"},"links":{"npm":"https://www.npmjs.com/package/@cap-js/cds-types","repo":"https://github.com/cap-js/cds-types"},"compat":{"runtimes":["node"]},"provenance":{"discovered_via":[{"source":"source:npm"},{"source":"source:github","channel":"cap-js"}],"first_seen":"2026-08-31"},"provides":[{"capability":"capability:typing","what_it_does":"The TypeScript declarations for the @sap/cds APIs, used by TypeScript files and by IntelliSense in JavaScript projects.","sources":[{"url":"https://cap.cloud.sap/docs/node.js/typescript","title":"Using TypeScript — capire","checked":"2026-09-27","quote":"The package @cap-js/cds-types contains all TypeScript declarations for @sap/cds APIs. These declarations are used automatically when you write TypeScript files, but also enable IntelliSense and type checking for standard JavaScript development in Visual Studio Code."}]}],"maintainers":["actor:cap-js"],"contributors":["actor:akatuoro","actor:aschmidt93","actor:chgeo","actor:danjoa","actor:daogrady","actor:etimr","actor:hakimio","actor:hm23","actor:joergmann","actor:johannes-vogel","actor:kkoile","actor:mariayord","actor:mschfer","actor:niklasvieth","actor:ogrady","actor:schiwekm","actor:schwma","actor:siarhei-murkou","actor:sjvans","actor:stockbal","actor:swaldmann","actor:theplenkov","actor:vkozyura"],"drafted_with_ai":true,"changed_in":[{"version":"0.9.0","date":"2025-01-13","what_changed":"The type `TypedRequest<T>` is removed and handlers type their request as `Request<T>`. The deprecated `cds.Float` CSN type is removed in the same release.","invalidates":"Handler signatures typed with `TypedRequest<T>`.","source":{"url":"https://github.com/cap-js/cds-types/blob/main/CHANGELOG.md#090---25-01-13","title":"cap-js/cds-types changelog, 0.9.0","checked":"2026-10-19","quote":"[breaking] Removed type `TypedRequest<T>` and replaced it with just `Request<T>`"}},{"version":"0.12.0","date":"2025-06-05","what_changed":"The package's dependency on [@sap/cds](artifact:sap-cds) moves to 9.0.0 or later, so from this release the types are meant for cds 9.","invalidates":"Pairing the newest cds-types with a project on cds 8 or earlier.","source":{"url":"https://github.com/cap-js/cds-types/blob/main/CHANGELOG.md#0120---2025-06-05","title":"cap-js/cds-types changelog, 0.12.0","checked":"2026-10-19","quote":"Bump dependency to `@sap/cds` to `>=9.0.0`. This means starting with this version, `cds-types` is supposed to be used alongside `@sap/cds@9`!"}},{"version":"0.18.0","date":"2026-06-22","what_changed":"Installing the package no longer runs a postinstall script that links it into `node_modules/@types`; a project points TypeScript at it with a `paths` entry in tsconfig.json, which `cds add typescript` creates.","invalidates":"Setup notes that rely on `@types/sap__cds` appearing after `npm install`.","source":{"url":"https://github.com/cap-js/cds-types/blob/main/CHANGELOG.md#0180---2026-06-22","title":"cap-js/cds-types changelog, 0.18.0","checked":"2026-10-19","quote":"Installing `@cap-js/cds-types` no longer executes a postinstall script that creates a symlink in `node_modules/@types`."}}]},"effective_normative_relations":[],"readings":{"liveness":[{"label":"Maintenance","tier":"good","evidence":"1 month since release"},{"label":"Continuity","tier":"good","evidence":"27 contributors, 3 publishers, org-owned"},{"label":"Repository","tier":"good","evidence":"pushed 2026-10, not archived"}],"compatibility":[{"label":"Declared for","tier":"good","evidence":">=9.0.0 — includes cds 10 and 9"},{"label":"Survived majors","tier":"good","evidence":"released before and after @sap/cds 10"},{"label":"Maintainer's CI","tier":"good","evidence":"Linting green, 2026-09-23"}],"practice":[{"label":"Tests","tier":"good","evidence":"27 test files, npm test"},{"label":"Docs","tier":"fair","evidence":"README 3 KB"},{"label":"Changelog","tier":"good","evidence":"CHANGELOG in the repo"}],"reach":[{"value":28245,"unit":"installs/week"},{"value":20,"unit":"watching"}]},"signals":{"crawled_at":"2026-10-24","latest_version":"0.20.0","majors":{"0.0":{"version":"0.0.1","date":"2023-12-06"},"0.1":{"version":"0.1.0","date":"2023-12-13"},"0.2":{"version":"0.2.0","date":"2024-01-17"},"0.4":{"version":"0.4.0","date":"2024-05-29"},"0.5":{"version":"0.5.0","date":"2024-06-20"},"0.6":{"version":"0.6.0","date":"2024-07-05"},"0.7":{"version":"0.7.0","date":"2024-10-24"},"0.8":{"version":"0.8.0","date":"2024-11-26"},"0.9":{"version":"0.9.0","date":"2025-01-14"},"0.10":{"version":"0.10.0","date":"2025-04-02"},"0.11":{"version":"0.11.0","date":"2025-06-05"},"0.12":{"version":"0.12.0","date":"2025-06-24"},"0.13":{"version":"0.13.0","date":"2025-07-04"},"0.14":{"version":"0.14.0","date":"2025-08-28"},"0.15":{"version":"0.15.0","date":"2025-09-26"},"0.16":{"version":"0.16.0","date":"2026-02-09"},"0.17":{"version":"0.17.0","date":"2026-05-11"},"0.18":{"version":"0.18.0","date":"2026-06-22"},"0.19":{"version":"0.19.0","date":"2026-08-24"},"0.20":{"version":"0.20.0","date":"2026-09-23"}},"license":"Apache-2.0","first_release":"2023-12-06","last_release":"2026-09-23","releases":26,"cadence_days":42,"maintainers":3,"repository":"git+https://github.com/cap-js/cds-types.git","peer_cds":">=9.0.0","test_script":true,"types":true,"downloads_weekly":28245,"stars":20,"forks":19,"open_issues":15,"archived":false,"pushed_at":"2026-10-22","license_spdx":"Apache-2.0","org_owned":true,"default_branch":"main","contributors":27,"tree_truncated":false,"test_files":27,"workflows":7,"other_ci":false,"readme_bytes":3387,"docs_files":0,"changelog":true,"license_file":true,"dts_files":22,"ci_status":"success","ci_run_at":"2026-09-23","ci_workflow":"Linting","ci_event":"push","readme_path":"README.md","readme_sha":"66614482e5f05104d5dd90c0570799935c9d9ebd","months_since_release":1,"dormant":false,"repository_directory":null,"dependencies":0,"node_engine":null,"downloads_monthly":162191,"created_at":"2023-09-14T13:35:44Z","open_prs":7,"first_commit":"2023-09-14","last_commit":"2026-09-23","commits":388,"repo_read":"2026-10-24"},"release_notes":{"license":"Apache-2.0","quotable":true,"prereleases":1,"source":{"kind":"repo","path":"CHANGELOG.md","ref":"main","url":"https://github.com/cap-js/cds-types/blob/main/CHANGELOG.md"},"format":"keep-a-changelog","releases":[{"version":"0.20.0","date":"2026-09-23","date_source":"heading","heading":"[0.20.0] - 2026-09-23","url":"https://github.com/cap-js/cds-types/blob/main/CHANGELOG.md#0200---2026-09-23","sections":[{"kind":"feature","heading":"Added","items":2},{"kind":"change","heading":"Changed","items":0},{"kind":"deprecation","heading":"Deprecated","items":0},{"kind":"removal","heading":"Removed","items":0},{"kind":"fix","heading":"Fixed","items":0},{"kind":"security","heading":"Security","items":0}],"hash":"c1ee0eb0cccaf964"},{"version":"0.19.0","date":"2026-08-24","date_source":"heading","heading":"[0.19.0] - 2026-08-24","url":"https://github.com/cap-js/cds-types/blob/main/CHANGELOG.md#0190---2026-08-24","sections":[{"kind":"feature","heading":"Added","items":6},{"kind":"change","heading":"Changed","items":2},{"kind":"deprecation","heading":"Deprecated","items":0},{"kind":"removal","heading":"Removed","items":0},{"kind":"fix","heading":"Fixed","items":1},{"kind":"security","heading":"Security","items":0}],"hash":"6397a7282e5acd0f"},{"version":"0.18.0","date":"2026-06-22","date_source":"heading","heading":"[0.18.0] - 2026-06-22","url":"https://github.com/cap-js/cds-types/blob/main/CHANGELOG.md#0180---2026-06-22","sections":[{"kind":"feature","heading":"Added","items":0},{"kind":"change","heading":"Changed","items":1},{"kind":"deprecation","heading":"Deprecated","items":0},{"kind":"removal","heading":"Removed","items":0},{"kind":"fix","heading":"Fixed","items":0},{"kind":"security","heading":"Security","items":0}],"hash":"5ba4fac1c0a67fbe","cited_by":[{"version":"0.18.0","date":"2026-06-22"}]},{"version":"0.17.0","date":"2026-05-11","date_source":"heading","heading":"[0.17.0] - 2026-05-11","url":"https://github.com/cap-js/cds-types/blob/main/CHANGELOG.md#0170---2026-05-11","sections":[{"kind":"feature","heading":"Added","items":3},{"kind":"change","heading":"Changed","items":4},{"kind":"deprecation","heading":"Deprecated","items":2},{"kind":"removal","heading":"Removed","items":0},{"kind":"fix","heading":"Fixed","items":0},{"kind":"security","heading":"Security","items":0}],"hash":"81448092466d3078"},{"version":"0.16.0","date":"2026-02-09","date_source":"heading","heading":"[0.16.0] - 2026-02-09","url":"https://github.com/cap-js/cds-types/blob/main/CHANGELOG.md#0160---2026-02-09","sections":[{"kind":"feature","heading":"Added","items":3},{"kind":"change","heading":"Changed","items":0},{"kind":"deprecation","heading":"Deprecated","items":2},{"kind":"removal","heading":"Removed","items":0},{"kind":"fix","heading":"Fixed","items":3},{"kind":"security","heading":"Security","items":0}],"hash":"f212737250c66c97"},{"version":"0.15.0","date":"2025-09-26","date_source":"heading","heading":"[0.15.0] - 2025-09-26","url":"https://github.com/cap-js/cds-types/blob/main/CHANGELOG.md#0150---2025-09-26","sections":[{"kind":"feature","heading":"Added","items":3},{"kind":"change","heading":"Changed","items":0},{"kind":"deprecation","heading":"Deprecated","items":0},{"kind":"removal","heading":"Removed","items":0},{"kind":"fix","heading":"Fixed","items":0},{"kind":"security","heading":"Security","items":0}],"hash":"0e3c82043a6f3538"},{"version":"0.14.0","date":"2025-08-28","date_source":"heading","heading":"[0.14.0] - 2025-08-28","url":"https://github.com/cap-js/cds-types/blob/main/CHANGELOG.md#0140---2025-08-28","sections":[{"kind":"feature","heading":"Added","items":3},{"kind":"change","heading":"Changed","items":2},{"kind":"deprecation","heading":"Deprecated","items":0},{"kind":"removal","heading":"Removed","items":0},{"kind":"fix","heading":"Fixed","items":1},{"kind":"security","heading":"Security","items":0}],"hash":"2925d8015d60415f"},{"version":"0.13.0","date":"2025-07-04","date_source":"heading","heading":"[0.13.0] - 2025-07-04","url":"https://github.com/cap-js/cds-types/blob/main/CHANGELOG.md#0130---2025-07-04","sections":[{"kind":"feature","heading":"Added","items":1},{"kind":"change","heading":"Changed","items":0},{"kind":"deprecation","heading":"Deprecated","items":0},{"kind":"removal","heading":"Removed","items":0},{"kind":"fix","heading":"Fixed","items":1},{"kind":"security","heading":"Security","items":0}],"hash":"706310bdb5709341"},{"version":"0.12.0","date":"2025-06-05","date_source":"heading","heading":"[0.12.0] - 2025-06-05","url":"https://github.com/cap-js/cds-types/blob/main/CHANGELOG.md#0120---2025-06-05","sections":[{"kind":"feature","heading":"Added","items":2},{"kind":"change","heading":"Changed","items":2},{"kind":"deprecation","heading":"Deprecated","items":0},{"kind":"removal","heading":"Removed","items":0},{"kind":"fix","heading":"Fixed","items":0},{"kind":"security","heading":"Security","items":0}],"hash":"3cad48316e12ec1a","cited_by":[{"version":"0.12.0","date":"2025-06-05"}]},{"version":"0.11.0","date":"2025-06-05","date_source":"heading","heading":"[0.11.0] - 2025-06-05","url":"https://github.com/cap-js/cds-types/blob/main/CHANGELOG.md#0110---2025-06-05","sections":[{"kind":"feature","heading":"Added","items":6},{"kind":"change","heading":"Changed","items":3},{"kind":"deprecation","heading":"Deprecated","items":0},{"kind":"removal","heading":"Removed","items":1},{"kind":"fix","heading":"Fixed","items":0},{"kind":"security","heading":"Security","items":0}],"hash":"4d8794eb21b14932"},{"version":"0.10.0","date":"2025-04-01","date_source":"heading","heading":"[0.10.0] - 2025-04-01","url":"https://github.com/cap-js/cds-types/blob/main/CHANGELOG.md#0100---2025-04-01","sections":[{"kind":"feature","heading":"Added","items":4},{"kind":"change","heading":"Changed","items":1},{"kind":"deprecation","heading":"Deprecated","items":0},{"kind":"removal","heading":"Removed","items":0},{"kind":"fix","heading":"Fixed","items":0},{"kind":"security","heading":"Security","items":0}],"hash":"8926f336f7f95041"},{"version":"0.9.0","date":"2025-01-14","date_source":"registry","heading":"[0.9.0] - 25-01-13","url":"https://github.com/cap-js/cds-types/blob/main/CHANGELOG.md#090---25-01-13","sections":[{"kind":"feature","heading":"Added","items":4},{"kind":"change","heading":"Changed","items":1},{"kind":"removal","heading":"Removed","items":2},{"kind":"fix","heading":"Fixed","items":5}],"hash":"d9c4c1f7690d0775","cited_by":[{"version":"0.9.0","date":"2025-01-13"}]},{"version":"0.8.0","date":"2024-11-26","date_source":"registry","heading":"[0.8.0] - 24-11-26","url":"https://github.com/cap-js/cds-types/blob/main/CHANGELOG.md#080---24-11-26","sections":[{"kind":"fix","heading":"Fixed","items":6}],"hash":"203b8806947816c7"},{"version":"0.7.0","date":"2024-10-24","date_source":"registry","heading":"[0.7.0] - 24-10-24","url":"https://github.com/cap-js/cds-types/blob/main/CHANGELOG.md#070---24-10-24","sections":[{"kind":"fix","heading":"Fixed","items":4},{"kind":"feature","heading":"Added","items":7},{"kind":"change","heading":"Changed","items":3}],"hash":"64f7dbf10e2f2319"},{"version":"0.6.5","date":"2024-08-13","date_source":"heading","heading":"[0.6.5] - 2024-08-13","url":"https://github.com/cap-js/cds-types/blob/main/CHANGELOG.md#065---2024-08-13","sections":[{"kind":"fix","heading":"Fixed","items":1},{"kind":"removal","heading":"Removed","items":1}],"hash":"f5a3452dded03097"},{"version":"0.6.4","date":"2024-08-05","date_source":"heading","heading":"[0.6.4] - 2024-08-05","url":"https://github.com/cap-js/cds-types/blob/main/CHANGELOG.md#064---2024-08-05","sections":[{"kind":"feature","heading":"Added","items":4},{"kind":"change","heading":"Changed","items":1},{"kind":"fix","heading":"Fixed","items":1}],"hash":"8ca87a10205fcb61"},{"version":"0.6.3","date":"2024-07-19","date_source":"heading","heading":"[0.6.3] - 2024-07-19","url":"https://github.com/cap-js/cds-types/blob/main/CHANGELOG.md#063---2024-07-19","sections":[{"kind":"fix","heading":"Fixed","items":1}],"hash":"8c91b1dafeb5cd28"},{"version":"0.6.2","date":"2024-07-18","date_source":"heading","heading":"[0.6.2] - 2024-07-18","url":"https://github.com/cap-js/cds-types/blob/main/CHANGELOG.md#062---2024-07-18","sections":[{"kind":"fix","heading":"Fixed","items":1}],"hash":"4376892305ee004e"},{"version":"0.6.1","date":"2024-07-18","date_source":"heading","heading":"[0.6.1] - 2024-07-18","url":"https://github.com/cap-js/cds-types/blob/main/CHANGELOG.md#061---2024-07-18","sections":[{"kind":"fix","heading":"Fixed","items":1},{"kind":"change","heading":"Changed","items":1}],"hash":"8accafdd44ec8044"},{"version":"0.6.0","date":"2024-07-05","date_source":"heading","heading":"[0.6.0] - 2024-07-05","url":"https://github.com/cap-js/cds-types/blob/main/CHANGELOG.md#060---2024-07-05","sections":[{"kind":"change","heading":"Changed","items":2}],"hash":"0224b9d2184179fc"},{"version":"0.5.0","date":"2024-06-20","date_source":"heading","heading":"[0.5.0] - 2024-06-20","url":"https://github.com/cap-js/cds-types/blob/main/CHANGELOG.md#050---2024-06-20","sections":[{"kind":"fix","heading":"Fixed","items":1}],"hash":"ad1907defa103e60"},{"version":"0.4.0","date":"2024-05-23","date_source":"heading","heading":"[0.4.0] - 2024-05-23","url":"https://github.com/cap-js/cds-types/blob/main/CHANGELOG.md#040---2024-05-23","sections":[{"kind":"fix","heading":"Fixed","items":1}],"hash":"72440804db543baf"},{"version":"0.3.0-beta.1","date":"2024-05-23","date_source":"heading","heading":"[0.3.0-beta.1] - 2024-05-23","url":"https://github.com/cap-js/cds-types/blob/main/CHANGELOG.md#030-beta1---2024-05-23","sections":[{"kind":"feature","heading":"Added","items":4},{"kind":"change","heading":"Changed","items":6},{"kind":"fix","heading":"Fixed","items":3}],"hash":"61e61c974aeab730"},{"version":"0.2.0","date":"2024-01-17","date_source":"heading","heading":"[0.2.0] - 2024-01-17","url":"https://github.com/cap-js/cds-types/blob/main/CHANGELOG.md#020---2024-01-17","sections":[{"kind":"feature","heading":"Added","items":1},{"kind":"change","heading":"Changed","items":1},{"kind":"fix","heading":"Fixed","items":6}],"hash":"2934e2e277589378"},{"version":"0.1.0","date":"2023-12-13","date_source":"heading","heading":"[0.1.0] - 2023-12-13","url":"https://github.com/cap-js/cds-types/blob/main/CHANGELOG.md#010---2023-12-13","sections":[{"kind":"change","heading":"Changed","items":1},{"kind":"fix","heading":"Fixed","items":1}],"hash":"f122577092d5da84"},{"version":"0.0.1","date":"2023-12-06","date_source":"heading","heading":"[0.0.1] - 2023-12-06","url":"https://github.com/cap-js/cds-types/blob/main/CHANGELOG.md#001---2023-12-06","sections":[{"kind":"feature","heading":"Added","items":1}],"hash":"dc1afc5ef3d7af8d"}],"versions":[{"version":"0.20.0","date":"2026-09-23"},{"version":"0.19.0","date":"2026-08-24"},{"version":"0.18.0","date":"2026-06-22"},{"version":"0.17.0","date":"2026-05-11"},{"version":"0.16.0","date":"2026-02-09"},{"version":"0.15.0","date":"2025-09-26"},{"version":"0.14.0","date":"2025-08-28"},{"version":"0.13.0","date":"2025-07-04"},{"version":"0.12.0","date":"2025-06-24"},{"version":"0.11.0","date":"2025-06-05"},{"version":"0.10.0","date":"2025-04-02"},{"version":"0.9.0","date":"2025-01-14"},{"version":"0.8.0","date":"2024-11-26"},{"version":"0.7.0","date":"2024-10-24"},{"version":"0.6.5","date":"2024-08-13"},{"version":"0.6.4","date":"2024-08-05"},{"version":"0.6.3","date":"2024-07-19"},{"version":"0.6.2","date":"2024-07-18"},{"version":"0.6.1","date":"2024-07-18"},{"version":"0.6.0","date":"2024-07-05"},{"version":"0.5.0","date":"2024-06-20"},{"version":"0.4.0","date":"2024-05-29"},{"version":"0.2.0","date":"2024-01-17"},{"version":"0.1.0","date":"2023-12-13"},{"version":"0.0.1","date":"2023-12-06"}],"crawled_at":"2026-10-25"},"edges":{"maintainers":[{"ref":"actor:cap-js","name":"SAP Cloud Application Programming Model","json":"/actors/cap-js.json"}],"contributors":[{"ref":"actor:aschmidt93","name":"Andreas Schmidt","json":"/actors/aschmidt93.json"},{"ref":"actor:chgeo","name":"Christian Georgi","json":"/actors/chgeo.json"},{"ref":"actor:danjoa","name":"Daniel Hutzel","json":"/actors/danjoa.json"},{"ref":"actor:daogrady","name":"Daniel O'Grady","json":"/actors/daogrady.json"},{"ref":"actor:ogrady","name":"Daniel O'Grady","json":"/actors/ogrady.json"},{"ref":"actor:hm23","name":"Heiko Witteborg","json":"/actors/hm23.json"},{"ref":"actor:johannes-vogel","name":"Johannes Vogel","json":"/actors/johannes-vogel.json"},{"ref":"actor:akatuoro","name":"Johannes Vogt","json":"/actors/akatuoro.json"},{"ref":"actor:joergmann","name":"Jörg Mann","json":"/actors/joergmann.json"},{"ref":"actor:stockbal","name":"Ludwig Stockbauer-Muhr","json":"/actors/stockbal.json"},{"ref":"actor:schwma","name":"Marcel Schwarz","json":"/actors/schwma.json"},{"ref":"actor:mariayord","name":"mariayord","json":"/actors/mariayord.json"},{"ref":"actor:schiwekm","name":"Marten Schiwek","json":"/actors/schiwekm.json"},{"ref":"actor:mschfer","name":"Mirko Günther","json":"/actors/mschfer.json"},{"ref":"actor:niklasvieth","name":"Niklas","json":"/actors/niklasvieth.json"},{"ref":"actor:kkoile","name":"Nils Hirsekorn","json":"/actors/kkoile.json"},{"ref":"actor:etimr","name":"Olena","json":"/actors/etimr.json"},{"ref":"actor:theplenkov","name":"Petr Plenkov","json":"/actors/theplenkov.json"},{"ref":"actor:siarhei-murkou","name":"Siarhei Murkou","json":"/actors/siarhei-murkou.json"},{"ref":"actor:sjvans","name":"sjvans","json":"/actors/sjvans.json"},{"ref":"actor:swaldmann","name":"Steffen Waldmann","json":"/actors/swaldmann.json"},{"ref":"actor:hakimio","name":"Tomas Rimkus","json":"/actors/hakimio.json"},{"ref":"actor:vkozyura","name":"Vitaly Kozyura","json":"/actors/vkozyura.json"}],"explained_by":[],"alternative_to_this":[],"needed_by":[],"available_via":[],"parts":[],"add_ons":[],"answered_through_parts":[]}}