@hogsend/engine 0.66.0 → 0.68.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (760) hide show
  1. package/README.md +3 -2
  2. package/dist/account-links/__fixtures__/fake-fetch.d.ts +38 -0
  3. package/dist/account-links/__fixtures__/fake-fetch.d.ts.map +1 -0
  4. package/dist/account-links/battlenet.d.ts +36 -0
  5. package/dist/account-links/battlenet.d.ts.map +1 -0
  6. package/dist/account-links/epic.d.ts +36 -0
  7. package/dist/account-links/epic.d.ts.map +1 -0
  8. package/dist/account-links/index.d.ts +7 -0
  9. package/dist/account-links/index.d.ts.map +1 -0
  10. package/dist/account-links/riot.d.ts +35 -0
  11. package/dist/account-links/riot.d.ts.map +1 -0
  12. package/dist/account-links/steam.d.ts +35 -0
  13. package/dist/account-links/steam.d.ts.map +1 -0
  14. package/dist/account-links/twitch.d.ts +38 -0
  15. package/dist/account-links/twitch.d.ts.map +1 -0
  16. package/dist/account-links/xbox.d.ts +39 -0
  17. package/dist/account-links/xbox.d.ts.map +1 -0
  18. package/dist/app.d.ts +50 -0
  19. package/dist/app.d.ts.map +1 -0
  20. package/dist/buckets/bucket-access.d.ts +60 -0
  21. package/dist/buckets/bucket-access.d.ts.map +1 -0
  22. package/dist/buckets/bucket-reactions.d.ts +100 -0
  23. package/dist/buckets/bucket-reactions.d.ts.map +1 -0
  24. package/dist/buckets/check-membership.d.ts +105 -0
  25. package/dist/buckets/check-membership.d.ts.map +1 -0
  26. package/dist/buckets/define-bucket.d.ts +53 -0
  27. package/dist/buckets/define-bucket.d.ts.map +1 -0
  28. package/dist/buckets/membership-epoch.d.ts +74 -0
  29. package/dist/buckets/membership-epoch.d.ts.map +1 -0
  30. package/dist/buckets/registry-singleton.d.ts +6 -0
  31. package/dist/buckets/registry-singleton.d.ts.map +1 -0
  32. package/dist/buckets/registry.d.ts +59 -0
  33. package/dist/buckets/registry.d.ts.map +1 -0
  34. package/dist/campaigns/cohort-sql.d.ts +54 -0
  35. package/dist/campaigns/cohort-sql.d.ts.map +1 -0
  36. package/dist/campaigns/define-campaign.d.ts +105 -0
  37. package/dist/campaigns/define-campaign.d.ts.map +1 -0
  38. package/dist/campaigns/reconcile.d.ts +13 -0
  39. package/dist/campaigns/reconcile.d.ts.map +1 -0
  40. package/dist/campaigns/steps.d.ts +29 -0
  41. package/dist/campaigns/steps.d.ts.map +1 -0
  42. package/dist/cold-connect/index.d.ts +98 -0
  43. package/dist/cold-connect/index.d.ts.map +1 -0
  44. package/dist/cold-connect/page.d.ts +69 -0
  45. package/dist/cold-connect/page.d.ts.map +1 -0
  46. package/dist/cold-connect/throttle.d.ts +39 -0
  47. package/dist/cold-connect/throttle.d.ts.map +1 -0
  48. package/dist/cold-connect/token.d.ts +57 -0
  49. package/dist/cold-connect/token.d.ts.map +1 -0
  50. package/dist/connectors/action-registry-singleton.d.ts +21 -0
  51. package/dist/connectors/action-registry-singleton.d.ts.map +1 -0
  52. package/dist/connectors/define-action.d.ts +117 -0
  53. package/dist/connectors/define-action.d.ts.map +1 -0
  54. package/dist/connectors/define-connector.d.ts +172 -0
  55. package/dist/connectors/define-connector.d.ts.map +1 -0
  56. package/dist/connectors/presets/index.d.ts +17 -0
  57. package/dist/connectors/presets/index.d.ts.map +1 -0
  58. package/dist/connectors/registry-singleton.d.ts +34 -0
  59. package/dist/connectors/registry-singleton.d.ts.map +1 -0
  60. package/dist/connectors/runtime.d.ts +68 -0
  61. package/dist/connectors/runtime.d.ts.map +1 -0
  62. package/dist/container.d.ts +678 -0
  63. package/dist/container.d.ts.map +1 -0
  64. package/dist/destinations/define-destination.d.ts +96 -0
  65. package/dist/destinations/define-destination.d.ts.map +1 -0
  66. package/dist/destinations/presets/index.d.ts +42 -0
  67. package/dist/destinations/presets/index.d.ts.map +1 -0
  68. package/dist/destinations/presets/posthog.d.ts +12 -0
  69. package/dist/destinations/presets/posthog.d.ts.map +1 -0
  70. package/dist/destinations/presets/segment.d.ts +15 -0
  71. package/dist/destinations/presets/segment.d.ts.map +1 -0
  72. package/dist/destinations/presets/slack.d.ts +10 -0
  73. package/dist/destinations/presets/slack.d.ts.map +1 -0
  74. package/dist/destinations/presets/webhook.d.ts +14 -0
  75. package/dist/destinations/presets/webhook.d.ts.map +1 -0
  76. package/dist/destinations/registry-singleton.d.ts +44 -0
  77. package/dist/destinations/registry-singleton.d.ts.map +1 -0
  78. package/dist/env.d.ts +119 -0
  79. package/dist/env.d.ts.map +1 -0
  80. package/dist/flags/reconcile.d.ts +36 -0
  81. package/dist/flags/reconcile.d.ts.map +1 -0
  82. package/dist/index.d.ts +210 -0
  83. package/dist/index.d.ts.map +1 -0
  84. package/dist/journeys/authoring.d.ts +15 -0
  85. package/dist/journeys/authoring.d.ts.map +1 -0
  86. package/dist/journeys/client-defaults-singleton.d.ts +16 -0
  87. package/dist/journeys/client-defaults-singleton.d.ts.map +1 -0
  88. package/dist/journeys/constants.d.ts +32 -0
  89. package/dist/journeys/constants.d.ts.map +1 -0
  90. package/dist/journeys/define-journey.d.ts +33 -0
  91. package/dist/journeys/define-journey.d.ts.map +1 -0
  92. package/dist/journeys/durable-law-harness.d.ts +74 -0
  93. package/dist/journeys/durable-law-harness.d.ts.map +1 -0
  94. package/dist/journeys/errors.d.ts +13 -0
  95. package/dist/journeys/errors.d.ts.map +1 -0
  96. package/dist/journeys/execute-journey-run.d.ts +160 -0
  97. package/dist/journeys/execute-journey-run.d.ts.map +1 -0
  98. package/dist/journeys/graph/build-graph.d.ts +24 -0
  99. package/dist/journeys/graph/build-graph.d.ts.map +1 -0
  100. package/dist/journeys/group-scope.d.ts +56 -0
  101. package/dist/journeys/group-scope.d.ts.map +1 -0
  102. package/dist/journeys/journey-boundary.d.ts +264 -0
  103. package/dist/journeys/journey-boundary.d.ts.map +1 -0
  104. package/dist/journeys/journey-context.d.ts +60 -0
  105. package/dist/journeys/journey-context.d.ts.map +1 -0
  106. package/dist/journeys/journey-log.d.ts +42 -0
  107. package/dist/journeys/journey-log.d.ts.map +1 -0
  108. package/dist/journeys/journey-source-locations-singleton.d.ts +6 -0
  109. package/dist/journeys/journey-source-locations-singleton.d.ts.map +1 -0
  110. package/dist/journeys/journey-sources-singleton.d.ts +5 -0
  111. package/dist/journeys/journey-sources-singleton.d.ts.map +1 -0
  112. package/dist/journeys/journey-task-factory.d.ts +11 -0
  113. package/dist/journeys/journey-task-factory.d.ts.map +1 -0
  114. package/dist/journeys/journey-task-runtime.d.ts +2 -0
  115. package/dist/journeys/journey-task-runtime.d.ts.map +1 -0
  116. package/dist/journeys/journey-version.d.ts +71 -0
  117. package/dist/journeys/journey-version.d.ts.map +1 -0
  118. package/dist/journeys/record-once.d.ts +56 -0
  119. package/dist/journeys/record-once.d.ts.map +1 -0
  120. package/dist/journeys/registry-singleton.d.ts +6 -0
  121. package/dist/journeys/registry-singleton.d.ts.map +1 -0
  122. package/dist/journeys/registry.d.ts +59 -0
  123. package/dist/journeys/registry.d.ts.map +1 -0
  124. package/dist/journeys/with-durable-gate.d.ts +97 -0
  125. package/dist/journeys/with-durable-gate.d.ts.map +1 -0
  126. package/dist/lib/account-link-emit.d.ts +69 -0
  127. package/dist/lib/account-link-emit.d.ts.map +1 -0
  128. package/dist/lib/account-link-events.d.ts +128 -0
  129. package/dist/lib/account-link-events.d.ts.map +1 -0
  130. package/dist/lib/account-link-hooks.d.ts +32 -0
  131. package/dist/lib/account-link-hooks.d.ts.map +1 -0
  132. package/dist/lib/account-link-ingest.d.ts +78 -0
  133. package/dist/lib/account-link-ingest.d.ts.map +1 -0
  134. package/dist/lib/account-link-nonce.d.ts +29 -0
  135. package/dist/lib/account-link-nonce.d.ts.map +1 -0
  136. package/dist/lib/account-link-origins.d.ts +37 -0
  137. package/dist/lib/account-link-origins.d.ts.map +1 -0
  138. package/dist/lib/account-link-pkce.d.ts +48 -0
  139. package/dist/lib/account-link-pkce.d.ts.map +1 -0
  140. package/dist/lib/account-link-provider-registry.d.ts +35 -0
  141. package/dist/lib/account-link-provider-registry.d.ts.map +1 -0
  142. package/dist/lib/account-link-throttle.d.ts +76 -0
  143. package/dist/lib/account-link-throttle.d.ts.map +1 -0
  144. package/dist/lib/account-link-url.d.ts +41 -0
  145. package/dist/lib/account-link-url.d.ts.map +1 -0
  146. package/dist/lib/account-links-from-env.d.ts +62 -0
  147. package/dist/lib/account-links-from-env.d.ts.map +1 -0
  148. package/dist/lib/account-links.d.ts +353 -0
  149. package/dist/lib/account-links.d.ts.map +1 -0
  150. package/dist/lib/agent/config.d.ts +14 -0
  151. package/dist/lib/agent/config.d.ts.map +1 -0
  152. package/dist/lib/agent/proposals.d.ts +52 -0
  153. package/dist/lib/agent/proposals.d.ts.map +1 -0
  154. package/dist/lib/agent/provider.d.ts +9 -0
  155. package/dist/lib/agent/provider.d.ts.map +1 -0
  156. package/dist/lib/agent/risk.d.ts +24 -0
  157. package/dist/lib/agent/risk.d.ts.map +1 -0
  158. package/dist/lib/agent/system-prompt.d.ts +8 -0
  159. package/dist/lib/agent/system-prompt.d.ts.map +1 -0
  160. package/dist/lib/agent/tools.d.ts +258 -0
  161. package/dist/lib/agent/tools.d.ts.map +1 -0
  162. package/dist/lib/alerting.d.ts +7 -0
  163. package/dist/lib/alerting.d.ts.map +1 -0
  164. package/dist/lib/analytics-adapter.d.ts +24 -0
  165. package/dist/lib/analytics-adapter.d.ts.map +1 -0
  166. package/dist/lib/analytics-identity.d.ts +60 -0
  167. package/dist/lib/analytics-identity.d.ts.map +1 -0
  168. package/dist/lib/analytics-provider-registry.d.ts +20 -0
  169. package/dist/lib/analytics-provider-registry.d.ts.map +1 -0
  170. package/dist/lib/analytics-providers-from-env.d.ts +41 -0
  171. package/dist/lib/analytics-providers-from-env.d.ts.map +1 -0
  172. package/dist/lib/analytics-singleton.d.ts +10 -0
  173. package/dist/lib/analytics-singleton.d.ts.map +1 -0
  174. package/dist/lib/api-key-hash.d.ts +9 -0
  175. package/dist/lib/api-key-hash.d.ts.map +1 -0
  176. package/dist/lib/app-secret.d.ts +29 -0
  177. package/dist/lib/app-secret.d.ts.map +1 -0
  178. package/dist/lib/attachments.d.ts +53 -0
  179. package/dist/lib/attachments.d.ts.map +1 -0
  180. package/dist/lib/attribution-backfill.d.ts +48 -0
  181. package/dist/lib/attribution-backfill.d.ts.map +1 -0
  182. package/dist/lib/attribution.d.ts +44 -0
  183. package/dist/lib/attribution.d.ts.map +1 -0
  184. package/dist/lib/auth.d.ts +136 -0
  185. package/dist/lib/auth.d.ts.map +1 -0
  186. package/dist/lib/backfill.d.ts +41 -0
  187. package/dist/lib/backfill.d.ts.map +1 -0
  188. package/dist/lib/banner.d.ts +52 -0
  189. package/dist/lib/banner.d.ts.map +1 -0
  190. package/dist/lib/blueprint-lock.d.ts +19 -0
  191. package/dist/lib/blueprint-lock.d.ts.map +1 -0
  192. package/dist/lib/blueprints.d.ts +573 -0
  193. package/dist/lib/blueprints.d.ts.map +1 -0
  194. package/dist/lib/boot-api-key.d.ts +38 -0
  195. package/dist/lib/boot-api-key.d.ts.map +1 -0
  196. package/dist/lib/boot.d.ts +23 -0
  197. package/dist/lib/boot.d.ts.map +1 -0
  198. package/dist/lib/bootstrap-admin.d.ts +33 -0
  199. package/dist/lib/bootstrap-admin.d.ts.map +1 -0
  200. package/dist/lib/bot-prefetch.d.ts +21 -0
  201. package/dist/lib/bot-prefetch.d.ts.map +1 -0
  202. package/dist/lib/bucket-emit.d.ts +75 -0
  203. package/dist/lib/bucket-emit.d.ts.map +1 -0
  204. package/dist/lib/bucket-posthog-sync.d.ts +29 -0
  205. package/dist/lib/bucket-posthog-sync.d.ts.map +1 -0
  206. package/dist/lib/campaign-send-key.d.ts +31 -0
  207. package/dist/lib/campaign-send-key.d.ts.map +1 -0
  208. package/dist/lib/connector-actions.d.ts +83 -0
  209. package/dist/lib/connector-actions.d.ts.map +1 -0
  210. package/dist/lib/connector-heartbeat.d.ts +35 -0
  211. package/dist/lib/connector-heartbeat.d.ts.map +1 -0
  212. package/dist/lib/connector-link-codes.d.ts +105 -0
  213. package/dist/lib/connector-link-codes.d.ts.map +1 -0
  214. package/dist/lib/connector-state.d.ts +97 -0
  215. package/dist/lib/connector-state.d.ts.map +1 -0
  216. package/dist/lib/contacts.d.ts +622 -0
  217. package/dist/lib/contacts.d.ts.map +1 -0
  218. package/dist/lib/conversion-dispatch.d.ts +98 -0
  219. package/dist/lib/conversion-dispatch.d.ts.map +1 -0
  220. package/dist/lib/conversions.d.ts +75 -0
  221. package/dist/lib/conversions.d.ts.map +1 -0
  222. package/dist/lib/create-admin.d.ts +54 -0
  223. package/dist/lib/create-admin.d.ts.map +1 -0
  224. package/dist/lib/crm-deals.d.ts +66 -0
  225. package/dist/lib/crm-deals.d.ts.map +1 -0
  226. package/dist/lib/crm-ingest.d.ts +38 -0
  227. package/dist/lib/crm-ingest.d.ts.map +1 -0
  228. package/dist/lib/crm-provider-registry.d.ts +20 -0
  229. package/dist/lib/crm-provider-registry.d.ts.map +1 -0
  230. package/dist/lib/crm-registry-singleton.d.ts +18 -0
  231. package/dist/lib/crm-registry-singleton.d.ts.map +1 -0
  232. package/dist/lib/db.d.ts +3 -0
  233. package/dist/lib/db.d.ts.map +1 -0
  234. package/dist/lib/deal-money-events.d.ts +35 -0
  235. package/dist/lib/deal-money-events.d.ts.map +1 -0
  236. package/dist/lib/discord-gateway-heartbeat.d.ts +47 -0
  237. package/dist/lib/discord-gateway-heartbeat.d.ts.map +1 -0
  238. package/dist/lib/domain-status.d.ts +87 -0
  239. package/dist/lib/domain-status.d.ts.map +1 -0
  240. package/dist/lib/email-provider-registry.d.ts +30 -0
  241. package/dist/lib/email-provider-registry.d.ts.map +1 -0
  242. package/dist/lib/email-providers-from-env.d.ts +12 -0
  243. package/dist/lib/email-providers-from-env.d.ts.map +1 -0
  244. package/dist/lib/email-service-types.d.ts +189 -0
  245. package/dist/lib/email-service-types.d.ts.map +1 -0
  246. package/dist/lib/email-stats.d.ts +12 -0
  247. package/dist/lib/email-stats.d.ts.map +1 -0
  248. package/dist/lib/email.d.ts +73 -0
  249. package/dist/lib/email.d.ts.map +1 -0
  250. package/dist/lib/enrichment-ledger.d.ts +101 -0
  251. package/dist/lib/enrichment-ledger.d.ts.map +1 -0
  252. package/dist/lib/enrichment-provider-registry.d.ts +20 -0
  253. package/dist/lib/enrichment-provider-registry.d.ts.map +1 -0
  254. package/dist/lib/enrichment-providers-from-env.d.ts +13 -0
  255. package/dist/lib/enrichment-providers-from-env.d.ts.map +1 -0
  256. package/dist/lib/enrichment-registry-singleton.d.ts +9 -0
  257. package/dist/lib/enrichment-registry-singleton.d.ts.map +1 -0
  258. package/dist/lib/enrollment-guards.d.ts +28 -0
  259. package/dist/lib/enrollment-guards.d.ts.map +1 -0
  260. package/dist/lib/enrollment-policy.d.ts +25 -0
  261. package/dist/lib/enrollment-policy.d.ts.map +1 -0
  262. package/dist/lib/event-names.d.ts +27 -0
  263. package/dist/lib/event-names.d.ts.map +1 -0
  264. package/dist/lib/feed.d.ts +64 -0
  265. package/dist/lib/feed.d.ts.map +1 -0
  266. package/dist/lib/flags-registry.d.ts +23 -0
  267. package/dist/lib/flags-registry.d.ts.map +1 -0
  268. package/dist/lib/flags.d.ts +143 -0
  269. package/dist/lib/flags.d.ts.map +1 -0
  270. package/dist/lib/frequency-cap.d.ts +38 -0
  271. package/dist/lib/frequency-cap.d.ts.map +1 -0
  272. package/dist/lib/from-address.d.ts +15 -0
  273. package/dist/lib/from-address.d.ts.map +1 -0
  274. package/dist/lib/funnel-progress.d.ts +37 -0
  275. package/dist/lib/funnel-progress.d.ts.map +1 -0
  276. package/dist/lib/funnel-registry.d.ts +44 -0
  277. package/dist/lib/funnel-registry.d.ts.map +1 -0
  278. package/dist/lib/funnel-transitions.d.ts +63 -0
  279. package/dist/lib/funnel-transitions.d.ts.map +1 -0
  280. package/dist/lib/fx.d.ts +118 -0
  281. package/dist/lib/fx.d.ts.map +1 -0
  282. package/dist/lib/global-control-readout.d.ts +72 -0
  283. package/dist/lib/global-control-readout.d.ts.map +1 -0
  284. package/dist/lib/groups.d.ts +138 -0
  285. package/dist/lib/groups.d.ts.map +1 -0
  286. package/dist/lib/hatchet-duration.d.ts +14 -0
  287. package/dist/lib/hatchet-duration.d.ts.map +1 -0
  288. package/dist/lib/hatchet.d.ts +3 -0
  289. package/dist/lib/hatchet.d.ts.map +1 -0
  290. package/dist/lib/headers.d.ts +8 -0
  291. package/dist/lib/headers.d.ts.map +1 -0
  292. package/dist/lib/holdout.d.ts +36 -0
  293. package/dist/lib/holdout.d.ts.map +1 -0
  294. package/dist/lib/html.d.ts +5 -0
  295. package/dist/lib/html.d.ts.map +1 -0
  296. package/dist/lib/identity-service.d.ts +60 -0
  297. package/dist/lib/identity-service.d.ts.map +1 -0
  298. package/dist/lib/identity-token.d.ts +81 -0
  299. package/dist/lib/identity-token.d.ts.map +1 -0
  300. package/dist/lib/ingestion.d.ts +218 -0
  301. package/dist/lib/ingestion.d.ts.map +1 -0
  302. package/dist/lib/journey-lift.d.ts +56 -0
  303. package/dist/lib/journey-lift.d.ts.map +1 -0
  304. package/dist/lib/journey-suppress.d.ts +59 -0
  305. package/dist/lib/journey-suppress.d.ts.map +1 -0
  306. package/dist/lib/leader-lease.d.ts +36 -0
  307. package/dist/lib/leader-lease.d.ts.map +1 -0
  308. package/dist/lib/lift-stats.d.ts +46 -0
  309. package/dist/lib/lift-stats.d.ts.map +1 -0
  310. package/dist/lib/links.d.ts +186 -0
  311. package/dist/lib/links.d.ts.map +1 -0
  312. package/dist/lib/load-optional-plugin.d.ts +47 -0
  313. package/dist/lib/load-optional-plugin.d.ts.map +1 -0
  314. package/dist/lib/logger.d.ts +4 -0
  315. package/dist/lib/logger.d.ts.map +1 -0
  316. package/dist/lib/mailer.d.ts +43 -0
  317. package/dist/lib/mailer.d.ts.map +1 -0
  318. package/dist/lib/metrics-sql.d.ts +11 -0
  319. package/dist/lib/metrics-sql.d.ts.map +1 -0
  320. package/dist/lib/notifications.d.ts +17 -0
  321. package/dist/lib/notifications.d.ts.map +1 -0
  322. package/dist/lib/oauth-token-manager.d.ts +74 -0
  323. package/dist/lib/oauth-token-manager.d.ts.map +1 -0
  324. package/dist/lib/operator-settings.d.ts +33 -0
  325. package/dist/lib/operator-settings.d.ts.map +1 -0
  326. package/dist/lib/operator.d.ts +20 -0
  327. package/dist/lib/operator.d.ts.map +1 -0
  328. package/dist/lib/outbound-endpoint-cache.d.ts +25 -0
  329. package/dist/lib/outbound-endpoint-cache.d.ts.map +1 -0
  330. package/dist/lib/outbound.d.ts +687 -0
  331. package/dist/lib/outbound.d.ts.map +1 -0
  332. package/dist/lib/phone.d.ts +11 -0
  333. package/dist/lib/phone.d.ts.map +1 -0
  334. package/dist/lib/posthog-scopes.d.ts +30 -0
  335. package/dist/lib/posthog-scopes.d.ts.map +1 -0
  336. package/dist/lib/posthog.d.ts +16 -0
  337. package/dist/lib/posthog.d.ts.map +1 -0
  338. package/dist/lib/preferences.d.ts +72 -0
  339. package/dist/lib/preferences.d.ts.map +1 -0
  340. package/dist/lib/provider-credentials.d.ts +149 -0
  341. package/dist/lib/provider-credentials.d.ts.map +1 -0
  342. package/dist/lib/provision-posthog-loop.d.ts +100 -0
  343. package/dist/lib/provision-posthog-loop.d.ts.map +1 -0
  344. package/dist/lib/recipient-preferences.d.ts +29 -0
  345. package/dist/lib/recipient-preferences.d.ts.map +1 -0
  346. package/dist/lib/redis.d.ts +33 -0
  347. package/dist/lib/redis.d.ts.map +1 -0
  348. package/dist/lib/referral-intent.d.ts +99 -0
  349. package/dist/lib/referral-intent.d.ts.map +1 -0
  350. package/dist/lib/referral-link.d.ts +59 -0
  351. package/dist/lib/referral-link.d.ts.map +1 -0
  352. package/dist/lib/referral-registry.d.ts +37 -0
  353. package/dist/lib/referral-registry.d.ts.map +1 -0
  354. package/dist/lib/referral-report.d.ts +178 -0
  355. package/dist/lib/referral-report.d.ts.map +1 -0
  356. package/dist/lib/referral-runtime.d.ts +43 -0
  357. package/dist/lib/referral-runtime.d.ts.map +1 -0
  358. package/dist/lib/referrals.d.ts +184 -0
  359. package/dist/lib/referrals.d.ts.map +1 -0
  360. package/dist/lib/refine-chain.d.ts +236 -0
  361. package/dist/lib/refine-chain.d.ts.map +1 -0
  362. package/dist/lib/refine-traits.d.ts +78 -0
  363. package/dist/lib/refine-traits.d.ts.map +1 -0
  364. package/dist/lib/refine.d.ts +35 -0
  365. package/dist/lib/refine.d.ts.map +1 -0
  366. package/dist/lib/reset-email.d.ts +38 -0
  367. package/dist/lib/reset-email.d.ts.map +1 -0
  368. package/dist/lib/revenue.d.ts +61 -0
  369. package/dist/lib/revenue.d.ts.map +1 -0
  370. package/dist/lib/schemas.d.ts +9 -0
  371. package/dist/lib/schemas.d.ts.map +1 -0
  372. package/dist/lib/seed-posthog-destination.d.ts +22 -0
  373. package/dist/lib/seed-posthog-destination.d.ts.map +1 -0
  374. package/dist/lib/semantic-click.d.ts +58 -0
  375. package/dist/lib/semantic-click.d.ts.map +1 -0
  376. package/dist/lib/sending-domain-guidance.d.ts +40 -0
  377. package/dist/lib/sending-domain-guidance.d.ts.map +1 -0
  378. package/dist/lib/singleton.d.ts +24 -0
  379. package/dist/lib/singleton.d.ts.map +1 -0
  380. package/dist/lib/sms-frequency-cap.d.ts +16 -0
  381. package/dist/lib/sms-frequency-cap.d.ts.map +1 -0
  382. package/dist/lib/sms-inbound.d.ts +37 -0
  383. package/dist/lib/sms-inbound.d.ts.map +1 -0
  384. package/dist/lib/sms-link-tracking.d.ts +53 -0
  385. package/dist/lib/sms-link-tracking.d.ts.map +1 -0
  386. package/dist/lib/sms-mailer.d.ts +12 -0
  387. package/dist/lib/sms-mailer.d.ts.map +1 -0
  388. package/dist/lib/sms-provider-registry.d.ts +20 -0
  389. package/dist/lib/sms-provider-registry.d.ts.map +1 -0
  390. package/dist/lib/sms-providers-from-env.d.ts +4 -0
  391. package/dist/lib/sms-providers-from-env.d.ts.map +1 -0
  392. package/dist/lib/sms-service-types.d.ts +131 -0
  393. package/dist/lib/sms-service-types.d.ts.map +1 -0
  394. package/dist/lib/sms-tracked.d.ts +36 -0
  395. package/dist/lib/sms-tracked.d.ts.map +1 -0
  396. package/dist/lib/sms.d.ts +58 -0
  397. package/dist/lib/sms.d.ts.map +1 -0
  398. package/dist/lib/snippet.d.ts +32 -0
  399. package/dist/lib/snippet.d.ts.map +1 -0
  400. package/dist/lib/stable-stringify.d.ts +12 -0
  401. package/dist/lib/stable-stringify.d.ts.map +1 -0
  402. package/dist/lib/studio.d.ts +21 -0
  403. package/dist/lib/studio.d.ts.map +1 -0
  404. package/dist/lib/survey.d.ts +35 -0
  405. package/dist/lib/survey.d.ts.map +1 -0
  406. package/dist/lib/test-mode.d.ts +77 -0
  407. package/dist/lib/test-mode.d.ts.map +1 -0
  408. package/dist/lib/timezone.d.ts +55 -0
  409. package/dist/lib/timezone.d.ts.map +1 -0
  410. package/dist/lib/tracked.d.ts +95 -0
  411. package/dist/lib/tracked.d.ts.map +1 -0
  412. package/dist/lib/tracking-event-names.d.ts +7 -0
  413. package/dist/lib/tracking-event-names.d.ts.map +1 -0
  414. package/dist/lib/tracking-events.d.ts +232 -0
  415. package/dist/lib/tracking-events.d.ts.map +1 -0
  416. package/dist/lib/tracking.d.ts +47 -0
  417. package/dist/lib/tracking.d.ts.map +1 -0
  418. package/dist/lib/unconfigured-email-provider.d.ts +20 -0
  419. package/dist/lib/unconfigured-email-provider.d.ts.map +1 -0
  420. package/dist/lib/unique-violation.d.ts +22 -0
  421. package/dist/lib/unique-violation.d.ts.map +1 -0
  422. package/dist/lib/user-token.d.ts +44 -0
  423. package/dist/lib/user-token.d.ts.map +1 -0
  424. package/dist/lib/variant.d.ts +44 -0
  425. package/dist/lib/variant.d.ts.map +1 -0
  426. package/dist/lib/webhook-signing.d.ts +120 -0
  427. package/dist/lib/webhook-signing.d.ts.map +1 -0
  428. package/dist/lib/worker-heartbeat.d.ts +18 -0
  429. package/dist/lib/worker-heartbeat.d.ts.map +1 -0
  430. package/dist/lists/channels.d.ts +43 -0
  431. package/dist/lists/channels.d.ts.map +1 -0
  432. package/dist/lists/define-list.d.ts +76 -0
  433. package/dist/lists/define-list.d.ts.map +1 -0
  434. package/dist/lists/registry-singleton.d.ts +8 -0
  435. package/dist/lists/registry-singleton.d.ts.map +1 -0
  436. package/dist/lists/registry.d.ts +66 -0
  437. package/dist/lists/registry.d.ts.map +1 -0
  438. package/dist/lists/subscription.d.ts +10 -0
  439. package/dist/lists/subscription.d.ts.map +1 -0
  440. package/dist/mcp/authoring-guide.d.ts +33 -0
  441. package/dist/mcp/authoring-guide.d.ts.map +1 -0
  442. package/dist/mcp/blueprint-tools.d.ts +266 -0
  443. package/dist/mcp/blueprint-tools.d.ts.map +1 -0
  444. package/dist/middleware/api-key.d.ts +45 -0
  445. package/dist/middleware/api-key.d.ts.map +1 -0
  446. package/dist/middleware/audit.d.ts +3 -0
  447. package/dist/middleware/audit.d.ts.map +1 -0
  448. package/dist/middleware/error-handler.d.ts +4 -0
  449. package/dist/middleware/error-handler.d.ts.map +1 -0
  450. package/dist/middleware/publishable-key.d.ts +27 -0
  451. package/dist/middleware/publishable-key.d.ts.map +1 -0
  452. package/dist/middleware/rate-limit.d.ts +105 -0
  453. package/dist/middleware/rate-limit.d.ts.map +1 -0
  454. package/dist/middleware/request-logger.d.ts +4 -0
  455. package/dist/middleware/request-logger.d.ts.map +1 -0
  456. package/dist/middleware/require-admin.d.ts +3 -0
  457. package/dist/middleware/require-admin.d.ts.map +1 -0
  458. package/dist/routes/_shared.d.ts +52 -0
  459. package/dist/routes/_shared.d.ts.map +1 -0
  460. package/dist/routes/accounts/callback.d.ts +18 -0
  461. package/dist/routes/accounts/callback.d.ts.map +1 -0
  462. package/dist/routes/accounts/emit.d.ts +96 -0
  463. package/dist/routes/accounts/emit.d.ts.map +1 -0
  464. package/dist/routes/accounts/import-links.d.ts +4 -0
  465. package/dist/routes/accounts/import-links.d.ts.map +1 -0
  466. package/dist/routes/accounts/index.d.ts +39 -0
  467. package/dist/routes/accounts/index.d.ts.map +1 -0
  468. package/dist/routes/accounts/lookup.d.ts +6 -0
  469. package/dist/routes/accounts/lookup.d.ts.map +1 -0
  470. package/dist/routes/accounts/me.d.ts +5 -0
  471. package/dist/routes/accounts/me.d.ts.map +1 -0
  472. package/dist/routes/accounts/mint.d.ts +5 -0
  473. package/dist/routes/accounts/mint.d.ts.map +1 -0
  474. package/dist/routes/accounts/pages.d.ts +23 -0
  475. package/dist/routes/accounts/pages.d.ts.map +1 -0
  476. package/dist/routes/accounts/resolve.d.ts +33 -0
  477. package/dist/routes/accounts/resolve.d.ts.map +1 -0
  478. package/dist/routes/accounts/serialize.d.ts +57 -0
  479. package/dist/routes/accounts/serialize.d.ts.map +1 -0
  480. package/dist/routes/accounts/shared.d.ts +68 -0
  481. package/dist/routes/accounts/shared.d.ts.map +1 -0
  482. package/dist/routes/accounts/start.d.ts +16 -0
  483. package/dist/routes/accounts/start.d.ts.map +1 -0
  484. package/dist/routes/accounts/unlink.d.ts +36 -0
  485. package/dist/routes/accounts/unlink.d.ts.map +1 -0
  486. package/dist/routes/admin/agent.d.ts +4 -0
  487. package/dist/routes/admin/agent.d.ts.map +1 -0
  488. package/dist/routes/admin/alerts.d.ts +190 -0
  489. package/dist/routes/admin/alerts.d.ts.map +1 -0
  490. package/dist/routes/admin/analytics.d.ts +137 -0
  491. package/dist/routes/admin/analytics.d.ts.map +1 -0
  492. package/dist/routes/admin/api-keys.d.ts +158 -0
  493. package/dist/routes/admin/api-keys.d.ts.map +1 -0
  494. package/dist/routes/admin/attribution.d.ts +93 -0
  495. package/dist/routes/admin/attribution.d.ts.map +1 -0
  496. package/dist/routes/admin/audit-logs.d.ts +40 -0
  497. package/dist/routes/admin/audit-logs.d.ts.map +1 -0
  498. package/dist/routes/admin/blueprints.d.ts +4 -0
  499. package/dist/routes/admin/blueprints.d.ts.map +1 -0
  500. package/dist/routes/admin/buckets.d.ts +215 -0
  501. package/dist/routes/admin/buckets.d.ts.map +1 -0
  502. package/dist/routes/admin/bulk.d.ts +203 -0
  503. package/dist/routes/admin/bulk.d.ts.map +1 -0
  504. package/dist/routes/admin/campaigns.d.ts +198 -0
  505. package/dist/routes/admin/campaigns.d.ts.map +1 -0
  506. package/dist/routes/admin/connectors.d.ts +116 -0
  507. package/dist/routes/admin/connectors.d.ts.map +1 -0
  508. package/dist/routes/admin/contacts.d.ts +246 -0
  509. package/dist/routes/admin/contacts.d.ts.map +1 -0
  510. package/dist/routes/admin/conversions.d.ts +103 -0
  511. package/dist/routes/admin/conversions.d.ts.map +1 -0
  512. package/dist/routes/admin/deals.d.ts +136 -0
  513. package/dist/routes/admin/deals.d.ts.map +1 -0
  514. package/dist/routes/admin/dlq.d.ts +100 -0
  515. package/dist/routes/admin/dlq.d.ts.map +1 -0
  516. package/dist/routes/admin/domain.d.ts +314 -0
  517. package/dist/routes/admin/domain.d.ts.map +1 -0
  518. package/dist/routes/admin/emails.d.ts +127 -0
  519. package/dist/routes/admin/emails.d.ts.map +1 -0
  520. package/dist/routes/admin/events.d.ts +140 -0
  521. package/dist/routes/admin/events.d.ts.map +1 -0
  522. package/dist/routes/admin/flags.d.ts +719 -0
  523. package/dist/routes/admin/flags.d.ts.map +1 -0
  524. package/dist/routes/admin/funnels.d.ts +71 -0
  525. package/dist/routes/admin/funnels.d.ts.map +1 -0
  526. package/dist/routes/admin/groups.d.ts +169 -0
  527. package/dist/routes/admin/groups.d.ts.map +1 -0
  528. package/dist/routes/admin/identity.d.ts +72 -0
  529. package/dist/routes/admin/identity.d.ts.map +1 -0
  530. package/dist/routes/admin/impact-schemas.d.ts +48 -0
  531. package/dist/routes/admin/impact-schemas.d.ts.map +1 -0
  532. package/dist/routes/admin/impact.d.ts +316 -0
  533. package/dist/routes/admin/impact.d.ts.map +1 -0
  534. package/dist/routes/admin/index.d.ts +4 -0
  535. package/dist/routes/admin/index.d.ts.map +1 -0
  536. package/dist/routes/admin/journey-impact.d.ts +320 -0
  537. package/dist/routes/admin/journey-impact.d.ts.map +1 -0
  538. package/dist/routes/admin/journey-logs.d.ts +57 -0
  539. package/dist/routes/admin/journey-logs.d.ts.map +1 -0
  540. package/dist/routes/admin/journeys.d.ts +736 -0
  541. package/dist/routes/admin/journeys.d.ts.map +1 -0
  542. package/dist/routes/admin/links.d.ts +382 -0
  543. package/dist/routes/admin/links.d.ts.map +1 -0
  544. package/dist/routes/admin/lists.d.ts +22 -0
  545. package/dist/routes/admin/lists.d.ts.map +1 -0
  546. package/dist/routes/admin/maintenance.d.ts +72 -0
  547. package/dist/routes/admin/maintenance.d.ts.map +1 -0
  548. package/dist/routes/admin/metrics.d.ts +212 -0
  549. package/dist/routes/admin/metrics.d.ts.map +1 -0
  550. package/dist/routes/admin/open-editor.d.ts +36 -0
  551. package/dist/routes/admin/open-editor.d.ts.map +1 -0
  552. package/dist/routes/admin/preferences.d.ts +109 -0
  553. package/dist/routes/admin/preferences.d.ts.map +1 -0
  554. package/dist/routes/admin/provider-credentials.d.ts +108 -0
  555. package/dist/routes/admin/provider-credentials.d.ts.map +1 -0
  556. package/dist/routes/admin/readiness.d.ts +24 -0
  557. package/dist/routes/admin/readiness.d.ts.map +1 -0
  558. package/dist/routes/admin/referrals.d.ts +230 -0
  559. package/dist/routes/admin/referrals.d.ts.map +1 -0
  560. package/dist/routes/admin/reporting.d.ts +149 -0
  561. package/dist/routes/admin/reporting.d.ts.map +1 -0
  562. package/dist/routes/admin/settings.d.ts +80 -0
  563. package/dist/routes/admin/settings.d.ts.map +1 -0
  564. package/dist/routes/admin/suppressions.d.ts +90 -0
  565. package/dist/routes/admin/suppressions.d.ts.map +1 -0
  566. package/dist/routes/admin/targeting.d.ts +58 -0
  567. package/dist/routes/admin/targeting.d.ts.map +1 -0
  568. package/dist/routes/admin/templates.d.ts +197 -0
  569. package/dist/routes/admin/templates.d.ts.map +1 -0
  570. package/dist/routes/admin/timeline.d.ts +51 -0
  571. package/dist/routes/admin/timeline.d.ts.map +1 -0
  572. package/dist/routes/admin/webhooks.d.ts +250 -0
  573. package/dist/routes/admin/webhooks.d.ts.map +1 -0
  574. package/dist/routes/campaigns/index.d.ts +239 -0
  575. package/dist/routes/campaigns/index.d.ts.map +1 -0
  576. package/dist/routes/connectors/index.d.ts +16 -0
  577. package/dist/routes/connectors/index.d.ts.map +1 -0
  578. package/dist/routes/contacts/index.d.ts +187 -0
  579. package/dist/routes/contacts/index.d.ts.map +1 -0
  580. package/dist/routes/email/index.d.ts +4 -0
  581. package/dist/routes/email/index.d.ts.map +1 -0
  582. package/dist/routes/email/preferences.d.ts +17 -0
  583. package/dist/routes/email/preferences.d.ts.map +1 -0
  584. package/dist/routes/email/unsubscribe.d.ts +17 -0
  585. package/dist/routes/email/unsubscribe.d.ts.map +1 -0
  586. package/dist/routes/emails/index.d.ts +90 -0
  587. package/dist/routes/emails/index.d.ts.map +1 -0
  588. package/dist/routes/events/index.d.ts +116 -0
  589. package/dist/routes/events/index.d.ts.map +1 -0
  590. package/dist/routes/feed/index.d.ts +248 -0
  591. package/dist/routes/feed/index.d.ts.map +1 -0
  592. package/dist/routes/feed/recipient.d.ts +65 -0
  593. package/dist/routes/feed/recipient.d.ts.map +1 -0
  594. package/dist/routes/flags/index.d.ts +94 -0
  595. package/dist/routes/flags/index.d.ts.map +1 -0
  596. package/dist/routes/groups/index.d.ts +192 -0
  597. package/dist/routes/groups/index.d.ts.map +1 -0
  598. package/dist/routes/health.d.ts +57 -0
  599. package/dist/routes/health.d.ts.map +1 -0
  600. package/dist/routes/index.d.ts +8 -0
  601. package/dist/routes/index.d.ts.map +1 -0
  602. package/dist/routes/lists/index.d.ts +266 -0
  603. package/dist/routes/lists/index.d.ts.map +1 -0
  604. package/dist/routes/referrals/index.d.ts +22 -0
  605. package/dist/routes/referrals/index.d.ts.map +1 -0
  606. package/dist/routes/referrals/me.d.ts +4 -0
  607. package/dist/routes/referrals/me.d.ts.map +1 -0
  608. package/dist/routes/referrals/report.d.ts +5 -0
  609. package/dist/routes/referrals/report.d.ts.map +1 -0
  610. package/dist/routes/referrals/shared.d.ts +16 -0
  611. package/dist/routes/referrals/shared.d.ts.map +1 -0
  612. package/dist/routes/referrals/touch.d.ts +5 -0
  613. package/dist/routes/referrals/touch.d.ts.map +1 -0
  614. package/dist/routes/snippet.d.ts +12 -0
  615. package/dist/routes/snippet.d.ts.map +1 -0
  616. package/dist/routes/tracking/answer.d.ts +56 -0
  617. package/dist/routes/tracking/answer.d.ts.map +1 -0
  618. package/dist/routes/tracking/arrive.d.ts +32 -0
  619. package/dist/routes/tracking/arrive.d.ts.map +1 -0
  620. package/dist/routes/tracking/click-pipeline.d.ts +213 -0
  621. package/dist/routes/tracking/click-pipeline.d.ts.map +1 -0
  622. package/dist/routes/tracking/click.d.ts +26 -0
  623. package/dist/routes/tracking/click.d.ts.map +1 -0
  624. package/dist/routes/tracking/identify.d.ts +32 -0
  625. package/dist/routes/tracking/identify.d.ts.map +1 -0
  626. package/dist/routes/tracking/index.d.ts +4 -0
  627. package/dist/routes/tracking/index.d.ts.map +1 -0
  628. package/dist/routes/tracking/open.d.ts +17 -0
  629. package/dist/routes/tracking/open.d.ts.map +1 -0
  630. package/dist/routes/tracking/short.d.ts +17 -0
  631. package/dist/routes/tracking/short.d.ts.map +1 -0
  632. package/dist/routes/tracking/vanity.d.ts +17 -0
  633. package/dist/routes/tracking/vanity.d.ts.map +1 -0
  634. package/dist/routes/webhooks/crm-provider.d.ts +24 -0
  635. package/dist/routes/webhooks/crm-provider.d.ts.map +1 -0
  636. package/dist/routes/webhooks/email-provider.d.ts +21 -0
  637. package/dist/routes/webhooks/email-provider.d.ts.map +1 -0
  638. package/dist/routes/webhooks/index.d.ts +8 -0
  639. package/dist/routes/webhooks/index.d.ts.map +1 -0
  640. package/dist/routes/webhooks/resend.d.ts +35 -0
  641. package/dist/routes/webhooks/resend.d.ts.map +1 -0
  642. package/dist/routes/webhooks/sms-provider.d.ts +23 -0
  643. package/dist/routes/webhooks/sms-provider.d.ts.map +1 -0
  644. package/dist/routes/webhooks/sources.d.ts +12 -0
  645. package/dist/routes/webhooks/sources.d.ts.map +1 -0
  646. package/dist/sources/define-contact-source.d.ts +114 -0
  647. package/dist/sources/define-contact-source.d.ts.map +1 -0
  648. package/dist/sources/registry.d.ts +31 -0
  649. package/dist/sources/registry.d.ts.map +1 -0
  650. package/dist/sources/webhook-source.d.ts +53 -0
  651. package/dist/sources/webhook-source.d.ts.map +1 -0
  652. package/dist/testing.d.ts +10 -0
  653. package/dist/testing.d.ts.map +1 -0
  654. package/dist/webhook-sources/define-webhook-source.d.ts +60 -0
  655. package/dist/webhook-sources/define-webhook-source.d.ts.map +1 -0
  656. package/dist/webhook-sources/presets/clerk.d.ts +9 -0
  657. package/dist/webhook-sources/presets/clerk.d.ts.map +1 -0
  658. package/dist/webhook-sources/presets/index.d.ts +140 -0
  659. package/dist/webhook-sources/presets/index.d.ts.map +1 -0
  660. package/dist/webhook-sources/presets/intercom.d.ts +44 -0
  661. package/dist/webhook-sources/presets/intercom.d.ts.map +1 -0
  662. package/dist/webhook-sources/presets/segment.d.ts +16 -0
  663. package/dist/webhook-sources/presets/segment.d.ts.map +1 -0
  664. package/dist/webhook-sources/presets/stripe.d.ts +20 -0
  665. package/dist/webhook-sources/presets/stripe.d.ts.map +1 -0
  666. package/dist/webhook-sources/presets/supabase.d.ts +23 -0
  667. package/dist/webhook-sources/presets/supabase.d.ts.map +1 -0
  668. package/dist/webhook-sources/verify.d.ts +48 -0
  669. package/dist/webhook-sources/verify.d.ts.map +1 -0
  670. package/dist/worker.d.ts +37 -0
  671. package/dist/worker.d.ts.map +1 -0
  672. package/dist/workflows/backfill-contact-id.d.ts +202 -0
  673. package/dist/workflows/backfill-contact-id.d.ts.map +1 -0
  674. package/dist/workflows/bucket-backfill.d.ts +64 -0
  675. package/dist/workflows/bucket-backfill.d.ts.map +1 -0
  676. package/dist/workflows/bucket-reconcile.d.ts +73 -0
  677. package/dist/workflows/bucket-reconcile.d.ts.map +1 -0
  678. package/dist/workflows/check-alerts.d.ts +10 -0
  679. package/dist/workflows/check-alerts.d.ts.map +1 -0
  680. package/dist/workflows/confirm-semantic-click.d.ts +15 -0
  681. package/dist/workflows/confirm-semantic-click.d.ts.map +1 -0
  682. package/dist/workflows/crm-reconcile.d.ts +27 -0
  683. package/dist/workflows/crm-reconcile.d.ts.map +1 -0
  684. package/dist/workflows/deliver-webhook.d.ts +88 -0
  685. package/dist/workflows/deliver-webhook.d.ts.map +1 -0
  686. package/dist/workflows/dispatch-conversion.d.ts +14 -0
  687. package/dist/workflows/dispatch-conversion.d.ts.map +1 -0
  688. package/dist/workflows/identity-alias-backfill.d.ts +96 -0
  689. package/dist/workflows/identity-alias-backfill.d.ts.map +1 -0
  690. package/dist/workflows/impact-digest.d.ts +142 -0
  691. package/dist/workflows/impact-digest.d.ts.map +1 -0
  692. package/dist/workflows/import-contacts.d.ts +14 -0
  693. package/dist/workflows/import-contacts.d.ts.map +1 -0
  694. package/dist/workflows/import-suppressions.d.ts +55 -0
  695. package/dist/workflows/import-suppressions.d.ts.map +1 -0
  696. package/dist/workflows/journey-blueprint-interpreter.d.ts +73 -0
  697. package/dist/workflows/journey-blueprint-interpreter.d.ts.map +1 -0
  698. package/dist/workflows/send-campaign.d.ts +128 -0
  699. package/dist/workflows/send-campaign.d.ts.map +1 -0
  700. package/dist/workflows/send-email.d.ts +15 -0
  701. package/dist/workflows/send-email.d.ts.map +1 -0
  702. package/dist/workflows/send-feed.d.ts +37 -0
  703. package/dist/workflows/send-feed.d.ts.map +1 -0
  704. package/package.json +60 -22
  705. package/src/app.ts +9 -1
  706. package/src/buckets/check-membership.ts +54 -20
  707. package/src/container.ts +77 -0
  708. package/src/env.ts +30 -0
  709. package/src/index.ts +78 -0
  710. package/src/journeys/journey-log.ts +25 -8
  711. package/src/lib/contacts.ts +117 -1
  712. package/src/lib/email-service-types.ts +10 -0
  713. package/src/lib/ingestion.ts +91 -19
  714. package/src/lib/links.ts +94 -11
  715. package/src/lib/mailer-bounce-idempotency.test.ts +7 -2
  716. package/src/lib/mailer-replied.test.ts +7 -2
  717. package/src/lib/mailer.ts +1 -0
  718. package/src/lib/outbound-endpoint-cache.ts +83 -0
  719. package/src/lib/outbound.ts +150 -37
  720. package/src/lib/referral-intent.ts +723 -0
  721. package/src/lib/referral-link.ts +200 -0
  722. package/src/lib/referral-registry.ts +83 -0
  723. package/src/lib/referral-report.ts +739 -0
  724. package/src/lib/referral-runtime.ts +49 -0
  725. package/src/lib/referrals-no-emit.test.ts +109 -0
  726. package/src/lib/referrals.ts +712 -0
  727. package/src/lib/seed-posthog-destination.ts +5 -1
  728. package/src/lib/tracked.ts +11 -3
  729. package/src/lib/tracking-events.ts +20 -3
  730. package/src/lib/webhook-signing.ts +10 -0
  731. package/src/middleware/api-key.ts +69 -60
  732. package/src/middleware/publishable-key.ts +11 -23
  733. package/src/middleware/rate-limit.ts +165 -3
  734. package/src/routes/admin/api-keys.ts +153 -0
  735. package/src/routes/admin/index.ts +2 -0
  736. package/src/routes/admin/links.ts +14 -5
  737. package/src/routes/admin/referrals.ts +565 -0
  738. package/src/routes/admin/targeting.ts +6 -1
  739. package/src/routes/admin/webhooks.ts +4 -0
  740. package/src/routes/contacts/index.ts +78 -0
  741. package/src/routes/index.ts +104 -22
  742. package/src/routes/referrals/index.ts +41 -0
  743. package/src/routes/referrals/me.ts +123 -0
  744. package/src/routes/referrals/report.ts +285 -0
  745. package/src/routes/referrals/shared.ts +34 -0
  746. package/src/routes/referrals/touch.ts +313 -0
  747. package/src/routes/tracking/arrive.ts +90 -0
  748. package/src/routes/tracking/click-pipeline.ts +8 -0
  749. package/src/workflows/backfill-contact-id.ts +3 -7
  750. package/src/workflows/bucket-backfill.ts +2 -2
  751. package/src/workflows/bucket-reconcile.ts +28 -12
  752. package/src/workflows/check-alerts.ts +3 -9
  753. package/src/workflows/crm-reconcile.ts +3 -2
  754. package/src/workflows/deliver-webhook.ts +21 -8
  755. package/src/workflows/dispatch-conversion.ts +2 -2
  756. package/src/workflows/identity-alias-backfill.ts +3 -2
  757. package/src/workflows/impact-digest.ts +2 -2
  758. package/src/workflows/import-contacts.ts +3 -4
  759. package/src/workflows/import-suppressions.ts +4 -5
  760. package/src/workflows/send-campaign.ts +10 -1
@@ -0,0 +1,23 @@
1
+ import type { DefinedFlag } from "@hogsend/core";
2
+ import type { Logger } from "./logger.js";
3
+ /**
4
+ * Registry of code-defined feature flags ({@link defineFlag}), the flag sibling
5
+ * of `ConversionRegistry`. Indexed by `meta.key`; a duplicate key warns and is
6
+ * skipped (first definition wins) so one fat-fingered copy-paste never silently
7
+ * shadows another flag. Constructed by `createHogsendClient` from `opts.flags`
8
+ * and installed on the process singleton so the boot reconciler + Studio can
9
+ * read it without a client reference.
10
+ */
11
+ export declare class FlagRegistry {
12
+ private byKey;
13
+ constructor(definitions?: DefinedFlag[], logger?: Logger);
14
+ get(key: string): DefinedFlag | undefined;
15
+ has(key: string): boolean;
16
+ getAll(): DefinedFlag[];
17
+ count(): number;
18
+ }
19
+ export declare const setFlagRegistry: (value: FlagRegistry | undefined) => void;
20
+ export declare const getFlagRegistry: () => FlagRegistry | undefined;
21
+ /** Reset the singleton — only for test cleanup. */
22
+ export declare const resetFlagRegistry: () => void;
23
+ //# sourceMappingURL=flags-registry.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"flags-registry.d.ts","sourceRoot":"","sources":["../../src/lib/flags-registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAG1C;;;;;;;GAOG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,KAAK,CAAkC;gBAEnC,WAAW,GAAE,WAAW,EAAO,EAAE,MAAM,CAAC,EAAE,MAAM;IAW5D,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS;IAIzC,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAIzB,MAAM,IAAI,WAAW,EAAE;IAIvB,KAAK,IAAI,MAAM;CAGhB;AAGD,eAAO,MAAM,eAAe,2CAAgB,CAAC;AAC7C,eAAO,MAAM,eAAe,gCAAgB,CAAC;AAC7C,mDAAmD;AACnD,eAAO,MAAM,iBAAiB,YAAkB,CAAC"}
@@ -0,0 +1,143 @@
1
+ import type { ConditionSet, FlagTargeting, FlagVariant, PropertyCondition } from "@hogsend/core";
2
+ import { type Database } from "@hogsend/db";
3
+ /**
4
+ * The structural subset of a flag the evaluator reads. Both the drizzle row
5
+ * (`flags.$inferSelect`) and the portable `FlagDefinition` (@hogsend/core)
6
+ * satisfy it, so the same pure function serves the DB path and any in-memory
7
+ * caller. `targeting` accepts BOTH the legacy `PropertyCondition[]` (implicit
8
+ * AND) and the condition tree ({@link FlagTargeting}); `conditionSets` is the
9
+ * richer ordered form (first matching set wins) and, when present, takes
10
+ * precedence over `targeting`+`rollout`.
11
+ */
12
+ export interface EvaluableFlag {
13
+ key: string;
14
+ enabled: boolean;
15
+ type: string;
16
+ variants: FlagVariant[];
17
+ defaultValue: unknown;
18
+ targeting: FlagTargeting | PropertyCondition[];
19
+ rollout: number;
20
+ conditionSets?: ConditionSet[] | null;
21
+ }
22
+ /**
23
+ * The FIXED, snapshot of the materialized contact state the pure targeting
24
+ * leaves read. Loaded ONCE per flag evaluation request (never per flag), so the
25
+ * browser `GET /v1/flags` hot path stays O(1) in the number of flags:
26
+ * - `properties` — the contact's stored properties (property leaves)
27
+ * - `email` — the contact's email, the key `email_engagement` scan leaves
28
+ * look up `email_sends` on (SERVER path only; `contactKey` is
29
+ * NOT an email, so without this the leaf never matches)
30
+ * - `buckets` — the ids of the contact's ACTIVE bucket memberships
31
+ * - `journeys` — per journey id, whether it is live (active/waiting) and/or
32
+ * has completed
33
+ * - `deals` — the contact's CRM deal posture (won/open + furthest stage)
34
+ */
35
+ export interface TargetingSnapshot {
36
+ properties: Record<string, unknown>;
37
+ email: string | null;
38
+ buckets: Set<string>;
39
+ journeys: Map<string, {
40
+ active: boolean;
41
+ completed: boolean;
42
+ }>;
43
+ deals: {
44
+ won: boolean;
45
+ open: boolean;
46
+ stage: string | null;
47
+ };
48
+ }
49
+ /** An empty snapshot (anon contact / no materialized rows). */
50
+ export declare function emptySnapshot(properties?: Record<string, unknown>): TargetingSnapshot;
51
+ /**
52
+ * Load the FIXED ~4-query targeting snapshot for a contact. `contactId` is the
53
+ * trusted uuid: it scopes the property + deal reads (see
54
+ * `evaluateFlagsForContact`'s security note) AND, via `bySubject`, the bucket +
55
+ * journey history reads. `contactKey` (`external_id ?? anonymous_id ?? id`) is
56
+ * the fallback those two history reads use when NO contact is resolved — an
57
+ * anonymous visitor, whose rows are still text-keyed. An anon contact with no
58
+ * rows yields empty sets — correct (targeting-gated flags fall to default).
59
+ */
60
+ export declare function loadTargetingSnapshot(opts: {
61
+ db: Database;
62
+ contactKey: string;
63
+ contactId?: string;
64
+ }): Promise<TargetingSnapshot>;
65
+ /**
66
+ * The context an async targeting evaluation runs in. `mode` gates the SERVER-
67
+ * ONLY scan leaves (`event`/`email_engagement`): they resolve via
68
+ * `evaluateCondition` ONLY when `mode==="server"` with `db`+`userId`, and
69
+ * short-circuit to `false` on the browser path (keeping the browser query count
70
+ * fixed — no per-flag DB access).
71
+ */
72
+ export interface TargetingEvalContext {
73
+ snapshot: TargetingSnapshot;
74
+ mode: "browser" | "server";
75
+ db?: Database;
76
+ userId?: string;
77
+ /**
78
+ * The SERVER-TRUSTED `contacts.id` for `userId`, forwarded verbatim to
79
+ * `ConditionContext.contactId` so a scan leaf reads the PERSON's history
80
+ * rather than whatever the mutable `userId` text key happens to name. Absent
81
+ * / null for a subject with no contact (an anonymous visitor), which keeps
82
+ * the scan on the text key exactly as before.
83
+ */
84
+ contactId?: string | null;
85
+ }
86
+ /**
87
+ * Fully evaluate a targeting node against the snapshot + mode. PURE leaves
88
+ * resolve from the snapshot; the SERVER-ONLY scan leaves resolve via
89
+ * `evaluateCondition` on the server path (else `false`); a COMPOSITE folds
90
+ * AND/OR (short-circuiting) over its children. A bare `PropertyCondition[]` is
91
+ * an implicit AND (empty ⇒ everyone); an empty COMPOSITE ⇒ everyone.
92
+ */
93
+ export declare function evaluateTargeting(node: FlagTargeting | PropertyCondition[] | null | undefined, ctx: TargetingEvalContext): Promise<boolean>;
94
+ /**
95
+ * Deterministic percent bucket in [0, 100) from a string. Mirrors the holdout
96
+ * hashing law (sha256's first 4 bytes → uniform bucket): NO RNG and NO clock,
97
+ * so the same input buckets identically forever. A contact is IN a set's
98
+ * rollout when `bucket < set.rollout` (see {@link evaluateFlag}).
99
+ */
100
+ export declare function flagBucket(input: string): number;
101
+ /**
102
+ * Deterministic unit in [0, 1) from a string — the weighted-variant selector.
103
+ * Same sha256-first-4-bytes construction as {@link flagBucket}, normalized over
104
+ * the full 32-bit range so the multivariate pick is uniform.
105
+ */
106
+ export declare function flagUnit(input: string): number;
107
+ /**
108
+ * SYNC, browser-pure evaluation of a flag for a contact. PURE leaves
109
+ * (property/bucket/journey/deal) resolve from `snapshot` (or, back-compat, from
110
+ * bare `properties`); the SERVER-ONLY scan leaves (event/email_engagement)
111
+ * evaluate to `false`. STICKY by construction. Precedence — walk the ordered
112
+ * condition sets; the FIRST set whose targeting matches AND whose per-set
113
+ * rollout bucket ({@link rolloutKey}) admits the contact wins; otherwise
114
+ * `defaultValue`.
115
+ */
116
+ export declare function evaluateFlag(flag: EvaluableFlag, ctx: {
117
+ contactKey: string;
118
+ properties: Record<string, unknown>;
119
+ snapshot?: TargetingSnapshot;
120
+ }): unknown;
121
+ /**
122
+ * Evaluate EVERY live (enabled, non-archived) flag for a contact and return the
123
+ * `{ key: value }` map. `contactKey` is the STICKY bucketing identity AND the
124
+ * key `bucket_memberships`/`journey_states`/`user_events` are read on; the
125
+ * SERVER-TRUSTED `contactId` (a resolved `contacts.id`, NEVER a re-resolved raw
126
+ * `contactKey`) scopes the property + deal reads — the same security boundary as
127
+ * before (a pk_ caller's raw `contactKey` must never load another contact's
128
+ * properties/deals).
129
+ *
130
+ * THE INVARIANT: the snapshot is loaded ONCE (a fixed ~4 indexed queries) and
131
+ * every flag evaluates against it, so the browser path issues a FIXED query
132
+ * count (flags query + snapshot) regardless of flag count. On `mode:"browser"`
133
+ * the server-only scan leaves (event/email_engagement) short-circuit to false —
134
+ * NO per-flag DB query runs. `mode:"server"` (the secret-key evaluate route)
135
+ * resolves those leaves via `evaluateCondition` keyed on `contactKey`.
136
+ */
137
+ export declare function evaluateFlagsForContact(opts: {
138
+ db: Database;
139
+ contactKey: string;
140
+ contactId?: string;
141
+ mode: "browser" | "server";
142
+ }): Promise<Record<string, unknown>>;
143
+ //# sourceMappingURL=flags.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"flags.d.ts","sourceRoot":"","sources":["../../src/lib/flags.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAEV,YAAY,EACZ,aAAa,EACb,WAAW,EACX,iBAAiB,EAClB,MAAM,eAAe,CAAC;AAMvB,OAAO,EAGL,KAAK,QAAQ,EAId,MAAM,aAAa,CAAC;AAGrB;;;;;;;;GAQG;AACH,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,YAAY,EAAE,OAAO,CAAC;IACtB,SAAS,EAAE,aAAa,GAAG,iBAAiB,EAAE,CAAC;IAC/C,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,YAAY,EAAE,GAAG,IAAI,CAAC;CACvC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,OAAO,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACrB,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE;QAAE,MAAM,EAAE,OAAO,CAAC;QAAC,SAAS,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IAC/D,KAAK,EAAE;QAAE,GAAG,EAAE,OAAO,CAAC;QAAC,IAAI,EAAE,OAAO,CAAC;QAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC;CAC9D;AAED,+DAA+D;AAC/D,wBAAgB,aAAa,CAC3B,UAAU,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GACvC,iBAAiB,CAQnB;AAED;;;;;;;;GAQG;AACH,wBAAsB,qBAAqB,CAAC,IAAI,EAAE;IAChD,EAAE,EAAE,QAAQ,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAsF7B;AAED;;;;;;GAMG;AACH,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,IAAI,EAAE,SAAS,GAAG,QAAQ,CAAC;IAC3B,EAAE,CAAC,EAAE,QAAQ,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;;;OAMG;IACH,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AA6CD;;;;;;GAMG;AACH,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,aAAa,GAAG,iBAAiB,EAAE,GAAG,IAAI,GAAG,SAAS,EAC5D,GAAG,EAAE,oBAAoB,GACxB,OAAO,CAAC,OAAO,CAAC,CA0ClB;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAGhD;AAeD;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAG9C;AA0CD;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAC1B,IAAI,EAAE,aAAa,EACnB,GAAG,EAAE;IACH,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpC,QAAQ,CAAC,EAAE,iBAAiB,CAAC;CAC9B,GACA,OAAO,CAeT;AAiED;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,uBAAuB,CAAC,IAAI,EAAE;IAClD,EAAE,EAAE,QAAQ,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,SAAS,GAAG,QAAQ,CAAC;CAC5B,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CA0BnC"}
@@ -0,0 +1,38 @@
1
+ import type { Database } from "@hogsend/db";
2
+ import type { FrequencyCapConfig } from "./email-service-types.js";
3
+ /**
4
+ * The windowed non-failed send count for a recipient — the COUNT behind
5
+ * {@link isFrequencyCapped}, shared with `ctx.throttle` (and later the suppress
6
+ * guard). Served by the `email_sends_freq_cap_idx (to_email, created_at,
7
+ * category)` index. Never-dispatched / failed rows (`status = 'failed'`) are
8
+ * excluded; a `category` narrows the count to that category.
9
+ *
10
+ * NOTE: NO exemption semantics live here — unlike {@link isFrequencyCapped}
11
+ * (which short-circuits an exempt "transactional" category), a `category` passed
12
+ * here genuinely counts that category's sends.
13
+ */
14
+ export declare function countRecentSends(opts: {
15
+ db: Database;
16
+ to: string;
17
+ since: Date;
18
+ category?: string;
19
+ }): Promise<number>;
20
+ /**
21
+ * True if this recipient has hit the configured send cap within the window.
22
+ *
23
+ * - `config` undefined → false (feature is opt-in; safe default = no cap).
24
+ * - An exempt `category` (default "transactional") → false.
25
+ * - A `byCategory[category]` override uses its own count/window AND filters the
26
+ * COUNT by that category; otherwise the global rule counts ALL of the
27
+ * recipient's non-failed sends in the window (NULL-category rows included).
28
+ *
29
+ * The COUNT is served by `email_sends_freq_cap_idx (to_email, created_at,
30
+ * category)`. Never-dispatched / failed rows (`status = 'failed'`) are excluded.
31
+ */
32
+ export declare function isFrequencyCapped(opts: {
33
+ db: Database;
34
+ to: string;
35
+ category?: string;
36
+ config?: FrequencyCapConfig;
37
+ }): Promise<boolean>;
38
+ //# sourceMappingURL=frequency-cap.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"frequency-cap.d.ts","sourceRoot":"","sources":["../../src/lib/frequency-cap.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAG5C,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAInE;;;;;;;;;;GAUG;AACH,wBAAsB,gBAAgB,CAAC,IAAI,EAAE;IAC3C,EAAE,EAAE,QAAQ,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,IAAI,CAAC;IACZ,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,GAAG,OAAO,CAAC,MAAM,CAAC,CAoBlB;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,iBAAiB,CAAC,IAAI,EAAE;IAC5C,EAAE,EAAE,QAAQ,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,kBAAkB,CAAC;CAC7B,GAAG,OAAO,CAAC,OAAO,CAAC,CAsBnB"}
@@ -0,0 +1,15 @@
1
+ /**
2
+ * From-address helpers. A configured from address may be a bare addr-spec
3
+ * ("doug@hogsend.com") or carry a display name ("Doug at Hogsend
4
+ * <doug@hogsend.com>") — both are valid on the wire for every supported
5
+ * provider. These helpers parse either form so env validation and
6
+ * domain derivation agree on what the address part is.
7
+ */
8
+ /**
9
+ * Extract the addr-spec from a from address ("Doug <d@x.com>" → "d@x.com",
10
+ * "d@x.com" → "d@x.com"). Returns null when no valid address is present.
11
+ */
12
+ export declare function addrSpecOf(value: string | undefined): string | null;
13
+ /** Host part of a from address ("Doug <d@x.com>" → "x.com"). */
14
+ export declare function hostOfFromAddress(value: string | undefined): string | null;
15
+ //# sourceMappingURL=from-address.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"from-address.d.ts","sourceRoot":"","sources":["../../src/lib/from-address.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH;;;GAGG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CAKnE;AAED,gEAAgE;AAChE,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CAM1E"}
@@ -0,0 +1,37 @@
1
+ import { type Database } from "@hogsend/db";
2
+ import type { FunnelRegistry } from "./funnel-registry.js";
3
+ import type { Logger } from "./logger.js";
4
+ /**
5
+ * Event-funnel REPORTING projection —
6
+ * one first-reach row per (contact, funnel, stage), the raw material for
7
+ * progression counts ("how many reached activated") and velocity ("median
8
+ * time signed_up → activated"). Complements the deals projection the
9
+ * transition machinery (funnel-transitions.ts) maintains: deals hold ONE
10
+ * current stage + money timestamps; this holds every stage's first-reach
11
+ * instant, which is what progression rates and velocity medians read.
12
+ *
13
+ * Targets come from {@link resolveFunnelTargets} — the SAME gates and
14
+ * winner selection as the deal mover, so the two projections can never
15
+ * disagree about what counts as a stage event. `lost` is a deal outcome,
16
+ * not progress, and is skipped; the unique (contact, funnel, stage) index
17
+ * absorbs replays and repeats — `reachedAt` is FIRST reach by construction.
18
+ */
19
+ export declare function recordFunnelProgressAtIngest(opts: {
20
+ db: Database;
21
+ logger: Logger;
22
+ funnels: FunnelRegistry | undefined;
23
+ event: {
24
+ name: string;
25
+ source: string | null;
26
+ properties: Record<string, unknown>;
27
+ value: number | null;
28
+ currency: string | null;
29
+ occurredAt: Date;
30
+ };
31
+ eventRowId: string;
32
+ contactId: string;
33
+ userKey: string;
34
+ }): Promise<{
35
+ reached: number;
36
+ }>;
37
+ //# sourceMappingURL=funnel-progress.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"funnel-progress.d.ts","sourceRoot":"","sources":["../../src/lib/funnel-progress.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,QAAQ,EAAkB,MAAM,aAAa,CAAC;AAC5D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAE3D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAE1C;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,4BAA4B,CAAC,IAAI,EAAE;IACvD,EAAE,EAAE,QAAQ,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,cAAc,GAAG,SAAS,CAAC;IACpC,KAAK,EAAE;QACL,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;QACtB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACpC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;QACrB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;QACxB,UAAU,EAAE,IAAI,CAAC;KAClB,CAAC;IACF,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;CACjB,GAAG,OAAO,CAAC;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CAuC/B"}
@@ -0,0 +1,44 @@
1
+ import type { DefinedFunnel, FunnelBinding, FunnelTransition } from "@hogsend/core";
2
+ /** A resolved claim: the owning funnel + the binding that matched (absent
3
+ * when traffic merely fell through to the default funnel). */
4
+ export interface ResolvedFunnelClaim {
5
+ funnel: DefinedFunnel;
6
+ binding?: FunnelBinding;
7
+ }
8
+ /** One event→stage rule bound to its owning funnel. */
9
+ export interface FunnelTransitionMatch {
10
+ funnel: DefinedFunnel;
11
+ transition: FunnelTransition;
12
+ }
13
+ /**
14
+ * Funnel routing (plan §5b.4): which funnel claims a stage event's
15
+ * (provider, pipeline). Claims come straight from each funnel's CRM
16
+ * `bindings` — an exact pipeline claim beats a provider-wide `"*"`.
17
+ * Overlapping claims are a boot error, not a runtime coin-flip. Events
18
+ * nobody claims fall back to the `"default"` funnel when one is registered
19
+ * (the `crm.{stages,stageMaps}` sugar synthesizes it).
20
+ */
21
+ export declare class FunnelRegistry {
22
+ private byId;
23
+ /** `${provider}:${pipelineId}` (or `${provider}:*`) → funnel + binding. */
24
+ private claims;
25
+ /** Event name → the transitions (across funnels) it can fire. */
26
+ private transitions;
27
+ /** Trigger events wired to a quoted/won milestone stage. */
28
+ private milestoneTriggers;
29
+ constructor(funnels?: DefinedFunnel[]);
30
+ /** Event→stage rules listening on this event name (empty when none). */
31
+ transitionsFor(event: string): FunnelTransitionMatch[];
32
+ /**
33
+ * Trigger events wired to a money-milestone stage in ANY funnel. Their
34
+ * value is handed to the minted `deal.quoted`/`deal.sold`, so revenue
35
+ * rollups exclude the raw trigger rows (else one sale counts twice).
36
+ */
37
+ milestoneTriggerEvents(): string[];
38
+ /** Route one stage event: exact pipeline claim → provider `"*"` → default. */
39
+ resolve(providerId: string, pipelineId: string | undefined): ResolvedFunnelClaim | undefined;
40
+ get(id: string): DefinedFunnel | undefined;
41
+ getAll(): DefinedFunnel[];
42
+ count(): number;
43
+ }
44
+ //# sourceMappingURL=funnel-registry.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"funnel-registry.d.ts","sourceRoot":"","sources":["../../src/lib/funnel-registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,aAAa,EACb,aAAa,EACb,gBAAgB,EACjB,MAAM,eAAe,CAAC;AAGvB;8DAC8D;AAC9D,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,aAAa,CAAC;IACtB,OAAO,CAAC,EAAE,aAAa,CAAC;CACzB;AAED,uDAAuD;AACvD,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,aAAa,CAAC;IACtB,UAAU,EAAE,gBAAgB,CAAC;CAC9B;AAED;;;;;;;GAOG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,IAAI,CAAoC;IAChD,2EAA2E;IAC3E,OAAO,CAAC,MAAM,CAA0C;IACxD,iEAAiE;IACjE,OAAO,CAAC,WAAW,CAA8C;IACjE,4DAA4D;IAC5D,OAAO,CAAC,iBAAiB,CAAqB;gBAElC,OAAO,GAAE,aAAa,EAAO;IA+BzC,wEAAwE;IACxE,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,qBAAqB,EAAE;IAItD;;;;OAIG;IACH,sBAAsB,IAAI,MAAM,EAAE;IAIlC,8EAA8E;IAC9E,OAAO,CACL,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,GAAG,SAAS,GAC7B,mBAAmB,GAAG,SAAS;IAUlC,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS;IAI1C,MAAM,IAAI,aAAa,EAAE;IAIzB,KAAK,IAAI,MAAM;CAGhB"}
@@ -0,0 +1,63 @@
1
+ import type { HatchetClient } from "@hatchet-dev/typescript-sdk/v1/index.js";
2
+ import type { AnalyticsProvider, DefinedFunnel } from "@hogsend/core";
3
+ import type { JourneyRegistry } from "@hogsend/core/registry";
4
+ import { type Database } from "@hogsend/db";
5
+ import type { FunnelRegistry } from "./funnel-registry.js";
6
+ import type { Logger } from "./logger.js";
7
+ /**
8
+ * Event-driven funnel stage transitions — the step-(5d) ingest hook. For
9
+ * each funnel whose `on`/`lostOn` triggers match the just-stored event:
10
+ * trust-gate the source, evaluate the `where` conditions, pick the winning
11
+ * stage, and apply it to the contact's open deal in that funnel (one deal
12
+ * per contact per funnel, across producers — an open CRM-born row is moved
13
+ * in place; no open deal mints a synthetic `events`-provider row). Money
14
+ * milestones ride the same projection freshness as the CRM path, so
15
+ * whichever producer reaches a milestone first mints it.
16
+ *
17
+ * The triggering event IS already on the spine, so this path never ingests
18
+ * a `funnel.stage_changed` twin — it emits outbound only. Loop safety is
19
+ * define-time: `deal.`/`funnel.`/`crm.` events are rejected as triggers, so
20
+ * the money events this hook mints can never re-enter it.
21
+ */
22
+ /**
23
+ * The gated, per-funnel WINNING stage targets for one event — source
24
+ * allowlist, `where` over money-overlaid properties, then the highest-ranked
25
+ * matching positive stage per funnel (`lost` only wins unopposed). Shared by
26
+ * the deal mover below and the `funnel_progress` reporting projection
27
+ * (funnel-progress.ts) so the two projections apply IDENTICAL rules and can
28
+ * never disagree about what counts as a stage event.
29
+ */
30
+ export declare function resolveFunnelTargets(opts: {
31
+ funnels: FunnelRegistry;
32
+ event: {
33
+ name: string;
34
+ source: string | null;
35
+ properties: Record<string, unknown>;
36
+ value: number | null;
37
+ currency: string | null;
38
+ };
39
+ logger?: Logger;
40
+ }): Array<{
41
+ funnel: DefinedFunnel;
42
+ target: string;
43
+ }>;
44
+ export declare function applyFunnelTransitionsAtIngest(opts: {
45
+ db: Database;
46
+ registry: JourneyRegistry;
47
+ hatchet: HatchetClient;
48
+ logger: Logger;
49
+ analytics?: AnalyticsProvider;
50
+ funnels: FunnelRegistry;
51
+ event: {
52
+ name: string;
53
+ source: string | null;
54
+ properties: Record<string, unknown>;
55
+ value: number | null;
56
+ currency: string | null;
57
+ occurredAt: Date;
58
+ };
59
+ eventRowId: string;
60
+ contactId: string;
61
+ userKey: string;
62
+ }): Promise<void>;
63
+ //# sourceMappingURL=funnel-transitions.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"funnel-transitions.d.ts","sourceRoot":"","sources":["../../src/lib/funnel-transitions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yCAAyC,CAAC;AAC7E,OAAO,KAAK,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAOtE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAE,KAAK,QAAQ,EAAS,MAAM,aAAa,CAAC;AAKnD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAG1C;;;;;;;;;;;;;;GAcG;AACH;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE;IACzC,OAAO,EAAE,cAAc,CAAC;IACxB,KAAK,EAAE;QACL,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;QACtB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACpC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;QACrB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;KACzB,CAAC;IACF,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,GAAG,KAAK,CAAC;IAAE,MAAM,EAAE,aAAa,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CAgDnD;AAED,wBAAsB,8BAA8B,CAAC,IAAI,EAAE;IACzD,EAAE,EAAE,QAAQ,CAAC;IACb,QAAQ,EAAE,eAAe,CAAC;IAC1B,OAAO,EAAE,aAAa,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,iBAAiB,CAAC;IAC9B,OAAO,EAAE,cAAc,CAAC;IACxB,KAAK,EAAE;QACL,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;QACtB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACpC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;QACrB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;QACxB,UAAU,EAAE,IAAI,CAAC;KAClB,CAAC;IACF,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;CACjB,GAAG,OAAO,CAAC,IAAI,CAAC,CAgKhB"}
@@ -0,0 +1,118 @@
1
+ import type { FxRateProvider } from "@hogsend/core";
2
+ import type { Database } from "@hogsend/db";
3
+ import type { env as envSchema } from "../env.js";
4
+ import type { Logger } from "./logger.js";
5
+ /**
6
+ * Parse the `FX_RATES` env JSON into a quote→rate map. THROWS on anything
7
+ * malformed (bad JSON, non-object, non-finite or non-positive rates) — a
8
+ * typo'd rate sheet must fail the boot loudly, never silently convert money
9
+ * wrong (the same fail-loud posture as an unresolvable `EMAIL_PROVIDER`).
10
+ * Keys are uppercased so lookups never miss on case.
11
+ */
12
+ export declare function parseFxRatesEnv(raw: string): Record<string, number>;
13
+ /**
14
+ * The sovereign default rate source: a fixed operator-supplied sheet, which
15
+ * is exactly the sovereignty trade: no network, no drift, rates change only
16
+ * when the operator changes them.
17
+ *
18
+ * THE HONESTY RULE: a static sheet is only meaningful against the ONE base
19
+ * it was quoted in (`quotedBase` — the env `BASE_CURRENCY` the operator's
20
+ * `FX_RATES` were written for). `getRates(base)` serves the sheet ONLY when
21
+ * `base === quotedBase` and resolves null for any other base — a USD-quoted
22
+ * sheet must never silently convert into EUR just because the effective base
23
+ * changed (e.g. via the Studio setting). A `quotedBase` of null (FX_RATES
24
+ * with no BASE_CURRENCY) is a base-less sheet: it serves null for EVERY
25
+ * base — inert, warned at boot in {@link fxProviderFromEnv}.
26
+ */
27
+ export declare function createStaticFxProvider(opts: {
28
+ rates: Record<string, number>;
29
+ asOf?: string | null;
30
+ /** The base the sheet's rates are quoted against (null = base-less/inert). */
31
+ quotedBase: string | null;
32
+ }): FxRateProvider;
33
+ /**
34
+ * ECB daily reference rates via frankfurter.app, opt-in
35
+ * (`FX_PROVIDER=frankfurter`). ONE request serves every quote:
36
+ * `latest?from=<base>` returns base→quote rates (1 base = N quote) for all
37
+ * supported currencies, which we INVERT (quote→base = 1/N) — there is no
38
+ * `latest?to=<base>` batch form.
39
+ *
40
+ * Every successful fetch is upserted into `fx_rates`, and the cache is
41
+ * authoritative until it goes stale, so the API sees at most one call per
42
+ * staleness window and a day's conversions are pinned to one recorded sheet.
43
+ * Staleness is measured from `fetched_at`, NOT `as_of`: the ECB reference
44
+ * date legitimately freezes over weekends/holidays, so keying the refetch off
45
+ * `as_of` would re-hit the API on every request all weekend for rates that
46
+ * cannot have changed.
47
+ *
48
+ * FAIL-SOFT throughout: a failed/malformed fetch serves the last cached sheet
49
+ * when one exists, else resolves null. Nothing here ever throws into a
50
+ * request path.
51
+ */
52
+ export declare function createFrankfurterFxProvider(opts: {
53
+ db: Database;
54
+ logger?: Logger;
55
+ /** Test seam — injected fetch. Defaults to the global. */
56
+ fetchImpl?: typeof fetch;
57
+ /** Refetch window in ms. Defaults to 24h (ECB publishes daily). */
58
+ maxAgeMs?: number;
59
+ }): FxRateProvider;
60
+ /**
61
+ * Resolve the ONE env-configured rate source, mirroring the env-preset spirit
62
+ * of `analyticsProvidersFromEnv` without the registry: `FX_PROVIDER=
63
+ * frankfurter` opts into the network source; otherwise a set `FX_RATES`
64
+ * builds the sovereign static sheet (throwing at boot on a malformed one);
65
+ * otherwise there is no source. A consumer `fx.provider` wins over this
66
+ * entirely (checked at the container call site).
67
+ */
68
+ export declare function fxProviderFromEnv(env: typeof envSchema, deps: {
69
+ db: Database;
70
+ logger?: Logger;
71
+ }): FxRateProvider | undefined;
72
+ /**
73
+ * A resolved quote→base sheet, normalized for consumers: keys uppercased,
74
+ * non-usable rates dropped, and the identity rate (base→base = 1) injected so
75
+ * no reader special-cases the base currency. Carries the base it converts TO
76
+ * — a sheet is only meaningful relative to its base, so readers never have to
77
+ * pair it back up with the lens.
78
+ */
79
+ export interface FxRatesToBase {
80
+ baseCurrency: string;
81
+ rates: Record<string, number>;
82
+ asOf: string | null;
83
+ }
84
+ /**
85
+ * The minimal FX surface the container exposes (`client.fx`). The effective
86
+ * base currency is resolved PER CALL (never boot-frozen): the container's
87
+ * resolver walks code pin → Studio operator setting → env `BASE_CURRENCY`,
88
+ * so a base chosen/changed/cleared in Studio takes effect on the next
89
+ * request without a reboot. Null base = the lens is OFF: `getRatesToBase`
90
+ * resolves null and every consumer renders the unconverted truth, unchanged.
91
+ */
92
+ export interface FxLens {
93
+ /** The active rate source's id (`meta.id`), or null when none is wired. */
94
+ providerId: string | null;
95
+ /**
96
+ * Resolve the operator's EFFECTIVE reporting currency (uppercased), or
97
+ * null when the lens is off. Fail-soft: a throwing resolver reads as off.
98
+ */
99
+ getBaseCurrency(): Promise<string | null>;
100
+ /**
101
+ * Resolve the quote→base sheet from the active provider. Null when the
102
+ * lens is off, no provider is configured, or the provider has nothing to
103
+ * serve. NEVER throws — the lens is the fail-soft chokepoint even for a
104
+ * misbehaving BYO provider, so no request path needs its own guard.
105
+ */
106
+ getRatesToBase(): Promise<FxRatesToBase | null>;
107
+ }
108
+ /** Build the container's {@link FxLens} from the base resolver + provider. */
109
+ export declare function createFxLens(opts: {
110
+ /**
111
+ * Resolves the effective base per call (the container builds it from the
112
+ * code pin / operator setting / env precedence). Null = lens off.
113
+ */
114
+ resolveBaseCurrency: () => Promise<string | null>;
115
+ provider?: FxRateProvider;
116
+ logger: Logger;
117
+ }): FxLens;
118
+ //# sourceMappingURL=fx.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"fx.d.ts","sourceRoot":"","sources":["../../src/lib/fx.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAe,MAAM,eAAe,CAAC;AAEjE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAG5C,OAAO,KAAK,EAAE,GAAG,IAAI,SAAS,EAAE,MAAM,WAAW,CAAC;AAClD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAgC1C;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAwBnE;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE;IAC3C,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9B,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,8EAA8E;IAC9E,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B,GAAG,cAAc,CAmBjB;AAYD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,2BAA2B,CAAC,IAAI,EAAE;IAChD,EAAE,EAAE,QAAQ,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,0DAA0D;IAC1D,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;IACzB,mEAAmE;IACnE,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,GAAG,cAAc,CA4FjB;AAMD;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,OAAO,SAAS,EACrB,IAAI,EAAE;IAAE,EAAE,EAAE,QAAQ,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GACtC,cAAc,GAAG,SAAS,CAsB5B;AAED;;;;;;GAMG;AACH,MAAM,WAAW,aAAa;IAC5B,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9B,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CACrB;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,MAAM;IACrB,2EAA2E;IAC3E,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B;;;OAGG;IACH,eAAe,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAC1C;;;;;OAKG;IACH,cAAc,IAAI,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAAC;CACjD;AAED,8EAA8E;AAC9E,wBAAgB,YAAY,CAAC,IAAI,EAAE;IACjC;;;OAGG;IACH,mBAAmB,EAAE,MAAM,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAClD,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B,MAAM,EAAE,MAAM,CAAC;CAChB,GAAG,MAAM,CA8CT"}
@@ -0,0 +1,72 @@
1
+ import type { Database } from "@hogsend/db";
2
+ import { type LiftVerdict } from "./lift-stats.js";
3
+ /**
4
+ * Program-level global-control readout (impact-experiments spec D4.5e).
5
+ * Assignment lives only in env + hash (no assignment table), so the
6
+ * readout recomputes membership per contact as
7
+ * key = externalId ?? anonymousId ?? id, which is what
8
+ * isGlobalControl(options.userId ?? options.to) hashes at send time
9
+ * (lib/tracked.ts:245-246, lib/sms-tracked.ts:225-226) for JOURNEY sends —
10
+ * a journey's `userId` is the ingest-resolved key
11
+ * (event.userId ?? event.anonymousId, lib/ingestion.ts), so an
12
+ * anonymous-triggered journey hashes the same anonymousId the readout
13
+ * falls back to.
14
+ *
15
+ * DISCLOSED APPROXIMATION: two OTHER send paths resolve a different key and
16
+ * can disagree with the readout for a contact whose external_id is NULL but
17
+ * anonymous_id is set (the readout hashes anonymous_id; these paths hash the
18
+ * contact's UUID instead, never anonymous_id):
19
+ * - bare POST /v1/emails — regardless of whether the caller supplied a
20
+ * userId, the route always resolves the send's userId as
21
+ * recipient.externalId ?? recipient.contactId (routes/emails/index.ts),
22
+ * so it can never fall through to anonymous_id.
23
+ * - list-audience campaign broadcasts — the send-campaign cursor query
24
+ * resolves the same externalId ?? contactId fallback
25
+ * (workflows/send-campaign.ts), also never anonymous_id.
26
+ * Journey sends stay in parity with the readout (see above); the
27
+ * divergence is bounded to these two paths, so the fallback chain remains
28
+ * a reasonable, disclosed approximation for a mixed-population program —
29
+ * not a blanket "no userId" case.
30
+ *
31
+ * Converter outcomes aggregate ALL definitions (global control suppresses
32
+ * all non-transactional sends, so any registered conversion is a fair
33
+ * program-level outcome; no definitionId knob in v1). ITT caveat: this is
34
+ * a cross-sectional randomized comparison — outcome window
35
+ * occurred_at >= since for BOTH buckets; random assignment keeps it
36
+ * causal, window symmetry keeps it fair.
37
+ */
38
+ /** In-request scan ceiling — above this the readout reports `skipped`
39
+ * (honest ceiling; a cached cron materialization is explicitly deferred). */
40
+ export declare const GLOBAL_CONTROL_SCAN_CEILING = 500000;
41
+ export type GlobalControlReadout = {
42
+ state: "off";
43
+ } | {
44
+ state: "skipped";
45
+ reason: "too_many_contacts";
46
+ percent: number;
47
+ contactCount: number;
48
+ } | ({
49
+ state: "computed";
50
+ causal: true;
51
+ percent: number;
52
+ contactsScanned: number;
53
+ treatment: {
54
+ contacts: number;
55
+ converters: number;
56
+ rate: number;
57
+ };
58
+ control: {
59
+ contacts: number;
60
+ converters: number;
61
+ rate: number;
62
+ };
63
+ } & LiftVerdict);
64
+ export declare function computeGlobalControlReadout(opts: {
65
+ db: Database;
66
+ since: Date;
67
+ /** Scan ceiling override — the route always uses the default; the
68
+ * parameter exists so the skipped state is testable. */
69
+ scanCeiling?: number;
70
+ batchSize?: number;
71
+ }): Promise<GlobalControlReadout>;
72
+ //# sourceMappingURL=global-control-readout.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"global-control-readout.d.ts","sourceRoot":"","sources":["../../src/lib/global-control-readout.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAG5C,OAAO,EAAe,KAAK,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAEhE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAEH;6EAC6E;AAC7E,eAAO,MAAM,2BAA2B,SAAU,CAAC;AAmCnD,MAAM,MAAM,oBAAoB,GAC5B;IAAE,KAAK,EAAE,KAAK,CAAA;CAAE,GAChB;IACE,KAAK,EAAE,SAAS,CAAC;IACjB,MAAM,EAAE,mBAAmB,CAAC;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;CACtB,GACD,CAAC;IACC,KAAK,EAAE,UAAU,CAAC;IAClB,MAAM,EAAE,IAAI,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE,MAAM,CAAC;IACxB,SAAS,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IAClE,OAAO,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;CACjE,GAAG,WAAW,CAAC,CAAC;AAErB,wBAAsB,2BAA2B,CAAC,IAAI,EAAE;IACtD,EAAE,EAAE,QAAQ,CAAC;IACb,KAAK,EAAE,IAAI,CAAC;IACZ;4DACwD;IACxD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CA+DhC"}