{"ref":"artifact:sap-ams-dev","page":"/artifacts/sap-ams-dev","json":"/artifacts/sap-ams-dev.json","generated":"2026-10-26","drafted_with_ai":true,"entity":{"id":"sap-ams-dev","name":"@sap/ams-dev","artifact_type":"build-tool","ecosystem":"cap","domain":"developer-experience","secondary_domains":["security-and-compliance"],"origin_ring":"sap-official","description":{"one_line":"Compiles the DCL authorization policies of SAP's Authorization Management Service to DCN, so an AMS-secured application runs and is tested on a laptop.","short":"Compiler from AMS DCL policies to DCN for local runs and tests","what_it_solves":"Policies for AMS are written in DCL and the runtime reads DCN, so nothing local can evaluate one until it is compiled. This is the compiler: a `compile-dcl` bin takes a DCL source root and a DCN output root, runs entirely in Node.js through WebAssembly with no Java installed, and can be told to fail on a warning or a deprecation rather than only on an error. In a CAP project it reacts to DCL changes, compiling them under mocked authentication and, under `ias` authentication, pushing the policies to the AMS server from the SAP Identity service binding. A test then runs against the local bundle with policy assignments mocked per tenant and user in JSON, which is what its own `pretest` and `posttest` example wires up.","when_not_to_use":"Its own account of itself is local running and tests: the DCN it writes serves as input for running an application using AMS on the DCL bundle locally. It carries the SAP Developer License Agreement rather than an open-source licence, and the repository named in its package metadata is an internal SAP host, so the npm page is the only thing to read."},"links":{"npm":"https://www.npmjs.com/package/@sap/ams-dev"},"identity":{"license":"SAP DEVELOPER LICENSE AGREEMENT"},"source_available":false,"framework_contexts":[{"framework":"cap","role":"plugin","source":{"url":"https://www.npmjs.com/package/@sap/ams-dev","title":"@sap/ams-dev — npm, CAP integration","checked":"2026-09-18","quote":"For CAP (Cloud Application Programming Model) applications, the plugin integrates nicely into mocked auth and hybrid environments which allows developing local applications with AMS bound to SAP Identity service instances on SAP BTP."}}],"compat":{"runtimes":["node"]},"type_properties":{"distribution":{"value":["npm"],"sources":[{"url":"https://www.npmjs.com/package/@sap/ams-dev","title":"@sap/ams-dev — README","checked":"2026-10-18","quote":"\"pretest\": \"npx --package=@sap/ams-dev compile-dcl -d test/dcl -o $npm_package_config_dcn_root\","}]}},"provides":[{"capability":"capability:local-development","what_it_does":"Makes an AMS-secured service runnable and testable without a deployment: DCL compiled to DCN before the run, recompiled when a DCL file changes under mocked authentication, and policy assignments mocked per tenant and user from a JSON file.","sources":[{"url":"https://www.npmjs.com/package/@sap/ams-dev","title":"@sap/ams-dev — npm","checked":"2026-09-18","quote":"The primary functionality provided by this module is enabling tests on local DCL (Data Control Language) bundles."},{"url":"https://www.npmjs.com/package/@sap/ams-dev","title":"@sap/ams-dev — npm, DCL compilation","checked":"2026-09-18","quote":"This module provides a bin script called compile-dcl which compiles .dcl files to .dcn files which serve as input for running an application using AMS on the DCL bundle locally, e.g. for unit tests."}]},{"capability":"capability:authorization","what_it_does":"The development-time half of an AMS authorization model: it compiles the DCL policies the decision controller evaluates, and under ias authentication pushes them to the AMS server from the SAP Identity service binding.","sources":[{"url":"https://www.npmjs.com/package/@sap/ams-dev","title":"@sap/ams-dev — npm, CAP integration","checked":"2026-09-18","quote":"When using ias auth, it provides a feature to push the policies to the AMS server from the SAP Identity service binding."},{"url":"https://www.npmjs.com/package/@sap/ams-dev","title":"@sap/ams-dev — npm","checked":"2026-09-18","quote":"This module provides tooling support for extending applications which authenticate users via the SAP Cloud Identity Services with AMS (Authorization Management Service) authorization checks."}]}],"maintainers":["actor:sap"],"provenance":{"discovered_via":[{"source":"source:discover"},{"source":"source:npm"}],"first_seen":"2026-09-18"},"drafted_with_ai":true},"effective_normative_relations":[{"instrument":"instrument:sap-developer-license-3-2-cap","relation":"use-constrained-by","sections":["1","2","3"],"applies_when":"A cds-plugin is used with SAP CAP materials, or an artifact is explicitly identified as a CAP plugin or application.","note":"This is inherited applicability, not a licence verdict about the artifact itself. Review the agreement for the actual materials and use; an explicit artifact relationship to another revision takes precedence.","scope":{"kind":"artifact"},"sources":[{"url":"https://cap.cloud.sap/resources/license/developer-license-3_2_CAP.txt","title":"SAP Developer License Agreement 3.2 CAP","checked":"2026-09-16","quote":"documentation, plug-ins, templates, scripts and sample code, libraries, software development kits"}],"inherited_from":"cap-plugins-and-applications","relevant_capabilities":["agent-systems-access","async-processing","data-import-export","database-connectors","deployment","destinations","llm-integration","mcp-servers","plugin-authoring","replication","retrieval-augmented-generation","rfc-connectivity"]}],"readings":{"liveness":[{"label":"Maintenance","tier":"good","evidence":"3 months since release"},{"label":"Continuity","tier":"fair","evidence":"1 publisher on npm"},{"label":"Repository","tier":"unknown","evidence":"no repository data"}],"compatibility":[{"label":"Declared for","tier":"good","evidence":">=8 — includes cds 10 and 9"},{"label":"Survived majors","tier":"good","evidence":"released before and after @sap/cds 10"},{"label":"Maintainer's CI","tier":"unknown","evidence":"no repository data"}],"practice":[{"label":"Tests","tier":"unknown","evidence":"npm test script, tree not read"},{"label":"Docs","tier":"good","evidence":"README 7 KB"},{"label":"Changelog","tier":"fair","evidence":"none in the repo"}],"reach":[{"value":1755,"unit":"installs/week"},{"value":null,"unit":"watching"}]},"signals":{"crawled_at":"2026-10-26","latest_version":"3.0.2","majors":{"1":{"version":"1.0.0","date":"2024-08-08"},"2":{"version":"2.0.0","date":"2024-12-13"},"3":{"version":"3.0.2","date":"2026-07-21"},"0.7":{"version":"0.7.1","date":"2023-09-21"},"0.8":{"version":"0.8.0","date":"2023-12-21"},"0.9":{"version":"0.9.0","date":"2024-06-05"},"0.10":{"version":"0.10.0","date":"2024-06-24"}},"license":"SAP DEVELOPER LICENSE AGREEMENT","first_release":"2023-09-21","last_release":"2026-07-21","releases":26,"cadence_days":38,"maintainers":1,"repository":"git@github.wdf.sap.corp:CPSecurity/cloud-authorization-nodejs-development.git","repository_directory":null,"peer_cds":">=8","dependencies":1,"node_engine":null,"test_script":true,"types":false,"downloads_weekly":1755,"downloads_monthly":9309,"npm_document_version":"3.0.2","npm_document_integrity":"sha512-J+b2MCnBW77WAlGcJtGYbKD9CKG6WtI79fUrB/AwnO+Nl/ata7K4Ehl26M3RBS4jaENkB5FNL2x0xCDTDo/D8g==","npm_document_tarball":"https://registry.npmjs.org/@sap/ams-dev/-/ams-dev-3.0.2.tgz","readme_path":"README.md","readme_bytes":6910,"readme_source":"npm","changelog":false,"license_file":true,"license_path":"LICENSE","license_name":"SAP DEVELOPER LICENSE AGREEMENT 3.2","months_since_release":3,"dormant":false},"release_notes":{"license":"SAP DEVELOPER LICENSE AGREEMENT 3.2","quotable":true,"versions":[{"version":"3.0.2","date":"2026-07-21"},{"version":"2.2.0","date":"2025-08-26"},{"version":"2.1.4","date":"2025-07-22"},{"version":"2.1.3","date":"2025-05-19"},{"version":"2.1.2","date":"2025-04-11"},{"version":"2.1.1","date":"2025-03-28"},{"version":"2.1.0","date":"2025-03-26"},{"version":"2.0.0","date":"2024-12-13"},{"version":"1.3.1","date":"2024-10-21"},{"version":"1.3.0","date":"2024-10-21"},{"version":"1.2.0","date":"2024-09-09"},{"version":"1.1.0","date":"2024-08-21"},{"version":"1.0.1","date":"2024-08-14"},{"version":"1.0.0","date":"2024-08-08"},{"version":"0.10.2","date":"2024-07-22"},{"version":"0.10.1","date":"2024-07-01"},{"version":"0.10.0","date":"2024-06-24"},{"version":"0.9.0","date":"2024-06-05"},{"version":"0.8.6","date":"2024-05-03"},{"version":"0.8.5","date":"2024-05-02"},{"version":"0.8.4","date":"2024-02-28"},{"version":"0.8.3","date":"2024-02-02"},{"version":"0.8.2","date":"2024-01-29"},{"version":"0.8.1","date":"2024-01-24"},{"version":"0.8.0","date":"2023-12-21"},{"version":"0.7.1","date":"2023-09-21"}],"crawled_at":"2026-10-25"},"edges":{"maintainers":[{"ref":"actor:sap","name":"SAP","json":"/actors/sap.json"}],"contributors":[],"explained_by":[],"alternative_to_this":[],"needed_by":[],"available_via":[],"parts":[],"add_ons":[],"answered_through_parts":[]}}