@mastra/qdrant 1.0.0-beta.0 → 1.0.0-beta.2

package/CHANGELOG.md

@@ -1,5 +1,23 @@
 # @mastra/qdrant
 
+## 1.0.0-beta.2
+
+### 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
+
+## 1.0.0-beta.1
+
+### Patch Changes
+
+- Add new deleteVectors, updateVector by filter ([#10408](https://github.com/mastra-ai/mastra/pull/10408))
+
+- Updated dependencies [[`21a15de`](https://github.com/mastra-ai/mastra/commit/21a15de369fe82aac26bb642ed7be73505475e8b), [`feb7ee4`](https://github.com/mastra-ai/mastra/commit/feb7ee4d09a75edb46c6669a3beaceec78811747), [`b0e2ea5`](https://github.com/mastra-ai/mastra/commit/b0e2ea5b52c40fae438b9e2f7baee6f0f89c5442), [`c456e01`](https://github.com/mastra-ai/mastra/commit/c456e0149e3c176afcefdbd9bb1d2c5917723725), [`ab035c2`](https://github.com/mastra-ai/mastra/commit/ab035c2ef6d8cc7bb25f06f1a38508bd9e6f126b), [`1a46a56`](https://github.com/mastra-ai/mastra/commit/1a46a566f45a3fcbadc1cf36bf86d351f264bfa3), [`3cf540b`](https://github.com/mastra-ai/mastra/commit/3cf540b9fbfea8f4fc8d3a2319a4e6c0b0cbfd52), [`1c6ce51`](https://github.com/mastra-ai/mastra/commit/1c6ce51f875915ab57fd36873623013699a2a65d), [`898a972`](https://github.com/mastra-ai/mastra/commit/898a9727d286c2510d6b702dfd367e6aaf5c6b0f), [`a97003a`](https://github.com/mastra-ai/mastra/commit/a97003aa1cf2f4022a41912324a1e77263b326b8), [`ccc141e`](https://github.com/mastra-ai/mastra/commit/ccc141ed27da0abc3a3fc28e9e5128152e8e37f4), [`fe3b897`](https://github.com/mastra-ai/mastra/commit/fe3b897c2ccbcd2b10e81b099438c7337feddf89), [`00123ba`](https://github.com/mastra-ai/mastra/commit/00123ba96dc9e5cd0b110420ebdba56d8f237b25), [`29c4309`](https://github.com/mastra-ai/mastra/commit/29c4309f818b24304c041bcb4a8f19b5f13f6b62), [`16785ce`](https://github.com/mastra-ai/mastra/commit/16785ced928f6f22638f4488cf8a125d99211799), [`de8239b`](https://github.com/mastra-ai/mastra/commit/de8239bdcb1d8c0cfa06da21f1569912a66bbc8a), [`b5e6cd7`](https://github.com/mastra-ai/mastra/commit/b5e6cd77fc8c8e64e0494c1d06cee3d84e795d1e), [`3759cb0`](https://github.com/mastra-ai/mastra/commit/3759cb064935b5f74c65ac2f52a1145f7352899d), [`651e772`](https://github.com/mastra-ai/mastra/commit/651e772eb1475fb13e126d3fcc01751297a88214), [`b61b93f`](https://github.com/mastra-ai/mastra/commit/b61b93f9e058b11dd2eec169853175d31dbdd567), [`bae33d9`](https://github.com/mastra-ai/mastra/commit/bae33d91a63fbb64d1e80519e1fc1acaed1e9013), [`c0b731f`](https://github.com/mastra-ai/mastra/commit/c0b731fb27d712dc8582e846df5c0332a6a0c5ba), [`43ca8f2`](https://github.com/mastra-ai/mastra/commit/43ca8f2c7334851cc7b4d3d2f037d8784bfbdd5f), [`2ca67cc`](https://github.com/mastra-ai/mastra/commit/2ca67cc3bb1f6a617353fdcab197d9efebe60d6f), [`9e67002`](https://github.com/mastra-ai/mastra/commit/9e67002b52c9be19936c420a489dbee9c5fd6a78), [`35edc49`](https://github.com/mastra-ai/mastra/commit/35edc49ac0556db609189641d6341e76771b81fc)]:
+  - @mastra/core@1.0.0-beta.5
+
 ## 1.0.0-beta.0
 
 ### Major Changes

package/README.md

@@ -72,6 +72,9 @@ The following distance metrics are supported:
 - `createIndex({ indexName, dimension, metric? })`: Create a new collection
 - `upsert({ indexName, vectors, metadata?, ids? })`: Add or update vectors
 - `query({ indexName, queryVector, topK?, filter?, includeVector? })`: Search for similar vectors
+- `updateVector({ indexName, id?, filter?, update })`: Update a single vector by ID or metadata filter
+- `deleteVector({ indexName, id })`: Delete a single vector by ID
+- `deleteVectors({ indexName, ids?, filter? })`: Delete multiple vectors by IDs or metadata filter
 - `listIndexes()`: List all collections
 - `describeIndex(indexName)`: Get collection statistics
 - `deleteIndex(indexName)`: Delete a collection

package/dist/index.cjs

@@ -1,6 +1,7 @@
 'use strict';
 
 var error = require('@mastra/core/error');
+var storage = require('@mastra/core/storage');
 var vector = require('@mastra/core/vector');
 var jsClientRest = require('@qdrant/js-client-rest');
 var filter = require('@mastra/core/vector/filter');
@@ -271,7 +272,7 @@ var QdrantVector = class extends vector.MastraVector {
     } catch (error$1) {
       throw new error.MastraError(
         {
-          id: "STORAGE_QDRANT_VECTOR_UPSERT_FAILED",
+          id: storage.createVectorErrorId("QDRANT", "UPSERT", "FAILED"),
           domain: error.ErrorDomain.STORAGE,
           category: error.ErrorCategory.THIRD_PARTY,
           details: { indexName, vectorCount: vectors.length }
@@ -291,7 +292,7 @@ var QdrantVector = class extends vector.MastraVector {
     } catch (validationError) {
       throw new error.MastraError(
         {
-          id: "STORAGE_QDRANT_VECTOR_CREATE_INDEX_INVALID_ARGS",
+          id: storage.createVectorErrorId("QDRANT", "CREATE_INDEX", "INVALID_ARGS"),
           domain: error.ErrorDomain.STORAGE,
           category: error.ErrorCategory.USER,
           details: { indexName, dimension, metric }
@@ -314,7 +315,7 @@ var QdrantVector = class extends vector.MastraVector {
       }
       throw new error.MastraError(
         {
-          id: "STORAGE_QDRANT_VECTOR_CREATE_INDEX_FAILED",
+          id: storage.createVectorErrorId("QDRANT", "CREATE_INDEX", "FAILED"),
           domain: error.ErrorDomain.STORAGE,
           category: error.ErrorCategory.THIRD_PARTY,
           details: { indexName, dimension, metric }
@@ -362,7 +363,7 @@ var QdrantVector = class extends vector.MastraVector {
     } catch (error$1) {
       throw new error.MastraError(
         {
-          id: "STORAGE_QDRANT_VECTOR_QUERY_FAILED",
+          id: storage.createVectorErrorId("QDRANT", "QUERY", "FAILED"),
           domain: error.ErrorDomain.STORAGE,
           category: error.ErrorCategory.THIRD_PARTY,
           details: { indexName, topK }
@@ -378,7 +379,7 @@ var QdrantVector = class extends vector.MastraVector {
     } catch (error$1) {
       throw new error.MastraError(
         {
-          id: "STORAGE_QDRANT_VECTOR_LIST_INDEXES_FAILED",
+          id: storage.createVectorErrorId("QDRANT", "LIST_INDEXES", "FAILED"),
           domain: error.ErrorDomain.STORAGE,
           category: error.ErrorCategory.THIRD_PARTY
         },
@@ -405,7 +406,7 @@ var QdrantVector = class extends vector.MastraVector {
     } catch (error$1) {
       throw new error.MastraError(
         {
-          id: "STORAGE_QDRANT_VECTOR_DESCRIBE_INDEX_FAILED",
+          id: storage.createVectorErrorId("QDRANT", "DESCRIBE_INDEX", "FAILED"),
           domain: error.ErrorDomain.STORAGE,
           category: error.ErrorCategory.THIRD_PARTY,
           details: { indexName }
@@ -418,9 +419,14 @@ var QdrantVector = class extends vector.MastraVector {
     try {
       await this.client.deleteCollection(indexName);
     } catch (error$1) {
+      const errorMessage = error$1?.message || error$1?.toString() || "";
+      if (error$1?.status === 404 || errorMessage.toLowerCase().includes("not found") || errorMessage.toLowerCase().includes("not exist")) {
+        this.logger.info(`Collection ${indexName} does not exist, treating as already deleted`);
+        return;
+      }
       throw new error.MastraError(
         {
-          id: "STORAGE_QDRANT_VECTOR_DELETE_INDEX_FAILED",
+          id: storage.createVectorErrorId("QDRANT", "DELETE_INDEX", "FAILED"),
           domain: error.ErrorDomain.STORAGE,
           category: error.ErrorCategory.THIRD_PARTY,
           details: { indexName }
@@ -430,66 +436,143 @@ var QdrantVector = class extends vector.MastraVector {
     }
   }
   /**
-   * Updates a vector by its ID with the provided vector and/or metadata.
-   * @param indexName - The name of the index containing the vector.
-   * @param id - The ID of the vector to update.
+   * Updates a vector by its ID or multiple vectors matching a filter.
+   * @param indexName - The name of the index containing the vector(s).
+   * @param id - The ID of the vector to update (mutually exclusive with filter).
+   * @param filter - Filter to match multiple vectors to update (mutually exclusive with id).
    * @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.
    * @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, id, update }) {
-    try {
-      if (!update.vector && !update.metadata) {
-        throw new Error("No updates provided");
-      }
-    } catch (validationError) {
-      throw new error.MastraError(
-        {
-          id: "STORAGE_QDRANT_VECTOR_UPDATE_VECTOR_INVALID_ARGS",
-          domain: error.ErrorDomain.STORAGE,
-          category: error.ErrorCategory.USER,
-          details: { indexName, id }
-        },
-        validationError
-      );
+  async updateVector({ indexName, id, filter, update }) {
+    if (id && filter) {
+      throw new error.MastraError({
+        id: storage.createVectorErrorId("QDRANT", "UPDATE_VECTOR", "MUTUALLY_EXCLUSIVE"),
+        text: "Cannot specify both id and filter - they are mutually exclusive",
+        domain: error.ErrorDomain.STORAGE,
+        category: error.ErrorCategory.USER,
+        details: { indexName }
+      });
+    }
+    if (!id && !filter) {
+      throw new error.MastraError({
+        id: storage.createVectorErrorId("QDRANT", "UPDATE_VECTOR", "NO_TARGET"),
+        text: "Either id or filter must be provided",
+        domain: error.ErrorDomain.STORAGE,
+        category: error.ErrorCategory.USER,
+        details: { indexName }
+      });
+    }
+    if (!update.vector && !update.metadata) {
+      throw new error.MastraError({
+        id: storage.createVectorErrorId("QDRANT", "UPDATE_VECTOR", "NO_PAYLOAD"),
+        text: "No updates provided",
+        domain: error.ErrorDomain.STORAGE,
+        category: error.ErrorCategory.USER,
+        details: {
+          indexName,
+          ...id && { id }
+        }
+      });
+    }
+    if (filter && Object.keys(filter).length === 0) {
+      throw new error.MastraError({
+        id: storage.createVectorErrorId("QDRANT", "UPDATE_VECTOR", "EMPTY_FILTER"),
+        text: "Filter cannot be an empty filter object",
+        domain: error.ErrorDomain.STORAGE,
+        category: error.ErrorCategory.USER,
+        details: { indexName }
+      });
     }
-    const pointId = this.parsePointId(id);
     try {
-      if (update.metadata && !update.vector) {
-        await this.client.setPayload(indexName, { payload: update.metadata, points: [pointId] });
-        return;
-      }
-      if (update.vector && !update.metadata) {
-        await this.client.updateVectors(indexName, {
-          points: [
-            {
-              id: pointId,
-              vector: update.vector
-            }
-          ]
-        });
-        return;
-      }
-      if (update.vector && update.metadata) {
-        const point = {
-          id: pointId,
-          vector: update.vector,
-          payload: update.metadata
-        };
-        await this.client.upsert(indexName, {
-          points: [point]
-        });
-        return;
+      if (id) {
+        const pointId = this.parsePointId(id);
+        if (update.metadata && !update.vector) {
+          await this.client.setPayload(indexName, { payload: update.metadata, points: [pointId] });
+          return;
+        }
+        if (update.vector && !update.metadata) {
+          await this.client.updateVectors(indexName, {
+            points: [
+              {
+                id: pointId,
+                vector: update.vector
+              }
+            ]
+          });
+          return;
+        }
+        if (update.vector && update.metadata) {
+          const point = {
+            id: pointId,
+            vector: update.vector,
+            payload: update.metadata
+          };
+          await this.client.upsert(indexName, {
+            points: [point]
+          });
+          return;
+        }
+      } else if (filter) {
+        const translatedFilter = this.transformFilter(filter);
+        const matchingPoints = [];
+        let offset = void 0;
+        do {
+          const scrollResult = await this.client.scroll(indexName, {
+            filter: translatedFilter,
+            limit: 100,
+            offset,
+            with_payload: false,
+            with_vector: update.vector ? false : true
+            // Only fetch vectors if not updating them
+          });
+          matchingPoints.push(
+            ...scrollResult.points.map((point) => ({
+              id: point.id,
+              vector: Array.isArray(point.vector) ? point.vector : void 0
+            }))
+          );
+          const nextOffset = scrollResult.next_page_offset;
+          offset = typeof nextOffset === "string" || typeof nextOffset === "number" ? nextOffset : void 0;
+        } while (offset !== void 0);
+        if (matchingPoints.length === 0) {
+          return;
+        }
+        const pointIds = matchingPoints.map((p) => p.id);
+        if (update.metadata && !update.vector) {
+          await this.client.setPayload(indexName, { payload: update.metadata, points: pointIds });
+          return;
+        }
+        if (update.vector) {
+          const points = matchingPoints.map((p) => ({
+            id: p.id,
+            vector: update.vector,
+            payload: update.metadata || {}
+          }));
+          for (let i = 0; i < points.length; i += BATCH_SIZE) {
+            const batch = points.slice(i, i + BATCH_SIZE);
+            await this.client.upsert(indexName, {
+              points: batch,
+              wait: true
+            });
+          }
+          return;
+        }
       }
     } catch (error$1) {
+      if (error$1 instanceof error.MastraError) throw error$1;
       throw new error.MastraError(
         {
-          id: "STORAGE_QDRANT_VECTOR_UPDATE_VECTOR_FAILED",
+          id: storage.createVectorErrorId("QDRANT", "UPDATE_VECTOR", "FAILED"),
           domain: error.ErrorDomain.STORAGE,
           category: error.ErrorCategory.THIRD_PARTY,
-          details: { indexName, id }
+          details: {
+            indexName,
+            ...id && { id },
+            ...filter && { filter: JSON.stringify(filter) }
+          }
         },
         error$1
       );
@@ -511,10 +594,13 @@ var QdrantVector = class extends vector.MastraVector {
     } catch (error$1) {
       throw new error.MastraError(
         {
-          id: "STORAGE_QDRANT_VECTOR_DELETE_VECTOR_FAILED",
+          id: storage.createVectorErrorId("QDRANT", "DELETE_VECTOR", "FAILED"),
           domain: error.ErrorDomain.STORAGE,
           category: error.ErrorCategory.THIRD_PARTY,
-          details: { indexName, id }
+          details: {
+            indexName,
+            ...id && { id }
+          }
         },
         error$1
       );
@@ -555,6 +641,90 @@ var QdrantVector = class extends vector.MastraVector {
     }
     return id;
   }
+  /**
+   * Deletes multiple vectors by IDs or filter.
+   * @param indexName - The name of the index 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, filter, ids }) {
+    if (ids && filter) {
+      throw new error.MastraError({
+        id: storage.createVectorErrorId("QDRANT", "DELETE_VECTORS", "MUTUALLY_EXCLUSIVE"),
+        text: "Cannot specify both ids and filter - they are mutually exclusive",
+        domain: error.ErrorDomain.STORAGE,
+        category: error.ErrorCategory.USER,
+        details: { indexName }
+      });
+    }
+    if (!ids && !filter) {
+      throw new error.MastraError({
+        id: storage.createVectorErrorId("QDRANT", "DELETE_VECTORS", "NO_TARGET"),
+        text: "Either filter or ids must be provided",
+        domain: error.ErrorDomain.STORAGE,
+        category: error.ErrorCategory.USER,
+        details: { indexName }
+      });
+    }
+    if (ids && ids.length === 0) {
+      throw new error.MastraError({
+        id: storage.createVectorErrorId("QDRANT", "DELETE_VECTORS", "EMPTY_IDS"),
+        text: "Cannot delete with empty ids array",
+        domain: error.ErrorDomain.STORAGE,
+        category: error.ErrorCategory.USER,
+        details: { indexName }
+      });
+    }
+    if (filter && Object.keys(filter).length === 0) {
+      throw new error.MastraError({
+        id: storage.createVectorErrorId("QDRANT", "DELETE_VECTORS", "EMPTY_FILTER"),
+        text: "Cannot delete with empty filter object",
+        domain: error.ErrorDomain.STORAGE,
+        category: error.ErrorCategory.USER,
+        details: { indexName }
+      });
+    }
+    try {
+      if (ids) {
+        const pointIds = ids.map((id) => this.parsePointId(id));
+        try {
+          await this.client.delete(indexName, {
+            points: pointIds,
+            wait: true
+          });
+        } catch (error) {
+          const message = error?.message || error?.toString() || "";
+          if (message.toLowerCase().includes("bad request")) {
+            return;
+          }
+          throw error;
+        }
+      } else if (filter) {
+        const translatedFilter = this.transformFilter(filter) ?? {};
+        await this.client.delete(indexName, {
+          filter: translatedFilter,
+          wait: true
+        });
+      }
+    } catch (error$1) {
+      if (error$1 instanceof error.MastraError) throw error$1;
+      throw new error.MastraError(
+        {
+          id: storage.createVectorErrorId("QDRANT", "DELETE_VECTORS", "FAILED"),
+          domain: error.ErrorDomain.STORAGE,
+          category: error.ErrorCategory.THIRD_PARTY,
+          details: {
+            indexName,
+            ...filter && { filter: JSON.stringify(filter) },
+            ...ids && { idsCount: ids.length }
+          }
+        },
+        error$1
+      );
+    }
+  }
 };
 
 // src/vector/prompt.ts