@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
|
package/dist/docs/SKILL.md
CHANGED
|
@@ -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
|
|
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
|
|
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
|
|
227
|
-
- `CONVEX_ADMIN_KEY
|
|
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
|
|
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
|
|
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.
|
|
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.
|
|
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.
|
|
56
|
-
"@internal/
|
|
57
|
-
"@internal/
|
|
58
|
-
"@mastra/core": "1.
|
|
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"
|