Release 0.5.0

[danReynolds]

Performance and reliability release since 0.4.0. No breaking changes and no changes to the public export surface (lib/resqlite.dart unchanged) — safe to upgrade from 0.4.x.

Wins at a glance

Up to 45% faster concurrent writes, ~1.8× faster large selectBytes reads (>256 KB), faster Row/batch operations, a new diagnostics counter for silent re-query fallbacks, and a reader-isolate crash fix for diagnostics() under load.

What's in it (with traceability)

• New API — Diagnostics.unknownDependencyFallbackCount: cumulative counter of writes that conservatively re-queried every registered stream because native dependency tracking overflowed its caps (or hit OOM). Previously unobservable. (#151)

• Bug fix — Database.diagnostics() could intermittently SEGV a reader isolate when polled while readers were mid-query (it toggled SQLite memory accounting on live NOMUTEX reader connections). Read workers now bracket each request with a real busy guard. (#156)

• Performance (accepted experiments, each linked to its PR + experiment doc):

  Win	Impact	PR	Experiment
  Writer-request pipelining (persistent reply port)	−36% to −45% concurrent standalone writes	#153	exp 159
  selectBytes native-view transfer	−44% / ~1.8× on large (>256 KB) byte reads	#169	exp 174
  Row.containsKey identity fast path	−23% on the containsKey lane	#173	exp 176
  RowSchema lookup fast path	~2× main-isolate map consumption at 10K rows	#150	exp 158
  Six-parameter batch packing	executeBatch p50 88 → 75 µs	#141	exp 149
  Nullable batch packing	nullable ASCII 10k×20 25.7 → 21.7 ms	#145	exp 150

  See the benchmark dashboard for current cross-library numbers.

Versioning

• resqlite 0.4.0 → 0.5.0 (pre-1.0 minor). README + workspace constraint pins moved ^0.4.0 → ^0.5.0.
• Companion compatibility releases: resqlite_vector & resqlite_js 0.1.0 → 0.1.1 (now require resqlite: ^0.5.0) so extension users can upgrade alongside 0.5.0.

Verification

• dart pub publish --dry-run clean
• dart test → 303 passed (drift peer-benchmark codegen regenerated via build_runner)

After merge + green CI on main: publish resqlite 0.5.0 + companions 0.1.1 to pub.dev, then tag v0.5.0.

🤖 Generated with Claude Code