PackagePackagetypeA library you install and call yourself.See every one →What this type is →by SAPby SAPoriginPublished by SAP itself. A visible facet, never an input to a reading — a dormant official plugin reads exactly like a dormant independent one.See every one →
@sap-cloud-sdk/util
General utilities shared across the Cloud SDK packages — a dependency, not a thing to reach for on its own.
DestinationsCAPDestinationscapabilityReaching a system that is not yours — an S/4HANA tenant, an on-premise service, a third-party API — without the address, the credentials or the tunnel being written into the application. The destination is the indirection, and the reason an endpoint can move without a redeploy.
Who is behind it
SAPSAPOrganisationMaintains this In the atlas: maintains 137, wrote 14@SAPmaintainerArtem KovalovPersonContributes to this In the atlas: contributes to 6@artemkovalyovSAP Cloud SDK BotPersonContributes to this In the atlas: contributes to 11@bot-sdk-jsBrigittaK307PersonContributes to this In the atlas: contributes to 12@BrigittaK307Britta VarwigPersonContributes to this In the atlas: contributes to 8@bvarwigRobert KaniaPersonContributes to this In the atlas: contributes to 6@cezaryrkChristian SchüringsPersonContributes to this In the atlas: contributes to 25@cschueringsDaniel KullmannPersonContributes to this In the atlas: contributes to 6@daniel-kullmannDavid KnaackPersonContributes to this In the atlas: contributes to 13, wrote 1@davidkna-sapDeeksha SinhaPersonContributes to this In the atlas: contributes to 12@deekshas8Deni DajaPersonContributes to this In the atlas: contributes to 6@denidaja38 contributors
Before choosing this
crawled
Conditions
LicenceSAP Developer License Agreement 3.2 CAP§ 1from DestinationsA destination used by a covered CAP application sends SAP product data to a non-SAP product rather than only addressing a remote endpoint.
§ 1License. Productive customer applications are limited to SAP BTP or another SAP-licensed platform, and mass extraction to a non-SAP product is restricted except where solely required for SAP interoperability.
A destination is configuration, not the deciding boundary. The licence becomes material when the resulting data flow is extraction into a non-SAP product, so the target and purpose need review.
declared, Where the library runs once installed: inside its host (loaded into the CAP application, installed into the ABAP system, loaded by the UI5 application), in a program of your own, or only at build time.
Distributed through
npm
declared, How it is installed, as its documentation tells a user to get it., read npm install @sap-cloud-sdk/util — @sap-cloud-sdk/util — README, 2026-10-18
Connections1
Group by
NodeRelationConditionBasis
Functional1
DestinationsDestinationscapabilityReaching remote systems without addresses or credentials in the codeSAP and community, unassessed
→provides
none
authored
provides Destinations
Functional, authored
Reaching remote systems without addresses or credentials in the code
This package contains general utility functions that we reuse multiple times in the SDK.
While primarily designed for internal usage, they might also be beneficial for consumers of the SDK.
Installation
$ npm install @sap-cloud-sdk/util
Usage
The util package collects useful tools that help build your SAP Business Technology Platform application.
For example, the following code snippet changes the log level of the destination accessor of the SDK.
import { setLogLevel } from '@sap-cloud-sdk/util';
setLogLevel('debug', 'destination-accessor');
Support
The recommended way to get in touch with us is to create an issue on GitHub.
Select the issue category Bug, Feature, or Question depending on the nature of your request.
We try to provide fixes, features and answers as soon as possible.
Contribute
If you would like to contribute to the SAP Cloud SDK, please make yourself familiar with our contributing guidelines and follow the given instructions.
7d92a1b: [Compatibility Note] The following deprecated content has been removed from the package:
The assoc constant has been removed. There is no replacement.
Minor Changes
936a6eb: [New Functionality] Add basePath option in the options-per-service.json file in the OpenAPI generator. This option prepends the base URL path to the API path parameter for every request.
Patch Changes
4228412: [Fixed Issue] Stringify Axios response data object in the error stack of ErrorWithCause class.
fde964e37: [Compatibility Note] By default, generation of OData clients fails if a service path cannot be determined. Either provide servicePath value in the options-per-service.json or set skipValidation to true, in which case, / will be used.
fde964e37: [Compatibility Note] The function variadicArgumentToArray is replaced by the function transformVariadicArgumentToArray.
fde964e37: [Compatibility Note] Switch the compilerOptions.module to Node16 instead of CommonJS for better interoperability with ES modules. See the TypeScript handbook for technical details if needed.
fde964e37: [Compatibility Note] The field logger on the interface LoggerOptions was not used and is removed from the interface.
89f1c423: [Compatibility Note] Stop using VCAP_SERVICES to determine the log format. Use setLogFormat and setGlobalLogFormat to specify the log format. By default, the log format is set to kibana for NODE_ENV=production and local otherwise.
DestinationsDestinationscapabilityReaching a system that is not yours — an S/4HANA tenant, an on-premise service, a third-party API — without the address, the credentials or the tunnel being written into the application. The destination is the indirection, and the reason an endpoint can move without a redeploy.SAP and community, unassessed
SAP Destination serviceSAP Destination serviceserviceNamed, credentialed addresses of other systems, resolved at runtime — so an application holds no URL and no secret of its own, and the same code reaches a different system in every landscape.sap official, btpNamed, credentialed addresses of other systems resolved at runtimefrom BTP/BAIP
SAP Private Link ServiceSAP Private Link ServiceserviceA private network connection between a selected SAP BTP service and a selected service in an application's own account with a partner cloud provider, so the traffic between them never touches the public internet.sap official, btpPrivate network link between a BTP service and a partner cloudfrom BTP/BAIP
com.sap.cds:cds-feature-remote-odatacom.sap.cds:cds-feature-remote-odatapackageA CAP Java feature for consuming remote OData V2 and V4 services as Remote Services, translating CQN queries into OData requests against a destination or a service binding.sap official, capRemote Services for consuming OData V2 and V4 APIs in CAP Javafrom CAP
com.sap.cds:cds-integration-cloud-sdkcom.sap.cds:cds-integration-cloud-sdkpackageA CAP Java feature that integrates the SAP Cloud SDK, so features such as remote OData and enterprise messaging resolve a destination or service binding and reach a remote REST-based service.sap official, capSAP Cloud SDK integration for remote REST services in CAP Javafrom CAP
capire/s4capire/s4packageA pre-built integration package for SAP S/4HANA, holding the imported service definitions a CAP project would otherwise generate for itself.sap official, capPrebuilt SAP S/4HANA integration package for CAP projectsfrom CAP
cdsecdsepackageResolves a destination from a CAP project's own configuration, then makes the outbound call with axios: the url, the method and the body are written at the call site.independent, capDestination resolution and axios calls from CAP configurationfrom CAP
@sap/cds@sap/cdspackageThe CAP Node.js runtime, which compiles the CDS model, serves the services declared in it, answers generic requests before any handler runs, and loads every cds-plugin.sap official, capCAP Node.js runtimefrom CAP
@sap-cloud-sdk/connectivity@sap-cloud-sdk/connectivitypackageDestination lookup and the connectivity proxy — the package that turns a destination name into a reachable endpoint with credentials attached.sap official, capDestination lookup and connectivity proxy for the Cloud SDKfrom CAP
@sap-cloud-sdk/http-client@sap-cloud-sdk/http-clientpackageThe HTTP client that carries a destination's credentials, so an outbound call inherits the authentication rather than assembling it.sap official, capHTTP client carrying a destination's credentialsfrom CAP
@sap-cloud-sdk/odata-common@sap-cloud-sdk/odata-commonpackageThe shared machinery under the SDK's OData and OpenAPI client generators; a dependency of the generated clients rather than something written against directly.sap official, capShared machinery under the Cloud SDK's OData and OpenAPI clientsfrom CAP
@sap-cloud-sdk/openapi@sap-cloud-sdk/openapipackageGenerated OpenAPI clients for the Cloud SDK, so a REST API described by a specification is called through typed functions.sap official, capGenerated OpenAPI clients for the Cloud SDKfrom CAP
@sap-cloud-sdk/resilience@sap-cloud-sdk/resiliencepackageTimeouts, retries and circuit breaking around a remote call, so one slow downstream system does not take the application with it.sap official, capTimeouts, retries and circuit breaking around remote callsfrom CAP
btp-cloud-connector-setup-automationbtp-cloud-connector-setup-automationgeneratorA Yeoman generator that adds the Cloud Connector system mappings for an XS Advanced system and writes the matching SAP BTP destination files.sap official, btpYeoman generator for Cloud Connector mappings and BTP destinationsfrom BTP/BAIP
@sapmentors/cds-scp-api@sapmentors/cds-scp-apipackageA Node module for CAP that calls an external API through a destination instead of a hardcoded endpoint, taking its address, credentials and on-premise tunnel from the SAP Destination and Connectivity services.community org, capNode module for CAP calling external APIs through a destinationfrom CAP
