axiodb 15.0.1 → 15.1.0

package/README.md

@@ -155,7 +155,7 @@ const db = new AxioDB({
 ### Querying
 - **Chainable Query API:** `.query()`, `.Sort()`, `.Limit()`, `.Skip()`, `.setCount()`, `.setProject()`, `.exec()` / `.findOne()`
 - **MongoDB-style Query Operators:** `$gt`, `$gte`, `$lt`, `$lte`, `$ne`, `$in`, `$nin`, `$exists`, `$regex`, `$or`, `$and`
-- **Aggregation Pipelines:** MongoDB-compatible (`$match`, `$group`, `$sort`, `$project`, `$limit`, `$skip`, `$unwind`, `$addFields`, ...)
+- **Aggregation Pipelines:** 60+ MongoDB-compatible stages (`$match`, `$group`, `$sort`, `$project`, `$limit`, `$skip`, `$unwind`, `$addFields`, `$lookup`, `$facet`, `$bucket`, `$count`, `$sample`, ...) with full expression evaluator, cross-collection `$lookup` joins, and custom operator registration via `OperatorRegistry`
 - **Bulk Operations:** high-performance `insertMany`, `UpdateMany`, `deleteMany`
 
 ### Indexing
@@ -882,7 +882,7 @@ For vulnerability reporting, see [SECURITY.md](SECURITY.md).
 | **Built-in caching** | ❌ | ❌ | ❌ | ✅ InMemoryCache |
 | **Worker Threads** | ❌ | ❌ | ❌ | ✅ |
 | **ACID Transactions** | ❌ | ❌ | ✅ | ✅ |
-| **Aggregation Pipelines** | ❌ | Partial | ❌ | ✅ MongoDB-compatible |
+| **Aggregation Pipelines** | ❌ | Partial | ❌ | ✅ 60+ stages, $lookup, custom operators |
 | **TypeScript support** | ✅ | Partial | ✅ | ✅ Full |
 | **Electron compatible** | ✅ | ✅ | ❌ (requires rebuild) | ✅ |
 | **Sweet spot** | <5K docs | <100K docs | 10M+ (relational) | 10K–500K docs |

package/lib/Services/Aggregation/Aggregation.Operation.d.ts

@@ -1,52 +1,13 @@
 import { ErrorInterface, SuccessInterface } from "../../config/Interfaces/Helper/response.helper.interface";
-/**
- * Class that performs aggregation operations on data.
- *
- * This class allows for MongoDB-like aggregation pipeline operations on collection data.
- * It supports various stages including $match, $group, $sort, $project, $limit, $skip,
- * $unwind, and $addFields.
- *
- */
+import { CollectionResolver } from "../../config/Interfaces/Operation/aggregation.interface";
 export default class Aggregation {
     private AllData;
     private readonly Pipeline;
-    private path;
+    private readonly path;
     private readonly collectionName;
     private readonly ResponseHelper;
-    constructor(collectionName: string, path: string, Pipeline: object[] | any);
-    /**
-     * Executes the aggregation pipeline on the data.
-     *
-     * This method processes the aggregation pipeline stages in sequence:
-     * - $match: Filters documents based on specified conditions
-     * - $group: Groups documents by specified fields and applies aggregation operations
-     * - $sort: Sorts documents based on specified fields and order
-     * - $project: Reshapes documents by including specified fields
-     * - $limit: Limits the number of documents in the result
-     * - $skip: Skips a specified number of documents
-     * - $unwind: Deconstructs an array field from input documents
-     * - $addFields: Adds new fields to documents
-     *
-     * The method first validates if the pipeline is an array, loads all buffer data,
-     * and then processes each stage of the pipeline sequentially.
-     *
-     * @throws {Error} If the pipeline is not an array
-     * @returns {Array<any>} The result of the aggregation pipeline
-     */
+    private readonly collectionResolver?;
+    constructor(collectionName: string, path: string, Pipeline: object[] | any, collectionResolver?: CollectionResolver);
     exec(): Promise<SuccessInterface | ErrorInterface>;
-    /**
-     * Loads all buffer raw data from the specified directory.
-     *
-     * This method performs the following steps:
-     * 1. Checks if the directory is locked.
-     * 2. If the directory is not locked, it lists all files in the directory.
-     * 3. Reads each file.
-     * 4. Stores the data in the `AllData` array.
-     * 5. If the directory is locked, it unlocks the directory, reads the files, and then locks the directory again.
-     *
-     * @returns {Promise<SuccessInterface | ErrorInterface>} A promise that resolves to a success or error response.
-     *
-     * @throws {Error} Throws an error if any operation fails.
-     */
-    private LoadAllBufferRawData;
+    private loadSourceData;
 }

package/lib/Services/Aggregation/Aggregation.Operation.js

@@ -12,253 +12,93 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+/* eslint-disable @typescript-eslint/no-explicit-any */
 const response_helper_1 = __importDefault(require("../../Helper/response.helper"));
 const DocumentLoader_helper_1 = __importDefault(require("../../Helper/DocumentLoader.helper"));
 const Console_helper_1 = __importDefault(require("../../Helper/Console.helper"));
 const ReadIndex_service_1 = require("../Index/ReadIndex.service");
-/**
- * Class that performs aggregation operations on data.
- *
- * This class allows for MongoDB-like aggregation pipeline operations on collection data.
- * It supports various stages including $match, $group, $sort, $project, $limit, $skip,
- * $unwind, and $addFields.
- *
- */
+const OperatorRegistry_1 = require("./OperatorRegistry");
+const stageOperators_1 = require("./operators/stageOperators");
 class Aggregation {
-    constructor(collectionName, path, Pipeline) {
-        // property to store the data
+    constructor(collectionName, path, Pipeline, collectionResolver) {
         this.AllData = [];
         this.collectionName = collectionName;
         this.path = path;
         this.AllData = [];
         this.Pipeline = Pipeline;
         this.ResponseHelper = new response_helper_1.default();
+        this.collectionResolver = collectionResolver;
     }
-    /**
-     * Executes the aggregation pipeline on the data.
-     *
-     * This method processes the aggregation pipeline stages in sequence:
-     * - $match: Filters documents based on specified conditions
-     * - $group: Groups documents by specified fields and applies aggregation operations
-     * - $sort: Sorts documents based on specified fields and order
-     * - $project: Reshapes documents by including specified fields
-     * - $limit: Limits the number of documents in the result
-     * - $skip: Skips a specified number of documents
-     * - $unwind: Deconstructs an array field from input documents
-     * - $addFields: Adds new fields to documents
-     *
-     * The method first validates if the pipeline is an array, loads all buffer data,
-     * and then processes each stage of the pipeline sequentially.
-     *
-     * @throws {Error} If the pipeline is not an array
-     * @returns {Array<any>} The result of the aggregation pipeline
-     */
     exec() {
         return __awaiter(this, void 0, void 0, function* () {
             if (!Array.isArray(this.Pipeline)) {
                 throw new Error("Pipeline must be an array of aggregation stages.");
             }
-            if (!this.Pipeline[0] || !this.Pipeline[0].$match) {
-                throw new Error("Pipeline must have a $match operator at top");
-            }
-            if (this.Pipeline.$match) {
-                const fileNames = yield new ReadIndex_service_1.ReadIndex(this.path).getFileFromIndex(this.Pipeline.$match);
-                if (fileNames.length > 0) {
-                    // Load File Names from Index
-                    yield this.LoadAllBufferRawData(fileNames);
-                }
-                else {
-                    // Load all buffer raw data from the specified directory
-                    yield this.LoadAllBufferRawData().then((response) => {
-                        var _a;
-                        if ("data" in response) {
-                            Console_helper_1.default.green(`${(_a = response === null || response === void 0 ? void 0 : response.data) === null || _a === void 0 ? void 0 : _a.length} Documents Loaded for Aggregation`);
-                        }
-                    });
-                }
-            }
-            else {
-                // Load all buffer raw data from the specified directory
-                yield this.LoadAllBufferRawData().then((response) => {
-                    var _a;
-                    if ("data" in response) {
-                        Console_helper_1.default.green(`${(_a = response === null || response === void 0 ? void 0 : response.data) === null || _a === void 0 ? void 0 : _a.length} Documents Loaded for Aggregation`);
-                    }
-                });
-            }
+            yield this.loadSourceData();
             let result = [...this.AllData];
             for (const stage of this.Pipeline) {
-                if (stage.$match) {
-                    result = result.filter((item) => {
-                        return Object.entries(stage.$match).every(([key, value]) => {
-                            var _a;
-                            const itemValue = (_a = item[key]) !== null && _a !== void 0 ? _a : ""; // Ensure item[key] exists
-                            if (typeof value === "string" ||
-                                typeof value === "number" ||
-                                typeof value === "boolean") {
-                                return itemValue === value;
-                            }
-                            if (typeof value === "object" && value !== null) {
-                                if (value instanceof RegExp) {
-                                    return value.test(itemValue);
-                                }
-                                if ("$regex" in value) {
-                                    const regexPattern = value.$regex;
-                                    const regexOptions = "$options" in value ? value.$options : "";
-                                    try {
-                                        const regex = new RegExp(String(regexPattern), regexOptions);
-                                        return regex.test(itemValue);
-                                    }
-                                    catch (error) {
-                                        Console_helper_1.default.red(`Invalid regex: ${regexPattern} with options: ${regexOptions}`, error);
-                                        return false;
-                                    }
-                                }
-                                // Comparison operators
-                                if ("$gte" in value) {
-                                    return itemValue >= value.$gte;
-                                }
-                                if ("$gt" in value) {
-                                    return itemValue > value.$gt;
-                                }
-                                if ("$lte" in value) {
-                                    return itemValue <= value.$lte;
-                                }
-                                if ("$lt" in value) {
-                                    return itemValue < value.$lt;
-                                }
-                                if ("$ne" in value) {
-                                    return itemValue !== value.$ne;
-                                }
-                                if ("$in" in value) {
-                                    return Array.isArray(value.$in) && value.$in.includes(itemValue);
-                                }
-                                if ("$nin" in value) {
-                                    return Array.isArray(value.$nin) && !value.$nin.includes(itemValue);
-                                }
-                            }
-                            return false;
-                        });
-                    });
-                }
-                if (stage.$group) {
-                    const groupedData = {};
-                    for (const item of result) {
-                        let groupKey;
-                        if (typeof stage.$group._id === "string") {
-                            groupKey = stage.$group._id.startsWith("$")
-                                ? item[stage.$group._id.substring(1)]
-                                : stage.$group._id;
-                        }
-                        else if (typeof stage.$group._id === "object") {
-                            groupKey = JSON.stringify(Object.entries(stage.$group._id).reduce((acc, [k, v]) => {
-                                const fieldPath = v.replace("$", "");
-                                acc[k] = item[fieldPath];
-                                return acc;
-                            }, {}));
-                        }
-                        else {
-                            groupKey = "null";
-                        }
-                        if (!groupedData[groupKey]) {
-                            groupedData[groupKey] = { _id: groupKey };
-                        }
-                        for (const [key, operation] of Object.entries(stage.$group)) {
-                            if (key === "_id")
-                                continue;
-                            if (operation.$avg !== undefined) {
-                                const operand = operation.$avg;
-                                const value = typeof operand === "string" ? item[operand.replace("$", "")] : operand;
-                                groupedData[groupKey][key] = groupedData[groupKey][key] || {
-                                    sum: 0,
-                                    count: 0,
-                                };
-                                groupedData[groupKey][key].sum += value;
-                                groupedData[groupKey][key].count += 1;
-                            }
-                            if (operation.$sum !== undefined) {
-                                const operand = operation.$sum;
-                                const value = typeof operand === "string" ? item[operand.replace("$", "")] : operand;
-                                groupedData[groupKey][key] = (groupedData[groupKey][key] || 0) + value;
-                            }
-                        }
-                    }
-                    result = Object.values(groupedData).map((group) => {
-                        for (const key in group) {
-                            if (group[key] && group[key].sum !== undefined) {
-                                group[key] = group[key].sum / group[key].count;
-                            }
-                        }
-                        return group;
-                    });
-                }
-                if (stage.$sort) {
-                    const [[key, order]] = Object.entries(stage.$sort);
-                    const numOrder = Number(order);
-                    result.sort((a, b) => {
-                        if (a[key] < b[key])
-                            return -numOrder;
-                        if (a[key] > b[key])
-                            return numOrder;
-                        return 0;
-                    });
+                if (!stage || typeof stage !== "object")
+                    continue;
+                const opName = Object.keys(stage)[0];
+                if (!opName)
+                    continue;
+                const opExpr = stage[opName];
+                if (opName === "$lookup") {
+                    result = yield (0, stageOperators_1.executeLookup)(result, opExpr, this.collectionResolver);
+                    continue;
                 }
-                if (stage.$project) {
-                    result = result.map((item) => {
-                        const projected = {};
-                        for (const key in stage.$project) {
-                            if (stage.$project[key] === 1) {
-                                projected[key] = item[key];
-                            }
-                        }
-                        return projected;
-                    });
+                if (opName === "$facet") {
+                    result = [(0, stageOperators_1.executeFacet)(result, opExpr)];
+                    continue;
                 }
-                if (stage.$limit) {
-                    result = result.slice(0, stage.$limit);
+                if (opName === "$bucket") {
+                    result = (0, stageOperators_1.executeBucket)(result, opExpr);
+                    continue;
                 }
-                if (stage.$skip) {
-                    result = result.slice(stage.$skip);
+                if (opName === "$bucketAuto") {
+                    result = (0, stageOperators_1.executeBucketAuto)(result, opExpr);
+                    continue;
                 }
-                if (stage.$unwind) {
-                    const field = stage.$unwind.replace("$", "");
-                    result = result.flatMap((item) => {
-                        return Array.isArray(item[field])
-                            ? item[field].map((value) => (Object.assign(Object.assign({}, item), { [field]: value })))
-                            : [item];
-                    });
+                const builtInOp = stageOperators_1.BUILT_IN_STAGE_OPERATORS[opName];
+                if (builtInOp) {
+                    result = builtInOp(result, opExpr);
+                    continue;
                 }
-                if (stage.$addFields) {
-                    result = result.map((item) => (Object.assign(Object.assign({}, item), stage.$addFields)));
+                const registered = OperatorRegistry_1.OperatorRegistry.getOperator(opName);
+                if (registered && registered.type === "stage") {
+                    const customResult = registered.fn(result, opExpr, this.collectionResolver);
+                    result = customResult instanceof Promise ? yield customResult : customResult;
+                    continue;
                 }
+                Console_helper_1.default.red(`Unknown aggregation stage operator: ${opName}`);
             }
             return this.ResponseHelper.Success(result);
         });
     }
-    /**
-     * Loads all buffer raw data from the specified directory.
-     *
-     * This method performs the following steps:
-     * 1. Checks if the directory is locked.
-     * 2. If the directory is not locked, it lists all files in the directory.
-     * 3. Reads each file.
-     * 4. Stores the data in the `AllData` array.
-     * 5. If the directory is locked, it unlocks the directory, reads the files, and then locks the directory again.
-     *
-     * @returns {Promise<SuccessInterface | ErrorInterface>} A promise that resolves to a success or error response.
-     *
-     * @throws {Error} Throws an error if any operation fails.
-     */
-    LoadAllBufferRawData(documentIdDirectFile) {
+    loadSourceData() {
         return __awaiter(this, void 0, void 0, function* () {
-            // Use shared DocumentLoader helper (DRY - consolidates duplicated code)
-            const result = yield DocumentLoader_helper_1.default.loadDocuments(this.path, documentIdDirectFile, false // Don't include fileName for Aggregation
-            );
-            // Store result in AllData if successful
+            const matchExpr = (0, stageOperators_1.extractMatchFromPipeline)(this.Pipeline);
+            if (matchExpr) {
+                try {
+                    const fileNames = yield new ReadIndex_service_1.ReadIndex(this.path).getFileFromIndex(matchExpr);
+                    if (fileNames.length > 0) {
+                        const result = yield DocumentLoader_helper_1.default.loadDocuments(this.path, fileNames, false);
+                        if ("data" in result) {
+                            this.AllData = result.data;
+                            Console_helper_1.default.green(`${this.AllData.length} Documents Loaded for Aggregation (index-optimized)`);
+                            return;
+                        }
+                    }
+                }
+                catch (_a) {
+                    // Index miss - fall through to full scan
+                }
+            }
+            const result = yield DocumentLoader_helper_1.default.loadDocuments(this.path, undefined, false);
             if ("data" in result) {
                 this.AllData = result.data;
+                Console_helper_1.default.green(`${this.AllData.length} Documents Loaded for Aggregation`);
             }
-            return result;
         });
     }
 }

package/lib/Services/Aggregation/Aggregation.Operation.js.map

@@ -1 +1 @@
-{"version":3,"file":"Aggregation.Operation.js","sourceRoot":"","sources":["../../../source/Services/Aggregation/Aggregation.Operation.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"Aggregation.Operation.js","sourceRoot":"","sources":["../../../source/Services/Aggregation/Aggregation.Operation.ts"],"names":[],"mappings":"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"}

package/lib/Services/Aggregation/OperatorRegistry.d.ts

@@ -0,0 +1,11 @@
+import { StageOperatorFn, AccumulatorFn, ExpressionFn, RegisteredOperator } from "../../config/Interfaces/Operation/aggregation.interface";
+export declare class OperatorRegistry {
+    private static operators;
+    static registerStageOperator(name: string, fn: StageOperatorFn): void;
+    static registerAccumulator(name: string, fn: AccumulatorFn): void;
+    static registerExpressionOperator(name: string, fn: ExpressionFn): void;
+    static getOperator(name: string): RegisteredOperator | undefined;
+    static getAllByType(type: "stage" | "accumulator" | "expression"): RegisteredOperator[];
+    static getRegisteredNames(): string[];
+    static clearAll(): void;
+}

package/lib/Services/Aggregation/OperatorRegistry.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OperatorRegistry = void 0;
+class OperatorRegistry {
+    static registerStageOperator(name, fn) {
+        if (!name.startsWith("$"))
+            throw new Error(`Operator name must start with "$", got: "${name}"`);
+        OperatorRegistry.operators.set(name, { type: "stage", name, fn });
+    }
+    static registerAccumulator(name, fn) {
+        if (!name.startsWith("$"))
+            throw new Error(`Operator name must start with "$", got: "${name}"`);
+        OperatorRegistry.operators.set(name, { type: "accumulator", name, fn });
+    }
+    static registerExpressionOperator(name, fn) {
+        if (!name.startsWith("$"))
+            throw new Error(`Operator name must start with "$", got: "${name}"`);
+        OperatorRegistry.operators.set(name, { type: "expression", name, fn });
+    }
+    static getOperator(name) {
+        return OperatorRegistry.operators.get(name);
+    }
+    static getAllByType(type) {
+        return [...OperatorRegistry.operators.values()].filter(op => op.type === type);
+    }
+    static getRegisteredNames() {
+        return [...OperatorRegistry.operators.keys()];
+    }
+    static clearAll() {
+        OperatorRegistry.operators.clear();
+    }
+}
+exports.OperatorRegistry = OperatorRegistry;
+OperatorRegistry.operators = new Map();
+//# sourceMappingURL=OperatorRegistry.js.map

package/lib/Services/Aggregation/OperatorRegistry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"OperatorRegistry.js","sourceRoot":"","sources":["../../../source/Services/Aggregation/OperatorRegistry.ts"],"names":[],"mappings":";;;AAQA;IAGE,MAAM,CAAC,qBAAqB,CAAC,IAAY,EAAE,EAAmB;QAC5D,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,4CAA4C,IAAI,GAAG,CAAC,CAAC;QAChG,gBAAgB,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;IACpE,CAAC;IAED,MAAM,CAAC,mBAAmB,CAAC,IAAY,EAAE,EAAiB;QACxD,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,4CAA4C,IAAI,GAAG,CAAC,CAAC;QAChG,gBAAgB,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;IAC1E,CAAC;IAED,MAAM,CAAC,0BAA0B,CAAC,IAAY,EAAE,EAAgB;QAC9D,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,4CAA4C,IAAI,GAAG,CAAC,CAAC;QAChG,gBAAgB,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;IACzE,CAAC;IAED,MAAM,CAAC,WAAW,CAAC,IAAY;QAC7B,OAAO,gBAAgB,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC9C,CAAC;IAED,MAAM,CAAC,YAAY,CAAC,IAA4C;QAC9D,OAAO,CAAC,GAAG,gBAAgB,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;IACjF,CAAC;IAED,MAAM,CAAC,kBAAkB;QACvB,OAAO,CAAC,GAAG,gBAAgB,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,CAAC;IAChD,CAAC;IAED,MAAM,CAAC,QAAQ;QACb,gBAAgB,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC;IACrC,CAAC;CACF;;AAhCgB,0BAAS,GAAoC,IAAI,GAAG,EAAE,CAAC"}

package/lib/Services/Aggregation/operators/accumulatorOperators.d.ts

@@ -0,0 +1,12 @@
+export declare function accumulatorSum(groupDocs: any[], expr: any): number;
+export declare function accumulatorAvg(groupDocs: any[], expr: any): number | null;
+export declare function accumulatorMin(groupDocs: any[], expr: any): any;
+export declare function accumulatorMax(groupDocs: any[], expr: any): any;
+export declare function accumulatorFirst(groupDocs: any[], expr: any): any;
+export declare function accumulatorLast(groupDocs: any[], expr: any): any;
+export declare function accumulatorPush(groupDocs: any[], expr: any): any[];
+export declare function accumulatorAddToSet(groupDocs: any[], expr: any): any[];
+export declare function accumulatorStdDevPop(groupDocs: any[], expr: any): number | null;
+export declare function accumulatorStdDevSamp(groupDocs: any[], expr: any): number | null;
+export declare function accumulatorCount(groupDocs: any[]): number;
+export declare const BUILT_IN_ACCUMULATORS: Record<string, (groupDocs: any[], expr: any) => any>;

package/lib/Services/Aggregation/operators/accumulatorOperators.js

@@ -0,0 +1,138 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BUILT_IN_ACCUMULATORS = void 0;
+exports.accumulatorSum = accumulatorSum;
+exports.accumulatorAvg = accumulatorAvg;
+exports.accumulatorMin = accumulatorMin;
+exports.accumulatorMax = accumulatorMax;
+exports.accumulatorFirst = accumulatorFirst;
+exports.accumulatorLast = accumulatorLast;
+exports.accumulatorPush = accumulatorPush;
+exports.accumulatorAddToSet = accumulatorAddToSet;
+exports.accumulatorStdDevPop = accumulatorStdDevPop;
+exports.accumulatorStdDevSamp = accumulatorStdDevSamp;
+exports.accumulatorCount = accumulatorCount;
+/* eslint-disable @typescript-eslint/no-explicit-any */
+const expressionOperators_1 = require("./expressionOperators");
+function resolveOperand(doc, operand) {
+    if (typeof operand === "string" && operand.startsWith("$")) {
+        return doc[operand.substring(1)];
+    }
+    if (typeof operand === "object" && operand !== null) {
+        return (0, expressionOperators_1.evaluateExpression)(doc, operand);
+    }
+    return operand;
+}
+function accumulatorSum(groupDocs, expr) {
+    if (typeof expr === "number")
+        return groupDocs.length * expr;
+    return groupDocs.reduce((sum, doc) => {
+        const val = resolveOperand(doc, expr);
+        return sum + (typeof val === "number" ? val : 0);
+    }, 0);
+}
+function accumulatorAvg(groupDocs, expr) {
+    if (groupDocs.length === 0)
+        return null;
+    let sum = 0;
+    let count = 0;
+    for (const doc of groupDocs) {
+        const val = resolveOperand(doc, expr);
+        if (typeof val === "number" && !isNaN(val)) {
+            sum += val;
+            count++;
+        }
+    }
+    return count > 0 ? sum / count : null;
+}
+function accumulatorMin(groupDocs, expr) {
+    if (groupDocs.length === 0)
+        return null;
+    let min = undefined;
+    for (const doc of groupDocs) {
+        const val = resolveOperand(doc, expr);
+        if (val !== null && val !== undefined && (min === undefined || val < min)) {
+            min = val;
+        }
+    }
+    return min !== undefined ? min : null;
+}
+function accumulatorMax(groupDocs, expr) {
+    if (groupDocs.length === 0)
+        return null;
+    let max = undefined;
+    for (const doc of groupDocs) {
+        const val = resolveOperand(doc, expr);
+        if (val !== null && val !== undefined && (max === undefined || val > max)) {
+            max = val;
+        }
+    }
+    return max !== undefined ? max : null;
+}
+function accumulatorFirst(groupDocs, expr) {
+    if (groupDocs.length === 0)
+        return null;
+    return resolveOperand(groupDocs[0], expr);
+}
+function accumulatorLast(groupDocs, expr) {
+    if (groupDocs.length === 0)
+        return null;
+    return resolveOperand(groupDocs[groupDocs.length - 1], expr);
+}
+function accumulatorPush(groupDocs, expr) {
+    return groupDocs.map(doc => resolveOperand(doc, expr));
+}
+function accumulatorAddToSet(groupDocs, expr) {
+    const seen = new Set();
+    const result = [];
+    for (const doc of groupDocs) {
+        const val = resolveOperand(doc, expr);
+        const key = JSON.stringify(val);
+        if (!seen.has(key)) {
+            seen.add(key);
+            result.push(val);
+        }
+    }
+    return result;
+}
+function accumulatorStdDevPop(groupDocs, expr) {
+    if (groupDocs.length === 0)
+        return null;
+    const values = groupDocs
+        .map(doc => resolveOperand(doc, expr))
+        .filter(v => typeof v === "number" && !isNaN(v));
+    if (values.length === 0)
+        return null;
+    const mean = values.reduce((a, b) => a + b, 0) / values.length;
+    const variance = values.reduce((sum, v) => sum + Math.pow(v - mean, 2), 0) / values.length;
+    return Math.sqrt(variance);
+}
+function accumulatorStdDevSamp(groupDocs, expr) {
+    if (groupDocs.length <= 1)
+        return null;
+    const values = groupDocs
+        .map(doc => resolveOperand(doc, expr))
+        .filter(v => typeof v === "number" && !isNaN(v));
+    if (values.length <= 1)
+        return null;
+    const mean = values.reduce((a, b) => a + b, 0) / values.length;
+    const variance = values.reduce((sum, v) => sum + Math.pow(v - mean, 2), 0) / (values.length - 1);
+    return Math.sqrt(variance);
+}
+function accumulatorCount(groupDocs) {
+    return groupDocs.length;
+}
+exports.BUILT_IN_ACCUMULATORS = {
+    $sum: accumulatorSum,
+    $avg: accumulatorAvg,
+    $min: accumulatorMin,
+    $max: accumulatorMax,
+    $first: accumulatorFirst,
+    $last: accumulatorLast,
+    $push: accumulatorPush,
+    $addToSet: accumulatorAddToSet,
+    $stdDevPop: accumulatorStdDevPop,
+    $stdDevSamp: accumulatorStdDevSamp,
+    $count: accumulatorCount,
+};
+//# sourceMappingURL=accumulatorOperators.js.map

package/lib/Services/Aggregation/operators/accumulatorOperators.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"accumulatorOperators.js","sourceRoot":"","sources":["../../../../source/Services/Aggregation/operators/accumulatorOperators.ts"],"names":[],"mappings":"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"}

package/lib/Services/Aggregation/operators/expressionOperators.d.ts

@@ -0,0 +1,3 @@
+export declare function getNestedValue(obj: any, path: string): any;
+export declare function setNestedValue(obj: any, path: string, value: any): void;
+export declare function evaluateExpression(doc: any, expr: any): any;