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

package/CHANGELOG.md

@@ -1,5 +1,14 @@
 # @mastra/libsql
 
+## 1.0.0-beta.2
+
+### 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.1
 
 ### Patch Changes

package/README.md

@@ -131,6 +131,9 @@ Example filter:
 - `createIndex({indexName, dimension, metric?, indexConfig?, defineIndex?})`: Create a new table with vector support
 - `upsert({indexName, vectors, metadata?, ids?})`: Add or update vectors
 - `query({indexName, queryVector, topK?, filter?, includeVector?, minScore?})`: 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
 - `defineIndex({indexName, metric?, indexConfig?})`: Define an index
 - `listIndexes()`: List all vector-enabled tables
 - `describeIndex(indexName)`: Get table statistics

package/dist/index.cjs

@@ -92,12 +92,20 @@ var createBasicOperator = (symbol) => {
   };
 };
 var createNumericOperator = (symbol) => {
-  return (key) => {
+  return (key, value) => {
     const jsonPath = getJsonPath(key);
-    return {
-      sql: `CAST(json_extract(metadata, ${jsonPath}) AS NUMERIC) ${symbol} ?`,
-      needsValue: true
-    };
+    const isNumeric = typeof value === "number" || typeof value === "string" && !isNaN(Number(value)) && value.trim() !== "";
+    if (isNumeric) {
+      return {
+        sql: `CAST(json_extract(metadata, ${jsonPath}) AS NUMERIC) ${symbol} ?`,
+        needsValue: true
+      };
+    } else {
+      return {
+        sql: `CAST(json_extract(metadata, ${jsonPath}) AS TEXT) ${symbol} ?`,
+        needsValue: true
+      };
+    }
   };
 };
 var validateJsonArray = (key) => {
@@ -826,8 +834,27 @@ var LibSQLVector = class extends vector.MastraVector {
   updateVector(args) {
     return this.executeWriteOperationWithRetry(() => this.doUpdateVector(args));
   }
-  async doUpdateVector({ indexName, id, update }) {
+  async doUpdateVector(params) {
+    const { indexName, update } = params;
     const parsedIndexName = utils.parseSqlIdentifier(indexName, "index name");
+    if ("id" in params && params.id && "filter" in params && params.filter) {
+      throw new error.MastraError({
+        id: "LIBSQL_VECTOR_UPDATE_MUTUALLY_EXCLUSIVE_PARAMS",
+        domain: error.ErrorDomain.STORAGE,
+        category: error.ErrorCategory.USER,
+        details: { indexName },
+        text: "id and filter are mutually exclusive - provide only one"
+      });
+    }
+    if (!update.vector && !update.metadata) {
+      throw new error.MastraError({
+        id: "LIBSQL_VECTOR_UPDATE_VECTOR_INVALID_ARGS",
+        domain: error.ErrorDomain.STORAGE,
+        category: error.ErrorCategory.USER,
+        details: { indexName },
+        text: "No updates provided"
+      });
+    }
     const updates = [];
     const args = [];
     if (update.vector) {
@@ -839,32 +866,81 @@ var LibSQLVector = class extends vector.MastraVector {
       args.push(JSON.stringify(update.metadata));
     }
     if (updates.length === 0) {
+      return;
+    }
+    let whereClause;
+    let whereValues;
+    if ("id" in params && params.id) {
+      whereClause = "vector_id = ?";
+      whereValues = [params.id];
+    } else if ("filter" in params && params.filter) {
+      const filter = params.filter;
+      if (!filter || Object.keys(filter).length === 0) {
+        throw new error.MastraError({
+          id: "LIBSQL_VECTOR_UPDATE_EMPTY_FILTER",
+          domain: error.ErrorDomain.STORAGE,
+          category: error.ErrorCategory.USER,
+          details: { indexName },
+          text: "Cannot update with empty filter"
+        });
+      }
+      const translatedFilter = this.transformFilter(filter);
+      const { sql: filterSql, values: filterValues } = buildFilterQuery(translatedFilter);
+      if (!filterSql || filterSql.trim() === "") {
+        throw new error.MastraError({
+          id: "LIBSQL_VECTOR_UPDATE_INVALID_FILTER",
+          domain: error.ErrorDomain.STORAGE,
+          category: error.ErrorCategory.USER,
+          details: { indexName },
+          text: "Filter produced empty WHERE clause"
+        });
+      }
+      const normalizedCondition = filterSql.replace(/^\s*WHERE\s+/i, "").trim().toLowerCase();
+      const matchAllPatterns = ["true", "1 = 1", "1=1"];
+      if (matchAllPatterns.includes(normalizedCondition)) {
+        throw new error.MastraError({
+          id: "LIBSQL_VECTOR_UPDATE_MATCH_ALL_FILTER",
+          domain: error.ErrorDomain.STORAGE,
+          category: error.ErrorCategory.USER,
+          details: { indexName, filterSql: normalizedCondition },
+          text: "Filter matches all vectors. Provide a specific filter to update targeted vectors."
+        });
+      }
+      whereClause = filterSql.replace(/^WHERE\s+/i, "");
+      whereValues = filterValues;
+    } else {
       throw new error.MastraError({
-        id: "LIBSQL_VECTOR_UPDATE_VECTOR_INVALID_ARGS",
+        id: "LIBSQL_VECTOR_UPDATE_MISSING_PARAMS",
         domain: error.ErrorDomain.STORAGE,
         category: error.ErrorCategory.USER,
-        details: { indexName, id },
-        text: "No updates provided"
+        details: { indexName },
+        text: "Either id or filter must be provided"
       });
     }
-    args.push(id);
     const query = `
-        UPDATE ${parsedIndexName}
-        SET ${updates.join(", ")}
-        WHERE vector_id = ?;
-      `;
+      UPDATE ${parsedIndexName}
+      SET ${updates.join(", ")}
+      WHERE ${whereClause};
+    `;
     try {
       await this.turso.execute({
         sql: query,
-        args
+        args: [...args, ...whereValues]
       });
     } catch (error$1) {
+      const errorDetails = { indexName };
+      if ("id" in params && params.id) {
+        errorDetails.id = params.id;
+      }
+      if ("filter" in params && params.filter) {
+        errorDetails.filter = JSON.stringify(params.filter);
+      }
       throw new error.MastraError(
         {
           id: "LIBSQL_VECTOR_UPDATE_VECTOR_FAILED",
           domain: error.ErrorDomain.STORAGE,
           category: error.ErrorCategory.THIRD_PARTY,
-          details: { indexName, id }
+          details: errorDetails
         },
         error$1
       );
@@ -886,7 +962,10 @@ var LibSQLVector = class extends vector.MastraVector {
           id: "LIBSQL_VECTOR_DELETE_VECTOR_FAILED",
           domain: error.ErrorDomain.STORAGE,
           category: error.ErrorCategory.THIRD_PARTY,
-          details: { indexName: args.indexName, id: args.id }
+          details: {
+            indexName: args.indexName,
+            ...args.id && { id: args.id }
+          }
         },
         error$1
       );
@@ -899,6 +978,100 @@ var LibSQLVector = class extends vector.MastraVector {
       args: [id]
     });
   }
+  deleteVectors(args) {
+    return this.executeWriteOperationWithRetry(() => this.doDeleteVectors(args));
+  }
+  async doDeleteVectors({ indexName, filter, ids }) {
+    const parsedIndexName = utils.parseSqlIdentifier(indexName, "index name");
+    if (!filter && !ids) {
+      throw new error.MastraError({
+        id: "LIBSQL_VECTOR_DELETE_MISSING_PARAMS",
+        domain: error.ErrorDomain.STORAGE,
+        category: error.ErrorCategory.USER,
+        details: { indexName },
+        text: "Either filter or ids must be provided"
+      });
+    }
+    if (filter && ids) {
+      throw new error.MastraError({
+        id: "LIBSQL_VECTOR_DELETE_CONFLICTING_PARAMS",
+        domain: error.ErrorDomain.STORAGE,
+        category: error.ErrorCategory.USER,
+        details: { indexName },
+        text: "Cannot provide both filter and ids - they are mutually exclusive"
+      });
+    }
+    let query;
+    let values;
+    if (ids) {
+      if (ids.length === 0) {
+        throw new error.MastraError({
+          id: "LIBSQL_VECTOR_DELETE_EMPTY_IDS",
+          domain: error.ErrorDomain.STORAGE,
+          category: error.ErrorCategory.USER,
+          details: { indexName },
+          text: "Cannot delete with empty ids array"
+        });
+      }
+      const placeholders = ids.map(() => "?").join(", ");
+      query = `DELETE FROM ${parsedIndexName} WHERE vector_id IN (${placeholders})`;
+      values = ids;
+    } else {
+      if (!filter || Object.keys(filter).length === 0) {
+        throw new error.MastraError({
+          id: "LIBSQL_VECTOR_DELETE_EMPTY_FILTER",
+          domain: error.ErrorDomain.STORAGE,
+          category: error.ErrorCategory.USER,
+          details: { indexName },
+          text: "Cannot delete with empty filter. Use deleteIndex to delete all vectors."
+        });
+      }
+      const translatedFilter = this.transformFilter(filter);
+      const { sql: filterSql, values: filterValues } = buildFilterQuery(translatedFilter);
+      if (!filterSql || filterSql.trim() === "") {
+        throw new error.MastraError({
+          id: "LIBSQL_VECTOR_DELETE_INVALID_FILTER",
+          domain: error.ErrorDomain.STORAGE,
+          category: error.ErrorCategory.USER,
+          details: { indexName },
+          text: "Filter produced empty WHERE clause"
+        });
+      }
+      const normalizedCondition = filterSql.replace(/^\s*WHERE\s+/i, "").trim().toLowerCase();
+      const matchAllPatterns = ["true", "1 = 1", "1=1"];
+      if (matchAllPatterns.includes(normalizedCondition)) {
+        throw new error.MastraError({
+          id: "LIBSQL_VECTOR_DELETE_MATCH_ALL_FILTER",
+          domain: error.ErrorDomain.STORAGE,
+          category: error.ErrorCategory.USER,
+          details: { indexName, filterSql: normalizedCondition },
+          text: "Filter matches all vectors. Use deleteIndex to delete all vectors from an index."
+        });
+      }
+      query = `DELETE FROM ${parsedIndexName} ${filterSql}`;
+      values = filterValues;
+    }
+    try {
+      await this.turso.execute({
+        sql: query,
+        args: values
+      });
+    } catch (error$1) {
+      throw new error.MastraError(
+        {
+          id: "LIBSQL_VECTOR_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
+      );
+    }
+  }
   truncateIndex(args) {
     try {
       return this.executeWriteOperationWithRetry(() => this._doTruncateIndex(args));