vectra-client 0.3.3 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 510bd3a530df754db719892b7157846a72a29998659052fa7fda33b615ddab84
-  data.tar.gz: 6e853240a0231e909fda25709b72610f5d294e630f3576a0a52c0949e500e47f
+  metadata.gz: b0d48b8a6205df9a0d6545e3772e26da09f826f03d56751a6fa997e1a73d89f1
+  data.tar.gz: 25dc65ad327e03e7912a0b938739b6acf1d6708efd8fa41773d9bbae1053e3dc
 SHA512:
-  metadata.gz: a1658293c6bd4f62c777b106f40da783b56b68498b4cb73dda4af6df542277c8545105bafe47c6ba1fea106f68e934395df42f0d8453d35a2cdc3d89ef80500d
-  data.tar.gz: 9a108eb9be1df21a216824f2e9f0bbe60bb721bf6145cb2b4f772ecb1d7abe7b2e618c2d70d67455ed484ad65c05b20b3ec65485196740a51809fa9dd49a70c3
+  metadata.gz: 68fc7d7a2c941733bb8f42007dffa52989daedeb362da62c094d05dec7d02f8ca6d7ca8763194e9b51b4ecfe3f7a6e8db4418c7589caab31943f055f75f4c48a
+  data.tar.gz: f40ab28eb011943d4961e22c5d31b5a816a81cea1a2bf6afa238004adaa1cdd8558f10b0ee8d56376d6fc737788b16fc1acb7088778d8461ecb3a8db2ff85580

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,5 +1,30 @@
 # Changelog
 
+## [v0.4.0](https://github.com/stokry/vectra/tree/v0.4.0) (2026-01-12)
+
+### Added
+- Memory provider for in-memory vector storage
+- QueryBuilder for chainable query API
+- Batch operations with concurrent processing
+- Vector normalization methods (L2, L1)
+- Enhanced error message extraction
+
+### Fixed
+- Weaviate DELETE request query parameters
+- Qdrant error message extraction from nested status
+- Client ping error info capture
+- Credential rotation timeout parameter handling
+
+[Full Changelog](https://github.com/stokry/vectra/compare/v0.3.4...v0.4.0)
+
+## [v0.3.4](https://github.com/stokry/vectra/tree/v0.3.4) (2026-01-12)
+
+[Full Changelog](https://github.com/stokry/vectra/compare/v0.3.3...v0.3.4)
+
+## [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)
@@ -16,6 +41,7 @@
 
 [Full Changelog](https://github.com/stokry/vectra/compare/v0.2.1...v0.2.2)
 
+## [v0.2.1](https://github.com/stokry/vectra/tree/v0.2.1) (2026-01-08)
 
 [Full Changelog](https://github.com/stokry/vectra/compare/v0.2.0...v0.2.1)
 
@@ -23,14 +49,6 @@
 
 [Full Changelog](https://github.com/stokry/vectra/compare/v0.1.3...v0.2.0)
 
-## [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)
-
-### Changed
-
-- Version bump and minor maintenance release.
-
 ## [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)

data/README.md

@@ -17,6 +17,7 @@
 | **Qdrant** | Open Source | ✅ Supported |
 | **Weaviate** | Open Source | ✅ Supported |
 | **pgvector** | PostgreSQL | ✅ Supported |
+| **Memory** | In-Memory | ✅ Testing only |
 
 ## Installation
 
@@ -48,12 +49,38 @@ client.upsert(
   ]
 )
 
-# Search
+# Search (classic API)
 results = client.query(vector: [0.1, 0.2, 0.3], top_k: 5)
 results.each { |match| puts "#{match.id}: #{match.score}" }
 
+# Search (chainable Query Builder)
+results = client
+  .query('docs')
+  .vector([0.1, 0.2, 0.3])
+  .top_k(5)
+  .with_metadata
+  .execute
+
+results.each do |match|
+  puts "#{match.id}: #{match.score}"
+end
+
+# Normalize embeddings (for better cosine similarity)
+embedding = openai_response['data'][0]['embedding']
+normalized = Vectra::Vector.normalize(embedding)
+client.upsert(vectors: [{ id: 'doc-1', values: normalized }])
+
 # Delete
 client.delete(ids: ['doc-1', 'doc-2'])
+
+# Health check
+if client.healthy?
+  puts "Connection is healthy"
+end
+
+# Ping with latency
+status = client.ping
+puts "Provider: #{status[:provider]}, Latency: #{status[:latency_ms]}ms"
 ```
 
 ## Provider Examples
@@ -69,10 +96,16 @@ client = Vectra.qdrant(host: 'http://localhost:6333')
 client = Vectra.qdrant(host: 'https://your-cluster.qdrant.io', api_key: ENV['QDRANT_API_KEY'])
 
 # Weaviate
-client = Vectra.weaviate(host: 'http://localhost:8080', api_key: ENV['WEAVIATE_API_KEY'])
+client = Vectra.weaviate(
+  api_key: ENV['WEAVIATE_API_KEY'],
+  host: 'https://your-weaviate-instance'
+)
 
 # pgvector (PostgreSQL)
 client = Vectra.pgvector(connection_url: 'postgres://user:pass@localhost/mydb')
+
+# Memory (in-memory, testing only)
+client = Vectra.memory
 ```
 
 ## Features

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>

data/docs/assets/style.css

@@ -164,6 +164,40 @@ body {
   border-color: var(--tma-color-border-hover);
 }
 
+.tma-nav__toggle {
+  display: none;
+  flex-direction: column;
+  justify-content: space-around;
+  width: 24px;
+  height: 24px;
+  background: transparent;
+  border: none;
+  cursor: pointer;
+  padding: 0;
+  z-index: 10;
+}
+
+.tma-nav__toggle-line {
+  width: 100%;
+  height: 2px;
+  background: var(--tma-color-text-primary);
+  border-radius: 2px;
+  transition: all var(--tma-transition-normal);
+  transform-origin: center;
+}
+
+.tma-nav__toggle[aria-expanded="true"] .tma-nav__toggle-line:nth-child(1) {
+  transform: rotate(45deg) translate(6px, 6px);
+}
+
+.tma-nav__toggle[aria-expanded="true"] .tma-nav__toggle-line:nth-child(2) {
+  opacity: 0;
+}
+
+.tma-nav__toggle[aria-expanded="true"] .tma-nav__toggle-line:nth-child(3) {
+  transform: rotate(-45deg) translate(6px, -6px);
+}
+
 /* ============================================
    Hero Section
    ============================================ */
@@ -751,8 +785,49 @@ code {
     padding: 0 var(--tma-spacing-md);
   }
   
+  .tma-nav__toggle {
+    display: flex;
+  }
+  
   .tma-nav__menu {
-    display: none;
+    display: flex;
+    position: fixed;
+    top: var(--tma-header-height);
+    left: 0;
+    right: 0;
+    height: 0;
+    max-height: 400px;
+    background: rgba(10, 10, 15, 0.98);
+    backdrop-filter: blur(12px);
+    flex-direction: column;
+    align-items: stretch;
+    padding: 0;
+    gap: var(--tma-spacing-xs);
+    transform: translateX(100%);
+    transition: transform var(--tma-transition-normal), opacity var(--tma-transition-normal), height var(--tma-transition-normal), padding var(--tma-transition-normal);
+    z-index: 999;
+    overflow-y: auto;
+    opacity: 0;
+    pointer-events: none;
+    border-top: 1px solid var(--tma-color-border);
+  }
+  
+  .tma-nav__menu.tma-nav__menu--open {
+    transform: translateX(0);
+    opacity: 1;
+    pointer-events: auto;
+    height: 400px;
+    padding: var(--tma-spacing-lg);
+  }
+  
+  .tma-nav__menu li {
+    width: 100%;
+  }
+  
+  .tma-nav__link {
+    width: 100%;
+    padding: var(--tma-spacing-md);
+    justify-content: flex-start;
   }
   
   .tma-hero {
@@ -925,3 +1000,153 @@ code {
   color: #ef4444;
   font-weight: bold;
 }
+
+/* ============================================
+   Dashboard Showcase
+   ============================================ */
+.tma-dashboard-showcase {
+  display: grid;
+  grid-template-columns: 1fr 1fr;
+  gap: var(--tma-spacing-2xl);
+  margin: var(--tma-spacing-2xl) 0;
+  padding: var(--tma-spacing-xl);
+  background: var(--tma-color-bg-secondary);
+  border-radius: var(--tma-radius-lg);
+  border: 1px solid var(--tma-color-border);
+}
+
+.tma-dashboard-showcase__image {
+  position: relative;
+  border-radius: var(--tma-radius-md);
+  overflow: hidden;
+  box-shadow: var(--tma-shadow-lg);
+  background: var(--tma-color-bg-primary);
+  border: 1px solid var(--tma-color-border);
+}
+
+.tma-dashboard-screenshot {
+  width: 100%;
+  height: auto;
+  display: block;
+  border-radius: var(--tma-radius-md);
+  transition: transform var(--tma-transition-normal);
+}
+
+.tma-dashboard-showcase__image:hover .tma-dashboard-screenshot {
+  transform: scale(1.02);
+}
+
+.tma-dashboard-showcase__features {
+  display: flex;
+  flex-direction: column;
+  justify-content: center;
+}
+
+.tma-dashboard-showcase__features h4 {
+  font-size: 1.3rem;
+  font-weight: 700;
+  margin-bottom: var(--tma-spacing-lg);
+  color: var(--tma-color-text-primary);
+}
+
+.tma-dashboard-showcase__features ul {
+  list-style: none;
+  padding-left: 0;
+  margin: 0 0 var(--tma-spacing-xl) 0;
+}
+
+.tma-dashboard-showcase__features li {
+  margin-bottom: var(--tma-spacing-md);
+  padding-left: var(--tma-spacing-lg);
+  position: relative;
+  color: var(--tma-color-text-secondary);
+  line-height: 1.6;
+}
+
+.tma-dashboard-showcase__features li::before {
+  content: '▸';
+  position: absolute;
+  left: 0;
+  color: var(--tma-color-accent-primary);
+  font-weight: bold;
+}
+
+.tma-dashboard-showcase__features strong {
+  color: var(--tma-color-text-primary);
+  font-weight: 600;
+}
+
+.tma-dashboard-showcase__actions {
+  display: flex;
+  gap: var(--tma-spacing-md);
+  flex-wrap: wrap;
+  margin-top: var(--tma-spacing-lg);
+}
+
+.tma-button {
+  display: inline-flex;
+  align-items: center;
+  gap: var(--tma-spacing-sm);
+  padding: var(--tma-spacing-md) var(--tma-spacing-lg);
+  border-radius: var(--tma-radius-md);
+  font-weight: 600;
+  font-size: 0.95rem;
+  text-decoration: none;
+  transition: all var(--tma-transition-fast);
+  border: 1px solid transparent;
+}
+
+.tma-button--primary {
+  background: var(--tma-color-accent-primary);
+  color: #0a0a0f!important;
+  border-color: var(--tma-color-accent-primary);
+}
+
+.tma-button--primary:hover {
+  background: var(--tma-color-accent-light);
+  border-color: var(--tma-color-accent-light);
+  color: #0a0a0f!important;
+  transform: translateY(-1px);
+  box-shadow: var(--tma-shadow-md);
+}
+
+.tma-button--secondary {
+  background: transparent;
+  color: var(--tma-color-accent-primary);
+  border-color: var(--tma-color-accent-primary);
+}
+
+.tma-button--secondary:hover {
+  background: var(--tma-color-accent-muted);
+  border-color: var(--tma-color-accent-light);
+  color: var(--tma-color-accent-light);
+  transform: translateY(-1px);
+}
+
+/* Responsive Dashboard Showcase */
+@media (max-width: 1024px) {
+  .tma-dashboard-showcase {
+    grid-template-columns: 1fr;
+    gap: var(--tma-spacing-xl);
+  }
+  
+  .tma-dashboard-showcase__features {
+    order: -1;
+  }
+}
+
+@media (max-width: 768px) {
+  .tma-dashboard-showcase {
+    padding: var(--tma-spacing-md);
+    margin: var(--tma-spacing-lg) 0;
+  }
+  
+  .tma-dashboard-showcase__actions {
+    flex-direction: column;
+  }
+  
+  .tma-button {
+    width: 100%;
+    justify-content: center;
+  }
+}

data/docs/examples/index.md

@@ -48,7 +48,16 @@ Practical examples to get started with Vectra.
   </div>
 </div>
 
+## Real-World Examples
+
+<div class="tma-comparison-card">
+  <h4>Production Use Cases</h4>
+  <p>E-commerce search, RAG chatbots, multi-tenant SaaS, and batch processing</p>
+  <a href="{{ site.baseurl }}/examples/real-world/">View Examples →</a>
+</div>
+
 ## More Resources
 
 - [GitHub Examples](https://github.com/stokry/vectra/tree/main/examples) - Full example files
+- [Comprehensive Demo](https://github.com/stokry/vectra/tree/main/examples/comprehensive_demo.rb) - Complete feature demonstration
 - [Integration Tests](https://github.com/stokry/vectra/tree/main/spec/integration) - Real-world test cases