fix(sdks/actor/client): make disconnect async & await for socket close (

#1733)

<!-- Please make sure there is an issue that this PR is correlated to. -->

## Changes

<!-- If there are frontend changes, please include screenshots. -->

sdks/actor/client/src/handle.ts

@@ -333,23 +333,28 @@ export class ActorHandleRaw {
 	}
 
 	// TODO:Add destructor
-	disconnect() {
-		if (!this.#websocket) return;
-		this.#disconnected = true;
+	disconnect(): Promise<void> {
+		return new Promise(resolve => {
+			if (!this.#websocket) return;
+			this.#disconnected = true;
 
-		logger().debug("disconnecting");
+			logger().debug("disconnecting");
 
-		// TODO: What do we do with the queue?
+			// TODO: What do we do with the queue?
 
-		this.#websocket?.close();
-		this.#websocket = undefined;
+			if (this.#websocket) {
+				this.#websocket.addEventListener("close", () => resolve());
+				this.#websocket.close();
+				this.#websocket = undefined;
+			}
+		});
 	}
 
-	dispose() {
+	async dispose() {
 		logger().debug("disposing");
 
 		// TODO: this will error if not usable
-		this.disconnect();
+		await this.disconnect();
 	}
 
 	#sendSubscription(eventName: string, subscribe: boolean) {

site/src/content/docs/connections.mdx

@@ -88,15 +88,21 @@ class ChatRoom extends Actor {
 Connections can be disconnected with:
 
 ```typescript {{ "title": "actor.ts" }}
-connection.disconnect();
+await connection.disconnect();
 ```
 
 A reason can optionally be provided like:
 
 ```typescript {{ "title": "actor.ts" }}
-connection.disconnect('Too many requests');
+await connection.disconnect('Too many requests');
 ```
 
+<Tip>
+	Waiting the `disconnect` promise is not required, but recommended in order
+	to ensure the underlying network connections close cleanly before exiting
+	the program.
+</Tip>
+
 ## Offline & reconnection behavior
 
 Clients automatically attempt to reconnect (with [exponential backoff](https://docs.aws.amazon.com/prescriptive-guidance/latest/cloud-design-patterns/retry-backoff.html)) when disconnected. Remote procedure calls made while disconnected are queued.