@pluv/client 0.41.7 → 0.43.0

package/.turbo/turbo-build.log

@@ -1,5 +1,5 @@
 
-> @pluv/client@0.41.7 build /home/runner/work/pluv/pluv/packages/client
+> @pluv/client@0.43.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.12 KB
-ESM ⚡️ Build success in 110ms
-CJS dist/index.js 56.44 KB
-CJS ⚡️ Build success in 116ms
+CJS dist/index.js 57.65 KB
+CJS ⚡️ Build success in 115ms
+ESM dist/index.mjs 56.33 KB
+ESM ⚡️ Build success in 116ms
 DTS Build start
-DTS ⚡️ Build success in 3198ms
-DTS dist/index.d.mts 24.58 KB
-DTS dist/index.d.ts  24.58 KB
+DTS ⚡️ Build success in 3550ms
+DTS dist/index.d.mts 25.24 KB
+DTS dist/index.d.ts  25.24 KB

package/CHANGELOG.md

@@ -1,5 +1,31 @@
 # @pluv/client
 
+## 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
+
+- 7ae56bf: Periodically sync connection ids with the server to clear stale connections.
+  - @pluv/crdt@0.42.0
+  - @pluv/types@0.42.0
+
 ## 0.41.7
 
 ### Patch Changes

package/dist/index.d.mts

@@ -84,6 +84,7 @@ type SubscriptionCallback<TIO extends IOLike, TPresence extends JsonObject, TSub
 
 type UsersManagerConfig<TPresence extends JsonObject = {}> = {
     initialPresence?: TPresence;
+    limits: PluvClientLimits;
     presence?: InputZodLike<TPresence>;
 };
 
@@ -130,6 +131,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 +146,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;
@@ -206,6 +209,7 @@ declare class PluvRoom<TIO extends IOLike<any, any>, TMetadata extends JsonObjec
     private _handleRegisteredMessage;
     private _handleStorageReceivedMessage;
     private _handleStorageUpdatedMessage;
+    private _handleSyncStateReceived;
     private _handleUserJoinedMessage;
     private _heartbeat;
     private _logDebug;
@@ -234,6 +238,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>;
@@ -254,6 +263,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;
@@ -290,6 +300,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;
 }
@@ -367,19 +383,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

@@ -84,6 +84,7 @@ type SubscriptionCallback<TIO extends IOLike, TPresence extends JsonObject, TSub
 
 type UsersManagerConfig<TPresence extends JsonObject = {}> = {
     initialPresence?: TPresence;
+    limits: PluvClientLimits;
     presence?: InputZodLike<TPresence>;
 };
 
@@ -130,6 +131,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 +146,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;
@@ -206,6 +209,7 @@ declare class PluvRoom<TIO extends IOLike<any, any>, TMetadata extends JsonObjec
     private _handleRegisteredMessage;
     private _handleStorageReceivedMessage;
     private _handleStorageUpdatedMessage;
+    private _handleSyncStateReceived;
     private _handleUserJoinedMessage;
     private _heartbeat;
     private _logDebug;
@@ -234,6 +238,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>;
@@ -254,6 +263,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;
@@ -290,6 +300,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;
 }
@@ -367,19 +383,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 = {}) {
@@ -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()}`
       );
@@ -563,6 +564,7 @@ var PluvRoom = class extends AbstractRoom {
       debug = false,
       initialPresence,
       initialStorage,
+      limits,
       metadata,
       onAuthorizationFail,
       presence,
@@ -738,6 +740,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 +750,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() {
@@ -1113,6 +1116,21 @@ var PluvRoom = class extends AbstractRoom {
     );
     this._crdtNotifier.rootSubject.next(storageRoot);
   }
+  _handleSyncStateReceived(message) {
+    var _a;
+    const { connectionId } = message;
+    if (!connectionId) return;
+    if (!this._state.webSocket) throw new Error("Could not find WebSocket");
+    if (!this._usersManager.myself) return;
+    const data = message.data;
+    const active = new Set((_a = data == null ? void 0 : data.connectionIds) != null ? _a : []);
+    const quitters = this._usersManager.getOthers().filter((other) => !active.has(other.connectionId));
+    quitters.forEach((quitter) => {
+      this._usersManager.deleteConnection(quitter.connectionId);
+    });
+    const remaining = this._usersManager.getOthers();
+    this._stateNotifier.subjects.others.next(remaining);
+  }
   _handleUserJoinedMessage(message) {
     const { connectionId } = message;
     if (!connectionId) return;
@@ -1250,6 +1268,10 @@ var PluvRoom = class extends AbstractRoom {
         this._handleStorageUpdatedMessage(message);
         return;
       }
+      case "$syncStateReceived": {
+        this._handleSyncStateReceived(message);
+        return;
+      }
       case "$userJoined": {
         this._handleUserJoinedMessage(message);
         return;
@@ -1383,6 +1405,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,
@@ -1417,11 +1440,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;
@@ -1459,7 +1494,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();
@@ -1590,11 +1625,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 = {}) {
@@ -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()}`
       );
@@ -532,6 +533,7 @@ var PluvRoom = class extends AbstractRoom {
       debug = false,
       initialPresence,
       initialStorage,
+      limits,
       metadata,
       onAuthorizationFail,
       presence,
@@ -707,6 +709,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 +719,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() {
@@ -1082,6 +1085,21 @@ var PluvRoom = class extends AbstractRoom {
     );
     this._crdtNotifier.rootSubject.next(storageRoot);
   }
+  _handleSyncStateReceived(message) {
+    var _a;
+    const { connectionId } = message;
+    if (!connectionId) return;
+    if (!this._state.webSocket) throw new Error("Could not find WebSocket");
+    if (!this._usersManager.myself) return;
+    const data = message.data;
+    const active = new Set((_a = data == null ? void 0 : data.connectionIds) != null ? _a : []);
+    const quitters = this._usersManager.getOthers().filter((other) => !active.has(other.connectionId));
+    quitters.forEach((quitter) => {
+      this._usersManager.deleteConnection(quitter.connectionId);
+    });
+    const remaining = this._usersManager.getOthers();
+    this._stateNotifier.subjects.others.next(remaining);
+  }
   _handleUserJoinedMessage(message) {
     const { connectionId } = message;
     if (!connectionId) return;
@@ -1219,6 +1237,10 @@ var PluvRoom = class extends AbstractRoom {
         this._handleStorageUpdatedMessage(message);
         return;
       }
+      case "$syncStateReceived": {
+        this._handleSyncStateReceived(message);
+        return;
+      }
       case "$userJoined": {
         this._handleUserJoinedMessage(message);
         return;
@@ -1352,6 +1374,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,
@@ -1386,11 +1409,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;
@@ -1428,7 +1463,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();
@@ -1559,11 +1594,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.41.7",
+  "version": "0.43.0",
   "description": "@pluv/io frontend client",
   "author": "leedavidcs",
   "license": "MIT",
@@ -18,15 +18,15 @@
   },
   "dependencies": {
     "wonka": "^6.3.5",
-    "@pluv/crdt": "^0.41.7",
-    "@pluv/types": "^0.41.7"
+    "@pluv/crdt": "^0.43.0",
+    "@pluv/types": "^0.43.0"
   },
   "devDependencies": {
-    "eslint": "^9.25.0",
+    "eslint": "^9.25.1",
     "tsup": "^8.4.0",
     "typescript": "^5.8.3",
-    "@pluv/tsconfig": "^0.41.7",
-    "eslint-config-pluv": "^0.41.7"
+    "@pluv/tsconfig": "^0.43.0",
+    "eslint-config-pluv": "^0.43.0"
   },
   "scripts": {
     "build": "tsup src/index.ts --format esm,cjs --dts",

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 });
     }
 
@@ -1017,6 +1022,28 @@ export class PluvRoom<
         this._crdtNotifier.rootSubject.next(storageRoot);
     }
 
+    private _handleSyncStateReceived(message: IOEventMessage<TIO>): void {
+        const { connectionId } = message;
+
+        if (!connectionId) return;
+        // Should not reach here
+        if (!this._state.webSocket) throw new Error("Could not find WebSocket");
+        if (!this._usersManager.myself) return;
+
+        const data = message.data as BaseIOEventRecord<InferIOAuthorize<TIO>>["$syncStateReceived"];
+        const active = new Set(data?.connectionIds ?? []);
+
+        const quitters = this._usersManager.getOthers().filter((other) => !active.has(other.connectionId));
+
+        quitters.forEach((quitter) => {
+            this._usersManager.deleteConnection(quitter.connectionId);
+        });
+
+        const remaining = this._usersManager.getOthers();
+
+        this._stateNotifier.subjects.others.next(remaining);
+    }
+
     private _handleUserJoinedMessage(message: IOEventMessage<TIO>): void {
         const { connectionId } = message;
 
@@ -1190,6 +1217,10 @@ export class PluvRoom<
                 this._handleStorageUpdatedMessage(message);
                 return;
             }
+            case "$syncStateReceived": {
+                this._handleSyncStateReceived(message);
+                return;
+            }
             case "$userJoined": {
                 this._handleUserJoinedMessage(message);
                 return;

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/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;
 }