@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 @@
1
+ {"version":3,"file":"singleton.d.ts","sourceRoot":"","sources":["../../src/lib/singleton.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,MAAM,WAAW,SAAS,CAAC,CAAC;IAC1B,GAAG,CAAC,KAAK,EAAE,CAAC,GAAG,IAAI,CAAC;IACpB,GAAG,IAAI,CAAC,CAAC;IACT,KAAK,IAAI,IAAI,CAAC;CACf;AAED,MAAM,WAAW,iBAAiB,CAAC,CAAC;IAClC,GAAG,CAAC,KAAK,EAAE,CAAC,GAAG,SAAS,GAAG,IAAI,CAAC;IAChC,GAAG,IAAI,CAAC,GAAG,SAAS,CAAC;IACrB,KAAK,IAAI,IAAI,CAAC;CACf;AAED,wBAAgB,eAAe,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC,CAgB7D;AAED,wBAAgB,uBAAuB,CAAC,CAAC,KAAK,iBAAiB,CAAC,CAAC,CAAC,CAajE"}
@@ -0,0 +1,16 @@
1
+ import type { Database } from "@hogsend/db";
2
+ import type { FrequencyCapConfig } from "./email-service-types.js";
3
+ /**
4
+ * The SMS sibling of {@link isFrequencyCapped}: true if this recipient has hit
5
+ * the configured send cap within the window, counted over `sms_sends` by
6
+ * `to_phone` (served by `sms_sends_freq_cap_idx`). Kept SEPARATE from the email
7
+ * cap so email and SMS budgets never consume each other. Failed rows are
8
+ * excluded; an exempt category (default "transactional") short-circuits.
9
+ */
10
+ export declare function isSmsFrequencyCapped(opts: {
11
+ db: Database;
12
+ to: string;
13
+ category?: string;
14
+ config?: FrequencyCapConfig;
15
+ }): Promise<boolean>;
16
+ //# sourceMappingURL=sms-frequency-cap.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"sms-frequency-cap.d.ts","sourceRoot":"","sources":["../../src/lib/sms-frequency-cap.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAG5C,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAInE;;;;;;GAMG;AACH,wBAAsB,oBAAoB,CAAC,IAAI,EAAE;IAC/C,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,CA0BnB"}
@@ -0,0 +1,37 @@
1
+ import type { SmsEvent, SmsProvider } from "@hogsend/core";
2
+ import type { Database } from "@hogsend/db";
3
+ import type { Logger } from "./logger.js";
4
+ /** Normalize an inbound body to a single keyword token for matching. */
5
+ export declare function normalizeKeyword(body: string): string;
6
+ interface InboundDeps {
7
+ db: Database;
8
+ provider: SmsProvider;
9
+ logger: Logger;
10
+ /** Send STOP/START/HELP confirmation replies (default off). */
11
+ optOutReplies?: boolean;
12
+ from?: string;
13
+ }
14
+ /**
15
+ * Handle a normalized inbound (mobile-originated) SMS. Detects STOP/START/HELP
16
+ * keywords and records the opt-out in BOTH tracks: the phone-keyed
17
+ * `sms_suppressions` table (authoritative — works even for a number with no
18
+ * contact) and, when the phone resolves to a contact with an email, the `sms`
19
+ * channel category on `email_preferences` (keeps the preference center
20
+ * consistent and reuses the single `upsertEmailPreference` write choke, which
21
+ * emits `contact.unsubscribed`). TCPA/CTIA compliant.
22
+ */
23
+ export declare function handleInboundSms(event: SmsEvent, deps: InboundDeps): Promise<void>;
24
+ /** Suppress a phone (STOP / manual). Upsert: re-STOP after START resets the flag. */
25
+ export declare function recordPhoneOptOut(db: Database, phone: string, reason: "inbound_stop" | "manual"): Promise<void>;
26
+ /**
27
+ * Record express phone-level consent: an `sms_suppressions` row with
28
+ * `resubscribed_at` set. Under the explicit opt-in model this row IS the
29
+ * consent record for a number with no (or a phone-only) contact — texting
30
+ * START is express consent, so a fresh START with no prior STOP row must
31
+ * still grant (hence upsert, not update).
32
+ */
33
+ export declare function grantPhoneConsent(db: Database, phone: string, opts?: {
34
+ reason?: "inbound_start" | "api_grant";
35
+ }): Promise<void>;
36
+ export {};
37
+ //# sourceMappingURL=sms-inbound.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"sms-inbound.d.ts","sourceRoot":"","sources":["../../src/lib/sms-inbound.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC3D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAG5C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAiB1C,wEAAwE;AACxE,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAKrD;AAcD,UAAU,WAAW;IACnB,EAAE,EAAE,QAAQ,CAAC;IACb,QAAQ,EAAE,WAAW,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,+DAA+D;IAC/D,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;;;;;;;GAQG;AACH,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,QAAQ,EACf,IAAI,EAAE,WAAW,GAChB,OAAO,CAAC,IAAI,CAAC,CAwCf;AAED,qFAAqF;AACrF,wBAAsB,iBAAiB,CACrC,EAAE,EAAE,QAAQ,EACZ,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,cAAc,GAAG,QAAQ,GAChC,OAAO,CAAC,IAAI,CAAC,CAcf;AAED;;;;;;GAMG;AACH,wBAAsB,iBAAiB,CACrC,EAAE,EAAE,QAAQ,EACZ,KAAK,EAAE,MAAM,EACb,IAAI,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,eAAe,GAAG,WAAW,CAAA;CAAE,GAChD,OAAO,CAAC,IAAI,CAAC,CAcf"}
@@ -0,0 +1,53 @@
1
+ /**
2
+ * SMS link shortening — the plain-text sibling of `rewriteLinks` (which is
3
+ * HTML-anchor/email-only). `planSmsLinkRewrite` is PURE: it returns the
4
+ * rewritten body plus the pending `tracked_links` rows; the caller inserts
5
+ * them in the SAME transaction as the `sms_sends` row (the FK forces the
6
+ * order, and the transaction closes both crash windows — no queued row ever
7
+ * carries codes whose tracked rows are missing, and a short-code unique
8
+ * collision rolls the whole attempt back for a clean replan).
9
+ *
10
+ * Why short links at all: a full `/v1/t/c/<uuid>` tracking URL eats a third
11
+ * of a 160-char GSM-7 segment, and US carriers filter public shorteners —
12
+ * first-party short codes on the operator's own domain are the practice.
13
+ */
14
+ /**
15
+ * Crockford-style base32 (no `i l o u`), all GSM-7 basic-set characters — a
16
+ * code can never flip a message to UCS-2. 8 chars = 40 bits: birthday
17
+ * collision odds reach 50% only around ~1.2M live codes; the insert-time
18
+ * unique index + replan retry is a correctness backstop, not an expected path.
19
+ */
20
+ export declare const SHORT_CODE_ALPHABET = "0123456789abcdefghjkmnpqrstvwxyz";
21
+ export declare const SHORT_CODE_LENGTH = 8;
22
+ export declare function generateShortCode(): string;
23
+ export interface PendingSmsLink {
24
+ shortCode: string;
25
+ originalUrl: string;
26
+ }
27
+ export interface SmsLinkRewritePlan {
28
+ /** The body with every rewritable URL replaced by `${linkHost}/s/${code}`. */
29
+ body: string;
30
+ /** One entry per DISTINCT rewritten URL (occurrences share one code). */
31
+ links: PendingSmsLink[];
32
+ }
33
+ /**
34
+ * Pure rewrite pass over a rendered SMS body. Skips unsubscribe/preference
35
+ * URLs (shared `shouldSkipUrl`) and the engine's OWN short/vanity/tracking
36
+ * URLs (`/s/`, `/l/`, `/v1/t/` under `linkHost`) — a pasted tracked URL
37
+ * already counts its click; wrapping it would add a hop and double-count.
38
+ *
39
+ * `generateCode` is injectable for deterministic tests.
40
+ */
41
+ export declare function planSmsLinkRewrite(opts: {
42
+ body: string;
43
+ /** Full origin the short links are served from, no trailing slash. */
44
+ linkHost: string;
45
+ generateCode?: () => string;
46
+ }): SmsLinkRewritePlan;
47
+ /**
48
+ * True when `err` is the `tracked_links_short_code_unique` partial-unique
49
+ * violation (an astronomically-rare 40-bit code collision). Walks the drizzle
50
+ * cause chain for PG 23505, mirroring `isSlugUniqueViolation` in links.ts.
51
+ */
52
+ export declare function isShortCodeCollision(err: unknown): boolean;
53
+ //# sourceMappingURL=sms-link-tracking.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"sms-link-tracking.d.ts","sourceRoot":"","sources":["../../src/lib/sms-link-tracking.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;GAYG;AAEH;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,qCAAqC,CAAC;AACtE,eAAO,MAAM,iBAAiB,IAAI,CAAC;AAEnC,wBAAgB,iBAAiB,IAAI,MAAM,CAQ1C;AAED,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,kBAAkB;IACjC,8EAA8E;IAC9E,IAAI,EAAE,MAAM,CAAC;IACb,yEAAyE;IACzE,KAAK,EAAE,cAAc,EAAE,CAAC;CACzB;AAqCD;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,sEAAsE;IACtE,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,MAAM,CAAC;CAC7B,GAAG,kBAAkB,CAsCrB;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAkB1D"}
@@ -0,0 +1,12 @@
1
+ import type { SmsProvider } from "@hogsend/core";
2
+ import type { SmsService, SmsServiceConfig } from "./sms-service-types.js";
3
+ /**
4
+ * The engine-owned high-level SMS sender. Owns the full pipeline — render →
5
+ * preference/suppression check → `sms_sends` insert → `provider.send` → status
6
+ * record — and delegates only raw delivery + webhook parse/verify to the
7
+ * injected {@link SmsProvider}. The SMS sibling of `createTrackedMailer`.
8
+ */
9
+ export declare function createTrackedSmsSender(config: SmsServiceConfig, deps: {
10
+ provider: SmsProvider;
11
+ }): SmsService;
12
+ //# sourceMappingURL=sms-mailer.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"sms-mailer.d.ts","sourceRoot":"","sources":["../../src/lib/sms-mailer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAGV,WAAW,EAEZ,MAAM,eAAe,CAAC;AAcvB,OAAO,KAAK,EACV,UAAU,EACV,gBAAgB,EAMjB,MAAM,wBAAwB,CAAC;AAsChC;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,gBAAgB,EACxB,IAAI,EAAE;IAAE,QAAQ,EAAE,WAAW,CAAA;CAAE,GAC9B,UAAU,CAgQZ"}
@@ -0,0 +1,20 @@
1
+ import type { SmsProvider } from "@hogsend/core";
2
+ /**
3
+ * Container-held registry of SMS providers, keyed by `provider.meta.id`. The
4
+ * webhook route (`POST /v1/webhooks/sms/:providerId`) resolves the verifying
5
+ * provider out of this via `c.get("container")`, and the container picks ONE
6
+ * active provider out of it for the tracked SMS sender.
7
+ *
8
+ * The SMS sibling of {@link EmailProviderRegistry}. Unlike email, `meta` is
9
+ * REQUIRED on the SMS contract (no pre-registry back-compat), so there is no
10
+ * fallback id — last-writer-wins on `meta.id`.
11
+ */
12
+ export declare class SmsProviderRegistry {
13
+ private byId;
14
+ constructor(providers?: SmsProvider[]);
15
+ register(provider: SmsProvider): void;
16
+ get(id: string): SmsProvider | undefined;
17
+ getAll(): SmsProvider[];
18
+ count(): number;
19
+ }
20
+ //# sourceMappingURL=sms-provider-registry.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"sms-provider-registry.d.ts","sourceRoot":"","sources":["../../src/lib/sms-provider-registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAEjD;;;;;;;;;GASG;AACH,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,IAAI,CAAkC;gBAElC,SAAS,GAAE,WAAW,EAAO;IAIzC,QAAQ,CAAC,QAAQ,EAAE,WAAW,GAAG,IAAI;IAIrC,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS;IAIxC,MAAM,IAAI,WAAW,EAAE;IAIvB,KAAK,IAAI,MAAM;CAGhB"}
@@ -0,0 +1,4 @@
1
+ import type { SmsProvider } from "@hogsend/core";
2
+ import type { env as envSchema } from "../env.js";
3
+ export declare function smsProvidersFromEnv(env: typeof envSchema): SmsProvider[];
4
+ //# sourceMappingURL=sms-providers-from-env.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"sms-providers-from-env.d.ts","sourceRoot":"","sources":["../../src/lib/sms-providers-from-env.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,KAAK,EAAE,GAAG,IAAI,SAAS,EAAE,MAAM,WAAW,CAAC;AAsElD,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,OAAO,SAAS,GAAG,WAAW,EAAE,CA4BxE"}
@@ -0,0 +1,131 @@
1
+ import type { SendSmsOptions, SmsEvent, SmsEventType, SmsProvider, SmsWebhookHandlerMap } from "@hogsend/core";
2
+ import type { SmsTemplateName, SmsTemplateRegistry, SmsTemplateRegistryMap } from "@hogsend/sms";
3
+ import type { FrequencyCapConfig } from "./email-service-types.js";
4
+ import type { Logger } from "./logger.js";
5
+ export interface SendTrackedSmsOptions<K extends SmsTemplateName = SmsTemplateName> {
6
+ templateKey: K;
7
+ props: SmsTemplateRegistryMap[K];
8
+ from: string;
9
+ to: string;
10
+ journeyStateId?: string;
11
+ /** Denormalized recipient identity, persisted on the sms_sends row. */
12
+ userId?: string;
13
+ category?: string;
14
+ /**
15
+ * Skips the consent + topic gates and the frequency cap — NEVER the phone
16
+ * STOP list or the `unsubscribed_all` master opt-out, which are enforced
17
+ * unconditionally (system sends must still respect a STOP).
18
+ */
19
+ skipPreferenceCheck?: boolean;
20
+ /**
21
+ * Caller-supplied idempotency key. A retry with the same key short-circuits to
22
+ * the prior `sms_sends` row instead of dispatching a duplicate provider send.
23
+ */
24
+ idempotencyKey?: string;
25
+ }
26
+ export interface SmsTrackedSendResult {
27
+ smsSendId: string;
28
+ /** The provider's neutral message id (Twilio MessageSid). */
29
+ messageId: string;
30
+ /**
31
+ * `"no_consent"` — the recipient has no explicit SMS consent (no
32
+ * `categories.sms === true` grant and no phone-track consent, or no
33
+ * resolvable `userId` on a non-transactional send). The consent model is
34
+ * explicit opt-in; the sender fails closed.
35
+ */
36
+ status: "sent" | "suppressed" | "unsubscribed" | "no_consent" | "skipped";
37
+ /**
38
+ * Present only when `status === "skipped"`:
39
+ * - `"frequency_capped"` — the per-recipient frequency cap was hit.
40
+ * - `"journey_suppressed"` — the journey's `meta.suppress` min-gap found a
41
+ * recent SMS to this recipient from the same journey.
42
+ * - `"test_mode_blocked"` — test mode active but no `HOGSEND_TEST_PHONE`, so
43
+ * the send was blocked rather than delivered to the real recipient.
44
+ * - `"control_group"` — the recipient is in the global control group
45
+ * (impact plan §4.3); non-transactional sends are withheld.
46
+ */
47
+ reason?: "frequency_capped" | "journey_suppressed" | "test_mode_blocked" | "control_group";
48
+ }
49
+ export interface SmsServiceConfig {
50
+ defaultFrom?: string;
51
+ /** The client app's SMS template registry (key → component + category). */
52
+ templates: SmsTemplateRegistry;
53
+ db?: unknown;
54
+ webhookHandlers?: SmsWebhookHandlerMap;
55
+ /** Optional per-client frequency cap; undefined disables capping. */
56
+ frequencyCap?: FrequencyCapConfig;
57
+ logger?: Logger;
58
+ /**
59
+ * The compliance footer appended to non-transactional bodies when it isn't
60
+ * already present. `false` disables it entirely; a string overrides the
61
+ * default `"Reply STOP to opt out"`.
62
+ */
63
+ stopFooter?: string | false;
64
+ /**
65
+ * Whether the engine sends STOP/START/HELP confirmation replies on inbound
66
+ * keywords. Default `false`: Twilio's carrier-level opt-out already replies,
67
+ * and a post-STOP send is blocked by error 21610 — a double reply is worse
68
+ * than none. Operators who disable Twilio's Advanced Opt-Out can enable this.
69
+ */
70
+ optOutReplies?: boolean;
71
+ /**
72
+ * Resolves whether SMS test mode is active per send (container-wired from the
73
+ * validated HOGSEND_TEST_MODE, coherent with the email side's auto-arm).
74
+ * Absent ⇒ never active.
75
+ */
76
+ testMode?: () => boolean;
77
+ /** The redirect target while test mode is active (env.HOGSEND_TEST_PHONE). */
78
+ testPhone?: string;
79
+ /**
80
+ * Rewrite bare URLs in rendered bodies to first-party short tracked links
81
+ * (`/s/:code`). Default true (mirrors email's always-on tracking).
82
+ */
83
+ linkTracking?: boolean;
84
+ /**
85
+ * Full origin the short links are minted under (no trailing slash). The
86
+ * container resolves `sms.linkHost ?? SMS_LINK_HOST ?? API_PUBLIC_URL`.
87
+ * Rewriting is skipped when absent.
88
+ */
89
+ linkHost?: string;
90
+ }
91
+ export interface SmsServiceSendOptions<K extends SmsTemplateName = SmsTemplateName> {
92
+ template: K;
93
+ props: SmsTemplateRegistryMap[K];
94
+ to: string;
95
+ from?: string;
96
+ journeyStateId?: string;
97
+ userId?: string;
98
+ category?: string;
99
+ skipPreferenceCheck?: boolean;
100
+ idempotencyKey?: string;
101
+ }
102
+ export interface SmsServiceRenderOptions<K extends SmsTemplateName = SmsTemplateName> {
103
+ template: K;
104
+ props: SmsTemplateRegistryMap[K];
105
+ }
106
+ export interface SmsServiceRenderResult {
107
+ text: string;
108
+ category?: string;
109
+ segments: number;
110
+ }
111
+ export interface SmsServiceWebhookResult {
112
+ type: SmsEventType;
113
+ handled: boolean;
114
+ }
115
+ export interface SmsService {
116
+ send<K extends SmsTemplateName>(options: SmsServiceSendOptions<K>): Promise<SmsTrackedSendResult>;
117
+ /** Deliver a raw text body (no template, no tracking) — used for confirmations. */
118
+ sendRaw(options: SendSmsOptions): Promise<{
119
+ id: string;
120
+ }>;
121
+ render<K extends SmsTemplateName>(options: SmsServiceRenderOptions<K>): Promise<SmsServiceRenderResult>;
122
+ /**
123
+ * Dispatch an already-verified, provider-neutral {@link SmsEvent} into the
124
+ * status/suppression/inbound pipeline. The webhook route owns provider
125
+ * resolution + signature verification.
126
+ */
127
+ handleWebhook(event: SmsEvent, providerId?: string): Promise<SmsServiceWebhookResult>;
128
+ }
129
+ /** The active SMS provider a tracked sender delegates raw delivery to. */
130
+ export type { SmsProvider };
131
+ //# sourceMappingURL=sms-service-types.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"sms-service-types.d.ts","sourceRoot":"","sources":["../../src/lib/sms-service-types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,EACd,QAAQ,EACR,YAAY,EACZ,WAAW,EACX,oBAAoB,EACrB,MAAM,eAAe,CAAC;AACvB,OAAO,KAAK,EACV,eAAe,EACf,mBAAmB,EACnB,sBAAsB,EACvB,MAAM,cAAc,CAAC;AACtB,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AACnE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAM1C,MAAM,WAAW,qBAAqB,CACpC,CAAC,SAAS,eAAe,GAAG,eAAe;IAE3C,WAAW,EAAE,CAAC,CAAC;IACf,KAAK,EAAE,sBAAsB,CAAC,CAAC,CAAC,CAAC;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,uEAAuE;IACvE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;OAIG;IACH,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,6DAA6D;IAC7D,SAAS,EAAE,MAAM,CAAC;IAClB;;;;;OAKG;IACH,MAAM,EAAE,MAAM,GAAG,YAAY,GAAG,cAAc,GAAG,YAAY,GAAG,SAAS,CAAC;IAC1E;;;;;;;;;OASG;IACH,MAAM,CAAC,EACH,kBAAkB,GAClB,oBAAoB,GACpB,mBAAmB,GACnB,eAAe,CAAC;CACrB;AAMD,MAAM,WAAW,gBAAgB;IAC/B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,2EAA2E;IAC3E,SAAS,EAAE,mBAAmB,CAAC;IAC/B,EAAE,CAAC,EAAE,OAAO,CAAC;IACb,eAAe,CAAC,EAAE,oBAAoB,CAAC;IACvC,qEAAqE;IACrE,YAAY,CAAC,EAAE,kBAAkB,CAAC;IAClC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;IAC5B;;;;;OAKG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,OAAO,CAAC;IACzB,8EAA8E;IAC9E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;OAGG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,qBAAqB,CACpC,CAAC,SAAS,eAAe,GAAG,eAAe;IAE3C,QAAQ,EAAE,CAAC,CAAC;IACZ,KAAK,EAAE,sBAAsB,CAAC,CAAC,CAAC,CAAC;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,uBAAuB,CACtC,CAAC,SAAS,eAAe,GAAG,eAAe;IAE3C,QAAQ,EAAE,CAAC,CAAC;IACZ,KAAK,EAAE,sBAAsB,CAAC,CAAC,CAAC,CAAC;CAClC;AAED,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,YAAY,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,CAAC,CAAC,SAAS,eAAe,EAC5B,OAAO,EAAE,qBAAqB,CAAC,CAAC,CAAC,GAChC,OAAO,CAAC,oBAAoB,CAAC,CAAC;IAEjC,mFAAmF;IACnF,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAE1D,MAAM,CAAC,CAAC,SAAS,eAAe,EAC9B,OAAO,EAAE,uBAAuB,CAAC,CAAC,CAAC,GAClC,OAAO,CAAC,sBAAsB,CAAC,CAAC;IAEnC;;;;OAIG;IACH,aAAa,CACX,KAAK,EAAE,QAAQ,EACf,UAAU,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC,uBAAuB,CAAC,CAAC;CACrC;AAED,0EAA0E;AAC1E,YAAY,EAAE,WAAW,EAAE,CAAC"}
@@ -0,0 +1,36 @@
1
+ import type { SmsProvider } from "@hogsend/core";
2
+ import type { Database } from "@hogsend/db";
3
+ import { type SmsTemplateName, type SmsTemplateRegistry } from "@hogsend/sms";
4
+ import type { FrequencyCapConfig } from "./email-service-types.js";
5
+ import { type Logger } from "./logger.js";
6
+ import type { SendTrackedSmsOptions, SmsTrackedSendResult } from "./sms-service-types.js";
7
+ /** The engine-synthesized SMS channel list id (opt-out polarity). */
8
+ export declare const SMS_CHANNEL_ID = "sms";
9
+ interface TrackedSmsDeps {
10
+ db: Database;
11
+ provider: SmsProvider;
12
+ registry: SmsTemplateRegistry;
13
+ frequencyCap?: FrequencyCapConfig;
14
+ logger?: Logger;
15
+ /** `false` disables the STOP footer; a string overrides the default text. */
16
+ stopFooter?: string | false;
17
+ /** Container-wired test-mode resolver (validated env). Absent ⇒ never active. */
18
+ testMode?: () => boolean;
19
+ /** Redirect target while test mode is active (env.HOGSEND_TEST_PHONE). */
20
+ testPhone?: string;
21
+ /** Rewrite bare URLs to first-party short tracked links. Default true. */
22
+ linkTracking?: boolean;
23
+ /** Full origin short links are minted under; rewriting is skipped if absent. */
24
+ linkHost?: string;
25
+ }
26
+ /**
27
+ * Boundary-aware entry point mirroring {@link sendTrackedEmail}. A raw-service
28
+ * SMS send from INSIDE a journey (no idempotency key set) is auto-keyed with the
29
+ * `smsSend` kind so the engine's exactly-once guarantee covers it. Outside a
30
+ * journey, or with a key already set, this is a transparent pass-through.
31
+ */
32
+ export declare function sendTrackedSms<K extends SmsTemplateName>(opts: TrackedSmsDeps & {
33
+ options: SendTrackedSmsOptions<K>;
34
+ }): Promise<SmsTrackedSendResult>;
35
+ export {};
36
+ //# sourceMappingURL=sms-tracked.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"sms-tracked.d.ts","sourceRoot":"","sources":["../../src/lib/sms-tracked.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAE5C,OAAO,EAIL,KAAK,eAAe,EACpB,KAAK,mBAAmB,EACzB,MAAM,cAAc,CAAC;AAUtB,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAInE,OAAO,EAAgB,KAAK,MAAM,EAAE,MAAM,aAAa,CAAC;AASxD,OAAO,KAAK,EACV,qBAAqB,EACrB,oBAAoB,EACrB,MAAM,wBAAwB,CAAC;AAIhC,qEAAqE;AACrE,eAAO,MAAM,cAAc,QAAQ,CAAC;AAEpC,UAAU,cAAc;IACtB,EAAE,EAAE,QAAQ,CAAC;IACb,QAAQ,EAAE,WAAW,CAAC;IACtB,QAAQ,EAAE,mBAAmB,CAAC;IAC9B,YAAY,CAAC,EAAE,kBAAkB,CAAC;IAClC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,6EAA6E;IAC7E,UAAU,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;IAC5B,iFAAiF;IACjF,QAAQ,CAAC,EAAE,MAAM,OAAO,CAAC;IACzB,0EAA0E;IAC1E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,0EAA0E;IAC1E,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,gFAAgF;IAChF,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;;GAKG;AACH,wBAAsB,cAAc,CAAC,CAAC,SAAS,eAAe,EAC5D,IAAI,EAAE,cAAc,GAAG;IAAE,OAAO,EAAE,qBAAqB,CAAC,CAAC,CAAC,CAAA;CAAE,GAC3D,OAAO,CAAC,oBAAoB,CAAC,CAiC/B"}
@@ -0,0 +1,58 @@
1
+ import type { SmsTemplateName } from "@hogsend/sms";
2
+ import type { SmsService } from "./sms-service-types.js";
3
+ export declare const setSmsService: (value: SmsService) => void;
4
+ /**
5
+ * The injected {@link SmsService} (set by `createHogsendClient` →
6
+ * `setSmsService`). Exposed so module-level sites with no client reference reach
7
+ * the container-built SMS sender. Throws if read before the container installs
8
+ * it — the container always runs first. When no SMS provider is configured, the
9
+ * installed service is a throwing stub whose `send` fails with an actionable
10
+ * error.
11
+ */
12
+ export declare const getSmsService: () => SmsService;
13
+ export interface SendSmsOptions {
14
+ /** E.164 recipient. */
15
+ to: string;
16
+ userId: string;
17
+ /**
18
+ * The SMS template to send — typed against the consumer's augmented
19
+ * `@hogsend/sms` `SmsTemplateRegistryMap` (`src/sms/templates.d.ts`). A key
20
+ * that was never registered is a COMPILE error here.
21
+ */
22
+ template: SmsTemplateName;
23
+ props?: Record<string, unknown>;
24
+ journeyName?: string;
25
+ journeyStateId?: string;
26
+ /** Explicit idempotency key (a public caller); always wins over auto-derivation. */
27
+ idempotencyKey?: string;
28
+ /**
29
+ * Disambiguates the exactly-once key when the SAME template is sent more than
30
+ * once in one journey enrollment on divergent branches sharing a wait label.
31
+ */
32
+ idempotencyLabel?: string;
33
+ }
34
+ export interface SendSmsResult {
35
+ smsSendId: string;
36
+ /**
37
+ * The pipeline verdict, passed through verbatim: `"sent"`, or a non-delivery
38
+ * outcome — `"suppressed"` (STOP list), `"unsubscribed"`, `"no_consent"`
39
+ * (explicit opt-in missing), `"skipped"` (frequency cap / journey suppress /
40
+ * test mode; see `reason`). Journeys treating every outcome as success
41
+ * should branch on this.
42
+ */
43
+ status: "sent" | "suppressed" | "unsubscribed" | "no_consent" | "skipped";
44
+ /** Present when `status === "skipped"` — the skip reason. */
45
+ reason?: string;
46
+ /** Present only when `status === "sent"`. */
47
+ sentAt?: string;
48
+ }
49
+ /**
50
+ * The journey-facing SMS entry point — the SMS sibling of `sendEmail`. Derives a
51
+ * deterministic, replay-stable idempotency key from the active journey boundary
52
+ * (kind `smsSend`, a namespace DISJOINT from email's `send` so a `sendEmail` and
53
+ * a `sendSms` of the same template under one wait label never collide), so a
54
+ * durable replay re-firing the same logical send is absorbed by the unique
55
+ * `sms_sends.idempotencyKey` index (Layer 2) and Hatchet's `memo` (Layer 1).
56
+ */
57
+ export declare function sendSms(opts: SendSmsOptions): Promise<SendSmsResult>;
58
+ //# sourceMappingURL=sms.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"sms.d.ts","sourceRoot":"","sources":["../../src/lib/sms.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAOpD,OAAO,KAAK,EAAE,UAAU,EAAyB,MAAM,wBAAwB,CAAC;AAIhF,eAAO,MAAM,aAAa,6BAAe,CAAC;AAE1C;;;;;;;GAOG;AACH,eAAO,MAAM,aAAa,kBAAe,CAAC;AAE1C,MAAM,WAAW,cAAc;IAC7B,uBAAuB;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf;;;;OAIG;IACH,QAAQ,EAAE,eAAe,CAAC;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,oFAAoF;IACpF,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;;OAGG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB;;;;;;OAMG;IACH,MAAM,EAAE,MAAM,GAAG,YAAY,GAAG,cAAc,GAAG,YAAY,GAAG,SAAS,CAAC;IAC1E,6DAA6D;IAC7D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,6CAA6C;IAC7C,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;GAOG;AACH,wBAAsB,OAAO,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC,CAkE1E"}
@@ -0,0 +1,32 @@
1
+ /**
2
+ * The drop-in browser snippet: `@hogsend/js` builds a single minified IIFE to
3
+ * `dist/hogsend.js`, and the engine serves it first-party at `GET /hogsend.js`
4
+ * so a site with no bundler can paste one `<script>` tag.
5
+ *
6
+ * Like the Studio SPA, `@hogsend/js` is NOT a code import of the engine — the
7
+ * asset is located on disk at boot (so consumer bundlers never inline it) and
8
+ * serving is best-effort: no file, no route (404), never a boot crash.
9
+ *
10
+ * Resolution order:
11
+ * 1. `HOGSEND_JS_PATH` env var (explicit file path; absolute or cwd-relative).
12
+ * 2. `require.resolve("@hogsend/js/package.json")` → sibling `dist/hogsend.js`
13
+ * (the package is installed alongside the engine).
14
+ * 3. Monorepo source layout: `packages/js/dist/hogsend.js` relative to here.
15
+ * 4. cwd-relative `packages/js/dist/hogsend.js`.
16
+ */
17
+ export declare function resolveSnippetPath(): string | null;
18
+ export interface LoadedSnippet {
19
+ /** The JS source, served verbatim. */
20
+ body: string;
21
+ /** Strong ETag: quoted sha256 prefix of the body. */
22
+ etag: string;
23
+ /** Where it was read from (logging). */
24
+ path: string;
25
+ }
26
+ /**
27
+ * Read the snippet ONCE. The body is small (tens of KB) and immutable for the
28
+ * life of the process, so it stays in memory; the ETag is content-derived so
29
+ * clients revalidate cheaply and a new build invalidates naturally.
30
+ */
31
+ export declare function loadSnippet(path?: string | null): LoadedSnippet | null;
32
+ //# sourceMappingURL=snippet.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"snippet.d.ts","sourceRoot":"","sources":["../../src/lib/snippet.ts"],"names":[],"mappings":"AAMA;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,GAAG,IAAI,CAyBlD;AAED,MAAM,WAAW,aAAa;IAC5B,sCAAsC;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,qDAAqD;IACrD,IAAI,EAAE,MAAM,CAAC;IACb,wCAAwC;IACxC,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CACzB,IAAI,GAAE,MAAM,GAAG,IAA2B,GACzC,aAAa,GAAG,IAAI,CAUtB"}
@@ -0,0 +1,12 @@
1
+ /**
2
+ * Deterministic JSON-ish stringify: sorted object keys, `undefined` entries
3
+ * dropped — so key insertion order and optional-field spreading never change
4
+ * the output. Hoisted VERBATIM from workflows/bucket-backfill.ts (impact
5
+ * experiments D1) so the journey version hash
6
+ * (journeys/journey-version.ts) and the bucket criteria hash share ONE
7
+ * byte-identical implementation. `bucket_configs.criteriaHash` values MUST
8
+ * NOT change across this move (no re-eval storm on boot) — locked by the
9
+ * golden-value test in stable-stringify.test.ts.
10
+ */
11
+ export declare function stableStringify(value: unknown): string;
12
+ //# sourceMappingURL=stable-stringify.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"stable-stringify.d.ts","sourceRoot":"","sources":["../../src/lib/stable-stringify.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAYtD"}
@@ -0,0 +1,21 @@
1
+ import type { OpenAPIHono } from "@hono/zod-openapi";
2
+ import type { AppEnv } from "../app.js";
3
+ export interface MountStudioResult {
4
+ /** True when the SPA was mounted, false when no built dist was found. */
5
+ mounted: boolean;
6
+ /** Absolute path to the served dist directory, when mounted. */
7
+ distPath?: string;
8
+ }
9
+ /**
10
+ * Mount the Studio SPA at `/studio/*` as static files, with an SPA fallback to
11
+ * `index.html` for client-side routes.
12
+ *
13
+ * IMPORTANT: this is intentionally OUTSIDE the `/v1/admin` auth guard at the
14
+ * static layer. The SPA itself gates access via `/v1/auth/status` + login; the
15
+ * actual data endpoints under `/v1/admin/*` stay protected by `requireAdmin`.
16
+ *
17
+ * No-op (returns `{ mounted: false }`) when no built `dist/` is found, so an
18
+ * unbuilt studio never crashes the server.
19
+ */
20
+ export declare function mountStudio(app: OpenAPIHono<AppEnv>): MountStudioResult;
21
+ //# sourceMappingURL=studio.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"studio.d.ts","sourceRoot":"","sources":["../../src/lib/studio.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAmDxC,MAAM,WAAW,iBAAiB;IAChC,yEAAyE;IACzE,OAAO,EAAE,OAAO,CAAC;IACjB,gEAAgE;IAChE,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,WAAW,CAAC,MAAM,CAAC,GAAG,iBAAiB,CAmCvE"}
@@ -0,0 +1,35 @@
1
+ import type { FeedBlock } from "@hogsend/db";
2
+ import { type SendFeedItemResult } from "./feed.js";
3
+ /** The survey block's own fields (event/mode/property/…), minus the discriminant. */
4
+ type SurveyBlockFields = Omit<Extract<FeedBlock, {
5
+ type: "survey";
6
+ }>, "type">;
7
+ /**
8
+ * Options for {@link sendSurvey} — the producer sugar that drops a `survey`
9
+ * feed block into a recipient's in-app feed. Thin over {@link sendFeedItem}, so
10
+ * it inherits the full pipeline (recipient resolution, `in_app` suppression,
11
+ * replay-safe idempotency, Redis realtime publish).
12
+ */
13
+ export interface SendSurveyOptions extends SurveyBlockFields {
14
+ recipient: {
15
+ userId?: string;
16
+ email?: string;
17
+ anonymousId?: string;
18
+ };
19
+ title?: string;
20
+ category?: string;
21
+ idempotencyKey?: string;
22
+ idempotencyLabel?: string;
23
+ }
24
+ /**
25
+ * Journey-callable in-app survey send — producer sugar over {@link sendFeedItem}.
26
+ * Builds a single `survey` feed block from `opts` and delegates, so the in-app
27
+ * survey/rating primitive gets the SAME exactly-once replay-safety and `in_app`
28
+ * suppression as any other feed send. The answer the recipient picks is captured
29
+ * onto the spine by `<SurveyBlockView>` and lands in `user_events` — readable by
30
+ * a journey via `ctx.waitForEvent → properties` and by
31
+ * `GET /v1/admin/reporting/breakdown`.
32
+ */
33
+ export declare function sendSurvey(opts: SendSurveyOptions): Promise<SendFeedItemResult>;
34
+ export {};
35
+ //# sourceMappingURL=survey.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"survey.d.ts","sourceRoot":"","sources":["../../src/lib/survey.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,KAAK,kBAAkB,EAAgB,MAAM,WAAW,CAAC;AAElE,qFAAqF;AACrF,KAAK,iBAAiB,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,CAAC,EAAE,MAAM,CAAC,CAAC;AAE9E;;;;;GAKG;AACH,MAAM,WAAW,iBAAkB,SAAQ,iBAAiB;IAC1D,SAAS,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACrE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;;;;;;;GAQG;AACH,wBAAgB,UAAU,CACxB,IAAI,EAAE,iBAAiB,GACtB,OAAO,CAAC,kBAAkB,CAAC,CAkB7B"}
@@ -0,0 +1,77 @@
1
+ import type { TestModeState } from "./domain-status.js";
2
+ import type { Logger } from "./logger.js";
3
+ /**
4
+ * Test-mode redirect helpers — the provider-neutral safety net that protects an
5
+ * operator from sending real mail before their DNS verifies. The active
6
+ * {@link TestModeState} is resolved ONCE per send by the mailer (cache-only,
7
+ * zero provider latency) and threaded here; these helpers are pure transforms.
8
+ *
9
+ * Why the redirect lives in the engine (not the provider): any `EmailProvider`
10
+ * is a dumb HTML wire; test mode must protect Postmark/SES users identically.
11
+ * Only `fromOverride` is provider-aware (Resend's `onboarding@resend.dev`), and
12
+ * that knowledge sits in the domain-status resolver, keyed on `providerId`.
13
+ */
14
+ /** The structured WARN event name fired per redirected send. */
15
+ export declare const TEST_MODE_REDIRECT_EVENT = "email.test_mode_redirect";
16
+ /** The actionable error message when test mode is active but unaddressable. */
17
+ export declare const NO_REDIRECT_MESSAGE: string;
18
+ /**
19
+ * Thrown by the no-db raw send paths (`sendRaw`/`sendBatch`) when test mode is
20
+ * active but no redirect address resolves. The tracked (DB) path does NOT throw
21
+ * — it records a `failed` row and returns a skipped result, mirroring the
22
+ * suppression branch — but the raw paths have no row to write, so they fail
23
+ * loudly rather than silently delivering to the real recipient.
24
+ */
25
+ export declare class TestModeNoRedirectError extends Error {
26
+ constructor();
27
+ }
28
+ /** The redirected wire fields for a single message. */
29
+ export interface RedirectedFields {
30
+ /** Always the single redirect inbox (cc/bcc are dropped). */
31
+ to: string[];
32
+ /** The single redirect address (`to[0]`), for the `email_sends.toEmail` column. */
33
+ redirectTo: string;
34
+ /** Prefixed `[TEST → <originalRecipients>] <subject>`. */
35
+ subject: string;
36
+ /** `fromOverride ?? originalFrom` (Resend ⇒ onboarding@resend.dev). */
37
+ from: string;
38
+ /** Comma-joined ORIGINAL recipients, for the WARN log + email_sends marker. */
39
+ originalTo: string;
40
+ /** The flattened original recipient list (to + cc + bcc). */
41
+ originalRecipients: string[];
42
+ }
43
+ /**
44
+ * Resolve the active {@link TestModeState} for a send. Returns the cached state
45
+ * when `active`, else `null` (live send). ALWAYS fires the fire-and-forget
46
+ * `refreshIfStale()` first — the ONLY cache-refresh trigger on the send path,
47
+ * never awaited. `domainStatus` is optional so direct mailer construction
48
+ * (tests) without it keeps today's behavior.
49
+ */
50
+ export declare function resolveTestMode(domainStatus?: {
51
+ testModeCached(): TestModeState;
52
+ refreshIfStale(): void;
53
+ }): TestModeState | null;
54
+ /**
55
+ * Build the redirected wire fields for one message under an active test mode.
56
+ * `to`/`cc`/`bcc` flatten into the subject prefix; the wire `to` becomes the
57
+ * single redirect inbox and cc/bcc are dropped entirely (never leak the test
58
+ * mail to an original cc/bcc recipient). Caller MUST have checked
59
+ * `state.redirectTo !== null` first (use {@link isUnaddressable}).
60
+ */
61
+ export declare function buildRedirect(opts: {
62
+ from: string;
63
+ to: string | string[];
64
+ cc?: string | string[];
65
+ bcc?: string | string[];
66
+ subject: string;
67
+ state: TestModeState;
68
+ }): RedirectedFields;
69
+ /** True when test mode is active but no redirect address resolves. */
70
+ export declare function isUnaddressable(state: TestModeState): boolean;
71
+ /** Fire the per-send structured WARN for a redirected send. */
72
+ export declare function logRedirect(logger: Logger | undefined, meta: {
73
+ originalTo: string;
74
+ redirectTo: string | null;
75
+ reason: string | null;
76
+ }): void;
77
+ //# sourceMappingURL=test-mode.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"test-mode.d.ts","sourceRoot":"","sources":["../../src/lib/test-mode.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAE1C;;;;;;;;;;GAUG;AAEH,gEAAgE;AAChE,eAAO,MAAM,wBAAwB,6BAA6B,CAAC;AAEnE,+EAA+E;AAC/E,eAAO,MAAM,mBAAmB,QAEsD,CAAC;AAEvF;;;;;;GAMG;AACH,qBAAa,uBAAwB,SAAQ,KAAK;;CAKjD;AAED,uDAAuD;AACvD,MAAM,WAAW,gBAAgB;IAC/B,6DAA6D;IAC7D,EAAE,EAAE,MAAM,EAAE,CAAC;IACb,mFAAmF;IACnF,UAAU,EAAE,MAAM,CAAC;IACnB,0DAA0D;IAC1D,OAAO,EAAE,MAAM,CAAC;IAChB,uEAAuE;IACvE,IAAI,EAAE,MAAM,CAAC;IACb,+EAA+E;IAC/E,UAAU,EAAE,MAAM,CAAC;IACnB,6DAA6D;IAC7D,kBAAkB,EAAE,MAAM,EAAE,CAAC;CAC9B;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,YAAY,CAAC,EAAE;IAC7C,cAAc,IAAI,aAAa,CAAC;IAChC,cAAc,IAAI,IAAI,CAAC;CACxB,GAAG,aAAa,GAAG,IAAI,CAKvB;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IACtB,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IACvB,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,aAAa,CAAC;CACtB,GAAG,gBAAgB,CAiBnB;AAED,sEAAsE;AACtE,wBAAgB,eAAe,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAE7D;AAED,+DAA+D;AAC/D,wBAAgB,WAAW,CACzB,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,IAAI,EAAE;IACJ,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB,GACA,IAAI,CAKN"}