@hogsend/engine 0.66.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 (760) 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/container.ts +77 -0
  708. package/src/env.ts +30 -0
  709. package/src/index.ts +78 -0
  710. package/src/journeys/journey-log.ts +25 -8
  711. package/src/lib/contacts.ts +117 -1
  712. package/src/lib/email-service-types.ts +10 -0
  713. package/src/lib/ingestion.ts +91 -19
  714. package/src/lib/links.ts +94 -11
  715. package/src/lib/mailer-bounce-idempotency.test.ts +7 -2
  716. package/src/lib/mailer-replied.test.ts +7 -2
  717. package/src/lib/mailer.ts +1 -0
  718. package/src/lib/outbound-endpoint-cache.ts +83 -0
  719. package/src/lib/outbound.ts +150 -37
  720. package/src/lib/referral-intent.ts +723 -0
  721. package/src/lib/referral-link.ts +200 -0
  722. package/src/lib/referral-registry.ts +83 -0
  723. package/src/lib/referral-report.ts +739 -0
  724. package/src/lib/referral-runtime.ts +49 -0
  725. package/src/lib/referrals-no-emit.test.ts +109 -0
  726. package/src/lib/referrals.ts +712 -0
  727. package/src/lib/seed-posthog-destination.ts +5 -1
  728. package/src/lib/tracked.ts +11 -3
  729. package/src/lib/tracking-events.ts +20 -3
  730. package/src/lib/webhook-signing.ts +10 -0
  731. package/src/middleware/api-key.ts +69 -60
  732. package/src/middleware/publishable-key.ts +11 -23
  733. package/src/middleware/rate-limit.ts +165 -3
  734. package/src/routes/admin/api-keys.ts +153 -0
  735. package/src/routes/admin/index.ts +2 -0
  736. package/src/routes/admin/links.ts +14 -5
  737. package/src/routes/admin/referrals.ts +565 -0
  738. package/src/routes/admin/targeting.ts +6 -1
  739. package/src/routes/admin/webhooks.ts +4 -0
  740. package/src/routes/contacts/index.ts +78 -0
  741. package/src/routes/index.ts +104 -22
  742. package/src/routes/referrals/index.ts +41 -0
  743. package/src/routes/referrals/me.ts +123 -0
  744. package/src/routes/referrals/report.ts +285 -0
  745. package/src/routes/referrals/shared.ts +34 -0
  746. package/src/routes/referrals/touch.ts +313 -0
  747. package/src/routes/tracking/arrive.ts +90 -0
  748. package/src/routes/tracking/click-pipeline.ts +8 -0
  749. package/src/workflows/backfill-contact-id.ts +3 -7
  750. package/src/workflows/bucket-backfill.ts +2 -2
  751. package/src/workflows/bucket-reconcile.ts +28 -12
  752. package/src/workflows/check-alerts.ts +3 -9
  753. package/src/workflows/crm-reconcile.ts +3 -2
  754. package/src/workflows/deliver-webhook.ts +21 -8
  755. package/src/workflows/dispatch-conversion.ts +2 -2
  756. package/src/workflows/identity-alias-backfill.ts +3 -2
  757. package/src/workflows/impact-digest.ts +2 -2
  758. package/src/workflows/import-contacts.ts +3 -4
  759. package/src/workflows/import-suppressions.ts +4 -5
  760. package/src/workflows/send-campaign.ts +10 -1
@@ -1,3 +1,4 @@
1
+ import { DEFAULT_REFERRAL_ID } from "@hogsend/core";
1
2
  import { linkClicks, links, trackedLinks } from "@hogsend/db";
2
3
  import { createRoute, OpenAPIHono, z } from "@hono/zod-openapi";
3
4
  import { and, eq, isNull } from "drizzle-orm";
@@ -5,9 +6,11 @@ import type { AppEnv } from "../../app.js";
5
6
  import {
6
7
  collidesWithIdentified,
7
8
  PublishableAnonymousMergeError,
9
+ resolveContactNoCreate,
8
10
  } from "../../lib/contacts.js";
9
11
  import { ingestEvent } from "../../lib/ingestion.js";
10
12
  import { emitOutbound } from "../../lib/outbound.js";
13
+ import { touchReferral } from "../../lib/referral-intent.js";
11
14
  import { LINK_ARRIVED } from "../../lib/tracking-event-names.js";
12
15
  import {
13
16
  InvalidUserTokenError,
@@ -104,6 +107,11 @@ export const arriveRouter = new OpenAPIHono<AppEnv>().openapi(
104
107
  source: trackedLinks.source,
105
108
  linkId: links.id,
106
109
  campaign: links.campaign,
110
+ // Referral provenance: a `shared` link is owned by a person and
111
+ // clicked by someone else, so an arrival on one is a referral TOUCH.
112
+ linkType: links.type,
113
+ ownerContactId: links.ownerContactId,
114
+ referralId: links.referralId,
107
115
  })
108
116
  .from(linkClicks)
109
117
  .innerJoin(trackedLinks, eq(linkClicks.trackedLinkId, trackedLinks.id))
@@ -294,6 +302,88 @@ export const arriveRouter = new OpenAPIHono<AppEnv>().openapi(
294
302
  });
295
303
  }
296
304
 
305
+ // --- REFERRAL TOUCH -----------------------------------------------------
306
+ // ARRIVE, not the click, is where a cold referral touch can be recorded:
307
+ // a `shared` link carries no `distinct_id` (it stitches nobody), so the
308
+ // click itself knows the referrer but NOT the clicker. The `hs_ref` the
309
+ // redirect appended is what brings the two together here, which is why
310
+ // `getReferralLink` always mints with `appendRef: true`.
311
+ //
312
+ // The touch is written from the STAMPED identity, exactly like the ingest
313
+ // above, so a replayed ref cannot re-attribute; `clickId = ref` is the
314
+ // store's replay key, so a replay is a no-op rather than a second edge.
315
+ // No contact is minted on the anon leg: `refereeKey` is the raw anonymous
316
+ // id and the store writes it VERBATIM to `referral_touches.referee_key`,
317
+ // which is the value `adoptOrphanHistory` will bind against at identify.
318
+ await recordReferralArrival({
319
+ container: c.get("container"),
320
+ hit,
321
+ ref,
322
+ refereeKey: stamp.visitorDistinctId,
323
+ isToken,
324
+ }).catch((err: unknown) => {
325
+ logger.warn("arrive: referral touch failed", {
326
+ ref,
327
+ error: err instanceof Error ? err.message : String(err),
328
+ });
329
+ });
330
+
297
331
  return ok();
298
332
  },
299
333
  );
334
+
335
+ /**
336
+ * Record the referral touch for an arrival, when the link is a `shared` link
337
+ * belonging to a REGISTERED referral. Every other case is a silent no-op:
338
+ * a non-shared link, an owner-less link, an unregistered referral id (the
339
+ * program was deleted from code) and a self-arrival all leave no row.
340
+ */
341
+ async function recordReferralArrival(opts: {
342
+ container: AppEnv["Variables"]["container"];
343
+ hit: {
344
+ linkId: string;
345
+ linkType: string | null;
346
+ ownerContactId: string | null;
347
+ referralId: string | null;
348
+ };
349
+ ref: string;
350
+ refereeKey: string;
351
+ isToken: boolean;
352
+ }): Promise<void> {
353
+ const { container, hit, ref, refereeKey, isToken } = opts;
354
+ if (hit.linkType !== "shared" || !hit.ownerContactId) return;
355
+ const referral = container.referrals.get(
356
+ hit.referralId ?? DEFAULT_REFERRAL_ID,
357
+ );
358
+ if (!referral) return;
359
+
360
+ // A TOKEN arrival is a server-minted identity assertion, so the toucher is a
361
+ // known person and the touch binds immediately (the store's self-check
362
+ // applies). An ANON arrival has no contact: it stays one-ended until the
363
+ // visitor identifies. Resolving the token leg's contact must never CREATE
364
+ // one, so it goes through the no-create resolver.
365
+ let refereeContactId: string | null = null;
366
+ if (isToken) {
367
+ const resolved = await resolveContactNoCreate({
368
+ db: container.db,
369
+ userId: refereeKey,
370
+ });
371
+ refereeContactId = resolved.id;
372
+ }
373
+
374
+ await touchReferral({
375
+ db: container.db,
376
+ hatchet: container.hatchet,
377
+ registry: container.registry,
378
+ logger: container.logger,
379
+ ...(container.analytics ? { analytics: container.analytics } : {}),
380
+ referrals: container.referrals,
381
+ referral,
382
+ referrerContactId: hit.ownerContactId,
383
+ refereeKey,
384
+ refereeContactId,
385
+ linkId: hit.linkId,
386
+ clickId: ref,
387
+ source: "link",
388
+ });
389
+ }
@@ -159,6 +159,14 @@ export async function handleTrackedClick(
159
159
  : []),
160
160
  ]);
161
161
 
162
+ // REFERRAL LINKS (`type: "shared"`) record no touch HERE, deliberately. A
163
+ // shared link stitches nobody (it carries no `distinct_id`), so the click
164
+ // knows the referrer but has no key at all for the CLICKER — and inventing
165
+ // one from the click id would mint an edge to a person who never arrives.
166
+ // The referee's anonymous id first exists at `POST /v1/t/arrive`, reported
167
+ // back with the `hs_ref` the redirect appends, which is where the touch is
168
+ // written (`routes/tracking/arrive.ts`). `getReferralLink` therefore always
169
+ // mints with `appendRef: true`.
162
170
  const { hatchet, registry, logger } = c.get("container");
163
171
 
164
172
  // SEMANTIC link: the click is a PROVISIONAL answer. Confirmation is
@@ -1,12 +1,8 @@
1
1
  import type { JsonObject } from "@hatchet-dev/typescript-sdk/v1/types.js";
2
- import {
3
- contacts,
4
- createDatabase,
5
- type Database,
6
- importJobs,
7
- } from "@hogsend/db";
2
+ import { contacts, type Database, importJobs } from "@hogsend/db";
8
3
  import { and, desc, eq, gt, inArray, isNull, type SQL, sql } from "drizzle-orm";
9
4
  import { contactKeySql } from "../lib/contacts.js";
5
+ import { getDb } from "../lib/db.js";
10
6
  import { hatchet } from "../lib/hatchet.js";
11
7
  import type { Logger } from "../lib/logger.js";
12
8
  import { createLogger } from "../lib/logger.js";
@@ -836,7 +832,7 @@ export const contactIdBackfillTask = hatchet.task({
836
832
  // timeout is not lost — the next re-sweep resumes it for free.
837
833
  executionTimeout: "3600s",
838
834
  fn: async (input: ContactIdBackfillInput) => {
839
- const { db } = createDatabase({ url: process.env.DATABASE_URL ?? "" });
835
+ const db = getDb();
840
836
  const logger = createLogger(process.env.LOG_LEVEL ?? "info");
841
837
  return runContactIdBackfill({
842
838
  db,
@@ -10,7 +10,6 @@ import {
10
10
  bucketConfigs,
11
11
  bucketMemberships,
12
12
  contacts,
13
- createDatabase,
14
13
  type Database,
15
14
  importJobs,
16
15
  userEvents,
@@ -35,6 +34,7 @@ import { getBucketRegistrySingleton } from "../buckets/registry-singleton.js";
35
34
  import { getJourneyRegistrySingleton } from "../journeys/registry-singleton.js";
36
35
  import { emitBucketTransition } from "../lib/bucket-emit.js";
37
36
  import { contactKeySql, normalizeEmailOrNull } from "../lib/contacts.js";
37
+ import { getDb } from "../lib/db.js";
38
38
  import { hatchet } from "../lib/hatchet.js";
39
39
  import type { Logger } from "../lib/logger.js";
40
40
  import { createLogger } from "../lib/logger.js";
@@ -108,7 +108,7 @@ export const bucketBackfillTask = hatchet.task({
108
108
  retries: 0,
109
109
  executionTimeout: "600s",
110
110
  fn: async (input: BucketBackfillInput) => {
111
- const { db } = createDatabase({ url: process.env.DATABASE_URL ?? "" });
111
+ const db = getDb();
112
112
  const logger = createLogger(process.env.LOG_LEVEL ?? "info");
113
113
  const registry = getBucketRegistrySingleton();
114
114
  const journeyRegistry = getJourneyRegistrySingleton();
@@ -12,7 +12,6 @@ import {
12
12
  bucketConfigs,
13
13
  bucketMemberships,
14
14
  contacts,
15
- createDatabase,
16
15
  type Database,
17
16
  importJobs,
18
17
  userEvents,
@@ -46,6 +45,7 @@ import {
46
45
  lookupContactIdByKey,
47
46
  normalizeEmailOrNull,
48
47
  } from "../lib/contacts.js";
48
+ import { getDb } from "../lib/db.js";
49
49
  import { hatchet } from "../lib/hatchet.js";
50
50
  import { toSleepDuration } from "../lib/hatchet-duration.js";
51
51
  import type { Logger } from "../lib/logger.js";
@@ -93,7 +93,7 @@ export const bucketReconcileTask = hatchet.task({
93
93
  limitStrategy: ConcurrencyLimitStrategy.GROUP_ROUND_ROBIN,
94
94
  },
95
95
  fn: async () => {
96
- const { db } = createDatabase({ url: process.env.DATABASE_URL ?? "" });
96
+ const db = getDb();
97
97
  const logger = createLogger(process.env.LOG_LEVEL ?? "info");
98
98
  const registry = getBucketRegistrySingleton();
99
99
  const journeyRegistry = getJourneyRegistrySingleton();
@@ -237,7 +237,7 @@ export const bucketExpiryTask = hatchet.durableTask({
237
237
  onEvents: [`${BUCKET_EVENT_PREFIX}arm-expiry`],
238
238
  retries: 0,
239
239
  fn: async (input: BucketArmExpiryInput, ctx) => {
240
- const { db } = createDatabase({ url: process.env.DATABASE_URL ?? "" });
240
+ const db = getDb();
241
241
  const logger = createLogger(process.env.LOG_LEVEL ?? "info");
242
242
  const registry = getBucketRegistrySingleton();
243
243
  const journeyRegistry = getJourneyRegistrySingleton();
@@ -600,14 +600,7 @@ async function reconcileBucketTtlLeaves(opts: {
600
600
  });
601
601
  }
602
602
 
603
- /**
604
- * Bulk compare-and-swap a set of active members to `left`, then emit `bucket:left`
605
- * for each row the UPDATE actually flipped (gated on RETURNING — the loser of a
606
- * concurrent race mutates zero rows and never emits, Section 6.3). minDwell defers:
607
- * a member still inside its dwell window is NOT left here (the dwell deadline is
608
- * carried on `expiresAt`; the next eligible tick leaves it).
609
- */
610
- async function bulkLeave(opts: {
603
+ interface BulkLeaveOpts {
611
604
  db: Database;
612
605
  logger: Logger;
613
606
  journeyRegistry: ReturnType<typeof getJourneyRegistrySingleton>;
@@ -615,7 +608,30 @@ async function bulkLeave(opts: {
615
608
  leavers: BucketLeaver[];
616
609
  /** Why these members leave — TTL passes "maxDwell", criteria passes "criteria". */
617
610
  reason: BucketLeaveReason;
618
- }): Promise<number> {
611
+ }
612
+
613
+ /**
614
+ * Bulk compare-and-swap a set of active members to `left`, then emit `bucket:left`
615
+ * for each row the UPDATE actually flipped (gated on RETURNING — the loser of a
616
+ * concurrent race mutates zero rows and never emits, Section 6.3). minDwell defers:
617
+ * a member still inside its dwell window is NOT left here (the dwell deadline is
618
+ * carried on `expiresAt`; the next eligible tick leaves it).
619
+ */
620
+ async function bulkLeave(opts: BulkLeaveOpts): Promise<number> {
621
+ // Chunked: one `inArray` over a mass expiry (backfill stamps one maxDwellAt
622
+ // on a whole cohort) exceeds postgres.js's 65,534-parameter limit and throws
623
+ // on every tick. Flip + emit per BATCH_SIZE chunk so each tick makes progress.
624
+ let flipped = 0;
625
+ for (let i = 0; i < opts.leavers.length; i += BATCH_SIZE) {
626
+ flipped += await bulkLeaveChunk({
627
+ ...opts,
628
+ leavers: opts.leavers.slice(i, i + BATCH_SIZE),
629
+ });
630
+ }
631
+ return flipped;
632
+ }
633
+
634
+ async function bulkLeaveChunk(opts: BulkLeaveOpts): Promise<number> {
619
635
  const { db, logger, journeyRegistry, bucket, leavers, reason } = opts;
620
636
  const userIds = leavers.map((l) => l.userId);
621
637
  // Membership key → resolved contact row id, for the emit's provenance pin.
@@ -1,11 +1,7 @@
1
- import {
2
- createDatabase,
3
- type Database,
4
- emailSends,
5
- journeyStates,
6
- } from "@hogsend/db";
1
+ import { type Database, emailSends, journeyStates } from "@hogsend/db";
7
2
  import { and, eq, gte, isNull, sql } from "drizzle-orm";
8
3
  import { checkAlertRules } from "../lib/alerting.js";
4
+ import { getDb } from "../lib/db.js";
9
5
  import { hatchet } from "../lib/hatchet.js";
10
6
  import { createLogger, type Logger } from "../lib/logger.js";
11
7
 
@@ -199,9 +195,7 @@ export const checkAlertsTask = hatchet.task({
199
195
  retries: 1,
200
196
  executionTimeout: "60s",
201
197
  fn: async () => {
202
- const { db } = createDatabase({
203
- url: process.env.DATABASE_URL ?? "",
204
- });
198
+ const db = getDb();
205
199
  const logger = createLogger(process.env.LOG_LEVEL ?? "info");
206
200
 
207
201
  await surfaceRecentFailures({ db, logger });
@@ -1,10 +1,11 @@
1
1
  import { ConcurrencyLimitStrategy } from "@hatchet-dev/typescript-sdk/v1/index.js";
2
- import { createDatabase, crmSyncCursors, type Database } from "@hogsend/db";
2
+ import { crmSyncCursors, type Database } from "@hogsend/db";
3
3
  import { eq } from "drizzle-orm";
4
4
  import { getJourneyRegistrySingleton } from "../journeys/registry-singleton.js";
5
5
  import { getAnalytics } from "../lib/analytics-singleton.js";
6
6
  import { ingestCrmStageEvents } from "../lib/crm-ingest.js";
7
7
  import { getCrmSyncConfig } from "../lib/crm-registry-singleton.js";
8
+ import { getDb } from "../lib/db.js";
8
9
  import { hatchet } from "../lib/hatchet.js";
9
10
  import { createLogger, type Logger } from "../lib/logger.js";
10
11
 
@@ -122,7 +123,7 @@ export const crmReconcileTask = hatchet.task({
122
123
  limitStrategy: ConcurrencyLimitStrategy.GROUP_ROUND_ROBIN,
123
124
  },
124
125
  fn: async () => {
125
- const { db } = createDatabase({ url: process.env.DATABASE_URL ?? "" });
126
+ const db = getDb();
126
127
  const logger = createLogger(process.env.LOG_LEVEL ?? "info");
127
128
  return runCrmReconcile({ db, logger });
128
129
  },
@@ -121,14 +121,22 @@ export const deliverWebhookTask = hatchet.task({
121
121
  return { status: row.status, skipped: true };
122
122
  }
123
123
 
124
- // (2) Load the endpoint. Absent (cascade-deleted) OR disabled → `discarded`:
125
- // an operator action, NOT a delivery error, so it is NOT dead-lettered.
124
+ // (2) Load the endpoint. Absent (cascade-deleted), disabled, or no longer
125
+ // subscribed to this event → `discarded`: an operator action, NOT a
126
+ // delivery error, so it is NOT dead-lettered. The subscription re-check
127
+ // matters because emitters read endpoints from a short cache
128
+ // (lib/outbound-endpoint-cache.ts). A `webhook.test` delivery is sent on
129
+ // request and is exempt.
126
130
  const [endpoint] = await db
127
131
  .select()
128
132
  .from(webhookEndpoints)
129
133
  .where(eq(webhookEndpoints.id, row.endpointId))
130
134
  .limit(1);
131
- if (!endpoint || endpoint.disabled) {
135
+ const unsubscribed =
136
+ !!endpoint &&
137
+ row.eventType !== "webhook.test" &&
138
+ !(endpoint.eventTypes as readonly string[]).includes(row.eventType);
139
+ if (!endpoint || endpoint.disabled || unsubscribed) {
132
140
  await db
133
141
  .update(webhookDeliveries)
134
142
  .set({
@@ -139,9 +147,11 @@ export const deliverWebhookTask = hatchet.task({
139
147
  .where(eq(webhookDeliveries.id, row.id));
140
148
  return {
141
149
  status: "discarded" as const,
142
- reason: endpoint
143
- ? ("endpoint_disabled" as const)
144
- : ("endpoint_deleted" as const),
150
+ reason: !endpoint
151
+ ? ("endpoint_deleted" as const)
152
+ : endpoint.disabled
153
+ ? ("endpoint_disabled" as const)
154
+ : ("event_unsubscribed" as const),
145
155
  };
146
156
  }
147
157
 
@@ -420,7 +430,7 @@ const REAPER_BATCH = 500;
420
430
  * never reached a terminal write) is re-driven once it is older than
421
431
  * `STUCK_AFTER_MS` (measured from `updatedAt`, which step 3's CAS bumped).
422
432
  *
423
- * Recovery is `deliverWebhookTask.run({ deliveryId })`; the delivery task's own
433
+ * Recovery is `deliverWebhookTask.runNoWait({ deliveryId })`; the delivery task's own
424
434
  * `sending` CAS guard makes an overlap with a still-live run safe (the loser
425
435
  * no-ops). Self-bootstraps `db`/`logger` from `process.env` (cron runs have no
426
436
  * request container).
@@ -462,7 +472,10 @@ export const reapDueWebhookDeliveriesTask = hatchet.task({
462
472
  let reDriven = 0;
463
473
  for (const row of due) {
464
474
  try {
465
- await deliverWebhookTask.run({ deliveryId: row.id });
475
+ // Enqueue, don't await completion: up to REAPER_BATCH serial `.run()`s
476
+ // against a slow endpoint (15 s timeout each) blew the 120 s budget.
477
+ // The delivery task's own CAS claim makes a duplicate enqueue a no-op.
478
+ await deliverWebhookTask.runNoWait({ deliveryId: row.id });
466
479
  reDriven += 1;
467
480
  } catch (err) {
468
481
  logger.warn("reap-due-webhook-deliveries: re-drive failed", {
@@ -1,5 +1,5 @@
1
- import { createDatabase } from "@hogsend/db";
2
1
  import { deliverConversionDispatch } from "../lib/conversion-dispatch.js";
2
+ import { getDb } from "../lib/db.js";
3
3
  import { hatchet } from "../lib/hatchet.js";
4
4
  import { createLogger } from "../lib/logger.js";
5
5
 
@@ -19,7 +19,7 @@ export const dispatchConversionTask = hatchet.task({
19
19
  retries: 4,
20
20
  executionTimeout: "60s",
21
21
  fn: async (input: DispatchConversionInput) => {
22
- const { db } = createDatabase({ url: process.env.DATABASE_URL ?? "" });
22
+ const db = getDb();
23
23
  const logger = createLogger(process.env.LOG_LEVEL ?? "info");
24
24
  return deliverConversionDispatch({
25
25
  db,
@@ -1,7 +1,8 @@
1
1
  import type { JsonObject } from "@hatchet-dev/typescript-sdk/v1/types.js";
2
- import { createDatabase, type Database, importJobs } from "@hogsend/db";
2
+ import { type Database, importJobs } from "@hogsend/db";
3
3
  import { and, eq, inArray, sql } from "drizzle-orm";
4
4
  import { ALIAS_REASON_BACKFILL } from "../lib/contacts.js";
5
+ import { getDb } from "../lib/db.js";
5
6
  import { hatchet } from "../lib/hatchet.js";
6
7
  import type { Logger } from "../lib/logger.js";
7
8
  import { createLogger } from "../lib/logger.js";
@@ -330,7 +331,7 @@ export const identityAliasBackfillTask = hatchet.task({
330
331
  retries: 0,
331
332
  executionTimeout: "600s",
332
333
  fn: async (input: IdentityAliasBackfillInput) => {
333
- const { db } = createDatabase({ url: process.env.DATABASE_URL ?? "" });
334
+ const db = getDb();
334
335
  const logger = createLogger(process.env.LOG_LEVEL ?? "info");
335
336
  return runIdentityAliasBackfill({
336
337
  db,
@@ -1,12 +1,12 @@
1
1
  import { ConcurrencyLimitStrategy } from "@hatchet-dev/typescript-sdk/v1/index.js";
2
2
  import {
3
- createDatabase,
4
3
  type Database,
5
4
  webhookDeliveries,
6
5
  webhookEndpoints,
7
6
  } from "@hogsend/db";
8
7
  import { and, desc, eq, isNull, sql } from "drizzle-orm";
9
8
  import { getJourneyRegistrySingleton } from "../journeys/registry-singleton.js";
9
+ import { getDb } from "../lib/db.js";
10
10
  import { hatchet } from "../lib/hatchet.js";
11
11
  import { computeJourneyLift } from "../lib/journey-lift.js";
12
12
  import { createLogger, type Logger } from "../lib/logger.js";
@@ -638,7 +638,7 @@ export const impactDigestTask = hatchet.task({
638
638
  until?: string;
639
639
  }> => {
640
640
  // Cron runs have no request container — self-bootstrap (check-alerts).
641
- const { db } = createDatabase({ url: process.env.DATABASE_URL ?? "" });
641
+ const db = getDb();
642
642
  const logger = createLogger(process.env.LOG_LEVEL ?? "info");
643
643
 
644
644
  // (1) Subscriber pre-check — THE opt-in gate, one indexed query with
@@ -1,8 +1,9 @@
1
1
  import type { Database } from "@hogsend/db";
2
- import { contacts, createDatabase, importJobs } from "@hogsend/db";
2
+ import { contacts, importJobs } from "@hogsend/db";
3
3
  import { and, eq, isNull } from "drizzle-orm";
4
4
  import Papa from "papaparse";
5
5
  import { resolveOrCreateContact } from "../lib/contacts.js";
6
+ import { getDb } from "../lib/db.js";
6
7
  import { hatchet } from "../lib/hatchet.js";
7
8
  import { normalizePhone } from "../lib/phone.js";
8
9
 
@@ -70,9 +71,7 @@ export const importContactsTask = hatchet.task({
70
71
  retries: 0,
71
72
  executionTimeout: "600s",
72
73
  fn: async (input: { jobId: string; data: string; format: string }) => {
73
- const { db } = createDatabase({
74
- url: process.env.DATABASE_URL ?? "",
75
- });
74
+ const db = getDb();
76
75
 
77
76
  await db
78
77
  .update(importJobs)
@@ -1,7 +1,8 @@
1
- import { createDatabase, importJobs } from "@hogsend/db";
1
+ import { type Database, importJobs } from "@hogsend/db";
2
2
  import { eq } from "drizzle-orm";
3
3
  import Papa from "papaparse";
4
4
  import { resolveRecipient } from "../lib/contacts.js";
5
+ import { getDb } from "../lib/db.js";
5
6
  import { hatchet } from "../lib/hatchet.js";
6
7
  import { upsertEmailPreference } from "../lib/preferences.js";
7
8
 
@@ -106,9 +107,7 @@ export const importSuppressionsTask = hatchet.task({
106
107
  retries: 0,
107
108
  executionTimeout: "600s",
108
109
  fn: async (input: { jobId: string; data: string; format: string }) => {
109
- const { db } = createDatabase({
110
- url: process.env.DATABASE_URL ?? "",
111
- });
110
+ const db = getDb();
112
111
 
113
112
  await db
114
113
  .update(importJobs)
@@ -192,7 +191,7 @@ export const importSuppressionsTask = hatchet.task({
192
191
  },
193
192
  });
194
193
 
195
- type Db = ReturnType<typeof createDatabase>["db"];
194
+ type Db = Database;
196
195
 
197
196
  /**
198
197
  * Map one row and write it through the single preference choke point.
@@ -33,6 +33,8 @@ const CHUNK_SIZE = 100;
33
33
  interface CampaignRecipient {
34
34
  email: string;
35
35
  userId?: string;
36
+ /** The owning `contacts.id`, when the resolver joined it (skips a resolve). */
37
+ contactId?: string;
36
38
  }
37
39
 
38
40
  /**
@@ -584,6 +586,7 @@ export const sendCampaignTask = hatchet.task({
584
586
  props: (step.props ?? {}) as never,
585
587
  to: r.email,
586
588
  userId: r.userId,
589
+ ...(r.contactId ? { contactId: r.contactId } : {}),
587
590
  userEmail: r.email,
588
591
  subject: step.subject,
589
592
  from: step.from,
@@ -978,6 +981,7 @@ async function* resolveBucketRecipients(
978
981
  .select({
979
982
  id: bucketMemberships.id,
980
983
  userId: bucketMemberships.userId,
984
+ contactId: contacts.id,
981
985
  membershipEmail: bucketMemberships.userEmail,
982
986
  contactEmail: contacts.email,
983
987
  })
@@ -1011,7 +1015,11 @@ async function* resolveBucketRecipients(
1011
1015
  if (!raw) return undefined;
1012
1016
  // Normalize so the recipient matches the normalized email_preferences
1013
1017
  // keyspace the mailer's suppression check queries (see fn docstring).
1014
- return { email: normalizeEmail(raw), userId: row.userId };
1018
+ return {
1019
+ email: normalizeEmail(raw),
1020
+ userId: row.userId,
1021
+ contactId: row.contactId,
1022
+ };
1015
1023
  },
1016
1024
  });
1017
1025
  }
@@ -1159,6 +1167,7 @@ async function* resolveOptOutListRecipients(
1159
1167
  return {
1160
1168
  email: normalizeEmail(row.email),
1161
1169
  userId: row.userId ?? row.contactId,
1170
+ contactId: row.contactId,
1162
1171
  };
1163
1172
  },
1164
1173
  });