connectors 0.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 (112) hide show
  1. checksums.yaml +7 -0
  2. data/CHANGELOG.md +35 -0
  3. data/CONNECTORS_FRAMEWORK.md +799 -0
  4. data/CONTRIBUTING.md +60 -0
  5. data/MCP_CLIENT.md +168 -0
  6. data/MIT-LICENSE +20 -0
  7. data/README.md +146 -0
  8. data/app/connectors/clickup/connector.rb +13 -0
  9. data/app/connectors/gmail/api.rb +114 -0
  10. data/app/connectors/gmail/connector.rb +921 -0
  11. data/app/connectors/gmail/mime_builder.rb +261 -0
  12. data/app/connectors/gmail/mime_parser.rb +106 -0
  13. data/app/connectors/gmail/polling.rb +154 -0
  14. data/app/connectors/remote_mcp/connector.rb +18 -0
  15. data/app/connectors/resend/connector.rb +218 -0
  16. data/app/controllers/concerns/connectors/grant_access.rb +43 -0
  17. data/app/controllers/connectors/actions_controller.rb +66 -0
  18. data/app/controllers/connectors/application_controller.rb +5 -0
  19. data/app/controllers/connectors/credentials_controller.rb +245 -0
  20. data/app/controllers/connectors/grants_controller.rb +123 -0
  21. data/app/controllers/connectors/mcp_controller.rb +88 -0
  22. data/app/controllers/connectors/oauth_controller.rb +134 -0
  23. data/app/controllers/connectors/types_controller.rb +144 -0
  24. data/app/controllers/connectors/webhooks_controller.rb +105 -0
  25. data/app/jobs/connectors/application_job.rb +4 -0
  26. data/app/jobs/connectors/deliver_webhook_job.rb +27 -0
  27. data/app/jobs/connectors/poll_job.rb +49 -0
  28. data/app/models/connectors/application_record.rb +5 -0
  29. data/app/models/connectors/credential_share.rb +31 -0
  30. data/app/models/connectors/grant.rb +103 -0
  31. data/app/models/connectors/mcp_authorization.rb +6 -0
  32. data/app/models/connectors/mcp_interaction.rb +6 -0
  33. data/app/models/connectors/poll_state.rb +17 -0
  34. data/app/models/connectors/webhook_event.rb +19 -0
  35. data/config/routes.rb +68 -0
  36. data/db/migrate/20260518210324_create_connectors_grants.rb +49 -0
  37. data/db/migrate/20260518214609_create_connectors_webhook_events.rb +35 -0
  38. data/db/migrate/20260521140000_create_connectors_credential_shares.rb +26 -0
  39. data/db/migrate/20260922120000_create_connectors_poll_states.rb +12 -0
  40. data/db/migrate/20260922130000_create_connectors_mcp_transactions.rb +18 -0
  41. data/docs/adding-connectors.md +92 -0
  42. data/docs/architecture.md +71 -0
  43. data/docs/releasing.md +60 -0
  44. data/lib/connectors/action.rb +90 -0
  45. data/lib/connectors/action_builder.rb +125 -0
  46. data/lib/connectors/action_runner.rb +99 -0
  47. data/lib/connectors/auth/scheme/api_key.rb +51 -0
  48. data/lib/connectors/auth/scheme/oauth2.rb +23 -0
  49. data/lib/connectors/auth/scheme.rb +35 -0
  50. data/lib/connectors/auth.rb +4 -0
  51. data/lib/connectors/auth_injection.rb +65 -0
  52. data/lib/connectors/client_builder.rb +87 -0
  53. data/lib/connectors/configuration.rb +138 -0
  54. data/lib/connectors/connector.rb +565 -0
  55. data/lib/connectors/credential_schema.rb +219 -0
  56. data/lib/connectors/credential_tester.rb +85 -0
  57. data/lib/connectors/credential_type_registry.rb +162 -0
  58. data/lib/connectors/credential_types/http_auth.rb +171 -0
  59. data/lib/connectors/engine.rb +123 -0
  60. data/lib/connectors/errors.rb +88 -0
  61. data/lib/connectors/grant_policy.rb +13 -0
  62. data/lib/connectors/mcp/access.rb +50 -0
  63. data/lib/connectors/mcp/authorization.rb +177 -0
  64. data/lib/connectors/mcp/authorization_context.rb +25 -0
  65. data/lib/connectors/mcp/authorization_discovery.rb +42 -0
  66. data/lib/connectors/mcp/cancellation.rb +36 -0
  67. data/lib/connectors/mcp/client.rb +137 -0
  68. data/lib/connectors/mcp/connection_config.rb +48 -0
  69. data/lib/connectors/mcp/http.rb +108 -0
  70. data/lib/connectors/mcp/interaction.rb +82 -0
  71. data/lib/connectors/mcp/pending_transaction.rb +26 -0
  72. data/lib/connectors/mcp/protocol/2026-07-28.json +3963 -0
  73. data/lib/connectors/mcp/protocol/LICENSE +216 -0
  74. data/lib/connectors/mcp/protocol/README.md +8 -0
  75. data/lib/connectors/mcp/protocol_schema.rb +30 -0
  76. data/lib/connectors/mcp/schema.rb +45 -0
  77. data/lib/connectors/mcp/settings.rb +27 -0
  78. data/lib/connectors/mcp/token_endpoint.rb +48 -0
  79. data/lib/connectors/mcp/transport.rb +105 -0
  80. data/lib/connectors/mcp.rb +69 -0
  81. data/lib/connectors/middleware/authenticate_generic.rb +79 -0
  82. data/lib/connectors/middleware/auto_refresh.rb +71 -0
  83. data/lib/connectors/middleware/error_normalization.rb +45 -0
  84. data/lib/connectors/middleware/grant_status.rb +19 -0
  85. data/lib/connectors/middleware/pre_authentication.rb +54 -0
  86. data/lib/connectors/middleware/rate_limit.rb +40 -0
  87. data/lib/connectors/oauth/authorize_url.rb +78 -0
  88. data/lib/connectors/oauth/client_authentication.rb +24 -0
  89. data/lib/connectors/oauth/client_credentials.rb +43 -0
  90. data/lib/connectors/oauth/grant_writer.rb +73 -0
  91. data/lib/connectors/oauth/pkce.rb +32 -0
  92. data/lib/connectors/oauth/revoke.rb +72 -0
  93. data/lib/connectors/oauth/state.rb +41 -0
  94. data/lib/connectors/oauth/token_exchange.rb +69 -0
  95. data/lib/connectors/oauth/token_response.rb +40 -0
  96. data/lib/connectors/oauth.rb +4 -0
  97. data/lib/connectors/oauth1.rb +151 -0
  98. data/lib/connectors/permission_check.rb +33 -0
  99. data/lib/connectors/poll_runner.rb +50 -0
  100. data/lib/connectors/pre_authentication_helpers.rb +76 -0
  101. data/lib/connectors/registry.rb +38 -0
  102. data/lib/connectors/version.rb +3 -0
  103. data/lib/connectors/webhook_context.rb +62 -0
  104. data/lib/connectors/webhook_lifecycle.rb +69 -0
  105. data/lib/connectors/webhook_methods.rb +48 -0
  106. data/lib/connectors/webhooks/verifier.rb +31 -0
  107. data/lib/connectors/webhooks.rb +5 -0
  108. data/lib/connectors.rb +50 -0
  109. data/lib/tasks/connectors_mcp.rake +9 -0
  110. data/lib/tasks/connectors_tasks.rake +4 -0
  111. data/openapi.yaml +1099 -0
  112. metadata +263 -0
metadata ADDED
@@ -0,0 +1,263 @@
1
+ --- !ruby/object:Gem::Specification
2
+ name: connectors
3
+ version: !ruby/object:Gem::Version
4
+ version: 0.1.0
5
+ platform: ruby
6
+ authors:
7
+ - Jackson Helio
8
+ bindir: bin
9
+ cert_chain: []
10
+ date: 1980-01-02 00:00:00.000000000 Z
11
+ dependencies:
12
+ - !ruby/object:Gem::Dependency
13
+ name: rails
14
+ requirement: !ruby/object:Gem::Requirement
15
+ requirements:
16
+ - - "~>"
17
+ - !ruby/object:Gem::Version
18
+ version: 8.1.3
19
+ type: :runtime
20
+ prerelease: false
21
+ version_requirements: !ruby/object:Gem::Requirement
22
+ requirements:
23
+ - - "~>"
24
+ - !ruby/object:Gem::Version
25
+ version: 8.1.3
26
+ - !ruby/object:Gem::Dependency
27
+ name: faraday
28
+ requirement: !ruby/object:Gem::Requirement
29
+ requirements:
30
+ - - "~>"
31
+ - !ruby/object:Gem::Version
32
+ version: '2.9'
33
+ type: :runtime
34
+ prerelease: false
35
+ version_requirements: !ruby/object:Gem::Requirement
36
+ requirements:
37
+ - - "~>"
38
+ - !ruby/object:Gem::Version
39
+ version: '2.9'
40
+ - !ruby/object:Gem::Dependency
41
+ name: faraday-retry
42
+ requirement: !ruby/object:Gem::Requirement
43
+ requirements:
44
+ - - "~>"
45
+ - !ruby/object:Gem::Version
46
+ version: '2.2'
47
+ type: :runtime
48
+ prerelease: false
49
+ version_requirements: !ruby/object:Gem::Requirement
50
+ requirements:
51
+ - - "~>"
52
+ - !ruby/object:Gem::Version
53
+ version: '2.2'
54
+ - !ruby/object:Gem::Dependency
55
+ name: oauth2
56
+ requirement: !ruby/object:Gem::Requirement
57
+ requirements:
58
+ - - "~>"
59
+ - !ruby/object:Gem::Version
60
+ version: '2.0'
61
+ type: :runtime
62
+ prerelease: false
63
+ version_requirements: !ruby/object:Gem::Requirement
64
+ requirements:
65
+ - - "~>"
66
+ - !ruby/object:Gem::Version
67
+ version: '2.0'
68
+ - !ruby/object:Gem::Dependency
69
+ name: mcp
70
+ requirement: !ruby/object:Gem::Requirement
71
+ requirements:
72
+ - - '='
73
+ - !ruby/object:Gem::Version
74
+ version: 1.6.0
75
+ type: :runtime
76
+ prerelease: false
77
+ version_requirements: !ruby/object:Gem::Requirement
78
+ requirements:
79
+ - - '='
80
+ - !ruby/object:Gem::Version
81
+ version: 1.6.0
82
+ - !ruby/object:Gem::Dependency
83
+ name: json_schemer
84
+ requirement: !ruby/object:Gem::Requirement
85
+ requirements:
86
+ - - "~>"
87
+ - !ruby/object:Gem::Version
88
+ version: '2.5'
89
+ type: :runtime
90
+ prerelease: false
91
+ version_requirements: !ruby/object:Gem::Requirement
92
+ requirements:
93
+ - - "~>"
94
+ - !ruby/object:Gem::Version
95
+ version: '2.5'
96
+ - !ruby/object:Gem::Dependency
97
+ name: event_stream_parser
98
+ requirement: !ruby/object:Gem::Requirement
99
+ requirements:
100
+ - - "~>"
101
+ - !ruby/object:Gem::Version
102
+ version: '1.0'
103
+ type: :runtime
104
+ prerelease: false
105
+ version_requirements: !ruby/object:Gem::Requirement
106
+ requirements:
107
+ - - "~>"
108
+ - !ruby/object:Gem::Version
109
+ version: '1.0'
110
+ description: Mountable Rails engine with encrypted credentials, role-based sharing,
111
+ OAuth, provider actions, webhooks and polling. Includes authenticated HTTP clients
112
+ and remote MCP tool discovery and invocation with durable OAuth and elicitation.
113
+ Hosts supply authentication, encryption keys and scheduling.
114
+ email:
115
+ - 4428869+jackhelio@users.noreply.github.com
116
+ executables: []
117
+ extensions: []
118
+ extra_rdoc_files:
119
+ - CHANGELOG.md
120
+ - CONNECTORS_FRAMEWORK.md
121
+ - MCP_CLIENT.md
122
+ - README.md
123
+ files:
124
+ - CHANGELOG.md
125
+ - CONNECTORS_FRAMEWORK.md
126
+ - CONTRIBUTING.md
127
+ - MCP_CLIENT.md
128
+ - MIT-LICENSE
129
+ - README.md
130
+ - app/connectors/clickup/connector.rb
131
+ - app/connectors/gmail/api.rb
132
+ - app/connectors/gmail/connector.rb
133
+ - app/connectors/gmail/mime_builder.rb
134
+ - app/connectors/gmail/mime_parser.rb
135
+ - app/connectors/gmail/polling.rb
136
+ - app/connectors/remote_mcp/connector.rb
137
+ - app/connectors/resend/connector.rb
138
+ - app/controllers/concerns/connectors/grant_access.rb
139
+ - app/controllers/connectors/actions_controller.rb
140
+ - app/controllers/connectors/application_controller.rb
141
+ - app/controllers/connectors/credentials_controller.rb
142
+ - app/controllers/connectors/grants_controller.rb
143
+ - app/controllers/connectors/mcp_controller.rb
144
+ - app/controllers/connectors/oauth_controller.rb
145
+ - app/controllers/connectors/types_controller.rb
146
+ - app/controllers/connectors/webhooks_controller.rb
147
+ - app/jobs/connectors/application_job.rb
148
+ - app/jobs/connectors/deliver_webhook_job.rb
149
+ - app/jobs/connectors/poll_job.rb
150
+ - app/models/connectors/application_record.rb
151
+ - app/models/connectors/credential_share.rb
152
+ - app/models/connectors/grant.rb
153
+ - app/models/connectors/mcp_authorization.rb
154
+ - app/models/connectors/mcp_interaction.rb
155
+ - app/models/connectors/poll_state.rb
156
+ - app/models/connectors/webhook_event.rb
157
+ - config/routes.rb
158
+ - db/migrate/20260518210324_create_connectors_grants.rb
159
+ - db/migrate/20260518214609_create_connectors_webhook_events.rb
160
+ - db/migrate/20260521140000_create_connectors_credential_shares.rb
161
+ - db/migrate/20260922120000_create_connectors_poll_states.rb
162
+ - db/migrate/20260922130000_create_connectors_mcp_transactions.rb
163
+ - docs/adding-connectors.md
164
+ - docs/architecture.md
165
+ - docs/releasing.md
166
+ - lib/connectors.rb
167
+ - lib/connectors/action.rb
168
+ - lib/connectors/action_builder.rb
169
+ - lib/connectors/action_runner.rb
170
+ - lib/connectors/auth.rb
171
+ - lib/connectors/auth/scheme.rb
172
+ - lib/connectors/auth/scheme/api_key.rb
173
+ - lib/connectors/auth/scheme/oauth2.rb
174
+ - lib/connectors/auth_injection.rb
175
+ - lib/connectors/client_builder.rb
176
+ - lib/connectors/configuration.rb
177
+ - lib/connectors/connector.rb
178
+ - lib/connectors/credential_schema.rb
179
+ - lib/connectors/credential_tester.rb
180
+ - lib/connectors/credential_type_registry.rb
181
+ - lib/connectors/credential_types/http_auth.rb
182
+ - lib/connectors/engine.rb
183
+ - lib/connectors/errors.rb
184
+ - lib/connectors/grant_policy.rb
185
+ - lib/connectors/mcp.rb
186
+ - lib/connectors/mcp/access.rb
187
+ - lib/connectors/mcp/authorization.rb
188
+ - lib/connectors/mcp/authorization_context.rb
189
+ - lib/connectors/mcp/authorization_discovery.rb
190
+ - lib/connectors/mcp/cancellation.rb
191
+ - lib/connectors/mcp/client.rb
192
+ - lib/connectors/mcp/connection_config.rb
193
+ - lib/connectors/mcp/http.rb
194
+ - lib/connectors/mcp/interaction.rb
195
+ - lib/connectors/mcp/pending_transaction.rb
196
+ - lib/connectors/mcp/protocol/2026-07-28.json
197
+ - lib/connectors/mcp/protocol/LICENSE
198
+ - lib/connectors/mcp/protocol/README.md
199
+ - lib/connectors/mcp/protocol_schema.rb
200
+ - lib/connectors/mcp/schema.rb
201
+ - lib/connectors/mcp/settings.rb
202
+ - lib/connectors/mcp/token_endpoint.rb
203
+ - lib/connectors/mcp/transport.rb
204
+ - lib/connectors/middleware/authenticate_generic.rb
205
+ - lib/connectors/middleware/auto_refresh.rb
206
+ - lib/connectors/middleware/error_normalization.rb
207
+ - lib/connectors/middleware/grant_status.rb
208
+ - lib/connectors/middleware/pre_authentication.rb
209
+ - lib/connectors/middleware/rate_limit.rb
210
+ - lib/connectors/oauth.rb
211
+ - lib/connectors/oauth/authorize_url.rb
212
+ - lib/connectors/oauth/client_authentication.rb
213
+ - lib/connectors/oauth/client_credentials.rb
214
+ - lib/connectors/oauth/grant_writer.rb
215
+ - lib/connectors/oauth/pkce.rb
216
+ - lib/connectors/oauth/revoke.rb
217
+ - lib/connectors/oauth/state.rb
218
+ - lib/connectors/oauth/token_exchange.rb
219
+ - lib/connectors/oauth/token_response.rb
220
+ - lib/connectors/oauth1.rb
221
+ - lib/connectors/permission_check.rb
222
+ - lib/connectors/poll_runner.rb
223
+ - lib/connectors/pre_authentication_helpers.rb
224
+ - lib/connectors/registry.rb
225
+ - lib/connectors/version.rb
226
+ - lib/connectors/webhook_context.rb
227
+ - lib/connectors/webhook_lifecycle.rb
228
+ - lib/connectors/webhook_methods.rb
229
+ - lib/connectors/webhooks.rb
230
+ - lib/connectors/webhooks/verifier.rb
231
+ - lib/tasks/connectors_mcp.rake
232
+ - lib/tasks/connectors_tasks.rake
233
+ - openapi.yaml
234
+ homepage: https://github.com/jackhelio/connectors
235
+ licenses:
236
+ - MIT
237
+ metadata:
238
+ allowed_push_host: https://rubygems.org
239
+ homepage_uri: https://github.com/jackhelio/connectors
240
+ source_code_uri: https://github.com/jackhelio/connectors/tree/main
241
+ documentation_uri: https://github.com/jackhelio/connectors/blob/main/README.md
242
+ changelog_uri: https://github.com/jackhelio/connectors/blob/main/CHANGELOG.md
243
+ rdoc_options:
244
+ - "--main"
245
+ - README.md
246
+ require_paths:
247
+ - lib
248
+ required_ruby_version: !ruby/object:Gem::Requirement
249
+ requirements:
250
+ - - ">="
251
+ - !ruby/object:Gem::Version
252
+ version: 3.2.0
253
+ required_rubygems_version: !ruby/object:Gem::Requirement
254
+ requirements:
255
+ - - ">="
256
+ - !ruby/object:Gem::Version
257
+ version: '0'
258
+ requirements:
259
+ - PostgreSQL 13+; UUID primary keys for owner and sharing-principal models
260
+ rubygems_version: 3.6.9
261
+ specification_version: 4
262
+ summary: Rails connector engine for provider APIs and remote MCP tools.
263
+ test_files: []