@mastra/libsql 0.0.4 → 0.1.0-alpha.1

package/.turbo/turbo-build.log

@@ -1,23 +1,23 @@
 
-> @mastra/libsql@0.0.4-alpha.4 build /home/runner/work/mastra/mastra/stores/libsql
+> @mastra/libsql@0.1.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 8727ms
+TSC ⚡️ Build success in 8453ms
 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 10253ms
+DTS ⚡️ Build success in 12124ms
 CLI Cleaning output folder
 ESM Build start
 CJS Build start
-ESM dist/index.js 43.50 KB
-ESM ⚡️ Build success in 775ms
-CJS dist/index.cjs 43.63 KB
-CJS ⚡️ Build success in 774ms
+CJS dist/index.cjs 45.42 KB
+CJS ⚡️ Build success in 1441ms
+ESM dist/index.js 45.22 KB
+ESM ⚡️ Build success in 1444ms

package/CHANGELOG.md

@@ -1,5 +1,41 @@
 # @mastra/libsql
 
+## 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
+
+- 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
+- Updated dependencies [f53a6ac]
+- Updated dependencies [eabdcd9]
+- Updated dependencies [90be034]
+- Updated dependencies [99f050a]
+- Updated dependencies [d0ee3c6]
+- Updated dependencies [23f258c]
+- Updated dependencies [2672a05]
+  - @mastra/core@0.9.5-alpha.0
+
 ## 0.0.4
 
 ### Patch Changes

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

@@ -1,26 +1,22 @@
-import type { ArrayOperator } from '@mastra/core/vector/filter';
 import { BaseFilterTranslator } from '@mastra/core/vector/filter';
-import type { BasicOperator } from '@mastra/core/vector/filter';
 import type { CreateIndexParams } from '@mastra/core/vector';
-import type { ElementOperator } from '@mastra/core/vector/filter';
+import type { DeleteIndexParams } from '@mastra/core/vector';
+import type { DeleteVectorParams } from '@mastra/core/vector';
+import type { DescribeIndexParams } from '@mastra/core/vector';
 import type { EvalRow } from '@mastra/core/storage';
 import type { IndexStats } from '@mastra/core/vector';
 import type { InValue } from '@libsql/client';
-import type { LogicalOperator } from '@mastra/core/vector/filter';
 import { MastraStorage } from '@mastra/core/storage';
 import { MastraVector } from '@mastra/core/vector';
 import type { MessageType } from '@mastra/core/memory';
-import type { NumericOperator } from '@mastra/core/vector/filter';
 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 { RegexOperator } from '@mastra/core/vector/filter';
 import type { StorageColumn } from '@mastra/core/storage';
 import type { StorageGetMessagesArg } from '@mastra/core/storage';
 import type { StorageThreadType } from '@mastra/core/memory';
 import type { TABLE_NAMES } from '@mastra/core/storage';
+import type { UpdateVectorParams } from '@mastra/core/vector';
 import type { UpsertVectorParams } from '@mastra/core/vector';
 import type { VectorFilter } from '@mastra/core/vector/filter';
 import type { WorkflowRun } from '@mastra/core/storage';
@@ -28,21 +24,11 @@ import type { WorkflowRuns } from '@mastra/core/storage';
 
 export declare function buildFilterQuery(filter: VectorFilter): FilterResult;
 
-export declare const FILTER_OPERATORS: Record<string, OperatorFn>;
-
-declare type FilterOperator = {
-    sql: string;
-    needsValue: boolean;
-    transformValue?: (value: any) => any;
-};
-
-export declare interface FilterResult {
+declare interface FilterResult {
     sql: string;
     values: InValue[];
 }
 
-export declare const handleKey: (key: string) => string;
-
 /**
  * Vector store specific prompt that details supported operators and examples.
  * This prompt helps users construct valid filters for LibSQL Vector.
@@ -74,8 +60,6 @@ export declare class LibSQLFilterTranslator extends BaseFilterTranslator {
     private translateNode;
 }
 
-declare type LibSQLQueryArgs = [...QueryVectorArgs, number?];
-
 declare interface LibSQLQueryParams extends QueryVectorParams {
     minScore?: number;
 }
@@ -167,30 +151,21 @@ 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(indexName: string): 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[]>;
-    describeIndex(indexName: string): Promise<IndexStats>;
     /**
-     * @deprecated Use {@link updateVector} instead. This method will be removed on May 20th, 2025.
+     * Retrieves statistics about a vector index.
      *
-     * 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.
+     * @param {string} indexName - The name of the index to describe
+     * @returns A promise that resolves to the index statistics including dimension, count and metric
      */
-    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.
+     *
      * @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.
@@ -199,35 +174,18 @@ 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(indexName: string, id: string, update: {
-        vector?: number[];
-        metadata?: Record<string, any>;
-    }): Promise<void>;
+    updateVector({ indexName, id, update }: 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>;
-    /**
-     * 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>;
+    deleteVector({ indexName, id }: DeleteVectorParams): Promise<void>;
+    truncateIndex({ indexName }: DeleteIndexParams): Promise<void>;
 }
 export { LibSQLVector }
 export { LibSQLVector as LibSQLVector_alias_1 }
 
-declare type OperatorFn = (key: string, value?: any) => FilterOperator;
-
-export declare type OperatorType = BasicOperator | NumericOperator | ArrayOperator | ElementOperator | LogicalOperator | '$contains' | Exclude<RegexOperator, '$options'>;
-
 export { }

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

@@ -1,26 +1,22 @@
-import type { ArrayOperator } from '@mastra/core/vector/filter';
 import { BaseFilterTranslator } from '@mastra/core/vector/filter';
-import type { BasicOperator } from '@mastra/core/vector/filter';
 import type { CreateIndexParams } from '@mastra/core/vector';
-import type { ElementOperator } from '@mastra/core/vector/filter';
+import type { DeleteIndexParams } from '@mastra/core/vector';
+import type { DeleteVectorParams } from '@mastra/core/vector';
+import type { DescribeIndexParams } from '@mastra/core/vector';
 import type { EvalRow } from '@mastra/core/storage';
 import type { IndexStats } from '@mastra/core/vector';
 import type { InValue } from '@libsql/client';
-import type { LogicalOperator } from '@mastra/core/vector/filter';
 import { MastraStorage } from '@mastra/core/storage';
 import { MastraVector } from '@mastra/core/vector';
 import type { MessageType } from '@mastra/core/memory';
-import type { NumericOperator } from '@mastra/core/vector/filter';
 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 { RegexOperator } from '@mastra/core/vector/filter';
 import type { StorageColumn } from '@mastra/core/storage';
 import type { StorageGetMessagesArg } from '@mastra/core/storage';
 import type { StorageThreadType } from '@mastra/core/memory';
 import type { TABLE_NAMES } from '@mastra/core/storage';
+import type { UpdateVectorParams } from '@mastra/core/vector';
 import type { UpsertVectorParams } from '@mastra/core/vector';
 import type { VectorFilter } from '@mastra/core/vector/filter';
 import type { WorkflowRun } from '@mastra/core/storage';
@@ -28,21 +24,11 @@ import type { WorkflowRuns } from '@mastra/core/storage';
 
 export declare function buildFilterQuery(filter: VectorFilter): FilterResult;
 
-export declare const FILTER_OPERATORS: Record<string, OperatorFn>;
-
-declare type FilterOperator = {
-    sql: string;
-    needsValue: boolean;
-    transformValue?: (value: any) => any;
-};
-
-export declare interface FilterResult {
+declare interface FilterResult {
     sql: string;
     values: InValue[];
 }
 
-export declare const handleKey: (key: string) => string;
-
 /**
  * Vector store specific prompt that details supported operators and examples.
  * This prompt helps users construct valid filters for LibSQL Vector.
@@ -74,8 +60,6 @@ export declare class LibSQLFilterTranslator extends BaseFilterTranslator {
     private translateNode;
 }
 
-declare type LibSQLQueryArgs = [...QueryVectorArgs, number?];
-
 declare interface LibSQLQueryParams extends QueryVectorParams {
     minScore?: number;
 }
@@ -167,30 +151,21 @@ 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(indexName: string): 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[]>;
-    describeIndex(indexName: string): Promise<IndexStats>;
     /**
-     * @deprecated Use {@link updateVector} instead. This method will be removed on May 20th, 2025.
+     * Retrieves statistics about a vector index.
      *
-     * 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.
+     * @param {string} indexName - The name of the index to describe
+     * @returns A promise that resolves to the index statistics including dimension, count and metric
      */
-    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.
+     *
      * @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.
@@ -199,35 +174,18 @@ 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(indexName: string, id: string, update: {
-        vector?: number[];
-        metadata?: Record<string, any>;
-    }): Promise<void>;
+    updateVector({ indexName, id, update }: 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>;
-    /**
-     * 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>;
+    deleteVector({ indexName, id }: DeleteVectorParams): Promise<void>;
+    truncateIndex({ indexName }: DeleteIndexParams): Promise<void>;
 }
 export { LibSQLVector }
 export { LibSQLVector as LibSQLVector_alias_1 }
 
-declare type OperatorFn = (key: string, value?: any) => FilterOperator;
-
-export declare type OperatorType = BasicOperator | NumericOperator | ArrayOperator | ElementOperator | LogicalOperator | '$contains' | Exclude<RegexOperator, '$options'>;
-
 export { }