@elevasis/core 0.22.0 → 0.24.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 (244) hide show
  1. package/dist/index.d.ts +3214 -2501
  2. package/dist/index.js +3112 -1222
  3. package/dist/knowledge/index.d.ts +1108 -1264
  4. package/dist/knowledge/index.js +112 -9
  5. package/dist/organization-model/index.d.ts +3214 -2501
  6. package/dist/organization-model/index.js +3112 -1222
  7. package/dist/test-utils/index.d.ts +985 -1103
  8. package/dist/test-utils/index.js +2464 -1165
  9. package/package.json +5 -5
  10. package/src/README.md +14 -14
  11. package/src/__tests__/publish.test.ts +24 -24
  12. package/src/__tests__/template-core-compatibility.test.ts +9 -80
  13. package/src/_gen/__tests__/__snapshots__/contracts.md.snap +2389 -2121
  14. package/src/_gen/__tests__/scaffold-contracts.test.ts +30 -30
  15. package/src/auth/multi-tenancy/credentials/__tests__/encryption.test.ts +217 -217
  16. package/src/auth/multi-tenancy/credentials/server/encryption.ts +69 -69
  17. package/src/auth/multi-tenancy/credentials/server/kek-loader.ts +37 -37
  18. package/src/auth/multi-tenancy/index.ts +26 -26
  19. package/src/auth/multi-tenancy/invitations/api-schemas.ts +104 -104
  20. package/src/auth/multi-tenancy/memberships/api-schemas.ts +143 -143
  21. package/src/auth/multi-tenancy/memberships/index.ts +26 -26
  22. package/src/auth/multi-tenancy/memberships/membership.ts +130 -130
  23. package/src/auth/multi-tenancy/organizations/__tests__/api-schemas.test.ts +194 -194
  24. package/src/auth/multi-tenancy/organizations/api-schemas.ts +136 -136
  25. package/src/auth/multi-tenancy/permissions.test.ts +42 -42
  26. package/src/auth/multi-tenancy/permissions.ts +123 -123
  27. package/src/auth/multi-tenancy/role-management/api-schemas.ts +78 -78
  28. package/src/auth/multi-tenancy/role-management/index.ts +16 -16
  29. package/src/auth/multi-tenancy/theme-presets.ts +45 -45
  30. package/src/auth/multi-tenancy/types.ts +57 -57
  31. package/src/auth/multi-tenancy/users/api-schemas.ts +165 -165
  32. package/src/business/README.md +2 -2
  33. package/src/business/acquisition/activity-events.test.ts +250 -250
  34. package/src/business/acquisition/activity-events.ts +93 -93
  35. package/src/business/acquisition/api-schemas.test.ts +1883 -1843
  36. package/src/business/acquisition/api-schemas.ts +1493 -1500
  37. package/src/business/acquisition/build-templates.test.ts +240 -240
  38. package/src/business/acquisition/build-templates.ts +83 -41
  39. package/src/business/acquisition/crm-next-action.test.ts +262 -262
  40. package/src/business/acquisition/crm-next-action.ts +220 -220
  41. package/src/business/acquisition/crm-priority.test.ts +216 -216
  42. package/src/business/acquisition/crm-priority.ts +349 -349
  43. package/src/business/acquisition/crm-state-actions.test.ts +153 -151
  44. package/src/business/acquisition/deal-ownership.test.ts +351 -351
  45. package/src/business/acquisition/deal-ownership.ts +120 -120
  46. package/src/business/acquisition/derive-actions.test.ts +129 -104
  47. package/src/business/acquisition/derive-actions.ts +74 -84
  48. package/src/business/acquisition/index.ts +171 -170
  49. package/src/business/acquisition/ontology-validation.ts +309 -0
  50. package/src/business/acquisition/stateful.ts +30 -30
  51. package/src/business/acquisition/types.ts +396 -392
  52. package/src/business/clients/api-schemas.test.ts +115 -115
  53. package/src/business/clients/api-schemas.ts +158 -158
  54. package/src/business/clients/index.ts +1 -1
  55. package/src/business/crm/api-schemas.ts +40 -40
  56. package/src/business/crm/index.ts +1 -1
  57. package/src/business/deals/api-schemas.ts +87 -87
  58. package/src/business/deals/index.ts +1 -1
  59. package/src/business/index.ts +5 -5
  60. package/src/business/projects/types.ts +144 -144
  61. package/src/commands/queue/types/task.ts +15 -15
  62. package/src/execution/core/runner-types.ts +61 -61
  63. package/src/execution/core/sse-executions.ts +7 -7
  64. package/src/execution/engine/__tests__/fixtures/test-agents.ts +10 -10
  65. package/src/execution/engine/agent/core/__tests__/agent.test.ts +16 -16
  66. package/src/execution/engine/agent/core/__tests__/error-passthrough.test.ts +4 -4
  67. package/src/execution/engine/agent/core/types.ts +25 -25
  68. package/src/execution/engine/agent/index.ts +6 -6
  69. package/src/execution/engine/agent/reasoning/__tests__/request-builder.test.ts +24 -24
  70. package/src/execution/engine/index.ts +443 -443
  71. package/src/execution/engine/tools/integration/server/adapters/apify/__tests__/apify-run-actor.integration.test.ts +298 -298
  72. package/src/execution/engine/tools/integration/server/adapters/apify/apify-adapter.test.ts +55 -55
  73. package/src/execution/engine/tools/integration/server/adapters/apify/apify-adapter.ts +107 -107
  74. package/src/execution/engine/tools/integration/server/adapters/apollo/apollo-adapter.test.ts +48 -48
  75. package/src/execution/engine/tools/integration/server/adapters/apollo/apollo-adapter.ts +99 -99
  76. package/src/execution/engine/tools/integration/server/adapters/apollo/index.ts +1 -1
  77. package/src/execution/engine/tools/integration/server/adapters/attio/__tests__/attio-crud.integration.test.ts +363 -363
  78. package/src/execution/engine/tools/integration/server/adapters/attio/fetch/get-record/index.test.ts +162 -162
  79. package/src/execution/engine/tools/integration/server/adapters/attio/fetch/list-records/index.test.ts +316 -316
  80. package/src/execution/engine/tools/integration/server/adapters/clickup/clickup-adapter.test.ts +18 -18
  81. package/src/execution/engine/tools/integration/server/adapters/clickup/clickup-adapter.ts +194 -194
  82. package/src/execution/engine/tools/integration/server/adapters/clickup/index.ts +7 -7
  83. package/src/execution/engine/tools/integration/server/adapters/gmail/gmail-adapter.ts +204 -204
  84. package/src/execution/engine/tools/integration/server/adapters/gmail/gmail-tools.ts +105 -105
  85. package/src/execution/engine/tools/integration/server/adapters/google-calendar/google-calendar-adapter.ts +428 -428
  86. package/src/execution/engine/tools/integration/server/adapters/google-calendar/index.ts +2 -2
  87. package/src/execution/engine/tools/integration/server/adapters/google-sheets/__tests__/google-sheets.integration.test.ts +261 -261
  88. package/src/execution/engine/tools/integration/server/adapters/instantly/instantly-tools.ts +1474 -1474
  89. package/src/execution/engine/tools/integration/server/adapters/millionverifier/millionverifier-tools.ts +103 -103
  90. package/src/execution/engine/tools/integration/server/adapters/resend/fetch/send-email/index.test.ts +88 -88
  91. package/src/execution/engine/tools/integration/server/adapters/resend/fetch/send-email/index.ts +141 -141
  92. package/src/execution/engine/tools/integration/server/adapters/resend/fetch/utils/types.ts +76 -76
  93. package/src/execution/engine/tools/integration/server/adapters/signature-api/signature-api-tools.ts +182 -182
  94. package/src/execution/engine/tools/integration/server/adapters/stripe/stripe-tools.ts +310 -310
  95. package/src/execution/engine/tools/integration/service.test.ts +239 -239
  96. package/src/execution/engine/tools/integration/service.ts +172 -172
  97. package/src/execution/engine/tools/integration/tool.ts +255 -255
  98. package/src/execution/engine/tools/lead-service-types.ts +1005 -1005
  99. package/src/execution/engine/tools/messages.ts +43 -43
  100. package/src/execution/engine/tools/platform/acquisition/company-tools.ts +7 -7
  101. package/src/execution/engine/tools/platform/acquisition/contact-tools.ts +6 -6
  102. package/src/execution/engine/tools/platform/acquisition/list-tools.ts +6 -6
  103. package/src/execution/engine/tools/platform/acquisition/types.ts +280 -280
  104. package/src/execution/engine/tools/platform/email/types.ts +97 -97
  105. package/src/execution/engine/tools/registry.ts +704 -704
  106. package/src/execution/engine/tools/tool-maps.ts +831 -831
  107. package/src/execution/engine/tools/types.ts +234 -234
  108. package/src/execution/engine/workflow/types.ts +202 -202
  109. package/src/execution/external/__tests__/api-schemas.test.ts +127 -127
  110. package/src/execution/external/api-schemas.ts +40 -40
  111. package/src/execution/external/index.ts +1 -1
  112. package/src/index.ts +18 -18
  113. package/src/integrations/credentials/__tests__/api-schemas.test.ts +420 -420
  114. package/src/integrations/credentials/api-schemas.ts +146 -146
  115. package/src/integrations/credentials/schemas.ts +200 -200
  116. package/src/integrations/oauth/__tests__/provider-registry.test.ts +7 -7
  117. package/src/integrations/oauth/provider-registry.ts +74 -74
  118. package/src/integrations/oauth/server/credentials.ts +43 -43
  119. package/src/integrations/webhook-endpoints/__tests__/api-schemas.test.ts +327 -327
  120. package/src/integrations/webhook-endpoints/api-schemas.ts +103 -103
  121. package/src/integrations/webhook-endpoints/types.ts +58 -58
  122. package/src/knowledge/README.md +33 -32
  123. package/src/knowledge/__tests__/queries.test.ts +633 -541
  124. package/src/knowledge/format.ts +100 -99
  125. package/src/knowledge/index.ts +5 -5
  126. package/src/knowledge/published.ts +5 -5
  127. package/src/knowledge/queries.ts +274 -222
  128. package/src/operations/activities/api-schemas.ts +80 -80
  129. package/src/operations/activities/types.ts +64 -64
  130. package/src/organization-model/README.md +149 -109
  131. package/src/organization-model/__tests__/content-kinds-registry.test.ts +210 -0
  132. package/src/organization-model/__tests__/defaults.test.ts +168 -194
  133. package/src/organization-model/__tests__/domains/actions.test.ts +78 -0
  134. package/src/organization-model/__tests__/domains/customers.test.ts +48 -44
  135. package/src/organization-model/__tests__/domains/entities.test.ts +56 -0
  136. package/src/organization-model/__tests__/domains/goals.test.ts +110 -96
  137. package/src/organization-model/__tests__/domains/identity.test.ts +4 -3
  138. package/src/organization-model/__tests__/domains/navigation.test.ts +222 -166
  139. package/src/organization-model/__tests__/domains/offerings.test.ts +83 -88
  140. package/src/organization-model/__tests__/domains/policies.test.ts +323 -0
  141. package/src/organization-model/__tests__/domains/resource-mappings.test.ts +30 -30
  142. package/src/organization-model/__tests__/domains/resources.test.ts +396 -175
  143. package/src/organization-model/__tests__/domains/roles.test.ts +463 -402
  144. package/src/organization-model/__tests__/domains/statuses.test.ts +13 -10
  145. package/src/organization-model/__tests__/domains/systems.test.ts +209 -193
  146. package/src/organization-model/__tests__/flatten-additive-merge.test.ts +362 -0
  147. package/src/organization-model/__tests__/foundation.test.ts +47 -75
  148. package/src/organization-model/__tests__/get-resources-for-system.test.ts +144 -0
  149. package/src/organization-model/__tests__/graph.test.ts +1336 -149
  150. package/src/organization-model/__tests__/icons.test.ts +10 -1
  151. package/src/organization-model/__tests__/knowledge.test.ts +418 -61
  152. package/src/organization-model/__tests__/lookup-helpers.test.ts +438 -0
  153. package/src/organization-model/__tests__/migration-helpers.test.ts +591 -0
  154. package/src/organization-model/__tests__/prospecting-ssot.test.ts +103 -94
  155. package/src/organization-model/__tests__/recursive-system-schema.test.ts +549 -0
  156. package/src/organization-model/__tests__/resolve.test.ts +303 -42
  157. package/src/organization-model/__tests__/schema.test.ts +863 -153
  158. package/src/organization-model/__tests__/surface-projection.test.ts +284 -174
  159. package/src/organization-model/catalogs/lead-gen.ts +144 -0
  160. package/src/organization-model/content-kinds/config.ts +36 -0
  161. package/src/organization-model/content-kinds/index.ts +78 -0
  162. package/src/organization-model/content-kinds/pipeline.ts +68 -0
  163. package/src/organization-model/content-kinds/registry.ts +44 -0
  164. package/src/organization-model/content-kinds/status.ts +71 -0
  165. package/src/organization-model/content-kinds/template.ts +83 -0
  166. package/src/organization-model/content-kinds/types.ts +117 -0
  167. package/src/organization-model/contracts.ts +27 -17
  168. package/src/organization-model/defaults.ts +489 -107
  169. package/src/organization-model/domains/actions.ts +333 -0
  170. package/src/organization-model/domains/customers.ts +10 -7
  171. package/src/organization-model/domains/entities.ts +144 -0
  172. package/src/organization-model/domains/goals.ts +9 -6
  173. package/src/organization-model/domains/knowledge.ts +128 -54
  174. package/src/organization-model/domains/navigation.ts +139 -416
  175. package/src/organization-model/domains/offerings.ts +15 -10
  176. package/src/organization-model/domains/policies.ts +102 -0
  177. package/src/organization-model/domains/projects.ts +6 -40
  178. package/src/organization-model/domains/prospecting.ts +395 -514
  179. package/src/organization-model/domains/resources.ts +173 -81
  180. package/src/organization-model/domains/roles.ts +96 -93
  181. package/src/organization-model/domains/sales.test.ts +218 -218
  182. package/src/organization-model/domains/sales.ts +380 -589
  183. package/src/organization-model/domains/shared.ts +8 -8
  184. package/src/organization-model/domains/statuses.ts +298 -89
  185. package/src/organization-model/domains/systems.ts +240 -38
  186. package/src/organization-model/foundation.ts +35 -48
  187. package/src/organization-model/graph/build.ts +1035 -279
  188. package/src/organization-model/graph/index.ts +4 -4
  189. package/src/organization-model/graph/link.ts +10 -10
  190. package/src/organization-model/graph/schema.ts +77 -56
  191. package/src/organization-model/graph/types.ts +75 -56
  192. package/src/organization-model/helpers.ts +312 -59
  193. package/src/organization-model/icons.ts +78 -66
  194. package/src/organization-model/index.ts +129 -16
  195. package/src/organization-model/migration-helpers.ts +252 -0
  196. package/src/organization-model/ontology.ts +661 -0
  197. package/src/organization-model/organization-graph.mdx +110 -89
  198. package/src/organization-model/organization-model.mdx +226 -171
  199. package/src/organization-model/published.ts +295 -139
  200. package/src/organization-model/resolve.ts +139 -21
  201. package/src/organization-model/schema.ts +841 -301
  202. package/src/organization-model/surface-projection.ts +212 -218
  203. package/src/organization-model/types.ts +181 -90
  204. package/src/platform/api/types.ts +38 -38
  205. package/src/platform/constants/versions.ts +3 -3
  206. package/src/platform/index.ts +23 -23
  207. package/src/platform/registry/__tests__/command-view.test.ts +5 -7
  208. package/src/platform/registry/__tests__/resource-link.test.ts +35 -30
  209. package/src/platform/registry/__tests__/resource-registry.integration.test.ts +17 -32
  210. package/src/platform/registry/__tests__/resource-registry.nested-systems.test.ts +245 -0
  211. package/src/platform/registry/__tests__/resource-registry.test.ts +2053 -2051
  212. package/src/platform/registry/__tests__/validation.test.ts +1347 -1343
  213. package/src/platform/registry/command-view.ts +10 -10
  214. package/src/platform/registry/index.ts +103 -103
  215. package/src/platform/registry/resource-link.ts +32 -32
  216. package/src/platform/registry/resource-registry.ts +890 -878
  217. package/src/platform/registry/serialization.ts +295 -295
  218. package/src/platform/registry/serialized-types.ts +166 -166
  219. package/src/platform/registry/stats-types.ts +68 -68
  220. package/src/platform/registry/types.ts +425 -425
  221. package/src/platform/registry/validation.ts +745 -743
  222. package/src/platform/utils/__tests__/validation.test.ts +1084 -1084
  223. package/src/platform/utils/validation.ts +425 -425
  224. package/src/projects/api-schemas.test.ts +39 -39
  225. package/src/projects/api-schemas.ts +291 -291
  226. package/src/reference/_generated/contracts.md +2389 -2121
  227. package/src/reference/glossary.md +76 -76
  228. package/src/scaffold-registry/__tests__/index.test.ts +206 -206
  229. package/src/scaffold-registry/__tests__/schema.test.ts +166 -166
  230. package/src/scaffold-registry/index.ts +392 -392
  231. package/src/scaffold-registry/schema.ts +243 -243
  232. package/src/server.ts +289 -289
  233. package/src/supabase/database.types.ts +3153 -3093
  234. package/src/test-utils/README.md +37 -37
  235. package/src/test-utils/entities.ts +108 -108
  236. package/src/test-utils/fixtures/memberships.ts +82 -82
  237. package/src/test-utils/index.ts +12 -12
  238. package/src/test-utils/organization-model.ts +65 -65
  239. package/src/test-utils/published.ts +6 -6
  240. package/src/test-utils/rls/RLSTestContext.ts +588 -588
  241. package/src/test-utils/test-utils.test.ts +44 -49
  242. package/src/organization-model/__tests__/domains/operations.test.ts +0 -203
  243. package/src/organization-model/domains/features.ts +0 -31
  244. package/src/organization-model/domains/operations.ts +0 -85
@@ -1,200 +1,200 @@
1
- import { z } from 'zod'
2
-
3
- /**
4
- * Credential field definition
5
- */
6
- export interface CredentialField {
7
- key: string
8
- label: string
9
- type: 'password' | 'text'
10
- required: boolean
11
- placeholder?: string
12
- description?: string
13
- }
14
-
15
- /**
16
- * Credential schema definition
17
- */
18
- export interface CredentialSchema {
19
- type: string
20
- label: string
21
- description: string
22
- fields?: CredentialField[]
23
- docsUrl?: string
24
- nameSuggestions: string[]
25
- oauthProvider?: string // For OAuth types
26
- }
27
-
28
- /**
29
- * Zod schemas for runtime validation
30
- */
31
- const CredentialFieldSchema = z.object({
32
- key: z.string(),
33
- label: z.string(),
34
- type: z.enum(['password', 'text']),
35
- required: z.boolean(),
36
- placeholder: z.string().optional(),
37
- description: z.string().optional()
38
- })
39
-
40
- const CredentialSchemaZod = z.object({
41
- type: z.string(),
42
- label: z.string(),
43
- description: z.string(),
44
- fields: z.array(CredentialFieldSchema).optional(),
45
- docsUrl: z.string().url().optional(),
46
- nameSuggestions: z.array(z.string()),
47
- oauthProvider: z.string().optional()
48
- })
49
-
50
- /**
51
- * Credential Schema Registry
52
- *
53
- * Add new integration = add schema object here (no modal changes needed)
54
- *
55
- * Schema types:
56
- * - oauth: OAuth-based authentication (handled via OAuth flow)
57
- * - single_field: Single API key field (generic)
58
- */
59
- export const CREDENTIAL_SCHEMAS: Record<string, CredentialSchema> = {
60
- 'google-sheets': {
61
- type: 'oauth',
62
- label: 'Google Sheets',
63
- description: 'Google Sheets OAuth integration',
64
- oauthProvider: 'google-sheets',
65
- nameSuggestions: ['google-sheets-prod', 'google-sheets-dev', 'sheets-workspace']
66
- },
67
-
68
- dropbox: {
69
- type: 'oauth',
70
- label: 'Dropbox',
71
- description: 'Dropbox OAuth integration',
72
- oauthProvider: 'dropbox',
73
- nameSuggestions: ['dropbox-prod', 'dropbox-dev', 'elevasis-dropbox']
74
- },
75
-
76
- oauth: {
77
- type: 'oauth',
78
- label: 'OAuth',
79
- description: 'Generic OAuth credential',
80
- nameSuggestions: []
81
- },
82
-
83
- 'api-key': {
84
- type: 'single_field',
85
- label: 'API Key',
86
- description: 'Single-field API key credential',
87
- fields: [
88
- {
89
- key: 'apiKey',
90
- label: 'API Key',
91
- type: 'password',
92
- required: true,
93
- placeholder: 'Enter your API key',
94
- description: 'API key for the service'
95
- }
96
- ],
97
- nameSuggestions: ['service-prod', 'service-dev', 'api-key']
98
- },
99
-
100
- 'webhook-secret': {
101
- type: 'single_field',
102
- label: 'Webhook Secret',
103
- description: 'Webhook signing secret for signature validation',
104
- fields: [
105
- {
106
- key: 'signingSecret',
107
- label: 'Signing Secret',
108
- type: 'password',
109
- required: true,
110
- placeholder: 'whsec_...',
111
- description: 'Webhook signing secret from provider dashboard'
112
- }
113
- ],
114
- nameSuggestions: ['my-org-cal-com-webhook', 'my-org-stripe-webhook', 'my-org-signature-api-webhook']
115
- },
116
-
117
- 'api-key-secret': {
118
- type: 'api-key-secret',
119
- label: 'API Key + Secret',
120
- description: 'API key and secret pair authentication',
121
- fields: [
122
- {
123
- key: 'apiKey',
124
- label: 'API Key',
125
- type: 'password',
126
- required: true
127
- },
128
- {
129
- key: 'apiSecret',
130
- label: 'API Secret',
131
- type: 'password',
132
- required: true
133
- }
134
- ],
135
- nameSuggestions: []
136
- },
137
-
138
- apify: {
139
- type: 'single_field',
140
- label: 'Apify',
141
- description: 'Apify API token for running web-scraping actors (e.g. website crawl, Google Places scrape).',
142
- fields: [
143
- {
144
- key: 'apiKey',
145
- label: 'API Token',
146
- type: 'password',
147
- required: true,
148
- placeholder: 'apify_api_...',
149
- description: 'Personal API token from https://console.apify.com/account/integrations'
150
- }
151
- ],
152
- docsUrl: 'https://docs.apify.com/platform/integrations/api',
153
- nameSuggestions: ['elevasis-apify', 'apify-prod', 'apify-dev']
154
- },
155
-
156
- clickup: {
157
- type: 'single_field',
158
- label: 'ClickUp',
159
- description: 'ClickUp personal API token for creating tasks in tenant-managed ClickUp workspaces.',
160
- fields: [
161
- {
162
- key: 'apiToken',
163
- label: 'API Token',
164
- type: 'password',
165
- required: true,
166
- placeholder: 'pk_...',
167
- description: 'Personal API token from ClickUp settings. Personal tokens start with pk_.'
168
- }
169
- ],
170
- docsUrl: 'https://developer.clickup.com/docs/authentication',
171
- nameSuggestions: ['clickup-demo', 'clickup-prod', 'clickup-dev']
172
- }
173
- }
174
-
175
- /**
176
- * Get credential schema by type
177
- * @param type - Credential type identifier
178
- * @returns Validated credential schema
179
- * @throws ZodError if schema is malformed
180
- */
181
- export function getCredentialSchema(type: string): CredentialSchema {
182
- const schema = CREDENTIAL_SCHEMAS[type] || CREDENTIAL_SCHEMAS['api-key']
183
- return CredentialSchemaZod.parse(schema)
184
- }
185
-
186
- /**
187
- * List all available credential types (for frontend dropdown)
188
- * @returns Array of credential schemas
189
- */
190
- export function listCredentialSchemas(): CredentialSchema[] {
191
- return Object.values(CREDENTIAL_SCHEMAS)
192
- }
193
-
194
- /**
195
- * Get all credential type identifiers
196
- * @returns Array of type strings
197
- */
198
- export function getCredentialTypes(): string[] {
199
- return Object.keys(CREDENTIAL_SCHEMAS)
200
- }
1
+ import { z } from 'zod'
2
+
3
+ /**
4
+ * Credential field definition
5
+ */
6
+ export interface CredentialField {
7
+ key: string
8
+ label: string
9
+ type: 'password' | 'text'
10
+ required: boolean
11
+ placeholder?: string
12
+ description?: string
13
+ }
14
+
15
+ /**
16
+ * Credential schema definition
17
+ */
18
+ export interface CredentialSchema {
19
+ type: string
20
+ label: string
21
+ description: string
22
+ fields?: CredentialField[]
23
+ docsUrl?: string
24
+ nameSuggestions: string[]
25
+ oauthProvider?: string // For OAuth types
26
+ }
27
+
28
+ /**
29
+ * Zod schemas for runtime validation
30
+ */
31
+ const CredentialFieldSchema = z.object({
32
+ key: z.string(),
33
+ label: z.string(),
34
+ type: z.enum(['password', 'text']),
35
+ required: z.boolean(),
36
+ placeholder: z.string().optional(),
37
+ description: z.string().optional()
38
+ })
39
+
40
+ const CredentialSchemaZod = z.object({
41
+ type: z.string(),
42
+ label: z.string(),
43
+ description: z.string(),
44
+ fields: z.array(CredentialFieldSchema).optional(),
45
+ docsUrl: z.string().url().optional(),
46
+ nameSuggestions: z.array(z.string()),
47
+ oauthProvider: z.string().optional()
48
+ })
49
+
50
+ /**
51
+ * Credential Schema Registry
52
+ *
53
+ * Add new integration = add schema object here (no modal changes needed)
54
+ *
55
+ * Schema types:
56
+ * - oauth: OAuth-based authentication (handled via OAuth flow)
57
+ * - single_field: Single API key field (generic)
58
+ */
59
+ export const CREDENTIAL_SCHEMAS: Record<string, CredentialSchema> = {
60
+ 'google-sheets': {
61
+ type: 'oauth',
62
+ label: 'Google Sheets',
63
+ description: 'Google Sheets OAuth integration',
64
+ oauthProvider: 'google-sheets',
65
+ nameSuggestions: ['google-sheets-prod', 'google-sheets-dev', 'sheets-workspace']
66
+ },
67
+
68
+ dropbox: {
69
+ type: 'oauth',
70
+ label: 'Dropbox',
71
+ description: 'Dropbox OAuth integration',
72
+ oauthProvider: 'dropbox',
73
+ nameSuggestions: ['dropbox-prod', 'dropbox-dev', 'elevasis-dropbox']
74
+ },
75
+
76
+ oauth: {
77
+ type: 'oauth',
78
+ label: 'OAuth',
79
+ description: 'Generic OAuth credential',
80
+ nameSuggestions: []
81
+ },
82
+
83
+ 'api-key': {
84
+ type: 'single_field',
85
+ label: 'API Key',
86
+ description: 'Single-field API key credential',
87
+ fields: [
88
+ {
89
+ key: 'apiKey',
90
+ label: 'API Key',
91
+ type: 'password',
92
+ required: true,
93
+ placeholder: 'Enter your API key',
94
+ description: 'API key for the service'
95
+ }
96
+ ],
97
+ nameSuggestions: ['service-prod', 'service-dev', 'api-key']
98
+ },
99
+
100
+ 'webhook-secret': {
101
+ type: 'single_field',
102
+ label: 'Webhook Secret',
103
+ description: 'Webhook signing secret for signature validation',
104
+ fields: [
105
+ {
106
+ key: 'signingSecret',
107
+ label: 'Signing Secret',
108
+ type: 'password',
109
+ required: true,
110
+ placeholder: 'whsec_...',
111
+ description: 'Webhook signing secret from provider dashboard'
112
+ }
113
+ ],
114
+ nameSuggestions: ['my-org-cal-com-webhook', 'my-org-stripe-webhook', 'my-org-signature-api-webhook']
115
+ },
116
+
117
+ 'api-key-secret': {
118
+ type: 'api-key-secret',
119
+ label: 'API Key + Secret',
120
+ description: 'API key and secret pair authentication',
121
+ fields: [
122
+ {
123
+ key: 'apiKey',
124
+ label: 'API Key',
125
+ type: 'password',
126
+ required: true
127
+ },
128
+ {
129
+ key: 'apiSecret',
130
+ label: 'API Secret',
131
+ type: 'password',
132
+ required: true
133
+ }
134
+ ],
135
+ nameSuggestions: []
136
+ },
137
+
138
+ apify: {
139
+ type: 'single_field',
140
+ label: 'Apify',
141
+ description: 'Apify API token for running web-scraping actors (e.g. website crawl, Google Places scrape).',
142
+ fields: [
143
+ {
144
+ key: 'apiKey',
145
+ label: 'API Token',
146
+ type: 'password',
147
+ required: true,
148
+ placeholder: 'apify_api_...',
149
+ description: 'Personal API token from https://console.apify.com/account/integrations'
150
+ }
151
+ ],
152
+ docsUrl: 'https://docs.apify.com/platform/integrations/api',
153
+ nameSuggestions: ['elevasis-apify', 'apify-prod', 'apify-dev']
154
+ },
155
+
156
+ clickup: {
157
+ type: 'single_field',
158
+ label: 'ClickUp',
159
+ description: 'ClickUp personal API token for creating tasks in tenant-managed ClickUp workspaces.',
160
+ fields: [
161
+ {
162
+ key: 'apiToken',
163
+ label: 'API Token',
164
+ type: 'password',
165
+ required: true,
166
+ placeholder: 'pk_...',
167
+ description: 'Personal API token from ClickUp settings. Personal tokens start with pk_.'
168
+ }
169
+ ],
170
+ docsUrl: 'https://developer.clickup.com/docs/authentication',
171
+ nameSuggestions: ['clickup-demo', 'clickup-prod', 'clickup-dev']
172
+ }
173
+ }
174
+
175
+ /**
176
+ * Get credential schema by type
177
+ * @param type - Credential type identifier
178
+ * @returns Validated credential schema
179
+ * @throws ZodError if schema is malformed
180
+ */
181
+ export function getCredentialSchema(type: string): CredentialSchema {
182
+ const schema = CREDENTIAL_SCHEMAS[type] || CREDENTIAL_SCHEMAS['api-key']
183
+ return CredentialSchemaZod.parse(schema)
184
+ }
185
+
186
+ /**
187
+ * List all available credential types (for frontend dropdown)
188
+ * @returns Array of credential schemas
189
+ */
190
+ export function listCredentialSchemas(): CredentialSchema[] {
191
+ return Object.values(CREDENTIAL_SCHEMAS)
192
+ }
193
+
194
+ /**
195
+ * Get all credential type identifiers
196
+ * @returns Array of type strings
197
+ */
198
+ export function getCredentialTypes(): string[] {
199
+ return Object.keys(CREDENTIAL_SCHEMAS)
200
+ }
@@ -38,13 +38,13 @@ describe('OAuth Provider Registry', () => {
38
38
  })
39
39
 
40
40
  describe('listProviders', () => {
41
- it('should return all providers as array', () => {
42
- const providers = listProviders()
43
- expect(providers).toHaveLength(Object.keys(OAUTH_PROVIDERS).length)
44
- expect(providers).toContainEqual(OAUTH_PROVIDERS['google-sheets'])
45
- expect(providers).toContainEqual(OAUTH_PROVIDERS['google-calendar'])
46
- expect(providers).toContainEqual(OAUTH_PROVIDERS.dropbox)
47
- })
41
+ it('should return all providers as array', () => {
42
+ const providers = listProviders()
43
+ expect(providers).toHaveLength(Object.keys(OAUTH_PROVIDERS).length)
44
+ expect(providers).toContainEqual(OAUTH_PROVIDERS['google-sheets'])
45
+ expect(providers).toContainEqual(OAUTH_PROVIDERS['google-calendar'])
46
+ expect(providers).toContainEqual(OAUTH_PROVIDERS.dropbox)
47
+ })
48
48
 
49
49
  it('should return array with correct provider structure', () => {
50
50
  const providers = listProviders()
@@ -1,74 +1,74 @@
1
- import type { OAuthProviderConfig } from './types'
2
-
3
- /**
4
- * OAuth Provider Registry
5
- *
6
- * Add new integration = add config object here (no new code needed)
7
- *
8
- * Standard token exchange methods:
9
- * - basic-auth: client_id:client_secret in Authorization header
10
- * - form-encoded: credentials in URL-encoded body (Google)
11
- * - json-body: credentials in JSON body (most providers)
12
- *
13
- * Custom overrides for edge cases:
14
- * - customAuthFlow: Override authorization URL building
15
- * - customTokenExchange: Override token exchange logic
16
- */
17
- export const OAUTH_PROVIDERS: Record<string, OAuthProviderConfig> = {
18
- 'google-sheets': {
19
- id: 'google-sheets',
20
- name: 'Google Sheets',
21
- authUrl: 'https://accounts.google.com/o/oauth2/v2/auth',
22
- tokenUrl: 'https://oauth2.googleapis.com/token',
23
- authParams: {
24
- access_type: 'offline', // Required for refresh token
25
- prompt: 'consent' // Force consent to get refresh token on reconnect
26
- },
27
- tokenExchange: 'form-encoded',
28
- scopes: ['https://www.googleapis.com/auth/spreadsheets']
29
- },
30
-
31
- 'google-calendar': {
32
- id: 'google-calendar',
33
- name: 'Google Calendar',
34
- authUrl: 'https://accounts.google.com/o/oauth2/v2/auth',
35
- tokenUrl: 'https://oauth2.googleapis.com/token',
36
- authParams: {
37
- access_type: 'offline', // Required for refresh token
38
- prompt: 'consent' // Force consent to get refresh token on reconnect
39
- },
40
- tokenExchange: 'form-encoded',
41
- scopes: ['https://www.googleapis.com/auth/calendar.readonly']
42
- },
43
-
44
- dropbox: {
45
- id: 'dropbox',
46
- name: 'Dropbox',
47
- authUrl: 'https://www.dropbox.com/oauth2/authorize',
48
- tokenUrl: 'https://api.dropboxapi.com/oauth2/token',
49
- authParams: {
50
- token_access_type: 'offline' // Required for refresh token
51
- },
52
- tokenExchange: 'form-encoded',
53
- scopes: ['files.content.write', 'files.content.read', 'files.metadata.write']
54
- }
55
- }
56
-
57
- /**
58
- * Get provider config by ID
59
- * @throws Error if provider not found
60
- */
61
- export function getProviderConfig(providerId: string): OAuthProviderConfig {
62
- const config = OAUTH_PROVIDERS[providerId]
63
- if (!config) {
64
- throw new Error(`Unknown OAuth provider: ${providerId}`)
65
- }
66
- return config
67
- }
68
-
69
- /**
70
- * List all available providers (for frontend)
71
- */
72
- export function listProviders(): OAuthProviderConfig[] {
73
- return Object.values(OAUTH_PROVIDERS)
74
- }
1
+ import type { OAuthProviderConfig } from './types'
2
+
3
+ /**
4
+ * OAuth Provider Registry
5
+ *
6
+ * Add new integration = add config object here (no new code needed)
7
+ *
8
+ * Standard token exchange methods:
9
+ * - basic-auth: client_id:client_secret in Authorization header
10
+ * - form-encoded: credentials in URL-encoded body (Google)
11
+ * - json-body: credentials in JSON body (most providers)
12
+ *
13
+ * Custom overrides for edge cases:
14
+ * - customAuthFlow: Override authorization URL building
15
+ * - customTokenExchange: Override token exchange logic
16
+ */
17
+ export const OAUTH_PROVIDERS: Record<string, OAuthProviderConfig> = {
18
+ 'google-sheets': {
19
+ id: 'google-sheets',
20
+ name: 'Google Sheets',
21
+ authUrl: 'https://accounts.google.com/o/oauth2/v2/auth',
22
+ tokenUrl: 'https://oauth2.googleapis.com/token',
23
+ authParams: {
24
+ access_type: 'offline', // Required for refresh token
25
+ prompt: 'consent' // Force consent to get refresh token on reconnect
26
+ },
27
+ tokenExchange: 'form-encoded',
28
+ scopes: ['https://www.googleapis.com/auth/spreadsheets']
29
+ },
30
+
31
+ 'google-calendar': {
32
+ id: 'google-calendar',
33
+ name: 'Google Calendar',
34
+ authUrl: 'https://accounts.google.com/o/oauth2/v2/auth',
35
+ tokenUrl: 'https://oauth2.googleapis.com/token',
36
+ authParams: {
37
+ access_type: 'offline', // Required for refresh token
38
+ prompt: 'consent' // Force consent to get refresh token on reconnect
39
+ },
40
+ tokenExchange: 'form-encoded',
41
+ scopes: ['https://www.googleapis.com/auth/calendar.readonly']
42
+ },
43
+
44
+ dropbox: {
45
+ id: 'dropbox',
46
+ name: 'Dropbox',
47
+ authUrl: 'https://www.dropbox.com/oauth2/authorize',
48
+ tokenUrl: 'https://api.dropboxapi.com/oauth2/token',
49
+ authParams: {
50
+ token_access_type: 'offline' // Required for refresh token
51
+ },
52
+ tokenExchange: 'form-encoded',
53
+ scopes: ['files.content.write', 'files.content.read', 'files.metadata.write']
54
+ }
55
+ }
56
+
57
+ /**
58
+ * Get provider config by ID
59
+ * @throws Error if provider not found
60
+ */
61
+ export function getProviderConfig(providerId: string): OAuthProviderConfig {
62
+ const config = OAUTH_PROVIDERS[providerId]
63
+ if (!config) {
64
+ throw new Error(`Unknown OAuth provider: ${providerId}`)
65
+ }
66
+ return config
67
+ }
68
+
69
+ /**
70
+ * List all available providers (for frontend)
71
+ */
72
+ export function listProviders(): OAuthProviderConfig[] {
73
+ return Object.values(OAUTH_PROVIDERS)
74
+ }
@@ -1,43 +1,43 @@
1
- /**
2
- * OAuth Provider Credentials
3
- * Maps provider IDs to environment variable names
4
- * Single source of truth for credential lookup
5
- */
6
-
7
- const PROVIDER_ENV_VARS: Record<string, { clientIdEnv: string; clientSecretEnv: string }> = {
8
- 'google-sheets': {
9
- clientIdEnv: 'GOOGLE_OAUTH_CLIENT_ID',
10
- clientSecretEnv: 'GOOGLE_OAUTH_CLIENT_SECRET'
11
- },
12
- 'google-calendar': {
13
- clientIdEnv: 'GOOGLE_OAUTH_CLIENT_ID',
14
- clientSecretEnv: 'GOOGLE_OAUTH_CLIENT_SECRET'
15
- },
16
- dropbox: {
17
- clientIdEnv: 'DROPBOX_APP_KEY',
18
- clientSecretEnv: 'DROPBOX_APP_SECRET'
19
- }
20
- }
21
-
22
- /**
23
- * Get OAuth client credentials for a provider
24
- * @throws Error if provider unknown or credentials missing
25
- */
26
- export function getOAuthCredentials(providerId: string): { clientId: string; clientSecret: string } {
27
- const config = PROVIDER_ENV_VARS[providerId]
28
- if (!config) {
29
- throw new Error(`Unknown OAuth provider: ${providerId}`)
30
- }
31
-
32
- const clientId = process.env[config.clientIdEnv]
33
- const clientSecret = process.env[config.clientSecretEnv]
34
-
35
- if (!clientId) {
36
- throw new Error(`Missing environment variable: ${config.clientIdEnv}`)
37
- }
38
- if (!clientSecret) {
39
- throw new Error(`Missing environment variable: ${config.clientSecretEnv}`)
40
- }
41
-
42
- return { clientId, clientSecret }
43
- }
1
+ /**
2
+ * OAuth Provider Credentials
3
+ * Maps provider IDs to environment variable names
4
+ * Single source of truth for credential lookup
5
+ */
6
+
7
+ const PROVIDER_ENV_VARS: Record<string, { clientIdEnv: string; clientSecretEnv: string }> = {
8
+ 'google-sheets': {
9
+ clientIdEnv: 'GOOGLE_OAUTH_CLIENT_ID',
10
+ clientSecretEnv: 'GOOGLE_OAUTH_CLIENT_SECRET'
11
+ },
12
+ 'google-calendar': {
13
+ clientIdEnv: 'GOOGLE_OAUTH_CLIENT_ID',
14
+ clientSecretEnv: 'GOOGLE_OAUTH_CLIENT_SECRET'
15
+ },
16
+ dropbox: {
17
+ clientIdEnv: 'DROPBOX_APP_KEY',
18
+ clientSecretEnv: 'DROPBOX_APP_SECRET'
19
+ }
20
+ }
21
+
22
+ /**
23
+ * Get OAuth client credentials for a provider
24
+ * @throws Error if provider unknown or credentials missing
25
+ */
26
+ export function getOAuthCredentials(providerId: string): { clientId: string; clientSecret: string } {
27
+ const config = PROVIDER_ENV_VARS[providerId]
28
+ if (!config) {
29
+ throw new Error(`Unknown OAuth provider: ${providerId}`)
30
+ }
31
+
32
+ const clientId = process.env[config.clientIdEnv]
33
+ const clientSecret = process.env[config.clientSecretEnv]
34
+
35
+ if (!clientId) {
36
+ throw new Error(`Missing environment variable: ${config.clientIdEnv}`)
37
+ }
38
+ if (!clientSecret) {
39
+ throw new Error(`Missing environment variable: ${config.clientSecretEnv}`)
40
+ }
41
+
42
+ return { clientId, clientSecret }
43
+ }