@mastra/mongodb 0.0.0-vnext-inngest-20250508122351 → 0.0.0-vnext-20251104230439

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mastra/mongodb",
-  "version": "0.0.0-vnext-inngest-20250508122351",
+  "version": "0.0.0-vnext-20251104230439",
   "description": "MongoDB provider for Mastra - includes vector store capabilities",
   "type": "module",
   "main": "dist/index.js",
@@ -12,7 +12,7 @@
         "default": "./dist/index.js"
       },
       "require": {
-        "types": "./dist/index.d.cts",
+        "types": "./dist/index.d.ts",
         "default": "./dist/index.cjs"
       }
     },
@@ -20,24 +20,42 @@
   },
   "dependencies": {
     "@types/mongodb": "^4.0.7",
-    "cloudflare": "^4.1.0",
-    "mongodb": "^6.15.0",
-    "uuid": "^11.1.0",
-    "@mastra/core": "0.0.0-vnext-inngest-20250508122351"
+    "cloudflare": "^4.5.0",
+    "mongodb": "^6.17.0",
+    "uuid": "^11.1.0"
   },
   "devDependencies": {
-    "@microsoft/api-extractor": "^7.52.5",
-    "@types/node": "^20.17.27",
-    "eslint": "^9.23.0",
-    "tsup": "^8.4.0",
-    "typescript": "^5.8.2",
-    "vitest": "^3.1.2",
-    "@internal/lint": "0.0.0-vnext-inngest-20250508122351"
+    "@microsoft/api-extractor": "^7.52.8",
+    "@types/node": "^20.19.0",
+    "eslint": "^9.37.0",
+    "tsup": "^8.5.0",
+    "typescript": "^5.8.3",
+    "vitest": "^3.2.4",
+    "@internal/lint": "0.0.0-vnext-20251104230439",
+    "@mastra/core": "0.0.0-vnext-20251104230439",
+    "@internal/storage-test-utils": "0.0.49",
+    "@internal/types-builder": "0.0.0-vnext-20251104230439"
+  },
+  "peerDependencies": {
+    "@mastra/core": "0.0.0-vnext-20251104230439"
+  },
+  "files": [
+    "dist",
+    "CHANGELOG.md"
+  ],
+  "homepage": "https://mastra.ai",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/mastra-ai/mastra.git",
+    "directory": "stores/mongodb"
+  },
+  "bugs": {
+    "url": "https://github.com/mastra-ai/mastra/issues"
   },
   "scripts": {
-    "build": "tsup src/index.ts --format esm,cjs --experimental-dts --clean --treeshake=smallest --splitting",
-    "build:watch": "pnpm build --watch",
-    "pretest": "docker compose up -d && (for i in $(seq 1 30); do docker compose exec -T mongodb mongosh --eval 'db.adminCommand(\"ping\")' --quiet && break || (sleep 1; [ $i -eq 30 ] && exit 1); done)",
+    "build": "tsup --silent --config tsup.config.ts",
+    "build:watch": "tsup --watch --silent --config tsup.config.ts",
+    "pretest": "docker compose up -d --wait",
     "test": "vitest run",
     "posttest": "docker compose down -v",
     "pretest:watch": "docker compose up -d",

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

@@ -1,96 +0,0 @@
-import { BaseFilterTranslator } from '@mastra/core/vector/filter';
-import type { CreateIndexParams } from '@mastra/core/vector';
-import type { IndexStats } from '@mastra/core/vector';
-import { MastraVector } from '@mastra/core/vector';
-import type { MongoClientOptions } from 'mongodb';
-import type { OperatorSupport } from '@mastra/core/vector/filter';
-import type { ParamsToArgs } from '@mastra/core/vector';
-import type { QueryResult } from '@mastra/core/vector';
-import type { QueryVectorArgs } from '@mastra/core/vector';
-import type { QueryVectorParams } from '@mastra/core/vector';
-import type { UpsertVectorArgs } from '@mastra/core/vector';
-import type { UpsertVectorParams } from '@mastra/core/vector';
-import type { VectorFilter } from '@mastra/core/vector/filter';
-
-/**
- * Vector store specific prompt that details supported operators and examples.
- * This prompt helps users construct valid filters for MongoDB Vector.
- */
-declare const MONGODB_PROMPT = "When querying MongoDB Vector, you can ONLY use the operators listed below. Any other operators will be rejected.\nImportant: Don't explain how to construct the filter - use the specified operators and fields to search the content and return relevant results.\nIf a user tries to give an explicit operator that is not supported, reject the filter entirely and let them know that the operator is not supported.\n\nBasic Comparison Operators:\n- $eq: Exact match (default when using field: value)\n  Example: { \"category\": \"electronics\" }\n- $ne: Not equal\n  Example: { \"category\": { \"$ne\": \"electronics\" } }\n- $gt: Greater than\n  Example: { \"price\": { \"$gt\": 100 } }\n- $gte: Greater than or equal\n  Example: { \"price\": { \"$gte\": 100 } }\n- $lt: Less than\n  Example: { \"price\": { \"$lt\": 100 } }\n- $lte: Less than or equal\n  Example: { \"price\": { \"$lte\": 100 } }\n\nArray Operators:\n- $in: Match any value in array\n  Example: { \"category\": { \"$in\": [\"electronics\", \"books\"] } }\n- $nin: Does not match any value in array\n  Example: { \"category\": { \"$nin\": [\"electronics\", \"books\"] } }\n- $all: Match all values in array\n  Example: { \"tags\": { \"$all\": [\"premium\", \"sale\"] } }\n- $elemMatch: Match array elements that meet all specified conditions\n  Example: { \"items\": { \"$elemMatch\": { \"price\": { \"$gt\": 100 } } } }\n- $size: Match arrays with specific length\n  Example: { \"tags\": { \"$size\": 3 } }\n\nLogical Operators:\n- $and: Logical AND (can be implicit or explicit)\n  Implicit Example: { \"price\": { \"$gt\": 100 }, \"category\": \"electronics\" }\n  Explicit Example: { \"$and\": [{ \"price\": { \"$gt\": 100 } }, { \"category\": \"electronics\" }] }\n- $or: Logical OR\n  Example: { \"$or\": [{ \"price\": { \"$lt\": 50 } }, { \"category\": \"books\" }] }\n- $not: Logical NOT\n  Example: { \"$not\": { \"category\": \"electronics\" } }\n- $nor: Logical NOR\n  Example: { \"$nor\": [{ \"price\": { \"$lt\": 50 } }, { \"category\": \"books\" }] }\n\nElement Operators:\n- $exists: Check if field exists\n  Example: { \"rating\": { \"$exists\": true } }\n- $type: Check field type\n  Example: { \"price\": { \"$type\": \"number\" } }\n\nText Search Operators:\n- $text: Full text search\n  Example: { \"$text\": { \"$search\": \"gaming laptop\" } }\n- $regex: Regular expression match\n  Example: { \"name\": { \"$regex\": \"^Gaming\" } }\n\nRestrictions:\n- Only logical operators ($and, $or, $not, $nor) can be used at the top level\n- Empty arrays in array operators will return no results\n- Nested fields are supported using dot notation\n- Multiple conditions on the same field are supported\n- At least one key-value pair is required in filter object\n- Empty objects and undefined values are treated as no filter\n- Invalid types in comparison operators will throw errors\n- All non-logical operators must be used within a field condition\n  Valid: { \"field\": { \"$gt\": 100 } }\n  Valid: { \"$and\": [...] }\n  Invalid: { \"$gt\": 100 }\n- Logical operators must contain field conditions, not direct operators\n  Valid: { \"$and\": [{ \"field\": { \"$gt\": 100 } }] }\n  Invalid: { \"$and\": [{ \"$gt\": 100 }] }\n- Logical operators ($and, $or, $not, $nor):\n  - Can only be used at top level or nested within other logical operators\n  - Can not be used on a field level, or be nested inside a field\n  - Can not be used inside an operator\n  - Valid: { \"$and\": [{ \"field\": { \"$gt\": 100 } }] }\n  - Valid: { \"$or\": [{ \"$and\": [{ \"field\": { \"$gt\": 100 } }] }] }\n  - Invalid: { \"field\": { \"$and\": [{ \"$gt\": 100 }] } }\n  - Invalid: { \"field\": { \"$or\": [{ \"$gt\": 100 }] } }\n  - Invalid: { \"field\": { \"$gt\": { \"$and\": [{...}] } } }\n\nExample Complex Query:\n{\n  \"$and\": [\n    { \"category\": { \"$in\": [\"electronics\", \"computers\"] } },\n    { \"price\": { \"$gte\": 100, \"$lte\": 1000 } },\n    { \"tags\": { \"$all\": [\"premium\", \"sale\"] } },\n    { \"items\": { \"$elemMatch\": { \"price\": { \"$gt\": 50 }, \"inStock\": true } } },\n    { \"$text\": { \"$search\": \"gaming laptop\" } },\n    { \"$or\": [\n      { \"stock\": { \"$gt\": 0 } },\n      { \"preorder\": true }\n    ]},\n    { \"$not\": { \"status\": \"discontinued\" } }\n  ]\n}";
-export { MONGODB_PROMPT }
-export { MONGODB_PROMPT as MONGODB_PROMPT_alias_1 }
-
-/**
- * Translator for MongoDB filter queries.
- * Maintains MongoDB-compatible syntax while ensuring proper validation
- * and normalization of values.
- */
-export declare class MongoDBFilterTranslator extends BaseFilterTranslator {
-    protected getSupportedOperators(): OperatorSupport;
-    translate(filter?: VectorFilter): any;
-    private translateNode;
-    private translateOperatorValue;
-    isEmpty(filter: any): boolean;
-}
-
-declare type MongoDBQueryArgs = [...QueryVectorArgs, string?];
-export { MongoDBQueryArgs }
-export { MongoDBQueryArgs as MongoDBQueryArgs_alias_1 }
-
-declare interface MongoDBQueryVectorParams extends QueryVectorParams {
-    documentFilter?: VectorFilter;
-}
-export { MongoDBQueryVectorParams }
-export { MongoDBQueryVectorParams as MongoDBQueryVectorParams_alias_1 }
-
-declare type MongoDBUpsertArgs = [...UpsertVectorArgs, string[]?];
-export { MongoDBUpsertArgs }
-export { MongoDBUpsertArgs as MongoDBUpsertArgs_alias_1 }
-
-declare type MongoDBUpsertParams = ParamsToArgs<MongoDBUpsertArgs>;
-export { MongoDBUpsertParams }
-export { MongoDBUpsertParams as MongoDBUpsertParams_alias_1 }
-
-declare interface MongoDBUpsertVectorParams extends UpsertVectorParams {
-    documents?: string[];
-}
-export { MongoDBUpsertVectorParams }
-export { MongoDBUpsertVectorParams as MongoDBUpsertVectorParams_alias_1 }
-
-declare class MongoDBVector extends MastraVector {
-    private client;
-    private db;
-    private collections;
-    private readonly embeddingFieldName;
-    private readonly metadataFieldName;
-    private readonly documentFieldName;
-    private collectionForValidation;
-    private mongoMetricMap;
-    constructor({ uri, dbName, options }: {
-        uri: string;
-        dbName: string;
-        options?: MongoClientOptions;
-    });
-    connect(): Promise<void>;
-    disconnect(): Promise<void>;
-    createIndex(params: CreateIndexParams): Promise<void>;
-    waitForIndexReady(indexName: string, timeoutMs?: number, checkIntervalMs?: number): Promise<void>;
-    upsert(params: MongoDBUpsertVectorParams): Promise<string[]>;
-    query(params: MongoDBQueryVectorParams): Promise<QueryResult[]>;
-    listIndexes(): Promise<string[]>;
-    describeIndex(indexName: string): Promise<IndexStats>;
-    deleteIndex(indexName: string): Promise<void>;
-    updateIndexById(indexName: string, id: string, update: {
-        vector?: number[];
-        metadata?: Record<string, any>;
-    }): Promise<void>;
-    deleteIndexById(indexName: string, id: string): Promise<void>;
-    private getCollection;
-    private validateVectorDimensions;
-    private setIndexDimension;
-    private transformFilter;
-}
-export { MongoDBVector }
-export { MongoDBVector as MongoDBVector_alias_1 }
-
-export { }

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

@@ -1,96 +0,0 @@
-import { BaseFilterTranslator } from '@mastra/core/vector/filter';
-import type { CreateIndexParams } from '@mastra/core/vector';
-import type { IndexStats } from '@mastra/core/vector';
-import { MastraVector } from '@mastra/core/vector';
-import type { MongoClientOptions } from 'mongodb';
-import type { OperatorSupport } from '@mastra/core/vector/filter';
-import type { ParamsToArgs } from '@mastra/core/vector';
-import type { QueryResult } from '@mastra/core/vector';
-import type { QueryVectorArgs } from '@mastra/core/vector';
-import type { QueryVectorParams } from '@mastra/core/vector';
-import type { UpsertVectorArgs } from '@mastra/core/vector';
-import type { UpsertVectorParams } from '@mastra/core/vector';
-import type { VectorFilter } from '@mastra/core/vector/filter';
-
-/**
- * Vector store specific prompt that details supported operators and examples.
- * This prompt helps users construct valid filters for MongoDB Vector.
- */
-declare const MONGODB_PROMPT = "When querying MongoDB Vector, you can ONLY use the operators listed below. Any other operators will be rejected.\nImportant: Don't explain how to construct the filter - use the specified operators and fields to search the content and return relevant results.\nIf a user tries to give an explicit operator that is not supported, reject the filter entirely and let them know that the operator is not supported.\n\nBasic Comparison Operators:\n- $eq: Exact match (default when using field: value)\n  Example: { \"category\": \"electronics\" }\n- $ne: Not equal\n  Example: { \"category\": { \"$ne\": \"electronics\" } }\n- $gt: Greater than\n  Example: { \"price\": { \"$gt\": 100 } }\n- $gte: Greater than or equal\n  Example: { \"price\": { \"$gte\": 100 } }\n- $lt: Less than\n  Example: { \"price\": { \"$lt\": 100 } }\n- $lte: Less than or equal\n  Example: { \"price\": { \"$lte\": 100 } }\n\nArray Operators:\n- $in: Match any value in array\n  Example: { \"category\": { \"$in\": [\"electronics\", \"books\"] } }\n- $nin: Does not match any value in array\n  Example: { \"category\": { \"$nin\": [\"electronics\", \"books\"] } }\n- $all: Match all values in array\n  Example: { \"tags\": { \"$all\": [\"premium\", \"sale\"] } }\n- $elemMatch: Match array elements that meet all specified conditions\n  Example: { \"items\": { \"$elemMatch\": { \"price\": { \"$gt\": 100 } } } }\n- $size: Match arrays with specific length\n  Example: { \"tags\": { \"$size\": 3 } }\n\nLogical Operators:\n- $and: Logical AND (can be implicit or explicit)\n  Implicit Example: { \"price\": { \"$gt\": 100 }, \"category\": \"electronics\" }\n  Explicit Example: { \"$and\": [{ \"price\": { \"$gt\": 100 } }, { \"category\": \"electronics\" }] }\n- $or: Logical OR\n  Example: { \"$or\": [{ \"price\": { \"$lt\": 50 } }, { \"category\": \"books\" }] }\n- $not: Logical NOT\n  Example: { \"$not\": { \"category\": \"electronics\" } }\n- $nor: Logical NOR\n  Example: { \"$nor\": [{ \"price\": { \"$lt\": 50 } }, { \"category\": \"books\" }] }\n\nElement Operators:\n- $exists: Check if field exists\n  Example: { \"rating\": { \"$exists\": true } }\n- $type: Check field type\n  Example: { \"price\": { \"$type\": \"number\" } }\n\nText Search Operators:\n- $text: Full text search\n  Example: { \"$text\": { \"$search\": \"gaming laptop\" } }\n- $regex: Regular expression match\n  Example: { \"name\": { \"$regex\": \"^Gaming\" } }\n\nRestrictions:\n- Only logical operators ($and, $or, $not, $nor) can be used at the top level\n- Empty arrays in array operators will return no results\n- Nested fields are supported using dot notation\n- Multiple conditions on the same field are supported\n- At least one key-value pair is required in filter object\n- Empty objects and undefined values are treated as no filter\n- Invalid types in comparison operators will throw errors\n- All non-logical operators must be used within a field condition\n  Valid: { \"field\": { \"$gt\": 100 } }\n  Valid: { \"$and\": [...] }\n  Invalid: { \"$gt\": 100 }\n- Logical operators must contain field conditions, not direct operators\n  Valid: { \"$and\": [{ \"field\": { \"$gt\": 100 } }] }\n  Invalid: { \"$and\": [{ \"$gt\": 100 }] }\n- Logical operators ($and, $or, $not, $nor):\n  - Can only be used at top level or nested within other logical operators\n  - Can not be used on a field level, or be nested inside a field\n  - Can not be used inside an operator\n  - Valid: { \"$and\": [{ \"field\": { \"$gt\": 100 } }] }\n  - Valid: { \"$or\": [{ \"$and\": [{ \"field\": { \"$gt\": 100 } }] }] }\n  - Invalid: { \"field\": { \"$and\": [{ \"$gt\": 100 }] } }\n  - Invalid: { \"field\": { \"$or\": [{ \"$gt\": 100 }] } }\n  - Invalid: { \"field\": { \"$gt\": { \"$and\": [{...}] } } }\n\nExample Complex Query:\n{\n  \"$and\": [\n    { \"category\": { \"$in\": [\"electronics\", \"computers\"] } },\n    { \"price\": { \"$gte\": 100, \"$lte\": 1000 } },\n    { \"tags\": { \"$all\": [\"premium\", \"sale\"] } },\n    { \"items\": { \"$elemMatch\": { \"price\": { \"$gt\": 50 }, \"inStock\": true } } },\n    { \"$text\": { \"$search\": \"gaming laptop\" } },\n    { \"$or\": [\n      { \"stock\": { \"$gt\": 0 } },\n      { \"preorder\": true }\n    ]},\n    { \"$not\": { \"status\": \"discontinued\" } }\n  ]\n}";
-export { MONGODB_PROMPT }
-export { MONGODB_PROMPT as MONGODB_PROMPT_alias_1 }
-
-/**
- * Translator for MongoDB filter queries.
- * Maintains MongoDB-compatible syntax while ensuring proper validation
- * and normalization of values.
- */
-export declare class MongoDBFilterTranslator extends BaseFilterTranslator {
-    protected getSupportedOperators(): OperatorSupport;
-    translate(filter?: VectorFilter): any;
-    private translateNode;
-    private translateOperatorValue;
-    isEmpty(filter: any): boolean;
-}
-
-declare type MongoDBQueryArgs = [...QueryVectorArgs, string?];
-export { MongoDBQueryArgs }
-export { MongoDBQueryArgs as MongoDBQueryArgs_alias_1 }
-
-declare interface MongoDBQueryVectorParams extends QueryVectorParams {
-    documentFilter?: VectorFilter;
-}
-export { MongoDBQueryVectorParams }
-export { MongoDBQueryVectorParams as MongoDBQueryVectorParams_alias_1 }
-
-declare type MongoDBUpsertArgs = [...UpsertVectorArgs, string[]?];
-export { MongoDBUpsertArgs }
-export { MongoDBUpsertArgs as MongoDBUpsertArgs_alias_1 }
-
-declare type MongoDBUpsertParams = ParamsToArgs<MongoDBUpsertArgs>;
-export { MongoDBUpsertParams }
-export { MongoDBUpsertParams as MongoDBUpsertParams_alias_1 }
-
-declare interface MongoDBUpsertVectorParams extends UpsertVectorParams {
-    documents?: string[];
-}
-export { MongoDBUpsertVectorParams }
-export { MongoDBUpsertVectorParams as MongoDBUpsertVectorParams_alias_1 }
-
-declare class MongoDBVector extends MastraVector {
-    private client;
-    private db;
-    private collections;
-    private readonly embeddingFieldName;
-    private readonly metadataFieldName;
-    private readonly documentFieldName;
-    private collectionForValidation;
-    private mongoMetricMap;
-    constructor({ uri, dbName, options }: {
-        uri: string;
-        dbName: string;
-        options?: MongoClientOptions;
-    });
-    connect(): Promise<void>;
-    disconnect(): Promise<void>;
-    createIndex(params: CreateIndexParams): Promise<void>;
-    waitForIndexReady(indexName: string, timeoutMs?: number, checkIntervalMs?: number): Promise<void>;
-    upsert(params: MongoDBUpsertVectorParams): Promise<string[]>;
-    query(params: MongoDBQueryVectorParams): Promise<QueryResult[]>;
-    listIndexes(): Promise<string[]>;
-    describeIndex(indexName: string): Promise<IndexStats>;
-    deleteIndex(indexName: string): Promise<void>;
-    updateIndexById(indexName: string, id: string, update: {
-        vector?: number[];
-        metadata?: Record<string, any>;
-    }): Promise<void>;
-    deleteIndexById(indexName: string, id: string): Promise<void>;
-    private getCollection;
-    private validateVectorDimensions;
-    private setIndexDimension;
-    private transformFilter;
-}
-export { MongoDBVector }
-export { MongoDBVector as MongoDBVector_alias_1 }
-
-export { }

package/dist/index.d.cts

@@ -1,7 +0,0 @@
-export { MONGODB_PROMPT } from './_tsup-dts-rollup.cjs';
-export { MongoDBUpsertArgs } from './_tsup-dts-rollup.cjs';
-export { MongoDBQueryArgs } from './_tsup-dts-rollup.cjs';
-export { MongoDBUpsertParams } from './_tsup-dts-rollup.cjs';
-export { MongoDBUpsertVectorParams } from './_tsup-dts-rollup.cjs';
-export { MongoDBQueryVectorParams } from './_tsup-dts-rollup.cjs';
-export { MongoDBVector } from './_tsup-dts-rollup.cjs';

package/docker-compose.yml

@@ -1,8 +0,0 @@
-services:
-  mongodb:
-    image: mongodb/mongodb-atlas-local
-    environment:
-      MONGODB_INITDB_ROOT_USERNAME: mongodb
-      MONGODB_INITDB_ROOT_PASSWORD: mongodb
-    ports:
-      - 27018:27017

package/eslint.config.js

@@ -1,6 +0,0 @@
-import { createConfig } from '@internal/lint/eslint';
-
-const config = await createConfig();
-
-/** @type {import("eslint").Linter.Config[]} */
-export default [...config];

package/src/index.ts

@@ -1,2 +0,0 @@
-export * from './vector';
-export { MONGODB_PROMPT } from './vector/prompt';