---
title: "HeliosDB-Lite v3.3.0 Release Notes"
---

# 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:

```bash
# 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

---

## Links

- [HeliosDB Lite product page](https://www.heliosdb.com/lite.html)
- [Previous Release (v3.2.0)](https://www.heliosdb.com/docs/lite/releases/v32/release_notes_v32/)