@mastra/mongodb 1.18.5-alpha.1 → 1.18.5

package/README.md

@@ -8,11 +8,6 @@ MongoDB Atlas Search implementation for Mastra, providing vector similarity sear
 npm install @mastra/mongodb
 ```
 
-## Prerequisites
-
-- MongoDB Atlas Local (via Docker) or MongoDB Atlas Cloud instance with Atlas Search enabled
-- MongoDB 7.0+ recommended
-
 ## Usage
 
 ### Vector Store
@@ -32,21 +27,24 @@ await vectorDB.connect();
 // Create a new vector index (collection)
 await vectorDB.createIndex({
   indexName: 'my_vectors',
-  dimension: 1536,
+  dimension: 3,
   metric: 'cosine', // or 'euclidean', 'dotproduct'
 });
 
 // Upsert vectors
 const ids = await vectorDB.upsert({
   indexName: 'my_vectors',
-  vectors: [[0.1, 0.2, ...], [0.3, 0.4, ...]],
+  vectors: [
+    [0.1, 0.2, 0.3],
+    [0.3, 0.4, 0.5],
+  ],
   metadata: [{ text: 'doc1' }, { text: 'doc2' }],
 });
 
 // Query vectors
 const results = await vectorDB.query({
   indexName: 'my_vectors',
-  queryVector: [0.1, 0.2, ...],
+  queryVector: [0.1, 0.2, 0.3],
   topK: 10,
   filter: { text: 'doc1' },
   includeVector: false,
@@ -56,158 +54,15 @@ const results = await vectorDB.query({
 await vectorDB.disconnect();
 ```
 
-### Storage
-
-```typescript
-import { MongoDBStore } from '@mastra/mongodb';
-
-const store = new MongoDBStore({
-  id: 'mongodb-store',
-  uri: 'mongodb://mongodb:mongodb@localhost:27018/?authSource=admin&directConnection=true',
-  dbName: 'mastra',
-});
-
-// Create a thread
-await store.saveThread({
-  thread: {
-    id: 'thread-123',
-    resourceId: 'resource-456',
-    title: 'My Thread',
-    metadata: { key: 'value' },
-    createdAt: new Date(),
-  },
-});
-
-// Add messages to thread
-await store.saveMessages({
-  messages: [
-    {
-      id: 'msg-789',
-      threadId: 'thread-123',
-      role: 'user',
-      content: { content: 'Hello' },
-      resourceId: 'resource-456',
-      createdAt: new Date(),
-    },
-  ],
-});
-
-// Query threads and messages
-const savedThread = await store.getThreadById({ threadId: 'thread-123' });
-const { messages } = await store.listMessages({ threadId: 'thread-123' });
-```
-
-## Configuration
-
-The MongoDB vector store is initialized with:
-
-- `id`: Unique identifier for this store instance
-- `uri`: MongoDB connection string (with credentials and options)
-- `dbName`: Name of the database to use
-- `embeddingFieldPath` (optional): Path to the field that stores vector embeddings. Supports nested paths using dot notation (e.g., `'text.contentEmbedding'`). Defaults to `'embedding'`.
-
-Example:
-
-```typescript
-const vectorDB = new MongoDBVector({
-  id: 'mongodb-vector',
-  uri: 'mongodb://mongodb:mongodb@localhost:27018/?authSource=admin&directConnection=true',
-  dbName: 'vector_db',
-});
-```
-
-### Custom Embedding Field Path
-
-If you need to store embeddings in a nested field structure, use the `embeddingFieldPath` option:
-
-```typescript
-const vectorDB = new MongoDBVector({
-  id: 'mongodb-vector',
-  uri: 'mongodb://mongodb:mongodb@localhost:27018/?authSource=admin&directConnection=true',
-  dbName: 'vector_db',
-  embeddingFieldPath: 'text.contentEmbedding', // Store embeddings at text.contentEmbedding
-});
-```
-
-## Features
-
-### Vector Store Features
-
-- Vector similarity search with cosine, euclidean, and dotproduct metrics (Atlas Search)
-- Metadata filtering with MongoDB-style query syntax
-- Automatic UUID generation for vectors
-- Collection (index) management: create, list, describe, delete
-- Atlas Search readiness checks for reliable testing
-
-### Storage Features
-
-- Thread and message storage with JSON support
-- Efficient batch operations
-- Rich metadata support
-- Timestamp tracking
-
-## Supported Filter Operators
-
-- Comparison: `$eq`, `$ne`, `$gt`, `$gte`, `$lt`, `$lte`
-- Logical: `$and`, `$or`
-- Array: `$in`, `$nin`
-- Text: `$regex`, `$like`
-
-Example filter:
-
-```typescript
-{
-  $and: [{ age: { $gt: 25 } }, { tags: { $in: ['tag1', 'tag2'] } }];
-}
-```
-
-## Distance Metrics
-
-The following distance metrics are supported:
-
-- `cosine` → Cosine similarity (default)
-- `euclidean` → Euclidean distance
-- `dotproduct` → Dot product
-
-## Vector Store Methods
-
-- `createIndex({indexName, dimension, metric})`: Create a new collection with vector search support
-- `upsert({indexName, vectors, metadata?, ids?})`: Add or update vectors
-- `query({indexName, queryVector, topK?, filter?, includeVector?, documentFilter?})`: Search for similar vectors (optionally filter by document content)
-
-> **Note:** `documentFilter` allows filtering results based on the content of the `document` field. Example: `{ $contains: 'specific text' }` will return only vectors whose associated document contains the specified text.
-
-- `updateVector({ indexName, id?, filter?, update })`: Update a single vector by ID or metadata filter
-- `deleteVector({ indexName, id })`: Delete a single vector by ID
-- `deleteVectors({ indexName, ids?, filter? })`: Delete multiple vectors by IDs or metadata filter
-- `listIndexes()`: List all vector-enabled collections
-- `describeIndex(indexName)`: Get collection statistics (dimension, count, metric)
-- `deleteIndex(indexName)`: Delete a collection
-- `disconnect()`: Close the MongoDB connection
-
-## Storage Methods
-
-- `saveThread({ thread })`: Create or update a thread
-- `getThreadById({ threadId })`: Get a thread by ID
-- `deleteThread({ threadId })`: Delete a thread and its messages
-- `saveMessages({ messages })`: Save multiple messages in a transaction
-- `listMessages({ threadId, perPage?, page? })`: Get messages for a thread with pagination
-- `deleteMessages(messageIds)`: Delete specific messages
-
-## Query Response Format
-
-Each query result includes:
+## Documentation
 
-- `id`: Vector ID
-- `score`: Similarity score (higher is more similar)
-- `metadata`: Associated metadata
-- `vector`: Original vector (if `includeVector` is true)
+- [MongoDB integration guide](https://mastra.ai/integrations/databases/mongodb)
+- [MongoDB vector reference](https://mastra.ai/reference/vectors/mongodb)
 
-## Testing
+## Changelog
 
-Integration tests use MongoDB Atlas Local via Docker. See `docker-compose.yml` for setup. The test suite includes readiness checks for Atlas Search before running vector operations.
+See the [package changelog](https://github.com/mastra-ai/mastra/blob/main/stores/mongodb/CHANGELOG.md) for version history and release notes.
 
-## Related Links
+## Support
 
-- [MongoDB Atlas Search Documentation](https://www.mongodb.com/docs/atlas/atlas-search/)
-- [MongoDB Node.js Driver](https://mongodb.github.io/node-mongodb-native/)
+We have an [open community Discord](https://discord.gg/mastra-ai). Come and say hello and let us know if you have any questions or need any help getting things running.

package/dist/docs/SKILL.md

@@ -3,7 +3,7 @@ name: mastra-mongodb
 description: Documentation for @mastra/mongodb. Use when working with @mastra/mongodb APIs, configuration, or implementation.
 metadata:
   package: "@mastra/mongodb"
-  version: "1.18.5-alpha.1"
+  version: "1.18.5"
 ---
 
 ## When to use

package/dist/docs/assets/SOURCE_MAP.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.18.5-alpha.1",
+  "version": "1.18.5",
   "package": "@mastra/mongodb",
   "exports": {},
   "modules": {}

package/dist/index.cjs

@@ -10,7 +10,7 @@ let _mastra_core_agent = require("@mastra/core/agent");
 let _mastra_core_evals = require("@mastra/core/evals");
 let _mastra_core_storage_domains_skills = require("@mastra/core/storage/domains/skills");
 //#region package.json
-var version = "1.18.5-alpha.1";
+var version = "1.18.5";
 //#endregion
 //#region src/vector/filter.ts
 /**

package/dist/index.js

@@ -9,7 +9,7 @@ import { MessageList } from "@mastra/core/agent";
 import { saveScorePayloadSchema } from "@mastra/core/evals";
 import { skillSnapshotFieldValuesEqual } from "@mastra/core/storage/domains/skills";
 //#region package.json
-var version = "1.18.5-alpha.1";
+var version = "1.18.5";
 //#endregion
 //#region src/vector/filter.ts
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mastra/mongodb",
-  "version": "1.18.5-alpha.1",
+  "version": "1.18.5",
   "description": "MongoDB provider for Mastra - includes vector store capabilities",
   "type": "module",
   "main": "dist/index.js",
@@ -32,10 +32,10 @@
     "tsx": "^4.23.1",
     "typescript": "^7.0.2",
     "vitest": "4.1.10",
-    "@internal/lint": "0.0.129",
-    "@internal/types-builder": "0.0.104",
-    "@mastra/core": "1.64.0-alpha.5",
-    "@internal/storage-test-utils": "0.0.125"
+    "@internal/lint": "0.0.130",
+    "@internal/storage-test-utils": "0.0.126",
+    "@internal/types-builder": "0.0.105",
+    "@mastra/core": "1.64.0"
   },
   "peerDependencies": {
     "@mastra/core": ">=1.63.1-0 <2.0.0-0"