@hogsend/engine 0.67.0 → 0.68.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (738) hide show
  1. package/README.md +3 -2
  2. package/dist/account-links/__fixtures__/fake-fetch.d.ts +38 -0
  3. package/dist/account-links/__fixtures__/fake-fetch.d.ts.map +1 -0
  4. package/dist/account-links/battlenet.d.ts +36 -0
  5. package/dist/account-links/battlenet.d.ts.map +1 -0
  6. package/dist/account-links/epic.d.ts +36 -0
  7. package/dist/account-links/epic.d.ts.map +1 -0
  8. package/dist/account-links/index.d.ts +7 -0
  9. package/dist/account-links/index.d.ts.map +1 -0
  10. package/dist/account-links/riot.d.ts +35 -0
  11. package/dist/account-links/riot.d.ts.map +1 -0
  12. package/dist/account-links/steam.d.ts +35 -0
  13. package/dist/account-links/steam.d.ts.map +1 -0
  14. package/dist/account-links/twitch.d.ts +38 -0
  15. package/dist/account-links/twitch.d.ts.map +1 -0
  16. package/dist/account-links/xbox.d.ts +39 -0
  17. package/dist/account-links/xbox.d.ts.map +1 -0
  18. package/dist/app.d.ts +50 -0
  19. package/dist/app.d.ts.map +1 -0
  20. package/dist/buckets/bucket-access.d.ts +60 -0
  21. package/dist/buckets/bucket-access.d.ts.map +1 -0
  22. package/dist/buckets/bucket-reactions.d.ts +100 -0
  23. package/dist/buckets/bucket-reactions.d.ts.map +1 -0
  24. package/dist/buckets/check-membership.d.ts +105 -0
  25. package/dist/buckets/check-membership.d.ts.map +1 -0
  26. package/dist/buckets/define-bucket.d.ts +53 -0
  27. package/dist/buckets/define-bucket.d.ts.map +1 -0
  28. package/dist/buckets/membership-epoch.d.ts +74 -0
  29. package/dist/buckets/membership-epoch.d.ts.map +1 -0
  30. package/dist/buckets/registry-singleton.d.ts +6 -0
  31. package/dist/buckets/registry-singleton.d.ts.map +1 -0
  32. package/dist/buckets/registry.d.ts +59 -0
  33. package/dist/buckets/registry.d.ts.map +1 -0
  34. package/dist/campaigns/cohort-sql.d.ts +54 -0
  35. package/dist/campaigns/cohort-sql.d.ts.map +1 -0
  36. package/dist/campaigns/define-campaign.d.ts +105 -0
  37. package/dist/campaigns/define-campaign.d.ts.map +1 -0
  38. package/dist/campaigns/reconcile.d.ts +13 -0
  39. package/dist/campaigns/reconcile.d.ts.map +1 -0
  40. package/dist/campaigns/steps.d.ts +29 -0
  41. package/dist/campaigns/steps.d.ts.map +1 -0
  42. package/dist/cold-connect/index.d.ts +98 -0
  43. package/dist/cold-connect/index.d.ts.map +1 -0
  44. package/dist/cold-connect/page.d.ts +69 -0
  45. package/dist/cold-connect/page.d.ts.map +1 -0
  46. package/dist/cold-connect/throttle.d.ts +39 -0
  47. package/dist/cold-connect/throttle.d.ts.map +1 -0
  48. package/dist/cold-connect/token.d.ts +57 -0
  49. package/dist/cold-connect/token.d.ts.map +1 -0
  50. package/dist/connectors/action-registry-singleton.d.ts +21 -0
  51. package/dist/connectors/action-registry-singleton.d.ts.map +1 -0
  52. package/dist/connectors/define-action.d.ts +117 -0
  53. package/dist/connectors/define-action.d.ts.map +1 -0
  54. package/dist/connectors/define-connector.d.ts +172 -0
  55. package/dist/connectors/define-connector.d.ts.map +1 -0
  56. package/dist/connectors/presets/index.d.ts +17 -0
  57. package/dist/connectors/presets/index.d.ts.map +1 -0
  58. package/dist/connectors/registry-singleton.d.ts +34 -0
  59. package/dist/connectors/registry-singleton.d.ts.map +1 -0
  60. package/dist/connectors/runtime.d.ts +68 -0
  61. package/dist/connectors/runtime.d.ts.map +1 -0
  62. package/dist/container.d.ts +678 -0
  63. package/dist/container.d.ts.map +1 -0
  64. package/dist/destinations/define-destination.d.ts +96 -0
  65. package/dist/destinations/define-destination.d.ts.map +1 -0
  66. package/dist/destinations/presets/index.d.ts +42 -0
  67. package/dist/destinations/presets/index.d.ts.map +1 -0
  68. package/dist/destinations/presets/posthog.d.ts +12 -0
  69. package/dist/destinations/presets/posthog.d.ts.map +1 -0
  70. package/dist/destinations/presets/segment.d.ts +15 -0
  71. package/dist/destinations/presets/segment.d.ts.map +1 -0
  72. package/dist/destinations/presets/slack.d.ts +10 -0
  73. package/dist/destinations/presets/slack.d.ts.map +1 -0
  74. package/dist/destinations/presets/webhook.d.ts +14 -0
  75. package/dist/destinations/presets/webhook.d.ts.map +1 -0
  76. package/dist/destinations/registry-singleton.d.ts +44 -0
  77. package/dist/destinations/registry-singleton.d.ts.map +1 -0
  78. package/dist/env.d.ts +119 -0
  79. package/dist/env.d.ts.map +1 -0
  80. package/dist/flags/reconcile.d.ts +36 -0
  81. package/dist/flags/reconcile.d.ts.map +1 -0
  82. package/dist/index.d.ts +210 -0
  83. package/dist/index.d.ts.map +1 -0
  84. package/dist/journeys/authoring.d.ts +15 -0
  85. package/dist/journeys/authoring.d.ts.map +1 -0
  86. package/dist/journeys/client-defaults-singleton.d.ts +16 -0
  87. package/dist/journeys/client-defaults-singleton.d.ts.map +1 -0
  88. package/dist/journeys/constants.d.ts +32 -0
  89. package/dist/journeys/constants.d.ts.map +1 -0
  90. package/dist/journeys/define-journey.d.ts +33 -0
  91. package/dist/journeys/define-journey.d.ts.map +1 -0
  92. package/dist/journeys/durable-law-harness.d.ts +74 -0
  93. package/dist/journeys/durable-law-harness.d.ts.map +1 -0
  94. package/dist/journeys/errors.d.ts +13 -0
  95. package/dist/journeys/errors.d.ts.map +1 -0
  96. package/dist/journeys/execute-journey-run.d.ts +160 -0
  97. package/dist/journeys/execute-journey-run.d.ts.map +1 -0
  98. package/dist/journeys/graph/build-graph.d.ts +24 -0
  99. package/dist/journeys/graph/build-graph.d.ts.map +1 -0
  100. package/dist/journeys/group-scope.d.ts +56 -0
  101. package/dist/journeys/group-scope.d.ts.map +1 -0
  102. package/dist/journeys/journey-boundary.d.ts +264 -0
  103. package/dist/journeys/journey-boundary.d.ts.map +1 -0
  104. package/dist/journeys/journey-context.d.ts +60 -0
  105. package/dist/journeys/journey-context.d.ts.map +1 -0
  106. package/dist/journeys/journey-log.d.ts +42 -0
  107. package/dist/journeys/journey-log.d.ts.map +1 -0
  108. package/dist/journeys/journey-source-locations-singleton.d.ts +6 -0
  109. package/dist/journeys/journey-source-locations-singleton.d.ts.map +1 -0
  110. package/dist/journeys/journey-sources-singleton.d.ts +5 -0
  111. package/dist/journeys/journey-sources-singleton.d.ts.map +1 -0
  112. package/dist/journeys/journey-task-factory.d.ts +11 -0
  113. package/dist/journeys/journey-task-factory.d.ts.map +1 -0
  114. package/dist/journeys/journey-task-runtime.d.ts +2 -0
  115. package/dist/journeys/journey-task-runtime.d.ts.map +1 -0
  116. package/dist/journeys/journey-version.d.ts +71 -0
  117. package/dist/journeys/journey-version.d.ts.map +1 -0
  118. package/dist/journeys/record-once.d.ts +56 -0
  119. package/dist/journeys/record-once.d.ts.map +1 -0
  120. package/dist/journeys/registry-singleton.d.ts +6 -0
  121. package/dist/journeys/registry-singleton.d.ts.map +1 -0
  122. package/dist/journeys/registry.d.ts +59 -0
  123. package/dist/journeys/registry.d.ts.map +1 -0
  124. package/dist/journeys/with-durable-gate.d.ts +97 -0
  125. package/dist/journeys/with-durable-gate.d.ts.map +1 -0
  126. package/dist/lib/account-link-emit.d.ts +69 -0
  127. package/dist/lib/account-link-emit.d.ts.map +1 -0
  128. package/dist/lib/account-link-events.d.ts +128 -0
  129. package/dist/lib/account-link-events.d.ts.map +1 -0
  130. package/dist/lib/account-link-hooks.d.ts +32 -0
  131. package/dist/lib/account-link-hooks.d.ts.map +1 -0
  132. package/dist/lib/account-link-ingest.d.ts +78 -0
  133. package/dist/lib/account-link-ingest.d.ts.map +1 -0
  134. package/dist/lib/account-link-nonce.d.ts +29 -0
  135. package/dist/lib/account-link-nonce.d.ts.map +1 -0
  136. package/dist/lib/account-link-origins.d.ts +37 -0
  137. package/dist/lib/account-link-origins.d.ts.map +1 -0
  138. package/dist/lib/account-link-pkce.d.ts +48 -0
  139. package/dist/lib/account-link-pkce.d.ts.map +1 -0
  140. package/dist/lib/account-link-provider-registry.d.ts +35 -0
  141. package/dist/lib/account-link-provider-registry.d.ts.map +1 -0
  142. package/dist/lib/account-link-throttle.d.ts +76 -0
  143. package/dist/lib/account-link-throttle.d.ts.map +1 -0
  144. package/dist/lib/account-link-url.d.ts +41 -0
  145. package/dist/lib/account-link-url.d.ts.map +1 -0
  146. package/dist/lib/account-links-from-env.d.ts +62 -0
  147. package/dist/lib/account-links-from-env.d.ts.map +1 -0
  148. package/dist/lib/account-links.d.ts +353 -0
  149. package/dist/lib/account-links.d.ts.map +1 -0
  150. package/dist/lib/agent/config.d.ts +14 -0
  151. package/dist/lib/agent/config.d.ts.map +1 -0
  152. package/dist/lib/agent/proposals.d.ts +52 -0
  153. package/dist/lib/agent/proposals.d.ts.map +1 -0
  154. package/dist/lib/agent/provider.d.ts +9 -0
  155. package/dist/lib/agent/provider.d.ts.map +1 -0
  156. package/dist/lib/agent/risk.d.ts +24 -0
  157. package/dist/lib/agent/risk.d.ts.map +1 -0
  158. package/dist/lib/agent/system-prompt.d.ts +8 -0
  159. package/dist/lib/agent/system-prompt.d.ts.map +1 -0
  160. package/dist/lib/agent/tools.d.ts +258 -0
  161. package/dist/lib/agent/tools.d.ts.map +1 -0
  162. package/dist/lib/alerting.d.ts +7 -0
  163. package/dist/lib/alerting.d.ts.map +1 -0
  164. package/dist/lib/analytics-adapter.d.ts +24 -0
  165. package/dist/lib/analytics-adapter.d.ts.map +1 -0
  166. package/dist/lib/analytics-identity.d.ts +60 -0
  167. package/dist/lib/analytics-identity.d.ts.map +1 -0
  168. package/dist/lib/analytics-provider-registry.d.ts +20 -0
  169. package/dist/lib/analytics-provider-registry.d.ts.map +1 -0
  170. package/dist/lib/analytics-providers-from-env.d.ts +41 -0
  171. package/dist/lib/analytics-providers-from-env.d.ts.map +1 -0
  172. package/dist/lib/analytics-singleton.d.ts +10 -0
  173. package/dist/lib/analytics-singleton.d.ts.map +1 -0
  174. package/dist/lib/api-key-hash.d.ts +9 -0
  175. package/dist/lib/api-key-hash.d.ts.map +1 -0
  176. package/dist/lib/app-secret.d.ts +29 -0
  177. package/dist/lib/app-secret.d.ts.map +1 -0
  178. package/dist/lib/attachments.d.ts +53 -0
  179. package/dist/lib/attachments.d.ts.map +1 -0
  180. package/dist/lib/attribution-backfill.d.ts +48 -0
  181. package/dist/lib/attribution-backfill.d.ts.map +1 -0
  182. package/dist/lib/attribution.d.ts +44 -0
  183. package/dist/lib/attribution.d.ts.map +1 -0
  184. package/dist/lib/auth.d.ts +136 -0
  185. package/dist/lib/auth.d.ts.map +1 -0
  186. package/dist/lib/backfill.d.ts +41 -0
  187. package/dist/lib/backfill.d.ts.map +1 -0
  188. package/dist/lib/banner.d.ts +52 -0
  189. package/dist/lib/banner.d.ts.map +1 -0
  190. package/dist/lib/blueprint-lock.d.ts +19 -0
  191. package/dist/lib/blueprint-lock.d.ts.map +1 -0
  192. package/dist/lib/blueprints.d.ts +573 -0
  193. package/dist/lib/blueprints.d.ts.map +1 -0
  194. package/dist/lib/boot-api-key.d.ts +38 -0
  195. package/dist/lib/boot-api-key.d.ts.map +1 -0
  196. package/dist/lib/boot.d.ts +23 -0
  197. package/dist/lib/boot.d.ts.map +1 -0
  198. package/dist/lib/bootstrap-admin.d.ts +33 -0
  199. package/dist/lib/bootstrap-admin.d.ts.map +1 -0
  200. package/dist/lib/bot-prefetch.d.ts +21 -0
  201. package/dist/lib/bot-prefetch.d.ts.map +1 -0
  202. package/dist/lib/bucket-emit.d.ts +75 -0
  203. package/dist/lib/bucket-emit.d.ts.map +1 -0
  204. package/dist/lib/bucket-posthog-sync.d.ts +29 -0
  205. package/dist/lib/bucket-posthog-sync.d.ts.map +1 -0
  206. package/dist/lib/campaign-send-key.d.ts +31 -0
  207. package/dist/lib/campaign-send-key.d.ts.map +1 -0
  208. package/dist/lib/connector-actions.d.ts +83 -0
  209. package/dist/lib/connector-actions.d.ts.map +1 -0
  210. package/dist/lib/connector-heartbeat.d.ts +35 -0
  211. package/dist/lib/connector-heartbeat.d.ts.map +1 -0
  212. package/dist/lib/connector-link-codes.d.ts +105 -0
  213. package/dist/lib/connector-link-codes.d.ts.map +1 -0
  214. package/dist/lib/connector-state.d.ts +97 -0
  215. package/dist/lib/connector-state.d.ts.map +1 -0
  216. package/dist/lib/contacts.d.ts +622 -0
  217. package/dist/lib/contacts.d.ts.map +1 -0
  218. package/dist/lib/conversion-dispatch.d.ts +98 -0
  219. package/dist/lib/conversion-dispatch.d.ts.map +1 -0
  220. package/dist/lib/conversions.d.ts +75 -0
  221. package/dist/lib/conversions.d.ts.map +1 -0
  222. package/dist/lib/create-admin.d.ts +54 -0
  223. package/dist/lib/create-admin.d.ts.map +1 -0
  224. package/dist/lib/crm-deals.d.ts +66 -0
  225. package/dist/lib/crm-deals.d.ts.map +1 -0
  226. package/dist/lib/crm-ingest.d.ts +38 -0
  227. package/dist/lib/crm-ingest.d.ts.map +1 -0
  228. package/dist/lib/crm-provider-registry.d.ts +20 -0
  229. package/dist/lib/crm-provider-registry.d.ts.map +1 -0
  230. package/dist/lib/crm-registry-singleton.d.ts +18 -0
  231. package/dist/lib/crm-registry-singleton.d.ts.map +1 -0
  232. package/dist/lib/db.d.ts +3 -0
  233. package/dist/lib/db.d.ts.map +1 -0
  234. package/dist/lib/deal-money-events.d.ts +35 -0
  235. package/dist/lib/deal-money-events.d.ts.map +1 -0
  236. package/dist/lib/discord-gateway-heartbeat.d.ts +47 -0
  237. package/dist/lib/discord-gateway-heartbeat.d.ts.map +1 -0
  238. package/dist/lib/domain-status.d.ts +87 -0
  239. package/dist/lib/domain-status.d.ts.map +1 -0
  240. package/dist/lib/email-provider-registry.d.ts +30 -0
  241. package/dist/lib/email-provider-registry.d.ts.map +1 -0
  242. package/dist/lib/email-providers-from-env.d.ts +12 -0
  243. package/dist/lib/email-providers-from-env.d.ts.map +1 -0
  244. package/dist/lib/email-service-types.d.ts +189 -0
  245. package/dist/lib/email-service-types.d.ts.map +1 -0
  246. package/dist/lib/email-stats.d.ts +12 -0
  247. package/dist/lib/email-stats.d.ts.map +1 -0
  248. package/dist/lib/email.d.ts +73 -0
  249. package/dist/lib/email.d.ts.map +1 -0
  250. package/dist/lib/enrichment-ledger.d.ts +101 -0
  251. package/dist/lib/enrichment-ledger.d.ts.map +1 -0
  252. package/dist/lib/enrichment-provider-registry.d.ts +20 -0
  253. package/dist/lib/enrichment-provider-registry.d.ts.map +1 -0
  254. package/dist/lib/enrichment-providers-from-env.d.ts +13 -0
  255. package/dist/lib/enrichment-providers-from-env.d.ts.map +1 -0
  256. package/dist/lib/enrichment-registry-singleton.d.ts +9 -0
  257. package/dist/lib/enrichment-registry-singleton.d.ts.map +1 -0
  258. package/dist/lib/enrollment-guards.d.ts +28 -0
  259. package/dist/lib/enrollment-guards.d.ts.map +1 -0
  260. package/dist/lib/enrollment-policy.d.ts +25 -0
  261. package/dist/lib/enrollment-policy.d.ts.map +1 -0
  262. package/dist/lib/event-names.d.ts +27 -0
  263. package/dist/lib/event-names.d.ts.map +1 -0
  264. package/dist/lib/feed.d.ts +64 -0
  265. package/dist/lib/feed.d.ts.map +1 -0
  266. package/dist/lib/flags-registry.d.ts +23 -0
  267. package/dist/lib/flags-registry.d.ts.map +1 -0
  268. package/dist/lib/flags.d.ts +143 -0
  269. package/dist/lib/flags.d.ts.map +1 -0
  270. package/dist/lib/frequency-cap.d.ts +38 -0
  271. package/dist/lib/frequency-cap.d.ts.map +1 -0
  272. package/dist/lib/from-address.d.ts +15 -0
  273. package/dist/lib/from-address.d.ts.map +1 -0
  274. package/dist/lib/funnel-progress.d.ts +37 -0
  275. package/dist/lib/funnel-progress.d.ts.map +1 -0
  276. package/dist/lib/funnel-registry.d.ts +44 -0
  277. package/dist/lib/funnel-registry.d.ts.map +1 -0
  278. package/dist/lib/funnel-transitions.d.ts +63 -0
  279. package/dist/lib/funnel-transitions.d.ts.map +1 -0
  280. package/dist/lib/fx.d.ts +118 -0
  281. package/dist/lib/fx.d.ts.map +1 -0
  282. package/dist/lib/global-control-readout.d.ts +72 -0
  283. package/dist/lib/global-control-readout.d.ts.map +1 -0
  284. package/dist/lib/groups.d.ts +138 -0
  285. package/dist/lib/groups.d.ts.map +1 -0
  286. package/dist/lib/hatchet-duration.d.ts +14 -0
  287. package/dist/lib/hatchet-duration.d.ts.map +1 -0
  288. package/dist/lib/hatchet.d.ts +3 -0
  289. package/dist/lib/hatchet.d.ts.map +1 -0
  290. package/dist/lib/headers.d.ts +8 -0
  291. package/dist/lib/headers.d.ts.map +1 -0
  292. package/dist/lib/holdout.d.ts +36 -0
  293. package/dist/lib/holdout.d.ts.map +1 -0
  294. package/dist/lib/html.d.ts +5 -0
  295. package/dist/lib/html.d.ts.map +1 -0
  296. package/dist/lib/identity-service.d.ts +60 -0
  297. package/dist/lib/identity-service.d.ts.map +1 -0
  298. package/dist/lib/identity-token.d.ts +81 -0
  299. package/dist/lib/identity-token.d.ts.map +1 -0
  300. package/dist/lib/ingestion.d.ts +218 -0
  301. package/dist/lib/ingestion.d.ts.map +1 -0
  302. package/dist/lib/journey-lift.d.ts +56 -0
  303. package/dist/lib/journey-lift.d.ts.map +1 -0
  304. package/dist/lib/journey-suppress.d.ts +59 -0
  305. package/dist/lib/journey-suppress.d.ts.map +1 -0
  306. package/dist/lib/leader-lease.d.ts +36 -0
  307. package/dist/lib/leader-lease.d.ts.map +1 -0
  308. package/dist/lib/lift-stats.d.ts +46 -0
  309. package/dist/lib/lift-stats.d.ts.map +1 -0
  310. package/dist/lib/links.d.ts +186 -0
  311. package/dist/lib/links.d.ts.map +1 -0
  312. package/dist/lib/load-optional-plugin.d.ts +47 -0
  313. package/dist/lib/load-optional-plugin.d.ts.map +1 -0
  314. package/dist/lib/logger.d.ts +4 -0
  315. package/dist/lib/logger.d.ts.map +1 -0
  316. package/dist/lib/mailer.d.ts +43 -0
  317. package/dist/lib/mailer.d.ts.map +1 -0
  318. package/dist/lib/metrics-sql.d.ts +11 -0
  319. package/dist/lib/metrics-sql.d.ts.map +1 -0
  320. package/dist/lib/notifications.d.ts +17 -0
  321. package/dist/lib/notifications.d.ts.map +1 -0
  322. package/dist/lib/oauth-token-manager.d.ts +74 -0
  323. package/dist/lib/oauth-token-manager.d.ts.map +1 -0
  324. package/dist/lib/operator-settings.d.ts +33 -0
  325. package/dist/lib/operator-settings.d.ts.map +1 -0
  326. package/dist/lib/operator.d.ts +20 -0
  327. package/dist/lib/operator.d.ts.map +1 -0
  328. package/dist/lib/outbound-endpoint-cache.d.ts +25 -0
  329. package/dist/lib/outbound-endpoint-cache.d.ts.map +1 -0
  330. package/dist/lib/outbound.d.ts +687 -0
  331. package/dist/lib/outbound.d.ts.map +1 -0
  332. package/dist/lib/phone.d.ts +11 -0
  333. package/dist/lib/phone.d.ts.map +1 -0
  334. package/dist/lib/posthog-scopes.d.ts +30 -0
  335. package/dist/lib/posthog-scopes.d.ts.map +1 -0
  336. package/dist/lib/posthog.d.ts +16 -0
  337. package/dist/lib/posthog.d.ts.map +1 -0
  338. package/dist/lib/preferences.d.ts +72 -0
  339. package/dist/lib/preferences.d.ts.map +1 -0
  340. package/dist/lib/provider-credentials.d.ts +149 -0
  341. package/dist/lib/provider-credentials.d.ts.map +1 -0
  342. package/dist/lib/provision-posthog-loop.d.ts +100 -0
  343. package/dist/lib/provision-posthog-loop.d.ts.map +1 -0
  344. package/dist/lib/recipient-preferences.d.ts +29 -0
  345. package/dist/lib/recipient-preferences.d.ts.map +1 -0
  346. package/dist/lib/redis.d.ts +33 -0
  347. package/dist/lib/redis.d.ts.map +1 -0
  348. package/dist/lib/referral-intent.d.ts +99 -0
  349. package/dist/lib/referral-intent.d.ts.map +1 -0
  350. package/dist/lib/referral-link.d.ts +59 -0
  351. package/dist/lib/referral-link.d.ts.map +1 -0
  352. package/dist/lib/referral-registry.d.ts +37 -0
  353. package/dist/lib/referral-registry.d.ts.map +1 -0
  354. package/dist/lib/referral-report.d.ts +178 -0
  355. package/dist/lib/referral-report.d.ts.map +1 -0
  356. package/dist/lib/referral-runtime.d.ts +43 -0
  357. package/dist/lib/referral-runtime.d.ts.map +1 -0
  358. package/dist/lib/referrals.d.ts +184 -0
  359. package/dist/lib/referrals.d.ts.map +1 -0
  360. package/dist/lib/refine-chain.d.ts +236 -0
  361. package/dist/lib/refine-chain.d.ts.map +1 -0
  362. package/dist/lib/refine-traits.d.ts +78 -0
  363. package/dist/lib/refine-traits.d.ts.map +1 -0
  364. package/dist/lib/refine.d.ts +35 -0
  365. package/dist/lib/refine.d.ts.map +1 -0
  366. package/dist/lib/reset-email.d.ts +38 -0
  367. package/dist/lib/reset-email.d.ts.map +1 -0
  368. package/dist/lib/revenue.d.ts +61 -0
  369. package/dist/lib/revenue.d.ts.map +1 -0
  370. package/dist/lib/schemas.d.ts +9 -0
  371. package/dist/lib/schemas.d.ts.map +1 -0
  372. package/dist/lib/seed-posthog-destination.d.ts +22 -0
  373. package/dist/lib/seed-posthog-destination.d.ts.map +1 -0
  374. package/dist/lib/semantic-click.d.ts +58 -0
  375. package/dist/lib/semantic-click.d.ts.map +1 -0
  376. package/dist/lib/sending-domain-guidance.d.ts +40 -0
  377. package/dist/lib/sending-domain-guidance.d.ts.map +1 -0
  378. package/dist/lib/singleton.d.ts +24 -0
  379. package/dist/lib/singleton.d.ts.map +1 -0
  380. package/dist/lib/sms-frequency-cap.d.ts +16 -0
  381. package/dist/lib/sms-frequency-cap.d.ts.map +1 -0
  382. package/dist/lib/sms-inbound.d.ts +37 -0
  383. package/dist/lib/sms-inbound.d.ts.map +1 -0
  384. package/dist/lib/sms-link-tracking.d.ts +53 -0
  385. package/dist/lib/sms-link-tracking.d.ts.map +1 -0
  386. package/dist/lib/sms-mailer.d.ts +12 -0
  387. package/dist/lib/sms-mailer.d.ts.map +1 -0
  388. package/dist/lib/sms-provider-registry.d.ts +20 -0
  389. package/dist/lib/sms-provider-registry.d.ts.map +1 -0
  390. package/dist/lib/sms-providers-from-env.d.ts +4 -0
  391. package/dist/lib/sms-providers-from-env.d.ts.map +1 -0
  392. package/dist/lib/sms-service-types.d.ts +131 -0
  393. package/dist/lib/sms-service-types.d.ts.map +1 -0
  394. package/dist/lib/sms-tracked.d.ts +36 -0
  395. package/dist/lib/sms-tracked.d.ts.map +1 -0
  396. package/dist/lib/sms.d.ts +58 -0
  397. package/dist/lib/sms.d.ts.map +1 -0
  398. package/dist/lib/snippet.d.ts +32 -0
  399. package/dist/lib/snippet.d.ts.map +1 -0
  400. package/dist/lib/stable-stringify.d.ts +12 -0
  401. package/dist/lib/stable-stringify.d.ts.map +1 -0
  402. package/dist/lib/studio.d.ts +21 -0
  403. package/dist/lib/studio.d.ts.map +1 -0
  404. package/dist/lib/survey.d.ts +35 -0
  405. package/dist/lib/survey.d.ts.map +1 -0
  406. package/dist/lib/test-mode.d.ts +77 -0
  407. package/dist/lib/test-mode.d.ts.map +1 -0
  408. package/dist/lib/timezone.d.ts +55 -0
  409. package/dist/lib/timezone.d.ts.map +1 -0
  410. package/dist/lib/tracked.d.ts +95 -0
  411. package/dist/lib/tracked.d.ts.map +1 -0
  412. package/dist/lib/tracking-event-names.d.ts +7 -0
  413. package/dist/lib/tracking-event-names.d.ts.map +1 -0
  414. package/dist/lib/tracking-events.d.ts +232 -0
  415. package/dist/lib/tracking-events.d.ts.map +1 -0
  416. package/dist/lib/tracking.d.ts +47 -0
  417. package/dist/lib/tracking.d.ts.map +1 -0
  418. package/dist/lib/unconfigured-email-provider.d.ts +20 -0
  419. package/dist/lib/unconfigured-email-provider.d.ts.map +1 -0
  420. package/dist/lib/unique-violation.d.ts +22 -0
  421. package/dist/lib/unique-violation.d.ts.map +1 -0
  422. package/dist/lib/user-token.d.ts +44 -0
  423. package/dist/lib/user-token.d.ts.map +1 -0
  424. package/dist/lib/variant.d.ts +44 -0
  425. package/dist/lib/variant.d.ts.map +1 -0
  426. package/dist/lib/webhook-signing.d.ts +120 -0
  427. package/dist/lib/webhook-signing.d.ts.map +1 -0
  428. package/dist/lib/worker-heartbeat.d.ts +18 -0
  429. package/dist/lib/worker-heartbeat.d.ts.map +1 -0
  430. package/dist/lists/channels.d.ts +43 -0
  431. package/dist/lists/channels.d.ts.map +1 -0
  432. package/dist/lists/define-list.d.ts +76 -0
  433. package/dist/lists/define-list.d.ts.map +1 -0
  434. package/dist/lists/registry-singleton.d.ts +8 -0
  435. package/dist/lists/registry-singleton.d.ts.map +1 -0
  436. package/dist/lists/registry.d.ts +66 -0
  437. package/dist/lists/registry.d.ts.map +1 -0
  438. package/dist/lists/subscription.d.ts +10 -0
  439. package/dist/lists/subscription.d.ts.map +1 -0
  440. package/dist/mcp/authoring-guide.d.ts +33 -0
  441. package/dist/mcp/authoring-guide.d.ts.map +1 -0
  442. package/dist/mcp/blueprint-tools.d.ts +266 -0
  443. package/dist/mcp/blueprint-tools.d.ts.map +1 -0
  444. package/dist/middleware/api-key.d.ts +45 -0
  445. package/dist/middleware/api-key.d.ts.map +1 -0
  446. package/dist/middleware/audit.d.ts +3 -0
  447. package/dist/middleware/audit.d.ts.map +1 -0
  448. package/dist/middleware/error-handler.d.ts +4 -0
  449. package/dist/middleware/error-handler.d.ts.map +1 -0
  450. package/dist/middleware/publishable-key.d.ts +27 -0
  451. package/dist/middleware/publishable-key.d.ts.map +1 -0
  452. package/dist/middleware/rate-limit.d.ts +105 -0
  453. package/dist/middleware/rate-limit.d.ts.map +1 -0
  454. package/dist/middleware/request-logger.d.ts +4 -0
  455. package/dist/middleware/request-logger.d.ts.map +1 -0
  456. package/dist/middleware/require-admin.d.ts +3 -0
  457. package/dist/middleware/require-admin.d.ts.map +1 -0
  458. package/dist/routes/_shared.d.ts +52 -0
  459. package/dist/routes/_shared.d.ts.map +1 -0
  460. package/dist/routes/accounts/callback.d.ts +18 -0
  461. package/dist/routes/accounts/callback.d.ts.map +1 -0
  462. package/dist/routes/accounts/emit.d.ts +96 -0
  463. package/dist/routes/accounts/emit.d.ts.map +1 -0
  464. package/dist/routes/accounts/import-links.d.ts +4 -0
  465. package/dist/routes/accounts/import-links.d.ts.map +1 -0
  466. package/dist/routes/accounts/index.d.ts +39 -0
  467. package/dist/routes/accounts/index.d.ts.map +1 -0
  468. package/dist/routes/accounts/lookup.d.ts +6 -0
  469. package/dist/routes/accounts/lookup.d.ts.map +1 -0
  470. package/dist/routes/accounts/me.d.ts +5 -0
  471. package/dist/routes/accounts/me.d.ts.map +1 -0
  472. package/dist/routes/accounts/mint.d.ts +5 -0
  473. package/dist/routes/accounts/mint.d.ts.map +1 -0
  474. package/dist/routes/accounts/pages.d.ts +23 -0
  475. package/dist/routes/accounts/pages.d.ts.map +1 -0
  476. package/dist/routes/accounts/resolve.d.ts +33 -0
  477. package/dist/routes/accounts/resolve.d.ts.map +1 -0
  478. package/dist/routes/accounts/serialize.d.ts +57 -0
  479. package/dist/routes/accounts/serialize.d.ts.map +1 -0
  480. package/dist/routes/accounts/shared.d.ts +68 -0
  481. package/dist/routes/accounts/shared.d.ts.map +1 -0
  482. package/dist/routes/accounts/start.d.ts +16 -0
  483. package/dist/routes/accounts/start.d.ts.map +1 -0
  484. package/dist/routes/accounts/unlink.d.ts +36 -0
  485. package/dist/routes/accounts/unlink.d.ts.map +1 -0
  486. package/dist/routes/admin/agent.d.ts +4 -0
  487. package/dist/routes/admin/agent.d.ts.map +1 -0
  488. package/dist/routes/admin/alerts.d.ts +190 -0
  489. package/dist/routes/admin/alerts.d.ts.map +1 -0
  490. package/dist/routes/admin/analytics.d.ts +137 -0
  491. package/dist/routes/admin/analytics.d.ts.map +1 -0
  492. package/dist/routes/admin/api-keys.d.ts +158 -0
  493. package/dist/routes/admin/api-keys.d.ts.map +1 -0
  494. package/dist/routes/admin/attribution.d.ts +93 -0
  495. package/dist/routes/admin/attribution.d.ts.map +1 -0
  496. package/dist/routes/admin/audit-logs.d.ts +40 -0
  497. package/dist/routes/admin/audit-logs.d.ts.map +1 -0
  498. package/dist/routes/admin/blueprints.d.ts +4 -0
  499. package/dist/routes/admin/blueprints.d.ts.map +1 -0
  500. package/dist/routes/admin/buckets.d.ts +215 -0
  501. package/dist/routes/admin/buckets.d.ts.map +1 -0
  502. package/dist/routes/admin/bulk.d.ts +203 -0
  503. package/dist/routes/admin/bulk.d.ts.map +1 -0
  504. package/dist/routes/admin/campaigns.d.ts +198 -0
  505. package/dist/routes/admin/campaigns.d.ts.map +1 -0
  506. package/dist/routes/admin/connectors.d.ts +116 -0
  507. package/dist/routes/admin/connectors.d.ts.map +1 -0
  508. package/dist/routes/admin/contacts.d.ts +246 -0
  509. package/dist/routes/admin/contacts.d.ts.map +1 -0
  510. package/dist/routes/admin/conversions.d.ts +103 -0
  511. package/dist/routes/admin/conversions.d.ts.map +1 -0
  512. package/dist/routes/admin/deals.d.ts +136 -0
  513. package/dist/routes/admin/deals.d.ts.map +1 -0
  514. package/dist/routes/admin/dlq.d.ts +100 -0
  515. package/dist/routes/admin/dlq.d.ts.map +1 -0
  516. package/dist/routes/admin/domain.d.ts +314 -0
  517. package/dist/routes/admin/domain.d.ts.map +1 -0
  518. package/dist/routes/admin/emails.d.ts +127 -0
  519. package/dist/routes/admin/emails.d.ts.map +1 -0
  520. package/dist/routes/admin/events.d.ts +140 -0
  521. package/dist/routes/admin/events.d.ts.map +1 -0
  522. package/dist/routes/admin/flags.d.ts +719 -0
  523. package/dist/routes/admin/flags.d.ts.map +1 -0
  524. package/dist/routes/admin/funnels.d.ts +71 -0
  525. package/dist/routes/admin/funnels.d.ts.map +1 -0
  526. package/dist/routes/admin/groups.d.ts +169 -0
  527. package/dist/routes/admin/groups.d.ts.map +1 -0
  528. package/dist/routes/admin/identity.d.ts +72 -0
  529. package/dist/routes/admin/identity.d.ts.map +1 -0
  530. package/dist/routes/admin/impact-schemas.d.ts +48 -0
  531. package/dist/routes/admin/impact-schemas.d.ts.map +1 -0
  532. package/dist/routes/admin/impact.d.ts +316 -0
  533. package/dist/routes/admin/impact.d.ts.map +1 -0
  534. package/dist/routes/admin/index.d.ts +4 -0
  535. package/dist/routes/admin/index.d.ts.map +1 -0
  536. package/dist/routes/admin/journey-impact.d.ts +320 -0
  537. package/dist/routes/admin/journey-impact.d.ts.map +1 -0
  538. package/dist/routes/admin/journey-logs.d.ts +57 -0
  539. package/dist/routes/admin/journey-logs.d.ts.map +1 -0
  540. package/dist/routes/admin/journeys.d.ts +736 -0
  541. package/dist/routes/admin/journeys.d.ts.map +1 -0
  542. package/dist/routes/admin/links.d.ts +382 -0
  543. package/dist/routes/admin/links.d.ts.map +1 -0
  544. package/dist/routes/admin/lists.d.ts +22 -0
  545. package/dist/routes/admin/lists.d.ts.map +1 -0
  546. package/dist/routes/admin/maintenance.d.ts +72 -0
  547. package/dist/routes/admin/maintenance.d.ts.map +1 -0
  548. package/dist/routes/admin/metrics.d.ts +212 -0
  549. package/dist/routes/admin/metrics.d.ts.map +1 -0
  550. package/dist/routes/admin/open-editor.d.ts +36 -0
  551. package/dist/routes/admin/open-editor.d.ts.map +1 -0
  552. package/dist/routes/admin/preferences.d.ts +109 -0
  553. package/dist/routes/admin/preferences.d.ts.map +1 -0
  554. package/dist/routes/admin/provider-credentials.d.ts +108 -0
  555. package/dist/routes/admin/provider-credentials.d.ts.map +1 -0
  556. package/dist/routes/admin/readiness.d.ts +24 -0
  557. package/dist/routes/admin/readiness.d.ts.map +1 -0
  558. package/dist/routes/admin/referrals.d.ts +230 -0
  559. package/dist/routes/admin/referrals.d.ts.map +1 -0
  560. package/dist/routes/admin/reporting.d.ts +149 -0
  561. package/dist/routes/admin/reporting.d.ts.map +1 -0
  562. package/dist/routes/admin/settings.d.ts +80 -0
  563. package/dist/routes/admin/settings.d.ts.map +1 -0
  564. package/dist/routes/admin/suppressions.d.ts +90 -0
  565. package/dist/routes/admin/suppressions.d.ts.map +1 -0
  566. package/dist/routes/admin/targeting.d.ts +58 -0
  567. package/dist/routes/admin/targeting.d.ts.map +1 -0
  568. package/dist/routes/admin/templates.d.ts +197 -0
  569. package/dist/routes/admin/templates.d.ts.map +1 -0
  570. package/dist/routes/admin/timeline.d.ts +51 -0
  571. package/dist/routes/admin/timeline.d.ts.map +1 -0
  572. package/dist/routes/admin/webhooks.d.ts +250 -0
  573. package/dist/routes/admin/webhooks.d.ts.map +1 -0
  574. package/dist/routes/campaigns/index.d.ts +239 -0
  575. package/dist/routes/campaigns/index.d.ts.map +1 -0
  576. package/dist/routes/connectors/index.d.ts +16 -0
  577. package/dist/routes/connectors/index.d.ts.map +1 -0
  578. package/dist/routes/contacts/index.d.ts +187 -0
  579. package/dist/routes/contacts/index.d.ts.map +1 -0
  580. package/dist/routes/email/index.d.ts +4 -0
  581. package/dist/routes/email/index.d.ts.map +1 -0
  582. package/dist/routes/email/preferences.d.ts +17 -0
  583. package/dist/routes/email/preferences.d.ts.map +1 -0
  584. package/dist/routes/email/unsubscribe.d.ts +17 -0
  585. package/dist/routes/email/unsubscribe.d.ts.map +1 -0
  586. package/dist/routes/emails/index.d.ts +90 -0
  587. package/dist/routes/emails/index.d.ts.map +1 -0
  588. package/dist/routes/events/index.d.ts +116 -0
  589. package/dist/routes/events/index.d.ts.map +1 -0
  590. package/dist/routes/feed/index.d.ts +248 -0
  591. package/dist/routes/feed/index.d.ts.map +1 -0
  592. package/dist/routes/feed/recipient.d.ts +65 -0
  593. package/dist/routes/feed/recipient.d.ts.map +1 -0
  594. package/dist/routes/flags/index.d.ts +94 -0
  595. package/dist/routes/flags/index.d.ts.map +1 -0
  596. package/dist/routes/groups/index.d.ts +192 -0
  597. package/dist/routes/groups/index.d.ts.map +1 -0
  598. package/dist/routes/health.d.ts +57 -0
  599. package/dist/routes/health.d.ts.map +1 -0
  600. package/dist/routes/index.d.ts +8 -0
  601. package/dist/routes/index.d.ts.map +1 -0
  602. package/dist/routes/lists/index.d.ts +266 -0
  603. package/dist/routes/lists/index.d.ts.map +1 -0
  604. package/dist/routes/referrals/index.d.ts +22 -0
  605. package/dist/routes/referrals/index.d.ts.map +1 -0
  606. package/dist/routes/referrals/me.d.ts +4 -0
  607. package/dist/routes/referrals/me.d.ts.map +1 -0
  608. package/dist/routes/referrals/report.d.ts +5 -0
  609. package/dist/routes/referrals/report.d.ts.map +1 -0
  610. package/dist/routes/referrals/shared.d.ts +16 -0
  611. package/dist/routes/referrals/shared.d.ts.map +1 -0
  612. package/dist/routes/referrals/touch.d.ts +5 -0
  613. package/dist/routes/referrals/touch.d.ts.map +1 -0
  614. package/dist/routes/snippet.d.ts +12 -0
  615. package/dist/routes/snippet.d.ts.map +1 -0
  616. package/dist/routes/tracking/answer.d.ts +56 -0
  617. package/dist/routes/tracking/answer.d.ts.map +1 -0
  618. package/dist/routes/tracking/arrive.d.ts +32 -0
  619. package/dist/routes/tracking/arrive.d.ts.map +1 -0
  620. package/dist/routes/tracking/click-pipeline.d.ts +213 -0
  621. package/dist/routes/tracking/click-pipeline.d.ts.map +1 -0
  622. package/dist/routes/tracking/click.d.ts +26 -0
  623. package/dist/routes/tracking/click.d.ts.map +1 -0
  624. package/dist/routes/tracking/identify.d.ts +32 -0
  625. package/dist/routes/tracking/identify.d.ts.map +1 -0
  626. package/dist/routes/tracking/index.d.ts +4 -0
  627. package/dist/routes/tracking/index.d.ts.map +1 -0
  628. package/dist/routes/tracking/open.d.ts +17 -0
  629. package/dist/routes/tracking/open.d.ts.map +1 -0
  630. package/dist/routes/tracking/short.d.ts +17 -0
  631. package/dist/routes/tracking/short.d.ts.map +1 -0
  632. package/dist/routes/tracking/vanity.d.ts +17 -0
  633. package/dist/routes/tracking/vanity.d.ts.map +1 -0
  634. package/dist/routes/webhooks/crm-provider.d.ts +24 -0
  635. package/dist/routes/webhooks/crm-provider.d.ts.map +1 -0
  636. package/dist/routes/webhooks/email-provider.d.ts +21 -0
  637. package/dist/routes/webhooks/email-provider.d.ts.map +1 -0
  638. package/dist/routes/webhooks/index.d.ts +8 -0
  639. package/dist/routes/webhooks/index.d.ts.map +1 -0
  640. package/dist/routes/webhooks/resend.d.ts +35 -0
  641. package/dist/routes/webhooks/resend.d.ts.map +1 -0
  642. package/dist/routes/webhooks/sms-provider.d.ts +23 -0
  643. package/dist/routes/webhooks/sms-provider.d.ts.map +1 -0
  644. package/dist/routes/webhooks/sources.d.ts +12 -0
  645. package/dist/routes/webhooks/sources.d.ts.map +1 -0
  646. package/dist/sources/define-contact-source.d.ts +114 -0
  647. package/dist/sources/define-contact-source.d.ts.map +1 -0
  648. package/dist/sources/registry.d.ts +31 -0
  649. package/dist/sources/registry.d.ts.map +1 -0
  650. package/dist/sources/webhook-source.d.ts +53 -0
  651. package/dist/sources/webhook-source.d.ts.map +1 -0
  652. package/dist/testing.d.ts +10 -0
  653. package/dist/testing.d.ts.map +1 -0
  654. package/dist/webhook-sources/define-webhook-source.d.ts +60 -0
  655. package/dist/webhook-sources/define-webhook-source.d.ts.map +1 -0
  656. package/dist/webhook-sources/presets/clerk.d.ts +9 -0
  657. package/dist/webhook-sources/presets/clerk.d.ts.map +1 -0
  658. package/dist/webhook-sources/presets/index.d.ts +140 -0
  659. package/dist/webhook-sources/presets/index.d.ts.map +1 -0
  660. package/dist/webhook-sources/presets/intercom.d.ts +44 -0
  661. package/dist/webhook-sources/presets/intercom.d.ts.map +1 -0
  662. package/dist/webhook-sources/presets/segment.d.ts +16 -0
  663. package/dist/webhook-sources/presets/segment.d.ts.map +1 -0
  664. package/dist/webhook-sources/presets/stripe.d.ts +20 -0
  665. package/dist/webhook-sources/presets/stripe.d.ts.map +1 -0
  666. package/dist/webhook-sources/presets/supabase.d.ts +23 -0
  667. package/dist/webhook-sources/presets/supabase.d.ts.map +1 -0
  668. package/dist/webhook-sources/verify.d.ts +48 -0
  669. package/dist/webhook-sources/verify.d.ts.map +1 -0
  670. package/dist/worker.d.ts +37 -0
  671. package/dist/worker.d.ts.map +1 -0
  672. package/dist/workflows/backfill-contact-id.d.ts +202 -0
  673. package/dist/workflows/backfill-contact-id.d.ts.map +1 -0
  674. package/dist/workflows/bucket-backfill.d.ts +64 -0
  675. package/dist/workflows/bucket-backfill.d.ts.map +1 -0
  676. package/dist/workflows/bucket-reconcile.d.ts +73 -0
  677. package/dist/workflows/bucket-reconcile.d.ts.map +1 -0
  678. package/dist/workflows/check-alerts.d.ts +10 -0
  679. package/dist/workflows/check-alerts.d.ts.map +1 -0
  680. package/dist/workflows/confirm-semantic-click.d.ts +15 -0
  681. package/dist/workflows/confirm-semantic-click.d.ts.map +1 -0
  682. package/dist/workflows/crm-reconcile.d.ts +27 -0
  683. package/dist/workflows/crm-reconcile.d.ts.map +1 -0
  684. package/dist/workflows/deliver-webhook.d.ts +88 -0
  685. package/dist/workflows/deliver-webhook.d.ts.map +1 -0
  686. package/dist/workflows/dispatch-conversion.d.ts +14 -0
  687. package/dist/workflows/dispatch-conversion.d.ts.map +1 -0
  688. package/dist/workflows/identity-alias-backfill.d.ts +96 -0
  689. package/dist/workflows/identity-alias-backfill.d.ts.map +1 -0
  690. package/dist/workflows/impact-digest.d.ts +142 -0
  691. package/dist/workflows/impact-digest.d.ts.map +1 -0
  692. package/dist/workflows/import-contacts.d.ts +14 -0
  693. package/dist/workflows/import-contacts.d.ts.map +1 -0
  694. package/dist/workflows/import-suppressions.d.ts +55 -0
  695. package/dist/workflows/import-suppressions.d.ts.map +1 -0
  696. package/dist/workflows/journey-blueprint-interpreter.d.ts +73 -0
  697. package/dist/workflows/journey-blueprint-interpreter.d.ts.map +1 -0
  698. package/dist/workflows/send-campaign.d.ts +128 -0
  699. package/dist/workflows/send-campaign.d.ts.map +1 -0
  700. package/dist/workflows/send-email.d.ts +15 -0
  701. package/dist/workflows/send-email.d.ts.map +1 -0
  702. package/dist/workflows/send-feed.d.ts +37 -0
  703. package/dist/workflows/send-feed.d.ts.map +1 -0
  704. package/package.json +60 -22
  705. package/src/app.ts +9 -1
  706. package/src/buckets/check-membership.ts +54 -20
  707. package/src/env.ts +30 -0
  708. package/src/journeys/journey-log.ts +25 -8
  709. package/src/lib/contacts.ts +47 -1
  710. package/src/lib/email-service-types.ts +10 -0
  711. package/src/lib/ingestion.ts +30 -19
  712. package/src/lib/mailer-bounce-idempotency.test.ts +7 -2
  713. package/src/lib/mailer-replied.test.ts +7 -2
  714. package/src/lib/mailer.ts +1 -0
  715. package/src/lib/outbound-endpoint-cache.ts +83 -0
  716. package/src/lib/outbound.ts +56 -37
  717. package/src/lib/seed-posthog-destination.ts +5 -1
  718. package/src/lib/tracked.ts +11 -3
  719. package/src/lib/tracking-events.ts +20 -3
  720. package/src/middleware/api-key.ts +69 -60
  721. package/src/middleware/publishable-key.ts +11 -23
  722. package/src/middleware/rate-limit.ts +165 -3
  723. package/src/routes/admin/api-keys.ts +148 -0
  724. package/src/routes/admin/targeting.ts +6 -1
  725. package/src/routes/admin/webhooks.ts +4 -0
  726. package/src/routes/index.ts +67 -24
  727. package/src/workflows/backfill-contact-id.ts +3 -7
  728. package/src/workflows/bucket-backfill.ts +2 -2
  729. package/src/workflows/bucket-reconcile.ts +28 -12
  730. package/src/workflows/check-alerts.ts +3 -9
  731. package/src/workflows/crm-reconcile.ts +3 -2
  732. package/src/workflows/deliver-webhook.ts +21 -8
  733. package/src/workflows/dispatch-conversion.ts +2 -2
  734. package/src/workflows/identity-alias-backfill.ts +3 -2
  735. package/src/workflows/impact-digest.ts +2 -2
  736. package/src/workflows/import-contacts.ts +3 -4
  737. package/src/workflows/import-suppressions.ts +4 -5
  738. package/src/workflows/send-campaign.ts +10 -1
@@ -0,0 +1,59 @@
1
+ import { type DefinedReferral } from "@hogsend/core";
2
+ import { type Database } from "@hogsend/db";
3
+ import type { ReferralRegistry } from "./referral-registry.js";
4
+ /**
5
+ * `getReferralLink` (PRD 05 §7.2): the referrer's share link, journey-safe and
6
+ * idempotent. THE ONE mint path for a `shared` link, so `links.referral_id`,
7
+ * `owner_contact_id` and `append_ref` can never be set inconsistently.
8
+ *
9
+ * Journey-safe means two things. It issues NO durable Hatchet call, so it is
10
+ * invisible to the replay journal and needs no `ctx.once` wrap. And it is
11
+ * IDEMPOTENT at the database: a replay re-minting the same referrer's link
12
+ * recovers the existing row rather than minting a second one, either by the
13
+ * vanity slug or by the deterministic idempotency key below.
14
+ */
15
+ /** The subset of the container this needs, structurally - avoids a cycle. */
16
+ export interface ReferralLinkContainer {
17
+ db: Database;
18
+ env: {
19
+ API_PUBLIC_URL: string;
20
+ };
21
+ referrals: ReferralRegistry;
22
+ }
23
+ export interface GetReferralLinkOptions {
24
+ /** The `defineReferral` id, or the definition itself. Default `"default"`. */
25
+ referral?: string | DefinedReferral;
26
+ /** The REFERRER - the contact who earns the credit for this link. */
27
+ contactId: string;
28
+ /**
29
+ * The request container, when the caller has one. Omitted inside a journey /
30
+ * durable task, where the process runtime installed by `createHogsendClient`
31
+ * is read instead.
32
+ */
33
+ container?: ReferralLinkContainer;
34
+ }
35
+ export interface ReferralLink {
36
+ /**
37
+ * The share URL. The VANITY url (`/l/<slug>`) when the referral derives a
38
+ * slug, else the UUID redirect - so a program with `slugFrom` hands out the
39
+ * typeable code and one without hands out the durable one.
40
+ */
41
+ url: string;
42
+ /** The normalized vanity slug, or null when the program derives none. */
43
+ slug: string | null;
44
+ /** The durable `links.id`. */
45
+ linkId: string;
46
+ /** The `tracked_links.id` - the `:id` in `/v1/t/c/:id`. */
47
+ trackedLinkId: string;
48
+ /** The referral this link belongs to. */
49
+ referralId: string;
50
+ /** True when the mint RECOVERED an existing link rather than inserting one. */
51
+ existing: boolean;
52
+ }
53
+ /**
54
+ * Resolve (or mint) the `shared` link that credits `contactId` under
55
+ * `referral`. Safe to call on every journey run: the second call returns the
56
+ * first call's link.
57
+ */
58
+ export declare function getReferralLink(opts: GetReferralLinkOptions): Promise<ReferralLink>;
59
+ //# sourceMappingURL=referral-link.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"referral-link.d.ts","sourceRoot":"","sources":["../../src/lib/referral-link.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,eAAe,EAErB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAY,KAAK,QAAQ,EAAE,MAAM,aAAa,CAAC;AAItD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAG/D;;;;;;;;;;GAUG;AAEH,6EAA6E;AAC7E,MAAM,WAAW,qBAAqB;IACpC,EAAE,EAAE,QAAQ,CAAC;IACb,GAAG,EAAE;QAAE,cAAc,EAAE,MAAM,CAAA;KAAE,CAAC;IAChC,SAAS,EAAE,gBAAgB,CAAC;CAC7B;AAED,MAAM,WAAW,sBAAsB;IACrC,8EAA8E;IAC9E,QAAQ,CAAC,EAAE,MAAM,GAAG,eAAe,CAAC;IACpC,qEAAqE;IACrE,SAAS,EAAE,MAAM,CAAC;IAClB;;;;OAIG;IACH,SAAS,CAAC,EAAE,qBAAqB,CAAC;CACnC;AAED,MAAM,WAAW,YAAY;IAC3B;;;;OAIG;IACH,GAAG,EAAE,MAAM,CAAC;IACZ,yEAAyE;IACzE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,8BAA8B;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,2DAA2D;IAC3D,aAAa,EAAE,MAAM,CAAC;IACtB,yCAAyC;IACzC,UAAU,EAAE,MAAM,CAAC;IACnB,+EAA+E;IAC/E,QAAQ,EAAE,OAAO,CAAC;CACnB;AAOD;;;;GAIG;AACH,wBAAsB,eAAe,CACnC,IAAI,EAAE,sBAAsB,GAC3B,OAAO,CAAC,YAAY,CAAC,CAiFvB"}
@@ -0,0 +1,37 @@
1
+ import type { DefinedReferral } from "@hogsend/core";
2
+ /**
3
+ * Container-held registry of referral definitions, keyed by `DefinedReferral.id`
4
+ * - a structural mirror of {@link AccountLinkProviderRegistry}
5
+ * (`lib/account-link-provider-registry.ts`).
6
+ *
7
+ * There is NO env preset and NO "active referral": a referral is authored in
8
+ * code or it does not exist, and a product may run several programs at once
9
+ * (each link carries its own `links.referral_id`). So an empty registry is the
10
+ * normal state of a deploy that never asked for referrals, and every wired
11
+ * site - the click/arrive touch, the bind at identity adoption, the qualify
12
+ * evaluation in `ingestEvent` - is INERT while it stays empty.
13
+ *
14
+ * Last-writer-wins on `id`, matching every other registry merge in the engine.
15
+ * `defineReferral()` already validates the id charset, so this does not
16
+ * re-validate it (a second copy of that rule is a second place to update).
17
+ */
18
+ export declare class ReferralRegistry {
19
+ private byId;
20
+ /**
21
+ * `qualify.event` → the referrals watching it. Built at construction because
22
+ * `ingestEvent` asks this question on EVERY event: a miss must cost one map
23
+ * lookup, not a scan of every definition.
24
+ */
25
+ private byEvent;
26
+ constructor(referrals?: DefinedReferral[]);
27
+ /** Register (or replace) a referral. Last-writer-wins on `id`. */
28
+ register(referral: DefinedReferral): void;
29
+ private unindexEvent;
30
+ get(id: string): DefinedReferral | undefined;
31
+ list(): DefinedReferral[];
32
+ ids(): string[];
33
+ count(): number;
34
+ /** Every referral whose `qualify.event` is `event`. Empty when none watch it. */
35
+ byQualifyEvent(event: string): DefinedReferral[];
36
+ }
37
+ //# sourceMappingURL=referral-registry.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"referral-registry.d.ts","sourceRoot":"","sources":["../../src/lib/referral-registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAErD;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,IAAI,CAAsC;IAClD;;;;OAIG;IACH,OAAO,CAAC,OAAO,CAAwC;gBAE3C,SAAS,GAAE,eAAe,EAAO;IAI7C,kEAAkE;IAClE,QAAQ,CAAC,QAAQ,EAAE,eAAe,GAAG,IAAI;IAoBzC,OAAO,CAAC,YAAY;IAUpB,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS;IAI5C,IAAI,IAAI,eAAe,EAAE;IAIzB,GAAG,IAAI,MAAM,EAAE;IAIf,KAAK,IAAI,MAAM;IAIf,iFAAiF;IACjF,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,eAAe,EAAE;CAGjD"}
@@ -0,0 +1,178 @@
1
+ import type { Database } from "@hogsend/db";
2
+ /**
3
+ * THE REFERRAL REPORT (PRD 05 §5.3). Model, window, depth and level weights
4
+ * are REQUEST parameters; nothing weighted is persisted, so changing your mind
5
+ * costs one query and backfills nothing.
6
+ *
7
+ * The whole tree walk is ONE recursive CTE. Doing it in TypeScript would mean
8
+ * shipping every edge of every referrer to the process to multiply five
9
+ * numbers, and the cycle guard (a referee who later refers an ancestor) would
10
+ * have to be re-implemented over the wire. Postgres already has `ARRAY` and
11
+ * `WITH RECURSIVE`.
12
+ *
13
+ * ## Currencies are never converted
14
+ *
15
+ * `conversions.value` carries `conversions.currency`, and this file has no FX
16
+ * rate and no business asking for one. Every monetary answer is a LIST of
17
+ * `{ currency, value }` pairs. The only place currency is flattened is the
18
+ * beneficiary ORDER (a leaderboard needs one axis), and that is documented at
19
+ * the sort itself rather than leaking into a returned number.
20
+ */
21
+ /**
22
+ * The referral model vocabulary. Deliberately NOT `@hogsend/attribution`'s
23
+ * `ATTRIBUTION_MODELS`: that list is a marketing-touchpoint vocabulary
24
+ * (`lastNonDirect`, `blended`, `positionU` vs `positionW`) whose ids do not
25
+ * name the thing a referral edge is. These five are the models a referral
26
+ * report can answer with the columns `referral_touches` actually has.
27
+ */
28
+ export declare const REFERRAL_MODELS: readonly ["first_touch", "last_touch", "linear", "time_decay", "position"];
29
+ export type ReferralModel = (typeof REFERRAL_MODELS)[number];
30
+ /** PRD 05 §5.3: the walk is capped, in the engine, at five levels. */
31
+ export declare const REFERRAL_REPORT_MAX_DEPTH = 5;
32
+ /** ISO 4217's "no currency" code - used when a conversion carries none. */
33
+ export declare const NO_CURRENCY = "XXX";
34
+ export declare class InvalidWindowError extends Error {
35
+ }
36
+ /**
37
+ * Parse a duration string (`"30d"`, `"12h"`, `"90m"`) to milliseconds. The
38
+ * window applies to the TOUCH -> BIND gap: an edge whose referee identified
39
+ * later than this after the touch is not eligible for the report, whatever the
40
+ * program's own `bindWindow` was when the row was written.
41
+ */
42
+ export declare function parseWindowMs(input: string): number;
43
+ /**
44
+ * The level weight vector. Level 1 (the direct referrer) defaults to 1 and
45
+ * every deeper level to 0, so adding `depth` WITHOUT adding weights widens the
46
+ * tree counts but changes no revenue number.
47
+ */
48
+ export declare function resolveLevelWeights(depth: number, weights: number[] | undefined): number[];
49
+ export interface CurrencyValue {
50
+ currency: string;
51
+ value: number;
52
+ }
53
+ export interface ReferralTreeLevel {
54
+ level: number;
55
+ /** Distinct referee contacts at this level of this beneficiary's tree. */
56
+ referees: number;
57
+ /** Conversions those referees fired inside `from`/`to`. */
58
+ conversions: number;
59
+ /** `levelWeight * edgeWeightProduct * conversion value`, per currency. */
60
+ value: CurrencyValue[];
61
+ }
62
+ export interface ReferralBeneficiary {
63
+ contactId: string;
64
+ direct: {
65
+ touched: number;
66
+ bound: number;
67
+ qualified: number;
68
+ };
69
+ tree: ReferralTreeLevel[];
70
+ /** The tree's value, summed across levels, per currency. */
71
+ value: CurrencyValue[];
72
+ }
73
+ export interface ReferralReportOptions {
74
+ db: Database;
75
+ referralId: string;
76
+ model: ReferralModel;
77
+ /** Touch -> bind gap ceiling, in milliseconds. */
78
+ windowMs: number;
79
+ depth: number;
80
+ /** One weight per level, index 0 = level 1. */
81
+ levelWeights: number[];
82
+ from?: Date;
83
+ to?: Date;
84
+ limit: number;
85
+ offset: number;
86
+ }
87
+ export interface ReferralReport {
88
+ beneficiaries: ReferralBeneficiary[];
89
+ /** Opaque cursor for the next page, or null at the end. */
90
+ nextOffset: number | null;
91
+ }
92
+ /**
93
+ * Run the report. Two queries: the tree (one recursive CTE) and the direct
94
+ * touch counts for the page's beneficiaries. The direct counts are deliberately
95
+ * NOT model-filtered - "how many people did this person touch" is a fact about
96
+ * the referrer, not about the model the reader picked today.
97
+ */
98
+ export declare function getReferralReport(opts: ReferralReportOptions): Promise<ReferralReport>;
99
+ export interface ReferralTreeNode {
100
+ contactId: string;
101
+ level: number;
102
+ /** The contact one hop up - the beneficiary's own referrer at `level - 1`. */
103
+ viaContactId: string;
104
+ status: string;
105
+ touchedAt: string;
106
+ boundAt: string | null;
107
+ qualifiedAt: string | null;
108
+ conversions: number;
109
+ value: CurrencyValue[];
110
+ }
111
+ export interface ReferralTreeOptions {
112
+ db: Database;
113
+ referralId: string;
114
+ contactId: string;
115
+ depth: number;
116
+ limit: number;
117
+ }
118
+ /**
119
+ * The DESCENDANTS of one referrer, to `depth`. Unlike the report this is a
120
+ * ledger view, not a model: every non-rejected edge is walked, no window is
121
+ * applied, and nothing is weighted. It answers "who did this person bring in,
122
+ * and what happened to them".
123
+ */
124
+ export declare function getReferralTree(opts: ReferralTreeOptions): Promise<ReferralTreeNode[]>;
125
+ export interface ReferralOverviewOptions {
126
+ db: Database;
127
+ referralId: string;
128
+ /** Period start; omitted = all time. */
129
+ from?: Date;
130
+ to?: Date;
131
+ }
132
+ export interface ReferralSeriesPoint {
133
+ date: string;
134
+ touched: number;
135
+ bound: number;
136
+ qualified: number;
137
+ }
138
+ export interface ReferralOverview {
139
+ /** Distinct referrers with at least one non-rejected touch in the period. */
140
+ referrers: number;
141
+ /** Live `shared` links minted for this referral (not period-bounded). */
142
+ links: number;
143
+ funnel: {
144
+ touched: number;
145
+ bound: number;
146
+ qualified: number;
147
+ /** Bound/qualified referees with at least one conversion in the period. */
148
+ converted: number;
149
+ };
150
+ rejected: {
151
+ total: number;
152
+ byReason: {
153
+ reason: string;
154
+ count: number;
155
+ }[];
156
+ };
157
+ sources: {
158
+ source: string;
159
+ count: number;
160
+ }[];
161
+ /**
162
+ * Conversions fired by referred contacts in the period, per currency: the
163
+ * ledger's number, before any model or level weight. The leaderboard's
164
+ * weighted totals can only be less than or equal to this.
165
+ */
166
+ refereeValue: CurrencyValue[];
167
+ /** `day` under ~3 months of range, else `week`. */
168
+ granularity: "day" | "week";
169
+ series: ReferralSeriesPoint[];
170
+ }
171
+ /**
172
+ * The program-level numbers the Studio header reads. Every count comes from
173
+ * `referral_touches` (plus `links` for the mint count and `conversions` for
174
+ * the money), bounded by the same `from`/`to` the leaderboard takes, so the
175
+ * tiles and the table describe one period.
176
+ */
177
+ export declare function getReferralOverview(opts: ReferralOverviewOptions): Promise<ReferralOverview>;
178
+ //# sourceMappingURL=referral-report.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"referral-report.d.ts","sourceRoot":"","sources":["../../src/lib/referral-report.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,43 @@
1
+ import type { HatchetClient } from "@hatchet-dev/typescript-sdk/v1/index.js";
2
+ import type { AnalyticsProvider } from "@hogsend/core";
3
+ import type { JourneyRegistry } from "@hogsend/core/registry";
4
+ import type { Database } from "@hogsend/db";
5
+ import type { Logger } from "./logger.js";
6
+ import type { ReferralRegistry } from "./referral-registry.js";
7
+ /**
8
+ * The handles the referral wiring needs at sites that hold no container:
9
+ * `lib/contacts.ts` (bind, post-commit), `lib/ingestion.ts` (qualify +
10
+ * convert) and journey-runtime `getReferralLink`. Installed once by
11
+ * `createHogsendClient`.
12
+ */
13
+ export interface ReferralRuntime {
14
+ referrals: ReferralRegistry;
15
+ db: Database;
16
+ /** `env.API_PUBLIC_URL` - the tracking host every minted link is built on. */
17
+ baseUrl: string;
18
+ /**
19
+ * The container's emit handles, so a library-code site (the bind in
20
+ * `lib/contacts.ts`) reaches the SAME Hatchet client the container was built
21
+ * with. Without them the intent layer would fall back to importing
22
+ * `lib/hatchet.js`, whose module load runs `HatchetClient.init` and throws
23
+ * where no real token exists.
24
+ */
25
+ hatchet: HatchetClient;
26
+ registry: JourneyRegistry;
27
+ logger: Logger;
28
+ analytics?: AnalyticsProvider;
29
+ }
30
+ export declare const setReferralRuntime: (value: ReferralRuntime | undefined) => void;
31
+ /**
32
+ * The installed referral runtime, or `undefined`.
33
+ *
34
+ * OPTIONAL, not required: unlike the email/SMS services there is no stub to
35
+ * install, and every consumer of this is a wired site that must stay INERT on
36
+ * a deploy with no referrals. `undefined` therefore means "no referrals
37
+ * configured", which is a legitimate steady state and never an error - so this
38
+ * must not be switched to `createSingleton`, whose getter throws.
39
+ */
40
+ export declare const getReferralRuntime: () => ReferralRuntime | undefined;
41
+ /** Reset the singleton - only for test cleanup. */
42
+ export declare const resetReferralRuntime: () => void;
43
+ //# sourceMappingURL=referral-runtime.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"referral-runtime.d.ts","sourceRoot":"","sources":["../../src/lib/referral-runtime.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yCAAyC,CAAC;AAC7E,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AACvD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAG/D;;;;;GAKG;AACH,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,gBAAgB,CAAC;IAC5B,EAAE,EAAE,QAAQ,CAAC;IACb,8EAA8E;IAC9E,OAAO,EAAE,MAAM,CAAC;IAChB;;;;;;OAMG;IACH,OAAO,EAAE,aAAa,CAAC;IACvB,QAAQ,EAAE,eAAe,CAAC;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,iBAAiB,CAAC;CAC/B;AAID,eAAO,MAAM,kBAAkB,8CAAe,CAAC;AAE/C;;;;;;;;GAQG;AACH,eAAO,MAAM,kBAAkB,mCAAe,CAAC;AAE/C,mDAAmD;AACnD,eAAO,MAAM,oBAAoB,YAAiB,CAAC"}
@@ -0,0 +1,184 @@
1
+ import type { DefinedReferral } from "@hogsend/core";
2
+ import { type Database } from "@hogsend/db";
3
+ /**
4
+ * The referral store (PRD 05 stage 2): the ONE place a `referral_touches` row
5
+ * is ever written. It records touches, stamps the bind at identity-adoption
6
+ * time, applies the self / window / veto rejections, and promotes a bound touch
7
+ * to qualified.
8
+ *
9
+ * House style follows {@link file://./account-links.ts}: single-object-in /
10
+ * result-object-out, `db` injected, typed error classes, and mutation FACTS
11
+ * returned so callers can emit.
12
+ *
13
+ * THIS MODULE NEVER EMITS (PRD 05 §6, DECISIONS §15.7 for the account-link
14
+ * twin). It touches neither the outbound spine nor the journey plane nor
15
+ * analytics: it returns what changed, and the intent layer above it emits
16
+ * `referral.*` outbound AND re-ingests for journeys, side by side. Two tests in
17
+ * `referrals-no-emit.test.ts` pin that - one scans this file for emit symbols,
18
+ * one pins its runtime import list, so the NEXT emit surface fails there
19
+ * whatever it ends up being called.
20
+ */
21
+ export type ReferralTouchStatus = "touched" | "bound" | "qualified" | "rejected";
22
+ /** The vocabulary of `referral_touches.rejected_reason`. */
23
+ export type ReferralRejectReason = "self" | "window" | "veto" | "bot" | "duplicate";
24
+ export type ReferralTouchSource = "link" | "slug_entry" | "invite" | "manual" | "import";
25
+ export interface ReferralTouchRecord {
26
+ id: string;
27
+ referralId: string;
28
+ referrerContactId: string;
29
+ refereeKey: string;
30
+ refereeContactId: string | null;
31
+ linkId: string | null;
32
+ clickId: string | null;
33
+ source: string;
34
+ touchedAt: Date;
35
+ boundAt: Date | null;
36
+ status: ReferralTouchStatus;
37
+ rejectedReason: ReferralRejectReason | null;
38
+ qualifiedAt: Date | null;
39
+ qualifiedConversionId: string | null;
40
+ properties: Record<string, unknown>;
41
+ }
42
+ /**
43
+ * The property key the caller's idempotency key is filed under. A PROPERTY and
44
+ * not a column: `click_id` already covers the only high-volume path (a click),
45
+ * and the manual/invite paths are low-rate operator writes whose key is
46
+ * usefully visible next to the rest of their bag.
47
+ */
48
+ export declare const REFERRAL_IDEMPOTENCY_PROPERTY = "idempotencyKey";
49
+ /** Where a hook's own free-text reason is kept when the row records `veto`. */
50
+ export declare const REFERRAL_VETO_REASON_PROPERTY = "vetoReason";
51
+ export interface RecordTouchInput {
52
+ db: Database;
53
+ /** Defaults to `"default"`, matching `defineReferral`. */
54
+ referralId?: string;
55
+ /** `links.owner_contact_id` READ AT TOUCH TIME (never re-read later). */
56
+ referrerContactId: string;
57
+ /** The toucher's canonical key - an anonymous id on a cold touch. */
58
+ refereeKey: string;
59
+ /** Set only when the toucher was ALREADY identified; the touch binds now. */
60
+ refereeContactId?: string | null;
61
+ linkId?: string | null;
62
+ /** `link_clicks.id`. Doubles as the touch's replay key when present. */
63
+ clickId?: string | null;
64
+ source: ReferralTouchSource;
65
+ properties?: Record<string, unknown>;
66
+ /**
67
+ * Explicit replay key for the paths with no click (invite/manual/import).
68
+ * A repeat is a NO-OP returning the existing row, never a second edge.
69
+ */
70
+ idempotencyKey?: string;
71
+ /** The definition, for `beforeTouch`. Absent = no veto configured. */
72
+ referral?: DefinedReferral;
73
+ touchedAt?: Date;
74
+ }
75
+ export interface RecordTouchResult {
76
+ touch: ReferralTouchRecord;
77
+ /** True only when THIS call inserted the row. */
78
+ created: boolean;
79
+ /** True when the call recovered a prior row (replay or same-pair re-touch). */
80
+ existing: boolean;
81
+ /** True when the row was written already-rejected. */
82
+ rejected: boolean;
83
+ /** The rejection's vocabulary reason, or the hook's free text for a veto. */
84
+ reason?: string;
85
+ }
86
+ /**
87
+ * Record one referral touch. Returns mutation FACTS; it emits nothing.
88
+ *
89
+ * Replay: a touch carrying a `clickId` (or an explicit `idempotencyKey`) is
90
+ * looked up first, so a redelivered click writes no second edge. Same-pair
91
+ * re-touch is a no-op at the DATABASE - the partial-unique edge index is the
92
+ * arbiter, not a judgement call here - which is what keeps a DIFFERENT
93
+ * referrer's touch a genuinely new row for last-touch models to see.
94
+ */
95
+ export declare function recordTouch(input: RecordTouchInput): Promise<RecordTouchResult>;
96
+ export interface BindTouchesInput {
97
+ db: Database;
98
+ /** The anonymous/canonical key the visitor touched under. */
99
+ refereeKey: string;
100
+ /** The contact that key just resolved to (identity adoption). */
101
+ contactId: string;
102
+ /** Narrow to one program; default = every unbound touch for the key. */
103
+ referralId?: string;
104
+ /**
105
+ * Definition lookup for `beforeBind` + `bindWindow`. Absent means the
106
+ * defaults apply (no veto, 30-day window) - binding must never depend on a
107
+ * definition being registered, or a redeploy that drops one would silently
108
+ * stop binding.
109
+ */
110
+ resolveReferral?: (referralId: string) => DefinedReferral | undefined;
111
+ now?: Date;
112
+ }
113
+ export interface BindTouchesResult {
114
+ /** Touches that gained their second end. */
115
+ bound: ReferralTouchRecord[];
116
+ /** Touches refused, with the vocabulary reason. */
117
+ rejected: Array<{
118
+ touch: ReferralTouchRecord;
119
+ reason: ReferralRejectReason;
120
+ detail?: string;
121
+ }>;
122
+ }
123
+ /**
124
+ * Stamp `referee_contact_id` / `bound_at` on every UNBOUND touch for a key, at
125
+ * identity-adoption time. Self, out-of-window and vetoed touches are rejected
126
+ * in place rather than deleted: an edge that was refused is itself a fact the
127
+ * report and the operator want to see.
128
+ */
129
+ export declare function bindTouches(input: BindTouchesInput): Promise<BindTouchesResult>;
130
+ export interface QualifyTouchInput {
131
+ db: Database;
132
+ touchId: string;
133
+ /** The event that triggered the evaluation (for `beforeQualify`). */
134
+ event?: string;
135
+ eventProperties?: Record<string, unknown>;
136
+ conversionId?: string | null;
137
+ referral?: DefinedReferral;
138
+ at?: Date;
139
+ }
140
+ export interface QualifyTouchResult {
141
+ touch: ReferralTouchRecord | null;
142
+ /** True only when THIS call promoted the row. */
143
+ qualified: boolean;
144
+ /** True when the row was already qualified (a replay). */
145
+ existing: boolean;
146
+ rejected: boolean;
147
+ reason?: string;
148
+ }
149
+ /**
150
+ * Promote a BOUND touch to qualified, exactly once. The `qualified_at IS NULL`
151
+ * predicate is the replay guard, so a redelivered qualify event returns
152
+ * `existing: true` instead of re-firing the reward journey downstream.
153
+ */
154
+ export declare function qualifyTouch(input: QualifyTouchInput): Promise<QualifyTouchResult>;
155
+ export interface RejectTouchInput {
156
+ db: Database;
157
+ touchId: string;
158
+ reason: ReferralRejectReason;
159
+ /** A hook's free text, filed alongside the vocabulary reason. */
160
+ detail?: string;
161
+ }
162
+ export interface RejectTouchResult {
163
+ touch: ReferralTouchRecord | null;
164
+ /** True only when THIS call flipped the row to rejected. */
165
+ rejected: boolean;
166
+ }
167
+ /**
168
+ * Mark a touch rejected. Idempotent: an already-rejected row is returned as-is
169
+ * with `rejected: false`, so a re-run cannot rewrite the ORIGINAL reason (which
170
+ * is the only record of why the edge was thrown away).
171
+ */
172
+ export declare function rejectTouch(input: RejectTouchInput): Promise<RejectTouchResult>;
173
+ export interface ListTouchesInput {
174
+ db: Database;
175
+ contactId: string;
176
+ referralId?: string;
177
+ status?: ReferralTouchStatus[];
178
+ limit?: number;
179
+ }
180
+ /** Every touch where this contact is the REFEREE (who referred me). */
181
+ export declare function listTouchesForReferee(input: ListTouchesInput): Promise<ReferralTouchRecord[]>;
182
+ /** Every touch where this contact is the REFERRER (who I referred). */
183
+ export declare function listTouchesForReferrer(input: ListTouchesInput): Promise<ReferralTouchRecord[]>;
184
+ //# sourceMappingURL=referrals.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"referrals.d.ts","sourceRoot":"","sources":["../../src/lib/referrals.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAIV,eAAe,EAEhB,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,KAAK,QAAQ,EAAmB,MAAM,aAAa,CAAC;AAG7D;;;;;;;;;;;;;;;;;GAiBG;AAMH,MAAM,MAAM,mBAAmB,GAC3B,SAAS,GACT,OAAO,GACP,WAAW,GACX,UAAU,CAAC;AAEf,4DAA4D;AAC5D,MAAM,MAAM,oBAAoB,GAC5B,MAAM,GACN,QAAQ,GACR,MAAM,GACN,KAAK,GACL,WAAW,CAAC;AAEhB,MAAM,MAAM,mBAAmB,GAC3B,MAAM,GACN,YAAY,GACZ,QAAQ,GACR,QAAQ,GACR,QAAQ,CAAC;AAEb,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;IACnB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,IAAI,CAAC;IAChB,OAAO,EAAE,IAAI,GAAG,IAAI,CAAC;IACrB,MAAM,EAAE,mBAAmB,CAAC;IAC5B,cAAc,EAAE,oBAAoB,GAAG,IAAI,CAAC;IAC5C,WAAW,EAAE,IAAI,GAAG,IAAI,CAAC;IACzB,qBAAqB,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACrC;AAwBD;;;;;GAKG;AACH,eAAO,MAAM,6BAA6B,mBAAmB,CAAC;AAE9D,+EAA+E;AAC/E,eAAO,MAAM,6BAA6B,eAAe,CAAC;AA+C1D,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,QAAQ,CAAC;IACb,0DAA0D;IAC1D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,yEAAyE;IACzE,iBAAiB,EAAE,MAAM,CAAC;IAC1B,qEAAqE;IACrE,UAAU,EAAE,MAAM,CAAC;IACnB,6EAA6E;IAC7E,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,wEAAwE;IACxE,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,MAAM,EAAE,mBAAmB,CAAC;IAC5B,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,sEAAsE;IACtE,QAAQ,CAAC,EAAE,eAAe,CAAC;IAC3B,SAAS,CAAC,EAAE,IAAI,CAAC;CAClB;AAED,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,mBAAmB,CAAC;IAC3B,iDAAiD;IACjD,OAAO,EAAE,OAAO,CAAC;IACjB,+EAA+E;IAC/E,QAAQ,EAAE,OAAO,CAAC;IAClB,sDAAsD;IACtD,QAAQ,EAAE,OAAO,CAAC;IAClB,6EAA6E;IAC7E,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;GAQG;AACH,wBAAsB,WAAW,CAC/B,KAAK,EAAE,gBAAgB,GACtB,OAAO,CAAC,iBAAiB,CAAC,CAoI5B;AAMD,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,QAAQ,CAAC;IACb,6DAA6D;IAC7D,UAAU,EAAE,MAAM,CAAC;IACnB,iEAAiE;IACjE,SAAS,EAAE,MAAM,CAAC;IAClB,wEAAwE;IACxE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;;;OAKG;IACH,eAAe,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,eAAe,GAAG,SAAS,CAAC;IACtE,GAAG,CAAC,EAAE,IAAI,CAAC;CACZ;AAED,MAAM,WAAW,iBAAiB;IAChC,4CAA4C;IAC5C,KAAK,EAAE,mBAAmB,EAAE,CAAC;IAC7B,mDAAmD;IACnD,QAAQ,EAAE,KAAK,CAAC;QACd,KAAK,EAAE,mBAAmB,CAAC;QAC3B,MAAM,EAAE,oBAAoB,CAAC;QAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,CAAC,CAAC;CACJ;AAED;;;;;GAKG;AACH,wBAAsB,WAAW,CAC/B,KAAK,EAAE,gBAAgB,GACtB,OAAO,CAAC,iBAAiB,CAAC,CAoG5B;AAMD,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,QAAQ,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,qEAAqE;IACrE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC1C,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,QAAQ,CAAC,EAAE,eAAe,CAAC;IAC3B,EAAE,CAAC,EAAE,IAAI,CAAC;CACX;AAED,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,mBAAmB,GAAG,IAAI,CAAC;IAClC,iDAAiD;IACjD,SAAS,EAAE,OAAO,CAAC;IACnB,0DAA0D;IAC1D,QAAQ,EAAE,OAAO,CAAC;IAClB,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;GAIG;AACH,wBAAsB,YAAY,CAChC,KAAK,EAAE,iBAAiB,GACvB,OAAO,CAAC,kBAAkB,CAAC,CAiG7B;AAED,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,QAAQ,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,oBAAoB,CAAC;IAC7B,iEAAiE;IACjE,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,mBAAmB,GAAG,IAAI,CAAC;IAClC,4DAA4D;IAC5D,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED;;;;GAIG;AACH,wBAAsB,WAAW,CAC/B,KAAK,EAAE,gBAAgB,GACtB,OAAO,CAAC,iBAAiB,CAAC,CAgC5B;AAMD,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,QAAQ,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,mBAAmB,EAAE,CAAC;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,uEAAuE;AACvE,wBAAsB,qBAAqB,CACzC,KAAK,EAAE,gBAAgB,GACtB,OAAO,CAAC,mBAAmB,EAAE,CAAC,CAEhC;AAED,uEAAuE;AACvE,wBAAsB,sBAAsB,CAC1C,KAAK,EAAE,gBAAgB,GACtB,OAAO,CAAC,mBAAmB,EAAE,CAAC,CAEhC"}