@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,312 @@
1
+ /**
2
+ * @fileoverview Base cache manager with pluggable storage adapters
3
+ *
4
+ * This module provides the core caching functionality with support for
5
+ * multiple storage backends (memory, persistent file-based storage).
6
+ * It includes TTL management, size limits, and comprehensive logging.
7
+ */
8
+ import { PodioCacheError } from '../errors/index.js';
9
+ /**
10
+ * Base cache manager with pluggable storage and comprehensive monitoring
11
+ */
12
+ export class BaseCacheManager {
13
+ storage;
14
+ config;
15
+ stats;
16
+ validator;
17
+ cleanupInterval;
18
+ constructor(storage, config = {}, validator) {
19
+ this.storage = storage;
20
+ this.config = {
21
+ maxSize: 1000,
22
+ ttl: 60 * 60 * 1000, // 1 hour default
23
+ enableLogging: true,
24
+ keyPrefix: '',
25
+ ...config,
26
+ };
27
+ this.validator = validator;
28
+ this.stats = {
29
+ hits: 0,
30
+ misses: 0,
31
+ size: 0,
32
+ hitRatio: 0,
33
+ expired: 0,
34
+ evicted: 0,
35
+ lastCleanup: Date.now(),
36
+ };
37
+ // Start periodic cleanup if TTL is enabled
38
+ if (this.config.ttl > 0) {
39
+ this.startPeriodicCleanup();
40
+ }
41
+ }
42
+ /**
43
+ * Get an item from cache with TTL and validation checks
44
+ */
45
+ async get(key) {
46
+ const fullKey = this.getFullKey(key);
47
+ try {
48
+ const entry = await this.storage.get(fullKey);
49
+ if (!entry) {
50
+ this.stats.misses++;
51
+ this.updateHitRatio();
52
+ this.log(`Cache miss for key: ${key}`);
53
+ return null;
54
+ }
55
+ // Check if entry is expired
56
+ if (this.isExpired(entry)) {
57
+ await this.storage.delete(fullKey);
58
+ this.stats.misses++;
59
+ this.stats.expired++;
60
+ this.updateHitRatio();
61
+ this.log(`Cache expired for key: ${key}`);
62
+ return null;
63
+ }
64
+ // Run validation if provided
65
+ if (this.validator) {
66
+ try {
67
+ const isValid = await this.validator(entry.data, entry);
68
+ if (!isValid) {
69
+ await this.storage.delete(fullKey);
70
+ this.stats.misses++;
71
+ this.updateHitRatio();
72
+ this.log(`Cache validation failed for key: ${key}`);
73
+ return null;
74
+ }
75
+ }
76
+ catch (error) {
77
+ this.log(`Cache validation error for key ${key}: ${error}`);
78
+ // Continue with cached data if validation throws
79
+ }
80
+ }
81
+ this.stats.hits++;
82
+ this.updateHitRatio();
83
+ this.log(`Cache hit for key: ${key}`);
84
+ return entry.data;
85
+ }
86
+ catch (error) {
87
+ throw PodioCacheError.readFailed(fullKey, error);
88
+ }
89
+ }
90
+ /**
91
+ * Set an item in cache with TTL and size limit enforcement
92
+ */
93
+ async set(key, data, customTtl) {
94
+ const fullKey = this.getFullKey(key);
95
+ const ttl = customTtl ?? this.config.ttl;
96
+ try {
97
+ // Check size limits and evict if necessary
98
+ await this.enforceSize();
99
+ const entry = {
100
+ data,
101
+ timestamp: Date.now(),
102
+ ttl,
103
+ version: this.generateVersion(),
104
+ };
105
+ await this.storage.set(fullKey, entry);
106
+ await this.updateSize();
107
+ this.log(`Cache set for key: ${key} (TTL: ${ttl}ms)`);
108
+ }
109
+ catch (error) {
110
+ throw PodioCacheError.writeFailed(fullKey, error);
111
+ }
112
+ }
113
+ /**
114
+ * Remove an item from cache
115
+ */
116
+ async delete(key) {
117
+ const fullKey = this.getFullKey(key);
118
+ try {
119
+ await this.storage.delete(fullKey);
120
+ await this.updateSize();
121
+ this.log(`Cache deleted for key: ${key}`);
122
+ }
123
+ catch (error) {
124
+ throw PodioCacheError.invalidationFailed(fullKey, error);
125
+ }
126
+ }
127
+ /**
128
+ * Check if a key exists in cache (and is not expired)
129
+ */
130
+ async has(key) {
131
+ const data = await this.get(key);
132
+ return data !== null;
133
+ }
134
+ /**
135
+ * Clear all items from cache
136
+ */
137
+ async clear() {
138
+ try {
139
+ await this.storage.clear();
140
+ this.stats.size = 0;
141
+ this.log('Cache cleared');
142
+ }
143
+ catch (error) {
144
+ throw PodioCacheError.invalidationFailed('all', error);
145
+ }
146
+ }
147
+ /**
148
+ * Get all keys in cache (excluding expired ones)
149
+ */
150
+ async keys() {
151
+ try {
152
+ const allKeys = await this.storage.keys();
153
+ const validKeys = [];
154
+ for (const fullKey of allKeys) {
155
+ if (fullKey.startsWith(this.config.keyPrefix)) {
156
+ const entry = await this.storage.get(fullKey);
157
+ if (entry && !this.isExpired(entry)) {
158
+ validKeys.push(this.stripPrefix(fullKey));
159
+ }
160
+ }
161
+ }
162
+ return validKeys;
163
+ }
164
+ catch (error) {
165
+ throw PodioCacheError.readFailed('keys', error);
166
+ }
167
+ }
168
+ /**
169
+ * Get current cache statistics
170
+ */
171
+ getStats() {
172
+ return { ...this.stats };
173
+ }
174
+ /**
175
+ * Reset cache statistics
176
+ */
177
+ resetStats() {
178
+ this.stats = {
179
+ hits: 0,
180
+ misses: 0,
181
+ size: this.stats.size, // Keep current size
182
+ hitRatio: 0,
183
+ expired: 0,
184
+ evicted: 0,
185
+ lastCleanup: Date.now(),
186
+ };
187
+ }
188
+ /**
189
+ * Perform manual cleanup of expired entries
190
+ */
191
+ async cleanup() {
192
+ try {
193
+ const allKeys = await this.storage.keys();
194
+ let cleanedCount = 0;
195
+ for (const fullKey of allKeys) {
196
+ if (fullKey.startsWith(this.config.keyPrefix)) {
197
+ const entry = await this.storage.get(fullKey);
198
+ if (entry && this.isExpired(entry)) {
199
+ await this.storage.delete(fullKey);
200
+ cleanedCount++;
201
+ this.stats.expired++;
202
+ }
203
+ }
204
+ }
205
+ await this.updateSize();
206
+ this.stats.lastCleanup = Date.now();
207
+ if (cleanedCount > 0) {
208
+ this.log(`Cleanup removed ${cleanedCount} expired entries`);
209
+ }
210
+ }
211
+ catch (error) {
212
+ this.log(`Cache cleanup error: ${error}`);
213
+ }
214
+ }
215
+ /**
216
+ * Gracefully shutdown the cache manager
217
+ */
218
+ async shutdown() {
219
+ if (this.cleanupInterval) {
220
+ clearInterval(this.cleanupInterval);
221
+ this.cleanupInterval = undefined;
222
+ }
223
+ this.log('Cache manager shutdown');
224
+ }
225
+ // Protected methods for subclasses
226
+ /**
227
+ * Get the storage adapter (for subclass customization)
228
+ */
229
+ getStorage() {
230
+ return this.storage;
231
+ }
232
+ /**
233
+ * Get the full configuration
234
+ */
235
+ getConfig() {
236
+ return this.config;
237
+ }
238
+ /**
239
+ * Log a message if logging is enabled
240
+ */
241
+ log(message) {
242
+ if (this.config.enableLogging) {
243
+ console.error(`[${this.constructor.name}] ${message}`);
244
+ }
245
+ }
246
+ // Private helper methods
247
+ getFullKey(key) {
248
+ return this.config.keyPrefix ? `${this.config.keyPrefix}:${key}` : key;
249
+ }
250
+ stripPrefix(fullKey) {
251
+ if (this.config.keyPrefix && fullKey.startsWith(this.config.keyPrefix + ':')) {
252
+ return fullKey.slice(this.config.keyPrefix.length + 1);
253
+ }
254
+ return fullKey;
255
+ }
256
+ isExpired(entry) {
257
+ if (entry.ttl <= 0)
258
+ return false; // No expiration
259
+ return Date.now() - entry.timestamp > entry.ttl;
260
+ }
261
+ generateVersion() {
262
+ return Date.now().toString(36) + Math.random().toString(36).substr(2);
263
+ }
264
+ updateHitRatio() {
265
+ const total = this.stats.hits + this.stats.misses;
266
+ this.stats.hitRatio = total > 0 ? this.stats.hits / total : 0;
267
+ }
268
+ async updateSize() {
269
+ try {
270
+ this.stats.size = await this.storage.size();
271
+ }
272
+ catch (error) {
273
+ this.log(`Error updating cache size: ${error}`);
274
+ }
275
+ }
276
+ async enforceSize() {
277
+ if (this.config.maxSize <= 0)
278
+ return; // No size limit
279
+ const currentSize = await this.storage.size();
280
+ if (currentSize >= this.config.maxSize) {
281
+ // Simple eviction: remove oldest entries
282
+ const allKeys = await this.storage.keys();
283
+ const entries = [];
284
+ for (const key of allKeys) {
285
+ if (key.startsWith(this.config.keyPrefix)) {
286
+ const entry = await this.storage.get(key);
287
+ if (entry) {
288
+ entries.push({ key, timestamp: entry.timestamp });
289
+ }
290
+ }
291
+ }
292
+ // Sort by timestamp (oldest first) and remove excess
293
+ entries.sort((a, b) => a.timestamp - b.timestamp);
294
+ const toRemove = entries.slice(0, currentSize - this.config.maxSize + 1);
295
+ for (const { key } of toRemove) {
296
+ await this.storage.delete(key);
297
+ this.stats.evicted++;
298
+ }
299
+ this.log(`Evicted ${toRemove.length} entries due to size limit`);
300
+ }
301
+ }
302
+ startPeriodicCleanup() {
303
+ // Run cleanup every 5 minutes
304
+ const interval = 5 * 60 * 1000;
305
+ this.cleanupInterval = setInterval(() => {
306
+ this.cleanup().catch((error) => {
307
+ this.log(`Periodic cleanup error: ${error}`);
308
+ });
309
+ }, interval);
310
+ }
311
+ }
312
+ //# sourceMappingURL=base-cache-manager.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"base-cache-manager.js","sourceRoot":"","sources":["../../src/cache/base-cache-manager.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,230 @@
1
+ /**
2
+ * @fileoverview Unified cache manager coordinating all cache implementations
3
+ *
4
+ * This module provides the main CacheManager class that coordinates
5
+ * all specialized cache implementations (apps, projects, epics, members)
6
+ * and replaces the scattered caching logic in index.ts.
7
+ */
8
+ import { type AppCacheConfig } from './app-cache.js';
9
+ import { type ProjectEpicCacheConfig } from './project-epic-cache.js';
10
+ import { type SpaceMembersCacheConfig } from './space-members-cache.js';
11
+ import type { CachedApp } from '../types/cache-types.js';
12
+ import type { AppStructure, AppCoordinates } from '../types/api-types.js';
13
+ import type { ProjectOrEpicItem, SpaceMember } from '../types/podio-types.js';
14
+ /**
15
+ * Global cache configuration
16
+ */
17
+ export interface CacheManagerConfig {
18
+ /** Base directory for persistent cache files */
19
+ cacheDir?: string;
20
+ /** Configuration for app structure cache */
21
+ appCache?: AppCacheConfig;
22
+ /** Configuration for project cache */
23
+ projectCache?: ProjectEpicCacheConfig;
24
+ /** Configuration for epic cache */
25
+ epicCache?: ProjectEpicCacheConfig;
26
+ /** Configuration for space members cache */
27
+ membersCache?: SpaceMembersCacheConfig;
28
+ /** Enable global cache logging */
29
+ enableLogging?: boolean;
30
+ }
31
+ /**
32
+ * Combined cache statistics from all cache implementations
33
+ */
34
+ export interface GlobalCacheStats {
35
+ apps: {
36
+ appCount: number;
37
+ totalSize: number;
38
+ hitRatio: number;
39
+ lastCleanup: number;
40
+ };
41
+ projects: {
42
+ appCount: number;
43
+ totalItems: number;
44
+ hitRatio: number;
45
+ averageItemsPerApp: number;
46
+ };
47
+ epics: {
48
+ appCount: number;
49
+ totalItems: number;
50
+ hitRatio: number;
51
+ averageItemsPerApp: number;
52
+ };
53
+ members: {
54
+ spaceCount: number;
55
+ totalMembers: number;
56
+ hitRatio: number;
57
+ employeeCount: number;
58
+ };
59
+ overall: {
60
+ totalCacheSize: number;
61
+ averageHitRatio: number;
62
+ memoryUsage: NodeJS.MemoryUsage;
63
+ };
64
+ }
65
+ /**
66
+ * Unified cache manager coordinating all cache implementations
67
+ *
68
+ * This class serves as the main interface for all caching operations,
69
+ * providing a single point of access to app structures, projects, epics,
70
+ * and space members caches. It replaces the scattered cache management
71
+ * logic throughout the main index.ts file.
72
+ */
73
+ export declare class CacheManager {
74
+ private readonly appCache;
75
+ private readonly projectCache;
76
+ private readonly epicCache;
77
+ private readonly membersCache;
78
+ private readonly enableLogging;
79
+ constructor(config?: CacheManagerConfig);
80
+ /**
81
+ * Get app structure by coordinates with automatic staleness detection
82
+ */
83
+ getAppByCoordinates(coordinates: AppCoordinates, maxAgeHours?: number): Promise<CachedApp | null>;
84
+ /**
85
+ * Cache an app structure with coordinates and metadata
86
+ */
87
+ cacheApp(coordinates: AppCoordinates, structure: AppStructure, name: string): Promise<void>;
88
+ /**
89
+ * Remove a cached app by ID
90
+ */
91
+ removeAppById(appId: number): Promise<void>;
92
+ /**
93
+ * Get all cached apps
94
+ */
95
+ getAllCachedApps(): Promise<CachedApp[]>;
96
+ /**
97
+ * Find current app coordinates from loaded app ID
98
+ */
99
+ getCurrentAppCoordinates(currentAppId?: number): Promise<AppCoordinates | null>;
100
+ /**
101
+ * Refresh a specific app by coordinates or all apps
102
+ */
103
+ refreshAppCache(coordinates?: AppCoordinates): Promise<void>;
104
+ /**
105
+ * Clear all app caches
106
+ */
107
+ clearAppCache(): Promise<void>;
108
+ /**
109
+ * Handle API errors with automatic cache refresh
110
+ */
111
+ handleApiErrorWithCacheRefresh(error: any, coordinates?: AppCoordinates, operation?: string): Promise<void>;
112
+ /**
113
+ * Set projects for a specific app
114
+ */
115
+ setProjects(appId: number, projects: ProjectOrEpicItem[]): Promise<void>;
116
+ /**
117
+ * Get projects for a specific app
118
+ */
119
+ getProjects(appId: number): Promise<ProjectOrEpicItem[]>;
120
+ /**
121
+ * Get all projects across all apps
122
+ */
123
+ getAllProjects(): Promise<ProjectOrEpicItem[]>;
124
+ /**
125
+ * Find projects by title with fuzzy matching
126
+ */
127
+ findProjectsByTitle(title: string, appId?: number): Promise<ProjectOrEpicItem[]>;
128
+ /**
129
+ * Get project suggestions with scoring
130
+ */
131
+ getProjectSuggestions(input: string, appId?: number): Promise<any[]>;
132
+ /**
133
+ * Get formatted list of projects
134
+ */
135
+ getFormattedProjectsList(appId?: number): Promise<string>;
136
+ /**
137
+ * Check if project cache is empty
138
+ */
139
+ isProjectCacheEmpty(appId?: number): Promise<boolean>;
140
+ /**
141
+ * Clear project cache
142
+ */
143
+ clearProjectCache(): Promise<void>;
144
+ /**
145
+ * Set epics for a specific app
146
+ */
147
+ setEpics(appId: number, epics: ProjectOrEpicItem[]): Promise<void>;
148
+ /**
149
+ * Get epics for a specific app
150
+ */
151
+ getEpics(appId: number): Promise<ProjectOrEpicItem[]>;
152
+ /**
153
+ * Get all epics across all apps
154
+ */
155
+ getAllEpics(): Promise<ProjectOrEpicItem[]>;
156
+ /**
157
+ * Find epics by title with fuzzy matching
158
+ */
159
+ findEpicsByTitle(title: string, appId?: number): Promise<ProjectOrEpicItem[]>;
160
+ /**
161
+ * Get epic suggestions with scoring
162
+ */
163
+ getEpicSuggestions(input: string, appId?: number): Promise<any[]>;
164
+ /**
165
+ * Get formatted list of epics
166
+ */
167
+ getFormattedEpicsList(appId?: number): Promise<string>;
168
+ /**
169
+ * Check if epic cache is empty
170
+ */
171
+ isEpicCacheEmpty(appId?: number): Promise<boolean>;
172
+ /**
173
+ * Clear epic cache
174
+ */
175
+ clearEpicCache(): Promise<void>;
176
+ /**
177
+ * Set members for a specific space
178
+ */
179
+ setSpaceMembers(spaceId: number, members: SpaceMember[]): Promise<void>;
180
+ /**
181
+ * Get members for a specific space
182
+ */
183
+ getSpaceMembers(spaceId: number): Promise<SpaceMember[]>;
184
+ /**
185
+ * Find a user by name or email
186
+ */
187
+ findUser(nameOrEmail: string, spaceId?: number): Promise<any>;
188
+ /**
189
+ * Find a user by user ID
190
+ */
191
+ findUserById(userId: number, spaceId?: number): Promise<SpaceMember | null>;
192
+ /**
193
+ * Get formatted list of space members
194
+ */
195
+ getFormattedMembersList(spaceId?: number): Promise<string>;
196
+ /**
197
+ * Check if members are cached for a space
198
+ */
199
+ hasSpaceMembers(spaceId: number): Promise<boolean>;
200
+ /**
201
+ * Clear space members cache
202
+ */
203
+ clearSpaceMembersCache(): Promise<void>;
204
+ /**
205
+ * Clear all caches
206
+ */
207
+ clearAllCaches(): Promise<void>;
208
+ /**
209
+ * Get comprehensive cache statistics
210
+ */
211
+ getGlobalCacheStats(): Promise<GlobalCacheStats>;
212
+ /**
213
+ * Perform cleanup on all caches
214
+ */
215
+ performGlobalCleanup(): Promise<void>;
216
+ /**
217
+ * Get cache health summary
218
+ */
219
+ getCacheHealthSummary(): Promise<string>;
220
+ /**
221
+ * Gracefully shutdown all cache managers
222
+ */
223
+ shutdown(): Promise<void>;
224
+ /**
225
+ * Check if an API error indicates cache structure mismatch
226
+ */
227
+ static isCacheStructureMismatch(error: any): boolean;
228
+ private log;
229
+ }
230
+ //# sourceMappingURL=cache-manager.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"cache-manager.d.ts","sourceRoot":"","sources":["../../src/cache/cache-manager.ts"],"names":[],"mappings":"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"}