@pluv/client 0.42.0 → 0.44.0

package/.turbo/turbo-build.log

@@ -1,5 +1,5 @@
 
-> @pluv/client@0.42.0 build /home/runner/work/pluv/pluv/packages/client
+> @pluv/client@0.44.0 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
-ESM dist/index.mjs 55.91 KB
+ESM dist/index.mjs 56.45 KB
 ESM ⚡️ Build success in 112ms
-CJS dist/index.js 57.22 KB
-CJS ⚡️ Build success in 118ms
+CJS dist/index.js 57.76 KB
+CJS ⚡️ Build success in 112ms
 DTS Build start
-DTS ⚡️ Build success in 3444ms
-DTS dist/index.d.mts 24.61 KB
-DTS dist/index.d.ts  24.61 KB
+DTS ⚡️ Build success in 3446ms
+DTS dist/index.d.mts 25.36 KB
+DTS dist/index.d.ts  25.36 KB

package/CHANGELOG.md

@@ -1,5 +1,36 @@
 # @pluv/client
 
+## 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
+
+- 65d9172: Added configurable limits for client-side validation. These should only be updated if you control the server and the server limits have been changed.
+
+  ```ts
+  // defaults
+  createClient({
+    limits: {
+      presenceMaxSize: 512,
+    },
+  });
+  ```
+
+  - @pluv/crdt@0.43.0
+  - @pluv/types@0.43.0
+
 ## 0.42.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;
 
@@ -84,6 +85,7 @@ type SubscriptionCallback<TIO extends IOLike, TPresence extends JsonObject, TSub
 
 type UsersManagerConfig<TPresence extends JsonObject = {}> = {
     initialPresence?: TPresence;
+    limits: PluvClientLimits;
     presence?: InputZodLike<TPresence>;
 };
 
@@ -130,6 +132,7 @@ type ReconnectTimeoutMs = number | ((params: ReconnectTimeoutMsParams) => number
 type RoomConfig<TIO extends IOLike, TMetadata extends JsonObject = {}, TPresence extends JsonObject = {}, TStorage extends Record<string, CrdtType<any, any>> = {}, TEvents extends PluvRouterEventConfig<TIO, TPresence, TStorage> = {}> = Id<{
     addons?: readonly PluvRoomAddon<TIO, TMetadata, TPresence, TStorage>[];
     debug?: boolean | PluvRoomDebug<TIO>;
+    limits: PluvClientLimits;
     onAuthorizationFail?: (error: Error) => void;
     metadata?: InputZodLike<TMetadata>;
     publicKey?: PublicKey<TMetadata>;
@@ -144,6 +147,7 @@ declare class PluvRoom<TIO extends IOLike<any, any>, TMetadata extends JsonObjec
     private readonly _debug;
     private readonly _eventNotifier;
     private readonly _intervals;
+    private readonly _limits;
     private readonly _listeners;
     private readonly _otherNotifier;
     private readonly _publicKey;
@@ -235,6 +239,11 @@ declare class PluvRoom<TIO extends IOLike<any, any>, TMetadata extends JsonObjec
 type PluvClientOptions<TIO extends IOLike<any, any>, TPresence extends JsonObject, TStorage extends Record<string, CrdtType<any, any>>, TMetadata extends JsonObject> = RoomEndpoints<TIO, TMetadata> & {
     debug?: boolean;
     initialStorage?: AbstractCrdtDocFactory<TStorage>;
+    /**
+     * @description Configurable limits defined for client-side validation. You should only set
+     * this if you control the server and have changed the limits there.
+     */
+    limits?: PluvClientLimits;
     metadata?: InputZodLike<TMetadata>;
     presence?: InputZodLike<TPresence>;
     publicKey?: PublicKey<TMetadata>;
@@ -255,6 +264,7 @@ declare class PluvClient<TIO extends IOLike<any, any>, TPresence extends JsonObj
     private readonly _authEndpoint;
     private readonly _debug;
     private readonly _initialStorage?;
+    private readonly _limits;
     private readonly _presence?;
     private readonly _publicKey;
     private readonly _rooms;
@@ -291,6 +301,12 @@ type MergeEventRecords<TEventRecords extends EventRecord<string, any>[], TRoot e
 ] ? MergeEventRecords<ITail, Omit<TRoot, keyof IHead> & {
     [P in keyof IHead]: TRoot extends Record<P, any> ? TRoot[P] | IHead[P] : IHead[P];
 }> : Id<TRoot>;
+interface PluvClientLimits {
+    /**
+     * @description Maximum size of presence object in bytes
+     */
+    presenceMaxSize?: number | null;
+}
 interface PublicKeyParams<TMetadata extends JsonObject> {
     metadata: TMetadata;
 }
@@ -368,19 +384,21 @@ type MockedRoomEvents<TIO extends IOLike> = Partial<{
 }>;
 type MockedRoomConfig<TIO extends IOLike, TPresence extends JsonObject = {}, TStorage extends Record<string, CrdtType<any, any>> = {}, TEvents extends PluvRouterEventConfig<TIO, TPresence, TStorage> = {}> = {
     events?: MockedRoomEvents<MergeEvents<TEvents, TIO>>;
+    limits?: PluvClientLimits;
     router?: PluvRouter<TIO, TPresence, TStorage, TEvents>;
-} & Pick<CrdtManagerOptions<TStorage>, "initialStorage"> & UsersManagerConfig<TPresence>;
+} & Pick<CrdtManagerOptions<TStorage>, "initialStorage"> & Omit<UsersManagerConfig<TPresence>, "limits">;
 declare class MockedRoom<TIO extends IOLike, TPresence extends JsonObject = {}, TStorage extends Record<string, CrdtType<any, any>> = {}, TEvents extends PluvRouterEventConfig<TIO, TPresence, TStorage> = {}> extends AbstractRoom<TIO, TPresence, TStorage> {
-    private _crdtManager;
-    private _crdtNotifier;
-    private _eventNotifier;
-    private _events?;
-    private _otherNotifier;
-    private _router;
+    private readonly _crdtManager;
+    private readonly _crdtNotifier;
+    private readonly _eventNotifier;
+    private readonly _events?;
+    private readonly _limits;
+    private readonly _otherNotifier;
+    private readonly _router;
     private _state;
-    private _stateNotifier;
-    private _subscriptions;
-    private _usersManager;
+    private readonly _stateNotifier;
+    private readonly _subscriptions;
+    private readonly _usersManager;
     constructor(room: string, options: MockedRoomConfig<TIO, TPresence, TStorage, TEvents>);
     get storageLoaded(): boolean;
     broadcast: (<TEvent extends keyof InferIOInput<MergeEvents<TEvents, TIO>>>(event: TEvent, data: Id<InferIOInput<MergeEvents<TEvents, TIO>>[TEvent]>) => Promise<void>) & { [event in keyof InferIOInput<TIO>]: (data: Id<InferIOInput<TIO>[event]>) => Promise<void>; };

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;
 
@@ -84,6 +85,7 @@ type SubscriptionCallback<TIO extends IOLike, TPresence extends JsonObject, TSub
 
 type UsersManagerConfig<TPresence extends JsonObject = {}> = {
     initialPresence?: TPresence;
+    limits: PluvClientLimits;
     presence?: InputZodLike<TPresence>;
 };
 
@@ -130,6 +132,7 @@ type ReconnectTimeoutMs = number | ((params: ReconnectTimeoutMsParams) => number
 type RoomConfig<TIO extends IOLike, TMetadata extends JsonObject = {}, TPresence extends JsonObject = {}, TStorage extends Record<string, CrdtType<any, any>> = {}, TEvents extends PluvRouterEventConfig<TIO, TPresence, TStorage> = {}> = Id<{
     addons?: readonly PluvRoomAddon<TIO, TMetadata, TPresence, TStorage>[];
     debug?: boolean | PluvRoomDebug<TIO>;
+    limits: PluvClientLimits;
     onAuthorizationFail?: (error: Error) => void;
     metadata?: InputZodLike<TMetadata>;
     publicKey?: PublicKey<TMetadata>;
@@ -144,6 +147,7 @@ declare class PluvRoom<TIO extends IOLike<any, any>, TMetadata extends JsonObjec
     private readonly _debug;
     private readonly _eventNotifier;
     private readonly _intervals;
+    private readonly _limits;
     private readonly _listeners;
     private readonly _otherNotifier;
     private readonly _publicKey;
@@ -235,6 +239,11 @@ declare class PluvRoom<TIO extends IOLike<any, any>, TMetadata extends JsonObjec
 type PluvClientOptions<TIO extends IOLike<any, any>, TPresence extends JsonObject, TStorage extends Record<string, CrdtType<any, any>>, TMetadata extends JsonObject> = RoomEndpoints<TIO, TMetadata> & {
     debug?: boolean;
     initialStorage?: AbstractCrdtDocFactory<TStorage>;
+    /**
+     * @description Configurable limits defined for client-side validation. You should only set
+     * this if you control the server and have changed the limits there.
+     */
+    limits?: PluvClientLimits;
     metadata?: InputZodLike<TMetadata>;
     presence?: InputZodLike<TPresence>;
     publicKey?: PublicKey<TMetadata>;
@@ -255,6 +264,7 @@ declare class PluvClient<TIO extends IOLike<any, any>, TPresence extends JsonObj
     private readonly _authEndpoint;
     private readonly _debug;
     private readonly _initialStorage?;
+    private readonly _limits;
     private readonly _presence?;
     private readonly _publicKey;
     private readonly _rooms;
@@ -291,6 +301,12 @@ type MergeEventRecords<TEventRecords extends EventRecord<string, any>[], TRoot e
 ] ? MergeEventRecords<ITail, Omit<TRoot, keyof IHead> & {
     [P in keyof IHead]: TRoot extends Record<P, any> ? TRoot[P] | IHead[P] : IHead[P];
 }> : Id<TRoot>;
+interface PluvClientLimits {
+    /**
+     * @description Maximum size of presence object in bytes
+     */
+    presenceMaxSize?: number | null;
+}
 interface PublicKeyParams<TMetadata extends JsonObject> {
     metadata: TMetadata;
 }
@@ -368,19 +384,21 @@ type MockedRoomEvents<TIO extends IOLike> = Partial<{
 }>;
 type MockedRoomConfig<TIO extends IOLike, TPresence extends JsonObject = {}, TStorage extends Record<string, CrdtType<any, any>> = {}, TEvents extends PluvRouterEventConfig<TIO, TPresence, TStorage> = {}> = {
     events?: MockedRoomEvents<MergeEvents<TEvents, TIO>>;
+    limits?: PluvClientLimits;
     router?: PluvRouter<TIO, TPresence, TStorage, TEvents>;
-} & Pick<CrdtManagerOptions<TStorage>, "initialStorage"> & UsersManagerConfig<TPresence>;
+} & Pick<CrdtManagerOptions<TStorage>, "initialStorage"> & Omit<UsersManagerConfig<TPresence>, "limits">;
 declare class MockedRoom<TIO extends IOLike, TPresence extends JsonObject = {}, TStorage extends Record<string, CrdtType<any, any>> = {}, TEvents extends PluvRouterEventConfig<TIO, TPresence, TStorage> = {}> extends AbstractRoom<TIO, TPresence, TStorage> {
-    private _crdtManager;
-    private _crdtNotifier;
-    private _eventNotifier;
-    private _events?;
-    private _otherNotifier;
-    private _router;
+    private readonly _crdtManager;
+    private readonly _crdtNotifier;
+    private readonly _eventNotifier;
+    private readonly _events?;
+    private readonly _limits;
+    private readonly _otherNotifier;
+    private readonly _router;
     private _state;
-    private _stateNotifier;
-    private _subscriptions;
-    private _usersManager;
+    private readonly _stateNotifier;
+    private readonly _subscriptions;
+    private readonly _usersManager;
     constructor(room: string, options: MockedRoomConfig<TIO, TPresence, TStorage, TEvents>);
     get storageLoaded(): boolean;
     broadcast: (<TEvent extends keyof InferIOInput<MergeEvents<TEvents, TIO>>>(event: TEvent, data: Id<InferIOInput<MergeEvents<TEvents, TIO>>[TEvent]>) => Promise<void>) & { [event in keyof InferIOInput<TIO>]: (data: Id<InferIOInput<TIO>[event]>) => Promise<void>; };

package/dist/index.js

@@ -83,6 +83,9 @@ var AbstractStorageStore = class {
   }
 };
 
+// src/constants.ts
+var MAX_PRESENCE_SIZE_BYTES = 512;
+
 // src/PluvProcedure.ts
 var PluvProcedure = class _PluvProcedure {
   constructor(config = {}) {
@@ -169,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;
   }
@@ -317,9 +320,6 @@ var StorageStore = class extends AbstractStorageStore {
   }
 };
 
-// src/constants.ts
-var MAX_PRESENCE_SIZE_BYTES = 512;
-
 // src/utils/debounce.ts
 var debounce = (fn, options) => {
   const { wait, immediate = false } = options != null ? options : {};
@@ -364,8 +364,9 @@ var UsersManager = class {
     this._myself = null;
     this._others = /* @__PURE__ */ new Map();
     this._presence = null;
-    const { initialPresence, presence = null } = config;
+    const { initialPresence, limits, presence = null } = config;
     this.initialPresence = initialPresence;
+    this._limits = limits;
     this._myPresence = initialPresence;
     this._presence = presence;
   }
@@ -498,7 +499,7 @@ var UsersManager = class {
     const cleanedPresence = pickBy(this._myPresence, (value) => typeof value !== "undefined");
     const updated = __spreadValues(__spreadValues(__spreadValues({}, this.initialPresence), cleanedPresence), cleanedPatch);
     const bytes = new TextEncoder().encode(JSON.stringify(updated)).length;
-    if (bytes > MAX_PRESENCE_SIZE_BYTES) {
+    if (!!this._limits.presenceMaxSize && bytes > this._limits.presenceMaxSize) {
       throw new Error(
         `Large presence. Presence must be at most 512 bytes. Current size: ${bytes.toLocaleString()}`
       );
@@ -534,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;
@@ -563,6 +563,7 @@ var PluvRoom = class extends AbstractRoom {
       debug = false,
       initialPresence,
       initialStorage,
+      limits,
       metadata,
       onAuthorizationFail,
       presence,
@@ -597,7 +598,7 @@ var PluvRoom = class extends AbstractRoom {
         attempts: 0,
         count: 0,
         id: null,
-        state: "Untouched" /* Untouched */
+        state: ConnectionState.Untouched
       },
       webSocket: null
     };
@@ -606,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)) {
@@ -738,6 +739,7 @@ var PluvRoom = class extends AbstractRoom {
     this.metadata = metadata;
     this._debug = debug;
     this._endpoints = { authEndpoint, wsEndpoint };
+    this._limits = limits;
     this._reconnectTimeoutMs = reconnectTimeoutMs;
     this._storageStore = storage;
     if (!!publicKey) this._publicKey = publicKey;
@@ -747,7 +749,7 @@ var PluvRoom = class extends AbstractRoom {
       }
     };
     this._router = router != null ? router : new PluvRouter({});
-    this._usersManager = new UsersManager({ initialPresence, presence });
+    this._usersManager = new UsersManager({ initialPresence, limits: this._limits, presence });
     this._crdtManager = new CrdtManager({ initialStorage });
   }
   get storageLoaded() {
@@ -762,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();
@@ -806,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;
@@ -815,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;
       });
@@ -854,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)
@@ -865,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),
@@ -1185,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;
     });
   }
@@ -1209,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;
       });
@@ -1277,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);
@@ -1288,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();
     });
   }
@@ -1306,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;
         }
@@ -1339,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);
@@ -1402,6 +1412,7 @@ var PluvClient = class {
         debug: options.debug,
         initialPresence: options.initialPresence,
         initialStorage: this._initialStorage,
+        limits: this._limits,
         metadata: this.metadata,
         onAuthorizationFail: options.onAuthorizationFail,
         presence: this._presence,
@@ -1436,11 +1447,23 @@ var PluvClient = class {
       this._rooms.delete(toLeave.id);
       this._logDebug(`Left and deleted room: ${room}`);
     });
-    const { authEndpoint, debug = false, initialStorage, metadata, presence, publicKey, wsEndpoint } = options;
+    const {
+      authEndpoint,
+      debug = false,
+      initialStorage,
+      limits,
+      metadata,
+      presence,
+      publicKey,
+      wsEndpoint
+    } = options;
     this.metadata = metadata;
     this._authEndpoint = authEndpoint;
     this._debug = debug;
     this._initialStorage = initialStorage;
+    this._limits = __spreadValues({
+      presenceMaxSize: MAX_PRESENCE_SIZE_BYTES
+    }, limits);
     this._presence = presence;
     this._wsEndpoint = wsEndpoint;
     if (!!publicKey) this._publicKey = publicKey;
@@ -1478,7 +1501,7 @@ var infer = (callback) => callback;
 // src/MockedRoom.ts
 var MockedRoom = class extends AbstractRoom {
   constructor(room, options) {
-    const { events, initialPresence, initialStorage, presence, router } = options;
+    const { events, initialPresence, initialStorage, limits, presence, router } = options;
     super(room);
     this._crdtNotifier = new CrdtNotifier();
     this._eventNotifier = new EventNotifier();
@@ -1492,7 +1515,7 @@ var MockedRoom = class extends AbstractRoom {
         attempts: 0,
         count: 1,
         id: null,
-        state: "Untouched" /* Untouched */
+        state: ConnectionState.Untouched
       },
       webSocket: null
     };
@@ -1503,7 +1526,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)) {
@@ -1609,11 +1632,11 @@ var MockedRoom = class extends AbstractRoom {
       if (!!myself) this._stateNotifier.subjects["myself"].next(myself);
     };
     this._events = events;
+    this._limits = __spreadValues({
+      presenceMaxSize: MAX_PRESENCE_SIZE_BYTES
+    }, limits);
     this._router = router != null ? router : new PluvRouter({});
-    this._usersManager = new UsersManager({
-      initialPresence,
-      presence
-    });
+    this._usersManager = new UsersManager({ initialPresence, limits: this._limits, presence });
     this._crdtManager = new CrdtManager({
       initialStorage
     });

package/dist/index.mjs

@@ -52,6 +52,9 @@ var AbstractStorageStore = class {
   }
 };
 
+// src/constants.ts
+var MAX_PRESENCE_SIZE_BYTES = 512;
+
 // src/PluvProcedure.ts
 var PluvProcedure = class _PluvProcedure {
   constructor(config = {}) {
@@ -138,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;
   }
@@ -286,9 +289,6 @@ var StorageStore = class extends AbstractStorageStore {
   }
 };
 
-// src/constants.ts
-var MAX_PRESENCE_SIZE_BYTES = 512;
-
 // src/utils/debounce.ts
 var debounce = (fn, options) => {
   const { wait, immediate = false } = options != null ? options : {};
@@ -333,8 +333,9 @@ var UsersManager = class {
     this._myself = null;
     this._others = /* @__PURE__ */ new Map();
     this._presence = null;
-    const { initialPresence, presence = null } = config;
+    const { initialPresence, limits, presence = null } = config;
     this.initialPresence = initialPresence;
+    this._limits = limits;
     this._myPresence = initialPresence;
     this._presence = presence;
   }
@@ -467,7 +468,7 @@ var UsersManager = class {
     const cleanedPresence = pickBy(this._myPresence, (value) => typeof value !== "undefined");
     const updated = __spreadValues(__spreadValues(__spreadValues({}, this.initialPresence), cleanedPresence), cleanedPatch);
     const bytes = new TextEncoder().encode(JSON.stringify(updated)).length;
-    if (bytes > MAX_PRESENCE_SIZE_BYTES) {
+    if (!!this._limits.presenceMaxSize && bytes > this._limits.presenceMaxSize) {
       throw new Error(
         `Large presence. Presence must be at most 512 bytes. Current size: ${bytes.toLocaleString()}`
       );
@@ -503,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;
@@ -532,6 +532,7 @@ var PluvRoom = class extends AbstractRoom {
       debug = false,
       initialPresence,
       initialStorage,
+      limits,
       metadata,
       onAuthorizationFail,
       presence,
@@ -566,7 +567,7 @@ var PluvRoom = class extends AbstractRoom {
         attempts: 0,
         count: 0,
         id: null,
-        state: "Untouched" /* Untouched */
+        state: ConnectionState.Untouched
       },
       webSocket: null
     };
@@ -575,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)) {
@@ -707,6 +708,7 @@ var PluvRoom = class extends AbstractRoom {
     this.metadata = metadata;
     this._debug = debug;
     this._endpoints = { authEndpoint, wsEndpoint };
+    this._limits = limits;
     this._reconnectTimeoutMs = reconnectTimeoutMs;
     this._storageStore = storage;
     if (!!publicKey) this._publicKey = publicKey;
@@ -716,7 +718,7 @@ var PluvRoom = class extends AbstractRoom {
       }
     };
     this._router = router != null ? router : new PluvRouter({});
-    this._usersManager = new UsersManager({ initialPresence, presence });
+    this._usersManager = new UsersManager({ initialPresence, limits: this._limits, presence });
     this._crdtManager = new CrdtManager({ initialStorage });
   }
   get storageLoaded() {
@@ -731,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();
@@ -775,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;
@@ -784,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;
       });
@@ -823,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)
@@ -834,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),
@@ -1154,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;
     });
   }
@@ -1178,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;
       });
@@ -1246,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);
@@ -1257,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();
     });
   }
@@ -1275,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;
         }
@@ -1308,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);
@@ -1371,6 +1381,7 @@ var PluvClient = class {
         debug: options.debug,
         initialPresence: options.initialPresence,
         initialStorage: this._initialStorage,
+        limits: this._limits,
         metadata: this.metadata,
         onAuthorizationFail: options.onAuthorizationFail,
         presence: this._presence,
@@ -1405,11 +1416,23 @@ var PluvClient = class {
       this._rooms.delete(toLeave.id);
       this._logDebug(`Left and deleted room: ${room}`);
     });
-    const { authEndpoint, debug = false, initialStorage, metadata, presence, publicKey, wsEndpoint } = options;
+    const {
+      authEndpoint,
+      debug = false,
+      initialStorage,
+      limits,
+      metadata,
+      presence,
+      publicKey,
+      wsEndpoint
+    } = options;
     this.metadata = metadata;
     this._authEndpoint = authEndpoint;
     this._debug = debug;
     this._initialStorage = initialStorage;
+    this._limits = __spreadValues({
+      presenceMaxSize: MAX_PRESENCE_SIZE_BYTES
+    }, limits);
     this._presence = presence;
     this._wsEndpoint = wsEndpoint;
     if (!!publicKey) this._publicKey = publicKey;
@@ -1447,7 +1470,7 @@ var infer = (callback) => callback;
 // src/MockedRoom.ts
 var MockedRoom = class extends AbstractRoom {
   constructor(room, options) {
-    const { events, initialPresence, initialStorage, presence, router } = options;
+    const { events, initialPresence, initialStorage, limits, presence, router } = options;
     super(room);
     this._crdtNotifier = new CrdtNotifier();
     this._eventNotifier = new EventNotifier();
@@ -1461,7 +1484,7 @@ var MockedRoom = class extends AbstractRoom {
         attempts: 0,
         count: 1,
         id: null,
-        state: "Untouched" /* Untouched */
+        state: ConnectionState.Untouched
       },
       webSocket: null
     };
@@ -1472,7 +1495,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)) {
@@ -1578,11 +1601,11 @@ var MockedRoom = class extends AbstractRoom {
       if (!!myself) this._stateNotifier.subjects["myself"].next(myself);
     };
     this._events = events;
+    this._limits = __spreadValues({
+      presenceMaxSize: MAX_PRESENCE_SIZE_BYTES
+    }, limits);
     this._router = router != null ? router : new PluvRouter({});
-    this._usersManager = new UsersManager({
-      initialPresence,
-      presence
-    });
+    this._usersManager = new UsersManager({ initialPresence, limits: this._limits, presence });
     this._crdtManager = new CrdtManager({
       initialStorage
     });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pluv/client",
-  "version": "0.42.0",
+  "version": "0.44.0",
   "description": "@pluv/io frontend client",
   "author": "leedavidcs",
   "license": "MIT",
@@ -18,15 +18,15 @@
   },
   "dependencies": {
     "wonka": "^6.3.5",
-    "@pluv/crdt": "^0.42.0",
-    "@pluv/types": "^0.42.0"
+    "@pluv/crdt": "^0.44.0",
+    "@pluv/types": "^0.44.0"
   },
   "devDependencies": {
     "eslint": "^9.25.1",
     "tsup": "^8.4.0",
     "typescript": "^5.8.3",
-    "@pluv/tsconfig": "^0.42.0",
-    "eslint-config-pluv": "^0.42.0"
+    "@pluv/tsconfig": "^0.44.0",
+    "eslint-config-pluv": "^0.44.0"
   },
   "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/MockedRoom.ts

@@ -20,11 +20,13 @@ import type {
     EventResolver,
     EventResolverContext,
     InternalSubscriptions,
+    PluvClientLimits,
     UpdateMyPresenceAction,
     UserInfo,
     WebSocketConnection,
     WebSocketState,
 } from "./types";
+import { MAX_PRESENCE_SIZE_BYTES } from "./constants";
 
 export type MockedRoomEvents<TIO extends IOLike> = Partial<{
     [P in keyof InferIOInput<TIO>]: (data: Id<InferIOInput<TIO>[P]>) => Partial<InferIOOutput<TIO>>;
@@ -37,9 +39,10 @@ export type MockedRoomConfig<
     TEvents extends PluvRouterEventConfig<TIO, TPresence, TStorage> = {},
 > = {
     events?: MockedRoomEvents<MergeEvents<TEvents, TIO>>;
+    limits?: PluvClientLimits;
     router?: PluvRouter<TIO, TPresence, TStorage, TEvents>;
 } & Pick<CrdtManagerOptions<TStorage>, "initialStorage"> &
-    UsersManagerConfig<TPresence>;
+    Omit<UsersManagerConfig<TPresence>, "limits">;
 
 export class MockedRoom<
     TIO extends IOLike,
@@ -47,12 +50,13 @@ export class MockedRoom<
     TStorage extends Record<string, CrdtType<any, any>> = {},
     TEvents extends PluvRouterEventConfig<TIO, TPresence, TStorage> = {},
 > extends AbstractRoom<TIO, TPresence, TStorage> {
-    private _crdtManager: CrdtManager<TStorage>;
-    private _crdtNotifier = new CrdtNotifier<TStorage>();
-    private _eventNotifier = new EventNotifier<MergeEvents<TEvents, TIO>>();
-    private _events?: MockedRoomEvents<MergeEvents<TEvents, TIO>>;
-    private _otherNotifier = new OtherNotifier<TIO, TPresence>();
-    private _router: PluvRouter<TIO, TPresence, TStorage, TEvents>;
+    private readonly _crdtManager: CrdtManager<TStorage>;
+    private readonly _crdtNotifier = new CrdtNotifier<TStorage>();
+    private readonly _eventNotifier = new EventNotifier<MergeEvents<TEvents, TIO>>();
+    private readonly _events?: MockedRoomEvents<MergeEvents<TEvents, TIO>>;
+    private readonly _limits: PluvClientLimits;
+    private readonly _otherNotifier = new OtherNotifier<TIO, TPresence>();
+    private readonly _router: PluvRouter<TIO, TPresence, TStorage, TEvents>;
     private _state: WebSocketState<TIO> = {
         authorization: {
             token: null,
@@ -66,24 +70,24 @@ export class MockedRoom<
         },
         webSocket: null,
     };
-    private _stateNotifier = new StateNotifier<TIO, TPresence>();
-    private _subscriptions: InternalSubscriptions = {
+    private readonly _stateNotifier = new StateNotifier<TIO, TPresence>();
+    private readonly _subscriptions: InternalSubscriptions = {
         observeCrdt: null,
     };
-    private _usersManager: UsersManager<TIO, TPresence>;
+    private readonly _usersManager: UsersManager<TIO, TPresence>;
 
     constructor(room: string, options: MockedRoomConfig<TIO, TPresence, TStorage, TEvents>) {
-        const { events, initialPresence, initialStorage, presence, router } = options;
+        const { events, initialPresence, initialStorage, limits, presence, router } = options;
 
         super(room);
 
         this._events = events;
-
+        this._limits = {
+            presenceMaxSize: MAX_PRESENCE_SIZE_BYTES,
+            ...limits,
+        };
         this._router = router ?? (new PluvRouter({}) as PluvRouter<TIO, TPresence, TStorage, TEvents>);
-        this._usersManager = new UsersManager<TIO, TPresence>({
-            initialPresence,
-            presence,
-        });
+        this._usersManager = new UsersManager<TIO, TPresence>({ initialPresence, limits: this._limits, presence });
 
         this._crdtManager = new CrdtManager<TStorage>({
             initialStorage,

package/src/PluvClient.ts

@@ -1,5 +1,6 @@
 import type { AbstractCrdtDocFactory, CrdtType } from "@pluv/crdt";
 import type { InputZodLike, IOLike, JsonObject } from "@pluv/types";
+import { MAX_PRESENCE_SIZE_BYTES } from "./constants";
 import type { InferCallback } from "./infer";
 import { PluvProcedure } from "./PluvProcedure";
 import type {
@@ -14,7 +15,7 @@ import type {
 import { PluvRoom } from "./PluvRoom";
 import type { PluvRouterEventConfig } from "./PluvRouter";
 import { PluvRouter } from "./PluvRouter";
-import type { PublicKey, WithMetadata } from "./types";
+import type { PluvClientLimits, PublicKey, WithMetadata } from "./types";
 
 export type PluvClientOptions<
     TIO extends IOLike<any, any>,
@@ -24,6 +25,11 @@ export type PluvClientOptions<
 > = RoomEndpoints<TIO, TMetadata> & {
     debug?: boolean;
     initialStorage?: AbstractCrdtDocFactory<TStorage>;
+    /**
+     * @description Configurable limits defined for client-side validation. You should only set
+     * this if you control the server and have changed the limits there.
+     */
+    limits?: PluvClientLimits;
     metadata?: InputZodLike<TMetadata>;
     presence?: InputZodLike<TPresence>;
     publicKey?: PublicKey<TMetadata>;
@@ -61,6 +67,7 @@ export class PluvClient<
     private readonly _authEndpoint: AuthEndpoint<TMetadata> | undefined;
     private readonly _debug: boolean;
     private readonly _initialStorage?: AbstractCrdtDocFactory<TStorage>;
+    private readonly _limits: PluvClientLimits;
     private readonly _presence?: InputZodLike<TPresence>;
     private readonly _publicKey: PublicKey<TMetadata> | null = null;
     private readonly _rooms = new Map<string, PluvRoom<TIO, TMetadata, TPresence, TStorage, any>>();
@@ -77,13 +84,26 @@ export class PluvClient<
     }
 
     constructor(options: PluvClientOptions<TIO, TPresence, TStorage, TMetadata>) {
-        const { authEndpoint, debug = false, initialStorage, metadata, presence, publicKey, wsEndpoint } = options;
+        const {
+            authEndpoint,
+            debug = false,
+            initialStorage,
+            limits,
+            metadata,
+            presence,
+            publicKey,
+            wsEndpoint,
+        } = options;
 
         this.metadata = metadata;
 
         this._authEndpoint = authEndpoint as AuthEndpoint<TMetadata>;
         this._debug = debug;
         this._initialStorage = initialStorage;
+        this._limits = {
+            presenceMaxSize: MAX_PRESENCE_SIZE_BYTES,
+            ...limits,
+        };
         this._presence = presence;
         this._wsEndpoint = wsEndpoint;
 
@@ -104,6 +124,7 @@ export class PluvClient<
             debug: options.debug,
             initialPresence: options.initialPresence,
             initialStorage: this._initialStorage,
+            limits: this._limits,
             metadata: this.metadata,
             onAuthorizationFail: options.onAuthorizationFail,
             presence: this._presence,

package/src/PluvRoom.ts

@@ -37,6 +37,7 @@ import type {
     EventResolver,
     EventResolverContext,
     InternalSubscriptions,
+    PluvClientLimits,
     PublicKey,
     UpdateMyPresenceAction,
     UserInfo,
@@ -169,6 +170,7 @@ export type RoomConfig<
     {
         addons?: readonly PluvRoomAddon<TIO, TMetadata, TPresence, TStorage>[];
         debug?: boolean | PluvRoomDebug<TIO>;
+        limits: PluvClientLimits;
         onAuthorizationFail?: (error: Error) => void;
         metadata?: InputZodLike<TMetadata>;
         publicKey?: PublicKey<TMetadata>;
@@ -197,6 +199,7 @@ export class PluvRoom<
     private readonly _intervals: IntervalIds = {
         heartbeat: null,
     };
+    private readonly _limits: PluvClientLimits;
     private readonly _listeners: InternalListeners;
     private readonly _otherNotifier = new OtherNotifier<TIO, TPresence>();
     private readonly _publicKey: PublicKey<TMetadata> | null = null;
@@ -237,6 +240,7 @@ export class PluvRoom<
             debug = false,
             initialPresence,
             initialStorage,
+            limits,
             metadata,
             onAuthorizationFail,
             presence,
@@ -259,6 +263,7 @@ export class PluvRoom<
 
         this._debug = debug;
         this._endpoints = { authEndpoint, wsEndpoint } as RoomEndpoints<TIO, TMetadata>;
+        this._limits = limits;
         this._reconnectTimeoutMs = reconnectTimeoutMs;
         this._storageStore = storage;
 
@@ -271,7 +276,7 @@ export class PluvRoom<
         };
 
         this._router = router ?? (new PluvRouter({}) as PluvRouter<TIO, TPresence, TStorage, TEvents>);
-        this._usersManager = new UsersManager<TIO, TPresence>({ initialPresence, presence });
+        this._usersManager = new UsersManager<TIO, TPresence>({ initialPresence, limits: this._limits, presence });
         this._crdtManager = new CrdtManager<TStorage>({ initialStorage });
     }
 
@@ -358,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,
         );
 
@@ -610,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),
@@ -624,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),
@@ -1147,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;
@@ -1309,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>;
 

package/src/UsersManager.ts

@@ -1,12 +1,12 @@
 import type { InputZodLike, IOLike, JsonObject, OptionalProps } from "@pluv/types";
-import { MAX_PRESENCE_SIZE_BYTES } from "./constants";
-import type { UserInfo } from "./types";
+import type { PluvClientLimits, UserInfo } from "./types";
 import { pickBy } from "./utils";
 
 export type Presence = Record<string, unknown>;
 
 export type UsersManagerConfig<TPresence extends JsonObject = {}> = {
     initialPresence?: TPresence;
+    limits: PluvClientLimits;
     presence?: InputZodLike<TPresence>;
 };
 
@@ -24,12 +24,13 @@ export type DeleteConnectionResult<TIO extends IOLike, TPresence extends JsonObj
 };
 
 export class UsersManager<TIO extends IOLike, TPresence extends JsonObject = {}> {
-    private _idMap = {
+    public readonly initialPresence: TPresence;
+
+    private readonly _idMap = {
         fromConnectionId: new Map<[connectionId: string][0], [clientId: string][0]>(),
         fromClientId: new Map<[clientId: string][0], Set<[connectionId: string][0]>>(),
     };
-
-    public readonly initialPresence: TPresence;
+    private _limits: PluvClientLimits;
     /**
      * @description This presence can be updated while the user is not
      * connected.
@@ -43,10 +44,11 @@ export class UsersManager<TIO extends IOLike, TPresence extends JsonObject = {}>
     private _presence: InputZodLike<TPresence> | null = null;
 
     constructor(config: UsersManagerConfig<TPresence>) {
-        const { initialPresence, presence = null } = config;
+        const { initialPresence, limits, presence = null } = config;
 
         this.initialPresence = initialPresence as TPresence;
 
+        this._limits = limits;
         this._myPresence = initialPresence as TPresence;
         this._presence = presence;
     }
@@ -256,7 +258,7 @@ export class UsersManager<TIO extends IOLike, TPresence extends JsonObject = {}>
         const updated = { ...this.initialPresence, ...cleanedPresence, ...cleanedPatch } as TPresence;
         const bytes = new TextEncoder().encode(JSON.stringify(updated)).length;
 
-        if (bytes > MAX_PRESENCE_SIZE_BYTES) {
+        if (!!this._limits.presenceMaxSize && bytes > this._limits.presenceMaxSize) {
             throw new Error(
                 `Large presence. Presence must be at most 512 bytes. Current size: ${bytes.toLocaleString()}`,
             );

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];

package/src/types.ts

@@ -57,6 +57,13 @@ export type MergeEventRecords<
       >
     : Id<TRoot>;
 
+export interface PluvClientLimits {
+    /**
+     * @description Maximum size of presence object in bytes
+     */
+    presenceMaxSize?: number | null;
+}
+
 export interface PublicKeyParams<TMetadata extends JsonObject> {
     metadata: TMetadata;
 }