@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
@@ -0,0 +1,98 @@
1
+ import { currentDate } from "../../core/clock.js";
2
+ import { isValidTimeZone } from "../../timeframe/tz.js";
3
+ import { addCalendarDays, calendarDayOf } from "../../timeframe/calendar.js";
4
+ import { keepRecent } from "./recent.js";
5
+ import { TimezoneResolutionError } from "../../timeframe/reportingTimezone.js";
6
+ /**
7
+ * A hit's salt: its local day's, or its UTC day's (the zone such a scope is read in) while its zone
8
+ * never resolved nor was recorded; `unresolved` hears each time. Its counted day is set at read.
9
+ */
10
+ const saltForHit = async (salts, hit, unresolved) => {
11
+ try {
12
+ return (await salts.forHit(hit)).salt;
13
+ } catch (err) {
14
+ if (!(err instanceof TimezoneResolutionError)) throw err;
15
+ unresolved(err);
16
+ return salts.forDay(calendarDayOf(hit.at, "UTC"));
17
+ }
18
+ };
19
+ /**
20
+ * A scope whose zone fails keeps its last good one (remembered or recorded), never UTC, else throws
21
+ * `TimezoneResolutionError`. Expired salts are deleted so a past day's hashes cannot be recomputed.
22
+ */
23
+ const createDailySalts = (options) => {
24
+ const salts = /* @__PURE__ */ new Map();
25
+ const lastZones = /* @__PURE__ */ new Map();
26
+ const warned = /* @__PURE__ */ new Set();
27
+ const now = options.now ?? currentDate;
28
+ let sweptThrough;
29
+ const sweepExpired = () => {
30
+ options.state.sweep(now()).catch((err) => {
31
+ options.warn?.(`analytics: deleting expired visitor salts failed: ${String(err)}`);
32
+ });
33
+ };
34
+ const load = (day) => {
35
+ const cached = salts.get(day);
36
+ if (cached) return cached;
37
+ const loading = options.state.salt(day);
38
+ salts.set(day, loading);
39
+ loading.catch(() => {
40
+ if (salts.get(day) === loading) salts.delete(day);
41
+ });
42
+ while (salts.size > 4) salts.delete(Math.min(...salts.keys()));
43
+ return loading;
44
+ };
45
+ const remember = (scope, tz) => {
46
+ warned.delete(scope);
47
+ keepRecent(lastZones, [scope, tz], (oldest) => warned.delete(oldest));
48
+ };
49
+ const zoneOf = async (hit) => {
50
+ try {
51
+ const tz = await hit.zone();
52
+ if (!isValidTimeZone(tz)) throw new Error(`"${tz}" is not an IANA time zone`);
53
+ remember(hit.scope, tz);
54
+ return tz;
55
+ } catch (err) {
56
+ let last = lastZones.get(hit.scope);
57
+ if (last === void 0 && options.recorded) {
58
+ const stored = await options.recorded(hit.scope).catch(() => null);
59
+ if (stored !== null && isValidTimeZone(stored)) {
60
+ last = stored;
61
+ keepRecent(lastZones, [hit.scope, stored], (oldest) => warned.delete(oldest));
62
+ }
63
+ }
64
+ if (last === void 0) throw err instanceof TimezoneResolutionError ? err : new TimezoneResolutionError(`analytics: the reporting timezone of scope "${hit.scope}" could not be resolved: ${String(err)}`, void 0, err);
65
+ if (!warned.has(hit.scope)) {
66
+ warned.add(hit.scope);
67
+ options.warn?.(`analytics: the reporting timezone of scope "${hit.scope}" could not be resolved, so its hits keep the last good zone, ${last}: ${String(err)}`);
68
+ }
69
+ return last;
70
+ }
71
+ };
72
+ const forDay = (day) => {
73
+ const first = !salts.has(day);
74
+ const salt = load(day);
75
+ if (first) load(addCalendarDays(day, 1)).catch(() => void 0);
76
+ if (sweptThrough === void 0 || day > sweptThrough) {
77
+ sweptThrough = day;
78
+ sweepExpired();
79
+ }
80
+ return salt;
81
+ };
82
+ return {
83
+ forDay,
84
+ async forHit(hit) {
85
+ const tz = await zoneOf(hit);
86
+ const day = calendarDayOf(hit.at, tz);
87
+ return {
88
+ day,
89
+ tz,
90
+ salt: await forDay(day)
91
+ };
92
+ }
93
+ };
94
+ };
95
+ //#endregion
96
+ export { createDailySalts, saltForHit };
97
+
98
+ //# sourceMappingURL=salt.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"salt.js","names":[],"sources":["../../../src/native/engine/salt.ts"],"sourcesContent":["import { currentDate } from '../../core/clock'\nimport { addCalendarDays, type CalendarDay, calendarDayOf } from '../../timeframe/calendar'\nimport { TimezoneResolutionError } from '../../timeframe/reportingTimezone'\nimport { DEFAULT_TIMEZONE, isValidTimeZone } from '../../timeframe/tz'\nimport type { StateStore } from '../store/types'\nimport { keepRecent } from './recent'\n\n/**\n * Days whose salts stay in memory: the three dates a moment can fall on somewhere between UTC-12\n * and UTC+14, and the one created ahead of midnight.\n */\nexport const MAX_CACHED_DAYS = 4\n\n/** The salt a hit is hashed with, and the local day it belongs to. */\ninterface HitSalt {\n\tday: CalendarDay\n\ttz: string\n\tsalt: string\n}\n\ninterface HitTime {\n\tscope: string\n\tat: Date\n\t/** The scope's reporting zone; it may throw, or answer something that is no zone. */\n\tzone: () => string | Promise<string>\n}\n\nexport interface DailySalts {\n\t/** The salt of the local day `at` falls on in the scope's zone. */\n\tforHit(hit: HitTime): Promise<HitSalt>\n\t/**\n\t * A day's salt; the first fetch of a day also creates the next one's, and the first of a later\n\t * day than any before deletes the expired ones.\n\t */\n\tforDay(day: CalendarDay): Promise<string>\n}\n\ninterface DailySaltsOptions {\n\tstate: Pick<StateStore, 'salt' | 'sweep'>\n\twarn?: (message: string) => void\n\t/**\n\t * The zone a scope's newest counted day was counted in: its last good zone when the source\n\t * fails in a process that never resolved it, so hits hash by the days reads cut.\n\t */\n\trecorded?: (scope: string) => Promise<string | null>\n\t/** The clock salts expire by; the plugin's clock (`currentDate`) by default. */\n\tnow?: () => Date\n}\n\n/**\n * A hit's salt: its local day's, or its UTC day's (the zone such a scope is read in) while its zone\n * never resolved nor was recorded; `unresolved` hears each time. Its counted day is set at read.\n */\nexport const saltForHit = async (\n\tsalts: Pick<DailySalts, 'forHit' | 'forDay'>,\n\thit: HitTime,\n\tunresolved: (err: TimezoneResolutionError) => void\n): Promise<string> => {\n\ttry {\n\t\treturn (await salts.forHit(hit)).salt\n\t} catch (err) {\n\t\tif (!(err instanceof TimezoneResolutionError)) {\n\t\t\tthrow err\n\t\t}\n\t\tunresolved(err)\n\t\treturn salts.forDay(calendarDayOf(hit.at, DEFAULT_TIMEZONE))\n\t}\n}\n\n/**\n * A scope whose zone fails keeps its last good one (remembered or recorded), never UTC, else throws\n * `TimezoneResolutionError`. Expired salts are deleted so a past day's hashes cannot be recomputed.\n */\nexport const createDailySalts = (options: DailySaltsOptions): DailySalts => {\n\tconst salts = new Map<CalendarDay, Promise<string>>()\n\tconst lastZones = new Map<string, string>()\n\tconst warned = new Set<string>()\n\tconst now = options.now ?? currentDate\n\tlet sweptThrough: CalendarDay | undefined\n\n\tconst sweepExpired = (): void => {\n\t\tvoid options.state.sweep(now()).catch((err: unknown) => {\n\t\t\toptions.warn?.(`analytics: deleting expired visitor salts failed: ${String(err)}`)\n\t\t})\n\t}\n\n\tconst load = (day: CalendarDay): Promise<string> => {\n\t\tconst cached = salts.get(day)\n\t\tif (cached) {\n\t\t\treturn cached\n\t\t}\n\t\tconst loading = options.state.salt(day)\n\t\tsalts.set(day, loading)\n\t\tloading.catch(() => {\n\t\t\tif (salts.get(day) === loading) {\n\t\t\t\tsalts.delete(day)\n\t\t\t}\n\t\t})\n\t\twhile (salts.size > MAX_CACHED_DAYS) {\n\t\t\tsalts.delete(Math.min(...salts.keys()))\n\t\t}\n\t\treturn loading\n\t}\n\n\tconst remember = (scope: string, tz: string): void => {\n\t\twarned.delete(scope)\n\t\tkeepRecent(lastZones, [scope, tz], (oldest) => warned.delete(oldest))\n\t}\n\n\tconst zoneOf = async (hit: HitTime): Promise<string> => {\n\t\ttry {\n\t\t\tconst tz = await hit.zone()\n\t\t\tif (!isValidTimeZone(tz)) {\n\t\t\t\tthrow new Error(`\"${tz}\" is not an IANA time zone`)\n\t\t\t}\n\t\t\tremember(hit.scope, tz)\n\t\t\treturn tz\n\t\t} catch (err) {\n\t\t\tlet last = lastZones.get(hit.scope)\n\t\t\tif (last === undefined && options.recorded) {\n\t\t\t\tconst stored = await options.recorded(hit.scope).catch(() => null)\n\t\t\t\tif (stored !== null && isValidTimeZone(stored)) {\n\t\t\t\t\tlast = stored\n\t\t\t\t\tkeepRecent(lastZones, [hit.scope, stored], (oldest) => warned.delete(oldest))\n\t\t\t\t}\n\t\t\t}\n\t\t\tif (last === undefined) {\n\t\t\t\tthrow err instanceof TimezoneResolutionError\n\t\t\t\t\t? err\n\t\t\t\t\t: new TimezoneResolutionError(\n\t\t\t\t\t\t\t`analytics: the reporting timezone of scope \"${hit.scope}\" could not be resolved: ${String(err)}`,\n\t\t\t\t\t\t\tundefined,\n\t\t\t\t\t\t\terr\n\t\t\t\t\t\t)\n\t\t\t}\n\t\t\tif (!warned.has(hit.scope)) {\n\t\t\t\twarned.add(hit.scope)\n\t\t\t\toptions.warn?.(\n\t\t\t\t\t`analytics: the reporting timezone of scope \"${hit.scope}\" could not be resolved, so its hits keep the last good zone, ${last}: ${String(err)}`\n\t\t\t\t)\n\t\t\t}\n\t\t\treturn last\n\t\t}\n\t}\n\n\tconst forDay = (day: CalendarDay): Promise<string> => {\n\t\tconst first = !salts.has(day)\n\t\tconst salt = load(day)\n\t\tif (first) {\n\t\t\tvoid load(addCalendarDays(day, 1)).catch(() => undefined)\n\t\t}\n\t\tif (sweptThrough === undefined || day > sweptThrough) {\n\t\t\tsweptThrough = day\n\t\t\tsweepExpired()\n\t\t}\n\t\treturn salt\n\t}\n\n\treturn {\n\t\tforDay,\n\t\tasync forHit(hit) {\n\t\t\tconst tz = await zoneOf(hit)\n\t\t\tconst day = calendarDayOf(hit.at, tz)\n\t\t\treturn { day, tz, salt: await forDay(day) }\n\t\t},\n\t}\n}\n"],"mappings":";;;;;;;;;AAqDA,MAAa,aAAa,OACzB,OACA,KACA,eACqB;CACrB,IAAI;EACH,QAAQ,MAAM,MAAM,OAAO,GAAG,GAAG;CAClC,SAAS,KAAK;EACb,IAAI,EAAE,eAAe,0BACpB,MAAM;EAEP,WAAW,GAAG;EACd,OAAO,MAAM,OAAO,cAAc,IAAI,IAAA,KAAoB,CAAC;CAC5D;AACD;;;;;AAMA,MAAa,oBAAoB,YAA2C;CAC3E,MAAM,wBAAQ,IAAI,IAAkC;CACpD,MAAM,4BAAY,IAAI,IAAoB;CAC1C,MAAM,yBAAS,IAAI,IAAY;CAC/B,MAAM,MAAM,QAAQ,OAAO;CAC3B,IAAI;CAEJ,MAAM,qBAA2B;EAChC,QAAa,MAAM,MAAM,IAAI,CAAC,EAAE,OAAO,QAAiB;GACvD,QAAQ,OAAO,qDAAqD,OAAO,GAAG,GAAG;EAClF,CAAC;CACF;CAEA,MAAM,QAAQ,QAAsC;EACnD,MAAM,SAAS,MAAM,IAAI,GAAG;EAC5B,IAAI,QACH,OAAO;EAER,MAAM,UAAU,QAAQ,MAAM,KAAK,GAAG;EACtC,MAAM,IAAI,KAAK,OAAO;EACtB,QAAQ,YAAY;GACnB,IAAI,MAAM,IAAI,GAAG,MAAM,SACtB,MAAM,OAAO,GAAG;EAElB,CAAC;EACD,OAAO,MAAM,OAAA,GACZ,MAAM,OAAO,KAAK,IAAI,GAAG,MAAM,KAAK,CAAC,CAAC;EAEvC,OAAO;CACR;CAEA,MAAM,YAAY,OAAe,OAAqB;EACrD,OAAO,OAAO,KAAK;EACnB,WAAW,WAAW,CAAC,OAAO,EAAE,IAAI,WAAW,OAAO,OAAO,MAAM,CAAC;CACrE;CAEA,MAAM,SAAS,OAAO,QAAkC;EACvD,IAAI;GACH,MAAM,KAAK,MAAM,IAAI,KAAK;GAC1B,IAAI,CAAC,gBAAgB,EAAE,GACtB,MAAM,IAAI,MAAM,IAAI,GAAG,2BAA2B;GAEnD,SAAS,IAAI,OAAO,EAAE;GACtB,OAAO;EACR,SAAS,KAAK;GACb,IAAI,OAAO,UAAU,IAAI,IAAI,KAAK;GAClC,IAAI,SAAS,KAAA,KAAa,QAAQ,UAAU;IAC3C,MAAM,SAAS,MAAM,QAAQ,SAAS,IAAI,KAAK,EAAE,YAAY,IAAI;IACjE,IAAI,WAAW,QAAQ,gBAAgB,MAAM,GAAG;KAC/C,OAAO;KACP,WAAW,WAAW,CAAC,IAAI,OAAO,MAAM,IAAI,WAAW,OAAO,OAAO,MAAM,CAAC;IAC7E;GACD;GACA,IAAI,SAAS,KAAA,GACZ,MAAM,eAAe,0BAClB,MACA,IAAI,wBACJ,+CAA+C,IAAI,MAAM,2BAA2B,OAAO,GAAG,KAC9F,KAAA,GACA,GACD;GAEH,IAAI,CAAC,OAAO,IAAI,IAAI,KAAK,GAAG;IAC3B,OAAO,IAAI,IAAI,KAAK;IACpB,QAAQ,OACP,+CAA+C,IAAI,MAAM,gEAAgE,KAAK,IAAI,OAAO,GAAG,GAC7I;GACD;GACA,OAAO;EACR;CACD;CAEA,MAAM,UAAU,QAAsC;EACrD,MAAM,QAAQ,CAAC,MAAM,IAAI,GAAG;EAC5B,MAAM,OAAO,KAAK,GAAG;EACrB,IAAI,OACH,KAAU,gBAAgB,KAAK,CAAC,CAAC,EAAE,YAAY,KAAA,CAAS;EAEzD,IAAI,iBAAiB,KAAA,KAAa,MAAM,cAAc;GACrD,eAAe;GACf,aAAa;EACd;EACA,OAAO;CACR;CAEA,OAAO;EACN;EACA,MAAM,OAAO,KAAK;GACjB,MAAM,KAAK,MAAM,OAAO,GAAG;GAC3B,MAAM,MAAM,cAAc,IAAI,IAAI,EAAE;GACpC,OAAO;IAAE;IAAK;IAAI,MAAM,MAAM,OAAO,GAAG;GAAE;EAC3C;CACD;AACD"}
@@ -0,0 +1 @@
1
+ export { };
@@ -0,0 +1,58 @@
1
+ import { addCalendarDays, calendarDayOf } from "../../timeframe/calendar.js";
2
+ import { keepRecent } from "./recent.js";
3
+ import { bareHost } from "../ingest/referrer.js";
4
+ /** How many hostnames one scope keeps from this process's own hits beyond the stored ones. */
5
+ const MAX_SEEN_PER_SCOPE = 1e3;
6
+ const createSiteHosts = (args) => {
7
+ const entries = /* @__PURE__ */ new Map();
8
+ let warned = false;
9
+ const entryOf = (scope) => {
10
+ const entry = entries.get(scope) ?? {
11
+ stored: /* @__PURE__ */ new Set(),
12
+ seen: /* @__PURE__ */ new Set(),
13
+ readAt: Number.NEGATIVE_INFINITY,
14
+ reading: null
15
+ };
16
+ keepRecent(entries, [scope, entry]);
17
+ return entry;
18
+ };
19
+ const load = async (scope, entry) => {
20
+ const now = args.now();
21
+ const since = addCalendarDays(calendarDayOf(now, "UTC"), -30);
22
+ try {
23
+ entry.stored = new Set((await args.store.hostnames(scope, since)).map(bareHost));
24
+ } catch (err) {
25
+ if (!warned) {
26
+ warned = true;
27
+ args.warn(`analytics: the hostnames a scope records hits under could not be read, so links between them may count as referrals until they can: ${String(err)}`);
28
+ }
29
+ }
30
+ entry.readAt = now.getTime();
31
+ };
32
+ /** One read per scope at a time: concurrent beacons wait for the read already running. */
33
+ const refresh = (scope, entry) => {
34
+ if (entry.reading) return entry.reading;
35
+ const reading = load(scope, entry);
36
+ entry.reading = reading;
37
+ reading.finally(() => {
38
+ if (entry.reading === reading) entry.reading = null;
39
+ });
40
+ return reading;
41
+ };
42
+ return {
43
+ async of(scope) {
44
+ const entry = entryOf(scope);
45
+ if (args.now().getTime() - entry.readAt > 6e5) await refresh(scope, entry);
46
+ return new Set([...entry.stored, ...entry.seen]);
47
+ },
48
+ saw(scope, hostname) {
49
+ const entry = entryOf(scope);
50
+ const bare = bareHost(hostname);
51
+ if (!entry.stored.has(bare) && entry.seen.size < MAX_SEEN_PER_SCOPE) entry.seen.add(bare);
52
+ }
53
+ };
54
+ };
55
+ //#endregion
56
+ export { createSiteHosts };
57
+
58
+ //# sourceMappingURL=siteHosts.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"siteHosts.js","names":[],"sources":["../../../src/native/engine/siteHosts.ts"],"sourcesContent":["import { addCalendarDays, calendarDayOf } from '../../timeframe/calendar'\nimport { DEFAULT_TIMEZONE } from '../../timeframe/tz'\nimport { bareHost } from '../ingest/referrer'\nimport type { EventStore } from '../store/types'\nimport { keepRecent } from './recent'\n\n/** How many days back a scope's hostnames are read from its daily totals. */\nconst SITE_HOSTS_LOOKBACK_DAYS = 30\n\n/** How long a scope's hostnames are used before its daily totals are read again. */\nexport const SITE_HOSTS_REFRESH_MS = 10 * 60_000\n\n/** How many hostnames one scope keeps from this process's own hits beyond the stored ones. */\nconst MAX_SEEN_PER_SCOPE = 1_000\n\n/**\n * Each scope's hostnames, so a link between two is a page of the site, not a referral: its last 30\n * days' totals reread every 10 minutes, plus those this process has stored hits under since.\n */\nexport interface SiteHosts {\n\t/** The scope's hostnames, bare (lowercased, no `www.`). */\n\tof(scope: string): Promise<ReadonlySet<string>>\n\t/** Notes a hostname the scope just stored a hit under. */\n\tsaw(scope: string, hostname: string): void\n}\n\ninterface Entry {\n\tstored: ReadonlySet<string>\n\tseen: Set<string>\n\treadAt: number\n\treading: Promise<void> | null\n}\n\nexport const createSiteHosts = (args: {\n\tstore: Pick<EventStore, 'hostnames'>\n\tnow: () => Date\n\twarn: (message: string) => void\n}): SiteHosts => {\n\tconst entries = new Map<string, Entry>()\n\tlet warned = false\n\n\tconst entryOf = (scope: string): Entry => {\n\t\tconst entry: Entry = entries.get(scope) ?? {\n\t\t\tstored: new Set(),\n\t\t\tseen: new Set(),\n\t\t\treadAt: Number.NEGATIVE_INFINITY,\n\t\t\treading: null,\n\t\t}\n\t\tkeepRecent(entries, [scope, entry])\n\t\treturn entry\n\t}\n\n\tconst load = async (scope: string, entry: Entry): Promise<void> => {\n\t\tconst now = args.now()\n\t\tconst since = addCalendarDays(calendarDayOf(now, DEFAULT_TIMEZONE), -SITE_HOSTS_LOOKBACK_DAYS)\n\t\ttry {\n\t\t\tentry.stored = new Set((await args.store.hostnames(scope, since)).map(bareHost))\n\t\t} catch (err) {\n\t\t\tif (!warned) {\n\t\t\t\twarned = true\n\t\t\t\targs.warn(\n\t\t\t\t\t`analytics: the hostnames a scope records hits under could not be read, so links between them may count as referrals until they can: ${String(err)}`\n\t\t\t\t)\n\t\t\t}\n\t\t}\n\t\tentry.readAt = now.getTime()\n\t}\n\n\t/** One read per scope at a time: concurrent beacons wait for the read already running. */\n\tconst refresh = (scope: string, entry: Entry): Promise<void> => {\n\t\tif (entry.reading) {\n\t\t\treturn entry.reading\n\t\t}\n\t\tconst reading = load(scope, entry)\n\t\tentry.reading = reading\n\t\tvoid reading.finally(() => {\n\t\t\tif (entry.reading === reading) {\n\t\t\t\tentry.reading = null\n\t\t\t}\n\t\t})\n\t\treturn reading\n\t}\n\n\treturn {\n\t\tasync of(scope) {\n\t\t\tconst entry = entryOf(scope)\n\t\t\tif (args.now().getTime() - entry.readAt > SITE_HOSTS_REFRESH_MS) {\n\t\t\t\tawait refresh(scope, entry)\n\t\t\t}\n\t\t\treturn new Set([...entry.stored, ...entry.seen])\n\t\t},\n\t\tsaw(scope, hostname) {\n\t\t\tconst entry = entryOf(scope)\n\t\t\tconst bare = bareHost(hostname)\n\t\t\tif (!entry.stored.has(bare) && entry.seen.size < MAX_SEEN_PER_SCOPE) {\n\t\t\t\tentry.seen.add(bare)\n\t\t\t}\n\t\t},\n\t}\n}\n"],"mappings":";;;;AAaA,MAAM,qBAAqB;AAoB3B,MAAa,mBAAmB,SAIf;CAChB,MAAM,0BAAU,IAAI,IAAmB;CACvC,IAAI,SAAS;CAEb,MAAM,WAAW,UAAyB;EACzC,MAAM,QAAe,QAAQ,IAAI,KAAK,KAAK;GAC1C,wBAAQ,IAAI,IAAI;GAChB,sBAAM,IAAI,IAAI;GACd,QAAQ,OAAO;GACf,SAAS;EACV;EACA,WAAW,SAAS,CAAC,OAAO,KAAK,CAAC;EAClC,OAAO;CACR;CAEA,MAAM,OAAO,OAAO,OAAe,UAAgC;EAClE,MAAM,MAAM,KAAK,IAAI;EACrB,MAAM,QAAQ,gBAAgB,cAAc,KAAA,KAAqB,GAAG,GAAyB;EAC7F,IAAI;GACH,MAAM,SAAS,IAAI,KAAK,MAAM,KAAK,MAAM,UAAU,OAAO,KAAK,GAAG,IAAI,QAAQ,CAAC;EAChF,SAAS,KAAK;GACb,IAAI,CAAC,QAAQ;IACZ,SAAS;IACT,KAAK,KACJ,uIAAuI,OAAO,GAAG,GAClJ;GACD;EACD;EACA,MAAM,SAAS,IAAI,QAAQ;CAC5B;;CAGA,MAAM,WAAW,OAAe,UAAgC;EAC/D,IAAI,MAAM,SACT,OAAO,MAAM;EAEd,MAAM,UAAU,KAAK,OAAO,KAAK;EACjC,MAAM,UAAU;EAChB,QAAa,cAAc;GAC1B,IAAI,MAAM,YAAY,SACrB,MAAM,UAAU;EAElB,CAAC;EACD,OAAO;CACR;CAEA,OAAO;EACN,MAAM,GAAG,OAAO;GACf,MAAM,QAAQ,QAAQ,KAAK;GAC3B,IAAI,KAAK,IAAI,EAAE,QAAQ,IAAI,MAAM,SAAA,KAChC,MAAM,QAAQ,OAAO,KAAK;GAE3B,OAAO,IAAI,IAAI,CAAC,GAAG,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC;EAChD;EACA,IAAI,OAAO,UAAU;GACpB,MAAM,QAAQ,QAAQ,KAAK;GAC3B,MAAM,OAAO,SAAS,QAAQ;GAC9B,IAAI,CAAC,MAAM,OAAO,IAAI,IAAI,KAAK,MAAM,KAAK,OAAO,oBAChD,MAAM,KAAK,IAAI,IAAI;EAErB;CACD;AACD"}
@@ -0,0 +1,110 @@
1
+ import "../../goals/constants.js";
2
+ import { orderHitId, ulid } from "../store/ids.js";
3
+ import { classifyChannel, deriveSource } from "../ingest/source.js";
4
+ import { isSelfReferral } from "../ingest/referrer.js";
5
+ //#region src/native/engine/toHit.ts
6
+ /**
7
+ * Whether a hit opens a visit: a document-loading pageview no page of its scope's hostnames linked
8
+ * to. Events, goals and engagements never do: their referrer is the one their page loaded with.
9
+ */
10
+ const isLanding = (event) => event.type === "pageview" && event.navigation !== true && event.siteReferrer !== true && !isSelfReferral(event.referrer, event.hostname);
11
+ /**
12
+ * Where a visit came from: the referrer on a landing alone, tags and click id on any hit. A hit
13
+ * with no visitor claims no source unless it carries one, or is a page's landing: a webhook is not
14
+ * direct traffic, and an anonymous page further into a visit is not either.
15
+ */
16
+ const acquisitionOf = (event, landing) => {
17
+ const ref = landing ? event.referrerHost : void 0;
18
+ const tagged = ref !== void 0 || event.clickId !== void 0 || [
19
+ event.utmSource,
20
+ event.utmMedium,
21
+ event.utmCampaign,
22
+ event.utmContent,
23
+ event.utmTerm
24
+ ].some((tag) => tag !== void 0);
25
+ if (event.visitorId === "" && !tagged && (event.server === true || !landing)) return {};
26
+ return {
27
+ ref,
28
+ source: deriveSource({
29
+ referrerHost: ref,
30
+ utmSource: event.utmSource
31
+ }),
32
+ channel: classifyChannel({
33
+ referrerHost: ref,
34
+ utmSource: event.utmSource,
35
+ utmMedium: event.utmMedium,
36
+ clickId: event.clickId
37
+ }),
38
+ channelVersion: 1,
39
+ clickId: event.clickId,
40
+ utmSource: event.utmSource,
41
+ utmMedium: event.utmMedium,
42
+ utmCampaign: event.utmCampaign,
43
+ utmContent: event.utmContent,
44
+ utmTerm: event.utmTerm
45
+ };
46
+ };
47
+ /** Drops the fields a row leaves out, so an absent one is missing rather than undefined. */
48
+ const withoutAbsent = (hit) => {
49
+ for (const key of Object.keys(hit)) if (Reflect.get(hit, key) === void 0) Reflect.deleteProperty(hit, key);
50
+ return hit;
51
+ };
52
+ /**
53
+ * The row a normalized event is stored as. An order's id is its dedupe key, so a retried order
54
+ * meets its own primary key; an engagement keeps its pageview's `ts`, its arrival as `lastAt`.
55
+ */
56
+ const toHit = (event, context) => {
57
+ const landing = isLanding(event);
58
+ const hit = {
59
+ id: event.dedupeKey === void 0 ? (context.ids ?? ulid)(event.timestamp) : orderHitId(event.dedupeKey),
60
+ scope: event.scope ?? "",
61
+ ts: event.timestamp,
62
+ type: event.type,
63
+ hostname: event.hostname,
64
+ path: event.path,
65
+ v: event.visitorId ?? "",
66
+ landing,
67
+ server: event.server === true,
68
+ mode: event.mode ?? "f",
69
+ durationMs: event.durationMs,
70
+ scrollDepth: event.scrollDepth
71
+ };
72
+ if (event.type === "engagement") {
73
+ const seen = event.impressions?.slice(0, 50) ?? [];
74
+ return withoutAbsent({
75
+ ...hit,
76
+ lastAt: new Date(Math.max(event.timestamp.getTime(), context.receivedAt.getTime())),
77
+ ...seen.length > 0 ? { impressions: seen } : {}
78
+ });
79
+ }
80
+ const goals = event.goals ?? [];
81
+ const revenue = goals.reduce((sum, completion) => sum + completion.value, 0);
82
+ const money = event.value !== void 0 || event.originalValue !== void 0 || goals.length > 0;
83
+ return withoutAbsent({
84
+ ...hit,
85
+ ...acquisitionOf(event, landing),
86
+ name: event.name,
87
+ country: event.country,
88
+ region: event.region,
89
+ city: event.city,
90
+ language: event.language,
91
+ device: event.device,
92
+ browser: event.browser,
93
+ os: event.os,
94
+ value: event.value,
95
+ originalValue: event.originalValue,
96
+ currency: money ? event.currency : void 0,
97
+ originalCurrency: event.originalCurrency,
98
+ item: event.item,
99
+ props: event.props,
100
+ ...goals.length > 0 ? {
101
+ goals,
102
+ conversions: event.refund ? 0 : goals.length,
103
+ revenue
104
+ } : {}
105
+ });
106
+ };
107
+ //#endregion
108
+ export { toHit };
109
+
110
+ //# sourceMappingURL=toHit.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"toHit.js","names":[],"sources":["../../../src/native/engine/toHit.ts"],"sourcesContent":["import { MAX_ITEMS_PER_BEACON } from '../../goals/constants'\nimport type { NormalizedEvent } from '../ingest/normalizeEvent'\nimport { isSelfReferral } from '../ingest/referrer'\nimport { CHANNEL_TAXONOMY_VERSION, classifyChannel, deriveSource } from '../ingest/source'\nimport { orderHitId, type UlidFactory, ulid } from '../store/ids'\nimport type { HitRow } from '../store/types'\n\ninterface HitContext {\n\t/** When the beacon arrived, or the server call was made: where an engagement's reading ends. */\n\treceivedAt: Date\n\t/** Makes a hit's id out of its time; the process's own factory unless a test hands one in. */\n\tids?: UlidFactory\n}\n\n/**\n * Whether a hit opens a visit: a document-loading pageview no page of its scope's hostnames linked\n * to. Events, goals and engagements never do: their referrer is the one their page loaded with.\n */\nexport const isLanding = (\n\tevent: Pick<NormalizedEvent, 'type' | 'navigation' | 'referrer' | 'hostname' | 'siteReferrer'>\n): boolean =>\n\tevent.type === 'pageview' &&\n\tevent.navigation !== true &&\n\tevent.siteReferrer !== true &&\n\t!isSelfReferral(event.referrer, event.hostname)\n\n/**\n * Where a visit came from: the referrer on a landing alone, tags and click id on any hit. A hit\n * with no visitor claims no source unless it carries one, or is a page's landing: a webhook is not\n * direct traffic, and an anonymous page further into a visit is not either.\n */\nconst acquisitionOf = (event: NormalizedEvent, landing: boolean): Partial<HitRow> => {\n\tconst ref = landing ? event.referrerHost : undefined\n\tconst tagged =\n\t\tref !== undefined ||\n\t\tevent.clickId !== undefined ||\n\t\t[event.utmSource, event.utmMedium, event.utmCampaign, event.utmContent, event.utmTerm].some(\n\t\t\t(tag) => tag !== undefined\n\t\t)\n\tif (event.visitorId === '' && !tagged && (event.server === true || !landing)) {\n\t\treturn {}\n\t}\n\treturn {\n\t\tref,\n\t\tsource: deriveSource({ referrerHost: ref, utmSource: event.utmSource }),\n\t\tchannel: classifyChannel({\n\t\t\treferrerHost: ref,\n\t\t\tutmSource: event.utmSource,\n\t\t\tutmMedium: event.utmMedium,\n\t\t\tclickId: event.clickId,\n\t\t}),\n\t\tchannelVersion: CHANNEL_TAXONOMY_VERSION,\n\t\tclickId: event.clickId,\n\t\tutmSource: event.utmSource,\n\t\tutmMedium: event.utmMedium,\n\t\tutmCampaign: event.utmCampaign,\n\t\tutmContent: event.utmContent,\n\t\tutmTerm: event.utmTerm,\n\t}\n}\n\n/** Drops the fields a row leaves out, so an absent one is missing rather than undefined. */\nconst withoutAbsent = (hit: HitRow): HitRow => {\n\tfor (const key of Object.keys(hit)) {\n\t\tif (Reflect.get(hit, key) === undefined) {\n\t\t\tReflect.deleteProperty(hit, key)\n\t\t}\n\t}\n\treturn hit\n}\n\n/**\n * The row a normalized event is stored as. An order's id is its dedupe key, so a retried order\n * meets its own primary key; an engagement keeps its pageview's `ts`, its arrival as `lastAt`.\n */\nexport const toHit = (event: NormalizedEvent, context: HitContext): HitRow => {\n\tconst landing = isLanding(event)\n\tconst hit: HitRow = {\n\t\tid:\n\t\t\tevent.dedupeKey === undefined\n\t\t\t\t? (context.ids ?? ulid)(event.timestamp)\n\t\t\t\t: orderHitId(event.dedupeKey),\n\t\tscope: event.scope ?? '',\n\t\tts: event.timestamp,\n\t\ttype: event.type,\n\t\thostname: event.hostname,\n\t\tpath: event.path,\n\t\tv: event.visitorId ?? '',\n\t\tlanding,\n\t\tserver: event.server === true,\n\t\tmode: event.mode ?? 'f',\n\t\tdurationMs: event.durationMs,\n\t\tscrollDepth: event.scrollDepth,\n\t}\n\tif (event.type === 'engagement') {\n\t\tconst seen = event.impressions?.slice(0, MAX_ITEMS_PER_BEACON) ?? []\n\t\treturn withoutAbsent({\n\t\t\t...hit,\n\t\t\tlastAt: new Date(Math.max(event.timestamp.getTime(), context.receivedAt.getTime())),\n\t\t\t...(seen.length > 0 ? { impressions: seen } : {}),\n\t\t})\n\t}\n\tconst goals = event.goals ?? []\n\tconst revenue = goals.reduce((sum, completion) => sum + completion.value, 0)\n\t// A pageview has no currency: a configured one is stamped on every event, money or not.\n\tconst money = event.value !== undefined || event.originalValue !== undefined || goals.length > 0\n\treturn withoutAbsent({\n\t\t...hit,\n\t\t...acquisitionOf(event, landing),\n\t\tname: event.name,\n\t\tcountry: event.country,\n\t\tregion: event.region,\n\t\tcity: event.city,\n\t\tlanguage: event.language,\n\t\tdevice: event.device,\n\t\tbrowser: event.browser,\n\t\tos: event.os,\n\t\tvalue: event.value,\n\t\toriginalValue: event.originalValue,\n\t\tcurrency: money ? event.currency : undefined,\n\t\toriginalCurrency: event.originalCurrency,\n\t\titem: event.item,\n\t\tprops: event.props,\n\t\t// A refund takes money back from a sale that still happened: revenue, and no conversion.\n\t\t...(goals.length > 0 ? { goals, conversions: event.refund ? 0 : goals.length, revenue } : {}),\n\t})\n}\n"],"mappings":";;;;;;;;;AAkBA,MAAa,aACZ,UAEA,MAAM,SAAS,cACf,MAAM,eAAe,QACrB,MAAM,iBAAiB,QACvB,CAAC,eAAe,MAAM,UAAU,MAAM,QAAQ;;;;;;AAO/C,MAAM,iBAAiB,OAAwB,YAAsC;CACpF,MAAM,MAAM,UAAU,MAAM,eAAe,KAAA;CAC3C,MAAM,SACL,QAAQ,KAAA,KACR,MAAM,YAAY,KAAA,KAClB;EAAC,MAAM;EAAW,MAAM;EAAW,MAAM;EAAa,MAAM;EAAY,MAAM;CAAO,EAAE,MACrF,QAAQ,QAAQ,KAAA,CAClB;CACD,IAAI,MAAM,cAAc,MAAM,CAAC,WAAW,MAAM,WAAW,QAAQ,CAAC,UACnE,OAAO,CAAC;CAET,OAAO;EACN;EACA,QAAQ,aAAa;GAAE,cAAc;GAAK,WAAW,MAAM;EAAU,CAAC;EACtE,SAAS,gBAAgB;GACxB,cAAc;GACd,WAAW,MAAM;GACjB,WAAW,MAAM;GACjB,SAAS,MAAM;EAChB,CAAC;EACD,gBAAA;EACA,SAAS,MAAM;EACf,WAAW,MAAM;EACjB,WAAW,MAAM;EACjB,aAAa,MAAM;EACnB,YAAY,MAAM;EAClB,SAAS,MAAM;CAChB;AACD;;AAGA,MAAM,iBAAiB,QAAwB;CAC9C,KAAK,MAAM,OAAO,OAAO,KAAK,GAAG,GAChC,IAAI,QAAQ,IAAI,KAAK,GAAG,MAAM,KAAA,GAC7B,QAAQ,eAAe,KAAK,GAAG;CAGjC,OAAO;AACR;;;;;AAMA,MAAa,SAAS,OAAwB,YAAgC;CAC7E,MAAM,UAAU,UAAU,KAAK;CAC/B,MAAM,MAAc;EACnB,IACC,MAAM,cAAc,KAAA,KAChB,QAAQ,OAAO,MAAM,MAAM,SAAS,IACrC,WAAW,MAAM,SAAS;EAC9B,OAAO,MAAM,SAAS;EACtB,IAAI,MAAM;EACV,MAAM,MAAM;EACZ,UAAU,MAAM;EAChB,MAAM,MAAM;EACZ,GAAG,MAAM,aAAa;EACtB;EACA,QAAQ,MAAM,WAAW;EACzB,MAAM,MAAM,QAAQ;EACpB,YAAY,MAAM;EAClB,aAAa,MAAM;CACpB;CACA,IAAI,MAAM,SAAS,cAAc;EAChC,MAAM,OAAO,MAAM,aAAa,MAAM,GAAA,EAAuB,KAAK,CAAC;EACnE,OAAO,cAAc;GACpB,GAAG;GACH,QAAQ,IAAI,KAAK,KAAK,IAAI,MAAM,UAAU,QAAQ,GAAG,QAAQ,WAAW,QAAQ,CAAC,CAAC;GAClF,GAAI,KAAK,SAAS,IAAI,EAAE,aAAa,KAAK,IAAI,CAAC;EAChD,CAAC;CACF;CACA,MAAM,QAAQ,MAAM,SAAS,CAAC;CAC9B,MAAM,UAAU,MAAM,QAAQ,KAAK,eAAe,MAAM,WAAW,OAAO,CAAC;CAE3E,MAAM,QAAQ,MAAM,UAAU,KAAA,KAAa,MAAM,kBAAkB,KAAA,KAAa,MAAM,SAAS;CAC/F,OAAO,cAAc;EACpB,GAAG;EACH,GAAG,cAAc,OAAO,OAAO;EAC/B,MAAM,MAAM;EACZ,SAAS,MAAM;EACf,QAAQ,MAAM;EACd,MAAM,MAAM;EACZ,UAAU,MAAM;EAChB,QAAQ,MAAM;EACd,SAAS,MAAM;EACf,IAAI,MAAM;EACV,OAAO,MAAM;EACb,eAAe,MAAM;EACrB,UAAU,QAAQ,MAAM,WAAW,KAAA;EACnC,kBAAkB,MAAM;EACxB,MAAM,MAAM;EACZ,OAAO,MAAM;EAEb,GAAI,MAAM,SAAS,IAAI;GAAE;GAAO,aAAa,MAAM,SAAS,IAAI,MAAM;GAAQ;EAAQ,IAAI,CAAC;CAC5F,CAAC;AACF"}
@@ -0,0 +1,14 @@
1
+ //#region src/native/engine/writeBuffer.d.ts
2
+ interface WriteBufferLimits {
3
+ /** Hits one write to the store carries at most. */
4
+ maxSize: number;
5
+ /** How long the first hit of a batch waits for its write. */
6
+ maxAgeMs: number;
7
+ /** Hits held at once, waiting or being written; past it, a new one waits for a write. */
8
+ maxPending: number;
9
+ }
10
+ /** `native({ buffer })`: off unless set; `true` takes defaults, an object overrides any of them. */
11
+ type WriteBufferOption = boolean | Partial<WriteBufferLimits>;
12
+ //#endregion
13
+ export { WriteBufferLimits, WriteBufferOption };
14
+ //# sourceMappingURL=writeBuffer.d.ts.map
@@ -0,0 +1,317 @@
1
+ import { isRecord } from "../../core/values.js";
2
+ import { monotonicMs } from "../../core/monotonic.js";
3
+ import { isRowError } from "../../db/errors.js";
4
+ import { isOrderHitId } from "../store/ids.js";
5
+ import { clearTimeout, setTimeout } from "node:timers";
6
+ //#region src/native/engine/writeBuffer.ts
7
+ const DEFAULT_WRITE_BUFFER = {
8
+ maxSize: 200,
9
+ maxAgeMs: 1e3,
10
+ maxPending: 5e3
11
+ };
12
+ const wholeLimit = (value, name) => {
13
+ if (typeof value !== "number" || !Number.isInteger(value) || value < 1) throw new Error(`analytics: native buffer.${name} must be a whole number of at least 1, got ${String(value)}`);
14
+ return value;
15
+ };
16
+ /** The limits an option asks for, null for no buffer; limits no buffer could keep fail the boot. */
17
+ const resolveWriteBuffer = (option) => {
18
+ if (option === void 0 || option === false) return null;
19
+ if (option !== true && (!isRecord(option) || Array.isArray(option))) throw new Error("analytics: native buffer must be true, false or an object of limits");
20
+ const given = option === true ? {} : option;
21
+ const limits = {
22
+ maxSize: wholeLimit(given.maxSize ?? DEFAULT_WRITE_BUFFER.maxSize, "maxSize"),
23
+ maxAgeMs: wholeLimit(given.maxAgeMs ?? DEFAULT_WRITE_BUFFER.maxAgeMs, "maxAgeMs"),
24
+ maxPending: wholeLimit(given.maxPending ?? DEFAULT_WRITE_BUFFER.maxPending, "maxPending")
25
+ };
26
+ if (limits.maxPending < limits.maxSize) throw new Error(`analytics: native buffer.maxPending (${limits.maxPending}) must be at least buffer.maxSize (${limits.maxSize})`);
27
+ return limits;
28
+ };
29
+ /** Environment variables a serverless platform sets in every function it runs. */
30
+ const SERVERLESS_ENV = [
31
+ "VERCEL",
32
+ "AWS_LAMBDA_FUNCTION_NAME",
33
+ "NETLIFY"
34
+ ];
35
+ /** The variable that gives a serverless platform away, or undefined when none is set. */
36
+ const serverlessPlatformOf = (env) => SERVERLESS_ENV.find((name) => (env[name] ?? "") !== "");
37
+ /** One line about dropped hits at most this often, whatever the database does. */
38
+ const DROP_LOG_INTERVAL_MS = 6e4;
39
+ /** How long a SIGTERM or SIGINT waits for the last write before the signal is handed on. */
40
+ const SIGNAL_FLUSH_MS = 5e3;
41
+ /** How often deferred work asks whether it may run. */
42
+ const DEFER_POLL_MS = 50;
43
+ /** Deferred work held at once, waiting or running: past it, more is dropped and logged. */
44
+ const MAX_DEFERRED = 1e4;
45
+ const STOP_SIGNALS = ["SIGTERM", "SIGINT"];
46
+ const unrefTimer = (run, ms) => {
47
+ const handle = setTimeout(run, ms).unref();
48
+ return () => clearTimeout(handle);
49
+ };
50
+ /** Resolves when `work` settles or `ms` has passed, whichever comes first. */
51
+ const settleWithin = (work, ms) => new Promise((resolve) => {
52
+ const cancel = unrefTimer(resolve, ms);
53
+ work.finally(() => {
54
+ cancel();
55
+ resolve();
56
+ });
57
+ });
58
+ /** Reports failures at most once a minute, with how many there were since the last line. */
59
+ const rateLimitedReport = (logger, now, message) => {
60
+ let missed = 0;
61
+ let loggedAt = null;
62
+ return (count, error) => {
63
+ missed += count;
64
+ const at = now();
65
+ if (loggedAt !== null && at - loggedAt < DROP_LOG_INTERVAL_MS) return;
66
+ loggedAt = at;
67
+ logger?.error({
68
+ err: error,
69
+ msg: message(missed)
70
+ });
71
+ missed = 0;
72
+ };
73
+ };
74
+ /** Work that waits its turn, asked on a timer whether it may run yet; at most `MAX_DEFERRED`. */
75
+ const createDeferrals = (args) => {
76
+ let waiting = [];
77
+ const running = /* @__PURE__ */ new Set();
78
+ let cancel = null;
79
+ const mayRun = (entry, force) => {
80
+ if (force || args.now() - entry.since >= 6e5) return true;
81
+ try {
82
+ return !entry.blocked();
83
+ } catch {
84
+ return true;
85
+ }
86
+ };
87
+ const start = (entry) => {
88
+ const task = entry.work().catch(args.failed);
89
+ running.add(task);
90
+ task.then(() => running.delete(task));
91
+ };
92
+ const poll = (force) => {
93
+ cancel?.();
94
+ cancel = null;
95
+ const still = [];
96
+ for (const entry of waiting) if (mayRun(entry, force)) start(entry);
97
+ else still.push(entry);
98
+ waiting = still;
99
+ if (waiting.length > 0) cancel = args.setTimer(() => poll(false), DEFER_POLL_MS);
100
+ };
101
+ return {
102
+ add(work, blocked) {
103
+ if (waiting.length + running.size >= 1e4) {
104
+ args.dropped();
105
+ return;
106
+ }
107
+ waiting.push({
108
+ work,
109
+ blocked,
110
+ since: args.now()
111
+ });
112
+ poll(false);
113
+ },
114
+ /** Work not finished yet, waiting or running. */
115
+ held: () => waiting.length + running.size,
116
+ /** Starts what may run (everything, when forced) and waits for all of it to finish. */
117
+ async settle(force) {
118
+ poll(force);
119
+ while (running.size > 0) await Promise.allSettled([...running]);
120
+ }
121
+ };
122
+ };
123
+ /**
124
+ * Writes what a writer holds before the process goes: on SIGTERM and SIGINT, then hands the signal
125
+ * back; when the event loop runs dry; and on `exit`, where no write can run, warns what is lost.
126
+ */
127
+ const guardShutdown = (args) => {
128
+ const { signals } = args;
129
+ let listening = false;
130
+ let settling = null;
131
+ const settleOnce = (stopping) => {
132
+ settling ??= args.settle(stopping).finally(() => {
133
+ settling = null;
134
+ });
135
+ return settling;
136
+ };
137
+ const onBeforeExit = () => {
138
+ if (args.held() > 0 && settling === null) settleOnce(false);
139
+ };
140
+ const onExit = () => {
141
+ const lost = args.held();
142
+ if (lost > 0) args.logger?.warn(`analytics: the process exited with ${lost} hits not stored yet, and they are lost. Destroy Payload (await payload.destroy()) before calling process.exit() to store them.`);
143
+ };
144
+ const onSignal = (signal) => () => {
145
+ settleWithin(settleOnce(true), SIGNAL_FLUSH_MS).then(() => {
146
+ release();
147
+ if (signals.listenerCount(signal) === 0) signals.kill(signals.pid, signal);
148
+ });
149
+ };
150
+ const handlers = new Map(STOP_SIGNALS.map((signal) => [signal, onSignal(signal)]));
151
+ const release = () => {
152
+ if (!listening) return;
153
+ listening = false;
154
+ signals.off("beforeExit", onBeforeExit);
155
+ signals.off("exit", onExit);
156
+ for (const [signal, handler] of handlers) signals.off(signal, handler);
157
+ };
158
+ return {
159
+ listen() {
160
+ if (listening) return;
161
+ listening = true;
162
+ signals.on("beforeExit", onBeforeExit);
163
+ signals.on("exit", onExit);
164
+ for (const [signal, handler] of handlers) signals.on(signal, handler);
165
+ },
166
+ release
167
+ };
168
+ };
169
+ const DEFERRED_FAILED = (count) => `analytics: ${count} server events recorded inside a database transaction could not be stored once it ended. Logged at most once a minute.`;
170
+ const DEFERRED_DROPPED = (count) => `analytics: ${count} server events recorded inside a database transaction were dropped: ${MAX_DEFERRED} were already waiting for theirs to end. Logged at most once a minute.`;
171
+ const BUFFERED_DROPPED = (count) => `analytics: ${count} buffered hits could not be written and were dropped. Logged at most once a minute.`;
172
+ /**
173
+ * Writes hits through an optional buffer bounded by size, age and hits held; a batch refused for
174
+ * its rows goes again hit by hit, one refused for the database's state again whole, once.
175
+ */
176
+ const createHitWriter = (options) => {
177
+ const { store, logger } = options;
178
+ const limits = resolveWriteBuffer(options.buffer);
179
+ const now = options.now ?? monotonicMs;
180
+ const setTimer = options.setTimer ?? unrefTimer;
181
+ const deferredFailed = rateLimitedReport(logger, now, DEFERRED_FAILED);
182
+ const deferredDropped = rateLimitedReport(logger, now, DEFERRED_DROPPED);
183
+ const deferrals = createDeferrals({
184
+ now,
185
+ setTimer,
186
+ failed: (error) => deferredFailed(1, error),
187
+ dropped: () => deferredDropped(1, /* @__PURE__ */ new Error("too many server events waiting"))
188
+ });
189
+ const direct = (hit) => store.append([hit]);
190
+ const signals = options.signals ?? process;
191
+ if (limits === null) {
192
+ const shutdown = guardShutdown({
193
+ signals,
194
+ logger,
195
+ held: deferrals.held,
196
+ settle: () => deferrals.settle(true)
197
+ });
198
+ return {
199
+ write: direct,
200
+ defer(work, blocked) {
201
+ shutdown.listen();
202
+ deferrals.add(work, blocked);
203
+ },
204
+ flush: () => deferrals.settle(false),
205
+ async close() {
206
+ shutdown.release();
207
+ await deferrals.settle(true);
208
+ },
209
+ pending: () => 0
210
+ };
211
+ }
212
+ const platform = serverlessPlatformOf(options.env ?? process.env);
213
+ if (platform !== void 0) logger?.warn(`analytics: native buffer is on, and ${platform} is set. On a serverless platform a function can be frozen or stopped between requests, and the hits it still holds in memory are lost: turn the buffer off there.`);
214
+ let waiting = [];
215
+ let writing = 0;
216
+ let flushing = Promise.resolve();
217
+ /** A drain is chained behind the current one and has not started yet. */
218
+ let queued = false;
219
+ let cancelTimer = null;
220
+ let closed = false;
221
+ const report = rateLimitedReport(logger, now, BUFFERED_DROPPED);
222
+ /** Resolves with the store's refusal of `hits`, or null once they are written. */
223
+ const attempt = (hits) => store.append(hits).then(() => null, (error) => error ?? /* @__PURE__ */ new Error("analytics: the store refused a write"));
224
+ const pause = (ms) => new Promise((resolve) => {
225
+ setTimer(resolve, ms);
226
+ });
227
+ const writeBatch = async (batch) => {
228
+ let failure = await attempt(batch);
229
+ if (failure === null) return;
230
+ if (!isRowError(failure)) {
231
+ await pause(500);
232
+ failure = await attempt(batch);
233
+ if (failure === null) return;
234
+ if (!isRowError(failure)) {
235
+ report(batch.length, failure);
236
+ return;
237
+ }
238
+ }
239
+ let lost = 0;
240
+ for (const [index, hit] of batch.entries()) {
241
+ const refused = await attempt([hit]);
242
+ if (refused === null) continue;
243
+ if (!isRowError(refused)) {
244
+ report(lost + batch.length - index, refused);
245
+ return;
246
+ }
247
+ lost += 1;
248
+ }
249
+ if (lost > 0) report(lost, failure);
250
+ };
251
+ const drain = async () => {
252
+ cancelTimer?.();
253
+ cancelTimer = null;
254
+ while (waiting.length > 0) {
255
+ const batch = waiting.slice(0, limits.maxSize);
256
+ waiting = waiting.slice(batch.length);
257
+ writing = batch.length;
258
+ try {
259
+ await writeBatch(batch);
260
+ } finally {
261
+ writing = 0;
262
+ }
263
+ }
264
+ };
265
+ const drainBuffer = () => {
266
+ if (!queued) {
267
+ queued = true;
268
+ flushing = flushing.then(() => {
269
+ queued = false;
270
+ return drain();
271
+ }).catch(() => void 0);
272
+ }
273
+ return flushing;
274
+ };
275
+ const flush = async () => {
276
+ await deferrals.settle(false);
277
+ await drainBuffer();
278
+ };
279
+ const pending = () => waiting.length + writing;
280
+ const shutdown = guardShutdown({
281
+ signals,
282
+ logger,
283
+ held: () => pending() + deferrals.held(),
284
+ settle: async (stopping) => {
285
+ closed ||= stopping;
286
+ await deferrals.settle(true);
287
+ await drainBuffer();
288
+ }
289
+ });
290
+ shutdown.listen();
291
+ return {
292
+ async write(hit, writeOptions) {
293
+ const bypass = writeOptions?.flush === true || isOrderHitId(hit.id);
294
+ while (!bypass && !closed && pending() >= limits.maxPending) await drainBuffer();
295
+ if (bypass || closed) return direct(hit);
296
+ waiting.push(hit);
297
+ if (waiting.length >= limits.maxSize) drainBuffer();
298
+ else if (cancelTimer === null) cancelTimer = setTimer(() => {
299
+ cancelTimer = null;
300
+ drainBuffer();
301
+ }, limits.maxAgeMs);
302
+ },
303
+ defer: deferrals.add,
304
+ flush,
305
+ async close() {
306
+ closed = true;
307
+ shutdown.release();
308
+ await deferrals.settle(true);
309
+ await drainBuffer();
310
+ },
311
+ pending
312
+ };
313
+ };
314
+ //#endregion
315
+ export { createHitWriter, resolveWriteBuffer };
316
+
317
+ //# sourceMappingURL=writeBuffer.js.map