@mastra/vectorize 0.2.11-alpha.0 → 0.3.0-alpha.1

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

@@ -7,7 +7,6 @@ import type { DescribeIndexParams } from '@mastra/core/vector';
 import type { IndexStats } from '@mastra/core/vector';
 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 { QueryVectorParams } from '@mastra/core/vector';
 import type { UpdateVectorParams } from '@mastra/core/vector';
@@ -22,26 +21,23 @@ declare class CloudflareVector extends MastraVector {
         apiToken: string;
     });
     get indexSeparator(): string;
-    upsert(...args: ParamsToArgs<UpsertVectorParams>): Promise<string[]>;
+    upsert({ indexName, vectors, metadata, ids }: UpsertVectorParams): Promise<string[]>;
     transformFilter(filter?: VectorFilter): VectorFilter;
-    createIndex(...args: ParamsToArgs<CreateIndexParams>): Promise<void>;
-    query(...args: ParamsToArgs<QueryVectorParams>): Promise<QueryResult[]>;
+    createIndex({ indexName, dimension, metric }: CreateIndexParams): Promise<void>;
+    query({ indexName, queryVector, topK, filter, includeVector, }: QueryVectorParams): Promise<QueryResult[]>;
     listIndexes(): Promise<string[]>;
     /**
      * Retrieves statistics about a vector index.
      *
-     * @param params - The parameters for describing an index
-     * @param params.indexName - The name of the index to describe
+     * @param {string} indexName - The name of the index to describe
      * @returns A promise that resolves to the index statistics including dimension, count and metric
      */
-    describeIndex(...args: ParamsToArgs<DescribeIndexParams>): Promise<IndexStats>;
-    deleteIndex(...args: ParamsToArgs<DeleteIndexParams>): Promise<void>;
+    describeIndex({ indexName }: DescribeIndexParams): Promise<IndexStats>;
+    deleteIndex({ indexName }: DeleteIndexParams): Promise<void>;
     createMetadataIndex(indexName: string, propertyName: string, indexType: 'string' | 'number' | 'boolean'): Promise<void>;
     deleteMetadataIndex(indexName: string, propertyName: string): Promise<void>;
     listMetadataIndexes(indexName: string): Promise<Cloudflare.Vectorize.Indexes.MetadataIndex.MetadataIndexListResponse.MetadataIndex[]>;
     /**
-     * @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.
@@ -51,31 +47,7 @@ declare class CloudflareVector extends MastraVector {
      * @returns A promise that resolves when the update is complete.
      * @throws Will throw an error if no updates are provided or if the update operation fails.
      */
-    updateIndexById(indexName: string, id: string, update: {
-        vector?: number[];
-        metadata?: Record<string, any>;
-    }): Promise<void>;
-    /**
-     * Updates a vector by its ID with the provided vector and/or metadata.
-     * @param indexName - The name of the index containing the vector.
-     * @param id - The ID of the vector to update.
-     * @param update - An object containing the vector and/or metadata to update.
-     * @param update.vector - An optional array of numbers representing the new vector.
-     * @param update.metadata - An optional record containing the new metadata.
-     * @returns A promise that resolves when the update is complete.
-     * @throws Will throw an error if no updates are provided or if the update operation fails.
-     */
-    updateVector(...args: ParamsToArgs<UpdateVectorParams>): Promise<void>;
-    /**
-     * @deprecated Use {@link deleteVector} instead. This method will be removed on May 20th, 2025.
-     *
-     * Deletes a vector by its ID.
-     * @param indexName - The name of the index containing the vector.
-     * @param id - The ID of the vector to delete.
-     * @returns A promise that resolves when the deletion is complete.
-     * @throws Will throw an error if the deletion operation fails.
-     */
-    deleteIndexById(indexName: string, id: string): Promise<void>;
+    updateVector({ indexName, id, update }: UpdateVectorParams): Promise<void>;
     /**
      * Deletes a vector by its ID.
      * @param indexName - The name of the index containing the vector.
@@ -83,7 +55,7 @@ declare class CloudflareVector extends MastraVector {
      * @returns A promise that resolves when the deletion is complete.
      * @throws Will throw an error if the deletion operation fails.
      */
-    deleteVector(...args: ParamsToArgs<DeleteVectorParams>): Promise<void>;
+    deleteVector({ indexName, id }: DeleteVectorParams): Promise<void>;
 }
 export { CloudflareVector }
 export { CloudflareVector as CloudflareVector_alias_1 }

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

@@ -7,7 +7,6 @@ import type { DescribeIndexParams } from '@mastra/core/vector';
 import type { IndexStats } from '@mastra/core/vector';
 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 { QueryVectorParams } from '@mastra/core/vector';
 import type { UpdateVectorParams } from '@mastra/core/vector';
@@ -22,26 +21,23 @@ declare class CloudflareVector extends MastraVector {
         apiToken: string;
     });
     get indexSeparator(): string;
-    upsert(...args: ParamsToArgs<UpsertVectorParams>): Promise<string[]>;
+    upsert({ indexName, vectors, metadata, ids }: UpsertVectorParams): Promise<string[]>;
     transformFilter(filter?: VectorFilter): VectorFilter;
-    createIndex(...args: ParamsToArgs<CreateIndexParams>): Promise<void>;
-    query(...args: ParamsToArgs<QueryVectorParams>): Promise<QueryResult[]>;
+    createIndex({ indexName, dimension, metric }: CreateIndexParams): Promise<void>;
+    query({ indexName, queryVector, topK, filter, includeVector, }: QueryVectorParams): Promise<QueryResult[]>;
     listIndexes(): Promise<string[]>;
     /**
      * Retrieves statistics about a vector index.
      *
-     * @param params - The parameters for describing an index
-     * @param params.indexName - The name of the index to describe
+     * @param {string} indexName - The name of the index to describe
      * @returns A promise that resolves to the index statistics including dimension, count and metric
      */
-    describeIndex(...args: ParamsToArgs<DescribeIndexParams>): Promise<IndexStats>;
-    deleteIndex(...args: ParamsToArgs<DeleteIndexParams>): Promise<void>;
+    describeIndex({ indexName }: DescribeIndexParams): Promise<IndexStats>;
+    deleteIndex({ indexName }: DeleteIndexParams): Promise<void>;
     createMetadataIndex(indexName: string, propertyName: string, indexType: 'string' | 'number' | 'boolean'): Promise<void>;
     deleteMetadataIndex(indexName: string, propertyName: string): Promise<void>;
     listMetadataIndexes(indexName: string): Promise<Cloudflare.Vectorize.Indexes.MetadataIndex.MetadataIndexListResponse.MetadataIndex[]>;
     /**
-     * @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.
@@ -51,31 +47,7 @@ declare class CloudflareVector extends MastraVector {
      * @returns A promise that resolves when the update is complete.
      * @throws Will throw an error if no updates are provided or if the update operation fails.
      */
-    updateIndexById(indexName: string, id: string, update: {
-        vector?: number[];
-        metadata?: Record<string, any>;
-    }): Promise<void>;
-    /**
-     * Updates a vector by its ID with the provided vector and/or metadata.
-     * @param indexName - The name of the index containing the vector.
-     * @param id - The ID of the vector to update.
-     * @param update - An object containing the vector and/or metadata to update.
-     * @param update.vector - An optional array of numbers representing the new vector.
-     * @param update.metadata - An optional record containing the new metadata.
-     * @returns A promise that resolves when the update is complete.
-     * @throws Will throw an error if no updates are provided or if the update operation fails.
-     */
-    updateVector(...args: ParamsToArgs<UpdateVectorParams>): Promise<void>;
-    /**
-     * @deprecated Use {@link deleteVector} instead. This method will be removed on May 20th, 2025.
-     *
-     * Deletes a vector by its ID.
-     * @param indexName - The name of the index containing the vector.
-     * @param id - The ID of the vector to delete.
-     * @returns A promise that resolves when the deletion is complete.
-     * @throws Will throw an error if the deletion operation fails.
-     */
-    deleteIndexById(indexName: string, id: string): Promise<void>;
+    updateVector({ indexName, id, update }: UpdateVectorParams): Promise<void>;
     /**
      * Deletes a vector by its ID.
      * @param indexName - The name of the index containing the vector.
@@ -83,7 +55,7 @@ declare class CloudflareVector extends MastraVector {
      * @returns A promise that resolves when the deletion is complete.
      * @throws Will throw an error if the deletion operation fails.
      */
-    deleteVector(...args: ParamsToArgs<DeleteVectorParams>): Promise<void>;
+    deleteVector({ indexName, id }: DeleteVectorParams): Promise<void>;
 }
 export { CloudflareVector }
 export { CloudflareVector as CloudflareVector_alias_1 }

package/dist/index.cjs

@@ -77,9 +77,7 @@ var CloudflareVector = class extends vector.MastraVector {
   get indexSeparator() {
     return "-";
   }
-  async upsert(...args) {
-    const params = this.normalizeArgs("upsert", args);
-    const { indexName, vectors, metadata, ids } = params;
+  async upsert({ indexName, vectors, metadata, ids }) {
     const generatedIds = ids || vectors.map(() => crypto.randomUUID());
     const ndjson = vectors.map(
       (vector, index) => JSON.stringify({
@@ -104,9 +102,7 @@ var CloudflareVector = class extends vector.MastraVector {
     const translator = new VectorizeFilterTranslator();
     return translator.translate(filter);
   }
-  async createIndex(...args) {
-    const params = this.normalizeArgs("createIndex", args);
-    const { indexName, dimension, metric = "cosine" } = params;
+  async createIndex({ indexName, dimension, metric = "cosine" }) {
     try {
       await this.client.vectorize.indexes.create({
         account_id: this.accountId,
@@ -125,9 +121,13 @@ var CloudflareVector = class extends vector.MastraVector {
       throw error;
     }
   }
-  async query(...args) {
-    const params = this.normalizeArgs("query", args);
-    const { indexName, queryVector, topK = 10, filter, includeVector = false } = params;
+  async query({
+    indexName,
+    queryVector,
+    topK = 10,
+    filter,
+    includeVector = false
+  }) {
     const translatedFilter = this.transformFilter(filter) ?? {};
     const response = await this.client.vectorize.indexes.query(indexName, {
       account_id: this.accountId,
@@ -155,13 +155,10 @@ var CloudflareVector = class extends vector.MastraVector {
   /**
    * Retrieves statistics about a vector index.
    *
-   * @param params - The parameters for describing an index
-   * @param params.indexName - The name of the index to describe
+   * @param {string} indexName - The name of the index to describe
    * @returns A promise that resolves to the index statistics including dimension, count and metric
    */
-  async describeIndex(...args) {
-    const params = this.normalizeArgs("describeIndex", args);
-    const { indexName } = params;
+  async describeIndex({ indexName }) {
     const index = await this.client.vectorize.indexes.get(indexName, {
       account_id: this.accountId
     });
@@ -176,9 +173,7 @@ var CloudflareVector = class extends vector.MastraVector {
       metric: index?.config?.metric
     };
   }
-  async deleteIndex(...args) {
-    const params = this.normalizeArgs("deleteIndex", args);
-    const { indexName } = params;
+  async deleteIndex({ indexName }) {
     await this.client.vectorize.indexes.delete(indexName, {
       account_id: this.accountId
     });
@@ -203,8 +198,6 @@ var CloudflareVector = class extends vector.MastraVector {
     return res?.metadataIndexes ?? [];
   }
   /**
-   * @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.
@@ -214,27 +207,7 @@ var CloudflareVector = class extends vector.MastraVector {
    * @returns A promise that resolves when the update is complete.
    * @throws Will throw an error if no updates are provided or if the update operation fails.
    */
-  async updateIndexById(indexName, id, update) {
-    this.logger.warn(
-      `Deprecation Warning: updateIndexById() is deprecated. 
-      Please use updateVector() instead. 
-      updateIndexById() will be removed on May 20th, 2025.`
-    );
-    await this.updateVector({ indexName, id, update });
-  }
-  /**
-   * Updates a vector by its ID with the provided vector and/or metadata.
-   * @param indexName - The name of the index containing the vector.
-   * @param id - The ID of the vector to update.
-   * @param update - An object containing the vector and/or metadata to update.
-   * @param update.vector - An optional array of numbers representing the new vector.
-   * @param update.metadata - An optional record containing the new metadata.
-   * @returns A promise that resolves when the update is complete.
-   * @throws Will throw an error if no updates are provided or if the update operation fails.
-   */
-  async updateVector(...args) {
-    const params = this.normalizeArgs("updateVector", args);
-    const { indexName, id, update } = params;
+  async updateVector({ indexName, id, update }) {
     try {
       if (!update.vector && !update.metadata) {
         throw new Error("No update data provided");
@@ -252,23 +225,6 @@ var CloudflareVector = class extends vector.MastraVector {
       throw new Error(`Failed to update vector by id: ${id} for index name: ${indexName}: ${error.message}`);
     }
   }
-  /**
-   * @deprecated Use {@link deleteVector} instead. This method will be removed on May 20th, 2025.
-   *
-   * Deletes a vector by its ID.
-   * @param indexName - The name of the index containing the vector.
-   * @param id - The ID of the vector to delete.
-   * @returns A promise that resolves when the deletion is complete.
-   * @throws Will throw an error if the deletion operation fails.
-   */
-  async deleteIndexById(indexName, id) {
-    this.logger.warn(
-      `Deprecation Warning: deleteIndexById() is deprecated. 
-      Please use deleteVector() instead. 
-      deleteIndexById() will be removed on May 20th, 2025.`
-    );
-    await this.deleteVector({ indexName, id });
-  }
   /**
    * Deletes a vector by its ID.
    * @param indexName - The name of the index containing the vector.
@@ -276,9 +232,7 @@ var CloudflareVector = class extends vector.MastraVector {
    * @returns A promise that resolves when the deletion is complete.
    * @throws Will throw an error if the deletion operation fails.
    */
-  async deleteVector(...args) {
-    const params = this.normalizeArgs("deleteVector", args);
-    const { indexName, id } = params;
+  async deleteVector({ indexName, id }) {
     try {
       await this.client.vectorize.indexes.deleteByIds(indexName, {
         ids: [id],

package/dist/index.js

@@ -71,9 +71,7 @@ var CloudflareVector = class extends MastraVector {
   get indexSeparator() {
     return "-";
   }
-  async upsert(...args) {
-    const params = this.normalizeArgs("upsert", args);
-    const { indexName, vectors, metadata, ids } = params;
+  async upsert({ indexName, vectors, metadata, ids }) {
     const generatedIds = ids || vectors.map(() => crypto.randomUUID());
     const ndjson = vectors.map(
       (vector, index) => JSON.stringify({
@@ -98,9 +96,7 @@ var CloudflareVector = class extends MastraVector {
     const translator = new VectorizeFilterTranslator();
     return translator.translate(filter);
   }
-  async createIndex(...args) {
-    const params = this.normalizeArgs("createIndex", args);
-    const { indexName, dimension, metric = "cosine" } = params;
+  async createIndex({ indexName, dimension, metric = "cosine" }) {
     try {
       await this.client.vectorize.indexes.create({
         account_id: this.accountId,
@@ -119,9 +115,13 @@ var CloudflareVector = class extends MastraVector {
       throw error;
     }
   }
-  async query(...args) {
-    const params = this.normalizeArgs("query", args);
-    const { indexName, queryVector, topK = 10, filter, includeVector = false } = params;
+  async query({
+    indexName,
+    queryVector,
+    topK = 10,
+    filter,
+    includeVector = false
+  }) {
     const translatedFilter = this.transformFilter(filter) ?? {};
     const response = await this.client.vectorize.indexes.query(indexName, {
       account_id: this.accountId,
@@ -149,13 +149,10 @@ var CloudflareVector = class extends MastraVector {
   /**
    * Retrieves statistics about a vector index.
    *
-   * @param params - The parameters for describing an index
-   * @param params.indexName - The name of the index to describe
+   * @param {string} indexName - The name of the index to describe
    * @returns A promise that resolves to the index statistics including dimension, count and metric
    */
-  async describeIndex(...args) {
-    const params = this.normalizeArgs("describeIndex", args);
-    const { indexName } = params;
+  async describeIndex({ indexName }) {
     const index = await this.client.vectorize.indexes.get(indexName, {
       account_id: this.accountId
     });
@@ -170,9 +167,7 @@ var CloudflareVector = class extends MastraVector {
       metric: index?.config?.metric
     };
   }
-  async deleteIndex(...args) {
-    const params = this.normalizeArgs("deleteIndex", args);
-    const { indexName } = params;
+  async deleteIndex({ indexName }) {
     await this.client.vectorize.indexes.delete(indexName, {
       account_id: this.accountId
     });
@@ -197,8 +192,6 @@ var CloudflareVector = class extends MastraVector {
     return res?.metadataIndexes ?? [];
   }
   /**
-   * @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.
@@ -208,27 +201,7 @@ var CloudflareVector = class extends MastraVector {
    * @returns A promise that resolves when the update is complete.
    * @throws Will throw an error if no updates are provided or if the update operation fails.
    */
-  async updateIndexById(indexName, id, update) {
-    this.logger.warn(
-      `Deprecation Warning: updateIndexById() is deprecated. 
-      Please use updateVector() instead. 
-      updateIndexById() will be removed on May 20th, 2025.`
-    );
-    await this.updateVector({ indexName, id, update });
-  }
-  /**
-   * Updates a vector by its ID with the provided vector and/or metadata.
-   * @param indexName - The name of the index containing the vector.
-   * @param id - The ID of the vector to update.
-   * @param update - An object containing the vector and/or metadata to update.
-   * @param update.vector - An optional array of numbers representing the new vector.
-   * @param update.metadata - An optional record containing the new metadata.
-   * @returns A promise that resolves when the update is complete.
-   * @throws Will throw an error if no updates are provided or if the update operation fails.
-   */
-  async updateVector(...args) {
-    const params = this.normalizeArgs("updateVector", args);
-    const { indexName, id, update } = params;
+  async updateVector({ indexName, id, update }) {
     try {
       if (!update.vector && !update.metadata) {
         throw new Error("No update data provided");
@@ -246,23 +219,6 @@ var CloudflareVector = class extends MastraVector {
       throw new Error(`Failed to update vector by id: ${id} for index name: ${indexName}: ${error.message}`);
     }
   }
-  /**
-   * @deprecated Use {@link deleteVector} instead. This method will be removed on May 20th, 2025.
-   *
-   * Deletes a vector by its ID.
-   * @param indexName - The name of the index containing the vector.
-   * @param id - The ID of the vector to delete.
-   * @returns A promise that resolves when the deletion is complete.
-   * @throws Will throw an error if the deletion operation fails.
-   */
-  async deleteIndexById(indexName, id) {
-    this.logger.warn(
-      `Deprecation Warning: deleteIndexById() is deprecated. 
-      Please use deleteVector() instead. 
-      deleteIndexById() will be removed on May 20th, 2025.`
-    );
-    await this.deleteVector({ indexName, id });
-  }
   /**
    * Deletes a vector by its ID.
    * @param indexName - The name of the index containing the vector.
@@ -270,9 +226,7 @@ var CloudflareVector = class extends MastraVector {
    * @returns A promise that resolves when the deletion is complete.
    * @throws Will throw an error if the deletion operation fails.
    */
-  async deleteVector(...args) {
-    const params = this.normalizeArgs("deleteVector", args);
-    const { indexName, id } = params;
+  async deleteVector({ indexName, id }) {
     try {
       await this.client.vectorize.indexes.deleteByIds(indexName, {
         ids: [id],

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mastra/vectorize",
-  "version": "0.2.11-alpha.0",
+  "version": "0.3.0-alpha.1",
   "description": "Cloudflare Vectorize store provider for Mastra",
   "type": "module",
   "files": [
@@ -23,8 +23,7 @@
   },
   "license": "MIT",
   "dependencies": {
-    "cloudflare": "^4.1.0",
-    "@mastra/core": "^0.9.5-alpha.0"
+    "cloudflare": "^4.1.0"
   },
   "devDependencies": {
     "@microsoft/api-extractor": "^7.52.5",
@@ -34,7 +33,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",