@hogsend/engine 0.67.0 → 0.68.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (738) hide show
  1. package/README.md +3 -2
  2. package/dist/account-links/__fixtures__/fake-fetch.d.ts +38 -0
  3. package/dist/account-links/__fixtures__/fake-fetch.d.ts.map +1 -0
  4. package/dist/account-links/battlenet.d.ts +36 -0
  5. package/dist/account-links/battlenet.d.ts.map +1 -0
  6. package/dist/account-links/epic.d.ts +36 -0
  7. package/dist/account-links/epic.d.ts.map +1 -0
  8. package/dist/account-links/index.d.ts +7 -0
  9. package/dist/account-links/index.d.ts.map +1 -0
  10. package/dist/account-links/riot.d.ts +35 -0
  11. package/dist/account-links/riot.d.ts.map +1 -0
  12. package/dist/account-links/steam.d.ts +35 -0
  13. package/dist/account-links/steam.d.ts.map +1 -0
  14. package/dist/account-links/twitch.d.ts +38 -0
  15. package/dist/account-links/twitch.d.ts.map +1 -0
  16. package/dist/account-links/xbox.d.ts +39 -0
  17. package/dist/account-links/xbox.d.ts.map +1 -0
  18. package/dist/app.d.ts +50 -0
  19. package/dist/app.d.ts.map +1 -0
  20. package/dist/buckets/bucket-access.d.ts +60 -0
  21. package/dist/buckets/bucket-access.d.ts.map +1 -0
  22. package/dist/buckets/bucket-reactions.d.ts +100 -0
  23. package/dist/buckets/bucket-reactions.d.ts.map +1 -0
  24. package/dist/buckets/check-membership.d.ts +105 -0
  25. package/dist/buckets/check-membership.d.ts.map +1 -0
  26. package/dist/buckets/define-bucket.d.ts +53 -0
  27. package/dist/buckets/define-bucket.d.ts.map +1 -0
  28. package/dist/buckets/membership-epoch.d.ts +74 -0
  29. package/dist/buckets/membership-epoch.d.ts.map +1 -0
  30. package/dist/buckets/registry-singleton.d.ts +6 -0
  31. package/dist/buckets/registry-singleton.d.ts.map +1 -0
  32. package/dist/buckets/registry.d.ts +59 -0
  33. package/dist/buckets/registry.d.ts.map +1 -0
  34. package/dist/campaigns/cohort-sql.d.ts +54 -0
  35. package/dist/campaigns/cohort-sql.d.ts.map +1 -0
  36. package/dist/campaigns/define-campaign.d.ts +105 -0
  37. package/dist/campaigns/define-campaign.d.ts.map +1 -0
  38. package/dist/campaigns/reconcile.d.ts +13 -0
  39. package/dist/campaigns/reconcile.d.ts.map +1 -0
  40. package/dist/campaigns/steps.d.ts +29 -0
  41. package/dist/campaigns/steps.d.ts.map +1 -0
  42. package/dist/cold-connect/index.d.ts +98 -0
  43. package/dist/cold-connect/index.d.ts.map +1 -0
  44. package/dist/cold-connect/page.d.ts +69 -0
  45. package/dist/cold-connect/page.d.ts.map +1 -0
  46. package/dist/cold-connect/throttle.d.ts +39 -0
  47. package/dist/cold-connect/throttle.d.ts.map +1 -0
  48. package/dist/cold-connect/token.d.ts +57 -0
  49. package/dist/cold-connect/token.d.ts.map +1 -0
  50. package/dist/connectors/action-registry-singleton.d.ts +21 -0
  51. package/dist/connectors/action-registry-singleton.d.ts.map +1 -0
  52. package/dist/connectors/define-action.d.ts +117 -0
  53. package/dist/connectors/define-action.d.ts.map +1 -0
  54. package/dist/connectors/define-connector.d.ts +172 -0
  55. package/dist/connectors/define-connector.d.ts.map +1 -0
  56. package/dist/connectors/presets/index.d.ts +17 -0
  57. package/dist/connectors/presets/index.d.ts.map +1 -0
  58. package/dist/connectors/registry-singleton.d.ts +34 -0
  59. package/dist/connectors/registry-singleton.d.ts.map +1 -0
  60. package/dist/connectors/runtime.d.ts +68 -0
  61. package/dist/connectors/runtime.d.ts.map +1 -0
  62. package/dist/container.d.ts +678 -0
  63. package/dist/container.d.ts.map +1 -0
  64. package/dist/destinations/define-destination.d.ts +96 -0
  65. package/dist/destinations/define-destination.d.ts.map +1 -0
  66. package/dist/destinations/presets/index.d.ts +42 -0
  67. package/dist/destinations/presets/index.d.ts.map +1 -0
  68. package/dist/destinations/presets/posthog.d.ts +12 -0
  69. package/dist/destinations/presets/posthog.d.ts.map +1 -0
  70. package/dist/destinations/presets/segment.d.ts +15 -0
  71. package/dist/destinations/presets/segment.d.ts.map +1 -0
  72. package/dist/destinations/presets/slack.d.ts +10 -0
  73. package/dist/destinations/presets/slack.d.ts.map +1 -0
  74. package/dist/destinations/presets/webhook.d.ts +14 -0
  75. package/dist/destinations/presets/webhook.d.ts.map +1 -0
  76. package/dist/destinations/registry-singleton.d.ts +44 -0
  77. package/dist/destinations/registry-singleton.d.ts.map +1 -0
  78. package/dist/env.d.ts +119 -0
  79. package/dist/env.d.ts.map +1 -0
  80. package/dist/flags/reconcile.d.ts +36 -0
  81. package/dist/flags/reconcile.d.ts.map +1 -0
  82. package/dist/index.d.ts +210 -0
  83. package/dist/index.d.ts.map +1 -0
  84. package/dist/journeys/authoring.d.ts +15 -0
  85. package/dist/journeys/authoring.d.ts.map +1 -0
  86. package/dist/journeys/client-defaults-singleton.d.ts +16 -0
  87. package/dist/journeys/client-defaults-singleton.d.ts.map +1 -0
  88. package/dist/journeys/constants.d.ts +32 -0
  89. package/dist/journeys/constants.d.ts.map +1 -0
  90. package/dist/journeys/define-journey.d.ts +33 -0
  91. package/dist/journeys/define-journey.d.ts.map +1 -0
  92. package/dist/journeys/durable-law-harness.d.ts +74 -0
  93. package/dist/journeys/durable-law-harness.d.ts.map +1 -0
  94. package/dist/journeys/errors.d.ts +13 -0
  95. package/dist/journeys/errors.d.ts.map +1 -0
  96. package/dist/journeys/execute-journey-run.d.ts +160 -0
  97. package/dist/journeys/execute-journey-run.d.ts.map +1 -0
  98. package/dist/journeys/graph/build-graph.d.ts +24 -0
  99. package/dist/journeys/graph/build-graph.d.ts.map +1 -0
  100. package/dist/journeys/group-scope.d.ts +56 -0
  101. package/dist/journeys/group-scope.d.ts.map +1 -0
  102. package/dist/journeys/journey-boundary.d.ts +264 -0
  103. package/dist/journeys/journey-boundary.d.ts.map +1 -0
  104. package/dist/journeys/journey-context.d.ts +60 -0
  105. package/dist/journeys/journey-context.d.ts.map +1 -0
  106. package/dist/journeys/journey-log.d.ts +42 -0
  107. package/dist/journeys/journey-log.d.ts.map +1 -0
  108. package/dist/journeys/journey-source-locations-singleton.d.ts +6 -0
  109. package/dist/journeys/journey-source-locations-singleton.d.ts.map +1 -0
  110. package/dist/journeys/journey-sources-singleton.d.ts +5 -0
  111. package/dist/journeys/journey-sources-singleton.d.ts.map +1 -0
  112. package/dist/journeys/journey-task-factory.d.ts +11 -0
  113. package/dist/journeys/journey-task-factory.d.ts.map +1 -0
  114. package/dist/journeys/journey-task-runtime.d.ts +2 -0
  115. package/dist/journeys/journey-task-runtime.d.ts.map +1 -0
  116. package/dist/journeys/journey-version.d.ts +71 -0
  117. package/dist/journeys/journey-version.d.ts.map +1 -0
  118. package/dist/journeys/record-once.d.ts +56 -0
  119. package/dist/journeys/record-once.d.ts.map +1 -0
  120. package/dist/journeys/registry-singleton.d.ts +6 -0
  121. package/dist/journeys/registry-singleton.d.ts.map +1 -0
  122. package/dist/journeys/registry.d.ts +59 -0
  123. package/dist/journeys/registry.d.ts.map +1 -0
  124. package/dist/journeys/with-durable-gate.d.ts +97 -0
  125. package/dist/journeys/with-durable-gate.d.ts.map +1 -0
  126. package/dist/lib/account-link-emit.d.ts +69 -0
  127. package/dist/lib/account-link-emit.d.ts.map +1 -0
  128. package/dist/lib/account-link-events.d.ts +128 -0
  129. package/dist/lib/account-link-events.d.ts.map +1 -0
  130. package/dist/lib/account-link-hooks.d.ts +32 -0
  131. package/dist/lib/account-link-hooks.d.ts.map +1 -0
  132. package/dist/lib/account-link-ingest.d.ts +78 -0
  133. package/dist/lib/account-link-ingest.d.ts.map +1 -0
  134. package/dist/lib/account-link-nonce.d.ts +29 -0
  135. package/dist/lib/account-link-nonce.d.ts.map +1 -0
  136. package/dist/lib/account-link-origins.d.ts +37 -0
  137. package/dist/lib/account-link-origins.d.ts.map +1 -0
  138. package/dist/lib/account-link-pkce.d.ts +48 -0
  139. package/dist/lib/account-link-pkce.d.ts.map +1 -0
  140. package/dist/lib/account-link-provider-registry.d.ts +35 -0
  141. package/dist/lib/account-link-provider-registry.d.ts.map +1 -0
  142. package/dist/lib/account-link-throttle.d.ts +76 -0
  143. package/dist/lib/account-link-throttle.d.ts.map +1 -0
  144. package/dist/lib/account-link-url.d.ts +41 -0
  145. package/dist/lib/account-link-url.d.ts.map +1 -0
  146. package/dist/lib/account-links-from-env.d.ts +62 -0
  147. package/dist/lib/account-links-from-env.d.ts.map +1 -0
  148. package/dist/lib/account-links.d.ts +353 -0
  149. package/dist/lib/account-links.d.ts.map +1 -0
  150. package/dist/lib/agent/config.d.ts +14 -0
  151. package/dist/lib/agent/config.d.ts.map +1 -0
  152. package/dist/lib/agent/proposals.d.ts +52 -0
  153. package/dist/lib/agent/proposals.d.ts.map +1 -0
  154. package/dist/lib/agent/provider.d.ts +9 -0
  155. package/dist/lib/agent/provider.d.ts.map +1 -0
  156. package/dist/lib/agent/risk.d.ts +24 -0
  157. package/dist/lib/agent/risk.d.ts.map +1 -0
  158. package/dist/lib/agent/system-prompt.d.ts +8 -0
  159. package/dist/lib/agent/system-prompt.d.ts.map +1 -0
  160. package/dist/lib/agent/tools.d.ts +258 -0
  161. package/dist/lib/agent/tools.d.ts.map +1 -0
  162. package/dist/lib/alerting.d.ts +7 -0
  163. package/dist/lib/alerting.d.ts.map +1 -0
  164. package/dist/lib/analytics-adapter.d.ts +24 -0
  165. package/dist/lib/analytics-adapter.d.ts.map +1 -0
  166. package/dist/lib/analytics-identity.d.ts +60 -0
  167. package/dist/lib/analytics-identity.d.ts.map +1 -0
  168. package/dist/lib/analytics-provider-registry.d.ts +20 -0
  169. package/dist/lib/analytics-provider-registry.d.ts.map +1 -0
  170. package/dist/lib/analytics-providers-from-env.d.ts +41 -0
  171. package/dist/lib/analytics-providers-from-env.d.ts.map +1 -0
  172. package/dist/lib/analytics-singleton.d.ts +10 -0
  173. package/dist/lib/analytics-singleton.d.ts.map +1 -0
  174. package/dist/lib/api-key-hash.d.ts +9 -0
  175. package/dist/lib/api-key-hash.d.ts.map +1 -0
  176. package/dist/lib/app-secret.d.ts +29 -0
  177. package/dist/lib/app-secret.d.ts.map +1 -0
  178. package/dist/lib/attachments.d.ts +53 -0
  179. package/dist/lib/attachments.d.ts.map +1 -0
  180. package/dist/lib/attribution-backfill.d.ts +48 -0
  181. package/dist/lib/attribution-backfill.d.ts.map +1 -0
  182. package/dist/lib/attribution.d.ts +44 -0
  183. package/dist/lib/attribution.d.ts.map +1 -0
  184. package/dist/lib/auth.d.ts +136 -0
  185. package/dist/lib/auth.d.ts.map +1 -0
  186. package/dist/lib/backfill.d.ts +41 -0
  187. package/dist/lib/backfill.d.ts.map +1 -0
  188. package/dist/lib/banner.d.ts +52 -0
  189. package/dist/lib/banner.d.ts.map +1 -0
  190. package/dist/lib/blueprint-lock.d.ts +19 -0
  191. package/dist/lib/blueprint-lock.d.ts.map +1 -0
  192. package/dist/lib/blueprints.d.ts +573 -0
  193. package/dist/lib/blueprints.d.ts.map +1 -0
  194. package/dist/lib/boot-api-key.d.ts +38 -0
  195. package/dist/lib/boot-api-key.d.ts.map +1 -0
  196. package/dist/lib/boot.d.ts +23 -0
  197. package/dist/lib/boot.d.ts.map +1 -0
  198. package/dist/lib/bootstrap-admin.d.ts +33 -0
  199. package/dist/lib/bootstrap-admin.d.ts.map +1 -0
  200. package/dist/lib/bot-prefetch.d.ts +21 -0
  201. package/dist/lib/bot-prefetch.d.ts.map +1 -0
  202. package/dist/lib/bucket-emit.d.ts +75 -0
  203. package/dist/lib/bucket-emit.d.ts.map +1 -0
  204. package/dist/lib/bucket-posthog-sync.d.ts +29 -0
  205. package/dist/lib/bucket-posthog-sync.d.ts.map +1 -0
  206. package/dist/lib/campaign-send-key.d.ts +31 -0
  207. package/dist/lib/campaign-send-key.d.ts.map +1 -0
  208. package/dist/lib/connector-actions.d.ts +83 -0
  209. package/dist/lib/connector-actions.d.ts.map +1 -0
  210. package/dist/lib/connector-heartbeat.d.ts +35 -0
  211. package/dist/lib/connector-heartbeat.d.ts.map +1 -0
  212. package/dist/lib/connector-link-codes.d.ts +105 -0
  213. package/dist/lib/connector-link-codes.d.ts.map +1 -0
  214. package/dist/lib/connector-state.d.ts +97 -0
  215. package/dist/lib/connector-state.d.ts.map +1 -0
  216. package/dist/lib/contacts.d.ts +622 -0
  217. package/dist/lib/contacts.d.ts.map +1 -0
  218. package/dist/lib/conversion-dispatch.d.ts +98 -0
  219. package/dist/lib/conversion-dispatch.d.ts.map +1 -0
  220. package/dist/lib/conversions.d.ts +75 -0
  221. package/dist/lib/conversions.d.ts.map +1 -0
  222. package/dist/lib/create-admin.d.ts +54 -0
  223. package/dist/lib/create-admin.d.ts.map +1 -0
  224. package/dist/lib/crm-deals.d.ts +66 -0
  225. package/dist/lib/crm-deals.d.ts.map +1 -0
  226. package/dist/lib/crm-ingest.d.ts +38 -0
  227. package/dist/lib/crm-ingest.d.ts.map +1 -0
  228. package/dist/lib/crm-provider-registry.d.ts +20 -0
  229. package/dist/lib/crm-provider-registry.d.ts.map +1 -0
  230. package/dist/lib/crm-registry-singleton.d.ts +18 -0
  231. package/dist/lib/crm-registry-singleton.d.ts.map +1 -0
  232. package/dist/lib/db.d.ts +3 -0
  233. package/dist/lib/db.d.ts.map +1 -0
  234. package/dist/lib/deal-money-events.d.ts +35 -0
  235. package/dist/lib/deal-money-events.d.ts.map +1 -0
  236. package/dist/lib/discord-gateway-heartbeat.d.ts +47 -0
  237. package/dist/lib/discord-gateway-heartbeat.d.ts.map +1 -0
  238. package/dist/lib/domain-status.d.ts +87 -0
  239. package/dist/lib/domain-status.d.ts.map +1 -0
  240. package/dist/lib/email-provider-registry.d.ts +30 -0
  241. package/dist/lib/email-provider-registry.d.ts.map +1 -0
  242. package/dist/lib/email-providers-from-env.d.ts +12 -0
  243. package/dist/lib/email-providers-from-env.d.ts.map +1 -0
  244. package/dist/lib/email-service-types.d.ts +189 -0
  245. package/dist/lib/email-service-types.d.ts.map +1 -0
  246. package/dist/lib/email-stats.d.ts +12 -0
  247. package/dist/lib/email-stats.d.ts.map +1 -0
  248. package/dist/lib/email.d.ts +73 -0
  249. package/dist/lib/email.d.ts.map +1 -0
  250. package/dist/lib/enrichment-ledger.d.ts +101 -0
  251. package/dist/lib/enrichment-ledger.d.ts.map +1 -0
  252. package/dist/lib/enrichment-provider-registry.d.ts +20 -0
  253. package/dist/lib/enrichment-provider-registry.d.ts.map +1 -0
  254. package/dist/lib/enrichment-providers-from-env.d.ts +13 -0
  255. package/dist/lib/enrichment-providers-from-env.d.ts.map +1 -0
  256. package/dist/lib/enrichment-registry-singleton.d.ts +9 -0
  257. package/dist/lib/enrichment-registry-singleton.d.ts.map +1 -0
  258. package/dist/lib/enrollment-guards.d.ts +28 -0
  259. package/dist/lib/enrollment-guards.d.ts.map +1 -0
  260. package/dist/lib/enrollment-policy.d.ts +25 -0
  261. package/dist/lib/enrollment-policy.d.ts.map +1 -0
  262. package/dist/lib/event-names.d.ts +27 -0
  263. package/dist/lib/event-names.d.ts.map +1 -0
  264. package/dist/lib/feed.d.ts +64 -0
  265. package/dist/lib/feed.d.ts.map +1 -0
  266. package/dist/lib/flags-registry.d.ts +23 -0
  267. package/dist/lib/flags-registry.d.ts.map +1 -0
  268. package/dist/lib/flags.d.ts +143 -0
  269. package/dist/lib/flags.d.ts.map +1 -0
  270. package/dist/lib/frequency-cap.d.ts +38 -0
  271. package/dist/lib/frequency-cap.d.ts.map +1 -0
  272. package/dist/lib/from-address.d.ts +15 -0
  273. package/dist/lib/from-address.d.ts.map +1 -0
  274. package/dist/lib/funnel-progress.d.ts +37 -0
  275. package/dist/lib/funnel-progress.d.ts.map +1 -0
  276. package/dist/lib/funnel-registry.d.ts +44 -0
  277. package/dist/lib/funnel-registry.d.ts.map +1 -0
  278. package/dist/lib/funnel-transitions.d.ts +63 -0
  279. package/dist/lib/funnel-transitions.d.ts.map +1 -0
  280. package/dist/lib/fx.d.ts +118 -0
  281. package/dist/lib/fx.d.ts.map +1 -0
  282. package/dist/lib/global-control-readout.d.ts +72 -0
  283. package/dist/lib/global-control-readout.d.ts.map +1 -0
  284. package/dist/lib/groups.d.ts +138 -0
  285. package/dist/lib/groups.d.ts.map +1 -0
  286. package/dist/lib/hatchet-duration.d.ts +14 -0
  287. package/dist/lib/hatchet-duration.d.ts.map +1 -0
  288. package/dist/lib/hatchet.d.ts +3 -0
  289. package/dist/lib/hatchet.d.ts.map +1 -0
  290. package/dist/lib/headers.d.ts +8 -0
  291. package/dist/lib/headers.d.ts.map +1 -0
  292. package/dist/lib/holdout.d.ts +36 -0
  293. package/dist/lib/holdout.d.ts.map +1 -0
  294. package/dist/lib/html.d.ts +5 -0
  295. package/dist/lib/html.d.ts.map +1 -0
  296. package/dist/lib/identity-service.d.ts +60 -0
  297. package/dist/lib/identity-service.d.ts.map +1 -0
  298. package/dist/lib/identity-token.d.ts +81 -0
  299. package/dist/lib/identity-token.d.ts.map +1 -0
  300. package/dist/lib/ingestion.d.ts +218 -0
  301. package/dist/lib/ingestion.d.ts.map +1 -0
  302. package/dist/lib/journey-lift.d.ts +56 -0
  303. package/dist/lib/journey-lift.d.ts.map +1 -0
  304. package/dist/lib/journey-suppress.d.ts +59 -0
  305. package/dist/lib/journey-suppress.d.ts.map +1 -0
  306. package/dist/lib/leader-lease.d.ts +36 -0
  307. package/dist/lib/leader-lease.d.ts.map +1 -0
  308. package/dist/lib/lift-stats.d.ts +46 -0
  309. package/dist/lib/lift-stats.d.ts.map +1 -0
  310. package/dist/lib/links.d.ts +186 -0
  311. package/dist/lib/links.d.ts.map +1 -0
  312. package/dist/lib/load-optional-plugin.d.ts +47 -0
  313. package/dist/lib/load-optional-plugin.d.ts.map +1 -0
  314. package/dist/lib/logger.d.ts +4 -0
  315. package/dist/lib/logger.d.ts.map +1 -0
  316. package/dist/lib/mailer.d.ts +43 -0
  317. package/dist/lib/mailer.d.ts.map +1 -0
  318. package/dist/lib/metrics-sql.d.ts +11 -0
  319. package/dist/lib/metrics-sql.d.ts.map +1 -0
  320. package/dist/lib/notifications.d.ts +17 -0
  321. package/dist/lib/notifications.d.ts.map +1 -0
  322. package/dist/lib/oauth-token-manager.d.ts +74 -0
  323. package/dist/lib/oauth-token-manager.d.ts.map +1 -0
  324. package/dist/lib/operator-settings.d.ts +33 -0
  325. package/dist/lib/operator-settings.d.ts.map +1 -0
  326. package/dist/lib/operator.d.ts +20 -0
  327. package/dist/lib/operator.d.ts.map +1 -0
  328. package/dist/lib/outbound-endpoint-cache.d.ts +25 -0
  329. package/dist/lib/outbound-endpoint-cache.d.ts.map +1 -0
  330. package/dist/lib/outbound.d.ts +687 -0
  331. package/dist/lib/outbound.d.ts.map +1 -0
  332. package/dist/lib/phone.d.ts +11 -0
  333. package/dist/lib/phone.d.ts.map +1 -0
  334. package/dist/lib/posthog-scopes.d.ts +30 -0
  335. package/dist/lib/posthog-scopes.d.ts.map +1 -0
  336. package/dist/lib/posthog.d.ts +16 -0
  337. package/dist/lib/posthog.d.ts.map +1 -0
  338. package/dist/lib/preferences.d.ts +72 -0
  339. package/dist/lib/preferences.d.ts.map +1 -0
  340. package/dist/lib/provider-credentials.d.ts +149 -0
  341. package/dist/lib/provider-credentials.d.ts.map +1 -0
  342. package/dist/lib/provision-posthog-loop.d.ts +100 -0
  343. package/dist/lib/provision-posthog-loop.d.ts.map +1 -0
  344. package/dist/lib/recipient-preferences.d.ts +29 -0
  345. package/dist/lib/recipient-preferences.d.ts.map +1 -0
  346. package/dist/lib/redis.d.ts +33 -0
  347. package/dist/lib/redis.d.ts.map +1 -0
  348. package/dist/lib/referral-intent.d.ts +99 -0
  349. package/dist/lib/referral-intent.d.ts.map +1 -0
  350. package/dist/lib/referral-link.d.ts +59 -0
  351. package/dist/lib/referral-link.d.ts.map +1 -0
  352. package/dist/lib/referral-registry.d.ts +37 -0
  353. package/dist/lib/referral-registry.d.ts.map +1 -0
  354. package/dist/lib/referral-report.d.ts +178 -0
  355. package/dist/lib/referral-report.d.ts.map +1 -0
  356. package/dist/lib/referral-runtime.d.ts +43 -0
  357. package/dist/lib/referral-runtime.d.ts.map +1 -0
  358. package/dist/lib/referrals.d.ts +184 -0
  359. package/dist/lib/referrals.d.ts.map +1 -0
  360. package/dist/lib/refine-chain.d.ts +236 -0
  361. package/dist/lib/refine-chain.d.ts.map +1 -0
  362. package/dist/lib/refine-traits.d.ts +78 -0
  363. package/dist/lib/refine-traits.d.ts.map +1 -0
  364. package/dist/lib/refine.d.ts +35 -0
  365. package/dist/lib/refine.d.ts.map +1 -0
  366. package/dist/lib/reset-email.d.ts +38 -0
  367. package/dist/lib/reset-email.d.ts.map +1 -0
  368. package/dist/lib/revenue.d.ts +61 -0
  369. package/dist/lib/revenue.d.ts.map +1 -0
  370. package/dist/lib/schemas.d.ts +9 -0
  371. package/dist/lib/schemas.d.ts.map +1 -0
  372. package/dist/lib/seed-posthog-destination.d.ts +22 -0
  373. package/dist/lib/seed-posthog-destination.d.ts.map +1 -0
  374. package/dist/lib/semantic-click.d.ts +58 -0
  375. package/dist/lib/semantic-click.d.ts.map +1 -0
  376. package/dist/lib/sending-domain-guidance.d.ts +40 -0
  377. package/dist/lib/sending-domain-guidance.d.ts.map +1 -0
  378. package/dist/lib/singleton.d.ts +24 -0
  379. package/dist/lib/singleton.d.ts.map +1 -0
  380. package/dist/lib/sms-frequency-cap.d.ts +16 -0
  381. package/dist/lib/sms-frequency-cap.d.ts.map +1 -0
  382. package/dist/lib/sms-inbound.d.ts +37 -0
  383. package/dist/lib/sms-inbound.d.ts.map +1 -0
  384. package/dist/lib/sms-link-tracking.d.ts +53 -0
  385. package/dist/lib/sms-link-tracking.d.ts.map +1 -0
  386. package/dist/lib/sms-mailer.d.ts +12 -0
  387. package/dist/lib/sms-mailer.d.ts.map +1 -0
  388. package/dist/lib/sms-provider-registry.d.ts +20 -0
  389. package/dist/lib/sms-provider-registry.d.ts.map +1 -0
  390. package/dist/lib/sms-providers-from-env.d.ts +4 -0
  391. package/dist/lib/sms-providers-from-env.d.ts.map +1 -0
  392. package/dist/lib/sms-service-types.d.ts +131 -0
  393. package/dist/lib/sms-service-types.d.ts.map +1 -0
  394. package/dist/lib/sms-tracked.d.ts +36 -0
  395. package/dist/lib/sms-tracked.d.ts.map +1 -0
  396. package/dist/lib/sms.d.ts +58 -0
  397. package/dist/lib/sms.d.ts.map +1 -0
  398. package/dist/lib/snippet.d.ts +32 -0
  399. package/dist/lib/snippet.d.ts.map +1 -0
  400. package/dist/lib/stable-stringify.d.ts +12 -0
  401. package/dist/lib/stable-stringify.d.ts.map +1 -0
  402. package/dist/lib/studio.d.ts +21 -0
  403. package/dist/lib/studio.d.ts.map +1 -0
  404. package/dist/lib/survey.d.ts +35 -0
  405. package/dist/lib/survey.d.ts.map +1 -0
  406. package/dist/lib/test-mode.d.ts +77 -0
  407. package/dist/lib/test-mode.d.ts.map +1 -0
  408. package/dist/lib/timezone.d.ts +55 -0
  409. package/dist/lib/timezone.d.ts.map +1 -0
  410. package/dist/lib/tracked.d.ts +95 -0
  411. package/dist/lib/tracked.d.ts.map +1 -0
  412. package/dist/lib/tracking-event-names.d.ts +7 -0
  413. package/dist/lib/tracking-event-names.d.ts.map +1 -0
  414. package/dist/lib/tracking-events.d.ts +232 -0
  415. package/dist/lib/tracking-events.d.ts.map +1 -0
  416. package/dist/lib/tracking.d.ts +47 -0
  417. package/dist/lib/tracking.d.ts.map +1 -0
  418. package/dist/lib/unconfigured-email-provider.d.ts +20 -0
  419. package/dist/lib/unconfigured-email-provider.d.ts.map +1 -0
  420. package/dist/lib/unique-violation.d.ts +22 -0
  421. package/dist/lib/unique-violation.d.ts.map +1 -0
  422. package/dist/lib/user-token.d.ts +44 -0
  423. package/dist/lib/user-token.d.ts.map +1 -0
  424. package/dist/lib/variant.d.ts +44 -0
  425. package/dist/lib/variant.d.ts.map +1 -0
  426. package/dist/lib/webhook-signing.d.ts +120 -0
  427. package/dist/lib/webhook-signing.d.ts.map +1 -0
  428. package/dist/lib/worker-heartbeat.d.ts +18 -0
  429. package/dist/lib/worker-heartbeat.d.ts.map +1 -0
  430. package/dist/lists/channels.d.ts +43 -0
  431. package/dist/lists/channels.d.ts.map +1 -0
  432. package/dist/lists/define-list.d.ts +76 -0
  433. package/dist/lists/define-list.d.ts.map +1 -0
  434. package/dist/lists/registry-singleton.d.ts +8 -0
  435. package/dist/lists/registry-singleton.d.ts.map +1 -0
  436. package/dist/lists/registry.d.ts +66 -0
  437. package/dist/lists/registry.d.ts.map +1 -0
  438. package/dist/lists/subscription.d.ts +10 -0
  439. package/dist/lists/subscription.d.ts.map +1 -0
  440. package/dist/mcp/authoring-guide.d.ts +33 -0
  441. package/dist/mcp/authoring-guide.d.ts.map +1 -0
  442. package/dist/mcp/blueprint-tools.d.ts +266 -0
  443. package/dist/mcp/blueprint-tools.d.ts.map +1 -0
  444. package/dist/middleware/api-key.d.ts +45 -0
  445. package/dist/middleware/api-key.d.ts.map +1 -0
  446. package/dist/middleware/audit.d.ts +3 -0
  447. package/dist/middleware/audit.d.ts.map +1 -0
  448. package/dist/middleware/error-handler.d.ts +4 -0
  449. package/dist/middleware/error-handler.d.ts.map +1 -0
  450. package/dist/middleware/publishable-key.d.ts +27 -0
  451. package/dist/middleware/publishable-key.d.ts.map +1 -0
  452. package/dist/middleware/rate-limit.d.ts +105 -0
  453. package/dist/middleware/rate-limit.d.ts.map +1 -0
  454. package/dist/middleware/request-logger.d.ts +4 -0
  455. package/dist/middleware/request-logger.d.ts.map +1 -0
  456. package/dist/middleware/require-admin.d.ts +3 -0
  457. package/dist/middleware/require-admin.d.ts.map +1 -0
  458. package/dist/routes/_shared.d.ts +52 -0
  459. package/dist/routes/_shared.d.ts.map +1 -0
  460. package/dist/routes/accounts/callback.d.ts +18 -0
  461. package/dist/routes/accounts/callback.d.ts.map +1 -0
  462. package/dist/routes/accounts/emit.d.ts +96 -0
  463. package/dist/routes/accounts/emit.d.ts.map +1 -0
  464. package/dist/routes/accounts/import-links.d.ts +4 -0
  465. package/dist/routes/accounts/import-links.d.ts.map +1 -0
  466. package/dist/routes/accounts/index.d.ts +39 -0
  467. package/dist/routes/accounts/index.d.ts.map +1 -0
  468. package/dist/routes/accounts/lookup.d.ts +6 -0
  469. package/dist/routes/accounts/lookup.d.ts.map +1 -0
  470. package/dist/routes/accounts/me.d.ts +5 -0
  471. package/dist/routes/accounts/me.d.ts.map +1 -0
  472. package/dist/routes/accounts/mint.d.ts +5 -0
  473. package/dist/routes/accounts/mint.d.ts.map +1 -0
  474. package/dist/routes/accounts/pages.d.ts +23 -0
  475. package/dist/routes/accounts/pages.d.ts.map +1 -0
  476. package/dist/routes/accounts/resolve.d.ts +33 -0
  477. package/dist/routes/accounts/resolve.d.ts.map +1 -0
  478. package/dist/routes/accounts/serialize.d.ts +57 -0
  479. package/dist/routes/accounts/serialize.d.ts.map +1 -0
  480. package/dist/routes/accounts/shared.d.ts +68 -0
  481. package/dist/routes/accounts/shared.d.ts.map +1 -0
  482. package/dist/routes/accounts/start.d.ts +16 -0
  483. package/dist/routes/accounts/start.d.ts.map +1 -0
  484. package/dist/routes/accounts/unlink.d.ts +36 -0
  485. package/dist/routes/accounts/unlink.d.ts.map +1 -0
  486. package/dist/routes/admin/agent.d.ts +4 -0
  487. package/dist/routes/admin/agent.d.ts.map +1 -0
  488. package/dist/routes/admin/alerts.d.ts +190 -0
  489. package/dist/routes/admin/alerts.d.ts.map +1 -0
  490. package/dist/routes/admin/analytics.d.ts +137 -0
  491. package/dist/routes/admin/analytics.d.ts.map +1 -0
  492. package/dist/routes/admin/api-keys.d.ts +158 -0
  493. package/dist/routes/admin/api-keys.d.ts.map +1 -0
  494. package/dist/routes/admin/attribution.d.ts +93 -0
  495. package/dist/routes/admin/attribution.d.ts.map +1 -0
  496. package/dist/routes/admin/audit-logs.d.ts +40 -0
  497. package/dist/routes/admin/audit-logs.d.ts.map +1 -0
  498. package/dist/routes/admin/blueprints.d.ts +4 -0
  499. package/dist/routes/admin/blueprints.d.ts.map +1 -0
  500. package/dist/routes/admin/buckets.d.ts +215 -0
  501. package/dist/routes/admin/buckets.d.ts.map +1 -0
  502. package/dist/routes/admin/bulk.d.ts +203 -0
  503. package/dist/routes/admin/bulk.d.ts.map +1 -0
  504. package/dist/routes/admin/campaigns.d.ts +198 -0
  505. package/dist/routes/admin/campaigns.d.ts.map +1 -0
  506. package/dist/routes/admin/connectors.d.ts +116 -0
  507. package/dist/routes/admin/connectors.d.ts.map +1 -0
  508. package/dist/routes/admin/contacts.d.ts +246 -0
  509. package/dist/routes/admin/contacts.d.ts.map +1 -0
  510. package/dist/routes/admin/conversions.d.ts +103 -0
  511. package/dist/routes/admin/conversions.d.ts.map +1 -0
  512. package/dist/routes/admin/deals.d.ts +136 -0
  513. package/dist/routes/admin/deals.d.ts.map +1 -0
  514. package/dist/routes/admin/dlq.d.ts +100 -0
  515. package/dist/routes/admin/dlq.d.ts.map +1 -0
  516. package/dist/routes/admin/domain.d.ts +314 -0
  517. package/dist/routes/admin/domain.d.ts.map +1 -0
  518. package/dist/routes/admin/emails.d.ts +127 -0
  519. package/dist/routes/admin/emails.d.ts.map +1 -0
  520. package/dist/routes/admin/events.d.ts +140 -0
  521. package/dist/routes/admin/events.d.ts.map +1 -0
  522. package/dist/routes/admin/flags.d.ts +719 -0
  523. package/dist/routes/admin/flags.d.ts.map +1 -0
  524. package/dist/routes/admin/funnels.d.ts +71 -0
  525. package/dist/routes/admin/funnels.d.ts.map +1 -0
  526. package/dist/routes/admin/groups.d.ts +169 -0
  527. package/dist/routes/admin/groups.d.ts.map +1 -0
  528. package/dist/routes/admin/identity.d.ts +72 -0
  529. package/dist/routes/admin/identity.d.ts.map +1 -0
  530. package/dist/routes/admin/impact-schemas.d.ts +48 -0
  531. package/dist/routes/admin/impact-schemas.d.ts.map +1 -0
  532. package/dist/routes/admin/impact.d.ts +316 -0
  533. package/dist/routes/admin/impact.d.ts.map +1 -0
  534. package/dist/routes/admin/index.d.ts +4 -0
  535. package/dist/routes/admin/index.d.ts.map +1 -0
  536. package/dist/routes/admin/journey-impact.d.ts +320 -0
  537. package/dist/routes/admin/journey-impact.d.ts.map +1 -0
  538. package/dist/routes/admin/journey-logs.d.ts +57 -0
  539. package/dist/routes/admin/journey-logs.d.ts.map +1 -0
  540. package/dist/routes/admin/journeys.d.ts +736 -0
  541. package/dist/routes/admin/journeys.d.ts.map +1 -0
  542. package/dist/routes/admin/links.d.ts +382 -0
  543. package/dist/routes/admin/links.d.ts.map +1 -0
  544. package/dist/routes/admin/lists.d.ts +22 -0
  545. package/dist/routes/admin/lists.d.ts.map +1 -0
  546. package/dist/routes/admin/maintenance.d.ts +72 -0
  547. package/dist/routes/admin/maintenance.d.ts.map +1 -0
  548. package/dist/routes/admin/metrics.d.ts +212 -0
  549. package/dist/routes/admin/metrics.d.ts.map +1 -0
  550. package/dist/routes/admin/open-editor.d.ts +36 -0
  551. package/dist/routes/admin/open-editor.d.ts.map +1 -0
  552. package/dist/routes/admin/preferences.d.ts +109 -0
  553. package/dist/routes/admin/preferences.d.ts.map +1 -0
  554. package/dist/routes/admin/provider-credentials.d.ts +108 -0
  555. package/dist/routes/admin/provider-credentials.d.ts.map +1 -0
  556. package/dist/routes/admin/readiness.d.ts +24 -0
  557. package/dist/routes/admin/readiness.d.ts.map +1 -0
  558. package/dist/routes/admin/referrals.d.ts +230 -0
  559. package/dist/routes/admin/referrals.d.ts.map +1 -0
  560. package/dist/routes/admin/reporting.d.ts +149 -0
  561. package/dist/routes/admin/reporting.d.ts.map +1 -0
  562. package/dist/routes/admin/settings.d.ts +80 -0
  563. package/dist/routes/admin/settings.d.ts.map +1 -0
  564. package/dist/routes/admin/suppressions.d.ts +90 -0
  565. package/dist/routes/admin/suppressions.d.ts.map +1 -0
  566. package/dist/routes/admin/targeting.d.ts +58 -0
  567. package/dist/routes/admin/targeting.d.ts.map +1 -0
  568. package/dist/routes/admin/templates.d.ts +197 -0
  569. package/dist/routes/admin/templates.d.ts.map +1 -0
  570. package/dist/routes/admin/timeline.d.ts +51 -0
  571. package/dist/routes/admin/timeline.d.ts.map +1 -0
  572. package/dist/routes/admin/webhooks.d.ts +250 -0
  573. package/dist/routes/admin/webhooks.d.ts.map +1 -0
  574. package/dist/routes/campaigns/index.d.ts +239 -0
  575. package/dist/routes/campaigns/index.d.ts.map +1 -0
  576. package/dist/routes/connectors/index.d.ts +16 -0
  577. package/dist/routes/connectors/index.d.ts.map +1 -0
  578. package/dist/routes/contacts/index.d.ts +187 -0
  579. package/dist/routes/contacts/index.d.ts.map +1 -0
  580. package/dist/routes/email/index.d.ts +4 -0
  581. package/dist/routes/email/index.d.ts.map +1 -0
  582. package/dist/routes/email/preferences.d.ts +17 -0
  583. package/dist/routes/email/preferences.d.ts.map +1 -0
  584. package/dist/routes/email/unsubscribe.d.ts +17 -0
  585. package/dist/routes/email/unsubscribe.d.ts.map +1 -0
  586. package/dist/routes/emails/index.d.ts +90 -0
  587. package/dist/routes/emails/index.d.ts.map +1 -0
  588. package/dist/routes/events/index.d.ts +116 -0
  589. package/dist/routes/events/index.d.ts.map +1 -0
  590. package/dist/routes/feed/index.d.ts +248 -0
  591. package/dist/routes/feed/index.d.ts.map +1 -0
  592. package/dist/routes/feed/recipient.d.ts +65 -0
  593. package/dist/routes/feed/recipient.d.ts.map +1 -0
  594. package/dist/routes/flags/index.d.ts +94 -0
  595. package/dist/routes/flags/index.d.ts.map +1 -0
  596. package/dist/routes/groups/index.d.ts +192 -0
  597. package/dist/routes/groups/index.d.ts.map +1 -0
  598. package/dist/routes/health.d.ts +57 -0
  599. package/dist/routes/health.d.ts.map +1 -0
  600. package/dist/routes/index.d.ts +8 -0
  601. package/dist/routes/index.d.ts.map +1 -0
  602. package/dist/routes/lists/index.d.ts +266 -0
  603. package/dist/routes/lists/index.d.ts.map +1 -0
  604. package/dist/routes/referrals/index.d.ts +22 -0
  605. package/dist/routes/referrals/index.d.ts.map +1 -0
  606. package/dist/routes/referrals/me.d.ts +4 -0
  607. package/dist/routes/referrals/me.d.ts.map +1 -0
  608. package/dist/routes/referrals/report.d.ts +5 -0
  609. package/dist/routes/referrals/report.d.ts.map +1 -0
  610. package/dist/routes/referrals/shared.d.ts +16 -0
  611. package/dist/routes/referrals/shared.d.ts.map +1 -0
  612. package/dist/routes/referrals/touch.d.ts +5 -0
  613. package/dist/routes/referrals/touch.d.ts.map +1 -0
  614. package/dist/routes/snippet.d.ts +12 -0
  615. package/dist/routes/snippet.d.ts.map +1 -0
  616. package/dist/routes/tracking/answer.d.ts +56 -0
  617. package/dist/routes/tracking/answer.d.ts.map +1 -0
  618. package/dist/routes/tracking/arrive.d.ts +32 -0
  619. package/dist/routes/tracking/arrive.d.ts.map +1 -0
  620. package/dist/routes/tracking/click-pipeline.d.ts +213 -0
  621. package/dist/routes/tracking/click-pipeline.d.ts.map +1 -0
  622. package/dist/routes/tracking/click.d.ts +26 -0
  623. package/dist/routes/tracking/click.d.ts.map +1 -0
  624. package/dist/routes/tracking/identify.d.ts +32 -0
  625. package/dist/routes/tracking/identify.d.ts.map +1 -0
  626. package/dist/routes/tracking/index.d.ts +4 -0
  627. package/dist/routes/tracking/index.d.ts.map +1 -0
  628. package/dist/routes/tracking/open.d.ts +17 -0
  629. package/dist/routes/tracking/open.d.ts.map +1 -0
  630. package/dist/routes/tracking/short.d.ts +17 -0
  631. package/dist/routes/tracking/short.d.ts.map +1 -0
  632. package/dist/routes/tracking/vanity.d.ts +17 -0
  633. package/dist/routes/tracking/vanity.d.ts.map +1 -0
  634. package/dist/routes/webhooks/crm-provider.d.ts +24 -0
  635. package/dist/routes/webhooks/crm-provider.d.ts.map +1 -0
  636. package/dist/routes/webhooks/email-provider.d.ts +21 -0
  637. package/dist/routes/webhooks/email-provider.d.ts.map +1 -0
  638. package/dist/routes/webhooks/index.d.ts +8 -0
  639. package/dist/routes/webhooks/index.d.ts.map +1 -0
  640. package/dist/routes/webhooks/resend.d.ts +35 -0
  641. package/dist/routes/webhooks/resend.d.ts.map +1 -0
  642. package/dist/routes/webhooks/sms-provider.d.ts +23 -0
  643. package/dist/routes/webhooks/sms-provider.d.ts.map +1 -0
  644. package/dist/routes/webhooks/sources.d.ts +12 -0
  645. package/dist/routes/webhooks/sources.d.ts.map +1 -0
  646. package/dist/sources/define-contact-source.d.ts +114 -0
  647. package/dist/sources/define-contact-source.d.ts.map +1 -0
  648. package/dist/sources/registry.d.ts +31 -0
  649. package/dist/sources/registry.d.ts.map +1 -0
  650. package/dist/sources/webhook-source.d.ts +53 -0
  651. package/dist/sources/webhook-source.d.ts.map +1 -0
  652. package/dist/testing.d.ts +10 -0
  653. package/dist/testing.d.ts.map +1 -0
  654. package/dist/webhook-sources/define-webhook-source.d.ts +60 -0
  655. package/dist/webhook-sources/define-webhook-source.d.ts.map +1 -0
  656. package/dist/webhook-sources/presets/clerk.d.ts +9 -0
  657. package/dist/webhook-sources/presets/clerk.d.ts.map +1 -0
  658. package/dist/webhook-sources/presets/index.d.ts +140 -0
  659. package/dist/webhook-sources/presets/index.d.ts.map +1 -0
  660. package/dist/webhook-sources/presets/intercom.d.ts +44 -0
  661. package/dist/webhook-sources/presets/intercom.d.ts.map +1 -0
  662. package/dist/webhook-sources/presets/segment.d.ts +16 -0
  663. package/dist/webhook-sources/presets/segment.d.ts.map +1 -0
  664. package/dist/webhook-sources/presets/stripe.d.ts +20 -0
  665. package/dist/webhook-sources/presets/stripe.d.ts.map +1 -0
  666. package/dist/webhook-sources/presets/supabase.d.ts +23 -0
  667. package/dist/webhook-sources/presets/supabase.d.ts.map +1 -0
  668. package/dist/webhook-sources/verify.d.ts +48 -0
  669. package/dist/webhook-sources/verify.d.ts.map +1 -0
  670. package/dist/worker.d.ts +37 -0
  671. package/dist/worker.d.ts.map +1 -0
  672. package/dist/workflows/backfill-contact-id.d.ts +202 -0
  673. package/dist/workflows/backfill-contact-id.d.ts.map +1 -0
  674. package/dist/workflows/bucket-backfill.d.ts +64 -0
  675. package/dist/workflows/bucket-backfill.d.ts.map +1 -0
  676. package/dist/workflows/bucket-reconcile.d.ts +73 -0
  677. package/dist/workflows/bucket-reconcile.d.ts.map +1 -0
  678. package/dist/workflows/check-alerts.d.ts +10 -0
  679. package/dist/workflows/check-alerts.d.ts.map +1 -0
  680. package/dist/workflows/confirm-semantic-click.d.ts +15 -0
  681. package/dist/workflows/confirm-semantic-click.d.ts.map +1 -0
  682. package/dist/workflows/crm-reconcile.d.ts +27 -0
  683. package/dist/workflows/crm-reconcile.d.ts.map +1 -0
  684. package/dist/workflows/deliver-webhook.d.ts +88 -0
  685. package/dist/workflows/deliver-webhook.d.ts.map +1 -0
  686. package/dist/workflows/dispatch-conversion.d.ts +14 -0
  687. package/dist/workflows/dispatch-conversion.d.ts.map +1 -0
  688. package/dist/workflows/identity-alias-backfill.d.ts +96 -0
  689. package/dist/workflows/identity-alias-backfill.d.ts.map +1 -0
  690. package/dist/workflows/impact-digest.d.ts +142 -0
  691. package/dist/workflows/impact-digest.d.ts.map +1 -0
  692. package/dist/workflows/import-contacts.d.ts +14 -0
  693. package/dist/workflows/import-contacts.d.ts.map +1 -0
  694. package/dist/workflows/import-suppressions.d.ts +55 -0
  695. package/dist/workflows/import-suppressions.d.ts.map +1 -0
  696. package/dist/workflows/journey-blueprint-interpreter.d.ts +73 -0
  697. package/dist/workflows/journey-blueprint-interpreter.d.ts.map +1 -0
  698. package/dist/workflows/send-campaign.d.ts +128 -0
  699. package/dist/workflows/send-campaign.d.ts.map +1 -0
  700. package/dist/workflows/send-email.d.ts +15 -0
  701. package/dist/workflows/send-email.d.ts.map +1 -0
  702. package/dist/workflows/send-feed.d.ts +37 -0
  703. package/dist/workflows/send-feed.d.ts.map +1 -0
  704. package/package.json +60 -22
  705. package/src/app.ts +9 -1
  706. package/src/buckets/check-membership.ts +54 -20
  707. package/src/env.ts +30 -0
  708. package/src/journeys/journey-log.ts +25 -8
  709. package/src/lib/contacts.ts +47 -1
  710. package/src/lib/email-service-types.ts +10 -0
  711. package/src/lib/ingestion.ts +30 -19
  712. package/src/lib/mailer-bounce-idempotency.test.ts +7 -2
  713. package/src/lib/mailer-replied.test.ts +7 -2
  714. package/src/lib/mailer.ts +1 -0
  715. package/src/lib/outbound-endpoint-cache.ts +83 -0
  716. package/src/lib/outbound.ts +56 -37
  717. package/src/lib/seed-posthog-destination.ts +5 -1
  718. package/src/lib/tracked.ts +11 -3
  719. package/src/lib/tracking-events.ts +20 -3
  720. package/src/middleware/api-key.ts +69 -60
  721. package/src/middleware/publishable-key.ts +11 -23
  722. package/src/middleware/rate-limit.ts +165 -3
  723. package/src/routes/admin/api-keys.ts +148 -0
  724. package/src/routes/admin/targeting.ts +6 -1
  725. package/src/routes/admin/webhooks.ts +4 -0
  726. package/src/routes/index.ts +67 -24
  727. package/src/workflows/backfill-contact-id.ts +3 -7
  728. package/src/workflows/bucket-backfill.ts +2 -2
  729. package/src/workflows/bucket-reconcile.ts +28 -12
  730. package/src/workflows/check-alerts.ts +3 -9
  731. package/src/workflows/crm-reconcile.ts +3 -2
  732. package/src/workflows/deliver-webhook.ts +21 -8
  733. package/src/workflows/dispatch-conversion.ts +2 -2
  734. package/src/workflows/identity-alias-backfill.ts +3 -2
  735. package/src/workflows/impact-digest.ts +2 -2
  736. package/src/workflows/import-contacts.ts +3 -4
  737. package/src/workflows/import-suppressions.ts +4 -5
  738. package/src/workflows/send-campaign.ts +10 -1
@@ -0,0 +1,12 @@
1
+ import type { EmailProvider } from "@hogsend/core";
2
+ import type { env as envSchema } from "../env.js";
3
+ /**
4
+ * Build the env-enabled email-provider presets. Mirrors `destinationsFromEnv`:
5
+ * a preset is constructed ONLY when its credential is present, so a
6
+ * Postmark-only deploy (no `RESEND_API_KEY`) contributes no Resend provider.
7
+ *
8
+ * These presets come FIRST in the container's merge — a consumer-supplied
9
+ * provider of the same id wins (last-writer-wins on the registry).
10
+ */
11
+ export declare function emailProvidersFromEnv(env: typeof envSchema): EmailProvider[];
12
+ //# sourceMappingURL=email-providers-from-env.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"email-providers-from-env.d.ts","sourceRoot":"","sources":["../../src/lib/email-providers-from-env.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAEnD,OAAO,KAAK,EAAE,GAAG,IAAI,SAAS,EAAE,MAAM,WAAW,CAAC;AA8ElD;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,OAAO,SAAS,GAAG,aAAa,EAAE,CA4E5E"}
@@ -0,0 +1,189 @@
1
+ import type { BatchEmailItem, DurationObject, EmailAttachment, EmailEvent, EmailEventType, SendEmailOptions, SendResult, WebhookHandlerMap } from "@hogsend/core";
2
+ import type { EmailServiceRenderOptions, EmailServiceRenderResult, RetryOptions, TemplateName, TemplateRegistry, TemplateRegistryMap } from "@hogsend/email";
3
+ import type { Logger } from "./logger.js";
4
+ export type { BatchEmailItem, SendEmailOptions, SendResult, } from "@hogsend/core";
5
+ /**
6
+ * Input to the mailer's low-level {@link EmailService.sendRaw}: the provider
7
+ * contract's `SendEmailOptions`, but `from` is optional — the mailer resolves it
8
+ * from `config.defaultFrom` when absent (see `resolveFrom` in mailer.ts). The
9
+ * wire contract keeps `from` required because the provider always receives a
10
+ * resolved address.
11
+ */
12
+ export type SendRawOptions = Omit<SendEmailOptions, "from"> & {
13
+ from?: string;
14
+ };
15
+ export interface SendTrackedEmailOptions<K extends TemplateName = TemplateName> {
16
+ templateKey: K;
17
+ props: TemplateRegistryMap[K];
18
+ from: string;
19
+ to: string;
20
+ subject?: string;
21
+ journeyStateId?: string;
22
+ /**
23
+ * Campaign identity for campaign-dispatched sends, persisted on the
24
+ * email_sends row (attribution scope + stats). NULL for journey /
25
+ * transactional sends.
26
+ */
27
+ campaignId?: string;
28
+ /**
29
+ * The recipient's `contacts.id` when the caller already holds it fresh (a
30
+ * campaign resolver that joined `contacts`). The mailer then stamps
31
+ * `email_sends.contact_id` with it instead of resolving `userId` again. Leave
32
+ * it unset unless the id was read in the same unit of work: a journey's
33
+ * enrollment-time id can go stale across a merge.
34
+ */
35
+ contactId?: string;
36
+ /** Denormalized recipient identity, persisted on the email_sends row for reporting. */
37
+ userId?: string;
38
+ userEmail?: string;
39
+ category?: string;
40
+ tags?: Array<{
41
+ name: string;
42
+ value: string;
43
+ }>;
44
+ headers?: Record<string, string>;
45
+ replyTo?: string | string[];
46
+ skipPreferenceCheck?: boolean;
47
+ baseUrl?: string;
48
+ /**
49
+ * Caller-supplied idempotency key (POST /v1/emails). A retry with the same key
50
+ * short-circuits to the prior `email_sends` row instead of dispatching a
51
+ * duplicate provider send.
52
+ */
53
+ idempotencyKey?: string;
54
+ /**
55
+ * Neutral attachments (PRD 17), validated + capability-gated before ANY send
56
+ * work (see `assertAttachmentsSendable`) and handed to the provider alongside
57
+ * the TRACKED html — tracking is applied first, attachments ride alongside;
58
+ * an attachment never causes tracking to be skipped. `email_sends.metadata`
59
+ * records filenames/sizes/types only, never the bytes.
60
+ */
61
+ attachments?: EmailAttachment[];
62
+ }
63
+ export interface TrackedSendResult {
64
+ emailSendId: string;
65
+ /** The provider's neutral message id (Resend email_id / Postmark MessageID). */
66
+ messageId: string;
67
+ /**
68
+ * @deprecated Renamed to {@link TrackedSendResult.messageId}. This read-alias
69
+ * always mirrors `messageId`; kept for one minor and removed the following
70
+ * minor. Build results via {@link trackedSendResult} so the alias stays live.
71
+ */
72
+ resendId: string;
73
+ status: "sent" | "suppressed" | "unsubscribed" | "skipped";
74
+ /**
75
+ * Present only when `status === "skipped"`:
76
+ * - `"frequency_capped"` — the per-recipient frequency cap was hit.
77
+ * - `"journey_suppressed"` — the enclosing journey's `meta.suppress` min-gap
78
+ * was in force: a non-failed send for this journey to this recipient already
79
+ * went out inside the window, so this one was skipped (no row, no send).
80
+ * - `"test_mode_blocked"` — test mode was active but no redirect address
81
+ * resolved (no `HOGSEND_TEST_EMAIL` / `STUDIO_ADMIN_EMAIL`), so the send was
82
+ * blocked rather than delivered to the real recipient.
83
+ * - `"control_group"` — the recipient is in the global control group
84
+ * (impact plan §4.3): non-transactional sends are withheld so
85
+ * program-level lift is measurable. Transactional mail still delivers.
86
+ */
87
+ reason?: "frequency_capped" | "journey_suppressed" | "test_mode_blocked" | "control_group";
88
+ }
89
+ /**
90
+ * Build a {@link TrackedSendResult}, attaching a live `@deprecated` `resendId`
91
+ * read-alias getter that mirrors `messageId`. Lets every send path return a
92
+ * single canonical `messageId` while public consumers reading the old `resendId`
93
+ * field keep working for one minor.
94
+ */
95
+ export declare function trackedSendResult(result: Omit<TrackedSendResult, "resendId">): TrackedSendResult;
96
+ export interface FrequencyCapWindow {
97
+ count: number;
98
+ window: DurationObject;
99
+ }
100
+ export interface FrequencyCapConfig {
101
+ /** Global send count allowed within `window` per recipient. */
102
+ count: number;
103
+ window: DurationObject;
104
+ /** Per-category overrides (count + window, filtered by that category). */
105
+ byCategory?: Record<string, FrequencyCapWindow>;
106
+ /** Categories exempt from capping. Defaults to ["transactional"]. */
107
+ exemptCategories?: string[];
108
+ }
109
+ export interface EmailServiceConfig {
110
+ defaultFrom: string;
111
+ /**
112
+ * The client app's template registry (key → component + subject + category).
113
+ * Threaded into `getTemplate(..., { registry })` at send + render time so the
114
+ * engine never bakes in concrete business templates. Required to send/render
115
+ * any template; an empty registry simply has no sendable keys.
116
+ */
117
+ templates: TemplateRegistry;
118
+ db?: unknown;
119
+ webhookHandlers?: WebhookHandlerMap;
120
+ retryOptions?: RetryOptions;
121
+ bounceThreshold?: number;
122
+ baseUrl?: string;
123
+ /**
124
+ * Optional per-client frequency cap. When set, sends are counted per
125
+ * recipient within the window and skipped (no provider call, no `sent` row)
126
+ * once the cap is reached. Opt-in: undefined ⇒ no capping.
127
+ */
128
+ frequencyCap?: FrequencyCapConfig;
129
+ /** Optional structured logger; used e.g. to record frequency-cap skips. */
130
+ logger?: Logger;
131
+ }
132
+ export interface EmailServiceSendOptions<K extends TemplateName = TemplateName> {
133
+ template: K;
134
+ props: TemplateRegistryMap[K];
135
+ to: string;
136
+ from?: string;
137
+ subject?: string;
138
+ journeyStateId?: string;
139
+ /** Campaign identity for campaign-dispatched sends (see SendTrackedEmailOptions). */
140
+ campaignId?: string;
141
+ /** A fresh `contacts.id` for the recipient (see SendTrackedEmailOptions). */
142
+ contactId?: string;
143
+ /** Denormalized recipient identity, persisted on the email_sends row for reporting. */
144
+ userId?: string;
145
+ userEmail?: string;
146
+ category?: string;
147
+ tags?: Array<{
148
+ name: string;
149
+ value: string;
150
+ }>;
151
+ headers?: Record<string, string>;
152
+ replyTo?: string | string[];
153
+ skipPreferenceCheck?: boolean;
154
+ /** Caller-supplied idempotency key (POST /v1/emails) — dedups duplicate sends. */
155
+ idempotencyKey?: string;
156
+ /** Neutral attachments — see `SendTrackedEmailOptions.attachments`. */
157
+ attachments?: EmailAttachment[];
158
+ }
159
+ /**
160
+ * @deprecated The route now verifies the provider webhook and hands
161
+ * {@link EmailService.handleWebhook} an already-parsed {@link EmailEvent}. This
162
+ * raw `{ payload, headers }` shape is no longer the handler input.
163
+ */
164
+ export interface EmailServiceWebhookOptions {
165
+ payload: string;
166
+ headers: Record<string, string>;
167
+ }
168
+ export interface EmailServiceWebhookResult {
169
+ type: EmailEventType;
170
+ handled: boolean;
171
+ }
172
+ export interface EmailService {
173
+ send<K extends TemplateName>(options: EmailServiceSendOptions<K>): Promise<TrackedSendResult>;
174
+ sendRaw(options: SendRawOptions): Promise<SendResult>;
175
+ sendBatch(options: {
176
+ emails: BatchEmailItem[];
177
+ }): Promise<{
178
+ results: SendResult[];
179
+ }>;
180
+ render<K extends TemplateName>(options: EmailServiceRenderOptions<K>): Promise<EmailServiceRenderResult>;
181
+ /**
182
+ * Dispatch an already-verified, provider-neutral {@link EmailEvent} into the
183
+ * status/suppression/outbound pipeline. The webhook route owns provider
184
+ * resolution + signature verification and passes the parsed event + the
185
+ * resolving `providerId` (the latter is informational for now).
186
+ */
187
+ handleWebhook(event: EmailEvent, providerId?: string): Promise<EmailServiceWebhookResult>;
188
+ }
189
+ //# sourceMappingURL=email-service-types.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"email-service-types.d.ts","sourceRoot":"","sources":["../../src/lib/email-service-types.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,12 @@
1
+ import { type Database } from "@hogsend/db";
2
+ export interface EmailStatsResult {
3
+ total: number;
4
+ delivered: number;
5
+ bounced: number;
6
+ complained: number;
7
+ }
8
+ export declare function getEmailStats(opts: {
9
+ db: Database;
10
+ since: Date;
11
+ }): Promise<EmailStatsResult>;
12
+ //# sourceMappingURL=email-stats.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"email-stats.d.ts","sourceRoot":"","sources":["../../src/lib/email-stats.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,QAAQ,EAAc,MAAM,aAAa,CAAC;AAGxD,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,wBAAsB,aAAa,CAAC,IAAI,EAAE;IACxC,EAAE,EAAE,QAAQ,CAAC;IACb,KAAK,EAAE,IAAI,CAAC;CACb,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAmB5B"}
@@ -0,0 +1,73 @@
1
+ import type { EmailAttachment } from "@hogsend/core";
2
+ import { type TemplateName } from "@hogsend/email";
3
+ import type { EmailService } from "./email-service-types.js";
4
+ export declare const setEmailService: (value: EmailService) => void;
5
+ /**
6
+ * The injected {@link EmailService} (set by `createHogsendClient` →
7
+ * `setEmailService`). Exposed so module-level task-execution sites with no
8
+ * client reference (the `send-email` Hatchet task, the alerting task) deliver
9
+ * through the same provider-backed mailer the container built, honoring a
10
+ * swapped provider instead of constructing a raw Resend client of their own.
11
+ * Throws if read before the container has installed the service — same
12
+ * guarantee as the journey/bucket registry singletons (the container always
13
+ * runs first in both the API and worker processes).
14
+ */
15
+ export declare const getEmailService: () => EmailService;
16
+ export interface SendEmailOptions {
17
+ to: string;
18
+ userId: string;
19
+ /**
20
+ * The template to send. Typed as {@link TemplateName} — the union of keys the
21
+ * consumer has registered by augmenting `@hogsend/email`'s
22
+ * `TemplateRegistryMap` (see the consumer's `src/emails/templates.d.ts`). A
23
+ * key that was never registered (a typo, or a slash-key when the registry
24
+ * uses hyphen-keys) is a COMPILE error here, so a journey can no longer ship
25
+ * pointing at an email that doesn't exist. `getTemplate` also throws a loud,
26
+ * actionable error at send time as a runtime backstop for keys resolved
27
+ * dynamically (e.g. the public `POST /v1/emails`).
28
+ */
29
+ template: TemplateName;
30
+ /**
31
+ * The email subject. Optional: when omitted, the tracked mailer falls back
32
+ * to the template registry's `defaultSubject` for {@link template} (the
33
+ * blueprint interpreter's send nodes rely on this — a blueprint send node
34
+ * carries only a template key). Code journeys typically pass it explicitly.
35
+ */
36
+ subject?: string;
37
+ journeyName?: string;
38
+ journeyStateId?: string;
39
+ props?: Record<string, unknown>;
40
+ /**
41
+ * Explicit idempotency key. A public caller (e.g. POST /v1/emails) sets this
42
+ * directly; it always wins over the engine's auto-derivation. Journey sends
43
+ * leave it unset — the engine derives a deterministic key from the active
44
+ * journey boundary (see {@link idempotencyLabel}).
45
+ */
46
+ idempotencyKey?: string;
47
+ /**
48
+ * Disambiguates a send's exactly-once idempotency key when the SAME template
49
+ * is sent more than once in one journey enrollment on divergent branches.
50
+ * Normally the engine auto-derives the key from the nearest authored wait
51
+ * label, so this is rarely needed; pass a distinct label per call if the
52
+ * engine throws an intra-run key-collision error. Additive and optional.
53
+ */
54
+ idempotencyLabel?: string;
55
+ /**
56
+ * Files to send with the email (invoices, receipts, tickets, exports).
57
+ * Neutral {@link EmailAttachment} shape; validated + capability-gated by the
58
+ * tracked mailer BEFORE any work — a provider that does not declare
59
+ * `capabilities.attachments` throws rather than delivering the message
60
+ * without its files. Attachments do NOT enter the replay-stable idempotency
61
+ * key (that stays `kind:anchor:site:template`), so no authoring change is
62
+ * needed for exactly-once — but if something NON-deterministic picks the
63
+ * attachment, wrap that choice in `ctx.once` like any other non-deterministic
64
+ * send input.
65
+ */
66
+ attachments?: EmailAttachment[];
67
+ }
68
+ export interface SendEmailResult {
69
+ emailSendId: string;
70
+ sentAt: string;
71
+ }
72
+ export declare function sendEmail(opts: SendEmailOptions): Promise<SendEmailResult>;
73
+ //# sourceMappingURL=email.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"email.d.ts","sourceRoot":"","sources":["../../src/lib/email.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EAA0B,KAAK,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAM3E,OAAO,KAAK,EACV,YAAY,EAEb,MAAM,0BAA0B,CAAC;AAKlC,eAAO,MAAM,eAAe,+BAAe,CAAC;AAE5C;;;;;;;;;GASG;AACH,eAAO,MAAM,eAAe,oBAAe,CAAC;AAE5C,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf;;;;;;;;;OASG;IACH,QAAQ,EAAE,YAAY,CAAC;IACvB;;;;;OAKG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC;;;;;OAKG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;;;;;OAMG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B;;;;;;;;;;OAUG;IACH,WAAW,CAAC,EAAE,eAAe,EAAE,CAAC;CACjC;AAED,MAAM,WAAW,eAAe;IAC9B,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,wBAAsB,SAAS,CAC7B,IAAI,EAAE,gBAAgB,GACrB,OAAO,CAAC,eAAe,CAAC,CA8H1B"}
@@ -0,0 +1,101 @@
1
+ import { type Database } from "@hogsend/db";
2
+ /** The lookup subject's kind — mirrors the `enrichment_lookup_kind` pgEnum. */
3
+ export type EnrichmentLookupKind = "email" | "domain";
4
+ /**
5
+ * The lookup's outcome — mirrors the `enrichment_lookup_status` pgEnum.
6
+ * `found`/`not_found` are both PAID answers and suppress re-spend until the row
7
+ * expires; `error` is not a paid answer and must never suppress a retry.
8
+ */
9
+ export type EnrichmentLookupStatus = "found" | "not_found" | "error";
10
+ /** A ledger row as the refinement gate chain reads it. */
11
+ export interface EnrichmentLookupRow {
12
+ id: string;
13
+ provider: string;
14
+ lookupKind: EnrichmentLookupKind;
15
+ lookupKey: string;
16
+ status: EnrichmentLookupStatus;
17
+ contactId: string | null;
18
+ refinedAt: Date;
19
+ expiresAt: Date;
20
+ raw: Record<string, unknown> | null;
21
+ /** The normalized canonical trait patch the paid answer produced. */
22
+ traits: Record<string, unknown> | null;
23
+ spendWindow: Date | null;
24
+ spendCount: number;
25
+ lastErrorAt: Date | null;
26
+ }
27
+ /**
28
+ * The ledger row for a `(provider, lookupKind, lookupKey)` triple, or null when
29
+ * this subject has never been looked up by this provider.
30
+ *
31
+ * Deliberately returns the row REGARDLESS of status and expiry: the gate chain
32
+ * owns the "unexpired AND paid" verdict so the `error`-never-short-circuits rule
33
+ * lives next to the rest of the gate ordering rather than being buried in a
34
+ * WHERE clause.
35
+ */
36
+ export declare function findEnrichmentLookup(opts: {
37
+ db: Database;
38
+ provider: string;
39
+ lookupKind: EnrichmentLookupKind;
40
+ lookupKey: string;
41
+ }): Promise<EnrichmentLookupRow | null>;
42
+ /**
43
+ * Record a lookup against the `(provider, lookup_kind, lookup_key)` unique index
44
+ * — the Layer-2, version-independent exactly-once backstop for refinement — AND
45
+ * the spend it cost.
46
+ *
47
+ * Conflict behaviour is status-dependent, and deliberately asymmetric:
48
+ *
49
+ * - a PAID answer (`found` / `not_found`) UPDATES the existing row, so a
50
+ * `force: true` re-lookup refreshes the TTL + the stored traits in place
51
+ * instead of inserting a duplicate (the unique index would reject one
52
+ * anyway);
53
+ * - an `error` never touches the CACHE columns (`status`/`expiresAt`/`raw`/
54
+ * `traits`/`refinedAt`), so a transient vendor 5xx during a forced re-lookup
55
+ * can never clobber a live, good cached row.
56
+ *
57
+ * What BOTH branches always do is bump the spend counter and stamp
58
+ * `spend_window`. That is the whole point: the row is one-per-key, so counting
59
+ * rows counts SUBJECTS, not vendor calls — a `force` loop, or an outage
60
+ * retrying an already-refined base, would otherwise spend real money without
61
+ * ever moving the budget cap. `spend_count` resets to 1 whenever the call lands
62
+ * in a window later than the one on the row, so a previous month's attempts can
63
+ * never be pulled into this month's ceiling.
64
+ */
65
+ export declare function upsertEnrichmentLookup(opts: {
66
+ db: Database;
67
+ provider: string;
68
+ lookupKind: EnrichmentLookupKind;
69
+ lookupKey: string;
70
+ status: EnrichmentLookupStatus;
71
+ contactId?: string | null;
72
+ refinedAt: Date;
73
+ expiresAt: Date;
74
+ raw?: unknown;
75
+ traits?: Record<string, unknown> | null;
76
+ /** First instant of the budget window this call is charged to. */
77
+ spendWindow: Date;
78
+ }): Promise<void>;
79
+ /**
80
+ * How many provider LOOKUPS the ledger recorded in the budget window starting
81
+ * at `since` — the number behind `ENRICHMENT_MONTHLY_LOOKUPS`.
82
+ *
83
+ * A SUM of `spend_count` over the rows stamped with this window, not a COUNT of
84
+ * rows: the table holds one row per subject, so a row count would answer "how
85
+ * many distinct subjects were touched", which equals spend only when nothing is
86
+ * ever re-looked-up. Errors are included — an `error` row still represents a
87
+ * request that left the building, and the operator's cap is a ceiling on
88
+ * requests, not on successful matches. Served by
89
+ * `enrichment_lookups_spend_window_idx`.
90
+ */
91
+ export declare function countEnrichmentLookups(opts: {
92
+ db: Database;
93
+ since: Date;
94
+ }): Promise<number>;
95
+ /**
96
+ * The first instant of `at`'s calendar month in UTC — the lower bound of the
97
+ * monthly budget window. UTC (not local) so the cap resets at the same instant
98
+ * for every process regardless of the host's timezone.
99
+ */
100
+ export declare function startOfUtcMonth(at: Date): Date;
101
+ //# sourceMappingURL=enrichment-ledger.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"enrichment-ledger.d.ts","sourceRoot":"","sources":["../../src/lib/enrichment-ledger.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,QAAQ,EAAqB,MAAM,aAAa,CAAC;AAG/D,+EAA+E;AAC/E,MAAM,MAAM,oBAAoB,GAAG,OAAO,GAAG,QAAQ,CAAC;AAEtD;;;;GAIG;AACH,MAAM,MAAM,sBAAsB,GAAG,OAAO,GAAG,WAAW,GAAG,OAAO,CAAC;AAErE,0DAA0D;AAC1D,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,oBAAoB,CAAC;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,sBAAsB,CAAC;IAC/B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,SAAS,EAAE,IAAI,CAAC;IAChB,SAAS,EAAE,IAAI,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACpC,qEAAqE;IACrE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACvC,WAAW,EAAE,IAAI,GAAG,IAAI,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,IAAI,GAAG,IAAI,CAAC;CAC1B;AAED;;;;;;;;GAQG;AACH,wBAAsB,oBAAoB,CAAC,IAAI,EAAE;IAC/C,EAAE,EAAE,QAAQ,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,oBAAoB,CAAC;IACjC,SAAS,EAAE,MAAM,CAAC;CACnB,GAAG,OAAO,CAAC,mBAAmB,GAAG,IAAI,CAAC,CAatC;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAsB,sBAAsB,CAAC,IAAI,EAAE;IACjD,EAAE,EAAE,QAAQ,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,oBAAoB,CAAC;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,sBAAsB,CAAC;IAC/B,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,SAAS,EAAE,IAAI,CAAC;IAChB,SAAS,EAAE,IAAI,CAAC;IAChB,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACxC,kEAAkE;IAClE,WAAW,EAAE,IAAI,CAAC;CACnB,GAAG,OAAO,CAAC,IAAI,CAAC,CAiEhB;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,sBAAsB,CAAC,IAAI,EAAE;IACjD,EAAE,EAAE,QAAQ,CAAC;IACb,KAAK,EAAE,IAAI,CAAC;CACb,GAAG,OAAO,CAAC,MAAM,CAAC,CAMlB;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,EAAE,EAAE,IAAI,GAAG,IAAI,CAE9C"}
@@ -0,0 +1,20 @@
1
+ import type { EnrichmentProvider } from "@hogsend/core";
2
+ /**
3
+ * Container-held registry of enrichment providers, keyed by `provider.meta.id`.
4
+ * The container picks ONE active provider out of it (resolved as
5
+ * `enrichment.defaultProvider ?? ENRICHMENT_PROVIDER ?? "apollo"`) for the
6
+ * `refineContact()` pipeline.
7
+ *
8
+ * The enrichment sibling of {@link SmsProviderRegistry}. `meta` is REQUIRED on
9
+ * the enrichment contract (no pre-registry back-compat), so there is no
10
+ * fallback id — last-writer-wins on `meta.id`.
11
+ */
12
+ export declare class EnrichmentProviderRegistry {
13
+ private byId;
14
+ constructor(providers?: EnrichmentProvider[]);
15
+ register(provider: EnrichmentProvider): void;
16
+ get(id: string): EnrichmentProvider | undefined;
17
+ getAll(): EnrichmentProvider[];
18
+ count(): number;
19
+ }
20
+ //# sourceMappingURL=enrichment-provider-registry.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"enrichment-provider-registry.d.ts","sourceRoot":"","sources":["../../src/lib/enrichment-provider-registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAExD;;;;;;;;;GASG;AACH,qBAAa,0BAA0B;IACrC,OAAO,CAAC,IAAI,CAAyC;gBAEzC,SAAS,GAAE,kBAAkB,EAAO;IAIhD,QAAQ,CAAC,QAAQ,EAAE,kBAAkB,GAAG,IAAI;IAI5C,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,kBAAkB,GAAG,SAAS;IAI/C,MAAM,IAAI,kBAAkB,EAAE;IAI9B,KAAK,IAAI,MAAM;CAGhB"}
@@ -0,0 +1,13 @@
1
+ import type { EnrichmentProvider } from "@hogsend/core";
2
+ import type { env as envSchema } from "../env.js";
3
+ /**
4
+ * Build the env-enabled enrichment-provider presets. A preset is constructed
5
+ * ONLY when its credential is present AND the opt-in package resolved (see the
6
+ * guarded dynamic import above), so a deploy without an Apollo key never
7
+ * touches the package and contributes no provider.
8
+ *
9
+ * These presets come FIRST in the container's merge — a consumer-supplied
10
+ * provider of the same id wins (last-writer-wins on the registry).
11
+ */
12
+ export declare function enrichmentProvidersFromEnv(env: typeof envSchema): EnrichmentProvider[];
13
+ //# sourceMappingURL=enrichment-providers-from-env.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"enrichment-providers-from-env.d.ts","sourceRoot":"","sources":["../../src/lib/enrichment-providers-from-env.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACxD,OAAO,KAAK,EAAE,GAAG,IAAI,SAAS,EAAE,MAAM,WAAW,CAAC;AA+BlD;;;;;;;;GAQG;AACH,wBAAgB,0BAA0B,CACxC,GAAG,EAAE,OAAO,SAAS,GACpB,kBAAkB,EAAE,CAQtB"}
@@ -0,0 +1,9 @@
1
+ import type { EnrichmentProvider } from "@hogsend/core";
2
+ import type { EnrichmentProviderRegistry } from "./enrichment-provider-registry.js";
3
+ export declare function setEnrichmentProviders(registry: EnrichmentProviderRegistry, active?: EnrichmentProvider): void;
4
+ export declare function getEnrichmentProviderRegistry(): EnrichmentProviderRegistry | undefined;
5
+ /** The single resolved active enrichment provider (undefined = not configured). */
6
+ export declare function getEnrichmentProvider(): EnrichmentProvider | undefined;
7
+ /** Reset the installed state — only for test cleanup. */
8
+ export declare function resetEnrichmentProviders(): void;
9
+ //# sourceMappingURL=enrichment-registry-singleton.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"enrichment-registry-singleton.d.ts","sourceRoot":"","sources":["../../src/lib/enrichment-registry-singleton.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACxD,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,mCAAmC,CAAC;AAsBpF,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,0BAA0B,EACpC,MAAM,CAAC,EAAE,kBAAkB,GAC1B,IAAI,CAEN;AAED,wBAAgB,6BAA6B,IACzC,0BAA0B,GAC1B,SAAS,CAEZ;AAED,mFAAmF;AACnF,wBAAgB,qBAAqB,IAAI,kBAAkB,GAAG,SAAS,CAEtE;AAED,yDAAyD;AACzD,wBAAgB,wBAAwB,IAAI,IAAI,CAE/C"}
@@ -0,0 +1,28 @@
1
+ import type { JourneyMeta } from "@hogsend/core/types";
2
+ import { type Database } from "@hogsend/db";
3
+ /**
4
+ * The subject these guards read history for. `contactId` is REQUIRED (not
5
+ * optional) for the same reason `ConditionContext.contactId` is: an optional
6
+ * field silently defaults a new caller onto the mutable text key, which is
7
+ * exactly the entry-limit miss this batch exists to close. Pass `null`
8
+ * explicitly for a subject with no contact — a permanent, supported state (the
9
+ * engine refuses to mint a contact on observation).
10
+ */
11
+ export declare function checkEntryLimit(opts: {
12
+ db: Database;
13
+ journey: JourneyMeta;
14
+ userId: string;
15
+ contactId: string | null;
16
+ }): Promise<{
17
+ allowed: boolean;
18
+ reason?: string;
19
+ }>;
20
+ /** See {@link checkEntryLimit} for why `contactId` is required. */
21
+ export declare function checkEmailPreferences(opts: {
22
+ db: Database;
23
+ userId: string;
24
+ contactId: string | null;
25
+ }): Promise<{
26
+ unsubscribed: boolean;
27
+ }>;
28
+ //# sourceMappingURL=enrollment-guards.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"enrollment-guards.d.ts","sourceRoot":"","sources":["../../src/lib/enrollment-guards.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,EAAE,KAAK,QAAQ,EAAmC,MAAM,aAAa,CAAC;AAG7E;;;;;;;GAOG;AACH,wBAAsB,eAAe,CAAC,IAAI,EAAE;IAC1C,EAAE,EAAE,QAAQ,CAAC;IACb,OAAO,EAAE,WAAW,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B,GAAG,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CA8BjD;AAED,mEAAmE;AACnE,wBAAsB,qBAAqB,CAAC,IAAI,EAAE;IAChD,EAAE,EAAE,QAAQ,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B,GAAG,OAAO,CAAC;IAAE,YAAY,EAAE,OAAO,CAAA;CAAE,CAAC,CAOrC"}
@@ -0,0 +1,25 @@
1
+ import type { JourneyMeta } from "@hogsend/core/types";
2
+ export interface EnrollmentPolicyFacts {
3
+ /** Omit when there is no persisted admin override. */
4
+ adminEnabled?: boolean;
5
+ entry?: {
6
+ allowed: boolean;
7
+ reason?: string;
8
+ };
9
+ unsubscribed?: boolean;
10
+ heldOut?: boolean;
11
+ alreadyActive?: boolean;
12
+ }
13
+ export type EnrollmentPolicyResult = {
14
+ allowed: true;
15
+ } | {
16
+ allowed: false;
17
+ reason: string;
18
+ };
19
+ /** Pure enrollment guard ordering shared by production and test fixtures. */
20
+ export declare function evaluateEnrollmentPolicy(opts: {
21
+ journey: JourneyMeta;
22
+ properties: Record<string, unknown>;
23
+ facts?: EnrollmentPolicyFacts;
24
+ }): EnrollmentPolicyResult;
25
+ //# sourceMappingURL=enrollment-policy.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"enrollment-policy.d.ts","sourceRoot":"","sources":["../../src/lib/enrollment-policy.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAEvD,MAAM,WAAW,qBAAqB;IACpC,sDAAsD;IACtD,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,KAAK,CAAC,EAAE;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC9C,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED,MAAM,MAAM,sBAAsB,GAC9B;IAAE,OAAO,EAAE,IAAI,CAAA;CAAE,GACjB;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAEvC,6EAA6E;AAC7E,wBAAgB,wBAAwB,CAAC,IAAI,EAAE;IAC7C,OAAO,EAAE,WAAW,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpC,KAAK,CAAC,EAAE,qBAAqB,CAAC;CAC/B,GAAG,sBAAsB,CA6BzB"}
@@ -0,0 +1,27 @@
1
+ import { z } from "@hono/zod-openapi";
2
+ import type { HogsendClient } from "../container.js";
3
+ /**
4
+ * One merged event-name entry. Canonical shape shared by the helper's return,
5
+ * the `list_events` tool, and the `GET /v1/admin/events/names` OpenAPI response
6
+ * (the route imports this instead of re-declaring it, so they can never drift).
7
+ */
8
+ export declare const eventNameEntrySchema: z.ZodObject<{
9
+ name: z.ZodString;
10
+ occurrences: z.ZodNumber;
11
+ firstSeenAt: z.ZodNullable<z.ZodString>;
12
+ lastSeenAt: z.ZodNullable<z.ZodString>;
13
+ usedBy: z.ZodArray<z.ZodString>;
14
+ }, z.core.$strip>;
15
+ export type EventNameEntry = z.infer<typeof eventNameEntrySchema>;
16
+ export declare function listEventNameVocabulary(opts: {
17
+ db: HogsendClient["db"];
18
+ registry: HogsendClient["registry"];
19
+ /** Case-insensitive substring filter on the event name. */
20
+ search?: string;
21
+ /** Cap on the observed-events scan (the declared merge is uncapped). */
22
+ limit: number;
23
+ }): Promise<{
24
+ note: string;
25
+ events: EventNameEntry[];
26
+ }>;
27
+ //# sourceMappingURL=event-names.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"event-names.d.ts","sourceRoot":"","sources":["../../src/lib/event-names.ts"],"names":[],"mappings":"AAeA,OAAO,EAAE,CAAC,EAAE,MAAM,mBAAmB,CAAC;AAEtC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAErD;;;;GAIG;AACH,eAAO,MAAM,oBAAoB;;;;;;iBAQ/B,CAAC;AAEH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAMlE,wBAAsB,uBAAuB,CAAC,IAAI,EAAE;IAClD,EAAE,EAAE,aAAa,CAAC,IAAI,CAAC,CAAC;IACxB,QAAQ,EAAE,aAAa,CAAC,UAAU,CAAC,CAAC;IACpC,2DAA2D;IAC3D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,wEAAwE;IACxE,KAAK,EAAE,MAAM,CAAC;CACf,GAAG,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,cAAc,EAAE,CAAA;CAAE,CAAC,CAqGtD"}
@@ -0,0 +1,64 @@
1
+ import { type FeedBlock } from "@hogsend/db";
2
+ import { IN_APP_LIST_ID } from "../lists/channels.js";
3
+ /**
4
+ * Reserved list id governing in-app feed suppression (mirrors the built-in
5
+ * `transactional` / `journey` categories). A recipient unsubscribed from
6
+ * `in_app` (or `unsubscribed_all`) gets no feed items. Canonically defined in
7
+ * `../lists/channels.js` (where the in-app channel is synthesized); re-exported
8
+ * here so the engine's existing export surface stays stable.
9
+ */
10
+ export { IN_APP_LIST_ID };
11
+ export interface SendFeedItemOptions {
12
+ recipient: {
13
+ userId?: string;
14
+ email?: string;
15
+ anonymousId?: string;
16
+ };
17
+ type: string;
18
+ title?: string;
19
+ body?: string;
20
+ blocks?: FeedBlock[];
21
+ actionUrl?: string;
22
+ metadata?: Record<string, unknown>;
23
+ /** Item category (the feed it lands in). Default `"in_app"`. */
24
+ category?: string;
25
+ templateKey?: string;
26
+ journeyStateId?: string;
27
+ /**
28
+ * Explicit idempotency key. A public caller sets it directly; it always wins
29
+ * over the engine's journey auto-derivation. Journey sends leave it unset.
30
+ */
31
+ idempotencyKey?: string;
32
+ /**
33
+ * Disambiguates the exactly-once key when the SAME feed type is sent more than
34
+ * once in one journey enrollment on divergent branches sharing a nearest wait
35
+ * label. Mirrors `sendEmail()`'s `idempotencyLabel`. Additive and optional.
36
+ */
37
+ idempotencyLabel?: string;
38
+ }
39
+ export interface SendFeedItemResult {
40
+ /** The inserted row id, or `null` when suppressed or idempotent-deduped. */
41
+ feedItemId: string | null;
42
+ /** The resolved canonical recipient key (null only when no recipient given). */
43
+ recipientKey: string | null;
44
+ suppressed: boolean;
45
+ createdAt: string | null;
46
+ }
47
+ /**
48
+ * Journey-callable in-app feed send — the standalone, single-object-in /
49
+ * result-out counterpart to `sendEmail()` / `sendConnectorAction()`. NOT on
50
+ * `JourneyContext` (features are standalone imports).
51
+ *
52
+ * Pipeline: resolve recipient → canonical key → `in_app` suppression check →
53
+ * insert a `feed_items` row (replay-safe idempotency when in a journey) → publish
54
+ * to the Redis realtime channel `feed:<recipientKey>` on the COMMAND singleton.
55
+ *
56
+ * Replay-safety mirrors `sendEmail()`: inside a journey the engine derives a
57
+ * deterministic, branch-stable key off `boundary.runAnchor` (the Hatchet run id,
58
+ * NOT the freshly-minted state id) so a replay re-firing the same logical send
59
+ * re-derives the SAME key and the unique `feed_items.idempotencyKey` index
60
+ * (`onConflictDoNothing`, Layer 2) absorbs the duplicate insert. When eviction is
61
+ * supported, the whole insert+publish runs inside `boundary.memoize` (Layer 1).
62
+ */
63
+ export declare function sendFeedItem(opts: SendFeedItemOptions): Promise<SendFeedItemResult>;
64
+ //# sourceMappingURL=feed.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"feed.d.ts","sourceRoot":"","sources":["../../src/lib/feed.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,SAAS,EAAa,MAAM,aAAa,CAAC;AAMxD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAgBtD;;;;;;GAMG;AACH,OAAO,EAAE,cAAc,EAAE,CAAC;AAE1B,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACrE,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,gEAAgE;IAChE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,kBAAkB;IACjC,4EAA4E;IAC5E,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,gFAAgF;IAChF,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,UAAU,EAAE,OAAO,CAAC;IACpB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,YAAY,CAChC,IAAI,EAAE,mBAAmB,GACxB,OAAO,CAAC,kBAAkB,CAAC,CA0R7B"}