Class BackupManager

Manages the key backup.

Hierarchy

BackupManager

Constructors

constructor

new BackupManager(baseApis: MatrixClient, getKey: GetKey): BackupManager
Parameters
- baseApis: MatrixClient
- getKey: GetKey
Returns BackupManager
- Defined in src/crypto/backup.ts:122

Properties

`Private` algorithm

algorithm: undefined | BackupAlgorithm

backupInfo

backupInfo: undefined | IKeyBackupInfo

`Private` `Readonly` baseApis

baseApis: MatrixClient

checkedForBackup

checkedForBackup: boolean

`Readonly` getKey

getKey: GetKey

`Private` sendingBackups

sendingBackups: boolean

`Private` sessionLastCheckAttemptedTime

sessionLastCheckAttemptedTime: Record<string, number> = {}

Accessors

version

get version(): undefined | string
Returns undefined | string
- Defined in src/crypto/backup.ts:127

Methods

backupGroupSession

backupGroupSession(senderKey: string, sessionId: string): Promise<void>
Parameters
- senderKey: string
- sessionId: string
Returns Promise<void>
- Defined in src/crypto/backup.ts:535

backupPendingKeys

backupPendingKeys(limit: number): Promise<number>
Take some e2e keys waiting to be backed up and send them to the backup.

Returns
Number of sessions backed up
Parameters
- limit: number
  
  Maximum number of keys to back up
Returns Promise<number>
- Defined in src/crypto/backup.ts:489

checkAndStart

checkAndStart(): Promise<null | IKeyBackupCheck>
Check the server for an active key backup and if one is present and has a valid signature from one of the user's verified devices, start backing up to it.

Returns Promise<null | IKeyBackupCheck>
- Defined in src/crypto/backup.ts:222

checkKeyBackup

checkKeyBackup(): Promise<null | IKeyBackupCheck>
Forces a re-check of the key backup and enables/disables it as appropriate.

Returns
Object with backup info (as returned by getKeyBackupVersion) in backupInfo and trust information (as returned by isKeyBackupTrusted) in trustInfo.

Returns Promise<null | IKeyBackupCheck>
- Defined in src/crypto/backup.ts:285

countSessionsNeedingBackup

countSessionsNeedingBackup(): Promise<number>
Counts the number of end to end session keys that are waiting to be backed up

Returns
Promise which resolves to the number of sessions requiring backup

Returns Promise<number>
- Defined in src/crypto/backup.ts:591

createKeyBackupVersion

createKeyBackupVersion(info: IKeyBackupInfo): Promise<void>
Parameters
- info: IKeyBackupInfo
Returns Promise<void>
- Defined in src/crypto/backup.ts:212

disableKeyBackup

disableKeyBackup(): void
Disable backing up of keys.

Returns void
- Defined in src/crypto/backup.ts:175

enableKeyBackup

enableKeyBackup(info: IKeyBackupInfo): Promise<void>
Parameters
- info: IKeyBackupInfo
Returns Promise<void>
- Defined in src/crypto/backup.ts:157

flagAllGroupSessionsForBackup

flagAllGroupSessionsForBackup(): Promise<number>
Marks all group sessions as needing to be backed up without scheduling them to upload in the background.

Returns
Promise which resolves to the number of sessions now requiring a backup (which will be equal to the number of sessions in the store).

Returns Promise<number>
- Defined in src/crypto/backup.ts:569

getKeyBackupEnabled

getKeyBackupEnabled(): null | boolean
Returns null | boolean
- Defined in src/crypto/backup.ts:186

isKeyBackupTrusted

isKeyBackupTrusted(backupInfo?: IKeyBackupInfo): Promise<TrustInfo>
Check if the given backup info is trusted.
Parameters
- Optional backupInfo: IKeyBackupInfo
  
  key backup info dict from /room_keys/version
Returns Promise<TrustInfo>
- Defined in src/crypto/backup.ts:317

prepareKeyBackupVersion

prepareKeyBackupVersion(key?: null | string | Uint8Array, algorithm?: string): Promise<IPreparedKeyBackupVersion>
Parameters
- Optional key: null | string | Uint8Array
- Optional algorithm: string
Returns Promise<IPreparedKeyBackupVersion>
- Defined in src/crypto/backup.ts:193

queryKeyBackupRateLimited

queryKeyBackupRateLimited(targetRoomId: undefined | string, targetSessionId: undefined | string): Promise<void>
Attempts to retrieve a session from a key backup, if enough time has elapsed since the last check for this session id.
Parameters
- targetRoomId: undefined | string
- targetSessionId: undefined | string
Returns Promise<void>
- Defined in src/crypto/backup.ts:294

scheduleAllGroupSessionsForBackup

scheduleAllGroupSessionsForBackup(): Promise<void>
Marks all group sessions as needing to be backed up and schedules them to upload in the background as soon as possible.

Returns Promise<void>
- Defined in src/crypto/backup.ts:556

scheduleKeyBackupSend

scheduleKeyBackupSend(maxDelay?: number): Promise<void>
Schedules sending all keys waiting to be sent to the backup, if not already scheduled. Retries if necessary.
Parameters
- maxDelay: number = 10000
  
  Maximum delay to wait in ms. 0 means no delay.
Returns Promise<void>
- Defined in src/crypto/backup.ts:431

`Static` checkBackupVersion

checkBackupVersion(info: IKeyBackupInfo): void
Performs a quick check to ensure that the backup info looks sane.

Throws an error if a problem is detected.
Parameters
- info: IKeyBackupInfo
  
  the key backup info
Returns void
- Defined in src/crypto/backup.ts:138

`Static` makeAlgorithm

makeAlgorithm(info: IKeyBackupInfo, getKey: GetKey): Promise<BackupAlgorithm>
Parameters
- info: IKeyBackupInfo
- getKey: GetKey
Returns Promise<BackupAlgorithm>
- Defined in src/crypto/backup.ts:149

Generated using TypeDoc