@mastra/upstash 0.3.4 → 0.4.0-alpha.1

package/.turbo/turbo-build.log

@@ -1,23 +1,23 @@
 
-> @mastra/upstash@0.3.4-alpha.4 build /home/runner/work/mastra/mastra/stores/upstash
+> @mastra/upstash@0.4.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.4.0
 TSC Build start
-TSC ⚡️ Build success in 7912ms
+TSC ⚡️ Build success in 8537ms
 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 11998ms
+DTS ⚡️ Build success in 11892ms
 CLI Cleaning output folder
 ESM Build start
 CJS Build start
-ESM dist/index.js 31.64 KB
-ESM ⚡️ Build success in 947ms
-CJS dist/index.cjs 31.78 KB
-CJS ⚡️ Build success in 1204ms
+ESM dist/index.js 30.09 KB
+ESM ⚡️ Build success in 1126ms
+CJS dist/index.cjs 30.23 KB
+CJS ⚡️ Build success in 1126ms

package/CHANGELOG.md

@@ -1,5 +1,40 @@
 # @mastra/upstash
 
+## 0.4.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.3.5-alpha.0
+
+### Patch Changes
+
+- 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.3.4
 
 ### Patch Changes

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

@@ -1,17 +1,21 @@
 import { BaseFilterTranslator } from '@mastra/core/vector/filter';
 import type { CreateIndexParams } from '@mastra/core/vector';
+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 { 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 { QueryVectorParams } from '@mastra/core/vector';
 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';
@@ -145,33 +149,19 @@ declare class UpstashVector extends MastraVector {
         url: string;
         token: string;
     });
-    upsert(...args: ParamsToArgs<UpsertVectorParams>): Promise<string[]>;
+    upsert({ indexName, vectors, metadata, ids }: UpsertVectorParams): Promise<string[]>;
     transformFilter(filter?: VectorFilter): string | undefined;
-    createIndex(..._args: ParamsToArgs<CreateIndexParams>): Promise<void>;
-    query(...args: ParamsToArgs<QueryVectorParams>): Promise<QueryResult[]>;
+    createIndex(_params: CreateIndexParams): Promise<void>;
+    query({ indexName, queryVector, topK, filter, includeVector, }: QueryVectorParams): Promise<QueryResult[]>;
     listIndexes(): Promise<string[]>;
-    describeIndex(indexName: string): Promise<{
-        dimension: number;
-        count: number;
-        metric: "cosine" | "euclidean" | "dotproduct";
-    }>;
-    deleteIndex(indexName: string): Promise<void>;
     /**
-     * @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>;
+    deleteIndex({ indexName }: 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.
@@ -182,20 +172,7 @@ 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: 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>;
+    updateVector({ indexName, id, update }: UpdateVectorParams): Promise<void>;
     /**
      * Deletes a vector by its ID.
      * @param indexName - The name of the index containing the vector.
@@ -203,7 +180,7 @@ declare class UpstashVector extends MastraVector {
      * @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>;
+    deleteVector({ indexName, id }: DeleteVectorParams): Promise<void>;
 }
 export { UpstashVector }
 export { UpstashVector as UpstashVector_alias_1 }

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

@@ -1,17 +1,21 @@
 import { BaseFilterTranslator } from '@mastra/core/vector/filter';
 import type { CreateIndexParams } from '@mastra/core/vector';
+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 { 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 { QueryVectorParams } from '@mastra/core/vector';
 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';
@@ -145,33 +149,19 @@ declare class UpstashVector extends MastraVector {
         url: string;
         token: string;
     });
-    upsert(...args: ParamsToArgs<UpsertVectorParams>): Promise<string[]>;
+    upsert({ indexName, vectors, metadata, ids }: UpsertVectorParams): Promise<string[]>;
     transformFilter(filter?: VectorFilter): string | undefined;
-    createIndex(..._args: ParamsToArgs<CreateIndexParams>): Promise<void>;
-    query(...args: ParamsToArgs<QueryVectorParams>): Promise<QueryResult[]>;
+    createIndex(_params: CreateIndexParams): Promise<void>;
+    query({ indexName, queryVector, topK, filter, includeVector, }: QueryVectorParams): Promise<QueryResult[]>;
     listIndexes(): Promise<string[]>;
-    describeIndex(indexName: string): Promise<{
-        dimension: number;
-        count: number;
-        metric: "cosine" | "euclidean" | "dotproduct";
-    }>;
-    deleteIndex(indexName: string): Promise<void>;
     /**
-     * @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>;
+    deleteIndex({ indexName }: 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.
@@ -182,20 +172,7 @@ 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: 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>;
+    updateVector({ indexName, id, update }: UpdateVectorParams): Promise<void>;
     /**
      * Deletes a vector by its ID.
      * @param indexName - The name of the index containing the vector.
@@ -203,7 +180,7 @@ declare class UpstashVector extends MastraVector {
      * @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>;
+    deleteVector({ indexName, id }: DeleteVectorParams): Promise<void>;
 }
 export { UpstashVector }
 export { UpstashVector as UpstashVector_alias_1 }

package/dist/index.cjs

@@ -675,9 +675,7 @@ var UpstashVector = class extends vector.MastraVector {
       token
     });
   }
-  async upsert(...args) {
-    const params = this.normalizeArgs("upsert", args);
-    const { indexName, vectors, metadata, ids } = params;
+  async upsert({ indexName, vectors, metadata, ids }) {
     const generatedIds = ids || vectors.map(() => crypto.randomUUID());
     const points = vectors.map((vector, index) => ({
       id: generatedIds[index],
@@ -693,12 +691,16 @@ var UpstashVector = class extends vector.MastraVector {
     const translator = new UpstashFilterTranslator();
     return translator.translate(filter);
   }
-  async createIndex(..._args) {
+  async createIndex(_params) {
     console.log("No need to call createIndex for Upstash");
   }
-  async query(...args) {
-    const params = this.normalizeArgs("query", args);
-    const { indexName, queryVector, topK = 10, filter, includeVector = false } = params;
+  async query({
+    indexName,
+    queryVector,
+    topK = 10,
+    filter,
+    includeVector = false
+  }) {
     const ns = this.client.namespace(indexName);
     const filterString = this.transformFilter(filter);
     const results = await ns.query({
@@ -719,7 +721,13 @@ var UpstashVector = class extends vector.MastraVector {
     const indexes = await this.client.listNamespaces();
     return indexes.filter(Boolean);
   }
-  async describeIndex(indexName) {
+  /**
+   * Retrieves statistics about a vector index.
+   *
+   * @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({ indexName }) {
     const info = await this.client.info();
     return {
       dimension: info.dimension,
@@ -727,7 +735,7 @@ var UpstashVector = class extends vector.MastraVector {
       metric: info?.similarityFunction?.toLowerCase()
     };
   }
-  async deleteIndex(indexName) {
+  async deleteIndex({ indexName }) {
     try {
       await this.client.deleteNamespace(indexName);
     } catch (error) {
@@ -735,8 +743,6 @@ var UpstashVector = class extends vector.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.
@@ -746,25 +752,7 @@ var UpstashVector = 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 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) {
+  async updateVector({ indexName, id, update }) {
     try {
       if (!update.vector && !update.metadata) {
         throw new Error("No update data provided");
@@ -791,23 +779,6 @@ var UpstashVector = class extends vector.MastraVector {
       throw new Error(`Failed to update vector by id: ${id} for index name: ${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.
@@ -815,7 +786,7 @@ var UpstashVector = 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(indexName, id) {
+  async deleteVector({ indexName, id }) {
     try {
       await this.client.delete(id, {
         namespace: indexName

package/dist/index.js

@@ -673,9 +673,7 @@ var UpstashVector = class extends MastraVector {
       token
     });
   }
-  async upsert(...args) {
-    const params = this.normalizeArgs("upsert", args);
-    const { indexName, vectors, metadata, ids } = params;
+  async upsert({ indexName, vectors, metadata, ids }) {
     const generatedIds = ids || vectors.map(() => crypto.randomUUID());
     const points = vectors.map((vector, index) => ({
       id: generatedIds[index],
@@ -691,12 +689,16 @@ var UpstashVector = class extends MastraVector {
     const translator = new UpstashFilterTranslator();
     return translator.translate(filter);
   }
-  async createIndex(..._args) {
+  async createIndex(_params) {
     console.log("No need to call createIndex for Upstash");
   }
-  async query(...args) {
-    const params = this.normalizeArgs("query", args);
-    const { indexName, queryVector, topK = 10, filter, includeVector = false } = params;
+  async query({
+    indexName,
+    queryVector,
+    topK = 10,
+    filter,
+    includeVector = false
+  }) {
     const ns = this.client.namespace(indexName);
     const filterString = this.transformFilter(filter);
     const results = await ns.query({
@@ -717,7 +719,13 @@ var UpstashVector = class extends MastraVector {
     const indexes = await this.client.listNamespaces();
     return indexes.filter(Boolean);
   }
-  async describeIndex(indexName) {
+  /**
+   * Retrieves statistics about a vector index.
+   *
+   * @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({ indexName }) {
     const info = await this.client.info();
     return {
       dimension: info.dimension,
@@ -725,7 +733,7 @@ var UpstashVector = class extends MastraVector {
       metric: info?.similarityFunction?.toLowerCase()
     };
   }
-  async deleteIndex(indexName) {
+  async deleteIndex({ indexName }) {
     try {
       await this.client.deleteNamespace(indexName);
     } catch (error) {
@@ -733,8 +741,6 @@ var UpstashVector = class 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.
@@ -744,25 +750,7 @@ var UpstashVector = 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 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) {
+  async updateVector({ indexName, id, update }) {
     try {
       if (!update.vector && !update.metadata) {
         throw new Error("No update data provided");
@@ -789,23 +777,6 @@ var UpstashVector = class extends MastraVector {
       throw new Error(`Failed to update vector by id: ${id} for index name: ${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.
@@ -813,7 +784,7 @@ var UpstashVector = 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(indexName, id) {
+  async deleteVector({ indexName, id }) {
     try {
       await this.client.delete(id, {
         namespace: indexName

package/docker-compose.yaml

@@ -3,13 +3,13 @@ services:
   redis:
     image: redis:7-alpine
     ports:
-      - "6379:6379"
+      - '6379:6379'
     command: redis-server --requirepass redis_password
   serverless-redis-http:
     image: hiett/serverless-redis-http:latest
     ports:
-      - "8079:80"
+      - '8079:80'
     environment:
       SRH_MODE: env
       SRH_TOKEN: test_token
-      SRH_CONNECTION_STRING: "redis://:redis_password@redis:6379"
+      SRH_CONNECTION_STRING: 'redis://:redis_password@redis:6379'

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mastra/upstash",
-  "version": "0.3.4",
+  "version": "0.4.0-alpha.1",
   "description": "Upstash provider for Mastra - includes both vector and db storage capabilities",
   "type": "module",
   "main": "dist/index.js",
@@ -21,8 +21,7 @@
   "license": "MIT",
   "dependencies": {
     "@upstash/redis": "^1.34.5",
-    "@upstash/vector": "^1.2.1",
-    "@mastra/core": "^0.9.4"
+    "@upstash/vector": "^1.2.1"
   },
   "devDependencies": {
     "@microsoft/api-extractor": "^7.52.5",
@@ -32,7 +31,11 @@
     "tsup": "^8.4.0",
     "typescript": "^5.8.2",
     "vitest": "^3.1.2",
-    "@internal/lint": "0.0.5"
+    "@internal/lint": "0.0.5",
+    "@mastra/core": "0.10.0-alpha.1"
+  },
+  "peerDependencies": {
+    "@mastra/core": "^0.9.4"
   },
   "scripts": {
     "pretest": "docker compose up -d",

package/src/vector/index.test.ts

@@ -1,7 +1,7 @@
 import type { QueryResult } from '@mastra/core/vector';
 import dotenv from 'dotenv';
 
-import { describe, it, expect, beforeAll, afterAll, beforeEach, vi, afterEach } from 'vitest';
+import { describe, it, expect, beforeAll, afterAll, afterEach } from 'vitest';
 
 import { UpstashVector } from './';
 
@@ -13,7 +13,7 @@ function waitUntilVectorsIndexed(vector: UpstashVector, indexName: string, expec
     let attempts = 0;
     const interval = setInterval(async () => {
       try {
-        const stats = await vector.describeIndex(indexName);
+        const stats = await vector.describeIndex({ indexName });
         if (stats && stats.count >= expectedCount) {
           clearInterval(interval);
           resolve(true);
@@ -59,12 +59,12 @@ describe.skipIf(!process.env.UPSTASH_VECTOR_URL || !process.env.UPSTASH_VECTOR_T
 
     // Cleanup: delete test index
     try {
-      await vectorStore.deleteIndex(testIndexName);
+      await vectorStore.deleteIndex({ indexName: testIndexName });
     } catch (error) {
       console.warn('Failed to delete test index:', error);
     }
     try {
-      await vectorStore.deleteIndex(filterIndexName);
+      await vectorStore.deleteIndex({ indexName: filterIndexName });
     } catch (error) {
       console.warn('Failed to delete filter index:', error);
     }
@@ -122,7 +122,7 @@ describe.skipIf(!process.env.UPSTASH_VECTOR_URL || !process.env.UPSTASH_VECTOR_T
       const testIndexName = 'test-index';
 
       afterEach(async () => {
-        await vectorStore.deleteIndex(testIndexName);
+        await vectorStore.deleteIndex({ indexName: testIndexName });
       });
 
       it('should update the vector by id', async () => {
@@ -140,7 +140,7 @@ describe.skipIf(!process.env.UPSTASH_VECTOR_URL || !process.env.UPSTASH_VECTOR_T
           metadata: newMetaData,
         };
 
-        await vectorStore.updateVector(testIndexName, idToBeUpdated, update);
+        await vectorStore.updateVector({ indexName: testIndexName, id: idToBeUpdated, update });
 
         await waitUntilVectorsIndexed(vectorStore, testIndexName, 3);
 
@@ -167,7 +167,7 @@ describe.skipIf(!process.env.UPSTASH_VECTOR_URL || !process.env.UPSTASH_VECTOR_T
           metadata: newMetaData,
         };
 
-        await expect(vectorStore.updateVector(testIndexName, 'id', update)).rejects.toThrow(
+        await expect(vectorStore.updateVector({ indexName: testIndexName, id: 'id', update })).rejects.toThrow(
           'Both vector and metadata must be provided for an update',
         );
       });
@@ -183,7 +183,7 @@ describe.skipIf(!process.env.UPSTASH_VECTOR_URL || !process.env.UPSTASH_VECTOR_T
           vector: newVector,
         };
 
-        await vectorStore.updateVector(testIndexName, idToBeUpdated, update);
+        await vectorStore.updateVector({ indexName: testIndexName, id: idToBeUpdated, update });
 
         await waitUntilVectorsIndexed(vectorStore, testIndexName, 3);
 
@@ -198,7 +198,9 @@ describe.skipIf(!process.env.UPSTASH_VECTOR_URL || !process.env.UPSTASH_VECTOR_T
       }, 500000);
 
       it('should throw exception when no updates are given', async () => {
-        await expect(vectorStore.updateVector(testIndexName, 'id', {})).rejects.toThrow('No update data provided');
+        await expect(vectorStore.updateVector({ indexName: testIndexName, id: 'id', update: {} })).rejects.toThrow(
+          'No update data provided',
+        );
       });
     });
 
@@ -206,7 +208,7 @@ describe.skipIf(!process.env.UPSTASH_VECTOR_URL || !process.env.UPSTASH_VECTOR_T
       const testVectors = [createVector(0, 1.0), createVector(1, 1.0), createVector(2, 1.0)];
 
       afterEach(async () => {
-        await vectorStore.deleteIndex(testIndexName);
+        await vectorStore.deleteIndex({ indexName: testIndexName });
       });
 
       it('should delete the vector by id', async () => {
@@ -214,7 +216,7 @@ describe.skipIf(!process.env.UPSTASH_VECTOR_URL || !process.env.UPSTASH_VECTOR_T
         expect(ids).toHaveLength(3);
         const idToBeDeleted = ids[0];
 
-        await vectorStore.deleteVector(testIndexName, idToBeDeleted);
+        await vectorStore.deleteVector({ indexName: testIndexName, id: idToBeDeleted });
 
         const results: QueryResult[] = await vectorStore.query({
           indexName: testIndexName,
@@ -246,7 +248,7 @@ describe.skipIf(!process.env.UPSTASH_VECTOR_URL || !process.env.UPSTASH_VECTOR_T
     });
 
     it('should describe an index correctly', async () => {
-      const stats = await vectorStore.describeIndex('mastra_default');
+      const stats = await vectorStore.describeIndex({ indexName: 'mastra_default' });
       expect(stats).toEqual({
         dimension: 1536,
         metric: 'cosine',
@@ -262,7 +264,7 @@ describe.skipIf(!process.env.UPSTASH_VECTOR_URL || !process.env.UPSTASH_VECTOR_T
     });
 
     afterAll(async () => {
-      await vectorStore.deleteIndex(testIndexName);
+      await vectorStore.deleteIndex({ indexName: testIndexName });
     });
 
     it('should handle invalid dimension vectors', async () => {
@@ -1200,97 +1202,4 @@ describe.skipIf(!process.env.UPSTASH_VECTOR_URL || !process.env.UPSTASH_VECTOR_T
       });
     });
   });
-  describe('Deprecation Warnings', () => {
-    const indexName = 'testdeprecationwarnings';
-
-    const indexName2 = 'testdeprecationwarnings2';
-
-    let warnSpy;
-
-    afterAll(async () => {
-      await vectorStore.deleteIndex(indexName);
-      await vectorStore.deleteIndex(indexName2);
-    });
-
-    beforeEach(async () => {
-      warnSpy = vi.spyOn(vectorStore['logger'], 'warn');
-    });
-
-    afterEach(async () => {
-      warnSpy.mockRestore();
-      await vectorStore.deleteIndex(indexName2);
-    });
-
-    const createVector = (primaryDimension: number, value: number = 1.0): number[] => {
-      const vector = new Array(VECTOR_DIMENSION).fill(0);
-      vector[primaryDimension] = value;
-      // Normalize the vector for cosine similarity
-      const magnitude = Math.sqrt(vector.reduce((sum, val) => sum + val * val, 0));
-      return vector.map(val => val / magnitude);
-    };
-
-    it('should show deprecation warning when using individual args for upsert', async () => {
-      await vectorStore.upsert(indexName, [createVector(0, 2)], [{ 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 vectorStore.query(indexName, createVector(0, 2), 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 vectorStore.query({
-        indexName,
-        queryVector: createVector(0, 2),
-        topK: 5,
-      });
-
-      expect(warnSpy).not.toHaveBeenCalled();
-    });
-
-    it('should not show deprecation warning when using object param for createIndex', async () => {
-      await vectorStore.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 vectorStore.upsert({
-        indexName,
-        vectors: [createVector(0, 2)],
-        metadata: [{ test: 'data' }],
-      });
-
-      expect(warnSpy).not.toHaveBeenCalled();
-    });
-
-    it('should maintain backward compatibility with individual args', async () => {
-      // Query
-      const queryResults = await vectorStore.query(indexName, createVector(0, 2), 5);
-      expect(Array.isArray(queryResults)).toBe(true);
-
-      // CreateIndex
-      await expect(vectorStore.createIndex(indexName2, 3, 'cosine')).resolves.not.toThrow();
-
-      // Upsert
-      const upsertResults = await vectorStore.upsert({
-        indexName,
-        vectors: [createVector(0, 2)],
-        metadata: [{ test: 'data' }],
-      });
-      expect(Array.isArray(upsertResults)).toBe(true);
-      expect(upsertResults).toHaveLength(1);
-    });
-  });
 });

package/src/vector/index.ts

@@ -1,9 +1,13 @@
 import { MastraVector } from '@mastra/core/vector';
 import type {
   CreateIndexParams,
-  ParamsToArgs,
+  DeleteIndexParams,
+  DeleteVectorParams,
+  DescribeIndexParams,
+  IndexStats,
   QueryResult,
   QueryVectorParams,
+  UpdateVectorParams,
   UpsertVectorParams,
 } from '@mastra/core/vector';
 import type { VectorFilter } from '@mastra/core/vector/filter';
@@ -22,11 +26,7 @@ export class UpstashVector 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 generatedIds = ids || vectors.map(() => crypto.randomUUID());
 
     const points = vectors.map((vector, index) => ({
@@ -46,15 +46,17 @@ export class UpstashVector extends MastraVector {
     return translator.translate(filter);
   }
 
-  async createIndex(..._args: ParamsToArgs<CreateIndexParams>): Promise<void> {
+  async createIndex(_params: CreateIndexParams): Promise<void> {
     console.log('No need to call createIndex for Upstash');
   }
 
-  async query(...args: ParamsToArgs<QueryVectorParams>): Promise<QueryResult[]> {
-    const params = this.normalizeArgs<QueryVectorParams>('query', args);
-
-    const { indexName, queryVector, topK = 10, filter, includeVector = false } = params;
-
+  async query({
+    indexName,
+    queryVector,
+    topK = 10,
+    filter,
+    includeVector = false,
+  }: QueryVectorParams): Promise<QueryResult[]> {
     const ns = this.client.namespace(indexName);
 
     const filterString = this.transformFilter(filter);
@@ -80,7 +82,13 @@ export class UpstashVector extends MastraVector {
     return indexes.filter(Boolean);
   }
 
-  async describeIndex(indexName: string) {
+  /**
+   * Retrieves statistics about a vector index.
+   *
+   * @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({ indexName }: DescribeIndexParams): Promise<IndexStats> {
     const info = await this.client.info();
 
     return {
@@ -90,7 +98,7 @@ export class UpstashVector extends MastraVector {
     };
   }
 
-  async deleteIndex(indexName: string): Promise<void> {
+  async deleteIndex({ indexName }: DeleteIndexParams): Promise<void> {
     try {
       await this.client.deleteNamespace(indexName);
     } catch (error) {
@@ -98,31 +106,6 @@ export class UpstashVector 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.
    * @param indexName - The name of the index containing the vector.
@@ -133,14 +116,7 @@ export 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.
    */
-  async updateVector(
-    indexName: string,
-    id: string,
-    update: {
-      vector?: number[];
-      metadata?: Record<string, any>;
-    },
-  ): Promise<void> {
+  async updateVector({ indexName, id, update }: UpdateVectorParams): Promise<void> {
     try {
       if (!update.vector && !update.metadata) {
         throw new Error('No update data provided');
@@ -174,24 +150,6 @@ export class UpstashVector 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.
@@ -199,7 +157,7 @@ export class UpstashVector extends MastraVector {
    * @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> {
+  async deleteVector({ indexName, id }: DeleteVectorParams): Promise<void> {
     try {
       await this.client.delete(id, {
         namespace: indexName,