@10x-media/analytics 1.0.0-beta.10 → 1.0.0-beta.12

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 (1242) hide show
  1. package/CHANGELOG.md +470 -0
  2. package/LICENSE +21 -21
  3. package/README.md +30 -37
  4. package/dist/access/adminUser.d.ts +15 -0
  5. package/dist/access/adminUser.js +13 -0
  6. package/dist/access/adminUser.js.map +1 -0
  7. package/dist/access/decideOnce.js +16 -0
  8. package/dist/access/decideOnce.js.map +1 -0
  9. package/dist/access/membership.d.ts +23 -0
  10. package/dist/access/membership.js +63 -0
  11. package/dist/access/membership.js.map +1 -0
  12. package/dist/access/principal.d.ts +37 -0
  13. package/dist/access/principal.js +29 -0
  14. package/dist/access/principal.js.map +1 -0
  15. package/dist/access/readGate.js +16 -0
  16. package/dist/access/readGate.js.map +1 -0
  17. package/dist/adapters/ga4/disableKey.js +7 -9
  18. package/dist/adapters/ga4/disableKey.js.map +1 -1
  19. package/dist/adapters/ga4/eventName.d.ts +2 -8
  20. package/dist/adapters/ga4/eventName.js +2 -8
  21. package/dist/adapters/ga4/eventName.js.map +1 -1
  22. package/dist/adapters/ga4/ga4.d.ts +11 -0
  23. package/dist/adapters/ga4/ga4.js +206 -123
  24. package/dist/adapters/ga4/ga4.js.map +1 -1
  25. package/dist/adapters/ga4/measurementId.js +2 -3
  26. package/dist/adapters/ga4/measurementId.js.map +1 -1
  27. package/dist/adapters/goalRead.js +15 -29
  28. package/dist/adapters/goalRead.js.map +1 -1
  29. package/dist/adapters/http/baseUrl.js +15 -0
  30. package/dist/adapters/http/baseUrl.js.map +1 -0
  31. package/dist/adapters/http/fetchJson.d.ts +19 -0
  32. package/dist/adapters/http/fetchJson.js +27 -8
  33. package/dist/adapters/http/fetchJson.js.map +1 -1
  34. package/dist/adapters/mapping.js +52 -0
  35. package/dist/adapters/mapping.js.map +1 -0
  36. package/dist/adapters/plausible/plausible.d.ts +13 -13
  37. package/dist/adapters/plausible/plausible.js +137 -122
  38. package/dist/adapters/plausible/plausible.js.map +1 -1
  39. package/dist/adapters/plausible/scriptId.js +19 -0
  40. package/dist/adapters/plausible/scriptId.js.map +1 -0
  41. package/dist/adapters/posthog/posthog.d.ts +20 -9
  42. package/dist/adapters/posthog/posthog.js +179 -113
  43. package/dist/adapters/posthog/posthog.js.map +1 -1
  44. package/dist/adapters/readTime.js +7 -0
  45. package/dist/adapters/readTime.js.map +1 -0
  46. package/dist/adapters/series.js +14 -8
  47. package/dist/adapters/series.js.map +1 -1
  48. package/dist/adapters/umami/umami.d.ts +7 -9
  49. package/dist/adapters/umami/umami.js +184 -172
  50. package/dist/adapters/umami/umami.js.map +1 -1
  51. package/dist/adapters/upstream.js +16 -0
  52. package/dist/adapters/upstream.js.map +1 -0
  53. package/dist/binding/report.d.ts +8 -0
  54. package/dist/binding/report.js +24 -0
  55. package/dist/binding/report.js.map +1 -0
  56. package/dist/binding/resolvePath.js +16 -29
  57. package/dist/binding/resolvePath.js.map +1 -1
  58. package/dist/binding/types.d.ts +14 -29
  59. package/dist/capture/captureRequest.js +28 -0
  60. package/dist/capture/captureRequest.js.map +1 -0
  61. package/dist/capture/exclusionEndpoint.js +98 -0
  62. package/dist/capture/exclusionEndpoint.js.map +1 -0
  63. package/dist/capture/exclusionPrelude.js +14 -0
  64. package/dist/capture/exclusionPrelude.js.map +1 -0
  65. package/dist/capture/exclusionToken.js +23 -0
  66. package/dist/capture/exclusionToken.js.map +1 -0
  67. package/dist/capture/jsLiteral.js +19 -0
  68. package/dist/capture/jsLiteral.js.map +1 -0
  69. package/dist/capture/mountPath.js +2 -3
  70. package/dist/capture/mountPath.js.map +1 -1
  71. package/dist/capture/proxyEndpoint.js +48 -95
  72. package/dist/capture/proxyEndpoint.js.map +1 -1
  73. package/dist/capture/proxyRoutes.js +58 -21
  74. package/dist/capture/proxyRoutes.js.map +1 -1
  75. package/dist/capture/relay.js +91 -0
  76. package/dist/capture/relay.js.map +1 -0
  77. package/dist/capture/requestBody.js +2 -6
  78. package/dist/capture/requestBody.js.map +1 -1
  79. package/dist/capture/requestTrust.js +45 -0
  80. package/dist/capture/requestTrust.js.map +1 -0
  81. package/dist/capture/sameSite.js +40 -0
  82. package/dist/capture/sameSite.js.map +1 -0
  83. package/dist/capture/slots.js +50 -25
  84. package/dist/capture/slots.js.map +1 -1
  85. package/dist/capture/trackerConfig.js +100 -36
  86. package/dist/capture/trackerConfig.js.map +1 -1
  87. package/dist/capture/trackerEndpoint.js +22 -21
  88. package/dist/capture/trackerEndpoint.js.map +1 -1
  89. package/dist/charts/BarList.d.ts +27 -14
  90. package/dist/charts/BarList.js +38 -83
  91. package/dist/charts/BarList.js.map +1 -1
  92. package/dist/charts/TrendChart.d.ts +40 -7
  93. package/dist/charts/TrendChart.js +243 -215
  94. package/dist/charts/TrendChart.js.map +1 -1
  95. package/dist/charts/bars.d.ts +15 -1
  96. package/dist/charts/bars.js +12 -12
  97. package/dist/charts/bars.js.map +1 -1
  98. package/dist/charts/bucket.js +106 -73
  99. package/dist/charts/bucket.js.map +1 -1
  100. package/dist/charts/inProgress.js +22 -0
  101. package/dist/charts/inProgress.js.map +1 -0
  102. package/dist/charts/series.d.ts +15 -0
  103. package/dist/charts/series.js +123 -0
  104. package/dist/charts/series.js.map +1 -0
  105. package/dist/charts/spline.js +91 -25
  106. package/dist/charts/spline.js.map +1 -1
  107. package/dist/charts/trendGeometry.js +91 -0
  108. package/dist/charts/trendGeometry.js.map +1 -0
  109. package/dist/core/adminOptions.d.ts +1 -0
  110. package/dist/core/adminOptions.js +193 -0
  111. package/dist/core/adminOptions.js.map +1 -0
  112. package/dist/core/budget.js +24 -0
  113. package/dist/core/budget.js.map +1 -0
  114. package/dist/core/cacheKey.d.ts +1 -0
  115. package/dist/core/cacheKey.js +48 -37
  116. package/dist/core/cacheKey.js.map +1 -1
  117. package/dist/core/cacheOptions.js +165 -0
  118. package/dist/core/cacheOptions.js.map +1 -0
  119. package/dist/core/capabilities.d.ts +24 -11
  120. package/dist/core/capabilities.js +96 -17
  121. package/dist/core/capabilities.js.map +1 -1
  122. package/dist/core/capture.d.ts +26 -25
  123. package/dist/core/captureOptions.d.ts +1 -0
  124. package/dist/core/captureOptions.js +258 -0
  125. package/dist/core/captureOptions.js.map +1 -0
  126. package/dist/core/clock.js +13 -0
  127. package/dist/core/clock.js.map +1 -0
  128. package/dist/core/collectionOption.d.ts +17 -0
  129. package/dist/core/collectionOption.js +104 -0
  130. package/dist/core/collectionOption.js.map +1 -0
  131. package/dist/core/collectionSlug.js +7 -0
  132. package/dist/core/collectionSlug.js.map +1 -0
  133. package/dist/core/contract.d.ts +285 -59
  134. package/dist/core/contract.js +6 -4
  135. package/dist/core/contract.js.map +1 -1
  136. package/dist/core/cron.js +57 -0
  137. package/dist/core/cron.js.map +1 -0
  138. package/dist/core/fetch.d.ts +17 -0
  139. package/dist/core/goalOptions.d.ts +1 -0
  140. package/dist/core/goalOptions.js +166 -0
  141. package/dist/core/goalOptions.js.map +1 -0
  142. package/dist/core/granularity.js +3 -2
  143. package/dist/core/granularity.js.map +1 -1
  144. package/dist/core/guards.js +17 -0
  145. package/dist/core/guards.js.map +1 -0
  146. package/dist/core/jobs.d.ts +40 -0
  147. package/dist/core/jobs.js +132 -0
  148. package/dist/core/jobs.js.map +1 -0
  149. package/dist/core/legacyOptions.js +145 -0
  150. package/dist/core/legacyOptions.js.map +1 -0
  151. package/dist/core/metricAliases.js +81 -0
  152. package/dist/core/metricAliases.js.map +1 -0
  153. package/dist/core/metricValues.js +57 -0
  154. package/dist/core/metricValues.js.map +1 -0
  155. package/dist/core/monotonic.js +10 -0
  156. package/dist/core/monotonic.js.map +1 -0
  157. package/dist/core/optionChecks.js +51 -0
  158. package/dist/core/optionChecks.js.map +1 -0
  159. package/dist/core/options.d.ts +473 -157
  160. package/dist/core/options.js +154 -219
  161. package/dist/core/options.js.map +1 -1
  162. package/dist/core/registry.js +45 -5
  163. package/dist/core/registry.js.map +1 -1
  164. package/dist/core/scopeList.js +7 -9
  165. package/dist/core/scopeList.js.map +1 -1
  166. package/dist/core/scopeOptions.d.ts +1 -0
  167. package/dist/core/scopeOptions.js +112 -0
  168. package/dist/core/scopeOptions.js.map +1 -0
  169. package/dist/core/scopedRead.js +182 -72
  170. package/dist/core/scopedRead.js.map +1 -1
  171. package/dist/core/sdks.d.ts +81 -0
  172. package/dist/core/sdks.js +23 -0
  173. package/dist/core/sdks.js.map +1 -0
  174. package/dist/core/serverEvent.d.ts +38 -20
  175. package/dist/core/serverEvent.js.map +1 -1
  176. package/dist/core/siteAddress.js +20 -0
  177. package/dist/core/siteAddress.js.map +1 -0
  178. package/dist/core/sourceErrors.js +109 -0
  179. package/dist/core/sourceErrors.js.map +1 -0
  180. package/dist/core/sourceOptions.js +94 -0
  181. package/dist/core/sourceOptions.js.map +1 -0
  182. package/dist/core/throttle.js +18 -0
  183. package/dist/core/throttle.js.map +1 -0
  184. package/dist/core/values.js +61 -0
  185. package/dist/core/values.js.map +1 -0
  186. package/dist/core/widgetSlugs.d.ts +17 -0
  187. package/dist/core/widgetSlugs.js +29 -0
  188. package/dist/core/widgetSlugs.js.map +1 -0
  189. package/dist/db/detachedWrite.js +36 -0
  190. package/dist/db/detachedWrite.js.map +1 -0
  191. package/dist/db/errors.js +182 -0
  192. package/dist/db/errors.js.map +1 -0
  193. package/dist/db/kind.js +32 -0
  194. package/dist/db/kind.js.map +1 -0
  195. package/dist/db/openTransaction.js +51 -0
  196. package/dist/db/openTransaction.js.map +1 -0
  197. package/dist/exports/adapters/contract.d.ts +14 -0
  198. package/dist/exports/adapters/ga4.d.ts +15 -1
  199. package/dist/exports/adapters/native.d.ts +26 -2
  200. package/dist/exports/adapters/native.js +4 -1
  201. package/dist/exports/adapters/plausible.d.ts +15 -1
  202. package/dist/exports/adapters/posthog.d.ts +15 -1
  203. package/dist/exports/adapters/umami.d.ts +15 -1
  204. package/dist/exports/attributes.d.ts +42 -0
  205. package/dist/exports/attributes.js +83 -0
  206. package/dist/exports/attributes.js.map +1 -0
  207. package/dist/exports/client.d.ts +41 -13
  208. package/dist/exports/client.js +21 -9
  209. package/dist/exports/geo.d.ts +3 -1
  210. package/dist/exports/geo.js +1 -1
  211. package/dist/exports/i18n.d.ts +2 -2
  212. package/dist/exports/i18n.js +2 -2
  213. package/dist/exports/migrations.d.ts +2 -0
  214. package/dist/exports/migrations.js +2 -0
  215. package/dist/exports/next.d.ts +18 -1
  216. package/dist/exports/next.js +3 -1
  217. package/dist/exports/react.d.ts +3 -2
  218. package/dist/exports/react.js +1 -2
  219. package/dist/exports/rsc.d.ts +31 -14
  220. package/dist/exports/rsc.js +11 -6
  221. package/dist/exports/site.d.ts +5 -0
  222. package/dist/exports/site.js +3 -0
  223. package/dist/exports/testing.d.ts +17 -0
  224. package/dist/exports/testing.js +3 -0
  225. package/dist/exports/tracker.d.ts +5 -20
  226. package/dist/exports/tracker.js +3 -14
  227. package/dist/exports/types.d.ts +40 -14
  228. package/dist/exports/types.js +5 -1
  229. package/dist/fields/AnalyticsPanelClient.js +265 -154
  230. package/dist/fields/AnalyticsPanelClient.js.map +1 -1
  231. package/dist/fields/AnalyticsPanelField.d.ts +20 -8
  232. package/dist/fields/AnalyticsPanelField.js +121 -30
  233. package/dist/fields/AnalyticsPanelField.js.map +1 -1
  234. package/dist/fields/AnalyticsStatField.d.ts +18 -7
  235. package/dist/fields/AnalyticsStatField.js +98 -63
  236. package/dist/fields/AnalyticsStatField.js.map +1 -1
  237. package/dist/fields/FieldShimmer.js +15 -0
  238. package/dist/fields/FieldShimmer.js.map +1 -0
  239. package/dist/fields/PanelContent.js +217 -0
  240. package/dist/fields/PanelContent.js.map +1 -0
  241. package/dist/fields/PanelList.js +82 -0
  242. package/dist/fields/PanelList.js.map +1 -0
  243. package/dist/fields/PanelLiveCounter.js +63 -0
  244. package/dist/fields/PanelLiveCounter.js.map +1 -0
  245. package/dist/fields/PanelSkeleton.js +63 -0
  246. package/dist/fields/PanelSkeleton.js.map +1 -0
  247. package/dist/fields/componentPaths.js +8 -0
  248. package/dist/fields/componentPaths.js.map +1 -0
  249. package/dist/fields/config/FilterDimensionSelectField.d.ts +2 -2
  250. package/dist/fields/config/FilterDimensionSelectField.js +26 -54
  251. package/dist/fields/config/FilterDimensionSelectField.js.map +1 -1
  252. package/dist/fields/config/FilterKeySelect.js +66 -0
  253. package/dist/fields/config/FilterKeySelect.js.map +1 -0
  254. package/dist/fields/config/FilterOperatorSelectField.d.ts +7 -2
  255. package/dist/fields/config/FilterOperatorSelectField.js +37 -53
  256. package/dist/fields/config/FilterOperatorSelectField.js.map +1 -1
  257. package/dist/fields/config/FilterValueField.d.ts +17 -0
  258. package/dist/fields/config/FilterValueField.js +130 -0
  259. package/dist/fields/config/FilterValueField.js.map +1 -0
  260. package/dist/fields/config/MetricSelectField.d.ts +5 -12
  261. package/dist/fields/config/MetricSelectField.js +18 -30
  262. package/dist/fields/config/MetricSelectField.js.map +1 -1
  263. package/dist/fields/config/OptionSelect.js +52 -0
  264. package/dist/fields/config/OptionSelect.js.map +1 -0
  265. package/dist/fields/config/SourceSelectField.js +16 -31
  266. package/dist/fields/config/SourceSelectField.js.map +1 -1
  267. package/dist/fields/config/fetchSources.js +14 -26
  268. package/dist/fields/config/fetchSources.js.map +1 -1
  269. package/dist/fields/config/filterValues.js +106 -0
  270. package/dist/fields/config/filterValues.js.map +1 -0
  271. package/dist/fields/config/narrow.js +8 -10
  272. package/dist/fields/config/narrow.js.map +1 -1
  273. package/dist/fields/config/retiredPickers.d.ts +45 -0
  274. package/dist/fields/config/retiredPickers.js +46 -0
  275. package/dist/fields/config/retiredPickers.js.map +1 -0
  276. package/dist/fields/config/scopedFields.d.ts +40 -0
  277. package/dist/fields/config/scopedFields.js +68 -0
  278. package/dist/fields/config/scopedFields.js.map +1 -0
  279. package/dist/fields/config/toSelectOption.js +13 -7
  280. package/dist/fields/config/toSelectOption.js.map +1 -1
  281. package/dist/fields/config/useAnalyticsSources.d.ts +5 -7
  282. package/dist/fields/config/useAnalyticsSources.js +17 -21
  283. package/dist/fields/config/useAnalyticsSources.js.map +1 -1
  284. package/dist/fields/config/useFilterCapabilities.d.ts +9 -6
  285. package/dist/fields/config/useFilterCapabilities.js +23 -15
  286. package/dist/fields/config/useFilterCapabilities.js.map +1 -1
  287. package/dist/fields/config/useFormString.js +12 -0
  288. package/dist/fields/config/useFormString.js.map +1 -0
  289. package/dist/fields/dateRange/field.js +7 -19
  290. package/dist/fields/dateRange/field.js.map +1 -1
  291. package/dist/fields/dateRange/types.d.ts +5 -1
  292. package/dist/fields/dateRange/ui.d.ts +3 -2
  293. package/dist/fields/dateRange/ui.js +57 -319
  294. package/dist/fields/dateRange/ui.js.map +1 -1
  295. package/dist/fields/documentScope.js +21 -0
  296. package/dist/fields/documentScope.js.map +1 -0
  297. package/dist/fields/emptyState.js +31 -26
  298. package/dist/fields/emptyState.js.map +1 -1
  299. package/dist/fields/factories.d.ts +35 -16
  300. package/dist/fields/factories.js +66 -37
  301. package/dist/fields/factories.js.map +1 -1
  302. package/dist/fields/format.d.ts +12 -3
  303. package/dist/fields/format.js +77 -13
  304. package/dist/fields/format.js.map +1 -1
  305. package/dist/fields/itemReport.js +45 -0
  306. package/dist/fields/itemReport.js.map +1 -0
  307. package/dist/fields/readForDocument.d.ts +78 -26
  308. package/dist/fields/readForDocument.js +446 -116
  309. package/dist/fields/readForDocument.js.map +1 -1
  310. package/dist/fields/stateKeys.js +20 -0
  311. package/dist/fields/stateKeys.js.map +1 -0
  312. package/dist/goals/GoalAmountField.d.ts +10 -0
  313. package/dist/goals/GoalAmountField.js +162 -0
  314. package/dist/goals/GoalAmountField.js.map +1 -0
  315. package/dist/goals/GoalSelectField.js +89 -40
  316. package/dist/goals/GoalSelectField.js.map +1 -1
  317. package/dist/goals/GoalSelectFieldServer.d.ts +13 -0
  318. package/dist/goals/GoalSelectFieldServer.js +21 -0
  319. package/dist/goals/GoalSelectFieldServer.js.map +1 -0
  320. package/dist/goals/amountField.d.ts +20 -0
  321. package/dist/goals/amountField.js +37 -0
  322. package/dist/goals/amountField.js.map +1 -0
  323. package/dist/goals/builtin.js +17 -0
  324. package/dist/goals/builtin.js.map +1 -0
  325. package/dist/goals/collection.d.ts +22 -0
  326. package/dist/goals/collection.js +141 -100
  327. package/dist/goals/collection.js.map +1 -1
  328. package/dist/goals/constants.d.ts +38 -0
  329. package/dist/goals/constants.js +49 -0
  330. package/dist/goals/constants.js.map +1 -0
  331. package/dist/goals/currency.d.ts +16 -0
  332. package/dist/goals/currency.js +46 -4
  333. package/dist/goals/currency.js.map +1 -1
  334. package/dist/goals/currencyOptions.js +70 -0
  335. package/dist/goals/currencyOptions.js.map +1 -0
  336. package/dist/goals/fetchGoals.d.ts +10 -0
  337. package/dist/goals/fetchGoals.js +12 -26
  338. package/dist/goals/fetchGoals.js.map +1 -1
  339. package/dist/goals/goalField.d.ts +4 -6
  340. package/dist/goals/goalField.js +9 -19
  341. package/dist/goals/goalField.js.map +1 -1
  342. package/dist/goals/goalsEndpoint.js +39 -40
  343. package/dist/goals/goalsEndpoint.js.map +1 -1
  344. package/dist/goals/items.js +35 -0
  345. package/dist/goals/items.js.map +1 -0
  346. package/dist/goals/latent.js +9 -0
  347. package/dist/goals/latent.js.map +1 -0
  348. package/dist/goals/linkFields.d.ts +35 -0
  349. package/dist/goals/linkFields.js +31 -0
  350. package/dist/goals/linkFields.js.map +1 -0
  351. package/dist/goals/match.d.ts +14 -0
  352. package/dist/goals/match.js +67 -46
  353. package/dist/goals/match.js.map +1 -1
  354. package/dist/goals/moneyFields.js +56 -0
  355. package/dist/goals/moneyFields.js.map +1 -0
  356. package/dist/goals/pathMatch.js +122 -0
  357. package/dist/goals/pathMatch.js.map +1 -0
  358. package/dist/goals/placeholder.js +12 -0
  359. package/dist/goals/placeholder.js.map +1 -0
  360. package/dist/goals/resolver.d.ts +3 -3
  361. package/dist/goals/resolver.js +154 -46
  362. package/dist/goals/resolver.js.map +1 -1
  363. package/dist/goals/serverRevenue.d.ts +60 -0
  364. package/dist/goals/serverRevenue.js +41 -0
  365. package/dist/goals/serverRevenue.js.map +1 -0
  366. package/dist/goals/trackGoalAction.d.ts +26 -27
  367. package/dist/goals/trackGoalAction.js +38 -52
  368. package/dist/goals/trackGoalAction.js.map +1 -1
  369. package/dist/goals/types.d.ts +13 -28
  370. package/dist/goals/types.js +1 -1
  371. package/dist/goals/types.js.map +1 -1
  372. package/dist/goals/useAnalyticsGoals.d.ts +6 -5
  373. package/dist/goals/useAnalyticsGoals.js +17 -18
  374. package/dist/goals/useAnalyticsGoals.js.map +1 -1
  375. package/dist/index.d.ts +63 -11
  376. package/dist/index.js +257 -247
  377. package/dist/index.js.map +1 -1
  378. package/dist/items/collectionIdType.js +20 -0
  379. package/dist/items/collectionIdType.js.map +1 -0
  380. package/dist/items/idType.js +31 -0
  381. package/dist/items/idType.js.map +1 -0
  382. package/dist/items/ref.js +73 -0
  383. package/dist/items/ref.js.map +1 -0
  384. package/dist/maintenance/apiTaskState.js +141 -0
  385. package/dist/maintenance/apiTaskState.js.map +1 -0
  386. package/dist/maintenance/heartbeat.js +51 -0
  387. package/dist/maintenance/heartbeat.js.map +1 -0
  388. package/dist/maintenance/lease.d.ts +1 -0
  389. package/dist/maintenance/lease.js +81 -0
  390. package/dist/maintenance/lease.js.map +1 -0
  391. package/dist/maintenance/taskSchedule.d.ts +1 -0
  392. package/dist/maintenance/taskSchedule.js +62 -0
  393. package/dist/maintenance/taskSchedule.js.map +1 -0
  394. package/dist/maintenance/underLease.js +35 -0
  395. package/dist/maintenance/underLease.js.map +1 -0
  396. package/dist/migrations/legacy.d.ts +54 -0
  397. package/dist/migrations/legacy.js +117 -0
  398. package/dist/migrations/legacy.js.map +1 -0
  399. package/dist/migrations/predefined/dropLegacyMongo.d.ts +11 -0
  400. package/dist/migrations/predefined/dropLegacyMongo.js +12 -0
  401. package/dist/migrations/predefined/dropLegacyMongo.js.map +1 -0
  402. package/dist/native/collections/aggregates.js +54 -0
  403. package/dist/native/collections/aggregates.js.map +1 -0
  404. package/dist/native/collections/hits.js +102 -0
  405. package/dist/native/collections/hits.js.map +1 -0
  406. package/dist/native/collections/slugs.d.ts +10 -0
  407. package/dist/native/collections/slugs.js +16 -0
  408. package/dist/native/collections/slugs.js.map +1 -0
  409. package/dist/native/collections/state.js +84 -0
  410. package/dist/native/collections/state.js.map +1 -0
  411. package/dist/native/collections/storeCollection.js +29 -0
  412. package/dist/native/collections/storeCollection.js.map +1 -0
  413. package/dist/native/engine/buckets.d.ts +1 -0
  414. package/dist/native/engine/buckets.js +53 -0
  415. package/dist/native/engine/buckets.js.map +1 -0
  416. package/dist/native/engine/capabilities.js +87 -0
  417. package/dist/native/engine/capabilities.js.map +1 -0
  418. package/dist/native/engine/cost.js +72 -0
  419. package/dist/native/engine/cost.js.map +1 -0
  420. package/dist/native/engine/days.d.ts +1 -0
  421. package/dist/native/engine/days.js +182 -0
  422. package/dist/native/engine/days.js.map +1 -0
  423. package/dist/native/engine/engine.d.ts +1 -0
  424. package/dist/native/engine/engine.js +1623 -0
  425. package/dist/native/engine/engine.js.map +1 -0
  426. package/dist/native/engine/instance.js +58 -0
  427. package/dist/native/engine/instance.js.map +1 -0
  428. package/dist/native/engine/maintenance.d.ts +1 -0
  429. package/dist/native/engine/maintenance.js +677 -0
  430. package/dist/native/engine/maintenance.js.map +1 -0
  431. package/dist/native/engine/merge.js +41 -0
  432. package/dist/native/engine/merge.js.map +1 -0
  433. package/dist/native/engine/nudge.js +26 -0
  434. package/dist/native/engine/nudge.js.map +1 -0
  435. package/dist/native/engine/planner.js +198 -0
  436. package/dist/native/engine/planner.js.map +1 -0
  437. package/dist/native/engine/rebuild.d.ts +22 -0
  438. package/dist/native/engine/rebuild.js +76 -0
  439. package/dist/native/engine/rebuild.js.map +1 -0
  440. package/dist/native/engine/recent.js +17 -0
  441. package/dist/native/engine/recent.js.map +1 -0
  442. package/dist/native/engine/salt.d.ts +1 -0
  443. package/dist/native/engine/salt.js +98 -0
  444. package/dist/native/engine/salt.js.map +1 -0
  445. package/dist/native/engine/siteHosts.d.ts +1 -0
  446. package/dist/native/engine/siteHosts.js +58 -0
  447. package/dist/native/engine/siteHosts.js.map +1 -0
  448. package/dist/native/engine/toHit.js +108 -0
  449. package/dist/native/engine/toHit.js.map +1 -0
  450. package/dist/native/engine/writeBuffer.d.ts +14 -0
  451. package/dist/native/engine/writeBuffer.js +317 -0
  452. package/dist/native/engine/writeBuffer.js.map +1 -0
  453. package/dist/native/geo/composeGeoResolvers.d.ts +1 -0
  454. package/dist/native/geo/composeGeoResolvers.js +4 -1
  455. package/dist/native/geo/composeGeoResolvers.js.map +1 -1
  456. package/dist/native/geo/geoResolver.d.ts +20 -2
  457. package/dist/native/geo/geoResolver.js +42 -6
  458. package/dist/native/geo/geoResolver.js.map +1 -1
  459. package/dist/native/geo/maxmindResolver.d.ts +8 -4
  460. package/dist/native/geo/maxmindResolver.js +20 -16
  461. package/dist/native/geo/maxmindResolver.js.map +1 -1
  462. package/dist/native/geo/resolveGeo.js +31 -0
  463. package/dist/native/geo/resolveGeo.js.map +1 -0
  464. package/dist/native/ingest/bots.d.ts +2 -3
  465. package/dist/native/ingest/bots.js +8 -13
  466. package/dist/native/ingest/bots.js.map +1 -1
  467. package/dist/native/ingest/browser.js +4 -6
  468. package/dist/native/ingest/browser.js.map +1 -1
  469. package/dist/native/ingest/clientIp.js +30 -9
  470. package/dist/native/ingest/clientIp.js.map +1 -1
  471. package/dist/native/ingest/device.js +4 -6
  472. package/dist/native/ingest/device.js.map +1 -1
  473. package/dist/native/ingest/endpoint.d.ts +1 -1
  474. package/dist/native/ingest/endpoint.js +119 -34
  475. package/dist/native/ingest/endpoint.js.map +1 -1
  476. package/dist/native/ingest/itemSignature.d.ts +26 -0
  477. package/dist/native/ingest/itemSignature.js +45 -0
  478. package/dist/native/ingest/itemSignature.js.map +1 -0
  479. package/dist/native/ingest/language.js +2 -3
  480. package/dist/native/ingest/language.js.map +1 -1
  481. package/dist/native/ingest/normalizeEvent.d.ts +60 -7
  482. package/dist/native/ingest/normalizeEvent.js +226 -61
  483. package/dist/native/ingest/normalizeEvent.js.map +1 -1
  484. package/dist/native/ingest/orderSignature.d.ts +13 -0
  485. package/dist/native/ingest/orderSignature.js +50 -0
  486. package/dist/native/ingest/orderSignature.js.map +1 -0
  487. package/dist/native/ingest/referrer.js +30 -32
  488. package/dist/native/ingest/referrer.js.map +1 -1
  489. package/dist/native/ingest/requestHost.js +10 -23
  490. package/dist/native/ingest/requestHost.js.map +1 -1
  491. package/dist/native/ingest/resolveHostname.d.ts +4 -13
  492. package/dist/native/ingest/resolveHostname.js +5 -6
  493. package/dist/native/ingest/resolveHostname.js.map +1 -1
  494. package/dist/native/ingest/revenue.d.ts +1 -0
  495. package/dist/native/ingest/revenue.js +121 -0
  496. package/dist/native/ingest/revenue.js.map +1 -0
  497. package/dist/native/ingest/route.d.ts +10 -0
  498. package/dist/native/ingest/route.js +82 -0
  499. package/dist/native/ingest/route.js.map +1 -0
  500. package/dist/native/ingest/serverTrack.d.ts +2 -10
  501. package/dist/native/ingest/serverTrack.js +181 -72
  502. package/dist/native/ingest/serverTrack.js.map +1 -1
  503. package/dist/native/ingest/signature.js +28 -0
  504. package/dist/native/ingest/signature.js.map +1 -0
  505. package/dist/native/ingest/source.d.ts +2 -3
  506. package/dist/native/ingest/source.js +35 -54
  507. package/dist/native/ingest/source.js.map +1 -1
  508. package/dist/native/ingest/utm.js +9 -9
  509. package/dist/native/ingest/utm.js.map +1 -1
  510. package/dist/native/ingest/validate.js +20 -10
  511. package/dist/native/ingest/validate.js.map +1 -1
  512. package/dist/native/ingest/visitorHash.js +6 -8
  513. package/dist/native/ingest/visitorHash.js.map +1 -1
  514. package/dist/native/nativeAdapter.d.ts +101 -33
  515. package/dist/native/nativeAdapter.js +375 -317
  516. package/dist/native/nativeAdapter.js.map +1 -1
  517. package/dist/native/rebuildDays.d.ts +12 -0
  518. package/dist/native/rebuildDays.js +16 -0
  519. package/dist/native/rebuildDays.js.map +1 -0
  520. package/dist/native/store/aggregate.js +450 -0
  521. package/dist/native/store/aggregate.js.map +1 -0
  522. package/dist/native/store/caps.d.ts +18 -0
  523. package/dist/native/store/caps.js +76 -0
  524. package/dist/native/store/caps.js.map +1 -0
  525. package/dist/native/store/chunks.js +34 -0
  526. package/dist/native/store/chunks.js.map +1 -0
  527. package/dist/native/store/columnValues.js +31 -0
  528. package/dist/native/store/columnValues.js.map +1 -0
  529. package/dist/native/store/dialect.js +106 -0
  530. package/dist/native/store/dialect.js.map +1 -0
  531. package/dist/native/store/eventStore.js +44 -0
  532. package/dist/native/store/eventStore.js.map +1 -0
  533. package/dist/native/store/hitRow.js +116 -0
  534. package/dist/native/store/hitRow.js.map +1 -0
  535. package/dist/native/store/hits.js +63 -0
  536. package/dist/native/store/hits.js.map +1 -0
  537. package/dist/native/store/ids.js +105 -0
  538. package/dist/native/store/ids.js.map +1 -0
  539. package/dist/native/store/mongo/aggregatePipelines.js +430 -0
  540. package/dist/native/store/mongo/aggregatePipelines.js.map +1 -0
  541. package/dist/native/store/mongo/mongoState.js +375 -0
  542. package/dist/native/store/mongo/mongoState.js.map +1 -0
  543. package/dist/native/store/mongo/mongoStore.js +618 -0
  544. package/dist/native/store/mongo/mongoStore.js.map +1 -0
  545. package/dist/native/store/mongo/pipelines.js +695 -0
  546. package/dist/native/store/mongo/pipelines.js.map +1 -0
  547. package/dist/native/store/mongo/results.js +20 -0
  548. package/dist/native/store/mongo/results.js.map +1 -0
  549. package/dist/native/store/parts.d.ts +1 -0
  550. package/dist/native/store/parts.js +95 -0
  551. package/dist/native/store/parts.js.map +1 -0
  552. package/dist/native/store/pattern.js +213 -0
  553. package/dist/native/store/pattern.js.map +1 -0
  554. package/dist/native/store/rawRead.d.ts +23 -0
  555. package/dist/native/store/rawRead.js +384 -0
  556. package/dist/native/store/rawRead.js.map +1 -0
  557. package/dist/native/store/reclassify.js +53 -0
  558. package/dist/native/store/reclassify.js.map +1 -0
  559. package/dist/native/store/sql/aggregateSql.js +345 -0
  560. package/dist/native/store/sql/aggregateSql.js.map +1 -0
  561. package/dist/native/store/sql/columns.js +48 -0
  562. package/dist/native/store/sql/columns.js.map +1 -0
  563. package/dist/native/store/sql/compile.js +656 -0
  564. package/dist/native/store/sql/compile.js.map +1 -0
  565. package/dist/native/store/sql/drivers.js +218 -0
  566. package/dist/native/store/sql/drivers.js.map +1 -0
  567. package/dist/native/store/sql/executor.js +132 -0
  568. package/dist/native/store/sql/executor.js.map +1 -0
  569. package/dist/native/store/sql/fragment.js +104 -0
  570. package/dist/native/store/sql/fragment.js.map +1 -0
  571. package/dist/native/store/sql/maintenanceSql.js +59 -0
  572. package/dist/native/store/sql/maintenanceSql.js.map +1 -0
  573. package/dist/native/store/sql/ownConnection.js +107 -0
  574. package/dist/native/store/sql/ownConnection.js.map +1 -0
  575. package/dist/native/store/sql/poolShare.js +101 -0
  576. package/dist/native/store/sql/poolShare.js.map +1 -0
  577. package/dist/native/store/sql/sqlState.js +325 -0
  578. package/dist/native/store/sql/sqlState.js.map +1 -0
  579. package/dist/native/store/sql/sqlStore.js +355 -0
  580. package/dist/native/store/sql/sqlStore.js.map +1 -0
  581. package/dist/native/store/sql/sqliteThread.d.ts +9 -0
  582. package/dist/native/store/sql/sqliteThread.js +314 -0
  583. package/dist/native/store/sql/sqliteThread.js.map +1 -0
  584. package/dist/native/store/sql/sqliteWorker.js +327 -0
  585. package/dist/native/store/sql/sqliteWorker.js.map +1 -0
  586. package/dist/native/store/sql/sqliteWorkerSource.js +347 -0
  587. package/dist/native/store/sql/sqliteWorkerSource.js.map +1 -0
  588. package/dist/native/store/state.js +151 -0
  589. package/dist/native/store/state.js.map +1 -0
  590. package/dist/native/store/stateStore.js +29 -0
  591. package/dist/native/store/stateStore.js.map +1 -0
  592. package/dist/native/store/types.d.ts +9 -0
  593. package/dist/native/tasks/maintainTask.d.ts +19 -0
  594. package/dist/native/tasks/maintainTask.js +68 -0
  595. package/dist/native/tasks/maintainTask.js.map +1 -0
  596. package/dist/net/guardedFetch.d.ts +32 -0
  597. package/dist/net/guardedFetch.js +220 -0
  598. package/dist/net/guardedFetch.js.map +1 -0
  599. package/dist/net/origin.js +40 -0
  600. package/dist/net/origin.js.map +1 -0
  601. package/dist/net/platform.d.ts +9 -0
  602. package/dist/net/platform.js +35 -0
  603. package/dist/net/platform.js.map +1 -0
  604. package/dist/next/captureRewrites.d.ts +4 -24
  605. package/dist/next/captureRewrites.js +6 -50
  606. package/dist/next/captureRewrites.js.map +1 -1
  607. package/dist/next/captureRoute.d.ts +28 -0
  608. package/dist/next/captureRoute.js +67 -0
  609. package/dist/next/captureRoute.js.map +1 -0
  610. package/dist/next/ingestRoute.d.ts +17 -0
  611. package/dist/next/ingestRoute.js +17 -0
  612. package/dist/next/ingestRoute.js.map +1 -0
  613. package/dist/next/posthogProxyRewrites.d.ts +3 -25
  614. package/dist/next/posthogProxyRewrites.js +5 -37
  615. package/dist/next/posthogProxyRewrites.js.map +1 -1
  616. package/dist/plugin/adminDependencies.js +34 -0
  617. package/dist/plugin/adminDependencies.js.map +1 -0
  618. package/dist/plugin/apiPath.js +23 -0
  619. package/dist/plugin/apiPath.js.map +1 -0
  620. package/dist/plugin/boundDocument.js +58 -0
  621. package/dist/plugin/boundDocument.js.map +1 -0
  622. package/dist/plugin/buildPhase.js +10 -0
  623. package/dist/plugin/buildPhase.js.map +1 -0
  624. package/dist/plugin/collectionChecks.js +232 -0
  625. package/dist/plugin/collectionChecks.js.map +1 -0
  626. package/dist/plugin/collectionFields.d.ts +13 -0
  627. package/dist/plugin/collectionFields.js +22 -0
  628. package/dist/plugin/collectionFields.js.map +1 -0
  629. package/dist/plugin/createRuntime.js +336 -0
  630. package/dist/plugin/createRuntime.js.map +1 -0
  631. package/dist/plugin/destroy.js +58 -0
  632. package/dist/plugin/destroy.js.map +1 -0
  633. package/dist/plugin/documentEndpoint.js +76 -53
  634. package/dist/plugin/documentEndpoint.js.map +1 -1
  635. package/dist/plugin/documentScopes.js +37 -0
  636. package/dist/plugin/documentScopes.js.map +1 -0
  637. package/dist/plugin/encrypted.js +25 -0
  638. package/dist/plugin/encrypted.js.map +1 -0
  639. package/dist/plugin/errors.d.ts +5 -12
  640. package/dist/plugin/errors.js +23 -16
  641. package/dist/plugin/errors.js.map +1 -1
  642. package/dist/plugin/flagsEndpoint.js +41 -0
  643. package/dist/plugin/flagsEndpoint.js.map +1 -0
  644. package/dist/plugin/goalHint.js +22 -11
  645. package/dist/plugin/goalHint.js.map +1 -1
  646. package/dist/plugin/itemLabels.js +114 -0
  647. package/dist/plugin/itemLabels.js.map +1 -0
  648. package/dist/plugin/jobsAccess.js +91 -0
  649. package/dist/plugin/jobsAccess.js.map +1 -0
  650. package/dist/plugin/keepAlive.js +48 -0
  651. package/dist/plugin/keepAlive.js.map +1 -0
  652. package/dist/plugin/peerImportError.js +3 -6
  653. package/dist/plugin/peerImportError.js.map +1 -1
  654. package/dist/plugin/peers.js +64 -0
  655. package/dist/plugin/peers.js.map +1 -0
  656. package/dist/plugin/pluginCollections.js +155 -0
  657. package/dist/plugin/pluginCollections.js.map +1 -0
  658. package/dist/plugin/queryEndpoint.js +69 -44
  659. package/dist/plugin/queryEndpoint.js.map +1 -1
  660. package/dist/plugin/queryParams.js +7 -0
  661. package/dist/plugin/queryParams.js.map +1 -0
  662. package/dist/plugin/readContextForRequest.js +52 -17
  663. package/dist/plugin/readContextForRequest.js.map +1 -1
  664. package/dist/plugin/readFailure.js +22 -0
  665. package/dist/plugin/readFailure.js.map +1 -0
  666. package/dist/plugin/readableProviders.js +64 -0
  667. package/dist/plugin/readableProviders.js.map +1 -0
  668. package/dist/plugin/realtimeEndpoint.js +77 -25
  669. package/dist/plugin/realtimeEndpoint.js.map +1 -1
  670. package/dist/plugin/refreshEndpoint.js +69 -44
  671. package/dist/plugin/refreshEndpoint.js.map +1 -1
  672. package/dist/plugin/relabelFields.js +36 -0
  673. package/dist/plugin/relabelFields.js.map +1 -0
  674. package/dist/plugin/requestMemo.js +35 -0
  675. package/dist/plugin/requestMemo.js.map +1 -0
  676. package/dist/plugin/routeChecks.js +39 -0
  677. package/dist/plugin/routeChecks.js.map +1 -0
  678. package/dist/plugin/routes.d.ts +53 -0
  679. package/dist/plugin/routes.js +92 -0
  680. package/dist/plugin/routes.js.map +1 -0
  681. package/dist/plugin/runtime.d.ts +1 -1
  682. package/dist/plugin/runtime.js +226 -30
  683. package/dist/plugin/runtime.js.map +1 -1
  684. package/dist/plugin/schemaOnly.js +63 -0
  685. package/dist/plugin/schemaOnly.js.map +1 -0
  686. package/dist/plugin/scopeChange.js +6 -5
  687. package/dist/plugin/scopeChange.js.map +1 -1
  688. package/dist/plugin/scopeFieldBoot.js +4 -4
  689. package/dist/plugin/scopeFieldBoot.js.map +1 -1
  690. package/dist/plugin/scopeToken.js +33 -0
  691. package/dist/plugin/scopeToken.js.map +1 -0
  692. package/dist/plugin/sourcesEndpoint.js +46 -12
  693. package/dist/plugin/sourcesEndpoint.js.map +1 -1
  694. package/dist/plugin/unbundledLanguages.js +25 -0
  695. package/dist/plugin/unbundledLanguages.js.map +1 -0
  696. package/dist/plugin/walkFields.js +22 -0
  697. package/dist/plugin/walkFields.js.map +1 -0
  698. package/dist/plugin/warmTask.js +0 -0
  699. package/dist/plugin/warmTask.js.map +1 -1
  700. package/dist/providers/access.d.ts +1 -0
  701. package/dist/providers/access.js +35 -26
  702. package/dist/providers/access.js.map +1 -1
  703. package/dist/providers/adapterPool.js +121 -0
  704. package/dist/providers/adapterPool.js.map +1 -0
  705. package/dist/providers/collection.d.ts +53 -0
  706. package/dist/providers/collection.js +274 -150
  707. package/dist/providers/collection.js.map +1 -1
  708. package/dist/providers/factory.d.ts +76 -0
  709. package/dist/providers/factory.js +76 -23
  710. package/dist/providers/factory.js.map +1 -1
  711. package/dist/providers/hosts.d.ts +25 -0
  712. package/dist/providers/hosts.js +128 -0
  713. package/dist/providers/hosts.js.map +1 -0
  714. package/dist/providers/probe.d.ts +1 -0
  715. package/dist/providers/probe.js +101 -0
  716. package/dist/providers/probe.js.map +1 -0
  717. package/dist/providers/refresh.d.ts +18 -0
  718. package/dist/providers/refresh.js +49 -0
  719. package/dist/providers/refresh.js.map +1 -0
  720. package/dist/providers/registry.js +318 -0
  721. package/dist/providers/registry.js.map +1 -0
  722. package/dist/providers/resolver.js +23 -88
  723. package/dist/providers/resolver.js.map +1 -1
  724. package/dist/providers/retarget.js +45 -0
  725. package/dist/providers/retarget.js.map +1 -0
  726. package/dist/providers/secrets.d.ts +26 -0
  727. package/dist/providers/secrets.js +61 -4
  728. package/dist/providers/secrets.js.map +1 -1
  729. package/dist/providers/stampScope.js +9 -6
  730. package/dist/providers/stampScope.js.map +1 -1
  731. package/dist/query/dates.js +10 -12
  732. package/dist/query/dates.js.map +1 -1
  733. package/dist/query/errors.d.ts +1 -5
  734. package/dist/query/fetchQuery.d.ts +25 -32
  735. package/dist/query/fetchQuery.js +91 -91
  736. package/dist/query/fetchQuery.js.map +1 -1
  737. package/dist/query/limits.js +8 -0
  738. package/dist/query/limits.js.map +1 -0
  739. package/dist/query/parse.d.ts +6 -0
  740. package/dist/query/parse.js +153 -106
  741. package/dist/query/parse.js.map +1 -1
  742. package/dist/query/response.d.ts +23 -3
  743. package/dist/query/response.js +12 -5
  744. package/dist/query/response.js.map +1 -1
  745. package/dist/react/AnalyticsProvider.d.ts +26 -17
  746. package/dist/react/AnalyticsProvider.js +23 -22
  747. package/dist/react/AnalyticsProvider.js.map +1 -1
  748. package/dist/react/TrackerBoot.js +15 -9
  749. package/dist/react/TrackerBoot.js.map +1 -1
  750. package/dist/react/useAnalytics.d.ts +2 -11
  751. package/dist/react/useAnalytics.js +22 -24
  752. package/dist/react/useAnalytics.js.map +1 -1
  753. package/dist/site/AnalyticsScripts.d.ts +34 -0
  754. package/dist/site/AnalyticsScripts.js +30 -0
  755. package/dist/site/AnalyticsScripts.js.map +1 -0
  756. package/dist/site/getTrackerConfig.d.ts +15 -0
  757. package/dist/site/getTrackerConfig.js +40 -0
  758. package/dist/site/getTrackerConfig.js.map +1 -0
  759. package/dist/surfacing/afterRead.d.ts +37 -0
  760. package/dist/surfacing/bounded.js +38 -0
  761. package/dist/surfacing/bounded.js.map +1 -0
  762. package/dist/surfacing/breaker.js +107 -0
  763. package/dist/surfacing/breaker.js.map +1 -0
  764. package/dist/surfacing/cacheCollection.d.ts +8 -0
  765. package/dist/surfacing/cacheCollection.js +69 -0
  766. package/dist/surfacing/cacheCollection.js.map +1 -0
  767. package/dist/surfacing/cacheStore.d.ts +71 -1
  768. package/dist/surfacing/cacheStore.js +16 -37
  769. package/dist/surfacing/cacheStore.js.map +1 -1
  770. package/dist/surfacing/cacheSweep.d.ts +1 -0
  771. package/dist/surfacing/cacheSweep.js +59 -0
  772. package/dist/surfacing/cacheSweep.js.map +1 -0
  773. package/dist/surfacing/classifyError.js +282 -0
  774. package/dist/surfacing/classifyError.js.map +1 -0
  775. package/dist/surfacing/coalesce.js +2 -1
  776. package/dist/surfacing/coalesce.js.map +1 -1
  777. package/dist/surfacing/coldBudget.js +60 -0
  778. package/dist/surfacing/coldBudget.js.map +1 -0
  779. package/dist/surfacing/collectionCacheStore.js +183 -0
  780. package/dist/surfacing/collectionCacheStore.js.map +1 -0
  781. package/dist/surfacing/engine.d.ts +1 -1
  782. package/dist/surfacing/engine.js +514 -72
  783. package/dist/surfacing/engine.js.map +1 -1
  784. package/dist/surfacing/epoch.js +70 -26
  785. package/dist/surfacing/epoch.js.map +1 -1
  786. package/dist/surfacing/lanes.d.ts +1 -0
  787. package/dist/surfacing/lanes.js +297 -0
  788. package/dist/surfacing/lanes.js.map +1 -0
  789. package/dist/surfacing/memo.js +40 -0
  790. package/dist/surfacing/memo.js.map +1 -0
  791. package/dist/surfacing/rateLimiter.d.ts +1 -0
  792. package/dist/surfacing/rateLimiter.js +69 -94
  793. package/dist/surfacing/rateLimiter.js.map +1 -1
  794. package/dist/surfacing/rebucket.js +178 -0
  795. package/dist/surfacing/rebucket.js.map +1 -0
  796. package/dist/surfacing/recipe.js +28 -0
  797. package/dist/surfacing/recipe.js.map +1 -0
  798. package/dist/surfacing/shape.js +22 -0
  799. package/dist/surfacing/shape.js.map +1 -0
  800. package/dist/surfacing/todaySplit.js +113 -0
  801. package/dist/surfacing/todaySplit.js.map +1 -0
  802. package/dist/sync/collection.d.ts +8 -0
  803. package/dist/sync/collection.js +28 -18
  804. package/dist/sync/collection.js.map +1 -1
  805. package/dist/sync/rekeyDurations.js +70 -0
  806. package/dist/sync/rekeyDurations.js.map +1 -0
  807. package/dist/sync/syncTask.js +226 -109
  808. package/dist/sync/syncTask.js.map +1 -1
  809. package/dist/testing/memoryAdapter.d.ts +6 -3
  810. package/dist/testing/memoryAdapter.js +12 -10
  811. package/dist/testing/memoryAdapter.js.map +1 -1
  812. package/dist/testing/settle.d.ts +11 -0
  813. package/dist/testing/settle.js +19 -0
  814. package/dist/testing/settle.js.map +1 -0
  815. package/dist/timeframe/calendar.js +65 -0
  816. package/dist/timeframe/calendar.js.map +1 -0
  817. package/dist/timeframe/comparison.js +46 -0
  818. package/dist/timeframe/comparison.js.map +1 -0
  819. package/dist/timeframe/presets.d.ts +1 -1
  820. package/dist/timeframe/presets.js +5 -5
  821. package/dist/timeframe/presets.js.map +1 -1
  822. package/dist/timeframe/reportingTimezone.d.ts +1 -0
  823. package/dist/timeframe/reportingTimezone.js +64 -0
  824. package/dist/timeframe/reportingTimezone.js.map +1 -0
  825. package/dist/timeframe/tz.js +55 -39
  826. package/dist/timeframe/tz.js.map +1 -1
  827. package/dist/tracker/autoCapture.js +125 -38
  828. package/dist/tracker/autoCapture.js.map +1 -1
  829. package/dist/tracker/campaign.js +52 -0
  830. package/dist/tracker/campaign.js.map +1 -0
  831. package/dist/tracker/config.d.ts +144 -0
  832. package/dist/tracker/config.js +25 -0
  833. package/dist/tracker/config.js.map +1 -0
  834. package/dist/tracker/createTracker.d.ts +4 -10
  835. package/dist/tracker/createTracker.js +386 -115
  836. package/dist/tracker/createTracker.js.map +1 -1
  837. package/dist/tracker/digest.js +28 -0
  838. package/dist/tracker/digest.js.map +1 -0
  839. package/dist/tracker/engagement.js +100 -0
  840. package/dist/tracker/engagement.js.map +1 -0
  841. package/dist/tracker/events.js +37 -0
  842. package/dist/tracker/events.js.map +1 -0
  843. package/dist/tracker/exclusion.d.ts +2 -22
  844. package/dist/tracker/exclusion.js +53 -21
  845. package/dist/tracker/exclusion.js.map +1 -1
  846. package/dist/tracker/gate.js +194 -0
  847. package/dist/tracker/gate.js.map +1 -0
  848. package/dist/tracker/initTracker.d.ts +5 -8
  849. package/dist/tracker/initTracker.js +42 -14
  850. package/dist/tracker/initTracker.js.map +1 -1
  851. package/dist/tracker/itemCapture.js +224 -0
  852. package/dist/tracker/itemCapture.js.map +1 -0
  853. package/dist/tracker/loadScript.js +21 -14
  854. package/dist/tracker/loadScript.js.map +1 -1
  855. package/dist/tracker/pageTracking.js +6 -6
  856. package/dist/tracker/pageTracking.js.map +1 -1
  857. package/dist/tracker/registry.js +118 -30
  858. package/dist/tracker/registry.js.map +1 -1
  859. package/dist/tracker/sinks/createSink.js +38 -0
  860. package/dist/tracker/sinks/createSink.js.map +1 -0
  861. package/dist/tracker/sinks/ga4.js +64 -20
  862. package/dist/tracker/sinks/ga4.js.map +1 -1
  863. package/dist/tracker/sinks/native.js +7 -42
  864. package/dist/tracker/sinks/native.js.map +1 -1
  865. package/dist/tracker/sinks/plausible.js +27 -22
  866. package/dist/tracker/sinks/plausible.js.map +1 -1
  867. package/dist/tracker/sinks/posthog.js +26 -22
  868. package/dist/tracker/sinks/posthog.js.map +1 -1
  869. package/dist/tracker/sinks/umami.js +14 -12
  870. package/dist/tracker/sinks/umami.js.map +1 -1
  871. package/dist/tracker/sinks/vendor.js +30 -27
  872. package/dist/tracker/sinks/vendor.js.map +1 -1
  873. package/dist/tracker/skip.js +81 -0
  874. package/dist/tracker/skip.js.map +1 -0
  875. package/dist/tracker/storage.js +23 -0
  876. package/dist/tracker/storage.js.map +1 -0
  877. package/dist/tracker/transport.js +2 -5
  878. package/dist/tracker/transport.js.map +1 -1
  879. package/dist/tracker/types.d.ts +86 -63
  880. package/dist/tracker/window.js +7 -0
  881. package/dist/tracker/window.js.map +1 -0
  882. package/dist/translations/ar.js +226 -71
  883. package/dist/translations/ar.js.map +1 -1
  884. package/dist/translations/de.js +215 -69
  885. package/dist/translations/de.js.map +1 -1
  886. package/dist/translations/en.js +209 -67
  887. package/dist/translations/en.js.map +1 -1
  888. package/dist/translations/es.js +217 -68
  889. package/dist/translations/es.js.map +1 -1
  890. package/dist/translations/fr.js +221 -72
  891. package/dist/translations/fr.js.map +1 -1
  892. package/dist/translations/id.js +212 -67
  893. package/dist/translations/id.js.map +1 -1
  894. package/dist/translations/index.d.ts +1 -1
  895. package/dist/translations/index.js +5 -7
  896. package/dist/translations/index.js.map +1 -1
  897. package/dist/translations/intl.js +71 -0
  898. package/dist/translations/intl.js.map +1 -0
  899. package/dist/translations/keys.d.ts +185 -14
  900. package/dist/translations/keys.js +190 -14
  901. package/dist/translations/keys.js.map +1 -1
  902. package/dist/translations/ko.js +214 -69
  903. package/dist/translations/ko.js.map +1 -1
  904. package/dist/translations/labelMap.d.ts +10 -0
  905. package/dist/translations/labelMap.js +22 -0
  906. package/dist/translations/labelMap.js.map +1 -0
  907. package/dist/translations/metricKeys.js +10 -2
  908. package/dist/translations/metricKeys.js.map +1 -1
  909. package/dist/translations/parts.js +20 -0
  910. package/dist/translations/parts.js.map +1 -0
  911. package/dist/translations/plural.js +61 -0
  912. package/dist/translations/plural.js.map +1 -0
  913. package/dist/translations/pt.js +226 -77
  914. package/dist/translations/pt.js.map +1 -1
  915. package/dist/translations/ru.js +217 -66
  916. package/dist/translations/ru.js.map +1 -1
  917. package/dist/translations/server.d.ts +1 -0
  918. package/dist/translations/server.js +2 -3
  919. package/dist/translations/server.js.map +1 -1
  920. package/dist/translations/staticLabel.js +69 -0
  921. package/dist/translations/staticLabel.js.map +1 -0
  922. package/dist/translations/uk.js +217 -66
  923. package/dist/translations/uk.js.map +1 -1
  924. package/dist/translations/zh.js +212 -67
  925. package/dist/translations/zh.js.map +1 -1
  926. package/dist/ui/RangePicker.js +112 -0
  927. package/dist/ui/RangePicker.js.map +1 -0
  928. package/dist/ui/analytics.css +1528 -0
  929. package/dist/ui/calendarDays.js +27 -0
  930. package/dist/ui/calendarDays.js.map +1 -0
  931. package/dist/ui/classNames.js +7 -0
  932. package/dist/ui/classNames.js.map +1 -0
  933. package/dist/ui/components/Card.d.ts +28 -0
  934. package/dist/ui/components/Card.js +21 -0
  935. package/dist/ui/components/Card.js.map +1 -0
  936. package/dist/ui/components/ChartDataTable.d.ts +41 -0
  937. package/dist/ui/components/ChartDataTable.js +48 -0
  938. package/dist/ui/components/ChartDataTable.js.map +1 -0
  939. package/dist/ui/components/DataTable.d.ts +82 -0
  940. package/dist/ui/components/DataTable.js +214 -0
  941. package/dist/ui/components/DataTable.js.map +1 -0
  942. package/dist/ui/components/LabeledSelect.js +62 -0
  943. package/dist/ui/components/LabeledSelect.js.map +1 -0
  944. package/dist/ui/components/LiveAnnouncement.js +21 -0
  945. package/dist/ui/components/LiveAnnouncement.js.map +1 -0
  946. package/dist/ui/components/MetricCard.d.ts +38 -0
  947. package/dist/ui/components/MetricCard.js +39 -0
  948. package/dist/ui/components/MetricCard.js.map +1 -0
  949. package/dist/ui/components/NoValue.js +22 -0
  950. package/dist/ui/components/NoValue.js.map +1 -0
  951. package/dist/ui/components/ReadState.js +27 -0
  952. package/dist/ui/components/ReadState.js.map +1 -0
  953. package/dist/ui/components/RefreshButton.js +26 -0
  954. package/dist/ui/components/RefreshButton.js.map +1 -0
  955. package/dist/ui/cssVars.js +7 -0
  956. package/dist/ui/cssVars.js.map +1 -0
  957. package/dist/ui/data/WithScopeToken.d.ts +20 -0
  958. package/dist/ui/data/WithScopeToken.js +20 -0
  959. package/dist/ui/data/WithScopeToken.js.map +1 -0
  960. package/dist/ui/data/clientFieldProps.js +16 -0
  961. package/dist/ui/data/clientFieldProps.js.map +1 -0
  962. package/dist/ui/data/request.d.ts +46 -0
  963. package/dist/ui/data/request.js +119 -0
  964. package/dist/ui/data/request.js.map +1 -0
  965. package/dist/ui/data/scopeTokenContext.js +18 -0
  966. package/dist/ui/data/scopeTokenContext.js.map +1 -0
  967. package/dist/ui/data/sharedCache.js +48 -0
  968. package/dist/ui/data/sharedCache.js.map +1 -0
  969. package/dist/ui/data/useRequest.d.ts +19 -0
  970. package/dist/ui/data/useRequest.js +123 -0
  971. package/dist/ui/data/useRequest.js.map +1 -0
  972. package/dist/ui/data/useRequestScope.js +25 -0
  973. package/dist/ui/data/useRequestScope.js.map +1 -0
  974. package/dist/ui/hooks/useDirection.js +47 -0
  975. package/dist/ui/hooks/useDirection.js.map +1 -0
  976. package/dist/ui/hooks/useDismissOnEscape.js +25 -0
  977. package/dist/ui/hooks/useDismissOnEscape.js.map +1 -0
  978. package/dist/ui/hooks/useLiveAnnouncement.js +57 -0
  979. package/dist/ui/hooks/useLiveAnnouncement.js.map +1 -0
  980. package/dist/ui/hooks/useRealtimePoll.js +112 -0
  981. package/dist/ui/hooks/useRealtimePoll.js.map +1 -0
  982. package/dist/ui/readState.js +19 -0
  983. package/dist/ui/readState.js.map +1 -0
  984. package/dist/ui/rows/toDisplayRows.js +49 -0
  985. package/dist/ui/rows/toDisplayRows.js.map +1 -0
  986. package/dist/ui/viewerClock.js +7 -0
  987. package/dist/ui/viewerClock.js.map +1 -0
  988. package/dist/view/AnalyticsNavLink.d.ts +5 -3
  989. package/dist/view/AnalyticsNavLink.js +11 -6
  990. package/dist/view/AnalyticsNavLink.js.map +1 -1
  991. package/dist/view/AnalyticsView.d.ts +8 -10
  992. package/dist/view/AnalyticsView.js +47 -18
  993. package/dist/view/AnalyticsView.js.map +1 -1
  994. package/dist/view/AnalyticsViewClient.d.ts +4 -7
  995. package/dist/view/AnalyticsViewClient.js +15 -229
  996. package/dist/view/AnalyticsViewClient.js.map +1 -1
  997. package/dist/view/CountryFlag.d.ts +27 -0
  998. package/dist/view/CountryFlag.js +44 -0
  999. package/dist/view/CountryFlag.js.map +1 -0
  1000. package/dist/view/DocumentTitle.js +27 -0
  1001. package/dist/view/DocumentTitle.js.map +1 -0
  1002. package/dist/view/ViewRoot.d.ts +21 -0
  1003. package/dist/view/ViewRoot.js +150 -0
  1004. package/dist/view/ViewRoot.js.map +1 -0
  1005. package/dist/view/ViewSections.d.ts +38 -0
  1006. package/dist/view/ViewSections.js +190 -0
  1007. package/dist/view/ViewSections.js.map +1 -0
  1008. package/dist/view/authRedirect.js +2 -4
  1009. package/dist/view/authRedirect.js.map +1 -1
  1010. package/dist/view/conversionRate.js +9 -7
  1011. package/dist/view/conversionRate.js.map +1 -1
  1012. package/dist/view/dayRange.js +6 -10
  1013. package/dist/view/dayRange.js.map +1 -1
  1014. package/dist/view/exclusionLink.d.ts +27 -0
  1015. package/dist/view/exclusionLink.js +46 -0
  1016. package/dist/view/exclusionLink.js.map +1 -0
  1017. package/dist/view/flagSrc.js +14 -0
  1018. package/dist/view/flagSrc.js.map +1 -0
  1019. package/dist/view/gating.d.ts +15 -1
  1020. package/dist/view/gating.js +66 -31
  1021. package/dist/view/gating.js.map +1 -1
  1022. package/dist/view/hostCountryFlag.js +41 -0
  1023. package/dist/view/hostCountryFlag.js.map +1 -0
  1024. package/dist/view/labels.js +95 -10
  1025. package/dist/view/labels.js.map +1 -1
  1026. package/dist/view/metricAliases.js +10 -0
  1027. package/dist/view/metricAliases.js.map +1 -0
  1028. package/dist/view/navLabel.js +15 -0
  1029. package/dist/view/navLabel.js.map +1 -0
  1030. package/dist/view/registerView.js +10 -9
  1031. package/dist/view/registerView.js.map +1 -1
  1032. package/dist/view/scopeLabel.js +21 -0
  1033. package/dist/view/scopeLabel.js.map +1 -0
  1034. package/dist/view/sections/Breakdowns.js +196 -134
  1035. package/dist/view/sections/Breakdowns.js.map +1 -1
  1036. package/dist/view/sections/EmptyStates.js +118 -30
  1037. package/dist/view/sections/EmptyStates.js.map +1 -1
  1038. package/dist/view/sections/ExcludeBrowser.js +188 -0
  1039. package/dist/view/sections/ExcludeBrowser.js.map +1 -0
  1040. package/dist/view/sections/FilterChips.js +124 -27
  1041. package/dist/view/sections/FilterChips.js.map +1 -1
  1042. package/dist/view/sections/GoalsPanel.js +68 -60
  1043. package/dist/view/sections/GoalsPanel.js.map +1 -1
  1044. package/dist/view/sections/OverviewCards.js +29 -33
  1045. package/dist/view/sections/OverviewCards.js.map +1 -1
  1046. package/dist/view/sections/RealtimeStrip.js +70 -59
  1047. package/dist/view/sections/RealtimeStrip.js.map +1 -1
  1048. package/dist/view/sections/SectionBoundary.js +34 -0
  1049. package/dist/view/sections/SectionBoundary.js.map +1 -0
  1050. package/dist/view/sections/Toolbar.d.ts +11 -0
  1051. package/dist/view/sections/Toolbar.js +123 -82
  1052. package/dist/view/sections/Toolbar.js.map +1 -1
  1053. package/dist/view/sections/Trend.js +176 -76
  1054. package/dist/view/sections/Trend.js.map +1 -1
  1055. package/dist/view/state.d.ts +42 -0
  1056. package/dist/view/state.js +93 -54
  1057. package/dist/view/state.js.map +1 -1
  1058. package/dist/view/useViewClock.js +31 -0
  1059. package/dist/view/useViewClock.js.map +1 -0
  1060. package/dist/view/useViewQueries.d.ts +21 -0
  1061. package/dist/view/useViewQueries.js +45 -77
  1062. package/dist/view/useViewQueries.js.map +1 -1
  1063. package/dist/view/useViewState.js +42 -0
  1064. package/dist/view/useViewState.js.map +1 -0
  1065. package/dist/view/useViewUrl.js +47 -0
  1066. package/dist/view/useViewUrl.js.map +1 -0
  1067. package/dist/view/viewBody.js +30 -0
  1068. package/dist/view/viewBody.js.map +1 -0
  1069. package/dist/view/viewContext.d.ts +81 -0
  1070. package/dist/view/viewContext.js +49 -0
  1071. package/dist/view/viewContext.js.map +1 -0
  1072. package/dist/view/viewProps.d.ts +64 -7
  1073. package/dist/view/viewProps.js +121 -35
  1074. package/dist/view/viewProps.js.map +1 -1
  1075. package/dist/widgets/AnalyticsBreakdownWidget.d.ts +7 -3
  1076. package/dist/widgets/AnalyticsBreakdownWidget.js +143 -118
  1077. package/dist/widgets/AnalyticsBreakdownWidget.js.map +1 -1
  1078. package/dist/widgets/AnalyticsGoalsWidget.d.ts +6 -7
  1079. package/dist/widgets/AnalyticsGoalsWidget.js +124 -167
  1080. package/dist/widgets/AnalyticsGoalsWidget.js.map +1 -1
  1081. package/dist/widgets/AnalyticsMetricWidget.d.ts +7 -3
  1082. package/dist/widgets/AnalyticsMetricWidget.js +80 -106
  1083. package/dist/widgets/AnalyticsMetricWidget.js.map +1 -1
  1084. package/dist/widgets/AnalyticsRealtimeWidget.d.ts +7 -3
  1085. package/dist/widgets/AnalyticsRealtimeWidget.js +74 -64
  1086. package/dist/widgets/AnalyticsRealtimeWidget.js.map +1 -1
  1087. package/dist/widgets/AnalyticsTrendWidget.d.ts +7 -3
  1088. package/dist/widgets/AnalyticsTrendWidget.js +129 -123
  1089. package/dist/widgets/AnalyticsTrendWidget.js.map +1 -1
  1090. package/dist/widgets/ComparisonDelta.js +33 -42
  1091. package/dist/widgets/ComparisonDelta.js.map +1 -1
  1092. package/dist/widgets/RealtimeCounter.d.ts +24 -4
  1093. package/dist/widgets/RealtimeCounter.js +91 -77
  1094. package/dist/widgets/RealtimeCounter.js.map +1 -1
  1095. package/dist/widgets/WidgetCard.d.ts +80 -0
  1096. package/dist/widgets/WidgetCard.js +99 -0
  1097. package/dist/widgets/WidgetCard.js.map +1 -0
  1098. package/dist/widgets/WidgetFrame.js +42 -0
  1099. package/dist/widgets/WidgetFrame.js.map +1 -0
  1100. package/dist/widgets/WidgetShimmer.d.ts +55 -0
  1101. package/dist/widgets/WidgetShimmer.js +86 -0
  1102. package/dist/widgets/WidgetShimmer.js.map +1 -0
  1103. package/dist/widgets/breakdownTypes.js +12 -2
  1104. package/dist/widgets/breakdownTypes.js.map +1 -1
  1105. package/dist/widgets/customWidget.d.ts +5 -1
  1106. package/dist/widgets/customWidget.js +6 -7
  1107. package/dist/widgets/customWidget.js.map +1 -1
  1108. package/dist/widgets/defaults.d.ts +4 -7
  1109. package/dist/widgets/defaults.js +4 -7
  1110. package/dist/widgets/defaults.js.map +1 -1
  1111. package/dist/widgets/fieldRows.js +14 -0
  1112. package/dist/widgets/fieldRows.js.map +1 -0
  1113. package/dist/widgets/filterCaption.js +6 -7
  1114. package/dist/widgets/filterCaption.js.map +1 -1
  1115. package/dist/widgets/filterField.d.ts +3 -7
  1116. package/dist/widgets/filterField.js +46 -35
  1117. package/dist/widgets/filterField.js.map +1 -1
  1118. package/dist/widgets/filterValueLabel.d.ts +1 -0
  1119. package/dist/widgets/filterValueLabel.js +45 -0
  1120. package/dist/widgets/filterValueLabel.js.map +1 -0
  1121. package/dist/widgets/notices.js +73 -0
  1122. package/dist/widgets/notices.js.map +1 -0
  1123. package/dist/widgets/prepareWidgetRead.d.ts +5 -1
  1124. package/dist/widgets/prepareWidgetRead.js +59 -27
  1125. package/dist/widgets/prepareWidgetRead.js.map +1 -1
  1126. package/dist/widgets/range.js +26 -21
  1127. package/dist/widgets/range.js.map +1 -1
  1128. package/dist/widgets/readForWidget.d.ts +27 -18
  1129. package/dist/widgets/readForWidget.js +31 -29
  1130. package/dist/widgets/readForWidget.js.map +1 -1
  1131. package/dist/widgets/readForWidgetBreakdown.d.ts +39 -28
  1132. package/dist/widgets/readForWidgetBreakdown.js +46 -22
  1133. package/dist/widgets/readForWidgetBreakdown.js.map +1 -1
  1134. package/dist/widgets/readForWidgetGoals.d.ts +17 -23
  1135. package/dist/widgets/readForWidgetGoals.js +50 -46
  1136. package/dist/widgets/readForWidgetGoals.js.map +1 -1
  1137. package/dist/widgets/readForWidgetRealtime.d.ts +21 -17
  1138. package/dist/widgets/readForWidgetRealtime.js +51 -27
  1139. package/dist/widgets/readForWidgetRealtime.js.map +1 -1
  1140. package/dist/widgets/readForWidgetSeries.d.ts +26 -31
  1141. package/dist/widgets/readForWidgetSeries.js +43 -82
  1142. package/dist/widgets/readForWidgetSeries.js.map +1 -1
  1143. package/dist/widgets/readMeta.d.ts +44 -0
  1144. package/dist/widgets/readMeta.js +47 -4
  1145. package/dist/widgets/readMeta.js.map +1 -1
  1146. package/dist/widgets/realtimePoll.d.ts +1 -0
  1147. package/dist/widgets/realtimePoll.js +53 -25
  1148. package/dist/widgets/realtimePoll.js.map +1 -1
  1149. package/dist/widgets/registerWidgets.js +204 -126
  1150. package/dist/widgets/registerWidgets.js.map +1 -1
  1151. package/dist/widgets/stateKeys.js +30 -0
  1152. package/dist/widgets/stateKeys.js.map +1 -0
  1153. package/dist/widgets/titleForecast.js +89 -0
  1154. package/dist/widgets/titleForecast.js.map +1 -0
  1155. package/dist/widgets/types.d.ts +4 -3
  1156. package/dist/widgets/types.js +2 -0
  1157. package/dist/widgets/types.js.map +1 -1
  1158. package/dist/widgets/viewLink.d.ts +24 -6
  1159. package/dist/widgets/viewLink.js +31 -24
  1160. package/dist/widgets/viewLink.js.map +1 -1
  1161. package/dist/widgets/widgetData.js +34 -0
  1162. package/dist/widgets/widgetData.js.map +1 -0
  1163. package/dist/widgets/widgetWindow.d.ts +1 -0
  1164. package/dist/widgets/widgetWindow.js +51 -0
  1165. package/dist/widgets/widgetWindow.js.map +1 -0
  1166. package/package.json +44 -22
  1167. package/dist/adapters/ga4/disableKey.d.ts +0 -9
  1168. package/dist/capture/getTrackerConfig.d.ts +0 -20
  1169. package/dist/capture/getTrackerConfig.js +0 -31
  1170. package/dist/capture/getTrackerConfig.js.map +0 -1
  1171. package/dist/capture/slots.d.ts +0 -8
  1172. package/dist/capture/trackerConfig.d.ts +0 -33
  1173. package/dist/charts/styles.js +0 -59
  1174. package/dist/charts/styles.js.map +0 -1
  1175. package/dist/fields/config/SourceSelectField.d.ts +0 -14
  1176. package/dist/fields/dateRange/styles.js +0 -23
  1177. package/dist/fields/dateRange/styles.js.map +0 -1
  1178. package/dist/goals/GoalSelectField.d.ts +0 -7
  1179. package/dist/native/collections/events.js +0 -165
  1180. package/dist/native/collections/events.js.map +0 -1
  1181. package/dist/native/collections/rollups.js +0 -151
  1182. package/dist/native/collections/rollups.js.map +0 -1
  1183. package/dist/native/collections/seen.js +0 -47
  1184. package/dist/native/collections/seen.js.map +0 -1
  1185. package/dist/native/eventScan.js +0 -25
  1186. package/dist/native/eventScan.js.map +0 -1
  1187. package/dist/native/ingest/flushBatch.js +0 -60
  1188. package/dist/native/ingest/flushBatch.js.map +0 -1
  1189. package/dist/native/ingest/salt.js +0 -39
  1190. package/dist/native/ingest/salt.js.map +0 -1
  1191. package/dist/native/ingest/writeBuffer.js +0 -55
  1192. package/dist/native/ingest/writeBuffer.js.map +0 -1
  1193. package/dist/native/ingest/writeEvent.js +0 -14
  1194. package/dist/native/ingest/writeEvent.js.map +0 -1
  1195. package/dist/native/query/eventAgg.js +0 -175
  1196. package/dist/native/query/eventAgg.js.map +0 -1
  1197. package/dist/native/realtime/buildRealtime.js +0 -53
  1198. package/dist/native/realtime/buildRealtime.js.map +0 -1
  1199. package/dist/native/retention/pruneTask.js +0 -69
  1200. package/dist/native/retention/pruneTask.js.map +0 -1
  1201. package/dist/native/rollupAcc.js +0 -64
  1202. package/dist/native/rollupAcc.js.map +0 -1
  1203. package/dist/native/rollups/bucketKey.js +0 -15
  1204. package/dist/native/rollups/bucketKey.js.map +0 -1
  1205. package/dist/native/rollups/bumpRollups.js +0 -116
  1206. package/dist/native/rollups/bumpRollups.js.map +0 -1
  1207. package/dist/native/rollups/deltas.js +0 -106
  1208. package/dist/native/rollups/deltas.js.map +0 -1
  1209. package/dist/native/rollups/insertManyIfNew.js +0 -93
  1210. package/dist/native/rollups/insertManyIfNew.js.map +0 -1
  1211. package/dist/plugin/paths.js +0 -29
  1212. package/dist/plugin/paths.js.map +0 -1
  1213. package/dist/react/TrackerBoot.d.ts +0 -22
  1214. package/dist/rsc/AnalyticsScripts.d.ts +0 -30
  1215. package/dist/rsc/AnalyticsScripts.js +0 -41
  1216. package/dist/rsc/AnalyticsScripts.js.map +0 -1
  1217. package/dist/surfacing/queue.js +0 -60
  1218. package/dist/surfacing/queue.js.map +0 -1
  1219. package/dist/surfacing/retryPolicy.js +0 -15
  1220. package/dist/surfacing/retryPolicy.js.map +0 -1
  1221. package/dist/tracker/autoCapture.d.ts +0 -48
  1222. package/dist/tracker/consent.d.ts +0 -24
  1223. package/dist/tracker/consent.js +0 -48
  1224. package/dist/tracker/consent.js.map +0 -1
  1225. package/dist/tracker/loadScript.d.ts +0 -14
  1226. package/dist/tracker/pageTracking.d.ts +0 -17
  1227. package/dist/tracker/registry.d.ts +0 -27
  1228. package/dist/tracker/sinks/ga4.d.ts +0 -29
  1229. package/dist/tracker/sinks/native.d.ts +0 -22
  1230. package/dist/tracker/sinks/plausible.d.ts +0 -20
  1231. package/dist/tracker/sinks/posthog.d.ts +0 -18
  1232. package/dist/tracker/sinks/umami.d.ts +0 -18
  1233. package/dist/tracker/sinks/vendor.d.ts +0 -14
  1234. package/dist/view/sections/styles.js +0 -76
  1235. package/dist/view/sections/styles.js.map +0 -1
  1236. package/dist/widgets/WidgetViewLink.js +0 -17
  1237. package/dist/widgets/WidgetViewLink.js.map +0 -1
  1238. package/dist/widgets/cardChrome.d.ts +0 -8
  1239. package/dist/widgets/cardChrome.js +0 -46
  1240. package/dist/widgets/cardChrome.js.map +0 -1
  1241. package/dist/widgets/comparison.js +0 -57
  1242. package/dist/widgets/comparison.js.map +0 -1
@@ -1,35 +1,67 @@
1
- import { readCappedBody } from "../../capture/requestBody.js";
1
+ import { captureRequest } from "../../capture/captureRequest.js";
2
+ import { currentDate } from "../../core/clock.js";
2
3
  import { analyticsError, errorResponse } from "../../plugin/errors.js";
3
- import { flushBatch } from "./flushBatch.js";
4
- import { normalizeEvent } from "./normalizeEvent.js";
5
- import { dailySalt } from "./salt.js";
4
+ import { readCappedBody } from "../../capture/requestBody.js";
5
+ import { refusedCrossSite, warnUntrustedForwarding } from "../../capture/requestTrust.js";
6
+ import { refusedSameSite } from "../../capture/sameSite.js";
7
+ import { monotonicMs } from "../../core/monotonic.js";
8
+ import { DEFAULT_BROWSER_AMOUNTS } from "../../goals/match.js";
9
+ import { orderDigestKey, warnUnconvertedOnce } from "./revenue.js";
10
+ import { serverTwinOf } from "../store/ids.js";
11
+ import { saltForHit } from "../engine/salt.js";
12
+ import { referrerHost } from "./referrer.js";
13
+ import { toHit } from "../engine/toHit.js";
6
14
  import { rawEventError } from "./validate.js";
15
+ import { eventTime, normalizeEvent } from "./normalizeEvent.js";
7
16
  import { isBot } from "./bots.js";
17
+ import { wireOrderId } from "./orderSignature.js";
8
18
  import { resolveEventHostname } from "./resolveHostname.js";
9
19
  //#region src/native/ingest/endpoint.ts
10
20
  /**
11
- * What an accepted beacon answers, and what a dropped one answers too: same status, same body,
12
- * no header of its own and nothing logged per event, so the endpoint never tells a prober which
13
- * hosts or tenants exist.
21
+ * Dropped beacons answer exactly like accepted ones, with nothing logged per event, so the endpoint
22
+ * never tells a prober which hosts or tenants exist.
14
23
  */
15
24
  const accepted = () => Response.json({ ok: true }, { status: 202 });
16
25
  const REQUEST_HOSTNAME = { kind: "request" };
26
+ const NO_ORIGINS = /* @__PURE__ */ new Set();
17
27
  /**
18
- * What an operator has to hear about once, and the line that tells them where to look. A
19
- * misconfigured resolver, a broken filter or a header-stripping proxy otherwise costs an
20
- * install its traffic in silence, since the response cannot say any of it.
28
+ * Logged once each: a misconfigured resolver, broken filter or header-stripping proxy otherwise
29
+ * costs an install its traffic in silence, since the response cannot say so.
21
30
  */
22
31
  const WARN_REASONS = {
23
- "no scope resolved": "analytics: ingest is dropping events because scopeResolver answered no scope for them. Check that resolver, and list any platform domain in platformHostnames so it ingests under the null scope. Logged once per process.",
32
+ "no scope resolved": "analytics: ingest is dropping events because scope.resolve answered no scope for them. Check that resolver, and list any platform domain in platformHostnames so it ingests under the null scope. Logged once per process.",
33
+ "no native provider": "analytics: ingest is dropping events for a scope with no enabled native provider document. Add one for that tenant to store its visits here. Logged once per process.",
24
34
  "hostname refused": "analytics: ingest is dropping events because the hostname option refused the request host. Check that option, and platformHostnames for a platform domain. Logged once per process.",
25
35
  "bot filter threw": "analytics: the filterBots function threw, so the event was kept. Check that function; every beacon counts while it throws. Logged once per process.",
26
- "no user agent": "analytics: a beacon arrived with no user agent and was not recorded: an intermediary may be stripping the header. Logged once per process."
36
+ "no user agent": "analytics: a beacon arrived with no user agent and was not recorded: an intermediary may be stripping the header. Logged once per process.",
37
+ "cross-site": "analytics: ingest is dropping beacons that a page on another site made a visitor's browser send (Sec-Fetch-Site: cross-site). If a site on another domain should send its visits here, list its origin in capture.allowedOrigins. Logged once per process.",
38
+ "other scope": "analytics: ingest is dropping beacons that a page on a sibling subdomain sent (Sec-Fetch-Site: same-site) whose Origin scope.resolve maps to another scope than the request's. Each tenant's pages post to their own host. Logged once per process.",
39
+ "timezone unresolved": "analytics: ingest hashes visitors by the UTC day for a scope whose reportingTimezone has never resolved: the resolver throws or answers something that is not an IANA timezone. Check that resolver. Logged once per process.",
40
+ "order recount failed": "analytics: a browser's record of an order was stored, but the closed day holding the server's record of it could not be marked to be counted again, so that day keeps the sale until it is rebuilt. Logged once per process.",
41
+ "order refused": "analytics: ingest is dropping sales whose orderId is empty, too long, holds a control character, or lacks the signature signOrderId writes while signatures are required. Logged once per process."
42
+ };
43
+ /** One line about failed beacons at most this often: a public path must not be a log amplifier. */
44
+ const FAILED_LOG_MS = 6e4;
45
+ /** Counts beacons that could not be `what` and logs them in one line at most once a minute. */
46
+ const beaconFailureLog = (what) => {
47
+ let failed = 0;
48
+ let loggedAt = null;
49
+ return (payload, err) => {
50
+ failed += 1;
51
+ const at = monotonicMs();
52
+ if (loggedAt !== null && at - loggedAt < FAILED_LOG_MS) return;
53
+ loggedAt = at;
54
+ payload.logger?.error({
55
+ err,
56
+ msg: `analytics: ${failed} beacons could not be ${what}. Logged at most once a minute.`
57
+ });
58
+ failed = 0;
59
+ };
27
60
  };
28
61
  /** One event, not a session replay: far above any legitimate payload, far below a DoS. */
29
62
  const MAX_INGEST_BODY_BYTES = 64 * 1024;
30
63
  /**
31
- * Parses the buffered body, answering undefined for anything the validator could not judge:
32
- * a garbage POST is a 400 like any other bad payload rather than a thrown parse error that
64
+ * Undefined for anything unparseable, so a garbage POST is a 400 rather than a thrown error that
33
65
  * escapes into Payload's routeError as a logged 500.
34
66
  */
35
67
  const parseBody = (bytes) => {
@@ -41,12 +73,15 @@ const parseBody = (bytes) => {
41
73
  }
42
74
  };
43
75
  /**
44
- * The refusal for the first field an event failed on: naming it costs nothing and saves a
45
- * tracker author guessing which one of four the endpoint refused. A body that is not an
46
- * object at all fails the very check a typeless event does, so it names `type`.
76
+ * Naming the failed field saves a tracker author guessing. A non-object body fails the same check
77
+ * a typeless event does, so it names `type`.
47
78
  */
48
79
  const invalidField = (param) => errorResponse(400, analyticsError("invalid_param", `analytics: ${param} is missing or invalid`, param));
49
- const makeIngestHandler = ({ geoResolver, getBuffer = () => null, resolvers = {}, attribution = {}, filterBots = isBot }) => {
80
+ /**
81
+ * Native beacon endpoint: cheap refusals first, then everything resolved as a capture call site
82
+ * sees the request. The only read on the public path is the day's salt, once a day per process.
83
+ */
84
+ const makeIngestHandler = ({ geoResolver, target, resolvers = {}, attribution = {}, filterBots = isBot, browserAmounts = DEFAULT_BROWSER_AMOUNTS }) => {
50
85
  const warned = /* @__PURE__ */ new Set();
51
86
  const warnOnce = (req, reason) => {
52
87
  if (!warned.has(reason)) {
@@ -58,7 +93,9 @@ const makeIngestHandler = ({ geoResolver, getBuffer = () => null, resolvers = {}
58
93
  warnOnce(req, reason);
59
94
  return accepted();
60
95
  };
61
- return async (req) => {
96
+ const writeFailed = beaconFailureLog("stored");
97
+ const takeFailed = beaconFailureLog("taken");
98
+ const take = async (req) => {
62
99
  const userAgent = req.headers.get("user-agent") ?? "";
63
100
  let automated = false;
64
101
  try {
@@ -70,47 +107,95 @@ const makeIngestHandler = ({ geoResolver, getBuffer = () => null, resolvers = {}
70
107
  if (userAgent.trim() === "") warnOnce(req, "no user agent");
71
108
  return accepted();
72
109
  }
73
- const { scope: resolveScope, timezone: resolveTimezone, goals: resolveGoals } = resolvers;
110
+ if (refusedCrossSite(req.headers, attribution.allowedOrigins ?? NO_ORIGINS)) return drop(req, "cross-site");
111
+ const { scope: resolveScope, timezone: resolveTimezone, currency: resolveCurrency, goals: resolveGoals } = resolvers;
74
112
  const read = await readCappedBody(req, MAX_INGEST_BODY_BYTES);
75
113
  if (!read.ok) return read.reason === "too-large" ? errorResponse(413, analyticsError("payload_too_large", "analytics: the event body is too large")) : errorResponse(400, analyticsError("invalid_param", "analytics: the event body could not be read"));
76
114
  const raw = parseBody(read.body);
77
115
  if (raw === void 0) return invalidField("type");
78
116
  const param = rawEventError(raw);
79
117
  if (param !== void 0) return invalidField(param);
80
- const now = /* @__PURE__ */ new Date();
81
- const resolvedScope = resolveScope ? await resolveScope(req) : null;
118
+ const receivedAt = currentDate();
119
+ const at = eventTime(raw, receivedAt);
120
+ const visitor = captureRequest(req);
121
+ const resolvedScope = resolveScope ? await resolveScope(visitor) : null;
82
122
  const scope = resolveScope ? resolvedScope ?? "" : void 0;
83
123
  const hostname = await resolveEventHostname({
84
124
  option: attribution.hostname ?? REQUEST_HOSTNAME,
85
125
  claimed: raw.hostname,
86
- req,
126
+ req: visitor,
87
127
  scope: resolvedScope,
88
128
  trustedProxyHops: attribution.trustedProxyHops
89
129
  });
90
130
  if (hostname === null) return drop(req, "hostname refused");
91
131
  if (resolveScope !== void 0 && resolvedScope === null && !(attribution.platformHostnames?.has(hostname) ?? false)) return drop(req, "no scope resolved");
92
- const salt = await dailySalt(req.payload, now);
93
- const timezone = resolveTimezone ? await resolveTimezone(req, scope ?? null) : void 0;
94
- const goals = resolveGoals ? await resolveGoals(req, scope ?? null) : void 0;
132
+ if (resolveScope && await refusedSameSite(visitor, () => Promise.resolve(resolvedScope), resolveScope)) return drop(req, "other scope");
133
+ if (resolvers.granted && !await resolvers.granted(visitor, resolvedScope)) return drop(req, "no native provider");
134
+ const { salts, writer, items, nudge, siteHosts, engine, orders, keepAlive } = target(req.payload);
135
+ const order = wireOrderId(raw.orderId, scope ?? "", orders);
136
+ if (!order.ok) return drop(req, "order refused");
137
+ const salt = await saltForHit(salts, {
138
+ scope: scope ?? "",
139
+ at,
140
+ zone: () => resolveTimezone ? resolveTimezone(visitor, scope ?? null) : "UTC"
141
+ }, () => warnOnce(req, "timezone unresolved"));
142
+ const goals = resolveGoals && raw.type !== "engagement" ? await resolveGoals(visitor, scope ?? null) : void 0;
143
+ const reportingCurrency = resolveCurrency ? await resolveCurrency(visitor, scope ?? null) : void 0;
144
+ const trust = {
145
+ trustedProxyHops: attribution.trustedProxyHops,
146
+ trustedPlatform: attribution.trustedPlatform
147
+ };
148
+ warnUntrustedForwarding(req.payload, req.headers, trust);
149
+ const siblings = siteHosts && raw.type === "pageview" && referrerHost(raw.referrer, hostname) !== void 0 ? await siteHosts.of(scope ?? "") : void 0;
95
150
  const event = await normalizeEvent({
96
- raw,
151
+ raw: {
152
+ ...raw,
153
+ orderId: order.orderId
154
+ },
97
155
  hostname,
98
156
  headers: req.headers,
99
157
  geoResolver,
158
+ warnGeo: (message) => req.payload.logger?.warn(message),
100
159
  salt,
101
- now,
160
+ now: at,
102
161
  scope,
103
- timezone,
104
162
  goals,
105
- trustedProxyHops: attribution.trustedProxyHops
163
+ origin: "wire",
164
+ browserAmounts,
165
+ reportingCurrency,
166
+ convertCurrency: resolvers.convertCurrency,
167
+ warnUnconverted: () => warnUnconvertedOnce(req.payload.logger),
168
+ ...trust,
169
+ ...items ? { items } : {},
170
+ ...siblings ? { siblings } : {},
171
+ orderKey: orderDigestKey(req.payload?.secret)
106
172
  });
107
- const buffer = getBuffer();
108
- if (buffer) buffer.add(event);
109
- else await flushBatch(req.payload, [event]);
173
+ if (event.type === "engagement" && !event.durationMs && !event.scrollDepth && !event.impressions?.length) return accepted();
174
+ const hit = toHit(event, { receivedAt });
175
+ let stored;
176
+ try {
177
+ stored = await writer.write(hit);
178
+ siteHosts?.saw(scope ?? "", hostname);
179
+ } catch (err) {
180
+ writeFailed(req.payload, err);
181
+ }
182
+ if (engine && (stored?.written ?? 0) > 0 && serverTwinOf(hit.id) !== void 0) {
183
+ const probe = engine.orderStored(scope ?? "", hit.id).catch(() => warnOnce(req, "order recount failed"));
184
+ keepAlive?.(probe);
185
+ }
186
+ nudge?.();
110
187
  return accepted();
111
188
  };
189
+ return async (req) => {
190
+ try {
191
+ return await take(req);
192
+ } catch (err) {
193
+ takeFailed(req.payload, err);
194
+ return errorResponse(500, analyticsError("internal", "analytics: the beacon failed"));
195
+ }
196
+ };
112
197
  };
113
198
  //#endregion
114
- export { makeIngestHandler };
199
+ export { beaconFailureLog, makeIngestHandler };
115
200
 
116
201
  //# sourceMappingURL=endpoint.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"endpoint.js","names":[],"sources":["../../../src/native/ingest/endpoint.ts"],"sourcesContent":["import type { PayloadHandler, PayloadRequest } from 'payload'\nimport { readCappedBody } from '../../capture/requestBody'\nimport type { Goal } from '../../goals/types'\nimport { analyticsError, errorResponse } from '../../plugin/errors'\nimport type { GeoResolver } from '../geo/geoResolver'\nimport { type BotFilter, isBot } from './bots'\nimport { flushBatch } from './flushBatch'\nimport { normalizeEvent, type RawEventInput, type StoredEvent } from './normalizeEvent'\nimport { type ResolvedHostnameOption, resolveEventHostname } from './resolveHostname'\nimport { dailySalt } from './salt'\nimport { type RawEventField, rawEventError } from './validate'\nimport type { WriteBuffer } from './writeBuffer'\n\nexport interface IngestResolvers {\n\tscope?: (req: PayloadRequest) => Promise<string | null>\n\ttimezone?: (req: PayloadRequest, scope?: string | null) => Promise<string>\n\tgoals?: (req: PayloadRequest, scope?: string | null) => Promise<Goal[]>\n}\n\n/** How the handler reads the request behind an event, as opposed to what the body claims. */\nexport interface IngestAttribution {\n\ttrustedProxyHops?: number\n\t/** Resolved `hostname` option; absent attributes the event to the request's own host. */\n\thostname?: ResolvedHostnameOption\n\t/** Hostnames that ingest on a scoped install even when the request resolves no scope. */\n\tplatformHostnames?: ReadonlySet<string>\n}\n\n/**\n * What an accepted beacon answers, and what a dropped one answers too: same status, same body,\n * no header of its own and nothing logged per event, so the endpoint never tells a prober which\n * hosts or tenants exist.\n */\nconst accepted = (): Response => Response.json({ ok: true }, { status: 202 })\n\nconst REQUEST_HOSTNAME: ResolvedHostnameOption = { kind: 'request' }\n\n/**\n * What an operator has to hear about once, and the line that tells them where to look. A\n * misconfigured resolver, a broken filter or a header-stripping proxy otherwise costs an\n * install its traffic in silence, since the response cannot say any of it.\n */\nconst WARN_REASONS = {\n\t'no scope resolved':\n\t\t'analytics: ingest is dropping events because scopeResolver answered no scope for them. Check that resolver, and list any platform domain in platformHostnames so it ingests under the null scope. Logged once per process.',\n\t'hostname refused':\n\t\t'analytics: ingest is dropping events because the hostname option refused the request host. Check that option, and platformHostnames for a platform domain. Logged once per process.',\n\t'bot filter threw':\n\t\t'analytics: the filterBots function threw, so the event was kept. Check that function; every beacon counts while it throws. Logged once per process.',\n\t'no user agent':\n\t\t'analytics: a beacon arrived with no user agent and was not recorded: an intermediary may be stripping the header. Logged once per process.',\n} as const\n\ntype WarnReason = keyof typeof WARN_REASONS\n\n/** One event, not a session replay: far above any legitimate payload, far below a DoS. */\nexport const MAX_INGEST_BODY_BYTES = 64 * 1024\n\n/**\n * Parses the buffered body, answering undefined for anything the validator could not judge:\n * a garbage POST is a 400 like any other bad payload rather than a thrown parse error that\n * escapes into Payload's routeError as a logged 500.\n */\nconst parseBody = (bytes: ArrayBuffer): RawEventInput | undefined => {\n\ttry {\n\t\tconst parsed: unknown = JSON.parse(new TextDecoder().decode(bytes))\n\t\treturn typeof parsed === 'object' && parsed !== null ? (parsed as RawEventInput) : undefined\n\t} catch {\n\t\treturn undefined\n\t}\n}\n\n/**\n * The refusal for the first field an event failed on: naming it costs nothing and saves a\n * tracker author guessing which one of four the endpoint refused. A body that is not an\n * object at all fails the very check a typeless event does, so it names `type`.\n */\nconst invalidField = (param: RawEventField): Response =>\n\terrorResponse(\n\t\t400,\n\t\tanalyticsError('invalid_param', `analytics: ${param} is missing or invalid`, param)\n\t)\n\nexport interface IngestHandlerOptions {\n\tgeoResolver: GeoResolver\n\tgetBuffer?: () => WriteBuffer<StoredEvent> | null\n\tresolvers?: IngestResolvers\n\tattribution?: IngestAttribution\n\t/** Which agents never reach the pipeline. Defaults to the built-in `isBot`. */\n\tfilterBots?: BotFilter\n}\n\nexport const makeIngestHandler = ({\n\tgeoResolver,\n\tgetBuffer = () => null,\n\tresolvers = {},\n\tattribution = {},\n\tfilterBots = isBot,\n}: IngestHandlerOptions): PayloadHandler => {\n\t// One line per reason for the life of the handler, which is the life of the process: a\n\t// public endpoint must not be a log amplifier, and an attacker chooses how often it drops.\n\tconst warned = new Set<WarnReason>()\n\tconst warnOnce = (req: PayloadRequest, reason: WarnReason): void => {\n\t\tif (!warned.has(reason)) {\n\t\t\twarned.add(reason)\n\t\t\treq.payload.logger?.warn(WARN_REASONS[reason])\n\t\t}\n\t}\n\tconst drop = (req: PayloadRequest, reason: WarnReason): Response => {\n\t\twarnOnce(req, reason)\n\t\treturn accepted()\n\t}\n\n\treturn async (req) => {\n\t\t// First, before the body is even read, so a crawler costs one header lookup. Its beacon\n\t\t// is answered exactly like a kept one and nothing is logged: bots are expected traffic\n\t\t// rather than a misconfiguration an operator has to hear about once per process.\n\t\tconst userAgent = req.headers.get('user-agent') ?? ''\n\t\tlet automated = false\n\t\ttry {\n\t\t\tautomated = filterBots(userAgent)\n\t\t} catch {\n\t\t\twarnOnce(req, 'bot filter threw')\n\t\t}\n\t\tif (automated) {\n\t\t\t// The exception to the silence: an agent-less beacon is indistinguishable from an\n\t\t\t// intermediary stripping the header, which would zero an install's numbers.\n\t\t\tif (userAgent.trim() === '') {\n\t\t\t\twarnOnce(req, 'no user agent')\n\t\t\t}\n\t\t\treturn accepted()\n\t\t}\n\t\tconst { scope: resolveScope, timezone: resolveTimezone, goals: resolveGoals } = resolvers\n\t\t// Read like the capture proxy does, and for the same reasons: this is a public,\n\t\t// unauthenticated path, so the body is capped before it is buffered and a body that\n\t\t// dies in transit (a beacon from an unloading tab) answers 400 rather than throwing.\n\t\tconst read = await readCappedBody(req, MAX_INGEST_BODY_BYTES)\n\t\tif (!read.ok) {\n\t\t\treturn read.reason === 'too-large'\n\t\t\t\t? errorResponse(\n\t\t\t\t\t\t413,\n\t\t\t\t\t\tanalyticsError('payload_too_large', 'analytics: the event body is too large')\n\t\t\t\t\t)\n\t\t\t\t: errorResponse(\n\t\t\t\t\t\t400,\n\t\t\t\t\t\tanalyticsError('invalid_param', 'analytics: the event body could not be read')\n\t\t\t\t\t)\n\t\t}\n\t\tconst raw = parseBody(read.body)\n\t\tif (raw === undefined) {\n\t\t\treturn invalidField('type')\n\t\t}\n\t\tconst param = rawEventError(raw)\n\t\tif (param !== undefined) {\n\t\t\treturn invalidField(param)\n\t\t}\n\t\tconst now = new Date()\n\t\tconst resolvedScope = resolveScope ? await resolveScope(req) : null\n\t\tconst scope = resolveScope ? (resolvedScope ?? '') : undefined\n\t\tconst hostname = await resolveEventHostname({\n\t\t\toption: attribution.hostname ?? REQUEST_HOSTNAME,\n\t\t\tclaimed: raw.hostname,\n\t\t\treq,\n\t\t\tscope: resolvedScope,\n\t\t\ttrustedProxyHops: attribution.trustedProxyHops,\n\t\t})\n\t\tif (hostname === null) {\n\t\t\treturn drop(req, 'hostname refused')\n\t\t}\n\t\t// A scoped install keeps only what a scope answers for. Its platform hostnames are\n\t\t// infrastructure rather than tenants, so they ingest under the null scope.\n\t\tconst unscoped =\n\t\t\tresolveScope !== undefined &&\n\t\t\tresolvedScope === null &&\n\t\t\t!(attribution.platformHostnames?.has(hostname) ?? false)\n\t\tif (unscoped) {\n\t\t\treturn drop(req, 'no scope resolved')\n\t\t}\n\t\tconst salt = await dailySalt(req.payload, now)\n\t\tconst timezone = resolveTimezone ? await resolveTimezone(req, scope ?? null) : undefined\n\t\t// Goals resolve under the same scope the event is stamped with, so a tenant's event\n\t\t// can only ever complete that tenant's goals.\n\t\tconst goals = resolveGoals ? await resolveGoals(req, scope ?? null) : undefined\n\t\tconst event = await normalizeEvent({\n\t\t\traw,\n\t\t\thostname,\n\t\t\theaders: req.headers,\n\t\t\tgeoResolver,\n\t\t\tsalt,\n\t\t\tnow,\n\t\t\tscope,\n\t\t\ttimezone,\n\t\t\tgoals,\n\t\t\ttrustedProxyHops: attribution.trustedProxyHops,\n\t\t})\n\t\tconst buffer = getBuffer()\n\t\tif (buffer) {\n\t\t\tbuffer.add(event)\n\t\t} else {\n\t\t\tawait flushBatch(req.payload, [event])\n\t\t}\n\t\treturn accepted()\n\t}\n}\n"],"mappings":";;;;;;;;;;;;;;AAiCA,MAAM,iBAA2B,SAAS,KAAK,EAAE,IAAI,KAAK,GAAG,EAAE,QAAQ,IAAI,CAAC;AAE5E,MAAM,mBAA2C,EAAE,MAAM,UAAU;;;;;;AAOnE,MAAM,eAAe;CACpB,qBACC;CACD,oBACC;CACD,oBACC;CACD,iBACC;AACF;;AAKA,MAAa,wBAAwB,KAAK;;;;;;AAO1C,MAAM,aAAa,UAAkD;CACpE,IAAI;EACH,MAAM,SAAkB,KAAK,MAAM,IAAI,YAAY,EAAE,OAAO,KAAK,CAAC;EAClE,OAAO,OAAO,WAAW,YAAY,WAAW,OAAQ,SAA2B,KAAA;CACpF,QAAQ;EACP;CACD;AACD;;;;;;AAOA,MAAM,gBAAgB,UACrB,cACC,KACA,eAAe,iBAAiB,cAAc,MAAM,yBAAyB,KAAK,CACnF;AAWD,MAAa,qBAAqB,EACjC,aACA,kBAAkB,MAClB,YAAY,CAAC,GACb,cAAc,CAAC,GACf,aAAa,YAC8B;CAG3C,MAAM,yBAAS,IAAI,IAAgB;CACnC,MAAM,YAAY,KAAqB,WAA6B;EACnE,IAAI,CAAC,OAAO,IAAI,MAAM,GAAG;GACxB,OAAO,IAAI,MAAM;GACjB,IAAI,QAAQ,QAAQ,KAAK,aAAa,OAAO;EAC9C;CACD;CACA,MAAM,QAAQ,KAAqB,WAAiC;EACnE,SAAS,KAAK,MAAM;EACpB,OAAO,SAAS;CACjB;CAEA,OAAO,OAAO,QAAQ;EAIrB,MAAM,YAAY,IAAI,QAAQ,IAAI,YAAY,KAAK;EACnD,IAAI,YAAY;EAChB,IAAI;GACH,YAAY,WAAW,SAAS;EACjC,QAAQ;GACP,SAAS,KAAK,kBAAkB;EACjC;EACA,IAAI,WAAW;GAGd,IAAI,UAAU,KAAK,MAAM,IACxB,SAAS,KAAK,eAAe;GAE9B,OAAO,SAAS;EACjB;EACA,MAAM,EAAE,OAAO,cAAc,UAAU,iBAAiB,OAAO,iBAAiB;EAIhF,MAAM,OAAO,MAAM,eAAe,KAAK,qBAAqB;EAC5D,IAAI,CAAC,KAAK,IACT,OAAO,KAAK,WAAW,cACpB,cACA,KACA,eAAe,qBAAqB,wCAAwC,CAC7E,IACC,cACA,KACA,eAAe,iBAAiB,6CAA6C,CAC9E;EAEH,MAAM,MAAM,UAAU,KAAK,IAAI;EAC/B,IAAI,QAAQ,KAAA,GACX,OAAO,aAAa,MAAM;EAE3B,MAAM,QAAQ,cAAc,GAAG;EAC/B,IAAI,UAAU,KAAA,GACb,OAAO,aAAa,KAAK;EAE1B,MAAM,sBAAM,IAAI,KAAK;EACrB,MAAM,gBAAgB,eAAe,MAAM,aAAa,GAAG,IAAI;EAC/D,MAAM,QAAQ,eAAgB,iBAAiB,KAAM,KAAA;EACrD,MAAM,WAAW,MAAM,qBAAqB;GAC3C,QAAQ,YAAY,YAAY;GAChC,SAAS,IAAI;GACb;GACA,OAAO;GACP,kBAAkB,YAAY;EAC/B,CAAC;EACD,IAAI,aAAa,MAChB,OAAO,KAAK,KAAK,kBAAkB;EAQpC,IAHC,iBAAiB,KAAA,KACjB,kBAAkB,QAClB,EAAE,YAAY,mBAAmB,IAAI,QAAQ,KAAK,QAElD,OAAO,KAAK,KAAK,mBAAmB;EAErC,MAAM,OAAO,MAAM,UAAU,IAAI,SAAS,GAAG;EAC7C,MAAM,WAAW,kBAAkB,MAAM,gBAAgB,KAAK,SAAS,IAAI,IAAI,KAAA;EAG/E,MAAM,QAAQ,eAAe,MAAM,aAAa,KAAK,SAAS,IAAI,IAAI,KAAA;EACtE,MAAM,QAAQ,MAAM,eAAe;GAClC;GACA;GACA,SAAS,IAAI;GACb;GACA;GACA;GACA;GACA;GACA;GACA,kBAAkB,YAAY;EAC/B,CAAC;EACD,MAAM,SAAS,UAAU;EACzB,IAAI,QACH,OAAO,IAAI,KAAK;OAEhB,MAAM,WAAW,IAAI,SAAS,CAAC,KAAK,CAAC;EAEtC,OAAO,SAAS;CACjB;AACD"}
1
+ {"version":3,"file":"endpoint.js","names":[],"sources":["../../../src/native/ingest/endpoint.ts"],"sourcesContent":["import type { Payload, PayloadHandler, PayloadRequest } from 'payload'\nimport { captureRequest } from '../../capture/captureRequest'\nimport { readCappedBody } from '../../capture/requestBody'\nimport { refusedCrossSite, warnUntrustedForwarding } from '../../capture/requestTrust'\nimport { refusedSameSite } from '../../capture/sameSite'\nimport { currentDate } from '../../core/clock'\nimport { monotonicMs } from '../../core/monotonic'\nimport type { CurrencyConverter } from '../../goals/currency'\nimport { type BrowserAmounts, DEFAULT_BROWSER_AMOUNTS } from '../../goals/match'\nimport type { Goal } from '../../goals/types'\nimport type { TrustedPlatform } from '../../net/platform'\nimport { analyticsError, errorResponse } from '../../plugin/errors'\nimport { DEFAULT_TIMEZONE } from '../../timeframe/tz'\nimport type { NativeEngine } from '../engine/engine'\nimport { type DailySalts, saltForHit } from '../engine/salt'\nimport type { SiteHosts } from '../engine/siteHosts'\nimport { toHit } from '../engine/toHit'\nimport type { HitWriter } from '../engine/writeBuffer'\nimport type { GeoResolver } from '../geo/geoResolver'\nimport { serverTwinOf } from '../store/ids'\nimport type { AppendResult } from '../store/types'\nimport { type BotFilter, isBot } from './bots'\nimport {\n\teventTime,\n\ttype ItemIngestOptions,\n\tnormalizeEvent,\n\ttype RawEventInput,\n} from './normalizeEvent'\nimport { type OrderSignatureCheck, wireOrderId } from './orderSignature'\nimport { referrerHost } from './referrer'\nimport { type ResolvedHostnameOption, resolveEventHostname } from './resolveHostname'\nimport { orderDigestKey, warnUnconvertedOnce } from './revenue'\nimport { type RawEventField, rawEventError } from './validate'\n\nexport interface IngestResolvers {\n\t/** `scope.resolve` at the `capture` call site. */\n\tscope?: (req: PayloadRequest) => Promise<string | null>\n\t/**\n\t * Reporting timezone, which picks the day whose salt hashes the visitor. Throws rather than\n\t * answer UTC when the host resolver fails; the scope's last good zone then stands in.\n\t */\n\ttimezone?: (req: PayloadRequest, scope?: string | null) => Promise<string>\n\tcurrency?: (req: PayloadRequest, scope?: string | null) => Promise<string | undefined>\n\tconvertCurrency?: CurrencyConverter\n\tgoals?: (req: PayloadRequest, scope?: string | null) => Promise<Goal[]>\n\t/**\n\t * Whether the scope's provider documents grant it the native engine; answered from the registry\n\t * cache, so it costs no query per beacon.\n\t */\n\tgranted?: (req: PayloadRequest, scope: string | null) => Promise<boolean>\n}\n\n/** How the handler reads the request behind an event, as opposed to what the body claims. */\nexport interface IngestAttribution {\n\ttrustedProxyHops?: number\n\t/** The platform whose edge headers carry the visitor's address and location. */\n\ttrustedPlatform?: TrustedPlatform\n\t/**\n\t * `capture.allowedOrigins`, normalized: the other sites whose pages may send beacons here.\n\t * Absent, every beacon a browser marks `Sec-Fetch-Site: cross-site` is dropped.\n\t */\n\tallowedOrigins?: ReadonlySet<string>\n\t/** Resolved `hostname` option; absent attributes the event to the request's own host. */\n\thostname?: ResolvedHostnameOption\n\t/** Hostnames that ingest on a scoped install even when the request resolves no scope. */\n\tplatformHostnames?: ReadonlySet<string>\n}\n\n/** What one Payload instance stores a beacon's hit through. */\nexport interface IngestTarget {\n\tsalts: Pick<DailySalts, 'forHit' | 'forDay'>\n\twriter: Pick<HitWriter, 'write'>\n\t/** The collections bound as items; absent, every item ref a beacon carries is dropped. */\n\titems?: ItemIngestOptions\n\t/** Asks for maintenance in the background after a hit; it never waits for it. */\n\tnudge?: () => void\n\t/** The hostnames each scope records hits under; absent, only the event's own is the site's. */\n\tsiteHosts?: SiteHosts\n\t/**\n\t * Told when a browser record of an order is stored, so a closed day holding the server's record\n\t * of that sale is counted again: the sale now counts on the browser's record.\n\t */\n\tengine?: Pick<NativeEngine, 'orderStored'>\n\t/** How an order id a page sends is checked; absent, no signature can be. */\n\torders?: OrderSignatureCheck\n\t/** Keeps work running past the response that started it (Next's `after()`). */\n\tkeepAlive?: (work: Promise<unknown>) => void\n}\n\n/**\n * Dropped beacons answer exactly like accepted ones, with nothing logged per event, so the endpoint\n * never tells a prober which hosts or tenants exist.\n */\nconst accepted = (): Response => Response.json({ ok: true }, { status: 202 })\n\nconst REQUEST_HOSTNAME: ResolvedHostnameOption = { kind: 'request' }\n\nconst NO_ORIGINS: ReadonlySet<string> = new Set()\n\n/**\n * Logged once each: a misconfigured resolver, broken filter or header-stripping proxy otherwise\n * costs an install its traffic in silence, since the response cannot say so.\n */\nconst WARN_REASONS = {\n\t'no scope resolved':\n\t\t'analytics: ingest is dropping events because scope.resolve answered no scope for them. Check that resolver, and list any platform domain in platformHostnames so it ingests under the null scope. Logged once per process.',\n\t'no native provider':\n\t\t'analytics: ingest is dropping events for a scope with no enabled native provider document. Add one for that tenant to store its visits here. Logged once per process.',\n\t'hostname refused':\n\t\t'analytics: ingest is dropping events because the hostname option refused the request host. Check that option, and platformHostnames for a platform domain. Logged once per process.',\n\t'bot filter threw':\n\t\t'analytics: the filterBots function threw, so the event was kept. Check that function; every beacon counts while it throws. Logged once per process.',\n\t'no user agent':\n\t\t'analytics: a beacon arrived with no user agent and was not recorded: an intermediary may be stripping the header. Logged once per process.',\n\t'cross-site':\n\t\t\"analytics: ingest is dropping beacons that a page on another site made a visitor's browser send (Sec-Fetch-Site: cross-site). If a site on another domain should send its visits here, list its origin in capture.allowedOrigins. Logged once per process.\",\n\t'other scope':\n\t\t\"analytics: ingest is dropping beacons that a page on a sibling subdomain sent (Sec-Fetch-Site: same-site) whose Origin scope.resolve maps to another scope than the request's. Each tenant's pages post to their own host. Logged once per process.\",\n\t'timezone unresolved':\n\t\t'analytics: ingest hashes visitors by the UTC day for a scope whose reportingTimezone has never resolved: the resolver throws or answers something that is not an IANA timezone. Check that resolver. Logged once per process.',\n\t'order recount failed':\n\t\t\"analytics: a browser's record of an order was stored, but the closed day holding the server's record of it could not be marked to be counted again, so that day keeps the sale until it is rebuilt. Logged once per process.\",\n\t'order refused':\n\t\t'analytics: ingest is dropping sales whose orderId is empty, too long, holds a control character, or lacks the signature signOrderId writes while signatures are required. Logged once per process.',\n} as const\n\ntype WarnReason = keyof typeof WARN_REASONS\n\n/** One line about failed beacons at most this often: a public path must not be a log amplifier. */\nconst FAILED_LOG_MS = 60_000\n\nexport type BeaconFailureLog = (payload: Payload, err: unknown) => void\n\n/** Counts beacons that could not be `what` and logs them in one line at most once a minute. */\nexport const beaconFailureLog = (what: 'stored' | 'taken'): BeaconFailureLog => {\n\tlet failed = 0\n\tlet loggedAt: number | null = null\n\treturn (payload, err) => {\n\t\tfailed += 1\n\t\tconst at = monotonicMs()\n\t\tif (loggedAt !== null && at - loggedAt < FAILED_LOG_MS) {\n\t\t\treturn\n\t\t}\n\t\tloggedAt = at\n\t\tpayload.logger?.error({\n\t\t\terr,\n\t\t\tmsg: `analytics: ${failed} beacons could not be ${what}. Logged at most once a minute.`,\n\t\t})\n\t\tfailed = 0\n\t}\n}\n\n/** One event, not a session replay: far above any legitimate payload, far below a DoS. */\nconst MAX_INGEST_BODY_BYTES = 64 * 1024\n\n/**\n * Undefined for anything unparseable, so a garbage POST is a 400 rather than a thrown error that\n * escapes into Payload's routeError as a logged 500.\n */\nconst parseBody = (bytes: ArrayBuffer): RawEventInput | undefined => {\n\ttry {\n\t\tconst parsed: unknown = JSON.parse(new TextDecoder().decode(bytes))\n\t\t// Unchecked until `rawEventError` runs; every field it skips is sanitized as unknown later.\n\t\treturn typeof parsed === 'object' && parsed !== null ? (parsed as RawEventInput) : undefined\n\t} catch {\n\t\treturn undefined\n\t}\n}\n\n/**\n * Naming the failed field saves a tracker author guessing. A non-object body fails the same check\n * a typeless event does, so it names `type`.\n */\nconst invalidField = (param: RawEventField): Response =>\n\terrorResponse(\n\t\t400,\n\t\tanalyticsError('invalid_param', `analytics: ${param} is missing or invalid`, param)\n\t)\n\nexport interface IngestHandlerOptions {\n\tgeoResolver: GeoResolver\n\t/** The salts, writer and items of the instance a beacon reached. */\n\ttarget: (payload: Payload) => IngestTarget\n\tresolvers?: IngestResolvers\n\tattribution?: IngestAttribution\n\t/** Which agents never reach the pipeline. Defaults to the built-in `isBot`. */\n\tfilterBots?: BotFilter\n\t/** `revenue.browserAmounts`: how far a beacon's amount is believed. Default `'fixed'`. */\n\tbrowserAmounts?: BrowserAmounts\n}\n\n/**\n * Native beacon endpoint: cheap refusals first, then everything resolved as a capture call site\n * sees the request. The only read on the public path is the day's salt, once a day per process.\n */\nexport const makeIngestHandler = ({\n\tgeoResolver,\n\ttarget,\n\tresolvers = {},\n\tattribution = {},\n\tfilterBots = isBot,\n\tbrowserAmounts = DEFAULT_BROWSER_AMOUNTS,\n}: IngestHandlerOptions): PayloadHandler => {\n\t// One line per reason for the life of the handler, which is the life of the process: a\n\t// public endpoint must not be a log amplifier, and an attacker chooses how often it drops.\n\tconst warned = new Set<WarnReason>()\n\tconst warnOnce = (req: PayloadRequest, reason: WarnReason): void => {\n\t\tif (!warned.has(reason)) {\n\t\t\twarned.add(reason)\n\t\t\treq.payload.logger?.warn(WARN_REASONS[reason])\n\t\t}\n\t}\n\tconst drop = (req: PayloadRequest, reason: WarnReason): Response => {\n\t\twarnOnce(req, reason)\n\t\treturn accepted()\n\t}\n\tconst writeFailed = beaconFailureLog('stored')\n\tconst takeFailed = beaconFailureLog('taken')\n\n\tconst take = async (req: PayloadRequest): Promise<Response> => {\n\t\t// Before the body is read, so a crawler costs one header lookup; answered like a kept beacon\n\t\t// and never logged, since bots are expected traffic.\n\t\tconst userAgent = req.headers.get('user-agent') ?? ''\n\t\tlet automated = false\n\t\ttry {\n\t\t\tautomated = filterBots(userAgent)\n\t\t} catch {\n\t\t\twarnOnce(req, 'bot filter threw')\n\t\t}\n\t\tif (automated) {\n\t\t\t// The exception to the silence: an agent-less beacon is indistinguishable from an\n\t\t\t// intermediary stripping the header, which would zero an install's numbers.\n\t\t\tif (userAgent.trim() === '') {\n\t\t\t\twarnOnce(req, 'no user agent')\n\t\t\t}\n\t\t\treturn accepted()\n\t\t}\n\t\t// Another site's page cannot make its visitors count here: the browser says where the\n\t\t// request came from, and only a listed origin may send from elsewhere.\n\t\tif (refusedCrossSite(req.headers, attribution.allowedOrigins ?? NO_ORIGINS)) {\n\t\t\treturn drop(req, 'cross-site')\n\t\t}\n\t\tconst {\n\t\t\tscope: resolveScope,\n\t\t\ttimezone: resolveTimezone,\n\t\t\tcurrency: resolveCurrency,\n\t\t\tgoals: resolveGoals,\n\t\t} = resolvers\n\t\t// A public path: the body is capped before it is buffered, and one that dies in transit (an\n\t\t// unloading tab's beacon) answers 400 rather than throwing.\n\t\tconst read = await readCappedBody(req, MAX_INGEST_BODY_BYTES)\n\t\tif (!read.ok) {\n\t\t\treturn read.reason === 'too-large'\n\t\t\t\t? errorResponse(\n\t\t\t\t\t\t413,\n\t\t\t\t\t\tanalyticsError('payload_too_large', 'analytics: the event body is too large')\n\t\t\t\t\t)\n\t\t\t\t: errorResponse(\n\t\t\t\t\t\t400,\n\t\t\t\t\t\tanalyticsError('invalid_param', 'analytics: the event body could not be read')\n\t\t\t\t\t)\n\t\t}\n\t\tconst raw = parseBody(read.body)\n\t\tif (raw === undefined) {\n\t\t\treturn invalidField('type')\n\t\t}\n\t\tconst param = rawEventError(raw)\n\t\tif (param !== undefined) {\n\t\t\treturn invalidField(param)\n\t\t}\n\t\tconst receivedAt = currentDate()\n\t\tconst at = eventTime(raw, receivedAt)\n\t\t// The host's resolvers are asked about the visit, never the signed-in editor whose session\n\t\t// a beacon carries: the tenant is the site it landed on, not the admin's selection.\n\t\tconst visitor = captureRequest(req)\n\t\tconst resolvedScope = resolveScope ? await resolveScope(visitor) : null\n\t\tconst scope = resolveScope ? (resolvedScope ?? '') : undefined\n\t\tconst hostname = await resolveEventHostname({\n\t\t\toption: attribution.hostname ?? REQUEST_HOSTNAME,\n\t\t\tclaimed: raw.hostname,\n\t\t\treq: visitor,\n\t\t\tscope: resolvedScope,\n\t\t\ttrustedProxyHops: attribution.trustedProxyHops,\n\t\t})\n\t\tif (hostname === null) {\n\t\t\treturn drop(req, 'hostname refused')\n\t\t}\n\t\t// A scoped install keeps only what a scope answers for. Its platform hostnames are\n\t\t// infrastructure rather than tenants, so they ingest under the null scope.\n\t\tconst unscoped =\n\t\t\tresolveScope !== undefined &&\n\t\t\tresolvedScope === null &&\n\t\t\t!(attribution.platformHostnames?.has(hostname) ?? false)\n\t\tif (unscoped) {\n\t\t\treturn drop(req, 'no scope resolved')\n\t\t}\n\t\t// A sibling subdomain is another tenant's site: its pages cannot count into this one.\n\t\tif (\n\t\t\tresolveScope &&\n\t\t\t(await refusedSameSite(visitor, () => Promise.resolve(resolvedScope), resolveScope))\n\t\t) {\n\t\t\treturn drop(req, 'other scope')\n\t\t}\n\t\t// A tenant stores visits only while it says so, checked after the hostname and scope rules\n\t\t// and answered 202 either way, so a forged host cannot probe which tenants exist.\n\t\tif (resolvers.granted && !(await resolvers.granted(visitor, resolvedScope))) {\n\t\t\treturn drop(req, 'no native provider')\n\t\t}\n\t\tconst { salts, writer, items, nudge, siteHosts, engine, orders, keepAlive } = target(\n\t\t\treq.payload\n\t\t)\n\t\t// An order id no key can be stored under is dropped rather than stored as a sale without one,\n\t\t// and answered 202 like any drop: a 400 here would tell a prober the tenant takes beacons.\n\t\tconst order = wireOrderId(raw.orderId, scope ?? '', orders)\n\t\tif (!order.ok) {\n\t\t\treturn drop(req, 'order refused')\n\t\t}\n\t\tconst salt = await saltForHit(\n\t\t\tsalts,\n\t\t\t{\n\t\t\t\tscope: scope ?? '',\n\t\t\t\tat,\n\t\t\t\tzone: () => (resolveTimezone ? resolveTimezone(visitor, scope ?? null) : DEFAULT_TIMEZONE),\n\t\t\t},\n\t\t\t() => warnOnce(req, 'timezone unresolved')\n\t\t)\n\t\t// Goals resolve under the same scope the event is stamped with, so a tenant's event\n\t\t// can only ever complete that tenant's goals. An engagement completes none.\n\t\tconst goals =\n\t\t\tresolveGoals && raw.type !== 'engagement'\n\t\t\t\t? await resolveGoals(visitor, scope ?? null)\n\t\t\t\t: undefined\n\t\tconst reportingCurrency = resolveCurrency\n\t\t\t? await resolveCurrency(visitor, scope ?? null)\n\t\t\t: undefined\n\t\tconst trust = {\n\t\t\ttrustedProxyHops: attribution.trustedProxyHops,\n\t\t\ttrustedPlatform: attribution.trustedPlatform,\n\t\t}\n\t\twarnUntrustedForwarding(req.payload, req.headers, trust)\n\t\t// Only a pageview from another host needs the scope's hostnames: is it a sibling's page?\n\t\tconst siblings =\n\t\t\tsiteHosts && raw.type === 'pageview' && referrerHost(raw.referrer, hostname) !== undefined\n\t\t\t\t? await siteHosts.of(scope ?? '')\n\t\t\t\t: undefined\n\t\tconst event = await normalizeEvent({\n\t\t\traw: { ...raw, orderId: order.orderId },\n\t\t\thostname,\n\t\t\theaders: req.headers,\n\t\t\tgeoResolver,\n\t\t\twarnGeo: (message) => req.payload.logger?.warn(message),\n\t\t\tsalt,\n\t\t\tnow: at,\n\t\t\tscope,\n\t\t\tgoals,\n\t\t\torigin: 'wire',\n\t\t\tbrowserAmounts,\n\t\t\treportingCurrency,\n\t\t\tconvertCurrency: resolvers.convertCurrency,\n\t\t\twarnUnconverted: () => warnUnconvertedOnce(req.payload.logger),\n\t\t\t...trust,\n\t\t\t...(items ? { items } : {}),\n\t\t\t...(siblings ? { siblings } : {}),\n\t\t\torderKey: orderDigestKey(req.payload?.secret),\n\t\t})\n\t\t// Nothing left to add once sanitized: no time, no scroll and no item seen moves no number.\n\t\tif (\n\t\t\tevent.type === 'engagement' &&\n\t\t\t!event.durationMs &&\n\t\t\t!event.scrollDepth &&\n\t\t\t!event.impressions?.length\n\t\t) {\n\t\t\treturn accepted()\n\t\t}\n\t\t// A retried order meets its own primary key and is refused there; nothing is read first,\n\t\t// since a read per beacon on a public path is a query anyone can repeat at will.\n\t\tconst hit = toHit(event, { receivedAt })\n\t\tlet stored: AppendResult | undefined\n\t\ttry {\n\t\t\tstored = await writer.write(hit)\n\t\t\tsiteHosts?.saw(scope ?? '', hostname)\n\t\t} catch (err) {\n\t\t\twriteFailed(req.payload, err)\n\t\t}\n\t\t// For an order the write just stored, never a repeat of one: one primary key lookup of the\n\t\t// server's record, past the response. Maintenance sweeps the orders again in case it is lost.\n\t\tif (engine && (stored?.written ?? 0) > 0 && serverTwinOf(hit.id) !== undefined) {\n\t\t\tconst probe = engine\n\t\t\t\t.orderStored(scope ?? '', hit.id)\n\t\t\t\t.catch(() => warnOnce(req, 'order recount failed'))\n\t\t\tkeepAlive?.(probe)\n\t\t}\n\t\tnudge?.()\n\t\treturn accepted()\n\t}\n\n\treturn async (req) => {\n\t\ttry {\n\t\t\treturn await take(req)\n\t\t} catch (err) {\n\t\t\t// A host resolver or a store failing must not reach Payload's routeError as a logged 500\n\t\t\t// per beacon: a public path answers its own envelope and logs at most once a minute.\n\t\t\ttakeFailed(req.payload, err)\n\t\t\treturn errorResponse(500, analyticsError('internal', 'analytics: the beacon failed'))\n\t\t}\n\t}\n}\n"],"mappings":"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"}
@@ -0,0 +1,26 @@
1
+ import { AnalyticsAttributes } from "../../exports/attributes.js";
2
+ import { Payload } from "payload";
3
+
4
+ //#region src/native/ingest/itemSignature.d.ts
5
+ /**
6
+ * `required` (default) keeps only server-signed refs, so a page script cannot invent items;
7
+ * `optional` also keeps unsigned ones, for a site that cannot sign where it writes refs.
8
+ */
9
+ type ItemSignatureMode = 'required' | 'optional';
10
+ /**
11
+ * `data-analytics-item` value for a document (`offers:12@<signature>`), undefined for an id the
12
+ * collection cannot hold. Call it during server rendering; the browser never sees the key.
13
+ */
14
+ declare const signItemRef: (payload: Payload, collection: string, id: string | number | null | undefined) => string | undefined;
15
+ /**
16
+ * `itemAttributes` with a signed ref, to spread on the element showing the item in a server
17
+ * component. Spreads to nothing for an item {@link signItemRef} cannot sign.
18
+ */
19
+ declare const itemAttributesFor: (payload: Payload, item: {
20
+ collection: string;
21
+ id: string | number | null | undefined;
22
+ name?: string | null;
23
+ }) => AnalyticsAttributes;
24
+ //#endregion
25
+ export { ItemSignatureMode, itemAttributesFor, signItemRef };
26
+ //# sourceMappingURL=itemSignature.d.ts.map
@@ -0,0 +1,45 @@
1
+ import { labelledKey, sameSignature, shortSignature } from "./signature.js";
2
+ import { fitsIdType } from "../../items/idType.js";
3
+ import { itemRefOf, parseItemValue } from "../../items/ref.js";
4
+ import { itemAttributes } from "../../exports/attributes.js";
5
+ import { itemIdTypeOf } from "../../items/collectionIdType.js";
6
+ //#region src/native/ingest/itemSignature.ts
7
+ /** The key item refs are signed with, derived from the instance's secret. */
8
+ const itemRefKey = labelledKey("analytics:item-ref:v1");
9
+ /** The signature of one ref: 72 bits of its HMAC, base64url. */
10
+ const itemRefSignature = (key, ref) => shortSignature(key, ref);
11
+ /**
12
+ * Ref ingest may keep: a signed value only with the server's signature, an unsigned one only when
13
+ * signatures are optional or the event is trusted server code.
14
+ */
15
+ const verifiedItemRef = (value, check, trusted) => {
16
+ const parsed = parseItemValue(value);
17
+ if (!parsed) return;
18
+ if (parsed.signature === void 0) return trusted || check?.mode === "optional" ? parsed.ref : void 0;
19
+ return check && sameSignature(itemRefSignature(check.key, parsed.ref), parsed.signature) ? parsed.ref : void 0;
20
+ };
21
+ /**
22
+ * `data-analytics-item` value for a document (`offers:12@<signature>`), undefined for an id the
23
+ * collection cannot hold. Call it during server rendering; the browser never sees the key.
24
+ */
25
+ const signItemRef = (payload, collection, id) => {
26
+ const slug = collection.trim();
27
+ const ref = slug === "" ? void 0 : itemRefOf(slug, id);
28
+ if (ref === void 0 || !fitsIdType(String(id), itemIdTypeOf(payload, slug))) return;
29
+ return `${ref}@${itemRefSignature(itemRefKey(payload.secret), ref)}`;
30
+ };
31
+ /**
32
+ * `itemAttributes` with a signed ref, to spread on the element showing the item in a server
33
+ * component. Spreads to nothing for an item {@link signItemRef} cannot sign.
34
+ */
35
+ const itemAttributesFor = (payload, item) => {
36
+ const ref = signItemRef(payload, item.collection, item.id);
37
+ return ref === void 0 ? {} : itemAttributes({
38
+ ref,
39
+ name: item.name
40
+ });
41
+ };
42
+ //#endregion
43
+ export { itemAttributesFor, itemRefKey, signItemRef, verifiedItemRef };
44
+
45
+ //# sourceMappingURL=itemSignature.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"itemSignature.js","names":[],"sources":["../../../src/native/ingest/itemSignature.ts"],"sourcesContent":["import type { Payload } from 'payload'\nimport { type AnalyticsAttributes, itemAttributes } from '../../exports/attributes'\nimport { ITEM_SIGNATURE_SEPARATOR } from '../../goals/constants'\nimport { itemIdTypeOf } from '../../items/collectionIdType'\nimport { fitsIdType } from '../../items/idType'\nimport { itemRefOf, parseItemValue } from '../../items/ref'\nimport { labelledKey, sameSignature, shortSignature } from './signature'\n\n/**\n * `required` (default) keeps only server-signed refs, so a page script cannot invent items;\n * `optional` also keeps unsigned ones, for a site that cannot sign where it writes refs.\n */\nexport type ItemSignatureMode = 'required' | 'optional'\n\nexport interface ItemSignatureCheck {\n\tmode: ItemSignatureMode\n\tkey: Buffer\n}\n\n/** The key item refs are signed with, derived from the instance's secret. */\nexport const itemRefKey = labelledKey('analytics:item-ref:v1')\n\n/** The signature of one ref: 72 bits of its HMAC, base64url. */\nexport const itemRefSignature = (key: Buffer, ref: string): string => shortSignature(key, ref)\n\n/**\n * Ref ingest may keep: a signed value only with the server's signature, an unsigned one only when\n * signatures are optional or the event is trusted server code.\n */\nexport const verifiedItemRef = (\n\tvalue: unknown,\n\tcheck: ItemSignatureCheck | undefined,\n\ttrusted: boolean\n): string | undefined => {\n\tconst parsed = parseItemValue(value)\n\tif (!parsed) {\n\t\treturn undefined\n\t}\n\tif (parsed.signature === undefined) {\n\t\treturn trusted || check?.mode === 'optional' ? parsed.ref : undefined\n\t}\n\treturn check && sameSignature(itemRefSignature(check.key, parsed.ref), parsed.signature)\n\t\t? parsed.ref\n\t\t: undefined\n}\n\n/**\n * `data-analytics-item` value for a document (`offers:12@<signature>`), undefined for an id the\n * collection cannot hold. Call it during server rendering; the browser never sees the key.\n */\nexport const signItemRef = (\n\tpayload: Payload,\n\tcollection: string,\n\tid: string | number | null | undefined\n): string | undefined => {\n\tconst slug = collection.trim()\n\tconst ref = slug === '' ? undefined : itemRefOf(slug, id)\n\tif (ref === undefined || !fitsIdType(String(id), itemIdTypeOf(payload, slug))) {\n\t\treturn undefined\n\t}\n\treturn `${ref}${ITEM_SIGNATURE_SEPARATOR}${itemRefSignature(itemRefKey(payload.secret), ref)}`\n}\n\n/**\n * `itemAttributes` with a signed ref, to spread on the element showing the item in a server\n * component. Spreads to nothing for an item {@link signItemRef} cannot sign.\n */\nexport const itemAttributesFor = (\n\tpayload: Payload,\n\titem: { collection: string; id: string | number | null | undefined; name?: string | null }\n): AnalyticsAttributes => {\n\tconst ref = signItemRef(payload, item.collection, item.id)\n\treturn ref === undefined ? {} : itemAttributes({ ref, name: item.name })\n}\n"],"mappings":";;;;;;;AAoBA,MAAa,aAAa,YAAY,uBAAuB;;AAG7D,MAAa,oBAAoB,KAAa,QAAwB,eAAe,KAAK,GAAG;;;;;AAM7F,MAAa,mBACZ,OACA,OACA,YACwB;CACxB,MAAM,SAAS,eAAe,KAAK;CACnC,IAAI,CAAC,QACJ;CAED,IAAI,OAAO,cAAc,KAAA,GACxB,OAAO,WAAW,OAAO,SAAS,aAAa,OAAO,MAAM,KAAA;CAE7D,OAAO,SAAS,cAAc,iBAAiB,MAAM,KAAK,OAAO,GAAG,GAAG,OAAO,SAAS,IACpF,OAAO,MACP,KAAA;AACJ;;;;;AAMA,MAAa,eACZ,SACA,YACA,OACwB;CACxB,MAAM,OAAO,WAAW,KAAK;CAC7B,MAAM,MAAM,SAAS,KAAK,KAAA,IAAY,UAAU,MAAM,EAAE;CACxD,IAAI,QAAQ,KAAA,KAAa,CAAC,WAAW,OAAO,EAAE,GAAG,aAAa,SAAS,IAAI,CAAC,GAC3E;CAED,OAAO,GAAG,OAAiC,iBAAiB,WAAW,QAAQ,MAAM,GAAG,GAAG;AAC5F;;;;;AAMA,MAAa,qBACZ,SACA,SACyB;CACzB,MAAM,MAAM,YAAY,SAAS,KAAK,YAAY,KAAK,EAAE;CACzD,OAAO,QAAQ,KAAA,IAAY,CAAC,IAAI,eAAe;EAAE;EAAK,MAAM,KAAK;CAAK,CAAC;AACxE"}
@@ -1,7 +1,6 @@
1
1
  /**
2
- * The visitor's preferred language from an `Accept-Language` header: the first tag, without
3
- * its quality factor, lowercased (`de-DE,de;q=0.9` becomes `de-de`). A wildcard or an absent
4
- * header states no preference, so nothing is reported.
2
+ * First `Accept-Language` tag without its quality factor, lowercased (`de-DE,de;q=0.9` gives
3
+ * `de-de`). A wildcard or absent header states no preference.
5
4
  */
6
5
  const primaryLanguage = (acceptLanguage) => {
7
6
  const tag = acceptLanguage?.split(",")[0]?.split(";")[0]?.trim().toLowerCase();
@@ -1 +1 @@
1
- {"version":3,"file":"language.js","names":[],"sources":["../../../src/native/ingest/language.ts"],"sourcesContent":["/** Long enough for any real BCP 47 tag; a longer one is junk, not a language. */\nexport const MAX_LANGUAGE_LENGTH = 16\n\n/**\n * The visitor's preferred language from an `Accept-Language` header: the first tag, without\n * its quality factor, lowercased (`de-DE,de;q=0.9` becomes `de-de`). A wildcard or an absent\n * header states no preference, so nothing is reported.\n */\nexport const primaryLanguage = (acceptLanguage: string | null): string | undefined => {\n\tconst tag = acceptLanguage?.split(',')[0]?.split(';')[0]?.trim().toLowerCase()\n\tif (!tag || tag === '*') {\n\t\treturn undefined\n\t}\n\treturn tag.slice(0, MAX_LANGUAGE_LENGTH)\n}\n"],"mappings":";;;;;AAQA,MAAa,mBAAmB,mBAAsD;CACrF,MAAM,MAAM,gBAAgB,MAAM,GAAG,EAAE,IAAI,MAAM,GAAG,EAAE,IAAI,KAAK,EAAE,YAAY;CAC7E,IAAI,CAAC,OAAO,QAAQ,KACnB;CAED,OAAO,IAAI,MAAM,GAAA,EAAsB;AACxC"}
1
+ {"version":3,"file":"language.js","names":[],"sources":["../../../src/native/ingest/language.ts"],"sourcesContent":["/** Long enough for any real BCP 47 tag; a longer one is junk, not a language. */\nexport const MAX_LANGUAGE_LENGTH = 16\n\n/**\n * First `Accept-Language` tag without its quality factor, lowercased (`de-DE,de;q=0.9` gives\n * `de-de`). A wildcard or absent header states no preference.\n */\nexport const primaryLanguage = (acceptLanguage: string | null): string | undefined => {\n\tconst tag = acceptLanguage?.split(',')[0]?.split(';')[0]?.trim().toLowerCase()\n\tif (!tag || tag === '*') {\n\t\treturn undefined\n\t}\n\treturn tag.slice(0, MAX_LANGUAGE_LENGTH)\n}\n"],"mappings":";;;;AAOA,MAAa,mBAAmB,mBAAsD;CACrF,MAAM,MAAM,gBAAgB,MAAM,GAAG,EAAE,IAAI,MAAM,GAAG,EAAE,IAAI,KAAK,EAAE,YAAY;CAC7E,IAAI,CAAC,OAAO,QAAQ,KACnB;CAED,OAAO,IAAI,MAAM,GAAA,EAAsB;AACxC"}
@@ -1,8 +1,13 @@
1
+ import { HitType } from "../store/types.js";
1
2
  //#region src/native/ingest/normalizeEvent.d.ts
2
- type EventType = 'pageview' | 'event' | 'goal';
3
+ /**
4
+ * One event as the tracker or `trackServerEvent` sends it, before the ingest normalizes it.
5
+ * @beta
6
+ */
3
7
  interface RawEventInput {
4
- type: EventType;
5
- /** Event name, or the goal slug on a `goal`. Absent on pageviews. */
8
+ /** An `engagement` gets a row of its own so a filtered read finds it, never counted as a hit. */
9
+ type: HitType;
10
+ /** Event name, or the goal slug on a `goal`. Absent on a pageview and an engagement. */
6
11
  name?: string;
7
12
  path: string;
8
13
  /**
@@ -12,18 +17,66 @@ interface RawEventInput {
12
17
  hostname?: string;
13
18
  referrer?: string;
14
19
  /**
15
- * The page's query string, without its leading `?`. Read for its utm keys and then
16
- * discarded: it is never stored, so a session token or an email address that happens to
17
- * be in the URL never lands in the events collection.
20
+ * Query string without its leading `?`. Read for campaign keys and never stored, so a session
21
+ * token or email address in the URL never lands in a hit.
18
22
  */
19
23
  query?: string;
24
+ /**
25
+ * Engaged time an engagement adds. Kept on a pageview too, which is what a tracker cached
26
+ * from before engagement existed still sends; dropped on every other type.
27
+ */
20
28
  durationMs?: number;
29
+ /**
30
+ * On an engagement only: ms since its pageview was sent, by the page's own clock so the device's
31
+ * date never matters. Read by {@link eventTime}, never stored.
32
+ */
33
+ sinceMs?: number;
34
+ /**
35
+ * How long the event waited in the page before it was sent, by the page's own clock: a pending
36
+ * gate or a prerender held it. Read by {@link eventTime}, never stored.
37
+ */
38
+ ageMs?: number;
39
+ /** `1` on a pageview a single-page app made in place, without loading a document. */
40
+ nav?: number;
21
41
  props?: Record<string, unknown>;
22
42
  /** Revenue for a goal completion, in `currency`. */
23
43
  value?: number;
24
44
  currency?: string;
25
- /** Max scroll depth reached on a pageview, 0-100. */
45
+ /**
46
+ * The lines of a sale. Sanitized and stored under `props.items`, so a read of the event
47
+ * carries the order without a second collection.
48
+ */
49
+ items?: unknown;
50
+ /**
51
+ * Marks a server `purchase` or `refund`, the one path a negative `value` is allowed on. The wire
52
+ * refuses it: a forged refund subtracts from revenue it never added to.
53
+ */
54
+ revenue?: boolean;
55
+ /**
56
+ * The order this amount belongs to. The order's hit is keyed by a digest of it, so a retried
57
+ * payment webhook counts once however often it arrives; the id itself is stored nowhere.
58
+ */
59
+ orderId?: string;
60
+ /**
61
+ * On a server refund, the refund's own id as the payment provider names it: it joins the order
62
+ * id in the refund's key, so each partial refund counts once however often it is retried.
63
+ */
64
+ refundId?: string;
65
+ /**
66
+ * On a pageview, its scroll depth, 0 when the tracker measures it afterwards; on an
67
+ * engagement, how much deeper the page was scrolled since the previous one. 0-100.
68
+ */
26
69
  scrollDepth?: number;
70
+ /**
71
+ * Item ref (`<collection>:<id>`), server-signed when a page sends it (`offers:12@<signature>`).
72
+ * Dropped, keeping the event, unless verified and of a collection bound as an item.
73
+ */
74
+ item?: string;
75
+ /**
76
+ * On an engagement only: item values seen since the previous one, each checked like `item` and
77
+ * capped at one beacon's worth.
78
+ */
79
+ impressions?: unknown;
27
80
  }
28
81
  //#endregion
29
82
  export { RawEventInput };