rails-paradedb 0.3.0 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f119945534d0ec4f358a9e05d85529d645dbd71e249a0456e65bbd70a7d63135
-  data.tar.gz: 7a9f56fe0eb2a0ea452697f90beeca5a58ca55b996c199fc08babbb14f10eb0c
+  metadata.gz: 2dac52ada2e15357193301cb0b3cf68bd0ef593794f972907c7ebf67cfa468f8
+  data.tar.gz: 99f3e0a8d0b18c1641e07bfe0e7098b2f19843de8910caa73c891b4ae3f42b9c
 SHA512:
-  metadata.gz: 1f98449702f8795645745b81bc344a1264946f8928e7bef804295a3bd15e468677414c85b266b2983ceb46aa558d9494f7933e0f770757cb0e31ff1d5fa39567
-  data.tar.gz: 3c2e6e60585532b13f3f810160ea77684274a1ba9ad7d7e878d037602bdb784edb2dbe773b66a87e21651671be121c3ba948fd7be38ee4e341c13ec151b7d1bd
+  metadata.gz: 020ae66713435adf05815a48581f1793a47ce5fabc1fd1abb2667408c18f99435eb915dac14d78afd3b566166cde0deb83af5177caecb8c9382c2317f667a983
+  data.tar.gz: 66c366c60656a2f494aefd0c0b050ea6fb8bcc57e7f3d9be270a9dabe75745bbec12ec7561531196c17f71bc3e3c59769515c1b43bb43e7c2b3fe961433cecaa

data/CHANGELOG.md

@@ -4,6 +4,13 @@ All notable changes to this project will be documented in this file. The format
 
 ## [Unreleased]
 
+## [0.4.0] - 2026-04-09
+
+### Changed
+
+- Removed unnecessary validation from non-exact aggregate queries without `over()`
+- `change` migrations now auto-reverse `create_paradedb_index` and `add_bm25_index`, while irreversible ParadeDB migration helpers raise explicit rollback errors
+
 ## [0.3.0] - 2026-03-23
 
 ### Removed
@@ -103,7 +110,8 @@ All notable changes to this project will be documented in this file. The format
 - Schema dump/load round-trip for tokenizer configuration and index options
   (including `target_segment_count`)
 
-[Unreleased]: https://github.com/paradedb/rails-paradedb/compare/v0.3.0...HEAD
+[Unreleased]: https://github.com/paradedb/rails-paradedb/compare/v0.4.0...HEAD
+[0.4.0]: https://github.com/paradedb/rails-paradedb/releases/tag/v0.4.0
 [0.3.0]: https://github.com/paradedb/rails-paradedb/releases/tag/v0.3.0
 [0.2.0]: https://github.com/paradedb/rails-paradedb/releases/tag/v0.2.0
 [0.1.0]: https://github.com/paradedb/rails-paradedb/releases/tag/v0.1.0

data/lib/parade_db/migration_helpers.rb

@@ -787,6 +787,41 @@ if defined?(ActiveRecord::ConnectionAdapters::AbstractAdapter)
   ActiveRecord::ConnectionAdapters::AbstractAdapter.include(ParadeDB::MigrationHelpers)
 end
 
+if defined?(ActiveRecord::Migration)
+  module ParadeDB
+    module MigrationDSL
+      def create_paradedb_index(index_klass, if_not_exists: false)
+        connection.create_paradedb_index(index_klass, if_not_exists: if_not_exists)
+      end
+
+      def replace_paradedb_index(index_klass)
+        connection.replace_paradedb_index(index_klass)
+      end
+
+      def add_bm25_index(table, fields:, key_field:, name: nil, index_options: nil, if_not_exists: false)
+        connection.add_bm25_index(
+          table,
+          fields: fields,
+          key_field: key_field,
+          name: name,
+          index_options: index_options,
+          if_not_exists: if_not_exists
+        )
+      end
+
+      def remove_bm25_index(table, name: nil, if_exists: false)
+        connection.remove_bm25_index(table, name: name, if_exists: if_exists)
+      end
+
+      def reindex_bm25(table, name: nil, concurrently: false)
+        connection.reindex_bm25(table, name: name, concurrently: concurrently)
+      end
+    end
+  end
+
+  ActiveRecord::Migration.include(ParadeDB::MigrationDSL)
+end
+
 if defined?(ActiveRecord::SchemaDumper)
   module ParadeDB
     module SchemaDumperPatch
@@ -829,3 +864,79 @@ if defined?(ActiveRecord::SchemaDumper)
 
   ActiveRecord::SchemaDumper.prepend(ParadeDB::SchemaDumperPatch)
 end
+
+if defined?(ActiveRecord::Migration::CommandRecorder)
+  module ParadeDB
+    module CommandRecorderPatch
+      %i[
+        create_paradedb_index
+        add_bm25_index
+        remove_bm25_index
+        replace_paradedb_index
+        reindex_bm25
+      ].each do |method_name|
+        define_method(method_name) do |*args, &block|
+          record(method_name, args, &block)
+        end
+        ruby2_keywords(method_name)
+      end
+
+      private
+
+      def invert_create_paradedb_index(args)
+        index_klass, = args
+        compiled = resolve_paradedb_index_klass(index_klass).compiled_definition
+        remove_options = Hash.ruby2_keywords_hash(name: compiled.index_name, if_exists: true)
+
+        [:remove_bm25_index, [compiled.table_name, remove_options]]
+      end
+
+      def invert_add_bm25_index(args)
+        table, options = args
+        options = symbolize_options_hash(options)
+
+        remove_options = { if_exists: true }
+        remove_options[:name] = options[:name] if options[:name]
+        remove_options = Hash.ruby2_keywords_hash(remove_options)
+
+        [:remove_bm25_index, [table, remove_options]]
+      end
+
+      def invert_remove_bm25_index(_args)
+        raise ActiveRecord::IrreversibleMigration,
+              "remove_bm25_index is not automatically reversible. Use #up/#down or #reversible."
+      end
+
+      def invert_replace_paradedb_index(_args)
+        raise ActiveRecord::IrreversibleMigration,
+              "replace_paradedb_index is not automatically reversible. Use #up/#down or #reversible."
+      end
+
+      def invert_reindex_bm25(_args)
+        raise ActiveRecord::IrreversibleMigration,
+              "reindex_bm25 is not automatically reversible. Use #up/#down or #reversible."
+      end
+
+      def resolve_paradedb_index_klass(index_klass)
+        case index_klass
+        when String
+          index_klass.to_s.split("::").inject(Object) { |ctx, const_name| ctx.const_get(const_name) }
+        else
+          index_klass
+        end
+      rescue NameError
+        raise ParadeDB::InvalidIndexDefinition, "Unknown index class #{index_klass.inspect}"
+      end
+
+      def symbolize_options_hash(options)
+        return {} unless options.is_a?(Hash)
+
+        options.each_with_object({}) do |(key, value), memo|
+          memo[key.to_sym] = value
+        end
+      end
+    end
+  end
+
+  ActiveRecord::Migration::CommandRecorder.prepend(ParadeDB::CommandRecorderPatch)
+end

data/lib/parade_db/search_methods.rb

@@ -397,10 +397,6 @@ module ParadeDB
 
     def facets_agg(exact: nil, **named_aggregations)
       validate_exact_option!(exact)
-      if exact == false
-        raise ArgumentError, "facets_agg(exact: false) requires with_agg so aggregation runs as a window function"
-      end
-
       agg_specs = normalize_named_aggregation_specs(named_aggregations)
       build_aggregation_query(agg_specs, exact: exact).execute
     end

data/lib/parade_db/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module ParadeDB
-  VERSION = "0.3.0"
+  VERSION = "0.4.0"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: rails-paradedb
 version: !ruby/object:Gem::Version
-  version: 0.3.0
+  version: 0.4.0
 platform: ruby
 authors:
 - ParadeDB