@mastra/opensearch 0.10.3 → 0.10.4-alpha.1

package/.turbo/turbo-build.log

@@ -1,23 +1,23 @@
 
-> @mastra/opensearch@0.10.3-alpha.0 build /home/runner/work/mastra/mastra/stores/opensearch
+> @mastra/opensearch@0.10.4-alpha.1 build /home/runner/work/mastra/mastra/stores/opensearch
 > tsup src/index.ts --format esm,cjs --experimental-dts --clean --treeshake=smallest --splitting
 
 CLI Building entry: src/index.ts
 CLI Using tsconfig: tsconfig.json
 CLI tsup v8.5.0
 TSC Build start
-TSC ⚡️ Build success in 11681ms
+TSC ⚡️ Build success in 11957ms
 DTS Build start
 CLI Target: es2022
 Analysis will use the bundled TypeScript version 5.8.3
 Writing package typings: /home/runner/work/mastra/mastra/stores/opensearch/dist/_tsup-dts-rollup.d.ts
 Analysis will use the bundled TypeScript version 5.8.3
 Writing package typings: /home/runner/work/mastra/mastra/stores/opensearch/dist/_tsup-dts-rollup.d.cts
-DTS ⚡️ Build success in 11326ms
+DTS ⚡️ Build success in 11764ms
 CLI Cleaning output folder
 ESM Build start
 CJS Build start
-ESM dist/index.js 21.72 KB
-ESM ⚡️ Build success in 798ms
-CJS dist/index.cjs 21.76 KB
-CJS ⚡️ Build success in 805ms
+CJS dist/index.cjs 23.79 KB
+CJS ⚡️ Build success in 807ms
+ESM dist/index.js 23.58 KB
+ESM ⚡️ Build success in 814ms

package/CHANGELOG.md

@@ -1,5 +1,29 @@
 # @mastra/opensearch
 
+## 0.10.4-alpha.1
+
+### Patch Changes
+
+- 144eb0b: [MASTRA-3669] Metadata Filter Types
+- Updated dependencies [15e9d26]
+- Updated dependencies [07d6d88]
+- Updated dependencies [5d74aab]
+- Updated dependencies [144eb0b]
+  - @mastra/core@0.10.7-alpha.2
+
+## 0.10.4-alpha.0
+
+### Patch Changes
+
+- 0e17048: Throw mastra errors in storage packages
+- Updated dependencies [d1baedb]
+- Updated dependencies [4d21bf2]
+- Updated dependencies [2097952]
+- Updated dependencies [4fb0cc2]
+- Updated dependencies [d2a7a31]
+- Updated dependencies [0e17048]
+  - @mastra/core@0.10.7-alpha.1
+
 ## 0.10.3
 
 ### Patch Changes

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

@@ -1,11 +1,14 @@
 import { BaseFilterTranslator } from '@mastra/core/vector/filter';
+import type { BlacklistedRootOperators } from '@mastra/core/vector/filter';
 import type { CreateIndexParams } from '@mastra/core';
 import type { DeleteIndexParams } from '@mastra/core';
 import type { DeleteVectorParams } from '@mastra/core';
 import type { DescribeIndexParams } from '@mastra/core';
 import type { IndexStats } from '@mastra/core';
+import type { LogicalOperatorValueMap } from '@mastra/core/vector/filter';
 import { MastraVector } from '@mastra/core/vector';
 import type { OperatorSupport } from '@mastra/core/vector/filter';
+import type { OperatorValueMap } from '@mastra/core/vector/filter';
 import type { QueryResult } from '@mastra/core';
 import type { QueryVectorParams } from '@mastra/core';
 import type { UpdateVectorParams } from '@mastra/core';
@@ -18,14 +21,16 @@ import type { VectorFilter } from '@mastra/core/vector/filter';
  */
 export declare const OPENSEARCH_PROMPT = "When querying OpenSearch, you can ONLY use the operators listed below. Any other operators will be rejected.\nImportant: Do not explain how to construct the filter\u2014use the specified operators and fields to search the content and return relevant results.\nIf a user tries to use an unsupported operator, reject the filter entirely and let them know that the operator is not supported.\n\nBasic Comparison Operators:\n- $eq: Exact match (default for 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- $all: Match all values in array\n  Example: { \"tags\": { \"$all\": [\"premium\", \"sale\"] } }\n\nLogical Operators:\n- $and: Logical AND (implicit when using multiple conditions)\n  Example: { \"$and\": [{ \"price\": { \"$gt\": 100 } }, { \"category\": \"electronics\" }] }\n- $or: Logical OR\n  Example: { \"$or\": [{ \"price\": { \"$lt\": 50 } }, { \"category\": \"books\" }] }\n- $not: Logical NOT\n  Example: { \"$not\": { \"category\": \"electronics\" } }\n\nElement Operators:\n- $exists: Check if field exists\n  Example: { \"rating\": { \"$exists\": true } }\n\nRegex Operator:\n- $regex: Match using a regular expression (ECMAScript syntax)\n  Example: { \"name\": { \"$regex\": \"^Sam.*son$\" } }\n  Note: Regex queries are supported for string fields only. Use valid ECMAScript patterns; invalid patterns will throw an error.\n\nRestrictions:\n- Nested fields are supported using dot notation (e.g., \"address.city\").\n- Multiple conditions on the same field are supported (e.g., { \"price\": { \"$gte\": 100, \"$lte\": 1000 } }).\n- Only logical operators ($and, $or, $not) can be used at the top level.\n- All other 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- $not operator:\n  - Must be an object\n  - Cannot be empty\n  - Can be used at field level or top level\n  - Valid: { \"$not\": { \"field\": \"value\" } }\n  - Valid: { \"field\": { \"$not\": { \"$eq\": \"value\" } } }\n- Array operators work on array fields only.\n- Empty arrays in conditions are handled gracefully.\n- Regex queries are case-sensitive by default; use patterns accordingly.\n\nExample Complex Query:\n{\n  \"$and\": [\n    { \"category\": { \"$in\": [\"electronics\", \"computers\"] } },\n    { \"price\": { \"$gte\": 100, \"$lte\": 1000 } },\n    { \"tags\": { \"$all\": [\"premium\"] } },\n    { \"rating\": { \"$exists\": true, \"$gt\": 4 } },\n    { \"$or\": [\n      { \"stock\": { \"$gt\": 0 } },\n      { \"preorder\": true }\n    ]},\n    { \"name\": { \"$regex\": \"^Sam.*son$\" } }\n  ]\n}";
 
+declare type OpenSearchBlacklisted = BlacklistedRootOperators | '$nor';
+
 /**
  * Translator for OpenSearch filter queries.
  * Maintains OpenSearch-compatible syntax while ensuring proper validation
  * and normalization of values.
  */
-export declare class OpenSearchFilterTranslator extends BaseFilterTranslator {
+export declare class OpenSearchFilterTranslator extends BaseFilterTranslator<OpenSearchVectorFilter> {
     protected getSupportedOperators(): OperatorSupport;
-    translate(filter?: VectorFilter): VectorFilter;
+    translate(filter?: OpenSearchVectorFilter): OpenSearchVectorFilter;
     private translateNode;
     /**
      * Handles translation of nested objects with dot notation fields
@@ -58,7 +63,11 @@ export declare class OpenSearchFilterTranslator extends BaseFilterTranslator {
     private createRangeQuery;
 }
 
-declare class OpenSearchVector extends MastraVector {
+declare type OpenSearchLogicalOperatorValueMap = Omit<LogicalOperatorValueMap, '$nor'>;
+
+declare type OpenSearchOperatorValueMap = Omit<OperatorValueMap, '$options' | '$nor' | '$elemMatch'>;
+
+declare class OpenSearchVector extends MastraVector<OpenSearchVectorFilter> {
     private client;
     /**
      * Creates a new OpenSearchVector client.
@@ -117,7 +126,7 @@ declare class OpenSearchVector extends MastraVector {
      * @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.
      */
-    query({ indexName, queryVector, filter, topK, includeVector, }: QueryVectorParams): Promise<QueryResult[]>;
+    query({ indexName, queryVector, filter, topK, includeVector, }: OpenSearchVectorParams): Promise<QueryResult[]>;
     /**
      * Validates the dimensions of the vectors.
      *
@@ -129,7 +138,7 @@ declare class OpenSearchVector extends MastraVector {
     /**
      * Transforms the filter to the OpenSearch DSL.
      *
-     * @param {VectorFilter} filter - The filter to transform.
+     * @param {OpenSearchVectorFilter} filter - The filter to transform.
      * @returns {Record<string, any>} The transformed filter.
      */
     private transformFilter;
@@ -156,4 +165,8 @@ declare class OpenSearchVector extends MastraVector {
 export { OpenSearchVector }
 export { OpenSearchVector as OpenSearchVector_alias_1 }
 
+export declare type OpenSearchVectorFilter = VectorFilter<keyof OpenSearchOperatorValueMap, OpenSearchOperatorValueMap, OpenSearchLogicalOperatorValueMap, OpenSearchBlacklisted>;
+
+declare type OpenSearchVectorParams = QueryVectorParams<OpenSearchVectorFilter>;
+
 export { }

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

@@ -1,11 +1,14 @@
 import { BaseFilterTranslator } from '@mastra/core/vector/filter';
+import type { BlacklistedRootOperators } from '@mastra/core/vector/filter';
 import type { CreateIndexParams } from '@mastra/core';
 import type { DeleteIndexParams } from '@mastra/core';
 import type { DeleteVectorParams } from '@mastra/core';
 import type { DescribeIndexParams } from '@mastra/core';
 import type { IndexStats } from '@mastra/core';
+import type { LogicalOperatorValueMap } from '@mastra/core/vector/filter';
 import { MastraVector } from '@mastra/core/vector';
 import type { OperatorSupport } from '@mastra/core/vector/filter';
+import type { OperatorValueMap } from '@mastra/core/vector/filter';
 import type { QueryResult } from '@mastra/core';
 import type { QueryVectorParams } from '@mastra/core';
 import type { UpdateVectorParams } from '@mastra/core';
@@ -18,14 +21,16 @@ import type { VectorFilter } from '@mastra/core/vector/filter';
  */
 export declare const OPENSEARCH_PROMPT = "When querying OpenSearch, you can ONLY use the operators listed below. Any other operators will be rejected.\nImportant: Do not explain how to construct the filter\u2014use the specified operators and fields to search the content and return relevant results.\nIf a user tries to use an unsupported operator, reject the filter entirely and let them know that the operator is not supported.\n\nBasic Comparison Operators:\n- $eq: Exact match (default for 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- $all: Match all values in array\n  Example: { \"tags\": { \"$all\": [\"premium\", \"sale\"] } }\n\nLogical Operators:\n- $and: Logical AND (implicit when using multiple conditions)\n  Example: { \"$and\": [{ \"price\": { \"$gt\": 100 } }, { \"category\": \"electronics\" }] }\n- $or: Logical OR\n  Example: { \"$or\": [{ \"price\": { \"$lt\": 50 } }, { \"category\": \"books\" }] }\n- $not: Logical NOT\n  Example: { \"$not\": { \"category\": \"electronics\" } }\n\nElement Operators:\n- $exists: Check if field exists\n  Example: { \"rating\": { \"$exists\": true } }\n\nRegex Operator:\n- $regex: Match using a regular expression (ECMAScript syntax)\n  Example: { \"name\": { \"$regex\": \"^Sam.*son$\" } }\n  Note: Regex queries are supported for string fields only. Use valid ECMAScript patterns; invalid patterns will throw an error.\n\nRestrictions:\n- Nested fields are supported using dot notation (e.g., \"address.city\").\n- Multiple conditions on the same field are supported (e.g., { \"price\": { \"$gte\": 100, \"$lte\": 1000 } }).\n- Only logical operators ($and, $or, $not) can be used at the top level.\n- All other 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- $not operator:\n  - Must be an object\n  - Cannot be empty\n  - Can be used at field level or top level\n  - Valid: { \"$not\": { \"field\": \"value\" } }\n  - Valid: { \"field\": { \"$not\": { \"$eq\": \"value\" } } }\n- Array operators work on array fields only.\n- Empty arrays in conditions are handled gracefully.\n- Regex queries are case-sensitive by default; use patterns accordingly.\n\nExample Complex Query:\n{\n  \"$and\": [\n    { \"category\": { \"$in\": [\"electronics\", \"computers\"] } },\n    { \"price\": { \"$gte\": 100, \"$lte\": 1000 } },\n    { \"tags\": { \"$all\": [\"premium\"] } },\n    { \"rating\": { \"$exists\": true, \"$gt\": 4 } },\n    { \"$or\": [\n      { \"stock\": { \"$gt\": 0 } },\n      { \"preorder\": true }\n    ]},\n    { \"name\": { \"$regex\": \"^Sam.*son$\" } }\n  ]\n}";
 
+declare type OpenSearchBlacklisted = BlacklistedRootOperators | '$nor';
+
 /**
  * Translator for OpenSearch filter queries.
  * Maintains OpenSearch-compatible syntax while ensuring proper validation
  * and normalization of values.
  */
-export declare class OpenSearchFilterTranslator extends BaseFilterTranslator {
+export declare class OpenSearchFilterTranslator extends BaseFilterTranslator<OpenSearchVectorFilter> {
     protected getSupportedOperators(): OperatorSupport;
-    translate(filter?: VectorFilter): VectorFilter;
+    translate(filter?: OpenSearchVectorFilter): OpenSearchVectorFilter;
     private translateNode;
     /**
      * Handles translation of nested objects with dot notation fields
@@ -58,7 +63,11 @@ export declare class OpenSearchFilterTranslator extends BaseFilterTranslator {
     private createRangeQuery;
 }
 
-declare class OpenSearchVector extends MastraVector {
+declare type OpenSearchLogicalOperatorValueMap = Omit<LogicalOperatorValueMap, '$nor'>;
+
+declare type OpenSearchOperatorValueMap = Omit<OperatorValueMap, '$options' | '$nor' | '$elemMatch'>;
+
+declare class OpenSearchVector extends MastraVector<OpenSearchVectorFilter> {
     private client;
     /**
      * Creates a new OpenSearchVector client.
@@ -117,7 +126,7 @@ declare class OpenSearchVector extends MastraVector {
      * @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.
      */
-    query({ indexName, queryVector, filter, topK, includeVector, }: QueryVectorParams): Promise<QueryResult[]>;
+    query({ indexName, queryVector, filter, topK, includeVector, }: OpenSearchVectorParams): Promise<QueryResult[]>;
     /**
      * Validates the dimensions of the vectors.
      *
@@ -129,7 +138,7 @@ declare class OpenSearchVector extends MastraVector {
     /**
      * Transforms the filter to the OpenSearch DSL.
      *
-     * @param {VectorFilter} filter - The filter to transform.
+     * @param {OpenSearchVectorFilter} filter - The filter to transform.
      * @returns {Record<string, any>} The transformed filter.
      */
     private transformFilter;
@@ -156,4 +165,8 @@ declare class OpenSearchVector extends MastraVector {
 export { OpenSearchVector }
 export { OpenSearchVector as OpenSearchVector_alias_1 }
 
+export declare type OpenSearchVectorFilter = VectorFilter<keyof OpenSearchOperatorValueMap, OpenSearchOperatorValueMap, OpenSearchLogicalOperatorValueMap, OpenSearchBlacklisted>;
+
+declare type OpenSearchVectorParams = QueryVectorParams<OpenSearchVectorFilter>;
+
 export { }

package/dist/index.cjs

@@ -1,5 +1,6 @@
 'use strict';
 
+var error = require('@mastra/core/error');
 var vector = require('@mastra/core/vector');
 var opensearch = require('@opensearch-project/opensearch');
 var filter = require('@mastra/core/vector/filter');
@@ -11,7 +12,6 @@ var OpenSearchFilterTranslator = class extends filter.BaseFilterTranslator {
       ...filter.BaseFilterTranslator.DEFAULT_OPERATORS,
       logical: ["$and", "$or", "$not"],
       array: ["$in", "$nin", "$all"],
-      element: ["$exists"],
       regex: ["$regex"],
       custom: []
     };
@@ -383,7 +383,13 @@ var OpenSearchVector = class extends vector.MastraVector {
    */
   async createIndex({ indexName, dimension, metric = "cosine" }) {
     if (!Number.isInteger(dimension) || dimension <= 0) {
-      throw new Error("Dimension must be a positive integer");
+      throw new error.MastraError({
+        id: "STORAGE_OPENSEARCH_VECTOR_CREATE_INDEX_INVALID_ARGS",
+        domain: error.ErrorDomain.STORAGE,
+        category: error.ErrorCategory.USER,
+        text: "Dimension must be a positive integer",
+        details: { indexName, dimension }
+      });
     }
     try {
       await this.client.indices.create({
@@ -408,14 +414,21 @@ var OpenSearchVector = class extends vector.MastraVector {
           }
         }
       });
-    } catch (error) {
-      const message = error?.message || error?.toString();
+    } catch (error$1) {
+      const message = error$1?.message || error$1?.toString();
       if (message && message.toLowerCase().includes("already exists")) {
         await this.validateExistingIndex(indexName, dimension, metric);
         return;
       }
-      console.error(`Failed to create index ${indexName}:`, error);
-      throw error;
+      throw new error.MastraError(
+        {
+          id: "STORAGE_OPENSEARCH_VECTOR_CREATE_INDEX_FAILED",
+          domain: error.ErrorDomain.STORAGE,
+          category: error.ErrorCategory.THIRD_PARTY,
+          details: { indexName, dimension, metric }
+        },
+        error$1
+      );
     }
   }
   /**
@@ -428,9 +441,15 @@ var OpenSearchVector = class extends vector.MastraVector {
       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) {
-      console.error("Failed to list indexes:", error);
-      throw new Error(`Failed to list indexes: ${error.message}`);
+    } catch (error$1) {
+      throw new error.MastraError(
+        {
+          id: "STORAGE_OPENSEARCH_VECTOR_LIST_INDEXES_FAILED",
+          domain: error.ErrorDomain.STORAGE,
+          category: error.ErrorCategory.THIRD_PARTY
+        },
+        error$1
+      );
     }
   }
   /**
@@ -460,8 +479,18 @@ var OpenSearchVector = class extends vector.MastraVector {
   async deleteIndex({ indexName }) {
     try {
       await this.client.indices.delete({ index: indexName });
-    } catch (error) {
-      console.error(`Failed to delete index ${indexName}:`, error);
+    } catch (error$1) {
+      const mastraError = new error.MastraError(
+        {
+          id: "STORAGE_OPENSEARCH_VECTOR_DELETE_INDEX_FAILED",
+          domain: error.ErrorDomain.STORAGE,
+          category: error.ErrorCategory.THIRD_PARTY,
+          details: { indexName }
+        },
+        error$1
+      );
+      this.logger?.error(mastraError.toString());
+      this.logger?.trackException(mastraError);
     }
   }
   /**
@@ -476,31 +505,38 @@ var OpenSearchVector = class extends vector.MastraVector {
   async upsert({ indexName, vectors, metadata = [], ids }) {
     const vectorIds = ids || vectors.map(() => crypto.randomUUID());
     const operations = [];
-    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);
-    }
     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) {
-      console.error("Failed to upsert vectors:", error);
-      throw error;
+    } catch (error$1) {
+      throw new error.MastraError(
+        {
+          id: "STORAGE_OPENSEARCH_VECTOR_UPSERT_FAILED",
+          domain: error.ErrorDomain.STORAGE,
+          category: error.ErrorCategory.THIRD_PARTY,
+          details: { indexName, vectorCount: vectors?.length || 0 }
+        },
+        error$1
+      );
     }
   }
   /**
@@ -544,9 +580,16 @@ var OpenSearchVector = class extends vector.MastraVector {
         };
       });
       return results;
-    } catch (error) {
-      console.error("Failed to query vectors:", error);
-      throw new Error(`Failed to query vectors for index ${indexName}: ${error.message}`);
+    } catch (error$1) {
+      throw new error.MastraError(
+        {
+          id: "STORAGE_OPENSEARCH_VECTOR_QUERY_FAILED",
+          domain: error.ErrorDomain.STORAGE,
+          category: error.ErrorCategory.THIRD_PARTY,
+          details: { indexName, topK }
+        },
+        error$1
+      );
     }
   }
   /**
@@ -564,7 +607,7 @@ var OpenSearchVector = class extends vector.MastraVector {
   /**
    * Transforms the filter to the OpenSearch DSL.
    *
-   * @param {VectorFilter} filter - The filter to transform.
+   * @param {OpenSearchVectorFilter} filter - The filter to transform.
    * @returns {Record<string, any>} The transformed filter.
    */
   transformFilter(filter) {
@@ -582,44 +625,68 @@ var OpenSearchVector = class extends vector.MastraVector {
    * @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("No updates provided");
-    }
+    let existingDoc;
     try {
-      const { body: existingDoc } = await this.client.get({
+      if (!update.vector && !update.metadata) {
+        throw new Error("No updates provided");
+      }
+      const { body } = await this.client.get({
         index: indexName,
         id
       }).catch(() => {
         throw new Error(`Document with ID ${id} not found in index ${indexName}`);
       });
-      if (!existingDoc || !existingDoc._source) {
+      if (!body || !body._source) {
         throw new Error(`Document with ID ${id} has no source data in index ${indexName}`);
       }
-      const source = existingDoc._source;
-      const updatedDoc = {
-        id: source.id || id
-      };
+      existingDoc = body;
+    } catch (error$1) {
+      throw new error.MastraError(
+        {
+          id: "STORAGE_OPENSEARCH_VECTOR_UPDATE_VECTOR_FAILED",
+          domain: error.ErrorDomain.STORAGE,
+          category: error.ErrorCategory.USER,
+          details: { indexName, id }
+        },
+        error$1
+      );
+    }
+    const source = existingDoc._source;
+    const updatedDoc = {
+      id: source?.id || id
+    };
+    try {
       if (update.vector) {
+        console.log(`1`);
         const indexInfo = await this.describeIndex({ indexName });
+        console.log(`2`);
         this.validateVectorDimensions([update.vector], indexInfo.dimension);
         updatedDoc.embedding = update.vector;
-      } else if (source.embedding) {
+      } else if (source?.embedding) {
         updatedDoc.embedding = source.embedding;
       }
       if (update.metadata) {
         updatedDoc.metadata = update.metadata;
       } else {
-        updatedDoc.metadata = source.metadata || {};
+        updatedDoc.metadata = source?.metadata || {};
       }
+      console.log(`3`);
       await this.client.index({
         index: indexName,
         id,
         body: updatedDoc,
         refresh: true
       });
-    } catch (error) {
-      console.error(`Failed to update document with ID ${id} in index ${indexName}:`, error);
-      throw error;
+    } catch (error$1) {
+      throw new error.MastraError(
+        {
+          id: "STORAGE_OPENSEARCH_VECTOR_UPDATE_VECTOR_FAILED",
+          domain: error.ErrorDomain.STORAGE,
+          category: error.ErrorCategory.THIRD_PARTY,
+          details: { indexName, id }
+        },
+        error$1
+      );
     }
   }
   /**
@@ -636,11 +703,19 @@ var OpenSearchVector = class extends vector.MastraVector {
         id,
         refresh: true
       });
-    } catch (error) {
-      console.error(`Failed to delete document with ID ${id} from index ${indexName}:`, error);
-      if (error && typeof error === "object" && "statusCode" in error && error.statusCode !== 404) {
-        throw error;
+    } catch (error$1) {
+      if (error$1 && typeof error$1 === "object" && "statusCode" in error$1 && error$1.statusCode === 404) {
+        return;
       }
+      throw new error.MastraError(
+        {
+          id: "STORAGE_OPENSEARCH_VECTOR_DELETE_VECTOR_FAILED",
+          domain: error.ErrorDomain.STORAGE,
+          category: error.ErrorCategory.THIRD_PARTY,
+          details: { indexName, id }
+        },
+        error$1
+      );
     }
   }
 };