@10x-media/analytics 1.0.0-beta.8 → 4.0.0-alpha.1

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 (1273) hide show
  1. package/CHANGELOG.md +780 -0
  2. package/LICENSE +21 -21
  3. package/README.md +35 -36
  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 +19 -0
  18. package/dist/adapters/ga4/disableKey.js.map +1 -0
  19. package/dist/adapters/ga4/eventName.d.ts +9 -0
  20. package/dist/adapters/ga4/eventName.js +13 -0
  21. package/dist/adapters/ga4/eventName.js.map +1 -0
  22. package/dist/adapters/ga4/ga4.d.ts +29 -0
  23. package/dist/adapters/ga4/ga4.js +324 -112
  24. package/dist/adapters/ga4/ga4.js.map +1 -1
  25. package/dist/adapters/ga4/measurementId.js +14 -0
  26. package/dist/adapters/ga4/measurementId.js.map +1 -0
  27. package/dist/adapters/goalRead.js +112 -0
  28. package/dist/adapters/goalRead.js.map +1 -0
  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 +30 -3
  37. package/dist/adapters/plausible/plausible.js +198 -110
  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 +33 -9
  42. package/dist/adapters/posthog/posthog.js +307 -127
  43. package/dist/adapters/posthog/posthog.js.map +1 -1
  44. package/dist/adapters/posthog/projectCheck.js +56 -0
  45. package/dist/adapters/posthog/projectCheck.js.map +1 -0
  46. package/dist/adapters/readTime.js +7 -0
  47. package/dist/adapters/readTime.js.map +1 -0
  48. package/dist/adapters/series.js +14 -8
  49. package/dist/adapters/series.js.map +1 -1
  50. package/dist/adapters/umami/umami.d.ts +21 -3
  51. package/dist/adapters/umami/umami.js +334 -95
  52. package/dist/adapters/umami/umami.js.map +1 -1
  53. package/dist/adapters/upstream.js +16 -0
  54. package/dist/adapters/upstream.js.map +1 -0
  55. package/dist/binding/report.d.ts +8 -0
  56. package/dist/binding/report.js +24 -0
  57. package/dist/binding/report.js.map +1 -0
  58. package/dist/binding/resolvePath.js +28 -25
  59. package/dist/binding/resolvePath.js.map +1 -1
  60. package/dist/binding/types.d.ts +14 -29
  61. package/dist/capture/captureRequest.js +28 -0
  62. package/dist/capture/captureRequest.js.map +1 -0
  63. package/dist/capture/exclusionEndpoint.js +98 -0
  64. package/dist/capture/exclusionEndpoint.js.map +1 -0
  65. package/dist/capture/exclusionPrelude.js +14 -0
  66. package/dist/capture/exclusionPrelude.js.map +1 -0
  67. package/dist/capture/exclusionToken.js +23 -0
  68. package/dist/capture/exclusionToken.js.map +1 -0
  69. package/dist/capture/jsLiteral.js +19 -0
  70. package/dist/capture/jsLiteral.js.map +1 -0
  71. package/dist/capture/mountPath.js +2 -3
  72. package/dist/capture/mountPath.js.map +1 -1
  73. package/dist/capture/proxyEndpoint.js +49 -92
  74. package/dist/capture/proxyEndpoint.js.map +1 -1
  75. package/dist/capture/proxyRoutes.js +58 -21
  76. package/dist/capture/proxyRoutes.js.map +1 -1
  77. package/dist/capture/relay.js +91 -0
  78. package/dist/capture/relay.js.map +1 -0
  79. package/dist/capture/requestBody.js +2 -6
  80. package/dist/capture/requestBody.js.map +1 -1
  81. package/dist/capture/requestTrust.js +45 -0
  82. package/dist/capture/requestTrust.js.map +1 -0
  83. package/dist/capture/sameSite.js +40 -0
  84. package/dist/capture/sameSite.js.map +1 -0
  85. package/dist/capture/slots.js +50 -25
  86. package/dist/capture/slots.js.map +1 -1
  87. package/dist/capture/trackerConfig.js +131 -36
  88. package/dist/capture/trackerConfig.js.map +1 -1
  89. package/dist/capture/trackerEndpoint.js +22 -21
  90. package/dist/capture/trackerEndpoint.js.map +1 -1
  91. package/dist/capture/withoutConsent.js +91 -0
  92. package/dist/capture/withoutConsent.js.map +1 -0
  93. package/dist/charts/BarList.d.ts +27 -13
  94. package/dist/charts/BarList.js +38 -77
  95. package/dist/charts/BarList.js.map +1 -1
  96. package/dist/charts/TrendChart.d.ts +40 -7
  97. package/dist/charts/TrendChart.js +243 -215
  98. package/dist/charts/TrendChart.js.map +1 -1
  99. package/dist/charts/bars.d.ts +17 -1
  100. package/dist/charts/bars.js +12 -11
  101. package/dist/charts/bars.js.map +1 -1
  102. package/dist/charts/bucket.js +106 -73
  103. package/dist/charts/bucket.js.map +1 -1
  104. package/dist/charts/inProgress.js +22 -0
  105. package/dist/charts/inProgress.js.map +1 -0
  106. package/dist/charts/series.d.ts +15 -0
  107. package/dist/charts/series.js +123 -0
  108. package/dist/charts/series.js.map +1 -0
  109. package/dist/charts/spline.js +91 -25
  110. package/dist/charts/spline.js.map +1 -1
  111. package/dist/charts/trendGeometry.js +91 -0
  112. package/dist/charts/trendGeometry.js.map +1 -0
  113. package/dist/core/adminOptions.d.ts +1 -0
  114. package/dist/core/adminOptions.js +198 -0
  115. package/dist/core/adminOptions.js.map +1 -0
  116. package/dist/core/budget.js +24 -0
  117. package/dist/core/budget.js.map +1 -0
  118. package/dist/core/cacheKey.d.ts +1 -0
  119. package/dist/core/cacheKey.js +51 -29
  120. package/dist/core/cacheKey.js.map +1 -1
  121. package/dist/core/cacheOptions.js +165 -0
  122. package/dist/core/cacheOptions.js.map +1 -0
  123. package/dist/core/capabilities.d.ts +24 -11
  124. package/dist/core/capabilities.js +101 -17
  125. package/dist/core/capabilities.js.map +1 -1
  126. package/dist/core/capture.d.ts +59 -26
  127. package/dist/core/captureOptions.d.ts +1 -0
  128. package/dist/core/captureOptions.js +347 -0
  129. package/dist/core/captureOptions.js.map +1 -0
  130. package/dist/core/clock.js +13 -0
  131. package/dist/core/clock.js.map +1 -0
  132. package/dist/core/collectionOption.d.ts +17 -0
  133. package/dist/core/collectionOption.js +105 -0
  134. package/dist/core/collectionOption.js.map +1 -0
  135. package/dist/core/collectionSlug.js +7 -0
  136. package/dist/core/collectionSlug.js.map +1 -0
  137. package/dist/core/contract.d.ts +340 -49
  138. package/dist/core/contract.js +7 -4
  139. package/dist/core/contract.js.map +1 -1
  140. package/dist/core/cron.js +57 -0
  141. package/dist/core/cron.js.map +1 -0
  142. package/dist/core/fetch.d.ts +17 -0
  143. package/dist/core/goalOptions.d.ts +1 -0
  144. package/dist/core/goalOptions.js +166 -0
  145. package/dist/core/goalOptions.js.map +1 -0
  146. package/dist/core/granularity.js +3 -2
  147. package/dist/core/granularity.js.map +1 -1
  148. package/dist/core/guards.js +17 -0
  149. package/dist/core/guards.js.map +1 -0
  150. package/dist/core/jobs.d.ts +40 -0
  151. package/dist/core/jobs.js +132 -0
  152. package/dist/core/jobs.js.map +1 -0
  153. package/dist/core/legacyOptions.js +145 -0
  154. package/dist/core/legacyOptions.js.map +1 -0
  155. package/dist/core/metricAliases.js +81 -0
  156. package/dist/core/metricAliases.js.map +1 -0
  157. package/dist/core/metricValues.js +57 -0
  158. package/dist/core/metricValues.js.map +1 -0
  159. package/dist/core/monotonic.js +10 -0
  160. package/dist/core/monotonic.js.map +1 -0
  161. package/dist/core/optionChecks.js +51 -0
  162. package/dist/core/optionChecks.js.map +1 -0
  163. package/dist/core/options.d.ts +535 -151
  164. package/dist/core/options.js +158 -214
  165. package/dist/core/options.js.map +1 -1
  166. package/dist/core/registry.js +45 -5
  167. package/dist/core/registry.js.map +1 -1
  168. package/dist/core/scopeList.js +7 -9
  169. package/dist/core/scopeList.js.map +1 -1
  170. package/dist/core/scopeOptions.d.ts +1 -0
  171. package/dist/core/scopeOptions.js +114 -0
  172. package/dist/core/scopeOptions.js.map +1 -0
  173. package/dist/core/scopedRead.js +349 -36
  174. package/dist/core/scopedRead.js.map +1 -1
  175. package/dist/core/sdks.d.ts +81 -0
  176. package/dist/core/sdks.js +23 -0
  177. package/dist/core/sdks.js.map +1 -0
  178. package/dist/core/serverEvent.d.ts +50 -14
  179. package/dist/core/serverEvent.js.map +1 -1
  180. package/dist/core/siteAddress.js +20 -0
  181. package/dist/core/siteAddress.js.map +1 -0
  182. package/dist/core/sourceErrors.js +109 -0
  183. package/dist/core/sourceErrors.js.map +1 -0
  184. package/dist/core/sourceLabel.d.ts +10 -0
  185. package/dist/core/sourceLabel.js +63 -0
  186. package/dist/core/sourceLabel.js.map +1 -0
  187. package/dist/core/sourceOptions.js +107 -0
  188. package/dist/core/sourceOptions.js.map +1 -0
  189. package/dist/core/sourcePolicy.d.ts +55 -0
  190. package/dist/core/sourcePolicy.js +51 -0
  191. package/dist/core/sourcePolicy.js.map +1 -0
  192. package/dist/core/throttle.js +18 -0
  193. package/dist/core/throttle.js.map +1 -0
  194. package/dist/core/values.js +61 -0
  195. package/dist/core/values.js.map +1 -0
  196. package/dist/core/widgetSlugs.d.ts +17 -0
  197. package/dist/core/widgetSlugs.js +29 -0
  198. package/dist/core/widgetSlugs.js.map +1 -0
  199. package/dist/db/detachedWrite.js +36 -0
  200. package/dist/db/detachedWrite.js.map +1 -0
  201. package/dist/db/errors.js +182 -0
  202. package/dist/db/errors.js.map +1 -0
  203. package/dist/db/kind.js +32 -0
  204. package/dist/db/kind.js.map +1 -0
  205. package/dist/db/openTransaction.js +51 -0
  206. package/dist/db/openTransaction.js.map +1 -0
  207. package/dist/exports/adapters/contract.d.ts +15 -0
  208. package/dist/exports/adapters/ga4.d.ts +17 -1
  209. package/dist/exports/adapters/ga4.js +2 -1
  210. package/dist/exports/adapters/native.d.ts +29 -2
  211. package/dist/exports/adapters/native.js +5 -1
  212. package/dist/exports/adapters/plausible.d.ts +16 -1
  213. package/dist/exports/adapters/posthog.d.ts +16 -1
  214. package/dist/exports/adapters/umami.d.ts +16 -1
  215. package/dist/exports/attributes.d.ts +42 -0
  216. package/dist/exports/attributes.js +83 -0
  217. package/dist/exports/attributes.js.map +1 -0
  218. package/dist/exports/client.d.ts +45 -11
  219. package/dist/exports/client.js +23 -6
  220. package/dist/exports/geo.d.ts +4 -2
  221. package/dist/exports/geo.js +1 -1
  222. package/dist/exports/i18n.d.ts +2 -2
  223. package/dist/exports/i18n.js +2 -2
  224. package/dist/exports/migrations.d.ts +2 -0
  225. package/dist/exports/migrations.js +2 -0
  226. package/dist/exports/react.d.ts +5 -3
  227. package/dist/exports/react.js +1 -2
  228. package/dist/exports/routes.d.ts +19 -0
  229. package/dist/exports/routes.js +3 -0
  230. package/dist/exports/rsc.d.ts +33 -14
  231. package/dist/exports/rsc.js +11 -6
  232. package/dist/exports/site.d.ts +5 -0
  233. package/dist/exports/site.js +3 -0
  234. package/dist/exports/testing.d.ts +18 -0
  235. package/dist/exports/testing.js +3 -0
  236. package/dist/exports/tracker.d.ts +6 -17
  237. package/dist/exports/tracker.js +3 -11
  238. package/dist/exports/types.d.ts +46 -14
  239. package/dist/exports/types.js +7 -1
  240. package/dist/fields/AnalyticsPanelClient.js +265 -154
  241. package/dist/fields/AnalyticsPanelClient.js.map +1 -1
  242. package/dist/fields/AnalyticsPanelField.d.ts +19 -7
  243. package/dist/fields/AnalyticsPanelField.js +123 -30
  244. package/dist/fields/AnalyticsPanelField.js.map +1 -1
  245. package/dist/fields/AnalyticsStatField.d.ts +17 -6
  246. package/dist/fields/AnalyticsStatField.js +98 -63
  247. package/dist/fields/AnalyticsStatField.js.map +1 -1
  248. package/dist/fields/FieldShimmer.js +15 -0
  249. package/dist/fields/FieldShimmer.js.map +1 -0
  250. package/dist/fields/PanelContent.js +222 -0
  251. package/dist/fields/PanelContent.js.map +1 -0
  252. package/dist/fields/PanelList.js +82 -0
  253. package/dist/fields/PanelList.js.map +1 -0
  254. package/dist/fields/PanelLiveCounter.js +63 -0
  255. package/dist/fields/PanelLiveCounter.js.map +1 -0
  256. package/dist/fields/PanelSkeleton.js +63 -0
  257. package/dist/fields/PanelSkeleton.js.map +1 -0
  258. package/dist/fields/componentPaths.js +8 -0
  259. package/dist/fields/componentPaths.js.map +1 -0
  260. package/dist/fields/config/FilterDimensionSelectField.d.ts +14 -0
  261. package/dist/fields/config/FilterDimensionSelectField.js +49 -0
  262. package/dist/fields/config/FilterDimensionSelectField.js.map +1 -0
  263. package/dist/fields/config/FilterKeySelect.js +66 -0
  264. package/dist/fields/config/FilterKeySelect.js.map +1 -0
  265. package/dist/fields/config/FilterOperatorSelectField.d.ts +19 -0
  266. package/dist/fields/config/FilterOperatorSelectField.js +59 -0
  267. package/dist/fields/config/FilterOperatorSelectField.js.map +1 -0
  268. package/dist/fields/config/FilterValueField.d.ts +17 -0
  269. package/dist/fields/config/FilterValueField.js +130 -0
  270. package/dist/fields/config/FilterValueField.js.map +1 -0
  271. package/dist/fields/config/MetricSelectField.d.ts +5 -12
  272. package/dist/fields/config/MetricSelectField.js +19 -31
  273. package/dist/fields/config/MetricSelectField.js.map +1 -1
  274. package/dist/fields/config/OptionSelect.js +52 -0
  275. package/dist/fields/config/OptionSelect.js.map +1 -0
  276. package/dist/fields/config/SourceSelectField.js +16 -31
  277. package/dist/fields/config/SourceSelectField.js.map +1 -1
  278. package/dist/fields/config/fetchSources.d.ts +3 -0
  279. package/dist/fields/config/fetchSources.js +17 -23
  280. package/dist/fields/config/fetchSources.js.map +1 -1
  281. package/dist/fields/config/filterValues.js +106 -0
  282. package/dist/fields/config/filterValues.js.map +1 -0
  283. package/dist/fields/config/narrow.js +8 -10
  284. package/dist/fields/config/narrow.js.map +1 -1
  285. package/dist/fields/config/retiredPickers.d.ts +45 -0
  286. package/dist/fields/config/retiredPickers.js +46 -0
  287. package/dist/fields/config/retiredPickers.js.map +1 -0
  288. package/dist/fields/config/scopedFields.d.ts +40 -0
  289. package/dist/fields/config/scopedFields.js +68 -0
  290. package/dist/fields/config/scopedFields.js.map +1 -0
  291. package/dist/fields/config/sourcesState.js +19 -3
  292. package/dist/fields/config/sourcesState.js.map +1 -1
  293. package/dist/fields/config/toSelectOption.js +13 -7
  294. package/dist/fields/config/toSelectOption.js.map +1 -1
  295. package/dist/fields/config/useAnalyticsSources.d.ts +10 -7
  296. package/dist/fields/config/useAnalyticsSources.js +23 -24
  297. package/dist/fields/config/useAnalyticsSources.js.map +1 -1
  298. package/dist/fields/config/useFilterCapabilities.d.ts +31 -0
  299. package/dist/fields/config/useFilterCapabilities.js +60 -0
  300. package/dist/fields/config/useFilterCapabilities.js.map +1 -0
  301. package/dist/fields/config/useFormString.js +12 -0
  302. package/dist/fields/config/useFormString.js.map +1 -0
  303. package/dist/fields/dateRange/field.js +7 -19
  304. package/dist/fields/dateRange/field.js.map +1 -1
  305. package/dist/fields/dateRange/types.d.ts +5 -1
  306. package/dist/fields/dateRange/ui.d.ts +3 -2
  307. package/dist/fields/dateRange/ui.js +57 -319
  308. package/dist/fields/dateRange/ui.js.map +1 -1
  309. package/dist/fields/documentScope.js +21 -0
  310. package/dist/fields/documentScope.js.map +1 -0
  311. package/dist/fields/emptyState.js +30 -26
  312. package/dist/fields/emptyState.js.map +1 -1
  313. package/dist/fields/factories.d.ts +35 -16
  314. package/dist/fields/factories.js +67 -38
  315. package/dist/fields/factories.js.map +1 -1
  316. package/dist/fields/format.d.ts +12 -3
  317. package/dist/fields/format.js +77 -13
  318. package/dist/fields/format.js.map +1 -1
  319. package/dist/fields/itemReport.js +45 -0
  320. package/dist/fields/itemReport.js.map +1 -0
  321. package/dist/fields/readForDocument.d.ts +79 -26
  322. package/dist/fields/readForDocument.js +451 -105
  323. package/dist/fields/readForDocument.js.map +1 -1
  324. package/dist/fields/stateKeys.js +20 -0
  325. package/dist/fields/stateKeys.js.map +1 -0
  326. package/dist/goals/GoalAmountField.d.ts +10 -0
  327. package/dist/goals/GoalAmountField.js +179 -0
  328. package/dist/goals/GoalAmountField.js.map +1 -0
  329. package/dist/goals/GoalSelectField.js +89 -40
  330. package/dist/goals/GoalSelectField.js.map +1 -1
  331. package/dist/goals/GoalSelectFieldServer.d.ts +13 -0
  332. package/dist/goals/GoalSelectFieldServer.js +21 -0
  333. package/dist/goals/GoalSelectFieldServer.js.map +1 -0
  334. package/dist/goals/amountField.d.ts +20 -0
  335. package/dist/goals/amountField.js +37 -0
  336. package/dist/goals/amountField.js.map +1 -0
  337. package/dist/goals/builtin.js +17 -0
  338. package/dist/goals/builtin.js.map +1 -0
  339. package/dist/goals/collection.d.ts +22 -0
  340. package/dist/goals/collection.js +143 -124
  341. package/dist/goals/collection.js.map +1 -1
  342. package/dist/goals/constants.d.ts +38 -0
  343. package/dist/goals/constants.js +49 -0
  344. package/dist/goals/constants.js.map +1 -0
  345. package/dist/goals/currency.d.ts +16 -0
  346. package/dist/goals/currency.js +46 -4
  347. package/dist/goals/currency.js.map +1 -1
  348. package/dist/goals/currencyOptions.js +70 -0
  349. package/dist/goals/currencyOptions.js.map +1 -0
  350. package/dist/goals/fetchGoals.d.ts +10 -0
  351. package/dist/goals/fetchGoals.js +12 -22
  352. package/dist/goals/fetchGoals.js.map +1 -1
  353. package/dist/goals/goalField.d.ts +4 -6
  354. package/dist/goals/goalField.js +9 -19
  355. package/dist/goals/goalField.js.map +1 -1
  356. package/dist/goals/goalsEndpoint.js +40 -38
  357. package/dist/goals/goalsEndpoint.js.map +1 -1
  358. package/dist/goals/items.js +35 -0
  359. package/dist/goals/items.js.map +1 -0
  360. package/dist/goals/latent.js +9 -0
  361. package/dist/goals/latent.js.map +1 -0
  362. package/dist/goals/linkFields.d.ts +35 -0
  363. package/dist/goals/linkFields.js +31 -0
  364. package/dist/goals/linkFields.js.map +1 -0
  365. package/dist/goals/match.d.ts +14 -0
  366. package/dist/goals/match.js +67 -46
  367. package/dist/goals/match.js.map +1 -1
  368. package/dist/goals/moneyFields.js +56 -0
  369. package/dist/goals/moneyFields.js.map +1 -0
  370. package/dist/goals/pathMatch.js +122 -0
  371. package/dist/goals/pathMatch.js.map +1 -0
  372. package/dist/goals/placeholder.js +12 -0
  373. package/dist/goals/placeholder.js.map +1 -0
  374. package/dist/goals/resolver.d.ts +3 -3
  375. package/dist/goals/resolver.js +155 -47
  376. package/dist/goals/resolver.js.map +1 -1
  377. package/dist/goals/serverRevenue.d.ts +60 -0
  378. package/dist/goals/serverRevenue.js +41 -0
  379. package/dist/goals/serverRevenue.js.map +1 -0
  380. package/dist/goals/trackGoalAction.d.ts +26 -25
  381. package/dist/goals/trackGoalAction.js +71 -66
  382. package/dist/goals/trackGoalAction.js.map +1 -1
  383. package/dist/goals/types.d.ts +13 -28
  384. package/dist/goals/types.js +1 -1
  385. package/dist/goals/types.js.map +1 -1
  386. package/dist/goals/useAnalyticsGoals.d.ts +6 -5
  387. package/dist/goals/useAnalyticsGoals.js +17 -18
  388. package/dist/goals/useAnalyticsGoals.js.map +1 -1
  389. package/dist/index.d.ts +69 -11
  390. package/dist/index.js +262 -192
  391. package/dist/index.js.map +1 -1
  392. package/dist/items/collectionIdType.js +20 -0
  393. package/dist/items/collectionIdType.js.map +1 -0
  394. package/dist/items/idType.js +31 -0
  395. package/dist/items/idType.js.map +1 -0
  396. package/dist/items/ref.js +73 -0
  397. package/dist/items/ref.js.map +1 -0
  398. package/dist/maintenance/apiTaskState.js +141 -0
  399. package/dist/maintenance/apiTaskState.js.map +1 -0
  400. package/dist/maintenance/heartbeat.js +51 -0
  401. package/dist/maintenance/heartbeat.js.map +1 -0
  402. package/dist/maintenance/lease.d.ts +1 -0
  403. package/dist/maintenance/lease.js +79 -0
  404. package/dist/maintenance/lease.js.map +1 -0
  405. package/dist/maintenance/taskSchedule.js +27 -0
  406. package/dist/maintenance/taskSchedule.js.map +1 -0
  407. package/dist/maintenance/underLease.js +35 -0
  408. package/dist/maintenance/underLease.js.map +1 -0
  409. package/dist/migrations/legacy.d.ts +54 -0
  410. package/dist/migrations/legacy.js +117 -0
  411. package/dist/migrations/legacy.js.map +1 -0
  412. package/dist/migrations/predefined/dropLegacyMongo.d.ts +11 -0
  413. package/dist/migrations/predefined/dropLegacyMongo.js +12 -0
  414. package/dist/migrations/predefined/dropLegacyMongo.js.map +1 -0
  415. package/dist/native/collections/aggregates.js +54 -0
  416. package/dist/native/collections/aggregates.js.map +1 -0
  417. package/dist/native/collections/hits.js +103 -0
  418. package/dist/native/collections/hits.js.map +1 -0
  419. package/dist/native/collections/slugs.d.ts +10 -0
  420. package/dist/native/collections/slugs.js +16 -0
  421. package/dist/native/collections/slugs.js.map +1 -0
  422. package/dist/native/collections/state.js +84 -0
  423. package/dist/native/collections/state.js.map +1 -0
  424. package/dist/native/collections/storeCollection.js +31 -0
  425. package/dist/native/collections/storeCollection.js.map +1 -0
  426. package/dist/native/engine/buckets.d.ts +1 -0
  427. package/dist/native/engine/buckets.js +53 -0
  428. package/dist/native/engine/buckets.js.map +1 -0
  429. package/dist/native/engine/capabilities.js +87 -0
  430. package/dist/native/engine/capabilities.js.map +1 -0
  431. package/dist/native/engine/cost.js +72 -0
  432. package/dist/native/engine/cost.js.map +1 -0
  433. package/dist/native/engine/days.d.ts +1 -0
  434. package/dist/native/engine/days.js +182 -0
  435. package/dist/native/engine/days.js.map +1 -0
  436. package/dist/native/engine/engine.d.ts +1 -0
  437. package/dist/native/engine/engine.js +1627 -0
  438. package/dist/native/engine/engine.js.map +1 -0
  439. package/dist/native/engine/instance.js +58 -0
  440. package/dist/native/engine/instance.js.map +1 -0
  441. package/dist/native/engine/maintenance.d.ts +1 -0
  442. package/dist/native/engine/maintenance.js +677 -0
  443. package/dist/native/engine/maintenance.js.map +1 -0
  444. package/dist/native/engine/merge.js +41 -0
  445. package/dist/native/engine/merge.js.map +1 -0
  446. package/dist/native/engine/nudge.js +26 -0
  447. package/dist/native/engine/nudge.js.map +1 -0
  448. package/dist/native/engine/planner.js +199 -0
  449. package/dist/native/engine/planner.js.map +1 -0
  450. package/dist/native/engine/rebuild.d.ts +22 -0
  451. package/dist/native/engine/rebuild.js +76 -0
  452. package/dist/native/engine/rebuild.js.map +1 -0
  453. package/dist/native/engine/recent.js +17 -0
  454. package/dist/native/engine/recent.js.map +1 -0
  455. package/dist/native/engine/salt.d.ts +1 -0
  456. package/dist/native/engine/salt.js +98 -0
  457. package/dist/native/engine/salt.js.map +1 -0
  458. package/dist/native/engine/siteHosts.d.ts +1 -0
  459. package/dist/native/engine/siteHosts.js +58 -0
  460. package/dist/native/engine/siteHosts.js.map +1 -0
  461. package/dist/native/engine/toHit.js +110 -0
  462. package/dist/native/engine/toHit.js.map +1 -0
  463. package/dist/native/engine/writeBuffer.d.ts +14 -0
  464. package/dist/native/engine/writeBuffer.js +317 -0
  465. package/dist/native/engine/writeBuffer.js.map +1 -0
  466. package/dist/native/geo/composeGeoResolvers.d.ts +1 -0
  467. package/dist/native/geo/composeGeoResolvers.js +5 -2
  468. package/dist/native/geo/composeGeoResolvers.js.map +1 -1
  469. package/dist/native/geo/geoResolver.d.ts +27 -2
  470. package/dist/native/geo/geoResolver.js +42 -6
  471. package/dist/native/geo/geoResolver.js.map +1 -1
  472. package/dist/native/geo/maxmindResolver.d.ts +8 -4
  473. package/dist/native/geo/maxmindResolver.js +20 -16
  474. package/dist/native/geo/maxmindResolver.js.map +1 -1
  475. package/dist/native/geo/resolveGeo.js +31 -0
  476. package/dist/native/geo/resolveGeo.js.map +1 -0
  477. package/dist/native/ingest/bots.d.ts +10 -0
  478. package/dist/native/ingest/bots.js +66 -0
  479. package/dist/native/ingest/bots.js.map +1 -0
  480. package/dist/native/ingest/browser.js +45 -0
  481. package/dist/native/ingest/browser.js.map +1 -0
  482. package/dist/native/ingest/clientIp.js +34 -8
  483. package/dist/native/ingest/clientIp.js.map +1 -1
  484. package/dist/native/ingest/device.js +4 -6
  485. package/dist/native/ingest/device.js.map +1 -1
  486. package/dist/native/ingest/endpoint.d.ts +1 -1
  487. package/dist/native/ingest/endpoint.js +185 -32
  488. package/dist/native/ingest/endpoint.js.map +1 -1
  489. package/dist/native/ingest/itemSignature.d.ts +26 -0
  490. package/dist/native/ingest/itemSignature.js +45 -0
  491. package/dist/native/ingest/itemSignature.js.map +1 -0
  492. package/dist/native/ingest/language.js +13 -0
  493. package/dist/native/ingest/language.js.map +1 -0
  494. package/dist/native/ingest/normalizeEvent.d.ts +73 -5
  495. package/dist/native/ingest/normalizeEvent.js +257 -51
  496. package/dist/native/ingest/normalizeEvent.js.map +1 -1
  497. package/dist/native/ingest/orderSignature.d.ts +13 -0
  498. package/dist/native/ingest/orderSignature.js +50 -0
  499. package/dist/native/ingest/orderSignature.js.map +1 -0
  500. package/dist/native/ingest/referrer.js +46 -0
  501. package/dist/native/ingest/referrer.js.map +1 -0
  502. package/dist/native/ingest/requestHost.js +44 -0
  503. package/dist/native/ingest/requestHost.js.map +1 -0
  504. package/dist/native/ingest/resolveHostname.d.ts +20 -0
  505. package/dist/native/ingest/resolveHostname.js +51 -0
  506. package/dist/native/ingest/resolveHostname.js.map +1 -0
  507. package/dist/native/ingest/revenue.d.ts +1 -0
  508. package/dist/native/ingest/revenue.js +121 -0
  509. package/dist/native/ingest/revenue.js.map +1 -0
  510. package/dist/native/ingest/route.d.ts +10 -0
  511. package/dist/native/ingest/route.js +85 -0
  512. package/dist/native/ingest/route.js.map +1 -0
  513. package/dist/native/ingest/serverTrack.d.ts +2 -10
  514. package/dist/native/ingest/serverTrack.js +188 -68
  515. package/dist/native/ingest/serverTrack.js.map +1 -1
  516. package/dist/native/ingest/signature.js +28 -0
  517. package/dist/native/ingest/signature.js.map +1 -0
  518. package/dist/native/ingest/source.d.ts +10 -0
  519. package/dist/native/ingest/source.js +245 -16
  520. package/dist/native/ingest/source.js.map +1 -1
  521. package/dist/native/ingest/utm.js +33 -0
  522. package/dist/native/ingest/utm.js.map +1 -0
  523. package/dist/native/ingest/validate.js +25 -13
  524. package/dist/native/ingest/validate.js.map +1 -1
  525. package/dist/native/ingest/visitorHash.js +6 -8
  526. package/dist/native/ingest/visitorHash.js.map +1 -1
  527. package/dist/native/nativeAdapter.d.ts +128 -9
  528. package/dist/native/nativeAdapter.js +395 -281
  529. package/dist/native/nativeAdapter.js.map +1 -1
  530. package/dist/native/rebuildDays.d.ts +12 -0
  531. package/dist/native/rebuildDays.js +16 -0
  532. package/dist/native/rebuildDays.js.map +1 -0
  533. package/dist/native/store/aggregate.js +450 -0
  534. package/dist/native/store/aggregate.js.map +1 -0
  535. package/dist/native/store/caps.d.ts +18 -0
  536. package/dist/native/store/caps.js +76 -0
  537. package/dist/native/store/caps.js.map +1 -0
  538. package/dist/native/store/chunks.js +34 -0
  539. package/dist/native/store/chunks.js.map +1 -0
  540. package/dist/native/store/columnValues.js +31 -0
  541. package/dist/native/store/columnValues.js.map +1 -0
  542. package/dist/native/store/dialect.js +106 -0
  543. package/dist/native/store/dialect.js.map +1 -0
  544. package/dist/native/store/eventStore.js +44 -0
  545. package/dist/native/store/eventStore.js.map +1 -0
  546. package/dist/native/store/hitRow.js +119 -0
  547. package/dist/native/store/hitRow.js.map +1 -0
  548. package/dist/native/store/hits.js +65 -0
  549. package/dist/native/store/hits.js.map +1 -0
  550. package/dist/native/store/ids.js +105 -0
  551. package/dist/native/store/ids.js.map +1 -0
  552. package/dist/native/store/mongo/aggregatePipelines.js +438 -0
  553. package/dist/native/store/mongo/aggregatePipelines.js.map +1 -0
  554. package/dist/native/store/mongo/mongoState.js +375 -0
  555. package/dist/native/store/mongo/mongoState.js.map +1 -0
  556. package/dist/native/store/mongo/mongoStore.js +618 -0
  557. package/dist/native/store/mongo/mongoStore.js.map +1 -0
  558. package/dist/native/store/mongo/pipelines.js +705 -0
  559. package/dist/native/store/mongo/pipelines.js.map +1 -0
  560. package/dist/native/store/mongo/results.js +20 -0
  561. package/dist/native/store/mongo/results.js.map +1 -0
  562. package/dist/native/store/parts.d.ts +1 -0
  563. package/dist/native/store/parts.js +101 -0
  564. package/dist/native/store/parts.js.map +1 -0
  565. package/dist/native/store/pattern.js +213 -0
  566. package/dist/native/store/pattern.js.map +1 -0
  567. package/dist/native/store/rawRead.d.ts +23 -0
  568. package/dist/native/store/rawRead.js +387 -0
  569. package/dist/native/store/rawRead.js.map +1 -0
  570. package/dist/native/store/reclassify.js +53 -0
  571. package/dist/native/store/reclassify.js.map +1 -0
  572. package/dist/native/store/sql/aggregateSql.js +349 -0
  573. package/dist/native/store/sql/aggregateSql.js.map +1 -0
  574. package/dist/native/store/sql/columns.js +49 -0
  575. package/dist/native/store/sql/columns.js.map +1 -0
  576. package/dist/native/store/sql/compile.js +668 -0
  577. package/dist/native/store/sql/compile.js.map +1 -0
  578. package/dist/native/store/sql/drivers.js +218 -0
  579. package/dist/native/store/sql/drivers.js.map +1 -0
  580. package/dist/native/store/sql/executor.js +132 -0
  581. package/dist/native/store/sql/executor.js.map +1 -0
  582. package/dist/native/store/sql/fragment.js +104 -0
  583. package/dist/native/store/sql/fragment.js.map +1 -0
  584. package/dist/native/store/sql/maintenanceSql.js +59 -0
  585. package/dist/native/store/sql/maintenanceSql.js.map +1 -0
  586. package/dist/native/store/sql/ownConnection.js +107 -0
  587. package/dist/native/store/sql/ownConnection.js.map +1 -0
  588. package/dist/native/store/sql/poolShare.js +101 -0
  589. package/dist/native/store/sql/poolShare.js.map +1 -0
  590. package/dist/native/store/sql/sqlState.js +325 -0
  591. package/dist/native/store/sql/sqlState.js.map +1 -0
  592. package/dist/native/store/sql/sqlStore.js +355 -0
  593. package/dist/native/store/sql/sqlStore.js.map +1 -0
  594. package/dist/native/store/sql/sqliteThread.d.ts +9 -0
  595. package/dist/native/store/sql/sqliteThread.js +314 -0
  596. package/dist/native/store/sql/sqliteThread.js.map +1 -0
  597. package/dist/native/store/sql/sqliteWorker.js +327 -0
  598. package/dist/native/store/sql/sqliteWorker.js.map +1 -0
  599. package/dist/native/store/sql/sqliteWorkerSource.js +347 -0
  600. package/dist/native/store/sql/sqliteWorkerSource.js.map +1 -0
  601. package/dist/native/store/state.js +151 -0
  602. package/dist/native/store/state.js.map +1 -0
  603. package/dist/native/store/stateStore.js +29 -0
  604. package/dist/native/store/stateStore.js.map +1 -0
  605. package/dist/native/store/types.d.ts +15 -0
  606. package/dist/native/store/types.js +10 -0
  607. package/dist/native/store/types.js.map +1 -0
  608. package/dist/native/tasks/maintainTask.d.ts +19 -0
  609. package/dist/native/tasks/maintainTask.js +57 -0
  610. package/dist/native/tasks/maintainTask.js.map +1 -0
  611. package/dist/net/guardedFetch.d.ts +32 -0
  612. package/dist/net/guardedFetch.js +220 -0
  613. package/dist/net/guardedFetch.js.map +1 -0
  614. package/dist/net/origin.js +40 -0
  615. package/dist/net/origin.js.map +1 -0
  616. package/dist/net/platform.d.ts +9 -0
  617. package/dist/net/platform.js +35 -0
  618. package/dist/net/platform.js.map +1 -0
  619. package/dist/plugin/adminDependencies.js +34 -0
  620. package/dist/plugin/adminDependencies.js.map +1 -0
  621. package/dist/plugin/apiPath.js +23 -0
  622. package/dist/plugin/apiPath.js.map +1 -0
  623. package/dist/plugin/boundDocument.js +58 -0
  624. package/dist/plugin/boundDocument.js.map +1 -0
  625. package/dist/plugin/buildPhase.js +10 -0
  626. package/dist/plugin/buildPhase.js.map +1 -0
  627. package/dist/plugin/collectionChecks.js +232 -0
  628. package/dist/plugin/collectionChecks.js.map +1 -0
  629. package/dist/plugin/collectionFields.d.ts +13 -0
  630. package/dist/plugin/collectionFields.js +22 -0
  631. package/dist/plugin/collectionFields.js.map +1 -0
  632. package/dist/plugin/createRuntime.js +346 -0
  633. package/dist/plugin/createRuntime.js.map +1 -0
  634. package/dist/plugin/destroy.js +58 -0
  635. package/dist/plugin/destroy.js.map +1 -0
  636. package/dist/plugin/documentEndpoint.js +106 -53
  637. package/dist/plugin/documentEndpoint.js.map +1 -1
  638. package/dist/plugin/documentScopes.js +37 -0
  639. package/dist/plugin/documentScopes.js.map +1 -0
  640. package/dist/plugin/encrypted.js +25 -0
  641. package/dist/plugin/encrypted.js.map +1 -0
  642. package/dist/plugin/errors.d.ts +24 -0
  643. package/dist/plugin/errors.js +86 -0
  644. package/dist/plugin/errors.js.map +1 -0
  645. package/dist/plugin/flagsEndpoint.js +41 -0
  646. package/dist/plugin/flagsEndpoint.js.map +1 -0
  647. package/dist/plugin/goalHint.d.ts +1 -0
  648. package/dist/plugin/goalHint.js +35 -0
  649. package/dist/plugin/goalHint.js.map +1 -0
  650. package/dist/plugin/itemLabels.js +114 -0
  651. package/dist/plugin/itemLabels.js.map +1 -0
  652. package/dist/plugin/keepAlive.js +48 -0
  653. package/dist/plugin/keepAlive.js.map +1 -0
  654. package/dist/plugin/peerImportError.js +3 -6
  655. package/dist/plugin/peerImportError.js.map +1 -1
  656. package/dist/plugin/peers.js +64 -0
  657. package/dist/plugin/peers.js.map +1 -0
  658. package/dist/plugin/pluginCollections.js +161 -0
  659. package/dist/plugin/pluginCollections.js.map +1 -0
  660. package/dist/plugin/queryEndpoint.js +88 -52
  661. package/dist/plugin/queryEndpoint.js.map +1 -1
  662. package/dist/plugin/queryParams.js +7 -0
  663. package/dist/plugin/queryParams.js.map +1 -0
  664. package/dist/plugin/readContextForRequest.d.ts +11 -0
  665. package/dist/plugin/readContextForRequest.js +79 -32
  666. package/dist/plugin/readContextForRequest.js.map +1 -1
  667. package/dist/plugin/readFailure.js +22 -0
  668. package/dist/plugin/readFailure.js.map +1 -0
  669. package/dist/plugin/readableProviders.js +67 -0
  670. package/dist/plugin/readableProviders.js.map +1 -0
  671. package/dist/plugin/realtimeEndpoint.js +91 -21
  672. package/dist/plugin/realtimeEndpoint.js.map +1 -1
  673. package/dist/plugin/refreshEndpoint.js +138 -0
  674. package/dist/plugin/refreshEndpoint.js.map +1 -0
  675. package/dist/plugin/relabelFields.js +36 -0
  676. package/dist/plugin/relabelFields.js.map +1 -0
  677. package/dist/plugin/requestMemo.js +35 -0
  678. package/dist/plugin/requestMemo.js.map +1 -0
  679. package/dist/plugin/routeChecks.js +39 -0
  680. package/dist/plugin/routeChecks.js.map +1 -0
  681. package/dist/plugin/routes.d.ts +53 -0
  682. package/dist/plugin/routes.js +92 -0
  683. package/dist/plugin/routes.js.map +1 -0
  684. package/dist/plugin/runtime.d.ts +1 -1
  685. package/dist/plugin/runtime.js +235 -29
  686. package/dist/plugin/runtime.js.map +1 -1
  687. package/dist/plugin/schemaOnly.js +61 -0
  688. package/dist/plugin/schemaOnly.js.map +1 -0
  689. package/dist/plugin/scopeChange.js +23 -0
  690. package/dist/plugin/scopeChange.js.map +1 -0
  691. package/dist/plugin/scopeFieldBoot.js +4 -4
  692. package/dist/plugin/scopeFieldBoot.js.map +1 -1
  693. package/dist/plugin/scopeToken.js +33 -0
  694. package/dist/plugin/scopeToken.js.map +1 -0
  695. package/dist/plugin/sourcesEndpoint.js +50 -16
  696. package/dist/plugin/sourcesEndpoint.js.map +1 -1
  697. package/dist/plugin/unbundledLanguages.js +25 -0
  698. package/dist/plugin/unbundledLanguages.js.map +1 -0
  699. package/dist/plugin/walkFields.js +24 -0
  700. package/dist/plugin/walkFields.js.map +1 -0
  701. package/dist/plugin/warmTask.js +0 -0
  702. package/dist/plugin/warmTask.js.map +1 -1
  703. package/dist/providers/ProvidersListNotice.d.ts +11 -0
  704. package/dist/providers/ProvidersListNotice.js +36 -0
  705. package/dist/providers/ProvidersListNotice.js.map +1 -0
  706. package/dist/providers/access.d.ts +1 -0
  707. package/dist/providers/access.js +35 -26
  708. package/dist/providers/access.js.map +1 -1
  709. package/dist/providers/adapterPool.js +121 -0
  710. package/dist/providers/adapterPool.js.map +1 -0
  711. package/dist/providers/collection.d.ts +63 -0
  712. package/dist/providers/collection.js +372 -143
  713. package/dist/providers/collection.js.map +1 -1
  714. package/dist/providers/factory.d.ts +84 -0
  715. package/dist/providers/factory.js +86 -25
  716. package/dist/providers/factory.js.map +1 -1
  717. package/dist/providers/hosts.d.ts +25 -0
  718. package/dist/providers/hosts.js +128 -0
  719. package/dist/providers/hosts.js.map +1 -0
  720. package/dist/providers/probe.d.ts +1 -0
  721. package/dist/providers/probe.js +105 -0
  722. package/dist/providers/probe.js.map +1 -0
  723. package/dist/providers/refresh.d.ts +18 -0
  724. package/dist/providers/refresh.js +49 -0
  725. package/dist/providers/refresh.js.map +1 -0
  726. package/dist/providers/registry.js +329 -0
  727. package/dist/providers/registry.js.map +1 -0
  728. package/dist/providers/resolver.js +26 -88
  729. package/dist/providers/resolver.js.map +1 -1
  730. package/dist/providers/retarget.js +45 -0
  731. package/dist/providers/retarget.js.map +1 -0
  732. package/dist/providers/scopeUnique.js +41 -0
  733. package/dist/providers/scopeUnique.js.map +1 -0
  734. package/dist/providers/secrets.d.ts +26 -0
  735. package/dist/providers/secrets.js +61 -4
  736. package/dist/providers/secrets.js.map +1 -1
  737. package/dist/providers/stampScope.js +9 -6
  738. package/dist/providers/stampScope.js.map +1 -1
  739. package/dist/query/dates.js +10 -12
  740. package/dist/query/dates.js.map +1 -1
  741. package/dist/query/errors.d.ts +6 -13
  742. package/dist/query/fetchQuery.d.ts +36 -23
  743. package/dist/query/fetchQuery.js +96 -89
  744. package/dist/query/fetchQuery.js.map +1 -1
  745. package/dist/query/limits.js +8 -0
  746. package/dist/query/limits.js.map +1 -0
  747. package/dist/query/parse.d.ts +8 -2
  748. package/dist/query/parse.js +155 -108
  749. package/dist/query/parse.js.map +1 -1
  750. package/dist/query/response.d.ts +27 -4
  751. package/dist/query/response.js +18 -0
  752. package/dist/query/response.js.map +1 -0
  753. package/dist/react/AnalyticsProvider.d.ts +42 -20
  754. package/dist/react/AnalyticsProvider.js +24 -22
  755. package/dist/react/AnalyticsProvider.js.map +1 -1
  756. package/dist/react/TrackerBoot.js +15 -9
  757. package/dist/react/TrackerBoot.js.map +1 -1
  758. package/dist/react/useAnalytics.d.ts +2 -8
  759. package/dist/react/useAnalytics.js +31 -13
  760. package/dist/react/useAnalytics.js.map +1 -1
  761. package/dist/routes/captureRoute.d.ts +28 -0
  762. package/dist/routes/captureRoute.js +67 -0
  763. package/dist/routes/captureRoute.js.map +1 -0
  764. package/dist/routes/ingestRoute.d.ts +17 -0
  765. package/dist/routes/ingestRoute.js +17 -0
  766. package/dist/routes/ingestRoute.js.map +1 -0
  767. package/dist/site/AnalyticsScripts.d.ts +35 -0
  768. package/dist/site/AnalyticsScripts.js +44 -0
  769. package/dist/site/AnalyticsScripts.js.map +1 -0
  770. package/dist/site/getTrackerConfig.d.ts +15 -0
  771. package/dist/site/getTrackerConfig.js +43 -0
  772. package/dist/site/getTrackerConfig.js.map +1 -0
  773. package/dist/surfacing/afterRead.d.ts +37 -0
  774. package/dist/surfacing/bounded.js +38 -0
  775. package/dist/surfacing/bounded.js.map +1 -0
  776. package/dist/surfacing/breaker.js +107 -0
  777. package/dist/surfacing/breaker.js.map +1 -0
  778. package/dist/surfacing/cacheCollection.d.ts +8 -0
  779. package/dist/surfacing/cacheCollection.js +71 -0
  780. package/dist/surfacing/cacheCollection.js.map +1 -0
  781. package/dist/surfacing/cacheStore.d.ts +71 -1
  782. package/dist/surfacing/cacheStore.js +16 -37
  783. package/dist/surfacing/cacheStore.js.map +1 -1
  784. package/dist/surfacing/cacheSweep.d.ts +1 -0
  785. package/dist/surfacing/cacheSweep.js +59 -0
  786. package/dist/surfacing/cacheSweep.js.map +1 -0
  787. package/dist/surfacing/classifyError.js +282 -0
  788. package/dist/surfacing/classifyError.js.map +1 -0
  789. package/dist/surfacing/coalesce.js +2 -1
  790. package/dist/surfacing/coalesce.js.map +1 -1
  791. package/dist/surfacing/coldBudget.js +60 -0
  792. package/dist/surfacing/coldBudget.js.map +1 -0
  793. package/dist/surfacing/collectionCacheStore.js +183 -0
  794. package/dist/surfacing/collectionCacheStore.js.map +1 -0
  795. package/dist/surfacing/engine.d.ts +1 -1
  796. package/dist/surfacing/engine.js +514 -71
  797. package/dist/surfacing/engine.js.map +1 -1
  798. package/dist/surfacing/epoch.d.ts +1 -0
  799. package/dist/surfacing/epoch.js +116 -0
  800. package/dist/surfacing/epoch.js.map +1 -0
  801. package/dist/surfacing/lanes.d.ts +1 -0
  802. package/dist/surfacing/lanes.js +297 -0
  803. package/dist/surfacing/lanes.js.map +1 -0
  804. package/dist/surfacing/memo.js +40 -0
  805. package/dist/surfacing/memo.js.map +1 -0
  806. package/dist/surfacing/rateLimiter.d.ts +1 -0
  807. package/dist/surfacing/rateLimiter.js +69 -94
  808. package/dist/surfacing/rateLimiter.js.map +1 -1
  809. package/dist/surfacing/rebucket.js +178 -0
  810. package/dist/surfacing/rebucket.js.map +1 -0
  811. package/dist/surfacing/recipe.js +28 -0
  812. package/dist/surfacing/recipe.js.map +1 -0
  813. package/dist/surfacing/shape.js +22 -0
  814. package/dist/surfacing/shape.js.map +1 -0
  815. package/dist/surfacing/todaySplit.js +119 -0
  816. package/dist/surfacing/todaySplit.js.map +1 -0
  817. package/dist/sync/collection.d.ts +8 -0
  818. package/dist/sync/collection.js +30 -18
  819. package/dist/sync/collection.js.map +1 -1
  820. package/dist/sync/rekeyDurations.js +70 -0
  821. package/dist/sync/rekeyDurations.js.map +1 -0
  822. package/dist/sync/syncTask.js +222 -109
  823. package/dist/sync/syncTask.js.map +1 -1
  824. package/dist/testing/memoryAdapter.d.ts +6 -3
  825. package/dist/testing/memoryAdapter.js +12 -11
  826. package/dist/testing/memoryAdapter.js.map +1 -1
  827. package/dist/testing/settle.d.ts +11 -0
  828. package/dist/testing/settle.js +19 -0
  829. package/dist/testing/settle.js.map +1 -0
  830. package/dist/timeframe/calendar.js +65 -0
  831. package/dist/timeframe/calendar.js.map +1 -0
  832. package/dist/timeframe/comparison.js +46 -0
  833. package/dist/timeframe/comparison.js.map +1 -0
  834. package/dist/timeframe/presets.d.ts +1 -1
  835. package/dist/timeframe/presets.js +5 -5
  836. package/dist/timeframe/presets.js.map +1 -1
  837. package/dist/timeframe/reportingTimezone.d.ts +1 -0
  838. package/dist/timeframe/reportingTimezone.js +64 -0
  839. package/dist/timeframe/reportingTimezone.js.map +1 -0
  840. package/dist/timeframe/tz.js +55 -39
  841. package/dist/timeframe/tz.js.map +1 -1
  842. package/dist/tracker/autoCapture.js +125 -38
  843. package/dist/tracker/autoCapture.js.map +1 -1
  844. package/dist/tracker/campaign.js +52 -0
  845. package/dist/tracker/campaign.js.map +1 -0
  846. package/dist/tracker/config.d.ts +174 -0
  847. package/dist/tracker/config.js +25 -0
  848. package/dist/tracker/config.js.map +1 -0
  849. package/dist/tracker/createTracker.d.ts +5 -10
  850. package/dist/tracker/createTracker.js +437 -82
  851. package/dist/tracker/createTracker.js.map +1 -1
  852. package/dist/tracker/digest.js +28 -0
  853. package/dist/tracker/digest.js.map +1 -0
  854. package/dist/tracker/engagement.js +100 -0
  855. package/dist/tracker/engagement.js.map +1 -0
  856. package/dist/tracker/events.js +37 -0
  857. package/dist/tracker/events.js.map +1 -0
  858. package/dist/tracker/exclusion.d.ts +8 -0
  859. package/dist/tracker/exclusion.js +82 -0
  860. package/dist/tracker/exclusion.js.map +1 -0
  861. package/dist/tracker/gate.d.ts +8 -0
  862. package/dist/tracker/gate.js +244 -0
  863. package/dist/tracker/gate.js.map +1 -0
  864. package/dist/tracker/initTracker.d.ts +5 -8
  865. package/dist/tracker/initTracker.js +42 -14
  866. package/dist/tracker/initTracker.js.map +1 -1
  867. package/dist/tracker/itemCapture.js +224 -0
  868. package/dist/tracker/itemCapture.js.map +1 -0
  869. package/dist/tracker/loadScript.js +23 -15
  870. package/dist/tracker/loadScript.js.map +1 -1
  871. package/dist/tracker/pageTracking.js +6 -6
  872. package/dist/tracker/pageTracking.js.map +1 -1
  873. package/dist/tracker/registry.js +129 -30
  874. package/dist/tracker/registry.js.map +1 -1
  875. package/dist/tracker/sinks/createSink.js +60 -0
  876. package/dist/tracker/sinks/createSink.js.map +1 -0
  877. package/dist/tracker/sinks/ga4.js +106 -0
  878. package/dist/tracker/sinks/ga4.js.map +1 -0
  879. package/dist/tracker/sinks/native.js +21 -42
  880. package/dist/tracker/sinks/native.js.map +1 -1
  881. package/dist/tracker/sinks/plausible.js +36 -18
  882. package/dist/tracker/sinks/plausible.js.map +1 -1
  883. package/dist/tracker/sinks/posthog.js +145 -9
  884. package/dist/tracker/sinks/posthog.js.map +1 -1
  885. package/dist/tracker/sinks/umami.js +18 -10
  886. package/dist/tracker/sinks/umami.js.map +1 -1
  887. package/dist/tracker/sinks/vendor.js +54 -22
  888. package/dist/tracker/sinks/vendor.js.map +1 -1
  889. package/dist/tracker/skip.js +81 -0
  890. package/dist/tracker/skip.js.map +1 -0
  891. package/dist/tracker/storage.js +23 -0
  892. package/dist/tracker/storage.js.map +1 -0
  893. package/dist/tracker/transport.js +2 -5
  894. package/dist/tracker/transport.js.map +1 -1
  895. package/dist/tracker/types.d.ts +99 -44
  896. package/dist/tracker/window.js +7 -0
  897. package/dist/tracker/window.js.map +1 -0
  898. package/dist/translations/ar.js +266 -56
  899. package/dist/translations/ar.js.map +1 -1
  900. package/dist/translations/de.js +256 -55
  901. package/dist/translations/de.js.map +1 -1
  902. package/dist/translations/en.js +253 -56
  903. package/dist/translations/en.js.map +1 -1
  904. package/dist/translations/es.js +261 -57
  905. package/dist/translations/es.js.map +1 -1
  906. package/dist/translations/fr.js +265 -61
  907. package/dist/translations/fr.js.map +1 -1
  908. package/dist/translations/id.js +256 -56
  909. package/dist/translations/id.js.map +1 -1
  910. package/dist/translations/index.d.ts +1 -1
  911. package/dist/translations/index.js +5 -7
  912. package/dist/translations/index.js.map +1 -1
  913. package/dist/translations/intl.js +71 -0
  914. package/dist/translations/intl.js.map +1 -0
  915. package/dist/translations/keys.d.ts +240 -14
  916. package/dist/translations/keys.js +245 -14
  917. package/dist/translations/keys.js.map +1 -1
  918. package/dist/translations/ko.js +258 -58
  919. package/dist/translations/ko.js.map +1 -1
  920. package/dist/translations/labelMap.d.ts +10 -0
  921. package/dist/translations/labelMap.js +22 -0
  922. package/dist/translations/labelMap.js.map +1 -0
  923. package/dist/translations/metricKeys.js +16 -2
  924. package/dist/translations/metricKeys.js.map +1 -1
  925. package/dist/translations/parts.js +20 -0
  926. package/dist/translations/parts.js.map +1 -0
  927. package/dist/translations/plural.js +61 -0
  928. package/dist/translations/plural.js.map +1 -0
  929. package/dist/translations/pt.js +270 -66
  930. package/dist/translations/pt.js.map +1 -1
  931. package/dist/translations/ru.js +261 -55
  932. package/dist/translations/ru.js.map +1 -1
  933. package/dist/translations/server.d.ts +1 -0
  934. package/dist/translations/server.js +2 -3
  935. package/dist/translations/server.js.map +1 -1
  936. package/dist/translations/staticLabel.js +69 -0
  937. package/dist/translations/staticLabel.js.map +1 -0
  938. package/dist/translations/uk.js +261 -55
  939. package/dist/translations/uk.js.map +1 -1
  940. package/dist/translations/zh.js +256 -56
  941. package/dist/translations/zh.js.map +1 -1
  942. package/dist/ui/RangePicker.js +110 -0
  943. package/dist/ui/RangePicker.js.map +1 -0
  944. package/dist/ui/analytics.css +1667 -0
  945. package/dist/ui/calendarDays.js +27 -0
  946. package/dist/ui/calendarDays.js.map +1 -0
  947. package/dist/ui/classNames.js +7 -0
  948. package/dist/ui/classNames.js.map +1 -0
  949. package/dist/ui/components/Card.d.ts +28 -0
  950. package/dist/ui/components/Card.js +21 -0
  951. package/dist/ui/components/Card.js.map +1 -0
  952. package/dist/ui/components/ChartDataTable.d.ts +41 -0
  953. package/dist/ui/components/ChartDataTable.js +48 -0
  954. package/dist/ui/components/ChartDataTable.js.map +1 -0
  955. package/dist/ui/components/ChoiceMenu.js +48 -0
  956. package/dist/ui/components/ChoiceMenu.js.map +1 -0
  957. package/dist/ui/components/DataTable.d.ts +82 -0
  958. package/dist/ui/components/DataTable.js +214 -0
  959. package/dist/ui/components/DataTable.js.map +1 -0
  960. package/dist/ui/components/LabeledSelect.js +62 -0
  961. package/dist/ui/components/LabeledSelect.js.map +1 -0
  962. package/dist/ui/components/LiveAnnouncement.js +21 -0
  963. package/dist/ui/components/LiveAnnouncement.js.map +1 -0
  964. package/dist/ui/components/MetricCard.d.ts +38 -0
  965. package/dist/ui/components/MetricCard.js +39 -0
  966. package/dist/ui/components/MetricCard.js.map +1 -0
  967. package/dist/ui/components/NoValue.js +22 -0
  968. package/dist/ui/components/NoValue.js.map +1 -0
  969. package/dist/ui/components/ReadState.js +27 -0
  970. package/dist/ui/components/ReadState.js.map +1 -0
  971. package/dist/ui/components/RefreshButton.js +25 -0
  972. package/dist/ui/components/RefreshButton.js.map +1 -0
  973. package/dist/ui/components/SourcesNoticeBanner.js +20 -0
  974. package/dist/ui/components/SourcesNoticeBanner.js.map +1 -0
  975. package/dist/ui/cssVars.js +7 -0
  976. package/dist/ui/cssVars.js.map +1 -0
  977. package/dist/ui/data/WithScopeToken.d.ts +20 -0
  978. package/dist/ui/data/WithScopeToken.js +20 -0
  979. package/dist/ui/data/WithScopeToken.js.map +1 -0
  980. package/dist/ui/data/clientFieldProps.js +16 -0
  981. package/dist/ui/data/clientFieldProps.js.map +1 -0
  982. package/dist/ui/data/request.d.ts +46 -0
  983. package/dist/ui/data/request.js +119 -0
  984. package/dist/ui/data/request.js.map +1 -0
  985. package/dist/ui/data/scopeTokenContext.js +18 -0
  986. package/dist/ui/data/scopeTokenContext.js.map +1 -0
  987. package/dist/ui/data/sharedCache.js +48 -0
  988. package/dist/ui/data/sharedCache.js.map +1 -0
  989. package/dist/ui/data/useRequest.d.ts +19 -0
  990. package/dist/ui/data/useRequest.js +123 -0
  991. package/dist/ui/data/useRequest.js.map +1 -0
  992. package/dist/ui/data/useRequestScope.js +25 -0
  993. package/dist/ui/data/useRequestScope.js.map +1 -0
  994. package/dist/ui/hooks/useDirection.js +47 -0
  995. package/dist/ui/hooks/useDirection.js.map +1 -0
  996. package/dist/ui/hooks/useDismissOnEscape.js +25 -0
  997. package/dist/ui/hooks/useDismissOnEscape.js.map +1 -0
  998. package/dist/ui/hooks/useLiveAnnouncement.js +57 -0
  999. package/dist/ui/hooks/useLiveAnnouncement.js.map +1 -0
  1000. package/dist/ui/hooks/useRealtimePoll.js +112 -0
  1001. package/dist/ui/hooks/useRealtimePoll.js.map +1 -0
  1002. package/dist/ui/readState.js +19 -0
  1003. package/dist/ui/readState.js.map +1 -0
  1004. package/dist/ui/rows/toDisplayRows.js +49 -0
  1005. package/dist/ui/rows/toDisplayRows.js.map +1 -0
  1006. package/dist/ui/viewerClock.js +7 -0
  1007. package/dist/ui/viewerClock.js.map +1 -0
  1008. package/dist/view/AnalyticsNavLink.d.ts +5 -3
  1009. package/dist/view/AnalyticsNavLink.js +12 -8
  1010. package/dist/view/AnalyticsNavLink.js.map +1 -1
  1011. package/dist/view/AnalyticsView.d.ts +9 -10
  1012. package/dist/view/AnalyticsView.js +47 -19
  1013. package/dist/view/AnalyticsView.js.map +1 -1
  1014. package/dist/view/AnalyticsViewClient.d.ts +4 -7
  1015. package/dist/view/AnalyticsViewClient.js +15 -174
  1016. package/dist/view/AnalyticsViewClient.js.map +1 -1
  1017. package/dist/view/CountryFlag.d.ts +27 -0
  1018. package/dist/view/CountryFlag.js +44 -0
  1019. package/dist/view/CountryFlag.js.map +1 -0
  1020. package/dist/view/DocumentTitle.js +27 -0
  1021. package/dist/view/DocumentTitle.js.map +1 -0
  1022. package/dist/view/ViewRoot.d.ts +21 -0
  1023. package/dist/view/ViewRoot.js +155 -0
  1024. package/dist/view/ViewRoot.js.map +1 -0
  1025. package/dist/view/ViewSections.d.ts +38 -0
  1026. package/dist/view/ViewSections.js +190 -0
  1027. package/dist/view/ViewSections.js.map +1 -0
  1028. package/dist/view/authRedirect.js +2 -4
  1029. package/dist/view/authRedirect.js.map +1 -1
  1030. package/dist/view/consentShare.js +15 -0
  1031. package/dist/view/consentShare.js.map +1 -0
  1032. package/dist/view/conversionRate.js +9 -7
  1033. package/dist/view/conversionRate.js.map +1 -1
  1034. package/dist/view/dayRange.js +6 -10
  1035. package/dist/view/dayRange.js.map +1 -1
  1036. package/dist/view/exclusionLink.d.ts +27 -0
  1037. package/dist/view/exclusionLink.js +46 -0
  1038. package/dist/view/exclusionLink.js.map +1 -0
  1039. package/dist/view/flagSrc.js +14 -0
  1040. package/dist/view/flagSrc.js.map +1 -0
  1041. package/dist/view/gating.d.ts +15 -1
  1042. package/dist/view/gating.js +92 -20
  1043. package/dist/view/gating.js.map +1 -1
  1044. package/dist/view/hostCountryFlag.js +41 -0
  1045. package/dist/view/hostCountryFlag.js.map +1 -0
  1046. package/dist/view/labels.js +120 -3
  1047. package/dist/view/labels.js.map +1 -1
  1048. package/dist/view/metricAliases.js +10 -0
  1049. package/dist/view/metricAliases.js.map +1 -0
  1050. package/dist/view/navLabel.js +15 -0
  1051. package/dist/view/navLabel.js.map +1 -0
  1052. package/dist/view/registerView.js +13 -11
  1053. package/dist/view/registerView.js.map +1 -1
  1054. package/dist/view/scopeLabel.js +21 -0
  1055. package/dist/view/scopeLabel.js.map +1 -0
  1056. package/dist/view/sections/Breakdowns.js +221 -118
  1057. package/dist/view/sections/Breakdowns.js.map +1 -1
  1058. package/dist/view/sections/EmptyStates.js +120 -32
  1059. package/dist/view/sections/EmptyStates.js.map +1 -1
  1060. package/dist/view/sections/ExcludeBrowser.js +188 -0
  1061. package/dist/view/sections/ExcludeBrowser.js.map +1 -0
  1062. package/dist/view/sections/FilterChips.js +130 -25
  1063. package/dist/view/sections/FilterChips.js.map +1 -1
  1064. package/dist/view/sections/GoalsPanel.js +68 -59
  1065. package/dist/view/sections/GoalsPanel.js.map +1 -1
  1066. package/dist/view/sections/OverviewCards.js +42 -36
  1067. package/dist/view/sections/OverviewCards.js.map +1 -1
  1068. package/dist/view/sections/RealtimeStrip.js +70 -56
  1069. package/dist/view/sections/RealtimeStrip.js.map +1 -1
  1070. package/dist/view/sections/SectionBoundary.js +34 -0
  1071. package/dist/view/sections/SectionBoundary.js.map +1 -0
  1072. package/dist/view/sections/Toolbar.d.ts +11 -0
  1073. package/dist/view/sections/Toolbar.js +182 -116
  1074. package/dist/view/sections/Toolbar.js.map +1 -1
  1075. package/dist/view/sections/Trend.js +179 -73
  1076. package/dist/view/sections/Trend.js.map +1 -1
  1077. package/dist/view/state.d.ts +42 -0
  1078. package/dist/view/state.js +97 -53
  1079. package/dist/view/state.js.map +1 -1
  1080. package/dist/view/useViewClock.js +31 -0
  1081. package/dist/view/useViewClock.js.map +1 -0
  1082. package/dist/view/useViewQueries.d.ts +21 -0
  1083. package/dist/view/useViewQueries.js +50 -79
  1084. package/dist/view/useViewQueries.js.map +1 -1
  1085. package/dist/view/useViewState.js +42 -0
  1086. package/dist/view/useViewState.js.map +1 -0
  1087. package/dist/view/useViewUrl.js +52 -0
  1088. package/dist/view/useViewUrl.js.map +1 -0
  1089. package/dist/view/viewBody.js +30 -0
  1090. package/dist/view/viewBody.js.map +1 -0
  1091. package/dist/view/viewContext.d.ts +81 -0
  1092. package/dist/view/viewContext.js +49 -0
  1093. package/dist/view/viewContext.js.map +1 -0
  1094. package/dist/view/viewProps.d.ts +65 -8
  1095. package/dist/view/viewProps.js +123 -36
  1096. package/dist/view/viewProps.js.map +1 -1
  1097. package/dist/widgets/AnalyticsBreakdownWidget.d.ts +7 -3
  1098. package/dist/widgets/AnalyticsBreakdownWidget.js +153 -78
  1099. package/dist/widgets/AnalyticsBreakdownWidget.js.map +1 -1
  1100. package/dist/widgets/AnalyticsGoalsWidget.d.ts +6 -7
  1101. package/dist/widgets/AnalyticsGoalsWidget.js +126 -159
  1102. package/dist/widgets/AnalyticsGoalsWidget.js.map +1 -1
  1103. package/dist/widgets/AnalyticsMetricWidget.d.ts +7 -3
  1104. package/dist/widgets/AnalyticsMetricWidget.js +85 -83
  1105. package/dist/widgets/AnalyticsMetricWidget.js.map +1 -1
  1106. package/dist/widgets/AnalyticsRealtimeWidget.d.ts +7 -3
  1107. package/dist/widgets/AnalyticsRealtimeWidget.js +81 -61
  1108. package/dist/widgets/AnalyticsRealtimeWidget.js.map +1 -1
  1109. package/dist/widgets/AnalyticsTrendWidget.d.ts +7 -3
  1110. package/dist/widgets/AnalyticsTrendWidget.js +134 -100
  1111. package/dist/widgets/AnalyticsTrendWidget.js.map +1 -1
  1112. package/dist/widgets/ComparisonDelta.js +33 -42
  1113. package/dist/widgets/ComparisonDelta.js.map +1 -1
  1114. package/dist/widgets/RealtimeCounter.d.ts +27 -3
  1115. package/dist/widgets/RealtimeCounter.js +90 -62
  1116. package/dist/widgets/RealtimeCounter.js.map +1 -1
  1117. package/dist/widgets/WidgetCard.d.ts +80 -0
  1118. package/dist/widgets/WidgetCard.js +99 -0
  1119. package/dist/widgets/WidgetCard.js.map +1 -0
  1120. package/dist/widgets/WidgetFrame.js +42 -0
  1121. package/dist/widgets/WidgetFrame.js.map +1 -0
  1122. package/dist/widgets/WidgetShimmer.d.ts +55 -0
  1123. package/dist/widgets/WidgetShimmer.js +86 -0
  1124. package/dist/widgets/WidgetShimmer.js.map +1 -0
  1125. package/dist/widgets/breakdownTypes.js +18 -2
  1126. package/dist/widgets/breakdownTypes.js.map +1 -1
  1127. package/dist/widgets/customWidget.d.ts +5 -1
  1128. package/dist/widgets/customWidget.js +6 -7
  1129. package/dist/widgets/customWidget.js.map +1 -1
  1130. package/dist/widgets/defaultLayout.d.ts +26 -0
  1131. package/dist/widgets/defaultLayout.js +51 -0
  1132. package/dist/widgets/defaultLayout.js.map +1 -0
  1133. package/dist/widgets/defaults.d.ts +4 -3
  1134. package/dist/widgets/defaults.js +76 -24
  1135. package/dist/widgets/defaults.js.map +1 -1
  1136. package/dist/widgets/fieldRows.js +14 -0
  1137. package/dist/widgets/fieldRows.js.map +1 -0
  1138. package/dist/widgets/filterCaption.js +26 -0
  1139. package/dist/widgets/filterCaption.js.map +1 -0
  1140. package/dist/widgets/filterField.d.ts +15 -0
  1141. package/dist/widgets/filterField.js +86 -0
  1142. package/dist/widgets/filterField.js.map +1 -0
  1143. package/dist/widgets/filterValueLabel.d.ts +1 -0
  1144. package/dist/widgets/filterValueLabel.js +45 -0
  1145. package/dist/widgets/filterValueLabel.js.map +1 -0
  1146. package/dist/widgets/notices.js +79 -0
  1147. package/dist/widgets/notices.js.map +1 -0
  1148. package/dist/widgets/prepareWidgetRead.d.ts +24 -0
  1149. package/dist/widgets/prepareWidgetRead.js +110 -0
  1150. package/dist/widgets/prepareWidgetRead.js.map +1 -0
  1151. package/dist/widgets/range.js +26 -21
  1152. package/dist/widgets/range.js.map +1 -1
  1153. package/dist/widgets/readForWidget.d.ts +32 -13
  1154. package/dist/widgets/readForWidget.js +52 -63
  1155. package/dist/widgets/readForWidget.js.map +1 -1
  1156. package/dist/widgets/readForWidgetBreakdown.d.ts +45 -18
  1157. package/dist/widgets/readForWidgetBreakdown.js +71 -58
  1158. package/dist/widgets/readForWidgetBreakdown.js.map +1 -1
  1159. package/dist/widgets/readForWidgetGoals.d.ts +21 -17
  1160. package/dist/widgets/readForWidgetGoals.js +72 -52
  1161. package/dist/widgets/readForWidgetGoals.js.map +1 -1
  1162. package/dist/widgets/readForWidgetRealtime.d.ts +24 -11
  1163. package/dist/widgets/readForWidgetRealtime.js +69 -41
  1164. package/dist/widgets/readForWidgetRealtime.js.map +1 -1
  1165. package/dist/widgets/readForWidgetSeries.d.ts +29 -24
  1166. package/dist/widgets/readForWidgetSeries.js +66 -114
  1167. package/dist/widgets/readForWidgetSeries.js.map +1 -1
  1168. package/dist/widgets/readMeta.d.ts +48 -0
  1169. package/dist/widgets/readMeta.js +66 -0
  1170. package/dist/widgets/readMeta.js.map +1 -0
  1171. package/dist/widgets/realtimePoll.d.ts +1 -0
  1172. package/dist/widgets/realtimePoll.js +56 -16
  1173. package/dist/widgets/realtimePoll.js.map +1 -1
  1174. package/dist/widgets/registerWidgets.js +207 -124
  1175. package/dist/widgets/registerWidgets.js.map +1 -1
  1176. package/dist/widgets/stateKeys.js +30 -0
  1177. package/dist/widgets/stateKeys.js.map +1 -0
  1178. package/dist/widgets/titleForecast.js +89 -0
  1179. package/dist/widgets/titleForecast.js.map +1 -0
  1180. package/dist/widgets/types.d.ts +16 -0
  1181. package/dist/widgets/types.js +2 -0
  1182. package/dist/widgets/types.js.map +1 -1
  1183. package/dist/widgets/viewLink.d.ts +24 -6
  1184. package/dist/widgets/viewLink.js +36 -26
  1185. package/dist/widgets/viewLink.js.map +1 -1
  1186. package/dist/widgets/widgetData.js +34 -0
  1187. package/dist/widgets/widgetData.js.map +1 -0
  1188. package/dist/widgets/widgetWindow.d.ts +1 -0
  1189. package/dist/widgets/widgetWindow.js +51 -0
  1190. package/dist/widgets/widgetWindow.js.map +1 -0
  1191. package/package.json +61 -42
  1192. package/dist/capture/getTrackerConfig.d.ts +0 -20
  1193. package/dist/capture/getTrackerConfig.js +0 -31
  1194. package/dist/capture/getTrackerConfig.js.map +0 -1
  1195. package/dist/capture/slots.d.ts +0 -8
  1196. package/dist/capture/trackerConfig.d.ts +0 -33
  1197. package/dist/charts/styles.js +0 -59
  1198. package/dist/charts/styles.js.map +0 -1
  1199. package/dist/exports/next.d.ts +0 -3
  1200. package/dist/exports/next.js +0 -3
  1201. package/dist/fields/config/SourceSelectField.d.ts +0 -14
  1202. package/dist/fields/dateRange/styles.js +0 -23
  1203. package/dist/fields/dateRange/styles.js.map +0 -1
  1204. package/dist/goals/GoalSelectField.d.ts +0 -7
  1205. package/dist/native/collections/events.js +0 -121
  1206. package/dist/native/collections/events.js.map +0 -1
  1207. package/dist/native/collections/rollups.js +0 -151
  1208. package/dist/native/collections/rollups.js.map +0 -1
  1209. package/dist/native/collections/seen.js +0 -47
  1210. package/dist/native/collections/seen.js.map +0 -1
  1211. package/dist/native/ingest/flushBatch.js +0 -60
  1212. package/dist/native/ingest/flushBatch.js.map +0 -1
  1213. package/dist/native/ingest/salt.js +0 -14
  1214. package/dist/native/ingest/salt.js.map +0 -1
  1215. package/dist/native/ingest/writeBuffer.js +0 -55
  1216. package/dist/native/ingest/writeBuffer.js.map +0 -1
  1217. package/dist/native/ingest/writeEvent.js +0 -14
  1218. package/dist/native/ingest/writeEvent.js.map +0 -1
  1219. package/dist/native/query/eventAgg.js +0 -161
  1220. package/dist/native/query/eventAgg.js.map +0 -1
  1221. package/dist/native/realtime/buildRealtime.js +0 -53
  1222. package/dist/native/realtime/buildRealtime.js.map +0 -1
  1223. package/dist/native/retention/pruneTask.js +0 -29
  1224. package/dist/native/retention/pruneTask.js.map +0 -1
  1225. package/dist/native/rollupAcc.js +0 -64
  1226. package/dist/native/rollupAcc.js.map +0 -1
  1227. package/dist/native/rollups/applyDistinctDeltas.js +0 -9
  1228. package/dist/native/rollups/applyDistinctDeltas.js.map +0 -1
  1229. package/dist/native/rollups/bumpRollup.js +0 -73
  1230. package/dist/native/rollups/bumpRollup.js.map +0 -1
  1231. package/dist/native/rollups/deltas.js +0 -90
  1232. package/dist/native/rollups/deltas.js.map +0 -1
  1233. package/dist/native/rollups/insertIfNew.js +0 -53
  1234. package/dist/native/rollups/insertIfNew.js.map +0 -1
  1235. package/dist/next/captureRewrites.d.ts +0 -41
  1236. package/dist/next/captureRewrites.js +0 -56
  1237. package/dist/next/captureRewrites.js.map +0 -1
  1238. package/dist/next/posthogProxyRewrites.d.ts +0 -41
  1239. package/dist/next/posthogProxyRewrites.js +0 -45
  1240. package/dist/next/posthogProxyRewrites.js.map +0 -1
  1241. package/dist/plugin/paths.js +0 -27
  1242. package/dist/plugin/paths.js.map +0 -1
  1243. package/dist/query/errors.js +0 -10
  1244. package/dist/query/errors.js.map +0 -1
  1245. package/dist/react/TrackerBoot.d.ts +0 -22
  1246. package/dist/rsc/AnalyticsScripts.d.ts +0 -30
  1247. package/dist/rsc/AnalyticsScripts.js +0 -41
  1248. package/dist/rsc/AnalyticsScripts.js.map +0 -1
  1249. package/dist/surfacing/queue.js +0 -60
  1250. package/dist/surfacing/queue.js.map +0 -1
  1251. package/dist/surfacing/retryPolicy.js +0 -15
  1252. package/dist/surfacing/retryPolicy.js.map +0 -1
  1253. package/dist/tracker/autoCapture.d.ts +0 -48
  1254. package/dist/tracker/consent.d.ts +0 -24
  1255. package/dist/tracker/consent.js +0 -48
  1256. package/dist/tracker/consent.js.map +0 -1
  1257. package/dist/tracker/loadScript.d.ts +0 -14
  1258. package/dist/tracker/pageTracking.d.ts +0 -17
  1259. package/dist/tracker/registry.d.ts +0 -27
  1260. package/dist/tracker/sinks/native.d.ts +0 -22
  1261. package/dist/tracker/sinks/plausible.d.ts +0 -14
  1262. package/dist/tracker/sinks/posthog.d.ts +0 -14
  1263. package/dist/tracker/sinks/umami.d.ts +0 -13
  1264. package/dist/tracker/sinks/vendor.d.ts +0 -14
  1265. package/dist/view/sections/styles.js +0 -74
  1266. package/dist/view/sections/styles.js.map +0 -1
  1267. package/dist/widgets/WidgetViewLink.js +0 -17
  1268. package/dist/widgets/WidgetViewLink.js.map +0 -1
  1269. package/dist/widgets/cardChrome.d.ts +0 -8
  1270. package/dist/widgets/cardChrome.js +0 -46
  1271. package/dist/widgets/cardChrome.js.map +0 -1
  1272. package/dist/widgets/comparison.js +0 -43
  1273. package/dist/widgets/comparison.js.map +0 -1
@@ -1,99 +1,219 @@
1
+ import { captureRequest } from "../../capture/captureRequest.js";
2
+ import { kindOf } from "../../core/values.js";
3
+ import { currentDate } from "../../core/clock.js";
1
4
  import { getRuntime } from "../../plugin/runtime.js";
5
+ import { overlayClientIp } from "./clientIp.js";
6
+ import { warnUntrustedForwarding } from "../../capture/requestTrust.js";
7
+ import { gateHoldsAdapter } from "../../capture/slots.js";
8
+ import { openTransactionOf } from "../../db/openTransaction.js";
2
9
  import { AnalyticsTrackError } from "../../core/serverEvent.js";
10
+ import { dedupeKeyFor, isRefund, orderDigestKey, sanitizeOrderId, warnUnconvertedOnce, warnUnmatchedRevenueGoal } from "./revenue.js";
11
+ import { orderHitId, wireTwinOf } from "../store/ids.js";
12
+ import { SERVER_CLOCK_SKEW_MS } from "../engine/engine.js";
13
+ import { saltForHit } from "../engine/salt.js";
14
+ import { referrerHost } from "./referrer.js";
15
+ import { toHit } from "../engine/toHit.js";
3
16
  import { SERVER_USER_AGENT } from "./device.js";
4
- import { flushBatch } from "./flushBatch.js";
5
- import { normalizeEvent } from "./normalizeEvent.js";
6
- import { dailySalt } from "./salt.js";
7
17
  import { rawEventError } from "./validate.js";
8
- import { createLocalReq } from "payload";
18
+ import { normalizeEvent } from "./normalizeEvent.js";
19
+ import { createPayloadRequest } from "payload";
9
20
  //#region src/native/ingest/serverTrack.ts
21
+ /** A warning each instance logs once, so a busy webhook says it once. */
22
+ const warningOncePer = (message) => {
23
+ const warned = /* @__PURE__ */ new WeakSet();
24
+ return (payload) => {
25
+ if (warned.has(payload)) return;
26
+ warned.add(payload);
27
+ payload.logger?.warn(message);
28
+ };
29
+ };
30
+ const warnUnresolvedZone = warningOncePer("analytics: trackServerEvent 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, or pass event.timezone. Logged once.");
31
+ /** Ids of a sale's browser and server records, which a refund of it looks up. */
32
+ const saleRecordsOf = (sale) => {
33
+ const parts = {
34
+ ...sale.scope ? { tenant: sale.scope } : {},
35
+ goal: sale.goal,
36
+ orderId: sale.orderId,
37
+ ...sale.key ? { key: sale.key } : {}
38
+ };
39
+ return {
40
+ wire: orderHitId(dedupeKeyFor({
41
+ origin: "wire",
42
+ ...parts
43
+ })),
44
+ server: orderHitId(dedupeKeyFor({
45
+ origin: "server",
46
+ ...parts
47
+ }))
48
+ };
49
+ };
50
+ const isIdentity = (value) => value === "request" || value === "none";
51
+ /**
52
+ * The identity of a call that names none: no visitor's while `capture.gate` holds a slot the
53
+ * native beacon may fill, since the server cannot know the visitor's answer; else the request's.
54
+ */
55
+ const defaultIdentity = (payload) => {
56
+ const runtime = getRuntime(payload);
57
+ const adapter = ingestAdapter(payload);
58
+ if (!runtime || !adapter) return "request";
59
+ const kind = adapter.capture?.client.kind ?? "native";
60
+ return gateHoldsAdapter(runtime, adapter.id, kind) ? "none" : "request";
61
+ };
62
+ /** An explicit `ip` or `userAgent` that the gated default set aside. */
63
+ const warnIgnoredVisitor = warningOncePer("analytics: trackServerEvent was given an ip or a userAgent but no identity, and capture.gate holds the native slot, so the event is recorded as no visitor's. Pass identity: 'request' where you know the visitor's answer allows it. Logged once.");
10
64
  /**
11
- * The originating request's own headers, so a server event attributes exactly like the
12
- * browser event it stands in for: the platform's geo headers reach the geo resolver and the
13
- * visitor hashes to the same person. Explicit `ip` / `userAgent` overlay them.
14
- *
15
- * With no request and no user agent the synthetic server agent stands in, which hashes every
16
- * such event in a day to one visitor per site and reports no device at all.
65
+ * A scoped sale with neither `scope` nor `req` is filed under no tenant. Warned, never thrown: a
66
+ * platform may record its own sales under the null scope on purpose.
17
67
  */
18
- const attributionHeaders = (event, req) => {
19
- const headers = new Headers(req?.headers);
20
- if (event.ip) headers.set("x-forwarded-for", event.ip);
68
+ const warnUnscopedSale = warningOncePer("analytics: purchase or refund was called on a scoped install with neither scope nor req, so the sale is filed under the null scope: no tenant reports it, and the browser's record of the order never meets it. Pass scope (the tenant) or req. Logged once.");
69
+ /**
70
+ * The originating request's headers, so a server event attributes like its browser twin; `ip` and
71
+ * `userAgent` override them. With neither, or `identity: 'none'`, the server agent stands in.
72
+ */
73
+ const attributionHeaders = (event, trust, behind) => {
74
+ const { identity, req } = behind;
75
+ if (identity === "none") return new Headers({ "user-agent": SERVER_USER_AGENT });
76
+ const own = new Headers(req?.headers);
77
+ const headers = event.ip ? overlayClientIp(own, event.ip, trust) : own;
21
78
  if (event.userAgent) headers.set("user-agent", event.userAgent);
22
79
  if (!headers.get("user-agent")) headers.set("user-agent", SERVER_USER_AGENT);
23
80
  return headers;
24
81
  };
82
+ /**
83
+ * The caller's scope, else the request's resolved without the signed-in user or cookies, so an
84
+ * editor's sale is filed under the site it happened on.
85
+ */
25
86
  const resolveScope = async (event, opts, resolvers) => {
26
87
  if (!resolvers.scope) return;
27
88
  if (event.scope !== void 0) return event.scope ?? "";
28
89
  if (!opts?.req) return "";
29
- return await resolvers.scope(opts.req) ?? "";
90
+ return await resolvers.scope(captureRequest(opts.req)) ?? "";
30
91
  };
31
92
  /**
32
- * The native adapter's server-side ingestion, exposed as `adapter.ingest.track`. Same
33
- * normalization, goal matching and write path the HTTP endpoint uses; only attribution and
34
- * scope resolution differ, since there may be no request behind the event at all.
93
+ * `adapter.ingest.track`: the endpoint's write path, outside any caller transaction. On SQLite a
94
+ * call inside an open transaction resolves at once and stores its hit when that transaction ends.
35
95
  */
36
- const makeServerTrack = (deps) => async (event, opts) => {
37
- const payload = deps.getPayload();
38
- if (!payload) throw new AnalyticsTrackError("analytics: trackServerEvent called before init");
39
- const invalid = rawEventError(event);
96
+ const makeServerTrack = (deps) => async (payload, event, opts) => {
97
+ const invalid = rawEventError(event, {
98
+ allowRevenue: true,
99
+ requireHostname: true
100
+ });
40
101
  if (invalid) throw new AnalyticsTrackError(`analytics: trackServerEvent needs a valid "${invalid}"`);
41
- const resolvers = deps.getResolvers();
42
- const scope = await resolveScope(event, opts, resolvers);
43
- let local;
44
- const requestFor = async () => {
45
- if (opts?.req) return opts.req;
46
- local ??= await createLocalReq({}, payload);
47
- return local;
48
- };
49
- const timezone = event.timezone ?? (resolvers.timezone ? await resolvers.timezone(await requestFor(), scope ?? null) : void 0);
50
- const goals = resolvers.goals ? await resolvers.goals(await requestFor(), scope ?? null) : void 0;
51
- const now = event.now ?? /* @__PURE__ */ new Date();
52
- const stored = await normalizeEvent({
53
- raw: {
54
- type: event.type,
55
- name: event.name,
56
- path: event.path,
102
+ if (event.orderId !== void 0 && sanitizeOrderId(event.orderId) === void 0) throw new AnalyticsTrackError(`analytics: trackServerEvent needs a valid "orderId": a string of 1 to 255 characters without control characters, so a retried order counts once`);
103
+ if (isRefund(event.revenue === true, event.value) && sanitizeOrderId(event.orderId) !== void 0 && sanitizeOrderId(event.refundId) === void 0) throw new AnalyticsTrackError("analytics: trackServerEvent needs a valid \"refundId\" on a refund of an order: the refund's own id, so each partial refund counts once");
104
+ if (opts?.identity !== void 0 && !isIdentity(opts.identity)) throw new AnalyticsTrackError(`analytics: trackServerEvent's identity must be 'request' or 'none', got ${kindOf(opts.identity)}`);
105
+ if (event.now !== void 0 && !(event.now instanceof Date && Number.isFinite(event.now.getTime()))) throw new AnalyticsTrackError("analytics: trackServerEvent needs a valid \"now\"");
106
+ const identity = opts?.identity ?? defaultIdentity(payload);
107
+ if (opts?.identity === void 0 && identity === "none" && (event.ip || event.userAgent)) warnIgnoredVisitor(payload);
108
+ const receivedAt = currentDate();
109
+ const now = event.now ?? receivedAt;
110
+ if (now.getTime() > receivedAt.getTime() + 3e5) throw new AnalyticsTrackError(`analytics: trackServerEvent's "now" (${now.toISOString()}) is more than ${SERVER_CLOCK_SKEW_MS / 6e4} minutes ahead of the server's clock`);
111
+ const target = deps.target(payload);
112
+ if (event.revenue === true && event.scope === void 0 && !opts?.req && deps.getResolvers().scope) warnUnscopedSale(payload);
113
+ const record = async () => {
114
+ const resolvers = deps.getResolvers();
115
+ const scope = await resolveScope(event, opts, resolvers);
116
+ const placed = await target.engine?.serverHitDay(scope ?? "", now);
117
+ let local;
118
+ const requestFor = async () => {
119
+ if (opts?.req) return captureRequest(opts.req);
120
+ local ??= await createPayloadRequest({ payload });
121
+ return local;
122
+ };
123
+ const salt = await saltForHit(target.salts, {
124
+ scope: scope ?? "",
125
+ at: now,
126
+ zone: async () => event.timezone ?? (resolvers.timezone ? resolvers.timezone(await requestFor(), scope ?? null) : "UTC")
127
+ }, () => warnUnresolvedZone(payload));
128
+ const goals = resolvers.goals ? await resolvers.goals(await requestFor(), scope ?? null) : void 0;
129
+ const reportingCurrency = resolvers.currency ? await resolvers.currency(await requestFor(), scope ?? null) : void 0;
130
+ const attribution = deps.getAttribution();
131
+ const orderKey = orderDigestKey(payload.secret);
132
+ const trust = {
133
+ trustedProxyHops: attribution.trustedProxyHops,
134
+ trustedPlatform: attribution.trustedPlatform
135
+ };
136
+ if (opts?.req && !event.ip && identity !== "none") warnUntrustedForwarding(payload, opts.req.headers, trust);
137
+ const siblings = target.siteHosts && event.type === "pageview" && referrerHost(event.referrer, event.hostname) !== void 0 ? await target.siteHosts.of(scope ?? "") : void 0;
138
+ const normalized = await normalizeEvent({
139
+ raw: {
140
+ type: event.type,
141
+ name: event.name,
142
+ path: event.path,
143
+ referrer: event.referrer,
144
+ query: event.query,
145
+ props: event.props,
146
+ value: event.value,
147
+ currency: event.currency,
148
+ items: event.items,
149
+ revenue: event.revenue,
150
+ orderId: event.orderId,
151
+ refundId: event.refundId,
152
+ item: event.item
153
+ },
57
154
  hostname: event.hostname,
58
- referrer: event.referrer,
59
- props: event.props,
60
- value: event.value,
61
- currency: event.currency
62
- },
63
- headers: attributionHeaders(event, opts?.req),
64
- geoResolver: deps.geoResolver,
65
- salt: await dailySalt(payload, now),
66
- now,
67
- scope,
68
- timezone,
69
- goals
70
- });
71
- const buffer = deps.getBuffer();
72
- if (!buffer) {
73
- await flushBatch(payload, [stored]);
155
+ headers: attributionHeaders(event, trust, {
156
+ identity,
157
+ req: opts?.req
158
+ }),
159
+ geoResolver: deps.geoResolver,
160
+ warnGeo: (message) => payload.logger?.warn(message),
161
+ salt,
162
+ now,
163
+ scope,
164
+ goals,
165
+ origin: "server",
166
+ reportingCurrency,
167
+ convertCurrency: resolvers.convertCurrency,
168
+ warnUnconverted: () => warnUnconvertedOnce(payload.logger),
169
+ ...trust,
170
+ ...target.items ? { items: target.items } : {},
171
+ ...siblings ? { siblings } : {},
172
+ orderKey,
173
+ mode: identity === "none" ? "a" : "f"
174
+ });
175
+ if (event.revenue === true && normalized.goals === void 0) warnUnmatchedRevenueGoal(payload.logger, event.name ?? event.type);
176
+ const late = placed?.closed === true;
177
+ const counted = toHit(normalized, { receivedAt });
178
+ const orderId = sanitizeOrderId(event.orderId);
179
+ const hit = normalized.refund && counted.v === "" && orderId !== void 0 && target.engine ? {
180
+ ...counted,
181
+ ...await target.engine.saleAttribution(scope ?? "", saleRecordsOf({
182
+ scope,
183
+ goal: normalized.name ?? normalized.type,
184
+ orderId,
185
+ key: orderKey
186
+ }))
187
+ } : counted;
188
+ const stored = await target.writer.write(hit, { ...opts?.flush || late ? { flush: true } : {} });
189
+ target.siteHosts?.saw(scope ?? "", normalized.hostname);
190
+ const fresh = stored === void 0 || stored.written > 0;
191
+ if (placed && late && fresh) await target.engine?.reopen(placed);
192
+ if (wireTwinOf(hit.id) !== void 0 && !normalized.refund && fresh) await target.engine?.orderStored(scope ?? "", hit.id);
193
+ };
194
+ const open = target.sqlite ? await openTransactionOf(payload, opts?.req) : void 0;
195
+ if (open) {
196
+ target.writer.defer(record, open);
74
197
  return;
75
198
  }
76
- buffer.add(stored);
77
- if (opts?.flush) await buffer.flush();
199
+ await record();
200
+ target.nudge?.();
78
201
  };
79
202
  /**
80
- * Records an analytics event from server code: a webhook, a job, a server action. The event
81
- * goes through the same normalization, sanitization and goal matching a browser event does.
82
- * Pass `opts.req` whenever there is a request behind the event, so it inherits that request's
83
- * attribution, scope and reporting timezone.
84
- *
85
- * `event.scope` overrides the request's scope; it is ignored on an unscoped install and is
86
- * never checked against the scopes that exist, so the caller owns what it stamps.
87
- *
88
- * Needs the native adapter: a provider slot (Plausible, GA4) has no server ingestion seam
89
- * here yet, so an install without the native adapter throws rather than dropping the event.
203
+ * First registered adapter with a server ingestion seam. Callers read every other seam off it too,
204
+ * so an event cannot be judged by one adapter and written by another.
205
+ */
206
+ const ingestAdapter = (payload) => getRuntime(payload)?.registry.all().find((adapter) => adapter.ingest?.track);
207
+ /**
208
+ * Records an event from server code through the native adapter, normalized as a beacon is. Without
209
+ * `opts.identity` it is no visitor's while `capture.gate` holds the native slot.
90
210
  */
91
211
  const trackServerEvent = async (payload, event, opts) => {
92
- const track = getRuntime(payload)?.registry.all().find((adapter) => adapter.ingest?.track)?.ingest?.track;
212
+ const track = ingestAdapter(payload)?.ingest?.track;
93
213
  if (!track) throw new AnalyticsTrackError("analytics: trackServerEvent needs the native adapter; provider-slot server tracking is not supported yet");
94
- await track(event, opts);
214
+ await track(payload, event, opts);
95
215
  };
96
216
  //#endregion
97
- export { makeServerTrack, trackServerEvent };
217
+ export { ingestAdapter, makeServerTrack, trackServerEvent };
98
218
 
99
219
  //# sourceMappingURL=serverTrack.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"serverTrack.js","names":[],"sources":["../../../src/native/ingest/serverTrack.ts"],"sourcesContent":["import { createLocalReq, type Payload, type PayloadRequest } from 'payload'\nimport {\n\tAnalyticsTrackError,\n\ttype ServerEventInput,\n\ttype ServerTrack,\n\ttype ServerTrackOptions,\n} from '../../core/serverEvent'\nimport { getRuntime } from '../../plugin/runtime'\nimport type { GeoResolver } from '../geo/geoResolver'\nimport { SERVER_USER_AGENT } from './device'\nimport type { IngestResolvers } from './endpoint'\nimport { flushBatch } from './flushBatch'\nimport { normalizeEvent, type StoredEvent } from './normalizeEvent'\nimport { dailySalt } from './salt'\nimport { rawEventError } from './validate'\nimport type { WriteBuffer } from './writeBuffer'\n\nexport interface ServerTrackDeps {\n\t/** Null until the adapter's onInit has run. */\n\tgetPayload: () => Payload | null\n\tgeoResolver: GeoResolver\n\tgetBuffer: () => WriteBuffer<StoredEvent> | null\n\t/** Read late: the register context that carries them arrives after the adapter is built. */\n\tgetResolvers: () => IngestResolvers\n}\n\n/**\n * The originating request's own headers, so a server event attributes exactly like the\n * browser event it stands in for: the platform's geo headers reach the geo resolver and the\n * visitor hashes to the same person. Explicit `ip` / `userAgent` overlay them.\n *\n * With no request and no user agent the synthetic server agent stands in, which hashes every\n * such event in a day to one visitor per site and reports no device at all.\n */\nconst attributionHeaders = (event: ServerEventInput, req?: PayloadRequest): Headers => {\n\tconst headers = new Headers(req?.headers)\n\tif (event.ip) {\n\t\theaders.set('x-forwarded-for', event.ip)\n\t}\n\tif (event.userAgent) {\n\t\theaders.set('user-agent', event.userAgent)\n\t}\n\tif (!headers.get('user-agent')) {\n\t\theaders.set('user-agent', SERVER_USER_AGENT)\n\t}\n\treturn headers\n}\n\nconst resolveScope = async (\n\tevent: ServerEventInput,\n\topts: ServerTrackOptions | undefined,\n\tresolvers: IngestResolvers\n): Promise<string | undefined> => {\n\t// An unscoped install has no scope resolver and no scope field on its rows, so a scope\n\t// declared by the caller is ignored exactly as the endpoint ignores one on the wire.\n\tif (!resolvers.scope) {\n\t\treturn undefined\n\t}\n\tif (event.scope !== undefined) {\n\t\treturn event.scope ?? ''\n\t}\n\tif (!opts?.req) {\n\t\treturn ''\n\t}\n\treturn (await resolvers.scope(opts.req)) ?? ''\n}\n\n/**\n * The native adapter's server-side ingestion, exposed as `adapter.ingest.track`. Same\n * normalization, goal matching and write path the HTTP endpoint uses; only attribution and\n * scope resolution differ, since there may be no request behind the event at all.\n */\nexport const makeServerTrack =\n\t(deps: ServerTrackDeps): ServerTrack =>\n\tasync (event, opts) => {\n\t\tconst payload = deps.getPayload()\n\t\tif (!payload) {\n\t\t\tthrow new AnalyticsTrackError('analytics: trackServerEvent called before init')\n\t\t}\n\t\tconst invalid = rawEventError(event)\n\t\tif (invalid) {\n\t\t\tthrow new AnalyticsTrackError(`analytics: trackServerEvent needs a valid \"${invalid}\"`)\n\t\t}\n\t\tconst resolvers = deps.getResolvers()\n\t\tconst scope = await resolveScope(event, opts, resolvers)\n\t\t// createLocalReq mutates the request it is given, so a caller's own req is passed\n\t\t// through untouched and a fresh one is built only when a resolver needs it.\n\t\tlet local: PayloadRequest | undefined\n\t\tconst requestFor = async (): Promise<PayloadRequest> => {\n\t\t\tif (opts?.req) {\n\t\t\t\treturn opts.req\n\t\t\t}\n\t\t\tlocal ??= await createLocalReq({}, payload)\n\t\t\treturn local\n\t\t}\n\t\tconst timezone =\n\t\t\tevent.timezone ??\n\t\t\t(resolvers.timezone ? await resolvers.timezone(await requestFor(), scope ?? null) : undefined)\n\t\t// Goals resolve under the scope the event is stamped with, so a tenant's server event\n\t\t// can only ever complete that tenant's goals.\n\t\tconst goals = resolvers.goals\n\t\t\t? await resolvers.goals(await requestFor(), scope ?? null)\n\t\t\t: undefined\n\t\tconst now = event.now ?? new Date()\n\t\tconst stored = await normalizeEvent({\n\t\t\traw: {\n\t\t\t\ttype: event.type,\n\t\t\t\tname: event.name,\n\t\t\t\tpath: event.path,\n\t\t\t\thostname: event.hostname,\n\t\t\t\treferrer: event.referrer,\n\t\t\t\tprops: event.props,\n\t\t\t\tvalue: event.value,\n\t\t\t\tcurrency: event.currency,\n\t\t\t},\n\t\t\theaders: attributionHeaders(event, opts?.req),\n\t\t\tgeoResolver: deps.geoResolver,\n\t\t\tsalt: await dailySalt(payload, now),\n\t\t\tnow,\n\t\t\tscope,\n\t\t\ttimezone,\n\t\t\tgoals,\n\t\t})\n\t\tconst buffer = deps.getBuffer()\n\t\tif (!buffer) {\n\t\t\tawait flushBatch(payload, [stored])\n\t\t\treturn\n\t\t}\n\t\tbuffer.add(stored)\n\t\tif (opts?.flush) {\n\t\t\tawait buffer.flush()\n\t\t}\n\t}\n\n/**\n * Records an analytics event from server code: a webhook, a job, a server action. The event\n * goes through the same normalization, sanitization and goal matching a browser event does.\n * Pass `opts.req` whenever there is a request behind the event, so it inherits that request's\n * attribution, scope and reporting timezone.\n *\n * `event.scope` overrides the request's scope; it is ignored on an unscoped install and is\n * never checked against the scopes that exist, so the caller owns what it stamps.\n *\n * Needs the native adapter: a provider slot (Plausible, GA4) has no server ingestion seam\n * here yet, so an install without the native adapter throws rather than dropping the event.\n */\nexport const trackServerEvent = async (\n\tpayload: Payload,\n\tevent: ServerEventInput,\n\topts?: ServerTrackOptions\n): Promise<void> => {\n\tconst track = getRuntime(payload)\n\t\t?.registry.all()\n\t\t.find((adapter) => adapter.ingest?.track)?.ingest?.track\n\tif (!track) {\n\t\tthrow new AnalyticsTrackError(\n\t\t\t'analytics: trackServerEvent needs the native adapter; provider-slot server tracking is not supported yet'\n\t\t)\n\t}\n\tawait track(event, opts)\n}\n"],"mappings":";;;;;;;;;;;;;;;;;AAkCA,MAAM,sBAAsB,OAAyB,QAAkC;CACtF,MAAM,UAAU,IAAI,QAAQ,KAAK,OAAO;CACxC,IAAI,MAAM,IACT,QAAQ,IAAI,mBAAmB,MAAM,EAAE;CAExC,IAAI,MAAM,WACT,QAAQ,IAAI,cAAc,MAAM,SAAS;CAE1C,IAAI,CAAC,QAAQ,IAAI,YAAY,GAC5B,QAAQ,IAAI,cAAc,iBAAiB;CAE5C,OAAO;AACR;AAEA,MAAM,eAAe,OACpB,OACA,MACA,cACiC;CAGjC,IAAI,CAAC,UAAU,OACd;CAED,IAAI,MAAM,UAAU,KAAA,GACnB,OAAO,MAAM,SAAS;CAEvB,IAAI,CAAC,MAAM,KACV,OAAO;CAER,OAAQ,MAAM,UAAU,MAAM,KAAK,GAAG,KAAM;AAC7C;;;;;;AAOA,MAAa,mBACX,SACD,OAAO,OAAO,SAAS;CACtB,MAAM,UAAU,KAAK,WAAW;CAChC,IAAI,CAAC,SACJ,MAAM,IAAI,oBAAoB,gDAAgD;CAE/E,MAAM,UAAU,cAAc,KAAK;CACnC,IAAI,SACH,MAAM,IAAI,oBAAoB,8CAA8C,QAAQ,EAAE;CAEvF,MAAM,YAAY,KAAK,aAAa;CACpC,MAAM,QAAQ,MAAM,aAAa,OAAO,MAAM,SAAS;CAGvD,IAAI;CACJ,MAAM,aAAa,YAAqC;EACvD,IAAI,MAAM,KACT,OAAO,KAAK;EAEb,UAAU,MAAM,eAAe,CAAC,GAAG,OAAO;EAC1C,OAAO;CACR;CACA,MAAM,WACL,MAAM,aACL,UAAU,WAAW,MAAM,UAAU,SAAS,MAAM,WAAW,GAAG,SAAS,IAAI,IAAI,KAAA;CAGrF,MAAM,QAAQ,UAAU,QACrB,MAAM,UAAU,MAAM,MAAM,WAAW,GAAG,SAAS,IAAI,IACvD,KAAA;CACH,MAAM,MAAM,MAAM,uBAAO,IAAI,KAAK;CAClC,MAAM,SAAS,MAAM,eAAe;EACnC,KAAK;GACJ,MAAM,MAAM;GACZ,MAAM,MAAM;GACZ,MAAM,MAAM;GACZ,UAAU,MAAM;GAChB,UAAU,MAAM;GAChB,OAAO,MAAM;GACb,OAAO,MAAM;GACb,UAAU,MAAM;EACjB;EACA,SAAS,mBAAmB,OAAO,MAAM,GAAG;EAC5C,aAAa,KAAK;EAClB,MAAM,MAAM,UAAU,SAAS,GAAG;EAClC;EACA;EACA;EACA;CACD,CAAC;CACD,MAAM,SAAS,KAAK,UAAU;CAC9B,IAAI,CAAC,QAAQ;EACZ,MAAM,WAAW,SAAS,CAAC,MAAM,CAAC;EAClC;CACD;CACA,OAAO,IAAI,MAAM;CACjB,IAAI,MAAM,OACT,MAAM,OAAO,MAAM;AAErB;;;;;;;;;;;;;AAcD,MAAa,mBAAmB,OAC/B,SACA,OACA,SACmB;CACnB,MAAM,QAAQ,WAAW,OAAO,GAC7B,SAAS,IAAI,EACd,MAAM,YAAY,QAAQ,QAAQ,KAAK,GAAG,QAAQ;CACpD,IAAI,CAAC,OACJ,MAAM,IAAI,oBACT,0GACD;CAED,MAAM,MAAM,OAAO,IAAI;AACxB"}
1
+ {"version":3,"file":"serverTrack.js","names":[],"sources":["../../../src/native/ingest/serverTrack.ts"],"sourcesContent":["import { createPayloadRequest, type Payload, type PayloadRequest } from 'payload'\nimport { captureRequest } from '../../capture/captureRequest'\nimport { warnUntrustedForwarding } from '../../capture/requestTrust'\nimport { gateHoldsAdapter } from '../../capture/slots'\nimport { currentDate } from '../../core/clock'\nimport type { AnalyticsAdapter } from '../../core/contract'\nimport {\n\tAnalyticsTrackError,\n\ttype ServerEventInput,\n\ttype ServerTrack,\n\ttype ServerTrackIdentity,\n\ttype ServerTrackOptions,\n} from '../../core/serverEvent'\nimport { kindOf } from '../../core/values'\nimport { openTransactionOf } from '../../db/openTransaction'\nimport { getRuntime } from '../../plugin/runtime'\nimport { DEFAULT_TIMEZONE } from '../../timeframe/tz'\nimport { type NativeEngine, SERVER_CLOCK_SKEW_MS } 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 { orderHitId, wireTwinOf } from '../store/ids'\nimport { type ClientIpOptions, overlayClientIp } from './clientIp'\nimport { SERVER_USER_AGENT } from './device'\nimport type { IngestAttribution, IngestResolvers } from './endpoint'\nimport { type ItemIngestOptions, normalizeEvent } from './normalizeEvent'\nimport { referrerHost } from './referrer'\nimport {\n\tdedupeKeyFor,\n\tisRefund,\n\tMAX_ORDER_ID_LENGTH,\n\torderDigestKey,\n\tsanitizeOrderId,\n\twarnUnconvertedOnce,\n\twarnUnmatchedRevenueGoal,\n} from './revenue'\nimport { rawEventError } from './validate'\n\n/** A warning each instance logs once, so a busy webhook says it once. */\nconst warningOncePer = (message: string): ((payload: Payload) => void) => {\n\tconst warned = new WeakSet<Payload>()\n\treturn (payload) => {\n\t\tif (warned.has(payload)) {\n\t\t\treturn\n\t\t}\n\t\twarned.add(payload)\n\t\tpayload.logger?.warn(message)\n\t}\n}\n\nconst warnUnresolvedZone = warningOncePer(\n\t'analytics: trackServerEvent 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, or pass event.timezone. Logged once.'\n)\n\n/** Ids of a sale's browser and server records, which a refund of it looks up. */\nconst saleRecordsOf = (sale: {\n\tscope: string | undefined\n\tgoal: string\n\torderId: string\n\tkey: Buffer | undefined\n}): { wire: string; server: string } => {\n\tconst parts = {\n\t\t...(sale.scope ? { tenant: sale.scope } : {}),\n\t\tgoal: sale.goal,\n\t\torderId: sale.orderId,\n\t\t...(sale.key ? { key: sale.key } : {}),\n\t}\n\treturn {\n\t\twire: orderHitId(dedupeKeyFor({ origin: 'wire', ...parts })),\n\t\tserver: orderHitId(dedupeKeyFor({ origin: 'server', ...parts })),\n\t}\n}\n\nconst isIdentity = (value: unknown): value is ServerTrackIdentity =>\n\tvalue === 'request' || value === 'none'\n\n/**\n * The identity of a call that names none: no visitor's while `capture.gate` holds a slot the\n * native beacon may fill, since the server cannot know the visitor's answer; else the request's.\n */\nconst defaultIdentity = (payload: Payload): ServerTrackIdentity => {\n\tconst runtime = getRuntime(payload)\n\tconst adapter = ingestAdapter(payload)\n\tif (!runtime || !adapter) {\n\t\treturn 'request'\n\t}\n\tconst kind = adapter.capture?.client.kind ?? 'native'\n\treturn gateHoldsAdapter(runtime, adapter.id, kind) ? 'none' : 'request'\n}\n\n/** An explicit `ip` or `userAgent` that the gated default set aside. */\nconst warnIgnoredVisitor = warningOncePer(\n\t\"analytics: trackServerEvent was given an ip or a userAgent but no identity, and capture.gate holds the native slot, so the event is recorded as no visitor's. Pass identity: 'request' where you know the visitor's answer allows it. Logged once.\"\n)\n\n/**\n * A scoped sale with neither `scope` nor `req` is filed under no tenant. Warned, never thrown: a\n * platform may record its own sales under the null scope on purpose.\n */\nconst warnUnscopedSale = warningOncePer(\n\t\"analytics: purchase or refund was called on a scoped install with neither scope nor req, so the sale is filed under the null scope: no tenant reports it, and the browser's record of the order never meets it. Pass scope (the tenant) or req. Logged once.\"\n)\n\n/** What one Payload instance stores a server event's hit through. */\nexport interface ServerTrackTarget {\n\tsalts: Pick<DailySalts, 'forHit' | 'forDay'>\n\twriter: Pick<HitWriter, 'write' | 'defer'>\n\titems?: ItemIngestOptions\n\t/** SQLite's single writer: a hit recorded inside an open host transaction waits for it. */\n\tsqlite: boolean\n\t/** Asks for maintenance in the background after a hit; it never waits for it. */\n\tnudge?: () => void\n\t/**\n\t * Refuses hits at or before the raw floor day, recounts a closed day a hit lands on, and says\n\t * where a refund's sale counts so the refund is filed beside it.\n\t */\n\tengine?: Pick<NativeEngine, 'serverHitDay' | 'reopen' | 'orderStored' | 'saleAttribution'>\n\t/** The hostnames each scope records hits under; absent, only the event's own is the site's. */\n\tsiteHosts?: SiteHosts\n}\n\ninterface ServerTrackDeps {\n\tgeoResolver: GeoResolver\n\t/** The salts, writer and items of the instance an event is recorded on. */\n\ttarget: (payload: Payload) => ServerTrackTarget\n\t/** Read late: the register context that carries them arrives after the adapter is built. */\n\tgetResolvers: () => IngestResolvers\n\t/** Read late for the same reason: the plugin option arrives with the register context. */\n\tgetAttribution: () => IngestAttribution\n}\n\n/**\n * The originating request's headers, so a server event attributes like its browser twin; `ip` and\n * `userAgent` override them. With neither, or `identity: 'none'`, the server agent stands in.\n */\nconst attributionHeaders = (\n\tevent: ServerEventInput,\n\ttrust: ClientIpOptions,\n\tbehind: { identity: ServerTrackIdentity; req: PayloadRequest | undefined }\n): Headers => {\n\tconst { identity, req } = behind\n\tif (identity === 'none') {\n\t\treturn new Headers({ 'user-agent': SERVER_USER_AGENT })\n\t}\n\tconst own = new Headers(req?.headers)\n\tconst headers = event.ip ? overlayClientIp(own, event.ip, trust) : own\n\tif (event.userAgent) {\n\t\theaders.set('user-agent', event.userAgent)\n\t}\n\tif (!headers.get('user-agent')) {\n\t\theaders.set('user-agent', SERVER_USER_AGENT)\n\t}\n\treturn headers\n}\n\n/**\n * The caller's scope, else the request's resolved without the signed-in user or cookies, so an\n * editor's sale is filed under the site it happened on.\n */\nconst resolveScope = async (\n\tevent: ServerEventInput,\n\topts: ServerTrackOptions | undefined,\n\tresolvers: IngestResolvers\n): Promise<string | undefined> => {\n\t// An unscoped install has no scope resolver and no scope field on its rows, so a scope\n\t// declared by the caller is ignored exactly as the endpoint ignores one on the wire.\n\tif (!resolvers.scope) {\n\t\treturn undefined\n\t}\n\tif (event.scope !== undefined) {\n\t\treturn event.scope ?? ''\n\t}\n\tif (!opts?.req) {\n\t\treturn ''\n\t}\n\treturn (await resolvers.scope(captureRequest(opts.req))) ?? ''\n}\n\n/**\n * `adapter.ingest.track`: the endpoint's write path, outside any caller transaction. On SQLite a\n * call inside an open transaction resolves at once and stores its hit when that transaction ends.\n */\nexport const makeServerTrack =\n\t(deps: ServerTrackDeps): ServerTrack =>\n\tasync (payload, event, opts) => {\n\t\t// Trusted server code: it supplies its own hostname, so the resolver the HTTP endpoint\n\t\t// runs is bypassed and the hostname stays required here.\n\t\tconst invalid = rawEventError(event, { allowRevenue: true, requireHostname: true })\n\t\tif (invalid) {\n\t\t\tthrow new AnalyticsTrackError(`analytics: trackServerEvent needs a valid \"${invalid}\"`)\n\t\t}\n\t\t// Refused rather than dropped: a sale stored without its key would count again on every retry.\n\t\tif (event.orderId !== undefined && sanitizeOrderId(event.orderId) === undefined) {\n\t\t\tthrow new AnalyticsTrackError(\n\t\t\t\t`analytics: trackServerEvent needs a valid \"orderId\": a string of 1 to ${MAX_ORDER_ID_LENGTH} characters without control characters, so a retried order counts once`\n\t\t\t)\n\t\t}\n\t\tif (\n\t\t\tisRefund(event.revenue === true, event.value) &&\n\t\t\tsanitizeOrderId(event.orderId) !== undefined &&\n\t\t\tsanitizeOrderId(event.refundId) === undefined\n\t\t) {\n\t\t\tthrow new AnalyticsTrackError(\n\t\t\t\t'analytics: trackServerEvent needs a valid \"refundId\" on a refund of an order: the refund\\'s own id, so each partial refund counts once'\n\t\t\t)\n\t\t}\n\t\t// Refused rather than read as the default: a misspelt 'none' must not attribute the visitor.\n\t\tif (opts?.identity !== undefined && !isIdentity(opts.identity)) {\n\t\t\tthrow new AnalyticsTrackError(\n\t\t\t\t`analytics: trackServerEvent's identity must be 'request' or 'none', got ${kindOf(opts.identity)}`\n\t\t\t)\n\t\t}\n\t\tif (\n\t\t\tevent.now !== undefined &&\n\t\t\t!(event.now instanceof Date && Number.isFinite(event.now.getTime()))\n\t\t) {\n\t\t\tthrow new AnalyticsTrackError('analytics: trackServerEvent needs a valid \"now\"')\n\t\t}\n\t\tconst identity = opts?.identity ?? defaultIdentity(payload)\n\t\tif (opts?.identity === undefined && identity === 'none' && (event.ip || event.userAgent)) {\n\t\t\twarnIgnoredVisitor(payload)\n\t\t}\n\t\tconst receivedAt = currentDate()\n\t\tconst now = event.now ?? receivedAt\n\t\tif (now.getTime() > receivedAt.getTime() + SERVER_CLOCK_SKEW_MS) {\n\t\t\tthrow new AnalyticsTrackError(\n\t\t\t\t`analytics: trackServerEvent's \"now\" (${now.toISOString()}) is more than ${SERVER_CLOCK_SKEW_MS / 60_000} minutes ahead of the server's clock`\n\t\t\t)\n\t\t}\n\t\tconst target = deps.target(payload)\n\t\tif (\n\t\t\tevent.revenue === true &&\n\t\t\tevent.scope === undefined &&\n\t\t\t!opts?.req &&\n\t\t\tdeps.getResolvers().scope\n\t\t) {\n\t\t\twarnUnscopedSale(payload)\n\t\t}\n\n\t\tconst record = async (): Promise<void> => {\n\t\t\tconst resolvers = deps.getResolvers()\n\t\t\tconst scope = await resolveScope(event, opts, resolvers)\n\t\t\t// Refused before anything is written: a day whose raw hits may be pruned is never counted.\n\t\t\tconst placed = await target.engine?.serverHitDay(scope ?? '', now)\n\t\t\t// createPayloadRequest mutates its request, so a caller's req never reaches it: resolvers see it\n\t\t\t// as a capture does, without the user or cookies, and a fresh one is built only on demand.\n\t\t\tlet local: PayloadRequest | undefined\n\t\t\tconst requestFor = async (): Promise<PayloadRequest> => {\n\t\t\t\tif (opts?.req) {\n\t\t\t\t\treturn captureRequest(opts.req)\n\t\t\t\t}\n\t\t\t\tlocal ??= await createPayloadRequest({ payload })\n\t\t\t\treturn local\n\t\t\t}\n\t\t\tconst salt = await saltForHit(\n\t\t\t\ttarget.salts,\n\t\t\t\t{\n\t\t\t\t\tscope: scope ?? '',\n\t\t\t\t\tat: now,\n\t\t\t\t\tzone: async () =>\n\t\t\t\t\t\tevent.timezone ??\n\t\t\t\t\t\t(resolvers.timezone\n\t\t\t\t\t\t\t? resolvers.timezone(await requestFor(), scope ?? null)\n\t\t\t\t\t\t\t: DEFAULT_TIMEZONE),\n\t\t\t\t},\n\t\t\t\t() => warnUnresolvedZone(payload)\n\t\t\t)\n\t\t\t// Goals resolve under the scope the event is stamped with, so a tenant's server event\n\t\t\t// can only ever complete that tenant's goals.\n\t\t\tconst goals = resolvers.goals\n\t\t\t\t? await resolvers.goals(await requestFor(), scope ?? null)\n\t\t\t\t: undefined\n\t\t\tconst reportingCurrency = resolvers.currency\n\t\t\t\t? await resolvers.currency(await requestFor(), scope ?? null)\n\t\t\t\t: undefined\n\t\t\tconst attribution = deps.getAttribution()\n\t\t\tconst orderKey = orderDigestKey(payload.secret)\n\t\t\tconst trust: ClientIpOptions = {\n\t\t\t\ttrustedProxyHops: attribution.trustedProxyHops,\n\t\t\t\ttrustedPlatform: attribution.trustedPlatform,\n\t\t\t}\n\t\t\tif (opts?.req && !event.ip && identity !== 'none') {\n\t\t\t\twarnUntrustedForwarding(payload, opts.req.headers, trust)\n\t\t\t}\n\t\t\tconst siblings =\n\t\t\t\ttarget.siteHosts &&\n\t\t\t\tevent.type === 'pageview' &&\n\t\t\t\treferrerHost(event.referrer, event.hostname) !== undefined\n\t\t\t\t\t? await target.siteHosts.of(scope ?? '')\n\t\t\t\t\t: undefined\n\t\t\tconst normalized = await normalizeEvent({\n\t\t\t\traw: {\n\t\t\t\t\ttype: event.type,\n\t\t\t\t\tname: event.name,\n\t\t\t\t\tpath: event.path,\n\t\t\t\t\treferrer: event.referrer,\n\t\t\t\t\tquery: event.query,\n\t\t\t\t\tprops: event.props,\n\t\t\t\t\tvalue: event.value,\n\t\t\t\t\tcurrency: event.currency,\n\t\t\t\t\titems: event.items,\n\t\t\t\t\trevenue: event.revenue,\n\t\t\t\t\torderId: event.orderId,\n\t\t\t\t\trefundId: event.refundId,\n\t\t\t\t\titem: event.item,\n\t\t\t\t},\n\t\t\t\thostname: event.hostname,\n\t\t\t\theaders: attributionHeaders(event, trust, { identity, req: opts?.req }),\n\t\t\t\tgeoResolver: deps.geoResolver,\n\t\t\t\twarnGeo: (message) => payload.logger?.warn(message),\n\t\t\t\tsalt,\n\t\t\t\tnow,\n\t\t\t\tscope,\n\t\t\t\tgoals,\n\t\t\t\torigin: 'server',\n\t\t\t\treportingCurrency,\n\t\t\t\tconvertCurrency: resolvers.convertCurrency,\n\t\t\t\twarnUnconverted: () => warnUnconvertedOnce(payload.logger),\n\t\t\t\t...trust,\n\t\t\t\t...(target.items ? { items: target.items } : {}),\n\t\t\t\t...(siblings ? { siblings } : {}),\n\t\t\t\torderKey,\n\t\t\t\tmode: identity === 'none' ? 'a' : 'f',\n\t\t\t})\n\t\t\t// Only the server path can reach this: a public beacon's caller must never be able to\n\t\t\t// write lines into the host's log.\n\t\t\tif (event.revenue === true && normalized.goals === undefined) {\n\t\t\t\twarnUnmatchedRevenueGoal(payload.logger, event.name ?? event.type)\n\t\t\t}\n\t\t\t// An order bypasses the buffer and meets its own primary key: a retry stores nothing. A hit\n\t\t\t// on a closed day is stored before its day is reopened, so the count after it holds it.\n\t\t\tconst late = placed?.closed === true\n\t\t\tconst counted = toHit(normalized, { receivedAt })\n\t\t\tconst orderId = sanitizeOrderId(event.orderId)\n\t\t\t// A refund with no visitor of its own is filed where its sale counts, so every breakdown\n\t\t\t// still sums to the total.\n\t\t\tconst hit =\n\t\t\t\tnormalized.refund && counted.v === '' && orderId !== undefined && target.engine\n\t\t\t\t\t? {\n\t\t\t\t\t\t\t...counted,\n\t\t\t\t\t\t\t...(await target.engine.saleAttribution(\n\t\t\t\t\t\t\t\tscope ?? '',\n\t\t\t\t\t\t\t\tsaleRecordsOf({\n\t\t\t\t\t\t\t\t\tscope,\n\t\t\t\t\t\t\t\t\tgoal: normalized.name ?? normalized.type,\n\t\t\t\t\t\t\t\t\torderId,\n\t\t\t\t\t\t\t\t\tkey: orderKey,\n\t\t\t\t\t\t\t\t})\n\t\t\t\t\t\t\t)),\n\t\t\t\t\t\t}\n\t\t\t\t\t: counted\n\t\t\tconst stored = await target.writer.write(hit, {\n\t\t\t\t...(opts?.flush || late ? { flush: true } : {}),\n\t\t\t})\n\t\t\ttarget.siteHosts?.saw(scope ?? '', normalized.hostname)\n\t\t\t// A retried order stores nothing, so it counts no day again.\n\t\t\tconst fresh = stored === undefined || stored.written > 0\n\t\t\tif (placed && late && fresh) {\n\t\t\t\tawait target.engine?.reopen(placed)\n\t\t\t}\n\t\t\tif (wireTwinOf(hit.id) !== undefined && !normalized.refund && fresh) {\n\t\t\t\tawait target.engine?.orderStored(scope ?? '', hit.id)\n\t\t\t}\n\t\t}\n\n\t\t// The host holds SQLite's one write lock until its transaction ends, and a write that waited\n\t\t// for it here would wait on the very caller it is part of.\n\t\tconst open = target.sqlite ? await openTransactionOf(payload, opts?.req) : undefined\n\t\tif (open) {\n\t\t\ttarget.writer.defer(record, open)\n\t\t\treturn\n\t\t}\n\t\tawait record()\n\t\ttarget.nudge?.()\n\t}\n\n/**\n * First registered adapter with a server ingestion seam. Callers read every other seam off it too,\n * so an event cannot be judged by one adapter and written by another.\n */\nexport const ingestAdapter = (payload: Payload): AnalyticsAdapter | undefined =>\n\tgetRuntime(payload)\n\t\t?.registry.all()\n\t\t.find((adapter) => adapter.ingest?.track)\n\n/**\n * Records an event from server code through the native adapter, normalized as a beacon is. Without\n * `opts.identity` it is no visitor's while `capture.gate` holds the native slot.\n */\nexport const trackServerEvent = async (\n\tpayload: Payload,\n\tevent: ServerEventInput,\n\topts?: ServerTrackOptions\n): Promise<void> => {\n\tconst track = ingestAdapter(payload)?.ingest?.track\n\tif (!track) {\n\t\tthrow new AnalyticsTrackError(\n\t\t\t'analytics: trackServerEvent needs the native adapter; provider-slot server tracking is not supported yet'\n\t\t)\n\t}\n\tawait track(payload, event, opts)\n}\n"],"mappings":"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"}
@@ -0,0 +1,28 @@
1
+ import { createHmac, timingSafeEqual } from "node:crypto";
2
+ //#region src/native/ingest/signature.ts
3
+ /**
4
+ * Derives a secret's key for the one use `label` names, so it can never stand in for any other
5
+ * use of the secret. Each secret's key is derived once.
6
+ */
7
+ const labelledKey = (label) => {
8
+ const keysBySecret = /* @__PURE__ */ new Map();
9
+ return (secret) => {
10
+ const known = keysBySecret.get(secret);
11
+ if (known) return known;
12
+ const key = createHmac("sha256", secret).update(label).digest();
13
+ keysBySecret.set(secret, key);
14
+ return key;
15
+ };
16
+ };
17
+ /** The signature a page carries for `message`: 72 bits of its HMAC under `key`, base64url. */
18
+ const shortSignature = (key, message) => createHmac("sha256", key).update(message).digest("base64url").slice(0, 12);
19
+ /** Whether `given` is `expected`, compared in constant time. */
20
+ const sameSignature = (expected, given) => {
21
+ const expectedBytes = Buffer.from(expected);
22
+ const givenBytes = Buffer.from(given);
23
+ return expectedBytes.length === givenBytes.length && timingSafeEqual(expectedBytes, givenBytes);
24
+ };
25
+ //#endregion
26
+ export { labelledKey, sameSignature, shortSignature };
27
+
28
+ //# sourceMappingURL=signature.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"signature.js","names":[],"sources":["../../../src/native/ingest/signature.ts"],"sourcesContent":["import { createHmac, timingSafeEqual } from 'node:crypto'\nimport { ITEM_SIGNATURE_LENGTH } from '../../goals/constants'\n\n/**\n * Derives a secret's key for the one use `label` names, so it can never stand in for any other\n * use of the secret. Each secret's key is derived once.\n */\nexport const labelledKey = (label: string): ((secret: string) => Buffer) => {\n\tconst keysBySecret = new Map<string, Buffer>()\n\treturn (secret) => {\n\t\tconst known = keysBySecret.get(secret)\n\t\tif (known) {\n\t\t\treturn known\n\t\t}\n\t\tconst key = createHmac('sha256', secret).update(label).digest()\n\t\tkeysBySecret.set(secret, key)\n\t\treturn key\n\t}\n}\n\n/** The signature a page carries for `message`: 72 bits of its HMAC under `key`, base64url. */\nexport const shortSignature = (key: Buffer, message: string): string =>\n\tcreateHmac('sha256', key).update(message).digest('base64url').slice(0, ITEM_SIGNATURE_LENGTH)\n\n/** Whether `given` is `expected`, compared in constant time. */\nexport const sameSignature = (expected: string, given: string): boolean => {\n\tconst expectedBytes = Buffer.from(expected)\n\tconst givenBytes = Buffer.from(given)\n\treturn expectedBytes.length === givenBytes.length && timingSafeEqual(expectedBytes, givenBytes)\n}\n"],"mappings":";;;;;;AAOA,MAAa,eAAe,UAAgD;CAC3E,MAAM,+BAAe,IAAI,IAAoB;CAC7C,QAAQ,WAAW;EAClB,MAAM,QAAQ,aAAa,IAAI,MAAM;EACrC,IAAI,OACH,OAAO;EAER,MAAM,MAAM,WAAW,UAAU,MAAM,EAAE,OAAO,KAAK,EAAE,OAAO;EAC9D,aAAa,IAAI,QAAQ,GAAG;EAC5B,OAAO;CACR;AACD;;AAGA,MAAa,kBAAkB,KAAa,YAC3C,WAAW,UAAU,GAAG,EAAE,OAAO,OAAO,EAAE,OAAO,WAAW,EAAE,MAAM,GAAA,EAAwB;;AAG7F,MAAa,iBAAiB,UAAkB,UAA2B;CAC1E,MAAM,gBAAgB,OAAO,KAAK,QAAQ;CAC1C,MAAM,aAAa,OAAO,KAAK,KAAK;CACpC,OAAO,cAAc,WAAW,WAAW,UAAU,gBAAgB,eAAe,UAAU;AAC/F"}
@@ -0,0 +1,10 @@
1
+ //#region src/native/ingest/source.d.ts
2
+ /**
3
+ * Paid is split per platform rather than pooled: that is the split every vendor reports and the
4
+ * one a budget question is asked in.
5
+ */
6
+ declare const TRAFFIC_CHANNELS: readonly ["direct", "organic-search", "paid-search", "organic-social", "paid-social", "organic-video", "paid-video", "email", "affiliate", "display", "referral", "paid-other"];
7
+ type TrafficChannel = (typeof TRAFFIC_CHANNELS)[number];
8
+ //#endregion
9
+ export { TRAFFIC_CHANNELS, TrafficChannel };
10
+ //# sourceMappingURL=source.d.ts.map