@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,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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"}
|