[DE-582] Implement renewAuthToken

Fixes #784.

Author: pluma

CHANGELOG.md

@@ -22,6 +22,13 @@ This driver uses semantic versioning:
 
 ## Added
 
+- Added `renewAuthToken` method to `Database` ([#784](https://github.com/arangodb/arangojs/issues/784))
+
+  This method allows refreshing the authentication token passed to the
+  `useBearerAuth` method or used by the `login` method. Note that ArangoDB
+  will currently only return a new token if the token is going to expire
+  in the next 150 seconds.
+
 - Added `returnOld` and `mergeObjects` to `CollectionInsertOptions` type
 
   These options are only available when using `overwriteMode`.

src/database.ts

@@ -1793,6 +1793,34 @@ export class Database {
       }
     );
   }
+
+  /**
+   * Attempts to renew the authentication token passed to {@link Database#useBearerAuth}
+   * or returned and used by {@link Database#login}. If a new authentication
+   * token is issued, it will be used for future requests and returned.
+   *
+   * @example
+   * ```js
+   * const db = new Database();
+   * await db.login("admin", "hunter2");
+   * // ... later ...
+   * const newToken = await db.renewAuthToken();
+   * if (!newToken) // no new token issued
+   * ```
+   */
+  renewAuthToken(): Promise<string | null> {
+    return this.request(
+      {
+        method: "POST",
+        path: "/_open/auth/renew",
+      },
+      (res) => {
+        if (!res.body.jwt) return null;
+        this.useBearerAuth(res.body.jwt);
+        return res.body.jwt;
+      }
+    );
+  }
   //#endregion
 
   //#region databases