@hogsend/engine 0.66.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 (760) 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/container.ts +77 -0
  708. package/src/env.ts +30 -0
  709. package/src/index.ts +78 -0
  710. package/src/journeys/journey-log.ts +25 -8
  711. package/src/lib/contacts.ts +117 -1
  712. package/src/lib/email-service-types.ts +10 -0
  713. package/src/lib/ingestion.ts +91 -19
  714. package/src/lib/links.ts +94 -11
  715. package/src/lib/mailer-bounce-idempotency.test.ts +7 -2
  716. package/src/lib/mailer-replied.test.ts +7 -2
  717. package/src/lib/mailer.ts +1 -0
  718. package/src/lib/outbound-endpoint-cache.ts +83 -0
  719. package/src/lib/outbound.ts +150 -37
  720. package/src/lib/referral-intent.ts +723 -0
  721. package/src/lib/referral-link.ts +200 -0
  722. package/src/lib/referral-registry.ts +83 -0
  723. package/src/lib/referral-report.ts +739 -0
  724. package/src/lib/referral-runtime.ts +49 -0
  725. package/src/lib/referrals-no-emit.test.ts +109 -0
  726. package/src/lib/referrals.ts +712 -0
  727. package/src/lib/seed-posthog-destination.ts +5 -1
  728. package/src/lib/tracked.ts +11 -3
  729. package/src/lib/tracking-events.ts +20 -3
  730. package/src/lib/webhook-signing.ts +10 -0
  731. package/src/middleware/api-key.ts +69 -60
  732. package/src/middleware/publishable-key.ts +11 -23
  733. package/src/middleware/rate-limit.ts +165 -3
  734. package/src/routes/admin/api-keys.ts +153 -0
  735. package/src/routes/admin/index.ts +2 -0
  736. package/src/routes/admin/links.ts +14 -5
  737. package/src/routes/admin/referrals.ts +565 -0
  738. package/src/routes/admin/targeting.ts +6 -1
  739. package/src/routes/admin/webhooks.ts +4 -0
  740. package/src/routes/contacts/index.ts +78 -0
  741. package/src/routes/index.ts +104 -22
  742. package/src/routes/referrals/index.ts +41 -0
  743. package/src/routes/referrals/me.ts +123 -0
  744. package/src/routes/referrals/report.ts +285 -0
  745. package/src/routes/referrals/shared.ts +34 -0
  746. package/src/routes/referrals/touch.ts +313 -0
  747. package/src/routes/tracking/arrive.ts +90 -0
  748. package/src/routes/tracking/click-pipeline.ts +8 -0
  749. package/src/workflows/backfill-contact-id.ts +3 -7
  750. package/src/workflows/bucket-backfill.ts +2 -2
  751. package/src/workflows/bucket-reconcile.ts +28 -12
  752. package/src/workflows/check-alerts.ts +3 -9
  753. package/src/workflows/crm-reconcile.ts +3 -2
  754. package/src/workflows/deliver-webhook.ts +21 -8
  755. package/src/workflows/dispatch-conversion.ts +2 -2
  756. package/src/workflows/identity-alias-backfill.ts +3 -2
  757. package/src/workflows/impact-digest.ts +2 -2
  758. package/src/workflows/import-contacts.ts +3 -4
  759. package/src/workflows/import-suppressions.ts +4 -5
  760. package/src/workflows/send-campaign.ts +10 -1
@@ -0,0 +1,266 @@
1
+ /**
2
+ * Journey Blueprint authoring tools (spec §9, phase 4) — the agent-facing
3
+ * surface for creating, validating, and operating blueprints without a
4
+ * deploy in the loop.
5
+ *
6
+ * Deliberately TRANSPORT-AGNOSTIC: this repo runs no MCP server today, so
7
+ * each tool is a plain `{ name, description, inputSchema, handler }` record
8
+ * rather than a registration against a specific SDK. That shape mounts
9
+ * 1:1 onto whatever hosts it:
10
+ * - an MCP server: `server.registerTool(t.name, { description, inputSchema }, t.handler)`
11
+ * - the Vercel AI SDK (like `buildAgentTools`): `tool({ description, inputSchema, execute: t.handler })`
12
+ * - direct in-process calls (tests, scripts): `await t.handler(input)`
13
+ *
14
+ * Handlers call the SAME service layer the admin routes use
15
+ * (`lib/blueprints.ts`) — in-process function calls, no HTTP round-trip, no
16
+ * parallel auth or storage path (spec §9: "thin wrapper … no parallel auth
17
+ * or storage path"). Authentication is the MOUNTING surface's job, exactly
18
+ * as `adminRouter` middleware is for the routes: do not expose these tools
19
+ * without an auth gate in front of them.
20
+ *
21
+ * Contract: handlers NEVER throw for expected failures. Every result is a
22
+ * discriminated union on `ok` (+ `code` on failures), and graph problems
23
+ * carry the same structured `BlueprintValidationIssue[]` the admin routes
24
+ * return — an authoring agent iterates on an itemized "what's wrong and
25
+ * where" list, not a caught exception's `.message`. Unexpected errors (DB
26
+ * down, …) still throw and are the host's problem.
27
+ */
28
+ import type { BlueprintValidationIssue } from "@hogsend/core";
29
+ import { z } from "zod";
30
+ import { type BlueprintServiceContainer, type SerializedBlueprint } from "../lib/blueprints.js";
31
+ /** Issue shape shared by input parsing and graph validation failures. */
32
+ export type BlueprintToolIssue = {
33
+ nodeId?: string;
34
+ edgeId?: string;
35
+ path: (string | number)[];
36
+ code: string;
37
+ message: string;
38
+ };
39
+ /** Returned when the tool call's arguments don't parse against `inputSchema`. */
40
+ export type BlueprintToolInvalidInput = {
41
+ ok: false;
42
+ code: "invalid_input";
43
+ error: string;
44
+ issues: BlueprintToolIssue[];
45
+ };
46
+ /**
47
+ * One tool: a name, an agent-facing description, a Zod input schema (convert
48
+ * with `z.toJSONSchema` for hosts that speak JSON Schema, e.g. MCP), and a
49
+ * handler. The handler safe-parses its own input (applying defaults), so it
50
+ * is self-contained even when the host doesn't pre-validate.
51
+ */
52
+ export interface BlueprintToolDefinition<S extends z.ZodType, Out> {
53
+ name: string;
54
+ description: string;
55
+ inputSchema: S;
56
+ handler: (input: unknown) => Promise<Out | BlueprintToolInvalidInput>;
57
+ }
58
+ type ToolWriteSuccess = {
59
+ ok: true;
60
+ blueprint: SerializedBlueprint;
61
+ };
62
+ type ToolNotFound = {
63
+ ok: false;
64
+ code: "not_found";
65
+ error: string;
66
+ };
67
+ type ToolConflict = {
68
+ ok: false;
69
+ code: "conflict";
70
+ error: string;
71
+ };
72
+ type ToolPromoted = {
73
+ ok: false;
74
+ code: "promoted";
75
+ error: string;
76
+ };
77
+ type ToolInFlight = {
78
+ ok: false;
79
+ code: "in_flight";
80
+ error: string;
81
+ };
82
+ type ToolVersionConflict = {
83
+ ok: false;
84
+ code: "version_conflict";
85
+ error: string;
86
+ };
87
+ type ToolInvalidGraph = {
88
+ ok: false;
89
+ code: "invalid_graph";
90
+ error: string;
91
+ issues: BlueprintValidationIssue[];
92
+ };
93
+ export interface JourneyBlueprintToolsOptions {
94
+ /** The DI client (or a Pick of db/registry/templates/connectorActionRegistry). */
95
+ container: BlueprintServiceContainer;
96
+ /**
97
+ * Actor label stamped into `journey_blueprints.createdBy` for every create —
98
+ * bind the mounting session's identity here (e.g. an MCP session id or
99
+ * operator email) for Studio's post-hoc oversight. It is NOT a tool input:
100
+ * a model cannot attribute a blueprint to anyone, exactly as `source` is
101
+ * stamped by the surface.
102
+ */
103
+ createdBy?: string;
104
+ }
105
+ /**
106
+ * Build the journey-blueprint tool set (spec §9). See the module docs for
107
+ * the mounting contract; `Object.values(tools)` gives the array form.
108
+ */
109
+ export declare function createJourneyBlueprintTools(options: JourneyBlueprintToolsOptions): {
110
+ create_journey_blueprint: BlueprintToolDefinition<z.ZodObject<{
111
+ name: z.ZodString;
112
+ status: z.ZodDefault<z.ZodEnum<{
113
+ draft: "draft";
114
+ enabled: "enabled";
115
+ }>>;
116
+ description: z.ZodOptional<z.ZodString>;
117
+ triggerEvent: z.ZodString;
118
+ triggerWhere: z.ZodOptional<z.ZodArray<z.ZodObject<{
119
+ type: z.ZodLiteral<"property">;
120
+ property: z.ZodString;
121
+ operator: z.ZodEnum<{
122
+ eq: "eq";
123
+ neq: "neq";
124
+ gt: "gt";
125
+ gte: "gte";
126
+ lt: "lt";
127
+ lte: "lte";
128
+ exists: "exists";
129
+ not_exists: "not_exists";
130
+ contains: "contains";
131
+ }>;
132
+ value: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>;
133
+ }, z.core.$strip>>>;
134
+ entryLimit: z.ZodEnum<{
135
+ once: "once";
136
+ once_per_period: "once_per_period";
137
+ unlimited: "unlimited";
138
+ }>;
139
+ entryPeriod: z.ZodOptional<z.ZodObject<{
140
+ hours: z.ZodOptional<z.ZodNumber>;
141
+ minutes: z.ZodOptional<z.ZodNumber>;
142
+ seconds: z.ZodOptional<z.ZodNumber>;
143
+ }, z.core.$strict>>;
144
+ exitOn: z.ZodOptional<z.ZodArray<z.ZodObject<{
145
+ event: z.ZodString;
146
+ where: z.ZodOptional<z.ZodArray<z.ZodObject<{
147
+ type: z.ZodLiteral<"property">;
148
+ property: z.ZodString;
149
+ operator: z.ZodEnum<{
150
+ eq: "eq";
151
+ neq: "neq";
152
+ gt: "gt";
153
+ gte: "gte";
154
+ lt: "lt";
155
+ lte: "lte";
156
+ exists: "exists";
157
+ not_exists: "not_exists";
158
+ contains: "contains";
159
+ }>;
160
+ value: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>;
161
+ }, z.core.$strip>>>;
162
+ }, z.core.$strip>>>;
163
+ suppress: z.ZodObject<{
164
+ hours: z.ZodOptional<z.ZodNumber>;
165
+ minutes: z.ZodOptional<z.ZodNumber>;
166
+ seconds: z.ZodOptional<z.ZodNumber>;
167
+ }, z.core.$strict>;
168
+ graph: z.ZodUnknown;
169
+ }, z.core.$strip>, ToolWriteSuccess | ToolConflict | ToolInvalidGraph>;
170
+ update_journey_blueprint: BlueprintToolDefinition<z.ZodObject<{
171
+ name: z.ZodOptional<z.ZodString>;
172
+ description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
173
+ triggerEvent: z.ZodOptional<z.ZodString>;
174
+ triggerWhere: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodObject<{
175
+ type: z.ZodLiteral<"property">;
176
+ property: z.ZodString;
177
+ operator: z.ZodEnum<{
178
+ eq: "eq";
179
+ neq: "neq";
180
+ gt: "gt";
181
+ gte: "gte";
182
+ lt: "lt";
183
+ lte: "lte";
184
+ exists: "exists";
185
+ not_exists: "not_exists";
186
+ contains: "contains";
187
+ }>;
188
+ value: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>;
189
+ }, z.core.$strip>>>>;
190
+ entryLimit: z.ZodOptional<z.ZodEnum<{
191
+ once: "once";
192
+ once_per_period: "once_per_period";
193
+ unlimited: "unlimited";
194
+ }>>;
195
+ entryPeriod: z.ZodOptional<z.ZodNullable<z.ZodObject<{
196
+ hours: z.ZodOptional<z.ZodNumber>;
197
+ minutes: z.ZodOptional<z.ZodNumber>;
198
+ seconds: z.ZodOptional<z.ZodNumber>;
199
+ }, z.core.$strict>>>;
200
+ exitOn: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodObject<{
201
+ event: z.ZodString;
202
+ where: z.ZodOptional<z.ZodArray<z.ZodObject<{
203
+ type: z.ZodLiteral<"property">;
204
+ property: z.ZodString;
205
+ operator: z.ZodEnum<{
206
+ eq: "eq";
207
+ neq: "neq";
208
+ gt: "gt";
209
+ gte: "gte";
210
+ lt: "lt";
211
+ lte: "lte";
212
+ exists: "exists";
213
+ not_exists: "not_exists";
214
+ contains: "contains";
215
+ }>;
216
+ value: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>;
217
+ }, z.core.$strip>>>;
218
+ }, z.core.$strip>>>>;
219
+ suppress: z.ZodOptional<z.ZodObject<{
220
+ hours: z.ZodOptional<z.ZodNumber>;
221
+ minutes: z.ZodOptional<z.ZodNumber>;
222
+ seconds: z.ZodOptional<z.ZodNumber>;
223
+ }, z.core.$strict>>;
224
+ graph: z.ZodOptional<z.ZodUnknown>;
225
+ id: z.ZodString;
226
+ }, z.core.$strip>, ToolWriteSuccess | ToolNotFound | ToolPromoted | ToolInFlight | ToolVersionConflict | ToolInvalidGraph>;
227
+ validate_journey_blueprint: BlueprintToolDefinition<z.ZodObject<{
228
+ graph: z.ZodOptional<z.ZodUnknown>;
229
+ id: z.ZodOptional<z.ZodString>;
230
+ }, z.core.$strip>, ToolNotFound | {
231
+ ok: true;
232
+ valid: boolean;
233
+ issues: BlueprintValidationIssue[];
234
+ }>;
235
+ list_email_templates: BlueprintToolDefinition<z.ZodObject<{}, z.core.$strip>, {
236
+ ok: true;
237
+ templates: {
238
+ key: string;
239
+ defaultSubject: string | undefined;
240
+ category: string | undefined;
241
+ }[];
242
+ }>;
243
+ list_events: BlueprintToolDefinition<z.ZodObject<{
244
+ search: z.ZodOptional<z.ZodString>;
245
+ limit: z.ZodDefault<z.ZodNumber>;
246
+ }, z.core.$strip>, {
247
+ ok: true;
248
+ note: string;
249
+ events: {
250
+ name: string;
251
+ occurrences: number;
252
+ firstSeenAt: string | null;
253
+ lastSeenAt: string | null;
254
+ usedBy: string[];
255
+ }[];
256
+ }>;
257
+ enable_journey_blueprint: BlueprintToolDefinition<z.ZodObject<{
258
+ id: z.ZodString;
259
+ }, z.core.$strip>, ToolWriteSuccess | ToolNotFound | ToolPromoted | ToolInvalidGraph>;
260
+ disable_journey_blueprint: BlueprintToolDefinition<z.ZodObject<{
261
+ id: z.ZodString;
262
+ }, z.core.$strip>, ToolWriteSuccess | ToolNotFound>;
263
+ };
264
+ export type JourneyBlueprintTools = ReturnType<typeof createJourneyBlueprintTools>;
265
+ export {};
266
+ //# sourceMappingURL=blueprint-tools.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"blueprint-tools.d.ts","sourceRoot":"","sources":["../../src/mcp/blueprint-tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,eAAe,CAAC;AAE9D,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EACL,KAAK,yBAAyB,EAO9B,KAAK,mBAAmB,EAIzB,MAAM,sBAAsB,CAAC;AAQ9B,yEAAyE;AACzE,MAAM,MAAM,kBAAkB,GAAG;IAC/B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,CAAC;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,iFAAiF;AACjF,MAAM,MAAM,yBAAyB,GAAG;IACtC,EAAE,EAAE,KAAK,CAAC;IACV,IAAI,EAAE,eAAe,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,kBAAkB,EAAE,CAAC;CAC9B,CAAC;AAEF;;;;;GAKG;AACH,MAAM,WAAW,uBAAuB,CAAC,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,GAAG;IAC/D,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,CAAC,CAAC;IACf,OAAO,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC,GAAG,GAAG,yBAAyB,CAAC,CAAC;CACvE;AAqCD,KAAK,gBAAgB,GAAG;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,SAAS,EAAE,mBAAmB,CAAA;CAAE,CAAC;AACrE,KAAK,YAAY,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,IAAI,EAAE,WAAW,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AACpE,KAAK,YAAY,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,IAAI,EAAE,UAAU,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AACnE,KAAK,YAAY,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,IAAI,EAAE,UAAU,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AACnE,KAAK,YAAY,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,IAAI,EAAE,WAAW,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AACpE,KAAK,mBAAmB,GAAG;IACzB,EAAE,EAAE,KAAK,CAAC;IACV,IAAI,EAAE,kBAAkB,CAAC;IACzB,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AACF,KAAK,gBAAgB,GAAG;IACtB,EAAE,EAAE,KAAK,CAAC;IACV,IAAI,EAAE,eAAe,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,wBAAwB,EAAE,CAAC;CACpC,CAAC;AAsDF,MAAM,WAAW,4BAA4B;IAC3C,kFAAkF;IAClF,SAAS,EAAE,yBAAyB,CAAC;IACrC;;;;;;OAMG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;GAGG;AACH,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,4BAA4B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;YA4EzB,IAAI;eAAS,OAAO;gBAAU,wBAAwB,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA2GrE;AAED,MAAM,MAAM,qBAAqB,GAAG,UAAU,CAC5C,OAAO,2BAA2B,CACnC,CAAC"}
@@ -0,0 +1,45 @@
1
+ import { type Database } from "@hogsend/db";
2
+ import type { AppEnv } from "../app.js";
3
+ export interface ApiKeyContext {
4
+ id: string;
5
+ name: string;
6
+ scopes: string[];
7
+ allowedOrigins?: string[] | null;
8
+ }
9
+ /**
10
+ * Single source of truth for scope checks.
11
+ *
12
+ * - Hierarchical scopes (`read` < `journey-admin` < `full-admin`): the key
13
+ * passes when the MAX hierarchical rank it holds is >= the required rank.
14
+ * - Orthogonal scopes (e.g. `ingest`): NOT part of the hierarchy. A key must
15
+ * either be granted the scope explicitly OR hold `full-admin` (which implies
16
+ * every orthogonal data-plane scope).
17
+ *
18
+ * This fixes the latent bug where an orthogonal required scope was looked up in
19
+ * SCOPE_HIERARCHY (`?? 0`), letting ANY authenticated key satisfy it.
20
+ */
21
+ export declare function hasScope(keyScopes: string[], required: string): boolean;
22
+ /** An `api_keys` row as both auth guards need it, cached per process. */
23
+ export interface CachedApiKey extends ApiKeyContext {
24
+ expiresAt: Date | null;
25
+ lastUsedAt: Date | null;
26
+ allowedOrigins: string[] | null;
27
+ }
28
+ /**
29
+ * Drop a key's cached auth entry so THIS process re-reads the row on the key's
30
+ * next request. Called after a revoke or a rotation changes the row. The cache
31
+ * is per process: other API instances keep their entry until its TTL (60s)
32
+ * runs out, which is the documented revocation lag.
33
+ */
34
+ export declare function evictCachedApiKey(keyHash: string): void;
35
+ /**
36
+ * Read a live (unrevoked) key by hash through the 60s per-process cache, for
37
+ * secret and publishable keys alike. Misses are not cached, so a key minted a
38
+ * moment ago works on its first request. Expiry is the caller's check (it is
39
+ * re-evaluated on every request, cached or not). On a cache fill, `lastUsedAt`
40
+ * is bumped fire-and-forget at most once per five minutes.
41
+ */
42
+ export declare function loadApiKey(db: Database, keyHash: string): Promise<CachedApiKey | null>;
43
+ export declare const requireApiKey: import("hono").MiddlewareHandler<AppEnv, string, {}, Response>;
44
+ export declare function requireScope(scope: string): import("hono").MiddlewareHandler<AppEnv, string, {}, Response>;
45
+ //# sourceMappingURL=api-key.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"api-key.d.ts","sourceRoot":"","sources":["../../src/middleware/api-key.ts"],"names":[],"mappings":"AAAA,OAAO,EAAW,KAAK,QAAQ,EAAE,MAAM,aAAa,CAAC;AAGrD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAGxC,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,EAAE,CAAC;IAIjB,cAAc,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;CAClC;AAQD;;;;;;;;;;;GAWG;AACH,wBAAgB,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAkBvE;AAED,yEAAyE;AACzE,MAAM,WAAW,YAAa,SAAQ,aAAa;IACjD,SAAS,EAAE,IAAI,GAAG,IAAI,CAAC;IACvB,UAAU,EAAE,IAAI,GAAG,IAAI,CAAC;IACxB,cAAc,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;CACjC;AAMD;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAEvD;AAED;;;;;;GAMG;AACH,wBAAsB,UAAU,CAC9B,EAAE,EAAE,QAAQ,EACZ,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAoC9B;AAED,eAAO,MAAM,aAAa,gEA6BxB,CAAC;AAEH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,kEAazC"}
@@ -0,0 +1,3 @@
1
+ import type { AppEnv } from "../app.js";
2
+ export declare const auditMiddleware: import("hono").MiddlewareHandler<AppEnv, string, {}, Response>;
3
+ //# sourceMappingURL=audit.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"audit.d.ts","sourceRoot":"","sources":["../../src/middleware/audit.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAkBxC,eAAO,MAAM,eAAe,gEA0B1B,CAAC"}
@@ -0,0 +1,4 @@
1
+ import type { ErrorHandler } from "hono";
2
+ import type { AppEnv } from "../app.js";
3
+ export declare const errorHandler: ErrorHandler<AppEnv>;
4
+ //# sourceMappingURL=error-handler.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"error-handler.d.ts","sourceRoot":"","sources":["../../src/middleware/error-handler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,MAAM,CAAC;AAEzC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAExC,eAAO,MAAM,YAAY,EAAE,YAAY,CAAC,MAAM,CAiB7C,CAAC"}
@@ -0,0 +1,27 @@
1
+ import type { AppEnv } from "../app.js";
2
+ /**
3
+ * Data-plane guard for the BROWSER-REACHABLE subset of `/v1` (POST /events, the
4
+ * contacts upsert, GET /lists, list subscribe/unsubscribe, GET /lists/preferences).
5
+ *
6
+ * Accepts EITHER credential class:
7
+ *
8
+ * - SECRET key (anything NOT prefixed `pk_`): delegates to the UNCHANGED
9
+ * `requireApiKey` (legacy ADMIN_API_KEY + 60s cache + expiry), then applies
10
+ * the same `requireScope("ingest")` check inline. This path is
11
+ * byte-for-byte behaviorally identical to the existing
12
+ * `requireApiKey` → `requireScope("ingest")` stack.
13
+ *
14
+ * - PUBLISHABLE key (`pk_` bearer): read through the same 60s key cache
15
+ * (`loadApiKey`, which carries `allowed_origins`) with the same debounced
16
+ * `lastUsedAt` bump as secret keys. Requires scope `ingest-public`
17
+ * and REJECTS any pk_ token that somehow also carries `ingest`/`full-admin`
18
+ * (defence in depth — a prefix never implies privilege). Enforces the
19
+ * per-key Origin allowlist FAIL-CLOSED (no/empty allowlist ⇒ reject; Origin
20
+ * not in the allowlist ⇒ reject), then sets `publishable = true`.
21
+ *
22
+ * A pk_ key therefore cannot reach any route this guard is not mounted on, and
23
+ * cannot pass `requireScope("ingest")` anywhere else (its `["ingest-public"]`
24
+ * scope is neither `ingest` nor `full-admin`).
25
+ */
26
+ export declare const requirePublishableOrIngest: import("hono").MiddlewareHandler<AppEnv, string, {}, Response>;
27
+ //# sourceMappingURL=publishable-key.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"publishable-key.d.ts","sourceRoot":"","sources":["../../src/middleware/publishable-key.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAIxC;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,eAAO,MAAM,0BAA0B,gEA6EtC,CAAC"}
@@ -0,0 +1,105 @@
1
+ import type { Context } from "hono";
2
+ import type { AppEnv } from "../app.js";
3
+ /**
4
+ * Every header `createRateLimit` can set. `app.ts` passes this list to the CORS
5
+ * `exposeHeaders` option: none of these is a CORS-safelisted response header,
6
+ * so without it a browser (`@hogsend/js` on a pk_ key) could not read them —
7
+ * including `Retry-After`, which the SDK maps to `RateLimitError.retryAfter`.
8
+ */
9
+ export declare const RATE_LIMIT_HEADERS: readonly ["RateLimit-Limit", "RateLimit-Remaining", "RateLimit-Reset", "RateLimit-Policy", "X-RateLimit-Limit", "X-RateLimit-Remaining", "Retry-After"];
10
+ export interface RateLimitOptions {
11
+ windowMs?: number;
12
+ max?: number;
13
+ prefix?: string;
14
+ /**
15
+ * Derive the per-request bucket key. Default keys on the resolved api-key /
16
+ * user id (falling back to "anonymous") — correct for the authenticated data
17
+ * plane. Pass `clientIpKey` for UNAUTHENTICATED surfaces (e.g. the first-admin
18
+ * sign-up gate) where every request would otherwise collapse onto the single
19
+ * "anonymous" bucket and let one attacker exhaust the budget for everyone.
20
+ */
21
+ keyFn?: (c: Context<AppEnv>) => string;
22
+ /**
23
+ * The middleware no-ops under `NODE_ENV=test` by default so the suite isn't
24
+ * throttled. Set `false` to keep it ACTIVE in tests — required to assert the
25
+ * unauthenticated sign-up limiter actually returns 429 past the threshold.
26
+ */
27
+ disableInTest?: boolean;
28
+ }
29
+ /** Bucket key for unauthenticated, IP-scoped surfaces (e.g. sign-up). */
30
+ export declare function clientIpKey(c: Context<AppEnv>): string;
31
+ /**
32
+ * Bucket key for the browser-reachable ingest surface (the routes behind
33
+ * `requirePublishableOrIngest`). Runs AFTER that guard, so `apiKey` is set.
34
+ *
35
+ * - Secret key: one bucket per key. A secret key is one server integration.
36
+ * - Publishable (pk_) key: one bucket per key PER CLIENT IP. A pk_ key is
37
+ * public and shared by every visitor of the site, so a per-key bucket
38
+ * would 429 the whole site once its aggregate traffic crossed the limit,
39
+ * and would let one client holding the (public) key exhaust everyone's
40
+ * budget.
41
+ * - No resolved key (not reachable behind the guard): client IP, so a
42
+ * misordered mount still never collapses onto one shared bucket.
43
+ */
44
+ export declare function ingestRateLimitKey(c: Context<AppEnv>): string;
45
+ /**
46
+ * Build a sliding-window rate-limit middleware.
47
+ *
48
+ * Each instance owns an isolated in-memory fallback store (keyed by `prefix`)
49
+ * and a distinct Redis key namespace, so two middlewares with different
50
+ * prefixes (e.g. "ratelimit" vs "ratelimit:emails") never share a budget —
51
+ * an email send must not consume the contact-upsert sliding window.
52
+ *
53
+ * Headers, on every limited response (allowed or 429):
54
+ * - `RateLimit-Limit` / `RateLimit-Remaining` / `RateLimit-Reset` /
55
+ * `RateLimit-Policy` (IETF draft-ietf-httpapi-ratelimit-headers, the
56
+ * separate-header form). `RateLimit-Reset` is the seconds until the window
57
+ * frees the next unit; `RateLimit-Policy` is `<max>;w=<window seconds>`.
58
+ * - `X-RateLimit-Limit` / `X-RateLimit-Remaining`, kept for existing readers.
59
+ * - `Retry-After` (seconds) on a 429 only: when the next request is accepted.
60
+ *
61
+ * An instance counts a request at most ONCE, however many matching `use`
62
+ * registrations reach it. Hono runs every matching `use`, and a `/<prefix>/*`
63
+ * pattern also matches the bare `/<prefix>`, so the same instance mounted on
64
+ * overlapping patterns would otherwise log two entries per request and halve
65
+ * the effective budget.
66
+ */
67
+ export declare function createRateLimit(opts?: RateLimitOptions): import("hono").MiddlewareHandler<AppEnv, string, {}, Response>;
68
+ export declare const rateLimit: import("hono").MiddlewareHandler<AppEnv, string, {}, Response>;
69
+ /**
70
+ * Data-plane budget defaults. `env.ts` declares the matching variables as
71
+ * optional so these stay the one place the numbers live.
72
+ *
73
+ * - Secret key on the ingest routes: 3000/min (50 req/s sustained). A secret
74
+ * key is usually one backend forwarding every user's events, and there is no
75
+ * batch event endpoint, so the budget has to cover a busy production app; it
76
+ * still stops a runaway loop well before it saturates an API instance.
77
+ * - Publishable key on the ingest routes: 1000/min per client IP. A browser on
78
+ * `@hogsend/js` makes a few requests a minute (one per captured event, plus a
79
+ * feed poll every 12s), so this leaves room for many visitors behind one
80
+ * office or carrier NAT while capping a single client that holds the public
81
+ * key.
82
+ * - `/v1/emails`: 30/min per key (unchanged). A loop sending more than that is
83
+ * almost certainly a runaway.
84
+ */
85
+ export declare const DEFAULT_INGEST_RATE_LIMIT_MAX = 3000;
86
+ export declare const DEFAULT_INGEST_PUBLIC_RATE_LIMIT_MAX = 1000;
87
+ export declare const DEFAULT_INGEST_RATE_LIMIT_WINDOW_MS = 60000;
88
+ export declare const DEFAULT_EMAIL_RATE_LIMIT_MAX = 30;
89
+ export interface IngestRateLimitOptions {
90
+ /** Requests per window per secret key. */
91
+ max?: number;
92
+ /** Requests per window per publishable key per client IP. */
93
+ publicMax?: number;
94
+ windowMs?: number;
95
+ disableInTest?: boolean;
96
+ }
97
+ /**
98
+ * The rate limit for the browser-reachable ingest routes. Two isolated budgets
99
+ * (own prefixes, so neither shares a window with `/v1/emails` or the admin
100
+ * plane), picked by the key class `requirePublishableOrIngest` resolved. Mount
101
+ * it AFTER that guard: the bucket key and the budget both read what the guard
102
+ * set (`apiKey`, `publishable`).
103
+ */
104
+ export declare function createIngestRateLimit(opts?: IngestRateLimitOptions): import("hono").MiddlewareHandler<AppEnv, string, {}, Response>;
105
+ //# sourceMappingURL=rate-limit.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"rate-limit.d.ts","sourceRoot":"","sources":["../../src/middleware/rate-limit.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAEpC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAQxC;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB,yJAQrB,CAAC;AAEX,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;;;OAMG;IACH,KAAK,CAAC,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,KAAK,MAAM,CAAC;IACvC;;;;OAIG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAeD,yEAAyE;AACzE,wBAAgB,WAAW,CAAC,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,GAAG,MAAM,CAEtD;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,GAAG,MAAM,CAK7D;AA4BD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,eAAe,CAAC,IAAI,GAAE,gBAAqB,kEA6F1D;AAED,eAAO,MAAM,SAAS,gEAAoB,CAAC;AAE3C;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,6BAA6B,OAAO,CAAC;AAClD,eAAO,MAAM,oCAAoC,OAAO,CAAC;AACzD,eAAO,MAAM,mCAAmC,QAAS,CAAC;AAC1D,eAAO,MAAM,4BAA4B,KAAK,CAAC;AAE/C,MAAM,WAAW,sBAAsB;IACrC,0CAA0C;IAC1C,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,6DAA6D;IAC7D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,GAAE,sBAA2B,kEAmBtE"}
@@ -0,0 +1,4 @@
1
+ import type { MiddlewareHandler } from "hono";
2
+ import type { AppEnv } from "../app.js";
3
+ export declare const requestLogger: MiddlewareHandler<AppEnv>;
4
+ //# sourceMappingURL=request-logger.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"request-logger.d.ts","sourceRoot":"","sources":["../../src/middleware/request-logger.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,MAAM,CAAC;AAC9C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAExC,eAAO,MAAM,aAAa,EAAE,iBAAiB,CAAC,MAAM,CAenD,CAAC"}
@@ -0,0 +1,3 @@
1
+ import type { AppEnv } from "../app.js";
2
+ export declare const requireAdmin: import("hono").MiddlewareHandler<AppEnv, string, {}, Response>;
3
+ //# sourceMappingURL=require-admin.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"require-admin.d.ts","sourceRoot":"","sources":["../../src/middleware/require-admin.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AASxC,eAAO,MAAM,YAAY,gEA4CvB,CAAC"}
@@ -0,0 +1,52 @@
1
+ import type { Context } from "hono";
2
+ /**
3
+ * The data-plane identity guard shared by `/v1/contacts`, `/v1/events`,
4
+ * `/v1/emails`, and `/v1/lists`: a request must carry at least one resolvable
5
+ * identity key. Returns the 400 JSON response when BOTH keys are absent (so the
6
+ * caller can `return guard;`), or `null` to proceed.
7
+ *
8
+ * `/v1/emails` names its recipient field `to` rather than `email`; pass
9
+ * `{ field: "to" }` so the 400 message matches that route's wording exactly.
10
+ */
11
+ export declare function requireIdentity(c: Context, identity: {
12
+ email?: string;
13
+ userId?: string;
14
+ }, opts?: {
15
+ field?: "email" | "to";
16
+ }): (Response & import("hono").TypedResponse<{
17
+ error: string;
18
+ }, 400, "json">) | null;
19
+ /**
20
+ * The publishable-key identity gate, shared by every browser-reachable handler
21
+ * (events ingest, contacts upsert, list subscribe/unsubscribe).
22
+ *
23
+ * - SECRET key (`!c.get("publishable")`): defers to the UNCHANGED
24
+ * `requireIdentity` — identical 400 wording, identical behavior.
25
+ *
26
+ * - PUBLISHABLE key: a token-less pk_ key may act ONLY on its own anon id.
27
+ * - No claimed identity (`email`/`userId` both absent) → allowed (the
28
+ * secure anon-only default). Returns `null`.
29
+ * - A claimed identity REQUIRES a verified `userToken` proving the
30
+ * `userId`. Reject with 403 when: no `userToken`; `email` is asserted
31
+ * (no email arm exists in v1 — a token only binds a userId); or the
32
+ * token's `userId` does not match the claimed `userId`.
33
+ *
34
+ * Returns a `Response` to `return`, or `null` to proceed.
35
+ */
36
+ export declare function gatePublishableIdentity(c: Context, body: {
37
+ email?: string;
38
+ userId?: string;
39
+ userToken?: string;
40
+ }, secret: string, opts?: {
41
+ field?: "email" | "to";
42
+ }): (Response & import("hono").TypedResponse<{
43
+ error: string;
44
+ }, 400, "json">) | (Response & import("hono").TypedResponse<{
45
+ error: string;
46
+ }, 403, "json">) | null;
47
+ /**
48
+ * Extract a human-readable message from an `applyListMembership` failure,
49
+ * matching the wording every data-plane route used inline.
50
+ */
51
+ export declare function listMembershipError(err: unknown): string;
52
+ //# sourceMappingURL=_shared.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"_shared.d.ts","sourceRoot":"","sources":["../../src/routes/_shared.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAGpC;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAC7B,CAAC,EAAE,OAAO,EACV,QAAQ,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,EAC7C,IAAI,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,OAAO,GAAG,IAAI,CAAA;CAAE;;wBAOlC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,uBAAuB,CACrC,CAAC,EAAE,OAAO,EACV,IAAI,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,EAC7D,MAAM,EAAE,MAAM,EACd,IAAI,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,OAAO,GAAG,IAAI,CAAA;CAAE;;;;wBAqClC;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAExD"}
@@ -0,0 +1,18 @@
1
+ import { type OpenAPIHono } from "@hono/zod-openapi";
2
+ import type { AppEnv } from "../../app.js";
3
+ /**
4
+ * `GET /v1/accounts/:provider/callback` — the ONE place in the whole feature
5
+ * where a link may MOVE (DECISIONS §6.1). Everything else — the import path,
6
+ * the SDK, the manage page — is structurally unable to displace a live owner,
7
+ * because only this route ever passes `allowDisplaceLiveOwner: true`, and only
8
+ * on the WARM path.
9
+ *
10
+ * The order below mirrors `routes/connectors/index.ts:100-159` step for step,
11
+ * because that dispatcher's hardening is the thing being reused rather than
12
+ * re-derived: verify BEFORE dispatching, reject a cross-surface state, burn the
13
+ * nonce single-use. The two deliberate divergences are commented at their
14
+ * sites: a null Redis REFUSES here (fail closed), and the contact side of the
15
+ * link is decided here rather than by the store.
16
+ */
17
+ export declare function registerAccountLinkCallbackRoute(router: OpenAPIHono<AppEnv>): void;
18
+ //# sourceMappingURL=callback.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"callback.d.ts","sourceRoot":"","sources":["../../../src/routes/accounts/callback.ts"],"names":[],"mappings":"AAMA,OAAO,EAAe,KAAK,WAAW,EAAK,MAAM,mBAAmB,CAAC;AAErE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAwB3C;;;;;;;;;;;;;GAaG;AAEH,wBAAgB,gCAAgC,CAAC,MAAM,EAAE,WAAW,CAAC,MAAM,CAAC,QAob3E"}