@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.
- package/LICENSE +21 -0
- package/README.md +491 -0
- package/build/__tests__/integration/setup.integration.d.ts +104 -0
- package/build/__tests__/integration/setup.integration.d.ts.map +1 -0
- package/build/__tests__/integration/setup.integration.js +233 -0
- package/build/__tests__/integration/setup.integration.js.map +1 -0
- package/build/__tests__/mock-data/items-mock-data.d.ts +168 -0
- package/build/__tests__/mock-data/items-mock-data.d.ts.map +1 -0
- package/build/__tests__/mock-data/items-mock-data.js +370 -0
- package/build/__tests__/mock-data/items-mock-data.js.map +1 -0
- package/build/__tests__/mock-data/notification-mock-data.d.ts +55 -0
- package/build/__tests__/mock-data/notification-mock-data.d.ts.map +1 -0
- package/build/__tests__/mock-data/notification-mock-data.js +190 -0
- package/build/__tests__/mock-data/notification-mock-data.js.map +1 -0
- package/build/__tests__/mock-data/project-epic-mock-data.d.ts +45 -0
- package/build/__tests__/mock-data/project-epic-mock-data.d.ts.map +1 -0
- package/build/__tests__/mock-data/project-epic-mock-data.js +85 -0
- package/build/__tests__/mock-data/project-epic-mock-data.js.map +1 -0
- package/build/__tests__/mock-data/tasks-mock-data.d.ts +27 -0
- package/build/__tests__/mock-data/tasks-mock-data.d.ts.map +1 -0
- package/build/__tests__/mock-data/tasks-mock-data.js +104 -0
- package/build/__tests__/mock-data/tasks-mock-data.js.map +1 -0
- package/build/__tests__/mock-data/utility-mock-data.d.ts +19 -0
- package/build/__tests__/mock-data/utility-mock-data.d.ts.map +1 -0
- package/build/__tests__/mock-data/utility-mock-data.js +165 -0
- package/build/__tests__/mock-data/utility-mock-data.js.map +1 -0
- package/build/__tests__/setup.d.ts +8 -0
- package/build/__tests__/setup.d.ts.map +1 -0
- package/build/__tests__/setup.js +31 -0
- package/build/__tests__/setup.js.map +1 -0
- package/build/__tests__/utils/test-helpers.d.ts +110 -0
- package/build/__tests__/utils/test-helpers.d.ts.map +1 -0
- package/build/__tests__/utils/test-helpers.js +222 -0
- package/build/__tests__/utils/test-helpers.js.map +1 -0
- package/build/api/podio-api-client.d.ts +364 -0
- package/build/api/podio-api-client.d.ts.map +1 -0
- package/build/api/podio-api-client.js +696 -0
- package/build/api/podio-api-client.js.map +1 -0
- package/build/cache/app-cache.d.ts +77 -0
- package/build/cache/app-cache.d.ts.map +1 -0
- package/build/cache/app-cache.js +230 -0
- package/build/cache/app-cache.js.map +1 -0
- package/build/cache/base-cache-manager.d.ts +149 -0
- package/build/cache/base-cache-manager.d.ts.map +1 -0
- package/build/cache/base-cache-manager.js +312 -0
- package/build/cache/base-cache-manager.js.map +1 -0
- package/build/cache/cache-manager.d.ts +230 -0
- package/build/cache/cache-manager.d.ts.map +1 -0
- package/build/cache/cache-manager.js +362 -0
- package/build/cache/cache-manager.js.map +1 -0
- package/build/cache/cache-test.d.ts +9 -0
- package/build/cache/cache-test.d.ts.map +1 -0
- package/build/cache/cache-test.js +169 -0
- package/build/cache/cache-test.js.map +1 -0
- package/build/cache/index.d.ts +18 -0
- package/build/cache/index.d.ts.map +1 -0
- package/build/cache/index.js +20 -0
- package/build/cache/index.js.map +1 -0
- package/build/cache/migration-helper.d.ts +44 -0
- package/build/cache/migration-helper.d.ts.map +1 -0
- package/build/cache/migration-helper.js +235 -0
- package/build/cache/migration-helper.js.map +1 -0
- package/build/cache/project-epic-cache.d.ts +108 -0
- package/build/cache/project-epic-cache.d.ts.map +1 -0
- package/build/cache/project-epic-cache.js +278 -0
- package/build/cache/project-epic-cache.js.map +1 -0
- package/build/cache/space-members-cache.d.ts +99 -0
- package/build/cache/space-members-cache.d.ts.map +1 -0
- package/build/cache/space-members-cache.js +305 -0
- package/build/cache/space-members-cache.js.map +1 -0
- package/build/cache/storage-adapters.d.ts +100 -0
- package/build/cache/storage-adapters.d.ts.map +1 -0
- package/build/cache/storage-adapters.js +297 -0
- package/build/cache/storage-adapters.js.map +1 -0
- package/build/errors/api-errors.d.ts +52 -0
- package/build/errors/api-errors.d.ts.map +1 -0
- package/build/errors/api-errors.js +86 -0
- package/build/errors/api-errors.js.map +1 -0
- package/build/errors/auth-errors.d.ts +67 -0
- package/build/errors/auth-errors.d.ts.map +1 -0
- package/build/errors/auth-errors.js +114 -0
- package/build/errors/auth-errors.js.map +1 -0
- package/build/errors/base.d.ts +102 -0
- package/build/errors/base.d.ts.map +1 -0
- package/build/errors/base.js +131 -0
- package/build/errors/base.js.map +1 -0
- package/build/errors/cache-errors.d.ts +53 -0
- package/build/errors/cache-errors.d.ts.map +1 -0
- package/build/errors/cache-errors.js +83 -0
- package/build/errors/cache-errors.js.map +1 -0
- package/build/errors/config-errors.d.ts +58 -0
- package/build/errors/config-errors.d.ts.map +1 -0
- package/build/errors/config-errors.js +96 -0
- package/build/errors/config-errors.js.map +1 -0
- package/build/errors/index.d.ts +101 -0
- package/build/errors/index.d.ts.map +1 -0
- package/build/errors/index.js +135 -0
- package/build/errors/index.js.map +1 -0
- package/build/errors/structure-errors.d.ts +89 -0
- package/build/errors/structure-errors.d.ts.map +1 -0
- package/build/errors/structure-errors.js +182 -0
- package/build/errors/structure-errors.js.map +1 -0
- package/build/errors/validation-errors.d.ts +81 -0
- package/build/errors/validation-errors.d.ts.map +1 -0
- package/build/errors/validation-errors.js +169 -0
- package/build/errors/validation-errors.js.map +1 -0
- package/build/fields/field-mapper.d.ts +245 -0
- package/build/fields/field-mapper.d.ts.map +1 -0
- package/build/fields/field-mapper.js +404 -0
- package/build/fields/field-mapper.js.map +1 -0
- package/build/index.d.ts +550 -0
- package/build/index.d.ts.map +1 -0
- package/build/index.js +1527 -0
- package/build/index.js.map +1 -0
- package/build/oauth-helper.d.ts +189 -0
- package/build/oauth-helper.d.ts.map +1 -0
- package/build/oauth-helper.js +422 -0
- package/build/oauth-helper.js.map +1 -0
- package/build/services/app-structure-service.d.ts +49 -0
- package/build/services/app-structure-service.d.ts.map +1 -0
- package/build/services/app-structure-service.js +122 -0
- package/build/services/app-structure-service.js.map +1 -0
- package/build/services/code-execution-service.d.ts +88 -0
- package/build/services/code-execution-service.d.ts.map +1 -0
- package/build/services/code-execution-service.js +342 -0
- package/build/services/code-execution-service.js.map +1 -0
- package/build/services/comment-service.d.ts +66 -0
- package/build/services/comment-service.d.ts.map +1 -0
- package/build/services/comment-service.js +139 -0
- package/build/services/comment-service.js.map +1 -0
- package/build/services/index.d.ts +16 -0
- package/build/services/index.d.ts.map +1 -0
- package/build/services/index.js +15 -0
- package/build/services/index.js.map +1 -0
- package/build/services/item-service.d.ts +104 -0
- package/build/services/item-service.d.ts.map +1 -0
- package/build/services/item-service.js +368 -0
- package/build/services/item-service.js.map +1 -0
- package/build/services/notification-service.d.ts +125 -0
- package/build/services/notification-service.d.ts.map +1 -0
- package/build/services/notification-service.js +321 -0
- package/build/services/notification-service.js.map +1 -0
- package/build/services/project-epic-service.d.ts +73 -0
- package/build/services/project-epic-service.d.ts.map +1 -0
- package/build/services/project-epic-service.js +248 -0
- package/build/services/project-epic-service.js.map +1 -0
- package/build/services/response-formatter.d.ts +190 -0
- package/build/services/response-formatter.d.ts.map +1 -0
- package/build/services/response-formatter.js +1221 -0
- package/build/services/response-formatter.js.map +1 -0
- package/build/services/search-service.d.ts +103 -0
- package/build/services/search-service.d.ts.map +1 -0
- package/build/services/search-service.js +273 -0
- package/build/services/search-service.js.map +1 -0
- package/build/services/task-service.d.ts +70 -0
- package/build/services/task-service.d.ts.map +1 -0
- package/build/services/task-service.js +156 -0
- package/build/services/task-service.js.map +1 -0
- package/build/tools/index.d.ts +8 -0
- package/build/tools/index.d.ts.map +1 -0
- package/build/tools/index.js +8 -0
- package/build/tools/index.js.map +1 -0
- package/build/tools/tool-definitions.d.ts +89 -0
- package/build/tools/tool-definitions.d.ts.map +1 -0
- package/build/tools/tool-definitions.js +1167 -0
- package/build/tools/tool-definitions.js.map +1 -0
- package/build/types/api-types.d.ts +106 -0
- package/build/types/api-types.d.ts.map +1 -0
- package/build/types/api-types.js +11 -0
- package/build/types/api-types.js.map +1 -0
- package/build/types/cache-types.d.ts +52 -0
- package/build/types/cache-types.d.ts.map +1 -0
- package/build/types/cache-types.js +12 -0
- package/build/types/cache-types.js.map +1 -0
- package/build/types/index.d.ts +31 -0
- package/build/types/index.d.ts.map +1 -0
- package/build/types/index.js +25 -0
- package/build/types/index.js.map +1 -0
- package/build/types/notification-types.d.ts +154 -0
- package/build/types/notification-types.d.ts.map +1 -0
- package/build/types/notification-types.js +7 -0
- package/build/types/notification-types.js.map +1 -0
- package/build/types/podio-types.d.ts +250 -0
- package/build/types/podio-types.d.ts.map +1 -0
- package/build/types/podio-types.js +11 -0
- package/build/types/podio-types.js.map +1 -0
- package/build/types/search-types.d.ts +188 -0
- package/build/types/search-types.d.ts.map +1 -0
- package/build/types/search-types.js +43 -0
- package/build/types/search-types.js.map +1 -0
- package/build/utils/debug.d.ts +58 -0
- package/build/utils/debug.d.ts.map +1 -0
- package/build/utils/debug.js +147 -0
- package/build/utils/debug.js.map +1 -0
- package/examples/claude-config-example.json +13 -0
- package/package.json +87 -0
- 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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"}
|