@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,55 @@
1
+ import { type TimeZone } from "@hogsend/core/schedule";
2
+ import { type Database } from "@hogsend/db";
3
+ export interface ResolveTimezoneInput {
4
+ /** Explicit per-call override, e.g. from `ctx.when.tz("Area/City")`. */
5
+ explicit?: string;
6
+ /** PostHog person properties ($timezone, $geoip_time_zone). */
7
+ posthogProperties?: Record<string, unknown>;
8
+ /** The `contacts.timezone` cache column. */
9
+ contactTimezone?: string | null;
10
+ /** The `contacts.properties` jsonb. */
11
+ contactProperties?: Record<string, unknown> | null;
12
+ /** The client `defaults.timezone`. */
13
+ defaultTimezone?: string;
14
+ logger?: {
15
+ warn(msg: string): void;
16
+ };
17
+ }
18
+ /**
19
+ * Source of a resolved timezone, surfaced so callers (e.g. `define-journey`)
20
+ * can decide whether to opportunistically cache it back to `contacts.timezone`.
21
+ */
22
+ export type TimezoneSource = "explicit" | "posthog_timezone" | "posthog_geoip" | "contact_column" | "contact_properties" | "default" | "fallback";
23
+ export interface ResolveTimezoneResult {
24
+ timezone: string;
25
+ source: TimezoneSource;
26
+ }
27
+ /**
28
+ * Resolve a user's IANA timezone via the precedence chain. The first *valid*
29
+ * candidate wins; invalid candidates are skipped and warned. Never throws —
30
+ * the terminal fallback is `"UTC"`.
31
+ *
32
+ * Precedence: explicit → PostHog `$timezone` → PostHog `$geoip_time_zone` →
33
+ * `contacts.timezone` → `contacts.properties.timezone` → client default → UTC.
34
+ */
35
+ export declare function resolveTimezoneWithSource(input: ResolveTimezoneInput): ResolveTimezoneResult;
36
+ /** Convenience wrapper returning just the resolved IANA timezone string. */
37
+ export declare function resolveTimezone(input: ResolveTimezoneInput): string;
38
+ /**
39
+ * Persist a known timezone for a contact (e.g. one the user picked in your
40
+ * app's settings) into the canonical `contacts.timezone` column, so the
41
+ * resolution chain prefers it over PostHog/geoip on the next journey run.
42
+ *
43
+ * Validates the zone and throws `TypeError` on an invalid one — this is an
44
+ * explicit, author-driven write, not best-effort data ingestion. Returns
45
+ * `{ updated: false }` if no contact exists yet for `userId` (it is created on
46
+ * first event ingestion); call again once the contact exists.
47
+ */
48
+ export declare function setContactTimezone(opts: {
49
+ db: Database;
50
+ userId: string;
51
+ timezone: TimeZone;
52
+ }): Promise<{
53
+ updated: boolean;
54
+ }>;
55
+ //# sourceMappingURL=timezone.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"timezone.d.ts","sourceRoot":"","sources":["../../src/lib/timezone.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmB,KAAK,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AACxE,OAAO,EAAY,KAAK,QAAQ,EAAE,MAAM,aAAa,CAAC;AAItD,MAAM,WAAW,oBAAoB;IACnC,wEAAwE;IACxE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,+DAA+D;IAC/D,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC5C,4CAA4C;IAC5C,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,uCAAuC;IACvC,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACnD,sCAAsC;IACtC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,MAAM,CAAC,EAAE;QAAE,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC;CACtC;AAED;;;GAGG;AACH,MAAM,MAAM,cAAc,GACtB,UAAU,GACV,kBAAkB,GAClB,eAAe,GACf,gBAAgB,GAChB,oBAAoB,GACpB,SAAS,GACT,UAAU,CAAC;AAEf,MAAM,WAAW,qBAAqB;IACpC,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,cAAc,CAAC;CACxB;AAMD;;;;;;;GAOG;AACH,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,oBAAoB,GAC1B,qBAAqB,CAwCvB;AAED,4EAA4E;AAC5E,wBAAgB,eAAe,CAAC,KAAK,EAAE,oBAAoB,GAAG,MAAM,CAEnE;AAED;;;;;;;;;GASG;AACH,wBAAsB,kBAAkB,CAAC,IAAI,EAAE;IAC7C,EAAE,EAAE,QAAQ,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,QAAQ,CAAC;CACpB,GAAG,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAA;CAAE,CAAC,CAuBhC"}
@@ -0,0 +1,95 @@
1
+ import type { EmailProvider } from "@hogsend/core";
2
+ import type { Database } from "@hogsend/db";
3
+ import type { RetryOptions, TemplateName, TemplateRegistry } from "@hogsend/email";
4
+ import type { TestModeState } from "./domain-status.js";
5
+ import { type FrequencyCapConfig, type SendTrackedEmailOptions, type TrackedSendResult } from "./email-service-types.js";
6
+ import { type Logger } from "./logger.js";
7
+ export type PrepareTrackedHtmlFn = (opts: {
8
+ html: string;
9
+ emailSendId: string;
10
+ baseUrl: string;
11
+ db: Database;
12
+ }) => Promise<string>;
13
+ /**
14
+ * Does the ACTIVE provider's TRANSPORT consume the `Idempotency-Key` header —
15
+ * lifting it off the message before anything reaches a recipient?
16
+ *
17
+ * THE RULE: a provider gets the engine's replay-stable key if and only if it
18
+ * DECLARES `capabilities.consumesIdempotencyKey: true`. Nothing else qualifies
19
+ * it — not its id, not its package. A third party opts in the same way the
20
+ * first-party relay does, by writing the declaration.
21
+ *
22
+ * Absence is NOT consent, and the default is the whole safety story. Resend and
23
+ * Postmark forward `SendEmailOptions.headers` VERBATIM onto the delivered
24
+ * message (Resend `headers`, Postmark `Headers`), so volunteering the key to a
25
+ * provider that never asked would stamp internal keys — which embed Hatchet run
26
+ * ids and wait labels (`journeySend:<runId>:<site>:<template>`) and, for
27
+ * campaign sends, the recipient's own address (`campaign:<id>:<email>`) — onto
28
+ * real customer mail, silently, on nothing more than an engine upgrade. So an
29
+ * absent or `false` flag means the delivered headers are byte-for-byte what
30
+ * they were before any of this existed.
31
+ *
32
+ * An `Idempotency-Key` the CALLER placed in `options.headers` themselves is
33
+ * untouched by this gate: explicit headers pass through regardless of what the
34
+ * provider declares, exactly as they did before the key threading existed.
35
+ */
36
+ export declare function providerConsumesIdempotencyKey(provider: EmailProvider): boolean;
37
+ /**
38
+ * Thread the send's replay-stable idempotency key onto the provider wire.
39
+ *
40
+ * `SendEmailOptions` has no `idempotencyKey` field — the contract is
41
+ * deliberately provider-NEUTRAL, so the key rides as a header, and ONLY to a
42
+ * provider that consumes it ({@link providerConsumesIdempotencyKey}): a
43
+ * header-forwarding provider (Resend, Postmark) would deliver it to the
44
+ * recipient as an SMTP header, so the caller passes `undefined` for those.
45
+ *
46
+ * This is load-bearing rather than a nicety. A transport that has to invent its
47
+ * own key can only hash the message bytes, and that CANNOT protect a crash
48
+ * replay: `prepareTrackedHtml` mints fresh `tracked_links` ids and an open pixel
49
+ * carrying the send id on every attempt, so a re-drive of the SAME logical send
50
+ * produces different HTML, a different hash, and no replay protection at all. A
51
+ * journey replayed after a worker crash would send twice. The engine already
52
+ * holds the only key that survives a replay (`journeySend:<runId>:<site>:<template>`,
53
+ * the same one the `email_sends` unique index dedups on), so it hands it over —
54
+ * one key, both dedup layers.
55
+ *
56
+ * An `Idempotency-Key` the CALLER already set is never clobbered: an explicit
57
+ * header is a deliberate override, and silently replacing it would make two
58
+ * distinct sends look like one to the transport.
59
+ */
60
+ export declare function withIdempotencyHeader(headers: Record<string, string> | undefined, key: string | undefined): Record<string, string> | undefined;
61
+ interface TrackedEmailDeps {
62
+ db: Database;
63
+ provider: EmailProvider;
64
+ /** The client app's template registry, threaded into {@link getTemplate}. */
65
+ registry: TemplateRegistry;
66
+ retryOptions?: RetryOptions;
67
+ prepareTrackedHtml?: PrepareTrackedHtmlFn;
68
+ /** Optional per-client frequency cap; undefined disables capping. */
69
+ frequencyCap?: FrequencyCapConfig;
70
+ /** Optional structured logger for operational events (e.g. cap skips). */
71
+ logger?: Logger;
72
+ /**
73
+ * The active test-mode state, resolved ONCE by the mailer (cache-only) and
74
+ * threaded in so this module stays domainStatus-unaware. `null` ⇒ live send.
75
+ * When active, suppression/frequency/unsubscribe still key to the ORIGINAL
76
+ * recipient (`options.to`); only the wire + `email_sends` row are redirected.
77
+ */
78
+ testMode?: TestModeState | null;
79
+ }
80
+ /**
81
+ * Boundary-aware entry point. When a send reaches the tracked mailer from INSIDE
82
+ * a journey `run()` WITHOUT an idempotency key already set — i.e. a journey that
83
+ * called the raw `getEmailService().send(...)` instead of the `sendEmail()`
84
+ * helper (which derives its own key) — derive the same deterministic, replay-
85
+ * stable key HERE so the engine's exactly-once guarantee covers that path too.
86
+ * This closes the raw-service footgun: ANY journey send is auto-keyed + memoized
87
+ * regardless of which import the author reached for. Outside a journey, or when
88
+ * a key is already set (sendEmail / POST /v1/emails), this is a transparent
89
+ * pass-through to {@link sendTrackedEmailInner}.
90
+ */
91
+ export declare function sendTrackedEmail<K extends TemplateName>(opts: TrackedEmailDeps & {
92
+ options: SendTrackedEmailOptions<K>;
93
+ }): Promise<TrackedSendResult>;
94
+ export {};
95
+ //# sourceMappingURL=tracked.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"tracked.d.ts","sourceRoot":"","sources":["../../src/lib/tracked.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAE5C,OAAO,KAAK,EAEV,YAAY,EACZ,YAAY,EACZ,gBAAgB,EACjB,MAAM,gBAAgB,CAAC;AAoBxB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EACL,KAAK,kBAAkB,EACvB,KAAK,uBAAuB,EAC5B,KAAK,iBAAiB,EAEvB,MAAM,0BAA0B,CAAC;AAKlC,OAAO,EAAgB,KAAK,MAAM,EAAE,MAAM,aAAa,CAAC;AAgBxD,MAAM,MAAM,oBAAoB,GAAG,CAAC,IAAI,EAAE;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,EAAE,EAAE,QAAQ,CAAC;CACd,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;AAKtB;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,8BAA8B,CAC5C,QAAQ,EAAE,aAAa,GACtB,OAAO,CAET;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,EAC3C,GAAG,EAAE,MAAM,GAAG,SAAS,GACtB,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAQpC;AAED,UAAU,gBAAgB;IACxB,EAAE,EAAE,QAAQ,CAAC;IACb,QAAQ,EAAE,aAAa,CAAC;IACxB,6EAA6E;IAC7E,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,kBAAkB,CAAC,EAAE,oBAAoB,CAAC;IAC1C,qEAAqE;IACrE,YAAY,CAAC,EAAE,kBAAkB,CAAC;IAClC,0EAA0E;IAC1E,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,aAAa,GAAG,IAAI,CAAC;CACjC;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,gBAAgB,CAAC,CAAC,SAAS,YAAY,EAC3D,IAAI,EAAE,gBAAgB,GAAG;IAAE,OAAO,EAAE,uBAAuB,CAAC,CAAC,CAAC,CAAA;CAAE,GAC/D,OAAO,CAAC,iBAAiB,CAAC,CAwB5B"}
@@ -0,0 +1,7 @@
1
+ export declare const EMAIL_OPENED: "email.opened";
2
+ export declare const EMAIL_LINK_CLICKED: "email.link_clicked";
3
+ export declare const EMAIL_REPLIED: "email.replied";
4
+ export declare const LINK_CLICKED: "link.clicked";
5
+ export declare const LINK_ARRIVED: "link.arrived";
6
+ export declare const SMS_LINK_CLICKED: "sms.link_clicked";
7
+ //# sourceMappingURL=tracking-event-names.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"tracking-event-names.d.ts","sourceRoot":"","sources":["../../src/lib/tracking-event-names.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,YAAY,EAAG,cAAuB,CAAC;AACpD,eAAO,MAAM,kBAAkB,EAAG,oBAA6B,CAAC;AAShE,eAAO,MAAM,aAAa,EAAG,eAAwB,CAAC;AAStD,eAAO,MAAM,YAAY,EAAG,cAAuB,CAAC;AAQpD,eAAO,MAAM,YAAY,EAAG,cAAuB,CAAC;AAMpD,eAAO,MAAM,gBAAgB,EAAG,kBAA2B,CAAC"}
@@ -0,0 +1,232 @@
1
+ import type { HatchetClient } from "@hatchet-dev/typescript-sdk/v1/index.js";
2
+ import type { JourneyRegistry } from "@hogsend/core/registry";
3
+ import { type Database } from "@hogsend/db";
4
+ import { type IngestResult } from "./ingestion.js";
5
+ import type { Logger } from "./logger.js";
6
+ interface EmailSendContext {
7
+ /**
8
+ * Display/attribution identity: the enrollment's key, else the send's
9
+ * recorded `user_id`, else the recipient address. Never re-ingest this as
10
+ * `userId` — use {@link subjectKey}, which is null for a bare-address send.
11
+ */
12
+ userId: string;
13
+ userEmail: string;
14
+ /**
15
+ * The subject key the send was actually made for (enrollment key, else
16
+ * `email_sends.user_id`), or null for a bare-address send. Bus re-ingests key
17
+ * on this, so a raw send's address is offered as an EMAIL key, never as an
18
+ * external `userId` (which would fill a free `external_id` with the address
19
+ * and flip the contact's canonical key).
20
+ */
21
+ subjectKey: string | null;
22
+ /**
23
+ * PRD 05 T6 — the send's owning contact (`email_sends.contact_id`, falling
24
+ * back to the enrollment's stamp). The denormalized `userId` string above is
25
+ * FROZEN at send time and goes stale when the contact adopts a new key; the
26
+ * re-ingest pins this id so tracking events land on the contact, not on
27
+ * whatever key happened to be canonical when the mail left.
28
+ */
29
+ contactId: string | null;
30
+ templateKey: string | null;
31
+ messageId: string | null;
32
+ to: string;
33
+ /**
34
+ * Attribution scope (plan §1.2): the enrollment's journey id and the send's
35
+ * campaign id, stamped into every tracking event's properties so the credit
36
+ * ledger can slice by journey/campaign without a join back through
37
+ * email_sends. Null for transactional/raw sends.
38
+ */
39
+ journeyId: string | null;
40
+ campaignId: string | null;
41
+ }
42
+ export declare function resolveEmailSendContext(db: Database, emailSendId: string | null): Promise<EmailSendContext | null>;
43
+ export interface EmailSendContextByMessageId {
44
+ emailSendId: string;
45
+ userId: string;
46
+ userEmail: string;
47
+ /** See {@link EmailSendContext.contactId}. */
48
+ contactId: string | null;
49
+ templateKey: string | null;
50
+ to: string;
51
+ }
52
+ /**
53
+ * @deprecated Renamed to {@link EmailSendContextByMessageId} as part of the
54
+ * provider-neutral `resendId` → `messageId` rename. Kept as an alias for one
55
+ * minor; removed the following minor.
56
+ */
57
+ export type ResendEmailSendContext = EmailSendContextByMessageId;
58
+ /**
59
+ * Mirror of {@link resolveEmailSendContext} that resolves by the provider's
60
+ * `messageId` instead of the internal `email_sends.id`. Used by the
61
+ * provider-webhook enrichment path (`email.delivered`/`email.bounced`) where the
62
+ * only handle we hold is the provider message id.
63
+ *
64
+ * Returns the internal `emailSendId` plus the same denormalized identity
65
+ * (`userId`/`userEmail` fall back to the recipient address, exactly like the
66
+ * id-keyed resolver) and `to` recipient. Returns null when no send row carries
67
+ * that `messageId` yet (e.g. a webhook arriving before the send row is committed).
68
+ */
69
+ export declare function resolveEmailSendContextByMessageId(db: Database, messageId: string): Promise<EmailSendContextByMessageId | null>;
70
+ /**
71
+ * @deprecated Renamed to {@link resolveEmailSendContextByMessageId} as part of
72
+ * the provider-neutral `resendId` → `messageId` rename. Kept as an alias for one
73
+ * minor; removed the following minor.
74
+ */
75
+ export declare const resolveEmailSendContextByResendId: typeof resolveEmailSendContextByMessageId;
76
+ export interface PushTrackingEventOpts {
77
+ db: Database;
78
+ hatchet: HatchetClient;
79
+ registry: JourneyRegistry;
80
+ logger: Logger;
81
+ event: string;
82
+ emailSendId: string;
83
+ properties?: Record<string, unknown>;
84
+ /**
85
+ * Pre-resolved send context. When provided (including `null`), the duplicate
86
+ * `resolveEmailSendContext` read is skipped — the tracking routes resolve once
87
+ * and share the result with the outbound emit on the hot path. Omit to resolve
88
+ * lazily.
89
+ */
90
+ resolvedContext?: EmailSendContext | null;
91
+ /**
92
+ * Threaded straight into `ingestEvent` — a duplicate key returns
93
+ * `{ stored: false }` BEFORE the Hatchet push, so journeys never see the
94
+ * duplicate. Semantic link answers use `sem:<emailSendId>:<event>` for
95
+ * first-answer-per-send semantics.
96
+ */
97
+ idempotencyKey?: string;
98
+ }
99
+ /**
100
+ * Re-push a first-party tracking event (open/click) back onto the INTERNAL bus
101
+ * (`ingestEvent`) for journey routing + `userEvents` persistence.
102
+ *
103
+ * NOTE (Phase 2): this NO LONGER fires a fire-and-forget PostHog `captureEvent`.
104
+ * PostHog now receives opens/clicks PER-HIT via the durable outbound spine — a
105
+ * `kind="posthog"` destination subscribed to `email.opened`/`email.clicked` (the
106
+ * tracking routes call `emitOutbound` alongside this). The legacy double-emit was
107
+ * removed so PostHog gets exactly one, durable copy of each hit.
108
+ */
109
+ export declare function pushTrackingEvent(opts: PushTrackingEventOpts): Promise<IngestResult | undefined>;
110
+ export interface PushLinkClickEventOpts {
111
+ db: Database;
112
+ hatchet: HatchetClient;
113
+ registry: JourneyRegistry;
114
+ logger: Logger;
115
+ /**
116
+ * The MANAGED `links.id` — the durable, re-mint-safe key a journey filters on
117
+ * via `trigger.where`/`ctx.waitForEvent` (`where: b.prop("linkId").eq(...)`).
118
+ * Null when the tracked link has no managed parent row.
119
+ */
120
+ linkId: string | null;
121
+ /** The `tracked_links.id` (the redirect `:id`); disambiguates a re-mint. */
122
+ trackedLinkId: string;
123
+ campaign: string | null;
124
+ source: string | null;
125
+ linkType: string | null;
126
+ linkUrl: string;
127
+ /**
128
+ * The personal link's canonical contact key (`links.distinct_id`). MUST be the
129
+ * subject's EXTERNAL canonical key (an app `external_id`) or the contact's
130
+ * canonical uuid key — a raw snowflake or anonymous id would fork an orphan
131
+ * contact. NOTE: a Discord member is keyed by the `discord_id` COLUMN, not an
132
+ * `external_id`, so a `"discord:<id>"` value here would fork an orphan contact;
133
+ * reach a discord-keyed contact by its resolved canonical key instead. Null ⇒
134
+ * a broadcast/public link (no person) ⇒ no re-ingest.
135
+ */
136
+ distinctId: string | null;
137
+ idempotencyKey?: string;
138
+ }
139
+ /**
140
+ * Re-push a NON-email managed-link click onto the INTERNAL bus (`ingestEvent`)
141
+ * as the first-party `link.clicked` event so journeys can trigger / await a
142
+ * click of a SPECIFIC managed link (filtered by `linkId`/`campaign`).
143
+ *
144
+ * IDENTITY GATE (crash-guard): the resolve THROWS on a zero-key event, so a
145
+ * broadcast/public link (`distinctId == null`) returns `undefined` WITHOUT
146
+ * calling ingest. The click route ALSO suppresses bot/prefetch hits upstream
147
+ * (`isBotOrPrefetch`), so an unfurl bot never reaches here. All six payload
148
+ * keys are scalars (or null) so they survive ingest and reach `trigger.where` +
149
+ * `waitForEvent.properties`.
150
+ *
151
+ * NEVER MINTS (D11). This is a re-ingest DERIVED from an earlier observation,
152
+ * so it inherits that observation's refusal — `allowCreate: false`. `mintLink`
153
+ * copies whatever `distinctId` the caller passes for a `personal` link, so a
154
+ * link minted for a visitor who was never identified carries an ANON key; with
155
+ * creation allowed the create arm wrote `external_id = <anonId>`, the shape
156
+ * #621 calls strictly WORSE than the ghost it replaces (it then answers
157
+ * `collidesWithIdentified` (contacts.ts) and 403-locks the visitor out of their
158
+ * own feed). Safe by construction: a link carrying a `distinctId` was minted for
159
+ * someone already known, so either the key resolves — fill-in-link, unchanged —
160
+ * or it was refused at observation time and must STAY refused.
161
+ *
162
+ * Unlike `sendFeedItem`'s `userId` arm (lib/feed.ts), the mint here has no
163
+ * confidentiality role. There it is load-bearing: the minted row is the only
164
+ * signal `collidesWithIdentified` has, and refusing would convert a private
165
+ * feed row into an anon-addressable one. This is an event ingest, not a
166
+ * feed-read authorization — `collidesWithIdentified` is consulted only by
167
+ * `routes/feed/recipient.ts` and `routes/tracking/arrive.ts`, neither of which
168
+ * reads anything this function writes.
169
+ *
170
+ * Nothing is lost by the refusal: `resolvedKey` is always a real string (D8),
171
+ * so `user_events` still stores under the same key and journeys still trigger.
172
+ * `tracked_links` has no `contact_id` column (only `distinctId`), so inheriting
173
+ * the refusal is the correct fix rather than threading a provenance pin — if a
174
+ * later change adds `contact_id` there, revisit.
175
+ *
176
+ * Distinct from the per-hit OUTBOUND `link.clicked` webhook: that fires for
177
+ * EVERY hit and carries `trackedLinks.id` + the raw mint distinctId; THIS bus
178
+ * event carries the managed `links.id` + the resolved survivor contact key.
179
+ */
180
+ export declare function pushLinkClickEvent(opts: PushLinkClickEventOpts): Promise<IngestResult | undefined>;
181
+ export interface SmsSendContext {
182
+ /**
183
+ * The resolved contact key: the enrollment's userId, else the send row's
184
+ * denormalized userId, else NULL. Deliberately NO phone fallback — phone is
185
+ * not a merge-participating contact `Kind`, so a phone-keyed ingest would
186
+ * fork an orphan contact.
187
+ */
188
+ userId: string | null;
189
+ userEmail: string | null;
190
+ /**
191
+ * PRD 05 T6 — the enrollment's contact stamp (`sms_sends` itself carries no
192
+ * dual-write column). Null for a journeyless send.
193
+ */
194
+ contactId: string | null;
195
+ templateKey: string | null;
196
+ messageId: string | null;
197
+ to: string;
198
+ /**
199
+ * Attribution scope (plan §1.2): the enrollment's journey id. No campaign
200
+ * leg — campaign steps are email-only today, so `sms_sends` carries no
201
+ * campaign column (plan §5 Q3).
202
+ */
203
+ journeyId: string | null;
204
+ }
205
+ /**
206
+ * The SMS sibling of {@link resolveEmailSendContext}: one LEFT JOIN from
207
+ * `sms_sends` to `journey_states` giving the click pipeline the identity +
208
+ * template context for the bus re-ingest and the `sms.clicked` outbound emit.
209
+ */
210
+ export declare function resolveSmsSendContext(db: Database, smsSendId: string | null): Promise<SmsSendContext | null>;
211
+ export interface PushSmsTrackingEventOpts {
212
+ db: Database;
213
+ hatchet: HatchetClient;
214
+ registry: JourneyRegistry;
215
+ logger: Logger;
216
+ event: string;
217
+ smsSendId: string;
218
+ properties?: Record<string, unknown>;
219
+ /** Pre-resolved send context (including null) skips the duplicate read. */
220
+ resolvedContext?: SmsSendContext | null;
221
+ idempotencyKey?: string;
222
+ }
223
+ /**
224
+ * Re-push a first-party SMS tracking event (short-link click) onto the
225
+ * INTERNAL bus for journey routing + `userEvents` persistence — the SMS
226
+ * sibling of {@link pushTrackingEvent}. Returns undefined without ingesting
227
+ * when the send has no resolvable contact key (`ingestEvent` throws on a
228
+ * zero-key event, and phone is not a contact key).
229
+ */
230
+ export declare function pushSmsTrackingEvent(opts: PushSmsTrackingEventOpts): Promise<IngestResult | undefined>;
231
+ export {};
232
+ //# sourceMappingURL=tracking-events.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"tracking-events.d.ts","sourceRoot":"","sources":["../../src/lib/tracking-events.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yCAAyC,CAAC;AAC7E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EACL,KAAK,QAAQ,EAId,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,KAAK,YAAY,EAAe,MAAM,gBAAgB,CAAC;AAChE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAG1C,UAAU,gBAAgB;IACxB;;;;OAIG;IACH,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB;;;;;;OAMG;IACH,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B;;;;;;OAMG;IACH,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,EAAE,EAAE,MAAM,CAAC;IACX;;;;;OAKG;IACH,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAED,wBAAsB,uBAAuB,CAC3C,EAAE,EAAE,QAAQ,EACZ,WAAW,EAAE,MAAM,GAAG,IAAI,GACzB,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAuClC;AAED,MAAM,WAAW,2BAA2B;IAC1C,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,8CAA8C;IAC9C,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,EAAE,EAAE,MAAM,CAAC;CACZ;AAED;;;;GAIG;AACH,MAAM,MAAM,sBAAsB,GAAG,2BAA2B,CAAC;AAEjE;;;;;;;;;;GAUG;AACH,wBAAsB,kCAAkC,CACtD,EAAE,EAAE,QAAQ,EACZ,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,2BAA2B,GAAG,IAAI,CAAC,CA6B7C;AAED;;;;GAIG;AACH,eAAO,MAAM,iCAAiC,2CACV,CAAC;AAErC,MAAM,WAAW,qBAAqB;IACpC,EAAE,EAAE,QAAQ,CAAC;IACb,OAAO,EAAE,aAAa,CAAC;IACvB,QAAQ,EAAE,eAAe,CAAC;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC;;;;;OAKG;IACH,eAAe,CAAC,EAAE,gBAAgB,GAAG,IAAI,CAAC;IAC1C;;;;;OAKG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;;;;;;;;GASG;AACH,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,qBAAqB,GAC1B,OAAO,CAAC,YAAY,GAAG,SAAS,CAAC,CAoCnC;AAED,MAAM,WAAW,sBAAsB;IACrC,EAAE,EAAE,QAAQ,CAAC;IACb,OAAO,EAAE,aAAa,CAAC;IACvB,QAAQ,EAAE,eAAe,CAAC;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf;;;;OAIG;IACH,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,4EAA4E;IAC5E,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB;;;;;;;;OAQG;IACH,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AACH,wBAAsB,kBAAkB,CACtC,IAAI,EAAE,sBAAsB,GAC3B,OAAO,CAAC,YAAY,GAAG,SAAS,CAAC,CA0BnC;AAED,MAAM,WAAW,cAAc;IAC7B;;;;;OAKG;IACH,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB;;;OAGG;IACH,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,EAAE,EAAE,MAAM,CAAC;IACX;;;;OAIG;IACH,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED;;;;GAIG;AACH,wBAAsB,qBAAqB,CACzC,EAAE,EAAE,QAAQ,EACZ,SAAS,EAAE,MAAM,GAAG,IAAI,GACvB,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CA8BhC;AAED,MAAM,WAAW,wBAAwB;IACvC,EAAE,EAAE,QAAQ,CAAC;IACb,OAAO,EAAE,aAAa,CAAC;IACvB,QAAQ,EAAE,eAAe,CAAC;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,2EAA2E;IAC3E,eAAe,CAAC,EAAE,cAAc,GAAG,IAAI,CAAC;IACxC,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;;;;;GAMG;AACH,wBAAsB,oBAAoB,CACxC,IAAI,EAAE,wBAAwB,GAC7B,OAAO,CAAC,YAAY,GAAG,SAAS,CAAC,CA+BnC"}
@@ -0,0 +1,47 @@
1
+ import type { Database } from "@hogsend/db";
2
+ /** Never rewrite unsubscribe/preference URLs (shared with the SMS rewriter). */
3
+ export declare function shouldSkipUrl(url: string): boolean;
4
+ export declare function rewriteLinks(opts: {
5
+ html: string;
6
+ emailSendId: string;
7
+ baseUrl: string;
8
+ db: Database;
9
+ }): Promise<string>;
10
+ export declare function injectOpenPixel(opts: {
11
+ html: string;
12
+ emailSendId: string;
13
+ baseUrl: string;
14
+ }): string;
15
+ export declare function prepareTrackedHtml(opts: {
16
+ html: string;
17
+ emailSendId: string;
18
+ baseUrl: string;
19
+ db: Database;
20
+ }): Promise<string>;
21
+ /**
22
+ * The mint surface for a NON-email tracked link (Discord, referral, ad-hoc).
23
+ * Inserts a `tracked_links` row with a NULL `emailSendId` and returns the
24
+ * `/v1/t/c/:id` redirect URL to use in place of the raw destination.
25
+ *
26
+ * This is the SINGLE chokepoint enforcing "broadcast links carry no subject":
27
+ * a link only becomes identity-bearing when the caller EXPLICITLY passes
28
+ * `distinctId` (the canonical contact key the click should stitch into). Per
29
+ * MF-4, the referral path does NOT pass `distinctId` by default (referral
30
+ * pages are shareable → broadcast), and the Discord destination passes
31
+ * `distinctId: undefined`. The `hs_t` mint at click time is still gated by
32
+ * `TRACKING_IDENTITY_TOKEN` (default false); a row with a NULL `distinctId`
33
+ * never mints a token regardless.
34
+ */
35
+ export declare function createTrackedLink(opts: {
36
+ db: Database;
37
+ url: string;
38
+ /**
39
+ * The canonical contact key a click should fold the visitor's anon session
40
+ * into. OMIT for a broadcast link (the safe default) — only an explicit,
41
+ * single-subject, non-shareable link should pass this.
42
+ */
43
+ distinctId?: string;
44
+ source: "discord" | "referral" | "link";
45
+ baseUrl: string;
46
+ }): Promise<string>;
47
+ //# sourceMappingURL=tracking.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"tracking.d.ts","sourceRoot":"","sources":["../../src/lib/tracking.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AA8B5C,gFAAgF;AAChF,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAElD;AAwFD,wBAAsB,YAAY,CAAC,IAAI,EAAE;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,EAAE,EAAE,QAAQ,CAAC;CACd,GAAG,OAAO,CAAC,MAAM,CAAC,CA+ElB;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;CACjB,GAAG,MAAM,CAUT;AAED,wBAAsB,kBAAkB,CAAC,IAAI,EAAE;IAC7C,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,EAAE,EAAE,QAAQ,CAAC;CACd,GAAG,OAAO,CAAC,MAAM,CAAC,CAQlB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,iBAAiB,CAAC,IAAI,EAAE;IAC5C,EAAE,EAAE,QAAQ,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,SAAS,GAAG,UAAU,GAAG,MAAM,CAAC;IACxC,OAAO,EAAE,MAAM,CAAC;CACjB,GAAG,OAAO,CAAC,MAAM,CAAC,CAUlB"}
@@ -0,0 +1,20 @@
1
+ /**
2
+ * The inert email provider a container boots with when NO provider is
3
+ * configured and none was explicitly requested (mirrors the SMS channel's
4
+ * operator-opt-in posture: unconfigured ⇒ inert stub, not a boot crash).
5
+ *
6
+ * A fresh scaffold has no RESEND_API_KEY yet — it should still boot, serve
7
+ * Studio, ingest events and run non-email journeys. Every email send fails
8
+ * per-call with this actionable message instead; the container logs one boot
9
+ * warning. Never registered in the provider registry, so no webhook route
10
+ * resolves it.
11
+ *
12
+ * DELIBERATE seam choice (vs SMS's service-level stub): the stub is the WIRE
13
+ * inside the real tracked mailer, so an unconfigured send still runs the
14
+ * pipeline (preferences → render → tracking → `email_sends` write) and fails
15
+ * at dispatch — leaving a failed-send row visible in Studio, which is exactly
16
+ * the operator-facing breadcrumb a "why didn't my email go out?" moment needs.
17
+ */
18
+ export declare const UNCONFIGURED_EMAIL_MESSAGE: string;
19
+ export declare function createUnconfiguredEmailProvider(): import("@hogsend/core").EmailProvider;
20
+ //# sourceMappingURL=unconfigured-email-provider.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"unconfigured-email-provider.d.ts","sourceRoot":"","sources":["../../src/lib/unconfigured-email-provider.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,0BAA0B,QAGb,CAAC;AAE3B,wBAAgB,+BAA+B,0CAoB9C"}
@@ -0,0 +1,22 @@
1
+ /**
2
+ * PRD 05 T3 — the shared "was this a unique_violation on THAT index?" probe.
3
+ *
4
+ * The contact-scoped uniqueness indexes are pure CONSTRAINTS: no upsert names
5
+ * them as an `ON CONFLICT` arbiter, because drizzle can only target columns and
6
+ * a bare `(contact_id, …)` arbiter would never fire for the NULL (contactless)
7
+ * population — an anonymous re-trigger would then insert a second row and die on
8
+ * the retained string index. So each writer keeps its string arbiter and
9
+ * converts THIS error into its own already-exists branch.
10
+ *
11
+ * Postgres reports the code as 23505 and names the index in `constraint_name`,
12
+ * but drizzle wraps the driver error in a `DrizzleQueryError`, so the real
13
+ * payload lives on `cause` (sometimes nested) — walk the chain, bounded. Mirrors
14
+ * `isSlugUniqueViolation` (lib/links.ts) and `isPhoneUniqueViolation`
15
+ * (lib/contacts.ts); this is the extracted, shared form.
16
+ */
17
+ export declare function isUniqueViolationOn(err: unknown, index: string): boolean;
18
+ /** `journey_states` — one live enrollment per (contact, journey). */
19
+ export declare const UQ_CONTACT_JOURNEY_ACTIVE = "uq_contact_journey_active";
20
+ /** `email_preferences` — one row per (contact, email). */
21
+ export declare const UQ_CONTACT_EMAIL_PREFERENCES = "email_preferences_contact_email_idx";
22
+ //# sourceMappingURL=unique-violation.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"unique-violation.d.ts","sourceRoot":"","sources":["../../src/lib/unique-violation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAoBxE;AAED,qEAAqE;AACrE,eAAO,MAAM,yBAAyB,8BAA8B,CAAC;AAErE,0DAA0D;AAC1D,eAAO,MAAM,4BAA4B,wCACF,CAAC"}
@@ -0,0 +1,44 @@
1
+ /**
2
+ * The publishable-key `userToken` — a short-lived HMAC over a `userId`, signed
3
+ * with `BETTER_AUTH_SECRET` (the same trust root as the `hs_t` identity token).
4
+ *
5
+ * Unlike `hs_t` (AES-256-GCM ENCRYPTED, because it can carry an email), this
6
+ * token is SIGNED-NOT-ENCRYPTED: it carries only a `userId` the integrating
7
+ * server already knows and chose to assert, so there is no PII to hide — only
8
+ * integrity (a browser must not be able to forge another person's userId) to
9
+ * guarantee.
10
+ *
11
+ * v1 use: a publishable (pk_) key is ANON-ONLY by default. To act on a concrete
12
+ * `userId`, the browser must present a `userToken` the integrating server minted
13
+ * SERVER-SIDE (v3 ships the mint helper into the SDK / a signing endpoint). In
14
+ * v1 the VERIFY function exists and is wired into every publishable-reachable
15
+ * handler, but with no mint path exposed a pk_ key is effectively anon-only —
16
+ * the secure default, and the point.
17
+ */
18
+ export interface UserTokenPayload {
19
+ userId: string;
20
+ exp: number;
21
+ }
22
+ export declare class InvalidUserTokenError extends Error {
23
+ constructor(message: string);
24
+ }
25
+ /**
26
+ * MINT helper — v3. Present but UNUSED by the engine in v1 (publishable keys are
27
+ * anon-only by default). Wired here so v3 can expose a signer (SDK / endpoint)
28
+ * without re-touching the verify path. Produces `<base64url(payload)>.<sig>`.
29
+ */
30
+ export declare function generateUserToken(opts: {
31
+ secret: string;
32
+ userId: string;
33
+ expiresInSeconds?: number;
34
+ }): string;
35
+ /**
36
+ * VERIFY: parse `<base64url(payload)>.<sig>`, verify the HMAC in constant time,
37
+ * and check expiry. Throws {@link InvalidUserTokenError} on any failure
38
+ * (malformed, bad signature, bad payload shape, expired).
39
+ */
40
+ export declare function verifyUserToken(opts: {
41
+ token: string;
42
+ secret: string;
43
+ }): UserTokenPayload;
44
+ //# sourceMappingURL=user-token.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"user-token.d.ts","sourceRoot":"","sources":["../../src/lib/user-token.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;GAgBG;AAEH,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;CACb;AAED,qBAAa,qBAAsB,SAAQ,KAAK;gBAClC,OAAO,EAAE,MAAM;CAI5B;AAQD;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE;IACtC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B,GAAG,MAAM,CAST;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB,GAAG,gBAAgB,CAiCnB"}
@@ -0,0 +1,44 @@
1
+ /**
2
+ * Uniform 0-9999 bucket. Hash input is `variant:<journeyId>:<key>:<userId>`
3
+ * — the `variant:` prefix + the key segment make this hash family DISJOINT
4
+ * from holdoutBucket's `<salt>:<journeyId>:<userId>` (holdout.ts:17), so
5
+ * variant assignment is statistically independent of holdout assignment.
6
+ * `key` cannot contain `:` (validated), so segments are unambiguous.
7
+ * FROZEN COMPATIBILITY CONTRACT under the replay law — locked by a
8
+ * golden-value test; changing it re-buckets live experiments mid-flight.
9
+ */
10
+ export declare function variantBucket(opts: {
11
+ journeyId: string;
12
+ key: string;
13
+ userId: string;
14
+ }): number;
15
+ /**
16
+ * Key-syntax-only check — runs BEFORE the recordOnce read (it gates the
17
+ * jsonb path). Throws RangeError. 1-64 chars of [A-Za-z0-9_.-], starting
18
+ * with a letter or digit; no `:` (it delimits the hash-input segments) and
19
+ * no whitespace.
20
+ */
21
+ export declare function validateVariantKey(key: string): void;
22
+ /**
23
+ * Arms validation — runs ONLY inside the compute path (see performVariant
24
+ * in journeys/journey-context.ts): an enrollment with a recorded arm must
25
+ * never crash on a later deploy that ships malformed arms. Throws
26
+ * RangeError on: zero arms (JS callers; TS blocks via the tuple type),
27
+ * empty/non-string arm, duplicate arms.
28
+ */
29
+ export declare function validateVariantArms(arms: readonly string[]): void;
30
+ /**
31
+ * Deterministically pick one arm, equal split. Threshold for arm i is
32
+ * Math.round(((i + 1) / arms.length) * 10000); the LAST arm is forced to
33
+ * 10000 so rounding can never leave bucket 9999 unassigned. Weighted arms
34
+ * are deliberately NOT supported (v1 = equal split; a weight edit would
35
+ * remap buckets and reassign re-entrants of unlimited/once_per_period
36
+ * journeys — see the impact-experiments design spec, D2).
37
+ */
38
+ export declare function pickVariant(opts: {
39
+ journeyId: string;
40
+ key: string;
41
+ userId: string;
42
+ arms: readonly string[];
43
+ }): string;
44
+ //# sourceMappingURL=variant.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"variant.d.ts","sourceRoot":"","sources":["../../src/lib/variant.ts"],"names":[],"mappings":"AAaA;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;CAChB,GAAG,MAAM,CAKT;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAQpD;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI,CAkBjE;AAED;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;CACzB,GAAG,MAAM,CAST"}