@mastra/opensearch 0.0.0-generate-message-id-20250512171942 → 0.0.0-vector-sources-20250516175436

package/CHANGELOG.md

@@ -1,11 +1,28 @@
 # @mastra/opensearch
 
-## 0.0.0-generate-message-id-20250512171942
+## 0.0.0-vector-sources-20250516175436
 
 ### 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 [d0ee3c6]
+- Updated dependencies [23f258c]
+- Updated dependencies [2672a05]
+  - @mastra/core@0.0.0-vector-sources-20250516175436
+
+## 0.1.1
+
+### Patch Changes
+
+- c3bd795: [MASTRA-3358] Deprecate updateIndexById and deleteIndexById
+- Updated dependencies [396be50]
 - Updated dependencies [ab80e7e]
-- Updated dependencies [66a786d]
+- Updated dependencies [c3bd795]
+- Updated dependencies [da082f8]
+- Updated dependencies [a5810ce]
+- Updated dependencies [3e9c131]
 - Updated dependencies [3171b5b]
 - Updated dependencies [973e5ac]
 - Updated dependencies [daf942f]
@@ -14,7 +31,25 @@
 - Updated dependencies [6fa1ad1]
 - Updated dependencies [c28d7a0]
 - Updated dependencies [edf1e88]
-  - @mastra/core@0.0.0-generate-message-id-20250512171942
+  - @mastra/core@0.9.4
+
+## 0.1.1-alpha.4
+
+### Patch Changes
+
+- Updated dependencies [3e9c131]
+  - @mastra/core@0.9.4-alpha.4
+
+## 0.1.1-alpha.3
+
+### Patch Changes
+
+- c3bd795: [MASTRA-3358] Deprecate updateIndexById and deleteIndexById
+- Updated dependencies [396be50]
+- Updated dependencies [c3bd795]
+- Updated dependencies [da082f8]
+- Updated dependencies [a5810ce]
+  - @mastra/core@0.9.4-alpha.3
 
 ## 0.1.1-alpha.2
 

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

@@ -1,10 +1,15 @@
 import { BaseFilterTranslator } from '@mastra/core/vector/filter';
 import type { CreateIndexParams } from '@mastra/core';
+import type { DeleteIndexParams } from '@mastra/core';
+import type { DeleteVectorParams } from '@mastra/core';
+import type { DescribeIndexParams } from '@mastra/core';
 import type { IndexStats } from '@mastra/core';
 import { MastraVector } from '@mastra/core/vector';
 import type { OperatorSupport } from '@mastra/core/vector/filter';
+import type { ParamsToArgs } from '@mastra/core';
 import type { QueryResult } from '@mastra/core';
 import type { QueryVectorParams } from '@mastra/core';
+import type { UpdateVectorParams } from '@mastra/core';
 import type { UpsertVectorParams } from '@mastra/core';
 import type { VectorFilter } from '@mastra/core/vector/filter';
 
@@ -50,7 +55,19 @@ export declare class OpenSearchFilterTranslator extends BaseFilterTranslator {
 
 declare class OpenSearchVector extends MastraVector {
     private client;
+    /**
+     * @deprecated Passing a string URL is deprecated. Use an object parameter: { url }.
+     * @param url - The OpenSearch node URL (deprecated)
+     */
     constructor(url: string);
+    /**
+     * Creates a new OpenSearchVector client.
+     *
+     * @param params - An object with a url property specifying the OpenSearch node.
+     */
+    constructor(params: {
+        url: string;
+    });
     /**
      * Creates a new collection with the specified configuration.
      *
@@ -66,14 +83,21 @@ declare class OpenSearchVector extends MastraVector {
      * @returns {Promise<string[]>} A promise that resolves to an array of indexes.
      */
     listIndexes(): Promise<string[]>;
-    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
+     */
+    describeIndex(...args: ParamsToArgs<DescribeIndexParams>): Promise<IndexStats>;
     /**
      * Deletes the specified index.
      *
      * @param {string} indexName - The name of the index to delete.
      * @returns {Promise<void>} A promise that resolves when the index is deleted.
      */
-    deleteIndex(indexName: string): Promise<void>;
+    deleteIndex(...args: ParamsToArgs<DeleteIndexParams>): Promise<void>;
     /**
      * Inserts or updates vectors in the specified collection.
      *
@@ -111,27 +135,50 @@ declare class OpenSearchVector extends MastraVector {
      */
     private transformFilter;
     /**
-     * Updates a specific document in the index by ID.
+     * @deprecated Use {@link updateVector} instead. This method will be removed on May 20th, 2025.
      *
-     * @param {string} indexName - The name of the index containing the document.
-     * @param {string} id - The ID of the document to update.
-     * @param {Object} update - The update to apply to the document.
-     * @param {number[]} [update.vector] - Optional new vector to update.
-     * @param {Record<string, any>} [update.metadata] - Optional new metadata to update.
-     * @returns {Promise<void>} A promise that resolves when the document is updated.
+     * 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.
      */
     updateIndexById(indexName: string, id: string, update: {
         vector?: number[];
         metadata?: Record<string, any>;
     }): Promise<void>;
     /**
-     * Deletes a specific document from the index by ID.
+     * 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.
      *
-     * @param {string} indexName - The name of the index containing the document.
-     * @param {string} id - The ID of the document to delete.
-     * @returns {Promise<void>} A promise that resolves when the document is deleted.
+     * 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>;
+    /**
+     * Deletes a vector by its ID.
+     * @param indexName - The name of the index containing the vector.
+     * @param id - The ID of the vector to delete.
+     * @returns A promise that resolves when the deletion is complete.
+     * @throws Will throw an error if the deletion operation fails.
+     */
+    deleteVector(...args: ParamsToArgs<DeleteVectorParams>): Promise<void>;
 }
 export { OpenSearchVector }
 export { OpenSearchVector as OpenSearchVector_alias_1 }

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

@@ -1,10 +1,15 @@
 import { BaseFilterTranslator } from '@mastra/core/vector/filter';
 import type { CreateIndexParams } from '@mastra/core';
+import type { DeleteIndexParams } from '@mastra/core';
+import type { DeleteVectorParams } from '@mastra/core';
+import type { DescribeIndexParams } from '@mastra/core';
 import type { IndexStats } from '@mastra/core';
 import { MastraVector } from '@mastra/core/vector';
 import type { OperatorSupport } from '@mastra/core/vector/filter';
+import type { ParamsToArgs } from '@mastra/core';
 import type { QueryResult } from '@mastra/core';
 import type { QueryVectorParams } from '@mastra/core';
+import type { UpdateVectorParams } from '@mastra/core';
 import type { UpsertVectorParams } from '@mastra/core';
 import type { VectorFilter } from '@mastra/core/vector/filter';
 
@@ -50,7 +55,19 @@ export declare class OpenSearchFilterTranslator extends BaseFilterTranslator {
 
 declare class OpenSearchVector extends MastraVector {
     private client;
+    /**
+     * @deprecated Passing a string URL is deprecated. Use an object parameter: { url }.
+     * @param url - The OpenSearch node URL (deprecated)
+     */
     constructor(url: string);
+    /**
+     * Creates a new OpenSearchVector client.
+     *
+     * @param params - An object with a url property specifying the OpenSearch node.
+     */
+    constructor(params: {
+        url: string;
+    });
     /**
      * Creates a new collection with the specified configuration.
      *
@@ -66,14 +83,21 @@ declare class OpenSearchVector extends MastraVector {
      * @returns {Promise<string[]>} A promise that resolves to an array of indexes.
      */
     listIndexes(): Promise<string[]>;
-    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
+     */
+    describeIndex(...args: ParamsToArgs<DescribeIndexParams>): Promise<IndexStats>;
     /**
      * Deletes the specified index.
      *
      * @param {string} indexName - The name of the index to delete.
      * @returns {Promise<void>} A promise that resolves when the index is deleted.
      */
-    deleteIndex(indexName: string): Promise<void>;
+    deleteIndex(...args: ParamsToArgs<DeleteIndexParams>): Promise<void>;
     /**
      * Inserts or updates vectors in the specified collection.
      *
@@ -111,27 +135,50 @@ declare class OpenSearchVector extends MastraVector {
      */
     private transformFilter;
     /**
-     * Updates a specific document in the index by ID.
+     * @deprecated Use {@link updateVector} instead. This method will be removed on May 20th, 2025.
      *
-     * @param {string} indexName - The name of the index containing the document.
-     * @param {string} id - The ID of the document to update.
-     * @param {Object} update - The update to apply to the document.
-     * @param {number[]} [update.vector] - Optional new vector to update.
-     * @param {Record<string, any>} [update.metadata] - Optional new metadata to update.
-     * @returns {Promise<void>} A promise that resolves when the document is updated.
+     * 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.
      */
     updateIndexById(indexName: string, id: string, update: {
         vector?: number[];
         metadata?: Record<string, any>;
     }): Promise<void>;
     /**
-     * Deletes a specific document from the index by ID.
+     * 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.
      *
-     * @param {string} indexName - The name of the index containing the document.
-     * @param {string} id - The ID of the document to delete.
-     * @returns {Promise<void>} A promise that resolves when the document is deleted.
+     * 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>;
+    /**
+     * Deletes a vector by its ID.
+     * @param indexName - The name of the index containing the vector.
+     * @param id - The ID of the vector to delete.
+     * @returns A promise that resolves when the deletion is complete.
+     * @throws Will throw an error if the deletion operation fails.
+     */
+    deleteVector(...args: ParamsToArgs<DeleteVectorParams>): Promise<void>;
 }
 export { OpenSearchVector }
 export { OpenSearchVector as OpenSearchVector_alias_1 }

package/dist/index.cjs

@@ -364,8 +364,21 @@ var REVERSE_METRIC_MAPPING = {
 };
 var OpenSearchVector = class extends vector.MastraVector {
   client;
-  constructor(url) {
+  constructor(paramsOrUrl) {
     super();
+    let url;
+    if (typeof paramsOrUrl === "string") {
+      if (typeof console !== "undefined" && console.warn) {
+        console.warn(
+          "Deprecation Warning: OpenSearchVector constructor positional arguments are deprecated. Please use a single object parameter instead. This signature will be removed on May 20th, 2025."
+        );
+      }
+      url = paramsOrUrl;
+    } else if (typeof paramsOrUrl === "object" && paramsOrUrl !== null && "url" in paramsOrUrl) {
+      url = paramsOrUrl.url;
+    } else {
+      throw new Error("Invalid parameters for OpenSearchVector constructor. Expected { url: string }.");
+    }
     this.client = new opensearch.Client({ node: url });
   }
   /**
@@ -429,7 +442,16 @@ var OpenSearchVector = class extends vector.MastraVector {
       throw new Error(`Failed to list indexes: ${error.message}`);
     }
   }
-  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 { body: indexInfo } = await this.client.indices.get({ index: indexName });
     const mappings = indexInfo[indexName]?.mappings;
     const embedding = mappings?.properties?.embedding;
@@ -447,7 +469,9 @@ var OpenSearchVector = class extends vector.MastraVector {
    * @param {string} indexName - The name of the index to delete.
    * @returns {Promise<void>} A promise that resolves when the index is deleted.
    */
-  async deleteIndex(indexName) {
+  async deleteIndex(...args) {
+    const params = this.normalizeArgs("deleteIndex", args);
+    const { indexName } = params;
     try {
       await this.client.indices.delete({ index: indexName });
     } catch (error) {
@@ -467,7 +491,7 @@ var OpenSearchVector = class extends vector.MastraVector {
     const { indexName, vectors, metadata = [], ids } = params;
     const vectorIds = ids || vectors.map(() => crypto.randomUUID());
     const operations = [];
-    const indexInfo = await this.describeIndex(indexName);
+    const indexInfo = await this.describeIndex({ indexName });
     this.validateVectorDimensions(vectors, indexInfo.dimension);
     for (let i = 0; i < vectors.length; i++) {
       const operation = {
@@ -558,16 +582,38 @@ var OpenSearchVector = class extends vector.MastraVector {
     return translator.translate(filter);
   }
   /**
-   * Updates a specific document in the index by ID.
+   * @deprecated Use {@link updateVector} instead. This method will be removed on May 20th, 2025.
    *
-   * @param {string} indexName - The name of the index containing the document.
-   * @param {string} id - The ID of the document to update.
-   * @param {Object} update - The update to apply to the document.
-   * @param {number[]} [update.vector] - Optional new vector to update.
-   * @param {Record<string, any>} [update.metadata] - Optional new metadata to update.
-   * @returns {Promise<void>} A promise that resolves when the document is updated.
+   * 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, 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;
     if (!update.vector && !update.metadata) {
       throw new Error("No updates provided");
     }
@@ -586,7 +632,7 @@ var OpenSearchVector = class extends vector.MastraVector {
         id: source.id || id
       };
       if (update.vector) {
-        const indexInfo = await this.describeIndex(indexName);
+        const indexInfo = await this.describeIndex({ indexName });
         this.validateVectorDimensions([update.vector], indexInfo.dimension);
         updatedDoc.embedding = update.vector;
       } else if (source.embedding) {
@@ -609,13 +655,32 @@ var OpenSearchVector = class extends vector.MastraVector {
     }
   }
   /**
-   * Deletes a specific document from the index by ID.
+   * @deprecated Use {@link deleteVector} instead. This method will be removed on May 20th, 2025.
    *
-   * @param {string} indexName - The name of the index containing the document.
-   * @param {string} id - The ID of the document to delete.
-   * @returns {Promise<void>} A promise that resolves when the document is deleted.
+   * 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.
+   * @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 deleteVector(...args) {
+    const params = this.normalizeArgs("deleteVector", args);
+    const { indexName, id } = params;
     try {
       await this.client.delete({
         index: indexName,

package/dist/index.js

@@ -362,8 +362,21 @@ var REVERSE_METRIC_MAPPING = {
 };
 var OpenSearchVector = class extends MastraVector {
   client;
-  constructor(url) {
+  constructor(paramsOrUrl) {
     super();
+    let url;
+    if (typeof paramsOrUrl === "string") {
+      if (typeof console !== "undefined" && console.warn) {
+        console.warn(
+          "Deprecation Warning: OpenSearchVector constructor positional arguments are deprecated. Please use a single object parameter instead. This signature will be removed on May 20th, 2025."
+        );
+      }
+      url = paramsOrUrl;
+    } else if (typeof paramsOrUrl === "object" && paramsOrUrl !== null && "url" in paramsOrUrl) {
+      url = paramsOrUrl.url;
+    } else {
+      throw new Error("Invalid parameters for OpenSearchVector constructor. Expected { url: string }.");
+    }
     this.client = new Client({ node: url });
   }
   /**
@@ -427,7 +440,16 @@ var OpenSearchVector = class extends MastraVector {
       throw new Error(`Failed to list indexes: ${error.message}`);
     }
   }
-  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 { body: indexInfo } = await this.client.indices.get({ index: indexName });
     const mappings = indexInfo[indexName]?.mappings;
     const embedding = mappings?.properties?.embedding;
@@ -445,7 +467,9 @@ var OpenSearchVector = class extends MastraVector {
    * @param {string} indexName - The name of the index to delete.
    * @returns {Promise<void>} A promise that resolves when the index is deleted.
    */
-  async deleteIndex(indexName) {
+  async deleteIndex(...args) {
+    const params = this.normalizeArgs("deleteIndex", args);
+    const { indexName } = params;
     try {
       await this.client.indices.delete({ index: indexName });
     } catch (error) {
@@ -465,7 +489,7 @@ var OpenSearchVector = class extends MastraVector {
     const { indexName, vectors, metadata = [], ids } = params;
     const vectorIds = ids || vectors.map(() => crypto.randomUUID());
     const operations = [];
-    const indexInfo = await this.describeIndex(indexName);
+    const indexInfo = await this.describeIndex({ indexName });
     this.validateVectorDimensions(vectors, indexInfo.dimension);
     for (let i = 0; i < vectors.length; i++) {
       const operation = {
@@ -556,16 +580,38 @@ var OpenSearchVector = class extends MastraVector {
     return translator.translate(filter);
   }
   /**
-   * Updates a specific document in the index by ID.
+   * @deprecated Use {@link updateVector} instead. This method will be removed on May 20th, 2025.
    *
-   * @param {string} indexName - The name of the index containing the document.
-   * @param {string} id - The ID of the document to update.
-   * @param {Object} update - The update to apply to the document.
-   * @param {number[]} [update.vector] - Optional new vector to update.
-   * @param {Record<string, any>} [update.metadata] - Optional new metadata to update.
-   * @returns {Promise<void>} A promise that resolves when the document is updated.
+   * 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, 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;
     if (!update.vector && !update.metadata) {
       throw new Error("No updates provided");
     }
@@ -584,7 +630,7 @@ var OpenSearchVector = class extends MastraVector {
         id: source.id || id
       };
       if (update.vector) {
-        const indexInfo = await this.describeIndex(indexName);
+        const indexInfo = await this.describeIndex({ indexName });
         this.validateVectorDimensions([update.vector], indexInfo.dimension);
         updatedDoc.embedding = update.vector;
       } else if (source.embedding) {
@@ -607,13 +653,32 @@ var OpenSearchVector = class extends MastraVector {
     }
   }
   /**
-   * Deletes a specific document from the index by ID.
+   * @deprecated Use {@link deleteVector} instead. This method will be removed on May 20th, 2025.
    *
-   * @param {string} indexName - The name of the index containing the document.
-   * @param {string} id - The ID of the document to delete.
-   * @returns {Promise<void>} A promise that resolves when the document is deleted.
+   * 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.
+   * @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 deleteVector(...args) {
+    const params = this.normalizeArgs("deleteVector", args);
+    const { indexName, id } = params;
     try {
       await this.client.delete({
         index: indexName,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mastra/opensearch",
-  "version": "0.0.0-generate-message-id-20250512171942",
+  "version": "0.0.0-vector-sources-20250516175436",
   "description": "OpenSearch vector store provider for Mastra",
   "type": "module",
   "main": "dist/index.js",
@@ -20,7 +20,7 @@
   },
   "dependencies": {
     "@opensearch-project/opensearch": "^3.4.0",
-    "@mastra/core": "0.0.0-generate-message-id-20250512171942"
+    "@mastra/core": "0.0.0-vector-sources-20250516175436"
   },
   "devDependencies": {
     "@microsoft/api-extractor": "^7.52.1",
@@ -29,7 +29,7 @@
     "tsup": "^8.4.0",
     "typescript": "^5.8.2",
     "vitest": "^3.0.8",
-    "@internal/lint": "0.0.0-generate-message-id-20250512171942"
+    "@internal/lint": "0.0.0-vector-sources-20250516175436"
   },
   "scripts": {
     "build": "tsup src/index.ts --format esm,cjs --experimental-dts --clean --treeshake=smallest --splitting",

package/src/vector/index.test.ts

@@ -39,31 +39,31 @@ describe('OpenSearchVector', () => {
 
   beforeAll(async () => {
     // Initialize PgVector
-    vectorDB = new OpenSearchVector(url);
+    vectorDB = new OpenSearchVector({ url });
   });
 
   afterAll(async () => {
     // Clean up test tables
-    await vectorDB.deleteIndex(testIndexName);
+    await vectorDB.deleteIndex({ indexName: testIndexName });
   });
 
   // Index Management Tests
   describe('Index Management', () => {
     describe('createIndex', () => {
       afterAll(async () => {
-        await vectorDB.deleteIndex(testIndexName2);
+        await vectorDB.deleteIndex({ indexName: testIndexName2 });
       });
 
       it('should create a new vector table with specified dimensions', async () => {
         await vectorDB.createIndex({ indexName: testIndexName, dimension: 3 });
-        const stats = await vectorDB.describeIndex(testIndexName);
+        const stats = await vectorDB.describeIndex({ indexName: testIndexName });
         expect(stats?.dimension).toBe(3);
         expect(stats?.count).toBe(0);
       });
 
       it('should create index with specified metric', async () => {
         await vectorDB.createIndex({ indexName: testIndexName2, dimension: 3, metric: 'euclidean' });
-        const stats = await vectorDB.describeIndex(testIndexName2);
+        const stats = await vectorDB.describeIndex({ indexName: testIndexName2 });
         expect(stats.metric).toBe('euclidean');
       });
 
@@ -75,7 +75,7 @@ describe('OpenSearchVector', () => {
     describe('metrics', () => {
       const testIndex = 'test_metric';
       afterEach(async () => {
-        await vectorDB.deleteIndex(testIndex);
+        await vectorDB.deleteIndex({ indexName: testIndex });
       });
       it('should create index with cosine metric', async () => {
         await vectorDB.createIndex({
@@ -83,7 +83,7 @@ describe('OpenSearchVector', () => {
           dimension: 3,
           metric: 'cosine',
         });
-        const stats = await vectorDB.describeIndex(testIndex);
+        const stats = await vectorDB.describeIndex({ indexName: testIndex });
         expect(stats.metric).toBe('cosine');
       });
 
@@ -93,7 +93,7 @@ describe('OpenSearchVector', () => {
           dimension: 3,
           metric: 'euclidean',
         });
-        const stats = await vectorDB.describeIndex(testIndex);
+        const stats = await vectorDB.describeIndex({ indexName: testIndex });
         expect(stats.metric).toBe('euclidean');
       });
 
@@ -103,7 +103,7 @@ describe('OpenSearchVector', () => {
           dimension: 3,
           metric: 'dotproduct',
         });
-        const stats = await vectorDB.describeIndex(testIndex);
+        const stats = await vectorDB.describeIndex({ indexName: testIndex });
         expect(stats.metric).toBe('dotproduct');
       });
     });
@@ -115,7 +115,7 @@ describe('OpenSearchVector', () => {
       });
 
       afterAll(async () => {
-        await vectorDB.deleteIndex(indexName);
+        await vectorDB.deleteIndex({ indexName });
       });
 
       it('should list all vector tables', async () => {
@@ -124,7 +124,7 @@ describe('OpenSearchVector', () => {
       });
 
       it('should not return created index in list if it is deleted', async () => {
-        await vectorDB.deleteIndex(indexName);
+        await vectorDB.deleteIndex({ indexName });
         const indexes = await vectorDB.listIndexes();
         expect(indexes).not.toContain(indexName);
       });
@@ -137,7 +137,7 @@ describe('OpenSearchVector', () => {
       });
 
       afterAll(async () => {
-        await vectorDB.deleteIndex(indexName);
+        await vectorDB.deleteIndex({ indexName });
       });
 
       it('should return correct index stats', async () => {
@@ -147,7 +147,7 @@ describe('OpenSearchVector', () => {
         ];
         await vectorDB.upsert({ indexName, vectors });
 
-        const stats = await vectorDB.describeIndex(indexName);
+        const stats = await vectorDB.describeIndex({ indexName });
         expect(stats).toEqual({
           dimension: 3,
           count: 2,
@@ -156,7 +156,7 @@ describe('OpenSearchVector', () => {
       });
 
       it('should throw error for non-existent index', async () => {
-        await expect(vectorDB.describeIndex('non_existent')).rejects.toThrow();
+        await expect(vectorDB.describeIndex({ indexName: 'non_existent' })).rejects.toThrow();
       });
     });
 
@@ -170,7 +170,7 @@ describe('OpenSearchVector', () => {
         expect(indexes).toContain(testIndexName);
 
         // Delete the index after the test
-        await vectorDB.deleteIndex(testIndexName);
+        await vectorDB.deleteIndex({ indexName: testIndexName });
       });
 
       it('should throw an error if dimension is not a positive integer', async () => {
@@ -186,7 +186,7 @@ describe('OpenSearchVector', () => {
         let indexes = await vectorDB.listIndexes();
         expect(indexes).toContain(deleteTestIndex);
 
-        await vectorDB.deleteIndex(deleteTestIndex);
+        await vectorDB.deleteIndex({ indexName: deleteTestIndex });
 
         indexes = await vectorDB.listIndexes();
         expect(indexes).not.toContain(deleteTestIndex);
@@ -201,7 +201,7 @@ describe('OpenSearchVector', () => {
     });
 
     afterEach(async () => {
-      await vectorDB.deleteIndex(testIndexName);
+      await vectorDB.deleteIndex({ indexName: testIndexName });
     });
 
     describe('query', () => {
@@ -421,7 +421,7 @@ describe('OpenSearchVector', () => {
       });
 
       afterEach(async () => {
-        await vectorDB.deleteIndex(testIndexName);
+        await vectorDB.deleteIndex({ indexName: testIndexName });
       });
 
       it('should insert new vectors', async () => {
@@ -432,7 +432,7 @@ describe('OpenSearchVector', () => {
         const ids = await vectorDB.upsert({ indexName: testIndexName, vectors });
 
         expect(ids).toHaveLength(2);
-        const stats = await vectorDB.describeIndex(testIndexName);
+        const stats = await vectorDB.describeIndex({ indexName: testIndexName });
         expect(stats.count).toBe(2);
       });
 
@@ -485,7 +485,7 @@ describe('OpenSearchVector', () => {
       });
 
       afterEach(async () => {
-        await vectorDB.deleteIndex(testIndexName);
+        await vectorDB.deleteIndex({ indexName: testIndexName });
       });
 
       it('should update the vector by id', async () => {
@@ -503,7 +503,7 @@ describe('OpenSearchVector', () => {
           metadata: newMetaData,
         };
 
-        await vectorDB.updateIndexById(testIndexName, idToBeUpdated, update);
+        await vectorDB.updateVector({ indexName: testIndexName, id: idToBeUpdated, update });
 
         const results: QueryResult[] = await vectorDB.query({
           indexName: testIndexName,
@@ -530,7 +530,7 @@ describe('OpenSearchVector', () => {
           metadata: newMetaData,
         };
 
-        await vectorDB.updateIndexById(testIndexName, idToBeUpdated, update);
+        await vectorDB.updateVector({ indexName: testIndexName, id: idToBeUpdated, update });
 
         const results: QueryResult[] = await vectorDB.query({
           indexName: testIndexName,
@@ -555,7 +555,7 @@ describe('OpenSearchVector', () => {
           vector: newVector,
         };
 
-        await vectorDB.updateIndexById(testIndexName, idToBeUpdated, update);
+        await vectorDB.updateVector({ indexName: testIndexName, id: idToBeUpdated, update });
 
         const results: QueryResult[] = await vectorDB.query({
           indexName: testIndexName,
@@ -569,7 +569,9 @@ describe('OpenSearchVector', () => {
       });
 
       it('should throw exception when no updates are given', async () => {
-        await expect(vectorDB.updateIndexById(testIndexName, 'id', {})).rejects.toThrow('No updates provided');
+        await expect(vectorDB.updateVector({ indexName: testIndexName, id: 'id', update: {} })).rejects.toThrow(
+          'No updates provided',
+        );
       });
     });
 
@@ -586,7 +588,7 @@ describe('OpenSearchVector', () => {
       });
 
       afterEach(async () => {
-        await vectorDB.deleteIndex(testIndexName);
+        await vectorDB.deleteIndex({ indexName: testIndexName });
       });
 
       it('should delete the vector by id', async () => {
@@ -594,7 +596,7 @@ describe('OpenSearchVector', () => {
         expect(ids).toHaveLength(3);
         const idToBeDeleted = ids[0];
 
-        await vectorDB.deleteIndexById(testIndexName, idToBeDeleted);
+        await vectorDB.deleteVector({ indexName: testIndexName, id: idToBeDeleted });
 
         const results: QueryResult[] = await vectorDB.query({
           indexName: testIndexName,
@@ -663,7 +665,7 @@ describe('OpenSearchVector', () => {
     });
 
     afterEach(async () => {
-      await vectorDB.deleteIndex(indexName);
+      await vectorDB.deleteIndex({ indexName });
     });
 
     // Numeric Comparison Tests
@@ -1487,7 +1489,7 @@ describe('OpenSearchVector', () => {
     });
 
     afterAll(async () => {
-      await vectorDB.deleteIndex(testIndexName);
+      await vectorDB.deleteIndex({ indexName: testIndexName });
     });
 
     it('should handle non-existent index queries', async () => {
@@ -1550,7 +1552,7 @@ describe('OpenSearchVector', () => {
         infoSpy.mockRestore();
         warnSpy.mockRestore();
         // Cleanup
-        await vectorDB.deleteIndex(duplicateIndexName);
+        await vectorDB.deleteIndex({ indexName: duplicateIndexName });
       }
     });
   });

package/src/vector/index.ts

@@ -1,4 +1,15 @@
-import type { CreateIndexParams, IndexStats, QueryResult, QueryVectorParams, UpsertVectorParams } from '@mastra/core';
+import type {
+  CreateIndexParams,
+  DeleteIndexParams,
+  DeleteVectorParams,
+  DescribeIndexParams,
+  IndexStats,
+  ParamsToArgs,
+  QueryResult,
+  QueryVectorParams,
+  UpdateVectorParams,
+  UpsertVectorParams,
+} from '@mastra/core';
 import { MastraVector } from '@mastra/core/vector';
 import type { VectorFilter } from '@mastra/core/vector/filter';
 import { Client as OpenSearchClient } from '@opensearch-project/opensearch';
@@ -19,8 +30,33 @@ const REVERSE_METRIC_MAPPING = {
 export class OpenSearchVector extends MastraVector {
   private client: OpenSearchClient;
 
-  constructor(url: string) {
+  /**
+   * @deprecated Passing a string URL is deprecated. Use an object parameter: { url }.
+   * @param url - The OpenSearch node URL (deprecated)
+   */
+  constructor(url: string);
+  /**
+   * Creates a new OpenSearchVector client.
+   *
+   * @param params - An object with a url property specifying the OpenSearch node.
+   */
+  constructor(params: { url: string });
+  constructor(paramsOrUrl: { url: string } | string) {
     super();
+    let url: string;
+    if (typeof paramsOrUrl === 'string') {
+      // Deprecation warning for positional argument
+      if (typeof console !== 'undefined' && console.warn) {
+        console.warn(
+          'Deprecation Warning: OpenSearchVector constructor positional arguments are deprecated. Please use a single object parameter instead. This signature will be removed on May 20th, 2025.',
+        );
+      }
+      url = paramsOrUrl;
+    } else if (typeof paramsOrUrl === 'object' && paramsOrUrl !== null && 'url' in paramsOrUrl) {
+      url = paramsOrUrl.url;
+    } else {
+      throw new Error('Invalid parameters for OpenSearchVector constructor. Expected { url: string }.');
+    }
     this.client = new OpenSearchClient({ node: url });
   }
 
@@ -93,7 +129,17 @@ export class OpenSearchVector extends MastraVector {
     }
   }
 
-  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 { body: indexInfo } = await this.client.indices.get({ index: indexName });
     const mappings = indexInfo[indexName]?.mappings;
     const embedding: any = mappings?.properties?.embedding;
@@ -114,7 +160,10 @@ export class OpenSearchVector extends MastraVector {
    * @param {string} indexName - The name of the index to delete.
    * @returns {Promise<void>} A promise that resolves when the index is deleted.
    */
-  async deleteIndex(indexName: string): Promise<void> {
+  async deleteIndex(...args: ParamsToArgs<DeleteIndexParams>): Promise<void> {
+    const params = this.normalizeArgs<DeleteIndexParams>('deleteIndex', args);
+
+    const { indexName } = params;
     try {
       await this.client.indices.delete({ index: indexName });
     } catch (error) {
@@ -138,7 +187,7 @@ export class OpenSearchVector extends MastraVector {
     const operations = [];
 
     // Get index stats to check dimension
-    const indexInfo = await this.describeIndex(indexName);
+    const indexInfo = await this.describeIndex({ indexName });
 
     // Validate vector dimensions
     this.validateVectorDimensions(vectors, indexInfo.dimension);
@@ -244,23 +293,43 @@ export class OpenSearchVector extends MastraVector {
   }
 
   /**
-   * Updates a specific document in the index by ID.
+   * @deprecated Use {@link updateVector} instead. This method will be removed on May 20th, 2025.
    *
-   * @param {string} indexName - The name of the index containing the document.
-   * @param {string} id - The ID of the document to update.
-   * @param {Object} update - The update to apply to the document.
-   * @param {number[]} [update.vector] - Optional new vector to update.
-   * @param {Record<string, any>} [update.metadata] - Optional new metadata to update.
-   * @returns {Promise<void>} A promise that resolves when the document is updated.
+   * 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>;
-    },
+    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;
     if (!update.vector && !update.metadata) {
       throw new Error('No updates provided');
     }
@@ -288,7 +357,7 @@ export class OpenSearchVector extends MastraVector {
       // Update vector if provided
       if (update.vector) {
         // Get index stats to check dimension
-        const indexInfo = await this.describeIndex(indexName);
+        const indexInfo = await this.describeIndex({ indexName });
 
         // Validate vector dimensions
         this.validateVectorDimensions([update.vector], indexInfo.dimension);
@@ -319,13 +388,33 @@ export class OpenSearchVector extends MastraVector {
   }
 
   /**
-   * Deletes a specific document from the index by ID.
+   * @deprecated Use {@link deleteVector} instead. This method will be removed on May 20th, 2025.
    *
-   * @param {string} indexName - The name of the index containing the document.
-   * @param {string} id - The ID of the document to delete.
-   * @returns {Promise<void>} A promise that resolves when the document is deleted.
+   * 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.
+   * @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 deleteVector(...args: ParamsToArgs<DeleteVectorParams>): Promise<void> {
+    const params = this.normalizeArgs<DeleteVectorParams>('deleteVector', args);
+    const { indexName, id } = params;
     try {
       await this.client.delete({
         index: indexName,