@10x-media/analytics 1.0.0-beta.11 → 1.0.0-beta.13

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 (1259) hide show
  1. package/CHANGELOG.md +530 -0
  2. package/README.md +30 -37
  3. package/dist/access/adminUser.d.ts +15 -0
  4. package/dist/access/adminUser.js +13 -0
  5. package/dist/access/adminUser.js.map +1 -0
  6. package/dist/access/decideOnce.js +16 -0
  7. package/dist/access/decideOnce.js.map +1 -0
  8. package/dist/access/membership.d.ts +23 -0
  9. package/dist/access/membership.js +63 -0
  10. package/dist/access/membership.js.map +1 -0
  11. package/dist/access/principal.d.ts +37 -0
  12. package/dist/access/principal.js +29 -0
  13. package/dist/access/principal.js.map +1 -0
  14. package/dist/access/readGate.js +16 -0
  15. package/dist/access/readGate.js.map +1 -0
  16. package/dist/adapters/ga4/disableKey.js +7 -9
  17. package/dist/adapters/ga4/disableKey.js.map +1 -1
  18. package/dist/adapters/ga4/eventName.d.ts +2 -8
  19. package/dist/adapters/ga4/eventName.js +2 -8
  20. package/dist/adapters/ga4/eventName.js.map +1 -1
  21. package/dist/adapters/ga4/ga4.d.ts +17 -0
  22. package/dist/adapters/ga4/ga4.js +208 -124
  23. package/dist/adapters/ga4/ga4.js.map +1 -1
  24. package/dist/adapters/ga4/measurementId.js +2 -3
  25. package/dist/adapters/ga4/measurementId.js.map +1 -1
  26. package/dist/adapters/goalRead.js +15 -29
  27. package/dist/adapters/goalRead.js.map +1 -1
  28. package/dist/adapters/http/baseUrl.js +15 -0
  29. package/dist/adapters/http/baseUrl.js.map +1 -0
  30. package/dist/adapters/http/fetchJson.d.ts +19 -0
  31. package/dist/adapters/http/fetchJson.js +27 -8
  32. package/dist/adapters/http/fetchJson.js.map +1 -1
  33. package/dist/adapters/mapping.js +52 -0
  34. package/dist/adapters/mapping.js.map +1 -0
  35. package/dist/adapters/plausible/plausible.d.ts +19 -13
  36. package/dist/adapters/plausible/plausible.js +139 -123
  37. package/dist/adapters/plausible/plausible.js.map +1 -1
  38. package/dist/adapters/plausible/scriptId.js +19 -0
  39. package/dist/adapters/plausible/scriptId.js.map +1 -0
  40. package/dist/adapters/posthog/posthog.d.ts +26 -9
  41. package/dist/adapters/posthog/posthog.js +194 -115
  42. package/dist/adapters/posthog/posthog.js.map +1 -1
  43. package/dist/adapters/readTime.js +7 -0
  44. package/dist/adapters/readTime.js.map +1 -0
  45. package/dist/adapters/series.js +14 -8
  46. package/dist/adapters/series.js.map +1 -1
  47. package/dist/adapters/umami/umami.d.ts +13 -9
  48. package/dist/adapters/umami/umami.js +186 -173
  49. package/dist/adapters/umami/umami.js.map +1 -1
  50. package/dist/adapters/upstream.js +16 -0
  51. package/dist/adapters/upstream.js.map +1 -0
  52. package/dist/binding/report.d.ts +8 -0
  53. package/dist/binding/report.js +24 -0
  54. package/dist/binding/report.js.map +1 -0
  55. package/dist/binding/resolvePath.js +16 -29
  56. package/dist/binding/resolvePath.js.map +1 -1
  57. package/dist/binding/types.d.ts +14 -29
  58. package/dist/capture/captureRequest.js +28 -0
  59. package/dist/capture/captureRequest.js.map +1 -0
  60. package/dist/capture/exclusionEndpoint.js +98 -0
  61. package/dist/capture/exclusionEndpoint.js.map +1 -0
  62. package/dist/capture/exclusionPrelude.js +14 -0
  63. package/dist/capture/exclusionPrelude.js.map +1 -0
  64. package/dist/capture/exclusionToken.js +23 -0
  65. package/dist/capture/exclusionToken.js.map +1 -0
  66. package/dist/capture/jsLiteral.js +19 -0
  67. package/dist/capture/jsLiteral.js.map +1 -0
  68. package/dist/capture/mountPath.js +2 -3
  69. package/dist/capture/mountPath.js.map +1 -1
  70. package/dist/capture/proxyEndpoint.js +48 -95
  71. package/dist/capture/proxyEndpoint.js.map +1 -1
  72. package/dist/capture/proxyRoutes.js +58 -21
  73. package/dist/capture/proxyRoutes.js.map +1 -1
  74. package/dist/capture/relay.js +91 -0
  75. package/dist/capture/relay.js.map +1 -0
  76. package/dist/capture/requestBody.js +2 -6
  77. package/dist/capture/requestBody.js.map +1 -1
  78. package/dist/capture/requestTrust.js +45 -0
  79. package/dist/capture/requestTrust.js.map +1 -0
  80. package/dist/capture/sameSite.js +40 -0
  81. package/dist/capture/sameSite.js.map +1 -0
  82. package/dist/capture/slots.js +50 -25
  83. package/dist/capture/slots.js.map +1 -1
  84. package/dist/capture/trackerConfig.js +108 -36
  85. package/dist/capture/trackerConfig.js.map +1 -1
  86. package/dist/capture/trackerEndpoint.js +22 -21
  87. package/dist/capture/trackerEndpoint.js.map +1 -1
  88. package/dist/charts/BarList.d.ts +27 -14
  89. package/dist/charts/BarList.js +38 -83
  90. package/dist/charts/BarList.js.map +1 -1
  91. package/dist/charts/TrendChart.d.ts +40 -7
  92. package/dist/charts/TrendChart.js +243 -215
  93. package/dist/charts/TrendChart.js.map +1 -1
  94. package/dist/charts/bars.d.ts +15 -1
  95. package/dist/charts/bars.js +12 -12
  96. package/dist/charts/bars.js.map +1 -1
  97. package/dist/charts/bucket.js +106 -73
  98. package/dist/charts/bucket.js.map +1 -1
  99. package/dist/charts/inProgress.js +22 -0
  100. package/dist/charts/inProgress.js.map +1 -0
  101. package/dist/charts/series.d.ts +15 -0
  102. package/dist/charts/series.js +123 -0
  103. package/dist/charts/series.js.map +1 -0
  104. package/dist/charts/spline.js +91 -25
  105. package/dist/charts/spline.js.map +1 -1
  106. package/dist/charts/trendGeometry.js +91 -0
  107. package/dist/charts/trendGeometry.js.map +1 -0
  108. package/dist/core/adminOptions.d.ts +1 -0
  109. package/dist/core/adminOptions.js +198 -0
  110. package/dist/core/adminOptions.js.map +1 -0
  111. package/dist/core/budget.js +24 -0
  112. package/dist/core/budget.js.map +1 -0
  113. package/dist/core/cacheKey.d.ts +1 -0
  114. package/dist/core/cacheKey.js +48 -37
  115. package/dist/core/cacheKey.js.map +1 -1
  116. package/dist/core/cacheOptions.js +165 -0
  117. package/dist/core/cacheOptions.js.map +1 -0
  118. package/dist/core/capabilities.d.ts +24 -11
  119. package/dist/core/capabilities.js +96 -17
  120. package/dist/core/capabilities.js.map +1 -1
  121. package/dist/core/capture.d.ts +28 -25
  122. package/dist/core/captureOptions.d.ts +1 -0
  123. package/dist/core/captureOptions.js +258 -0
  124. package/dist/core/captureOptions.js.map +1 -0
  125. package/dist/core/clock.js +13 -0
  126. package/dist/core/clock.js.map +1 -0
  127. package/dist/core/collectionOption.d.ts +17 -0
  128. package/dist/core/collectionOption.js +104 -0
  129. package/dist/core/collectionOption.js.map +1 -0
  130. package/dist/core/collectionSlug.js +7 -0
  131. package/dist/core/collectionSlug.js.map +1 -0
  132. package/dist/core/contract.d.ts +297 -59
  133. package/dist/core/contract.js +6 -4
  134. package/dist/core/contract.js.map +1 -1
  135. package/dist/core/cron.js +57 -0
  136. package/dist/core/cron.js.map +1 -0
  137. package/dist/core/fetch.d.ts +17 -0
  138. package/dist/core/goalOptions.d.ts +1 -0
  139. package/dist/core/goalOptions.js +166 -0
  140. package/dist/core/goalOptions.js.map +1 -0
  141. package/dist/core/granularity.js +3 -2
  142. package/dist/core/granularity.js.map +1 -1
  143. package/dist/core/guards.js +17 -0
  144. package/dist/core/guards.js.map +1 -0
  145. package/dist/core/jobs.d.ts +40 -0
  146. package/dist/core/jobs.js +132 -0
  147. package/dist/core/jobs.js.map +1 -0
  148. package/dist/core/legacyOptions.js +145 -0
  149. package/dist/core/legacyOptions.js.map +1 -0
  150. package/dist/core/metricAliases.js +81 -0
  151. package/dist/core/metricAliases.js.map +1 -0
  152. package/dist/core/metricValues.js +57 -0
  153. package/dist/core/metricValues.js.map +1 -0
  154. package/dist/core/monotonic.js +10 -0
  155. package/dist/core/monotonic.js.map +1 -0
  156. package/dist/core/optionChecks.js +51 -0
  157. package/dist/core/optionChecks.js.map +1 -0
  158. package/dist/core/options.d.ts +505 -157
  159. package/dist/core/options.js +158 -219
  160. package/dist/core/options.js.map +1 -1
  161. package/dist/core/registry.js +45 -5
  162. package/dist/core/registry.js.map +1 -1
  163. package/dist/core/scopeList.js +7 -9
  164. package/dist/core/scopeList.js.map +1 -1
  165. package/dist/core/scopeOptions.d.ts +1 -0
  166. package/dist/core/scopeOptions.js +114 -0
  167. package/dist/core/scopeOptions.js.map +1 -0
  168. package/dist/core/scopedRead.js +330 -71
  169. package/dist/core/scopedRead.js.map +1 -1
  170. package/dist/core/sdks.d.ts +81 -0
  171. package/dist/core/sdks.js +23 -0
  172. package/dist/core/sdks.js.map +1 -0
  173. package/dist/core/serverEvent.d.ts +38 -20
  174. package/dist/core/serverEvent.js.map +1 -1
  175. package/dist/core/siteAddress.js +20 -0
  176. package/dist/core/siteAddress.js.map +1 -0
  177. package/dist/core/sourceErrors.js +109 -0
  178. package/dist/core/sourceErrors.js.map +1 -0
  179. package/dist/core/sourceLabel.d.ts +10 -0
  180. package/dist/core/sourceLabel.js +63 -0
  181. package/dist/core/sourceLabel.js.map +1 -0
  182. package/dist/core/sourceOptions.js +106 -0
  183. package/dist/core/sourceOptions.js.map +1 -0
  184. package/dist/core/sourcePolicy.d.ts +55 -0
  185. package/dist/core/sourcePolicy.js +51 -0
  186. package/dist/core/sourcePolicy.js.map +1 -0
  187. package/dist/core/throttle.js +18 -0
  188. package/dist/core/throttle.js.map +1 -0
  189. package/dist/core/values.js +61 -0
  190. package/dist/core/values.js.map +1 -0
  191. package/dist/core/widgetSlugs.d.ts +17 -0
  192. package/dist/core/widgetSlugs.js +29 -0
  193. package/dist/core/widgetSlugs.js.map +1 -0
  194. package/dist/db/detachedWrite.js +36 -0
  195. package/dist/db/detachedWrite.js.map +1 -0
  196. package/dist/db/errors.js +182 -0
  197. package/dist/db/errors.js.map +1 -0
  198. package/dist/db/kind.js +32 -0
  199. package/dist/db/kind.js.map +1 -0
  200. package/dist/db/openTransaction.js +51 -0
  201. package/dist/db/openTransaction.js.map +1 -0
  202. package/dist/exports/adapters/contract.d.ts +15 -0
  203. package/dist/exports/adapters/ga4.d.ts +16 -1
  204. package/dist/exports/adapters/native.d.ts +27 -2
  205. package/dist/exports/adapters/native.js +4 -1
  206. package/dist/exports/adapters/plausible.d.ts +16 -1
  207. package/dist/exports/adapters/posthog.d.ts +16 -1
  208. package/dist/exports/adapters/umami.d.ts +16 -1
  209. package/dist/exports/attributes.d.ts +42 -0
  210. package/dist/exports/attributes.js +83 -0
  211. package/dist/exports/attributes.js.map +1 -0
  212. package/dist/exports/client.d.ts +43 -13
  213. package/dist/exports/client.js +22 -9
  214. package/dist/exports/geo.d.ts +3 -1
  215. package/dist/exports/geo.js +1 -1
  216. package/dist/exports/i18n.d.ts +2 -2
  217. package/dist/exports/i18n.js +2 -2
  218. package/dist/exports/migrations.d.ts +2 -0
  219. package/dist/exports/migrations.js +2 -0
  220. package/dist/exports/next.d.ts +19 -1
  221. package/dist/exports/next.js +3 -1
  222. package/dist/exports/react.d.ts +3 -2
  223. package/dist/exports/react.js +1 -2
  224. package/dist/exports/rsc.d.ts +32 -14
  225. package/dist/exports/rsc.js +11 -6
  226. package/dist/exports/site.d.ts +5 -0
  227. package/dist/exports/site.js +3 -0
  228. package/dist/exports/testing.d.ts +18 -0
  229. package/dist/exports/testing.js +3 -0
  230. package/dist/exports/tracker.d.ts +5 -20
  231. package/dist/exports/tracker.js +3 -14
  232. package/dist/exports/types.d.ts +44 -14
  233. package/dist/exports/types.js +5 -1
  234. package/dist/fields/AnalyticsPanelClient.js +265 -154
  235. package/dist/fields/AnalyticsPanelClient.js.map +1 -1
  236. package/dist/fields/AnalyticsPanelField.d.ts +19 -7
  237. package/dist/fields/AnalyticsPanelField.js +123 -30
  238. package/dist/fields/AnalyticsPanelField.js.map +1 -1
  239. package/dist/fields/AnalyticsStatField.d.ts +17 -6
  240. package/dist/fields/AnalyticsStatField.js +98 -63
  241. package/dist/fields/AnalyticsStatField.js.map +1 -1
  242. package/dist/fields/FieldShimmer.js +15 -0
  243. package/dist/fields/FieldShimmer.js.map +1 -0
  244. package/dist/fields/PanelContent.js +222 -0
  245. package/dist/fields/PanelContent.js.map +1 -0
  246. package/dist/fields/PanelList.js +82 -0
  247. package/dist/fields/PanelList.js.map +1 -0
  248. package/dist/fields/PanelLiveCounter.js +63 -0
  249. package/dist/fields/PanelLiveCounter.js.map +1 -0
  250. package/dist/fields/PanelSkeleton.js +63 -0
  251. package/dist/fields/PanelSkeleton.js.map +1 -0
  252. package/dist/fields/componentPaths.js +8 -0
  253. package/dist/fields/componentPaths.js.map +1 -0
  254. package/dist/fields/config/FilterDimensionSelectField.d.ts +2 -2
  255. package/dist/fields/config/FilterDimensionSelectField.js +26 -54
  256. package/dist/fields/config/FilterDimensionSelectField.js.map +1 -1
  257. package/dist/fields/config/FilterKeySelect.js +66 -0
  258. package/dist/fields/config/FilterKeySelect.js.map +1 -0
  259. package/dist/fields/config/FilterOperatorSelectField.d.ts +7 -2
  260. package/dist/fields/config/FilterOperatorSelectField.js +37 -53
  261. package/dist/fields/config/FilterOperatorSelectField.js.map +1 -1
  262. package/dist/fields/config/FilterValueField.d.ts +17 -0
  263. package/dist/fields/config/FilterValueField.js +130 -0
  264. package/dist/fields/config/FilterValueField.js.map +1 -0
  265. package/dist/fields/config/MetricSelectField.d.ts +5 -12
  266. package/dist/fields/config/MetricSelectField.js +18 -30
  267. package/dist/fields/config/MetricSelectField.js.map +1 -1
  268. package/dist/fields/config/OptionSelect.js +52 -0
  269. package/dist/fields/config/OptionSelect.js.map +1 -0
  270. package/dist/fields/config/SourceSelectField.js +16 -31
  271. package/dist/fields/config/SourceSelectField.js.map +1 -1
  272. package/dist/fields/config/fetchSources.d.ts +3 -0
  273. package/dist/fields/config/fetchSources.js +17 -27
  274. package/dist/fields/config/fetchSources.js.map +1 -1
  275. package/dist/fields/config/filterValues.js +106 -0
  276. package/dist/fields/config/filterValues.js.map +1 -0
  277. package/dist/fields/config/narrow.js +8 -10
  278. package/dist/fields/config/narrow.js.map +1 -1
  279. package/dist/fields/config/retiredPickers.d.ts +45 -0
  280. package/dist/fields/config/retiredPickers.js +46 -0
  281. package/dist/fields/config/retiredPickers.js.map +1 -0
  282. package/dist/fields/config/scopedFields.d.ts +40 -0
  283. package/dist/fields/config/scopedFields.js +68 -0
  284. package/dist/fields/config/scopedFields.js.map +1 -0
  285. package/dist/fields/config/toSelectOption.js +13 -7
  286. package/dist/fields/config/toSelectOption.js.map +1 -1
  287. package/dist/fields/config/useAnalyticsSources.d.ts +5 -7
  288. package/dist/fields/config/useAnalyticsSources.js +17 -21
  289. package/dist/fields/config/useAnalyticsSources.js.map +1 -1
  290. package/dist/fields/config/useFilterCapabilities.d.ts +9 -6
  291. package/dist/fields/config/useFilterCapabilities.js +23 -15
  292. package/dist/fields/config/useFilterCapabilities.js.map +1 -1
  293. package/dist/fields/config/useFormString.js +12 -0
  294. package/dist/fields/config/useFormString.js.map +1 -0
  295. package/dist/fields/dateRange/field.js +7 -19
  296. package/dist/fields/dateRange/field.js.map +1 -1
  297. package/dist/fields/dateRange/types.d.ts +5 -1
  298. package/dist/fields/dateRange/ui.d.ts +3 -2
  299. package/dist/fields/dateRange/ui.js +57 -319
  300. package/dist/fields/dateRange/ui.js.map +1 -1
  301. package/dist/fields/documentScope.js +21 -0
  302. package/dist/fields/documentScope.js.map +1 -0
  303. package/dist/fields/emptyState.js +31 -26
  304. package/dist/fields/emptyState.js.map +1 -1
  305. package/dist/fields/factories.d.ts +35 -16
  306. package/dist/fields/factories.js +66 -37
  307. package/dist/fields/factories.js.map +1 -1
  308. package/dist/fields/format.d.ts +12 -3
  309. package/dist/fields/format.js +77 -13
  310. package/dist/fields/format.js.map +1 -1
  311. package/dist/fields/itemReport.js +45 -0
  312. package/dist/fields/itemReport.js.map +1 -0
  313. package/dist/fields/readForDocument.d.ts +79 -26
  314. package/dist/fields/readForDocument.js +450 -116
  315. package/dist/fields/readForDocument.js.map +1 -1
  316. package/dist/fields/stateKeys.js +20 -0
  317. package/dist/fields/stateKeys.js.map +1 -0
  318. package/dist/goals/GoalAmountField.d.ts +10 -0
  319. package/dist/goals/GoalAmountField.js +162 -0
  320. package/dist/goals/GoalAmountField.js.map +1 -0
  321. package/dist/goals/GoalSelectField.js +89 -40
  322. package/dist/goals/GoalSelectField.js.map +1 -1
  323. package/dist/goals/GoalSelectFieldServer.d.ts +13 -0
  324. package/dist/goals/GoalSelectFieldServer.js +21 -0
  325. package/dist/goals/GoalSelectFieldServer.js.map +1 -0
  326. package/dist/goals/amountField.d.ts +20 -0
  327. package/dist/goals/amountField.js +37 -0
  328. package/dist/goals/amountField.js.map +1 -0
  329. package/dist/goals/builtin.js +17 -0
  330. package/dist/goals/builtin.js.map +1 -0
  331. package/dist/goals/collection.d.ts +22 -0
  332. package/dist/goals/collection.js +139 -125
  333. package/dist/goals/collection.js.map +1 -1
  334. package/dist/goals/constants.d.ts +38 -0
  335. package/dist/goals/constants.js +49 -0
  336. package/dist/goals/constants.js.map +1 -0
  337. package/dist/goals/currency.d.ts +16 -0
  338. package/dist/goals/currency.js +46 -4
  339. package/dist/goals/currency.js.map +1 -1
  340. package/dist/goals/currencyOptions.js +70 -0
  341. package/dist/goals/currencyOptions.js.map +1 -0
  342. package/dist/goals/fetchGoals.d.ts +10 -0
  343. package/dist/goals/fetchGoals.js +12 -26
  344. package/dist/goals/fetchGoals.js.map +1 -1
  345. package/dist/goals/goalField.d.ts +4 -6
  346. package/dist/goals/goalField.js +9 -19
  347. package/dist/goals/goalField.js.map +1 -1
  348. package/dist/goals/goalsEndpoint.js +39 -40
  349. package/dist/goals/goalsEndpoint.js.map +1 -1
  350. package/dist/goals/items.js +35 -0
  351. package/dist/goals/items.js.map +1 -0
  352. package/dist/goals/latent.js +9 -0
  353. package/dist/goals/latent.js.map +1 -0
  354. package/dist/goals/linkFields.d.ts +35 -0
  355. package/dist/goals/linkFields.js +31 -0
  356. package/dist/goals/linkFields.js.map +1 -0
  357. package/dist/goals/match.d.ts +14 -0
  358. package/dist/goals/match.js +67 -46
  359. package/dist/goals/match.js.map +1 -1
  360. package/dist/goals/moneyFields.js +56 -0
  361. package/dist/goals/moneyFields.js.map +1 -0
  362. package/dist/goals/pathMatch.js +122 -0
  363. package/dist/goals/pathMatch.js.map +1 -0
  364. package/dist/goals/placeholder.js +12 -0
  365. package/dist/goals/placeholder.js.map +1 -0
  366. package/dist/goals/resolver.d.ts +3 -3
  367. package/dist/goals/resolver.js +155 -47
  368. package/dist/goals/resolver.js.map +1 -1
  369. package/dist/goals/serverRevenue.d.ts +60 -0
  370. package/dist/goals/serverRevenue.js +41 -0
  371. package/dist/goals/serverRevenue.js.map +1 -0
  372. package/dist/goals/trackGoalAction.d.ts +26 -27
  373. package/dist/goals/trackGoalAction.js +38 -52
  374. package/dist/goals/trackGoalAction.js.map +1 -1
  375. package/dist/goals/types.d.ts +13 -28
  376. package/dist/goals/types.js +1 -1
  377. package/dist/goals/types.js.map +1 -1
  378. package/dist/goals/useAnalyticsGoals.d.ts +6 -5
  379. package/dist/goals/useAnalyticsGoals.js +17 -18
  380. package/dist/goals/useAnalyticsGoals.js.map +1 -1
  381. package/dist/index.d.ts +67 -12
  382. package/dist/index.js +258 -247
  383. package/dist/index.js.map +1 -1
  384. package/dist/items/collectionIdType.js +20 -0
  385. package/dist/items/collectionIdType.js.map +1 -0
  386. package/dist/items/idType.js +31 -0
  387. package/dist/items/idType.js.map +1 -0
  388. package/dist/items/ref.js +73 -0
  389. package/dist/items/ref.js.map +1 -0
  390. package/dist/maintenance/apiTaskState.js +141 -0
  391. package/dist/maintenance/apiTaskState.js.map +1 -0
  392. package/dist/maintenance/heartbeat.js +51 -0
  393. package/dist/maintenance/heartbeat.js.map +1 -0
  394. package/dist/maintenance/lease.d.ts +1 -0
  395. package/dist/maintenance/lease.js +81 -0
  396. package/dist/maintenance/lease.js.map +1 -0
  397. package/dist/maintenance/taskSchedule.d.ts +1 -0
  398. package/dist/maintenance/taskSchedule.js +62 -0
  399. package/dist/maintenance/taskSchedule.js.map +1 -0
  400. package/dist/maintenance/underLease.js +35 -0
  401. package/dist/maintenance/underLease.js.map +1 -0
  402. package/dist/migrations/legacy.d.ts +54 -0
  403. package/dist/migrations/legacy.js +117 -0
  404. package/dist/migrations/legacy.js.map +1 -0
  405. package/dist/migrations/predefined/dropLegacyMongo.d.ts +11 -0
  406. package/dist/migrations/predefined/dropLegacyMongo.js +12 -0
  407. package/dist/migrations/predefined/dropLegacyMongo.js.map +1 -0
  408. package/dist/native/collections/aggregates.js +54 -0
  409. package/dist/native/collections/aggregates.js.map +1 -0
  410. package/dist/native/collections/hits.js +102 -0
  411. package/dist/native/collections/hits.js.map +1 -0
  412. package/dist/native/collections/slugs.d.ts +10 -0
  413. package/dist/native/collections/slugs.js +16 -0
  414. package/dist/native/collections/slugs.js.map +1 -0
  415. package/dist/native/collections/state.js +84 -0
  416. package/dist/native/collections/state.js.map +1 -0
  417. package/dist/native/collections/storeCollection.js +29 -0
  418. package/dist/native/collections/storeCollection.js.map +1 -0
  419. package/dist/native/engine/buckets.d.ts +1 -0
  420. package/dist/native/engine/buckets.js +53 -0
  421. package/dist/native/engine/buckets.js.map +1 -0
  422. package/dist/native/engine/capabilities.js +87 -0
  423. package/dist/native/engine/capabilities.js.map +1 -0
  424. package/dist/native/engine/cost.js +72 -0
  425. package/dist/native/engine/cost.js.map +1 -0
  426. package/dist/native/engine/days.d.ts +1 -0
  427. package/dist/native/engine/days.js +182 -0
  428. package/dist/native/engine/days.js.map +1 -0
  429. package/dist/native/engine/engine.d.ts +1 -0
  430. package/dist/native/engine/engine.js +1623 -0
  431. package/dist/native/engine/engine.js.map +1 -0
  432. package/dist/native/engine/instance.js +58 -0
  433. package/dist/native/engine/instance.js.map +1 -0
  434. package/dist/native/engine/maintenance.d.ts +1 -0
  435. package/dist/native/engine/maintenance.js +677 -0
  436. package/dist/native/engine/maintenance.js.map +1 -0
  437. package/dist/native/engine/merge.js +41 -0
  438. package/dist/native/engine/merge.js.map +1 -0
  439. package/dist/native/engine/nudge.js +26 -0
  440. package/dist/native/engine/nudge.js.map +1 -0
  441. package/dist/native/engine/planner.js +198 -0
  442. package/dist/native/engine/planner.js.map +1 -0
  443. package/dist/native/engine/rebuild.d.ts +22 -0
  444. package/dist/native/engine/rebuild.js +76 -0
  445. package/dist/native/engine/rebuild.js.map +1 -0
  446. package/dist/native/engine/recent.js +17 -0
  447. package/dist/native/engine/recent.js.map +1 -0
  448. package/dist/native/engine/salt.d.ts +1 -0
  449. package/dist/native/engine/salt.js +98 -0
  450. package/dist/native/engine/salt.js.map +1 -0
  451. package/dist/native/engine/siteHosts.d.ts +1 -0
  452. package/dist/native/engine/siteHosts.js +58 -0
  453. package/dist/native/engine/siteHosts.js.map +1 -0
  454. package/dist/native/engine/toHit.js +108 -0
  455. package/dist/native/engine/toHit.js.map +1 -0
  456. package/dist/native/engine/writeBuffer.d.ts +14 -0
  457. package/dist/native/engine/writeBuffer.js +317 -0
  458. package/dist/native/engine/writeBuffer.js.map +1 -0
  459. package/dist/native/geo/composeGeoResolvers.d.ts +1 -0
  460. package/dist/native/geo/composeGeoResolvers.js +4 -1
  461. package/dist/native/geo/composeGeoResolvers.js.map +1 -1
  462. package/dist/native/geo/geoResolver.d.ts +20 -2
  463. package/dist/native/geo/geoResolver.js +42 -6
  464. package/dist/native/geo/geoResolver.js.map +1 -1
  465. package/dist/native/geo/maxmindResolver.d.ts +8 -4
  466. package/dist/native/geo/maxmindResolver.js +20 -16
  467. package/dist/native/geo/maxmindResolver.js.map +1 -1
  468. package/dist/native/geo/resolveGeo.js +31 -0
  469. package/dist/native/geo/resolveGeo.js.map +1 -0
  470. package/dist/native/ingest/bots.d.ts +2 -3
  471. package/dist/native/ingest/bots.js +8 -13
  472. package/dist/native/ingest/bots.js.map +1 -1
  473. package/dist/native/ingest/browser.js +4 -6
  474. package/dist/native/ingest/browser.js.map +1 -1
  475. package/dist/native/ingest/clientIp.js +30 -9
  476. package/dist/native/ingest/clientIp.js.map +1 -1
  477. package/dist/native/ingest/device.js +4 -6
  478. package/dist/native/ingest/device.js.map +1 -1
  479. package/dist/native/ingest/endpoint.d.ts +1 -1
  480. package/dist/native/ingest/endpoint.js +119 -34
  481. package/dist/native/ingest/endpoint.js.map +1 -1
  482. package/dist/native/ingest/itemSignature.d.ts +26 -0
  483. package/dist/native/ingest/itemSignature.js +45 -0
  484. package/dist/native/ingest/itemSignature.js.map +1 -0
  485. package/dist/native/ingest/language.js +2 -3
  486. package/dist/native/ingest/language.js.map +1 -1
  487. package/dist/native/ingest/normalizeEvent.d.ts +60 -7
  488. package/dist/native/ingest/normalizeEvent.js +226 -61
  489. package/dist/native/ingest/normalizeEvent.js.map +1 -1
  490. package/dist/native/ingest/orderSignature.d.ts +13 -0
  491. package/dist/native/ingest/orderSignature.js +50 -0
  492. package/dist/native/ingest/orderSignature.js.map +1 -0
  493. package/dist/native/ingest/referrer.js +30 -32
  494. package/dist/native/ingest/referrer.js.map +1 -1
  495. package/dist/native/ingest/requestHost.js +10 -23
  496. package/dist/native/ingest/requestHost.js.map +1 -1
  497. package/dist/native/ingest/resolveHostname.d.ts +4 -13
  498. package/dist/native/ingest/resolveHostname.js +5 -6
  499. package/dist/native/ingest/resolveHostname.js.map +1 -1
  500. package/dist/native/ingest/revenue.d.ts +1 -0
  501. package/dist/native/ingest/revenue.js +121 -0
  502. package/dist/native/ingest/revenue.js.map +1 -0
  503. package/dist/native/ingest/route.d.ts +10 -0
  504. package/dist/native/ingest/route.js +82 -0
  505. package/dist/native/ingest/route.js.map +1 -0
  506. package/dist/native/ingest/serverTrack.d.ts +2 -10
  507. package/dist/native/ingest/serverTrack.js +181 -72
  508. package/dist/native/ingest/serverTrack.js.map +1 -1
  509. package/dist/native/ingest/signature.js +28 -0
  510. package/dist/native/ingest/signature.js.map +1 -0
  511. package/dist/native/ingest/source.d.ts +2 -3
  512. package/dist/native/ingest/source.js +35 -54
  513. package/dist/native/ingest/source.js.map +1 -1
  514. package/dist/native/ingest/utm.js +9 -9
  515. package/dist/native/ingest/utm.js.map +1 -1
  516. package/dist/native/ingest/validate.js +20 -10
  517. package/dist/native/ingest/validate.js.map +1 -1
  518. package/dist/native/ingest/visitorHash.js +6 -8
  519. package/dist/native/ingest/visitorHash.js.map +1 -1
  520. package/dist/native/nativeAdapter.d.ts +107 -33
  521. package/dist/native/nativeAdapter.js +376 -317
  522. package/dist/native/nativeAdapter.js.map +1 -1
  523. package/dist/native/rebuildDays.d.ts +12 -0
  524. package/dist/native/rebuildDays.js +16 -0
  525. package/dist/native/rebuildDays.js.map +1 -0
  526. package/dist/native/store/aggregate.js +450 -0
  527. package/dist/native/store/aggregate.js.map +1 -0
  528. package/dist/native/store/caps.d.ts +18 -0
  529. package/dist/native/store/caps.js +76 -0
  530. package/dist/native/store/caps.js.map +1 -0
  531. package/dist/native/store/chunks.js +34 -0
  532. package/dist/native/store/chunks.js.map +1 -0
  533. package/dist/native/store/columnValues.js +31 -0
  534. package/dist/native/store/columnValues.js.map +1 -0
  535. package/dist/native/store/dialect.js +106 -0
  536. package/dist/native/store/dialect.js.map +1 -0
  537. package/dist/native/store/eventStore.js +44 -0
  538. package/dist/native/store/eventStore.js.map +1 -0
  539. package/dist/native/store/hitRow.js +116 -0
  540. package/dist/native/store/hitRow.js.map +1 -0
  541. package/dist/native/store/hits.js +63 -0
  542. package/dist/native/store/hits.js.map +1 -0
  543. package/dist/native/store/ids.js +105 -0
  544. package/dist/native/store/ids.js.map +1 -0
  545. package/dist/native/store/mongo/aggregatePipelines.js +430 -0
  546. package/dist/native/store/mongo/aggregatePipelines.js.map +1 -0
  547. package/dist/native/store/mongo/mongoState.js +375 -0
  548. package/dist/native/store/mongo/mongoState.js.map +1 -0
  549. package/dist/native/store/mongo/mongoStore.js +618 -0
  550. package/dist/native/store/mongo/mongoStore.js.map +1 -0
  551. package/dist/native/store/mongo/pipelines.js +695 -0
  552. package/dist/native/store/mongo/pipelines.js.map +1 -0
  553. package/dist/native/store/mongo/results.js +20 -0
  554. package/dist/native/store/mongo/results.js.map +1 -0
  555. package/dist/native/store/parts.d.ts +1 -0
  556. package/dist/native/store/parts.js +95 -0
  557. package/dist/native/store/parts.js.map +1 -0
  558. package/dist/native/store/pattern.js +213 -0
  559. package/dist/native/store/pattern.js.map +1 -0
  560. package/dist/native/store/rawRead.d.ts +23 -0
  561. package/dist/native/store/rawRead.js +384 -0
  562. package/dist/native/store/rawRead.js.map +1 -0
  563. package/dist/native/store/reclassify.js +53 -0
  564. package/dist/native/store/reclassify.js.map +1 -0
  565. package/dist/native/store/sql/aggregateSql.js +345 -0
  566. package/dist/native/store/sql/aggregateSql.js.map +1 -0
  567. package/dist/native/store/sql/columns.js +48 -0
  568. package/dist/native/store/sql/columns.js.map +1 -0
  569. package/dist/native/store/sql/compile.js +656 -0
  570. package/dist/native/store/sql/compile.js.map +1 -0
  571. package/dist/native/store/sql/drivers.js +218 -0
  572. package/dist/native/store/sql/drivers.js.map +1 -0
  573. package/dist/native/store/sql/executor.js +132 -0
  574. package/dist/native/store/sql/executor.js.map +1 -0
  575. package/dist/native/store/sql/fragment.js +104 -0
  576. package/dist/native/store/sql/fragment.js.map +1 -0
  577. package/dist/native/store/sql/maintenanceSql.js +59 -0
  578. package/dist/native/store/sql/maintenanceSql.js.map +1 -0
  579. package/dist/native/store/sql/ownConnection.js +107 -0
  580. package/dist/native/store/sql/ownConnection.js.map +1 -0
  581. package/dist/native/store/sql/poolShare.js +101 -0
  582. package/dist/native/store/sql/poolShare.js.map +1 -0
  583. package/dist/native/store/sql/sqlState.js +325 -0
  584. package/dist/native/store/sql/sqlState.js.map +1 -0
  585. package/dist/native/store/sql/sqlStore.js +355 -0
  586. package/dist/native/store/sql/sqlStore.js.map +1 -0
  587. package/dist/native/store/sql/sqliteThread.d.ts +9 -0
  588. package/dist/native/store/sql/sqliteThread.js +314 -0
  589. package/dist/native/store/sql/sqliteThread.js.map +1 -0
  590. package/dist/native/store/sql/sqliteWorker.js +327 -0
  591. package/dist/native/store/sql/sqliteWorker.js.map +1 -0
  592. package/dist/native/store/sql/sqliteWorkerSource.js +347 -0
  593. package/dist/native/store/sql/sqliteWorkerSource.js.map +1 -0
  594. package/dist/native/store/state.js +151 -0
  595. package/dist/native/store/state.js.map +1 -0
  596. package/dist/native/store/stateStore.js +29 -0
  597. package/dist/native/store/stateStore.js.map +1 -0
  598. package/dist/native/store/types.d.ts +9 -0
  599. package/dist/native/tasks/maintainTask.d.ts +19 -0
  600. package/dist/native/tasks/maintainTask.js +68 -0
  601. package/dist/native/tasks/maintainTask.js.map +1 -0
  602. package/dist/net/guardedFetch.d.ts +32 -0
  603. package/dist/net/guardedFetch.js +220 -0
  604. package/dist/net/guardedFetch.js.map +1 -0
  605. package/dist/net/origin.js +40 -0
  606. package/dist/net/origin.js.map +1 -0
  607. package/dist/net/platform.d.ts +9 -0
  608. package/dist/net/platform.js +35 -0
  609. package/dist/net/platform.js.map +1 -0
  610. package/dist/next/captureRewrites.d.ts +4 -24
  611. package/dist/next/captureRewrites.js +6 -50
  612. package/dist/next/captureRewrites.js.map +1 -1
  613. package/dist/next/captureRoute.d.ts +28 -0
  614. package/dist/next/captureRoute.js +67 -0
  615. package/dist/next/captureRoute.js.map +1 -0
  616. package/dist/next/ingestRoute.d.ts +17 -0
  617. package/dist/next/ingestRoute.js +17 -0
  618. package/dist/next/ingestRoute.js.map +1 -0
  619. package/dist/next/posthogProxyRewrites.d.ts +3 -25
  620. package/dist/next/posthogProxyRewrites.js +5 -37
  621. package/dist/next/posthogProxyRewrites.js.map +1 -1
  622. package/dist/plugin/adminDependencies.js +34 -0
  623. package/dist/plugin/adminDependencies.js.map +1 -0
  624. package/dist/plugin/apiPath.js +23 -0
  625. package/dist/plugin/apiPath.js.map +1 -0
  626. package/dist/plugin/boundDocument.js +58 -0
  627. package/dist/plugin/boundDocument.js.map +1 -0
  628. package/dist/plugin/buildPhase.js +10 -0
  629. package/dist/plugin/buildPhase.js.map +1 -0
  630. package/dist/plugin/collectionChecks.js +232 -0
  631. package/dist/plugin/collectionChecks.js.map +1 -0
  632. package/dist/plugin/collectionFields.d.ts +13 -0
  633. package/dist/plugin/collectionFields.js +22 -0
  634. package/dist/plugin/collectionFields.js.map +1 -0
  635. package/dist/plugin/createRuntime.js +339 -0
  636. package/dist/plugin/createRuntime.js.map +1 -0
  637. package/dist/plugin/destroy.js +58 -0
  638. package/dist/plugin/destroy.js.map +1 -0
  639. package/dist/plugin/documentEndpoint.js +77 -53
  640. package/dist/plugin/documentEndpoint.js.map +1 -1
  641. package/dist/plugin/documentScopes.js +37 -0
  642. package/dist/plugin/documentScopes.js.map +1 -0
  643. package/dist/plugin/encrypted.js +25 -0
  644. package/dist/plugin/encrypted.js.map +1 -0
  645. package/dist/plugin/errors.d.ts +5 -12
  646. package/dist/plugin/errors.js +23 -16
  647. package/dist/plugin/errors.js.map +1 -1
  648. package/dist/plugin/flagsEndpoint.js +41 -0
  649. package/dist/plugin/flagsEndpoint.js.map +1 -0
  650. package/dist/plugin/goalHint.js +22 -11
  651. package/dist/plugin/goalHint.js.map +1 -1
  652. package/dist/plugin/itemLabels.js +114 -0
  653. package/dist/plugin/itemLabels.js.map +1 -0
  654. package/dist/plugin/jobsAccess.js +91 -0
  655. package/dist/plugin/jobsAccess.js.map +1 -0
  656. package/dist/plugin/keepAlive.js +48 -0
  657. package/dist/plugin/keepAlive.js.map +1 -0
  658. package/dist/plugin/peerImportError.js +3 -6
  659. package/dist/plugin/peerImportError.js.map +1 -1
  660. package/dist/plugin/peers.js +64 -0
  661. package/dist/plugin/peers.js.map +1 -0
  662. package/dist/plugin/pluginCollections.js +161 -0
  663. package/dist/plugin/pluginCollections.js.map +1 -0
  664. package/dist/plugin/queryEndpoint.js +70 -45
  665. package/dist/plugin/queryEndpoint.js.map +1 -1
  666. package/dist/plugin/queryParams.js +7 -0
  667. package/dist/plugin/queryParams.js.map +1 -0
  668. package/dist/plugin/readContextForRequest.d.ts +11 -0
  669. package/dist/plugin/readContextForRequest.js +70 -25
  670. package/dist/plugin/readContextForRequest.js.map +1 -1
  671. package/dist/plugin/readFailure.js +22 -0
  672. package/dist/plugin/readFailure.js.map +1 -0
  673. package/dist/plugin/readableProviders.js +64 -0
  674. package/dist/plugin/readableProviders.js.map +1 -0
  675. package/dist/plugin/realtimeEndpoint.js +77 -25
  676. package/dist/plugin/realtimeEndpoint.js.map +1 -1
  677. package/dist/plugin/refreshEndpoint.js +69 -44
  678. package/dist/plugin/refreshEndpoint.js.map +1 -1
  679. package/dist/plugin/relabelFields.js +36 -0
  680. package/dist/plugin/relabelFields.js.map +1 -0
  681. package/dist/plugin/requestMemo.js +35 -0
  682. package/dist/plugin/requestMemo.js.map +1 -0
  683. package/dist/plugin/routeChecks.js +39 -0
  684. package/dist/plugin/routeChecks.js.map +1 -0
  685. package/dist/plugin/routes.d.ts +53 -0
  686. package/dist/plugin/routes.js +92 -0
  687. package/dist/plugin/routes.js.map +1 -0
  688. package/dist/plugin/runtime.d.ts +1 -1
  689. package/dist/plugin/runtime.js +234 -30
  690. package/dist/plugin/runtime.js.map +1 -1
  691. package/dist/plugin/schemaOnly.js +63 -0
  692. package/dist/plugin/schemaOnly.js.map +1 -0
  693. package/dist/plugin/scopeChange.js +6 -5
  694. package/dist/plugin/scopeChange.js.map +1 -1
  695. package/dist/plugin/scopeFieldBoot.js +4 -4
  696. package/dist/plugin/scopeFieldBoot.js.map +1 -1
  697. package/dist/plugin/scopeToken.js +33 -0
  698. package/dist/plugin/scopeToken.js.map +1 -0
  699. package/dist/plugin/sourcesEndpoint.js +50 -17
  700. package/dist/plugin/sourcesEndpoint.js.map +1 -1
  701. package/dist/plugin/unbundledLanguages.js +25 -0
  702. package/dist/plugin/unbundledLanguages.js.map +1 -0
  703. package/dist/plugin/walkFields.js +22 -0
  704. package/dist/plugin/walkFields.js.map +1 -0
  705. package/dist/plugin/warmTask.js +0 -0
  706. package/dist/plugin/warmTask.js.map +1 -1
  707. package/dist/providers/ProvidersListNotice.d.ts +11 -0
  708. package/dist/providers/ProvidersListNotice.js +36 -0
  709. package/dist/providers/ProvidersListNotice.js.map +1 -0
  710. package/dist/providers/access.d.ts +1 -0
  711. package/dist/providers/access.js +35 -26
  712. package/dist/providers/access.js.map +1 -1
  713. package/dist/providers/adapterPool.js +121 -0
  714. package/dist/providers/adapterPool.js.map +1 -0
  715. package/dist/providers/collection.d.ts +61 -0
  716. package/dist/providers/collection.js +340 -151
  717. package/dist/providers/collection.js.map +1 -1
  718. package/dist/providers/factory.d.ts +76 -0
  719. package/dist/providers/factory.js +75 -25
  720. package/dist/providers/factory.js.map +1 -1
  721. package/dist/providers/hosts.d.ts +25 -0
  722. package/dist/providers/hosts.js +128 -0
  723. package/dist/providers/hosts.js.map +1 -0
  724. package/dist/providers/probe.d.ts +1 -0
  725. package/dist/providers/probe.js +105 -0
  726. package/dist/providers/probe.js.map +1 -0
  727. package/dist/providers/refresh.d.ts +18 -0
  728. package/dist/providers/refresh.js +49 -0
  729. package/dist/providers/refresh.js.map +1 -0
  730. package/dist/providers/registry.js +328 -0
  731. package/dist/providers/registry.js.map +1 -0
  732. package/dist/providers/resolver.js +26 -88
  733. package/dist/providers/resolver.js.map +1 -1
  734. package/dist/providers/retarget.js +45 -0
  735. package/dist/providers/retarget.js.map +1 -0
  736. package/dist/providers/scopeUnique.js +41 -0
  737. package/dist/providers/scopeUnique.js.map +1 -0
  738. package/dist/providers/secrets.d.ts +26 -0
  739. package/dist/providers/secrets.js +61 -4
  740. package/dist/providers/secrets.js.map +1 -1
  741. package/dist/providers/stampScope.js +9 -6
  742. package/dist/providers/stampScope.js.map +1 -1
  743. package/dist/query/dates.js +10 -12
  744. package/dist/query/dates.js.map +1 -1
  745. package/dist/query/errors.d.ts +1 -5
  746. package/dist/query/fetchQuery.d.ts +25 -32
  747. package/dist/query/fetchQuery.js +91 -91
  748. package/dist/query/fetchQuery.js.map +1 -1
  749. package/dist/query/limits.js +8 -0
  750. package/dist/query/limits.js.map +1 -0
  751. package/dist/query/parse.d.ts +6 -0
  752. package/dist/query/parse.js +153 -106
  753. package/dist/query/parse.js.map +1 -1
  754. package/dist/query/response.d.ts +23 -3
  755. package/dist/query/response.js +12 -5
  756. package/dist/query/response.js.map +1 -1
  757. package/dist/react/AnalyticsProvider.d.ts +26 -17
  758. package/dist/react/AnalyticsProvider.js +23 -22
  759. package/dist/react/AnalyticsProvider.js.map +1 -1
  760. package/dist/react/TrackerBoot.js +15 -9
  761. package/dist/react/TrackerBoot.js.map +1 -1
  762. package/dist/react/useAnalytics.d.ts +2 -11
  763. package/dist/react/useAnalytics.js +22 -24
  764. package/dist/react/useAnalytics.js.map +1 -1
  765. package/dist/site/AnalyticsScripts.d.ts +34 -0
  766. package/dist/site/AnalyticsScripts.js +30 -0
  767. package/dist/site/AnalyticsScripts.js.map +1 -0
  768. package/dist/site/getTrackerConfig.d.ts +15 -0
  769. package/dist/site/getTrackerConfig.js +40 -0
  770. package/dist/site/getTrackerConfig.js.map +1 -0
  771. package/dist/surfacing/afterRead.d.ts +37 -0
  772. package/dist/surfacing/bounded.js +38 -0
  773. package/dist/surfacing/bounded.js.map +1 -0
  774. package/dist/surfacing/breaker.js +107 -0
  775. package/dist/surfacing/breaker.js.map +1 -0
  776. package/dist/surfacing/cacheCollection.d.ts +8 -0
  777. package/dist/surfacing/cacheCollection.js +69 -0
  778. package/dist/surfacing/cacheCollection.js.map +1 -0
  779. package/dist/surfacing/cacheStore.d.ts +71 -1
  780. package/dist/surfacing/cacheStore.js +16 -37
  781. package/dist/surfacing/cacheStore.js.map +1 -1
  782. package/dist/surfacing/cacheSweep.d.ts +1 -0
  783. package/dist/surfacing/cacheSweep.js +59 -0
  784. package/dist/surfacing/cacheSweep.js.map +1 -0
  785. package/dist/surfacing/classifyError.js +282 -0
  786. package/dist/surfacing/classifyError.js.map +1 -0
  787. package/dist/surfacing/coalesce.js +2 -1
  788. package/dist/surfacing/coalesce.js.map +1 -1
  789. package/dist/surfacing/coldBudget.js +60 -0
  790. package/dist/surfacing/coldBudget.js.map +1 -0
  791. package/dist/surfacing/collectionCacheStore.js +183 -0
  792. package/dist/surfacing/collectionCacheStore.js.map +1 -0
  793. package/dist/surfacing/engine.d.ts +1 -1
  794. package/dist/surfacing/engine.js +514 -72
  795. package/dist/surfacing/engine.js.map +1 -1
  796. package/dist/surfacing/epoch.js +70 -26
  797. package/dist/surfacing/epoch.js.map +1 -1
  798. package/dist/surfacing/lanes.d.ts +1 -0
  799. package/dist/surfacing/lanes.js +297 -0
  800. package/dist/surfacing/lanes.js.map +1 -0
  801. package/dist/surfacing/memo.js +40 -0
  802. package/dist/surfacing/memo.js.map +1 -0
  803. package/dist/surfacing/rateLimiter.d.ts +1 -0
  804. package/dist/surfacing/rateLimiter.js +69 -94
  805. package/dist/surfacing/rateLimiter.js.map +1 -1
  806. package/dist/surfacing/rebucket.js +178 -0
  807. package/dist/surfacing/rebucket.js.map +1 -0
  808. package/dist/surfacing/recipe.js +28 -0
  809. package/dist/surfacing/recipe.js.map +1 -0
  810. package/dist/surfacing/shape.js +22 -0
  811. package/dist/surfacing/shape.js.map +1 -0
  812. package/dist/surfacing/todaySplit.js +113 -0
  813. package/dist/surfacing/todaySplit.js.map +1 -0
  814. package/dist/sync/collection.d.ts +8 -0
  815. package/dist/sync/collection.js +28 -18
  816. package/dist/sync/collection.js.map +1 -1
  817. package/dist/sync/rekeyDurations.js +70 -0
  818. package/dist/sync/rekeyDurations.js.map +1 -0
  819. package/dist/sync/syncTask.js +226 -109
  820. package/dist/sync/syncTask.js.map +1 -1
  821. package/dist/testing/memoryAdapter.d.ts +6 -3
  822. package/dist/testing/memoryAdapter.js +12 -10
  823. package/dist/testing/memoryAdapter.js.map +1 -1
  824. package/dist/testing/settle.d.ts +11 -0
  825. package/dist/testing/settle.js +19 -0
  826. package/dist/testing/settle.js.map +1 -0
  827. package/dist/timeframe/calendar.js +65 -0
  828. package/dist/timeframe/calendar.js.map +1 -0
  829. package/dist/timeframe/comparison.js +46 -0
  830. package/dist/timeframe/comparison.js.map +1 -0
  831. package/dist/timeframe/presets.d.ts +1 -1
  832. package/dist/timeframe/presets.js +5 -5
  833. package/dist/timeframe/presets.js.map +1 -1
  834. package/dist/timeframe/reportingTimezone.d.ts +1 -0
  835. package/dist/timeframe/reportingTimezone.js +64 -0
  836. package/dist/timeframe/reportingTimezone.js.map +1 -0
  837. package/dist/timeframe/tz.js +55 -39
  838. package/dist/timeframe/tz.js.map +1 -1
  839. package/dist/tracker/autoCapture.js +125 -38
  840. package/dist/tracker/autoCapture.js.map +1 -1
  841. package/dist/tracker/campaign.js +52 -0
  842. package/dist/tracker/campaign.js.map +1 -0
  843. package/dist/tracker/config.d.ts +149 -0
  844. package/dist/tracker/config.js +25 -0
  845. package/dist/tracker/config.js.map +1 -0
  846. package/dist/tracker/createTracker.d.ts +4 -10
  847. package/dist/tracker/createTracker.js +386 -115
  848. package/dist/tracker/createTracker.js.map +1 -1
  849. package/dist/tracker/digest.js +28 -0
  850. package/dist/tracker/digest.js.map +1 -0
  851. package/dist/tracker/engagement.js +100 -0
  852. package/dist/tracker/engagement.js.map +1 -0
  853. package/dist/tracker/events.js +37 -0
  854. package/dist/tracker/events.js.map +1 -0
  855. package/dist/tracker/exclusion.d.ts +2 -22
  856. package/dist/tracker/exclusion.js +53 -21
  857. package/dist/tracker/exclusion.js.map +1 -1
  858. package/dist/tracker/gate.js +194 -0
  859. package/dist/tracker/gate.js.map +1 -0
  860. package/dist/tracker/initTracker.d.ts +5 -8
  861. package/dist/tracker/initTracker.js +42 -14
  862. package/dist/tracker/initTracker.js.map +1 -1
  863. package/dist/tracker/itemCapture.js +224 -0
  864. package/dist/tracker/itemCapture.js.map +1 -0
  865. package/dist/tracker/loadScript.js +21 -14
  866. package/dist/tracker/loadScript.js.map +1 -1
  867. package/dist/tracker/pageTracking.js +6 -6
  868. package/dist/tracker/pageTracking.js.map +1 -1
  869. package/dist/tracker/registry.js +118 -30
  870. package/dist/tracker/registry.js.map +1 -1
  871. package/dist/tracker/sinks/createSink.js +41 -0
  872. package/dist/tracker/sinks/createSink.js.map +1 -0
  873. package/dist/tracker/sinks/ga4.js +64 -20
  874. package/dist/tracker/sinks/ga4.js.map +1 -1
  875. package/dist/tracker/sinks/native.js +7 -42
  876. package/dist/tracker/sinks/native.js.map +1 -1
  877. package/dist/tracker/sinks/plausible.js +27 -22
  878. package/dist/tracker/sinks/plausible.js.map +1 -1
  879. package/dist/tracker/sinks/posthog.js +54 -22
  880. package/dist/tracker/sinks/posthog.js.map +1 -1
  881. package/dist/tracker/sinks/umami.js +14 -12
  882. package/dist/tracker/sinks/umami.js.map +1 -1
  883. package/dist/tracker/sinks/vendor.js +30 -27
  884. package/dist/tracker/sinks/vendor.js.map +1 -1
  885. package/dist/tracker/skip.js +81 -0
  886. package/dist/tracker/skip.js.map +1 -0
  887. package/dist/tracker/storage.js +23 -0
  888. package/dist/tracker/storage.js.map +1 -0
  889. package/dist/tracker/transport.js +2 -5
  890. package/dist/tracker/transport.js.map +1 -1
  891. package/dist/tracker/types.d.ts +86 -63
  892. package/dist/tracker/window.js +7 -0
  893. package/dist/tracker/window.js.map +1 -0
  894. package/dist/translations/ar.js +232 -71
  895. package/dist/translations/ar.js.map +1 -1
  896. package/dist/translations/de.js +221 -69
  897. package/dist/translations/de.js.map +1 -1
  898. package/dist/translations/en.js +215 -67
  899. package/dist/translations/en.js.map +1 -1
  900. package/dist/translations/es.js +223 -68
  901. package/dist/translations/es.js.map +1 -1
  902. package/dist/translations/fr.js +227 -72
  903. package/dist/translations/fr.js.map +1 -1
  904. package/dist/translations/id.js +218 -67
  905. package/dist/translations/id.js.map +1 -1
  906. package/dist/translations/index.d.ts +1 -1
  907. package/dist/translations/index.js +5 -7
  908. package/dist/translations/index.js.map +1 -1
  909. package/dist/translations/intl.js +71 -0
  910. package/dist/translations/intl.js.map +1 -0
  911. package/dist/translations/keys.d.ts +191 -14
  912. package/dist/translations/keys.js +196 -14
  913. package/dist/translations/keys.js.map +1 -1
  914. package/dist/translations/ko.js +220 -69
  915. package/dist/translations/ko.js.map +1 -1
  916. package/dist/translations/labelMap.d.ts +10 -0
  917. package/dist/translations/labelMap.js +22 -0
  918. package/dist/translations/labelMap.js.map +1 -0
  919. package/dist/translations/metricKeys.js +10 -2
  920. package/dist/translations/metricKeys.js.map +1 -1
  921. package/dist/translations/parts.js +20 -0
  922. package/dist/translations/parts.js.map +1 -0
  923. package/dist/translations/plural.js +61 -0
  924. package/dist/translations/plural.js.map +1 -0
  925. package/dist/translations/pt.js +232 -77
  926. package/dist/translations/pt.js.map +1 -1
  927. package/dist/translations/ru.js +223 -66
  928. package/dist/translations/ru.js.map +1 -1
  929. package/dist/translations/server.d.ts +1 -0
  930. package/dist/translations/server.js +2 -3
  931. package/dist/translations/server.js.map +1 -1
  932. package/dist/translations/staticLabel.js +69 -0
  933. package/dist/translations/staticLabel.js.map +1 -0
  934. package/dist/translations/uk.js +223 -66
  935. package/dist/translations/uk.js.map +1 -1
  936. package/dist/translations/zh.js +218 -67
  937. package/dist/translations/zh.js.map +1 -1
  938. package/dist/ui/RangePicker.js +112 -0
  939. package/dist/ui/RangePicker.js.map +1 -0
  940. package/dist/ui/analytics.css +1533 -0
  941. package/dist/ui/calendarDays.js +27 -0
  942. package/dist/ui/calendarDays.js.map +1 -0
  943. package/dist/ui/classNames.js +7 -0
  944. package/dist/ui/classNames.js.map +1 -0
  945. package/dist/ui/components/Card.d.ts +28 -0
  946. package/dist/ui/components/Card.js +21 -0
  947. package/dist/ui/components/Card.js.map +1 -0
  948. package/dist/ui/components/ChartDataTable.d.ts +41 -0
  949. package/dist/ui/components/ChartDataTable.js +48 -0
  950. package/dist/ui/components/ChartDataTable.js.map +1 -0
  951. package/dist/ui/components/DataTable.d.ts +82 -0
  952. package/dist/ui/components/DataTable.js +214 -0
  953. package/dist/ui/components/DataTable.js.map +1 -0
  954. package/dist/ui/components/LabeledSelect.js +62 -0
  955. package/dist/ui/components/LabeledSelect.js.map +1 -0
  956. package/dist/ui/components/LiveAnnouncement.js +21 -0
  957. package/dist/ui/components/LiveAnnouncement.js.map +1 -0
  958. package/dist/ui/components/MetricCard.d.ts +38 -0
  959. package/dist/ui/components/MetricCard.js +39 -0
  960. package/dist/ui/components/MetricCard.js.map +1 -0
  961. package/dist/ui/components/NoValue.js +22 -0
  962. package/dist/ui/components/NoValue.js.map +1 -0
  963. package/dist/ui/components/ReadState.js +27 -0
  964. package/dist/ui/components/ReadState.js.map +1 -0
  965. package/dist/ui/components/RefreshButton.js +26 -0
  966. package/dist/ui/components/RefreshButton.js.map +1 -0
  967. package/dist/ui/components/SourcesNoticeBanner.js +20 -0
  968. package/dist/ui/components/SourcesNoticeBanner.js.map +1 -0
  969. package/dist/ui/cssVars.js +7 -0
  970. package/dist/ui/cssVars.js.map +1 -0
  971. package/dist/ui/data/WithScopeToken.d.ts +20 -0
  972. package/dist/ui/data/WithScopeToken.js +20 -0
  973. package/dist/ui/data/WithScopeToken.js.map +1 -0
  974. package/dist/ui/data/clientFieldProps.js +16 -0
  975. package/dist/ui/data/clientFieldProps.js.map +1 -0
  976. package/dist/ui/data/request.d.ts +46 -0
  977. package/dist/ui/data/request.js +119 -0
  978. package/dist/ui/data/request.js.map +1 -0
  979. package/dist/ui/data/scopeTokenContext.js +18 -0
  980. package/dist/ui/data/scopeTokenContext.js.map +1 -0
  981. package/dist/ui/data/sharedCache.js +48 -0
  982. package/dist/ui/data/sharedCache.js.map +1 -0
  983. package/dist/ui/data/useRequest.d.ts +19 -0
  984. package/dist/ui/data/useRequest.js +123 -0
  985. package/dist/ui/data/useRequest.js.map +1 -0
  986. package/dist/ui/data/useRequestScope.js +25 -0
  987. package/dist/ui/data/useRequestScope.js.map +1 -0
  988. package/dist/ui/hooks/useDirection.js +47 -0
  989. package/dist/ui/hooks/useDirection.js.map +1 -0
  990. package/dist/ui/hooks/useDismissOnEscape.js +25 -0
  991. package/dist/ui/hooks/useDismissOnEscape.js.map +1 -0
  992. package/dist/ui/hooks/useLiveAnnouncement.js +57 -0
  993. package/dist/ui/hooks/useLiveAnnouncement.js.map +1 -0
  994. package/dist/ui/hooks/useRealtimePoll.js +112 -0
  995. package/dist/ui/hooks/useRealtimePoll.js.map +1 -0
  996. package/dist/ui/readState.js +19 -0
  997. package/dist/ui/readState.js.map +1 -0
  998. package/dist/ui/rows/toDisplayRows.js +49 -0
  999. package/dist/ui/rows/toDisplayRows.js.map +1 -0
  1000. package/dist/ui/viewerClock.js +7 -0
  1001. package/dist/ui/viewerClock.js.map +1 -0
  1002. package/dist/view/AnalyticsNavLink.d.ts +5 -3
  1003. package/dist/view/AnalyticsNavLink.js +11 -6
  1004. package/dist/view/AnalyticsNavLink.js.map +1 -1
  1005. package/dist/view/AnalyticsView.d.ts +8 -10
  1006. package/dist/view/AnalyticsView.js +47 -18
  1007. package/dist/view/AnalyticsView.js.map +1 -1
  1008. package/dist/view/AnalyticsViewClient.d.ts +4 -7
  1009. package/dist/view/AnalyticsViewClient.js +15 -229
  1010. package/dist/view/AnalyticsViewClient.js.map +1 -1
  1011. package/dist/view/CountryFlag.d.ts +27 -0
  1012. package/dist/view/CountryFlag.js +44 -0
  1013. package/dist/view/CountryFlag.js.map +1 -0
  1014. package/dist/view/DocumentTitle.js +27 -0
  1015. package/dist/view/DocumentTitle.js.map +1 -0
  1016. package/dist/view/ViewRoot.d.ts +21 -0
  1017. package/dist/view/ViewRoot.js +152 -0
  1018. package/dist/view/ViewRoot.js.map +1 -0
  1019. package/dist/view/ViewSections.d.ts +38 -0
  1020. package/dist/view/ViewSections.js +190 -0
  1021. package/dist/view/ViewSections.js.map +1 -0
  1022. package/dist/view/authRedirect.js +2 -4
  1023. package/dist/view/authRedirect.js.map +1 -1
  1024. package/dist/view/conversionRate.js +9 -7
  1025. package/dist/view/conversionRate.js.map +1 -1
  1026. package/dist/view/dayRange.js +6 -10
  1027. package/dist/view/dayRange.js.map +1 -1
  1028. package/dist/view/exclusionLink.d.ts +27 -0
  1029. package/dist/view/exclusionLink.js +46 -0
  1030. package/dist/view/exclusionLink.js.map +1 -0
  1031. package/dist/view/flagSrc.js +14 -0
  1032. package/dist/view/flagSrc.js.map +1 -0
  1033. package/dist/view/gating.d.ts +15 -1
  1034. package/dist/view/gating.js +66 -31
  1035. package/dist/view/gating.js.map +1 -1
  1036. package/dist/view/hostCountryFlag.js +41 -0
  1037. package/dist/view/hostCountryFlag.js.map +1 -0
  1038. package/dist/view/labels.js +95 -10
  1039. package/dist/view/labels.js.map +1 -1
  1040. package/dist/view/metricAliases.js +10 -0
  1041. package/dist/view/metricAliases.js.map +1 -0
  1042. package/dist/view/navLabel.js +15 -0
  1043. package/dist/view/navLabel.js.map +1 -0
  1044. package/dist/view/registerView.js +13 -11
  1045. package/dist/view/registerView.js.map +1 -1
  1046. package/dist/view/scopeLabel.js +21 -0
  1047. package/dist/view/scopeLabel.js.map +1 -0
  1048. package/dist/view/sections/Breakdowns.js +196 -134
  1049. package/dist/view/sections/Breakdowns.js.map +1 -1
  1050. package/dist/view/sections/EmptyStates.js +118 -30
  1051. package/dist/view/sections/EmptyStates.js.map +1 -1
  1052. package/dist/view/sections/ExcludeBrowser.js +188 -0
  1053. package/dist/view/sections/ExcludeBrowser.js.map +1 -0
  1054. package/dist/view/sections/FilterChips.js +124 -27
  1055. package/dist/view/sections/FilterChips.js.map +1 -1
  1056. package/dist/view/sections/GoalsPanel.js +68 -60
  1057. package/dist/view/sections/GoalsPanel.js.map +1 -1
  1058. package/dist/view/sections/OverviewCards.js +29 -33
  1059. package/dist/view/sections/OverviewCards.js.map +1 -1
  1060. package/dist/view/sections/RealtimeStrip.js +70 -59
  1061. package/dist/view/sections/RealtimeStrip.js.map +1 -1
  1062. package/dist/view/sections/SectionBoundary.js +34 -0
  1063. package/dist/view/sections/SectionBoundary.js.map +1 -0
  1064. package/dist/view/sections/Toolbar.d.ts +11 -0
  1065. package/dist/view/sections/Toolbar.js +123 -82
  1066. package/dist/view/sections/Toolbar.js.map +1 -1
  1067. package/dist/view/sections/Trend.js +176 -76
  1068. package/dist/view/sections/Trend.js.map +1 -1
  1069. package/dist/view/state.d.ts +42 -0
  1070. package/dist/view/state.js +93 -54
  1071. package/dist/view/state.js.map +1 -1
  1072. package/dist/view/useViewClock.js +31 -0
  1073. package/dist/view/useViewClock.js.map +1 -0
  1074. package/dist/view/useViewQueries.d.ts +21 -0
  1075. package/dist/view/useViewQueries.js +45 -77
  1076. package/dist/view/useViewQueries.js.map +1 -1
  1077. package/dist/view/useViewState.js +42 -0
  1078. package/dist/view/useViewState.js.map +1 -0
  1079. package/dist/view/useViewUrl.js +47 -0
  1080. package/dist/view/useViewUrl.js.map +1 -0
  1081. package/dist/view/viewBody.js +30 -0
  1082. package/dist/view/viewBody.js.map +1 -0
  1083. package/dist/view/viewContext.d.ts +81 -0
  1084. package/dist/view/viewContext.js +49 -0
  1085. package/dist/view/viewContext.js.map +1 -0
  1086. package/dist/view/viewProps.d.ts +65 -8
  1087. package/dist/view/viewProps.js +123 -36
  1088. package/dist/view/viewProps.js.map +1 -1
  1089. package/dist/widgets/AnalyticsBreakdownWidget.d.ts +7 -3
  1090. package/dist/widgets/AnalyticsBreakdownWidget.js +144 -118
  1091. package/dist/widgets/AnalyticsBreakdownWidget.js.map +1 -1
  1092. package/dist/widgets/AnalyticsGoalsWidget.d.ts +6 -7
  1093. package/dist/widgets/AnalyticsGoalsWidget.js +125 -167
  1094. package/dist/widgets/AnalyticsGoalsWidget.js.map +1 -1
  1095. package/dist/widgets/AnalyticsMetricWidget.d.ts +7 -3
  1096. package/dist/widgets/AnalyticsMetricWidget.js +81 -106
  1097. package/dist/widgets/AnalyticsMetricWidget.js.map +1 -1
  1098. package/dist/widgets/AnalyticsRealtimeWidget.d.ts +7 -3
  1099. package/dist/widgets/AnalyticsRealtimeWidget.js +81 -63
  1100. package/dist/widgets/AnalyticsRealtimeWidget.js.map +1 -1
  1101. package/dist/widgets/AnalyticsTrendWidget.d.ts +7 -3
  1102. package/dist/widgets/AnalyticsTrendWidget.js +130 -123
  1103. package/dist/widgets/AnalyticsTrendWidget.js.map +1 -1
  1104. package/dist/widgets/ComparisonDelta.js +33 -42
  1105. package/dist/widgets/ComparisonDelta.js.map +1 -1
  1106. package/dist/widgets/RealtimeCounter.d.ts +24 -4
  1107. package/dist/widgets/RealtimeCounter.js +91 -77
  1108. package/dist/widgets/RealtimeCounter.js.map +1 -1
  1109. package/dist/widgets/WidgetCard.d.ts +80 -0
  1110. package/dist/widgets/WidgetCard.js +99 -0
  1111. package/dist/widgets/WidgetCard.js.map +1 -0
  1112. package/dist/widgets/WidgetFrame.js +42 -0
  1113. package/dist/widgets/WidgetFrame.js.map +1 -0
  1114. package/dist/widgets/WidgetShimmer.d.ts +55 -0
  1115. package/dist/widgets/WidgetShimmer.js +86 -0
  1116. package/dist/widgets/WidgetShimmer.js.map +1 -0
  1117. package/dist/widgets/breakdownTypes.js +12 -2
  1118. package/dist/widgets/breakdownTypes.js.map +1 -1
  1119. package/dist/widgets/customWidget.d.ts +5 -1
  1120. package/dist/widgets/customWidget.js +6 -7
  1121. package/dist/widgets/customWidget.js.map +1 -1
  1122. package/dist/widgets/defaultLayout.d.ts +26 -0
  1123. package/dist/widgets/defaultLayout.js +51 -0
  1124. package/dist/widgets/defaultLayout.js.map +1 -0
  1125. package/dist/widgets/defaults.d.ts +4 -7
  1126. package/dist/widgets/defaults.js +4 -7
  1127. package/dist/widgets/defaults.js.map +1 -1
  1128. package/dist/widgets/fieldRows.js +14 -0
  1129. package/dist/widgets/fieldRows.js.map +1 -0
  1130. package/dist/widgets/filterCaption.js +6 -7
  1131. package/dist/widgets/filterCaption.js.map +1 -1
  1132. package/dist/widgets/filterField.d.ts +3 -7
  1133. package/dist/widgets/filterField.js +46 -35
  1134. package/dist/widgets/filterField.js.map +1 -1
  1135. package/dist/widgets/filterValueLabel.d.ts +1 -0
  1136. package/dist/widgets/filterValueLabel.js +45 -0
  1137. package/dist/widgets/filterValueLabel.js.map +1 -0
  1138. package/dist/widgets/notices.js +74 -0
  1139. package/dist/widgets/notices.js.map +1 -0
  1140. package/dist/widgets/prepareWidgetRead.d.ts +19 -2
  1141. package/dist/widgets/prepareWidgetRead.js +63 -27
  1142. package/dist/widgets/prepareWidgetRead.js.map +1 -1
  1143. package/dist/widgets/range.js +26 -21
  1144. package/dist/widgets/range.js.map +1 -1
  1145. package/dist/widgets/readForWidget.d.ts +28 -19
  1146. package/dist/widgets/readForWidget.js +33 -29
  1147. package/dist/widgets/readForWidget.js.map +1 -1
  1148. package/dist/widgets/readForWidgetBreakdown.d.ts +40 -29
  1149. package/dist/widgets/readForWidgetBreakdown.js +48 -22
  1150. package/dist/widgets/readForWidgetBreakdown.js.map +1 -1
  1151. package/dist/widgets/readForWidgetGoals.d.ts +18 -24
  1152. package/dist/widgets/readForWidgetGoals.js +52 -46
  1153. package/dist/widgets/readForWidgetGoals.js.map +1 -1
  1154. package/dist/widgets/readForWidgetRealtime.d.ts +22 -17
  1155. package/dist/widgets/readForWidgetRealtime.js +54 -28
  1156. package/dist/widgets/readForWidgetRealtime.js.map +1 -1
  1157. package/dist/widgets/readForWidgetSeries.d.ts +27 -32
  1158. package/dist/widgets/readForWidgetSeries.js +45 -82
  1159. package/dist/widgets/readForWidgetSeries.js.map +1 -1
  1160. package/dist/widgets/readMeta.d.ts +44 -0
  1161. package/dist/widgets/readMeta.js +47 -4
  1162. package/dist/widgets/readMeta.js.map +1 -1
  1163. package/dist/widgets/realtimePoll.d.ts +1 -0
  1164. package/dist/widgets/realtimePoll.js +53 -25
  1165. package/dist/widgets/realtimePoll.js.map +1 -1
  1166. package/dist/widgets/registerWidgets.js +207 -127
  1167. package/dist/widgets/registerWidgets.js.map +1 -1
  1168. package/dist/widgets/stateKeys.js +30 -0
  1169. package/dist/widgets/stateKeys.js.map +1 -0
  1170. package/dist/widgets/titleForecast.js +89 -0
  1171. package/dist/widgets/titleForecast.js.map +1 -0
  1172. package/dist/widgets/types.d.ts +4 -3
  1173. package/dist/widgets/types.js +2 -0
  1174. package/dist/widgets/types.js.map +1 -1
  1175. package/dist/widgets/viewLink.d.ts +24 -6
  1176. package/dist/widgets/viewLink.js +31 -24
  1177. package/dist/widgets/viewLink.js.map +1 -1
  1178. package/dist/widgets/widgetData.js +34 -0
  1179. package/dist/widgets/widgetData.js.map +1 -0
  1180. package/dist/widgets/widgetWindow.d.ts +1 -0
  1181. package/dist/widgets/widgetWindow.js +51 -0
  1182. package/dist/widgets/widgetWindow.js.map +1 -0
  1183. package/package.json +44 -22
  1184. package/dist/adapters/ga4/disableKey.d.ts +0 -9
  1185. package/dist/capture/getTrackerConfig.d.ts +0 -20
  1186. package/dist/capture/getTrackerConfig.js +0 -31
  1187. package/dist/capture/getTrackerConfig.js.map +0 -1
  1188. package/dist/capture/slots.d.ts +0 -8
  1189. package/dist/capture/trackerConfig.d.ts +0 -33
  1190. package/dist/charts/styles.js +0 -59
  1191. package/dist/charts/styles.js.map +0 -1
  1192. package/dist/fields/config/SourceSelectField.d.ts +0 -14
  1193. package/dist/fields/dateRange/styles.js +0 -23
  1194. package/dist/fields/dateRange/styles.js.map +0 -1
  1195. package/dist/goals/GoalSelectField.d.ts +0 -7
  1196. package/dist/native/collections/events.js +0 -165
  1197. package/dist/native/collections/events.js.map +0 -1
  1198. package/dist/native/collections/rollups.js +0 -151
  1199. package/dist/native/collections/rollups.js.map +0 -1
  1200. package/dist/native/collections/seen.js +0 -47
  1201. package/dist/native/collections/seen.js.map +0 -1
  1202. package/dist/native/eventScan.js +0 -25
  1203. package/dist/native/eventScan.js.map +0 -1
  1204. package/dist/native/ingest/flushBatch.js +0 -60
  1205. package/dist/native/ingest/flushBatch.js.map +0 -1
  1206. package/dist/native/ingest/salt.js +0 -39
  1207. package/dist/native/ingest/salt.js.map +0 -1
  1208. package/dist/native/ingest/writeBuffer.js +0 -55
  1209. package/dist/native/ingest/writeBuffer.js.map +0 -1
  1210. package/dist/native/ingest/writeEvent.js +0 -14
  1211. package/dist/native/ingest/writeEvent.js.map +0 -1
  1212. package/dist/native/query/eventAgg.js +0 -175
  1213. package/dist/native/query/eventAgg.js.map +0 -1
  1214. package/dist/native/realtime/buildRealtime.js +0 -53
  1215. package/dist/native/realtime/buildRealtime.js.map +0 -1
  1216. package/dist/native/retention/pruneTask.js +0 -69
  1217. package/dist/native/retention/pruneTask.js.map +0 -1
  1218. package/dist/native/rollupAcc.js +0 -64
  1219. package/dist/native/rollupAcc.js.map +0 -1
  1220. package/dist/native/rollups/bucketKey.js +0 -15
  1221. package/dist/native/rollups/bucketKey.js.map +0 -1
  1222. package/dist/native/rollups/bumpRollups.js +0 -116
  1223. package/dist/native/rollups/bumpRollups.js.map +0 -1
  1224. package/dist/native/rollups/deltas.js +0 -106
  1225. package/dist/native/rollups/deltas.js.map +0 -1
  1226. package/dist/native/rollups/insertManyIfNew.js +0 -93
  1227. package/dist/native/rollups/insertManyIfNew.js.map +0 -1
  1228. package/dist/plugin/paths.js +0 -29
  1229. package/dist/plugin/paths.js.map +0 -1
  1230. package/dist/react/TrackerBoot.d.ts +0 -22
  1231. package/dist/rsc/AnalyticsScripts.d.ts +0 -30
  1232. package/dist/rsc/AnalyticsScripts.js +0 -41
  1233. package/dist/rsc/AnalyticsScripts.js.map +0 -1
  1234. package/dist/surfacing/queue.js +0 -60
  1235. package/dist/surfacing/queue.js.map +0 -1
  1236. package/dist/surfacing/retryPolicy.js +0 -15
  1237. package/dist/surfacing/retryPolicy.js.map +0 -1
  1238. package/dist/tracker/autoCapture.d.ts +0 -48
  1239. package/dist/tracker/consent.d.ts +0 -24
  1240. package/dist/tracker/consent.js +0 -48
  1241. package/dist/tracker/consent.js.map +0 -1
  1242. package/dist/tracker/loadScript.d.ts +0 -14
  1243. package/dist/tracker/pageTracking.d.ts +0 -17
  1244. package/dist/tracker/registry.d.ts +0 -27
  1245. package/dist/tracker/sinks/ga4.d.ts +0 -29
  1246. package/dist/tracker/sinks/native.d.ts +0 -22
  1247. package/dist/tracker/sinks/plausible.d.ts +0 -20
  1248. package/dist/tracker/sinks/posthog.d.ts +0 -18
  1249. package/dist/tracker/sinks/umami.d.ts +0 -18
  1250. package/dist/tracker/sinks/vendor.d.ts +0 -14
  1251. package/dist/view/sections/styles.js +0 -76
  1252. package/dist/view/sections/styles.js.map +0 -1
  1253. package/dist/widgets/WidgetViewLink.js +0 -17
  1254. package/dist/widgets/WidgetViewLink.js.map +0 -1
  1255. package/dist/widgets/cardChrome.d.ts +0 -8
  1256. package/dist/widgets/cardChrome.js +0 -46
  1257. package/dist/widgets/cardChrome.js.map +0 -1
  1258. package/dist/widgets/comparison.js +0 -57
  1259. package/dist/widgets/comparison.js.map +0 -1
@@ -1,44 +1,101 @@
1
+ import { isRecord } from "../../core/values.js";
1
2
  import { clientIpFromHeaders } from "./clientIp.js";
3
+ import { DEFAULT_BROWSER_AMOUNTS, completionAmounts } from "../../goals/match.js";
4
+ import { MAX_SINCE_MS } from "../../goals/constants.js";
5
+ import { boundedValue, dedupeKeyFor, isRefund, reconcileMoney, sanitizeOrderId } from "./revenue.js";
6
+ import { extractUtm } from "./utm.js";
7
+ import { clickIdOf } from "./source.js";
8
+ import { isSiteReferral, referrerHost, storedReferrer } from "./referrer.js";
2
9
  import { classifyDevice } from "./device.js";
3
- import { matchGoals } from "../../goals/match.js";
10
+ import { sanitizeItems } from "../../goals/items.js";
11
+ import { boundItemRef } from "../../items/ref.js";
12
+ import { resolveGeo } from "../geo/resolveGeo.js";
4
13
  import { classifyBrowser, classifyOs } from "./browser.js";
14
+ import { verifiedItemRef } from "./itemSignature.js";
5
15
  import { primaryLanguage } from "./language.js";
6
- import { referrerHost, storedReferrer } from "./referrer.js";
7
- import { extractUtm } from "./utm.js";
8
- import { classifyChannel, deriveSource } from "./source.js";
9
- import { dailyVisitorHash, deriveSessionId } from "./visitorHash.js";
16
+ import { boundedSinceMs, isNavigation } from "./validate.js";
17
+ import { dailyVisitorId } from "./visitorHash.js";
10
18
  //#region src/native/ingest/normalizeEvent.ts
11
19
  const MAX_PROPS = 20;
12
20
  const MAX_KEY_LENGTH = 64;
13
21
  const MAX_VALUE_LENGTH = 256;
14
22
  const MAX_NAME_LENGTH = 128;
15
23
  const MAX_PATH_LENGTH = 512;
16
- /** 24 hours. A longer duration is a broken clock, not a session. */
17
- const MAX_DURATION_MS = 864e5;
18
24
  const CURRENCY = /^[A-Z]{3}$/;
19
25
  /**
20
- * Optional wire fields are sanitized rather than rejected: a bad `value`, `currency`,
21
- * `scrollDepth`, `durationMs`, or prop is dropped and the event is still ingested, so one malformed
22
- * attribute never costs a pageview. Only the required fields (checked in the endpoint)
23
- * can fail an event.
26
+ * When an event happened: its arrival less its `ageMs`, and an engagement's `sinceMs` too, so it is
27
+ * filed at its pageview's start. Each is believed from 0 to a day, and together reach back a day.
28
+ */
29
+ const eventTime = (raw, receivedAt) => {
30
+ const waited = boundedSinceMs(raw.ageMs) ?? 0;
31
+ const since = raw.type === "engagement" ? boundedSinceMs(raw.sinceMs) ?? 0 : 0;
32
+ const back = Math.min(MAX_SINCE_MS, waited + since);
33
+ return back === 0 ? receivedAt : new Date(receivedAt.getTime() - back);
34
+ };
35
+ /**
36
+ * Whether an event comes with a visitor of its own: an address, or a user agent other than the
37
+ * one server tracking stamps when it has none. A beacon always does; server code may not.
24
38
  */
25
- const nonNegative = (value) => typeof value === "number" && Number.isFinite(value) && value >= 0 ? value : void 0;
39
+ const identifiesVisitor = (ip, ua) => ip !== "" || ua !== "" && ua !== "analytics-server";
40
+ /**
41
+ * Optional wire fields are sanitized rather than rejected, so one malformed attribute never costs
42
+ * a pageview.
43
+ */
44
+ const nonNegative = (value) => {
45
+ const bounded = boundedValue(value);
46
+ return bounded !== void 0 && bounded >= 0 ? bounded : void 0;
47
+ };
48
+ /** A refund is the one negative amount ingest keeps, and only on a server `refund` call. */
49
+ const signed = (value) => boundedValue(value);
26
50
  const currencyCode = (value) => typeof value === "string" && CURRENCY.test(value) ? value : void 0;
27
51
  /**
28
- * Infinity would poison a rollup bucket's average for good, and a string would throw out of
29
- * the write and take the whole buffered batch with it, so a duration outside the ceiling is
30
- * dropped like any other malformed attribute.
52
+ * The event's amount as far as it is believed: as sent under `trust` and `fixed` (where a goal's
53
+ * fixed value still wins for its own completion), nothing under `none`.
54
+ */
55
+ const sentAmount = (args) => args.believed === "none" ? {} : {
56
+ ...args.value === void 0 ? {} : { value: args.value },
57
+ ...args.currency === void 0 ? {} : { currency: args.currency }
58
+ };
59
+ /**
60
+ * Each completion reconciled on its own (a fixed value in its goal's currency, else the event's),
61
+ * one conversion per distinct amount however many goals share it.
62
+ */
63
+ const countCompletions = async (amounts, args) => {
64
+ const counted = [];
65
+ for (const { goal, source, amount } of amounts) {
66
+ if (source === "none") {
67
+ counted.push({ completion: {
68
+ slug: goal.slug,
69
+ value: 0
70
+ } });
71
+ continue;
72
+ }
73
+ const currency = source === "fixed" ? currencyCode(goal.currency) : args.eventCurrency;
74
+ const money = await args.reconcile(amount, currency);
75
+ counted.push({
76
+ completion: {
77
+ slug: goal.slug,
78
+ value: money.value ?? 0,
79
+ ...money.originalValue === void 0 ? {} : { sent: money.originalValue }
80
+ },
81
+ money
82
+ });
83
+ }
84
+ return counted;
85
+ };
86
+ /**
87
+ * Infinity would poison every average for good, and a string would throw out of the write and take
88
+ * the buffered batch with it.
31
89
  */
32
90
  const duration = (value) => {
33
91
  const n = nonNegative(value);
34
- return n === void 0 || n > MAX_DURATION_MS ? void 0 : n;
92
+ return n === void 0 || n > 18e5 ? void 0 : n;
35
93
  };
36
- /** The event name is a rollup bucket key (the `event` dimension), so it is length-capped. */
94
+ /** The event name is a value the `event` dimension groups by, so it is length-capped. */
37
95
  const eventName = (value) => typeof value === "string" ? value.slice(0, MAX_NAME_LENGTH) : void 0;
38
96
  /**
39
- * A geo value as stored. The resolver reads request headers a client can set, and each value
40
- * becomes a rollup dimvalue and part of a seen-ledger key, so it is capped here rather than
41
- * trusted. An empty value stays absent: '' would be a bucket of its own.
97
+ * Capped, not trusted: the resolver reads headers a client can set. An empty value stays absent,
98
+ * since '' would be a value of its own.
42
99
  */
43
100
  const geoValue = (value) => value ? value.slice(0, 128) : void 0;
44
101
  /** Capped before it is parsed, so a hostile query cannot make ingest do unbounded work. */
@@ -47,13 +104,16 @@ const depth = (value) => {
47
104
  const n = nonNegative(value);
48
105
  return n === void 0 ? void 0 : Math.round(Math.min(n, 100));
49
106
  };
50
- /** Flat JSON scalars only: the first 20 short-keyed string/number/boolean entries. */
51
- const sanitizeProps = (raw) => {
52
- if (typeof raw !== "object" || raw === null || Array.isArray(raw)) return;
107
+ /**
108
+ * Flat JSON scalars only, first 20 short-keyed entries. An order's event drops an `orderId` prop:
109
+ * an order is kept as its digest alone.
110
+ */
111
+ const sanitizeProps = (raw, order) => {
112
+ if (!isRecord(raw) || Array.isArray(raw)) return;
53
113
  const out = {};
54
114
  let kept = 0;
55
115
  for (const [key, value] of Object.entries(raw)) {
56
- if (kept >= MAX_PROPS || key.length > MAX_KEY_LENGTH) continue;
116
+ if (kept >= MAX_PROPS || key.length > MAX_KEY_LENGTH || order && key === "orderId") continue;
57
117
  if (typeof value === "string") out[key] = value.slice(0, MAX_VALUE_LENGTH);
58
118
  else if (typeof value === "boolean" || typeof value === "number" && Number.isFinite(value)) out[key] = value;
59
119
  else continue;
@@ -61,38 +121,133 @@ const sanitizeProps = (raw) => {
61
121
  }
62
122
  return kept > 0 ? out : void 0;
63
123
  };
64
- async function normalizeEvent({ raw, hostname: rawHostname, headers, geoResolver, salt, now, scope, timezone, goals, trustedProxyHops }) {
65
- const geo = await geoResolver(headers, { trustedProxyHops });
66
- const ip = clientIpFromHeaders(headers, { trustedProxyHops }) ?? "";
124
+ /**
125
+ * An engagement adds only time, scroll and items seen; time and scroll count from a pageview or an
126
+ * engagement alone, and only an event or a goal belongs to an item.
127
+ */
128
+ const fieldsOfType = (raw) => {
129
+ if (raw.type === "engagement") {
130
+ const { type, path, hostname, referrer, query, durationMs, scrollDepth, impressions } = raw;
131
+ return {
132
+ type,
133
+ path,
134
+ hostname,
135
+ referrer,
136
+ query,
137
+ durationMs,
138
+ scrollDepth,
139
+ impressions
140
+ };
141
+ }
142
+ if (raw.type === "pageview") {
143
+ const { item: _item, impressions: _impressions, ...pageview } = raw;
144
+ return pageview;
145
+ }
146
+ const { durationMs: _durationMs, scrollDepth: _scrollDepth, impressions: _impressions, ...hit } = raw;
147
+ return hit;
148
+ };
149
+ /**
150
+ * The ref an item value is kept under: signed by this server (or trusted, or unsigned where
151
+ * signatures are optional), of a bound collection, with an id that collection could hold.
152
+ */
153
+ const keptItemRef = (value, options, origin) => {
154
+ const ref = verifiedItemRef(value, options.signature, origin === "server");
155
+ return ref === void 0 ? void 0 : boundItemRef(ref, options.collections, options.idTypes);
156
+ };
157
+ /**
158
+ * The refs of the items an engagement saw, each kept, once each, and no more than one beacon
159
+ * carries. Anything else in the list is dropped rather than failing the engagement.
160
+ */
161
+ const seenItems = (value, options, origin) => {
162
+ if (!options || !Array.isArray(value)) return [];
163
+ const refs = /* @__PURE__ */ new Set();
164
+ for (const entry of value) {
165
+ if (refs.size >= 50) break;
166
+ const ref = keptItemRef(entry, options, origin);
167
+ if (ref !== void 0) refs.add(ref);
168
+ }
169
+ return [...refs];
170
+ };
171
+ /** One event sanitized, attributed and goal-matched, alike for a beacon and for server code. */
172
+ async function normalizeEvent({ raw: input, hostname: rawHostname, headers, geoResolver, warnGeo, salt, now, scope, goals, origin = "wire", browserAmounts = DEFAULT_BROWSER_AMOUNTS, reportingCurrency, convertCurrency, warnUnconverted, trustedProxyHops, trustedPlatform, items: itemOptions, siblings, orderKey }) {
173
+ const raw = fieldsOfType(input);
174
+ const item = itemOptions ? keptItemRef(raw.item, itemOptions, origin) : void 0;
175
+ const impressions = seenItems(raw.impressions, itemOptions, origin);
176
+ const trust = {
177
+ trustedProxyHops,
178
+ trustedPlatform
179
+ };
180
+ const geo = await resolveGeo(geoResolver, headers, {
181
+ trust,
182
+ warn: warnGeo
183
+ });
184
+ const ip = clientIpFromHeaders(headers, trust) ?? "";
67
185
  const ua = headers.get("user-agent") ?? "";
68
186
  const path = raw.path.slice(0, MAX_PATH_LENGTH);
69
187
  const hostname = rawHostname.slice(0, 253);
70
- const visitorHash = dailyVisitorHash({
71
- ip,
72
- ua,
73
- site: hostname,
74
- salt
188
+ const items = sanitizeItems(raw.items);
189
+ const sanitized = sanitizeProps(raw.props, raw.orderId !== void 0);
190
+ const props = items === void 0 ? sanitized : {
191
+ ...sanitized,
192
+ items
193
+ };
194
+ const name = eventName(raw.name);
195
+ const isRevenue = origin === "server" && raw.revenue === true;
196
+ const refund = isRefund(isRevenue, raw.value);
197
+ const believed = origin === "server" ? "trust" : browserAmounts;
198
+ const candidates = origin === "wire" ? goals?.filter((goal) => goal.browser !== false) : goals;
199
+ const matching = Boolean(candidates?.length) && raw.type !== "engagement";
200
+ const eventCurrency = currencyCode(raw.currency);
201
+ const sent = sentAmount({
202
+ value: isRevenue ? signed(raw.value) : nonNegative(raw.value),
203
+ currency: eventCurrency,
204
+ believed
75
205
  });
76
- const hourBucket = now.toISOString().slice(0, 13);
77
- const props = sanitizeProps(raw.props);
78
- const value = nonNegative(raw.value);
206
+ const reconciled = /* @__PURE__ */ new Map();
207
+ const reconcile = (value, currency) => {
208
+ const key = JSON.stringify([value ?? null, currency ?? null]);
209
+ const known = reconciled.get(key);
210
+ if (known) return known;
211
+ const money = reconcileMoney({
212
+ ...value === void 0 ? {} : { value },
213
+ ...currency === void 0 ? {} : { currency },
214
+ reportingCurrency,
215
+ convertCurrency,
216
+ at: now,
217
+ warn: warnUnconverted
218
+ });
219
+ reconciled.set(key, money);
220
+ return money;
221
+ };
222
+ const counted = matching && candidates ? await countCompletions(completionAmounts({
223
+ type: raw.type,
224
+ name,
225
+ path,
226
+ props,
227
+ value: sent.value
228
+ }, candidates, {
229
+ allowNegativeValue: isRevenue,
230
+ props: believed !== "none",
231
+ fixedFirst: believed !== "trust"
232
+ }), {
233
+ eventCurrency,
234
+ reconcile
235
+ }) : [];
236
+ const completions = counted.map((each) => each.completion);
237
+ const money = counted.find((each) => each.money !== void 0)?.money ?? await reconcile(sent.value, sent.currency);
238
+ const order = sanitizeOrderId(raw.orderId);
239
+ const refundId = refund ? sanitizeOrderId(raw.refundId) : void 0;
79
240
  const scrollDepth = depth(raw.scrollDepth);
80
241
  const durationMs = duration(raw.durationMs);
81
- const name = eventName(raw.name);
82
242
  const device = classifyDevice(ua);
83
243
  const browser = classifyBrowser(ua);
84
244
  const os = classifyOs(ua);
85
245
  const language = primaryLanguage(headers.get("accept-language"));
86
- const refHost = referrerHost(raw.referrer, hostname);
246
+ const refHost = referrerHost(raw.referrer, hostname, siblings);
247
+ const siteReferrer = !isSiteReferral(raw.referrer, hostname) && isSiteReferral(raw.referrer, hostname, siblings);
87
248
  const query = queryString(raw.query);
88
249
  const utm = extractUtm(query);
89
- const completions = goals?.length ? matchGoals({
90
- type: raw.type,
91
- name,
92
- path,
93
- props,
94
- value
95
- }, goals) : [];
250
+ const clickId = clickIdOf(query);
96
251
  return {
97
252
  timestamp: now,
98
253
  type: raw.type,
@@ -101,38 +256,48 @@ async function normalizeEvent({ raw, hostname: rawHostname, headers, geoResolver
101
256
  hostname,
102
257
  referrer: storedReferrer(raw.referrer),
103
258
  ...refHost ? { referrerHost: refHost } : {},
259
+ ...siteReferrer ? { siteReferrer: true } : {},
104
260
  ...device ? { device } : {},
105
261
  ...browser ? { browser } : {},
106
262
  ...os ? { os } : {},
107
- source: deriveSource({
108
- referrerHost: refHost,
109
- utmSource: utm.utmSource
110
- }),
111
- channel: classifyChannel({
112
- referrerHost: refHost,
113
- utmSource: utm.utmSource,
114
- utmMedium: utm.utmMedium,
115
- query
116
- }),
117
- channelVersion: 1,
118
263
  ...utm,
119
264
  country: geoValue(geo.country),
120
265
  region: geoValue(geo.region),
121
266
  city: geoValue(geo.city),
122
267
  ...language ? { language } : {},
123
- visitorHash,
124
- sessionId: deriveSessionId(visitorHash, hourBucket),
125
268
  props,
126
269
  ...durationMs !== void 0 ? { durationMs } : {},
127
- ...value !== void 0 ? { value } : {},
128
- ...currencyCode(raw.currency) !== void 0 ? { currency: raw.currency } : {},
270
+ ...money.value !== void 0 ? { value: money.value } : {},
271
+ ...money.currency !== void 0 ? { currency: money.currency } : {},
272
+ ...money.originalValue !== void 0 ? { originalValue: money.originalValue } : {},
273
+ ...money.originalCurrency !== void 0 ? { originalCurrency: money.originalCurrency } : {},
274
+ ...order ? { dedupeKey: dedupeKeyFor({
275
+ origin,
276
+ ...scope ? { tenant: scope } : {},
277
+ goal: name ?? raw.type,
278
+ orderId: order,
279
+ refund,
280
+ ...refundId === void 0 ? {} : { refundId },
281
+ ...orderKey ? { key: orderKey } : {}
282
+ }) } : {},
283
+ ...refund ? { refund: true } : {},
129
284
  ...scrollDepth !== void 0 ? { scrollDepth } : {},
130
285
  ...completions.length > 0 ? { goals: completions } : {},
131
286
  ...scope !== void 0 ? { scope } : {},
132
- ...timezone !== void 0 ? { timezone } : {}
287
+ ...item !== void 0 ? { item } : {},
288
+ ...impressions.length > 0 ? { impressions } : {},
289
+ visitorId: identifiesVisitor(ip, ua) ? dailyVisitorId({
290
+ ip,
291
+ ua,
292
+ site: hostname,
293
+ salt
294
+ }) : "",
295
+ ...clickId ? { clickId } : {},
296
+ ...input.type === "pageview" && isNavigation(input.nav) ? { navigation: true } : {},
297
+ ...origin === "server" ? { server: true } : {}
133
298
  };
134
299
  }
135
300
  //#endregion
136
- export { normalizeEvent };
301
+ export { eventTime, normalizeEvent };
137
302
 
138
303
  //# sourceMappingURL=normalizeEvent.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"normalizeEvent.js","names":[],"sources":["../../../src/native/ingest/normalizeEvent.ts"],"sourcesContent":["import { type GoalCompletion, matchGoals } from '../../goals/match'\nimport type { Goal } from '../../goals/types'\nimport { MAX_GEO_LENGTH, MAX_QUERY_LENGTH, MAX_REFERRER_LENGTH } from '../../query/limits'\nimport type { GeoResolver } from '../geo/geoResolver'\nimport { type BrowserName, classifyBrowser, classifyOs, type OsName } from './browser'\nimport { clientIpFromHeaders } from './clientIp'\nimport { classifyDevice, type DeviceType } from './device'\nimport { primaryLanguage } from './language'\nimport { referrerHost, storedReferrer } from './referrer'\nimport { MAX_HOSTNAME_LENGTH } from './requestHost'\nimport { CHANNEL_TAXONOMY_VERSION, classifyChannel, deriveSource } from './source'\nimport { extractUtm } from './utm'\nimport { dailyVisitorHash, deriveSessionId } from './visitorHash'\n\n/** The wire caps, re-exported beside the sanitizers that apply them. */\nexport { MAX_GEO_LENGTH, MAX_QUERY_LENGTH, MAX_REFERRER_LENGTH }\n\nexport type EventType = 'pageview' | 'event' | 'goal'\n\nexport interface RawEventInput {\n\ttype: EventType\n\t/** Event name, or the goal slug on a `goal`. Absent on pageviews. */\n\tname?: string\n\tpath: string\n\t/**\n\t * The hostname the client claims. Ignored by the HTTP ingest, which attributes an event to\n\t * the request that carried it; `trackServerEvent` supplies its own and it is used as sent.\n\t */\n\thostname?: string\n\treferrer?: string\n\t/**\n\t * The page's query string, without its leading `?`. Read for its utm keys and then\n\t * discarded: it is never stored, so a session token or an email address that happens to\n\t * be in the URL never lands in the events collection.\n\t */\n\tquery?: string\n\tdurationMs?: number\n\tprops?: Record<string, unknown>\n\t/** Revenue for a goal completion, in `currency`. */\n\tvalue?: number\n\tcurrency?: string\n\t/** Max scroll depth reached on a pageview, 0-100. */\n\tscrollDepth?: number\n}\n\nexport interface StoredEvent {\n\ttimestamp: Date\n\ttype: EventType\n\tname?: string\n\tpath: string\n\thostname: string\n\t/** Origin and path only: the query string and fragment are stripped before storage. */\n\treferrer?: string\n\t/**\n\t * The referrer's bare host, derived at ingest because a `where` cannot derive it at read\n\t * time: it is what the `referrer` dimension buckets and filters on.\n\t */\n\treferrerHost?: string\n\tdevice?: DeviceType\n\tbrowser?: BrowserName\n\tos?: OsName\n\t/**\n\t * The visit's named origin: its `utm_source`, else the referrer host, else `direct`.\n\t * Typed as a string because a row written before this classification holds whatever the\n\t * rules of its day decided, and rows are never rewritten.\n\t */\n\tsource?: string\n\t/** The hit's acquisition channel (`TrafficChannel`), classified from the origin above. */\n\tchannel: string\n\t/**\n\t * The taxonomy the `channel` beside it was decided under, so a later reclassify can find\n\t * the rows an older rule set wrote.\n\t */\n\tchannelVersion: number\n\t/** The five campaign keys extracted from the wire `query`; absent when it carried none. */\n\tutmSource?: string\n\tutmMedium?: string\n\tutmCampaign?: string\n\tutmContent?: string\n\tutmTerm?: string\n\tcountry?: string\n\tregion?: string\n\tcity?: string\n\t/** Primary `Accept-Language` tag, lowercased (`de-de`). */\n\tlanguage?: string\n\tvisitorHash: string\n\tsessionId: string\n\tdurationMs?: number\n\tprops?: Record<string, unknown>\n\tvalue?: number\n\t/** ISO 4217 code `value` is denominated in. Stored as sent; revenue is never converted. */\n\tcurrency?: string\n\tscrollDepth?: number\n\t/**\n\t * Goals this event completed, resolved against the install's goals at ingest so a later\n\t * goal edit never rewrites history and a raw-event read can re-derive the same numbers\n\t * the rollups hold.\n\t */\n\tgoals?: GoalCompletion[]\n\t/** Set only in scoped installs; '' is the null scope. */\n\tscope?: string\n\t/**\n\t * Reporting timezone the rollup day bucket is computed in. In-memory only: stripped\n\t * before the event row is persisted (day bucketing happens at rollup time). Absent\n\t * means UTC.\n\t */\n\ttimezone?: string\n}\n\nexport interface NormalizeArgs {\n\traw: RawEventInput\n\t/** Already resolved and capped: what the event is attributed to, not what it claimed. */\n\thostname: string\n\theaders: Headers\n\tgeoResolver: GeoResolver\n\tsalt: string\n\tnow: Date\n\tscope?: string\n\ttimezone?: string\n\t/** Goals to match this event against; omitted means no goal matching. */\n\tgoals?: Goal[]\n\t/** Trusted proxies in front of the app, for the client address the hash and geo read. */\n\ttrustedProxyHops?: number\n}\n\nconst MAX_PROPS = 20\nconst MAX_KEY_LENGTH = 64\nconst MAX_VALUE_LENGTH = 256\nconst MAX_NAME_LENGTH = 128\nconst MAX_PATH_LENGTH = 512\n/** 24 hours. A longer duration is a broken clock, not a session. */\nconst MAX_DURATION_MS = 86_400_000\nconst CURRENCY = /^[A-Z]{3}$/\n\n/**\n * Optional wire fields are sanitized rather than rejected: a bad `value`, `currency`,\n * `scrollDepth`, `durationMs`, or prop is dropped and the event is still ingested, so one malformed\n * attribute never costs a pageview. Only the required fields (checked in the endpoint)\n * can fail an event.\n */\nconst nonNegative = (value: unknown): number | undefined =>\n\ttypeof value === 'number' && Number.isFinite(value) && value >= 0 ? value : undefined\n\nconst currencyCode = (value: unknown): string | undefined =>\n\ttypeof value === 'string' && CURRENCY.test(value) ? value : undefined\n\n/**\n * Infinity would poison a rollup bucket's average for good, and a string would throw out of\n * the write and take the whole buffered batch with it, so a duration outside the ceiling is\n * dropped like any other malformed attribute.\n */\nconst duration = (value: unknown): number | undefined => {\n\tconst n = nonNegative(value)\n\treturn n === undefined || n > MAX_DURATION_MS ? undefined : n\n}\n\n/** The event name is a rollup bucket key (the `event` dimension), so it is length-capped. */\nconst eventName = (value: unknown): string | undefined =>\n\ttypeof value === 'string' ? value.slice(0, MAX_NAME_LENGTH) : undefined\n\n/**\n * A geo value as stored. The resolver reads request headers a client can set, and each value\n * becomes a rollup dimvalue and part of a seen-ledger key, so it is capped here rather than\n * trusted. An empty value stays absent: '' would be a bucket of its own.\n */\nconst geoValue = (value: string | undefined): string | undefined =>\n\tvalue ? value.slice(0, MAX_GEO_LENGTH) : undefined\n\n/** Capped before it is parsed, so a hostile query cannot make ingest do unbounded work. */\nconst queryString = (value: unknown): string | undefined =>\n\ttypeof value === 'string' ? value.slice(0, MAX_QUERY_LENGTH) : undefined\n\nconst depth = (value: unknown): number | undefined => {\n\tconst n = nonNegative(value)\n\treturn n === undefined ? undefined : Math.round(Math.min(n, 100))\n}\n\n/** Flat JSON scalars only: the first 20 short-keyed string/number/boolean entries. */\nconst sanitizeProps = (raw: unknown): Record<string, unknown> | undefined => {\n\tif (typeof raw !== 'object' || raw === null || Array.isArray(raw)) {\n\t\treturn undefined\n\t}\n\tconst out: Record<string, unknown> = {}\n\tlet kept = 0\n\tfor (const [key, value] of Object.entries(raw)) {\n\t\tif (kept >= MAX_PROPS || key.length > MAX_KEY_LENGTH) {\n\t\t\tcontinue\n\t\t}\n\t\tif (typeof value === 'string') {\n\t\t\tout[key] = value.slice(0, MAX_VALUE_LENGTH)\n\t\t} else if (\n\t\t\ttypeof value === 'boolean' ||\n\t\t\t(typeof value === 'number' && Number.isFinite(value))\n\t\t) {\n\t\t\tout[key] = value\n\t\t} else {\n\t\t\tcontinue\n\t\t}\n\t\tkept++\n\t}\n\treturn kept > 0 ? out : undefined\n}\n\nexport async function normalizeEvent({\n\traw,\n\thostname: rawHostname,\n\theaders,\n\tgeoResolver,\n\tsalt,\n\tnow,\n\tscope,\n\ttimezone,\n\tgoals,\n\ttrustedProxyHops,\n}: NormalizeArgs): Promise<StoredEvent> {\n\tconst geo = await geoResolver(headers, { trustedProxyHops })\n\tconst ip = clientIpFromHeaders(headers, { trustedProxyHops }) ?? ''\n\tconst ua = headers.get('user-agent') ?? ''\n\t// Everything that becomes a rollup dimvalue or a seen-ledger key is capped before anything\n\t// derives from it: an uncapped value exceeds Mongo's index key limit, and on Postgres a\n\t// btree key over 2704 bytes fails the write outright. That covers path and hostname here,\n\t// the geo values below (a client can set the headers a resolver reads), and the event name,\n\t// query and referrer in their own sanitizers.\n\tconst path = raw.path.slice(0, MAX_PATH_LENGTH)\n\tconst hostname = rawHostname.slice(0, MAX_HOSTNAME_LENGTH)\n\tconst visitorHash = dailyVisitorHash({ ip, ua, site: hostname, salt })\n\tconst hourBucket = now.toISOString().slice(0, 13)\n\tconst props = sanitizeProps(raw.props)\n\tconst value = nonNegative(raw.value)\n\tconst scrollDepth = depth(raw.scrollDepth)\n\tconst durationMs = duration(raw.durationMs)\n\tconst name = eventName(raw.name)\n\tconst device = classifyDevice(ua)\n\tconst browser = classifyBrowser(ua)\n\tconst os = classifyOs(ua)\n\tconst language = primaryLanguage(headers.get('accept-language'))\n\tconst refHost = referrerHost(raw.referrer, hostname)\n\tconst query = queryString(raw.query)\n\tconst utm = extractUtm(query)\n\t// Match on the sanitized fields so a rejected value never reaches a goal's revenue.\n\tconst completions = goals?.length\n\t\t? matchGoals({ type: raw.type, name, path, props, value }, goals)\n\t\t: []\n\treturn {\n\t\ttimestamp: now,\n\t\ttype: raw.type,\n\t\tname,\n\t\tpath,\n\t\thostname,\n\t\treferrer: storedReferrer(raw.referrer),\n\t\t...(refHost ? { referrerHost: refHost } : {}),\n\t\t...(device ? { device } : {}),\n\t\t...(browser ? { browser } : {}),\n\t\t...(os ? { os } : {}),\n\t\tsource: deriveSource({ referrerHost: refHost, utmSource: utm.utmSource }),\n\t\tchannel: classifyChannel({\n\t\t\treferrerHost: refHost,\n\t\t\tutmSource: utm.utmSource,\n\t\t\tutmMedium: utm.utmMedium,\n\t\t\tquery,\n\t\t}),\n\t\tchannelVersion: CHANNEL_TAXONOMY_VERSION,\n\t\t...utm,\n\t\tcountry: geoValue(geo.country),\n\t\tregion: geoValue(geo.region),\n\t\tcity: geoValue(geo.city),\n\t\t...(language ? { language } : {}),\n\t\tvisitorHash,\n\t\tsessionId: deriveSessionId(visitorHash, hourBucket),\n\t\tprops,\n\t\t...(durationMs !== undefined ? { durationMs } : {}),\n\t\t...(value !== undefined ? { value } : {}),\n\t\t...(currencyCode(raw.currency) !== undefined ? { currency: raw.currency } : {}),\n\t\t...(scrollDepth !== undefined ? { scrollDepth } : {}),\n\t\t...(completions.length > 0 ? { goals: completions } : {}),\n\t\t...(scope !== undefined ? { scope } : {}),\n\t\t...(timezone !== undefined ? { timezone } : {}),\n\t}\n}\n"],"mappings":"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"}
1
+ {"version":3,"file":"normalizeEvent.js","names":[],"sources":["../../../src/native/ingest/normalizeEvent.ts"],"sourcesContent":["import { isRecord } from '../../core/values'\nimport { MAX_ENGAGEMENT_MS, MAX_ITEMS_PER_BEACON, MAX_SINCE_MS } from '../../goals/constants'\nimport type { CurrencyConverter } from '../../goals/currency'\nimport { sanitizeItems } from '../../goals/items'\nimport {\n\ttype BrowserAmounts,\n\ttype CompletionAmount,\n\tcompletionAmounts,\n\tDEFAULT_BROWSER_AMOUNTS,\n\ttype GoalCompletion,\n} from '../../goals/match'\nimport type { Goal } from '../../goals/types'\nimport type { ItemIdType } from '../../items/idType'\nimport { boundItemRef } from '../../items/ref'\nimport type { TrustedPlatform } from '../../net/platform'\nimport { MAX_GEO_LENGTH, MAX_QUERY_LENGTH } from '../../query/limits'\nimport type { GeoResolver } from '../geo/geoResolver'\nimport { resolveGeo } from '../geo/resolveGeo'\nimport type { HitType } from '../store/types'\nimport { type BrowserName, classifyBrowser, classifyOs, type OsName } from './browser'\nimport { clientIpFromHeaders } from './clientIp'\nimport { classifyDevice, type DeviceType, SERVER_USER_AGENT } from './device'\nimport { type ItemSignatureCheck, verifiedItemRef } from './itemSignature'\nimport { primaryLanguage } from './language'\nimport { isSiteReferral, referrerHost, storedReferrer } from './referrer'\nimport { MAX_HOSTNAME_LENGTH } from './requestHost'\nimport {\n\tboundedValue,\n\tdedupeKeyFor,\n\ttype IngestOrigin,\n\tisRefund,\n\ttype Money,\n\treconcileMoney,\n\tsanitizeOrderId,\n} from './revenue'\nimport { clickIdOf } from './source'\nimport { extractUtm } from './utm'\nimport { boundedSinceMs, isNavigation } from './validate'\nimport { dailyVisitorId } from './visitorHash'\n\n/**\n * One event as the tracker or `trackServerEvent` sends it, before the ingest normalizes it.\n * @beta\n */\nexport interface RawEventInput {\n\t/** An `engagement` gets a row of its own so a filtered read finds it, never counted as a hit. */\n\ttype: HitType\n\t/** Event name, or the goal slug on a `goal`. Absent on a pageview and an engagement. */\n\tname?: string\n\tpath: string\n\t/**\n\t * The hostname the client claims. Ignored by the HTTP ingest, which attributes an event to\n\t * the request that carried it; `trackServerEvent` supplies its own and it is used as sent.\n\t */\n\thostname?: string\n\treferrer?: string\n\t/**\n\t * Query string without its leading `?`. Read for campaign keys and never stored, so a session\n\t * token or email address in the URL never lands in a hit.\n\t */\n\tquery?: string\n\t/**\n\t * Engaged time an engagement adds. Kept on a pageview too, which is what a tracker cached\n\t * from before engagement existed still sends; dropped on every other type.\n\t */\n\tdurationMs?: number\n\t/**\n\t * On an engagement only: ms since its pageview was sent, by the page's own clock so the device's\n\t * date never matters. Read by {@link eventTime}, never stored.\n\t */\n\tsinceMs?: number\n\t/**\n\t * How long the event waited in the page before it was sent, by the page's own clock: a pending\n\t * gate or a prerender held it. Read by {@link eventTime}, never stored.\n\t */\n\tageMs?: number\n\t/** `1` on a pageview a single-page app made in place, without loading a document. */\n\tnav?: number\n\tprops?: Record<string, unknown>\n\t/** Revenue for a goal completion, in `currency`. */\n\tvalue?: number\n\tcurrency?: string\n\t/**\n\t * The lines of a sale. Sanitized and stored under `props.items`, so a read of the event\n\t * carries the order without a second collection.\n\t */\n\titems?: unknown\n\t/**\n\t * Marks a server `purchase` or `refund`, the one path a negative `value` is allowed on. The wire\n\t * refuses it: a forged refund subtracts from revenue it never added to.\n\t */\n\trevenue?: boolean\n\t/**\n\t * The order this amount belongs to. The order's hit is keyed by a digest of it, so a retried\n\t * payment webhook counts once however often it arrives; the id itself is stored nowhere.\n\t */\n\torderId?: string\n\t/**\n\t * On a server refund, the refund's own id as the payment provider names it: it joins the order\n\t * id in the refund's key, so each partial refund counts once however often it is retried.\n\t */\n\trefundId?: string\n\t/**\n\t * On a pageview, its scroll depth, 0 when the tracker measures it afterwards; on an\n\t * engagement, how much deeper the page was scrolled since the previous one. 0-100.\n\t */\n\tscrollDepth?: number\n\t/**\n\t * Item ref (`<collection>:<id>`), server-signed when a page sends it (`offers:12@<signature>`).\n\t * Dropped, keeping the event, unless verified and of a collection bound as an item.\n\t */\n\titem?: string\n\t/**\n\t * On an engagement only: item values seen since the previous one, each checked like `item` and\n\t * capped at one beacon's worth.\n\t */\n\timpressions?: unknown\n}\n\n/**\n * An event once ingest has sanitized, attributed and matched it: what `toHit` shapes into the row\n * that is stored. Nothing here is written as it stands.\n */\nexport interface NormalizedEvent {\n\t/** When it arrived, or for an engagement its pageview's start; see {@link eventTime}. */\n\ttimestamp: Date\n\ttype: HitType\n\tname?: string\n\tpath: string\n\thostname: string\n\t/**\n\t * Origin and path only, the query string and fragment stripped: whether a pageview opens a\n\t * visit is decided by it. Never stored.\n\t */\n\treferrer?: string\n\t/** The referrer's bare host, which a landing stores as `ref`; absent for the site's own. */\n\treferrerHost?: string\n\t/**\n\t * The referrer is another hostname its scope records hits under: a link inside the site, which\n\t * opens no visit, whatever hostname it led to.\n\t */\n\tsiteReferrer?: boolean\n\tdevice?: DeviceType\n\tbrowser?: BrowserName\n\tos?: OsName\n\t/** The five campaign keys extracted from the wire `query`; absent when it carried none. */\n\tutmSource?: string\n\tutmMedium?: string\n\tutmCampaign?: string\n\tutmContent?: string\n\tutmTerm?: string\n\tcountry?: string\n\tregion?: string\n\tcity?: string\n\t/** Primary `Accept-Language` tag, lowercased (`de-de`). */\n\tlanguage?: string\n\tdurationMs?: number\n\tprops?: Record<string, unknown>\n\tvalue?: number\n\t/**\n\t * ISO 4217 code of `value`: as sent without `revenue.currency`, else always the reporting\n\t * currency, with the `original` fields holding what arrived.\n\t */\n\tcurrency?: string\n\t/** The amount as sent, present only when it is not what `value` holds. */\n\toriginalValue?: number\n\toriginalCurrency?: string\n\t/**\n\t * The order hit's primary key derives from it, so the database refuses a second row for one order\n\t * even when two retries race.\n\t */\n\tdedupeKey?: string\n\t/** A server refund: its completions count their negative amount in revenue and no conversion. */\n\trefund?: true\n\tscrollDepth?: number\n\t/**\n\t * Goals this event completed, resolved against the install's goals at ingest so a later\n\t * goal edit never rewrites history.\n\t */\n\tgoals?: GoalCompletion[]\n\t/** Set only in scoped installs; '' is the null scope. */\n\tscope?: string\n\t/** The content item this event or goal belongs to, as its ref. */\n\titem?: string\n\t/** Items seen on screen since the previous engagement, on an engagement only. */\n\timpressions?: string[]\n\t/**\n\t * The day's visitor id: 16 characters of a keyed hash of the address, the agent and the site,\n\t * or `''` for a server event with neither an address nor a user agent of its own.\n\t */\n\tvisitorId: string\n\t/** The ad click id the query carried, by name (`gclid`, `fbclid`). */\n\tclickId?: string\n\t/** A pageview a single-page app made in place (`nav: 1`). */\n\tnavigation?: boolean\n\t/** Recorded by server code rather than sent by a browser. */\n\tserver?: boolean\n}\n\ninterface NormalizeArgs {\n\traw: RawEventInput\n\t/** Already resolved and capped: what the event is attributed to, not what it claimed. */\n\thostname: string\n\theaders: Headers\n\tgeoResolver: GeoResolver\n\t/** Where a throwing resolver is reported; the event is stored without a location either way. */\n\twarnGeo?: (message: string) => void\n\t/** The salt of the visitor's day, which the visitor id is hashed with. */\n\tsalt: string\n\tnow: Date\n\tscope?: string\n\tgoals?: Goal[]\n\t/**\n\t * Revenue semantics belong to `'server'` alone, so the default is the unprivileged origin and\n\t * only `trackServerEvent` passes the other.\n\t */\n\torigin?: IngestOrigin\n\t/**\n\t * `revenue.browserAmounts`: how far an amount a browser sent is believed. Read for\n\t * `origin: 'wire'` alone; absent, `DEFAULT_BROWSER_AMOUNTS`.\n\t */\n\tbrowserAmounts?: BrowserAmounts\n\t/** The install's reporting currency; undefined stores and sums amounts exactly as sent. */\n\treportingCurrency?: string\n\tconvertCurrency?: CurrencyConverter\n\t/** Called at most once per process when an amount could not be converted. */\n\twarnUnconverted?: () => void\n\t/** Trusted proxies in front of the app, for the client address the hash and geo read. */\n\ttrustedProxyHops?: number\n\t/** The platform whose edge headers carry the client address and location, when trusted. */\n\ttrustedPlatform?: TrustedPlatform\n\t/** The collections bound as items, whose refs alone are kept. Absent keeps no item at all. */\n\titems?: ItemIngestOptions\n\t/**\n\t * The other hostnames the event's scope records hits under, bare: a referrer on one of them is\n\t * the site's own page, never a referral.\n\t */\n\tsiblings?: ReadonlySet<string>\n\t/** `orderDigestKey` of the instance's secret, which an order's key is digested with. */\n\torderKey?: Buffer\n}\n\nexport interface ItemIngestOptions {\n\tcollections: ReadonlySet<string>\n\t/**\n\t * Each bound collection's id type, known once the database adapter is (at init). A ref whose\n\t * id cannot be one of its collection's ids is dropped like an unbound one.\n\t */\n\tidTypes?: ReadonlyMap<string, ItemIdType>\n\t/**\n\t * How a ref's signature is checked, known once the instance's secret is. Absent, nothing a page\n\t * sends can be verified, so only server code's own items are kept.\n\t */\n\tsignature?: ItemSignatureCheck\n}\n\nconst MAX_PROPS = 20\nconst MAX_KEY_LENGTH = 64\nconst MAX_VALUE_LENGTH = 256\nconst MAX_NAME_LENGTH = 128\nconst MAX_PATH_LENGTH = 512\nconst CURRENCY = /^[A-Z]{3}$/\n\n/**\n * When an event happened: its arrival less its `ageMs`, and an engagement's `sinceMs` too, so it is\n * filed at its pageview's start. Each is believed from 0 to a day, and together reach back a day.\n */\nexport const eventTime = (\n\traw: Pick<RawEventInput, 'type' | 'sinceMs' | 'ageMs'>,\n\treceivedAt: Date\n): Date => {\n\tconst waited = boundedSinceMs(raw.ageMs) ?? 0\n\tconst since = raw.type === 'engagement' ? (boundedSinceMs(raw.sinceMs) ?? 0) : 0\n\tconst back = Math.min(MAX_SINCE_MS, waited + since)\n\treturn back === 0 ? receivedAt : new Date(receivedAt.getTime() - back)\n}\n\n/**\n * Whether an event comes with a visitor of its own: an address, or a user agent other than the\n * one server tracking stamps when it has none. A beacon always does; server code may not.\n */\nconst identifiesVisitor = (ip: string, ua: string): boolean =>\n\tip !== '' || (ua !== '' && ua !== SERVER_USER_AGENT)\n\n/**\n * Optional wire fields are sanitized rather than rejected, so one malformed attribute never costs\n * a pageview.\n */\nconst nonNegative = (value: unknown): number | undefined => {\n\tconst bounded = boundedValue(value)\n\treturn bounded !== undefined && bounded >= 0 ? bounded : undefined\n}\n\n/** A refund is the one negative amount ingest keeps, and only on a server `refund` call. */\nconst signed = (value: unknown): number | undefined => boundedValue(value)\n\nconst currencyCode = (value: unknown): string | undefined =>\n\ttypeof value === 'string' && CURRENCY.test(value) ? value : undefined\n\n/**\n * The event's amount as far as it is believed: as sent under `trust` and `fixed` (where a goal's\n * fixed value still wins for its own completion), nothing under `none`.\n */\nexport const sentAmount = (args: {\n\tvalue: number | undefined\n\tcurrency: string | undefined\n\tbelieved: BrowserAmounts\n}): { value?: number; currency?: string } =>\n\targs.believed === 'none'\n\t\t? {}\n\t\t: {\n\t\t\t\t...(args.value === undefined ? {} : { value: args.value }),\n\t\t\t\t...(args.currency === undefined ? {} : { currency: args.currency }),\n\t\t\t}\n\n/** One completion as counted, and the money its amount came to, absent for one worth nothing. */\ninterface CountedCompletion {\n\tcompletion: GoalCompletion\n\tmoney?: Money\n}\n\n/**\n * Each completion reconciled on its own (a fixed value in its goal's currency, else the event's),\n * one conversion per distinct amount however many goals share it.\n */\nconst countCompletions = async (\n\tamounts: readonly CompletionAmount[],\n\targs: {\n\t\teventCurrency: string | undefined\n\t\treconcile: (value: number, currency: string | undefined) => Promise<Money>\n\t}\n): Promise<CountedCompletion[]> => {\n\tconst counted: CountedCompletion[] = []\n\tfor (const { goal, source, amount } of amounts) {\n\t\tif (source === 'none') {\n\t\t\tcounted.push({ completion: { slug: goal.slug, value: 0 } })\n\t\t\tcontinue\n\t\t}\n\t\tconst currency = source === 'fixed' ? currencyCode(goal.currency) : args.eventCurrency\n\t\tconst money = await args.reconcile(amount, currency)\n\t\tcounted.push({\n\t\t\tcompletion: {\n\t\t\t\tslug: goal.slug,\n\t\t\t\tvalue: money.value ?? 0,\n\t\t\t\t...(money.originalValue === undefined ? {} : { sent: money.originalValue }),\n\t\t\t},\n\t\t\tmoney,\n\t\t})\n\t}\n\treturn counted\n}\n\n/**\n * Infinity would poison every average for good, and a string would throw out of the write and take\n * the buffered batch with it.\n */\nconst duration = (value: unknown): number | undefined => {\n\tconst n = nonNegative(value)\n\treturn n === undefined || n > MAX_ENGAGEMENT_MS ? undefined : n\n}\n\n/** The event name is a value the `event` dimension groups by, so it is length-capped. */\nconst eventName = (value: unknown): string | undefined =>\n\ttypeof value === 'string' ? value.slice(0, MAX_NAME_LENGTH) : undefined\n\n/**\n * Capped, not trusted: the resolver reads headers a client can set. An empty value stays absent,\n * since '' would be a value of its own.\n */\nconst geoValue = (value: string | undefined): string | undefined =>\n\tvalue ? value.slice(0, MAX_GEO_LENGTH) : undefined\n\n/** Capped before it is parsed, so a hostile query cannot make ingest do unbounded work. */\nconst queryString = (value: unknown): string | undefined =>\n\ttypeof value === 'string' ? value.slice(0, MAX_QUERY_LENGTH) : undefined\n\nconst depth = (value: unknown): number | undefined => {\n\tconst n = nonNegative(value)\n\treturn n === undefined ? undefined : Math.round(Math.min(n, 100))\n}\n\n/**\n * Flat JSON scalars only, first 20 short-keyed entries. An order's event drops an `orderId` prop:\n * an order is kept as its digest alone.\n */\nconst sanitizeProps = (raw: unknown, order: boolean): Record<string, unknown> | undefined => {\n\tif (!isRecord(raw) || Array.isArray(raw)) {\n\t\treturn undefined\n\t}\n\tconst out: Record<string, unknown> = {}\n\tlet kept = 0\n\tfor (const [key, value] of Object.entries(raw)) {\n\t\tif (kept >= MAX_PROPS || key.length > MAX_KEY_LENGTH || (order && key === 'orderId')) {\n\t\t\tcontinue\n\t\t}\n\t\tif (typeof value === 'string') {\n\t\t\tout[key] = value.slice(0, MAX_VALUE_LENGTH)\n\t\t} else if (\n\t\t\ttypeof value === 'boolean' ||\n\t\t\t(typeof value === 'number' && Number.isFinite(value))\n\t\t) {\n\t\t\tout[key] = value\n\t\t} else {\n\t\t\tcontinue\n\t\t}\n\t\tkept++\n\t}\n\treturn kept > 0 ? out : undefined\n}\n\n/**\n * An engagement adds only time, scroll and items seen; time and scroll count from a pageview or an\n * engagement alone, and only an event or a goal belongs to an item.\n */\nconst fieldsOfType = (raw: RawEventInput): RawEventInput => {\n\tif (raw.type === 'engagement') {\n\t\tconst { type, path, hostname, referrer, query, durationMs, scrollDepth, impressions } = raw\n\t\treturn { type, path, hostname, referrer, query, durationMs, scrollDepth, impressions }\n\t}\n\tif (raw.type === 'pageview') {\n\t\tconst { item: _item, impressions: _impressions, ...pageview } = raw\n\t\treturn pageview\n\t}\n\tconst {\n\t\tdurationMs: _durationMs,\n\t\tscrollDepth: _scrollDepth,\n\t\timpressions: _impressions,\n\t\t...hit\n\t} = raw\n\treturn hit\n}\n\n/**\n * The ref an item value is kept under: signed by this server (or trusted, or unsigned where\n * signatures are optional), of a bound collection, with an id that collection could hold.\n */\nconst keptItemRef = (\n\tvalue: unknown,\n\toptions: ItemIngestOptions,\n\torigin: IngestOrigin\n): string | undefined => {\n\tconst ref = verifiedItemRef(value, options.signature, origin === 'server')\n\treturn ref === undefined ? undefined : boundItemRef(ref, options.collections, options.idTypes)\n}\n\n/**\n * The refs of the items an engagement saw, each kept, once each, and no more than one beacon\n * carries. Anything else in the list is dropped rather than failing the engagement.\n */\nconst seenItems = (\n\tvalue: unknown,\n\toptions: ItemIngestOptions | undefined,\n\torigin: IngestOrigin\n): string[] => {\n\tif (!options || !Array.isArray(value)) {\n\t\treturn []\n\t}\n\tconst refs = new Set<string>()\n\tfor (const entry of value) {\n\t\tif (refs.size >= MAX_ITEMS_PER_BEACON) {\n\t\t\tbreak\n\t\t}\n\t\tconst ref = keptItemRef(entry, options, origin)\n\t\tif (ref !== undefined) {\n\t\t\trefs.add(ref)\n\t\t}\n\t}\n\treturn [...refs]\n}\n\n/** One event sanitized, attributed and goal-matched, alike for a beacon and for server code. */\nexport async function normalizeEvent({\n\traw: input,\n\thostname: rawHostname,\n\theaders,\n\tgeoResolver,\n\twarnGeo,\n\tsalt,\n\tnow,\n\tscope,\n\tgoals,\n\torigin = 'wire',\n\tbrowserAmounts = DEFAULT_BROWSER_AMOUNTS,\n\treportingCurrency,\n\tconvertCurrency,\n\twarnUnconverted,\n\ttrustedProxyHops,\n\ttrustedPlatform,\n\titems: itemOptions,\n\tsiblings,\n\torderKey,\n}: NormalizeArgs): Promise<NormalizedEvent> {\n\tconst raw = fieldsOfType(input)\n\tconst item = itemOptions ? keptItemRef(raw.item, itemOptions, origin) : undefined\n\tconst impressions = seenItems(raw.impressions, itemOptions, origin)\n\tconst trust = { trustedProxyHops, trustedPlatform }\n\tconst geo = await resolveGeo(geoResolver, headers, { trust, warn: warnGeo })\n\tconst ip = clientIpFromHeaders(headers, trust) ?? ''\n\tconst ua = headers.get('user-agent') ?? ''\n\t// Every value a daily total is keyed by is capped first: Mongo's index key limit and Postgres'\n\t// 2704-byte btree key both fail the write. Geo, name, query and referrer cap below.\n\tconst path = raw.path.slice(0, MAX_PATH_LENGTH)\n\tconst hostname = rawHostname.slice(0, MAX_HOSTNAME_LENGTH)\n\tconst items = sanitizeItems(raw.items)\n\tconst sanitized = sanitizeProps(raw.props, raw.orderId !== undefined)\n\t// The lines ride under props rather than in a column of their own: they are read back with\n\t// the event, never grouped or filtered on, and `sanitizeProps` keeps scalars only.\n\tconst props = items === undefined ? sanitized : { ...sanitized, items }\n\tconst name = eventName(raw.name)\n\tconst isRevenue = origin === 'server' && raw.revenue === true\n\tconst refund = isRefund(isRevenue, raw.value)\n\tconst believed: BrowserAmounts = origin === 'server' ? 'trust' : browserAmounts\n\t// A server-only goal (`browser: false`) is one a browser cannot complete, whatever it sends.\n\tconst candidates = origin === 'wire' ? goals?.filter((goal) => goal.browser !== false) : goals\n\tconst matching = Boolean(candidates?.length) && raw.type !== 'engagement'\n\tconst eventCurrency = currencyCode(raw.currency)\n\tconst sent = sentAmount({\n\t\tvalue: isRevenue ? signed(raw.value) : nonNegative(raw.value),\n\t\tcurrency: eventCurrency,\n\t\tbelieved,\n\t})\n\tconst reconciled = new Map<string, Promise<Money>>()\n\tconst reconcile = (value: number | undefined, currency: string | undefined): Promise<Money> => {\n\t\tconst key = JSON.stringify([value ?? null, currency ?? null])\n\t\tconst known = reconciled.get(key)\n\t\tif (known) {\n\t\t\treturn known\n\t\t}\n\t\tconst money = reconcileMoney({\n\t\t\t...(value === undefined ? {} : { value }),\n\t\t\t...(currency === undefined ? {} : { currency }),\n\t\t\treportingCurrency,\n\t\t\tconvertCurrency,\n\t\t\tat: now,\n\t\t\twarn: warnUnconverted,\n\t\t})\n\t\treconciled.set(key, money)\n\t\treturn money\n\t}\n\t// Match on the sanitized fields, each completion's amount reconciled on its own, so a rejected\n\t// value never reaches a goal's revenue and a converted one is what revenue sums.\n\tconst counted =\n\t\tmatching && candidates\n\t\t\t? await countCompletions(\n\t\t\t\t\tcompletionAmounts({ type: raw.type, name, path, props, value: sent.value }, candidates, {\n\t\t\t\t\t\tallowNegativeValue: isRevenue,\n\t\t\t\t\t\tprops: believed !== 'none',\n\t\t\t\t\t\tfixedFirst: believed !== 'trust',\n\t\t\t\t\t}),\n\t\t\t\t\t{ eventCurrency, reconcile }\n\t\t\t\t)\n\t\t\t: []\n\tconst completions = counted.map((each) => each.completion)\n\t// The row carries the money of its first completion worth something, else the event's own.\n\tconst money =\n\t\tcounted.find((each) => each.money !== undefined)?.money ??\n\t\t(await reconcile(sent.value, sent.currency))\n\tconst order = sanitizeOrderId(raw.orderId)\n\tconst refundId = refund ? sanitizeOrderId(raw.refundId) : undefined\n\tconst scrollDepth = depth(raw.scrollDepth)\n\tconst durationMs = duration(raw.durationMs)\n\tconst device = classifyDevice(ua)\n\tconst browser = classifyBrowser(ua)\n\tconst os = classifyOs(ua)\n\tconst language = primaryLanguage(headers.get('accept-language'))\n\tconst refHost = referrerHost(raw.referrer, hostname, siblings)\n\tconst siteReferrer =\n\t\t!isSiteReferral(raw.referrer, hostname) && isSiteReferral(raw.referrer, hostname, siblings)\n\tconst query = queryString(raw.query)\n\tconst utm = extractUtm(query)\n\tconst clickId = clickIdOf(query)\n\treturn {\n\t\ttimestamp: now,\n\t\ttype: raw.type,\n\t\tname,\n\t\tpath,\n\t\thostname,\n\t\treferrer: storedReferrer(raw.referrer),\n\t\t...(refHost ? { referrerHost: refHost } : {}),\n\t\t...(siteReferrer ? { siteReferrer: true } : {}),\n\t\t...(device ? { device } : {}),\n\t\t...(browser ? { browser } : {}),\n\t\t...(os ? { os } : {}),\n\t\t...utm,\n\t\tcountry: geoValue(geo.country),\n\t\tregion: geoValue(geo.region),\n\t\tcity: geoValue(geo.city),\n\t\t...(language ? { language } : {}),\n\t\tprops,\n\t\t...(durationMs !== undefined ? { durationMs } : {}),\n\t\t...(money.value !== undefined ? { value: money.value } : {}),\n\t\t...(money.currency !== undefined ? { currency: money.currency } : {}),\n\t\t...(money.originalValue !== undefined ? { originalValue: money.originalValue } : {}),\n\t\t...(money.originalCurrency !== undefined ? { originalCurrency: money.originalCurrency } : {}),\n\t\t...(order\n\t\t\t? {\n\t\t\t\t\tdedupeKey: dedupeKeyFor({\n\t\t\t\t\t\torigin,\n\t\t\t\t\t\t...(scope ? { tenant: scope } : {}),\n\t\t\t\t\t\tgoal: name ?? raw.type,\n\t\t\t\t\t\torderId: order,\n\t\t\t\t\t\trefund,\n\t\t\t\t\t\t...(refundId === undefined ? {} : { refundId }),\n\t\t\t\t\t\t...(orderKey ? { key: orderKey } : {}),\n\t\t\t\t\t}),\n\t\t\t\t}\n\t\t\t: {}),\n\t\t...(refund ? { refund: true } : {}),\n\t\t...(scrollDepth !== undefined ? { scrollDepth } : {}),\n\t\t...(completions.length > 0 ? { goals: completions } : {}),\n\t\t...(scope !== undefined ? { scope } : {}),\n\t\t...(item !== undefined ? { item } : {}),\n\t\t...(impressions.length > 0 ? { impressions } : {}),\n\t\tvisitorId: identifiesVisitor(ip, ua) ? dailyVisitorId({ ip, ua, site: hostname, salt }) : '',\n\t\t...(clickId ? { clickId } : {}),\n\t\t...(input.type === 'pageview' && isNavigation(input.nav) ? { navigation: true } : {}),\n\t\t...(origin === 'server' ? { server: true } : {}),\n\t}\n}\n"],"mappings":"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"}
@@ -0,0 +1,13 @@
1
+ import { Payload } from "payload";
2
+
3
+ //#region src/native/ingest/orderSignature.d.ts
4
+ /**
5
+ * `orderId` for the browser `purchase` (`<orderId>@<signature>`), bound to the tenant `scope`.
6
+ * Call it where the success page renders; the browser never sees the key.
7
+ */
8
+ declare const signOrderId: (payload: Payload, orderId: string, opts?: {
9
+ scope?: string | null;
10
+ }) => string | undefined;
11
+ //#endregion
12
+ export { signOrderId };
13
+ //# sourceMappingURL=orderSignature.d.ts.map
@@ -0,0 +1,50 @@
1
+ import { labelledKey, sameSignature, shortSignature } from "./signature.js";
2
+ import { sanitizeOrderId } from "./revenue.js";
3
+ import { isSignatureShaped } from "../../items/ref.js";
4
+ //#region src/native/ingest/orderSignature.ts
5
+ /** The key order ids are signed with, derived from the instance's secret. */
6
+ const orderRefKey = labelledKey("analytics:order-ref:v1");
7
+ /** The signature of one order id in one scope. */
8
+ const signatureOf = (key, scope, orderId) => shortSignature(key, JSON.stringify([scope, orderId]));
9
+ /** A value split at its last separator when what follows it has a signature's shape. */
10
+ const splitSigned = (value) => {
11
+ const at = value.lastIndexOf("@");
12
+ const signature = at > 0 ? value.slice(at + 1) : "";
13
+ return isSignatureShaped(signature) ? {
14
+ orderId: value.slice(0, at),
15
+ signature
16
+ } : void 0;
17
+ };
18
+ const signedWith = (key, scope, signed) => sameSignature(signatureOf(key, scope, signed.orderId), signed.signature);
19
+ const sanitizedOrderId = (value) => {
20
+ const orderId = sanitizeOrderId(value);
21
+ return orderId === void 0 ? { ok: false } : {
22
+ ok: true,
23
+ orderId
24
+ };
25
+ };
26
+ /**
27
+ * Id unwrapped from a reference signed for the event's scope, else the raw value while signatures
28
+ * are optional. Refuses a malformed id and, when signatures are required, an unsigned one.
29
+ */
30
+ const wireOrderId = (value, scope, check) => {
31
+ if (value === void 0) return { ok: true };
32
+ const signed = typeof value === "string" ? splitSigned(value) : void 0;
33
+ if (signed && check?.key && signedWith(check.key, scope, signed)) return sanitizedOrderId(signed.orderId);
34
+ if (check?.mode === "required") return { ok: false };
35
+ return sanitizedOrderId(value);
36
+ };
37
+ /**
38
+ * `orderId` for the browser `purchase` (`<orderId>@<signature>`), bound to the tenant `scope`.
39
+ * Call it where the success page renders; the browser never sees the key.
40
+ */
41
+ const signOrderId = (payload, orderId, opts = {}) => {
42
+ const id = sanitizeOrderId(orderId);
43
+ const secret = payload.secret;
44
+ if (id === void 0 || typeof secret !== "string" || secret === "") return;
45
+ return `${id}@${signatureOf(orderRefKey(secret), opts.scope ?? "", id)}`;
46
+ };
47
+ //#endregion
48
+ export { orderRefKey, signOrderId, wireOrderId };
49
+
50
+ //# sourceMappingURL=orderSignature.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"orderSignature.js","names":[],"sources":["../../../src/native/ingest/orderSignature.ts"],"sourcesContent":["import type { Payload } from 'payload'\nimport { ITEM_SIGNATURE_SEPARATOR } from '../../goals/constants'\nimport type { OrderSignatureMode } from '../../goals/match'\nimport { isSignatureShaped } from '../../items/ref'\nimport { sanitizeOrderId } from './revenue'\nimport { labelledKey, sameSignature, shortSignature } from './signature'\n\n/** What ingest checks a page's order id against; without a key no signature is ever valid. */\nexport interface OrderSignatureCheck {\n\tmode: OrderSignatureMode\n\tkey?: Buffer\n}\n\n/** The key order ids are signed with, derived from the instance's secret. */\nexport const orderRefKey = labelledKey('analytics:order-ref:v1')\n\n/** The signature of one order id in one scope. */\nconst signatureOf = (key: Buffer, scope: string, orderId: string): string =>\n\tshortSignature(key, JSON.stringify([scope, orderId]))\n\ninterface SignedOrderId {\n\torderId: string\n\tsignature: string\n}\n\n/** A value split at its last separator when what follows it has a signature's shape. */\nconst splitSigned = (value: string): SignedOrderId | undefined => {\n\tconst at = value.lastIndexOf(ITEM_SIGNATURE_SEPARATOR)\n\tconst signature = at > 0 ? value.slice(at + 1) : ''\n\treturn isSignatureShaped(signature) ? { orderId: value.slice(0, at), signature } : undefined\n}\n\nconst signedWith = (key: Buffer, scope: string, signed: SignedOrderId): boolean =>\n\tsameSignature(signatureOf(key, scope, signed.orderId), signed.signature)\n\n/** A page's order id as ingest keeps it, or a refusal: ingest drops the sale and answers 202. */\ntype WireOrderId = { ok: true; orderId?: string } | { ok: false }\n\nconst sanitizedOrderId = (value: unknown): WireOrderId => {\n\tconst orderId = sanitizeOrderId(value)\n\treturn orderId === undefined ? { ok: false } : { ok: true, orderId }\n}\n\n/**\n * Id unwrapped from a reference signed for the event's scope, else the raw value while signatures\n * are optional. Refuses a malformed id and, when signatures are required, an unsigned one.\n */\nexport const wireOrderId = (\n\tvalue: unknown,\n\tscope: string,\n\tcheck: OrderSignatureCheck | undefined\n): WireOrderId => {\n\tif (value === undefined) {\n\t\treturn { ok: true }\n\t}\n\tconst signed = typeof value === 'string' ? splitSigned(value) : undefined\n\tif (signed && check?.key && signedWith(check.key, scope, signed)) {\n\t\treturn sanitizedOrderId(signed.orderId)\n\t}\n\tif (check?.mode === 'required') {\n\t\treturn { ok: false }\n\t}\n\treturn sanitizedOrderId(value)\n}\n\n/**\n * `orderId` for the browser `purchase` (`<orderId>@<signature>`), bound to the tenant `scope`.\n * Call it where the success page renders; the browser never sees the key.\n */\nexport const signOrderId = (\n\tpayload: Payload,\n\torderId: string,\n\topts: { scope?: string | null } = {}\n): string | undefined => {\n\tconst id = sanitizeOrderId(orderId)\n\tconst secret: unknown = payload.secret\n\tif (id === undefined || typeof secret !== 'string' || secret === '') {\n\t\treturn undefined\n\t}\n\tconst signature = signatureOf(orderRefKey(secret), opts.scope ?? '', id)\n\treturn `${id}${ITEM_SIGNATURE_SEPARATOR}${signature}`\n}\n"],"mappings":";;;;;AAcA,MAAa,cAAc,YAAY,wBAAwB;;AAG/D,MAAM,eAAe,KAAa,OAAe,YAChD,eAAe,KAAK,KAAK,UAAU,CAAC,OAAO,OAAO,CAAC,CAAC;;AAQrD,MAAM,eAAe,UAA6C;CACjE,MAAM,KAAK,MAAM,YAAA,GAAoC;CACrD,MAAM,YAAY,KAAK,IAAI,MAAM,MAAM,KAAK,CAAC,IAAI;CACjD,OAAO,kBAAkB,SAAS,IAAI;EAAE,SAAS,MAAM,MAAM,GAAG,EAAE;EAAG;CAAU,IAAI,KAAA;AACpF;AAEA,MAAM,cAAc,KAAa,OAAe,WAC/C,cAAc,YAAY,KAAK,OAAO,OAAO,OAAO,GAAG,OAAO,SAAS;AAKxE,MAAM,oBAAoB,UAAgC;CACzD,MAAM,UAAU,gBAAgB,KAAK;CACrC,OAAO,YAAY,KAAA,IAAY,EAAE,IAAI,MAAM,IAAI;EAAE,IAAI;EAAM;CAAQ;AACpE;;;;;AAMA,MAAa,eACZ,OACA,OACA,UACiB;CACjB,IAAI,UAAU,KAAA,GACb,OAAO,EAAE,IAAI,KAAK;CAEnB,MAAM,SAAS,OAAO,UAAU,WAAW,YAAY,KAAK,IAAI,KAAA;CAChE,IAAI,UAAU,OAAO,OAAO,WAAW,MAAM,KAAK,OAAO,MAAM,GAC9D,OAAO,iBAAiB,OAAO,OAAO;CAEvC,IAAI,OAAO,SAAS,YACnB,OAAO,EAAE,IAAI,MAAM;CAEpB,OAAO,iBAAiB,KAAK;AAC9B;;;;;AAMA,MAAa,eACZ,SACA,SACA,OAAkC,CAAC,MACX;CACxB,MAAM,KAAK,gBAAgB,OAAO;CAClC,MAAM,SAAkB,QAAQ;CAChC,IAAI,OAAO,KAAA,KAAa,OAAO,WAAW,YAAY,WAAW,IAChE;CAGD,OAAO,GAAG,MADQ,YAAY,YAAY,MAAM,GAAG,KAAK,SAAS,IAAI,EACnB;AACnD"}
@@ -1,17 +1,17 @@
1
1
  //#region src/native/ingest/referrer.ts
2
- /** A hostname as it is compared: lowercased, without a leading `www.`. */
2
+ /** A host lowercased and without `www.`, the form every referrer comparison uses. */
3
3
  const bareHost = (host) => host.toLowerCase().replace(/^www\./, "");
4
+ const parsedHost = (raw) => {
5
+ if (typeof raw !== "string" || !raw) return;
6
+ try {
7
+ return bareHost(new URL(raw).hostname) || void 0;
8
+ } catch {
9
+ return;
10
+ }
11
+ };
4
12
  /**
5
- * The referrer as it is stored: everything from the first `#` or `?` onwards removed, then
6
- * capped. A same-origin navigation puts the previous page's whole URL in `document.referrer`,
7
- * so the query string routinely carries a reset token, a session id or an email address that
8
- * has no business in an analytics row. Origin and path are kept verbatim, case included,
9
- * because they are what makes a referrer readable. The fragment goes first: a `?` after a
10
- * `#` belongs to the fragment, not to a query.
11
- *
12
- * An unparseable referrer is stripped on the same terms rather than trusted, and a value that
13
- * is not a string at all is dropped: the wire field is public and unvalidated, so a body
14
- * carrying `"referrer": {}` must cost the event its referrer, not the request its response.
13
+ * Referrer cut at the first `#` or `?`, then capped: a same-origin referrer's query can carry a
14
+ * reset token or an email address. A non-string is dropped, since the wire field is unvalidated.
15
15
  */
16
16
  const storedReferrer = (raw) => {
17
17
  if (typeof raw !== "string") return;
@@ -19,30 +19,28 @@ const storedReferrer = (raw) => {
19
19
  return stripped ? stripped.slice(0, 512) : void 0;
20
20
  };
21
21
  /**
22
- * The referrer's bare host, which is what the `referrer` dimension buckets and reads by:
23
- * lowercased, without scheme, port, path, query or a leading `www.`. Nothing is reported for
24
- * a missing, non-string, hostless or unparseable referrer, so the event contributes no
25
- * referrer bucket.
26
- *
27
- * A self-referral reports nothing either: internal navigation is the bulk of any site's
28
- * traffic, and counting it would put the site's own domain at the top of its referrers
29
- * breakdown forever. `selfHostname` is the event's own hostname, compared on the same terms
30
- * (case-insensitively, `www.` stripped). The `source` dimension reads the same absence as its
31
- * `direct` channel.
22
+ * Whether a referrer is a page of the event's own site: its own hostname, or another one its
23
+ * scope records hits under (`siblings`, bare hosts), compared the way {@link referrerHost} does.
32
24
  */
33
- const referrerHost = (raw, selfHostname) => {
34
- if (typeof raw !== "string" || !raw) return;
35
- let host;
36
- try {
37
- host = new URL(raw).hostname;
38
- } catch {
39
- return;
40
- }
41
- const bare = bareHost(host);
42
- if (!bare || bare === bareHost(selfHostname)) return;
25
+ const isSiteReferral = (raw, selfHostname, siblings) => {
26
+ const bare = parsedHost(raw);
27
+ return bare !== void 0 && (bare === bareHost(selfHostname) || (siblings?.has(bare) ?? false));
28
+ };
29
+ /**
30
+ * Bare host the `referrer` dimension groups by; undefined when unparseable or for the site itself
31
+ * (`selfHostname` and `siblings`), which `source` then reads as direct.
32
+ */
33
+ const referrerHost = (raw, selfHostname, siblings) => {
34
+ const bare = parsedHost(raw);
35
+ if (!bare || isSiteReferral(raw, selfHostname, siblings)) return;
43
36
  return bare.slice(0, 253);
44
37
  };
38
+ /** A link inside the hit's own site moves a visit along rather than opening one. */
39
+ const isSelfReferral = (raw, selfHostname) => {
40
+ const bare = parsedHost(raw);
41
+ return bare !== void 0 && bare === bareHost(selfHostname);
42
+ };
45
43
  //#endregion
46
- export { referrerHost, storedReferrer };
44
+ export { bareHost, isSelfReferral, isSiteReferral, referrerHost, storedReferrer };
47
45
 
48
46
  //# sourceMappingURL=referrer.js.map