@mastra/turbopuffer 1.2.1 → 1.2.2-alpha.0

package/dist/docs/SKILL.md

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

package/dist/docs/assets/SOURCE_MAP.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.2.1",
+  "version": "1.2.2-alpha.0",
   "package": "@mastra/turbopuffer",
   "exports": {},
   "modules": {}

package/dist/docs/references/reference-vectors-turbopuffer.md

@@ -28,11 +28,13 @@ The TurbopufferVector class provides vector search using [Turbopuffer](https://t
 
 ### `createIndex()`
 
+Turbopuffer has no explicit create-index operation. `createIndex()` validates the arguments and records the dimension and metric locally; the namespace is created in Turbopuffer on the first `upsert()`.
+
 **indexName** (`string`): Name of the index to create
 
 **dimension** (`number`): Vector dimension (must match your embedding model)
 
-**metric** (`'cosine' | 'euclidean' | 'dotproduct'`): Distance metric for similarity search (Default: `cosine`)
+**metric** (`'cosine' | 'euclidean'`): Distance metric for similarity search. 'dotproduct' isn't supported and throws an error. (Default: `cosine`)
 
 ### `upsert()`
 
@@ -80,7 +82,7 @@ interface IndexStats {
 
 ### `updateVector()`
 
-Update a single vector by ID or by metadata filter. Either `id` or `filter` must be provided, but not both.
+Update a single vector by ID, or every vector that matches a metadata filter. Either `id` or `filter` must be provided, but not both.
 
 **indexName** (`string`): Name of the index containing the vector
 
@@ -114,7 +116,7 @@ Query results are returned in this format:
 interface QueryResult {
   id: string
   score: number
-  metadata: Record<string, any>
+  metadata?: Record<string, any>
   vector?: number[] // Only included if includeVector is true
 }
 ```
@@ -144,17 +146,21 @@ schemaConfigForIndex: (indexName: string) => {
 
 ## Error handling
 
-The store throws typed errors that can be caught:
+The store throws `MastraError` instances from `@mastra/core/error`:
 
 ```typescript
+import { MastraError } from '@mastra/core/error'
+
 try {
   await store.query({
     indexName: 'index_name',
     queryVector: queryVector,
   })
 } catch (error) {
-  if (error instanceof VectorStoreError) {
-    console.log(error.code) // 'connection_failed' | 'invalid_dimension' | etc
+  if (error instanceof MastraError) {
+    console.log(error.id) // 'MASTRA_VECTOR_TURBOPUFFER_QUERY_FAILED'
+    console.log(error.domain) // 'STORAGE'
+    console.log(error.category) // 'USER' | 'THIRD_PARTY'
     console.log(error.details) // Additional error context
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mastra/turbopuffer",
-  "version": "1.2.1",
+  "version": "1.2.2-alpha.0",
   "description": "Turbopuffer vector store provider for Mastra",
   "type": "module",
   "files": [
@@ -27,18 +27,18 @@
   },
   "devDependencies": {
     "@types/node": "22.20.1",
-    "@vitest/coverage-v8": "4.1.10",
-    "@vitest/ui": "4.1.10",
+    "@vitest/coverage-v8": "4.1.11",
+    "@vitest/ui": "4.1.11",
     "dotenv": "^17.4.2",
     "eslint": "^10.7.0",
     "tsdown": "0.22.9",
     "tsx": "^4.23.1",
     "typescript": "^7.0.2",
-    "vitest": "4.1.10",
-    "@internal/lint": "0.0.130",
-    "@mastra/core": "1.64.0",
-    "@internal/types-builder": "0.0.105",
-    "@internal/storage-test-utils": "0.0.126"
+    "vitest": "4.1.11",
+    "@internal/storage-test-utils": "0.0.140",
+    "@internal/lint": "0.0.144",
+    "@internal/types-builder": "0.0.119",
+    "@mastra/core": "1.78.1-alpha.0"
   },
   "peerDependencies": {
     "@mastra/core": ">=1.0.0-0 <2.0.0-0"