@mastra/convex 1.5.0 → 1.5.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/CHANGELOG.md CHANGED
@@ -1,5 +1,23 @@
1
1
  # @mastra/convex
2
2
 
3
+ ## 1.5.1
4
+
5
+ ### Patch Changes
6
+
7
+ - dependencies updates: ([#19779](https://github.com/mastra-ai/mastra/pull/19779))
8
+ - Updated dependency [`convex@^1.42.3` ↗︎](https://www.npmjs.com/package/convex/v/1.42.3) (from `^1.33.1`, in `dependencies`)
9
+ - Updated dependencies [[`3f472b4`](https://github.com/mastra-ai/mastra/commit/3f472b468892a1ff14ccb43cc0343b86f7d8fd7d), [`ba369f2`](https://github.com/mastra-ai/mastra/commit/ba369f2a0aaf998da0d6aa033d26f64f96bef8ac), [`35b929b`](https://github.com/mastra-ai/mastra/commit/35b929b7abc3d20d85c7985880960ac2d04a6c86), [`55c9e24`](https://github.com/mastra-ai/mastra/commit/55c9e248c27c1d72b5bb7e94ea6b8a3999eee49f), [`dcfed93`](https://github.com/mastra-ai/mastra/commit/dcfed93e1e256c6abfa792cbb7ca836f5d0e8638), [`2876e15`](https://github.com/mastra-ai/mastra/commit/2876e15b4d2f616a3bc1ed3af57d546c268384ce), [`9b3626a`](https://github.com/mastra-ai/mastra/commit/9b3626aeb1d16fcd34b0a8e94c114ddb80a3b240), [`4696963`](https://github.com/mastra-ai/mastra/commit/469696312ac4c618bc8475b0c5ed7949b8a3455e), [`723aa54`](https://github.com/mastra-ai/mastra/commit/723aa5437106bdb708ae03c0ef6b77aa11291e73), [`07f5b4b`](https://github.com/mastra-ai/mastra/commit/07f5b4ba9d608d88865030732e580298296adf99), [`723aa54`](https://github.com/mastra-ai/mastra/commit/723aa5437106bdb708ae03c0ef6b77aa11291e73), [`723aa54`](https://github.com/mastra-ai/mastra/commit/723aa5437106bdb708ae03c0ef6b77aa11291e73), [`598080f`](https://github.com/mastra-ai/mastra/commit/598080f224edb3f0f5b801035b067fac50a56a03)]:
10
+ - @mastra/core@1.55.0
11
+
12
+ ## 1.5.1-alpha.0
13
+
14
+ ### Patch Changes
15
+
16
+ - dependencies updates: ([#19779](https://github.com/mastra-ai/mastra/pull/19779))
17
+ - Updated dependency [`convex@^1.42.3` ↗︎](https://www.npmjs.com/package/convex/v/1.42.3) (from `^1.33.1`, in `dependencies`)
18
+ - Updated dependencies [[`723aa54`](https://github.com/mastra-ai/mastra/commit/723aa5437106bdb708ae03c0ef6b77aa11291e73), [`723aa54`](https://github.com/mastra-ai/mastra/commit/723aa5437106bdb708ae03c0ef6b77aa11291e73), [`723aa54`](https://github.com/mastra-ai/mastra/commit/723aa5437106bdb708ae03c0ef6b77aa11291e73)]:
19
+ - @mastra/core@1.55.0-alpha.3
20
+
3
21
  ## 1.5.0
4
22
 
5
23
  ### Minor Changes
@@ -3,7 +3,7 @@ name: mastra-convex
3
3
  description: Documentation for @mastra/convex. Use when working with @mastra/convex APIs, configuration, or implementation.
4
4
  metadata:
5
5
  package: "@mastra/convex"
6
- version: "1.5.0"
6
+ version: "1.5.1"
7
7
  ---
8
8
 
9
9
  ## When to use
@@ -1,5 +1,5 @@
1
1
  {
2
- "version": "1.5.0",
2
+ "version": "1.5.1",
3
3
  "package": "@mastra/convex",
4
4
  "exports": {},
5
5
  "modules": {}
@@ -182,7 +182,7 @@ During batched cleanup, cache metadata can temporarily use an internal `deleted`
182
182
 
183
183
  `clear()` only removes rows whose stored `keyPrefix` exactly matches the configured `keyPrefix`. It doesn't clear nested prefixes by string prefix matching. Each `listPush()` refreshes the list TTL using the cache's configured `ttlMs`.
184
184
 
185
- Use a non-empty `keyPrefix` unless you intentionally want `clear()` to remove every cache key in the deployment. Expired list rows are reclaimed incrementally during reads and writes; `clear()` removes all rows for the prefix.
185
+ Use a non-empty `keyPrefix` unless you intentionally want `clear()` to remove every cache key in the deployment. Expired list rows are reclaimed incrementally during reads and writes. `clear()` removes all rows for the prefix.
186
186
 
187
187
  `ConvexServerCache` works best for durable replay of moderate-frequency events. For high-frequency token streams, prefer batching events or using a lower-latency cache backend.
188
188
 
@@ -217,14 +217,14 @@ All typed tables include:
217
217
  - An `id` field for Mastra's record ID (distinct from Convex's auto-generated `_id`)
218
218
  - A `by_record_id` index for efficient lookups by Mastra ID
219
219
 
220
- This design ensures compatibility with Mastra's storage contract while leveraging Convex's automatic indexing and real-time capabilities.
220
+ This design ensures compatibility with Mastra's storage contract while using Convex's automatic indexing and real-time capabilities.
221
221
 
222
222
  ### Environment variables
223
223
 
224
224
  Set these environment variables for your deployment:
225
225
 
226
- - `CONVEX_URL` Your Convex deployment URL
227
- - `CONVEX_ADMIN_KEY` Admin authentication token (get from Convex dashboard)
226
+ - `CONVEX_URL`: Your Convex deployment URL
227
+ - `CONVEX_ADMIN_KEY`: Admin authentication token (get from Convex dashboard)
228
228
 
229
229
  ## Related
230
230
 
@@ -351,7 +351,7 @@ interface QueryResult {
351
351
 
352
352
  ## Metadata filtering
353
353
 
354
- `ConvexVector` supports metadata filtering with various operators. These filters are applied by the adapter after vectors are loaded from Convex.
354
+ `ConvexVector` supports metadata filtering with operators. These filters are applied by the adapter after vectors are loaded from Convex.
355
355
 
356
356
  ```typescript
357
357
  // Simple equality
@@ -415,7 +415,7 @@ Vector similarity search is performed with cosine similarity in the Mastra adapt
415
415
  - Filters must target fields listed in the Convex vector index `filterFields`.
416
416
  - Use one dedicated table per Mastra vector index to avoid cross-index results.
417
417
 
418
- Use an external vector database when you need dynamic index creation at runtime, metadata-only queries, complex filter operators, filter-based bulk updates or deletes, or result limits above Convex's native vector search cap.
418
+ Use an external vector database when you need runtime-defined index creation at runtime, metadata-only queries, complex filter operators, filter-based bulk updates or deletes, or result limits above Convex's native vector search cap.
419
419
 
420
420
  ## Related
421
421
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@mastra/convex",
3
- "version": "1.5.0",
3
+ "version": "1.5.1",
4
4
  "description": "Convex provider for Mastra - includes both storage and vector adapters plus Convex server helpers",
5
5
  "type": "module",
6
6
  "main": "dist/index.js",
@@ -40,7 +40,7 @@
40
40
  },
41
41
  "license": "Apache-2.0",
42
42
  "dependencies": {
43
- "convex": "^1.33.1"
43
+ "convex": "^1.42.3"
44
44
  },
45
45
  "devDependencies": {
46
46
  "@types/node": "22.20.1",
@@ -52,10 +52,10 @@
52
52
  "tsx": "^4.23.1",
53
53
  "typescript": "^6.0.3",
54
54
  "vitest": "4.1.10",
55
- "@internal/lint": "0.0.118",
56
- "@internal/types-builder": "0.0.93",
57
- "@internal/storage-test-utils": "0.0.114",
58
- "@mastra/core": "1.54.0"
55
+ "@internal/lint": "0.0.119",
56
+ "@internal/storage-test-utils": "0.0.115",
57
+ "@internal/types-builder": "0.0.94",
58
+ "@mastra/core": "1.55.0"
59
59
  },
60
60
  "peerDependencies": {
61
61
  "@mastra/core": ">=1.50.0-0 <2.0.0-0"