vectra-client 1.1.3 → 1.1.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 83a312bb14b8f556d743e0072548a33ec0ac79c9d64768c78b18af3bc7ac6c6b
-  data.tar.gz: 0f0e859dd346e86f095a882e4cb7d47fd1ecf05aa968730b2b3e0d2ff7fa253b
+  metadata.gz: c2ed5842cd4c611fd0c140abc8925a2d13577c4f2094dbc71c7b2772aceda9e4
+  data.tar.gz: da3005805b97d5b36c632d3e2c34ad9a3966eb65b09ce2f5f84911858c2d34d5
 SHA512:
-  metadata.gz: ccbc0520ce83f7d2f039a50c0a4b16a9fb59ce21956eb00d5f28270bf61e3ae6c81ab133b02b3ffd1662d29864f5b0ae9c04f60b8e61715f8cbb513b71d48c72
-  data.tar.gz: 38a9b1bbfc4db14005b88d1f29957806f888dc80886c147925fe9dec1643ca67e992aae71258108130ba33b317b999658df5a7756fffe92f0f91bb39b3ba88d1
+  metadata.gz: bb3324f260afb42c5e03356f8d09c902571fcaddc39969541c918523c4ebadbdb8dadf35764d9d04cce2b308ee4aa18d9f7c3266690a1a728ceeecb9908a3622
+  data.tar.gz: adca9a174757547d1306dbaa727069fa1954a8dc40b101c1cb378bfb3663c94ad7ec0a35082ea578ef4dd4a7ab53477bdfde6dd258623c83e161eb8c6cff2b42

data/CHANGELOG.md

@@ -1,12 +1,16 @@
 # Changelog
 
+## [v1.1.4](https://github.com/stokry/vectra/tree/v1.1.4) (2026-01-20)
+
+[Full Changelog](https://github.com/stokry/vectra/compare/v1.1.3...v1.1.4)
+
+- Add `Client#valid?` – non-raising validation (returns true/false)
+- Add `Client#for_tenant` – multi-tenant block helper for namespace isolation
+
 ## [v1.1.3](https://github.com/stokry/vectra/tree/v1.1.3) (2026-01-20)
 
 [Full Changelog](https://github.com/stokry/vectra/compare/v1.1.2...v1.1.3)
 
-- Add `Client#validate!` for configuration/capability checks
-- Add `Client#with_defaults` block helper for temporary default index/namespace
-
 ## [v1.1.2](https://github.com/stokry/vectra/tree/v1.1.2) (2026-01-19)
 
 [Full Changelog](https://github.com/stokry/vectra/compare/v1.1.1...v1.1.2)

data/docs/api/cheatsheet.md

@@ -66,6 +66,19 @@ end
 client.validate!
 client.validate!(require_default_index: true)
 client.validate!(features: [:text_search])
+
+# Non-raising: returns true/false
+client.valid?
+client.valid?(require_default_index: true)
+```
+
+### Multi-tenant (for_tenant)
+
+```ruby
+client.for_tenant("acme", namespace_prefix: "tenant_") do |c|
+  c.upsert(vectors: [...])
+  c.query(vector: query_embedding, top_k: 10)
+end
 ```
 
 ### Upsert

data/docs/api/methods.md

@@ -475,6 +475,45 @@ end
 
 ---
 
+### `client.valid?(require_default_index: false, require_default_namespace: false, features: [])`
+
+Non-raising validation. Returns `true` if the client passes `validate!`, `false` otherwise. Accepts the same options as `validate!`.
+
+**Returns:** `Boolean`
+
+**Example:**
+```ruby
+next unless client.valid?
+client.upsert(vectors: [...])
+
+# With same options as validate!
+client.valid?(require_default_index: true)
+client.valid?(features: [:text_search])
+```
+
+---
+
+### `client.for_tenant(tenant_id, namespace_prefix: "tenant_") { ... }`
+
+Multi-tenant block helper. Temporarily sets the default namespace to `"#{namespace_prefix}#{tenant_id}"`, yields the client, then restores the previous namespace. `tenant_id` can be a string, symbol, or anything responding to `to_s`.
+
+**Parameters:**
+- `tenant_id` (String, Symbol, #to_s) - Tenant identifier
+- `namespace_prefix` (String) - Prefix for namespace (default: `"tenant_"`)
+
+**Returns:** Block result
+
+**Example:**
+```ruby
+client.for_tenant("acme", namespace_prefix: "tenant_") do |c|
+  c.upsert(vectors: [...])
+  c.query(vector: embedding, top_k: 10)
+end
+# All operations use namespace "tenant_acme"; previous default restored after block.
+```
+
+---
+
 ### `client.health_check`
 
 Detailed health check with provider-specific information.

data/lib/vectra/client.rb

@@ -661,6 +661,30 @@ module Vectra
       self
     end
 
+    # Non-raising validation. Returns true if client passes validate!, false otherwise.
+    #
+    # Accepts the same options as validate!.
+    #
+    # @param require_default_index [Boolean] require default index to be set
+    # @param require_default_namespace [Boolean] require default namespace to be set
+    # @param features [Array<Symbol>, Symbol] provider features required, e.g. :text_search
+    # @return [Boolean]
+    #
+    # @example
+    #   next unless client.valid?
+    #   client.upsert(vectors: [...])
+    #
+    def valid?(require_default_index: false, require_default_namespace: false, features: [])
+      validate!(
+        require_default_index: require_default_index,
+        require_default_namespace: require_default_namespace,
+        features: features
+      )
+      true
+    rescue ConfigurationError
+      false
+    end
+
     # Chainable query builder
     #
     # @api public
@@ -1016,7 +1040,25 @@ module Vectra
       @default_namespace = previous_namespace
     end
 
-    public :with_index, :with_namespace, :with_index_and_namespace, :with_defaults, :with_timeout
+    # Multi-tenant block helper: temporarily sets default namespace to +"#{namespace_prefix}#{tenant_id}"+.
+    #
+    # @param tenant_id [String, Symbol, #to_s] tenant identifier
+    # @param namespace_prefix [String] prefix for namespace (default: "tenant_")
+    # @yield [Client] yields self with overridden namespace
+    # @return [Object] block result
+    #
+    # @example
+    #   client.for_tenant("acme", namespace_prefix: "tenant_") do |c|
+    #     c.upsert(vectors: [...])
+    #     c.query(vector: emb, top_k: 10)
+    #   end
+    #
+    def for_tenant(tenant_id, namespace_prefix: "tenant_")
+      ns = "#{namespace_prefix}#{tenant_id}"
+      with_namespace(ns) { yield self }
+    end
+
+    public :with_index, :with_namespace, :with_index_and_namespace, :with_defaults, :with_timeout, :for_tenant
   end
   # rubocop:enable Metrics/ClassLength
 end

data/lib/vectra/version.rb

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

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: vectra-client
 version: !ruby/object:Gem::Version
-  version: 1.1.3
+  version: 1.1.4
 platform: ruby
 authors:
 - Mijo Kristo