Introduce explicity resource management to Driver and Session objects (#1154)

This is a TC39 [proposal](https://github.com/tc39/proposal-explicit-resource-management) which is already implemented in Typescript 5.2, core-js, babel and other polyfill tools.

This feature enables the user create the driver or a session with the `await using` keywords and then do not have to close the resource afterwards, since this resources will be closed after leaving the block which were created at.

For example:

```typescript
await using driver = neo4j.driver(uri, authToken)
await using session = driver.session()

await session.executeRead(tx => "RETURN 1")
```

Since Deno is more strict with typescript, small fixes had to be done in the driver.

* Add a value to Result[Symbol.toStringTag].
* Fix Integer.shiftRight function to add proper integer conversion it.

A package.json file was added to the `neo4j-driver-deno` folder for making easier to integrate the test runners to the environments.

Author: bigmontz

package.json

@@ -40,8 +40,8 @@
   "scripts": {
     "clean": "lerna clean -y && lerna run clean",
     "build": "lerna bootstrap --ci",
-    "set_version::deno": "cd ./packages/neo4j-driver-deno && deno run --allow-read --allow-write ./versioning.ts --output=. --filename=current.version.ts", 
-    "build::deno": "cd ./packages/neo4j-driver-deno && deno run --allow-read --allow-write --allow-net ./generate.ts",
+    "set_version::deno": "lerna run set_version --scope neo4j-driver-deno --stream -- ", 
+    "build::deno": "lerna run build --scope neo4j-driver-deno --stream --  ",
     "build::notci": "lerna bootstrap",
     "docs": "lerna run docs --stream --concurrency 1",
     "test::unit": "lerna run test::unit --stream",

packages/core/src/driver.ts

@@ -776,6 +776,12 @@ class Driver {
     return Promise.resolve()
   }
 
+  // eslint-disable-next-line
+  // @ts-ignore
+  [Symbol.asyncDispose] (): Promise<void> {
+    return this.close()
+  }
+
   /**
    * @protected
    * @returns {void}

packages/core/src/integer.ts

@@ -695,10 +695,11 @@ class Integer {
    */
   shiftRight (numBits: number | Integer): Integer {
     let bitsCount: number = Integer.toNumber(numBits)
+    const numBitNum: number = Integer.toNumber(numBits)
 
     if ((bitsCount &= 63) === 0) {
       return Integer.ZERO
-    } else if (numBits < 32) {
+    } else if (numBitNum < 32) {
       return Integer.fromBits(
         (this.low >>> bitsCount) | (this.high << (32 - bitsCount)),
         this.high >> bitsCount

packages/core/src/result.ts

@@ -375,7 +375,7 @@ class Result<R extends RecordShape = RecordShape> implements Promise<QueryResult
    * @param {function()|null} onfinally - function when the promise finished
    * @return {Promise} promise.
    */
-  [Symbol.toStringTag]: string
+  [Symbol.toStringTag]: string = 'Result'
   finally (onfinally?: (() => void) | null): Promise<QueryResult<R>> {
     return this._getOrCreatePromise().finally(onfinally)
   }

packages/core/src/session.ts

@@ -561,6 +561,12 @@ class Session {
     }
   }
 
+  // eslint-disable-next-line
+  // @ts-ignore
+  [Symbol.asyncDispose] (): Promise<void> {
+    return this.close()
+  }
+
   _connectionHolderWithMode (mode: SessionMode): ConnectionHolder {
     if (mode === ACCESS_MODE_READ) {
       return this._readConnectionHolder

packages/neo4j-driver-deno/lib/core/driver.ts

@@ -776,6 +776,12 @@ class Driver {
     return Promise.resolve()
   }
 
+  // eslint-disable-next-line
+  // @ts-ignore
+  [Symbol.asyncDispose] (): Promise<void> {
+    return this.close()
+  }
+
   /**
    * @protected
    * @returns {void}

packages/neo4j-driver-deno/lib/core/integer.ts

@@ -695,10 +695,11 @@ class Integer {
    */
   shiftRight (numBits: number | Integer): Integer {
     let bitsCount: number = Integer.toNumber(numBits)
+    const numBitNum: number = Integer.toNumber(numBits)
 
     if ((bitsCount &= 63) === 0) {
       return Integer.ZERO
-    } else if (numBits < 32) {
+    } else if (numBitNum < 32) {
       return Integer.fromBits(
         (this.low >>> bitsCount) | (this.high << (32 - bitsCount)),
         this.high >> bitsCount

packages/neo4j-driver-deno/lib/core/result.ts

@@ -375,7 +375,7 @@ class Result<R extends RecordShape = RecordShape> implements Promise<QueryResult
    * @param {function()|null} onfinally - function when the promise finished
    * @return {Promise} promise.
    */
-  [Symbol.toStringTag]: string
+  [Symbol.toStringTag]: string = 'Result'
   finally (onfinally?: (() => void) | null): Promise<QueryResult<R>> {
     return this._getOrCreatePromise().finally(onfinally)
   }

packages/neo4j-driver-deno/lib/core/session.ts

@@ -561,6 +561,12 @@ class Session {
     }
   }
 
+  // eslint-disable-next-line
+  // @ts-ignore
+  [Symbol.asyncDispose] (): Promise<void> {
+    return this.close()
+  }
+
   _connectionHolderWithMode (mode: SessionMode): ConnectionHolder {
     if (mode === ACCESS_MODE_READ) {
       return this._readConnectionHolder

packages/neo4j-driver-deno/package.json

@@ -0,0 +1,19 @@
+{
+  "name": "neo4j-driver-deno",
+  "version": "5.0.0-dev",
+  "description": "Package just used for running scripts",
+  "private": true,
+  "main": "index.js",
+  "directories": {
+    "lib": "lib",
+    "test": "test"
+  },
+  "scripts": {
+    "test": "npm run test::integration",
+    "test::integration": "deno test --allow-all ./test",
+    "set_version": "deno run --allow-read --allow-write ./versioning.ts --output=. --filename=current.version.ts",
+    "build": "deno run --allow-read --allow-write --allow-net ./generate.ts"
+  },
+  "author": "Neo4j",
+  "license": "Apache-2.0"
+}