bun-sqlite-for-rxdb 1.3.1 → 1.5.0

package/CHANGELOG.md

@@ -1,722 +0,0 @@
-# Changelog
-
-## [1.3.0] - 2026-02-26
-
-### Added
-- **Bun-optimized stable-stringify for deterministic JSON**
-  - Custom implementation optimized for Bun's JavaScriptCore engine
-  - 25x faster than baseline (536K ops/sec average)
-  - 49x faster for Mango queries (1.04M ops/sec)
-  - Eliminates cache key collisions between undefined and null
-  - Safe toJSON error handling (returns "[Error: message]" instead of crashing)
-
-### Performance 🔥
-- **stable-stringify optimizations: 10-65% faster**
-  - Small objects: +65% faster (691K → 1.1M ops/sec)
-  - Overall average: +10% faster (646K → 714K ops/sec)
-  - Optimized for common case (simple Mango queries with 5-20 keys)
-- **SQL query optimizations**
-  - Push ORDER BY/LIMIT/OFFSET to SQL layer (eliminates in-memory sorting overhead)
-  - Batch INSERT operations for better throughput
-- **Regex cache: O(1) FIFO eviction**
-  - Eliminates cache management overhead
-  - Constant-time eviction vs linear scan
-
-### Fixed 🔥
-- **Query cache collision between undefined and null**
-  - Fixed cache key collision where `{ age: undefined }` and `{ age: null }` produced identical keys
-  - stable-stringify now omits undefined values (matches JSON.stringify behavior)
-  - Prevents cache pollution and wrong SQL being returned
-  - 30x faster performance (645K ops/sec)
-- **toJSON error handling in stableStringify**
-  - Add callSafe helper to catch toJSON errors instead of crashing
-  - Returns "[Error: <message>]" format for failed toJSON calls
-  - Prevents application crashes from buggy toJSON implementations
-- **$elemMatch operator fixes**
-  - Handle non-operator fields and nested operators correctly
-  - Added 6 missing operators: $exists, $size, $mod, $not, $and, $or
-  - Fixed 3 edge cases: multi-field objects, nested object values, dot notation paths
-- **SQL operator precedence**
-  - Add proper parentheses for $or operator precedence (AND > OR in SQL)
-  - Fixed 3 test expectations that were checking for incorrect SQL
-- **Input validation to prevent data corruption crashes**
-  - Validate at function boundaries (buildWhereClause, processSelector, operators)
-  - Prevents crashes on null/undefined/wrong types
-  - Fixed 17 data corruption test failures
-- **Null checks in not-operators tests**
-  - Add proper null validation to prevent edge case failures
-
-### Changed
-- **Removed Mingo dependency**
-  - Simplified query routing by using ourMemory regex matcher for all fallback cases
-  - Eliminates 519 lines from lockfile
-  - Reduces bundle size and dependency complexity
-  - All regex queries now use custom LRU-cached matcher
-- **buildWhereClause now returns nullable**
-  - Returns null for untranslatable queries (cleaner API)
-  - Enables proper fallback to in-memory filtering
-  - Updated all unit tests for new signature
-
-### Technical Details
-- All 346 tests passing (17 data corruption tests fixed)
-- No regressions in query or write performance
-- stable-stringify uses manual loops (no .map() overhead)
-- Custom insertion sort for arrays <100 elements (threshold optimized)
-- Proper type safety: no `any` types in stable-stringify implementation
-- Query cache now properly handles undefined vs null distinction
-
----
-
-## [1.2.8] - 2026-02-25
-
-### Performance 🔥
-- **PRAGMA optimizations for read-heavy workloads**
-  - Added `PRAGMA mmap_size = 268435456` (256MB, configurable via `mmapSize` setting)
-  - Added `PRAGMA temp_store = MEMORY` (10-20% faster complex queries)
-  - Added `PRAGMA locking_mode = NORMAL` (multi-instance compatibility)
-  - 256MB mmap_size is industry standard (GrapheneOS, Android apps, desktop tools)
-  - Eliminates double-copy for reads, shares OS page cache directly
-
-### Added
-- **Configurable mmap_size setting**
-  - New `mmapSize` option in `BunSQLiteStorageSettings`
-  - Default: 268435456 bytes (256MB) - industry standard
-  - Set to 0 to disable (recommended for iOS)
-  - Automatically skipped for in-memory databases
-- **4 comprehensive behavior tests**
-  - Transaction queue prevents race conditions
-  - mmap_size improves read performance at scale
-  - temp_store MEMORY improves complex query performance
-  - mmapSize can be disabled without breaking functionality
-
-### Technical Details
-- mmap_size default validated against production libraries:
-  - GrapheneOS AttestationServer: 256MB
-  - WechatExporter: 256MB
-  - Android ArchiveTune: 256MB
-  - better-sqlite3 tests: Fresh DB per test pattern
-- temp_store = MEMORY: Keeps temporary tables/indexes in RAM
-- locking_mode = NORMAL: Allows multiple connections (vs EXCLUSIVE)
-- All 215 tests passing (211 + 4 behavior tests)
-- No regressions in query or write performance
-
----
-
-## [1.2.7] - 2026-02-25
-
-### Fixed 🔥
-- **Transaction queue for bulkWrite: Prevents race conditions**
-  - Added `sqliteTransaction()` helper to serialize concurrent writes
-  - Wraps bulkWrite in transaction queue (BEGIN IMMEDIATE → COMMIT/ROLLBACK)
-  - Prevents data corruption from parallel bulkWrite calls
-  - SQLite doesn't support concurrent writes - queue ensures serialization
-
-### Added
-- **7 comprehensive transaction queue tests**
-  - Tests for successful transactions, rollback on error
-  - Concurrent write serialization verification
-  - Race condition prevention tests
-  - Error preservation and handler result tests
-
-### Technical Details
-- Transaction queue uses WeakMap to track per-database queues
-- BEGIN IMMEDIATE ensures exclusive write lock
-- Automatic ROLLBACK on errors
-- All 211 tests passing (7 new transaction queue tests)
-- No performance regression (transactions were already implicit)
-
----
-
-## [1.2.6] - 2026-02-25
-
-### Performance 🔥
-- **Statement caching in all() and get(): 35% variance reduction**
-  - Added LRU statement caching to all() and get() methods
-  - Previously only run() had caching, causing 22% query variance
-  - queryEq: 5.43ms → 3.52ms StdDev (35% reduction)
-  - queryRepeated: 4.25ms → 3.87ms StdDev (9% reduction)
-  - 6.8x faster for cached queries (performance test)
-
-### Added
-- **Linus-style close() safety**
-  - close() now throws on use-after-close (prevents resource leaks)
-  - Matches industry standard (file handles, DB connections, streams)
-  - Prevents silent failures and memory leaks
-- **20 comprehensive StatementManager tests**
-  - Cache hits/misses, LRU eviction, boundary conditions
-  - Multiple managers isolation, statement finalization
-  - Stress tests: 10k queries in 81ms (8.17µs per query)
-
-### Technical Details
-- Statement cache uses same LRU pattern as run() method
-- MAX_STATEMENTS = 500 with proper finalization on eviction
-- close() sets flag and throws Error on subsequent use
-- All 204 tests passing (20 new StatementManager tests)
-- No regressions in query or write performance
-
----
-
-## [1.2.5] - 2026-02-25
-
-### Performance 🔥
-- **Bounded statement cache: Prevents memory leaks**
-  - Added MAX_STATEMENTS = 500 with LRU eviction
-  - Calls finalize() on evicted statements to free resources
-  - No performance regression - cache hit path unchanged
-- **bulkWrite(100) optimization: 2.1x faster**
-  - 3.83ms → 1.82ms (Phase 1 PRAGMA optimizations showing impact at scale)
-
-### Changed
-- **Document cache removed** (Phase 2 Iteration 5)
-  - Industry research: PouchDB, Dexie, LokiJS, WatermelonDB don't use document-level caching
-  - SQLite page cache (PRAGMA cache_size = -32000) is sufficient
-  - Simpler architecture, no cache invalidation complexity
-
-### Fixed
-- **Timing test reliability on Windows**
-  - Switched from performance.now() to process.hrtime.bigint() for nanosecond precision
-  - Fixes flaky tests caused by ~1ms resolution on Windows
-  - Applied to "Production Scenario 3" and "Edge Case 13" tests
-
-### Added
-- bulkWrite(100) benchmark test to measure Phase 2 impact at scale
-
-### Technical Details
-- Statement cache bounded at 500 entries (prevents unbounded growth)
-- LRU eviction: moves accessed statements to end, evicts oldest
-- All 184 tests passing with reliable timing
-- No regressions in query or write performance
-
----
-
-## [1.2.4] - 2026-02-25
-
-### Performance 🔥
-- **count() optimization: 4.5x faster at scale**
-  - Fixed to use `SELECT COUNT(*)` instead of fetching all documents
-  - 10k docs: 21.74ms → 5.03ms (4.32x faster)
-  - 100k docs: 219.44ms → 48.41ms (4.53x faster)
-- **PRAGMA optimizations: 2x faster writes**
-  - Added `PRAGMA wal_autocheckpoint = 1000` (+12% write performance)
-  - Added `PRAGMA cache_size = -32000` (32MB cache for better query performance)
-  - Added `PRAGMA analysis_limit = 400` (faster query planning)
-  - bulkWrite: 0.36ms → 0.18ms (2x faster for single doc)
-- **Query cache increase: 500 → 1000**
-  - Prevents cache thrashing in multi-collection apps
-  - Supports 5-10 collections × 10-20 queries each
-
-### Added
-- Comprehensive Phase 1 benchmark suite (200 runs @ 10k docs, 100 runs @ 100k docs)
-- Optimization journey documentation with baseline results and Phase 2-4 roadmap
-
-### Technical Details
-- count() changed from O(n) to O(1) complexity
-- All optimizations verified with 260/260 tests passing
-- No regressions in query performance (1.01-1.03x, within margin of error)
-- Low standard deviation confirms stable, reliable results
-
----
-
-## [1.2.3] - 2026-02-25
-
-### Changed
-- **Code Organization**
-  - Reorganized tests into unit/integration/benchmarks structure
-  - Added TypeScript path aliases ($app/* → src/*) for cleaner imports
-  - Updated all test imports to use path aliases
-  - Eliminated all `any` types from core modules (src/)
-  - Removed obsolete test files and old benchmark directory
-
-### Technical Details
-- Zero `any` types in src/ (instance.ts, rxdb-helpers.ts, statement-manager.ts, builder.ts)
-- Proper TypeScript types: `SQLQueryBindings[]`, `RxAttachmentData`, generic `all<T>()`
-- Test structure: test/unit/, test/unit/operators/, test/integration/, test/benchmarks/
-- Path aliases configured in tsconfig.json
-
-### Test Results
-- 181/184 tests passing (3 pre-existing regex bugs)
-- All type safety improvements verified
-
----
-
-## [1.2.2] - 2026-02-24
-
-### Fixed
-- **$type Operator** (SQL Translation)
-  - Fixed translateType() signature: now requires jsonColumn, fieldName, and type parameters
-  - Rewritten to use SQLite's json_type() for all 6 RxDB types (was using typeof() for only 3)
-  - All types now translate to SQL: null, boolean, number, string, array, object
-  - Removed redundant canTranslateToSQL check (all types now supported)
-  - Fixed TypeScript error: "Expected 3 arguments, but got 2"
-
-### Changed
-- **Architecture Simplification**
-  - Removed redundant ternary in translateType() (both branches identical)
-  - Cleaner jsonPath construction: `$.${fieldName}`
-
-### Test Results
-- 181/184 tests passing (3 pre-existing regex bugs unrelated to $type)
-- All 6 $type operator tests passing
-
----
-
-## [1.2.1] - 2026-02-24
-
-### Added
-- **$elemMatch with $and/$or/$nor** (SQL Fast Path)
-  - Implemented nested logical operators inside $elemMatch queries
-  - Uses single EXISTS pattern with combined WHERE clause (SQLite best practice)
-  - Eliminates Mingo fallback for complex array matching
-  - 8 integration tests for $elemMatch with logical operators
-
-### Changed
-- **Architecture Simplification**
-  - Removed redundant $and/$or/$nor validation from canTranslateToSQL()
-  - Simplified routing logic (processSelector handles all cases)
-
-### Performance
-- $elemMatch with $and: ~24.44ms (SQL fast path)
-- $elemMatch with $or: ~25.23ms (SQL fast path)
-- $elemMatch with $nor: ~25.33ms (SQL fast path)
-
-### Test Results
-- 8/8 new integration tests passing
-- 180/183 total tests passing (3 pre-existing regex bugs)
-
----
-
-## [1.2.0] - 2026-02-24
-
-### Added
-- **$elemMatch Operator** (SQL Translation)
-  - Implemented with EXISTS + json_each() pattern
-  - Supports simple field matching inside arrays
-  - Foundation for nested logical operators
-- **$type Array Operator**
-  - Added json_type check for 'array' type detection
-  - Completes $type operator support
-- **ourMemory Regex Matcher**
-  - Custom LRU-cached regex matcher (100 entries, 53 lines)
-  - Replaces Mingo for simple case-insensitive $regex queries
-  - Expression index support: LOWER(field) parsing
-  - 6.1% performance improvement (37.41ms → 35.11ms)
-- **Mingo Routing Architecture**
-  - Added canTranslateToSQL() for intelligent query routing
-  - SQL fast path for translatable queries
-  - Mingo fallback for complex patterns
-  - Schema-aware query builder
-
-### Changed
-- **Query Builder Schema-Aware**
-  - translateRegex() now accepts schema and fieldName parameters
-  - Enables expression index detection
-  - Better optimization decisions
-
-### Fixed
-- Disabled case-insensitive regex translation to SQL (correctness over performance)
-
-### Performance
-- ourMemory regex matcher: 6.1% faster than Mingo (37.41ms → 35.11ms)
-- $elemMatch: SQL fast path for simple queries
-
-### Test Results
-- Comprehensive array edge case tests added
-- All $type array tests passing
-
----
-
-## [1.1.4] - 2026-02-24
-
-### Fixed
-- **$nor Operator Bug** (Critical)
-  - Fixed $nor generating raw field names instead of json_extract() paths
-  - Was causing "no such column" SQLite errors
-  - Now schema-aware and handles JSONB storage correctly
-- **Query Cache Collision** (Critical)
-  - Fixed cache collisions between different collections
-  - Cache key now includes collectionName: `v${version}_${collectionName}_${selector}`
-  - Prevents wrong SQL being used across collections with same schema
-
-### Changed
-- **DRY Refactor: Unified $or/$nor Handling**
-  - Created `buildLogicalOperator()` helper for both operators
-  - Eliminated code duplication (15 lines of inline $or code)
-  - Both operators now use same schema-aware logic
-- **buildWhereClause Signature**
-  - Added `collectionName` as 3rd parameter
-  - Ensures cache isolation between collections
-  - All unit tests updated for new signature
-
-### Added
-- **DEBUG_QUERIES Logging**
-  - Added fallback error logging via `DEBUG_QUERIES=1` env var
-  - Helps debug which queries trigger fallback path
-- **Comprehensive Integration Tests**
-  - 27 new integration tests for all SQL operators
-  - Covers: $eq, $ne, $gt, $gte, $lt, $lte, $in, $nin, $exists, $regex (simple), $and, $or, $not, $nor, $type (simple), $size, $mod
-  - Tests include edge cases and complex nested queries
-- **TDD Tests for Complex Operators**
-  - 6 failing tests documenting fallback bug
-  - Tests for: complex $regex (character classes, flags), $elemMatch, $type (array/object)
-  - Will pass once Mingo fallback is implemented
-
-### Test Results
-- **Local tests: 162/162 pass (100%)** ✅
-- **Failing tests: 6/6 (expected - TDD tests for Mingo fallback)** ⏳
-- All SQL operators working correctly
-- $nor bug fixed and tested
-
-### Technical Details
-- Removed broken `translateNor()` function
-- Kept `processOperatorValue()` (used by `translateNot()`)
-- Cache key now: `v${schema.version}_${collectionName}_${stringify(selector)}`
-- RxDB integration verified: `this.collectionName` available and passed correctly
-
----
-
-## [1.1.0] - 2026-02-23
-
-### Added
-- **schema.indexes Support** (v1.1.0)
-  - Dynamic index creation from schema.indexes definitions
-  - Supports single-field indexes: `['age']`
-  - Supports compound indexes: `['age', 'status']`
-  - Uses `json_extract()` for JSONB fields
-  - Proper index naming: `idx_users_v0_age_status`
-  - 9 lines of implementation code
-  - Research validated: 4/5 RxDB storage plugins implement this
-
-### Changed
-- **ORDER BY Optimization** (v1.1.0)
-  - Removed redundant SQL `ORDER BY id` (we sort in-memory anyway)
-  - Eliminates temp B-tree overhead in SQLite
-  - Research finding: We already sort at line 226, SQL ORDER BY was redundant
-
-### Performance
-- **29.8% faster queries** (165.43ms → 116.09ms avg on 100k docs)
-  - Test 1 (age > 50): 20.6% faster
-  - Test 2 (status = "active"): 22.1% faster
-  - Test 3 (age > 30 AND status): 26.8% faster
-  - Test 4 (age BETWEEN 25-35): 51.5% faster!
-
-### Test Results
-- **Local tests: 138/138 pass (100%)** ✅
-- **Official RxDB tests: 122/122 pass (100%)** ✅
-- **Total: 260/260 tests pass (100%)** 🎉
-
-### Research
-- **3 research agents deployed** (2 codebase + 1 web)
-  - Verified implementation correctness vs other RxDB storages
-  - Analyzed ORDER BY patterns in storage plugins
-  - Researched SQLite covering indexes and optimization
-- **Key findings:**
-  - Our implementation matches standard RxDB patterns
-  - Better than official SQLite Trial (which has no indexes)
-  - ORDER BY id was causing temp B-tree overhead
-  - Removing it eliminated redundant sorting
-
-### Documentation
-- Added Pattern #28: schema.indexes Support
-- Added Pattern #29: ORDER BY Optimization
-- Updated ROADMAP.md with implementation results
-
----
-
-## [1.0.1] - 2026-02-23
-
-### Added
-- **EXPLAIN QUERY PLAN Debug Mode** (Development Tool)
-  - Activated via `DEBUG_QUERIES=1` environment variable
-  - Logs query plans, SQL, and args to console
-  - Helps verify query builder generates optimal SQL
-  - Validates SQLite index usage
-  - Zero production overhead (env var check only)
-
-### Usage
-```bash
-DEBUG_QUERIES=1 bun test
-```
-
----
-
-## [1.0.0] - 2026-02-23
-
-### Added
-- **Attachments Support** (Phase 4)
-  - Storage-level implementation with 4 comprehensive tests
-  - `getAttachmentData()` returns base64 strings with digest validation
-  - Preserves `_attachments` metadata in documents
-  - Attachments table with composite keys (documentId||attachmentId)
-  - 122/122 official RxDB tests passing (includes 5 attachment tests)
-- **RxDB Helper Functions** (Phase 4)
-  - `categorizeBulkWriteRows()` - Battle-tested conflict detection + attachment extraction
-  - `stripAttachmentsDataFromDocument()` - Remove attachment .data field, keep metadata
-  - `stripAttachmentsDataFromRow()` - Strip attachments from bulk write rows
-  - `attachmentWriteDataToNormalData()` - Convert attachment write format to storage format
-  - `getAttachmentSize()` - Calculate attachment size from base64
-
-### Changed
-- **bulkWrite Refactored** - Now uses `categorizeBulkWriteRows()` helper
-  - Cleaner architecture with proper conflict handling
-  - Automatic attachment extraction
-  - Matches official adapter patterns (Dexie, MongoDB, SQLite)
-
-### Test Results
-- **Local tests: 138/138 pass (100%)** ✅
-- **Official RxDB tests: 122/122 pass (100%)** ✅
-- **Total: 260/260 tests pass (100%)** 🎉
-
-### Performance
-- Database operations: 1.06-1.68x faster than better-sqlite3
-- Query builder cache: 5.2-57.9x speedup for cached queries
-- All optimizations from v0.4.0 included
-
-### Documentation
-- Updated ROADMAP.md - Phase 4 marked COMPLETE
-- Removed redundant Phase 4 TDD implementation details
-- All helper functions documented with line numbers
-
----
-
-## [0.4.0] - 2026-02-23
-
-### Added
-- **Query Builder LRU Cache** (Phase 2.5)
-  - 5.2-57.9x speedup for repeated queries
-  - High-frequency: 505K-808K queries/sec
-  - Bounded at 500 entries (no memory leak)
-  - True LRU eviction with canonical key generation (fast-stable-stringify)
-  - Zero dependencies except fast-stable-stringify (5KB)
-- **RxDB Official Test Suite Integration** (Phase 3.1)
-  - 112/112 official RxDB tests passing (100%)
-  - StatementManager abstraction for automatic statement lifecycle
-  - Connection pooling with reference counting for multi-instance support
-  - Official `addRxStorageMultiInstanceSupport()` integration
-  - Composite primary key support
-  - Bun test suite compatibility (Mocha through Bun)
-- **Performance Benchmarks** (Phase 3.2)
-  - Bun:sqlite 1.06-1.68x faster than better-sqlite3
-  - Benchmarked at 1M documents with WAL + PRAGMA synchronous = 1
-  - Query builder cache benchmarks
-  - Raw database comparison benchmarks
-- **New Query Operators** (8 operators added)
-  - `$exists` - Field existence check with IS NULL/IS NOT NULL
-  - `$regex` - Pattern matching with LIKE translation and Mingo fallback
-  - `$elemMatch` - Array element matching (Mingo fallback)
-  - `$not` - Negation operator
-  - `$nor` - Logical NOR
-  - `$type` - Type checking with typeof()
-  - `$size` - Array size with json_array_length()
-  - `$mod` - Modulo operations
-
-### Changed
-- **BREAKING**: Statement lifecycle management
-  - Static SQL uses db.query() (cached, max 20)
-  - Dynamic SQL uses db.prepare() + finalize() (no cache pollution)
-  - StatementManager abstraction eliminates manual try-finally boilerplate
-- Connection pooling now mandatory for multi-instance support
-- Switched from custom multi-instance to RxDB's official implementation
-
-### Fixed
-- Statement resource leaks (7 locations in instance.ts)
-- Collection isolation bug (events leaked across collections)
-- Composite primary key handling (string vs object format)
-- EventBulk.id generation (empty string → unique timestamp + random)
-- Multi-instance event propagation via BroadcastChannel
-- Bun test suite compatibility (node:sqlite import, test globals)
-
-### Performance
-- Query builder cache: 5.2-57.9x speedup for cached queries
-- Database operations: 1.06-1.68x faster than better-sqlite3
-- No OOM errors (proper statement finalization)
-- Tests complete in 12.91s (no hangs)
-
-### Test Results
-- **Local tests: 134/134 pass (100%)**
-- **Official RxDB tests: 112/112 pass (100%)**
-- **Total: 246/246 tests pass (100%)** 🎉
-
-### Documentation
-- Added `docs/id1-testsuite-journey.md` - Complete debugging journey (15 iterations)
-- Added `docs/official-test-suite-setup.md` - Guide for running RxDB tests with Bun
-- Updated `docs/architectural-patterns.md` - Added patterns 15-24
-- Updated `ROADMAP.md` - Phase 2.5 and 3.2 marked COMPLETE, Phase 4 marked READY
-
-### Technical Debt Resolved
-- Statement lifecycle properly managed (no leaks)
-- Connection pooling with reference counting
-- Test architecture at correct level (RxDatabase for integration, storage for low-level)
-- Proper separation of concerns (we handle DB pooling, RxDB handles event coordination)
-
----
-
-## [0.3.1] - 2026-02-22
-
-### Added
-- **JSONB Storage**: Implemented SQLite's native binary JSON format as default storage
-  - 1.57x faster complex queries (657ms → 418ms at 1M docs)
-  - 1.20x faster read + parse operations
-  - 1.04x faster simple queries
-  - Uses `jsonb()` on INSERT, `json()` on SELECT
-- **Smart Regex Optimization**: Convert simple regex patterns to SQL operators
-  - 2.03x faster exact matches (^text$ → = operator)
-  - 1.23x faster case-insensitive (COLLATE NOCASE vs LOWER())
-  - Overall 1.24x speedup across all patterns
-- **Regression Tests**: Added tests for % and _ escaping edge cases
-
-### Fixed
-- Critical bug: Missing % and _ escaping in case-insensitive exact match regex patterns
-
-### Investigated
-- **FTS5 Trigram Indexes**: Benchmarked at 100k and 1M scales
-  - Result: 1.5-1.79x SLOWER at our scale
-  - Decision: NOT implemented (only beneficial at 10M+ rows)
-  - Documented findings in architectural-patterns.md
-
-### Performance
-- Complex queries: 1.57x faster (JSONB)
-- Exact match regex: 2.03x faster (smart optimization)
-- Read operations: 1.20x faster (JSONB)
-
----
-
-## [0.3.0] - 2026-02-22
-
-### Added
-- **Advanced Query Operators** (4 new operators)
-  - `$in` - Value in array (80% usage in production)
-  - `$nin` - Value not in array
-  - `$or` - Logical OR with proper parentheses handling
-  - `$and` - Explicit logical AND
-- NULL handling for `$in` / `$nin` operators
-- Recursive query builder with `logicalDepth` tracking
-- 13 new tests for advanced operators
-
-### Performance
-- Benchmark results (10k documents):
-  - Average query time: 27.39ms
-  - Supports complex nested queries: `{$or: [{$and: [...]}, {field: {$in: [...]}}]}`
-
-### Technical
-- DRY architecture: Pure operator functions, recursive builder
-- Type-safe: 0 `any` types, proper TypeScript throughout
-- Test coverage: 44/44 tests passing
-
-## [0.2.0] - 2026-02-22
-
-### Added
-- Conflict detection for concurrent writes
-  - Catches UNIQUE constraint violations
-  - Returns 409 status with existing document
-  - Enables proper RxDB replication conflict handling
-
-### Changed
-- **BREAKING**: `bulkWrite` now uses individual INSERT statements instead of INSERT OR REPLACE
-  - Conflicts are now detected and returned as errors
-  - Enables proper RxDB replication conflict resolution
-
-### Performance
-- Benchmark results (10k documents, 10-run average):
-  - **JSON + TEXT: 23.40ms** (WINNER)
-  - Tested alternatives: MessagePack (137ms), bun:jsc (37ms)
-  - **Verdict: Bun's SIMD-accelerated JSON is fastest**
-
-### Research Notes
-- Extensively tested binary serialization formats (MessagePack, bun:jsc)
-- MessagePack: 5.6x slower than JSON (pure JS implementation)
-- bun:jsc (optimized): 1.58x slower than JSON (Structured Clone overhead)
-- **Conclusion: JSON + TEXT is optimal for Bun's architecture**
-
-## [0.1.2] - 2026-02-22
-
-### Added
-- Conflict detection for concurrent writes
-  - Catches UNIQUE constraint violations
-  - Returns 409 status with existing document
-  - Enables proper RxDB replication conflict handling
-
-### Changed
-- **BREAKING**: `bulkWrite` now uses individual INSERT statements instead of INSERT OR REPLACE
-  - Conflicts are now detected and returned as errors
-  - Enables proper RxDB replication conflict resolution
-
-### Performance
-- Benchmark results (10k documents):
-  - Simple equality: 15.40ms
-  - Greater than: 22.05ms
-  - Multiple conditions: 23.51ms
-  - Range query: 24.89ms
-  - Average: 21.46ms
-
-## [0.1.2] - 2026-02-22
-
-### Added
-- WAL mode for 3-6x write speedup and better concurrency
-  - Automatically enabled for file-based databases
-  - Skipped for in-memory databases (not supported by SQLite)
-- Proper checkpoint implementation in changeStream
-  - Checkpoint structure: `{ id: documentId, lwt: timestamp }`
-  - Enables efficient replication tracking
-
-### Removed
-- **BREAKING**: Removed `conflictResultionTasks()` method (doesn't exist in RxDB interface)
-- **BREAKING**: Removed `resolveConflictResultionTask()` method (doesn't exist in RxDB interface)
-  - Conflict resolution happens at RxDB replication level, not storage level
-
-### Changed
-- WAL mode test now uses file-based database instead of in-memory
-
-### Performance
-- Write operations: 3-6x faster with WAL mode
-- Concurrent reads during writes: No blocking with WAL mode
-
-## [0.1.1] - 2026-02-22
-
-### Added
-- SQL query builder for WHERE clause generation (10-100x speedup)
-  - 6 Mango operators: `$eq`, `$ne`, `$gt`, `$gte`, `$lt`, `$lte`
-  - Functional architecture (pure functions, no state)
-  - Column mapping for RxDB internal fields
-  - Fallback to in-memory filtering if WHERE fails
-- Benchmark script for performance testing
-- Comprehensive test suite (27 tests total)
-  - 19 storage tests
-  - 6 operator tests
-  - 10 query builder tests
-
-### Changed
-- **BREAKING**: Removed per-document error handling in `bulkWrite`
-  - Now uses atomic transactions (all or nothing)
-  - Entire batch fails if any document fails
-- Removed ALL `any` types (32 instances → 0)
-- Proper TypeScript types throughout
-  - `RxStorage<BunSQLiteInternals, BunSQLiteStorageSettings>`
-  - `RxStorageInstance` with proper type parameters
-  - `PreparedQuery<RxDocType>` for queries
-  - `RxStorageWriteError<RxDocType>` for errors
-
-### Fixed
-- Type safety: Zero `any` types in entire codebase
-- Test isolation: Reference folder excluded from test runs
-- Schema types: Proper RxDB internal fields in all schemas
-
-### Performance
-- Query performance: ~20ms average for 10k documents
-- Uses SQL WHERE clauses with indexed columns
-- Expected 10-100x speedup vs in-memory filtering
-
-## [0.1.0] - 2026-02-20
-
-### Added
-- Initial RxDB storage adapter for Bun's native SQLite
-- Basic CRUD operations (bulkWrite, query, findById, count)
-- Atomic transactions via `bun:sqlite`
-- In-memory Mango query filtering
-- Streak tracking support
-- Change stream for reactivity
-- 8 passing tests
-
-### Features
-- SQLite via `bun:sqlite` (no external dependencies)
-- RxDB v16 and v17 beta support
-- MIT licensed