@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
package/README.md CHANGED
@@ -28,5 +28,6 @@ for the committed API surface and
28
28
  [RELEASING.md](https://github.com/dougwithseismic/hogsend/blob/main/docs/RELEASING.md)
29
29
  for semver discipline.
30
30
 
31
- This package ships raw TypeScript source; consumers bundle it via their own build
32
- (tsup `noExternal`).
31
+ This package ships raw TypeScript source as its runtime entry; consumers bundle
32
+ it via their own build (tsup `noExternal`). Types resolve from emitted
33
+ declarations in `dist/`, so your `tsc` checks your code, not the engine's.
@@ -0,0 +1,38 @@
1
+ /**
2
+ * Deterministic in-process `fetch` for the account-link test suites.
3
+ *
4
+ * The injection point is PRD 01's `HandleCallbackArgs.fetchImpl` (resolved as
5
+ * `fetchImpl ?? globalThis.fetch` inside the presets) — the same pattern
6
+ * `plugin-apollo` proved (`packages/plugin-apollo/src/index.ts:46-47`, "the
7
+ * whole suite runs offline through this"). The engine providers therefore need
8
+ * no `fetch` field of their own, and PRD 07's route tests thread the same
9
+ * `fetchImpl` through.
10
+ *
11
+ * Routes key on `method + " " + url-without-query`, so a test asserts query
12
+ * params off `calls` rather than baking them into the key. An unmatched call
13
+ * THROWS with the full URL, so a provider that quietly reaches an unexpected
14
+ * endpoint fails loudly instead of hanging on a real network call.
15
+ */
16
+ export interface FakeFetchRoute {
17
+ /** Response status. Default 200. */
18
+ status?: number;
19
+ /** JSON body — serialized with `JSON.stringify`, `content-type: application/json`. */
20
+ body?: unknown;
21
+ /**
22
+ * Plain-text body (`content-type: text/plain`) — Steam's
23
+ * `check_authentication` answers key-value text, not JSON. Wins over `body`
24
+ * when both are set.
25
+ */
26
+ text?: string;
27
+ }
28
+ export interface FakeFetchCall {
29
+ url: string;
30
+ method: string;
31
+ headers: Record<string, string>;
32
+ body: string | null;
33
+ }
34
+ export declare function fakeFetch(routes: Record<string, FakeFetchRoute>): {
35
+ fetchImpl: typeof fetch;
36
+ calls: FakeFetchCall[];
37
+ };
38
+ //# sourceMappingURL=fake-fetch.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"fake-fetch.d.ts","sourceRoot":"","sources":["../../../src/account-links/__fixtures__/fake-fetch.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,MAAM,WAAW,cAAc;IAC7B,oCAAoC;IACpC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,sFAAsF;IACtF,IAAI,CAAC,EAAE,OAAO,CAAC;IACf;;;;OAIG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CACrB;AAyBD,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,GAAG;IACjE,SAAS,EAAE,OAAO,KAAK,CAAC;IACxB,KAAK,EAAE,aAAa,EAAE,CAAC;CACxB,CAmDA"}
@@ -0,0 +1,36 @@
1
+ import { type AccountLinkProvider, type LinkedIdentity } from "@hogsend/core";
2
+ /**
3
+ * Battle.net app credentials, from an application registered at
4
+ * `https://develop.battle.net/access/clients` with OAuth redirect URL
5
+ * `<API_PUBLIC_URL>/v1/accounts/battlenet/callback`. Env spelling:
6
+ * `ACCOUNT_LINK_BATTLENET_CLIENT_ID` / `ACCOUNT_LINK_BATTLENET_CLIENT_SECRET`
7
+ * (see `lib/account-links-from-env.ts` — registered only when BOTH are set).
8
+ */
9
+ export interface BattlenetAccountLinkConfig {
10
+ clientId: string;
11
+ clientSecret: string;
12
+ }
13
+ /**
14
+ * Map a Battle.net `/oauth/userinfo` response onto a {@link LinkedIdentity}.
15
+ * Exported for direct unit testing — it is the only real logic in this file.
16
+ *
17
+ * - `providerUserId` is the `sub` claim, the IMMUTABLE key. Never `battletag`:
18
+ * it is user-editable, so keying on it lets a player rename themselves onto
19
+ * another player's link row.
20
+ * - `battletag` is a display name and lands in `username`, NOT `verifiedEmail`:
21
+ * the userinfo endpoint exposes no email verification info.
22
+ */
23
+ export declare function mapBattlenetUser(json: unknown): Omit<LinkedIdentity, "tokens">;
24
+ /**
25
+ * The Battle.net account-link provider: pure CONFIG over the `oauth2Link()`
26
+ * preset (OAuth2 authorization code + PKCE, tokens sealed). All protocol
27
+ * mechanics — authorize URL, token exchange, `error=access_denied` mapping,
28
+ * the userinfo fetch — live in the preset
29
+ * (`@hogsend/core`, `providers/account-link-presets.ts`), not here.
30
+ *
31
+ * Battle.net has no standard token revocation endpoint, so `revokeEndpoint`
32
+ * is omitted — unlinking destroys the stored tokens without calling the
33
+ * provider.
34
+ */
35
+ export declare function battlenetAccountLink(config: BattlenetAccountLinkConfig): AccountLinkProvider;
36
+ //# sourceMappingURL=battlenet.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"battlenet.d.ts","sourceRoot":"","sources":["../../src/account-links/battlenet.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,mBAAmB,EACxB,KAAK,cAAc,EAEpB,MAAM,eAAe,CAAC;AAEvB;;;;;;GAMG;AACH,MAAM,WAAW,0BAA0B;IACzC,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;CACtB;AAQD;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,OAAO,GACZ,IAAI,CAAC,cAAc,EAAE,QAAQ,CAAC,CAYhC;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,0BAA0B,GACjC,mBAAmB,CAmBrB"}
@@ -0,0 +1,36 @@
1
+ import { type AccountLinkProvider, type LinkedIdentity } from "@hogsend/core";
2
+ /**
3
+ * Epic Games app credentials, from an application registered at
4
+ * `https://dev.epicgames.com/portal` with OAuth redirect URL
5
+ * `<API_PUBLIC_URL>/v1/accounts/epic/callback`. Env spelling:
6
+ * `ACCOUNT_LINK_EPIC_CLIENT_ID` / `ACCOUNT_LINK_EPIC_CLIENT_SECRET`
7
+ * (see `lib/account-links-from-env.ts` — registered only when BOTH are set).
8
+ */
9
+ export interface EpicAccountLinkConfig {
10
+ clientId: string;
11
+ clientSecret: string;
12
+ }
13
+ /**
14
+ * Map an Epic `GET /oauth/verify` response onto a {@link LinkedIdentity}.
15
+ * Exported for direct unit testing — it is the only real logic in this file.
16
+ *
17
+ * - `providerUserId` is Epic's `accountId`, the IMMUTABLE key. Never
18
+ * `displayName`: it is user-editable, so keying on it lets a player rename
19
+ * themselves onto another player's link row.
20
+ * - Epic's verify endpoint returns camelCase (`accountId`, `displayName`) but
21
+ * we defensively check snake_case variants too.
22
+ */
23
+ export declare function mapEpicUser(json: unknown): Omit<LinkedIdentity, "tokens">;
24
+ /**
25
+ * The Epic Games account-link provider: pure CONFIG over the `oauth2Link()`
26
+ * preset (OAuth2 authorization code, tokens sealed). All protocol mechanics
27
+ * — authorize URL, token exchange, `error=access_denied` mapping, the
28
+ * userinfo fetch — live in the preset
29
+ * (`@hogsend/core`, `providers/account-link-presets.ts`), not here.
30
+ *
31
+ * Epic does not support PKCE for confidential clients, so `usePkce` is false.
32
+ * The verify endpoint returns the authenticated user's identity from the
33
+ * bearer token alone — no extra headers needed.
34
+ */
35
+ export declare function epicAccountLink(config: EpicAccountLinkConfig): AccountLinkProvider;
36
+ //# sourceMappingURL=epic.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"epic.d.ts","sourceRoot":"","sources":["../../src/account-links/epic.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,mBAAmB,EACxB,KAAK,cAAc,EAEpB,MAAM,eAAe,CAAC;AAEvB;;;;;;GAMG;AACH,MAAM,WAAW,qBAAqB;IACpC,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;CACtB;AAUD;;;;;;;;;GASG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,CAAC,cAAc,EAAE,QAAQ,CAAC,CAczE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE,qBAAqB,GAC5B,mBAAmB,CAoBrB"}
@@ -0,0 +1,7 @@
1
+ export { type BattlenetAccountLinkConfig, battlenetAccountLink, } from "./battlenet.js";
2
+ export { type EpicAccountLinkConfig, epicAccountLink } from "./epic.js";
3
+ export { type RiotAccountLinkConfig, riotAccountLink } from "./riot.js";
4
+ export { type SteamAccountLinkConfig, steamAccountLink } from "./steam.js";
5
+ export { type TwitchAccountLinkConfig, twitchAccountLink } from "./twitch.js";
6
+ export { type XboxAccountLinkConfig, xboxAccountLink } from "./xbox.js";
7
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/account-links/index.ts"],"names":[],"mappings":"AAMA,OAAO,EACL,KAAK,0BAA0B,EAC/B,oBAAoB,GACrB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,KAAK,qBAAqB,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AACxE,OAAO,EAAE,KAAK,qBAAqB,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AACxE,OAAO,EAAE,KAAK,sBAAsB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAC3E,OAAO,EAAE,KAAK,uBAAuB,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAC9E,OAAO,EAAE,KAAK,qBAAqB,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC"}
@@ -0,0 +1,35 @@
1
+ import { type AccountLinkProvider, type LinkedIdentity } from "@hogsend/core";
2
+ /**
3
+ * Riot Games app credentials, from an application registered at
4
+ * `https://developer.riotgames.com/` with OAuth redirect URL
5
+ * `<API_PUBLIC_URL>/v1/accounts/riot/callback`. Env spelling:
6
+ * `ACCOUNT_LINK_RIOT_CLIENT_ID` / `ACCOUNT_LINK_RIOT_CLIENT_SECRET`
7
+ * (see `lib/account-links-from-env.ts` — registered only when BOTH are set).
8
+ */
9
+ export interface RiotAccountLinkConfig {
10
+ clientId: string;
11
+ clientSecret: string;
12
+ }
13
+ /**
14
+ * Map an RSO `GET /userinfo` response onto a {@link LinkedIdentity}.
15
+ * Exported for direct unit testing — it is the only real logic in this file.
16
+ *
17
+ * - `providerUserId` is the PUUID (`sub`), the IMMUTABLE key. Riot returns it
18
+ * as `sub` in the OpenID Connect userinfo response; some endpoint versions
19
+ * also surface it as `puuid`. Never `cpid`: that is a legacy id.
20
+ * - Riot's userinfo endpoint does NOT return a gameName or tagLine, so no
21
+ * `username` is set. The PUUID alone is sufficient for the link row.
22
+ */
23
+ export declare function mapRiotUser(json: unknown): Omit<LinkedIdentity, "tokens">;
24
+ /**
25
+ * The Riot Games account-link provider: pure CONFIG over the `oauth2Link()`
26
+ * preset (OAuth2 authorization code + PKCE, tokens sealed). All protocol
27
+ * mechanics — authorize URL, token exchange, `error=access_denied` mapping,
28
+ * the userinfo fetch — live in the preset
29
+ * (`@hogsend/core`, `providers/account-link-presets.ts`), not here.
30
+ *
31
+ * RSO (Riot Sign On) is standard OAuth2 / OpenID Connect. The `openid` scope
32
+ * gives access to the `/userinfo` endpoint which returns the PUUID as `sub`.
33
+ */
34
+ export declare function riotAccountLink(config: RiotAccountLinkConfig): AccountLinkProvider;
35
+ //# sourceMappingURL=riot.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"riot.d.ts","sourceRoot":"","sources":["../../src/account-links/riot.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,mBAAmB,EACxB,KAAK,cAAc,EAEpB,MAAM,eAAe,CAAC;AAEvB;;;;;;GAMG;AACH,MAAM,WAAW,qBAAqB;IACpC,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;CACtB;AASD;;;;;;;;;GASG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,CAAC,cAAc,EAAE,QAAQ,CAAC,CAYzE;AAED;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE,qBAAqB,GAC5B,mBAAmB,CAmBrB"}
@@ -0,0 +1,35 @@
1
+ import { type AccountLinkProvider } from "@hogsend/core";
2
+ export interface SteamAccountLinkConfig {
3
+ /**
4
+ * Steam Web API key (`https://steamcommunity.com/dev/apikey`). OPTIONAL —
5
+ * it never gates the link itself. Absent: linking works and the identity is
6
+ * the bare 17-digit steamid64. Present: the best-effort
7
+ * `GetPlayerSummaries` pull fills `username`/`avatarUrl` and the
8
+ * `steam_playtime_2wk` property sync attaches.
9
+ */
10
+ webApiKey?: string;
11
+ /** The `openid.realm` this deployment presents. `API_PUBLIC_URL`, trailing slash stripped. */
12
+ realm: string;
13
+ }
14
+ /**
15
+ * The Steam account-link provider: pure CONFIG over the `steamOpenIdLink()`
16
+ * preset. "Sign in through Steam" is OpenID 2.0 `checkid_setup`, so three
17
+ * things a reader will come looking for are structurally absent:
18
+ *
19
+ * - There is NO `code` and NO PKCE — OpenID 2.0 has neither, so PRD 07 skips
20
+ * its PKCE mint for this provider (`capabilities.pkce` absent).
21
+ * - There is NO token — OpenID 2.0 issues nothing to store, so
22
+ * `capabilities.tokens` is absent and PRD 03 writes a null
23
+ * `linked_accounts.tokens`.
24
+ * - The relying party presents NO credential: no app registration, no client
25
+ * id, no secret. The entire security model is the preset's server-side
26
+ * `check_authentication` round-trip against Steam's HARDCODED endpoint
27
+ * (`STEAM_OPENID_ENDPOINT`), never the callback-echoed `openid.op_endpoint`.
28
+ *
29
+ * All protocol mechanics — the `checkid_setup` URL, the round-trip, the strict
30
+ * `parseSteamClaimedId` anchor, the `return_to` echo check, the `mode=cancel`
31
+ * mapping, the playtime sync reader — live in the preset
32
+ * (`@hogsend/core`, `providers/account-link-presets.ts`), not here.
33
+ */
34
+ export declare function steamAccountLink(config: SteamAccountLinkConfig): AccountLinkProvider;
35
+ //# sourceMappingURL=steam.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"steam.d.ts","sourceRoot":"","sources":["../../src/account-links/steam.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,mBAAmB,EAAmB,MAAM,eAAe,CAAC;AAE1E,MAAM,WAAW,sBAAsB;IACrC;;;;;;OAMG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,8FAA8F;IAC9F,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,sBAAsB,GAC7B,mBAAmB,CAUrB"}
@@ -0,0 +1,38 @@
1
+ import { type AccountLinkProvider, type LinkedIdentity } from "@hogsend/core";
2
+ /**
3
+ * Twitch app credentials, from an application registered at
4
+ * `https://dev.twitch.tv/console/apps` with OAuth redirect URL
5
+ * `<API_PUBLIC_URL>/v1/accounts/twitch/callback`. Env spelling:
6
+ * `ACCOUNT_LINK_TWITCH_CLIENT_ID` / `ACCOUNT_LINK_TWITCH_CLIENT_SECRET`
7
+ * (see `lib/account-links-from-env.ts` — registered only when BOTH are set).
8
+ */
9
+ export interface TwitchAccountLinkConfig {
10
+ clientId: string;
11
+ clientSecret: string;
12
+ }
13
+ /**
14
+ * Map a Helix `GET /helix/users` response onto a {@link LinkedIdentity}.
15
+ * Exported for direct unit testing — it is the only real logic in this file.
16
+ *
17
+ * - `providerUserId` is Helix's numeric `id`, the IMMUTABLE key. Never `login`
18
+ * or `display_name`: both are user-editable, so keying on one lets a player
19
+ * rename themselves onto another player's link row.
20
+ * - The email is a PROPERTY, never an identity key and never `verifiedEmail`:
21
+ * Helix returns `email` under the `user:read:email` scope but exposes no
22
+ * per-address verification boolean, and DECISIONS §6.4 makes a
23
+ * provider-reported email a property regardless. It lands in
24
+ * `properties.twitch_email`.
25
+ */
26
+ export declare function mapTwitchUser(json: unknown): Omit<LinkedIdentity, "tokens">;
27
+ /**
28
+ * The Twitch account-link provider: pure CONFIG over the `oauth2Link()` preset
29
+ * (OAuth2 authorization code + PKCE, tokens sealed, revoke on unlink). All
30
+ * protocol mechanics — authorize URL, token exchange, `error=access_denied`
31
+ * mapping, the userinfo fetch — live in the preset
32
+ * (`@hogsend/core`, `providers/account-link-presets.ts`), not here.
33
+ *
34
+ * `userInfo.headers` carries `Client-Id` because Helix 401s any request
35
+ * without it; the preset merges it UNDER the `Authorization: Bearer` header.
36
+ */
37
+ export declare function twitchAccountLink(config: TwitchAccountLinkConfig): AccountLinkProvider;
38
+ //# sourceMappingURL=twitch.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"twitch.d.ts","sourceRoot":"","sources":["../../src/account-links/twitch.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,mBAAmB,EACxB,KAAK,cAAc,EAEpB,MAAM,eAAe,CAAC;AAEvB;;;;;;GAMG;AACH,MAAM,WAAW,uBAAuB;IACtC,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;CACtB;AAWD;;;;;;;;;;;;GAYG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,CAAC,cAAc,EAAE,QAAQ,CAAC,CAkB3E;AAED;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,uBAAuB,GAC9B,mBAAmB,CAyBrB"}
@@ -0,0 +1,39 @@
1
+ import { type AccountLinkProvider, type LinkedIdentity } from "@hogsend/core";
2
+ /**
3
+ * Microsoft (Xbox) app credentials, from an application registered at
4
+ * `https://portal.azure.com` → App registrations with OAuth redirect URL
5
+ * `<API_PUBLIC_URL>/v1/accounts/xbox/callback`. The app MUST allow
6
+ * "personal Microsoft accounts" (consumers tenant). Env spelling:
7
+ * `ACCOUNT_LINK_XBOX_CLIENT_ID` / `ACCOUNT_LINK_XBOX_CLIENT_SECRET`
8
+ * (see `lib/account-links-from-env.ts` — registered only when BOTH are set).
9
+ */
10
+ export interface XboxAccountLinkConfig {
11
+ clientId: string;
12
+ clientSecret: string;
13
+ }
14
+ /**
15
+ * Map a Microsoft Graph `GET /v1.0/me` response onto a {@link LinkedIdentity}.
16
+ * Exported for direct unit testing — it is the only real logic in this file.
17
+ *
18
+ * - `providerUserId` is Graph's `id` (the IMMUTABLE Azure AD object id). This
19
+ * is the same identity that owns the Xbox account — personal Microsoft
20
+ * accounts are the backing identity for Xbox Live.
21
+ * - `userPrincipalName` is a PROPERTY, never an identity key and never
22
+ * `verifiedEmail`: Graph returns the primary email but DECISIONS §6.4 makes
23
+ * a provider-reported email a property regardless. It lands in
24
+ * `properties.xbox_email`.
25
+ */
26
+ export declare function mapXboxUser(json: unknown): Omit<LinkedIdentity, "tokens">;
27
+ /**
28
+ * The Xbox account-link provider: pure CONFIG over the `oauth2Link()` preset
29
+ * (OAuth2 authorization code + PKCE, tokens sealed). All protocol mechanics —
30
+ * authorize URL, token exchange, `error=access_denied` mapping, the userinfo
31
+ * fetch — live in the preset (`@hogsend/core`, `providers/account-link-presets.ts`),
32
+ * not here.
33
+ *
34
+ * Uses the Microsoft `/consumers` tenant so ONLY personal Microsoft accounts
35
+ * (which back Xbox Live) are accepted — work/school accounts are rejected at
36
+ * the authorize step by Microsoft itself.
37
+ */
38
+ export declare function xboxAccountLink(config: XboxAccountLinkConfig): AccountLinkProvider;
39
+ //# sourceMappingURL=xbox.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"xbox.d.ts","sourceRoot":"","sources":["../../src/account-links/xbox.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,mBAAmB,EACxB,KAAK,cAAc,EAEpB,MAAM,eAAe,CAAC;AAEvB;;;;;;;GAOG;AACH,MAAM,WAAW,qBAAqB;IACpC,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;CACtB;AASD;;;;;;;;;;;GAWG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,CAAC,cAAc,EAAE,QAAQ,CAAC,CAezE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE,qBAAqB,GAC5B,mBAAmB,CAsBrB"}
package/dist/app.d.ts ADDED
@@ -0,0 +1,50 @@
1
+ import { OpenAPIHono } from "@hono/zod-openapi";
2
+ import type { ErrorHandler, MiddlewareHandler } from "hono/types";
3
+ import type { HogsendClient } from "./container.js";
4
+ import type { Auth } from "./lib/auth.js";
5
+ import type { ApiKeyContext } from "./middleware/api-key.js";
6
+ import { type DefinedWebhookSource } from "./webhook-sources/define-webhook-source.js";
7
+ type AuthSession = Awaited<ReturnType<Auth["api"]["getSession"]>>;
8
+ export type AppEnv = {
9
+ Variables: {
10
+ container: HogsendClient;
11
+ requestId: string;
12
+ user: NonNullable<AuthSession>["user"] | null;
13
+ session: NonNullable<AuthSession>["session"] | null;
14
+ apiKey: ApiKeyContext | undefined;
15
+ publishable?: boolean;
16
+ };
17
+ };
18
+ /** A function that mounts custom routers onto the app after the built-in routes. */
19
+ export type RoutesFn = (app: OpenAPIHono<AppEnv>) => void;
20
+ export interface CreateAppOptions {
21
+ /**
22
+ * Mount custom routers after the built-in routes. Accepts a single function or
23
+ * an array — each is applied in order, so a consumer can compose its own
24
+ * routes with e.g. `cc.routes` without clobbering: `routes: [existing,
25
+ * cc.routes]`.
26
+ */
27
+ routes?: RoutesFn | RoutesFn[];
28
+ /** Extra middleware applied after the built-in stack. */
29
+ middleware?: MiddlewareHandler[];
30
+ /** Webhook sources served at `/v1/webhooks/:sourceId`. */
31
+ webhookSources?: DefinedWebhookSource[];
32
+ /**
33
+ * Auto-enable the shipped integration presets (Clerk, Supabase, Stripe,
34
+ * Segment) for every preset whose env secret is configured (gated further by
35
+ * `ENABLED_WEBHOOK_PRESETS`). Consumer-supplied `webhookSources` always win on
36
+ * an id collision. Set `false` to opt out entirely. Default `true`.
37
+ *
38
+ * @deprecated prefer `createHogsendClient({ enablePresets })` — preset
39
+ * resolution now lives in the container's connector registry. This flag is
40
+ * STILL HONORED end-to-end: when `false`, `createApp` strips the env-preset
41
+ * ids back out of the already-built registry, so the opt-out is NOT a silent
42
+ * no-op.
43
+ */
44
+ enablePresets?: boolean;
45
+ /** Override the default error handler. */
46
+ onError?: ErrorHandler<AppEnv>;
47
+ }
48
+ export declare function createApp(container: HogsendClient, opts?: CreateAppOptions): OpenAPIHono<AppEnv, {}, "/">;
49
+ export {};
50
+ //# sourceMappingURL=app.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"app.d.ts","sourceRoot":"","sources":["../src/app.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAMhD,OAAO,KAAK,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAElE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAEpD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AAE1C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAU7D,OAAO,EACL,KAAK,oBAAoB,EAE1B,MAAM,4CAA4C,CAAC;AAEpD,KAAK,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;AAElE,MAAM,MAAM,MAAM,GAAG;IACnB,SAAS,EAAE;QACT,SAAS,EAAE,aAAa,CAAC;QACzB,SAAS,EAAE,MAAM,CAAC;QAClB,IAAI,EAAE,WAAW,CAAC,WAAW,CAAC,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC;QAC9C,OAAO,EAAE,WAAW,CAAC,WAAW,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,CAAC;QACpD,MAAM,EAAE,aAAa,GAAG,SAAS,CAAC;QAKlC,WAAW,CAAC,EAAE,OAAO,CAAC;KACvB,CAAC;CACH,CAAC;AAEF,oFAAoF;AACpF,MAAM,MAAM,QAAQ,GAAG,CAAC,GAAG,EAAE,WAAW,CAAC,MAAM,CAAC,KAAK,IAAI,CAAC;AAE1D,MAAM,WAAW,gBAAgB;IAC/B;;;;;OAKG;IACH,MAAM,CAAC,EAAE,QAAQ,GAAG,QAAQ,EAAE,CAAC;IAC/B,yDAAyD;IACzD,UAAU,CAAC,EAAE,iBAAiB,EAAE,CAAC;IACjC,0DAA0D;IAC1D,cAAc,CAAC,EAAE,oBAAoB,EAAE,CAAC;IACxC;;;;;;;;;;;OAWG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,0CAA0C;IAC1C,OAAO,CAAC,EAAE,YAAY,CAAC,MAAM,CAAC,CAAC;CAChC;AAED,wBAAgB,SAAS,CACvB,SAAS,EAAE,aAAa,EACxB,IAAI,GAAE,gBAAqB,gCAmK5B"}
@@ -0,0 +1,60 @@
1
+ import { type Database } from "@hogsend/db";
2
+ /** A serialized active-membership row returned by `members()` / the iterator. */
3
+ export interface BucketMemberRow {
4
+ id: string;
5
+ userId: string;
6
+ userEmail: string | null;
7
+ enteredAt: string;
8
+ entryCount: number;
9
+ }
10
+ /** Supabase-shaped paged result — no throw; failures land in `error`. */
11
+ export interface MembersResult {
12
+ data: BucketMemberRow[];
13
+ error: Error | null;
14
+ /**
15
+ * Per-call snapshot total (active, non-deleted, joined to a live contact).
16
+ * NOT a consistent paginated total — under churn it can drift page-to-page.
17
+ * The keyset cursor itself is churn-safe; use `count()` for one authoritative
18
+ * number.
19
+ */
20
+ count: number | null;
21
+ /** Keyset continuation (last row `id`); `null` when the page is exhausted. */
22
+ cursor: string | null;
23
+ }
24
+ export interface BucketAccessor {
25
+ count(): Promise<{
26
+ data: number | null;
27
+ error: Error | null;
28
+ }>;
29
+ has(userId: string): Promise<{
30
+ data: boolean;
31
+ error: Error | null;
32
+ }>;
33
+ members(opts?: {
34
+ limit?: number;
35
+ cursor?: string;
36
+ }): Promise<MembersResult>;
37
+ membersIterator(opts?: {
38
+ pageSize?: number;
39
+ }): AsyncIterableIterator<BucketMemberRow>;
40
+ }
41
+ /**
42
+ * Build the per-bucket member-access surface (`count`/`has`/`members`/iterator).
43
+ *
44
+ * The accessor is constructed at module load (`defineBucket` time), before any
45
+ * container exists, so it defaults to `getDb()` — the same singleton the
46
+ * desugared reaction journeys run on. To honor `overrides.db` in tests, the
47
+ * container re-binds the accessors with a `dbResolver` that returns its own
48
+ * `db`; the `getDb()` default bypasses the container.
49
+ *
50
+ * Every query `innerJoin`s `contacts` on the membership's OWNING CONTACT
51
+ * (`bucket_memberships.contact_id`) and filters `isNull(deletedAt)` on both
52
+ * tables — GDPR parity with every reconcile/admin query. The join used to run
53
+ * on the mutable text key (`coalesce(external_id, anonymous_id, id) =
54
+ * user_id`); it now runs on the FK, so a membership adopted onto a contact
55
+ * under a since-stale key stays visible instead of dropping out of every count
56
+ * and page. No method throws (except the iterator on a page error); failures
57
+ * are carried in the result's `error`.
58
+ */
59
+ export declare function createBucketAccessor(bucketId: string, dbResolver?: () => Database): BucketAccessor;
60
+ //# sourceMappingURL=bucket-access.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"bucket-access.d.ts","sourceRoot":"","sources":["../../src/buckets/bucket-access.ts"],"names":[],"mappings":"AAAA,OAAO,EAA+B,KAAK,QAAQ,EAAE,MAAM,aAAa,CAAC;AAazE,iFAAiF;AACjF,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,yEAAyE;AACzE,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,eAAe,EAAE,CAAC;IACxB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB;;;;;OAKG;IACH,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,8EAA8E;IAC9E,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,IAAI,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAA;KAAE,CAAC,CAAC;IAC/D,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,OAAO,CAAC;QAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAA;KAAE,CAAC,CAAC;IACrE,OAAO,CAAC,IAAI,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IAC5E,eAAe,CAAC,IAAI,CAAC,EAAE;QACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,GAAG,qBAAqB,CAAC,eAAe,CAAC,CAAC;CAC5C;AAMD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,MAAM,EAChB,UAAU,GAAE,MAAM,QAAgB,GACjC,cAAc,CA+JhB"}
@@ -0,0 +1,100 @@
1
+ import type { DurationObject } from "@hogsend/core";
2
+ import type { JourneyContext, JourneyUser } from "@hogsend/core/types";
3
+ import { type DefinedJourney } from "../journeys/define-journey.js";
4
+ import type { DefinedBucket } from "./define-bucket.js";
5
+ /**
6
+ * Why a reaction reaches for THIS leave reason. Carried on the emitted
7
+ * `bucket:left:<id>` event properties and surfaced to a `leave` handler as
8
+ * `ctx.reason`. `"manual"` is reserved for a future force-leave path.
9
+ */
10
+ export type BucketLeaveReason = "criteria" | "maxDwell" | "manual";
11
+ /** `bucket.on("enter", opts?, handler)` options. */
12
+ export interface EnterOptions {
13
+ /**
14
+ * Only run the handler on the user's FIRST entry to this bucket (re-entries
15
+ * are skipped). Re-entry is a FILTER, never a separate event — the filter runs
16
+ * inside `run` AFTER enrollment (a filtered-out entry still writes a short
17
+ * active→completed `journeyStates` row).
18
+ */
19
+ firstEntryOnly?: boolean;
20
+ }
21
+ /** `bucket.on("leave", opts?, handler)` options. */
22
+ export interface LeaveOptions {
23
+ /**
24
+ * Only run the handler when the leave matches this reason (or one of these
25
+ * reasons). Filter runs inside `run` AFTER enrollment.
26
+ */
27
+ reason?: BucketLeaveReason | BucketLeaveReason[];
28
+ }
29
+ /**
30
+ * `bucket.on("dwell", opts, handler)` options — exactly one of `after`/`every`.
31
+ * - `after`: one-shot, fires once when the member has dwelt continuously for
32
+ * the duration.
33
+ * - `every`: recurring, fires (coalescing) once per elapsed interval.
34
+ */
35
+ export type DwellOptions = {
36
+ after: DurationObject;
37
+ every?: never;
38
+ } | {
39
+ every: DurationObject;
40
+ after?: never;
41
+ };
42
+ /**
43
+ * Reaction-specific read-only extras layered onto the canonical
44
+ * `JourneyContext` for the handler, discriminated by the reaction kind.
45
+ */
46
+ export type ReactionExtras<K> = K extends "enter" ? {
47
+ entryCount: number;
48
+ isFirstEntry: boolean;
49
+ } : K extends "leave" ? {
50
+ reason: BucketLeaveReason;
51
+ } : {
52
+ dwellCount: number;
53
+ };
54
+ /** The ctx a reaction handler receives: full JourneyContext + kind extras. */
55
+ export type BucketReactionCtx<K extends "enter" | "leave" | "dwell"> = JourneyContext & ReactionExtras<K>;
56
+ /** A bucket-reaction handler — same `(user, ctx)` shape as a journey `run`. */
57
+ export type BucketOnHandler<K extends "enter" | "leave" | "dwell"> = (user: JourneyUser, ctx: BucketReactionCtx<K>) => Promise<void>;
58
+ /** Coerce a single value or array to an array. */
59
+ export declare function asArray<T>(value: T | T[]): T[];
60
+ /**
61
+ * Stable, schedule-unique label for a dwell reaction: `after-<ms>` / `every-<ms>`.
62
+ * Hatchet keys workflows by `journey-${id}`, so two dwell reactions on one bucket
63
+ * (one `after`, one `every`) get distinct, boot-stable ids/events.
64
+ */
65
+ export declare function dwellLabel(opts: DwellOptions): string;
66
+ /** The schema persisted on the reaction meta (read by the dwell cron). */
67
+ export declare function parseDwellSchedule(opts: DwellOptions): {
68
+ label: string;
69
+ after?: number;
70
+ every?: number;
71
+ };
72
+ /** Derive the generated reaction journey id from the bucket id + kind. */
73
+ export declare function reactionJourneyId(bucketId: string, kind: "enter" | "leave" | "dwell", opts: EnterOptions | LeaveOptions | DwellOptions | undefined): string;
74
+ /**
75
+ * Discriminate the `(opts?, handler)` overload by argument type: a function in
76
+ * the first slot is the handler (opts undefined); an object in the first slot is
77
+ * opts and the second slot is the handler. For `dwell`, opts is mandatory and
78
+ * must carry exactly one of `after`/`every` — a `TypeError` otherwise.
79
+ */
80
+ export declare function normalizeOnArgs(kind: "enter" | "leave" | "dwell", a: unknown, b?: unknown): {
81
+ opts: EnterOptions | LeaveOptions | DwellOptions | undefined;
82
+ handler: BucketOnHandler<"enter" | "leave" | "dwell">;
83
+ };
84
+ /**
85
+ * Desugar `bucket.on(kind, opts?, handler)` to a real `defineJourney` output
86
+ * tagged with `sourceBucketId` + `reactionKind`. The reaction IS a journey, so
87
+ * it inherits the entire enrollment guard stack, the active-state dedup, the
88
+ * durable context, and event routing for free.
89
+ *
90
+ * The handler ctx is built by SPREAD (`{ ...ctx, ...extras }`), never by
91
+ * mutating the engine's canonical ctx (which is shared/closed). The
92
+ * `firstEntryOnly`/`reason` filters run inside `run` AFTER enrollment.
93
+ */
94
+ export declare function buildBucketReaction(args: {
95
+ bucket: DefinedBucket;
96
+ kind: "enter" | "leave" | "dwell";
97
+ opts: EnterOptions | LeaveOptions | DwellOptions | undefined;
98
+ handler: BucketOnHandler<"enter" | "leave" | "dwell">;
99
+ }): DefinedJourney;
100
+ //# sourceMappingURL=bucket-reactions.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"bucket-reactions.d.ts","sourceRoot":"","sources":["../../src/buckets/bucket-reactions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAEpD,OAAO,KAAK,EACV,cAAc,EAEd,WAAW,EACZ,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,KAAK,cAAc,EAEpB,MAAM,+BAA+B,CAAC;AACvC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAExD;;;;GAIG;AACH,MAAM,MAAM,iBAAiB,GAAG,UAAU,GAAG,UAAU,GAAG,QAAQ,CAAC;AAEnE,oDAAoD;AACpD,MAAM,WAAW,YAAY;IAC3B;;;;;OAKG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,oDAAoD;AACpD,MAAM,WAAW,YAAY;IAC3B;;;OAGG;IACH,MAAM,CAAC,EAAE,iBAAiB,GAAG,iBAAiB,EAAE,CAAC;CAClD;AAED;;;;;GAKG;AACH,MAAM,MAAM,YAAY,GACpB;IAAE,KAAK,EAAE,cAAc,CAAC;IAAC,KAAK,CAAC,EAAE,KAAK,CAAA;CAAE,GACxC;IAAE,KAAK,EAAE,cAAc,CAAC;IAAC,KAAK,CAAC,EAAE,KAAK,CAAA;CAAE,CAAC;AAE7C;;;GAGG;AACH,MAAM,MAAM,cAAc,CAAC,CAAC,IAAI,CAAC,SAAS,OAAO,GAC7C;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,OAAO,CAAA;CAAE,GAC7C,CAAC,SAAS,OAAO,GACf;IAAE,MAAM,EAAE,iBAAiB,CAAA;CAAE,GAC7B;IAAE,UAAU,EAAE,MAAM,CAAA;CAAE,CAAC;AAE7B,8EAA8E;AAC9E,MAAM,MAAM,iBAAiB,CAAC,CAAC,SAAS,OAAO,GAAG,OAAO,GAAG,OAAO,IACjE,cAAc,GAAG,cAAc,CAAC,CAAC,CAAC,CAAC;AAErC,+EAA+E;AAC/E,MAAM,MAAM,eAAe,CAAC,CAAC,SAAS,OAAO,GAAG,OAAO,GAAG,OAAO,IAAI,CACnE,IAAI,EAAE,WAAW,EACjB,GAAG,EAAE,iBAAiB,CAAC,CAAC,CAAC,KACtB,OAAO,CAAC,IAAI,CAAC,CAAC;AAEnB,kDAAkD;AAClD,wBAAgB,OAAO,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,CAAC,EAAE,GAAG,CAAC,EAAE,CAE9C;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,YAAY,GAAG,MAAM,CAIrD;AAED,0EAA0E;AAC1E,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,YAAY,GAAG;IACtD,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAIA;AAED,0EAA0E;AAC1E,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,OAAO,GAAG,OAAO,GAAG,OAAO,EACjC,IAAI,EAAE,YAAY,GAAG,YAAY,GAAG,YAAY,GAAG,SAAS,GAC3D,MAAM,CAIR;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,OAAO,GAAG,OAAO,GAAG,OAAO,EACjC,CAAC,EAAE,OAAO,EACV,CAAC,CAAC,EAAE,OAAO,GACV;IACD,IAAI,EAAE,YAAY,GAAG,YAAY,GAAG,YAAY,GAAG,SAAS,CAAC;IAC7D,OAAO,EAAE,eAAe,CAAC,OAAO,GAAG,OAAO,GAAG,OAAO,CAAC,CAAC;CACvD,CA4BA;AAED;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE;IACxC,MAAM,EAAE,aAAa,CAAC;IACtB,IAAI,EAAE,OAAO,GAAG,OAAO,GAAG,OAAO,CAAC;IAClC,IAAI,EAAE,YAAY,GAAG,YAAY,GAAG,YAAY,GAAG,SAAS,CAAC;IAC7D,OAAO,EAAE,eAAe,CAAC,OAAO,GAAG,OAAO,GAAG,OAAO,CAAC,CAAC;CACvD,GAAG,cAAc,CA0DjB"}