@pluv/client 0.41.1 → 0.41.3

package/.turbo/turbo-build.log

@@ -1,5 +1,5 @@
 
-> @pluv/client@0.41.1 build /home/runner/work/pluv/pluv/packages/client
+> @pluv/client@0.41.3 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 55.51 KB
-CJS ⚡️ Build success in 131ms
-ESM dist/index.mjs 54.19 KB
-ESM ⚡️ Build success in 132ms
+CJS dist/index.js 56.67 KB
+CJS ⚡️ Build success in 110ms
+ESM dist/index.mjs 55.36 KB
+ESM ⚡️ Build success in 111ms
 DTS Build start
-DTS ⚡️ Build success in 3291ms
+DTS ⚡️ Build success in 3194ms
 DTS dist/index.d.mts 24.58 KB
 DTS dist/index.d.ts  24.58 KB

package/CHANGELOG.md

@@ -1,5 +1,21 @@
 # @pluv/client
 
+## 0.41.3
+
+### Patch Changes
+
+- 49051c0: Fix presence keys becoming lost, causing presence objects to be partial and failing schema validation.
+  - @pluv/crdt@0.41.3
+  - @pluv/types@0.41.3
+
+## 0.41.2
+
+### Patch Changes
+
+- 37956d3: When presence is received for a user that is not currently being tracked, `PluvRoom` now automatically updates `others` to include the connection of the received presence.
+  - @pluv/crdt@0.41.2
+  - @pluv/types@0.41.2
+
 ## 0.41.1
 
 ### Patch Changes

package/dist/index.js

@@ -320,6 +320,37 @@ 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 : {};
+  let prevResult;
+  let timeout = null;
+  return (...args) => {
+    if (typeof timeout === "number") clearTimeout(timeout);
+    timeout = setTimeout(() => {
+      timeout = null;
+      if (!immediate) prevResult = fn(args);
+    }, wait);
+    if (immediate && !timeout) {
+      fn(args);
+      return;
+    }
+    return prevResult;
+  };
+};
+
+// src/utils/pickBy.ts
+var pickBy = (obj, by) => {
+  const result = {};
+  const keys = Object.keys(obj);
+  for (let i = 0; i < keys.length; ++i) {
+    const key = keys[i];
+    const value = obj[key];
+    if (by(value)) result[key] = value;
+  }
+  return result;
+};
+
 // src/UsersManager.ts
 var UsersManager = class {
   constructor(config) {
@@ -334,7 +365,7 @@ var UsersManager = class {
     this._others = /* @__PURE__ */ new Map();
     this._presence = null;
     const { initialPresence, presence = null } = config;
-    this._initialPresence = initialPresence;
+    this.initialPresence = initialPresence;
     this._myPresence = initialPresence;
     this._presence = presence;
   }
@@ -346,9 +377,9 @@ var UsersManager = class {
   }
   addConnection(userInfo) {
     var _a;
-    const data = __spreadProps(__spreadValues({}, userInfo), {
-      presence: (_a = userInfo.presence) != null ? _a : this._initialPresence
-    });
+    const cleaned = pickBy((_a = userInfo.presence) != null ? _a : {}, (value) => typeof value !== "undefined");
+    const presence = __spreadValues(__spreadValues({}, this.initialPresence), cleaned);
+    const data = __spreadProps(__spreadValues({}, userInfo), { presence });
     const myClientId = !!this._myself ? this.getClientId(this._myself) : null;
     const clientId = this.getClientId(data);
     const remaining = this._setConnectionId(userInfo.connectionId, clientId).size;
@@ -414,13 +445,16 @@ var UsersManager = class {
     return Array.from(this._others.values());
   }
   patchPresence(connectionId, patch) {
+    var _a;
     const clientId = this.getClientId(connectionId);
     const myClientId = !!this._myself ? this.getClientId(this._myself) : null;
     if (!clientId) return null;
     if (myClientId === clientId) return this.updateMyPresence(patch);
     const other = this._others.get(clientId);
     if (!other) return null;
-    const presence = __spreadValues(__spreadValues({}, other.presence), patch);
+    const cleanedPatch = pickBy(patch != null ? patch : {}, (value) => typeof value !== "undefined");
+    const cleanedPresence = pickBy((_a = other.presence) != null ? _a : {}, (value) => typeof value !== "undefined");
+    const presence = __spreadValues(__spreadValues(__spreadValues({}, this.initialPresence), cleanedPresence), cleanedPatch);
     const validated = this._presence ? this._presence.parse(presence) : presence;
     this._others.set(clientId, __spreadProps(__spreadValues({}, other), { presence: validated }));
     return validated;
@@ -434,7 +468,7 @@ var UsersManager = class {
   setMyself(userInfo) {
     var _a;
     const connectionId = userInfo.connectionId;
-    const presence = (_a = userInfo.presence) != null ? _a : this._initialPresence;
+    const presence = (_a = userInfo.presence) != null ? _a : this.initialPresence;
     this._myself = __spreadProps(__spreadValues({}, userInfo), { presence });
     this._myPresence = presence;
     const clientId = this.getClientId(this._myself);
@@ -455,10 +489,14 @@ var UsersManager = class {
     this._others.set(clientId, __spreadProps(__spreadValues({}, other), { presence }));
   }
   /**
-   * @description This method need not care about being connected.
+   * @description This method need not care about being connected. This is because a user should
+   * be able to view and update their own presence without being online
+   * @date April 20, 2025
    */
   updateMyPresence(patch) {
-    const updated = __spreadValues(__spreadValues({}, this._myPresence), patch);
+    const cleanedPatch = pickBy(patch, (value) => typeof value !== "undefined");
+    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) {
       throw new Error(
@@ -505,25 +543,6 @@ var ConnectionState = /* @__PURE__ */ ((ConnectionState2) => {
   return ConnectionState2;
 })(ConnectionState || {});
 
-// src/utils/debounce.ts
-var debounce = (fn, options) => {
-  const { wait, immediate = false } = options != null ? options : {};
-  let prevResult;
-  let timeout = null;
-  return (...args) => {
-    if (typeof timeout === "number") clearTimeout(timeout);
-    timeout = setTimeout(() => {
-      timeout = null;
-      if (!immediate) prevResult = fn(args);
-    }, wait);
-    if (immediate && !timeout) {
-      fn(args);
-      return;
-    }
-    return prevResult;
-  };
-};
-
 // src/PluvRoom.ts
 var ADD_TO_STORAGE_STATE_DEBOUNCE_MS = 1e3;
 var HEARTBEAT_INTERVAL_MS = 1e4;
@@ -983,9 +1002,19 @@ var PluvRoom = class extends AbstractRoom {
       this._stateNotifier.subjects.myself.next(this._usersManager.myself);
       return;
     }
-    const other = this._usersManager.getOther(connectionId);
+    if (!!clientId) {
+      const other = this._usersManager.getOther(connectionId);
+      this._otherNotifier.subject(clientId).next(other);
+    } else {
+      const added = this._usersManager.addConnection({
+        connectionId,
+        presence: data.presence,
+        user: message.user
+      });
+      const other = this._usersManager.getOther(connectionId);
+      this._otherNotifier.subject(added.clientId).next(other);
+    }
     const others = this._usersManager.getOthers();
-    if (!!clientId) this._otherNotifier.subject(clientId).next(other);
     this._stateNotifier.subjects.others.next(others);
   }
   _handleReceiveOthers(message) {
@@ -996,7 +1025,7 @@ var PluvRoom = class extends AbstractRoom {
       const { presence, user } = data.others[connectionId];
       const result = this._usersManager.addConnection({
         connectionId,
-        presence: presence != null ? presence : void 0,
+        presence,
         user
       });
       if (!!presence) this._usersManager.patchPresence(connectionId, presence);
@@ -1086,7 +1115,6 @@ var PluvRoom = class extends AbstractRoom {
     this._crdtNotifier.rootSubject.next(storageRoot);
   }
   _handleUserJoinedMessage(message) {
-    var _a;
     const { connectionId } = message;
     if (!connectionId) return;
     if (!this._state.webSocket) throw new Error("Could not find WebSocket");
@@ -1097,15 +1125,14 @@ var PluvRoom = class extends AbstractRoom {
       this._sendMessage({ type: "$getOthers", data: {} });
       return;
     }
-    const result = this._usersManager.addConnection({
+    const added = this._usersManager.addConnection({
       connectionId,
       presence: data.presence,
       user: data.user
     });
-    const clientId = (_a = result == null ? void 0 : result.clientId) != null ? _a : null;
     const other = this._usersManager.getOther(connectionId);
     const others = this._usersManager.getOthers();
-    if (!!clientId) this._otherNotifier.subject(clientId).next(other);
+    this._otherNotifier.subject(added.clientId).next(other);
     this._stateNotifier.subjects.others.next(others);
   }
   _heartbeat() {
@@ -1261,13 +1288,15 @@ var PluvRoom = class extends AbstractRoom {
       if (typeof document === "undefined") return;
       if (document.visibilityState !== "visible") return;
       switch (this._state.connection.state) {
-        case "Open" /* Open */:
+        case "Open" /* Open */: {
           this._clearInterval(this._intervals.heartbeat);
           setInterval(this._heartbeat.bind(this), HEARTBEAT_INTERVAL_MS);
           return;
-        case "Unavailable" /* Unavailable */:
+        }
+        case "Unavailable" /* Unavailable */: {
           yield this._reconnect();
           return;
+        }
         default:
       }
     });

package/dist/index.mjs

@@ -289,6 +289,37 @@ 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 : {};
+  let prevResult;
+  let timeout = null;
+  return (...args) => {
+    if (typeof timeout === "number") clearTimeout(timeout);
+    timeout = setTimeout(() => {
+      timeout = null;
+      if (!immediate) prevResult = fn(args);
+    }, wait);
+    if (immediate && !timeout) {
+      fn(args);
+      return;
+    }
+    return prevResult;
+  };
+};
+
+// src/utils/pickBy.ts
+var pickBy = (obj, by) => {
+  const result = {};
+  const keys = Object.keys(obj);
+  for (let i = 0; i < keys.length; ++i) {
+    const key = keys[i];
+    const value = obj[key];
+    if (by(value)) result[key] = value;
+  }
+  return result;
+};
+
 // src/UsersManager.ts
 var UsersManager = class {
   constructor(config) {
@@ -303,7 +334,7 @@ var UsersManager = class {
     this._others = /* @__PURE__ */ new Map();
     this._presence = null;
     const { initialPresence, presence = null } = config;
-    this._initialPresence = initialPresence;
+    this.initialPresence = initialPresence;
     this._myPresence = initialPresence;
     this._presence = presence;
   }
@@ -315,9 +346,9 @@ var UsersManager = class {
   }
   addConnection(userInfo) {
     var _a;
-    const data = __spreadProps(__spreadValues({}, userInfo), {
-      presence: (_a = userInfo.presence) != null ? _a : this._initialPresence
-    });
+    const cleaned = pickBy((_a = userInfo.presence) != null ? _a : {}, (value) => typeof value !== "undefined");
+    const presence = __spreadValues(__spreadValues({}, this.initialPresence), cleaned);
+    const data = __spreadProps(__spreadValues({}, userInfo), { presence });
     const myClientId = !!this._myself ? this.getClientId(this._myself) : null;
     const clientId = this.getClientId(data);
     const remaining = this._setConnectionId(userInfo.connectionId, clientId).size;
@@ -383,13 +414,16 @@ var UsersManager = class {
     return Array.from(this._others.values());
   }
   patchPresence(connectionId, patch) {
+    var _a;
     const clientId = this.getClientId(connectionId);
     const myClientId = !!this._myself ? this.getClientId(this._myself) : null;
     if (!clientId) return null;
     if (myClientId === clientId) return this.updateMyPresence(patch);
     const other = this._others.get(clientId);
     if (!other) return null;
-    const presence = __spreadValues(__spreadValues({}, other.presence), patch);
+    const cleanedPatch = pickBy(patch != null ? patch : {}, (value) => typeof value !== "undefined");
+    const cleanedPresence = pickBy((_a = other.presence) != null ? _a : {}, (value) => typeof value !== "undefined");
+    const presence = __spreadValues(__spreadValues(__spreadValues({}, this.initialPresence), cleanedPresence), cleanedPatch);
     const validated = this._presence ? this._presence.parse(presence) : presence;
     this._others.set(clientId, __spreadProps(__spreadValues({}, other), { presence: validated }));
     return validated;
@@ -403,7 +437,7 @@ var UsersManager = class {
   setMyself(userInfo) {
     var _a;
     const connectionId = userInfo.connectionId;
-    const presence = (_a = userInfo.presence) != null ? _a : this._initialPresence;
+    const presence = (_a = userInfo.presence) != null ? _a : this.initialPresence;
     this._myself = __spreadProps(__spreadValues({}, userInfo), { presence });
     this._myPresence = presence;
     const clientId = this.getClientId(this._myself);
@@ -424,10 +458,14 @@ var UsersManager = class {
     this._others.set(clientId, __spreadProps(__spreadValues({}, other), { presence }));
   }
   /**
-   * @description This method need not care about being connected.
+   * @description This method need not care about being connected. This is because a user should
+   * be able to view and update their own presence without being online
+   * @date April 20, 2025
    */
   updateMyPresence(patch) {
-    const updated = __spreadValues(__spreadValues({}, this._myPresence), patch);
+    const cleanedPatch = pickBy(patch, (value) => typeof value !== "undefined");
+    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) {
       throw new Error(
@@ -474,25 +512,6 @@ var ConnectionState = /* @__PURE__ */ ((ConnectionState2) => {
   return ConnectionState2;
 })(ConnectionState || {});
 
-// src/utils/debounce.ts
-var debounce = (fn, options) => {
-  const { wait, immediate = false } = options != null ? options : {};
-  let prevResult;
-  let timeout = null;
-  return (...args) => {
-    if (typeof timeout === "number") clearTimeout(timeout);
-    timeout = setTimeout(() => {
-      timeout = null;
-      if (!immediate) prevResult = fn(args);
-    }, wait);
-    if (immediate && !timeout) {
-      fn(args);
-      return;
-    }
-    return prevResult;
-  };
-};
-
 // src/PluvRoom.ts
 var ADD_TO_STORAGE_STATE_DEBOUNCE_MS = 1e3;
 var HEARTBEAT_INTERVAL_MS = 1e4;
@@ -952,9 +971,19 @@ var PluvRoom = class extends AbstractRoom {
       this._stateNotifier.subjects.myself.next(this._usersManager.myself);
       return;
     }
-    const other = this._usersManager.getOther(connectionId);
+    if (!!clientId) {
+      const other = this._usersManager.getOther(connectionId);
+      this._otherNotifier.subject(clientId).next(other);
+    } else {
+      const added = this._usersManager.addConnection({
+        connectionId,
+        presence: data.presence,
+        user: message.user
+      });
+      const other = this._usersManager.getOther(connectionId);
+      this._otherNotifier.subject(added.clientId).next(other);
+    }
     const others = this._usersManager.getOthers();
-    if (!!clientId) this._otherNotifier.subject(clientId).next(other);
     this._stateNotifier.subjects.others.next(others);
   }
   _handleReceiveOthers(message) {
@@ -965,7 +994,7 @@ var PluvRoom = class extends AbstractRoom {
       const { presence, user } = data.others[connectionId];
       const result = this._usersManager.addConnection({
         connectionId,
-        presence: presence != null ? presence : void 0,
+        presence,
         user
       });
       if (!!presence) this._usersManager.patchPresence(connectionId, presence);
@@ -1055,7 +1084,6 @@ var PluvRoom = class extends AbstractRoom {
     this._crdtNotifier.rootSubject.next(storageRoot);
   }
   _handleUserJoinedMessage(message) {
-    var _a;
     const { connectionId } = message;
     if (!connectionId) return;
     if (!this._state.webSocket) throw new Error("Could not find WebSocket");
@@ -1066,15 +1094,14 @@ var PluvRoom = class extends AbstractRoom {
       this._sendMessage({ type: "$getOthers", data: {} });
       return;
     }
-    const result = this._usersManager.addConnection({
+    const added = this._usersManager.addConnection({
       connectionId,
       presence: data.presence,
       user: data.user
     });
-    const clientId = (_a = result == null ? void 0 : result.clientId) != null ? _a : null;
     const other = this._usersManager.getOther(connectionId);
     const others = this._usersManager.getOthers();
-    if (!!clientId) this._otherNotifier.subject(clientId).next(other);
+    this._otherNotifier.subject(added.clientId).next(other);
     this._stateNotifier.subjects.others.next(others);
   }
   _heartbeat() {
@@ -1230,13 +1257,15 @@ var PluvRoom = class extends AbstractRoom {
       if (typeof document === "undefined") return;
       if (document.visibilityState !== "visible") return;
       switch (this._state.connection.state) {
-        case "Open" /* Open */:
+        case "Open" /* Open */: {
           this._clearInterval(this._intervals.heartbeat);
           setInterval(this._heartbeat.bind(this), HEARTBEAT_INTERVAL_MS);
           return;
-        case "Unavailable" /* Unavailable */:
+        }
+        case "Unavailable" /* Unavailable */: {
           yield this._reconnect();
           return;
+        }
         default:
       }
     });

package/package.json

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

package/src/PluvRoom.ts

@@ -77,9 +77,6 @@ export const DEFAULT_PLUV_CLIENT_ADDON = <
     storage: new StorageStore(input.room.id),
 });
 
-interface CloseWsOptions {
-    connectionState?: ConnectionState;
-}
 interface WindowListeners {
     onNavigatorOffline: () => void;
     onNavigatorOnline: () => void;
@@ -857,10 +854,28 @@ export class PluvRoom<
             return;
         }
 
-        const other = this._usersManager.getOther(connectionId);
+        if (!!clientId) {
+            const other = this._usersManager.getOther(connectionId);
+
+            this._otherNotifier.subject(clientId).next(other);
+        } else {
+            /**
+             * !HACK
+             * @description User could not be found. Add the connection to keep others up-to-date
+             * @date April 19, 2025
+             */
+            const added = this._usersManager.addConnection({
+                connectionId,
+                presence: data.presence as TPresence,
+                user: message.user as Id<InferIOAuthorizeUser<InferIOAuthorize<TIO>>>,
+            });
+            const other = this._usersManager.getOther(connectionId);
+
+            this._otherNotifier.subject(added.clientId).next(other);
+        }
+
         const others = this._usersManager.getOthers();
 
-        if (!!clientId) this._otherNotifier.subject(clientId).next(other);
         this._stateNotifier.subjects.others.next(others);
     }
 
@@ -876,7 +891,7 @@ export class PluvRoom<
 
             const result = this._usersManager.addConnection({
                 connectionId,
-                presence: (presence ?? undefined) as TPresence,
+                presence: presence as TPresence,
                 user,
             });
 
@@ -1020,17 +1035,16 @@ export class PluvRoom<
             return;
         }
 
-        const result = this._usersManager.addConnection({
+        const added = this._usersManager.addConnection({
             connectionId,
             presence: data.presence as TPresence,
             user: data.user,
         });
 
-        const clientId = result?.clientId ?? null;
         const other = this._usersManager.getOther(connectionId);
         const others = this._usersManager.getOthers();
 
-        if (!!clientId) this._otherNotifier.subject(clientId).next(other);
+        this._otherNotifier.subject(added.clientId).next(other);
         this._stateNotifier.subjects.others.next(others);
     }
 
@@ -1222,15 +1236,17 @@ export class PluvRoom<
         if (document.visibilityState !== "visible") return;
 
         switch (this._state.connection.state) {
-            case ConnectionState.Open:
+            case ConnectionState.Open: {
                 this._clearInterval(this._intervals.heartbeat);
                 setInterval(this._heartbeat.bind(this), HEARTBEAT_INTERVAL_MS);
 
                 return;
-            case ConnectionState.Unavailable:
+            }
+            case ConnectionState.Unavailable: {
                 await this._reconnect();
 
                 return;
+            }
             default:
         }
     }

package/src/UsersManager.ts

@@ -1,6 +1,7 @@
 import type { InputZodLike, IOLike, JsonObject, OptionalProps } from "@pluv/types";
 import { MAX_PRESENCE_SIZE_BYTES } from "./constants";
 import type { UserInfo } from "./types";
+import { pickBy } from "./utils";
 
 export type Presence = Record<string, unknown>;
 
@@ -28,7 +29,7 @@ export class UsersManager<TIO extends IOLike, TPresence extends JsonObject = {}>
         fromClientId: new Map<[clientId: string][0], Set<[connectionId: string][0]>>(),
     };
 
-    private _initialPresence: TPresence;
+    public readonly initialPresence: TPresence;
     /**
      * @description This presence can be updated while the user is not
      * connected.
@@ -44,7 +45,8 @@ export class UsersManager<TIO extends IOLike, TPresence extends JsonObject = {}>
     constructor(config: UsersManagerConfig<TPresence>) {
         const { initialPresence, presence = null } = config;
 
-        this._initialPresence = initialPresence as TPresence;
+        this.initialPresence = initialPresence as TPresence;
+
         this._myPresence = initialPresence as TPresence;
         this._presence = presence;
     }
@@ -60,10 +62,14 @@ export class UsersManager<TIO extends IOLike, TPresence extends JsonObject = {}>
     public addConnection(
         userInfo: OptionalProps<UserInfo<TIO, TPresence>, "presence">,
     ): AddConnectionResult<TIO, TPresence> {
-        const data: UserInfo<TIO, TPresence> = {
-            ...userInfo,
-            presence: userInfo.presence ?? this._initialPresence,
-        };
+        /**
+         * @description Ensure that the presence is complete, so that it does not fail schema
+         * validation
+         * @date April 20, 2025
+         */
+        const cleaned = pickBy(userInfo.presence ?? {}, (value) => typeof value !== "undefined");
+        const presence = { ...this.initialPresence, ...cleaned };
+        const data: UserInfo<TIO, TPresence> = { ...userInfo, presence };
 
         const myClientId = !!this._myself ? this.getClientId(this._myself) : null;
         const clientId = this.getClientId(data);
@@ -186,7 +192,9 @@ export class UsersManager<TIO extends IOLike, TPresence extends JsonObject = {}>
 
         if (!other) return null;
 
-        const presence = { ...other.presence, ...patch } as TPresence;
+        const cleanedPatch = pickBy(patch ?? {}, (value) => typeof value !== "undefined");
+        const cleanedPresence = pickBy(other.presence ?? {}, (value) => typeof value !== "undefined");
+        const presence = { ...this.initialPresence, ...cleanedPresence, ...cleanedPatch } as TPresence;
         const validated = this._presence ? this._presence.parse(presence) : presence;
 
         this._others.set(clientId, { ...other, presence: validated });
@@ -205,7 +213,7 @@ export class UsersManager<TIO extends IOLike, TPresence extends JsonObject = {}>
 
     public setMyself(userInfo: OptionalProps<UserInfo<TIO, TPresence>, "presence">): void {
         const connectionId = userInfo.connectionId;
-        const presence = userInfo.presence ?? this._initialPresence;
+        const presence = userInfo.presence ?? this.initialPresence;
 
         this._myself = { ...userInfo, presence };
         this._myPresence = presence;
@@ -238,10 +246,14 @@ export class UsersManager<TIO extends IOLike, TPresence extends JsonObject = {}>
     }
 
     /**
-     * @description This method need not care about being connected.
+     * @description This method need not care about being connected. This is because a user should
+     * be able to view and update their own presence without being online
+     * @date April 20, 2025
      */
     public updateMyPresence(patch: Partial<TPresence>): TPresence {
-        const updated = { ...this._myPresence, ...patch };
+        const cleanedPatch = pickBy(patch, (value) => typeof value !== "undefined");
+        const cleanedPresence = pickBy(this._myPresence, (value) => typeof value !== "undefined");
+        const updated = { ...this.initialPresence, ...cleanedPresence, ...cleanedPatch } as TPresence;
         const bytes = new TextEncoder().encode(JSON.stringify(updated)).length;
 
         if (bytes > MAX_PRESENCE_SIZE_BYTES) {

package/src/utils/index.ts

@@ -1,2 +1,3 @@
 export { debounce } from "./debounce";
 export { identity } from "./identity";
+export { pickBy } from "./pickBy";

package/src/utils/pickBy.ts

@@ -0,0 +1,13 @@
+export const pickBy = <T extends Record<string, any>>(obj: T, by: (value: T[keyof T]) => boolean): Partial<T> => {
+    const result: Partial<T> = {};
+    const keys: (keyof T)[] = Object.keys(obj);
+
+    for (let i = 0; i < keys.length; ++i) {
+        const key = keys[i];
+        const value = obj[key];
+
+        if (by(value)) result[key] = value;
+    }
+
+    return result;
+};