import { type EventType } from "../@types/event.ts"; import { type Room } from "../models/room.ts"; import { type User } from "../models/user.ts"; import { type IEvent, type MatrixEvent } from "../models/event.ts"; import { type Filter } from "../filter.ts"; import { type RoomSummary } from "../models/room-summary.ts"; import { type IMinimalEvent, type IRooms, type ISyncResponse } from "../sync-accumulator.ts"; import { type IStartClientOpts } from "../client.ts"; import { type IStateEventWithRoomId } from "../@types/search.ts"; import { type IndexedToDeviceBatch, type ToDeviceBatchWithTxnId } from "../models/ToDeviceMessage.ts"; import { type EventEmitterEvents } from "../models/typed-event-emitter.ts"; export interface ISavedSync { nextBatch: string; roomsData: IRooms; accountData: IMinimalEvent[]; } export type UserCreator = (userId: string) => User; /** * A store for most of the data js-sdk needs to store, apart from crypto data */ export interface IStore { readonly accountData: Map; on?: (event: EventEmitterEvents | "degraded" | "closed", handler: (...args: any[]) => void) => void; /** @returns whether or not the database was newly created in this session. */ isNewlyCreated(): Promise; /** * Get the sync token. */ getSyncToken(): string | null; /** * Set the sync token. */ setSyncToken(token: string): void; /** * Store the given room. * @param room - The room to be stored. All properties must be stored. */ storeRoom(room: Room): void; /** * Set the user creator which is used for creating User objects * @param creator - A callback that accepts an user-id and returns an User object */ setUserCreator(creator: UserCreator): void; /** * Retrieve a room by its' room ID. * @param roomId - The room ID. * @returns The room or null. */ getRoom(roomId: string): Room | null; /** * Retrieve all known rooms. * @returns A list of rooms, which may be empty. */ getRooms(): Room[]; /** * Permanently delete a room. */ removeRoom(roomId: string): void; /** * Retrieve a summary of all the rooms. * @returns A summary of each room. */ getRoomSummaries(): RoomSummary[]; /** * Store a User. * @param user - The user to store. */ storeUser(user: User): void; /** * Retrieve a User by its' user ID. * @param userId - The user ID. * @returns The user or null. */ getUser(userId: string): User | null; /** * Retrieve all known users. * @returns A list of users, which may be empty. */ getUsers(): User[]; /** * Retrieve scrollback for this room. * @param room - The matrix room * @param limit - The max number of old events to retrieve. * @returns An array of objects which will be at most 'limit' * length and at least 0. The objects are the raw event JSON. */ scrollback(room: Room, limit: number): MatrixEvent[]; /** * Store events for a room. * @param room - The room to store events for. * @param events - The events to store. * @param token - The token associated with these events. * @param toStart - True if these are paginated results. */ storeEvents(room: Room, events: MatrixEvent[], token: string | null, toStart: boolean): void; /** * Store a filter. */ storeFilter(filter: Filter): void; /** * Retrieve a filter. * @returns A filter or null. */ getFilter(userId: string, filterId: string): Filter | null; /** * Retrieve a filter ID with the given name. * @param filterName - The filter name. * @returns The filter ID or null. */ getFilterIdByName(filterName: string): string | null; /** * Set a filter name to ID mapping. */ setFilterIdByName(filterName: string, filterId?: string): void; /** * Store user-scoped account data events * @param events - The events to store. */ storeAccountDataEvents(events: MatrixEvent[]): void; /** * Get account data event by event type * @param eventType - The event type being queried */ getAccountData(eventType: EventType | string): MatrixEvent | undefined; /** * setSyncData does nothing as there is no backing data store. * * @param syncData - The sync data * @returns An immediately resolved promise. */ setSyncData(syncData: ISyncResponse): Promise; /** * We never want to save because we have nothing to save to. * * @returns If the store wants to save */ wantsSave(): boolean; /** * Save does nothing as there is no backing data store. */ save(force?: boolean): Promise; /** * Startup does nothing. * @returns An immediately resolved promise. */ startup(): Promise; /** * @returns Promise which resolves with a sync response to restore the * client state to where it was at the last save, or null if there * is no saved sync data. */ getSavedSync(): Promise; /** * @returns If there is a saved sync, the nextBatch token * for this sync, otherwise null. */ getSavedSyncToken(): Promise; /** * Delete all data from this store. Does nothing since this store * doesn't store anything. * @returns An immediately resolved promise. */ deleteAllData(): Promise; /** * Returns the out-of-band membership events for this room that * were previously loaded. * @returns the events, potentially an empty array if OOB loading didn't yield any new members * @returns in case the members for this room haven't been stored yet */ getOutOfBandMembers(roomId: string): Promise; /** * Stores the out-of-band membership events for this room. Note that * it still makes sense to store an empty array as the OOB status for the room is * marked as fetched, and getOutOfBandMembers will return an empty array instead of null * @param membershipEvents - the membership events to store * @returns when all members have been stored */ setOutOfBandMembers(roomId: string, membershipEvents: IStateEventWithRoomId[]): Promise; clearOutOfBandMembers(roomId: string): Promise; getClientOptions(): Promise; storeClientOptions(options: IStartClientOpts): Promise; getPendingEvents(roomId: string): Promise[]>; setPendingEvents(roomId: string, events: Partial[]): Promise; /** * Stores batches of outgoing to-device messages */ saveToDeviceBatches(batch: ToDeviceBatchWithTxnId[]): Promise; /** * Fetches the oldest batch of to-device messages in the queue */ getOldestToDeviceBatch(): Promise; /** * Removes a specific batch of to-device messages from the queue */ removeToDeviceBatch(id: number): Promise; /** * Stop the store and perform any appropriate cleanup */ destroy(): Promise; } //# sourceMappingURL=index.d.ts.map