archbase_flutter

Adicionado

• ArchbaseSyncEngine.save(coalesce: true) — coalescência local por (type, aggregateId), opt-in (default false). Desacopla a chave de coalescência (estável) do operationId (id de mutação, único por envio):
  • enquanto a op está pendente, uma nova edição do mesmo (type, aggregateId) substitui o payload da op ainda não enviada (preserva a posição na fila e reusa o id, que nunca saiu do device);
  • depois do ACK (op removida), a próxima edição vira uma op nova com UUID, então o servidor não a devolve como SKIPPED por reuso de id.
  • Elimina a perda silenciosa do anti-padrão de operationId estável TYPE:aggregateId (edições descartadas após o primeiro envio).
• ArchbaseAtomicWriteStore — capacidade OPCIONAL do store: grava a entidade otimista e a operação de outbox na mesma transação. O motor a usa quando o store implementa (o ArchbaseSqfliteStore implementa); senão, cai no modo sequencial. Evita o estado inconsistente (entidade pendente sem op, ou registro removido antes do delete entrar na fila) após um crash.

Notas

• Tudo aditivo/opt-in: atualizar de 0.6.x não muda o comportamento de quem já usa o motor. Nenhuma migração de schema (a coalescência usa as colunas type/aggregate_id já existentes).
• Implementações próprias de ArchbaseLocalStore seguem válidas sem mudança; para ganhar a escrita atômica, basta também implementar ArchbaseAtomicWriteStore.

Adicionado

• Coalescing delete↔upsert (anti-ghost) no motor: ArchbaseSyncEngine.save(..., supersedeAggregate: true) cancela todas as operações do mesmo agregado — abertas e terminais (exhausted/rejected/ conflict) — antes de enfileirar a nova. Elimina o "registro que ressuscita": um DELETE não deixa para trás um UPSERT no dead-letter que seria recriado depois.
• Resgate de dead-letter (opt-in) via maxRescuesPerOperation (default 0 = desligado). Quando > 0, o drain() promove operações exhausted de volta a pending até este teto por operação — destrava a fila quando o erro terminal pode ter sido resolvido no servidor (ex.: a dependência voltou a existir), sem virar retry infinito. Contador em memória (por sessão). Também exposto como ArchbaseSyncEngine.rescueExhausted() para chamada manual.

Notas

• Ambos são aditivos e opt-in (defaults preservam o comportamento anterior): atualizar de 0.6.1 não exige nenhuma mudança em quem já usa o motor.

Adicionado

• Módulo offline-first reutilizável em lib/src/offline/ (barrel archbase_offline.dart):
  • ArchbaseSyncEngine — outbox + drain single-flight, backoff exponencial + jitter, dependsOn que BLOQUEIA, dead-letter (exhausted) com retry manual, gating de binário, snapshot reativo para badges e hook de reconciliação.
  • ArchbaseSyncable / ArchbaseSyncState — contrato de entidade sincronizável (id UUID cliente, syncState, clientUpdatedAt, serverVersion, deletedAt).
  • ArchbaseSqfliteStore (implementa ArchbaseLocalStore) — store local em single-table JSON + outbox, watch<T>() reativo, opener injetável para SQLCipher; registro por ArchbaseEntityCodec (sem codegen).
  • Protocolo em lote (archbase_sync_protocol.dart): ArchbaseSyncSender (porta), serialização de operações e parsing de ACKs (PROCESSED/SKIPPED/CONFLICT/BLOCKED/ REJECTED/FAILED) — casa com POST /api/v1/sync/operations do archbase-offline-sync.
  • ArchbaseBinaryUploader (porta) para upload de binários em canal separado, com gating.
• ADR-0001 (motor offline-first) + design do contrato do módulo em docs/.

Mudou

• documentation: no pubspec aponta para o URL real do site (/archbase-flutter-docs/ — o repo de docs é separado da lib)
• Adapters (_riverpod, _getx) também atualizados — agora dependem de archbase_flutter: ^0.5.3 e o documentation URL correto