vectra-client 1.0.8 → 1.1.1

data/lib/vectra/providers/weaviate.rb

@@ -139,6 +139,36 @@ module Vectra
                                       include_values, include_metadata)
       end
 
+      # Text-only search using Weaviate's BM25 text search
+      #
+      # @param index [String] class name
+      # @param text [String] text query for BM25 search
+      # @param top_k [Integer] number of results
+      # @param namespace [String, nil] optional namespace (not used in Weaviate)
+      # @param filter [Hash, nil] metadata filter
+      # @param include_values [Boolean] include vector values
+      # @param include_metadata [Boolean] include metadata
+      # @return [QueryResult] search results
+      def text_search(index:, text:, top_k:, namespace: nil, filter: nil,
+                      include_values: false, include_metadata: true)
+        where_filter = build_where(filter, namespace)
+        graphql = build_text_search_graphql(
+          index: index,
+          text: text,
+          top_k: top_k,
+          where_filter: where_filter,
+          include_values: include_values,
+          include_metadata: include_metadata
+        )
+        body = { "query" => graphql }
+
+        response = with_error_handling do
+          connection.post("#{API_BASE_PATH}/graphql", body)
+        end
+
+        handle_text_search_response(response, index, namespace, include_values, include_metadata)
+      end
+
       # rubocop:disable Metrics/PerceivedComplexity
       def fetch(index:, ids:, namespace: nil)
         body = {
@@ -337,6 +367,26 @@ module Vectra
         build_graphql_query(index, top_k, text, alpha, vector, where_filter, selection_block)
       end
 
+      def build_text_search_graphql(index:, text:, top_k:, where_filter:,
+                                    include_values:, include_metadata:)
+        selection_block = build_selection_fields(include_values, include_metadata).join(" ")
+        <<~GRAPHQL
+          {
+            Get {
+              #{index}(
+                limit: #{top_k}
+                bm25: {
+                  query: "#{text.gsub('"', '\\"')}"
+                }
+                #{"where: #{JSON.generate(where_filter)}" if where_filter}
+              ) {
+                #{selection_block}
+              }
+            }
+          }
+        GRAPHQL
+      end
+
       def build_graphql_query(index, top_k, text, alpha, vector, where_filter, selection_block)
         <<~GRAPHQL
           {
@@ -379,6 +429,20 @@ module Vectra
         end
       end
 
+      def handle_text_search_response(response, index, namespace, include_values, include_metadata)
+        if response.success?
+          matches = extract_query_matches(response.body, index, include_values, include_metadata)
+          log_debug("Text search returned #{matches.size} results")
+
+          QueryResult.from_response(
+            matches: matches,
+            namespace: namespace
+          )
+        else
+          handle_error(response)
+        end
+      end
+
       def validate_config!
         super
         raise ConfigurationError, "Host must be configured for Weaviate" if config.host.nil? || config.host.empty?

data/lib/vectra/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Vectra
-  VERSION = "1.0.8"
+  VERSION = "1.1.1"
 end

data/lib/vectra.rb

@@ -18,6 +18,15 @@ require_relative "vectra/health_check"
 require_relative "vectra/credential_rotation"
 require_relative "vectra/audit_log"
 require_relative "vectra/active_record"
+require_relative "vectra/middleware/request"
+require_relative "vectra/middleware/response"
+require_relative "vectra/middleware/base"
+require_relative "vectra/middleware/stack"
+require_relative "vectra/middleware/logging"
+require_relative "vectra/middleware/retry"
+require_relative "vectra/middleware/instrumentation"
+require_relative "vectra/middleware/pii_redaction"
+require_relative "vectra/middleware/cost_tracker"
 require_relative "vectra/providers/base"
 require_relative "vectra/providers/pinecone"
 require_relative "vectra/providers/qdrant"

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: vectra-client
 version: !ruby/object:Gem::Version
-  version: 1.0.8
+  version: 1.1.1
 platform: ruby
 authors:
 - Mijo Kristo
@@ -268,11 +268,13 @@ files:
 - docs/guides/faq.md
 - docs/guides/getting-started.md
 - docs/guides/installation.md
+- docs/guides/middleware.md
 - docs/guides/monitoring.md
 - docs/guides/performance.md
 - docs/guides/rails-integration.md
 - docs/guides/rails-troubleshooting.md
 - docs/guides/recipes.md
+- docs/guides/roadmap.md
 - docs/guides/runbooks/cache-issues.md
 - docs/guides/runbooks/high-error-rate.md
 - docs/guides/runbooks/high-latency.md
@@ -294,6 +296,7 @@ files:
 - examples/grafana-dashboard.json
 - examples/grafana-setup.md
 - examples/instrumentation_demo.rb
+- examples/middleware_demo.rb
 - examples/prometheus-exporter.rb
 - lib/generators/vectra/index_generator.rb
 - lib/generators/vectra/install_generator.rb
@@ -316,6 +319,15 @@ files:
 - lib/vectra/instrumentation/new_relic.rb
 - lib/vectra/instrumentation/sentry.rb
 - lib/vectra/logging.rb
+- lib/vectra/middleware/base.rb
+- lib/vectra/middleware/cost_tracker.rb
+- lib/vectra/middleware/instrumentation.rb
+- lib/vectra/middleware/logging.rb
+- lib/vectra/middleware/pii_redaction.rb
+- lib/vectra/middleware/request.rb
+- lib/vectra/middleware/response.rb
+- lib/vectra/middleware/retry.rb
+- lib/vectra/middleware/stack.rb
 - lib/vectra/pool.rb
 - lib/vectra/providers/base.rb
 - lib/vectra/providers/memory.rb