@towns-labs/sdk 2.0.1

package/dist/observable/observableRecord.js

@@ -0,0 +1,71 @@
+import { Observable } from './observable';
+/// ObservableRecord is a class that implements an observable record.
+/// the Record part is like a normal record
+/// this class has a makeDefault function that provides the default value for a key
+/// default values don't get added to the record, but they are cached
+/// We're using WeakRef to store default values, allowing them to be garbage collected when unused
+/// if the default value contains the streamId, you can pass makeDefault as a function
+/// otherwise you can pass a static default value
+/// in typscript it's assumed that all keys of Records have a value, even though that's obviously false
+/// this class actually does always have a default value if you call get(...)
+/// `makeDefault` is especially useful when you want consistent, per-key objects that can also be modified and stored back via `set(...)`.
+export class ObservableRecord extends Observable {
+    // weak reference cache of default values
+    defaultSource;
+    defaultValues = new Map();
+    constructor(params) {
+        super(params.initialValue ?? {});
+        this.defaultSource =
+            'makeDefault' in params
+                ? { makeDefault: params.makeDefault }
+                : { defaultValue: params.defaultValue };
+    }
+    // For testing
+    _cleanupNow() {
+        for (const key of this.defaultValues.keys()) {
+            if (this.defaultValues.get(key)?.deref() === undefined) {
+                this.defaultValues.delete(key);
+            }
+        }
+    }
+    // every 100ish calls to makeDefault, we check if any default values are no longer needed
+    // and remove them from the cache
+    maybeCleanup() {
+        if (Math.random() < 0.01) {
+            this._cleanupNow();
+        }
+    }
+    // Return stable default values to avoid unnecessary React re-renders.
+    // But allow GC to clean them up when unused.
+    makeDefault(key) {
+        // store default values in a weak reference cache
+        // we want to return consistant values so that react components don't re-render
+        // but once the value is no longer needed, we want to garbage collect it
+        if ('defaultValue' in this.defaultSource) {
+            return this.defaultSource.defaultValue;
+        }
+        else {
+            let defaultVal = this.defaultValues.get(key)?.deref();
+            if (!defaultVal) {
+                this.maybeCleanup();
+                defaultVal = this.defaultSource.makeDefault(key);
+                this.defaultValues.set(key, new WeakRef(defaultVal));
+            }
+            return defaultVal;
+        }
+    }
+    // return the value in the record or a default value for that key
+    // the default value will be weakly cached so repeated calls will return the
+    // same value as long as the value is not garbage collected
+    get(key) {
+        return this.value[key] ?? this.makeDefault(key);
+    }
+    // set a value for a specific key
+    setValueFor(key, value) {
+        this.set((prev) => ({
+            ...prev,
+            [key]: value,
+        }));
+    }
+}
+//# sourceMappingURL=observableRecord.js.map

package/dist/observable/observableRecord.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"observableRecord.js","sourceRoot":"","sources":["../../src/observable/observableRecord.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AAEzC,qEAAqE;AACrE,2CAA2C;AAC3C,mFAAmF;AACnF,qEAAqE;AACrE,kGAAkG;AAClG,sFAAsF;AACtF,iDAAiD;AACjD,uGAAuG;AACvG,6EAA6E;AAC7E,0IAA0I;AAC1I,MAAM,OAAO,gBAGX,SAAQ,UAA0C;IAChD,yCAAyC;IACjC,aAAa,CAAgE;IAC7E,aAAa,GAAG,IAAI,GAAG,EAAuB,CAAA;IAEtD,YACI,MAEgE;QAEhE,KAAK,CAAC,MAAM,CAAC,YAAY,IAAK,EAAyB,CAAC,CAAA;QACxD,IAAI,CAAC,aAAa;YACd,aAAa,IAAI,MAAM;gBACnB,CAAC,CAAC,EAAE,WAAW,EAAE,MAAM,CAAC,WAAW,EAAE;gBACrC,CAAC,CAAC,EAAE,YAAY,EAAE,MAAM,CAAC,YAAY,EAAE,CAAA;IACnD,CAAC;IAED,cAAc;IACd,WAAW;QACP,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,aAAa,CAAC,IAAI,EAAE,EAAE,CAAC;YAC1C,IAAI,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE,KAAK,SAAS,EAAE,CAAC;gBACrD,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;YAClC,CAAC;QACL,CAAC;IACL,CAAC;IACD,yFAAyF;IACzF,iCAAiC;IACzB,YAAY;QAChB,IAAI,IAAI,CAAC,MAAM,EAAE,GAAG,IAAI,EAAE,CAAC;YACvB,IAAI,CAAC,WAAW,EAAE,CAAA;QACtB,CAAC;IACL,CAAC;IAED,sEAAsE;IACtE,6CAA6C;IAC7C,WAAW,CAAC,GAAQ;QAChB,iDAAiD;QACjD,+EAA+E;QAC/E,wEAAwE;QACxE,IAAI,cAAc,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;YACvC,OAAO,IAAI,CAAC,aAAa,CAAC,YAAY,CAAA;QAC1C,CAAC;aAAM,CAAC;YACJ,IAAI,UAAU,GAAG,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE,CAAA;YACrD,IAAI,CAAC,UAAU,EAAE,CAAC;gBACd,IAAI,CAAC,YAAY,EAAE,CAAA;gBACnB,UAAU,GAAG,IAAI,CAAC,aAAa,CAAC,WAAW,CAAC,GAAG,CAAC,CAAA;gBAChD,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,OAAO,CAAC,UAAU,CAAC,CAAC,CAAA;YACxD,CAAC;YACD,OAAO,UAAU,CAAA;QACrB,CAAC;IACL,CAAC;IAED,iEAAiE;IACjE,4EAA4E;IAC5E,2DAA2D;IAC3D,GAAG,CAAC,GAAQ;QACR,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAA;IACnD,CAAC;IAED,iCAAiC;IACjC,WAAW,CAAC,GAAQ,EAAE,KAAY;QAC9B,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;YAChB,GAAG,IAAI;YACP,CAAC,GAAG,CAAC,EAAE,KAAK;SACf,CAAC,CAAC,CAAA;IACP,CAAC;CACJ"}

package/dist/observable/persistedObservable.d.ts

@@ -0,0 +1,39 @@
+import { Observable } from './observable';
+import { LoadPriority, Store, Identifiable } from '../store/store';
+export interface PersistedOpts {
+    tableName: string;
+}
+export type PersistedModel<T> = {
+    status: 'loading';
+    data: T;
+} | {
+    status: 'loaded';
+    data: T;
+} | {
+    status: 'error';
+    data: T;
+    error: Error;
+};
+interface Storable {
+}
+export declare function persistedObservable(options: PersistedOpts): <T extends {
+    new (...args: any[]): Storable;
+}>(constructor: T) => {
+    new (...args: any[]): {};
+    tableName: string;
+} & T;
+export declare class PersistedObservable<T extends Identifiable> extends Observable<PersistedModel<T>> implements Storable {
+    protected tableName: string;
+    protected readonly store: Store;
+    protected readonly loadPriority: LoadPriority;
+    constructor(initialValue: T, store: Store, loadPriority?: LoadPriority);
+    protected load(): void;
+    get value(): PersistedModel<T>;
+    setValue(_newValue: PersistedModel<T>): boolean;
+    get data(): T;
+    setData(newDataPartial: Partial<T>): void;
+    protected onLoaded(): void;
+    protected onSaved(): void;
+}
+export {};
+//# sourceMappingURL=persistedObservable.d.ts.map

package/dist/observable/persistedObservable.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"persistedObservable.d.ts","sourceRoot":"","sources":["../../src/observable/persistedObservable.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AACzC,OAAO,EAAE,YAAY,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAGlE,MAAM,WAAW,aAAa;IAC1B,SAAS,EAAE,MAAM,CAAA;CACpB;AAED,MAAM,MAAM,cAAc,CAAC,CAAC,IACtB;IAAE,MAAM,EAAE,SAAS,CAAC;IAAC,IAAI,EAAE,CAAC,CAAA;CAAE,GAC9B;IAAE,MAAM,EAAE,QAAQ,CAAC;IAAC,IAAI,EAAE,CAAC,CAAA;CAAE,GAC7B;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,CAAC,CAAC;IAAC,KAAK,EAAE,KAAK,CAAA;CAAE,CAAA;AAGhD,UAAU,QAAQ;CAAG;AAKrB,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,aAAa,IAGrC,CAAC,SAAS;IAAE,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,QAAQ,CAAA;CAAE,EAAE,aAAa,CAAC;kBAEhD,GAAG,EAAE;;MAcrC;AAED,qBAAa,mBAAmB,CAAC,CAAC,SAAS,YAAY,CACnD,SAAQ,UAAU,CAAC,cAAc,CAAC,CAAC,CAAC,CACpC,YAAW,QAAQ;IAEnB,SAAS,CAAC,SAAS,EAAE,MAAM,CAAK;IAChC,SAAS,CAAC,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAA;IAC/B,SAAS,CAAC,QAAQ,CAAC,YAAY,EAAE,YAAY,CAAA;gBAGjC,YAAY,EAAE,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,YAAY,GAAE,YAA+B;IAMxF,SAAS,CAAC,IAAI;IAkBd,IAAa,KAAK,IAAI,cAAc,CAAC,CAAC,CAAC,CAEtC;IAEQ,QAAQ,CAAC,SAAS,EAAE,cAAc,CAAC,CAAC,CAAC,GAAG,OAAO;IAIxD,IAAI,IAAI,IAAI,CAAC,CAEZ;IAGD,OAAO,CAAC,cAAc,EAAE,OAAO,CAAC,CAAC,CAAC;IAqBlC,SAAS,CAAC,QAAQ;IAIlB,SAAS,CAAC,OAAO;CAGpB"}

package/dist/observable/persistedObservable.js

@@ -0,0 +1,77 @@
+import { check } from '@towns-labs/utils';
+import { Observable } from './observable';
+import { LoadPriority } from '../store/store';
+import { isDefined } from '../check';
+const all_tables = new Set();
+/// decorator
+export function persistedObservable(options) {
+    check(!all_tables.has(options.tableName), `duplicate table name: ${options.tableName}`);
+    all_tables.add(options.tableName);
+    return function (constructor) {
+        return class extends constructor {
+            constructor(...args) {
+                // eslint-disable-next-line @typescript-eslint/no-unsafe-argument
+                super(...args);
+                this.tableName = options.tableName;
+                this.store.withTransaction(`new-${options.tableName}`, () => {
+                    // eslint-disable-next-line @typescript-eslint/no-unsafe-call, @typescript-eslint/no-unsafe-member-access
+                    ;
+                    this.load();
+                });
+            }
+            static tableName = options.tableName;
+        };
+    };
+}
+export class PersistedObservable extends Observable {
+    tableName = '';
+    store;
+    loadPriority;
+    // must be called in a store transaction
+    constructor(initialValue, store, loadPriority = LoadPriority.low) {
+        super({ status: 'loading', data: initialValue });
+        this.loadPriority = loadPriority;
+        this.store = store;
+    }
+    load() {
+        check(super.value.status === 'loading', 'already loaded');
+        this.store.load(this.tableName, this.data.id, this.loadPriority, (data) => {
+            super.setValue({ status: 'loaded', data: data ?? this.data });
+        }, (error) => {
+            super.setValue({ status: 'error', data: this.data, error });
+        }, () => {
+            this.onLoaded();
+        });
+    }
+    get value() {
+        return super.value;
+    }
+    setValue(_newValue) {
+        throw new Error('use updateData instead of set value');
+    }
+    get data() {
+        return super.value.data;
+    }
+    // must be called in a store transaction
+    setData(newDataPartial) {
+        check(isDefined(newDataPartial), 'value is undefined');
+        const prevData = this.data;
+        const newData = { ...this.data, ...newDataPartial };
+        check(newData.id === this.data.id, 'id mismatch');
+        super.setValue({ status: 'loaded', data: newData });
+        this.store.withTransaction(`update-${this.tableName}:${this.data.id}`, () => {
+            this.store.save(this.tableName, newData, () => { }, (e) => {
+                super.setValue({ status: 'error', data: prevData, error: e });
+            }, () => {
+                this.onSaved();
+            });
+        });
+    }
+    onLoaded() {
+        // abstract
+    }
+    onSaved() {
+        // abstract
+    }
+}
+//# sourceMappingURL=persistedObservable.js.map

package/dist/observable/persistedObservable.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"persistedObservable.js","sourceRoot":"","sources":["../../src/observable/persistedObservable.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAA;AACzC,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AACzC,OAAO,EAAE,YAAY,EAAuB,MAAM,gBAAgB,CAAA;AAClE,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAA;AAcpC,MAAM,UAAU,GAAG,IAAI,GAAG,EAAU,CAAA;AAEpC,aAAa;AACb,MAAM,UAAU,mBAAmB,CAAC,OAAsB;IACtD,KAAK,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,yBAAyB,OAAO,CAAC,SAAS,EAAE,CAAC,CAAA;IACvF,UAAU,CAAC,GAAG,CAAC,OAAO,CAAC,SAAS,CAAC,CAAA;IACjC,OAAO,UAAwD,WAAc;QACzE,OAAO,KAAM,SAAQ,WAAW;YAC5B,YAAY,GAAG,IAAW;gBACtB,iEAAiE;gBACjE,KAAK,CAAC,GAAG,IAAI,CAAC,CAEb;gBAAC,IAAY,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,CAE3C;gBAAE,IAAY,CAAC,KAAe,CAAC,eAAe,CAAC,OAAO,OAAO,CAAC,SAAS,EAAE,EAAE,GAAG,EAAE;oBAC7E,yGAAyG;oBACzG,CAAC;oBAAC,IAAY,CAAC,IAAI,EAAE,CAAA;gBACzB,CAAC,CAAC,CAAA;YACN,CAAC;YACD,MAAM,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,CAAA;SACvC,CAAA;IACL,CAAC,CAAA;AACL,CAAC;AAED,MAAM,OAAO,mBACT,SAAQ,UAA6B;IAG3B,SAAS,GAAW,EAAE,CAAA;IACb,KAAK,CAAO;IACZ,YAAY,CAAc;IAE7C,wCAAwC;IACxC,YAAY,YAAe,EAAE,KAAY,EAAE,eAA6B,YAAY,CAAC,GAAG;QACpF,KAAK,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC,CAAA;QAChD,IAAI,CAAC,YAAY,GAAG,YAAY,CAAA;QAChC,IAAI,CAAC,KAAK,GAAG,KAAK,CAAA;IACtB,CAAC;IAES,IAAI;QACV,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,KAAK,SAAS,EAAE,gBAAgB,CAAC,CAAA;QACzD,IAAI,CAAC,KAAK,CAAC,IAAI,CACX,IAAI,CAAC,SAAS,EACd,IAAI,CAAC,IAAI,CAAC,EAAE,EACZ,IAAI,CAAC,YAAY,EACjB,CAAC,IAAQ,EAAE,EAAE;YACT,KAAK,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC,CAAA;QACjE,CAAC,EACD,CAAC,KAAY,EAAE,EAAE;YACb,KAAK,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,CAAA;QAC/D,CAAC,EACD,GAAG,EAAE;YACD,IAAI,CAAC,QAAQ,EAAE,CAAA;QACnB,CAAC,CACJ,CAAA;IACL,CAAC;IAED,IAAa,KAAK;QACd,OAAO,KAAK,CAAC,KAAK,CAAA;IACtB,CAAC;IAEQ,QAAQ,CAAC,SAA4B;QAC1C,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAA;IAC1D,CAAC;IAED,IAAI,IAAI;QACJ,OAAO,KAAK,CAAC,KAAK,CAAC,IAAI,CAAA;IAC3B,CAAC;IAED,wCAAwC;IACxC,OAAO,CAAC,cAA0B;QAC9B,KAAK,CAAC,SAAS,CAAC,cAAc,CAAC,EAAE,oBAAoB,CAAC,CAAA;QACtD,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAA;QAC1B,MAAM,OAAO,GAAG,EAAE,GAAG,IAAI,CAAC,IAAI,EAAE,GAAG,cAAc,EAAE,CAAA;QACnD,KAAK,CAAC,OAAO,CAAC,EAAE,KAAK,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,aAAa,CAAC,CAAA;QACjD,KAAK,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAA;QACnD,IAAI,CAAC,KAAK,CAAC,eAAe,CAAC,UAAU,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,GAAG,EAAE;YACxE,IAAI,CAAC,KAAK,CAAC,IAAI,CACX,IAAI,CAAC,SAAS,EACd,OAAO,EACP,GAAG,EAAE,GAAE,CAAC,EACR,CAAC,CAAC,EAAE,EAAE;gBACF,KAAK,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAA;YACjE,CAAC,EACD,GAAG,EAAE;gBACD,IAAI,CAAC,OAAO,EAAE,CAAA;YAClB,CAAC,CACJ,CAAA;QACL,CAAC,CAAC,CAAA;IACN,CAAC;IAES,QAAQ;QACd,WAAW;IACf,CAAC;IAES,OAAO;QACb,WAAW;IACf,CAAC;CACJ"}

package/dist/observable/utils.d.ts

@@ -0,0 +1,2 @@
+export declare function sortedArraysEqual(a: string[], b: string[]): boolean;
+//# sourceMappingURL=utils.d.ts.map

package/dist/observable/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/observable/utils.ts"],"names":[],"mappings":"AAAA,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,MAAM,EAAE,GAAG,OAAO,CAUnE"}

package/dist/observable/utils.js

@@ -0,0 +1,12 @@
+export function sortedArraysEqual(a, b) {
+    if (a.length !== b.length) {
+        return false;
+    }
+    for (let i = 0; i < a.length; i++) {
+        if (a[i] !== b[i]) {
+            return false;
+        }
+    }
+    return true;
+}
+//# sourceMappingURL=utils.js.map

package/dist/observable/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../src/observable/utils.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,iBAAiB,CAAC,CAAW,EAAE,CAAW;IACtD,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,MAAM,EAAE,CAAC;QACxB,OAAO,KAAK,CAAA;IAChB,CAAC;IACD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAChC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YAChB,OAAO,KAAK,CAAA;QAChB,CAAC;IACL,CAAC;IACD,OAAO,IAAI,CAAA;AACf,CAAC"}

package/dist/persistenceStore.d.ts

@@ -0,0 +1,112 @@
+import { PersistedSyncedStream, Snapshot } from '@towns-labs/proto';
+import Dexie, { Table } from 'dexie';
+import { ParsedMiniblock } from './types';
+import { ParsedPersistedSyncedStream } from './streamUtils';
+export interface LoadedStream {
+    persistedSyncedStream: ParsedPersistedSyncedStream;
+    miniblocks: ParsedMiniblock[];
+    cleartexts: Record<string, Uint8Array | string> | undefined;
+    snapshot: Snapshot;
+    prependedMiniblocks: ParsedMiniblock[];
+    prevSnapshotMiniblockNum: bigint;
+}
+export interface IPersistenceStore {
+    setHighPriorityStreams(streamIds: string[]): void;
+    saveCleartext(eventId: string, cleartext: Uint8Array | string): Promise<void>;
+    getCleartext(eventId: string): Promise<Uint8Array | string | undefined>;
+    getCleartexts(eventIds: string[]): Promise<Record<string, Uint8Array | string> | undefined>;
+    getSyncedStream(streamId: string): Promise<ParsedPersistedSyncedStream | undefined>;
+    saveSyncedStream(streamId: string, syncedStream: PersistedSyncedStream): Promise<void>;
+    loadStream(streamId: string, inPersistedSyncedStream?: ParsedPersistedSyncedStream): Promise<LoadedStream | undefined>;
+    loadStreams(streamIds: string[]): Promise<{
+        streams: Record<string, LoadedStream | undefined>;
+        lastAccessedAt: Record<string, number>;
+    }>;
+    saveMiniblock(streamId: string, miniblock: ParsedMiniblock): Promise<void>;
+    saveMiniblocks(streamId: string, miniblocks: ParsedMiniblock[], direction: 'forward' | 'backward'): Promise<void>;
+    getMiniblock(streamId: string, miniblockNum: bigint): Promise<ParsedMiniblock | undefined>;
+    getMiniblocks(streamId: string, rangeStart: bigint, randeEnd: bigint): Promise<ParsedMiniblock[]>;
+    saveSnapshot(streamId: string, miniblockNum: bigint, snapshot: Snapshot): Promise<void>;
+}
+type ScratchData = {
+    lastAccessedAt: {
+        [streamId: string]: number;
+    };
+};
+export declare class PersistenceStore extends Dexie implements IPersistenceStore {
+    cleartexts: Table<{
+        cleartext: Uint8Array | string;
+        eventId: string;
+    }>;
+    syncedStreams: Table<{
+        streamId: string;
+        data: Uint8Array;
+    }>;
+    miniblocks: Table<{
+        streamId: string;
+        miniblockNum: string;
+        data: Uint8Array;
+    }>;
+    snapshots: Table<{
+        streamId: string;
+        data: {
+            miniblockNum: bigint;
+            snapshot: Uint8Array;
+        };
+    }>;
+    scratch: Table<{
+        id: string;
+        data: ScratchData;
+    }>;
+    private scratchQueue;
+    private scratchTimerId;
+    constructor(databaseName: string);
+    setHighPriorityStreams(streamIds: string[]): void;
+    processScratchQueue(): Promise<void>;
+    saveCleartext(eventId: string, cleartext: Uint8Array | string): Promise<void>;
+    getCleartext(eventId: string): Promise<string | Uint8Array<ArrayBufferLike> | undefined>;
+    getCleartexts(eventIds: string[]): Promise<Record<string, string | Uint8Array<ArrayBufferLike>> | undefined>;
+    getSyncedStream(streamId: string): Promise<ParsedPersistedSyncedStream | undefined>;
+    loadStream(streamId: string, inPersistedSyncedStream?: ParsedPersistedSyncedStream): Promise<LoadedStream | undefined>;
+    loadStreams(streamIds: string[]): Promise<{
+        streams: Record<string, LoadedStream | undefined>;
+        lastAccessedAt: {
+            [streamId: string]: number;
+        };
+    }>;
+    private getSyncedStreams;
+    saveSyncedStream(streamId: string, syncedStream: PersistedSyncedStream): Promise<void>;
+    saveMiniblock(streamId: string, miniblock: ParsedMiniblock): Promise<void>;
+    saveMiniblocks(streamId: string, miniblocks: ParsedMiniblock[], direction: 'forward' | 'backward'): Promise<void>;
+    getMiniblock(streamId: string, miniblockNum: bigint): Promise<ParsedMiniblock | undefined>;
+    getMiniblocks(streamId: string, rangeStart: bigint, rangeEnd: bigint): Promise<ParsedMiniblock[]>;
+    saveSnapshot(streamId: string, miniblockNum: bigint, snapshot: Snapshot): Promise<void>;
+    getSnapshot(streamId: string): Promise<{
+        snapshot: Snapshot;
+        miniblockNum: bigint;
+    } | undefined>;
+    private requestPersistentStorage;
+    private checkPersistenceStats;
+    private cachedScrollback;
+}
+export declare function eventIdsFromSnapshot(snapshot: Snapshot): string[];
+export declare class StubPersistenceStore implements IPersistenceStore {
+    setHighPriorityStreams(streamIds: string[]): void;
+    saveCleartext(eventId: string, cleartext: Uint8Array): Promise<void>;
+    getCleartext(eventId: string): Promise<undefined>;
+    getCleartexts(eventIds: string[]): Promise<undefined>;
+    getSyncedStream(streamId: string): Promise<undefined>;
+    loadStream(streamId: string, inPersistedSyncedStream?: ParsedPersistedSyncedStream): Promise<undefined>;
+    loadStreams(streamIds: string[]): Promise<{
+        streams: {};
+        lastAccessedAt: {};
+    }>;
+    saveSyncedStream(streamId: string, syncedStream: PersistedSyncedStream): Promise<void>;
+    saveMiniblock(streamId: string, miniblock: ParsedMiniblock): Promise<void>;
+    saveMiniblocks(streamId: string, miniblocks: ParsedMiniblock[], direction: 'forward' | 'backward'): Promise<void>;
+    getMiniblock(streamId: string, miniblockNum: bigint): Promise<ParsedMiniblock | undefined>;
+    getMiniblocks(streamId: string, rangeStart: bigint, rangeEnd: bigint): Promise<ParsedMiniblock[]>;
+    saveSnapshot(streamId: string, miniblockNum: bigint, snapshot: Snapshot): Promise<void>;
+}
+export {};
+//# sourceMappingURL=persistenceStore.d.ts.map

package/dist/persistenceStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"persistenceStore.d.ts","sourceRoot":"","sources":["../src/persistenceStore.ts"],"names":[],"mappings":"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"}