@openeo/js-client 2.7.0 → 2.9.0

package/openeo.d.ts

@@ -3,8 +3,9 @@
 import { User, UserManager } from 'oidc-client';
 import { ProcessRegistry } from '@openeo/js-commons';
 import { Readable } from 'stream';
+import axios from 'axios';
 
-declare module OpenEO {
+declare namespace OpenEO {
     /**
      * The base class for authentication providers such as Basic and OpenID Connect.
      *
@@ -123,12 +124,12 @@ declare module OpenEO {
          * @protected
          * @type {object.<string, string>}
          */
-        protected apiToClientNames: object<string, string>;
+        protected apiToClientNames: Record<string, string>;
         /**
          * @protected
          * @type {object.<string, string>}
          */
-        protected clientToApiNames: object<string, string>;
+        protected clientToApiNames: Record<string, string>;
         /**
          * @protected
          * @type {number}
@@ -140,20 +141,20 @@ declare module OpenEO {
          * @protected
          * @type {object.<string, *>}
          */
-        protected extra: object<string, any>;
+        protected extra: Record<string, any>;
         /**
          * Returns a JSON serializable representation of the data that is API compliant.
          *
          * @returns {object.<string, *>}
          */
-        toJSON(): object<string, any>;
+        toJSON(): Record<string, any>;
         /**
          * Converts the data from an API response into data suitable for our JS client models.
          *
          * @param {object.<string, *>} metadata - JSON object originating from an API response.
          * @returns {BaseEntity} Returns the object itself.
          */
-        setAll(metadata: object<string, any>): BaseEntity;
+        setAll(metadata: Record<string, any>): BaseEntity;
         /**
          * Returns the age of the data in seconds.
          *
@@ -165,7 +166,7 @@ declare module OpenEO {
          *
          * @returns {object.<string, *>}
          */
-        getAll(): object<string, any>;
+        getAll(): Record<string, any>;
         /**
          * Get a value from the additional data that is not part of the core model, i.e. from proprietary extensions.
          *
@@ -180,7 +181,7 @@ declare module OpenEO {
          * @returns {object.<string, *>}
          * @protected
          */
-        protected _convertToRequest(parameters: object<string, any>): object<string, any>;
+        protected _convertToRequest(parameters: Record<string, any>): Record<string, any>;
         /**
          * Checks whether a features is supported by the API.
          *
@@ -204,7 +205,7 @@ declare module OpenEO {
          * @type {object}
          * @static
          */
-        static axios: object;
+        static axios: typeof axios;
         /**
          * Returns the name of the Environment, `Node` or `Browser`.
          *
@@ -279,7 +280,7 @@ declare module OpenEO {
          * @param {string} targetFolder
          * @throws {Error}
          */
-        static downloadResults(con: Connection, assets: Array<object<string, any>>, targetFolder: string): Promise<void>;
+        static downloadResults(con: Connection, assets: Array<Record<string, any>>, targetFolder: string): Promise<void>;
         /**
          * Streams data into a file (node) or offers data to download (browser).
          *
@@ -329,7 +330,7 @@ declare module OpenEO {
          * @param {object.<string, *>} data - A capabilities response compatible to the API specification for `GET /`.
          * @throws {Error}
          */
-        constructor(data: object<string, any>);
+        constructor(data: Record<string, any>);
         /**
          * @private
          * @type {object.<string, *>}
@@ -366,7 +367,7 @@ declare module OpenEO {
          *
          * @returns {object.<string, *>} - A reference to the capabilities response.
          */
-        toJSON(): object<string, any>;
+        toJSON(): Record<string, any>;
         /**
          * Returns the openEO API version implemented by the back-end.
          *
@@ -409,6 +410,20 @@ declare module OpenEO {
          * @returns {Array.<FederationBackend>} Array of backends
          */
         listFederation(): Array<FederationBackend>;
+        /**
+         * Given just the string ID of a backend within the federation, returns that backend's full details as a FederationBackend object.
+         *
+         * @param {string} backendId - The ID of a backend within the federation
+         * @returns {FederationBackend} The full details of the backend
+         */
+        getFederationBackend(backendId: string): FederationBackend;
+        /**
+         * Given a list of string IDs of backends within the federation, returns those backends' full details as FederationBackend objects.
+         *
+         * @param {Array<string>} backendIds - The IDs of backends within the federation
+         * @returns {Array<FederationBackend>} An array in the same order as the input, containing for each position the full details of the backend
+         */
+        getFederationBackends(backendIds: Array<string>): Array<FederationBackend>;
         /**
          * Lists all supported features.
          *
@@ -422,6 +437,15 @@ declare module OpenEO {
          * @returns {boolean} `true` if the feature is supported, otherwise `false`.
          */
         hasFeature(methodName: string): boolean;
+        /**
+         * Check whether a conformance class is supported by the back-end.
+         *
+         * Use `*` as a wildcard character for e.g. version numbers.
+         *
+         * @param {string|Array.<string>} uris - Conformance class URI(s) - any of them must match.
+         * @returns {boolean} `true` if any of the conformance classes is supported, otherwise `false`.
+         */
+        hasConformance(uris: string | Array<string>): boolean;
         /**
          * Get the billing currency.
          *
@@ -442,6 +466,8 @@ declare module OpenEO {
          * @returns {AxiosResponse}
          */
         protected migrate(response: AxiosResponse): AxiosResponse;
+
+        static Conformance: Record<string, string | Array<string>>;
     }
     /**
      * The Authentication Provider for OpenID Connect.
@@ -480,7 +506,7 @@ declare module OpenEO {
          * @throws {Error}
          * @see https://github.com/IdentityModel/oidc-client-js/wiki#other-optional-settings
          */
-        static signinCallback(provider?: OidcProvider, options?: object<string, any>): Promise<User | null>;
+        static signinCallback(provider?: OidcProvider, options?: Record<string, any>): Promise<User | null>;
         /**
          * Creates a new OidcProvider instance to authenticate using OpenID Connect.
          *
@@ -580,7 +606,7 @@ declare module OpenEO {
          * @see https://github.com/IdentityModel/oidc-client-js/wiki#other-optional-settings
          * @see {OidcProvider#refreshTokenScope}
          */
-        login(options?: object<string, any>, requestRefreshToken?: boolean): Promise<void>;
+        login(options?: Record<string, any>, requestRefreshToken?: boolean): Promise<void>;
         /**
          * Returns the options for the OIDC client library.
          *
@@ -592,7 +618,7 @@ declare module OpenEO {
          * @returns {object.<string, *>}
          * @see {OidcProvider#refreshTokenScope}
          */
-        protected getOptions(options?: object<string, any>, requestRefreshToken?: boolean): object<string, any>;
+        protected getOptions(options?: Record<string, any>, requestRefreshToken?: boolean): Record<string, any>;
         /**
          * Get the response_type based on the grant type.
          *
@@ -672,13 +698,13 @@ declare module OpenEO {
          *
          * @returns {object.<string, FileType>}
          */
-        getInputTypes(): object<string, FileType>;
+        getInputTypes(): Record<string, FileType>;
         /**
          * Returns the output file formats.
          *
          * @returns {object.<string, FileType>}
          */
-        getOutputTypes(): object<string, FileType>;
+        getOutputTypes(): Record<string, FileType>;
         /**
          * Returns a single input file format for a given identifier.
          *
@@ -1056,7 +1082,7 @@ declare module OpenEO {
          * @returns {Promise<object.<string, *>>} The JSON-based response compatible to the API specification, but also including a `costs` property if present in the headers.
          * @throws {Error}
          */
-        getResultsAsStac(): Promise<object<string, any>>;
+        getResultsAsStac(): Promise<Record<string, any>>;
         /**
          * Retrieves download links.
          *
@@ -1123,14 +1149,14 @@ declare module OpenEO {
          * @readonly
          * @type {?Array.<object.<string, *>>}
          */
-        public readonly parameters: Array<object<string, any>> | null;
+        public readonly parameters: Array<Record<string, any>> | null;
         /**
          * Description of the data that is returned by this process.
          * @public
          * @readonly
          * @type {?object.<string, *>}
          */
-        public readonly returns: object<string, any> | null;
+        public readonly returns: Record<string, any> | null;
         /**
          * Specifies that the process or parameter is deprecated with the potential to be removed in any of the next versions.
          * @public
@@ -1151,13 +1177,13 @@ declare module OpenEO {
          * @readonly
          * @type {?object.<string, *>}
          */
-        public readonly exceptions: object<string, any> | null;
+        public readonly exceptions: Record<string, any> | null;
         /**
          * @public
          * @readonly
          * @type {?Array.<object.<string, *>>}
          */
-        public readonly examples: Array<object<string, any>> | null;
+        public readonly examples: Array<Record<string, any>> | null;
         /**
          * Links related to this process.
          * @public
@@ -1170,7 +1196,7 @@ declare module OpenEO {
          * @readonly
          * @type {?object.<string, *>}
          */
-        public readonly processGraph: object<string, any> | null;
+        public readonly processGraph: Record<string, any> | null;
         /**
          * Updates the data stored in this object by requesting the process graph metadata from the back-end.
          *
@@ -1268,14 +1294,14 @@ declare module OpenEO {
          * @readonly
          * @type {?object.<string, *>}
          */
-        public readonly configuration: object<string, any> | null;
+        public readonly configuration: Record<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> | null;
+        public readonly attributes: Record<string, any> | null;
         /**
          * Date and time of creation, formatted as a RFC 3339 date-time.
          * @public
@@ -1332,7 +1358,7 @@ declare module OpenEO {
             title: string;
             description: string;
             enabled: boolean;
-            configuration: object<string, any>;
+            configuration: Record<string, any>;
             plan: string;
             budget: number;
         }): Promise<Service>;
@@ -1415,7 +1441,7 @@ declare module OpenEO {
          * @param {string} description - A description for the parameter
          * @param {*} defaultValue - An optional default Value for the parameter. If set, make the parameter optional. If not set, the parameter is required. Defaults to `undefined`.
          */
-        constructor(name: string, schema?: object<string, any> | string, description?: string, defaultValue?: any);
+        constructor(name: string, schema?: Record<string, any> | string, description?: string, defaultValue?: any);
         name: string;
         spec: {
             name: string;
@@ -1427,7 +1453,7 @@ declare module OpenEO {
          *
          * @returns {object.<string, *>}
          */
-        toJSON(): object<string, any>;
+        toJSON(): Record<string, any>;
         /**
          * Returns the reference object for this parameter.
          *
@@ -1483,7 +1509,7 @@ declare module OpenEO {
         /**
          * @type {object.<string, *>}
          */
-        tree: object<string, any>;
+        tree: Record<string, any>;
         /**
          * @type {Builder | null}
          */
@@ -1512,7 +1538,7 @@ declare module OpenEO {
          * @returns {object.<string, *>}
          * @throws {Error}
          */
-        protected parseTree(tree: object<string, any>): object<string, any>;
+        protected parseTree(tree: Record<string, any>): Record<string, any>;
         /**
          * Gets the reference for a value, e.g. from_node or from_parameter.
          *
@@ -1530,10 +1556,10 @@ declare module OpenEO {
          * @returns {BuilderNode}
          * @throws {Error}
          */
-        addOperatorProcess(operator: string, left: number | object<string, any>, right: number | object<string, any>): BuilderNode;
+        addOperatorProcess(operator: string, left: number | Record<string, any>, right: number | Record<string, any>): BuilderNode;
     }
     export namespace Formula {
-        let operatorMapping: object<string, string>;
+        let operatorMapping: Record<string, string>;
     }
     /**
      * A class that represents a process node and also a result from a process.
@@ -1548,7 +1574,7 @@ declare module OpenEO {
          * @param {?string} [processDescription=null]
          * @param {?string} [processNamespace=null]
          */
-        constructor(parent: Builder, processId: string, processArgs?: object<string, any>, processDescription?: string | null, processNamespace?: string | null);
+        constructor(parent: Builder, processId: string, processArgs?: Record<string, any>, processDescription?: string | null, processNamespace?: string | null);
         /**
          * The parent builder.
          * @type {Builder}
@@ -1574,7 +1600,7 @@ declare module OpenEO {
          * The arguments for the process.
          * @type {object.<string, *>}
          */
-        arguments: object<string, any>;
+        arguments: Record<string, any>;
         /**
          * @ignore
          */
@@ -1591,13 +1617,13 @@ declare module OpenEO {
          * @returns {object.<string, *>}
          * @throws {Error}
          */
-        namedArguments(processArgs: Array<object<string, any>>): object<string, any>;
+        namedArguments(processArgs: Array<Record<string, any>>): Record<string, any>;
         /**
          * Checks the arguments given for parameters and add them to the process.
          *
          * @param {object.<string, *>|Array} processArgs
          */
-        addParametersToProcess(processArgs: object<string, any> | any[]): void;
+        addParametersToProcess(processArgs: Record<string, any> | any[]): void;
         /**
          * Gets/Sets a description for the node.
          *
@@ -1643,13 +1669,13 @@ declare module OpenEO {
          * @returns {object.<string, *>}
          * @throws {Error}
          */
-        protected exportCallback(arg: Function, name: string): object<string, any>;
+        protected exportCallback(arg: Function, name: string): Record<string, any>;
         /**
          * Returns a JSON serializable representation of the data that is API compliant.
          *
          * @returns {object.<string, *>}
          */
-        toJSON(): object<string, any>;
+        toJSON(): Record<string, any>;
         /**
          * Returns the reference object for this node.
          *
@@ -1824,7 +1850,7 @@ declare module OpenEO {
          * @returns {Array.<object.<string,*>>}
          * @todo Should this also pass callback parameters from parents until root is reached?
          */
-        getParentCallbackParameters(): Array<object<string, any>>;
+        getParentCallbackParameters(): Array<Record<string, any>>;
         /**
          * Adds a parameter to the list of process parameters.
          *
@@ -1833,7 +1859,7 @@ declare module OpenEO {
          * @param {object.<string, *>} parameter - The parameter spec to add, must comply to the API.
          * @param {boolean} [root=true] - Adds the parameter to the root process if set to `true`, otherwise to the process constructed by this builder. Usually you want to add it to the root.
          */
-        addParameter(parameter: object<string, any>, root?: boolean): void;
+        addParameter(parameter: Record<string, any>, root?: boolean): void;
         /**
          * Returns the process specification for the given process identifier and namespace (or `null`).
          *
@@ -1869,7 +1895,7 @@ declare module OpenEO {
          * @param {?string} [description=null] - An optional description for the process call.
          * @returns {BuilderNode}
          */
-        process(processId: string, args?: object<string, any> | any[], description?: string | null): BuilderNode;
+        process(processId: string, args?: Record<string, any> | any[], description?: string | null): BuilderNode;
         /**
          * Returns a JSON serializable representation of the data that is API compliant.
          *
@@ -1887,6 +1913,158 @@ declare module OpenEO {
          */
         generateId(prefix?: string): string;
     }
+    /**
+     * A class to handle pagination of resources.
+     *
+     * @abstract
+     */
+    export class Pages {
+        /**
+         * Creates an instance of Pages.
+         *
+         * @param {Connection} connection
+         * @param {string} endpoint
+         * @param {string} key
+         * @param {Constructor} cls - Class
+         * @param {object} [params={}]
+         * @param {string} primaryKey
+         */
+        constructor(connection: Connection, endpoint: string, key: string, cls: Constructor, params?: object, primaryKey?: string);
+        connection: Connection;
+        nextUrl: string;
+        key: string;
+        primaryKey: string;
+        cls: Constructor;
+        params: any;
+        /**
+         * Returns true if there are more pages to fetch.
+         *
+         * @returns {boolean}
+         */
+        hasNextPage(): boolean;
+        /**
+         * Returns the next page of resources.
+         *
+         * @async
+         * @param {Array.<object>} oldObjects - Existing objects to update, if any.
+         * @param {boolean} [toArray=true] - Whether to return the objects as a simplified array or as an object with all information.
+         * @returns {Array.<object>}
+         * @throws {Error}
+         */
+        nextPage(oldObjects?: Array<object>, toArray?: boolean): Array<object>;
+        /**
+         * Ensures a variable is an array.
+         *
+         * @protected
+         * @param {*} x
+         * @returns {Array}
+         */
+        protected _ensureArray(x: any): any[];
+        /**
+         * Creates a facade for the object, if needed.
+         *
+         * @protected
+         * @param {object} obj
+         * @returns {object}
+         */
+        protected _createObject(obj: object): object;
+        /**
+         * Caches the plain objects if needed.
+         *
+         * @param {Array.<object>} objects
+         * @returns {Array.<object>}
+         */
+        _cache(objects: Array<object>): Array<object>;
+        /**
+         * Get the URL of the next page from a response.
+         *
+         * @protected
+         * @param {AxiosResponse} response
+         * @returns {string | null}
+         */
+        protected _getNextLink(response: AxiosResponse): string | null;
+        /**
+         * Makes this class asynchronously iterable.
+         *
+         * @returns {AsyncIterator}
+         */
+        [Symbol.asyncIterator](): AsyncIterator<any, any, any>;
+    }
+    /**
+     * Paginate through collections.
+     */
+    export class CollectionPages extends Pages {
+        /**
+         * Paginate through collections.
+         *
+         * @param {Connection} connection
+         * @param {?number} limit
+         */
+        constructor(connection: Connection, limit?: number | null);
+    }
+    /**
+     * Paginate through collection items.
+     */
+    export class ItemPages extends Pages {
+        /**
+         * Paginate through collection items.
+         *
+         * @param {Connection} connection
+         * @param {string} collectionId
+         * @param {object} params
+         */
+        constructor(connection: Connection, collectionId: string, params: object);
+    }
+    /**
+     * Paginate through jobs.
+     */
+    export class JobPages extends Pages {
+        /**
+         * Paginate through jobs.
+         *
+         * @param {Connection} connection
+         * @param {?number} limit
+         */
+        constructor(connection: Connection, limit?: number | null);
+    }
+    /**
+     * Paginate through processes.
+     */
+    export class ProcessPages extends Pages {
+        /**
+         * Paginate through processes.
+         *
+         * @param {Connection} connection
+         * @param {?number} limit
+         * @param {?string} namespace
+         */
+        constructor(connection: Connection, limit?: number | null, namespace?: string | null);
+        namespace: string;
+    }
+    /**
+     * Paginate through services.
+     */
+    export class ServicePages extends Pages {
+        /**
+         * Paginate through services.
+         *
+         * @param {Connection} connection
+         * @param {?number} limit
+         */
+        constructor(connection: Connection, limit?: number | null);
+    }
+    /**
+     * Paginate through user files.
+     */
+    export class UserFilePages extends Pages {
+        /**
+         * Paginate through user files.
+         *
+         * @param {Connection} connection
+         * @param {?number} limit
+         */
+        constructor(connection: Connection, limit?: number | null);
+    }
     /**
      * A connection to a back-end.
      */
@@ -1942,7 +2120,7 @@ declare module OpenEO {
          * @protected
          * @type {object.<string|Function>}
          */
-        protected listeners: object<string | Function>;
+        protected listeners: Record<string, Function>;
         /**
          * Additional options for the connection.
          *
@@ -2000,6 +2178,14 @@ declare module OpenEO {
          * @throws {Error}
          */
         listFileTypes(): Promise<FileTypes>;
+        /**
+         * List the supported output file formats.
+         *
+         * @async
+         * @returns {Promise<ProcessingParameters>} A response compatible to the API specification.
+         * @throws {Error}
+         */
+        listProcessingParameters(): Promise<ProcessingParameters>;
         /**
          * List the supported secondary service types.
          *
@@ -2007,7 +2193,7 @@ declare module OpenEO {
          * @returns {Promise<object.<string, ServiceType>>} A response compatible to the API specification.
          * @throws {Error}
          */
-        listServiceTypes(): Promise<object<string, ServiceType>>;
+        listServiceTypes(): Promise<Record<string, ServiceType>>;
         /**
          * List the supported UDF runtimes.
          *
@@ -2015,7 +2201,7 @@ declare module OpenEO {
          * @returns {Promise<object.<string, UdfRuntime>>} A response compatible to the API specification.
          * @throws {Error}
          */
-        listUdfRuntimes(): Promise<object<string, UdfRuntime>>;
+        listUdfRuntimes(): Promise<Record<string, UdfRuntime>>;
         /**
          * List all collections available on the back-end.
          *
@@ -2030,15 +2216,12 @@ declare module OpenEO {
         /**
          * 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.
+         * The collections returned always comply to the latest STAC version (currently 1.0.0).
          *
-         * @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}
+         * @returns {CollectionPages} A paged list of collections.
          */
-        paginateCollections(limit?: number | null): AsyncGenerator<any, void, unknown>;
+        paginateCollections(limit?: number | null): CollectionPages;
         /**
          * Get further information about a single collection.
          *
@@ -2051,7 +2234,7 @@ declare module OpenEO {
          */
         describeCollection(collectionId: string): Promise<Collection>;
         /**
-         * Loads items for a specific image collection.
+         * Paginate through items for a specific collection.
          *
          * May not be available for all collections.
          *
@@ -2069,10 +2252,10 @@ declare module OpenEO {
          * 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.
          * @param {?number} [limit=null] - The amount of items per request/page as integer. If `null` (default), the back-end decides.
-         * @yields {Promise<ItemCollection>} A response compatible to the API specification.
+         * @returns {Promise<ItemPages>} A response compatible to the API specification.
          * @throws {Error}
          */
-        listCollectionItems(collectionId: string, spatialExtent?: Array<number> | null, temporalExtent?: any[] | null, limit?: number | null): AsyncGenerator<any, void, unknown>;
+        listCollectionItems(collectionId: string, spatialExtent?: Array<number> | null, temporalExtent?: any[] | null, limit?: number | null): Promise<ItemPages>;
         /**
          * Normalisation of the namespace to a value that is compatible with the OpenEO specs - EXPERIMENTAL.
          *
@@ -2113,15 +2296,11 @@ 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!
          * @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}
+         * @returns {ProcessPages} A paged list of processes.
          */
-        paginateProcesses(namespace?: string | null, limit?: number | null): AsyncGenerator<any, void, unknown>;
+        paginateProcesses(namespace?: string | null, limit?: number | null): ProcessPages;
         /**
          * Get information about a single process.
          *
@@ -2281,12 +2460,10 @@ declare module OpenEO {
         /**
          * 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}
+         * @returns {ServicePages} A paged list of files.
          */
-        paginateFiles(limit?: number | null): AsyncGenerator<any, void, unknown>;
+        paginateFiles(limit?: number | null): ServicePages;
         /**
          * A callback that is executed on upload progress updates.
          *
@@ -2329,7 +2506,7 @@ declare module OpenEO {
          * @returns {object.<string, *>}
          * @protected
          */
-        protected _normalizeUserProcess(process: UserProcess | BuilderNode | object<string, any>, additional?: object<string, any>): object<string, any>;
+        protected _normalizeUserProcess(process: UserProcess | BuilderNode | Record<string, any>, additional?: Record<string, any>): Record<string, any>;
         /**
          * Validates a user-defined process at the back-end.
          *
@@ -2351,13 +2528,10 @@ declare module OpenEO {
         /**
          * 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}
+         * @returns {ProcessPages} A paged list of user-defined processes.
          */
-        paginateUserProcesses(limit?: number | null, oldProcesses?: Array<UserProcess>): AsyncGenerator<any, void, unknown>;
+        paginateUserProcesses(limit?: number | null): ProcessPages;
         /**
          * Creates a new stored user-defined process at the back-end.
          *
@@ -2390,7 +2564,7 @@ declare module OpenEO {
          * @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, additional?: object<string, any>): Promise<SyncResult>;
+        computeResult(process: Process, plan?: string | null, budget?: number | null, abortController?: AbortController | null, additional?: Record<string, any>): Promise<SyncResult>;
         /**
          * Executes a process synchronously and downloads to result the given path.
          *
@@ -2421,13 +2595,10 @@ declare module OpenEO {
         /**
          * 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}
+         * @returns {JobPages} A paged list of jobs.
          */
-        paginateJobs(limit?: number | null, oldJobs?: Array<Job>): AsyncGenerator<any, void, unknown>;
+        paginateJobs(limit?: number | null): JobPages;
         /**
          * Creates a new batch job at the back-end.
          *
@@ -2441,7 +2612,7 @@ declare module OpenEO {
          * @returns {Promise<Job>} The stored batch job.
          * @throws {Error}
          */
-        createJob(process: Process, title?: string | null, description?: string | null, plan?: string | null, budget?: number | null, additional?: object<string, any>): Promise<Job>;
+        createJob(process: Process, title?: string | null, description?: string | null, plan?: string | null, budget?: number | null, additional?: Record<string, any>): Promise<Job>;
         /**
          * Get all information about a batch job.
          *
@@ -2456,20 +2627,17 @@ declare module OpenEO {
          *
          * @async
          * @param {Array.<Service>} [oldServices=[]] - A list of existing services to update.
-         * @returns {Promise<ResponseArray.<Job>>} A list of services.
+         * @returns {Promise<ResponseArray.<Service>>} A list of services.
          * @throws {Error}
          */
-        listServices(oldServices?: Array<Service>): Promise<ResponseArray<Job>>;
+        listServices(oldServices?: Array<Service>): Promise<ResponseArray<Service>>;
         /**
          * 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}
+         * @returns {ServicePages} A paged list of services.
          */
-        paginateServices(limit?: number | null, oldServices?: Array<Service>): AsyncGenerator<any, void, unknown>;
+        paginateServices(limit?: number | null): ServicePages;
         /**
          * Creates a new secondary web service at the back-end.
          *
@@ -2486,7 +2654,7 @@ declare module OpenEO {
          * @returns {Promise<Service>} The stored service.
          * @throws {Error}
          */
-        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>;
+        createService(process: Process, type: string, title?: string | null, description?: string | null, enabled?: boolean, configuration?: Record<string, any>, plan?: string | null, budget?: number | null, additional?: Record<string, any>): Promise<Service>;
         /**
          * Get all information about a secondary web service.
          *
@@ -2496,18 +2664,6 @@ declare module OpenEO {
          * @throws {Error}
          */
         getService(id: string): Promise<Service>;
-        /**
-         * Adds additional response details to the array.
-         *
-         * Adds links and federation:missing.
-         *
-         * @protected
-         * @param {Array.<*>} arr
-         * @param {object.<string, *>} response
-         * @param {string} selfUrl
-         * @returns {ResponseArray}
-         */
-        protected _toResponseArray(arr: Array<any>, response: object<string, any>, selfUrl: string): ResponseArray;
         /**
          * Get the a link with the given rel type.
          *
@@ -2518,22 +2674,6 @@ declare module OpenEO {
          * @throws {Error}
          */
         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.
          *
@@ -2555,7 +2695,7 @@ declare module OpenEO {
          * @throws {Error}
          * @see https://github.com/axios/axios#request-config
          */
-        protected _get(path: string, query: object<string, any>, responseType: string, abortController?: AbortController | null): Promise<AxiosResponse>;
+        protected _get(path: string, query: Record<string, any>, responseType: string, abortController?: AbortController | null): Promise<AxiosResponse>;
         /**
          * Sends a POST request.
          *
@@ -2619,7 +2759,7 @@ declare module OpenEO {
          * @protected
          * @returns {object.<string, string>}
          */
-        protected _getAuthHeaders(): object<string, string>;
+        protected _getAuthHeaders(): Record<string, string>;
         /**
          * Sends a HTTP request.
          *
@@ -2640,7 +2780,7 @@ declare module OpenEO {
          * @throws {Error}
          * @see https://github.com/axios/axios
          */
-        protected _send(options: object<string, any>, abortController?: AbortController | null): Promise<AxiosResponse>;
+        protected _send(options: Record<string, any>, abortController?: AbortController | null): Promise<AxiosResponse>;
     }
     namespace Connection {
         export { oidcProviderFactoryFunction, uploadStatusCallback };
@@ -2736,7 +2876,7 @@ declare module OpenEO {
         status: number;
         statusText: string;
         headers: any;
-        config: object<string, any>;
+        config: Record<string, any>;
         request: any;
     };
     export type BillingPlan = {
@@ -2769,22 +2909,22 @@ declare module OpenEO {
          */
 	"federation:missing": Array<string>;
     };
-    export type Collection = object<string, any>;
+    export type Collection = Record<string, any>;
     export type FileTypesAPI = {
         /**
          * - File types supported to import
          */
-        input: object<string, FileType>;
+        input: Record<string, FileType>;
         /**
          * - File types supported to export
          */
-        output: object<string, FileType>;
+        output: Record<string, FileType>;
     };
     export type FileType = {
         title: string;
         description: string;
         gis_data_types: Array<string>;
-        parameters: object<string, any>;
+        parameters: Record<string, any>;
         links: Array<Link>;
     };
     /**
@@ -2805,7 +2945,7 @@ declare module OpenEO {
          */
         from_parameter: string;
     };
-    export type Item = object<string, any>;
+    export type Item = Record<string, any>;
     export type ItemCollection = {
         /**
          * - The items in the collection.
@@ -2879,7 +3019,7 @@ declare module OpenEO {
         level: string;
         message: string;
         data: any;
-        path: Array<object<string, string | null>>;
+        path: Array<Record<string, string | null>>;
         links: Array<Link>;
     };
     /**
@@ -2956,11 +3096,36 @@ declare module OpenEO {
     /**
      * An openEO processing chain.
      */
-    export type Process = object<string, any>;
+    export type Process = Record<string, any>;
+    /**
+     * A specific processing parameter.
+     */
+    type ProcessingParameter = object<string, any>;
     /**
-     * An array of backends in the federation.
+     * All types of processing parameters.
+     */
+    type ProcessingParameters = {
+        /**
+         * Processing parameters for batch jobs.
+         */
+        create_job_parameters: Array<ProcessingParameter>;
+        /**
+         * Processing parameters for secondary web services.
+         */
+        create_service_parameters: Array<ProcessingParameter>;
+        /**
+         * Processing parameters for synchronous processing.
+         */
+        create_synchronous_parameters: Array<ProcessingParameter>;
+    };
+    /**
+     * A back-end in the federation.
      */
     export type FederationBackend = {
+        /**
+         * ID of the back-end within the federation.
+         */
+        id: string;
         /**
          * URL to the versioned API endpoint of the back-end.
          */
@@ -2974,7 +3139,7 @@ declare module OpenEO {
          */
         description: string;
         /**
-         * Current status of the back-ends (online or offline).
+         * Current status of the back-end (online or offline).
          */
         status: string;
         /**
@@ -2997,10 +3162,10 @@ declare module OpenEO {
     /**
      * An array, but enriched with additional details from an openEO API response.
      *
-     * Adds three properties: `url`, `links` and `federation:missing`.
+     * Adds two properties: `links` and `federation:missing`.
      */
     export type ResponseArray = any;
-    export type ServiceType = object<string, any>;
+    export type ServiceType = Record<string, any>;
     export type SyncResult = {
         /**
          * The data as `Stream` in NodeJS environments or as `Blob` in browsers.
@@ -3019,7 +3184,7 @@ declare module OpenEO {
          */
         logs: Array<Log>;
     };
-    export type UdfRuntime = object<string, any>;
+    export type UdfRuntime = Record<string, any>;
     export type UserAccountStorage = {
         /**
          * in bytes as integer