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

package/LICENSE.md

@@ -0,0 +1,15 @@
+# Apache License 2.0
+
+Copyright (c) 2025 Kepler Software, Inc.
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.

package/README.md

@@ -0,0 +1,74 @@
+# @mastra/vectorize
+
+Vector store implementation for Vectorize, a managed vector database service optimized for AI applications.
+
+## Installation
+
+```bash
+npm install @mastra/vectorize
+```
+
+## Usage
+
+```typescript
+import { VectorizeStore } from '@mastra/vectorize';
+
+const vectorStore = new VectorizeStore({
+  apiKey: process.env.VECTORIZE_API_KEY,
+  projectId: process.env.VECTORIZE_PROJECT_ID
+});
+
+// Create a new index
+await vectorStore.createIndex({
+  indexName: 'my-index',
+  dimension: 1536,
+  metric: 'cosine'
+});
+
+// Add vectors
+const vectors = [[0.1, 0.2, ...], [0.3, 0.4, ...]];
+const metadata = [{ text: 'doc1' }, { text: 'doc2' }];
+const ids = await vectorStore.upsert({
+  indexName: 'my-index',
+  vectors,
+  metadata
+});
+
+// Query vectors
+const results = await vectorStore.query({
+  indexName: 'my-index',
+  queryVector: [0.1, 0.2, ...],
+  topK: 10,
+  filter: { text: { $eq: 'doc1' } },
+  includeVector: false
+});
+```
+
+## Configuration
+
+The Vectorize vector store requires the following configuration:
+
+- `VECTORIZE_API_KEY`: Your Vectorize API key
+- `VECTORIZE_INDEX_NAME`: Name of the index to use
+- `VECTORIZE_PROJECT_ID`: Your Vectorize project ID
+
+## Features
+
+- Purpose-built for AI and ML workloads
+- High-performance vector similarity search
+- Automatic index optimization
+- Scalable architecture
+- Real-time updates and queries
+
+## Methods
+
+- `createIndex({ indexName, dimension, metric? })`: Create a new index
+- `upsert({ indexName, vectors, metadata?, ids? })`: Add or update vectors
+- `query({ indexName, queryVector, topK?, filter?, includeVector? })`: Search for similar vectors
+- `listIndexes()`: List all indexes
+- `describeIndex(indexName)`: Get index statistics
+- `deleteIndex(indexName)`: Delete an index
+
+## Related Links
+
+- [Vectorize Documentation](https://www.vectorize.com/docs)

package/dist/index.cjs

@@ -0,0 +1,454 @@
+'use strict';
+
+var error = require('@mastra/core/error');
+var vector = require('@mastra/core/vector');
+var Cloudflare = require('cloudflare');
+var filter = require('@mastra/core/vector/filter');
+
+function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
+
+var Cloudflare__default = /*#__PURE__*/_interopDefault(Cloudflare);
+
+// src/vector/index.ts
+var VectorizeFilterTranslator = class extends filter.BaseFilterTranslator {
+  getSupportedOperators() {
+    return {
+      ...filter.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 vector.MastraVector {
+  client;
+  accountId;
+  constructor({ accountId, apiToken, id }) {
+    super({ id });
+    this.accountId = accountId;
+    this.client = new Cloudflare__default.default({
+      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$1) {
+      throw new error.MastraError(
+        {
+          id: "STORAGE_VECTORIZE_VECTOR_UPSERT_FAILED",
+          domain: error.ErrorDomain.STORAGE,
+          category: error.ErrorCategory.THIRD_PARTY,
+          details: { indexName, vectorCount: vectors?.length }
+        },
+        error$1
+      );
+    }
+  }
+  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$1) {
+      const message = error$1?.errors?.[0]?.message || error$1?.message;
+      if (error$1.status === 409 || typeof message === "string" && (message.toLowerCase().includes("already exists") || message.toLowerCase().includes("duplicate"))) {
+        await this.validateExistingIndex(indexName, dimension, metric);
+        return;
+      }
+      throw new error.MastraError(
+        {
+          id: "STORAGE_VECTORIZE_VECTOR_CREATE_INDEX_FAILED",
+          domain: error.ErrorDomain.STORAGE,
+          category: error.ErrorCategory.THIRD_PARTY,
+          details: { indexName, dimension, metric }
+        },
+        error$1
+      );
+    }
+  }
+  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$1) {
+      throw new error.MastraError(
+        {
+          id: "STORAGE_VECTORIZE_VECTOR_QUERY_FAILED",
+          domain: error.ErrorDomain.STORAGE,
+          category: error.ErrorCategory.THIRD_PARTY,
+          details: { indexName, topK }
+        },
+        error$1
+      );
+    }
+  }
+  async listIndexes() {
+    try {
+      const res = await this.client.vectorize.indexes.list({
+        account_id: this.accountId
+      });
+      return res?.result?.map((index) => index.name) || [];
+    } catch (error$1) {
+      throw new error.MastraError(
+        {
+          id: "STORAGE_VECTORIZE_VECTOR_LIST_INDEXES_FAILED",
+          domain: error.ErrorDomain.STORAGE,
+          category: error.ErrorCategory.THIRD_PARTY
+        },
+        error$1
+      );
+    }
+  }
+  /**
+   * 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$1) {
+      throw new error.MastraError(
+        {
+          id: "STORAGE_VECTORIZE_VECTOR_DESCRIBE_INDEX_FAILED",
+          domain: error.ErrorDomain.STORAGE,
+          category: error.ErrorCategory.THIRD_PARTY,
+          details: { indexName }
+        },
+        error$1
+      );
+    }
+  }
+  async deleteIndex({ indexName }) {
+    try {
+      await this.client.vectorize.indexes.delete(indexName, {
+        account_id: this.accountId
+      });
+    } catch (error$1) {
+      throw new error.MastraError(
+        {
+          id: "STORAGE_VECTORIZE_VECTOR_DELETE_INDEX_FAILED",
+          domain: error.ErrorDomain.STORAGE,
+          category: error.ErrorCategory.THIRD_PARTY,
+          details: { indexName }
+        },
+        error$1
+      );
+    }
+  }
+  async createMetadataIndex(indexName, propertyName, indexType) {
+    try {
+      await this.client.vectorize.indexes.metadataIndex.create(indexName, {
+        account_id: this.accountId,
+        propertyName,
+        indexType
+      });
+    } catch (error$1) {
+      throw new error.MastraError(
+        {
+          id: "STORAGE_VECTORIZE_VECTOR_CREATE_METADATA_INDEX_FAILED",
+          domain: error.ErrorDomain.STORAGE,
+          category: error.ErrorCategory.THIRD_PARTY,
+          details: { indexName, propertyName, indexType }
+        },
+        error$1
+      );
+    }
+  }
+  async deleteMetadataIndex(indexName, propertyName) {
+    try {
+      await this.client.vectorize.indexes.metadataIndex.delete(indexName, {
+        account_id: this.accountId,
+        propertyName
+      });
+    } catch (error$1) {
+      throw new error.MastraError(
+        {
+          id: "STORAGE_VECTORIZE_VECTOR_DELETE_METADATA_INDEX_FAILED",
+          domain: error.ErrorDomain.STORAGE,
+          category: error.ErrorCategory.THIRD_PARTY,
+          details: { indexName, propertyName }
+        },
+        error$1
+      );
+    }
+  }
+  async listMetadataIndexes(indexName) {
+    try {
+      const res = await this.client.vectorize.indexes.metadataIndex.list(indexName, {
+        account_id: this.accountId
+      });
+      return res?.metadataIndexes ?? [];
+    } catch (error$1) {
+      throw new error.MastraError(
+        {
+          id: "STORAGE_VECTORIZE_VECTOR_LIST_METADATA_INDEXES_FAILED",
+          domain: error.ErrorDomain.STORAGE,
+          category: error.ErrorCategory.THIRD_PARTY,
+          details: { indexName }
+        },
+        error$1
+      );
+    }
+  }
+  /**
+   * 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 error.MastraError({
+        id: "STORAGE_VECTORIZE_VECTOR_UPDATE_VECTOR_INVALID_ARGS",
+        domain: error.ErrorDomain.STORAGE,
+        category: error.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$1) {
+      throw new error.MastraError(
+        {
+          id: "STORAGE_VECTORIZE_VECTOR_UPDATE_VECTOR_FAILED",
+          domain: error.ErrorDomain.STORAGE,
+          category: error.ErrorCategory.THIRD_PARTY,
+          details: { indexName, id }
+        },
+        error$1
+      );
+    }
+  }
+  /**
+   * 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$1) {
+      throw new error.MastraError(
+        {
+          id: "STORAGE_VECTORIZE_VECTOR_DELETE_VECTOR_FAILED",
+          domain: error.ErrorDomain.STORAGE,
+          category: error.ErrorCategory.THIRD_PARTY,
+          details: { indexName, id }
+        },
+        error$1
+      );
+    }
+  }
+};
+
+// 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 }
+    ]}
+  ]
+}`;
+
+exports.CloudflareVector = CloudflareVector;
+exports.VECTORIZE_PROMPT = VECTORIZE_PROMPT;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/vector/filter.ts","../src/vector/index.ts","../src/vector/prompt.ts"],"names":["BaseFilterTranslator","MastraVector","Cloudflare","error","MastraError","ErrorDomain","ErrorCategory"],"mappings":"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","file":"index.cjs","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/index.d.ts

@@ -0,0 +1,3 @@
+export * from './vector/index.js';
+export { VECTORIZE_PROMPT } from './vector/prompt.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC"}