rspace-online/modules/rsplat/local-first-client.ts

80 lines
2.8 KiB
TypeScript

/**
* rSplat Local-First Client
*
* Wraps the shared local-first stack into a splat gallery API.
* 3D files stay on the filesystem — only metadata is in Automerge.
*/
import * as Automerge from '@automerge/automerge';
import { DocumentManager } from '../../shared/local-first/document';
import type { DocumentId } from '../../shared/local-first/document';
import { EncryptedDocStore } from '../../shared/local-first/storage';
import { DocSyncManager } from '../../shared/local-first/sync';
import { DocCrypto } from '../../shared/local-first/crypto';
import { splatScenesSchema, splatScenesDocId } from './schemas';
import type { SplatScenesDoc } from './schemas';
export class SplatLocalFirstClient {
#space: string;
#documents: DocumentManager;
#store: EncryptedDocStore;
#sync: DocSyncManager;
#initialized = false;
constructor(space: string, docCrypto?: DocCrypto) {
this.#space = space;
this.#documents = new DocumentManager();
this.#store = new EncryptedDocStore(space, docCrypto);
this.#sync = new DocSyncManager({
documents: this.#documents,
store: this.#store,
});
this.#documents.registerSchema(splatScenesSchema);
}
get isConnected(): boolean { return this.#sync.isConnected; }
async init(): Promise<void> {
if (this.#initialized) return;
await this.#store.open();
const cachedIds = await this.#store.listByModule('splat', 'scenes');
for (const docId of cachedIds) {
const binary = await this.#store.load(docId);
if (binary) this.#documents.open<SplatScenesDoc>(docId, splatScenesSchema, binary);
}
const proto = location.protocol === 'https:' ? 'wss:' : 'ws:';
const wsUrl = `${proto}//${location.host}/ws/${this.#space}`;
try { await this.#sync.connect(wsUrl, this.#space); } catch { console.warn('[SplatClient] Working offline'); }
this.#initialized = true;
}
async subscribe(): Promise<SplatScenesDoc | null> {
const docId = splatScenesDocId(this.#space) as DocumentId;
let doc = this.#documents.get<SplatScenesDoc>(docId);
if (!doc) {
const binary = await this.#store.load(docId);
doc = binary
? this.#documents.open<SplatScenesDoc>(docId, splatScenesSchema, binary)
: this.#documents.open<SplatScenesDoc>(docId, splatScenesSchema);
}
await this.#sync.subscribe([docId]);
return doc ?? null;
}
getScenes(): SplatScenesDoc | undefined {
return this.#documents.get<SplatScenesDoc>(splatScenesDocId(this.#space) as DocumentId);
}
onChange(cb: (doc: SplatScenesDoc) => void): () => void {
return this.#sync.onChange(splatScenesDocId(this.#space) as DocumentId, cb as (doc: any) => void);
}
onConnect(cb: () => void): () => void { return this.#sync.onConnect(cb); }
onDisconnect(cb: () => void): () => void { return this.#sync.onDisconnect(cb); }
async disconnect(): Promise<void> {
await this.#sync.flush();
this.#sync.disconnect();
}
}