@verdant-web/store 2.0.1

package/dist/cjs/sync/Heartbeat.js

@@ -0,0 +1,56 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Heartbeat = void 0;
+const common_1 = require("@verdant-web/common");
+class Heartbeat extends common_1.EventSubscriber {
+    get interval() {
+        return this._interval;
+    }
+    constructor({ interval = 15 * 1000, deadlineLength = 3 * 1000, } = {}) {
+        super();
+        this.nextBeat = null;
+        this.deadline = null;
+        this.keepAlive = () => {
+            if (this.deadline) {
+                clearTimeout(this.deadline);
+                this.deadline = null;
+                this.start();
+            }
+        };
+        this.start = (immediate = false) => {
+            this.stop();
+            if (immediate) {
+                this.beat();
+            }
+            else {
+                this.nextBeat = setTimeout(this.beat, this._interval);
+            }
+        };
+        this.stop = () => {
+            if (this.nextBeat) {
+                clearTimeout(this.nextBeat);
+            }
+            if (this.deadline) {
+                clearTimeout(this.deadline);
+            }
+        };
+        this.beat = async () => {
+            this.emit('beat');
+            this.deadline = setTimeout(this.onDeadline, this.deadlineLength);
+        };
+        this.onDeadline = () => {
+            this.deadline = null;
+            this.emit('missed');
+        };
+        /**
+         * Only takes affect after the next beat
+         */
+        this.setInterval = (interval) => {
+            this._interval = interval;
+        };
+        this._interval = interval;
+        this.deadlineLength = deadlineLength;
+    }
+}
+exports.Heartbeat = Heartbeat;
+//# sourceMappingURL=Heartbeat.js.map

package/dist/cjs/sync/Heartbeat.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Heartbeat.js","sourceRoot":"","sources":["../../../src/sync/Heartbeat.ts"],"names":[],"mappings":";;;AAAA,gDAAsD;AAEtD,MAAa,SAAU,SAAQ,wBAG7B;IAMD,IAAI,QAAQ;QACX,OAAO,IAAI,CAAC,SAAS,CAAC;IACvB,CAAC;IAED,YAAY,EACX,QAAQ,GAAG,EAAE,GAAG,IAAI,EACpB,cAAc,GAAG,CAAC,GAAG,IAAI,MAItB,EAAE;QACL,KAAK,EAAE,CAAC;QAdD,aAAQ,GAA0B,IAAI,CAAC;QACvC,aAAQ,GAA0B,IAAI,CAAC;QAkB/C,cAAS,GAAG,GAAG,EAAE;YAChB,IAAI,IAAI,CAAC,QAAQ,EAAE;gBAClB,YAAY,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;gBAC5B,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;gBACrB,IAAI,CAAC,KAAK,EAAE,CAAC;aACb;QACF,CAAC,CAAC;QAEF,UAAK,GAAG,CAAC,SAAS,GAAG,KAAK,EAAE,EAAE;YAC7B,IAAI,CAAC,IAAI,EAAE,CAAC;YACZ,IAAI,SAAS,EAAE;gBACd,IAAI,CAAC,IAAI,EAAE,CAAC;aACZ;iBAAM;gBACN,IAAI,CAAC,QAAQ,GAAG,UAAU,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;aACtD;QACF,CAAC,CAAC;QAEF,SAAI,GAAG,GAAG,EAAE;YACX,IAAI,IAAI,CAAC,QAAQ,EAAE;gBAClB,YAAY,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;aAC5B;YACD,IAAI,IAAI,CAAC,QAAQ,EAAE;gBAClB,YAAY,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;aAC5B;QACF,CAAC,CAAC;QAEM,SAAI,GAAG,KAAK,IAAI,EAAE;YACzB,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YAClB,IAAI,CAAC,QAAQ,GAAG,UAAU,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,cAAc,CAAC,CAAC;QAClE,CAAC,CAAC;QAEM,eAAU,GAAG,GAAG,EAAE;YACzB,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;YACrB,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACrB,CAAC,CAAC;QAEF;;WAEG;QACH,gBAAW,GAAG,CAAC,QAAgB,EAAE,EAAE;YAClC,IAAI,CAAC,SAAS,GAAG,QAAQ,CAAC;QAC3B,CAAC,CAAC;QA7CD,IAAI,CAAC,SAAS,GAAG,QAAQ,CAAC;QAC1B,IAAI,CAAC,cAAc,GAAG,cAAc,CAAC;IACtC,CAAC;CA4CD;AAnED,8BAmEC"}

package/dist/cjs/sync/PresenceManager.d.ts

@@ -0,0 +1,41 @@
+import { ServerMessage, EventSubscriber } from '@verdant-web/common';
+import type { UserInfo } from '../index.js';
+import { LocalReplicaInfo } from '../metadata/LocalReplicaStore.js';
+export declare const HANDLE_MESSAGE: unique symbol;
+export declare class PresenceManager<Profile = any, Presence = any> extends EventSubscriber<{
+    peerChanged: (userId: string, presence: UserInfo<Profile, Presence>) => void;
+    selfChanged: (presence: UserInfo<Profile, Presence>) => void;
+    peersChanged: (peers: Record<string, any>) => void;
+    peerLeft: (userId: string, lastPresence: UserInfo<Profile, Presence>) => void;
+    update: (presence: Partial<Presence>) => void;
+}> {
+    private _peers;
+    private _self;
+    private _peerIds;
+    private _updateBatcher;
+    private _updateBatch;
+    get self(): UserInfo<Profile, Presence>;
+    get peers(): Record<string, UserInfo<Profile, Presence>>;
+    get peerIds(): string[];
+    get everyone(): {
+        [x: string]: UserInfo<Profile, Presence>;
+    };
+    constructor({ initialPresence, updateBatchTimeout, defaultProfile, }: {
+        initialPresence: Presence;
+        defaultProfile: Profile;
+        updateBatchTimeout?: number;
+    });
+    /**
+     * Decides if an update is for the local user or not. Even if it's a different replica
+     * than the local one.
+     *
+     * If the replicaId matches, we use that first - we may not know the local replica's User ID yet,
+     * e.g. on the first presence update.
+     *
+     * Otherwise, match the user ID to our local copy.
+     */
+    private isSelf;
+    [HANDLE_MESSAGE]: (localReplicaInfo: LocalReplicaInfo, message: ServerMessage) => Promise<void>;
+    update: (presence: Partial<Presence>) => Promise<void>;
+    flushPresenceUpdates: (presenceUpdates: Partial<Presence>[]) => void;
+}

package/dist/cjs/sync/PresenceManager.js

@@ -0,0 +1,108 @@
+"use strict";
+var _a;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PresenceManager = exports.HANDLE_MESSAGE = void 0;
+const common_1 = require("@verdant-web/common");
+exports.HANDLE_MESSAGE = Symbol('handleMessage');
+class PresenceManager extends common_1.EventSubscriber {
+    get self() {
+        return this._self;
+    }
+    get peers() {
+        return this._peers;
+    }
+    get peerIds() {
+        return this._peerIds;
+    }
+    get everyone() {
+        const everyone = Object.assign({}, this._peers);
+        everyone[this.self.id] = this.self;
+        return everyone;
+    }
+    constructor({ initialPresence, updateBatchTimeout = 200, defaultProfile, }) {
+        super();
+        this._peers = {};
+        this._self = { profile: {} };
+        this._peerIds = new Array();
+        /**
+         * Decides if an update is for the local user or not. Even if it's a different replica
+         * than the local one.
+         *
+         * If the replicaId matches, we use that first - we may not know the local replica's User ID yet,
+         * e.g. on the first presence update.
+         *
+         * Otherwise, match the user ID to our local copy.
+         */
+        this.isSelf = (localReplicaInfo, userInfo) => {
+            return (localReplicaInfo.id === userInfo.replicaId ||
+                this._self.id === userInfo.id);
+        };
+        this[_a] = async (localReplicaInfo, message) => {
+            let peersChanged = false;
+            const peerIdsSet = new Set(this.peerIds);
+            if (message.type === 'presence-changed') {
+                if (this.isSelf(localReplicaInfo, message.userInfo)) {
+                    this._self = message.userInfo;
+                    this.emit('selfChanged', message.userInfo);
+                }
+                else {
+                    peerIdsSet.add(message.userInfo.id);
+                    this._peers[message.userInfo.id] = message.userInfo;
+                    peersChanged = true;
+                    this.emit('peerChanged', message.userInfo.id, message.userInfo);
+                }
+            }
+            else if (message.type === 'sync-resp') {
+                // reset to provided presence data, which includes all peers.
+                this._peers = {};
+                peerIdsSet.clear();
+                for (const [id, userInfo] of Object.entries(message.peerPresence)) {
+                    if (this.isSelf(localReplicaInfo, userInfo)) {
+                        this._self = userInfo;
+                        this.emit('selfChanged', userInfo);
+                    }
+                    else {
+                        peersChanged = true;
+                        peerIdsSet.add(id);
+                        this._peers[id] = userInfo;
+                        this.emit('peerChanged', id, userInfo);
+                    }
+                }
+            }
+            else if (message.type === 'presence-offline') {
+                peerIdsSet.delete(message.userId);
+                const lastPresence = this._peers[message.userId];
+                delete this._peers[message.userId];
+                peersChanged = true;
+                this.emit('peerLeft', message.userId, lastPresence);
+            }
+            if (peersChanged) {
+                this._peerIds = Array.from(peerIdsSet);
+                this.emit('peersChanged', this._peers);
+            }
+        };
+        this.update = async (presence) => {
+            this._updateBatch.update({
+                items: [presence],
+            });
+        };
+        this.flushPresenceUpdates = (presenceUpdates) => {
+            const presence = presenceUpdates.reduce((acc, update) => {
+                return Object.assign(Object.assign({}, acc), update);
+            }, this.self.presence);
+            this.emit('update', presence);
+        };
+        this.self.presence = initialPresence;
+        this.self.profile = defaultProfile;
+        this._updateBatcher = new common_1.Batcher(this.flushPresenceUpdates);
+        this._updateBatch = this._updateBatcher.add({
+            max: 25,
+            timeout: updateBatchTimeout,
+            items: [],
+            key: 'default',
+        });
+    }
+}
+exports.PresenceManager = PresenceManager;
+_a = exports.HANDLE_MESSAGE;
+//# sourceMappingURL=PresenceManager.js.map

package/dist/cjs/sync/PresenceManager.js.map

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

package/dist/cjs/sync/PushPullSync.d.ts

@@ -0,0 +1,36 @@
+import { ClientMessage, EventSubscriber } from '@verdant-web/common';
+import { Metadata } from '../metadata/Metadata.js';
+import { PresenceManager } from './PresenceManager.js';
+import { ServerSyncEndpointProvider } from './ServerSyncEndpointProvider.js';
+import { SyncTransport, SyncTransportEvents } from './Sync.js';
+export declare class PushPullSync extends EventSubscriber<SyncTransportEvents> implements SyncTransport {
+    readonly meta: Metadata;
+    readonly presence: PresenceManager;
+    private endpointProvider;
+    private heartbeat;
+    readonly mode = "pull";
+    private log;
+    private _isConnected;
+    private _status;
+    private _hasSynced;
+    constructor({ endpointProvider, meta, presence, interval, log, }: {
+        endpointProvider: ServerSyncEndpointProvider;
+        meta: Metadata;
+        presence: PresenceManager;
+        interval?: number;
+        log?: (...args: any[]) => any;
+    });
+    setInterval: (interval: number) => void;
+    get interval(): number;
+    private sendRequest;
+    private handleServerMessage;
+    send: (message: ClientMessage) => Promise<void> | undefined;
+    start(): void;
+    stop(): void;
+    dispose: () => void;
+    reconnect(): void;
+    private onHeartbeat;
+    private onHeartbeatMissed;
+    get isConnected(): boolean;
+    get status(): "active" | "paused";
+}

package/dist/cjs/sync/PushPullSync.js

@@ -0,0 +1,142 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PushPullSync = void 0;
+const common_1 = require("@verdant-web/common");
+const Heartbeat_js_1 = require("./Heartbeat.js");
+class PushPullSync extends common_1.EventSubscriber {
+    constructor({ endpointProvider, meta, presence, interval = 15 * 1000, log = () => { }, }) {
+        super();
+        this.mode = 'pull';
+        this._isConnected = false;
+        this._status = 'paused';
+        this._hasSynced = false;
+        this.setInterval = (interval) => {
+            this.heartbeat.setInterval(interval);
+        };
+        this.sendRequest = async (messages) => {
+            this.log('Sending sync request', messages);
+            try {
+                const { http: host, token } = await this.endpointProvider.getEndpoints();
+                const response = await fetch(host, {
+                    method: 'POST',
+                    headers: {
+                        'Content-Type': 'application/json',
+                        Authorization: `Bearer ${token}`,
+                    },
+                    body: JSON.stringify({
+                        messages,
+                    }),
+                    credentials: 'include',
+                });
+                if (response.ok) {
+                    this.heartbeat.keepAlive();
+                    const json = (await response.json());
+                    for (const message of json.messages) {
+                        this.handleServerMessage(message);
+                    }
+                    if (!this._isConnected) {
+                        this._isConnected = true;
+                        this.emit('onlineChange', true);
+                    }
+                }
+                else {
+                    this.log('Sync request failed', response.status, await response.text());
+                    if (this._isConnected) {
+                        this._isConnected = false;
+                        this.emit('onlineChange', false);
+                    }
+                    // only keep trying if the error was not 4xx
+                    if (response.status >= 500) {
+                        this.heartbeat.keepAlive();
+                    }
+                }
+            }
+            catch (error) {
+                if (this._isConnected) {
+                    this._isConnected = false;
+                    this.emit('onlineChange', false);
+                }
+                this.log(error);
+                this.heartbeat.keepAlive();
+            }
+        };
+        this.handleServerMessage = async (message) => {
+            if (message.type === 'sync-resp') {
+                if (message.ackThisNonce) {
+                    // we need to ack the nonce to confirm that we received the sync-resp
+                    this.log('Sending sync ack', message.ackThisNonce);
+                    this.sendRequest([
+                        await this.meta.messageCreator.createAck(message.ackThisNonce),
+                    ]);
+                }
+                // but we can go ahead and preemptively allow ops to be sent
+                this._hasSynced = true;
+            }
+            this.emit('message', message);
+        };
+        this.send = (message) => {
+            // only certain messages are sent for pull-based sync.
+            switch (message.type) {
+                case 'presence-update':
+                case 'sync':
+                case 'heartbeat':
+                    return this.sendRequest([message]);
+                case 'op':
+                    if (this._hasSynced) {
+                        return this.sendRequest([message]);
+                    }
+                    break;
+            }
+        };
+        this.dispose = () => { };
+        // on a heartbeat, do a sync
+        this.onHeartbeat = async () => {
+            // for HTTP sync we send presence first, so that the sync-resp message
+            // will include the client's own presence info and fill in missing profile
+            // data on the first request. otherwise it would have to wait for the second.
+            this.sendRequest([
+                await this.meta.messageCreator.createPresenceUpdate(this.presence.self.presence),
+                await this.meta.messageCreator.createSyncStep1(),
+            ]);
+        };
+        // if the server fails to respond in a certain amount of time, we assume
+        // the connection is lost and go offline.
+        this.onHeartbeatMissed = async () => {
+            this.emit('onlineChange', false);
+            this.log('Missed heartbeat');
+            this._isConnected = false;
+        };
+        this.log = log;
+        this.meta = meta;
+        this.presence = presence;
+        this.endpointProvider = endpointProvider;
+        this.heartbeat = new Heartbeat_js_1.Heartbeat({
+            interval,
+        });
+        this.heartbeat.subscribe('beat', this.onHeartbeat);
+        this.heartbeat.subscribe('missed', this.onHeartbeatMissed);
+    }
+    get interval() {
+        return this.heartbeat.interval;
+    }
+    start() {
+        if (this.status === 'active') {
+            return;
+        }
+        this.heartbeat.start(true);
+        this._status = 'active';
+    }
+    stop() {
+        this.heartbeat.stop();
+        this._status = 'paused';
+    }
+    reconnect() { }
+    get isConnected() {
+        return this._isConnected;
+    }
+    get status() {
+        return this._status;
+    }
+}
+exports.PushPullSync = PushPullSync;
+//# sourceMappingURL=PushPullSync.js.map

package/dist/cjs/sync/PushPullSync.js.map

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

package/dist/cjs/sync/ServerSyncEndpointProvider.d.ts

@@ -0,0 +1,27 @@
+import { ReplicaType } from '@verdant-web/common';
+export interface ServerSyncEndpointProviderConfig {
+    /**
+     * The location of the endpoint used to retrieve an
+     * authorization token for the client.
+     */
+    authEndpoint?: string;
+    /**
+     * A custom fetch function to retrieve authorization
+     * data.
+     */
+    fetchAuth?: () => Promise<{
+        accessToken: string;
+    }>;
+}
+export declare class ServerSyncEndpointProvider {
+    private config;
+    private cached;
+    type: ReplicaType;
+    constructor(config: ServerSyncEndpointProviderConfig);
+    getEndpoints: () => Promise<{
+        http: string;
+        websocket: string;
+        files: string;
+        token: string;
+    }>;
+}

package/dist/cjs/sync/ServerSyncEndpointProvider.js

@@ -0,0 +1,65 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ServerSyncEndpointProvider = void 0;
+const common_1 = require("@verdant-web/common");
+const jwt_decode_1 = __importDefault(require("jwt-decode"));
+class ServerSyncEndpointProvider {
+    constructor(config) {
+        this.config = config;
+        this.cached = null;
+        this.type = common_1.ReplicaType.Realtime;
+        this.getEndpoints = async () => {
+            if (this.cached) {
+                return this.cached;
+            }
+            let result;
+            if (this.config.fetchAuth) {
+                result = await this.config.fetchAuth();
+            }
+            else {
+                result = await fetch(this.config.authEndpoint, {
+                    credentials: 'include',
+                }).then((res) => {
+                    if (!res.ok) {
+                        throw new Error(`Auth endpoint returned non-200 response: ${res.status}`);
+                    }
+                    else {
+                        return res.json();
+                    }
+                });
+            }
+            (0, common_1.assert)(result.accessToken, 'No access token provided from auth endpoint');
+            const decoded = jwt_decode_1.default(result.accessToken);
+            (0, common_1.assert)(decoded.url, 'No sync endpoint provided from auth endpoint');
+            (0, common_1.assert)(decoded.type !== undefined, 'No replica type provided from auth endpoint');
+            this.type = parseInt(decoded.type + '');
+            const url = new URL(decoded.url);
+            url.protocol = url.protocol.replace('ws', 'http');
+            const httpEndpoint = url.toString();
+            url.protocol = url.protocol.replace('http', 'ws');
+            const websocketEndpoint = url.toString();
+            let fileEndpoint = decoded.file;
+            if (!fileEndpoint) {
+                // default to http endpoint + '/files';
+                const fileUrl = new URL(httpEndpoint);
+                fileUrl.pathname = fileUrl.pathname + '/files';
+                fileEndpoint = fileUrl.toString();
+            }
+            this.cached = {
+                http: httpEndpoint,
+                websocket: websocketEndpoint,
+                files: fileEndpoint,
+                token: result.accessToken,
+            };
+            return this.cached;
+        };
+        if (!config.authEndpoint && !config.fetchAuth) {
+            throw new Error('Either authEndpoint or fetchAuth must be provided to ServerSyncEndpointProvider');
+        }
+    }
+}
+exports.ServerSyncEndpointProvider = ServerSyncEndpointProvider;
+//# sourceMappingURL=ServerSyncEndpointProvider.js.map

package/dist/cjs/sync/ServerSyncEndpointProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ServerSyncEndpointProvider.js","sourceRoot":"","sources":["../../../src/sync/ServerSyncEndpointProvider.ts"],"names":[],"mappings":";;;;;;AAAA,gDAA0D;AAC1D,4DAAkD;AAiBlD,MAAa,0BAA0B;IAStC,YAAoB,MAAwC;QAAxC,WAAM,GAAN,MAAM,CAAkC;QARpD,WAAM,GAAG,IAKT,CAAC;QACT,SAAI,GAAgB,oBAAW,CAAC,QAAQ,CAAC;QAUzC,iBAAY,GAAG,KAAK,IAAI,EAAE;YACzB,IAAI,IAAI,CAAC,MAAM,EAAE;gBAChB,OAAO,IAAI,CAAC,MAAM,CAAC;aACnB;YAED,IAAI,MAA+B,CAAC;YACpC,IAAI,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE;gBAC1B,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC;aACvC;iBAAM;gBACN,MAAM,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,YAAa,EAAE;oBAC/C,WAAW,EAAE,SAAS;iBACtB,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE;oBACf,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE;wBACZ,MAAM,IAAI,KAAK,CACd,4CAA4C,GAAG,CAAC,MAAM,EAAE,CACxD,CAAC;qBACF;yBAAM;wBACN,OAAO,GAAG,CAAC,IAAI,EAAE,CAAC;qBAClB;gBACF,CAAC,CAAC,CAAC;aACH;YACD,IAAA,eAAM,EAAC,MAAM,CAAC,WAAW,EAAE,6CAA6C,CAAC,CAAC;YAC1E,MAAM,OAAO,GAAI,oBAAiB,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;YACvD,IAAA,eAAM,EAAC,OAAO,CAAC,GAAG,EAAE,8CAA8C,CAAC,CAAC;YACpE,IAAA,eAAM,EACL,OAAO,CAAC,IAAI,KAAK,SAAS,EAC1B,6CAA6C,CAC7C,CAAC;YACF,IAAI,CAAC,IAAI,GAAG,QAAQ,CAAC,OAAO,CAAC,IAAI,GAAG,EAAE,CAAC,CAAC;YACxC,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;YACjC,GAAG,CAAC,QAAQ,GAAG,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;YAClD,MAAM,YAAY,GAAG,GAAG,CAAC,QAAQ,EAAE,CAAC;YACpC,GAAG,CAAC,QAAQ,GAAG,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;YAClD,MAAM,iBAAiB,GAAG,GAAG,CAAC,QAAQ,EAAE,CAAC;YACzC,IAAI,YAAY,GAAW,OAAO,CAAC,IAAI,CAAC;YACxC,IAAI,CAAC,YAAY,EAAE;gBAClB,uCAAuC;gBACvC,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,YAAY,CAAC,CAAC;gBACtC,OAAO,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,GAAG,QAAQ,CAAC;gBAC/C,YAAY,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;aAClC;YACD,IAAI,CAAC,MAAM,GAAG;gBACb,IAAI,EAAE,YAAY;gBAClB,SAAS,EAAE,iBAAiB;gBAC5B,KAAK,EAAE,YAAY;gBACnB,KAAK,EAAE,MAAM,CAAC,WAAW;aACzB,CAAC;YACF,OAAO,IAAI,CAAC,MAAM,CAAC;QACpB,CAAC,CAAC;QAvDD,IAAI,CAAC,MAAM,CAAC,YAAY,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE;YAC9C,MAAM,IAAI,KAAK,CACd,iFAAiF,CACjF,CAAC;SACF;IACF,CAAC;CAmDD;AAlED,gEAkEC"}

package/dist/cjs/sync/Sync.d.ts

@@ -0,0 +1,127 @@
+import { ClientMessage, DocumentBaseline, EventSubscriber, FileData, Operation, ServerMessage } from '@verdant-web/common';
+import { Metadata } from '../metadata/Metadata.js';
+import { PresenceManager } from './PresenceManager.js';
+import { FilePullResult, FileUploadResult } from './FileSync.js';
+import { ServerSyncEndpointProviderConfig } from './ServerSyncEndpointProvider.js';
+type SyncEvents = {
+    onlineChange: (isOnline: boolean) => void;
+};
+export type SyncTransportEvents = SyncEvents & {
+    message: (message: ServerMessage) => void;
+};
+export interface SyncTransport {
+    subscribe(event: 'onlineChange', handler: (online: boolean) => void): () => void;
+    readonly presence: PresenceManager;
+    readonly mode: SyncTransportMode;
+    send(message: ClientMessage): void;
+    start(): void;
+    stop(): void;
+    dispose(): void;
+    reconnect(): void;
+    readonly isConnected: boolean;
+    readonly status: 'active' | 'paused';
+}
+export interface Sync extends SyncTransport {
+    setMode(mode: SyncTransportMode): void;
+    setPullInterval(interval: number): void;
+    readonly pullInterval: number;
+    uploadFile(data: FileData): Promise<FileUploadResult>;
+    getFile(fileId: string): Promise<FilePullResult>;
+}
+export declare class NoSync extends EventSubscriber<SyncEvents> implements Sync {
+    readonly mode = "pull";
+    send(): void;
+    start(): void;
+    stop(): void;
+    dispose: () => void;
+    reconnect(): void;
+    setMode(): void;
+    setPullInterval(): void;
+    readonly isConnected = false;
+    readonly status = "paused";
+    readonly pullInterval = 0;
+    readonly presence: PresenceManager<{}, {}>;
+    uploadFile: () => Promise<{
+        success: boolean;
+        retry: boolean;
+    }>;
+    getFile: () => Promise<FilePullResult>;
+}
+export type SyncTransportMode = 'realtime' | 'pull';
+export interface ServerSyncOptions<Profile = any, Presence = any> extends ServerSyncEndpointProviderConfig {
+    /**
+     * When a client first connects, it will use this presence value.
+     */
+    initialPresence: Presence;
+    /**
+     * Before connecting to the server, the local client will have
+     * this value for their profile data. You can either cache and store
+     * profile data from a previous connection or provide defaults like
+     * empty strings.
+     */
+    defaultProfile: Profile;
+    /**
+     * Provide `false` to disable transport selection. Transport selection
+     * automatically switches between HTTP and WebSocket based sync depending
+     * on the number of peers connected. If a user is alone, they will use
+     * HTTP push/pull to sync changes. If another user joins, both users will
+     * be upgraded to websockets.
+     *
+     * Turning off this feature allows you more control over the transport
+     * which can be useful for low-power devices or to save server traffic.
+     * To modify transport modes manually, utilize `client.sync.setMode`.
+     * The built-in behavior is essentially switching modes based on
+     * the number of peers detected by client.sync.presence.
+     */
+    automaticTransportSelection?: boolean;
+    initialTransport?: SyncTransportMode;
+    autoStart?: boolean;
+    /**
+     * Optionally specify an interval, in milliseconds, to poll the server
+     * when in pull mode.
+     */
+    pullInterval?: number;
+    /**
+     * Presence updates are batched to reduce number of requests / messages
+     * sent to the server. You can specify the batching time slice, in milliseconds,
+     */
+    presenceUpdateBatchTimeout?: number;
+}
+export declare class ServerSync<Profile = any, Presence = any> extends EventSubscriber<SyncEvents> implements Sync {
+    private webSocketSync;
+    private pushPullSync;
+    private fileSync;
+    private activeSync;
+    private endpointProvider;
+    private onData;
+    private meta;
+    readonly presence: PresenceManager<Profile, Presence>;
+    private log;
+    constructor({ authEndpoint, fetchAuth, initialPresence, automaticTransportSelection, autoStart, initialTransport, pullInterval, presenceUpdateBatchTimeout, defaultProfile, }: ServerSyncOptions<Profile, Presence>, { meta, log, onData, }: {
+        meta: Metadata;
+        log?: (...args: any[]) => void;
+        onData: (data: {
+            operations: Operation[];
+            baselines: DocumentBaseline[];
+            reset?: boolean;
+        }) => Promise<void>;
+    });
+    get canDoRealtime(): boolean;
+    private handleMessage;
+    private handleOnlineChange;
+    private handlePresenceUpdate;
+    setMode: (transport: SyncTransportMode) => void;
+    setPullInterval: (interval: number) => void;
+    get pullInterval(): number;
+    send: (message: ClientMessage) => void;
+    uploadFile: (info: FileData) => Promise<FileUploadResult>;
+    getFile: (id: string) => Promise<FilePullResult>;
+    start: () => void;
+    stop: () => void;
+    dispose: () => void;
+    reconnect: () => void;
+    get isConnected(): boolean;
+    get status(): "active" | "paused";
+    get mode(): SyncTransportMode;
+}
+export {};