@mastra/upstash 1.4.4-alpha.0 → 1.4.4

package/README.md

@@ -1,6 +1,6 @@
 # @mastra/upstash
 
-Upstash provider for Mastra that includes both vector store and database storage capabilities.
+Use Upstash Redis as serverless Mastra storage with REST credentials, namespaced keys, durable persistence, and deployment-friendly connections.
 
 ## Installation
 
@@ -8,142 +8,9 @@ Upstash provider for Mastra that includes both vector store and database storage
 npm install @mastra/upstash
 ```
 
-## Vector Store Usage
+## Usage
 
-```typescript
-import { UpstashVector } from '@mastra/upstash';
-
-// In upstash they refer to the store as an index
-const vectorStore = new UpstashVector({
-  url: process.env.UPSTASH_VECTOR_REST_URL,
-  token: process.env.UPSTASH_VECTOR_TOKEN
-});
-
-// Add vectors
-const vectors = [[0.1, 0.2, ...], [0.3, 0.4, ...]];
-const metadata = [{ text: 'doc1' }, { text: 'doc2' }];
-const ids = await vectorStore.upsert({
-  indexName: 'my-namespace',
-  vectors,
-  metadata
-});
-
-// There is no store.createIndex call here, Upstash creates indexes (known as namespaces in Upstash) automatically
-// when you upsert if that namespace does not exist yet.
-
-// Query vectors
-const results = await vectorStore.query({
-  indexName: 'my-namespace',
-  queryVector: [0.1, 0.2, ...],
-  topK: 10,
-  filter: { text: { $eq: 'doc1' } },
-  includeVector: false
-});
-```
-
-### Hybrid Vector Search (Dense + Sparse)
-
-Upstash supports hybrid search that combines semantic search (dense vectors) with keyword-based search (sparse vectors) for improved relevance and accuracy.
-
-#### Upserting Hybrid Vectors
-
-```typescript
-import { UpstashVector } from '@mastra/upstash';
-
-const vectorStore = new UpstashVector({
-  url: process.env.UPSTASH_VECTOR_REST_URL,
-  token: process.env.UPSTASH_VECTOR_TOKEN
-});
-
-const vectors = [[0.1, 0.2, 0.3, ...], [0.4, 0.5, 0.6, ...]];
-const sparseVectors = [
-  { indices: [1, 5, 10], values: [0.8, 0.6, 0.4] },
-  { indices: [2, 6, 11], values: [0.7, 0.5, 0.3] }
-];
-const metadata = [{ title: 'Document 1' }, { title: 'Document 2' }];
-
-const ids = await vectorStore.upsert({
-  indexName: 'hybrid-index',
-  vectors,
-  sparseVectors,
-  metadata
-});
-```
-
-#### Querying with Hybrid Search
-
-```typescript
-import { FusionAlgorithm, QueryMode } from '@upstash/vector';
-
-// Query with both dense and sparse vectors (default hybrid mode)
-const results = await vectorStore.query({
-  indexName: 'hybrid-index',
-  queryVector: [0.1, 0.2, 0.3, ...],
-  sparseVector: { indices: [1, 5], values: [0.9, 0.7] },
-  topK: 10,
-  fusionAlgorithm: FusionAlgorithm.RRF,
-  includeVector: false
-});
-
-// Dense-only query (backward compatible)
-const denseResults = await vectorStore.query({
-  indexName: 'hybrid-index',
-  queryVector: [0.1, 0.2, 0.3, ...],
-  topK: 10
-});
-
-// Query only the dense component for custom reranking
-const denseOnlyResults = await vectorStore.query({
-  indexName: 'hybrid-index',
-  queryVector: [0.1, 0.2, 0.3, ...],
-  queryMode: QueryMode.DENSE,
-  topK: 10
-});
-
-// Query only the sparse component for custom reranking
-const sparseOnlyResults = await vectorStore.query({
-  indexName: 'hybrid-index',
-  queryVector: [0.1, 0.2, 0.3, ...],              // Still needed for dense index structure
-  sparseVector: { indices: [1, 5], values: [0.9, 0.7] },
-  queryMode: QueryMode.SPARSE,
-  topK: 10
-});
-
-// Explicit hybrid mode (same as default)
-const explicitHybridResults = await vectorStore.query({
-  indexName: 'hybrid-index',
-  queryVector: [0.1, 0.2, 0.3, ...],
-  sparseVector: { indices: [1, 5], values: [0.9, 0.7] },
-  queryMode: QueryMode.HYBRID,
-  fusionAlgorithm: FusionAlgorithm.RRF,
-  topK: 10
-});
-```
-
-#### Fusion Algorithms & Query Modes
-
-Upstash provides built-in fusion algorithms to combine dense and sparse search results:
-
-- **RRF (Reciprocal Rank Fusion)**: Default algorithm that combines rankings from both dense and sparse searches
-- **DBSF (Distribution-Based Score Fusion)**
-
-Query modes enable fine-grained control over hybrid index queries:
-
-- **`QueryMode.HYBRID`**: Default mode that queries both dense and sparse components and fuses results
-- **`QueryMode.DENSE`**: Query only the dense component, useful for custom reranking scenarios
-- **`QueryMode.SPARSE`**: Query only the sparse component, useful for custom reranking scenarios
-
-Use query modes when you want to implement custom fusion logic or need separate dense/sparse results for advanced reranking algorithms.
-
-### Vector Store Configuration
-
-The Upstash vector store requires the following configuration:
-
-- `UPSTASH_VECTOR_REST_URL`: Your Upstash Vector REST URL
-- `UPSTASH_VECTOR_TOKEN`: Your Upstash Vector REST token
-- `UPSTASH_INDEX`: Name of the index to use
-
-## Database Storage Usage
+Configure the database credentials required by your provider.
 
 ```typescript
 import { UpstashStore } from '@mastra/upstash';
@@ -154,39 +21,14 @@ const store = new UpstashStore({
 });
 ```
 
-### Database Storage Configuration
-
-The Upstash store requires the following configuration:
-
-- `UPSTASH_REDIS_REST_URL`: Your Upstash Redis REST URL
-- `UPSTASH_REDIS_REST_TOKEN`: Your Upstash Redis REST token
-
-## Vector Store Methods
+## Documentation
 
-- `createIndex({ indexName, dimension, metric? })`: Create a new namespace
-- `upsert({ indexName, vectors, sparseVectors?, metadata?, ids? })`: Add or update vectors (supports hybrid search)
-- `query({ indexName, queryVector, sparseQueryVector?, topK?, filter?, includeVector?, includeMetadata?, mode?, fusionAlgorithm? })`: Search for similar vectors
-- `updateVector({ indexName, id?, filter?, update })`: Update a single vector by ID or metadata filter
-- `deleteVector({ indexName, id })`: Delete a single vector by ID
-- `deleteVectors({ indexName, ids?, filter? })`: Delete multiple vectors by IDs or metadata filter
-- `listIndexes()`: List all namespaces
-- `describeIndex({ indexName })`: Get namespace statistics
-- `deleteIndex({ indexName })`: Delete a namespace
+- [Upstash](https://mastra.ai/integrations/databases/upstash)
 
-## Features
+## Changelog
 
-- Serverless vector database and key-value store
-- **Hybrid vector search** combining dense and sparse vectors
-- **Advanced fusion algorithms** (RRF) for optimal search ranking
-- Pay-per-use pricing
-- Low latency global access
-- REST API interface
-- Built-in vector similarity search
-- Durable storage for chat history and agent memory
-- Backward compatible with existing dense vector implementations
+See the [package changelog](https://github.com/mastra-ai/mastra/blob/main/stores/upstash/CHANGELOG.md) for version history and release notes.
 
-## Related Links
+## Support
 
-- [Upstash Vector Documentation](https://docs.upstash.com/vector)
-- [Upstash Hybrid Indexes Documentation](https://docs.upstash.com/vector/features/hybridindexes)
-- [Upstash Redis Documentation](https://docs.upstash.com/redis)
+We have an [open community Discord](https://discord.gg/mastra-ai). Come and say hello and let us know if you have any questions or need any help getting things running.

package/dist/docs/SKILL.md

@@ -3,7 +3,7 @@ name: mastra-upstash
 description: Documentation for @mastra/upstash. Use when working with @mastra/upstash APIs, configuration, or implementation.
 metadata:
   package: "@mastra/upstash"
-  version: "1.4.4-alpha.0"
+  version: "1.4.4"
 ---
 
 ## When to use

package/dist/docs/assets/SOURCE_MAP.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.4.4-alpha.0",
+  "version": "1.4.4",
   "package": "@mastra/upstash",
   "exports": {},
   "modules": {}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mastra/upstash",
-  "version": "1.4.4-alpha.0",
+  "version": "1.4.4",
   "description": "Upstash provider for Mastra - includes both vector and db storage capabilities",
   "type": "module",
   "main": "dist/index.js",
@@ -22,7 +22,7 @@
   "dependencies": {
     "@upstash/redis": "^1.37.0",
     "@upstash/vector": "^1.2.3",
-    "@mastra/redis": "1.4.3-alpha.0"
+    "@mastra/redis": "1.4.3"
   },
   "devDependencies": {
     "@types/node": "22.20.1",
@@ -34,10 +34,10 @@
     "tsx": "^4.23.1",
     "typescript": "^7.0.2",
     "vitest": "4.1.10",
-    "@internal/storage-test-utils": "0.0.125",
-    "@internal/lint": "0.0.129",
-    "@internal/types-builder": "0.0.104",
-    "@mastra/core": "1.64.0-alpha.2"
+    "@internal/lint": "0.0.130",
+    "@internal/storage-test-utils": "0.0.126",
+    "@internal/types-builder": "0.0.105",
+    "@mastra/core": "1.64.0"
   },
   "peerDependencies": {
     "@mastra/core": ">=1.61.0-0 <2.0.0-0"