@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,33 @@
1
+ import type { HogsendClient } from "../container.js";
2
+ /**
3
+ * Boot-time first-admin bootstrap. Replaces the old web setup-token land-grab:
4
+ * with public sign-up disabled (lib/auth.ts `disableSignUp`), admins are minted
5
+ * ONLY by the CLI (DB-direct) or this in-process boot path — there is NO
6
+ * unauthenticated network path that creates a user.
7
+ *
8
+ * Contract (all conditions must hold to mint):
9
+ * - `STUDIO_ADMIN_EMAIL` is set (unset ⇒ no-op; CLI is then the only path).
10
+ * - The `user` table has ZERO rows (idempotent: never mints over an existing
11
+ * user, never rotates/re-prints anything once an admin exists).
12
+ *
13
+ * Password resolution:
14
+ * - `STUDIO_ADMIN_PASSWORD` if set (NEVER logged).
15
+ * - else an auto-generated strong password (base64url, >=16 chars) PRINTED
16
+ * ONCE to the server log — the single intended secret-logging exception,
17
+ * clearly labelled "shown once". The operator should rotate it immediately
18
+ * via the self-service forgot/reset flow (retained, revokes sessions).
19
+ *
20
+ * Concurrency: two API replicas booting on a fresh DB could both pass the
21
+ * 0-rows check; the `user.email` unique constraint makes the loser's
22
+ * `createUser` throw — caught here and treated as "already created" (no-op, no
23
+ * log of the loser's generated password). Invariant preserved: exactly one
24
+ * admin, no unauthenticated path.
25
+ *
26
+ * Never blocks boot beyond a clear fatal when an explicitly-set password is too
27
+ * weak — that validation lives in env.ts (`STUDIO_ADMIN_PASSWORD.min(8)`), so
28
+ * by the time we run the password is already known-valid or auto-generated.
29
+ */
30
+ export declare function bootstrapAdminFromEnv(opts: {
31
+ client: HogsendClient;
32
+ }): Promise<void>;
33
+ //# sourceMappingURL=bootstrap-admin.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"bootstrap-admin.d.ts","sourceRoot":"","sources":["../../src/lib/bootstrap-admin.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAGrD;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAsB,qBAAqB,CAAC,IAAI,EAAE;IAChD,MAAM,EAAE,aAAa,CAAC;CACvB,GAAG,OAAO,CAAC,IAAI,CAAC,CAsDhB"}
@@ -0,0 +1,21 @@
1
+ export interface BotPrefetchHeaders {
2
+ userAgent?: string | null;
3
+ /** `Purpose` request header (legacy Chrome/Safari prefetch). */
4
+ purpose?: string | null;
5
+ /** `X-Purpose` request header (Safari). */
6
+ xPurpose?: string | null;
7
+ /** `X-Moz` request header (Firefox prefetch — value `prefetch`). */
8
+ xMozPrefetch?: string | null;
9
+ /**
10
+ * `Sec-Purpose` request header — modern Chromium (Chrome/Edge 121+)
11
+ * Speculation-Rules prefetch/prerender, sent with a REAL browser UA. Values
12
+ * like `prefetch` or `prefetch;prerender`.
13
+ */
14
+ secPurpose?: string | null;
15
+ }
16
+ /**
17
+ * True when the request looks like an automated unfurl bot or a speculative
18
+ * prefetch/prerender rather than a real human click.
19
+ */
20
+ export declare function isBotOrPrefetch(headers: BotPrefetchHeaders): boolean;
21
+ //# sourceMappingURL=bot-prefetch.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"bot-prefetch.d.ts","sourceRoot":"","sources":["../../src/lib/bot-prefetch.ts"],"names":[],"mappings":"AAgBA,MAAM,WAAW,kBAAkB;IACjC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,gEAAgE;IAChE,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,2CAA2C;IAC3C,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,oEAAoE;IACpE,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAWpE"}
@@ -0,0 +1,75 @@
1
+ import type { HatchetClient } from "@hatchet-dev/typescript-sdk/v1/index.js";
2
+ import type { BucketMeta } from "@hogsend/core";
3
+ import type { JourneyRegistry } from "@hogsend/core/registry";
4
+ import type { Database } from "@hogsend/db";
5
+ import type { BucketLeaveReason } from "../buckets/bucket-reactions.js";
6
+ import { ingestEvent } from "./ingestion.js";
7
+ import type { Logger } from "./logger.js";
8
+ export type BucketTransitionKind = "entered" | "left" | "dwell";
9
+ /** Where a transition originated — carried on the emitted event properties. */
10
+ export type BucketTransitionSource = "event" | "reconcile" | "backfill" | "manual";
11
+ /**
12
+ * Emit a bucket transition back through `ingestEvent` (the `ctx.trigger`
13
+ * precedent) — shared by ALL three producers (real-time `checkBucketMembership`,
14
+ * the reconcile cron, and the fast-expiry timer) so they compute byte-identical
15
+ * `idempotencyKey`s for the same transition and converge to ONE emission
16
+ * (Section 6.3 worked example).
17
+ *
18
+ * Persists to `userEvents`, pushes to Hatchet (routing to journeys), and runs
19
+ * `checkExits`. Emits the per-bucket ALIAS (`bucket:<kind>:<id>`) by default; the
20
+ * generic `bucket:<kind>` is emitted ONLY when a generic-bound journey actually
21
+ * exists (aliased-only default — Section 8.5). `epoch` is the winning membership
22
+ * row's `entryCount`, read off the single winning mutation by the caller.
23
+ */
24
+ export declare function emitBucketTransition(opts: {
25
+ db: Database;
26
+ /** The JOURNEY registry — forwarded into the recursive emit ingestEvent. */
27
+ registry: JourneyRegistry;
28
+ hatchet: HatchetClient;
29
+ logger: Logger;
30
+ kind: BucketTransitionKind;
31
+ bucket: BucketMeta;
32
+ userId: string;
33
+ userEmail: string | null;
34
+ /**
35
+ * The subject contact's resolved row id (`contacts.id`) — the ENGINE-INTERNAL
36
+ * provenance pin, threaded into BOTH re-ingests below. `userId` here is the
37
+ * contact's CANONICAL key (`external_id ?? anonymous_id ?? id`), but the
38
+ * resolver treats a bare `userId` as an EXTERNAL key and never probes
39
+ * `anonymous_id` — so without the pin an anonymous-only contact gets a
40
+ * phantom `external_id` twin minted on every transition (issue #608).
41
+ * OPTIONAL: a producer that has no resolved contact row in scope degrades to
42
+ * the pin-less resolve (exactly the pre-pin behaviour).
43
+ */
44
+ contactId?: string;
45
+ /**
46
+ * D1 creation guard for BOTH re-ingests below, inherited from the originating
47
+ * ingest via `checkBucketMembership`. `false` ⇒ the transition event stores
48
+ * and routes exactly as always, but mints no `contacts` row. This is the
49
+ * ONLY correct behavior when the producer has no `contactId` to pin with:
50
+ * degrading the pin instead would make the resolver read this transition's
51
+ * `userId` (the subject's canonical key, often its `anonymous_id`) as an
52
+ * EXTERNAL key and mint a phantom `external_id` twin (issue #608). Producers
53
+ * that legitimately create (the reconcile cron, backfill) leave it unset.
54
+ */
55
+ allowCreate?: boolean;
56
+ epoch: number;
57
+ source?: BucketTransitionSource;
58
+ /** Carried on a `left` transition's properties → `ctx.reason`. */
59
+ reason?: BucketLeaveReason;
60
+ /** The dwell schedule label (`after-<ms>`/`every-<ms>`) — `dwell` only. */
61
+ dwellLabel?: string;
62
+ /**
63
+ * The deterministic dwell interval ordinal — `dwell` only. Rides the
64
+ * idempotencyKey so a same-sweep retry recomputes the identical key and is
65
+ * absorbed by the `userEvents` dedup. Surfaced as `dwellCount`.
66
+ */
67
+ dwellOrdinal?: number;
68
+ /**
69
+ * Testing seam — the re-ingest fn (defaults to the real `ingestEvent`), so a
70
+ * unit test can assert the provenance pin rides BOTH re-ingests without a
71
+ * live database (the Section 14 pattern `checkBucketMembership` uses).
72
+ */
73
+ ingest?: typeof ingestEvent;
74
+ }): Promise<void>;
75
+ //# sourceMappingURL=bucket-emit.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"bucket-emit.d.ts","sourceRoot":"","sources":["../../src/lib/bucket-emit.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yCAAyC,CAAC;AAC7E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AAExE,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAG1C,MAAM,MAAM,oBAAoB,GAAG,SAAS,GAAG,MAAM,GAAG,OAAO,CAAC;AAEhE,+EAA+E;AAC/E,MAAM,MAAM,sBAAsB,GAC9B,OAAO,GACP,WAAW,GACX,UAAU,GACV,QAAQ,CAAC;AAEb;;;;;;;;;;;;GAYG;AACH,wBAAsB,oBAAoB,CAAC,IAAI,EAAE;IAC/C,EAAE,EAAE,QAAQ,CAAC;IACb,4EAA4E;IAC5E,QAAQ,EAAE,eAAe,CAAC;IAC1B,OAAO,EAAE,aAAa,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,oBAAoB,CAAC;IAC3B,MAAM,EAAE,UAAU,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB;;;;;;;;;OASG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;;;;;;OASG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,sBAAsB,CAAC;IAChC,kEAAkE;IAClE,MAAM,CAAC,EAAE,iBAAiB,CAAC;IAC3B,2EAA2E;IAC3E,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;;OAIG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;;OAIG;IACH,MAAM,CAAC,EAAE,OAAO,WAAW,CAAC;CAC7B,GAAG,OAAO,CAAC,IAAI,CAAC,CA2JhB"}
@@ -0,0 +1,29 @@
1
+ import type { BucketMeta } from "@hogsend/core";
2
+ import type { Logger } from "./logger.js";
3
+ /**
4
+ * Optional PostHog person-property mirror for a bucket transition (Section 12).
5
+ *
6
+ * OFF BY DEFAULT — a no-op unless `meta.syncToPostHog === true`. Also a no-op
7
+ * without `POSTHOG_API_KEY` (the injected analytics is undefined), so self-host
8
+ * setups that omit PostHog silently do nothing — documented, not broken.
9
+ *
10
+ * On JOIN it `$set`s a boolean person property `true`; on LEAVE it `$unset`s the
11
+ * same key. `$unset` (NOT `$set false`) is the recommended default: a cohort
12
+ * `key = true` excludes a false value, but a cohort `key is set` STILL matches a
13
+ * false value, so `$unset` is the only form where both cohort idioms behave
14
+ * correctly. The property key defaults to `hogsend_bucket_<id>`, overridable via
15
+ * `meta.postHogPropertyKey`.
16
+ *
17
+ * This reuses the existing `plugin-posthog` capture path (the same one
18
+ * `identify()` uses at journey-context.ts) — it adds no new integration surface
19
+ * and never pushes to any non-PostHog destination (the Section 2.4 anti-CDP
20
+ * invariant). Best-effort: a capture failure is logged and swallowed so a sync
21
+ * error never blocks a transition emit.
22
+ */
23
+ export declare function syncBucketToPostHog(opts: {
24
+ logger: Logger;
25
+ kind: "entered" | "left";
26
+ bucket: BucketMeta;
27
+ userId: string;
28
+ }): void;
29
+ //# sourceMappingURL=bucket-posthog-sync.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"bucket-posthog-sync.d.ts","sourceRoot":"","sources":["../../src/lib/bucket-posthog-sync.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAEhD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAE1C;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE;IACxC,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,SAAS,GAAG,MAAM,CAAC;IACzB,MAAM,EAAE,UAAU,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;CAChB,GAAG,IAAI,CAqCP"}
@@ -0,0 +1,31 @@
1
+ /**
2
+ * The deterministic per-recipient idempotency key a campaign send writes to
3
+ * `email_sends.idempotency_key`. The key exists for DEDUP; campaign
4
+ * attribution is the `email_sends.campaign_id` column (stamped on every
5
+ * campaign-dispatched row including suppressed sends, which write no key at
6
+ * all; legacy rows backfilled by migration 0051). The one thing the key
7
+ * still uniquely carries is the STEP NUMBER of a multi-step campaign, which
8
+ * is why the per-step stats breakdown matches `campaignStepSendKeyPattern`
9
+ * (scoped to the campaign_id FK first).
10
+ *
11
+ * Two formats, chosen by the campaign's step count (NOT per call site):
12
+ *
13
+ * - Single-step campaigns (steps.length === 1 or a NULL steps blob) ALWAYS
14
+ * use the legacy `campaign:<id>:<email>` — behavior and any in-flight
15
+ * campaign at deploy time are byte-for-byte unchanged.
16
+ * - Multi-step campaigns use `campaign:<id>:<step>:<email>` for ALL steps
17
+ * including 0. No ambiguity with the legacy format is possible (no
18
+ * multi-step campaign exists before this ships), and per-step stats
19
+ * filter on the step-scoped pattern.
20
+ *
21
+ * The key deliberately excludes any timezone bucket (phase 3): same
22
+ * recipient + same step = same key, always.
23
+ */
24
+ export declare function campaignSendKey(campaignId: string, email: string, step?: number): string;
25
+ /**
26
+ * SQL LIKE pattern matching every send of ONE step of a multi-step campaign
27
+ * (`campaign:<id>:<step>:%`). Meaningless against legacy single-step keys —
28
+ * callers only use it on campaigns with a steps blob.
29
+ */
30
+ export declare function campaignStepSendKeyPattern(campaignId: string, step: number): string;
31
+ //# sourceMappingURL=campaign-send-key.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"campaign-send-key.d.ts","sourceRoot":"","sources":["../../src/lib/campaign-send-key.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,eAAe,CAC7B,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,MAAM,EACb,IAAI,CAAC,EAAE,MAAM,GACZ,MAAM,CAIR;AAOD;;;;GAIG;AACH,wBAAgB,0BAA0B,CACxC,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,GACX,MAAM,CAER"}
@@ -0,0 +1,83 @@
1
+ import { type Database } from "@hogsend/db";
2
+ import type { ConnectorActionSkipped, DefinedConnectorAction, ResolvedActionContact } from "../connectors/define-action.js";
3
+ /**
4
+ * Preference gate for a member-directed outbound action. Returns a
5
+ * {@link ConnectorActionSkipped} verdict when the resolved recipient has opted
6
+ * out, or `null` when the send is allowed.
7
+ *
8
+ * Gating rules:
9
+ * - An action WITHOUT a member audience (`audience?.kind !== "member"`) is
10
+ * ops/channel-directed (grantRole, broadcast, mentions, channel messages) and
11
+ * is NEVER gated — returns null immediately.
12
+ * - The audience extractor is run inside a try/catch: a THROWING extractor
13
+ * FAILS OPEN (`logger.warn` + null) — a bad extractor must never brick a
14
+ * journey that works today.
15
+ * - Candidate refs are tried in order; the FIRST that resolves a live contact
16
+ * wins. A candidate that resolves NO contact (a raw snowflake, a group-chat
17
+ * id, an unlinked ref) means there is NO preference surface to consult — the
18
+ * send is ALLOWED (null). Only once a contact is resolved do preferences gate.
19
+ * - On a resolved contact the COLD-CHANNEL GATE runs first: when the
20
+ * contact's `source` names a registered Contact Source (⇒ a cold prospect),
21
+ * the source's resolved {@link ColdPosture} must allow this connector's
22
+ * channel or the action skips with `cold_channel_blocked` (logged once at
23
+ * info with the source id + blocked channel). Null/unregistered `source` ⇒
24
+ * not a prospect ⇒ unaffected; a throwing posture lookup fails OPEN.
25
+ * - On a resolved contact we read the aggregated {@link readRecipientPreferences}
26
+ * keyed by its email + `externalId ?? id` (the SAME key form preference writes
27
+ * use), then: `unsubscribedAll` → skip `unsubscribed_all`; else channel
28
+ * opt-out (`!getListRegistry().isSubscribed(categories, connectorId)`) → skip
29
+ * `channel_unsubscribed`; else null.
30
+ *
31
+ * Deliberately does NOT consume `prefs.suppressed` — that is an email-transport
32
+ * hard-bounce/complaint signal, irrelevant to a chat channel.
33
+ *
34
+ * Exported ONLY for unit tests (the engine suite is pure/unit and cannot drive
35
+ * the DB-backed `sendConnectorAction` path) — production callers go through
36
+ * {@link sendConnectorAction}, which runs this gate INSIDE the durable memo
37
+ * closure so the verdict replays verbatim.
38
+ */
39
+ export declare function checkActionAudience(db: Database, resolveCachedContact: (ref: string) => Promise<ResolvedActionContact | null>, action: DefinedConnectorAction, connectorId: string, actionName: string, args: unknown): Promise<ConnectorActionSkipped | null>;
40
+ export interface SendConnectorActionArgs {
41
+ /** The connector the action belongs to (e.g. "discord"). */
42
+ connectorId: string;
43
+ /** The action name (e.g. "sendChannelMessage"). */
44
+ action: string;
45
+ /** The action's own args object (shape defined by the action). */
46
+ args?: unknown;
47
+ /**
48
+ * Disambiguates the exactly-once dedupe key when the SAME action is sent more
49
+ * than once in one journey run. The action's `args` are NOT part of the
50
+ * derived key, so two genuinely-distinct sends of the same action within one
51
+ * run — without an intervening `ctx.sleep`/`waitForEvent`/`checkpoint` to
52
+ * advance the nearest label — would otherwise derive an IDENTICAL key and the
53
+ * second would fail-fast via `registerKey`. Pass a distinct label per call
54
+ * (e.g. broadcasting the same message to two channels back-to-back). Mirrors
55
+ * `idempotencyLabel` on `sendEmail()` and `ctx.trigger()`. Additive and
56
+ * optional.
57
+ */
58
+ idempotencyLabel?: string;
59
+ }
60
+ /**
61
+ * Invoke a registered connector outbound action from a journey/workflow. The
62
+ * standalone, socket-free counterpart to `sendEmail()` — single-object-in,
63
+ * result-out, NOT on `JourneyContext` (features are standalone imports). Throws
64
+ * when the action isn't registered (wire it via
65
+ * `createHogsendClient({ connectorActions })`).
66
+ *
67
+ * Independent of any inbound gateway runtime: a deployment with the gateway off
68
+ * (or "Worker Offline") can still send — Discord actions are bot-REST needing
69
+ * only the bot token.
70
+ *
71
+ * MEMBER-DIRECTED actions (those declaring `audience: { kind: "member" }`) are
72
+ * automatically gated on the recipient's channel preferences BEFORE the plugin
73
+ * runs: a resolved contact who unsubscribed globally or opted out of the
74
+ * connector's channel list yields a {@link ConnectorActionSkipped} verdict
75
+ * INSTEAD of a send, and no `connector_deliveries` row is claimed. The gate runs
76
+ * INSIDE the durable memo closure, so its verdict is recorded and replays
77
+ * verbatim (THE LAW: the key derivation, `registerKey`, and the `memoize` call
78
+ * itself stay unconditional). Skips are observable via logs + the returned
79
+ * verdict only — an audit ledger is a future additive migration. Ops/channel-
80
+ * directed actions (no audience) are never gated.
81
+ */
82
+ export declare function sendConnectorAction(input: SendConnectorActionArgs): Promise<unknown>;
83
+ //# sourceMappingURL=connector-actions.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"connector-actions.d.ts","sourceRoot":"","sources":["../../src/lib/connector-actions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiC,KAAK,QAAQ,EAAE,MAAM,aAAa,CAAC;AAG3E,OAAO,KAAK,EACV,sBAAsB,EACtB,sBAAsB,EACtB,qBAAqB,EACtB,MAAM,gCAAgC,CAAC;AA8GxC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,wBAAsB,mBAAmB,CACvC,EAAE,EAAE,QAAQ,EACZ,oBAAoB,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,qBAAqB,GAAG,IAAI,CAAC,EAC5E,MAAM,EAAE,sBAAsB,EAC9B,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,OAAO,GACZ,OAAO,CAAC,sBAAsB,GAAG,IAAI,CAAC,CA2FxC;AAED,MAAM,WAAW,uBAAuB;IACtC,4DAA4D;IAC5D,WAAW,EAAE,MAAM,CAAC;IACpB,mDAAmD;IACnD,MAAM,EAAE,MAAM,CAAC;IACf,kEAAkE;IAClE,IAAI,CAAC,EAAE,OAAO,CAAC;IACf;;;;;;;;;;OAUG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAsB,mBAAmB,CACvC,KAAK,EAAE,uBAAuB,GAC7B,OAAO,CAAC,OAAO,CAAC,CAiJlB"}
@@ -0,0 +1,35 @@
1
+ import type { Logger } from "./logger.js";
2
+ export interface ConnectorHeartbeat {
3
+ /** True when a fresh runtime heartbeat is present in Redis. */
4
+ alive: boolean;
5
+ /** ISO timestamp the runtime last wrote, when alive. */
6
+ lastSeenAt?: string;
7
+ /** Opaque platform metadata the runtime folded in (e.g. guildId, intents). */
8
+ metadata?: Record<string, unknown>;
9
+ }
10
+ export interface ConnectorHeartbeatState {
11
+ /**
12
+ * Merge a metadata patch (read-merge-write) and flush immediately, so Studio
13
+ * reflects a late-observed field (e.g. the guild id seen at GUILD_CREATE)
14
+ * without waiting for the next refresh tick.
15
+ */
16
+ setMetadata(patch: Record<string, unknown>): void;
17
+ }
18
+ export interface ConnectorHeartbeatHandle {
19
+ state: ConnectorHeartbeatState;
20
+ /** Clear the timer and delete the key for an immediate "down" on demotion. */
21
+ stop(): Promise<void>;
22
+ }
23
+ /**
24
+ * Begin writing a connector-runtime heartbeat. Writes once immediately, then
25
+ * refreshes every {@link REFRESH_MS} with a {@link TTL_SECONDS} expiry — so an
26
+ * ungraceful death (or a lost lease) is reflected as "down" within the TTL.
27
+ */
28
+ export declare function startConnectorHeartbeat(connectorId: string, logger: Logger): ConnectorHeartbeatHandle;
29
+ /**
30
+ * Read a connector-runtime heartbeat. Resolves to `{ alive: false }` when the
31
+ * key is missing or Redis is unreachable. For `connectorId === "discord"`, falls
32
+ * back to the legacy standalone-worker key so a mid-rollout deploy stays green.
33
+ */
34
+ export declare function getConnectorHeartbeat(connectorId: string): Promise<ConnectorHeartbeat>;
35
+ //# sourceMappingURL=connector-heartbeat.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"connector-heartbeat.d.ts","sourceRoot":"","sources":["../../src/lib/connector-heartbeat.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAiC1C,MAAM,WAAW,kBAAkB;IACjC,+DAA+D;IAC/D,KAAK,EAAE,OAAO,CAAC;IACf,wDAAwD;IACxD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,8EAA8E;IAC9E,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAQD,MAAM,WAAW,uBAAuB;IACtC;;;;OAIG;IACH,WAAW,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;CACnD;AAED,MAAM,WAAW,wBAAwB;IACvC,KAAK,EAAE,uBAAuB,CAAC;IAC/B,8EAA8E;IAC9E,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACvB;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CACrC,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,GACb,wBAAwB,CA4C1B;AAyCD;;;;GAIG;AACH,wBAAsB,qBAAqB,CACzC,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,kBAAkB,CAAC,CAa7B"}
@@ -0,0 +1,105 @@
1
+ import { type Database } from "@hogsend/db";
2
+ /**
3
+ * Single-use verification codes for the native in-connector identify loop
4
+ * (Discord `/link <email>` → emailed code → `/verify <code>`).
5
+ *
6
+ * Security posture (all four hold simultaneously — the 6-digit code's small
7
+ * keyspace is acceptable ONLY because of this stack):
8
+ * - SINGLE-USE — redeem is an atomic `UPDATE … SET used_at WHERE used_at IS
9
+ * NULL RETURNING`; a second redeem of the same code affects zero rows.
10
+ * - TTL'd — `expires_at` is checked on redeem; an aged code is rejected.
11
+ * - IDENTITY-BOUND — the code is bound to the invoking platform user at mint
12
+ * and re-checked at redeem with a CONSTANT-TIME compare; a code minted for
13
+ * one account can never be redeemed by another.
14
+ * - HASHED-AT-REST — only `sha256(code)` is stored; the plaintext code lives
15
+ * only in the member's inbox, so a DB read never yields a redeemable code.
16
+ * - THROTTLED — the anti-email-bomb throttle counts mints in a rolling window.
17
+ * The per-USER cap ({@link LINK_CODE_MAX_PER_USER}) is the PRIMARY backstop:
18
+ * it caps how many codes ONE Discord account can trigger regardless of
19
+ * address. The per-EMAIL cap ({@link LINK_CODE_MAX_PER_EMAIL}) is a
20
+ * SECONDARY, BEST-EFFORT speed bump — `+tag`/dot aliasing sidesteps it
21
+ * (`a@x.com`, `a+1@x.com`, `a.@x.com` normalize to DISTINCT `targetEmail`
22
+ * buckets under `trim().toLowerCase()`, which does NOT canonicalize
23
+ * Gmail-style aliases; canonicalizing is out of scope). Either cap, when hit,
24
+ * refuses to mint+send.
25
+ */
26
+ /** How long a minted code is valid before `/verify` (15 minutes). */
27
+ export declare const LINK_CODE_TTL_SECONDS = 900;
28
+ /** Rolling window (seconds) the anti-email-bomb throttle counts mints over. */
29
+ export declare const LINK_CODE_THROTTLE_WINDOW_SECONDS = 900;
30
+ /** Max codes one invoking platform user may mint per throttle window. */
31
+ export declare const LINK_CODE_MAX_PER_USER = 5;
32
+ /** Max codes that may be minted FOR one target email per throttle window. */
33
+ export declare const LINK_CODE_MAX_PER_EMAIL = 3;
34
+ /** sha256 of the plaintext code, lowercase hex — the at-rest lookup key. */
35
+ export declare function hashLinkCode(code: string): string;
36
+ /**
37
+ * A 6-digit, human-typable, zero-padded code drawn from a CSPRNG. Entropy is
38
+ * intentionally low (≈20 bits) — the security comes from single-use + TTL +
39
+ * identity-binding + throttling, NOT from the code being hard to guess (a
40
+ * guesser must hit a code minted FOR THEIR OWN platform id in a 15-min window,
41
+ * which is self-targeting and pointless). 6 digits is the universal
42
+ * "verification code" UX, trivial to type on mobile.
43
+ */
44
+ export declare function generateLinkCode(): string;
45
+ /** Why a `/link` mint was refused. */
46
+ export type LinkCodeThrottleScope = "platformUser" | "email";
47
+ export type CreateLinkCodeResult = {
48
+ ok: true;
49
+ code: string;
50
+ } | {
51
+ ok: false;
52
+ reason: "throttled";
53
+ scope: LinkCodeThrottleScope;
54
+ };
55
+ /**
56
+ * Mint a single-use link code, enforcing the anti-email-bomb throttle FIRST.
57
+ *
58
+ * The throttle counts rows already minted for this connector in the rolling
59
+ * window — per invoking `platformUserId` (≤ {@link LINK_CODE_MAX_PER_USER}) AND
60
+ * per target `email` (≤ {@link LINK_CODE_MAX_PER_EMAIL}) — and refuses to mint
61
+ * (so nothing is emailed) when either cap is already met. Counting on MINT and
62
+ * never freeing on redeem/expiry is the email-bomb control. On success the row
63
+ * stores ONLY the sha256 hash and returns the plaintext `code` for the caller
64
+ * to email.
65
+ *
66
+ * NOTE: a DB failure throws — callers MUST treat that as a hard failure and
67
+ * NOT fall through to sending an email (an unthrottled send would defeat the
68
+ * email-bomb control).
69
+ */
70
+ export declare function createLinkCode(opts: {
71
+ db: Database;
72
+ connectorId: string;
73
+ platformUserId: string;
74
+ email: string;
75
+ ttlSeconds?: number;
76
+ maxPerUser?: number;
77
+ maxPerEmail?: number;
78
+ windowSeconds?: number;
79
+ }): Promise<CreateLinkCodeResult>;
80
+ export type RedeemLinkCodeResult = {
81
+ ok: true;
82
+ email: string;
83
+ } | {
84
+ ok: false;
85
+ reason: "invalid" | "expired" | "used" | "wrong_user";
86
+ };
87
+ /**
88
+ * Redeem a typed code for the bound email — single-use, TTL-enforced, and
89
+ * identity-bound to the invoking platform user.
90
+ *
91
+ * Resolution is by `sha256(code)` (the plaintext is never stored). A missing
92
+ * row → `invalid`. A row whose `platformUserId` does not match the caller
93
+ * (CONSTANT-TIME compared so a redeem can't probe other accounts' codes) →
94
+ * `wrong_user`. An expired row → `expired`. Single-use is the atomic
95
+ * `UPDATE … SET used_at = now() WHERE id = ? AND used_at IS NULL RETURNING`:
96
+ * the FIRST redeem wins and every later one sees zero affected rows → `used`
97
+ * (this also closes the read-then-write race two concurrent `/verify`s create).
98
+ */
99
+ export declare function redeemLinkCode(opts: {
100
+ db: Database;
101
+ connectorId: string;
102
+ platformUserId: string;
103
+ code: string;
104
+ }): Promise<RedeemLinkCodeResult>;
105
+ //# sourceMappingURL=connector-link-codes.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"connector-link-codes.d.ts","sourceRoot":"","sources":["../../src/lib/connector-link-codes.ts"],"names":[],"mappings":"AACA,OAAO,EAAsB,KAAK,QAAQ,EAAE,MAAM,aAAa,CAAC;AAIhE;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,qEAAqE;AACrE,eAAO,MAAM,qBAAqB,MAAM,CAAC;AAEzC,+EAA+E;AAC/E,eAAO,MAAM,iCAAiC,MAAM,CAAC;AAErD,yEAAyE;AACzE,eAAO,MAAM,sBAAsB,IAAI,CAAC;AAExC,6EAA6E;AAC7E,eAAO,MAAM,uBAAuB,IAAI,CAAC;AAEzC,4EAA4E;AAC5E,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEjD;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,CAEzC;AAED,sCAAsC;AACtC,MAAM,MAAM,qBAAqB,GAAG,cAAc,GAAG,OAAO,CAAC;AAE7D,MAAM,MAAM,oBAAoB,GAC5B;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC1B;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,WAAW,CAAC;IAAC,KAAK,EAAE,qBAAqB,CAAA;CAAE,CAAC;AAErE;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,cAAc,CAAC,IAAI,EAAE;IACzC,EAAE,EAAE,QAAQ,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CA0DhC;AAED,MAAM,MAAM,oBAAoB,GAC5B;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAC3B;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,MAAM,GAAG,YAAY,CAAA;CAAE,CAAC;AAEzE;;;;;;;;;;;GAWG;AACH,wBAAsB,cAAc,CAAC,IAAI,EAAE;IACzC,EAAE,EAAE,QAAQ,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;CACd,GAAG,OAAO,CAAC,oBAAoB,CAAC,CA8ChC"}
@@ -0,0 +1,97 @@
1
+ /**
2
+ * Engine-owned, GENERIC signed connector state — the CSRF/binding token carried
3
+ * on a connector OAuth `state` query param. The connector OAuth callback lands
4
+ * UNAUTHENTICATED (it is a public redirect target), so every connect/authorize
5
+ * URL must carry a server-minted, server-verified `state`:
6
+ *
7
+ * - `purpose: "install"` — CSRF only (a one-click bot/app install). No contact
8
+ * is bound; the callback just proves the redirect was initiated by us.
9
+ * - `purpose: "member_link"` — binds the EXACT contact/email the per-member
10
+ * link was issued for, so the callback attaches the platform identity to THAT
11
+ * contact (never to whatever email the platform happens to report — the
12
+ * grafting/account-takeover vector).
13
+ * - `purpose: "account_link"` — binds ONE account-link attempt
14
+ * (`/v1/accounts/:provider/start` → `/callback`, PRD 07) to the provider it
15
+ * was minted for (`providerId`) and to the contact side it may attach to:
16
+ * either a sealed `contactId` (the WARM binding, authoritative — the
17
+ * provider-reported email is NEVER a resolution key) or an `anonymousId`
18
+ * (the COLD binding, which may attach only to an anonymous-only contact,
19
+ * DECISIONS §6.10). It also carries the already-allowlist-checked
20
+ * `returnTo`, re-checked at redirect time.
21
+ *
22
+ * The token is `base64url(JSON(payload)).base64url(HMAC-SHA256(payloadB64))`,
23
+ * signed with the engine's `BETTER_AUTH_SECRET`. The same hardened constant-time
24
+ * compare the connector ingress uses ({@link safeEqual}) guards verification.
25
+ *
26
+ * REPLAY: the token is single-use WHEN a nonce store is available — the OAuth
27
+ * callback burns the per-mint `nonce` on first use (a `SET … NX` in Redis), so a
28
+ * captured callback URL cannot be replayed. Without Redis (self-host without it,
29
+ * tests) it degrades to TTL-bounded validity: the signature + `exp` still gate
30
+ * it, but the same token works until expiry. The mint TTL is the replay window.
31
+ */
32
+ export interface ConnectorStateIntent {
33
+ purpose: "install" | "member_link" | "account_link";
34
+ /**
35
+ * Connector flows only (`install` / `member_link`). OPTIONAL now that
36
+ * `account_link` exists — an account-link state binds `providerId` instead.
37
+ */
38
+ connectorId?: string;
39
+ /**
40
+ * `account_link` only — the `AccountLinkProvider` `meta.id` this state was
41
+ * minted for.
42
+ *
43
+ * A NEW field, deliberately NOT a reuse of {@link connectorId}: one secret
44
+ * signs every state in the process, so a state minted for one surface is
45
+ * signature-valid on the other, and a future connector id colliding with an
46
+ * account-link provider id (both `"discord"`, say) would make the two
47
+ * indistinguishable. Two fields cannot be confused. The connector callback's
48
+ * `intent.connectorId !== id` check already rejects an account-link state
49
+ * incidentally (`undefined !== id`), and it also states the rule explicitly
50
+ * with a purpose allowlist.
51
+ */
52
+ providerId?: string;
53
+ /**
54
+ * `member_link`, and `account_link`'s WARM binding — the bound contact id.
55
+ * AUTHORITATIVE: the callback attaches to THIS contact and never to whatever
56
+ * email the platform reports (DECISIONS §6.3).
57
+ */
58
+ contactId?: string;
59
+ /** Member-link only — the bound contact email (authoritative resolution key). */
60
+ email?: string;
61
+ /**
62
+ * `account_link` COLD binding only — the browser anonymous key the link
63
+ * attaches to. It is browser-readable by design, so a cold link may attach
64
+ * ONLY to an anonymous-only contact and may never displace a live owner
65
+ * (DECISIONS §6.10). Exactly one of {@link contactId} / `anonymousId` is set
66
+ * on an account-link state.
67
+ */
68
+ anonymousId?: string;
69
+ /**
70
+ * `account_link` only — where to send the player after a completed link.
71
+ * Allowlist-checked at MINT time AND re-checked at redirect time, because
72
+ * the allowlist can change between the two (and a signed state outlives a
73
+ * config edit).
74
+ */
75
+ returnTo?: string;
76
+ /**
77
+ * High-entropy per-mint value so two states are never byte-identical AND so
78
+ * the callback can burn it for single-use replay protection (see header).
79
+ */
80
+ nonce: string;
81
+ }
82
+ /**
83
+ * Mint a signed connector-state token from an intent. `Date.now()` is fine here
84
+ * — this is engine RUNTIME code (route handlers), not a journey workflow script.
85
+ */
86
+ export declare function signConnectorState(intent: ConnectorStateIntent, secret: string, ttlSeconds: number): string;
87
+ /**
88
+ * Verify a signed connector-state token. Recomputes the HMAC, constant-time
89
+ * compares it, then enforces expiry. Returns `{ valid: false, reason }` on ANY
90
+ * malformed/bad/expired input — NEVER throws.
91
+ */
92
+ export declare function verifyConnectorState(token: string, secret: string): {
93
+ valid: boolean;
94
+ intent?: ConnectorStateIntent;
95
+ reason?: string;
96
+ };
97
+ //# sourceMappingURL=connector-state.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"connector-state.d.ts","sourceRoot":"","sources":["../../src/lib/connector-state.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,SAAS,GAAG,aAAa,GAAG,cAAc,CAAC;IACpD;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;;;;;;;;;OAYG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,iFAAiF;IACjF,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;;;;OAMG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,KAAK,EAAE,MAAM,CAAC;CACf;AAeD;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,oBAAoB,EAC5B,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,GACjB,MAAM,CAQR;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,GACb;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,oBAAoB,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CAkCpE"}