Skip to content
HeliosDB HeliosDB Lite

HeliosDB-Lite v3.3.0 Release Notes

Previous Version: v3.2.0

Overview

HeliosDB-Lite v3.3.0 is a Code Quality & Stability Release focused on eliminating potential runtime panics and improving error handling throughout the production codebase. This release ensures panic-free operation in all critical paths.

Highlights

  • Zero Critical Panics: All critical and high-priority panic paths in production code have been eliminated
  • Graceful Error Recovery: New patterns for handling edge cases without crashing
  • Improved Safety Guarantees: Documented safety invariants throughout the codebase
  • 100% Backward Compatible: No API changes, drop-in replacement for v3.2.0

Changes

Critical Fixes

Mutex Poisoning Recovery

  • Before: Query execution statistics retrieval would panic if a mutex was poisoned (thread panic while holding lock)
  • After: Gracefully recovers data from poisoned mutex and marks execution state as failed
  • Impact: Query execution tracking never panics, even in catastrophic scenarios

High Priority Fixes

OpenAPI Error Responses

  • Before: Nested .expect() calls could panic on response building failures
  • After: Falls back to a minimal error response
  • Impact: API documentation endpoints never panic

SCRAM Authentication

  • Before: Zero iterations would cause panic
  • After: Falls back to minimum 4096 iterations (SCRAM-SHA-256 recommended minimum)
  • Impact: Authentication never panics on invalid input

Base64 Encoding

  • Before: .expect() on encoding operations
  • After: Safe default handling (Base64 to Vec cannot fail)
  • Impact: Authentication encoding never panics

Upgrade Guide

From v3.2.0

No action required. v3.3.0 is a drop-in replacement:

Terminal window
# Rebuild from the v3.3.0 licensed source distribution (no binary downloads)
cargo build --release


# Replace existing binary
sudo cp target/release/heliosdb-lite /usr/local/bin/


# Verify
heliosdb-lite repl

Breaking Changes

None. This is a stability release with no API changes.

Build Information

  • Binary Size: ~20MB (release build)
  • Rust Version: 1.75+
  • Target: x86_64-unknown-linux-gnu
  • Checksum: See releases/v3.3.0/heliosdb-lite.sha256

Contributors

  • HeliosDB Team