All notable changes to this project will be documented in this file.
The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.
2.12.0 - 2026-04-17
- Added function to get collection queryables:
Connection.describeCollectionQueryables()
- Fixed Typescript declaration file
2.11.0 - 2026-03-10
- Resume previously authenticated sessions via
AuthProvider.resume() - Support OIDC Client Credentials flow
- Clean stale OIDC auth entries from local storage
2.10.0 - 2026-02-25
- Support for JWT tokens as defined in openEO API v1.3.0 (conformance class:
https://api.openeo.org/1.3.0/authentication/jwt) - Support OIDC client
authorization_parameters
- Tests run on openeo-test-api instead of openeo-earthengine-driver
- Federation extension support in
Connection.validateProcessforPOST /validationresponses
2.9.0 - 2025-08-22
Capabilities: AddedhasConformancefunction andConformanceURI objectConnection: AddedlistProcessingParametersfunction
- Typescript declaration
2.8.0 - 2025-04-25
- New property
idadded toFederationBackendobjects returned bylistFederationinCapabilities - New functions
getFederationBackendandgetFederationBackendsinCapabilities
- Updated/fixed Typescript declaration
2.7.0 - 2025-01-04
- New function
getMissingBackendsforLogs - New property
federation:backendsadded to the array returned byvalidateProcess - New property
axiosin theEnvironment - New functions in
Connectionfor paginating through lists:paginateProcessespaginateCollectionspaginateJobspaginateFilespaginateUserProcessespaginateServices
- The
listCollectionItemsfunction inConnectionwas completely rewritten. - The client may add a self link to the links in responses
2.6.0 - 2024-07-11
- Support to retrieve conformance classes
- Added
Connection.makeLinksAbsolute - Added
AuthProvider.getDisplayName - Hook to migrate capabilities
- Support for
usage,log_level,linksin batch jobs and services - Support for
levelparameter for log requests in batch jobs and services - Support passing additional parameters to synchronous jobs.
- Updated axios from 0.x to 1.x
- Dependency for
node-abort-controllernot required any longer in nodeJS
- Make the feature / endpoint mapping more robust
- Add missing endpoints to feature / endpoint mapping
- Fix AbortController handling
- Clarify that the
log_levelparameter for jobs, services and sync. processing can be provided via theadditionalparameter
2.5.1 - 2022-04-08
- Job status missing from batch job metadata
2.5.0 - 2022-04-07
listJobs,listServicesandlistUserProcessesallow to update existing processes.listFiles,listJobs,listServicesandlistUserProcessesreturn aResponseArrayinstead of a plainArray. The ResonseArray now has the propertieslinksandfederation:missingfrom the responses. This is usually a non-breaking change, but if you mistakenly useObjectfunctions (such asObject.keys) on an array, you'll get the additional properties, too.
- Fine-tuned some Typescript declarations.
2.4.1 - 2022-01-13
- Fixed regression for OIDC scopes introduced in 2.4.0
2.4.0 - 2022-01-10
- OpenID Connect: Support requesting a refresh token easily via the
requestRefreshTokenparameter.
- The
namespaceparameter inlistProcessesanddescribeProcessparses URLs to extract the namespace (experimental).
- Fixed several type annotations in the documentation and the TypeScript declaration file.
2.3.1 - 2021-12-10
- Process cache gets refreshed after the authentication details have changed (e.g. the user has logged in or out).
2.3.0 - 2021-12-10
- New parameter
abortControllerto allow cancellation of longer running requests (uploading files, sync. data processing).
- Rarely used
multihashesdependency not included in the bundle by default, see Readme to include it in the browser. No change for node environments.
2.2.0 - 2021-08-20
- New method
getUrlto classConnectionto get the main URL of the back-end, which the user provided (i.e. doesn't usually contain version part)
2.1.0 - 2021-08-18
- Experimental support for process namespaces, see API#348.
- Internally, a new process registry is used to manage and cache processes.
listProcessesdoesn't cache requests any longer.
- Return a better error message if issues with reading batch job results occur in
Job.getResultsAsStac getAll()functions return only properties for values that are defined
2.0.1 - 2021-07-14
Formula: Formulas can reference more then just the first parameter by adding additional$at the beginning, e.g.$$0to access the first element of an array in the second parameter.
2.0.0 - 2021-07-06
- Added events to
Connectionto populate changes for Auth Tokens (tokenChanged) and Auth Providers (authProviderChanged). - Added new methods to
Connectionfor working with events:on,offandemit.
- OpenID Connect authentication has been rewritten.
- Default grant type for OpenID Connect is "AuthCode w/ PKCE" instead of "Implicit".
- Support for OpenID Connect session renewal via refresh tokens.
- Updated STAC support to STAC v1.0.0.
OidcProvider: MethodsgetGrant,getScopes,getIssuerandgetUserremoved. Use the propertiesgrant,scopes,issueranduserinstead.- Removed deprecated method
getResultsAsItemin favor ofgetResultsAsStac.
1.3.2 - 2021-05-27
- Fixed error handling for HTTP requests
1.3.1 - 2021-04-29
- Invalid dependency version for @openeo/js-commons
1.3.0 - 2021-04-29
- Custom process specifications can be added to the process builder after first initialization.
- The process builder supports implicitly wrapping:
- an array returned from a callback using the
array_createprocess. - non-objects (e.g. numbers) returned from a callback using the
constantprocess.
- an array returned from a callback using the
- Support for "Default OpenID Connect Clients" (detecting default client IDs).
- Arrow functions can be used as callbacks in process graph building.
- Fixed nullable return types in TS declaraion
- Fixed other minor issues in TS declaration
1.2.0 - 2021-03-11
- Added new method
listCollectionItemsfor searching and retrieving Items fromGET /collections/{collectionId}/items.
- Methods returning STAC (e.g.
listCollections,describeCollection,getResultAsStac,listCollectionItems) always return the data compliant to the latest STAC version (currently 1.0.0-rc.1).
1.1.0 - 2021-02-18
- Added new method
getResultsAsStacfor Jobs, which includes support for STAC Collections returned by the API for batch job results.
- Deprecated method
getResultsAsItemin favor ofgetResultsAsStac.
- TypeScript declaration for Links has been fixed
- Updated dependencies
1.0.3 - 2021-02-02
- Updated axios dependency to fix a vulnerability.
- Updated oidc-client dependency to support the OpenID Connect flow AuthCode with PKCE. Default is still the Implicit Flow.
1.0.2 - 2020-12-02
- Make client more flexible to allow setting the client to use OIDC Authentication Code Flow with PKCE instead of Implicit Flow in the future
- Client doesn't throw errors on back-ends with version numbers >= 1.0.1
1.0.1 - 2020-11-19
- Don't set unnecessary
withCredentialsoption on HTTP requests for better CORS support. openeo-api#41
1.0.0 - 2020-11-17
- Throw better error message in case openeo-identifier can't be retrieved. #37
All prior releases have been documented in the GitHub Releases.