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

80 lines
2.8 KiB
TypeScript

/**
* rVote Local-First Client
*
* Wraps the shared local-first stack into a voting-specific API.
* Note: Vote tallying uses Intent/Claim pattern — server validates votes.
*/
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 { proposalSchema, proposalDocId } from './schemas';
import type { ProposalDoc } from './schemas';
export class VoteLocalFirstClient {
#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(proposalSchema);
}
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('vote', 'proposals');
for (const docId of cachedIds) {
const binary = await this.#store.load(docId);
if (binary) this.#documents.open<ProposalDoc>(docId, proposalSchema, 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('[VoteClient] Working offline'); }
this.#initialized = true;
}
async subscribeProposal(proposalId: string): Promise<ProposalDoc | null> {
const docId = proposalDocId(this.#space, proposalId) as DocumentId;
let doc = this.#documents.get<ProposalDoc>(docId);
if (!doc) {
const binary = await this.#store.load(docId);
doc = binary
? this.#documents.open<ProposalDoc>(docId, proposalSchema, binary)
: this.#documents.open<ProposalDoc>(docId, proposalSchema);
}
await this.#sync.subscribe([docId]);
return doc ?? null;
}
getProposal(proposalId: string): ProposalDoc | undefined {
return this.#documents.get<ProposalDoc>(proposalDocId(this.#space, proposalId) as DocumentId);
}
onChange(proposalId: string, cb: (doc: ProposalDoc) => void): () => void {
return this.#sync.onChange(proposalDocId(this.#space, proposalId) 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();
}
}