@mastra/vectorize 0.0.0-1.x-tester-20251106055847

package/dist/index.js

@@ -0,0 +1,447 @@
+import { MastraError, ErrorCategory, ErrorDomain } from '@mastra/core/error';
+import { MastraVector } from '@mastra/core/vector';
+import Cloudflare from 'cloudflare';
+import { BaseFilterTranslator } from '@mastra/core/vector/filter';
+
+// src/vector/index.ts
+var VectorizeFilterTranslator = class extends BaseFilterTranslator {
+  getSupportedOperators() {
+    return {
+      ...BaseFilterTranslator.DEFAULT_OPERATORS,
+      logical: [],
+      array: ["$in", "$nin"],
+      element: [],
+      regex: [],
+      custom: []
+    };
+  }
+  translate(filter) {
+    if (this.isEmpty(filter)) return filter;
+    this.validateFilter(filter);
+    return this.translateNode(filter);
+  }
+  translateNode(node, currentPath = "") {
+    if (this.isRegex(node)) {
+      throw new Error("Regex is not supported in Vectorize");
+    }
+    if (this.isPrimitive(node)) return { $eq: this.normalizeComparisonValue(node) };
+    if (Array.isArray(node)) return { $in: this.normalizeArrayValues(node) };
+    const entries = Object.entries(node);
+    const firstEntry = entries[0];
+    if (entries.length === 1 && firstEntry && this.isOperator(firstEntry[0])) {
+      const [operator, value] = firstEntry;
+      return { [operator]: this.normalizeComparisonValue(value) };
+    }
+    const result = {};
+    for (const [key, value] of entries) {
+      const newPath = currentPath ? `${currentPath}.${key}` : key;
+      if (this.isOperator(key)) {
+        result[key] = this.normalizeComparisonValue(value);
+        continue;
+      }
+      if (typeof value === "object" && value !== null && !Array.isArray(value)) {
+        if (Object.keys(value).length === 0) {
+          result[newPath] = this.translateNode(value);
+          continue;
+        }
+        const hasOperators = Object.keys(value).some((k) => this.isOperator(k));
+        if (hasOperators) {
+          result[newPath] = this.translateNode(value);
+        } else {
+          Object.assign(result, this.translateNode(value, newPath));
+        }
+      } else {
+        result[newPath] = this.translateNode(value);
+      }
+    }
+    return result;
+  }
+};
+
+// src/vector/index.ts
+var CloudflareVector = class extends MastraVector {
+  client;
+  accountId;
+  constructor({ accountId, apiToken, id }) {
+    super({ id });
+    this.accountId = accountId;
+    this.client = new Cloudflare({
+      apiToken
+    });
+  }
+  get indexSeparator() {
+    return "-";
+  }
+  async upsert({ indexName, vectors, metadata, ids }) {
+    const generatedIds = ids || vectors.map(() => crypto.randomUUID());
+    const ndjson = vectors.map(
+      (vector, index) => JSON.stringify({
+        id: generatedIds[index],
+        values: vector,
+        metadata: metadata?.[index]
+      })
+    ).join("\n");
+    try {
+      await this.client.vectorize.indexes.upsert(
+        indexName,
+        {
+          account_id: this.accountId,
+          body: ndjson
+        },
+        {
+          __binaryRequest: true
+        }
+      );
+      return generatedIds;
+    } catch (error) {
+      throw new MastraError(
+        {
+          id: "STORAGE_VECTORIZE_VECTOR_UPSERT_FAILED",
+          domain: ErrorDomain.STORAGE,
+          category: ErrorCategory.THIRD_PARTY,
+          details: { indexName, vectorCount: vectors?.length }
+        },
+        error
+      );
+    }
+  }
+  transformFilter(filter) {
+    const translator = new VectorizeFilterTranslator();
+    return translator.translate(filter);
+  }
+  async createIndex({ indexName, dimension, metric = "cosine" }) {
+    try {
+      await this.client.vectorize.indexes.create({
+        account_id: this.accountId,
+        config: {
+          dimensions: dimension,
+          metric: metric === "dotproduct" ? "dot-product" : metric
+        },
+        name: indexName
+      });
+    } catch (error) {
+      const message = error?.errors?.[0]?.message || error?.message;
+      if (error.status === 409 || typeof message === "string" && (message.toLowerCase().includes("already exists") || message.toLowerCase().includes("duplicate"))) {
+        await this.validateExistingIndex(indexName, dimension, metric);
+        return;
+      }
+      throw new MastraError(
+        {
+          id: "STORAGE_VECTORIZE_VECTOR_CREATE_INDEX_FAILED",
+          domain: ErrorDomain.STORAGE,
+          category: ErrorCategory.THIRD_PARTY,
+          details: { indexName, dimension, metric }
+        },
+        error
+      );
+    }
+  }
+  async query({
+    indexName,
+    queryVector,
+    topK = 10,
+    filter,
+    includeVector = false
+  }) {
+    try {
+      const translatedFilter = this.transformFilter(filter) ?? {};
+      const response = await this.client.vectorize.indexes.query(indexName, {
+        account_id: this.accountId,
+        vector: queryVector,
+        returnValues: includeVector,
+        returnMetadata: "all",
+        topK,
+        filter: translatedFilter
+      });
+      return response?.matches?.map((match) => {
+        return {
+          id: match.id,
+          metadata: match.metadata,
+          score: match.score,
+          vector: match.values
+        };
+      }) || [];
+    } catch (error) {
+      throw new MastraError(
+        {
+          id: "STORAGE_VECTORIZE_VECTOR_QUERY_FAILED",
+          domain: ErrorDomain.STORAGE,
+          category: ErrorCategory.THIRD_PARTY,
+          details: { indexName, topK }
+        },
+        error
+      );
+    }
+  }
+  async listIndexes() {
+    try {
+      const res = await this.client.vectorize.indexes.list({
+        account_id: this.accountId
+      });
+      return res?.result?.map((index) => index.name) || [];
+    } catch (error) {
+      throw new MastraError(
+        {
+          id: "STORAGE_VECTORIZE_VECTOR_LIST_INDEXES_FAILED",
+          domain: ErrorDomain.STORAGE,
+          category: ErrorCategory.THIRD_PARTY
+        },
+        error
+      );
+    }
+  }
+  /**
+   * Retrieves statistics about a vector index.
+   *
+   * @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({ indexName }) {
+    try {
+      const index = await this.client.vectorize.indexes.get(indexName, {
+        account_id: this.accountId
+      });
+      const described = await this.client.vectorize.indexes.info(indexName, {
+        account_id: this.accountId
+      });
+      return {
+        dimension: described?.dimensions,
+        // Since vector_count is not available in the response,
+        // we might need a separate API call to get the count if needed
+        count: described?.vectorCount || 0,
+        metric: index?.config?.metric
+      };
+    } catch (error) {
+      throw new MastraError(
+        {
+          id: "STORAGE_VECTORIZE_VECTOR_DESCRIBE_INDEX_FAILED",
+          domain: ErrorDomain.STORAGE,
+          category: ErrorCategory.THIRD_PARTY,
+          details: { indexName }
+        },
+        error
+      );
+    }
+  }
+  async deleteIndex({ indexName }) {
+    try {
+      await this.client.vectorize.indexes.delete(indexName, {
+        account_id: this.accountId
+      });
+    } catch (error) {
+      throw new MastraError(
+        {
+          id: "STORAGE_VECTORIZE_VECTOR_DELETE_INDEX_FAILED",
+          domain: ErrorDomain.STORAGE,
+          category: ErrorCategory.THIRD_PARTY,
+          details: { indexName }
+        },
+        error
+      );
+    }
+  }
+  async createMetadataIndex(indexName, propertyName, indexType) {
+    try {
+      await this.client.vectorize.indexes.metadataIndex.create(indexName, {
+        account_id: this.accountId,
+        propertyName,
+        indexType
+      });
+    } catch (error) {
+      throw new MastraError(
+        {
+          id: "STORAGE_VECTORIZE_VECTOR_CREATE_METADATA_INDEX_FAILED",
+          domain: ErrorDomain.STORAGE,
+          category: ErrorCategory.THIRD_PARTY,
+          details: { indexName, propertyName, indexType }
+        },
+        error
+      );
+    }
+  }
+  async deleteMetadataIndex(indexName, propertyName) {
+    try {
+      await this.client.vectorize.indexes.metadataIndex.delete(indexName, {
+        account_id: this.accountId,
+        propertyName
+      });
+    } catch (error) {
+      throw new MastraError(
+        {
+          id: "STORAGE_VECTORIZE_VECTOR_DELETE_METADATA_INDEX_FAILED",
+          domain: ErrorDomain.STORAGE,
+          category: ErrorCategory.THIRD_PARTY,
+          details: { indexName, propertyName }
+        },
+        error
+      );
+    }
+  }
+  async listMetadataIndexes(indexName) {
+    try {
+      const res = await this.client.vectorize.indexes.metadataIndex.list(indexName, {
+        account_id: this.accountId
+      });
+      return res?.metadataIndexes ?? [];
+    } catch (error) {
+      throw new MastraError(
+        {
+          id: "STORAGE_VECTORIZE_VECTOR_LIST_METADATA_INDEXES_FAILED",
+          domain: ErrorDomain.STORAGE,
+          category: ErrorCategory.THIRD_PARTY,
+          details: { indexName }
+        },
+        error
+      );
+    }
+  }
+  /**
+   * 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({ indexName, id, update }) {
+    if (!update.vector && !update.metadata) {
+      throw new MastraError({
+        id: "STORAGE_VECTORIZE_VECTOR_UPDATE_VECTOR_INVALID_ARGS",
+        domain: ErrorDomain.STORAGE,
+        category: ErrorCategory.USER,
+        text: "No update data provided",
+        details: { indexName, id }
+      });
+    }
+    try {
+      const updatePayload = {
+        };
+      if (update.vector) {
+        updatePayload.vectors = [update.vector];
+      }
+      if (update.metadata) {
+        updatePayload.metadata = [update.metadata];
+      }
+      await this.upsert({ indexName, vectors: updatePayload.vectors, metadata: updatePayload.metadata });
+    } catch (error) {
+      throw new MastraError(
+        {
+          id: "STORAGE_VECTORIZE_VECTOR_UPDATE_VECTOR_FAILED",
+          domain: ErrorDomain.STORAGE,
+          category: ErrorCategory.THIRD_PARTY,
+          details: { indexName, id }
+        },
+        error
+      );
+    }
+  }
+  /**
+   * 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({ indexName, id }) {
+    try {
+      await this.client.vectorize.indexes.deleteByIds(indexName, {
+        ids: [id],
+        account_id: this.accountId
+      });
+    } catch (error) {
+      throw new MastraError(
+        {
+          id: "STORAGE_VECTORIZE_VECTOR_DELETE_VECTOR_FAILED",
+          domain: ErrorDomain.STORAGE,
+          category: ErrorCategory.THIRD_PARTY,
+          details: { indexName, id }
+        },
+        error
+      );
+    }
+  }
+};
+
+// src/vector/prompt.ts
+var VECTORIZE_PROMPT = `When querying Vectorize, you can ONLY use the operators listed below. Any other operators will be rejected.
+Important: Don't explain how to construct the filter - use the specified operators and fields to search the content and return relevant results.
+If a user tries to give an explicit operator that is not supported, reject the filter entirely and let them know that the operator is not supported.
+
+Basic Comparison Operators:
+- $eq: Exact match (default when using field: value)
+  Example: { "category": "electronics" }
+- $ne: Not equal
+  Example: { "category": { "$ne": "electronics" } }
+- $gt: Greater than
+  Example: { "price": { "$gt": 100 } }
+- $gte: Greater than or equal
+  Example: { "price": { "$gte": 100 } }
+- $lt: Less than
+  Example: { "price": { "$lt": 100 } }
+- $lte: Less than or equal
+  Example: { "price": { "$lte": 100 } }
+
+Array Operators:
+- $in: Match any value in array
+  Example: { "category": { "$in": ["electronics", "books"] } }
+- $nin: Does not match any value in array
+  Example: { "category": { "$nin": ["electronics", "books"] } }
+
+Logical Operators:
+- $and: Logical AND (can be implicit or explicit)
+  Implicit Example: { "price": { "$gt": 100 }, "category": "electronics" }
+  Explicit Example: { "$and": [{ "price": { "$gt": 100 } }, { "category": "electronics" }] }
+- $or: Logical OR
+  Example: { "$or": [{ "price": { "$lt": 50 } }, { "category": "books" }] }
+
+Element Operators:
+- $exists: Check if field exists
+  Example: { "rating": { "$exists": true } }
+- $match: Match text using full-text search
+  Example: { "description": { "$match": "gaming laptop" } }
+
+Restrictions:
+- Regex patterns are not supported
+- Only $and and $or logical operators are supported at the top level
+- Empty arrays in $in/$nin will return no results
+- Nested fields are supported using dot notation
+- Multiple conditions on the same field are supported with both implicit and explicit $and
+- At least one key-value pair is required in filter object
+- Empty objects and undefined values are treated as no filter
+- Invalid types in comparison operators will throw errors
+- All non-logical operators must be used within a field condition
+  Valid: { "field": { "$gt": 100 } }
+  Valid: { "$and": [...] }
+  Invalid: { "$gt": 100 }
+- Logical operators must contain field conditions, not direct operators
+  Valid: { "$and": [{ "field": { "$gt": 100 } }] }
+  Invalid: { "$and": [{ "$gt": 100 }] }
+- Logical operators ($and, $or):
+  - Can only be used at top level or nested within other logical operators
+  - Can not be used on a field level, or be nested inside a field
+  - Can not be used inside an operator
+  - Valid: { "$and": [{ "field": { "$gt": 100 } }] }
+  - Valid: { "$or": [{ "$and": [{ "field": { "$gt": 100 } }] }] }
+  - Invalid: { "field": { "$and": [{ "$gt": 100 }] } }
+  - Invalid: { "field": { "$or": [{ "$gt": 100 }] } }
+  - Invalid: { "field": { "$gt": { "$and": [{...}] } } }
+
+Example Complex Query:
+{
+  "$and": [
+    { "category": { "$in": ["electronics", "computers"] } },
+    { "price": { "$gte": 100, "$lte": 1000 } },
+    { "description": { "$match": "gaming laptop" } },
+    { "rating": { "$exists": true, "$gt": 4 } },
+    { "$or": [
+      { "stock": { "$gt": 0 } },
+      { "preorder": true }
+    ]}
+  ]
+}`;
+
+export { CloudflareVector, VECTORIZE_PROMPT };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/vector/filter.ts","../src/vector/index.ts","../src/vector/prompt.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["import { BaseFilterTranslator } from '@mastra/core/vector/filter';\nimport type {\n  VectorFilter,\n  OperatorSupport,\n  OperatorValueMap,\n  LogicalOperatorValueMap,\n  BlacklistedRootOperators,\n} from '@mastra/core/vector/filter';\n\ntype VectorizeOperatorValueMap = Omit<OperatorValueMap, '$regex' | '$options' | '$exists' | '$elemMatch' | '$all'>;\n\ntype VectorizeLogicalOperatorValueMap = Omit<LogicalOperatorValueMap, '$nor' | '$not' | '$and' | '$or'>;\n\ntype VectorizeBlacklistedRootOperators = BlacklistedRootOperators | '$nor' | '$not' | '$and' | '$or';\n\nexport type VectorizeVectorFilter = VectorFilter<\n  keyof VectorizeOperatorValueMap,\n  VectorizeOperatorValueMap,\n  VectorizeLogicalOperatorValueMap,\n  VectorizeBlacklistedRootOperators\n>;\n\nexport class VectorizeFilterTranslator extends BaseFilterTranslator<VectorizeVectorFilter> {\n  protected override getSupportedOperators(): OperatorSupport {\n    return {\n      ...BaseFilterTranslator.DEFAULT_OPERATORS,\n      logical: [],\n      array: ['$in', '$nin'],\n      element: [],\n      regex: [],\n      custom: [],\n    };\n  }\n\n  translate(filter?: VectorizeVectorFilter): VectorizeVectorFilter {\n    if (this.isEmpty(filter)) return filter;\n    this.validateFilter(filter);\n    return this.translateNode(filter);\n  }\n\n  private translateNode(node: VectorizeVectorFilter, currentPath: string = ''): any {\n    if (this.isRegex(node)) {\n      throw new Error('Regex is not supported in Vectorize');\n    }\n    if (this.isPrimitive(node)) return { $eq: this.normalizeComparisonValue(node) };\n    if (Array.isArray(node)) return { $in: this.normalizeArrayValues(node) };\n\n    const entries = Object.entries(node as Record<string, any>);\n    const firstEntry = entries[0];\n\n    // Handle single operator case\n    if (entries.length === 1 && firstEntry && this.isOperator(firstEntry[0])) {\n      const [operator, value] = firstEntry;\n      return { [operator]: this.normalizeComparisonValue(value) };\n    }\n\n    // Process each entry\n    const result: Record<string, any> = {};\n    for (const [key, value] of entries) {\n      const newPath = currentPath ? `${currentPath}.${key}` : key;\n\n      if (this.isOperator(key)) {\n        result[key] = this.normalizeComparisonValue(value);\n        continue;\n      }\n\n      if (typeof value === 'object' && value !== null && !Array.isArray(value)) {\n        if (Object.keys(value).length === 0) {\n          result[newPath] = this.translateNode(value);\n          continue;\n        }\n\n        // Check if the nested object contains operators\n        const hasOperators = Object.keys(value).some(k => this.isOperator(k));\n        if (hasOperators) {\n          result[newPath] = this.translateNode(value);\n        } else {\n          // For objects without operators, flatten them\n          Object.assign(result, this.translateNode(value, newPath));\n        }\n      } else {\n        result[newPath] = this.translateNode(value);\n      }\n    }\n\n    return result;\n  }\n}\n","import { MastraError, ErrorDomain, ErrorCategory } from '@mastra/core/error';\nimport { MastraVector } from '@mastra/core/vector';\nimport type {\n  QueryResult,\n  CreateIndexParams,\n  UpsertVectorParams,\n  QueryVectorParams,\n  DescribeIndexParams,\n  DeleteIndexParams,\n  DeleteVectorParams,\n  UpdateVectorParams,\n  IndexStats,\n} from '@mastra/core/vector';\nimport Cloudflare from 'cloudflare';\n\nimport { VectorizeFilterTranslator } from './filter';\nimport type { VectorizeVectorFilter } from './filter';\n\ntype VectorizeQueryParams = QueryVectorParams<VectorizeVectorFilter>;\n\nexport class CloudflareVector extends MastraVector<VectorizeVectorFilter> {\n  client: Cloudflare;\n  accountId: string;\n\n  constructor({ accountId, apiToken, id }: { accountId: string; apiToken: string } & { id: string }) {\n    super({ id });\n    this.accountId = accountId;\n\n    this.client = new Cloudflare({\n      apiToken: apiToken,\n    });\n  }\n\n  get indexSeparator(): string {\n    return '-';\n  }\n\n  async upsert({ indexName, vectors, metadata, ids }: UpsertVectorParams): Promise<string[]> {\n    const generatedIds = ids || vectors.map(() => crypto.randomUUID());\n\n    // Create NDJSON string - each line is a JSON object\n    const ndjson = vectors\n      .map((vector, index) =>\n        JSON.stringify({\n          id: generatedIds[index]!,\n          values: vector,\n          metadata: metadata?.[index],\n        }),\n      )\n      .join('\\n');\n\n    try {\n      // Note: __binaryRequest is required for proper NDJSON handling\n      await this.client.vectorize.indexes.upsert(\n        indexName,\n        {\n          account_id: this.accountId,\n          body: ndjson,\n        },\n        {\n          __binaryRequest: true,\n        },\n      );\n\n      return generatedIds;\n    } catch (error) {\n      throw new MastraError(\n        {\n          id: 'STORAGE_VECTORIZE_VECTOR_UPSERT_FAILED',\n          domain: ErrorDomain.STORAGE,\n          category: ErrorCategory.THIRD_PARTY,\n          details: { indexName, vectorCount: vectors?.length },\n        },\n        error,\n      );\n    }\n  }\n\n  transformFilter(filter?: VectorizeVectorFilter) {\n    const translator = new VectorizeFilterTranslator();\n    return translator.translate(filter);\n  }\n\n  async createIndex({ indexName, dimension, metric = 'cosine' }: CreateIndexParams): Promise<void> {\n    try {\n      await this.client.vectorize.indexes.create({\n        account_id: this.accountId,\n        config: {\n          dimensions: dimension,\n          metric: metric === 'dotproduct' ? 'dot-product' : metric,\n        },\n        name: indexName,\n      });\n    } catch (error: any) {\n      // Check for 'already exists' error\n      const message = error?.errors?.[0]?.message || error?.message;\n      if (\n        error.status === 409 ||\n        (typeof message === 'string' &&\n          (message.toLowerCase().includes('already exists') || message.toLowerCase().includes('duplicate')))\n      ) {\n        // Fetch index info and check dimensions\n        await this.validateExistingIndex(indexName, dimension, metric);\n        return;\n      }\n      // For any other errors, propagate\n      throw new MastraError(\n        {\n          id: 'STORAGE_VECTORIZE_VECTOR_CREATE_INDEX_FAILED',\n          domain: ErrorDomain.STORAGE,\n          category: ErrorCategory.THIRD_PARTY,\n          details: { indexName, dimension, metric },\n        },\n        error,\n      );\n    }\n  }\n\n  async query({\n    indexName,\n    queryVector,\n    topK = 10,\n    filter,\n    includeVector = false,\n  }: VectorizeQueryParams): Promise<QueryResult[]> {\n    try {\n      const translatedFilter = this.transformFilter(filter) ?? {};\n      const response = await this.client.vectorize.indexes.query(indexName, {\n        account_id: this.accountId,\n        vector: queryVector,\n        returnValues: includeVector,\n        returnMetadata: 'all',\n        topK,\n        filter: translatedFilter,\n      });\n\n      return (\n        response?.matches?.map((match: any) => {\n          return {\n            id: match.id,\n            metadata: match.metadata,\n            score: match.score,\n            vector: match.values,\n          };\n        }) || []\n      );\n    } catch (error) {\n      throw new MastraError(\n        {\n          id: 'STORAGE_VECTORIZE_VECTOR_QUERY_FAILED',\n          domain: ErrorDomain.STORAGE,\n          category: ErrorCategory.THIRD_PARTY,\n          details: { indexName, topK },\n        },\n        error,\n      );\n    }\n  }\n\n  async listIndexes(): Promise<string[]> {\n    try {\n      const res = await this.client.vectorize.indexes.list({\n        account_id: this.accountId,\n      });\n\n      return res?.result?.map(index => index.name!) || [];\n    } catch (error) {\n      throw new MastraError(\n        {\n          id: 'STORAGE_VECTORIZE_VECTOR_LIST_INDEXES_FAILED',\n          domain: ErrorDomain.STORAGE,\n          category: ErrorCategory.THIRD_PARTY,\n        },\n        error,\n      );\n    }\n  }\n\n  /**\n   * Retrieves statistics about a vector index.\n   *\n   * @param {string} indexName - The name of the index to describe\n   * @returns A promise that resolves to the index statistics including dimension, count and metric\n   */\n  async describeIndex({ indexName }: DescribeIndexParams): Promise<IndexStats> {\n    try {\n      const index = await this.client.vectorize.indexes.get(indexName, {\n        account_id: this.accountId,\n      });\n\n      const described = await this.client.vectorize.indexes.info(indexName, {\n        account_id: this.accountId,\n      });\n\n      return {\n        dimension: described?.dimensions!,\n        // Since vector_count is not available in the response,\n        // we might need a separate API call to get the count if needed\n        count: described?.vectorCount || 0,\n        metric: index?.config?.metric as 'cosine' | 'euclidean' | 'dotproduct',\n      };\n    } catch (error) {\n      throw new MastraError(\n        {\n          id: 'STORAGE_VECTORIZE_VECTOR_DESCRIBE_INDEX_FAILED',\n          domain: ErrorDomain.STORAGE,\n          category: ErrorCategory.THIRD_PARTY,\n          details: { indexName },\n        },\n        error,\n      );\n    }\n  }\n\n  async deleteIndex({ indexName }: DeleteIndexParams): Promise<void> {\n    try {\n      await this.client.vectorize.indexes.delete(indexName, {\n        account_id: this.accountId,\n      });\n    } catch (error) {\n      throw new MastraError(\n        {\n          id: 'STORAGE_VECTORIZE_VECTOR_DELETE_INDEX_FAILED',\n          domain: ErrorDomain.STORAGE,\n          category: ErrorCategory.THIRD_PARTY,\n          details: { indexName },\n        },\n        error,\n      );\n    }\n  }\n\n  async createMetadataIndex(indexName: string, propertyName: string, indexType: 'string' | 'number' | 'boolean') {\n    try {\n      await this.client.vectorize.indexes.metadataIndex.create(indexName, {\n        account_id: this.accountId,\n        propertyName,\n        indexType,\n      });\n    } catch (error) {\n      throw new MastraError(\n        {\n          id: 'STORAGE_VECTORIZE_VECTOR_CREATE_METADATA_INDEX_FAILED',\n          domain: ErrorDomain.STORAGE,\n          category: ErrorCategory.THIRD_PARTY,\n          details: { indexName, propertyName, indexType },\n        },\n        error,\n      );\n    }\n  }\n\n  async deleteMetadataIndex(indexName: string, propertyName: string) {\n    try {\n      await this.client.vectorize.indexes.metadataIndex.delete(indexName, {\n        account_id: this.accountId,\n        propertyName,\n      });\n    } catch (error) {\n      throw new MastraError(\n        {\n          id: 'STORAGE_VECTORIZE_VECTOR_DELETE_METADATA_INDEX_FAILED',\n          domain: ErrorDomain.STORAGE,\n          category: ErrorCategory.THIRD_PARTY,\n          details: { indexName, propertyName },\n        },\n        error,\n      );\n    }\n  }\n\n  async listMetadataIndexes(indexName: string) {\n    try {\n      const res = await this.client.vectorize.indexes.metadataIndex.list(indexName, {\n        account_id: this.accountId,\n      });\n\n      return res?.metadataIndexes ?? [];\n    } catch (error) {\n      throw new MastraError(\n        {\n          id: 'STORAGE_VECTORIZE_VECTOR_LIST_METADATA_INDEXES_FAILED',\n          domain: ErrorDomain.STORAGE,\n          category: ErrorCategory.THIRD_PARTY,\n          details: { indexName },\n        },\n        error,\n      );\n    }\n  }\n\n  /**\n   * Updates a vector by its ID with the provided vector and/or metadata.\n   * @param indexName - The name of the index containing the vector.\n   * @param id - The ID of the vector to update.\n   * @param update - An object containing the vector and/or metadata to update.\n   * @param update.vector - An optional array of numbers representing the new vector.\n   * @param update.metadata - An optional record containing the new metadata.\n   * @returns A promise that resolves when the update is complete.\n   * @throws Will throw an error if no updates are provided or if the update operation fails.\n   */\n  async updateVector({ indexName, id, update }: UpdateVectorParams): Promise<void> {\n    if (!update.vector && !update.metadata) {\n      throw new MastraError({\n        id: 'STORAGE_VECTORIZE_VECTOR_UPDATE_VECTOR_INVALID_ARGS',\n        domain: ErrorDomain.STORAGE,\n        category: ErrorCategory.USER,\n        text: 'No update data provided',\n        details: { indexName, id },\n      });\n    }\n\n    try {\n      const updatePayload: any = {\n        ids: [id],\n        account_id: this.accountId,\n      };\n\n      if (update.vector) {\n        updatePayload.vectors = [update.vector];\n      }\n      if (update.metadata) {\n        updatePayload.metadata = [update.metadata];\n      }\n\n      await this.upsert({ indexName: indexName, vectors: updatePayload.vectors, metadata: updatePayload.metadata });\n    } catch (error) {\n      throw new MastraError(\n        {\n          id: 'STORAGE_VECTORIZE_VECTOR_UPDATE_VECTOR_FAILED',\n          domain: ErrorDomain.STORAGE,\n          category: ErrorCategory.THIRD_PARTY,\n          details: { indexName, id },\n        },\n        error,\n      );\n    }\n  }\n\n  /**\n   * Deletes a vector by its ID.\n   * @param indexName - The name of the index containing the vector.\n   * @param id - The ID of the vector to delete.\n   * @returns A promise that resolves when the deletion is complete.\n   * @throws Will throw an error if the deletion operation fails.\n   */\n  async deleteVector({ indexName, id }: DeleteVectorParams): Promise<void> {\n    try {\n      await this.client.vectorize.indexes.deleteByIds(indexName, {\n        ids: [id],\n        account_id: this.accountId,\n      });\n    } catch (error) {\n      throw new MastraError(\n        {\n          id: 'STORAGE_VECTORIZE_VECTOR_DELETE_VECTOR_FAILED',\n          domain: ErrorDomain.STORAGE,\n          category: ErrorCategory.THIRD_PARTY,\n          details: { indexName, id },\n        },\n        error,\n      );\n    }\n  }\n}\n","/**\n * Vector store specific prompt that details supported operators and examples.\n * This prompt helps users construct valid filters for Vectorize.\n */\nexport const VECTORIZE_PROMPT = `When querying Vectorize, you can ONLY use the operators listed below. Any other operators will be rejected.\nImportant: Don't explain how to construct the filter - use the specified operators and fields to search the content and return relevant results.\nIf a user tries to give an explicit operator that is not supported, reject the filter entirely and let them know that the operator is not supported.\n\nBasic Comparison Operators:\n- $eq: Exact match (default when using field: value)\n  Example: { \"category\": \"electronics\" }\n- $ne: Not equal\n  Example: { \"category\": { \"$ne\": \"electronics\" } }\n- $gt: Greater than\n  Example: { \"price\": { \"$gt\": 100 } }\n- $gte: Greater than or equal\n  Example: { \"price\": { \"$gte\": 100 } }\n- $lt: Less than\n  Example: { \"price\": { \"$lt\": 100 } }\n- $lte: Less than or equal\n  Example: { \"price\": { \"$lte\": 100 } }\n\nArray Operators:\n- $in: Match any value in array\n  Example: { \"category\": { \"$in\": [\"electronics\", \"books\"] } }\n- $nin: Does not match any value in array\n  Example: { \"category\": { \"$nin\": [\"electronics\", \"books\"] } }\n\nLogical Operators:\n- $and: Logical AND (can be implicit or explicit)\n  Implicit Example: { \"price\": { \"$gt\": 100 }, \"category\": \"electronics\" }\n  Explicit Example: { \"$and\": [{ \"price\": { \"$gt\": 100 } }, { \"category\": \"electronics\" }] }\n- $or: Logical OR\n  Example: { \"$or\": [{ \"price\": { \"$lt\": 50 } }, { \"category\": \"books\" }] }\n\nElement Operators:\n- $exists: Check if field exists\n  Example: { \"rating\": { \"$exists\": true } }\n- $match: Match text using full-text search\n  Example: { \"description\": { \"$match\": \"gaming laptop\" } }\n\nRestrictions:\n- Regex patterns are not supported\n- Only $and and $or logical operators are supported at the top level\n- Empty arrays in $in/$nin will return no results\n- Nested fields are supported using dot notation\n- Multiple conditions on the same field are supported with both implicit and explicit $and\n- At least one key-value pair is required in filter object\n- Empty objects and undefined values are treated as no filter\n- Invalid types in comparison operators will throw errors\n- All non-logical operators must be used within a field condition\n  Valid: { \"field\": { \"$gt\": 100 } }\n  Valid: { \"$and\": [...] }\n  Invalid: { \"$gt\": 100 }\n- Logical operators must contain field conditions, not direct operators\n  Valid: { \"$and\": [{ \"field\": { \"$gt\": 100 } }] }\n  Invalid: { \"$and\": [{ \"$gt\": 100 }] }\n- Logical operators ($and, $or):\n  - Can only be used at top level or nested within other logical operators\n  - Can not be used on a field level, or be nested inside a field\n  - Can not be used inside an operator\n  - Valid: { \"$and\": [{ \"field\": { \"$gt\": 100 } }] }\n  - Valid: { \"$or\": [{ \"$and\": [{ \"field\": { \"$gt\": 100 } }] }] }\n  - Invalid: { \"field\": { \"$and\": [{ \"$gt\": 100 }] } }\n  - Invalid: { \"field\": { \"$or\": [{ \"$gt\": 100 }] } }\n  - Invalid: { \"field\": { \"$gt\": { \"$and\": [{...}] } } }\n\nExample Complex Query:\n{\n  \"$and\": [\n    { \"category\": { \"$in\": [\"electronics\", \"computers\"] } },\n    { \"price\": { \"$gte\": 100, \"$lte\": 1000 } },\n    { \"description\": { \"$match\": \"gaming laptop\" } },\n    { \"rating\": { \"$exists\": true, \"$gt\": 4 } },\n    { \"$or\": [\n      { \"stock\": { \"$gt\": 0 } },\n      { \"preorder\": true }\n    ]}\n  ]\n}`;\n"]}

package/dist/vector/filter.d.ts

@@ -0,0 +1,13 @@
+import { BaseFilterTranslator } from '@mastra/core/vector/filter';
+import type { VectorFilter, OperatorSupport, OperatorValueMap, LogicalOperatorValueMap, BlacklistedRootOperators } from '@mastra/core/vector/filter';
+type VectorizeOperatorValueMap = Omit<OperatorValueMap, '$regex' | '$options' | '$exists' | '$elemMatch' | '$all'>;
+type VectorizeLogicalOperatorValueMap = Omit<LogicalOperatorValueMap, '$nor' | '$not' | '$and' | '$or'>;
+type VectorizeBlacklistedRootOperators = BlacklistedRootOperators | '$nor' | '$not' | '$and' | '$or';
+export type VectorizeVectorFilter = VectorFilter<keyof VectorizeOperatorValueMap, VectorizeOperatorValueMap, VectorizeLogicalOperatorValueMap, VectorizeBlacklistedRootOperators>;
+export declare class VectorizeFilterTranslator extends BaseFilterTranslator<VectorizeVectorFilter> {
+    protected getSupportedOperators(): OperatorSupport;
+    translate(filter?: VectorizeVectorFilter): VectorizeVectorFilter;
+    private translateNode;
+}
+export {};
+//# sourceMappingURL=filter.d.ts.map

package/dist/vector/filter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"filter.d.ts","sourceRoot":"","sources":["../../src/vector/filter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAClE,OAAO,KAAK,EACV,YAAY,EACZ,eAAe,EACf,gBAAgB,EAChB,uBAAuB,EACvB,wBAAwB,EACzB,MAAM,4BAA4B,CAAC;AAEpC,KAAK,yBAAyB,GAAG,IAAI,CAAC,gBAAgB,EAAE,QAAQ,GAAG,UAAU,GAAG,SAAS,GAAG,YAAY,GAAG,MAAM,CAAC,CAAC;AAEnH,KAAK,gCAAgC,GAAG,IAAI,CAAC,uBAAuB,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,KAAK,CAAC,CAAC;AAExG,KAAK,iCAAiC,GAAG,wBAAwB,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,KAAK,CAAC;AAErG,MAAM,MAAM,qBAAqB,GAAG,YAAY,CAC9C,MAAM,yBAAyB,EAC/B,yBAAyB,EACzB,gCAAgC,EAChC,iCAAiC,CAClC,CAAC;AAEF,qBAAa,yBAA0B,SAAQ,oBAAoB,CAAC,qBAAqB,CAAC;cACrE,qBAAqB,IAAI,eAAe;IAW3D,SAAS,CAAC,MAAM,CAAC,EAAE,qBAAqB,GAAG,qBAAqB;IAMhE,OAAO,CAAC,aAAa;CA+CtB"}

package/dist/vector/index.d.ts

@@ -0,0 +1,53 @@
+import { MastraVector } from '@mastra/core/vector';
+import type { QueryResult, CreateIndexParams, UpsertVectorParams, QueryVectorParams, DescribeIndexParams, DeleteIndexParams, DeleteVectorParams, UpdateVectorParams, IndexStats } from '@mastra/core/vector';
+import Cloudflare from 'cloudflare';
+import type { VectorizeVectorFilter } from './filter.js';
+type VectorizeQueryParams = QueryVectorParams<VectorizeVectorFilter>;
+export declare class CloudflareVector extends MastraVector<VectorizeVectorFilter> {
+    client: Cloudflare;
+    accountId: string;
+    constructor({ accountId, apiToken, id }: {
+        accountId: string;
+        apiToken: string;
+    } & {
+        id: string;
+    });
+    get indexSeparator(): string;
+    upsert({ indexName, vectors, metadata, ids }: UpsertVectorParams): Promise<string[]>;
+    transformFilter(filter?: VectorizeVectorFilter): VectorizeVectorFilter;
+    createIndex({ indexName, dimension, metric }: CreateIndexParams): Promise<void>;
+    query({ indexName, queryVector, topK, filter, includeVector, }: VectorizeQueryParams): Promise<QueryResult[]>;
+    listIndexes(): Promise<string[]>;
+    /**
+     * Retrieves statistics about a vector index.
+     *
+     * @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({ 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[]>;
+    /**
+     * 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({ indexName, id, update }: UpdateVectorParams): 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({ indexName, id }: DeleteVectorParams): Promise<void>;
+}
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/vector/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/vector/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,KAAK,EACV,WAAW,EACX,iBAAiB,EACjB,kBAAkB,EAClB,iBAAiB,EACjB,mBAAmB,EACnB,iBAAiB,EACjB,kBAAkB,EAClB,kBAAkB,EAClB,UAAU,EACX,MAAM,qBAAqB,CAAC;AAC7B,OAAO,UAAU,MAAM,YAAY,CAAC;AAGpC,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,UAAU,CAAC;AAEtD,KAAK,oBAAoB,GAAG,iBAAiB,CAAC,qBAAqB,CAAC,CAAC;AAErE,qBAAa,gBAAiB,SAAQ,YAAY,CAAC,qBAAqB,CAAC;IACvE,MAAM,EAAE,UAAU,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;gBAEN,EAAE,SAAS,EAAE,QAAQ,EAAE,EAAE,EAAE,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,GAAG;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE;IASjG,IAAI,cAAc,IAAI,MAAM,CAE3B;IAEK,MAAM,CAAC,EAAE,SAAS,EAAE,OAAO,EAAE,QAAQ,EAAE,GAAG,EAAE,EAAE,kBAAkB,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAyC1F,eAAe,CAAC,MAAM,CAAC,EAAE,qBAAqB;IAKxC,WAAW,CAAC,EAAE,SAAS,EAAE,SAAS,EAAE,MAAiB,EAAE,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IAmC1F,KAAK,CAAC,EACV,SAAS,EACT,WAAW,EACX,IAAS,EACT,MAAM,EACN,aAAqB,GACtB,EAAE,oBAAoB,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAmC1C,WAAW,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAmBtC;;;;;OAKG;IACG,aAAa,CAAC,EAAE,SAAS,EAAE,EAAE,mBAAmB,GAAG,OAAO,CAAC,UAAU,CAAC;IA8BtE,WAAW,CAAC,EAAE,SAAS,EAAE,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IAkB5D,mBAAmB,CAAC,SAAS,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS;IAoBvG,mBAAmB,CAAC,SAAS,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM;IAmB3D,mBAAmB,CAAC,SAAS,EAAE,MAAM;IAoB3C;;;;;;;;;OASG;IACG,YAAY,CAAC,EAAE,SAAS,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC;IAsChF;;;;;;OAMG;IACG,YAAY,CAAC,EAAE,SAAS,EAAE,EAAE,EAAE,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC;CAkBzE"}

package/dist/vector/prompt.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Vector store specific prompt that details supported operators and examples.
+ * This prompt helps users construct valid filters for Vectorize.
+ */
+export declare const VECTORIZE_PROMPT = "When querying Vectorize, you can ONLY use the operators listed below. Any other operators will be rejected.\nImportant: Don't explain how to construct the filter - use the specified operators and fields to search the content and return relevant results.\nIf a user tries to give an explicit operator that is not supported, reject the filter entirely and let them know that the operator is not supported.\n\nBasic Comparison Operators:\n- $eq: Exact match (default when using field: value)\n  Example: { \"category\": \"electronics\" }\n- $ne: Not equal\n  Example: { \"category\": { \"$ne\": \"electronics\" } }\n- $gt: Greater than\n  Example: { \"price\": { \"$gt\": 100 } }\n- $gte: Greater than or equal\n  Example: { \"price\": { \"$gte\": 100 } }\n- $lt: Less than\n  Example: { \"price\": { \"$lt\": 100 } }\n- $lte: Less than or equal\n  Example: { \"price\": { \"$lte\": 100 } }\n\nArray Operators:\n- $in: Match any value in array\n  Example: { \"category\": { \"$in\": [\"electronics\", \"books\"] } }\n- $nin: Does not match any value in array\n  Example: { \"category\": { \"$nin\": [\"electronics\", \"books\"] } }\n\nLogical Operators:\n- $and: Logical AND (can be implicit or explicit)\n  Implicit Example: { \"price\": { \"$gt\": 100 }, \"category\": \"electronics\" }\n  Explicit Example: { \"$and\": [{ \"price\": { \"$gt\": 100 } }, { \"category\": \"electronics\" }] }\n- $or: Logical OR\n  Example: { \"$or\": [{ \"price\": { \"$lt\": 50 } }, { \"category\": \"books\" }] }\n\nElement Operators:\n- $exists: Check if field exists\n  Example: { \"rating\": { \"$exists\": true } }\n- $match: Match text using full-text search\n  Example: { \"description\": { \"$match\": \"gaming laptop\" } }\n\nRestrictions:\n- Regex patterns are not supported\n- Only $and and $or logical operators are supported at the top level\n- Empty arrays in $in/$nin will return no results\n- Nested fields are supported using dot notation\n- Multiple conditions on the same field are supported with both implicit and explicit $and\n- At least one key-value pair is required in filter object\n- Empty objects and undefined values are treated as no filter\n- Invalid types in comparison operators will throw errors\n- All non-logical operators must be used within a field condition\n  Valid: { \"field\": { \"$gt\": 100 } }\n  Valid: { \"$and\": [...] }\n  Invalid: { \"$gt\": 100 }\n- Logical operators must contain field conditions, not direct operators\n  Valid: { \"$and\": [{ \"field\": { \"$gt\": 100 } }] }\n  Invalid: { \"$and\": [{ \"$gt\": 100 }] }\n- Logical operators ($and, $or):\n  - Can only be used at top level or nested within other logical operators\n  - Can not be used on a field level, or be nested inside a field\n  - Can not be used inside an operator\n  - Valid: { \"$and\": [{ \"field\": { \"$gt\": 100 } }] }\n  - Valid: { \"$or\": [{ \"$and\": [{ \"field\": { \"$gt\": 100 } }] }] }\n  - Invalid: { \"field\": { \"$and\": [{ \"$gt\": 100 }] } }\n  - Invalid: { \"field\": { \"$or\": [{ \"$gt\": 100 }] } }\n  - Invalid: { \"field\": { \"$gt\": { \"$and\": [{...}] } } }\n\nExample Complex Query:\n{\n  \"$and\": [\n    { \"category\": { \"$in\": [\"electronics\", \"computers\"] } },\n    { \"price\": { \"$gte\": 100, \"$lte\": 1000 } },\n    { \"description\": { \"$match\": \"gaming laptop\" } },\n    { \"rating\": { \"$exists\": true, \"$gt\": 4 } },\n    { \"$or\": [\n      { \"stock\": { \"$gt\": 0 } },\n      { \"preorder\": true }\n    ]}\n  ]\n}";
+//# sourceMappingURL=prompt.d.ts.map

package/dist/vector/prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.d.ts","sourceRoot":"","sources":["../../src/vector/prompt.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,gBAAgB,+5GA2E3B,CAAC"}

package/package.json

@@ -0,0 +1,62 @@
+{
+  "name": "@mastra/vectorize",
+  "version": "0.0.0-1.x-tester-20251106055847",
+  "description": "Cloudflare Vectorize store provider for Mastra",
+  "type": "module",
+  "files": [
+    "dist",
+    "CHANGELOG.md"
+  ],
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.cjs"
+      }
+    },
+    "./package.json": "./package.json"
+  },
+  "license": "Apache-2.0",
+  "dependencies": {
+    "cloudflare": "^4.5.0"
+  },
+  "devDependencies": {
+    "@microsoft/api-extractor": "^7.52.8",
+    "@types/node": "^20.19.0",
+    "dotenv": "^17.0.0",
+    "eslint": "^9.37.0",
+    "tsup": "^8.5.0",
+    "typescript": "^5.8.3",
+    "vitest": "^3.2.4",
+    "@internal/lint": "0.0.0-1.x-tester-20251106055847",
+    "@mastra/core": "0.0.0-1.x-tester-20251106055847",
+    "@internal/types-builder": "0.0.0-1.x-tester-20251106055847"
+  },
+  "peerDependencies": {
+    "@mastra/core": "0.0.0-1.x-tester-20251106055847"
+  },
+  "homepage": "https://mastra.ai",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/mastra-ai/mastra.git",
+    "directory": "stores/vectorize"
+  },
+  "bugs": {
+    "url": "https://github.com/mastra-ai/mastra/issues"
+  },
+  "engines": {
+    "node": ">=22.13.0"
+  },
+  "scripts": {
+    "build": "tsup --silent --config tsup.config.ts",
+    "build:watch": "tsup --watch --silent --config tsup.config.ts",
+    "test": "vitest run",
+    "lint": "eslint ."
+  }
+}