v0.3.2

0.3.2 (2026-08-18)

Documentation

• fix RELEASE.md drift on Maven Central and device-test status (66fab78)

v0.3.1

0.3.1 (2026-08-18)

Documentation

• fix the one install snippet I missed (c09be29)
• update install to 0.3.0, and the facts around it (6839024)

v0.3.0

0.3.0 (2026-08-18)

Features

• core: QueryEvent stream, so the cache can explain itself (766a64b)
• persist-room: Room-backed stores that write only what changed (a1d3609)

Fixes

• persist: concurrent writers broke persistence permanently (53571d6)

Documentation

• give Kwery its own identity, and use terms people search for (983bf60)
• hero banner, and positioning that argues from measurements (ce923ac)
• rewrite the README shorter, and add a flow diagram (77ccac7)

v0.2.1

0.2.1 (2026-08-18)

Fixes

• build: publish with the configuration cache off, and allow re-publishing (a44f688)

v0.2.0

0.2.0 (2026-08-18)

Features

• core: typed combineQueries for up to five queries (95fe442)

Fixes

• build: publish from the release-please workflow, not on: release (9ba9b34)

v0.1.2

0.1.2 (2026-08-18)

Fixes

• build: make release-please actually update the version (7c7d225)

Build and publishing

• automate releases with release-please and the vanniktech plugin (f8cabc6)
• bump main to 0.2.0-SNAPSHOT after v0.1.1 (a3174a1)

v0.1.1

Same library as v0.1.0 —
no file under kwery-*/src/main differs. This release exists because the Maven
Central publishing infrastructure landed three commits after that tag, so
v0.1.0 cannot build a signable bundle: the task is not in that tree.

Building "0.1.0" from a later tree would have worked and would have been a quiet
lie. On an immutable registry a version has to be the tag it claims to be.

What changed

• GPG signing, using an in-memory key from Gradle properties, skipped entirely
  when no key is present so ./gradlew build still works for everyone else
• ./gradlew centralBundle — stages all five modules into one Maven repository
  layout and zips it, which is the shape the Central Portal takes
• Documentation reshuffle so each fact has one home: the README owns what Kwery
  is and how to install it, release notes own what changed, RELEASE.md owns
  what to expect and what was deliberately left out

Install

// settings.gradle.kts
maven("https://jitpack.io")

// build.gradle.kts
implementation("com.github.dbjpanda.kwery:kwery-core:v0.1.1")
implementation("com.github.dbjpanda.kwery:kwery-android:v0.1.1")   // focus + connectivity
implementation("com.github.dbjpanda.kwery:kwery-compose:v0.1.1")   // rememberQuery
implementation("com.github.dbjpanda.kwery:kwery-persist:v0.1.1")   // cache across process death
testImplementation("com.github.dbjpanda.kwery:kwery-test:v0.1.1")  // TestQueryClient

Still not on Maven Central — the namespace io.github.dbjpanda is registered
and verified, and the bundle task is ready; it needs a signing key.

v0.1.0

Async server-state management for Android — caching, deduplication,
stale-while-revalidate, mutations, offline support, and a cache that survives
process death.

A TanStack Query equivalent for Kotlin,
built for how Android actually behaves.

Install

Not on Maven Central yet. JitPack builds it from this tag.

// settings.gradle.kts
dependencyResolutionManagement {
    repositories {
        google()
        mavenCentral()
        maven("https://jitpack.io")
    }
}

// build.gradle.kts
dependencies {
    implementation("com.github.dbjpanda.kwery:kwery-core:v0.1.0")
    implementation("com.github.dbjpanda.kwery:kwery-android:v0.1.0")   // focus + connectivity
    implementation("com.github.dbjpanda.kwery:kwery-compose:v0.1.0")   // rememberQuery
    implementation("com.github.dbjpanda.kwery:kwery-persist:v0.1.0")   // cache across process death
    testImplementation("com.github.dbjpanda.kwery:kwery-test:v0.1.0")  // TestQueryClient
}

What is in it

19 of 24 features complete through spec, tests and documentation, behind
367 tests — none of which use a real delay(), so the suite runs in
seconds rather than minutes.

• Queries with staleTime / gcTime, deduplication, and two orthogonal
  status axes so success + fetching (background refresh) and pending +
  paused (cold start, offline) are both expressible
• Mutations with optimistic updates, typed rollback context, and scopes that
  serialise writes which must not race
• Offline: queries pause rather than fail, and writes queue durably and
  replay after process death
• Persistence with hydration that preserves each entry's original age, so a
  restored cache is judged fresh or stale correctly
• Infinite and paginated queries, with retry applied per page
• Compose bindings and a Flow-first core that works equally well from a
  ViewModel

Android-specific choices

These are where Kwery diverges from a direct port, and why it exists:

• Rotation costs nothing. A reattach inside a five-second grace window is a
  continuation, not a new mount, so it skips the staleness check. Measured:
  without it, rotation at the default staleTime = 0 fires a redundant request
  every time.
• Connectivity means a validated network. A captive portal reports a
  perfectly good network on which every request fails; treating "connected" as
  "online" means refetching into a black hole.
• Focus is process lifecycle, not Activity focus — per-Activity focus fires
  on dialogs, permission prompts and the app switcher.
• The cache is bounded by count as well as time. A browser tab gets
  reloaded; an Android process can live for days.

What is not in it

Stated plainly, because a version number is a promise:

• Not on Maven Central — needs GPG signing and a Portal namespace
• Persistence is file-backed only. Benchmarked: 10 000 entries restore in
  3–5 ms, so this is not a startup problem. The cost is write amplification —
  every change rewrites the whole file
• Three tests need a device: R8 key-encoding survival, captive-portal
  detection, and Compose render paths
• Devtools, cross-process sync and streamed queries are specified and unbuilt

RELEASE.md is the
full inventory, including nine things deliberately not built and the reason for
each. Documentation is 22
pages, and every identifier in them is checked against the published API on
every build.

Apache-2.0. Feedback and bug reports very welcome — this is early.