@mastra/upstash 0.10.3 → 0.11.0-alpha.1

package/.turbo/turbo-build.log

@@ -1,39 +1,39 @@
 
-> @mastra/upstash@0.10.3-alpha.4 build /home/runner/work/mastra/mastra/stores/upstash
+> @mastra/upstash@0.11.0-alpha.1 build /home/runner/work/mastra/mastra/stores/upstash
 > 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.5.0
 TSC Build start
-TSC ⚡️ Build success in 8571ms
+TSC ⚡️ Build success in 10304ms
 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/upstash/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/upstash/dist/_tsup-dts-rollup.d.cts
-DTS ⚡️ Build success in 10508ms
+DTS ⚡️ Build success in 12195ms
 CLI Cleaning output folder
 ESM Build start
 CJS Build start
-dist/index.cjs (1651:18): Use of eval in "dist/index.cjs" is strongly discouraged as it poses security risks and may cause issues with minification.
-dist/index.js (1651:18): Use of eval in "dist/index.js" is strongly discouraged as it poses security risks and may cause issues with minification.
+dist/index.cjs (1729:18): Use of eval in "dist/index.cjs" is strongly discouraged as it poses security risks and may cause issues with minification.
+dist/index.js (1729:18): Use of eval in "dist/index.js" is strongly discouraged as it poses security risks and may cause issues with minification.
 CJS dist/getMachineId-darwin-3PL23DL6.cjs      1.19 KB
 CJS dist/getMachineId-linux-KYLPK3HC.cjs       813.00 B
+CJS dist/getMachineId-bsd-HDZ73WR7.cjs         1015.00 B
 CJS dist/getMachineId-win-ZTI2LRDJ.cjs         1.66 KB
 CJS dist/chunk-N2CPQVE3.cjs                    1.09 KB
 CJS dist/getMachineId-unsupported-DEDJN4ZS.cjs 777.00 B
-CJS dist/getMachineId-bsd-HDZ73WR7.cjs         1015.00 B
 CJS dist/chunk-U74OJRHU.cjs                    62.08 KB
-CJS dist/index.cjs                             1.65 MB
-CJS ⚡️ Build success in 17305ms
-ESM dist/getMachineId-darwin-UTKBTJ2U.js      1.08 KB
+CJS dist/index.cjs                             1.67 MB
+CJS ⚡️ Build success in 22539ms
 ESM dist/getMachineId-linux-K3QXQYAB.js       740.00 B
+ESM dist/getMachineId-darwin-UTKBTJ2U.js      1.08 KB
+ESM dist/getMachineId-win-L2EYIM5A.js         1.04 KB
 ESM dist/getMachineId-bsd-KKIDU47O.js         896.00 B
 ESM dist/chunk-IGKEDEDE.js                    452.00 B
-ESM dist/getMachineId-win-L2EYIM5A.js         1.04 KB
 ESM dist/chunk-HSTZWXH7.js                    61.52 KB
 ESM dist/getMachineId-unsupported-VPWBQCK7.js 700.00 B
-ESM dist/index.js                             1.64 MB
-ESM ⚡️ Build success in 17306ms
+ESM dist/index.js                             1.67 MB
+ESM ⚡️ Build success in 22541ms

package/CHANGELOG.md

@@ -1,5 +1,29 @@
 # @mastra/upstash
 
+## 0.11.0-alpha.1
+
+### Patch Changes
+
+- 2fda031: Clarify upstash argument concepts.
+- Updated dependencies [ee9af57]
+- Updated dependencies [751c894]
+- Updated dependencies [577ce3a]
+- Updated dependencies [9260b3a]
+  - @mastra/core@0.10.6-alpha.1
+
+## 0.11.0-alpha.0
+
+### Minor Changes
+
+- 704d1ca: Thread Timestamp Auto-Update Enhancement
+  Added automatic thread updatedAt timestamp updates when messages are saved across all storage providers
+  Enhanced user experience: Threads now accurately reflect their latest activity with automatic timestamp updates when new messages are added
+  Universal implementation: Consistent behavior across all 7 storage backends (ClickHouse, Cloudflare D1, DynamoDB, MongoDB, PostgreSQL, Upstash, LibSQL)
+  Performance optimized: Updates execute in parallel with message saving operations for minimal performance impact
+  Backwards compatible: No breaking changes - existing code continues to work unchanged
+  Improved conversation ordering: Chat interfaces can now properly sort threads by actual last activity
+  This enhancement resolves the issue where active conversations appeared stale due to outdated thread timestamps, providing better conversation management and user experience in chat applications.
+
 ## 0.10.3
 
 ### Patch Changes

package/README.md

@@ -13,6 +13,7 @@ npm install @mastra/upstash
 ```typescript
 import { UpstashVector } from '@mastra/upstash';
 
+// In upstash they refer to the store as an index
 const vectorStore = new UpstashVector({
   url: process.env.UPSTASH_VECTOR_REST_URL,
   token: process.env.UPSTASH_VECTOR_TOKEN
@@ -27,6 +28,9 @@ const ids = await vectorStore.upsert({
   metadata
 });
 
+// There is no store.createIndex call here, Upstash creates indexes (known as namespaces in Upstash) automatically
+// when you upsert if that namespace does not exist yet.
+
 // Query vectors
 const results = await vectorStore.query({
   indexName: 'my-namespace',

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

@@ -217,26 +217,61 @@ export { UpstashStore as UpstashStore_alias_1 }
 
 declare class UpstashVector extends MastraVector {
     private client;
+    /**
+     * Creates a new UpstashVector instance.
+     * @param {object} params - The parameters for the UpstashVector.
+     * @param {string} params.url - The URL of the Upstash vector index.
+     * @param {string} params.token - The token for the Upstash vector index.
+     */
     constructor({ url, token }: {
         url: string;
         token: string;
     });
-    upsert({ indexName, vectors, metadata, ids }: UpsertVectorParams): Promise<string[]>;
+    /**
+     * Upserts vectors into the index.
+     * @param {UpsertVectorParams} params - The parameters for the upsert operation.
+     * @returns {Promise<string[]>} A promise that resolves to the IDs of the upserted vectors.
+     */
+    upsert({ indexName: namespace, vectors, metadata, ids }: UpsertVectorParams): Promise<string[]>;
+    /**
+     * Transforms a Mastra vector filter into an Upstash-compatible filter string.
+     * @param {VectorFilter} [filter] - The filter to transform.
+     * @returns {string | undefined} The transformed filter string, or undefined if no filter is provided.
+     */
     transformFilter(filter?: VectorFilter): string | undefined;
+    /**
+     * Creates a new index. For Upstash, this is a no-op as indexes (known as namespaces in Upstash) are created on-the-fly.
+     * @param {CreateIndexParams} _params - The parameters for creating the index (ignored).
+     * @returns {Promise<void>} A promise that resolves when the operation is complete.
+     */
     createIndex(_params: CreateIndexParams): Promise<void>;
-    query({ indexName, queryVector, topK, filter, includeVector, }: QueryVectorParams): Promise<QueryResult[]>;
+    /**
+     * Queries the vector index.
+     * @param {QueryVectorParams} params - The parameters for the query operation. indexName is the namespace in Upstash.
+     * @returns {Promise<QueryResult[]>} A promise that resolves to the query results.
+     */
+    query({ indexName: namespace, queryVector, topK, filter, includeVector, }: QueryVectorParams): Promise<QueryResult[]>;
+    /**
+     * Lists all namespaces in the Upstash vector index, which correspond to indexes.
+     * @returns {Promise<string[]>} A promise that resolves to a list of index names.
+     */
     listIndexes(): Promise<string[]>;
     /**
      * Retrieves statistics about a vector index.
      *
-     * @param {string} indexName - The name of the index to describe
+     * @param {string} indexName - The name of the namespace to describe
      * @returns A promise that resolves to the index statistics including dimension, count and metric
      */
-    describeIndex({ indexName }: DescribeIndexParams): Promise<IndexStats>;
-    deleteIndex({ indexName }: DeleteIndexParams): Promise<void>;
+    describeIndex({ indexName: namespace }: DescribeIndexParams): Promise<IndexStats>;
+    /**
+     * Deletes an index (namespace).
+     * @param {DeleteIndexParams} params - The parameters for the delete operation.
+     * @returns {Promise<void>} A promise that resolves when the deletion is complete.
+     */
+    deleteIndex({ indexName: namespace }: DeleteIndexParams): 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 indexName - The name of the namespace 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.
@@ -244,15 +279,15 @@ declare class UpstashVector 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, id, update }: UpdateVectorParams): Promise<void>;
+    updateVector({ indexName: namespace, id, update }: UpdateVectorParams): Promise<void>;
     /**
      * Deletes a vector by its ID.
-     * @param indexName - The name of the index containing the vector.
+     * @param indexName - The name of the namespace 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, id }: DeleteVectorParams): Promise<void>;
+    deleteVector({ indexName: namespace, id }: DeleteVectorParams): Promise<void>;
 }
 export { UpstashVector }
 export { UpstashVector as UpstashVector_alias_1 }

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

@@ -217,26 +217,61 @@ export { UpstashStore as UpstashStore_alias_1 }
 
 declare class UpstashVector extends MastraVector {
     private client;
+    /**
+     * Creates a new UpstashVector instance.
+     * @param {object} params - The parameters for the UpstashVector.
+     * @param {string} params.url - The URL of the Upstash vector index.
+     * @param {string} params.token - The token for the Upstash vector index.
+     */
     constructor({ url, token }: {
         url: string;
         token: string;
     });
-    upsert({ indexName, vectors, metadata, ids }: UpsertVectorParams): Promise<string[]>;
+    /**
+     * Upserts vectors into the index.
+     * @param {UpsertVectorParams} params - The parameters for the upsert operation.
+     * @returns {Promise<string[]>} A promise that resolves to the IDs of the upserted vectors.
+     */
+    upsert({ indexName: namespace, vectors, metadata, ids }: UpsertVectorParams): Promise<string[]>;
+    /**
+     * Transforms a Mastra vector filter into an Upstash-compatible filter string.
+     * @param {VectorFilter} [filter] - The filter to transform.
+     * @returns {string | undefined} The transformed filter string, or undefined if no filter is provided.
+     */
     transformFilter(filter?: VectorFilter): string | undefined;
+    /**
+     * Creates a new index. For Upstash, this is a no-op as indexes (known as namespaces in Upstash) are created on-the-fly.
+     * @param {CreateIndexParams} _params - The parameters for creating the index (ignored).
+     * @returns {Promise<void>} A promise that resolves when the operation is complete.
+     */
     createIndex(_params: CreateIndexParams): Promise<void>;
-    query({ indexName, queryVector, topK, filter, includeVector, }: QueryVectorParams): Promise<QueryResult[]>;
+    /**
+     * Queries the vector index.
+     * @param {QueryVectorParams} params - The parameters for the query operation. indexName is the namespace in Upstash.
+     * @returns {Promise<QueryResult[]>} A promise that resolves to the query results.
+     */
+    query({ indexName: namespace, queryVector, topK, filter, includeVector, }: QueryVectorParams): Promise<QueryResult[]>;
+    /**
+     * Lists all namespaces in the Upstash vector index, which correspond to indexes.
+     * @returns {Promise<string[]>} A promise that resolves to a list of index names.
+     */
     listIndexes(): Promise<string[]>;
     /**
      * Retrieves statistics about a vector index.
      *
-     * @param {string} indexName - The name of the index to describe
+     * @param {string} indexName - The name of the namespace to describe
      * @returns A promise that resolves to the index statistics including dimension, count and metric
      */
-    describeIndex({ indexName }: DescribeIndexParams): Promise<IndexStats>;
-    deleteIndex({ indexName }: DeleteIndexParams): Promise<void>;
+    describeIndex({ indexName: namespace }: DescribeIndexParams): Promise<IndexStats>;
+    /**
+     * Deletes an index (namespace).
+     * @param {DeleteIndexParams} params - The parameters for the delete operation.
+     * @returns {Promise<void>} A promise that resolves when the deletion is complete.
+     */
+    deleteIndex({ indexName: namespace }: DeleteIndexParams): 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 indexName - The name of the namespace 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.
@@ -244,15 +279,15 @@ declare class UpstashVector 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, id, update }: UpdateVectorParams): Promise<void>;
+    updateVector({ indexName: namespace, id, update }: UpdateVectorParams): Promise<void>;
     /**
      * Deletes a vector by its ID.
-     * @param indexName - The name of the index containing the vector.
+     * @param indexName - The name of the namespace 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, id }: DeleteVectorParams): Promise<void>;
+    deleteVector({ indexName: namespace, id }: DeleteVectorParams): Promise<void>;
 }
 export { UpstashVector }
 export { UpstashVector as UpstashVector_alias_1 }