@mastra/opensearch 1.1.0 → 1.1.1-alpha.0

package/dist/index.js

@@ -1,911 +1,709 @@
-import { MastraError, ErrorCategory, ErrorDomain } from '@mastra/core/error';
-import { createVectorErrorId } from '@mastra/core/storage';
-import { MastraVector, validateUpsert, validateTopK } from '@mastra/core/vector';
-import { Client } from '@opensearch-project/opensearch';
-import { BaseFilterTranslator } from '@mastra/core/vector/filter';
-
-// src/vector/index.ts
+import { ErrorCategory, ErrorDomain, MastraError } from "@mastra/core/error";
+import { createVectorErrorId } from "@mastra/core/storage";
+import { MastraVector, validateTopK, validateUpsert } from "@mastra/core/vector";
+import { Client } from "@opensearch-project/opensearch";
+import { BaseFilterTranslator } from "@mastra/core/vector/filter";
+//#region src/vector/filter.ts
+/**
+* Translator for OpenSearch filter queries.
+* Maintains OpenSearch-compatible syntax while ensuring proper validation
+* and normalization of values.
+*/
 var OpenSearchFilterTranslator = class extends BaseFilterTranslator {
-  getSupportedOperators() {
-    return {
-      ...BaseFilterTranslator.DEFAULT_OPERATORS,
-      logical: ["$and", "$or", "$not"],
-      array: ["$in", "$nin", "$all"],
-      regex: ["$regex"],
-      custom: []
-    };
-  }
-  translate(filter) {
-    if (this.isEmpty(filter)) return void 0;
-    this.validateFilter(filter);
-    return this.translateNode(filter);
-  }
-  translateNode(node) {
-    if (this.isPrimitive(node) || Array.isArray(node)) {
-      return node;
-    }
-    const entries = Object.entries(node);
-    const logicalOperators = [];
-    const fieldConditions = [];
-    entries.forEach(([key, value]) => {
-      if (this.isLogicalOperator(key)) {
-        logicalOperators.push([key, value]);
-      } else {
-        fieldConditions.push([key, value]);
-      }
-    });
-    if (logicalOperators.length === 1 && fieldConditions.length === 0) {
-      const [operator, value] = logicalOperators[0];
-      if (!Array.isArray(value) && typeof value !== "object") {
-        throw new Error(`Invalid logical operator structure: ${operator} must have an array or object value`);
-      }
-      return this.translateLogicalOperator(operator, value);
-    }
-    const fieldConditionQueries = fieldConditions.map(([key, value]) => {
-      if (typeof value === "object" && value !== null && !Array.isArray(value)) {
-        const hasOperators = Object.keys(value).some((k) => this.isOperator(k));
-        const nestedField = `metadata.${key}`;
-        return hasOperators ? this.translateFieldConditions(nestedField, value) : this.translateNestedObject(nestedField, value);
-      }
-      if (Array.isArray(value)) {
-        const fieldWithKeyword2 = this.addKeywordIfNeeded(`metadata.${key}`, value);
-        return { terms: { [fieldWithKeyword2]: value } };
-      }
-      const fieldWithKeyword = this.addKeywordIfNeeded(`metadata.${key}`, value);
-      return { term: { [fieldWithKeyword]: value } };
-    });
-    if (logicalOperators.length > 0) {
-      const logicalConditions = logicalOperators.map(
-        ([operator, value]) => this.translateOperator(operator, value)
-      );
-      return {
-        bool: {
-          must: [...logicalConditions, ...fieldConditionQueries]
-        }
-      };
-    }
-    if (fieldConditionQueries.length > 1) {
-      return {
-        bool: {
-          must: fieldConditionQueries
-        }
-      };
-    }
-    if (fieldConditionQueries.length === 1) {
-      return fieldConditionQueries[0];
-    }
-    return { match_all: {} };
-  }
-  /**
-   * Handles translation of nested objects with dot notation fields
-   */
-  translateNestedObject(field, value) {
-    const conditions = Object.entries(value).map(([subField, subValue]) => {
-      const fullField = `${field}.${subField}`;
-      if (this.isOperator(subField)) {
-        return this.translateOperator(subField, subValue, field);
-      }
-      if (typeof subValue === "object" && subValue !== null && !Array.isArray(subValue)) {
-        const hasOperators = Object.keys(subValue).some((k) => this.isOperator(k));
-        if (hasOperators) {
-          return this.translateFieldConditions(fullField, subValue);
-        }
-        return this.translateNestedObject(fullField, subValue);
-      }
-      const fieldWithKeyword = this.addKeywordIfNeeded(fullField, subValue);
-      return { term: { [fieldWithKeyword]: subValue } };
-    });
-    return {
-      bool: {
-        must: conditions
-      }
-    };
-  }
-  translateLogicalOperator(operator, value) {
-    const conditions = Array.isArray(value) ? value.map((item) => this.translateNode(item)) : [this.translateNode(value)];
-    switch (operator) {
-      case "$and":
-        if (Array.isArray(value) && value.length === 0) {
-          return { match_all: {} };
-        }
-        return {
-          bool: {
-            must: conditions
-          }
-        };
-      case "$or":
-        if (Array.isArray(value) && value.length === 0) {
-          return {
-            bool: {
-              must_not: [{ match_all: {} }]
-            }
-          };
-        }
-        return {
-          bool: {
-            should: conditions
-          }
-        };
-      case "$not":
-        return {
-          bool: {
-            must_not: conditions
-          }
-        };
-      default:
-        return value;
-    }
-  }
-  translateFieldOperator(field, operator, value) {
-    if (this.isBasicOperator(operator)) {
-      const normalizedValue = this.normalizeComparisonValue(value);
-      const fieldWithKeyword2 = this.addKeywordIfNeeded(field, value);
-      switch (operator) {
-        case "$eq":
-          if (value === null) {
-            return {
-              bool: {
-                must_not: [{ exists: { field } }]
-              }
-            };
-          }
-          return { term: { [fieldWithKeyword2]: normalizedValue } };
-        case "$ne":
-          if (value === null) {
-            return { exists: { field } };
-          }
-          return {
-            bool: {
-              must_not: [{ term: { [fieldWithKeyword2]: normalizedValue } }]
-            }
-          };
-        default:
-          return { term: { [fieldWithKeyword2]: normalizedValue } };
-      }
-    }
-    if (this.isNumericOperator(operator)) {
-      const normalizedValue = this.normalizeComparisonValue(value);
-      const rangeOp = operator.replace("$", "");
-      return { range: { [field]: { [rangeOp]: normalizedValue } } };
-    }
-    if (this.isArrayOperator(operator)) {
-      if (!Array.isArray(value)) {
-        throw new Error(`Invalid array operator value: ${operator} requires an array value`);
-      }
-      const normalizedValues = this.normalizeArrayValues(value);
-      const fieldWithKeyword2 = this.addKeywordIfNeeded(field, value);
-      switch (operator) {
-        case "$in":
-          return { terms: { [fieldWithKeyword2]: normalizedValues } };
-        case "$nin":
-          if (normalizedValues.length === 0) {
-            return { match_all: {} };
-          }
-          return {
-            bool: {
-              must_not: [{ terms: { [fieldWithKeyword2]: normalizedValues } }]
-            }
-          };
-        case "$all":
-          if (normalizedValues.length === 0) {
-            return {
-              bool: {
-                must_not: [{ match_all: {} }]
-              }
-            };
-          }
-          return {
-            bool: {
-              must: normalizedValues.map((v) => ({ term: { [fieldWithKeyword2]: v } }))
-            }
-          };
-        default:
-          return { terms: { [fieldWithKeyword2]: normalizedValues } };
-      }
-    }
-    if (this.isElementOperator(operator)) {
-      switch (operator) {
-        case "$exists":
-          return value ? { exists: { field } } : { bool: { must_not: [{ exists: { field } }] } };
-        default:
-          return { exists: { field } };
-      }
-    }
-    if (this.isRegexOperator(operator)) {
-      return this.translateRegexOperator(field, value);
-    }
-    const fieldWithKeyword = this.addKeywordIfNeeded(field, value);
-    return { term: { [fieldWithKeyword]: value } };
-  }
-  /**
-   * Translates regex patterns to OpenSearch query syntax
-   */
-  translateRegexOperator(field, value) {
-    const regexValue = typeof value === "string" ? value : value.toString();
-    if (regexValue.includes("\n") || regexValue.includes("\r")) {
-      return { match: { [field]: value } };
-    }
-    let processedRegex = regexValue;
-    const hasStartAnchor = regexValue.startsWith("^");
-    const hasEndAnchor = regexValue.endsWith("$");
-    if (hasStartAnchor || hasEndAnchor) {
-      if (hasStartAnchor) {
-        processedRegex = processedRegex.substring(1);
-      }
-      if (hasEndAnchor) {
-        processedRegex = processedRegex.substring(0, processedRegex.length - 1);
-      }
-      let wildcardPattern = processedRegex;
-      if (!hasStartAnchor) {
-        wildcardPattern = "*" + wildcardPattern;
-      }
-      if (!hasEndAnchor) {
-        wildcardPattern = wildcardPattern + "*";
-      }
-      return { wildcard: { [field]: wildcardPattern } };
-    }
-    const escapedRegex = regexValue.replace(/\\/g, "\\\\");
-    return { regexp: { [field]: escapedRegex } };
-  }
-  addKeywordIfNeeded(field, value) {
-    if (typeof value === "string") {
-      return `${field}.keyword`;
-    }
-    if (Array.isArray(value) && value.every((item) => typeof item === "string")) {
-      return `${field}.keyword`;
-    }
-    return field;
-  }
-  /**
-   * Helper method to handle special cases for the $not operator
-   */
-  handleNotOperatorSpecialCases(value, field) {
-    if (value === null) {
-      return { exists: { field } };
-    }
-    if (typeof value === "object" && value !== null) {
-      if ("$eq" in value && value.$eq === null) {
-        return { exists: { field } };
-      }
-      if ("$ne" in value && value.$ne === null) {
-        return {
-          bool: {
-            must_not: [{ exists: { field } }]
-          }
-        };
-      }
-    }
-    return null;
-  }
-  translateOperator(operator, value, field) {
-    if (!this.isOperator(operator)) {
-      throw new Error(`Unsupported operator: ${operator}`);
-    }
-    if (operator === "$not" && field) {
-      const specialCaseResult = this.handleNotOperatorSpecialCases(value, field);
-      if (specialCaseResult) {
-        return specialCaseResult;
-      }
-    }
-    if (this.isLogicalOperator(operator)) {
-      if (operator === "$not" && field && typeof value === "object" && value !== null && !Array.isArray(value)) {
-        const entries = Object.entries(value);
-        if (entries.length > 0) {
-          if (entries.every(([op]) => this.isOperator(op))) {
-            const translatedCondition = this.translateFieldConditions(field, value);
-            return {
-              bool: {
-                must_not: [translatedCondition]
-              }
-            };
-          }
-          if (entries.length === 1 && entries[0] && this.isOperator(entries[0][0])) {
-            const [nestedOp, nestedVal] = entries[0];
-            const translatedNested = this.translateFieldOperator(field, nestedOp, nestedVal);
-            return {
-              bool: {
-                must_not: [translatedNested]
-              }
-            };
-          }
-        }
-      }
-      return this.translateLogicalOperator(operator, value);
-    }
-    if (field) {
-      return this.translateFieldOperator(field, operator, value);
-    }
-    return value;
-  }
-  /**
-   * Translates field conditions to OpenSearch query syntax
-   * Handles special cases like range queries and multiple operators
-   */
-  translateFieldConditions(field, conditions) {
-    if (this.canOptimizeToRangeQuery(conditions)) {
-      return this.createRangeQuery(field, conditions);
-    }
-    const queryConditions = [];
-    Object.entries(conditions).forEach(([operator, value]) => {
-      if (this.isOperator(operator)) {
-        queryConditions.push(this.translateOperator(operator, value, field));
-      } else {
-        const fieldWithKeyword = this.addKeywordIfNeeded(`${field}.${operator}`, value);
-        queryConditions.push({ term: { [fieldWithKeyword]: value } });
-      }
-    });
-    if (queryConditions.length === 1) {
-      return queryConditions[0];
-    }
-    return {
-      bool: {
-        must: queryConditions
-      }
-    };
-  }
-  /**
-   * Checks if conditions can be optimized to a range query
-   */
-  canOptimizeToRangeQuery(conditions) {
-    return Object.keys(conditions).every((op) => this.isNumericOperator(op)) && Object.keys(conditions).length > 0;
-  }
-  /**
-   * Creates a range query from numeric operators
-   */
-  createRangeQuery(field, conditions) {
-    const rangeParams = Object.fromEntries(
-      Object.entries(conditions).map(([op, val]) => [op.replace("$", ""), this.normalizeComparisonValue(val)])
-    );
-    return { range: { [field]: rangeParams } };
-  }
+	getSupportedOperators() {
+		return {
+			...BaseFilterTranslator.DEFAULT_OPERATORS,
+			logical: [
+				"$and",
+				"$or",
+				"$not"
+			],
+			array: [
+				"$in",
+				"$nin",
+				"$all"
+			],
+			regex: ["$regex"],
+			custom: []
+		};
+	}
+	translate(filter) {
+		if (this.isEmpty(filter)) return void 0;
+		this.validateFilter(filter);
+		return this.translateNode(filter);
+	}
+	translateNode(node) {
+		if (this.isPrimitive(node) || Array.isArray(node)) return node;
+		const entries = Object.entries(node);
+		const logicalOperators = [];
+		const fieldConditions = [];
+		entries.forEach(([key, value]) => {
+			if (this.isLogicalOperator(key)) logicalOperators.push([key, value]);
+			else fieldConditions.push([key, value]);
+		});
+		if (logicalOperators.length === 1 && fieldConditions.length === 0) {
+			const [operator, value] = logicalOperators[0];
+			if (!Array.isArray(value) && typeof value !== "object") throw new Error(`Invalid logical operator structure: ${operator} must have an array or object value`);
+			return this.translateLogicalOperator(operator, value);
+		}
+		const fieldConditionQueries = fieldConditions.map(([key, value]) => {
+			if (typeof value === "object" && value !== null && !Array.isArray(value)) {
+				const hasOperators = Object.keys(value).some((k) => this.isOperator(k));
+				const nestedField = `metadata.${key}`;
+				return hasOperators ? this.translateFieldConditions(nestedField, value) : this.translateNestedObject(nestedField, value);
+			}
+			if (Array.isArray(value)) return { terms: { [this.addKeywordIfNeeded(`metadata.${key}`, value)]: value } };
+			return { term: { [this.addKeywordIfNeeded(`metadata.${key}`, value)]: value } };
+		});
+		if (logicalOperators.length > 0) return { bool: { must: [...logicalOperators.map(([operator, value]) => this.translateOperator(operator, value)), ...fieldConditionQueries] } };
+		if (fieldConditionQueries.length > 1) return { bool: { must: fieldConditionQueries } };
+		if (fieldConditionQueries.length === 1) return fieldConditionQueries[0];
+		return { match_all: {} };
+	}
+	/**
+	* Handles translation of nested objects with dot notation fields
+	*/
+	translateNestedObject(field, value) {
+		return { bool: { must: Object.entries(value).map(([subField, subValue]) => {
+			const fullField = `${field}.${subField}`;
+			if (this.isOperator(subField)) return this.translateOperator(subField, subValue, field);
+			if (typeof subValue === "object" && subValue !== null && !Array.isArray(subValue)) {
+				if (Object.keys(subValue).some((k) => this.isOperator(k))) return this.translateFieldConditions(fullField, subValue);
+				return this.translateNestedObject(fullField, subValue);
+			}
+			return { term: { [this.addKeywordIfNeeded(fullField, subValue)]: subValue } };
+		}) } };
+	}
+	translateLogicalOperator(operator, value) {
+		const conditions = Array.isArray(value) ? value.map((item) => this.translateNode(item)) : [this.translateNode(value)];
+		switch (operator) {
+			case "$and":
+				if (Array.isArray(value) && value.length === 0) return { match_all: {} };
+				return { bool: { must: conditions } };
+			case "$or":
+				if (Array.isArray(value) && value.length === 0) return { bool: { must_not: [{ match_all: {} }] } };
+				return { bool: { should: conditions } };
+			case "$not": return { bool: { must_not: conditions } };
+			default: return value;
+		}
+	}
+	translateFieldOperator(field, operator, value) {
+		if (this.isBasicOperator(operator)) {
+			const normalizedValue = this.normalizeComparisonValue(value);
+			const fieldWithKeyword = this.addKeywordIfNeeded(field, value);
+			switch (operator) {
+				case "$eq":
+					if (value === null) return { bool: { must_not: [{ exists: { field } }] } };
+					return { term: { [fieldWithKeyword]: normalizedValue } };
+				case "$ne":
+					if (value === null) return { exists: { field } };
+					return { bool: { must_not: [{ term: { [fieldWithKeyword]: normalizedValue } }] } };
+				default: return { term: { [fieldWithKeyword]: normalizedValue } };
+			}
+		}
+		if (this.isNumericOperator(operator)) {
+			const normalizedValue = this.normalizeComparisonValue(value);
+			const rangeOp = operator.replace("$", "");
+			return { range: { [field]: { [rangeOp]: normalizedValue } } };
+		}
+		if (this.isArrayOperator(operator)) {
+			if (!Array.isArray(value)) throw new Error(`Invalid array operator value: ${operator} requires an array value`);
+			const normalizedValues = this.normalizeArrayValues(value);
+			const fieldWithKeyword = this.addKeywordIfNeeded(field, value);
+			switch (operator) {
+				case "$in": return { terms: { [fieldWithKeyword]: normalizedValues } };
+				case "$nin":
+					if (normalizedValues.length === 0) return { match_all: {} };
+					return { bool: { must_not: [{ terms: { [fieldWithKeyword]: normalizedValues } }] } };
+				case "$all":
+					if (normalizedValues.length === 0) return { bool: { must_not: [{ match_all: {} }] } };
+					return { bool: { must: normalizedValues.map((v) => ({ term: { [fieldWithKeyword]: v } })) } };
+				default: return { terms: { [fieldWithKeyword]: normalizedValues } };
+			}
+		}
+		if (this.isElementOperator(operator)) switch (operator) {
+			case "$exists": return value ? { exists: { field } } : { bool: { must_not: [{ exists: { field } }] } };
+			default: return { exists: { field } };
+		}
+		if (this.isRegexOperator(operator)) return this.translateRegexOperator(field, value);
+		return { term: { [this.addKeywordIfNeeded(field, value)]: value } };
+	}
+	/**
+	* Translates regex patterns to OpenSearch query syntax
+	*/
+	translateRegexOperator(field, value) {
+		const regexValue = typeof value === "string" ? value : value.toString();
+		if (regexValue.includes("\n") || regexValue.includes("\r")) return { match: { [field]: value } };
+		let processedRegex = regexValue;
+		const hasStartAnchor = regexValue.startsWith("^");
+		const hasEndAnchor = regexValue.endsWith("$");
+		if (hasStartAnchor || hasEndAnchor) {
+			if (hasStartAnchor) processedRegex = processedRegex.substring(1);
+			if (hasEndAnchor) processedRegex = processedRegex.substring(0, processedRegex.length - 1);
+			let wildcardPattern = processedRegex;
+			if (!hasStartAnchor) wildcardPattern = "*" + wildcardPattern;
+			if (!hasEndAnchor) wildcardPattern = wildcardPattern + "*";
+			return { wildcard: { [field]: wildcardPattern } };
+		}
+		const escapedRegex = regexValue.replace(/\\/g, "\\\\");
+		return { regexp: { [field]: escapedRegex } };
+	}
+	addKeywordIfNeeded(field, value) {
+		if (typeof value === "string") return `${field}.keyword`;
+		if (Array.isArray(value) && value.every((item) => typeof item === "string")) return `${field}.keyword`;
+		return field;
+	}
+	/**
+	* Helper method to handle special cases for the $not operator
+	*/
+	handleNotOperatorSpecialCases(value, field) {
+		if (value === null) return { exists: { field } };
+		if (typeof value === "object" && value !== null) {
+			if ("$eq" in value && value.$eq === null) return { exists: { field } };
+			if ("$ne" in value && value.$ne === null) return { bool: { must_not: [{ exists: { field } }] } };
+		}
+		return null;
+	}
+	translateOperator(operator, value, field) {
+		if (!this.isOperator(operator)) throw new Error(`Unsupported operator: ${operator}`);
+		if (operator === "$not" && field) {
+			const specialCaseResult = this.handleNotOperatorSpecialCases(value, field);
+			if (specialCaseResult) return specialCaseResult;
+		}
+		if (this.isLogicalOperator(operator)) {
+			if (operator === "$not" && field && typeof value === "object" && value !== null && !Array.isArray(value)) {
+				const entries = Object.entries(value);
+				if (entries.length > 0) {
+					if (entries.every(([op]) => this.isOperator(op))) return { bool: { must_not: [this.translateFieldConditions(field, value)] } };
+					if (entries.length === 1 && entries[0] && this.isOperator(entries[0][0])) {
+						const [nestedOp, nestedVal] = entries[0];
+						return { bool: { must_not: [this.translateFieldOperator(field, nestedOp, nestedVal)] } };
+					}
+				}
+			}
+			return this.translateLogicalOperator(operator, value);
+		}
+		if (field) return this.translateFieldOperator(field, operator, value);
+		return value;
+	}
+	/**
+	* Translates field conditions to OpenSearch query syntax
+	* Handles special cases like range queries and multiple operators
+	*/
+	translateFieldConditions(field, conditions) {
+		if (this.canOptimizeToRangeQuery(conditions)) return this.createRangeQuery(field, conditions);
+		const queryConditions = [];
+		Object.entries(conditions).forEach(([operator, value]) => {
+			if (this.isOperator(operator)) queryConditions.push(this.translateOperator(operator, value, field));
+			else {
+				const fieldWithKeyword = this.addKeywordIfNeeded(`${field}.${operator}`, value);
+				queryConditions.push({ term: { [fieldWithKeyword]: value } });
+			}
+		});
+		if (queryConditions.length === 1) return queryConditions[0];
+		return { bool: { must: queryConditions } };
+	}
+	/**
+	* Checks if conditions can be optimized to a range query
+	*/
+	canOptimizeToRangeQuery(conditions) {
+		return Object.keys(conditions).every((op) => this.isNumericOperator(op)) && Object.keys(conditions).length > 0;
+	}
+	/**
+	* Creates a range query from numeric operators
+	*/
+	createRangeQuery(field, conditions) {
+		const rangeParams = Object.fromEntries(Object.entries(conditions).map(([op, val]) => [op.replace("$", ""), this.normalizeComparisonValue(val)]));
+		return { range: { [field]: rangeParams } };
+	}
 };
-
-// src/vector/index.ts
-var METRIC_MAPPING = {
-  cosine: "cosinesimil",
-  euclidean: "l2",
-  dotproduct: "innerproduct"
+//#endregion
+//#region src/vector/index.ts
+const METRIC_MAPPING = {
+	cosine: "cosinesimil",
+	euclidean: "l2",
+	dotproduct: "innerproduct"
 };
-var REVERSE_METRIC_MAPPING = {
-  cosinesimil: "cosine",
-  l2: "euclidean",
-  innerproduct: "dotproduct"
+const REVERSE_METRIC_MAPPING = {
+	cosinesimil: "cosine",
+	l2: "euclidean",
+	innerproduct: "dotproduct"
 };
 var OpenSearchVector = class extends MastraVector {
-  client;
-  /**
-   * Creates a new OpenSearchVector client.
-   *
-   * @param config - OpenSearch client configuration options plus a required id.
-   * @see OpenSearchVectorConfig for all available options.
-   */
-  constructor({ id, ...clientOptions }) {
-    super({ id });
-    this.client = new Client(clientOptions);
-  }
-  /**
-   * Creates a new collection with the specified configuration.
-   *
-   * @param {string} indexName - The name of the collection to create.
-   * @param {number} dimension - The dimension of the vectors to be stored in the collection.
-   * @param {'cosine' | 'euclidean' | 'dotproduct'} [metric=cosine] - The metric to use to sort vectors in the collection.
-   * @returns {Promise<void>} A promise that resolves when the collection is created.
-   */
-  async createIndex({ indexName, dimension, metric = "cosine" }) {
-    if (!Number.isInteger(dimension) || dimension <= 0) {
-      throw new MastraError({
-        id: createVectorErrorId("OPENSEARCH", "CREATE_INDEX", "INVALID_ARGS"),
-        domain: ErrorDomain.STORAGE,
-        category: ErrorCategory.USER,
-        text: "Dimension must be a positive integer",
-        details: { indexName, dimension }
-      });
-    }
-    try {
-      await this.client.indices.create({
-        index: indexName,
-        body: {
-          settings: { index: { knn: true } },
-          mappings: {
-            properties: {
-              metadata: { type: "object" },
-              id: { type: "keyword" },
-              embedding: {
-                type: "knn_vector",
-                dimension,
-                method: {
-                  name: "hnsw",
-                  space_type: METRIC_MAPPING[metric],
-                  engine: "faiss",
-                  parameters: { ef_construction: 128, m: 16 }
-                }
-              }
-            }
-          }
-        }
-      });
-    } catch (error) {
-      const message = error?.message || error?.toString();
-      if (message && message.toLowerCase().includes("already exists")) {
-        await this.validateExistingIndex(indexName, dimension, metric);
-        return;
-      }
-      throw new MastraError(
-        {
-          id: createVectorErrorId("OPENSEARCH", "CREATE_INDEX", "FAILED"),
-          domain: ErrorDomain.STORAGE,
-          category: ErrorCategory.THIRD_PARTY,
-          details: { indexName, dimension, metric }
-        },
-        error
-      );
-    }
-  }
-  /**
-   * Lists all indexes.
-   *
-   * @returns {Promise<string[]>} A promise that resolves to an array of indexes.
-   */
-  async listIndexes() {
-    try {
-      const response = await this.client.cat.indices({ format: "json" });
-      const indexes = response.body.map((record) => record.index).filter((index) => index !== void 0);
-      return indexes;
-    } catch (error) {
-      throw new MastraError(
-        {
-          id: createVectorErrorId("OPENSEARCH", "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 }) {
-    const { body: indexInfo } = await this.client.indices.get({ index: indexName });
-    const mappings = indexInfo[indexName]?.mappings;
-    const embedding = mappings?.properties?.embedding;
-    const spaceType = embedding.method.space_type;
-    const { body: countInfo } = await this.client.count({ index: indexName });
-    return {
-      dimension: Number(embedding.dimension),
-      count: Number(countInfo.count),
-      metric: REVERSE_METRIC_MAPPING[spaceType]
-    };
-  }
-  /**
-   * Deletes the specified index.
-   *
-   * @param {string} indexName - The name of the index to delete.
-   * @returns {Promise<void>} A promise that resolves when the index is deleted.
-   */
-  async deleteIndex({ indexName }) {
-    try {
-      await this.client.indices.delete({ index: indexName });
-    } catch (error) {
-      const mastraError = new MastraError(
-        {
-          id: createVectorErrorId("OPENSEARCH", "DELETE_INDEX", "FAILED"),
-          domain: ErrorDomain.STORAGE,
-          category: ErrorCategory.THIRD_PARTY,
-          details: { indexName }
-        },
-        error
-      );
-      this.logger?.error(mastraError.toString());
-      this.logger?.trackException(mastraError);
-    }
-  }
-  /**
-   * Inserts or updates vectors in the specified collection.
-   *
-   * @param {string} indexName - The name of the collection to upsert into.
-   * @param {number[][]} vectors - An array of vectors to upsert.
-   * @param {Record<string, any>[]} [metadata] - An optional array of metadata objects corresponding to each vector.
-   * @param {string[]} [ids] - An optional array of IDs corresponding to each vector. If not provided, new IDs will be generated.
-   * @returns {Promise<string[]>} A promise that resolves to an array of IDs of the upserted vectors.
-   */
-  async upsert({ indexName, vectors, metadata = [], ids }) {
-    validateUpsert("OPENSEARCH", vectors, metadata, ids, true);
-    const vectorIds = ids || vectors.map(() => crypto.randomUUID());
-    const operations = [];
-    try {
-      const indexInfo = await this.describeIndex({ indexName });
-      this.validateVectorDimensions(vectors, indexInfo.dimension);
-      for (let i = 0; i < vectors.length; i++) {
-        const operation = {
-          index: {
-            _index: indexName,
-            _id: vectorIds[i]
-          }
-        };
-        const document = {
-          id: vectorIds[i],
-          embedding: vectors[i],
-          metadata: metadata[i] || {}
-        };
-        operations.push(operation);
-        operations.push(document);
-      }
-      if (operations.length > 0) {
-        await this.client.bulk({ body: operations, refresh: true });
-      }
-      return vectorIds;
-    } catch (error) {
-      throw new MastraError(
-        {
-          id: createVectorErrorId("OPENSEARCH", "UPSERT", "FAILED"),
-          domain: ErrorDomain.STORAGE,
-          category: ErrorCategory.THIRD_PARTY,
-          details: { indexName, vectorCount: vectors?.length || 0 }
-        },
-        error
-      );
-    }
-  }
-  /**
-   * Queries the specified collection using a vector and optional filter.
-   *
-   * @param {string} indexName - The name of the collection to query.
-   * @param {number[]} queryVector - The vector to query with.
-   * @param {number} [topK] - The maximum number of results to return.
-   * @param {Record<string, any>} [filter] - An optional filter to apply to the query. For more on filters in OpenSearch, see the filtering reference: https://opensearch.org/docs/latest/query-dsl/
-   * @param {boolean} [includeVectors=false] - Whether to include the vectors in the response.
-   * @returns {Promise<QueryResult[]>} A promise that resolves to an array of query results.
-   */
-  async query({
-    indexName,
-    queryVector,
-    filter,
-    topK = 10,
-    includeVector = false
-  }) {
-    if (!queryVector) {
-      throw new MastraError({
-        id: createVectorErrorId("OPENSEARCH", "QUERY", "MISSING_VECTOR"),
-        text: "queryVector is required for OpenSearch queries. Metadata-only queries are not supported by this vector store.",
-        domain: ErrorDomain.STORAGE,
-        category: ErrorCategory.USER,
-        details: { indexName }
-      });
-    }
-    validateTopK("OPENSEARCH", topK);
-    try {
-      const translatedFilter = this.transformFilter(filter);
-      const response = await this.client.search({
-        index: indexName,
-        body: {
-          query: {
-            bool: {
-              must: { knn: { embedding: { vector: queryVector, k: topK } } },
-              filter: translatedFilter ? [translatedFilter] : []
-            }
-          },
-          _source: ["id", "metadata", "embedding"]
-        }
-      });
-      const results = response.body.hits.hits.map((hit) => {
-        const source = hit._source || {};
-        return {
-          id: String(source.id || ""),
-          score: typeof hit._score === "number" ? hit._score : 0,
-          metadata: source.metadata || {},
-          ...includeVector && { vector: source.embedding }
-        };
-      });
-      return results;
-    } catch (error) {
-      throw new MastraError(
-        {
-          id: createVectorErrorId("OPENSEARCH", "QUERY", "FAILED"),
-          domain: ErrorDomain.STORAGE,
-          category: ErrorCategory.THIRD_PARTY,
-          details: { indexName, topK }
-        },
-        error
-      );
-    }
-  }
-  /**
-   * Validates the dimensions of the vectors.
-   *
-   * @param {number[][]} vectors - The vectors to validate.
-   * @param {number} dimension - The dimension of the vectors.
-   * @returns {void}
-   */
-  validateVectorDimensions(vectors, dimension) {
-    if (vectors.some((vector) => vector.length !== dimension)) {
-      throw new Error("Vector dimension does not match index dimension");
-    }
-  }
-  /**
-   * Transforms the filter to the OpenSearch DSL.
-   *
-   * @param {OpenSearchVectorFilter} filter - The filter to transform.
-   * @returns {Record<string, any>} The transformed filter.
-   */
-  transformFilter(filter) {
-    const translator = new OpenSearchFilterTranslator();
-    return translator.translate(filter);
-  }
-  /**
-   * Updates vectors by ID or filter with the provided vector and/or metadata.
-   * @param params - Parameters containing either id or filter for targeting vectors to update
-   * @param params.indexName - The name of the index containing the vector(s).
-   * @param params.id - The ID of a single vector to update (mutually exclusive with filter).
-   * @param params.filter - A filter to match multiple vectors to update (mutually exclusive with id).
-   * @param params.update - An object containing the vector and/or metadata to update.
-   * @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(params) {
-    const { indexName, update } = params;
-    if ("id" in params && "filter" in params && params.id && params.filter) {
-      throw new MastraError({
-        id: createVectorErrorId("OPENSEARCH", "UPDATE_VECTOR", "MUTUALLY_EXCLUSIVE"),
-        domain: ErrorDomain.STORAGE,
-        category: ErrorCategory.USER,
-        text: "id and filter are mutually exclusive",
-        details: { indexName }
-      });
-    }
-    if (!update.vector && !update.metadata) {
-      throw new MastraError({
-        id: createVectorErrorId("OPENSEARCH", "UPDATE_VECTOR", "NO_UPDATES"),
-        domain: ErrorDomain.STORAGE,
-        category: ErrorCategory.USER,
-        text: "No updates provided",
-        details: { indexName }
-      });
-    }
-    if ("filter" in params && params.filter && Object.keys(params.filter).length === 0) {
-      throw new MastraError({
-        id: createVectorErrorId("OPENSEARCH", "UPDATE_VECTOR", "EMPTY_FILTER"),
-        domain: ErrorDomain.STORAGE,
-        category: ErrorCategory.USER,
-        text: "Cannot update with empty filter",
-        details: { indexName }
-      });
-    }
-    if ("id" in params && params.id) {
-      await this.updateVectorById(indexName, params.id, update);
-    } else if ("filter" in params && params.filter) {
-      await this.updateVectorsByFilter(indexName, params.filter, update);
-    } else {
-      throw new MastraError({
-        id: createVectorErrorId("OPENSEARCH", "UPDATE_VECTOR", "NO_TARGET"),
-        domain: ErrorDomain.STORAGE,
-        category: ErrorCategory.USER,
-        text: "Either id or filter must be provided",
-        details: { indexName }
-      });
-    }
-  }
-  /**
-   * Updates a single vector by its ID.
-   */
-  async updateVectorById(indexName, id, update) {
-    let existingDoc;
-    try {
-      const { body } = await this.client.get({
-        index: indexName,
-        id
-      }).catch(() => {
-        throw new Error(`Document with ID ${id} not found in index ${indexName}`);
-      });
-      if (!body || !body._source) {
-        throw new Error(`Document with ID ${id} has no source data in index ${indexName}`);
-      }
-      existingDoc = body;
-    } catch (error) {
-      throw new MastraError(
-        {
-          id: createVectorErrorId("OPENSEARCH", "UPDATE_VECTOR", "FAILED"),
-          domain: ErrorDomain.STORAGE,
-          category: ErrorCategory.USER,
-          details: {
-            indexName,
-            id
-          }
-        },
-        error
-      );
-    }
-    const source = existingDoc._source;
-    const updatedDoc = {
-      id: source?.id || id
-    };
-    try {
-      if (update.vector) {
-        const indexInfo = await this.describeIndex({ indexName });
-        this.validateVectorDimensions([update.vector], indexInfo.dimension);
-        updatedDoc.embedding = update.vector;
-      } else if (source?.embedding) {
-        updatedDoc.embedding = source.embedding;
-      }
-      if (update.metadata) {
-        updatedDoc.metadata = update.metadata;
-      } else {
-        updatedDoc.metadata = source?.metadata || {};
-      }
-      await this.client.index({
-        index: indexName,
-        id,
-        body: updatedDoc,
-        refresh: true
-      });
-    } catch (error) {
-      throw new MastraError(
-        {
-          id: createVectorErrorId("OPENSEARCH", "UPDATE_VECTOR", "FAILED"),
-          domain: ErrorDomain.STORAGE,
-          category: ErrorCategory.THIRD_PARTY,
-          details: {
-            indexName,
-            id
-          }
-        },
-        error
-      );
-    }
-  }
-  /**
-   * Updates multiple vectors matching a filter.
-   */
-  async updateVectorsByFilter(indexName, filter, update) {
-    try {
-      const translator = new OpenSearchFilterTranslator();
-      const translatedFilter = translator.translate(filter);
-      const scriptSource = [];
-      const scriptParams = {};
-      if (update.vector) {
-        scriptSource.push("ctx._source.embedding = params.embedding");
-        scriptParams.embedding = update.vector;
-      }
-      if (update.metadata) {
-        scriptSource.push("ctx._source.metadata = params.metadata");
-        scriptParams.metadata = update.metadata;
-      }
-      await this.client.updateByQuery({
-        index: indexName,
-        body: {
-          query: translatedFilter || { match_all: {} },
-          script: {
-            source: scriptSource.join("; "),
-            params: scriptParams,
-            lang: "painless"
-          }
-        },
-        refresh: true
-      });
-    } catch (error) {
-      throw new MastraError(
-        {
-          id: createVectorErrorId("OPENSEARCH", "UPDATE_VECTOR_BY_FILTER", "FAILED"),
-          domain: ErrorDomain.STORAGE,
-          category: ErrorCategory.THIRD_PARTY,
-          details: {
-            indexName,
-            filter: JSON.stringify(filter)
-          }
-        },
-        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.delete({
-        index: indexName,
-        id,
-        refresh: true
-      });
-    } catch (error) {
-      if (error && typeof error === "object" && "statusCode" in error && error.statusCode === 404) {
-        return;
-      }
-      throw new MastraError(
-        {
-          id: createVectorErrorId("OPENSEARCH", "DELETE_VECTOR", "FAILED"),
-          domain: ErrorDomain.STORAGE,
-          category: ErrorCategory.THIRD_PARTY,
-          details: {
-            indexName,
-            ...id && { id }
-          }
-        },
-        error
-      );
-    }
-  }
-  async deleteVectors({ indexName, filter, ids }) {
-    if (ids && filter) {
-      throw new MastraError({
-        id: createVectorErrorId("OPENSEARCH", "DELETE_VECTORS", "MUTUALLY_EXCLUSIVE"),
-        domain: ErrorDomain.STORAGE,
-        category: ErrorCategory.USER,
-        text: "ids and filter are mutually exclusive",
-        details: { indexName }
-      });
-    }
-    if (!ids && !filter) {
-      throw new MastraError({
-        id: createVectorErrorId("OPENSEARCH", "DELETE_VECTORS", "NO_TARGET"),
-        domain: ErrorDomain.STORAGE,
-        category: ErrorCategory.USER,
-        text: "Either filter or ids must be provided",
-        details: { indexName }
-      });
-    }
-    if (ids && ids.length === 0) {
-      throw new MastraError({
-        id: createVectorErrorId("OPENSEARCH", "DELETE_VECTORS", "EMPTY_IDS"),
-        domain: ErrorDomain.STORAGE,
-        category: ErrorCategory.USER,
-        text: "Cannot delete with empty ids array",
-        details: { indexName }
-      });
-    }
-    if (filter && Object.keys(filter).length === 0) {
-      throw new MastraError({
-        id: createVectorErrorId("OPENSEARCH", "DELETE_VECTORS", "EMPTY_FILTER"),
-        domain: ErrorDomain.STORAGE,
-        category: ErrorCategory.USER,
-        text: "Cannot delete with empty filter",
-        details: { indexName }
-      });
-    }
-    try {
-      if (ids) {
-        const bulkBody = ids.flatMap((id) => [{ delete: { _index: indexName, _id: id } }]);
-        await this.client.bulk({
-          body: bulkBody,
-          refresh: true
-        });
-      } else if (filter) {
-        const translator = new OpenSearchFilterTranslator();
-        const translatedFilter = translator.translate(filter);
-        await this.client.deleteByQuery({
-          index: indexName,
-          body: {
-            query: translatedFilter || { match_all: {} }
-          },
-          refresh: true
-        });
-      }
-    } catch (error) {
-      if (error instanceof MastraError) throw error;
-      throw new MastraError(
-        {
-          id: createVectorErrorId("OPENSEARCH", "DELETE_VECTORS", "FAILED"),
-          domain: ErrorDomain.STORAGE,
-          category: ErrorCategory.THIRD_PARTY,
-          details: {
-            indexName,
-            ...filter && { filter: JSON.stringify(filter) },
-            ...ids && { idsCount: ids.length }
-          }
-        },
-        error
-      );
-    }
-  }
+	client;
+	/**
+	* Creates a new OpenSearchVector client.
+	*
+	* @param config - OpenSearch client configuration options plus a required id.
+	* @see OpenSearchVectorConfig for all available options.
+	*/
+	constructor({ id, ...clientOptions }) {
+		super({ id });
+		this.client = new Client(clientOptions);
+	}
+	/**
+	* Creates a new collection with the specified configuration.
+	*
+	* @param {string} indexName - The name of the collection to create.
+	* @param {number} dimension - The dimension of the vectors to be stored in the collection.
+	* @param {'cosine' | 'euclidean' | 'dotproduct'} [metric=cosine] - The metric to use to sort vectors in the collection.
+	* @returns {Promise<void>} A promise that resolves when the collection is created.
+	*/
+	async createIndex({ indexName, dimension, metric = "cosine" }) {
+		if (!Number.isInteger(dimension) || dimension <= 0) throw new MastraError({
+			id: createVectorErrorId("OPENSEARCH", "CREATE_INDEX", "INVALID_ARGS"),
+			domain: ErrorDomain.STORAGE,
+			category: ErrorCategory.USER,
+			text: "Dimension must be a positive integer",
+			details: {
+				indexName,
+				dimension
+			}
+		});
+		try {
+			await this.client.indices.create({
+				index: indexName,
+				body: {
+					settings: { index: { knn: true } },
+					mappings: { properties: {
+						metadata: { type: "object" },
+						id: { type: "keyword" },
+						embedding: {
+							type: "knn_vector",
+							dimension,
+							method: {
+								name: "hnsw",
+								space_type: METRIC_MAPPING[metric],
+								engine: "faiss",
+								parameters: {
+									ef_construction: 128,
+									m: 16
+								}
+							}
+						}
+					} }
+				}
+			});
+		} catch (error) {
+			const message = error?.message || error?.toString();
+			if (message && message.toLowerCase().includes("already exists")) {
+				await this.validateExistingIndex(indexName, dimension, metric);
+				return;
+			}
+			throw new MastraError({
+				id: createVectorErrorId("OPENSEARCH", "CREATE_INDEX", "FAILED"),
+				domain: ErrorDomain.STORAGE,
+				category: ErrorCategory.THIRD_PARTY,
+				details: {
+					indexName,
+					dimension,
+					metric
+				}
+			}, error);
+		}
+	}
+	/**
+	* Lists all indexes.
+	*
+	* @returns {Promise<string[]>} A promise that resolves to an array of indexes.
+	*/
+	async listIndexes() {
+		try {
+			return (await this.client.cat.indices({ format: "json" })).body.map((record) => record.index).filter((index) => index !== void 0);
+		} catch (error) {
+			throw new MastraError({
+				id: createVectorErrorId("OPENSEARCH", "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 }) {
+		const { body: indexInfo } = await this.client.indices.get({ index: indexName });
+		const embedding = (indexInfo[indexName]?.mappings)?.properties?.embedding;
+		const spaceType = embedding.method.space_type;
+		const { body: countInfo } = await this.client.count({ index: indexName });
+		return {
+			dimension: Number(embedding.dimension),
+			count: Number(countInfo.count),
+			metric: REVERSE_METRIC_MAPPING[spaceType]
+		};
+	}
+	/**
+	* Deletes the specified index.
+	*
+	* @param {string} indexName - The name of the index to delete.
+	* @returns {Promise<void>} A promise that resolves when the index is deleted.
+	*/
+	async deleteIndex({ indexName }) {
+		try {
+			await this.client.indices.delete({ index: indexName });
+		} catch (error) {
+			const mastraError = new MastraError({
+				id: createVectorErrorId("OPENSEARCH", "DELETE_INDEX", "FAILED"),
+				domain: ErrorDomain.STORAGE,
+				category: ErrorCategory.THIRD_PARTY,
+				details: { indexName }
+			}, error);
+			this.logger?.error(mastraError.toString());
+			this.logger?.trackException(mastraError);
+		}
+	}
+	/**
+	* Inserts or updates vectors in the specified collection.
+	*
+	* @param {string} indexName - The name of the collection to upsert into.
+	* @param {number[][]} vectors - An array of vectors to upsert.
+	* @param {Record<string, any>[]} [metadata] - An optional array of metadata objects corresponding to each vector.
+	* @param {string[]} [ids] - An optional array of IDs corresponding to each vector. If not provided, new IDs will be generated.
+	* @returns {Promise<string[]>} A promise that resolves to an array of IDs of the upserted vectors.
+	*/
+	async upsert({ indexName, vectors, metadata = [], ids }) {
+		validateUpsert("OPENSEARCH", vectors, metadata, ids, true);
+		const vectorIds = ids || vectors.map(() => crypto.randomUUID());
+		const operations = [];
+		try {
+			const indexInfo = await this.describeIndex({ indexName });
+			this.validateVectorDimensions(vectors, indexInfo.dimension);
+			for (let i = 0; i < vectors.length; i++) {
+				const operation = { index: {
+					_index: indexName,
+					_id: vectorIds[i]
+				} };
+				const document = {
+					id: vectorIds[i],
+					embedding: vectors[i],
+					metadata: metadata[i] || {}
+				};
+				operations.push(operation);
+				operations.push(document);
+			}
+			if (operations.length > 0) await this.client.bulk({
+				body: operations,
+				refresh: true
+			});
+			return vectorIds;
+		} catch (error) {
+			throw new MastraError({
+				id: createVectorErrorId("OPENSEARCH", "UPSERT", "FAILED"),
+				domain: ErrorDomain.STORAGE,
+				category: ErrorCategory.THIRD_PARTY,
+				details: {
+					indexName,
+					vectorCount: vectors?.length || 0
+				}
+			}, error);
+		}
+	}
+	/**
+	* Queries the specified collection using a vector and optional filter.
+	*
+	* @param {string} indexName - The name of the collection to query.
+	* @param {number[]} queryVector - The vector to query with.
+	* @param {number} [topK] - The maximum number of results to return.
+	* @param {Record<string, any>} [filter] - An optional filter to apply to the query. For more on filters in OpenSearch, see the filtering reference: https://opensearch.org/docs/latest/query-dsl/
+	* @param {boolean} [includeVectors=false] - Whether to include the vectors in the response.
+	* @returns {Promise<QueryResult[]>} A promise that resolves to an array of query results.
+	*/
+	async query({ indexName, queryVector, filter, topK = 10, includeVector = false }) {
+		if (!queryVector) throw new MastraError({
+			id: createVectorErrorId("OPENSEARCH", "QUERY", "MISSING_VECTOR"),
+			text: "queryVector is required for OpenSearch queries. Metadata-only queries are not supported by this vector store.",
+			domain: ErrorDomain.STORAGE,
+			category: ErrorCategory.USER,
+			details: { indexName }
+		});
+		validateTopK("OPENSEARCH", topK);
+		try {
+			const translatedFilter = this.transformFilter(filter);
+			return (await this.client.search({
+				index: indexName,
+				body: {
+					query: { bool: {
+						must: { knn: { embedding: {
+							vector: queryVector,
+							k: topK
+						} } },
+						filter: translatedFilter ? [translatedFilter] : []
+					} },
+					_source: [
+						"id",
+						"metadata",
+						"embedding"
+					]
+				}
+			})).body.hits.hits.map((hit) => {
+				const source = hit._source || {};
+				return {
+					id: String(source.id || ""),
+					score: typeof hit._score === "number" ? hit._score : 0,
+					metadata: source.metadata || {},
+					...includeVector && { vector: source.embedding }
+				};
+			});
+		} catch (error) {
+			throw new MastraError({
+				id: createVectorErrorId("OPENSEARCH", "QUERY", "FAILED"),
+				domain: ErrorDomain.STORAGE,
+				category: ErrorCategory.THIRD_PARTY,
+				details: {
+					indexName,
+					topK
+				}
+			}, error);
+		}
+	}
+	/**
+	* Validates the dimensions of the vectors.
+	*
+	* @param {number[][]} vectors - The vectors to validate.
+	* @param {number} dimension - The dimension of the vectors.
+	* @returns {void}
+	*/
+	validateVectorDimensions(vectors, dimension) {
+		if (vectors.some((vector) => vector.length !== dimension)) throw new Error("Vector dimension does not match index dimension");
+	}
+	/**
+	* Transforms the filter to the OpenSearch DSL.
+	*
+	* @param {OpenSearchVectorFilter} filter - The filter to transform.
+	* @returns {Record<string, any>} The transformed filter.
+	*/
+	transformFilter(filter) {
+		return new OpenSearchFilterTranslator().translate(filter);
+	}
+	/**
+	* Updates vectors by ID or filter with the provided vector and/or metadata.
+	* @param params - Parameters containing either id or filter for targeting vectors to update
+	* @param params.indexName - The name of the index containing the vector(s).
+	* @param params.id - The ID of a single vector to update (mutually exclusive with filter).
+	* @param params.filter - A filter to match multiple vectors to update (mutually exclusive with id).
+	* @param params.update - An object containing the vector and/or metadata to update.
+	* @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(params) {
+		const { indexName, update } = params;
+		if ("id" in params && "filter" in params && params.id && params.filter) throw new MastraError({
+			id: createVectorErrorId("OPENSEARCH", "UPDATE_VECTOR", "MUTUALLY_EXCLUSIVE"),
+			domain: ErrorDomain.STORAGE,
+			category: ErrorCategory.USER,
+			text: "id and filter are mutually exclusive",
+			details: { indexName }
+		});
+		if (!update.vector && !update.metadata) throw new MastraError({
+			id: createVectorErrorId("OPENSEARCH", "UPDATE_VECTOR", "NO_UPDATES"),
+			domain: ErrorDomain.STORAGE,
+			category: ErrorCategory.USER,
+			text: "No updates provided",
+			details: { indexName }
+		});
+		if ("filter" in params && params.filter && Object.keys(params.filter).length === 0) throw new MastraError({
+			id: createVectorErrorId("OPENSEARCH", "UPDATE_VECTOR", "EMPTY_FILTER"),
+			domain: ErrorDomain.STORAGE,
+			category: ErrorCategory.USER,
+			text: "Cannot update with empty filter",
+			details: { indexName }
+		});
+		if ("id" in params && params.id) await this.updateVectorById(indexName, params.id, update);
+		else if ("filter" in params && params.filter) await this.updateVectorsByFilter(indexName, params.filter, update);
+		else throw new MastraError({
+			id: createVectorErrorId("OPENSEARCH", "UPDATE_VECTOR", "NO_TARGET"),
+			domain: ErrorDomain.STORAGE,
+			category: ErrorCategory.USER,
+			text: "Either id or filter must be provided",
+			details: { indexName }
+		});
+	}
+	/**
+	* Updates a single vector by its ID.
+	*/
+	async updateVectorById(indexName, id, update) {
+		let existingDoc;
+		try {
+			const { body } = await this.client.get({
+				index: indexName,
+				id
+			}).catch(() => {
+				throw new Error(`Document with ID ${id} not found in index ${indexName}`);
+			});
+			if (!body || !body._source) throw new Error(`Document with ID ${id} has no source data in index ${indexName}`);
+			existingDoc = body;
+		} catch (error) {
+			throw new MastraError({
+				id: createVectorErrorId("OPENSEARCH", "UPDATE_VECTOR", "FAILED"),
+				domain: ErrorDomain.STORAGE,
+				category: ErrorCategory.USER,
+				details: {
+					indexName,
+					id
+				}
+			}, error);
+		}
+		const source = existingDoc._source;
+		const updatedDoc = { id: source?.id || id };
+		try {
+			if (update.vector) {
+				const indexInfo = await this.describeIndex({ indexName });
+				this.validateVectorDimensions([update.vector], indexInfo.dimension);
+				updatedDoc.embedding = update.vector;
+			} else if (source?.embedding) updatedDoc.embedding = source.embedding;
+			if (update.metadata) updatedDoc.metadata = update.metadata;
+			else updatedDoc.metadata = source?.metadata || {};
+			await this.client.index({
+				index: indexName,
+				id,
+				body: updatedDoc,
+				refresh: true
+			});
+		} catch (error) {
+			throw new MastraError({
+				id: createVectorErrorId("OPENSEARCH", "UPDATE_VECTOR", "FAILED"),
+				domain: ErrorDomain.STORAGE,
+				category: ErrorCategory.THIRD_PARTY,
+				details: {
+					indexName,
+					id
+				}
+			}, error);
+		}
+	}
+	/**
+	* Updates multiple vectors matching a filter.
+	*/
+	async updateVectorsByFilter(indexName, filter, update) {
+		try {
+			const translatedFilter = new OpenSearchFilterTranslator().translate(filter);
+			const scriptSource = [];
+			const scriptParams = {};
+			if (update.vector) {
+				scriptSource.push("ctx._source.embedding = params.embedding");
+				scriptParams.embedding = update.vector;
+			}
+			if (update.metadata) {
+				scriptSource.push("ctx._source.metadata = params.metadata");
+				scriptParams.metadata = update.metadata;
+			}
+			await this.client.updateByQuery({
+				index: indexName,
+				body: {
+					query: translatedFilter || { match_all: {} },
+					script: {
+						source: scriptSource.join("; "),
+						params: scriptParams,
+						lang: "painless"
+					}
+				},
+				refresh: true
+			});
+		} catch (error) {
+			throw new MastraError({
+				id: createVectorErrorId("OPENSEARCH", "UPDATE_VECTOR_BY_FILTER", "FAILED"),
+				domain: ErrorDomain.STORAGE,
+				category: ErrorCategory.THIRD_PARTY,
+				details: {
+					indexName,
+					filter: JSON.stringify(filter)
+				}
+			}, 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.delete({
+				index: indexName,
+				id,
+				refresh: true
+			});
+		} catch (error) {
+			if (error && typeof error === "object" && "statusCode" in error && error.statusCode === 404) return;
+			throw new MastraError({
+				id: createVectorErrorId("OPENSEARCH", "DELETE_VECTOR", "FAILED"),
+				domain: ErrorDomain.STORAGE,
+				category: ErrorCategory.THIRD_PARTY,
+				details: {
+					indexName,
+					...id && { id }
+				}
+			}, error);
+		}
+	}
+	async deleteVectors({ indexName, filter, ids }) {
+		if (ids && filter) throw new MastraError({
+			id: createVectorErrorId("OPENSEARCH", "DELETE_VECTORS", "MUTUALLY_EXCLUSIVE"),
+			domain: ErrorDomain.STORAGE,
+			category: ErrorCategory.USER,
+			text: "ids and filter are mutually exclusive",
+			details: { indexName }
+		});
+		if (!ids && !filter) throw new MastraError({
+			id: createVectorErrorId("OPENSEARCH", "DELETE_VECTORS", "NO_TARGET"),
+			domain: ErrorDomain.STORAGE,
+			category: ErrorCategory.USER,
+			text: "Either filter or ids must be provided",
+			details: { indexName }
+		});
+		if (ids && ids.length === 0) throw new MastraError({
+			id: createVectorErrorId("OPENSEARCH", "DELETE_VECTORS", "EMPTY_IDS"),
+			domain: ErrorDomain.STORAGE,
+			category: ErrorCategory.USER,
+			text: "Cannot delete with empty ids array",
+			details: { indexName }
+		});
+		if (filter && Object.keys(filter).length === 0) throw new MastraError({
+			id: createVectorErrorId("OPENSEARCH", "DELETE_VECTORS", "EMPTY_FILTER"),
+			domain: ErrorDomain.STORAGE,
+			category: ErrorCategory.USER,
+			text: "Cannot delete with empty filter",
+			details: { indexName }
+		});
+		try {
+			if (ids) {
+				const bulkBody = ids.flatMap((id) => [{ delete: {
+					_index: indexName,
+					_id: id
+				} }]);
+				await this.client.bulk({
+					body: bulkBody,
+					refresh: true
+				});
+			} else if (filter) {
+				const translatedFilter = new OpenSearchFilterTranslator().translate(filter);
+				await this.client.deleteByQuery({
+					index: indexName,
+					body: { query: translatedFilter || { match_all: {} } },
+					refresh: true
+				});
+			}
+		} catch (error) {
+			if (error instanceof MastraError) throw error;
+			throw new MastraError({
+				id: createVectorErrorId("OPENSEARCH", "DELETE_VECTORS", "FAILED"),
+				domain: ErrorDomain.STORAGE,
+				category: ErrorCategory.THIRD_PARTY,
+				details: {
+					indexName,
+					...filter && { filter: JSON.stringify(filter) },
+					...ids && { idsCount: ids.length }
+				}
+			}, error);
+		}
+	}
 };
-
+//#endregion
 export { OpenSearchVector };
-//# sourceMappingURL=index.js.map
+
 //# sourceMappingURL=index.js.map