matrix-js-sdk
Version:
Matrix Client-Server SDK for Javascript
99 lines • 3.85 kB
TypeScript
import { Room } from "./models/room";
import { IStoredClientOpts, MatrixClient } from "./client";
import { ISyncStateData, SyncState } from "./sync";
import { SlidingSync } from "./sliding-sync";
/**
* A copy of SyncApi such that it can be used as a drop-in replacement for sync v2. For the actual
* sliding sync API, see sliding-sync.ts or the class SlidingSync.
*/
export declare class SlidingSyncSdk {
private readonly slidingSync;
private readonly client;
private readonly opts;
private syncState;
private syncStateData;
private lastPos;
private failCount;
private notifEvents;
constructor(slidingSync: SlidingSync, client: MatrixClient, opts?: Partial<IStoredClientOpts>);
private onRoomData;
private onLifecycle;
/**
* Sync rooms the user has left.
* @return {Promise} Resolved when they've been added to the store.
*/
syncLeftRooms(): Promise<any[]>;
/**
* Peek into a room. This will result in the room in question being synced so it
* is accessible via getRooms(). Live updates for the room will be provided.
* @param {string} roomId The room ID to peek into.
* @return {Promise} A promise which resolves once the room has been added to the
* store.
*/
peek(_roomId: string): Promise<Room>;
/**
* Stop polling for updates in the peeked room. NOPs if there is no room being
* peeked.
*/
stopPeeking(): void;
/**
* Returns the current state of this sync object
* @see module:client~MatrixClient#event:"sync"
* @return {?String}
*/
getSyncState(): SyncState;
/**
* Returns the additional data object associated with
* the current sync state, or null if there is no
* such data.
* Sync errors, if available, are put in the 'error' key of
* this object.
* @return {?Object}
*/
getSyncStateData(): ISyncStateData;
private shouldAbortSync;
private processRoomData;
/**
* @param {Room} room
* @param {MatrixEvent[]} stateEventList A list of state events. This is the state
* at the *START* of the timeline list if it is supplied.
* @param {MatrixEvent[]} [timelineEventList] A list of timeline events. Lower index
* @param {boolean} fromCache whether the sync response came from cache
* is earlier in time. Higher index is later.
*/
private processRoomEvents;
private resolveInvites;
retryImmediately(): boolean;
/**
* Main entry point. Blocks until stop() is called.
*/
sync(): Promise<void>;
/**
* Stops the sync object from syncing.
*/
stop(): void;
/**
* Sets the sync state and emits an event to say so
* @param {String} newState The new state string
* @param {Object} data Object of additional data to emit in the event
*/
private updateSyncState;
/**
* Takes a list of timelineEvents and adds and adds to notifEvents
* as appropriate.
* This must be called after the room the events belong to has been stored.
*
* @param {MatrixEvent[]} [timelineEventList] A list of timeline events. Lower index
* is earlier in time. Higher index is later.
*/
private addNotifications;
/**
* Purge any events in the notifEvents array. Used after a /sync has been complete.
* This should not be called at a per-room scope (e.g in onRoomData) because otherwise the ordering
* will be messed up e.g room A gets a bing, room B gets a newer bing, but both in the same /sync
* response. If we purge at a per-room scope then we could process room B before room A leading to
* room B appearing earlier in the notifications timeline, even though it has the higher origin_server_ts.
*/
private purgeNotifications;
}
//# sourceMappingURL=sliding-sync-sdk.d.ts.map