@mastra/libsql 0.0.0-separate-trace-data-from-component-20250501141108 → 0.0.0-vector-query-sources-20250516172905

package/CHANGELOG.md

@@ -1,13 +1,183 @@
 # @mastra/libsql
 
-## 0.0.0-separate-trace-data-from-component-20250501141108
+## 0.0.0-vector-query-sources-20250516172905
 
 ### 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 [d0ee3c6]
+- Updated dependencies [23f258c]
+- Updated dependencies [2672a05]
+  - @mastra/core@0.0.0-vector-query-sources-20250516172905
+
+## 0.0.4
+
+### Patch Changes
+
+- c3bd795: [MASTRA-3358] Deprecate updateIndexById and deleteIndexById
+- Updated dependencies [396be50]
+- Updated dependencies [ab80e7e]
+- Updated dependencies [c3bd795]
+- Updated dependencies [da082f8]
+- Updated dependencies [a5810ce]
+- Updated dependencies [3e9c131]
+- Updated dependencies [3171b5b]
+- Updated dependencies [973e5ac]
+- Updated dependencies [daf942f]
+- Updated dependencies [0b8b868]
+- Updated dependencies [9e1eff5]
+- Updated dependencies [6fa1ad1]
+- Updated dependencies [c28d7a0]
+- Updated dependencies [edf1e88]
+  - @mastra/core@0.9.4
+
+## 0.0.4-alpha.4
+
+### Patch Changes
+
+- Updated dependencies [3e9c131]
+  - @mastra/core@0.9.4-alpha.4
+
+## 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
+
+- Updated dependencies [3171b5b]
+- Updated dependencies [973e5ac]
+- Updated dependencies [9e1eff5]
+  - @mastra/core@0.9.4-alpha.2
+
+## 0.0.4-alpha.1
+
+### Patch Changes
+
+- Updated dependencies [ab80e7e]
+- Updated dependencies [6fa1ad1]
+- Updated dependencies [c28d7a0]
+- Updated dependencies [edf1e88]
+  - @mastra/core@0.9.4-alpha.1
+
+## 0.0.4-alpha.0
+
+### Patch Changes
+
+- Updated dependencies [daf942f]
+- Updated dependencies [0b8b868]
+  - @mastra/core@0.9.4-alpha.0
+
+## 0.0.3
+
+### Patch Changes
+
+- Updated dependencies [e450778]
+- Updated dependencies [8902157]
+- Updated dependencies [ca0dc88]
+- Updated dependencies [526c570]
+- Updated dependencies [d7a6a33]
+- Updated dependencies [9cd1a46]
+- Updated dependencies [b5d2de0]
+- Updated dependencies [644f8ad]
+- Updated dependencies [70dbf51]
+  - @mastra/core@0.9.3
+
+## 0.0.3-alpha.1
+
+### Patch Changes
+
+- Updated dependencies [e450778]
+- Updated dependencies [8902157]
+- Updated dependencies [ca0dc88]
+- Updated dependencies [9cd1a46]
+- Updated dependencies [70dbf51]
+  - @mastra/core@0.9.3-alpha.1
+
+## 0.0.3-alpha.0
+
+### Patch Changes
+
+- Updated dependencies [526c570]
+- Updated dependencies [b5d2de0]
+- Updated dependencies [644f8ad]
+  - @mastra/core@0.9.3-alpha.0
+
+## 0.0.2
+
+### Patch Changes
+
+- 4155f47: Add parameters to filter workflow runs
+  Add fromDate and toDate to telemetry parameters
+- Updated dependencies [6052aa6]
+- Updated dependencies [967b41c]
+- Updated dependencies [3d2fb5c]
 - Updated dependencies [26738f4]
+- Updated dependencies [4155f47]
+- Updated dependencies [7eeb2bc]
 - Updated dependencies [b804723]
+- Updated dependencies [8607972]
+- Updated dependencies [ccef9f9]
 - Updated dependencies [0097d50]
-  - @mastra/core@0.0.0-separate-trace-data-from-component-20250501141108
+- Updated dependencies [7eeb2bc]
+- Updated dependencies [17826a9]
+- Updated dependencies [7d8b7c7]
+- Updated dependencies [fba031f]
+- Updated dependencies [3a5f1e1]
+- Updated dependencies [51e6923]
+- Updated dependencies [8398d89]
+  - @mastra/core@0.9.2
+
+## 0.0.2-alpha.6
+
+### Patch Changes
+
+- Updated dependencies [6052aa6]
+- Updated dependencies [7d8b7c7]
+- Updated dependencies [3a5f1e1]
+- Updated dependencies [8398d89]
+  - @mastra/core@0.9.2-alpha.6
+
+## 0.0.2-alpha.5
+
+### Patch Changes
+
+- Updated dependencies [3d2fb5c]
+- Updated dependencies [7eeb2bc]
+- Updated dependencies [8607972]
+- Updated dependencies [7eeb2bc]
+- Updated dependencies [fba031f]
+  - @mastra/core@0.9.2-alpha.5
+
+## 0.0.2-alpha.4
+
+### Patch Changes
+
+- Updated dependencies [ccef9f9]
+- Updated dependencies [51e6923]
+  - @mastra/core@0.9.2-alpha.4
+
+## 0.0.2-alpha.3
+
+### Patch Changes
+
+- 4155f47: Add parameters to filter workflow runs
+  Add fromDate and toDate to telemetry parameters
+- Updated dependencies [967b41c]
+- Updated dependencies [4155f47]
+- Updated dependencies [17826a9]
+  - @mastra/core@0.9.2-alpha.3
 
 ## 0.0.2-alpha.2
 

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

@@ -1,26 +1,24 @@
-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 +26,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.
@@ -128,13 +116,15 @@ declare class LibSQLStore extends MastraStorage {
     }): Promise<MessageType[]>;
     private transformEvalRow;
     getEvalsByAgentName(agentName: string, type?: 'test' | 'live'): Promise<EvalRow[]>;
-    getTraces({ name, scope, page, perPage, attributes, filters, }?: {
+    getTraces({ name, scope, page, perPage, attributes, filters, fromDate, toDate, }?: {
         name?: string;
         scope?: string;
         page: number;
         perPage: number;
         attributes?: Record<string, string>;
         filters?: Record<string, any>;
+        fromDate?: Date;
+        toDate?: Date;
     }): Promise<any[]>;
     getWorkflowRuns({ workflowName, fromDate, toDate, limit, offset, resourceId, }?: {
         workflowName?: string;
@@ -168,14 +158,22 @@ declare class LibSQLVector extends MastraVector {
     query(...args: ParamsToArgs<LibSQLQueryParams> | LibSQLQueryArgs): Promise<QueryResult[]>;
     upsert(...args: ParamsToArgs<UpsertVectorParams>): Promise<string[]>;
     createIndex(...args: ParamsToArgs<CreateIndexParams>): Promise<void>;
-    deleteIndex(indexName: string): Promise<void>;
+    deleteIndex(...args: ParamsToArgs<DeleteIndexParams>): Promise<void>;
     listIndexes(): Promise<string[]>;
-    describeIndex(indexName: string): Promise<IndexStats>;
     /**
-     * Updates an index entry by its ID with the provided vector and/or metadata.
+     * Retrieves statistics about a vector index.
      *
-     * @param indexName - The name of the index to update.
-     * @param id - The ID of the index entry to update.
+     * @param params - The parameters for describing an index
+     * @param params.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.
@@ -186,14 +184,39 @@ 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(...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>;
-    truncateIndex(indexName: 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(...args: ParamsToArgs<DeleteVectorParams>): Promise<void>;
+    truncateIndex(...args: ParamsToArgs<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,24 @@
-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 +26,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.
@@ -128,13 +116,15 @@ declare class LibSQLStore extends MastraStorage {
     }): Promise<MessageType[]>;
     private transformEvalRow;
     getEvalsByAgentName(agentName: string, type?: 'test' | 'live'): Promise<EvalRow[]>;
-    getTraces({ name, scope, page, perPage, attributes, filters, }?: {
+    getTraces({ name, scope, page, perPage, attributes, filters, fromDate, toDate, }?: {
         name?: string;
         scope?: string;
         page: number;
         perPage: number;
         attributes?: Record<string, string>;
         filters?: Record<string, any>;
+        fromDate?: Date;
+        toDate?: Date;
     }): Promise<any[]>;
     getWorkflowRuns({ workflowName, fromDate, toDate, limit, offset, resourceId, }?: {
         workflowName?: string;
@@ -168,14 +158,22 @@ declare class LibSQLVector extends MastraVector {
     query(...args: ParamsToArgs<LibSQLQueryParams> | LibSQLQueryArgs): Promise<QueryResult[]>;
     upsert(...args: ParamsToArgs<UpsertVectorParams>): Promise<string[]>;
     createIndex(...args: ParamsToArgs<CreateIndexParams>): Promise<void>;
-    deleteIndex(indexName: string): Promise<void>;
+    deleteIndex(...args: ParamsToArgs<DeleteIndexParams>): Promise<void>;
     listIndexes(): Promise<string[]>;
-    describeIndex(indexName: string): Promise<IndexStats>;
     /**
-     * Updates an index entry by its ID with the provided vector and/or metadata.
+     * Retrieves statistics about a vector index.
      *
-     * @param indexName - The name of the index to update.
-     * @param id - The ID of the index entry to update.
+     * @param params - The parameters for describing an index
+     * @param params.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.
@@ -186,14 +184,39 @@ 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(...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>;
-    truncateIndex(indexName: 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(...args: ParamsToArgs<DeleteVectorParams>): Promise<void>;
+    truncateIndex(...args: ParamsToArgs<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 { }