vikunja-mcp-ng 0.4.0

package/dist/utils/filtering/HybridFilteringStrategy.js

@@ -0,0 +1,55 @@
+"use strict";
+/**
+ * Hybrid filtering strategy
+ *
+ * This strategy attempts server-side filtering first, and falls back to
+ * client-side filtering if server-side fails. This provides the best of
+ * both worlds: efficiency when possible, reliability always.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HybridFilteringStrategy = void 0;
+const ServerSideFilteringStrategy_1 = require("./ServerSideFilteringStrategy");
+const ClientSideFilteringStrategy_1 = require("./ClientSideFilteringStrategy");
+const logger_1 = require("../logger");
+class HybridFilteringStrategy {
+    serverSideStrategy = new ServerSideFilteringStrategy_1.ServerSideFilteringStrategy();
+    clientSideStrategy = new ClientSideFilteringStrategy_1.ClientSideFilteringStrategy();
+    async execute(params) {
+        const { filterString } = params;
+        if (!filterString) {
+            // No filtering needed, use client-side strategy (which just loads tasks)
+            return this.clientSideStrategy.execute(params);
+        }
+        // Attempt server-side filtering first
+        try {
+            logger_1.logger.info('Hybrid filtering: attempting server-side filtering first', {
+                filter: filterString
+            });
+            const result = await this.serverSideStrategy.execute(params);
+            logger_1.logger.info('Hybrid filtering: server-side filtering succeeded', {
+                taskCount: result.tasks.length,
+                filter: filterString
+            });
+            return result;
+        }
+        catch (error) {
+            // Server-side filtering failed, fall back to client-side
+            logger_1.logger.warn('Hybrid filtering: server-side filtering failed, falling back to client-side', {
+                error: error instanceof Error ? error.message : String(error),
+                filter: filterString
+            });
+            const result = await this.clientSideStrategy.execute(params);
+            // Update metadata to reflect that server-side was attempted
+            return {
+                ...result,
+                metadata: {
+                    ...result.metadata,
+                    serverSideFilteringAttempted: true,
+                    filteringNote: 'Server-side filtering failed, client-side filtering applied as fallback'
+                }
+            };
+        }
+    }
+}
+exports.HybridFilteringStrategy = HybridFilteringStrategy;
+//# sourceMappingURL=HybridFilteringStrategy.js.map

package/dist/utils/filtering/HybridFilteringStrategy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"HybridFilteringStrategy.js","sourceRoot":"","sources":["../../../src/utils/filtering/HybridFilteringStrategy.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;AAIH,+EAA4E;AAC5E,+EAA4E;AAC5E,sCAAmC;AAEnC,MAAa,uBAAuB;IAC1B,kBAAkB,GAAG,IAAI,yDAA2B,EAAE,CAAC;IACvD,kBAAkB,GAAG,IAAI,yDAA2B,EAAE,CAAC;IAE/D,KAAK,CAAC,OAAO,CAAC,MAAuB;QACnC,MAAM,EAAE,YAAY,EAAE,GAAG,MAAM,CAAC;QAEhC,IAAI,CAAC,YAAY,EAAE,CAAC;YAClB,yEAAyE;YACzE,OAAO,IAAI,CAAC,kBAAkB,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QACjD,CAAC;QAED,sCAAsC;QACtC,IAAI,CAAC;YACH,eAAM,CAAC,IAAI,CAAC,0DAA0D,EAAE;gBACtE,MAAM,EAAE,YAAY;aACrB,CAAC,CAAC;YAEH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,kBAAkB,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;YAE7D,eAAM,CAAC,IAAI,CAAC,mDAAmD,EAAE;gBAC/D,SAAS,EAAE,MAAM,CAAC,KAAK,CAAC,MAAM;gBAC9B,MAAM,EAAE,YAAY;aACrB,CAAC,CAAC;YAEH,OAAO,MAAM,CAAC;QAEhB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,yDAAyD;YACzD,eAAM,CAAC,IAAI,CAAC,6EAA6E,EAAE;gBACzF,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;gBAC7D,MAAM,EAAE,YAAY;aACrB,CAAC,CAAC;YAEH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,kBAAkB,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;YAE7D,4DAA4D;YAC5D,OAAO;gBACL,GAAG,MAAM;gBACT,QAAQ,EAAE;oBACR,GAAG,MAAM,CAAC,QAAQ;oBAClB,4BAA4B,EAAE,IAAI;oBAClC,aAAa,EAAE,yEAAyE;iBACzF;aACF,CAAC;QACJ,CAAC;IACH,CAAC;CACF;AA/CD,0DA+CC"}

package/dist/utils/filtering/RestCrossProjectFilteringStrategy.d.ts

@@ -0,0 +1,42 @@
+/**
+ * REST cross-project filtering strategy
+ *
+ * Vikunja documents a single-call `GET /tasks` endpoint for listing tasks
+ * across every project the user can access, with `page`, `per_page`, `s`,
+ * `sort_by`, `order_by`, `filter`, `filter_timezone`, `filter_include_nulls`
+ * and `expand` query params (see docs/vikunja-openapi.json). Neither
+ * the legacy client's `getAllTasks` (which calls the non-existent `GET
+ * /tasks/all`, confirmed to 400 "Invalid model provided" on real servers —
+ * see `ClientSideFilteringStrategy`) nor any other code path in this
+ * project ever called the real endpoint.
+ *
+ * This strategy calls `GET /tasks` directly via `vikunjaRestRequest` and is
+ * the PRIMARY strategy for cross-project ("all projects" or no `projectId`)
+ * listing — one call instead of an N+1 per-project aggregation. If the
+ * direct call fails for any reason (older server without the endpoint, the
+ * circuit breaker open, a transient network error surviving retries, etc.)
+ * it falls back to the existing per-project aggregation
+ * (`ClientSideFilteringStrategy`, which itself applies `filterExpression`
+ * client-side), kept as the documented fallback per
+ * docs/ENDPOINT-PLAYBOOK.md's hybrid pattern — the fallback matters if some
+ * server versions reject `GET /tasks`.
+ *
+ * Single-project listing is untouched by this strategy: it is only selected
+ * by `FilteringContext` when the listing is cross-project.
+ */
+import type { TaskFilteringStrategy } from './TaskFilteringStrategy';
+import type { FilteringArgs, FilteringParams, FilteringResult, TaskListApiParams } from './types';
+/**
+ * Builds the `GET /tasks` query string from the shared API params plus the
+ * task-list-only extras (`order_by`, `filter_timezone`,
+ * `filter_include_nulls`, `expand`) — single-project listing
+ * (`ClientSideFilteringStrategy`/`ServerSideFilteringStrategy`) does not
+ * honor these, since they were never part of the legacy client's `GetTasksParams`
+ * shape that the pre-migration single-project call sites used (see
+ * docs/ENDPOINT-PLAYBOOK.md's direct-REST rule).
+ */
+export declare function buildTasksListQuery(apiParams: TaskListApiParams, filterString: string | undefined, args: FilteringArgs): string;
+export declare class RestCrossProjectFilteringStrategy implements TaskFilteringStrategy {
+    execute(params: FilteringParams): Promise<FilteringResult>;
+}
+//# sourceMappingURL=RestCrossProjectFilteringStrategy.d.ts.map

package/dist/utils/filtering/RestCrossProjectFilteringStrategy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RestCrossProjectFilteringStrategy.d.ts","sourceRoot":"","sources":["../../../src/utils/filtering/RestCrossProjectFilteringStrategy.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AACrE,OAAO,KAAK,EAAE,aAAa,EAAE,eAAe,EAAE,eAAe,EAAE,iBAAiB,EAAe,MAAM,SAAS,CAAC;AAM/G;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,iBAAiB,EAC5B,YAAY,EAAE,MAAM,GAAG,SAAS,EAChC,IAAI,EAAE,aAAa,GAClB,MAAM,CAkBR;AAED,qBAAa,iCAAkC,YAAW,qBAAqB;IACvE,OAAO,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC;CA6DjE"}

package/dist/utils/filtering/RestCrossProjectFilteringStrategy.js

@@ -0,0 +1,120 @@
+"use strict";
+/**
+ * REST cross-project filtering strategy
+ *
+ * Vikunja documents a single-call `GET /tasks` endpoint for listing tasks
+ * across every project the user can access, with `page`, `per_page`, `s`,
+ * `sort_by`, `order_by`, `filter`, `filter_timezone`, `filter_include_nulls`
+ * and `expand` query params (see docs/vikunja-openapi.json). Neither
+ * the legacy client's `getAllTasks` (which calls the non-existent `GET
+ * /tasks/all`, confirmed to 400 "Invalid model provided" on real servers —
+ * see `ClientSideFilteringStrategy`) nor any other code path in this
+ * project ever called the real endpoint.
+ *
+ * This strategy calls `GET /tasks` directly via `vikunjaRestRequest` and is
+ * the PRIMARY strategy for cross-project ("all projects" or no `projectId`)
+ * listing — one call instead of an N+1 per-project aggregation. If the
+ * direct call fails for any reason (older server without the endpoint, the
+ * circuit breaker open, a transient network error surviving retries, etc.)
+ * it falls back to the existing per-project aggregation
+ * (`ClientSideFilteringStrategy`, which itself applies `filterExpression`
+ * client-side), kept as the documented fallback per
+ * docs/ENDPOINT-PLAYBOOK.md's hybrid pattern — the fallback matters if some
+ * server versions reject `GET /tasks`.
+ *
+ * Single-project listing is untouched by this strategy: it is only selected
+ * by `FilteringContext` when the listing is cross-project.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RestCrossProjectFilteringStrategy = void 0;
+exports.buildTasksListQuery = buildTasksListQuery;
+const ClientSideFilteringStrategy_1 = require("./ClientSideFilteringStrategy");
+const vikunja_rest_1 = require("../vikunja-rest");
+const types_1 = require("../../types");
+const logger_1 = require("../logger");
+/**
+ * Builds the `GET /tasks` query string from the shared API params plus the
+ * task-list-only extras (`order_by`, `filter_timezone`,
+ * `filter_include_nulls`, `expand`) — single-project listing
+ * (`ClientSideFilteringStrategy`/`ServerSideFilteringStrategy`) does not
+ * honor these, since they were never part of the legacy client's `GetTasksParams`
+ * shape that the pre-migration single-project call sites used (see
+ * docs/ENDPOINT-PLAYBOOK.md's direct-REST rule).
+ */
+function buildTasksListQuery(apiParams, filterString, args) {
+    const query = new URLSearchParams();
+    if (apiParams.page !== undefined)
+        query.set('page', String(apiParams.page));
+    if (apiParams.per_page !== undefined)
+        query.set('per_page', String(apiParams.per_page));
+    if (apiParams.s !== undefined)
+        query.set('s', String(apiParams.s));
+    if (apiParams.sort_by !== undefined)
+        query.set('sort_by', String(apiParams.sort_by));
+    if (filterString)
+        query.set('filter', filterString);
+    if (args.orderBy)
+        query.set('order_by', args.orderBy);
+    if (args.filterTimezone)
+        query.set('filter_timezone', args.filterTimezone);
+    if (args.filterIncludeNulls !== undefined) {
+        query.set('filter_include_nulls', args.filterIncludeNulls ? 'true' : 'false');
+    }
+    if (args.expand && args.expand.length > 0) {
+        for (const value of args.expand) {
+            query.append('expand', value);
+        }
+    }
+    return query.toString();
+}
+class RestCrossProjectFilteringStrategy {
+    async execute(params) {
+        const { authManager, filterString, args, params: apiParams } = params;
+        if (!authManager) {
+            // Programmer error: FilteringContext must only select this strategy
+            // when an authManager was threaded through from the tool handler.
+            throw new types_1.MCPError(types_1.ErrorCode.INTERNAL_ERROR, 'RestCrossProjectFilteringStrategy requires an authManager');
+        }
+        const query = buildTasksListQuery(apiParams, filterString, args);
+        const path = `/tasks${query ? `?${query}` : ''}`;
+        try {
+            logger_1.logger.info('Attempting cross-project task listing via direct REST GET /tasks', {
+                filter: filterString,
+                path,
+            });
+            const tasks = await (0, vikunja_rest_1.vikunjaRestRequest)(authManager, 'GET', path);
+            const safeTasks = Array.isArray(tasks) ? tasks : [];
+            logger_1.logger.info('Direct REST GET /tasks succeeded for cross-project listing', {
+                taskCount: safeTasks.length,
+            });
+            return {
+                tasks: safeTasks,
+                metadata: {
+                    serverSideFilteringUsed: Boolean(filterString),
+                    serverSideFilteringAttempted: true,
+                    clientSideFiltering: false,
+                    filteringNote: filterString
+                        ? 'Server-side filtering used via direct REST GET /tasks'
+                        : 'Cross-project listing via direct REST GET /tasks (single call, no per-project aggregation)',
+                },
+            };
+        }
+        catch (error) {
+            logger_1.logger.warn('Direct REST GET /tasks failed for cross-project listing, falling back to per-project aggregation', {
+                error: error instanceof Error ? error.message : String(error),
+                filter: filterString,
+            });
+            const fallbackResult = await new ClientSideFilteringStrategy_1.ClientSideFilteringStrategy().execute(params);
+            return {
+                ...fallbackResult,
+                metadata: {
+                    ...fallbackResult.metadata,
+                    serverSideFilteringAttempted: true,
+                    filteringNote: 'Direct REST GET /tasks failed; used per-project aggregation fallback',
+                },
+            };
+        }
+    }
+}
+exports.RestCrossProjectFilteringStrategy = RestCrossProjectFilteringStrategy;
+//# sourceMappingURL=RestCrossProjectFilteringStrategy.js.map

package/dist/utils/filtering/RestCrossProjectFilteringStrategy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RestCrossProjectFilteringStrategy.js","sourceRoot":"","sources":["../../../src/utils/filtering/RestCrossProjectFilteringStrategy.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;;;AAkBH,kDAsBC;AApCD,+EAA4E;AAC5E,kDAAqD;AACrD,uCAAkD;AAClD,sCAAmC;AAEnC;;;;;;;;GAQG;AACH,SAAgB,mBAAmB,CACjC,SAA4B,EAC5B,YAAgC,EAChC,IAAmB;IAEnB,MAAM,KAAK,GAAG,IAAI,eAAe,EAAE,CAAC;IACpC,IAAI,SAAS,CAAC,IAAI,KAAK,SAAS;QAAE,KAAK,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC;IAC5E,IAAI,SAAS,CAAC,QAAQ,KAAK,SAAS;QAAE,KAAK,CAAC,GAAG,CAAC,UAAU,EAAE,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC;IACxF,IAAI,SAAS,CAAC,CAAC,KAAK,SAAS;QAAE,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;IACnE,IAAI,SAAS,CAAC,OAAO,KAAK,SAAS;QAAE,KAAK,CAAC,GAAG,CAAC,SAAS,EAAE,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC;IACrF,IAAI,YAAY;QAAE,KAAK,CAAC,GAAG,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC;IACpD,IAAI,IAAI,CAAC,OAAO;QAAE,KAAK,CAAC,GAAG,CAAC,UAAU,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;IACtD,IAAI,IAAI,CAAC,cAAc;QAAE,KAAK,CAAC,GAAG,CAAC,iBAAiB,EAAE,IAAI,CAAC,cAAc,CAAC,CAAC;IAC3E,IAAI,IAAI,CAAC,kBAAkB,KAAK,SAAS,EAAE,CAAC;QAC1C,KAAK,CAAC,GAAG,CAAC,sBAAsB,EAAE,IAAI,CAAC,kBAAkB,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;IAChF,CAAC;IACD,IAAI,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC1C,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChC,KAAK,CAAC,MAAM,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;QAChC,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC,QAAQ,EAAE,CAAC;AAC1B,CAAC;AAED,MAAa,iCAAiC;IAC5C,KAAK,CAAC,OAAO,CAAC,MAAuB;QACnC,MAAM,EAAE,WAAW,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,CAAC;QAEtE,IAAI,CAAC,WAAW,EAAE,CAAC;YACjB,oEAAoE;YACpE,kEAAkE;YAClE,MAAM,IAAI,gBAAQ,CAChB,iBAAS,CAAC,cAAc,EACxB,2DAA2D,CAC5D,CAAC;QACJ,CAAC;QAED,MAAM,KAAK,GAAG,mBAAmB,CAAC,SAAS,EAAE,YAAY,EAAE,IAAI,CAAC,CAAC;QACjE,MAAM,IAAI,GAAG,SAAS,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;QAEjD,IAAI,CAAC;YACH,eAAM,CAAC,IAAI,CAAC,kEAAkE,EAAE;gBAC9E,MAAM,EAAE,YAAY;gBACpB,IAAI;aACL,CAAC,CAAC;YAEH,MAAM,KAAK,GAAG,MAAM,IAAA,iCAAkB,EAAgB,WAAW,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC;YAChF,MAAM,SAAS,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;YAEpD,eAAM,CAAC,IAAI,CAAC,4DAA4D,EAAE;gBACxE,SAAS,EAAE,SAAS,CAAC,MAAM;aAC5B,CAAC,CAAC;YAEH,OAAO;gBACL,KAAK,EAAE,SAAS;gBAChB,QAAQ,EAAE;oBACR,uBAAuB,EAAE,OAAO,CAAC,YAAY,CAAC;oBAC9C,4BAA4B,EAAE,IAAI;oBAClC,mBAAmB,EAAE,KAAK;oBAC1B,aAAa,EAAE,YAAY;wBACzB,CAAC,CAAC,uDAAuD;wBACzD,CAAC,CAAC,4FAA4F;iBACjG;aACF,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,eAAM,CAAC,IAAI,CACT,kGAAkG,EAClG;gBACE,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;gBAC7D,MAAM,EAAE,YAAY;aACrB,CACF,CAAC;YAEF,MAAM,cAAc,GAAG,MAAM,IAAI,yDAA2B,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;YAE/E,OAAO;gBACL,GAAG,cAAc;gBACjB,QAAQ,EAAE;oBACR,GAAG,cAAc,CAAC,QAAQ;oBAC1B,4BAA4B,EAAE,IAAI;oBAClC,aAAa,EACX,sEAAsE;iBACzE;aACF,CAAC;QACJ,CAAC;IACH,CAAC;CACF;AA9DD,8EA8DC"}

package/dist/utils/filtering/ServerSideFilteringStrategy.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Server-side filtering strategy
+ *
+ * This strategy attempts to use Vikunja's server-side filtering capabilities
+ * by passing filter parameters directly to the API. This is the most efficient
+ * approach when the server supports advanced filtering.
+ */
+import type { TaskFilteringStrategy } from './TaskFilteringStrategy';
+import type { FilteringParams, FilteringResult } from './types';
+export declare class ServerSideFilteringStrategy implements TaskFilteringStrategy {
+    execute(params: FilteringParams): Promise<FilteringResult>;
+}
+//# sourceMappingURL=ServerSideFilteringStrategy.d.ts.map

package/dist/utils/filtering/ServerSideFilteringStrategy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ServerSideFilteringStrategy.d.ts","sourceRoot":"","sources":["../../../src/utils/filtering/ServerSideFilteringStrategy.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AACrE,OAAO,KAAK,EAAE,eAAe,EAAE,eAAe,EAAe,MAAM,SAAS,CAAC;AAO7E,qBAAa,2BAA4B,YAAW,qBAAqB;IACjE,OAAO,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC;CAkFjE"}

package/dist/utils/filtering/ServerSideFilteringStrategy.js

@@ -0,0 +1,88 @@
+"use strict";
+/**
+ * Server-side filtering strategy
+ *
+ * This strategy attempts to use Vikunja's server-side filtering capabilities
+ * by passing filter parameters directly to the API. This is the most efficient
+ * approach when the server supports advanced filtering.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ServerSideFilteringStrategy = void 0;
+const vikunja_rest_1 = require("../vikunja-rest");
+const validation_1 = require("../../tools/tasks/validation");
+const logger_1 = require("../logger");
+const types_1 = require("../../types");
+const RestCrossProjectFilteringStrategy_1 = require("./RestCrossProjectFilteringStrategy");
+class ServerSideFilteringStrategy {
+    async execute(params) {
+        const { args, filterString, params: apiParams, authManager } = params;
+        if (!filterString) {
+            throw new types_1.MCPError(types_1.ErrorCode.VALIDATION_ERROR, 'Server-side filtering requires a filter string');
+        }
+        if (!authManager) {
+            // Programmer error: FilteringContext must only select this strategy
+            // (via HybridFilteringStrategy) when an authManager was threaded
+            // through from the tool handler.
+            throw new types_1.MCPError(types_1.ErrorCode.INTERNAL_ERROR, 'ServerSideFilteringStrategy requires an authManager');
+        }
+        const query = (0, RestCrossProjectFilteringStrategy_1.buildTasksListQuery)(apiParams, filterString, {});
+        const singleProject = args.projectId !== undefined && !args.allProjects;
+        logger_1.logger.info('Attempting server-side filtering', {
+            filter: filterString,
+            endpoint: singleProject ? 'getProjectTasks' : 'getAllTasks'
+        });
+        let tasks;
+        try {
+            if (singleProject && args.projectId !== undefined) {
+                // Validate project ID
+                (0, validation_1.validateId)(args.projectId, 'projectId');
+                // Get tasks for specific project with server-side filter. Calls the
+                // same `GET /projects/{id}/tasks` path the legacy client's
+                // `getProjectTasks` used pre-migration — a literal call-site
+                // migration, not an endpoint redesign (see
+                // ClientSideFilteringStrategy's `fetchProjectTasks` doc comment for
+                // why the spec's `get?: never` at this path doesn't block reusing it
+                // here).
+                const path = `/projects/${args.projectId}/tasks${query ? `?${query}` : ''}`;
+                tasks = await (0, vikunja_rest_1.vikunjaRestRequest)(authManager, 'GET', path);
+            }
+            else {
+                // Get all tasks across all projects with server-side filter. Calls
+                // the same (non-existent, confirmed 400 "Invalid model provided" on
+                // real servers) `GET /tasks/all` path the legacy client's `getAllTasks`
+                // used pre-migration. This branch is unreachable in production —
+                // `FilteringContext` always routes cross-project listings through
+                // `RestCrossProjectFilteringStrategy` (real `GET /tasks`) before
+                // this strategy is ever selected — but the literal call-site
+                // migration is preserved rather than silently redirected to a
+                // different, working endpoint, per this item's byte-compatible
+                // refactor-not-redesign scope.
+                const path = `/tasks/all${query ? `?${query}` : ''}`;
+                tasks = await (0, vikunja_rest_1.vikunjaRestRequest)(authManager, 'GET', path);
+            }
+            logger_1.logger.info('Server-side filtering completed successfully', {
+                taskCount: tasks?.length || 0,
+                filter: filterString
+            });
+            return {
+                tasks: tasks || [],
+                metadata: {
+                    serverSideFilteringUsed: true,
+                    serverSideFilteringAttempted: true,
+                    clientSideFiltering: false,
+                    filteringNote: 'Server-side filtering used (modern Vikunja)'
+                }
+            };
+        }
+        catch (error) {
+            logger_1.logger.error('Server-side filtering failed', {
+                error: error instanceof Error ? error.message : String(error),
+                filter: filterString
+            });
+            // Re-throw the error to be handled by the calling code
+            throw error;
+        }
+    }
+}
+exports.ServerSideFilteringStrategy = ServerSideFilteringStrategy;
+//# sourceMappingURL=ServerSideFilteringStrategy.js.map

package/dist/utils/filtering/ServerSideFilteringStrategy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ServerSideFilteringStrategy.js","sourceRoot":"","sources":["../../../src/utils/filtering/ServerSideFilteringStrategy.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;AAIH,kDAAqD;AACrD,6DAA0D;AAC1D,sCAAmC;AACnC,uCAAkD;AAClD,2FAA0E;AAE1E,MAAa,2BAA2B;IACtC,KAAK,CAAC,OAAO,CAAC,MAAuB;QACnC,MAAM,EAAE,IAAI,EAAE,YAAY,EAAE,MAAM,EAAE,SAAS,EAAE,WAAW,EAAE,GAAG,MAAM,CAAC;QAEtE,IAAI,CAAC,YAAY,EAAE,CAAC;YAClB,MAAM,IAAI,gBAAQ,CAChB,iBAAS,CAAC,gBAAgB,EAC1B,gDAAgD,CACjD,CAAC;QACJ,CAAC;QAED,IAAI,CAAC,WAAW,EAAE,CAAC;YACjB,oEAAoE;YACpE,iEAAiE;YACjE,iCAAiC;YACjC,MAAM,IAAI,gBAAQ,CAChB,iBAAS,CAAC,cAAc,EACxB,qDAAqD,CACtD,CAAC;QACJ,CAAC;QAED,MAAM,KAAK,GAAG,IAAA,uDAAmB,EAAC,SAAS,EAAE,YAAY,EAAE,EAAE,CAAC,CAAC;QAC/D,MAAM,aAAa,GAAG,IAAI,CAAC,SAAS,KAAK,SAAS,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC;QAExE,eAAM,CAAC,IAAI,CAAC,kCAAkC,EAAE;YAC9C,MAAM,EAAE,YAAY;YACpB,QAAQ,EAAE,aAAa,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC,aAAa;SAC5D,CAAC,CAAC;QAEH,IAAI,KAAK,CAAC;QACV,IAAI,CAAC;YACH,IAAI,aAAa,IAAI,IAAI,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;gBAClD,sBAAsB;gBACtB,IAAA,uBAAU,EAAC,IAAI,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;gBACxC,oEAAoE;gBACpE,2DAA2D;gBAC3D,6DAA6D;gBAC7D,2CAA2C;gBAC3C,oEAAoE;gBACpE,qEAAqE;gBACrE,SAAS;gBACT,MAAM,IAAI,GAAG,aAAa,IAAI,CAAC,SAAS,SAAS,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;gBAC5E,KAAK,GAAG,MAAM,IAAA,iCAAkB,EAAgB,WAAW,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC;YAC5E,CAAC;iBAAM,CAAC;gBACN,mEAAmE;gBACnE,oEAAoE;gBACpE,wEAAwE;gBACxE,iEAAiE;gBACjE,kEAAkE;gBAClE,iEAAiE;gBACjE,6DAA6D;gBAC7D,8DAA8D;gBAC9D,+DAA+D;gBAC/D,+BAA+B;gBAC/B,MAAM,IAAI,GAAG,aAAa,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;gBACrD,KAAK,GAAG,MAAM,IAAA,iCAAkB,EAAgB,WAAW,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC;YAC5E,CAAC;YAED,eAAM,CAAC,IAAI,CAAC,8CAA8C,EAAE;gBAC1D,SAAS,EAAE,KAAK,EAAE,MAAM,IAAI,CAAC;gBAC7B,MAAM,EAAE,YAAY;aACrB,CAAC,CAAC;YAEH,OAAO;gBACL,KAAK,EAAE,KAAK,IAAI,EAAE;gBAClB,QAAQ,EAAE;oBACR,uBAAuB,EAAE,IAAI;oBAC7B,4BAA4B,EAAE,IAAI;oBAClC,mBAAmB,EAAE,KAAK;oBAC1B,aAAa,EAAE,6CAA6C;iBAC7D;aACF,CAAC;QAEJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,eAAM,CAAC,KAAK,CAAC,8BAA8B,EAAE;gBAC3C,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;gBAC7D,MAAM,EAAE,YAAY;aACrB,CAAC,CAAC;YAEH,uDAAuD;YACvD,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;CACF;AAnFD,kEAmFC"}

package/dist/utils/filtering/TaskFilteringStrategy.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Base interface for task filtering strategies
+ *
+ * This interface defines the contract that all filtering strategies must implement.
+ * It follows the Strategy pattern to encapsulate different filtering approaches
+ * while maintaining a consistent interface.
+ */
+import type { FilteringParams, FilteringResult } from './types';
+export interface TaskFilteringStrategy {
+    /**
+     * Execute the filtering strategy
+     *
+     * @param params - The filtering parameters including args, expressions, and API params
+     * @returns Promise resolving to the filtering result with tasks and metadata
+     * @throws MCPError for validation or API errors
+     */
+    execute(params: FilteringParams): Promise<FilteringResult>;
+}
+//# sourceMappingURL=TaskFilteringStrategy.d.ts.map

package/dist/utils/filtering/TaskFilteringStrategy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TaskFilteringStrategy.d.ts","sourceRoot":"","sources":["../../../src/utils/filtering/TaskFilteringStrategy.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAEhE,MAAM,WAAW,qBAAqB;IACpC;;;;;;OAMG;IACH,OAAO,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;CAC5D"}

package/dist/utils/filtering/TaskFilteringStrategy.js

@@ -0,0 +1,10 @@
+"use strict";
+/**
+ * Base interface for task filtering strategies
+ *
+ * This interface defines the contract that all filtering strategies must implement.
+ * It follows the Strategy pattern to encapsulate different filtering approaches
+ * while maintaining a consistent interface.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=TaskFilteringStrategy.js.map

package/dist/utils/filtering/TaskFilteringStrategy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TaskFilteringStrategy.js","sourceRoot":"","sources":["../../../src/utils/filtering/TaskFilteringStrategy.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG"}

package/dist/utils/filtering/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Filtering strategy pattern exports
+ *
+ * This module provides a clean interface for the filtering strategy pattern
+ * implementation, allowing easy import of all necessary components.
+ */
+export type { TaskFilteringStrategy } from './TaskFilteringStrategy';
+export { ServerSideFilteringStrategy } from './ServerSideFilteringStrategy';
+export { ClientSideFilteringStrategy } from './ClientSideFilteringStrategy';
+export { HybridFilteringStrategy } from './HybridFilteringStrategy';
+export { RestCrossProjectFilteringStrategy } from './RestCrossProjectFilteringStrategy';
+export { FilteringContext } from './FilteringContext';
+export type { FilteringArgs, FilteringParams, FilteringMetadata, FilteringResult, StrategyConfig } from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/utils/filtering/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/filtering/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,YAAY,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAGrE,OAAO,EAAE,2BAA2B,EAAE,MAAM,+BAA+B,CAAC;AAC5E,OAAO,EAAE,2BAA2B,EAAE,MAAM,+BAA+B,CAAC;AAC5E,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AACpE,OAAO,EAAE,iCAAiC,EAAE,MAAM,qCAAqC,CAAC;AAGxF,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAGtD,YAAY,EACV,aAAa,EACb,eAAe,EACf,iBAAiB,EACjB,eAAe,EACf,cAAc,EACf,MAAM,SAAS,CAAC"}

package/dist/utils/filtering/index.js

@@ -0,0 +1,22 @@
+"use strict";
+/**
+ * Filtering strategy pattern exports
+ *
+ * This module provides a clean interface for the filtering strategy pattern
+ * implementation, allowing easy import of all necessary components.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FilteringContext = exports.RestCrossProjectFilteringStrategy = exports.HybridFilteringStrategy = exports.ClientSideFilteringStrategy = exports.ServerSideFilteringStrategy = void 0;
+// Strategy implementations
+var ServerSideFilteringStrategy_1 = require("./ServerSideFilteringStrategy");
+Object.defineProperty(exports, "ServerSideFilteringStrategy", { enumerable: true, get: function () { return ServerSideFilteringStrategy_1.ServerSideFilteringStrategy; } });
+var ClientSideFilteringStrategy_1 = require("./ClientSideFilteringStrategy");
+Object.defineProperty(exports, "ClientSideFilteringStrategy", { enumerable: true, get: function () { return ClientSideFilteringStrategy_1.ClientSideFilteringStrategy; } });
+var HybridFilteringStrategy_1 = require("./HybridFilteringStrategy");
+Object.defineProperty(exports, "HybridFilteringStrategy", { enumerable: true, get: function () { return HybridFilteringStrategy_1.HybridFilteringStrategy; } });
+var RestCrossProjectFilteringStrategy_1 = require("./RestCrossProjectFilteringStrategy");
+Object.defineProperty(exports, "RestCrossProjectFilteringStrategy", { enumerable: true, get: function () { return RestCrossProjectFilteringStrategy_1.RestCrossProjectFilteringStrategy; } });
+// Context for strategy selection
+var FilteringContext_1 = require("./FilteringContext");
+Object.defineProperty(exports, "FilteringContext", { enumerable: true, get: function () { return FilteringContext_1.FilteringContext; } });
+//# sourceMappingURL=index.js.map

package/dist/utils/filtering/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/utils/filtering/index.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAKH,2BAA2B;AAC3B,6EAA4E;AAAnE,0IAAA,2BAA2B,OAAA;AACpC,6EAA4E;AAAnE,0IAAA,2BAA2B,OAAA;AACpC,qEAAoE;AAA3D,kIAAA,uBAAuB,OAAA;AAChC,yFAAwF;AAA/E,sJAAA,iCAAiC,OAAA;AAE1C,iCAAiC;AACjC,uDAAsD;AAA7C,oHAAA,gBAAgB,OAAA"}

package/dist/utils/filtering/types.d.ts

@@ -0,0 +1,108 @@
+/**
+ * Type definitions for the filtering strategy pattern
+ */
+import type { FilterExpression } from '../../types/filters';
+import type { AuthManager } from '../../auth/AuthManager';
+import type { components } from '../../types/generated/vikunja-openapi';
+/** `models.Task` per the OpenAPI spec. */
+export type VikunjaTask = components['schemas']['models.Task'];
+/**
+ * Query params shared by the task-listing endpoints (page/per_page/s/sort_by
+ * plus the server-side `filter` string). Mirrors the legacy client's
+ * `GetTasksParams` shape without depending on the (EOL) legacy client package.
+ */
+export interface TaskListApiParams {
+    page?: number;
+    per_page?: number;
+    s?: string;
+    sort_by?: string;
+    filter?: string;
+}
+/**
+ * Arguments for filtering operations
+ */
+export interface FilteringArgs {
+    projectId?: number;
+    page?: number;
+    perPage?: number;
+    search?: string;
+    sort?: string;
+    filter?: string;
+    filterId?: string;
+    allProjects?: boolean;
+    done?: boolean;
+    /**
+     * The documented GET /tasks `order_by` param ('asc' | 'desc', paired with
+     * `sort_by`). Only honored by `RestCrossProjectFilteringStrategy` —
+     * single-project listing (`ClientSideFilteringStrategy`/
+     * `ServerSideFilteringStrategy`) never supported this param even
+     * pre-migration, so it stays REST-cross-project-only to preserve exact
+     * behavior.
+     */
+    orderBy?: 'asc' | 'desc';
+    /** GET /tasks `filter_timezone` param. Same REST-only scope as `orderBy`. */
+    filterTimezone?: string;
+    /** GET /tasks `filter_include_nulls` param. Same REST-only scope as `orderBy`. */
+    filterIncludeNulls?: boolean;
+    /** GET /tasks `expand` param (repeatable). Same REST-only scope as `orderBy`. */
+    expand?: string[];
+}
+/**
+ * Parameters passed to filtering strategies
+ */
+export interface FilteringParams {
+    args: FilteringArgs;
+    filterExpression: FilterExpression | null;
+    filterString: string | undefined;
+    params: TaskListApiParams;
+    /**
+     * Active auth manager, required by strategies that call the direct-REST
+     * helper (`RestCrossProjectFilteringStrategy`). Kept as its own field
+     * rather than folded into `args` so that logging/debugging code that logs
+     * `args` wholesale never accidentally serializes session credentials.
+     */
+    authManager?: AuthManager;
+}
+/**
+ * Metadata about the filtering operation performed
+ */
+export interface FilteringMetadata {
+    serverSideFilteringUsed: boolean;
+    serverSideFilteringAttempted: boolean;
+    clientSideFiltering: boolean;
+    filteringNote: string;
+}
+/**
+ * Result of a filtering operation
+ */
+export interface FilteringResult {
+    tasks: VikunjaTask[];
+    metadata: FilteringMetadata;
+}
+/**
+ * Configuration for strategy selection
+ */
+export interface StrategyConfig {
+    enableServerSide: boolean;
+    /**
+     * True when the listing spans every accessible project (no `projectId`,
+     * or `allProjects: true`). Cross-project listing always routes through
+     * `RestCrossProjectFilteringStrategy` (direct REST GET /tasks, falling
+     * back to per-project aggregation), regardless of `enableServerSide` —
+     * the documented single-call endpoint is strictly better than the N+1
+     * aggregation whether or not a filter is present.
+     */
+    crossProject?: boolean;
+}
+/**
+ * Task filtering strategy interface
+ */
+export interface TaskFilteringStrategy {
+    /**
+     * Execute the filtering strategy
+     * @param params - Filtering parameters
+     * @returns Promise resolving to filtering result
+     */
+    execute(params: FilteringParams): Promise<FilteringResult>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/utils/filtering/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/utils/filtering/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uCAAuC,CAAC;AAExE,0CAA0C;AAC1C,MAAM,MAAM,WAAW,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC,aAAa,CAAC,CAAC;AAE/D;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IAChC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf;;;;;;;OAOG;IACH,OAAO,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;IACzB,6EAA6E;IAC7E,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,kFAAkF;IAClF,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,iFAAiF;IACjF,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,aAAa,CAAC;IACpB,gBAAgB,EAAE,gBAAgB,GAAG,IAAI,CAAC;IAC1C,YAAY,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,MAAM,EAAE,iBAAiB,CAAC;IAC1B;;;;;OAKG;IACH,WAAW,CAAC,EAAE,WAAW,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,uBAAuB,EAAE,OAAO,CAAC;IACjC,4BAA4B,EAAE,OAAO,CAAC;IACtC,mBAAmB,EAAE,OAAO,CAAC;IAC7B,aAAa,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,WAAW,EAAE,CAAC;IACrB,QAAQ,EAAE,iBAAiB,CAAC;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,gBAAgB,EAAE,OAAO,CAAC;IAC1B;;;;;;;OAOG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC;;;;OAIG;IACH,OAAO,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;CAC5D"}

package/dist/utils/filtering/types.js

@@ -0,0 +1,6 @@
+"use strict";
+/**
+ * Type definitions for the filtering strategy pattern
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/utils/filtering/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/utils/filtering/types.ts"],"names":[],"mappings":";AAAA;;GAEG"}

package/dist/utils/filters.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Zod-based filter validation and parsing system
+ * Replaces the complex custom tokenizer/parser with secure Zod schemas
+ */
+import type { FilterCondition, FilterExpression, FilterField, FilterGroup, FilterOperator, FilterValidationResult, FilterValidationConfig, LogicalOperator, ParseResult } from '../types/filters';
+/**
+ * Security validation functions
+ */
+export declare const SecurityValidator: {
+    /**
+     * Validates input string contains only allowed characters
+     */
+    validateAllowedChars(input: string): boolean;
+    /**
+     * Validates filter string length
+     */
+    validateLength(input: string): {
+        isValid: boolean;
+        error?: string;
+    };
+    /**
+     * Validates individual value length and safety
+     */
+    validateValue(value: string): {
+        isValid: boolean;
+        error?: string;
+    };
+};
+/**
+ * Main filter string parsing function
+ * Replaces the complex tokenizer/parser system with Zod validation
+ */
+export declare function parseFilterString(filterStr: string): ParseResult;
+/**
+ * Validate a filter condition using enhanced validation
+ */
+export declare function validateCondition(condition: FilterCondition): string[];
+/**
+ * Validate filter expression using Zod
+ */
+export declare function validateFilterExpression(expression: FilterExpression, config?: FilterValidationConfig): FilterValidationResult;
+/**
+ * Convert condition to string representation
+ */
+export declare function conditionToString(condition: FilterCondition): string;
+/**
+ * Convert group to string representation
+ */
+export declare function groupToString(group: FilterGroup): string;
+/**
+ * Convert expression to string representation
+ */
+export declare function expressionToString(expression: FilterExpression): string;
+/**
+ * Filter builder class for fluent construction
+ */
+export declare class FilterBuilder {
+    private expression;
+    private currentGroup;
+    constructor();
+    where(field: FilterField, operator: FilterOperator, value: unknown): FilterBuilder;
+    and(): FilterBuilder;
+    or(): FilterBuilder;
+    group(operator?: LogicalOperator): FilterBuilder;
+    groupOperator(operator: LogicalOperator): FilterBuilder;
+    build(): FilterExpression;
+    toString(): string;
+    validate(config?: FilterValidationConfig): FilterValidationResult;
+}
+//# sourceMappingURL=filters.d.ts.map

package/dist/utils/filters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"filters.d.ts","sourceRoot":"","sources":["../../src/utils/filters.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EACV,eAAe,EACf,gBAAgB,EAChB,WAAW,EACX,WAAW,EACX,cAAc,EACd,sBAAsB,EACtB,sBAAsB,EACtB,eAAe,EACf,WAAW,EAEZ,MAAM,kBAAkB,CAAC;AA+E1B;;GAEG;AACH,eAAO,MAAM,iBAAiB;IAC5B;;OAEG;gCACyB,MAAM,GAAG,OAAO;IAI5C;;OAEG;0BACmB,MAAM,GAAG;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE;IAUnE;;OAEG;yBACkB,MAAM,GAAG;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE;CASnE,CAAC;AA8XF;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,WAAW,CAgHhE;AAmHD;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,eAAe,GAAG,MAAM,EAAE,CAoBtE;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CACtC,UAAU,EAAE,gBAAgB,EAC5B,MAAM,GAAE,sBAA2B,GAClC,sBAAsB,CAiDxB;AAwBD;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,eAAe,GAAG,MAAM,CAoBpE;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,CAKxD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,gBAAgB,GAAG,MAAM,CAIvE;AAED;;GAEG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,UAAU,CAAmB;IACrC,OAAO,CAAC,YAAY,CAAc;;IAYlC,KAAK,CAAC,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,cAAc,EAAE,KAAK,EAAE,OAAO,GAAG,aAAa;IASlF,GAAG,IAAI,aAAa;IAKpB,EAAE,IAAI,aAAa;IAKnB,KAAK,CAAC,QAAQ,GAAE,eAAsB,GAAG,aAAa;IAStD,aAAa,CAAC,QAAQ,EAAE,eAAe,GAAG,aAAa;IAKvD,KAAK,IAAI,gBAAgB;IAKzB,QAAQ,IAAI,MAAM;IAIlB,QAAQ,CAAC,MAAM,CAAC,EAAE,sBAAsB,GAAG,sBAAsB;CAGlE"}