@elevasis/core 0.23.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 (241) hide show
  1. package/dist/index.d.ts +1326 -552
  2. package/dist/index.js +869 -154
  3. package/dist/knowledge/index.d.ts +487 -209
  4. package/dist/knowledge/index.js +104 -1
  5. package/dist/organization-model/index.d.ts +1326 -552
  6. package/dist/organization-model/index.js +869 -154
  7. package/dist/test-utils/index.d.ts +357 -72
  8. package/dist/test-utils/index.js +795 -142
  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 -12
  13. package/src/_gen/__tests__/__snapshots__/contracts.md.snap +2102 -2096
  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 +1492 -1497
  37. package/src/business/acquisition/build-templates.test.ts +240 -240
  38. package/src/business/acquisition/build-templates.ts +98 -98
  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 -153
  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 -396
  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 +32 -32
  123. package/src/knowledge/__tests__/queries.test.ts +626 -535
  124. package/src/knowledge/format.ts +99 -99
  125. package/src/knowledge/index.ts +5 -5
  126. package/src/knowledge/published.ts +5 -5
  127. package/src/knowledge/queries.ts +269 -218
  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 -149
  131. package/src/organization-model/__tests__/content-kinds-registry.test.ts +210 -210
  132. package/src/organization-model/__tests__/defaults.test.ts +168 -168
  133. package/src/organization-model/__tests__/domains/actions.test.ts +78 -56
  134. package/src/organization-model/__tests__/domains/customers.test.ts +299 -299
  135. package/src/organization-model/__tests__/domains/entities.test.ts +56 -56
  136. package/src/organization-model/__tests__/domains/goals.test.ts +493 -493
  137. package/src/organization-model/__tests__/domains/identity.test.ts +280 -280
  138. package/src/organization-model/__tests__/domains/navigation.test.ts +268 -268
  139. package/src/organization-model/__tests__/domains/offerings.test.ts +414 -414
  140. package/src/organization-model/__tests__/domains/policies.test.ts +323 -323
  141. package/src/organization-model/__tests__/domains/resource-mappings.test.ts +293 -293
  142. package/src/organization-model/__tests__/domains/resources.test.ts +382 -283
  143. package/src/organization-model/__tests__/domains/roles.test.ts +463 -463
  144. package/src/organization-model/__tests__/domains/statuses.test.ts +246 -246
  145. package/src/organization-model/__tests__/domains/systems.test.ts +209 -209
  146. package/src/organization-model/__tests__/flatten-additive-merge.test.ts +362 -361
  147. package/src/organization-model/__tests__/foundation.test.ts +77 -77
  148. package/src/organization-model/__tests__/get-resources-for-system.test.ts +144 -144
  149. package/src/organization-model/__tests__/graph.test.ts +1246 -887
  150. package/src/organization-model/__tests__/icons.test.ts +10 -1
  151. package/src/organization-model/__tests__/knowledge.test.ts +251 -15
  152. package/src/organization-model/__tests__/lookup-helpers.test.ts +438 -438
  153. package/src/organization-model/__tests__/migration-helpers.test.ts +591 -591
  154. package/src/organization-model/__tests__/prospecting-ssot.test.ts +103 -103
  155. package/src/organization-model/__tests__/recursive-system-schema.test.ts +535 -506
  156. package/src/organization-model/__tests__/resolve.test.ts +274 -164
  157. package/src/organization-model/__tests__/schema.test.ts +834 -301
  158. package/src/organization-model/__tests__/surface-projection.test.ts +284 -284
  159. package/src/organization-model/catalogs/lead-gen.ts +144 -144
  160. package/src/organization-model/content-kinds/config.ts +36 -36
  161. package/src/organization-model/content-kinds/index.ts +76 -72
  162. package/src/organization-model/content-kinds/pipeline.ts +68 -68
  163. package/src/organization-model/content-kinds/registry.ts +44 -44
  164. package/src/organization-model/content-kinds/status.ts +71 -71
  165. package/src/organization-model/content-kinds/template.ts +83 -83
  166. package/src/organization-model/content-kinds/types.ts +117 -117
  167. package/src/organization-model/contracts.ts +27 -27
  168. package/src/organization-model/defaults.ts +40 -50
  169. package/src/organization-model/domains/actions.ts +333 -239
  170. package/src/organization-model/domains/customers.ts +78 -78
  171. package/src/organization-model/domains/entities.ts +144 -144
  172. package/src/organization-model/domains/goals.ts +83 -83
  173. package/src/organization-model/domains/knowledge.ts +117 -101
  174. package/src/organization-model/domains/navigation.ts +139 -139
  175. package/src/organization-model/domains/offerings.ts +71 -71
  176. package/src/organization-model/domains/policies.ts +102 -102
  177. package/src/organization-model/domains/projects.ts +14 -14
  178. package/src/organization-model/domains/prospecting.ts +395 -395
  179. package/src/organization-model/domains/resources.ts +167 -132
  180. package/src/organization-model/domains/roles.ts +96 -96
  181. package/src/organization-model/domains/sales.test.ts +218 -218
  182. package/src/organization-model/domains/sales.ts +380 -380
  183. package/src/organization-model/domains/shared.ts +63 -63
  184. package/src/organization-model/domains/statuses.ts +339 -339
  185. package/src/organization-model/domains/systems.ts +217 -172
  186. package/src/organization-model/foundation.ts +75 -75
  187. package/src/organization-model/graph/build.ts +1016 -888
  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 +76 -70
  191. package/src/organization-model/graph/types.ts +73 -67
  192. package/src/organization-model/helpers.ts +289 -241
  193. package/src/organization-model/icons.ts +78 -66
  194. package/src/organization-model/index.ts +130 -128
  195. package/src/organization-model/migration-helpers.ts +247 -244
  196. package/src/organization-model/ontology.ts +661 -0
  197. package/src/organization-model/organization-graph.mdx +110 -90
  198. package/src/organization-model/organization-model.mdx +226 -219
  199. package/src/organization-model/published.ts +289 -235
  200. package/src/organization-model/resolve.ts +146 -91
  201. package/src/organization-model/schema.ts +790 -671
  202. package/src/organization-model/surface-projection.ts +212 -212
  203. package/src/organization-model/types.ts +177 -167
  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 +10 -10
  208. package/src/platform/registry/__tests__/resource-link.test.ts +35 -35
  209. package/src/platform/registry/__tests__/resource-registry.integration.test.ts +20 -20
  210. package/src/platform/registry/__tests__/resource-registry.nested-systems.test.ts +245 -245
  211. package/src/platform/registry/__tests__/resource-registry.test.ts +2053 -2053
  212. package/src/platform/registry/__tests__/validation.test.ts +1347 -1347
  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 -890
  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 -745
  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 +2101 -2096
  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 -3153
  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 -44
@@ -1,2 +1,2 @@
1
- export { GoogleCalendarAdapter } from './google-calendar-adapter'
2
- export type { CalendarEvent, CalendarDateTime, ListEventsResult } from './google-calendar-adapter'
1
+ export { GoogleCalendarAdapter } from './google-calendar-adapter'
2
+ export type { CalendarEvent, CalendarDateTime, ListEventsResult } from './google-calendar-adapter'
@@ -1,261 +1,261 @@
1
- import { describe, it, expect, beforeAll, afterAll, vi } from 'vitest'
2
- import { GoogleSheetsAdapter } from '../google-sheets-adapter'
3
- import type { ExecutionContext } from '../../../../../../base/types'
4
- import { createClient } from '@supabase/supabase-js'
5
- import type { Database } from '../../../../../../../../supabase/database.types'
6
- import { decryptCredentialValue } from '../../../../../../../../auth/multi-tenancy/credentials/server/service'
7
-
8
- /**
9
- * Google Sheets Integration Tests
10
- *
11
- * Consolidated test suite covering:
12
- * - Basic CRUD operations (read, write, append, batch update, clear)
13
- * - Workflow-friendly methods (getHeaders, getRowByValue, upsertRow, etc.)
14
- * - Error handling
15
- *
16
- * Rate limit: Google Sheets API allows 60 requests/minute/user
17
- * Tests are grouped to minimize API calls.
18
- */
19
-
20
- const SKIP_TESTS = true
21
-
22
- describe.skipIf(SKIP_TESTS)('Google Sheets Integration Tests', () => {
23
- const adapter = new GoogleSheetsAdapter()
24
- const organizationId = 'f9aa5a56-8c13-4cd1-9161-8827ae7b452b'
25
- const credentialName = 'elevasis-google-sheets'
26
- const spreadsheetId = '1cgrLVPE0bpq4GAqo8RvRh3VkP49Ut-osuNKL-hNx44Y'
27
-
28
- const context: ExecutionContext = {
29
- organizationId,
30
- executionId: 'sheets-integration-test',
31
- resourceId: 'sheets-test-agent',
32
- resourceType: 'agent',
33
- logger: { info: vi.fn(), warn: vi.fn(), error: vi.fn(), debug: vi.fn(), child: vi.fn().mockReturnThis() }
34
- }
35
-
36
- let credentials: Record<string, unknown>
37
- let testSheetName: string
38
-
39
- beforeAll(async () => {
40
- console.log('\n=== Google Sheets Integration Tests ===')
41
- const supabase = createClient<Database>(process.env.SUPABASE_URL!, process.env.SUPABASE_SERVICE_KEY!)
42
-
43
- const { data: credRow, error } = await supabase
44
- .from('credentials')
45
- .select('encrypted_value')
46
- .eq('organization_id', organizationId)
47
- .eq('name', credentialName)
48
- .single()
49
-
50
- if (error || !credRow) {
51
- throw new Error(`Credential not found: ${error?.message}`)
52
- }
53
-
54
- credentials = decryptCredentialValue(credRow.encrypted_value)
55
- console.log('✓ Credentials loaded\n')
56
- }, 15000)
57
-
58
- afterAll(async () => {
59
- // Clean up test data
60
- const rangesToClean = ['Test!A100:C105', 'Test!A200:C210', 'Test!A300:C302']
61
- for (const range of rangesToClean) {
62
- try {
63
- await adapter.call('clearRange', { spreadsheetId, range }, credentials, context)
64
- } catch {
65
- // Ignore cleanup errors
66
- }
67
- }
68
- console.log('\n=== Tests Complete ===\n')
69
- })
70
-
71
- // ============================================
72
- // 1. Basic CRUD Operations
73
- // ============================================
74
-
75
- describe('Basic CRUD Operations', () => {
76
- it('should get spreadsheet metadata', async () => {
77
- const result = (await adapter.call('getSpreadsheetMetadata', { spreadsheetId }, credentials, context)) as {
78
- title: string
79
- sheets: Array<{ sheetId: number; title: string; index: number }>
80
- }
81
-
82
- expect(result.title).toBeTruthy()
83
- expect(result.sheets.length).toBeGreaterThan(0)
84
- testSheetName = result.sheets[0].title
85
- console.log(`Using sheet: ${testSheetName}`)
86
- }, 15000)
87
-
88
- it('should read, write, and clear data', async () => {
89
- const range = 'Test!A100:C101'
90
- const testData = [
91
- ['TestName', '101', 'Test description'],
92
- ['TestName2', '102', 'Another description']
93
- ]
94
-
95
- // Write
96
- const writeResult = (await adapter.call(
97
- 'writeSheet',
98
- { spreadsheetId, range, values: testData },
99
- credentials,
100
- context
101
- )) as { updatedCells: number }
102
- expect(writeResult.updatedCells).toBe(6)
103
-
104
- // Read back
105
- const readResult = (await adapter.call('readSheet', { spreadsheetId, range }, credentials, context)) as {
106
- values: string[][]
107
- }
108
- expect(readResult.values[0][0]).toBe('TestName')
109
- expect(readResult.values[1][0]).toBe('TestName2')
110
-
111
- // Clear
112
- const clearResult = (await adapter.call('clearRange', { spreadsheetId, range }, credentials, context)) as {
113
- clearedRange: string
114
- }
115
- expect(clearResult.clearedRange).toContain('A100')
116
-
117
- // Verify cleared
118
- const verifyResult = (await adapter.call('readSheet', { spreadsheetId, range }, credentials, context)) as {
119
- values: string[][]
120
- }
121
- expect(verifyResult.values.length).toBe(0)
122
- }, 15000)
123
-
124
- it('should append rows and batch update', async () => {
125
- // Append
126
- const appendResult = (await adapter.call(
127
- 'appendRows',
128
- {
129
- spreadsheetId,
130
- range: 'Test!A200:C200',
131
- values: [['Appended1', '201', 'Appended row']]
132
- },
133
- credentials,
134
- context
135
- )) as { updatedRows: number }
136
- expect(appendResult.updatedRows).toBe(1)
137
-
138
- // Batch update
139
- const batchResult = (await adapter.call(
140
- 'batchUpdate',
141
- {
142
- spreadsheetId,
143
- data: [
144
- { range: 'Test!A202:C202', values: [['Batch1', '202', 'Batch row 1']] },
145
- { range: 'Test!A203:C203', values: [['Batch2', '203', 'Batch row 2']] }
146
- ]
147
- },
148
- credentials,
149
- context
150
- )) as { totalUpdatedCells: number; totalUpdatedRows: number }
151
- expect(batchResult.totalUpdatedRows).toBe(2)
152
- }, 20000)
153
- })
154
-
155
- // ============================================
156
- // 2. Workflow-Friendly Methods
157
- // ============================================
158
-
159
- describe('Workflow-Friendly Methods', () => {
160
- it('should get headers and find row by value', async () => {
161
- // Setup: Write test data with headers
162
- await adapter.call(
163
- 'writeSheet',
164
- {
165
- spreadsheetId,
166
- range: 'Test!A1:C2',
167
- values: [
168
- ['Name', 'Id', 'Description'],
169
- ['FindMe', '999', 'Test row for lookup']
170
- ]
171
- },
172
- credentials,
173
- context
174
- )
175
-
176
- // Get headers
177
- const headersResult = (await adapter.call(
178
- 'getHeaders',
179
- { spreadsheetId, sheetName: 'Test' },
180
- credentials,
181
- context
182
- )) as { headers: string[]; columnMap: Record<string, string> }
183
- expect(headersResult.headers).toContain('Name')
184
- expect(headersResult.columnMap.Name).toBe('A')
185
-
186
- // Find row by value
187
- const findResult = (await adapter.call(
188
- 'getRowByValue',
189
- { spreadsheetId, sheetName: 'Test', searchColumn: 'A', searchValue: 'FindMe' },
190
- credentials,
191
- context
192
- )) as { found: boolean; rowNumber: number | null; rowData: string[] | null }
193
- expect(findResult.found).toBe(true)
194
- expect(findResult.rowData?.[0]).toBe('FindMe')
195
- }, 20000)
196
-
197
- it('should upsert and update rows by value', async () => {
198
- const uniqueKey = `UpsertTest_${Date.now()}`
199
-
200
- // Upsert (insert)
201
- const insertResult = (await adapter.call(
202
- 'upsertRow',
203
- {
204
- spreadsheetId,
205
- sheetName: 'Test',
206
- keyColumn: 'A',
207
- keyValue: uniqueKey,
208
- rowData: { Name: uniqueKey, Id: '888', Description: 'Inserted via upsert' }
209
- },
210
- credentials,
211
- context
212
- )) as { action: 'inserted' | 'updated' }
213
- expect(insertResult.action).toBe('inserted')
214
-
215
- // Upsert (update)
216
- const updateResult = (await adapter.call(
217
- 'upsertRow',
218
- {
219
- spreadsheetId,
220
- sheetName: 'Test',
221
- keyColumn: 'A',
222
- keyValue: uniqueKey,
223
- rowData: { Name: uniqueKey, Id: '888', Description: 'Updated via upsert' }
224
- },
225
- credentials,
226
- context
227
- )) as { action: 'inserted' | 'updated' }
228
- expect(updateResult.action).toBe('updated')
229
-
230
- // Clean up
231
- await adapter.call(
232
- 'deleteRowByValue',
233
- { spreadsheetId, sheetName: 'Test', searchColumn: 'A', searchValue: uniqueKey },
234
- credentials,
235
- context
236
- )
237
- }, 25000)
238
- })
239
-
240
- // ============================================
241
- // 3. Error Handling
242
- // ============================================
243
-
244
- describe('Error Handling', () => {
245
- it('should handle invalid spreadsheet ID', async () => {
246
- await expect(
247
- adapter.call('readSheet', { spreadsheetId: 'invalid-id', range: 'Sheet1!A1' }, credentials, context)
248
- ).rejects.toThrow()
249
- }, 15000)
250
-
251
- it('should validate required fields', async () => {
252
- await expect(adapter.call('readSheet', { spreadsheetId: '', range: 'A1' }, credentials, context)).rejects.toThrow(
253
- 'Missing required field: spreadsheetId'
254
- )
255
-
256
- await expect(
257
- adapter.call('writeSheet', { spreadsheetId, range: 'A1', values: null }, credentials, context)
258
- ).rejects.toThrow('Missing required field: values')
259
- }, 15000)
260
- })
261
- })
1
+ import { describe, it, expect, beforeAll, afterAll, vi } from 'vitest'
2
+ import { GoogleSheetsAdapter } from '../google-sheets-adapter'
3
+ import type { ExecutionContext } from '../../../../../../base/types'
4
+ import { createClient } from '@supabase/supabase-js'
5
+ import type { Database } from '../../../../../../../../supabase/database.types'
6
+ import { decryptCredentialValue } from '../../../../../../../../auth/multi-tenancy/credentials/server/service'
7
+
8
+ /**
9
+ * Google Sheets Integration Tests
10
+ *
11
+ * Consolidated test suite covering:
12
+ * - Basic CRUD operations (read, write, append, batch update, clear)
13
+ * - Workflow-friendly methods (getHeaders, getRowByValue, upsertRow, etc.)
14
+ * - Error handling
15
+ *
16
+ * Rate limit: Google Sheets API allows 60 requests/minute/user
17
+ * Tests are grouped to minimize API calls.
18
+ */
19
+
20
+ const SKIP_TESTS = true
21
+
22
+ describe.skipIf(SKIP_TESTS)('Google Sheets Integration Tests', () => {
23
+ const adapter = new GoogleSheetsAdapter()
24
+ const organizationId = 'f9aa5a56-8c13-4cd1-9161-8827ae7b452b'
25
+ const credentialName = 'elevasis-google-sheets'
26
+ const spreadsheetId = '1cgrLVPE0bpq4GAqo8RvRh3VkP49Ut-osuNKL-hNx44Y'
27
+
28
+ const context: ExecutionContext = {
29
+ organizationId,
30
+ executionId: 'sheets-integration-test',
31
+ resourceId: 'sheets-test-agent',
32
+ resourceType: 'agent',
33
+ logger: { info: vi.fn(), warn: vi.fn(), error: vi.fn(), debug: vi.fn(), child: vi.fn().mockReturnThis() }
34
+ }
35
+
36
+ let credentials: Record<string, unknown>
37
+ let testSheetName: string
38
+
39
+ beforeAll(async () => {
40
+ console.log('\n=== Google Sheets Integration Tests ===')
41
+ const supabase = createClient<Database>(process.env.SUPABASE_URL!, process.env.SUPABASE_SERVICE_KEY!)
42
+
43
+ const { data: credRow, error } = await supabase
44
+ .from('credentials')
45
+ .select('encrypted_value')
46
+ .eq('organization_id', organizationId)
47
+ .eq('name', credentialName)
48
+ .single()
49
+
50
+ if (error || !credRow) {
51
+ throw new Error(`Credential not found: ${error?.message}`)
52
+ }
53
+
54
+ credentials = decryptCredentialValue(credRow.encrypted_value)
55
+ console.log('✓ Credentials loaded\n')
56
+ }, 15000)
57
+
58
+ afterAll(async () => {
59
+ // Clean up test data
60
+ const rangesToClean = ['Test!A100:C105', 'Test!A200:C210', 'Test!A300:C302']
61
+ for (const range of rangesToClean) {
62
+ try {
63
+ await adapter.call('clearRange', { spreadsheetId, range }, credentials, context)
64
+ } catch {
65
+ // Ignore cleanup errors
66
+ }
67
+ }
68
+ console.log('\n=== Tests Complete ===\n')
69
+ })
70
+
71
+ // ============================================
72
+ // 1. Basic CRUD Operations
73
+ // ============================================
74
+
75
+ describe('Basic CRUD Operations', () => {
76
+ it('should get spreadsheet metadata', async () => {
77
+ const result = (await adapter.call('getSpreadsheetMetadata', { spreadsheetId }, credentials, context)) as {
78
+ title: string
79
+ sheets: Array<{ sheetId: number; title: string; index: number }>
80
+ }
81
+
82
+ expect(result.title).toBeTruthy()
83
+ expect(result.sheets.length).toBeGreaterThan(0)
84
+ testSheetName = result.sheets[0].title
85
+ console.log(`Using sheet: ${testSheetName}`)
86
+ }, 15000)
87
+
88
+ it('should read, write, and clear data', async () => {
89
+ const range = 'Test!A100:C101'
90
+ const testData = [
91
+ ['TestName', '101', 'Test description'],
92
+ ['TestName2', '102', 'Another description']
93
+ ]
94
+
95
+ // Write
96
+ const writeResult = (await adapter.call(
97
+ 'writeSheet',
98
+ { spreadsheetId, range, values: testData },
99
+ credentials,
100
+ context
101
+ )) as { updatedCells: number }
102
+ expect(writeResult.updatedCells).toBe(6)
103
+
104
+ // Read back
105
+ const readResult = (await adapter.call('readSheet', { spreadsheetId, range }, credentials, context)) as {
106
+ values: string[][]
107
+ }
108
+ expect(readResult.values[0][0]).toBe('TestName')
109
+ expect(readResult.values[1][0]).toBe('TestName2')
110
+
111
+ // Clear
112
+ const clearResult = (await adapter.call('clearRange', { spreadsheetId, range }, credentials, context)) as {
113
+ clearedRange: string
114
+ }
115
+ expect(clearResult.clearedRange).toContain('A100')
116
+
117
+ // Verify cleared
118
+ const verifyResult = (await adapter.call('readSheet', { spreadsheetId, range }, credentials, context)) as {
119
+ values: string[][]
120
+ }
121
+ expect(verifyResult.values.length).toBe(0)
122
+ }, 15000)
123
+
124
+ it('should append rows and batch update', async () => {
125
+ // Append
126
+ const appendResult = (await adapter.call(
127
+ 'appendRows',
128
+ {
129
+ spreadsheetId,
130
+ range: 'Test!A200:C200',
131
+ values: [['Appended1', '201', 'Appended row']]
132
+ },
133
+ credentials,
134
+ context
135
+ )) as { updatedRows: number }
136
+ expect(appendResult.updatedRows).toBe(1)
137
+
138
+ // Batch update
139
+ const batchResult = (await adapter.call(
140
+ 'batchUpdate',
141
+ {
142
+ spreadsheetId,
143
+ data: [
144
+ { range: 'Test!A202:C202', values: [['Batch1', '202', 'Batch row 1']] },
145
+ { range: 'Test!A203:C203', values: [['Batch2', '203', 'Batch row 2']] }
146
+ ]
147
+ },
148
+ credentials,
149
+ context
150
+ )) as { totalUpdatedCells: number; totalUpdatedRows: number }
151
+ expect(batchResult.totalUpdatedRows).toBe(2)
152
+ }, 20000)
153
+ })
154
+
155
+ // ============================================
156
+ // 2. Workflow-Friendly Methods
157
+ // ============================================
158
+
159
+ describe('Workflow-Friendly Methods', () => {
160
+ it('should get headers and find row by value', async () => {
161
+ // Setup: Write test data with headers
162
+ await adapter.call(
163
+ 'writeSheet',
164
+ {
165
+ spreadsheetId,
166
+ range: 'Test!A1:C2',
167
+ values: [
168
+ ['Name', 'Id', 'Description'],
169
+ ['FindMe', '999', 'Test row for lookup']
170
+ ]
171
+ },
172
+ credentials,
173
+ context
174
+ )
175
+
176
+ // Get headers
177
+ const headersResult = (await adapter.call(
178
+ 'getHeaders',
179
+ { spreadsheetId, sheetName: 'Test' },
180
+ credentials,
181
+ context
182
+ )) as { headers: string[]; columnMap: Record<string, string> }
183
+ expect(headersResult.headers).toContain('Name')
184
+ expect(headersResult.columnMap.Name).toBe('A')
185
+
186
+ // Find row by value
187
+ const findResult = (await adapter.call(
188
+ 'getRowByValue',
189
+ { spreadsheetId, sheetName: 'Test', searchColumn: 'A', searchValue: 'FindMe' },
190
+ credentials,
191
+ context
192
+ )) as { found: boolean; rowNumber: number | null; rowData: string[] | null }
193
+ expect(findResult.found).toBe(true)
194
+ expect(findResult.rowData?.[0]).toBe('FindMe')
195
+ }, 20000)
196
+
197
+ it('should upsert and update rows by value', async () => {
198
+ const uniqueKey = `UpsertTest_${Date.now()}`
199
+
200
+ // Upsert (insert)
201
+ const insertResult = (await adapter.call(
202
+ 'upsertRow',
203
+ {
204
+ spreadsheetId,
205
+ sheetName: 'Test',
206
+ keyColumn: 'A',
207
+ keyValue: uniqueKey,
208
+ rowData: { Name: uniqueKey, Id: '888', Description: 'Inserted via upsert' }
209
+ },
210
+ credentials,
211
+ context
212
+ )) as { action: 'inserted' | 'updated' }
213
+ expect(insertResult.action).toBe('inserted')
214
+
215
+ // Upsert (update)
216
+ const updateResult = (await adapter.call(
217
+ 'upsertRow',
218
+ {
219
+ spreadsheetId,
220
+ sheetName: 'Test',
221
+ keyColumn: 'A',
222
+ keyValue: uniqueKey,
223
+ rowData: { Name: uniqueKey, Id: '888', Description: 'Updated via upsert' }
224
+ },
225
+ credentials,
226
+ context
227
+ )) as { action: 'inserted' | 'updated' }
228
+ expect(updateResult.action).toBe('updated')
229
+
230
+ // Clean up
231
+ await adapter.call(
232
+ 'deleteRowByValue',
233
+ { spreadsheetId, sheetName: 'Test', searchColumn: 'A', searchValue: uniqueKey },
234
+ credentials,
235
+ context
236
+ )
237
+ }, 25000)
238
+ })
239
+
240
+ // ============================================
241
+ // 3. Error Handling
242
+ // ============================================
243
+
244
+ describe('Error Handling', () => {
245
+ it('should handle invalid spreadsheet ID', async () => {
246
+ await expect(
247
+ adapter.call('readSheet', { spreadsheetId: 'invalid-id', range: 'Sheet1!A1' }, credentials, context)
248
+ ).rejects.toThrow()
249
+ }, 15000)
250
+
251
+ it('should validate required fields', async () => {
252
+ await expect(adapter.call('readSheet', { spreadsheetId: '', range: 'A1' }, credentials, context)).rejects.toThrow(
253
+ 'Missing required field: spreadsheetId'
254
+ )
255
+
256
+ await expect(
257
+ adapter.call('writeSheet', { spreadsheetId, range: 'A1', values: null }, credentials, context)
258
+ ).rejects.toThrow('Missing required field: values')
259
+ }, 15000)
260
+ })
261
+ })