@pluv/client 0.43.0 → 0.44.1

package/.turbo/turbo-build.log

@@ -1,5 +1,5 @@
 
-> @pluv/client@0.43.0 build /home/runner/work/pluv/pluv/packages/client
+> @pluv/client@0.44.1 build /home/runner/work/pluv/pluv/packages/client
 > tsup src/index.ts --format esm,cjs --dts
 
 CLI Building entry: src/index.ts
@@ -8,11 +8,11 @@
 CLI Target: es6
 ESM Build start
 CJS Build start
-CJS dist/index.js 57.65 KB
-CJS ⚡️ Build success in 115ms
-ESM dist/index.mjs 56.33 KB
-ESM ⚡️ Build success in 116ms
+ESM dist/index.mjs 56.50 KB
+ESM ⚡️ Build success in 128ms
+CJS dist/index.js 57.82 KB
+CJS ⚡️ Build success in 129ms
 DTS Build start
-DTS ⚡️ Build success in 3550ms
-DTS dist/index.d.mts 25.24 KB
-DTS dist/index.d.ts  25.24 KB
+DTS ⚡️ Build success in 3277ms
+DTS dist/index.d.mts 25.36 KB
+DTS dist/index.d.ts  25.36 KB

package/CHANGELOG.md

@@ -1,5 +1,26 @@
 # @pluv/client
 
+## 0.44.1
+
+### Patch Changes
+
+- 67c081d: Fix `PluvRoom._reconnect` not being called with the last used metadata (from `PluvRoom.connect`).
+  - @pluv/crdt@0.44.1
+  - @pluv/types@0.44.1
+
+## 0.44.0
+
+### Minor Changes
+
+- c9fcea5: **BREAKING** The `ConnectionState` enum is now a `const` to avoid several pitfalls of using TypeScript enums.
+
+### Patch Changes
+
+- fba9354: Fix potential edge case where event handlers may be called redundantly.
+- bc2d684: Fix `PluvRoom` not properly reconnecting when connections are unavailable.
+  - @pluv/crdt@0.44.0
+  - @pluv/types@0.44.0
+
 ## 0.43.0
 
 ### Patch Changes

package/dist/index.d.mts

@@ -6,13 +6,14 @@ import { Subject } from 'wonka';
 
 type EventNotifierSubscriptionCallback<TIO extends IOLike<any, any>, TEvent extends keyof InferIOOutput<TIO>> = (value: Id<IOEventMessage<TIO, TEvent>>) => void;
 
-declare enum ConnectionState {
-    Closed = "Closed",
-    Connecting = "Connecting",
-    Open = "Open",
-    Unavailable = "Unavailable",
-    Untouched = "Untouched"
-}
+declare const ConnectionState: {
+    readonly Closed: "Closed";
+    readonly Connecting: "Connecting";
+    readonly Open: "Open";
+    readonly Unavailable: "Unavailable";
+    readonly Untouched: "Untouched";
+};
+type ConnectionState = (typeof ConnectionState)[keyof typeof ConnectionState];
 
 declare const identity: <T extends unknown>(x: T) => T;
 

package/dist/index.d.ts

@@ -6,13 +6,14 @@ import { Subject } from 'wonka';
 
 type EventNotifierSubscriptionCallback<TIO extends IOLike<any, any>, TEvent extends keyof InferIOOutput<TIO>> = (value: Id<IOEventMessage<TIO, TEvent>>) => void;
 
-declare enum ConnectionState {
-    Closed = "Closed",
-    Connecting = "Connecting",
-    Open = "Open",
-    Unavailable = "Unavailable",
-    Untouched = "Untouched"
-}
+declare const ConnectionState: {
+    readonly Closed: "Closed";
+    readonly Connecting: "Connecting";
+    readonly Open: "Open";
+    readonly Unavailable: "Unavailable";
+    readonly Untouched: "Untouched";
+};
+type ConnectionState = (typeof ConnectionState)[keyof typeof ConnectionState];
 
 declare const identity: <T extends unknown>(x: T) => T;
 

package/dist/index.js

@@ -172,7 +172,7 @@ var CrdtManager = class {
   }
   _applyDocUpdates(doc, updates, origin) {
     doc.transact(() => {
-      doc.batchApplyEncodedState(updates.map((update) => ({ origin, update })));
+      doc.batchApplyEncodedState({ origin, updates });
     }, origin);
     return doc;
   }
@@ -535,14 +535,13 @@ var UsersManager = class {
 };
 
 // src/enums.ts
-var ConnectionState = /* @__PURE__ */ ((ConnectionState2) => {
-  ConnectionState2["Closed"] = "Closed";
-  ConnectionState2["Connecting"] = "Connecting";
-  ConnectionState2["Open"] = "Open";
-  ConnectionState2["Unavailable"] = "Unavailable";
-  ConnectionState2["Untouched"] = "Untouched";
-  return ConnectionState2;
-})(ConnectionState || {});
+var ConnectionState = {
+  Closed: "Closed",
+  Connecting: "Connecting",
+  Open: "Open",
+  Unavailable: "Unavailable",
+  Untouched: "Untouched"
+};
 
 // src/PluvRoom.ts
 var ADD_TO_STORAGE_STATE_DEBOUNCE_MS = 1e3;
@@ -599,7 +598,7 @@ var PluvRoom = class extends AbstractRoom {
         attempts: 0,
         count: 0,
         id: null,
-        state: "Untouched" /* Untouched */
+        state: ConnectionState.Untouched
       },
       webSocket: null
     };
@@ -608,7 +607,7 @@ var PluvRoom = class extends AbstractRoom {
     this.broadcast = new Proxy(
       (event, data) => __async(this, null, function* () {
         if (!this._state.webSocket) return;
-        if (this._state.connection.state !== "Open" /* Open */) return;
+        if (this._state.connection.state !== ConnectionState.Open) return;
         const type = event.toString();
         const procedure = this._router._defs.events[type];
         if (!(procedure == null ? void 0 : procedure.config.broadcast)) {
@@ -765,13 +764,13 @@ var PluvRoom = class extends AbstractRoom {
       const params = (_a = args[0]) != null ? _a : {};
       const metadata = params.metadata;
       this._setMetadata(metadata);
-      const canConnect = ["Closed" /* Closed */, "Untouched" /* Untouched */].some(
+      const canConnect = [ConnectionState.Closed, ConnectionState.Unavailable, ConnectionState.Untouched].some(
         (state) => this._state.connection.state === state
       );
       if (!canConnect) return;
       this._clearTimeout(this._timeouts.reconnect);
       this._updateState((oldState) => {
-        oldState.connection.state = "Connecting" /* Connecting */;
+        oldState.connection.state = ConnectionState.Connecting;
         return oldState;
       });
       yield this._storageStore.initialize();
@@ -809,7 +808,7 @@ var PluvRoom = class extends AbstractRoom {
   disconnect() {
     return __async(this, null, function* () {
       if (!this._state.webSocket) return;
-      const canDisconnect = ["Connecting" /* Connecting */, "Open" /* Open */].some(
+      const canDisconnect = [ConnectionState.Connecting, ConnectionState.Open].some(
         (state) => this._state.connection.state === state
       );
       if (!canDisconnect) return;
@@ -818,7 +817,7 @@ var PluvRoom = class extends AbstractRoom {
       this._clearTimeout(this._timeouts.reconnect);
       this._updateState((oldState) => {
         oldState.authorization.token = null;
-        oldState.connection.state = "Closed" /* Closed */;
+        oldState.connection.state = ConnectionState.Closed;
         oldState.webSocket = null;
         return oldState;
       });
@@ -857,7 +856,7 @@ var PluvRoom = class extends AbstractRoom {
   _attachWindowListeners() {
     if (typeof window === "undefined") return;
     if (typeof document === "undefined") return;
-    this._windowListeners = {
+    this._windowListeners = this._windowListeners || {
       onNavigatorOffline: this._onNavigatorOffline.bind(this),
       onNavigatorOnline: this._onNavigatorOnline.bind(this),
       onVisibilityChange: this._onVisibilityChange.bind(this)
@@ -868,7 +867,7 @@ var PluvRoom = class extends AbstractRoom {
   }
   _attachWsListeners() {
     if (!this._state.webSocket) return;
-    this._wsListeners = {
+    this._wsListeners = this._wsListeners || {
       onClose: this._onClose.bind(this),
       onError: this._onError.bind(this),
       onMessage: this._onMessage.bind(this),
@@ -1188,7 +1187,7 @@ var PluvRoom = class extends AbstractRoom {
     const authError = error instanceof Error ? error : new Error("Authorization failed");
     this._listeners.onAuthorizationFail(authError);
     this._updateState((oldState) => {
-      oldState.connection.state = "Unavailable" /* Unavailable */;
+      oldState.connection.state = ConnectionState.Unavailable;
       return oldState;
     });
   }
@@ -1212,7 +1211,15 @@ var PluvRoom = class extends AbstractRoom {
       ].some((okToRetryCode) => event.code === okToRetryCode);
       this._updateState((oldState) => {
         oldState.authorization.token = null;
-        oldState.connection.state = shouldRetry ? "Unavailable" /* Unavailable */ : "Closed" /* Closed */;
+        oldState.connection.state = shouldRetry ? ConnectionState.Unavailable : (
+          /**
+           * !HACK
+           * @description Assume these are not recoverable. We're just going to mark this
+           * as Closed to avoid reconnect attempts.
+           * @date April 28, 2025
+           */
+          ConnectionState.Closed
+        );
         oldState.webSocket = null;
         return oldState;
       });
@@ -1280,10 +1287,10 @@ var PluvRoom = class extends AbstractRoom {
     }
   }
   _onOpen() {
-    if (this._state.connection.state !== "Connecting" /* Connecting */) return;
+    if (this._state.connection.state !== ConnectionState.Connecting) return;
     this._logDebug("WebSocket connected");
     this._updateState((oldState) => {
-      oldState.connection.state = "Open" /* Open */;
+      oldState.connection.state = ConnectionState.Open;
       return oldState;
     });
     this._clearInterval(this._intervals.heartbeat);
@@ -1291,16 +1298,16 @@ var PluvRoom = class extends AbstractRoom {
   }
   _onNavigatorOffline() {
     return __async(this, null, function* () {
-      if (this._state.connection.state === "Closed" /* Closed */) return;
+      if (this._state.connection.state === ConnectionState.Closed) return;
       this._updateState((oldState) => {
-        oldState.connection.state = "Unavailable" /* Unavailable */;
+        oldState.connection.state = ConnectionState.Unavailable;
         return oldState;
       });
     });
   }
   _onNavigatorOnline() {
     return __async(this, null, function* () {
-      if (this._state.connection.state !== "Unavailable" /* Unavailable */) return;
+      if (this._state.connection.state !== ConnectionState.Unavailable) return;
       yield this._reconnect();
     });
   }
@@ -1309,12 +1316,12 @@ var PluvRoom = class extends AbstractRoom {
       if (typeof document === "undefined") return;
       if (document.visibilityState !== "visible") return;
       switch (this._state.connection.state) {
-        case "Open" /* Open */: {
+        case ConnectionState.Open: {
           this._clearInterval(this._intervals.heartbeat);
           setInterval(this._heartbeat.bind(this), HEARTBEAT_INTERVAL_MS);
           return;
         }
-        case "Unavailable" /* Unavailable */: {
+        case ConnectionState.Unavailable: {
           yield this._reconnect();
           return;
         }
@@ -1342,8 +1349,8 @@ var PluvRoom = class extends AbstractRoom {
   }
   _reconnect() {
     return __async(this, null, function* () {
-      if (!this._state.webSocket) return;
       this._closeWs();
+      if (this._state.connection.state === ConnectionState.Closed) return;
       const metadata = this._lastMetadata;
       const params = typeof metadata === "undefined" ? [] : [{ metadata }];
       yield this.connect(...params);
@@ -1368,7 +1375,9 @@ var PluvRoom = class extends AbstractRoom {
     webSocket.send(message);
   }
   _setMetadata(metadata) {
-    return this.metadata ? this.metadata.parse(metadata) : metadata;
+    const parsed = this.metadata ? this.metadata.parse(metadata) : metadata;
+    this._lastMetadata = parsed;
+    return parsed;
   }
   _updateState(updater) {
     let authorization;
@@ -1508,7 +1517,7 @@ var MockedRoom = class extends AbstractRoom {
         attempts: 0,
         count: 1,
         id: null,
-        state: "Untouched" /* Untouched */
+        state: ConnectionState.Untouched
       },
       webSocket: null
     };
@@ -1519,7 +1528,7 @@ var MockedRoom = class extends AbstractRoom {
     this.broadcast = new Proxy(
       (event, data) => __async(this, null, function* () {
         if (!this._state.webSocket) return;
-        if (this._state.connection.state !== "Open" /* Open */) return;
+        if (this._state.connection.state !== ConnectionState.Open) return;
         const type = event.toString();
         const procedure = this._router._defs.events[type];
         if (!(procedure == null ? void 0 : procedure.config.broadcast)) {

package/dist/index.mjs

@@ -141,7 +141,7 @@ var CrdtManager = class {
   }
   _applyDocUpdates(doc, updates, origin) {
     doc.transact(() => {
-      doc.batchApplyEncodedState(updates.map((update) => ({ origin, update })));
+      doc.batchApplyEncodedState({ origin, updates });
     }, origin);
     return doc;
   }
@@ -504,14 +504,13 @@ var UsersManager = class {
 };
 
 // src/enums.ts
-var ConnectionState = /* @__PURE__ */ ((ConnectionState2) => {
-  ConnectionState2["Closed"] = "Closed";
-  ConnectionState2["Connecting"] = "Connecting";
-  ConnectionState2["Open"] = "Open";
-  ConnectionState2["Unavailable"] = "Unavailable";
-  ConnectionState2["Untouched"] = "Untouched";
-  return ConnectionState2;
-})(ConnectionState || {});
+var ConnectionState = {
+  Closed: "Closed",
+  Connecting: "Connecting",
+  Open: "Open",
+  Unavailable: "Unavailable",
+  Untouched: "Untouched"
+};
 
 // src/PluvRoom.ts
 var ADD_TO_STORAGE_STATE_DEBOUNCE_MS = 1e3;
@@ -568,7 +567,7 @@ var PluvRoom = class extends AbstractRoom {
         attempts: 0,
         count: 0,
         id: null,
-        state: "Untouched" /* Untouched */
+        state: ConnectionState.Untouched
       },
       webSocket: null
     };
@@ -577,7 +576,7 @@ var PluvRoom = class extends AbstractRoom {
     this.broadcast = new Proxy(
       (event, data) => __async(this, null, function* () {
         if (!this._state.webSocket) return;
-        if (this._state.connection.state !== "Open" /* Open */) return;
+        if (this._state.connection.state !== ConnectionState.Open) return;
         const type = event.toString();
         const procedure = this._router._defs.events[type];
         if (!(procedure == null ? void 0 : procedure.config.broadcast)) {
@@ -734,13 +733,13 @@ var PluvRoom = class extends AbstractRoom {
       const params = (_a = args[0]) != null ? _a : {};
       const metadata = params.metadata;
       this._setMetadata(metadata);
-      const canConnect = ["Closed" /* Closed */, "Untouched" /* Untouched */].some(
+      const canConnect = [ConnectionState.Closed, ConnectionState.Unavailable, ConnectionState.Untouched].some(
         (state) => this._state.connection.state === state
       );
       if (!canConnect) return;
       this._clearTimeout(this._timeouts.reconnect);
       this._updateState((oldState) => {
-        oldState.connection.state = "Connecting" /* Connecting */;
+        oldState.connection.state = ConnectionState.Connecting;
         return oldState;
       });
       yield this._storageStore.initialize();
@@ -778,7 +777,7 @@ var PluvRoom = class extends AbstractRoom {
   disconnect() {
     return __async(this, null, function* () {
       if (!this._state.webSocket) return;
-      const canDisconnect = ["Connecting" /* Connecting */, "Open" /* Open */].some(
+      const canDisconnect = [ConnectionState.Connecting, ConnectionState.Open].some(
         (state) => this._state.connection.state === state
       );
       if (!canDisconnect) return;
@@ -787,7 +786,7 @@ var PluvRoom = class extends AbstractRoom {
       this._clearTimeout(this._timeouts.reconnect);
       this._updateState((oldState) => {
         oldState.authorization.token = null;
-        oldState.connection.state = "Closed" /* Closed */;
+        oldState.connection.state = ConnectionState.Closed;
         oldState.webSocket = null;
         return oldState;
       });
@@ -826,7 +825,7 @@ var PluvRoom = class extends AbstractRoom {
   _attachWindowListeners() {
     if (typeof window === "undefined") return;
     if (typeof document === "undefined") return;
-    this._windowListeners = {
+    this._windowListeners = this._windowListeners || {
       onNavigatorOffline: this._onNavigatorOffline.bind(this),
       onNavigatorOnline: this._onNavigatorOnline.bind(this),
       onVisibilityChange: this._onVisibilityChange.bind(this)
@@ -837,7 +836,7 @@ var PluvRoom = class extends AbstractRoom {
   }
   _attachWsListeners() {
     if (!this._state.webSocket) return;
-    this._wsListeners = {
+    this._wsListeners = this._wsListeners || {
       onClose: this._onClose.bind(this),
       onError: this._onError.bind(this),
       onMessage: this._onMessage.bind(this),
@@ -1157,7 +1156,7 @@ var PluvRoom = class extends AbstractRoom {
     const authError = error instanceof Error ? error : new Error("Authorization failed");
     this._listeners.onAuthorizationFail(authError);
     this._updateState((oldState) => {
-      oldState.connection.state = "Unavailable" /* Unavailable */;
+      oldState.connection.state = ConnectionState.Unavailable;
       return oldState;
     });
   }
@@ -1181,7 +1180,15 @@ var PluvRoom = class extends AbstractRoom {
       ].some((okToRetryCode) => event.code === okToRetryCode);
       this._updateState((oldState) => {
         oldState.authorization.token = null;
-        oldState.connection.state = shouldRetry ? "Unavailable" /* Unavailable */ : "Closed" /* Closed */;
+        oldState.connection.state = shouldRetry ? ConnectionState.Unavailable : (
+          /**
+           * !HACK
+           * @description Assume these are not recoverable. We're just going to mark this
+           * as Closed to avoid reconnect attempts.
+           * @date April 28, 2025
+           */
+          ConnectionState.Closed
+        );
         oldState.webSocket = null;
         return oldState;
       });
@@ -1249,10 +1256,10 @@ var PluvRoom = class extends AbstractRoom {
     }
   }
   _onOpen() {
-    if (this._state.connection.state !== "Connecting" /* Connecting */) return;
+    if (this._state.connection.state !== ConnectionState.Connecting) return;
     this._logDebug("WebSocket connected");
     this._updateState((oldState) => {
-      oldState.connection.state = "Open" /* Open */;
+      oldState.connection.state = ConnectionState.Open;
       return oldState;
     });
     this._clearInterval(this._intervals.heartbeat);
@@ -1260,16 +1267,16 @@ var PluvRoom = class extends AbstractRoom {
   }
   _onNavigatorOffline() {
     return __async(this, null, function* () {
-      if (this._state.connection.state === "Closed" /* Closed */) return;
+      if (this._state.connection.state === ConnectionState.Closed) return;
       this._updateState((oldState) => {
-        oldState.connection.state = "Unavailable" /* Unavailable */;
+        oldState.connection.state = ConnectionState.Unavailable;
         return oldState;
       });
     });
   }
   _onNavigatorOnline() {
     return __async(this, null, function* () {
-      if (this._state.connection.state !== "Unavailable" /* Unavailable */) return;
+      if (this._state.connection.state !== ConnectionState.Unavailable) return;
       yield this._reconnect();
     });
   }
@@ -1278,12 +1285,12 @@ var PluvRoom = class extends AbstractRoom {
       if (typeof document === "undefined") return;
       if (document.visibilityState !== "visible") return;
       switch (this._state.connection.state) {
-        case "Open" /* Open */: {
+        case ConnectionState.Open: {
           this._clearInterval(this._intervals.heartbeat);
           setInterval(this._heartbeat.bind(this), HEARTBEAT_INTERVAL_MS);
           return;
         }
-        case "Unavailable" /* Unavailable */: {
+        case ConnectionState.Unavailable: {
           yield this._reconnect();
           return;
         }
@@ -1311,8 +1318,8 @@ var PluvRoom = class extends AbstractRoom {
   }
   _reconnect() {
     return __async(this, null, function* () {
-      if (!this._state.webSocket) return;
       this._closeWs();
+      if (this._state.connection.state === ConnectionState.Closed) return;
       const metadata = this._lastMetadata;
       const params = typeof metadata === "undefined" ? [] : [{ metadata }];
       yield this.connect(...params);
@@ -1337,7 +1344,9 @@ var PluvRoom = class extends AbstractRoom {
     webSocket.send(message);
   }
   _setMetadata(metadata) {
-    return this.metadata ? this.metadata.parse(metadata) : metadata;
+    const parsed = this.metadata ? this.metadata.parse(metadata) : metadata;
+    this._lastMetadata = parsed;
+    return parsed;
   }
   _updateState(updater) {
     let authorization;
@@ -1477,7 +1486,7 @@ var MockedRoom = class extends AbstractRoom {
         attempts: 0,
         count: 1,
         id: null,
-        state: "Untouched" /* Untouched */
+        state: ConnectionState.Untouched
       },
       webSocket: null
     };
@@ -1488,7 +1497,7 @@ var MockedRoom = class extends AbstractRoom {
     this.broadcast = new Proxy(
       (event, data) => __async(this, null, function* () {
         if (!this._state.webSocket) return;
-        if (this._state.connection.state !== "Open" /* Open */) return;
+        if (this._state.connection.state !== ConnectionState.Open) return;
         const type = event.toString();
         const procedure = this._router._defs.events[type];
         if (!(procedure == null ? void 0 : procedure.config.broadcast)) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pluv/client",
-  "version": "0.43.0",
+  "version": "0.44.1",
   "description": "@pluv/io frontend client",
   "author": "leedavidcs",
   "license": "MIT",
@@ -18,15 +18,15 @@
   },
   "dependencies": {
     "wonka": "^6.3.5",
-    "@pluv/crdt": "^0.43.0",
-    "@pluv/types": "^0.43.0"
+    "@pluv/crdt": "^0.44.1",
+    "@pluv/types": "^0.44.1"
   },
   "devDependencies": {
     "eslint": "^9.25.1",
     "tsup": "^8.4.0",
     "typescript": "^5.8.3",
-    "@pluv/tsconfig": "^0.43.0",
-    "eslint-config-pluv": "^0.43.0"
+    "@pluv/tsconfig": "^0.44.1",
+    "eslint-config-pluv": "^0.44.1"
   },
   "scripts": {
     "build": "tsup src/index.ts --format esm,cjs --dts",

package/src/CrdtManager.ts

@@ -93,7 +93,7 @@ export class CrdtManager<TStorage extends Record<string, CrdtType<any, any>>> {
         origin?: string,
     ): AbstractCrdtDoc<TStorage> {
         doc.transact(() => {
-            doc.batchApplyEncodedState(updates.map((update) => ({ origin, update })));
+            doc.batchApplyEncodedState({ origin, updates });
         }, origin);
 
         return doc;

package/src/PluvRoom.ts

@@ -363,7 +363,7 @@ export class PluvRoom<
 
         this._setMetadata(metadata);
 
-        const canConnect = [ConnectionState.Closed, ConnectionState.Untouched].some(
+        const canConnect = [ConnectionState.Closed, ConnectionState.Unavailable, ConnectionState.Untouched].some(
             (state) => this._state.connection.state === state,
         );
 
@@ -615,7 +615,7 @@ export class PluvRoom<
         if (typeof window === "undefined") return;
         if (typeof document === "undefined") return;
 
-        this._windowListeners = {
+        this._windowListeners = this._windowListeners || {
             onNavigatorOffline: this._onNavigatorOffline.bind(this),
             onNavigatorOnline: this._onNavigatorOnline.bind(this),
             onVisibilityChange: this._onVisibilityChange.bind(this),
@@ -629,7 +629,7 @@ export class PluvRoom<
     private _attachWsListeners(): void {
         if (!this._state.webSocket) return;
 
-        this._wsListeners = {
+        this._wsListeners = this._wsListeners || {
             onClose: this._onClose.bind(this),
             onError: this._onError.bind(this),
             onMessage: this._onMessage.bind(this),
@@ -1152,7 +1152,15 @@ export class PluvRoom<
 
         this._updateState((oldState) => {
             oldState.authorization.token = null;
-            oldState.connection.state = shouldRetry ? ConnectionState.Unavailable : ConnectionState.Closed;
+            oldState.connection.state = shouldRetry
+                ? ConnectionState.Unavailable
+                : /**
+                   * !HACK
+                   * @description Assume these are not recoverable. We're just going to mark this
+                   * as Closed to avoid reconnect attempts.
+                   * @date April 28, 2025
+                   */
+                  ConnectionState.Closed;
             oldState.webSocket = null;
 
             return oldState;
@@ -1314,10 +1322,16 @@ export class PluvRoom<
     }
 
     private async _reconnect(): Promise<void> {
-        if (!this._state.webSocket) return;
-
         this._closeWs();
 
+        /**
+         * @description User has manually closed this connection. We're not going to retry, since
+         * the user probably intends for this to stay closed. They will need to invoke connect
+         * themselves.
+         * @date April 28, 2025
+         */
+        if (this._state.connection.state === ConnectionState.Closed) return;
+
         const metadata = this._lastMetadata;
         const params = (typeof metadata === "undefined" ? [] : [{ metadata }]) as RoomConnectParams<TMetadata>;
 
@@ -1357,7 +1371,11 @@ export class PluvRoom<
     }
 
     private _setMetadata(metadata: TMetadata): TMetadata {
-        return this.metadata ? this.metadata.parse(metadata) : metadata;
+        const parsed = this.metadata ? this.metadata.parse(metadata) : metadata;
+
+        this._lastMetadata = parsed;
+
+        return parsed;
     }
 
     private _updateState(updater: (oldState: WebSocketState<TIO>) => WebSocketState<TIO>): WebSocketState<TIO> {

package/src/enums.ts

@@ -1,7 +1,9 @@
-export enum ConnectionState {
-    Closed = "Closed",
-    Connecting = "Connecting",
-    Open = "Open",
-    Unavailable = "Unavailable",
-    Untouched = "Untouched",
-}
+export const ConnectionState = {
+    Closed: "Closed",
+    Connecting: "Connecting",
+    Open: "Open",
+    Unavailable: "Unavailable",
+    Untouched: "Untouched",
+} as const;
+
+export type ConnectionState = (typeof ConnectionState)[keyof typeof ConnectionState];