cloud-sdk-js

Improvements

• [openapi-generator] Update generation of properties with nullable: true in the spec to include type | null in the output types. (d2a2394)
• [openapi-generator] Normalize schemas that have allOf, anyOf, or oneOf alongside properties defined at the same level. (d2a2394)
• [openapi-generator] Configure generated OpenAPI clients to handle text/plain, application/octet-stream, and wildcard */* content types in response headers. (89f77cd)

Compatibility Notes

• [connectivity] Throw an error if a JWT for caching was provided, but doesn't contain tenant information. (39eb88c)

Fixed Issues

• [connectivity] Derive tenant information for destination caching also for IAS tokens.
  • @sap-cloud-sdk/[email protected]
  • @sap-cloud-sdk/[email protected] (39eb88c)

Fixed Issues

• [openapi-generator] Prevent query parameters from being optional when header parameters are required in signature. (a566fdd)

Fixed Issues

• [connectivity] Fix IAS to XSUAA token exchange to have less strict verification.
  • @sap-cloud-sdk/[email protected]
  • @sap-cloud-sdk/[email protected] (c1bf319)

New Functionalities

• [connectivity] Support IAS tokens without the need to pass iss in the destination fetch options. (06e5c72)
• [openapi-generator, generator-common] Introduce option generateESM in OpenAPI generator to generate ESM compatible code. (3a93e38)

Fixed Issues

• [connectivity] Fix the JwtPayload import.
  • @sap-cloud-sdk/[email protected]
  • @sap-cloud-sdk/[email protected] (c23ccfd)
• [mail-client] Fix the type of replyTo property in the MailConfig interface. (00fa35d)

New Functionalities

• [connectivity] Add getTenantId() function for convenience. (dbad36f)
• [mail-client] Add support for multi-tenancy for on-premise mail destinations. (68a07d6)

Improvements

• [connectivity] Use tenant ID instead of tenant-aware authentication URL for the client credentials cache. (54a46a3)
• [connectivity] Retrieve service token for OAuth2ClientCredentials authentication only once. (99b5009)
• [openapi-generator] Generated OpenAPI clients support application/merge-patch+json media type for patch requests. (e9a243a)

Fixed Issues

• [connectivity] Fix token fetching for mail multi-tenancy scenarios.
  • @sap-cloud-sdk/[email protected]
  • @sap-cloud-sdk/[email protected] (86f4158)
• [mail-client] Fix token fetching for mail multi-tenancy scenarios. (86f4158)

Compatibility Notes

• [connectivity] The JKU header in JWTs is no longer verified. Instead the signature of the JWT is verified, which is more secure. (4f29615)
• [generator] Generation of OData clients does no longer fail if basePath value cannot be determined. It will be set to / by default. (ef3a800)

New Functionalities

• [connectivity] Add convenience function transformServiceBindingToDestination() to create destination from service bindings.
  The following service bindings are supported:

  • business-logging
  • destination
  • s4-hana-cloud
  • saas-registry
  • workflow
  • service-manager
  • xsuaa
  • aicore (efa75d3)

Improvements

• [connectivity] Expose getServiceBinding(). This was previously an internal function. (efa75d3)
• [generator] Generated clients support noImplicitOverride config option in tsconfig.json. (022adae)
• [generator] If basePath cannot be determined, it is set to /, and generation no longer fails. (28ab1a4)
• [openapi-generator] Generate OpenAPI clients with header parameters. (aa0b849)

Fixed Issues

• [generator] Fix incorrect warning logs for operation imports that have a matching operation in the service specification. (9efe37e)

Improvements

• [openapi] Expose custom type for the addCustomRequestConfiguration() method of the OpenAPI Request Builder (4b3ebfd)
• [eslint-config] Add a config based on the new eslint flat config format. The new config can be used inside a eslint.config.js file. (7760692)

Fixed Issues

• [openapi-generator] Fix nested array type in generated OpenAPI schemas such that array wraps the whole object. (ff3ede6)
• [openapi-generator] Fix serialization of path params that contain quotes to avoid syntax error and failing client generation (b4bc9ad)

New Functionalities

• [connectivity] Support the AI Core Service Binding when creating destinations from service bindings (f72986a)

Fixed Issues

• [connectivity] Fix fetchDestinationWithoutTokenRetrieval to correctly return instance and subaccount destinations.
  • @sap-cloud-sdk/[email protected]
  • @sap-cloud-sdk/[email protected] (60fdc04)
• [openapi, odata-common] Fix type in addCustomRequestConfiguration method to accept values of type any. (60fdc04)

New Functionalities

• [connectivity] Support certificates in PEM format for ClientCertificateAuthentication. (36be489)

Fixed Issues

• [openapi] Fix incorrect encoding of query parameters in OpenAPI requests. Query parameters (except for additional custom parameters) are now encoded by default. To change this behavior overwrite the parameterEncoder in the request options. (d6b1c5b)
• [openapi-generator] Fix types in generated OpenAPI schemas to have proper types instead of type any. (6bbdd4d)

Improvements

• [mail-client] Add optional logger property to enable console logs. Defaults to false. (7ec62fa)

Fixed Issues

• [mail-client] Fix "Hostname/IP does not match certificate's altnames" issues with "localhost" when sending e-mails OnPremise. Always pass the host and port of the MAIL destination explicitly to the underlying nodemailer instead of falling back to the default.
  • @sap-cloud-sdk/[email protected]
  • @sap-cloud-sdk/[email protected] (62f31fb)

Compatibility Notes

• [connectivity] The SAP Cloud SDK used to get all subaccount and instance destinations, that are available with your JWT (without potentially required token retrieval), through two requests to the destination service (/subaccountDestinations and /instanceDestinations). While this approach can have advantages when caching, it can cause severe performance issues without caching. Therefore, from now on, only one destination is retrieved per requested destination through /destinations.
  You can no longer rely on the SDK to automatically cache all destinations on the first request. If needed, you can call getAllDestinationsFromDestinationService() with cache enabled instead. (c721bbd)
• [connectivity] Using Principal Propagation through authentication type NoAuthentication is no longer supported. This resulted in erroneous behavior for destinations with authentication type NoAuthentication. If you need to use Principal Propagation use authentication type PrincipalPropagation. (28c9cb7)

New Functionalities

• [util] Add support for setting log level for newly created logger using environment variable SAP_CLOUD_SDK_LOG_LEVEL. (4d2b49b)

Improvements

• [connectivity] Retrieve only one destination per requested destination instead of all subaccount and instance destinations. (See compatibility notes.) (c721bbd)

Fixed Issues

• [connectivity] Allow the use of authentication type NoAuthentication with proxy type OnPremise without requiring the SAP-Connectivity-Authentication header. (28c9cb7)

Fixed Issues

• [odata-common] Add support for subrequest serialization where a batch request may only contain an entity with no path. (a87dd7f)

Improvements

• [eslint-config] Update eslint plugins (d6bbd3210)

Compatibility Notes

• [connectivity] Remove unused internal functionality around JWT property access, like userFromJwt (removed) and audiences (changed). (693cd655f)

New Functionalities

• [mail-client] Add Support for Location ID in destinations of type MAIL (8516b7f04)

Fixed Issues

• [generator] Don't generate delete(), update(), and getByKey() methods in the RequestBuilder of an entity without keys.
  • @sap-cloud-sdk/[email protected]
  • @sap-cloud-sdk/[email protected]
  • @sap-cloud-sdk/[email protected]
  • @sap-cloud-sdk/[email protected]
  • @sap-cloud-sdk/[email protected] (34ef77a1c)

Fixed Issues

• [odata-common, odata-v2, odata-v4, generator, generator-common] Do not send null values in the request payload for properties that are not set while creating or updating an entity.
• [odata-common, odata-v2, odata-v4, generator, generator-common] Fix RangeError: Maximum call stack size exceeded error that occurs when updating an entity after calling getByKey. (bdcf14f85)

Compatibility Notes

• [connectivity] Proxy configuration is no longer realized through a proxy agent, but with the native axios proxy setting instead. (025b6aa2c)

Fixed Issues

• [connectivity] Use axios native proxy, instead of proxy agent, which causes connection issues for write requests on SAP Cloud Connector. (025b6aa2c)
• [http-client] Fix CSRF token fetching against OnPremise systems. (c2a2987c5)

Fixed Issues

• [connectivity] Compare selectionStrategy in DestinationFetchOptions based on value instead of reference. (7ed5ceb52)
• [connectivity] Fix destination caching for destinations from service bindings. The destinations are not cached repeatedly. The function getDestinationFromServiceBinding() returns undefined for destinations which have expired JWTs. (bf54df09b)
• [connectivity] Support destinations of type ClientCertificateAuthentication without password.
  • @sap-cloud-sdk/[email protected]
  • @sap-cloud-sdk/[email protected] (2277f9443)
• [odata-common, odata-v2, odata-v4] Fix OData v2 serialization for Edm.Decimal to serialize to string. (ee7477ce2)