@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,99 @@
1
+ /**
2
+ * @fileoverview Space members cache implementation for user lookups
3
+ *
4
+ * This module provides a specialized cache for space members with
5
+ * fuzzy search capabilities for names and emails, role-based filtering,
6
+ * and efficient user assignment lookup. Replaces the simple array-based
7
+ * space members caching in index.ts.
8
+ */
9
+ import { BaseCacheManager, type CacheConfig } from './base-cache-manager.js';
10
+ import type { SpaceMember } from '../types/podio-types.js';
11
+ /**
12
+ * Configuration for space members cache
13
+ */
14
+ export interface SpaceMembersCacheConfig extends CacheConfig {
15
+ /** Enable fuzzy search for user lookups */
16
+ enableFuzzySearch?: boolean;
17
+ /** Minimum similarity score for fuzzy matches (0-1) */
18
+ minSimilarityScore?: number;
19
+ }
20
+ /**
21
+ * User search result with scoring information
22
+ */
23
+ export interface UserSearchResult {
24
+ member: SpaceMember;
25
+ score: number;
26
+ matchReason: 'exact_name' | 'exact_email' | 'partial_name' | 'partial_email' | 'fuzzy_name' | 'fuzzy_email';
27
+ }
28
+ /**
29
+ * Specialized cache manager for space members
30
+ *
31
+ * Provides efficient user lookups by name, email, or user ID with support
32
+ * for fuzzy matching and role-based filtering. Designed for assignment
33
+ * operations and user suggestion functionality.
34
+ */
35
+ export declare class SpaceMembersCacheManager extends BaseCacheManager<SpaceMember[]> {
36
+ private readonly enableFuzzySearch;
37
+ private readonly minSimilarityScore;
38
+ constructor(config?: SpaceMembersCacheConfig);
39
+ /**
40
+ * Set members for a specific space ID
41
+ */
42
+ setMembers(spaceId: number, members: SpaceMember[]): Promise<void>;
43
+ /**
44
+ * Get members for a specific space ID
45
+ */
46
+ getMembers(spaceId: number): Promise<SpaceMember[]>;
47
+ /**
48
+ * Find a user by name or email with fuzzy matching
49
+ */
50
+ findUser(nameOrEmail: string, spaceId?: number): Promise<UserSearchResult | null>;
51
+ /**
52
+ * Find multiple users matching the search term
53
+ */
54
+ findUsers(nameOrEmail: string, spaceId?: number, maxResults?: number): Promise<UserSearchResult[]>;
55
+ /**
56
+ * Find a user by exact user ID
57
+ */
58
+ findUserById(userId: number, spaceId?: number): Promise<SpaceMember | null>;
59
+ /**
60
+ * Get members filtered by role
61
+ */
62
+ getMembersByRole(role: string, spaceId?: number): Promise<SpaceMember[]>;
63
+ /**
64
+ * Get only employee members
65
+ */
66
+ getEmployeeMembers(spaceId?: number): Promise<SpaceMember[]>;
67
+ /**
68
+ * Get all members across all spaces
69
+ */
70
+ getAllMembers(): Promise<SpaceMember[]>;
71
+ /**
72
+ * Get formatted list of members for display
73
+ */
74
+ getFormattedMembersList(spaceId?: number): Promise<string>;
75
+ /**
76
+ * Check if members are cached for a specific space
77
+ */
78
+ hasMembersForSpace(spaceId: number): Promise<boolean>;
79
+ /**
80
+ * Get cache statistics with member counts
81
+ */
82
+ getCacheStatistics(): Promise<{
83
+ spaceCount: number;
84
+ totalMembers: number;
85
+ membersBySpace: Record<string, number>;
86
+ averageMembersPerSpace: number;
87
+ employeeCount: number;
88
+ roleDistribution: Record<string, number>;
89
+ }>;
90
+ private findExactNameMatch;
91
+ private findExactEmailMatch;
92
+ private findPartialNameMatch;
93
+ private findPartialEmailMatch;
94
+ private findFuzzyMatch;
95
+ private calculateSimilarity;
96
+ private levenshteinSimilarity;
97
+ private levenshteinDistance;
98
+ }
99
+ //# sourceMappingURL=space-members-cache.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"space-members-cache.d.ts","sourceRoot":"","sources":["../../src/cache/space-members-cache.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,gBAAgB,EAAE,KAAK,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAE7E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAE3D;;GAEG;AACH,MAAM,WAAW,uBAAwB,SAAQ,WAAW;IAC1D,2CAA2C;IAC3C,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,uDAAuD;IACvD,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,WAAW,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EACP,YAAY,GACZ,aAAa,GACb,cAAc,GACd,eAAe,GACf,YAAY,GACZ,aAAa,CAAC;CACnB;AAED;;;;;;GAMG;AACH,qBAAa,wBAAyB,SAAQ,gBAAgB,CAAC,WAAW,EAAE,CAAC;IAC3E,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAU;IAC5C,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAS;gBAEhC,MAAM,GAAE,uBAA4B;IAiBhD;;OAEG;IACG,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAKxE;;OAEG;IACG,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAKzD;;OAEG;IACG,QAAQ,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC;IAwDvF;;OAEG;IACG,SAAS,CACb,WAAW,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE,MAAM,EAChB,UAAU,GAAE,MAAW,GACtB,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAsC9B;;OAEG;IACG,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;IAKjF;;OAEG;IACG,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAK9E;;OAEG;IACG,kBAAkB,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAKlE;;OAEG;IACG,aAAa,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;IAc7C;;OAEG;IACG,uBAAuB,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IA2BhE;;OAEG;IACG,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAK3D;;OAEG;IACG,kBAAkB,IAAI,OAAO,CAAC;QAClC,UAAU,EAAE,MAAM,CAAC;QACnB,YAAY,EAAE,MAAM,CAAC;QACrB,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACvC,sBAAsB,EAAE,MAAM,CAAC;QAC/B,aAAa,EAAE,MAAM,CAAC;QACtB,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;KAC1C,CAAC;IAoCF,OAAO,CAAC,kBAAkB;IAM1B,OAAO,CAAC,mBAAmB;IAM3B,OAAO,CAAC,oBAAoB;IAK5B,OAAO,CAAC,qBAAqB;IAK7B,OAAO,CAAC,cAAc;IAwBtB,OAAO,CAAC,mBAAmB;IAe3B,OAAO,CAAC,qBAAqB;IAM7B,OAAO,CAAC,mBAAmB;CAwB5B"}
@@ -0,0 +1,305 @@
1
+ /**
2
+ * @fileoverview Space members cache implementation for user lookups
3
+ *
4
+ * This module provides a specialized cache for space members with
5
+ * fuzzy search capabilities for names and emails, role-based filtering,
6
+ * and efficient user assignment lookup. Replaces the simple array-based
7
+ * space members caching in index.ts.
8
+ */
9
+ import { BaseCacheManager } from './base-cache-manager.js';
10
+ import { MemoryStorageAdapter } from './storage-adapters.js';
11
+ /**
12
+ * Specialized cache manager for space members
13
+ *
14
+ * Provides efficient user lookups by name, email, or user ID with support
15
+ * for fuzzy matching and role-based filtering. Designed for assignment
16
+ * operations and user suggestion functionality.
17
+ */
18
+ export class SpaceMembersCacheManager extends BaseCacheManager {
19
+ enableFuzzySearch;
20
+ minSimilarityScore;
21
+ constructor(config = {}) {
22
+ const storage = new MemoryStorageAdapter();
23
+ const cacheConfig = {
24
+ maxSize: 20, // Reasonable limit for space collections
25
+ ttl: 15 * 60 * 1000, // 15 minutes (user data changes less frequently)
26
+ enableLogging: true,
27
+ keyPrefix: 'members',
28
+ ...config,
29
+ };
30
+ super(storage, cacheConfig);
31
+ this.enableFuzzySearch = config.enableFuzzySearch !== false;
32
+ this.minSimilarityScore = config.minSimilarityScore || 0.4;
33
+ }
34
+ /**
35
+ * Set members for a specific space ID
36
+ */
37
+ async setMembers(spaceId, members) {
38
+ await this.set(spaceId.toString(), members);
39
+ this.log(`Cached ${members.length} members for space ${spaceId}`);
40
+ }
41
+ /**
42
+ * Get members for a specific space ID
43
+ */
44
+ async getMembers(spaceId) {
45
+ const members = await this.get(spaceId.toString());
46
+ return members || [];
47
+ }
48
+ /**
49
+ * Find a user by name or email with fuzzy matching
50
+ */
51
+ async findUser(nameOrEmail, spaceId) {
52
+ const members = spaceId ? await this.getMembers(spaceId) : await this.getAllMembers();
53
+ if (members.length === 0) {
54
+ return null;
55
+ }
56
+ // Try exact matches first (highest priority)
57
+ let member = this.findExactNameMatch(members, nameOrEmail);
58
+ if (member) {
59
+ return {
60
+ member,
61
+ score: 1.0,
62
+ matchReason: 'exact_name',
63
+ };
64
+ }
65
+ member = this.findExactEmailMatch(members, nameOrEmail);
66
+ if (member) {
67
+ return {
68
+ member,
69
+ score: 1.0,
70
+ matchReason: 'exact_email',
71
+ };
72
+ }
73
+ // Try partial matches (medium priority)
74
+ member = this.findPartialNameMatch(members, nameOrEmail);
75
+ if (member) {
76
+ return {
77
+ member,
78
+ score: 0.8,
79
+ matchReason: 'partial_name',
80
+ };
81
+ }
82
+ member = this.findPartialEmailMatch(members, nameOrEmail);
83
+ if (member) {
84
+ return {
85
+ member,
86
+ score: 0.8,
87
+ matchReason: 'partial_email',
88
+ };
89
+ }
90
+ // Try fuzzy matching if enabled (lowest priority)
91
+ if (this.enableFuzzySearch) {
92
+ const fuzzyResult = this.findFuzzyMatch(members, nameOrEmail);
93
+ if (fuzzyResult) {
94
+ return fuzzyResult;
95
+ }
96
+ }
97
+ return null;
98
+ }
99
+ /**
100
+ * Find multiple users matching the search term
101
+ */
102
+ async findUsers(nameOrEmail, spaceId, maxResults = 10) {
103
+ const members = spaceId ? await this.getMembers(spaceId) : await this.getAllMembers();
104
+ const results = [];
105
+ const lowerSearch = nameOrEmail.toLowerCase();
106
+ // Score all members
107
+ for (const member of members) {
108
+ const nameScore = this.calculateSimilarity(lowerSearch, member.user.name.toLowerCase());
109
+ const emailScore = this.calculateSimilarity(lowerSearch, member.user.mail.toLowerCase());
110
+ const bestScore = Math.max(nameScore, emailScore);
111
+ if (bestScore >= this.minSimilarityScore) {
112
+ const matchReason = nameScore > emailScore
113
+ ? nameScore === 1.0
114
+ ? 'exact_name'
115
+ : nameScore > 0.8
116
+ ? 'partial_name'
117
+ : 'fuzzy_name'
118
+ : emailScore === 1.0
119
+ ? 'exact_email'
120
+ : emailScore > 0.8
121
+ ? 'partial_email'
122
+ : 'fuzzy_email';
123
+ results.push({
124
+ member,
125
+ score: bestScore,
126
+ matchReason,
127
+ });
128
+ }
129
+ }
130
+ // Sort by score and return top results
131
+ return results.sort((a, b) => b.score - a.score).slice(0, maxResults);
132
+ }
133
+ /**
134
+ * Find a user by exact user ID
135
+ */
136
+ async findUserById(userId, spaceId) {
137
+ const members = spaceId ? await this.getMembers(spaceId) : await this.getAllMembers();
138
+ return members.find((member) => member.user.user_id === userId) || null;
139
+ }
140
+ /**
141
+ * Get members filtered by role
142
+ */
143
+ async getMembersByRole(role, spaceId) {
144
+ const members = spaceId ? await this.getMembers(spaceId) : await this.getAllMembers();
145
+ return members.filter((member) => member.role.toLowerCase() === role.toLowerCase());
146
+ }
147
+ /**
148
+ * Get only employee members
149
+ */
150
+ async getEmployeeMembers(spaceId) {
151
+ const members = spaceId ? await this.getMembers(spaceId) : await this.getAllMembers();
152
+ return members.filter((member) => member.employee);
153
+ }
154
+ /**
155
+ * Get all members across all spaces
156
+ */
157
+ async getAllMembers() {
158
+ const keys = await this.keys();
159
+ const allMembers = [];
160
+ for (const key of keys) {
161
+ const members = await this.get(key);
162
+ if (members) {
163
+ allMembers.push(...members);
164
+ }
165
+ }
166
+ return allMembers;
167
+ }
168
+ /**
169
+ * Get formatted list of members for display
170
+ */
171
+ async getFormattedMembersList(spaceId) {
172
+ const members = spaceId ? await this.getMembers(spaceId) : await this.getAllMembers();
173
+ if (members.length === 0) {
174
+ return spaceId ? `No members found for space ${spaceId}.` : 'No members found in cache.';
175
+ }
176
+ let result = `Found ${members.length} space members:\n\n`;
177
+ members.forEach((member, index) => {
178
+ result += `${index + 1}. **${member.user.name}**\n`;
179
+ result += ` - Email: ${member.user.mail}\n`;
180
+ result += ` - User ID: ${member.user.user_id}\n`;
181
+ result += ` - Role: ${member.role}\n`;
182
+ result += ` - Employee: ${member.employee ? 'Yes' : 'No'}\n`;
183
+ result += ` - Grants: ${member.grants}\n`;
184
+ if (member.user.avatar) {
185
+ result += ` - Avatar: ${member.user.avatar}\n`;
186
+ }
187
+ result += '\n';
188
+ });
189
+ return result;
190
+ }
191
+ /**
192
+ * Check if members are cached for a specific space
193
+ */
194
+ async hasMembersForSpace(spaceId) {
195
+ const members = await this.getMembers(spaceId);
196
+ return members.length > 0;
197
+ }
198
+ /**
199
+ * Get cache statistics with member counts
200
+ */
201
+ async getCacheStatistics() {
202
+ const keys = await this.keys();
203
+ const membersBySpace = {};
204
+ const roleDistribution = {};
205
+ let totalMembers = 0;
206
+ let employeeCount = 0;
207
+ for (const key of keys) {
208
+ const members = await this.get(key);
209
+ if (members) {
210
+ membersBySpace[key] = members.length;
211
+ totalMembers += members.length;
212
+ for (const member of members) {
213
+ if (member.employee) {
214
+ employeeCount++;
215
+ }
216
+ const role = member.role;
217
+ roleDistribution[role] = (roleDistribution[role] || 0) + 1;
218
+ }
219
+ }
220
+ }
221
+ return {
222
+ spaceCount: keys.length,
223
+ totalMembers,
224
+ membersBySpace,
225
+ averageMembersPerSpace: keys.length > 0 ? totalMembers / keys.length : 0,
226
+ employeeCount,
227
+ roleDistribution,
228
+ };
229
+ }
230
+ // Private helper methods
231
+ findExactNameMatch(members, search) {
232
+ return (members.find((member) => member.user.name.toLowerCase() === search.toLowerCase()) || null);
233
+ }
234
+ findExactEmailMatch(members, search) {
235
+ return (members.find((member) => member.user.mail.toLowerCase() === search.toLowerCase()) || null);
236
+ }
237
+ findPartialNameMatch(members, search) {
238
+ const lowerSearch = search.toLowerCase();
239
+ return members.find((member) => member.user.name.toLowerCase().includes(lowerSearch)) || null;
240
+ }
241
+ findPartialEmailMatch(members, search) {
242
+ const lowerSearch = search.toLowerCase();
243
+ return members.find((member) => member.user.mail.toLowerCase().includes(lowerSearch)) || null;
244
+ }
245
+ findFuzzyMatch(members, search) {
246
+ let bestMatch = null;
247
+ const lowerSearch = search.toLowerCase();
248
+ for (const member of members) {
249
+ const nameScore = this.calculateSimilarity(lowerSearch, member.user.name.toLowerCase());
250
+ const emailScore = this.calculateSimilarity(lowerSearch, member.user.mail.toLowerCase());
251
+ const bestScore = Math.max(nameScore, emailScore);
252
+ if (bestScore >= this.minSimilarityScore) {
253
+ if (!bestMatch || bestScore > bestMatch.score) {
254
+ bestMatch = {
255
+ member,
256
+ score: bestScore,
257
+ matchReason: nameScore > emailScore ? 'fuzzy_name' : 'fuzzy_email',
258
+ };
259
+ }
260
+ }
261
+ }
262
+ return bestMatch;
263
+ }
264
+ calculateSimilarity(a, b) {
265
+ // Exact match
266
+ if (a === b)
267
+ return 1.0;
268
+ // One contains the other
269
+ if (a.includes(b) || b.includes(a)) {
270
+ const shorter = a.length < b.length ? a : b;
271
+ const longer = a.length >= b.length ? a : b;
272
+ return shorter.length / longer.length;
273
+ }
274
+ // Levenshtein-based similarity
275
+ return this.levenshteinSimilarity(a, b);
276
+ }
277
+ levenshteinSimilarity(a, b) {
278
+ const distance = this.levenshteinDistance(a, b);
279
+ const maxLength = Math.max(a.length, b.length);
280
+ return maxLength > 0 ? 1 - distance / maxLength : 1;
281
+ }
282
+ levenshteinDistance(a, b) {
283
+ if (a.length === 0)
284
+ return b.length;
285
+ if (b.length === 0)
286
+ return a.length;
287
+ const matrix = Array(b.length + 1)
288
+ .fill(null)
289
+ .map(() => Array(a.length + 1).fill(null));
290
+ for (let i = 0; i <= a.length; i++)
291
+ matrix[0][i] = i;
292
+ for (let j = 0; j <= b.length; j++)
293
+ matrix[j][0] = j;
294
+ for (let j = 1; j <= b.length; j++) {
295
+ for (let i = 1; i <= a.length; i++) {
296
+ const cost = a[i - 1] === b[j - 1] ? 0 : 1;
297
+ matrix[j][i] = Math.min(matrix[j][i - 1] + 1, // deletion
298
+ matrix[j - 1][i] + 1, // insertion
299
+ matrix[j - 1][i - 1] + cost);
300
+ }
301
+ }
302
+ return matrix[b.length][a.length];
303
+ }
304
+ }
305
+ //# sourceMappingURL=space-members-cache.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"space-members-cache.js","sourceRoot":"","sources":["../../src/cache/space-members-cache.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,100 @@
1
+ /**
2
+ * @fileoverview Storage adapter implementations for different cache backends
3
+ *
4
+ * This module provides concrete implementations of the StorageAdapter interface
5
+ * for both in-memory and persistent file-based storage. These adapters can be
6
+ * plugged into the BaseCacheManager for different caching strategies.
7
+ */
8
+ import type { StorageAdapter, CacheEntry } from './base-cache-manager.js';
9
+ /**
10
+ * In-memory storage adapter for fast, temporary caching
11
+ *
12
+ * This adapter stores data in a JavaScript Map for maximum performance.
13
+ * Data is lost when the process restarts, making it ideal for frequently
14
+ * accessed, short-lived cache data like user sessions and API responses.
15
+ */
16
+ export declare class MemoryStorageAdapter<T = any> implements StorageAdapter<T> {
17
+ private cache;
18
+ get(key: string): Promise<CacheEntry<T> | null>;
19
+ set(key: string, entry: CacheEntry<T>): Promise<void>;
20
+ delete(key: string): Promise<void>;
21
+ clear(): Promise<void>;
22
+ keys(): Promise<string[]>;
23
+ has(key: string): Promise<boolean>;
24
+ size(): Promise<number>;
25
+ }
26
+ /**
27
+ * Configuration options for file-based storage
28
+ */
29
+ export interface FileStorageConfig {
30
+ /** Directory path for cache files */
31
+ cacheDir: string;
32
+ /** File extension for cache files (default: .json) */
33
+ extension?: string;
34
+ /** Enable pretty-printing JSON (default: false for performance) */
35
+ prettyPrint?: boolean;
36
+ /** File encoding (default: utf-8) */
37
+ encoding?: BufferEncoding;
38
+ }
39
+ /**
40
+ * File-based storage adapter for persistent caching
41
+ *
42
+ * This adapter stores cache entries as individual JSON files on disk.
43
+ * Data persists across process restarts, making it ideal for app structures,
44
+ * configuration data, and other long-lived cache entries.
45
+ */
46
+ export declare class FileStorageAdapter<T = any> implements StorageAdapter<T> {
47
+ private config;
48
+ constructor(config: FileStorageConfig);
49
+ get(key: string): Promise<CacheEntry<T> | null>;
50
+ set(key: string, entry: CacheEntry<T>): Promise<void>;
51
+ delete(key: string): Promise<void>;
52
+ clear(): Promise<void>;
53
+ keys(): Promise<string[]>;
54
+ has(key: string): Promise<boolean>;
55
+ size(): Promise<number>;
56
+ /**
57
+ * Get total disk space used by cache files in bytes
58
+ */
59
+ getDiskUsage(): Promise<number>;
60
+ /**
61
+ * Clean up corrupted or invalid cache files
62
+ */
63
+ cleanupCorrupted(): Promise<number>;
64
+ private ensureCacheDir;
65
+ private getFilePath;
66
+ private getCacheFiles;
67
+ private isValidEntry;
68
+ }
69
+ /**
70
+ * Hybrid storage adapter that combines memory and file storage
71
+ *
72
+ * This adapter uses memory storage for fast access and file storage for persistence.
73
+ * It provides the performance benefits of memory caching with the durability of
74
+ * file-based storage. Ideal for app structures and other data that needs both
75
+ * speed and persistence.
76
+ */
77
+ export declare class HybridStorageAdapter<T = any> implements StorageAdapter<T> {
78
+ private memoryAdapter;
79
+ private fileAdapter;
80
+ constructor(fileConfig: FileStorageConfig);
81
+ get(key: string): Promise<CacheEntry<T> | null>;
82
+ set(key: string, entry: CacheEntry<T>): Promise<void>;
83
+ delete(key: string): Promise<void>;
84
+ clear(): Promise<void>;
85
+ keys(): Promise<string[]>;
86
+ has(key: string): Promise<boolean>;
87
+ size(): Promise<number>;
88
+ /**
89
+ * Sync memory cache with file storage
90
+ *
91
+ * Loads all file entries into memory for maximum performance.
92
+ * Useful during startup or after memory cache is cleared.
93
+ */
94
+ syncMemoryFromDisk(): Promise<void>;
95
+ /**
96
+ * Get memory cache hit ratio for monitoring
97
+ */
98
+ getMemoryHitRatio(): Promise<number>;
99
+ }
100
+ //# sourceMappingURL=storage-adapters.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"storage-adapters.d.ts","sourceRoot":"","sources":["../../src/cache/storage-adapters.ts"],"names":[],"mappings":"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"}