@elevasis/core 0.7.1 → 0.8.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 (473) hide show
  1. package/package.json +1 -1
  2. package/src/README.md +41 -41
  3. package/src/__tests__/publish.test.ts +18 -18
  4. package/src/__tests__/{template-foundations-compatibility.test.ts → template-core-compatibility.test.ts} +99 -99
  5. package/src/_gen/__tests__/__snapshots__/contracts.md.snap +1135 -1131
  6. package/src/_gen/__tests__/scaffold-contracts.test.ts +53 -53
  7. package/src/_gen/scaffold-contracts.ts +45 -45
  8. package/src/auth/multi-tenancy/credentials/README.md +38 -38
  9. package/src/auth/multi-tenancy/credentials/index.ts +6 -6
  10. package/src/auth/multi-tenancy/credentials/server/encryption.ts +39 -39
  11. package/src/auth/multi-tenancy/credentials/server/service.ts +60 -60
  12. package/src/auth/multi-tenancy/index.ts +17 -17
  13. package/src/auth/multi-tenancy/invitations/api-schemas.ts +107 -107
  14. package/src/auth/multi-tenancy/invitations/index.ts +37 -37
  15. package/src/auth/multi-tenancy/invitations/invitation.ts +86 -86
  16. package/src/auth/multi-tenancy/invitations/server/index.ts +25 -25
  17. package/src/auth/multi-tenancy/invitations/server/transforms.ts +24 -24
  18. package/src/auth/multi-tenancy/invitations/server/workos.ts +24 -24
  19. package/src/auth/multi-tenancy/invitations/supabase.ts +50 -50
  20. package/src/auth/multi-tenancy/memberships/api-schemas.ts +126 -126
  21. package/src/auth/multi-tenancy/memberships/index.ts +21 -21
  22. package/src/auth/multi-tenancy/memberships/membership.ts +138 -138
  23. package/src/auth/multi-tenancy/memberships/server/index.ts +15 -15
  24. package/src/auth/multi-tenancy/memberships/server/transforms.ts +32 -32
  25. package/src/auth/multi-tenancy/memberships/server/workos.ts +21 -21
  26. package/src/auth/multi-tenancy/memberships/supabase.ts +46 -46
  27. package/src/auth/multi-tenancy/organizations/api-schemas.ts +128 -128
  28. package/src/auth/multi-tenancy/organizations/index.ts +23 -23
  29. package/src/auth/multi-tenancy/organizations/organization.ts +24 -24
  30. package/src/auth/multi-tenancy/organizations/server/index.ts +10 -10
  31. package/src/auth/multi-tenancy/organizations/server/transforms.ts +35 -35
  32. package/src/auth/multi-tenancy/organizations/server/workos.ts +20 -20
  33. package/src/auth/multi-tenancy/types.ts +83 -83
  34. package/src/auth/multi-tenancy/users/api-schemas.ts +194 -194
  35. package/src/auth/multi-tenancy/users/index.ts +27 -27
  36. package/src/auth/multi-tenancy/users/server/index.ts +19 -19
  37. package/src/auth/multi-tenancy/users/server/transforms.ts +21 -21
  38. package/src/auth/multi-tenancy/users/server/workos.ts +16 -16
  39. package/src/auth/multi-tenancy/users/user.ts +65 -65
  40. package/src/business/README.md +52 -52
  41. package/src/business/__tests__/entities-published.test.ts +33 -33
  42. package/src/business/acquisition/api-schemas.ts +759 -759
  43. package/src/business/acquisition/index.ts +109 -109
  44. package/src/business/acquisition/types.ts +402 -402
  45. package/src/business/base-entities.test.ts +481 -481
  46. package/src/business/base-entities.ts +241 -241
  47. package/src/business/entities-published.ts +24 -24
  48. package/src/business/index.ts +15 -15
  49. package/src/business/pdf/browser/pdfmake-browser.ts +229 -229
  50. package/src/business/pdf/index.ts +10 -10
  51. package/src/business/pdf/server/index.ts +21 -21
  52. package/src/business/pdf/server/themes/default.ts +8 -8
  53. package/src/business/pdf/server/themes/index.ts +9 -9
  54. package/src/business/pdf/server/themes/types.ts +8 -8
  55. package/src/business/pdf/types.ts +272 -272
  56. package/src/business/projects/index.ts +2 -2
  57. package/src/business/projects/sse-events.ts +21 -21
  58. package/src/business/projects/types.ts +89 -89
  59. package/src/business/sales/api-schemas.ts +75 -75
  60. package/src/business/seo/__tests__/linking.test.ts +549 -549
  61. package/src/business/seo/__tests__/types.test.ts +404 -404
  62. package/src/business/seo/index.ts +2 -2
  63. package/src/business/seo/linking.ts +281 -281
  64. package/src/business/seo/types.ts +199 -199
  65. package/src/commands/queue/index.ts +3 -3
  66. package/src/commands/queue/schemas.test.ts +593 -593
  67. package/src/commands/queue/schemas.ts +125 -125
  68. package/src/commands/queue/sse-events.ts +61 -61
  69. package/src/commands/queue/types/action.ts +52 -52
  70. package/src/commands/queue/types/checkpoint.ts +44 -44
  71. package/src/commands/queue/types/index.ts +7 -7
  72. package/src/commands/queue/types/task.ts +116 -116
  73. package/src/commands/queue/types.ts +14 -14
  74. package/src/content/distribution-metadata.ts +61 -61
  75. package/src/content/index.ts +10 -10
  76. package/src/deployments/index.ts +22 -22
  77. package/src/execution/core/__tests__/archived-logs.test.ts +72 -72
  78. package/src/execution/core/index.ts +11 -11
  79. package/src/execution/core/runner-types.ts +80 -80
  80. package/src/execution/core/server/environment.ts +31 -31
  81. package/src/execution/core/sse-executions.ts +119 -119
  82. package/src/execution/core/types.ts +29 -29
  83. package/src/execution/engine/__tests__/fixtures/test-agents.ts +4 -4
  84. package/src/execution/engine/__tests__/timeout.test.ts +565 -565
  85. package/src/execution/engine/agent/__tests__/errors.test.ts +508 -508
  86. package/src/execution/engine/agent/actions/__tests__/processor.test.ts +531 -531
  87. package/src/execution/engine/agent/actions/executor.ts +205 -205
  88. package/src/execution/engine/agent/actions/navigate-knowledge-executor.ts +230 -230
  89. package/src/execution/engine/agent/actions/processor.ts +116 -116
  90. package/src/execution/engine/agent/actions/types.ts +70 -70
  91. package/src/execution/engine/agent/core/agent.ts +810 -810
  92. package/src/execution/engine/agent/core/types.ts +155 -155
  93. package/src/execution/engine/agent/errors.ts +251 -251
  94. package/src/execution/engine/agent/index.ts +78 -78
  95. package/src/execution/engine/agent/knowledge-map/types.ts +106 -106
  96. package/src/execution/engine/agent/knowledge-map/utils.ts +101 -101
  97. package/src/execution/engine/agent/memory/__tests__/manager.test.ts +754 -754
  98. package/src/execution/engine/agent/memory/domains.ts +99 -99
  99. package/src/execution/engine/agent/memory/manager.ts +365 -365
  100. package/src/execution/engine/agent/memory/processor.ts +66 -66
  101. package/src/execution/engine/agent/memory/types.ts +90 -90
  102. package/src/execution/engine/agent/memory/utils.ts +134 -134
  103. package/src/execution/engine/agent/observability/logging.ts +467 -467
  104. package/src/execution/engine/agent/observability/types.ts +64 -64
  105. package/src/execution/engine/agent/reasoning/adapters/agent-adapter-helpers.ts +349 -349
  106. package/src/execution/engine/agent/reasoning/processor.ts +92 -92
  107. package/src/execution/engine/agent/reasoning/prompt-sections/base-actions.ts +134 -134
  108. package/src/execution/engine/agent/reasoning/prompt-sections/completion.ts +49 -49
  109. package/src/execution/engine/agent/reasoning/prompt-sections/knowledge-map.ts +93 -93
  110. package/src/execution/engine/agent/reasoning/prompt-sections/memory.ts +65 -65
  111. package/src/execution/engine/agent/reasoning/prompt-sections/tools.ts +44 -44
  112. package/src/execution/engine/agent/reasoning/request-builder.ts +169 -169
  113. package/src/execution/engine/agent/reasoning/types.ts +18 -18
  114. package/src/execution/engine/base/errors.ts +118 -118
  115. package/src/execution/engine/base/index.ts +2 -2
  116. package/src/execution/engine/base/logging.ts +31 -31
  117. package/src/execution/engine/base/serialization.ts +324 -324
  118. package/src/execution/engine/base/types.ts +126 -126
  119. package/src/execution/engine/base/utils.ts +41 -41
  120. package/src/execution/engine/index.ts +434 -434
  121. package/src/execution/engine/interface/index.ts +1 -1
  122. package/src/execution/engine/interface/types.ts +62 -62
  123. package/src/execution/engine/llm/__tests__/model-info.test.ts +50 -50
  124. package/src/execution/engine/llm/__tests__/model-validation.test.ts +321 -321
  125. package/src/execution/engine/llm/__tests__/response-schema-validator.test.ts +115 -115
  126. package/src/execution/engine/llm/adapters/__tests__/adapter-factory.test.ts +375 -375
  127. package/src/execution/engine/llm/adapters/__tests__/anthropic-adapter.test.ts +463 -463
  128. package/src/execution/engine/llm/adapters/__tests__/anthropic.integration.test.ts +177 -177
  129. package/src/execution/engine/llm/adapters/__tests__/google-adapter.test.ts +722 -722
  130. package/src/execution/engine/llm/adapters/__tests__/google.integration.test.ts +376 -376
  131. package/src/execution/engine/llm/adapters/__tests__/openai-adapter.test.ts +551 -551
  132. package/src/execution/engine/llm/adapters/__tests__/openrouter-adapter.test.ts +563 -563
  133. package/src/execution/engine/llm/adapters/__tests__/openrouter.integration.test.ts +105 -105
  134. package/src/execution/engine/llm/adapters/__tests__/universal-adapter.test.ts +537 -537
  135. package/src/execution/engine/llm/adapters/circuit-breaker.ts +147 -147
  136. package/src/execution/engine/llm/adapters/index.ts +17 -17
  137. package/src/execution/engine/llm/adapters/mock-adapter.ts +116 -116
  138. package/src/execution/engine/llm/adapters/server/adapter-factory.ts +130 -130
  139. package/src/execution/engine/llm/adapters/server/anthropic.ts +137 -137
  140. package/src/execution/engine/llm/adapters/server/google.ts +283 -283
  141. package/src/execution/engine/llm/adapters/server/index.ts +12 -12
  142. package/src/execution/engine/llm/adapters/server/openai.ts +206 -206
  143. package/src/execution/engine/llm/adapters/server/openrouter.ts +235 -235
  144. package/src/execution/engine/llm/adapters/universal-adapter.ts +230 -230
  145. package/src/execution/engine/llm/errors.ts +186 -186
  146. package/src/execution/engine/llm/model-info.ts +332 -332
  147. package/src/execution/engine/llm/response-schema-validator.ts +113 -113
  148. package/src/execution/engine/llm/types.ts +86 -86
  149. package/src/execution/engine/test-utils/index.ts +6 -6
  150. package/src/execution/engine/test-utils/mocks.ts +56 -56
  151. package/src/execution/engine/tools/integration/base-integration-adapter.ts +50 -50
  152. package/src/execution/engine/tools/integration/index.ts +53 -53
  153. package/src/execution/engine/tools/integration/server/adapters/anymailfinder/anymailfinder-adapter.ts +73 -73
  154. package/src/execution/engine/tools/integration/server/adapters/anymailfinder/anymailfinder-tools.ts +209 -209
  155. package/src/execution/engine/tools/integration/server/adapters/anymailfinder/fetch/find-company-email/index.ts +82 -82
  156. package/src/execution/engine/tools/integration/server/adapters/anymailfinder/fetch/find-decision-maker-email/index.ts +122 -122
  157. package/src/execution/engine/tools/integration/server/adapters/anymailfinder/fetch/find-person-email/index.ts +89 -89
  158. package/src/execution/engine/tools/integration/server/adapters/anymailfinder/fetch/verify-email/index.ts +84 -84
  159. package/src/execution/engine/tools/integration/server/adapters/anymailfinder/index.ts +16 -16
  160. package/src/execution/engine/tools/integration/server/adapters/apify/__tests__/apify-run-actor.integration.test.ts +293 -293
  161. package/src/execution/engine/tools/integration/server/adapters/apify/apify-adapter.ts +100 -100
  162. package/src/execution/engine/tools/integration/server/adapters/apify/apify-tools.ts +217 -217
  163. package/src/execution/engine/tools/integration/server/adapters/apify/fetch/get-dataset-items/index.ts +92 -92
  164. package/src/execution/engine/tools/integration/server/adapters/apify/fetch/run-actor/index.ts +218 -218
  165. package/src/execution/engine/tools/integration/server/adapters/apify/fetch/start-actor/index.ts +87 -87
  166. package/src/execution/engine/tools/integration/server/adapters/apify/index.ts +11 -11
  167. package/src/execution/engine/tools/integration/server/adapters/attio/__tests__/attio-crud.integration.test.ts +361 -361
  168. package/src/execution/engine/tools/integration/server/adapters/attio/attio-adapter.ts +162 -162
  169. package/src/execution/engine/tools/integration/server/adapters/attio/attio-tools.ts +594 -594
  170. package/src/execution/engine/tools/integration/server/adapters/attio/fetch/create-attribute/index.ts +214 -214
  171. package/src/execution/engine/tools/integration/server/adapters/attio/fetch/create-note/index.ts +152 -152
  172. package/src/execution/engine/tools/integration/server/adapters/attio/fetch/create-record/index.ts +141 -141
  173. package/src/execution/engine/tools/integration/server/adapters/attio/fetch/delete-note/index.ts +86 -86
  174. package/src/execution/engine/tools/integration/server/adapters/attio/fetch/delete-record/index.ts +105 -105
  175. package/src/execution/engine/tools/integration/server/adapters/attio/fetch/get-record/index.ts +118 -118
  176. package/src/execution/engine/tools/integration/server/adapters/attio/fetch/list-attributes/index.ts +165 -165
  177. package/src/execution/engine/tools/integration/server/adapters/attio/fetch/list-notes/index.ts +96 -96
  178. package/src/execution/engine/tools/integration/server/adapters/attio/fetch/list-objects/index.ts +104 -104
  179. package/src/execution/engine/tools/integration/server/adapters/attio/fetch/list-records/index.ts +156 -156
  180. package/src/execution/engine/tools/integration/server/adapters/attio/fetch/update-attribute/index.ts +220 -220
  181. package/src/execution/engine/tools/integration/server/adapters/attio/fetch/update-record/index.ts +140 -140
  182. package/src/execution/engine/tools/integration/server/adapters/attio/fetch/utils/types.ts +146 -146
  183. package/src/execution/engine/tools/integration/server/adapters/attio/index.ts +31 -31
  184. package/src/execution/engine/tools/integration/server/adapters/gmail/gmail-adapter.ts +210 -210
  185. package/src/execution/engine/tools/integration/server/adapters/gmail/gmail-tools.ts +104 -104
  186. package/src/execution/engine/tools/integration/server/adapters/google-sheets/__tests__/google-sheets.integration.test.ts +261 -261
  187. package/src/execution/engine/tools/integration/server/adapters/google-sheets/google-sheets-adapter.ts +1189 -1189
  188. package/src/execution/engine/tools/integration/server/adapters/google-sheets/google-sheets-tools.ts +641 -641
  189. package/src/execution/engine/tools/integration/server/adapters/google-sheets/index.ts +18 -18
  190. package/src/execution/engine/tools/integration/server/adapters/instantly/fetch/activate-campaign/index.ts +86 -86
  191. package/src/execution/engine/tools/integration/server/adapters/instantly/fetch/add-to-campaign/__tests__/index.test.ts +289 -289
  192. package/src/execution/engine/tools/integration/server/adapters/instantly/fetch/add-to-campaign/index.ts +154 -154
  193. package/src/execution/engine/tools/integration/server/adapters/instantly/fetch/bulk-add-leads/__tests__/index.test.ts +325 -325
  194. package/src/execution/engine/tools/integration/server/adapters/instantly/fetch/bulk-add-leads/index.ts +153 -153
  195. package/src/execution/engine/tools/integration/server/adapters/instantly/fetch/bulk-delete-leads/index.ts +84 -84
  196. package/src/execution/engine/tools/integration/server/adapters/instantly/fetch/create-campaign/index.ts +125 -125
  197. package/src/execution/engine/tools/integration/server/adapters/instantly/fetch/create-inbox-test/index.ts +107 -107
  198. package/src/execution/engine/tools/integration/server/adapters/instantly/fetch/delete-campaign/index.ts +85 -85
  199. package/src/execution/engine/tools/integration/server/adapters/instantly/fetch/get-account-health/index.ts +91 -91
  200. package/src/execution/engine/tools/integration/server/adapters/instantly/fetch/get-campaign/index.ts +92 -92
  201. package/src/execution/engine/tools/integration/server/adapters/instantly/fetch/get-campaign-analytics/__tests__/index.test.ts +195 -195
  202. package/src/execution/engine/tools/integration/server/adapters/instantly/fetch/get-campaign-analytics/index.ts +113 -113
  203. package/src/execution/engine/tools/integration/server/adapters/instantly/fetch/get-daily-campaign-analytics/index.ts +104 -104
  204. package/src/execution/engine/tools/integration/server/adapters/instantly/fetch/get-emails/index.ts +155 -155
  205. package/src/execution/engine/tools/integration/server/adapters/instantly/fetch/get-step-analytics/__tests__/index.test.ts +196 -196
  206. package/src/execution/engine/tools/integration/server/adapters/instantly/fetch/get-step-analytics/index.ts +102 -102
  207. package/src/execution/engine/tools/integration/server/adapters/instantly/fetch/list-campaigns/__tests__/index.test.ts +189 -189
  208. package/src/execution/engine/tools/integration/server/adapters/instantly/fetch/list-campaigns/index.ts +87 -87
  209. package/src/execution/engine/tools/integration/server/adapters/instantly/fetch/list-leads/index.ts +112 -112
  210. package/src/execution/engine/tools/integration/server/adapters/instantly/fetch/patch-lead/index.ts +76 -76
  211. package/src/execution/engine/tools/integration/server/adapters/instantly/fetch/pause-campaign/index.ts +86 -86
  212. package/src/execution/engine/tools/integration/server/adapters/instantly/fetch/remove-from-subsequence/index.ts +98 -98
  213. package/src/execution/engine/tools/integration/server/adapters/instantly/fetch/send-reply/index.ts +126 -126
  214. package/src/execution/engine/tools/integration/server/adapters/instantly/fetch/update-campaign/__tests__/index.test.ts +193 -193
  215. package/src/execution/engine/tools/integration/server/adapters/instantly/fetch/update-campaign/index.ts +99 -99
  216. package/src/execution/engine/tools/integration/server/adapters/instantly/fetch/update-interest-status/__tests__/index.test.ts +621 -621
  217. package/src/execution/engine/tools/integration/server/adapters/instantly/fetch/update-interest-status/index.ts +125 -125
  218. package/src/execution/engine/tools/integration/server/adapters/instantly/index.ts +29 -29
  219. package/src/execution/engine/tools/integration/server/adapters/instantly/instantly-adapter.ts +178 -178
  220. package/src/execution/engine/tools/integration/server/adapters/instantly/instantly-tools.ts +1473 -1473
  221. package/src/execution/engine/tools/integration/server/adapters/millionverifier/fetch/check-credits/index.ts +59 -59
  222. package/src/execution/engine/tools/integration/server/adapters/millionverifier/fetch/verify-email/index.ts +102 -102
  223. package/src/execution/engine/tools/integration/server/adapters/millionverifier/index.ts +17 -17
  224. package/src/execution/engine/tools/integration/server/adapters/millionverifier/millionverifier-adapter.ts +80 -80
  225. package/src/execution/engine/tools/integration/server/adapters/millionverifier/millionverifier-tools.ts +102 -102
  226. package/src/execution/engine/tools/integration/server/adapters/resend/fetch/get-email/index.ts +102 -102
  227. package/src/execution/engine/tools/integration/server/adapters/resend/fetch/send-email/index.ts +134 -134
  228. package/src/execution/engine/tools/integration/server/adapters/resend/fetch/utils/types.ts +75 -75
  229. package/src/execution/engine/tools/integration/server/adapters/resend/index.ts +27 -27
  230. package/src/execution/engine/tools/integration/server/adapters/resend/resend-adapter.ts +108 -108
  231. package/src/execution/engine/tools/integration/server/adapters/resend/resend-tools.ts +132 -132
  232. package/src/execution/engine/tools/integration/server/adapters/signature-api/fetch/create-envelope/index.ts +274 -274
  233. package/src/execution/engine/tools/integration/server/adapters/signature-api/fetch/download-document/index.ts +230 -230
  234. package/src/execution/engine/tools/integration/server/adapters/signature-api/fetch/get-envelope/index.ts +133 -133
  235. package/src/execution/engine/tools/integration/server/adapters/signature-api/fetch/void-envelope/index.ts +90 -90
  236. package/src/execution/engine/tools/integration/server/adapters/stripe/fetch/utils/types.ts +210 -210
  237. package/src/execution/engine/tools/integration/server/adapters/stripe/stripe-adapter.ts +517 -517
  238. package/src/execution/engine/tools/integration/server/adapters/stripe/stripe-tools.ts +309 -309
  239. package/src/execution/engine/tools/integration/server/adapters/tomba/fetch/domain-search/index.ts +133 -133
  240. package/src/execution/engine/tools/integration/server/adapters/tomba/fetch/email-finder/index.ts +122 -122
  241. package/src/execution/engine/tools/integration/server/adapters/tomba/fetch/email-verifier/index.ts +111 -111
  242. package/src/execution/engine/tools/integration/server/adapters/tomba/index.ts +11 -11
  243. package/src/execution/engine/tools/integration/server/adapters/tomba/tomba-adapter.ts +78 -78
  244. package/src/execution/engine/tools/integration/server/adapters/tomba/tomba-tools.ts +222 -222
  245. package/src/execution/engine/tools/integration/server/index.ts +61 -61
  246. package/src/execution/engine/tools/integration/service.ts +161 -161
  247. package/src/execution/engine/tools/integration/tool.ts +253 -253
  248. package/src/execution/engine/tools/integration/types/anymailfinder.ts +74 -74
  249. package/src/execution/engine/tools/integration/types/apify.ts +92 -92
  250. package/src/execution/engine/tools/integration/types/index.ts +19 -19
  251. package/src/execution/engine/tools/integration/types/instantly.ts +557 -557
  252. package/src/execution/engine/tools/integration/types/millionverifier.ts +56 -56
  253. package/src/execution/engine/tools/integration/types/stripe.ts +162 -162
  254. package/src/execution/engine/tools/integration/types/tomba.ts +94 -94
  255. package/src/execution/engine/tools/lead-service-types.ts +884 -884
  256. package/src/execution/engine/tools/llm/index.ts +11 -11
  257. package/src/execution/engine/tools/llm/server/index.ts +8 -8
  258. package/src/execution/engine/tools/llm/server/llm-call-tool.ts +118 -118
  259. package/src/execution/engine/tools/platform/__tests__/pdf.test.ts +441 -441
  260. package/src/execution/engine/tools/platform/acquisition/company-tools.ts +248 -248
  261. package/src/execution/engine/tools/platform/acquisition/contact-tools.ts +319 -319
  262. package/src/execution/engine/tools/platform/acquisition/index.ts +43 -43
  263. package/src/execution/engine/tools/platform/acquisition/list-tools.ts +148 -148
  264. package/src/execution/engine/tools/platform/acquisition/types.ts +260 -260
  265. package/src/execution/engine/tools/platform/email/index.ts +122 -122
  266. package/src/execution/engine/tools/platform/email/types.ts +96 -96
  267. package/src/execution/engine/tools/platform/index.ts +157 -157
  268. package/src/execution/engine/tools/platform/notification.ts +81 -81
  269. package/src/execution/engine/tools/platform/pdf/index.ts +110 -110
  270. package/src/execution/engine/tools/platform/pdf/types.ts +77 -77
  271. package/src/execution/engine/tools/platform/scheduler.ts +87 -87
  272. package/src/execution/engine/tools/platform/storage/index.ts +370 -370
  273. package/src/execution/engine/tools/platform/types.ts +148 -148
  274. package/src/execution/engine/tools/registry.ts +700 -700
  275. package/src/execution/engine/tools/tool-maps.ts +786 -786
  276. package/src/execution/engine/tools/types.ts +233 -233
  277. package/src/execution/engine/workflow/__tests__/errors.test.ts +139 -139
  278. package/src/execution/engine/workflow/errors.ts +63 -63
  279. package/src/execution/engine/workflow/helpers/index.ts +11 -11
  280. package/src/execution/engine/workflow/helpers/server/index.ts +8 -8
  281. package/src/execution/engine/workflow/helpers/server/llm-call.ts +93 -93
  282. package/src/execution/engine/workflow/index.ts +19 -19
  283. package/src/execution/engine/workflow/log-truncate.ts +26 -26
  284. package/src/execution/engine/workflow/logging.ts +191 -191
  285. package/src/execution/engine/workflow/types.ts +182 -182
  286. package/src/execution/engine/workflow/utils.ts +280 -280
  287. package/src/execution/engine/workflow/workflow.ts +168 -168
  288. package/src/execution/index.ts +3 -3
  289. package/src/execution/scheduler/__tests__/api-schemas.test.ts +733 -733
  290. package/src/execution/scheduler/__tests__/utils.test.ts +1009 -1009
  291. package/src/execution/scheduler/api-schemas.ts +296 -296
  292. package/src/execution/scheduler/index.ts +50 -50
  293. package/src/execution/scheduler/schemas.ts +264 -264
  294. package/src/execution/scheduler/types.ts +111 -111
  295. package/src/execution/scheduler/utils.ts +364 -364
  296. package/src/forms/index.ts +7 -7
  297. package/src/forms/schemas.ts +69 -69
  298. package/src/forms/types.ts +70 -70
  299. package/src/index.ts +71 -60
  300. package/src/integrations/credentials/__tests__/schemas.test.ts +82 -82
  301. package/src/integrations/credentials/__tests__/utils.test.ts +144 -144
  302. package/src/integrations/credentials/api-schemas.ts +143 -143
  303. package/src/integrations/credentials/index.ts +32 -32
  304. package/src/integrations/credentials/schemas.ts +164 -164
  305. package/src/integrations/credentials/utils.ts +59 -59
  306. package/src/integrations/oauth/__tests__/provider-registry.test.ts +59 -59
  307. package/src/integrations/oauth/api-schemas.ts +92 -92
  308. package/src/integrations/oauth/index.ts +19 -19
  309. package/src/integrations/oauth/provider-registry.ts +61 -61
  310. package/src/integrations/oauth/server/__tests__/refresh-concurrent.test.ts +183 -183
  311. package/src/integrations/oauth/server/__tests__/refresh.test.ts +577 -577
  312. package/src/integrations/oauth/server/credentials.ts +39 -39
  313. package/src/integrations/oauth/server/refresh.ts +214 -214
  314. package/src/integrations/oauth/types.ts +34 -34
  315. package/src/integrations/webhook-endpoints/__tests__/api-schemas.test.ts +318 -318
  316. package/src/integrations/webhook-endpoints/api-schemas.ts +102 -102
  317. package/src/integrations/webhook-endpoints/index.ts +28 -28
  318. package/src/integrations/webhook-endpoints/types.ts +51 -51
  319. package/src/operations/activities/api-schemas.ts +79 -79
  320. package/src/operations/activities/index.ts +9 -9
  321. package/src/operations/activities/sse-events.ts +30 -30
  322. package/src/operations/activities/types.ts +63 -63
  323. package/src/operations/debug-logs/client.ts +60 -60
  324. package/src/operations/debug-logs/debug-logger.ts +83 -83
  325. package/src/operations/debug-logs/index.ts +8 -8
  326. package/src/operations/debug-logs/server.ts +19 -19
  327. package/src/operations/debug-logs/types.ts +33 -33
  328. package/src/operations/index.ts +50 -50
  329. package/src/operations/notifications/api-schemas.ts +91 -91
  330. package/src/operations/notifications/index.ts +3 -3
  331. package/src/operations/notifications/sse-events.ts +21 -21
  332. package/src/operations/notifications/types.ts +47 -47
  333. package/src/operations/observability/__tests__/openrouter-cost-flow.test.ts +297 -297
  334. package/src/operations/observability/__tests__/utils.test.ts +54 -54
  335. package/src/operations/observability/ai-usage-collector.ts +64 -64
  336. package/src/operations/observability/index.ts +13 -13
  337. package/src/operations/observability/metrics-collector.ts +49 -49
  338. package/src/operations/observability/schemas.ts +39 -39
  339. package/src/operations/observability/types.ts +463 -463
  340. package/src/operations/observability/utils.ts +77 -77
  341. package/src/operations/sessions/__tests__/manager.test.ts +821 -821
  342. package/src/operations/sessions/index.ts +26 -26
  343. package/src/operations/sessions/server/manager.ts +90 -90
  344. package/src/operations/sessions/server/session.ts +180 -180
  345. package/src/operations/sessions/types.ts +98 -98
  346. package/src/operations/triggers/index.ts +12 -12
  347. package/src/operations/triggers/webhook/definitions/instantly-account-error.ts +44 -44
  348. package/src/operations/triggers/webhook/definitions/instantly-auto-reply-received.ts +51 -51
  349. package/src/operations/triggers/webhook/definitions/instantly-campaign-completed.ts +45 -45
  350. package/src/operations/triggers/webhook/definitions/instantly-email-bounced.ts +49 -49
  351. package/src/operations/triggers/webhook/definitions/instantly-lead-unsubscribed.ts +45 -45
  352. package/src/operations/triggers/webhook/definitions/instantly-reply-received.ts +54 -54
  353. package/src/operations/triggers/webhook/index.ts +35 -35
  354. package/src/operations/triggers/webhook/types.ts +74 -74
  355. package/src/organization-model/README.md +97 -97
  356. package/src/organization-model/__tests__/defaults.test.ts +175 -175
  357. package/src/organization-model/__tests__/domains/customers.test.ts +295 -295
  358. package/src/organization-model/__tests__/domains/goals.test.ts +479 -479
  359. package/src/organization-model/__tests__/domains/identity.test.ts +279 -279
  360. package/src/organization-model/__tests__/domains/navigation.test.ts +212 -212
  361. package/src/organization-model/__tests__/domains/offerings.test.ts +419 -419
  362. package/src/organization-model/__tests__/domains/operations.test.ts +203 -203
  363. package/src/organization-model/__tests__/domains/resource-mappings.test.ts +362 -362
  364. package/src/organization-model/__tests__/domains/roles.test.ts +347 -347
  365. package/src/organization-model/__tests__/domains/statuses.test.ts +243 -243
  366. package/src/organization-model/__tests__/foundation.test.ts +105 -105
  367. package/src/organization-model/__tests__/graph.test.ts +894 -894
  368. package/src/organization-model/__tests__/resolve.test.ts +690 -690
  369. package/src/organization-model/__tests__/schema.test.ts +407 -407
  370. package/src/organization-model/contracts.ts +14 -14
  371. package/src/organization-model/defaults.ts +148 -148
  372. package/src/organization-model/domains/branding.ts +22 -22
  373. package/src/organization-model/domains/customers.ts +75 -75
  374. package/src/organization-model/domains/features.ts +22 -22
  375. package/src/organization-model/domains/goals.ts +80 -80
  376. package/src/organization-model/domains/identity.ts +94 -94
  377. package/src/organization-model/domains/navigation.ts +391 -391
  378. package/src/organization-model/domains/offerings.ts +66 -66
  379. package/src/organization-model/domains/operations.ts +85 -85
  380. package/src/organization-model/domains/projects.ts +48 -48
  381. package/src/organization-model/domains/prospecting.ts +33 -33
  382. package/src/organization-model/domains/roles.ts +55 -55
  383. package/src/organization-model/domains/sales.ts +94 -94
  384. package/src/organization-model/domains/shared.ts +62 -62
  385. package/src/organization-model/domains/statuses.ts +130 -130
  386. package/src/organization-model/foundation.ts +97 -97
  387. package/src/organization-model/graph/build.ts +399 -399
  388. package/src/organization-model/graph/index.ts +4 -4
  389. package/src/organization-model/graph/schema.ts +48 -48
  390. package/src/organization-model/graph/types.ts +40 -40
  391. package/src/organization-model/index.ts +13 -13
  392. package/src/organization-model/organization-graph.mdx +272 -272
  393. package/src/organization-model/organization-model.mdx +320 -320
  394. package/src/organization-model/published.ts +85 -85
  395. package/src/organization-model/resolve.ts +66 -66
  396. package/src/organization-model/schema.ts +287 -287
  397. package/src/organization-model/types.ts +46 -46
  398. package/src/platform/api/index.ts +1 -1
  399. package/src/platform/api/types.ts +35 -35
  400. package/src/platform/constants/http.ts +37 -37
  401. package/src/platform/constants/index.ts +5 -5
  402. package/src/platform/constants/limits.ts +32 -32
  403. package/src/platform/constants/resilience.ts +51 -51
  404. package/src/platform/constants/timeouts.ts +20 -20
  405. package/src/platform/constants/versions.ts +3 -3
  406. package/src/platform/registry/__tests__/resource-registry-static.test.ts +347 -347
  407. package/src/platform/registry/__tests__/resource-registry.integration.test.ts +1028 -1028
  408. package/src/platform/registry/__tests__/resource-registry.list-executable.test.ts +393 -393
  409. package/src/platform/registry/__tests__/resource-registry.test.ts +2005 -2005
  410. package/src/platform/registry/__tests__/serialization.test.ts +1127 -1127
  411. package/src/platform/registry/command-view.ts +180 -180
  412. package/src/platform/registry/domains.ts +165 -165
  413. package/src/platform/registry/index.ts +93 -93
  414. package/src/platform/registry/reserved.ts +24 -24
  415. package/src/platform/registry/resource-metadata.ts +59 -59
  416. package/src/platform/registry/resource-registry.command-queue-groups.test.ts +129 -129
  417. package/src/platform/registry/resource-registry.ts +876 -876
  418. package/src/platform/registry/serialization.ts +273 -273
  419. package/src/platform/registry/serialized-types.ts +231 -231
  420. package/src/platform/registry/stats-types.ts +66 -66
  421. package/src/platform/registry/types.ts +404 -404
  422. package/src/platform/registry/validation.ts +513 -513
  423. package/src/platform/resilience/__tests__/rate-limiter.test.ts +471 -471
  424. package/src/platform/resilience/circuit-breaker.ts +164 -164
  425. package/src/platform/resilience/errors.ts +68 -68
  426. package/src/platform/resilience/http-error-mapper.ts +129 -129
  427. package/src/platform/resilience/index.ts +93 -93
  428. package/src/platform/resilience/rate-limiter-types.ts +46 -46
  429. package/src/platform/resilience/rate-limiter.ts +140 -140
  430. package/src/platform/resilience/retry.ts +89 -89
  431. package/src/platform/resilience/timeout.ts +63 -63
  432. package/src/platform/sse/events.ts +37 -37
  433. package/src/platform/sse/index.ts +7 -7
  434. package/src/platform/utils/__tests__/validation.test.ts +1083 -1083
  435. package/src/platform/utils/currency.ts +96 -96
  436. package/src/platform/utils/debounce.ts +52 -52
  437. package/src/platform/utils/error.ts +41 -41
  438. package/src/platform/utils/hmac.test.ts +97 -97
  439. package/src/platform/utils/index.ts +32 -32
  440. package/src/platform/utils/server/betterstack-logger.ts +210 -210
  441. package/src/platform/utils/server/hmac.ts +44 -44
  442. package/src/platform/utils/server/unsubscribe.ts +111 -111
  443. package/src/platform/utils/token-counter.ts +96 -96
  444. package/src/platform/utils/validation.ts +425 -425
  445. package/src/projects/api-schemas.ts +268 -268
  446. package/src/published.ts +1 -1
  447. package/src/reference/_generated/contracts.md +607 -607
  448. package/src/reference/glossary.md +105 -105
  449. package/src/requests/__tests__/api-schemas.test.ts +277 -277
  450. package/src/requests/api-schemas.ts +83 -83
  451. package/src/requests/index.ts +1 -1
  452. package/src/scaffold-registry/__tests__/index.test.ts +17 -0
  453. package/src/scaffold-registry/__tests__/schema.test.ts +329 -230
  454. package/src/scaffold-registry/index.ts +205 -189
  455. package/src/scaffold-registry/schema.ts +196 -128
  456. package/src/server.ts +272 -272
  457. package/src/supabase/database.types.ts +2719 -2719
  458. package/src/supabase/helpers.ts +20 -20
  459. package/src/supabase/index.ts +52 -52
  460. package/src/supabase/server/client.ts +58 -58
  461. package/src/test-utils/README.md +38 -38
  462. package/src/test-utils/browser-mocks.ts +54 -54
  463. package/src/test-utils/fixtures/api-keys.ts +52 -52
  464. package/src/test-utils/fixtures/index.ts +4 -4
  465. package/src/test-utils/fixtures/memberships.ts +80 -80
  466. package/src/test-utils/fixtures/organizations.ts +69 -69
  467. package/src/test-utils/fixtures/users.ts +79 -79
  468. package/src/test-utils/index.ts +11 -11
  469. package/src/test-utils/mocks/index.ts +2 -2
  470. package/src/test-utils/mocks/supabase.ts +142 -142
  471. package/src/test-utils/mocks/workos.ts +108 -108
  472. package/src/test-utils/rls/RLSTestContext.ts +556 -556
  473. package/src/test-utils/rls/index.ts +1 -1
@@ -1,133 +1,133 @@
1
- import { withRetry, createHttpError, DEFAULT_RETRY_POLICY } from '../../../../../../../../../platform/resilience'
2
- import type { ExecutionContext } from '../../../../../../../base/types'
3
-
4
- interface TombaCredentials {
5
- apiKey: string
6
- apiSecret: string
7
- }
8
-
9
- export interface DomainSearchParams {
10
- domain: string
11
- limit?: number
12
- department?: string
13
- type?: 'personal' | 'generic'
14
- }
15
-
16
- export interface DomainSearchEmail {
17
- email: string
18
- firstName: string
19
- lastName: string
20
- fullName: string
21
- position: string
22
- department: string
23
- verificationDate: string
24
- verificationStatus: string
25
- sources: Array<{
26
- uri: string
27
- extractedOn: string
28
- lastSeenOn: string
29
- stillOnPage: boolean
30
- }>
31
- }
32
-
33
- export interface DomainSearchResult {
34
- organizationName: string
35
- domain: string
36
- emails: DomainSearchEmail[]
37
- }
38
-
39
- const TOMBA_API_BASE = 'https://api.tomba.io/v1'
40
-
41
- /**
42
- * Find all email addresses at a company domain via Tomba
43
- *
44
- * Searches for all known email addresses at the given domain. Optionally filter
45
- * by department. Returns enriched data per email including position and
46
- * verification status.
47
- *
48
- * @param credentials - Tomba API key and secret
49
- * @param params - Domain, optional limit, and optional department filter
50
- * @param context - Execution context for logging
51
- * @returns Organization name, domain, and list of found email records
52
- */
53
- export async function domainSearch(
54
- credentials: TombaCredentials,
55
- params: DomainSearchParams,
56
- context?: ExecutionContext
57
- ): Promise<DomainSearchResult> {
58
- const { apiKey, apiSecret } = credentials
59
- const { domain, limit, department, type } = params
60
-
61
- if (!domain) {
62
- throw new Error('domain is required for domainSearch')
63
- }
64
-
65
- if (context?.logger) {
66
- context.logger.info(
67
- `[TombaAdapter] domainSearch: domain=${domain} limit=${limit} department=${department} type=${type} organizationId=${context.organizationId} executionId=${context.executionId}`
68
- )
69
- }
70
-
71
- const url = new URL(`${TOMBA_API_BASE}/domain-search`)
72
- url.searchParams.set('domain', domain)
73
- if (limit !== undefined) {
74
- url.searchParams.set('limit', String(limit))
75
- }
76
- if (department) {
77
- url.searchParams.set('department', department)
78
- }
79
- if (type) {
80
- url.searchParams.set('type', type)
81
- }
82
-
83
- const response = await withRetry(async () => {
84
- const res = await fetch(url.toString(), {
85
- method: 'GET',
86
- headers: {
87
- 'X-Tomba-Key': apiKey,
88
- 'X-Tomba-Secret': apiSecret
89
- },
90
- signal: AbortSignal.timeout(60_000)
91
- })
92
-
93
- if (!res.ok) {
94
- throw await createHttpError(res, {
95
- integration: 'tomba',
96
- method: 'domainSearch',
97
- organizationId: context?.organizationId
98
- })
99
- }
100
-
101
- return res.json()
102
- }, DEFAULT_RETRY_POLICY)
103
-
104
- const data = response.data ?? {}
105
- const rawEmails: Array<Record<string, unknown>> = data.emails ?? []
106
-
107
- if (context?.logger) {
108
- context.logger.info(
109
- `[TombaAdapter] domainSearch complete: domain=${domain} emailCount=${rawEmails.length} organizationId=${context.organizationId}`
110
- )
111
- }
112
-
113
- return {
114
- organizationName: data.organization_name ?? '',
115
- domain: data.domain ?? domain,
116
- emails: rawEmails.map((e) => ({
117
- email: (e.email as string) ?? '',
118
- firstName: (e.first_name as string) ?? '',
119
- lastName: (e.last_name as string) ?? '',
120
- fullName: (e.full_name as string) ?? '',
121
- position: (e.position as string) ?? '',
122
- department: (e.department as string) ?? '',
123
- verificationDate: ((e.verification as Record<string, unknown>)?.date as string) ?? '',
124
- verificationStatus: ((e.verification as Record<string, unknown>)?.status as string) ?? '',
125
- sources: ((e.sources as Array<Record<string, unknown>>) ?? []).map((s) => ({
126
- uri: (s.uri as string) ?? '',
127
- extractedOn: (s.extracted_on as string) ?? '',
128
- lastSeenOn: (s.last_seen_on as string) ?? '',
129
- stillOnPage: (s.still_on_page as boolean) ?? false
130
- }))
131
- }))
132
- }
133
- }
1
+ import { withRetry, createHttpError, DEFAULT_RETRY_POLICY } from '../../../../../../../../../platform/resilience'
2
+ import type { ExecutionContext } from '../../../../../../../base/types'
3
+
4
+ interface TombaCredentials {
5
+ apiKey: string
6
+ apiSecret: string
7
+ }
8
+
9
+ export interface DomainSearchParams {
10
+ domain: string
11
+ limit?: number
12
+ department?: string
13
+ type?: 'personal' | 'generic'
14
+ }
15
+
16
+ export interface DomainSearchEmail {
17
+ email: string
18
+ firstName: string
19
+ lastName: string
20
+ fullName: string
21
+ position: string
22
+ department: string
23
+ verificationDate: string
24
+ verificationStatus: string
25
+ sources: Array<{
26
+ uri: string
27
+ extractedOn: string
28
+ lastSeenOn: string
29
+ stillOnPage: boolean
30
+ }>
31
+ }
32
+
33
+ export interface DomainSearchResult {
34
+ organizationName: string
35
+ domain: string
36
+ emails: DomainSearchEmail[]
37
+ }
38
+
39
+ const TOMBA_API_BASE = 'https://api.tomba.io/v1'
40
+
41
+ /**
42
+ * Find all email addresses at a company domain via Tomba
43
+ *
44
+ * Searches for all known email addresses at the given domain. Optionally filter
45
+ * by department. Returns enriched data per email including position and
46
+ * verification status.
47
+ *
48
+ * @param credentials - Tomba API key and secret
49
+ * @param params - Domain, optional limit, and optional department filter
50
+ * @param context - Execution context for logging
51
+ * @returns Organization name, domain, and list of found email records
52
+ */
53
+ export async function domainSearch(
54
+ credentials: TombaCredentials,
55
+ params: DomainSearchParams,
56
+ context?: ExecutionContext
57
+ ): Promise<DomainSearchResult> {
58
+ const { apiKey, apiSecret } = credentials
59
+ const { domain, limit, department, type } = params
60
+
61
+ if (!domain) {
62
+ throw new Error('domain is required for domainSearch')
63
+ }
64
+
65
+ if (context?.logger) {
66
+ context.logger.info(
67
+ `[TombaAdapter] domainSearch: domain=${domain} limit=${limit} department=${department} type=${type} organizationId=${context.organizationId} executionId=${context.executionId}`
68
+ )
69
+ }
70
+
71
+ const url = new URL(`${TOMBA_API_BASE}/domain-search`)
72
+ url.searchParams.set('domain', domain)
73
+ if (limit !== undefined) {
74
+ url.searchParams.set('limit', String(limit))
75
+ }
76
+ if (department) {
77
+ url.searchParams.set('department', department)
78
+ }
79
+ if (type) {
80
+ url.searchParams.set('type', type)
81
+ }
82
+
83
+ const response = await withRetry(async () => {
84
+ const res = await fetch(url.toString(), {
85
+ method: 'GET',
86
+ headers: {
87
+ 'X-Tomba-Key': apiKey,
88
+ 'X-Tomba-Secret': apiSecret
89
+ },
90
+ signal: AbortSignal.timeout(60_000)
91
+ })
92
+
93
+ if (!res.ok) {
94
+ throw await createHttpError(res, {
95
+ integration: 'tomba',
96
+ method: 'domainSearch',
97
+ organizationId: context?.organizationId
98
+ })
99
+ }
100
+
101
+ return res.json()
102
+ }, DEFAULT_RETRY_POLICY)
103
+
104
+ const data = response.data ?? {}
105
+ const rawEmails: Array<Record<string, unknown>> = data.emails ?? []
106
+
107
+ if (context?.logger) {
108
+ context.logger.info(
109
+ `[TombaAdapter] domainSearch complete: domain=${domain} emailCount=${rawEmails.length} organizationId=${context.organizationId}`
110
+ )
111
+ }
112
+
113
+ return {
114
+ organizationName: data.organization_name ?? '',
115
+ domain: data.domain ?? domain,
116
+ emails: rawEmails.map((e) => ({
117
+ email: (e.email as string) ?? '',
118
+ firstName: (e.first_name as string) ?? '',
119
+ lastName: (e.last_name as string) ?? '',
120
+ fullName: (e.full_name as string) ?? '',
121
+ position: (e.position as string) ?? '',
122
+ department: (e.department as string) ?? '',
123
+ verificationDate: ((e.verification as Record<string, unknown>)?.date as string) ?? '',
124
+ verificationStatus: ((e.verification as Record<string, unknown>)?.status as string) ?? '',
125
+ sources: ((e.sources as Array<Record<string, unknown>>) ?? []).map((s) => ({
126
+ uri: (s.uri as string) ?? '',
127
+ extractedOn: (s.extracted_on as string) ?? '',
128
+ lastSeenOn: (s.last_seen_on as string) ?? '',
129
+ stillOnPage: (s.still_on_page as boolean) ?? false
130
+ }))
131
+ }))
132
+ }
133
+ }
@@ -1,122 +1,122 @@
1
- import { withRetry, createHttpError, DEFAULT_RETRY_POLICY } from '../../../../../../../../../platform/resilience'
2
- import type { ExecutionContext } from '../../../../../../../base/types'
3
-
4
- interface TombaCredentials {
5
- apiKey: string
6
- apiSecret: string
7
- }
8
-
9
- export interface EmailFinderParams {
10
- domain: string
11
- firstName: string
12
- lastName: string
13
- }
14
-
15
- export interface EmailFinderResult {
16
- email: string
17
- firstName: string
18
- lastName: string
19
- fullName: string
20
- position: string
21
- company: string
22
- country: string
23
- score: number
24
- verificationDate: string
25
- verificationStatus: string
26
- sources: Array<{
27
- uri: string
28
- extractedOn: string
29
- lastSeenOn: string
30
- stillOnPage: boolean
31
- }>
32
- }
33
-
34
- const TOMBA_API_BASE = 'https://api.tomba.io/v1'
35
-
36
- /**
37
- * Find a person's email address via Tomba
38
- *
39
- * Searches for a specific person's email by combining their first/last name
40
- * with a company domain. Returns enriched data including position, score, and
41
- * verification status.
42
- *
43
- * @param credentials - Tomba API key and secret
44
- * @param params - Domain, first name, and last name
45
- * @param context - Execution context for logging
46
- * @returns Email address with enrichment data and verification status
47
- */
48
- export async function emailFinder(
49
- credentials: TombaCredentials,
50
- params: EmailFinderParams,
51
- context?: ExecutionContext
52
- ): Promise<EmailFinderResult> {
53
- const { apiKey, apiSecret } = credentials
54
- const { domain, firstName, lastName } = params
55
-
56
- if (!domain) {
57
- throw new Error('domain is required for emailFinder')
58
- }
59
-
60
- if (!firstName || !lastName) {
61
- throw new Error('firstName and lastName are required for emailFinder')
62
- }
63
-
64
- if (context?.logger) {
65
- context.logger.info(
66
- `[TombaAdapter] emailFinder: domain=${domain} firstName=${firstName} lastName=${lastName} organizationId=${context.organizationId} executionId=${context.executionId}`
67
- )
68
- }
69
-
70
- const url = new URL(`${TOMBA_API_BASE}/email-finder`)
71
- url.searchParams.set('domain', domain)
72
- url.searchParams.set('first_name', firstName)
73
- url.searchParams.set('last_name', lastName)
74
-
75
- const response = await withRetry(async () => {
76
- const res = await fetch(url.toString(), {
77
- method: 'GET',
78
- headers: {
79
- 'X-Tomba-Key': apiKey,
80
- 'X-Tomba-Secret': apiSecret
81
- },
82
- signal: AbortSignal.timeout(60_000)
83
- })
84
-
85
- if (!res.ok) {
86
- throw await createHttpError(res, {
87
- integration: 'tomba',
88
- method: 'emailFinder',
89
- organizationId: context?.organizationId
90
- })
91
- }
92
-
93
- return res.json()
94
- }, DEFAULT_RETRY_POLICY)
95
-
96
- const data = response.data ?? {}
97
-
98
- if (context?.logger) {
99
- context.logger.info(
100
- `[TombaAdapter] emailFinder complete: email=${data.email ? '[found]' : '[not found]'} score=${data.score ?? 0} organizationId=${context.organizationId}`
101
- )
102
- }
103
-
104
- return {
105
- email: data.email ?? '',
106
- firstName: data.first_name ?? '',
107
- lastName: data.last_name ?? '',
108
- fullName: data.full_name ?? '',
109
- position: data.position ?? '',
110
- company: data.company ?? '',
111
- country: data.country ?? '',
112
- score: data.score ?? 0,
113
- verificationDate: data.verification?.date ?? '',
114
- verificationStatus: data.verification?.status ?? '',
115
- sources: (data.sources ?? []).map((s: Record<string, unknown>) => ({
116
- uri: s.uri ?? '',
117
- extractedOn: s.extracted_on ?? '',
118
- lastSeenOn: s.last_seen_on ?? '',
119
- stillOnPage: s.still_on_page ?? false
120
- }))
121
- }
122
- }
1
+ import { withRetry, createHttpError, DEFAULT_RETRY_POLICY } from '../../../../../../../../../platform/resilience'
2
+ import type { ExecutionContext } from '../../../../../../../base/types'
3
+
4
+ interface TombaCredentials {
5
+ apiKey: string
6
+ apiSecret: string
7
+ }
8
+
9
+ export interface EmailFinderParams {
10
+ domain: string
11
+ firstName: string
12
+ lastName: string
13
+ }
14
+
15
+ export interface EmailFinderResult {
16
+ email: string
17
+ firstName: string
18
+ lastName: string
19
+ fullName: string
20
+ position: string
21
+ company: string
22
+ country: string
23
+ score: number
24
+ verificationDate: string
25
+ verificationStatus: string
26
+ sources: Array<{
27
+ uri: string
28
+ extractedOn: string
29
+ lastSeenOn: string
30
+ stillOnPage: boolean
31
+ }>
32
+ }
33
+
34
+ const TOMBA_API_BASE = 'https://api.tomba.io/v1'
35
+
36
+ /**
37
+ * Find a person's email address via Tomba
38
+ *
39
+ * Searches for a specific person's email by combining their first/last name
40
+ * with a company domain. Returns enriched data including position, score, and
41
+ * verification status.
42
+ *
43
+ * @param credentials - Tomba API key and secret
44
+ * @param params - Domain, first name, and last name
45
+ * @param context - Execution context for logging
46
+ * @returns Email address with enrichment data and verification status
47
+ */
48
+ export async function emailFinder(
49
+ credentials: TombaCredentials,
50
+ params: EmailFinderParams,
51
+ context?: ExecutionContext
52
+ ): Promise<EmailFinderResult> {
53
+ const { apiKey, apiSecret } = credentials
54
+ const { domain, firstName, lastName } = params
55
+
56
+ if (!domain) {
57
+ throw new Error('domain is required for emailFinder')
58
+ }
59
+
60
+ if (!firstName || !lastName) {
61
+ throw new Error('firstName and lastName are required for emailFinder')
62
+ }
63
+
64
+ if (context?.logger) {
65
+ context.logger.info(
66
+ `[TombaAdapter] emailFinder: domain=${domain} firstName=${firstName} lastName=${lastName} organizationId=${context.organizationId} executionId=${context.executionId}`
67
+ )
68
+ }
69
+
70
+ const url = new URL(`${TOMBA_API_BASE}/email-finder`)
71
+ url.searchParams.set('domain', domain)
72
+ url.searchParams.set('first_name', firstName)
73
+ url.searchParams.set('last_name', lastName)
74
+
75
+ const response = await withRetry(async () => {
76
+ const res = await fetch(url.toString(), {
77
+ method: 'GET',
78
+ headers: {
79
+ 'X-Tomba-Key': apiKey,
80
+ 'X-Tomba-Secret': apiSecret
81
+ },
82
+ signal: AbortSignal.timeout(60_000)
83
+ })
84
+
85
+ if (!res.ok) {
86
+ throw await createHttpError(res, {
87
+ integration: 'tomba',
88
+ method: 'emailFinder',
89
+ organizationId: context?.organizationId
90
+ })
91
+ }
92
+
93
+ return res.json()
94
+ }, DEFAULT_RETRY_POLICY)
95
+
96
+ const data = response.data ?? {}
97
+
98
+ if (context?.logger) {
99
+ context.logger.info(
100
+ `[TombaAdapter] emailFinder complete: email=${data.email ? '[found]' : '[not found]'} score=${data.score ?? 0} organizationId=${context.organizationId}`
101
+ )
102
+ }
103
+
104
+ return {
105
+ email: data.email ?? '',
106
+ firstName: data.first_name ?? '',
107
+ lastName: data.last_name ?? '',
108
+ fullName: data.full_name ?? '',
109
+ position: data.position ?? '',
110
+ company: data.company ?? '',
111
+ country: data.country ?? '',
112
+ score: data.score ?? 0,
113
+ verificationDate: data.verification?.date ?? '',
114
+ verificationStatus: data.verification?.status ?? '',
115
+ sources: (data.sources ?? []).map((s: Record<string, unknown>) => ({
116
+ uri: s.uri ?? '',
117
+ extractedOn: s.extracted_on ?? '',
118
+ lastSeenOn: s.last_seen_on ?? '',
119
+ stillOnPage: s.still_on_page ?? false
120
+ }))
121
+ }
122
+ }