@mastra/libsql 0.0.4-alpha.2 → 0.0.4-alpha.3

package/.turbo/turbo-build.log

@@ -1,23 +1,23 @@
 
-> @mastra/libsql@0.0.4-alpha.2 build /home/runner/work/mastra/mastra/stores/libsql
+> @mastra/libsql@0.0.4-alpha.3 build /home/runner/work/mastra/mastra/stores/libsql
 > tsup src/index.ts --format esm,cjs --experimental-dts --clean --treeshake=smallest --splitting
 
 CLI Building entry: src/index.ts
 CLI Using tsconfig: tsconfig.json
 CLI tsup v8.4.0
 TSC Build start
-TSC ⚡️ Build success in 9275ms
+TSC ⚡️ Build success in 8335ms
 DTS Build start
 CLI Target: es2022
 Analysis will use the bundled TypeScript version 5.8.3
 Writing package typings: /home/runner/work/mastra/mastra/stores/libsql/dist/_tsup-dts-rollup.d.ts
 Analysis will use the bundled TypeScript version 5.8.3
 Writing package typings: /home/runner/work/mastra/mastra/stores/libsql/dist/_tsup-dts-rollup.d.cts
-DTS ⚡️ Build success in 10384ms
+DTS ⚡️ Build success in 8910ms
 CLI Cleaning output folder
 ESM Build start
 CJS Build start
-ESM dist/index.js 41.56 KB
-ESM ⚡️ Build success in 642ms
-CJS dist/index.cjs 41.69 KB
-CJS ⚡️ Build success in 643ms
+ESM dist/index.js 43.50 KB
+ESM ⚡️ Build success in 743ms
+CJS dist/index.cjs 43.63 KB
+CJS ⚡️ Build success in 744ms

package/CHANGELOG.md

@@ -1,5 +1,16 @@
 # @mastra/libsql
 
+## 0.0.4-alpha.3
+
+### Patch Changes
+
+- c3bd795: [MASTRA-3358] Deprecate updateIndexById and deleteIndexById
+- Updated dependencies [396be50]
+- Updated dependencies [c3bd795]
+- Updated dependencies [da082f8]
+- Updated dependencies [a5810ce]
+  - @mastra/core@0.9.4-alpha.3
+
 ## 0.0.4-alpha.2
 
 ### Patch Changes

package/dist/_tsup-dts-rollup.d.cts

@@ -174,10 +174,11 @@ declare class LibSQLVector extends MastraVector {
     listIndexes(): Promise<string[]>;
     describeIndex(indexName: string): Promise<IndexStats>;
     /**
-     * Updates an index entry by its ID with the provided vector and/or metadata.
+     * @deprecated Use {@link updateVector} instead. This method will be removed on May 20th, 2025.
      *
-     * @param indexName - The name of the index to update.
-     * @param id - The ID of the index entry to update.
+     * 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.
      * @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.
@@ -188,7 +189,38 @@ declare class LibSQLVector extends MastraVector {
         vector?: number[];
         metadata?: Record<string, any>;
     }): Promise<void>;
+    /**
+     * 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.
+     * @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.
+     */
+    updateVector(indexName: string, id: string, update: {
+        vector?: number[];
+        metadata?: Record<string, any>;
+    }): Promise<void>;
+    /**
+     * @deprecated Use {@link deleteVector} instead. This method will be removed on May 20th, 2025.
+     *
+     * Deletes a vector by its ID.
+     * @param indexName - The name of the index containing the vector.
+     * @param id - The ID of the vector to delete.
+     * @returns A promise that resolves when the deletion is complete.
+     * @throws Will throw an error if the deletion operation fails.
+     */
     deleteIndexById(indexName: string, id: string): Promise<void>;
+    /**
+     * Deletes a vector by its ID.
+     * @param indexName - The name of the index containing the vector.
+     * @param id - The ID of the vector to delete.
+     * @returns A promise that resolves when the deletion is complete.
+     * @throws Will throw an error if the deletion operation fails.
+     */
+    deleteVector(indexName: string, id: string): Promise<void>;
     truncateIndex(indexName: string): Promise<void>;
 }
 export { LibSQLVector }

package/dist/_tsup-dts-rollup.d.ts

@@ -174,10 +174,11 @@ declare class LibSQLVector extends MastraVector {
     listIndexes(): Promise<string[]>;
     describeIndex(indexName: string): Promise<IndexStats>;
     /**
-     * Updates an index entry by its ID with the provided vector and/or metadata.
+     * @deprecated Use {@link updateVector} instead. This method will be removed on May 20th, 2025.
      *
-     * @param indexName - The name of the index to update.
-     * @param id - The ID of the index entry to update.
+     * 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.
      * @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.
@@ -188,7 +189,38 @@ declare class LibSQLVector extends MastraVector {
         vector?: number[];
         metadata?: Record<string, any>;
     }): Promise<void>;
+    /**
+     * 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.
+     * @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.
+     */
+    updateVector(indexName: string, id: string, update: {
+        vector?: number[];
+        metadata?: Record<string, any>;
+    }): Promise<void>;
+    /**
+     * @deprecated Use {@link deleteVector} instead. This method will be removed on May 20th, 2025.
+     *
+     * Deletes a vector by its ID.
+     * @param indexName - The name of the index containing the vector.
+     * @param id - The ID of the vector to delete.
+     * @returns A promise that resolves when the deletion is complete.
+     * @throws Will throw an error if the deletion operation fails.
+     */
     deleteIndexById(indexName: string, id: string): Promise<void>;
+    /**
+     * Deletes a vector by its ID.
+     * @param indexName - The name of the index containing the vector.
+     * @param id - The ID of the vector to delete.
+     * @returns A promise that resolves when the deletion is complete.
+     * @throws Will throw an error if the deletion operation fails.
+     */
+    deleteVector(indexName: string, id: string): Promise<void>;
     truncateIndex(indexName: string): Promise<void>;
 }
 export { LibSQLVector }

package/dist/index.cjs

@@ -617,10 +617,11 @@ var LibSQLVector = class extends vector.MastraVector {
     }
   }
   /**
-   * Updates an index entry by its ID with the provided vector and/or metadata.
+   * @deprecated Use {@link updateVector} instead. This method will be removed on May 20th, 2025.
    *
-   * @param indexName - The name of the index to update.
-   * @param id - The ID of the index entry to update.
+   * 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.
    * @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.
@@ -628,6 +629,24 @@ var LibSQLVector = class extends vector.MastraVector {
    * @throws Will throw an error if no updates are provided or if the update operation fails.
    */
   async updateIndexById(indexName, id, update) {
+    this.logger.warn(
+      `Deprecation Warning: updateIndexById() is deprecated. 
+      Please use updateVector() instead. 
+      updateIndexById() will be removed on May 20th, 2025.`
+    );
+    await this.updateVector(indexName, id, update);
+  }
+  /**
+   * 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.
+   * @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 {
       const updates = [];
       const args = [];
@@ -653,17 +672,41 @@ var LibSQLVector = class extends vector.MastraVector {
         args
       });
     } catch (error) {
-      throw new Error(`Failed to update index by id: ${id} for index: ${indexName}: ${error.message}`);
+      throw new Error(`Failed to update vector by id: ${id} for index: ${indexName}: ${error.message}`);
     }
   }
+  /**
+   * @deprecated Use {@link deleteVector} instead. This method will be removed on May 20th, 2025.
+   *
+   * Deletes a vector by its ID.
+   * @param indexName - The name of the index containing the vector.
+   * @param id - The ID of the vector to delete.
+   * @returns A promise that resolves when the deletion is complete.
+   * @throws Will throw an error if the deletion operation fails.
+   */
   async deleteIndexById(indexName, id) {
+    this.logger.warn(
+      `Deprecation Warning: deleteIndexById() is deprecated. 
+      Please use deleteVector() instead. 
+      deleteIndexById() will be removed on May 20th, 2025.`
+    );
+    await this.deleteVector(indexName, id);
+  }
+  /**
+   * Deletes a vector by its ID.
+   * @param indexName - The name of the index containing the vector.
+   * @param id - The ID of the vector to delete.
+   * @returns A promise that resolves when the deletion is complete.
+   * @throws Will throw an error if the deletion operation fails.
+   */
+  async deleteVector(indexName, id) {
     try {
       await this.turso.execute({
         sql: `DELETE FROM ${indexName} WHERE vector_id = ?`,
         args: [id]
       });
     } catch (error) {
-      throw new Error(`Failed to delete index by id: ${id} for index: ${indexName}: ${error.message}`);
+      throw new Error(`Failed to delete vector by id: ${id} for index: ${indexName}: ${error.message}`);
     }
   }
   async truncateIndex(indexName) {

package/dist/index.js

@@ -615,10 +615,11 @@ var LibSQLVector = class extends MastraVector {
     }
   }
   /**
-   * Updates an index entry by its ID with the provided vector and/or metadata.
+   * @deprecated Use {@link updateVector} instead. This method will be removed on May 20th, 2025.
    *
-   * @param indexName - The name of the index to update.
-   * @param id - The ID of the index entry to update.
+   * 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.
    * @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.
@@ -626,6 +627,24 @@ var LibSQLVector = class extends MastraVector {
    * @throws Will throw an error if no updates are provided or if the update operation fails.
    */
   async updateIndexById(indexName, id, update) {
+    this.logger.warn(
+      `Deprecation Warning: updateIndexById() is deprecated. 
+      Please use updateVector() instead. 
+      updateIndexById() will be removed on May 20th, 2025.`
+    );
+    await this.updateVector(indexName, id, update);
+  }
+  /**
+   * 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.
+   * @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 {
       const updates = [];
       const args = [];
@@ -651,17 +670,41 @@ var LibSQLVector = class extends MastraVector {
         args
       });
     } catch (error) {
-      throw new Error(`Failed to update index by id: ${id} for index: ${indexName}: ${error.message}`);
+      throw new Error(`Failed to update vector by id: ${id} for index: ${indexName}: ${error.message}`);
     }
   }
+  /**
+   * @deprecated Use {@link deleteVector} instead. This method will be removed on May 20th, 2025.
+   *
+   * Deletes a vector by its ID.
+   * @param indexName - The name of the index containing the vector.
+   * @param id - The ID of the vector to delete.
+   * @returns A promise that resolves when the deletion is complete.
+   * @throws Will throw an error if the deletion operation fails.
+   */
   async deleteIndexById(indexName, id) {
+    this.logger.warn(
+      `Deprecation Warning: deleteIndexById() is deprecated. 
+      Please use deleteVector() instead. 
+      deleteIndexById() will be removed on May 20th, 2025.`
+    );
+    await this.deleteVector(indexName, id);
+  }
+  /**
+   * Deletes a vector by its ID.
+   * @param indexName - The name of the index containing the vector.
+   * @param id - The ID of the vector to delete.
+   * @returns A promise that resolves when the deletion is complete.
+   * @throws Will throw an error if the deletion operation fails.
+   */
+  async deleteVector(indexName, id) {
     try {
       await this.turso.execute({
         sql: `DELETE FROM ${indexName} WHERE vector_id = ?`,
         args: [id]
       });
     } catch (error) {
-      throw new Error(`Failed to delete index by id: ${id} for index: ${indexName}: ${error.message}`);
+      throw new Error(`Failed to delete vector by id: ${id} for index: ${indexName}: ${error.message}`);
     }
   }
   async truncateIndex(indexName) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mastra/libsql",
-  "version": "0.0.4-alpha.2",
+  "version": "0.0.4-alpha.3",
   "description": "Libsql provider for Mastra - includes both vector and db storage capabilities",
   "type": "module",
   "main": "dist/index.js",
@@ -21,7 +21,7 @@
   "license": "MIT",
   "dependencies": {
     "@libsql/client": "^0.15.4",
-    "@mastra/core": "^0.9.4-alpha.2"
+    "@mastra/core": "^0.9.4-alpha.3"
   },
   "devDependencies": {
     "@microsoft/api-extractor": "^7.52.5",

package/src/vector/index.test.ts

@@ -165,7 +165,7 @@ describe('LibSQLVector', () => {
         expect(ids).toHaveLength(2);
         const id = ids[1];
 
-        await vectorDB.deleteIndexById(testIndexName, ids[0]);
+        await vectorDB.deleteVector(testIndexName, ids[0]);
 
         const results = await vectorDB.query({ indexName: testIndexName, queryVector: [1, 2, 3] });
         expect(results).toHaveLength(1);
@@ -181,7 +181,7 @@ describe('LibSQLVector', () => {
           vector: [4, 5, 6],
           metadata: { test: 'updated' },
         };
-        await vectorDB.updateIndexById(testIndexName, id, update);
+        await vectorDB.updateVector(testIndexName, id, update);
 
         const results = await vectorDB.query({
           indexName: testIndexName,
@@ -202,7 +202,7 @@ describe('LibSQLVector', () => {
         const update = {
           metadata: { test: 'updated' },
         };
-        await vectorDB.updateIndexById(testIndexName, id, update);
+        await vectorDB.updateVector(testIndexName, id, update);
 
         const results = await vectorDB.query({ indexName: testIndexName, queryVector: [1, 2, 3], topK: 1 });
         expect(results[0]?.id).toBe(id);
@@ -218,7 +218,7 @@ describe('LibSQLVector', () => {
         const update = {
           vector: [4, 5, 6],
         };
-        await vectorDB.updateIndexById(testIndexName, id, update);
+        await vectorDB.updateVector(testIndexName, id, update);
 
         const results = await vectorDB.query({
           indexName: testIndexName,
@@ -236,7 +236,7 @@ describe('LibSQLVector', () => {
         const metadata = [{ test: 'initial' }];
         const [id] = await vectorDB.upsert({ indexName: testIndexName, vectors, metadata });
 
-        await expect(vectorDB.updateIndexById(testIndexName, id, {})).rejects.toThrow('No updates provided');
+        await expect(vectorDB.updateVector(testIndexName, id, {})).rejects.toThrow('No updates provided');
       });
     });
 

package/src/vector/index.ts

@@ -274,10 +274,11 @@ export class LibSQLVector extends MastraVector {
   }
 
   /**
-   * Updates an index entry by its ID with the provided vector and/or metadata.
+   * @deprecated Use {@link updateVector} instead. This method will be removed on May 20th, 2025.
    *
-   * @param indexName - The name of the index to update.
-   * @param id - The ID of the index entry to update.
+   * 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.
    * @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.
@@ -288,6 +289,29 @@ export class LibSQLVector extends MastraVector {
     indexName: string,
     id: string,
     update: { vector?: number[]; metadata?: Record<string, any> },
+  ): Promise<void> {
+    this.logger.warn(
+      `Deprecation Warning: updateIndexById() is deprecated. 
+      Please use updateVector() instead. 
+      updateIndexById() will be removed on May 20th, 2025.`,
+    );
+    await this.updateVector(indexName, id, update);
+  }
+
+  /**
+   * 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.
+   * @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: string,
+    id: string,
+    update: { vector?: number[]; metadata?: Record<string, any> },
   ): Promise<void> {
     try {
       const updates = [];
@@ -320,18 +344,43 @@ export class LibSQLVector extends MastraVector {
         args,
       });
     } catch (error: any) {
-      throw new Error(`Failed to update index by id: ${id} for index: ${indexName}: ${error.message}`);
+      throw new Error(`Failed to update vector by id: ${id} for index: ${indexName}: ${error.message}`);
     }
   }
 
+  /**
+   * @deprecated Use {@link deleteVector} instead. This method will be removed on May 20th, 2025.
+   *
+   * Deletes a vector by its ID.
+   * @param indexName - The name of the index containing the vector.
+   * @param id - The ID of the vector to delete.
+   * @returns A promise that resolves when the deletion is complete.
+   * @throws Will throw an error if the deletion operation fails.
+   */
   async deleteIndexById(indexName: string, id: string): Promise<void> {
+    this.logger.warn(
+      `Deprecation Warning: deleteIndexById() is deprecated. 
+      Please use deleteVector() instead. 
+      deleteIndexById() will be removed on May 20th, 2025.`,
+    );
+    await this.deleteVector(indexName, id);
+  }
+
+  /**
+   * Deletes a vector by its ID.
+   * @param indexName - The name of the index containing the vector.
+   * @param id - The ID of the vector to delete.
+   * @returns A promise that resolves when the deletion is complete.
+   * @throws Will throw an error if the deletion operation fails.
+   */
+  async deleteVector(indexName: string, id: string): Promise<void> {
     try {
       await this.turso.execute({
         sql: `DELETE FROM ${indexName} WHERE vector_id = ?`,
         args: [id],
       });
     } catch (error: any) {
-      throw new Error(`Failed to delete index by id: ${id} for index: ${indexName}: ${error.message}`);
+      throw new Error(`Failed to delete vector by id: ${id} for index: ${indexName}: ${error.message}`);
     }
   }