@mastra/mysql 0.4.0 → 0.5.0-alpha.0

package/CHANGELOG.md

@@ -1,5 +1,30 @@
 # @mastra/mysql
 
+## 0.5.0-alpha.0
+
+### Minor Changes
+
+- Added exact metadata filtering to message history queries across Memory APIs and supported storage providers. ([#19991](https://github.com/mastra-ai/mastra/pull/19991))
+
+  ```ts
+  const messages = await memory.recall({
+    threadId: 'thread-1',
+    filter: {
+      metadata: {
+        status: 'done',
+        priority: 'high',
+      },
+    },
+  });
+  ```
+
+  Multiple fields use AND semantics. Supported values are strings, finite numbers, booleans, and `null`.
+
+### Patch Changes
+
+- Updated dependencies [[`0dca9d0`](https://github.com/mastra-ai/mastra/commit/0dca9d0b1356024a53b72ea6f040db528b126caa)]:
+  - @mastra/core@1.54.0-alpha.0
+
 ## 0.4.0
 
 ### Minor Changes

package/dist/index.cjs

@@ -5216,6 +5216,22 @@ function parseJSON3(value) {
     return null;
   }
 }
+function addMySQLMessageMetadataFilter(conditions, params, metadataFilter) {
+  if (!metadataFilter) return;
+  for (const [key, value] of Object.entries(metadataFilter)) {
+    const path = `$.metadata.${key}`;
+    conditions.push(`JSON_VALID(${quoteIdentifier("content", "column name")})`);
+    conditions.push(`JSON_CONTAINS_PATH(${quoteIdentifier("content", "column name")}, 'one', ?)`);
+    params.push(path);
+    if (value === null) {
+      conditions.push(`JSON_TYPE(JSON_EXTRACT(${quoteIdentifier("content", "column name")}, ?)) = 'NULL'`);
+      params.push(path);
+    } else {
+      conditions.push(`JSON_EXTRACT(${quoteIdentifier("content", "column name")}, ?) = CAST(? AS JSON)`);
+      params.push(path, JSON.stringify(value));
+    }
+  }
+}
 var MemoryMySQL = class _MemoryMySQL extends storage.MemoryStorage {
   supportsObservationalMemory = true;
   pool;
@@ -6071,6 +6087,7 @@ var MemoryMySQL = class _MemoryMySQL extends storage.MemoryStorage {
     const { threadId, resourceId, filter, orderBy, page = 0, perPage: perPageInput } = args;
     const selectBy = args.selectBy;
     const include = args.include ?? selectBy?.include;
+    const metadataFilter = storage.validateStorageMetadataFilter(filter?.metadata);
     const threadIds = Array.isArray(threadId) ? threadId : [threadId];
     if (threadIds.length === 0 || threadIds.some((id) => !id.trim())) {
       throw emitValidationError("threadId must be a non-empty string or array of non-empty strings");
@@ -6117,6 +6134,7 @@ var MemoryMySQL = class _MemoryMySQL extends storage.MemoryStorage {
         conditions.push(`${quoteIdentifier("createdAt", "column name")} ${endOp} ?`);
         params.push(transformToSqlValue(filter.dateRange.end));
       }
+      addMySQLMessageMetadataFilter(conditions, params, metadataFilter);
       if (selectBy?.vectorSearchString) {
         conditions.push(`${quoteIdentifier("content", "column name")} LIKE ?`);
         params.push(`%${selectBy.vectorSearchString}%`);
@@ -6198,7 +6216,7 @@ var MemoryMySQL = class _MemoryMySQL extends storage.MemoryStorage {
       const mainThreadMessageCount = messages.filter(
         (msg) => msg.threadId !== void 0 && threadIdSet.has(msg.threadId)
       ).length;
-      const hasMore = include && include.length ? mainThreadMessageCount >= total ? false : baseHasMore : baseHasMore;
+      const hasMore = metadataFilter || !include?.length || mainThreadMessageCount < total ? baseHasMore : false;
       return {
         messages,
         total,
@@ -6227,6 +6245,7 @@ var MemoryMySQL = class _MemoryMySQL extends storage.MemoryStorage {
   }
   async listMessagesByResourceId(args) {
     const { resourceId, include, filter, perPage: perPageInput, page = 0, orderBy } = args;
+    const metadataFilter = storage.validateStorageMetadataFilter(filter?.metadata);
     if (!resourceId || typeof resourceId !== "string" || resourceId.trim().length === 0) {
       throw new error.MastraError(
         {
@@ -6267,6 +6286,7 @@ var MemoryMySQL = class _MemoryMySQL extends storage.MemoryStorage {
         conditions.push(`${quoteIdentifier("createdAt", "column name")} ${endOp} ?`);
         params.push(transformToSqlValue(filter.dateRange.end));
       }
+      addMySQLMessageMetadataFilter(conditions, params, metadataFilter);
       const whereSql = `WHERE ${conditions.join(" AND ")}`;
       const tableName = formatTableName(storage.TABLE_MESSAGES);
       const [countRows] = await this.pool.execute(