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

Hierarchy

Constructors

Properties

botSdkIntent: Intent
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

  • get matrixClient(): MatrixClient
  • Returns MatrixClient

  • get userId(): string
  • Returns string

Methods

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

  • Parameters

    • roomIdOrAlias: string
    • ignoreCache: boolean = false
    • Optional viaServers: string[]
    • passthroughError: boolean = false

    Returns Promise<string>

  • Type Parameters

    • T

    Parameters

    • roomId: string
    • promiseFn: (() => Promise<T>)
        • (): Promise<T>
        • Returns Promise<T>

    Returns Promise<T>

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

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

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

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

  • Parameters

    • forceRegister: boolean = false

    Returns Promise<undefined | "registered=true">

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

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

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

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

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

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

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

  • 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

    Returns void

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

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

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

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

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

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

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

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

  • Set the user's avatar URL

    Parameters

    • url: string

      The new avatar URL

    Returns Promise<any>

  • Set the user's display name

    Parameters

    • name: string

      The new display name

    Returns 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: undefined | number

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

    Returns Promise<void>

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

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

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

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

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

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

  • Parameters

    • roomId: string
    • profile: MatrixProfileInfo

    Returns Promise<void>

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

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

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

Generated using TypeDoc