polfan-server-js-client 0.3.0 → 0.3.1

package/build/types/AbstractChatClient.d.ts

@@ -1,4 +1,4 @@
-import { Bye, GetSession, JoinSpace, Session, SpaceJoined, Error as ErrorType, SpaceLeft, SpaceMemberJoined, SpaceMemberLeft, SpaceMemberUpdated, SpaceDeleted, SpaceMembers, SpaceRooms, NewRole, RoomDeleted, RoomJoined, RoomLeft, RoomMemberLeft, RoomMemberJoined, RoomMembers, NewRoom, NewTopic, TopicDeleted, NewMessage, GetPermissionOverwrites, GetComputedPermissions, LeaveSpace, CreateSpace, DeleteSpace, GetSpaceMembers, GetSpaceRooms, CreateRole, DeleteRole, AssignRole, DeassignRole, SetPermissionOverwrites, JoinRoom, LeaveRoom, CreateRoom, DeleteRoom, GetRoomMembers, CreateTopic, DeleteTopic, CreateMessage, Envelope, PermissionOverwrites, PermissionOverwritesUpdated, RoomMemberUpdated, UpdateRole, RoleUpdated, Ack, UserUpdated, UpdateRoom, RoomUpdated, UpdateSpace, SpaceUpdated, PermissionOverwriteTargets, GetPermissionOverwriteTargets, Owners, Ok, GetOwners, CreateOwner, RoleDeleted, FollowedTopicUpdated, TopicFollowed, FollowedTopics, FollowTopic, UpdateFollowedTopic, GetFollowedTopics, Messages, GetMessages, Topics, GetTopics, TopicUpdated, UpdateTopic, GetDiscoverableSpaces, DiscoverableSpaces, CreateEmoticon, DeleteEmoticon, GetEmoticons, Emoticons, EmoticonDeleted, NewEmoticon, Bans, GetBans, Ban, Unban, Kick, ClientData, GetClientData, SetClientData, GetRoomSummary, GetSpaceSummary, RoomSummaryEvent, SpaceSummaryEvent, UpdateSpaceMember, Relationships, RelationshipDeleted, NewRelationship, DeleteRelationship, CreateRelationship, RoomSummaryUpdated, Pong, Ping, RedactMessages, MessagesRedacted, ReportAbuse, UpdateRoomMember, GetRelationships, GetUserInfo, UserInfo, SetSessionData, SessionData, GetSessionData, SetUserData, UserData, GetUserData, UnfollowTopic, TopicUnfollowed } from "./types/src";
+import { Bye, GetSession, JoinSpace, Session, SpaceJoined, Error as ErrorType, SpaceLeft, SpaceMemberJoined, SpaceMemberLeft, SpaceMemberUpdated, SpaceDeleted, SpaceMembers, SpaceRooms, NewRole, RoomDeleted, RoomJoined, RoomLeft, RoomMemberLeft, RoomMembersJoined, RoomMembers, NewRoom, NewTopic, TopicDeleted, NewMessage, GetPermissionOverwrites, GetComputedPermissions, LeaveSpace, CreateSpace, DeleteSpace, GetSpaceMembers, GetSpaceRooms, CreateRole, DeleteRole, AssignRole, DeassignRole, SetPermissionOverwrites, JoinRoom, LeaveRoom, CreateRoom, DeleteRoom, GetRoomMembers, CreateTopic, DeleteTopic, CreateMessage, Envelope, PermissionOverwrites, PermissionOverwritesUpdated, RoomMemberUpdated, UpdateRole, RoleUpdated, Ack, UserUpdated, UpdateRoom, RoomUpdated, UpdateSpace, SpaceUpdated, PermissionOverwriteTargets, GetPermissionOverwriteTargets, Owners, Ok, GetOwners, CreateOwner, RoleDeleted, FollowedTopicUpdated, TopicFollowed, FollowedTopics, FollowTopic, UpdateFollowedTopic, GetFollowedTopics, Messages, GetMessages, Topics, GetTopics, TopicUpdated, UpdateTopic, GetDiscoverableSpaces, DiscoverableSpaces, CreateEmoticon, DeleteEmoticon, GetEmoticons, Emoticons, EmoticonDeleted, NewEmoticon, Bans, GetBans, Ban, Unban, Kick, ClientData, GetClientData, SetClientData, GetRoomSummary, GetSpaceSummary, RoomSummaryEvent, SpaceSummaryEvent, UpdateSpaceMember, Relationships, RelationshipDeleted, NewRelationship, DeleteRelationship, CreateRelationship, RoomSummaryUpdated, Pong, Ping, RedactMessages, MessagesRedacted, ReportAbuse, UpdateRoomMember, GetRelationships, GetUserInfo, UserInfo, SetSessionData, SessionData, GetSessionData, SetUserData, UserData, GetUserData, UnfollowTopic, TopicUnfollowed, Invite, Uninvite, GetInvited, Invited } from "./types/src";
 import { EventTarget } from "./EventTarget";
 type ArrayOfPromiseResolvers = [(value: any) => void, (reason?: any) => void];
 type ExtraEventMap = Record<string, any>;
@@ -68,7 +68,7 @@ export type EventsMap = {
     SpaceSummaryEvent: SpaceSummaryEvent;
     RoomJoined: RoomJoined;
     RoomLeft: RoomLeft;
-    RoomMemberJoined: RoomMemberJoined;
+    RoomMembersJoined: RoomMembersJoined;
     RoomMemberLeft: RoomMemberLeft;
     RoomMemberUpdated: RoomMemberUpdated;
     RoomMembers: RoomMembers;
@@ -77,6 +77,7 @@ export type EventsMap = {
     RoomUpdated: RoomUpdated;
     RoomSummaryEvent: RoomSummaryEvent;
     RoomSummaryUpdated: RoomSummaryUpdated;
+    Invited: Invited;
     NewTopic: NewTopic;
     TopicDeleted: TopicDeleted;
     NewMessage: NewMessage;
@@ -144,6 +145,9 @@ export type CommandsMap = {
     GetRoomMembers: CommandDefinition<GetRoomMembers, EventsMap['RoomMembers']>;
     GetRoomSummary: CommandDefinition<GetRoomSummary, EventsMap['RoomSummaryEvent']>;
     UpdateRoomMember: CommandDefinition<UpdateRoomMember, EventsMap['RoomMemberUpdated']>;
+    Invite: CommandDefinition<Invite, EventsMap['Invited']>;
+    Uninvite: CommandDefinition<Uninvite, EventsMap['Invited']>;
+    GetInvited: CommandDefinition<GetInvited, EventsMap['Invited']>;
     CreateTopic: CommandDefinition<CreateTopic, EventsMap['NewTopic']>;
     DeleteTopic: CommandDefinition<DeleteTopic, EventsMap['TopicDeleted']>;
     CreateMessage: CommandDefinition<CreateMessage, EventsMap['NewMessage']>;

package/build/types/Permissions.d.ts

@@ -86,6 +86,10 @@ export declare class Permissions {
             value: number;
             maxLayer: Layer;
         };
+        AddMembers: {
+            value: number;
+            maxLayer: Layer;
+        };
     };
     static getNames(): (keyof typeof this.list)[];
     static getByName(name: keyof typeof this.list): PermissionDefinition | undefined;

package/build/types/state-tracker/RoomsManager.d.ts

@@ -51,7 +51,7 @@ export declare class RoomsManager {
     private handleTopicUpdated;
     private addJoinedRooms;
     private handleRoomLeft;
-    private handleRoomMemberJoined;
+    private handleRoomMembersJoined;
     private handleRoomMemberLeft;
     private handleRoomMembers;
     private handleSession;

package/build/types/state-tracker/SpacesManager.d.ts

@@ -24,6 +24,12 @@ export declare class SpacesManager {
      * Get collection of the all available rooms inside given space.
      */
     getRooms(spaceId: string): Promise<ObservableIndexedObjectCollection<RoomSummary> | undefined>;
+    /**
+     * Drop the cached room listing of the space and fetch it again from the server.
+     * Room visibility depends on things this client is not notified about (invitations,
+     * permission changes), so the listing needs a way to be pulled anew on demand.
+     */
+    refreshRooms(spaceId: string): Promise<ObservableIndexedObjectCollection<RoomSummary> | undefined>;
     /**
      * Get collection of space members.
      */

package/build/types/types/src/index.d.ts

@@ -26,7 +26,7 @@ import { NewRole } from "./schemes/events/NewRole";
 import { RoleDeleted } from "./schemes/events/RoleDeleted";
 import { RoomJoined } from "./schemes/events/RoomJoined";
 import { RoomLeft } from "./schemes/events/RoomLeft";
-import { RoomMemberJoined } from "./schemes/events/RoomMemberJoined";
+import { RoomMembersJoined } from "./schemes/events/RoomMembersJoined";
 import { RoomMemberLeft } from "./schemes/events/RoomMemberLeft";
 import { RoomMembers } from "./schemes/events/RoomMembers";
 import { RoomMemberUpdated } from "./schemes/events/RoomMemberUpdated";
@@ -140,5 +140,9 @@ import { UserData, PrivateMessagePolicy } from "./schemes/UserData";
 import { SetUserData } from "./schemes/commands/SetUserData";
 import { GetUserData } from "./schemes/commands/GetUserData";
 import { UnfollowTopic } from "./schemes/commands/UnfollowTopic";
+import { Invite } from "./schemes/commands/Invite";
+import { Uninvite } from "./schemes/commands/Uninvite";
+import { GetInvited } from "./schemes/commands/GetInvited";
+import { Invited } from "./schemes/events/Invited";
 import { TopicUnfollowed } from "./schemes/events/TopicUnfollowed";
-export { Envelope, Message, MessageType, MessageAuthor, Role, Room, RoomType, RoomStream, RoomStreamType, RoomHistory, RoomHistoryMode, RoomMember, RoomSummary, RoomSummaryExtras, Space, SpaceMember, Topic, FollowedTopic, NotificationLevel, User, UserState, PermissionOverwritesValue, ChatLocation, SpaceSummary, SpaceDiscoverable, Emoticon, PermissionOverwritesTarget, BanObject, LeaveReason, UserRelationship, UserRelationshipType, CreateTopicInitialMessage, UserInformation, SessionPush, SessionData, UserData, PrivateMessagePolicy, Bye, Error, Messages, NewMessage, NewRole, NewRoom, NewTopic, TopicFollowed, TopicUnfollowed, FollowedTopics, FollowedTopicUpdated, ComputedPermissions, PermissionOverwrites, PermissionOverwritesUpdated, RoleDeleted, RoleUpdated, RoomDeleted, RoomUpdated, RoomJoined, RoomLeft, RoomMemberJoined, RoomMemberLeft, RoomMembers, RoomMemberUpdated, UserUpdated, Session, SpaceDeleted, SpaceUpdated, SpaceJoined, SpaceLeft, SpaceMemberJoined, SpaceMemberLeft, SpaceMembers, SpaceMemberUpdated, SpaceRooms, TopicDeleted, TopicUpdated, PermissionOverwriteTargets, Owners, Ok, DiscoverableSpaces, Emoticons, EmoticonDeleted, NewEmoticon, Bans, ClientData, SpaceSummaryEvent, RoomSummaryEvent, NewRelationship, RelationshipDeleted, Relationships, RoomSummaryUpdated, Pong, MessagesRedacted, UserInfo, AssignRole, GetMessages, CreateMessage, Ack, CreateRole, CreateRoom, CreateSpace, CreateTopic, FollowTopic, UnfollowTopic, UpdateFollowedTopic, GetFollowedTopics, DeassignRole, DeleteRole, DeleteRoom, DeleteSpace, DeleteTopic, SetPermissionOverwrites, GetPermissionOverwrites, GetComputedPermissions, GetRoomMembers, GetSession, GetSpaceMembers, GetSpaceRooms, JoinRoom, JoinSpace, LeaveRoom, LeaveSpace, UpdateRole, UpdateSpace, UpdateRoom, UpdateTopic, GetPermissionOverwriteTargets, CreateOwner, DeleteOwner, GetOwners, Topics, GetTopics, GetDiscoverableSpaces, GetEmoticons, CreateEmoticon, DeleteEmoticon, Ban, Unban, GetBans, Kick, GetClientData, SetClientData, GetSpaceSummary, GetRoomSummary, UpdateSpaceMember, CreateRelationship, DeleteRelationship, GetRelationships, UpdateRoomMember, Ping, ReportAbuse, RedactMessages, GetUserInfo, SetSessionData, GetSessionData, SetUserData, GetUserData, };
+export { Envelope, Message, MessageType, MessageAuthor, Role, Room, RoomType, RoomStream, RoomStreamType, RoomHistory, RoomHistoryMode, RoomMember, RoomSummary, RoomSummaryExtras, Space, SpaceMember, Topic, FollowedTopic, NotificationLevel, User, UserState, PermissionOverwritesValue, ChatLocation, SpaceSummary, SpaceDiscoverable, Emoticon, PermissionOverwritesTarget, BanObject, LeaveReason, UserRelationship, UserRelationshipType, CreateTopicInitialMessage, UserInformation, SessionPush, SessionData, UserData, PrivateMessagePolicy, Bye, Error, Messages, NewMessage, NewRole, NewRoom, NewTopic, TopicFollowed, TopicUnfollowed, FollowedTopics, FollowedTopicUpdated, ComputedPermissions, PermissionOverwrites, PermissionOverwritesUpdated, RoleDeleted, RoleUpdated, RoomDeleted, RoomUpdated, RoomJoined, RoomLeft, RoomMembersJoined, RoomMemberLeft, RoomMembers, RoomMemberUpdated, UserUpdated, Session, SpaceDeleted, SpaceUpdated, SpaceJoined, SpaceLeft, SpaceMemberJoined, SpaceMemberLeft, SpaceMembers, SpaceMemberUpdated, SpaceRooms, TopicDeleted, TopicUpdated, PermissionOverwriteTargets, Owners, Ok, DiscoverableSpaces, Emoticons, EmoticonDeleted, NewEmoticon, Bans, ClientData, SpaceSummaryEvent, RoomSummaryEvent, NewRelationship, RelationshipDeleted, Relationships, RoomSummaryUpdated, Pong, MessagesRedacted, UserInfo, Invited, AssignRole, GetMessages, CreateMessage, Ack, CreateRole, CreateRoom, CreateSpace, CreateTopic, FollowTopic, UnfollowTopic, UpdateFollowedTopic, GetFollowedTopics, DeassignRole, DeleteRole, DeleteRoom, DeleteSpace, DeleteTopic, SetPermissionOverwrites, GetPermissionOverwrites, GetComputedPermissions, GetRoomMembers, GetSession, GetSpaceMembers, GetSpaceRooms, JoinRoom, JoinSpace, LeaveRoom, LeaveSpace, UpdateRole, UpdateSpace, UpdateRoom, UpdateTopic, GetPermissionOverwriteTargets, CreateOwner, DeleteOwner, GetOwners, Topics, GetTopics, GetDiscoverableSpaces, GetEmoticons, CreateEmoticon, DeleteEmoticon, Ban, Unban, GetBans, Kick, GetClientData, SetClientData, GetSpaceSummary, GetRoomSummary, UpdateSpaceMember, CreateRelationship, DeleteRelationship, GetRelationships, UpdateRoomMember, Ping, ReportAbuse, RedactMessages, GetUserInfo, SetSessionData, GetSessionData, SetUserData, GetUserData, Invite, Uninvite, GetInvited, };

package/build/types/types/src/schemes/Message.d.ts

@@ -1,6 +1,6 @@
 import { User } from "./User";
 import { ChatLocation } from "./ChatLocation";
-export type MessageType = 'Text' | 'RoomJoin' | 'RoomLeave' | 'SpaceJoin' | 'SpaceLeave' | 'TopicChange' | 'CustomNickChange' | 'Ephemeral';
+export type MessageType = 'Text' | 'RoomJoin' | 'RoomMemberAdd' | 'RoomLeave' | 'SpaceJoin' | 'SpaceLeave' | 'TopicChange' | 'CustomNickChange' | 'Ephemeral';
 export interface MessageAuthor {
     user: User;
     customNick?: string;

package/build/types/types/src/schemes/RoomSummary.d.ts

@@ -1,6 +1,7 @@
 import { RoomType } from "./Room";
 export interface RoomSummaryExtras {
     isPrivate: boolean;
+    isInvitationOnly: boolean;
 }
 export interface RoomSummary {
     id: string;

package/build/types/types/src/schemes/commands/GetInvited.d.ts

@@ -0,0 +1,3 @@
+export interface GetInvited {
+    roomId: string;
+}

package/build/types/types/src/schemes/commands/Invite.d.ts

@@ -0,0 +1,5 @@
+export interface Invite {
+    roomId: string;
+    userIds?: string[];
+    roleIds?: string[];
+}

package/build/types/types/src/schemes/commands/JoinRoom.d.ts

@@ -1,3 +1,13 @@
 export interface JoinRoom {
     id: string;
+    /**
+     * Ids of the users to add to the room instead of joining it yourself.
+     * Requires the `AddMembers` permission.
+     */
+    userIds?: string[];
+    /**
+     * Ids of the roles whose members should be added to the room. The space default
+     * ("everyone") role is not supported. Requires the `AddMembers` permission.
+     */
+    roleIds?: string[];
 }

package/build/types/types/src/schemes/commands/Uninvite.d.ts

@@ -0,0 +1,5 @@
+export interface Uninvite {
+    roomId: string;
+    userIds?: string[];
+    roleIds?: string[];
+}

package/build/types/types/src/schemes/events/Invited.d.ts

@@ -0,0 +1,10 @@
+import { ChatLocation } from "../ChatLocation";
+import { Role } from "../Role";
+export interface Invited {
+    location: ChatLocation;
+    /**
+     * Ids of the invited users. Join them with the space member collection to display them.
+     */
+    userIds: string[];
+    roles: Role[];
+}

package/build/types/types/src/schemes/events/RoomMembersJoined.d.ts

@@ -0,0 +1,9 @@
+import { RoomMember } from "../RoomMember";
+export interface RoomMembersJoined {
+    roomId: string;
+    members: RoomMember[];
+    /**
+     * Id of the user who added the members to the room, null when they joined on their own.
+     */
+    addedByUserId: string | null;
+}

package/build/types/types/src/schemes/events/RoomSummaryUpdated.d.ts

@@ -1,7 +1,8 @@
 import { RoomSummary } from "../RoomSummary";
 export interface RoomSummaryUpdated {
     /**
-     * Partial summary: without the `extras` field.
+     * Partial summary - the client merges it into the cached one.
+     * Private rooms do not emit this event at all.
      */
     summary: RoomSummary;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "polfan-server-js-client",
-  "version": "0.3.0",
+  "version": "0.3.1",
   "description": "JavaScript client library for handling communication with Polfan chat server.",
   "author": "Jarosław Żak",
   "license": "MIT",

package/src/AbstractChatClient.ts

@@ -17,7 +17,7 @@ import {
     RoomJoined,
     RoomLeft,
     RoomMemberLeft,
-    RoomMemberJoined,
+    RoomMembersJoined,
     RoomMembers,
     NewRoom,
     NewTopic,
@@ -118,6 +118,10 @@ import {
     GetUserData,
     UnfollowTopic,
     TopicUnfollowed,
+    Invite,
+    Uninvite,
+    GetInvited,
+    Invited,
 } from "./types/src";
 import {EventTarget} from "./EventTarget";
 
@@ -236,7 +240,7 @@ export type CommandResponse<CommandType extends keyof CommandsMap> = CommandsMap
     // Room events
     RoomJoined: RoomJoined,
     RoomLeft: RoomLeft,
-    RoomMemberJoined: RoomMemberJoined,
+    RoomMembersJoined: RoomMembersJoined,
     RoomMemberLeft: RoomMemberLeft,
     RoomMemberUpdated: RoomMemberUpdated,
     RoomMembers: RoomMembers,
@@ -245,6 +249,7 @@ export type CommandResponse<CommandType extends keyof CommandsMap> = CommandsMap
     RoomUpdated: RoomUpdated,
     RoomSummaryEvent: RoomSummaryEvent,
     RoomSummaryUpdated: RoomSummaryUpdated,
+    Invited: Invited,
     // Topic events
     NewTopic: NewTopic,
     TopicDeleted: TopicDeleted,
@@ -317,6 +322,9 @@ export type CommandsMap = {
     GetRoomMembers: CommandDefinition<GetRoomMembers, EventsMap['RoomMembers']>,
     GetRoomSummary: CommandDefinition<GetRoomSummary, EventsMap['RoomSummaryEvent']>,
     UpdateRoomMember: CommandDefinition<UpdateRoomMember, EventsMap['RoomMemberUpdated']>,
+    Invite: CommandDefinition<Invite, EventsMap['Invited']>,
+    Uninvite: CommandDefinition<Uninvite, EventsMap['Invited']>,
+    GetInvited: CommandDefinition<GetInvited, EventsMap['Invited']>,
      // Topic commands
     CreateTopic: CommandDefinition<CreateTopic, EventsMap['NewTopic']>,
     DeleteTopic: CommandDefinition<DeleteTopic, EventsMap['TopicDeleted']>,

package/src/Permissions.ts

@@ -32,6 +32,7 @@ export class Permissions {
         ChangeOwnNick: {value: 1 << 17, maxLayer: Layer.Space},
         ChangeOwnColor: {value: 1 << 18, maxLayer: Layer.Room},
         RedactMessages: {value: 1 << 19, maxLayer: Layer.Topic},
+        AddMembers: {value: 1 << 20, maxLayer: Layer.Space},
     };
 
     public static getNames(): (keyof typeof this.list)[] {

package/src/state-tracker/RoomsManager.ts

@@ -6,7 +6,7 @@ import {
     NewTopic,
     Room, RoomDeleted,
     RoomJoined, RoomLeft,
-    RoomMember, RoomMemberJoined, RoomMemberLeft, RoomMembers,
+    RoomMember, RoomMemberLeft, RoomMembers, RoomMembersJoined,
     RoomMemberUpdated, RoomUpdated, Session, SpaceDeleted, SpaceLeft, SpaceMemberLeft,
     SpaceMemberUpdated,
     Topic,
@@ -42,7 +42,7 @@ export class RoomsManager {
         this.tracker.client.on('RoomUpdated', ev => this.handleRoomUpdated(ev));
         this.tracker.client.on('RoomDeleted', ev => this.handleRoomDeleted(ev));
         this.tracker.client.on('TopicUpdated', ev => this.handleTopicUpdated(ev));
-        this.tracker.client.on('RoomMemberJoined', ev => this.handleRoomMemberJoined(ev));
+        this.tracker.client.on('RoomMembersJoined', ev => this.handleRoomMembersJoined(ev));
         this.tracker.client.on('RoomMemberLeft', ev => this.handleRoomMemberLeft(ev));
         this.tracker.client.on('RoomMembers', ev => this.handleRoomMembers(ev));
         this.tracker.client.on('RoomMemberUpdated', ev => this.handleRoomMemberUpdated(ev));
@@ -282,9 +282,9 @@ export class RoomsManager {
         this.deleteRoom(ev.id);
     }
 
-    private handleRoomMemberJoined(ev: RoomMemberJoined): void {
+    private handleRoomMembersJoined(ev: RoomMembersJoined): void {
         if (this.members.has(ev.roomId)) {
-            this.members.get(ev.roomId).set(ev.member);
+            this.members.get(ev.roomId).set(...ev.members);
         }
     }
 

package/src/state-tracker/SpacesManager.ts

@@ -92,6 +92,16 @@ export class SpacesManager {
         return this.rooms.get(spaceId);
     }
 
+    /**
+     * Drop the cached room listing of the space and fetch it again from the server.
+     * Room visibility depends on things this client is not notified about (invitations,
+     * permission changes), so the listing needs a way to be pulled anew on demand.
+     */
+    public async refreshRooms(spaceId: string): Promise<ObservableIndexedObjectCollection<RoomSummary> | undefined> {
+        this.roomsPromises.forget(spaceId);
+        return this.getRooms(spaceId);
+    }
+
     /**
      * Get collection of space members.
      */

package/src/state-tracker/UsersManager.ts

@@ -12,7 +12,7 @@ export class UsersManager {
     public constructor(private tracker: ChatStateTracker) {
         // RoomMemberUpdated & SpaceMemberUpdated events are not contains user object
         tracker.client.on('UserUpdated', event => this.handleUsers([event.user]));
-        tracker.client.on('RoomMemberJoined', event => this.handleMembers([event.member]));
+        tracker.client.on('RoomMembersJoined', event => this.handleMembers(event.members));
         tracker.client.on('SpaceMemberJoined', event => this.handleMembers([event.member]));
         tracker.client.on('SpaceMembers', event => this.handleMembers(event.members));
         tracker.client.on('RoomMembers', event => this.handleMembers(event.members));

package/src/types/src/index.ts

@@ -26,7 +26,7 @@ import {NewRole} from "./schemes/events/NewRole";
 import {RoleDeleted} from "./schemes/events/RoleDeleted";
 import {RoomJoined} from "./schemes/events/RoomJoined";
 import {RoomLeft} from "./schemes/events/RoomLeft";
-import {RoomMemberJoined} from "./schemes/events/RoomMemberJoined";
+import {RoomMembersJoined} from "./schemes/events/RoomMembersJoined";
 import {RoomMemberLeft} from "./schemes/events/RoomMemberLeft";
 import {RoomMembers} from "./schemes/events/RoomMembers";
 import {RoomMemberUpdated} from "./schemes/events/RoomMemberUpdated";
@@ -140,6 +140,10 @@ import {UserData, PrivateMessagePolicy} from "./schemes/UserData";
 import {SetUserData} from "./schemes/commands/SetUserData";
 import {GetUserData} from "./schemes/commands/GetUserData";
 import {UnfollowTopic} from "./schemes/commands/UnfollowTopic";
+import {Invite} from "./schemes/commands/Invite";
+import {Uninvite} from "./schemes/commands/Uninvite";
+import {GetInvited} from "./schemes/commands/GetInvited";
+import {Invited} from "./schemes/events/Invited";
 import {TopicUnfollowed} from "./schemes/events/TopicUnfollowed";
 
 export {
@@ -202,7 +206,7 @@ export {
     RoomUpdated,
     RoomJoined,
     RoomLeft,
-    RoomMemberJoined,
+    RoomMembersJoined,
     RoomMemberLeft,
     RoomMembers,
     RoomMemberUpdated,
@@ -237,6 +241,7 @@ export {
     Pong,
     MessagesRedacted,
     UserInfo,
+    Invited,
     // commands
     AssignRole,
     GetMessages,
@@ -301,4 +306,7 @@ export {
     GetSessionData,
     SetUserData,
     GetUserData,
+    Invite,
+    Uninvite,
+    GetInvited,
 };

package/src/types/src/schemes/Message.ts

@@ -1,7 +1,7 @@
 import {User} from "./User";
 import {ChatLocation} from "./ChatLocation";
 
-export type MessageType = 'Text'|'RoomJoin'|'RoomLeave'|'SpaceJoin'|'SpaceLeave'|'TopicChange'|'CustomNickChange'|'Ephemeral';
+export type MessageType = 'Text'|'RoomJoin'|'RoomMemberAdd'|'RoomLeave'|'SpaceJoin'|'SpaceLeave'|'TopicChange'|'CustomNickChange'|'Ephemeral';
 
 export interface MessageAuthor {
     user: User;

package/src/types/src/schemes/RoomSummary.ts

@@ -2,6 +2,7 @@ import {RoomType} from "./Room";
 
 export interface RoomSummaryExtras {
     isPrivate: boolean;
+    isInvitationOnly: boolean;
 }
 
 export interface RoomSummary {
@@ -12,4 +13,4 @@ export interface RoomSummary {
     memberCount: number;
     type: RoomType;
     extras?: RoomSummaryExtras;
-}
+}

package/src/types/src/schemes/commands/GetInvited.ts

@@ -0,0 +1,3 @@
+export interface GetInvited {
+    roomId: string;
+}

package/src/types/src/schemes/commands/Invite.ts

@@ -0,0 +1,5 @@
+export interface Invite {
+    roomId: string;
+    userIds?: string[];
+    roleIds?: string[];
+}

package/src/types/src/schemes/commands/JoinRoom.ts

@@ -1,3 +1,15 @@
 export interface JoinRoom {
     id: string;
+
+    /**
+     * Ids of the users to add to the room instead of joining it yourself.
+     * Requires the `AddMembers` permission.
+     */
+    userIds?: string[];
+
+    /**
+     * Ids of the roles whose members should be added to the room. The space default
+     * ("everyone") role is not supported. Requires the `AddMembers` permission.
+     */
+    roleIds?: string[];
 }

package/src/types/src/schemes/commands/Uninvite.ts

@@ -0,0 +1,5 @@
+export interface Uninvite {
+    roomId: string;
+    userIds?: string[];
+    roleIds?: string[];
+}

package/src/types/src/schemes/events/Invited.ts

@@ -0,0 +1,13 @@
+import {ChatLocation} from "../ChatLocation";
+import {Role} from "../Role";
+
+export interface Invited {
+    location: ChatLocation;
+
+    /**
+     * Ids of the invited users. Join them with the space member collection to display them.
+     */
+    userIds: string[];
+
+    roles: Role[];
+}

package/src/types/src/schemes/events/RoomMembersJoined.ts

@@ -0,0 +1,11 @@
+import {RoomMember} from "../RoomMember";
+
+export interface RoomMembersJoined {
+    roomId: string;
+    members: RoomMember[];
+
+    /**
+     * Id of the user who added the members to the room, null when they joined on their own.
+     */
+    addedByUserId: string | null;
+}

package/src/types/src/schemes/events/RoomSummaryUpdated.ts

@@ -2,7 +2,8 @@ import {RoomSummary} from "../RoomSummary";
 
 export interface RoomSummaryUpdated {
     /**
-     * Partial summary: without the `extras` field.
+     * Partial summary - the client merges it into the cached one.
+     * Private rooms do not emit this event at all.
      */
     summary: RoomSummary;
-}
+}

package/src/types/src/schemes/events/RoomMemberJoined.ts

@@ -1,6 +0,0 @@
-import {RoomMember} from "../RoomMember";
-
-export interface RoomMemberJoined {
-    roomId: string;
-    member: RoomMember;
-}