@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
package/src/lib/links.ts CHANGED
@@ -16,9 +16,26 @@ import { and, eq, isNull, ne, or, sql } from "drizzle-orm";
16
16
  * SHARE-SAFE INVARIANT: a link is identity-bearing (carries a `distinctId` the
17
17
  * click can stitch + may mint a single-use `hs_t`) ONLY when `type: "personal"`
18
18
  * AND an explicit `distinctId` is passed. A `"public"` link NEVER carries a
19
- * person token — a shared/reshared public link attributes by campaign only.
19
+ * person token - a shared/reshared public link attributes by campaign only.
20
+ * `"shared"` (a referral link) is owned by a person and clicked by SOMEONE
21
+ * ELSE, so it sits on the PUBLIC side of that invariant: it attributes to
22
+ * `ownerContactId` and stitches nobody.
20
23
  */
21
- export type LinkType = "personal" | "public";
24
+ export type LinkType = "personal" | "public" | "shared";
25
+
26
+ /**
27
+ * Thrown when the `shared` link ownership invariant is broken (PRD 05 5.2):
28
+ * a `shared` link with no `ownerContactId` credits nobody, and an
29
+ * `ownerContactId` on a `personal`/`public` link is a silent no-op that reads
30
+ * as if attribution were configured. Both are authoring errors, so they throw
31
+ * at mint time rather than minting a link that quietly does nothing.
32
+ */
33
+ export class LinkOwnershipError extends Error {
34
+ constructor(message: string) {
35
+ super(message);
36
+ this.name = "LinkOwnershipError";
37
+ }
38
+ }
22
39
 
23
40
  export interface MintLinkOptions {
24
41
  db: Database;
@@ -28,8 +45,22 @@ export interface MintLinkOptions {
28
45
  baseUrl: string;
29
46
  /** Originating channel: "studio" | "discord" | "sms" | "referral" | … (open). */
30
47
  source: string;
31
- /** "personal" (1:1, identity-bearing) | "public" (shareable). Default "public". */
48
+ /**
49
+ * "personal" (1:1, identity-bearing) | "public" (shareable) | "shared"
50
+ * (owned by a person, clicked by others - a referral link). Default
51
+ * "public".
52
+ */
32
53
  type?: LinkType;
54
+ /**
55
+ * The contact this link earns credit FOR. REQUIRED for `type: "shared"`,
56
+ * forbidden on `personal`/`public` (see {@link LinkOwnershipError}).
57
+ *
58
+ * This is an ATTRIBUTION field, never an identity one: it is deliberately
59
+ * not `distinctId`, because a referral link's clicker must never be stitched
60
+ * to its owner. Reusing `personal` for this would identify every referee AS
61
+ * the referrer, which is precisely the share-safe invariant's failure mode.
62
+ */
63
+ ownerContactId?: string;
33
64
  /** Operator-facing name (Studio list). */
34
65
  label?: string;
35
66
  /**
@@ -40,8 +71,16 @@ export interface MintLinkOptions {
40
71
  /** UTM-style campaign grouping (public links). */
41
72
  campaign?: string;
42
73
  /**
43
- * The canonical contact key a click should stitch — honoured ONLY for
44
- * `type: "personal"`; dropped for public links (the share-safe invariant).
74
+ * The `defineReferral` id this link belongs to (`getReferralLink` sets it).
75
+ * Stored on the row so a CLICK can find the DEFINITION that owns it - the
76
+ * hooks, the bind window and the qualify rule - without inferring it from
77
+ * `campaign`, which is operator-facing grouping and may be absent or shared.
78
+ */
79
+ referralId?: string;
80
+ /**
81
+ * The canonical contact key a click should stitch - honoured ONLY for
82
+ * `type: "personal"`; dropped for public AND shared links (the share-safe
83
+ * invariant).
45
84
  */
46
85
  distinctId?: string;
47
86
  /** The admin actor who minted it (Studio). */
@@ -81,6 +120,10 @@ export interface MintedLink {
81
120
  slug: string | null;
82
121
  /** The vanity short URL (`${baseUrl}/l/:slug`), if a slug was minted. */
83
122
  vanityUrl: string | null;
123
+ /** The link's type, as stored. */
124
+ type: LinkType;
125
+ /** The credited owner for a `shared` link; null for personal/public. */
126
+ ownerContactId: string | null;
84
127
  /**
85
128
  * True when the mint RECOVERED an existing live link (same slug or
86
129
  * idempotencyKey + same destination) instead of inserting a new one.
@@ -290,7 +333,12 @@ export function assertHttpUrl(url: string): void {
290
333
  async function recoverExistingLink(
291
334
  db: Database,
292
335
  baseUrl: string,
293
- row: { id: string; slug: string | null },
336
+ row: {
337
+ id: string;
338
+ slug: string | null;
339
+ type: string;
340
+ ownerContactId: string | null;
341
+ },
294
342
  ): Promise<MintedLink | null> {
295
343
  const [tracked] = await db
296
344
  .select({ id: sql<string | null>`min(${trackedLinks.id}::text)` })
@@ -304,6 +352,8 @@ async function recoverExistingLink(
304
352
  url: `${baseUrl}/v1/t/c/${trackedLinkId}`,
305
353
  slug: row.slug,
306
354
  vanityUrl: row.slug ? vanityUrlFor(baseUrl, row.slug) : null,
355
+ type: row.type as LinkType,
356
+ ownerContactId: row.ownerContactId,
307
357
  existing: true,
308
358
  };
309
359
  }
@@ -314,7 +364,25 @@ export async function mintLink(opts: MintLinkOptions): Promise<MintedLink> {
314
364
  throw new Error("mintLink: slug and idempotencyKey are mutually exclusive");
315
365
  }
316
366
  const type: LinkType = opts.type ?? "public";
317
- // A public link must NEVER carry a person token — drop any distinctId.
367
+ // THE OWNERSHIP INVARIANT (PRD 05 5.2). Loud at mint time, because both
368
+ // halves fail SILENTLY otherwise: an unowned shared link records touches
369
+ // that credit nobody, and an owner set on a public link looks like
370
+ // attribution is wired when nothing reads it.
371
+ const ownerContactId = opts.ownerContactId ?? null;
372
+ if (type === "shared" && !ownerContactId) {
373
+ throw new LinkOwnershipError(
374
+ 'mintLink: type "shared" requires ownerContactId - a shared link is ' +
375
+ "owned by the person it credits",
376
+ );
377
+ }
378
+ if (type !== "shared" && ownerContactId) {
379
+ throw new LinkOwnershipError(
380
+ `mintLink: ownerContactId is only valid for type "shared", got "${type}"`,
381
+ );
382
+ }
383
+ // Only a PERSONAL link carries a person token. A public link must never
384
+ // carry one, and neither must a shared link: it is clicked by someone other
385
+ // than its owner, so stitching would identify every referee as the referrer.
318
386
  const distinctId = type === "personal" ? (opts.distinctId ?? null) : null;
319
387
  const slug = opts.slug !== undefined ? normalizeSlug(opts.slug) : null;
320
388
 
@@ -335,8 +403,10 @@ export async function mintLink(opts: MintLinkOptions): Promise<MintedLink> {
335
403
  description: opts.description ?? null,
336
404
  appendRef: opts.appendRef ?? false,
337
405
  campaign: opts.campaign ?? null,
406
+ referralId: opts.referralId ?? null,
338
407
  source: opts.source,
339
408
  distinctId,
409
+ ownerContactId,
340
410
  createdBy: opts.createdBy ?? null,
341
411
  idempotencyKey: opts.idempotencyKey ?? null,
342
412
  });
@@ -360,13 +430,19 @@ export async function mintLink(opts: MintLinkOptions): Promise<MintedLink> {
360
430
  .from(links)
361
431
  .where(and(eq(links.slug, slug), isNull(links.archivedAt)))
362
432
  .limit(1);
363
- if (row && row.originalUrl === opts.url && row.type === type) {
433
+ if (
434
+ row &&
435
+ row.originalUrl === opts.url &&
436
+ row.type === type &&
437
+ row.ownerContactId === ownerContactId
438
+ ) {
364
439
  const recovered = await recoverExistingLink(opts.db, opts.baseUrl, row);
365
440
  if (recovered) return recovered;
366
441
  }
367
442
  // Slug held by an ARCHIVED link (the live lookup misses — archived
368
- // links keep their slug reserved), a different destination, or a
369
- // different type → conflict.
443
+ // links keep their slug reserved), a different destination, a
444
+ // different type, or a different owner (two referrers whose slugFrom
445
+ // collide must NOT share one link) → conflict.
370
446
  throw new SlugTakenError(slug);
371
447
  }
372
448
  if (opts.idempotencyKey && isIdempotencyKeyViolation(err)) {
@@ -380,7 +456,12 @@ export async function mintLink(opts: MintLinkOptions): Promise<MintedLink> {
380
456
  ),
381
457
  )
382
458
  .limit(1);
383
- if (row && row.originalUrl === opts.url) {
459
+ if (
460
+ row &&
461
+ row.originalUrl === opts.url &&
462
+ row.type === type &&
463
+ row.ownerContactId === ownerContactId
464
+ ) {
384
465
  const recovered = await recoverExistingLink(opts.db, opts.baseUrl, row);
385
466
  if (recovered) return recovered;
386
467
  }
@@ -398,6 +479,8 @@ export async function mintLink(opts: MintLinkOptions): Promise<MintedLink> {
398
479
  url: `${opts.baseUrl}/v1/t/c/${trackedLinkId}`,
399
480
  slug,
400
481
  vanityUrl: slug ? vanityUrlFor(opts.baseUrl, slug) : null,
482
+ type,
483
+ ownerContactId,
401
484
  existing: false,
402
485
  };
403
486
  }
@@ -16,6 +16,7 @@ process.env.BETTER_AUTH_SECRET ??= "test-secret";
16
16
  process.env.HATCHET_CLIENT_TOKEN ??=
17
17
  "eyJhbGciOiJFUzI1NiIsImtpZCI6InRlc3QifQ.eyJhdWQiOiJsb2NhbGhvc3QiLCJleHAiOjQ5MzMyNDA5ODMsImdycGNfYnJvYWRjYXN0X2FkZHJlc3MiOiJsb2NhbGhvc3Q6NzA3NyIsImlhdCI6MTc3OTY0MDk4MywiaXNzIjoibG9jYWxob3N0Iiwic2VydmVyX3VybCI6ImxvY2FsaG9zdCIsInN1YiI6InRlc3QtdGVuYW50LWlkIiwidG9rZW5faWQiOiJ0ZXN0LXRva2VuLWlkIn0.test";
18
18
  const { createTrackedMailer } = await import("./mailer.js");
19
+ const { WEBHOOK_EVENT_TYPES } = await import("./webhook-signing.js");
19
20
 
20
21
  /**
21
22
  * BOUNCE IDEMPOTENCY.
@@ -203,8 +204,12 @@ function fakeDb(rows: FakeSend[]): FakeDb {
203
204
  ),
204
205
  }),
205
206
  }),
206
- // One subscribed endpoint, so the spine has somewhere to deliver.
207
- where: () => Promise.resolve([{ id: "endpoint-1" }]),
207
+ // One endpoint subscribed to every event, so the spine has
208
+ // somewhere to deliver whatever the path emits.
209
+ where: () =>
210
+ Promise.resolve([
211
+ { id: "endpoint-1", eventTypes: [...WEBHOOK_EVENT_TYPES] },
212
+ ]),
208
213
  };
209
214
  },
210
215
  };
@@ -15,6 +15,7 @@ process.env.BETTER_AUTH_SECRET ??= "test-secret";
15
15
  process.env.HATCHET_CLIENT_TOKEN ??=
16
16
  "eyJhbGciOiJFUzI1NiIsImtpZCI6InRlc3QifQ.eyJhdWQiOiJsb2NhbGhvc3QiLCJleHAiOjQ5MzMyNDA5ODMsImdycGNfYnJvYWRjYXN0X2FkZHJlc3MiOiJsb2NhbGhvc3Q6NzA3NyIsImlhdCI6MTc3OTY0MDk4MywiaXNzIjoibG9jYWxob3N0Iiwic2VydmVyX3VybCI6ImxvY2FsaG9zdCIsInN1YiI6InRlc3QtdGVuYW50LWlkIiwidG9rZW5faWQiOiJ0ZXN0LXRva2VuLWlkIn0.test";
17
17
  const { createTrackedMailer } = await import("./mailer.js");
18
+ const { WEBHOOK_EVENT_TYPES } = await import("./webhook-signing.js");
18
19
 
19
20
  /**
20
21
  * `email.replied` handling (PRD 16 task 5).
@@ -128,8 +129,12 @@ function recordingDb(selectRows: SendRow[] = []): {
128
129
  leftJoin: () => ({
129
130
  where: () => ({ limit: () => Promise.resolve(selectRows) }),
130
131
  }),
131
- // One subscribed endpoint, so the spine has somewhere to deliver.
132
- where: () => Promise.resolve([{ id: "endpoint-1" }]),
132
+ // One endpoint subscribed to every event, so the spine has
133
+ // somewhere to deliver whatever the path emits.
134
+ where: () =>
135
+ Promise.resolve([
136
+ { id: "endpoint-1", eventTypes: [...WEBHOOK_EVENT_TYPES] },
137
+ ]),
133
138
  };
134
139
  },
135
140
  };
package/src/lib/mailer.ts CHANGED
@@ -224,6 +224,7 @@ export function createTrackedMailer(
224
224
  subject: options.subject,
225
225
  journeyStateId: options.journeyStateId,
226
226
  campaignId: options.campaignId,
227
+ contactId: options.contactId,
227
228
  userId: options.userId,
228
229
  userEmail: options.userEmail,
229
230
  category: options.category,
@@ -0,0 +1,83 @@
1
+ import { type Database, webhookEndpoints } from "@hogsend/db";
2
+ import { and, eq, isNull } from "drizzle-orm";
3
+
4
+ /** How long the enabled-endpoint list is reused before a re-read. */
5
+ const DEFAULT_ENDPOINT_CACHE_TTL_MS = 30_000;
6
+
7
+ interface CachedEndpoint {
8
+ id: string;
9
+ eventTypes: string[];
10
+ }
11
+
12
+ interface CacheEntry {
13
+ rows: CachedEndpoint[];
14
+ loadedAt: number;
15
+ generation: number;
16
+ }
17
+
18
+ // One entry per database client, so two databases in one process (tests,
19
+ // a multi-database host) never read each other's endpoints.
20
+ const endpointCache = new WeakMap<Database, CacheEntry>();
21
+ // Bumped by every invalidation. An entry from an older generation is ignored,
22
+ // and a read that started before an admin write can't put the pre-write list
23
+ // back into the cache when it finishes.
24
+ let endpointCacheGeneration = 0;
25
+
26
+ function endpointCacheTtlMs(): number {
27
+ const raw = process.env.OUTBOUND_ENDPOINT_CACHE_TTL_MS;
28
+ if (raw === undefined || raw === "") return DEFAULT_ENDPOINT_CACHE_TTL_MS;
29
+ const ttl = Number(raw);
30
+ return Number.isFinite(ttl) && ttl >= 0 ? ttl : DEFAULT_ENDPOINT_CACHE_TTL_MS;
31
+ }
32
+
33
+ /**
34
+ * Drop the cached endpoint list so the next emit re-reads `webhook_endpoints`.
35
+ * Every engine writer of that table calls this (the admin webhook routes and
36
+ * the PostHog destination seed). It only clears THIS process: another API
37
+ * instance or the worker picks the change up when its own copy expires
38
+ * (`OUTBOUND_ENDPOINT_CACHE_TTL_MS`, default 30 s). A disabled or deleted
39
+ * endpoint, or an event it was just unsubscribed from, is still never sent to
40
+ * inside that window: the delivery task re-reads the endpoint row before every
41
+ * attempt. `emitOutbound` retries once on the foreign-key error a deleted
42
+ * cached endpoint causes, so the other endpoints keep their delivery.
43
+ */
44
+ export function invalidateOutboundEndpointCache(): void {
45
+ endpointCacheGeneration += 1;
46
+ }
47
+
48
+ /**
49
+ * Every enabled single-tenant endpoint with its subscriptions, read at most
50
+ * once per TTL. The per-event filter runs in memory: an install has a handful
51
+ * of endpoints, and this saves a query on every outbound emit.
52
+ */
53
+ export async function loadSubscribableEndpoints(
54
+ db: Database,
55
+ ): Promise<CachedEndpoint[]> {
56
+ const ttl = endpointCacheTtlMs();
57
+ const now = Date.now();
58
+ const cached = ttl > 0 ? endpointCache.get(db) : undefined;
59
+ if (
60
+ cached &&
61
+ cached.generation === endpointCacheGeneration &&
62
+ now - cached.loadedAt < ttl
63
+ ) {
64
+ return cached.rows;
65
+ }
66
+ const generation = endpointCacheGeneration;
67
+ const rows = await db
68
+ .select({
69
+ id: webhookEndpoints.id,
70
+ eventTypes: webhookEndpoints.eventTypes,
71
+ })
72
+ .from(webhookEndpoints)
73
+ .where(
74
+ and(
75
+ eq(webhookEndpoints.disabled, false),
76
+ isNull(webhookEndpoints.organizationId),
77
+ ),
78
+ );
79
+ if (ttl > 0 && generation === endpointCacheGeneration) {
80
+ endpointCache.set(db, { rows, loadedAt: now, generation });
81
+ }
82
+ return rows;
83
+ }
@@ -1,14 +1,13 @@
1
1
  import { randomUUID } from "node:crypto";
2
2
  import type { HatchetClient } from "@hatchet-dev/typescript-sdk/v1/index.js";
3
- import {
4
- type Database,
5
- webhookDeliveries,
6
- webhookEndpoints,
7
- } from "@hogsend/db";
8
- import { and, eq, isNull, sql } from "drizzle-orm";
3
+ import { type Database, webhookDeliveries } from "@hogsend/db";
9
4
  import { deliverWebhookTask } from "../workflows/deliver-webhook.js";
10
5
  import type { SerializedContact } from "./contacts.js";
11
6
  import type { Logger } from "./logger.js";
7
+ import {
8
+ invalidateOutboundEndpointCache,
9
+ loadSubscribableEndpoints,
10
+ } from "./outbound-endpoint-cache.js";
12
11
  import {
13
12
  WEBHOOK_EVENT_TYPES,
14
13
  type WebhookEventType,
@@ -28,6 +27,16 @@ export {
28
27
  resolveEmailSendContextByResendId,
29
28
  } from "./tracking-events.js";
30
29
 
30
+ /** Postgres `foreign_key_violation`; drizzle nests the driver error in `cause`. */
31
+ function isForeignKeyViolation(error: unknown): boolean {
32
+ for (let e = error, depth = 0; e && depth < 5; depth++) {
33
+ const candidate = e as { code?: string; cause?: unknown };
34
+ if (candidate.code === "23503") return true;
35
+ e = candidate.cause;
36
+ }
37
+ return false;
38
+ }
39
+
31
40
  /**
32
41
  * The outbound event catalog re-exported for the emit spine. Identical to the
33
42
  * signing lib's {@link WEBHOOK_EVENT_TYPES} — the single source of truth.
@@ -318,6 +327,51 @@ export interface OutboundPayloads {
318
327
  userEmail: string;
319
328
  heldOutAt: string;
320
329
  };
330
+ /**
331
+ * A referral EDGE reached its first end: someone clicked a `shared` link and
332
+ * landed. `refereeContactId` is NULL on the (normal) cold path — the referee
333
+ * is a browser id, not yet a person — which is exactly why this event names
334
+ * only the REFERRER as its subject and mints no contact.
335
+ */
336
+ "referral.touched": ReferralTouchPayload;
337
+ /**
338
+ * The edge gained its second end: the referee identified and
339
+ * `adoptOrphanHistory` stamped the touch. Delivered ONCE per touch (one
340
+ * dedupe key), and re-ingested onto the journey bus for BOTH ends.
341
+ */
342
+ "referral.bound": ReferralTouchPayload & { boundAt: string; side: string };
343
+ /**
344
+ * A bound referee did the thing the program asked for (`qualify.event`, with
345
+ * optional `where`). Exactly once per touch — the store's
346
+ * `qualified_at IS NULL` predicate is the guard.
347
+ */
348
+ "referral.qualified": ReferralTouchPayload & {
349
+ event: string | null;
350
+ conversionId: string | null;
351
+ qualifiedAt: string;
352
+ side: string;
353
+ };
354
+ /** A referee converted; the DIRECT referrer is told (`level` is always 1). */
355
+ "referral.converted": ReferralConversionPayload;
356
+ /**
357
+ * An ANCESTOR above the direct referrer is told about the same conversion,
358
+ * one delivery per hop to depth 5. `level` is a FACT on the event: a reward
359
+ * journey filters with `trigger.where: (b) => b.prop("level").eq(1)`, and
360
+ * that is the only place levels appear in code. Depth and weights stay
361
+ * report-time parameters.
362
+ */
363
+ "referral.tree_converted": ReferralConversionPayload;
364
+ /**
365
+ * An edge was refused — `self` (the referee turned out to BE the referrer,
366
+ * which falls out of the identity merge rather than a fraud heuristic),
367
+ * `window` (the touch was older than `bindWindow` at identify),
368
+ * `duplicate`, or `veto` (a `before*` hook said no; its free text rides
369
+ * `detail`).
370
+ */
371
+ "referral.rejected": ReferralTouchPayload & {
372
+ reason: string | null;
373
+ detail?: string | null;
374
+ };
321
375
  /**
322
376
  * Weekly impact digest (impact experiments D5) — facts-only rollup of
323
377
  * shipped journey changes and holdout-lift threshold crossings, emitted
@@ -569,6 +623,55 @@ export interface ImpactDigestLiftEntry {
569
623
  smallSample: boolean;
570
624
  }
571
625
 
626
+ /**
627
+ * The shared shape of every touch-scoped referral event. Scalars only: these
628
+ * payloads double as the journey-bus `eventProperties`, and `ingestEvent`
629
+ * filters the Hatchet push down to `string | number | boolean | null`, so a
630
+ * nested field would be silently dropped between `user_events` and the journey
631
+ * (and a `where` clause naming it would never match).
632
+ */
633
+ export type ReferralTouchPayload = {
634
+ referralId: string;
635
+ touchId: string;
636
+ referrerContactId: string;
637
+ /** NULL until the edge binds. */
638
+ refereeContactId: string | null;
639
+ /** The canonical key at touch time — an ANONYMOUS id on a cold touch. */
640
+ refereeKey: string;
641
+ source: string;
642
+ linkId: string | null;
643
+ clickId: string | null;
644
+ status: string;
645
+ /** ISO 8601. */
646
+ touchedAt: string;
647
+ };
648
+
649
+ /** `referral.converted` / `referral.tree_converted`. */
650
+ export type ReferralConversionPayload = {
651
+ referralId: string;
652
+ touchId: string;
653
+ /** 1 = the direct referrer; 2+ = an ancestor. Capped at 5. */
654
+ level: number;
655
+ /** The contact being TOLD (who earns at this level). */
656
+ beneficiaryContactId: string;
657
+ /** The contact who actually converted. */
658
+ refereeContactId: string;
659
+ /** The next hop toward the referee — "your friend's friend". */
660
+ viaContactId: string;
661
+ conversionId: string;
662
+ /**
663
+ * The converted amount. NOT named `value`: this payload doubles verbatim as
664
+ * the journey-bus `eventProperties`, and a `value` there would fire the
665
+ * built-in wildcard `revenue` conversion (trigger `*` + `value > 0`) FOR THE
666
+ * BENEFICIARY - minting a phantom conversion on every ancestor and
667
+ * re-entering `convertReferral` up the whole chain.
668
+ */
669
+ conversionValue: number | null;
670
+ currency: string | null;
671
+ /** ISO 8601. */
672
+ at: string;
673
+ };
674
+
572
675
  export type ImpactDigestEntry =
573
676
  | ImpactDigestShippedEntry
574
677
  | ImpactDigestLiftEntry;
@@ -623,19 +726,14 @@ export async function emitOutbound<E extends OutboundEventName>(opts: {
623
726
  const webhookId = `msg_${randomUUID()}`;
624
727
  const timestamp = new Date();
625
728
 
626
- // (2) Active, subscribed endpoints. `event_types @> '["<event>"]'` matches
627
- // the jsonb array containing this event. Single-tenant: organizationId IS
628
- // NULL (NOT a hardcoded tenant — keeps the MT wiring non-breaking).
629
- const endpoints = await db
630
- .select({ id: webhookEndpoints.id })
631
- .from(webhookEndpoints)
632
- .where(
633
- and(
634
- eq(webhookEndpoints.disabled, false),
635
- isNull(webhookEndpoints.organizationId),
636
- sql`${webhookEndpoints.eventTypes} @> ${JSON.stringify([event])}::jsonb`,
637
- ),
729
+ // (2) Active, subscribed endpoints, from the endpoint cache below.
730
+ // Single-tenant: organizationId IS NULL (NOT a hardcoded tenant — keeps the
731
+ // MT wiring non-breaking).
732
+ const subscribed = async () =>
733
+ (await loadSubscribableEndpoints(db)).filter((endpoint) =>
734
+ endpoint.eventTypes.includes(event),
638
735
  );
736
+ let endpoints = await subscribed();
639
737
 
640
738
  if (endpoints.length === 0) return;
641
739
 
@@ -649,25 +747,40 @@ export async function emitOutbound<E extends OutboundEventName>(opts: {
649
747
 
650
748
  // (4) One delivery row per endpoint, sharing the webhookId. onConflictDoNothing
651
749
  // on (endpointId, dedupeKey) is the producer-side fan-out idempotency guard.
652
- const inserted = await db
653
- .insert(webhookDeliveries)
654
- .values(
655
- endpoints.map((endpoint) => ({
656
- endpointId: endpoint.id,
657
- organizationId,
658
- webhookId,
659
- eventType: event,
660
- dedupeKey: dedupeKey ?? null,
661
- payload: envelope as unknown as Record<string, unknown>,
662
- status: "pending" as const,
663
- attemptCount: 0,
664
- nextRetryAt: timestamp,
665
- })),
666
- )
667
- .onConflictDoNothing({
668
- target: [webhookDeliveries.endpointId, webhookDeliveries.dedupeKey],
669
- })
670
- .returning({ id: webhookDeliveries.id });
750
+ const insertDeliveries = (targets: typeof endpoints) =>
751
+ db
752
+ .insert(webhookDeliveries)
753
+ .values(
754
+ targets.map((endpoint) => ({
755
+ endpointId: endpoint.id,
756
+ organizationId,
757
+ webhookId,
758
+ eventType: event,
759
+ dedupeKey: dedupeKey ?? null,
760
+ payload: envelope as unknown as Record<string, unknown>,
761
+ status: "pending" as const,
762
+ attemptCount: 0,
763
+ nextRetryAt: timestamp,
764
+ })),
765
+ )
766
+ .onConflictDoNothing({
767
+ target: [webhookDeliveries.endpointId, webhookDeliveries.dedupeKey],
768
+ })
769
+ .returning({ id: webhookDeliveries.id });
770
+
771
+ let inserted: Awaited<ReturnType<typeof insertDeliveries>>;
772
+ try {
773
+ inserted = await insertDeliveries(endpoints);
774
+ } catch (error) {
775
+ // A cached endpoint was deleted on another instance: the FK fails the
776
+ // whole multi-row insert, which would drop the event for every OTHER
777
+ // endpoint too. Re-read the endpoints and retry once without it.
778
+ if (!isForeignKeyViolation(error)) throw error;
779
+ invalidateOutboundEndpointCache();
780
+ endpoints = await subscribed();
781
+ if (endpoints.length === 0) return;
782
+ inserted = await insertDeliveries(endpoints);
783
+ }
671
784
 
672
785
  // (5) Enqueue the durable delivery task per freshly-inserted row,
673
786
  // fire-and-forget. A failed enqueue is recovered by the reaper (the row is