mongodash 2.0.0 → 2.1.0

package/dist/lib/src/reactiveTasks/queryToExpression.js

@@ -0,0 +1,160 @@
+/**!
+   * mongodash v2.1.0
+   * git+https://github.com/VaclavObornik/mongodash.git
+   *
+   * Copyright (c) 2025 Václav Oborník
+   * Released under the MIT license
+   */
+  "use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.queryToExpression = queryToExpression;
+const mongodb_1 = require("mongodb");
+/**
+ * Converts a standard MongoDB query object into an Aggregation Expression.
+ * strict support for:
+ * - Implicit Equality: { a: 1 }
+ * - Comparisons: $eq, $ne, $gt, $gte, $lt, $lte, $in, $nin
+ * - Logical: $and, $or, $nor, $not
+ * - Regex: /pattern/, $regex
+ * - Existence: $exists
+ *
+ * THROWS error on unsupported operators (like $elemMatch, $all, $xyz) to avoid silent failures.
+ */
+function queryToExpression(query) {
+    if (!query || Object.keys(query).length === 0) {
+        return {};
+    }
+    const conditions = [];
+    for (const key of Object.keys(query)) {
+        const value = query[key];
+        if (key.startsWith('$')) {
+            // Logical Operators
+            if (key === '$or' || key === '$and' || key === '$nor') {
+                if (!Array.isArray(value)) {
+                    throw new Error(`ReactiveTasks: Value for '${key}' must be an array.`);
+                }
+                const mapped = value.map((item) => queryToExpression(item));
+                conditions.push({ [key]: mapped });
+            }
+            else if (key === '$not') {
+                conditions.push({ $not: [queryToExpression(value)] });
+            }
+            else if (key === '$expr') {
+                // If the user mixes $expr into a query, trust it (it's already an expression)
+                conditions.push(value);
+            }
+            else {
+                throw new Error(`ReactiveTasks: Top-level operator '${key}' is not supported in simple filter conversion. Use Aggregation syntax.`);
+            }
+        }
+        else {
+            // Field condition
+            const fieldCondition = parseFieldCondition(key, value);
+            if (fieldCondition) {
+                conditions.push(fieldCondition);
+            }
+        }
+    }
+    if (conditions.length === 0) {
+        return {};
+    }
+    if (conditions.length === 1) {
+        return conditions[0];
+    }
+    return { $and: conditions };
+}
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+function parseFieldCondition(field, value) {
+    // Escape field name if it contains dots? No, user intends dot notation -> mapped to nested access in aggregation.
+    // e.g. "meta.type" -> "$meta.type" (valid in agg if meta is object)
+    const fieldPath = `$${field}`;
+    // 1. Equality / Direct Value
+    if (typeof value !== 'object' ||
+        value === null ||
+        Array.isArray(value) ||
+        value instanceof Date ||
+        value instanceof RegExp ||
+        value instanceof mongodb_1.ObjectId ||
+        value._bsontype === 'ObjectId' // Handling different ObjectId implementations
+    ) {
+        if (value instanceof RegExp) {
+            return { $regexMatch: { input: fieldPath, regex: value.source, options: value.flags } };
+        }
+        return { $eq: [fieldPath, value] };
+    }
+    const valueKeys = Object.keys(value);
+    // Check if it's an object with operators: { age: { $gt: 18 } }
+    const isOperatorObject = valueKeys.length > 0 && valueKeys.every((k) => k.startsWith('$'));
+    if (isOperatorObject) {
+        const fieldConditions = [];
+        for (const op of valueKeys) {
+            const opVal = value[op];
+            switch (op) {
+                case '$eq':
+                    fieldConditions.push({ $eq: [fieldPath, opVal] });
+                    break;
+                case '$ne':
+                    fieldConditions.push({ $ne: [fieldPath, opVal] });
+                    break;
+                case '$gt':
+                    fieldConditions.push({ $gt: [fieldPath, opVal] });
+                    break;
+                case '$gte':
+                    fieldConditions.push({ $gte: [fieldPath, opVal] });
+                    break;
+                case '$lt':
+                    fieldConditions.push({ $lt: [fieldPath, opVal] });
+                    break;
+                case '$lte':
+                    fieldConditions.push({ $lte: [fieldPath, opVal] });
+                    break;
+                case '$in':
+                    fieldConditions.push({ $in: [fieldPath, opVal] });
+                    break;
+                case '$nin':
+                    fieldConditions.push({ $not: [{ $in: [fieldPath, opVal] }] });
+                    break;
+                case '$exists':
+                    // { field: { $exists: true } } -> { $ne: [{ $type: "$field" }, "missing"] }
+                    if (opVal) {
+                        fieldConditions.push({ $ne: [{ $type: fieldPath }, 'missing'] });
+                    }
+                    else {
+                        fieldConditions.push({ $eq: [{ $type: fieldPath }, 'missing'] });
+                    }
+                    break;
+                case '$regex':
+                    // { name: { $regex: 'val', $options: 'i' } }
+                    const options = value['$options'] || '';
+                    fieldConditions.push({ $regexMatch: { input: fieldPath, regex: opVal, options } });
+                    break;
+                case '$options':
+                    // Handled in $regex
+                    break;
+                case '$type':
+                    fieldConditions.push({ $eq: [{ $type: fieldPath }, opVal] });
+                    break;
+                case '$size':
+                    fieldConditions.push({ $eq: [{ $size: fieldPath }, opVal] });
+                    break;
+                default:
+                    throw new Error(`ReactiveTasks: Operator '${op}' on field '${field}' is not supported in simple filter conversion. Use Aggregation syntax.`);
+            }
+        }
+        if (fieldConditions.length === 0) {
+            return null;
+        }
+        if (fieldConditions.length === 1) {
+            return fieldConditions[0];
+        }
+        return { $and: fieldConditions };
+    }
+    else {
+        // Direct object equality: { "meta": { type: "param" } } -> { $eq: ["$meta", { type: "param" }] }
+        // BUT if user did "meta.type": "val", it lands here.
+        // fieldPath is "$meta.type". value is "val".
+        // { $eq: ["$meta.type", "val"] } -> CORRECT.
+        return { $eq: [fieldPath, value] };
+    }
+}
+//# sourceMappingURL=queryToExpression.js.map

package/dist/lib/src/reactiveTasks/queryToExpression.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"queryToExpression.js","sourceRoot":"","sources":["../../../../src/reactiveTasks/queryToExpression.ts"],"names":[],"mappings":"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"}

package/dist/lib/src/reactiveTasks/validateTaskFilter.js

@@ -0,0 +1,88 @@
+/**!
+   * mongodash v2.1.0
+   * git+https://github.com/VaclavObornik/mongodash.git
+   *
+   * Copyright (c) 2025 Václav Oborník
+   * Released under the MIT license
+   */
+  "use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.normalizeTaskFilter = normalizeTaskFilter;
+const queryToExpression_1 = require("./queryToExpression");
+/**
+ * Normalizes the task filter into a valid Aggregation Expression.
+ * If the filter is a standard query (keys not starting with $), it is converted.
+ * If the filter is already an expression (keys starting with $), it is kept.
+ *
+ * @param filter The filter object to normalize.
+ * @param taskName The name of the task (for error context).
+ */
+function normalizeTaskFilter(filter, taskName) {
+    if (!filter) {
+        return undefined;
+    }
+    if (typeof filter !== 'object' || Array.isArray(filter)) {
+        throw new Error(`Task '${taskName}': Invalid filter. Expected an object.`);
+    }
+    const keys = Object.keys(filter);
+    if (keys.length === 0) {
+        return {};
+    }
+    // Check if it's already an expression (simple heuristic: empty or $expr)
+    // Or if it DOESN'T look like a query.
+    // However, { $and: [...] } is valid query AND valid expression (mostly).
+    // The main difference is { field: val } vs { $eq: ['$field', val] }.
+    // We assume if ANY key does NOT start with $, it is definitely a Query.
+    const hasFieldKeys = keys.some((k) => !k.startsWith('$'));
+    if (hasFieldKeys) {
+        try {
+            return (0, queryToExpression_1.queryToExpression)(filter);
+        }
+        catch (e) {
+            throw new Error(`Task '${taskName}': Failed to convert simple filter to expression: ${e.message}`);
+        }
+    }
+    // If all keys start with $, it's EITHER a logical query OR an expression.
+    // queryToExpression handles $and/$or/$not recursively via queryToExpression.
+    // But if the user intended { $eq: ['$a', 1] }, queryToExpression would trip on '$eq' as top level key?
+    // queryToExpression throws on unsupported top level keys.
+    // So if the user provided a valid expression like { $eq: ... }, queryToExpression would throw.
+    // Heuristic: If it looks like an expression (keys are aggregation operators), return as is.
+    // IF the user provided { $or: [ { a: 1 } ] }, this is a query using logical op.
+    // If they provided { $or: [ { $eq: ... } ] }, this is an expression.
+    // The safest bet is: if we see field keys (not starting with $), CONVERT.
+    // If all keys start with $, we assume it is ALREADY an expression, UNLESS it is $or/$and/$nor/$not which are ambiguous.
+    // But wait, { $or: [{ a: 1 }] } -> queryToExpression handles this recursively.
+    // { $or: [{ $eq: [..] }] } -> queryToExpression -> $or -> map -> queryToExpression({ $eq: .. }) -> Throw 'Unsupported top level operator $eq'?
+    // So queryToExpression is strict about what it accepts.
+    // If the top level is $or, it descends.
+    // If we want to support both, we need to know intent.
+    // Let's rely on the previous logic: If the user provides a "Simple Filter", they imply Query Syntax.
+    // If they strictly use Expression Syntax, they usually wrap in { $expr: ... } or use operators that queryToExpression doesn't support.
+    // If validation fails (queryToExpression throws), we could assume it's an Expression and return it?
+    // But queryToExpression might partially convert deep inside?
+    // Let's assume: If it works as Query, convert it. If it throws, assume it is Expression?
+    // That is risky.
+    // Better strategy:
+    // If ANY key does NOT start with $, it MUST be a Query -> Convert.
+    // If ALL keys start with $ AND it includes $expr, it is Expression -> Return.
+    // If ALL keys start with $ AND are logical ($or/$and), checks children?
+    // Compromise:
+    // If the user uses the feature 'Simple Filtering', they should probably NOT mix Expression syntax at root unless wrapped in $expr.
+    // If they pass { $eq: ['$a', 1] }, queryToExpression throws. We catch and return original?
+    try {
+        const expr = (0, queryToExpression_1.queryToExpression)(filter);
+        if (expr && Object.keys(expr).length === 1 && expr.$expr) {
+            return expr.$expr;
+        }
+        return expr;
+    }
+    catch (_a) {
+        // If conversion failed, it might be because it was already an expression.
+        if (keys.length === 1 && keys[0] === '$expr') {
+            return filter.$expr;
+        }
+        return filter;
+    }
+}
+//# sourceMappingURL=validateTaskFilter.js.map

package/dist/lib/src/reactiveTasks/validateTaskFilter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validateTaskFilter.js","sourceRoot":"","sources":["../../../../src/reactiveTasks/validateTaskFilter.ts"],"names":[],"mappings":";;AAWA,kDAgFC;AA1FD,2DAAwD;AAExD;;;;;;;GAOG;AACH,SAAgB,mBAAmB,CAAC,MAA4B,EAAE,QAAgB;IAC9E,IAAI,CAAC,MAAM,EAAE,CAAC;QACV,OAAO,SAAS,CAAC;IACrB,CAAC;IAED,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QACtD,MAAM,IAAI,KAAK,CAAC,SAAS,QAAQ,wCAAwC,CAAC,CAAC;IAC/E,CAAC;IAED,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACjC,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACpB,OAAO,EAAE,CAAC;IACd,CAAC;IAED,yEAAyE;IACzE,sCAAsC;IACtC,yEAAyE;IACzE,qEAAqE;IAErE,wEAAwE;IACxE,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC;IAE1D,IAAI,YAAY,EAAE,CAAC;QACf,IAAI,CAAC;YACD,OAAO,IAAA,qCAAiB,EAAC,MAAM,CAAC,CAAC;QACrC,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACT,MAAM,IAAI,KAAK,CAAC,SAAS,QAAQ,qDAAsD,CAAW,CAAC,OAAO,EAAE,CAAC,CAAC;QAClH,CAAC;IACL,CAAC;IAED,0EAA0E;IAC1E,6EAA6E;IAC7E,uGAAuG;IACvG,0DAA0D;IAC1D,+FAA+F;IAE/F,4FAA4F;IAC5F,gFAAgF;IAChF,qEAAqE;IAErE,0EAA0E;IAC1E,wHAAwH;IACxH,+EAA+E;IAC/E,+IAA+I;IAE/I,wDAAwD;IACxD,wCAAwC;IACxC,sDAAsD;IAEtD,qGAAqG;IACrG,uIAAuI;IAEvI,oGAAoG;IACpG,6DAA6D;IAE7D,yFAAyF;IACzF,iBAAiB;IAEjB,mBAAmB;IACnB,mEAAmE;IACnE,8EAA8E;IAC9E,wEAAwE;IAExE,cAAc;IACd,mIAAmI;IACnI,2FAA2F;IAE3F,IAAI,CAAC;QACD,MAAM,IAAI,GAAG,IAAA,qCAAiB,EAAC,MAAM,CAAC,CAAC;QACvC,IAAI,IAAI,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACvD,OAAO,IAAI,CAAC,KAAK,CAAC;QACtB,CAAC;QACD,OAAO,IAAI,CAAC;IAChB,CAAC;IAAC,WAAM,CAAC;QACL,0EAA0E;QAC1E,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,OAAO,EAAE,CAAC;YAC3C,OAAO,MAAM,CAAC,KAAK,CAAC;QACxB,CAAC;QACD,OAAO,MAAM,CAAC;IAClB,CAAC;AACL,CAAC"}

package/dist/lib/src/task-management/OperationalTaskController.js

@@ -0,0 +1,162 @@
+/**!
+   * mongodash v2.1.0
+   * git+https://github.com/VaclavObornik/mongodash.git
+   *
+   * Copyright (c) 2025 Václav Oborník
+   * Released under the MIT license
+   */
+  "use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OperationalTaskController = void 0;
+const cronTasks_1 = require("../cronTasks");
+const getMongoClient_1 = require("../getMongoClient");
+const mongodb_1 = require("mongodb");
+class OperationalTaskController {
+    constructor(scheduler) {
+        this.scheduler = scheduler;
+    }
+    async getReactiveTasks(params) {
+        const query = {};
+        if (params.task) {
+            query.task = params.task;
+        }
+        else if (params.collection) {
+            // Map collection to task names that belong to it
+            const allTasks = this.scheduler.getRegistry().getAllTasks();
+            const taskNamesInCollection = allTasks.filter((t) => t.sourceCollection.collectionName === params.collection).map((t) => t.task);
+            if (taskNamesInCollection.length > 0) {
+                query.task = taskNamesInCollection;
+            }
+            else {
+                // No tasks in this collection, return empty result
+                query.task = ['__nonexistent__'];
+            }
+        }
+        if (params.status) {
+            query.status = params.status.split(',').map((s) => s.trim());
+        }
+        if (params.errorMessage) {
+            query.errorMessage = params.errorMessage;
+        }
+        if (params.hasError !== undefined) {
+            query.hasError = params.hasError === 'true';
+        }
+        if (params.sourceDocId) {
+            query.sourceDocFilter = this.createSmartIdFilter(params.sourceDocId);
+        }
+        const statsQuery = Object.assign({}, query);
+        delete statsQuery.status;
+        delete statsQuery.errorMessage;
+        delete statsQuery.hasError;
+        const [result, stats] = await Promise.all([
+            this.scheduler.getTaskManager().getTasks(query, {
+                limit: Number(params.limit || 50),
+                skip: Number(params.skip || 0),
+                sort: { field: 'scheduledAt', direction: 1 },
+            }),
+            this.scheduler.getTaskManager().getTaskStats(statsQuery),
+        ]);
+        // Hide sensitive internal data
+        result.items.forEach((item) => {
+            delete item.lastObservedValues;
+        });
+        return Object.assign(Object.assign({}, result), { stats });
+    }
+    async retryReactiveTasks(body) {
+        const query = {};
+        if (body.task) {
+            query.task = body.task;
+        }
+        if (body.status) {
+            query.status = body.status;
+        }
+        if (body.errorMessage) {
+            query.errorMessage = body.errorMessage;
+        }
+        if (body._id) {
+            query._id = body._id;
+        }
+        if (body.sourceDocId) {
+            query.sourceDocFilter = this.createSmartIdFilter(body.sourceDocId);
+        }
+        return this.scheduler.getTaskManager().retryTasks(query);
+    }
+    createSmartIdFilter(sourceDocId) {
+        const input = sourceDocId.trim();
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const candidates = [input];
+        // Smart ID Matching:
+        // 1. Exact String (already added)
+        // 2. ObjectId (if valid hex)
+        if (/^[0-9a-fA-F]{24}$/.test(input)) {
+            candidates.push(new mongodb_1.ObjectId(input));
+        }
+        // 3. Number (if valid number)
+        if (!isNaN(Number(input)) && input !== '') {
+            candidates.push(Number(input));
+        }
+        return { _id: { $in: candidates } };
+    }
+    async getCronTasks(params) {
+        return (0, cronTasks_1.getCronTasksList)({
+            filter: params.filter,
+            limit: Number(params.limit || 50),
+            skip: Number(params.skip || 0),
+            sort: params.sort,
+        });
+    }
+    async triggerCronTask(body) {
+        if (!body.taskId)
+            throw new Error('taskId is required');
+        await (0, cronTasks_1.triggerCronTask)(body.taskId);
+        return { success: true };
+    }
+    async getInfo() {
+        const [allStats, cronPaged] = await Promise.all([this.scheduler.getTaskManager().getAllTaskStats(), (0, cronTasks_1.getCronTasksList)({ limit: 1000 })]);
+        const allTasks = this.scheduler.getRegistry().getAllTasks();
+        const reactiveTasks = allTasks
+            .map((t) => {
+            const stats = allStats[t.task] || { statuses: [], errorCount: 0 };
+            const counts = {
+                success: 0,
+                failed: 0,
+                processing: 0,
+                pending: 0,
+                error: stats.errorCount || 0,
+            };
+            for (const s of stats.statuses) {
+                const status = s._id;
+                if (status === 'completed' || status === 'success')
+                    counts.success += s.count;
+                if (status === 'failed')
+                    counts.failed += s.count;
+                if (status === 'processing' || status === 'processing_dirty')
+                    counts.processing += s.count;
+                if (status === 'pending')
+                    counts.pending += s.count;
+            }
+            return {
+                name: t.task,
+                collection: t.sourceCollection.collectionName,
+                stats: counts,
+            };
+        })
+            .sort((a, b) => a.name.localeCompare(b.name));
+        const cronTasks = cronPaged.items.map((t) => {
+            var _a;
+            return ({
+                id: t._id,
+                status: t.status,
+                lastRunError: (_a = t.lastRun) === null || _a === void 0 ? void 0 : _a.error,
+                nextRunAt: t.nextRunAt,
+            });
+        });
+        return {
+            databaseName: (0, getMongoClient_1.getMongoClient)().db().databaseName,
+            reactiveTasks,
+            cronTasks,
+        };
+    }
+}
+exports.OperationalTaskController = OperationalTaskController;
+//# sourceMappingURL=OperationalTaskController.js.map

package/dist/lib/src/task-management/OperationalTaskController.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"OperationalTaskController.js","sourceRoot":"","sources":["../../../../src/task-management/OperationalTaskController.ts"],"names":[],"mappings":"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"}

package/dist/lib/src/task-management/index.js

@@ -0,0 +1,27 @@
+/**!
+   * mongodash v2.1.0
+   * git+https://github.com/VaclavObornik/mongodash.git
+   *
+   * Copyright (c) 2025 Václav Oborník
+   * Released under the MIT license
+   */
+  "use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./OperationalTaskController"), exports);
+__exportStar(require("./serveDashboard"), exports);
+__exportStar(require("./types"), exports);
+//# sourceMappingURL=index.js.map

package/dist/lib/src/task-management/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/task-management/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,8DAA4C;AAC5C,mDAAiC;AACjC,0CAAwB"}

package/dist/lib/src/task-management/serveDashboard.js

@@ -0,0 +1,149 @@
+/**!
+   * mongodash v2.1.0
+   * git+https://github.com/VaclavObornik/mongodash.git
+   *
+   * Copyright (c) 2025 Václav Oborník
+   * Released under the MIT license
+   */
+  "use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.serveDashboard = serveDashboard;
+const fs = require("fs");
+const path = require("path");
+const url_1 = require("url");
+const index_1 = require("../reactiveTasks/index");
+const OperationalTaskController_1 = require("./OperationalTaskController");
+console.log('[serveDashboard.ts] Module loaded');
+const mimeTypes = {
+    '.html': 'text/html',
+    '.js': 'text/javascript',
+    '.css': 'text/css',
+    '.json': 'application/json',
+    '.png': 'image/png',
+    '.jpg': 'image/jpeg',
+    '.gif': 'image/gif',
+    '.svg': 'image/svg+xml',
+    '.ico': 'image/x-icon',
+};
+/**
+ * Serve the mongodash dashboard.
+ * Framework-agnostic: Works with Express, Koa, or native Node.js http.
+ * Returns true if the request was handled.
+ */
+async function serveDashboard(req, res, options = {}) {
+    const scheduler = options.scheduler || index_1._scheduler;
+    const controller = new OperationalTaskController_1.OperationalTaskController(scheduler);
+    // Default dashboard path: inside dist/dashboard of the package
+    // When running from src..., it might be elsewhere, but we assume it's integrated.
+    // __dirname is .../src/task-management
+    const dashboardPath = options.dashboardPath || path.resolve(__dirname, '../../dist/dashboard');
+    const parsedUrl = (0, url_1.parse)(req.url || '', true);
+    const pathname = parsedUrl.pathname || '/';
+    const method = (req.method || 'GET').toUpperCase();
+    // 1. Handle API Requests
+    // We look for /api/ in the path. This supports mounting with prefixes.
+    const apiIndex = pathname.indexOf('/api/');
+    if (apiIndex !== -1) {
+        const apiPath = pathname.substring(apiIndex); // e.g. /api/reactive/list
+        try {
+            if (method === 'GET' && apiPath === '/api/reactive/list') {
+                // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                const result = await controller.getReactiveTasks(parsedUrl.query);
+                return sendJson(res, result);
+            }
+            if (method === 'POST' && apiPath === '/api/reactive/retry') {
+                const body = await getBody(req);
+                const result = await controller.retryReactiveTasks(body);
+                return sendJson(res, result);
+            }
+            if (method === 'GET' && apiPath === '/api/cron/list') {
+                // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                const result = await controller.getCronTasks(parsedUrl.query);
+                return sendJson(res, result);
+            }
+            if (method === 'POST' && apiPath === '/api/cron/trigger') {
+                const body = await getBody(req);
+                const result = await controller.triggerCronTask(body);
+                return sendJson(res, result);
+            }
+            if (method === 'GET' && apiPath === '/api/info') {
+                const result = await controller.getInfo();
+                return sendJson(res, result);
+            }
+            // If it matched /api/ but no handler, we return false so parent can handle or 404
+            return false;
+        }
+        catch (err) {
+            return sendError(res, err);
+        }
+    }
+    // 2. Handle Static Files
+    if (method === 'GET' && fs.existsSync(dashboardPath)) {
+        // We need to decide which part of pathname is the file.
+        // If mounted at /dash, pathname might be /dash/assets/log.png
+        // We try to find the file from the end of the pathname.
+        // Brute force: try suffixes? No, too slow.
+        // Better: The dashboard is a single-file build or limited assets.
+        // We can check if the pathname (or parts of it) exist in dashboardPath.
+        const pathParts = pathname.split('/').filter(Boolean);
+        // Try suffixes from longest to shortest
+        for (let i = 0; i < pathParts.length; i++) {
+            const potentialFile = pathParts.slice(i).join('/');
+            const filePath = path.join(dashboardPath, potentialFile);
+            if (fs.existsSync(filePath) && fs.statSync(filePath).isFile()) {
+                return pipeFile(res, filePath);
+            }
+        }
+        // 3. SPA Fallback
+        // If it's a GET request and no file found, and it looks like a dashboard route (no extension)
+        const lastPart = pathParts[pathParts.length - 1] || '';
+        if (!lastPart.includes('.') || pathname.endsWith('/')) {
+            const indexPath = path.join(dashboardPath, 'index.html');
+            if (fs.existsSync(indexPath)) {
+                return pipeFile(res, indexPath);
+            }
+        }
+    }
+    return false;
+}
+async function getBody(req) {
+    // If body is already parsed (Express/Koa with body-parser)
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    if (req.body)
+        return req.body;
+    return new Promise((resolve, reject) => {
+        let body = '';
+        req.on('data', (chunk) => {
+            body += chunk.toString();
+        });
+        req.on('end', () => {
+            try {
+                resolve(body ? JSON.parse(body) : {});
+            }
+            catch (_a) {
+                reject(new Error('Invalid JSON body'));
+            }
+        });
+        req.on('error', reject);
+    });
+}
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+function sendJson(res, data) {
+    res.setHeader('Content-Type', 'application/json');
+    res.end(JSON.stringify(data));
+    return true;
+}
+function sendError(res, err) {
+    res.statusCode = 500;
+    res.setHeader('Content-Type', 'application/json');
+    res.end(JSON.stringify({ error: err instanceof Error ? err.message : String(err) }));
+    return true;
+}
+function pipeFile(res, filePath) {
+    const ext = path.extname(filePath).toLowerCase();
+    const mime = mimeTypes[ext] || 'application/octet-stream';
+    res.setHeader('Content-Type', mime);
+    fs.createReadStream(filePath).pipe(res);
+    return true;
+}
+//# sourceMappingURL=serveDashboard.js.map

package/dist/lib/src/task-management/serveDashboard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"serveDashboard.js","sourceRoot":"","sources":["../../../../src/task-management/serveDashboard.ts"],"names":[],"mappings":"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"}

package/dist/lib/src/task-management/types.js

@@ -0,0 +1,10 @@
+/**!
+   * mongodash v2.1.0
+   * git+https://github.com/VaclavObornik/mongodash.git
+   *
+   * Copyright (c) 2025 Václav Oborník
+   * Released under the MIT license
+   */
+  "use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/lib/src/task-management/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/task-management/types.ts"],"names":[],"mappings":""}