@hogsend/engine 0.67.0 → 0.68.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 (738) hide show
  1. package/README.md +3 -2
  2. package/dist/account-links/__fixtures__/fake-fetch.d.ts +38 -0
  3. package/dist/account-links/__fixtures__/fake-fetch.d.ts.map +1 -0
  4. package/dist/account-links/battlenet.d.ts +36 -0
  5. package/dist/account-links/battlenet.d.ts.map +1 -0
  6. package/dist/account-links/epic.d.ts +36 -0
  7. package/dist/account-links/epic.d.ts.map +1 -0
  8. package/dist/account-links/index.d.ts +7 -0
  9. package/dist/account-links/index.d.ts.map +1 -0
  10. package/dist/account-links/riot.d.ts +35 -0
  11. package/dist/account-links/riot.d.ts.map +1 -0
  12. package/dist/account-links/steam.d.ts +35 -0
  13. package/dist/account-links/steam.d.ts.map +1 -0
  14. package/dist/account-links/twitch.d.ts +38 -0
  15. package/dist/account-links/twitch.d.ts.map +1 -0
  16. package/dist/account-links/xbox.d.ts +39 -0
  17. package/dist/account-links/xbox.d.ts.map +1 -0
  18. package/dist/app.d.ts +50 -0
  19. package/dist/app.d.ts.map +1 -0
  20. package/dist/buckets/bucket-access.d.ts +60 -0
  21. package/dist/buckets/bucket-access.d.ts.map +1 -0
  22. package/dist/buckets/bucket-reactions.d.ts +100 -0
  23. package/dist/buckets/bucket-reactions.d.ts.map +1 -0
  24. package/dist/buckets/check-membership.d.ts +105 -0
  25. package/dist/buckets/check-membership.d.ts.map +1 -0
  26. package/dist/buckets/define-bucket.d.ts +53 -0
  27. package/dist/buckets/define-bucket.d.ts.map +1 -0
  28. package/dist/buckets/membership-epoch.d.ts +74 -0
  29. package/dist/buckets/membership-epoch.d.ts.map +1 -0
  30. package/dist/buckets/registry-singleton.d.ts +6 -0
  31. package/dist/buckets/registry-singleton.d.ts.map +1 -0
  32. package/dist/buckets/registry.d.ts +59 -0
  33. package/dist/buckets/registry.d.ts.map +1 -0
  34. package/dist/campaigns/cohort-sql.d.ts +54 -0
  35. package/dist/campaigns/cohort-sql.d.ts.map +1 -0
  36. package/dist/campaigns/define-campaign.d.ts +105 -0
  37. package/dist/campaigns/define-campaign.d.ts.map +1 -0
  38. package/dist/campaigns/reconcile.d.ts +13 -0
  39. package/dist/campaigns/reconcile.d.ts.map +1 -0
  40. package/dist/campaigns/steps.d.ts +29 -0
  41. package/dist/campaigns/steps.d.ts.map +1 -0
  42. package/dist/cold-connect/index.d.ts +98 -0
  43. package/dist/cold-connect/index.d.ts.map +1 -0
  44. package/dist/cold-connect/page.d.ts +69 -0
  45. package/dist/cold-connect/page.d.ts.map +1 -0
  46. package/dist/cold-connect/throttle.d.ts +39 -0
  47. package/dist/cold-connect/throttle.d.ts.map +1 -0
  48. package/dist/cold-connect/token.d.ts +57 -0
  49. package/dist/cold-connect/token.d.ts.map +1 -0
  50. package/dist/connectors/action-registry-singleton.d.ts +21 -0
  51. package/dist/connectors/action-registry-singleton.d.ts.map +1 -0
  52. package/dist/connectors/define-action.d.ts +117 -0
  53. package/dist/connectors/define-action.d.ts.map +1 -0
  54. package/dist/connectors/define-connector.d.ts +172 -0
  55. package/dist/connectors/define-connector.d.ts.map +1 -0
  56. package/dist/connectors/presets/index.d.ts +17 -0
  57. package/dist/connectors/presets/index.d.ts.map +1 -0
  58. package/dist/connectors/registry-singleton.d.ts +34 -0
  59. package/dist/connectors/registry-singleton.d.ts.map +1 -0
  60. package/dist/connectors/runtime.d.ts +68 -0
  61. package/dist/connectors/runtime.d.ts.map +1 -0
  62. package/dist/container.d.ts +678 -0
  63. package/dist/container.d.ts.map +1 -0
  64. package/dist/destinations/define-destination.d.ts +96 -0
  65. package/dist/destinations/define-destination.d.ts.map +1 -0
  66. package/dist/destinations/presets/index.d.ts +42 -0
  67. package/dist/destinations/presets/index.d.ts.map +1 -0
  68. package/dist/destinations/presets/posthog.d.ts +12 -0
  69. package/dist/destinations/presets/posthog.d.ts.map +1 -0
  70. package/dist/destinations/presets/segment.d.ts +15 -0
  71. package/dist/destinations/presets/segment.d.ts.map +1 -0
  72. package/dist/destinations/presets/slack.d.ts +10 -0
  73. package/dist/destinations/presets/slack.d.ts.map +1 -0
  74. package/dist/destinations/presets/webhook.d.ts +14 -0
  75. package/dist/destinations/presets/webhook.d.ts.map +1 -0
  76. package/dist/destinations/registry-singleton.d.ts +44 -0
  77. package/dist/destinations/registry-singleton.d.ts.map +1 -0
  78. package/dist/env.d.ts +119 -0
  79. package/dist/env.d.ts.map +1 -0
  80. package/dist/flags/reconcile.d.ts +36 -0
  81. package/dist/flags/reconcile.d.ts.map +1 -0
  82. package/dist/index.d.ts +210 -0
  83. package/dist/index.d.ts.map +1 -0
  84. package/dist/journeys/authoring.d.ts +15 -0
  85. package/dist/journeys/authoring.d.ts.map +1 -0
  86. package/dist/journeys/client-defaults-singleton.d.ts +16 -0
  87. package/dist/journeys/client-defaults-singleton.d.ts.map +1 -0
  88. package/dist/journeys/constants.d.ts +32 -0
  89. package/dist/journeys/constants.d.ts.map +1 -0
  90. package/dist/journeys/define-journey.d.ts +33 -0
  91. package/dist/journeys/define-journey.d.ts.map +1 -0
  92. package/dist/journeys/durable-law-harness.d.ts +74 -0
  93. package/dist/journeys/durable-law-harness.d.ts.map +1 -0
  94. package/dist/journeys/errors.d.ts +13 -0
  95. package/dist/journeys/errors.d.ts.map +1 -0
  96. package/dist/journeys/execute-journey-run.d.ts +160 -0
  97. package/dist/journeys/execute-journey-run.d.ts.map +1 -0
  98. package/dist/journeys/graph/build-graph.d.ts +24 -0
  99. package/dist/journeys/graph/build-graph.d.ts.map +1 -0
  100. package/dist/journeys/group-scope.d.ts +56 -0
  101. package/dist/journeys/group-scope.d.ts.map +1 -0
  102. package/dist/journeys/journey-boundary.d.ts +264 -0
  103. package/dist/journeys/journey-boundary.d.ts.map +1 -0
  104. package/dist/journeys/journey-context.d.ts +60 -0
  105. package/dist/journeys/journey-context.d.ts.map +1 -0
  106. package/dist/journeys/journey-log.d.ts +42 -0
  107. package/dist/journeys/journey-log.d.ts.map +1 -0
  108. package/dist/journeys/journey-source-locations-singleton.d.ts +6 -0
  109. package/dist/journeys/journey-source-locations-singleton.d.ts.map +1 -0
  110. package/dist/journeys/journey-sources-singleton.d.ts +5 -0
  111. package/dist/journeys/journey-sources-singleton.d.ts.map +1 -0
  112. package/dist/journeys/journey-task-factory.d.ts +11 -0
  113. package/dist/journeys/journey-task-factory.d.ts.map +1 -0
  114. package/dist/journeys/journey-task-runtime.d.ts +2 -0
  115. package/dist/journeys/journey-task-runtime.d.ts.map +1 -0
  116. package/dist/journeys/journey-version.d.ts +71 -0
  117. package/dist/journeys/journey-version.d.ts.map +1 -0
  118. package/dist/journeys/record-once.d.ts +56 -0
  119. package/dist/journeys/record-once.d.ts.map +1 -0
  120. package/dist/journeys/registry-singleton.d.ts +6 -0
  121. package/dist/journeys/registry-singleton.d.ts.map +1 -0
  122. package/dist/journeys/registry.d.ts +59 -0
  123. package/dist/journeys/registry.d.ts.map +1 -0
  124. package/dist/journeys/with-durable-gate.d.ts +97 -0
  125. package/dist/journeys/with-durable-gate.d.ts.map +1 -0
  126. package/dist/lib/account-link-emit.d.ts +69 -0
  127. package/dist/lib/account-link-emit.d.ts.map +1 -0
  128. package/dist/lib/account-link-events.d.ts +128 -0
  129. package/dist/lib/account-link-events.d.ts.map +1 -0
  130. package/dist/lib/account-link-hooks.d.ts +32 -0
  131. package/dist/lib/account-link-hooks.d.ts.map +1 -0
  132. package/dist/lib/account-link-ingest.d.ts +78 -0
  133. package/dist/lib/account-link-ingest.d.ts.map +1 -0
  134. package/dist/lib/account-link-nonce.d.ts +29 -0
  135. package/dist/lib/account-link-nonce.d.ts.map +1 -0
  136. package/dist/lib/account-link-origins.d.ts +37 -0
  137. package/dist/lib/account-link-origins.d.ts.map +1 -0
  138. package/dist/lib/account-link-pkce.d.ts +48 -0
  139. package/dist/lib/account-link-pkce.d.ts.map +1 -0
  140. package/dist/lib/account-link-provider-registry.d.ts +35 -0
  141. package/dist/lib/account-link-provider-registry.d.ts.map +1 -0
  142. package/dist/lib/account-link-throttle.d.ts +76 -0
  143. package/dist/lib/account-link-throttle.d.ts.map +1 -0
  144. package/dist/lib/account-link-url.d.ts +41 -0
  145. package/dist/lib/account-link-url.d.ts.map +1 -0
  146. package/dist/lib/account-links-from-env.d.ts +62 -0
  147. package/dist/lib/account-links-from-env.d.ts.map +1 -0
  148. package/dist/lib/account-links.d.ts +353 -0
  149. package/dist/lib/account-links.d.ts.map +1 -0
  150. package/dist/lib/agent/config.d.ts +14 -0
  151. package/dist/lib/agent/config.d.ts.map +1 -0
  152. package/dist/lib/agent/proposals.d.ts +52 -0
  153. package/dist/lib/agent/proposals.d.ts.map +1 -0
  154. package/dist/lib/agent/provider.d.ts +9 -0
  155. package/dist/lib/agent/provider.d.ts.map +1 -0
  156. package/dist/lib/agent/risk.d.ts +24 -0
  157. package/dist/lib/agent/risk.d.ts.map +1 -0
  158. package/dist/lib/agent/system-prompt.d.ts +8 -0
  159. package/dist/lib/agent/system-prompt.d.ts.map +1 -0
  160. package/dist/lib/agent/tools.d.ts +258 -0
  161. package/dist/lib/agent/tools.d.ts.map +1 -0
  162. package/dist/lib/alerting.d.ts +7 -0
  163. package/dist/lib/alerting.d.ts.map +1 -0
  164. package/dist/lib/analytics-adapter.d.ts +24 -0
  165. package/dist/lib/analytics-adapter.d.ts.map +1 -0
  166. package/dist/lib/analytics-identity.d.ts +60 -0
  167. package/dist/lib/analytics-identity.d.ts.map +1 -0
  168. package/dist/lib/analytics-provider-registry.d.ts +20 -0
  169. package/dist/lib/analytics-provider-registry.d.ts.map +1 -0
  170. package/dist/lib/analytics-providers-from-env.d.ts +41 -0
  171. package/dist/lib/analytics-providers-from-env.d.ts.map +1 -0
  172. package/dist/lib/analytics-singleton.d.ts +10 -0
  173. package/dist/lib/analytics-singleton.d.ts.map +1 -0
  174. package/dist/lib/api-key-hash.d.ts +9 -0
  175. package/dist/lib/api-key-hash.d.ts.map +1 -0
  176. package/dist/lib/app-secret.d.ts +29 -0
  177. package/dist/lib/app-secret.d.ts.map +1 -0
  178. package/dist/lib/attachments.d.ts +53 -0
  179. package/dist/lib/attachments.d.ts.map +1 -0
  180. package/dist/lib/attribution-backfill.d.ts +48 -0
  181. package/dist/lib/attribution-backfill.d.ts.map +1 -0
  182. package/dist/lib/attribution.d.ts +44 -0
  183. package/dist/lib/attribution.d.ts.map +1 -0
  184. package/dist/lib/auth.d.ts +136 -0
  185. package/dist/lib/auth.d.ts.map +1 -0
  186. package/dist/lib/backfill.d.ts +41 -0
  187. package/dist/lib/backfill.d.ts.map +1 -0
  188. package/dist/lib/banner.d.ts +52 -0
  189. package/dist/lib/banner.d.ts.map +1 -0
  190. package/dist/lib/blueprint-lock.d.ts +19 -0
  191. package/dist/lib/blueprint-lock.d.ts.map +1 -0
  192. package/dist/lib/blueprints.d.ts +573 -0
  193. package/dist/lib/blueprints.d.ts.map +1 -0
  194. package/dist/lib/boot-api-key.d.ts +38 -0
  195. package/dist/lib/boot-api-key.d.ts.map +1 -0
  196. package/dist/lib/boot.d.ts +23 -0
  197. package/dist/lib/boot.d.ts.map +1 -0
  198. package/dist/lib/bootstrap-admin.d.ts +33 -0
  199. package/dist/lib/bootstrap-admin.d.ts.map +1 -0
  200. package/dist/lib/bot-prefetch.d.ts +21 -0
  201. package/dist/lib/bot-prefetch.d.ts.map +1 -0
  202. package/dist/lib/bucket-emit.d.ts +75 -0
  203. package/dist/lib/bucket-emit.d.ts.map +1 -0
  204. package/dist/lib/bucket-posthog-sync.d.ts +29 -0
  205. package/dist/lib/bucket-posthog-sync.d.ts.map +1 -0
  206. package/dist/lib/campaign-send-key.d.ts +31 -0
  207. package/dist/lib/campaign-send-key.d.ts.map +1 -0
  208. package/dist/lib/connector-actions.d.ts +83 -0
  209. package/dist/lib/connector-actions.d.ts.map +1 -0
  210. package/dist/lib/connector-heartbeat.d.ts +35 -0
  211. package/dist/lib/connector-heartbeat.d.ts.map +1 -0
  212. package/dist/lib/connector-link-codes.d.ts +105 -0
  213. package/dist/lib/connector-link-codes.d.ts.map +1 -0
  214. package/dist/lib/connector-state.d.ts +97 -0
  215. package/dist/lib/connector-state.d.ts.map +1 -0
  216. package/dist/lib/contacts.d.ts +622 -0
  217. package/dist/lib/contacts.d.ts.map +1 -0
  218. package/dist/lib/conversion-dispatch.d.ts +98 -0
  219. package/dist/lib/conversion-dispatch.d.ts.map +1 -0
  220. package/dist/lib/conversions.d.ts +75 -0
  221. package/dist/lib/conversions.d.ts.map +1 -0
  222. package/dist/lib/create-admin.d.ts +54 -0
  223. package/dist/lib/create-admin.d.ts.map +1 -0
  224. package/dist/lib/crm-deals.d.ts +66 -0
  225. package/dist/lib/crm-deals.d.ts.map +1 -0
  226. package/dist/lib/crm-ingest.d.ts +38 -0
  227. package/dist/lib/crm-ingest.d.ts.map +1 -0
  228. package/dist/lib/crm-provider-registry.d.ts +20 -0
  229. package/dist/lib/crm-provider-registry.d.ts.map +1 -0
  230. package/dist/lib/crm-registry-singleton.d.ts +18 -0
  231. package/dist/lib/crm-registry-singleton.d.ts.map +1 -0
  232. package/dist/lib/db.d.ts +3 -0
  233. package/dist/lib/db.d.ts.map +1 -0
  234. package/dist/lib/deal-money-events.d.ts +35 -0
  235. package/dist/lib/deal-money-events.d.ts.map +1 -0
  236. package/dist/lib/discord-gateway-heartbeat.d.ts +47 -0
  237. package/dist/lib/discord-gateway-heartbeat.d.ts.map +1 -0
  238. package/dist/lib/domain-status.d.ts +87 -0
  239. package/dist/lib/domain-status.d.ts.map +1 -0
  240. package/dist/lib/email-provider-registry.d.ts +30 -0
  241. package/dist/lib/email-provider-registry.d.ts.map +1 -0
  242. package/dist/lib/email-providers-from-env.d.ts +12 -0
  243. package/dist/lib/email-providers-from-env.d.ts.map +1 -0
  244. package/dist/lib/email-service-types.d.ts +189 -0
  245. package/dist/lib/email-service-types.d.ts.map +1 -0
  246. package/dist/lib/email-stats.d.ts +12 -0
  247. package/dist/lib/email-stats.d.ts.map +1 -0
  248. package/dist/lib/email.d.ts +73 -0
  249. package/dist/lib/email.d.ts.map +1 -0
  250. package/dist/lib/enrichment-ledger.d.ts +101 -0
  251. package/dist/lib/enrichment-ledger.d.ts.map +1 -0
  252. package/dist/lib/enrichment-provider-registry.d.ts +20 -0
  253. package/dist/lib/enrichment-provider-registry.d.ts.map +1 -0
  254. package/dist/lib/enrichment-providers-from-env.d.ts +13 -0
  255. package/dist/lib/enrichment-providers-from-env.d.ts.map +1 -0
  256. package/dist/lib/enrichment-registry-singleton.d.ts +9 -0
  257. package/dist/lib/enrichment-registry-singleton.d.ts.map +1 -0
  258. package/dist/lib/enrollment-guards.d.ts +28 -0
  259. package/dist/lib/enrollment-guards.d.ts.map +1 -0
  260. package/dist/lib/enrollment-policy.d.ts +25 -0
  261. package/dist/lib/enrollment-policy.d.ts.map +1 -0
  262. package/dist/lib/event-names.d.ts +27 -0
  263. package/dist/lib/event-names.d.ts.map +1 -0
  264. package/dist/lib/feed.d.ts +64 -0
  265. package/dist/lib/feed.d.ts.map +1 -0
  266. package/dist/lib/flags-registry.d.ts +23 -0
  267. package/dist/lib/flags-registry.d.ts.map +1 -0
  268. package/dist/lib/flags.d.ts +143 -0
  269. package/dist/lib/flags.d.ts.map +1 -0
  270. package/dist/lib/frequency-cap.d.ts +38 -0
  271. package/dist/lib/frequency-cap.d.ts.map +1 -0
  272. package/dist/lib/from-address.d.ts +15 -0
  273. package/dist/lib/from-address.d.ts.map +1 -0
  274. package/dist/lib/funnel-progress.d.ts +37 -0
  275. package/dist/lib/funnel-progress.d.ts.map +1 -0
  276. package/dist/lib/funnel-registry.d.ts +44 -0
  277. package/dist/lib/funnel-registry.d.ts.map +1 -0
  278. package/dist/lib/funnel-transitions.d.ts +63 -0
  279. package/dist/lib/funnel-transitions.d.ts.map +1 -0
  280. package/dist/lib/fx.d.ts +118 -0
  281. package/dist/lib/fx.d.ts.map +1 -0
  282. package/dist/lib/global-control-readout.d.ts +72 -0
  283. package/dist/lib/global-control-readout.d.ts.map +1 -0
  284. package/dist/lib/groups.d.ts +138 -0
  285. package/dist/lib/groups.d.ts.map +1 -0
  286. package/dist/lib/hatchet-duration.d.ts +14 -0
  287. package/dist/lib/hatchet-duration.d.ts.map +1 -0
  288. package/dist/lib/hatchet.d.ts +3 -0
  289. package/dist/lib/hatchet.d.ts.map +1 -0
  290. package/dist/lib/headers.d.ts +8 -0
  291. package/dist/lib/headers.d.ts.map +1 -0
  292. package/dist/lib/holdout.d.ts +36 -0
  293. package/dist/lib/holdout.d.ts.map +1 -0
  294. package/dist/lib/html.d.ts +5 -0
  295. package/dist/lib/html.d.ts.map +1 -0
  296. package/dist/lib/identity-service.d.ts +60 -0
  297. package/dist/lib/identity-service.d.ts.map +1 -0
  298. package/dist/lib/identity-token.d.ts +81 -0
  299. package/dist/lib/identity-token.d.ts.map +1 -0
  300. package/dist/lib/ingestion.d.ts +218 -0
  301. package/dist/lib/ingestion.d.ts.map +1 -0
  302. package/dist/lib/journey-lift.d.ts +56 -0
  303. package/dist/lib/journey-lift.d.ts.map +1 -0
  304. package/dist/lib/journey-suppress.d.ts +59 -0
  305. package/dist/lib/journey-suppress.d.ts.map +1 -0
  306. package/dist/lib/leader-lease.d.ts +36 -0
  307. package/dist/lib/leader-lease.d.ts.map +1 -0
  308. package/dist/lib/lift-stats.d.ts +46 -0
  309. package/dist/lib/lift-stats.d.ts.map +1 -0
  310. package/dist/lib/links.d.ts +186 -0
  311. package/dist/lib/links.d.ts.map +1 -0
  312. package/dist/lib/load-optional-plugin.d.ts +47 -0
  313. package/dist/lib/load-optional-plugin.d.ts.map +1 -0
  314. package/dist/lib/logger.d.ts +4 -0
  315. package/dist/lib/logger.d.ts.map +1 -0
  316. package/dist/lib/mailer.d.ts +43 -0
  317. package/dist/lib/mailer.d.ts.map +1 -0
  318. package/dist/lib/metrics-sql.d.ts +11 -0
  319. package/dist/lib/metrics-sql.d.ts.map +1 -0
  320. package/dist/lib/notifications.d.ts +17 -0
  321. package/dist/lib/notifications.d.ts.map +1 -0
  322. package/dist/lib/oauth-token-manager.d.ts +74 -0
  323. package/dist/lib/oauth-token-manager.d.ts.map +1 -0
  324. package/dist/lib/operator-settings.d.ts +33 -0
  325. package/dist/lib/operator-settings.d.ts.map +1 -0
  326. package/dist/lib/operator.d.ts +20 -0
  327. package/dist/lib/operator.d.ts.map +1 -0
  328. package/dist/lib/outbound-endpoint-cache.d.ts +25 -0
  329. package/dist/lib/outbound-endpoint-cache.d.ts.map +1 -0
  330. package/dist/lib/outbound.d.ts +687 -0
  331. package/dist/lib/outbound.d.ts.map +1 -0
  332. package/dist/lib/phone.d.ts +11 -0
  333. package/dist/lib/phone.d.ts.map +1 -0
  334. package/dist/lib/posthog-scopes.d.ts +30 -0
  335. package/dist/lib/posthog-scopes.d.ts.map +1 -0
  336. package/dist/lib/posthog.d.ts +16 -0
  337. package/dist/lib/posthog.d.ts.map +1 -0
  338. package/dist/lib/preferences.d.ts +72 -0
  339. package/dist/lib/preferences.d.ts.map +1 -0
  340. package/dist/lib/provider-credentials.d.ts +149 -0
  341. package/dist/lib/provider-credentials.d.ts.map +1 -0
  342. package/dist/lib/provision-posthog-loop.d.ts +100 -0
  343. package/dist/lib/provision-posthog-loop.d.ts.map +1 -0
  344. package/dist/lib/recipient-preferences.d.ts +29 -0
  345. package/dist/lib/recipient-preferences.d.ts.map +1 -0
  346. package/dist/lib/redis.d.ts +33 -0
  347. package/dist/lib/redis.d.ts.map +1 -0
  348. package/dist/lib/referral-intent.d.ts +99 -0
  349. package/dist/lib/referral-intent.d.ts.map +1 -0
  350. package/dist/lib/referral-link.d.ts +59 -0
  351. package/dist/lib/referral-link.d.ts.map +1 -0
  352. package/dist/lib/referral-registry.d.ts +37 -0
  353. package/dist/lib/referral-registry.d.ts.map +1 -0
  354. package/dist/lib/referral-report.d.ts +178 -0
  355. package/dist/lib/referral-report.d.ts.map +1 -0
  356. package/dist/lib/referral-runtime.d.ts +43 -0
  357. package/dist/lib/referral-runtime.d.ts.map +1 -0
  358. package/dist/lib/referrals.d.ts +184 -0
  359. package/dist/lib/referrals.d.ts.map +1 -0
  360. package/dist/lib/refine-chain.d.ts +236 -0
  361. package/dist/lib/refine-chain.d.ts.map +1 -0
  362. package/dist/lib/refine-traits.d.ts +78 -0
  363. package/dist/lib/refine-traits.d.ts.map +1 -0
  364. package/dist/lib/refine.d.ts +35 -0
  365. package/dist/lib/refine.d.ts.map +1 -0
  366. package/dist/lib/reset-email.d.ts +38 -0
  367. package/dist/lib/reset-email.d.ts.map +1 -0
  368. package/dist/lib/revenue.d.ts +61 -0
  369. package/dist/lib/revenue.d.ts.map +1 -0
  370. package/dist/lib/schemas.d.ts +9 -0
  371. package/dist/lib/schemas.d.ts.map +1 -0
  372. package/dist/lib/seed-posthog-destination.d.ts +22 -0
  373. package/dist/lib/seed-posthog-destination.d.ts.map +1 -0
  374. package/dist/lib/semantic-click.d.ts +58 -0
  375. package/dist/lib/semantic-click.d.ts.map +1 -0
  376. package/dist/lib/sending-domain-guidance.d.ts +40 -0
  377. package/dist/lib/sending-domain-guidance.d.ts.map +1 -0
  378. package/dist/lib/singleton.d.ts +24 -0
  379. package/dist/lib/singleton.d.ts.map +1 -0
  380. package/dist/lib/sms-frequency-cap.d.ts +16 -0
  381. package/dist/lib/sms-frequency-cap.d.ts.map +1 -0
  382. package/dist/lib/sms-inbound.d.ts +37 -0
  383. package/dist/lib/sms-inbound.d.ts.map +1 -0
  384. package/dist/lib/sms-link-tracking.d.ts +53 -0
  385. package/dist/lib/sms-link-tracking.d.ts.map +1 -0
  386. package/dist/lib/sms-mailer.d.ts +12 -0
  387. package/dist/lib/sms-mailer.d.ts.map +1 -0
  388. package/dist/lib/sms-provider-registry.d.ts +20 -0
  389. package/dist/lib/sms-provider-registry.d.ts.map +1 -0
  390. package/dist/lib/sms-providers-from-env.d.ts +4 -0
  391. package/dist/lib/sms-providers-from-env.d.ts.map +1 -0
  392. package/dist/lib/sms-service-types.d.ts +131 -0
  393. package/dist/lib/sms-service-types.d.ts.map +1 -0
  394. package/dist/lib/sms-tracked.d.ts +36 -0
  395. package/dist/lib/sms-tracked.d.ts.map +1 -0
  396. package/dist/lib/sms.d.ts +58 -0
  397. package/dist/lib/sms.d.ts.map +1 -0
  398. package/dist/lib/snippet.d.ts +32 -0
  399. package/dist/lib/snippet.d.ts.map +1 -0
  400. package/dist/lib/stable-stringify.d.ts +12 -0
  401. package/dist/lib/stable-stringify.d.ts.map +1 -0
  402. package/dist/lib/studio.d.ts +21 -0
  403. package/dist/lib/studio.d.ts.map +1 -0
  404. package/dist/lib/survey.d.ts +35 -0
  405. package/dist/lib/survey.d.ts.map +1 -0
  406. package/dist/lib/test-mode.d.ts +77 -0
  407. package/dist/lib/test-mode.d.ts.map +1 -0
  408. package/dist/lib/timezone.d.ts +55 -0
  409. package/dist/lib/timezone.d.ts.map +1 -0
  410. package/dist/lib/tracked.d.ts +95 -0
  411. package/dist/lib/tracked.d.ts.map +1 -0
  412. package/dist/lib/tracking-event-names.d.ts +7 -0
  413. package/dist/lib/tracking-event-names.d.ts.map +1 -0
  414. package/dist/lib/tracking-events.d.ts +232 -0
  415. package/dist/lib/tracking-events.d.ts.map +1 -0
  416. package/dist/lib/tracking.d.ts +47 -0
  417. package/dist/lib/tracking.d.ts.map +1 -0
  418. package/dist/lib/unconfigured-email-provider.d.ts +20 -0
  419. package/dist/lib/unconfigured-email-provider.d.ts.map +1 -0
  420. package/dist/lib/unique-violation.d.ts +22 -0
  421. package/dist/lib/unique-violation.d.ts.map +1 -0
  422. package/dist/lib/user-token.d.ts +44 -0
  423. package/dist/lib/user-token.d.ts.map +1 -0
  424. package/dist/lib/variant.d.ts +44 -0
  425. package/dist/lib/variant.d.ts.map +1 -0
  426. package/dist/lib/webhook-signing.d.ts +120 -0
  427. package/dist/lib/webhook-signing.d.ts.map +1 -0
  428. package/dist/lib/worker-heartbeat.d.ts +18 -0
  429. package/dist/lib/worker-heartbeat.d.ts.map +1 -0
  430. package/dist/lists/channels.d.ts +43 -0
  431. package/dist/lists/channels.d.ts.map +1 -0
  432. package/dist/lists/define-list.d.ts +76 -0
  433. package/dist/lists/define-list.d.ts.map +1 -0
  434. package/dist/lists/registry-singleton.d.ts +8 -0
  435. package/dist/lists/registry-singleton.d.ts.map +1 -0
  436. package/dist/lists/registry.d.ts +66 -0
  437. package/dist/lists/registry.d.ts.map +1 -0
  438. package/dist/lists/subscription.d.ts +10 -0
  439. package/dist/lists/subscription.d.ts.map +1 -0
  440. package/dist/mcp/authoring-guide.d.ts +33 -0
  441. package/dist/mcp/authoring-guide.d.ts.map +1 -0
  442. package/dist/mcp/blueprint-tools.d.ts +266 -0
  443. package/dist/mcp/blueprint-tools.d.ts.map +1 -0
  444. package/dist/middleware/api-key.d.ts +45 -0
  445. package/dist/middleware/api-key.d.ts.map +1 -0
  446. package/dist/middleware/audit.d.ts +3 -0
  447. package/dist/middleware/audit.d.ts.map +1 -0
  448. package/dist/middleware/error-handler.d.ts +4 -0
  449. package/dist/middleware/error-handler.d.ts.map +1 -0
  450. package/dist/middleware/publishable-key.d.ts +27 -0
  451. package/dist/middleware/publishable-key.d.ts.map +1 -0
  452. package/dist/middleware/rate-limit.d.ts +105 -0
  453. package/dist/middleware/rate-limit.d.ts.map +1 -0
  454. package/dist/middleware/request-logger.d.ts +4 -0
  455. package/dist/middleware/request-logger.d.ts.map +1 -0
  456. package/dist/middleware/require-admin.d.ts +3 -0
  457. package/dist/middleware/require-admin.d.ts.map +1 -0
  458. package/dist/routes/_shared.d.ts +52 -0
  459. package/dist/routes/_shared.d.ts.map +1 -0
  460. package/dist/routes/accounts/callback.d.ts +18 -0
  461. package/dist/routes/accounts/callback.d.ts.map +1 -0
  462. package/dist/routes/accounts/emit.d.ts +96 -0
  463. package/dist/routes/accounts/emit.d.ts.map +1 -0
  464. package/dist/routes/accounts/import-links.d.ts +4 -0
  465. package/dist/routes/accounts/import-links.d.ts.map +1 -0
  466. package/dist/routes/accounts/index.d.ts +39 -0
  467. package/dist/routes/accounts/index.d.ts.map +1 -0
  468. package/dist/routes/accounts/lookup.d.ts +6 -0
  469. package/dist/routes/accounts/lookup.d.ts.map +1 -0
  470. package/dist/routes/accounts/me.d.ts +5 -0
  471. package/dist/routes/accounts/me.d.ts.map +1 -0
  472. package/dist/routes/accounts/mint.d.ts +5 -0
  473. package/dist/routes/accounts/mint.d.ts.map +1 -0
  474. package/dist/routes/accounts/pages.d.ts +23 -0
  475. package/dist/routes/accounts/pages.d.ts.map +1 -0
  476. package/dist/routes/accounts/resolve.d.ts +33 -0
  477. package/dist/routes/accounts/resolve.d.ts.map +1 -0
  478. package/dist/routes/accounts/serialize.d.ts +57 -0
  479. package/dist/routes/accounts/serialize.d.ts.map +1 -0
  480. package/dist/routes/accounts/shared.d.ts +68 -0
  481. package/dist/routes/accounts/shared.d.ts.map +1 -0
  482. package/dist/routes/accounts/start.d.ts +16 -0
  483. package/dist/routes/accounts/start.d.ts.map +1 -0
  484. package/dist/routes/accounts/unlink.d.ts +36 -0
  485. package/dist/routes/accounts/unlink.d.ts.map +1 -0
  486. package/dist/routes/admin/agent.d.ts +4 -0
  487. package/dist/routes/admin/agent.d.ts.map +1 -0
  488. package/dist/routes/admin/alerts.d.ts +190 -0
  489. package/dist/routes/admin/alerts.d.ts.map +1 -0
  490. package/dist/routes/admin/analytics.d.ts +137 -0
  491. package/dist/routes/admin/analytics.d.ts.map +1 -0
  492. package/dist/routes/admin/api-keys.d.ts +158 -0
  493. package/dist/routes/admin/api-keys.d.ts.map +1 -0
  494. package/dist/routes/admin/attribution.d.ts +93 -0
  495. package/dist/routes/admin/attribution.d.ts.map +1 -0
  496. package/dist/routes/admin/audit-logs.d.ts +40 -0
  497. package/dist/routes/admin/audit-logs.d.ts.map +1 -0
  498. package/dist/routes/admin/blueprints.d.ts +4 -0
  499. package/dist/routes/admin/blueprints.d.ts.map +1 -0
  500. package/dist/routes/admin/buckets.d.ts +215 -0
  501. package/dist/routes/admin/buckets.d.ts.map +1 -0
  502. package/dist/routes/admin/bulk.d.ts +203 -0
  503. package/dist/routes/admin/bulk.d.ts.map +1 -0
  504. package/dist/routes/admin/campaigns.d.ts +198 -0
  505. package/dist/routes/admin/campaigns.d.ts.map +1 -0
  506. package/dist/routes/admin/connectors.d.ts +116 -0
  507. package/dist/routes/admin/connectors.d.ts.map +1 -0
  508. package/dist/routes/admin/contacts.d.ts +246 -0
  509. package/dist/routes/admin/contacts.d.ts.map +1 -0
  510. package/dist/routes/admin/conversions.d.ts +103 -0
  511. package/dist/routes/admin/conversions.d.ts.map +1 -0
  512. package/dist/routes/admin/deals.d.ts +136 -0
  513. package/dist/routes/admin/deals.d.ts.map +1 -0
  514. package/dist/routes/admin/dlq.d.ts +100 -0
  515. package/dist/routes/admin/dlq.d.ts.map +1 -0
  516. package/dist/routes/admin/domain.d.ts +314 -0
  517. package/dist/routes/admin/domain.d.ts.map +1 -0
  518. package/dist/routes/admin/emails.d.ts +127 -0
  519. package/dist/routes/admin/emails.d.ts.map +1 -0
  520. package/dist/routes/admin/events.d.ts +140 -0
  521. package/dist/routes/admin/events.d.ts.map +1 -0
  522. package/dist/routes/admin/flags.d.ts +719 -0
  523. package/dist/routes/admin/flags.d.ts.map +1 -0
  524. package/dist/routes/admin/funnels.d.ts +71 -0
  525. package/dist/routes/admin/funnels.d.ts.map +1 -0
  526. package/dist/routes/admin/groups.d.ts +169 -0
  527. package/dist/routes/admin/groups.d.ts.map +1 -0
  528. package/dist/routes/admin/identity.d.ts +72 -0
  529. package/dist/routes/admin/identity.d.ts.map +1 -0
  530. package/dist/routes/admin/impact-schemas.d.ts +48 -0
  531. package/dist/routes/admin/impact-schemas.d.ts.map +1 -0
  532. package/dist/routes/admin/impact.d.ts +316 -0
  533. package/dist/routes/admin/impact.d.ts.map +1 -0
  534. package/dist/routes/admin/index.d.ts +4 -0
  535. package/dist/routes/admin/index.d.ts.map +1 -0
  536. package/dist/routes/admin/journey-impact.d.ts +320 -0
  537. package/dist/routes/admin/journey-impact.d.ts.map +1 -0
  538. package/dist/routes/admin/journey-logs.d.ts +57 -0
  539. package/dist/routes/admin/journey-logs.d.ts.map +1 -0
  540. package/dist/routes/admin/journeys.d.ts +736 -0
  541. package/dist/routes/admin/journeys.d.ts.map +1 -0
  542. package/dist/routes/admin/links.d.ts +382 -0
  543. package/dist/routes/admin/links.d.ts.map +1 -0
  544. package/dist/routes/admin/lists.d.ts +22 -0
  545. package/dist/routes/admin/lists.d.ts.map +1 -0
  546. package/dist/routes/admin/maintenance.d.ts +72 -0
  547. package/dist/routes/admin/maintenance.d.ts.map +1 -0
  548. package/dist/routes/admin/metrics.d.ts +212 -0
  549. package/dist/routes/admin/metrics.d.ts.map +1 -0
  550. package/dist/routes/admin/open-editor.d.ts +36 -0
  551. package/dist/routes/admin/open-editor.d.ts.map +1 -0
  552. package/dist/routes/admin/preferences.d.ts +109 -0
  553. package/dist/routes/admin/preferences.d.ts.map +1 -0
  554. package/dist/routes/admin/provider-credentials.d.ts +108 -0
  555. package/dist/routes/admin/provider-credentials.d.ts.map +1 -0
  556. package/dist/routes/admin/readiness.d.ts +24 -0
  557. package/dist/routes/admin/readiness.d.ts.map +1 -0
  558. package/dist/routes/admin/referrals.d.ts +230 -0
  559. package/dist/routes/admin/referrals.d.ts.map +1 -0
  560. package/dist/routes/admin/reporting.d.ts +149 -0
  561. package/dist/routes/admin/reporting.d.ts.map +1 -0
  562. package/dist/routes/admin/settings.d.ts +80 -0
  563. package/dist/routes/admin/settings.d.ts.map +1 -0
  564. package/dist/routes/admin/suppressions.d.ts +90 -0
  565. package/dist/routes/admin/suppressions.d.ts.map +1 -0
  566. package/dist/routes/admin/targeting.d.ts +58 -0
  567. package/dist/routes/admin/targeting.d.ts.map +1 -0
  568. package/dist/routes/admin/templates.d.ts +197 -0
  569. package/dist/routes/admin/templates.d.ts.map +1 -0
  570. package/dist/routes/admin/timeline.d.ts +51 -0
  571. package/dist/routes/admin/timeline.d.ts.map +1 -0
  572. package/dist/routes/admin/webhooks.d.ts +250 -0
  573. package/dist/routes/admin/webhooks.d.ts.map +1 -0
  574. package/dist/routes/campaigns/index.d.ts +239 -0
  575. package/dist/routes/campaigns/index.d.ts.map +1 -0
  576. package/dist/routes/connectors/index.d.ts +16 -0
  577. package/dist/routes/connectors/index.d.ts.map +1 -0
  578. package/dist/routes/contacts/index.d.ts +187 -0
  579. package/dist/routes/contacts/index.d.ts.map +1 -0
  580. package/dist/routes/email/index.d.ts +4 -0
  581. package/dist/routes/email/index.d.ts.map +1 -0
  582. package/dist/routes/email/preferences.d.ts +17 -0
  583. package/dist/routes/email/preferences.d.ts.map +1 -0
  584. package/dist/routes/email/unsubscribe.d.ts +17 -0
  585. package/dist/routes/email/unsubscribe.d.ts.map +1 -0
  586. package/dist/routes/emails/index.d.ts +90 -0
  587. package/dist/routes/emails/index.d.ts.map +1 -0
  588. package/dist/routes/events/index.d.ts +116 -0
  589. package/dist/routes/events/index.d.ts.map +1 -0
  590. package/dist/routes/feed/index.d.ts +248 -0
  591. package/dist/routes/feed/index.d.ts.map +1 -0
  592. package/dist/routes/feed/recipient.d.ts +65 -0
  593. package/dist/routes/feed/recipient.d.ts.map +1 -0
  594. package/dist/routes/flags/index.d.ts +94 -0
  595. package/dist/routes/flags/index.d.ts.map +1 -0
  596. package/dist/routes/groups/index.d.ts +192 -0
  597. package/dist/routes/groups/index.d.ts.map +1 -0
  598. package/dist/routes/health.d.ts +57 -0
  599. package/dist/routes/health.d.ts.map +1 -0
  600. package/dist/routes/index.d.ts +8 -0
  601. package/dist/routes/index.d.ts.map +1 -0
  602. package/dist/routes/lists/index.d.ts +266 -0
  603. package/dist/routes/lists/index.d.ts.map +1 -0
  604. package/dist/routes/referrals/index.d.ts +22 -0
  605. package/dist/routes/referrals/index.d.ts.map +1 -0
  606. package/dist/routes/referrals/me.d.ts +4 -0
  607. package/dist/routes/referrals/me.d.ts.map +1 -0
  608. package/dist/routes/referrals/report.d.ts +5 -0
  609. package/dist/routes/referrals/report.d.ts.map +1 -0
  610. package/dist/routes/referrals/shared.d.ts +16 -0
  611. package/dist/routes/referrals/shared.d.ts.map +1 -0
  612. package/dist/routes/referrals/touch.d.ts +5 -0
  613. package/dist/routes/referrals/touch.d.ts.map +1 -0
  614. package/dist/routes/snippet.d.ts +12 -0
  615. package/dist/routes/snippet.d.ts.map +1 -0
  616. package/dist/routes/tracking/answer.d.ts +56 -0
  617. package/dist/routes/tracking/answer.d.ts.map +1 -0
  618. package/dist/routes/tracking/arrive.d.ts +32 -0
  619. package/dist/routes/tracking/arrive.d.ts.map +1 -0
  620. package/dist/routes/tracking/click-pipeline.d.ts +213 -0
  621. package/dist/routes/tracking/click-pipeline.d.ts.map +1 -0
  622. package/dist/routes/tracking/click.d.ts +26 -0
  623. package/dist/routes/tracking/click.d.ts.map +1 -0
  624. package/dist/routes/tracking/identify.d.ts +32 -0
  625. package/dist/routes/tracking/identify.d.ts.map +1 -0
  626. package/dist/routes/tracking/index.d.ts +4 -0
  627. package/dist/routes/tracking/index.d.ts.map +1 -0
  628. package/dist/routes/tracking/open.d.ts +17 -0
  629. package/dist/routes/tracking/open.d.ts.map +1 -0
  630. package/dist/routes/tracking/short.d.ts +17 -0
  631. package/dist/routes/tracking/short.d.ts.map +1 -0
  632. package/dist/routes/tracking/vanity.d.ts +17 -0
  633. package/dist/routes/tracking/vanity.d.ts.map +1 -0
  634. package/dist/routes/webhooks/crm-provider.d.ts +24 -0
  635. package/dist/routes/webhooks/crm-provider.d.ts.map +1 -0
  636. package/dist/routes/webhooks/email-provider.d.ts +21 -0
  637. package/dist/routes/webhooks/email-provider.d.ts.map +1 -0
  638. package/dist/routes/webhooks/index.d.ts +8 -0
  639. package/dist/routes/webhooks/index.d.ts.map +1 -0
  640. package/dist/routes/webhooks/resend.d.ts +35 -0
  641. package/dist/routes/webhooks/resend.d.ts.map +1 -0
  642. package/dist/routes/webhooks/sms-provider.d.ts +23 -0
  643. package/dist/routes/webhooks/sms-provider.d.ts.map +1 -0
  644. package/dist/routes/webhooks/sources.d.ts +12 -0
  645. package/dist/routes/webhooks/sources.d.ts.map +1 -0
  646. package/dist/sources/define-contact-source.d.ts +114 -0
  647. package/dist/sources/define-contact-source.d.ts.map +1 -0
  648. package/dist/sources/registry.d.ts +31 -0
  649. package/dist/sources/registry.d.ts.map +1 -0
  650. package/dist/sources/webhook-source.d.ts +53 -0
  651. package/dist/sources/webhook-source.d.ts.map +1 -0
  652. package/dist/testing.d.ts +10 -0
  653. package/dist/testing.d.ts.map +1 -0
  654. package/dist/webhook-sources/define-webhook-source.d.ts +60 -0
  655. package/dist/webhook-sources/define-webhook-source.d.ts.map +1 -0
  656. package/dist/webhook-sources/presets/clerk.d.ts +9 -0
  657. package/dist/webhook-sources/presets/clerk.d.ts.map +1 -0
  658. package/dist/webhook-sources/presets/index.d.ts +140 -0
  659. package/dist/webhook-sources/presets/index.d.ts.map +1 -0
  660. package/dist/webhook-sources/presets/intercom.d.ts +44 -0
  661. package/dist/webhook-sources/presets/intercom.d.ts.map +1 -0
  662. package/dist/webhook-sources/presets/segment.d.ts +16 -0
  663. package/dist/webhook-sources/presets/segment.d.ts.map +1 -0
  664. package/dist/webhook-sources/presets/stripe.d.ts +20 -0
  665. package/dist/webhook-sources/presets/stripe.d.ts.map +1 -0
  666. package/dist/webhook-sources/presets/supabase.d.ts +23 -0
  667. package/dist/webhook-sources/presets/supabase.d.ts.map +1 -0
  668. package/dist/webhook-sources/verify.d.ts +48 -0
  669. package/dist/webhook-sources/verify.d.ts.map +1 -0
  670. package/dist/worker.d.ts +37 -0
  671. package/dist/worker.d.ts.map +1 -0
  672. package/dist/workflows/backfill-contact-id.d.ts +202 -0
  673. package/dist/workflows/backfill-contact-id.d.ts.map +1 -0
  674. package/dist/workflows/bucket-backfill.d.ts +64 -0
  675. package/dist/workflows/bucket-backfill.d.ts.map +1 -0
  676. package/dist/workflows/bucket-reconcile.d.ts +73 -0
  677. package/dist/workflows/bucket-reconcile.d.ts.map +1 -0
  678. package/dist/workflows/check-alerts.d.ts +10 -0
  679. package/dist/workflows/check-alerts.d.ts.map +1 -0
  680. package/dist/workflows/confirm-semantic-click.d.ts +15 -0
  681. package/dist/workflows/confirm-semantic-click.d.ts.map +1 -0
  682. package/dist/workflows/crm-reconcile.d.ts +27 -0
  683. package/dist/workflows/crm-reconcile.d.ts.map +1 -0
  684. package/dist/workflows/deliver-webhook.d.ts +88 -0
  685. package/dist/workflows/deliver-webhook.d.ts.map +1 -0
  686. package/dist/workflows/dispatch-conversion.d.ts +14 -0
  687. package/dist/workflows/dispatch-conversion.d.ts.map +1 -0
  688. package/dist/workflows/identity-alias-backfill.d.ts +96 -0
  689. package/dist/workflows/identity-alias-backfill.d.ts.map +1 -0
  690. package/dist/workflows/impact-digest.d.ts +142 -0
  691. package/dist/workflows/impact-digest.d.ts.map +1 -0
  692. package/dist/workflows/import-contacts.d.ts +14 -0
  693. package/dist/workflows/import-contacts.d.ts.map +1 -0
  694. package/dist/workflows/import-suppressions.d.ts +55 -0
  695. package/dist/workflows/import-suppressions.d.ts.map +1 -0
  696. package/dist/workflows/journey-blueprint-interpreter.d.ts +73 -0
  697. package/dist/workflows/journey-blueprint-interpreter.d.ts.map +1 -0
  698. package/dist/workflows/send-campaign.d.ts +128 -0
  699. package/dist/workflows/send-campaign.d.ts.map +1 -0
  700. package/dist/workflows/send-email.d.ts +15 -0
  701. package/dist/workflows/send-email.d.ts.map +1 -0
  702. package/dist/workflows/send-feed.d.ts +37 -0
  703. package/dist/workflows/send-feed.d.ts.map +1 -0
  704. package/package.json +60 -22
  705. package/src/app.ts +9 -1
  706. package/src/buckets/check-membership.ts +54 -20
  707. package/src/env.ts +30 -0
  708. package/src/journeys/journey-log.ts +25 -8
  709. package/src/lib/contacts.ts +47 -1
  710. package/src/lib/email-service-types.ts +10 -0
  711. package/src/lib/ingestion.ts +30 -19
  712. package/src/lib/mailer-bounce-idempotency.test.ts +7 -2
  713. package/src/lib/mailer-replied.test.ts +7 -2
  714. package/src/lib/mailer.ts +1 -0
  715. package/src/lib/outbound-endpoint-cache.ts +83 -0
  716. package/src/lib/outbound.ts +56 -37
  717. package/src/lib/seed-posthog-destination.ts +5 -1
  718. package/src/lib/tracked.ts +11 -3
  719. package/src/lib/tracking-events.ts +20 -3
  720. package/src/middleware/api-key.ts +69 -60
  721. package/src/middleware/publishable-key.ts +11 -23
  722. package/src/middleware/rate-limit.ts +165 -3
  723. package/src/routes/admin/api-keys.ts +148 -0
  724. package/src/routes/admin/targeting.ts +6 -1
  725. package/src/routes/admin/webhooks.ts +4 -0
  726. package/src/routes/index.ts +67 -24
  727. package/src/workflows/backfill-contact-id.ts +3 -7
  728. package/src/workflows/bucket-backfill.ts +2 -2
  729. package/src/workflows/bucket-reconcile.ts +28 -12
  730. package/src/workflows/check-alerts.ts +3 -9
  731. package/src/workflows/crm-reconcile.ts +3 -2
  732. package/src/workflows/deliver-webhook.ts +21 -8
  733. package/src/workflows/dispatch-conversion.ts +2 -2
  734. package/src/workflows/identity-alias-backfill.ts +3 -2
  735. package/src/workflows/impact-digest.ts +2 -2
  736. package/src/workflows/import-contacts.ts +3 -4
  737. package/src/workflows/import-suppressions.ts +4 -5
  738. package/src/workflows/send-campaign.ts +10 -1
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cold-connect/index.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,69 @@
1
+ /**
2
+ * Branding for the cold-connect page. Every field is plain text (NOT HTML) — the
3
+ * page JSON-embeds them into a JS-string-safe config and writes them via
4
+ * `textContent`, so no field can inject markup. `accentColor` is regex-validated
5
+ * to a 6-digit hex before it ever reaches a stylesheet.
6
+ */
7
+ export interface ColdConnectBranding {
8
+ /** Page `<title>` + heading before the user confirms. */
9
+ title: string;
10
+ /** Body copy under the heading. */
11
+ blurb: string;
12
+ /** Heading + body shown after a successful bind. */
13
+ successCopy: {
14
+ heading: string;
15
+ body: string;
16
+ };
17
+ /** Heading + body shown after a failed/expired bind. */
18
+ errorCopy: {
19
+ heading: string;
20
+ body: string;
21
+ };
22
+ /** A short emoji/glyph rendered in the badge (fallback when `iconSvg` is unset). */
23
+ badge: string;
24
+ /**
25
+ * Inline platform-logo SVG rendered in the badge instead of `badge`.
26
+ *
27
+ * SECURITY: unlike every other field here (plain text, written via
28
+ * `textContent`), this is inlined into the page markup verbatim. It MUST be a
29
+ * static, developer-authored `<svg>…</svg>` from connector source — NEVER
30
+ * runtime/user input. Author it with `fill="currentColor"`; the badge tints it
31
+ * white.
32
+ */
33
+ iconSvg?: string;
34
+ /** Accent color (`#rrggbb`); validated, falls back to a safe blue. */
35
+ accentColor?: string;
36
+ /** Uppercase micro-label above the badge (Studio `.eyebrow`). Defaults to "Hogsend". */
37
+ eyebrow?: string;
38
+ /**
39
+ * Reassurance footnote under the button ("didn't request this? ignore it").
40
+ * Hidden once the bind resolves. Has a safe default if omitted.
41
+ */
42
+ reassurance?: string;
43
+ }
44
+ /**
45
+ * Self-contained connect page, styled to the Hogsend Studio "Crimzon" design
46
+ * language (ink background, hairline-bordered surface card, Inter, eyebrow
47
+ * micro-label, faint grain) while keeping each connector's platform accent on
48
+ * the badge tint + Confirm button.
49
+ *
50
+ * Security (from the adversarial review):
51
+ * - `?tok=` is read CLIENT-side and never reflected into the markup.
52
+ * - The bind happens on a human button CLICK (POST), NEVER on GET — an email
53
+ * link-preview prefetch can't complete it.
54
+ * - The page identifies CLIENT-side (real geo/IP) keyed to the SERVER-proven
55
+ * `contactKey` the exchange returns — it never sends a distinct_id the server
56
+ * resolves a contact on, so there is no graft/takeover vector.
57
+ * - posthog-js inits with `cross_subdomain_cookie: true` so it reads the
58
+ * visitor's existing `.hogsend.com` distinct_id and folds their prior
59
+ * anonymous browsing into the now-identified person.
60
+ *
61
+ * Branding is plain-text/JSON-embedded; `accentColor` is regex-validated.
62
+ */
63
+ export declare function coldConnectPageHtml(branding: ColdConnectBranding, opts: {
64
+ posthogKey: string | null;
65
+ posthogHost: string | null;
66
+ exchangeUrl: string;
67
+ identifyPropKey: string;
68
+ }): string;
69
+ //# sourceMappingURL=page.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"page.d.ts","sourceRoot":"","sources":["../../src/cold-connect/page.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,WAAW,mBAAmB;IAClC,yDAAyD;IACzD,KAAK,EAAE,MAAM,CAAC;IACd,mCAAmC;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,oDAAoD;IACpD,WAAW,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IAC/C,wDAAwD;IACxD,SAAS,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IAC7C,oFAAoF;IACpF,KAAK,EAAE,MAAM,CAAC;IACd;;;;;;;;OAQG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,sEAAsE;IACtE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,wFAAwF;IACxF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAgCD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,mBAAmB,EAC7B,IAAI,EAAE;IACJ,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;CACzB,GACA,MAAM,CAyLR"}
@@ -0,0 +1,39 @@
1
+ /**
2
+ * Mint-throttle config for a cold-connect flow. Two independent budgets — one
3
+ * keyed on the platform user id, one on the email — each a fixed-window counter
4
+ * (`windowSeconds` / `max`). Both default to a conservative "a few per 15 min".
5
+ */
6
+ export interface ColdConnectThrottleConfig {
7
+ /** Per-platform-user budget. */
8
+ perUser?: {
9
+ windowSeconds?: number;
10
+ max?: number;
11
+ };
12
+ /** Per-email budget. */
13
+ perEmail?: {
14
+ windowSeconds?: number;
15
+ max?: number;
16
+ };
17
+ }
18
+ export type ThrottleResult = {
19
+ ok: true;
20
+ } | {
21
+ ok: false;
22
+ reason: "rate_limited" | "redis_unavailable";
23
+ };
24
+ /**
25
+ * Mint-counted, Redis-INCR throttle for a cold-connect confirm mint. Bumps both
26
+ * the per-user and per-email windows and rejects when EITHER is over its cap.
27
+ *
28
+ * Fail-CLOSED: any Redis fault returns `{ ok:false, reason:"redis_unavailable"
29
+ * }` so the caller (`mintConfirm`) returns `{ ok:false }` and does NOT send a
30
+ * link. Cold-connect deliberately stays OFF the `connectorLinkCodes` DB table —
31
+ * these counters live only in Redis.
32
+ */
33
+ export declare function checkColdConnectThrottle(args: {
34
+ connectorId: string;
35
+ platformUserId: string;
36
+ email: string;
37
+ config?: ColdConnectThrottleConfig;
38
+ }): Promise<ThrottleResult>;
39
+ //# sourceMappingURL=throttle.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"throttle.d.ts","sourceRoot":"","sources":["../../src/cold-connect/throttle.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,MAAM,WAAW,yBAAyB;IACxC,gCAAgC;IAChC,OAAO,CAAC,EAAE;QAAE,aAAa,CAAC,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACnD,wBAAwB;IACxB,QAAQ,CAAC,EAAE;QAAE,aAAa,CAAC,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CACrD;AAKD,MAAM,MAAM,cAAc,GACtB;IAAE,EAAE,EAAE,IAAI,CAAA;CAAE,GACZ;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,cAAc,GAAG,mBAAmB,CAAA;CAAE,CAAC;AAkBhE;;;;;;;;GAQG;AACH,wBAAsB,wBAAwB,CAAC,IAAI,EAAE;IACnD,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,yBAAyB,CAAC;CACpC,GAAG,OAAO,CAAC,cAAc,CAAC,CAuB1B"}
@@ -0,0 +1,57 @@
1
+ /** Default time-to-live for a cold-connect confirm token (seconds). */
2
+ export declare const COLD_CONNECT_DEFAULT_TTL_SECONDS = 900;
3
+ /**
4
+ * The sealed cold-connect binding. The `connectorId` is sealed IN the value so
5
+ * the exchange route can assert it matches the route it was redeemed on
6
+ * (cross-connector token isolation): a token minted for one connector can never
7
+ * be redeemed by another, even if a composer miswires the mounts.
8
+ */
9
+ export interface ColdConnectBinding<S = Record<string, unknown>> {
10
+ connectorId: string;
11
+ platformUserId: string;
12
+ email: string;
13
+ /** Caller-supplied extra scalars carried through to the exchange. */
14
+ scalars?: S;
15
+ }
16
+ /**
17
+ * Mint a cold-connect confirm token sealing `{ connectorId, platformUserId,
18
+ * email, scalars }` server-side in Redis (TTL-bounded). The token rides in a
19
+ * link emailed to that address — clicking it proves inbox ownership. The web
20
+ * caller never names the platform id OR an arbitrary email; both come from the
21
+ * server-sealed token, not the request. Returns the token, or `null` when Redis
22
+ * is unavailable (fail-closed — the caller must not send a link it can't honor).
23
+ */
24
+ export declare function mintColdConnectToken<S = Record<string, unknown>>(args: {
25
+ binding: ColdConnectBinding<S>;
26
+ ttlSeconds?: number;
27
+ }): Promise<string | null>;
28
+ /**
29
+ * PEEK a token's sealed binding WITHOUT consuming it (Redis GET). The exchange
30
+ * consumes the token only AFTER the bind ingest commits, so a transient failure
31
+ * doesn't burn the user's single click. Returns `null` on unknown/expired/
32
+ * malformed token.
33
+ */
34
+ export declare function peekColdConnectToken<S = Record<string, unknown>>(args: {
35
+ connectorId: string;
36
+ token: string;
37
+ }): Promise<ColdConnectBinding<S> | null>;
38
+ /**
39
+ * Consume (single-use delete) a token AFTER its bind ingest has committed.
40
+ * Idempotent: a second click then sees the token gone. Best-effort — a Redis
41
+ * blip here leaves the token to expire on its TTL.
42
+ */
43
+ export declare function consumeColdConnectToken(args: {
44
+ connectorId: string;
45
+ token: string;
46
+ }): Promise<void>;
47
+ /**
48
+ * Build the email-confirmation connect URL on the customer's own API_PUBLIC_URL.
49
+ * The path is derived from `connectorId` (`/connect/<connectorId>?tok=…`) — the
50
+ * same basePath `cc.routes` mounts, so a minted URL always resolves.
51
+ */
52
+ export declare function buildColdConnectUrl(args: {
53
+ apiPublicUrl: string;
54
+ connectorId: string;
55
+ token: string;
56
+ }): string;
57
+ //# sourceMappingURL=token.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"token.d.ts","sourceRoot":"","sources":["../../src/cold-connect/token.ts"],"names":[],"mappings":"AAGA,uEAAuE;AACvE,eAAO,MAAM,gCAAgC,MAAM,CAAC;AAEpD;;;;;GAKG;AACH,MAAM,WAAW,kBAAkB,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAC7D,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,qEAAqE;IACrE,OAAO,CAAC,EAAE,CAAC,CAAC;CACb;AAgBD;;;;;;;GAOG;AACH,wBAAsB,oBAAoB,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,EAAE;IAC5E,OAAO,EAAE,kBAAkB,CAAC,CAAC,CAAC,CAAC;IAC/B,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAezB;AAED;;;;;GAKG;AACH,wBAAsB,oBAAoB,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,EAAE;IAC5E,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;CACf,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAwBxC;AAED;;;;GAIG;AACH,wBAAsB,uBAAuB,CAAC,IAAI,EAAE;IAClD,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;CACf,GAAG,OAAO,CAAC,IAAI,CAAC,CAQhB;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE;IACxC,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;CACf,GAAG,MAAM,CAKT"}
@@ -0,0 +1,21 @@
1
+ import type { DefinedConnectorAction } from "./define-action.js";
2
+ /**
3
+ * The process-wide connector-action registry, set once by `createHogsendClient`.
4
+ * Mirrors {@link ConnectorRegistry}: keyed by `${connectorId}:${name}`,
5
+ * last-writer-wins, with a lazy empty fallback so a self-booting context (the
6
+ * standalone {@link sendConnectorAction}) resolves cleanly even before any
7
+ * container ran (it just finds no actions).
8
+ */
9
+ export declare class ConnectorActionRegistry {
10
+ private readonly byKey;
11
+ constructor(actions?: DefinedConnectorAction[]);
12
+ register(action: DefinedConnectorAction): void;
13
+ get(connectorId: string, name: string): DefinedConnectorAction | undefined;
14
+ getAll(): DefinedConnectorAction[];
15
+ count(): number;
16
+ }
17
+ export declare function setConnectorActionRegistry(registry: ConnectorActionRegistry): void;
18
+ export declare function getConnectorActionRegistry(): ConnectorActionRegistry;
19
+ /** Reset the installed registry — only for test cleanup. */
20
+ export declare function resetConnectorActionRegistry(): void;
21
+ //# sourceMappingURL=action-registry-singleton.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"action-registry-singleton.d.ts","sourceRoot":"","sources":["../../src/connectors/action-registry-singleton.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAEjE;;;;;;GAMG;AACH,qBAAa,uBAAuB;IAClC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA6C;gBAEvD,OAAO,GAAE,sBAAsB,EAAO;IAIlD,QAAQ,CAAC,MAAM,EAAE,sBAAsB,GAAG,IAAI;IAI9C,GAAG,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,sBAAsB,GAAG,SAAS;IAI1E,MAAM,IAAI,sBAAsB,EAAE;IAIlC,KAAK,IAAI,MAAM;CAGhB;AAKD,wBAAgB,0BAA0B,CACxC,QAAQ,EAAE,uBAAuB,GAChC,IAAI,CAEN;AAED,wBAAgB,0BAA0B,IAAI,uBAAuB,CAIpE;AAED,4DAA4D;AAC5D,wBAAgB,4BAA4B,IAAI,IAAI,CAEnD"}
@@ -0,0 +1,117 @@
1
+ import type { Database } from "@hogsend/db";
2
+ import type { Logger } from "../lib/logger.js";
3
+ /**
4
+ * Connector OUTBOUND ACTIONS — the journey-callable, socket-free face of a
5
+ * connector. Distinct from event fan-out (the durable `emitOutbound` →
6
+ * destination spine): an action is an IMPERATIVE call a journey/workflow makes
7
+ * ("post this to #general", "@mention these members", "DM this user"). On
8
+ * Discord these are pure bot-REST calls needing only the bot token — so they run
9
+ * on ANY replica and are INDEPENDENT of the inbound gateway socket (a deployment
10
+ * with the gateway off can still send).
11
+ *
12
+ * A platform plugin contributes actions (e.g. `discordActions`); the consumer
13
+ * registers them via `createHogsendClient({ connectorActions })`. A journey
14
+ * invokes one through the standalone {@link sendConnectorAction} export (NOT on
15
+ * `ctx` — features are standalone imports, mirroring `sendEmail()`).
16
+ */
17
+ /** A contact resolved for an outbound action — a platform-neutral projection. */
18
+ export interface ResolvedActionContact {
19
+ id: string;
20
+ email: string | null;
21
+ discordId: string | null;
22
+ externalId: string | null;
23
+ /**
24
+ * Provenance (`contacts.source`) — the id of the origin that minted the
25
+ * contact ("api"/"posthog"/a Contact Source id like "clay"). Consulted by the
26
+ * cold-channel gate: a value naming a registered Contact Source classifies
27
+ * the contact as a cold prospect. OPTIONAL (additive) so pre-existing
28
+ * constructors of this public shape keep compiling; the engine's resolver
29
+ * always populates it, and an absent value is treated as "not a prospect"
30
+ * (fail open), matching the gate's posture.
31
+ */
32
+ source?: string | null;
33
+ properties: Record<string, unknown>;
34
+ }
35
+ export interface ConnectorActionCtx {
36
+ db: Database;
37
+ logger: Logger;
38
+ /**
39
+ * Resolve a contact by email, external id, or a platform id (e.g. a Discord
40
+ * snowflake). The engine owns the contacts schema, so a plugin action resolves
41
+ * a recipient WITHOUT coupling to `@hogsend/db`. Null when no live contact
42
+ * matches.
43
+ */
44
+ resolveContact(ref: string): Promise<ResolvedActionContact | null>;
45
+ }
46
+ /**
47
+ * Declares an action MEMBER-DIRECTED — aimed at an individual recipient rather
48
+ * than a channel/ops surface. Its presence gates the action on the recipient's
49
+ * channel preferences (the auto-registered per-connector opt-out list) before
50
+ * the plugin runs; enforcement lands in a later phase. Absent audience =
51
+ * ops/channel-directed = never gated.
52
+ */
53
+ export interface MemberAudience<A = unknown> {
54
+ kind: "member";
55
+ /**
56
+ * Candidate recipient refs (email | externalId | platform id | namespaced key
57
+ * like "telegram:<chatId>"), tried in order; first resolving contact wins.
58
+ * Returning undefined (or throwing) fails OPEN — the send proceeds.
59
+ *
60
+ * Method shorthand (bivariant) so a `DefinedConnectorAction<DmArgs, …>` stays
61
+ * assignable to the erased `DefinedConnectorAction[]` the registry/plugin
62
+ * index files use (same reason `run` is method shorthand).
63
+ */
64
+ ref(args: A): string | string[] | undefined;
65
+ }
66
+ export interface DefinedConnectorAction<A = unknown, R = unknown> {
67
+ /** The connector this action belongs to (e.g. "discord"). Keys the registry. */
68
+ connectorId: string;
69
+ /** Action name, unique within the connector (e.g. "sendChannelMessage"). */
70
+ name: string;
71
+ /** Optional human description (Studio enumeration / docs). */
72
+ description?: string;
73
+ /**
74
+ * When set, declares the action member-directed: the engine will gate it on
75
+ * the recipient's channel preferences before the plugin runs (enforcement
76
+ * lands in a later phase). Absent = ops/channel-directed = never gated.
77
+ */
78
+ audience?: MemberAudience<A>;
79
+ /** Perform the outbound action. Single-object-in, result-out. */
80
+ run(args: A, ctx: ConnectorActionCtx): Promise<R>;
81
+ }
82
+ /** Identity/validating authoring helper (mirrors `defineConnector`/`defineDestination`). */
83
+ export declare function defineConnectorAction<A, R>(def: DefinedConnectorAction<A, R>): DefinedConnectorAction<A, R>;
84
+ /**
85
+ * The verdict returned when the engine SKIPS a member-directed connector action
86
+ * because the resolved recipient opted out — either the global master opt-out
87
+ * (`unsubscribed_all`) or the per-connector channel list (`channel_unsubscribed`)
88
+ * — or because the recipient is a cold prospect (their `contacts.source` names a
89
+ * registered Contact Source) whose source posture blocks this connector's
90
+ * channel (`cold_channel_blocked`).
91
+ *
92
+ * A plain JSON-safe POJO so it is memo-recordable and replays VERBATIM through
93
+ * both the Hatchet durable `memo` (Layer 1) AND the `connector_deliveries.result`
94
+ * jsonb round-trip (Layer 2) — although a skip in practice NEVER writes a
95
+ * delivery row (the gate runs BEFORE the ledger claim), so a skip is observable
96
+ * only via logs + this returned value.
97
+ *
98
+ * The shape DELIBERATELY does NOT mimic per-action result shapes (it carries no
99
+ * `messageId`/`delivered`): the `skipped: true` discriminant must be
100
+ * unambiguous. An existing consumer reading `result.delivered` gets `undefined`
101
+ * (falsy) on a skip — which degrades in the correct direction (treated as "not
102
+ * delivered").
103
+ */
104
+ export interface ConnectorActionSkipped {
105
+ skipped: true;
106
+ reason: "unsubscribed_all" | "channel_unsubscribed" | "cold_channel_blocked";
107
+ connectorId: string;
108
+ action: string;
109
+ }
110
+ /**
111
+ * Narrow an outbound-action result to a {@link ConnectorActionSkipped} verdict.
112
+ * Checks a non-null object with `skipped === true` plus string
113
+ * `reason`/`connectorId`/`action` — enough to disambiguate from every per-action
114
+ * result shape.
115
+ */
116
+ export declare function isConnectorActionSkipped(r: unknown): r is ConnectorActionSkipped;
117
+ //# sourceMappingURL=define-action.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"define-action.d.ts","sourceRoot":"","sources":["../../src/connectors/define-action.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAE/C;;;;;;;;;;;;;GAaG;AACH,iFAAiF;AACjF,MAAM,WAAW,qBAAqB;IACpC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B;;;;;;;;OAQG;IACH,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACrC;AAED,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,QAAQ,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf;;;;;OAKG;IACH,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,GAAG,IAAI,CAAC,CAAC;CACpE;AAED;;;;;;GAMG;AACH,MAAM,WAAW,cAAc,CAAC,CAAC,GAAG,OAAO;IACzC,IAAI,EAAE,QAAQ,CAAC;IACf;;;;;;;;OAQG;IACH,GAAG,CAAC,IAAI,EAAE,CAAC,GAAG,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC;CAC7C;AAED,MAAM,WAAW,sBAAsB,CAAC,CAAC,GAAG,OAAO,EAAE,CAAC,GAAG,OAAO;IAC9D,gFAAgF;IAChF,WAAW,EAAE,MAAM,CAAC;IACpB,4EAA4E;IAC5E,IAAI,EAAE,MAAM,CAAC;IACb,8DAA8D;IAC9D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,cAAc,CAAC,CAAC,CAAC,CAAC;IAC7B,iEAAiE;IACjE,GAAG,CAAC,IAAI,EAAE,CAAC,EAAE,GAAG,EAAE,kBAAkB,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;CACnD;AAED,4FAA4F;AAC5F,wBAAgB,qBAAqB,CAAC,CAAC,EAAE,CAAC,EACxC,GAAG,EAAE,sBAAsB,CAAC,CAAC,EAAE,CAAC,CAAC,GAChC,sBAAsB,CAAC,CAAC,EAAE,CAAC,CAAC,CAE9B;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,IAAI,CAAC;IACd,MAAM,EAAE,kBAAkB,GAAG,sBAAsB,GAAG,sBAAsB,CAAC;IAC7E,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CACtC,CAAC,EAAE,OAAO,GACT,CAAC,IAAI,sBAAsB,CAS7B"}
@@ -0,0 +1,172 @@
1
+ import type { Database } from "@hogsend/db";
2
+ import type { z } from "zod";
3
+ import type { env as engineEnv } from "../env.js";
4
+ import type { ConnectorStateIntent } from "../lib/connector-state.js";
5
+ import type { IngestEvent } from "../lib/ingestion.js";
6
+ import type { Logger } from "../lib/logger.js";
7
+ import type { SignatureScheme, VerifySignatureArgs } from "../webhook-sources/verify.js";
8
+ /**
9
+ * The unified INBOUND connector abstraction. A connector is one platform's
10
+ * inbound face — it turns a raw platform payload into an {@link IngestEvent}
11
+ * via {@link DefinedConnector.transform}. The transform contract is IDENTICAL
12
+ * across transports; only the ACTIVATION RUNTIME differs:
13
+ *
14
+ * - `"webhook"` — an HTTP route (`POST /v1/webhooks/:id`) verifies the inbound
15
+ * request and calls `transform`. (The long-standing `defineWebhookSource`
16
+ * behavior, now one transport under this umbrella.)
17
+ * - `"gateway"` — a long-lived worker process (its OWN entrypoint / Railway
18
+ * service, NOT a Hatchet task) holds a socket to the platform, and on each
19
+ * platform event POSTs into this connector's own ingress
20
+ * (`POST /v1/connectors/:id/ingress`, shared internal secret) so ALL
21
+ * transform logic stays here and the socket worker stays dumb.
22
+ * - `"poll"` — a Hatchet cron pulls the platform on a schedule (using the
23
+ * stored credential) and runs `transform` per pulled item.
24
+ *
25
+ * The symmetric INBOUND twin of {@link DefinedDestination}.
26
+ * {@link defineConnector} is an identity / validating function.
27
+ */
28
+ export type ConnectorTransport = "webhook" | "gateway" | "poll";
29
+ /**
30
+ * INBOUND-REQUEST VERIFICATION — webhook transport only. "Does this HTTP
31
+ * request prove it came from the platform?" The EXACT pre-existing
32
+ * `WebhookSourceAuth` union, re-homed here (re-exported by
33
+ * define-webhook-source for back-compat). `match` = shared-secret equality
34
+ * (OPEN when unset); `signature` = provider HMAC (FAIL CLOSED when unset).
35
+ */
36
+ export type InboundVerifyAuth = {
37
+ type: "match";
38
+ header: string;
39
+ envKey: string;
40
+ } | {
41
+ type: "signature";
42
+ scheme: SignatureScheme;
43
+ envKey: string;
44
+ header: string;
45
+ fallbackMatchHeader?: string;
46
+ verify?(args: VerifySignatureArgs): boolean | Promise<boolean>;
47
+ };
48
+ /**
49
+ * STORED OUTBOUND CREDENTIAL — gateway/poll transports only. The connector PULLS
50
+ * from the platform and must present a credential. Declares WHICH
51
+ * `provider_credentials` row to read. The engine resolves the row at activation
52
+ * time and hands the decrypted material to the gateway worker / poll cron —
53
+ * never the transform. SEPARATE from {@link InboundVerifyAuth} by design.
54
+ */
55
+ export interface StoredCredentialRef {
56
+ /** `provider_credentials.providerId` to read (defaults to `meta.id`). */
57
+ providerId?: string;
58
+ /** Which credential kind the runtime resolves. Default `"oauth"`. */
59
+ kind?: "oauth" | "derived";
60
+ }
61
+ /**
62
+ * Side context handed to {@link DefinedConnector.transform}. A superset of the
63
+ * old `WebhookSourceCtx`: `rawBody`/`headers` are populated by the webhook
64
+ * route; `transport` lets a shared transform branch when a platform feeds more
65
+ * than one transport.
66
+ */
67
+ export interface ConnectorCtx {
68
+ db: Database;
69
+ logger: Logger;
70
+ /** Which activation runtime invoked the transform. */
71
+ transport: ConnectorTransport;
72
+ /** Webhook transport only — EXACT raw request bytes. */
73
+ rawBody?: string;
74
+ /** Webhook transport only — inbound request headers (lowercased keys). */
75
+ headers?: Record<string, string>;
76
+ }
77
+ export interface ConnectorMeta {
78
+ id: string;
79
+ name: string;
80
+ description?: string;
81
+ /** The activation runtime. Defaults to `"webhook"` (back-compat). */
82
+ transport?: ConnectorTransport;
83
+ }
84
+ /**
85
+ * Minimal handler context for the generic connector routes. `env` is the EXACT
86
+ * validated engine env object (number/boolean fields included) — NOT a string
87
+ * Record — so the route can pass `c.get("container").env` straight through.
88
+ */
89
+ export interface ConnectorRouteCtx {
90
+ db: Database;
91
+ logger: Logger;
92
+ env: typeof engineEnv;
93
+ /** Public base URL of this instance (redirect-URI construction). */
94
+ apiPublicUrl: string;
95
+ }
96
+ export type ConnectorOAuthResult = {
97
+ kind: "redirect";
98
+ location: string;
99
+ } | {
100
+ kind: "json";
101
+ status: number;
102
+ body: unknown;
103
+ } | {
104
+ kind: "html";
105
+ status: number;
106
+ body: string;
107
+ };
108
+ export type ConnectorInteractionResult = {
109
+ kind: "ack";
110
+ status?: number;
111
+ body?: unknown;
112
+ } | {
113
+ kind: "ingest";
114
+ event: IngestEvent;
115
+ } | {
116
+ kind: "unauthorized";
117
+ };
118
+ /**
119
+ * OPTIONAL per-connector OAuth + interactions hooks dispatched by the GENERIC
120
+ * engine routes (mirrors how `/v1/webhooks/:sourceId` dispatches `transform`),
121
+ * so platform #3 needs no new routes.
122
+ *
123
+ * - `oauthCallback` — handle `GET|POST /v1/connectors/:id/oauth/callback`:
124
+ * exchange the code, persist into `provider_credentials`, return a
125
+ * redirect/JSON result. The connector imports the engine's credential-save
126
+ * helpers directly (they are public exports). The ENGINE owns CSRF `state`
127
+ * verification GENERICALLY (the route verifies the signed state before
128
+ * dispatch and hands the decoded {@link ConnectorStateIntent} in as `state`);
129
+ * the handler must NOT re-verify the raw query `state`.
130
+ * - `interactions` — handle `POST /v1/connectors/:id/interactions`: the
131
+ * connector verifies the platform signature ITSELF (Discord ed25519), may
132
+ * 200 a handshake (Discord PING), and may return an {@link IngestEvent}.
133
+ */
134
+ export interface ConnectorHandlers {
135
+ oauthCallback?(args: {
136
+ query: Record<string, string>;
137
+ body: unknown;
138
+ /** Engine-verified, decoded OAuth `state` (CSRF + member-link binding). */
139
+ state: ConnectorStateIntent;
140
+ ctx: ConnectorRouteCtx;
141
+ }): Promise<ConnectorOAuthResult>;
142
+ interactions?(args: {
143
+ rawBody: string;
144
+ headers: Record<string, string>;
145
+ ctx: ConnectorRouteCtx;
146
+ }): Promise<ConnectorInteractionResult>;
147
+ }
148
+ export interface DefinedConnector<T = unknown> {
149
+ meta: ConnectorMeta;
150
+ /**
151
+ * Inbound-request verification — REQUIRED for `transport: "webhook"`,
152
+ * forbidden otherwise.
153
+ */
154
+ inboundVerify?: InboundVerifyAuth;
155
+ /** Stored outbound credential to pull with — used by `gateway`/`poll`. */
156
+ credential?: StoredCredentialRef;
157
+ /** Optional Zod schema validating the payload BEFORE transform. */
158
+ schema?: z.ZodSchema<T>;
159
+ /**
160
+ * The transport-invariant heart: raw platform payload →
161
+ * `IngestEvent | IngestEvent[] | null`. Returning an ARRAY fans one inbound
162
+ * dispatch into multiple subject-keyed events (e.g. a Discord reaction →
163
+ * reactor-keyed `reaction_added` + author-keyed `reaction_received`); each
164
+ * element ingests independently with its own idempotencyKey (see
165
+ * `ingestTransformResult`).
166
+ */
167
+ transform(payload: T, ctx: ConnectorCtx): Promise<IngestEvent | IngestEvent[] | null>;
168
+ /** OPTIONAL OAuth + interactions hooks for the generic dispatch routes. */
169
+ handlers?: ConnectorHandlers;
170
+ }
171
+ export declare function defineConnector<T>(def: DefinedConnector<T>): DefinedConnector<T>;
172
+ //# sourceMappingURL=define-connector.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"define-connector.d.ts","sourceRoot":"","sources":["../../src/connectors/define-connector.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,17 @@
1
+ import type { env as engineEnv } from "../../env.js";
2
+ import type { DefinedConnector } from "../define-connector.js";
3
+ /**
4
+ * Every shipped connector preset, keyed by id. Webhook-transport presets are
5
+ * the existing `defineWebhookSource` presets lifted onto the umbrella; gateway/
6
+ * poll presets (Discord) are SHIPPED IN THE PLUGIN, not here — the engine
7
+ * bundles no Discord code.
8
+ */
9
+ export declare const PRESET_CONNECTORS: Record<string, DefinedConnector>;
10
+ /**
11
+ * Resolve which connector presets to register from env. Webhook presets keep
12
+ * their exact env-secret gating (delegated to `presetsFromEnv`). Gateway/poll
13
+ * presets are consumer-supplied via `opts.connectors` (the Discord plugin), so
14
+ * this preset resolver covers only the engine-shipped webhook presets.
15
+ */
16
+ export declare function connectorsFromEnv(env: typeof engineEnv): DefinedConnector[];
17
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/connectors/presets/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,IAAI,SAAS,EAAE,MAAM,cAAc,CAAC;AASrD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE/D;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAS5D,CAAC;AAEJ;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,OAAO,SAAS,GAAG,gBAAgB,EAAE,CAE3E"}
@@ -0,0 +1,34 @@
1
+ import type { ConnectorTransport, DefinedConnector } from "./define-connector.js";
2
+ /**
3
+ * The process-wide connector registry, set once by `createHogsendClient` at
4
+ * startup. Mirrors {@link DestinationRegistry}: keyed by `meta.id`,
5
+ * last-writer-wins on collision, with a lazy preset-only fallback so a
6
+ * self-booting context (a bare poll cron, a test harness) still resolves the
7
+ * shipped presets even before any container ran.
8
+ *
9
+ * Read by: the webhook route (`getByTransport("webhook")`), the generic
10
+ * `/v1/connectors/:id/*` routes (`get(id)` → `handlers`), the poll-cron
11
+ * registrar, and the gateway launcher.
12
+ */
13
+ export declare class ConnectorRegistry {
14
+ private readonly byId;
15
+ constructor(connectors?: DefinedConnector[]);
16
+ /** Register / overwrite a connector (last-writer-wins). */
17
+ register(connector: DefinedConnector): void;
18
+ /**
19
+ * Remove a connector by id (no-op when absent). Used by the deprecated
20
+ * `createApp({ enablePresets: false })` strip path to suppress env presets the
21
+ * container already installed.
22
+ */
23
+ unregister(id: string): boolean;
24
+ get(id: string): DefinedConnector | undefined;
25
+ getAll(): DefinedConnector[];
26
+ /** Every connector whose (defaulted) transport matches. */
27
+ getByTransport(transport: ConnectorTransport): DefinedConnector[];
28
+ count(): number;
29
+ }
30
+ export declare function setConnectorRegistry(registry: ConnectorRegistry): void;
31
+ export declare function getConnectorRegistry(): ConnectorRegistry;
32
+ /** Reset the installed registry — only for test cleanup. */
33
+ export declare function resetConnectorRegistry(): void;
34
+ //# sourceMappingURL=registry-singleton.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"registry-singleton.d.ts","sourceRoot":"","sources":["../../src/connectors/registry-singleton.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,kBAAkB,EAClB,gBAAgB,EACjB,MAAM,uBAAuB,CAAC;AAG/B;;;;;;;;;;GAUG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAuC;gBAEhD,UAAU,GAAE,gBAAgB,EAAO;IAM/C,2DAA2D;IAC3D,QAAQ,CAAC,SAAS,EAAE,gBAAgB,GAAG,IAAI;IAI3C;;;;OAIG;IACH,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAI/B,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS;IAI7C,MAAM,IAAI,gBAAgB,EAAE;IAI5B,2DAA2D;IAC3D,cAAc,CAAC,SAAS,EAAE,kBAAkB,GAAG,gBAAgB,EAAE;IAMjE,KAAK,IAAI,MAAM;CAGhB;AAKD,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,iBAAiB,GAAG,IAAI,CAEtE;AAED,wBAAgB,oBAAoB,IAAI,iBAAiB,CAMxD;AAED,4DAA4D;AAC5D,wBAAgB,sBAAsB,IAAI,IAAI,CAE7C"}
@@ -0,0 +1,68 @@
1
+ import type { HogsendClient } from "../container.js";
2
+ import type { Logger } from "../lib/logger.js";
3
+ /**
4
+ * The connector-agnostic INBOUND RUNTIME seam. A `gateway`-transport connector
5
+ * (Discord today, Slack tomorrow) needs a long-lived process holding a socket to
6
+ * the platform. Rather than a hand-wired standalone service per consumer, the
7
+ * engine boots that runtime INLINE inside the process every consumer already
8
+ * runs (the Hatchet worker by default), gated by a Redis LEADER LEASE so exactly
9
+ * ONE replica ever holds the socket — one bot token permits one live session.
10
+ *
11
+ * A platform plugin contributes a {@link ConnectorRuntimeFactory} (supplied to
12
+ * `createWorker({ connectorRuntimes })`); the engine owns everything
13
+ * platform-neutral: lease election, the in-process dispatch→transform→ingest
14
+ * sink (no HTTP hop, no shared secret), the owned heartbeat, and shutdown
15
+ * ordering. A second connector reuses this verbatim — it only writes a
16
+ * `defineConnector` + a runtime factory, and touches zero engine code.
17
+ */
18
+ /** The minimal long-lived runtime a platform plugin supplies (e.g. a discord.js socket). */
19
+ export interface ConnectorRuntime {
20
+ /** Open the socket. Rejects loudly on a fatal config error (bad token/intents). */
21
+ start(): Promise<void>;
22
+ /** Close the socket and clear timers (awaited on demotion / shutdown). */
23
+ stop(): Promise<void>;
24
+ /** Platform metadata to fold into the heartbeat (e.g. `{ intents }`). */
25
+ getMetadata(): Record<string, unknown>;
26
+ }
27
+ /**
28
+ * What the engine injects into a runtime factory. `ingest` is the in-process
29
+ * sink: hand it a raw platform dispatch and the engine runs the connector's own
30
+ * `transform` then `ingestEvent` — the EXACT pair the HTTP ingress route runs,
31
+ * minus the network hop. `onMetadata` folds a late-observed field (e.g. the
32
+ * guild id seen at GUILD_CREATE) into the live heartbeat.
33
+ */
34
+ export interface ConnectorRuntimeDeps {
35
+ ingest(dispatchType: string, data: unknown): Promise<{
36
+ ok: boolean;
37
+ status: number;
38
+ }>;
39
+ onMetadata(patch: Record<string, unknown>): void;
40
+ logger: Logger;
41
+ }
42
+ /**
43
+ * Build a runtime for a connector, or return `null` when it is not configured to
44
+ * run here (e.g. the platform's bot token env is unset) — the engine then simply
45
+ * skips it without holding a lease.
46
+ */
47
+ export type ConnectorRuntimeFactory = (deps: ConnectorRuntimeDeps) => ConnectorRuntime | null;
48
+ export interface ConnectorRuntimesHandle {
49
+ /** Release every lease + delete heartbeats BEFORE stopping sockets. */
50
+ stop(): Promise<void>;
51
+ }
52
+ export interface StartConnectorRuntimesArgs {
53
+ client: HogsendClient;
54
+ /** Platform runtime factories keyed by connector id (from createWorker opts). */
55
+ factories: Record<string, ConnectorRuntimeFactory>;
56
+ }
57
+ /**
58
+ * Boot the inline runtimes for every registered `gateway`-transport connector
59
+ * that has a supplied factory. Fire-and-forget per connector (each runs its own
60
+ * lease loop); returns a handle whose `stop()` releases all leases + deletes
61
+ * heartbeats before stopping sockets (graceful, heartbeat-first ordering).
62
+ *
63
+ * No-ops cleanly when there are no gateway connectors, no factories, or a
64
+ * factory declines (returns null) — so a deploy with nothing configured carries
65
+ * zero cost.
66
+ */
67
+ export declare function startConnectorRuntimes(args: StartConnectorRuntimesArgs): ConnectorRuntimesHandle;
68
+ //# sourceMappingURL=runtime.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../src/connectors/runtime.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAYrD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAG/C;;;;;;;;;;;;;;GAcG;AAEH,4FAA4F;AAC5F,MAAM,WAAW,gBAAgB;IAC/B,mFAAmF;IACnF,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,0EAA0E;IAC1E,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACtB,yEAAyE;IACzE,WAAW,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACxC;AAED;;;;;;GAMG;AACH,MAAM,WAAW,oBAAoB;IACnC,MAAM,CACJ,YAAY,EAAE,MAAM,EACpB,IAAI,EAAE,OAAO,GACZ,OAAO,CAAC;QAAE,EAAE,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC5C,UAAU,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACjD,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;GAIG;AACH,MAAM,MAAM,uBAAuB,GAAG,CACpC,IAAI,EAAE,oBAAoB,KACvB,gBAAgB,GAAG,IAAI,CAAC;AAE7B,MAAM,WAAW,uBAAuB;IACtC,uEAAuE;IACvE,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACvB;AAmMD,MAAM,WAAW,0BAA0B;IACzC,MAAM,EAAE,aAAa,CAAC;IACtB,iFAAiF;IACjF,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,uBAAuB,CAAC,CAAC;CACpD;AAED;;;;;;;;;GASG;AACH,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,0BAA0B,GAC/B,uBAAuB,CA+BzB"}