@openeo/js-client 2.5.1 → 2.7.0

package/openeo.d.ts

@@ -3,7 +3,6 @@
 import { User, UserManager } from 'oidc-client';
 import { ProcessRegistry } from '@openeo/js-commons';
 import { Readable } from 'stream';
-import { AbortController } from "node-abort-controller";
 
 declare module OpenEO {
     /**
@@ -36,6 +35,12 @@ declare module OpenEO {
          * @returns {string}
          */
         getId(): string;
+        /**
+         * Returns a display name for the authenticated user.
+         *
+         * @returns {string?} Name of the user or `null`
+         */
+        getDisplayName(): string | null;
         /**
          * Returns the type of the authentication procedure as specified by the API, e.g. `oidc` or `basic`.
          *
@@ -78,6 +83,14 @@ declare module OpenEO {
          * @param {?string} token
          */
         setToken(token: string | null): void;
+        /**
+         * Abstract method that extending classes implement the login process with.
+         *
+         * @async
+         * @param {...*} args
+         * @throws {Error}
+         */
+        login(...args: any[]): Promise<void>;
         /**
          * Logout from the established session.
          *
@@ -98,9 +111,9 @@ declare module OpenEO {
          * Creates an instance of this object.
          *
          * @param {Connection} connection - A Connection object representing an established connection to an openEO back-end.
-         * @param {Array} properties - A mapping from the API property names to the JS client property names (usually to convert between snake_case and camelCase), e.g. `["id", "title", ["process_graph", "processGraph"]]`
+         * @param {Array.<string|Array.<string>>} properties - A mapping from the API property names to the JS client property names (usually to convert between snake_case and camelCase), e.g. `["id", "title", ["process_graph", "processGraph"]]`
          */
-        constructor(connection: Connection, properties?: any[]);
+        constructor(connection: Connection, properties?: Array<string | Array<string>>);
         /**
          * @protected
          * @type {Connection}
@@ -184,6 +197,14 @@ declare module OpenEO {
      * @hideconstructor
      */
     export class Environment {
+        /**
+         * The axios instance to use for HTTP requests.
+         *
+         * 
+         * @type {object}
+         * @static
+         */
+        static axios: object;
         /**
          * Returns the name of the Environment, `Node` or `Browser`.
          *
@@ -228,7 +249,7 @@ declare module OpenEO {
          * @param {string|Buffer} str - String to encode.
          * @returns {string} String encoded in Base64.
          */
-        static base64encode(str: string|Buffer): string;
+        static base64encode(str: string | Buffer): string;
         /**
          * Detect the file name for the given data source.
          *
@@ -286,16 +307,17 @@ declare module OpenEO {
          * @param {Connection} connection - A Connection object representing an established connection to an openEO back-end.
          */
         constructor(connection: Connection);
+        username: string;
         /**
          * Authenticate with HTTP Basic.
-         * 
+         *
          * @async
-         * @param {string} username 
-         * @param {string} password 
+         * @param {string} username
+         * @param {string} password
          * @returns {Promise<void>}
          * @throws {Error}
          */
-        login(username: string, password: string) : Promise<void>;
+        login(username: string, password: string): Promise<void>;
     }
     /**
      * Capabilities of a back-end.
@@ -313,17 +335,32 @@ declare module OpenEO {
          * @type {object.<string, *>}
          */
         private data;
+        /**
+         * @private
+         * @ignore
+         * @type {object.<string, string>}
+         */
+        private featureMap;
         /**
          * @private
          * @type {Array.<string>}
          */
         private features;
         /**
-         * @private
-         * @ignore
-         * @type {object.<string, string>}
+         * Validates the capabilities.
+         *
+         * Throws an error in case of an issue, otherwise just passes.
+         *
+         * @protected
+         * @throws {Error}
          */
-        private featureMap;
+        protected validate(): void;
+        /**
+         * Initializes the class.
+         *
+         * @protected
+         */
+        protected init(): void;
         /**
          * Returns the capabilities response as a JSON serializable representation of the data that is API compliant.
          *
@@ -366,6 +403,12 @@ declare module OpenEO {
          * @returns {Array.<Link>} Array of link objects (href, title, rel, type)
          */
         links(): Array<Link>;
+        /**
+         * Returns list of backends in the federation.
+         *
+         * @returns {Array.<FederationBackend>} Array of backends
+         */
+        listFederation(): Array<FederationBackend>;
         /**
          * Lists all supported features.
          *
@@ -391,6 +434,14 @@ declare module OpenEO {
          * @returns {Array.<BillingPlan>} Billing plans
          */
         listPlans(): Array<BillingPlan>;
+        /**
+         * Migrates a response, if required.
+         *
+         * @param {AxiosResponse} response
+         * @protected
+         * @returns {AxiosResponse}
+         */
+        protected migrate(response: AxiosResponse): AxiosResponse;
     }
     /**
      * The Authentication Provider for OpenID Connect.
@@ -516,6 +567,20 @@ declare module OpenEO {
          * @see OidcProvider#addListener
          */
         removeListener(event: string, scope?: string): void;
+        /**
+         * Authenticate with OpenID Connect (OIDC).
+         *
+         * Supported only in Browser environments.
+         *
+         * @async
+         * @param {object.<string, *>} [options={}] - Object with authentication options.
+         * @param {boolean} [requestRefreshToken=false] - If set to `true`, adds a scope to request a refresh token.
+         * @returns {Promise<void>}
+         * @throws {Error}
+         * @see https://github.com/IdentityModel/oidc-client-js/wiki#other-optional-settings
+         * @see {OidcProvider#refreshTokenScope}
+         */
+        login(options?: object<string, any>, requestRefreshToken?: boolean): Promise<void>;
         /**
          * Returns the options for the OIDC client library.
          *
@@ -568,25 +633,11 @@ declare module OpenEO {
          * @see OidcProvider#setClientId
          */
         detectDefaultClient(): OidcClient | null;
-        /**
-         * Authenticate with OpenID Connect (OIDC).
-         * 
-         * Supported only in Browser environments.
-         * 
-         * @async
-         * @param {object.<string, *>} [options={}] - Object with authentication options.
-         * @param {boolean} [requestRefreshToken=false] - If set to `true`, adds a scope to request a refresh token.
-         * @returns {Promise<void>}
-         * @throws {Error}
-         * @see https://github.com/IdentityModel/oidc-client-js/wiki#other-optional-settings
-         * @see {OidcProvider#refreshTokenScope}
-         */
-        login(options?: any, requestRefreshToken?: boolean) : void;
     }
     export namespace OidcProvider {
-        const uiMethod: string;
-        const redirectUrl: string;
-        const grants: Array<string>;
+        let uiMethod: string;
+        let redirectUrl: string;
+        let grants: Array<string>;
     }
     /**
      * Manages the files types supported by the back-end.
@@ -761,15 +812,34 @@ declare module OpenEO {
          *
          * @param {Connection} connection - A Connection object representing an established connection to an openEO back-end.
          * @param {string} endpoint - The relative endpoint to request the logs from, usually `/jobs/.../logs` or `/services/.../logs` with `...` being the actual job or service id.
+         * @param {?string} [level=null] - Minimum level of logs to return.
          */
-        constructor(connection: Connection, endpoint: string);
+        constructor(connection: Connection, endpoint: string, level?: string | null);
         /**
          * @protected
          * @type {Connection}
          */
         protected connection: Connection;
-        endpoint: string;
-        lastId: string;
+        /**
+         * @protected
+         * @type {string}
+         */
+        protected endpoint: string;
+        /**
+         * @protected
+         * @type {string}
+         */
+        protected lastId: string;
+        /**
+         * @protected
+         * @type {?string}
+         */
+        protected level: string | null;
+        /**
+         * @protected
+         * @type {Set<string>}
+         */
+        protected missing: Set<string>;
         /**
          * Retrieves the next log entries since the last request.
          *
@@ -780,6 +850,16 @@ declare module OpenEO {
          * @returns {Promise<Array.<Log>>}
          */
         nextLogs(limit?: number): Promise<Array<Log>>;
+        /**
+         * Retrieves the backend identifiers that are (partially) missing in the logs.
+         *
+         * This is only filled after the first request using `nextLogs` or `next`.
+         *
+         * @returns {Array.<string>}
+         * @see {Logs#nextLogs}
+         * @see {Logs#next}
+         */
+        getMissingBackends(): Array<string>;
         /**
          * Retrieves the next log entries since the last request.
          *
@@ -829,7 +909,7 @@ declare module OpenEO {
          * @readonly
          * @type {?Process}
          */
-        public readonly process: Process;
+        public readonly process: Process | null;
         /**
          * The current status of a batch job.
          * One of "created", "queued", "running", "canceled", "finished" or "error".
@@ -926,9 +1006,10 @@ declare module OpenEO {
         /**
          * Get logs for the batch job from the back-end.
          *
+         * @param {?string} [level=null] - Minimum level of logs to return.
          * @returns {Logs}
          */
-        debugJob(): Logs;
+        debugJob(level?: string | null): Logs;
         /**
          * Checks for status changes and new log entries every x seconds.
          *
@@ -1049,7 +1130,7 @@ declare module OpenEO {
          * @readonly
          * @type {?object.<string, *>}
          */
-        public readonly returns: object<string, any>;
+        public readonly returns: object<string, any> | null;
         /**
          * Specifies that the process or parameter is deprecated with the potential to be removed in any of the next versions.
          * @public
@@ -1070,7 +1151,7 @@ declare module OpenEO {
          * @readonly
          * @type {?object.<string, *>}
          */
-        public readonly exceptions: object<string, any>;
+        public readonly exceptions: object<string, any> | null;
         /**
          * @public
          * @readonly
@@ -1089,7 +1170,7 @@ declare module OpenEO {
          * @readonly
          * @type {?object.<string, *>}
          */
-        public readonly processGraph: object<string, any>;
+        public readonly processGraph: object<string, any> | null;
         /**
          * Updates the data stored in this object by requesting the process graph metadata from the back-end.
          *
@@ -1160,7 +1241,7 @@ declare module OpenEO {
          * @readonly
          * @type {?Process}
          */
-        public readonly process: Process;
+        public readonly process: Process | null;
         /**
          * URL at which the secondary web service is accessible
          * @public
@@ -1187,14 +1268,14 @@ declare module OpenEO {
          * @readonly
          * @type {?object.<string, *>}
          */
-        public readonly configuration: object<string, any>;
+        public readonly configuration: object<string, any> | null;
         /**
          * Additional attributes of the secondary web service, e.g. available layers for a WMS based on the bands in the underlying GeoTiff.
          * @public
          * @readonly
          * @type {?object.<string, *>}
          */
-        public readonly attributes: object<string, any>;
+        public readonly attributes: object<string, any> | null;
         /**
          * Date and time of creation, formatted as a RFC 3339 date-time.
          * @public
@@ -1265,9 +1346,10 @@ declare module OpenEO {
         /**
          * Get logs for the secondary web service from the back-end.
          *
+         * @param {?string} [level=null] - Minimum level of logs to return.
          * @returns {Logs}
          */
-        debugService(): Logs;
+        debugService(level?: string | null): Logs;
         /**
          * Checks for new log entries every x seconds.
          *
@@ -1451,7 +1533,7 @@ declare module OpenEO {
         addOperatorProcess(operator: string, left: number | object<string, any>, right: number | object<string, any>): BuilderNode;
     }
     export namespace Formula {
-        const operatorMapping: object<string, string>;
+        let operatorMapping: object<string, string>;
     }
     /**
      * A class that represents a process node and also a result from a process.
@@ -1505,11 +1587,11 @@ declare module OpenEO {
         /**
          * Converts a sorted array of arguments to an object with the respective parameter names.
          *
-         * @param {Array} processArgs
+         * @param {Array.<object.<string, *>>} processArgs
          * @returns {object.<string, *>}
          * @throws {Error}
          */
-        namedArguments(processArgs: any[]): object<string, any>;
+        namedArguments(processArgs: Array<object<string, any>>): object<string, any>;
         /**
          * Checks the arguments given for parameters and add them to the process.
          *
@@ -1739,10 +1821,10 @@ declare module OpenEO {
         /**
          * Gets the callback parameter specifics from the parent process.
          *
-         * @returns {Array}
+         * @returns {Array.<object.<string,*>>}
          * @todo Should this also pass callback parameters from parents until root is reached?
          */
-        getParentCallbackParameters(): any[];
+        getParentCallbackParameters(): Array<object<string, any>>;
         /**
          * Adds a parameter to the list of process parameters.
          *
@@ -1881,11 +1963,12 @@ declare module OpenEO {
          * @async
          * @protected
          * @returns {Promise<Capabilities>} Capabilities
+         * @throws {Error}
          */
         protected init(): Promise<Capabilities>;
         /**
          * Refresh the cache for processes.
-         * 
+         *
          * @async
          * @protected
          * @returns {Promise}
@@ -1937,12 +2020,25 @@ declare module OpenEO {
          * List all collections available on the back-end.
          *
          * The collections returned always comply to the latest STAC version (currently 1.0.0).
+         * This function adds a self link to the response if not present.
          *
          * @async
          * @returns {Promise<Collections>} A response compatible to the API specification.
          * @throws {Error}
          */
         listCollections(): Promise<Collections>;
+        /**
+         * Paginate through the collections available on the back-end.
+         *
+         * The collections returned always complies to the latest STAC version (currently 1.0.0).
+         * This function adds a self link to the response if not present.
+         *
+         * @async
+         * @param {?number} [limit=50] - The number of collections per request/page as integer. If `null`, requests all collections.
+         * @yields {Promise<Collections>} A response compatible to the API specification.
+         * @throws {Error}
+         */
+        paginateCollections(limit?: number | null): AsyncGenerator<any, void, unknown>;
         /**
          * Get further information about a single collection.
          *
@@ -1956,12 +2052,11 @@ declare module OpenEO {
         describeCollection(collectionId: string): Promise<Collection>;
         /**
          * Loads items for a specific image collection.
+         *
          * May not be available for all collections.
          *
          * The items returned always comply to the latest STAC version (currently 1.0.0).
          *
-         * This is an experimental API and is subject to change.
-         *
          * @async
          * @param {string} collectionId - Collection ID to request items for.
          * @param {?Array.<number>} [spatialExtent=null] - Limits the items to the given bounding box in WGS84:
@@ -1969,7 +2064,7 @@ declare module OpenEO {
          * 2. Lower left corner, coordinate axis 2
          * 3. Upper right corner, coordinate axis 1
          * 4. Upper right corner, coordinate axis 2
-         * @param {?Array.<*>} [temporalExtent=null] - Limits the items to the specified temporal interval.
+         * @param {?Array} [temporalExtent=null] - Limits the items to the specified temporal interval.
          * The interval has to be specified as an array with exactly two elements (start, end) and
          * each must be either an RFC 3339 compatible string or a Date object.
          * Also supports open intervals by setting one of the boundaries to `null`, but never both.
@@ -1977,7 +2072,7 @@ declare module OpenEO {
          * @yields {Promise<ItemCollection>} A response compatible to the API specification.
          * @throws {Error}
          */
-        listCollectionItems(collectionId: string, spatialExtent?: Array<number> | null, temporalExtent?: Array<any> | null, limit?: number | null): AsyncGenerator<any, void, unknown>;
+        listCollectionItems(collectionId: string, spatialExtent?: Array<number> | null, temporalExtent?: any[] | null, limit?: number | null): AsyncGenerator<any, void, unknown>;
         /**
          * Normalisation of the namespace to a value that is compatible with the OpenEO specs - EXPERIMENTAL.
          *
@@ -1993,7 +2088,7 @@ declare module OpenEO {
          */
         protected normalizeNamespace(namespace: string | null): string | null;
         /**
-         * List processes available on the back-end.
+         * List all processes available on the back-end.
          *
          * Requests pre-defined processes by default.
          * Set the namespace parameter to request processes from a specific namespace.
@@ -2001,12 +2096,32 @@ declare module OpenEO {
          * Note: The list of namespaces can be retrieved by calling `listProcesses` without a namespace given.
          * The namespaces are then listed in the property `namespaces`.
          *
+         * This function adds a self link to the response if not present.
+         *
          * @async
          * @param {?string} [namespace=null] - Namespace of the processes (default to `null`, i.e. pre-defined processes). EXPERIMENTAL!
          * @returns {Promise<Processes>} - A response compatible to the API specification.
          * @throws {Error}
          */
         listProcesses(namespace?: string | null): Promise<Processes>;
+        /**
+         * Paginate through the processes available on the back-end.
+         *
+         * Requests pre-defined processes by default.
+         * Set the namespace parameter to request processes from a specific namespace.
+         *
+         * Note: The list of namespaces can be retrieved by calling `listProcesses` without a namespace given.
+         * The namespaces are then listed in the property `namespaces`.
+         *
+         * This function adds a self link to the response if not present.
+         *
+         * @async
+         * @param {?string} [namespace=null] - Namespace of the processes (default to `null`, i.e. pre-defined processes). EXPERIMENTAL!
+         * @param {?number} [limit=50] - The number of processes per request/page as integer. If `null`, requests all processes.
+         * @yields {Promise<Processes>} - A response compatible to the API specification.
+         * @throws {Error}
+         */
+        paginateProcesses(namespace?: string | null, limit?: number | null): AsyncGenerator<any, void, unknown>;
         /**
          * Get information about a single process.
          *
@@ -2156,13 +2271,22 @@ declare module OpenEO {
          */
         describeAccount(): Promise<UserAccount>;
         /**
-         * Lists all files from the user workspace.
+         * List all files from the user workspace.
          *
          * @async
          * @returns {Promise<ResponseArray.<UserFile>>} A list of files.
          * @throws {Error}
          */
         listFiles(): Promise<ResponseArray<UserFile>>;
+        /**
+         * Paginate through the files from the user workspace.
+         *
+         * @async
+         * @param {?number} [limit=50] - The number of files per request/page as integer. If `null`, requests all files.
+         * @yields {Promise<ResponseArray.<UserFile>>} A list of files.
+         * @throws {Error}
+         */
+        paginateFiles(limit?: number | null): AsyncGenerator<any, void, unknown>;
         /**
          * A callback that is executed on upload progress updates.
          *
@@ -2211,12 +2335,12 @@ declare module OpenEO {
          *
          * @async
          * @param {Process} process - User-defined process to validate.
-         * @returns {Promise<Array.<ApiError>>} errors - A list of API compatible error objects. A valid process returns an empty list.
+         * @returns {Promise<ValidationResult>} errors - A list of API compatible error objects. A valid process returns an empty list.
          * @throws {Error}
          */
-        validateProcess(process: Process): Promise<Array<ApiError>>;
+        validateProcess(process: Process): Promise<ValidationResult>;
         /**
-         * Lists all user-defined processes of the authenticated user.
+         * List all user-defined processes of the authenticated user.
          *
          * @async
          * @param {Array.<UserProcess>} [oldProcesses=[]] - A list of existing user-defined processes to update.
@@ -2224,6 +2348,16 @@ declare module OpenEO {
          * @throws {Error}
          */
         listUserProcesses(oldProcesses?: Array<UserProcess>): Promise<ResponseArray<UserProcess>>;
+        /**
+         * Paginates through the user-defined processes of the authenticated user.
+         *
+         * @async
+         * @param {?number} [limit=50] - The number of processes per request/page as integer. If `null`, requests all processes.
+         * @param {Array.<UserProcess>} [oldProcesses=[]] - A list of existing user-defined processes to update.
+         * @yields {Promise<ResponseArray.<UserProcess>>} A list of user-defined processes.
+         * @throws {Error}
+         */
+        paginateUserProcesses(limit?: number | null, oldProcesses?: Array<UserProcess>): AsyncGenerator<any, void, unknown>;
         /**
          * Creates a new stored user-defined process at the back-end.
          *
@@ -2253,9 +2387,10 @@ declare module OpenEO {
          * @param {?string} [plan=null] - The billing plan to use for this computation.
          * @param {?number} [budget=null] - The maximum budget allowed to spend for this computation.
          * @param {?AbortController} [abortController=null] - An AbortController object that can be used to cancel the processing request.
+         * @param {object.<string, *>} [additional={}] - Other parameters to pass for the batch job, e.g. `log_level`.
          * @returns {Promise<SyncResult>} - An object with the data and some metadata.
          */
-        computeResult(process: Process, plan?: string | null, budget?: number | null, abortController?: AbortController | null): Promise<SyncResult>;
+        computeResult(process: Process, plan?: string | null, budget?: number | null, abortController?: AbortController | null, additional?: object<string, any>): Promise<SyncResult>;
         /**
          * Executes a process synchronously and downloads to result the given path.
          *
@@ -2275,7 +2410,7 @@ declare module OpenEO {
          */
         downloadResult(process: Process, targetPath: string, plan?: string | null, budget?: number | null, abortController?: AbortController | null): Promise<void>;
         /**
-         * Lists all batch jobs of the authenticated user.
+         * List all batch jobs of the authenticated user.
          *
          * @async
          * @param {Array.<Job>} [oldJobs=[]] - A list of existing jobs to update.
@@ -2283,6 +2418,16 @@ declare module OpenEO {
          * @throws {Error}
          */
         listJobs(oldJobs?: Array<Job>): Promise<ResponseArray<Job>>;
+        /**
+         * Paginate through the batch jobs of the authenticated user.
+         *
+         * @async
+         * @param {?number} [limit=50] - The number of jobs per request/page as integer. If `null`, requests all jobs.
+         * @param {Array.<Job>} [oldJobs=[]] - A list of existing jobs to update.
+         * @yields {Promise<ResponseArray.<Job>>} A list of jobs.
+         * @throws {Error}
+         */
+        paginateJobs(limit?: number | null, oldJobs?: Array<Job>): AsyncGenerator<any, void, unknown>;
         /**
          * Creates a new batch job at the back-end.
          *
@@ -2292,7 +2437,7 @@ declare module OpenEO {
          * @param {?string} [description=null] - A description for the batch job.
          * @param {?string} [plan=null] - The billing plan to use for this batch job.
          * @param {?number} [budget=null] - The maximum budget allowed to spend for this batch job.
-         * @param {object.<string, *>} [additional={}] - Proprietary parameters to pass for the batch job.
+         * @param {object.<string, *>} [additional={}] - Other parameters to pass for the batch job, e.g. `log_level`.
          * @returns {Promise<Job>} The stored batch job.
          * @throws {Error}
          */
@@ -2307,7 +2452,7 @@ declare module OpenEO {
          */
         getJob(id: string): Promise<Job>;
         /**
-         * Lists all secondary web services of the authenticated user.
+         * List all secondary web services of the authenticated user.
          *
          * @async
          * @param {Array.<Service>} [oldServices=[]] - A list of existing services to update.
@@ -2315,6 +2460,16 @@ declare module OpenEO {
          * @throws {Error}
          */
         listServices(oldServices?: Array<Service>): Promise<ResponseArray<Job>>;
+        /**
+         * Paginate through the secondary web services of the authenticated user.
+         *
+         * @async
+         * @param {?number} [limit=50] - The number of services per request/page as integer. If `null` (default), requests all services.
+         * @param {Array.<Service>} [oldServices=[]] - A list of existing services to update.
+         * @yields {Promise<ResponseArray.<Job>>} A list of services.
+         * @throws {Error}
+         */
+        paginateServices(limit?: number | null, oldServices?: Array<Service>): AsyncGenerator<any, void, unknown>;
         /**
          * Creates a new secondary web service at the back-end.
          *
@@ -2327,11 +2482,11 @@ declare module OpenEO {
          * @param {object.<string, *>} [configuration={}] - Configuration parameters to pass to the service.
          * @param {?string} [plan=null] - The billing plan to use for this service.
          * @param {?number} [budget=null] - The maximum budget allowed to spend for this service.
-         * @param {object.<string, *>} [additional={}] - Proprietary parameters to pass for the batch job.
+         * @param {object.<string, *>} [additional={}] - Other parameters to pass for the service, e.g. `log_level`.
          * @returns {Promise<Service>} The stored service.
          * @throws {Error}
          */
-        createService(process: Process, type: string, title?: string | null, description?: string | null, enabled?: boolean, configuration?: any, plan?: string | null, budget?: number | null, additional?: object<string, any>): Promise<Service>;
+        createService(process: Process, type: string, title?: string | null, description?: string | null, enabled?: boolean, configuration?: object<string, any>, plan?: string | null, budget?: number | null, additional?: object<string, any>): Promise<Service>;
         /**
          * Get all information about a secondary web service.
          *
@@ -2347,21 +2502,46 @@ declare module OpenEO {
          * Adds links and federation:missing.
          *
          * @protected
-         * @param {Array} arr
+         * @param {Array.<*>} arr
          * @param {object.<string, *>} response
+         * @param {string} selfUrl
          * @returns {ResponseArray}
          */
-        protected _toResponseArray(arr: any[], response: object<string, any>): any;
+        protected _toResponseArray(arr: Array<any>, response: object<string, any>, selfUrl: string): ResponseArray;
         /**
          * Get the a link with the given rel type.
          *
          * @protected
          * @param {Array.<Link>} links - An array of links.
-         * @param {string} rel - Relation type to find, defaults to `next`.
+         * @param {string|Array.<string>} rel - Relation type(s) to find.
          * @returns {string | null}
          * @throws {Error}
          */
-        protected _getLinkHref(links: Array<Link>, rel?: string): string | null;
+        protected _getLinkHref(links: Array<Link>, rel: string | Array<string>): string | null;
+        /**
+         * Get the URL of the next page from a response.
+         *
+         * @protected
+         * @param {AxiosResponse} response
+         * @returns {string | null}
+         */
+        protected _getNextLink(response: AxiosResponse): string | null;
+        /**
+         * Add a self link to the response if not present.
+         *
+         * @param {object} data - The body of the response as an object.
+         * @param {string} selfUrl - The URL of the current request.
+         * @returns {object} The modified object.
+         */
+        _addSelfLink(data: object, selfUrl: string): object;
+        /**
+         * Makes all links in the list absolute.
+         *
+         * @param {Array.<Link>} links - An array of links.
+         * @param {?string|AxiosResponse} [base=null] - The base url to use for relative links, or an response to derive the url from.
+         * @returns {Array.<Link>}
+         */
+        makeLinksAbsolute(links: Array<Link>, base?: (string | AxiosResponse) | null): Array<Link>;
         /**
          * Sends a GET request.
          *
@@ -2370,11 +2550,12 @@ declare module OpenEO {
          * @param {string} path
          * @param {object.<string, *>} query
          * @param {string} responseType - Response type according to axios, defaults to `json`.
+         * @param {?AbortController} [abortController=null] - An AbortController object that can be used to cancel the request.
          * @returns {Promise<AxiosResponse>}
          * @throws {Error}
          * @see https://github.com/axios/axios#request-config
          */
-        protected _get(path: string, query: object<string, any>, responseType: string): Promise<AxiosResponse>;
+        protected _get(path: string, query: object<string, any>, responseType: string, abortController?: AbortController | null): Promise<AxiosResponse>;
         /**
          * Sends a POST request.
          *
@@ -2432,6 +2613,13 @@ declare module OpenEO {
          * @throws {Error}
          */
         download(url: string, authorize: boolean): Promise<Readable | Blob>;
+        /**
+         * Get the authorization header for requests.
+         *
+         * @protected
+         * @returns {object.<string, string>}
+         */
+        protected _getAuthHeaders(): object<string, string>;
         /**
          * Sends a HTTP request.
          *
@@ -2548,7 +2736,7 @@ declare module OpenEO {
         status: number;
         statusText: string;
         headers: any;
-    config: object<string, any>;
+        config: object<string, any>;
         request: any;
     };
     export type BillingPlan = {
@@ -2576,6 +2764,10 @@ declare module OpenEO {
     export type Collections = {
         collections: Array<Collection>;
         links: Array<Link>;
+        /**
+         * "federation:missing"] A list of backends from the federation that are missing in the response data.
+         */
+	"federation:missing": Array<string>;
     };
     export type Collection = object<string, any>;
     export type FileTypesAPI = {
@@ -2687,7 +2879,7 @@ declare module OpenEO {
         level: string;
         message: string;
         data: any;
-        path: Array<object<string, string>>;
+        path: Array<object<string, string | null>>;
         links: Array<Link>;
     };
     /**
@@ -2756,17 +2948,58 @@ declare module OpenEO {
          * EXPERIMENTAL!
          */
         namespaces: Array<string> | null;
+        /**
+         * "federation:missing"] A list of backends from the federation that are missing in the response data.
+         */
+	"federation:missing": Array<string>;
     };
     /**
      * An openEO processing chain.
      */
     export type Process = object<string, any>;
+    /**
+     * An array of backends in the federation.
+     */
+    export type FederationBackend = {
+        /**
+         * URL to the versioned API endpoint of the back-end.
+         */
+        url: string;
+        /**
+         * Name of the back-end.
+         */
+        title: string;
+        /**
+         * A description of the back-end and its specifics.
+         */
+        description: string;
+        /**
+         * Current status of the back-ends (online or offline).
+         */
+        status: string;
+        /**
+         * The time at which the status of the back-end was checked last, formatted as a RFC 3339 date-time.
+         */
+        last_status_check: string;
+        /**
+         * If the `status` is `offline`: The time at which the back-end was checked and available the last time. Otherwise, this is equal to the property `last_status_check`. Formatted as a RFC 3339 date-time.
+         */
+        last_successful_check: string;
+        /**
+         * Declares the back-end to be experimental.
+         */
+        experimental: boolean;
+        /**
+         * Declares the back-end to be deprecated.
+         */
+        deprecated: boolean;
+    };
     /**
      * An array, but enriched with additional details from an openEO API response.
      *
-     * Adds two properties: `links` and `federation:missing`.
+     * Adds three properties: `url`, `links` and `federation:missing`.
      */
-    export type ResponseArray = Array;
+    export type ResponseArray = any;
     export type ServiceType = object<string, any>;
     export type SyncResult = {
         /**
@@ -2805,7 +3038,12 @@ declare module OpenEO {
         budget: number | null;
         links: Array<Link> | null;
     };
-
+    /**
+     * An array, but enriched with additional details from an openEO API response.
+     *
+     * Adds the property `federation:backends`.
+     */
+    export type ValidationResult = any;
 }
 
 export = OpenEO;