@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,156 @@
1
+ /**
2
+ * @fileoverview Task Service
3
+ *
4
+ * This service handles all task-related operations including CRUD operations,
5
+ * filtering, and user resolution.
6
+ */
7
+ import { PodioValidationError } from '../errors/index.js';
8
+ /**
9
+ * Service class for handling task operations.
10
+ *
11
+ * This class encapsulates all task-related business logic and coordinates
12
+ * between the API client and cache manager.
13
+ */
14
+ export class TaskService {
15
+ apiClient;
16
+ cacheManager;
17
+ constructor(apiClient, cacheManager) {
18
+ this.apiClient = apiClient;
19
+ this.cacheManager = cacheManager;
20
+ }
21
+ /**
22
+ * List tasks with optional filtering
23
+ */
24
+ async listTasks(filters = {}, spaceId) {
25
+ const { assigned_to, status, limit = 20 } = filters;
26
+ // Build filter parameters
27
+ const apiFilters = {};
28
+ if (assigned_to) {
29
+ if (assigned_to === 'me') {
30
+ apiFilters.responsible = '0'; // Current user
31
+ }
32
+ else {
33
+ const userId = await this.resolveUser(assigned_to);
34
+ apiFilters.responsible = userId || assigned_to;
35
+ }
36
+ }
37
+ if (status) {
38
+ if (status === 'completed') {
39
+ apiFilters.completed = 'true';
40
+ }
41
+ else if (status === 'active') {
42
+ apiFilters.completed = 'false';
43
+ }
44
+ }
45
+ apiFilters.limit = limit.toString();
46
+ // Get tasks
47
+ const tasks = spaceId
48
+ ? await this.apiClient.getTasks(spaceId, apiFilters)
49
+ : await this.apiClient.get('/task/', { headers: apiFilters });
50
+ return Array.isArray(tasks) ? tasks : tasks.data || [];
51
+ }
52
+ /**
53
+ * Create a new task
54
+ */
55
+ async createTask(taskData) {
56
+ const { text, description, due_date, assigned_to, ref_type, ref_id } = taskData;
57
+ if (!text) {
58
+ throw PodioValidationError.requiredField('text', 'create task');
59
+ }
60
+ const payload = { text };
61
+ if (description)
62
+ payload.description = description;
63
+ if (due_date)
64
+ payload.due_date = due_date;
65
+ if (ref_type && ref_id) {
66
+ payload.ref_type = ref_type;
67
+ payload.ref_id = ref_id;
68
+ }
69
+ if (assigned_to) {
70
+ const userId = await this.resolveUser(assigned_to);
71
+ payload.responsible = userId || assigned_to;
72
+ }
73
+ return await this.apiClient.createTask(payload);
74
+ }
75
+ /**
76
+ * Create a task for a specific item
77
+ */
78
+ async createTaskForItem(itemId, taskData) {
79
+ const { text, description, due_date, assigned_to } = taskData;
80
+ if (!itemId || !text) {
81
+ throw PodioValidationError.requiredField('item_id and text', 'create task for item');
82
+ }
83
+ const payload = { text };
84
+ if (description)
85
+ payload.description = description;
86
+ if (due_date)
87
+ payload.due_date = due_date;
88
+ if (assigned_to) {
89
+ const userId = await this.resolveUser(assigned_to);
90
+ payload.responsible = userId || assigned_to;
91
+ }
92
+ const response = await this.apiClient.post(`/task/item/${itemId}/`, payload);
93
+ return response.data;
94
+ }
95
+ /**
96
+ * Update an existing task
97
+ */
98
+ async updateTask(taskId, updateData) {
99
+ const { text, description, due_date, completed } = updateData;
100
+ if (!taskId) {
101
+ throw PodioValidationError.requiredField('task_id', 'update task');
102
+ }
103
+ const payload = {};
104
+ let hasUpdates = false;
105
+ if (text) {
106
+ payload.text = text;
107
+ hasUpdates = true;
108
+ }
109
+ if (description !== undefined) {
110
+ payload.description = description;
111
+ hasUpdates = true;
112
+ }
113
+ if (due_date !== undefined) {
114
+ payload.due_date = due_date;
115
+ hasUpdates = true;
116
+ }
117
+ if (completed !== undefined) {
118
+ payload.completed = completed;
119
+ hasUpdates = true;
120
+ }
121
+ if (!hasUpdates) {
122
+ throw PodioValidationError.invalidFieldValue('No fields', 'provided for update', 'At least one field must be provided');
123
+ }
124
+ return await this.apiClient.updateTask(taskId, payload);
125
+ }
126
+ /**
127
+ * Delete a task
128
+ */
129
+ async deleteTask(taskId) {
130
+ if (!taskId) {
131
+ throw PodioValidationError.requiredField('task_id', 'delete task');
132
+ }
133
+ await this.apiClient.deleteTask(taskId);
134
+ }
135
+ /**
136
+ * Get task details by ID
137
+ */
138
+ async getTaskDetails(taskId) {
139
+ if (!taskId) {
140
+ throw PodioValidationError.requiredField('task_id', 'get task details');
141
+ }
142
+ const response = await this.apiClient.get(`/task/${taskId}`);
143
+ return response.data;
144
+ }
145
+ // ===============================
146
+ // HELPER METHODS
147
+ // ===============================
148
+ /**
149
+ * Resolve user by name or email to user ID
150
+ */
151
+ async resolveUser(nameOrEmail) {
152
+ const user = await this.cacheManager.findUser(nameOrEmail);
153
+ return user ? user.member.user.user_id : null;
154
+ }
155
+ }
156
+ //# sourceMappingURL=task-service.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"task-service.js","sourceRoot":"","sources":["../../src/services/task-service.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,8 @@
1
+ /**
2
+ * Tools Module Index
3
+ *
4
+ * This module exports the tool definitions and related utilities
5
+ * for use throughout the MCP server.
6
+ */
7
+ export { ToolDefinitions, toolDefinitions, getAllTools, getToolByName, validateToolSchema, type ToolDefinition, type ToolSchema, type ToolCategory, } from './tool-definitions.js';
8
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,eAAe,EACf,eAAe,EACf,WAAW,EACX,aAAa,EACb,kBAAkB,EAClB,KAAK,cAAc,EACnB,KAAK,UAAU,EACf,KAAK,YAAY,GAClB,MAAM,uBAAuB,CAAC"}
@@ -0,0 +1,8 @@
1
+ /**
2
+ * Tools Module Index
3
+ *
4
+ * This module exports the tool definitions and related utilities
5
+ * for use throughout the MCP server.
6
+ */
7
+ export { ToolDefinitions, toolDefinitions, getAllTools, getToolByName, validateToolSchema, } from './tool-definitions.js';
8
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,eAAe,EACf,eAAe,EACf,WAAW,EACX,aAAa,EACb,kBAAkB,GAInB,MAAM,uBAAuB,CAAC"}
@@ -0,0 +1,89 @@
1
+ /**
2
+ * Tool Definitions and Configuration
3
+ *
4
+ * This module provides a configuration-based system for defining MCP tools,
5
+ * organized by functional categories for better maintainability and testing.
6
+ */
7
+ export interface ToolSchema {
8
+ type: 'object';
9
+ properties: Record<string, {
10
+ type: string;
11
+ description: string;
12
+ }>;
13
+ required?: string[];
14
+ }
15
+ export interface ToolDefinition {
16
+ name: string;
17
+ description: string;
18
+ inputSchema: ToolSchema;
19
+ category: string;
20
+ }
21
+ export interface ToolCategory {
22
+ name: string;
23
+ description: string;
24
+ tools: ToolDefinition[];
25
+ }
26
+ export declare class ToolDefinitions {
27
+ private static instance;
28
+ private readonly appManagement;
29
+ private readonly itemOperations;
30
+ private readonly taskManagement;
31
+ private readonly projectEpicManagement;
32
+ private readonly notificationManagement;
33
+ private readonly utilityTools;
34
+ private readonly searchOperations;
35
+ private readonly commentActivityOperations;
36
+ private readonly codeExecution;
37
+ private constructor();
38
+ /**
39
+ * Get singleton instance of ToolDefinitions
40
+ */
41
+ static getInstance(): ToolDefinitions;
42
+ /**
43
+ * Get all tool categories
44
+ */
45
+ getCategories(): ToolCategory[];
46
+ /**
47
+ * Get tools by category
48
+ */
49
+ getToolsByCategory(categoryName: string): ToolDefinition[];
50
+ /**
51
+ * Get a specific tool definition by name
52
+ */
53
+ getToolByName(toolName: string): ToolDefinition | undefined;
54
+ /**
55
+ * Get all tools as a flat array (compatible with MCP server)
56
+ */
57
+ getAllTools(): ToolDefinition[];
58
+ getMcpTools(): Omit<ToolDefinition, 'category'>[];
59
+ /**
60
+ * Validate a tool's input schema
61
+ */
62
+ validateToolSchema(toolName: string, input: any): {
63
+ valid: boolean;
64
+ errors: string[];
65
+ };
66
+ /**
67
+ * Get tool statistics
68
+ */
69
+ getStatistics(): {
70
+ totalTools: number;
71
+ categoryCounts: Record<string, number>;
72
+ toolsWithRequiredParams: number;
73
+ };
74
+ }
75
+ /**
76
+ * Export the singleton instance for easy use
77
+ */
78
+ export declare const toolDefinitions: ToolDefinitions;
79
+ /**
80
+ * Export commonly used functions
81
+ */
82
+ export declare const getAllTools: () => ToolDefinition[];
83
+ export declare const getMcpTools: () => Omit<ToolDefinition, "category">[];
84
+ export declare const getToolByName: (name: string) => ToolDefinition | undefined;
85
+ export declare const validateToolSchema: (toolName: string, input: any) => {
86
+ valid: boolean;
87
+ errors: string[];
88
+ };
89
+ //# sourceMappingURL=tool-definitions.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"tool-definitions.d.ts","sourceRoot":"","sources":["../../src/tools/tool-definitions.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,QAAQ,CAAC;IACf,UAAU,EAAE,MAAM,CAChB,MAAM,EACN;QACE,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;KACrB,CACF,CAAC;IACF,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,UAAU,CAAC;IACxB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,cAAc,EAAE,CAAC;CACzB;AAED,qBAAa,eAAe;IAC1B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAkB;IAGzC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAmI5B;IAEF,OAAO,CAAC,QAAQ,CAAC,cAAc,CA8P7B;IAEF,OAAO,CAAC,QAAQ,CAAC,cAAc,CA0J7B;IAEF,OAAO,CAAC,QAAQ,CAAC,qBAAqB,CAuDpC;IAEF,OAAO,CAAC,QAAQ,CAAC,sBAAsB,CAsFrC;IAEF,OAAO,CAAC,QAAQ,CAAC,YAAY,CAmC3B;IAEF,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAoK/B;IAEF,OAAO,CAAC,QAAQ,CAAC,yBAAyB,CAiJxC;IAEF,OAAO,CAAC,QAAQ,CAAC,aAAa,CA0C5B;IAEF,OAAO;IAEP;;OAEG;WACW,WAAW,IAAI,eAAe;IAO5C;;OAEG;IACI,aAAa,IAAI,YAAY,EAAE;IActC;;OAEG;IACI,kBAAkB,CAAC,YAAY,EAAE,MAAM,GAAG,cAAc,EAAE;IAOjE;;OAEG;IACI,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS;IAKlE;;OAEG;IACI,WAAW,IAAI,cAAc,EAAE;IAU/B,WAAW,IAAI,IAAI,CAAC,cAAc,EAAE,UAAU,CAAC,EAAE;IAIxD;;OAEG;IACI,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,GAAG;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,MAAM,EAAE,CAAA;KAAE;IAuC7F;;OAEG;IACI,aAAa,IAAI;QACtB,UAAU,EAAE,MAAM,CAAC;QACnB,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACvC,uBAAuB,EAAE,MAAM,CAAC;KACjC;CAqBF;AAED;;GAEG;AACH,eAAO,MAAM,eAAe,iBAAgC,CAAC;AAE7D;;GAEG;AACH,eAAO,MAAM,WAAW,wBAAsC,CAAC;AAC/D,eAAO,MAAM,WAAW,0CAAsC,CAAC;AAC/D,eAAO,MAAM,aAAa,GAAI,MAAM,MAAM,+BAAwC,CAAC;AACnF,eAAO,MAAM,kBAAkB,GAAI,UAAU,MAAM,EAAE,OAAO,GAAG;WAhFK,OAAO;YAAU,MAAM,EAAE;CAiFxC,CAAC"}