@joyjit/vikunja-mcp 0.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (424) hide show
  1. package/CHANGELOG.md +51 -0
  2. package/LICENSE +21 -0
  3. package/README.md +1377 -0
  4. package/dist/auth/AuthManager.d.ts +63 -0
  5. package/dist/auth/AuthManager.d.ts.map +1 -0
  6. package/dist/auth/AuthManager.js +137 -0
  7. package/dist/auth/AuthManager.js.map +1 -0
  8. package/dist/auth/index.d.ts +7 -0
  9. package/dist/auth/index.d.ts.map +1 -0
  10. package/dist/auth/index.js +14 -0
  11. package/dist/auth/index.js.map +1 -0
  12. package/dist/auth/permissions.d.ts +60 -0
  13. package/dist/auth/permissions.d.ts.map +1 -0
  14. package/dist/auth/permissions.js +173 -0
  15. package/dist/auth/permissions.js.map +1 -0
  16. package/dist/client/VikunjaClientFactory.d.ts +32 -0
  17. package/dist/client/VikunjaClientFactory.d.ts.map +1 -0
  18. package/dist/client/VikunjaClientFactory.js +66 -0
  19. package/dist/client/VikunjaClientFactory.js.map +1 -0
  20. package/dist/client.d.ts +57 -0
  21. package/dist/client.d.ts.map +1 -0
  22. package/dist/client.js +128 -0
  23. package/dist/client.js.map +1 -0
  24. package/dist/config/ConfigurationManager.d.ts +63 -0
  25. package/dist/config/ConfigurationManager.d.ts.map +1 -0
  26. package/dist/config/ConfigurationManager.js +243 -0
  27. package/dist/config/ConfigurationManager.js.map +1 -0
  28. package/dist/config/index.d.ts +8 -0
  29. package/dist/config/index.d.ts.map +1 -0
  30. package/dist/config/index.js +27 -0
  31. package/dist/config/index.js.map +1 -0
  32. package/dist/config/types.d.ts +434 -0
  33. package/dist/config/types.d.ts.map +1 -0
  34. package/dist/config/types.js +93 -0
  35. package/dist/config/types.js.map +1 -0
  36. package/dist/formatters/BatchImportResponseFormatter.d.ts +89 -0
  37. package/dist/formatters/BatchImportResponseFormatter.d.ts.map +1 -0
  38. package/dist/formatters/BatchImportResponseFormatter.js +125 -0
  39. package/dist/formatters/BatchImportResponseFormatter.js.map +1 -0
  40. package/dist/index.d.ts +20 -0
  41. package/dist/index.d.ts.map +1 -0
  42. package/dist/index.js +119 -0
  43. package/dist/index.js.map +1 -0
  44. package/dist/middleware/direct-middleware.d.ts +9 -0
  45. package/dist/middleware/direct-middleware.d.ts.map +1 -0
  46. package/dist/middleware/direct-middleware.js +49 -0
  47. package/dist/middleware/direct-middleware.js.map +1 -0
  48. package/dist/middleware/index.d.ts +8 -0
  49. package/dist/middleware/index.d.ts.map +1 -0
  50. package/dist/middleware/index.js +21 -0
  51. package/dist/middleware/index.js.map +1 -0
  52. package/dist/middleware/simplified-rate-limit.d.ts +147 -0
  53. package/dist/middleware/simplified-rate-limit.d.ts.map +1 -0
  54. package/dist/middleware/simplified-rate-limit.js +542 -0
  55. package/dist/middleware/simplified-rate-limit.js.map +1 -0
  56. package/dist/parsers/CSVParser.d.ts +36 -0
  57. package/dist/parsers/CSVParser.d.ts.map +1 -0
  58. package/dist/parsers/CSVParser.js +69 -0
  59. package/dist/parsers/CSVParser.js.map +1 -0
  60. package/dist/parsers/InputParserFactory.d.ts +17 -0
  61. package/dist/parsers/InputParserFactory.d.ts.map +1 -0
  62. package/dist/parsers/InputParserFactory.js +137 -0
  63. package/dist/parsers/InputParserFactory.js.map +1 -0
  64. package/dist/parsers/JSONParser.d.ts +74 -0
  65. package/dist/parsers/JSONParser.d.ts.map +1 -0
  66. package/dist/parsers/JSONParser.js +69 -0
  67. package/dist/parsers/JSONParser.js.map +1 -0
  68. package/dist/services/EntityResolver.d.ts +75 -0
  69. package/dist/services/EntityResolver.d.ts.map +1 -0
  70. package/dist/services/EntityResolver.js +176 -0
  71. package/dist/services/EntityResolver.js.map +1 -0
  72. package/dist/services/TaskCreationService.d.ts +96 -0
  73. package/dist/services/TaskCreationService.d.ts.map +1 -0
  74. package/dist/services/TaskCreationService.js +361 -0
  75. package/dist/services/TaskCreationService.js.map +1 -0
  76. package/dist/storage/SimpleFilterStorage.d.ts +110 -0
  77. package/dist/storage/SimpleFilterStorage.d.ts.map +1 -0
  78. package/dist/storage/SimpleFilterStorage.js +358 -0
  79. package/dist/storage/SimpleFilterStorage.js.map +1 -0
  80. package/dist/storage/index.d.ts +59 -0
  81. package/dist/storage/index.d.ts.map +1 -0
  82. package/dist/storage/index.js +117 -0
  83. package/dist/storage/index.js.map +1 -0
  84. package/dist/tools/auth.d.ts +9 -0
  85. package/dist/tools/auth.d.ts.map +1 -0
  86. package/dist/tools/auth.js +80 -0
  87. package/dist/tools/auth.js.map +1 -0
  88. package/dist/tools/batch-import.d.ts +5 -0
  89. package/dist/tools/batch-import.d.ts.map +1 -0
  90. package/dist/tools/batch-import.js +150 -0
  91. package/dist/tools/batch-import.js.map +1 -0
  92. package/dist/tools/export.d.ts +14 -0
  93. package/dist/tools/export.d.ts.map +1 -0
  94. package/dist/tools/export.js +232 -0
  95. package/dist/tools/export.js.map +1 -0
  96. package/dist/tools/filters.d.ts +8 -0
  97. package/dist/tools/filters.d.ts.map +1 -0
  98. package/dist/tools/filters.js +419 -0
  99. package/dist/tools/filters.js.map +1 -0
  100. package/dist/tools/index.d.ts +36 -0
  101. package/dist/tools/index.d.ts.map +1 -0
  102. package/dist/tools/index.js +87 -0
  103. package/dist/tools/index.js.map +1 -0
  104. package/dist/tools/labels.d.ts +9 -0
  105. package/dist/tools/labels.d.ts.map +1 -0
  106. package/dist/tools/labels.js +152 -0
  107. package/dist/tools/labels.js.map +1 -0
  108. package/dist/tools/projects/crud.d.ts +118 -0
  109. package/dist/tools/projects/crud.d.ts.map +1 -0
  110. package/dist/tools/projects/crud.js +389 -0
  111. package/dist/tools/projects/crud.js.map +1 -0
  112. package/dist/tools/projects/hierarchy.d.ts +68 -0
  113. package/dist/tools/projects/hierarchy.d.ts.map +1 -0
  114. package/dist/tools/projects/hierarchy.js +280 -0
  115. package/dist/tools/projects/hierarchy.js.map +1 -0
  116. package/dist/tools/projects/index.d.ts +17 -0
  117. package/dist/tools/projects/index.d.ts.map +1 -0
  118. package/dist/tools/projects/index.js +169 -0
  119. package/dist/tools/projects/index.js.map +1 -0
  120. package/dist/tools/projects/response-formatter.d.ts +46 -0
  121. package/dist/tools/projects/response-formatter.d.ts.map +1 -0
  122. package/dist/tools/projects/response-formatter.js +131 -0
  123. package/dist/tools/projects/response-formatter.js.map +1 -0
  124. package/dist/tools/projects/sharing.d.ts +89 -0
  125. package/dist/tools/projects/sharing.d.ts.map +1 -0
  126. package/dist/tools/projects/sharing.js +272 -0
  127. package/dist/tools/projects/sharing.js.map +1 -0
  128. package/dist/tools/projects/validation.d.ts +39 -0
  129. package/dist/tools/projects/validation.d.ts.map +1 -0
  130. package/dist/tools/projects/validation.js +129 -0
  131. package/dist/tools/projects/validation.js.map +1 -0
  132. package/dist/tools/projects.d.ts +10 -0
  133. package/dist/tools/projects.d.ts.map +1 -0
  134. package/dist/tools/projects.js +42 -0
  135. package/dist/tools/projects.js.map +1 -0
  136. package/dist/tools/task-assignees.d.ts +13 -0
  137. package/dist/tools/task-assignees.d.ts.map +1 -0
  138. package/dist/tools/task-assignees.js +62 -0
  139. package/dist/tools/task-assignees.js.map +1 -0
  140. package/dist/tools/task-bulk.d.ts +13 -0
  141. package/dist/tools/task-bulk.d.ts.map +1 -0
  142. package/dist/tools/task-bulk.js +113 -0
  143. package/dist/tools/task-bulk.js.map +1 -0
  144. package/dist/tools/task-comments.d.ts +13 -0
  145. package/dist/tools/task-comments.d.ts.map +1 -0
  146. package/dist/tools/task-comments.js +53 -0
  147. package/dist/tools/task-comments.js.map +1 -0
  148. package/dist/tools/task-crud.d.ts +13 -0
  149. package/dist/tools/task-crud.d.ts.map +1 -0
  150. package/dist/tools/task-crud.js +163 -0
  151. package/dist/tools/task-crud.js.map +1 -0
  152. package/dist/tools/task-labels.d.ts +13 -0
  153. package/dist/tools/task-labels.d.ts.map +1 -0
  154. package/dist/tools/task-labels.js +62 -0
  155. package/dist/tools/task-labels.js.map +1 -0
  156. package/dist/tools/task-relations.d.ts +13 -0
  157. package/dist/tools/task-relations.d.ts.map +1 -0
  158. package/dist/tools/task-relations.js +72 -0
  159. package/dist/tools/task-relations.js.map +1 -0
  160. package/dist/tools/task-reminders.d.ts +13 -0
  161. package/dist/tools/task-reminders.d.ts.map +1 -0
  162. package/dist/tools/task-reminders.js +63 -0
  163. package/dist/tools/task-reminders.js.map +1 -0
  164. package/dist/tools/tasks/assignees/AssigneeOperationsService.d.ts +31 -0
  165. package/dist/tools/tasks/assignees/AssigneeOperationsService.d.ts.map +1 -0
  166. package/dist/tools/tasks/assignees/AssigneeOperationsService.js +95 -0
  167. package/dist/tools/tasks/assignees/AssigneeOperationsService.js.map +1 -0
  168. package/dist/tools/tasks/assignees/AssigneeResponseFormatter.d.ts +32 -0
  169. package/dist/tools/tasks/assignees/AssigneeResponseFormatter.d.ts.map +1 -0
  170. package/dist/tools/tasks/assignees/AssigneeResponseFormatter.js +84 -0
  171. package/dist/tools/tasks/assignees/AssigneeResponseFormatter.js.map +1 -0
  172. package/dist/tools/tasks/assignees/AssigneeValidationService.d.ts +36 -0
  173. package/dist/tools/tasks/assignees/AssigneeValidationService.d.ts.map +1 -0
  174. package/dist/tools/tasks/assignees/AssigneeValidationService.js +63 -0
  175. package/dist/tools/tasks/assignees/AssigneeValidationService.js.map +1 -0
  176. package/dist/tools/tasks/assignees/index.d.ts +40 -0
  177. package/dist/tools/tasks/assignees/index.d.ts.map +1 -0
  178. package/dist/tools/tasks/assignees/index.js +72 -0
  179. package/dist/tools/tasks/assignees/index.js.map +1 -0
  180. package/dist/tools/tasks/bulk/BulkOperationValidator.d.ts +51 -0
  181. package/dist/tools/tasks/bulk/BulkOperationValidator.d.ts.map +1 -0
  182. package/dist/tools/tasks/bulk/BulkOperationValidator.js +149 -0
  183. package/dist/tools/tasks/bulk/BulkOperationValidator.js.map +1 -0
  184. package/dist/tools/tasks/bulk-operations-simplified.d.ts +39 -0
  185. package/dist/tools/tasks/bulk-operations-simplified.d.ts.map +1 -0
  186. package/dist/tools/tasks/bulk-operations-simplified.js +249 -0
  187. package/dist/tools/tasks/bulk-operations-simplified.js.map +1 -0
  188. package/dist/tools/tasks/bulk-operations.d.ts +8 -0
  189. package/dist/tools/tasks/bulk-operations.d.ts.map +1 -0
  190. package/dist/tools/tasks/bulk-operations.js +14 -0
  191. package/dist/tools/tasks/bulk-operations.js.map +1 -0
  192. package/dist/tools/tasks/comments/CommentOperationsService.d.ts +23 -0
  193. package/dist/tools/tasks/comments/CommentOperationsService.d.ts.map +1 -0
  194. package/dist/tools/tasks/comments/CommentOperationsService.js +37 -0
  195. package/dist/tools/tasks/comments/CommentOperationsService.js.map +1 -0
  196. package/dist/tools/tasks/comments/CommentResponseFormatter.d.ts +29 -0
  197. package/dist/tools/tasks/comments/CommentResponseFormatter.d.ts.map +1 -0
  198. package/dist/tools/tasks/comments/CommentResponseFormatter.js +69 -0
  199. package/dist/tools/tasks/comments/CommentResponseFormatter.js.map +1 -0
  200. package/dist/tools/tasks/comments/CommentValidationService.d.ts +33 -0
  201. package/dist/tools/tasks/comments/CommentValidationService.d.ts.map +1 -0
  202. package/dist/tools/tasks/comments/CommentValidationService.js +50 -0
  203. package/dist/tools/tasks/comments/CommentValidationService.js.map +1 -0
  204. package/dist/tools/tasks/comments/index.d.ts +38 -0
  205. package/dist/tools/tasks/comments/index.d.ts.map +1 -0
  206. package/dist/tools/tasks/comments/index.js +62 -0
  207. package/dist/tools/tasks/comments/index.js.map +1 -0
  208. package/dist/tools/tasks/constants.d.ts +17 -0
  209. package/dist/tools/tasks/constants.d.ts.map +1 -0
  210. package/dist/tools/tasks/constants.js +36 -0
  211. package/dist/tools/tasks/constants.js.map +1 -0
  212. package/dist/tools/tasks/crud/TaskCreationService.d.ts +26 -0
  213. package/dist/tools/tasks/crud/TaskCreationService.d.ts.map +1 -0
  214. package/dist/tools/tasks/crud/TaskCreationService.js +228 -0
  215. package/dist/tools/tasks/crud/TaskCreationService.js.map +1 -0
  216. package/dist/tools/tasks/crud/TaskDeletionService.d.ts +18 -0
  217. package/dist/tools/tasks/crud/TaskDeletionService.d.ts.map +1 -0
  218. package/dist/tools/tasks/crud/TaskDeletionService.js +89 -0
  219. package/dist/tools/tasks/crud/TaskDeletionService.js.map +1 -0
  220. package/dist/tools/tasks/crud/TaskReadService.d.ts +18 -0
  221. package/dist/tools/tasks/crud/TaskReadService.d.ts.map +1 -0
  222. package/dist/tools/tasks/crud/TaskReadService.js +58 -0
  223. package/dist/tools/tasks/crud/TaskReadService.js.map +1 -0
  224. package/dist/tools/tasks/crud/TaskResponseFormatter.d.ts +18 -0
  225. package/dist/tools/tasks/crud/TaskResponseFormatter.d.ts.map +1 -0
  226. package/dist/tools/tasks/crud/TaskResponseFormatter.js +244 -0
  227. package/dist/tools/tasks/crud/TaskResponseFormatter.js.map +1 -0
  228. package/dist/tools/tasks/crud/TaskUpdateService.d.ts +29 -0
  229. package/dist/tools/tasks/crud/TaskUpdateService.d.ts.map +1 -0
  230. package/dist/tools/tasks/crud/TaskUpdateService.js +231 -0
  231. package/dist/tools/tasks/crud/TaskUpdateService.js.map +1 -0
  232. package/dist/tools/tasks/crud/index.d.ts +16 -0
  233. package/dist/tools/tasks/crud/index.d.ts.map +1 -0
  234. package/dist/tools/tasks/crud/index.js +20 -0
  235. package/dist/tools/tasks/crud/index.js.map +1 -0
  236. package/dist/tools/tasks/filtering/FilterExecutor.d.ts +38 -0
  237. package/dist/tools/tasks/filtering/FilterExecutor.d.ts.map +1 -0
  238. package/dist/tools/tasks/filtering/FilterExecutor.js +200 -0
  239. package/dist/tools/tasks/filtering/FilterExecutor.js.map +1 -0
  240. package/dist/tools/tasks/filtering/FilterValidator.d.ts +56 -0
  241. package/dist/tools/tasks/filtering/FilterValidator.d.ts.map +1 -0
  242. package/dist/tools/tasks/filtering/FilterValidator.js +183 -0
  243. package/dist/tools/tasks/filtering/FilterValidator.js.map +1 -0
  244. package/dist/tools/tasks/filtering/TaskFilteringOrchestrator.d.ts +75 -0
  245. package/dist/tools/tasks/filtering/TaskFilteringOrchestrator.d.ts.map +1 -0
  246. package/dist/tools/tasks/filtering/TaskFilteringOrchestrator.js +193 -0
  247. package/dist/tools/tasks/filtering/TaskFilteringOrchestrator.js.map +1 -0
  248. package/dist/tools/tasks/filtering/evaluators.d.ts +38 -0
  249. package/dist/tools/tasks/filtering/evaluators.d.ts.map +1 -0
  250. package/dist/tools/tasks/filtering/evaluators.js +200 -0
  251. package/dist/tools/tasks/filtering/evaluators.js.map +1 -0
  252. package/dist/tools/tasks/filtering/index.d.ts +11 -0
  253. package/dist/tools/tasks/filtering/index.d.ts.map +1 -0
  254. package/dist/tools/tasks/filtering/index.js +26 -0
  255. package/dist/tools/tasks/filtering/index.js.map +1 -0
  256. package/dist/tools/tasks/index.d.ts +9 -0
  257. package/dist/tools/tasks/index.d.ts.map +1 -0
  258. package/dist/tools/tasks/index.js +245 -0
  259. package/dist/tools/tasks/index.js.map +1 -0
  260. package/dist/tools/tasks/labels.d.ts +39 -0
  261. package/dist/tools/tasks/labels.d.ts.map +1 -0
  262. package/dist/tools/tasks/labels.js +150 -0
  263. package/dist/tools/tasks/labels.js.map +1 -0
  264. package/dist/tools/tasks/reminders.d.ts +39 -0
  265. package/dist/tools/tasks/reminders.d.ts.map +1 -0
  266. package/dist/tools/tasks/reminders.js +147 -0
  267. package/dist/tools/tasks/reminders.js.map +1 -0
  268. package/dist/tools/tasks/types/filters.d.ts +121 -0
  269. package/dist/tools/tasks/types/filters.d.ts.map +1 -0
  270. package/dist/tools/tasks/types/filters.js +7 -0
  271. package/dist/tools/tasks/types/filters.js.map +1 -0
  272. package/dist/tools/tasks/validation.d.ts +44 -0
  273. package/dist/tools/tasks/validation.d.ts.map +1 -0
  274. package/dist/tools/tasks/validation.js +121 -0
  275. package/dist/tools/tasks/validation.js.map +1 -0
  276. package/dist/tools/tasks-relations.d.ts +24 -0
  277. package/dist/tools/tasks-relations.d.ts.map +1 -0
  278. package/dist/tools/tasks-relations.js +203 -0
  279. package/dist/tools/tasks-relations.js.map +1 -0
  280. package/dist/tools/tasks.d.ts +6 -0
  281. package/dist/tools/tasks.d.ts.map +1 -0
  282. package/dist/tools/tasks.js +10 -0
  283. package/dist/tools/tasks.js.map +1 -0
  284. package/dist/tools/teams.d.ts +9 -0
  285. package/dist/tools/teams.d.ts.map +1 -0
  286. package/dist/tools/teams.js +332 -0
  287. package/dist/tools/teams.js.map +1 -0
  288. package/dist/tools/templates.d.ts +9 -0
  289. package/dist/tools/templates.d.ts.map +1 -0
  290. package/dist/tools/templates.js +356 -0
  291. package/dist/tools/templates.js.map +1 -0
  292. package/dist/tools/users.d.ts +9 -0
  293. package/dist/tools/users.d.ts.map +1 -0
  294. package/dist/tools/users.js +239 -0
  295. package/dist/tools/users.js.map +1 -0
  296. package/dist/tools/webhooks.d.ts +11 -0
  297. package/dist/tools/webhooks.d.ts.map +1 -0
  298. package/dist/tools/webhooks.js +378 -0
  299. package/dist/tools/webhooks.js.map +1 -0
  300. package/dist/transforms/base.d.ts +178 -0
  301. package/dist/transforms/base.d.ts.map +1 -0
  302. package/dist/transforms/base.js +134 -0
  303. package/dist/transforms/base.js.map +1 -0
  304. package/dist/transforms/field-selector.d.ts +27 -0
  305. package/dist/transforms/field-selector.d.ts.map +1 -0
  306. package/dist/transforms/field-selector.js +91 -0
  307. package/dist/transforms/field-selector.js.map +1 -0
  308. package/dist/transforms/task.d.ts +207 -0
  309. package/dist/transforms/task.d.ts.map +1 -0
  310. package/dist/transforms/task.js +259 -0
  311. package/dist/transforms/task.js.map +1 -0
  312. package/dist/types/errors.d.ts +55 -0
  313. package/dist/types/errors.d.ts.map +1 -0
  314. package/dist/types/errors.js +44 -0
  315. package/dist/types/errors.js.map +1 -0
  316. package/dist/types/filters.d.ts +146 -0
  317. package/dist/types/filters.d.ts.map +1 -0
  318. package/dist/types/filters.js +22 -0
  319. package/dist/types/filters.js.map +1 -0
  320. package/dist/types/index.d.ts +151 -0
  321. package/dist/types/index.d.ts.map +1 -0
  322. package/dist/types/index.js +24 -0
  323. package/dist/types/index.js.map +1 -0
  324. package/dist/types/node-vikunja-extended.d.ts +36 -0
  325. package/dist/types/node-vikunja-extended.d.ts.map +1 -0
  326. package/dist/types/node-vikunja-extended.js +25 -0
  327. package/dist/types/node-vikunja-extended.js.map +1 -0
  328. package/dist/types/responses.d.ts +118 -0
  329. package/dist/types/responses.d.ts.map +1 -0
  330. package/dist/types/responses.js +26 -0
  331. package/dist/types/responses.js.map +1 -0
  332. package/dist/types/vikunja.d.ts +315 -0
  333. package/dist/types/vikunja.d.ts.map +1 -0
  334. package/dist/types/vikunja.js +7 -0
  335. package/dist/types/vikunja.js.map +1 -0
  336. package/dist/utils/auth-error-handler.d.ts +23 -0
  337. package/dist/utils/auth-error-handler.d.ts.map +1 -0
  338. package/dist/utils/auth-error-handler.js +162 -0
  339. package/dist/utils/auth-error-handler.js.map +1 -0
  340. package/dist/utils/error-handler.d.ts +38 -0
  341. package/dist/utils/error-handler.d.ts.map +1 -0
  342. package/dist/utils/error-handler.js +288 -0
  343. package/dist/utils/error-handler.js.map +1 -0
  344. package/dist/utils/filtering/ClientSideFilteringStrategy.d.ts +13 -0
  345. package/dist/utils/filtering/ClientSideFilteringStrategy.d.ts.map +1 -0
  346. package/dist/utils/filtering/ClientSideFilteringStrategy.js +63 -0
  347. package/dist/utils/filtering/ClientSideFilteringStrategy.js.map +1 -0
  348. package/dist/utils/filtering/FilteringContext.d.ts +27 -0
  349. package/dist/utils/filtering/FilteringContext.d.ts.map +1 -0
  350. package/dist/utils/filtering/FilteringContext.js +43 -0
  351. package/dist/utils/filtering/FilteringContext.js.map +1 -0
  352. package/dist/utils/filtering/HybridFilteringStrategy.d.ts +15 -0
  353. package/dist/utils/filtering/HybridFilteringStrategy.d.ts.map +1 -0
  354. package/dist/utils/filtering/HybridFilteringStrategy.js +55 -0
  355. package/dist/utils/filtering/HybridFilteringStrategy.js.map +1 -0
  356. package/dist/utils/filtering/ServerSideFilteringStrategy.d.ts +13 -0
  357. package/dist/utils/filtering/ServerSideFilteringStrategy.d.ts.map +1 -0
  358. package/dist/utils/filtering/ServerSideFilteringStrategy.js +64 -0
  359. package/dist/utils/filtering/ServerSideFilteringStrategy.js.map +1 -0
  360. package/dist/utils/filtering/TaskFilteringStrategy.d.ts +19 -0
  361. package/dist/utils/filtering/TaskFilteringStrategy.d.ts.map +1 -0
  362. package/dist/utils/filtering/TaskFilteringStrategy.js +10 -0
  363. package/dist/utils/filtering/TaskFilteringStrategy.js.map +1 -0
  364. package/dist/utils/filtering/index.d.ts +13 -0
  365. package/dist/utils/filtering/index.d.ts.map +1 -0
  366. package/dist/utils/filtering/index.js +20 -0
  367. package/dist/utils/filtering/index.js.map +1 -0
  368. package/dist/utils/filtering/types.d.ts +62 -0
  369. package/dist/utils/filtering/types.d.ts.map +1 -0
  370. package/dist/utils/filtering/types.js +6 -0
  371. package/dist/utils/filtering/types.js.map +1 -0
  372. package/dist/utils/filters.d.ts +97 -0
  373. package/dist/utils/filters.d.ts.map +1 -0
  374. package/dist/utils/filters.js +939 -0
  375. package/dist/utils/filters.js.map +1 -0
  376. package/dist/utils/logger.d.ts +26 -0
  377. package/dist/utils/logger.d.ts.map +1 -0
  378. package/dist/utils/logger.js +83 -0
  379. package/dist/utils/logger.js.map +1 -0
  380. package/dist/utils/memory.d.ts +71 -0
  381. package/dist/utils/memory.d.ts.map +1 -0
  382. package/dist/utils/memory.js +194 -0
  383. package/dist/utils/memory.js.map +1 -0
  384. package/dist/utils/performance/batch-processor.d.ts +77 -0
  385. package/dist/utils/performance/batch-processor.d.ts.map +1 -0
  386. package/dist/utils/performance/batch-processor.js +218 -0
  387. package/dist/utils/performance/batch-processor.js.map +1 -0
  388. package/dist/utils/performance/index.d.ts +42 -0
  389. package/dist/utils/performance/index.d.ts.map +1 -0
  390. package/dist/utils/performance/index.js +49 -0
  391. package/dist/utils/performance/index.js.map +1 -0
  392. package/dist/utils/performance/performance-monitor.d.ts +116 -0
  393. package/dist/utils/performance/performance-monitor.d.ts.map +1 -0
  394. package/dist/utils/performance/performance-monitor.js +307 -0
  395. package/dist/utils/performance/performance-monitor.js.map +1 -0
  396. package/dist/utils/response-factory.d.ts +81 -0
  397. package/dist/utils/response-factory.d.ts.map +1 -0
  398. package/dist/utils/response-factory.js +86 -0
  399. package/dist/utils/response-factory.js.map +1 -0
  400. package/dist/utils/retry.d.ts +146 -0
  401. package/dist/utils/retry.d.ts.map +1 -0
  402. package/dist/utils/retry.js +281 -0
  403. package/dist/utils/retry.js.map +1 -0
  404. package/dist/utils/security.d.ts +70 -0
  405. package/dist/utils/security.d.ts.map +1 -0
  406. package/dist/utils/security.js +358 -0
  407. package/dist/utils/security.js.map +1 -0
  408. package/dist/utils/simple-response.d.ts +75 -0
  409. package/dist/utils/simple-response.d.ts.map +1 -0
  410. package/dist/utils/simple-response.js +208 -0
  411. package/dist/utils/simple-response.js.map +1 -0
  412. package/dist/utils/storage-errors.d.ts +9 -0
  413. package/dist/utils/storage-errors.d.ts.map +1 -0
  414. package/dist/utils/storage-errors.js +20 -0
  415. package/dist/utils/storage-errors.js.map +1 -0
  416. package/dist/utils/unicode-fix.d.ts +19 -0
  417. package/dist/utils/unicode-fix.d.ts.map +1 -0
  418. package/dist/utils/unicode-fix.js +70 -0
  419. package/dist/utils/unicode-fix.js.map +1 -0
  420. package/dist/utils/validation.d.ts +103 -0
  421. package/dist/utils/validation.d.ts.map +1 -0
  422. package/dist/utils/validation.js +729 -0
  423. package/dist/utils/validation.js.map +1 -0
  424. package/package.json +148 -0
@@ -0,0 +1,200 @@
1
+ "use strict";
2
+ /**
3
+ * Filter execution engine for task filtering operations
4
+ * Handles the execution of filters and applies additional post-processing
5
+ */
6
+ Object.defineProperty(exports, "__esModule", { value: true });
7
+ exports.FilterExecutor = void 0;
8
+ const filtering_1 = require("../../../utils/filtering");
9
+ const memory_1 = require("../../../utils/memory");
10
+ const types_1 = require("../../../types");
11
+ const logger_1 = require("../../../utils/logger");
12
+ /**
13
+ * Executes filtering operations on tasks with comprehensive error handling
14
+ */
15
+ exports.FilterExecutor = {
16
+ /**
17
+ * Executes task filtering with the provided parameters
18
+ */
19
+ async executeFiltering(args, filterExpression, filterString, params, _storage) {
20
+ try {
21
+ // Execute filtering using strategy pattern
22
+ const filteringContext = new filtering_1.FilteringContext({
23
+ enableServerSide: Boolean(filterString)
24
+ });
25
+ const filteringParams = {
26
+ args: args,
27
+ filterExpression,
28
+ filterString,
29
+ params
30
+ };
31
+ const filteringResult = await filteringContext.execute(filteringParams);
32
+ const tasks = filteringResult.tasks;
33
+ // Extract metadata for response formatting
34
+ const { serverSideFilteringUsed, serverSideFilteringAttempted, } = filteringResult.metadata;
35
+ // Additional memory protection: validate actual loaded task count
36
+ const actualTaskCount = tasks.length;
37
+ const finalTaskCountValidation = (0, memory_1.validateTaskCountLimit)(actualTaskCount);
38
+ let memoryInfo;
39
+ if (!finalTaskCountValidation.allowed) {
40
+ // Log warning but don't fail since tasks are already loaded
41
+ logger_1.logger.warn('Loaded task count exceeds recommended limits', {
42
+ actualCount: actualTaskCount,
43
+ maxRecommended: finalTaskCountValidation.maxAllowed,
44
+ estimatedMemoryMB: finalTaskCountValidation.estimatedMemoryMB
45
+ });
46
+ memoryInfo = {
47
+ actualCount: actualTaskCount,
48
+ maxAllowed: finalTaskCountValidation.maxAllowed,
49
+ estimatedMemoryMB: finalTaskCountValidation.estimatedMemoryMB
50
+ };
51
+ // For extremely large datasets, still enforce hard limits
52
+ if (actualTaskCount > finalTaskCountValidation.maxAllowed * 1.5) {
53
+ throw new types_1.MCPError(types_1.ErrorCode.INTERNAL_ERROR, (0, memory_1.createTaskLimitExceededMessage)('process loaded tasks', actualTaskCount));
54
+ }
55
+ }
56
+ // Log memory usage for monitoring
57
+ (0, memory_1.logMemoryUsage)('task listing', actualTaskCount);
58
+ // Apply post-processing filters
59
+ const processedTasks = exports.FilterExecutor.applyPostProcessingFilters(tasks, args);
60
+ // Determine filtering method message and metadata from strategy result
61
+ const filteringMetadata = exports.FilterExecutor.createFilteringMetadata(filterString, serverSideFilteringUsed, serverSideFilteringAttempted, filteringResult.metadata.filteringNote);
62
+ // Build return object, only including defined properties to satisfy exactOptionalPropertyTypes
63
+ const result = {
64
+ success: true,
65
+ tasks: processedTasks,
66
+ metadata: filteringMetadata,
67
+ };
68
+ if (memoryInfo !== undefined) {
69
+ result.memoryInfo = memoryInfo;
70
+ }
71
+ return result;
72
+ }
73
+ catch (error) {
74
+ if (error instanceof types_1.MCPError) {
75
+ throw error;
76
+ }
77
+ // Log the full error for debugging filter issues
78
+ logger_1.logger.error('Task filtering execution error:', {
79
+ error: error instanceof Error ? error.message : String(error),
80
+ params: params,
81
+ filter: args.filter,
82
+ filterId: args.filterId,
83
+ });
84
+ // Re-throw original error to be handled by main function
85
+ throw error;
86
+ }
87
+ },
88
+ /**
89
+ * Applies post-processing filters that aren't handled by the main filtering strategies
90
+ */
91
+ applyPostProcessingFilters(tasks, args) {
92
+ let filteredTasks = [...tasks];
93
+ // Filter by done status if specified (this is a simpler filter that works)
94
+ if (args.done !== undefined) {
95
+ filteredTasks = filteredTasks.filter((task) => task.done === args.done);
96
+ }
97
+ return filteredTasks;
98
+ },
99
+ /**
100
+ * Creates filtering metadata for response formatting
101
+ */
102
+ createFilteringMetadata(filterString, serverSideFilteringUsed, serverSideFilteringAttempted, filteringNote) {
103
+ if (filterString) {
104
+ if (serverSideFilteringUsed) {
105
+ return {
106
+ serverSideFilteringUsed: true,
107
+ serverSideFilteringAttempted: true,
108
+ clientSideFiltering: false,
109
+ filteringNote,
110
+ };
111
+ }
112
+ else if (serverSideFilteringAttempted) {
113
+ return {
114
+ serverSideFilteringUsed: false,
115
+ serverSideFilteringAttempted: true,
116
+ clientSideFiltering: true,
117
+ filteringNote,
118
+ };
119
+ }
120
+ else {
121
+ return {
122
+ serverSideFilteringUsed: false,
123
+ serverSideFilteringAttempted: false,
124
+ clientSideFiltering: true,
125
+ filteringNote,
126
+ };
127
+ }
128
+ }
129
+ else {
130
+ return {
131
+ serverSideFilteringUsed: false,
132
+ serverSideFilteringAttempted: false,
133
+ clientSideFiltering: false,
134
+ filteringNote,
135
+ };
136
+ }
137
+ },
138
+ /**
139
+ * Prepares query parameters for API calls
140
+ */
141
+ prepareQueryParameters(args) {
142
+ const params = {};
143
+ // Build query parameters
144
+ if (args.page !== undefined)
145
+ params.page = args.page;
146
+ if (args.perPage !== undefined)
147
+ params.per_page = args.perPage;
148
+ if (args.search !== undefined)
149
+ params.s = args.search;
150
+ if (args.sort !== undefined)
151
+ params.sort_by = args.sort;
152
+ // Memory protection: Check if we should implement pagination limits
153
+ // Note: Vikunja API doesn't provide task count endpoints, so we use conservative defaults
154
+ // and rely on user-provided pagination parameters
155
+ if (!params.per_page) {
156
+ // Set default pagination to prevent unbounded loading
157
+ params.per_page = 1000; // Conservative default
158
+ if (!params.page) {
159
+ params.page = 1;
160
+ }
161
+ logger_1.logger.info('Applied default pagination for memory protection', {
162
+ per_page: params.per_page,
163
+ page: params.page
164
+ });
165
+ }
166
+ return params;
167
+ },
168
+ /**
169
+ * Validates loaded tasks against memory constraints
170
+ */
171
+ validateLoadedTaskCount(tasks) {
172
+ const actualTaskCount = tasks.length;
173
+ const finalTaskCountValidation = (0, memory_1.validateTaskCountLimit)(actualTaskCount);
174
+ const warnings = [];
175
+ if (!finalTaskCountValidation.allowed) {
176
+ // Log warning but don't fail since tasks are already loaded
177
+ logger_1.logger.warn('Loaded task count exceeds recommended limits', {
178
+ actualCount: actualTaskCount,
179
+ maxRecommended: finalTaskCountValidation.maxAllowed,
180
+ estimatedMemoryMB: finalTaskCountValidation.estimatedMemoryMB
181
+ });
182
+ warnings.push(`Loaded ${actualTaskCount} tasks, which exceeds recommended limit of ${finalTaskCountValidation.maxAllowed}. ` +
183
+ `Estimated memory usage: ${finalTaskCountValidation.estimatedMemoryMB}MB.`);
184
+ // For extremely large datasets, still enforce hard limits
185
+ if (actualTaskCount > finalTaskCountValidation.maxAllowed * 1.5) {
186
+ return {
187
+ isValid: false,
188
+ warnings,
189
+ shouldThrow: true
190
+ };
191
+ }
192
+ }
193
+ return {
194
+ isValid: true,
195
+ warnings,
196
+ shouldThrow: false
197
+ };
198
+ },
199
+ };
200
+ //# sourceMappingURL=FilterExecutor.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"FilterExecutor.js","sourceRoot":"","sources":["../../../../src/tools/tasks/filtering/FilterExecutor.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,56 @@
1
+ /**
2
+ * Filter validation for task filtering operations
3
+ * Handles validation of filter expressions and task listing parameters
4
+ */
5
+ import type { Task } from 'node-vikunja';
6
+ import type { FilterExpression } from '../../../types/filters';
7
+ import type { TaskListingArgs, TaskFilterValidationConfig, TaskFilterStorage } from '../types/filters';
8
+ /**
9
+ * Validates filter parameters for task listing operations
10
+ */
11
+ export declare const FilterValidator: {
12
+ /**
13
+ * Validates and processes filter string or filter ID
14
+ */
15
+ validateAndParseFilter(args: TaskListingArgs, storage: TaskFilterStorage): Promise<{
16
+ filterExpression: FilterExpression | null;
17
+ filterString: string | undefined;
18
+ validationWarnings: string[];
19
+ }>;
20
+ /**
21
+ * Validates pagination and memory constraints
22
+ */
23
+ validateMemoryConstraints(args: TaskListingArgs, requestedPageSize: number): {
24
+ isValid: boolean;
25
+ warnings: string[];
26
+ maxAllowed?: number;
27
+ };
28
+ /**
29
+ * Validates the actual loaded task count against limits
30
+ */
31
+ validateLoadedTasks(actualTaskCount: number, sampleTask?: Task): {
32
+ isValid: boolean;
33
+ warnings: string[];
34
+ shouldThrow: boolean;
35
+ riskLevel?: "low" | "medium" | "high";
36
+ estimatedMemoryMB?: number;
37
+ };
38
+ /**
39
+ * Validates task listing arguments
40
+ */
41
+ validateTaskListingArgs(args: TaskListingArgs): string[];
42
+ /**
43
+ * Performs comprehensive validation of task filtering parameters
44
+ */
45
+ validateTaskFiltering(args: TaskListingArgs, storage: TaskFilterStorage, _config?: TaskFilterValidationConfig): Promise<{
46
+ filterExpression: FilterExpression | null;
47
+ filterString: string | undefined;
48
+ validationWarnings: string[];
49
+ memoryValidation: {
50
+ isValid: boolean;
51
+ warnings: string[];
52
+ maxAllowed?: number;
53
+ };
54
+ }>;
55
+ };
56
+ //# sourceMappingURL=FilterValidator.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"FilterValidator.d.ts","sourceRoot":"","sources":["../../../../src/tools/tasks/filtering/FilterValidator.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,KAAK,EAAE,gBAAgB,EAAe,MAAM,wBAAwB,CAAC;AAC5E,OAAO,KAAK,EAAE,eAAe,EAAE,0BAA0B,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAMvG;;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"}
@@ -0,0 +1,183 @@
1
+ "use strict";
2
+ /**
3
+ * Filter validation for task filtering operations
4
+ * Handles validation of filter expressions and task listing parameters
5
+ */
6
+ Object.defineProperty(exports, "__esModule", { value: true });
7
+ exports.FilterValidator = void 0;
8
+ const types_1 = require("../../../types");
9
+ const filters_1 = require("../../../utils/filters");
10
+ const memory_1 = require("../../../utils/memory");
11
+ const logger_1 = require("../../../utils/logger");
12
+ /**
13
+ * Validates filter parameters for task listing operations
14
+ */
15
+ exports.FilterValidator = {
16
+ /**
17
+ * Validates and processes filter string or filter ID
18
+ */
19
+ async validateAndParseFilter(args, storage) {
20
+ let filterExpression = null;
21
+ let filterString;
22
+ const validationWarnings = [];
23
+ try {
24
+ // Handle filter - either direct filter string or saved filter ID
25
+ if (args.filterId) {
26
+ const savedFilter = await storage.get(args.filterId);
27
+ if (!savedFilter) {
28
+ throw new types_1.MCPError(types_1.ErrorCode.VALIDATION_ERROR, `Filter with id ${args.filterId} not found`);
29
+ }
30
+ filterString = savedFilter.filter;
31
+ }
32
+ else if (args.filter !== undefined) {
33
+ filterString = args.filter;
34
+ }
35
+ // Parse the filter string for client-side filtering
36
+ if (filterString) {
37
+ const parseResult = (0, filters_1.parseFilterString)(filterString);
38
+ if (parseResult.error) {
39
+ throw new types_1.MCPError(types_1.ErrorCode.VALIDATION_ERROR, `Invalid filter syntax: ${parseResult.error.message}${parseResult.error.context ? `\n${parseResult.error.context}` : ''}`);
40
+ }
41
+ filterExpression = parseResult.expression;
42
+ // Log that we're preparing to attempt hybrid filtering
43
+ logger_1.logger.info('Preparing hybrid filtering (server-side attempt + client-side fallback)', {
44
+ filter: filterString,
45
+ });
46
+ }
47
+ return { filterExpression, filterString, validationWarnings };
48
+ }
49
+ catch (error) {
50
+ if (error instanceof types_1.MCPError) {
51
+ throw error;
52
+ }
53
+ throw new types_1.MCPError(types_1.ErrorCode.VALIDATION_ERROR, `Filter validation failed: ${error instanceof Error ? error.message : String(error)}`);
54
+ }
55
+ },
56
+ /**
57
+ * Validates pagination and memory constraints
58
+ */
59
+ validateMemoryConstraints(args, requestedPageSize) {
60
+ const warnings = [];
61
+ // Validate pagination limits for memory protection with enhanced analysis
62
+ const taskCountValidation = (0, memory_1.validateTaskCountLimit)(requestedPageSize, undefined, args.filter ? {
63
+ filterExpression: args.filter,
64
+ operationType: 'list'
65
+ } : undefined);
66
+ if (!taskCountValidation.allowed) {
67
+ throw new types_1.MCPError(types_1.ErrorCode.VALIDATION_ERROR, `Task count limit exceeded. Requested: ${requestedPageSize}, Max allowed: ${taskCountValidation.maxAllowed}. ` +
68
+ `Estimated memory usage: ${taskCountValidation.estimatedMemoryMB}MB (risk: ${taskCountValidation.riskLevel}). ` +
69
+ 'Reduce the perPage parameter, use pagination with smaller page sizes, or apply more specific filters.');
70
+ }
71
+ // Add warnings for large page sizes
72
+ if (requestedPageSize > 500) {
73
+ warnings.push(`Large page size (${requestedPageSize}) may impact performance. Consider using smaller pages or more specific filters.`);
74
+ }
75
+ // Include enhanced memory validation warnings
76
+ if (taskCountValidation.warnings.length > 0) {
77
+ warnings.push(...taskCountValidation.warnings);
78
+ }
79
+ return {
80
+ isValid: true,
81
+ warnings,
82
+ maxAllowed: taskCountValidation.maxAllowed
83
+ };
84
+ },
85
+ /**
86
+ * Validates the actual loaded task count against limits
87
+ */
88
+ validateLoadedTasks(actualTaskCount, sampleTask) {
89
+ const warnings = [];
90
+ const finalTaskCountValidation = (0, memory_1.validateTaskCountLimit)(actualTaskCount, sampleTask);
91
+ if (!finalTaskCountValidation.allowed) {
92
+ // Log warning but don't fail since tasks are already loaded
93
+ logger_1.logger.warn('Loaded task count exceeds recommended limits', {
94
+ actualCount: actualTaskCount,
95
+ maxRecommended: finalTaskCountValidation.maxAllowed,
96
+ estimatedMemoryMB: finalTaskCountValidation.estimatedMemoryMB,
97
+ riskLevel: finalTaskCountValidation.riskLevel
98
+ });
99
+ warnings.push(`Loaded ${actualTaskCount} tasks, which exceeds recommended limit of ${finalTaskCountValidation.maxAllowed}. ` +
100
+ `Estimated memory usage: ${finalTaskCountValidation.estimatedMemoryMB}MB (risk: ${finalTaskCountValidation.riskLevel}).`);
101
+ // For extremely large datasets, still enforce hard limits
102
+ if (actualTaskCount > finalTaskCountValidation.maxAllowed * 1.5) {
103
+ return {
104
+ isValid: false,
105
+ warnings,
106
+ shouldThrow: true,
107
+ riskLevel: finalTaskCountValidation.riskLevel,
108
+ estimatedMemoryMB: finalTaskCountValidation.estimatedMemoryMB
109
+ };
110
+ }
111
+ }
112
+ // Include warnings from enhanced validation
113
+ if (finalTaskCountValidation.warnings.length > 0) {
114
+ warnings.push(...finalTaskCountValidation.warnings);
115
+ }
116
+ return {
117
+ isValid: true,
118
+ warnings,
119
+ shouldThrow: false,
120
+ riskLevel: finalTaskCountValidation.riskLevel,
121
+ estimatedMemoryMB: finalTaskCountValidation.estimatedMemoryMB
122
+ };
123
+ },
124
+ /**
125
+ * Validates task listing arguments
126
+ */
127
+ validateTaskListingArgs(args) {
128
+ const errors = [];
129
+ // Validate numeric parameters
130
+ if (args.page !== undefined && (args.page < 1 || !Number.isInteger(args.page))) {
131
+ errors.push('Page number must be a positive integer');
132
+ }
133
+ if (args.perPage !== undefined && (args.perPage < 1 || !Number.isInteger(args.perPage))) {
134
+ errors.push('Per page count must be a positive integer');
135
+ }
136
+ if (args.projectId !== undefined && (args.projectId < 1 || !Number.isInteger(args.projectId))) {
137
+ errors.push('Project ID must be a positive integer');
138
+ }
139
+ // Validate boolean parameters
140
+ if (args.done !== undefined && typeof args.done !== 'boolean') {
141
+ errors.push('Done parameter must be a boolean value');
142
+ }
143
+ // Validate string parameters
144
+ if (args.search !== undefined && typeof args.search !== 'string') {
145
+ errors.push('Search parameter must be a string');
146
+ }
147
+ if (args.sort !== undefined && typeof args.sort !== 'string') {
148
+ errors.push('Sort parameter must be a string');
149
+ }
150
+ if (args.filter !== undefined && typeof args.filter !== 'string') {
151
+ errors.push('Filter parameter must be a string');
152
+ }
153
+ if (args.filterId !== undefined && typeof args.filterId !== 'string') {
154
+ errors.push('Filter ID parameter must be a string');
155
+ }
156
+ return errors;
157
+ },
158
+ /**
159
+ * Performs comprehensive validation of task filtering parameters
160
+ */
161
+ async validateTaskFiltering(args, storage, _config = {}) {
162
+ const allWarnings = [];
163
+ // Validate basic arguments
164
+ const argValidationErrors = exports.FilterValidator.validateTaskListingArgs(args);
165
+ if (argValidationErrors.length > 0) {
166
+ throw new types_1.MCPError(types_1.ErrorCode.VALIDATION_ERROR, `Invalid task listing arguments: ${argValidationErrors.join(', ')}`);
167
+ }
168
+ // Validate and parse filter
169
+ const filterValidation = await exports.FilterValidator.validateAndParseFilter(args, storage);
170
+ allWarnings.push(...filterValidation.validationWarnings);
171
+ // Validate memory constraints
172
+ const pageSize = args.perPage || 1000; // Default pagination
173
+ const memoryValidation = exports.FilterValidator.validateMemoryConstraints(args, pageSize);
174
+ allWarnings.push(...memoryValidation.warnings);
175
+ return {
176
+ filterExpression: filterValidation.filterExpression,
177
+ filterString: filterValidation.filterString,
178
+ validationWarnings: allWarnings,
179
+ memoryValidation
180
+ };
181
+ },
182
+ };
183
+ //# sourceMappingURL=FilterValidator.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"FilterValidator.js","sourceRoot":"","sources":["../../../../src/tools/tasks/filtering/FilterValidator.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAKH,0CAAqD;AACrD,oDAA2D;AAC3D,kDAA+D;AAC/D,kDAA+C;AAE/C;;GAEG;AACU,QAAA,eAAe,GAAG;IAC7B;;OAEG;IACH,KAAK,CAAC,sBAAsB,CAC1B,IAAqB,EACrB,OAA0B;QAM1B,IAAI,gBAAgB,GAA4B,IAAI,CAAC;QACrD,IAAI,YAAgC,CAAC;QACrC,MAAM,kBAAkB,GAAa,EAAE,CAAC;QAExC,IAAI,CAAC;YACH,iEAAiE;YACjE,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;gBAClB,MAAM,WAAW,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;gBACrD,IAAI,CAAC,WAAW,EAAE,CAAC;oBACjB,MAAM,IAAI,gBAAQ,CAChB,iBAAS,CAAC,gBAAgB,EAC1B,kBAAkB,IAAI,CAAC,QAAQ,YAAY,CAC5C,CAAC;gBACJ,CAAC;gBACD,YAAY,GAAG,WAAW,CAAC,MAAM,CAAC;YACpC,CAAC;iBAAM,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;gBACrC,YAAY,GAAG,IAAI,CAAC,MAAM,CAAC;YAC7B,CAAC;YAED,oDAAoD;YACpD,IAAI,YAAY,EAAE,CAAC;gBACjB,MAAM,WAAW,GAAgB,IAAA,2BAAiB,EAAC,YAAY,CAAC,CAAC;gBACjE,IAAI,WAAW,CAAC,KAAK,EAAE,CAAC;oBACtB,MAAM,IAAI,gBAAQ,CAChB,iBAAS,CAAC,gBAAgB,EAC1B,0BAA0B,WAAW,CAAC,KAAK,CAAC,OAAO,GAAG,WAAW,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,WAAW,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAC1H,CAAC;gBACJ,CAAC;gBACD,gBAAgB,GAAG,WAAW,CAAC,UAAU,CAAC;gBAE1C,uDAAuD;gBACvD,eAAM,CAAC,IAAI,CAAC,yEAAyE,EAAE;oBACrF,MAAM,EAAE,YAAY;iBACrB,CAAC,CAAC;YACL,CAAC;YAED,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAE,kBAAkB,EAAE,CAAC;QAChE,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,KAAK,YAAY,gBAAQ,EAAE,CAAC;gBAC9B,MAAM,KAAK,CAAC;YACd,CAAC;YACD,MAAM,IAAI,gBAAQ,CAChB,iBAAS,CAAC,gBAAgB,EAC1B,6BAA6B,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CACtF,CAAC;QACJ,CAAC;IACH,CAAC;IAED;;OAEG;IACH,yBAAyB,CACvB,IAAqB,EACrB,iBAAyB;QAMzB,MAAM,QAAQ,GAAa,EAAE,CAAC;QAE9B,0EAA0E;QAC1E,MAAM,mBAAmB,GAAG,IAAA,+BAAsB,EAChD,iBAAiB,EACjB,SAAS,EACT,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;YACZ,gBAAgB,EAAE,IAAI,CAAC,MAAM;YAC7B,aAAa,EAAE,MAAM;SACtB,CAAC,CAAC,CAAC,SAAS,CACd,CAAC;QAEF,IAAI,CAAC,mBAAmB,CAAC,OAAO,EAAE,CAAC;YACjC,MAAM,IAAI,gBAAQ,CAChB,iBAAS,CAAC,gBAAgB,EAC1B,yCAAyC,iBAAiB,kBAAkB,mBAAmB,CAAC,UAAU,IAAI;gBAC9G,2BAA2B,mBAAmB,CAAC,iBAAiB,aAAa,mBAAmB,CAAC,SAAS,KAAK;gBAC/G,uGAAuG,CACxG,CAAC;QACJ,CAAC;QAED,oCAAoC;QACpC,IAAI,iBAAiB,GAAG,GAAG,EAAE,CAAC;YAC5B,QAAQ,CAAC,IAAI,CAAC,oBAAoB,iBAAiB,kFAAkF,CAAC,CAAC;QACzI,CAAC;QAED,8CAA8C;QAC9C,IAAI,mBAAmB,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC5C,QAAQ,CAAC,IAAI,CAAC,GAAG,mBAAmB,CAAC,QAAQ,CAAC,CAAC;QACjD,CAAC;QAED,OAAO;YACL,OAAO,EAAE,IAAI;YACb,QAAQ;YACR,UAAU,EAAE,mBAAmB,CAAC,UAAU;SAO3C,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,mBAAmB,CAAC,eAAuB,EAAE,UAAiB;QAO5D,MAAM,QAAQ,GAAa,EAAE,CAAC;QAC9B,MAAM,wBAAwB,GAAG,IAAA,+BAAsB,EAAC,eAAe,EAAE,UAAU,CAAC,CAAC;QAErF,IAAI,CAAC,wBAAwB,CAAC,OAAO,EAAE,CAAC;YACtC,4DAA4D;YAC5D,eAAM,CAAC,IAAI,CAAC,8CAA8C,EAAE;gBAC1D,WAAW,EAAE,eAAe;gBAC5B,cAAc,EAAE,wBAAwB,CAAC,UAAU;gBACnD,iBAAiB,EAAE,wBAAwB,CAAC,iBAAiB;gBAC7D,SAAS,EAAE,wBAAwB,CAAC,SAAS;aAC9C,CAAC,CAAC;YAEH,QAAQ,CAAC,IAAI,CACX,UAAU,eAAe,8CAA8C,wBAAwB,CAAC,UAAU,IAAI;gBAC9G,2BAA2B,wBAAwB,CAAC,iBAAiB,aAAa,wBAAwB,CAAC,SAAS,IAAI,CACzH,CAAC;YAEF,0DAA0D;YAC1D,IAAI,eAAe,GAAG,wBAAwB,CAAC,UAAU,GAAG,GAAG,EAAE,CAAC;gBAChE,OAAO;oBACL,OAAO,EAAE,KAAK;oBACd,QAAQ;oBACR,WAAW,EAAE,IAAI;oBACjB,SAAS,EAAE,wBAAwB,CAAC,SAAS;oBAC7C,iBAAiB,EAAE,wBAAwB,CAAC,iBAAiB;iBAC9D,CAAC;YACJ,CAAC;QACH,CAAC;QAED,4CAA4C;QAC5C,IAAI,wBAAwB,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACjD,QAAQ,CAAC,IAAI,CAAC,GAAG,wBAAwB,CAAC,QAAQ,CAAC,CAAC;QACtD,CAAC;QAED,OAAO;YACL,OAAO,EAAE,IAAI;YACb,QAAQ;YACR,WAAW,EAAE,KAAK;YAClB,SAAS,EAAE,wBAAwB,CAAC,SAAS;YAC7C,iBAAiB,EAAE,wBAAwB,CAAC,iBAAiB;SAC9D,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,uBAAuB,CAAC,IAAqB;QAC3C,MAAM,MAAM,GAAa,EAAE,CAAC;QAE5B,8BAA8B;QAC9B,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS,IAAI,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC;YAC/E,MAAM,CAAC,IAAI,CAAC,wCAAwC,CAAC,CAAC;QACxD,CAAC;QAED,IAAI,IAAI,CAAC,OAAO,KAAK,SAAS,IAAI,CAAC,IAAI,CAAC,OAAO,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC;YACxF,MAAM,CAAC,IAAI,CAAC,2CAA2C,CAAC,CAAC;QAC3D,CAAC;QAED,IAAI,IAAI,CAAC,SAAS,KAAK,SAAS,IAAI,CAAC,IAAI,CAAC,SAAS,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC;YAC9F,MAAM,CAAC,IAAI,CAAC,uCAAuC,CAAC,CAAC;QACvD,CAAC;QAED,8BAA8B;QAC9B,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS,IAAI,OAAO,IAAI,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;YAC9D,MAAM,CAAC,IAAI,CAAC,wCAAwC,CAAC,CAAC;QACxD,CAAC;QAED,6BAA6B;QAC7B,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS,IAAI,OAAO,IAAI,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;YACjE,MAAM,CAAC,IAAI,CAAC,mCAAmC,CAAC,CAAC;QACnD,CAAC;QAED,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS,IAAI,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YAC7D,MAAM,CAAC,IAAI,CAAC,iCAAiC,CAAC,CAAC;QACjD,CAAC;QAED,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS,IAAI,OAAO,IAAI,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;YACjE,MAAM,CAAC,IAAI,CAAC,mCAAmC,CAAC,CAAC;QACnD,CAAC;QAED,IAAI,IAAI,CAAC,QAAQ,KAAK,SAAS,IAAI,OAAO,IAAI,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;YACrE,MAAM,CAAC,IAAI,CAAC,sCAAsC,CAAC,CAAC;QACtD,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,qBAAqB,CACzB,IAAqB,EACrB,OAA0B,EAC1B,UAAsC,EAAE;QAWxC,MAAM,WAAW,GAAa,EAAE,CAAC;QAEjC,2BAA2B;QAC3B,MAAM,mBAAmB,GAAG,uBAAe,CAAC,uBAAuB,CAAC,IAAI,CAAC,CAAC;QAC1E,IAAI,mBAAmB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACnC,MAAM,IAAI,gBAAQ,CAChB,iBAAS,CAAC,gBAAgB,EAC1B,mCAAmC,mBAAmB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CACpE,CAAC;QACJ,CAAC;QAED,4BAA4B;QAC5B,MAAM,gBAAgB,GAAG,MAAM,uBAAe,CAAC,sBAAsB,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QACrF,WAAW,CAAC,IAAI,CAAC,GAAG,gBAAgB,CAAC,kBAAkB,CAAC,CAAC;QAEzD,8BAA8B;QAC9B,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,CAAC,qBAAqB;QAC5D,MAAM,gBAAgB,GAAG,uBAAe,CAAC,yBAAyB,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;QACnF,WAAW,CAAC,IAAI,CAAC,GAAG,gBAAgB,CAAC,QAAQ,CAAC,CAAC;QAE/C,OAAO;YACL,gBAAgB,EAAE,gBAAgB,CAAC,gBAAgB;YACnD,YAAY,EAAE,gBAAgB,CAAC,YAAY;YAC3C,kBAAkB,EAAE,WAAW;YAC/B,gBAAgB;SACjB,CAAC;IACJ,CAAC;CACF,CAAC"}
@@ -0,0 +1,75 @@
1
+ /**
2
+ * Task Filtering Orchestrator
3
+ * Main service that coordinates all filtering operations for tasks
4
+ */
5
+ import type { TaskListingArgs, TaskFilterExecutionResult } from '../types/filters';
6
+ import type { FilterValidationConfig } from '../../../types/filters';
7
+ import type { SimpleFilterStorage } from '../../../storage';
8
+ /**
9
+ * Main orchestrator for task filtering operations
10
+ * Coordinates validation, execution, and result processing
11
+ */
12
+ export declare const TaskFilteringOrchestrator: {
13
+ /**
14
+ * Executes the complete task filtering workflow
15
+ *
16
+ * @param args - Task listing arguments including filters
17
+ * @param storage - Storage interface for saved filters
18
+ * @param config - Optional validation configuration
19
+ * @returns Promise resolving to filtering result with metadata
20
+ */
21
+ executeTaskFiltering(args: TaskListingArgs, storage: SimpleFilterStorage, config?: FilterValidationConfig): Promise<TaskFilterExecutionResult>;
22
+ /**
23
+ * Validates task filtering parameters without executing the filtering
24
+ * Useful for pre-validation or UI validation scenarios
25
+ */
26
+ validateTaskFiltering(args: TaskListingArgs, storage: SimpleFilterStorage, config?: FilterValidationConfig): Promise<{
27
+ isValid: boolean;
28
+ warnings: string[];
29
+ errors: string[];
30
+ memoryValidation: {
31
+ isValid: boolean;
32
+ warnings: string[];
33
+ maxAllowed?: number;
34
+ };
35
+ }>;
36
+ /**
37
+ * Prepares filtering context information for debugging and monitoring
38
+ */
39
+ createFilteringContext(args: TaskListingArgs, result: TaskFilterExecutionResult): {
40
+ input: {
41
+ hasFilter: boolean;
42
+ hasFilterId: boolean;
43
+ projectId?: number;
44
+ page?: number;
45
+ perPage?: number;
46
+ search?: string;
47
+ sort?: string;
48
+ };
49
+ output: {
50
+ taskCount: number;
51
+ serverSideFilteringUsed: boolean;
52
+ serverSideFilteringAttempted: boolean;
53
+ clientSideFiltering: boolean;
54
+ filteringNote: string;
55
+ memoryInfo?: {
56
+ actualCount: number;
57
+ maxAllowed: number;
58
+ estimatedMemoryMB: number;
59
+ };
60
+ };
61
+ performance: {
62
+ timestamp: string;
63
+ processingTimeMs?: number;
64
+ };
65
+ };
66
+ /**
67
+ * Analyzes filtering performance and provides recommendations
68
+ */
69
+ analyzeFilteringPerformance(args: TaskListingArgs, result: TaskFilterExecutionResult): {
70
+ isOptimal: boolean;
71
+ recommendations: string[];
72
+ issues: string[];
73
+ };
74
+ };
75
+ //# sourceMappingURL=TaskFilteringOrchestrator.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"TaskFilteringOrchestrator.d.ts","sourceRoot":"","sources":["../../../../src/tools/tasks/filtering/TaskFilteringOrchestrator.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,yBAAyB,EAAE,MAAM,kBAAkB,CAAC;AACnF,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAKrE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAE5D;;;GAGG;AACH,eAAO,MAAM,yBAAyB;IACpC;;;;;;;OAOG;+BAEK,eAAe,WACZ,mBAAmB,WACpB,sBAAsB,GAC7B,OAAO,CAAC,yBAAyB,CAAC;IA0ErC;;;OAGG;gCAEK,eAAe,WACZ,mBAAmB,WACpB,sBAAsB,GAC7B,OAAO,CAAC;QACT,OAAO,EAAE,OAAO,CAAC;QACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;QACnB,MAAM,EAAE,MAAM,EAAE,CAAC;QACjB,gBAAgB,EAAE;YAChB,OAAO,EAAE,OAAO,CAAC;YACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;YACnB,UAAU,CAAC,EAAE,MAAM,CAAC;SACrB,CAAC;KACH,CAAC;IA8BF;;OAEG;iCAEK,eAAe,UACb,yBAAyB,GAChC;QACD,KAAK,EAAE;YACL,SAAS,EAAE,OAAO,CAAC;YACnB,WAAW,EAAE,OAAO,CAAC;YACrB,SAAS,CAAC,EAAE,MAAM,CAAC;YACnB,IAAI,CAAC,EAAE,MAAM,CAAC;YACd,OAAO,CAAC,EAAE,MAAM,CAAC;YACjB,MAAM,CAAC,EAAE,MAAM,CAAC;YAChB,IAAI,CAAC,EAAE,MAAM,CAAC;SACf,CAAC;QACF,MAAM,EAAE;YACN,SAAS,EAAE,MAAM,CAAC;YAClB,uBAAuB,EAAE,OAAO,CAAC;YACjC,4BAA4B,EAAE,OAAO,CAAC;YACtC,mBAAmB,EAAE,OAAO,CAAC;YAC7B,aAAa,EAAE,MAAM,CAAC;YACtB,UAAU,CAAC,EAAE;gBACX,WAAW,EAAE,MAAM,CAAC;gBACpB,UAAU,EAAE,MAAM,CAAC;gBACnB,iBAAiB,EAAE,MAAM,CAAC;aAC3B,CAAC;SACH,CAAC;QACF,WAAW,EAAE;YACX,SAAS,EAAE,MAAM,CAAC;YAClB,gBAAgB,CAAC,EAAE,MAAM,CAAC;SAC3B,CAAC;KACH;IAmED;;OAEG;sCAEK,eAAe,UACb,yBAAyB,GAChC;QACD,SAAS,EAAE,OAAO,CAAC;QACnB,eAAe,EAAE,MAAM,EAAE,CAAC;QAC1B,MAAM,EAAE,MAAM,EAAE,CAAC;KAClB;CAyCF,CAAC"}