vectra-client 0.3.2 → 0.3.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 2d3586fe349f6746ba939c2596bf5b1110551a8e7ed16a8dc6581eaa2f91af81
-  data.tar.gz: 11d141983fba57e97fc0d96792f75e8e2e50eac453671ddb25ce8456002acac2
+  metadata.gz: bcc42d23052b076d9efcb085b9490b3d21b0e1b101a8edb3d9fca500d72ac2cd
+  data.tar.gz: 5abe33ef210d55e3cda6ffa8f80ca1ecadcea8632c46eb9ce78c824f35684c68
 SHA512:
-  metadata.gz: 6396f52e61633d9b2eed5502edbc80f8c001d85aea638afad4ff5c377e7d141ca80dd6198ace23808324411355924b2e653aa661e157fa4ae33c0b905bf31e4d
-  data.tar.gz: 1581ca62c63111caaf6fc26ced7503a101ceb30c8a0531b3fa454a0ac10376446f5a358dfbb29f045de9ba799114803af02b6a021828debc8df14cab129a5147
+  metadata.gz: 40aaec0556a2de07028db2e75ad2ebf463f51728336fc508676a567837a45d1be00174ed679601a1aa5f976a05605c10c86817dd99616bc38b63350fa1ed9e63
+  data.tar.gz: 1a3bfad7f776a429be42f591af896c3c9e9ba55a45eb58dffda8b9fa50190d5248552bfab87038ab53e04183d2cbe5fcade506bf0cc99580b1435c50a30b64b9

data/.rubocop.yml

@@ -11,6 +11,7 @@ AllCops:
     - 'bin/**/*'
     - 'node_modules/**/*'
     - 'lib/generators/**/templates/**/*'
+    - 'examples/**/*'
 
 # Layout
 Layout/LineLength:
@@ -30,6 +31,7 @@ Metrics/BlockLength:
     - 'vectra.gemspec'
     - 'Rakefile'
     - 'benchmarks/**/*'
+    - 'examples/**/*'
   AllowedMethods:
     - 'included'
     - 'class_methods'
@@ -38,26 +40,34 @@ Metrics/MethodLength:
   Max: 30
   Exclude:
     - 'spec/**/*'
+    - 'examples/**/*'
 
 Metrics/AbcSize:
   Max: 30
   Exclude:
     - 'spec/**/*'
+    - 'examples/**/*'
 
 Metrics/ClassLength:
   Max: 250
   Exclude:
     - 'spec/**/*'
+    - 'examples/**/*'
 
 Metrics/ModuleLength:
   Exclude:
     - 'spec/**/*'
+    - 'examples/**/*'
 
 Metrics/CyclomaticComplexity:
   Max: 10
+  Exclude:
+    - 'examples/**/*'
 
 Metrics/PerceivedComplexity:
   Max: 10
+  Exclude:
+    - 'examples/**/*'
 
 Metrics/ParameterLists:
   Max: 7

data/CHANGELOG.md

@@ -1,71 +1,20 @@
 # Changelog
 
-All notable changes to this project will be documented in this file.
-
-The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
-and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
-
-## [Unreleased]
-
-### Added
-
-- **Proactive Rate Limiting** (`Vectra::RateLimiter`)
-  - Token bucket algorithm for smooth rate limiting
-  - Burst support for handling traffic spikes
-  - Per-provider rate limiter registry
-  - `RateLimitedClient` wrapper for automatic throttling
-  - Prevents API rate limit errors before they occur
-
-- **Structured JSON Logging** (`Vectra::JsonLogger`)
-  - Machine-readable JSON log format
-  - Automatic operation logging via instrumentation
-  - Custom metadata support
-  - Integration with standard Ruby Logger via `JsonFormatter`
-  - Log levels: debug, info, warn, error, fatal
-
-- **Health Check Functionality** (`Vectra::HealthCheck`)
-  - Built-in `client.health_check` method
-  - Connectivity and latency testing
-  - Optional index statistics inclusion
-  - Pool health checking for pgvector
-  - `AggregateHealthCheck` for multi-provider setups
-  - JSON-serializable results
-
-- **Error Tracking Integrations**
-  - Sentry adapter with breadcrumbs, context, and fingerprinting
-  - Honeybadger adapter with severity tags and configurable notifications
-  - Automatic error context and grouping
-
-- **Circuit Breaker Pattern** (`Vectra::CircuitBreaker`)
-  - Three-state circuit (closed, open, half-open)
-  - Automatic failover with fallback support
-  - Per-provider circuit registry
-  - Thread-safe implementation
-  - Configurable failure/success thresholds
-
-- **Credential Rotation** (`Vectra::CredentialRotator`)
-  - Zero-downtime API key rotation
-  - Pre-rotation validation
-  - Rollback support
-  - Multi-provider rotation manager
-  - Per-provider rotation tracking
-
-- **Audit Logging** (`Vectra::AuditLog`)
-  - Structured audit events for compliance
-  - Access, authentication, authorization logging
-  - Configuration change tracking
-  - Credential rotation audit trail
-  - Automatic API key sanitization
-  - Global audit logging support
+## [v0.3.4](https://github.com/stokry/vectra/tree/v0.3.4) (2026-01-12)
 
-## [v0.3.2](https://github.com/stokry/vectra/tree/v0.3.2) (2026-01-08)
-
-[Full Changelog](https://github.com/stokry/vectra/compare/v0.3.1...v0.3.2)
+[Full Changelog](https://github.com/stokry/vectra/compare/v0.3.3...v0.3.4)
 
 ### Fixed
+- Fixed Weaviate provider DELETE request WebMock stub to include query parameters
+- Fixed RuboCop offenses: empty string interpolation, redundant else, ambiguous block associations, and style issues
 
-- Audit log keyword parameter ordering and optional fields now align with linting and usage expectations.
-- Credential rotation utilities use symbol procs and string interpolation while keeping the existing `switch_to_secondary` API.
+## [v0.3.3](https://github.com/stokry/vectra/tree/v0.3.3) (2026-01-09)
+
+[Full Changelog](https://github.com/stokry/vectra/compare/v0.3.2...v0.3.3)
+
+## [v0.3.2](https://github.com/stokry/vectra/tree/v0.3.2) (2026-01-08)
+
+[Full Changelog](https://github.com/stokry/vectra/compare/v0.3.1...v0.3.2)
 
 ## [v0.3.1](https://github.com/stokry/vectra/tree/v0.3.1) (2026-01-08)
 
@@ -75,49 +24,6 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 [Full Changelog](https://github.com/stokry/vectra/compare/v0.2.2...v0.3.0)
 
-### Added
-
-- **Async Batch Operations** (`Vectra::Batch`)
-  - Concurrent batch upsert with configurable worker count
-  - Automatic chunking of large vector sets
-  - Async delete and fetch operations
-  - Error aggregation and partial success handling
-
-- **Streaming Results** (`Vectra::Streaming`)
-  - Lazy enumeration for large query result sets
-  - Memory-efficient processing with automatic pagination
-  - `query_each` and `query_stream` methods
-  - Duplicate detection across pages
-
-- **Caching Layer** (`Vectra::Cache` and `Vectra::CachedClient`)
-  - In-memory LRU cache with configurable TTL
-  - Transparent caching for query and fetch operations
-  - Index-level cache invalidation
-  - Thread-safe with mutex synchronization
-
-- **Connection Pool with Warmup** (`Vectra::Pool`)
-  - Configurable pool size and checkout timeout
-  - Connection warmup at startup
-  - Health checking and automatic reconnection
-  - Pool statistics and monitoring
-
-- **CI Benchmark Integration**
-  - Weekly scheduled benchmark runs
-  - PostgreSQL (pgvector) integration in CI
-  - Benchmark result artifact storage
-
-### Configuration
-
-New configuration options:
-- `cache_enabled` - Enable/disable caching (default: false)
-- `cache_ttl` - Cache time-to-live in seconds (default: 300)
-- `cache_max_size` - Maximum cache entries (default: 1000)
-- `async_concurrency` - Concurrent workers for batch ops (default: 4)
-
-### Dependencies
-
-- Added `concurrent-ruby ~> 1.2` for thread-safe operations
-
 ## [v0.2.2](https://github.com/stokry/vectra/tree/v0.2.2) (2026-01-08)
 
 [Full Changelog](https://github.com/stokry/vectra/compare/v0.2.1...v0.2.2)
@@ -126,56 +32,10 @@ New configuration options:
 
 [Full Changelog](https://github.com/stokry/vectra/compare/v0.2.0...v0.2.1)
 
-### Added
-
-- **Qdrant Provider** - Full Qdrant vector database support:
-  - Vector upsert, query, fetch, update, delete operations
-  - Collection management (create, list, describe, delete)
-  - Multiple similarity metrics: cosine, euclidean, dot product
-  - Namespace support via payload filtering
-  - Advanced metadata filtering with Qdrant operators ($eq, $ne, $gt, $gte, $lt, $lte, $in, $nin)
-  - Automatic point ID hashing for string IDs
-  - Support for both local and cloud Qdrant instances
-  - Optional API key authentication for local deployments
-
-### Improved
-
-- Enhanced error handling with `Faraday::RetriableResponse` support
-- Configuration now allows optional API key for Qdrant and pgvector (local instances)
-- Better retry middleware integration across all providers
-
-### Provider Support
-
-- ✅ Pinecone - Fully implemented
-- ✅ pgvector (PostgreSQL) - Fully implemented
-- ✅ Qdrant - Fully implemented
-- 🚧 Weaviate - Stub implementation (planned for v0.4.0)
-
 ## [v0.2.0](https://github.com/stokry/vectra/tree/v0.2.0) (2026-01-08)
 
 [Full Changelog](https://github.com/stokry/vectra/compare/v0.1.3...v0.2.0)
 
-### Added
-
-- **Instrumentation & Monitoring** - Track all vector operations with New Relic, Datadog, or custom handlers
-- **ActiveRecord Integration** - `has_vector` DSL for seamless Rails model integration with automatic indexing
-- **Rails Generator** - `rails generate vectra:install` for quick setup
-- **Automatic Retry Logic** - Exponential backoff with jitter for transient database errors
-- **Performance Benchmarks** - Measure batch operations and connection pooling performance
-- **Comprehensive Documentation** - USAGE_EXAMPLES.md, IMPLEMENTATION_GUIDE.md with 10+ real-world examples
-
-### Improved
-
-- All Client methods now instrumented (upsert, query, fetch, update, delete)
-- pgvector Connection module includes retry logic with smart error detection
-- Configuration expanded with instrumentation, pool_size, batch_size, max_retries options
-
-### Documentation
-
-- Added USAGE_EXAMPLES.md with e-commerce search, RAG chatbot, duplicate detection examples
-- Added IMPLEMENTATION_GUIDE.md for developers implementing new features
-- Added NEW_FEATURES_v0.2.0.md with migration guide
-
 ## [v0.1.3](https://github.com/stokry/vectra/tree/v0.1.3) (2026-01-07)
 
 [Full Changelog](https://github.com/stokry/vectra/compare/v0.1.1...v0.1.3)
@@ -184,33 +44,6 @@ New configuration options:
 
 [Full Changelog](https://github.com/stokry/vectra/compare/0ab2ea7b42d7fbf0b540b24889cc2b24254fef2e...v0.1.1)
 
-### Added
-
-- **pgvector provider** - Full PostgreSQL with pgvector extension support:
-  - Vector upsert, query, fetch, update, delete operations
-  - Index (table) management with automatic schema creation
-  - Multiple similarity metrics: cosine, euclidean, inner product
-  - Namespace support via namespace column
-  - Metadata filtering with JSONB
-  - IVFFlat index creation for fast similarity search
-- `Vectra.pgvector` convenience method for creating pgvector clients
-- Comprehensive unit and integration tests for pgvector provider
-
-### Changed
-
-- Updated gemspec description to include pgvector
-- Added `pg` gem as development dependency
-
-## Planned
-
-### [0.4.0]
-
-- Weaviate provider implementation
-- Additional similarity metrics
-- Vector quantization support
 
-### [1.0.0]
 
-- Background job integration (Sidekiq, GoodJob)
-- Production-ready with full documentation
-- Performance monitoring dashboard
+\* *This Changelog was automatically generated by [github_changelog_generator](https://github.com/github-changelog-generator/github-changelog-generator)*

data/docs/_layouts/default.html

@@ -7,6 +7,7 @@
   <title>{{ page.title }} - {{ site.title }}</title>
   <link rel="stylesheet" href="{{ site.baseurl }}/assets/style.css">
   <link rel="icon" type="image/svg+xml" href="data:image/svg+xml,<svg xmlns=%22http://www.w3.org/2000/svg%22 viewBox=%220 0 100 100%22><text y=%22.9em%22 font-size=%2290%22>◆</text></svg>">
+  <script defer src="https://umami-production-dfb8.up.railway.app/script.js" data-website-id="07e5420c-12d1-4e3c-9dbd-5cecb15a878f"></script>
 </head>
 <body>
   {{ content }}

data/docs/_layouts/home.html

@@ -7,13 +7,19 @@
   <title>{{ page.title }} - {{ site.title }}</title>
   <link rel="stylesheet" href="{{ site.baseurl }}/assets/style.css">
   <link rel="icon" type="image/svg+xml" href="data:image/svg+xml,<svg xmlns=%22http://www.w3.org/2000/svg%22 viewBox=%220 0 100 100%22><text y=%22.9em%22 font-size=%2290%22>◆</text></svg>">
+  <script defer src="https://umami-production-dfb8.up.railway.app/script.js" data-website-id="07e5420c-12d1-4e3c-9dbd-5cecb15a878f"></script>
 </head>
 <body>
   <!-- Header -->
   <header class="tma-header">
     <nav class="tma-nav">
       <a href="{{ site.baseurl }}/" class="tma-nav__brand">Vectra</a>
-      <ul class="tma-nav__menu">
+      <button class="tma-nav__toggle" aria-label="Toggle menu" aria-expanded="false">
+        <span class="tma-nav__toggle-line"></span>
+        <span class="tma-nav__toggle-line"></span>
+        <span class="tma-nav__toggle-line"></span>
+      </button>
+      <ul class="tma-nav__menu" id="nav-menu">
         <li><a href="{{ site.baseurl }}/guides/getting-started" class="tma-nav__link">Getting Started</a></li>
         <li><a href="{{ site.baseurl }}/providers" class="tma-nav__link">Providers</a></li>
         <li><a href="{{ site.baseurl }}/api/overview" class="tma-nav__link">API</a></li>
@@ -29,7 +35,7 @@
   <!-- Hero Section -->
   <section class="tma-hero">
     <div class="tma-hero__container">
-      <span class="tma-hero__badge">v0.2.2 — Qdrant & Weaviate Support</span>
+      <span class="tma-hero__badge">v0.3.3 — Grafana Dashboard & Monitoring</span>
       <h1 class="tma-hero__title">
         Vector Databases,<br>
         <span class="tma-hero__title-gradient">Unified for Ruby.</span>
@@ -77,7 +83,7 @@
         <span class="tma-feature-card__icon">📈</span>
         <h3 class="tma-feature-card__title">Observable</h3>
         <p class="tma-feature-card__description">
-          Native instrumentation for Datadog and New Relic. Track latency, throughput, and errors.
+          Grafana dashboard, Prometheus metrics, and native instrumentation for Datadog and New Relic. Track latency, throughput, and errors.
         </p>
       </div>
       <div class="tma-feature-card">
@@ -183,5 +189,40 @@
       </ul>
     </div>
   </footer>
+  <script>
+    document.addEventListener('DOMContentLoaded', function() {
+      const navToggle = document.querySelector('.tma-nav__toggle');
+      const navMenu = document.querySelector('.tma-nav__menu');
+      
+      if (navToggle && navMenu) {
+        navToggle.addEventListener('click', function(e) {
+          e.preventDefault();
+          e.stopPropagation();
+          const isExpanded = navToggle.getAttribute('aria-expanded') === 'true';
+          navToggle.setAttribute('aria-expanded', !isExpanded);
+          navMenu.classList.toggle('tma-nav__menu--open');
+        });
+        
+        // Close menu when clicking on a link
+        const navLinks = navMenu.querySelectorAll('.tma-nav__link');
+        navLinks.forEach(function(link) {
+          link.addEventListener('click', function() {
+            navToggle.setAttribute('aria-expanded', 'false');
+            navMenu.classList.remove('tma-nav__menu--open');
+          });
+        });
+        
+        // Close menu when clicking outside
+        document.addEventListener('click', function(e) {
+          if (navMenu.classList.contains('tma-nav__menu--open') && 
+              !navMenu.contains(e.target) && 
+              !navToggle.contains(e.target)) {
+            navToggle.setAttribute('aria-expanded', 'false');
+            navMenu.classList.remove('tma-nav__menu--open');
+          }
+        });
+      }
+    });
+  </script>
 </body>
 </html>

data/docs/_layouts/page.html

@@ -7,13 +7,19 @@
   <title>{{ page.title }} - {{ site.title }}</title>
   <link rel="stylesheet" href="{{ site.baseurl }}/assets/style.css">
   <link rel="icon" type="image/svg+xml" href="data:image/svg+xml,<svg xmlns=%22http://www.w3.org/2000/svg%22 viewBox=%220 0 100 100%22><text y=%22.9em%22 font-size=%2290%22>◆</text></svg>">
+  <script defer src="https://umami-production-dfb8.up.railway.app/script.js" data-website-id="07e5420c-12d1-4e3c-9dbd-5cecb15a878f"></script>
 </head>
 <body>
   <!-- Header -->
   <header class="tma-header">
     <nav class="tma-nav">
       <a href="{{ site.baseurl }}/" class="tma-nav__brand">Vectra</a>
-      <ul class="tma-nav__menu">
+      <button class="tma-nav__toggle" aria-label="Toggle menu" aria-expanded="false">
+        <span class="tma-nav__toggle-line"></span>
+        <span class="tma-nav__toggle-line"></span>
+        <span class="tma-nav__toggle-line"></span>
+      </button>
+      <ul class="tma-nav__menu" id="nav-menu">
         <li><a href="{{ site.baseurl }}/guides/getting-started" class="tma-nav__link">Getting Started</a></li>
         <li><a href="{{ site.baseurl }}/providers" class="tma-nav__link">Providers</a></li>
         <li><a href="{{ site.baseurl }}/api/overview" class="tma-nav__link">API</a></li>
@@ -58,14 +64,6 @@
         </ul>
       </div>
 
-      <div class="tma-sidebar__section">
-        <h3 class="tma-sidebar__title">Examples</h3>
-        <ul class="tma-sidebar__list">
-          <li><a href="{{ site.baseurl }}/examples" class="tma-sidebar__link {% if page.url == '/examples/' %}tma-sidebar__link--active{% endif %}">Overview</a></li>
-          <li><a href="{{ site.baseurl }}/examples/basic-usage" class="tma-sidebar__link {% if page.url == '/examples/basic-usage/' %}tma-sidebar__link--active{% endif %}">Basic Usage</a></li>
-        </ul>
-      </div>
-
       <div class="tma-sidebar__section">
         <h3 class="tma-sidebar__title">Community</h3>
         <ul class="tma-sidebar__list">
@@ -80,5 +78,40 @@
       {{ content }}
     </main>
   </div>
+  <script>
+    document.addEventListener('DOMContentLoaded', function() {
+      const navToggle = document.querySelector('.tma-nav__toggle');
+      const navMenu = document.querySelector('.tma-nav__menu');
+      
+      if (navToggle && navMenu) {
+        navToggle.addEventListener('click', function(e) {
+          e.preventDefault();
+          e.stopPropagation();
+          const isExpanded = navToggle.getAttribute('aria-expanded') === 'true';
+          navToggle.setAttribute('aria-expanded', !isExpanded);
+          navMenu.classList.toggle('tma-nav__menu--open');
+        });
+        
+        // Close menu when clicking on a link
+        const navLinks = navMenu.querySelectorAll('.tma-nav__link');
+        navLinks.forEach(function(link) {
+          link.addEventListener('click', function() {
+            navToggle.setAttribute('aria-expanded', 'false');
+            navMenu.classList.remove('tma-nav__menu--open');
+          });
+        });
+        
+        // Close menu when clicking outside
+        document.addEventListener('click', function(e) {
+          if (navMenu.classList.contains('tma-nav__menu--open') && 
+              !navMenu.contains(e.target) && 
+              !navToggle.contains(e.target)) {
+            navToggle.setAttribute('aria-expanded', 'false');
+            navMenu.classList.remove('tma-nav__menu--open');
+          }
+        });
+      }
+    });
+  </script>
 </body>
 </html>