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.
- BREAKING: Removed
has_paradedb_indexclass attribute. It had no effect on library behavior. Removeself.has_paradedb_index = truefrom your models.
- BREAKING:
nearnow uses a symmetricleft_terms/right_termsAPI across the relation and Arel DSLs, and both operands now accept a string,ParadeDB.regex_term, or a mixed list of strings and regex terms
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)