@mastra/libsql 0.0.5-alpha.0 → 0.10.0

package/.turbo/turbo-build.log

@@ -1,23 +1,23 @@
 
-> @mastra/libsql@0.0.5-alpha.0 build /home/runner/work/mastra/mastra/stores/libsql
+> @mastra/libsql@0.10.0-alpha.1 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 8603ms
+TSC ⚡️ Build success in 8671ms
 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 8936ms
+DTS ⚡️ Build success in 8251ms
 CLI Cleaning output folder
 ESM Build start
 CJS Build start
-CJS dist/index.cjs 47.82 KB
-CJS ⚡️ Build success in 807ms
-ESM dist/index.js 47.62 KB
-ESM ⚡️ Build success in 808ms
+CJS dist/index.cjs 45.42 KB
+CJS ⚡️ Build success in 1060ms
+ESM dist/index.js 45.22 KB
+ESM ⚡️ Build success in 1062ms

package/CHANGELOG.md

@@ -1,5 +1,56 @@
 # @mastra/libsql
 
+## 0.10.0
+
+### Minor Changes
+
+- 83da932: Move @mastra/core to peerdeps
+
+### Patch Changes
+
+- eabdcd9: [MASTRA-3451] SQL Injection Protection
+- d0ee3c6: Change all public functions and constructors in vector stores to use named args and prepare to phase out positional args
+- a7292b0: BREAKING(@mastra/core, all vector stores): Vector store breaking changes (remove deprecated functions and positional arguments)
+- Updated dependencies [b3a3d63]
+- Updated dependencies [344f453]
+- Updated dependencies [0a3ae6d]
+- Updated dependencies [95911be]
+- Updated dependencies [f53a6ac]
+- Updated dependencies [5eb5a99]
+- Updated dependencies [7e632c5]
+- Updated dependencies [1e9fbfa]
+- Updated dependencies [eabdcd9]
+- Updated dependencies [90be034]
+- Updated dependencies [99f050a]
+- Updated dependencies [d0ee3c6]
+- Updated dependencies [b2ae5aa]
+- Updated dependencies [23f258c]
+- Updated dependencies [a7292b0]
+- Updated dependencies [0dcb9f0]
+- Updated dependencies [2672a05]
+  - @mastra/core@0.10.0
+
+## 0.1.0-alpha.1
+
+### Minor Changes
+
+- 83da932: Move @mastra/core to peerdeps
+
+### Patch Changes
+
+- a7292b0: BREAKING(@mastra/core, all vector stores): Vector store breaking changes (remove deprecated functions and positional arguments)
+- Updated dependencies [b3a3d63]
+- Updated dependencies [344f453]
+- Updated dependencies [0a3ae6d]
+- Updated dependencies [95911be]
+- Updated dependencies [5eb5a99]
+- Updated dependencies [7e632c5]
+- Updated dependencies [1e9fbfa]
+- Updated dependencies [b2ae5aa]
+- Updated dependencies [a7292b0]
+- Updated dependencies [0dcb9f0]
+  - @mastra/core@0.10.0-alpha.1
+
 ## 0.0.5-alpha.0
 
 ### Patch Changes

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

@@ -10,9 +10,7 @@ import { MastraStorage } from '@mastra/core/storage';
 import { MastraVector } from '@mastra/core/vector';
 import type { MessageType } from '@mastra/core/memory';
 import type { OperatorSupport } from '@mastra/core/vector/filter';
-import type { ParamsToArgs } from '@mastra/core/vector';
 import type { QueryResult } from '@mastra/core/vector';
-import type { QueryVectorArgs } from '@mastra/core/vector';
 import type { QueryVectorParams } from '@mastra/core/vector';
 import type { StorageColumn } from '@mastra/core/storage';
 import type { StorageGetMessagesArg } from '@mastra/core/storage';
@@ -62,8 +60,6 @@ export declare class LibSQLFilterTranslator extends BaseFilterTranslator {
     private translateNode;
 }
 
-declare type LibSQLQueryArgs = [...QueryVectorArgs, number?];
-
 declare interface LibSQLQueryParams extends QueryVectorParams {
     minScore?: number;
 }
@@ -155,35 +151,18 @@ declare class LibSQLVector extends MastraVector {
         syncInterval?: number;
     });
     transformFilter(filter?: VectorFilter): VectorFilter;
-    query(...args: ParamsToArgs<LibSQLQueryParams> | LibSQLQueryArgs): Promise<QueryResult[]>;
-    upsert(...args: ParamsToArgs<UpsertVectorParams>): Promise<string[]>;
-    createIndex(...args: ParamsToArgs<CreateIndexParams>): Promise<void>;
-    deleteIndex(...args: ParamsToArgs<DeleteIndexParams>): Promise<void>;
+    query({ indexName, queryVector, topK, filter, includeVector, minScore, }: LibSQLQueryParams): Promise<QueryResult[]>;
+    upsert({ indexName, vectors, metadata, ids }: UpsertVectorParams): Promise<string[]>;
+    createIndex({ indexName, dimension }: CreateIndexParams): Promise<void>;
+    deleteIndex({ indexName }: DeleteIndexParams): Promise<void>;
     listIndexes(): Promise<string[]>;
     /**
      * Retrieves statistics about a vector index.
      *
-     * @param params - The parameters for describing an index
-     * @param params.indexName - The name of the index to describe
+     * @param {string} indexName - The name of the index to describe
      * @returns A promise that resolves to the index statistics including dimension, count and metric
      */
-    describeIndex(...args: ParamsToArgs<DescribeIndexParams>): Promise<IndexStats>;
-    /**
-     * @deprecated Use {@link updateVector} instead. This method will be removed on May 20th, 2025.
-     *
-     * 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.
-     */
-    updateIndexById(indexName: string, id: string, update: {
-        vector?: number[];
-        metadata?: Record<string, any>;
-    }): Promise<void>;
+    describeIndex({ indexName }: DescribeIndexParams): Promise<IndexStats>;
     /**
      * Updates a vector by its ID with the provided vector and/or metadata.
      *
@@ -195,17 +174,7 @@ declare class LibSQLVector extends MastraVector {
      * @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(...args: ParamsToArgs<UpdateVectorParams>): 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>;
+    updateVector({ indexName, id, update }: UpdateVectorParams): Promise<void>;
     /**
      * Deletes a vector by its ID.
      * @param indexName - The name of the index containing the vector.
@@ -213,8 +182,8 @@ declare class LibSQLVector extends MastraVector {
      * @returns A promise that resolves when the deletion is complete.
      * @throws Will throw an error if the deletion operation fails.
      */
-    deleteVector(...args: ParamsToArgs<DeleteVectorParams>): Promise<void>;
-    truncateIndex(...args: ParamsToArgs<DeleteIndexParams>): Promise<void>;
+    deleteVector({ indexName, id }: DeleteVectorParams): Promise<void>;
+    truncateIndex({ indexName }: DeleteIndexParams): Promise<void>;
 }
 export { LibSQLVector }
 export { LibSQLVector as LibSQLVector_alias_1 }

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

@@ -10,9 +10,7 @@ import { MastraStorage } from '@mastra/core/storage';
 import { MastraVector } from '@mastra/core/vector';
 import type { MessageType } from '@mastra/core/memory';
 import type { OperatorSupport } from '@mastra/core/vector/filter';
-import type { ParamsToArgs } from '@mastra/core/vector';
 import type { QueryResult } from '@mastra/core/vector';
-import type { QueryVectorArgs } from '@mastra/core/vector';
 import type { QueryVectorParams } from '@mastra/core/vector';
 import type { StorageColumn } from '@mastra/core/storage';
 import type { StorageGetMessagesArg } from '@mastra/core/storage';
@@ -62,8 +60,6 @@ export declare class LibSQLFilterTranslator extends BaseFilterTranslator {
     private translateNode;
 }
 
-declare type LibSQLQueryArgs = [...QueryVectorArgs, number?];
-
 declare interface LibSQLQueryParams extends QueryVectorParams {
     minScore?: number;
 }
@@ -155,35 +151,18 @@ declare class LibSQLVector extends MastraVector {
         syncInterval?: number;
     });
     transformFilter(filter?: VectorFilter): VectorFilter;
-    query(...args: ParamsToArgs<LibSQLQueryParams> | LibSQLQueryArgs): Promise<QueryResult[]>;
-    upsert(...args: ParamsToArgs<UpsertVectorParams>): Promise<string[]>;
-    createIndex(...args: ParamsToArgs<CreateIndexParams>): Promise<void>;
-    deleteIndex(...args: ParamsToArgs<DeleteIndexParams>): Promise<void>;
+    query({ indexName, queryVector, topK, filter, includeVector, minScore, }: LibSQLQueryParams): Promise<QueryResult[]>;
+    upsert({ indexName, vectors, metadata, ids }: UpsertVectorParams): Promise<string[]>;
+    createIndex({ indexName, dimension }: CreateIndexParams): Promise<void>;
+    deleteIndex({ indexName }: DeleteIndexParams): Promise<void>;
     listIndexes(): Promise<string[]>;
     /**
      * Retrieves statistics about a vector index.
      *
-     * @param params - The parameters for describing an index
-     * @param params.indexName - The name of the index to describe
+     * @param {string} indexName - The name of the index to describe
      * @returns A promise that resolves to the index statistics including dimension, count and metric
      */
-    describeIndex(...args: ParamsToArgs<DescribeIndexParams>): Promise<IndexStats>;
-    /**
-     * @deprecated Use {@link updateVector} instead. This method will be removed on May 20th, 2025.
-     *
-     * 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.
-     */
-    updateIndexById(indexName: string, id: string, update: {
-        vector?: number[];
-        metadata?: Record<string, any>;
-    }): Promise<void>;
+    describeIndex({ indexName }: DescribeIndexParams): Promise<IndexStats>;
     /**
      * Updates a vector by its ID with the provided vector and/or metadata.
      *
@@ -195,17 +174,7 @@ declare class LibSQLVector extends MastraVector {
      * @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(...args: ParamsToArgs<UpdateVectorParams>): 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>;
+    updateVector({ indexName, id, update }: UpdateVectorParams): Promise<void>;
     /**
      * Deletes a vector by its ID.
      * @param indexName - The name of the index containing the vector.
@@ -213,8 +182,8 @@ declare class LibSQLVector extends MastraVector {
      * @returns A promise that resolves when the deletion is complete.
      * @throws Will throw an error if the deletion operation fails.
      */
-    deleteVector(...args: ParamsToArgs<DeleteVectorParams>): Promise<void>;
-    truncateIndex(...args: ParamsToArgs<DeleteIndexParams>): Promise<void>;
+    deleteVector({ indexName, id }: DeleteVectorParams): Promise<void>;
+    truncateIndex({ indexName }: DeleteIndexParams): Promise<void>;
 }
 export { LibSQLVector }
 export { LibSQLVector as LibSQLVector_alias_1 }

package/dist/index.cjs

@@ -508,10 +508,15 @@ var LibSQLVector = class extends vector.MastraVector {
     const translator = new LibSQLFilterTranslator();
     return translator.translate(filter);
   }
-  async query(...args) {
-    const params = this.normalizeArgs("query", args, ["minScore"]);
+  async query({
+    indexName,
+    queryVector,
+    topK = 10,
+    filter,
+    includeVector = false,
+    minScore = 0
+  }) {
     try {
-      const { indexName, queryVector, topK = 10, filter, includeVector = false, minScore = 0 } = params;
       if (!Number.isInteger(topK) || topK <= 0) {
         throw new Error("topK must be a positive integer");
       }
@@ -552,9 +557,7 @@ var LibSQLVector = class extends vector.MastraVector {
     } finally {
     }
   }
-  async upsert(...args) {
-    const params = this.normalizeArgs("upsert", args);
-    const { indexName, vectors, metadata, ids } = params;
+  async upsert({ indexName, vectors, metadata, ids }) {
     const tx = await this.turso.transaction("write");
     try {
       const parsedIndexName = utils.parseSqlIdentifier(indexName, "index name");
@@ -595,9 +598,7 @@ var LibSQLVector = class extends vector.MastraVector {
       throw error;
     }
   }
-  async createIndex(...args) {
-    const params = this.normalizeArgs("createIndex", args);
-    const { indexName, dimension } = params;
+  async createIndex({ indexName, dimension }) {
     try {
       if (!Number.isInteger(dimension) || dimension <= 0) {
         throw new Error("Dimension must be a positive integer");
@@ -627,9 +628,7 @@ var LibSQLVector = class extends vector.MastraVector {
     } finally {
     }
   }
-  async deleteIndex(...args) {
-    const params = this.normalizeArgs("deleteIndex", args);
-    const { indexName } = params;
+  async deleteIndex({ indexName }) {
     try {
       const parsedIndexName = utils.parseSqlIdentifier(indexName, "index name");
       await this.turso.execute({
@@ -661,13 +660,10 @@ var LibSQLVector = class extends vector.MastraVector {
   /**
    * Retrieves statistics about a vector index.
    *
-   * @param params - The parameters for describing an index
-   * @param params.indexName - The name of the index to describe
+   * @param {string} indexName - The name of the index to describe
    * @returns A promise that resolves to the index statistics including dimension, count and metric
    */
-  async describeIndex(...args) {
-    const params = this.normalizeArgs("describeIndex", args);
-    const { indexName } = params;
+  async describeIndex({ indexName }) {
     try {
       const parsedIndexName = utils.parseSqlIdentifier(indexName, "index name");
       const tableInfoQuery = `
@@ -702,26 +698,6 @@ var LibSQLVector = class extends vector.MastraVector {
       throw new Error(`Failed to describe vector table: ${e.message}`);
     }
   }
-  /**
-   * @deprecated Use {@link updateVector} instead. This method will be removed on May 20th, 2025.
-   *
-   * 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 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.
    *
@@ -733,25 +709,23 @@ var LibSQLVector = class extends vector.MastraVector {
    * @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(...args) {
-    const params = this.normalizeArgs("updateVector", args);
-    const { indexName, id, update } = params;
+  async updateVector({ indexName, id, update }) {
     try {
       const parsedIndexName = utils.parseSqlIdentifier(indexName, "index name");
       const updates = [];
-      const args2 = [];
+      const args = [];
       if (update.vector) {
         updates.push("embedding = vector32(?)");
-        args2.push(JSON.stringify(update.vector));
+        args.push(JSON.stringify(update.vector));
       }
       if (update.metadata) {
         updates.push("metadata = ?");
-        args2.push(JSON.stringify(update.metadata));
+        args.push(JSON.stringify(update.metadata));
       }
       if (updates.length === 0) {
         throw new Error("No updates provided");
       }
-      args2.push(id);
+      args.push(id);
       const query = `
         UPDATE ${parsedIndexName}
         SET ${updates.join(", ")}
@@ -759,29 +733,12 @@ var LibSQLVector = class extends vector.MastraVector {
       `;
       await this.turso.execute({
         sql: query,
-        args: args2
+        args
       });
     } catch (error) {
       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.
@@ -789,9 +746,7 @@ var LibSQLVector = class extends vector.MastraVector {
    * @returns A promise that resolves when the deletion is complete.
    * @throws Will throw an error if the deletion operation fails.
    */
-  async deleteVector(...args) {
-    const params = this.normalizeArgs("deleteVector", args);
-    const { indexName, id } = params;
+  async deleteVector({ indexName, id }) {
     try {
       const parsedIndexName = utils.parseSqlIdentifier(indexName, "index name");
       await this.turso.execute({
@@ -802,9 +757,7 @@ var LibSQLVector = class extends vector.MastraVector {
       throw new Error(`Failed to delete vector by id: ${id} for index: ${indexName}: ${error.message}`);
     }
   }
-  async truncateIndex(...args) {
-    const params = this.normalizeArgs("truncateIndex", args);
-    const { indexName } = params;
+  async truncateIndex({ indexName }) {
     await this.turso.execute({
       sql: `DELETE FROM ${utils.parseSqlIdentifier(indexName, "index name")}`,
       args: []

package/dist/index.js

@@ -506,10 +506,15 @@ var LibSQLVector = class extends MastraVector {
     const translator = new LibSQLFilterTranslator();
     return translator.translate(filter);
   }
-  async query(...args) {
-    const params = this.normalizeArgs("query", args, ["minScore"]);
+  async query({
+    indexName,
+    queryVector,
+    topK = 10,
+    filter,
+    includeVector = false,
+    minScore = 0
+  }) {
     try {
-      const { indexName, queryVector, topK = 10, filter, includeVector = false, minScore = 0 } = params;
       if (!Number.isInteger(topK) || topK <= 0) {
         throw new Error("topK must be a positive integer");
       }
@@ -550,9 +555,7 @@ var LibSQLVector = class extends MastraVector {
     } finally {
     }
   }
-  async upsert(...args) {
-    const params = this.normalizeArgs("upsert", args);
-    const { indexName, vectors, metadata, ids } = params;
+  async upsert({ indexName, vectors, metadata, ids }) {
     const tx = await this.turso.transaction("write");
     try {
       const parsedIndexName = parseSqlIdentifier(indexName, "index name");
@@ -593,9 +596,7 @@ var LibSQLVector = class extends MastraVector {
       throw error;
     }
   }
-  async createIndex(...args) {
-    const params = this.normalizeArgs("createIndex", args);
-    const { indexName, dimension } = params;
+  async createIndex({ indexName, dimension }) {
     try {
       if (!Number.isInteger(dimension) || dimension <= 0) {
         throw new Error("Dimension must be a positive integer");
@@ -625,9 +626,7 @@ var LibSQLVector = class extends MastraVector {
     } finally {
     }
   }
-  async deleteIndex(...args) {
-    const params = this.normalizeArgs("deleteIndex", args);
-    const { indexName } = params;
+  async deleteIndex({ indexName }) {
     try {
       const parsedIndexName = parseSqlIdentifier(indexName, "index name");
       await this.turso.execute({
@@ -659,13 +658,10 @@ var LibSQLVector = class extends MastraVector {
   /**
    * Retrieves statistics about a vector index.
    *
-   * @param params - The parameters for describing an index
-   * @param params.indexName - The name of the index to describe
+   * @param {string} indexName - The name of the index to describe
    * @returns A promise that resolves to the index statistics including dimension, count and metric
    */
-  async describeIndex(...args) {
-    const params = this.normalizeArgs("describeIndex", args);
-    const { indexName } = params;
+  async describeIndex({ indexName }) {
     try {
       const parsedIndexName = parseSqlIdentifier(indexName, "index name");
       const tableInfoQuery = `
@@ -700,26 +696,6 @@ var LibSQLVector = class extends MastraVector {
       throw new Error(`Failed to describe vector table: ${e.message}`);
     }
   }
-  /**
-   * @deprecated Use {@link updateVector} instead. This method will be removed on May 20th, 2025.
-   *
-   * 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 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.
    *
@@ -731,25 +707,23 @@ var LibSQLVector = class extends MastraVector {
    * @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(...args) {
-    const params = this.normalizeArgs("updateVector", args);
-    const { indexName, id, update } = params;
+  async updateVector({ indexName, id, update }) {
     try {
       const parsedIndexName = parseSqlIdentifier(indexName, "index name");
       const updates = [];
-      const args2 = [];
+      const args = [];
       if (update.vector) {
         updates.push("embedding = vector32(?)");
-        args2.push(JSON.stringify(update.vector));
+        args.push(JSON.stringify(update.vector));
       }
       if (update.metadata) {
         updates.push("metadata = ?");
-        args2.push(JSON.stringify(update.metadata));
+        args.push(JSON.stringify(update.metadata));
       }
       if (updates.length === 0) {
         throw new Error("No updates provided");
       }
-      args2.push(id);
+      args.push(id);
       const query = `
         UPDATE ${parsedIndexName}
         SET ${updates.join(", ")}
@@ -757,29 +731,12 @@ var LibSQLVector = class extends MastraVector {
       `;
       await this.turso.execute({
         sql: query,
-        args: args2
+        args
       });
     } catch (error) {
       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.
@@ -787,9 +744,7 @@ var LibSQLVector = class extends MastraVector {
    * @returns A promise that resolves when the deletion is complete.
    * @throws Will throw an error if the deletion operation fails.
    */
-  async deleteVector(...args) {
-    const params = this.normalizeArgs("deleteVector", args);
-    const { indexName, id } = params;
+  async deleteVector({ indexName, id }) {
     try {
       const parsedIndexName = parseSqlIdentifier(indexName, "index name");
       await this.turso.execute({
@@ -800,9 +755,7 @@ var LibSQLVector = class extends MastraVector {
       throw new Error(`Failed to delete vector by id: ${id} for index: ${indexName}: ${error.message}`);
     }
   }
-  async truncateIndex(...args) {
-    const params = this.normalizeArgs("truncateIndex", args);
-    const { indexName } = params;
+  async truncateIndex({ indexName }) {
     await this.turso.execute({
       sql: `DELETE FROM ${parseSqlIdentifier(indexName, "index name")}`,
       args: []

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mastra/libsql",
-  "version": "0.0.5-alpha.0",
+  "version": "0.10.0",
   "description": "Libsql provider for Mastra - includes both vector and db storage capabilities",
   "type": "module",
   "main": "dist/index.js",
@@ -20,8 +20,7 @@
   },
   "license": "MIT",
   "dependencies": {
-    "@libsql/client": "^0.15.4",
-    "@mastra/core": "^0.9.5-alpha.0"
+    "@libsql/client": "^0.15.4"
   },
   "devDependencies": {
     "@microsoft/api-extractor": "^7.52.5",
@@ -30,8 +29,12 @@
     "tsup": "^8.4.0",
     "typescript": "^5.8.3",
     "vitest": "^3.1.2",
-    "@internal/lint": "0.0.5",
-    "@internal/storage-test-utils": "0.0.2-alpha.5"
+    "@internal/lint": "0.0.6",
+    "@internal/storage-test-utils": "0.0.2",
+    "@mastra/core": "0.10.0"
+  },
+  "peerDependencies": {
+    "@mastra/core": "^0.10.0"
   },
   "scripts": {
     "build": "tsup src/index.ts --format esm,cjs --experimental-dts --clean --treeshake=smallest --splitting",

package/src/vector/index.test.ts

@@ -1,4 +1,4 @@
-import { describe, it, expect, beforeAll, afterAll, beforeEach, afterEach, vi } from 'vitest';
+import { describe, it, expect, beforeAll, afterAll, beforeEach, afterEach } from 'vitest';
 
 import { LibSQLVector } from './index.js';
 
@@ -58,7 +58,7 @@ describe('LibSQLVector', () => {
       });
 
       it('should not return created index in list if it is deleted', async () => {
-        await vectorDB.deleteIndex(indexName);
+        await vectorDB.deleteIndex({ indexName });
         const indexes = await vectorDB.listIndexes();
         expect(indexes).not.toContain(indexName);
       });
@@ -1679,102 +1679,4 @@ describe('LibSQLVector', () => {
       await vectorDB.deleteIndex({ indexName: duplicateIndexName });
     });
   });
-
-  describe('Deprecation Warnings', () => {
-    const indexName = 'testdeprecationwarnings';
-
-    const indexName2 = 'testdeprecationwarnings2';
-
-    let warnSpy;
-
-    beforeAll(async () => {
-      await vectorDB.createIndex({ indexName: indexName, dimension: 3 });
-    });
-
-    afterAll(async () => {
-      await vectorDB.deleteIndex({ indexName });
-      await vectorDB.deleteIndex({ indexName: indexName2 });
-    });
-
-    beforeEach(async () => {
-      warnSpy = vi.spyOn(vectorDB['logger'], 'warn');
-    });
-
-    afterEach(async () => {
-      warnSpy.mockRestore();
-      await vectorDB.deleteIndex({ indexName: indexName2 });
-    });
-
-    it('should show deprecation warning when using individual args for createIndex', async () => {
-      await vectorDB.createIndex(indexName2, 3, 'cosine');
-
-      expect(warnSpy).toHaveBeenCalledWith(
-        expect.stringContaining('Deprecation Warning: Passing individual arguments to createIndex() is deprecated'),
-      );
-    });
-
-    it('should show deprecation warning when using individual args for upsert', async () => {
-      await vectorDB.upsert(indexName, [[1, 2, 3]], [{ test: 'data' }]);
-
-      expect(warnSpy).toHaveBeenCalledWith(
-        expect.stringContaining('Deprecation Warning: Passing individual arguments to upsert() is deprecated'),
-      );
-    });
-
-    it('should show deprecation warning when using individual args for query', async () => {
-      await vectorDB.query(indexName, [1, 2, 3], 5);
-
-      expect(warnSpy).toHaveBeenCalledWith(
-        expect.stringContaining('Deprecation Warning: Passing individual arguments to query() is deprecated'),
-      );
-    });
-
-    it('should not show deprecation warning when using object param for query', async () => {
-      await vectorDB.query({
-        indexName,
-        queryVector: [1, 2, 3],
-        topK: 5,
-      });
-
-      expect(warnSpy).not.toHaveBeenCalled();
-    });
-
-    it('should not show deprecation warning when using object param for createIndex', async () => {
-      await vectorDB.createIndex({
-        indexName: indexName2,
-        dimension: 3,
-        metric: 'cosine',
-      });
-
-      expect(warnSpy).not.toHaveBeenCalled();
-    });
-
-    it('should not show deprecation warning when using object param for upsert', async () => {
-      await vectorDB.upsert({
-        indexName,
-        vectors: [[1, 2, 3]],
-        metadata: [{ test: 'data' }],
-      });
-
-      expect(warnSpy).not.toHaveBeenCalled();
-    });
-
-    it('should maintain backward compatibility with individual args', async () => {
-      // Query
-      const queryResults = await vectorDB.query(indexName, [1, 2, 3], 5);
-      expect(Array.isArray(queryResults)).toBe(true);
-
-      // CreateIndex
-      await expect(vectorDB.createIndex(indexName2, 3, 'cosine')).resolves.not.toThrow();
-
-      // Upsert
-      const upsertResults = await vectorDB.upsert({
-        indexName,
-        vectors: [[1, 2, 3]],
-        metadata: [{ test: 'data' }],
-      });
-      expect(Array.isArray(upsertResults)).toBe(true);
-      expect(upsertResults).toHaveLength(1);
-    });
-  });
 });

package/src/vector/index.ts

@@ -9,8 +9,6 @@ import type {
   QueryVectorParams,
   CreateIndexParams,
   UpsertVectorParams,
-  ParamsToArgs,
-  QueryVectorArgs,
   DescribeIndexParams,
   DeleteIndexParams,
   DeleteVectorParams,
@@ -24,8 +22,6 @@ interface LibSQLQueryParams extends QueryVectorParams {
   minScore?: number;
 }
 
-type LibSQLQueryArgs = [...QueryVectorArgs, number?];
-
 export class LibSQLVector extends MastraVector {
   private turso: TursoClient;
 
@@ -62,12 +58,15 @@ export class LibSQLVector extends MastraVector {
     return translator.translate(filter);
   }
 
-  async query(...args: ParamsToArgs<LibSQLQueryParams> | LibSQLQueryArgs): Promise<QueryResult[]> {
-    const params = this.normalizeArgs<LibSQLQueryParams, LibSQLQueryArgs>('query', args, ['minScore']);
-
+  async query({
+    indexName,
+    queryVector,
+    topK = 10,
+    filter,
+    includeVector = false,
+    minScore = 0,
+  }: LibSQLQueryParams): Promise<QueryResult[]> {
     try {
-      const { indexName, queryVector, topK = 10, filter, includeVector = false, minScore = 0 } = params;
-
       if (!Number.isInteger(topK) || topK <= 0) {
         throw new Error('topK must be a positive integer');
       }
@@ -116,10 +115,7 @@ export class LibSQLVector extends MastraVector {
     }
   }
 
-  async upsert(...args: ParamsToArgs<UpsertVectorParams>): Promise<string[]> {
-    const params = this.normalizeArgs<UpsertVectorParams>('upsert', args);
-
-    const { indexName, vectors, metadata, ids } = params;
+  async upsert({ indexName, vectors, metadata, ids }: UpsertVectorParams): Promise<string[]> {
     const tx = await this.turso.transaction('write');
 
     try {
@@ -173,10 +169,7 @@ export class LibSQLVector extends MastraVector {
     }
   }
 
-  async createIndex(...args: ParamsToArgs<CreateIndexParams>): Promise<void> {
-    const params = this.normalizeArgs<CreateIndexParams>('createIndex', args);
-
-    const { indexName, dimension } = params;
+  async createIndex({ indexName, dimension }: CreateIndexParams): Promise<void> {
     try {
       // Validate inputs
       if (!Number.isInteger(dimension) || dimension <= 0) {
@@ -212,10 +205,7 @@ export class LibSQLVector extends MastraVector {
     }
   }
 
-  async deleteIndex(...args: ParamsToArgs<DeleteIndexParams>): Promise<void> {
-    const params = this.normalizeArgs<DeleteIndexParams>('deleteIndex', args);
-
-    const { indexName } = params;
+  async deleteIndex({ indexName }: DeleteIndexParams): Promise<void> {
     try {
       const parsedIndexName = parseSqlIdentifier(indexName, 'index name');
       // Drop the table
@@ -251,14 +241,10 @@ export class LibSQLVector extends MastraVector {
   /**
    * Retrieves statistics about a vector index.
    *
-   * @param params - The parameters for describing an index
-   * @param params.indexName - The name of the index to describe
+   * @param {string} indexName - The name of the index to describe
    * @returns A promise that resolves to the index statistics including dimension, count and metric
    */
-  async describeIndex(...args: ParamsToArgs<DescribeIndexParams>): Promise<IndexStats> {
-    const params = this.normalizeArgs<DescribeIndexParams>('describeIndex', args);
-
-    const { indexName } = params;
+  async describeIndex({ indexName }: DescribeIndexParams): Promise<IndexStats> {
     try {
       const parsedIndexName = parseSqlIdentifier(indexName, 'index name');
       // Get table info including column info
@@ -303,31 +289,6 @@ export class LibSQLVector extends MastraVector {
     }
   }
 
-  /**
-   * @deprecated Use {@link updateVector} instead. This method will be removed on May 20th, 2025.
-   *
-   * 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 updateIndexById(
-    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.
    *
@@ -339,9 +300,7 @@ export class LibSQLVector extends MastraVector {
    * @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(...args: ParamsToArgs<UpdateVectorParams>): Promise<void> {
-    const params = this.normalizeArgs<UpdateVectorParams>('updateVector', args);
-    const { indexName, id, update } = params;
+  async updateVector({ indexName, id, update }: UpdateVectorParams): Promise<void> {
     try {
       const parsedIndexName = parseSqlIdentifier(indexName, 'index name');
       const updates = [];
@@ -379,34 +338,13 @@ export class LibSQLVector extends MastraVector {
   }
 
   /**
-   * @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(...args: ParamsToArgs<DeleteVectorParams>): Promise<void> {
-    const params = this.normalizeArgs<DeleteVectorParams>('deleteVector', args);
-
-    const { indexName, id } = params;
+  async deleteVector({ indexName, id }: DeleteVectorParams): Promise<void> {
     try {
       const parsedIndexName = parseSqlIdentifier(indexName, 'index name');
       await this.turso.execute({
@@ -418,9 +356,7 @@ export class LibSQLVector extends MastraVector {
     }
   }
 
-  async truncateIndex(...args: ParamsToArgs<DeleteIndexParams>): Promise<void> {
-    const params = this.normalizeArgs<DeleteIndexParams>('truncateIndex', args);
-    const { indexName } = params;
+  async truncateIndex({ indexName }: DeleteIndexParams): Promise<void> {
     await this.turso.execute({
       sql: `DELETE FROM ${parseSqlIdentifier(indexName, 'index name')}`,
       args: [],