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

Hierarchy (view full)

Constructors

Properties

botSdkIntent: Intent

The bot sdk intent which this intent wraps fulfilled e.g. the entity joining the room when you call intent.join(roomId).

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

Methods

  • Ensures that the client has the required power level to post the event type.

    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>

    If found, the power level event

  • Parameters

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

    Returns Promise<string>

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

      Optional. The reason for the ban.

    Returns Promise<any>

    Resolved when banned, else rejected with an error.

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

    Parameters

    • roomId: string

      The room to create the widget in.

    • widgetId: string

      The widget ID

    • opts: WidgetOpts

      Options for the widget.

    Returns Promise<string>

    An eventID if the event was created.

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

  • Create a widget in a room, if one doesn't already exist

    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>

    An eventID if the event was created, otherwise null.

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

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

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

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

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

    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.

  • Check if a room is encrypted. If it is, return the algorithm.

    Parameters

    • roomId: string

      The room ID to be checked

    Returns Promise<boolean>

    The encryption algorithm or false

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

    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>

    Resolved when kickked, else rejected with an error.

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

    Parameters

    • roomAliasOrId: string

      A roomId or alias to resolve.

    Returns Promise<string>

    Throws

    If the provided string was incorrectly formatted or alias does not exist.

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

    Parameters

    • roomId: string

      The room to send to.

    • content: Record<string, unknown>

      The event content

    Returns Promise<{
        event_id: string;
    }>

    The eventId of the sent message

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

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

    The event ID wrapped inside an object (for legacy reasons)

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

    The Matrix event ID.

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

    Parameters

    • presence: PresenceState

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

    • Optional statusMsg: string

    Returns Promise<any>

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

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

    Parameters

    • roomId: string

      The room to send to.

    • name: string

      The room name.

    Returns Promise<{
        event_id: string;
    }>

    The Matrix event ID.

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

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

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

Generated using TypeDoc