search-engine-for-typesense 30.1.0 → 30.1.1

data/lib/search_engine/relation/compiler.rb

@@ -1,5 +1,7 @@
 # frozen_string_literal: true
 
+require 'set'
+
 module SearchEngine
   class Relation
     # Compile immutable relation state and options into Typesense body params.
@@ -11,7 +13,7 @@ module SearchEngine
       # redaction-aware instrumentation events for DX surfaces.
       #
       # @return [SearchEngine::CompiledParams] deterministic, deeply frozen params
-      # @see `https://nikita-shkoda.mintlify.app/projects/search-engine-for-typesense/query-dsl`
+      # @see `https://nikita-shkoda.mintlify.app/projects/search-engine-for-typesense/v30.1/query-dsl`
       # @see `https://typesense.org/docs/latest/api/documents.html#search-document`
       def to_typesense_params
         cfg = SearchEngine.config
@@ -80,7 +82,7 @@ module SearchEngine
       # Compile filter_by string from AST nodes or legacy fragments.
       # @param ast_nodes [Array<SearchEngine::AST::Node>]
       # @return [String, nil] a Typesense filter string or nil when absent
-      # @see `https://nikita-shkoda.mintlify.app/projects/search-engine-for-typesense/compiler`
+      # @see `https://nikita-shkoda.mintlify.app/projects/search-engine-for-typesense/v30.1/compiler`
       def compiled_filter_by(ast_nodes)
         unless ast_nodes.empty?
           compiled = SearchEngine::Compiler.compile(ast_nodes, klass: @klass)
@@ -184,8 +186,9 @@ module SearchEngine
         applied = Array(@state[:joins])
         return {} if applied.empty?
 
+        seen = Set.new
         assocs = []
-        applied.each { |a| assocs << a unless assocs.include?(a) }
+        applied.each { |a| assocs << a if seen.add?(a) }
 
         nested_map = @state[:select_nested] || {}
         nested_order = Array(@state[:select_nested_order])
@@ -219,6 +222,7 @@ module SearchEngine
         list = Array(nodes).flatten.compact
         return [] if list.empty?
 
+        seen_set = Set.new
         seen = []
         walker = lambda do |node|
           return unless node.is_a?(SearchEngine::AST::Node)
@@ -229,7 +233,7 @@ module SearchEngine
               m = field.match(/^\$(\w+)\./)
               if m
                 name = m[1].to_sym
-                seen << name unless seen.include?(name)
+                seen << name if seen_set.add?(name)
               end
             end
           end
@@ -248,6 +252,7 @@ module SearchEngine
         list = Array(orders).flatten.compact
         return [] if list.empty?
 
+        seen_set = Set.new
         seen = []
         list.each do |entry|
           field, _dir = entry.to_s.split(':', 2)
@@ -257,7 +262,7 @@ module SearchEngine
           next unless m
 
           name = m[1].to_sym
-          seen << name unless seen.include?(name)
+          seen << name if seen_set.add?(name)
         end
         seen
       end
@@ -600,7 +605,7 @@ module SearchEngine
       rescue StandardError => error
         raise SearchEngine::Errors::InvalidOption.new(
           "InvalidOption: ranking options could not be compiled (#{error.class}: #{error.message})",
-          doc: 'https://nikita-shkoda.mintlify.app/projects/search-engine-for-typesense/ranking#options'
+          doc: 'https://nikita-shkoda.mintlify.app/projects/search-engine-for-typesense/v30.1/ranking#options'
         )
       end
 

data/lib/search_engine/relation/dsl/filters.rb

@@ -169,7 +169,7 @@ module SearchEngine
             raise SearchEngine::Errors::InvalidParams.new(
               "merge: cannot infer association for #{other.klass}",
               hint: 'Declare a collection on the joined model or pass assoc: :name',
-              doc: 'https://nikita-shkoda.mintlify.app/projects/search-engine-for-typesense/joins#troubleshooting'
+              doc: 'https://nikita-shkoda.mintlify.app/projects/search-engine-for-typesense/v30.1/joins#troubleshooting'
             )
           end
 
@@ -180,7 +180,7 @@ module SearchEngine
             raise SearchEngine::Errors::InvalidParams.new(
               "merge: no join association for #{collection_name} on #{klass_name_for_inspect}",
               hint: "#{hint} Pass assoc: :name to disambiguate.",
-              doc: 'https://nikita-shkoda.mintlify.app/projects/search-engine-for-typesense/joins#troubleshooting',
+              doc: 'https://nikita-shkoda.mintlify.app/projects/search-engine-for-typesense/v30.1/joins#troubleshooting',
               details: { target_collection: collection_name, available: cfgs.keys }
             )
           end
@@ -190,7 +190,7 @@ module SearchEngine
             raise SearchEngine::Errors::InvalidParams.new(
               "merge: ambiguous association for #{collection_name} on #{klass_name_for_inspect}",
               hint: "Pass assoc: :#{names.first} (available: #{names.map(&:inspect).join(', ')})",
-              doc: 'https://nikita-shkoda.mintlify.app/projects/search-engine-for-typesense/joins#troubleshooting',
+              doc: 'https://nikita-shkoda.mintlify.app/projects/search-engine-for-typesense/v30.1/joins#troubleshooting',
               details: { target_collection: collection_name, matches: names }
             )
           end
@@ -207,7 +207,7 @@ module SearchEngine
               raise SearchEngine::Errors::InvalidParams.new(
                 "merge: expected a join scope Symbol or Array<Symbol> for #{assoc.inspect}",
                 hint: 'Use merge(assoc: :scope) or merge(assoc: [:scope1, :scope2])',
-                doc: 'https://nikita-shkoda.mintlify.app/projects/search-engine-for-typesense/query-dsl#join-scope',
+                doc: 'https://nikita-shkoda.mintlify.app/projects/search-engine-for-typesense/v30.1/query-dsl#join-scope',
                 details: { assoc: assoc, value: scope_value }
               )
             end
@@ -350,7 +350,7 @@ module SearchEngine
             unless target_klass.respond_to?(sym)
               raise SearchEngine::Errors::InvalidParams.new(
                 %(Unknown join-scope :#{sym} on association :#{assoc} for #{target_klass}),
-                doc: 'https://nikita-shkoda.mintlify.app/projects/search-engine-for-typesense/query-dsl#join-scope'
+                doc: 'https://nikita-shkoda.mintlify.app/projects/search-engine-for-typesense/v30.1/query-dsl#join-scope'
               )
             end
 
@@ -358,7 +358,7 @@ module SearchEngine
             unless rel.is_a?(SearchEngine::Relation)
               raise SearchEngine::Errors::InvalidParams.new(
                 %(join-scope :#{sym} on :#{assoc} must return a SearchEngine::Relation (got #{rel.class})),
-                doc: 'https://nikita-shkoda.mintlify.app/projects/search-engine-for-typesense/query-dsl#join-scope'
+                doc: 'https://nikita-shkoda.mintlify.app/projects/search-engine-for-typesense/v30.1/query-dsl#join-scope'
               )
             end
 
@@ -397,7 +397,7 @@ module SearchEngine
             if fragment.include?('$')
               raise SearchEngine::Errors::InvalidParams.new(
                 'join-scope raw fragments must use base fields only (no nested join paths)',
-                doc: 'https://nikita-shkoda.mintlify.app/projects/search-engine-for-typesense/query-dsl#join-scope',
+                doc: 'https://nikita-shkoda.mintlify.app/projects/search-engine-for-typesense/v30.1/query-dsl#join-scope',
                 details: { fragment: fragment, assoc: assoc_sym }
               )
             end
@@ -416,7 +416,7 @@ module SearchEngine
             if lhs.start_with?('$') || lhs.include?('.')
               raise SearchEngine::Errors::InvalidParams.new(
                 %(join-scope cannot reference nested join field #{lhs.inspect}; use base fields only),
-                doc: 'https://nikita-shkoda.mintlify.app/projects/search-engine-for-typesense/query-dsl#join-scope',
+                doc: 'https://nikita-shkoda.mintlify.app/projects/search-engine-for-typesense/v30.1/query-dsl#join-scope',
                 details: { field: lhs, assoc: assoc_sym }
               )
             end
@@ -553,7 +553,7 @@ module SearchEngine
         def raise_empty_array_type!(field_sym)
           raise SearchEngine::Errors::InvalidType.new(
             %(expected #{field_sym.inspect} to be a non-empty Array),
-            doc: 'https://nikita-shkoda.mintlify.app/projects/search-engine-for-typesense/query-dsl#troubleshooting',
+            doc: 'https://nikita-shkoda.mintlify.app/projects/search-engine-for-typesense/v30.1/query-dsl#troubleshooting',
             details: { field: field_sym }
           )
         end

data/lib/search_engine/relation/dsl/selection.rb

@@ -9,7 +9,7 @@ module SearchEngine
         # Select a subset of fields for Typesense `include_fields`.
         # @param fields [Array<Symbol,String,Hash,Array>]
         # @return [SearchEngine::Relation]
-        # @see `https://nikita-shkoda.mintlify.app/projects/search-engine-for-typesense/field-selection`
+        # @see `https://nikita-shkoda.mintlify.app/projects/search-engine-for-typesense/v30.1/field-selection`
         def select(*fields)
           normalized = normalize_select_input(fields)
           spawn do |s|
@@ -46,7 +46,7 @@ module SearchEngine
         # Exclude a subset of fields from the final selection.
         # @param fields [Array<Symbol,String,Hash,Array>]
         # @return [SearchEngine::Relation]
-        # @see `https://nikita-shkoda.mintlify.app/projects/search-engine-for-typesense/field-selection`
+        # @see `https://nikita-shkoda.mintlify.app/projects/search-engine-for-typesense/v30.1/field-selection`
         #
         # When excluding, you may also pass a joined association name (after calling
         # `joins(:assoc)`) to exclude the entire joined payload from the response.
@@ -88,7 +88,7 @@ module SearchEngine
         # Replace the selected fields list (Typesense `include_fields`).
         # @param fields [Array<#to_sym,#to_s>]
         # @return [SearchEngine::Relation]
-        # @see `https://nikita-shkoda.mintlify.app/projects/search-engine-for-typesense/field-selection`
+        # @see `https://nikita-shkoda.mintlify.app/projects/search-engine-for-typesense/v30.1/field-selection`
         def reselect(*fields)
           normalized = normalize_select_input(fields)
 

data/lib/search_engine/relation/dsl.rb

@@ -98,7 +98,7 @@ module SearchEngine
           raise SearchEngine::Errors::InvalidOption.new(
             "InvalidOption: unknown prefix mode #{mode.inspect}",
             hint: 'Use :disabled, :fallback, or :always',
-            doc: 'https://nikita-shkoda.mintlify.app/projects/search-engine-for-typesense/ranking#prefix',
+            doc: 'https://nikita-shkoda.mintlify.app/projects/search-engine-for-typesense/v30.1/ranking#prefix',
             details: { provided: mode, allowed: valid.keys }
           )
         end
@@ -571,7 +571,7 @@ module SearchEngine
         if field_str.start_with?('$') || field_str.include?('.')
           raise SearchEngine::Errors::UnsupportedGroupField.new(
             %(UnsupportedGroupField: grouping supports base fields only (got #{field_str.inspect})),
-            doc: 'https://nikita-shkoda.mintlify.app/projects/search-engine-for-typesense/grouping#troubleshooting',
+            doc: 'https://nikita-shkoda.mintlify.app/projects/search-engine-for-typesense/v30.1/grouping#troubleshooting',
             details: { field: field_str }
           )
         end
@@ -583,7 +583,7 @@ module SearchEngine
             msg = build_invalid_group_unknown_field_message(sym)
             raise SearchEngine::Errors::InvalidGroup.new(
               msg,
-              doc: 'https://nikita-shkoda.mintlify.app/projects/search-engine-for-typesense/grouping#troubleshooting',
+              doc: 'https://nikita-shkoda.mintlify.app/projects/search-engine-for-typesense/v30.1/grouping#troubleshooting',
               details: { field: sym }
             )
           end
@@ -593,7 +593,7 @@ module SearchEngine
           got = limit.nil? ? 'nil' : limit.inspect
           raise SearchEngine::Errors::InvalidGroup.new(
             "InvalidGroup: limit must be a positive integer (got #{got})",
-            doc: 'https://nikita-shkoda.mintlify.app/projects/search-engine-for-typesense/grouping#troubleshooting',
+            doc: 'https://nikita-shkoda.mintlify.app/projects/search-engine-for-typesense/v30.1/grouping#troubleshooting',
             details: { limit: limit }
           )
         end
@@ -601,7 +601,7 @@ module SearchEngine
         unless [true, false].include?(missing_values)
           raise SearchEngine::Errors::InvalidGroup.new(
             "InvalidGroup: missing_values must be boolean (got #{missing_values.inspect})",
-            doc: 'https://nikita-shkoda.mintlify.app/projects/search-engine-for-typesense/grouping#troubleshooting',
+            doc: 'https://nikita-shkoda.mintlify.app/projects/search-engine-for-typesense/v30.1/grouping#troubleshooting',
             details: { missing_values: missing_values }
           )
         end
@@ -702,7 +702,7 @@ module SearchEngine
             'InvalidOption: ranking expects a Hash of options',
             hint: 'Use ranking(num_typos: 1, drop_tokens_threshold: 0.2,'\
                   'prioritize_exact_match: true, query_by_weights: { name: 2 })',
-            doc: 'https://nikita-shkoda.mintlify.app/projects/search-engine-for-typesense/ranking#options'
+            doc: 'https://nikita-shkoda.mintlify.app/projects/search-engine-for-typesense/v30.1/ranking#options'
           )
         end
 
@@ -729,14 +729,14 @@ module SearchEngine
           unless [0, 1, 2].include?(iv)
             raise SearchEngine::Errors::InvalidOption.new(
               "InvalidOption: num_typos must be 0, 1, or 2 (got #{raw.inspect})",
-              doc: 'https://nikita-shkoda.mintlify.app/projects/search-engine-for-typesense/ranking#options'
+              doc: 'https://nikita-shkoda.mintlify.app/projects/search-engine-for-typesense/v30.1/ranking#options'
             )
           end
           out[:num_typos] = iv
         rescue ArgumentError, TypeError
           raise SearchEngine::Errors::InvalidOption.new(
             "InvalidOption: num_typos must be an Integer in {0,1,2} (got #{raw.inspect})",
-            doc: 'https://nikita-shkoda.mintlify.app/projects/search-engine-for-typesense/ranking#options'
+            doc: 'https://nikita-shkoda.mintlify.app/projects/search-engine-for-typesense/v30.1/ranking#options'
           )
         end
       end
@@ -752,14 +752,14 @@ module SearchEngine
           unless fv >= 0.0 && fv <= 1.0 && fv.finite?
             raise SearchEngine::Errors::InvalidOption.new(
               "InvalidOption: drop_tokens_threshold must be a float between 0.0 and 1.0 (got #{raw.inspect})",
-              doc: 'https://nikita-shkoda.mintlify.app/projects/search-engine-for-typesense/ranking#options'
+              doc: 'https://nikita-shkoda.mintlify.app/projects/search-engine-for-typesense/v30.1/ranking#options'
             )
           end
           out[:drop_tokens_threshold] = fv
         rescue ArgumentError, TypeError
           raise SearchEngine::Errors::InvalidOption.new(
             "InvalidOption: drop_tokens_threshold must be a float between 0.0 and 1.0 (got #{raw.inspect})",
-            doc: 'https://nikita-shkoda.mintlify.app/projects/search-engine-for-typesense/ranking#options'
+            doc: 'https://nikita-shkoda.mintlify.app/projects/search-engine-for-typesense/v30.1/ranking#options'
           )
         end
       end
@@ -780,7 +780,7 @@ module SearchEngine
         unless raw.is_a?(Hash)
           raise SearchEngine::Errors::InvalidOption.new(
             'InvalidOption: query_by_weights must be a Hash of { field => Integer }',
-            doc: 'https://nikita-shkoda.mintlify.app/projects/search-engine-for-typesense/ranking#weights'
+            doc: 'https://nikita-shkoda.mintlify.app/projects/search-engine-for-typesense/v30.1/ranking#weights'
           )
         end
         normalized = {}
@@ -793,14 +793,14 @@ module SearchEngine
           rescue ArgumentError, TypeError
             raise SearchEngine::Errors::InvalidOption.new(
               "InvalidOption: weight for #{k.inspect} must be an Integer >= 0",
-              doc: 'https://nikita-shkoda.mintlify.app/projects/search-engine-for-typesense/ranking#weights',
+              doc: 'https://nikita-shkoda.mintlify.app/projects/search-engine-for-typesense/v30.1/ranking#weights',
               details: { field: k, weight: v }
             )
           end
           if w.negative?
             raise SearchEngine::Errors::InvalidOption.new(
               "InvalidOption: weight for #{k.inspect} must be >= 0",
-              doc: 'https://nikita-shkoda.mintlify.app/projects/search-engine-for-typesense/ranking#weights',
+              doc: 'https://nikita-shkoda.mintlify.app/projects/search-engine-for-typesense/v30.1/ranking#weights',
               details: { field: k, weight: v }
             )
           end
@@ -844,7 +844,7 @@ module SearchEngine
 
         raise SearchEngine::Errors::InvalidParams.new(
           %(#{context}: supports base fields only (got #{name.inspect})),
-          doc: 'https://nikita-shkoda.mintlify.app/projects/search-engine-for-typesense/faceting#supported-options',
+          doc: 'https://nikita-shkoda.mintlify.app/projects/search-engine-for-typesense/v30.1/faceting#supported-options',
           details: { field: name }
         )
       end
@@ -873,7 +873,7 @@ module SearchEngine
         raise SearchEngine::Errors::InvalidParams.new(
           "facet_by: option :sort is not supported by Typesense facets (got #{sort.inspect})",
           hint: 'Supported: default count-desc only at present.',
-          doc: 'https://nikita-shkoda.mintlify.app/projects/search-engine-for-typesense/faceting#supported-options',
+          doc: 'https://nikita-shkoda.mintlify.app/projects/search-engine-for-typesense/v30.1/faceting#supported-options',
           details: { sort: sort }
         )
       end
@@ -883,7 +883,7 @@ module SearchEngine
 
         raise SearchEngine::Errors::InvalidParams.new(
           'facet_by: option :stats is not supported at present',
-          doc: 'https://nikita-shkoda.mintlify.app/projects/search-engine-for-typesense/faceting#supported-options',
+          doc: 'https://nikita-shkoda.mintlify.app/projects/search-engine-for-typesense/v30.1/faceting#supported-options',
           details: { stats: stats }
         )
       end
@@ -905,7 +905,7 @@ module SearchEngine
         raise SearchEngine::Errors::InvalidParams.new(
           %(facet_query: invalid range syntax #{expr.inspect} (unbalanced brackets)),
           hint: 'Use shapes like "[0..9]", "[10..19]"',
-          doc: 'https://nikita-shkoda.mintlify.app/projects/search-engine-for-typesense/faceting#facet-query-expressions',
+          doc: 'https://nikita-shkoda.mintlify.app/projects/search-engine-for-typesense/v30.1/faceting#facet-query-expressions',
           details: { expr: expr }
         )
       end

data/lib/search_engine/relation/dx.rb

@@ -15,7 +15,7 @@ module SearchEngine
       # @param pretty [Boolean] pretty-print with stable key ordering when true
       # @return [String]
       # @since M8
-      # @see https://nikita-shkoda.mintlify.app/projects/search-engine-for-typesense/dx
+      # @see https://nikita-shkoda.mintlify.app/projects/search-engine-for-typesense/v30.1/dx
       def to_params_json(pretty: true)
         params = SearchEngine::CompiledParams.from(to_typesense_params)
         redacted = SearchEngine::Relation::Dx::DryRun.redact_params(params.to_h)
@@ -25,7 +25,7 @@ module SearchEngine
       # Return a single-line curl command with redacted API key and JSON body.
       # @return [String]
       # @since M8
-      # @see https://nikita-shkoda.mintlify.app/projects/search-engine-for-typesense/dx
+      # @see https://nikita-shkoda.mintlify.app/projects/search-engine-for-typesense/v30.1/dx
       def to_curl
         url = compiled_url
         params = SearchEngine::CompiledParams.from(to_typesense_params).to_h
@@ -37,7 +37,7 @@ module SearchEngine
       # @return [Hash] { url:, body:, url_opts: }
       # @raise [SearchEngine::Errors::*] same validation errors as runtime path
       # @since M8
-      # @see https://nikita-shkoda.mintlify.app/projects/search-engine-for-typesense/dx
+      # @see https://nikita-shkoda.mintlify.app/projects/search-engine-for-typesense/v30.1/dx
       def dry_run!
         params = SearchEngine::CompiledParams.from(to_typesense_params).to_h
         SearchEngine::Relation::Dx::DryRun.payload(url: compiled_url, params: params, url_opts: compiled_url_opts)
@@ -48,7 +48,7 @@ module SearchEngine
       # @param to [Symbol, nil]
       # @return [String]
       # @since M8
-      # @see https://nikita-shkoda.mintlify.app/projects/search-engine-for-typesense/dx#helpers--examples
+      # @see https://nikita-shkoda.mintlify.app/projects/search-engine-for-typesense/v30.1/dx#helpers--examples
       def explain(to: nil)
         params = SearchEngine::CompiledParams.from(to_typesense_params)
         lines = []

data/lib/search_engine/relation/materializers.rb

@@ -76,7 +76,7 @@ module SearchEngine
       # Returns nil when no records match.
       # @param fields [Array<#to_sym,#to_s>]
       # @return [Object, Array<Object>, nil]
-      # @see https://nikita-shkoda.mintlify.app/projects/search-engine-for-typesense/materializers#pick
+      # @see https://nikita-shkoda.mintlify.app/projects/search-engine-for-typesense/v30.1/materializers#pick
       def pick(*fields)
         SearchEngine::Hydration::Materializers.pick(self, *fields)
       end

data/lib/search_engine/relation/options.rb

@@ -44,7 +44,7 @@ module SearchEngine
         unless value.is_a?(Hash)
           raise SearchEngine::Errors::InvalidOption.new(
             'InvalidOption: hit_limits expects a Hash of options',
-            doc: 'https://nikita-shkoda.mintlify.app/projects/search-engine-for-typesense/hit-limits'
+            doc: 'https://nikita-shkoda.mintlify.app/projects/search-engine-for-typesense/v30.1/hit-limits'
           )
         end
 

data/lib/search_engine/relation.rb

@@ -591,7 +591,7 @@ module SearchEngine
       raise SearchEngine::Errors::HitLimitExceeded.new(
         msg,
         hint: 'Increase `validate_hits!(max:)` or narrow filters. Prefer `limit_hits(n)` to avoid work when supported.',
-        doc: 'https://nikita-shkoda.mintlify.app/projects/search-engine-for-typesense/hit-limits#validation',
+        doc: 'https://nikita-shkoda.mintlify.app/projects/search-engine-for-typesense/v30.1/hit-limits#validation',
         details: { total_hits: th, max: max, collection: coll, relation_summary: inspect }
       )
     end

data/lib/search_engine/result.rb

@@ -500,7 +500,7 @@ module SearchEngine
       raise SearchEngine::Errors::MissingField.new(
         msg,
         hint: 'Adjust select/exclude or disable strict_missing to avoid raising.',
-        doc: 'https://nikita-shkoda.mintlify.app/projects/search-engine-for-typesense/field-selection#strict-vs-lenient-selection',
+        doc: 'https://nikita-shkoda.mintlify.app/projects/search-engine-for-typesense/v30.1/field-selection#strict-vs-lenient-selection',
         details: { requested: requested, present_keys: present_keys }
       )
     end

data/lib/search_engine/schema.rb

@@ -71,7 +71,7 @@ module SearchEngine
       # @param klass [Class] model class inheriting from {SearchEngine::Base}
       # @param client [SearchEngine::Client] optional client wrapper (for tests)
       # @return [Hash] { diff: Hash, pretty: String }
-      # @see `https://nikita-shkoda.mintlify.app/projects/search-engine-for-typesense/schema-indexer-e2e`
+      # @see `https://nikita-shkoda.mintlify.app/projects/search-engine-for-typesense/v30.1/schema-indexer-e2e`
       # @see `https://typesense.org/docs/latest/api/collections.html`
       def diff(klass, client: nil)
         client ||= SearchEngine.client
@@ -154,7 +154,7 @@ module SearchEngine
       # @yieldparam physical_name [String] the newly created physical collection name
       # @return [Hash] { logical: String, new_physical: String, previous_physical: String, alias_target: String, dropped_physicals: Array<String> }
       # @raise [SearchEngine::Errors::Api, ArgumentError]
-      # @see `https://nikita-shkoda.mintlify.app/projects/search-engine-for-typesense/schema#lifecycle`
+      # @see `https://nikita-shkoda.mintlify.app/projects/search-engine-for-typesense/v30.1/schema#lifecycle`
       # @see `https://typesense.org/docs/latest/api/collections.html`
       def apply!(klass, client: nil, force_rebuild: false)
         client ||= SearchEngine.client
@@ -245,7 +245,7 @@ module SearchEngine
       # @param client [SearchEngine::Client]
       # @return [Hash] { logical: String, new_target: String, previous_target: String }
       # @raise [ArgumentError] when no previous physical exists
-      # @see `https://nikita-shkoda.mintlify.app/projects/search-engine-for-typesense/schema#retention`
+      # @see `https://nikita-shkoda.mintlify.app/projects/search-engine-for-typesense/v30.1/schema#retention`
       def rollback(klass, client: nil)
         client ||= SearchEngine.client
         compiled = compile(klass)
@@ -477,7 +477,7 @@ module SearchEngine
               "(got #{type_descriptor.inspect}).",
               hint: "Declare attribute :#{attribute_name}, :string in #{klass.name} to match " \
                     'Typesense reference requirements.',
-              doc: 'https://nikita-shkoda.mintlify.app/projects/search-engine-for-typesense/joins#declaring-references',
+              doc: 'https://nikita-shkoda.mintlify.app/projects/search-engine-for-typesense/v30.1/joins#declaring-references',
               details: {
                 field: attribute_name.to_s,
                 declared_type: type_descriptor,

data/lib/search_engine/sources/active_record_source.rb

@@ -81,7 +81,6 @@ module SearchEngine
           end
         elsif relation.respond_to?(:find_in_batches)
           relation.find_in_batches(batch_size: @batch_size) do |rows|
-            rows = rows.map { |r| r }
             duration = monotonic_ms - started
             instrument_batch_fetched(source: 'active_record', batch_index: idx, rows_count: rows.size,
                                      duration_ms: duration, partition: partition, cursor: cursor,

data/lib/search_engine/sources/lambda_source.rb

@@ -11,7 +11,7 @@ module SearchEngine
     #   src = SearchEngine::Sources::LambdaSource.new(->(cursor:, partition:) { [[row1, row2]] })
     #   src.each_batch { |rows| ... }
     #
-    # @see `https://nikita-shkoda.mintlify.app/projects/search-engine-for-typesense/indexer`
+    # @see `https://nikita-shkoda.mintlify.app/projects/search-engine-for-typesense/v30.1/indexer`
     class LambdaSource
       include Base
 

data/lib/search_engine/sources/sql_source.rb

@@ -12,7 +12,7 @@ module SearchEngine
     #   src.each_batch { |rows| ... }
     #
     # @note Emits "search_engine.source.batch_fetched" and "search_engine.source.error".
-    # @see `https://nikita-shkoda.mintlify.app/projects/search-engine-for-typesense/indexer`
+    # @see `https://nikita-shkoda.mintlify.app/projects/search-engine-for-typesense/v30.1/indexer`
     class SqlSource
       include Base
 

data/lib/search_engine/sources.rb

@@ -28,7 +28,7 @@ module SearchEngine
         unless model.is_a?(Class)
           raise SearchEngine::Errors::InvalidParams,
                 'active_record source requires :model (ActiveRecord class). See ' \
-                'https://nikita-shkoda.mintlify.app/projects/search-engine-for-typesense/indexer.'
+                'https://nikita-shkoda.mintlify.app/projects/search-engine-for-typesense/v30.1/indexer.'
         end
 
         scope = options[:scope]
@@ -43,7 +43,7 @@ module SearchEngine
         unless sql.is_a?(String) && !sql.strip.empty?
           raise SearchEngine::Errors::InvalidParams,
                 'sql source requires :sql (String). See ' \
-                'https://nikita-shkoda.mintlify.app/projects/search-engine-for-typesense/indexer.'
+                'https://nikita-shkoda.mintlify.app/projects/search-engine-for-typesense/v30.1/indexer.'
         end
 
         binds = options[:binds]
@@ -58,7 +58,7 @@ module SearchEngine
         unless callable
           raise SearchEngine::Errors::InvalidParams,
                 'lambda source requires a block or :callable. See ' \
-                'https://nikita-shkoda.mintlify.app/projects/search-engine-for-typesense/indexer.'
+                'https://nikita-shkoda.mintlify.app/projects/search-engine-for-typesense/v30.1/indexer.'
         end
 
         LambdaSource.new(callable)

data/lib/search_engine/test/stub_client.rb

@@ -20,7 +20,7 @@ module SearchEngine
     # or Procs that receive the captured request and return a response.
     #
     # @since M8
-    # @see https://nikita-shkoda.mintlify.app/projects/search-engine-for-typesense/testing
+    # @see https://nikita-shkoda.mintlify.app/projects/search-engine-for-typesense/v30.1/testing
     class StubClient
       Call = Struct.new(
         :timestamp,
@@ -45,7 +45,7 @@ module SearchEngine
       # @param value [Hash, Exception, Proc]
       # @return [void]
       # @since M8
-      # @see https://nikita-shkoda.mintlify.app/projects/search-engine-for-typesense/testing#quick-start
+      # @see https://nikita-shkoda.mintlify.app/projects/search-engine-for-typesense/v30.1/testing#quick-start
       def enqueue_response(method, value)
         @lock.synchronize do
           queue_for(method) << value
@@ -54,7 +54,7 @@ module SearchEngine
 
       # Reset all internal state (queues and captures).
       # @since M8
-      # @see https://nikita-shkoda.mintlify.app/projects/search-engine-for-typesense/testing#parallel-test-safety
+      # @see https://nikita-shkoda.mintlify.app/projects/search-engine-for-typesense/v30.1/testing#parallel-test-safety
       def reset!
         @lock.synchronize do
           @queues.each_value(&:clear)
@@ -65,7 +65,7 @@ module SearchEngine
       # Return captured calls for search.
       # @return [Array<Call>]
       # @since M8
-      # @see https://nikita-shkoda.mintlify.app/projects/search-engine-for-typesense/testing
+      # @see https://nikita-shkoda.mintlify.app/projects/search-engine-for-typesense/v30.1/testing
       def search_calls
         @lock.synchronize { @calls[:search].dup }
       end
@@ -73,7 +73,7 @@ module SearchEngine
       # Return captured calls for multi_search.
       # @return [Array<Call>]
       # @since M8
-      # @see https://nikita-shkoda.mintlify.app/projects/search-engine-for-typesense/testing
+      # @see https://nikita-shkoda.mintlify.app/projects/search-engine-for-typesense/v30.1/testing
       def multi_search_calls
         @lock.synchronize { @calls[:multi_search].dup }
       end
@@ -81,7 +81,7 @@ module SearchEngine
       # All calls in chronological order.
       # @return [Array<Call>]
       # @since M8
-      # @see https://nikita-shkoda.mintlify.app/projects/search-engine-for-typesense/testing
+      # @see https://nikita-shkoda.mintlify.app/projects/search-engine-for-typesense/v30.1/testing
       def all_calls
         @lock.synchronize { (@calls[:search] + @calls[:multi_search]).sort_by(&:timestamp) }
       end
@@ -91,7 +91,7 @@ module SearchEngine
       # @param params [Hash]
       # @param url_opts [Hash]
       # @since M8
-      # @see https://nikita-shkoda.mintlify.app/projects/search-engine-for-typesense/testing
+      # @see https://nikita-shkoda.mintlify.app/projects/search-engine-for-typesense/v30.1/testing
       def search(collection:, params:, url_opts: {})
         unless collection.is_a?(String) && !collection.strip.empty?
           raise ArgumentError, 'collection must be a non-empty String'
@@ -109,7 +109,7 @@ module SearchEngine
       # @param searches [Array<Hash>]
       # @param url_opts [Hash]
       # @since M8
-      # @see https://nikita-shkoda.mintlify.app/projects/search-engine-for-typesense/testing
+      # @see https://nikita-shkoda.mintlify.app/projects/search-engine-for-typesense/v30.1/testing
       def multi_search(searches:, url_opts: {})
         unless searches.is_a?(Array) && searches.all? { |h| h.is_a?(Hash) }
           raise ArgumentError, 'searches must be an Array of Hashes'

data/lib/search_engine/test.rb

@@ -12,7 +12,7 @@ module SearchEngine
   # These helpers are allocation-light, thread-safe, and never perform network I/O.
   #
   # @since M8
-  # @see https://nikita-shkoda.mintlify.app/projects/search-engine-for-typesense/testing
+  # @see https://nikita-shkoda.mintlify.app/projects/search-engine-for-typesense/v30.1/testing
   module Test
     class << self
       # Subscribe to `search_engine.*` for the duration of the block and return captured events.
@@ -22,7 +22,7 @@ module SearchEngine
       # @yield block within which events are captured
       # @return [Array<Hash>]
       # @since M8
-      # @see https://nikita-shkoda.mintlify.app/projects/search-engine-for-typesense/testing#event-assertions
+      # @see https://nikita-shkoda.mintlify.app/projects/search-engine-for-typesense/v30.1/testing#event-assertions
       def capture_events(name = nil)
         require 'active_support/notifications'
         pattern = name.is_a?(Regexp) ? name : /^search_engine\./

data/lib/search_engine/version.rb

@@ -3,5 +3,5 @@
 module SearchEngine
   # Current gem version.
   # @return [String]
-  VERSION = '30.1.0'
+  VERSION = '30.1.1'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: search-engine-for-typesense
 version: !ruby/object:Gem::Version
-  version: 30.1.0
+  version: 30.1.1
 platform: ruby
 authors:
 - Nikita Shkoda
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-02-05 00:00:00.000000000 Z
+date: 2026-03-05 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: concurrent-ruby