@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,258 @@
1
+ import type { HogsendClient } from "../../container.js";
2
+ /**
3
+ * The agent's tool set. READ tools auto-run (in-process against the container,
4
+ * the same query the corresponding admin route runs). WRITE tools are MINT-ONLY:
5
+ * their execute() builds a human summary, mints a single-use proposal token, and
6
+ * returns `{ status: "needs_confirmation", ... }` — they NEVER perform the side
7
+ * effect. The real write happens only in POST /v1/admin/agent/confirm.
8
+ */
9
+ export declare function buildAgentTools({ container, actorEmail, sessionId, }: {
10
+ container: HogsendClient;
11
+ actorEmail: string;
12
+ sessionId?: string;
13
+ }): {
14
+ list_journeys: import("ai").Tool<Record<string, never>, {
15
+ id: string;
16
+ name: string;
17
+ enabled: boolean;
18
+ trigger: string;
19
+ }[]>;
20
+ list_buckets: import("ai").Tool<Record<string, never>, {
21
+ id: string;
22
+ name: string;
23
+ }[]>;
24
+ overview_stats: import("ai").Tool<Record<string, never>, {
25
+ totalContacts: number;
26
+ activeJourneyEnrollments: number;
27
+ }>;
28
+ query_events: import("ai").Tool<{
29
+ limit: number;
30
+ event?: string | undefined;
31
+ }, {
32
+ event: string;
33
+ userId: string;
34
+ source: string | null;
35
+ occurredAt: Date;
36
+ }[]>;
37
+ find_contacts: import("ai").Tool<{
38
+ search: string;
39
+ limit: number;
40
+ }, {
41
+ id: string;
42
+ email: string | null;
43
+ externalId: string | null;
44
+ lastSeenAt: Date;
45
+ }[]>;
46
+ get_contact: import("ai").Tool<{
47
+ id: string;
48
+ }, {
49
+ error: string;
50
+ contact?: undefined;
51
+ preferences?: undefined;
52
+ } | {
53
+ contact: {
54
+ email: string | null;
55
+ id: string;
56
+ createdAt: Date;
57
+ updatedAt: Date;
58
+ organizationId: string | null;
59
+ externalId: string | null;
60
+ anonymousId: string | null;
61
+ discordId: string | null;
62
+ phone: string | null;
63
+ source: string | null;
64
+ sourcedAt: Date | null;
65
+ timezone: string | null;
66
+ properties: Record<string, unknown> | null;
67
+ firstSeenAt: Date;
68
+ lastSeenAt: Date;
69
+ deletedAt: Date | null;
70
+ };
71
+ preferences: {
72
+ createdAt: Date;
73
+ updatedAt: Date;
74
+ id: string;
75
+ userId: string;
76
+ email: string;
77
+ contactId: string | null;
78
+ unsubscribedAll: boolean;
79
+ suppressed: boolean;
80
+ bounceCount: number;
81
+ categories: Record<string, boolean> | null;
82
+ suppressedAt: Date | null;
83
+ lastBounceAt: Date | null;
84
+ } | null;
85
+ error?: undefined;
86
+ }>;
87
+ get_contact_timeline: import("ai").Tool<{
88
+ id: string;
89
+ limit: number;
90
+ }, {
91
+ error: string;
92
+ contactKey?: undefined;
93
+ events?: undefined;
94
+ journeys?: undefined;
95
+ } | {
96
+ contactKey: string;
97
+ events: {
98
+ event: string;
99
+ source: string | null;
100
+ occurredAt: Date;
101
+ }[];
102
+ journeys: {
103
+ journeyId: string;
104
+ status: "active" | "waiting" | "completed" | "failed" | "exited" | "held_out";
105
+ createdAt: Date;
106
+ }[];
107
+ error?: undefined;
108
+ }>;
109
+ list_sends: import("ai").Tool<{
110
+ limit: number;
111
+ }, {
112
+ id: string;
113
+ templateKey: string | null;
114
+ to: string;
115
+ status: "failed" | "queued" | "rendered" | "sent" | "delivered" | "opened" | "clicked" | "bounced" | "complained" | "suppressed";
116
+ sentAt: Date | null;
117
+ openedAt: Date | null;
118
+ clickedAt: Date | null;
119
+ }[]>;
120
+ build_audience: import("ai").Tool<{
121
+ kind: "event" | "property";
122
+ property?: string | undefined;
123
+ op?: "eq" | "neq" | "gt" | "gte" | "lt" | "lte" | "exists" | "contains" | undefined;
124
+ value?: string | number | boolean | undefined;
125
+ event?: string | undefined;
126
+ withinDays?: number | undefined;
127
+ }, {
128
+ count: number;
129
+ sample: string[];
130
+ capped: boolean;
131
+ }>;
132
+ fire_event: import("ai").Tool<{
133
+ event: string;
134
+ eventProperties: Record<string, unknown>;
135
+ userId?: string | undefined;
136
+ userEmail?: string | undefined;
137
+ }, {
138
+ status: "needs_confirmation";
139
+ proposalId: string;
140
+ token: string;
141
+ tool: string;
142
+ summary: string;
143
+ tier: import("./risk.js").Tier;
144
+ expiresAt: string;
145
+ }>;
146
+ send_transactional_email: import("ai").Tool<{
147
+ template: string;
148
+ to: string;
149
+ props: Record<string, unknown>;
150
+ subject?: string | undefined;
151
+ userId?: string | undefined;
152
+ }, {
153
+ status: "needs_confirmation";
154
+ proposalId: string;
155
+ token: string;
156
+ tool: string;
157
+ summary: string;
158
+ tier: import("./risk.js").Tier;
159
+ expiresAt: string;
160
+ }>;
161
+ send_campaign: import("ai").Tool<{
162
+ template: string;
163
+ props: Record<string, unknown>;
164
+ name?: string | undefined;
165
+ list?: string | undefined;
166
+ bucket?: string | undefined;
167
+ subject?: string | undefined;
168
+ from?: string | undefined;
169
+ }, {
170
+ status: "needs_confirmation";
171
+ proposalId: string;
172
+ token: string;
173
+ tool: string;
174
+ summary: string;
175
+ tier: import("./risk.js").Tier;
176
+ expiresAt: string;
177
+ }>;
178
+ enroll_in_journey: import("ai").Tool<{
179
+ journeyId: string;
180
+ properties: Record<string, unknown>;
181
+ userId?: string | undefined;
182
+ userEmail?: string | undefined;
183
+ }, {
184
+ status: "needs_confirmation";
185
+ proposalId: string;
186
+ token: string;
187
+ tool: string;
188
+ summary: string;
189
+ tier: import("./risk.js").Tier;
190
+ expiresAt: string;
191
+ }>;
192
+ subscribe_list: import("ai").Tool<{
193
+ list: string;
194
+ userId?: string | undefined;
195
+ email?: string | undefined;
196
+ }, {
197
+ status: "needs_confirmation";
198
+ proposalId: string;
199
+ token: string;
200
+ tool: string;
201
+ summary: string;
202
+ tier: import("./risk.js").Tier;
203
+ expiresAt: string;
204
+ }>;
205
+ unsubscribe_list: import("ai").Tool<{
206
+ list: string;
207
+ userId?: string | undefined;
208
+ email?: string | undefined;
209
+ }, {
210
+ status: "needs_confirmation";
211
+ proposalId: string;
212
+ token: string;
213
+ tool: string;
214
+ summary: string;
215
+ tier: import("./risk.js").Tier;
216
+ expiresAt: string;
217
+ }>;
218
+ upsert_contact: import("ai").Tool<{
219
+ properties: Record<string, unknown>;
220
+ userId?: string | undefined;
221
+ email?: string | undefined;
222
+ anonymousId?: string | undefined;
223
+ }, {
224
+ status: "needs_confirmation";
225
+ proposalId: string;
226
+ token: string;
227
+ tool: string;
228
+ summary: string;
229
+ tier: import("./risk.js").Tier;
230
+ expiresAt: string;
231
+ }>;
232
+ update_contact: import("ai").Tool<{
233
+ id: string;
234
+ properties: Record<string, unknown>;
235
+ email?: string | undefined;
236
+ }, {
237
+ status: "needs_confirmation";
238
+ proposalId: string;
239
+ token: string;
240
+ tool: string;
241
+ summary: string;
242
+ tier: import("./risk.js").Tier;
243
+ expiresAt: string;
244
+ }>;
245
+ delete_contact: import("ai").Tool<{
246
+ email?: string | undefined;
247
+ userId?: string | undefined;
248
+ }, {
249
+ status: "needs_confirmation";
250
+ proposalId: string;
251
+ token: string;
252
+ tool: string;
253
+ summary: string;
254
+ tier: import("./risk.js").Tier;
255
+ expiresAt: string;
256
+ }>;
257
+ };
258
+ //# sourceMappingURL=tools.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../../src/lib/agent/tools.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AASxD;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,EAC9B,SAAS,EACT,UAAU,EACV,SAAS,GACV,EAAE;IACD,SAAS,EAAE,aAAa,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAicA"}
@@ -0,0 +1,7 @@
1
+ import { type Database } from "@hogsend/db";
2
+ import type { Logger } from "./logger.js";
3
+ export declare function checkAlertRules(opts: {
4
+ db: Database;
5
+ logger: Logger;
6
+ }): Promise<void>;
7
+ //# sourceMappingURL=alerting.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"alerting.d.ts","sourceRoot":"","sources":["../../src/lib/alerting.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,QAAQ,EAEd,MAAM,aAAa,CAAC;AAGrB,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAmD1C,wBAAsB,eAAe,CAAC,IAAI,EAAE;IAC1C,EAAE,EAAE,QAAQ,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAChB,GAAG,OAAO,CAAC,IAAI,CAAC,CA0IhB"}
@@ -0,0 +1,24 @@
1
+ import type { AnalyticsProvider, PostHogService } from "@hogsend/core";
2
+ /**
3
+ * Wrap a legacy `PostHogService` (the deprecated PostHog-shaped interface
4
+ * accepted by `createHogsendClient({ analytics })` since before the neutral
5
+ * `AnalyticsProvider` contract existed) so it satisfies the contract the
6
+ * engine now speaks internally. Capabilities are assumed-on: a hand-built
7
+ * service predates capability reporting, and every method is best-effort
8
+ * anyway.
9
+ *
10
+ * Mapping notes:
11
+ * - `setPersonProperties.set` → `identify(distinctId, set)` (the legacy $set
12
+ * path). `setOnce` ALSO maps to `identify` — legacy services have no
13
+ * set-once wire, so overwrite semantics apply; `unset` maps to the legacy
14
+ * raw `$set` capture with `$unset`, mirroring what the bucket sync used to
15
+ * emit directly.
16
+ */
17
+ export declare function wrapLegacyAnalyticsService(service: PostHogService): AnalyticsProvider;
18
+ /**
19
+ * Runtime discrimination for the `analytics` option union: a neutral
20
+ * `AnalyticsProvider` carries `meta` + `capture`; the legacy `PostHogService`
21
+ * carries `captureEvent` and no `meta`.
22
+ */
23
+ export declare function isAnalyticsProvider(value: AnalyticsProvider | PostHogService): value is AnalyticsProvider;
24
+ //# sourceMappingURL=analytics-adapter.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"analytics-adapter.d.ts","sourceRoot":"","sources":["../../src/lib/analytics-adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAEvE;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,cAAc,GACtB,iBAAiB,CAkCnB;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,iBAAiB,GAAG,cAAc,GACxC,KAAK,IAAI,iBAAiB,CAK5B"}
@@ -0,0 +1,60 @@
1
+ import type { AnalyticsProvider } from "@hogsend/core";
2
+ import type { Logger } from "./logger.js";
3
+ /**
4
+ * The reason a merge was emitted — surfaced on the `identity.merge.emitted`
5
+ * structured log so an operator can see WHICH resolver path stitched (§10.5). A
6
+ * declining `collide_merge` / `key_flip` volume after anon threading lands
7
+ * (Stage 1) is the empirical "forks prevented" signal.
8
+ */
9
+ export type IdentityMergeReason = "collide_merge" | "key_flip" | "click_identify" | "discord_link";
10
+ /**
11
+ * Fan out the provider-neutral `mergeIdentities` primitive (§5.3) once per
12
+ * loser key, folding each absorbed (anonymous/uuid) key INTO the surviving
13
+ * canonical contact key. Fire-and-forget and never throws: analytics is
14
+ * non-load-bearing, so a provider error must not fail the ingest that triggered
15
+ * the merge.
16
+ *
17
+ * Direction is load-bearing (MF-1): `survivorKey` is the SURVIVING/canonical
18
+ * (identified) id and each `loserKey` is the ABSORBED (anonymous) one — mapped
19
+ * straight to `mergeIdentities({ distinctId: survivorKey, alias: loserKey })`.
20
+ *
21
+ * No-ops cleanly when:
22
+ * - no provider is injected (`!analytics`),
23
+ * - the active provider can't merge (`!capabilities.identityMerge` — a legacy
24
+ * adapter or a provider without an `alias` wire),
25
+ * - or it carries no `mergeIdentities` method.
26
+ *
27
+ * MF-2: callers MUST pass only the SAFE-to-absorb loser keys (anonymous/uuid,
28
+ * never an `external_id` that already identified a PostHog person). Aliasing an
29
+ * already-identified key is the identified→identified merge PostHog refuses
30
+ * (R2/R4) — it silently no-ops AND spams "Refused to merge" warnings on the
31
+ * normal merge path. The filtering happens at the emission point (the resolver
32
+ * splits its loser keys into safe vs. identified); this helper only fans out
33
+ * what it is given and skips a self-alias (`loserKey === survivorKey`).
34
+ */
35
+ export declare function mergeAnalyticsIdentities(opts: {
36
+ analytics?: AnalyticsProvider;
37
+ survivorKey: string;
38
+ loserKeys: string[];
39
+ /** Stitching path, for the `identity.merge.emitted` observability log. */
40
+ reason: IdentityMergeReason;
41
+ /** The contact id, for correlating the merge log to a contact row. */
42
+ contactId?: string;
43
+ logger?: Logger;
44
+ }): void;
45
+ /**
46
+ * Emit the `identity.merge.residual_twin` observability log (§10.5) for each
47
+ * loser key MF-2 excluded from the safe fan-out: a loser carrying an
48
+ * `external_id` is, by the engine's own model, an already-identified PostHog
49
+ * person, and PostHog refuses to merge two identified persons on the safe path.
50
+ * These twins are the known steady-state residual (OQ-1) made visible — NOT an
51
+ * error, just the honest "one email → one person, except across two prior
52
+ * identified persons" outcome surfaced for monitoring.
53
+ */
54
+ export declare function logResidualTwins(opts: {
55
+ survivorKey: string;
56
+ identifiedLoserKeys: string[];
57
+ contactId?: string;
58
+ logger?: Logger;
59
+ }): void;
60
+ //# sourceMappingURL=analytics-identity.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"analytics-identity.d.ts","sourceRoot":"","sources":["../../src/lib/analytics-identity.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AACvD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAE1C;;;;;GAKG;AACH,MAAM,MAAM,mBAAmB,GAC3B,eAAe,GACf,UAAU,GACV,gBAAgB,GAChB,cAAc,CAAC;AAEnB;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE;IAC7C,SAAS,CAAC,EAAE,iBAAiB,CAAC;IAC9B,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,0EAA0E;IAC1E,MAAM,EAAE,mBAAmB,CAAC;IAC5B,sEAAsE;IACtE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,GAAG,IAAI,CAoCP;AAED;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE;IACrC,WAAW,EAAE,MAAM,CAAC;IACpB,mBAAmB,EAAE,MAAM,EAAE,CAAC;IAC9B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,GAAG,IAAI,CAUP"}
@@ -0,0 +1,20 @@
1
+ import type { AnalyticsProvider } from "@hogsend/core";
2
+ /**
3
+ * Container-held registry of analytics providers, keyed by `provider.meta.id`
4
+ * — the analytics sibling of `EmailProviderRegistry`. The container picks ONE
5
+ * `active` provider out of it (env `ANALYTICS_PROVIDER` /
6
+ * `analytics.defaultProvider`, default `"posthog"`) for the identity PULL,
7
+ * person writes, and capture.
8
+ *
9
+ * Keyed with last-writer-wins, so a consumer-supplied provider of the same id
10
+ * overrides an env preset of that id.
11
+ */
12
+ export declare class AnalyticsProviderRegistry {
13
+ private byId;
14
+ constructor(providers?: AnalyticsProvider[]);
15
+ register(provider: AnalyticsProvider): void;
16
+ get(id: string): AnalyticsProvider | undefined;
17
+ getAll(): AnalyticsProvider[];
18
+ count(): number;
19
+ }
20
+ //# sourceMappingURL=analytics-provider-registry.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"analytics-provider-registry.d.ts","sourceRoot":"","sources":["../../src/lib/analytics-provider-registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAEvD;;;;;;;;;GASG;AACH,qBAAa,yBAAyB;IACpC,OAAO,CAAC,IAAI,CAAwC;gBAExC,SAAS,GAAE,iBAAiB,EAAO;IAI/C,QAAQ,CAAC,QAAQ,EAAE,iBAAiB,GAAG,IAAI;IAI3C,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS;IAI9C,MAAM,IAAI,iBAAiB,EAAE;IAI7B,KAAK,IAAI,MAAM;CAGhB"}
@@ -0,0 +1,41 @@
1
+ import type { AnalyticsProvider } from "@hogsend/core";
2
+ import type { Database } from "@hogsend/db";
3
+ import type { env as envSchema } from "../env.js";
4
+ import type { Logger } from "./logger.js";
5
+ /**
6
+ * Env-driven analytics-provider presets — the analytics sibling of
7
+ * `emailProvidersFromEnv`. PostHog is built when `POSTHOG_API_KEY` is set;
8
+ * person READS additionally need a privileged credential: an OAuth credential
9
+ * stored via `hogsend connect posthog` (preferred, token-manager-backed) or
10
+ * `POSTHOG_PERSONAL_API_KEY` (the public phc_ key is write-only by PostHog's
11
+ * design) — without either the provider still captures and writes person
12
+ * properties, and reads soft-fail to the engine's contact-property fallback.
13
+ *
14
+ * Consumer-supplied providers (`analytics.providers` / `analytics.provider`)
15
+ * merge AFTER these in the registry, so a consumer build of the same id wins.
16
+ */
17
+ export declare function analyticsProvidersFromEnv(env: typeof envSchema, deps?: {
18
+ db?: Database;
19
+ logger?: Logger;
20
+ }): AnalyticsProvider[];
21
+ /**
22
+ * Boot-time reader for the phc_ persisted by `hogsend connect posthog`
23
+ * (provider_credentials kind="derived", `projectApiKey`): a PURE builder —
24
+ * reads the stored credential and constructs the PostHog provider from it, or
25
+ * resolves null when there is nothing stored (or it can't be decrypted, which
26
+ * must behave exactly like "unconfigured"). ALL activation side effects
27
+ * (registry, `client.analytics`, the module singleton, identity rebind) live
28
+ * at the single call site in `container.ts`. Without this reader the
29
+ * persisted key is dead weight and outbound capture silently keeps requiring
30
+ * a hand-pasted env var.
31
+ *
32
+ * The capture host resolves env-first, then the ingestion host derived from
33
+ * the stored PRIVATE host (`eu.posthog.com` → `eu.i.posthog.com`) so an
34
+ * EU-connected instance never captures to the US default.
35
+ */
36
+ export declare function buildStoredPosthogProvider(opts: {
37
+ env: typeof envSchema;
38
+ db: Database;
39
+ logger: Logger;
40
+ }): Promise<AnalyticsProvider | null>;
41
+ //# sourceMappingURL=analytics-providers-from-env.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"analytics-providers-from-env.d.ts","sourceRoot":"","sources":["../../src/lib/analytics-providers-from-env.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AACvD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAM5C,OAAO,KAAK,EAAE,GAAG,IAAI,SAAS,EAAE,MAAM,WAAW,CAAC;AAClD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAK1C;;;;;;;;;;;GAWG;AACH,wBAAgB,yBAAyB,CACvC,GAAG,EAAE,OAAO,SAAS,EACrB,IAAI,CAAC,EAAE;IAAE,EAAE,CAAC,EAAE,QAAQ,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GACxC,iBAAiB,EAAE,CAUrB;AA+DD;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,0BAA0B,CAAC,IAAI,EAAE;IACrD,GAAG,EAAE,OAAO,SAAS,CAAC;IACtB,EAAE,EAAE,QAAQ,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAChB,GAAG,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAqBpC"}
@@ -0,0 +1,10 @@
1
+ import type { AnalyticsEventMirrorConfig, AnalyticsProvider } from "@hogsend/core";
2
+ export declare const setAnalytics: (value: AnalyticsProvider | undefined) => void;
3
+ export declare const getAnalytics: () => AnalyticsProvider | undefined;
4
+ /** Reset the singleton — only for test cleanup. */
5
+ export declare const resetAnalytics: () => void;
6
+ export declare const setAnalyticsEventMirror: (value: AnalyticsEventMirrorConfig | undefined) => void;
7
+ export declare const getAnalyticsEventMirror: () => AnalyticsEventMirrorConfig | undefined;
8
+ /** Reset the singleton — only for test cleanup. */
9
+ export declare const resetAnalyticsEventMirror: () => void;
10
+ //# sourceMappingURL=analytics-singleton.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"analytics-singleton.d.ts","sourceRoot":"","sources":["../../src/lib/analytics-singleton.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,0BAA0B,EAC1B,iBAAiB,EAClB,MAAM,eAAe,CAAC;AA4BvB,eAAO,MAAM,YAAY,gDAAgB,CAAC;AAC1C,eAAO,MAAM,YAAY,qCAAgB,CAAC;AAC1C,mDAAmD;AACnD,eAAO,MAAM,cAAc,YAAkB,CAAC;AAW9C,eAAO,MAAM,uBAAuB,yDAAsB,CAAC;AAC3D,eAAO,MAAM,uBAAuB,8CAAsB,CAAC;AAC3D,mDAAmD;AACnD,eAAO,MAAM,yBAAyB,YAAwB,CAAC"}
@@ -0,0 +1,9 @@
1
+ export declare function generateApiKey(opts?: {
2
+ publishable?: boolean;
3
+ }): {
4
+ key: string;
5
+ prefix: string;
6
+ hash: string;
7
+ };
8
+ export declare function hashApiKey(key: string): string;
9
+ //# sourceMappingURL=api-key-hash.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"api-key-hash.d.ts","sourceRoot":"","sources":["../../src/lib/api-key-hash.ts"],"names":[],"mappings":"AAIA,wBAAgB,cAAc,CAAC,IAAI,CAAC,EAAE;IAAE,WAAW,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG;IAChE,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd,CAWA;AAED,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE9C"}
@@ -0,0 +1,29 @@
1
+ /**
2
+ * Lazy access to `env.BETTER_AUTH_SECRET`, the engine's one master secret
3
+ * (AES-256-GCM key material for sealed link tokens and stored provider
4
+ * credentials).
5
+ *
6
+ * WHY THIS MODULE EXISTS: `../env.js` calls `createEnv` at MODULE SCOPE, so a
7
+ * static `import { env }` anywhere makes that file's whole import graph
8
+ * unloadable without a full, valid environment. `lib/account-links.ts` and
9
+ * `lib/provider-credentials.ts` are both reachable from `src/testing.ts` — the
10
+ * `@hogsend/engine/testing` entry point, which `@hogsend/testing` imports from
11
+ * a consumer app that has NO environment at all (the scaffold's packed-consumer
12
+ * smoke runs it under plain `tsx` with every var stripped). A static env import
13
+ * on that path turns "import a journey test helper" into "Invalid environment
14
+ * variables".
15
+ *
16
+ * Neither module reads the secret at module scope — only inside functions that
17
+ * are already `async` — so resolving it lazily costs nothing and validates
18
+ * EXACTLY the same contract: this loads the real `env.js`, it does not re-read
19
+ * or re-validate `process.env` itself. In a running API/worker `env.js` is
20
+ * already in the module cache (the container imports it at boot, so a bad
21
+ * environment still fails fast at startup); here the `await` just hands back
22
+ * the cached module.
23
+ *
24
+ * The promise is memoised, so the module is loaded — and, on a bad
25
+ * environment, throws — exactly once.
26
+ */
27
+ /** The validated `BETTER_AUTH_SECRET`, loading `env.js` on first use. */
28
+ export declare function getAppSecret(): Promise<string>;
29
+ //# sourceMappingURL=app-secret.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"app-secret.d.ts","sourceRoot":"","sources":["../../src/lib/app-secret.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAIH,yEAAyE;AACzE,wBAAgB,YAAY,IAAI,OAAO,CAAC,MAAM,CAAC,CAG9C"}
@@ -0,0 +1,53 @@
1
+ import type { EmailAttachment, EmailProvider } from "@hogsend/core";
2
+ /**
3
+ * Thrown when a send carries attachments but the resolved provider does not
4
+ * declare `capabilities.attachments`. A named class (mirroring
5
+ * `TestModeNoRedirectError`) so callers can branch on it without
6
+ * string-matching the message; the message itself names the provider id AND
7
+ * the capability so an operator reading a log can act on it directly.
8
+ */
9
+ export declare class AttachmentsUnsupportedError extends Error {
10
+ readonly providerId: string;
11
+ readonly code = "attachments_unsupported";
12
+ constructor(providerId: string);
13
+ }
14
+ /**
15
+ * The engine-side attachment gate, run BEFORE any other send work (no DB row,
16
+ * no render, no provider call happens first). Two checks, in order:
17
+ *
18
+ * 1. `assertValidAttachments` — shape/size/count validation. The relay
19
+ * validates too, and that is deliberate defence in depth rather than
20
+ * duplication: a Resend or Postmark send never passes through the relay at
21
+ * all, so for those providers THIS is the only gate before the wire.
22
+ *
23
+ * 2. The capability gate — throw unless the provider DECLARES
24
+ * `capabilities.attachments === true`. The quiet alternative (send the
25
+ * message, drop the files) is genuinely tempting and genuinely wrong: a
26
+ * receipt that arrives without its invoice looks *delivered* from every
27
+ * dashboard, from `email_sends`, and from the provider's own logs — nobody
28
+ * discovers it until the customer does. Absence of the flag is NOT consent
29
+ * (same rule as `consumesIdempotencyKey`): an absent or `false` flag means
30
+ * the provider cannot carry the files, so the send must fail loudly here,
31
+ * before anything is written or dispatched.
32
+ */
33
+ export declare function assertAttachmentsSendable(provider: EmailProvider, attachments: EmailAttachment[]): void;
34
+ /**
35
+ * One recorded metadata entry per attachment on the `email_sends` row:
36
+ * filename, raw byte size, and content type when declared.
37
+ */
38
+ export interface AttachmentSendMetadata {
39
+ filename: string;
40
+ sizeBytes: number;
41
+ contentType?: string;
42
+ }
43
+ /**
44
+ * What `email_sends.metadata.attachments` records: that the message HAD
45
+ * attachments — their filenames, raw sizes, and content types. NEVER the
46
+ * content itself. Storing customer invoices indefinitely is a data-protection
47
+ * decision nobody has made, and quietly making it here by persisting bytes
48
+ * would be the wrong default. Size comes from `attachmentByteLength` (raw
49
+ * bytes, decoded for `{ base64 }` content) so the recorded number matches the
50
+ * one the size cap enforces.
51
+ */
52
+ export declare function attachmentSendMetadata(attachments: EmailAttachment[]): AttachmentSendMetadata[];
53
+ //# sourceMappingURL=attachments.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"attachments.d.ts","sourceRoot":"","sources":["../../src/lib/attachments.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAGpE;;;;;;GAMG;AACH,qBAAa,2BAA4B,SAAQ,KAAK;IAExC,QAAQ,CAAC,UAAU,EAAE,MAAM;IADvC,QAAQ,CAAC,IAAI,6BAA6B;gBACrB,UAAU,EAAE,MAAM;CAQxC;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,yBAAyB,CACvC,QAAQ,EAAE,aAAa,EACvB,WAAW,EAAE,eAAe,EAAE,GAC7B,IAAI,CAKN;AAED;;;GAGG;AACH,MAAM,WAAW,sBAAsB;IACrC,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,CACpC,WAAW,EAAE,eAAe,EAAE,GAC7B,sBAAsB,EAAE,CAQ1B"}
@@ -0,0 +1,48 @@
1
+ import { type Database } from "@hogsend/db";
2
+ import type { ConversionRegistry } from "./conversions.js";
3
+ import type { Logger } from "./logger.js";
4
+ /**
5
+ * Attribution backfill (impact plan §5.1) — replays HISTORY through the
6
+ * same idempotent machinery ingest uses, so an existing deploy that
7
+ * upgrades gets its whole event history credited, and a definition/window
8
+ * change gets a deliberate, logged recompute path.
9
+ *
10
+ * Two stages behind one cursor (`events:<id>` → `credits:<id>`):
11
+ *
12
+ * 1. `events` — scan historical `user_events` matching the registry's
13
+ * trigger set and run conversion evaluation. The unique
14
+ * (definition, event) index makes replays no-ops; only genuinely new
15
+ * conversions are minted. Ad-platform dispatches are deliberately NOT
16
+ * enqueued — historical conversions must never re-fire to destinations.
17
+ * 2. `credits` — scan conversions rows (of the scoped definitions) that
18
+ * have NO credit rows yet and write their ledger entries under the
19
+ * definition's CURRENT window config.
20
+ *
21
+ * `recompute: true` (requires `definitionId`) deletes the definition's
22
+ * existing credit rows up front, then stage 2 re-credits everything — the
23
+ * ONE sanctioned exception to the ledger's write-once philosophy, guarded
24
+ * and logged. Conversion rows themselves are never deleted.
25
+ *
26
+ * Batch-shaped by design: each call processes up to `limit` rows of the
27
+ * current stage and returns `nextCursor` (null = done). The CLI loops it;
28
+ * an admin can curl it. Contacts are matched only — a historical event
29
+ * whose user never became a contact is skipped, never minted.
30
+ */
31
+ export interface BackfillBatchResult {
32
+ stage: "events" | "credits";
33
+ processed: number;
34
+ conversionsFired: number;
35
+ creditsWritten: number;
36
+ nextCursor: string | null;
37
+ }
38
+ export declare function backfillAttributionBatch(opts: {
39
+ db: Database;
40
+ logger: Logger;
41
+ registry: ConversionRegistry | undefined;
42
+ definitionId?: string;
43
+ since?: Date;
44
+ cursor?: string;
45
+ limit?: number;
46
+ recompute?: boolean;
47
+ }): Promise<BackfillBatchResult>;
48
+ //# sourceMappingURL=attribution-backfill.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"attribution-backfill.d.ts","sourceRoot":"","sources":["../../src/lib/attribution-backfill.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,QAAQ,EAEd,MAAM,aAAa,CAAC;AAarB,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAE3D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAE1C;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,QAAQ,GAAG,SAAS,CAAC;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,gBAAgB,EAAE,MAAM,CAAC;IACzB,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAKD,wBAAsB,wBAAwB,CAAC,IAAI,EAAE;IACnD,EAAE,EAAE,QAAQ,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,kBAAkB,GAAG,SAAS,CAAC;IACzC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,IAAI,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAqP/B"}
@@ -0,0 +1,44 @@
1
+ import { type DurationObject, type TouchpointChannel } from "@hogsend/core";
2
+ import { type Database } from "@hogsend/db";
3
+ import type { Logger } from "./logger.js";
4
+ /**
5
+ * The attribution ledger writer (plan §6.1): when a conversion fires, read
6
+ * the contact's touchpoint path inside the definition's lookback window and
7
+ * persist EVERY model's credit allocation into `attribution_credits`.
8
+ * Computing all models up front makes "switch the reporting model" a WHERE
9
+ * clause instead of a historical re-derivation.
10
+ *
11
+ * Idempotent: the unique (conversion, model, touchpoint) index turns any
12
+ * replay into a no-op — same inheritance as the conversion row itself.
13
+ */
14
+ export declare function recordAttributionCredits(opts: {
15
+ db: Database;
16
+ logger: Logger;
17
+ conversionId: string;
18
+ /** The contact's canonical event key (`user_events.user_id`). */
19
+ userKey: string;
20
+ /**
21
+ * The trusted owner uuid (`conversions.contact_id`). REQUIRED (not
22
+ * optional) for the same reason the enrollment guards' is: an optional
23
+ * field silently defaults a new caller onto the mutable text key, and the
24
+ * touchpoint path is precisely the history written BEFORE the person was
25
+ * identified — a key-scoped read drops the anonymous half of every journey
26
+ * and credits the conversion to nothing. Pass `null` explicitly for a
27
+ * subject with no contact; `userKey` still serves that case.
28
+ */
29
+ contactId: string | null;
30
+ value: number | null;
31
+ currency: string | null;
32
+ /** When the conversion happened. */
33
+ occurredAt: Date;
34
+ /** Lookback window in days (defineConversion attributionWindowDays). */
35
+ windowDays: number;
36
+ /**
37
+ * Per-channel window overrides (plan §2.1). A listed channel's touches
38
+ * qualify only inside its own window; unlisted channels use `windowDays`.
39
+ */
40
+ windows?: Partial<Record<TouchpointChannel, DurationObject>>;
41
+ }): Promise<{
42
+ touchpoints: number;
43
+ }>;
44
+ //# sourceMappingURL=attribution.d.ts.map