@memberjunction/server 3.4.0 → 4.1.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 (269) hide show
  1. package/README.md +689 -513
  2. package/dist/agents/skip-agent.d.ts +65 -0
  3. package/dist/agents/skip-agent.d.ts.map +1 -1
  4. package/dist/agents/skip-agent.js +63 -5
  5. package/dist/agents/skip-agent.js.map +1 -1
  6. package/dist/agents/skip-sdk.d.ts +163 -0
  7. package/dist/agents/skip-sdk.d.ts.map +1 -1
  8. package/dist/agents/skip-sdk.js +143 -12
  9. package/dist/agents/skip-sdk.js.map +1 -1
  10. package/dist/apolloServer/index.d.ts +0 -1
  11. package/dist/apolloServer/index.d.ts.map +1 -1
  12. package/dist/auth/APIKeyScopeAuth.d.ts +82 -0
  13. package/dist/auth/APIKeyScopeAuth.d.ts.map +1 -1
  14. package/dist/auth/APIKeyScopeAuth.js +78 -0
  15. package/dist/auth/APIKeyScopeAuth.js.map +1 -1
  16. package/dist/auth/AuthProviderFactory.d.ts +35 -0
  17. package/dist/auth/AuthProviderFactory.d.ts.map +1 -1
  18. package/dist/auth/AuthProviderFactory.js +51 -4
  19. package/dist/auth/AuthProviderFactory.js.map +1 -1
  20. package/dist/auth/BaseAuthProvider.d.ts +21 -0
  21. package/dist/auth/BaseAuthProvider.d.ts.map +1 -1
  22. package/dist/auth/BaseAuthProvider.js +24 -9
  23. package/dist/auth/BaseAuthProvider.js.map +1 -1
  24. package/dist/auth/IAuthProvider.d.ts +32 -0
  25. package/dist/auth/IAuthProvider.d.ts.map +1 -1
  26. package/dist/auth/exampleNewUserSubClass.d.ts +5 -1
  27. package/dist/auth/exampleNewUserSubClass.d.ts.map +1 -1
  28. package/dist/auth/exampleNewUserSubClass.js +21 -6
  29. package/dist/auth/exampleNewUserSubClass.js.map +1 -1
  30. package/dist/auth/index.d.ts +14 -0
  31. package/dist/auth/index.d.ts.map +1 -1
  32. package/dist/auth/index.js +35 -22
  33. package/dist/auth/index.js.map +1 -1
  34. package/dist/auth/initializeProviders.d.ts +3 -0
  35. package/dist/auth/initializeProviders.d.ts.map +1 -1
  36. package/dist/auth/initializeProviders.js +6 -0
  37. package/dist/auth/initializeProviders.js.map +1 -1
  38. package/dist/auth/newUsers.d.ts.map +1 -1
  39. package/dist/auth/newUsers.js +14 -3
  40. package/dist/auth/newUsers.js.map +1 -1
  41. package/dist/auth/providers/Auth0Provider.d.ts +9 -0
  42. package/dist/auth/providers/Auth0Provider.d.ts.map +1 -1
  43. package/dist/auth/providers/Auth0Provider.js +10 -0
  44. package/dist/auth/providers/Auth0Provider.js.map +1 -1
  45. package/dist/auth/providers/CognitoProvider.d.ts +9 -0
  46. package/dist/auth/providers/CognitoProvider.d.ts.map +1 -1
  47. package/dist/auth/providers/CognitoProvider.js +10 -0
  48. package/dist/auth/providers/CognitoProvider.js.map +1 -1
  49. package/dist/auth/providers/GoogleProvider.d.ts +9 -0
  50. package/dist/auth/providers/GoogleProvider.d.ts.map +1 -1
  51. package/dist/auth/providers/GoogleProvider.js +11 -1
  52. package/dist/auth/providers/GoogleProvider.js.map +1 -1
  53. package/dist/auth/providers/MSALProvider.d.ts +9 -0
  54. package/dist/auth/providers/MSALProvider.d.ts.map +1 -1
  55. package/dist/auth/providers/MSALProvider.js +10 -0
  56. package/dist/auth/providers/MSALProvider.js.map +1 -1
  57. package/dist/auth/providers/OktaProvider.d.ts +9 -0
  58. package/dist/auth/providers/OktaProvider.d.ts.map +1 -1
  59. package/dist/auth/providers/OktaProvider.js +10 -0
  60. package/dist/auth/providers/OktaProvider.js.map +1 -1
  61. package/dist/config.d.ts +12 -0
  62. package/dist/config.d.ts.map +1 -1
  63. package/dist/config.js +42 -8
  64. package/dist/config.js.map +1 -1
  65. package/dist/context.d.ts +8 -1
  66. package/dist/context.d.ts.map +1 -1
  67. package/dist/context.js +26 -4
  68. package/dist/context.js.map +1 -1
  69. package/dist/directives/Public.js +2 -0
  70. package/dist/directives/Public.js.map +1 -1
  71. package/dist/entitySubclasses/entityPermissions.server.d.ts +7 -2
  72. package/dist/entitySubclasses/entityPermissions.server.d.ts.map +1 -1
  73. package/dist/entitySubclasses/entityPermissions.server.js +26 -8
  74. package/dist/entitySubclasses/entityPermissions.server.js.map +1 -1
  75. package/dist/generated/generated.d.ts +539 -2
  76. package/dist/generated/generated.d.ts.map +1 -1
  77. package/dist/generated/generated.js +9985 -14951
  78. package/dist/generated/generated.js.map +1 -1
  79. package/dist/generic/DeleteOptionsInput.d.ts +3 -0
  80. package/dist/generic/DeleteOptionsInput.d.ts.map +1 -1
  81. package/dist/generic/DeleteOptionsInput.js +3 -2
  82. package/dist/generic/DeleteOptionsInput.js.map +1 -1
  83. package/dist/generic/KeyInputOutputTypes.js +0 -6
  84. package/dist/generic/KeyInputOutputTypes.js.map +1 -1
  85. package/dist/generic/KeyValuePairInput.d.ts +4 -0
  86. package/dist/generic/KeyValuePairInput.d.ts.map +1 -1
  87. package/dist/generic/KeyValuePairInput.js +4 -2
  88. package/dist/generic/KeyValuePairInput.js.map +1 -1
  89. package/dist/generic/PushStatusResolver.js +0 -3
  90. package/dist/generic/PushStatusResolver.js.map +1 -1
  91. package/dist/generic/ResolverBase.d.ts +58 -0
  92. package/dist/generic/ResolverBase.d.ts.map +1 -1
  93. package/dist/generic/ResolverBase.js +203 -18
  94. package/dist/generic/ResolverBase.js.map +1 -1
  95. package/dist/generic/RunViewResolver.d.ts +22 -0
  96. package/dist/generic/RunViewResolver.d.ts.map +1 -1
  97. package/dist/generic/RunViewResolver.js +42 -108
  98. package/dist/generic/RunViewResolver.js.map +1 -1
  99. package/dist/index.d.ts +12 -0
  100. package/dist/index.d.ts.map +1 -1
  101. package/dist/index.js +94 -37
  102. package/dist/index.js.map +1 -1
  103. package/dist/orm.d.ts.map +1 -1
  104. package/dist/orm.js +2 -1
  105. package/dist/orm.js.map +1 -1
  106. package/dist/resolvers/APIKeyResolver.d.ts +74 -0
  107. package/dist/resolvers/APIKeyResolver.d.ts.map +1 -1
  108. package/dist/resolvers/APIKeyResolver.js +49 -10
  109. package/dist/resolvers/APIKeyResolver.js.map +1 -1
  110. package/dist/resolvers/ActionResolver.d.ts +189 -0
  111. package/dist/resolvers/ActionResolver.d.ts.map +1 -1
  112. package/dist/resolvers/ActionResolver.js +152 -21
  113. package/dist/resolvers/ActionResolver.js.map +1 -1
  114. package/dist/resolvers/ColorResolver.js +0 -5
  115. package/dist/resolvers/ColorResolver.js.map +1 -1
  116. package/dist/resolvers/ComponentRegistryResolver.d.ts +65 -0
  117. package/dist/resolvers/ComponentRegistryResolver.d.ts.map +1 -1
  118. package/dist/resolvers/ComponentRegistryResolver.js +118 -40
  119. package/dist/resolvers/ComponentRegistryResolver.js.map +1 -1
  120. package/dist/resolvers/CreateQueryResolver.d.ts +47 -0
  121. package/dist/resolvers/CreateQueryResolver.d.ts.map +1 -1
  122. package/dist/resolvers/CreateQueryResolver.js +92 -116
  123. package/dist/resolvers/CreateQueryResolver.js.map +1 -1
  124. package/dist/resolvers/DatasetResolver.js +2 -14
  125. package/dist/resolvers/DatasetResolver.js.map +1 -1
  126. package/dist/resolvers/EntityCommunicationsResolver.d.ts +40 -0
  127. package/dist/resolvers/EntityCommunicationsResolver.d.ts.map +1 -1
  128. package/dist/resolvers/EntityCommunicationsResolver.js +2 -36
  129. package/dist/resolvers/EntityCommunicationsResolver.js.map +1 -1
  130. package/dist/resolvers/EntityRecordNameResolver.js +0 -7
  131. package/dist/resolvers/EntityRecordNameResolver.js.map +1 -1
  132. package/dist/resolvers/FileCategoryResolver.d.ts +1 -1
  133. package/dist/resolvers/FileCategoryResolver.d.ts.map +1 -1
  134. package/dist/resolvers/FileCategoryResolver.js +15 -3
  135. package/dist/resolvers/FileCategoryResolver.js.map +1 -1
  136. package/dist/resolvers/FileResolver.d.ts +16 -0
  137. package/dist/resolvers/FileResolver.d.ts.map +1 -1
  138. package/dist/resolvers/FileResolver.js +59 -74
  139. package/dist/resolvers/FileResolver.js.map +1 -1
  140. package/dist/resolvers/GetDataContextDataResolver.d.ts +18 -1
  141. package/dist/resolvers/GetDataContextDataResolver.d.ts.map +1 -1
  142. package/dist/resolvers/GetDataContextDataResolver.js +17 -9
  143. package/dist/resolvers/GetDataContextDataResolver.js.map +1 -1
  144. package/dist/resolvers/GetDataResolver.d.ts +19 -0
  145. package/dist/resolvers/GetDataResolver.d.ts.map +1 -1
  146. package/dist/resolvers/GetDataResolver.js +35 -35
  147. package/dist/resolvers/GetDataResolver.js.map +1 -1
  148. package/dist/resolvers/InfoResolver.d.ts +2 -2
  149. package/dist/resolvers/InfoResolver.d.ts.map +1 -1
  150. package/dist/resolvers/InfoResolver.js +17 -20
  151. package/dist/resolvers/InfoResolver.js.map +1 -1
  152. package/dist/resolvers/MCPResolver.d.ts +325 -1
  153. package/dist/resolvers/MCPResolver.d.ts.map +1 -1
  154. package/dist/resolvers/MCPResolver.js +931 -24
  155. package/dist/resolvers/MCPResolver.js.map +1 -1
  156. package/dist/resolvers/MergeRecordsResolver.js +3 -29
  157. package/dist/resolvers/MergeRecordsResolver.js.map +1 -1
  158. package/dist/resolvers/PotentialDuplicateRecordResolver.d.ts.map +1 -1
  159. package/dist/resolvers/PotentialDuplicateRecordResolver.js +0 -3
  160. package/dist/resolvers/PotentialDuplicateRecordResolver.js.map +1 -1
  161. package/dist/resolvers/QueryResolver.d.ts +20 -0
  162. package/dist/resolvers/QueryResolver.d.ts.map +1 -1
  163. package/dist/resolvers/QueryResolver.js +44 -36
  164. package/dist/resolvers/QueryResolver.js.map +1 -1
  165. package/dist/resolvers/ReportResolver.d.ts +3 -0
  166. package/dist/resolvers/ReportResolver.d.ts.map +1 -1
  167. package/dist/resolvers/ReportResolver.js +9 -10
  168. package/dist/resolvers/ReportResolver.js.map +1 -1
  169. package/dist/resolvers/RunAIAgentResolver.d.ts +54 -0
  170. package/dist/resolvers/RunAIAgentResolver.d.ts.map +1 -1
  171. package/dist/resolvers/RunAIAgentResolver.js +116 -40
  172. package/dist/resolvers/RunAIAgentResolver.js.map +1 -1
  173. package/dist/resolvers/RunAIPromptResolver.d.ts +42 -0
  174. package/dist/resolvers/RunAIPromptResolver.d.ts.map +1 -1
  175. package/dist/resolvers/RunAIPromptResolver.js +95 -22
  176. package/dist/resolvers/RunAIPromptResolver.js.map +1 -1
  177. package/dist/resolvers/RunTemplateResolver.js +9 -6
  178. package/dist/resolvers/RunTemplateResolver.js.map +1 -1
  179. package/dist/resolvers/RunTestResolver.d.ts +12 -0
  180. package/dist/resolvers/RunTestResolver.d.ts.map +1 -1
  181. package/dist/resolvers/RunTestResolver.js +35 -21
  182. package/dist/resolvers/RunTestResolver.js.map +1 -1
  183. package/dist/resolvers/SqlLoggingConfigResolver.d.ts +312 -0
  184. package/dist/resolvers/SqlLoggingConfigResolver.d.ts.map +1 -1
  185. package/dist/resolvers/SqlLoggingConfigResolver.js +295 -45
  186. package/dist/resolvers/SqlLoggingConfigResolver.js.map +1 -1
  187. package/dist/resolvers/SyncDataResolver.d.ts +21 -0
  188. package/dist/resolvers/SyncDataResolver.d.ts.map +1 -1
  189. package/dist/resolvers/SyncDataResolver.js +36 -22
  190. package/dist/resolvers/SyncDataResolver.js.map +1 -1
  191. package/dist/resolvers/SyncRolesUsersResolver.d.ts +14 -0
  192. package/dist/resolvers/SyncRolesUsersResolver.d.ts.map +1 -1
  193. package/dist/resolvers/SyncRolesUsersResolver.js +54 -21
  194. package/dist/resolvers/SyncRolesUsersResolver.js.map +1 -1
  195. package/dist/resolvers/TaskResolver.d.ts +13 -0
  196. package/dist/resolvers/TaskResolver.d.ts.map +1 -1
  197. package/dist/resolvers/TaskResolver.js +22 -7
  198. package/dist/resolvers/TaskResolver.js.map +1 -1
  199. package/dist/resolvers/TelemetryResolver.d.ts +22 -0
  200. package/dist/resolvers/TelemetryResolver.d.ts.map +1 -1
  201. package/dist/resolvers/TelemetryResolver.js +45 -79
  202. package/dist/resolvers/TelemetryResolver.js.map +1 -1
  203. package/dist/resolvers/TransactionGroupResolver.js +11 -13
  204. package/dist/resolvers/TransactionGroupResolver.js.map +1 -1
  205. package/dist/resolvers/UserFavoriteResolver.js +3 -12
  206. package/dist/resolvers/UserFavoriteResolver.js.map +1 -1
  207. package/dist/resolvers/UserResolver.js +10 -0
  208. package/dist/resolvers/UserResolver.js.map +1 -1
  209. package/dist/resolvers/UserViewResolver.js +4 -0
  210. package/dist/resolvers/UserViewResolver.js.map +1 -1
  211. package/dist/resolvers/VersionHistoryResolver.d.ts +39 -0
  212. package/dist/resolvers/VersionHistoryResolver.d.ts.map +1 -0
  213. package/dist/resolvers/VersionHistoryResolver.js +208 -0
  214. package/dist/resolvers/VersionHistoryResolver.js.map +1 -0
  215. package/dist/rest/EntityCRUDHandler.d.ts +19 -0
  216. package/dist/rest/EntityCRUDHandler.d.ts.map +1 -1
  217. package/dist/rest/EntityCRUDHandler.js +55 -0
  218. package/dist/rest/EntityCRUDHandler.js.map +1 -1
  219. package/dist/rest/OAuthCallbackHandler.d.ts +143 -0
  220. package/dist/rest/OAuthCallbackHandler.d.ts.map +1 -0
  221. package/dist/rest/OAuthCallbackHandler.js +634 -0
  222. package/dist/rest/OAuthCallbackHandler.js.map +1 -0
  223. package/dist/rest/RESTEndpointHandler.d.ts +120 -0
  224. package/dist/rest/RESTEndpointHandler.d.ts.map +1 -1
  225. package/dist/rest/RESTEndpointHandler.js +213 -24
  226. package/dist/rest/RESTEndpointHandler.js.map +1 -1
  227. package/dist/rest/ViewOperationsHandler.d.ts +19 -0
  228. package/dist/rest/ViewOperationsHandler.d.ts.map +1 -1
  229. package/dist/rest/ViewOperationsHandler.js +39 -0
  230. package/dist/rest/ViewOperationsHandler.js.map +1 -1
  231. package/dist/rest/index.d.ts +1 -0
  232. package/dist/rest/index.d.ts.map +1 -1
  233. package/dist/rest/index.js +1 -0
  234. package/dist/rest/index.js.map +1 -1
  235. package/dist/rest/setupRESTEndpoints.d.ts +35 -0
  236. package/dist/rest/setupRESTEndpoints.d.ts.map +1 -1
  237. package/dist/rest/setupRESTEndpoints.js +15 -1
  238. package/dist/rest/setupRESTEndpoints.js.map +1 -1
  239. package/dist/services/ScheduledJobsService.d.ts +31 -0
  240. package/dist/services/ScheduledJobsService.d.ts.map +1 -1
  241. package/dist/services/ScheduledJobsService.js +38 -4
  242. package/dist/services/ScheduledJobsService.js.map +1 -1
  243. package/dist/services/TaskOrchestrator.d.ts +73 -0
  244. package/dist/services/TaskOrchestrator.d.ts.map +1 -1
  245. package/dist/services/TaskOrchestrator.js +137 -15
  246. package/dist/services/TaskOrchestrator.js.map +1 -1
  247. package/dist/types.d.ts +14 -0
  248. package/dist/types.d.ts.map +1 -1
  249. package/dist/types.js +0 -13
  250. package/dist/types.js.map +1 -1
  251. package/dist/util.d.ts +37 -1
  252. package/dist/util.d.ts.map +1 -1
  253. package/dist/util.js +55 -8
  254. package/dist/util.js.map +1 -1
  255. package/package.json +83 -78
  256. package/src/auth/exampleNewUserSubClass.ts +1 -5
  257. package/src/auth/newUsers.ts +4 -2
  258. package/src/entitySubclasses/entityPermissions.server.ts +1 -3
  259. package/src/generated/generated.ts +4707 -2664
  260. package/src/index.ts +73 -62
  261. package/src/resolvers/FileCategoryResolver.ts +1 -1
  262. package/src/resolvers/InfoResolver.ts +10 -6
  263. package/src/resolvers/MCPResolver.ts +910 -10
  264. package/src/resolvers/PotentialDuplicateRecordResolver.ts +0 -4
  265. package/src/resolvers/VersionHistoryResolver.ts +177 -0
  266. package/src/rest/OAuthCallbackHandler.ts +766 -0
  267. package/src/rest/RESTEndpointHandler.ts +58 -35
  268. package/src/rest/index.ts +2 -1
  269. package/src/rest/setupRESTEndpoints.ts +13 -12
@@ -1,37 +1,361 @@
1
+ /**
2
+ * @fileoverview MCP GraphQL Resolver
3
+ *
4
+ * Provides GraphQL mutations for MCP (Model Context Protocol) operations
5
+ * including tool synchronization with progress streaming and OAuth management.
6
+ */
1
7
  import { PubSubEngine } from 'type-graphql';
2
8
  import { AppContext } from '../types.js';
3
9
  import { ResolverBase } from '../generic/ResolverBase.js';
10
+ /**
11
+ * Input type for syncing MCP tools
12
+ */
4
13
  export declare class SyncMCPToolsInput {
14
+ /**
15
+ * The ID of the MCP server connection to sync tools for
16
+ */
5
17
  ConnectionID: string;
18
+ /**
19
+ * Optional flag to force a full sync even if recently synced
20
+ */
6
21
  ForceSync?: boolean;
7
22
  }
23
+ /**
24
+ * Output type for MCP tool sync results
25
+ */
8
26
  export declare class SyncMCPToolsResult {
27
+ /**
28
+ * Whether the sync operation succeeded
29
+ */
9
30
  Success: boolean;
31
+ /**
32
+ * Error message if the operation failed
33
+ */
10
34
  ErrorMessage?: string;
35
+ /**
36
+ * Number of tools newly added
37
+ */
11
38
  Added: number;
39
+ /**
40
+ * Number of tools updated
41
+ */
12
42
  Updated: number;
43
+ /**
44
+ * Number of tools marked as deprecated
45
+ */
13
46
  Deprecated: number;
47
+ /**
48
+ * Total number of tools after sync
49
+ */
14
50
  Total: number;
51
+ /**
52
+ * Name of the MCP server that was synced
53
+ */
15
54
  ServerName?: string;
55
+ /**
56
+ * Connection name that was synced
57
+ */
16
58
  ConnectionName?: string;
59
+ /**
60
+ * Whether OAuth authorization is required before connecting
61
+ */
62
+ RequiresOAuth?: boolean;
63
+ /**
64
+ * OAuth authorization URL if authorization is required
65
+ */
66
+ AuthorizationUrl?: string;
67
+ /**
68
+ * OAuth state parameter for tracking the authorization flow
69
+ */
70
+ StateParameter?: string;
71
+ /**
72
+ * Whether OAuth re-authorization is required
73
+ */
74
+ RequiresReauthorization?: boolean;
75
+ /**
76
+ * Reason for re-authorization if required
77
+ */
78
+ ReauthorizationReason?: string;
17
79
  }
80
+ /**
81
+ * Input type for executing an MCP tool
82
+ */
18
83
  export declare class ExecuteMCPToolInput {
84
+ /**
85
+ * The ID of the MCP server connection to use
86
+ */
19
87
  ConnectionID: string;
88
+ /**
89
+ * The ID of the tool to execute (from MCP Server Tools entity)
90
+ */
20
91
  ToolID: string;
92
+ /**
93
+ * The name of the tool to execute
94
+ */
21
95
  ToolName: string;
96
+ /**
97
+ * JSON string of input arguments to pass to the tool
98
+ */
22
99
  InputArgs?: string;
23
100
  }
101
+ /**
102
+ * Output type for MCP tool execution results
103
+ */
24
104
  export declare class ExecuteMCPToolResult {
105
+ /**
106
+ * Whether the tool execution succeeded
107
+ */
25
108
  Success: boolean;
109
+ /**
110
+ * Error message if the execution failed
111
+ */
26
112
  ErrorMessage?: string;
113
+ /**
114
+ * The result returned by the tool (JSON)
115
+ */
27
116
  Result?: Record<string, unknown> | null;
117
+ /**
118
+ * Execution duration in milliseconds
119
+ */
28
120
  DurationMs?: number;
29
121
  }
122
+ /**
123
+ * OAuth authorization status enum
124
+ */
125
+ declare enum MCPOAuthStatus {
126
+ PENDING = "PENDING",
127
+ COMPLETED = "COMPLETED",
128
+ FAILED = "FAILED",
129
+ EXPIRED = "EXPIRED"
130
+ }
131
+ /**
132
+ * Input for initiating OAuth authorization
133
+ */
134
+ export declare class InitiateMCPOAuthInput {
135
+ ConnectionID: string;
136
+ AdditionalScopes?: string;
137
+ FrontendCallbackUrl?: string;
138
+ }
139
+ /**
140
+ * Input for checking OAuth status
141
+ */
142
+ export declare class GetMCPOAuthStatusInput {
143
+ StateParameter: string;
144
+ }
145
+ /**
146
+ * Input for revoking OAuth credentials
147
+ */
148
+ export declare class RevokeMCPOAuthInput {
149
+ ConnectionID: string;
150
+ Reason?: string;
151
+ }
152
+ /**
153
+ * Input for refreshing OAuth tokens
154
+ */
155
+ export declare class RefreshMCPOAuthTokenInput {
156
+ ConnectionID: string;
157
+ }
158
+ /**
159
+ * Result from initiating OAuth authorization
160
+ */
161
+ export declare class InitiateMCPOAuthResult {
162
+ Success: boolean;
163
+ ErrorMessage?: string;
164
+ AuthorizationUrl?: string;
165
+ StateParameter?: string;
166
+ ExpiresAt?: Date;
167
+ UsedDynamicRegistration?: boolean;
168
+ }
169
+ /**
170
+ * Result from checking OAuth status
171
+ */
172
+ export declare class MCPOAuthStatusResult {
173
+ Success: boolean;
174
+ ErrorMessage?: string;
175
+ Status?: MCPOAuthStatus;
176
+ ConnectionID?: string;
177
+ InitiatedAt?: Date;
178
+ CompletedAt?: Date;
179
+ AuthErrorCode?: string;
180
+ AuthErrorDescription?: string;
181
+ IsRetryable?: boolean;
182
+ }
183
+ /**
184
+ * Result from revoking OAuth credentials
185
+ */
186
+ export declare class RevokeMCPOAuthResult {
187
+ Success: boolean;
188
+ ErrorMessage?: string;
189
+ ConnectionID?: string;
190
+ }
191
+ /**
192
+ * Result from refreshing OAuth tokens
193
+ */
194
+ export declare class RefreshMCPOAuthTokenResult {
195
+ Success: boolean;
196
+ ErrorMessage?: string;
197
+ ExpiresAt?: Date;
198
+ RequiresReauthorization?: boolean;
199
+ }
200
+ /**
201
+ * OAuth connection status information
202
+ */
203
+ export declare class MCPOAuthConnectionStatus {
204
+ ConnectionID: string;
205
+ IsOAuthEnabled: boolean;
206
+ HasValidTokens: boolean;
207
+ IsAccessTokenExpired?: boolean;
208
+ TokenExpiresAt?: Date;
209
+ HasRefreshToken?: boolean;
210
+ RequiresReauthorization: boolean;
211
+ ReauthorizationReason?: string;
212
+ IssuerUrl?: string;
213
+ GrantedScopes?: string;
214
+ }
215
+ /** PubSub topic for MCP OAuth events */
216
+ export declare const MCP_OAUTH_EVENTS_TOPIC = "MCP_OAUTH_EVENTS";
217
+ /**
218
+ * OAuth event types for subscriptions
219
+ */
220
+ export type MCPOAuthEventType = 'authorizationRequired' | 'authorizationCompleted' | 'tokenRefreshed' | 'tokenRefreshFailed';
221
+ /**
222
+ * Payload interface for OAuth subscription events
223
+ */
224
+ export interface MCPOAuthEventPayload {
225
+ eventType: MCPOAuthEventType;
226
+ connectionId: string;
227
+ timestamp: string;
228
+ authorizationUrl?: string;
229
+ stateParameter?: string;
230
+ errorMessage?: string;
231
+ requiresReauthorization?: boolean;
232
+ }
233
+ /**
234
+ * Notification type for OAuth events
235
+ */
236
+ export declare class MCPOAuthEventNotification {
237
+ EventType: string;
238
+ ConnectionID: string;
239
+ Timestamp: Date;
240
+ AuthorizationUrl?: string;
241
+ StateParameter?: string;
242
+ ErrorMessage?: string;
243
+ RequiresReauthorization?: boolean;
244
+ }
245
+ /**
246
+ * MCP Resolver for GraphQL operations
247
+ */
30
248
  export declare class MCPResolver extends ResolverBase {
249
+ /**
250
+ * Syncs tools from an MCP server connection to the database.
251
+ * Publishes progress updates via the statusUpdates subscription.
252
+ *
253
+ * @param input The sync input parameters
254
+ * @param ctx The GraphQL context
255
+ * @param pubSub PubSub engine for progress updates
256
+ * @returns The sync result
257
+ */
31
258
  SyncMCPTools(input: SyncMCPToolsInput, ctx: AppContext, pubSub: PubSubEngine): Promise<SyncMCPToolsResult>;
259
+ /**
260
+ * Executes an MCP tool and returns the result.
261
+ *
262
+ * @param input The execution input parameters
263
+ * @param ctx The GraphQL context
264
+ * @returns The execution result
265
+ */
32
266
  ExecuteMCPTool(input: ExecuteMCPToolInput, ctx: AppContext): Promise<ExecuteMCPToolResult>;
267
+ /**
268
+ * Gets OAuth connection status for an MCP connection.
269
+ *
270
+ * @param connectionId - The MCP Server Connection ID
271
+ * @param ctx - GraphQL context
272
+ * @returns OAuth connection status
273
+ */
274
+ GetMCPOAuthConnectionStatus(connectionId: string, ctx: AppContext): Promise<MCPOAuthConnectionStatus>;
275
+ /**
276
+ * Gets OAuth authorization flow status by state parameter.
277
+ *
278
+ * @param input - Input containing state parameter
279
+ * @param ctx - GraphQL context
280
+ * @returns OAuth status result
281
+ */
282
+ GetMCPOAuthStatus(input: GetMCPOAuthStatusInput, ctx: AppContext): Promise<MCPOAuthStatusResult>;
283
+ /**
284
+ * Initiates an OAuth authorization flow for an MCP connection.
285
+ *
286
+ * @param input - Input containing connection ID and optional scopes
287
+ * @param ctx - GraphQL context
288
+ * @returns Initiation result with authorization URL
289
+ */
290
+ InitiateMCPOAuth(input: InitiateMCPOAuthInput, ctx: AppContext): Promise<InitiateMCPOAuthResult>;
291
+ /**
292
+ * Revokes OAuth credentials for an MCP connection.
293
+ *
294
+ * @param input - Input containing connection ID and optional reason
295
+ * @param ctx - GraphQL context
296
+ * @returns Revocation result
297
+ */
298
+ RevokeMCPOAuth(input: RevokeMCPOAuthInput, ctx: AppContext): Promise<RevokeMCPOAuthResult>;
299
+ /**
300
+ * Manually refreshes OAuth tokens for an MCP connection.
301
+ *
302
+ * @param input - Input containing connection ID
303
+ * @param ctx - GraphQL context
304
+ * @returns Refresh result
305
+ */
306
+ RefreshMCPOAuthToken(input: RefreshMCPOAuthTokenInput, ctx: AppContext): Promise<RefreshMCPOAuthTokenResult>;
307
+ /**
308
+ * Subscribes to OAuth events for MCP connections.
309
+ *
310
+ * Clients can subscribe to receive real-time notifications when:
311
+ * - Authorization is required for a connection
312
+ * - Authorization completes successfully
313
+ * - Token is refreshed
314
+ * - Token refresh fails
315
+ *
316
+ * @param payload - The OAuth event payload
317
+ * @returns OAuth event notification
318
+ */
319
+ onMCPOAuthEvent(payload: MCPOAuthEventPayload): MCPOAuthEventNotification;
320
+ /**
321
+ * Loads OAuth configuration for a connection
322
+ */
323
+ private loadConnectionOAuthConfig;
324
+ /**
325
+ * Publishes a progress update to the statusUpdates subscription
326
+ */
33
327
  private publishProgress;
328
+ /**
329
+ * Creates an error result with default values
330
+ */
34
331
  private createErrorResult;
332
+ /**
333
+ * Creates a result indicating OAuth authorization is required
334
+ */
335
+ private createOAuthRequiredResult;
336
+ /**
337
+ * Creates a result indicating OAuth re-authorization is required
338
+ */
339
+ private createOAuthReauthorizationResult;
340
+ /**
341
+ * Gets the public URL for OAuth callbacks
342
+ */
343
+ private getPublicUrl;
35
344
  }
36
- export declare function LoadMCPResolver(): void;
345
+ /**
346
+ * Publishes an OAuth event to the subscription topic.
347
+ * Can be called from other resolvers or handlers to notify clients of OAuth events.
348
+ *
349
+ * @param pubSub - PubSub engine
350
+ * @param event - OAuth event details
351
+ */
352
+ export declare function publishMCPOAuthEvent(pubSub: PubSubEngine, event: {
353
+ eventType: MCPOAuthEventType;
354
+ connectionId: string;
355
+ authorizationUrl?: string;
356
+ stateParameter?: string;
357
+ errorMessage?: string;
358
+ requiresReauthorization?: boolean;
359
+ }): Promise<void>;
360
+ export {};
37
361
  //# sourceMappingURL=MCPResolver.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"MCPResolver.d.ts","sourceRoot":"","sources":["../../src/resolvers/MCPResolver.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAG5C,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAO1D,qBACa,iBAAiB;IAK1B,YAAY,EAAE,MAAM,CAAC;IAMrB,SAAS,CAAC,EAAE,OAAO,CAAC;CACvB;AAKD,qBACa,kBAAkB;IAK3B,OAAO,EAAE,OAAO,CAAC;IAMjB,YAAY,CAAC,EAAE,MAAM,CAAC;IAMtB,KAAK,EAAE,MAAM,CAAC;IAMd,OAAO,EAAE,MAAM,CAAC;IAMhB,UAAU,EAAE,MAAM,CAAC;IAMnB,KAAK,EAAE,MAAM,CAAC;IAMd,UAAU,CAAC,EAAE,MAAM,CAAC;IAMpB,cAAc,CAAC,EAAE,MAAM,CAAC;CAC3B;AAKD,qBACa,mBAAmB;IAK5B,YAAY,EAAE,MAAM,CAAC;IAMrB,MAAM,EAAE,MAAM,CAAC;IAMf,QAAQ,EAAE,MAAM,CAAC;IAMjB,SAAS,CAAC,EAAE,MAAM,CAAC;CACtB;AAKD,qBACa,oBAAoB;IAK7B,OAAO,EAAE,OAAO,CAAC;IAMjB,YAAY,CAAC,EAAE,MAAM,CAAC;IAMtB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAMxC,UAAU,CAAC,EAAE,MAAM,CAAC;CACvB;AA4BD,qBACa,WAAY,SAAQ,YAAY;IAWnC,YAAY,CACA,KAAK,EAAE,iBAAiB,EAC/B,GAAG,EAAE,UAAU,EACZ,MAAM,EAAE,YAAY,GAC/B,OAAO,CAAC,kBAAkB,CAAC;IA8GxB,cAAc,CACF,KAAK,EAAE,mBAAmB,EACjC,GAAG,EAAE,UAAU,GACvB,OAAO,CAAC,oBAAoB,CAAC;IAoIhC,OAAO,CAAC,eAAe;IA2BvB,OAAO,CAAC,iBAAiB;CAU5B;AAKD,wBAAgB,eAAe,IAAI,IAAI,CAEtC"}
1
+ {"version":3,"file":"MCPResolver.d.ts","sourceRoot":"","sources":["../../src/resolvers/MCPResolver.ts"],"names":[],"mappings":"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"}