@atscript/db-mongo 0.1.38 → 0.1.40

package/README.md

@@ -0,0 +1,60 @@
+<p align="center">
+  <img src="https://atscript.dev/logo.svg" alt="Atscript" width="120" />
+</p>
+
+<h1 align="center">@atscript/db-mongo</h1>
+
+<p align="center">
+  <strong>Define your models once</strong> — get TypeScript types, runtime validation, and DB metadata from a single <code>.as</code> model.
+</p>
+
+<p align="center">
+  <a href="https://db.atscript.dev">Documentation</a> · <a href="https://db.atscript.dev/adapters/mongodb">MongoDB Adapter</a>
+</p>
+
+---
+
+MongoDB adapter for `@atscript/db`. Translates Atscript's portable query model into native MongoDB operations with support for Atlas Search, vector search, aggregation pipelines, capped collections, and the Convenient Transaction API.
+
+Includes `MongoPlugin` for `@db.mongo.*` annotations and custom primitives (`mongo.objectId`, `mongo.vector`).
+
+## Installation
+
+```bash
+pnpm add @atscript/db-mongo mongodb
+```
+
+## Quick Start
+
+```typescript
+import { DbSpace } from "@atscript/db";
+import { MongoAdapter } from "@atscript/db-mongo";
+import { MongoClient } from "mongodb";
+
+const client = new MongoClient("mongodb://localhost:27017/myapp");
+const db = new DbSpace(() => new MongoAdapter(client.db(), client));
+const todos = db.getTable(TodoType);
+
+await todos.insertOne({ title: "Hello", done: false });
+```
+
+## Features
+
+- Full CRUD with native MongoDB operations
+- Atlas Search: dynamic and static text indexes with analyzers and fuzzy matching
+- Vector search via `@db.search.vector` with configurable dimensions and similarity
+- Native relation loading via `$lookup` aggregation stages
+- Aggregation pipeline support
+- Array patch operations via `CollectionPatcher`
+- Capped collections via `@db.mongo.capped`
+- Auto-increment via atomic counter collection
+- Convenient Transaction API with automatic retry
+
+## Documentation
+
+- [MongoDB Adapter Guide](https://db.atscript.dev/adapters/mongodb)
+- [Full Documentation](https://db.atscript.dev)
+
+## License
+
+MIT

package/dist/agg.cjs

@@ -1,59 +1,9 @@
-"use strict";
-//#region rolldown:runtime
-var __create = Object.create;
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __getProtoOf = Object.getPrototypeOf;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __copyProps = (to, from, except, desc) => {
-	if (from && typeof from === "object" || typeof from === "function") for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
-		key = keys[i];
-		if (!__hasOwnProp.call(to, key) && key !== except) __defProp(to, key, {
-			get: ((k) => from[k]).bind(null, key),
-			enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
-		});
-	}
-	return to;
-};
-var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", {
-	value: mod,
-	enumerable: true
-}) : target, mod));
-
-//#endregion
-const __atscript_db_agg = __toESM(require("@atscript/db/agg"));
-const __atscript_db = __toESM(require("@atscript/db"));
-
-//#region packages/db-mongo/src/lib/mongo-filter.ts
-const EMPTY = {};
-const mongoVisitor = {
-	comparison(field, op, value) {
-		if (op === "$eq") return { [field]: value };
-		return { [field]: { [op]: value } };
-	},
-	and(children) {
-		if (children.length === 0) return EMPTY;
-		if (children.length === 1) return children[0];
-		return { $and: children };
-	},
-	or(children) {
-		if (children.length === 0) return { _impossible: true };
-		if (children.length === 1) return children[0];
-		return { $or: children };
-	},
-	not(child) {
-		return { $nor: [child] };
-	}
-};
-function buildMongoFilter(filter) {
-	if (!filter || Object.keys(filter).length === 0) return EMPTY;
-	return (0, __atscript_db.walkFilter)(filter, mongoVisitor) ?? EMPTY;
-}
-
-//#endregion
-//#region packages/db-mongo/src/agg.ts
-/** Simple accumulators that map directly to `{ $<fn>: '$field' }`. */ const SIMPLE_ACCUMULATORS = {
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_mongo_filter = require("./mongo-filter-B5ZINZPF.cjs");
+let _atscript_db_agg = require("@atscript/db/agg");
+//#region src/agg.ts
+/** Simple accumulators that map directly to `{ $<fn>: '$field' }`. */
+const SIMPLE_ACCUMULATORS = {
 	sum: "$sum",
 	avg: "$avg",
 	min: "$min",
@@ -61,7 +11,8 @@ function buildMongoFilter(filter) {
 };
 /**
 * Maps an AggregateExpr to a MongoDB $group accumulator expression.
-*/ function toAccumulator(expr) {
+*/
+function toAccumulator(expr) {
 	const simple = SIMPLE_ACCUMULATORS[expr.$fn];
 	if (simple) return { [simple]: `$${expr.$field}` };
 	if (expr.$fn === "count") {
@@ -77,10 +28,11 @@ function buildMongoFilter(filter) {
 /**
 * Builds the common prefix stages: $match + $group._id from groupBy fields.
 * Shared by both full aggregate and count pipelines.
-*/ function buildPrefix(query) {
+*/
+function buildPrefix(query) {
 	const controls = query.controls || {};
 	const groupBy = controls.$groupBy ?? [];
-	const pipeline = [{ $match: buildMongoFilter(query.filter) }];
+	const pipeline = [{ $match: require_mongo_filter.buildMongoFilter(query.filter) }];
 	const groupId = {};
 	for (const field of groupBy) groupId[field] = `$${field}`;
 	return {
@@ -90,6 +42,11 @@ function buildMongoFilter(filter) {
 		controls
 	};
 }
+/**
+* Builds a full MongoDB aggregation pipeline for GROUP BY queries.
+*
+* Pipeline: $match → $group → $project → $match(having) → $sort → $skip → $limit
+*/
 function buildAggregatePipeline(query) {
 	const { pipeline, groupId, groupBy, controls } = buildPrefix(query);
 	const groupStage = { _id: groupId };
@@ -97,18 +54,23 @@ function buildAggregatePipeline(query) {
 	const aggregates = controls.$select?.aggregates;
 	for (const field of groupBy) project[field] = `$_id.${field}`;
 	if (aggregates) for (const expr of aggregates) {
-		const alias = (0, __atscript_db_agg.resolveAlias)(expr);
+		const alias = (0, _atscript_db_agg.resolveAlias)(expr);
 		groupStage[alias] = toAccumulator(expr);
 		project[alias] = 1;
 	}
 	pipeline.push({ $group: groupStage });
 	pipeline.push({ $project: project });
-	if (controls.$having) pipeline.push({ $match: buildMongoFilter(controls.$having) });
+	if (controls.$having) pipeline.push({ $match: require_mongo_filter.buildMongoFilter(controls.$having) });
 	if (controls.$sort) pipeline.push({ $sort: controls.$sort });
 	if (controls.$skip) pipeline.push({ $skip: controls.$skip });
 	if (controls.$limit) pipeline.push({ $limit: controls.$limit });
 	return pipeline;
 }
+/**
+* Builds a count-only pipeline: returns the number of distinct groups.
+*
+* Pipeline: $match → $group (just _id) → $project → $match(having) → $count
+*/
 function buildCountPipeline(query) {
 	const { pipeline, groupId, groupBy, controls } = buildPrefix(query);
 	pipeline.push({ $group: { _id: groupId } });
@@ -116,12 +78,11 @@ function buildCountPipeline(query) {
 		const project = { _id: 0 };
 		for (const field of groupBy) project[field] = `$_id.${field}`;
 		pipeline.push({ $project: project });
-		pipeline.push({ $match: buildMongoFilter(controls.$having) });
+		pipeline.push({ $match: require_mongo_filter.buildMongoFilter(controls.$having) });
 	}
 	pipeline.push({ $count: "count" });
 	return pipeline;
 }
-
 //#endregion
-exports.buildAggregatePipeline = buildAggregatePipeline
-exports.buildCountPipeline = buildCountPipeline
+exports.buildAggregatePipeline = buildAggregatePipeline;
+exports.buildCountPipeline = buildCountPipeline;

package/dist/{agg.d.ts → agg.d.cts}

@@ -1,14 +1,7 @@
-import { DbQuery } from '@atscript/db';
-import { Document } from 'mongodb';
-
-/**
- * MongoDB aggregation pipeline builder.
- * Dynamically imported by MongoAdapter.aggregate() on first call.
- *
- * Constructs MongoDB aggregation pipelines from translated DbQuery objects
- * containing $groupBy, $select (with AggregateExpr), $having, $sort, etc.
- */
+import { DbQuery } from "@atscript/db";
+import { Document } from "mongodb";
 
+//#region src/agg.d.ts
 /**
  * Builds a full MongoDB aggregation pipeline for GROUP BY queries.
  *
@@ -21,5 +14,5 @@ declare function buildAggregatePipeline(query: DbQuery): Document[];
  * Pipeline: $match → $group (just _id) → $project → $match(having) → $count
  */
 declare function buildCountPipeline(query: DbQuery): Document[];
-
-export { buildAggregatePipeline, buildCountPipeline };
+//#endregion
+export { buildAggregatePipeline, buildCountPipeline };

package/dist/agg.d.mts

@@ -0,0 +1,18 @@
+import { DbQuery } from "@atscript/db";
+import { Document } from "mongodb";
+
+//#region src/agg.d.ts
+/**
+ * Builds a full MongoDB aggregation pipeline for GROUP BY queries.
+ *
+ * Pipeline: $match → $group → $project → $match(having) → $sort → $skip → $limit
+ */
+declare function buildAggregatePipeline(query: DbQuery): Document[];
+/**
+ * Builds a count-only pipeline: returns the number of distinct groups.
+ *
+ * Pipeline: $match → $group (just _id) → $project → $match(having) → $count
+ */
+declare function buildCountPipeline(query: DbQuery): Document[];
+//#endregion
+export { buildAggregatePipeline, buildCountPipeline };

package/dist/agg.mjs

@@ -1,35 +1,8 @@
+import { t as buildMongoFilter } from "./mongo-filter-CcQO-sEh.mjs";
 import { resolveAlias } from "@atscript/db/agg";
-import { walkFilter } from "@atscript/db";
-
-//#region packages/db-mongo/src/lib/mongo-filter.ts
-const EMPTY = {};
-const mongoVisitor = {
-	comparison(field, op, value) {
-		if (op === "$eq") return { [field]: value };
-		return { [field]: { [op]: value } };
-	},
-	and(children) {
-		if (children.length === 0) return EMPTY;
-		if (children.length === 1) return children[0];
-		return { $and: children };
-	},
-	or(children) {
-		if (children.length === 0) return { _impossible: true };
-		if (children.length === 1) return children[0];
-		return { $or: children };
-	},
-	not(child) {
-		return { $nor: [child] };
-	}
-};
-function buildMongoFilter(filter) {
-	if (!filter || Object.keys(filter).length === 0) return EMPTY;
-	return walkFilter(filter, mongoVisitor) ?? EMPTY;
-}
-
-//#endregion
-//#region packages/db-mongo/src/agg.ts
-/** Simple accumulators that map directly to `{ $<fn>: '$field' }`. */ const SIMPLE_ACCUMULATORS = {
+//#region src/agg.ts
+/** Simple accumulators that map directly to `{ $<fn>: '$field' }`. */
+const SIMPLE_ACCUMULATORS = {
 	sum: "$sum",
 	avg: "$avg",
 	min: "$min",
@@ -37,7 +10,8 @@ function buildMongoFilter(filter) {
 };
 /**
 * Maps an AggregateExpr to a MongoDB $group accumulator expression.
-*/ function toAccumulator(expr) {
+*/
+function toAccumulator(expr) {
 	const simple = SIMPLE_ACCUMULATORS[expr.$fn];
 	if (simple) return { [simple]: `$${expr.$field}` };
 	if (expr.$fn === "count") {
@@ -53,7 +27,8 @@ function buildMongoFilter(filter) {
 /**
 * Builds the common prefix stages: $match + $group._id from groupBy fields.
 * Shared by both full aggregate and count pipelines.
-*/ function buildPrefix(query) {
+*/
+function buildPrefix(query) {
 	const controls = query.controls || {};
 	const groupBy = controls.$groupBy ?? [];
 	const pipeline = [{ $match: buildMongoFilter(query.filter) }];
@@ -66,6 +41,11 @@ function buildMongoFilter(filter) {
 		controls
 	};
 }
+/**
+* Builds a full MongoDB aggregation pipeline for GROUP BY queries.
+*
+* Pipeline: $match → $group → $project → $match(having) → $sort → $skip → $limit
+*/
 function buildAggregatePipeline(query) {
 	const { pipeline, groupId, groupBy, controls } = buildPrefix(query);
 	const groupStage = { _id: groupId };
@@ -85,6 +65,11 @@ function buildAggregatePipeline(query) {
 	if (controls.$limit) pipeline.push({ $limit: controls.$limit });
 	return pipeline;
 }
+/**
+* Builds a count-only pipeline: returns the number of distinct groups.
+*
+* Pipeline: $match → $group (just _id) → $project → $match(having) → $count
+*/
 function buildCountPipeline(query) {
 	const { pipeline, groupId, groupBy, controls } = buildPrefix(query);
 	pipeline.push({ $group: { _id: groupId } });
@@ -97,6 +82,5 @@ function buildCountPipeline(query) {
 	pipeline.push({ $count: "count" });
 	return pipeline;
 }
-
 //#endregion
-export { buildAggregatePipeline, buildCountPipeline };
+export { buildAggregatePipeline, buildCountPipeline };