@mastra/qdrant 0.2.14 → 0.2.15-alpha.0

package/.turbo/turbo-build.log

@@ -1,23 +1,23 @@
 
-> @mastra/qdrant@0.2.14-alpha.4 build /home/runner/work/mastra/mastra/stores/qdrant
+> @mastra/qdrant@0.2.15-alpha.0 build /home/runner/work/mastra/mastra/stores/qdrant
 > 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 6845ms
+TSC ⚡️ Build success in 9736ms
 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/qdrant/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/qdrant/dist/_tsup-dts-rollup.d.cts
-DTS ⚡️ Build success in 8721ms
+DTS ⚡️ Build success in 10156ms
 CLI Cleaning output folder
 ESM Build start
 CJS Build start
-ESM dist/index.js 19.69 KB
-ESM ⚡️ Build success in 839ms
-CJS dist/index.cjs 19.75 KB
-CJS ⚡️ Build success in 842ms
+ESM dist/index.js 20.98 KB
+ESM ⚡️ Build success in 858ms
+CJS dist/index.cjs 21.04 KB
+CJS ⚡️ Build success in 858ms

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 # @mastra/qdrant
 
+## 0.2.15-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.2.14
 
 ### Patch Changes

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

@@ -1,5 +1,8 @@
 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 { IndexStats } from '@mastra/core/vector';
 import type { LogicalOperator } from '@mastra/core/vector/filter';
 import { MastraVector } from '@mastra/core/vector';
@@ -7,6 +10,7 @@ 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 { UpdateVectorParams } from '@mastra/core/vector';
 import type { UpsertVectorParams } from '@mastra/core/vector';
 import type { VectorFilter } from '@mastra/core/vector/filter';
 
@@ -55,14 +59,34 @@ export declare class QdrantFilterTranslator extends BaseFilterTranslator {
 
 declare class QdrantVector extends MastraVector {
     private client;
+    /**
+     * @deprecated Passing url, apiKey, https as positional arguments is deprecated.
+     * Use the object parameter instead. This signature will be removed on May 20th, 2025.
+     */
     constructor(url: string, apiKey?: string, https?: boolean);
+    /**
+     * Creates a new QdrantVector client.
+     * @param params - An object with url, optional apiKey, and optional https.
+     */
+    constructor(params: {
+        url: string;
+        apiKey?: string;
+        https?: boolean;
+    });
     upsert(...args: ParamsToArgs<UpsertVectorParams>): Promise<string[]>;
     createIndex(...args: ParamsToArgs<CreateIndexParams>): Promise<void>;
     transformFilter(filter?: VectorFilter): VectorFilter;
     query(...args: ParamsToArgs<QueryVectorParams>): Promise<QueryResult[]>;
     listIndexes(): Promise<string[]>;
-    describeIndex(indexName: string): Promise<IndexStats>;
-    deleteIndex(indexName: string): Promise<void>;
+    /**
+     * Retrieves statistics about a vector index.
+     *
+     * @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>;
+    deleteIndex(...args: ParamsToArgs<DeleteIndexParams>): Promise<void>;
     /**
      * @deprecated Use {@link updateVector} instead. This method will be removed on May 20th, 2025.
      *
@@ -89,10 +113,7 @@ declare class QdrantVector 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(...args: ParamsToArgs<UpdateVectorParams>): Promise<void>;
     /**
      * @deprecated Use {@link deleteVector} instead. This method will be removed on May 20th, 2025.
      *
@@ -110,7 +131,7 @@ declare class QdrantVector 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(...args: ParamsToArgs<DeleteVectorParams>): Promise<void>;
     /**
      * Parses and converts a string ID to the appropriate type (string or number) for Qdrant point operations.
      *

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

@@ -1,5 +1,8 @@
 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 { IndexStats } from '@mastra/core/vector';
 import type { LogicalOperator } from '@mastra/core/vector/filter';
 import { MastraVector } from '@mastra/core/vector';
@@ -7,6 +10,7 @@ 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 { UpdateVectorParams } from '@mastra/core/vector';
 import type { UpsertVectorParams } from '@mastra/core/vector';
 import type { VectorFilter } from '@mastra/core/vector/filter';
 
@@ -55,14 +59,34 @@ export declare class QdrantFilterTranslator extends BaseFilterTranslator {
 
 declare class QdrantVector extends MastraVector {
     private client;
+    /**
+     * @deprecated Passing url, apiKey, https as positional arguments is deprecated.
+     * Use the object parameter instead. This signature will be removed on May 20th, 2025.
+     */
     constructor(url: string, apiKey?: string, https?: boolean);
+    /**
+     * Creates a new QdrantVector client.
+     * @param params - An object with url, optional apiKey, and optional https.
+     */
+    constructor(params: {
+        url: string;
+        apiKey?: string;
+        https?: boolean;
+    });
     upsert(...args: ParamsToArgs<UpsertVectorParams>): Promise<string[]>;
     createIndex(...args: ParamsToArgs<CreateIndexParams>): Promise<void>;
     transformFilter(filter?: VectorFilter): VectorFilter;
     query(...args: ParamsToArgs<QueryVectorParams>): Promise<QueryResult[]>;
     listIndexes(): Promise<string[]>;
-    describeIndex(indexName: string): Promise<IndexStats>;
-    deleteIndex(indexName: string): Promise<void>;
+    /**
+     * Retrieves statistics about a vector index.
+     *
+     * @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>;
+    deleteIndex(...args: ParamsToArgs<DeleteIndexParams>): Promise<void>;
     /**
      * @deprecated Use {@link updateVector} instead. This method will be removed on May 20th, 2025.
      *
@@ -89,10 +113,7 @@ declare class QdrantVector 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(...args: ParamsToArgs<UpdateVectorParams>): Promise<void>;
     /**
      * @deprecated Use {@link deleteVector} instead. This method will be removed on May 20th, 2025.
      *
@@ -110,7 +131,7 @@ declare class QdrantVector 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(...args: ParamsToArgs<DeleteVectorParams>): Promise<void>;
     /**
      * Parses and converts a string ID to the appropriate type (string or number) for Qdrant point operations.
      *

package/dist/index.cjs

@@ -239,12 +239,32 @@ var DISTANCE_MAPPING = {
 };
 var QdrantVector = class extends vector.MastraVector {
   client;
-  constructor(url, apiKey, https) {
+  constructor(paramsOrUrl, apiKey, https) {
     super();
+    let url;
+    let key;
+    let secure;
+    if (typeof paramsOrUrl === "string") {
+      if (typeof console !== "undefined" && console.warn) {
+        console.warn(
+          `Deprecation Warning: Passing url, apiKey, https as positional arguments to QdrantVector constructor is deprecated.
+Please use an object parameter instead:
+  new QdrantVector({ url, apiKey, https })
+This signature will be removed on May 20th, 2025.`
+        );
+      }
+      url = paramsOrUrl;
+      key = apiKey;
+      secure = https;
+    } else {
+      url = paramsOrUrl.url;
+      key = paramsOrUrl.apiKey;
+      secure = paramsOrUrl.https;
+    }
     const baseClient = new jsClientRest.QdrantClient({
       url,
-      apiKey,
-      https
+      apiKey: key,
+      https: secure
     });
     const telemetry = this.__getTelemetry();
     this.client = telemetry?.traceClass(baseClient, {
@@ -333,7 +353,16 @@ var QdrantVector = class extends vector.MastraVector {
     const response = await this.client.getCollections();
     return response.collections.map((collection) => collection.name) || [];
   }
-  async describeIndex(indexName) {
+  /**
+   * Retrieves statistics about a vector index.
+   *
+   * @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
+   */
+  async describeIndex(...args) {
+    const params = this.normalizeArgs("describeIndex", args);
+    const { indexName } = params;
     const { config, points_count } = await this.client.getCollection(indexName);
     const distance = config.params.vectors?.distance;
     return {
@@ -343,7 +372,9 @@ var QdrantVector = class extends vector.MastraVector {
       metric: Object.keys(DISTANCE_MAPPING).find((key) => DISTANCE_MAPPING[key] === distance)
     };
   }
-  async deleteIndex(indexName) {
+  async deleteIndex(...args) {
+    const params = this.normalizeArgs("deleteIndex", args);
+    const { indexName } = params;
     await this.client.deleteCollection(indexName);
   }
   /**
@@ -364,7 +395,7 @@ var QdrantVector = class extends vector.MastraVector {
       Please use updateVector() instead. 
       updateIndexById() will be removed on May 20th, 2025.`
     );
-    await this.updateVector(indexName, id, update);
+    await this.updateVector({ indexName, id, update });
   }
   /**
    * Updates a vector by its ID with the provided vector and/or metadata.
@@ -376,7 +407,9 @@ var QdrantVector = 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(indexName, id, update) {
+  async updateVector(...args) {
+    const params = this.normalizeArgs("updateVector", args);
+    const { indexName, id, update } = params;
     if (!update.vector && !update.metadata) {
       throw new Error("No updates provided");
     }
@@ -428,7 +461,7 @@ var QdrantVector = class extends vector.MastraVector {
       Please use deleteVector() instead. 
       deleteIndexById() will be removed on May 20th, 2025.`
     );
-    await this.deleteVector(indexName, id);
+    await this.deleteVector({ indexName, id });
   }
   /**
    * Deletes a vector by its ID.
@@ -437,7 +470,9 @@ var QdrantVector = 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(...args) {
+    const params = this.normalizeArgs("deleteVector", args);
+    const { indexName, id } = params;
     try {
       const pointId = this.parsePointId(id);
       await this.client.delete(indexName, {

package/dist/index.js

@@ -237,12 +237,32 @@ var DISTANCE_MAPPING = {
 };
 var QdrantVector = class extends MastraVector {
   client;
-  constructor(url, apiKey, https) {
+  constructor(paramsOrUrl, apiKey, https) {
     super();
+    let url;
+    let key;
+    let secure;
+    if (typeof paramsOrUrl === "string") {
+      if (typeof console !== "undefined" && console.warn) {
+        console.warn(
+          `Deprecation Warning: Passing url, apiKey, https as positional arguments to QdrantVector constructor is deprecated.
+Please use an object parameter instead:
+  new QdrantVector({ url, apiKey, https })
+This signature will be removed on May 20th, 2025.`
+        );
+      }
+      url = paramsOrUrl;
+      key = apiKey;
+      secure = https;
+    } else {
+      url = paramsOrUrl.url;
+      key = paramsOrUrl.apiKey;
+      secure = paramsOrUrl.https;
+    }
     const baseClient = new QdrantClient({
       url,
-      apiKey,
-      https
+      apiKey: key,
+      https: secure
     });
     const telemetry = this.__getTelemetry();
     this.client = telemetry?.traceClass(baseClient, {
@@ -331,7 +351,16 @@ var QdrantVector = class extends MastraVector {
     const response = await this.client.getCollections();
     return response.collections.map((collection) => collection.name) || [];
   }
-  async describeIndex(indexName) {
+  /**
+   * Retrieves statistics about a vector index.
+   *
+   * @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
+   */
+  async describeIndex(...args) {
+    const params = this.normalizeArgs("describeIndex", args);
+    const { indexName } = params;
     const { config, points_count } = await this.client.getCollection(indexName);
     const distance = config.params.vectors?.distance;
     return {
@@ -341,7 +370,9 @@ var QdrantVector = class extends MastraVector {
       metric: Object.keys(DISTANCE_MAPPING).find((key) => DISTANCE_MAPPING[key] === distance)
     };
   }
-  async deleteIndex(indexName) {
+  async deleteIndex(...args) {
+    const params = this.normalizeArgs("deleteIndex", args);
+    const { indexName } = params;
     await this.client.deleteCollection(indexName);
   }
   /**
@@ -362,7 +393,7 @@ var QdrantVector = class extends MastraVector {
       Please use updateVector() instead. 
       updateIndexById() will be removed on May 20th, 2025.`
     );
-    await this.updateVector(indexName, id, update);
+    await this.updateVector({ indexName, id, update });
   }
   /**
    * Updates a vector by its ID with the provided vector and/or metadata.
@@ -374,7 +405,9 @@ var QdrantVector = 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(indexName, id, update) {
+  async updateVector(...args) {
+    const params = this.normalizeArgs("updateVector", args);
+    const { indexName, id, update } = params;
     if (!update.vector && !update.metadata) {
       throw new Error("No updates provided");
     }
@@ -426,7 +459,7 @@ var QdrantVector = class extends MastraVector {
       Please use deleteVector() instead. 
       deleteIndexById() will be removed on May 20th, 2025.`
     );
-    await this.deleteVector(indexName, id);
+    await this.deleteVector({ indexName, id });
   }
   /**
    * Deletes a vector by its ID.
@@ -435,7 +468,9 @@ var QdrantVector = 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(...args) {
+    const params = this.normalizeArgs("deleteVector", args);
+    const { indexName, id } = params;
     try {
       const pointId = this.parsePointId(id);
       await this.client.delete(indexName, {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mastra/qdrant",
-  "version": "0.2.14",
+  "version": "0.2.15-alpha.0",
   "description": "Qdrant vector store provider for Mastra",
   "type": "module",
   "main": "dist/index.js",
@@ -21,7 +21,7 @@
   "license": "MIT",
   "dependencies": {
     "@qdrant/js-client-rest": "^1.13.0",
-    "@mastra/core": "^0.9.4"
+    "@mastra/core": "^0.9.5-alpha.0"
   },
   "devDependencies": {
     "@microsoft/api-extractor": "^7.52.5",

package/src/vector/index.test.ts

@@ -13,12 +13,12 @@ describe('QdrantVector', () => {
 
   describe('Index Operations', () => {
     beforeAll(async () => {
-      qdrant = new QdrantVector('http://localhost:6333/');
+      qdrant = new QdrantVector({ url: 'http://localhost:6333/' });
       await qdrant.createIndex({ indexName: testCollectionName, dimension });
     });
 
     afterAll(async () => {
-      await qdrant.deleteIndex(testCollectionName);
+      await qdrant.deleteIndex({ indexName: testCollectionName });
     }, 50000);
 
     it('should list collections including ours', async () => {
@@ -27,7 +27,7 @@ describe('QdrantVector', () => {
     }, 50000);
 
     it('should describe index with correct properties', async () => {
-      const stats = await qdrant.describeIndex(testCollectionName);
+      const stats = await qdrant.describeIndex({ indexName: testCollectionName });
       expect(stats.dimension).toBe(dimension);
       expect(stats.metric).toBe('cosine');
       expect(typeof stats.count).toBe('number');
@@ -36,12 +36,12 @@ describe('QdrantVector', () => {
 
   describe('Vector Operations', () => {
     beforeAll(async () => {
-      qdrant = new QdrantVector('http://localhost:6333/');
+      qdrant = new QdrantVector({ url: 'http://localhost:6333/' });
       await qdrant.createIndex({ indexName: testCollectionName, dimension });
     });
 
     afterAll(async () => {
-      await qdrant.deleteIndex(testCollectionName);
+      await qdrant.deleteIndex({ indexName: testCollectionName });
     }, 50000);
 
     const testVectors = [
@@ -100,7 +100,7 @@ describe('QdrantVector', () => {
     });
 
     afterEach(async () => {
-      await qdrant.deleteIndex(testCollectionName);
+      await qdrant.deleteIndex({ indexName: testCollectionName });
     });
 
     it('should update the vector by id', async () => {
@@ -118,7 +118,7 @@ describe('QdrantVector', () => {
         metadata: newMetaData,
       };
 
-      await qdrant.updateVector(testCollectionName, idToBeUpdated, update);
+      await qdrant.updateVector({ indexName: testCollectionName, id: idToBeUpdated, update });
 
       const results: QueryResult[] = await qdrant.query({
         indexName: testCollectionName,
@@ -146,7 +146,7 @@ describe('QdrantVector', () => {
         metadata: newMetaData,
       };
 
-      await qdrant.updateVector(testCollectionName, idToBeUpdated, update);
+      await qdrant.updateVector({ indexName: testCollectionName, id: idToBeUpdated, update });
 
       const results: QueryResult[] = await qdrant.query({
         indexName: testCollectionName,
@@ -171,7 +171,7 @@ describe('QdrantVector', () => {
         vector: newVector,
       };
 
-      await qdrant.updateVector(testCollectionName, idToBeUpdated, update);
+      await qdrant.updateVector({ indexName: testCollectionName, id: idToBeUpdated, update });
 
       const results: QueryResult[] = await qdrant.query({
         indexName: testCollectionName,
@@ -185,12 +185,16 @@ describe('QdrantVector', () => {
     });
 
     it('should throw exception when no updates are given', async () => {
-      await expect(qdrant.updateVector(testCollectionName, 'id', {})).rejects.toThrow('No updates provided');
+      await expect(qdrant.updateVector({ indexName: testCollectionName, id: 'id', update: {} })).rejects.toThrow(
+        'No updates provided',
+      );
     });
 
     it('should throw error for non-existent index', async () => {
       const nonExistentIndex = 'non-existent-index';
-      await expect(qdrant.updateVector(nonExistentIndex, 'test-id', { vector: [1, 2, 3] })).rejects.toThrow();
+      await expect(
+        qdrant.updateVector({ indexName: nonExistentIndex, id: 'test-id', update: { vector: [1, 2, 3] } }),
+      ).rejects.toThrow();
     });
 
     it('should throw error for invalid vector dimension', async () => {
@@ -201,7 +205,7 @@ describe('QdrantVector', () => {
       });
 
       await expect(
-        qdrant.updateVector(testCollectionName, id, { vector: [1, 2] }), // Wrong dimension
+        qdrant.updateVector({ indexName: testCollectionName, id, update: { vector: [1, 2] } }), // Wrong dimension
       ).rejects.toThrow();
     });
   });
@@ -218,7 +222,7 @@ describe('QdrantVector', () => {
     });
 
     afterEach(async () => {
-      await qdrant.deleteIndex(testCollectionName);
+      await qdrant.deleteIndex({ indexName: testCollectionName });
     });
 
     it('should delete the vector by id', async () => {
@@ -226,7 +230,7 @@ describe('QdrantVector', () => {
       expect(ids).toHaveLength(3);
       const idToBeDeleted = ids[0];
 
-      await qdrant.deleteVector(testCollectionName, idToBeDeleted);
+      await qdrant.deleteVector({ indexName: testCollectionName, id: idToBeDeleted });
 
       const results: QueryResult[] = await qdrant.query({
         indexName: testCollectionName,
@@ -335,13 +339,13 @@ describe('QdrantVector', () => {
     ];
 
     beforeAll(async () => {
-      qdrant = new QdrantVector('http://localhost:6333/');
+      qdrant = new QdrantVector({ url: 'http://localhost:6333/' });
       await qdrant.createIndex({ indexName: testCollectionName, dimension });
       await qdrant.upsert({ indexName: testCollectionName, vectors: filterTestVectors, metadata: filterTestMetadata });
     });
 
     afterAll(async () => {
-      await qdrant.deleteIndex(testCollectionName);
+      await qdrant.deleteIndex({ indexName: testCollectionName });
     }, 50000);
 
     describe('Basic Operators', () => {
@@ -761,7 +765,7 @@ describe('QdrantVector', () => {
     });
 
     afterAll(async () => {
-      await qdrant.deleteIndex(testIndexName);
+      await qdrant.deleteIndex({ indexName: testIndexName });
     });
 
     it('should handle non-existent index query gracefully', async () => {
@@ -829,7 +833,7 @@ describe('QdrantVector', () => {
         infoSpy.mockRestore();
         warnSpy.mockRestore();
         // Cleanup
-        await qdrant.deleteIndex(duplicateIndexName);
+        await qdrant.deleteIndex({ indexName: duplicateIndexName });
       }
     });
   });
@@ -870,13 +874,13 @@ describe('QdrantVector', () => {
     ];
 
     beforeAll(async () => {
-      qdrant = new QdrantVector('http://localhost:6333/');
+      qdrant = new QdrantVector({ url: 'http://localhost:6333/' });
       await qdrant.createIndex({ indexName: testCollectionName, dimension });
       await qdrant.upsert({ indexName: testCollectionName, vectors: filterTestVectors, metadata: filterTestMetadata });
     });
 
     afterAll(async () => {
-      await qdrant.deleteIndex(testCollectionName);
+      await qdrant.deleteIndex({ indexName: testCollectionName });
     }, 50000);
     it('should handle undefined filter', async () => {
       const results1 = await qdrant.query({ indexName: testCollectionName, queryVector: [1, 0, 0], filter: undefined });
@@ -902,12 +906,12 @@ describe('QdrantVector', () => {
 
   describe('Performance Tests', () => {
     beforeAll(async () => {
-      qdrant = new QdrantVector('http://localhost:6333/');
+      qdrant = new QdrantVector({ url: 'http://localhost:6333/' });
       await qdrant.createIndex({ indexName: testCollectionName, dimension });
     });
 
     afterAll(async () => {
-      await qdrant.deleteIndex(testCollectionName);
+      await qdrant.deleteIndex({ indexName: testCollectionName });
     }, 50000);
 
     it('should handle batch upsert of 1000 vectors', async () => {
@@ -953,12 +957,12 @@ describe('QdrantVector', () => {
     let warnSpy;
 
     beforeAll(async () => {
-      await qdrant.createIndex({ indexName: indexName, dimension: 3 });
+      await qdrant.createIndex({ indexName, dimension: 3 });
     });
 
     afterAll(async () => {
-      await qdrant.deleteIndex(indexName);
-      await qdrant.deleteIndex(indexName2);
+      await qdrant.deleteIndex({ indexName });
+      await qdrant.deleteIndex({ indexName: indexName2 });
     });
 
     beforeEach(async () => {
@@ -967,7 +971,7 @@ describe('QdrantVector', () => {
 
     afterEach(async () => {
       warnSpy.mockRestore();
-      await qdrant.deleteIndex(indexName2);
+      await qdrant.deleteIndex({ indexName: indexName2 });
     });
 
     it('should show deprecation warning when using individual args for createIndex', async () => {

package/src/vector/index.ts

@@ -6,6 +6,10 @@ import type {
   UpsertVectorParams,
   QueryVectorParams,
   ParamsToArgs,
+  DescribeIndexParams,
+  DeleteIndexParams,
+  DeleteVectorParams,
+  UpdateVectorParams,
 } from '@mastra/core/vector';
 import type { VectorFilter } from '@mastra/core/vector/filter';
 import { QdrantClient } from '@qdrant/js-client-rest';
@@ -23,15 +27,45 @@ const DISTANCE_MAPPING: Record<string, Schemas['Distance']> = {
 export class QdrantVector extends MastraVector {
   private client: QdrantClient;
 
-  constructor(url: string, apiKey?: string, https?: boolean) {
+  /**
+   * @deprecated Passing url, apiKey, https as positional arguments is deprecated.
+   * Use the object parameter instead. This signature will be removed on May 20th, 2025.
+   */
+  constructor(url: string, apiKey?: string, https?: boolean);
+  /**
+   * Creates a new QdrantVector client.
+   * @param params - An object with url, optional apiKey, and optional https.
+   */
+  constructor(params: { url: string; apiKey?: string; https?: boolean });
+  constructor(
+    paramsOrUrl: { url: string; apiKey?: string; https?: boolean } | string,
+    apiKey?: string,
+    https?: boolean,
+  ) {
     super();
-
+    let url: string;
+    let key: string | undefined;
+    let secure: boolean | undefined;
+    if (typeof paramsOrUrl === 'string') {
+      // DEPRECATION WARNING
+      if (typeof console !== 'undefined' && console.warn) {
+        console.warn(
+          `Deprecation Warning: Passing url, apiKey, https as positional arguments to QdrantVector constructor is deprecated.\nPlease use an object parameter instead:\n  new QdrantVector({ url, apiKey, https })\nThis signature will be removed on May 20th, 2025.`,
+        );
+      }
+      url = paramsOrUrl;
+      key = apiKey;
+      secure = https;
+    } else {
+      url = paramsOrUrl.url;
+      key = paramsOrUrl.apiKey;
+      secure = paramsOrUrl.https;
+    }
     const baseClient = new QdrantClient({
       url,
-      apiKey,
-      https,
+      apiKey: key,
+      https: secure,
     });
-
     const telemetry = this.__getTelemetry();
     this.client =
       telemetry?.traceClass(baseClient, {
@@ -144,7 +178,16 @@ export class QdrantVector extends MastraVector {
     return response.collections.map(collection => collection.name) || [];
   }
 
-  async describeIndex(indexName: string): Promise<IndexStats> {
+  /**
+   * Retrieves statistics about a vector index.
+   *
+   * @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
+   */
+  async describeIndex(...args: ParamsToArgs<DescribeIndexParams>): Promise<IndexStats> {
+    const params = this.normalizeArgs<DescribeIndexParams>('describeIndex', args);
+    const { indexName } = params;
     const { config, points_count } = await this.client.getCollection(indexName);
 
     const distance = config.params.vectors?.distance as Schemas['Distance'];
@@ -156,7 +199,9 @@ export class QdrantVector extends MastraVector {
     };
   }
 
-  async deleteIndex(indexName: string): Promise<void> {
+  async deleteIndex(...args: ParamsToArgs<DeleteIndexParams>): Promise<void> {
+    const params = this.normalizeArgs<DeleteIndexParams>('deleteIndex', args);
+    const { indexName } = params;
     await this.client.deleteCollection(indexName);
   }
 
@@ -182,7 +227,7 @@ export class QdrantVector extends MastraVector {
       Please use updateVector() instead. 
       updateIndexById() will be removed on May 20th, 2025.`,
     );
-    await this.updateVector(indexName, id, update);
+    await this.updateVector({ indexName, id, update });
   }
 
   /**
@@ -195,14 +240,9 @@ export class QdrantVector 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(...args: ParamsToArgs<UpdateVectorParams>): Promise<void> {
+    const params = this.normalizeArgs<UpdateVectorParams>('updateVector', args);
+    const { indexName, id, update } = params;
     if (!update.vector && !update.metadata) {
       throw new Error('No updates provided');
     }
@@ -264,7 +304,7 @@ export class QdrantVector extends MastraVector {
       Please use deleteVector() instead. 
       deleteIndexById() will be removed on May 20th, 2025.`,
     );
-    await this.deleteVector(indexName, id);
+    await this.deleteVector({ indexName, id });
   }
 
   /**
@@ -274,7 +314,9 @@ export class QdrantVector 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(...args: ParamsToArgs<DeleteVectorParams>): Promise<void> {
+    const params = this.normalizeArgs<DeleteVectorParams>('deleteVector', args);
+    const { indexName, id } = params;
     try {
       // Parse the ID - Qdrant supports both string and numeric IDs
       const pointId = this.parsePointId(id);