Class EncryptedIntent

Implements some special handling on top of Intent to handle encrypted rooms.

Hierarchy

Intent
- EncryptedIntent

Constructors

constructor

new EncryptedIntent(botSdkIntent: Intent, botClient: MatrixClient, intentOpts: IntentOpts, encryptionOpts: EncryptedIntentOpts): EncryptedIntent
Parameters
- botSdkIntent: Intent
- botClient: MatrixClient
- intentOpts: IntentOpts
- encryptionOpts: EncryptedIntentOpts
Returns EncryptedIntent

Overrides Intent.constructor

Properties

`Readonly` botSdkIntent

botSdkIntent: Intent

`Protected` opts

opts: { backingStore: IntentBackingStore; caching: { size: number; ttl: number }; dontCheckPowerLevel?: boolean; dontJoin?: boolean; enablePresence: boolean; getJsSdkClient?: (() => any); onEventSent?: OnEventSentHook; registered?: boolean }

Type declaration

backingStore: IntentBackingStore
caching: { size: number; ttl: number }
- size: number
- ttl: number
Optional dontCheckPowerLevel?: boolean
Optional dontJoin?: boolean
enablePresence: boolean
Optional getJsSdkClient?: (() => any)
- - (): any
  - Returns any
Optional onEventSent?: OnEventSentHook
Optional registered?: boolean

Accessors

matrixClient

get matrixClient(): MatrixClient
Returns MatrixClient

Inherited from Intent.matrixClient

userId

get userId(): string
Returns string

Inherited from Intent.userId

Methods

`Protected` _ensureHasPowerLevelFor

_ensureHasPowerLevelFor(roomId: string, eventType: string, isState: boolean): Promise<undefined | PowerLevelContent>
Ensures that the client has the required power level to post the event type.

Returns
If found, the power level event
Parameters
- roomId: string
  
  Required as power levels exist inside a room.
- eventType: string
- isState: boolean
  
  Are we checking for state permissions or regular event permissions.
Returns Promise<undefined | PowerLevelContent>

Inherited from Intent._ensureHasPowerLevelFor

`Protected` _ensureJoined

_ensureJoined(roomIdOrAlias: string, ignoreCache?: boolean, viaServers?: string[], passthroughError?: boolean): Promise<string>
Parameters
- roomIdOrAlias: string
- ignoreCache: boolean = false
- Optional viaServers: string[]
- passthroughError: boolean = false
Returns Promise<string>

Inherited from Intent._ensureJoined

`Protected` _joinGuard

_joinGuard<T>(roomId: string, promiseFn: (() => Promise<T>)): Promise<T>
Type Parameters
- T
Parameters
- roomId: string
- promiseFn: (() => Promise<T>)
  - - (): Promise<T>
    - Returns Promise<T>
Returns Promise<T>

Inherited from Intent._joinGuard

ban

ban(roomId: string, target: string, reason?: string): Promise<any>
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.

Returns
Resolved when banned, else rejected with an error.
Parameters
- roomId: string
  
  The room to ban the user from.
- target: string
  
  The target of the ban operation.
- Optional reason: string
  
  Optional. The reason for the ban.
Returns Promise<any>

Inherited from Intent.ban

createAlias

createAlias(alias: string, roomId: string): Promise<any>
Create a new alias mapping.
Parameters
- alias: string
  
  The room alias to create
- roomId: string
  
  The room ID the alias should point at.
Returns Promise<any>

Inherited from Intent.createAlias

createRoom

createRoom(opts: RoomCreationOpts): Promise<{ room_id: string }>
Create a room with a set of options.
Parameters
- opts: RoomCreationOpts
  
  Options.
Returns Promise<{ room_id: string }>

Inherited from Intent.createRoom

createWidget

createWidget(roomId: string, widgetId: string, opts: WidgetOpts): Promise<string>
Create a widget in a room.

Returns
An eventID if the event was created.
Parameters
- roomId: string
  
  The room to create the widget in.
- widgetId: string
  
  The widget ID
- opts: WidgetOpts
  
  Options for the widget.
Returns Promise<string>

Inherited from Intent.createWidget

ensureProfile

ensureProfile(displayname?: string, avatarUrl?: string): Promise<void>
Ensure that the user has the given profile information set. If it does not, set it.
Parameters
- Optional displayname: string
  
  The displayname to set. Leave undefined to ignore.
- Optional avatarUrl: string
  
  The avatar to set. Leave undefined to ignore.
Returns Promise<void>

Inherited from Intent.ensureProfile

ensureRegistered

ensureRegistered(forceRegister?: boolean): Promise<undefined | "registered=true">
Parameters
- forceRegister: boolean = false
Returns Promise<undefined | "registered=true">

Overrides Intent.ensureRegistered

ensureWidgetInRoom

ensureWidgetInRoom(roomId: string, widgetId: string, opts: WidgetOpts): Promise<null | string>
Create a widget in a room, if one doesn't already exist

Returns
An eventID if the event was created, otherwise null.
Parameters
- roomId: string
  
  The room to create the widget in.
- widgetId: string
  
  The widget ID
- opts: WidgetOpts
  
  Options for the widget.
Returns Promise<null | string>

Inherited from Intent.ensureWidgetInRoom

getEvent

getEvent(roomId: string, eventId: string, useCache?: boolean): Promise<any>
Get an event in a room. This will automatically make the client join the room so they can get the event if they are not already joined.

Returns
Resolves with the content of the event, or rejects if not found.
Parameters
- roomId: string
  
  The room to fetch the event from.
- eventId: string
  
  The eventId of the event to fetch.
- useCache: boolean = true
  
  Should the request attempt to lookup from the cache.
Returns Promise<any>

Inherited from Intent.getEvent

getProfileInfo

getProfileInfo(userId: string, info?: UserProfileKeys, useCache?: boolean): Promise<MatrixProfileInfo>
Get a user's profile information

Returns
A Promise that resolves with the requested user's profile information
Parameters
- userId: string
  
  The ID of the user whose profile to return
- info: UserProfileKeys = null
  
  The profile field name to retrieve (e.g. 'displayname' or 'avatar_url'), or null to fetch the entire profile information.
- useCache: boolean = true
  
  Should the request attempt to lookup state from the cache.
Returns Promise<MatrixProfileInfo>

Inherited from Intent.getProfileInfo

getStateEvent

getStateEvent(roomId: string, eventType: string, stateKey?: string, returnNull?: boolean): Promise<any>
Get a state event in a room. This will automatically make the client join the room so they can get the state if they are not already joined.
Parameters
- roomId: string
  
  The room to get the state from.
- eventType: string
  
  The event type to fetch.
- stateKey: string = ""
  
  The state key of the event to fetch.
- returnNull: boolean = false
  
  Return null on not found, rather than throwing
Returns Promise<any>

Inherited from Intent.getStateEvent

invite

invite(roomId: string, target: string): Promise<any>
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.

Returns
Resolved when invited, else rejected with an error.
Parameters
- roomId: string
  
  The room to invite the user to.
- target: string
  
  The user ID to invite.
Returns Promise<any>

Inherited from Intent.invite

isRoomEncrypted

isRoomEncrypted(roomId: string): Promise<boolean>
Check if a room is encrypted. If it is, return the algorithm.

Returns
The encryption algorithm or false
Parameters
- roomId: string
  
  The room ID to be checked
Returns Promise<boolean>

join

join(roomIdOrAlias: string, viaServers?: string[]): Promise<string>
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
- roomIdOrAlias: string
  
  The room ID or room alias to join.
- Optional viaServers: string[]
  
  The server names to try and join through in addition to those that are automatically chosen.
Returns Promise<string>

Inherited from Intent.join

kick

kick(roomId: string, target: string, reason?: string): Promise<any>
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.

Returns
Resolved when kickked, else rejected with an error.
Parameters
- roomId: string
  
  The room to kick the user from.
- target: string
  
  The target of the kick operation.
- Optional reason: string
  
  Optional. The reason for the kick.
Returns Promise<any>

Inherited from Intent.kick

leave

leave(roomId: string, reason?: string): Promise<any>
Leave a room

This will no-op if the user isn't in the room.
Parameters
- roomId: string
  
  The room to leave.
- Optional reason: string
  
  An optional string to explain why the user left the room.
Returns Promise<any>

Inherited from Intent.leave

onEvent

onEvent(event: WeakStateEvent): void
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. This function does nothing if a backing store was provided to the Intent.
Parameters
- event: WeakStateEvent
  
  The incoming event JSON
Returns void

Overrides Intent.onEvent

resolveRoom

resolveRoom(roomAliasOrId: string): Promise<string>
Resolve a roomId or alias into a roomId. If a roomId is given, it is immediately returned.

Throws
If the provided string was incorrectly formatted or alias does not exist.
Parameters
- roomAliasOrId: string
  
  A roomId or alias to resolve.
Returns Promise<string>

Inherited from Intent.resolveRoom

roomState

roomState(roomId: string, useCache?: boolean): Promise<unknown>
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
- roomId: string
  
  The room to get the state from.
- useCache: boolean = false
  
  Should the request attempt to lookup state from the cache.
Returns Promise<unknown>

Inherited from Intent.roomState

sendEvent

sendEvent(roomId: string, type: string, content: Record<string, unknown>): Promise<{ event_id: string }>
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
- roomId: string
  
  The room to send to.
- type: string
  
  The event type
- content: Record<string, unknown>
  
  The event content
Returns Promise<{ event_id: string }>

Overrides Intent.sendEvent

sendMessage

sendMessage(roomId: string, content: Record<string, unknown>): Promise<{ event_id: string }>
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.

Returns
The eventId of the sent message
Parameters
- roomId: string
  
  The room to send to.
- content: Record<string, unknown>
  
  The event content
Returns Promise<{ event_id: string }>

Inherited from Intent.sendMessage

sendReadReceipt

sendReadReceipt(roomId: string, eventId: string): Promise<void>
Send a read receipt to a room.

This will automatically make the client join the room so they can send the receipt event if they are not already joined.
Parameters
- roomId: string
  
  The room to send to.
- eventId: string
  
  The event ID to set the receipt mark to.
Returns Promise<void>

Inherited from Intent.sendReadReceipt

sendStateEvent

sendStateEvent(roomId: string, type: string, skey: string, content: Record<string, unknown>): Promise<{ event_id: string }>
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.

Returns
The event ID wrapped inside an object (for legacy reasons)
Parameters
- roomId: string
  
  The room to send to.
- type: string
  
  The event type
- skey: string
  
  The state key
- content: Record<string, unknown>
  
  The event content
Returns Promise<{ event_id: string }>

Inherited from Intent.sendStateEvent

sendText

sendText(roomId: string, text: string): Promise<{ event_id: string }>
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.

Returns
The Matrix event ID.
Parameters
- roomId: string
  
  The room to send to.
- text: string
  
  The text string to send.
Returns Promise<{ event_id: string }>

Inherited from Intent.sendText

sendTyping

sendTyping(roomId: string, isTyping: boolean): Promise<void>
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
- roomId: string
  
  The room to send to.
- isTyping: boolean
  
  True if typing
Returns Promise<void>

Inherited from Intent.sendTyping

setAvatarUrl

setAvatarUrl(url: string): Promise<any>
Set the user's avatar URL
Parameters
- url: string
  
  The new avatar URL
Returns Promise<any>

Inherited from Intent.setAvatarUrl

setDisplayName

setDisplayName(name: string): Promise<any>
Set the user's display name
Parameters
- name: string
  
  The new display name
Returns Promise<any>

Inherited from Intent.setDisplayName

setPowerLevel

setPowerLevel(roomId: string, target: string, level: undefined | number): Promise<void>
Set the power level of the given target.
Parameters
- roomId: string
  
  The room to set the power level in.
- target: string
  
  The target user ID
- level: undefined | number
  
  The desired level. Undefined will remove the users custom power level.
Returns Promise<void>

Inherited from Intent.setPowerLevel

setPresence

setPresence(presence: PresenceState, statusMsg?: string): Promise<any>
Set the presence of this user.

Returns
Resolves if the presence was set or no-oped, rejects otherwise.
Parameters
- presence: PresenceState
  
  One of "online", "offline" or "unavailable".
- Optional statusMsg: string
Returns Promise<any>

Inherited from Intent.setPresence

setRoomAvatar

setRoomAvatar(roomId: string, avatar: string, info?: string): Promise<{ event_id: string }>
Set the avatar 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
- roomId: string
  
  The room to send to.
- avatar: string
  
  The url of the avatar.
- Optional info: string
  
  Extra information about the image. See m.room.avatar for details.
Returns Promise<{ event_id: string }>

Inherited from Intent.setRoomAvatar

setRoomDirectoryVisibility

setRoomDirectoryVisibility(roomId: string, visibility: "public" | "private"): Promise<any>
Set the visibility of a room in the homeserver's room directory.
Parameters
- roomId: string
  
  The room
- visibility: "public" | "private"
  
  Should the room be visible
Returns Promise<any>

Inherited from Intent.setRoomDirectoryVisibility

setRoomDirectoryVisibilityAppService

setRoomDirectoryVisibilityAppService(roomId: string, networkId: string, visibility: "public" | "private"): Promise<void>
Set the visibility of a room in the appservice's room directory. This only works if you have defined the protocol in the registration file.
Parameters
- roomId: string
  
  The room
- networkId: string
  
  The network (not protocol) that owns this room. E.g. "freenode" (for an IRC bridge)
- visibility: "public" | "private"
  
  Should the room be visible
Returns Promise<void>

Inherited from Intent.setRoomDirectoryVisibilityAppService

setRoomName

setRoomName(roomId: string, name: string): Promise<{ event_id: string }>
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.

Returns
The Matrix event ID.
Parameters
- roomId: string
  
  The room to send to.
- name: string
  
  The room name.
Returns Promise<{ event_id: string }>

Inherited from Intent.setRoomName

setRoomTopic

setRoomTopic(roomId: string, topic: string): Promise<{ event_id: string }>
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
- roomId: string
  
  The room to send to.
- topic: string
  
  The room topic.
Returns Promise<{ event_id: string }>

Inherited from Intent.setRoomTopic

setRoomUserProfile

setRoomUserProfile(roomId: string, profile: MatrixProfileInfo): Promise<void>
Parameters
- roomId: string
- profile: MatrixProfileInfo
Returns Promise<void>

Inherited from Intent.setRoomUserProfile

unban

unban(roomId: string, target: string): Promise<any>
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.

Returns
Resolved when unbanned, else rejected with an error.
Parameters
- roomId: string
  
  The room to unban the user from.
- target: string
  
  The target of the unban operation.
Returns Promise<any>

Inherited from Intent.unban

unstableSignalBridgeError

unstableSignalBridgeError(roomID: string, eventID: string, networkName: undefined | string, reason: BridgeErrorReason, affectedUsers: string[]): Promise<{ event_id: string }>
Signals that an error occured while handling an event by the bridge.

Warning: This function is unstable and is likely to change pending the outcome of https://github.com/matrix-org/matrix-doc/pull/2162.
Parameters
- roomID: string
  
  ID of the room in which the error occured.
- eventID: string
  
  ID of the event for which the error occured.
- networkName: undefined | string
  
  Name of the bridged network.
- reason: BridgeErrorReason
  
  The reason why the bridge error occured.
- affectedUsers: string[]
  
  Array of regex matching all affected users.
Returns Promise<{ event_id: string }>

Inherited from Intent.unstableSignalBridgeError

uploadContent

uploadContent(content: string | Buffer, opts?: FileUploadOpts): Promise<string>
Upload a file to the homeserver.

Returns
A MXC URL pointing to the uploaded data.
Parameters
- content: string | Buffer
  
  The file contents
- opts: FileUploadOpts = {}
  
  Additional options for the upload.
Returns Promise<string>

Overrides Intent.uploadContent

Class EncryptedIntent

Hierarchy

Index

Constructors

Properties

Accessors

Methods

Constructors

constructor

Parameters

botSdkIntent: Intent

botClient: MatrixClient

intentOpts: IntentOpts

encryptionOpts: EncryptedIntentOpts

Returns EncryptedIntent

Properties

Readonly botSdkIntent

Protected opts

Type declaration

backingStore: IntentBackingStore

caching: { size: number; ttl: number }

size: number

ttl: number

Optional dontCheckPowerLevel?: boolean

Optional dontJoin?: boolean

enablePresence: boolean

Optional getJsSdkClient?: (() => any)

Returns any

Optional onEventSent?: OnEventSentHook

Optional registered?: boolean

Accessors

matrixClient

Returns MatrixClient

userId

Returns string

Methods

Protected _ensureHasPowerLevelFor

Returns

Parameters

roomId: string

eventType: string

isState: boolean

Returns Promise<undefined | PowerLevelContent>

Protected _ensureJoined

Parameters

roomIdOrAlias: string

ignoreCache: boolean = false

Optional viaServers: string[]

passthroughError: boolean = false

Returns Promise<string>

Protected _joinGuard

Type Parameters

T

Parameters

roomId: string

promiseFn: (() => Promise<T>)

Returns Promise<T>

Returns Promise<T>

ban

Returns

Parameters

roomId: string

target: string

Optional reason: string

Returns Promise<any>

createAlias

Parameters

alias: string

roomId: string

Returns Promise<any>

createRoom

Parameters

opts: RoomCreationOpts

Returns Promise<{ room_id: string }>

createWidget

Returns

Parameters

roomId: string

widgetId: string

opts: WidgetOpts

`Readonly` botSdkIntent

`Protected` opts

`Optional` dontCheckPowerLevel?: boolean

`Optional` dontJoin?: boolean

`Optional` getJsSdkClient?: (() => any)

`Optional` onEventSent?: OnEventSentHook

`Optional` registered?: boolean

`Protected` _ensureHasPowerLevelFor

`Protected` _ensureJoined

`Optional` viaServers: string[]

`Protected` _joinGuard

`Optional` reason: string

`Optional` displayname: string

`Optional` avatarUrl: string

`Optional` viaServers: string[]

`Optional` reason: string

`Optional` reason: string