JSDoc: Class: Intent

new Intent(client, botClient, opts)

Create an entity which can fulfil the intent of a given user.

Parameters:

Name Type Description

client MatrixClient The matrix client instance whose intent is being fulfilled e.g. the entity joining the room when you call intent.join(roomId).

botClient MatrixClient The client instance for the AS bot itself. This will be used to perform more priveleged actions such as creating new rooms, sending invites, etc.

opts

Object

Options for this Intent instance.

Properties

Name	Type	Description
`registered`	boolean	True to inform this instance that the client is already registered. No registration requests will be made from this Intent.

Source:

components/intent.js, line 24

Methods

ban(roomId, target, reason) → {Promise}

Ban a user from a room.

This will automatically make the client join the room so they can send the ban if they are not already joined.

Parameters:

Name	Type	Description
`roomId`	string	The room to ban the user from.
`target`	string	The target of the ban operation.
`reason`	string	Optional. The reason for the ban.

Source:

components/intent.js, line 243

Returns:

Resolved when banned, else rejected with an error.

Type: Promise

createRoom(opts) → {Promise}

Create a room with a set of options.

Parameters:

Name Type Description

opts

Object

Options.

Properties

Name	Type	Description
`createAsClient`	boolean	True to create this room as a client and not the bot: the bot will not join. False to create this room as the bot and auto-join the client. Default: false.
`options`	Object	Options to pass to the client SDK /createRoom API.

Source:

components/intent.js, line 190

Returns:

Type: Promise

invite(roomId, target) → {Promise}

Invite a user to a room.

This will automatically make the client join the room so they can send the invite if they are not already joined.

Parameters:

Name	Type	Description
`roomId`	string	The room to invite the user to.
`target`	string	The user ID to invite.

Source:

components/intent.js, line 211

Returns:

Resolved when invited, else rejected with an error.

Type: Promise

join(roomId) → {Promise}

Join a room

This will automatically send an invite from the bot if it is an invite-only room, which may make the bot attempt to join the room if it isn't already.

Parameters:

Name	Type	Description
`roomId`	string	The room to join.

Source:

components/intent.js, line 272

Returns:

Type: Promise

kick(roomId, target, reason) → {Promise}

Kick a user from a room.

This will automatically make the client join the room so they can send the kick if they are not already joined.

Parameters:

Name	Type	Description
`roomId`	string	The room to kick the user from.
`target`	string	The target of the kick operation.
`reason`	string	Optional. The reason for the kick.

Source:

components/intent.js, line 227

Returns:

Resolved when kickked, else rejected with an error.

Type: Promise

leave(roomId) → {Promise}

Leave a room

This will no-op if the user isn't in the room.

Parameters:

Name	Type	Description
`roomId`	string	The room to leave.

Source:

components/intent.js, line 282

Returns:

Type: Promise

onEvent(event)

Inform this Intent class of an incoming event. Various optimisations will be done if this is provided. For example, a /join request won't be sent out if it knows you've already been joined to the room.

Parameters:

Name	Type	Description
`event`	Object	The incoming event JSON

Source:

components/intent.js, line 316

roomState(roomId) → {Promise}

Get the current room state for a room.

This will automatically make the client join the room so they can get the state if they are not already joined.

Parameters:

Name	Type	Description
`roomId`	string	The room to get the state from.

Source:

components/intent.js, line 174

Returns:

Type: Promise

sendEvent(roomId, type, content) → {Promise}

Send a message event to a room.

This will automatically make the client join the room so they can send the message if they are not already joined. It will also make sure that the client has sufficient power level to do this.

Parameters:

Name	Type	Description
`roomId`	string	The room to send to.
`type`	string	The event type
`content`	Object	The event content

Source:

components/intent.js, line 138

Returns:

Type: Promise

sendMessage(roomId, content) → {Promise}

Send an m.room.message event to a room.

This will automatically make the client join the room so they can send the message if they are not already joined. It will also make sure that the client has sufficient power level to do this.

Parameters:

Name	Type	Description
`roomId`	string	The room to send to.
`content`	Object	The event content

Source:

components/intent.js, line 124

Returns:

Type: Promise

sendStateEvent(roomId, type, skey, content) → {Promise}

Send a state event to a room.

This will automatically make the client join the room so they can send the state if they are not already joined. It will also make sure that the client has sufficient power level to do this.

Parameters:

Name	Type	Description
`roomId`	string	The room to send to.
`type`	string	The event type
`skey`	string	The state key
`content`	Object	The event content

Source:

components/intent.js, line 158

Returns:

Type: Promise

sendText(roomId, text) → {Promise}

Send a plaintext message to a room.

This will automatically make the client join the room so they can send the message if they are not already joined. It will also make sure that the client has sufficient power level to do this.

Parameters:

Name	Type	Description
`roomId`	string	The room to send to.
`text`	string	The text string to send.

Source:

components/intent.js, line 45

Returns:

Type: Promise

sendTyping(roomId, isTyping) → {Promise}

Send a typing event to a room.

This will automatically make the client join the room so they can send the typing event if they are not already joined.

Parameters:

Name	Type	Description
`roomId`	string	The room to send to.
`isTyping`	boolean	True if typing

Source:

components/intent.js, line 90

Returns:

Type: Promise

setAvatarUrl(url) → {Promise}

Set the user's avatar URL

Parameters:

Name	Type	Description
`url`	string	The new avatar URL

Source:

components/intent.js, line 303

Returns:

Type: Promise

setDisplayName(name) → {Promise}

Set the user's display name

Parameters:

Name	Type	Description
`name`	string	The new display name

Source:

components/intent.js, line 291

Returns:

Type: Promise

setPowerLevel(roomId, target, level) → {Promise}

Set the power level of the given target.

Parameters:

Name	Type	Description
`roomId`	string	The room to set the power level in.
`target`	string	The target user ID
`level`	number	The desired level

Source:

components/intent.js, line 106

Returns:

Type: Promise

setRoomName(roomId, name) → {Promise}

Set the name of a room.

This will automatically make the client join the room so they can set the name if they are not already joined. It will also make sure that the client has sufficient power level to do this.

Parameters:

Name	Type	Description
`roomId`	string	The room to send to.
`name`	string	The room name.

Source:

components/intent.js, line 61

Returns:

Type: Promise

setRoomTopic(roomId, topic) → {Promise}

Set the topic of a room.

This will automatically make the client join the room so they can set the topic if they are not already joined. It will also make sure that the client has sufficient power level to do this.

Parameters:

Name	Type	Description
`roomId`	string	The room to send to.
`topic`	string	The room topic.

Source:

components/intent.js, line 76

Returns:

Type: Promise

unban(roomId, target) → {Promise}

Unban a user from a room.

This will automatically make the client join the room so they can send the unban if they are not already joined.

Parameters:

Name	Type	Description
`roomId`	string	The room to unban the user from.
`target`	string	The target of the unban operation.

Source:

components/intent.js, line 258

Returns:

Resolved when unbanned, else rejected with an error.

Type: Promise