@wavezfm/api 0.7.33 → 0.7.35

package/CHANGELOG.md

@@ -2,6 +2,9 @@
 
 ## Unreleased
 
+- Type optional `RoomActiveUser.isVip` as an independent boolean benefit that can coexist with any room role. Older payloads may omit it.
+- Clarify that `effectiveRoomRole` describes effective hierarchy, not every additional operational permission; Ambassador room-configuration grants are enforced by the server.
+
 - Add `roomBot.getScheduledEvents(roomId)` for approved active/upcoming room and global calendar events, including start/end timestamps. Existing `getEvents` continues to return presence history.
 - Add `roomBot.setVip(roomId, userId, enabled)` and optional `isVip` in user-update payloads. VIP can coexist with the main room role.
 

package/dist/types.d.ts

@@ -209,10 +209,14 @@ export interface RoomActiveUser {
     avatarDjUrl?: string | null;
     avatarFrameCount?: number;
     guest?: boolean;
+    /** Independent VIP benefit; can coexist with any assigned room role. */
+    isVip?: boolean;
     role?: RoomRoleName | string;
-    /** Bot snapshots expose effective authorization roles; website badges may use assignedRoomRole. */
+    /** Actual room assignment, independent of platform privileges. */
     roomRole?: RoomRoleName | string;
     assignedRoomRole?: RoomRoleName | string;
+    /** Effective hierarchy including platform privileges; not an exhaustive permission list. */
+    effectiveRoomRole?: RoomRoleName | string;
     platformRole?: string | null;
     platformRoles?: string[];
     customGlobalRoles?: unknown[];
@@ -1618,11 +1622,13 @@ export interface BotPrivateCommand {
         userId: string;
         username: string;
         displayUsername: string;
-        /** Effective authorization role: Admin/Developer >= Host; Ambassador >= Manager. */
+        /** Actual assigned room role. */
         roomRole: string;
-        /** Effective role alias supplied by the current server; omitted by older deployments. */
+        /** Actual assigned room role alias. */
         role?: string;
         assignedRoomRole?: string;
+        /** Admin/Developer >= Host; Ambassador >= Manager. Additional grants are not encoded here. */
+        effectiveRoomRole?: string;
         platformRole?: string;
         platformRoles: string[];
         isRoomOwner: boolean;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wavezfm/api",
-  "version": "0.7.33",
+  "version": "0.7.35",
   "description": "Official JavaScript/TypeScript API client for WavezFM.",
   "homepage": "https://docs.wavez.fm/docs",
   "repository": {