@mastra/mongodb 0.0.6-alpha.0 → 0.10.0

package/.turbo/turbo-build.log

@@ -1,23 +1,23 @@
 
-> @mastra/mongodb@0.0.6-alpha.0 build /home/runner/work/mastra/mastra/stores/mongodb
+> @mastra/mongodb@0.10.0-alpha.1 build /home/runner/work/mastra/mastra/stores/mongodb
 > 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 6675ms
+TSC ⚡️ Build success in 5643ms
 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/mongodb/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/mongodb/dist/_tsup-dts-rollup.d.cts
-DTS ⚡️ Build success in 8933ms
+DTS ⚡️ Build success in 8219ms
 CLI Cleaning output folder
 ESM Build start
 CJS Build start
-CJS dist/index.cjs 20.42 KB
-CJS ⚡️ Build success in 734ms
-ESM dist/index.js 20.37 KB
-ESM ⚡️ Build success in 737ms
+CJS dist/index.cjs 18.11 KB
+CJS ⚡️ Build success in 706ms
+ESM dist/index.js 18.05 KB
+ESM ⚡️ Build success in 707ms

package/CHANGELOG.md

@@ -1,5 +1,55 @@
 # @mastra/mongodb
 
+## 0.10.0
+
+### Minor Changes
+
+- 83da932: Move @mastra/core to peerdeps
+
+### Patch Changes
+
+- d0ee3c6: Change all public functions and constructors in vector stores to use named args and prepare to phase out positional args
+- 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 [f53a6ac]
+- Updated dependencies [5eb5a99]
+- Updated dependencies [7e632c5]
+- Updated dependencies [1e9fbfa]
+- Updated dependencies [eabdcd9]
+- Updated dependencies [90be034]
+- Updated dependencies [99f050a]
+- Updated dependencies [d0ee3c6]
+- Updated dependencies [b2ae5aa]
+- Updated dependencies [23f258c]
+- Updated dependencies [a7292b0]
+- Updated dependencies [0dcb9f0]
+- Updated dependencies [2672a05]
+  - @mastra/core@0.10.0
+
+## 0.1.0-alpha.1
+
+### Minor Changes
+
+- 83da932: Move @mastra/core to peerdeps
+
+### Patch Changes
+
+- a7292b0: BREAKING(@mastra/core, all vector stores): Vector store breaking changes (remove deprecated functions and positional arguments)
+- Updated dependencies [b3a3d63]
+- Updated dependencies [344f453]
+- Updated dependencies [0a3ae6d]
+- Updated dependencies [95911be]
+- Updated dependencies [5eb5a99]
+- Updated dependencies [7e632c5]
+- Updated dependencies [1e9fbfa]
+- Updated dependencies [b2ae5aa]
+- Updated dependencies [a7292b0]
+- Updated dependencies [0dcb9f0]
+  - @mastra/core@0.10.0-alpha.1
+
 ## 0.0.6-alpha.0
 
 ### Patch Changes

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

@@ -7,12 +7,9 @@ import type { IndexStats } from '@mastra/core/vector';
 import { MastraVector } from '@mastra/core/vector';
 import type { MongoClientOptions } from 'mongodb';
 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 { UpdateVectorParams } from '@mastra/core/vector';
-import type { UpsertVectorArgs } from '@mastra/core/vector';
 import type { UpsertVectorParams } from '@mastra/core/vector';
 import type { VectorFilter } from '@mastra/core/vector/filter';
 
@@ -37,8 +34,6 @@ export declare class MongoDBFilterTranslator extends BaseFilterTranslator {
     isEmpty(filter: any): boolean;
 }
 
-declare type MongoDBIndexReadyArgs = [string, number?, number?];
-
 declare interface MongoDBIndexReadyParams {
     indexName: string;
     timeoutMs?: number;
@@ -47,24 +42,12 @@ declare interface MongoDBIndexReadyParams {
 export { MongoDBIndexReadyParams }
 export { MongoDBIndexReadyParams as MongoDBIndexReadyParams_alias_1 }
 
-declare type MongoDBQueryArgs = [...QueryVectorArgs, string?];
-export { MongoDBQueryArgs }
-export { MongoDBQueryArgs as MongoDBQueryArgs_alias_1 }
-
 declare interface MongoDBQueryVectorParams extends QueryVectorParams {
     documentFilter?: VectorFilter;
 }
 export { MongoDBQueryVectorParams }
 export { MongoDBQueryVectorParams as MongoDBQueryVectorParams_alias_1 }
 
-declare type MongoDBUpsertArgs = [...UpsertVectorArgs, string[]?];
-export { MongoDBUpsertArgs }
-export { MongoDBUpsertArgs as MongoDBUpsertArgs_alias_1 }
-
-declare type MongoDBUpsertParams = ParamsToArgs<MongoDBUpsertArgs>;
-export { MongoDBUpsertParams }
-export { MongoDBUpsertParams as MongoDBUpsertParams_alias_1 }
-
 declare interface MongoDBUpsertVectorParams extends UpsertVectorParams {
     documents?: string[];
 }
@@ -87,32 +70,28 @@ declare class MongoDBVector extends MastraVector {
     });
     connect(): Promise<void>;
     disconnect(): Promise<void>;
-    createIndex(params: CreateIndexParams): Promise<void>;
+    createIndex({ indexName, dimension, metric }: CreateIndexParams): Promise<void>;
     /**
      * Waits for the index to be ready.
      *
-     * @param params - The parameters for waiting for the index to be ready
-     * @param params.indexName - The name of the index to wait for
-     * @param params.timeoutMs - The maximum time in milliseconds to wait for the index to be ready (default: 60000)
-     * @param params.checkIntervalMs - The interval in milliseconds at which to check if the index is ready (default: 2000)
+     * @param {string} indexName - The name of the index to wait for
+     * @param {number} timeoutMs - The maximum time in milliseconds to wait for the index to be ready (default: 60000)
+     * @param {number} checkIntervalMs - The interval in milliseconds at which to check if the index is ready (default: 2000)
      * @returns A promise that resolves when the index is ready
      */
-    waitForIndexReady(...args: ParamsToArgs<MongoDBIndexReadyParams> | MongoDBIndexReadyArgs): Promise<void>;
-    upsert(params: MongoDBUpsertVectorParams): Promise<string[]>;
-    query(params: MongoDBQueryVectorParams): Promise<QueryResult[]>;
+    waitForIndexReady({ indexName, timeoutMs, checkIntervalMs, }: MongoDBIndexReadyParams): Promise<void>;
+    upsert({ indexName, vectors, metadata, ids, documents }: MongoDBUpsertVectorParams): Promise<string[]>;
+    query({ indexName, queryVector, topK, filter, includeVector, documentFilter, }: MongoDBQueryVectorParams): Promise<QueryResult[]>;
     listIndexes(): Promise<string[]>;
     /**
      * Retrieves statistics about a vector index.
      *
-     * @param params - The parameters for describing an index
-     * @param params.indexName - The name of the index to describe
+     * @param {string} 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>;
+    describeIndex({ indexName }: DescribeIndexParams): Promise<IndexStats>;
+    deleteIndex({ indexName }: DeleteIndexParams): Promise<void>;
     /**
-     * @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.
@@ -122,31 +101,7 @@ declare class MongoDBVector 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.
      */
-    updateIndexById(indexName: string, id: string, update: {
-        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>;
+    updateVector({ indexName, id, update }: UpdateVectorParams): Promise<void>;
     /**
      * Deletes a vector by its ID.
      * @param indexName - The name of the index containing the vector.
@@ -154,7 +109,7 @@ declare class MongoDBVector extends MastraVector {
      * @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>;
+    deleteVector({ indexName, id }: DeleteVectorParams): Promise<void>;
     private getCollection;
     private validateVectorDimensions;
     private setIndexDimension;

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

@@ -7,12 +7,9 @@ import type { IndexStats } from '@mastra/core/vector';
 import { MastraVector } from '@mastra/core/vector';
 import type { MongoClientOptions } from 'mongodb';
 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 { UpdateVectorParams } from '@mastra/core/vector';
-import type { UpsertVectorArgs } from '@mastra/core/vector';
 import type { UpsertVectorParams } from '@mastra/core/vector';
 import type { VectorFilter } from '@mastra/core/vector/filter';
 
@@ -37,8 +34,6 @@ export declare class MongoDBFilterTranslator extends BaseFilterTranslator {
     isEmpty(filter: any): boolean;
 }
 
-declare type MongoDBIndexReadyArgs = [string, number?, number?];
-
 declare interface MongoDBIndexReadyParams {
     indexName: string;
     timeoutMs?: number;
@@ -47,24 +42,12 @@ declare interface MongoDBIndexReadyParams {
 export { MongoDBIndexReadyParams }
 export { MongoDBIndexReadyParams as MongoDBIndexReadyParams_alias_1 }
 
-declare type MongoDBQueryArgs = [...QueryVectorArgs, string?];
-export { MongoDBQueryArgs }
-export { MongoDBQueryArgs as MongoDBQueryArgs_alias_1 }
-
 declare interface MongoDBQueryVectorParams extends QueryVectorParams {
     documentFilter?: VectorFilter;
 }
 export { MongoDBQueryVectorParams }
 export { MongoDBQueryVectorParams as MongoDBQueryVectorParams_alias_1 }
 
-declare type MongoDBUpsertArgs = [...UpsertVectorArgs, string[]?];
-export { MongoDBUpsertArgs }
-export { MongoDBUpsertArgs as MongoDBUpsertArgs_alias_1 }
-
-declare type MongoDBUpsertParams = ParamsToArgs<MongoDBUpsertArgs>;
-export { MongoDBUpsertParams }
-export { MongoDBUpsertParams as MongoDBUpsertParams_alias_1 }
-
 declare interface MongoDBUpsertVectorParams extends UpsertVectorParams {
     documents?: string[];
 }
@@ -87,32 +70,28 @@ declare class MongoDBVector extends MastraVector {
     });
     connect(): Promise<void>;
     disconnect(): Promise<void>;
-    createIndex(params: CreateIndexParams): Promise<void>;
+    createIndex({ indexName, dimension, metric }: CreateIndexParams): Promise<void>;
     /**
      * Waits for the index to be ready.
      *
-     * @param params - The parameters for waiting for the index to be ready
-     * @param params.indexName - The name of the index to wait for
-     * @param params.timeoutMs - The maximum time in milliseconds to wait for the index to be ready (default: 60000)
-     * @param params.checkIntervalMs - The interval in milliseconds at which to check if the index is ready (default: 2000)
+     * @param {string} indexName - The name of the index to wait for
+     * @param {number} timeoutMs - The maximum time in milliseconds to wait for the index to be ready (default: 60000)
+     * @param {number} checkIntervalMs - The interval in milliseconds at which to check if the index is ready (default: 2000)
      * @returns A promise that resolves when the index is ready
      */
-    waitForIndexReady(...args: ParamsToArgs<MongoDBIndexReadyParams> | MongoDBIndexReadyArgs): Promise<void>;
-    upsert(params: MongoDBUpsertVectorParams): Promise<string[]>;
-    query(params: MongoDBQueryVectorParams): Promise<QueryResult[]>;
+    waitForIndexReady({ indexName, timeoutMs, checkIntervalMs, }: MongoDBIndexReadyParams): Promise<void>;
+    upsert({ indexName, vectors, metadata, ids, documents }: MongoDBUpsertVectorParams): Promise<string[]>;
+    query({ indexName, queryVector, topK, filter, includeVector, documentFilter, }: MongoDBQueryVectorParams): Promise<QueryResult[]>;
     listIndexes(): Promise<string[]>;
     /**
      * Retrieves statistics about a vector index.
      *
-     * @param params - The parameters for describing an index
-     * @param params.indexName - The name of the index to describe
+     * @param {string} 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>;
+    describeIndex({ indexName }: DescribeIndexParams): Promise<IndexStats>;
+    deleteIndex({ indexName }: DeleteIndexParams): Promise<void>;
     /**
-     * @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.
@@ -122,31 +101,7 @@ declare class MongoDBVector 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.
      */
-    updateIndexById(indexName: string, id: string, update: {
-        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>;
+    updateVector({ indexName, id, update }: UpdateVectorParams): Promise<void>;
     /**
      * Deletes a vector by its ID.
      * @param indexName - The name of the index containing the vector.
@@ -154,7 +109,7 @@ declare class MongoDBVector extends MastraVector {
      * @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>;
+    deleteVector({ indexName, id }: DeleteVectorParams): Promise<void>;
     private getCollection;
     private validateVectorDimensions;
     private setIndexDimension;

package/dist/index.cjs

@@ -121,8 +121,7 @@ var MongoDBVector = class extends vector.MastraVector {
   async disconnect() {
     await this.client.close();
   }
-  async createIndex(params) {
-    const { indexName, dimension, metric = "cosine" } = params;
+  async createIndex({ indexName, dimension, metric = "cosine" }) {
     if (!Number.isInteger(dimension) || dimension <= 0) {
       throw new Error("Dimension must be a positive integer");
     }
@@ -163,18 +162,16 @@ var MongoDBVector = class extends vector.MastraVector {
   /**
    * Waits for the index to be ready.
    *
-   * @param params - The parameters for waiting for the index to be ready
-   * @param params.indexName - The name of the index to wait for
-   * @param params.timeoutMs - The maximum time in milliseconds to wait for the index to be ready (default: 60000)
-   * @param params.checkIntervalMs - The interval in milliseconds at which to check if the index is ready (default: 2000)
+   * @param {string} indexName - The name of the index to wait for
+   * @param {number} timeoutMs - The maximum time in milliseconds to wait for the index to be ready (default: 60000)
+   * @param {number} checkIntervalMs - The interval in milliseconds at which to check if the index is ready (default: 2000)
    * @returns A promise that resolves when the index is ready
    */
-  async waitForIndexReady(...args) {
-    const params = this.normalizeArgs("waitForIndexReady", args, [
-      "timeoutMs",
-      "checkIntervalMs"
-    ]);
-    const { indexName, timeoutMs = 6e4, checkIntervalMs = 2e3 } = params;
+  async waitForIndexReady({
+    indexName,
+    timeoutMs = 6e4,
+    checkIntervalMs = 2e3
+  }) {
     const collection = await this.getCollection(indexName, true);
     const indexNameInternal = `${indexName}_vector_index`;
     const startTime = Date.now();
@@ -189,8 +186,7 @@ var MongoDBVector = class extends vector.MastraVector {
     }
     throw new Error(`Index "${indexNameInternal}" did not become ready within timeout`);
   }
-  async upsert(params) {
-    const { indexName, vectors, metadata, ids, documents } = params;
+  async upsert({ indexName, vectors, metadata, ids, documents }) {
     const collection = await this.getCollection(indexName);
     this.collectionForValidation = collection;
     const stats = await this.describeIndex({ indexName });
@@ -226,8 +222,14 @@ var MongoDBVector = class extends vector.MastraVector {
     await collection.bulkWrite(operations);
     return generatedIds;
   }
-  async query(params) {
-    const { indexName, queryVector, topK = 10, filter, includeVector = false, documentFilter } = params;
+  async query({
+    indexName,
+    queryVector,
+    topK = 10,
+    filter,
+    includeVector = false,
+    documentFilter
+  }) {
     const collection = await this.getCollection(indexName, true);
     const indexNameInternal = `${indexName}_vector_index`;
     const mongoFilter = this.transformFilter(filter);
@@ -286,13 +288,10 @@ var MongoDBVector = class extends vector.MastraVector {
   /**
    * Retrieves statistics about a vector index.
    *
-   * @param params - The parameters for describing an index
-   * @param params.indexName - The name of the index to describe
+   * @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(...args) {
-    const params = this.normalizeArgs("describeIndex", args);
-    const { indexName } = params;
+  async describeIndex({ indexName }) {
     const collection = await this.getCollection(indexName, true);
     const count = await collection.countDocuments({ _id: { $ne: "__index_metadata__" } });
     const metadataDoc = await collection.findOne({ _id: "__index_metadata__" });
@@ -304,9 +303,7 @@ var MongoDBVector = class extends vector.MastraVector {
       metric
     };
   }
-  async deleteIndex(...args) {
-    const params = this.normalizeArgs("deleteIndex", args);
-    const { indexName } = params;
+  async deleteIndex({ indexName }) {
     const collection = await this.getCollection(indexName, false);
     if (collection) {
       await collection.drop();
@@ -316,8 +313,6 @@ var MongoDBVector = 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.
@@ -327,27 +322,7 @@ var MongoDBVector = 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(...args) {
-    const params = this.normalizeArgs("updateVector", args);
-    const { indexName, id, update } = params;
+  async updateVector({ indexName, id, update }) {
     try {
       if (!update.vector && !update.metadata) {
         throw new Error("No updates provided");
@@ -374,23 +349,6 @@ var MongoDBVector = 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.
@@ -398,9 +356,7 @@ var MongoDBVector = 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(...args) {
-    const params = this.normalizeArgs("deleteVector", args);
-    const { indexName, id } = params;
+  async deleteVector({ indexName, id }) {
     try {
       const collection = await this.getCollection(indexName, true);
       await collection.deleteOne({ _id: id });

package/dist/index.d.cts

@@ -1,7 +1,4 @@
 export { MONGODB_PROMPT } from './_tsup-dts-rollup.cjs';
-export { MongoDBUpsertArgs } from './_tsup-dts-rollup.cjs';
-export { MongoDBQueryArgs } from './_tsup-dts-rollup.cjs';
-export { MongoDBUpsertParams } from './_tsup-dts-rollup.cjs';
 export { MongoDBUpsertVectorParams } from './_tsup-dts-rollup.cjs';
 export { MongoDBQueryVectorParams } from './_tsup-dts-rollup.cjs';
 export { MongoDBIndexReadyParams } from './_tsup-dts-rollup.cjs';

package/dist/index.d.ts

@@ -1,7 +1,4 @@
 export { MONGODB_PROMPT } from './_tsup-dts-rollup.js';
-export { MongoDBUpsertArgs } from './_tsup-dts-rollup.js';
-export { MongoDBQueryArgs } from './_tsup-dts-rollup.js';
-export { MongoDBUpsertParams } from './_tsup-dts-rollup.js';
 export { MongoDBUpsertVectorParams } from './_tsup-dts-rollup.js';
 export { MongoDBQueryVectorParams } from './_tsup-dts-rollup.js';
 export { MongoDBIndexReadyParams } from './_tsup-dts-rollup.js';

package/dist/index.js

@@ -119,8 +119,7 @@ var MongoDBVector = class extends MastraVector {
   async disconnect() {
     await this.client.close();
   }
-  async createIndex(params) {
-    const { indexName, dimension, metric = "cosine" } = params;
+  async createIndex({ indexName, dimension, metric = "cosine" }) {
     if (!Number.isInteger(dimension) || dimension <= 0) {
       throw new Error("Dimension must be a positive integer");
     }
@@ -161,18 +160,16 @@ var MongoDBVector = class extends MastraVector {
   /**
    * Waits for the index to be ready.
    *
-   * @param params - The parameters for waiting for the index to be ready
-   * @param params.indexName - The name of the index to wait for
-   * @param params.timeoutMs - The maximum time in milliseconds to wait for the index to be ready (default: 60000)
-   * @param params.checkIntervalMs - The interval in milliseconds at which to check if the index is ready (default: 2000)
+   * @param {string} indexName - The name of the index to wait for
+   * @param {number} timeoutMs - The maximum time in milliseconds to wait for the index to be ready (default: 60000)
+   * @param {number} checkIntervalMs - The interval in milliseconds at which to check if the index is ready (default: 2000)
    * @returns A promise that resolves when the index is ready
    */
-  async waitForIndexReady(...args) {
-    const params = this.normalizeArgs("waitForIndexReady", args, [
-      "timeoutMs",
-      "checkIntervalMs"
-    ]);
-    const { indexName, timeoutMs = 6e4, checkIntervalMs = 2e3 } = params;
+  async waitForIndexReady({
+    indexName,
+    timeoutMs = 6e4,
+    checkIntervalMs = 2e3
+  }) {
     const collection = await this.getCollection(indexName, true);
     const indexNameInternal = `${indexName}_vector_index`;
     const startTime = Date.now();
@@ -187,8 +184,7 @@ var MongoDBVector = class extends MastraVector {
     }
     throw new Error(`Index "${indexNameInternal}" did not become ready within timeout`);
   }
-  async upsert(params) {
-    const { indexName, vectors, metadata, ids, documents } = params;
+  async upsert({ indexName, vectors, metadata, ids, documents }) {
     const collection = await this.getCollection(indexName);
     this.collectionForValidation = collection;
     const stats = await this.describeIndex({ indexName });
@@ -224,8 +220,14 @@ var MongoDBVector = class extends MastraVector {
     await collection.bulkWrite(operations);
     return generatedIds;
   }
-  async query(params) {
-    const { indexName, queryVector, topK = 10, filter, includeVector = false, documentFilter } = params;
+  async query({
+    indexName,
+    queryVector,
+    topK = 10,
+    filter,
+    includeVector = false,
+    documentFilter
+  }) {
     const collection = await this.getCollection(indexName, true);
     const indexNameInternal = `${indexName}_vector_index`;
     const mongoFilter = this.transformFilter(filter);
@@ -284,13 +286,10 @@ var MongoDBVector = class extends MastraVector {
   /**
    * Retrieves statistics about a vector index.
    *
-   * @param params - The parameters for describing an index
-   * @param params.indexName - The name of the index to describe
+   * @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(...args) {
-    const params = this.normalizeArgs("describeIndex", args);
-    const { indexName } = params;
+  async describeIndex({ indexName }) {
     const collection = await this.getCollection(indexName, true);
     const count = await collection.countDocuments({ _id: { $ne: "__index_metadata__" } });
     const metadataDoc = await collection.findOne({ _id: "__index_metadata__" });
@@ -302,9 +301,7 @@ var MongoDBVector = class extends MastraVector {
       metric
     };
   }
-  async deleteIndex(...args) {
-    const params = this.normalizeArgs("deleteIndex", args);
-    const { indexName } = params;
+  async deleteIndex({ indexName }) {
     const collection = await this.getCollection(indexName, false);
     if (collection) {
       await collection.drop();
@@ -314,8 +311,6 @@ var MongoDBVector = 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.
@@ -325,27 +320,7 @@ var MongoDBVector = 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(...args) {
-    const params = this.normalizeArgs("updateVector", args);
-    const { indexName, id, update } = params;
+  async updateVector({ indexName, id, update }) {
     try {
       if (!update.vector && !update.metadata) {
         throw new Error("No updates provided");
@@ -372,23 +347,6 @@ var MongoDBVector = 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.
@@ -396,9 +354,7 @@ var MongoDBVector = 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(...args) {
-    const params = this.normalizeArgs("deleteVector", args);
-    const { indexName, id } = params;
+  async deleteVector({ indexName, id }) {
     try {
       const collection = await this.getCollection(indexName, true);
       await collection.deleteOne({ _id: id });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mastra/mongodb",
-  "version": "0.0.6-alpha.0",
+  "version": "0.10.0",
   "description": "MongoDB provider for Mastra - includes vector store capabilities",
   "type": "module",
   "main": "dist/index.js",
@@ -22,8 +22,7 @@
     "@types/mongodb": "^4.0.7",
     "cloudflare": "^4.1.0",
     "mongodb": "^6.15.0",
-    "uuid": "^11.1.0",
-    "@mastra/core": "^0.9.5-alpha.0"
+    "uuid": "^11.1.0"
   },
   "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.6",
+    "@mastra/core": "0.10.0"
+  },
+  "peerDependencies": {
+    "@mastra/core": "^0.10.0"
   },
   "scripts": {
     "build": "tsup src/index.ts --format esm,cjs --experimental-dts --clean --treeshake=smallest --splitting",

package/src/vector/index.ts

@@ -5,9 +5,6 @@ import type {
   CreateIndexParams,
   UpsertVectorParams,
   QueryVectorParams,
-  ParamsToArgs,
-  QueryVectorArgs,
-  UpsertVectorArgs,
   DescribeIndexParams,
   DeleteIndexParams,
   DeleteVectorParams,
@@ -21,10 +18,6 @@ import { v4 as uuidv4 } from 'uuid';
 import { MongoDBFilterTranslator } from './filter';
 
 // Define necessary types and interfaces
-export type MongoDBUpsertArgs = [...UpsertVectorArgs, string[]?];
-export type MongoDBQueryArgs = [...QueryVectorArgs, string?];
-export type MongoDBUpsertParams = ParamsToArgs<MongoDBUpsertArgs>;
-
 export interface MongoDBUpsertVectorParams extends UpsertVectorParams {
   documents?: string[];
 }
@@ -39,8 +32,6 @@ export interface MongoDBIndexReadyParams {
   checkIntervalMs?: number;
 }
 
-type MongoDBIndexReadyArgs = [string, number?, number?];
-
 // Define the document interface
 interface MongoDBDocument extends Document {
   _id: string; // Explicitly declare '_id' as string
@@ -80,9 +71,7 @@ export class MongoDBVector extends MastraVector {
     await this.client.close();
   }
 
-  async createIndex(params: CreateIndexParams): Promise<void> {
-    const { indexName, dimension, metric = 'cosine' } = params;
-
+  async createIndex({ indexName, dimension, metric = 'cosine' }: CreateIndexParams): Promise<void> {
     if (!Number.isInteger(dimension) || dimension <= 0) {
       throw new Error('Dimension must be a positive integer');
     }
@@ -133,18 +122,16 @@ export class MongoDBVector extends MastraVector {
   /**
    * Waits for the index to be ready.
    *
-   * @param params - The parameters for waiting for the index to be ready
-   * @param params.indexName - The name of the index to wait for
-   * @param params.timeoutMs - The maximum time in milliseconds to wait for the index to be ready (default: 60000)
-   * @param params.checkIntervalMs - The interval in milliseconds at which to check if the index is ready (default: 2000)
+   * @param {string} indexName - The name of the index to wait for
+   * @param {number} timeoutMs - The maximum time in milliseconds to wait for the index to be ready (default: 60000)
+   * @param {number} checkIntervalMs - The interval in milliseconds at which to check if the index is ready (default: 2000)
    * @returns A promise that resolves when the index is ready
    */
-  async waitForIndexReady(...args: ParamsToArgs<MongoDBIndexReadyParams> | MongoDBIndexReadyArgs): Promise<void> {
-    const params = this.normalizeArgs<MongoDBIndexReadyParams, MongoDBIndexReadyArgs>('waitForIndexReady', args, [
-      'timeoutMs',
-      'checkIntervalMs',
-    ]);
-    const { indexName, timeoutMs = 60000, checkIntervalMs = 2000 } = params;
+  async waitForIndexReady({
+    indexName,
+    timeoutMs = 60000,
+    checkIntervalMs = 2000,
+  }: MongoDBIndexReadyParams): Promise<void> {
     const collection = await this.getCollection(indexName, true);
     const indexNameInternal = `${indexName}_vector_index`;
 
@@ -161,9 +148,7 @@ export class MongoDBVector extends MastraVector {
     throw new Error(`Index "${indexNameInternal}" did not become ready within timeout`);
   }
 
-  async upsert(params: MongoDBUpsertVectorParams): Promise<string[]> {
-    const { indexName, vectors, metadata, ids, documents } = params;
-
+  async upsert({ indexName, vectors, metadata, ids, documents }: MongoDBUpsertVectorParams): Promise<string[]> {
     const collection = await this.getCollection(indexName);
 
     this.collectionForValidation = collection;
@@ -213,9 +198,14 @@ export class MongoDBVector extends MastraVector {
     return generatedIds;
   }
 
-  async query(params: MongoDBQueryVectorParams): Promise<QueryResult[]> {
-    const { indexName, queryVector, topK = 10, filter, includeVector = false, documentFilter } = params;
-
+  async query({
+    indexName,
+    queryVector,
+    topK = 10,
+    filter,
+    includeVector = false,
+    documentFilter,
+  }: MongoDBQueryVectorParams): Promise<QueryResult[]> {
     const collection = await this.getCollection(indexName, true);
     const indexNameInternal = `${indexName}_vector_index`;
 
@@ -284,14 +274,10 @@ export class MongoDBVector extends MastraVector {
   /**
    * Retrieves statistics about a vector index.
    *
-   * @param params - The parameters for describing an index
-   * @param params.indexName - The name of the index to describe
+   * @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(...args: ParamsToArgs<DescribeIndexParams>): Promise<IndexStats> {
-    const params = this.normalizeArgs<DescribeIndexParams>('describeIndex', args);
-
-    const { indexName } = params;
+  async describeIndex({ indexName }: DescribeIndexParams): Promise<IndexStats> {
     const collection = await this.getCollection(indexName, true);
 
     // Get the count of documents, excluding the metadata document
@@ -309,10 +295,7 @@ export class MongoDBVector extends MastraVector {
     };
   }
 
-  async deleteIndex(...args: ParamsToArgs<DeleteIndexParams>): Promise<void> {
-    const params = this.normalizeArgs<DeleteIndexParams>('deleteIndex', args);
-
-    const { indexName } = params;
+  async deleteIndex({ indexName }: DeleteIndexParams): Promise<void> {
     const collection = await this.getCollection(indexName, false); // Do not throw error if collection doesn't exist
     if (collection) {
       await collection.drop();
@@ -324,8 +307,6 @@ export class MongoDBVector 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.
@@ -335,32 +316,7 @@ export class MongoDBVector 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: 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.
-   * @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(...args: ParamsToArgs<UpdateVectorParams>): Promise<void> {
-    const params = this.normalizeArgs<UpdateVectorParams>('updateVector', args);
-    const { indexName, id, update } = params;
+  async updateVector({ indexName, id, update }: UpdateVectorParams): Promise<void> {
     try {
       if (!update.vector && !update.metadata) {
         throw new Error('No updates provided');
@@ -395,24 +351,6 @@ export class MongoDBVector 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.
@@ -420,9 +358,7 @@ export class MongoDBVector extends MastraVector {
    * @returns A promise that resolves when the deletion is complete.
    * @throws Will throw an error if the deletion operation fails.
    */
-  async deleteVector(...args: ParamsToArgs<DeleteVectorParams>): Promise<void> {
-    const params = this.normalizeArgs<DeleteVectorParams>('deleteVector', args);
-    const { indexName, id } = params;
+  async deleteVector({ indexName, id }: DeleteVectorParams): Promise<void> {
     try {
       const collection = await this.getCollection(indexName, true);
       await collection.deleteOne({ _id: id });