arangojs 7.8.0 → 8.0.0

package/database.d.ts

@@ -1,4 +1,5 @@
 /// <reference types="node" />
+/// <reference types="node" />
 /**
  * ```js
  * import { Database } from "arangojs/database";
@@ -15,15 +16,15 @@ import { Readable } from "stream";
 import { Analyzer, AnalyzerDescription, CreateAnalyzerOptions } from "./analyzer";
 import { AqlLiteral, AqlQuery } from "./aql";
 import { ArangoCollection, Collection, CollectionMetadata, CollectionType, CreateCollectionOptions, DocumentCollection, EdgeCollection } from "./collection";
-import { ArangoResponseMetadata, Config, Connection, Dict, Headers, RequestOptions } from "./connection";
+import { ArangoApiResponse, Config, Connection, Headers, RequestOptions } from "./connection";
 import { ArrayCursor } from "./cursor";
 import { FoxxManifest } from "./foxx-manifest";
-import { EdgeDefinitionOptions, Graph, GraphCreateOptions, GraphInfo } from "./graph";
+import { CreateGraphOptions, EdgeDefinitionOptions, Graph, GraphInfo } from "./graph";
 import { Blob } from "./lib/blob";
 import { ArangojsResponse } from "./lib/request";
 import { Route } from "./route";
 import { Transaction } from "./transaction";
-import { ArangoSearchView, ArangoSearchViewPropertiesOptions, ViewDescription } from "./view";
+import { CreateViewOptions, View, ViewDescription } from "./view";
 /**
  * Indicates whether the given value represents a {@link Database}.
  *
@@ -43,9 +44,6 @@ export declare type TransactionCollections = {
     /**
      * An array of collections or a single collection that will be read from or
      * written to during the transaction.
-     *
-     * If ArangoDB is using the MMFiles storage engine, this option behaves
-     * exactly like `exclusive`, i.e. no other writes will run in parallel.
      */
     write?: (string | ArangoCollection)[] | string | ArangoCollection;
     /**
@@ -66,6 +64,12 @@ export declare type TransactionOptions = {
      * Default: `true`.
      */
     allowImplicit?: boolean;
+    /**
+     * If set to `true`, the request will explicitly permit ArangoDB to return a
+     * potentially dirty or stale result and arangojs will load balance the
+     * request without distinguishing between leaders and followers.
+     */
+    allowDirtyRead?: boolean;
     /**
      * Determines whether to force the transaction to write all data to disk
      * before returning.
@@ -80,25 +84,11 @@ export declare type TransactionOptions = {
      * (RocksDB only.) Determines the transaction size limit in bytes.
      */
     maxTransactionSize?: number;
-    /**
-     * (RocksDB only.) Determines the maximum number of operations after which an
-     * intermediate commit is performed automatically.
-     *
-     * @deprecated Removed in ArangoDB 3.4.
-     */
-    intermediateCommitCount?: number;
-    /**
-     * (RocksDB only.) Determine the maximum total size of operations after which
-     * an intermediate commit is performed automatically.
-     *
-     * @deprecated Removed in ArangoDB 3.4.
-     */
-    intermediateCommitSize?: number;
 };
 /**
  * Options for executing a query.
  *
- * See {@link Database.query}.
+ * See {@link Database#query}.
  */
 export declare type QueryOptions = {
     /**
@@ -265,7 +255,7 @@ export declare type QueryOptions = {
 /**
  * Options for explaining a query.
  *
- * See {@link Database.explain}.
+ * See {@link Database#explain}.
  */
 export declare type ExplainOptions = {
     /**
@@ -294,7 +284,7 @@ export declare type ExplainOptions = {
 /**
  * Details for a transaction.
  *
- * See also {@link TransactionStatus}.
+ * See also {@link transaction.TransactionStatus}.
  */
 export declare type TransactionDetails = {
     /**
@@ -455,6 +445,20 @@ export declare type ParseResult = {
      */
     ast: AstNode[];
 };
+/**
+ * Optimizer rule for AQL queries.
+ */
+export declare type QueryOptimizerRule = {
+    name: string;
+    flags: {
+        hidden: boolean;
+        clusterOnly: boolean;
+        canBeDisabled: boolean;
+        canCreateAdditionalPlans: boolean;
+        disabledByDefault: boolean;
+        enterpriseOnly: boolean;
+    };
+};
 /**
  * Information about query tracking.
  */
@@ -488,7 +492,7 @@ export declare type QueryTracking = {
 /**
  * Options for query tracking.
  *
- * See {@link Database.queryTracking}.
+ * See {@link Database#queryTracking}.
  */
 export declare type QueryTrackingOptions = {
     /**
@@ -533,7 +537,7 @@ export declare type QueryInfo = {
     /**
      * Bind parameters used in the query.
      */
-    bindVars: Dict<any>;
+    bindVars: Record<string, any>;
     /**
      * Query's running time in seconds.
      */
@@ -574,12 +578,12 @@ export declare type CreateDatabaseUser = {
     /**
      * Additional data to store with the user object.
      */
-    extra?: Dict<any>;
+    extra?: Record<string, any>;
 };
 /**
  * Options for creating a database.
  *
- * See {@link Database.createDatabase}.
+ * See {@link Database#createDatabase}.
  */
 export declare type CreateDatabaseOptions = {
     /**
@@ -604,18 +608,11 @@ export declare type CreateDatabaseOptions = {
      * database.
      */
     writeConcern?: number;
-    /**
-     * (Cluster only.) Default write concern for new collections created in this
-     * database.
-     *
-     * @deprecated Renamed to `writeConcern` in ArangoDB 3.6.
-     */
-    minReplicationFactor?: number;
 };
 /**
  * Object describing a database.
  *
- * See {@link Database.get}.
+ * See {@link Database#get}.
  */
 export declare type DatabaseInfo = {
     /**
@@ -649,13 +646,6 @@ export declare type DatabaseInfo = {
      * database.
      */
     writeConcern?: number;
-    /**
-     * (Cluster only.) Default write concern for new collections created in this
-     * database.
-     *
-     * @deprecated Renamed to `writeConcern` in ArangoDB 3.6.
-     */
-    minReplicationFactor?: number;
 };
 /**
  * Result of retrieving database version information.
@@ -695,32 +685,32 @@ export declare type AqlUserFunction = {
     /**
      * Whether the function is deterministic.
      *
-     * See {@link Database.createFunction}.
+     * See {@link Database#createFunction}.
      */
     isDeterministic: boolean;
 };
 /**
  * Options for installing the service.
  *
- * See {@link Database.installService}.
+ * See {@link Database#installService}.
  */
 export declare type InstallServiceOptions = {
     /**
      * An object mapping configuration option names to values.
      *
-     * See also {@link Database.getServiceConfiguration}.
+     * See also {@link Database#getServiceConfiguration}.
      */
-    configuration?: Dict<any>;
+    configuration?: Record<string, any>;
     /**
      * An object mapping dependency aliases to mount points.
      *
-     * See also {@link Database.getServiceDependencies}.
+     * See also {@link Database#getServiceDependencies}.
      */
-    dependencies?: Dict<string>;
+    dependencies?: Record<string, string>;
     /**
      * Whether the service should be installed in development mode.
      *
-     * See also {@link Database.setServiceDevelopmentMode}.
+     * See also {@link Database#setServiceDevelopmentMode}.
      *
      * Default: `false`
      */
@@ -743,25 +733,25 @@ export declare type InstallServiceOptions = {
 /**
  * Options for replacing a service.
  *
- * See {@link Database.replaceService}.
+ * See {@link Database#replaceService}.
  */
 export declare type ReplaceServiceOptions = {
     /**
      * An object mapping configuration option names to values.
      *
-     * See also {@link Database.getServiceConfiguration}.
+     * See also {@link Database#getServiceConfiguration}.
      */
-    configuration?: Dict<any>;
+    configuration?: Record<string, any>;
     /**
      * An object mapping dependency aliases to mount points.
      *
-     * See also {@link Database.getServiceDependencies}.
+     * See also {@link Database#getServiceDependencies}.
      */
-    dependencies?: Dict<string>;
+    dependencies?: Record<string, string>;
     /**
      * Whether the service should be installed in development mode.
      *
-     * See also {@link Database.setServiceDevelopmentMode}.
+     * See also {@link Database#setServiceDevelopmentMode}.
      *
      * Default: `false`
      */
@@ -798,25 +788,25 @@ export declare type ReplaceServiceOptions = {
 /**
  * Options for upgrading a service.
  *
- * See {@link Database.upgradeService}.
+ * See {@link Database#upgradeService}.
  */
 export declare type UpgradeServiceOptions = {
     /**
      * An object mapping configuration option names to values.
      *
-     * See also {@link Database.getServiceConfiguration}.
+     * See also {@link Database#getServiceConfiguration}.
      */
-    configuration?: Dict<any>;
+    configuration?: Record<string, any>;
     /**
      * An object mapping dependency aliases to mount points.
      *
-     * See also {@link Database.getServiceDependencies}.
+     * See also {@link Database#getServiceDependencies}.
      */
-    dependencies?: Dict<string>;
+    dependencies?: Record<string, string>;
     /**
      * Whether the service should be installed in development mode.
      *
-     * See also {@link Database.setServiceDevelopmentMode}.
+     * See also {@link Database#setServiceDevelopmentMode}.
      *
      * Default: `false`
      */
@@ -853,7 +843,7 @@ export declare type UpgradeServiceOptions = {
 /**
  * Options for uninstalling a service.
  *
- * See {@link Database.uninstallService}.
+ * See {@link Database#uninstallService}.
  */
 export declare type UninstallServiceOptions = {
     /**
@@ -891,7 +881,7 @@ export declare type ServiceSummary = {
      * Service dependencies the service expects to be able to match as a mapping
      * from dependency names to versions the service is compatible with.
      */
-    provides: Dict<string>;
+    provides: Record<string, string>;
     /**
      * Whether development mode is enabled for this service.
      */
@@ -944,11 +934,11 @@ export declare type ServiceInfo = {
         /**
          * Configuration values set for this service.
          */
-        configuration: Dict<any>;
+        configuration: Record<string, any>;
         /**
          * Service dependency configuration of this service.
          */
-        dependencies: Dict<string>;
+        dependencies: Record<string, string>;
     };
 };
 /**
@@ -1132,26 +1122,38 @@ export declare type ServiceTestXunitTest = ["testcase", {
     classname: string;
     name: string;
     time: number;
-}] | ["testcase", {
-    classname: string;
-    name: string;
-    time: number;
-}, ["failure", {
-    message: string;
-    type: string;
-}, string]];
+}] | [
+    "testcase",
+    {
+        classname: string;
+        name: string;
+        time: number;
+    },
+    [
+        "failure",
+        {
+            message: string;
+            type: string;
+        },
+        string
+    ]
+];
 /**
  * Test results for a Foxx service's tests in XUnit format using the JSONML
  * representation.
  */
-export declare type ServiceTestXunitReport = ["testsuite", {
-    timestamp: number;
-    tests: number;
-    errors: number;
-    failures: number;
-    skip: number;
-    time: number;
-}, ...ServiceTestXunitTest[]];
+export declare type ServiceTestXunitReport = [
+    "testsuite",
+    {
+        timestamp: number;
+        tests: number;
+        errors: number;
+        failures: number;
+        skip: number;
+        time: number;
+    },
+    ...ServiceTestXunitTest[]
+];
 /**
  * Test results for a Foxx service's tests in TAP format.
  */
@@ -1305,18 +1307,18 @@ export declare class Database {
     protected _analyzers: Map<string, Analyzer>;
     protected _collections: Map<string, Collection<any>>;
     protected _graphs: Map<string, Graph>;
-    protected _views: Map<string, ArangoSearchView>;
+    protected _views: Map<string, View>;
     /**
      * Creates a new `Database` instance with its own connection pool.
      *
-     * See also {@link Database.database}.
+     * See also {@link Database#database}.
      *
      * @param config - An object with configuration options.
      *
      * @example
      * ```js
      * const db = new Database({
-     *   url: "http://localhost:8529",
+     *   url: "http://127.0.0.1:8529",
      *   databaseName: "my_database",
      *   auth: { username: "admin", password: "hunter2" },
      * });
@@ -1326,18 +1328,22 @@ export declare class Database {
     /**
      * Creates a new `Database` instance with its own connection pool.
      *
-     * See also {@link Database.database}.
+     * See also {@link Database#database}.
      *
      * @param url - Base URL of the ArangoDB server or list of server URLs.
-     * Equivalent to the `url` option in {@link Config}.
+     * Equivalent to the `url` option in {@link connection.Config}.
      *
      * @example
      * ```js
-     * const db = new Database("http://localhost:8529", "my_database");
+     * const db = new Database("http://127.0.0.1:8529", "my_database");
      * db.useBasicAuth("admin", "hunter2");
      * ```
      */
     constructor(url: string | string[], name?: string);
+    /**
+     * @internal
+     */
+    constructor(database: Database, name?: string);
     /**
      * @internal
      *
@@ -1366,7 +1372,7 @@ export declare class Database {
      */
     version(details?: boolean): Promise<VersionInfo>;
     /**
-     * Returns a new {@link Route} instance for the given path (relative to the
+     * Returns a new {@link route.Route} instance for the given path (relative to the
      * database) that can be used to perform arbitrary HTTP requests.
      *
      * @param path - The database-relative URL of the route. Defaults to the
@@ -1401,19 +1407,22 @@ export declare class Database {
      * @param transform - An optional function to transform the low-level
      * response object to a more useful return value.
      */
-    request<T = ArangojsResponse>(options: RequestOptions & {
+    request<T = any>(options: RequestOptions & {
         absolutePath?: boolean;
-    }, transform?: (res: ArangojsResponse) => T): Promise<T>;
+    }, transform?: false | ((res: ArangojsResponse) => T)): Promise<T>;
     /**
      * Updates the URL list by requesting a list of all coordinators in the
      * cluster and adding any endpoints not initially specified in the
-     * {@link Config}.
+     * {@link connection.Config}.
      *
      * For long-running processes communicating with an ArangoDB cluster it is
      * recommended to run this method periodically (e.g. once per hour) to make
      * sure new coordinators are picked up correctly and can be used for
      * fail-over or load balancing.
      *
+     * @param overwrite - If set to `true`, the existing host list will be
+     * replaced instead of extended.
+     *
      * @example
      * ```js
      * const db = new Database();
@@ -1424,10 +1433,10 @@ export declare class Database {
      *
      * // later
      * clearInterval(interval);
-     * db.close();
+     * system.close();
      * ```
      */
-    acquireHostList(): Promise<void>;
+    acquireHostList(overwrite?: boolean): Promise<void>;
     /**
      * Closes all active connections of this database instance.
      *
@@ -1449,7 +1458,7 @@ export declare class Database {
      *     REMOVE session IN ${sessions}
      *   `);
      *   // Making sure to close the connections because they're no longer used
-     *   db.close();
+     *   system.close();
      * }, 1000 * 60 * 60);
      * ```
      */
@@ -1466,7 +1475,7 @@ export declare class Database {
      * @example
      * ```js
      * const db = new Database({ loadBalancingStrategy: "ROUND_ROBIN" });
-     * await db.acquireHostList();
+     * await system.acquireHostList();
      * const analyzer = db.analyzer("my-analyzer");
      * await analyzer.create();
      * await db.waitForPropagation(
@@ -1488,33 +1497,13 @@ export declare class Database {
     /**
      * Sets the limit for the number of values of the most recently received
      * server-reported queue times that can be accessed using
-     * {@link Database.queueTime}.
+     * {@link Database#queueTime}.
      *
      * @param responseQueueTimeSamples - Number of values to maintain.
      */
     setResponseQueueTimeSamples(responseQueueTimeSamples: number): void;
     /**
-     * Updates the `Database` instance and its connection string to use the given
-     * `databaseName`, then returns itself.
-     *
-     * **Note**: This also affects all collections, cursors and other arangojs
-     * objects originating from this database object, which may cause unexpected
-     * results.
-     *
-     * @param databaseName - Name of the database to use.
-     *
-     * @deprecated Use {@link Database.database} instead.
-     *
-     * @example
-     * ```js
-     * const systemDb = new Database();
-     * // systemDb.useDatabase("my_database"); // deprecated
-     * const myDb = systemDb.database("my_database");
-     * ```
-     */
-    useDatabase(databaseName: string): this;
-    /**
-     * Updates the `Database` instance's `authorization` header to use Basic
+     * Updates the underlying connection's `authorization` header to use Basic
      * authentication with the given `username` and `password`, then returns
      * itself.
      *
@@ -1524,15 +1513,13 @@ export declare class Database {
      * @example
      * ```js
      * const db = new Database();
-     * db.useDatabase("test");
      * db.useBasicAuth("admin", "hunter2");
-     * // The database instance now uses the database "test"
      * // with the username "admin" and password "hunter2".
      * ```
      */
     useBasicAuth(username?: string, password?: string): this;
     /**
-     * Updates the `Database` instance's `authorization` header to use Bearer
+     * Updates the underlying connection's `authorization` header to use Bearer
      * authentication with the given authentication `token`, then returns itself.
      *
      * @param token - The token to authenticate with.
@@ -1556,9 +1543,7 @@ export declare class Database {
      * @example
      * ```js
      * const db = new Database();
-     * db.useDatabase("test");
      * await db.login("admin", "hunter2");
-     * // The database instance now uses the database "test"
      * // with an authentication token for the "admin" user.
      * ```
      */
@@ -1567,7 +1552,7 @@ export declare class Database {
      * Creates a new `Database` instance for the given `databaseName` that
      * shares this database's connection pool.
      *
-     * See also {@link Database.constructor}.
+     * See also {@link Database:constructor}.
      *
      * @param databaseName - Name of the database.
      *
@@ -1614,8 +1599,6 @@ export declare class Database {
      *   users: [{ username: "root" }]
      * });
      * // the database has been created
-     * db.useDatabase("mydb");
-     * db.useBasicAuth("root", "");
      * ```
      */
     createDatabase(databaseName: string, options?: CreateDatabaseOptions): Promise<Database>;
@@ -1631,16 +1614,14 @@ export declare class Database {
      * const db = new Database();
      * const info = await db.createDatabase("mydb", [{ username: "root" }]);
      * // the database has been created
-     * db.useDatabase("mydb");
-     * db.useBasicAuth("root", "");
      * ```
      */
     createDatabase(databaseName: string, users: CreateDatabaseUser[]): Promise<Database>;
     /**
      * Fetches all databases from the server and returns an array of their names.
      *
-     * See also {@link Database.databases} and
-     * {@link Database.listUserDatabases}.
+     * See also {@link Database#databases} and
+     * {@link Database#listUserDatabases}.
      *
      * @example
      * ```js
@@ -1654,8 +1635,8 @@ export declare class Database {
      * Fetches all databases accessible to the active user from the server and
      * returns an array of their names.
      *
-     * See also {@link Database.userDatabases} and
-     * {@link Database.listDatabases}.
+     * See also {@link Database#userDatabases} and
+     * {@link Database#listDatabases}.
      *
      * @example
      * ```js
@@ -1669,8 +1650,8 @@ export declare class Database {
      * Fetches all databases from the server and returns an array of `Database`
      * instances for those databases.
      *
-     * See also {@link Database.listDatabases} and
-     * {@link Database.userDatabases}.
+     * See also {@link Database#listDatabases} and
+     * {@link Database#userDatabases}.
      *
      * @example
      * ```js
@@ -1684,8 +1665,8 @@ export declare class Database {
      * Fetches all databases accessible to the active user from the server and
      * returns an array of `Database` instances for those databases.
      *
-     * See also {@link Database.listUserDatabases} and
-     * {@link Database.databases}.
+     * See also {@link Database#listUserDatabases} and
+     * {@link Database#databases}.
      *
      * @example
      * ```js
@@ -1712,8 +1693,8 @@ export declare class Database {
      * Returns a `Collection` instance for the given collection name.
      *
      * In TypeScript the collection implements both the
-     * {@link DocumentCollection} and {@link EdgeCollection} interfaces and can
-     * be cast to either type to enforce a stricter API.
+     * {@link collection.DocumentCollection} and {@link collection.EdgeCollection}
+     * interfaces and can be cast to either type to enforce a stricter API.
      *
      * @param T - Type to use for document data. Defaults to `any`.
      * @param collectionName - Name of the edge collection.
@@ -1750,7 +1731,7 @@ export declare class Database {
     collection<T extends Record<string, any> = any>(collectionName: string): DocumentCollection<T> & EdgeCollection<T>;
     /**
      * Creates a new collection with the given `collectionName` and `options`,
-     * then returns a {@link DocumentCollection} instance for the new collection.
+     * then returns a {@link collection.DocumentCollection} instance for the new collection.
      *
      * @param T - Type to use for document data. Defaults to `any`.
      * @param collectionName - Name of the new collection.
@@ -1776,7 +1757,7 @@ export declare class Database {
     }): Promise<DocumentCollection<T>>;
     /**
      * Creates a new edge collection with the given `collectionName` and
-     * `options`, then returns an {@link EdgeCollection} instance for the new
+     * `options`, then returns an {@link collection.EdgeCollection} instance for the new
      * edge collection.
      *
      * @param T - Type to use for edge document data. Defaults to `any`.
@@ -1808,10 +1789,10 @@ export declare class Database {
     }): Promise<EdgeCollection<T>>;
     /**
      * Creates a new edge collection with the given `collectionName` and
-     * `options`, then returns an {@link EdgeCollection} instance for the new
+     * `options`, then returns an {@link collection.EdgeCollection} instance for the new
      * edge collection.
      *
-     * This is a convenience method for calling {@link Database.createCollection}
+     * This is a convenience method for calling {@link Database#createCollection}
      * with `options.type` set to `EDGE_COLLECTION`.
      *
      * @param T - Type to use for edge document data. Defaults to `any`.
@@ -1847,12 +1828,12 @@ export declare class Database {
      * @param collectionName - Current name of the collection.
      * @param newName - The new name of the collection.
      */
-    renameCollection(collectionName: string, newName: string): Promise<ArangoResponseMetadata & CollectionMetadata>;
+    renameCollection(collectionName: string, newName: string): Promise<ArangoApiResponse<CollectionMetadata>>;
     /**
      * Fetches all collections from the database and returns an array of
      * collection descriptions.
      *
-     * See also {@link Database.collections}.
+     * See also {@link Database#collections}.
      *
      * @param excludeSystem - Whether system collections should be excluded.
      *
@@ -1878,10 +1859,10 @@ export declare class Database {
      * `Collection` instances.
      *
      * In TypeScript these instances implement both the
-     * {@link DocumentCollection} and {@link EdgeCollection} interfaces and can
-     * be cast to either type to enforce a stricter API.
+     * {@link collection.DocumentCollection} and {@link collection.EdgeCollection}
+     * interfaces and can be cast to either type to enforce a stricter API.
      *
-     * See also {@link Database.listCollections}.
+     * See also {@link Database#listCollections}.
      *
      * @param excludeSystem - Whether system collections should be excluded.
      *
@@ -1889,23 +1870,21 @@ export declare class Database {
      * ```js
      * const db = new Database();
      * const collections = await db.collections();
-     * // collections is an array of DocumentCollection
-     * // and EdgeCollection instances
-     * // not including system collections
+     * // collections is an array of DocumentCollection and EdgeCollection
+     * // instances not including system collections
      * ```
      *
      * @example
      * ```js
      * const db = new Database();
      * const collections = await db.collections(false);
-     * // collections is an array of DocumentCollection
-     * // and EdgeCollection instances
-     * // including system collections
+     * // collections is an array of DocumentCollection and EdgeCollection
+     * // instances including system collections
      * ```
      */
     collections(excludeSystem?: boolean): Promise<Array<DocumentCollection & EdgeCollection>>;
     /**
-     * Returns a {@link Graph} instance representing the graph with the given
+     * Returns a {@link graph.Graph} instance representing the graph with the given
      * `graphName`.
      *
      * @param graphName - Name of the graph.
@@ -1919,18 +1898,18 @@ export declare class Database {
     graph(graphName: string): Graph;
     /**
      * Creates a graph with the given `graphName` and `edgeDefinitions`, then
-     * returns a {@link Graph} instance for the new graph.
+     * returns a {@link graph.Graph} instance for the new graph.
      *
      * @param graphName - Name of the graph to be created.
      * @param edgeDefinitions - An array of edge definitions.
      * @param options - An object defining the properties of the graph.
      */
-    createGraph(graphName: string, edgeDefinitions: EdgeDefinitionOptions[], options?: GraphCreateOptions): Promise<Graph>;
+    createGraph(graphName: string, edgeDefinitions: EdgeDefinitionOptions[], options?: CreateGraphOptions): Promise<Graph>;
     /**
      * Fetches all graphs from the database and returns an array of graph
      * descriptions.
      *
-     * See also {@link Database.graphs}.
+     * See also {@link Database#graphs}.
      *
      * @example
      * ```js
@@ -1941,10 +1920,10 @@ export declare class Database {
      */
     listGraphs(): Promise<GraphInfo[]>;
     /**
-     * Fetches all graphs from the database and returns an array of {@link Graph}
+     * Fetches all graphs from the database and returns an array of {@link graph.Graph}
      * instances for those graphs.
      *
-     * See also {@link Database.listGraphs}.
+     * See also {@link Database#listGraphs}.
      *
      * @example
      * ```js
@@ -1955,9 +1934,9 @@ export declare class Database {
      */
     graphs(): Promise<Graph[]>;
     /**
-     * Returns an {@link ArangoSearchView} instance for the given `viewName`.
+     * Returns a {@link view.View} instance for the given `viewName`.
      *
-     * @param viewName - Name of the ArangoSearch View.
+     * @param viewName - Name of the ArangoSearch or SearchAlias View.
      *
      * @example
      * ```js
@@ -1965,26 +1944,26 @@ export declare class Database {
      * const view = db.view("potatoes");
      * ```
      */
-    view(viewName: string): ArangoSearchView;
+    view(viewName: string): View;
     /**
-     * Creates a new ArangoSearch View with the given `viewName` and `options`
-     * and returns an {@link ArangoSearchView} instance for the created View.
+     * Creates a new View with the given `viewName` and `options`, then returns a
+     * {@link view.View} instance for the new View.
      *
-     * @param viewName - Name of the ArangoSearch View.
+     * @param viewName - Name of the View.
      * @param options - An object defining the properties of the View.
      *
      * @example
      * ```js
      * const db = new Database();
-     * const view = await db.createView("potatoes");
+     * const view = await db.createView("potatoes", { type: "arangosearch" });
      * // the ArangoSearch View "potatoes" now exists
      * ```
      */
-    createView(viewName: string, options?: ArangoSearchViewPropertiesOptions): Promise<ArangoSearchView>;
+    createView(viewName: string, options: CreateViewOptions): Promise<View>;
     /**
      * Renames the view `viewName` to `newName`.
      *
-     * Additionally removes any stored {@link View} instance for `viewName` from
+     * Additionally removes any stored {@link view.View} instance for `viewName` from
      * the `Database` instance's internal cache.
      *
      * **Note**: Renaming views may not be supported when ArangoDB is running in
@@ -1993,12 +1972,12 @@ export declare class Database {
      * @param viewName - Current name of the view.
      * @param newName - The new name of the view.
      */
-    renameView(viewName: string, newName: string): Promise<ArangoResponseMetadata & ViewDescription>;
+    renameView(viewName: string, newName: string): Promise<ArangoApiResponse<ViewDescription>>;
     /**
      * Fetches all Views from the database and returns an array of View
      * descriptions.
      *
-     * See also {@link Database.views}.
+     * See also {@link Database#views}.
      *
      * @example
      * ```js
@@ -2011,9 +1990,10 @@ export declare class Database {
     listViews(): Promise<ViewDescription[]>;
     /**
      * Fetches all Views from the database and returns an array of
-     * {@link ArangoSearchView} instances for the Views.
+     * {@link view.View} instances
+     * for the Views.
      *
-     * See also {@link Database.listViews}.
+     * See also {@link Database#listViews}.
      *
      * @example
      * ```js
@@ -2022,9 +2002,9 @@ export declare class Database {
      * // views is an array of ArangoSearch View instances
      * ```
      */
-    views(): Promise<ArangoSearchView[]>;
+    views(): Promise<View[]>;
     /**
-     * Returns an {@link Analyzer} instance representing the Analyzer with the
+     * Returns an {@link analyzer.Analyzer} instance representing the Analyzer with the
      * given `analyzerName`.
      *
      * @example
@@ -2037,7 +2017,7 @@ export declare class Database {
     analyzer(analyzerName: string): Analyzer;
     /**
      * Creates a new Analyzer with the given `analyzerName` and `options`, then
-     * returns an {@link Analyzer} instance for the new Analyzer.
+     * returns an {@link analyzer.Analyzer} instance for the new Analyzer.
      *
      * @param analyzerName - Name of the Analyzer.
      * @param options - An object defining the properties of the Analyzer.
@@ -2054,7 +2034,7 @@ export declare class Database {
      * Fetches all Analyzers visible in the database and returns an array of
      * Analyzer descriptions.
      *
-     * See also {@link Database.analyzers}.
+     * See also {@link Database#analyzers}.
      *
      * @example
      * ```js
@@ -2066,9 +2046,9 @@ export declare class Database {
     listAnalyzers(): Promise<AnalyzerDescription[]>;
     /**
      * Fetches all Analyzers visible in the database and returns an array of
-     * {@link Analyzer} instances for those Analyzers.
+     * {@link analyzer.Analyzer} instances for those Analyzers.
      *
-     * See also {@link Database.listAnalyzers}.
+     * See also {@link Database#listAnalyzers}.
      *
      * @example
      * ```js
@@ -2102,7 +2082,7 @@ export declare class Database {
      * // user is the user object for the user named "steve"
      * ```
      */
-    getUser(username: string): Promise<ArangoUser & ArangoResponseMetadata>;
+    getUser(username: string): Promise<ArangoApiResponse<ArangoUser>>;
     /**
      * Creates a new ArangoDB user with the given password.
      *
@@ -2116,7 +2096,7 @@ export declare class Database {
      * // The user "steve" has been created
      * ```
      */
-    createUser(username: string, passwd: string): Promise<ArangoUser & ArangoResponseMetadata>;
+    createUser(username: string, passwd: string): Promise<ArangoApiResponse<ArangoUser>>;
     /**
      * Creates a new ArangoDB user with the given options.
      *
@@ -2130,7 +2110,7 @@ export declare class Database {
      * // The user "steve" has been created
      * ```
      */
-    createUser(username: string, options: UserOptions): Promise<ArangoUser & ArangoResponseMetadata>;
+    createUser(username: string, options: UserOptions): Promise<ArangoApiResponse<ArangoUser>>;
     /**
      * Sets the password of a given ArangoDB user to the new value.
      *
@@ -2144,7 +2124,7 @@ export declare class Database {
      * // The user "steve" has received a new password
      * ```
      */
-    updateUser(username: string, passwd: string): Promise<ArangoUser & ArangoResponseMetadata>;
+    updateUser(username: string, passwd: string): Promise<ArangoApiResponse<ArangoUser>>;
     /**
      * Updates the ArangoDB user with the new options.
      *
@@ -2158,7 +2138,7 @@ export declare class Database {
      * // The user "steve" has been set to inactive
      * ```
      */
-    updateUser(username: string, options: Partial<UserOptions>): Promise<ArangoUser & ArangoResponseMetadata>;
+    updateUser(username: string, options: Partial<UserOptions>): Promise<ArangoApiResponse<ArangoUser>>;
     /**
      * Replaces the ArangoDB user's option with the new options.
      *
@@ -2172,7 +2152,7 @@ export declare class Database {
      * // The user "steve" has been set to inactive with an empty password
      * ```
      */
-    replaceUser(username: string, options: UserOptions): Promise<ArangoUser & ArangoResponseMetadata>;
+    replaceUser(username: string, options: UserOptions): Promise<ArangoApiResponse<ArangoUser>>;
     /**
      * Removes the ArangoDB user with the given username from the server.
      *
@@ -2185,7 +2165,7 @@ export declare class Database {
      * // The user "steve" has been removed
      * ```
      */
-    removeUser(username: string): Promise<ArangoResponseMetadata>;
+    removeUser(username: string): Promise<ArangoApiResponse<Record<string, never>>>;
     /**
      * Fetches the given ArangoDB user's access level for the database, or the
      * given collection in the given database.
@@ -2330,7 +2310,7 @@ export declare class Database {
      */
     setUserAccessLevel(username: string, { database, collection, grant, }: UserAccessLevelOptions & {
         grant: AccessLevel;
-    }): Promise<Record<string, AccessLevel> & ArangoResponseMetadata>;
+    }): Promise<ArangoApiResponse<Record<string, AccessLevel>>>;
     /**
      * Clears the given ArangoDB user's access level for the database, or the
      * given collection in the given database.
@@ -2394,7 +2374,7 @@ export declare class Database {
      * // "pokemons" collection in database "staging".
      * ```
      */
-    clearUserAccessLevel(username: string, { database, collection }: UserAccessLevelOptions): Promise<Record<string, AccessLevel> & ArangoResponseMetadata>;
+    clearUserAccessLevel(username: string, { database, collection }: UserAccessLevelOptions): Promise<ArangoApiResponse<Record<string, AccessLevel>>>;
     /**
      * Fetches an object mapping names of databases to the access level of the
      * given ArangoDB user for those databases.
@@ -2441,16 +2421,16 @@ export declare class Database {
      * value.
      *
      * Collections can be specified as collection names (strings) or objects
-     * implementing the {@link ArangoCollection} interface: `Collection`,
-     * {@link GraphVertexCollection}, {@link GraphEdgeCollection} as well as
-     * (in TypeScript) {@link DocumentCollection} and {@link EdgeCollection}.
+     * implementing the {@link collection.ArangoCollection} interface: `Collection`,
+     * {@link graph.GraphVertexCollection}, {@link graph.GraphEdgeCollection} as well as
+     * (in TypeScript) {@link collection.DocumentCollection} and {@link collection.EdgeCollection}.
      *
      * **Note**: The `action` function will be evaluated and executed on the
      * server inside ArangoDB's embedded JavaScript environment and can not
      * access any values other than those passed via the `params` option.
      *
      * See the official ArangoDB documentation for
-     * {@link https://www.arangodb.com/docs/stable/appendix-java-script-modules-arango-db.html | the JavaScript `@arangodb` module}
+     * [the JavaScript `@arangodb` module](https://www.arangodb.com/docs/stable/appendix-java-script-modules-arango-db.html)
      * for information about accessing the database from within ArangoDB's
      * server-side JavaScript environment.
      *
@@ -2494,15 +2474,15 @@ export declare class Database {
      * Performs a server-side transaction and returns its return value.
      *
      * Collections can be specified as collection names (strings) or objects
-     * implementing the {@link ArangoCollection} interface: `Collection`,
-     * {@link GraphVertexCollection}, {@link GraphEdgeCollection} as well as
-     * (in TypeScript) {@link DocumentCollection} and {@link EdgeCollection}.
+     * implementing the {@link collection.ArangoCollection} interface: `Collection`,
+     * {@link graph.GraphVertexCollection}, {@link graph.GraphEdgeCollection} as well as
+     * (in TypeScript) {@link collection.DocumentCollection} and {@link collection.EdgeCollection}.
      *
      * **Note**: The `action` function will be evaluated and executed on the
      * server inside ArangoDB's embedded JavaScript environment and can not
      * access any values other than those passed via the `params` option.
      * See the official ArangoDB documentation for
-     * {@link https://www.arangodb.com/docs/stable/appendix-java-script-modules-arango-db.html | the JavaScript `@arangodb` module}
+     * [the JavaScript `@arangodb` module](https://www.arangodb.com/docs/stable/appendix-java-script-modules-arango-db.html)
      * for information about accessing the database from within ArangoDB's
      * server-side JavaScript environment.
      *
@@ -2541,15 +2521,15 @@ export declare class Database {
      * Performs a server-side transaction and returns its return value.
      *
      * The Collection can be specified as a collection name (string) or an object
-     * implementing the {@link ArangoCollection} interface: `Collection`,
-     * {@link GraphVertexCollection}, {@link GraphEdgeCollection} as well as
-     * (in TypeScript) {@link DocumentCollection} and {@link EdgeCollection}.
+     * implementing the {@link collection.ArangoCollection} interface: `Collection`,
+     * {@link graph.GraphVertexCollection}, {@link graph.GraphEdgeCollection} as well as
+     * (in TypeScript) {@link collection.DocumentCollection} and {@link collection.EdgeCollection}.
      *
      * **Note**: The `action` function will be evaluated and executed on the
      * server inside ArangoDB's embedded JavaScript environment and can not
      * access any values other than those passed via the `params` option.
      * See the official ArangoDB documentation for
-     * {@link https://www.arangodb.com/docs/stable/appendix-java-script-modules-arango-db.html | the JavaScript `@arangodb` module}
+     * [the JavaScript `@arangodb` module](https://www.arangodb.com/docs/stable/appendix-java-script-modules-arango-db.html)
      * for information about accessing the database from within ArangoDB's
      * server-side JavaScript environment.
      *
@@ -2585,10 +2565,10 @@ export declare class Database {
         params?: any;
     }): Promise<any>;
     /**
-     * Returns a {@link Transaction} instance for an existing streaming
+     * Returns a {@link transaction.Transaction} instance for an existing streaming
      * transaction with the given `id`.
      *
-     * See also {@link Database.beginTransaction}.
+     * See also {@link Database#beginTransaction}.
      *
      * @param id - The `id` of an existing stream transaction.
      *
@@ -2604,12 +2584,13 @@ export declare class Database {
     transaction(transactionId: string): Transaction;
     /**
      * Begins a new streaming transaction for the given collections, then returns
-     * a {@link Transaction} instance for the transaction.
+     * a {@link transaction.Transaction} instance for the transaction.
      *
      * Collections can be specified as collection names (strings) or objects
-     * implementing the {@link ArangoCollection} interface: `Collection`,
-     * {@link GraphVertexCollection}, {@link GraphEdgeCollection} as well as
-     * (in TypeScript) {@link DocumentCollection} and {@link EdgeCollection}.
+     * implementing the {@link collection.ArangoCollection} interface: `Collection`,
+     * {@link graph.GraphVertexCollection}, {@link graph.GraphEdgeCollection} as
+     * well as (in TypeScript) {@link collection.DocumentCollection} and
+     * {@link collection.EdgeCollection}.
      *
      * @param collections - Collections involved in the transaction.
      * @param options - Options for the transaction.
@@ -2631,12 +2612,12 @@ export declare class Database {
     beginTransaction(collections: TransactionCollections, options?: TransactionOptions): Promise<Transaction>;
     /**
      * Begins a new streaming transaction for the given collections, then returns
-     * a {@link Transaction} instance for the transaction.
+     * a {@link transaction.Transaction} instance for the transaction.
      *
      * Collections can be specified as collection names (strings) or objects
-     * implementing the {@link ArangoCollection} interface: `Collection`,
-     * {@link GraphVertexCollection}, {@link GraphEdgeCollection} as well as
-     * (in TypeScript) {@link DocumentCollection} and {@link EdgeCollection}.
+     * implementing the {@link collection.ArangoCollection} interface: `Collection`,
+     * {@link graph.GraphVertexCollection}, {@link graph.GraphEdgeCollection} as well as
+     * (in TypeScript) {@link collection.DocumentCollection} and {@link collection.EdgeCollection}.
      *
      * @param collections - Collections that can be read from and written to
      * during the transaction.
@@ -2659,12 +2640,12 @@ export declare class Database {
     beginTransaction(collections: (string | ArangoCollection)[], options?: TransactionOptions): Promise<Transaction>;
     /**
      * Begins a new streaming transaction for the given collections, then returns
-     * a {@link Transaction} instance for the transaction.
+     * a {@link transaction.Transaction} instance for the transaction.
      *
      * The Collection can be specified as a collection name (string) or an object
-     * implementing the {@link ArangoCollection} interface: `Collection`,
-     * {@link GraphVertexCollection}, {@link GraphEdgeCollection} as well as
-     * (in TypeScript) {@link DocumentCollection} and {@link EdgeCollection}.
+     * implementing the {@link collection.ArangoCollection} interface: `Collection`,
+     * {@link graph.GraphVertexCollection}, {@link graph.GraphEdgeCollection} as well as
+     * (in TypeScript) {@link collection.DocumentCollection} and {@link collection.EdgeCollection}.
      *
      * @param collections - A collection that can be read from and written to
      * during the transaction.
@@ -2688,7 +2669,7 @@ export declare class Database {
      * Fetches all active transactions from the database and returns an array of
      * transaction descriptions.
      *
-     * See also {@link Database.transactions}.
+     * See also {@link Database#transactions}.
      *
      * @example
      * ```js
@@ -2700,9 +2681,9 @@ export declare class Database {
     listTransactions(): Promise<TransactionDetails[]>;
     /**
      * Fetches all active transactions from the database and returns an array of
-     * {@link Transaction} instances for those transactions.
+     * {@link transaction.Transaction} instances for those transactions.
      *
-     * See also {@link Database.listTransactions}.
+     * See also {@link Database#listTransactions}.
      *
      * @example
      * ```js
@@ -2714,24 +2695,27 @@ export declare class Database {
     transactions(): Promise<Transaction[]>;
     /**
      * Performs a database query using the given `query`, then returns a new
-     * {@link ArrayCursor} instance for the result set.
+     * {@link cursor.ArrayCursor} instance for the result set.
      *
-     * See the {@link aql} template string handler for information about how
+     * See the {@link aql!aql} template string handler for information about how
      * to create a query string without manually defining bind parameters nor
      * having to worry about escaping variables.
      *
      * @param query - An object containing an AQL query string and bind
-     * parameters, e.g. the object returned from an {@link aql} template string.
+     * parameters, e.g. the object returned from an {@link aql!aql} template string.
      * @param options - Options for the query execution.
      *
      * @example
      * ```js
      * const db = new Database();
      * const active = true;
+     * const Users = db.collection("_users");
      *
-     * // Using an aql template string
+     * // Using an aql template string:
+     * // Bind parameters are automatically extracted and arangojs collections
+     * // are automatically passed as collection bind parameters.
      * const cursor = await db.query(aql`
-     *   FOR u IN _users
+     *   FOR u IN ${Users}
      *   FILTER u.authData.active == ${active}
      *   RETURN u.user
      * `);
@@ -2742,24 +2726,25 @@ export declare class Database {
      * ```js
      * const db = new Database();
      * const active = true;
+     * const Users = db.collection("_users");
      *
      * // Using an object with a regular multi-line string
      * const cursor = await db.query({
      *   query: `
-     *     FOR u IN _users
+     *     FOR u IN @@users
      *     FILTER u.authData.active == @active
      *     RETURN u.user
      *   `,
-     *   bindVars: { active: active }
+     *   bindVars: { active: active, "@users": Users.name }
      * });
      * ```
      */
-    query(query: AqlQuery, options?: QueryOptions): Promise<ArrayCursor>;
+    query<T = any>(query: AqlQuery, options?: QueryOptions): Promise<ArrayCursor<T>>;
     /**
      * Performs a database query using the given `query` and `bindVars`, then
-     * returns a new {@link ArrayCursor} instance for the result set.
+     * returns a new {@link cursor.ArrayCursor} instance for the result set.
      *
-     * See the {@link aql} template string handler for a safer and easier
+     * See the {@link aql!aql} template string handler for a safer and easier
      * alternative to passing strings directly.
      *
      * @param query - An AQL query string.
@@ -2770,15 +2755,16 @@ export declare class Database {
      * ```js
      * const db = new Database();
      * const active = true;
+     * const Users = db.collection("_users");
      *
      * const cursor = await db.query(
      *   // A normal multi-line string
      *   `
-     *     FOR u IN _users
+     *     FOR u IN @@users
      *     FILTER u.authData.active == @active
      *     RETURN u.user
      *   `,
-     *   { active: active }
+     *   { active: active, "@users": Users.name }
      * );
      * ```
      *
@@ -2786,28 +2772,29 @@ export declare class Database {
      * ```js
      * const db = new Database();
      * const active = true;
+     * const Users = db.collection("_users");
      *
      * const cursor = await db.query(
      *   // An AQL literal created from a normal multi-line string
      *   aql.literal(`
-     *     FOR u IN _users
+     *     FOR u IN @@users
      *     FILTER u.authData.active == @active
      *     RETURN u.user
      *   `),
-     *   { active: active }
+     *   { active: active, "@users": Users.name }
      * );
      * ```
      */
-    query(query: string | AqlLiteral, bindVars?: Dict<any>, options?: QueryOptions): Promise<ArrayCursor>;
+    query<T = any>(query: string | AqlLiteral, bindVars?: Record<string, any>, options?: QueryOptions): Promise<ArrayCursor<T>>;
     /**
      * Explains a database query using the given `query`.
      *
-     * See the {@link aql} template string handler for information about how
+     * See the {@link aql!aql} template string handler for information about how
      * to create a query string without manually defining bind parameters nor
      * having to worry about escaping variables.
      *
      * @param query - An object containing an AQL query string and bind
-     * parameters, e.g. the object returned from an {@link aql} template string.
+     * parameters, e.g. the object returned from an {@link aql!aql} template string.
      * @param options - Options for explaining the query.
      *
      * @example
@@ -2823,16 +2810,16 @@ export declare class Database {
      */
     explain(query: AqlQuery, options?: ExplainOptions & {
         allPlans?: false;
-    }): Promise<ArangoResponseMetadata & SingleExplainResult>;
+    }): Promise<ArangoApiResponse<SingleExplainResult>>;
     /**
      * Explains a database query using the given `query`.
      *
-     * See the {@link aql} template string handler for information about how
+     * See the {@link aql!aql} template string handler for information about how
      * to create a query string without manually defining bind parameters nor
      * having to worry about escaping variables.
      *
      * @param query - An object containing an AQL query string and bind
-     * parameters, e.g. the object returned from an {@link aql} template string.
+     * parameters, e.g. the object returned from an {@link aql!aql} template string.
      * @param options - Options for explaining the query.
      *
      * @example
@@ -2851,11 +2838,11 @@ export declare class Database {
      */
     explain(query: AqlQuery, options?: ExplainOptions & {
         allPlans: true;
-    }): Promise<ArangoResponseMetadata & MultiExplainResult>;
+    }): Promise<ArangoApiResponse<MultiExplainResult>>;
     /**
      * Explains a database query using the given `query` and `bindVars`.
      *
-     * See the {@link aql} template string handler for a safer and easier
+     * See the {@link aql!aql} template string handler for a safer and easier
      * alternative to passing strings directly.
      *
      * @param query - An AQL query string.
@@ -2876,13 +2863,13 @@ export declare class Database {
      * );
      * ```
      */
-    explain(query: string | AqlLiteral, bindVars?: Dict<any>, options?: ExplainOptions & {
+    explain(query: string | AqlLiteral, bindVars?: Record<string, any>, options?: ExplainOptions & {
         allPlans?: false;
-    }): Promise<ArangoResponseMetadata & SingleExplainResult>;
+    }): Promise<ArangoApiResponse<SingleExplainResult>>;
     /**
      * Explains a database query using the given `query` and `bindVars`.
      *
-     * See the {@link aql} template string handler for a safer and easier
+     * See the {@link aql!aql} template string handler for a safer and easier
      * alternative to passing strings directly.
      *
      * @param query - An AQL query string.
@@ -2904,18 +2891,18 @@ export declare class Database {
      * );
      * ```
      */
-    explain(query: string | AqlLiteral, bindVars?: Dict<any>, options?: ExplainOptions & {
+    explain(query: string | AqlLiteral, bindVars?: Record<string, any>, options?: ExplainOptions & {
         allPlans: true;
-    }): Promise<ArangoResponseMetadata & MultiExplainResult>;
+    }): Promise<ArangoApiResponse<MultiExplainResult>>;
     /**
      * Parses the given query and returns the result.
      *
-     * See the {@link aql} template string handler for information about how
+     * See the {@link aql!aql} template string handler for information about how
      * to create a query string without manually defining bind parameters nor
      * having to worry about escaping variables.
      *
      * @param query - An AQL query string or an object containing an AQL query
-     * string and bind parameters, e.g. the object returned from an {@link aql}
+     * string and bind parameters, e.g. the object returned from an {@link aql!aql}
      * template string.
      *
      * @example
@@ -2930,6 +2917,19 @@ export declare class Database {
      * ```
      */
     parse(query: string | AqlQuery | AqlLiteral): Promise<ParseResult>;
+    /**
+     * Fetches the available optimizer rules.
+     *
+     * @example
+     * ```js
+     * const db = new Database();
+     * const rules = await db.queryRules();
+     * for (const rule of rules) {
+     *   console.log(rule.name);
+     * }
+     * ```
+     */
+    queryRules(): Promise<QueryOptimizerRule[]>;
     /**
      * Fetches the query tracking properties.
      *
@@ -2962,7 +2962,7 @@ export declare class Database {
     /**
      * Fetches a list of information for all currently running queries.
      *
-     * See also {@link Database.listSlowQueries} and {@link Database.killQuery}.
+     * See also {@link Database#listSlowQueries} and {@link Database#killQuery}.
      *
      * @example
      * ```js
@@ -2974,8 +2974,8 @@ export declare class Database {
     /**
      * Fetches a list of information for all recent slow queries.
      *
-     * See also {@link Database.listRunningQueries} and
-     * {@link Database.clearSlowQueries}.
+     * See also {@link Database#listRunningQueries} and
+     * {@link Database#clearSlowQueries}.
      *
      * @example
      * ```js
@@ -2988,7 +2988,7 @@ export declare class Database {
     /**
      * Clears the list of recent slow queries.
      *
-     * See also {@link Database.listSlowQueries}.
+     * See also {@link Database#listSlowQueries}.
      *
      * @example
      * ```js
@@ -3001,7 +3001,7 @@ export declare class Database {
     /**
      * Kills a running query with the given `queryId`.
      *
-     * See also {@link Database.listRunningQueries}.
+     * See also {@link Database#listRunningQueries}.
      *
      * @param queryId - The ID of a currently running query.
      *
@@ -3061,9 +3061,9 @@ export declare class Database {
      * // cursor is a cursor for the query result
      * ```
      */
-    createFunction(name: string, code: string, isDeterministic?: boolean): Promise<ArangoResponseMetadata & {
+    createFunction(name: string, code: string, isDeterministic?: boolean): Promise<ArangoApiResponse<{
         isNewlyCreated: boolean;
-    }>;
+    }>>;
     /**
      * Deletes the AQL user function with the given name from the database.
      *
@@ -3079,9 +3079,9 @@ export declare class Database {
      * // the function no longer exists
      * ```
      */
-    dropFunction(name: string, group?: boolean): Promise<ArangoResponseMetadata & {
+    dropFunction(name: string, group?: boolean): Promise<ArangoApiResponse<{
         deletedCount: number;
-    }>;
+    }>>;
     /**
      * Fetches a list of all installed service.
      *
@@ -3231,8 +3231,8 @@ export declare class Database {
      * Retrieves information about the service's configuration options and their
      * current values.
      *
-     * See also {@link Database.replaceServiceConfiguration} and
-     * {@link Database.updateServiceConfiguration}.
+     * See also {@link Database#replaceServiceConfiguration} and
+     * {@link Database#updateServiceConfiguration}.
      *
      * @param mount - The service's mount point, relative to the database.
      * @param minimal - If set to `true`, the result will only include each
@@ -3248,13 +3248,13 @@ export declare class Database {
      * }
      * ```
      */
-    getServiceConfiguration(mount: string, minimal?: false): Promise<Dict<ServiceConfiguration>>;
+    getServiceConfiguration(mount: string, minimal?: false): Promise<Record<string, ServiceConfiguration>>;
     /**
      * Retrieves information about the service's configuration options and their
      * current values.
      *
-     * See also {@link Database.replaceServiceConfiguration} and
-     * {@link Database.updateServiceConfiguration}.
+     * See also {@link Database#replaceServiceConfiguration} and
+     * {@link Database#updateServiceConfiguration}.
      *
      * @param mount - The service's mount point, relative to the database.
      * @param minimal - If set to `true`, the result will only include each
@@ -3270,13 +3270,13 @@ export declare class Database {
      * }
      * ```
      */
-    getServiceConfiguration(mount: string, minimal: true): Promise<Dict<any>>;
+    getServiceConfiguration(mount: string, minimal: true): Promise<Record<string, any>>;
     /**
      * Replaces the configuration of the given service, discarding any existing
      * values for options not specified.
      *
-     * See also {@link Database.updateServiceConfiguration} and
-     * {@link Database.getServiceConfiguration}.
+     * See also {@link Database#updateServiceConfiguration} and
+     * {@link Database#getServiceConfiguration}.
      *
      * @param mount - The service's mount point, relative to the database.
      * @param cfg - An object mapping configuration option names to values.
@@ -3284,10 +3284,6 @@ export declare class Database {
      * configuration option's current value and warning (if any).
      * Otherwise it will include the full definition for each option.
      *
-     * **Note**: When using ArangoDB 3.2.8 or older, setting the `minimal` option
-     * to `true` avoids triggering a second request to fetch the full
-     * configuration definitions.
-     *
      * @example
      * ```js
      * const db = new Database();
@@ -3299,15 +3295,15 @@ export declare class Database {
      * }
      * ```
      */
-    replaceServiceConfiguration(mount: string, cfg: Dict<any>, minimal?: false): Promise<Dict<ServiceConfiguration & {
+    replaceServiceConfiguration(mount: string, cfg: Record<string, any>, minimal?: false): Promise<Record<string, ServiceConfiguration & {
         warning?: string;
     }>>;
     /**
      * Replaces the configuration of the given service, discarding any existing
      * values for options not specified.
      *
-     * See also {@link Database.updateServiceConfiguration} and
-     * {@link Database.getServiceConfiguration}.
+     * See also {@link Database#updateServiceConfiguration} and
+     * {@link Database#getServiceConfiguration}.
      *
      * @param mount - The service's mount point, relative to the database.
      * @param cfg - An object mapping configuration option names to values.
@@ -3315,10 +3311,6 @@ export declare class Database {
      * configuration option's current value and warning (if any).
      * Otherwise it will include the full definition for each option.
      *
-     * **Note**: When using ArangoDB 3.2.8 or older, setting the `minimal` option
-     * to `true` avoids triggering a second request to fetch the full
-     * configuration definitions.
-     *
      * @example
      * ```js
      * const db = new Database();
@@ -3330,16 +3322,16 @@ export declare class Database {
      * }
      * ```
      */
-    replaceServiceConfiguration(mount: string, cfg: Dict<any>, minimal: true): Promise<{
-        values: Dict<any>;
-        warnings: Dict<string | undefined>;
+    replaceServiceConfiguration(mount: string, cfg: Record<string, any>, minimal: true): Promise<{
+        values: Record<string, any>;
+        warnings: Record<string, string>;
     }>;
     /**
      * Updates the configuration of the given service while maintaining any
      * existing values for options not specified.
      *
-     * See also {@link Database.replaceServiceConfiguration} and
-     * {@link Database.getServiceConfiguration}.
+     * See also {@link Database#replaceServiceConfiguration} and
+     * {@link Database#getServiceConfiguration}.
      *
      * @param mount - The service's mount point, relative to the database.
      * @param cfg - An object mapping configuration option names to values.
@@ -3347,10 +3339,6 @@ export declare class Database {
      * configuration option's current value and warning (if any).
      * Otherwise it will include the full definition for each option.
      *
-     * **Note**: When using ArangoDB 3.2.8 or older, setting the `minimal` option
-     * to `true` avoids triggering a second request to fetch the full
-     * configuration definitions.
-     *
      * @example
      * ```js
      * const db = new Database();
@@ -3362,15 +3350,15 @@ export declare class Database {
      * }
      * ```
      */
-    updateServiceConfiguration(mount: string, cfg: Dict<any>, minimal?: false): Promise<Dict<ServiceConfiguration & {
+    updateServiceConfiguration(mount: string, cfg: Record<string, any>, minimal?: false): Promise<Record<string, ServiceConfiguration & {
         warning?: string;
     }>>;
     /**
      * Updates the configuration of the given service while maintaining any
      * existing values for options not specified.
      *
-     * See also {@link Database.replaceServiceConfiguration} and
-     * {@link Database.getServiceConfiguration}.
+     * See also {@link Database#replaceServiceConfiguration} and
+     * {@link Database#getServiceConfiguration}.
      *
      * @param mount - The service's mount point, relative to the database.
      * @param cfg - An object mapping configuration option names to values.
@@ -3378,10 +3366,6 @@ export declare class Database {
      * configuration option's current value and warning (if any).
      * Otherwise it will include the full definition for each option.
      *
-     * **Note**: When using ArangoDB 3.2.8 or older, setting the `minimal` option
-     * to `true` avoids triggering a second request to fetch the full
-     * configuration definitions.
-     *
      * @example
      * ```js
      * const db = new Database();
@@ -3393,16 +3377,16 @@ export declare class Database {
      * }
      * ```
      */
-    updateServiceConfiguration(mount: string, cfg: Dict<any>, minimal: true): Promise<{
-        values: Dict<any>;
-        warnings: Dict<string | undefined>;
+    updateServiceConfiguration(mount: string, cfg: Record<string, any>, minimal: true): Promise<{
+        values: Record<string, any>;
+        warnings: Record<string, string>;
     }>;
     /**
      * Retrieves information about the service's dependencies and their current
      * mount points.
      *
-     * See also {@link Database.replaceServiceDependencies} and
-     * {@link Database.updateServiceDependencies}.
+     * See also {@link Database#replaceServiceDependencies} and
+     * {@link Database#updateServiceDependencies}.
      *
      * @param mount - The service's mount point, relative to the database.
      * @param minimal - If set to `true`, the result will only include each
@@ -3418,13 +3402,13 @@ export declare class Database {
      * }
      * ```
      */
-    getServiceDependencies(mount: string, minimal?: false): Promise<Dict<SingleServiceDependency | MultiServiceDependency>>;
+    getServiceDependencies(mount: string, minimal?: false): Promise<Record<string, SingleServiceDependency | MultiServiceDependency>>;
     /**
      * Retrieves information about the service's dependencies and their current
      * mount points.
      *
-     * See also {@link Database.replaceServiceDependencies} and
-     * {@link Database.updateServiceDependencies}.
+     * See also {@link Database#replaceServiceDependencies} and
+     * {@link Database#updateServiceDependencies}.
      *
      * @param mount - The service's mount point, relative to the database.
      * @param minimal - If set to `true`, the result will only include each
@@ -3440,13 +3424,13 @@ export declare class Database {
      * }
      * ```
      */
-    getServiceDependencies(mount: string, minimal: true): Promise<Dict<string | string[] | undefined>>;
+    getServiceDependencies(mount: string, minimal: true): Promise<Record<string, string | string[]>>;
     /**
      * Replaces the dependencies of the given service, discarding any existing
      * mount points for dependencies not specified.
      *
-     * See also {@link Database.updateServiceDependencies} and
-     * {@link Database.getServiceDependencies}.
+     * See also {@link Database#updateServiceDependencies} and
+     * {@link Database#getServiceDependencies}.
      *
      * @param mount - The service's mount point, relative to the database.
      * @param cfg - An object mapping dependency aliases to mount points.
@@ -3454,10 +3438,6 @@ export declare class Database {
      * dependency's current mount point. Otherwise it will include the full
      * definition for each dependency.
      *
-     * **Note**: When using ArangoDB 3.2.8 or older, setting the `minimal` option
-     * to `true` avoids triggering a second request to fetch the full
-     * dependency definitions.
-     *
      * @example
      * ```js
      * const db = new Database();
@@ -3469,15 +3449,15 @@ export declare class Database {
      * }
      * ```
      */
-    replaceServiceDependencies(mount: string, deps: Dict<string>, minimal?: false): Promise<Dict<(SingleServiceDependency | MultiServiceDependency) & {
+    replaceServiceDependencies(mount: string, deps: Record<string, string>, minimal?: false): Promise<Record<string, (SingleServiceDependency | MultiServiceDependency) & {
         warning?: string;
     }>>;
     /**
      * Replaces the dependencies of the given service, discarding any existing
      * mount points for dependencies not specified.
      *
-     * See also {@link Database.updateServiceDependencies} and
-     * {@link Database.getServiceDependencies}.
+     * See also {@link Database#updateServiceDependencies} and
+     * {@link Database#getServiceDependencies}.
      *
      * @param mount - The service's mount point, relative to the database.
      * @param cfg - An object mapping dependency aliases to mount points.
@@ -3485,10 +3465,6 @@ export declare class Database {
      * dependency's current mount point. Otherwise it will include the full
      * definition for each dependency.
      *
-     * **Note**: When using ArangoDB 3.2.8 or older, setting the `minimal` option
-     * to `true` avoids triggering a second request to fetch the full
-     * dependency definitions.
-     *
      * @example
      * ```js
      * const db = new Database();
@@ -3504,16 +3480,16 @@ export declare class Database {
      * }
      * ```
      */
-    replaceServiceDependencies(mount: string, deps: Dict<string>, minimal: true): Promise<{
-        values: Dict<string>;
-        warnings: Dict<string | undefined>;
+    replaceServiceDependencies(mount: string, deps: Record<string, string>, minimal: true): Promise<{
+        values: Record<string, string>;
+        warnings: Record<string, string>;
     }>;
     /**
      * Updates the dependencies of the given service while maintaining any
      * existing mount points for dependencies not specified.
      *
-     * See also {@link Database.replaceServiceDependencies} and
-     * {@link Database.getServiceDependencies}.
+     * See also {@link Database#replaceServiceDependencies} and
+     * {@link Database#getServiceDependencies}.
      *
      * @param mount - The service's mount point, relative to the database.
      * @param cfg - An object mapping dependency aliases to mount points.
@@ -3521,10 +3497,6 @@ export declare class Database {
      * dependency's current mount point. Otherwise it will include the full
      * definition for each dependency.
      *
-     * **Note**: When using ArangoDB 3.2.8 or older, setting the `minimal` option
-     * to `true` avoids triggering a second request to fetch the full
-     * dependency definitions.
-     *
      * @example
      * ```js
      * const db = new Database();
@@ -3536,15 +3508,15 @@ export declare class Database {
      * }
      * ```
      */
-    updateServiceDependencies(mount: string, deps: Dict<string>, minimal?: false): Promise<Dict<(SingleServiceDependency | MultiServiceDependency) & {
+    updateServiceDependencies(mount: string, deps: Record<string, string>, minimal?: false): Promise<Record<string, (SingleServiceDependency | MultiServiceDependency) & {
         warning?: string;
     }>>;
     /**
      * Updates the dependencies of the given service while maintaining any
      * existing mount points for dependencies not specified.
      *
-     * See also {@link Database.replaceServiceDependencies} and
-     * {@link Database.getServiceDependencies}.
+     * See also {@link Database#replaceServiceDependencies} and
+     * {@link Database#getServiceDependencies}.
      *
      * @param mount - The service's mount point, relative to the database.
      * @param cfg - An object mapping dependency aliases to mount points.
@@ -3552,10 +3524,6 @@ export declare class Database {
      * dependency's current mount point. Otherwise it will include the full
      * definition for each dependency.
      *
-     * **Note**: When using ArangoDB 3.2.8 or older, setting the `minimal` option
-     * to `true` avoids triggering a second request to fetch the full
-     * dependency definitions.
-     *
      * @example
      * ```js
      * const db = new Database();
@@ -3571,9 +3539,9 @@ export declare class Database {
      * }
      * ```
      */
-    updateServiceDependencies(mount: string, deps: Dict<string>, minimal: true): Promise<{
-        values: Dict<string>;
-        warnings: Dict<string | undefined>;
+    updateServiceDependencies(mount: string, deps: Record<string, string>, minimal: true): Promise<{
+        values: Record<string, string>;
+        warnings: Record<string, string>;
     }>;
     /**
      * Enables or disables development mode for the given service.
@@ -3606,7 +3574,7 @@ export declare class Database {
      * }
      * ```
      */
-    listServiceScripts(mount: string): Promise<Dict<string>>;
+    listServiceScripts(mount: string): Promise<Record<string, string>>;
     /**
      * Executes a service script and retrieves its result exposed as
      * `module.exports` (if any).