@atscript/db-mongo 0.1.38

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025-present Artem Maltsev
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/agg-CUX5Jb_A.mjs

@@ -0,0 +1,75 @@
+import { buildMongoFilter } from "./mongo-filter-CL69Yhcm.mjs";
+import { resolveAlias } from "@atscript/db/agg";
+
+//#region packages/db-mongo/src/agg.ts
+/** Simple accumulators that map directly to `{ $<fn>: '$field' }`. */ const SIMPLE_ACCUMULATORS = {
+	sum: "$sum",
+	avg: "$avg",
+	min: "$min",
+	max: "$max"
+};
+/**
+* Maps an AggregateExpr to a MongoDB $group accumulator expression.
+*/ function toAccumulator(expr) {
+	const simple = SIMPLE_ACCUMULATORS[expr.$fn];
+	if (simple) return { [simple]: `$${expr.$field}` };
+	if (expr.$fn === "count") {
+		if (expr.$field === "*") return { $sum: 1 };
+		return { $sum: { $cond: [
+			{ $ne: [`$${expr.$field}`, null] },
+			1,
+			0
+		] } };
+	}
+	throw new Error(`Unsupported aggregate function: ${expr.$fn}`);
+}
+/**
+* Builds the common prefix stages: $match + $group._id from groupBy fields.
+* Shared by both full aggregate and count pipelines.
+*/ function buildPrefix(query) {
+	const controls = query.controls || {};
+	const groupBy = controls.$groupBy ?? [];
+	const pipeline = [{ $match: buildMongoFilter(query.filter) }];
+	const groupId = {};
+	for (const field of groupBy) groupId[field] = `$${field}`;
+	return {
+		pipeline,
+		groupId,
+		groupBy,
+		controls
+	};
+}
+function buildAggregatePipeline(query) {
+	const { pipeline, groupId, groupBy, controls } = buildPrefix(query);
+	const groupStage = { _id: groupId };
+	const project = { _id: 0 };
+	const aggregates = controls.$select?.aggregates;
+	for (const field of groupBy) project[field] = `$_id.${field}`;
+	if (aggregates) for (const expr of aggregates) {
+		const alias = 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.$sort) pipeline.push({ $sort: controls.$sort });
+	if (controls.$skip) pipeline.push({ $skip: controls.$skip });
+	if (controls.$limit) pipeline.push({ $limit: controls.$limit });
+	return pipeline;
+}
+function buildCountPipeline(query) {
+	const { pipeline, groupId, groupBy, controls } = buildPrefix(query);
+	pipeline.push({ $group: { _id: groupId } });
+	if (controls.$having) {
+		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({ $count: "count" });
+	return pipeline;
+}
+
+//#endregion
+export { buildAggregatePipeline, buildCountPipeline };

package/dist/agg-FBVtOv9k.cjs

@@ -0,0 +1,77 @@
+"use strict";
+const require_mongo_filter = require('./mongo-filter-C8w5by9H.cjs');
+const __atscript_db_agg = require_mongo_filter.__toESM(require("@atscript/db/agg"));
+
+//#region packages/db-mongo/src/agg.ts
+/** Simple accumulators that map directly to `{ $<fn>: '$field' }`. */ const SIMPLE_ACCUMULATORS = {
+	sum: "$sum",
+	avg: "$avg",
+	min: "$min",
+	max: "$max"
+};
+/**
+* Maps an AggregateExpr to a MongoDB $group accumulator expression.
+*/ function toAccumulator(expr) {
+	const simple = SIMPLE_ACCUMULATORS[expr.$fn];
+	if (simple) return { [simple]: `$${expr.$field}` };
+	if (expr.$fn === "count") {
+		if (expr.$field === "*") return { $sum: 1 };
+		return { $sum: { $cond: [
+			{ $ne: [`$${expr.$field}`, null] },
+			1,
+			0
+		] } };
+	}
+	throw new Error(`Unsupported aggregate function: ${expr.$fn}`);
+}
+/**
+* Builds the common prefix stages: $match + $group._id from groupBy fields.
+* Shared by both full aggregate and count pipelines.
+*/ function buildPrefix(query) {
+	const controls = query.controls || {};
+	const groupBy = controls.$groupBy ?? [];
+	const pipeline = [{ $match: require_mongo_filter.buildMongoFilter(query.filter) }];
+	const groupId = {};
+	for (const field of groupBy) groupId[field] = `$${field}`;
+	return {
+		pipeline,
+		groupId,
+		groupBy,
+		controls
+	};
+}
+function buildAggregatePipeline(query) {
+	const { pipeline, groupId, groupBy, controls } = buildPrefix(query);
+	const groupStage = { _id: groupId };
+	const project = { _id: 0 };
+	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);
+		groupStage[alias] = toAccumulator(expr);
+		project[alias] = 1;
+	}
+	pipeline.push({ $group: groupStage });
+	pipeline.push({ $project: project });
+	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;
+}
+function buildCountPipeline(query) {
+	const { pipeline, groupId, groupBy, controls } = buildPrefix(query);
+	pipeline.push({ $group: { _id: groupId } });
+	if (controls.$having) {
+		const project = { _id: 0 };
+		for (const field of groupBy) project[field] = `$_id.${field}`;
+		pipeline.push({ $project: project });
+		pipeline.push({ $match: require_mongo_filter.buildMongoFilter(controls.$having) });
+	}
+	pipeline.push({ $count: "count" });
+	return pipeline;
+}
+
+//#endregion
+exports.buildAggregatePipeline = buildAggregatePipeline
+exports.buildCountPipeline = buildCountPipeline

package/dist/agg.cjs

@@ -0,0 +1,127 @@
+"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 = {
+	sum: "$sum",
+	avg: "$avg",
+	min: "$min",
+	max: "$max"
+};
+/**
+* Maps an AggregateExpr to a MongoDB $group accumulator expression.
+*/ function toAccumulator(expr) {
+	const simple = SIMPLE_ACCUMULATORS[expr.$fn];
+	if (simple) return { [simple]: `$${expr.$field}` };
+	if (expr.$fn === "count") {
+		if (expr.$field === "*") return { $sum: 1 };
+		return { $sum: { $cond: [
+			{ $ne: [`$${expr.$field}`, null] },
+			1,
+			0
+		] } };
+	}
+	throw new Error(`Unsupported aggregate function: ${expr.$fn}`);
+}
+/**
+* Builds the common prefix stages: $match + $group._id from groupBy fields.
+* Shared by both full aggregate and count pipelines.
+*/ function buildPrefix(query) {
+	const controls = query.controls || {};
+	const groupBy = controls.$groupBy ?? [];
+	const pipeline = [{ $match: buildMongoFilter(query.filter) }];
+	const groupId = {};
+	for (const field of groupBy) groupId[field] = `$${field}`;
+	return {
+		pipeline,
+		groupId,
+		groupBy,
+		controls
+	};
+}
+function buildAggregatePipeline(query) {
+	const { pipeline, groupId, groupBy, controls } = buildPrefix(query);
+	const groupStage = { _id: groupId };
+	const project = { _id: 0 };
+	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);
+		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.$sort) pipeline.push({ $sort: controls.$sort });
+	if (controls.$skip) pipeline.push({ $skip: controls.$skip });
+	if (controls.$limit) pipeline.push({ $limit: controls.$limit });
+	return pipeline;
+}
+function buildCountPipeline(query) {
+	const { pipeline, groupId, groupBy, controls } = buildPrefix(query);
+	pipeline.push({ $group: { _id: groupId } });
+	if (controls.$having) {
+		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({ $count: "count" });
+	return pipeline;
+}
+
+//#endregion
+exports.buildAggregatePipeline = buildAggregatePipeline
+exports.buildCountPipeline = buildCountPipeline

package/dist/agg.d.ts

@@ -0,0 +1,25 @@
+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.
+ */
+
+/**
+ * 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[];
+
+export { buildAggregatePipeline, buildCountPipeline };

package/dist/agg.mjs

@@ -0,0 +1,102 @@
+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 = {
+	sum: "$sum",
+	avg: "$avg",
+	min: "$min",
+	max: "$max"
+};
+/**
+* Maps an AggregateExpr to a MongoDB $group accumulator expression.
+*/ function toAccumulator(expr) {
+	const simple = SIMPLE_ACCUMULATORS[expr.$fn];
+	if (simple) return { [simple]: `$${expr.$field}` };
+	if (expr.$fn === "count") {
+		if (expr.$field === "*") return { $sum: 1 };
+		return { $sum: { $cond: [
+			{ $ne: [`$${expr.$field}`, null] },
+			1,
+			0
+		] } };
+	}
+	throw new Error(`Unsupported aggregate function: ${expr.$fn}`);
+}
+/**
+* Builds the common prefix stages: $match + $group._id from groupBy fields.
+* Shared by both full aggregate and count pipelines.
+*/ function buildPrefix(query) {
+	const controls = query.controls || {};
+	const groupBy = controls.$groupBy ?? [];
+	const pipeline = [{ $match: buildMongoFilter(query.filter) }];
+	const groupId = {};
+	for (const field of groupBy) groupId[field] = `$${field}`;
+	return {
+		pipeline,
+		groupId,
+		groupBy,
+		controls
+	};
+}
+function buildAggregatePipeline(query) {
+	const { pipeline, groupId, groupBy, controls } = buildPrefix(query);
+	const groupStage = { _id: groupId };
+	const project = { _id: 0 };
+	const aggregates = controls.$select?.aggregates;
+	for (const field of groupBy) project[field] = `$_id.${field}`;
+	if (aggregates) for (const expr of aggregates) {
+		const alias = 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.$sort) pipeline.push({ $sort: controls.$sort });
+	if (controls.$skip) pipeline.push({ $skip: controls.$skip });
+	if (controls.$limit) pipeline.push({ $limit: controls.$limit });
+	return pipeline;
+}
+function buildCountPipeline(query) {
+	const { pipeline, groupId, groupBy, controls } = buildPrefix(query);
+	pipeline.push({ $group: { _id: groupId } });
+	if (controls.$having) {
+		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({ $count: "count" });
+	return pipeline;
+}
+
+//#endregion
+export { buildAggregatePipeline, buildCountPipeline };