@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
@@ -4,6 +4,7 @@ import {
4
4
  ALL_IDENTITY_KINDS,
5
5
  findContacts,
6
6
  PublishableAnonymousMergeError,
7
+ projectPublicContact,
7
8
  resolveContact,
8
9
  resolveOrCreateContact,
9
10
  serializeContact,
@@ -17,6 +18,7 @@ import {
17
18
  listMembershipError,
18
19
  requireIdentity,
19
20
  } from "../_shared.js";
21
+ import { resolveFeedRecipient } from "../feed/recipient.js";
20
22
 
21
23
  // The public, serialized contact shape (§2.5). `externalId` is nullable (D1 —
22
24
  // email-only / anonymous contacts) and timestamps are ISO strings.
@@ -128,6 +130,58 @@ const findRoute = createRoute({
128
130
  },
129
131
  });
130
132
 
133
+ // ---------------------------------------------------------------------------
134
+ // GET /v1/contacts/me — the BROWSER read of the identified contact's traits
135
+ // (publishable OR secret-ingest tier; guarded as a LITERAL in routes/index.ts).
136
+ // Identity is recipient-scoped SERVER-SIDE via `resolveFeedRecipient`, the same
137
+ // leak boundary as `GET /v1/flags` and the in-app feed: a userToken-verified
138
+ // userId, a secret key's trusted userId/email, or a publishable caller's OWN
139
+ // anon id (a pk_ `anonymousId` colliding with an IDENTIFIED contact's canonical
140
+ // key is rejected 403). A request-supplied contact key is NEVER honored.
141
+ //
142
+ // What comes back is an operator ALLOWLIST projection, not the contact row: only
143
+ // exact `contacts.publicProperties` keys, plus `email` when `exposeEmail`. The
144
+ // default config is empty, so a deploy that configures nothing exposes nothing.
145
+ // No contact / empty allowlist answers 200 `{ identified: false, traits: {} }` —
146
+ // never 404, so the response does not confirm whether a contact exists.
147
+ // ---------------------------------------------------------------------------
148
+ const meQuerySchema = z.object({
149
+ userToken: z.string().optional(),
150
+ anonymousId: z.string().optional(),
151
+ userId: z.string().optional(),
152
+ email: z.string().optional(),
153
+ });
154
+
155
+ const publicContactSchema = z.object({
156
+ identified: z.boolean(),
157
+ traits: z.record(z.string(), z.unknown()),
158
+ email: z.string().nullable().optional(),
159
+ });
160
+
161
+ const meRoute = createRoute({
162
+ method: "get",
163
+ path: "/me",
164
+ tags: ["Contacts"],
165
+ summary: "Read the resolved recipient's public traits",
166
+ description:
167
+ "Recipient-scoped server-side. Returns only the operator-allowlisted contact properties (client option `contacts.publicProperties`), plus the email when `contacts.exposeEmail` is on. Empty allowlist or no contact returns an empty projection, never 404.",
168
+ request: { query: meQuerySchema },
169
+ responses: {
170
+ 200: {
171
+ content: { "application/json": { schema: publicContactSchema } },
172
+ description: "The recipient's allowlisted traits",
173
+ },
174
+ 400: {
175
+ content: { "application/json": { schema: errorSchema } },
176
+ description: "Missing identity",
177
+ },
178
+ 403: {
179
+ content: { "application/json": { schema: errorSchema } },
180
+ description: "Invalid userToken or non-addressable anonymousId",
181
+ },
182
+ },
183
+ });
184
+
131
185
  const deleteRoute = createRoute({
132
186
  method: "delete",
133
187
  path: "/",
@@ -275,6 +329,30 @@ export const contactsRouter = new OpenAPIHono<AppEnv>()
275
329
 
276
330
  return c.json({ contacts: rows.map((row) => serializeContact(row)) }, 200);
277
331
  })
332
+ .openapi(meRoute, async (c) => {
333
+ const { db, contactsConfig } = c.get("container");
334
+ const query = c.req.valid("query");
335
+ const rec = await resolveFeedRecipient(c, query);
336
+ if (!rec.ok) return c.json({ error: rec.error }, rec.status);
337
+ // `resolveFeedRecipient` already did the trust work; the only remaining
338
+ // read is the row it pinned. No `contactId` means no contact exists for
339
+ // this recipient yet, which projects to the same empty answer as a
340
+ // configured-closed allowlist.
341
+ const row = rec.contactId
342
+ ? await resolveContact({ db, id: rec.contactId })
343
+ : null;
344
+ // pk_ is ANON-ONLY; identity is a server-minted userToken. On the token-less
345
+ // publishable arm the resolver pins whatever live row holds this browser's
346
+ // anon id in its `anonymous_id` COLUMN — and that row may be an IDENTIFIED
347
+ // contact (a server-side stitch, or a pre-logout id that leaked), because
348
+ // `collidesWithIdentified` only rejects a value that IS a canonical key.
349
+ // Flags tolerate that (booleans); traits are PII, so an identified row is
350
+ // only readable through a token (or a secret key). Project it as empty.
351
+ const tokenless = c.get("publishable") === true && !query.userToken;
352
+ const identifiedRow = Boolean(row && (row.externalId || row.email));
353
+ const visible = tokenless && identifiedRow ? null : row;
354
+ return c.json(projectPublicContact(visible, contactsConfig), 200);
355
+ })
278
356
  .openapi(deleteRoute, async (c) => {
279
357
  const { db, hatchet, logger } = c.get("container");
280
358
  const { email, userId } = c.req.valid("json");
@@ -1,9 +1,14 @@
1
1
  import { OpenAPIHono } from "@hono/zod-openapi";
2
+ import { createMiddleware } from "hono/factory";
2
3
  import type { AppEnv } from "../app.js";
3
4
  import type { HogsendClient } from "../container.js";
4
5
  import { requireApiKey, requireScope } from "../middleware/api-key.js";
5
6
  import { requirePublishableOrIngest } from "../middleware/publishable-key.js";
6
- import { createRateLimit } from "../middleware/rate-limit.js";
7
+ import {
8
+ createIngestRateLimit,
9
+ createRateLimit,
10
+ DEFAULT_EMAIL_RATE_LIMIT_MAX,
11
+ } from "../middleware/rate-limit.js";
7
12
  import { createAccountsRouter } from "./accounts/index.js";
8
13
  import { adminRouter } from "./admin/index.js";
9
14
  import { campaignsRouter } from "./campaigns/index.js";
@@ -17,6 +22,7 @@ import { flagsRouter } from "./flags/index.js";
17
22
  import { groupsRouter } from "./groups/index.js";
18
23
  import { healthRouter } from "./health.js";
19
24
  import { listsRouter } from "./lists/index.js";
25
+ import { createReferralsRouter } from "./referrals/index.js";
20
26
  import { createSnippetRouter } from "./snippet.js";
21
27
  import { trackingRouter } from "./tracking/index.js";
22
28
  import { shortLinkRouter } from "./tracking/short.js";
@@ -27,13 +33,6 @@ export interface RegisterRoutesOptions {
27
33
  container: HogsendClient;
28
34
  }
29
35
 
30
- // Conservative per-key email budget. `/v1/emails` MUST use a distinct prefix so
31
- // transactional sends don't share the sliding-window budget with contact
32
- // upserts / event ingest (open risk #15). 30/min/key is well under the
33
- // contact-upsert default (100/min) — an integration loop sending more than that
34
- // is almost certainly a runaway.
35
- const EMAIL_RATE_LIMIT_MAX = 30;
36
-
37
36
  export function registerRoutes(
38
37
  app: OpenAPIHono<AppEnv>,
39
38
  opts: RegisterRoutesOptions,
@@ -56,9 +55,52 @@ export function registerRoutes(
56
55
  // Both the bare path and its `/*` subtree are covered (Hono treats them as
57
56
  // distinct match patterns). `/emails` layers the per-key email rate-limit on
58
57
  // top, in strict order auth → scope → rateLimit.
58
+ //
59
+ // Conservative per-key email budget (`EMAIL_RATE_LIMIT_MAX`, default 30/min).
60
+ // `/v1/emails` MUST use a distinct prefix so transactional sends don't share
61
+ // the sliding-window budget with contact upserts / event ingest (open risk
62
+ // #15). An integration loop sending more than that is almost certainly a
63
+ // runaway.
64
+ const { env } = opts.container;
59
65
  const emailRateLimit = createRateLimit({
60
66
  prefix: "ratelimit:emails",
61
- max: EMAIL_RATE_LIMIT_MAX,
67
+ max: env.EMAIL_RATE_LIMIT_MAX ?? DEFAULT_EMAIL_RATE_LIMIT_MAX,
68
+ });
69
+
70
+ // The browser-reachable ingest budget: per secret key, and per publishable
71
+ // key per client IP (`INGEST_RATE_LIMIT_MAX`, `INGEST_PUBLIC_RATE_LIMIT_MAX`,
72
+ // `INGEST_RATE_LIMIT_WINDOW_MS`; defaults in middleware/rate-limit.ts).
73
+ //
74
+ // It is COMPOSED INTO the guard rather than registered as its own `use`, so
75
+ // every path below keeps exactly one middleware that runs auth → scope →
76
+ // rateLimit in that order, and the method-branching guards (`/contacts`,
77
+ // `/accounts/:provider/:providerUserId`) keep branching: the limit lands only
78
+ // on the branch that hands off to the publishable-or-ingest guard. DELETE
79
+ // `/contacts` stays secret-only and unlimited, like the other secret
80
+ // prefixes. A 401/403 from the guard never reaches the limiter, so a request
81
+ // that fails auth spends no budget.
82
+ //
83
+ // Several patterns below match the same request (`/feed` + `/feed/*` both
84
+ // match `GET /v1/feed`; `/accounts/me/revoke` + the param branch both match
85
+ // the revoke). `createRateLimit` counts a request once per instance, so the
86
+ // overlap costs one unit, not two.
87
+ const ingestRateLimit = createIngestRateLimit({
88
+ max: env.INGEST_RATE_LIMIT_MAX,
89
+ publicMax: env.INGEST_PUBLIC_RATE_LIMIT_MAX,
90
+ windowMs: env.INGEST_RATE_LIMIT_WINDOW_MS,
91
+ });
92
+ const publishableOrIngest = createMiddleware<AppEnv>(async (c, next) => {
93
+ // The guard returns its own 401/403, or calls the inner function on
94
+ // success. The limiter's 429 comes back through that inner call, which
95
+ // the guard does not propagate (its `return next()` returns this inner
96
+ // function's void), so capture it here — the flag idiom of the
97
+ // `/contacts` DELETE branch below.
98
+ let limited: Response | undefined;
99
+ const res = await requirePublishableOrIngest(c, async () => {
100
+ const out = await ingestRateLimit(c, next);
101
+ if (out instanceof Response) limited = out;
102
+ });
103
+ return limited ?? res;
62
104
  });
63
105
 
64
106
  // ---- Browser-reachable subset (publishable OR secret-ingest) ----
@@ -66,28 +108,30 @@ export function registerRoutes(
66
108
  // win Hono's match order. `requirePublishableOrIngest` accepts EITHER a
67
109
  // secret ingest-scoped key (unchanged) OR a pk_/ingest-public key (Origin-
68
110
  // allowlisted, fail-closed). Everything NOT listed here stays secret-only.
111
+ // `publishableOrIngest` is that guard with the ingest rate limit behind it
112
+ // (defined above); every browser-reachable path in this file uses it.
69
113
  //
70
114
  // `/events` has no subtree (only `POST /`), so the bare pattern is complete.
71
- v1.use("/events", requirePublishableOrIngest);
115
+ v1.use("/events", publishableOrIngest);
72
116
  // `/lists` catalog + the new static `/preferences` read + subscribe/unsub.
73
- v1.use("/lists", requirePublishableOrIngest);
74
- v1.use("/lists/preferences", requirePublishableOrIngest);
75
- v1.use("/lists/:id/subscribe", requirePublishableOrIngest);
76
- v1.use("/lists/:id/unsubscribe", requirePublishableOrIngest);
117
+ v1.use("/lists", publishableOrIngest);
118
+ v1.use("/lists/preferences", publishableOrIngest);
119
+ v1.use("/lists/:id/subscribe", publishableOrIngest);
120
+ v1.use("/lists/:id/unsubscribe", publishableOrIngest);
77
121
  // Feed: `GET /feed` list/stream + `POST /feed/mark`/`mark-all` — publishable OR
78
122
  // secret. Both the bare `/feed` (GET list) and the `/feed/*` subtree
79
123
  // (mark/mark-all/stream) are covered (Hono treats them as distinct patterns).
80
124
  // Recipient scoping is enforced server-side in `resolveFeedRecipient`, never
81
125
  // from the request.
82
- v1.use("/feed", requirePublishableOrIngest);
83
- v1.use("/feed/*", requirePublishableOrIngest);
126
+ v1.use("/feed", publishableOrIngest);
127
+ v1.use("/feed/*", publishableOrIngest);
84
128
  // Flags: `GET /v1/flags` is the BROWSER read (publishable OR secret-ingest).
85
129
  // Only the bare `/flags` pattern is browser-reachable; the `/flags/evaluate`
86
130
  // subtree is secret-only (guarded in the secret section below). Because a
87
131
  // bare `use("/flags")` matches ONLY the exact path (not the subtree), the two
88
132
  // tiers never overlap. Recipient scoping is server-side in
89
133
  // `resolveFeedRecipient`, never from the request.
90
- v1.use("/flags", requirePublishableOrIngest);
134
+ v1.use("/flags", publishableOrIngest);
91
135
  // Bare `/contacts` is dual-purpose: PUT/POST = the publishable upsert;
92
136
  // DELETE = secret-only. Hono runs ALL matching `use`s, so a single guard must
93
137
  // branch by method rather than stacking two guards (which would 403 a valid
@@ -96,7 +140,7 @@ export function registerRoutes(
96
140
  const contactsDeleteGuard = requireScope("ingest");
97
141
  v1.use("/contacts", async (c, next) => {
98
142
  if (c.req.method !== "DELETE") {
99
- return requirePublishableOrIngest(c, next);
143
+ return publishableOrIngest(c, next);
100
144
  }
101
145
  // DELETE is secret-only: chain `requireApiKey` then `requireScope("ingest")`
102
146
  // exactly as the secret prefix loop does. `requireApiKey` only runs its
@@ -138,6 +182,13 @@ export function registerRoutes(
138
182
  v1.use(`${base}/*`, requireApiKey, requireScope("ingest"));
139
183
  }
140
184
  v1.use("/contacts/find", requireApiKey, requireScope("ingest"));
185
+ // `GET /v1/contacts/me` is the BROWSER read of the allowlisted contact
186
+ // projection — publishable OR secret-ingest, exactly like `GET /v1/flags`.
187
+ // Registered as a LITERAL for the reason spelled out above: a
188
+ // `/contacts/*` wildcard would ALSO match the bare `/contacts` upsert and
189
+ // re-run on top of its method-branch guard. Identity is resolved
190
+ // server-side inside the handler, so this guard only sets the key tier.
191
+ v1.use("/contacts/me", publishableOrIngest);
141
192
  // `POST /v1/flags/evaluate` is the SERVER SDK read — secret-only, exactly like
142
193
  // the other secret data-plane routes. The bare `/flags` (browser GET) is
143
194
  // guarded separately above; guard ONLY the `/evaluate` path here so the two
@@ -164,9 +215,9 @@ export function registerRoutes(
164
215
  // `userToken`-gated INSIDE its handler. Both `/me` entries are enumerated
165
216
  // rather than written `/accounts/me/*`: the wildcard trap applies at every
166
217
  // depth.
167
- v1.use("/accounts/me", requirePublishableOrIngest);
168
- v1.use("/accounts/me/revoke", requirePublishableOrIngest);
169
- v1.use("/accounts/link-url", requirePublishableOrIngest);
218
+ v1.use("/accounts/me", publishableOrIngest);
219
+ v1.use("/accounts/me/revoke", publishableOrIngest);
220
+ v1.use("/accounts/link-url", publishableOrIngest);
170
221
  // Tier 2 — secret-only literals, in the style of `/contacts/find` and
171
222
  // `/flags/evaluate` above. `accounts` is an ORTHOGONAL scope
172
223
  // (`middleware/api-key.ts:35-40`): an explicit grant or `full-admin`, and no
@@ -208,7 +259,7 @@ export function registerRoutes(
208
259
  // method-gated: the literal is POST-only, so a DELETE on this same shape
209
260
  // would otherwise reach the operator unlink holding only a `pk_` key.
210
261
  if (method === "POST" && provider === "me" && second === "revoke") {
211
- return requirePublishableOrIngest(c, next);
262
+ return publishableOrIngest(c, next);
212
263
  }
213
264
  // Everything else on this shape is the operator reverse lookup / unlink.
214
265
  // `requireApiKey` only runs its `next` on a successful auth, so use a flag
@@ -224,6 +275,37 @@ export function registerRoutes(
224
275
 
225
276
  v1.route("/accounts", createAccountsRouter());
226
277
 
278
+ // ---- Referrals (PRD 05 §7.2) ----
279
+ //
280
+ // TWO TIERS on one prefix, every path enumerated EXPLICITLY. There is
281
+ // deliberately NO `/referrals/*` catch-all: a `/<prefix>/*` `use` in Hono
282
+ // also matches the bare `/<prefix>` path AND every literal sibling, so one
283
+ // would 401 the browser-reachable `/referrals/me`, the same trap documented
284
+ // for `/contacts/*`, `/lists/*` and `/accounts/*` above.
285
+ //
286
+ // Tier 1: the browser-reachable literal, `userToken`-gated INSIDE its
287
+ // handler and non-confirming on every token failure.
288
+ v1.use("/referrals/me", publishableOrIngest);
289
+ // Tier 2: secret-only. `referrals` is an ORTHOGONAL scope exactly like
290
+ // `accounts`: an explicit grant or `full-admin`, and no SCOPE_HIERARCHY edit
291
+ // (`middleware/api-key.ts` `hasScope`). A `pk_` key holds only
292
+ // `["ingest-public"]`, so it 403s here rather than escalating.
293
+ //
294
+ // `/tree/*` is the ONLY parameterised path and it is GET-only, so it needs no
295
+ // method branch: nothing browser-reachable lives under it, unlike the
296
+ // `/accounts/:provider/:providerUserId` shape.
297
+ for (const path of [
298
+ "/referrals",
299
+ "/referrals/report",
300
+ "/referrals/touch",
301
+ "/referrals/import",
302
+ "/referrals/tree/*",
303
+ ]) {
304
+ v1.use(path, requireApiKey, requireScope("referrals"));
305
+ }
306
+
307
+ v1.route("/referrals", createReferralsRouter());
308
+
227
309
  v1.route("/contacts", contactsRouter);
228
310
  v1.route("/events", eventsRouter);
229
311
  v1.route("/feed", feedRouter);
@@ -0,0 +1,41 @@
1
+ import { OpenAPIHono } from "@hono/zod-openapi";
2
+ import type { AppEnv } from "../../app.js";
3
+ import { registerReferralMeRoute } from "./me.js";
4
+ import {
5
+ registerReferralReportRoute,
6
+ registerReferralTreeRoute,
7
+ } from "./report.js";
8
+ import {
9
+ registerReferralImportRoute,
10
+ registerReferralTouchRoute,
11
+ } from "./touch.js";
12
+
13
+ /**
14
+ * The `/v1/referrals/*` router (PRD 05 §7.2). TWO TIERS on one prefix:
15
+ *
16
+ * - `/me` is browser-reachable (publishable OR secret-ingest) and gated INSIDE
17
+ * its handler by a server-minted `userToken`;
18
+ * - `/report`, `/tree/:contactId`, `/touch` and `/import` are secret-key only
19
+ * under the ORTHOGONAL `referrals` scope.
20
+ *
21
+ * The guards live in `routes/index.ts` and BRANCH rather than stack, for the
22
+ * reason `routes/accounts/index.ts` documents at length: Hono runs EVERY
23
+ * matching `use` and `route("/v1", v1)` flattens the middleware, so a blanket
24
+ * `/referrals/*` guard would 401 the browser `/me` route. This router
25
+ * re-applies NO auth of its own.
26
+ *
27
+ * Registration order is LITERALS FIRST. `/me` is a literal and `/tree/{...}`
28
+ * is the only parameterised path, so they cannot collide today - but the order
29
+ * is kept explicit so a future `/referrals/{id}` cannot capture `/me`.
30
+ */
31
+ export function createReferralsRouter(): OpenAPIHono<AppEnv> {
32
+ const router = new OpenAPIHono<AppEnv>();
33
+
34
+ registerReferralMeRoute(router);
35
+ registerReferralReportRoute(router);
36
+ registerReferralTouchRoute(router);
37
+ registerReferralImportRoute(router);
38
+ registerReferralTreeRoute(router);
39
+
40
+ return router;
41
+ }
@@ -0,0 +1,123 @@
1
+ import { referralTouches } from "@hogsend/db";
2
+ import { createRoute, type OpenAPIHono, z } from "@hono/zod-openapi";
3
+ import { and, eq, sql } from "drizzle-orm";
4
+ import type { AppEnv } from "../../app.js";
5
+ import { getReferralLink } from "../../lib/referral-link.js";
6
+ import {
7
+ InvalidUserTokenError,
8
+ verifyUserToken,
9
+ } from "../../lib/user-token.js";
10
+ import { resolveTokenContactId } from "../accounts/resolve.js";
11
+ import { referralIdQuery, resolveReferralId } from "./shared.js";
12
+
13
+ /**
14
+ * `GET /v1/referrals/me` (PRD 05 §7.2) - the CALLER's own share link and
15
+ * counts, `userToken`-gated, and NON-CONFIRMING exactly like
16
+ * `GET /v1/accounts/me` (DECISIONS §6.9).
17
+ *
18
+ * An absent, malformed, expired or forged token takes the SAME code path as
19
+ * "no referral is registered": `200 { link: null, stats: null }`. Anything else
20
+ * would let a caller enumerate which of a customer's users exist.
21
+ *
22
+ * The mint is LAZY and idempotent: a signed-in user who has never shared gets a
23
+ * link on first ask, and `getReferralLink` recovers it on every ask after.
24
+ */
25
+
26
+ const meRoute = createRoute({
27
+ method: "get",
28
+ path: "/me",
29
+ tags: ["Referrals"],
30
+ summary: "The signed-in user's referral link and counts",
31
+ description:
32
+ "Publishable OR secret key, plus a server-minted `userToken` in the query string. Mints the caller's shared link lazily (idempotent). NON-CONFIRMING: an absent, forged, expired or unknown-user token returns `200 { link: null, stats: null }`, byte-identical to a deploy with no referral registered.",
33
+ request: {
34
+ query: z.object({
35
+ userToken: z.string().optional(),
36
+ referral: referralIdQuery,
37
+ }),
38
+ },
39
+ responses: {
40
+ 200: {
41
+ content: {
42
+ "application/json": {
43
+ schema: z.object({
44
+ link: z
45
+ .object({ url: z.string(), slug: z.string().nullable() })
46
+ .nullable(),
47
+ stats: z
48
+ .object({
49
+ touched: z.number(),
50
+ bound: z.number(),
51
+ qualified: z.number(),
52
+ })
53
+ .nullable(),
54
+ }),
55
+ },
56
+ },
57
+ description: "The caller's link + counts, or two nulls",
58
+ },
59
+ },
60
+ });
61
+
62
+ const EMPTY = { link: null, stats: null } as const;
63
+
64
+ export function registerReferralMeRoute(router: OpenAPIHono<AppEnv>) {
65
+ router.openapi(meRoute, async (c) => {
66
+ const container = c.get("container");
67
+ const { db, env, referrals } = container;
68
+ const query = c.req.valid("query");
69
+ const referralId = resolveReferralId(query.referral);
70
+
71
+ if (!query.userToken) return c.json(EMPTY, 200);
72
+ if (!referrals.get(referralId)) return c.json(EMPTY, 200);
73
+
74
+ let contactId: string | null = null;
75
+ try {
76
+ const { userId } = verifyUserToken({
77
+ token: query.userToken,
78
+ secret: env.BETTER_AUTH_SECRET,
79
+ });
80
+ contactId = await resolveTokenContactId(db, userId);
81
+ } catch (err) {
82
+ if (!(err instanceof InvalidUserTokenError)) throw err;
83
+ contactId = null;
84
+ }
85
+ if (!contactId) return c.json(EMPTY, 200);
86
+
87
+ const link = await getReferralLink({
88
+ referral: referralId,
89
+ contactId,
90
+ container: {
91
+ db,
92
+ env: { API_PUBLIC_URL: env.API_PUBLIC_URL },
93
+ referrals,
94
+ },
95
+ });
96
+
97
+ const [counts] = await db
98
+ .select({
99
+ touched: sql<number>`count(*) filter (where ${referralTouches.status} <> 'rejected')::int`,
100
+ bound: sql<number>`count(*) filter (where ${referralTouches.status} in ('bound', 'qualified'))::int`,
101
+ qualified: sql<number>`count(*) filter (where ${referralTouches.status} = 'qualified')::int`,
102
+ })
103
+ .from(referralTouches)
104
+ .where(
105
+ and(
106
+ eq(referralTouches.referralId, referralId),
107
+ eq(referralTouches.referrerContactId, contactId),
108
+ ),
109
+ );
110
+
111
+ return c.json(
112
+ {
113
+ link: { url: link.url, slug: link.slug },
114
+ stats: {
115
+ touched: Number(counts?.touched ?? 0),
116
+ bound: Number(counts?.bound ?? 0),
117
+ qualified: Number(counts?.qualified ?? 0),
118
+ },
119
+ },
120
+ 200,
121
+ );
122
+ });
123
+ }