🔗 Locorda

// 1. Add to pubspec.yaml
dependencies:
  locorda: ^0.1.0
  locorda_drift: ^0.1.0  # SQLite storage backend

// 2. Define your model with CRDT annotations
@RdfGlobalResource(IriTerm('https://example.org/Note'))
class Note {
  @RdfProperty(Schema.identifier)
  @RdfIriPart()
  String id;

  @RdfProperty(Schema.name)
  @CrdtLwwRegister()  // Last writer wins for title
  String title;

  @RdfProperty(Schema.text)
  @CrdtLwwRegister()  // Last writer wins for content
  String content;

  @RdfProperty(Schema.keywords)
  @CrdtOrSet()  // Tags can be added/removed independently
  Set<String> tags;

  Note({required this.id, required this.title, 
       required this.content, Set<String>? tags})
      : tags = tags ?? {};
}

// 3. Set up the sync system
final locorda = await Locorda.create(
  storage: DriftStorage(
    native: DriftNativeOptions(),
    web: DriftWebOptions(
      sqlite3Wasm: Uri.parse('sqlite3.wasm'),
      driftWorker: Uri.parse('drift_worker.js'),
    ),
  ),
  backends: [
    SolidBackend(auth: solidAuth),  // Optional: for Solid Pod sync
  ],
  mapperInitializer: (context) => initRdfMapper(
    rdfMapper: context.baseRdfMapper,
    // ... further mapper setup
  ),
  config: LocordaConfig(
    resources: [
      ResourceConfig(
        type: Note,
        crdtMapping: Uri.parse('$appBaseUrl/mappings/note-v1.ttl'),
        indices: [FullIndex(itemFetchPolicy: ItemFetchPolicy.prefetch)],
      ),
    ],
  ),
);

// 4. Set up hydration - Locorda syncs, you store in your database
final subscription = await locorda.hydrateWithCallbacks<Note>(
  getCurrentCursor: () => database.getCursor('note'),
  onUpdate: (note) => database.saveNote(note),
  onDelete: (id) => database.deleteNote(id),
  onCursorUpdate: (cursor) => database.saveCursor('note', cursor),
);

// 5. Use it! Works offline immediately
final note = Note(
  id: 'note-1',
  title: 'My First Note',
  content: 'This works offline and syncs to Solid Pods!',
  tags: {'offline-first', 'crdt'},
);

await locorda.save(note);  // Locorda handles sync, hydration updates your DB

// 6. Query YOUR database (Locorda is not a database!)
final notes = await database.getAllNotes();