@forumviriumhelsinki/podio-mcp 2.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 (197) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +491 -0
  3. package/build/__tests__/integration/setup.integration.d.ts +104 -0
  4. package/build/__tests__/integration/setup.integration.d.ts.map +1 -0
  5. package/build/__tests__/integration/setup.integration.js +233 -0
  6. package/build/__tests__/integration/setup.integration.js.map +1 -0
  7. package/build/__tests__/mock-data/items-mock-data.d.ts +168 -0
  8. package/build/__tests__/mock-data/items-mock-data.d.ts.map +1 -0
  9. package/build/__tests__/mock-data/items-mock-data.js +370 -0
  10. package/build/__tests__/mock-data/items-mock-data.js.map +1 -0
  11. package/build/__tests__/mock-data/notification-mock-data.d.ts +55 -0
  12. package/build/__tests__/mock-data/notification-mock-data.d.ts.map +1 -0
  13. package/build/__tests__/mock-data/notification-mock-data.js +190 -0
  14. package/build/__tests__/mock-data/notification-mock-data.js.map +1 -0
  15. package/build/__tests__/mock-data/project-epic-mock-data.d.ts +45 -0
  16. package/build/__tests__/mock-data/project-epic-mock-data.d.ts.map +1 -0
  17. package/build/__tests__/mock-data/project-epic-mock-data.js +85 -0
  18. package/build/__tests__/mock-data/project-epic-mock-data.js.map +1 -0
  19. package/build/__tests__/mock-data/tasks-mock-data.d.ts +27 -0
  20. package/build/__tests__/mock-data/tasks-mock-data.d.ts.map +1 -0
  21. package/build/__tests__/mock-data/tasks-mock-data.js +104 -0
  22. package/build/__tests__/mock-data/tasks-mock-data.js.map +1 -0
  23. package/build/__tests__/mock-data/utility-mock-data.d.ts +19 -0
  24. package/build/__tests__/mock-data/utility-mock-data.d.ts.map +1 -0
  25. package/build/__tests__/mock-data/utility-mock-data.js +165 -0
  26. package/build/__tests__/mock-data/utility-mock-data.js.map +1 -0
  27. package/build/__tests__/setup.d.ts +8 -0
  28. package/build/__tests__/setup.d.ts.map +1 -0
  29. package/build/__tests__/setup.js +31 -0
  30. package/build/__tests__/setup.js.map +1 -0
  31. package/build/__tests__/utils/test-helpers.d.ts +110 -0
  32. package/build/__tests__/utils/test-helpers.d.ts.map +1 -0
  33. package/build/__tests__/utils/test-helpers.js +222 -0
  34. package/build/__tests__/utils/test-helpers.js.map +1 -0
  35. package/build/api/podio-api-client.d.ts +364 -0
  36. package/build/api/podio-api-client.d.ts.map +1 -0
  37. package/build/api/podio-api-client.js +696 -0
  38. package/build/api/podio-api-client.js.map +1 -0
  39. package/build/cache/app-cache.d.ts +77 -0
  40. package/build/cache/app-cache.d.ts.map +1 -0
  41. package/build/cache/app-cache.js +230 -0
  42. package/build/cache/app-cache.js.map +1 -0
  43. package/build/cache/base-cache-manager.d.ts +149 -0
  44. package/build/cache/base-cache-manager.d.ts.map +1 -0
  45. package/build/cache/base-cache-manager.js +312 -0
  46. package/build/cache/base-cache-manager.js.map +1 -0
  47. package/build/cache/cache-manager.d.ts +230 -0
  48. package/build/cache/cache-manager.d.ts.map +1 -0
  49. package/build/cache/cache-manager.js +362 -0
  50. package/build/cache/cache-manager.js.map +1 -0
  51. package/build/cache/cache-test.d.ts +9 -0
  52. package/build/cache/cache-test.d.ts.map +1 -0
  53. package/build/cache/cache-test.js +169 -0
  54. package/build/cache/cache-test.js.map +1 -0
  55. package/build/cache/index.d.ts +18 -0
  56. package/build/cache/index.d.ts.map +1 -0
  57. package/build/cache/index.js +20 -0
  58. package/build/cache/index.js.map +1 -0
  59. package/build/cache/migration-helper.d.ts +44 -0
  60. package/build/cache/migration-helper.d.ts.map +1 -0
  61. package/build/cache/migration-helper.js +235 -0
  62. package/build/cache/migration-helper.js.map +1 -0
  63. package/build/cache/project-epic-cache.d.ts +108 -0
  64. package/build/cache/project-epic-cache.d.ts.map +1 -0
  65. package/build/cache/project-epic-cache.js +278 -0
  66. package/build/cache/project-epic-cache.js.map +1 -0
  67. package/build/cache/space-members-cache.d.ts +99 -0
  68. package/build/cache/space-members-cache.d.ts.map +1 -0
  69. package/build/cache/space-members-cache.js +305 -0
  70. package/build/cache/space-members-cache.js.map +1 -0
  71. package/build/cache/storage-adapters.d.ts +100 -0
  72. package/build/cache/storage-adapters.d.ts.map +1 -0
  73. package/build/cache/storage-adapters.js +297 -0
  74. package/build/cache/storage-adapters.js.map +1 -0
  75. package/build/errors/api-errors.d.ts +52 -0
  76. package/build/errors/api-errors.d.ts.map +1 -0
  77. package/build/errors/api-errors.js +86 -0
  78. package/build/errors/api-errors.js.map +1 -0
  79. package/build/errors/auth-errors.d.ts +67 -0
  80. package/build/errors/auth-errors.d.ts.map +1 -0
  81. package/build/errors/auth-errors.js +114 -0
  82. package/build/errors/auth-errors.js.map +1 -0
  83. package/build/errors/base.d.ts +102 -0
  84. package/build/errors/base.d.ts.map +1 -0
  85. package/build/errors/base.js +131 -0
  86. package/build/errors/base.js.map +1 -0
  87. package/build/errors/cache-errors.d.ts +53 -0
  88. package/build/errors/cache-errors.d.ts.map +1 -0
  89. package/build/errors/cache-errors.js +83 -0
  90. package/build/errors/cache-errors.js.map +1 -0
  91. package/build/errors/config-errors.d.ts +58 -0
  92. package/build/errors/config-errors.d.ts.map +1 -0
  93. package/build/errors/config-errors.js +96 -0
  94. package/build/errors/config-errors.js.map +1 -0
  95. package/build/errors/index.d.ts +101 -0
  96. package/build/errors/index.d.ts.map +1 -0
  97. package/build/errors/index.js +135 -0
  98. package/build/errors/index.js.map +1 -0
  99. package/build/errors/structure-errors.d.ts +89 -0
  100. package/build/errors/structure-errors.d.ts.map +1 -0
  101. package/build/errors/structure-errors.js +182 -0
  102. package/build/errors/structure-errors.js.map +1 -0
  103. package/build/errors/validation-errors.d.ts +81 -0
  104. package/build/errors/validation-errors.d.ts.map +1 -0
  105. package/build/errors/validation-errors.js +169 -0
  106. package/build/errors/validation-errors.js.map +1 -0
  107. package/build/fields/field-mapper.d.ts +245 -0
  108. package/build/fields/field-mapper.d.ts.map +1 -0
  109. package/build/fields/field-mapper.js +404 -0
  110. package/build/fields/field-mapper.js.map +1 -0
  111. package/build/index.d.ts +550 -0
  112. package/build/index.d.ts.map +1 -0
  113. package/build/index.js +1527 -0
  114. package/build/index.js.map +1 -0
  115. package/build/oauth-helper.d.ts +189 -0
  116. package/build/oauth-helper.d.ts.map +1 -0
  117. package/build/oauth-helper.js +422 -0
  118. package/build/oauth-helper.js.map +1 -0
  119. package/build/services/app-structure-service.d.ts +49 -0
  120. package/build/services/app-structure-service.d.ts.map +1 -0
  121. package/build/services/app-structure-service.js +122 -0
  122. package/build/services/app-structure-service.js.map +1 -0
  123. package/build/services/code-execution-service.d.ts +88 -0
  124. package/build/services/code-execution-service.d.ts.map +1 -0
  125. package/build/services/code-execution-service.js +342 -0
  126. package/build/services/code-execution-service.js.map +1 -0
  127. package/build/services/comment-service.d.ts +66 -0
  128. package/build/services/comment-service.d.ts.map +1 -0
  129. package/build/services/comment-service.js +139 -0
  130. package/build/services/comment-service.js.map +1 -0
  131. package/build/services/index.d.ts +16 -0
  132. package/build/services/index.d.ts.map +1 -0
  133. package/build/services/index.js +15 -0
  134. package/build/services/index.js.map +1 -0
  135. package/build/services/item-service.d.ts +104 -0
  136. package/build/services/item-service.d.ts.map +1 -0
  137. package/build/services/item-service.js +368 -0
  138. package/build/services/item-service.js.map +1 -0
  139. package/build/services/notification-service.d.ts +125 -0
  140. package/build/services/notification-service.d.ts.map +1 -0
  141. package/build/services/notification-service.js +321 -0
  142. package/build/services/notification-service.js.map +1 -0
  143. package/build/services/project-epic-service.d.ts +73 -0
  144. package/build/services/project-epic-service.d.ts.map +1 -0
  145. package/build/services/project-epic-service.js +248 -0
  146. package/build/services/project-epic-service.js.map +1 -0
  147. package/build/services/response-formatter.d.ts +190 -0
  148. package/build/services/response-formatter.d.ts.map +1 -0
  149. package/build/services/response-formatter.js +1221 -0
  150. package/build/services/response-formatter.js.map +1 -0
  151. package/build/services/search-service.d.ts +103 -0
  152. package/build/services/search-service.d.ts.map +1 -0
  153. package/build/services/search-service.js +273 -0
  154. package/build/services/search-service.js.map +1 -0
  155. package/build/services/task-service.d.ts +70 -0
  156. package/build/services/task-service.d.ts.map +1 -0
  157. package/build/services/task-service.js +156 -0
  158. package/build/services/task-service.js.map +1 -0
  159. package/build/tools/index.d.ts +8 -0
  160. package/build/tools/index.d.ts.map +1 -0
  161. package/build/tools/index.js +8 -0
  162. package/build/tools/index.js.map +1 -0
  163. package/build/tools/tool-definitions.d.ts +89 -0
  164. package/build/tools/tool-definitions.d.ts.map +1 -0
  165. package/build/tools/tool-definitions.js +1167 -0
  166. package/build/tools/tool-definitions.js.map +1 -0
  167. package/build/types/api-types.d.ts +106 -0
  168. package/build/types/api-types.d.ts.map +1 -0
  169. package/build/types/api-types.js +11 -0
  170. package/build/types/api-types.js.map +1 -0
  171. package/build/types/cache-types.d.ts +52 -0
  172. package/build/types/cache-types.d.ts.map +1 -0
  173. package/build/types/cache-types.js +12 -0
  174. package/build/types/cache-types.js.map +1 -0
  175. package/build/types/index.d.ts +31 -0
  176. package/build/types/index.d.ts.map +1 -0
  177. package/build/types/index.js +25 -0
  178. package/build/types/index.js.map +1 -0
  179. package/build/types/notification-types.d.ts +154 -0
  180. package/build/types/notification-types.d.ts.map +1 -0
  181. package/build/types/notification-types.js +7 -0
  182. package/build/types/notification-types.js.map +1 -0
  183. package/build/types/podio-types.d.ts +250 -0
  184. package/build/types/podio-types.d.ts.map +1 -0
  185. package/build/types/podio-types.js +11 -0
  186. package/build/types/podio-types.js.map +1 -0
  187. package/build/types/search-types.d.ts +188 -0
  188. package/build/types/search-types.d.ts.map +1 -0
  189. package/build/types/search-types.js +43 -0
  190. package/build/types/search-types.js.map +1 -0
  191. package/build/utils/debug.d.ts +58 -0
  192. package/build/utils/debug.d.ts.map +1 -0
  193. package/build/utils/debug.js +147 -0
  194. package/build/utils/debug.js.map +1 -0
  195. package/examples/claude-config-example.json +13 -0
  196. package/package.json +87 -0
  197. package/scripts/generate-claude-config.js +107 -0
@@ -0,0 +1,16 @@
1
+ /**
2
+ * @fileoverview Service Layer Index
3
+ *
4
+ * This module exports all service classes for easy importing throughout the application.
5
+ */
6
+ export { ResponseFormatter } from './response-formatter.js';
7
+ export { ItemService } from './item-service.js';
8
+ export { TaskService } from './task-service.js';
9
+ export { ProjectEpicService } from './project-epic-service.js';
10
+ export { AppStructureService } from './app-structure-service.js';
11
+ export { NotificationService } from './notification-service.js';
12
+ export { SearchService } from './search-service.js';
13
+ export { CommentService } from './comment-service.js';
14
+ export { CodeExecutionService } from './code-execution-service.js';
15
+ export type { CodeExecutionResult, CodeExecutionOptions } from './code-execution-service.js';
16
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/services/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAChE,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACnE,YAAY,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC"}
@@ -0,0 +1,15 @@
1
+ /**
2
+ * @fileoverview Service Layer Index
3
+ *
4
+ * This module exports all service classes for easy importing throughout the application.
5
+ */
6
+ export { ResponseFormatter } from './response-formatter.js';
7
+ export { ItemService } from './item-service.js';
8
+ export { TaskService } from './task-service.js';
9
+ export { ProjectEpicService } from './project-epic-service.js';
10
+ export { AppStructureService } from './app-structure-service.js';
11
+ export { NotificationService } from './notification-service.js';
12
+ export { SearchService } from './search-service.js';
13
+ export { CommentService } from './comment-service.js';
14
+ export { CodeExecutionService } from './code-execution-service.js';
15
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/services/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAChE,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC"}
@@ -0,0 +1,104 @@
1
+ /**
2
+ * @fileoverview Item Service
3
+ *
4
+ * This service handles all item-related operations including CRUD operations,
5
+ * field payload building, and data transformation.
6
+ */
7
+ import type { PodioApiClient } from '../api/podio-api-client.js';
8
+ import type { FieldMapper } from '../fields/field-mapper.js';
9
+ import type { CacheManager } from '../cache/cache-manager.js';
10
+ import type { PodioItem, AppCoordinates, PodioItemRevision, PodioItemRevisionDiff } from '../types/index.js';
11
+ /**
12
+ * Service class for handling item operations.
13
+ *
14
+ * This class encapsulates all item-related business logic and coordinates
15
+ * between the API client, field mapper, and cache manager.
16
+ */
17
+ export declare class ItemService {
18
+ private readonly apiClient;
19
+ private readonly cacheManager;
20
+ constructor(apiClient: PodioApiClient, cacheManager: CacheManager);
21
+ /**
22
+ * List items with optional filtering
23
+ */
24
+ listItems(appId: number, fieldMapper: FieldMapper, filters?: {
25
+ status_filter?: string;
26
+ responsible_filter?: string;
27
+ limit?: number;
28
+ }, coordinates?: AppCoordinates): Promise<{
29
+ items: PodioItem[];
30
+ filteredItems: PodioItem[];
31
+ }>;
32
+ /**
33
+ * Create a new item
34
+ */
35
+ createItem(appId: number, fieldMapper: FieldMapper, itemData: {
36
+ title?: string;
37
+ description?: string;
38
+ status?: string;
39
+ responsible?: string;
40
+ project?: string;
41
+ epic?: string;
42
+ }, coordinates?: AppCoordinates): Promise<PodioItem>;
43
+ /**
44
+ * Update an existing item
45
+ */
46
+ updateItem(itemId: number, fieldMapper: FieldMapper, updateData: {
47
+ title?: string;
48
+ description?: string;
49
+ status?: string;
50
+ responsible?: string;
51
+ project?: string;
52
+ epic?: string;
53
+ }, appId?: number, coordinates?: AppCoordinates): Promise<void>;
54
+ /**
55
+ * Delete an item
56
+ */
57
+ deleteItem(itemId: number): Promise<void>;
58
+ /**
59
+ * Get item details by ID
60
+ */
61
+ getItem(itemId: number): Promise<PodioItem>;
62
+ /**
63
+ * Get item details by app-specific item ID
64
+ */
65
+ getItemByAppItemId(appId: number, appItemId: number): Promise<PodioItem>;
66
+ /**
67
+ * Get all activity/revisions for a specific item
68
+ *
69
+ * @param itemId - ID of the item to get activity for
70
+ * @returns Array of item revisions showing activity history
71
+ */
72
+ getItemActivity(itemId: number): Promise<PodioItemRevision[]>;
73
+ /**
74
+ * Get details of a specific item revision
75
+ *
76
+ * @param itemId - ID of the item
77
+ * @param revisionId - ID of the revision to get
78
+ * @returns Specific revision details
79
+ */
80
+ getItemRevision(itemId: number, revisionId: number): Promise<PodioItemRevision>;
81
+ /**
82
+ * Get the difference between two item revisions
83
+ *
84
+ * @param itemId - ID of the item
85
+ * @param fromRevision - Starting revision number
86
+ * @param toRevision - Ending revision number
87
+ * @returns Difference between the two revisions
88
+ */
89
+ getItemRevisionDiff(itemId: number, fromRevision: number, toRevision: number): Promise<PodioItemRevisionDiff>;
90
+ /**
91
+ * Resolve user by name or email to user ID
92
+ */
93
+ private resolveUser;
94
+ /**
95
+ * Resolve project or epic by name to item ID
96
+ * This method ensures the cache is populated before searching
97
+ */
98
+ private resolveProjectEpic;
99
+ /**
100
+ * Populate project or epic cache by fetching from referenced app
101
+ */
102
+ private populateProjectEpicCache;
103
+ }
104
+ //# sourceMappingURL=item-service.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"item-service.d.ts","sourceRoot":"","sources":["../../src/services/item-service.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAC7D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,KAAK,EACV,SAAS,EACT,cAAc,EACd,iBAAiB,EACjB,qBAAqB,EACtB,MAAM,mBAAmB,CAAC;AAG3B;;;;;GAKG;AACH,qBAAa,WAAW;IAEpB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,YAAY;gBADZ,SAAS,EAAE,cAAc,EACzB,YAAY,EAAE,YAAY;IAG7C;;OAEG;IACG,SAAS,CACb,KAAK,EAAE,MAAM,EACb,WAAW,EAAE,WAAW,EACxB,OAAO,GAAE;QACP,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,kBAAkB,CAAC,EAAE,MAAM,CAAC;QAC5B,KAAK,CAAC,EAAE,MAAM,CAAC;KACX,EACN,WAAW,CAAC,EAAE,cAAc,GAC3B,OAAO,CAAC;QAAE,KAAK,EAAE,SAAS,EAAE,CAAC;QAAC,aAAa,EAAE,SAAS,EAAE,CAAA;KAAE,CAAC;IA8C9D;;OAEG;IACG,UAAU,CACd,KAAK,EAAE,MAAM,EACb,WAAW,EAAE,WAAW,EACxB,QAAQ,EAAE;QACR,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,IAAI,CAAC,EAAE,MAAM,CAAC;KACf,EACD,WAAW,CAAC,EAAE,cAAc,GAC3B,OAAO,CAAC,SAAS,CAAC;IA6DrB;;OAEG;IACG,UAAU,CACd,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,WAAW,EACxB,UAAU,EAAE;QACV,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,IAAI,CAAC,EAAE,MAAM,CAAC;KACf,EACD,KAAK,CAAC,EAAE,MAAM,EACd,WAAW,CAAC,EAAE,cAAc,GAC3B,OAAO,CAAC,IAAI,CAAC;IAsEhB;;OAEG;IACG,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI/C;;OAEG;IACG,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC;IAIjD;;OAEG;IACG,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC;IAQ9E;;;;;OAKG;IACG,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAYnE;;;;;;OAMG;IACG,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAgBrF;;;;;;;OAOG;IACG,mBAAmB,CACvB,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,MAAM,EACpB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,qBAAqB,CAAC;IAgCjC;;OAEG;YACW,WAAW;IAOzB;;;OAGG;YACW,kBAAkB;IAiEhC;;OAEG;YACW,wBAAwB;CAuCvC"}
@@ -0,0 +1,368 @@
1
+ /**
2
+ * @fileoverview Item Service
3
+ *
4
+ * This service handles all item-related operations including CRUD operations,
5
+ * field payload building, and data transformation.
6
+ */
7
+ import { PodioValidationError, PodioErrorFactory, isPodioApiError } from '../errors/index.js';
8
+ /**
9
+ * Service class for handling item operations.
10
+ *
11
+ * This class encapsulates all item-related business logic and coordinates
12
+ * between the API client, field mapper, and cache manager.
13
+ */
14
+ export class ItemService {
15
+ apiClient;
16
+ cacheManager;
17
+ constructor(apiClient, cacheManager) {
18
+ this.apiClient = apiClient;
19
+ this.cacheManager = cacheManager;
20
+ }
21
+ /**
22
+ * List items with optional filtering
23
+ */
24
+ async listItems(appId, fieldMapper, filters = {}, coordinates) {
25
+ const { status_filter, responsible_filter, limit = 20 } = filters;
26
+ try {
27
+ // Build filters using FieldMapper
28
+ const apiFilters = {};
29
+ if (status_filter) {
30
+ const statusField = fieldMapper.findField('status');
31
+ if (statusField?.type === 'category' && statusField.config?.settings?.options) {
32
+ const statusOption = statusField.config.settings.options.find((opt) => opt.text.toLowerCase() === status_filter.toLowerCase());
33
+ if (statusOption) {
34
+ const fieldKey = fieldMapper.getFieldKey(statusField);
35
+ apiFilters[fieldKey] = [statusOption.id];
36
+ }
37
+ }
38
+ }
39
+ // Use API client to fetch items
40
+ const response = await this.apiClient.filterItems(appId, apiFilters, limit);
41
+ const items = response.items;
42
+ // Apply client-side responsible filter if needed
43
+ // Note: extractContactProperty joins multiple assignees with "; " separator,
44
+ // and we use substring matching, so "Lauri Gates" will match an item with
45
+ // Responsible: "Lauri Gates; Juhani Kantola" (Issue #51)
46
+ let filteredItems = items;
47
+ if (responsible_filter) {
48
+ filteredItems = items.filter((item) => {
49
+ const responsibleName = fieldMapper.extractContactProperty(item, 'Responsible', 'name');
50
+ return responsibleName.toLowerCase().includes(responsible_filter.toLowerCase());
51
+ });
52
+ }
53
+ return { items, filteredItems };
54
+ }
55
+ catch (error) {
56
+ if (isPodioApiError(error) && coordinates) {
57
+ await this.cacheManager.handleApiErrorWithCacheRefresh(error, coordinates, 'list items');
58
+ }
59
+ throw error;
60
+ }
61
+ }
62
+ /**
63
+ * Create a new item
64
+ */
65
+ async createItem(appId, fieldMapper, itemData, coordinates) {
66
+ const { title, description, status, responsible, project, epic } = itemData;
67
+ try {
68
+ // Build field payload using FieldMapper
69
+ const payload = fieldMapper.createPayload();
70
+ // Add title (required)
71
+ if (title) {
72
+ fieldMapper.addTextField(payload, 'title', title, { validateField: false });
73
+ }
74
+ // Add description
75
+ if (description) {
76
+ fieldMapper.addTextField(payload, 'description', description, { validateField: false });
77
+ }
78
+ // Add status
79
+ if (status) {
80
+ fieldMapper.addCategoryField(payload, 'status', status, { validateField: false });
81
+ }
82
+ // Add responsible person
83
+ if (responsible) {
84
+ const userId = await this.resolveUser(responsible);
85
+ if (userId) {
86
+ fieldMapper.addContactField(payload, 'responsible', userId, { validateField: false });
87
+ }
88
+ }
89
+ // Add project/epic references
90
+ if (project) {
91
+ const projectId = await this.resolveProjectEpic('project', project, appId, fieldMapper);
92
+ if (projectId) {
93
+ fieldMapper.addAppReferenceField(payload, 'project', projectId, { validateField: false });
94
+ }
95
+ else {
96
+ console.warn(`[ItemService] Warning: Could not find project "${project}" in referenced app`);
97
+ }
98
+ }
99
+ if (epic) {
100
+ const epicId = await this.resolveProjectEpic('epic', epic, appId, fieldMapper);
101
+ if (epicId) {
102
+ fieldMapper.addAppReferenceField(payload, 'epic', epicId, { validateField: false });
103
+ }
104
+ else {
105
+ console.warn(`[ItemService] Warning: Could not find epic "${epic}" in referenced app`);
106
+ }
107
+ }
108
+ // Create item via API client
109
+ return await this.apiClient.createItem(appId, payload);
110
+ }
111
+ catch (error) {
112
+ if (isPodioApiError(error) && coordinates) {
113
+ await this.cacheManager.handleApiErrorWithCacheRefresh(error, coordinates, 'create item');
114
+ }
115
+ throw error;
116
+ }
117
+ }
118
+ /**
119
+ * Update an existing item
120
+ */
121
+ async updateItem(itemId, fieldMapper, updateData, appId, coordinates) {
122
+ const { title, description, status, responsible, project, epic } = updateData;
123
+ try {
124
+ // Build field payload using FieldMapper
125
+ const payload = fieldMapper.createPayload();
126
+ let hasUpdates = false;
127
+ // Update title
128
+ if (title) {
129
+ fieldMapper.addTextField(payload, 'title', title, { validateField: false });
130
+ hasUpdates = true;
131
+ }
132
+ // Update description
133
+ if (description) {
134
+ fieldMapper.addTextField(payload, 'description', description, { validateField: false });
135
+ hasUpdates = true;
136
+ }
137
+ // Update status
138
+ if (status) {
139
+ fieldMapper.addCategoryField(payload, 'status', status, { validateField: false });
140
+ hasUpdates = true;
141
+ }
142
+ // Update responsible person
143
+ if (responsible) {
144
+ const userId = await this.resolveUser(responsible);
145
+ if (userId) {
146
+ fieldMapper.addContactField(payload, 'responsible', userId, { validateField: false });
147
+ hasUpdates = true;
148
+ }
149
+ }
150
+ // Update project/epic references
151
+ if (project) {
152
+ const projectId = await this.resolveProjectEpic('project', project, appId, fieldMapper);
153
+ if (projectId) {
154
+ fieldMapper.addAppReferenceField(payload, 'project', projectId, { validateField: false });
155
+ hasUpdates = true;
156
+ }
157
+ }
158
+ if (epic) {
159
+ const epicId = await this.resolveProjectEpic('epic', epic, appId, fieldMapper);
160
+ if (epicId) {
161
+ fieldMapper.addAppReferenceField(payload, 'epic', epicId, { validateField: false });
162
+ hasUpdates = true;
163
+ }
164
+ }
165
+ if (!hasUpdates) {
166
+ throw PodioValidationError.invalidFieldValue('No fields', 'provided for update', 'At least one field must be provided');
167
+ }
168
+ // Update item via API client
169
+ await this.apiClient.updateItem(itemId, payload);
170
+ }
171
+ catch (error) {
172
+ if (isPodioApiError(error) && coordinates) {
173
+ await this.cacheManager.handleApiErrorWithCacheRefresh(error, coordinates, 'update item');
174
+ }
175
+ throw error;
176
+ }
177
+ }
178
+ /**
179
+ * Delete an item
180
+ */
181
+ async deleteItem(itemId) {
182
+ await this.apiClient.deleteItem(itemId);
183
+ }
184
+ /**
185
+ * Get item details by ID
186
+ */
187
+ async getItem(itemId) {
188
+ return await this.apiClient.getItem(itemId);
189
+ }
190
+ /**
191
+ * Get item details by app-specific item ID
192
+ */
193
+ async getItemByAppItemId(appId, appItemId) {
194
+ return await this.apiClient.getItemByAppItemId(appId, appItemId);
195
+ }
196
+ // ===============================
197
+ // ITEM ACTIVITY METHODS
198
+ // ===============================
199
+ /**
200
+ * Get all activity/revisions for a specific item
201
+ *
202
+ * @param itemId - ID of the item to get activity for
203
+ * @returns Array of item revisions showing activity history
204
+ */
205
+ async getItemActivity(itemId) {
206
+ if (!itemId || itemId <= 0) {
207
+ throw PodioValidationError.requiredField('item_id', 'get item activity');
208
+ }
209
+ try {
210
+ return await this.apiClient.getItemRevisions(itemId);
211
+ }
212
+ catch (error) {
213
+ throw PodioErrorFactory.apiCallFailed('get item activity', error);
214
+ }
215
+ }
216
+ /**
217
+ * Get details of a specific item revision
218
+ *
219
+ * @param itemId - ID of the item
220
+ * @param revisionId - ID of the revision to get
221
+ * @returns Specific revision details
222
+ */
223
+ async getItemRevision(itemId, revisionId) {
224
+ if (!itemId || itemId <= 0) {
225
+ throw PodioValidationError.requiredField('item_id', 'get item revision');
226
+ }
227
+ if (!revisionId || revisionId <= 0) {
228
+ throw PodioValidationError.requiredField('revision_id', 'get item revision');
229
+ }
230
+ try {
231
+ return await this.apiClient.getItemRevision(itemId, revisionId);
232
+ }
233
+ catch (error) {
234
+ throw PodioErrorFactory.apiCallFailed('get item revision', error);
235
+ }
236
+ }
237
+ /**
238
+ * Get the difference between two item revisions
239
+ *
240
+ * @param itemId - ID of the item
241
+ * @param fromRevision - Starting revision number
242
+ * @param toRevision - Ending revision number
243
+ * @returns Difference between the two revisions
244
+ */
245
+ async getItemRevisionDiff(itemId, fromRevision, toRevision) {
246
+ if (!itemId || itemId <= 0) {
247
+ throw PodioValidationError.requiredField('item_id', 'get item revision diff');
248
+ }
249
+ if (!fromRevision || fromRevision <= 0) {
250
+ throw PodioValidationError.requiredField('from_revision', 'get item revision diff');
251
+ }
252
+ if (!toRevision || toRevision <= 0) {
253
+ throw PodioValidationError.requiredField('to_revision', 'get item revision diff');
254
+ }
255
+ if (fromRevision >= toRevision) {
256
+ throw PodioValidationError.invalidFieldValue('revision range', `from_revision (${fromRevision}) >= to_revision (${toRevision})`, 'from_revision must be less than to_revision');
257
+ }
258
+ try {
259
+ return await this.apiClient.getItemRevisionDiff(itemId, fromRevision, toRevision);
260
+ }
261
+ catch (error) {
262
+ throw PodioErrorFactory.apiCallFailed('get item revision diff', error);
263
+ }
264
+ }
265
+ // ===============================
266
+ // HELPER METHODS
267
+ // ===============================
268
+ /**
269
+ * Resolve user by name or email to user ID
270
+ */
271
+ async resolveUser(nameOrEmail) {
272
+ // This would need access to space ID - we'll pass it through in a future refactor
273
+ // For now, delegate to cache manager's method
274
+ const user = await this.cacheManager.findUser(nameOrEmail);
275
+ return user ? user.member.user.user_id : null;
276
+ }
277
+ /**
278
+ * Resolve project or epic by name to item ID
279
+ * This method ensures the cache is populated before searching
280
+ */
281
+ async resolveProjectEpic(type, name, appId, fieldMapper) {
282
+ if (!appId) {
283
+ return null;
284
+ }
285
+ // Check if cache has any items at all for this app
286
+ const allCachedItems = type === 'project'
287
+ ? await this.cacheManager.getProjects(appId)
288
+ : await this.cacheManager.getEpics(appId);
289
+ // If cache is empty and we have fieldMapper, populate it
290
+ if ((!allCachedItems || allCachedItems.length === 0) && fieldMapper) {
291
+ // Fetch items from referenced app
292
+ const field = fieldMapper.findField(type);
293
+ if (field && field.type === 'app') {
294
+ const referencedApp = field.config?.referenced_apps?.[0];
295
+ if (referencedApp) {
296
+ try {
297
+ const response = await this.apiClient.filterItems(referencedApp.app_id, {}, 100);
298
+ const items = response.items.map((item) => ({
299
+ item_id: item.item_id,
300
+ title: fieldMapper.extractTitle(item),
301
+ link: item.link,
302
+ app: {
303
+ app_id: referencedApp.app_id,
304
+ name: `${type.charAt(0).toUpperCase() + type.slice(1)} App`,
305
+ },
306
+ }));
307
+ // Cache the items
308
+ if (type === 'project') {
309
+ await this.cacheManager.setProjects(appId, items);
310
+ }
311
+ else {
312
+ await this.cacheManager.setEpics(appId, items);
313
+ }
314
+ console.info(`[ItemService] Auto-populated ${type} cache with ${items.length} items from referenced app`);
315
+ }
316
+ catch (error) {
317
+ console.warn(`[ItemService] Failed to fetch ${type}s from referenced app:`, error);
318
+ }
319
+ }
320
+ }
321
+ }
322
+ // Now try to find the item
323
+ const items = type === 'project'
324
+ ? await this.cacheManager.findProjectsByTitle(name, appId)
325
+ : await this.cacheManager.findEpicsByTitle(name, appId);
326
+ if (items.length > 0) {
327
+ return items[0].item_id;
328
+ }
329
+ return null;
330
+ }
331
+ /**
332
+ * Populate project or epic cache by fetching from referenced app
333
+ */
334
+ async populateProjectEpicCache(type, appId, fieldMapper) {
335
+ try {
336
+ // Find the reference field
337
+ const field = fieldMapper.findField(type);
338
+ if (!field || field.type !== 'app' || !field.config?.settings?.referenced_apps?.[0]?.app_id) {
339
+ return; // No reference field found
340
+ }
341
+ const referencedAppId = field.config.settings.referenced_apps[0].app_id;
342
+ // Fetch items from the referenced app
343
+ const response = await this.apiClient.filterItems(referencedAppId, {}, 100);
344
+ const items = response.items || [];
345
+ // Transform to cache format
346
+ const cacheItems = items.map((item) => ({
347
+ item_id: item.item_id,
348
+ title: item.title || 'Untitled',
349
+ app: {
350
+ app_id: referencedAppId,
351
+ name: type === 'project' ? 'Projects' : 'Epics',
352
+ },
353
+ }));
354
+ // Store in cache
355
+ if (type === 'project') {
356
+ await this.cacheManager.setProjects(appId, cacheItems);
357
+ }
358
+ else {
359
+ await this.cacheManager.setEpics(appId, cacheItems);
360
+ }
361
+ }
362
+ catch (error) {
363
+ // Log error but don't fail the item creation
364
+ console.warn(`Failed to populate ${type} cache:`, error);
365
+ }
366
+ }
367
+ }
368
+ //# sourceMappingURL=item-service.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"item-service.js","sourceRoot":"","sources":["../../src/services/item-service.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,125 @@
1
+ /**
2
+ * @fileoverview Notification Service for managing Podio notifications
3
+ *
4
+ * This service handles all notification-related operations including fetching,
5
+ * filtering, caching, and formatting notification data.
6
+ */
7
+ import type { PodioApiClient } from '../api/podio-api-client.js';
8
+ import type { CacheManager } from '../cache/cache-manager.js';
9
+ import type { PodioNotification, NotificationsResponse, NotificationFilters, InboxNewCount, NotificationSettings, NotificationSummary } from '../types/index.js';
10
+ /**
11
+ * Service for managing Podio notifications
12
+ *
13
+ * This service provides a high-level interface for notification operations,
14
+ * including data fetching, filtering, caching, and transformation.
15
+ */
16
+ export declare class NotificationService {
17
+ private readonly apiClient;
18
+ private readonly cacheManager;
19
+ /** Simple in-memory cache for notifications */
20
+ private readonly simpleCache;
21
+ /** Cache key prefix for notifications */
22
+ private readonly CACHE_PREFIX;
23
+ /** Default cache duration for notifications (5 minutes) */
24
+ private readonly CACHE_DURATION;
25
+ /** Cache key for unread count */
26
+ private readonly UNREAD_COUNT_KEY;
27
+ constructor(apiClient: PodioApiClient, cacheManager: CacheManager);
28
+ /**
29
+ * Simple cache get method with expiry check
30
+ *
31
+ * @private
32
+ * @param key - Cache key
33
+ * @returns Cached data or null if expired/not found
34
+ */
35
+ private getCached;
36
+ /**
37
+ * Simple cache set method with expiry
38
+ *
39
+ * @private
40
+ * @param key - Cache key
41
+ * @param data - Data to cache
42
+ * @param ttl - Time to live in milliseconds
43
+ */
44
+ private setCached;
45
+ /**
46
+ * Simple cache delete method
47
+ *
48
+ * @private
49
+ * @param key - Cache key
50
+ */
51
+ private deleteCached;
52
+ /**
53
+ * List notifications with optional filtering and caching
54
+ *
55
+ * @param filters - Notification filters
56
+ * @param useCache - Whether to use cached data if available
57
+ * @returns Notifications response
58
+ */
59
+ listNotifications(filters?: NotificationFilters, useCache?: boolean): Promise<NotificationsResponse>;
60
+ /**
61
+ * Get a specific notification by ID
62
+ *
63
+ * @param notificationId - Notification ID
64
+ * @param useCache - Whether to use cached data if available
65
+ * @returns Notification details
66
+ */
67
+ getNotification(notificationId: number, useCache?: boolean): Promise<PodioNotification>;
68
+ /**
69
+ * Get unread notification count
70
+ *
71
+ * @param useCache - Whether to use cached data if available
72
+ * @returns Unread count information
73
+ */
74
+ getUnreadCount(useCache?: boolean): Promise<InboxNewCount>;
75
+ /**
76
+ * Get notification settings
77
+ *
78
+ * @param useCache - Whether to use cached data if available
79
+ * @returns Notification settings
80
+ */
81
+ getNotificationSettings(useCache?: boolean): Promise<NotificationSettings>;
82
+ /**
83
+ * Transform notifications into summary format for display
84
+ *
85
+ * @param notifications - Raw notifications from API
86
+ * @returns Summarized notifications
87
+ */
88
+ transformToSummary(notifications: PodioNotification[]): NotificationSummary[];
89
+ /**
90
+ * Filter notifications by various criteria
91
+ *
92
+ * @param notifications - Notifications to filter
93
+ * @param criteria - Filter criteria
94
+ * @returns Filtered notifications
95
+ */
96
+ filterNotifications(notifications: PodioNotification[], criteria?: {
97
+ unreadOnly?: boolean;
98
+ types?: string[];
99
+ hasContext?: boolean;
100
+ fromDate?: Date;
101
+ }): PodioNotification[];
102
+ /**
103
+ * Clear notification-related cache
104
+ *
105
+ * @param specific - Clear specific cache key (optional)
106
+ */
107
+ clearCache(specific?: string): Promise<void>;
108
+ /**
109
+ * Build cache key from notification filters
110
+ *
111
+ * @private
112
+ * @param filters - Notification filters
113
+ * @returns Cache key
114
+ */
115
+ private buildCacheKey;
116
+ /**
117
+ * Clean notification text for display (remove HTML, trim, etc.)
118
+ *
119
+ * @private
120
+ * @param text - Raw notification text
121
+ * @returns Cleaned text
122
+ */
123
+ private cleanNotificationText;
124
+ }
125
+ //# sourceMappingURL=notification-service.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"notification-service.d.ts","sourceRoot":"","sources":["../../src/services/notification-service.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,KAAK,EACV,iBAAiB,EACjB,qBAAqB,EACrB,mBAAmB,EACnB,aAAa,EACb,oBAAoB,EACpB,mBAAmB,EACpB,MAAM,mBAAmB,CAAC;AAG3B;;;;;GAKG;AACH,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAiB;IAC3C,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAe;IAE5C,+CAA+C;IAC/C,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAyD;IAErF,yCAAyC;IACzC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAmB;IAEhD,2DAA2D;IAC3D,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAiB;IAEhD,iCAAiC;IACjC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAkB;gBAEvC,SAAS,EAAE,cAAc,EAAE,YAAY,EAAE,YAAY;IAKjE;;;;;;OAMG;IACH,OAAO,CAAC,SAAS;IAcjB;;;;;;;OAOG;IACH,OAAO,CAAC,SAAS;IAKjB;;;;;OAKG;IACH,OAAO,CAAC,YAAY;IAIpB;;;;;;OAMG;IACU,iBAAiB,CAC5B,OAAO,GAAE,mBAAwB,EACjC,QAAQ,GAAE,OAAc,GACvB,OAAO,CAAC,qBAAqB,CAAC;IAiCjC;;;;;;OAMG;IACU,eAAe,CAC1B,cAAc,EAAE,MAAM,EACtB,QAAQ,GAAE,OAAc,GACvB,OAAO,CAAC,iBAAiB,CAAC;IAqC7B;;;;;OAKG;IACU,cAAc,CAAC,QAAQ,GAAE,OAAc,GAAG,OAAO,CAAC,aAAa,CAAC;IAiC7E;;;;;OAKG;IACU,uBAAuB,CAAC,QAAQ,GAAE,OAAc,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAiC7F;;;;;OAKG;IACI,kBAAkB,CAAC,aAAa,EAAE,iBAAiB,EAAE,GAAG,mBAAmB,EAAE;IAepF;;;;;;OAMG;IACI,mBAAmB,CACxB,aAAa,EAAE,iBAAiB,EAAE,EAClC,QAAQ,GAAE;QACR,UAAU,CAAC,EAAE,OAAO,CAAC;QACrB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;QACjB,UAAU,CAAC,EAAE,OAAO,CAAC;QACrB,QAAQ,CAAC,EAAE,IAAI,CAAC;KACZ,GACL,iBAAiB,EAAE;IAsBtB;;;;OAIG;IACU,UAAU,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAyBzD;;;;;;OAMG;IACH,OAAO,CAAC,aAAa;IAcrB;;;;;;OAMG;IACH,OAAO,CAAC,qBAAqB;CAyB9B"}