Options
All
  • Public
  • Public/Protected
  • All
Menu

Hierarchy

  • Intent

Index

Constructors

constructor

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

    Parameters

    • client: any

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

    • botClient: any

      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.

    • Default value opts: IntentOpts = {}

      Options for this Intent instance.

    Returns Intent

Properties

Readonly client

client: any

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

Accessors

userId

  • get userId(): string

Methods

ban

  • ban(roomId: string, target: string, reason?: undefined | 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.

    Parameters

    • roomId: string

      The room to ban the user from.

    • target: string

      The target of the ban operation.

    • Optional reason: undefined | string

      Optional. The reason for the ban.

    Returns Promise<any>

    Resolved when banned, else rejected with an error.

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>

createRoom

ensureRegistered

  • ensureRegistered(forceRegister?: boolean): Promise<any>

getClient

  • getClient(): any

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.

    Parameters

    • roomId: string

      The room to fetch the event from.

    • eventId: string

      The eventId of the event to fetch.

    • Default value useCache: boolean = true

      Should the request attempt to lookup from the cache.

    Returns Promise<any>

    Resolves with the content of the event, or rejects if not found.

getProfileInfo

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

    Parameters

    • userId: string

      The ID of the user whose profile to return

    • Default value info: UserProfileKeys = null

      The profile field name to retrieve (e.g. 'displayname' or 'avatar_url'), or null to fetch the entire profile information.

    • Default value useCache: boolean = true

      Should the request attempt to lookup state from the cache.

    Returns Promise<any>

    A Promise that resolves with the requested user's profile information

getStateEvent

  • getStateEvent(roomId: string, eventType: string, stateKey?: string): 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.

    • Default value stateKey: string = ""

    Returns Promise<any>

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.

    Parameters

    • roomId: string

      The room to invite the user to.

    • target: string

      The user ID to invite.

    Returns Promise<any>

    Resolved when invited, else rejected with an error.

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>

kick

  • kick(roomId: string, target: string, reason?: undefined | 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.

    Parameters

    • roomId: string

      The room to kick the user from.

    • target: string

      The target of the kick operation.

    • Optional reason: undefined | string

      Optional. The reason for the kick.

    Returns Promise<any>

    Resolved when kickked, else rejected with an error.

leave

  • leave(roomId: string, reason?: undefined | 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: undefined | string

      An optional string to explain why the user left the room.

    Returns Promise<any>

onEvent

  • onEvent(event: { content: { avatar_url?: undefined | string; displayname?: undefined | string; membership: UserMembership }; room_id: string; state_key: unknown; type: string }): 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: { content: { avatar_url?: undefined | string; displayname?: undefined | string; membership: UserMembership }; room_id: string; state_key: unknown; type: string }

      The incoming event JSON

      • content: { avatar_url?: undefined | string; displayname?: undefined | string; membership: UserMembership }
        • Optional avatar_url?: undefined | string
        • Optional displayname?: undefined | string
        • membership: UserMembership
      • room_id: string
      • state_key: unknown
      • type: string

    Returns void

roomState

  • roomState(roomId: string, useCache?: boolean): Promise<any>
  • 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.

    • Default value useCache: boolean = false

      Should the request attempt to lookup state from the cache.

    Returns Promise<any>

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 }>

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.

    Parameters

    • roomId: string

      The room to send to.

    • content: Record<string, unknown>

      The event content

    Returns Promise<{ event_id: string }>

sendReadReceipt

  • sendReadReceipt(roomId: string, eventId: string): Promise<any>
  • 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<any>

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.

    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 }>

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.

    Parameters

    • roomId: string

      The room to send to.

    • text: string

      The text string to send.

    Returns Promise<{ event_id: string }>

sendTyping

  • sendTyping(roomId: string, isTyping: boolean): Promise<any>
  • 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<any>

setAvatarUrl

  • setAvatarUrl(url: string): Promise<any>

setDisplayName

  • setDisplayName(name: string): Promise<any>

setPowerLevel

  • setPowerLevel(roomId: string, target: string, level: number | undefined): Promise<any>
  • 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: number | undefined

      The desired level. Undefined will remove the users custom power level.

    Returns Promise<any>

setPresence

  • setPresence(presence: string, status_msg?: undefined | string): Promise<any>
  • Set the presence of this user.

    Parameters

    • presence: string

      One of "online", "offline" or "unavailable".

    • Optional status_msg: undefined | string

      The status message to attach.

    Returns Promise<any>

    Resolves if the presence was set or no-oped, rejects otherwise.

setRoomAvatar

  • setRoomAvatar(roomId: string, avatar: string, info?: undefined | 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: undefined | string

      Extra information about the image. See m.room.avatar for details.

    Returns Promise<{ event_id: string }>

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>

setRoomDirectoryVisibilityAppService

  • setRoomDirectoryVisibilityAppService(roomId: string, networkId: string, visibility: "public" | "private"): Promise<any>
  • 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<any>

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.

    Parameters

    • roomId: string

      The room to send to.

    • name: string

      The room name.

    Returns Promise<{ event_id: string }>

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 }>

setRoomUserProfile

  • setRoomUserProfile(roomId: string, profile: UserProfile): Promise<void>

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.

    Parameters

    • roomId: string

      The room to unban the user from.

    • target: string

      The target of the unban operation.

    Returns Promise<any>

    Resolved when unbanned, else rejected with an error.

unstableSignalBridgeError

  • unstableSignalBridgeError(roomID: string, eventID: string, networkName: string | undefined, 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: string | undefined

      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 }>

uploadContent

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

    Parameters

    • content: Buffer | string | ReadStream

      The file contents

    • Default value opts: FileUploadOpts = {}

      Additional options for the upload.

    Returns Promise<string>

    A MXC URL pointing to the uploaded data.

Generated using TypeDoc