CRDT Guidelines

Critical: Draft-Style Mutations Only

typescript
1// CORRECT - mutate in place
2setState((state) => {
3  state.transactions[id] = transaction;
4});
5
6// WRONG - returning new objects breaks change tracking
7setState((state) => ({
8  ...state,
9  transactions: { ...state.transactions, [id]: transaction },
10}));

Rules

• Import types from schema.ts, don't redeclare
• Soft deletes: Set deletedAt timestamp, never remove from document
• Use crypto.randomUUID() for IDs, Date.now() for timestamps

Schema Pattern

typescript
1export const entitySchema = schema.LoroMap({
2  id: schema.String({ required: true }),
3  // ... fields
4  deletedAt: schema.Number(), // 0 = not deleted, >0 = timestamp
5});

React Hooks

• useActiveTransactions() - excludes soft-deleted
• useTransactions() - includes soft-deleted
• useVaultAction() - for mutations

Sync

• Updates encrypted before leaving client
• Loro handles versioning via version vectors
• Conflicts: last-write-wins per field