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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (1241) hide show
  1. package/CHANGELOG.md +463 -0
  2. package/README.md +30 -37
  3. package/dist/access/adminUser.d.ts +15 -0
  4. package/dist/access/adminUser.js +13 -0
  5. package/dist/access/adminUser.js.map +1 -0
  6. package/dist/access/decideOnce.js +16 -0
  7. package/dist/access/decideOnce.js.map +1 -0
  8. package/dist/access/membership.d.ts +23 -0
  9. package/dist/access/membership.js +63 -0
  10. package/dist/access/membership.js.map +1 -0
  11. package/dist/access/principal.d.ts +37 -0
  12. package/dist/access/principal.js +29 -0
  13. package/dist/access/principal.js.map +1 -0
  14. package/dist/access/readGate.js +16 -0
  15. package/dist/access/readGate.js.map +1 -0
  16. package/dist/adapters/ga4/disableKey.js +7 -9
  17. package/dist/adapters/ga4/disableKey.js.map +1 -1
  18. package/dist/adapters/ga4/eventName.d.ts +2 -8
  19. package/dist/adapters/ga4/eventName.js +2 -8
  20. package/dist/adapters/ga4/eventName.js.map +1 -1
  21. package/dist/adapters/ga4/ga4.d.ts +11 -0
  22. package/dist/adapters/ga4/ga4.js +206 -123
  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 +13 -13
  36. package/dist/adapters/plausible/plausible.js +137 -122
  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 +20 -9
  41. package/dist/adapters/posthog/posthog.js +179 -113
  42. package/dist/adapters/posthog/posthog.js.map +1 -1
  43. package/dist/adapters/readTime.js +7 -0
  44. package/dist/adapters/readTime.js.map +1 -0
  45. package/dist/adapters/series.js +14 -8
  46. package/dist/adapters/series.js.map +1 -1
  47. package/dist/adapters/umami/umami.d.ts +7 -9
  48. package/dist/adapters/umami/umami.js +184 -172
  49. package/dist/adapters/umami/umami.js.map +1 -1
  50. package/dist/adapters/upstream.js +16 -0
  51. package/dist/adapters/upstream.js.map +1 -0
  52. package/dist/binding/report.d.ts +8 -0
  53. package/dist/binding/report.js +24 -0
  54. package/dist/binding/report.js.map +1 -0
  55. package/dist/binding/resolvePath.js +16 -29
  56. package/dist/binding/resolvePath.js.map +1 -1
  57. package/dist/binding/types.d.ts +14 -29
  58. package/dist/capture/captureRequest.js +28 -0
  59. package/dist/capture/captureRequest.js.map +1 -0
  60. package/dist/capture/exclusionEndpoint.js +98 -0
  61. package/dist/capture/exclusionEndpoint.js.map +1 -0
  62. package/dist/capture/exclusionPrelude.js +14 -0
  63. package/dist/capture/exclusionPrelude.js.map +1 -0
  64. package/dist/capture/exclusionToken.js +23 -0
  65. package/dist/capture/exclusionToken.js.map +1 -0
  66. package/dist/capture/jsLiteral.js +19 -0
  67. package/dist/capture/jsLiteral.js.map +1 -0
  68. package/dist/capture/mountPath.js +2 -3
  69. package/dist/capture/mountPath.js.map +1 -1
  70. package/dist/capture/proxyEndpoint.js +48 -95
  71. package/dist/capture/proxyEndpoint.js.map +1 -1
  72. package/dist/capture/proxyRoutes.js +58 -21
  73. package/dist/capture/proxyRoutes.js.map +1 -1
  74. package/dist/capture/relay.js +91 -0
  75. package/dist/capture/relay.js.map +1 -0
  76. package/dist/capture/requestBody.js +2 -6
  77. package/dist/capture/requestBody.js.map +1 -1
  78. package/dist/capture/requestTrust.js +45 -0
  79. package/dist/capture/requestTrust.js.map +1 -0
  80. package/dist/capture/sameSite.js +40 -0
  81. package/dist/capture/sameSite.js.map +1 -0
  82. package/dist/capture/slots.js +50 -25
  83. package/dist/capture/slots.js.map +1 -1
  84. package/dist/capture/trackerConfig.js +100 -36
  85. package/dist/capture/trackerConfig.js.map +1 -1
  86. package/dist/capture/trackerEndpoint.js +22 -21
  87. package/dist/capture/trackerEndpoint.js.map +1 -1
  88. package/dist/charts/BarList.d.ts +27 -14
  89. package/dist/charts/BarList.js +38 -83
  90. package/dist/charts/BarList.js.map +1 -1
  91. package/dist/charts/TrendChart.d.ts +40 -7
  92. package/dist/charts/TrendChart.js +243 -215
  93. package/dist/charts/TrendChart.js.map +1 -1
  94. package/dist/charts/bars.d.ts +15 -1
  95. package/dist/charts/bars.js +12 -12
  96. package/dist/charts/bars.js.map +1 -1
  97. package/dist/charts/bucket.js +106 -73
  98. package/dist/charts/bucket.js.map +1 -1
  99. package/dist/charts/inProgress.js +22 -0
  100. package/dist/charts/inProgress.js.map +1 -0
  101. package/dist/charts/series.d.ts +15 -0
  102. package/dist/charts/series.js +123 -0
  103. package/dist/charts/series.js.map +1 -0
  104. package/dist/charts/spline.js +91 -25
  105. package/dist/charts/spline.js.map +1 -1
  106. package/dist/charts/trendGeometry.js +91 -0
  107. package/dist/charts/trendGeometry.js.map +1 -0
  108. package/dist/core/adminOptions.d.ts +1 -0
  109. package/dist/core/adminOptions.js +193 -0
  110. package/dist/core/adminOptions.js.map +1 -0
  111. package/dist/core/budget.js +24 -0
  112. package/dist/core/budget.js.map +1 -0
  113. package/dist/core/cacheKey.d.ts +1 -0
  114. package/dist/core/cacheKey.js +48 -37
  115. package/dist/core/cacheKey.js.map +1 -1
  116. package/dist/core/cacheOptions.js +165 -0
  117. package/dist/core/cacheOptions.js.map +1 -0
  118. package/dist/core/capabilities.d.ts +24 -11
  119. package/dist/core/capabilities.js +96 -17
  120. package/dist/core/capabilities.js.map +1 -1
  121. package/dist/core/capture.d.ts +26 -25
  122. package/dist/core/captureOptions.d.ts +1 -0
  123. package/dist/core/captureOptions.js +258 -0
  124. package/dist/core/captureOptions.js.map +1 -0
  125. package/dist/core/clock.js +13 -0
  126. package/dist/core/clock.js.map +1 -0
  127. package/dist/core/collectionOption.d.ts +17 -0
  128. package/dist/core/collectionOption.js +104 -0
  129. package/dist/core/collectionOption.js.map +1 -0
  130. package/dist/core/collectionSlug.js +7 -0
  131. package/dist/core/collectionSlug.js.map +1 -0
  132. package/dist/core/contract.d.ts +285 -59
  133. package/dist/core/contract.js +6 -4
  134. package/dist/core/contract.js.map +1 -1
  135. package/dist/core/cron.js +57 -0
  136. package/dist/core/cron.js.map +1 -0
  137. package/dist/core/fetch.d.ts +17 -0
  138. package/dist/core/goalOptions.d.ts +1 -0
  139. package/dist/core/goalOptions.js +166 -0
  140. package/dist/core/goalOptions.js.map +1 -0
  141. package/dist/core/granularity.js +3 -2
  142. package/dist/core/granularity.js.map +1 -1
  143. package/dist/core/guards.js +17 -0
  144. package/dist/core/guards.js.map +1 -0
  145. package/dist/core/jobs.d.ts +40 -0
  146. package/dist/core/jobs.js +132 -0
  147. package/dist/core/jobs.js.map +1 -0
  148. package/dist/core/legacyOptions.js +145 -0
  149. package/dist/core/legacyOptions.js.map +1 -0
  150. package/dist/core/metricAliases.js +81 -0
  151. package/dist/core/metricAliases.js.map +1 -0
  152. package/dist/core/metricValues.js +57 -0
  153. package/dist/core/metricValues.js.map +1 -0
  154. package/dist/core/monotonic.js +10 -0
  155. package/dist/core/monotonic.js.map +1 -0
  156. package/dist/core/optionChecks.js +51 -0
  157. package/dist/core/optionChecks.js.map +1 -0
  158. package/dist/core/options.d.ts +473 -157
  159. package/dist/core/options.js +154 -219
  160. package/dist/core/options.js.map +1 -1
  161. package/dist/core/registry.js +45 -5
  162. package/dist/core/registry.js.map +1 -1
  163. package/dist/core/scopeList.js +7 -9
  164. package/dist/core/scopeList.js.map +1 -1
  165. package/dist/core/scopeOptions.d.ts +1 -0
  166. package/dist/core/scopeOptions.js +112 -0
  167. package/dist/core/scopeOptions.js.map +1 -0
  168. package/dist/core/scopedRead.js +182 -72
  169. package/dist/core/scopedRead.js.map +1 -1
  170. package/dist/core/sdks.d.ts +81 -0
  171. package/dist/core/sdks.js +23 -0
  172. package/dist/core/sdks.js.map +1 -0
  173. package/dist/core/serverEvent.d.ts +38 -20
  174. package/dist/core/serverEvent.js.map +1 -1
  175. package/dist/core/siteAddress.js +20 -0
  176. package/dist/core/siteAddress.js.map +1 -0
  177. package/dist/core/sourceErrors.js +109 -0
  178. package/dist/core/sourceErrors.js.map +1 -0
  179. package/dist/core/sourceOptions.js +94 -0
  180. package/dist/core/sourceOptions.js.map +1 -0
  181. package/dist/core/throttle.js +18 -0
  182. package/dist/core/throttle.js.map +1 -0
  183. package/dist/core/values.js +61 -0
  184. package/dist/core/values.js.map +1 -0
  185. package/dist/core/widgetSlugs.d.ts +17 -0
  186. package/dist/core/widgetSlugs.js +29 -0
  187. package/dist/core/widgetSlugs.js.map +1 -0
  188. package/dist/db/detachedWrite.js +36 -0
  189. package/dist/db/detachedWrite.js.map +1 -0
  190. package/dist/db/errors.js +182 -0
  191. package/dist/db/errors.js.map +1 -0
  192. package/dist/db/kind.js +32 -0
  193. package/dist/db/kind.js.map +1 -0
  194. package/dist/db/openTransaction.js +51 -0
  195. package/dist/db/openTransaction.js.map +1 -0
  196. package/dist/exports/adapters/contract.d.ts +14 -0
  197. package/dist/exports/adapters/ga4.d.ts +15 -1
  198. package/dist/exports/adapters/native.d.ts +26 -2
  199. package/dist/exports/adapters/native.js +4 -1
  200. package/dist/exports/adapters/plausible.d.ts +15 -1
  201. package/dist/exports/adapters/posthog.d.ts +15 -1
  202. package/dist/exports/adapters/umami.d.ts +15 -1
  203. package/dist/exports/attributes.d.ts +42 -0
  204. package/dist/exports/attributes.js +83 -0
  205. package/dist/exports/attributes.js.map +1 -0
  206. package/dist/exports/client.d.ts +41 -13
  207. package/dist/exports/client.js +21 -9
  208. package/dist/exports/geo.d.ts +3 -1
  209. package/dist/exports/geo.js +1 -1
  210. package/dist/exports/i18n.d.ts +2 -2
  211. package/dist/exports/i18n.js +2 -2
  212. package/dist/exports/migrations.d.ts +2 -0
  213. package/dist/exports/migrations.js +2 -0
  214. package/dist/exports/next.d.ts +18 -1
  215. package/dist/exports/next.js +3 -1
  216. package/dist/exports/react.d.ts +3 -2
  217. package/dist/exports/react.js +1 -2
  218. package/dist/exports/rsc.d.ts +31 -14
  219. package/dist/exports/rsc.js +11 -6
  220. package/dist/exports/site.d.ts +5 -0
  221. package/dist/exports/site.js +3 -0
  222. package/dist/exports/testing.d.ts +17 -0
  223. package/dist/exports/testing.js +3 -0
  224. package/dist/exports/tracker.d.ts +5 -20
  225. package/dist/exports/tracker.js +3 -14
  226. package/dist/exports/types.d.ts +40 -14
  227. package/dist/exports/types.js +5 -1
  228. package/dist/fields/AnalyticsPanelClient.js +265 -154
  229. package/dist/fields/AnalyticsPanelClient.js.map +1 -1
  230. package/dist/fields/AnalyticsPanelField.d.ts +20 -8
  231. package/dist/fields/AnalyticsPanelField.js +121 -30
  232. package/dist/fields/AnalyticsPanelField.js.map +1 -1
  233. package/dist/fields/AnalyticsStatField.d.ts +18 -7
  234. package/dist/fields/AnalyticsStatField.js +98 -63
  235. package/dist/fields/AnalyticsStatField.js.map +1 -1
  236. package/dist/fields/FieldShimmer.js +15 -0
  237. package/dist/fields/FieldShimmer.js.map +1 -0
  238. package/dist/fields/PanelContent.js +217 -0
  239. package/dist/fields/PanelContent.js.map +1 -0
  240. package/dist/fields/PanelList.js +82 -0
  241. package/dist/fields/PanelList.js.map +1 -0
  242. package/dist/fields/PanelLiveCounter.js +63 -0
  243. package/dist/fields/PanelLiveCounter.js.map +1 -0
  244. package/dist/fields/PanelSkeleton.js +63 -0
  245. package/dist/fields/PanelSkeleton.js.map +1 -0
  246. package/dist/fields/componentPaths.js +8 -0
  247. package/dist/fields/componentPaths.js.map +1 -0
  248. package/dist/fields/config/FilterDimensionSelectField.d.ts +2 -2
  249. package/dist/fields/config/FilterDimensionSelectField.js +26 -54
  250. package/dist/fields/config/FilterDimensionSelectField.js.map +1 -1
  251. package/dist/fields/config/FilterKeySelect.js +66 -0
  252. package/dist/fields/config/FilterKeySelect.js.map +1 -0
  253. package/dist/fields/config/FilterOperatorSelectField.d.ts +7 -2
  254. package/dist/fields/config/FilterOperatorSelectField.js +37 -53
  255. package/dist/fields/config/FilterOperatorSelectField.js.map +1 -1
  256. package/dist/fields/config/FilterValueField.d.ts +17 -0
  257. package/dist/fields/config/FilterValueField.js +130 -0
  258. package/dist/fields/config/FilterValueField.js.map +1 -0
  259. package/dist/fields/config/MetricSelectField.d.ts +5 -12
  260. package/dist/fields/config/MetricSelectField.js +18 -30
  261. package/dist/fields/config/MetricSelectField.js.map +1 -1
  262. package/dist/fields/config/OptionSelect.js +52 -0
  263. package/dist/fields/config/OptionSelect.js.map +1 -0
  264. package/dist/fields/config/SourceSelectField.js +16 -31
  265. package/dist/fields/config/SourceSelectField.js.map +1 -1
  266. package/dist/fields/config/fetchSources.js +14 -26
  267. package/dist/fields/config/fetchSources.js.map +1 -1
  268. package/dist/fields/config/filterValues.js +106 -0
  269. package/dist/fields/config/filterValues.js.map +1 -0
  270. package/dist/fields/config/narrow.js +8 -10
  271. package/dist/fields/config/narrow.js.map +1 -1
  272. package/dist/fields/config/retiredPickers.d.ts +45 -0
  273. package/dist/fields/config/retiredPickers.js +46 -0
  274. package/dist/fields/config/retiredPickers.js.map +1 -0
  275. package/dist/fields/config/scopedFields.d.ts +40 -0
  276. package/dist/fields/config/scopedFields.js +68 -0
  277. package/dist/fields/config/scopedFields.js.map +1 -0
  278. package/dist/fields/config/toSelectOption.js +13 -7
  279. package/dist/fields/config/toSelectOption.js.map +1 -1
  280. package/dist/fields/config/useAnalyticsSources.d.ts +5 -7
  281. package/dist/fields/config/useAnalyticsSources.js +17 -21
  282. package/dist/fields/config/useAnalyticsSources.js.map +1 -1
  283. package/dist/fields/config/useFilterCapabilities.d.ts +9 -6
  284. package/dist/fields/config/useFilterCapabilities.js +23 -15
  285. package/dist/fields/config/useFilterCapabilities.js.map +1 -1
  286. package/dist/fields/config/useFormString.js +12 -0
  287. package/dist/fields/config/useFormString.js.map +1 -0
  288. package/dist/fields/dateRange/field.js +7 -19
  289. package/dist/fields/dateRange/field.js.map +1 -1
  290. package/dist/fields/dateRange/types.d.ts +5 -1
  291. package/dist/fields/dateRange/ui.d.ts +3 -2
  292. package/dist/fields/dateRange/ui.js +57 -319
  293. package/dist/fields/dateRange/ui.js.map +1 -1
  294. package/dist/fields/documentScope.js +21 -0
  295. package/dist/fields/documentScope.js.map +1 -0
  296. package/dist/fields/emptyState.js +31 -26
  297. package/dist/fields/emptyState.js.map +1 -1
  298. package/dist/fields/factories.d.ts +35 -16
  299. package/dist/fields/factories.js +66 -37
  300. package/dist/fields/factories.js.map +1 -1
  301. package/dist/fields/format.d.ts +12 -3
  302. package/dist/fields/format.js +77 -13
  303. package/dist/fields/format.js.map +1 -1
  304. package/dist/fields/itemReport.js +45 -0
  305. package/dist/fields/itemReport.js.map +1 -0
  306. package/dist/fields/readForDocument.d.ts +78 -26
  307. package/dist/fields/readForDocument.js +446 -116
  308. package/dist/fields/readForDocument.js.map +1 -1
  309. package/dist/fields/stateKeys.js +20 -0
  310. package/dist/fields/stateKeys.js.map +1 -0
  311. package/dist/goals/GoalAmountField.d.ts +10 -0
  312. package/dist/goals/GoalAmountField.js +162 -0
  313. package/dist/goals/GoalAmountField.js.map +1 -0
  314. package/dist/goals/GoalSelectField.js +89 -40
  315. package/dist/goals/GoalSelectField.js.map +1 -1
  316. package/dist/goals/GoalSelectFieldServer.d.ts +13 -0
  317. package/dist/goals/GoalSelectFieldServer.js +21 -0
  318. package/dist/goals/GoalSelectFieldServer.js.map +1 -0
  319. package/dist/goals/amountField.d.ts +20 -0
  320. package/dist/goals/amountField.js +37 -0
  321. package/dist/goals/amountField.js.map +1 -0
  322. package/dist/goals/builtin.js +17 -0
  323. package/dist/goals/builtin.js.map +1 -0
  324. package/dist/goals/collection.d.ts +22 -0
  325. package/dist/goals/collection.js +141 -100
  326. package/dist/goals/collection.js.map +1 -1
  327. package/dist/goals/constants.d.ts +38 -0
  328. package/dist/goals/constants.js +49 -0
  329. package/dist/goals/constants.js.map +1 -0
  330. package/dist/goals/currency.d.ts +16 -0
  331. package/dist/goals/currency.js +46 -4
  332. package/dist/goals/currency.js.map +1 -1
  333. package/dist/goals/currencyOptions.js +70 -0
  334. package/dist/goals/currencyOptions.js.map +1 -0
  335. package/dist/goals/fetchGoals.d.ts +10 -0
  336. package/dist/goals/fetchGoals.js +12 -26
  337. package/dist/goals/fetchGoals.js.map +1 -1
  338. package/dist/goals/goalField.d.ts +4 -6
  339. package/dist/goals/goalField.js +9 -19
  340. package/dist/goals/goalField.js.map +1 -1
  341. package/dist/goals/goalsEndpoint.js +39 -40
  342. package/dist/goals/goalsEndpoint.js.map +1 -1
  343. package/dist/goals/items.js +35 -0
  344. package/dist/goals/items.js.map +1 -0
  345. package/dist/goals/latent.js +9 -0
  346. package/dist/goals/latent.js.map +1 -0
  347. package/dist/goals/linkFields.d.ts +35 -0
  348. package/dist/goals/linkFields.js +31 -0
  349. package/dist/goals/linkFields.js.map +1 -0
  350. package/dist/goals/match.d.ts +14 -0
  351. package/dist/goals/match.js +67 -46
  352. package/dist/goals/match.js.map +1 -1
  353. package/dist/goals/moneyFields.js +56 -0
  354. package/dist/goals/moneyFields.js.map +1 -0
  355. package/dist/goals/pathMatch.js +122 -0
  356. package/dist/goals/pathMatch.js.map +1 -0
  357. package/dist/goals/placeholder.js +12 -0
  358. package/dist/goals/placeholder.js.map +1 -0
  359. package/dist/goals/resolver.d.ts +3 -3
  360. package/dist/goals/resolver.js +154 -46
  361. package/dist/goals/resolver.js.map +1 -1
  362. package/dist/goals/serverRevenue.d.ts +60 -0
  363. package/dist/goals/serverRevenue.js +41 -0
  364. package/dist/goals/serverRevenue.js.map +1 -0
  365. package/dist/goals/trackGoalAction.d.ts +26 -27
  366. package/dist/goals/trackGoalAction.js +38 -52
  367. package/dist/goals/trackGoalAction.js.map +1 -1
  368. package/dist/goals/types.d.ts +13 -28
  369. package/dist/goals/types.js +1 -1
  370. package/dist/goals/types.js.map +1 -1
  371. package/dist/goals/useAnalyticsGoals.d.ts +6 -5
  372. package/dist/goals/useAnalyticsGoals.js +17 -18
  373. package/dist/goals/useAnalyticsGoals.js.map +1 -1
  374. package/dist/index.d.ts +63 -11
  375. package/dist/index.js +257 -247
  376. package/dist/index.js.map +1 -1
  377. package/dist/items/collectionIdType.js +20 -0
  378. package/dist/items/collectionIdType.js.map +1 -0
  379. package/dist/items/idType.js +31 -0
  380. package/dist/items/idType.js.map +1 -0
  381. package/dist/items/ref.js +73 -0
  382. package/dist/items/ref.js.map +1 -0
  383. package/dist/maintenance/apiTaskState.js +141 -0
  384. package/dist/maintenance/apiTaskState.js.map +1 -0
  385. package/dist/maintenance/heartbeat.js +51 -0
  386. package/dist/maintenance/heartbeat.js.map +1 -0
  387. package/dist/maintenance/lease.d.ts +1 -0
  388. package/dist/maintenance/lease.js +81 -0
  389. package/dist/maintenance/lease.js.map +1 -0
  390. package/dist/maintenance/taskSchedule.d.ts +1 -0
  391. package/dist/maintenance/taskSchedule.js +62 -0
  392. package/dist/maintenance/taskSchedule.js.map +1 -0
  393. package/dist/maintenance/underLease.js +35 -0
  394. package/dist/maintenance/underLease.js.map +1 -0
  395. package/dist/migrations/legacy.d.ts +54 -0
  396. package/dist/migrations/legacy.js +117 -0
  397. package/dist/migrations/legacy.js.map +1 -0
  398. package/dist/migrations/predefined/dropLegacyMongo.d.ts +11 -0
  399. package/dist/migrations/predefined/dropLegacyMongo.js +12 -0
  400. package/dist/migrations/predefined/dropLegacyMongo.js.map +1 -0
  401. package/dist/native/collections/aggregates.js +54 -0
  402. package/dist/native/collections/aggregates.js.map +1 -0
  403. package/dist/native/collections/hits.js +102 -0
  404. package/dist/native/collections/hits.js.map +1 -0
  405. package/dist/native/collections/slugs.d.ts +10 -0
  406. package/dist/native/collections/slugs.js +16 -0
  407. package/dist/native/collections/slugs.js.map +1 -0
  408. package/dist/native/collections/state.js +84 -0
  409. package/dist/native/collections/state.js.map +1 -0
  410. package/dist/native/collections/storeCollection.js +29 -0
  411. package/dist/native/collections/storeCollection.js.map +1 -0
  412. package/dist/native/engine/buckets.d.ts +1 -0
  413. package/dist/native/engine/buckets.js +53 -0
  414. package/dist/native/engine/buckets.js.map +1 -0
  415. package/dist/native/engine/capabilities.js +87 -0
  416. package/dist/native/engine/capabilities.js.map +1 -0
  417. package/dist/native/engine/cost.js +72 -0
  418. package/dist/native/engine/cost.js.map +1 -0
  419. package/dist/native/engine/days.d.ts +1 -0
  420. package/dist/native/engine/days.js +182 -0
  421. package/dist/native/engine/days.js.map +1 -0
  422. package/dist/native/engine/engine.d.ts +1 -0
  423. package/dist/native/engine/engine.js +1623 -0
  424. package/dist/native/engine/engine.js.map +1 -0
  425. package/dist/native/engine/instance.js +58 -0
  426. package/dist/native/engine/instance.js.map +1 -0
  427. package/dist/native/engine/maintenance.d.ts +1 -0
  428. package/dist/native/engine/maintenance.js +677 -0
  429. package/dist/native/engine/maintenance.js.map +1 -0
  430. package/dist/native/engine/merge.js +41 -0
  431. package/dist/native/engine/merge.js.map +1 -0
  432. package/dist/native/engine/nudge.js +26 -0
  433. package/dist/native/engine/nudge.js.map +1 -0
  434. package/dist/native/engine/planner.js +198 -0
  435. package/dist/native/engine/planner.js.map +1 -0
  436. package/dist/native/engine/rebuild.d.ts +22 -0
  437. package/dist/native/engine/rebuild.js +76 -0
  438. package/dist/native/engine/rebuild.js.map +1 -0
  439. package/dist/native/engine/recent.js +17 -0
  440. package/dist/native/engine/recent.js.map +1 -0
  441. package/dist/native/engine/salt.d.ts +1 -0
  442. package/dist/native/engine/salt.js +98 -0
  443. package/dist/native/engine/salt.js.map +1 -0
  444. package/dist/native/engine/siteHosts.d.ts +1 -0
  445. package/dist/native/engine/siteHosts.js +58 -0
  446. package/dist/native/engine/siteHosts.js.map +1 -0
  447. package/dist/native/engine/toHit.js +108 -0
  448. package/dist/native/engine/toHit.js.map +1 -0
  449. package/dist/native/engine/writeBuffer.d.ts +14 -0
  450. package/dist/native/engine/writeBuffer.js +317 -0
  451. package/dist/native/engine/writeBuffer.js.map +1 -0
  452. package/dist/native/geo/composeGeoResolvers.d.ts +1 -0
  453. package/dist/native/geo/composeGeoResolvers.js +4 -1
  454. package/dist/native/geo/composeGeoResolvers.js.map +1 -1
  455. package/dist/native/geo/geoResolver.d.ts +20 -2
  456. package/dist/native/geo/geoResolver.js +42 -6
  457. package/dist/native/geo/geoResolver.js.map +1 -1
  458. package/dist/native/geo/maxmindResolver.d.ts +8 -4
  459. package/dist/native/geo/maxmindResolver.js +20 -16
  460. package/dist/native/geo/maxmindResolver.js.map +1 -1
  461. package/dist/native/geo/resolveGeo.js +31 -0
  462. package/dist/native/geo/resolveGeo.js.map +1 -0
  463. package/dist/native/ingest/bots.d.ts +2 -3
  464. package/dist/native/ingest/bots.js +8 -13
  465. package/dist/native/ingest/bots.js.map +1 -1
  466. package/dist/native/ingest/browser.js +4 -6
  467. package/dist/native/ingest/browser.js.map +1 -1
  468. package/dist/native/ingest/clientIp.js +30 -9
  469. package/dist/native/ingest/clientIp.js.map +1 -1
  470. package/dist/native/ingest/device.js +4 -6
  471. package/dist/native/ingest/device.js.map +1 -1
  472. package/dist/native/ingest/endpoint.d.ts +1 -1
  473. package/dist/native/ingest/endpoint.js +119 -34
  474. package/dist/native/ingest/endpoint.js.map +1 -1
  475. package/dist/native/ingest/itemSignature.d.ts +26 -0
  476. package/dist/native/ingest/itemSignature.js +45 -0
  477. package/dist/native/ingest/itemSignature.js.map +1 -0
  478. package/dist/native/ingest/language.js +2 -3
  479. package/dist/native/ingest/language.js.map +1 -1
  480. package/dist/native/ingest/normalizeEvent.d.ts +60 -7
  481. package/dist/native/ingest/normalizeEvent.js +226 -61
  482. package/dist/native/ingest/normalizeEvent.js.map +1 -1
  483. package/dist/native/ingest/orderSignature.d.ts +13 -0
  484. package/dist/native/ingest/orderSignature.js +50 -0
  485. package/dist/native/ingest/orderSignature.js.map +1 -0
  486. package/dist/native/ingest/referrer.js +30 -32
  487. package/dist/native/ingest/referrer.js.map +1 -1
  488. package/dist/native/ingest/requestHost.js +10 -23
  489. package/dist/native/ingest/requestHost.js.map +1 -1
  490. package/dist/native/ingest/resolveHostname.d.ts +4 -13
  491. package/dist/native/ingest/resolveHostname.js +5 -6
  492. package/dist/native/ingest/resolveHostname.js.map +1 -1
  493. package/dist/native/ingest/revenue.d.ts +1 -0
  494. package/dist/native/ingest/revenue.js +121 -0
  495. package/dist/native/ingest/revenue.js.map +1 -0
  496. package/dist/native/ingest/route.d.ts +10 -0
  497. package/dist/native/ingest/route.js +82 -0
  498. package/dist/native/ingest/route.js.map +1 -0
  499. package/dist/native/ingest/serverTrack.d.ts +2 -10
  500. package/dist/native/ingest/serverTrack.js +181 -72
  501. package/dist/native/ingest/serverTrack.js.map +1 -1
  502. package/dist/native/ingest/signature.js +28 -0
  503. package/dist/native/ingest/signature.js.map +1 -0
  504. package/dist/native/ingest/source.d.ts +2 -3
  505. package/dist/native/ingest/source.js +35 -54
  506. package/dist/native/ingest/source.js.map +1 -1
  507. package/dist/native/ingest/utm.js +9 -9
  508. package/dist/native/ingest/utm.js.map +1 -1
  509. package/dist/native/ingest/validate.js +20 -10
  510. package/dist/native/ingest/validate.js.map +1 -1
  511. package/dist/native/ingest/visitorHash.js +6 -8
  512. package/dist/native/ingest/visitorHash.js.map +1 -1
  513. package/dist/native/nativeAdapter.d.ts +101 -33
  514. package/dist/native/nativeAdapter.js +375 -317
  515. package/dist/native/nativeAdapter.js.map +1 -1
  516. package/dist/native/rebuildDays.d.ts +12 -0
  517. package/dist/native/rebuildDays.js +16 -0
  518. package/dist/native/rebuildDays.js.map +1 -0
  519. package/dist/native/store/aggregate.js +450 -0
  520. package/dist/native/store/aggregate.js.map +1 -0
  521. package/dist/native/store/caps.d.ts +18 -0
  522. package/dist/native/store/caps.js +76 -0
  523. package/dist/native/store/caps.js.map +1 -0
  524. package/dist/native/store/chunks.js +34 -0
  525. package/dist/native/store/chunks.js.map +1 -0
  526. package/dist/native/store/columnValues.js +31 -0
  527. package/dist/native/store/columnValues.js.map +1 -0
  528. package/dist/native/store/dialect.js +106 -0
  529. package/dist/native/store/dialect.js.map +1 -0
  530. package/dist/native/store/eventStore.js +44 -0
  531. package/dist/native/store/eventStore.js.map +1 -0
  532. package/dist/native/store/hitRow.js +116 -0
  533. package/dist/native/store/hitRow.js.map +1 -0
  534. package/dist/native/store/hits.js +63 -0
  535. package/dist/native/store/hits.js.map +1 -0
  536. package/dist/native/store/ids.js +105 -0
  537. package/dist/native/store/ids.js.map +1 -0
  538. package/dist/native/store/mongo/aggregatePipelines.js +430 -0
  539. package/dist/native/store/mongo/aggregatePipelines.js.map +1 -0
  540. package/dist/native/store/mongo/mongoState.js +375 -0
  541. package/dist/native/store/mongo/mongoState.js.map +1 -0
  542. package/dist/native/store/mongo/mongoStore.js +618 -0
  543. package/dist/native/store/mongo/mongoStore.js.map +1 -0
  544. package/dist/native/store/mongo/pipelines.js +695 -0
  545. package/dist/native/store/mongo/pipelines.js.map +1 -0
  546. package/dist/native/store/mongo/results.js +20 -0
  547. package/dist/native/store/mongo/results.js.map +1 -0
  548. package/dist/native/store/parts.d.ts +1 -0
  549. package/dist/native/store/parts.js +95 -0
  550. package/dist/native/store/parts.js.map +1 -0
  551. package/dist/native/store/pattern.js +213 -0
  552. package/dist/native/store/pattern.js.map +1 -0
  553. package/dist/native/store/rawRead.d.ts +23 -0
  554. package/dist/native/store/rawRead.js +384 -0
  555. package/dist/native/store/rawRead.js.map +1 -0
  556. package/dist/native/store/reclassify.js +53 -0
  557. package/dist/native/store/reclassify.js.map +1 -0
  558. package/dist/native/store/sql/aggregateSql.js +345 -0
  559. package/dist/native/store/sql/aggregateSql.js.map +1 -0
  560. package/dist/native/store/sql/columns.js +48 -0
  561. package/dist/native/store/sql/columns.js.map +1 -0
  562. package/dist/native/store/sql/compile.js +656 -0
  563. package/dist/native/store/sql/compile.js.map +1 -0
  564. package/dist/native/store/sql/drivers.js +218 -0
  565. package/dist/native/store/sql/drivers.js.map +1 -0
  566. package/dist/native/store/sql/executor.js +132 -0
  567. package/dist/native/store/sql/executor.js.map +1 -0
  568. package/dist/native/store/sql/fragment.js +104 -0
  569. package/dist/native/store/sql/fragment.js.map +1 -0
  570. package/dist/native/store/sql/maintenanceSql.js +59 -0
  571. package/dist/native/store/sql/maintenanceSql.js.map +1 -0
  572. package/dist/native/store/sql/ownConnection.js +107 -0
  573. package/dist/native/store/sql/ownConnection.js.map +1 -0
  574. package/dist/native/store/sql/poolShare.js +101 -0
  575. package/dist/native/store/sql/poolShare.js.map +1 -0
  576. package/dist/native/store/sql/sqlState.js +325 -0
  577. package/dist/native/store/sql/sqlState.js.map +1 -0
  578. package/dist/native/store/sql/sqlStore.js +355 -0
  579. package/dist/native/store/sql/sqlStore.js.map +1 -0
  580. package/dist/native/store/sql/sqliteThread.d.ts +9 -0
  581. package/dist/native/store/sql/sqliteThread.js +314 -0
  582. package/dist/native/store/sql/sqliteThread.js.map +1 -0
  583. package/dist/native/store/sql/sqliteWorker.js +327 -0
  584. package/dist/native/store/sql/sqliteWorker.js.map +1 -0
  585. package/dist/native/store/sql/sqliteWorkerSource.js +347 -0
  586. package/dist/native/store/sql/sqliteWorkerSource.js.map +1 -0
  587. package/dist/native/store/state.js +151 -0
  588. package/dist/native/store/state.js.map +1 -0
  589. package/dist/native/store/stateStore.js +29 -0
  590. package/dist/native/store/stateStore.js.map +1 -0
  591. package/dist/native/store/types.d.ts +9 -0
  592. package/dist/native/tasks/maintainTask.d.ts +19 -0
  593. package/dist/native/tasks/maintainTask.js +68 -0
  594. package/dist/native/tasks/maintainTask.js.map +1 -0
  595. package/dist/net/guardedFetch.d.ts +32 -0
  596. package/dist/net/guardedFetch.js +220 -0
  597. package/dist/net/guardedFetch.js.map +1 -0
  598. package/dist/net/origin.js +40 -0
  599. package/dist/net/origin.js.map +1 -0
  600. package/dist/net/platform.d.ts +9 -0
  601. package/dist/net/platform.js +35 -0
  602. package/dist/net/platform.js.map +1 -0
  603. package/dist/next/captureRewrites.d.ts +4 -24
  604. package/dist/next/captureRewrites.js +6 -50
  605. package/dist/next/captureRewrites.js.map +1 -1
  606. package/dist/next/captureRoute.d.ts +28 -0
  607. package/dist/next/captureRoute.js +67 -0
  608. package/dist/next/captureRoute.js.map +1 -0
  609. package/dist/next/ingestRoute.d.ts +17 -0
  610. package/dist/next/ingestRoute.js +17 -0
  611. package/dist/next/ingestRoute.js.map +1 -0
  612. package/dist/next/posthogProxyRewrites.d.ts +3 -25
  613. package/dist/next/posthogProxyRewrites.js +5 -37
  614. package/dist/next/posthogProxyRewrites.js.map +1 -1
  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 +336 -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 +76 -53
  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 +5 -12
  639. package/dist/plugin/errors.js +23 -16
  640. package/dist/plugin/errors.js.map +1 -1
  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/jobsAccess.js +91 -0
  648. package/dist/plugin/jobsAccess.js.map +1 -0
  649. package/dist/plugin/keepAlive.js +48 -0
  650. package/dist/plugin/keepAlive.js.map +1 -0
  651. package/dist/plugin/peerImportError.js +3 -6
  652. package/dist/plugin/peerImportError.js.map +1 -1
  653. package/dist/plugin/peers.js +64 -0
  654. package/dist/plugin/peers.js.map +1 -0
  655. package/dist/plugin/pluginCollections.js +155 -0
  656. package/dist/plugin/pluginCollections.js.map +1 -0
  657. package/dist/plugin/queryEndpoint.js +69 -44
  658. package/dist/plugin/queryEndpoint.js.map +1 -1
  659. package/dist/plugin/queryParams.js +7 -0
  660. package/dist/plugin/queryParams.js.map +1 -0
  661. package/dist/plugin/readContextForRequest.js +52 -17
  662. package/dist/plugin/readContextForRequest.js.map +1 -1
  663. package/dist/plugin/readFailure.js +22 -0
  664. package/dist/plugin/readFailure.js.map +1 -0
  665. package/dist/plugin/readableProviders.js +64 -0
  666. package/dist/plugin/readableProviders.js.map +1 -0
  667. package/dist/plugin/realtimeEndpoint.js +77 -25
  668. package/dist/plugin/realtimeEndpoint.js.map +1 -1
  669. package/dist/plugin/refreshEndpoint.js +69 -44
  670. package/dist/plugin/refreshEndpoint.js.map +1 -1
  671. package/dist/plugin/relabelFields.js +36 -0
  672. package/dist/plugin/relabelFields.js.map +1 -0
  673. package/dist/plugin/requestMemo.js +35 -0
  674. package/dist/plugin/requestMemo.js.map +1 -0
  675. package/dist/plugin/routeChecks.js +39 -0
  676. package/dist/plugin/routeChecks.js.map +1 -0
  677. package/dist/plugin/routes.d.ts +53 -0
  678. package/dist/plugin/routes.js +92 -0
  679. package/dist/plugin/routes.js.map +1 -0
  680. package/dist/plugin/runtime.d.ts +1 -1
  681. package/dist/plugin/runtime.js +226 -30
  682. package/dist/plugin/runtime.js.map +1 -1
  683. package/dist/plugin/schemaOnly.js +63 -0
  684. package/dist/plugin/schemaOnly.js.map +1 -0
  685. package/dist/plugin/scopeChange.js +6 -5
  686. package/dist/plugin/scopeChange.js.map +1 -1
  687. package/dist/plugin/scopeFieldBoot.js +4 -4
  688. package/dist/plugin/scopeFieldBoot.js.map +1 -1
  689. package/dist/plugin/scopeToken.js +33 -0
  690. package/dist/plugin/scopeToken.js.map +1 -0
  691. package/dist/plugin/sourcesEndpoint.js +46 -12
  692. package/dist/plugin/sourcesEndpoint.js.map +1 -1
  693. package/dist/plugin/unbundledLanguages.js +25 -0
  694. package/dist/plugin/unbundledLanguages.js.map +1 -0
  695. package/dist/plugin/walkFields.js +22 -0
  696. package/dist/plugin/walkFields.js.map +1 -0
  697. package/dist/plugin/warmTask.js +0 -0
  698. package/dist/plugin/warmTask.js.map +1 -1
  699. package/dist/providers/access.d.ts +1 -0
  700. package/dist/providers/access.js +35 -26
  701. package/dist/providers/access.js.map +1 -1
  702. package/dist/providers/adapterPool.js +121 -0
  703. package/dist/providers/adapterPool.js.map +1 -0
  704. package/dist/providers/collection.d.ts +53 -0
  705. package/dist/providers/collection.js +274 -150
  706. package/dist/providers/collection.js.map +1 -1
  707. package/dist/providers/factory.d.ts +76 -0
  708. package/dist/providers/factory.js +76 -23
  709. package/dist/providers/factory.js.map +1 -1
  710. package/dist/providers/hosts.d.ts +25 -0
  711. package/dist/providers/hosts.js +128 -0
  712. package/dist/providers/hosts.js.map +1 -0
  713. package/dist/providers/probe.d.ts +1 -0
  714. package/dist/providers/probe.js +101 -0
  715. package/dist/providers/probe.js.map +1 -0
  716. package/dist/providers/refresh.d.ts +18 -0
  717. package/dist/providers/refresh.js +49 -0
  718. package/dist/providers/refresh.js.map +1 -0
  719. package/dist/providers/registry.js +318 -0
  720. package/dist/providers/registry.js.map +1 -0
  721. package/dist/providers/resolver.js +23 -88
  722. package/dist/providers/resolver.js.map +1 -1
  723. package/dist/providers/retarget.js +45 -0
  724. package/dist/providers/retarget.js.map +1 -0
  725. package/dist/providers/secrets.d.ts +26 -0
  726. package/dist/providers/secrets.js +61 -4
  727. package/dist/providers/secrets.js.map +1 -1
  728. package/dist/providers/stampScope.js +9 -6
  729. package/dist/providers/stampScope.js.map +1 -1
  730. package/dist/query/dates.js +10 -12
  731. package/dist/query/dates.js.map +1 -1
  732. package/dist/query/errors.d.ts +1 -5
  733. package/dist/query/fetchQuery.d.ts +25 -32
  734. package/dist/query/fetchQuery.js +91 -91
  735. package/dist/query/fetchQuery.js.map +1 -1
  736. package/dist/query/limits.js +8 -0
  737. package/dist/query/limits.js.map +1 -0
  738. package/dist/query/parse.d.ts +6 -0
  739. package/dist/query/parse.js +153 -106
  740. package/dist/query/parse.js.map +1 -1
  741. package/dist/query/response.d.ts +23 -3
  742. package/dist/query/response.js +12 -5
  743. package/dist/query/response.js.map +1 -1
  744. package/dist/react/AnalyticsProvider.d.ts +26 -17
  745. package/dist/react/AnalyticsProvider.js +23 -22
  746. package/dist/react/AnalyticsProvider.js.map +1 -1
  747. package/dist/react/TrackerBoot.js +15 -9
  748. package/dist/react/TrackerBoot.js.map +1 -1
  749. package/dist/react/useAnalytics.d.ts +2 -11
  750. package/dist/react/useAnalytics.js +22 -24
  751. package/dist/react/useAnalytics.js.map +1 -1
  752. package/dist/site/AnalyticsScripts.d.ts +34 -0
  753. package/dist/site/AnalyticsScripts.js +30 -0
  754. package/dist/site/AnalyticsScripts.js.map +1 -0
  755. package/dist/site/getTrackerConfig.d.ts +15 -0
  756. package/dist/site/getTrackerConfig.js +40 -0
  757. package/dist/site/getTrackerConfig.js.map +1 -0
  758. package/dist/surfacing/afterRead.d.ts +37 -0
  759. package/dist/surfacing/bounded.js +38 -0
  760. package/dist/surfacing/bounded.js.map +1 -0
  761. package/dist/surfacing/breaker.js +107 -0
  762. package/dist/surfacing/breaker.js.map +1 -0
  763. package/dist/surfacing/cacheCollection.d.ts +8 -0
  764. package/dist/surfacing/cacheCollection.js +69 -0
  765. package/dist/surfacing/cacheCollection.js.map +1 -0
  766. package/dist/surfacing/cacheStore.d.ts +71 -1
  767. package/dist/surfacing/cacheStore.js +16 -37
  768. package/dist/surfacing/cacheStore.js.map +1 -1
  769. package/dist/surfacing/cacheSweep.d.ts +1 -0
  770. package/dist/surfacing/cacheSweep.js +59 -0
  771. package/dist/surfacing/cacheSweep.js.map +1 -0
  772. package/dist/surfacing/classifyError.js +282 -0
  773. package/dist/surfacing/classifyError.js.map +1 -0
  774. package/dist/surfacing/coalesce.js +2 -1
  775. package/dist/surfacing/coalesce.js.map +1 -1
  776. package/dist/surfacing/coldBudget.js +60 -0
  777. package/dist/surfacing/coldBudget.js.map +1 -0
  778. package/dist/surfacing/collectionCacheStore.js +183 -0
  779. package/dist/surfacing/collectionCacheStore.js.map +1 -0
  780. package/dist/surfacing/engine.d.ts +1 -1
  781. package/dist/surfacing/engine.js +514 -72
  782. package/dist/surfacing/engine.js.map +1 -1
  783. package/dist/surfacing/epoch.js +70 -26
  784. package/dist/surfacing/epoch.js.map +1 -1
  785. package/dist/surfacing/lanes.d.ts +1 -0
  786. package/dist/surfacing/lanes.js +297 -0
  787. package/dist/surfacing/lanes.js.map +1 -0
  788. package/dist/surfacing/memo.js +40 -0
  789. package/dist/surfacing/memo.js.map +1 -0
  790. package/dist/surfacing/rateLimiter.d.ts +1 -0
  791. package/dist/surfacing/rateLimiter.js +69 -94
  792. package/dist/surfacing/rateLimiter.js.map +1 -1
  793. package/dist/surfacing/rebucket.js +178 -0
  794. package/dist/surfacing/rebucket.js.map +1 -0
  795. package/dist/surfacing/recipe.js +28 -0
  796. package/dist/surfacing/recipe.js.map +1 -0
  797. package/dist/surfacing/shape.js +22 -0
  798. package/dist/surfacing/shape.js.map +1 -0
  799. package/dist/surfacing/todaySplit.js +113 -0
  800. package/dist/surfacing/todaySplit.js.map +1 -0
  801. package/dist/sync/collection.d.ts +8 -0
  802. package/dist/sync/collection.js +28 -18
  803. package/dist/sync/collection.js.map +1 -1
  804. package/dist/sync/rekeyDurations.js +70 -0
  805. package/dist/sync/rekeyDurations.js.map +1 -0
  806. package/dist/sync/syncTask.js +226 -109
  807. package/dist/sync/syncTask.js.map +1 -1
  808. package/dist/testing/memoryAdapter.d.ts +6 -3
  809. package/dist/testing/memoryAdapter.js +12 -10
  810. package/dist/testing/memoryAdapter.js.map +1 -1
  811. package/dist/testing/settle.d.ts +11 -0
  812. package/dist/testing/settle.js +19 -0
  813. package/dist/testing/settle.js.map +1 -0
  814. package/dist/timeframe/calendar.js +65 -0
  815. package/dist/timeframe/calendar.js.map +1 -0
  816. package/dist/timeframe/comparison.js +46 -0
  817. package/dist/timeframe/comparison.js.map +1 -0
  818. package/dist/timeframe/presets.d.ts +1 -1
  819. package/dist/timeframe/presets.js +5 -5
  820. package/dist/timeframe/presets.js.map +1 -1
  821. package/dist/timeframe/reportingTimezone.d.ts +1 -0
  822. package/dist/timeframe/reportingTimezone.js +64 -0
  823. package/dist/timeframe/reportingTimezone.js.map +1 -0
  824. package/dist/timeframe/tz.js +55 -39
  825. package/dist/timeframe/tz.js.map +1 -1
  826. package/dist/tracker/autoCapture.js +125 -38
  827. package/dist/tracker/autoCapture.js.map +1 -1
  828. package/dist/tracker/campaign.js +52 -0
  829. package/dist/tracker/campaign.js.map +1 -0
  830. package/dist/tracker/config.d.ts +144 -0
  831. package/dist/tracker/config.js +25 -0
  832. package/dist/tracker/config.js.map +1 -0
  833. package/dist/tracker/createTracker.d.ts +4 -10
  834. package/dist/tracker/createTracker.js +386 -115
  835. package/dist/tracker/createTracker.js.map +1 -1
  836. package/dist/tracker/digest.js +28 -0
  837. package/dist/tracker/digest.js.map +1 -0
  838. package/dist/tracker/engagement.js +100 -0
  839. package/dist/tracker/engagement.js.map +1 -0
  840. package/dist/tracker/events.js +37 -0
  841. package/dist/tracker/events.js.map +1 -0
  842. package/dist/tracker/exclusion.d.ts +2 -22
  843. package/dist/tracker/exclusion.js +53 -21
  844. package/dist/tracker/exclusion.js.map +1 -1
  845. package/dist/tracker/gate.js +194 -0
  846. package/dist/tracker/gate.js.map +1 -0
  847. package/dist/tracker/initTracker.d.ts +5 -8
  848. package/dist/tracker/initTracker.js +42 -14
  849. package/dist/tracker/initTracker.js.map +1 -1
  850. package/dist/tracker/itemCapture.js +224 -0
  851. package/dist/tracker/itemCapture.js.map +1 -0
  852. package/dist/tracker/loadScript.js +21 -14
  853. package/dist/tracker/loadScript.js.map +1 -1
  854. package/dist/tracker/pageTracking.js +6 -6
  855. package/dist/tracker/pageTracking.js.map +1 -1
  856. package/dist/tracker/registry.js +118 -30
  857. package/dist/tracker/registry.js.map +1 -1
  858. package/dist/tracker/sinks/createSink.js +38 -0
  859. package/dist/tracker/sinks/createSink.js.map +1 -0
  860. package/dist/tracker/sinks/ga4.js +64 -20
  861. package/dist/tracker/sinks/ga4.js.map +1 -1
  862. package/dist/tracker/sinks/native.js +7 -42
  863. package/dist/tracker/sinks/native.js.map +1 -1
  864. package/dist/tracker/sinks/plausible.js +27 -22
  865. package/dist/tracker/sinks/plausible.js.map +1 -1
  866. package/dist/tracker/sinks/posthog.js +26 -22
  867. package/dist/tracker/sinks/posthog.js.map +1 -1
  868. package/dist/tracker/sinks/umami.js +14 -12
  869. package/dist/tracker/sinks/umami.js.map +1 -1
  870. package/dist/tracker/sinks/vendor.js +30 -27
  871. package/dist/tracker/sinks/vendor.js.map +1 -1
  872. package/dist/tracker/skip.js +81 -0
  873. package/dist/tracker/skip.js.map +1 -0
  874. package/dist/tracker/storage.js +23 -0
  875. package/dist/tracker/storage.js.map +1 -0
  876. package/dist/tracker/transport.js +2 -5
  877. package/dist/tracker/transport.js.map +1 -1
  878. package/dist/tracker/types.d.ts +86 -63
  879. package/dist/tracker/window.js +7 -0
  880. package/dist/tracker/window.js.map +1 -0
  881. package/dist/translations/ar.js +226 -71
  882. package/dist/translations/ar.js.map +1 -1
  883. package/dist/translations/de.js +215 -69
  884. package/dist/translations/de.js.map +1 -1
  885. package/dist/translations/en.js +209 -67
  886. package/dist/translations/en.js.map +1 -1
  887. package/dist/translations/es.js +217 -68
  888. package/dist/translations/es.js.map +1 -1
  889. package/dist/translations/fr.js +221 -72
  890. package/dist/translations/fr.js.map +1 -1
  891. package/dist/translations/id.js +212 -67
  892. package/dist/translations/id.js.map +1 -1
  893. package/dist/translations/index.d.ts +1 -1
  894. package/dist/translations/index.js +5 -7
  895. package/dist/translations/index.js.map +1 -1
  896. package/dist/translations/intl.js +71 -0
  897. package/dist/translations/intl.js.map +1 -0
  898. package/dist/translations/keys.d.ts +185 -14
  899. package/dist/translations/keys.js +190 -14
  900. package/dist/translations/keys.js.map +1 -1
  901. package/dist/translations/ko.js +214 -69
  902. package/dist/translations/ko.js.map +1 -1
  903. package/dist/translations/labelMap.d.ts +10 -0
  904. package/dist/translations/labelMap.js +22 -0
  905. package/dist/translations/labelMap.js.map +1 -0
  906. package/dist/translations/metricKeys.js +10 -2
  907. package/dist/translations/metricKeys.js.map +1 -1
  908. package/dist/translations/parts.js +20 -0
  909. package/dist/translations/parts.js.map +1 -0
  910. package/dist/translations/plural.js +61 -0
  911. package/dist/translations/plural.js.map +1 -0
  912. package/dist/translations/pt.js +226 -77
  913. package/dist/translations/pt.js.map +1 -1
  914. package/dist/translations/ru.js +217 -66
  915. package/dist/translations/ru.js.map +1 -1
  916. package/dist/translations/server.d.ts +1 -0
  917. package/dist/translations/server.js +2 -3
  918. package/dist/translations/server.js.map +1 -1
  919. package/dist/translations/staticLabel.js +69 -0
  920. package/dist/translations/staticLabel.js.map +1 -0
  921. package/dist/translations/uk.js +217 -66
  922. package/dist/translations/uk.js.map +1 -1
  923. package/dist/translations/zh.js +212 -67
  924. package/dist/translations/zh.js.map +1 -1
  925. package/dist/ui/RangePicker.js +112 -0
  926. package/dist/ui/RangePicker.js.map +1 -0
  927. package/dist/ui/analytics.css +1528 -0
  928. package/dist/ui/calendarDays.js +27 -0
  929. package/dist/ui/calendarDays.js.map +1 -0
  930. package/dist/ui/classNames.js +7 -0
  931. package/dist/ui/classNames.js.map +1 -0
  932. package/dist/ui/components/Card.d.ts +28 -0
  933. package/dist/ui/components/Card.js +21 -0
  934. package/dist/ui/components/Card.js.map +1 -0
  935. package/dist/ui/components/ChartDataTable.d.ts +41 -0
  936. package/dist/ui/components/ChartDataTable.js +48 -0
  937. package/dist/ui/components/ChartDataTable.js.map +1 -0
  938. package/dist/ui/components/DataTable.d.ts +82 -0
  939. package/dist/ui/components/DataTable.js +214 -0
  940. package/dist/ui/components/DataTable.js.map +1 -0
  941. package/dist/ui/components/LabeledSelect.js +62 -0
  942. package/dist/ui/components/LabeledSelect.js.map +1 -0
  943. package/dist/ui/components/LiveAnnouncement.js +21 -0
  944. package/dist/ui/components/LiveAnnouncement.js.map +1 -0
  945. package/dist/ui/components/MetricCard.d.ts +38 -0
  946. package/dist/ui/components/MetricCard.js +39 -0
  947. package/dist/ui/components/MetricCard.js.map +1 -0
  948. package/dist/ui/components/NoValue.js +22 -0
  949. package/dist/ui/components/NoValue.js.map +1 -0
  950. package/dist/ui/components/ReadState.js +27 -0
  951. package/dist/ui/components/ReadState.js.map +1 -0
  952. package/dist/ui/components/RefreshButton.js +26 -0
  953. package/dist/ui/components/RefreshButton.js.map +1 -0
  954. package/dist/ui/cssVars.js +7 -0
  955. package/dist/ui/cssVars.js.map +1 -0
  956. package/dist/ui/data/WithScopeToken.d.ts +20 -0
  957. package/dist/ui/data/WithScopeToken.js +20 -0
  958. package/dist/ui/data/WithScopeToken.js.map +1 -0
  959. package/dist/ui/data/clientFieldProps.js +16 -0
  960. package/dist/ui/data/clientFieldProps.js.map +1 -0
  961. package/dist/ui/data/request.d.ts +46 -0
  962. package/dist/ui/data/request.js +119 -0
  963. package/dist/ui/data/request.js.map +1 -0
  964. package/dist/ui/data/scopeTokenContext.js +18 -0
  965. package/dist/ui/data/scopeTokenContext.js.map +1 -0
  966. package/dist/ui/data/sharedCache.js +48 -0
  967. package/dist/ui/data/sharedCache.js.map +1 -0
  968. package/dist/ui/data/useRequest.d.ts +19 -0
  969. package/dist/ui/data/useRequest.js +123 -0
  970. package/dist/ui/data/useRequest.js.map +1 -0
  971. package/dist/ui/data/useRequestScope.js +25 -0
  972. package/dist/ui/data/useRequestScope.js.map +1 -0
  973. package/dist/ui/hooks/useDirection.js +47 -0
  974. package/dist/ui/hooks/useDirection.js.map +1 -0
  975. package/dist/ui/hooks/useDismissOnEscape.js +25 -0
  976. package/dist/ui/hooks/useDismissOnEscape.js.map +1 -0
  977. package/dist/ui/hooks/useLiveAnnouncement.js +57 -0
  978. package/dist/ui/hooks/useLiveAnnouncement.js.map +1 -0
  979. package/dist/ui/hooks/useRealtimePoll.js +112 -0
  980. package/dist/ui/hooks/useRealtimePoll.js.map +1 -0
  981. package/dist/ui/readState.js +19 -0
  982. package/dist/ui/readState.js.map +1 -0
  983. package/dist/ui/rows/toDisplayRows.js +49 -0
  984. package/dist/ui/rows/toDisplayRows.js.map +1 -0
  985. package/dist/ui/viewerClock.js +7 -0
  986. package/dist/ui/viewerClock.js.map +1 -0
  987. package/dist/view/AnalyticsNavLink.d.ts +5 -3
  988. package/dist/view/AnalyticsNavLink.js +11 -6
  989. package/dist/view/AnalyticsNavLink.js.map +1 -1
  990. package/dist/view/AnalyticsView.d.ts +8 -10
  991. package/dist/view/AnalyticsView.js +47 -18
  992. package/dist/view/AnalyticsView.js.map +1 -1
  993. package/dist/view/AnalyticsViewClient.d.ts +4 -7
  994. package/dist/view/AnalyticsViewClient.js +15 -229
  995. package/dist/view/AnalyticsViewClient.js.map +1 -1
  996. package/dist/view/CountryFlag.d.ts +27 -0
  997. package/dist/view/CountryFlag.js +44 -0
  998. package/dist/view/CountryFlag.js.map +1 -0
  999. package/dist/view/DocumentTitle.js +27 -0
  1000. package/dist/view/DocumentTitle.js.map +1 -0
  1001. package/dist/view/ViewRoot.d.ts +21 -0
  1002. package/dist/view/ViewRoot.js +150 -0
  1003. package/dist/view/ViewRoot.js.map +1 -0
  1004. package/dist/view/ViewSections.d.ts +38 -0
  1005. package/dist/view/ViewSections.js +190 -0
  1006. package/dist/view/ViewSections.js.map +1 -0
  1007. package/dist/view/authRedirect.js +2 -4
  1008. package/dist/view/authRedirect.js.map +1 -1
  1009. package/dist/view/conversionRate.js +9 -7
  1010. package/dist/view/conversionRate.js.map +1 -1
  1011. package/dist/view/dayRange.js +6 -10
  1012. package/dist/view/dayRange.js.map +1 -1
  1013. package/dist/view/exclusionLink.d.ts +27 -0
  1014. package/dist/view/exclusionLink.js +46 -0
  1015. package/dist/view/exclusionLink.js.map +1 -0
  1016. package/dist/view/flagSrc.js +14 -0
  1017. package/dist/view/flagSrc.js.map +1 -0
  1018. package/dist/view/gating.d.ts +15 -1
  1019. package/dist/view/gating.js +66 -31
  1020. package/dist/view/gating.js.map +1 -1
  1021. package/dist/view/hostCountryFlag.js +41 -0
  1022. package/dist/view/hostCountryFlag.js.map +1 -0
  1023. package/dist/view/labels.js +95 -10
  1024. package/dist/view/labels.js.map +1 -1
  1025. package/dist/view/metricAliases.js +10 -0
  1026. package/dist/view/metricAliases.js.map +1 -0
  1027. package/dist/view/navLabel.js +15 -0
  1028. package/dist/view/navLabel.js.map +1 -0
  1029. package/dist/view/registerView.js +10 -9
  1030. package/dist/view/registerView.js.map +1 -1
  1031. package/dist/view/scopeLabel.js +21 -0
  1032. package/dist/view/scopeLabel.js.map +1 -0
  1033. package/dist/view/sections/Breakdowns.js +196 -134
  1034. package/dist/view/sections/Breakdowns.js.map +1 -1
  1035. package/dist/view/sections/EmptyStates.js +118 -30
  1036. package/dist/view/sections/EmptyStates.js.map +1 -1
  1037. package/dist/view/sections/ExcludeBrowser.js +188 -0
  1038. package/dist/view/sections/ExcludeBrowser.js.map +1 -0
  1039. package/dist/view/sections/FilterChips.js +124 -27
  1040. package/dist/view/sections/FilterChips.js.map +1 -1
  1041. package/dist/view/sections/GoalsPanel.js +68 -60
  1042. package/dist/view/sections/GoalsPanel.js.map +1 -1
  1043. package/dist/view/sections/OverviewCards.js +29 -33
  1044. package/dist/view/sections/OverviewCards.js.map +1 -1
  1045. package/dist/view/sections/RealtimeStrip.js +70 -59
  1046. package/dist/view/sections/RealtimeStrip.js.map +1 -1
  1047. package/dist/view/sections/SectionBoundary.js +34 -0
  1048. package/dist/view/sections/SectionBoundary.js.map +1 -0
  1049. package/dist/view/sections/Toolbar.d.ts +11 -0
  1050. package/dist/view/sections/Toolbar.js +123 -82
  1051. package/dist/view/sections/Toolbar.js.map +1 -1
  1052. package/dist/view/sections/Trend.js +176 -76
  1053. package/dist/view/sections/Trend.js.map +1 -1
  1054. package/dist/view/state.d.ts +42 -0
  1055. package/dist/view/state.js +93 -54
  1056. package/dist/view/state.js.map +1 -1
  1057. package/dist/view/useViewClock.js +31 -0
  1058. package/dist/view/useViewClock.js.map +1 -0
  1059. package/dist/view/useViewQueries.d.ts +21 -0
  1060. package/dist/view/useViewQueries.js +45 -77
  1061. package/dist/view/useViewQueries.js.map +1 -1
  1062. package/dist/view/useViewState.js +42 -0
  1063. package/dist/view/useViewState.js.map +1 -0
  1064. package/dist/view/useViewUrl.js +47 -0
  1065. package/dist/view/useViewUrl.js.map +1 -0
  1066. package/dist/view/viewBody.js +30 -0
  1067. package/dist/view/viewBody.js.map +1 -0
  1068. package/dist/view/viewContext.d.ts +81 -0
  1069. package/dist/view/viewContext.js +49 -0
  1070. package/dist/view/viewContext.js.map +1 -0
  1071. package/dist/view/viewProps.d.ts +64 -7
  1072. package/dist/view/viewProps.js +121 -35
  1073. package/dist/view/viewProps.js.map +1 -1
  1074. package/dist/widgets/AnalyticsBreakdownWidget.d.ts +7 -3
  1075. package/dist/widgets/AnalyticsBreakdownWidget.js +143 -118
  1076. package/dist/widgets/AnalyticsBreakdownWidget.js.map +1 -1
  1077. package/dist/widgets/AnalyticsGoalsWidget.d.ts +6 -7
  1078. package/dist/widgets/AnalyticsGoalsWidget.js +124 -167
  1079. package/dist/widgets/AnalyticsGoalsWidget.js.map +1 -1
  1080. package/dist/widgets/AnalyticsMetricWidget.d.ts +7 -3
  1081. package/dist/widgets/AnalyticsMetricWidget.js +80 -106
  1082. package/dist/widgets/AnalyticsMetricWidget.js.map +1 -1
  1083. package/dist/widgets/AnalyticsRealtimeWidget.d.ts +7 -3
  1084. package/dist/widgets/AnalyticsRealtimeWidget.js +74 -64
  1085. package/dist/widgets/AnalyticsRealtimeWidget.js.map +1 -1
  1086. package/dist/widgets/AnalyticsTrendWidget.d.ts +7 -3
  1087. package/dist/widgets/AnalyticsTrendWidget.js +129 -123
  1088. package/dist/widgets/AnalyticsTrendWidget.js.map +1 -1
  1089. package/dist/widgets/ComparisonDelta.js +33 -42
  1090. package/dist/widgets/ComparisonDelta.js.map +1 -1
  1091. package/dist/widgets/RealtimeCounter.d.ts +24 -4
  1092. package/dist/widgets/RealtimeCounter.js +91 -77
  1093. package/dist/widgets/RealtimeCounter.js.map +1 -1
  1094. package/dist/widgets/WidgetCard.d.ts +80 -0
  1095. package/dist/widgets/WidgetCard.js +99 -0
  1096. package/dist/widgets/WidgetCard.js.map +1 -0
  1097. package/dist/widgets/WidgetFrame.js +42 -0
  1098. package/dist/widgets/WidgetFrame.js.map +1 -0
  1099. package/dist/widgets/WidgetShimmer.d.ts +55 -0
  1100. package/dist/widgets/WidgetShimmer.js +86 -0
  1101. package/dist/widgets/WidgetShimmer.js.map +1 -0
  1102. package/dist/widgets/breakdownTypes.js +12 -2
  1103. package/dist/widgets/breakdownTypes.js.map +1 -1
  1104. package/dist/widgets/customWidget.d.ts +5 -1
  1105. package/dist/widgets/customWidget.js +6 -7
  1106. package/dist/widgets/customWidget.js.map +1 -1
  1107. package/dist/widgets/defaults.d.ts +4 -7
  1108. package/dist/widgets/defaults.js +4 -7
  1109. package/dist/widgets/defaults.js.map +1 -1
  1110. package/dist/widgets/fieldRows.js +14 -0
  1111. package/dist/widgets/fieldRows.js.map +1 -0
  1112. package/dist/widgets/filterCaption.js +6 -7
  1113. package/dist/widgets/filterCaption.js.map +1 -1
  1114. package/dist/widgets/filterField.d.ts +3 -7
  1115. package/dist/widgets/filterField.js +46 -35
  1116. package/dist/widgets/filterField.js.map +1 -1
  1117. package/dist/widgets/filterValueLabel.d.ts +1 -0
  1118. package/dist/widgets/filterValueLabel.js +45 -0
  1119. package/dist/widgets/filterValueLabel.js.map +1 -0
  1120. package/dist/widgets/notices.js +73 -0
  1121. package/dist/widgets/notices.js.map +1 -0
  1122. package/dist/widgets/prepareWidgetRead.d.ts +5 -1
  1123. package/dist/widgets/prepareWidgetRead.js +59 -27
  1124. package/dist/widgets/prepareWidgetRead.js.map +1 -1
  1125. package/dist/widgets/range.js +26 -21
  1126. package/dist/widgets/range.js.map +1 -1
  1127. package/dist/widgets/readForWidget.d.ts +27 -18
  1128. package/dist/widgets/readForWidget.js +31 -29
  1129. package/dist/widgets/readForWidget.js.map +1 -1
  1130. package/dist/widgets/readForWidgetBreakdown.d.ts +39 -28
  1131. package/dist/widgets/readForWidgetBreakdown.js +46 -22
  1132. package/dist/widgets/readForWidgetBreakdown.js.map +1 -1
  1133. package/dist/widgets/readForWidgetGoals.d.ts +17 -23
  1134. package/dist/widgets/readForWidgetGoals.js +50 -46
  1135. package/dist/widgets/readForWidgetGoals.js.map +1 -1
  1136. package/dist/widgets/readForWidgetRealtime.d.ts +21 -17
  1137. package/dist/widgets/readForWidgetRealtime.js +51 -27
  1138. package/dist/widgets/readForWidgetRealtime.js.map +1 -1
  1139. package/dist/widgets/readForWidgetSeries.d.ts +26 -31
  1140. package/dist/widgets/readForWidgetSeries.js +43 -82
  1141. package/dist/widgets/readForWidgetSeries.js.map +1 -1
  1142. package/dist/widgets/readMeta.d.ts +44 -0
  1143. package/dist/widgets/readMeta.js +47 -4
  1144. package/dist/widgets/readMeta.js.map +1 -1
  1145. package/dist/widgets/realtimePoll.d.ts +1 -0
  1146. package/dist/widgets/realtimePoll.js +53 -25
  1147. package/dist/widgets/realtimePoll.js.map +1 -1
  1148. package/dist/widgets/registerWidgets.js +204 -126
  1149. package/dist/widgets/registerWidgets.js.map +1 -1
  1150. package/dist/widgets/stateKeys.js +30 -0
  1151. package/dist/widgets/stateKeys.js.map +1 -0
  1152. package/dist/widgets/titleForecast.js +89 -0
  1153. package/dist/widgets/titleForecast.js.map +1 -0
  1154. package/dist/widgets/types.d.ts +4 -3
  1155. package/dist/widgets/types.js +2 -0
  1156. package/dist/widgets/types.js.map +1 -1
  1157. package/dist/widgets/viewLink.d.ts +24 -6
  1158. package/dist/widgets/viewLink.js +31 -24
  1159. package/dist/widgets/viewLink.js.map +1 -1
  1160. package/dist/widgets/widgetData.js +34 -0
  1161. package/dist/widgets/widgetData.js.map +1 -0
  1162. package/dist/widgets/widgetWindow.d.ts +1 -0
  1163. package/dist/widgets/widgetWindow.js +51 -0
  1164. package/dist/widgets/widgetWindow.js.map +1 -0
  1165. package/package.json +44 -22
  1166. package/dist/adapters/ga4/disableKey.d.ts +0 -9
  1167. package/dist/capture/getTrackerConfig.d.ts +0 -20
  1168. package/dist/capture/getTrackerConfig.js +0 -31
  1169. package/dist/capture/getTrackerConfig.js.map +0 -1
  1170. package/dist/capture/slots.d.ts +0 -8
  1171. package/dist/capture/trackerConfig.d.ts +0 -33
  1172. package/dist/charts/styles.js +0 -59
  1173. package/dist/charts/styles.js.map +0 -1
  1174. package/dist/fields/config/SourceSelectField.d.ts +0 -14
  1175. package/dist/fields/dateRange/styles.js +0 -23
  1176. package/dist/fields/dateRange/styles.js.map +0 -1
  1177. package/dist/goals/GoalSelectField.d.ts +0 -7
  1178. package/dist/native/collections/events.js +0 -165
  1179. package/dist/native/collections/events.js.map +0 -1
  1180. package/dist/native/collections/rollups.js +0 -151
  1181. package/dist/native/collections/rollups.js.map +0 -1
  1182. package/dist/native/collections/seen.js +0 -47
  1183. package/dist/native/collections/seen.js.map +0 -1
  1184. package/dist/native/eventScan.js +0 -25
  1185. package/dist/native/eventScan.js.map +0 -1
  1186. package/dist/native/ingest/flushBatch.js +0 -60
  1187. package/dist/native/ingest/flushBatch.js.map +0 -1
  1188. package/dist/native/ingest/salt.js +0 -39
  1189. package/dist/native/ingest/salt.js.map +0 -1
  1190. package/dist/native/ingest/writeBuffer.js +0 -55
  1191. package/dist/native/ingest/writeBuffer.js.map +0 -1
  1192. package/dist/native/ingest/writeEvent.js +0 -14
  1193. package/dist/native/ingest/writeEvent.js.map +0 -1
  1194. package/dist/native/query/eventAgg.js +0 -175
  1195. package/dist/native/query/eventAgg.js.map +0 -1
  1196. package/dist/native/realtime/buildRealtime.js +0 -53
  1197. package/dist/native/realtime/buildRealtime.js.map +0 -1
  1198. package/dist/native/retention/pruneTask.js +0 -69
  1199. package/dist/native/retention/pruneTask.js.map +0 -1
  1200. package/dist/native/rollupAcc.js +0 -64
  1201. package/dist/native/rollupAcc.js.map +0 -1
  1202. package/dist/native/rollups/bucketKey.js +0 -15
  1203. package/dist/native/rollups/bucketKey.js.map +0 -1
  1204. package/dist/native/rollups/bumpRollups.js +0 -116
  1205. package/dist/native/rollups/bumpRollups.js.map +0 -1
  1206. package/dist/native/rollups/deltas.js +0 -106
  1207. package/dist/native/rollups/deltas.js.map +0 -1
  1208. package/dist/native/rollups/insertManyIfNew.js +0 -93
  1209. package/dist/native/rollups/insertManyIfNew.js.map +0 -1
  1210. package/dist/plugin/paths.js +0 -29
  1211. package/dist/plugin/paths.js.map +0 -1
  1212. package/dist/react/TrackerBoot.d.ts +0 -22
  1213. package/dist/rsc/AnalyticsScripts.d.ts +0 -30
  1214. package/dist/rsc/AnalyticsScripts.js +0 -41
  1215. package/dist/rsc/AnalyticsScripts.js.map +0 -1
  1216. package/dist/surfacing/queue.js +0 -60
  1217. package/dist/surfacing/queue.js.map +0 -1
  1218. package/dist/surfacing/retryPolicy.js +0 -15
  1219. package/dist/surfacing/retryPolicy.js.map +0 -1
  1220. package/dist/tracker/autoCapture.d.ts +0 -48
  1221. package/dist/tracker/consent.d.ts +0 -24
  1222. package/dist/tracker/consent.js +0 -48
  1223. package/dist/tracker/consent.js.map +0 -1
  1224. package/dist/tracker/loadScript.d.ts +0 -14
  1225. package/dist/tracker/pageTracking.d.ts +0 -17
  1226. package/dist/tracker/registry.d.ts +0 -27
  1227. package/dist/tracker/sinks/ga4.d.ts +0 -29
  1228. package/dist/tracker/sinks/native.d.ts +0 -22
  1229. package/dist/tracker/sinks/plausible.d.ts +0 -20
  1230. package/dist/tracker/sinks/posthog.d.ts +0 -18
  1231. package/dist/tracker/sinks/umami.d.ts +0 -18
  1232. package/dist/tracker/sinks/vendor.d.ts +0 -14
  1233. package/dist/view/sections/styles.js +0 -76
  1234. package/dist/view/sections/styles.js.map +0 -1
  1235. package/dist/widgets/WidgetViewLink.js +0 -17
  1236. package/dist/widgets/WidgetViewLink.js.map +0 -1
  1237. package/dist/widgets/cardChrome.d.ts +0 -8
  1238. package/dist/widgets/cardChrome.js +0 -46
  1239. package/dist/widgets/cardChrome.js.map +0 -1
  1240. package/dist/widgets/comparison.js +0 -57
  1241. package/dist/widgets/comparison.js.map +0 -1
@@ -1,41 +1,43 @@
1
- import { resolveGoalsDetailedFor } from "../plugin/runtime.js";
2
- import { comparisonOf } from "../core/capabilities.js";
3
- import { previousWindow, withinLookback } from "./comparison.js";
4
- import { prepareWidgetRead } from "./prepareWidgetRead.js";
1
+ import { readPrincipalOf } from "../access/principal.js";
2
+ import { goalNamesFor, resolveGoalsDetailedFor } from "../plugin/runtime.js";
3
+ import { comparisonWindow, pinnedScope, prepareWidgetRead } from "./prepareWidgetRead.js";
4
+ import { mergeNotices } from "./readMeta.js";
5
5
  import { readForWidget } from "./readForWidget.js";
6
6
  import { readForWidgetBreakdown } from "./readForWidgetBreakdown.js";
7
7
  import { conversionRate } from "../view/conversionRate.js";
8
8
  //#region src/widgets/readForWidgetGoals.ts
9
9
  /**
10
- * How much wider than the table the previous window is read. Both windows rank by their own
11
- * conversions, so a goal in today's top rows may sit well below them in the previous window;
12
- * reading only as many rows as the table shows would drop exactly those deltas. Capped at
13
- * the bound every analytics query is held to.
10
+ * How much wider than the table the previous window is read: each window ranks by its own
11
+ * conversions, so a goal in today's top rows may rank too low there to keep its delta.
14
12
  */
15
13
  const PREVIOUS_LIMIT_FACTOR = 4;
16
14
  const previousLimit = (limit) => Math.min(limit * PREVIOUS_LIMIT_FACTOR, 500);
17
15
  /**
18
- * Goal names for the read's own scope. A resolver that throws must not cost the widget its
19
- * table, so the rows fall back to their slugs; the failure travels on as the hint, which is
20
- * what tells the read apart from a scope that configured no goals at all.
16
+ * The scope's goal slugs and their display names. A throwing resolver must not cost the table:
17
+ * rows fall back to slugs and `'unresolved'` tells the read apart from a scope with no goals.
21
18
  */
22
19
  const goalNames = async (runtime, req, scope) => {
23
20
  try {
24
21
  const resolved = await resolveGoalsDetailedFor(runtime, req, scope);
25
- return new Map(resolved.map(({ goal }) => [goal.slug, goal.name]));
22
+ const shown = await goalNamesFor({
23
+ runtime,
24
+ req,
25
+ scope,
26
+ resolved
27
+ });
28
+ return {
29
+ slugs: resolved.map(({ goal }) => goal.slug),
30
+ names: new Map(shown.map((goal) => [goal.slug, goal.name])),
31
+ builtin: resolved.filter((entry) => entry.source === "builtin").map(({ goal }) => goal.slug)
32
+ };
26
33
  } catch (err) {
27
34
  req.payload.logger?.warn(`analytics: widget goal names failed to resolve: ${String(err)}`);
28
35
  return "unresolved";
29
36
  }
30
37
  };
31
38
  /**
32
- * The goals table behind the goals widget: conversions per goal over the window, each with
33
- * its revenue, its share of the site's visitors, and (when comparing) the same goal's
34
- * conversions in the previous window. Rows come from one `goal` breakdown read and the site
35
- * total from one totals read, both through the existing widget helpers so capability
36
- * gating, scoping and caching stay in one place. Revenue and visitors ride along only where
37
- * the source serves them; the status is the breakdown's, since a table without its rows has
38
- * nothing to show.
39
+ * Goals table from a `goal` breakdown, a visitors total for the rate and, when comparing, the
40
+ * previous window's breakdown. Status is the breakdown's: a table without rows shows nothing.
39
41
  */
40
42
  const readForWidgetGoals = async (args) => {
41
43
  const { req, timeframe, limit, compare, adapterId, now } = args;
@@ -50,7 +52,7 @@ const readForWidgetGoals = async (args) => {
50
52
  now,
51
53
  timeframe,
52
54
  adapterId,
53
- scope: args.scope,
55
+ ...readPrincipalOf(args),
54
56
  timezone: args.timezone,
55
57
  range: args.range
56
58
  });
@@ -63,18 +65,15 @@ const readForWidgetGoals = async (args) => {
63
65
  req,
64
66
  timeframe,
65
67
  adapterId: adapter.id,
66
- scope: prepared.scope,
68
+ ...prepared.pin,
67
69
  timezone: tz,
68
70
  now
69
71
  };
70
- const previousRange = compare && runtime.comparison && comparisonOf(adapter.capabilities) ? previousWindow(dateRange, tz) : null;
71
- const comparisonRange = previousRange && withinLookback(previousRange, adapter.capabilities.maxLookbackDays, {
72
- tz,
73
- now
74
- }) ? previousRange : void 0;
72
+ const comparisonRange = compare ? comparisonWindow(prepared, now) : void 0;
75
73
  const resolved = await goalNames(runtime, req, prepared.scope);
76
- const names = resolved === "unresolved" ? /* @__PURE__ */ new Map() : resolved;
77
- const goalSlugs = resolved === "unresolved" ? "unresolved" : [...names.keys()];
74
+ const names = resolved === "unresolved" ? /* @__PURE__ */ new Map() : resolved.names;
75
+ const builtinGoalSlugs = resolved === "unresolved" ? [] : resolved.builtin;
76
+ const goalSlugs = resolved === "unresolved" ? "unresolved" : resolved.slugs;
78
77
  const [breakdown, totals, previous] = await Promise.all([
79
78
  readForWidgetBreakdown({
80
79
  ...shared,
@@ -83,7 +82,8 @@ const readForWidgetGoals = async (args) => {
83
82
  dimension: "goal",
84
83
  limit,
85
84
  extraMetrics: ["revenue", "visitors"],
86
- goalSlugs
85
+ goalSlugs,
86
+ builtinGoalSlugs
87
87
  }),
88
88
  adapter.capabilities.metrics.has("visitors") ? readForWidget({
89
89
  ...shared,
@@ -97,39 +97,43 @@ const readForWidgetGoals = async (args) => {
97
97
  metric: "conversions",
98
98
  dimension: "goal",
99
99
  limit: previousLimit(limit),
100
- goalSlugs
100
+ goalSlugs,
101
+ builtinGoalSlugs
101
102
  }) : void 0
102
103
  ]);
103
- if (breakdown.status !== "ok") return fallback(breakdown.status, breakdown.adapterId, {
104
- dateRange,
105
- timezone: tz
106
- });
107
- const previousBySlug = new Map((previous?.status === "ok" ? previous.rows : []).map((row) => [row.label, row.value]));
108
- const siteVisitors = totals?.status === "ok" ? totals.metrics.visitors : void 0;
104
+ if (breakdown.status !== "ok") return {
105
+ ...fallback(breakdown.status, breakdown.adapterId, {
106
+ dateRange,
107
+ timezone: tz
108
+ }),
109
+ ...breakdown.retryAfterMs === void 0 ? {} : { retryAfterMs: breakdown.retryAfterMs }
110
+ };
111
+ const previousBySlug = new Map((previous?.status === "ok" ? previous.rows : []).map((row) => [row.dimensionValue, row.value]));
112
+ const visitorTotal = totals?.status === "ok" ? totals.metrics.visitors : void 0;
113
+ const siteVisitors = typeof visitorTotal === "number" ? visitorTotal : void 0;
109
114
  const rows = breakdown.rows.map((row) => {
110
115
  const rate = conversionRate(row.metrics?.visitors, siteVisitors);
111
- const previousConversions = previousBySlug.get(row.label);
116
+ const previousConversions = previousBySlug.get(row.dimensionValue);
117
+ const revenue = row.metrics?.revenue;
112
118
  return {
113
- slug: row.label,
114
- name: names.get(row.label) ?? row.label,
115
- conversions: row.value,
116
- ...row.metrics?.revenue !== void 0 ? { revenue: row.metrics.revenue } : {},
119
+ slug: row.dimensionValue,
120
+ name: names.get(row.dimensionValue) ?? row.dimensionValue,
121
+ conversions: row.value ?? 0,
122
+ ...typeof revenue === "number" ? { revenue } : {},
117
123
  ...rate !== null ? { rate } : {},
118
- ...previousConversions !== void 0 ? { previousConversions } : {}
124
+ ...typeof previousConversions === "number" ? { previousConversions } : {}
119
125
  };
120
126
  }).sort((a, b) => b.conversions - a.conversions).slice(0, limit);
121
127
  return {
122
128
  status: "ok",
123
129
  adapterId: adapter.id,
130
+ ...pinnedScope(args, prepared.queryScope),
124
131
  dateRange,
125
132
  timezone: tz,
126
133
  rows,
127
134
  ...siteVisitors !== void 0 ? { siteVisitors } : {},
128
135
  ...breakdown.provider === void 0 ? {} : { provider: breakdown.provider },
129
- clamped: Boolean(breakdown.clamped || totals?.clamped || previous?.clamped),
130
- stale: Boolean(breakdown.stale || totals?.stale || previous?.stale),
131
- filtersUnapplied: Boolean(breakdown.filtersUnapplied || totals?.filtersUnapplied || previous?.filtersUnapplied),
132
- sampled: Boolean(breakdown.sampled || totals?.sampled || previous?.sampled),
136
+ ...mergeNotices(breakdown, totals, previous),
133
137
  goalsUnresolved: breakdown.goalsUnresolved === true,
134
138
  noGoals: breakdown.noGoals === true
135
139
  };
@@ -1 +1 @@
1
- {"version":3,"file":"readForWidgetGoals.js","names":[],"sources":["../../src/widgets/readForWidgetGoals.ts"],"sourcesContent":["import type { PayloadRequest } from 'payload'\nimport { comparisonOf } from '../core/capabilities'\nimport type { DateRange } from '../core/contract'\nimport { type AnalyticsRuntime, resolveGoalsDetailedFor } from '../plugin/runtime'\nimport { MAX_QUERY_LIMIT } from '../query/limits'\nimport type { TimeframePreset } from '../timeframe/presets'\nimport { conversionRate } from '../view/conversionRate'\nimport { previousWindow, withinLookback } from './comparison'\nimport { prepareWidgetRead, type WidgetReadStatus } from './prepareWidgetRead'\nimport { readForWidget } from './readForWidget'\nimport { readForWidgetBreakdown } from './readForWidgetBreakdown'\n\nexport interface GoalRow {\n\tslug: string\n\t/** The goal's admin-facing name, or its slug when no configured goal claims it. */\n\tname: string\n\tconversions: number\n\trevenue?: number\n\t/** 0..1 share of the site's visitors, absent when either side of the ratio is missing. */\n\trate?: number\n\tpreviousConversions?: number\n}\n\nexport interface WidgetGoalsResult {\n\tstatus: WidgetReadStatus\n\tadapterId: string\n\tdateRange: DateRange\n\ttimezone: string\n\trows: GoalRow[]\n\t/** Range total the rate divides by; absent when the source does not serve visitors. */\n\tsiteVisitors?: number\n\t/** The source that answered, absent on a read that never reached one. */\n\tprovider?: string\n\tclamped?: boolean\n\tstale?: boolean\n\t/** True when the source answered without one of the filters a read carried. */\n\tfiltersUnapplied?: boolean\n\t/** True when a read hit the source's event scan cap, so the numbers are a floor. */\n\tsampled?: boolean\n\t/** True when the source could not read the scope's goals, so the empty table means nothing. */\n\tgoalsUnresolved?: boolean\n\t/** True when the scope configures no goals at all, which is an empty table, not a failure. */\n\tnoGoals?: boolean\n}\n\nexport interface ReadForWidgetGoalsArgs {\n\treq: PayloadRequest\n\ttimeframe: TimeframePreset\n\tlimit: number\n\t/** Read the previous window too, when the source can compare. */\n\tcompare: boolean\n\tadapterId?: string\n\tnow: Date\n\trange?: DateRange\n\t/** Explicit scope override; omitted resolves via the plugin's scopeResolver. */\n\tscope?: string | null\n\t/**\n\t * Reporting timezone the caller already resolved, reused rather than resolved again so\n\t * a caller-supplied `range` is read in the very timezone it was interpreted in.\n\t */\n\ttimezone?: string\n}\n\n/**\n * How much wider than the table the previous window is read. Both windows rank by their own\n * conversions, so a goal in today's top rows may sit well below them in the previous window;\n * reading only as many rows as the table shows would drop exactly those deltas. Capped at\n * the bound every analytics query is held to.\n */\nconst PREVIOUS_LIMIT_FACTOR = 4\n\nconst previousLimit = (limit: number): number =>\n\tMath.min(limit * PREVIOUS_LIMIT_FACTOR, MAX_QUERY_LIMIT)\n\n/**\n * Goal names for the read's own scope. A resolver that throws must not cost the widget its\n * table, so the rows fall back to their slugs; the failure travels on as the hint, which is\n * what tells the read apart from a scope that configured no goals at all.\n */\nconst goalNames = async (\n\truntime: AnalyticsRuntime,\n\treq: PayloadRequest,\n\tscope: string | null\n): Promise<Map<string, string> | 'unresolved'> => {\n\ttry {\n\t\tconst resolved = await resolveGoalsDetailedFor(runtime, req, scope)\n\t\treturn new Map(resolved.map(({ goal }) => [goal.slug, goal.name]))\n\t} catch (err) {\n\t\treq.payload.logger?.warn(`analytics: widget goal names failed to resolve: ${String(err)}`)\n\t\treturn 'unresolved'\n\t}\n}\n\n/**\n * The goals table behind the goals widget: conversions per goal over the window, each with\n * its revenue, its share of the site's visitors, and (when comparing) the same goal's\n * conversions in the previous window. Rows come from one `goal` breakdown read and the site\n * total from one totals read, both through the existing widget helpers so capability\n * gating, scoping and caching stay in one place. Revenue and visitors ride along only where\n * the source serves them; the status is the breakdown's, since a table without its rows has\n * nothing to show.\n */\nexport const readForWidgetGoals = async (\n\targs: ReadForWidgetGoalsArgs\n): Promise<WidgetGoalsResult> => {\n\tconst { req, timeframe, limit, compare, adapterId, now } = args\n\tconst fallback = (\n\t\tstatus: WidgetReadStatus,\n\t\tid: string,\n\t\twindow: { dateRange: DateRange; timezone: string }\n\t): WidgetGoalsResult => ({ status, adapterId: id, rows: [], ...window })\n\n\tconst prepared = await prepareWidgetRead({\n\t\treq,\n\t\tnow,\n\t\ttimeframe,\n\t\tadapterId,\n\t\tscope: args.scope,\n\t\ttimezone: args.timezone,\n\t\trange: args.range,\n\t})\n\tif (!prepared.ok) {\n\t\treturn fallback(prepared.status, prepared.adapterId, {\n\t\t\tdateRange: prepared.dateRange,\n\t\t\ttimezone: prepared.tz,\n\t\t})\n\t}\n\tconst { runtime, adapter, tz, dateRange } = prepared\n\t// The sub-reads resolve their own context; pinning the adapter, scope, timezone and\n\t// window keeps all three answering about exactly the same read.\n\tconst shared = { req, timeframe, adapterId: adapter.id, scope: prepared.scope, timezone: tz, now }\n\tconst previousRange =\n\t\tcompare && runtime.comparison && comparisonOf(adapter.capabilities)\n\t\t\t? previousWindow(dateRange, tz)\n\t\t\t: null\n\tconst comparisonRange =\n\t\tpreviousRange &&\n\t\twithinLookback(previousRange, adapter.capabilities.maxLookbackDays, { tz, now })\n\t\t\t? previousRange\n\t\t\t: undefined\n\n\t// The names are resolved first: their slugs are the hint a provider source restricts its\n\t// goal rows to, so both reads below need them before they run.\n\tconst resolved = await goalNames(runtime, req, prepared.scope)\n\tconst names = resolved === 'unresolved' ? new Map<string, string>() : resolved\n\tconst goalSlugs = resolved === 'unresolved' ? 'unresolved' : [...names.keys()]\n\tconst [breakdown, totals, previous] = await Promise.all([\n\t\treadForWidgetBreakdown({\n\t\t\t...shared,\n\t\t\trange: dateRange,\n\t\t\tmetric: 'conversions',\n\t\t\tdimension: 'goal',\n\t\t\tlimit,\n\t\t\textraMetrics: ['revenue', 'visitors'],\n\t\t\tgoalSlugs,\n\t\t}),\n\t\tadapter.capabilities.metrics.has('visitors')\n\t\t\t? // The site total is a denominator, never a delta: its own previous window would\n\t\t\t\t// be a second read nothing renders.\n\t\t\t\treadForWidget({ ...shared, range: dateRange, metrics: ['visitors'], comparison: false })\n\t\t\t: undefined,\n\t\tcomparisonRange\n\t\t\t? readForWidgetBreakdown({\n\t\t\t\t\t...shared,\n\t\t\t\t\trange: comparisonRange,\n\t\t\t\t\tmetric: 'conversions',\n\t\t\t\t\tdimension: 'goal',\n\t\t\t\t\tlimit: previousLimit(limit),\n\t\t\t\t\tgoalSlugs,\n\t\t\t\t})\n\t\t\t: undefined,\n\t])\n\tif (breakdown.status !== 'ok') {\n\t\treturn fallback(breakdown.status, breakdown.adapterId, { dateRange, timezone: tz })\n\t}\n\n\tconst previousBySlug = new Map(\n\t\t(previous?.status === 'ok' ? previous.rows : []).map((row) => [row.label, row.value])\n\t)\n\tconst siteVisitors = totals?.status === 'ok' ? totals.metrics.visitors : undefined\n\tconst rows: GoalRow[] = breakdown.rows\n\t\t.map((row) => {\n\t\t\tconst rate = conversionRate(row.metrics?.visitors, siteVisitors)\n\t\t\tconst previousConversions = previousBySlug.get(row.label)\n\t\t\treturn {\n\t\t\t\tslug: row.label,\n\t\t\t\tname: names.get(row.label) ?? row.label,\n\t\t\t\tconversions: row.value,\n\t\t\t\t...(row.metrics?.revenue !== undefined ? { revenue: row.metrics.revenue } : {}),\n\t\t\t\t...(rate !== null ? { rate } : {}),\n\t\t\t\t...(previousConversions !== undefined ? { previousConversions } : {}),\n\t\t\t}\n\t\t})\n\t\t// The adapter ranks and caps already; re-applying both keeps one that does not from\n\t\t// spilling a long, unranked table into a dashboard card.\n\t\t.sort((a, b) => b.conversions - a.conversions)\n\t\t.slice(0, limit)\n\n\treturn {\n\t\tstatus: 'ok',\n\t\tadapterId: adapter.id,\n\t\tdateRange,\n\t\ttimezone: tz,\n\t\trows,\n\t\t...(siteVisitors !== undefined ? { siteVisitors } : {}),\n\t\t...(breakdown.provider === undefined ? {} : { provider: breakdown.provider }),\n\t\tclamped: Boolean(breakdown.clamped || totals?.clamped || previous?.clamped),\n\t\tstale: Boolean(breakdown.stale || totals?.stale || previous?.stale),\n\t\tfiltersUnapplied: Boolean(\n\t\t\tbreakdown.filtersUnapplied || totals?.filtersUnapplied || previous?.filtersUnapplied\n\t\t),\n\t\tsampled: Boolean(breakdown.sampled || totals?.sampled || previous?.sampled),\n\t\tgoalsUnresolved: breakdown.goalsUnresolved === true,\n\t\tnoGoals: breakdown.noGoals === true,\n\t}\n}\n"],"mappings":"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"}
1
+ {"version":3,"file":"readForWidgetGoals.js","names":[],"sources":["../../src/widgets/readForWidgetGoals.ts"],"sourcesContent":["import type { PayloadRequest } from 'payload'\nimport { type ReadPrincipal, readPrincipalOf } from '../access/principal'\nimport type { DateRange } from '../core/contract'\nimport { type AnalyticsRuntime, goalNamesFor, resolveGoalsDetailedFor } from '../plugin/runtime'\nimport { MAX_QUERY_LIMIT } from '../query/limits'\nimport type { TimeframePreset } from '../timeframe/presets'\nimport { conversionRate } from '../view/conversionRate'\nimport {\n\tcomparisonWindow,\n\tpinnedScope,\n\tprepareWidgetRead,\n\ttype WidgetReadStatus,\n} from './prepareWidgetRead'\nimport { readForWidget } from './readForWidget'\nimport { readForWidgetBreakdown } from './readForWidgetBreakdown'\nimport { mergeNotices, type ReadNotices } from './readMeta'\n\nexport interface GoalRow {\n\tslug: string\n\t/** The goal's admin-facing name, or its slug when no configured goal claims it. */\n\tname: string\n\tconversions: number\n\trevenue?: number\n\t/** 0..1 share of the site's visitors, absent when either side of the ratio is missing. */\n\trate?: number\n\tpreviousConversions?: number\n}\n\nexport interface WidgetGoalsResult extends Partial<ReadNotices> {\n\tstatus: WidgetReadStatus\n\t/** How long until a `busy` read can succeed, when the source or the plugin knows. */\n\tretryAfterMs?: number\n\tadapterId: string\n\t/**\n\t * Scope a link to this read must name, set only when the viewer would not resolve it alone:\n\t * a needless `scope` refuses every reader without `access.crossScope`.\n\t */\n\tscope?: string\n\tdateRange: DateRange\n\ttimezone: string\n\trows: GoalRow[]\n\t/** Range total the rate divides by; absent when the source does not serve visitors. */\n\tsiteVisitors?: number\n\t/** The source that answered, absent on a read that never reached one. */\n\tprovider?: string\n\t/** True when the scope declares no goals of its own: an empty table, not a failure. */\n\tnoGoals?: boolean\n}\n\n/** Scoped like `ReadForWidgetArgs`: the request's own scope unless one is pinned. */\nexport type ReadForWidgetGoalsArgs = ReadPrincipal & {\n\treq: PayloadRequest\n\ttimeframe: TimeframePreset\n\tlimit: number\n\t/** Read the previous window too, when the source can compare. */\n\tcompare: boolean\n\tadapterId?: string\n\tnow: Date\n\trange?: DateRange\n\t/**\n\t * Reporting timezone the caller already resolved, reused rather than resolved again so\n\t * a caller-supplied `range` is read in the very timezone it was interpreted in.\n\t */\n\ttimezone?: string\n}\n\n/**\n * How much wider than the table the previous window is read: each window ranks by its own\n * conversions, so a goal in today's top rows may rank too low there to keep its delta.\n */\nconst PREVIOUS_LIMIT_FACTOR = 4\n\nconst previousLimit = (limit: number): number =>\n\tMath.min(limit * PREVIOUS_LIMIT_FACTOR, MAX_QUERY_LIMIT)\n\n/**\n * The scope's goal slugs and their display names. A throwing resolver must not cost the table:\n * rows fall back to slugs and `'unresolved'` tells the read apart from a scope with no goals.\n */\nconst goalNames = async (\n\truntime: AnalyticsRuntime,\n\treq: PayloadRequest,\n\tscope: string | null\n): Promise<{ slugs: string[]; names: Map<string, string>; builtin: string[] } | 'unresolved'> => {\n\ttry {\n\t\tconst resolved = await resolveGoalsDetailedFor(runtime, req, scope)\n\t\tconst shown = await goalNamesFor({ runtime, req, scope, resolved })\n\t\treturn {\n\t\t\tslugs: resolved.map(({ goal }) => goal.slug),\n\t\t\tnames: new Map(shown.map((goal) => [goal.slug, goal.name])),\n\t\t\tbuiltin: resolved.filter((entry) => entry.source === 'builtin').map(({ goal }) => goal.slug),\n\t\t}\n\t} catch (err) {\n\t\treq.payload.logger?.warn(`analytics: widget goal names failed to resolve: ${String(err)}`)\n\t\treturn 'unresolved'\n\t}\n}\n\n/**\n * Goals table from a `goal` breakdown, a visitors total for the rate and, when comparing, the\n * previous window's breakdown. Status is the breakdown's: a table without rows shows nothing.\n */\nexport const readForWidgetGoals = async (\n\targs: ReadForWidgetGoalsArgs\n): Promise<WidgetGoalsResult> => {\n\tconst { req, timeframe, limit, compare, adapterId, now } = args\n\tconst fallback = (\n\t\tstatus: WidgetReadStatus,\n\t\tid: string,\n\t\twindow: { dateRange: DateRange; timezone: string }\n\t): WidgetGoalsResult => ({ status, adapterId: id, rows: [], ...window })\n\n\tconst prepared = await prepareWidgetRead({\n\t\treq,\n\t\tnow,\n\t\ttimeframe,\n\t\tadapterId,\n\t\t...readPrincipalOf(args),\n\t\ttimezone: args.timezone,\n\t\trange: args.range,\n\t})\n\tif (!prepared.ok) {\n\t\treturn fallback(prepared.status, prepared.adapterId, {\n\t\t\tdateRange: prepared.dateRange,\n\t\t\ttimezone: prepared.tz,\n\t\t})\n\t}\n\tconst { runtime, adapter, tz, dateRange } = prepared\n\t// The sub-reads resolve their own context; pinning the adapter, scope, timezone and\n\t// window keeps all three answering about exactly the same read.\n\tconst shared = { req, timeframe, adapterId: adapter.id, ...prepared.pin, timezone: tz, now }\n\tconst comparisonRange = compare ? comparisonWindow(prepared, now) : undefined\n\n\t// The names are resolved first: their slugs are the hint a provider source restricts its\n\t// goal rows to, so both reads below need them before they run.\n\tconst resolved = await goalNames(runtime, req, prepared.scope)\n\tconst names = resolved === 'unresolved' ? new Map<string, string>() : resolved.names\n\tconst builtinGoalSlugs = resolved === 'unresolved' ? [] : resolved.builtin\n\tconst goalSlugs = resolved === 'unresolved' ? 'unresolved' : resolved.slugs\n\tconst [breakdown, totals, previous] = await Promise.all([\n\t\treadForWidgetBreakdown({\n\t\t\t...shared,\n\t\t\trange: dateRange,\n\t\t\tmetric: 'conversions',\n\t\t\tdimension: 'goal',\n\t\t\tlimit,\n\t\t\textraMetrics: ['revenue', 'visitors'],\n\t\t\tgoalSlugs,\n\t\t\tbuiltinGoalSlugs,\n\t\t}),\n\t\tadapter.capabilities.metrics.has('visitors')\n\t\t\t? // The site total is a denominator, never a delta: its own previous window would\n\t\t\t\t// be a second read nothing renders.\n\t\t\t\treadForWidget({ ...shared, range: dateRange, metrics: ['visitors'], comparison: false })\n\t\t\t: undefined,\n\t\tcomparisonRange\n\t\t\t? readForWidgetBreakdown({\n\t\t\t\t\t...shared,\n\t\t\t\t\trange: comparisonRange,\n\t\t\t\t\tmetric: 'conversions',\n\t\t\t\t\tdimension: 'goal',\n\t\t\t\t\tlimit: previousLimit(limit),\n\t\t\t\t\tgoalSlugs,\n\t\t\t\t\tbuiltinGoalSlugs,\n\t\t\t\t})\n\t\t\t: undefined,\n\t])\n\tif (breakdown.status !== 'ok') {\n\t\treturn {\n\t\t\t...fallback(breakdown.status, breakdown.adapterId, { dateRange, timezone: tz }),\n\t\t\t...(breakdown.retryAfterMs === undefined ? {} : { retryAfterMs: breakdown.retryAfterMs }),\n\t\t}\n\t}\n\n\tconst previousBySlug = new Map(\n\t\t(previous?.status === 'ok' ? previous.rows : []).map((row) => [row.dimensionValue, row.value])\n\t)\n\tconst visitorTotal = totals?.status === 'ok' ? totals.metrics.visitors : undefined\n\tconst siteVisitors = typeof visitorTotal === 'number' ? visitorTotal : undefined\n\tconst rows: GoalRow[] = breakdown.rows\n\t\t.map((row) => {\n\t\t\tconst rate = conversionRate(row.metrics?.visitors, siteVisitors)\n\t\t\tconst previousConversions = previousBySlug.get(row.dimensionValue)\n\t\t\tconst revenue = row.metrics?.revenue\n\t\t\treturn {\n\t\t\t\tslug: row.dimensionValue,\n\t\t\t\tname: names.get(row.dimensionValue) ?? row.dimensionValue,\n\t\t\t\tconversions: row.value ?? 0,\n\t\t\t\t...(typeof revenue === 'number' ? { revenue } : {}),\n\t\t\t\t...(rate !== null ? { rate } : {}),\n\t\t\t\t...(typeof previousConversions === 'number' ? { previousConversions } : {}),\n\t\t\t}\n\t\t})\n\t\t// The adapter ranks and caps already; re-applying both keeps one that does not from\n\t\t// spilling a long, unranked table into a dashboard card.\n\t\t.sort((a, b) => b.conversions - a.conversions)\n\t\t.slice(0, limit)\n\n\treturn {\n\t\tstatus: 'ok',\n\t\tadapterId: adapter.id,\n\t\t// The caller's own scope, not the one this pinned onto its sub-reads: those are always\n\t\t// explicitly scoped, so reading their answer back would name every viewer's own scope.\n\t\t...pinnedScope(args, prepared.queryScope),\n\t\tdateRange,\n\t\ttimezone: tz,\n\t\trows,\n\t\t...(siteVisitors !== undefined ? { siteVisitors } : {}),\n\t\t...(breakdown.provider === undefined ? {} : { provider: breakdown.provider }),\n\t\t...mergeNotices(breakdown, totals, previous),\n\t\tgoalsUnresolved: breakdown.goalsUnresolved === true,\n\t\tnoGoals: breakdown.noGoals === true,\n\t}\n}\n"],"mappings":"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"}
@@ -1,40 +1,44 @@
1
1
  import { MetricKey } from "../core/contract.js";
2
+ import { ReadNotices } from "./readMeta.js";
3
+ import { ReadPrincipal } from "../access/principal.js";
2
4
  import { PayloadRequest } from "payload";
3
5
 
4
6
  //#region src/widgets/readForWidgetRealtime.d.ts
5
- type WidgetRealtimeStatus = 'ok' | 'not-configured' | 'unavailable';
7
+ /**
8
+ * What the live count reports: `unavailable` a source counting no one live, `busy` one that failed
9
+ * to count for now, `misconfigured` and `host-refused` one whose setup refused the read.
10
+ */
11
+ type WidgetRealtimeStatus = 'ok' | 'not-configured' | 'unavailable' | 'busy' | 'invalid' | 'no-access' | 'no-scope' | 'misconfigured' | 'host-refused';
6
12
  interface RealtimePoint {
7
13
  date: string;
8
14
  value: number;
9
15
  }
10
- interface WidgetRealtimeResult {
16
+ interface WidgetRealtimeResult extends Partial<ReadNotices> {
11
17
  status: WidgetRealtimeStatus;
18
+ /** How long until a `busy` read can succeed, when the source or the plugin knows. */
19
+ retryAfterMs?: number;
12
20
  adapterId: string;
21
+ /** The window's total for the metric that was asked for, not visitors specifically. */
13
22
  activeNow: number;
14
23
  series: RealtimePoint[];
15
24
  /** The source that answered, absent on a read that never reached one. */
16
25
  provider?: string;
17
- clamped?: boolean;
18
- stale?: boolean;
19
- filtersUnapplied?: boolean;
20
- goalsUnresolved?: boolean;
21
- /** True when the read hit the source's event scan cap, so the counts are a floor. */
22
- sampled?: boolean;
26
+ /** The scope the read narrowed to, absent for an install-wide one. */
27
+ scope?: string;
23
28
  }
24
- interface ReadForWidgetRealtimeArgs {
29
+ /** Scoped like `ReadForWidgetArgs`: the request's own scope unless one is pinned. */
30
+ type ReadForWidgetRealtimeArgs = ReadPrincipal & {
25
31
  req: PayloadRequest;
26
32
  metric: MetricKey;
27
33
  windowMinutes: number;
28
34
  adapterId?: string;
29
- now: Date;
30
- /** Explicit scope override; omitted resolves via the plugin's scopeResolver. */
31
- scope?: string | null;
32
- }
35
+ now: Date; /** Count only the visitors on this path; omitted counts the whole site. */
36
+ path?: string; /** False reads the window's total alone, its `series` left empty. Default true. */
37
+ series?: boolean;
38
+ };
33
39
  /**
34
- * Site-wide realtime read for the "active now" widget. The window arrives as a
35
- * dateRange (now - windowMinutes -> now). Cached under a realtime-specific key bucketed
36
- * to the realtime TTL: it is deliberately NOT routed through the engine, whose key
37
- * day-snaps the range (so a "last 30 min" read would collide with a "today" aggregate).
40
+ * Realtime read for the "active now" widget, memoized in-process only (a by-the-minute count is
41
+ * not worth a cache write) and keyed here, since the engine's key day-snaps the range.
38
42
  */
39
43
  declare const readForWidgetRealtime: (args: ReadForWidgetRealtimeArgs) => Promise<WidgetRealtimeResult>;
40
44
  //#endregion
@@ -1,7 +1,9 @@
1
- import { cacheEpochFor } from "../plugin/runtime.js";
1
+ import { readPrincipalOf } from "../access/principal.js";
2
+ import { cacheEpochsFor } from "../plugin/runtime.js";
3
+ import { readFailureOf } from "../surfacing/classifyError.js";
4
+ import { buildRealtimeKey } from "../core/cacheKey.js";
2
5
  import { prepareWidgetRead } from "./prepareWidgetRead.js";
3
6
  import { readMeta } from "./readMeta.js";
4
- import { kvCacheStore } from "../surfacing/cacheStore.js";
5
7
  //#region src/widgets/readForWidgetRealtime.ts
6
8
  const empty = (status, adapterId) => ({
7
9
  status,
@@ -9,14 +11,10 @@ const empty = (status, adapterId) => ({
9
11
  activeNow: 0,
10
12
  series: []
11
13
  });
12
- /**
13
- * Site-wide realtime read for the "active now" widget. The window arrives as a
14
- * dateRange (now - windowMinutes -> now). Cached under a realtime-specific key bucketed
15
- * to the realtime TTL: it is deliberately NOT routed through the engine, whose key
16
- * day-snaps the range (so a "last 30 min" read would collide with a "today" aggregate).
17
- */
18
- const readForWidgetRealtime = async (args) => {
19
- const { req, metric, windowMinutes, adapterId, now } = args;
14
+ /** The live count both callers share; `failed` answers for a source read that throws. */
15
+ const readRealtime = async (args, failed) => {
16
+ const { req, metric, windowMinutes, adapterId, now, path } = args;
17
+ const series = args.series ?? true;
20
18
  const dateRange = {
21
19
  start: /* @__PURE__ */ new Date(now.getTime() - windowMinutes * 6e4),
22
20
  end: now
@@ -27,26 +25,38 @@ const readForWidgetRealtime = async (args) => {
27
25
  range: dateRange,
28
26
  timezone: "UTC",
29
27
  adapterId,
30
- scope: args.scope,
28
+ ...readPrincipalOf(args),
31
29
  requires: { realtime: true }
32
30
  });
33
- if (!prepared.ok) return empty(prepared.status === "not-configured" ? "not-configured" : "unavailable", prepared.adapterId);
31
+ if (!prepared.ok) return empty(prepared.status === "not-configured" || prepared.status === "no-access" || prepared.status === "no-scope" ? prepared.status : "unavailable", prepared.adapterId);
34
32
  const { runtime, adapter, queryScope } = prepared;
35
33
  const realtime = adapter.realtime;
36
34
  if (!realtime) return empty("unavailable", adapter.id);
37
35
  const ttlSeconds = runtime.ttl.realtime ?? adapter.capabilities.recommendedTtl.realtime;
38
- const bucket = Math.floor(now.getTime() / 1e3 / Math.max(1, ttlSeconds));
39
- const scopeKey = queryScope === void 0 ? "" : `:${encodeURIComponent(queryScope)}`;
40
- const key = `rt:e${await cacheEpochFor(runtime, queryScope)}:${adapter.id}:${metric}:${windowMinutes}:${bucket}${scopeKey}`;
41
- const store = kvCacheStore(req.payload.kv);
42
- const cached = await store.get(key);
43
- if (cached) return cached;
44
- const result = await realtime({
45
- metrics: [metric],
46
- dateRange,
47
- scope: queryScope
48
- }, {});
49
- const out = {
36
+ const key = buildRealtimeKey(adapter.id, {
37
+ metric,
38
+ windowMinutes,
39
+ series,
40
+ ...queryScope === void 0 ? {} : { scope: queryScope },
41
+ ...path === void 0 ? {} : { path }
42
+ }, await cacheEpochsFor(runtime, queryScope));
43
+ let result = runtime.memo?.get(key);
44
+ if (!result) {
45
+ const query = {
46
+ metrics: [metric],
47
+ dateRange,
48
+ scope: queryScope,
49
+ ...path === void 0 ? {} : { path },
50
+ ...series ? { granularity: "minute" } : {}
51
+ };
52
+ try {
53
+ result = runtime.engine.realtime ? await runtime.engine.realtime(adapter, query) : await realtime.call(adapter, query, { payload: req.payload });
54
+ } catch (err) {
55
+ return failed(err, adapter.id);
56
+ }
57
+ runtime.memo?.set(key, result, ttlSeconds * 1e3);
58
+ }
59
+ return {
50
60
  status: "ok",
51
61
  adapterId: adapter.id,
52
62
  activeNow: result.totals?.[metric] ?? 0,
@@ -54,12 +64,26 @@ const readForWidgetRealtime = async (args) => {
54
64
  date: r.timestamp ?? "",
55
65
  value: r.metrics[metric] ?? 0
56
66
  })),
67
+ ...queryScope === void 0 ? {} : { scope: queryScope },
57
68
  ...readMeta(result)
58
69
  };
59
- await store.set(key, out, ttlSeconds);
60
- return out;
61
70
  };
71
+ /**
72
+ * Realtime read for the "active now" widget, memoized in-process only (a by-the-minute count is
73
+ * not worth a cache write) and keyed here, since the engine's key day-snaps the range.
74
+ */
75
+ const readForWidgetRealtime = (args) => readRealtime(args, (err, adapterId) => {
76
+ const { status, retryAfterMs } = readFailureOf(err);
77
+ return {
78
+ ...empty(status, adapterId),
79
+ ...retryAfterMs === void 0 ? {} : { retryAfterMs }
80
+ };
81
+ });
82
+ /** The same read for the live endpoint, which answers a failed read with its own error response. */
83
+ const readRealtimeOrThrow = (args) => readRealtime(args, (err) => {
84
+ throw err;
85
+ });
62
86
  //#endregion
63
- export { readForWidgetRealtime };
87
+ export { readForWidgetRealtime, readRealtimeOrThrow };
64
88
 
65
89
  //# sourceMappingURL=readForWidgetRealtime.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"readForWidgetRealtime.js","names":[],"sources":["../../src/widgets/readForWidgetRealtime.ts"],"sourcesContent":["import type { PayloadRequest } from 'payload'\nimport type { MetricKey } from '../core/contract'\nimport { cacheEpochFor } from '../plugin/runtime'\nimport { kvCacheStore } from '../surfacing/cacheStore'\nimport { DEFAULT_TIMEZONE } from '../timeframe/tz'\nimport { prepareWidgetRead } from './prepareWidgetRead'\nimport { readMeta } from './readMeta'\n\nexport type WidgetRealtimeStatus = 'ok' | 'not-configured' | 'unavailable'\n\nexport interface RealtimePoint {\n\tdate: string\n\tvalue: number\n}\n\nexport interface WidgetRealtimeResult {\n\tstatus: WidgetRealtimeStatus\n\tadapterId: string\n\tactiveNow: number\n\tseries: RealtimePoint[]\n\t/** The source that answered, absent on a read that never reached one. */\n\tprovider?: string\n\tclamped?: boolean\n\tstale?: boolean\n\tfiltersUnapplied?: boolean\n\tgoalsUnresolved?: boolean\n\t/** True when the read hit the source's event scan cap, so the counts are a floor. */\n\tsampled?: boolean\n}\n\nexport interface ReadForWidgetRealtimeArgs {\n\treq: PayloadRequest\n\tmetric: MetricKey\n\twindowMinutes: number\n\tadapterId?: string\n\tnow: Date\n\t/** Explicit scope override; omitted resolves via the plugin's scopeResolver. */\n\tscope?: string | null\n}\n\nconst empty = (status: WidgetRealtimeStatus, adapterId: string): WidgetRealtimeResult => ({\n\tstatus,\n\tadapterId,\n\tactiveNow: 0,\n\tseries: [],\n})\n\n/**\n * Site-wide realtime read for the \"active now\" widget. The window arrives as a\n * dateRange (now - windowMinutes -> now). Cached under a realtime-specific key bucketed\n * to the realtime TTL: it is deliberately NOT routed through the engine, whose key\n * day-snaps the range (so a \"last 30 min\" read would collide with a \"today\" aggregate).\n */\nexport const readForWidgetRealtime = async (\n\targs: ReadForWidgetRealtimeArgs\n): Promise<WidgetRealtimeResult> => {\n\tconst { req, metric, windowMinutes, adapterId, now } = args\n\tconst dateRange = { start: new Date(now.getTime() - windowMinutes * 60_000), end: now }\n\t// The window is anchored on `now` and never rendered in a zone, so the poll skips the\n\t// install's timezone resolver rather than paying for it ahead of the cache check.\n\tconst prepared = await prepareWidgetRead({\n\t\treq,\n\t\tnow,\n\t\trange: dateRange,\n\t\ttimezone: DEFAULT_TIMEZONE,\n\t\tadapterId,\n\t\tscope: args.scope,\n\t\trequires: { realtime: true },\n\t})\n\tif (!prepared.ok) {\n\t\t// The window carries no filters, so `filter-unsupported` cannot arise here.\n\t\tconst status = prepared.status === 'not-configured' ? 'not-configured' : 'unavailable'\n\t\treturn empty(status, prepared.adapterId)\n\t}\n\tconst { runtime, adapter, queryScope } = prepared\n\t// The capability says the source counts live visitors; the hook is what reads them.\n\tconst realtime = adapter.realtime\n\tif (!realtime) {\n\t\treturn empty('unavailable', adapter.id)\n\t}\n\n\tconst ttlSeconds = runtime.ttl.realtime ?? adapter.capabilities.recommendedTtl.realtime\n\tconst bucket = Math.floor(now.getTime() / 1000 / Math.max(1, ttlSeconds))\n\tconst scopeKey = queryScope === undefined ? '' : `:${encodeURIComponent(queryScope)}`\n\t// This key is built outside the engine, so it carries the scope's epoch itself.\n\tconst epoch = await cacheEpochFor(runtime, queryScope)\n\tconst key = `rt:e${epoch}:${adapter.id}:${metric}:${windowMinutes}:${bucket}${scopeKey}`\n\tconst store = kvCacheStore(req.payload.kv)\n\tconst cached = await store.get<WidgetRealtimeResult>(key)\n\tif (cached) {\n\t\treturn cached\n\t}\n\n\tconst result = await realtime({ metrics: [metric], dateRange, scope: queryScope }, {})\n\tconst out: WidgetRealtimeResult = {\n\t\tstatus: 'ok',\n\t\tadapterId: adapter.id,\n\t\tactiveNow: result.totals?.[metric] ?? 0,\n\t\tseries: result.rows.map((r) => ({ date: r.timestamp ?? '', value: r.metrics[metric] ?? 0 })),\n\t\t...readMeta(result),\n\t}\n\tawait store.set(key, out, ttlSeconds)\n\treturn out\n}\n"],"mappings":";;;;;AAwCA,MAAM,SAAS,QAA8B,eAA6C;CACzF;CACA;CACA,WAAW;CACX,QAAQ,CAAC;AACV;;;;;;;AAQA,MAAa,wBAAwB,OACpC,SACmC;CACnC,MAAM,EAAE,KAAK,QAAQ,eAAe,WAAW,QAAQ;CACvD,MAAM,YAAY;EAAE,uBAAO,IAAI,KAAK,IAAI,QAAQ,IAAI,gBAAgB,GAAM;EAAG,KAAK;CAAI;CAGtF,MAAM,WAAW,MAAM,kBAAkB;EACxC;EACA;EACA,OAAO;EACP,UAAA;EACA;EACA,OAAO,KAAK;EACZ,UAAU,EAAE,UAAU,KAAK;CAC5B,CAAC;CACD,IAAI,CAAC,SAAS,IAGb,OAAO,MADQ,SAAS,WAAW,mBAAmB,mBAAmB,eACpD,SAAS,SAAS;CAExC,MAAM,EAAE,SAAS,SAAS,eAAe;CAEzC,MAAM,WAAW,QAAQ;CACzB,IAAI,CAAC,UACJ,OAAO,MAAM,eAAe,QAAQ,EAAE;CAGvC,MAAM,aAAa,QAAQ,IAAI,YAAY,QAAQ,aAAa,eAAe;CAC/E,MAAM,SAAS,KAAK,MAAM,IAAI,QAAQ,IAAI,MAAO,KAAK,IAAI,GAAG,UAAU,CAAC;CACxE,MAAM,WAAW,eAAe,KAAA,IAAY,KAAK,IAAI,mBAAmB,UAAU;CAGlF,MAAM,MAAM,OAAO,MADC,cAAc,SAAS,UAAU,EAC5B,GAAG,QAAQ,GAAG,GAAG,OAAO,GAAG,cAAc,GAAG,SAAS;CAC9E,MAAM,QAAQ,aAAa,IAAI,QAAQ,EAAE;CACzC,MAAM,SAAS,MAAM,MAAM,IAA0B,GAAG;CACxD,IAAI,QACH,OAAO;CAGR,MAAM,SAAS,MAAM,SAAS;EAAE,SAAS,CAAC,MAAM;EAAG;EAAW,OAAO;CAAW,GAAG,CAAC,CAAC;CACrF,MAAM,MAA4B;EACjC,QAAQ;EACR,WAAW,QAAQ;EACnB,WAAW,OAAO,SAAS,WAAW;EACtC,QAAQ,OAAO,KAAK,KAAK,OAAO;GAAE,MAAM,EAAE,aAAa;GAAI,OAAO,EAAE,QAAQ,WAAW;EAAE,EAAE;EAC3F,GAAG,SAAS,MAAM;CACnB;CACA,MAAM,MAAM,IAAI,KAAK,KAAK,UAAU;CACpC,OAAO;AACR"}
1
+ {"version":3,"file":"readForWidgetRealtime.js","names":[],"sources":["../../src/widgets/readForWidgetRealtime.ts"],"sourcesContent":["import type { PayloadRequest } from 'payload'\nimport { type ReadPrincipal, readPrincipalOf } from '../access/principal'\nimport { buildRealtimeKey } from '../core/cacheKey'\nimport type { AnalyticsQuery, AnalyticsResult, MetricKey } from '../core/contract'\nimport { cacheEpochsFor } from '../plugin/runtime'\nimport { readFailureOf } from '../surfacing/classifyError'\nimport { DEFAULT_TIMEZONE } from '../timeframe/tz'\nimport { prepareWidgetRead } from './prepareWidgetRead'\nimport { type ReadNotices, readMeta } from './readMeta'\n\n/**\n * What the live count reports: `unavailable` a source counting no one live, `busy` one that failed\n * to count for now, `misconfigured` and `host-refused` one whose setup refused the read.\n */\nexport type WidgetRealtimeStatus =\n\t| 'ok'\n\t| 'not-configured'\n\t| 'unavailable'\n\t| 'busy'\n\t| 'invalid'\n\t| 'no-access'\n\t| 'no-scope'\n\t| 'misconfigured'\n\t| 'host-refused'\n\nexport interface RealtimePoint {\n\tdate: string\n\tvalue: number\n}\n\nexport interface WidgetRealtimeResult extends Partial<ReadNotices> {\n\tstatus: WidgetRealtimeStatus\n\t/** How long until a `busy` read can succeed, when the source or the plugin knows. */\n\tretryAfterMs?: number\n\tadapterId: string\n\t/** The window's total for the metric that was asked for, not visitors specifically. */\n\tactiveNow: number\n\tseries: RealtimePoint[]\n\t/** The source that answered, absent on a read that never reached one. */\n\tprovider?: string\n\t/** The scope the read narrowed to, absent for an install-wide one. */\n\tscope?: string\n}\n\n/** Scoped like `ReadForWidgetArgs`: the request's own scope unless one is pinned. */\nexport type ReadForWidgetRealtimeArgs = ReadPrincipal & {\n\treq: PayloadRequest\n\tmetric: MetricKey\n\twindowMinutes: number\n\tadapterId?: string\n\tnow: Date\n\t/** Count only the visitors on this path; omitted counts the whole site. */\n\tpath?: string\n\t/** False reads the window's total alone, its `series` left empty. Default true. */\n\tseries?: boolean\n}\n\nconst empty = (status: WidgetRealtimeStatus, adapterId: string): WidgetRealtimeResult => ({\n\tstatus,\n\tadapterId,\n\tactiveNow: 0,\n\tseries: [],\n})\n\n/** The live count both callers share; `failed` answers for a source read that throws. */\nconst readRealtime = async (\n\targs: ReadForWidgetRealtimeArgs,\n\tfailed: (err: unknown, adapterId: string) => WidgetRealtimeResult\n): Promise<WidgetRealtimeResult> => {\n\tconst { req, metric, windowMinutes, adapterId, now, path } = args\n\tconst series = args.series ?? true\n\tconst dateRange = { start: new Date(now.getTime() - windowMinutes * 60_000), end: now }\n\t// The window is anchored on `now` and never rendered in a zone, so the poll skips the\n\t// install's timezone resolver rather than paying for it ahead of the cache check.\n\tconst prepared = await prepareWidgetRead({\n\t\treq,\n\t\tnow,\n\t\trange: dateRange,\n\t\ttimezone: DEFAULT_TIMEZONE,\n\t\tadapterId,\n\t\t...readPrincipalOf(args),\n\t\trequires: { realtime: true },\n\t})\n\tif (!prepared.ok) {\n\t\t// The window carries no filters, so `filter-unsupported` cannot arise here.\n\t\tconst status =\n\t\t\tprepared.status === 'not-configured' ||\n\t\t\tprepared.status === 'no-access' ||\n\t\t\tprepared.status === 'no-scope'\n\t\t\t\t? prepared.status\n\t\t\t\t: 'unavailable'\n\t\treturn empty(status, prepared.adapterId)\n\t}\n\tconst { runtime, adapter, queryScope } = prepared\n\t// The capability says the source counts live visitors; the hook is what reads them.\n\tconst realtime = adapter.realtime\n\tif (!realtime) {\n\t\treturn empty('unavailable', adapter.id)\n\t}\n\n\tconst ttlSeconds = runtime.ttl.realtime ?? adapter.capabilities.recommendedTtl.realtime\n\t// Built outside the engine, so it carries the scope's epochs itself. The path is in it: two\n\t// pages of one site share everything else, so one page's count would otherwise serve the other's.\n\tconst key = buildRealtimeKey(\n\t\tadapter.id,\n\t\t{\n\t\t\tmetric,\n\t\t\twindowMinutes,\n\t\t\tseries,\n\t\t\t...(queryScope === undefined ? {} : { scope: queryScope }),\n\t\t\t...(path === undefined ? {} : { path }),\n\t\t},\n\t\tawait cacheEpochsFor(runtime, queryScope)\n\t)\n\tlet result: AnalyticsResult | undefined = runtime.memo?.get(key)\n\tif (!result) {\n\t\tconst query: AnalyticsQuery = {\n\t\t\tmetrics: [metric],\n\t\t\tdateRange,\n\t\t\tscope: queryScope,\n\t\t\t...(path === undefined ? {} : { path }),\n\t\t\t...(series ? { granularity: 'minute' as const } : {}),\n\t\t}\n\t\t// Through the source's lane like every other read of it, waiting ahead of background work;\n\t\t// the native engine's lane stays its own. A runtime built by hand may have no lanes.\n\t\ttry {\n\t\t\tresult = runtime.engine.realtime\n\t\t\t\t? await runtime.engine.realtime(adapter, query)\n\t\t\t\t: await realtime.call(adapter, query, { payload: req.payload })\n\t\t} catch (err) {\n\t\t\treturn failed(err, adapter.id)\n\t\t}\n\t\truntime.memo?.set(key, result, ttlSeconds * 1000)\n\t}\n\treturn {\n\t\tstatus: 'ok',\n\t\tadapterId: adapter.id,\n\t\tactiveNow: result.totals?.[metric] ?? 0,\n\t\tseries: result.rows.map((r) => ({ date: r.timestamp ?? '', value: r.metrics[metric] ?? 0 })),\n\t\t...(queryScope === undefined ? {} : { scope: queryScope }),\n\t\t...readMeta(result),\n\t}\n}\n\n/**\n * Realtime read for the \"active now\" widget, memoized in-process only (a by-the-minute count is\n * not worth a cache write) and keyed here, since the engine's key day-snaps the range.\n */\nexport const readForWidgetRealtime = (\n\targs: ReadForWidgetRealtimeArgs\n): Promise<WidgetRealtimeResult> =>\n\treadRealtime(args, (err, adapterId) => {\n\t\tconst { status, retryAfterMs } = readFailureOf(err)\n\t\treturn {\n\t\t\t...empty(status, adapterId),\n\t\t\t...(retryAfterMs === undefined ? {} : { retryAfterMs }),\n\t\t}\n\t})\n\n/** The same read for the live endpoint, which answers a failed read with its own error response. */\nexport const readRealtimeOrThrow = (\n\targs: ReadForWidgetRealtimeArgs\n): Promise<WidgetRealtimeResult> =>\n\treadRealtime(args, (err) => {\n\t\tthrow err\n\t})\n"],"mappings":";;;;;;;AAyDA,MAAM,SAAS,QAA8B,eAA6C;CACzF;CACA;CACA,WAAW;CACX,QAAQ,CAAC;AACV;;AAGA,MAAM,eAAe,OACpB,MACA,WACmC;CACnC,MAAM,EAAE,KAAK,QAAQ,eAAe,WAAW,KAAK,SAAS;CAC7D,MAAM,SAAS,KAAK,UAAU;CAC9B,MAAM,YAAY;EAAE,uBAAO,IAAI,KAAK,IAAI,QAAQ,IAAI,gBAAgB,GAAM;EAAG,KAAK;CAAI;CAGtF,MAAM,WAAW,MAAM,kBAAkB;EACxC;EACA;EACA,OAAO;EACP,UAAA;EACA;EACA,GAAG,gBAAgB,IAAI;EACvB,UAAU,EAAE,UAAU,KAAK;CAC5B,CAAC;CACD,IAAI,CAAC,SAAS,IAQb,OAAO,MALN,SAAS,WAAW,oBACpB,SAAS,WAAW,eACpB,SAAS,WAAW,aACjB,SAAS,SACT,eACiB,SAAS,SAAS;CAExC,MAAM,EAAE,SAAS,SAAS,eAAe;CAEzC,MAAM,WAAW,QAAQ;CACzB,IAAI,CAAC,UACJ,OAAO,MAAM,eAAe,QAAQ,EAAE;CAGvC,MAAM,aAAa,QAAQ,IAAI,YAAY,QAAQ,aAAa,eAAe;CAG/E,MAAM,MAAM,iBACX,QAAQ,IACR;EACC;EACA;EACA;EACA,GAAI,eAAe,KAAA,IAAY,CAAC,IAAI,EAAE,OAAO,WAAW;EACxD,GAAI,SAAS,KAAA,IAAY,CAAC,IAAI,EAAE,KAAK;CACtC,GACA,MAAM,eAAe,SAAS,UAAU,CACzC;CACA,IAAI,SAAsC,QAAQ,MAAM,IAAI,GAAG;CAC/D,IAAI,CAAC,QAAQ;EACZ,MAAM,QAAwB;GAC7B,SAAS,CAAC,MAAM;GAChB;GACA,OAAO;GACP,GAAI,SAAS,KAAA,IAAY,CAAC,IAAI,EAAE,KAAK;GACrC,GAAI,SAAS,EAAE,aAAa,SAAkB,IAAI,CAAC;EACpD;EAGA,IAAI;GACH,SAAS,QAAQ,OAAO,WACrB,MAAM,QAAQ,OAAO,SAAS,SAAS,KAAK,IAC5C,MAAM,SAAS,KAAK,SAAS,OAAO,EAAE,SAAS,IAAI,QAAQ,CAAC;EAChE,SAAS,KAAK;GACb,OAAO,OAAO,KAAK,QAAQ,EAAE;EAC9B;EACA,QAAQ,MAAM,IAAI,KAAK,QAAQ,aAAa,GAAI;CACjD;CACA,OAAO;EACN,QAAQ;EACR,WAAW,QAAQ;EACnB,WAAW,OAAO,SAAS,WAAW;EACtC,QAAQ,OAAO,KAAK,KAAK,OAAO;GAAE,MAAM,EAAE,aAAa;GAAI,OAAO,EAAE,QAAQ,WAAW;EAAE,EAAE;EAC3F,GAAI,eAAe,KAAA,IAAY,CAAC,IAAI,EAAE,OAAO,WAAW;EACxD,GAAG,SAAS,MAAM;CACnB;AACD;;;;;AAMA,MAAa,yBACZ,SAEA,aAAa,OAAO,KAAK,cAAc;CACtC,MAAM,EAAE,QAAQ,iBAAiB,cAAc,GAAG;CAClD,OAAO;EACN,GAAG,MAAM,QAAQ,SAAS;EAC1B,GAAI,iBAAiB,KAAA,IAAY,CAAC,IAAI,EAAE,aAAa;CACtD;AACD,CAAC;;AAGF,MAAa,uBACZ,SAEA,aAAa,OAAO,QAAQ;CAC3B,MAAM;AACP,CAAC"}
@@ -1,68 +1,63 @@
1
- import { AnalyticsFilter, DateRange, MetricKey } from "../core/contract.js";
1
+ import { AnalyticsFilter, DateRange, MetricKey, MetricValue } from "../core/contract.js";
2
2
  import { TimeframePreset } from "../timeframe/presets.js";
3
+ import { ReadNotices } from "./readMeta.js";
4
+ import { ReadPrincipal } from "../access/principal.js";
5
+ import { SeriesGranularity, SeriesPoint } from "../charts/series.js";
3
6
  import { WidgetReadStatus } from "./prepareWidgetRead.js";
4
7
  import { PayloadRequest } from "payload";
5
8
 
6
9
  //#region src/widgets/readForWidgetSeries.d.ts
7
- interface SeriesPoint {
8
- date: string;
9
- value: number;
10
- }
11
- interface WidgetSeriesResult {
10
+ interface WidgetSeriesResult extends Partial<ReadNotices> {
12
11
  status: WidgetReadStatus;
12
+ /** How long until a `busy` read can succeed, when the source or the plugin knows. */
13
+ retryAfterMs?: number;
13
14
  adapterId: string;
15
+ /** The scope the read narrowed to, absent for an install-wide one. */
16
+ scope?: string;
14
17
  dateRange: DateRange;
15
18
  /** Reporting timezone the read resolved in; the trend axis buckets in it. */
16
19
  timezone: string;
17
20
  points: SeriesPoint[];
18
- total: number;
21
+ /**
22
+ * The bucket the points actually carry. A window of a day or two is charted by hour, so
23
+ * `day` there says the source serves no hourly rows and the series is a single point.
24
+ */
25
+ seriesGranularity?: SeriesGranularity;
26
+ /** The window's headline reading; `null` for an average with no samples in it. */
27
+ total: MetricValue;
19
28
  /** The source that answered, absent on a read that never reached one. */
20
29
  provider?: string;
21
- clamped?: boolean;
22
- /** True when the engine served a stale cache entry after a failed provider read. */
23
- stale?: boolean;
24
- /** True when the source answered without one of the filters the read carried. */
25
- filtersUnapplied?: boolean;
26
- /** True when the read hit the source's event scan cap, so the numbers are a floor. */
27
- sampled?: boolean;
28
- /** True when the source could not read the scope's goals, so a conversions series means nothing. */
29
- goalsUnresolved?: boolean;
30
30
  /** Previous-window headline total, present only when the adapter supports comparison. */
31
- previousTotal?: number;
31
+ previousTotal?: MetricValue;
32
32
  /** The previous comparable window, present only when comparison ran. */
33
33
  comparisonRange?: DateRange;
34
34
  /**
35
- * The previous window's daily series, present only when `compare` was asked for and the
36
- * adapter supports comparison. Zero-filled to the same length as `points`, so the
37
- * previous window's day i overlays `points[i]`.
35
+ * Previous window's series at the same granularity, when `compare` ran. Zero-filled to the
36
+ * length of `points`, so its bucket i overlays `points[i]`.
38
37
  */
39
38
  comparisonPoints?: SeriesPoint[];
40
39
  }
41
- interface ReadForWidgetSeriesArgs {
40
+ /** Scoped like `ReadForWidgetArgs`: the request's own scope unless one is pinned. */
41
+ type ReadForWidgetSeriesArgs = ReadPrincipal & {
42
42
  req: PayloadRequest;
43
43
  metric: MetricKey;
44
44
  timeframe: TimeframePreset;
45
45
  adapterId?: string;
46
46
  now: Date;
47
47
  range?: DateRange;
48
- /** Explicit scope override; omitted resolves via the plugin's scopeResolver. */
49
- scope?: string | null;
50
48
  /**
51
49
  * Reporting timezone the caller already resolved, reused rather than resolved again so
52
50
  * a caller-supplied `range` is read in the very timezone it was interpreted in.
53
51
  */
54
52
  timezone?: string;
55
- filters?: AnalyticsFilter[];
56
- /** Also return the previous window's series, for the chart's comparison overlay. */
53
+ filters?: AnalyticsFilter[]; /** Also return the previous window's series, for the chart's comparison overlay. */
57
54
  compare?: boolean;
58
- }
55
+ };
59
56
  /**
60
- * Site-wide time-series read for a trend widget: resolve the timeframe, pick the
61
- * adapter, gate on the metric and day-granularity support, read through the engine,
62
- * then return a zero-filled daily series plus the headline total. Mirrors
63
- * `readForWidget` but yields points instead of a single value.
57
+ * Trend read: a zero-filled series plus headline total. A window of a day or two reads by hour
58
+ * where served (a daily axis there is one point); see {@link seriesGranularityFor}.
64
59
  */
65
60
  declare const readForWidgetSeries: (args: ReadForWidgetSeriesArgs) => Promise<WidgetSeriesResult>;
66
61
  //#endregion
67
- export { ReadForWidgetSeriesArgs, SeriesPoint, WidgetSeriesResult, readForWidgetSeries };
62
+ export { ReadForWidgetSeriesArgs, WidgetSeriesResult, readForWidgetSeries };
68
63
  //# sourceMappingURL=readForWidgetSeries.d.ts.map