@10x-media/analytics 1.0.0-beta.9 → 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 +710 -0
  2. package/README.md +35 -36
  3. package/dist/access/adminUser.d.ts +15 -0
  4. package/dist/access/adminUser.js +13 -0
  5. package/dist/access/adminUser.js.map +1 -0
  6. package/dist/access/decideOnce.js +16 -0
  7. package/dist/access/decideOnce.js.map +1 -0
  8. package/dist/access/membership.d.ts +23 -0
  9. package/dist/access/membership.js +63 -0
  10. package/dist/access/membership.js.map +1 -0
  11. package/dist/access/principal.d.ts +37 -0
  12. package/dist/access/principal.js +29 -0
  13. package/dist/access/principal.js.map +1 -0
  14. package/dist/access/readGate.js +16 -0
  15. package/dist/access/readGate.js.map +1 -0
  16. package/dist/adapters/ga4/disableKey.js +19 -0
  17. package/dist/adapters/ga4/disableKey.js.map +1 -0
  18. package/dist/adapters/ga4/eventName.d.ts +2 -8
  19. package/dist/adapters/ga4/eventName.js +2 -8
  20. package/dist/adapters/ga4/eventName.js.map +1 -1
  21. package/dist/adapters/ga4/ga4.d.ts +24 -0
  22. package/dist/adapters/ga4/ga4.js +226 -122
  23. package/dist/adapters/ga4/ga4.js.map +1 -1
  24. package/dist/adapters/ga4/measurementId.js +2 -3
  25. package/dist/adapters/ga4/measurementId.js.map +1 -1
  26. package/dist/adapters/goalRead.js +15 -29
  27. package/dist/adapters/goalRead.js.map +1 -1
  28. package/dist/adapters/http/baseUrl.js +15 -0
  29. package/dist/adapters/http/baseUrl.js.map +1 -0
  30. package/dist/adapters/http/fetchJson.d.ts +19 -0
  31. package/dist/adapters/http/fetchJson.js +27 -8
  32. package/dist/adapters/http/fetchJson.js.map +1 -1
  33. package/dist/adapters/mapping.js +52 -0
  34. package/dist/adapters/mapping.js.map +1 -0
  35. package/dist/adapters/plausible/plausible.d.ts +25 -13
  36. package/dist/adapters/plausible/plausible.js +144 -124
  37. package/dist/adapters/plausible/plausible.js.map +1 -1
  38. package/dist/adapters/plausible/scriptId.js +19 -0
  39. package/dist/adapters/plausible/scriptId.js.map +1 -0
  40. package/dist/adapters/posthog/posthog.d.ts +33 -9
  41. package/dist/adapters/posthog/posthog.js +279 -121
  42. package/dist/adapters/posthog/posthog.js.map +1 -1
  43. package/dist/adapters/posthog/projectCheck.js +56 -0
  44. package/dist/adapters/posthog/projectCheck.js.map +1 -0
  45. package/dist/adapters/readTime.js +7 -0
  46. package/dist/adapters/readTime.js.map +1 -0
  47. package/dist/adapters/series.js +14 -8
  48. package/dist/adapters/series.js.map +1 -1
  49. package/dist/adapters/umami/umami.d.ts +19 -9
  50. package/dist/adapters/umami/umami.js +196 -166
  51. package/dist/adapters/umami/umami.js.map +1 -1
  52. package/dist/adapters/upstream.js +16 -0
  53. package/dist/adapters/upstream.js.map +1 -0
  54. package/dist/binding/report.d.ts +8 -0
  55. package/dist/binding/report.js +24 -0
  56. package/dist/binding/report.js.map +1 -0
  57. package/dist/binding/resolvePath.js +28 -25
  58. package/dist/binding/resolvePath.js.map +1 -1
  59. package/dist/binding/types.d.ts +14 -29
  60. package/dist/capture/captureRequest.js +28 -0
  61. package/dist/capture/captureRequest.js.map +1 -0
  62. package/dist/capture/exclusionEndpoint.js +98 -0
  63. package/dist/capture/exclusionEndpoint.js.map +1 -0
  64. package/dist/capture/exclusionPrelude.js +14 -0
  65. package/dist/capture/exclusionPrelude.js.map +1 -0
  66. package/dist/capture/exclusionToken.js +23 -0
  67. package/dist/capture/exclusionToken.js.map +1 -0
  68. package/dist/capture/jsLiteral.js +19 -0
  69. package/dist/capture/jsLiteral.js.map +1 -0
  70. package/dist/capture/mountPath.js +2 -3
  71. package/dist/capture/mountPath.js.map +1 -1
  72. package/dist/capture/proxyEndpoint.js +49 -92
  73. package/dist/capture/proxyEndpoint.js.map +1 -1
  74. package/dist/capture/proxyRoutes.js +58 -21
  75. package/dist/capture/proxyRoutes.js.map +1 -1
  76. package/dist/capture/relay.js +91 -0
  77. package/dist/capture/relay.js.map +1 -0
  78. package/dist/capture/requestBody.js +2 -6
  79. package/dist/capture/requestBody.js.map +1 -1
  80. package/dist/capture/requestTrust.js +45 -0
  81. package/dist/capture/requestTrust.js.map +1 -0
  82. package/dist/capture/sameSite.js +40 -0
  83. package/dist/capture/sameSite.js.map +1 -0
  84. package/dist/capture/slots.js +50 -25
  85. package/dist/capture/slots.js.map +1 -1
  86. package/dist/capture/trackerConfig.js +131 -36
  87. package/dist/capture/trackerConfig.js.map +1 -1
  88. package/dist/capture/trackerEndpoint.js +22 -21
  89. package/dist/capture/trackerEndpoint.js.map +1 -1
  90. package/dist/capture/withoutConsent.js +91 -0
  91. package/dist/capture/withoutConsent.js.map +1 -0
  92. package/dist/charts/BarList.d.ts +27 -13
  93. package/dist/charts/BarList.js +38 -83
  94. package/dist/charts/BarList.js.map +1 -1
  95. package/dist/charts/TrendChart.d.ts +40 -7
  96. package/dist/charts/TrendChart.js +243 -215
  97. package/dist/charts/TrendChart.js.map +1 -1
  98. package/dist/charts/bars.d.ts +17 -1
  99. package/dist/charts/bars.js +12 -11
  100. package/dist/charts/bars.js.map +1 -1
  101. package/dist/charts/bucket.js +106 -73
  102. package/dist/charts/bucket.js.map +1 -1
  103. package/dist/charts/inProgress.js +22 -0
  104. package/dist/charts/inProgress.js.map +1 -0
  105. package/dist/charts/series.d.ts +15 -0
  106. package/dist/charts/series.js +123 -0
  107. package/dist/charts/series.js.map +1 -0
  108. package/dist/charts/spline.js +91 -25
  109. package/dist/charts/spline.js.map +1 -1
  110. package/dist/charts/trendGeometry.js +91 -0
  111. package/dist/charts/trendGeometry.js.map +1 -0
  112. package/dist/core/adminOptions.d.ts +1 -0
  113. package/dist/core/adminOptions.js +198 -0
  114. package/dist/core/adminOptions.js.map +1 -0
  115. package/dist/core/budget.js +24 -0
  116. package/dist/core/budget.js.map +1 -0
  117. package/dist/core/cacheKey.d.ts +1 -0
  118. package/dist/core/cacheKey.js +48 -36
  119. package/dist/core/cacheKey.js.map +1 -1
  120. package/dist/core/cacheOptions.js +165 -0
  121. package/dist/core/cacheOptions.js.map +1 -0
  122. package/dist/core/capabilities.d.ts +24 -11
  123. package/dist/core/capabilities.js +96 -17
  124. package/dist/core/capabilities.js.map +1 -1
  125. package/dist/core/capture.d.ts +59 -26
  126. package/dist/core/captureOptions.d.ts +1 -0
  127. package/dist/core/captureOptions.js +347 -0
  128. package/dist/core/captureOptions.js.map +1 -0
  129. package/dist/core/clock.js +13 -0
  130. package/dist/core/clock.js.map +1 -0
  131. package/dist/core/collectionOption.d.ts +17 -0
  132. package/dist/core/collectionOption.js +105 -0
  133. package/dist/core/collectionOption.js.map +1 -0
  134. package/dist/core/collectionSlug.js +7 -0
  135. package/dist/core/collectionSlug.js.map +1 -0
  136. package/dist/core/contract.d.ts +321 -60
  137. package/dist/core/contract.js +7 -4
  138. package/dist/core/contract.js.map +1 -1
  139. package/dist/core/cron.js +57 -0
  140. package/dist/core/cron.js.map +1 -0
  141. package/dist/core/fetch.d.ts +17 -0
  142. package/dist/core/goalOptions.d.ts +1 -0
  143. package/dist/core/goalOptions.js +166 -0
  144. package/dist/core/goalOptions.js.map +1 -0
  145. package/dist/core/granularity.js +3 -2
  146. package/dist/core/granularity.js.map +1 -1
  147. package/dist/core/guards.js +17 -0
  148. package/dist/core/guards.js.map +1 -0
  149. package/dist/core/jobs.d.ts +40 -0
  150. package/dist/core/jobs.js +132 -0
  151. package/dist/core/jobs.js.map +1 -0
  152. package/dist/core/legacyOptions.js +145 -0
  153. package/dist/core/legacyOptions.js.map +1 -0
  154. package/dist/core/metricAliases.js +81 -0
  155. package/dist/core/metricAliases.js.map +1 -0
  156. package/dist/core/metricValues.js +57 -0
  157. package/dist/core/metricValues.js.map +1 -0
  158. package/dist/core/monotonic.js +10 -0
  159. package/dist/core/monotonic.js.map +1 -0
  160. package/dist/core/optionChecks.js +51 -0
  161. package/dist/core/optionChecks.js.map +1 -0
  162. package/dist/core/options.d.ts +530 -152
  163. package/dist/core/options.js +158 -216
  164. package/dist/core/options.js.map +1 -1
  165. package/dist/core/registry.js +45 -5
  166. package/dist/core/registry.js.map +1 -1
  167. package/dist/core/scopeList.js +7 -9
  168. package/dist/core/scopeList.js.map +1 -1
  169. package/dist/core/scopeOptions.d.ts +1 -0
  170. package/dist/core/scopeOptions.js +114 -0
  171. package/dist/core/scopeOptions.js.map +1 -0
  172. package/dist/core/scopedRead.js +349 -36
  173. package/dist/core/scopedRead.js.map +1 -1
  174. package/dist/core/sdks.d.ts +81 -0
  175. package/dist/core/sdks.js +23 -0
  176. package/dist/core/sdks.js.map +1 -0
  177. package/dist/core/serverEvent.d.ts +50 -16
  178. package/dist/core/serverEvent.js.map +1 -1
  179. package/dist/core/siteAddress.js +20 -0
  180. package/dist/core/siteAddress.js.map +1 -0
  181. package/dist/core/sourceErrors.js +109 -0
  182. package/dist/core/sourceErrors.js.map +1 -0
  183. package/dist/core/sourceLabel.d.ts +10 -0
  184. package/dist/core/sourceLabel.js +63 -0
  185. package/dist/core/sourceLabel.js.map +1 -0
  186. package/dist/core/sourceOptions.js +107 -0
  187. package/dist/core/sourceOptions.js.map +1 -0
  188. package/dist/core/sourcePolicy.d.ts +55 -0
  189. package/dist/core/sourcePolicy.js +51 -0
  190. package/dist/core/sourcePolicy.js.map +1 -0
  191. package/dist/core/throttle.js +18 -0
  192. package/dist/core/throttle.js.map +1 -0
  193. package/dist/core/values.js +61 -0
  194. package/dist/core/values.js.map +1 -0
  195. package/dist/core/widgetSlugs.d.ts +17 -0
  196. package/dist/core/widgetSlugs.js +29 -0
  197. package/dist/core/widgetSlugs.js.map +1 -0
  198. package/dist/db/detachedWrite.js +36 -0
  199. package/dist/db/detachedWrite.js.map +1 -0
  200. package/dist/db/errors.js +182 -0
  201. package/dist/db/errors.js.map +1 -0
  202. package/dist/db/kind.js +32 -0
  203. package/dist/db/kind.js.map +1 -0
  204. package/dist/db/openTransaction.js +51 -0
  205. package/dist/db/openTransaction.js.map +1 -0
  206. package/dist/exports/adapters/contract.d.ts +15 -0
  207. package/dist/exports/adapters/ga4.d.ts +16 -1
  208. package/dist/exports/adapters/native.d.ts +29 -2
  209. package/dist/exports/adapters/native.js +5 -1
  210. package/dist/exports/adapters/plausible.d.ts +16 -1
  211. package/dist/exports/adapters/posthog.d.ts +16 -1
  212. package/dist/exports/adapters/umami.d.ts +16 -1
  213. package/dist/exports/attributes.d.ts +42 -0
  214. package/dist/exports/attributes.js +83 -0
  215. package/dist/exports/attributes.js.map +1 -0
  216. package/dist/exports/client.d.ts +43 -12
  217. package/dist/exports/client.js +22 -8
  218. package/dist/exports/geo.d.ts +4 -2
  219. package/dist/exports/geo.js +1 -1
  220. package/dist/exports/i18n.d.ts +2 -2
  221. package/dist/exports/i18n.js +2 -2
  222. package/dist/exports/migrations.d.ts +2 -0
  223. package/dist/exports/migrations.js +2 -0
  224. package/dist/exports/react.d.ts +5 -3
  225. package/dist/exports/react.js +1 -2
  226. package/dist/exports/routes.d.ts +19 -0
  227. package/dist/exports/routes.js +3 -0
  228. package/dist/exports/rsc.d.ts +32 -14
  229. package/dist/exports/rsc.js +11 -6
  230. package/dist/exports/site.d.ts +5 -0
  231. package/dist/exports/site.js +3 -0
  232. package/dist/exports/testing.d.ts +18 -0
  233. package/dist/exports/testing.js +3 -0
  234. package/dist/exports/tracker.d.ts +6 -18
  235. package/dist/exports/tracker.js +3 -12
  236. package/dist/exports/types.d.ts +45 -14
  237. package/dist/exports/types.js +6 -1
  238. package/dist/fields/AnalyticsPanelClient.js +265 -154
  239. package/dist/fields/AnalyticsPanelClient.js.map +1 -1
  240. package/dist/fields/AnalyticsPanelField.d.ts +19 -7
  241. package/dist/fields/AnalyticsPanelField.js +123 -30
  242. package/dist/fields/AnalyticsPanelField.js.map +1 -1
  243. package/dist/fields/AnalyticsStatField.d.ts +17 -6
  244. package/dist/fields/AnalyticsStatField.js +98 -63
  245. package/dist/fields/AnalyticsStatField.js.map +1 -1
  246. package/dist/fields/FieldShimmer.js +15 -0
  247. package/dist/fields/FieldShimmer.js.map +1 -0
  248. package/dist/fields/PanelContent.js +222 -0
  249. package/dist/fields/PanelContent.js.map +1 -0
  250. package/dist/fields/PanelList.js +82 -0
  251. package/dist/fields/PanelList.js.map +1 -0
  252. package/dist/fields/PanelLiveCounter.js +63 -0
  253. package/dist/fields/PanelLiveCounter.js.map +1 -0
  254. package/dist/fields/PanelSkeleton.js +63 -0
  255. package/dist/fields/PanelSkeleton.js.map +1 -0
  256. package/dist/fields/componentPaths.js +8 -0
  257. package/dist/fields/componentPaths.js.map +1 -0
  258. package/dist/fields/config/FilterDimensionSelectField.d.ts +2 -2
  259. package/dist/fields/config/FilterDimensionSelectField.js +26 -54
  260. package/dist/fields/config/FilterDimensionSelectField.js.map +1 -1
  261. package/dist/fields/config/FilterKeySelect.js +66 -0
  262. package/dist/fields/config/FilterKeySelect.js.map +1 -0
  263. package/dist/fields/config/FilterOperatorSelectField.d.ts +7 -2
  264. package/dist/fields/config/FilterOperatorSelectField.js +37 -53
  265. package/dist/fields/config/FilterOperatorSelectField.js.map +1 -1
  266. package/dist/fields/config/FilterValueField.d.ts +17 -0
  267. package/dist/fields/config/FilterValueField.js +130 -0
  268. package/dist/fields/config/FilterValueField.js.map +1 -0
  269. package/dist/fields/config/MetricSelectField.d.ts +5 -12
  270. package/dist/fields/config/MetricSelectField.js +18 -30
  271. package/dist/fields/config/MetricSelectField.js.map +1 -1
  272. package/dist/fields/config/OptionSelect.js +52 -0
  273. package/dist/fields/config/OptionSelect.js.map +1 -0
  274. package/dist/fields/config/SourceSelectField.js +16 -31
  275. package/dist/fields/config/SourceSelectField.js.map +1 -1
  276. package/dist/fields/config/fetchSources.d.ts +3 -0
  277. package/dist/fields/config/fetchSources.js +17 -23
  278. package/dist/fields/config/fetchSources.js.map +1 -1
  279. package/dist/fields/config/filterValues.js +106 -0
  280. package/dist/fields/config/filterValues.js.map +1 -0
  281. package/dist/fields/config/narrow.js +8 -10
  282. package/dist/fields/config/narrow.js.map +1 -1
  283. package/dist/fields/config/retiredPickers.d.ts +45 -0
  284. package/dist/fields/config/retiredPickers.js +46 -0
  285. package/dist/fields/config/retiredPickers.js.map +1 -0
  286. package/dist/fields/config/scopedFields.d.ts +40 -0
  287. package/dist/fields/config/scopedFields.js +68 -0
  288. package/dist/fields/config/scopedFields.js.map +1 -0
  289. package/dist/fields/config/toSelectOption.js +13 -7
  290. package/dist/fields/config/toSelectOption.js.map +1 -1
  291. package/dist/fields/config/useAnalyticsSources.d.ts +5 -7
  292. package/dist/fields/config/useAnalyticsSources.js +17 -21
  293. package/dist/fields/config/useAnalyticsSources.js.map +1 -1
  294. package/dist/fields/config/useFilterCapabilities.d.ts +9 -6
  295. package/dist/fields/config/useFilterCapabilities.js +23 -15
  296. package/dist/fields/config/useFilterCapabilities.js.map +1 -1
  297. package/dist/fields/config/useFormString.js +12 -0
  298. package/dist/fields/config/useFormString.js.map +1 -0
  299. package/dist/fields/dateRange/field.js +7 -19
  300. package/dist/fields/dateRange/field.js.map +1 -1
  301. package/dist/fields/dateRange/types.d.ts +5 -1
  302. package/dist/fields/dateRange/ui.d.ts +3 -2
  303. package/dist/fields/dateRange/ui.js +57 -319
  304. package/dist/fields/dateRange/ui.js.map +1 -1
  305. package/dist/fields/documentScope.js +21 -0
  306. package/dist/fields/documentScope.js.map +1 -0
  307. package/dist/fields/emptyState.js +30 -26
  308. package/dist/fields/emptyState.js.map +1 -1
  309. package/dist/fields/factories.d.ts +35 -16
  310. package/dist/fields/factories.js +67 -38
  311. package/dist/fields/factories.js.map +1 -1
  312. package/dist/fields/format.d.ts +12 -3
  313. package/dist/fields/format.js +77 -13
  314. package/dist/fields/format.js.map +1 -1
  315. package/dist/fields/itemReport.js +45 -0
  316. package/dist/fields/itemReport.js.map +1 -0
  317. package/dist/fields/readForDocument.d.ts +79 -26
  318. package/dist/fields/readForDocument.js +450 -116
  319. package/dist/fields/readForDocument.js.map +1 -1
  320. package/dist/fields/stateKeys.js +20 -0
  321. package/dist/fields/stateKeys.js.map +1 -0
  322. package/dist/goals/GoalAmountField.d.ts +10 -0
  323. package/dist/goals/GoalAmountField.js +179 -0
  324. package/dist/goals/GoalAmountField.js.map +1 -0
  325. package/dist/goals/GoalSelectField.js +89 -40
  326. package/dist/goals/GoalSelectField.js.map +1 -1
  327. package/dist/goals/GoalSelectFieldServer.d.ts +13 -0
  328. package/dist/goals/GoalSelectFieldServer.js +21 -0
  329. package/dist/goals/GoalSelectFieldServer.js.map +1 -0
  330. package/dist/goals/amountField.d.ts +20 -0
  331. package/dist/goals/amountField.js +37 -0
  332. package/dist/goals/amountField.js.map +1 -0
  333. package/dist/goals/builtin.js +17 -0
  334. package/dist/goals/builtin.js.map +1 -0
  335. package/dist/goals/collection.d.ts +22 -0
  336. package/dist/goals/collection.js +143 -124
  337. package/dist/goals/collection.js.map +1 -1
  338. package/dist/goals/constants.d.ts +38 -0
  339. package/dist/goals/constants.js +49 -0
  340. package/dist/goals/constants.js.map +1 -0
  341. package/dist/goals/currency.d.ts +16 -0
  342. package/dist/goals/currency.js +46 -4
  343. package/dist/goals/currency.js.map +1 -1
  344. package/dist/goals/currencyOptions.js +70 -0
  345. package/dist/goals/currencyOptions.js.map +1 -0
  346. package/dist/goals/fetchGoals.d.ts +10 -0
  347. package/dist/goals/fetchGoals.js +12 -22
  348. package/dist/goals/fetchGoals.js.map +1 -1
  349. package/dist/goals/goalField.d.ts +4 -6
  350. package/dist/goals/goalField.js +9 -19
  351. package/dist/goals/goalField.js.map +1 -1
  352. package/dist/goals/goalsEndpoint.js +40 -38
  353. package/dist/goals/goalsEndpoint.js.map +1 -1
  354. package/dist/goals/items.js +35 -0
  355. package/dist/goals/items.js.map +1 -0
  356. package/dist/goals/latent.js +9 -0
  357. package/dist/goals/latent.js.map +1 -0
  358. package/dist/goals/linkFields.d.ts +35 -0
  359. package/dist/goals/linkFields.js +31 -0
  360. package/dist/goals/linkFields.js.map +1 -0
  361. package/dist/goals/match.d.ts +14 -0
  362. package/dist/goals/match.js +67 -46
  363. package/dist/goals/match.js.map +1 -1
  364. package/dist/goals/moneyFields.js +56 -0
  365. package/dist/goals/moneyFields.js.map +1 -0
  366. package/dist/goals/pathMatch.js +122 -0
  367. package/dist/goals/pathMatch.js.map +1 -0
  368. package/dist/goals/placeholder.js +12 -0
  369. package/dist/goals/placeholder.js.map +1 -0
  370. package/dist/goals/resolver.d.ts +3 -3
  371. package/dist/goals/resolver.js +155 -47
  372. package/dist/goals/resolver.js.map +1 -1
  373. package/dist/goals/serverRevenue.d.ts +60 -0
  374. package/dist/goals/serverRevenue.js +41 -0
  375. package/dist/goals/serverRevenue.js.map +1 -0
  376. package/dist/goals/trackGoalAction.d.ts +26 -25
  377. package/dist/goals/trackGoalAction.js +71 -66
  378. package/dist/goals/trackGoalAction.js.map +1 -1
  379. package/dist/goals/types.d.ts +13 -28
  380. package/dist/goals/types.js +1 -1
  381. package/dist/goals/types.js.map +1 -1
  382. package/dist/goals/useAnalyticsGoals.d.ts +6 -5
  383. package/dist/goals/useAnalyticsGoals.js +17 -18
  384. package/dist/goals/useAnalyticsGoals.js.map +1 -1
  385. package/dist/index.d.ts +68 -12
  386. package/dist/index.js +261 -192
  387. package/dist/index.js.map +1 -1
  388. package/dist/items/collectionIdType.js +20 -0
  389. package/dist/items/collectionIdType.js.map +1 -0
  390. package/dist/items/idType.js +31 -0
  391. package/dist/items/idType.js.map +1 -0
  392. package/dist/items/ref.js +73 -0
  393. package/dist/items/ref.js.map +1 -0
  394. package/dist/maintenance/apiTaskState.js +141 -0
  395. package/dist/maintenance/apiTaskState.js.map +1 -0
  396. package/dist/maintenance/heartbeat.js +51 -0
  397. package/dist/maintenance/heartbeat.js.map +1 -0
  398. package/dist/maintenance/lease.d.ts +1 -0
  399. package/dist/maintenance/lease.js +79 -0
  400. package/dist/maintenance/lease.js.map +1 -0
  401. package/dist/maintenance/taskSchedule.js +27 -0
  402. package/dist/maintenance/taskSchedule.js.map +1 -0
  403. package/dist/maintenance/underLease.js +35 -0
  404. package/dist/maintenance/underLease.js.map +1 -0
  405. package/dist/migrations/legacy.d.ts +54 -0
  406. package/dist/migrations/legacy.js +117 -0
  407. package/dist/migrations/legacy.js.map +1 -0
  408. package/dist/migrations/predefined/dropLegacyMongo.d.ts +11 -0
  409. package/dist/migrations/predefined/dropLegacyMongo.js +12 -0
  410. package/dist/migrations/predefined/dropLegacyMongo.js.map +1 -0
  411. package/dist/native/collections/aggregates.js +54 -0
  412. package/dist/native/collections/aggregates.js.map +1 -0
  413. package/dist/native/collections/hits.js +103 -0
  414. package/dist/native/collections/hits.js.map +1 -0
  415. package/dist/native/collections/slugs.d.ts +10 -0
  416. package/dist/native/collections/slugs.js +16 -0
  417. package/dist/native/collections/slugs.js.map +1 -0
  418. package/dist/native/collections/state.js +84 -0
  419. package/dist/native/collections/state.js.map +1 -0
  420. package/dist/native/collections/storeCollection.js +31 -0
  421. package/dist/native/collections/storeCollection.js.map +1 -0
  422. package/dist/native/engine/buckets.d.ts +1 -0
  423. package/dist/native/engine/buckets.js +53 -0
  424. package/dist/native/engine/buckets.js.map +1 -0
  425. package/dist/native/engine/capabilities.js +87 -0
  426. package/dist/native/engine/capabilities.js.map +1 -0
  427. package/dist/native/engine/cost.js +72 -0
  428. package/dist/native/engine/cost.js.map +1 -0
  429. package/dist/native/engine/days.d.ts +1 -0
  430. package/dist/native/engine/days.js +182 -0
  431. package/dist/native/engine/days.js.map +1 -0
  432. package/dist/native/engine/engine.d.ts +1 -0
  433. package/dist/native/engine/engine.js +1627 -0
  434. package/dist/native/engine/engine.js.map +1 -0
  435. package/dist/native/engine/instance.js +58 -0
  436. package/dist/native/engine/instance.js.map +1 -0
  437. package/dist/native/engine/maintenance.d.ts +1 -0
  438. package/dist/native/engine/maintenance.js +677 -0
  439. package/dist/native/engine/maintenance.js.map +1 -0
  440. package/dist/native/engine/merge.js +41 -0
  441. package/dist/native/engine/merge.js.map +1 -0
  442. package/dist/native/engine/nudge.js +26 -0
  443. package/dist/native/engine/nudge.js.map +1 -0
  444. package/dist/native/engine/planner.js +199 -0
  445. package/dist/native/engine/planner.js.map +1 -0
  446. package/dist/native/engine/rebuild.d.ts +22 -0
  447. package/dist/native/engine/rebuild.js +76 -0
  448. package/dist/native/engine/rebuild.js.map +1 -0
  449. package/dist/native/engine/recent.js +17 -0
  450. package/dist/native/engine/recent.js.map +1 -0
  451. package/dist/native/engine/salt.d.ts +1 -0
  452. package/dist/native/engine/salt.js +98 -0
  453. package/dist/native/engine/salt.js.map +1 -0
  454. package/dist/native/engine/siteHosts.d.ts +1 -0
  455. package/dist/native/engine/siteHosts.js +58 -0
  456. package/dist/native/engine/siteHosts.js.map +1 -0
  457. package/dist/native/engine/toHit.js +110 -0
  458. package/dist/native/engine/toHit.js.map +1 -0
  459. package/dist/native/engine/writeBuffer.d.ts +14 -0
  460. package/dist/native/engine/writeBuffer.js +317 -0
  461. package/dist/native/engine/writeBuffer.js.map +1 -0
  462. package/dist/native/geo/composeGeoResolvers.d.ts +1 -0
  463. package/dist/native/geo/composeGeoResolvers.js +5 -2
  464. package/dist/native/geo/composeGeoResolvers.js.map +1 -1
  465. package/dist/native/geo/geoResolver.d.ts +27 -2
  466. package/dist/native/geo/geoResolver.js +42 -6
  467. package/dist/native/geo/geoResolver.js.map +1 -1
  468. package/dist/native/geo/maxmindResolver.d.ts +8 -4
  469. package/dist/native/geo/maxmindResolver.js +20 -16
  470. package/dist/native/geo/maxmindResolver.js.map +1 -1
  471. package/dist/native/geo/resolveGeo.js +31 -0
  472. package/dist/native/geo/resolveGeo.js.map +1 -0
  473. package/dist/native/ingest/bots.d.ts +10 -0
  474. package/dist/native/ingest/bots.js +66 -0
  475. package/dist/native/ingest/bots.js.map +1 -0
  476. package/dist/native/ingest/browser.js +4 -6
  477. package/dist/native/ingest/browser.js.map +1 -1
  478. package/dist/native/ingest/clientIp.js +34 -8
  479. package/dist/native/ingest/clientIp.js.map +1 -1
  480. package/dist/native/ingest/device.js +4 -6
  481. package/dist/native/ingest/device.js.map +1 -1
  482. package/dist/native/ingest/endpoint.d.ts +1 -1
  483. package/dist/native/ingest/endpoint.js +185 -32
  484. package/dist/native/ingest/endpoint.js.map +1 -1
  485. package/dist/native/ingest/itemSignature.d.ts +26 -0
  486. package/dist/native/ingest/itemSignature.js +45 -0
  487. package/dist/native/ingest/itemSignature.js.map +1 -0
  488. package/dist/native/ingest/language.js +2 -3
  489. package/dist/native/ingest/language.js.map +1 -1
  490. package/dist/native/ingest/normalizeEvent.d.ts +70 -8
  491. package/dist/native/ingest/normalizeEvent.js +239 -60
  492. package/dist/native/ingest/normalizeEvent.js.map +1 -1
  493. package/dist/native/ingest/orderSignature.d.ts +13 -0
  494. package/dist/native/ingest/orderSignature.js +50 -0
  495. package/dist/native/ingest/orderSignature.js.map +1 -0
  496. package/dist/native/ingest/referrer.js +30 -32
  497. package/dist/native/ingest/referrer.js.map +1 -1
  498. package/dist/native/ingest/requestHost.js +44 -0
  499. package/dist/native/ingest/requestHost.js.map +1 -0
  500. package/dist/native/ingest/resolveHostname.d.ts +20 -0
  501. package/dist/native/ingest/resolveHostname.js +51 -0
  502. package/dist/native/ingest/resolveHostname.js.map +1 -0
  503. package/dist/native/ingest/revenue.d.ts +1 -0
  504. package/dist/native/ingest/revenue.js +121 -0
  505. package/dist/native/ingest/revenue.js.map +1 -0
  506. package/dist/native/ingest/route.d.ts +10 -0
  507. package/dist/native/ingest/route.js +85 -0
  508. package/dist/native/ingest/route.js.map +1 -0
  509. package/dist/native/ingest/serverTrack.d.ts +2 -10
  510. package/dist/native/ingest/serverTrack.js +188 -69
  511. package/dist/native/ingest/serverTrack.js.map +1 -1
  512. package/dist/native/ingest/signature.js +28 -0
  513. package/dist/native/ingest/signature.js.map +1 -0
  514. package/dist/native/ingest/source.d.ts +5 -2
  515. package/dist/native/ingest/source.js +163 -59
  516. package/dist/native/ingest/source.js.map +1 -1
  517. package/dist/native/ingest/utm.js +9 -9
  518. package/dist/native/ingest/utm.js.map +1 -1
  519. package/dist/native/ingest/validate.js +25 -13
  520. package/dist/native/ingest/validate.js.map +1 -1
  521. package/dist/native/ingest/visitorHash.js +6 -8
  522. package/dist/native/ingest/visitorHash.js.map +1 -1
  523. package/dist/native/nativeAdapter.d.ts +128 -9
  524. package/dist/native/nativeAdapter.js +396 -288
  525. package/dist/native/nativeAdapter.js.map +1 -1
  526. package/dist/native/rebuildDays.d.ts +12 -0
  527. package/dist/native/rebuildDays.js +16 -0
  528. package/dist/native/rebuildDays.js.map +1 -0
  529. package/dist/native/store/aggregate.js +450 -0
  530. package/dist/native/store/aggregate.js.map +1 -0
  531. package/dist/native/store/caps.d.ts +18 -0
  532. package/dist/native/store/caps.js +76 -0
  533. package/dist/native/store/caps.js.map +1 -0
  534. package/dist/native/store/chunks.js +34 -0
  535. package/dist/native/store/chunks.js.map +1 -0
  536. package/dist/native/store/columnValues.js +31 -0
  537. package/dist/native/store/columnValues.js.map +1 -0
  538. package/dist/native/store/dialect.js +106 -0
  539. package/dist/native/store/dialect.js.map +1 -0
  540. package/dist/native/store/eventStore.js +44 -0
  541. package/dist/native/store/eventStore.js.map +1 -0
  542. package/dist/native/store/hitRow.js +119 -0
  543. package/dist/native/store/hitRow.js.map +1 -0
  544. package/dist/native/store/hits.js +65 -0
  545. package/dist/native/store/hits.js.map +1 -0
  546. package/dist/native/store/ids.js +105 -0
  547. package/dist/native/store/ids.js.map +1 -0
  548. package/dist/native/store/mongo/aggregatePipelines.js +438 -0
  549. package/dist/native/store/mongo/aggregatePipelines.js.map +1 -0
  550. package/dist/native/store/mongo/mongoState.js +375 -0
  551. package/dist/native/store/mongo/mongoState.js.map +1 -0
  552. package/dist/native/store/mongo/mongoStore.js +618 -0
  553. package/dist/native/store/mongo/mongoStore.js.map +1 -0
  554. package/dist/native/store/mongo/pipelines.js +705 -0
  555. package/dist/native/store/mongo/pipelines.js.map +1 -0
  556. package/dist/native/store/mongo/results.js +20 -0
  557. package/dist/native/store/mongo/results.js.map +1 -0
  558. package/dist/native/store/parts.d.ts +1 -0
  559. package/dist/native/store/parts.js +101 -0
  560. package/dist/native/store/parts.js.map +1 -0
  561. package/dist/native/store/pattern.js +213 -0
  562. package/dist/native/store/pattern.js.map +1 -0
  563. package/dist/native/store/rawRead.d.ts +23 -0
  564. package/dist/native/store/rawRead.js +387 -0
  565. package/dist/native/store/rawRead.js.map +1 -0
  566. package/dist/native/store/reclassify.js +53 -0
  567. package/dist/native/store/reclassify.js.map +1 -0
  568. package/dist/native/store/sql/aggregateSql.js +349 -0
  569. package/dist/native/store/sql/aggregateSql.js.map +1 -0
  570. package/dist/native/store/sql/columns.js +49 -0
  571. package/dist/native/store/sql/columns.js.map +1 -0
  572. package/dist/native/store/sql/compile.js +668 -0
  573. package/dist/native/store/sql/compile.js.map +1 -0
  574. package/dist/native/store/sql/drivers.js +218 -0
  575. package/dist/native/store/sql/drivers.js.map +1 -0
  576. package/dist/native/store/sql/executor.js +132 -0
  577. package/dist/native/store/sql/executor.js.map +1 -0
  578. package/dist/native/store/sql/fragment.js +104 -0
  579. package/dist/native/store/sql/fragment.js.map +1 -0
  580. package/dist/native/store/sql/maintenanceSql.js +59 -0
  581. package/dist/native/store/sql/maintenanceSql.js.map +1 -0
  582. package/dist/native/store/sql/ownConnection.js +107 -0
  583. package/dist/native/store/sql/ownConnection.js.map +1 -0
  584. package/dist/native/store/sql/poolShare.js +101 -0
  585. package/dist/native/store/sql/poolShare.js.map +1 -0
  586. package/dist/native/store/sql/sqlState.js +325 -0
  587. package/dist/native/store/sql/sqlState.js.map +1 -0
  588. package/dist/native/store/sql/sqlStore.js +355 -0
  589. package/dist/native/store/sql/sqlStore.js.map +1 -0
  590. package/dist/native/store/sql/sqliteThread.d.ts +9 -0
  591. package/dist/native/store/sql/sqliteThread.js +314 -0
  592. package/dist/native/store/sql/sqliteThread.js.map +1 -0
  593. package/dist/native/store/sql/sqliteWorker.js +327 -0
  594. package/dist/native/store/sql/sqliteWorker.js.map +1 -0
  595. package/dist/native/store/sql/sqliteWorkerSource.js +347 -0
  596. package/dist/native/store/sql/sqliteWorkerSource.js.map +1 -0
  597. package/dist/native/store/state.js +151 -0
  598. package/dist/native/store/state.js.map +1 -0
  599. package/dist/native/store/stateStore.js +29 -0
  600. package/dist/native/store/stateStore.js.map +1 -0
  601. package/dist/native/store/types.d.ts +15 -0
  602. package/dist/native/store/types.js +10 -0
  603. package/dist/native/store/types.js.map +1 -0
  604. package/dist/native/tasks/maintainTask.d.ts +19 -0
  605. package/dist/native/tasks/maintainTask.js +57 -0
  606. package/dist/native/tasks/maintainTask.js.map +1 -0
  607. package/dist/net/guardedFetch.d.ts +32 -0
  608. package/dist/net/guardedFetch.js +220 -0
  609. package/dist/net/guardedFetch.js.map +1 -0
  610. package/dist/net/origin.js +40 -0
  611. package/dist/net/origin.js.map +1 -0
  612. package/dist/net/platform.d.ts +9 -0
  613. package/dist/net/platform.js +35 -0
  614. package/dist/net/platform.js.map +1 -0
  615. package/dist/plugin/adminDependencies.js +34 -0
  616. package/dist/plugin/adminDependencies.js.map +1 -0
  617. package/dist/plugin/apiPath.js +23 -0
  618. package/dist/plugin/apiPath.js.map +1 -0
  619. package/dist/plugin/boundDocument.js +58 -0
  620. package/dist/plugin/boundDocument.js.map +1 -0
  621. package/dist/plugin/buildPhase.js +10 -0
  622. package/dist/plugin/buildPhase.js.map +1 -0
  623. package/dist/plugin/collectionChecks.js +232 -0
  624. package/dist/plugin/collectionChecks.js.map +1 -0
  625. package/dist/plugin/collectionFields.d.ts +13 -0
  626. package/dist/plugin/collectionFields.js +22 -0
  627. package/dist/plugin/collectionFields.js.map +1 -0
  628. package/dist/plugin/createRuntime.js +346 -0
  629. package/dist/plugin/createRuntime.js.map +1 -0
  630. package/dist/plugin/destroy.js +58 -0
  631. package/dist/plugin/destroy.js.map +1 -0
  632. package/dist/plugin/documentEndpoint.js +105 -71
  633. package/dist/plugin/documentEndpoint.js.map +1 -1
  634. package/dist/plugin/documentScopes.js +37 -0
  635. package/dist/plugin/documentScopes.js.map +1 -0
  636. package/dist/plugin/encrypted.js +25 -0
  637. package/dist/plugin/encrypted.js.map +1 -0
  638. package/dist/plugin/errors.d.ts +24 -0
  639. package/dist/plugin/errors.js +86 -0
  640. package/dist/plugin/errors.js.map +1 -0
  641. package/dist/plugin/flagsEndpoint.js +41 -0
  642. package/dist/plugin/flagsEndpoint.js.map +1 -0
  643. package/dist/plugin/goalHint.js +22 -11
  644. package/dist/plugin/goalHint.js.map +1 -1
  645. package/dist/plugin/itemLabels.js +114 -0
  646. package/dist/plugin/itemLabels.js.map +1 -0
  647. package/dist/plugin/keepAlive.js +48 -0
  648. package/dist/plugin/keepAlive.js.map +1 -0
  649. package/dist/plugin/peerImportError.js +3 -6
  650. package/dist/plugin/peerImportError.js.map +1 -1
  651. package/dist/plugin/peers.js +64 -0
  652. package/dist/plugin/peers.js.map +1 -0
  653. package/dist/plugin/pluginCollections.js +161 -0
  654. package/dist/plugin/pluginCollections.js.map +1 -0
  655. package/dist/plugin/queryEndpoint.js +80 -51
  656. package/dist/plugin/queryEndpoint.js.map +1 -1
  657. package/dist/plugin/queryParams.js +7 -0
  658. package/dist/plugin/queryParams.js.map +1 -0
  659. package/dist/plugin/readContextForRequest.d.ts +11 -0
  660. package/dist/plugin/readContextForRequest.js +79 -32
  661. package/dist/plugin/readContextForRequest.js.map +1 -1
  662. package/dist/plugin/readFailure.js +22 -0
  663. package/dist/plugin/readFailure.js.map +1 -0
  664. package/dist/plugin/readableProviders.js +67 -0
  665. package/dist/plugin/readableProviders.js.map +1 -0
  666. package/dist/plugin/realtimeEndpoint.js +79 -34
  667. package/dist/plugin/realtimeEndpoint.js.map +1 -1
  668. package/dist/plugin/refreshEndpoint.js +138 -0
  669. package/dist/plugin/refreshEndpoint.js.map +1 -0
  670. package/dist/plugin/relabelFields.js +36 -0
  671. package/dist/plugin/relabelFields.js.map +1 -0
  672. package/dist/plugin/requestMemo.js +35 -0
  673. package/dist/plugin/requestMemo.js.map +1 -0
  674. package/dist/plugin/routeChecks.js +39 -0
  675. package/dist/plugin/routeChecks.js.map +1 -0
  676. package/dist/plugin/routes.d.ts +53 -0
  677. package/dist/plugin/routes.js +92 -0
  678. package/dist/plugin/routes.js.map +1 -0
  679. package/dist/plugin/runtime.d.ts +1 -1
  680. package/dist/plugin/runtime.js +235 -29
  681. package/dist/plugin/runtime.js.map +1 -1
  682. package/dist/plugin/schemaOnly.js +61 -0
  683. package/dist/plugin/schemaOnly.js.map +1 -0
  684. package/dist/plugin/scopeChange.js +23 -0
  685. package/dist/plugin/scopeChange.js.map +1 -0
  686. package/dist/plugin/scopeFieldBoot.js +4 -4
  687. package/dist/plugin/scopeFieldBoot.js.map +1 -1
  688. package/dist/plugin/scopeToken.js +33 -0
  689. package/dist/plugin/scopeToken.js.map +1 -0
  690. package/dist/plugin/sourcesEndpoint.js +50 -23
  691. package/dist/plugin/sourcesEndpoint.js.map +1 -1
  692. package/dist/plugin/unbundledLanguages.js +25 -0
  693. package/dist/plugin/unbundledLanguages.js.map +1 -0
  694. package/dist/plugin/walkFields.js +24 -0
  695. package/dist/plugin/walkFields.js.map +1 -0
  696. package/dist/plugin/warmTask.js +0 -0
  697. package/dist/plugin/warmTask.js.map +1 -1
  698. package/dist/providers/ProvidersListNotice.d.ts +11 -0
  699. package/dist/providers/ProvidersListNotice.js +36 -0
  700. package/dist/providers/ProvidersListNotice.js.map +1 -0
  701. package/dist/providers/access.d.ts +1 -0
  702. package/dist/providers/access.js +35 -26
  703. package/dist/providers/access.js.map +1 -1
  704. package/dist/providers/adapterPool.js +121 -0
  705. package/dist/providers/adapterPool.js.map +1 -0
  706. package/dist/providers/collection.d.ts +63 -0
  707. package/dist/providers/collection.js +369 -150
  708. package/dist/providers/collection.js.map +1 -1
  709. package/dist/providers/factory.d.ts +84 -0
  710. package/dist/providers/factory.js +84 -25
  711. package/dist/providers/factory.js.map +1 -1
  712. package/dist/providers/hosts.d.ts +25 -0
  713. package/dist/providers/hosts.js +128 -0
  714. package/dist/providers/hosts.js.map +1 -0
  715. package/dist/providers/probe.d.ts +1 -0
  716. package/dist/providers/probe.js +105 -0
  717. package/dist/providers/probe.js.map +1 -0
  718. package/dist/providers/refresh.d.ts +18 -0
  719. package/dist/providers/refresh.js +49 -0
  720. package/dist/providers/refresh.js.map +1 -0
  721. package/dist/providers/registry.js +329 -0
  722. package/dist/providers/registry.js.map +1 -0
  723. package/dist/providers/resolver.js +26 -88
  724. package/dist/providers/resolver.js.map +1 -1
  725. package/dist/providers/retarget.js +45 -0
  726. package/dist/providers/retarget.js.map +1 -0
  727. package/dist/providers/scopeUnique.js +41 -0
  728. package/dist/providers/scopeUnique.js.map +1 -0
  729. package/dist/providers/secrets.d.ts +26 -0
  730. package/dist/providers/secrets.js +61 -4
  731. package/dist/providers/secrets.js.map +1 -1
  732. package/dist/providers/stampScope.js +9 -6
  733. package/dist/providers/stampScope.js.map +1 -1
  734. package/dist/query/dates.js +10 -12
  735. package/dist/query/dates.js.map +1 -1
  736. package/dist/query/errors.d.ts +6 -13
  737. package/dist/query/fetchQuery.d.ts +36 -23
  738. package/dist/query/fetchQuery.js +96 -89
  739. package/dist/query/fetchQuery.js.map +1 -1
  740. package/dist/query/limits.js +8 -0
  741. package/dist/query/limits.js.map +1 -0
  742. package/dist/query/parse.d.ts +8 -2
  743. package/dist/query/parse.js +155 -108
  744. package/dist/query/parse.js.map +1 -1
  745. package/dist/query/response.d.ts +23 -3
  746. package/dist/query/response.js +12 -5
  747. package/dist/query/response.js.map +1 -1
  748. package/dist/react/AnalyticsProvider.d.ts +42 -20
  749. package/dist/react/AnalyticsProvider.js +24 -22
  750. package/dist/react/AnalyticsProvider.js.map +1 -1
  751. package/dist/react/TrackerBoot.js +15 -9
  752. package/dist/react/TrackerBoot.js.map +1 -1
  753. package/dist/react/useAnalytics.d.ts +2 -8
  754. package/dist/react/useAnalytics.js +31 -13
  755. package/dist/react/useAnalytics.js.map +1 -1
  756. package/dist/routes/captureRoute.d.ts +28 -0
  757. package/dist/routes/captureRoute.js +67 -0
  758. package/dist/routes/captureRoute.js.map +1 -0
  759. package/dist/routes/ingestRoute.d.ts +17 -0
  760. package/dist/routes/ingestRoute.js +17 -0
  761. package/dist/routes/ingestRoute.js.map +1 -0
  762. package/dist/site/AnalyticsScripts.d.ts +35 -0
  763. package/dist/site/AnalyticsScripts.js +44 -0
  764. package/dist/site/AnalyticsScripts.js.map +1 -0
  765. package/dist/site/getTrackerConfig.d.ts +15 -0
  766. package/dist/site/getTrackerConfig.js +43 -0
  767. package/dist/site/getTrackerConfig.js.map +1 -0
  768. package/dist/surfacing/afterRead.d.ts +37 -0
  769. package/dist/surfacing/bounded.js +38 -0
  770. package/dist/surfacing/bounded.js.map +1 -0
  771. package/dist/surfacing/breaker.js +107 -0
  772. package/dist/surfacing/breaker.js.map +1 -0
  773. package/dist/surfacing/cacheCollection.d.ts +8 -0
  774. package/dist/surfacing/cacheCollection.js +71 -0
  775. package/dist/surfacing/cacheCollection.js.map +1 -0
  776. package/dist/surfacing/cacheStore.d.ts +71 -1
  777. package/dist/surfacing/cacheStore.js +16 -37
  778. package/dist/surfacing/cacheStore.js.map +1 -1
  779. package/dist/surfacing/cacheSweep.d.ts +1 -0
  780. package/dist/surfacing/cacheSweep.js +59 -0
  781. package/dist/surfacing/cacheSweep.js.map +1 -0
  782. package/dist/surfacing/classifyError.js +282 -0
  783. package/dist/surfacing/classifyError.js.map +1 -0
  784. package/dist/surfacing/coalesce.js +2 -1
  785. package/dist/surfacing/coalesce.js.map +1 -1
  786. package/dist/surfacing/coldBudget.js +60 -0
  787. package/dist/surfacing/coldBudget.js.map +1 -0
  788. package/dist/surfacing/collectionCacheStore.js +183 -0
  789. package/dist/surfacing/collectionCacheStore.js.map +1 -0
  790. package/dist/surfacing/engine.d.ts +1 -1
  791. package/dist/surfacing/engine.js +514 -71
  792. package/dist/surfacing/engine.js.map +1 -1
  793. package/dist/surfacing/epoch.d.ts +1 -0
  794. package/dist/surfacing/epoch.js +116 -0
  795. package/dist/surfacing/epoch.js.map +1 -0
  796. package/dist/surfacing/lanes.d.ts +1 -0
  797. package/dist/surfacing/lanes.js +297 -0
  798. package/dist/surfacing/lanes.js.map +1 -0
  799. package/dist/surfacing/memo.js +40 -0
  800. package/dist/surfacing/memo.js.map +1 -0
  801. package/dist/surfacing/rateLimiter.d.ts +1 -0
  802. package/dist/surfacing/rateLimiter.js +69 -94
  803. package/dist/surfacing/rateLimiter.js.map +1 -1
  804. package/dist/surfacing/rebucket.js +178 -0
  805. package/dist/surfacing/rebucket.js.map +1 -0
  806. package/dist/surfacing/recipe.js +28 -0
  807. package/dist/surfacing/recipe.js.map +1 -0
  808. package/dist/surfacing/shape.js +22 -0
  809. package/dist/surfacing/shape.js.map +1 -0
  810. package/dist/surfacing/todaySplit.js +119 -0
  811. package/dist/surfacing/todaySplit.js.map +1 -0
  812. package/dist/sync/collection.d.ts +8 -0
  813. package/dist/sync/collection.js +30 -18
  814. package/dist/sync/collection.js.map +1 -1
  815. package/dist/sync/rekeyDurations.js +70 -0
  816. package/dist/sync/rekeyDurations.js.map +1 -0
  817. package/dist/sync/syncTask.js +222 -109
  818. package/dist/sync/syncTask.js.map +1 -1
  819. package/dist/testing/memoryAdapter.d.ts +6 -3
  820. package/dist/testing/memoryAdapter.js +12 -10
  821. package/dist/testing/memoryAdapter.js.map +1 -1
  822. package/dist/testing/settle.d.ts +11 -0
  823. package/dist/testing/settle.js +19 -0
  824. package/dist/testing/settle.js.map +1 -0
  825. package/dist/timeframe/calendar.js +65 -0
  826. package/dist/timeframe/calendar.js.map +1 -0
  827. package/dist/timeframe/comparison.js +46 -0
  828. package/dist/timeframe/comparison.js.map +1 -0
  829. package/dist/timeframe/presets.d.ts +1 -1
  830. package/dist/timeframe/presets.js +5 -5
  831. package/dist/timeframe/presets.js.map +1 -1
  832. package/dist/timeframe/reportingTimezone.d.ts +1 -0
  833. package/dist/timeframe/reportingTimezone.js +64 -0
  834. package/dist/timeframe/reportingTimezone.js.map +1 -0
  835. package/dist/timeframe/tz.js +55 -39
  836. package/dist/timeframe/tz.js.map +1 -1
  837. package/dist/tracker/autoCapture.js +125 -38
  838. package/dist/tracker/autoCapture.js.map +1 -1
  839. package/dist/tracker/campaign.js +52 -0
  840. package/dist/tracker/campaign.js.map +1 -0
  841. package/dist/tracker/config.d.ts +174 -0
  842. package/dist/tracker/config.js +25 -0
  843. package/dist/tracker/config.js.map +1 -0
  844. package/dist/tracker/createTracker.d.ts +5 -10
  845. package/dist/tracker/createTracker.js +434 -91
  846. package/dist/tracker/createTracker.js.map +1 -1
  847. package/dist/tracker/digest.js +28 -0
  848. package/dist/tracker/digest.js.map +1 -0
  849. package/dist/tracker/engagement.js +100 -0
  850. package/dist/tracker/engagement.js.map +1 -0
  851. package/dist/tracker/events.js +37 -0
  852. package/dist/tracker/events.js.map +1 -0
  853. package/dist/tracker/exclusion.d.ts +8 -0
  854. package/dist/tracker/exclusion.js +82 -0
  855. package/dist/tracker/exclusion.js.map +1 -0
  856. package/dist/tracker/gate.d.ts +8 -0
  857. package/dist/tracker/gate.js +244 -0
  858. package/dist/tracker/gate.js.map +1 -0
  859. package/dist/tracker/initTracker.d.ts +5 -8
  860. package/dist/tracker/initTracker.js +42 -14
  861. package/dist/tracker/initTracker.js.map +1 -1
  862. package/dist/tracker/itemCapture.js +224 -0
  863. package/dist/tracker/itemCapture.js.map +1 -0
  864. package/dist/tracker/loadScript.js +23 -15
  865. package/dist/tracker/loadScript.js.map +1 -1
  866. package/dist/tracker/pageTracking.js +6 -6
  867. package/dist/tracker/pageTracking.js.map +1 -1
  868. package/dist/tracker/registry.js +129 -30
  869. package/dist/tracker/registry.js.map +1 -1
  870. package/dist/tracker/sinks/createSink.js +60 -0
  871. package/dist/tracker/sinks/createSink.js.map +1 -0
  872. package/dist/tracker/sinks/ga4.js +97 -17
  873. package/dist/tracker/sinks/ga4.js.map +1 -1
  874. package/dist/tracker/sinks/native.js +21 -42
  875. package/dist/tracker/sinks/native.js.map +1 -1
  876. package/dist/tracker/sinks/plausible.js +36 -18
  877. package/dist/tracker/sinks/plausible.js.map +1 -1
  878. package/dist/tracker/sinks/posthog.js +145 -9
  879. package/dist/tracker/sinks/posthog.js.map +1 -1
  880. package/dist/tracker/sinks/umami.js +18 -10
  881. package/dist/tracker/sinks/umami.js.map +1 -1
  882. package/dist/tracker/sinks/vendor.js +54 -22
  883. package/dist/tracker/sinks/vendor.js.map +1 -1
  884. package/dist/tracker/skip.js +81 -0
  885. package/dist/tracker/skip.js.map +1 -0
  886. package/dist/tracker/storage.js +23 -0
  887. package/dist/tracker/storage.js.map +1 -0
  888. package/dist/tracker/transport.js +2 -5
  889. package/dist/tracker/transport.js.map +1 -1
  890. package/dist/tracker/types.d.ts +99 -49
  891. package/dist/tracker/window.js +7 -0
  892. package/dist/tracker/window.js.map +1 -0
  893. package/dist/translations/ar.js +255 -74
  894. package/dist/translations/ar.js.map +1 -1
  895. package/dist/translations/de.js +243 -71
  896. package/dist/translations/de.js.map +1 -1
  897. package/dist/translations/en.js +238 -70
  898. package/dist/translations/en.js.map +1 -1
  899. package/dist/translations/es.js +246 -71
  900. package/dist/translations/es.js.map +1 -1
  901. package/dist/translations/fr.js +250 -75
  902. package/dist/translations/fr.js.map +1 -1
  903. package/dist/translations/id.js +241 -70
  904. package/dist/translations/id.js.map +1 -1
  905. package/dist/translations/index.d.ts +1 -1
  906. package/dist/translations/index.js +5 -7
  907. package/dist/translations/index.js.map +1 -1
  908. package/dist/translations/intl.js +71 -0
  909. package/dist/translations/intl.js.map +1 -0
  910. package/dist/translations/keys.d.ts +214 -17
  911. package/dist/translations/keys.js +219 -17
  912. package/dist/translations/keys.js.map +1 -1
  913. package/dist/translations/ko.js +243 -72
  914. package/dist/translations/ko.js.map +1 -1
  915. package/dist/translations/labelMap.d.ts +10 -0
  916. package/dist/translations/labelMap.js +22 -0
  917. package/dist/translations/labelMap.js.map +1 -0
  918. package/dist/translations/metricKeys.js +10 -2
  919. package/dist/translations/metricKeys.js.map +1 -1
  920. package/dist/translations/parts.js +20 -0
  921. package/dist/translations/parts.js.map +1 -0
  922. package/dist/translations/plural.js +61 -0
  923. package/dist/translations/plural.js.map +1 -0
  924. package/dist/translations/pt.js +255 -80
  925. package/dist/translations/pt.js.map +1 -1
  926. package/dist/translations/ru.js +246 -69
  927. package/dist/translations/ru.js.map +1 -1
  928. package/dist/translations/server.d.ts +1 -0
  929. package/dist/translations/server.js +2 -3
  930. package/dist/translations/server.js.map +1 -1
  931. package/dist/translations/staticLabel.js +69 -0
  932. package/dist/translations/staticLabel.js.map +1 -0
  933. package/dist/translations/uk.js +246 -69
  934. package/dist/translations/uk.js.map +1 -1
  935. package/dist/translations/zh.js +241 -70
  936. package/dist/translations/zh.js.map +1 -1
  937. package/dist/ui/RangePicker.js +110 -0
  938. package/dist/ui/RangePicker.js.map +1 -0
  939. package/dist/ui/analytics.css +1667 -0
  940. package/dist/ui/calendarDays.js +27 -0
  941. package/dist/ui/calendarDays.js.map +1 -0
  942. package/dist/ui/classNames.js +7 -0
  943. package/dist/ui/classNames.js.map +1 -0
  944. package/dist/ui/components/Card.d.ts +28 -0
  945. package/dist/ui/components/Card.js +21 -0
  946. package/dist/ui/components/Card.js.map +1 -0
  947. package/dist/ui/components/ChartDataTable.d.ts +41 -0
  948. package/dist/ui/components/ChartDataTable.js +48 -0
  949. package/dist/ui/components/ChartDataTable.js.map +1 -0
  950. package/dist/ui/components/ChoiceMenu.js +48 -0
  951. package/dist/ui/components/ChoiceMenu.js.map +1 -0
  952. package/dist/ui/components/DataTable.d.ts +82 -0
  953. package/dist/ui/components/DataTable.js +214 -0
  954. package/dist/ui/components/DataTable.js.map +1 -0
  955. package/dist/ui/components/LabeledSelect.js +62 -0
  956. package/dist/ui/components/LabeledSelect.js.map +1 -0
  957. package/dist/ui/components/LiveAnnouncement.js +21 -0
  958. package/dist/ui/components/LiveAnnouncement.js.map +1 -0
  959. package/dist/ui/components/MetricCard.d.ts +38 -0
  960. package/dist/ui/components/MetricCard.js +39 -0
  961. package/dist/ui/components/MetricCard.js.map +1 -0
  962. package/dist/ui/components/NoValue.js +22 -0
  963. package/dist/ui/components/NoValue.js.map +1 -0
  964. package/dist/ui/components/ReadState.js +27 -0
  965. package/dist/ui/components/ReadState.js.map +1 -0
  966. package/dist/ui/components/RefreshButton.js +25 -0
  967. package/dist/ui/components/RefreshButton.js.map +1 -0
  968. package/dist/ui/components/SourcesNoticeBanner.js +20 -0
  969. package/dist/ui/components/SourcesNoticeBanner.js.map +1 -0
  970. package/dist/ui/cssVars.js +7 -0
  971. package/dist/ui/cssVars.js.map +1 -0
  972. package/dist/ui/data/WithScopeToken.d.ts +20 -0
  973. package/dist/ui/data/WithScopeToken.js +20 -0
  974. package/dist/ui/data/WithScopeToken.js.map +1 -0
  975. package/dist/ui/data/clientFieldProps.js +16 -0
  976. package/dist/ui/data/clientFieldProps.js.map +1 -0
  977. package/dist/ui/data/request.d.ts +46 -0
  978. package/dist/ui/data/request.js +119 -0
  979. package/dist/ui/data/request.js.map +1 -0
  980. package/dist/ui/data/scopeTokenContext.js +18 -0
  981. package/dist/ui/data/scopeTokenContext.js.map +1 -0
  982. package/dist/ui/data/sharedCache.js +48 -0
  983. package/dist/ui/data/sharedCache.js.map +1 -0
  984. package/dist/ui/data/useRequest.d.ts +19 -0
  985. package/dist/ui/data/useRequest.js +123 -0
  986. package/dist/ui/data/useRequest.js.map +1 -0
  987. package/dist/ui/data/useRequestScope.js +25 -0
  988. package/dist/ui/data/useRequestScope.js.map +1 -0
  989. package/dist/ui/hooks/useDirection.js +47 -0
  990. package/dist/ui/hooks/useDirection.js.map +1 -0
  991. package/dist/ui/hooks/useDismissOnEscape.js +25 -0
  992. package/dist/ui/hooks/useDismissOnEscape.js.map +1 -0
  993. package/dist/ui/hooks/useLiveAnnouncement.js +57 -0
  994. package/dist/ui/hooks/useLiveAnnouncement.js.map +1 -0
  995. package/dist/ui/hooks/useRealtimePoll.js +112 -0
  996. package/dist/ui/hooks/useRealtimePoll.js.map +1 -0
  997. package/dist/ui/readState.js +19 -0
  998. package/dist/ui/readState.js.map +1 -0
  999. package/dist/ui/rows/toDisplayRows.js +49 -0
  1000. package/dist/ui/rows/toDisplayRows.js.map +1 -0
  1001. package/dist/ui/viewerClock.js +7 -0
  1002. package/dist/ui/viewerClock.js.map +1 -0
  1003. package/dist/view/AnalyticsNavLink.d.ts +5 -3
  1004. package/dist/view/AnalyticsNavLink.js +12 -8
  1005. package/dist/view/AnalyticsNavLink.js.map +1 -1
  1006. package/dist/view/AnalyticsView.d.ts +9 -10
  1007. package/dist/view/AnalyticsView.js +47 -19
  1008. package/dist/view/AnalyticsView.js.map +1 -1
  1009. package/dist/view/AnalyticsViewClient.d.ts +4 -7
  1010. package/dist/view/AnalyticsViewClient.js +15 -185
  1011. package/dist/view/AnalyticsViewClient.js.map +1 -1
  1012. package/dist/view/CountryFlag.d.ts +27 -0
  1013. package/dist/view/CountryFlag.js +44 -0
  1014. package/dist/view/CountryFlag.js.map +1 -0
  1015. package/dist/view/DocumentTitle.js +27 -0
  1016. package/dist/view/DocumentTitle.js.map +1 -0
  1017. package/dist/view/ViewRoot.d.ts +21 -0
  1018. package/dist/view/ViewRoot.js +155 -0
  1019. package/dist/view/ViewRoot.js.map +1 -0
  1020. package/dist/view/ViewSections.d.ts +38 -0
  1021. package/dist/view/ViewSections.js +190 -0
  1022. package/dist/view/ViewSections.js.map +1 -0
  1023. package/dist/view/authRedirect.js +2 -4
  1024. package/dist/view/authRedirect.js.map +1 -1
  1025. package/dist/view/consentShare.js +15 -0
  1026. package/dist/view/consentShare.js.map +1 -0
  1027. package/dist/view/conversionRate.js +9 -7
  1028. package/dist/view/conversionRate.js.map +1 -1
  1029. package/dist/view/dayRange.js +6 -10
  1030. package/dist/view/dayRange.js.map +1 -1
  1031. package/dist/view/exclusionLink.d.ts +27 -0
  1032. package/dist/view/exclusionLink.js +46 -0
  1033. package/dist/view/exclusionLink.js.map +1 -0
  1034. package/dist/view/flagSrc.js +14 -0
  1035. package/dist/view/flagSrc.js.map +1 -0
  1036. package/dist/view/gating.d.ts +15 -1
  1037. package/dist/view/gating.js +67 -32
  1038. package/dist/view/gating.js.map +1 -1
  1039. package/dist/view/hostCountryFlag.js +41 -0
  1040. package/dist/view/hostCountryFlag.js.map +1 -0
  1041. package/dist/view/labels.js +113 -16
  1042. package/dist/view/labels.js.map +1 -1
  1043. package/dist/view/metricAliases.js +10 -0
  1044. package/dist/view/metricAliases.js.map +1 -0
  1045. package/dist/view/navLabel.js +15 -0
  1046. package/dist/view/navLabel.js.map +1 -0
  1047. package/dist/view/registerView.js +13 -11
  1048. package/dist/view/registerView.js.map +1 -1
  1049. package/dist/view/scopeLabel.js +21 -0
  1050. package/dist/view/scopeLabel.js.map +1 -0
  1051. package/dist/view/sections/Breakdowns.js +195 -132
  1052. package/dist/view/sections/Breakdowns.js.map +1 -1
  1053. package/dist/view/sections/EmptyStates.js +120 -32
  1054. package/dist/view/sections/EmptyStates.js.map +1 -1
  1055. package/dist/view/sections/ExcludeBrowser.js +188 -0
  1056. package/dist/view/sections/ExcludeBrowser.js.map +1 -0
  1057. package/dist/view/sections/FilterChips.js +127 -27
  1058. package/dist/view/sections/FilterChips.js.map +1 -1
  1059. package/dist/view/sections/GoalsPanel.js +68 -60
  1060. package/dist/view/sections/GoalsPanel.js.map +1 -1
  1061. package/dist/view/sections/OverviewCards.js +42 -36
  1062. package/dist/view/sections/OverviewCards.js.map +1 -1
  1063. package/dist/view/sections/RealtimeStrip.js +70 -59
  1064. package/dist/view/sections/RealtimeStrip.js.map +1 -1
  1065. package/dist/view/sections/SectionBoundary.js +34 -0
  1066. package/dist/view/sections/SectionBoundary.js.map +1 -0
  1067. package/dist/view/sections/Toolbar.d.ts +11 -0
  1068. package/dist/view/sections/Toolbar.js +181 -122
  1069. package/dist/view/sections/Toolbar.js.map +1 -1
  1070. package/dist/view/sections/Trend.js +176 -76
  1071. package/dist/view/sections/Trend.js.map +1 -1
  1072. package/dist/view/state.d.ts +42 -0
  1073. package/dist/view/state.js +93 -54
  1074. package/dist/view/state.js.map +1 -1
  1075. package/dist/view/useViewClock.js +31 -0
  1076. package/dist/view/useViewClock.js.map +1 -0
  1077. package/dist/view/useViewQueries.d.ts +21 -0
  1078. package/dist/view/useViewQueries.js +45 -77
  1079. package/dist/view/useViewQueries.js.map +1 -1
  1080. package/dist/view/useViewState.js +42 -0
  1081. package/dist/view/useViewState.js.map +1 -0
  1082. package/dist/view/useViewUrl.js +52 -0
  1083. package/dist/view/useViewUrl.js.map +1 -0
  1084. package/dist/view/viewBody.js +30 -0
  1085. package/dist/view/viewBody.js.map +1 -0
  1086. package/dist/view/viewContext.d.ts +81 -0
  1087. package/dist/view/viewContext.js +49 -0
  1088. package/dist/view/viewContext.js.map +1 -0
  1089. package/dist/view/viewProps.d.ts +65 -8
  1090. package/dist/view/viewProps.js +123 -36
  1091. package/dist/view/viewProps.js.map +1 -1
  1092. package/dist/widgets/AnalyticsBreakdownWidget.d.ts +7 -3
  1093. package/dist/widgets/AnalyticsBreakdownWidget.js +144 -118
  1094. package/dist/widgets/AnalyticsBreakdownWidget.js.map +1 -1
  1095. package/dist/widgets/AnalyticsGoalsWidget.d.ts +6 -7
  1096. package/dist/widgets/AnalyticsGoalsWidget.js +126 -167
  1097. package/dist/widgets/AnalyticsGoalsWidget.js.map +1 -1
  1098. package/dist/widgets/AnalyticsMetricWidget.d.ts +7 -3
  1099. package/dist/widgets/AnalyticsMetricWidget.js +81 -106
  1100. package/dist/widgets/AnalyticsMetricWidget.js.map +1 -1
  1101. package/dist/widgets/AnalyticsRealtimeWidget.d.ts +7 -3
  1102. package/dist/widgets/AnalyticsRealtimeWidget.js +81 -63
  1103. package/dist/widgets/AnalyticsRealtimeWidget.js.map +1 -1
  1104. package/dist/widgets/AnalyticsTrendWidget.d.ts +7 -3
  1105. package/dist/widgets/AnalyticsTrendWidget.js +130 -123
  1106. package/dist/widgets/AnalyticsTrendWidget.js.map +1 -1
  1107. package/dist/widgets/ComparisonDelta.js +33 -42
  1108. package/dist/widgets/ComparisonDelta.js.map +1 -1
  1109. package/dist/widgets/RealtimeCounter.d.ts +24 -4
  1110. package/dist/widgets/RealtimeCounter.js +90 -71
  1111. package/dist/widgets/RealtimeCounter.js.map +1 -1
  1112. package/dist/widgets/WidgetCard.d.ts +80 -0
  1113. package/dist/widgets/WidgetCard.js +99 -0
  1114. package/dist/widgets/WidgetCard.js.map +1 -0
  1115. package/dist/widgets/WidgetFrame.js +42 -0
  1116. package/dist/widgets/WidgetFrame.js.map +1 -0
  1117. package/dist/widgets/WidgetShimmer.d.ts +55 -0
  1118. package/dist/widgets/WidgetShimmer.js +86 -0
  1119. package/dist/widgets/WidgetShimmer.js.map +1 -0
  1120. package/dist/widgets/breakdownTypes.js +18 -2
  1121. package/dist/widgets/breakdownTypes.js.map +1 -1
  1122. package/dist/widgets/customWidget.d.ts +5 -1
  1123. package/dist/widgets/customWidget.js +6 -7
  1124. package/dist/widgets/customWidget.js.map +1 -1
  1125. package/dist/widgets/defaultLayout.d.ts +26 -0
  1126. package/dist/widgets/defaultLayout.js +51 -0
  1127. package/dist/widgets/defaultLayout.js.map +1 -0
  1128. package/dist/widgets/defaults.d.ts +4 -7
  1129. package/dist/widgets/defaults.js +12 -7
  1130. package/dist/widgets/defaults.js.map +1 -1
  1131. package/dist/widgets/fieldRows.js +14 -0
  1132. package/dist/widgets/fieldRows.js.map +1 -0
  1133. package/dist/widgets/filterCaption.js +6 -7
  1134. package/dist/widgets/filterCaption.js.map +1 -1
  1135. package/dist/widgets/filterField.d.ts +3 -7
  1136. package/dist/widgets/filterField.js +46 -35
  1137. package/dist/widgets/filterField.js.map +1 -1
  1138. package/dist/widgets/filterValueLabel.d.ts +1 -0
  1139. package/dist/widgets/filterValueLabel.js +45 -0
  1140. package/dist/widgets/filterValueLabel.js.map +1 -0
  1141. package/dist/widgets/notices.js +79 -0
  1142. package/dist/widgets/notices.js.map +1 -0
  1143. package/dist/widgets/prepareWidgetRead.d.ts +19 -2
  1144. package/dist/widgets/prepareWidgetRead.js +63 -27
  1145. package/dist/widgets/prepareWidgetRead.js.map +1 -1
  1146. package/dist/widgets/range.js +26 -21
  1147. package/dist/widgets/range.js.map +1 -1
  1148. package/dist/widgets/readForWidget.d.ts +28 -19
  1149. package/dist/widgets/readForWidget.js +33 -29
  1150. package/dist/widgets/readForWidget.js.map +1 -1
  1151. package/dist/widgets/readForWidgetBreakdown.d.ts +40 -29
  1152. package/dist/widgets/readForWidgetBreakdown.js +48 -22
  1153. package/dist/widgets/readForWidgetBreakdown.js.map +1 -1
  1154. package/dist/widgets/readForWidgetGoals.d.ts +18 -24
  1155. package/dist/widgets/readForWidgetGoals.js +52 -46
  1156. package/dist/widgets/readForWidgetGoals.js.map +1 -1
  1157. package/dist/widgets/readForWidgetRealtime.d.ts +22 -17
  1158. package/dist/widgets/readForWidgetRealtime.js +54 -27
  1159. package/dist/widgets/readForWidgetRealtime.js.map +1 -1
  1160. package/dist/widgets/readForWidgetSeries.d.ts +27 -32
  1161. package/dist/widgets/readForWidgetSeries.js +45 -82
  1162. package/dist/widgets/readForWidgetSeries.js.map +1 -1
  1163. package/dist/widgets/readMeta.d.ts +48 -0
  1164. package/dist/widgets/readMeta.js +52 -4
  1165. package/dist/widgets/readMeta.js.map +1 -1
  1166. package/dist/widgets/realtimePoll.d.ts +1 -0
  1167. package/dist/widgets/realtimePoll.js +56 -16
  1168. package/dist/widgets/realtimePoll.js.map +1 -1
  1169. package/dist/widgets/registerWidgets.js +207 -127
  1170. package/dist/widgets/registerWidgets.js.map +1 -1
  1171. package/dist/widgets/stateKeys.js +30 -0
  1172. package/dist/widgets/stateKeys.js.map +1 -0
  1173. package/dist/widgets/titleForecast.js +89 -0
  1174. package/dist/widgets/titleForecast.js.map +1 -0
  1175. package/dist/widgets/types.d.ts +4 -3
  1176. package/dist/widgets/types.js +2 -0
  1177. package/dist/widgets/types.js.map +1 -1
  1178. package/dist/widgets/viewLink.d.ts +24 -6
  1179. package/dist/widgets/viewLink.js +31 -24
  1180. package/dist/widgets/viewLink.js.map +1 -1
  1181. package/dist/widgets/widgetData.js +34 -0
  1182. package/dist/widgets/widgetData.js.map +1 -0
  1183. package/dist/widgets/widgetWindow.d.ts +1 -0
  1184. package/dist/widgets/widgetWindow.js +51 -0
  1185. package/dist/widgets/widgetWindow.js.map +1 -0
  1186. package/package.json +61 -42
  1187. package/dist/capture/getTrackerConfig.d.ts +0 -20
  1188. package/dist/capture/getTrackerConfig.js +0 -31
  1189. package/dist/capture/getTrackerConfig.js.map +0 -1
  1190. package/dist/capture/slots.d.ts +0 -8
  1191. package/dist/capture/trackerConfig.d.ts +0 -33
  1192. package/dist/charts/styles.js +0 -59
  1193. package/dist/charts/styles.js.map +0 -1
  1194. package/dist/exports/next.d.ts +0 -3
  1195. package/dist/exports/next.js +0 -3
  1196. package/dist/fields/config/SourceSelectField.d.ts +0 -14
  1197. package/dist/fields/dateRange/styles.js +0 -23
  1198. package/dist/fields/dateRange/styles.js.map +0 -1
  1199. package/dist/goals/GoalSelectField.d.ts +0 -7
  1200. package/dist/native/collections/events.js +0 -157
  1201. package/dist/native/collections/events.js.map +0 -1
  1202. package/dist/native/collections/rollups.js +0 -151
  1203. package/dist/native/collections/rollups.js.map +0 -1
  1204. package/dist/native/collections/seen.js +0 -47
  1205. package/dist/native/collections/seen.js.map +0 -1
  1206. package/dist/native/eventScan.js +0 -25
  1207. package/dist/native/eventScan.js.map +0 -1
  1208. package/dist/native/ingest/flushBatch.js +0 -60
  1209. package/dist/native/ingest/flushBatch.js.map +0 -1
  1210. package/dist/native/ingest/salt.js +0 -14
  1211. package/dist/native/ingest/salt.js.map +0 -1
  1212. package/dist/native/ingest/writeBuffer.js +0 -55
  1213. package/dist/native/ingest/writeBuffer.js.map +0 -1
  1214. package/dist/native/ingest/writeEvent.js +0 -14
  1215. package/dist/native/ingest/writeEvent.js.map +0 -1
  1216. package/dist/native/query/eventAgg.js +0 -174
  1217. package/dist/native/query/eventAgg.js.map +0 -1
  1218. package/dist/native/realtime/buildRealtime.js +0 -53
  1219. package/dist/native/realtime/buildRealtime.js.map +0 -1
  1220. package/dist/native/retention/pruneTask.js +0 -29
  1221. package/dist/native/retention/pruneTask.js.map +0 -1
  1222. package/dist/native/rollupAcc.js +0 -64
  1223. package/dist/native/rollupAcc.js.map +0 -1
  1224. package/dist/native/rollups/bucketKey.js +0 -15
  1225. package/dist/native/rollups/bucketKey.js.map +0 -1
  1226. package/dist/native/rollups/bumpRollups.js +0 -116
  1227. package/dist/native/rollups/bumpRollups.js.map +0 -1
  1228. package/dist/native/rollups/deltas.js +0 -105
  1229. package/dist/native/rollups/deltas.js.map +0 -1
  1230. package/dist/native/rollups/insertManyIfNew.js +0 -93
  1231. package/dist/native/rollups/insertManyIfNew.js.map +0 -1
  1232. package/dist/next/captureRewrites.d.ts +0 -42
  1233. package/dist/next/captureRewrites.js +0 -57
  1234. package/dist/next/captureRewrites.js.map +0 -1
  1235. package/dist/next/posthogProxyRewrites.d.ts +0 -41
  1236. package/dist/next/posthogProxyRewrites.js +0 -45
  1237. package/dist/next/posthogProxyRewrites.js.map +0 -1
  1238. package/dist/plugin/paths.js +0 -27
  1239. package/dist/plugin/paths.js.map +0 -1
  1240. package/dist/plugin/responses.js +0 -17
  1241. package/dist/plugin/responses.js.map +0 -1
  1242. package/dist/query/errors.js +0 -10
  1243. package/dist/query/errors.js.map +0 -1
  1244. package/dist/react/TrackerBoot.d.ts +0 -22
  1245. package/dist/rsc/AnalyticsScripts.d.ts +0 -30
  1246. package/dist/rsc/AnalyticsScripts.js +0 -41
  1247. package/dist/rsc/AnalyticsScripts.js.map +0 -1
  1248. package/dist/surfacing/queue.js +0 -60
  1249. package/dist/surfacing/queue.js.map +0 -1
  1250. package/dist/surfacing/retryPolicy.js +0 -15
  1251. package/dist/surfacing/retryPolicy.js.map +0 -1
  1252. package/dist/tracker/autoCapture.d.ts +0 -48
  1253. package/dist/tracker/consent.d.ts +0 -24
  1254. package/dist/tracker/consent.js +0 -48
  1255. package/dist/tracker/consent.js.map +0 -1
  1256. package/dist/tracker/loadScript.d.ts +0 -14
  1257. package/dist/tracker/pageTracking.d.ts +0 -17
  1258. package/dist/tracker/registry.d.ts +0 -27
  1259. package/dist/tracker/sinks/ga4.d.ts +0 -21
  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 -57
  1273. package/dist/widgets/comparison.js.map +0 -1
@@ -0,0 +1 @@
1
+ {"version":3,"file":"calendar.js","names":[],"sources":["../../src/timeframe/calendar.ts"],"sourcesContent":["import {\n\ttype CalendarDate,\n\tDAY_MS,\n\tDEFAULT_TIMEZONE,\n\tformatYmd,\n\tstartOfCalendarDayInTz,\n\tzonedDate,\n} from './tz'\n\n/**\n * A calendar date as `yyyymmdd` (20261005). Day arithmetic runs on dates, not instants, so DST\n * never skips or repeats a day; a zone matters only when a day becomes an instant.\n */\nexport type CalendarDay = number\n\nexport const toCalendarDay = ({ year, month, day }: CalendarDate): CalendarDay =>\n\tyear * 10_000 + month * 100 + day\n\nexport const calendarDate = (day: CalendarDay): CalendarDate => ({\n\tyear: Math.floor(day / 10_000),\n\tmonth: Math.floor(day / 100) % 100,\n\tday: day % 100,\n})\n\n/** Midnight UTC of the date, which is only ever used to step and compare dates. */\nconst utcMidnight = (day: CalendarDay): number => {\n\tconst { year, month, day: date } = calendarDate(day)\n\treturn Date.UTC(year, month - 1, date)\n}\n\nconst fromUtcMidnight = (ms: number): CalendarDay => {\n\tconst at = new Date(ms)\n\treturn toCalendarDay({\n\t\tyear: at.getUTCFullYear(),\n\t\tmonth: at.getUTCMonth() + 1,\n\t\tday: at.getUTCDate(),\n\t})\n}\n\n/** Whether a number names a real date (no 20260231). */\nexport const isCalendarDay = (value: number): boolean =>\n\tNumber.isInteger(value) && value > 0 && fromUtcMidnight(utcMidnight(value)) === value\n\n/** `YYYY-MM-DD`, the form a day-granular provider API and a date input take. */\nexport const formatCalendarDay = (day: CalendarDay): string => formatYmd(calendarDate(day))\n\n/** The date a `YYYY-MM-DD` string names, or null for anything else. */\nexport const parseCalendarDay = (text: string): CalendarDay | null => {\n\tconst match = /^(\\d{4})-(\\d{2})-(\\d{2})$/.exec(text)\n\tif (!match) {\n\t\treturn null\n\t}\n\tconst day = toCalendarDay({\n\t\tyear: Number(match[1]),\n\t\tmonth: Number(match[2]),\n\t\tday: Number(match[3]),\n\t})\n\treturn isCalendarDay(day) ? day : null\n}\n\n/** The local date an instant falls on in `tz`. */\nexport const calendarDayOf = (instant: Date, tz: string = DEFAULT_TIMEZONE): CalendarDay =>\n\ttoCalendarDay(zonedDate(instant, tz))\n\nexport const addCalendarDays = (day: CalendarDay, days: number): CalendarDay =>\n\tfromUtcMidnight(utcMidnight(day) + days * DAY_MS)\n\n/** Whole days from `from` to `to`; negative when `to` comes first. */\nexport const calendarDaysBetween = (from: CalendarDay, to: CalendarDay): number =>\n\tMath.round((utcMidnight(to) - utcMidnight(from)) / DAY_MS)\n\n/**\n * The Monday starting the week a date belongs to, the same week `startOfWeekInTz` reads: a\n * Sunday closes its week rather than opening the next.\n */\nexport const weekStartOf = (day: CalendarDay): CalendarDay => {\n\tconst weekday = new Date(utcMidnight(day)).getUTCDay()\n\treturn addCalendarDays(day, -((weekday + 6) % 7))\n}\n\n/** The first of the date's month. */\nexport const monthStartOf = (day: CalendarDay): CalendarDay => Math.floor(day / 100) * 100 + 1\n\n/** The first of the month after the date's. */\nexport const nextMonthStart = (day: CalendarDay): CalendarDay => {\n\tconst { year, month } = calendarDate(day)\n\treturn month === 12\n\t\t? toCalendarDay({ year: year + 1, month: 1, day: 1 })\n\t\t: (year * 100 + month + 1) * 100 + 1\n}\n\n/** The instant a local date starts at in `tz`, which is not always midnight (Santiago, Havana). */\nexport const calendarDayStart = (day: CalendarDay, tz: string = DEFAULT_TIMEZONE): Date =>\n\tstartOfCalendarDayInTz(calendarDate(day), tz)\n"],"mappings":";;AAeA,MAAa,iBAAiB,EAAE,MAAM,OAAO,UAC5C,OAAO,MAAS,QAAQ,MAAM;AAE/B,MAAa,gBAAgB,SAAoC;CAChE,MAAM,KAAK,MAAM,MAAM,GAAM;CAC7B,OAAO,KAAK,MAAM,MAAM,GAAG,IAAI;CAC/B,KAAK,MAAM;AACZ;;AAGA,MAAM,eAAe,QAA6B;CACjD,MAAM,EAAE,MAAM,OAAO,KAAK,SAAS,aAAa,GAAG;CACnD,OAAO,KAAK,IAAI,MAAM,QAAQ,GAAG,IAAI;AACtC;AAEA,MAAM,mBAAmB,OAA4B;CACpD,MAAM,KAAK,IAAI,KAAK,EAAE;CACtB,OAAO,cAAc;EACpB,MAAM,GAAG,eAAe;EACxB,OAAO,GAAG,YAAY,IAAI;EAC1B,KAAK,GAAG,WAAW;CACpB,CAAC;AACF;;AAGA,MAAa,iBAAiB,UAC7B,OAAO,UAAU,KAAK,KAAK,QAAQ,KAAK,gBAAgB,YAAY,KAAK,CAAC,MAAM;;AAGjF,MAAa,qBAAqB,QAA6B,UAAU,aAAa,GAAG,CAAC;;AAG1F,MAAa,oBAAoB,SAAqC;CACrE,MAAM,QAAQ,4BAA4B,KAAK,IAAI;CACnD,IAAI,CAAC,OACJ,OAAO;CAER,MAAM,MAAM,cAAc;EACzB,MAAM,OAAO,MAAM,EAAE;EACrB,OAAO,OAAO,MAAM,EAAE;EACtB,KAAK,OAAO,MAAM,EAAE;CACrB,CAAC;CACD,OAAO,cAAc,GAAG,IAAI,MAAM;AACnC;;AAGA,MAAa,iBAAiB,SAAe,KAAA,UAC5C,cAAc,UAAU,SAAS,EAAE,CAAC;AAErC,MAAa,mBAAmB,KAAkB,SACjD,gBAAgB,YAAY,GAAG,IAAI,OAAO,MAAM;;AAGjD,MAAa,uBAAuB,MAAmB,OACtD,KAAK,OAAO,YAAY,EAAE,IAAI,YAAY,IAAI,KAAK,MAAM;;;;;AAM1D,MAAa,eAAe,QAAkC;CAE7D,OAAO,gBAAgB,KAAK,GADZ,IAAI,KAAK,YAAY,GAAG,CAAC,EAAE,UACN,IAAI,KAAK,EAAE;AACjD;;AAGA,MAAa,gBAAgB,QAAkC,KAAK,MAAM,MAAM,GAAG,IAAI,MAAM;;AAG7F,MAAa,kBAAkB,QAAkC;CAChE,MAAM,EAAE,MAAM,UAAU,aAAa,GAAG;CACxC,OAAO,UAAU,KACd,cAAc;EAAE,MAAM,OAAO;EAAG,OAAO;EAAG,KAAK;CAAE,CAAC,KACjD,OAAO,MAAM,QAAQ,KAAK,MAAM;AACrC;;AAGA,MAAa,oBAAoB,KAAkB,KAAA,UAClD,uBAAuB,aAAa,GAAG,GAAG,EAAE"}
@@ -0,0 +1,46 @@
1
+ import { DAY_MS, addDaysInTz, startOfDayInTz } from "./tz.js";
2
+ //#region src/timeframe/comparison.ts
3
+ /**
4
+ * Period-over-period beyond a year is not meaningful; the cap also rejects the unbounded `allTime`
5
+ * range, which would compare against a pre-1970 window.
6
+ */
7
+ const MAX_COMPARISON_DAYS = 366;
8
+ /**
9
+ * As many whole days in `tz` as `range` touches, ending 1 ms before its first day, so a source
10
+ * keeping daily totals never loses a day to a mid-day start. Null past {@link MAX_COMPARISON_DAYS}.
11
+ */
12
+ const previousWindow = (range, tz = "UTC") => {
13
+ const firstDay = startOfDayInTz(range.start, tz);
14
+ const lastDay = startOfDayInTz(range.end, tz);
15
+ const days = Math.round((lastDay.getTime() - firstDay.getTime()) / DAY_MS) + 1;
16
+ if (!Number.isFinite(days) || days < 1 || days > MAX_COMPARISON_DAYS) return null;
17
+ return {
18
+ start: addDaysInTz(firstDay, -days, tz),
19
+ end: /* @__PURE__ */ new Date(firstDay.getTime() - 1)
20
+ };
21
+ };
22
+ /**
23
+ * Whether a source still answers for `window`; callers omit the comparison otherwise. The floor
24
+ * anchors on `now`, as providers count lookback from today, and may be an hour off across DST.
25
+ */
26
+ const withinLookback = (window, maxLookbackDays, args) => {
27
+ if (maxLookbackDays == null) return true;
28
+ const floor = startOfDayInTz(args.now, args.tz ?? "UTC").getTime() - maxLookbackDays * DAY_MS;
29
+ return window.start.getTime() >= floor;
30
+ };
31
+ /**
32
+ * Period-over-period delta for one metric value against its previous-window value. Null when
33
+ * either side is missing or `null`: an average with no samples is no baseline and no change.
34
+ */
35
+ const computeDelta = (current, previous) => {
36
+ if (typeof current !== "number" || typeof previous !== "number") return null;
37
+ const diff = current - previous;
38
+ return {
39
+ direction: diff > 0 ? "up" : diff < 0 ? "down" : "none",
40
+ percent: previous === 0 ? null : diff / previous * 100
41
+ };
42
+ };
43
+ //#endregion
44
+ export { computeDelta, previousWindow, withinLookback };
45
+
46
+ //# sourceMappingURL=comparison.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"comparison.js","names":[],"sources":["../../src/timeframe/comparison.ts"],"sourcesContent":["import type { DateRange, MetricValue } from '../core/contract'\nimport { addDaysInTz, DAY_MS, DEFAULT_TIMEZONE, startOfDayInTz } from './tz'\n\nexport type DeltaDirection = 'up' | 'down' | 'none'\n\ninterface MetricDelta {\n\tdirection: DeltaDirection\n\t/** Signed percent change vs the previous value; null when that is 0, which is no baseline. */\n\tpercent: number | null\n}\n\n/**\n * Period-over-period beyond a year is not meaningful; the cap also rejects the unbounded `allTime`\n * range, which would compare against a pre-1970 window.\n */\nconst MAX_COMPARISON_DAYS = 366\n\n/**\n * As many whole days in `tz` as `range` touches, ending 1 ms before its first day, so a source\n * keeping daily totals never loses a day to a mid-day start. Null past {@link MAX_COMPARISON_DAYS}.\n */\nexport const previousWindow = (\n\trange: DateRange,\n\ttz: string = DEFAULT_TIMEZONE\n): DateRange | null => {\n\tconst firstDay = startOfDayInTz(range.start, tz)\n\tconst lastDay = startOfDayInTz(range.end, tz)\n\tconst days = Math.round((lastDay.getTime() - firstDay.getTime()) / DAY_MS) + 1\n\tif (!Number.isFinite(days) || days < 1 || days > MAX_COMPARISON_DAYS) {\n\t\treturn null\n\t}\n\treturn { start: addDaysInTz(firstDay, -days, tz), end: new Date(firstDay.getTime() - 1) }\n}\n\n/**\n * Whether a source still answers for `window`; callers omit the comparison otherwise. The floor\n * anchors on `now`, as providers count lookback from today, and may be an hour off across DST.\n */\nexport const withinLookback = (\n\twindow: DateRange,\n\tmaxLookbackDays: number | null,\n\targs: { tz?: string; now: Date }\n): boolean => {\n\tif (maxLookbackDays == null) {\n\t\treturn true\n\t}\n\tconst floor =\n\t\tstartOfDayInTz(args.now, args.tz ?? DEFAULT_TIMEZONE).getTime() - maxLookbackDays * DAY_MS\n\treturn window.start.getTime() >= floor\n}\n\n/**\n * Period-over-period delta for one metric value against its previous-window value. Null when\n * either side is missing or `null`: an average with no samples is no baseline and no change.\n */\nexport const computeDelta = (current?: MetricValue, previous?: MetricValue): MetricDelta | null => {\n\tif (typeof current !== 'number' || typeof previous !== 'number') {\n\t\treturn null\n\t}\n\tconst diff = current - previous\n\tconst direction: DeltaDirection = diff > 0 ? 'up' : diff < 0 ? 'down' : 'none'\n\tconst percent = previous === 0 ? null : (diff / previous) * 100\n\treturn { direction, percent }\n}\n"],"mappings":";;;;;;AAeA,MAAM,sBAAsB;;;;;AAM5B,MAAa,kBACZ,OACA,KAAA,UACsB;CACtB,MAAM,WAAW,eAAe,MAAM,OAAO,EAAE;CAC/C,MAAM,UAAU,eAAe,MAAM,KAAK,EAAE;CAC5C,MAAM,OAAO,KAAK,OAAO,QAAQ,QAAQ,IAAI,SAAS,QAAQ,KAAK,MAAM,IAAI;CAC7E,IAAI,CAAC,OAAO,SAAS,IAAI,KAAK,OAAO,KAAK,OAAO,qBAChD,OAAO;CAER,OAAO;EAAE,OAAO,YAAY,UAAU,CAAC,MAAM,EAAE;EAAG,qBAAK,IAAI,KAAK,SAAS,QAAQ,IAAI,CAAC;CAAE;AACzF;;;;;AAMA,MAAa,kBACZ,QACA,iBACA,SACa;CACb,IAAI,mBAAmB,MACtB,OAAO;CAER,MAAM,QACL,eAAe,KAAK,KAAK,KAAK,MAAA,KAAsB,EAAE,QAAQ,IAAI,kBAAkB;CACrF,OAAO,OAAO,MAAM,QAAQ,KAAK;AAClC;;;;;AAMA,MAAa,gBAAgB,SAAuB,aAA+C;CAClG,IAAI,OAAO,YAAY,YAAY,OAAO,aAAa,UACtD,OAAO;CAER,MAAM,OAAO,UAAU;CAGvB,OAAO;EAAE,WAFyB,OAAO,IAAI,OAAO,OAAO,IAAI,SAAS;EAEpD,SADJ,aAAa,IAAI,OAAQ,OAAO,WAAY;CAChC;AAC7B"}
@@ -2,5 +2,5 @@
2
2
  declare const TIMEFRAME_PRESETS: readonly ["today", "last7days", "last30days", "last90days", "thisMonth", "thisYear", "lastYear", "allTime"];
3
3
  type TimeframePreset = (typeof TIMEFRAME_PRESETS)[number];
4
4
  //#endregion
5
- export { TimeframePreset };
5
+ export { TIMEFRAME_PRESETS, TimeframePreset };
6
6
  //# sourceMappingURL=presets.d.ts.map
@@ -1,3 +1,4 @@
1
+ import { isOneOf } from "../core/values.js";
1
2
  import { addDaysInTz, startOfDayInTz, startOfMonthInTz, startOfYearInTz } from "./tz.js";
2
3
  //#region src/timeframe/presets.ts
3
4
  const TIMEFRAME_PRESETS = [
@@ -10,11 +11,10 @@ const TIMEFRAME_PRESETS = [
10
11
  "lastYear",
11
12
  "allTime"
12
13
  ];
14
+ const isTimeframePreset = (value) => isOneOf(TIMEFRAME_PRESETS, value);
13
15
  /**
14
- * Resolve a relative timeframe preset to an absolute `DateRange`. `now` is injected
15
- * so callers stay deterministic. `end` is `now`; `start` is the day floor of the
16
- * window in `tz` (defaulting to UTC, so day boundaries align with the reporting
17
- * timezone). Inclusive day windows count the current day (`last7days` = today plus 6).
16
+ * `end` is `now`; `start` is the window's day floor in `tz`. Day windows include today (`last7days`
17
+ * is today plus 6).
18
18
  */
19
19
  const resolveTimeframe = (preset, now, tz = "UTC") => {
20
20
  const end = new Date(now);
@@ -54,6 +54,6 @@ const resolveTimeframe = (preset, now, tz = "UTC") => {
54
54
  }
55
55
  };
56
56
  //#endregion
57
- export { TIMEFRAME_PRESETS, resolveTimeframe };
57
+ export { TIMEFRAME_PRESETS, isTimeframePreset, resolveTimeframe };
58
58
 
59
59
  //# sourceMappingURL=presets.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"presets.js","names":[],"sources":["../../src/timeframe/presets.ts"],"sourcesContent":["import type { DateRange } from '../core/contract'\nimport {\n\taddDaysInTz,\n\tDEFAULT_TIMEZONE,\n\tstartOfDayInTz,\n\tstartOfMonthInTz,\n\tstartOfYearInTz,\n} from './tz'\n\nexport const TIMEFRAME_PRESETS = [\n\t'today',\n\t'last7days',\n\t'last30days',\n\t'last90days',\n\t'thisMonth',\n\t'thisYear',\n\t'lastYear',\n\t'allTime',\n] as const\n\nexport type TimeframePreset = (typeof TIMEFRAME_PRESETS)[number]\n\n/**\n * Resolve a relative timeframe preset to an absolute `DateRange`. `now` is injected\n * so callers stay deterministic. `end` is `now`; `start` is the day floor of the\n * window in `tz` (defaulting to UTC, so day boundaries align with the reporting\n * timezone). Inclusive day windows count the current day (`last7days` = today plus 6).\n */\nexport const resolveTimeframe = (\n\tpreset: TimeframePreset,\n\tnow: Date,\n\ttz: string = DEFAULT_TIMEZONE\n): DateRange => {\n\tconst end = new Date(now)\n\tswitch (preset) {\n\t\tcase 'today':\n\t\t\treturn { start: startOfDayInTz(now, tz), end }\n\t\tcase 'last7days':\n\t\t\treturn { start: addDaysInTz(now, -6, tz), end }\n\t\tcase 'last30days':\n\t\t\treturn { start: addDaysInTz(now, -29, tz), end }\n\t\tcase 'last90days':\n\t\t\treturn { start: addDaysInTz(now, -89, tz), end }\n\t\tcase 'thisMonth':\n\t\t\treturn { start: startOfMonthInTz(now, tz), end }\n\t\tcase 'thisYear':\n\t\t\treturn { start: startOfYearInTz(now, tz), end }\n\t\tcase 'lastYear':\n\t\t\treturn { start: addDaysInTz(now, -364, tz), end }\n\t\tcase 'allTime':\n\t\t\treturn { start: new Date(0), end }\n\t}\n}\n"],"mappings":";;AASA,MAAa,oBAAoB;CAChC;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AACD;;;;;;;AAUA,MAAa,oBACZ,QACA,KACA,KAAA,UACe;CACf,MAAM,MAAM,IAAI,KAAK,GAAG;CACxB,QAAQ,QAAR;EACC,KAAK,SACJ,OAAO;GAAE,OAAO,eAAe,KAAK,EAAE;GAAG;EAAI;EAC9C,KAAK,aACJ,OAAO;GAAE,OAAO,YAAY,KAAK,IAAI,EAAE;GAAG;EAAI;EAC/C,KAAK,cACJ,OAAO;GAAE,OAAO,YAAY,KAAK,KAAK,EAAE;GAAG;EAAI;EAChD,KAAK,cACJ,OAAO;GAAE,OAAO,YAAY,KAAK,KAAK,EAAE;GAAG;EAAI;EAChD,KAAK,aACJ,OAAO;GAAE,OAAO,iBAAiB,KAAK,EAAE;GAAG;EAAI;EAChD,KAAK,YACJ,OAAO;GAAE,OAAO,gBAAgB,KAAK,EAAE;GAAG;EAAI;EAC/C,KAAK,YACJ,OAAO;GAAE,OAAO,YAAY,KAAK,MAAM,EAAE;GAAG;EAAI;EACjD,KAAK,WACJ,OAAO;GAAE,uBAAO,IAAI,KAAK,CAAC;GAAG;EAAI;CACnC;AACD"}
1
+ {"version":3,"file":"presets.js","names":[],"sources":["../../src/timeframe/presets.ts"],"sourcesContent":["import type { DateRange } from '../core/contract'\nimport { isOneOf } from '../core/values'\nimport {\n\taddDaysInTz,\n\tDEFAULT_TIMEZONE,\n\tstartOfDayInTz,\n\tstartOfMonthInTz,\n\tstartOfYearInTz,\n} from './tz'\n\nexport const TIMEFRAME_PRESETS = [\n\t'today',\n\t'last7days',\n\t'last30days',\n\t'last90days',\n\t'thisMonth',\n\t'thisYear',\n\t'lastYear',\n\t'allTime',\n] as const\n\nexport type TimeframePreset = (typeof TIMEFRAME_PRESETS)[number]\n\nexport const isTimeframePreset = (value: unknown): value is TimeframePreset =>\n\tisOneOf(TIMEFRAME_PRESETS, value)\n\n/**\n * `end` is `now`; `start` is the window's day floor in `tz`. Day windows include today (`last7days`\n * is today plus 6).\n */\nexport const resolveTimeframe = (\n\tpreset: TimeframePreset,\n\tnow: Date,\n\ttz: string = DEFAULT_TIMEZONE\n): DateRange => {\n\tconst end = new Date(now)\n\tswitch (preset) {\n\t\tcase 'today':\n\t\t\treturn { start: startOfDayInTz(now, tz), end }\n\t\tcase 'last7days':\n\t\t\treturn { start: addDaysInTz(now, -6, tz), end }\n\t\tcase 'last30days':\n\t\t\treturn { start: addDaysInTz(now, -29, tz), end }\n\t\tcase 'last90days':\n\t\t\treturn { start: addDaysInTz(now, -89, tz), end }\n\t\tcase 'thisMonth':\n\t\t\treturn { start: startOfMonthInTz(now, tz), end }\n\t\tcase 'thisYear':\n\t\t\treturn { start: startOfYearInTz(now, tz), end }\n\t\tcase 'lastYear':\n\t\t\treturn { start: addDaysInTz(now, -364, tz), end }\n\t\tcase 'allTime':\n\t\t\treturn { start: new Date(0), end }\n\t}\n}\n"],"mappings":";;;AAUA,MAAa,oBAAoB;CAChC;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AACD;AAIA,MAAa,qBAAqB,UACjC,QAAQ,mBAAmB,KAAK;;;;;AAMjC,MAAa,oBACZ,QACA,KACA,KAAA,UACe;CACf,MAAM,MAAM,IAAI,KAAK,GAAG;CACxB,QAAQ,QAAR;EACC,KAAK,SACJ,OAAO;GAAE,OAAO,eAAe,KAAK,EAAE;GAAG;EAAI;EAC9C,KAAK,aACJ,OAAO;GAAE,OAAO,YAAY,KAAK,IAAI,EAAE;GAAG;EAAI;EAC/C,KAAK,cACJ,OAAO;GAAE,OAAO,YAAY,KAAK,KAAK,EAAE;GAAG;EAAI;EAChD,KAAK,cACJ,OAAO;GAAE,OAAO,YAAY,KAAK,KAAK,EAAE;GAAG;EAAI;EAChD,KAAK,aACJ,OAAO;GAAE,OAAO,iBAAiB,KAAK,EAAE;GAAG;EAAI;EAChD,KAAK,YACJ,OAAO;GAAE,OAAO,gBAAgB,KAAK,EAAE;GAAG;EAAI;EAC/C,KAAK,YACJ,OAAO;GAAE,OAAO,YAAY,KAAK,MAAM,EAAE;GAAG;EAAI;EACjD,KAAK,WACJ,OAAO;GAAE,uBAAO,IAAI,KAAK,CAAC;GAAG;EAAI;CACnC;AACD"}
@@ -0,0 +1 @@
1
+ import { PayloadRequest } from "payload";
@@ -0,0 +1,64 @@
1
+ import { isValidTimeZone } from "./tz.js";
2
+ //#region src/timeframe/reportingTimezone.ts
3
+ /** A resolver can answer from request data, so the values it is warned about are capped. */
4
+ const MAX_WARNED_ZONES = 100;
5
+ /** A resolver's answer as a log line quotes it, cut short so a caller cannot inflate the line. */
6
+ const quoted = (answer) => JSON.stringify(answer.slice(0, 64));
7
+ /** The host's `reportingTimezone` resolver threw, or answered something that is not a zone. */
8
+ var TimezoneResolutionError = class extends Error {
9
+ /** What the resolver answered, when it answered a name that is not an IANA zone. */
10
+ answer;
11
+ constructor(message, answer, cause) {
12
+ super(message, cause === void 0 ? void 0 : { cause });
13
+ this.name = "TimezoneResolutionError";
14
+ this.answer = answer;
15
+ }
16
+ };
17
+ /**
18
+ * Throws a {@link TimezoneResolutionError} instead of falling back to UTC: the native engine counts
19
+ * stored days in this zone, so one UTC day would move its numbers. `null` is UTC.
20
+ */
21
+ const createStrictTimezoneResolver = (args) => async (req, scope) => {
22
+ const { option } = args;
23
+ if (option === void 0) return "UTC";
24
+ if (typeof option === "string") return option;
25
+ let tz;
26
+ try {
27
+ tz = await option({
28
+ req,
29
+ scope: scope !== void 0 ? scope : await args.resolveScope(req)
30
+ });
31
+ } catch (err) {
32
+ throw new TimezoneResolutionError(`analytics: reportingTimezone resolution failed: ${String(err)}`, void 0, err);
33
+ }
34
+ if (!tz) return "UTC";
35
+ if (!isValidTimeZone(tz)) throw new TimezoneResolutionError(`analytics: reportingTimezone resolved ${quoted(tz)}, which is not an IANA timezone name`, tz);
36
+ return tz;
37
+ };
38
+ /**
39
+ * Reporting timezone for display and provider reads, bound once per plugin instance. A throw or a
40
+ * non-IANA answer reads in UTC, the latter warned once per distinct value.
41
+ */
42
+ const createTimezoneResolver = (args) => {
43
+ const strict = createStrictTimezoneResolver(args);
44
+ const warned = /* @__PURE__ */ new Set();
45
+ return async (req, scope) => {
46
+ try {
47
+ return await strict(req, scope);
48
+ } catch (err) {
49
+ const answer = err instanceof TimezoneResolutionError ? err.answer : void 0;
50
+ if (answer === void 0) {
51
+ const cause = err instanceof TimezoneResolutionError ? err.cause : err;
52
+ req.payload?.logger?.warn?.(`analytics: reportingTimezone resolution failed, falling back to UTC: ${String(cause)}`);
53
+ } else if (!warned.has(answer) && warned.size < MAX_WARNED_ZONES) {
54
+ warned.add(answer);
55
+ req.payload?.logger?.warn?.(`analytics: reportingTimezone resolved ${quoted(answer)}, which is not an IANA timezone name, so the read is in UTC`);
56
+ }
57
+ return "UTC";
58
+ }
59
+ };
60
+ };
61
+ //#endregion
62
+ export { TimezoneResolutionError, createStrictTimezoneResolver, createTimezoneResolver };
63
+
64
+ //# sourceMappingURL=reportingTimezone.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"reportingTimezone.js","names":[],"sources":["../../src/timeframe/reportingTimezone.ts"],"sourcesContent":["import type { PayloadRequest } from 'payload'\nimport type { TimezoneResolver } from '../core/options'\nimport { DEFAULT_TIMEZONE, isValidTimeZone } from './tz'\n\n/** A resolver can answer from request data, so the values it is warned about are capped. */\nconst MAX_WARNED_ZONES = 100\n\n/** A resolver's answer as a log line quotes it, cut short so a caller cannot inflate the line. */\nconst quoted = (answer: string): string => JSON.stringify(answer.slice(0, 64))\n\ninterface ReportingTimezoneArgs {\n\t/** `reportingTimezone`; a string was already validated at boot. */\n\toption: string | TimezoneResolver | undefined\n\tresolveScope: (req: PayloadRequest) => Promise<string | null>\n}\n\n/** A request's reporting timezone, for the scope the caller resolved or the request's own. */\ntype RequestTimezoneResolver = (req: PayloadRequest, scope?: string | null) => Promise<string>\n\n/** The host's `reportingTimezone` resolver threw, or answered something that is not a zone. */\nexport class TimezoneResolutionError extends Error {\n\t/** What the resolver answered, when it answered a name that is not an IANA zone. */\n\treadonly answer: string | undefined\n\n\tconstructor(message: string, answer?: string, cause?: unknown) {\n\t\tsuper(message, cause === undefined ? undefined : { cause })\n\t\tthis.name = 'TimezoneResolutionError'\n\t\tthis.answer = answer\n\t}\n}\n\n/**\n * Throws a {@link TimezoneResolutionError} instead of falling back to UTC: the native engine counts\n * stored days in this zone, so one UTC day would move its numbers. `null` is UTC.\n */\nexport const createStrictTimezoneResolver =\n\t(args: ReportingTimezoneArgs): RequestTimezoneResolver =>\n\tasync (req, scope) => {\n\t\tconst { option } = args\n\t\tif (option === undefined) {\n\t\t\treturn DEFAULT_TIMEZONE\n\t\t}\n\t\tif (typeof option === 'string') {\n\t\t\treturn option\n\t\t}\n\t\tlet tz: string | null\n\t\ttry {\n\t\t\ttz = await option({\n\t\t\t\treq,\n\t\t\t\tscope: scope !== undefined ? scope : await args.resolveScope(req),\n\t\t\t})\n\t\t} catch (err) {\n\t\t\tthrow new TimezoneResolutionError(\n\t\t\t\t`analytics: reportingTimezone resolution failed: ${String(err)}`,\n\t\t\t\tundefined,\n\t\t\t\terr\n\t\t\t)\n\t\t}\n\t\tif (!tz) {\n\t\t\treturn DEFAULT_TIMEZONE\n\t\t}\n\t\tif (!isValidTimeZone(tz)) {\n\t\t\tthrow new TimezoneResolutionError(\n\t\t\t\t`analytics: reportingTimezone resolved ${quoted(tz)}, which is not an IANA timezone name`,\n\t\t\t\ttz\n\t\t\t)\n\t\t}\n\t\treturn tz\n\t}\n\n/**\n * Reporting timezone for display and provider reads, bound once per plugin instance. A throw or a\n * non-IANA answer reads in UTC, the latter warned once per distinct value.\n */\nexport const createTimezoneResolver = (args: ReportingTimezoneArgs): RequestTimezoneResolver => {\n\tconst strict = createStrictTimezoneResolver(args)\n\tconst warned = new Set<string>()\n\treturn async (req, scope) => {\n\t\ttry {\n\t\t\treturn await strict(req, scope)\n\t\t} catch (err) {\n\t\t\tconst answer = err instanceof TimezoneResolutionError ? err.answer : undefined\n\t\t\tif (answer === undefined) {\n\t\t\t\tconst cause = err instanceof TimezoneResolutionError ? err.cause : err\n\t\t\t\treq.payload?.logger?.warn?.(\n\t\t\t\t\t`analytics: reportingTimezone resolution failed, falling back to UTC: ${String(cause)}`\n\t\t\t\t)\n\t\t\t} else if (!warned.has(answer) && warned.size < MAX_WARNED_ZONES) {\n\t\t\t\twarned.add(answer)\n\t\t\t\treq.payload?.logger?.warn?.(\n\t\t\t\t\t`analytics: reportingTimezone resolved ${quoted(answer)}, which is not an IANA timezone name, so the read is in UTC`\n\t\t\t\t)\n\t\t\t}\n\t\t\treturn DEFAULT_TIMEZONE\n\t\t}\n\t}\n}\n"],"mappings":";;;AAKA,MAAM,mBAAmB;;AAGzB,MAAM,UAAU,WAA2B,KAAK,UAAU,OAAO,MAAM,GAAG,EAAE,CAAC;;AAY7E,IAAa,0BAAb,cAA6C,MAAM;;CAElD;CAEA,YAAY,SAAiB,QAAiB,OAAiB;EAC9D,MAAM,SAAS,UAAU,KAAA,IAAY,KAAA,IAAY,EAAE,MAAM,CAAC;EAC1D,KAAK,OAAO;EACZ,KAAK,SAAS;CACf;AACD;;;;;AAMA,MAAa,gCACX,SACD,OAAO,KAAK,UAAU;CACrB,MAAM,EAAE,WAAW;CACnB,IAAI,WAAW,KAAA,GACd,OAAA;CAED,IAAI,OAAO,WAAW,UACrB,OAAO;CAER,IAAI;CACJ,IAAI;EACH,KAAK,MAAM,OAAO;GACjB;GACA,OAAO,UAAU,KAAA,IAAY,QAAQ,MAAM,KAAK,aAAa,GAAG;EACjE,CAAC;CACF,SAAS,KAAK;EACb,MAAM,IAAI,wBACT,mDAAmD,OAAO,GAAG,KAC7D,KAAA,GACA,GACD;CACD;CACA,IAAI,CAAC,IACJ,OAAA;CAED,IAAI,CAAC,gBAAgB,EAAE,GACtB,MAAM,IAAI,wBACT,yCAAyC,OAAO,EAAE,EAAE,uCACpD,EACD;CAED,OAAO;AACR;;;;;AAMD,MAAa,0BAA0B,SAAyD;CAC/F,MAAM,SAAS,6BAA6B,IAAI;CAChD,MAAM,yBAAS,IAAI,IAAY;CAC/B,OAAO,OAAO,KAAK,UAAU;EAC5B,IAAI;GACH,OAAO,MAAM,OAAO,KAAK,KAAK;EAC/B,SAAS,KAAK;GACb,MAAM,SAAS,eAAe,0BAA0B,IAAI,SAAS,KAAA;GACrE,IAAI,WAAW,KAAA,GAAW;IACzB,MAAM,QAAQ,eAAe,0BAA0B,IAAI,QAAQ;IACnE,IAAI,SAAS,QAAQ,OACpB,wEAAwE,OAAO,KAAK,GACrF;GACD,OAAO,IAAI,CAAC,OAAO,IAAI,MAAM,KAAK,OAAO,OAAO,kBAAkB;IACjE,OAAO,IAAI,MAAM;IACjB,IAAI,SAAS,QAAQ,OACpB,yCAAyC,OAAO,MAAM,EAAE,4DACzD;GACD;GACA,OAAA;EACD;CACD;AACD"}
@@ -1,3 +1,7 @@
1
+ /** Milliseconds in a UTC day; a local day across a DST change is an hour longer or shorter. */
2
+ const DAY_MS = 864e5;
3
+ const HOUR_MS = 36e5;
4
+ const MINUTE_MS = 6e4;
1
5
  const formatterCache = /* @__PURE__ */ new Map();
2
6
  const partsFormatter = (tz) => {
3
7
  let formatter = formatterCache.get(tz);
@@ -16,7 +20,6 @@ const partsFormatter = (tz) => {
16
20
  }
17
21
  return formatter;
18
22
  };
19
- /** Wall-clock parts `date` maps to in `tz`. */
20
23
  const zonedParts = (date, tz) => {
21
24
  const map = {};
22
25
  for (const part of partsFormatter(tz).formatToParts(date)) if (part.type !== "literal") map[part.type] = part.value;
@@ -38,26 +41,46 @@ const sameLocalDay = (date, ymd, tz) => {
38
41
  const p = zonedParts(date, tz);
39
42
  return p.year === ymd.year && p.month === ymd.month && p.day === ymd.day;
40
43
  };
41
- /**
42
- * The first instant of a wall-clock calendar date in `tz`. Usually local midnight; when a
43
- * spring-forward transition lands exactly at midnight (Chile, Cuba) the 00:00 wall clock
44
- * does not exist and the refinement below oscillates between the pre- and post-transition
45
- * offsets, so the candidate that still falls on `ymd` (the transition instant, local
46
- * 01:00) is taken instead of the refined one that fell back onto the previous day.
47
- */
48
- const startOfCalendarDayInTz = (ymd, tz = "UTC") => {
44
+ /** Zones found valid: checking one builds a formatter, and a read checks every scope's. */
45
+ const validZones = /* @__PURE__ */ new Set();
46
+ const MAX_VALID_ZONES = 1e3;
47
+ /** Day starts by zone and date: a read over many scopes asks for the same few again and again. */
48
+ const dayStarts = /* @__PURE__ */ new Map();
49
+ const MAX_DAY_STARTS = 2e4;
50
+ const dayStartOf = (ymd, tz) => {
49
51
  const asUtc = Date.UTC(ymd.year, ymd.month - 1, ymd.day);
50
52
  const guess = new Date(asUtc - offsetMs(new Date(asUtc), tz));
51
53
  const refined = new Date(asUtc - offsetMs(guess, tz));
52
54
  if (sameLocalDay(refined, ymd, tz)) return refined;
53
55
  if (sameLocalDay(guess, ymd, tz)) return guess;
54
- return startOfCalendarDayInTz(zonedParts(refined.getTime() > guess.getTime() ? refined : guess, tz), tz);
56
+ return dayStartOf(zonedParts(refined.getTime() > guess.getTime() ? refined : guess, tz), tz);
57
+ };
58
+ /**
59
+ * First instant of a wall-clock date in `tz`: usually local midnight, but where spring-forward
60
+ * skips 00:00 (Chile, Cuba) it is the transition instant, local 01:00.
61
+ */
62
+ const startOfCalendarDayInTz = (ymd, tz = "UTC") => {
63
+ const key = `${tz} ${ymd.year}-${ymd.month}-${ymd.day}`;
64
+ const known = dayStarts.get(key);
65
+ if (known !== void 0) return new Date(known);
66
+ const start = dayStartOf(ymd, tz);
67
+ if (dayStarts.size >= MAX_DAY_STARTS) dayStarts.clear();
68
+ dayStarts.set(key, start.getTime());
69
+ return start;
55
70
  };
56
- /** Start of `date`'s local day in `tz`. */
57
71
  const startOfDayInTz = (date, tz = "UTC") => {
58
72
  return startOfCalendarDayInTz(zonedParts(date, tz), tz);
59
73
  };
60
- /** Start of `date`'s local month in `tz`. */
74
+ /**
75
+ * Derived from the zoned minute and second, not a UTC hour floor, so half- and quarter-hour zones
76
+ * (India, Nepal, Chatham) bucket on their own hours.
77
+ */
78
+ const startOfHourInTz = (date, tz = "UTC") => {
79
+ const p = zonedParts(date, tz);
80
+ const ms = date.getTime();
81
+ const intoHour = (p.minute * 60 + p.second) * 1e3 + (ms % 1e3 + 1e3) % 1e3;
82
+ return new Date(ms - intoHour);
83
+ };
61
84
  const startOfMonthInTz = (date, tz = "UTC") => {
62
85
  const p = zonedParts(date, tz);
63
86
  return startOfCalendarDayInTz({
@@ -66,7 +89,6 @@ const startOfMonthInTz = (date, tz = "UTC") => {
66
89
  day: 1
67
90
  }, tz);
68
91
  };
69
- /** Start of `date`'s local year in `tz`. */
70
92
  const startOfYearInTz = (date, tz = "UTC") => {
71
93
  return startOfCalendarDayInTz({
72
94
  year: zonedParts(date, tz).year,
@@ -75,47 +97,41 @@ const startOfYearInTz = (date, tz = "UTC") => {
75
97
  }, tz);
76
98
  };
77
99
  /**
78
- * Add `days` calendar days to `date`'s local day in `tz`, returning the resulting day
79
- * start. The +12h buffer before re-flooring absorbs 23/25-hour DST days so stepping
80
- * never lands short of, or past, the intended calendar day.
100
+ * Day start `days` calendar days from `date`'s local day in `tz`. The +12h buffer before
101
+ * re-flooring absorbs 23/25-hour DST days.
81
102
  */
82
103
  const addDaysInTz = (date, days, tz = "UTC") => {
83
104
  const start = startOfDayInTz(date, tz);
84
- return startOfDayInTz(new Date(start.getTime() + days * 864e5 + 432e5), tz);
105
+ return startOfDayInTz(new Date(start.getTime() + days * DAY_MS + DAY_MS / 2), tz);
85
106
  };
86
- /**
87
- * Start of the ISO week (Monday) containing `date`'s local day in `tz`. The weekday of a
88
- * calendar Y-M-D is timezone-independent, so it is derived from the zoned date and the
89
- * step back to Monday runs through `addDaysInTz` to stay DST-safe.
90
- */
91
- const startOfWeekInTz = (date, tz = "UTC") => {
107
+ const zonedDate = (date, tz = "UTC") => {
92
108
  const p = zonedParts(date, tz);
93
- const mondayIndex = (new Date(Date.UTC(p.year, p.month - 1, p.day)).getUTCDay() + 6) % 7;
94
- return addDaysInTz(startOfDayInTz(date, tz), -mondayIndex, tz);
109
+ return {
110
+ year: p.year,
111
+ month: p.month,
112
+ day: p.day
113
+ };
95
114
  };
96
- /** ISO string of `date`'s local day start in `tz`; the canonical day-bucket key. */
97
- const zonedDayIso = (date, tz = "UTC") => startOfDayInTz(date, tz).toISOString();
115
+ /** A date as `YYYY-MM-DD`. */
116
+ const formatYmd = ({ year, month, day }) => `${String(year).padStart(4, "0")}-${String(month).padStart(2, "0")}-${String(day).padStart(2, "0")}`;
98
117
  /**
99
- * `date`'s local calendar date in `tz` as `YYYY-MM-DD`, the form day-granular provider APIs
100
- * take. Not `zonedDayIso(...).slice(0, 10)`: that returns the UTC spelling of the local day
101
- * start, which names the previous calendar day for every zone east of UTC.
118
+ * `date`'s local date in `tz` as `YYYY-MM-DD`. Not the local day start's ISO prefix: that is the
119
+ * UTC spelling, a day early for every zone east of UTC.
102
120
  */
103
- const zonedCalendarDay = (date, tz = "UTC") => {
104
- const p = zonedParts(date, tz);
105
- const month = String(p.month).padStart(2, "0");
106
- const day = String(p.day).padStart(2, "0");
107
- return `${String(p.year).padStart(4, "0")}-${month}-${day}`;
108
- };
109
- /** True when `tz` is a resolvable IANA identifier. */
121
+ const zonedCalendarDay = (date, tz = "UTC") => formatYmd(zonedParts(date, tz));
122
+ /** Whether the runtime's `Intl` knows `tz` as a time zone. */
110
123
  const isValidTimeZone = (tz) => {
124
+ if (formatterCache.has(tz) || validZones.has(tz)) return true;
111
125
  try {
112
126
  new Intl.DateTimeFormat("en-US", { timeZone: tz });
113
- return true;
114
127
  } catch {
115
128
  return false;
116
129
  }
130
+ if (validZones.size >= MAX_VALID_ZONES) validZones.clear();
131
+ validZones.add(tz);
132
+ return true;
117
133
  };
118
134
  //#endregion
119
- export { addDaysInTz, isValidTimeZone, startOfCalendarDayInTz, startOfDayInTz, startOfMonthInTz, startOfWeekInTz, startOfYearInTz, zonedCalendarDay, zonedDayIso };
135
+ export { DAY_MS, HOUR_MS, MINUTE_MS, addDaysInTz, formatYmd, isValidTimeZone, startOfCalendarDayInTz, startOfDayInTz, startOfHourInTz, startOfMonthInTz, startOfYearInTz, zonedCalendarDay, zonedDate };
120
136
 
121
137
  //# sourceMappingURL=tz.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"tz.js","names":[],"sources":["../../src/timeframe/tz.ts"],"sourcesContent":["/**\n * IANA-timezone day math, built on `Intl.DateTimeFormat` so there is no dependency.\n * All reporting boundaries (timeframe windows, series axes, native rollup buckets,\n * cache-key day snaps) resolve through these helpers. `startOfDayInTz(d, 'UTC')` is\n * exactly the previous `Date.UTC(...)` day floor, so the default path is unchanged.\n */\n\nexport const DEFAULT_TIMEZONE = 'UTC'\n\ninterface ZonedParts {\n\tyear: number\n\tmonth: number\n\tday: number\n\thour: number\n\tminute: number\n\tsecond: number\n}\n\n// Constructing Intl.DateTimeFormat dominates the cost of these helpers (~14x), and they\n// run per event at ingest and in series loops, so formatters are cached per zone.\nconst formatterCache = new Map<string, Intl.DateTimeFormat>()\n\nconst partsFormatter = (tz: string): Intl.DateTimeFormat => {\n\tlet formatter = formatterCache.get(tz)\n\tif (!formatter) {\n\t\tformatter = new Intl.DateTimeFormat('en-US', {\n\t\t\ttimeZone: tz,\n\t\t\thourCycle: 'h23',\n\t\t\tyear: 'numeric',\n\t\t\tmonth: '2-digit',\n\t\t\tday: '2-digit',\n\t\t\thour: '2-digit',\n\t\t\tminute: '2-digit',\n\t\t\tsecond: '2-digit',\n\t\t})\n\t\tformatterCache.set(tz, formatter)\n\t}\n\treturn formatter\n}\n\n/** Wall-clock parts `date` maps to in `tz`. */\nconst zonedParts = (date: Date, tz: string): ZonedParts => {\n\tconst map: Record<string, string> = {}\n\tfor (const part of partsFormatter(tz).formatToParts(date)) {\n\t\tif (part.type !== 'literal') {\n\t\t\tmap[part.type] = part.value\n\t\t}\n\t}\n\treturn {\n\t\tyear: Number(map.year),\n\t\tmonth: Number(map.month),\n\t\tday: Number(map.day),\n\t\thour: Number(map.hour),\n\t\tminute: Number(map.minute),\n\t\tsecond: Number(map.second),\n\t}\n}\n\n/** Milliseconds `tz` is ahead of UTC at `date` (positive east of UTC). */\nconst offsetMs = (date: Date, tz: string): number => {\n\tconst p = zonedParts(date, tz)\n\tconst asUtc = Date.UTC(p.year, p.month - 1, p.day, p.hour, p.minute, p.second)\n\t// formatToParts drops sub-second precision, so compare against the truncated instant.\n\treturn asUtc - Math.floor(date.getTime() / 1000) * 1000\n}\n\nconst sameLocalDay = (\n\tdate: Date,\n\tymd: { year: number; month: number; day: number },\n\ttz: string\n): boolean => {\n\tconst p = zonedParts(date, tz)\n\treturn p.year === ymd.year && p.month === ymd.month && p.day === ymd.day\n}\n\n/**\n * The first instant of a wall-clock calendar date in `tz`. Usually local midnight; when a\n * spring-forward transition lands exactly at midnight (Chile, Cuba) the 00:00 wall clock\n * does not exist and the refinement below oscillates between the pre- and post-transition\n * offsets, so the candidate that still falls on `ymd` (the transition instant, local\n * 01:00) is taken instead of the refined one that fell back onto the previous day.\n */\nexport const startOfCalendarDayInTz = (\n\tymd: { year: number; month: number; day: number },\n\ttz: string = DEFAULT_TIMEZONE\n): Date => {\n\tconst asUtc = Date.UTC(ymd.year, ymd.month - 1, ymd.day)\n\tconst guess = new Date(asUtc - offsetMs(new Date(asUtc), tz))\n\tconst refined = new Date(asUtc - offsetMs(guess, tz))\n\tif (sameLocalDay(refined, ymd, tz)) {\n\t\treturn refined\n\t}\n\tif (sameLocalDay(guess, ymd, tz)) {\n\t\treturn guess\n\t}\n\t// Neither candidate lands on ymd (the calendar date was skipped entirely, e.g. a\n\t// dateline change): fall forward to the later candidate's day start.\n\tconst later = refined.getTime() > guess.getTime() ? refined : guess\n\treturn startOfCalendarDayInTz(zonedParts(later, tz), tz)\n}\n\n/** Start of `date`'s local day in `tz`. */\nexport const startOfDayInTz = (date: Date, tz: string = DEFAULT_TIMEZONE): Date => {\n\tconst p = zonedParts(date, tz)\n\treturn startOfCalendarDayInTz(p, tz)\n}\n\n/** Start of `date`'s local month in `tz`. */\nexport const startOfMonthInTz = (date: Date, tz: string = DEFAULT_TIMEZONE): Date => {\n\tconst p = zonedParts(date, tz)\n\treturn startOfCalendarDayInTz({ year: p.year, month: p.month, day: 1 }, tz)\n}\n\n/** Start of `date`'s local year in `tz`. */\nexport const startOfYearInTz = (date: Date, tz: string = DEFAULT_TIMEZONE): Date => {\n\tconst p = zonedParts(date, tz)\n\treturn startOfCalendarDayInTz({ year: p.year, month: 1, day: 1 }, tz)\n}\n\n/**\n * Add `days` calendar days to `date`'s local day in `tz`, returning the resulting day\n * start. The +12h buffer before re-flooring absorbs 23/25-hour DST days so stepping\n * never lands short of, or past, the intended calendar day.\n */\nexport const addDaysInTz = (date: Date, days: number, tz: string = DEFAULT_TIMEZONE): Date => {\n\tconst start = startOfDayInTz(date, tz)\n\treturn startOfDayInTz(new Date(start.getTime() + days * 86_400_000 + 43_200_000), tz)\n}\n\n/**\n * Start of the ISO week (Monday) containing `date`'s local day in `tz`. The weekday of a\n * calendar Y-M-D is timezone-independent, so it is derived from the zoned date and the\n * step back to Monday runs through `addDaysInTz` to stay DST-safe.\n */\nexport const startOfWeekInTz = (date: Date, tz: string = DEFAULT_TIMEZONE): Date => {\n\tconst p = zonedParts(date, tz)\n\tconst dow = new Date(Date.UTC(p.year, p.month - 1, p.day)).getUTCDay()\n\tconst mondayIndex = (dow + 6) % 7\n\treturn addDaysInTz(startOfDayInTz(date, tz), -mondayIndex, tz)\n}\n\n/** ISO string of `date`'s local day start in `tz`; the canonical day-bucket key. */\nexport const zonedDayIso = (date: Date, tz: string = DEFAULT_TIMEZONE): string =>\n\tstartOfDayInTz(date, tz).toISOString()\n\n/**\n * `date`'s local calendar date in `tz` as `YYYY-MM-DD`, the form day-granular provider APIs\n * take. Not `zonedDayIso(...).slice(0, 10)`: that returns the UTC spelling of the local day\n * start, which names the previous calendar day for every zone east of UTC.\n */\nexport const zonedCalendarDay = (date: Date, tz: string = DEFAULT_TIMEZONE): string => {\n\tconst p = zonedParts(date, tz)\n\tconst month = String(p.month).padStart(2, '0')\n\tconst day = String(p.day).padStart(2, '0')\n\treturn `${String(p.year).padStart(4, '0')}-${month}-${day}`\n}\n\n/** True when `tz` is a resolvable IANA identifier. */\nexport const isValidTimeZone = (tz: string): boolean => {\n\ttry {\n\t\tnew Intl.DateTimeFormat('en-US', { timeZone: tz })\n\t\treturn true\n\t} catch {\n\t\treturn false\n\t}\n}\n"],"mappings":"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"}
1
+ {"version":3,"file":"tz.js","names":[],"sources":["../../src/timeframe/tz.ts"],"sourcesContent":["/**\n * IANA-timezone day math on `Intl.DateTimeFormat`, with no dependency. Every reporting boundary\n * (windows, series axes, engine days, cache-key snaps) resolves through it.\n */\n\nexport const DEFAULT_TIMEZONE = 'UTC'\n\n/** Milliseconds in a UTC day; a local day across a DST change is an hour longer or shorter. */\nexport const DAY_MS = 86_400_000\n\nexport const HOUR_MS = 3_600_000\n\nexport const MINUTE_MS = 60_000\n\n/** A wall-clock date, `month` and `day` counted from 1. */\nexport interface CalendarDate {\n\tyear: number\n\tmonth: number\n\tday: number\n}\n\ninterface ZonedParts extends CalendarDate {\n\thour: number\n\tminute: number\n\tsecond: number\n}\n\n// Constructing Intl.DateTimeFormat dominates the cost of these helpers (~14x), and they\n// run per event at ingest and in series loops, so formatters are cached per zone.\nconst formatterCache = new Map<string, Intl.DateTimeFormat>()\n\nconst partsFormatter = (tz: string): Intl.DateTimeFormat => {\n\tlet formatter = formatterCache.get(tz)\n\tif (!formatter) {\n\t\tformatter = new Intl.DateTimeFormat('en-US', {\n\t\t\ttimeZone: tz,\n\t\t\thourCycle: 'h23',\n\t\t\tyear: 'numeric',\n\t\t\tmonth: '2-digit',\n\t\t\tday: '2-digit',\n\t\t\thour: '2-digit',\n\t\t\tminute: '2-digit',\n\t\t\tsecond: '2-digit',\n\t\t})\n\t\tformatterCache.set(tz, formatter)\n\t}\n\treturn formatter\n}\n\nconst zonedParts = (date: Date, tz: string): ZonedParts => {\n\tconst map: Record<string, string> = {}\n\tfor (const part of partsFormatter(tz).formatToParts(date)) {\n\t\tif (part.type !== 'literal') {\n\t\t\tmap[part.type] = part.value\n\t\t}\n\t}\n\treturn {\n\t\tyear: Number(map.year),\n\t\tmonth: Number(map.month),\n\t\tday: Number(map.day),\n\t\thour: Number(map.hour),\n\t\tminute: Number(map.minute),\n\t\tsecond: Number(map.second),\n\t}\n}\n\n/** Milliseconds `tz` is ahead of UTC at `date` (positive east of UTC). */\nconst offsetMs = (date: Date, tz: string): number => {\n\tconst p = zonedParts(date, tz)\n\tconst asUtc = Date.UTC(p.year, p.month - 1, p.day, p.hour, p.minute, p.second)\n\t// formatToParts drops sub-second precision, so compare against the truncated instant.\n\treturn asUtc - Math.floor(date.getTime() / 1000) * 1000\n}\n\nconst sameLocalDay = (date: Date, ymd: CalendarDate, tz: string): boolean => {\n\tconst p = zonedParts(date, tz)\n\treturn p.year === ymd.year && p.month === ymd.month && p.day === ymd.day\n}\n\n/** Zones found valid: checking one builds a formatter, and a read checks every scope's. */\nconst validZones = new Set<string>()\n\nconst MAX_VALID_ZONES = 1_000\n\n/** Day starts by zone and date: a read over many scopes asks for the same few again and again. */\nconst dayStarts = new Map<string, number>()\n\nconst MAX_DAY_STARTS = 20_000\n\nconst dayStartOf = (ymd: CalendarDate, tz: string): Date => {\n\tconst asUtc = Date.UTC(ymd.year, ymd.month - 1, ymd.day)\n\tconst guess = new Date(asUtc - offsetMs(new Date(asUtc), tz))\n\tconst refined = new Date(asUtc - offsetMs(guess, tz))\n\tif (sameLocalDay(refined, ymd, tz)) {\n\t\treturn refined\n\t}\n\tif (sameLocalDay(guess, ymd, tz)) {\n\t\treturn guess\n\t}\n\t// Neither candidate lands on ymd (the calendar date was skipped entirely, e.g. a\n\t// dateline change): fall forward to the later candidate's day start.\n\tconst later = refined.getTime() > guess.getTime() ? refined : guess\n\treturn dayStartOf(zonedParts(later, tz), tz)\n}\n\n/**\n * First instant of a wall-clock date in `tz`: usually local midnight, but where spring-forward\n * skips 00:00 (Chile, Cuba) it is the transition instant, local 01:00.\n */\nexport const startOfCalendarDayInTz = (ymd: CalendarDate, tz: string = DEFAULT_TIMEZONE): Date => {\n\tconst key = `${tz} ${ymd.year}-${ymd.month}-${ymd.day}`\n\tconst known = dayStarts.get(key)\n\tif (known !== undefined) {\n\t\treturn new Date(known)\n\t}\n\tconst start = dayStartOf(ymd, tz)\n\tif (dayStarts.size >= MAX_DAY_STARTS) {\n\t\tdayStarts.clear()\n\t}\n\tdayStarts.set(key, start.getTime())\n\treturn start\n}\n\nexport const startOfDayInTz = (date: Date, tz: string = DEFAULT_TIMEZONE): Date => {\n\tconst p = zonedParts(date, tz)\n\treturn startOfCalendarDayInTz(p, tz)\n}\n\n/**\n * Derived from the zoned minute and second, not a UTC hour floor, so half- and quarter-hour zones\n * (India, Nepal, Chatham) bucket on their own hours.\n */\nexport const startOfHourInTz = (date: Date, tz: string = DEFAULT_TIMEZONE): Date => {\n\tconst p = zonedParts(date, tz)\n\tconst ms = date.getTime()\n\tconst intoHour = (p.minute * 60 + p.second) * 1000 + (((ms % 1000) + 1000) % 1000)\n\treturn new Date(ms - intoHour)\n}\n\nexport const startOfMonthInTz = (date: Date, tz: string = DEFAULT_TIMEZONE): Date => {\n\tconst p = zonedParts(date, tz)\n\treturn startOfCalendarDayInTz({ year: p.year, month: p.month, day: 1 }, tz)\n}\n\nexport const startOfYearInTz = (date: Date, tz: string = DEFAULT_TIMEZONE): Date => {\n\tconst p = zonedParts(date, tz)\n\treturn startOfCalendarDayInTz({ year: p.year, month: 1, day: 1 }, tz)\n}\n\n/**\n * Day start `days` calendar days from `date`'s local day in `tz`. The +12h buffer before\n * re-flooring absorbs 23/25-hour DST days.\n */\nexport const addDaysInTz = (date: Date, days: number, tz: string = DEFAULT_TIMEZONE): Date => {\n\tconst start = startOfDayInTz(date, tz)\n\treturn startOfDayInTz(new Date(start.getTime() + days * DAY_MS + DAY_MS / 2), tz)\n}\n\n/**\n * Start of the ISO week (Monday) holding `date`'s local day in `tz`, stepped back through\n * `addDaysInTz` to stay DST-safe.\n */\nexport const startOfWeekInTz = (date: Date, tz: string = DEFAULT_TIMEZONE): Date => {\n\tconst p = zonedParts(date, tz)\n\tconst dow = new Date(Date.UTC(p.year, p.month - 1, p.day)).getUTCDay()\n\tconst mondayIndex = (dow + 6) % 7\n\treturn addDaysInTz(startOfDayInTz(date, tz), -mondayIndex, tz)\n}\n\nexport const zonedDate = (date: Date, tz: string = DEFAULT_TIMEZONE): CalendarDate => {\n\tconst p = zonedParts(date, tz)\n\treturn { year: p.year, month: p.month, day: p.day }\n}\n\n/** A date as `YYYY-MM-DD`. */\nexport const formatYmd = ({ year, month, day }: CalendarDate): string =>\n\t`${String(year).padStart(4, '0')}-${String(month).padStart(2, '0')}-${String(day).padStart(2, '0')}`\n\n/**\n * `date`'s local date in `tz` as `YYYY-MM-DD`. Not the local day start's ISO prefix: that is the\n * UTC spelling, a day early for every zone east of UTC.\n */\nexport const zonedCalendarDay = (date: Date, tz: string = DEFAULT_TIMEZONE): string =>\n\tformatYmd(zonedParts(date, tz))\n\n/** Whether the runtime's `Intl` knows `tz` as a time zone. */\nexport const isValidTimeZone = (tz: string): boolean => {\n\tif (formatterCache.has(tz) || validZones.has(tz)) {\n\t\treturn true\n\t}\n\ttry {\n\t\tnew Intl.DateTimeFormat('en-US', { timeZone: tz })\n\t} catch {\n\t\treturn false\n\t}\n\tif (validZones.size >= MAX_VALID_ZONES) {\n\t\tvalidZones.clear()\n\t}\n\tvalidZones.add(tz)\n\treturn true\n}\n"],"mappings":"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"}
@@ -1,13 +1,7 @@
1
+ import { DEFAULT_ITEM_CAPTURE } from "./config.js";
2
+ import { CURRENCY_ATTRIBUTE, DOWNLOAD_EVENT, EVENT_ATTRIBUTE, EVENT_PROP_PREFIX, GOAL_ATTRIBUTE, ITEM_ATTRIBUTE, ITEM_CLICK_EVENT, ITEM_NAME_ATTRIBUTE, OUTBOUND_EVENT, SCROLL_EVENT, VALUE_ATTRIBUTE } from "../goals/constants.js";
3
+ import { parseItemValue } from "../items/ref.js";
1
4
  //#region src/tracker/autoCapture.ts
2
- /** Event name for a click on a link leaving the site. */
3
- const OUTBOUND_EVENT = "outbound_link";
4
- /** Event name for a click on a link whose target is a file. */
5
- const DOWNLOAD_EVENT = "file_download";
6
- /** Event name for a crossed scroll threshold; `props.depth` carries which one. */
7
- const SCROLL_EVENT = "scroll_depth";
8
- const GOAL_ATTRIBUTE = "data-analytics-goal";
9
- const VALUE_ATTRIBUTE = "data-analytics-value";
10
- const CURRENCY_ATTRIBUTE = "data-analytics-currency";
11
5
  const DOWNLOAD_EXTENSIONS = new Set([
12
6
  "pdf",
13
7
  "zip",
@@ -32,10 +26,25 @@ const SCROLL_THRESHOLDS = [
32
26
  75,
33
27
  100
34
28
  ];
29
+ /**
30
+ * How long a new page has to render before its first screen counts toward its depth: by then a
31
+ * router has swapped the layout in and reset the scroll position.
32
+ */
33
+ const FIRST_SCREEN_MS = 1e3;
34
+ /**
35
+ * The item settings, with a config snapshot rendered before items existed keeping the documented
36
+ * default rather than losing them.
37
+ */
38
+ const itemCaptureOf = (options) => options.items ?? DEFAULT_ITEM_CAPTURE;
35
39
  const linkFor = (target) => target instanceof Element ? target.closest("a[href]") : null;
40
+ /**
41
+ * Scheme, host and path only: signed download links, reset tokens and session ids travel in the
42
+ * query, the fragment and the credentials.
43
+ */
44
+ const destinationOf = (url) => `${url.origin}${url.pathname}`;
36
45
  const isDownload = (url) => {
37
46
  const extension = url.pathname.split(".").pop()?.toLowerCase();
38
- return Boolean(extension) && DOWNLOAD_EXTENSIONS.has(extension);
47
+ return extension !== void 0 && DOWNLOAD_EXTENSIONS.has(extension);
39
48
  };
40
49
  const goalPayload = (el) => {
41
50
  const raw = el.getAttribute(VALUE_ATTRIBUTE)?.trim();
@@ -46,6 +55,32 @@ const goalPayload = (el) => {
46
55
  ...currency ? { currency } : {}
47
56
  };
48
57
  };
58
+ const MAX_EVENT_PROPS = 20;
59
+ const MAX_EVENT_PROP_LENGTH = 256;
60
+ /** The item an element sits in, from the nearest ancestor marked as one with a usable ref. */
61
+ const capturedItem = (target) => {
62
+ const el = target.closest(`[${ITEM_ATTRIBUTE}]`);
63
+ const ref = el?.getAttribute(ITEM_ATTRIBUTE);
64
+ if (!el || !ref || parseItemValue(ref) === null) return;
65
+ const name = el.getAttribute(ITEM_NAME_ATTRIBUTE)?.trim().slice(0, MAX_EVENT_PROP_LENGTH);
66
+ return {
67
+ item: ref,
68
+ ...name ? { itemName: name } : {}
69
+ };
70
+ };
71
+ /** `data-analytics-prop-plan="pro"` on the tagged element becomes `{ plan: 'pro' }`. */
72
+ const eventProps = (el) => {
73
+ const out = {};
74
+ let kept = 0;
75
+ for (const attr of Array.from(el.attributes)) {
76
+ if (kept >= MAX_EVENT_PROPS || !attr.name.startsWith("data-analytics-prop-")) continue;
77
+ const key = attr.name.slice(EVENT_PROP_PREFIX.length);
78
+ if (key === "") continue;
79
+ out[key] = attr.value.slice(0, MAX_EVENT_PROP_LENGTH);
80
+ kept++;
81
+ }
82
+ return kept > 0 ? out : void 0;
83
+ };
49
84
  const currentDepth = (win) => {
50
85
  const doc = win.document.documentElement;
51
86
  const height = Math.max(doc?.scrollHeight ?? 0, win.document.body?.scrollHeight ?? 0);
@@ -54,26 +89,29 @@ const currentDepth = (win) => {
54
89
  return Math.max(0, Math.min(100, Math.round(viewed / height * 100)));
55
90
  };
56
91
  /**
57
- * The delegated listeners behind `capture.autoCapture`. Everything is bound once on
58
- * `document` in the capture phase, so a handler that stops propagation (or a link that
59
- * navigates away) cannot swallow the event first, and the listener set never grows with
60
- * the DOM.
61
- *
62
- * A link that is both outbound and a download reports both, matching how the vendors
63
- * ship those as two independent extensions; turning one toggle off never changes what
64
- * the other counts.
65
- *
66
- * Scroll thresholds are evaluated on scroll only, never on load or on a route change, so
67
- * a fresh page whose DOM has not rendered yet cannot inherit the previous page's depth.
68
- * The max fed into the pageview still folds in the position at read time, so a page too
69
- * short to scroll still reports its depth.
92
+ * The delegated listeners behind `capture.autoCapture`, bound once on `document` in the capture
93
+ * phase so a handler that stops propagation, or a link that navigates away, cannot swallow one.
70
94
  */
71
95
  const createAutoCapture = (args) => {
72
96
  const { win, options, handlers } = args;
73
97
  const doc = win.document;
98
+ const items = itemCaptureOf(options);
99
+ const credits = items.impressions || items.clicks || items.pages;
74
100
  let maxDepth = 0;
75
101
  let fired = /* @__PURE__ */ new Set();
102
+ let clicked = /* @__PURE__ */ new Set();
103
+ let frame = null;
104
+ let cancelFirstScreen = null;
105
+ const onItemClick = (target) => {
106
+ if (!(target instanceof Element)) return;
107
+ const captured = capturedItem(target);
108
+ if (captured && !clicked.has(captured.item)) {
109
+ clicked.add(captured.item);
110
+ handlers.track(ITEM_CLICK_EVENT, void 0, captured);
111
+ }
112
+ };
76
113
  const onClick = (event) => {
114
+ if (items.clicks) onItemClick(event.target);
77
115
  const link = linkFor(event.target);
78
116
  if (link) {
79
117
  let url = null;
@@ -83,40 +121,89 @@ const createAutoCapture = (args) => {
83
121
  url = null;
84
122
  }
85
123
  if (url && (url.protocol === "http:" || url.protocol === "https:")) {
86
- if (options.outboundLinks && url.origin !== win.location.origin) handlers.track(OUTBOUND_EVENT, { url: url.href });
87
- if (options.fileDownloads && isDownload(url)) handlers.track(DOWNLOAD_EVENT, { url: url.href });
124
+ const destination = destinationOf(url);
125
+ if (options.outboundLinks && url.origin !== win.location.origin) handlers.track(OUTBOUND_EVENT, { url: destination });
126
+ if (options.fileDownloads && isDownload(url)) handlers.track(DOWNLOAD_EVENT, { url: destination });
88
127
  }
89
128
  }
90
129
  if (!options.goalAttribute) return;
91
- const goalEl = event.target instanceof Element ? event.target.closest(`[${GOAL_ATTRIBUTE}]`) : null;
92
- const slug = goalEl?.getAttribute(GOAL_ATTRIBUTE);
93
- if (goalEl && slug) handlers.trackGoal(slug, goalPayload(goalEl));
130
+ fireTagged(event.target, "click");
94
131
  };
95
132
  const onSubmit = (event) => {
96
- const form = event.target instanceof Element ? event.target.closest(`[${GOAL_ATTRIBUTE}]`) : null;
97
- const slug = form?.getAttribute(GOAL_ATTRIBUTE);
98
- if (form && slug) handlers.trackGoal(slug, goalPayload(form));
133
+ fireTagged(event.target, "submit");
99
134
  };
100
- const onScroll = () => {
101
- const depth = currentDepth(win);
102
- if (depth <= maxDepth) return;
103
- maxDepth = depth;
135
+ /**
136
+ * Each attribute is read from its nearest tagged ancestor, so a card or form can be tagged at its
137
+ * root. A tagged form answers only its own submit; goal and event are looked up independently.
138
+ */
139
+ const fireTagged = (target, trigger) => {
140
+ if (!(target instanceof Element)) return;
141
+ const answers = (el) => el !== null && (trigger === "submit" ? el === target : el.localName !== "form");
142
+ const captured = credits ? capturedItem(target) : void 0;
143
+ const goalEl = target.closest(`[${GOAL_ATTRIBUTE}]`);
144
+ const slug = goalEl?.getAttribute(GOAL_ATTRIBUTE);
145
+ if (answers(goalEl) && slug) handlers.trackGoal(slug, {
146
+ ...goalPayload(goalEl),
147
+ ...captured
148
+ });
149
+ const eventEl = target.closest(`[${EVENT_ATTRIBUTE}]`);
150
+ const name = eventEl?.getAttribute(EVENT_ATTRIBUTE);
151
+ if (answers(eventEl) && name) if (captured) handlers.track(name, eventProps(eventEl), captured);
152
+ else handlers.track(name, eventProps(eventEl));
153
+ };
154
+ /** A layout read in a document being torn down can throw; that moment measures nothing. */
155
+ const measure = () => {
156
+ let depth;
157
+ try {
158
+ depth = currentDepth(win);
159
+ } catch {
160
+ return;
161
+ }
162
+ maxDepth = Math.max(maxDepth, depth);
163
+ return depth;
164
+ };
165
+ const onScrollFrame = () => {
166
+ frame = null;
167
+ const depth = measure();
168
+ if (depth === void 0) return;
104
169
  for (const threshold of SCROLL_THRESHOLDS) if (depth >= threshold && !fired.has(threshold)) {
105
170
  fired.add(threshold);
106
171
  handlers.track(SCROLL_EVENT, { depth: threshold });
107
172
  }
108
173
  };
109
- const clickBound = options.outboundLinks || options.fileDownloads || options.goalAttribute;
174
+ const onScroll = () => {
175
+ frame ??= win.requestAnimationFrame(onScrollFrame);
176
+ };
177
+ const cancelPending = () => {
178
+ if (frame !== null) {
179
+ win.cancelAnimationFrame(frame);
180
+ frame = null;
181
+ }
182
+ cancelFirstScreen?.();
183
+ cancelFirstScreen = null;
184
+ };
185
+ const measureFirstScreen = () => {
186
+ const timer = win.setTimeout(() => {
187
+ cancelFirstScreen = null;
188
+ measure();
189
+ }, FIRST_SCREEN_MS);
190
+ cancelFirstScreen = () => win.clearTimeout(timer);
191
+ };
192
+ const clickBound = options.outboundLinks || options.fileDownloads || options.goalAttribute || items.clicks;
110
193
  if (clickBound) doc.addEventListener("click", onClick, true);
111
194
  if (options.goalAttribute) doc.addEventListener("submit", onSubmit, true);
112
195
  if (options.scrollDepth) win.addEventListener("scroll", onScroll, { passive: true });
113
196
  return {
114
- scrollDepth: () => options.scrollDepth ? Math.max(maxDepth, currentDepth(win)) : void 0,
197
+ scrollDepth: () => options.scrollDepth ? maxDepth : void 0,
115
198
  resetPage() {
199
+ cancelPending();
116
200
  maxDepth = 0;
117
201
  fired = /* @__PURE__ */ new Set();
202
+ clicked = /* @__PURE__ */ new Set();
203
+ if (options.scrollDepth) measureFirstScreen();
118
204
  },
119
205
  destroy() {
206
+ cancelPending();
120
207
  if (clickBound) doc.removeEventListener("click", onClick, true);
121
208
  if (options.goalAttribute) doc.removeEventListener("submit", onSubmit, true);
122
209
  if (options.scrollDepth) win.removeEventListener("scroll", onScroll);
@@ -124,6 +211,6 @@ const createAutoCapture = (args) => {
124
211
  };
125
212
  };
126
213
  //#endregion
127
- export { DOWNLOAD_EVENT, GOAL_ATTRIBUTE, OUTBOUND_EVENT, SCROLL_EVENT, createAutoCapture };
214
+ export { createAutoCapture, itemCaptureOf };
128
215
 
129
216
  //# sourceMappingURL=autoCapture.js.map