@mastra/upstash 1.0.0-beta.1 → 1.0.0-beta.2

package/dist/index.js

@@ -498,13 +498,11 @@ var StoreMemoryUpstash = class extends MemoryStorage {
         }
         return 0;
       };
-      if (orderBy) {
-        messagesData.sort((a, b) => {
-          const aValue = getFieldValue(a);
-          const bValue = getFieldValue(b);
-          return direction === "ASC" ? aValue - bValue : bValue - aValue;
-        });
-      }
+      messagesData.sort((a, b) => {
+        const aValue = getFieldValue(a);
+        const bValue = getFieldValue(b);
+        return direction === "ASC" ? aValue - bValue : bValue - aValue;
+      });
       const total = messagesData.length;
       const start = offset;
       const end = perPageInput === false ? total : start + perPage;
@@ -525,23 +523,11 @@ var StoreMemoryUpstash = class extends MemoryStorage {
       }
       const list = new MessageList().add(allMessages, "memory");
       let finalMessages = list.get.all.db();
-      if (orderBy) {
-        finalMessages = finalMessages.sort((a, b) => {
-          const aValue = getFieldValue(a);
-          const bValue = getFieldValue(b);
-          return direction === "ASC" ? aValue - bValue : bValue - aValue;
-        });
-      } else {
-        const messageIdToPosition = /* @__PURE__ */ new Map();
-        allMessageIds.forEach((id, index) => {
-          messageIdToPosition.set(id, index);
-        });
-        finalMessages = finalMessages.sort((a, b) => {
-          const aPos = messageIdToPosition.get(a.id) ?? Number.MAX_SAFE_INTEGER;
-          const bPos = messageIdToPosition.get(b.id) ?? Number.MAX_SAFE_INTEGER;
-          return aPos - bPos;
-        });
-      }
+      finalMessages = finalMessages.sort((a, b) => {
+        const aValue = getFieldValue(a);
+        const bValue = getFieldValue(b);
+        return direction === "ASC" ? aValue - bValue : bValue - aValue;
+      });
       const returnedThreadMessageIds = new Set(finalMessages.filter((m) => m.threadId === threadId).map((m) => m.id));
       const allThreadMessagesReturned = returnedThreadMessageIds.size >= total;
       const hasMore = perPageInput !== false && !allThreadMessagesReturned && end < total;
@@ -1009,7 +995,9 @@ var ScoresUpstash = class extends ScoresStorage {
           id: "STORAGE_UPSTASH_STORAGE_GET_SCORE_BY_ID_FAILED",
           domain: ErrorDomain.STORAGE,
           category: ErrorCategory.THIRD_PARTY,
-          details: { id }
+          details: {
+            ...id && { id }
+          }
         },
         error
       );
@@ -1999,6 +1987,11 @@ var UpstashVector = class extends MastraVector {
     try {
       await this.client.deleteNamespace(namespace);
     } catch (error) {
+      const errorMessage = error?.message || "";
+      if (errorMessage.includes("does not exist") || errorMessage.includes("not found")) {
+        this.logger.info(`Namespace ${namespace} does not exist, treating as already deleted`);
+        return;
+      }
       throw new MastraError(
         {
           id: "STORAGE_UPSTASH_VECTOR_DELETE_INDEX_FAILED",
@@ -2011,47 +2004,124 @@ var UpstashVector = class extends MastraVector {
     }
   }
   /**
-   * Updates a vector by its ID with the provided vector and/or metadata.
-   * @param indexName - The name of the namespace containing the vector.
-   * @param id - The ID of the vector to update.
-   * @param update - An object containing the vector and/or metadata to update.
-   * @param update.vector - An optional array of numbers representing the new vector.
-   * @param update.metadata - An optional record containing the new metadata.
+   * Updates a vector by its ID or multiple vectors matching a filter.
+   * @param params - Parameters containing the id or filter for targeting the vector(s) to update
+   * @param params.indexName - The name of the namespace containing the vector.
+   * @param params.id - The ID of the vector to update (mutually exclusive with filter).
+   * @param params.filter - Filter to match multiple vectors to update (mutually exclusive with id).
+   * @param params.update - An object containing the vector and/or metadata to update.
    * @returns A promise that resolves when the update is complete.
    * @throws Will throw an error if no updates are provided or if the update operation fails.
    */
-  async updateVector({ indexName: namespace, id, update }) {
-    if (!update.vector && !update.metadata && !update.sparseVector) {
+  async updateVector(params) {
+    const { indexName: namespace, update } = params;
+    const upstashUpdate = update;
+    const sparseVector = upstashUpdate.sparseVector;
+    if ("id" in params && params.id && "filter" in params && params.filter) {
       throw new MastraError({
-        id: "STORAGE_UPSTASH_VECTOR_UPDATE_VECTOR_FAILED",
+        id: "STORAGE_UPSTASH_VECTOR_UPDATE_MUTUALLY_EXCLUSIVE",
+        text: "Cannot specify both id and filter - they are mutually exclusive",
         domain: ErrorDomain.STORAGE,
-        category: ErrorCategory.THIRD_PARTY,
-        details: { namespace, id },
-        text: "No update data provided"
+        category: ErrorCategory.USER,
+        details: { namespace }
       });
     }
-    if (!update.vector && !update.sparseVector && update.metadata) {
+    if (!("id" in params && params.id) && !("filter" in params && params.filter)) {
       throw new MastraError({
-        id: "STORAGE_UPSTASH_VECTOR_UPDATE_VECTOR_FAILED",
+        id: "STORAGE_UPSTASH_VECTOR_UPDATE_NO_TARGET",
+        text: "Either id or filter must be provided",
         domain: ErrorDomain.STORAGE,
-        category: ErrorCategory.THIRD_PARTY,
-        details: { namespace, id },
-        text: "Both vector and metadata must be provided for an update"
+        category: ErrorCategory.USER,
+        details: { namespace }
+      });
+    }
+    if (!update.vector && !update.metadata && !sparseVector) {
+      throw new MastraError({
+        id: "STORAGE_UPSTASH_VECTOR_UPDATE_NO_PAYLOAD",
+        text: "No update data provided",
+        domain: ErrorDomain.STORAGE,
+        category: ErrorCategory.USER,
+        details: { namespace }
+      });
+    }
+    if ("filter" in params && params.filter && Object.keys(params.filter).length === 0) {
+      throw new MastraError({
+        id: "STORAGE_UPSTASH_VECTOR_UPDATE_EMPTY_FILTER",
+        text: "Filter cannot be an empty filter object",
+        domain: ErrorDomain.STORAGE,
+        category: ErrorCategory.USER,
+        details: { namespace }
       });
     }
     try {
-      const points = { id };
-      if (update.vector) points.vector = update.vector;
-      if (update.metadata) points.metadata = update.metadata;
-      if (update.sparseVector) points.sparseVector = update.sparseVector;
-      await this.client.upsert(points, { namespace });
+      const ns = this.client.namespace(namespace);
+      if ("id" in params && params.id) {
+        const points = { id: params.id };
+        if (!update.vector || !update.metadata) {
+          try {
+            const existing = await ns.fetch([params.id], {
+              includeVectors: true,
+              includeMetadata: true
+            });
+            if (existing && existing.length > 0 && existing[0]) {
+              if (!update.vector && existing[0]?.vector) {
+                points.vector = existing[0].vector;
+              }
+              if (!update.metadata && existing[0]?.metadata) {
+                points.metadata = existing[0].metadata;
+              }
+            }
+          } catch (fetchError) {
+            this.logger.warn(`Failed to fetch existing vector ${params.id} for partial update: ${fetchError}`);
+          }
+        }
+        if (update.vector) points.vector = update.vector;
+        if (update.metadata) points.metadata = update.metadata;
+        if (sparseVector) points.sparseVector = sparseVector;
+        await ns.upsert(points);
+      } else if ("filter" in params && params.filter) {
+        const filterString = this.transformFilter(params.filter);
+        if (filterString) {
+          const stats = await this.describeIndex({ indexName: namespace });
+          const dummyVector = new Array(stats.dimension).fill(1 / Math.sqrt(stats.dimension));
+          const needsVectors = !update.vector;
+          const results = await ns.query({
+            vector: dummyVector,
+            topK: 1e3,
+            // Upstash's max query limit
+            filter: filterString,
+            includeVectors: needsVectors,
+            includeMetadata: needsVectors
+          });
+          for (const result of results) {
+            const points = { id: `${result.id}` };
+            if (update.vector) {
+              points.vector = update.vector;
+            } else if (result.vector) {
+              points.vector = result.vector;
+            }
+            if (update.metadata) {
+              points.metadata = update.metadata;
+            } else if (result.metadata) {
+              points.metadata = result.metadata;
+            }
+            if (sparseVector) points.sparseVector = sparseVector;
+            await ns.upsert(points);
+          }
+        }
+      }
     } catch (error) {
+      if (error instanceof MastraError) throw error;
       throw new MastraError(
         {
           id: "STORAGE_UPSTASH_VECTOR_UPDATE_VECTOR_FAILED",
           domain: ErrorDomain.STORAGE,
           category: ErrorCategory.THIRD_PARTY,
-          details: { namespace, id }
+          details: {
+            namespace,
+            ..."id" in params && params.id && { id: params.id },
+            ..."filter" in params && params.filter && { filter: JSON.stringify(params.filter) }
+          }
         },
         error
       );
@@ -2066,22 +2136,109 @@ var UpstashVector = class extends MastraVector {
    */
   async deleteVector({ indexName: namespace, id }) {
     try {
-      await this.client.delete(id, {
-        namespace
-      });
+      const ns = this.client.namespace(namespace);
+      await ns.delete(id);
     } catch (error) {
       const mastraError = new MastraError(
         {
           id: "STORAGE_UPSTASH_VECTOR_DELETE_VECTOR_FAILED",
           domain: ErrorDomain.STORAGE,
           category: ErrorCategory.THIRD_PARTY,
-          details: { namespace, id }
+          details: {
+            namespace,
+            ...id && { id }
+          }
         },
         error
       );
       this.logger?.error(mastraError.toString());
     }
   }
+  /**
+   * Deletes multiple vectors by IDs or filter.
+   * @param indexName - The name of the namespace containing the vectors.
+   * @param ids - Array of vector IDs to delete (mutually exclusive with filter).
+   * @param filter - Filter to match vectors to delete (mutually exclusive with ids).
+   * @returns A promise that resolves when the deletion is complete.
+   * @throws Will throw an error if both ids and filter are provided, or if neither is provided.
+   */
+  async deleteVectors({ indexName: namespace, filter, ids }) {
+    if (ids && filter) {
+      throw new MastraError({
+        id: "STORAGE_UPSTASH_VECTOR_DELETE_VECTORS_MUTUALLY_EXCLUSIVE",
+        text: "Cannot specify both ids and filter - they are mutually exclusive",
+        domain: ErrorDomain.STORAGE,
+        category: ErrorCategory.USER,
+        details: { namespace }
+      });
+    }
+    if (!ids && !filter) {
+      throw new MastraError({
+        id: "STORAGE_UPSTASH_VECTOR_DELETE_VECTORS_NO_TARGET",
+        text: "Either filter or ids must be provided",
+        domain: ErrorDomain.STORAGE,
+        category: ErrorCategory.USER,
+        details: { namespace }
+      });
+    }
+    if (ids && ids.length === 0) {
+      throw new MastraError({
+        id: "STORAGE_UPSTASH_VECTOR_DELETE_VECTORS_EMPTY_IDS",
+        text: "Cannot delete with empty ids array",
+        domain: ErrorDomain.STORAGE,
+        category: ErrorCategory.USER,
+        details: { namespace }
+      });
+    }
+    if (filter && Object.keys(filter).length === 0) {
+      throw new MastraError({
+        id: "STORAGE_UPSTASH_VECTOR_DELETE_VECTORS_EMPTY_FILTER",
+        text: "Cannot delete with empty filter object",
+        domain: ErrorDomain.STORAGE,
+        category: ErrorCategory.USER,
+        details: { namespace }
+      });
+    }
+    try {
+      const ns = this.client.namespace(namespace);
+      if (ids) {
+        await ns.delete(ids);
+      } else if (filter) {
+        const filterString = this.transformFilter(filter);
+        if (filterString) {
+          const stats = await this.describeIndex({ indexName: namespace });
+          const dummyVector = new Array(stats.dimension).fill(1 / Math.sqrt(stats.dimension));
+          const results = await ns.query({
+            vector: dummyVector,
+            topK: 1e3,
+            // Upstash's max query limit
+            filter: filterString,
+            includeVectors: false,
+            includeMetadata: false
+          });
+          const idsToDelete = results.map((r) => `${r.id}`);
+          if (idsToDelete.length > 0) {
+            await ns.delete(idsToDelete);
+          }
+        }
+      }
+    } catch (error) {
+      if (error instanceof MastraError) throw error;
+      throw new MastraError(
+        {
+          id: "STORAGE_UPSTASH_VECTOR_DELETE_VECTORS_FAILED",
+          domain: ErrorDomain.STORAGE,
+          category: ErrorCategory.THIRD_PARTY,
+          details: {
+            namespace,
+            ...filter && { filter: JSON.stringify(filter) },
+            ...ids && { idsCount: ids.length }
+          }
+        },
+        error
+      );
+    }
+  }
 };
 
 // src/vector/prompt.ts