@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
@@ -0,0 +1,73 @@
1
+ import type { JsonObject } from "@hatchet-dev/typescript-sdk/v1/types.js";
2
+ /**
3
+ * Engine-owned cron reconciliation for TIME-BASED bucket leaves (Section 6.4).
4
+ *
5
+ * Time-based criteria (an `EventCondition.within` rolling window) silently flip a
6
+ * user OUT of a bucket as the clock advances with NO inbound event — the real-time
7
+ * path structurally cannot catch this. This cron sweeps every `timeBased`,
8
+ * `kind:"dynamic"` bucket and transitions members who SHOULD leave via a single
9
+ * set-based SHOULD-LEAVE query (per criterion shape) + a bulk compare-and-swap.
10
+ *
11
+ * It self-bootstraps `db`/`logger` from `process.env` (cron runs have no request
12
+ * container), cloned from `check-alerts.ts`, and reads the process bucket-registry
13
+ * singleton (installed by `createHogsendClient`, which both API and worker call).
14
+ *
15
+ * Emission is gated on the `RETURNING` of the bulk CAS — the loser of a concurrent
16
+ * race (e.g. an overlapping ingest tick) mutates zero rows and never emits — and it
17
+ * reuses the SAME deterministic `idempotencyKey` shape as the real-time path
18
+ * (`bucket:<id>:<userId>:<kind>:<entryCount>`), so concurrent ingest + cron
19
+ * converge to exactly ONE emission (Section 6.3 worked example).
20
+ *
21
+ * NON-cancelling concurrency: a sweep that overruns the interval must be allowed to
22
+ * FINISH (else an expiration never completes and members are stuck `active`
23
+ * forever), so the strategy is `GROUP_ROUND_ROBIN` with `maxRuns: 1` keyed on a
24
+ * single static group — a newcomer queues behind the incumbent, it is never
25
+ * cancelled (NOT `CANCEL_IN_PROGRESS`).
26
+ */
27
+ export declare const bucketReconcileTask: import("@hatchet-dev/typescript-sdk/v1").TaskWorkflowDeclaration<import("@hatchet-dev/typescript-sdk/v1").UnknownInputType, {
28
+ reconciled: number;
29
+ joined: number;
30
+ }, {}, {}, {}, {}>;
31
+ /**
32
+ * Optional per-user fast-expiry durable timer (Section 6.5). Armed on JOIN for
33
+ * `meta.fastExpiry` buckets, it durably sleeps until the membership's `expiresAt`
34
+ * deadline, then leaves via a SINGLE atomic CAS keyed on the ARMED `expiresAt` —
35
+ * never read-then-act. A concurrent real-time event that re-armed the window (a new
36
+ * `expiresAt`) makes the CAS match zero rows, so the stale timer no-ops WITHOUT
37
+ * emitting a spurious `bucket:left`. The cron remains the authoritative backstop
38
+ * for any timer lost to worker churn.
39
+ *
40
+ * It is a single SHARED durableTask keyed on `bucket:arm-expiry` (per-bucket arming
41
+ * is by event payload, not per-bucket task instances), registered once by
42
+ * `selectBucketTasks` if ANY enabled bucket opts in (Section 9.4). The
43
+ * `bucket:`-prefixed event name is recursion-guarded by `checkBucketMembership`.
44
+ */
45
+ export interface BucketArmExpiryInput extends JsonObject {
46
+ rowId: string;
47
+ bucketId: string;
48
+ userId: string;
49
+ userEmail: string | null;
50
+ /** ISO timestamp of the armed deadline — the CAS epoch. */
51
+ armedExpiresAt: string;
52
+ /** ms from arming to the deadline (the durable sleep). */
53
+ msUntilExpiry: number;
54
+ /**
55
+ * D1 creation guard inherited from the ingest that armed this timer, present
56
+ * ONLY when that ingest REFUSED (`armExpiryTimer` omits the key otherwise, so
57
+ * an unset value keeps today's create-by-default semantics and no JSON null
58
+ * crosses the wire). Forwarded into the leave `emitBucketTransition` below —
59
+ * the one thing that keeps the woken timer from minting the phantom the
60
+ * synchronous emits already refuse (issue #608, D11 category (iii)).
61
+ */
62
+ allowCreate?: boolean;
63
+ }
64
+ export declare const bucketExpiryTask: import("@hatchet-dev/typescript-sdk/v1").TaskWorkflowDeclaration<BucketArmExpiryInput, {
65
+ status: string;
66
+ reason: string;
67
+ rowId?: undefined;
68
+ } | {
69
+ status: string;
70
+ rowId: string;
71
+ reason?: undefined;
72
+ }, {}, {}, {}, {}>;
73
+ //# sourceMappingURL=bucket-reconcile.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"bucket-reconcile.d.ts","sourceRoot":"","sources":["../../src/workflows/bucket-reconcile.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yCAAyC,CAAC;AAwD1E;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,eAAO,MAAM,mBAAmB;;;kBAoH9B,CAAC;AAEH;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,oBAAqB,SAAQ,UAAU;IACtD,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,2DAA2D;IAC3D,cAAc,EAAE,MAAM,CAAC;IACvB,0DAA0D;IAC1D,aAAa,EAAE,MAAM,CAAC;IACtB;;;;;;;OAOG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,eAAO,MAAM,gBAAgB;;;;;;;;kBAyG3B,CAAC"}
@@ -0,0 +1,10 @@
1
+ import { type Database } from "@hogsend/db";
2
+ import { type Logger } from "../lib/logger.js";
3
+ export declare function surfaceStrandedWaiting(opts: {
4
+ db: Database;
5
+ logger: Logger;
6
+ }): Promise<void>;
7
+ export declare const checkAlertsTask: import("@hatchet-dev/typescript-sdk/index.js").TaskWorkflowDeclaration<import("@hatchet-dev/typescript-sdk/index.js").UnknownInputType, {
8
+ checked: true;
9
+ }, {}, {}, {}, {}>;
10
+ //# sourceMappingURL=check-alerts.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"check-alerts.d.ts","sourceRoot":"","sources":["../../src/workflows/check-alerts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,QAAQ,EAA6B,MAAM,aAAa,CAAC;AAKvE,OAAO,EAAgB,KAAK,MAAM,EAAE,MAAM,kBAAkB,CAAC;AA0D7D,wBAAsB,sBAAsB,CAAC,IAAI,EAAE;IACjD,EAAE,EAAE,QAAQ,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAChB,GAAG,OAAO,CAAC,IAAI,CAAC,CAwEhB;AAsDD,eAAO,MAAM,eAAe;;kBAmB1B,CAAC"}
@@ -0,0 +1,15 @@
1
+ import { type ConfirmSemanticClickInput } from "../lib/semantic-click.js";
2
+ /**
3
+ * Deferred confirmation of a semantic-link answer, enqueued per candidate
4
+ * click by the click route. The deferral (≈ the burst window, 30s) is the
5
+ * point: an inline gate can never suppress a scanner's FIRST click because
6
+ * the rest of the burst hasn't happened yet — this task judges the click with
7
+ * the whole window visible on both sides.
8
+ *
9
+ * Retries are safe: the claim is an idempotency-keyed `user_events` insert
10
+ * whose failed-publish path rolls back inside `ingestEvent`, the stamp is
11
+ * `IS NULL`-guarded, and the outbound emit carries a `dedupeKey`. Self-
12
+ * bootstraps deps from the process (cron-style; no request container).
13
+ */
14
+ export declare const confirmSemanticClickTask: import("@hatchet-dev/typescript-sdk/index.js").TaskWorkflowDeclaration<ConfirmSemanticClickInput, import("../lib/semantic-click.js").ConfirmSemanticClickResult, {}, {}, {}, {}>;
15
+ //# sourceMappingURL=confirm-semantic-click.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"confirm-semantic-click.d.ts","sourceRoot":"","sources":["../../src/workflows/confirm-semantic-click.ts"],"names":[],"mappings":"AAIA,OAAO,EACL,KAAK,yBAAyB,EAE/B,MAAM,0BAA0B,CAAC;AAElC;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,wBAAwB,kLAenC,CAAC"}
@@ -0,0 +1,27 @@
1
+ import { type Database } from "@hogsend/db";
2
+ import { hatchet } from "../lib/hatchet.js";
3
+ import { type Logger } from "../lib/logger.js";
4
+ /**
5
+ * CRM reconciliation poll — the pull
6
+ * half of the webhook+poll hybrid. Every provider implementing `poll` is
7
+ * walked on a cron: read the persisted cursor, pull changed deals, feed them
8
+ * through the SAME `ingestCrmStageEvents` sink the webhook route uses (the
9
+ * spine's idempotency dedups the overlap), persist the next cursor. A failing
10
+ * provider records `lastError` on its cursor row and never blocks the others
11
+ * — webhooks give latency, this poll guarantees eventual consistency.
12
+ */
13
+ /** The sweep body — exported for direct testing; the cron task wraps it. */
14
+ export declare function runCrmReconcile(deps: {
15
+ db: Database;
16
+ logger: Logger;
17
+ /** Test seam — defaults to the process Hatchet client. */
18
+ hatchet?: typeof hatchet;
19
+ }): Promise<{
20
+ polled: number;
21
+ ingested: number;
22
+ }>;
23
+ export declare const crmReconcileTask: import("@hatchet-dev/typescript-sdk/v1").TaskWorkflowDeclaration<import("@hatchet-dev/typescript-sdk/v1").UnknownInputType, {
24
+ polled: number;
25
+ ingested: number;
26
+ }, {}, {}, {}, {}>;
27
+ //# sourceMappingURL=crm-reconcile.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"crm-reconcile.d.ts","sourceRoot":"","sources":["../../src/workflows/crm-reconcile.ts"],"names":[],"mappings":"AACA,OAAO,EAAkB,KAAK,QAAQ,EAAE,MAAM,aAAa,CAAC;AAO5D,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAC5C,OAAO,EAAgB,KAAK,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAE7D;;;;;;;;GAQG;AAEH,4EAA4E;AAC5E,wBAAsB,eAAe,CAAC,IAAI,EAAE;IAC1C,EAAE,EAAE,QAAQ,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,0DAA0D;IAC1D,OAAO,CAAC,EAAE,OAAO,OAAO,CAAC;CAC1B,GAAG,OAAO,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC,CAmFhD;AAED,eAAO,MAAM,gBAAgB;YArFP,MAAM;cAAY,MAAM;kBAsG5C,CAAC"}
@@ -0,0 +1,88 @@
1
+ /**
2
+ * One durable delivery attempt for a single `webhook_deliveries` row.
3
+ *
4
+ * `retries: 0` — the reaper (driven off `nextRetryAt`) is the retry scheduler,
5
+ * NOT Hatchet's own backoff (which would double up on the reaper's). The CAS to
6
+ * `sending` (step 3) prevents an overlapping reaper re-drive from double-POSTing
7
+ * the same row.
8
+ */
9
+ export declare const deliverWebhookTask: import("@hatchet-dev/typescript-sdk/index.js").TaskWorkflowDeclaration<{
10
+ deliveryId: string;
11
+ }, {
12
+ status: string;
13
+ reason: "not_found";
14
+ skipped?: undefined;
15
+ responseStatus?: undefined;
16
+ attemptCount?: undefined;
17
+ nextRetryAt?: undefined;
18
+ fastFail?: undefined;
19
+ } | {
20
+ status: "failed" | "delivered" | "pending" | "discarded" | "sending";
21
+ skipped: true;
22
+ reason?: undefined;
23
+ responseStatus?: undefined;
24
+ attemptCount?: undefined;
25
+ nextRetryAt?: undefined;
26
+ fastFail?: undefined;
27
+ } | {
28
+ status: "discarded";
29
+ reason: "endpoint_deleted" | "endpoint_disabled" | "event_unsubscribed";
30
+ skipped?: undefined;
31
+ responseStatus?: undefined;
32
+ attemptCount?: undefined;
33
+ nextRetryAt?: undefined;
34
+ fastFail?: undefined;
35
+ } | {
36
+ status: string;
37
+ reason: "lost_cas";
38
+ skipped?: undefined;
39
+ responseStatus?: undefined;
40
+ attemptCount?: undefined;
41
+ nextRetryAt?: undefined;
42
+ fastFail?: undefined;
43
+ } | {
44
+ status: "delivered";
45
+ responseStatus: number | null;
46
+ reason?: undefined;
47
+ skipped?: undefined;
48
+ attemptCount?: undefined;
49
+ nextRetryAt?: undefined;
50
+ fastFail?: undefined;
51
+ } | {
52
+ status: "pending";
53
+ attemptCount: number;
54
+ nextRetryAt: string;
55
+ reason?: undefined;
56
+ skipped?: undefined;
57
+ responseStatus?: undefined;
58
+ fastFail?: undefined;
59
+ } | {
60
+ status: "failed";
61
+ attemptCount: number;
62
+ fastFail: boolean;
63
+ reason?: undefined;
64
+ skipped?: undefined;
65
+ responseStatus?: undefined;
66
+ nextRetryAt?: undefined;
67
+ }, {}, {}, {}, {}>;
68
+ /**
69
+ * Engine-owned reaper cron for outbound webhook deliveries (Section 1.5, cloned
70
+ * from `reapStuckCampaignsTask`). It is BOTH the retry scheduler AND the
71
+ * orphan-`sending` recovery:
72
+ *
73
+ * - A `pending` row whose `nextRetryAt` has passed (or is null — a freshly
74
+ * enqueued row whose `runNoWait` failed at emit time) is re-driven.
75
+ * - A `sending` row whose worker died mid-POST (OOM/SIGKILL/timeout, so the JS
76
+ * never reached a terminal write) is re-driven once it is older than
77
+ * `STUCK_AFTER_MS` (measured from `updatedAt`, which step 3's CAS bumped).
78
+ *
79
+ * Recovery is `deliverWebhookTask.runNoWait({ deliveryId })`; the delivery task's own
80
+ * `sending` CAS guard makes an overlap with a still-live run safe (the loser
81
+ * no-ops). Self-bootstraps `db`/`logger` from `process.env` (cron runs have no
82
+ * request container).
83
+ */
84
+ export declare const reapDueWebhookDeliveriesTask: import("@hatchet-dev/typescript-sdk/index.js").TaskWorkflowDeclaration<import("@hatchet-dev/typescript-sdk/index.js").UnknownInputType, {
85
+ candidates: number;
86
+ reDriven: number;
87
+ }, {}, {}, {}, {}>;
88
+ //# sourceMappingURL=deliver-webhook.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"deliver-webhook.d.ts","sourceRoot":"","sources":["../../src/workflows/deliver-webhook.ts"],"names":[],"mappings":"AA2FA;;;;;;;GAOG;AACH,eAAO,MAAM,kBAAkB;gBAIG,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAyTtC,CAAC;AAKH;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,4BAA4B;;;kBA2DvC,CAAC"}
@@ -0,0 +1,14 @@
1
+ /**
2
+ * Durable delivery of ONE conversion dispatch row (plan §5.2). Retries ride
3
+ * Hatchet (the deterministic event_id makes platform-side dedup safe);
4
+ * `deliverConversionDispatch` marks the row failed once attempts exhaust and
5
+ * stops throwing, so the task run ends cleanly.
6
+ */
7
+ export interface DispatchConversionInput {
8
+ dispatchId: string;
9
+ [key: string]: string;
10
+ }
11
+ export declare const dispatchConversionTask: import("@hatchet-dev/typescript-sdk/index.js").TaskWorkflowDeclaration<DispatchConversionInput, {
12
+ status: "delivered" | "failed" | "skipped";
13
+ }, {}, {}, {}, {}>;
14
+ //# sourceMappingURL=dispatch-conversion.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"dispatch-conversion.d.ts","sourceRoot":"","sources":["../../src/workflows/dispatch-conversion.ts"],"names":[],"mappings":"AAKA;;;;;GAKG;AACH,MAAM,WAAW,uBAAuB;IACtC,UAAU,EAAE,MAAM,CAAC;IACnB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC;CACvB;AAED,eAAO,MAAM,sBAAsB;;kBAcjC,CAAC"}
@@ -0,0 +1,96 @@
1
+ import type { JsonObject } from "@hatchet-dev/typescript-sdk/v1/types.js";
2
+ import { type Database } from "@hogsend/db";
3
+ import type { Logger } from "../lib/logger.js";
4
+ /** `import_jobs.format` discriminator for the reused status record. */
5
+ export declare const IDENTITY_ALIAS_BACKFILL_FORMAT = "identity-alias-backfill";
6
+ /**
7
+ * PRD 02 T3 — fill `contact_aliases` with a row per identity key of every LIVE
8
+ * contact, so the identity table can become the source of truth `findByKey`
9
+ * reads first. Keyset-paginated on the `contacts` PK; one classify SELECT plus
10
+ * one guarded INSERT per batch; no long-held transaction, no table lock.
11
+ *
12
+ * Invariants, each pinned by a test:
13
+ * - IDEMPOTENT — `ON CONFLICT (alias_kind, alias_value) DO NOTHING` against
14
+ * the plain unique index; a re-run (or a resume from zero) inserts nothing.
15
+ * - NEVER STEALS — a `(kind, value)` already claimed by a DIFFERENT contact is
16
+ * skipped and counted (`conflicting`), never repointed.
17
+ * - Soft-deleted contacts are EXCLUDED (`deleted_at IS NULL`): their keys are
18
+ * either a merged loser's (already aliased to the survivor by
19
+ * `recordMergeAliases`) or an erased person's (must not be resurrected).
20
+ * - Emails land NORMALIZED (`lower(trim(email))`) so the alias row matches the
21
+ * value the resolver's probes always compare against.
22
+ * - The row-uuid pseudo-key (`('external', contacts.id)`) is deliberately NOT
23
+ * backfilled — on a deployment using uuids as external ids it would contend
24
+ * with real keys, a history-theft-shaped outcome for a defensive row. The
25
+ * uuid probe stays last in `findByKey` instead.
26
+ */
27
+ export interface IdentityAliasBackfillInput extends JsonObject {
28
+ jobId: string;
29
+ /** Classify + count only; write nothing. Also reports the mixed-case email
30
+ * count (the datum behind PRD 02 T6's per-deployment decision). */
31
+ dryRun?: boolean;
32
+ }
33
+ export interface IdentityAliasBackfillResult extends JsonObject {
34
+ status: "completed" | "failed";
35
+ dryRun: boolean;
36
+ /** Live contacts scanned. */
37
+ scanned: number;
38
+ /** Alias rows written (projected, in a dry run). */
39
+ inserted: number;
40
+ /** Pairs already aliased to the SAME contact (benign; dominated by the
41
+ * dual-write once it has been live for a while). */
42
+ present: number;
43
+ /** Pairs whose `(kind, value)` is claimed by a DIFFERENT contact — the
44
+ * divergence metric. Never repointed; surfaced via the parity endpoint. */
45
+ conflicting: number;
46
+ /** Live contacts whose stored email differs from `lower(trim(email))` —
47
+ * re-measure per deployment before trusting the read flip for email (T6). */
48
+ mixedCaseEmails: number;
49
+ reason?: string;
50
+ }
51
+ /**
52
+ * The task body, exported directly so tests and operator scripts can run it
53
+ * without a Hatchet engine. `jobId` is optional: when present, progress is
54
+ * recorded on the `import_jobs` row (`processedRows` = contacts scanned,
55
+ * `failedRows` = conflicting pairs — the divergence metric, NOT an error
56
+ * count; the full breakdown is in the return value and the completion log).
57
+ */
58
+ export declare function runIdentityAliasBackfill(opts: {
59
+ db: Database;
60
+ logger: Logger;
61
+ jobId?: string;
62
+ dryRun?: boolean;
63
+ }): Promise<IdentityAliasBackfillResult>;
64
+ export declare const identityAliasBackfillTask: import("@hatchet-dev/typescript-sdk/index.js").TaskWorkflowDeclaration<IdentityAliasBackfillInput, IdentityAliasBackfillResult, {}, {}, {}, {}>;
65
+ /**
66
+ * Worker-boot enqueue (mirrors `enqueueBucketBackfills`): fire the backfill
67
+ * once per deployment without an operator having to remember it — the engine
68
+ * is a published dependency, and a manual step every consumer must run before
69
+ * the read flip is how deployments strand. Skips when ANY non-failed job of
70
+ * this format exists (pending/processing/completed); a failed run re-enqueues
71
+ * on the next boot, and `POST /v1/admin/identity/alias-backfill` forces a
72
+ * re-run past a stale record. Re-running is always safe (ON CONFLICT DO
73
+ * NOTHING), just not free — hence the skip. Best-effort: a failure to enqueue
74
+ * must never crash worker boot.
75
+ */
76
+ export declare function enqueueIdentityAliasBackfill(opts: {
77
+ db: Database;
78
+ logger: Logger;
79
+ }): Promise<void>;
80
+ export interface AliasParityRow {
81
+ kind: string;
82
+ /** Alias and column resolve to DIFFERENT live contacts. MUST be 0 before
83
+ * trusting alias-first resolution; a non-zero value is a data bug to fix on
84
+ * its own, never to flip over. */
85
+ diverged: number;
86
+ /** Alias target is dead/missing but a live column owner exists — expected,
87
+ * handled by `findByKey`'s live-target fall-through. */
88
+ aliasDead: number;
89
+ /** Alias exists with no column owner — the merge/promote population, and
90
+ * (after PRD 03) the point of the table. */
91
+ aliasOnly: number;
92
+ }
93
+ /** "Would alias-first return a different contact than column-first?", per kind,
94
+ * over every alias row. Pure read; no writes, no locks beyond the reads. */
95
+ export declare function identityAliasParity(db: Database): Promise<AliasParityRow[]>;
96
+ //# sourceMappingURL=identity-alias-backfill.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"identity-alias-backfill.d.ts","sourceRoot":"","sources":["../../src/workflows/identity-alias-backfill.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yCAAyC,CAAC;AAC1E,OAAO,EAAE,KAAK,QAAQ,EAAc,MAAM,aAAa,CAAC;AAKxD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAG/C,uEAAuE;AACvE,eAAO,MAAM,8BAA8B,4BAA4B,CAAC;AAKxE;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,WAAW,0BAA2B,SAAQ,UAAU;IAC5D,KAAK,EAAE,MAAM,CAAC;IACd;uEACmE;IACnE,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAID,MAAM,WAAW,2BAA4B,SAAQ,UAAU;IAC7D,MAAM,EAAE,WAAW,GAAG,QAAQ,CAAC;IAC/B,MAAM,EAAE,OAAO,CAAC;IAChB,6BAA6B;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,oDAAoD;IACpD,QAAQ,EAAE,MAAM,CAAC;IACjB;wDACoD;IACpD,OAAO,EAAE,MAAM,CAAC;IAChB;+EAC2E;IAC3E,WAAW,EAAE,MAAM,CAAC;IACpB;iFAC6E;IAC7E,eAAe,EAAE,MAAM,CAAC;IACxB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AA6HD;;;;;;GAMG;AACH,wBAAsB,wBAAwB,CAAC,IAAI,EAAE;IACnD,EAAE,EAAE,QAAQ,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB,GAAG,OAAO,CAAC,2BAA2B,CAAC,CA+HvC;AAED,eAAO,MAAM,yBAAyB,iJAcpC,CAAC;AAEH;;;;;;;;;;GAUG;AACH,wBAAsB,4BAA4B,CAAC,IAAI,EAAE;IACvD,EAAE,EAAE,QAAQ,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAChB,GAAG,OAAO,CAAC,IAAI,CAAC,CAkChB;AAMD,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb;;sCAEkC;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB;4DACwD;IACxD,SAAS,EAAE,MAAM,CAAC;IAClB;gDAC4C;IAC5C,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;4EAC4E;AAC5E,wBAAsB,mBAAmB,CACvC,EAAE,EAAE,QAAQ,GACX,OAAO,CAAC,cAAc,EAAE,CAAC,CAgC3B"}
@@ -0,0 +1,142 @@
1
+ import { type Database } from "@hogsend/db";
2
+ import { type Logger } from "../lib/logger.js";
3
+ import { type ImpactDigestEntry, type ImpactDigestLiftEntry, type ImpactDigestShippedEntry } from "../lib/outbound.js";
4
+ /**
5
+ * Structural slice of the journey registry the digest reads (goal + name).
6
+ * `JourneyRegistry.get` (@hogsend/core registry/index.ts:32-34) satisfies
7
+ * it; tests hand in a plain object. A registry MISS (blueprint journey,
8
+ * removed journey) degrades to nulls — never a crash.
9
+ */
10
+ export interface DigestRegistryLike {
11
+ get(id: string): {
12
+ goal?: string;
13
+ name?: string;
14
+ } | undefined;
15
+ }
16
+ /**
17
+ * Cron input. `now` is a TEST SEAM: the Hatchet cron always pushes `{}`
18
+ * and the task falls back to `Date.now()` — legal here (this is a cron
19
+ * task, not a journey; determinism is delivered by the daily dedupeKey).
20
+ */
21
+ export interface ImpactDigestInput {
22
+ now?: string;
23
+ }
24
+ export declare function subDays(date: Date, days: number): Date;
25
+ /**
26
+ * Watermark → window. `since` = the last impact.digest delivery's
27
+ * created_at (max), defaulting to a 7-day window on the first-ever run,
28
+ * clamped to at most 30 days back. Self-healing: pruned delivery rows
29
+ * widen the window at most to the clamp.
30
+ */
31
+ export declare function deriveDigestWindow(opts: {
32
+ lastDeliveryAt: Date | null;
33
+ now: Date;
34
+ }): {
35
+ since: Date;
36
+ until: Date;
37
+ };
38
+ /**
39
+ * Payload ordering + cap: lift entries first (desc |winProbability − 0.5|
40
+ * — strongest evidence up top), then shipped (desc firstSeenAt — newest
41
+ * change first); deterministic journeyId tiebreak; capped with a
42
+ * `truncated` flag.
43
+ */
44
+ export declare function assembleDigestEntries(opts: {
45
+ lift: ImpactDigestLiftEntry[];
46
+ shipped: ImpactDigestShippedEntry[];
47
+ cap: number;
48
+ }): {
49
+ entries: ImpactDigestEntry[];
50
+ truncated: boolean;
51
+ };
52
+ /**
53
+ * Detection A — "you shipped a change" (causal: false). Two queries, not
54
+ * one (a window-filtered GROUP BY cannot supply earlier hashes' first-seen),
55
+ * plus the label pass: a (journey, label) pair first observed in-window
56
+ * whose hash first-seen PREDATES the window is a label-only change — the
57
+ * first-class "shipped" signal for template reworks the hash cannot see.
58
+ * Inert until Decision A's columns fill (the IS NOT NULL filter); blueprint
59
+ * enrollments are covered automatically (this reads journey_states, not the
60
+ * code registry). Consumers MUST treat a new hash as "possible new
61
+ * version" — toolchain bumps can fork it with zero content change.
62
+ */
63
+ export declare function detectShippedVersions(opts: {
64
+ db: Database;
65
+ since: Date;
66
+ until: Date;
67
+ registry?: DigestRegistryLike;
68
+ logger?: Logger;
69
+ }): Promise<{
70
+ entries: ImpactDigestShippedEntry[];
71
+ }>;
72
+ /**
73
+ * Detection B — "working / hurting" (causal: true). Candidates = journeys
74
+ * with held-out rows inside the 90-day lift window, capped at
75
+ * CANDIDATE_CAP (warned when hit). Per candidate the unified helper runs
76
+ * two snapshots through a LIFT_CONCURRENCY pool: `now` (asOf = until) and
77
+ * — only when the frozen payload has no answer — `prev` (asOf = since).
78
+ *
79
+ * FROZEN-PAYLOAD OVERRIDE (the drift hole): `prev` is the LAST digest's
80
+ * as-REPORTED winProbability when available. Late-arriving/backfilled
81
+ * conversions can otherwise retroactively flip last week's probability
82
+ * across T, silently swallowing a real crossing or re-reporting one
83
+ * already sent. The recompute remains the fallback for journeys absent
84
+ * from the last payload.
85
+ *
86
+ * Crossing (not level) semantics — no weekly re-nag; the down side is
87
+ * included deliberately. Suppression is absolute; smallSample rides.
88
+ */
89
+ export declare function detectLiftCrossings(opts: {
90
+ db: Database;
91
+ since: Date;
92
+ until: Date;
93
+ threshold: number;
94
+ registry?: DigestRegistryLike;
95
+ previousWinProbabilities?: Map<string, number>;
96
+ logger?: Logger;
97
+ }): Promise<{
98
+ entries: ImpactDigestLiftEntry[];
99
+ }>;
100
+ /**
101
+ * Compose Detection A (+ label pass) and Detection B, then order + cap.
102
+ * Each detection degrades independently (per-section try/catch — the
103
+ * check-alerts posture): a failed section logs and yields zero entries of
104
+ * its kind rather than killing the whole digest.
105
+ */
106
+ export declare function buildImpactDigest(opts: {
107
+ db: Database;
108
+ since: Date;
109
+ until: Date;
110
+ threshold: number;
111
+ registry?: DigestRegistryLike;
112
+ previousWinProbabilities?: Map<string, number>;
113
+ logger?: Logger;
114
+ }): Promise<{
115
+ entries: ImpactDigestEntry[];
116
+ truncated: boolean;
117
+ }>;
118
+ /**
119
+ * The weekly impact digest cron (impact experiments D5). Read-only except
120
+ * the emit; no email/SMS (rendering the digest is a subscriber choice);
121
+ * inert without subscribers — the opt-in is an endpoint subscribing to
122
+ * impact.digest, NOT an env var. Registered in worker.ts baseWorkflows.
123
+ *
124
+ * REPLAY-LAW NOTE: this is a CRON task, not a journey — Date.now() is
125
+ * legal; determinism is delivered by the UTC-day dedupeKey plus
126
+ * emitOutbound's onConflictDoNothing fan-out on (endpointId, dedupeKey).
127
+ * That index is a plain uniqueIndex relying on NULL-distinctness, NOT a
128
+ * partial index — do not add a WHERE predicate to it.
129
+ *
130
+ * Documented consequence of the day-keyed dedupe: at most one digest per
131
+ * endpoint per UTC day, even on a sub-daily cron. The cross-midnight
132
+ * retry edge is self-healing (a retry re-reads the watermark; the window
133
+ * collapses to minutes and is almost surely empty → no emit).
134
+ */
135
+ export declare const impactDigestTask: import("@hatchet-dev/typescript-sdk/v1").TaskWorkflowDeclaration<import("@hatchet-dev/typescript-sdk/v1").JsonObject, {
136
+ emitted: boolean;
137
+ reason?: string;
138
+ entries?: number;
139
+ since?: string;
140
+ until?: string;
141
+ }, {}, {}, {}, {}>;
142
+ //# sourceMappingURL=impact-digest.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"impact-digest.d.ts","sourceRoot":"","sources":["../../src/workflows/impact-digest.ts"],"names":[],"mappings":"AACA,OAAO,EACL,KAAK,QAAQ,EAGd,MAAM,aAAa,CAAC;AAMrB,OAAO,EAAgB,KAAK,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC7D,OAAO,EAEL,KAAK,iBAAiB,EACtB,KAAK,qBAAqB,EAC1B,KAAK,wBAAwB,EAE9B,MAAM,oBAAoB,CAAC;AAW5B;;;;;GAKG;AACH,MAAM,WAAW,kBAAkB;IACjC,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS,CAAC;CAC/D;AAED;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IAChC,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAQD,wBAAgB,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAEtD;AAMD;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE;IACvC,cAAc,EAAE,IAAI,GAAG,IAAI,CAAC;IAC5B,GAAG,EAAE,IAAI,CAAC;CACX,GAAG;IAAE,KAAK,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,IAAI,CAAA;CAAE,CAO/B;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE;IAC1C,IAAI,EAAE,qBAAqB,EAAE,CAAC;IAC9B,OAAO,EAAE,wBAAwB,EAAE,CAAC;IACpC,GAAG,EAAE,MAAM,CAAC;CACb,GAAG;IAAE,OAAO,EAAE,iBAAiB,EAAE,CAAC;IAAC,SAAS,EAAE,OAAO,CAAA;CAAE,CAevD;AAqGD;;;;;;;;;;GAUG;AACH,wBAAsB,qBAAqB,CAAC,IAAI,EAAE;IAChD,EAAE,EAAE,QAAQ,CAAC;IACb,KAAK,EAAE,IAAI,CAAC;IACZ,KAAK,EAAE,IAAI,CAAC;IACZ,QAAQ,CAAC,EAAE,kBAAkB,CAAC;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,GAAG,OAAO,CAAC;IAAE,OAAO,EAAE,wBAAwB,EAAE,CAAA;CAAE,CAAC,CAkLnD;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,mBAAmB,CAAC,IAAI,EAAE;IAC9C,EAAE,EAAE,QAAQ,CAAC;IACb,KAAK,EAAE,IAAI,CAAC;IACZ,KAAK,EAAE,IAAI,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,kBAAkB,CAAC;IAC9B,wBAAwB,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/C,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,GAAG,OAAO,CAAC;IAAE,OAAO,EAAE,qBAAqB,EAAE,CAAA;CAAE,CAAC,CA8FhD;AAED;;;;;GAKG;AACH,wBAAsB,iBAAiB,CAAC,IAAI,EAAE;IAC5C,EAAE,EAAE,QAAQ,CAAC;IACb,KAAK,EAAE,IAAI,CAAC;IACZ,KAAK,EAAE,IAAI,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,kBAAkB,CAAC;IAC9B,wBAAwB,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/C,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,GAAG,OAAO,CAAC;IAAE,OAAO,EAAE,iBAAiB,EAAE,CAAC;IAAC,SAAS,EAAE,OAAO,CAAA;CAAE,CAAC,CAoBhE;AAwCD;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,gBAAgB;aAkBhB,OAAO;aACP,MAAM;cACL,MAAM;YACR,MAAM;YACN,MAAM;kBAkIhB,CAAC"}
@@ -0,0 +1,14 @@
1
+ export declare const importContactsTask: import("@hatchet-dev/typescript-sdk/index.js").TaskWorkflowDeclaration<{
2
+ jobId: string;
3
+ data: string;
4
+ format: string;
5
+ }, {
6
+ status: string;
7
+ processed?: undefined;
8
+ failed?: undefined;
9
+ } | {
10
+ status: string;
11
+ processed: number;
12
+ failed: number;
13
+ }, {}, {}, {}, {}>;
14
+ //# sourceMappingURL=import-contacts.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"import-contacts.d.ts","sourceRoot":"","sources":["../../src/workflows/import-contacts.ts"],"names":[],"mappings":"AAoEA,eAAO,MAAM,kBAAkB;WAIF,MAAM;UAAQ,MAAM;YAAU,MAAM;;;;;;;;;kBAqH/D,CAAC"}
@@ -0,0 +1,55 @@
1
+ export declare const SUPPRESSION_REASONS: readonly ["unsubscribed", "bounced", "complained"];
2
+ export type SuppressionReason = (typeof SUPPRESSION_REASONS)[number];
3
+ /** One raw input row (a parsed CSV record or a JSON array element). */
4
+ export interface SuppressionImportRow {
5
+ email?: string;
6
+ reason?: string;
7
+ externalId?: string;
8
+ }
9
+ /**
10
+ * The `email_preferences` update a validated row maps to. Timestamp columns
11
+ * are expressed as flags so the mapping stays pure (the task applies `now`):
12
+ * `recordBounce` = `bounce_count = GREATEST(bounce_count, 1)` + `last_bounce_at`,
13
+ * `setSuppressedAt` = `suppressed_at = now`.
14
+ */
15
+ export interface MappedSuppressionRow {
16
+ email: string;
17
+ externalId?: string;
18
+ reason: SuppressionReason;
19
+ update: {
20
+ unsubscribedAll?: boolean;
21
+ suppressed?: boolean;
22
+ setSuppressedAt?: boolean;
23
+ recordBounce?: boolean;
24
+ };
25
+ }
26
+ /**
27
+ * Pure row → preference-update mapping for the suppression import. Validates
28
+ * and lowercases `email`, defaults `reason` to `unsubscribed`, and maps each
29
+ * reason onto the existing derived `email_preferences` semantics (NO schema
30
+ * change — see `routes/admin/suppressions.ts` typeFilter):
31
+ *
32
+ * - `unsubscribed` → `unsubscribed_all = true`
33
+ * - `bounced` → `suppressed = true` + bounce slate (`bounce_count >= 1`)
34
+ * - `complained` → `suppressed = true` with `bounce_count` untouched, so the
35
+ * derived "complained" view (suppressed AND bounceCount = 0)
36
+ * still identifies it
37
+ *
38
+ * Throws on an invalid row (missing/malformed email, unknown reason); the task
39
+ * records the error against the row index.
40
+ */
41
+ export declare function mapSuppressionRow(row: SuppressionImportRow): MappedSuppressionRow;
42
+ export declare const importSuppressionsTask: import("@hatchet-dev/typescript-sdk/index.js").TaskWorkflowDeclaration<{
43
+ jobId: string;
44
+ data: string;
45
+ format: string;
46
+ }, {
47
+ status: string;
48
+ processed?: undefined;
49
+ failed?: undefined;
50
+ } | {
51
+ status: string;
52
+ processed: number;
53
+ failed: number;
54
+ }, {}, {}, {}, {}>;
55
+ //# sourceMappingURL=import-suppressions.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"import-suppressions.d.ts","sourceRoot":"","sources":["../../src/workflows/import-suppressions.ts"],"names":[],"mappings":"AAUA,eAAO,MAAM,mBAAmB,oDAItB,CAAC;AAEX,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,mBAAmB,CAAC,CAAC,MAAM,CAAC,CAAC;AAErE,uEAAuE;AACvE,MAAM,WAAW,oBAAoB;IACnC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;;GAKG;AACH,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,iBAAiB,CAAC;IAC1B,MAAM,EAAE;QACN,eAAe,CAAC,EAAE,OAAO,CAAC;QAC1B,UAAU,CAAC,EAAE,OAAO,CAAC;QACrB,eAAe,CAAC,EAAE,OAAO,CAAC;QAC1B,YAAY,CAAC,EAAE,OAAO,CAAC;KACxB,CAAC;CACH;AAOD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,oBAAoB,GACxB,oBAAoB,CAqCtB;AAED,eAAO,MAAM,sBAAsB;WAIN,MAAM;UAAQ,MAAM;YAAU,MAAM;;;;;;;;;kBAmF/D,CAAC"}