@mastra/pinecone 0.2.14-alpha.0 → 0.3.0-alpha.1

package/.turbo/turbo-build.log

@@ -1,23 +1,23 @@
 
-> @mastra/pinecone@0.2.14-alpha.0 build /home/runner/work/mastra/mastra/stores/pinecone
+> @mastra/pinecone@0.3.0-alpha.1 build /home/runner/work/mastra/mastra/stores/pinecone
 > 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 6087ms
+TSC ⚡️ Build success in 8231ms
 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/pinecone/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/pinecone/dist/_tsup-dts-rollup.d.cts
-DTS ⚡️ Build success in 8467ms
+DTS ⚡️ Build success in 10007ms
 CLI Cleaning output folder
 ESM Build start
 CJS Build start
-CJS dist/index.cjs 15.44 KB
-CJS ⚡️ Build success in 493ms
-ESM dist/index.js 15.38 KB
-ESM ⚡️ Build success in 494ms
+ESM dist/index.js 12.38 KB
+ESM ⚡️ Build success in 683ms
+CJS dist/index.cjs 12.45 KB
+CJS ⚡️ Build success in 682ms

package/CHANGELOG.md

@@ -1,5 +1,26 @@
 # @mastra/pinecone
 
+## 0.3.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.2.14-alpha.0
 
 ### Patch Changes

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

@@ -1,21 +1,16 @@
 import { BaseFilterTranslator } from '@mastra/core/vector/filter';
 import type { CreateIndexParams } from '@mastra/core/vector';
 import type { DeleteIndexParams } from '@mastra/core/vector';
-import type { DeleteVectorArgs } 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 { IndexStatsDescription } from '@pinecone-database/pinecone';
 import { MastraVector } from '@mastra/core/vector';
 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 { RecordSparseValues } from '@pinecone-database/pinecone';
-import type { UpdateVectorArgs } 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';
 
@@ -27,8 +22,6 @@ declare const PINECONE_PROMPT = "When querying Pinecone, you can ONLY use the op
 export { PINECONE_PROMPT }
 export { PINECONE_PROMPT as PINECONE_PROMPT_alias_1 }
 
-declare type PineconeDeleteVectorArgs = [...DeleteVectorArgs, string?];
-
 declare interface PineconeDeleteVectorParams extends DeleteVectorParams {
     namespace?: string;
 }
@@ -44,21 +37,15 @@ declare interface PineconeIndexStats extends IndexStats {
     namespaces?: IndexStatsDescription['namespaces'];
 }
 
-declare type PineconeQueryVectorArgs = [...QueryVectorArgs, string?, RecordSparseValues?];
-
 declare interface PineconeQueryVectorParams extends QueryVectorParams {
     namespace?: string;
     sparseVector?: RecordSparseValues;
 }
 
-declare type PineconeUpdateVectorArgs = [...UpdateVectorArgs, string?];
-
 declare interface PineconeUpdateVectorParams extends UpdateVectorParams {
     namespace?: string;
 }
 
-declare type PineconeUpsertVectorArgs = [...UpsertVectorArgs, string?, RecordSparseValues[]?];
-
 declare interface PineconeUpsertVectorParams extends UpsertVectorParams {
     namespace?: string;
     sparseVectors?: RecordSparseValues[];
@@ -66,37 +53,30 @@ declare interface PineconeUpsertVectorParams extends UpsertVectorParams {
 
 declare class PineconeVector extends MastraVector {
     private client;
-    /**
-     * @deprecated Passing apiKey and environment as positional arguments is deprecated.
-     * Use the object parameter instead. This signature will be removed on May 20th, 2025.
-     */
-    constructor(apiKey: string, environment?: string);
     /**
      * Creates a new PineconeVector client.
-     * @param params - An object with apiKey and optional environment.
+     * @param apiKey - The API key for Pinecone.
+     * @param environment - The environment for Pinecone.
      */
-    constructor(params: {
+    constructor({ apiKey, environment }: {
         apiKey: string;
         environment?: string;
     });
     get indexSeparator(): string;
-    createIndex(...args: ParamsToArgs<CreateIndexParams>): Promise<void>;
-    upsert(...args: ParamsToArgs<PineconeUpsertVectorParams> | PineconeUpsertVectorArgs): Promise<string[]>;
+    createIndex({ indexName, dimension, metric }: CreateIndexParams): Promise<void>;
+    upsert({ indexName, vectors, metadata, ids, namespace, sparseVectors, }: PineconeUpsertVectorParams): Promise<string[]>;
     transformFilter(filter?: VectorFilter): VectorFilter;
-    query(...args: ParamsToArgs<PineconeQueryVectorParams> | PineconeQueryVectorArgs): Promise<QueryResult[]>;
+    query({ indexName, queryVector, topK, filter, includeVector, namespace, sparseVector, }: PineconeQueryVectorParams): 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<PineconeIndexStats>;
-    deleteIndex(...args: ParamsToArgs<DeleteIndexParams>): Promise<void>;
+    describeIndex({ indexName }: DescribeIndexParams): Promise<PineconeIndexStats>;
+    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.
@@ -107,33 +87,7 @@ declare class PineconeVector 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>;
-    }, namespace?: string): 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.
-     * @param namespace - The namespace of the index (optional).
-     * @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<PineconeUpdateVectorParams> | PineconeUpdateVectorArgs): 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.
-     * @param namespace - The namespace of the index (optional).
-     * @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, namespace?: string): Promise<void>;
+    updateVector({ indexName, id, update, namespace }: PineconeUpdateVectorParams): Promise<void>;
     /**
      * Deletes a vector by its ID.
      * @param indexName - The name of the index containing the vector.
@@ -142,7 +96,7 @@ declare class PineconeVector 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<PineconeDeleteVectorParams> | PineconeDeleteVectorArgs): Promise<void>;
+    deleteVector({ indexName, id, namespace }: PineconeDeleteVectorParams): Promise<void>;
 }
 export { PineconeVector }
 export { PineconeVector as PineconeVector_alias_1 }

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

@@ -1,21 +1,16 @@
 import { BaseFilterTranslator } from '@mastra/core/vector/filter';
 import type { CreateIndexParams } from '@mastra/core/vector';
 import type { DeleteIndexParams } from '@mastra/core/vector';
-import type { DeleteVectorArgs } 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 { IndexStatsDescription } from '@pinecone-database/pinecone';
 import { MastraVector } from '@mastra/core/vector';
 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 { RecordSparseValues } from '@pinecone-database/pinecone';
-import type { UpdateVectorArgs } 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';
 
@@ -27,8 +22,6 @@ declare const PINECONE_PROMPT = "When querying Pinecone, you can ONLY use the op
 export { PINECONE_PROMPT }
 export { PINECONE_PROMPT as PINECONE_PROMPT_alias_1 }
 
-declare type PineconeDeleteVectorArgs = [...DeleteVectorArgs, string?];
-
 declare interface PineconeDeleteVectorParams extends DeleteVectorParams {
     namespace?: string;
 }
@@ -44,21 +37,15 @@ declare interface PineconeIndexStats extends IndexStats {
     namespaces?: IndexStatsDescription['namespaces'];
 }
 
-declare type PineconeQueryVectorArgs = [...QueryVectorArgs, string?, RecordSparseValues?];
-
 declare interface PineconeQueryVectorParams extends QueryVectorParams {
     namespace?: string;
     sparseVector?: RecordSparseValues;
 }
 
-declare type PineconeUpdateVectorArgs = [...UpdateVectorArgs, string?];
-
 declare interface PineconeUpdateVectorParams extends UpdateVectorParams {
     namespace?: string;
 }
 
-declare type PineconeUpsertVectorArgs = [...UpsertVectorArgs, string?, RecordSparseValues[]?];
-
 declare interface PineconeUpsertVectorParams extends UpsertVectorParams {
     namespace?: string;
     sparseVectors?: RecordSparseValues[];
@@ -66,37 +53,30 @@ declare interface PineconeUpsertVectorParams extends UpsertVectorParams {
 
 declare class PineconeVector extends MastraVector {
     private client;
-    /**
-     * @deprecated Passing apiKey and environment as positional arguments is deprecated.
-     * Use the object parameter instead. This signature will be removed on May 20th, 2025.
-     */
-    constructor(apiKey: string, environment?: string);
     /**
      * Creates a new PineconeVector client.
-     * @param params - An object with apiKey and optional environment.
+     * @param apiKey - The API key for Pinecone.
+     * @param environment - The environment for Pinecone.
      */
-    constructor(params: {
+    constructor({ apiKey, environment }: {
         apiKey: string;
         environment?: string;
     });
     get indexSeparator(): string;
-    createIndex(...args: ParamsToArgs<CreateIndexParams>): Promise<void>;
-    upsert(...args: ParamsToArgs<PineconeUpsertVectorParams> | PineconeUpsertVectorArgs): Promise<string[]>;
+    createIndex({ indexName, dimension, metric }: CreateIndexParams): Promise<void>;
+    upsert({ indexName, vectors, metadata, ids, namespace, sparseVectors, }: PineconeUpsertVectorParams): Promise<string[]>;
     transformFilter(filter?: VectorFilter): VectorFilter;
-    query(...args: ParamsToArgs<PineconeQueryVectorParams> | PineconeQueryVectorArgs): Promise<QueryResult[]>;
+    query({ indexName, queryVector, topK, filter, includeVector, namespace, sparseVector, }: PineconeQueryVectorParams): 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<PineconeIndexStats>;
-    deleteIndex(...args: ParamsToArgs<DeleteIndexParams>): Promise<void>;
+    describeIndex({ indexName }: DescribeIndexParams): Promise<PineconeIndexStats>;
+    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.
@@ -107,33 +87,7 @@ declare class PineconeVector 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>;
-    }, namespace?: string): 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.
-     * @param namespace - The namespace of the index (optional).
-     * @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<PineconeUpdateVectorParams> | PineconeUpdateVectorArgs): 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.
-     * @param namespace - The namespace of the index (optional).
-     * @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, namespace?: string): Promise<void>;
+    updateVector({ indexName, id, update, namespace }: PineconeUpdateVectorParams): Promise<void>;
     /**
      * Deletes a vector by its ID.
      * @param indexName - The name of the index containing the vector.
@@ -142,7 +96,7 @@ declare class PineconeVector 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<PineconeDeleteVectorParams> | PineconeDeleteVectorArgs): Promise<void>;
+    deleteVector({ indexName, id, namespace }: PineconeDeleteVectorParams): Promise<void>;
 }
 export { PineconeVector }
 export { PineconeVector as PineconeVector_alias_1 }

package/dist/index.cjs

@@ -85,28 +85,16 @@ var PineconeFilterTranslator = class extends filter.BaseFilterTranslator {
 // src/vector/index.ts
 var PineconeVector = class extends vector.MastraVector {
   client;
-  constructor(paramsOrApiKey, environment) {
+  /**
+   * Creates a new PineconeVector client.
+   * @param apiKey - The API key for Pinecone.
+   * @param environment - The environment for Pinecone.
+   */
+  constructor({ apiKey, environment }) {
     super();
-    let apiKey;
-    let env;
-    if (typeof paramsOrApiKey === "string") {
-      if (typeof console !== "undefined" && console.warn) {
-        console.warn(
-          `Deprecation Warning: Passing apiKey and environment as positional arguments to PineconeVector constructor is deprecated.
-Please use an object parameter instead:
-  new PineconeVector({ apiKey, environment })
-This signature will be removed on May 20th, 2025.`
-        );
-      }
-      apiKey = paramsOrApiKey;
-      env = environment;
-    } else {
-      apiKey = paramsOrApiKey.apiKey;
-      env = paramsOrApiKey.environment;
-    }
     const opts = { apiKey };
-    if (env) {
-      opts["controllerHostUrl"] = env;
+    if (environment) {
+      opts["controllerHostUrl"] = environment;
     }
     const baseClient = new pinecone.Pinecone(opts);
     const telemetry = this.__getTelemetry();
@@ -120,9 +108,7 @@ This signature will be removed on May 20th, 2025.`
   get indexSeparator() {
     return "-";
   }
-  async createIndex(...args) {
-    const params = this.normalizeArgs("createIndex", args);
-    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");
     }
@@ -150,12 +136,14 @@ This signature will be removed on May 20th, 2025.`
       throw error;
     }
   }
-  async upsert(...args) {
-    const params = this.normalizeArgs("upsert", args, [
-      "namespace",
-      "sparseVectors"
-    ]);
-    const { indexName, vectors, metadata, ids, namespace, sparseVectors } = params;
+  async upsert({
+    indexName,
+    vectors,
+    metadata,
+    ids,
+    namespace,
+    sparseVectors
+  }) {
     const index = this.client.Index(indexName).namespace(namespace || "");
     const vectorIds = ids || vectors.map(() => crypto.randomUUID());
     const records = vectors.map((vector, i) => ({
@@ -175,12 +163,15 @@ This signature will be removed on May 20th, 2025.`
     const translator = new PineconeFilterTranslator();
     return translator.translate(filter);
   }
-  async query(...args) {
-    const params = this.normalizeArgs("query", args, [
-      "namespace",
-      "sparseVector"
-    ]);
-    const { indexName, queryVector, topK = 10, filter, includeVector = false, namespace, sparseVector } = params;
+  async query({
+    indexName,
+    queryVector,
+    topK = 10,
+    filter,
+    includeVector = false,
+    namespace,
+    sparseVector
+  }) {
     const index = this.client.Index(indexName).namespace(namespace || "");
     const translatedFilter = this.transformFilter(filter) ?? void 0;
     const queryParams = {
@@ -208,13 +199,10 @@ This signature will be removed on May 20th, 2025.`
   /**
    * 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 index = this.client.Index(indexName);
     const stats = await index.describeIndexStats();
     const description = await this.client.describeIndex(indexName);
@@ -225,9 +213,7 @@ This signature will be removed on May 20th, 2025.`
       namespaces: stats.namespaces
     };
   }
-  async deleteIndex(...args) {
-    const params = this.normalizeArgs("deleteIndex", args);
-    const { indexName } = params;
+  async deleteIndex({ indexName }) {
     try {
       await this.client.deleteIndex(indexName);
     } catch (error) {
@@ -235,8 +221,6 @@ This signature will be removed on May 20th, 2025.`
     }
   }
   /**
-   * @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.
@@ -247,30 +231,7 @@ This signature will be removed on May 20th, 2025.`
    * @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, namespace) {
-    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, namespace });
-  }
-  /**
-   * 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.
-   * @param namespace - The namespace of the index (optional).
-   * @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, [
-      "namespace"
-    ]);
-    const { indexName, id, update, namespace } = params;
+  async updateVector({ indexName, id, update, namespace }) {
     try {
       if (!update.vector && !update.metadata) {
         throw new Error("No updates provided");
@@ -288,24 +249,6 @@ This signature will be removed on May 20th, 2025.`
       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.
-   * @param namespace - The namespace of the index (optional).
-   * @returns A promise that resolves when the deletion is complete.
-   * @throws Will throw an error if the deletion operation fails.
-   */
-  async deleteIndexById(indexName, id, namespace) {
-    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, namespace });
-  }
   /**
    * Deletes a vector by its ID.
    * @param indexName - The name of the index containing the vector.
@@ -314,11 +257,7 @@ This signature will be removed on May 20th, 2025.`
    * @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, [
-      "namespace"
-    ]);
-    const { indexName, id, namespace } = params;
+  async deleteVector({ indexName, id, namespace }) {
     try {
       const index = this.client.Index(indexName).namespace(namespace || "");
       await index.deleteOne(id);

package/dist/index.js

@@ -83,28 +83,16 @@ var PineconeFilterTranslator = class extends BaseFilterTranslator {
 // src/vector/index.ts
 var PineconeVector = class extends MastraVector {
   client;
-  constructor(paramsOrApiKey, environment) {
+  /**
+   * Creates a new PineconeVector client.
+   * @param apiKey - The API key for Pinecone.
+   * @param environment - The environment for Pinecone.
+   */
+  constructor({ apiKey, environment }) {
     super();
-    let apiKey;
-    let env;
-    if (typeof paramsOrApiKey === "string") {
-      if (typeof console !== "undefined" && console.warn) {
-        console.warn(
-          `Deprecation Warning: Passing apiKey and environment as positional arguments to PineconeVector constructor is deprecated.
-Please use an object parameter instead:
-  new PineconeVector({ apiKey, environment })
-This signature will be removed on May 20th, 2025.`
-        );
-      }
-      apiKey = paramsOrApiKey;
-      env = environment;
-    } else {
-      apiKey = paramsOrApiKey.apiKey;
-      env = paramsOrApiKey.environment;
-    }
     const opts = { apiKey };
-    if (env) {
-      opts["controllerHostUrl"] = env;
+    if (environment) {
+      opts["controllerHostUrl"] = environment;
     }
     const baseClient = new Pinecone(opts);
     const telemetry = this.__getTelemetry();
@@ -118,9 +106,7 @@ This signature will be removed on May 20th, 2025.`
   get indexSeparator() {
     return "-";
   }
-  async createIndex(...args) {
-    const params = this.normalizeArgs("createIndex", args);
-    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");
     }
@@ -148,12 +134,14 @@ This signature will be removed on May 20th, 2025.`
       throw error;
     }
   }
-  async upsert(...args) {
-    const params = this.normalizeArgs("upsert", args, [
-      "namespace",
-      "sparseVectors"
-    ]);
-    const { indexName, vectors, metadata, ids, namespace, sparseVectors } = params;
+  async upsert({
+    indexName,
+    vectors,
+    metadata,
+    ids,
+    namespace,
+    sparseVectors
+  }) {
     const index = this.client.Index(indexName).namespace(namespace || "");
     const vectorIds = ids || vectors.map(() => crypto.randomUUID());
     const records = vectors.map((vector, i) => ({
@@ -173,12 +161,15 @@ This signature will be removed on May 20th, 2025.`
     const translator = new PineconeFilterTranslator();
     return translator.translate(filter);
   }
-  async query(...args) {
-    const params = this.normalizeArgs("query", args, [
-      "namespace",
-      "sparseVector"
-    ]);
-    const { indexName, queryVector, topK = 10, filter, includeVector = false, namespace, sparseVector } = params;
+  async query({
+    indexName,
+    queryVector,
+    topK = 10,
+    filter,
+    includeVector = false,
+    namespace,
+    sparseVector
+  }) {
     const index = this.client.Index(indexName).namespace(namespace || "");
     const translatedFilter = this.transformFilter(filter) ?? void 0;
     const queryParams = {
@@ -206,13 +197,10 @@ This signature will be removed on May 20th, 2025.`
   /**
    * 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 index = this.client.Index(indexName);
     const stats = await index.describeIndexStats();
     const description = await this.client.describeIndex(indexName);
@@ -223,9 +211,7 @@ This signature will be removed on May 20th, 2025.`
       namespaces: stats.namespaces
     };
   }
-  async deleteIndex(...args) {
-    const params = this.normalizeArgs("deleteIndex", args);
-    const { indexName } = params;
+  async deleteIndex({ indexName }) {
     try {
       await this.client.deleteIndex(indexName);
     } catch (error) {
@@ -233,8 +219,6 @@ This signature will be removed on May 20th, 2025.`
     }
   }
   /**
-   * @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.
@@ -245,30 +229,7 @@ This signature will be removed on May 20th, 2025.`
    * @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, namespace) {
-    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, namespace });
-  }
-  /**
-   * 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.
-   * @param namespace - The namespace of the index (optional).
-   * @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, [
-      "namespace"
-    ]);
-    const { indexName, id, update, namespace } = params;
+  async updateVector({ indexName, id, update, namespace }) {
     try {
       if (!update.vector && !update.metadata) {
         throw new Error("No updates provided");
@@ -286,24 +247,6 @@ This signature will be removed on May 20th, 2025.`
       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.
-   * @param namespace - The namespace of the index (optional).
-   * @returns A promise that resolves when the deletion is complete.
-   * @throws Will throw an error if the deletion operation fails.
-   */
-  async deleteIndexById(indexName, id, namespace) {
-    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, namespace });
-  }
   /**
    * Deletes a vector by its ID.
    * @param indexName - The name of the index containing the vector.
@@ -312,11 +255,7 @@ This signature will be removed on May 20th, 2025.`
    * @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, [
-      "namespace"
-    ]);
-    const { indexName, id, namespace } = params;
+  async deleteVector({ indexName, id, namespace }) {
     try {
       const index = this.client.Index(indexName).namespace(namespace || "");
       await index.deleteOne(id);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mastra/pinecone",
-  "version": "0.2.14-alpha.0",
+  "version": "0.3.0-alpha.1",
   "description": "Pinecone vector store provider for Mastra",
   "type": "module",
   "main": "dist/index.js",
@@ -20,8 +20,7 @@
   },
   "license": "MIT",
   "dependencies": {
-    "@pinecone-database/pinecone": "^3.0.3",
-    "@mastra/core": "^0.9.5-alpha.0"
+    "@pinecone-database/pinecone": "^3.0.3"
   },
   "devDependencies": {
     "@microsoft/api-extractor": "^7.52.5",
@@ -31,7 +30,11 @@
     "tsup": "^8.4.0",
     "typescript": "^5.8.2",
     "vitest": "^3.1.2",
-    "@internal/lint": "0.0.5"
+    "@internal/lint": "0.0.5",
+    "@mastra/core": "0.10.0-alpha.1"
+  },
+  "peerDependencies": {
+    "@mastra/core": "^0.9.4"
   },
   "scripts": {
     "build": "tsup src/index.ts --format esm,cjs --experimental-dts --clean --treeshake=smallest --splitting",

package/src/vector/index.test.ts

@@ -1478,144 +1478,4 @@ describe.skip('PineconeVector Integration Tests', () => {
       expect(hybridResults).toHaveLength(1);
     });
   });
-
-  describe('Deprecation Warnings', () => {
-    const indexName = 'testdeprecationwarnings';
-
-    const indexName2 = 'testdeprecationwarnings2';
-
-    const indexName3 = 'testdeprecationwarnings3';
-
-    const indexName4 = 'testdeprecationwarnings4';
-
-    let warnSpy;
-
-    beforeAll(async () => {
-      try {
-        await vectorDB.deleteIndex({ indexName });
-      } catch {
-        // Ignore errors if index doesn't exist
-      }
-      try {
-        await vectorDB.deleteIndex({ indexName: indexName2 });
-      } catch {
-        // Ignore errors if index doesn't exist
-      }
-      try {
-        await vectorDB.deleteIndex({ indexName: indexName3 });
-      } catch {
-        // Ignore errors if index doesn't exist
-      }
-      try {
-        await vectorDB.deleteIndex({ indexName: indexName4 });
-      } catch {
-        // Ignore errors if index doesn't exist
-      }
-      await vectorDB.createIndex({ indexName: indexName, dimension: 3 });
-      await waitUntilReady(vectorDB, indexName);
-    });
-
-    afterAll(async () => {
-      try {
-        await vectorDB.deleteIndex({ indexName });
-      } catch {
-        // Ignore errors if index doesn't exist
-      }
-      try {
-        await vectorDB.deleteIndex({ indexName: indexName2 });
-      } catch {
-        // Ignore errors if index doesn't exist
-      }
-      try {
-        await vectorDB.deleteIndex({ indexName: indexName3 });
-      } catch {
-        // Ignore errors if index doesn't exist
-      }
-      try {
-        await vectorDB.deleteIndex({ indexName: indexName4 });
-      } catch {
-        // Ignore errors if index doesn't exist
-      }
-    });
-
-    beforeEach(async () => {
-      warnSpy = vi.spyOn(vectorDB['logger'], 'warn');
-    });
-
-    afterEach(async () => {
-      warnSpy.mockRestore();
-    });
-
-    it('should show deprecation warning when using individual args for createIndex', async () => {
-      await vectorDB.createIndex(indexName2, 3, 'cosine');
-      await waitUntilReady(vectorDB, indexName2);
-      expect(warnSpy).toHaveBeenCalledWith(
-        expect.stringContaining('Deprecation Warning: Passing individual arguments to createIndex() is deprecated'),
-      );
-    });
-
-    it('should show deprecation warning when using individual args for upsert', async () => {
-      await vectorDB.upsert(indexName, [[1, 2, 3]], [{ test: 'data' }]);
-
-      expect(warnSpy).toHaveBeenCalledWith(
-        expect.stringContaining('Deprecation Warning: Passing individual arguments to upsert() is deprecated'),
-      );
-    });
-
-    it('should show deprecation warning when using individual args for query', async () => {
-      await vectorDB.query(indexName, [1, 2, 3], 5);
-
-      expect(warnSpy).toHaveBeenCalledWith(
-        expect.stringContaining('Deprecation Warning: Passing individual arguments to query() is deprecated'),
-      );
-    });
-
-    it('should not show deprecation warning when using object param for query', async () => {
-      await vectorDB.query({
-        indexName,
-        queryVector: [1, 2, 3],
-        topK: 5,
-      });
-
-      expect(warnSpy).not.toHaveBeenCalled();
-    });
-
-    it('should not show deprecation warning when using object param for createIndex', async () => {
-      await vectorDB.createIndex({
-        indexName: indexName3,
-        dimension: 3,
-        metric: 'cosine',
-      });
-
-      expect(warnSpy).not.toHaveBeenCalled();
-    });
-
-    it('should not show deprecation warning when using object param for upsert', async () => {
-      await vectorDB.upsert({
-        indexName,
-        vectors: [[1, 2, 3]],
-        metadata: [{ test: 'data' }],
-      });
-
-      expect(warnSpy).not.toHaveBeenCalled();
-    });
-
-    it('should maintain backward compatibility with individual args', async () => {
-      // Query
-      const queryResults = await vectorDB.query(indexName, [1, 2, 3], 5);
-      expect(Array.isArray(queryResults)).toBe(true);
-
-      // CreateIndex
-      await expect(vectorDB.createIndex(indexName4, 3, 'cosine')).resolves.not.toThrow();
-      await waitUntilReady(vectorDB, indexName4);
-      // Upsert
-      const upsertResults = await vectorDB.upsert({
-        indexName,
-        vectors: [[1, 2, 3]],
-        metadata: [{ test: 'data' }],
-      });
-      expect(Array.isArray(upsertResults)).toBe(true);
-      expect(upsertResults).toHaveLength(1);
-    });
-  });
 });

package/src/vector/index.ts

@@ -5,15 +5,10 @@ import type {
   CreateIndexParams,
   UpsertVectorParams,
   QueryVectorParams,
-  ParamsToArgs,
-  QueryVectorArgs,
-  UpsertVectorArgs,
   DescribeIndexParams,
   DeleteIndexParams,
   DeleteVectorParams,
-  DeleteVectorArgs,
   UpdateVectorParams,
-  UpdateVectorArgs,
 } from '@mastra/core/vector';
 import type { VectorFilter } from '@mastra/core/vector/filter';
 import { Pinecone } from '@pinecone-database/pinecone';
@@ -35,60 +30,32 @@ interface PineconeQueryVectorParams extends QueryVectorParams {
   sparseVector?: RecordSparseValues;
 }
 
-type PineconeQueryVectorArgs = [...QueryVectorArgs, string?, RecordSparseValues?];
-
 interface PineconeUpsertVectorParams extends UpsertVectorParams {
   namespace?: string;
   sparseVectors?: RecordSparseValues[];
 }
 
-type PineconeUpsertVectorArgs = [...UpsertVectorArgs, string?, RecordSparseValues[]?];
-
 interface PineconeUpdateVectorParams extends UpdateVectorParams {
   namespace?: string;
 }
 
-type PineconeUpdateVectorArgs = [...UpdateVectorArgs, string?];
-
 interface PineconeDeleteVectorParams extends DeleteVectorParams {
   namespace?: string;
 }
 
-type PineconeDeleteVectorArgs = [...DeleteVectorArgs, string?];
-
 export class PineconeVector extends MastraVector {
   private client: Pinecone;
 
-  /**
-   * @deprecated Passing apiKey and environment as positional arguments is deprecated.
-   * Use the object parameter instead. This signature will be removed on May 20th, 2025.
-   */
-  constructor(apiKey: string, environment?: string);
   /**
    * Creates a new PineconeVector client.
-   * @param params - An object with apiKey and optional environment.
+   * @param apiKey - The API key for Pinecone.
+   * @param environment - The environment for Pinecone.
    */
-  constructor(params: { apiKey: string; environment?: string });
-  constructor(paramsOrApiKey: { apiKey: string; environment?: string } | string, environment?: string) {
+  constructor({ apiKey, environment }: { apiKey: string; environment?: string }) {
     super();
-    let apiKey: string;
-    let env: string | undefined;
-    if (typeof paramsOrApiKey === 'string') {
-      // DEPRECATION WARNING
-      if (typeof console !== 'undefined' && console.warn) {
-        console.warn(
-          `Deprecation Warning: Passing apiKey and environment as positional arguments to PineconeVector constructor is deprecated.\nPlease use an object parameter instead:\n  new PineconeVector({ apiKey, environment })\nThis signature will be removed on May 20th, 2025.`,
-        );
-      }
-      apiKey = paramsOrApiKey;
-      env = environment;
-    } else {
-      apiKey = paramsOrApiKey.apiKey;
-      env = paramsOrApiKey.environment;
-    }
     const opts: { apiKey: string; controllerHostUrl?: string } = { apiKey };
-    if (env) {
-      opts['controllerHostUrl'] = env;
+    if (environment) {
+      opts['controllerHostUrl'] = environment;
     }
     const baseClient = new Pinecone(opts);
     const telemetry = this.__getTelemetry();
@@ -105,11 +72,7 @@ export class PineconeVector extends MastraVector {
     return '-';
   }
 
-  async createIndex(...args: ParamsToArgs<CreateIndexParams>): Promise<void> {
-    const params = this.normalizeArgs<CreateIndexParams>('createIndex', args);
-
-    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');
     }
@@ -145,14 +108,14 @@ export class PineconeVector extends MastraVector {
     }
   }
 
-  async upsert(...args: ParamsToArgs<PineconeUpsertVectorParams> | PineconeUpsertVectorArgs): Promise<string[]> {
-    const params = this.normalizeArgs<PineconeUpsertVectorParams, PineconeUpsertVectorArgs>('upsert', args, [
-      'namespace',
-      'sparseVectors',
-    ]);
-
-    const { indexName, vectors, metadata, ids, namespace, sparseVectors } = params;
-
+  async upsert({
+    indexName,
+    vectors,
+    metadata,
+    ids,
+    namespace,
+    sparseVectors,
+  }: PineconeUpsertVectorParams): Promise<string[]> {
     const index = this.client.Index(indexName).namespace(namespace || '');
 
     // Generate IDs if not provided
@@ -180,14 +143,15 @@ export class PineconeVector extends MastraVector {
     return translator.translate(filter);
   }
 
-  async query(...args: ParamsToArgs<PineconeQueryVectorParams> | PineconeQueryVectorArgs): Promise<QueryResult[]> {
-    const params = this.normalizeArgs<PineconeQueryVectorParams, PineconeQueryVectorArgs>('query', args, [
-      'namespace',
-      'sparseVector',
-    ]);
-
-    const { indexName, queryVector, topK = 10, filter, includeVector = false, namespace, sparseVector } = params;
-
+  async query({
+    indexName,
+    queryVector,
+    topK = 10,
+    filter,
+    includeVector = false,
+    namespace,
+    sparseVector,
+  }: PineconeQueryVectorParams): Promise<QueryResult[]> {
     const index = this.client.Index(indexName).namespace(namespace || '');
 
     const translatedFilter = this.transformFilter(filter) ?? undefined;
@@ -223,13 +187,10 @@ export class PineconeVector 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<PineconeIndexStats> {
-    const params = this.normalizeArgs<DescribeIndexParams>('describeIndex', args);
-    const { indexName } = params;
+  async describeIndex({ indexName }: DescribeIndexParams): Promise<PineconeIndexStats> {
     const index = this.client.Index(indexName);
     const stats = await index.describeIndexStats();
     const description = await this.client.describeIndex(indexName);
@@ -242,41 +203,13 @@ export class PineconeVector 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> {
     try {
       await this.client.deleteIndex(indexName);
     } catch (error: any) {
       throw new Error(`Failed to delete Pinecone index: ${error.message}`);
     }
   }
-  /**
-   * @deprecated Use {@link updateVector} instead. This method will be removed on May 20th, 2025.
-   *
-   * Updates a vector by its ID with the provided vector and/or metadata.
-   * @param indexName - The name of the index containing the vector.
-   * @param id - The ID of the vector to update.
-   * @param update - An object containing the vector and/or metadata to update.
-   * @param update.vector - An optional array of numbers representing the new vector.
-   * @param update.metadata - An optional record containing the new metadata.
-   * @param namespace - The namespace of the index (optional).
-   * @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> },
-    namespace?: string,
-  ): 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, namespace });
-  }
 
   /**
    * Updates a vector by its ID with the provided vector and/or metadata.
@@ -289,11 +222,7 @@ export class PineconeVector 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(...args: ParamsToArgs<PineconeUpdateVectorParams> | PineconeUpdateVectorArgs): Promise<void> {
-    const params = this.normalizeArgs<PineconeUpdateVectorParams, PineconeUpdateVectorArgs>('updateVector', args, [
-      'namespace',
-    ]);
-    const { indexName, id, update, namespace } = params;
+  async updateVector({ indexName, id, update, namespace }: PineconeUpdateVectorParams): Promise<void> {
     try {
       if (!update.vector && !update.metadata) {
         throw new Error('No updates provided');
@@ -317,25 +246,6 @@ export class PineconeVector 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.
-   * @param namespace - The namespace of the index (optional).
-   * @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, namespace?: 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, namespace });
-  }
-
   /**
    * Deletes a vector by its ID.
    * @param indexName - The name of the index containing the vector.
@@ -344,11 +254,7 @@ export class PineconeVector 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<PineconeDeleteVectorParams> | PineconeDeleteVectorArgs): Promise<void> {
-    const params = this.normalizeArgs<PineconeDeleteVectorParams, PineconeDeleteVectorArgs>('deleteVector', args, [
-      'namespace',
-    ]);
-    const { indexName, id, namespace } = params;
+  async deleteVector({ indexName, id, namespace }: PineconeDeleteVectorParams): Promise<void> {
     try {
       const index = this.client.Index(indexName).namespace(namespace || '');
       await index.deleteOne(id);