vikunja-mcp-ng 0.4.0

package/dist/storage/SimpleFilterStorage.js

@@ -0,0 +1,350 @@
+"use strict";
+/**
+ * Simple filter storage - eliminates over-engineering
+ *
+ * Replaces 33 files and 9,803 lines with essential functionality:
+ * - Session-isolated filter storage
+ * - Thread-safe operations with mutex
+ * - Same external API as before
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.storageManager = exports.FilterStorageManager = exports.SimpleFilterStorage = void 0;
+const logger_1 = require("../utils/logger");
+const async_mutex_1 = require("async-mutex");
+const uuid_1 = require("uuid");
+/**
+ * Simple filter storage implementation
+ */
+class SimpleFilterStorage {
+    filters = new Map();
+    mutex = new async_mutex_1.Mutex();
+    session;
+    constructor(sessionId, userId, apiUrl) {
+        this.session = {
+            id: sessionId,
+            createdAt: new Date(),
+            lastAccessAt: new Date(),
+            ...(userId !== undefined && { userId }),
+            ...(apiUrl !== undefined && { apiUrl }),
+        };
+    }
+    updateAccessTime() {
+        this.session.lastAccessAt = new Date();
+    }
+    async list() {
+        const release = await this.mutex.acquire();
+        try {
+            this.updateAccessTime();
+            return Array.from(this.filters.values()).sort((a, b) => b.updated.getTime() - a.updated.getTime());
+        }
+        finally {
+            release();
+        }
+    }
+    async get(id) {
+        const release = await this.mutex.acquire();
+        try {
+            this.updateAccessTime();
+            return this.filters.get(id) || null;
+        }
+        finally {
+            release();
+        }
+    }
+    async create(filter) {
+        const release = await this.mutex.acquire();
+        try {
+            this.updateAccessTime();
+            const now = new Date();
+            const savedFilter = {
+                ...filter,
+                id: (0, uuid_1.v4)(),
+                created: now,
+                updated: now,
+            };
+            this.filters.set(savedFilter.id, savedFilter);
+            return savedFilter;
+        }
+        finally {
+            release();
+        }
+    }
+    async update(id, filter) {
+        const release = await this.mutex.acquire();
+        try {
+            this.updateAccessTime();
+            const existing = this.filters.get(id);
+            if (!existing) {
+                throw new Error(`Filter with id ${id} not found`);
+            }
+            const updated = {
+                ...existing,
+                ...filter,
+                updated: new Date(),
+            };
+            this.filters.set(id, updated);
+            return updated;
+        }
+        finally {
+            release();
+        }
+    }
+    async delete(id) {
+        const release = await this.mutex.acquire();
+        try {
+            this.updateAccessTime();
+            if (!this.filters.has(id)) {
+                throw new Error(`Filter with id ${id} not found`);
+            }
+            this.filters.delete(id);
+        }
+        finally {
+            release();
+        }
+    }
+    async findByName(name) {
+        const release = await this.mutex.acquire();
+        try {
+            this.updateAccessTime();
+            for (const filter of this.filters.values()) {
+                if (filter.name === name) {
+                    return filter;
+                }
+            }
+            return null;
+        }
+        finally {
+            release();
+        }
+    }
+    async getByProject(projectId) {
+        const release = await this.mutex.acquire();
+        try {
+            this.updateAccessTime();
+            const projectFilters = [];
+            for (const filter of this.filters.values()) {
+                if (filter.projectId === projectId) {
+                    projectFilters.push(filter);
+                }
+            }
+            return projectFilters.sort((a, b) => b.updated.getTime() - a.updated.getTime());
+        }
+        finally {
+            release();
+        }
+    }
+    /**
+     * Session management
+     */
+    getSession() {
+        return { ...this.session };
+    }
+    /**
+     * Get storage statistics
+     */
+    async getStats() {
+        const release = await this.mutex.acquire();
+        try {
+            this.updateAccessTime();
+            return {
+                filterCount: this.filters.size,
+                sessionId: this.session.id,
+                createdAt: this.session.createdAt,
+                lastAccessAt: this.session.lastAccessAt,
+                storageType: 'memory',
+            };
+        }
+        finally {
+            release();
+        }
+    }
+    /**
+     * Clear all filters (for testing)
+     */
+    async clear() {
+        const release = await this.mutex.acquire();
+        try {
+            this.updateAccessTime();
+            this.filters.clear();
+        }
+        finally {
+            release();
+        }
+    }
+    /**
+     * Health check
+     */
+    healthCheck() {
+        return {
+            healthy: true,
+            details: {
+                storageType: 'memory',
+                filterCount: this.filters.size,
+                sessionId: this.session.id,
+            },
+        };
+    }
+    /**
+     * Close storage
+     */
+    async close() {
+        const release = await this.mutex.acquire();
+        try {
+            this.filters.clear();
+        }
+        finally {
+            release();
+        }
+    }
+}
+exports.SimpleFilterStorage = SimpleFilterStorage;
+/**
+ * Storage manager
+ */
+class FilterStorageManager {
+    storageInstances = new Map();
+    cleanupInterval = null;
+    mutex = new async_mutex_1.Mutex();
+    // Clean up sessions after 1 hour
+    CLEANUP_INTERVAL_MS = 60 * 60 * 1000;
+    SESSION_TIMEOUT_MS = 60 * 60 * 1000;
+    constructor() {
+        this.startCleanupTimer();
+    }
+    async getStorage(sessionId, userId, apiUrl) {
+        const release = await this.mutex.acquire();
+        try {
+            let storage = this.storageInstances.get(sessionId);
+            if (!storage) {
+                storage = new SimpleFilterStorage(sessionId, userId, apiUrl);
+                this.storageInstances.set(sessionId, storage);
+            }
+            return storage;
+        }
+        finally {
+            release();
+        }
+    }
+    async getAllStats() {
+        const release = await this.mutex.acquire();
+        try {
+            const stats = [];
+            for (const [sessionId, storage] of this.storageInstances) {
+                const storageStats = await storage.getStats();
+                stats.push({
+                    sessionId,
+                    filterCount: storageStats.filterCount,
+                    createdAt: storageStats.createdAt,
+                    lastAccessAt: storageStats.lastAccessAt,
+                    memoryUsageKb: 0, // Simplified - no detailed memory tracking
+                });
+            }
+            return stats;
+        }
+        finally {
+            release();
+        }
+    }
+    startCleanupTimer() {
+        this.cleanupInterval = setInterval(() => {
+            this.cleanupInactiveSessions().catch(error => {
+                logger_1.logger.error('Failed to cleanup inactive sessions', { error: error instanceof Error ? error.message : String(error) });
+            });
+        }, this.CLEANUP_INTERVAL_MS);
+        // Timer hygiene: don't let this module-level interval keep the process
+        // (or a Jest worker) alive on its own. `unref()` is a no-op in
+        // environments without it (some fake timers), so guard the call.
+        this.cleanupInterval.unref?.();
+    }
+    async cleanupInactiveSessions() {
+        const now = Date.now();
+        const expiredSessions = [];
+        const release = await this.mutex.acquire();
+        try {
+            for (const [sessionId, storage] of this.storageInstances) {
+                const session = storage.getSession();
+                if (now - session.lastAccessAt.getTime() > this.SESSION_TIMEOUT_MS) {
+                    expiredSessions.push(sessionId);
+                }
+            }
+            for (const sessionId of expiredSessions) {
+                const storage = this.storageInstances.get(sessionId);
+                if (storage) {
+                    await storage.close();
+                    this.storageInstances.delete(sessionId);
+                    logger_1.logger.debug('Cleaned up expired storage session', { sessionId });
+                }
+            }
+        }
+        finally {
+            release();
+        }
+    }
+    /**
+     * Cleanup on process exit
+     */
+    async destroy() {
+        if (this.cleanupInterval) {
+            clearInterval(this.cleanupInterval);
+            this.cleanupInterval = null;
+        }
+        const release = await this.mutex.acquire();
+        try {
+            for (const storage of this.storageInstances.values()) {
+                await storage.close();
+            }
+            this.storageInstances.clear();
+        }
+        finally {
+            release();
+        }
+    }
+    /**
+     * Clear all storage instances (for testing)
+     */
+    async clearAll() {
+        const release = await this.mutex.acquire();
+        try {
+            for (const storage of this.storageInstances.values()) {
+                await storage.clear();
+            }
+            this.storageInstances.clear();
+        }
+        finally {
+            release();
+        }
+    }
+    /**
+     * Stop cleanup timer (for testing)
+     */
+    stopCleanupTimer() {
+        if (this.cleanupInterval) {
+            clearInterval(this.cleanupInterval);
+            this.cleanupInterval = null;
+        }
+    }
+}
+exports.FilterStorageManager = FilterStorageManager;
+// Global storage manager instance
+exports.storageManager = new FilterStorageManager();
+// Cleanup on process exit
+process.on('exit', () => {
+    exports.storageManager.destroy().catch(() => {
+        // Ignore errors during shutdown
+    });
+});
+process.on('SIGINT', () => {
+    exports.storageManager.destroy().then(() => {
+        process.exit(0);
+    }).catch(() => {
+        process.exit(1);
+    });
+});
+process.on('SIGTERM', () => {
+    exports.storageManager.destroy().then(() => {
+        process.exit(0);
+    }).catch(() => {
+        process.exit(1);
+    });
+});
+//# sourceMappingURL=SimpleFilterStorage.js.map

package/dist/storage/SimpleFilterStorage.js.map

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

package/dist/storage/filtering/FilterSerializer.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Filter Serializer
+ *
+ * Handles serialization and validation of filter expressions
+ * with proper type safety for the storage layer.
+ */
+import type { FilterExpression } from '../../types/filters';
+export declare class FilterSerializer {
+    /**
+     * Validates if an object is a proper filter expression
+     */
+    private isValidExpression;
+    /**
+     * Validates if an object is a proper filter group
+     */
+    private isValidGroup;
+    /**
+     * Validates if an object is a proper filter condition
+     */
+    private isValidCondition;
+    /**
+     * Serialize a filter expression to JSON string
+     */
+    serialize(expression: FilterExpression): string;
+    /**
+     * Deserialize a JSON string to filter expression
+     */
+    deserialize(data: string): FilterExpression;
+    /**
+     * Validate filter expression structure
+     */
+    validate(expression: unknown): {
+        valid: boolean;
+        errors: string[];
+    };
+    /**
+     * Validate a filter group
+     */
+    private validateGroup;
+    /**
+     * Validate a filter condition
+     */
+    private validateCondition;
+}
+//# sourceMappingURL=FilterSerializer.d.ts.map

package/dist/storage/filtering/FilterSerializer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FilterSerializer.d.ts","sourceRoot":"","sources":["../../../src/storage/filtering/FilterSerializer.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAE5D,qBAAa,gBAAgB;IAC3B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAsBzB;;OAEG;IACH,OAAO,CAAC,YAAY;IA2BpB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAsBxB;;OAEG;IACH,SAAS,CAAC,UAAU,EAAE,gBAAgB,GAAG,MAAM;IAQ/C;;OAEG;IACH,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB;IAc3C;;OAEG;IACH,QAAQ,CAAC,UAAU,EAAE,OAAO,GAAG;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,MAAM,EAAE,CAAA;KAAE;IA0BnE;;OAEG;IACH,OAAO,CAAC,aAAa;IA0BrB;;OAEG;IACH,OAAO,CAAC,iBAAiB;CAyB1B"}

package/dist/storage/filtering/FilterSerializer.js

@@ -0,0 +1,171 @@
+"use strict";
+/**
+ * Filter Serializer
+ *
+ * Handles serialization and validation of filter expressions
+ * with proper type safety for the storage layer.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FilterSerializer = void 0;
+class FilterSerializer {
+    /**
+     * Validates if an object is a proper filter expression
+     */
+    isValidExpression(input) {
+        if (!input || typeof input !== 'object') {
+            return false;
+        }
+        const inputObj = input;
+        // Must have groups array
+        if (!Array.isArray(inputObj.groups)) {
+            return false;
+        }
+        // Validate each group
+        for (const group of inputObj.groups) {
+            if (!this.isValidGroup(group)) {
+                return false;
+            }
+        }
+        return true;
+    }
+    /**
+     * Validates if an object is a proper filter group
+     */
+    isValidGroup(input) {
+        if (!input || typeof input !== 'object') {
+            return false;
+        }
+        const inputObj = input;
+        // Must have conditions array and operator
+        if (!Array.isArray(inputObj.conditions) || typeof inputObj.operator !== 'string') {
+            return false;
+        }
+        // Validate operator
+        if (!['&&', '||'].includes(inputObj.operator)) {
+            return false;
+        }
+        // Validate each condition
+        for (const condition of inputObj.conditions) {
+            if (!this.isValidCondition(condition)) {
+                return false;
+            }
+        }
+        return true;
+    }
+    /**
+     * Validates if an object is a proper filter condition
+     */
+    isValidCondition(input) {
+        if (!input || typeof input !== 'object') {
+            return false;
+        }
+        const inputObj = input;
+        // Must have field, operator, and value
+        if (typeof inputObj.field !== 'string' || typeof inputObj.operator !== 'string') {
+            return false;
+        }
+        // Validate operator
+        const validOperators = ['=', '!=', '>', '>=', '<', '<=', 'like', 'LIKE', 'in', 'not in'];
+        if (!validOperators.includes(inputObj.operator)) {
+            return false;
+        }
+        // Value can be any type (string, number, boolean, array)
+        return true;
+    }
+    /**
+     * Serialize a filter expression to JSON string
+     */
+    serialize(expression) {
+        if (!this.isValidExpression(expression)) {
+            throw new Error('Invalid filter expression');
+        }
+        return JSON.stringify(expression);
+    }
+    /**
+     * Deserialize a JSON string to filter expression
+     */
+    deserialize(data) {
+        try {
+            const parsed = JSON.parse(data);
+            if (!this.isValidExpression(parsed)) {
+                throw new Error('Invalid filter expression structure');
+            }
+            return parsed;
+        }
+        catch (error) {
+            throw new Error(`Failed to deserialize filter expression: ${error instanceof Error ? error.message : 'Unknown error'}`);
+        }
+    }
+    /**
+     * Validate filter expression structure
+     */
+    validate(expression) {
+        const errors = [];
+        if (!expression || typeof expression !== 'object') {
+            errors.push('Expression must be an object');
+            return { valid: false, errors };
+        }
+        const exprObj = expression;
+        if (!Array.isArray(exprObj.groups)) {
+            errors.push('Expression must have a groups array');
+        }
+        else {
+            exprObj.groups.forEach((group, index) => {
+                const groupErrors = this.validateGroup(group, `groups[${index}]`);
+                errors.push(...groupErrors);
+            });
+        }
+        if (exprObj.operator && !['&&', '||'].includes(exprObj.operator)) {
+            errors.push('Invalid operator at root level');
+        }
+        return { valid: errors.length === 0, errors };
+    }
+    /**
+     * Validate a filter group
+     */
+    validateGroup(group, path) {
+        const errors = [];
+        if (!group || typeof group !== 'object') {
+            errors.push(`${path} must be an object`);
+            return errors;
+        }
+        const groupObj = group;
+        if (!Array.isArray(groupObj.conditions)) {
+            errors.push(`${path}.conditions must be an array`);
+        }
+        else {
+            groupObj.conditions.forEach((condition, condIndex) => {
+                const condErrors = this.validateCondition(condition, `${path}.conditions[${condIndex}]`);
+                errors.push(...condErrors);
+            });
+        }
+        if (!['&&', '||'].includes(groupObj.operator)) {
+            errors.push(`${path}.operator must be '&&' or '||'`);
+        }
+        return errors;
+    }
+    /**
+     * Validate a filter condition
+     */
+    validateCondition(condition, path) {
+        const errors = [];
+        if (!condition || typeof condition !== 'object') {
+            errors.push(`${path} must be an object`);
+            return errors;
+        }
+        const conditionObj = condition;
+        if (typeof conditionObj.field !== 'string') {
+            errors.push(`${path}.field must be a string`);
+        }
+        const validOperators = ['=', '!=', '>', '>=', '<', '<=', 'like', 'LIKE', 'in', 'not in'];
+        if (!validOperators.includes(conditionObj.operator)) {
+            errors.push(`${path}.operator must be one of: ${validOperators.join(', ')}`);
+        }
+        if (conditionObj.value === undefined) {
+            errors.push(`${path}.value is required`);
+        }
+        return errors;
+    }
+}
+exports.FilterSerializer = FilterSerializer;
+//# sourceMappingURL=FilterSerializer.js.map

package/dist/storage/filtering/FilterSerializer.js.map

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

package/dist/storage/filtering/FilterValidator.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Filter validation for task filtering operations
+ * Handles validation of filter expressions and task listing parameters
+ */
+import type { components } from '../../types/generated/vikunja-openapi';
+import type { FilterExpression } from '../../types/filters';
+import type { TaskListingArgs, TaskFilterValidationConfig, TaskFilterStorage } from '../../tools/tasks/types/filters';
+/** `models.Task` per the OpenAPI spec — sample task for memory estimation. */
+type Task = components['schemas']['models.Task'];
+/**
+ * Validates filter parameters for task listing operations
+ */
+export declare const FilterValidator: {
+    /**
+     * Validates and processes filter string or filter ID
+     */
+    validateAndParseFilter(args: TaskListingArgs, storage: TaskFilterStorage): Promise<{
+        filterExpression: FilterExpression | null;
+        filterString: string | undefined;
+        validationWarnings: string[];
+    }>;
+    /**
+     * Validates pagination and memory constraints
+     */
+    validateMemoryConstraints(args: TaskListingArgs, requestedPageSize: number): {
+        isValid: boolean;
+        warnings: string[];
+        maxAllowed?: number;
+    };
+    /**
+     * Validates the actual loaded task count against limits
+     */
+    validateLoadedTasks(actualTaskCount: number, sampleTask?: Task): {
+        isValid: boolean;
+        warnings: string[];
+        shouldThrow: boolean;
+        riskLevel?: "low" | "medium" | "high";
+        estimatedMemoryMB?: number;
+    };
+    /**
+     * Validates task listing arguments
+     */
+    validateTaskListingArgs(args: TaskListingArgs): string[];
+    /**
+     * Performs comprehensive validation of task filtering parameters
+     */
+    validateTaskFiltering(args: TaskListingArgs, storage: TaskFilterStorage, _config?: TaskFilterValidationConfig): Promise<{
+        filterExpression: FilterExpression | null;
+        filterString: string | undefined;
+        validationWarnings: string[];
+        memoryValidation: {
+            isValid: boolean;
+            warnings: string[];
+            maxAllowed?: number;
+        };
+    }>;
+};
+export {};
+//# sourceMappingURL=FilterValidator.d.ts.map

package/dist/storage/filtering/FilterValidator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FilterValidator.d.ts","sourceRoot":"","sources":["../../../src/storage/filtering/FilterValidator.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uCAAuC,CAAC;AACxE,OAAO,KAAK,EAAE,gBAAgB,EAAe,MAAM,qBAAqB,CAAC;AACzE,OAAO,KAAK,EAAE,eAAe,EAAE,0BAA0B,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AAMtH,8EAA8E;AAC9E,KAAK,IAAI,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC,aAAa,CAAC,CAAC;AAEjD;;GAEG;AACH,eAAO,MAAM,eAAe;IAC1B;;OAEG;iCAEK,eAAe,WACZ,iBAAiB,GACzB,OAAO,CAAC;QACT,gBAAgB,EAAE,gBAAgB,GAAG,IAAI,CAAC;QAC1C,YAAY,EAAE,MAAM,GAAG,SAAS,CAAC;QACjC,kBAAkB,EAAE,MAAM,EAAE,CAAC;KAC9B,CAAC;IAiDF;;OAEG;oCAEK,eAAe,qBACF,MAAM,GACxB;QACD,OAAO,EAAE,OAAO,CAAC;QACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;QACnB,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB;IA6CD;;OAEG;yCACkC,MAAM,eAAe,IAAI,GAAG;QAC/D,OAAO,EAAE,OAAO,CAAC;QACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;QACnB,WAAW,EAAE,OAAO,CAAC;QACrB,SAAS,CAAC,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;QACtC,iBAAiB,CAAC,EAAE,MAAM,CAAC;KAC5B;IA4CD;;OAEG;kCAC2B,eAAe,GAAG,MAAM,EAAE;IAyCxD;;OAEG;gCAEK,eAAe,WACZ,iBAAiB,YACjB,0BAA0B,GAClC,OAAO,CAAC;QACT,gBAAgB,EAAE,gBAAgB,GAAG,IAAI,CAAC;QAC1C,YAAY,EAAE,MAAM,GAAG,SAAS,CAAC;QACjC,kBAAkB,EAAE,MAAM,EAAE,CAAC;QAC7B,gBAAgB,EAAE;YAChB,OAAO,EAAE,OAAO,CAAC;YACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;YACnB,UAAU,CAAC,EAAE,MAAM,CAAC;SACrB,CAAC;KACH,CAAC;CA4BH,CAAC"}