All notable changes to this project will be documented in this file. The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.
- Allow SQL/Arel function nodes as
match_allandmatch_anyquery arguments.
- BREAKING: Restrict match APIs to a single query argument.
- BREAKING: Rename relation query methods
matching_allandmatching_anytomatch_allandmatch_any.
0.8.0 - 2026-06-15
- BREAKING: The
Tokenizerclass is now namespaced asParadeDB::Tokenizer. Update references fromTokenizer.simple(...)toParadeDB::Tokenizer.simple(...). Schema dumps (schema.rb) now emit the fully-qualified constant.
0.7.0 - 2026-04-21
- BREAKING: Use function based approach for specifying tokenizers:
Tokenizer.simple(options: {alias: "description_simple"})
0.6.0 - 2026-04-14
- Support concurrent BM25 index creation via
concurrently:increate_paradedb_indexandadd_bm25_index
0.5.0 - 2026-04-14
- Support partial indexes via
where:inadd_bm25_indexandParadeDB::Index
- Allow aliased indexed expressions like
"(rating + 1)" => { alias: "rating" }
0.4.0 - 2026-04-09
- Removed unnecessary validation from non-exact aggregate queries without
over() changemigrations now auto-reversecreate_paradedb_indexandadd_bm25_index, while irreversible ParadeDB migration helpers raise explicit rollback errors
0.3.0 - 2026-03-23
- BREAKING: Removed
has_paradedb_indexclass attribute. It had no effect on library behavior. Removeself.has_paradedb_index = truefrom your models.
- BREAKING:
nearnow accepts a chainableParadeDB.proximity(...).within(...)clause to support the full proximity API
0.2.0 - 2026-03-13
- Rails 7.2 support and CI coverage
- New search/query APIs:
regex_phrase,phrase_prefix,parse, groupedaggregate_by, andParadeDB::Query.regex - Expanded snippet support with
with_snippetsandwith_snippet_positions - ParadeDB diagnostics helpers:
paradedb_indexes,paradedb_index_segments,paradedb_verify_index, andparadedb_verify_all_indexes - Additional aggregation helpers:
percentiles,histogram,date_histogram,top_hits, andfiltered - Support for passing regexes into proximity queries using
ParadeDB.regex_term
- Fuzzy search controls are now flattened across the relation and Arel
DSLs with direct
distance,prefix, andtransposition_cost_oneoptions matching_allandmatching_anynow accept explicittokenizer:overrides- Runtime index validation now includes index-class discovery, drift
checks, indexed-field validation, and model helpers for
paradedb_index_classes,paradedb_indexed_fields,paradedb_key_field, andparadedb_index_name - Facet and aggregation APIs now support
exact:controls for exact versus windowed execution - README, examples, and Arel documentation were expanded to cover the newer query, snippet, aggregation, and diagnostics APIs
- Search/runtime tokenizer handling now renders tokenizer SQL safely and validates unsupported tokenizer and facet combinations earlier
- BREAKING:
near_regexhas been removed in favor of callingnearwith a regex argument usingParadeDB.regex_term
0.1.0 - 2026-02-07
- Initial
rails-paradedbrelease. - ActiveRecord model integration with ParadeDB entrypoints:
search,more_like_this,with_facets,facets,with_agg, andfacets_agg - ActiveRecord relation search API with ParadeDB operators:
matching_all,matching_any,excluding,phrase,fuzzy,regex,term,near,phrase_prefix,more_like_this,parse,match_all exists,range, andterm_sethelpers across relation and Arel DSLswith_scoreandwith_snippetdecorators- Highlighting expansion with
with_snippetsandwith_snippet_positions - Faceting support:
facetsandwith_facets - Named aggregation helpers:
ParadeDB::Aggregations,facets_agg,with_agg, andaggregates - Arel integration with custom builder and visitor support
- BM25 index DSL with multi-tokenizer field configs, per-field options,
tokenizer aliases, and
index_options - Migration helper support for creating/replacing/removing/reindexing BM25
indexes (
create_paradedb_index,replace_paradedb_index,add_bm25_index,remove_bm25_index, andreindex_bm25) - Runtime safety checks for PostgreSQL adapter compatibility, index drift
validation mode (
:off,:warn,:raise), field-index validation, and class method collision detection - PostgreSQL adapter guards and integration test suite
- Runnable examples for quickstart, faceted search, autocomplete, more-like-this, hybrid RRF, and RAG
with_agg/facets_aggnow execute onepdb.agg(...)call per named aggregation to match ParadeDB aggregate parser constraints- README coverage was tightened for query and highlighting APIs
- Schema dump/load round-trip for tokenizer configuration and index options
(including
target_segment_count)