TopGun
Get started

Changelog

TopGun follows Semantic Versioning (semver):

  • Major versions (X.0.0) introduce breaking changes to the public API or wire protocol
  • Minor versions (0.X.0) add new features in a backward-compatible manner
  • Patch versions (0.0.X) contain backward-compatible bug fixes

Releases

For the complete list of releases with detailed notes, visit the GitHub Releases page.

v0.13.0 — Data Platform (Intermediate)

New features and documentation for the v2.0 Data Platform milestone:

Unified Query API (breaking change):

  • client.query() now supports field projection (fields: string[]) and result limits (limit: number)
  • Efficient Merkle delta reconnect — on reconnect, only changed records are re-sent instead of the full result set
  • Writer exclusion — query subscribers no longer receive echo of their own writes
  • The separate Shapes API (subscribeShape()) has been removed; all partial replication features are now part of client.query()

New v2.0 features (server):

  • Schema system — TypeScript-first schema definition with server-side validation (@topgunbuild/core)
  • DataFusion SQL queries — SELECT, WHERE, GROUP BY, ORDER BY via Apache DataFusion (feature-gated: --features datafusion)
  • RSA JWT auto-detection — server automatically detects HMAC vs RSA/EC key format

Security fixes:

  • Re-enabled JWT expiration validation with configurable leeway
  • CORS origins default changed from wildcard to empty (deny-all)
  • Missing sub claim in JWT now rejected

Documentation:

  • New guide pages: Schema & Type Safety, SQL Queries, Troubleshooting, FAQ, Benchmarks, Tutorials (Todo App)
  • Updated Live Queries guide with field projection, limits, and Merkle reconnect
  • Fixed misleading auth/security/RBAC documentation
  • Brand color token system replacing hardcoded Tailwind classes

Updated packages: @topgunbuild/core, @topgunbuild/client, @topgunbuild/react

v1.0.0 — Launch Release

The first stable release of TopGun, featuring:

  • Rust server with all 7 domain services (CRDT, Sync, Query, Search, Messaging, Persistence, Coordination)
  • TypeScript client SDK (@topgunbuild/client) with offline-first LWWMap and ORMap CRDTs
  • React hooks (@topgunbuild/react) including useMap, useQuery, useMutation, useTopic
  • IndexedDB adapter (@topgunbuild/adapters) for browser-side persistence
  • PostgreSQL storage for server-side durability
  • Cluster protocol with 271-partition data distribution
  • Full-text search powered by Tantivy
  • MerkleTree delta sync for efficient reconnection
  • JWT authentication and role-based access control
  • Apache 2.0 license

Pre-release History

Development milestones leading to v1.0:

  • Phase 3: Rust server with all domain services, integration tests (TS client to Rust server)
  • Phase 2.5: Research sprint — storage architecture, cluster architecture, service patterns
  • Phase 2: Core Rust library — CRDTs, HLC, MerkleTree, message schema
  • Phase 1: TypeScript implementation — client SDK, React hooks, sync engine

Tracking Changes

  • GitHub Releases: github.com/topgunbuild/topgun/releases — detailed notes for every release
  • Commit log: Each commit follows the type(scope): description convention for easy scanning
  • Migration guides: Breaking changes in major versions include migration instructions in the release notes