@mastra/convex 0.0.1 → 0.1.0-beta.1

package/CHANGELOG.md

@@ -1,5 +1,60 @@
 # @mastra/convex
 
+## 0.1.0-beta.1
+
+### Minor Changes
+
+- Add `disableInit` option to all storage adapters ([#10851](https://github.com/mastra-ai/mastra/pull/10851))
+
+  Adds a new `disableInit` config option to all storage providers that allows users to disable automatic table creation/migrations at runtime. This is useful for CI/CD pipelines where you want to run migrations during deployment with elevated credentials, then run the application with `disableInit: true` so it doesn't attempt schema changes at runtime.
+
+  ```typescript
+  // CI/CD script - run migrations
+  const storage = new PostgresStore({
+    connectionString: DATABASE_URL,
+    id: 'pg-storage',
+  });
+  await storage.init();
+
+  // Runtime - skip auto-init
+  const storage = new PostgresStore({
+    connectionString: DATABASE_URL,
+    id: 'pg-storage',
+    disableInit: true,
+  });
+  ```
+
+### Patch Changes
+
+- Standardize error IDs across all storage and vector stores using centralized helper functions (`createStorageErrorId` and `createVectorErrorId`). This ensures consistent error ID patterns (`MASTRA_STORAGE_{STORE}_{OPERATION}_{STATUS}` and `MASTRA_VECTOR_{STORE}_{OPERATION}_{STATUS}`) across the codebase for better error tracking and debugging. ([#10913](https://github.com/mastra-ai/mastra/pull/10913))
+
+- Updated dependencies [[`3076c67`](https://github.com/mastra-ai/mastra/commit/3076c6778b18988ae7d5c4c5c466366974b2d63f), [`85d7ee1`](https://github.com/mastra-ai/mastra/commit/85d7ee18ff4e14d625a8a30ec6656bb49804989b), [`c6c1092`](https://github.com/mastra-ai/mastra/commit/c6c1092f8fbf76109303f69e000e96fd1960c4ce), [`81dc110`](https://github.com/mastra-ai/mastra/commit/81dc11008d147cf5bdc8996ead1aa61dbdebb6fc), [`7aedb74`](https://github.com/mastra-ai/mastra/commit/7aedb74883adf66af38e270e4068fd42e7a37036), [`8f02d80`](https://github.com/mastra-ai/mastra/commit/8f02d800777397e4b45d7f1ad041988a8b0c6630), [`d7aad50`](https://github.com/mastra-ai/mastra/commit/d7aad501ce61646b76b4b511e558ac4eea9884d0), [`ce0a73a`](https://github.com/mastra-ai/mastra/commit/ce0a73abeaa75b10ca38f9e40a255a645d50ebfb), [`a02e542`](https://github.com/mastra-ai/mastra/commit/a02e542d23179bad250b044b17ff023caa61739f), [`a372c64`](https://github.com/mastra-ai/mastra/commit/a372c640ad1fd12e8f0613cebdc682fc156b4d95), [`8846867`](https://github.com/mastra-ai/mastra/commit/8846867ffa9a3746767618e314bebac08eb77d87), [`42a42cf`](https://github.com/mastra-ai/mastra/commit/42a42cf3132b9786feecbb8c13c583dce5b0e198), [`ae08bf0`](https://github.com/mastra-ai/mastra/commit/ae08bf0ebc6a4e4da992b711c4a389c32ba84cf4), [`21735a7`](https://github.com/mastra-ai/mastra/commit/21735a7ef306963554a69a89b44f06c3bcd85141), [`1d877b8`](https://github.com/mastra-ai/mastra/commit/1d877b8d7b536a251c1a7a18db7ddcf4f68d6f8b)]:
+  - @mastra/core@1.0.0-beta.7
+
+## 0.0.2-beta.0
+
+### Patch Changes
+
+- feat(storage): support querying messages from multiple threads ([#10663](https://github.com/mastra-ai/mastra/pull/10663))
+  - Fixed TypeScript errors where `threadId: string | string[]` was being passed to places expecting `Scalar` type
+  - Added proper multi-thread support for `listMessages` across all adapters when `threadId` is an array
+  - Updated `_getIncludedMessages` to look up message threadId by ID (since message IDs are globally unique)
+  - **upstash**: Added `msg-idx:{messageId}` index for O(1) message lookups (backwards compatible with fallback to scan for old messages, with automatic backfill)
+
+- Convex storage and vector adapter improvements: ([#10421](https://github.com/mastra-ai/mastra/pull/10421))
+  - Refactored to use typed Convex tables for each Mastra domain (threads, messages, resources, workflows, scorers, vectors)
+  - All tables now include `id` field for Mastra record ID and `by_record_id` index for efficient lookups
+  - Fixed 32k document limit issues by using batched operations and indexed queries
+  - Updated `saveMessages` and `updateMessages` to automatically update thread `updatedAt` timestamps
+  - Fixed `listMessages` to properly fetch messages from different threads when using `include`
+  - Fixed `saveResource` to preserve `undefined` metadata instead of converting to empty object
+  - Rewrote `ConvexAdminClient` to use Convex HTTP API directly with proper admin authentication
+  - Added comprehensive documentation for storage and vector adapters
+  - Exported pre-built table definitions from `@mastra/convex/server` for easy schema setup
+
+- Updated dependencies [[`ac0d2f4`](https://github.com/mastra-ai/mastra/commit/ac0d2f4ff8831f72c1c66c2be809706d17f65789), [`1a0d3fc`](https://github.com/mastra-ai/mastra/commit/1a0d3fc811482c9c376cdf79ee615c23bae9b2d6), [`85a628b`](https://github.com/mastra-ai/mastra/commit/85a628b1224a8f64cd82ea7f033774bf22df7a7e), [`c237233`](https://github.com/mastra-ai/mastra/commit/c23723399ccedf7f5744b3f40997b79246bfbe64), [`15f9e21`](https://github.com/mastra-ai/mastra/commit/15f9e216177201ea6e3f6d0bfb063fcc0953444f), [`ff94dea`](https://github.com/mastra-ai/mastra/commit/ff94dea935f4e34545c63bcb6c29804732698809), [`5b2ff46`](https://github.com/mastra-ai/mastra/commit/5b2ff4651df70c146523a7fca773f8eb0a2272f8), [`db41688`](https://github.com/mastra-ai/mastra/commit/db4168806d007417e2e60b4f68656dca4e5f40c9), [`5ca599d`](https://github.com/mastra-ai/mastra/commit/5ca599d0bb59a1595f19f58473fcd67cc71cef58), [`bff1145`](https://github.com/mastra-ai/mastra/commit/bff114556b3cbadad9b2768488708f8ad0e91475), [`5c8ca24`](https://github.com/mastra-ai/mastra/commit/5c8ca247094e0cc2cdbd7137822fb47241f86e77), [`e191844`](https://github.com/mastra-ai/mastra/commit/e1918444ca3f80e82feef1dad506cd4ec6e2875f), [`22553f1`](https://github.com/mastra-ai/mastra/commit/22553f11c63ee5e966a9c034a349822249584691), [`7237163`](https://github.com/mastra-ai/mastra/commit/72371635dbf96a87df4b073cc48fc655afbdce3d), [`2500740`](https://github.com/mastra-ai/mastra/commit/2500740ea23da067d6e50ec71c625ab3ce275e64), [`873ecbb`](https://github.com/mastra-ai/mastra/commit/873ecbb517586aa17d2f1e99283755b3ebb2863f), [`4f9bbe5`](https://github.com/mastra-ai/mastra/commit/4f9bbe5968f42c86f4930b8193de3c3c17e5bd36), [`02e51fe`](https://github.com/mastra-ai/mastra/commit/02e51feddb3d4155cfbcc42624fd0d0970d032c0), [`8f3fa3a`](https://github.com/mastra-ai/mastra/commit/8f3fa3a652bb77da092f913ec51ae46e3a7e27dc), [`cd29ad2`](https://github.com/mastra-ai/mastra/commit/cd29ad23a255534e8191f249593849ed29160886), [`bdf4d8c`](https://github.com/mastra-ai/mastra/commit/bdf4d8cdc656d8a2c21d81834bfa3bfa70f56c16), [`854e3da`](https://github.com/mastra-ai/mastra/commit/854e3dad5daac17a91a20986399d3a51f54bf68b), [`ce18d38`](https://github.com/mastra-ai/mastra/commit/ce18d38678c65870350d123955014a8432075fd9), [`cccf9c8`](https://github.com/mastra-ai/mastra/commit/cccf9c8b2d2dfc1a5e63919395b83d78c89682a0), [`61a5705`](https://github.com/mastra-ai/mastra/commit/61a570551278b6743e64243b3ce7d73de915ca8a), [`db70a48`](https://github.com/mastra-ai/mastra/commit/db70a48aeeeeb8e5f92007e8ede52c364ce15287), [`f0fdc14`](https://github.com/mastra-ai/mastra/commit/f0fdc14ee233d619266b3d2bbdeea7d25cfc6d13), [`db18bc9`](https://github.com/mastra-ai/mastra/commit/db18bc9c3825e2c1a0ad9a183cc9935f6691bfa1), [`9b37b56`](https://github.com/mastra-ai/mastra/commit/9b37b565e1f2a76c24f728945cc740c2b09be9da), [`41a23c3`](https://github.com/mastra-ai/mastra/commit/41a23c32f9877d71810f37e24930515df2ff7a0f), [`5d171ad`](https://github.com/mastra-ai/mastra/commit/5d171ad9ef340387276b77c2bb3e83e83332d729), [`f03ae60`](https://github.com/mastra-ai/mastra/commit/f03ae60500fe350c9d828621006cdafe1975fdd8), [`d1e74a0`](https://github.com/mastra-ai/mastra/commit/d1e74a0a293866dece31022047f5dbab65a304d0), [`39e7869`](https://github.com/mastra-ai/mastra/commit/39e7869bc7d0ee391077ce291474d8a84eedccff), [`5761926`](https://github.com/mastra-ai/mastra/commit/57619260c4a2cdd598763abbacd90de594c6bc76), [`c900fdd`](https://github.com/mastra-ai/mastra/commit/c900fdd504c41348efdffb205cfe80d48c38fa33), [`604a79f`](https://github.com/mastra-ai/mastra/commit/604a79fecf276e26a54a3fe01bb94e65315d2e0e), [`887f0b4`](https://github.com/mastra-ai/mastra/commit/887f0b4746cdbd7cb7d6b17ac9f82aeb58037ea5), [`2562143`](https://github.com/mastra-ai/mastra/commit/256214336b4faa78646c9c1776612393790d8784), [`ef11a61`](https://github.com/mastra-ai/mastra/commit/ef11a61920fa0ed08a5b7ceedd192875af119749)]:
+  - @mastra/core@1.0.0-beta.6
+
 ## Unreleased
 
 - Initial release.

package/dist/index.cjs

@@ -110,7 +110,7 @@ var MemoryConvex = class extends storage.MemoryStorage {
     const existing = await this.getThreadById({ threadId: id });
     if (!existing) {
       throw new error.MastraError({
-        id: "CONVEX_STORAGE_THREAD_NOT_FOUND",
+        id: storage.createStorageErrorId("CONVEX", "UPDATE_THREAD", "THREAD_NOT_FOUND"),
         domain: error.ErrorDomain.STORAGE,
         category: error.ErrorCategory.USER,
         text: `Thread ${id} not found`
@@ -169,23 +169,28 @@ var MemoryConvex = class extends storage.MemoryStorage {
   }
   async listMessages(args) {
     const { threadId, resourceId, include, filter, perPage: perPageInput, page = 0, orderBy } = args;
-    if (!threadId.trim()) {
+    const threadIds = Array.isArray(threadId) ? threadId : [threadId];
+    if (threadIds.length === 0 || threadIds.some((id) => !id.trim())) {
       throw new error.MastraError(
         {
-          id: "CONVEX_STORAGE_LIST_MESSAGES_INVALID_THREAD_ID",
+          id: storage.createStorageErrorId("CONVEX", "LIST_MESSAGES", "INVALID_THREAD_ID"),
           domain: error.ErrorDomain.STORAGE,
           category: error.ErrorCategory.USER,
-          details: { threadId }
+          details: { threadId: Array.isArray(threadId) ? threadId.join(",") : threadId }
         },
-        new Error("threadId must be a non-empty string")
+        new Error("threadId must be a non-empty string or array of non-empty strings")
       );
     }
     const perPage = storage.normalizePerPage(perPageInput, 40);
     const { offset, perPage: perPageForResponse } = storage.calculatePagination(page, perPageInput, perPage);
     const { field, direction } = this.parseOrderBy(orderBy, "ASC");
-    let rows = await this.operations.queryTable(storage.TABLE_MESSAGES, [
-      { field: "thread_id", value: threadId }
-    ]);
+    let rows = [];
+    for (const tid of threadIds) {
+      const threadRows = await this.operations.queryTable(storage.TABLE_MESSAGES, [
+        { field: "thread_id", value: tid }
+      ]);
+      rows.push(...threadRows);
+    }
     if (resourceId) {
       rows = rows.filter((row) => row.resourceId === resourceId);
     }
@@ -212,21 +217,41 @@ var MemoryConvex = class extends storage.MemoryStorage {
     const messageIds = new Set(messages.map((msg) => msg.id));
     if (include && include.length > 0) {
       const threadMessagesCache = /* @__PURE__ */ new Map();
-      threadMessagesCache.set(threadId, rows);
+      for (const tid of threadIds) {
+        const tidRows = rows.filter((r) => r.thread_id === tid);
+        threadMessagesCache.set(tid, tidRows);
+      }
       for (const includeItem of include) {
-        const targetThreadId = includeItem.threadId || threadId;
-        if (!threadMessagesCache.has(targetThreadId)) {
-          const otherThreadRows = await this.operations.queryTable(storage.TABLE_MESSAGES, [
-            { field: "thread_id", value: targetThreadId }
+        let targetThreadId;
+        let target;
+        for (const [tid, cachedRows] of threadMessagesCache) {
+          target = cachedRows.find((row) => row.id === includeItem.id);
+          if (target) {
+            targetThreadId = tid;
+            break;
+          }
+        }
+        if (!target) {
+          const messageRows = await this.operations.queryTable(storage.TABLE_MESSAGES, [
+            { field: "id", value: includeItem.id }
           ]);
-          threadMessagesCache.set(targetThreadId, otherThreadRows);
+          if (messageRows.length > 0) {
+            target = messageRows[0];
+            targetThreadId = target.thread_id;
+            if (targetThreadId && !threadMessagesCache.has(targetThreadId)) {
+              const otherThreadRows = await this.operations.queryTable(storage.TABLE_MESSAGES, [
+                { field: "thread_id", value: targetThreadId }
+              ]);
+              threadMessagesCache.set(targetThreadId, otherThreadRows);
+            }
+          }
         }
-        const targetThreadRows = threadMessagesCache.get(targetThreadId) || [];
-        const target = targetThreadRows.find((row) => row.id === includeItem.id);
-        if (target && !messageIds.has(target.id)) {
+        if (!target || !targetThreadId) continue;
+        if (!messageIds.has(target.id)) {
           messages.push(this.parseStoredMessage(target));
           messageIds.add(target.id);
         }
+        const targetThreadRows = threadMessagesCache.get(targetThreadId) || [];
         await this.addContextMessages({
           includeItem,
           allMessages: targetThreadRows,
@@ -531,7 +556,7 @@ var ScoresConvex = class extends storage.ScoresStorage {
     if (pagination.page < 0) {
       throw new error.MastraError(
         {
-          id: "CONVEX_STORAGE_INVALID_PAGINATION",
+          id: storage.createStorageErrorId("CONVEX", "LIST_SCORES", "INVALID_PAGINATION"),
           domain: error.ErrorDomain.STORAGE,
           category: error.ErrorCategory.USER
         },
@@ -810,7 +835,7 @@ var ConvexStore = class extends storage.MastraStorage {
   workflows;
   scores;
   constructor(config) {
-    super({ id: config.id, name: config.name ?? "ConvexStore" });
+    super({ id: config.id, name: config.name ?? "ConvexStore", disableInit: config.disableInit });
     const client = new ConvexAdminClient(config);
     this.operations = new StoreOperationsConvex(client);
     this.memory = new MemoryConvex(this.operations);