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

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 (1259) hide show
  1. package/CHANGELOG.md +530 -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 +17 -0
  22. package/dist/adapters/ga4/ga4.js +208 -124
  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 +19 -13
  36. package/dist/adapters/plausible/plausible.js +139 -123
  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 +26 -9
  41. package/dist/adapters/posthog/posthog.js +194 -115
  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 +13 -9
  48. package/dist/adapters/umami/umami.js +186 -173
  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 +108 -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 +198 -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 +28 -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 +297 -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 +505 -157
  159. package/dist/core/options.js +158 -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 +114 -0
  167. package/dist/core/scopeOptions.js.map +1 -0
  168. package/dist/core/scopedRead.js +330 -71
  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/sourceLabel.d.ts +10 -0
  180. package/dist/core/sourceLabel.js +63 -0
  181. package/dist/core/sourceLabel.js.map +1 -0
  182. package/dist/core/sourceOptions.js +106 -0
  183. package/dist/core/sourceOptions.js.map +1 -0
  184. package/dist/core/sourcePolicy.d.ts +55 -0
  185. package/dist/core/sourcePolicy.js +51 -0
  186. package/dist/core/sourcePolicy.js.map +1 -0
  187. package/dist/core/throttle.js +18 -0
  188. package/dist/core/throttle.js.map +1 -0
  189. package/dist/core/values.js +61 -0
  190. package/dist/core/values.js.map +1 -0
  191. package/dist/core/widgetSlugs.d.ts +17 -0
  192. package/dist/core/widgetSlugs.js +29 -0
  193. package/dist/core/widgetSlugs.js.map +1 -0
  194. package/dist/db/detachedWrite.js +36 -0
  195. package/dist/db/detachedWrite.js.map +1 -0
  196. package/dist/db/errors.js +182 -0
  197. package/dist/db/errors.js.map +1 -0
  198. package/dist/db/kind.js +32 -0
  199. package/dist/db/kind.js.map +1 -0
  200. package/dist/db/openTransaction.js +51 -0
  201. package/dist/db/openTransaction.js.map +1 -0
  202. package/dist/exports/adapters/contract.d.ts +15 -0
  203. package/dist/exports/adapters/ga4.d.ts +16 -1
  204. package/dist/exports/adapters/native.d.ts +27 -2
  205. package/dist/exports/adapters/native.js +4 -1
  206. package/dist/exports/adapters/plausible.d.ts +16 -1
  207. package/dist/exports/adapters/posthog.d.ts +16 -1
  208. package/dist/exports/adapters/umami.d.ts +16 -1
  209. package/dist/exports/attributes.d.ts +42 -0
  210. package/dist/exports/attributes.js +83 -0
  211. package/dist/exports/attributes.js.map +1 -0
  212. package/dist/exports/client.d.ts +43 -13
  213. package/dist/exports/client.js +22 -9
  214. package/dist/exports/geo.d.ts +3 -1
  215. package/dist/exports/geo.js +1 -1
  216. package/dist/exports/i18n.d.ts +2 -2
  217. package/dist/exports/i18n.js +2 -2
  218. package/dist/exports/migrations.d.ts +2 -0
  219. package/dist/exports/migrations.js +2 -0
  220. package/dist/exports/next.d.ts +19 -1
  221. package/dist/exports/next.js +3 -1
  222. package/dist/exports/react.d.ts +3 -2
  223. package/dist/exports/react.js +1 -2
  224. package/dist/exports/rsc.d.ts +32 -14
  225. package/dist/exports/rsc.js +11 -6
  226. package/dist/exports/site.d.ts +5 -0
  227. package/dist/exports/site.js +3 -0
  228. package/dist/exports/testing.d.ts +18 -0
  229. package/dist/exports/testing.js +3 -0
  230. package/dist/exports/tracker.d.ts +5 -20
  231. package/dist/exports/tracker.js +3 -14
  232. package/dist/exports/types.d.ts +44 -14
  233. package/dist/exports/types.js +5 -1
  234. package/dist/fields/AnalyticsPanelClient.js +265 -154
  235. package/dist/fields/AnalyticsPanelClient.js.map +1 -1
  236. package/dist/fields/AnalyticsPanelField.d.ts +19 -7
  237. package/dist/fields/AnalyticsPanelField.js +123 -30
  238. package/dist/fields/AnalyticsPanelField.js.map +1 -1
  239. package/dist/fields/AnalyticsStatField.d.ts +17 -6
  240. package/dist/fields/AnalyticsStatField.js +98 -63
  241. package/dist/fields/AnalyticsStatField.js.map +1 -1
  242. package/dist/fields/FieldShimmer.js +15 -0
  243. package/dist/fields/FieldShimmer.js.map +1 -0
  244. package/dist/fields/PanelContent.js +222 -0
  245. package/dist/fields/PanelContent.js.map +1 -0
  246. package/dist/fields/PanelList.js +82 -0
  247. package/dist/fields/PanelList.js.map +1 -0
  248. package/dist/fields/PanelLiveCounter.js +63 -0
  249. package/dist/fields/PanelLiveCounter.js.map +1 -0
  250. package/dist/fields/PanelSkeleton.js +63 -0
  251. package/dist/fields/PanelSkeleton.js.map +1 -0
  252. package/dist/fields/componentPaths.js +8 -0
  253. package/dist/fields/componentPaths.js.map +1 -0
  254. package/dist/fields/config/FilterDimensionSelectField.d.ts +2 -2
  255. package/dist/fields/config/FilterDimensionSelectField.js +26 -54
  256. package/dist/fields/config/FilterDimensionSelectField.js.map +1 -1
  257. package/dist/fields/config/FilterKeySelect.js +66 -0
  258. package/dist/fields/config/FilterKeySelect.js.map +1 -0
  259. package/dist/fields/config/FilterOperatorSelectField.d.ts +7 -2
  260. package/dist/fields/config/FilterOperatorSelectField.js +37 -53
  261. package/dist/fields/config/FilterOperatorSelectField.js.map +1 -1
  262. package/dist/fields/config/FilterValueField.d.ts +17 -0
  263. package/dist/fields/config/FilterValueField.js +130 -0
  264. package/dist/fields/config/FilterValueField.js.map +1 -0
  265. package/dist/fields/config/MetricSelectField.d.ts +5 -12
  266. package/dist/fields/config/MetricSelectField.js +18 -30
  267. package/dist/fields/config/MetricSelectField.js.map +1 -1
  268. package/dist/fields/config/OptionSelect.js +52 -0
  269. package/dist/fields/config/OptionSelect.js.map +1 -0
  270. package/dist/fields/config/SourceSelectField.js +16 -31
  271. package/dist/fields/config/SourceSelectField.js.map +1 -1
  272. package/dist/fields/config/fetchSources.d.ts +3 -0
  273. package/dist/fields/config/fetchSources.js +17 -27
  274. package/dist/fields/config/fetchSources.js.map +1 -1
  275. package/dist/fields/config/filterValues.js +106 -0
  276. package/dist/fields/config/filterValues.js.map +1 -0
  277. package/dist/fields/config/narrow.js +8 -10
  278. package/dist/fields/config/narrow.js.map +1 -1
  279. package/dist/fields/config/retiredPickers.d.ts +45 -0
  280. package/dist/fields/config/retiredPickers.js +46 -0
  281. package/dist/fields/config/retiredPickers.js.map +1 -0
  282. package/dist/fields/config/scopedFields.d.ts +40 -0
  283. package/dist/fields/config/scopedFields.js +68 -0
  284. package/dist/fields/config/scopedFields.js.map +1 -0
  285. package/dist/fields/config/toSelectOption.js +13 -7
  286. package/dist/fields/config/toSelectOption.js.map +1 -1
  287. package/dist/fields/config/useAnalyticsSources.d.ts +5 -7
  288. package/dist/fields/config/useAnalyticsSources.js +17 -21
  289. package/dist/fields/config/useAnalyticsSources.js.map +1 -1
  290. package/dist/fields/config/useFilterCapabilities.d.ts +9 -6
  291. package/dist/fields/config/useFilterCapabilities.js +23 -15
  292. package/dist/fields/config/useFilterCapabilities.js.map +1 -1
  293. package/dist/fields/config/useFormString.js +12 -0
  294. package/dist/fields/config/useFormString.js.map +1 -0
  295. package/dist/fields/dateRange/field.js +7 -19
  296. package/dist/fields/dateRange/field.js.map +1 -1
  297. package/dist/fields/dateRange/types.d.ts +5 -1
  298. package/dist/fields/dateRange/ui.d.ts +3 -2
  299. package/dist/fields/dateRange/ui.js +57 -319
  300. package/dist/fields/dateRange/ui.js.map +1 -1
  301. package/dist/fields/documentScope.js +21 -0
  302. package/dist/fields/documentScope.js.map +1 -0
  303. package/dist/fields/emptyState.js +31 -26
  304. package/dist/fields/emptyState.js.map +1 -1
  305. package/dist/fields/factories.d.ts +35 -16
  306. package/dist/fields/factories.js +66 -37
  307. package/dist/fields/factories.js.map +1 -1
  308. package/dist/fields/format.d.ts +12 -3
  309. package/dist/fields/format.js +77 -13
  310. package/dist/fields/format.js.map +1 -1
  311. package/dist/fields/itemReport.js +45 -0
  312. package/dist/fields/itemReport.js.map +1 -0
  313. package/dist/fields/readForDocument.d.ts +79 -26
  314. package/dist/fields/readForDocument.js +450 -116
  315. package/dist/fields/readForDocument.js.map +1 -1
  316. package/dist/fields/stateKeys.js +20 -0
  317. package/dist/fields/stateKeys.js.map +1 -0
  318. package/dist/goals/GoalAmountField.d.ts +10 -0
  319. package/dist/goals/GoalAmountField.js +162 -0
  320. package/dist/goals/GoalAmountField.js.map +1 -0
  321. package/dist/goals/GoalSelectField.js +89 -40
  322. package/dist/goals/GoalSelectField.js.map +1 -1
  323. package/dist/goals/GoalSelectFieldServer.d.ts +13 -0
  324. package/dist/goals/GoalSelectFieldServer.js +21 -0
  325. package/dist/goals/GoalSelectFieldServer.js.map +1 -0
  326. package/dist/goals/amountField.d.ts +20 -0
  327. package/dist/goals/amountField.js +37 -0
  328. package/dist/goals/amountField.js.map +1 -0
  329. package/dist/goals/builtin.js +17 -0
  330. package/dist/goals/builtin.js.map +1 -0
  331. package/dist/goals/collection.d.ts +22 -0
  332. package/dist/goals/collection.js +139 -125
  333. package/dist/goals/collection.js.map +1 -1
  334. package/dist/goals/constants.d.ts +38 -0
  335. package/dist/goals/constants.js +49 -0
  336. package/dist/goals/constants.js.map +1 -0
  337. package/dist/goals/currency.d.ts +16 -0
  338. package/dist/goals/currency.js +46 -4
  339. package/dist/goals/currency.js.map +1 -1
  340. package/dist/goals/currencyOptions.js +70 -0
  341. package/dist/goals/currencyOptions.js.map +1 -0
  342. package/dist/goals/fetchGoals.d.ts +10 -0
  343. package/dist/goals/fetchGoals.js +12 -26
  344. package/dist/goals/fetchGoals.js.map +1 -1
  345. package/dist/goals/goalField.d.ts +4 -6
  346. package/dist/goals/goalField.js +9 -19
  347. package/dist/goals/goalField.js.map +1 -1
  348. package/dist/goals/goalsEndpoint.js +39 -40
  349. package/dist/goals/goalsEndpoint.js.map +1 -1
  350. package/dist/goals/items.js +35 -0
  351. package/dist/goals/items.js.map +1 -0
  352. package/dist/goals/latent.js +9 -0
  353. package/dist/goals/latent.js.map +1 -0
  354. package/dist/goals/linkFields.d.ts +35 -0
  355. package/dist/goals/linkFields.js +31 -0
  356. package/dist/goals/linkFields.js.map +1 -0
  357. package/dist/goals/match.d.ts +14 -0
  358. package/dist/goals/match.js +67 -46
  359. package/dist/goals/match.js.map +1 -1
  360. package/dist/goals/moneyFields.js +56 -0
  361. package/dist/goals/moneyFields.js.map +1 -0
  362. package/dist/goals/pathMatch.js +122 -0
  363. package/dist/goals/pathMatch.js.map +1 -0
  364. package/dist/goals/placeholder.js +12 -0
  365. package/dist/goals/placeholder.js.map +1 -0
  366. package/dist/goals/resolver.d.ts +3 -3
  367. package/dist/goals/resolver.js +155 -47
  368. package/dist/goals/resolver.js.map +1 -1
  369. package/dist/goals/serverRevenue.d.ts +60 -0
  370. package/dist/goals/serverRevenue.js +41 -0
  371. package/dist/goals/serverRevenue.js.map +1 -0
  372. package/dist/goals/trackGoalAction.d.ts +26 -27
  373. package/dist/goals/trackGoalAction.js +38 -52
  374. package/dist/goals/trackGoalAction.js.map +1 -1
  375. package/dist/goals/types.d.ts +13 -28
  376. package/dist/goals/types.js +1 -1
  377. package/dist/goals/types.js.map +1 -1
  378. package/dist/goals/useAnalyticsGoals.d.ts +6 -5
  379. package/dist/goals/useAnalyticsGoals.js +17 -18
  380. package/dist/goals/useAnalyticsGoals.js.map +1 -1
  381. package/dist/index.d.ts +67 -12
  382. package/dist/index.js +258 -247
  383. package/dist/index.js.map +1 -1
  384. package/dist/items/collectionIdType.js +20 -0
  385. package/dist/items/collectionIdType.js.map +1 -0
  386. package/dist/items/idType.js +31 -0
  387. package/dist/items/idType.js.map +1 -0
  388. package/dist/items/ref.js +73 -0
  389. package/dist/items/ref.js.map +1 -0
  390. package/dist/maintenance/apiTaskState.js +141 -0
  391. package/dist/maintenance/apiTaskState.js.map +1 -0
  392. package/dist/maintenance/heartbeat.js +51 -0
  393. package/dist/maintenance/heartbeat.js.map +1 -0
  394. package/dist/maintenance/lease.d.ts +1 -0
  395. package/dist/maintenance/lease.js +81 -0
  396. package/dist/maintenance/lease.js.map +1 -0
  397. package/dist/maintenance/taskSchedule.d.ts +1 -0
  398. package/dist/maintenance/taskSchedule.js +62 -0
  399. package/dist/maintenance/taskSchedule.js.map +1 -0
  400. package/dist/maintenance/underLease.js +35 -0
  401. package/dist/maintenance/underLease.js.map +1 -0
  402. package/dist/migrations/legacy.d.ts +54 -0
  403. package/dist/migrations/legacy.js +117 -0
  404. package/dist/migrations/legacy.js.map +1 -0
  405. package/dist/migrations/predefined/dropLegacyMongo.d.ts +11 -0
  406. package/dist/migrations/predefined/dropLegacyMongo.js +12 -0
  407. package/dist/migrations/predefined/dropLegacyMongo.js.map +1 -0
  408. package/dist/native/collections/aggregates.js +54 -0
  409. package/dist/native/collections/aggregates.js.map +1 -0
  410. package/dist/native/collections/hits.js +102 -0
  411. package/dist/native/collections/hits.js.map +1 -0
  412. package/dist/native/collections/slugs.d.ts +10 -0
  413. package/dist/native/collections/slugs.js +16 -0
  414. package/dist/native/collections/slugs.js.map +1 -0
  415. package/dist/native/collections/state.js +84 -0
  416. package/dist/native/collections/state.js.map +1 -0
  417. package/dist/native/collections/storeCollection.js +29 -0
  418. package/dist/native/collections/storeCollection.js.map +1 -0
  419. package/dist/native/engine/buckets.d.ts +1 -0
  420. package/dist/native/engine/buckets.js +53 -0
  421. package/dist/native/engine/buckets.js.map +1 -0
  422. package/dist/native/engine/capabilities.js +87 -0
  423. package/dist/native/engine/capabilities.js.map +1 -0
  424. package/dist/native/engine/cost.js +72 -0
  425. package/dist/native/engine/cost.js.map +1 -0
  426. package/dist/native/engine/days.d.ts +1 -0
  427. package/dist/native/engine/days.js +182 -0
  428. package/dist/native/engine/days.js.map +1 -0
  429. package/dist/native/engine/engine.d.ts +1 -0
  430. package/dist/native/engine/engine.js +1623 -0
  431. package/dist/native/engine/engine.js.map +1 -0
  432. package/dist/native/engine/instance.js +58 -0
  433. package/dist/native/engine/instance.js.map +1 -0
  434. package/dist/native/engine/maintenance.d.ts +1 -0
  435. package/dist/native/engine/maintenance.js +677 -0
  436. package/dist/native/engine/maintenance.js.map +1 -0
  437. package/dist/native/engine/merge.js +41 -0
  438. package/dist/native/engine/merge.js.map +1 -0
  439. package/dist/native/engine/nudge.js +26 -0
  440. package/dist/native/engine/nudge.js.map +1 -0
  441. package/dist/native/engine/planner.js +198 -0
  442. package/dist/native/engine/planner.js.map +1 -0
  443. package/dist/native/engine/rebuild.d.ts +22 -0
  444. package/dist/native/engine/rebuild.js +76 -0
  445. package/dist/native/engine/rebuild.js.map +1 -0
  446. package/dist/native/engine/recent.js +17 -0
  447. package/dist/native/engine/recent.js.map +1 -0
  448. package/dist/native/engine/salt.d.ts +1 -0
  449. package/dist/native/engine/salt.js +98 -0
  450. package/dist/native/engine/salt.js.map +1 -0
  451. package/dist/native/engine/siteHosts.d.ts +1 -0
  452. package/dist/native/engine/siteHosts.js +58 -0
  453. package/dist/native/engine/siteHosts.js.map +1 -0
  454. package/dist/native/engine/toHit.js +108 -0
  455. package/dist/native/engine/toHit.js.map +1 -0
  456. package/dist/native/engine/writeBuffer.d.ts +14 -0
  457. package/dist/native/engine/writeBuffer.js +317 -0
  458. package/dist/native/engine/writeBuffer.js.map +1 -0
  459. package/dist/native/geo/composeGeoResolvers.d.ts +1 -0
  460. package/dist/native/geo/composeGeoResolvers.js +4 -1
  461. package/dist/native/geo/composeGeoResolvers.js.map +1 -1
  462. package/dist/native/geo/geoResolver.d.ts +20 -2
  463. package/dist/native/geo/geoResolver.js +42 -6
  464. package/dist/native/geo/geoResolver.js.map +1 -1
  465. package/dist/native/geo/maxmindResolver.d.ts +8 -4
  466. package/dist/native/geo/maxmindResolver.js +20 -16
  467. package/dist/native/geo/maxmindResolver.js.map +1 -1
  468. package/dist/native/geo/resolveGeo.js +31 -0
  469. package/dist/native/geo/resolveGeo.js.map +1 -0
  470. package/dist/native/ingest/bots.d.ts +2 -3
  471. package/dist/native/ingest/bots.js +8 -13
  472. package/dist/native/ingest/bots.js.map +1 -1
  473. package/dist/native/ingest/browser.js +4 -6
  474. package/dist/native/ingest/browser.js.map +1 -1
  475. package/dist/native/ingest/clientIp.js +30 -9
  476. package/dist/native/ingest/clientIp.js.map +1 -1
  477. package/dist/native/ingest/device.js +4 -6
  478. package/dist/native/ingest/device.js.map +1 -1
  479. package/dist/native/ingest/endpoint.d.ts +1 -1
  480. package/dist/native/ingest/endpoint.js +119 -34
  481. package/dist/native/ingest/endpoint.js.map +1 -1
  482. package/dist/native/ingest/itemSignature.d.ts +26 -0
  483. package/dist/native/ingest/itemSignature.js +45 -0
  484. package/dist/native/ingest/itemSignature.js.map +1 -0
  485. package/dist/native/ingest/language.js +2 -3
  486. package/dist/native/ingest/language.js.map +1 -1
  487. package/dist/native/ingest/normalizeEvent.d.ts +60 -7
  488. package/dist/native/ingest/normalizeEvent.js +226 -61
  489. package/dist/native/ingest/normalizeEvent.js.map +1 -1
  490. package/dist/native/ingest/orderSignature.d.ts +13 -0
  491. package/dist/native/ingest/orderSignature.js +50 -0
  492. package/dist/native/ingest/orderSignature.js.map +1 -0
  493. package/dist/native/ingest/referrer.js +30 -32
  494. package/dist/native/ingest/referrer.js.map +1 -1
  495. package/dist/native/ingest/requestHost.js +10 -23
  496. package/dist/native/ingest/requestHost.js.map +1 -1
  497. package/dist/native/ingest/resolveHostname.d.ts +4 -13
  498. package/dist/native/ingest/resolveHostname.js +5 -6
  499. package/dist/native/ingest/resolveHostname.js.map +1 -1
  500. package/dist/native/ingest/revenue.d.ts +1 -0
  501. package/dist/native/ingest/revenue.js +121 -0
  502. package/dist/native/ingest/revenue.js.map +1 -0
  503. package/dist/native/ingest/route.d.ts +10 -0
  504. package/dist/native/ingest/route.js +82 -0
  505. package/dist/native/ingest/route.js.map +1 -0
  506. package/dist/native/ingest/serverTrack.d.ts +2 -10
  507. package/dist/native/ingest/serverTrack.js +181 -72
  508. package/dist/native/ingest/serverTrack.js.map +1 -1
  509. package/dist/native/ingest/signature.js +28 -0
  510. package/dist/native/ingest/signature.js.map +1 -0
  511. package/dist/native/ingest/source.d.ts +2 -3
  512. package/dist/native/ingest/source.js +35 -54
  513. package/dist/native/ingest/source.js.map +1 -1
  514. package/dist/native/ingest/utm.js +9 -9
  515. package/dist/native/ingest/utm.js.map +1 -1
  516. package/dist/native/ingest/validate.js +20 -10
  517. package/dist/native/ingest/validate.js.map +1 -1
  518. package/dist/native/ingest/visitorHash.js +6 -8
  519. package/dist/native/ingest/visitorHash.js.map +1 -1
  520. package/dist/native/nativeAdapter.d.ts +107 -33
  521. package/dist/native/nativeAdapter.js +376 -317
  522. package/dist/native/nativeAdapter.js.map +1 -1
  523. package/dist/native/rebuildDays.d.ts +12 -0
  524. package/dist/native/rebuildDays.js +16 -0
  525. package/dist/native/rebuildDays.js.map +1 -0
  526. package/dist/native/store/aggregate.js +450 -0
  527. package/dist/native/store/aggregate.js.map +1 -0
  528. package/dist/native/store/caps.d.ts +18 -0
  529. package/dist/native/store/caps.js +76 -0
  530. package/dist/native/store/caps.js.map +1 -0
  531. package/dist/native/store/chunks.js +34 -0
  532. package/dist/native/store/chunks.js.map +1 -0
  533. package/dist/native/store/columnValues.js +31 -0
  534. package/dist/native/store/columnValues.js.map +1 -0
  535. package/dist/native/store/dialect.js +106 -0
  536. package/dist/native/store/dialect.js.map +1 -0
  537. package/dist/native/store/eventStore.js +44 -0
  538. package/dist/native/store/eventStore.js.map +1 -0
  539. package/dist/native/store/hitRow.js +116 -0
  540. package/dist/native/store/hitRow.js.map +1 -0
  541. package/dist/native/store/hits.js +63 -0
  542. package/dist/native/store/hits.js.map +1 -0
  543. package/dist/native/store/ids.js +105 -0
  544. package/dist/native/store/ids.js.map +1 -0
  545. package/dist/native/store/mongo/aggregatePipelines.js +430 -0
  546. package/dist/native/store/mongo/aggregatePipelines.js.map +1 -0
  547. package/dist/native/store/mongo/mongoState.js +375 -0
  548. package/dist/native/store/mongo/mongoState.js.map +1 -0
  549. package/dist/native/store/mongo/mongoStore.js +618 -0
  550. package/dist/native/store/mongo/mongoStore.js.map +1 -0
  551. package/dist/native/store/mongo/pipelines.js +695 -0
  552. package/dist/native/store/mongo/pipelines.js.map +1 -0
  553. package/dist/native/store/mongo/results.js +20 -0
  554. package/dist/native/store/mongo/results.js.map +1 -0
  555. package/dist/native/store/parts.d.ts +1 -0
  556. package/dist/native/store/parts.js +95 -0
  557. package/dist/native/store/parts.js.map +1 -0
  558. package/dist/native/store/pattern.js +213 -0
  559. package/dist/native/store/pattern.js.map +1 -0
  560. package/dist/native/store/rawRead.d.ts +23 -0
  561. package/dist/native/store/rawRead.js +384 -0
  562. package/dist/native/store/rawRead.js.map +1 -0
  563. package/dist/native/store/reclassify.js +53 -0
  564. package/dist/native/store/reclassify.js.map +1 -0
  565. package/dist/native/store/sql/aggregateSql.js +345 -0
  566. package/dist/native/store/sql/aggregateSql.js.map +1 -0
  567. package/dist/native/store/sql/columns.js +48 -0
  568. package/dist/native/store/sql/columns.js.map +1 -0
  569. package/dist/native/store/sql/compile.js +656 -0
  570. package/dist/native/store/sql/compile.js.map +1 -0
  571. package/dist/native/store/sql/drivers.js +218 -0
  572. package/dist/native/store/sql/drivers.js.map +1 -0
  573. package/dist/native/store/sql/executor.js +132 -0
  574. package/dist/native/store/sql/executor.js.map +1 -0
  575. package/dist/native/store/sql/fragment.js +104 -0
  576. package/dist/native/store/sql/fragment.js.map +1 -0
  577. package/dist/native/store/sql/maintenanceSql.js +59 -0
  578. package/dist/native/store/sql/maintenanceSql.js.map +1 -0
  579. package/dist/native/store/sql/ownConnection.js +107 -0
  580. package/dist/native/store/sql/ownConnection.js.map +1 -0
  581. package/dist/native/store/sql/poolShare.js +101 -0
  582. package/dist/native/store/sql/poolShare.js.map +1 -0
  583. package/dist/native/store/sql/sqlState.js +325 -0
  584. package/dist/native/store/sql/sqlState.js.map +1 -0
  585. package/dist/native/store/sql/sqlStore.js +355 -0
  586. package/dist/native/store/sql/sqlStore.js.map +1 -0
  587. package/dist/native/store/sql/sqliteThread.d.ts +9 -0
  588. package/dist/native/store/sql/sqliteThread.js +314 -0
  589. package/dist/native/store/sql/sqliteThread.js.map +1 -0
  590. package/dist/native/store/sql/sqliteWorker.js +327 -0
  591. package/dist/native/store/sql/sqliteWorker.js.map +1 -0
  592. package/dist/native/store/sql/sqliteWorkerSource.js +347 -0
  593. package/dist/native/store/sql/sqliteWorkerSource.js.map +1 -0
  594. package/dist/native/store/state.js +151 -0
  595. package/dist/native/store/state.js.map +1 -0
  596. package/dist/native/store/stateStore.js +29 -0
  597. package/dist/native/store/stateStore.js.map +1 -0
  598. package/dist/native/store/types.d.ts +9 -0
  599. package/dist/native/tasks/maintainTask.d.ts +19 -0
  600. package/dist/native/tasks/maintainTask.js +68 -0
  601. package/dist/native/tasks/maintainTask.js.map +1 -0
  602. package/dist/net/guardedFetch.d.ts +32 -0
  603. package/dist/net/guardedFetch.js +220 -0
  604. package/dist/net/guardedFetch.js.map +1 -0
  605. package/dist/net/origin.js +40 -0
  606. package/dist/net/origin.js.map +1 -0
  607. package/dist/net/platform.d.ts +9 -0
  608. package/dist/net/platform.js +35 -0
  609. package/dist/net/platform.js.map +1 -0
  610. package/dist/next/captureRewrites.d.ts +4 -24
  611. package/dist/next/captureRewrites.js +6 -50
  612. package/dist/next/captureRewrites.js.map +1 -1
  613. package/dist/next/captureRoute.d.ts +28 -0
  614. package/dist/next/captureRoute.js +67 -0
  615. package/dist/next/captureRoute.js.map +1 -0
  616. package/dist/next/ingestRoute.d.ts +17 -0
  617. package/dist/next/ingestRoute.js +17 -0
  618. package/dist/next/ingestRoute.js.map +1 -0
  619. package/dist/next/posthogProxyRewrites.d.ts +3 -25
  620. package/dist/next/posthogProxyRewrites.js +5 -37
  621. package/dist/next/posthogProxyRewrites.js.map +1 -1
  622. package/dist/plugin/adminDependencies.js +34 -0
  623. package/dist/plugin/adminDependencies.js.map +1 -0
  624. package/dist/plugin/apiPath.js +23 -0
  625. package/dist/plugin/apiPath.js.map +1 -0
  626. package/dist/plugin/boundDocument.js +58 -0
  627. package/dist/plugin/boundDocument.js.map +1 -0
  628. package/dist/plugin/buildPhase.js +10 -0
  629. package/dist/plugin/buildPhase.js.map +1 -0
  630. package/dist/plugin/collectionChecks.js +232 -0
  631. package/dist/plugin/collectionChecks.js.map +1 -0
  632. package/dist/plugin/collectionFields.d.ts +13 -0
  633. package/dist/plugin/collectionFields.js +22 -0
  634. package/dist/plugin/collectionFields.js.map +1 -0
  635. package/dist/plugin/createRuntime.js +339 -0
  636. package/dist/plugin/createRuntime.js.map +1 -0
  637. package/dist/plugin/destroy.js +58 -0
  638. package/dist/plugin/destroy.js.map +1 -0
  639. package/dist/plugin/documentEndpoint.js +77 -53
  640. package/dist/plugin/documentEndpoint.js.map +1 -1
  641. package/dist/plugin/documentScopes.js +37 -0
  642. package/dist/plugin/documentScopes.js.map +1 -0
  643. package/dist/plugin/encrypted.js +25 -0
  644. package/dist/plugin/encrypted.js.map +1 -0
  645. package/dist/plugin/errors.d.ts +5 -12
  646. package/dist/plugin/errors.js +23 -16
  647. package/dist/plugin/errors.js.map +1 -1
  648. package/dist/plugin/flagsEndpoint.js +41 -0
  649. package/dist/plugin/flagsEndpoint.js.map +1 -0
  650. package/dist/plugin/goalHint.js +22 -11
  651. package/dist/plugin/goalHint.js.map +1 -1
  652. package/dist/plugin/itemLabels.js +114 -0
  653. package/dist/plugin/itemLabels.js.map +1 -0
  654. package/dist/plugin/jobsAccess.js +91 -0
  655. package/dist/plugin/jobsAccess.js.map +1 -0
  656. package/dist/plugin/keepAlive.js +48 -0
  657. package/dist/plugin/keepAlive.js.map +1 -0
  658. package/dist/plugin/peerImportError.js +3 -6
  659. package/dist/plugin/peerImportError.js.map +1 -1
  660. package/dist/plugin/peers.js +64 -0
  661. package/dist/plugin/peers.js.map +1 -0
  662. package/dist/plugin/pluginCollections.js +161 -0
  663. package/dist/plugin/pluginCollections.js.map +1 -0
  664. package/dist/plugin/queryEndpoint.js +70 -45
  665. package/dist/plugin/queryEndpoint.js.map +1 -1
  666. package/dist/plugin/queryParams.js +7 -0
  667. package/dist/plugin/queryParams.js.map +1 -0
  668. package/dist/plugin/readContextForRequest.d.ts +11 -0
  669. package/dist/plugin/readContextForRequest.js +70 -25
  670. package/dist/plugin/readContextForRequest.js.map +1 -1
  671. package/dist/plugin/readFailure.js +22 -0
  672. package/dist/plugin/readFailure.js.map +1 -0
  673. package/dist/plugin/readableProviders.js +64 -0
  674. package/dist/plugin/readableProviders.js.map +1 -0
  675. package/dist/plugin/realtimeEndpoint.js +77 -25
  676. package/dist/plugin/realtimeEndpoint.js.map +1 -1
  677. package/dist/plugin/refreshEndpoint.js +69 -44
  678. package/dist/plugin/refreshEndpoint.js.map +1 -1
  679. package/dist/plugin/relabelFields.js +36 -0
  680. package/dist/plugin/relabelFields.js.map +1 -0
  681. package/dist/plugin/requestMemo.js +35 -0
  682. package/dist/plugin/requestMemo.js.map +1 -0
  683. package/dist/plugin/routeChecks.js +39 -0
  684. package/dist/plugin/routeChecks.js.map +1 -0
  685. package/dist/plugin/routes.d.ts +53 -0
  686. package/dist/plugin/routes.js +92 -0
  687. package/dist/plugin/routes.js.map +1 -0
  688. package/dist/plugin/runtime.d.ts +1 -1
  689. package/dist/plugin/runtime.js +234 -30
  690. package/dist/plugin/runtime.js.map +1 -1
  691. package/dist/plugin/schemaOnly.js +63 -0
  692. package/dist/plugin/schemaOnly.js.map +1 -0
  693. package/dist/plugin/scopeChange.js +6 -5
  694. package/dist/plugin/scopeChange.js.map +1 -1
  695. package/dist/plugin/scopeFieldBoot.js +4 -4
  696. package/dist/plugin/scopeFieldBoot.js.map +1 -1
  697. package/dist/plugin/scopeToken.js +33 -0
  698. package/dist/plugin/scopeToken.js.map +1 -0
  699. package/dist/plugin/sourcesEndpoint.js +50 -17
  700. package/dist/plugin/sourcesEndpoint.js.map +1 -1
  701. package/dist/plugin/unbundledLanguages.js +25 -0
  702. package/dist/plugin/unbundledLanguages.js.map +1 -0
  703. package/dist/plugin/walkFields.js +22 -0
  704. package/dist/plugin/walkFields.js.map +1 -0
  705. package/dist/plugin/warmTask.js +0 -0
  706. package/dist/plugin/warmTask.js.map +1 -1
  707. package/dist/providers/ProvidersListNotice.d.ts +11 -0
  708. package/dist/providers/ProvidersListNotice.js +36 -0
  709. package/dist/providers/ProvidersListNotice.js.map +1 -0
  710. package/dist/providers/access.d.ts +1 -0
  711. package/dist/providers/access.js +35 -26
  712. package/dist/providers/access.js.map +1 -1
  713. package/dist/providers/adapterPool.js +121 -0
  714. package/dist/providers/adapterPool.js.map +1 -0
  715. package/dist/providers/collection.d.ts +61 -0
  716. package/dist/providers/collection.js +340 -151
  717. package/dist/providers/collection.js.map +1 -1
  718. package/dist/providers/factory.d.ts +76 -0
  719. package/dist/providers/factory.js +75 -25
  720. package/dist/providers/factory.js.map +1 -1
  721. package/dist/providers/hosts.d.ts +25 -0
  722. package/dist/providers/hosts.js +128 -0
  723. package/dist/providers/hosts.js.map +1 -0
  724. package/dist/providers/probe.d.ts +1 -0
  725. package/dist/providers/probe.js +105 -0
  726. package/dist/providers/probe.js.map +1 -0
  727. package/dist/providers/refresh.d.ts +18 -0
  728. package/dist/providers/refresh.js +49 -0
  729. package/dist/providers/refresh.js.map +1 -0
  730. package/dist/providers/registry.js +328 -0
  731. package/dist/providers/registry.js.map +1 -0
  732. package/dist/providers/resolver.js +26 -88
  733. package/dist/providers/resolver.js.map +1 -1
  734. package/dist/providers/retarget.js +45 -0
  735. package/dist/providers/retarget.js.map +1 -0
  736. package/dist/providers/scopeUnique.js +41 -0
  737. package/dist/providers/scopeUnique.js.map +1 -0
  738. package/dist/providers/secrets.d.ts +26 -0
  739. package/dist/providers/secrets.js +61 -4
  740. package/dist/providers/secrets.js.map +1 -1
  741. package/dist/providers/stampScope.js +9 -6
  742. package/dist/providers/stampScope.js.map +1 -1
  743. package/dist/query/dates.js +10 -12
  744. package/dist/query/dates.js.map +1 -1
  745. package/dist/query/errors.d.ts +1 -5
  746. package/dist/query/fetchQuery.d.ts +25 -32
  747. package/dist/query/fetchQuery.js +91 -91
  748. package/dist/query/fetchQuery.js.map +1 -1
  749. package/dist/query/limits.js +8 -0
  750. package/dist/query/limits.js.map +1 -0
  751. package/dist/query/parse.d.ts +6 -0
  752. package/dist/query/parse.js +153 -106
  753. package/dist/query/parse.js.map +1 -1
  754. package/dist/query/response.d.ts +23 -3
  755. package/dist/query/response.js +12 -5
  756. package/dist/query/response.js.map +1 -1
  757. package/dist/react/AnalyticsProvider.d.ts +26 -17
  758. package/dist/react/AnalyticsProvider.js +23 -22
  759. package/dist/react/AnalyticsProvider.js.map +1 -1
  760. package/dist/react/TrackerBoot.js +15 -9
  761. package/dist/react/TrackerBoot.js.map +1 -1
  762. package/dist/react/useAnalytics.d.ts +2 -11
  763. package/dist/react/useAnalytics.js +22 -24
  764. package/dist/react/useAnalytics.js.map +1 -1
  765. package/dist/site/AnalyticsScripts.d.ts +34 -0
  766. package/dist/site/AnalyticsScripts.js +30 -0
  767. package/dist/site/AnalyticsScripts.js.map +1 -0
  768. package/dist/site/getTrackerConfig.d.ts +15 -0
  769. package/dist/site/getTrackerConfig.js +40 -0
  770. package/dist/site/getTrackerConfig.js.map +1 -0
  771. package/dist/surfacing/afterRead.d.ts +37 -0
  772. package/dist/surfacing/bounded.js +38 -0
  773. package/dist/surfacing/bounded.js.map +1 -0
  774. package/dist/surfacing/breaker.js +107 -0
  775. package/dist/surfacing/breaker.js.map +1 -0
  776. package/dist/surfacing/cacheCollection.d.ts +8 -0
  777. package/dist/surfacing/cacheCollection.js +69 -0
  778. package/dist/surfacing/cacheCollection.js.map +1 -0
  779. package/dist/surfacing/cacheStore.d.ts +71 -1
  780. package/dist/surfacing/cacheStore.js +16 -37
  781. package/dist/surfacing/cacheStore.js.map +1 -1
  782. package/dist/surfacing/cacheSweep.d.ts +1 -0
  783. package/dist/surfacing/cacheSweep.js +59 -0
  784. package/dist/surfacing/cacheSweep.js.map +1 -0
  785. package/dist/surfacing/classifyError.js +282 -0
  786. package/dist/surfacing/classifyError.js.map +1 -0
  787. package/dist/surfacing/coalesce.js +2 -1
  788. package/dist/surfacing/coalesce.js.map +1 -1
  789. package/dist/surfacing/coldBudget.js +60 -0
  790. package/dist/surfacing/coldBudget.js.map +1 -0
  791. package/dist/surfacing/collectionCacheStore.js +183 -0
  792. package/dist/surfacing/collectionCacheStore.js.map +1 -0
  793. package/dist/surfacing/engine.d.ts +1 -1
  794. package/dist/surfacing/engine.js +514 -72
  795. package/dist/surfacing/engine.js.map +1 -1
  796. package/dist/surfacing/epoch.js +70 -26
  797. package/dist/surfacing/epoch.js.map +1 -1
  798. package/dist/surfacing/lanes.d.ts +1 -0
  799. package/dist/surfacing/lanes.js +297 -0
  800. package/dist/surfacing/lanes.js.map +1 -0
  801. package/dist/surfacing/memo.js +40 -0
  802. package/dist/surfacing/memo.js.map +1 -0
  803. package/dist/surfacing/rateLimiter.d.ts +1 -0
  804. package/dist/surfacing/rateLimiter.js +69 -94
  805. package/dist/surfacing/rateLimiter.js.map +1 -1
  806. package/dist/surfacing/rebucket.js +178 -0
  807. package/dist/surfacing/rebucket.js.map +1 -0
  808. package/dist/surfacing/recipe.js +28 -0
  809. package/dist/surfacing/recipe.js.map +1 -0
  810. package/dist/surfacing/shape.js +22 -0
  811. package/dist/surfacing/shape.js.map +1 -0
  812. package/dist/surfacing/todaySplit.js +113 -0
  813. package/dist/surfacing/todaySplit.js.map +1 -0
  814. package/dist/sync/collection.d.ts +8 -0
  815. package/dist/sync/collection.js +28 -18
  816. package/dist/sync/collection.js.map +1 -1
  817. package/dist/sync/rekeyDurations.js +70 -0
  818. package/dist/sync/rekeyDurations.js.map +1 -0
  819. package/dist/sync/syncTask.js +226 -109
  820. package/dist/sync/syncTask.js.map +1 -1
  821. package/dist/testing/memoryAdapter.d.ts +6 -3
  822. package/dist/testing/memoryAdapter.js +12 -10
  823. package/dist/testing/memoryAdapter.js.map +1 -1
  824. package/dist/testing/settle.d.ts +11 -0
  825. package/dist/testing/settle.js +19 -0
  826. package/dist/testing/settle.js.map +1 -0
  827. package/dist/timeframe/calendar.js +65 -0
  828. package/dist/timeframe/calendar.js.map +1 -0
  829. package/dist/timeframe/comparison.js +46 -0
  830. package/dist/timeframe/comparison.js.map +1 -0
  831. package/dist/timeframe/presets.d.ts +1 -1
  832. package/dist/timeframe/presets.js +5 -5
  833. package/dist/timeframe/presets.js.map +1 -1
  834. package/dist/timeframe/reportingTimezone.d.ts +1 -0
  835. package/dist/timeframe/reportingTimezone.js +64 -0
  836. package/dist/timeframe/reportingTimezone.js.map +1 -0
  837. package/dist/timeframe/tz.js +55 -39
  838. package/dist/timeframe/tz.js.map +1 -1
  839. package/dist/tracker/autoCapture.js +125 -38
  840. package/dist/tracker/autoCapture.js.map +1 -1
  841. package/dist/tracker/campaign.js +52 -0
  842. package/dist/tracker/campaign.js.map +1 -0
  843. package/dist/tracker/config.d.ts +149 -0
  844. package/dist/tracker/config.js +25 -0
  845. package/dist/tracker/config.js.map +1 -0
  846. package/dist/tracker/createTracker.d.ts +4 -10
  847. package/dist/tracker/createTracker.js +386 -115
  848. package/dist/tracker/createTracker.js.map +1 -1
  849. package/dist/tracker/digest.js +28 -0
  850. package/dist/tracker/digest.js.map +1 -0
  851. package/dist/tracker/engagement.js +100 -0
  852. package/dist/tracker/engagement.js.map +1 -0
  853. package/dist/tracker/events.js +37 -0
  854. package/dist/tracker/events.js.map +1 -0
  855. package/dist/tracker/exclusion.d.ts +2 -22
  856. package/dist/tracker/exclusion.js +53 -21
  857. package/dist/tracker/exclusion.js.map +1 -1
  858. package/dist/tracker/gate.js +194 -0
  859. package/dist/tracker/gate.js.map +1 -0
  860. package/dist/tracker/initTracker.d.ts +5 -8
  861. package/dist/tracker/initTracker.js +42 -14
  862. package/dist/tracker/initTracker.js.map +1 -1
  863. package/dist/tracker/itemCapture.js +224 -0
  864. package/dist/tracker/itemCapture.js.map +1 -0
  865. package/dist/tracker/loadScript.js +21 -14
  866. package/dist/tracker/loadScript.js.map +1 -1
  867. package/dist/tracker/pageTracking.js +6 -6
  868. package/dist/tracker/pageTracking.js.map +1 -1
  869. package/dist/tracker/registry.js +118 -30
  870. package/dist/tracker/registry.js.map +1 -1
  871. package/dist/tracker/sinks/createSink.js +41 -0
  872. package/dist/tracker/sinks/createSink.js.map +1 -0
  873. package/dist/tracker/sinks/ga4.js +64 -20
  874. package/dist/tracker/sinks/ga4.js.map +1 -1
  875. package/dist/tracker/sinks/native.js +7 -42
  876. package/dist/tracker/sinks/native.js.map +1 -1
  877. package/dist/tracker/sinks/plausible.js +27 -22
  878. package/dist/tracker/sinks/plausible.js.map +1 -1
  879. package/dist/tracker/sinks/posthog.js +54 -22
  880. package/dist/tracker/sinks/posthog.js.map +1 -1
  881. package/dist/tracker/sinks/umami.js +14 -12
  882. package/dist/tracker/sinks/umami.js.map +1 -1
  883. package/dist/tracker/sinks/vendor.js +30 -27
  884. package/dist/tracker/sinks/vendor.js.map +1 -1
  885. package/dist/tracker/skip.js +81 -0
  886. package/dist/tracker/skip.js.map +1 -0
  887. package/dist/tracker/storage.js +23 -0
  888. package/dist/tracker/storage.js.map +1 -0
  889. package/dist/tracker/transport.js +2 -5
  890. package/dist/tracker/transport.js.map +1 -1
  891. package/dist/tracker/types.d.ts +86 -63
  892. package/dist/tracker/window.js +7 -0
  893. package/dist/tracker/window.js.map +1 -0
  894. package/dist/translations/ar.js +232 -71
  895. package/dist/translations/ar.js.map +1 -1
  896. package/dist/translations/de.js +221 -69
  897. package/dist/translations/de.js.map +1 -1
  898. package/dist/translations/en.js +215 -67
  899. package/dist/translations/en.js.map +1 -1
  900. package/dist/translations/es.js +223 -68
  901. package/dist/translations/es.js.map +1 -1
  902. package/dist/translations/fr.js +227 -72
  903. package/dist/translations/fr.js.map +1 -1
  904. package/dist/translations/id.js +218 -67
  905. package/dist/translations/id.js.map +1 -1
  906. package/dist/translations/index.d.ts +1 -1
  907. package/dist/translations/index.js +5 -7
  908. package/dist/translations/index.js.map +1 -1
  909. package/dist/translations/intl.js +71 -0
  910. package/dist/translations/intl.js.map +1 -0
  911. package/dist/translations/keys.d.ts +191 -14
  912. package/dist/translations/keys.js +196 -14
  913. package/dist/translations/keys.js.map +1 -1
  914. package/dist/translations/ko.js +220 -69
  915. package/dist/translations/ko.js.map +1 -1
  916. package/dist/translations/labelMap.d.ts +10 -0
  917. package/dist/translations/labelMap.js +22 -0
  918. package/dist/translations/labelMap.js.map +1 -0
  919. package/dist/translations/metricKeys.js +10 -2
  920. package/dist/translations/metricKeys.js.map +1 -1
  921. package/dist/translations/parts.js +20 -0
  922. package/dist/translations/parts.js.map +1 -0
  923. package/dist/translations/plural.js +61 -0
  924. package/dist/translations/plural.js.map +1 -0
  925. package/dist/translations/pt.js +232 -77
  926. package/dist/translations/pt.js.map +1 -1
  927. package/dist/translations/ru.js +223 -66
  928. package/dist/translations/ru.js.map +1 -1
  929. package/dist/translations/server.d.ts +1 -0
  930. package/dist/translations/server.js +2 -3
  931. package/dist/translations/server.js.map +1 -1
  932. package/dist/translations/staticLabel.js +69 -0
  933. package/dist/translations/staticLabel.js.map +1 -0
  934. package/dist/translations/uk.js +223 -66
  935. package/dist/translations/uk.js.map +1 -1
  936. package/dist/translations/zh.js +218 -67
  937. package/dist/translations/zh.js.map +1 -1
  938. package/dist/ui/RangePicker.js +112 -0
  939. package/dist/ui/RangePicker.js.map +1 -0
  940. package/dist/ui/analytics.css +1533 -0
  941. package/dist/ui/calendarDays.js +27 -0
  942. package/dist/ui/calendarDays.js.map +1 -0
  943. package/dist/ui/classNames.js +7 -0
  944. package/dist/ui/classNames.js.map +1 -0
  945. package/dist/ui/components/Card.d.ts +28 -0
  946. package/dist/ui/components/Card.js +21 -0
  947. package/dist/ui/components/Card.js.map +1 -0
  948. package/dist/ui/components/ChartDataTable.d.ts +41 -0
  949. package/dist/ui/components/ChartDataTable.js +48 -0
  950. package/dist/ui/components/ChartDataTable.js.map +1 -0
  951. package/dist/ui/components/DataTable.d.ts +82 -0
  952. package/dist/ui/components/DataTable.js +214 -0
  953. package/dist/ui/components/DataTable.js.map +1 -0
  954. package/dist/ui/components/LabeledSelect.js +62 -0
  955. package/dist/ui/components/LabeledSelect.js.map +1 -0
  956. package/dist/ui/components/LiveAnnouncement.js +21 -0
  957. package/dist/ui/components/LiveAnnouncement.js.map +1 -0
  958. package/dist/ui/components/MetricCard.d.ts +38 -0
  959. package/dist/ui/components/MetricCard.js +39 -0
  960. package/dist/ui/components/MetricCard.js.map +1 -0
  961. package/dist/ui/components/NoValue.js +22 -0
  962. package/dist/ui/components/NoValue.js.map +1 -0
  963. package/dist/ui/components/ReadState.js +27 -0
  964. package/dist/ui/components/ReadState.js.map +1 -0
  965. package/dist/ui/components/RefreshButton.js +26 -0
  966. package/dist/ui/components/RefreshButton.js.map +1 -0
  967. package/dist/ui/components/SourcesNoticeBanner.js +20 -0
  968. package/dist/ui/components/SourcesNoticeBanner.js.map +1 -0
  969. package/dist/ui/cssVars.js +7 -0
  970. package/dist/ui/cssVars.js.map +1 -0
  971. package/dist/ui/data/WithScopeToken.d.ts +20 -0
  972. package/dist/ui/data/WithScopeToken.js +20 -0
  973. package/dist/ui/data/WithScopeToken.js.map +1 -0
  974. package/dist/ui/data/clientFieldProps.js +16 -0
  975. package/dist/ui/data/clientFieldProps.js.map +1 -0
  976. package/dist/ui/data/request.d.ts +46 -0
  977. package/dist/ui/data/request.js +119 -0
  978. package/dist/ui/data/request.js.map +1 -0
  979. package/dist/ui/data/scopeTokenContext.js +18 -0
  980. package/dist/ui/data/scopeTokenContext.js.map +1 -0
  981. package/dist/ui/data/sharedCache.js +48 -0
  982. package/dist/ui/data/sharedCache.js.map +1 -0
  983. package/dist/ui/data/useRequest.d.ts +19 -0
  984. package/dist/ui/data/useRequest.js +123 -0
  985. package/dist/ui/data/useRequest.js.map +1 -0
  986. package/dist/ui/data/useRequestScope.js +25 -0
  987. package/dist/ui/data/useRequestScope.js.map +1 -0
  988. package/dist/ui/hooks/useDirection.js +47 -0
  989. package/dist/ui/hooks/useDirection.js.map +1 -0
  990. package/dist/ui/hooks/useDismissOnEscape.js +25 -0
  991. package/dist/ui/hooks/useDismissOnEscape.js.map +1 -0
  992. package/dist/ui/hooks/useLiveAnnouncement.js +57 -0
  993. package/dist/ui/hooks/useLiveAnnouncement.js.map +1 -0
  994. package/dist/ui/hooks/useRealtimePoll.js +112 -0
  995. package/dist/ui/hooks/useRealtimePoll.js.map +1 -0
  996. package/dist/ui/readState.js +19 -0
  997. package/dist/ui/readState.js.map +1 -0
  998. package/dist/ui/rows/toDisplayRows.js +49 -0
  999. package/dist/ui/rows/toDisplayRows.js.map +1 -0
  1000. package/dist/ui/viewerClock.js +7 -0
  1001. package/dist/ui/viewerClock.js.map +1 -0
  1002. package/dist/view/AnalyticsNavLink.d.ts +5 -3
  1003. package/dist/view/AnalyticsNavLink.js +11 -6
  1004. package/dist/view/AnalyticsNavLink.js.map +1 -1
  1005. package/dist/view/AnalyticsView.d.ts +8 -10
  1006. package/dist/view/AnalyticsView.js +47 -18
  1007. package/dist/view/AnalyticsView.js.map +1 -1
  1008. package/dist/view/AnalyticsViewClient.d.ts +4 -7
  1009. package/dist/view/AnalyticsViewClient.js +15 -229
  1010. package/dist/view/AnalyticsViewClient.js.map +1 -1
  1011. package/dist/view/CountryFlag.d.ts +27 -0
  1012. package/dist/view/CountryFlag.js +44 -0
  1013. package/dist/view/CountryFlag.js.map +1 -0
  1014. package/dist/view/DocumentTitle.js +27 -0
  1015. package/dist/view/DocumentTitle.js.map +1 -0
  1016. package/dist/view/ViewRoot.d.ts +21 -0
  1017. package/dist/view/ViewRoot.js +152 -0
  1018. package/dist/view/ViewRoot.js.map +1 -0
  1019. package/dist/view/ViewSections.d.ts +38 -0
  1020. package/dist/view/ViewSections.js +190 -0
  1021. package/dist/view/ViewSections.js.map +1 -0
  1022. package/dist/view/authRedirect.js +2 -4
  1023. package/dist/view/authRedirect.js.map +1 -1
  1024. package/dist/view/conversionRate.js +9 -7
  1025. package/dist/view/conversionRate.js.map +1 -1
  1026. package/dist/view/dayRange.js +6 -10
  1027. package/dist/view/dayRange.js.map +1 -1
  1028. package/dist/view/exclusionLink.d.ts +27 -0
  1029. package/dist/view/exclusionLink.js +46 -0
  1030. package/dist/view/exclusionLink.js.map +1 -0
  1031. package/dist/view/flagSrc.js +14 -0
  1032. package/dist/view/flagSrc.js.map +1 -0
  1033. package/dist/view/gating.d.ts +15 -1
  1034. package/dist/view/gating.js +66 -31
  1035. package/dist/view/gating.js.map +1 -1
  1036. package/dist/view/hostCountryFlag.js +41 -0
  1037. package/dist/view/hostCountryFlag.js.map +1 -0
  1038. package/dist/view/labels.js +95 -10
  1039. package/dist/view/labels.js.map +1 -1
  1040. package/dist/view/metricAliases.js +10 -0
  1041. package/dist/view/metricAliases.js.map +1 -0
  1042. package/dist/view/navLabel.js +15 -0
  1043. package/dist/view/navLabel.js.map +1 -0
  1044. package/dist/view/registerView.js +13 -11
  1045. package/dist/view/registerView.js.map +1 -1
  1046. package/dist/view/scopeLabel.js +21 -0
  1047. package/dist/view/scopeLabel.js.map +1 -0
  1048. package/dist/view/sections/Breakdowns.js +196 -134
  1049. package/dist/view/sections/Breakdowns.js.map +1 -1
  1050. package/dist/view/sections/EmptyStates.js +118 -30
  1051. package/dist/view/sections/EmptyStates.js.map +1 -1
  1052. package/dist/view/sections/ExcludeBrowser.js +188 -0
  1053. package/dist/view/sections/ExcludeBrowser.js.map +1 -0
  1054. package/dist/view/sections/FilterChips.js +124 -27
  1055. package/dist/view/sections/FilterChips.js.map +1 -1
  1056. package/dist/view/sections/GoalsPanel.js +68 -60
  1057. package/dist/view/sections/GoalsPanel.js.map +1 -1
  1058. package/dist/view/sections/OverviewCards.js +29 -33
  1059. package/dist/view/sections/OverviewCards.js.map +1 -1
  1060. package/dist/view/sections/RealtimeStrip.js +70 -59
  1061. package/dist/view/sections/RealtimeStrip.js.map +1 -1
  1062. package/dist/view/sections/SectionBoundary.js +34 -0
  1063. package/dist/view/sections/SectionBoundary.js.map +1 -0
  1064. package/dist/view/sections/Toolbar.d.ts +11 -0
  1065. package/dist/view/sections/Toolbar.js +123 -82
  1066. package/dist/view/sections/Toolbar.js.map +1 -1
  1067. package/dist/view/sections/Trend.js +176 -76
  1068. package/dist/view/sections/Trend.js.map +1 -1
  1069. package/dist/view/state.d.ts +42 -0
  1070. package/dist/view/state.js +93 -54
  1071. package/dist/view/state.js.map +1 -1
  1072. package/dist/view/useViewClock.js +31 -0
  1073. package/dist/view/useViewClock.js.map +1 -0
  1074. package/dist/view/useViewQueries.d.ts +21 -0
  1075. package/dist/view/useViewQueries.js +45 -77
  1076. package/dist/view/useViewQueries.js.map +1 -1
  1077. package/dist/view/useViewState.js +42 -0
  1078. package/dist/view/useViewState.js.map +1 -0
  1079. package/dist/view/useViewUrl.js +47 -0
  1080. package/dist/view/useViewUrl.js.map +1 -0
  1081. package/dist/view/viewBody.js +30 -0
  1082. package/dist/view/viewBody.js.map +1 -0
  1083. package/dist/view/viewContext.d.ts +81 -0
  1084. package/dist/view/viewContext.js +49 -0
  1085. package/dist/view/viewContext.js.map +1 -0
  1086. package/dist/view/viewProps.d.ts +65 -8
  1087. package/dist/view/viewProps.js +123 -36
  1088. package/dist/view/viewProps.js.map +1 -1
  1089. package/dist/widgets/AnalyticsBreakdownWidget.d.ts +7 -3
  1090. package/dist/widgets/AnalyticsBreakdownWidget.js +144 -118
  1091. package/dist/widgets/AnalyticsBreakdownWidget.js.map +1 -1
  1092. package/dist/widgets/AnalyticsGoalsWidget.d.ts +6 -7
  1093. package/dist/widgets/AnalyticsGoalsWidget.js +125 -167
  1094. package/dist/widgets/AnalyticsGoalsWidget.js.map +1 -1
  1095. package/dist/widgets/AnalyticsMetricWidget.d.ts +7 -3
  1096. package/dist/widgets/AnalyticsMetricWidget.js +81 -106
  1097. package/dist/widgets/AnalyticsMetricWidget.js.map +1 -1
  1098. package/dist/widgets/AnalyticsRealtimeWidget.d.ts +7 -3
  1099. package/dist/widgets/AnalyticsRealtimeWidget.js +81 -63
  1100. package/dist/widgets/AnalyticsRealtimeWidget.js.map +1 -1
  1101. package/dist/widgets/AnalyticsTrendWidget.d.ts +7 -3
  1102. package/dist/widgets/AnalyticsTrendWidget.js +130 -123
  1103. package/dist/widgets/AnalyticsTrendWidget.js.map +1 -1
  1104. package/dist/widgets/ComparisonDelta.js +33 -42
  1105. package/dist/widgets/ComparisonDelta.js.map +1 -1
  1106. package/dist/widgets/RealtimeCounter.d.ts +24 -4
  1107. package/dist/widgets/RealtimeCounter.js +91 -77
  1108. package/dist/widgets/RealtimeCounter.js.map +1 -1
  1109. package/dist/widgets/WidgetCard.d.ts +80 -0
  1110. package/dist/widgets/WidgetCard.js +99 -0
  1111. package/dist/widgets/WidgetCard.js.map +1 -0
  1112. package/dist/widgets/WidgetFrame.js +42 -0
  1113. package/dist/widgets/WidgetFrame.js.map +1 -0
  1114. package/dist/widgets/WidgetShimmer.d.ts +55 -0
  1115. package/dist/widgets/WidgetShimmer.js +86 -0
  1116. package/dist/widgets/WidgetShimmer.js.map +1 -0
  1117. package/dist/widgets/breakdownTypes.js +12 -2
  1118. package/dist/widgets/breakdownTypes.js.map +1 -1
  1119. package/dist/widgets/customWidget.d.ts +5 -1
  1120. package/dist/widgets/customWidget.js +6 -7
  1121. package/dist/widgets/customWidget.js.map +1 -1
  1122. package/dist/widgets/defaultLayout.d.ts +26 -0
  1123. package/dist/widgets/defaultLayout.js +51 -0
  1124. package/dist/widgets/defaultLayout.js.map +1 -0
  1125. package/dist/widgets/defaults.d.ts +4 -7
  1126. package/dist/widgets/defaults.js +4 -7
  1127. package/dist/widgets/defaults.js.map +1 -1
  1128. package/dist/widgets/fieldRows.js +14 -0
  1129. package/dist/widgets/fieldRows.js.map +1 -0
  1130. package/dist/widgets/filterCaption.js +6 -7
  1131. package/dist/widgets/filterCaption.js.map +1 -1
  1132. package/dist/widgets/filterField.d.ts +3 -7
  1133. package/dist/widgets/filterField.js +46 -35
  1134. package/dist/widgets/filterField.js.map +1 -1
  1135. package/dist/widgets/filterValueLabel.d.ts +1 -0
  1136. package/dist/widgets/filterValueLabel.js +45 -0
  1137. package/dist/widgets/filterValueLabel.js.map +1 -0
  1138. package/dist/widgets/notices.js +74 -0
  1139. package/dist/widgets/notices.js.map +1 -0
  1140. package/dist/widgets/prepareWidgetRead.d.ts +19 -2
  1141. package/dist/widgets/prepareWidgetRead.js +63 -27
  1142. package/dist/widgets/prepareWidgetRead.js.map +1 -1
  1143. package/dist/widgets/range.js +26 -21
  1144. package/dist/widgets/range.js.map +1 -1
  1145. package/dist/widgets/readForWidget.d.ts +28 -19
  1146. package/dist/widgets/readForWidget.js +33 -29
  1147. package/dist/widgets/readForWidget.js.map +1 -1
  1148. package/dist/widgets/readForWidgetBreakdown.d.ts +40 -29
  1149. package/dist/widgets/readForWidgetBreakdown.js +48 -22
  1150. package/dist/widgets/readForWidgetBreakdown.js.map +1 -1
  1151. package/dist/widgets/readForWidgetGoals.d.ts +18 -24
  1152. package/dist/widgets/readForWidgetGoals.js +52 -46
  1153. package/dist/widgets/readForWidgetGoals.js.map +1 -1
  1154. package/dist/widgets/readForWidgetRealtime.d.ts +22 -17
  1155. package/dist/widgets/readForWidgetRealtime.js +54 -28
  1156. package/dist/widgets/readForWidgetRealtime.js.map +1 -1
  1157. package/dist/widgets/readForWidgetSeries.d.ts +27 -32
  1158. package/dist/widgets/readForWidgetSeries.js +45 -82
  1159. package/dist/widgets/readForWidgetSeries.js.map +1 -1
  1160. package/dist/widgets/readMeta.d.ts +44 -0
  1161. package/dist/widgets/readMeta.js +47 -4
  1162. package/dist/widgets/readMeta.js.map +1 -1
  1163. package/dist/widgets/realtimePoll.d.ts +1 -0
  1164. package/dist/widgets/realtimePoll.js +53 -25
  1165. package/dist/widgets/realtimePoll.js.map +1 -1
  1166. package/dist/widgets/registerWidgets.js +207 -127
  1167. package/dist/widgets/registerWidgets.js.map +1 -1
  1168. package/dist/widgets/stateKeys.js +30 -0
  1169. package/dist/widgets/stateKeys.js.map +1 -0
  1170. package/dist/widgets/titleForecast.js +89 -0
  1171. package/dist/widgets/titleForecast.js.map +1 -0
  1172. package/dist/widgets/types.d.ts +4 -3
  1173. package/dist/widgets/types.js +2 -0
  1174. package/dist/widgets/types.js.map +1 -1
  1175. package/dist/widgets/viewLink.d.ts +24 -6
  1176. package/dist/widgets/viewLink.js +31 -24
  1177. package/dist/widgets/viewLink.js.map +1 -1
  1178. package/dist/widgets/widgetData.js +34 -0
  1179. package/dist/widgets/widgetData.js.map +1 -0
  1180. package/dist/widgets/widgetWindow.d.ts +1 -0
  1181. package/dist/widgets/widgetWindow.js +51 -0
  1182. package/dist/widgets/widgetWindow.js.map +1 -0
  1183. package/package.json +44 -22
  1184. package/dist/adapters/ga4/disableKey.d.ts +0 -9
  1185. package/dist/capture/getTrackerConfig.d.ts +0 -20
  1186. package/dist/capture/getTrackerConfig.js +0 -31
  1187. package/dist/capture/getTrackerConfig.js.map +0 -1
  1188. package/dist/capture/slots.d.ts +0 -8
  1189. package/dist/capture/trackerConfig.d.ts +0 -33
  1190. package/dist/charts/styles.js +0 -59
  1191. package/dist/charts/styles.js.map +0 -1
  1192. package/dist/fields/config/SourceSelectField.d.ts +0 -14
  1193. package/dist/fields/dateRange/styles.js +0 -23
  1194. package/dist/fields/dateRange/styles.js.map +0 -1
  1195. package/dist/goals/GoalSelectField.d.ts +0 -7
  1196. package/dist/native/collections/events.js +0 -165
  1197. package/dist/native/collections/events.js.map +0 -1
  1198. package/dist/native/collections/rollups.js +0 -151
  1199. package/dist/native/collections/rollups.js.map +0 -1
  1200. package/dist/native/collections/seen.js +0 -47
  1201. package/dist/native/collections/seen.js.map +0 -1
  1202. package/dist/native/eventScan.js +0 -25
  1203. package/dist/native/eventScan.js.map +0 -1
  1204. package/dist/native/ingest/flushBatch.js +0 -60
  1205. package/dist/native/ingest/flushBatch.js.map +0 -1
  1206. package/dist/native/ingest/salt.js +0 -39
  1207. package/dist/native/ingest/salt.js.map +0 -1
  1208. package/dist/native/ingest/writeBuffer.js +0 -55
  1209. package/dist/native/ingest/writeBuffer.js.map +0 -1
  1210. package/dist/native/ingest/writeEvent.js +0 -14
  1211. package/dist/native/ingest/writeEvent.js.map +0 -1
  1212. package/dist/native/query/eventAgg.js +0 -175
  1213. package/dist/native/query/eventAgg.js.map +0 -1
  1214. package/dist/native/realtime/buildRealtime.js +0 -53
  1215. package/dist/native/realtime/buildRealtime.js.map +0 -1
  1216. package/dist/native/retention/pruneTask.js +0 -69
  1217. package/dist/native/retention/pruneTask.js.map +0 -1
  1218. package/dist/native/rollupAcc.js +0 -64
  1219. package/dist/native/rollupAcc.js.map +0 -1
  1220. package/dist/native/rollups/bucketKey.js +0 -15
  1221. package/dist/native/rollups/bucketKey.js.map +0 -1
  1222. package/dist/native/rollups/bumpRollups.js +0 -116
  1223. package/dist/native/rollups/bumpRollups.js.map +0 -1
  1224. package/dist/native/rollups/deltas.js +0 -106
  1225. package/dist/native/rollups/deltas.js.map +0 -1
  1226. package/dist/native/rollups/insertManyIfNew.js +0 -93
  1227. package/dist/native/rollups/insertManyIfNew.js.map +0 -1
  1228. package/dist/plugin/paths.js +0 -29
  1229. package/dist/plugin/paths.js.map +0 -1
  1230. package/dist/react/TrackerBoot.d.ts +0 -22
  1231. package/dist/rsc/AnalyticsScripts.d.ts +0 -30
  1232. package/dist/rsc/AnalyticsScripts.js +0 -41
  1233. package/dist/rsc/AnalyticsScripts.js.map +0 -1
  1234. package/dist/surfacing/queue.js +0 -60
  1235. package/dist/surfacing/queue.js.map +0 -1
  1236. package/dist/surfacing/retryPolicy.js +0 -15
  1237. package/dist/surfacing/retryPolicy.js.map +0 -1
  1238. package/dist/tracker/autoCapture.d.ts +0 -48
  1239. package/dist/tracker/consent.d.ts +0 -24
  1240. package/dist/tracker/consent.js +0 -48
  1241. package/dist/tracker/consent.js.map +0 -1
  1242. package/dist/tracker/loadScript.d.ts +0 -14
  1243. package/dist/tracker/pageTracking.d.ts +0 -17
  1244. package/dist/tracker/registry.d.ts +0 -27
  1245. package/dist/tracker/sinks/ga4.d.ts +0 -29
  1246. package/dist/tracker/sinks/native.d.ts +0 -22
  1247. package/dist/tracker/sinks/plausible.d.ts +0 -20
  1248. package/dist/tracker/sinks/posthog.d.ts +0 -18
  1249. package/dist/tracker/sinks/umami.d.ts +0 -18
  1250. package/dist/tracker/sinks/vendor.d.ts +0 -14
  1251. package/dist/view/sections/styles.js +0 -76
  1252. package/dist/view/sections/styles.js.map +0 -1
  1253. package/dist/widgets/WidgetViewLink.js +0 -17
  1254. package/dist/widgets/WidgetViewLink.js.map +0 -1
  1255. package/dist/widgets/cardChrome.d.ts +0 -8
  1256. package/dist/widgets/cardChrome.js +0 -46
  1257. package/dist/widgets/cardChrome.js.map +0 -1
  1258. package/dist/widgets/comparison.js +0 -57
  1259. package/dist/widgets/comparison.js.map +0 -1
@@ -1 +1 @@
1
- {"version":3,"file":"filterCaption.js","names":[],"sources":["../../src/widgets/filterCaption.ts"],"sourcesContent":["import type { AnalyticsFilter } from '../core/contract'\nimport { keys } from '../translations/keys'\nimport { FILTER_OPERATOR_KEYS } from '../translations/metricKeys'\nimport type { Translate } from '../translations/server'\nimport { DIMENSION_LABELS } from '../view/labels'\n\n/**\n * One filter as a sentence a caption can end on (\"where Country is DE\"). Both parts are\n * translated before they reach the sentence, which is itself a translated template, so a\n * locale can reorder them. The value is the editor's own text and is never translated.\n */\nexport const filterCaption = (filter: AnalyticsFilter, t: Translate): string =>\n\tt(keys.widgetFilterCaption, {\n\t\tdimension: t(DIMENSION_LABELS[filter.dimension]),\n\t\toperator: t(FILTER_OPERATOR_KEYS[filter.operator]),\n\t\tvalue: filter.value,\n\t})\n\n/**\n * A widget's caption: its window, and the filter sentence after it when there is one. The\n * join is a translated template too, so a locale that does not separate the two with a\n * space (zh) does not get one.\n */\nexport const captionWithFilter = (\n\twindowCaption: string,\n\tfilter: AnalyticsFilter | undefined,\n\tt: Translate\n): string =>\n\tfilter\n\t\t? t(keys.widgetCaptionWithFilter, {\n\t\t\t\twindow: windowCaption,\n\t\t\t\tfilter: filterCaption(filter, t),\n\t\t\t})\n\t\t: windowCaption\n"],"mappings":";;;;;;;;;AAWA,MAAa,iBAAiB,QAAyB,MACtD,EAAE,KAAK,qBAAqB;CAC3B,WAAW,EAAE,iBAAiB,OAAO,UAAU;CAC/C,UAAU,EAAE,qBAAqB,OAAO,SAAS;CACjD,OAAO,OAAO;AACf,CAAC;;;;;;AAOF,MAAa,qBACZ,eACA,QACA,MAEA,SACG,EAAE,KAAK,yBAAyB;CAChC,QAAQ;CACR,QAAQ,cAAc,QAAQ,CAAC;AAChC,CAAC,IACA"}
1
+ {"version":3,"file":"filterCaption.js","names":[],"sources":["../../src/widgets/filterCaption.ts"],"sourcesContent":["import type { AnalyticsFilter } from '../core/contract'\nimport { keys } from '../translations/keys'\nimport { FILTER_OPERATOR_KEYS } from '../translations/metricKeys'\nimport { isolate } from '../translations/parts'\nimport type { Translate } from '../translations/server'\nimport { DIMENSION_LABELS } from '../view/labels'\n\n/** A filter with the value as a reader knows it (see `filterValueLabel`), when it was looked up. */\nexport type CaptionFilter = AnalyticsFilter & { shown?: string }\n\n/**\n * One filter as a caption sentence (\"where Country is Germany\"), worded like the view's chip.\n * The value (`shown`, else stored) is bidi-isolated so a path keeps its direction in RTL text.\n */\nexport const filterCaption = (filter: CaptionFilter, t: Translate): string =>\n\tt(keys.widgetFilterCaption, {\n\t\tdimension: t(DIMENSION_LABELS[filter.dimension]),\n\t\toperator: t(FILTER_OPERATOR_KEYS[filter.operator]),\n\t\tvalue: isolate(filter.shown ?? filter.value),\n\t})\n\n/**\n * A widget's caption: its window, then the filter sentence when there is one. The join is a\n * translated template too, since some locales (zh) put no space between them.\n */\nexport const captionWithFilter = (\n\twindowCaption: string,\n\tfilter: CaptionFilter | undefined,\n\tt: Translate\n): string =>\n\tfilter\n\t\t? t(keys.widgetCaptionWithFilter, {\n\t\t\t\twindow: windowCaption,\n\t\t\t\tfilter: filterCaption(filter, t),\n\t\t\t})\n\t\t: windowCaption\n"],"mappings":";;;;;;;;;AAcA,MAAa,iBAAiB,QAAuB,MACpD,EAAE,KAAK,qBAAqB;CAC3B,WAAW,EAAE,iBAAiB,OAAO,UAAU;CAC/C,UAAU,EAAE,qBAAqB,OAAO,SAAS;CACjD,OAAO,QAAQ,OAAO,SAAS,OAAO,KAAK;AAC5C,CAAC;;;;;AAMF,MAAa,qBACZ,eACA,QACA,MAEA,SACG,EAAE,KAAK,yBAAyB;CAChC,QAAQ;CACR,QAAQ,cAAc,QAAQ,CAAC;AAChC,CAAC,IACA"}
@@ -2,14 +2,10 @@ import { AnalyticsFilter } from "../core/contract.js";
2
2
  import { WidgetFilter } from "./types.js";
3
3
  //#region src/widgets/filterField.d.ts
4
4
  /**
5
- * The stored group as query filters: one entry, or none at all. A group without both a
6
- * dimension and a value is still being configured, and the value is stored exactly as it
7
- * was typed, so the query's own trimming and cap are applied here rather than assumed.
5
+ * The stored group as zero or one query filter; the value is stored as typed, so it is trimmed
6
+ * and capped here. An unknown dimension is no filter; an unknown operator becomes `eq`.
8
7
  *
9
- * Both keys are text fields the pickers fill, so a hand-edited layout or a widget saved
10
- * against an older contract can hold anything. A dimension the contract does not define
11
- * has no label to caption it with, so it is no filter at all; an undefined operator falls
12
- * back to `eq`, the field's own default.
8
+ * @beta
13
9
  */
14
10
  declare const widgetFilters: (data: {
15
11
  filter?: WidgetFilter;
@@ -1,30 +1,29 @@
1
1
  import { DIMENSION_KEYS, FILTER_OPERATORS } from "../core/contract.js";
2
+ import { isRecord } from "../core/values.js";
2
3
  import { keys } from "../translations/keys.js";
3
4
  import { asTranslate, labelForKey } from "../translations/server.js";
5
+ import { THIRD } from "./fieldRows.js";
4
6
  //#region src/widgets/filterField.ts
5
7
  /** importMap paths of the scoped pickers; the factory never imports the components. */
6
- const FILTER_DIMENSION_COMPONENT = "@10x-media/analytics/client#FilterDimensionSelectField";
7
- const FILTER_OPERATOR_COMPONENT = "@10x-media/analytics/client#FilterOperatorSelectField";
8
+ const FILTER_DIMENSION_COMPONENT = "@10x-media/analytics/rsc#FilterDimensionSelectFieldServer";
9
+ const FILTER_OPERATOR_COMPONENT = "@10x-media/analytics/rsc#FilterOperatorSelectFieldServer";
10
+ const FILTER_VALUE_COMPONENT = "@10x-media/analytics/rsc#FilterValueFieldServer";
8
11
  /**
9
12
  * The dimension is the gate: without one there is no filter, so an empty value is fine.
10
13
  * With one, a blank value would filter on nothing and read as an accident.
11
14
  */
12
15
  const validateValue = (value, { req, siblingData }) => {
13
- const dimension = siblingData?.dimension;
16
+ const dimension = isRecord(siblingData) ? siblingData.dimension : void 0;
14
17
  if (typeof dimension !== "string" || dimension.trim() === "") return true;
15
18
  const trimmed = typeof value === "string" ? value.trim() : "";
16
19
  if (trimmed === "") return asTranslate(req.t)(keys.widgetFilterValueRequired);
17
20
  return trimmed.length <= 256 ? true : asTranslate(req.t)(keys.widgetFilterValueTooLong);
18
21
  };
19
22
  /**
20
- * The stored group as query filters: one entry, or none at all. A group without both a
21
- * dimension and a value is still being configured, and the value is stored exactly as it
22
- * was typed, so the query's own trimming and cap are applied here rather than assumed.
23
+ * The stored group as zero or one query filter; the value is stored as typed, so it is trimmed
24
+ * and capped here. An unknown dimension is no filter; an unknown operator becomes `eq`.
23
25
  *
24
- * Both keys are text fields the pickers fill, so a hand-edited layout or a widget saved
25
- * against an older contract can hold anything. A dimension the contract does not define
26
- * has no label to caption it with, so it is no filter at all; an undefined operator falls
27
- * back to `eq`, the field's own default.
26
+ * @beta
28
27
  */
29
28
  const widgetFilters = (data) => {
30
29
  const { dimension, operator, value } = data.filter ?? {};
@@ -37,37 +36,49 @@ const widgetFilters = (data) => {
37
36
  }];
38
37
  };
39
38
  /**
40
- * The optional one-filter group every filterable widget carries. Text-backed rather than
41
- * select-backed on purpose: the servable dimensions and operators are per source and per
42
- * request, so the option lists are the client pickers' to build, not the config's.
39
+ * Optional one-filter group every filterable widget carries. Text- rather than select-backed:
40
+ * servable dimensions and operators vary per source and request, so client pickers list them.
43
41
  */
44
42
  const filterField = () => ({
45
43
  name: "filter",
46
44
  type: "group",
47
45
  label: labelForKey(keys.widgetFieldFilter),
48
46
  admin: { description: labelForKey(keys.widgetFieldFilterDescription) },
49
- fields: [
50
- {
51
- name: "dimension",
52
- type: "text",
53
- label: labelForKey(keys.widgetFieldFilterDimension),
54
- admin: { components: { Field: { path: FILTER_DIMENSION_COMPONENT } } }
55
- },
56
- {
57
- name: "operator",
58
- type: "text",
59
- defaultValue: "eq",
60
- label: labelForKey(keys.widgetFieldFilterOperator),
61
- admin: { components: { Field: { path: FILTER_OPERATOR_COMPONENT } } }
62
- },
63
- {
64
- name: "value",
65
- type: "text",
66
- maxLength: 256,
67
- label: labelForKey(keys.widgetFieldFilterValue),
68
- validate: validateValue
69
- }
70
- ]
47
+ fields: [{
48
+ type: "row",
49
+ fields: [
50
+ {
51
+ name: "dimension",
52
+ type: "text",
53
+ label: labelForKey(keys.widgetFieldFilterDimension),
54
+ admin: {
55
+ width: THIRD,
56
+ components: { Field: { path: FILTER_DIMENSION_COMPONENT } }
57
+ }
58
+ },
59
+ {
60
+ name: "operator",
61
+ type: "text",
62
+ defaultValue: "eq",
63
+ label: labelForKey(keys.widgetFieldFilterOperator),
64
+ admin: {
65
+ width: THIRD,
66
+ components: { Field: { path: FILTER_OPERATOR_COMPONENT } }
67
+ }
68
+ },
69
+ {
70
+ name: "value",
71
+ type: "text",
72
+ maxLength: 256,
73
+ label: labelForKey(keys.widgetFieldFilterValue),
74
+ validate: validateValue,
75
+ admin: {
76
+ width: THIRD,
77
+ components: { Field: { path: FILTER_VALUE_COMPONENT } }
78
+ }
79
+ }
80
+ ]
81
+ }]
71
82
  });
72
83
  //#endregion
73
84
  export { filterField, widgetFilters };
@@ -1 +1 @@
1
- {"version":3,"file":"filterField.js","names":[],"sources":["../../src/widgets/filterField.ts"],"sourcesContent":["import type { NamedGroupField, TextFieldSingleValidation } from 'payload'\nimport { type AnalyticsFilter, DIMENSION_KEYS, FILTER_OPERATORS } from '../core/contract'\nimport { MAX_QUERY_FILTER_VALUE_LENGTH } from '../query/limits'\nimport { keys } from '../translations/keys'\nimport { asTranslate, labelForKey } from '../translations/server'\nimport type { WidgetFilter } from './types'\n\n/** importMap paths of the scoped pickers; the factory never imports the components. */\nexport const FILTER_DIMENSION_COMPONENT = '@10x-media/analytics/client#FilterDimensionSelectField'\nexport const FILTER_OPERATOR_COMPONENT = '@10x-media/analytics/client#FilterOperatorSelectField'\n\n/**\n * The dimension is the gate: without one there is no filter, so an empty value is fine.\n * With one, a blank value would filter on nothing and read as an accident.\n */\nconst validateValue: TextFieldSingleValidation = (value, { req, siblingData }) => {\n\tconst dimension = (siblingData as { dimension?: unknown } | undefined)?.dimension\n\tif (typeof dimension !== 'string' || dimension.trim() === '') return true\n\tconst trimmed = typeof value === 'string' ? value.trim() : ''\n\tif (trimmed === '') return asTranslate(req.t)(keys.widgetFilterValueRequired)\n\treturn trimmed.length <= MAX_QUERY_FILTER_VALUE_LENGTH\n\t\t? true\n\t\t: asTranslate(req.t)(keys.widgetFilterValueTooLong)\n}\n\n/**\n * The stored group as query filters: one entry, or none at all. A group without both a\n * dimension and a value is still being configured, and the value is stored exactly as it\n * was typed, so the query's own trimming and cap are applied here rather than assumed.\n *\n * Both keys are text fields the pickers fill, so a hand-edited layout or a widget saved\n * against an older contract can hold anything. A dimension the contract does not define\n * has no label to caption it with, so it is no filter at all; an undefined operator falls\n * back to `eq`, the field's own default.\n */\nexport const widgetFilters = (data: { filter?: WidgetFilter }): AnalyticsFilter[] => {\n\tconst { dimension, operator, value } = data.filter ?? {}\n\tconst trimmed = typeof value === 'string' ? value.trim() : ''\n\tif (!dimension || !DIMENSION_KEYS.includes(dimension) || trimmed === '') {\n\t\treturn []\n\t}\n\treturn [\n\t\t{\n\t\t\tdimension,\n\t\t\toperator: operator && FILTER_OPERATORS.includes(operator) ? operator : 'eq',\n\t\t\tvalue: trimmed.slice(0, MAX_QUERY_FILTER_VALUE_LENGTH),\n\t\t},\n\t]\n}\n\n/**\n * The optional one-filter group every filterable widget carries. Text-backed rather than\n * select-backed on purpose: the servable dimensions and operators are per source and per\n * request, so the option lists are the client pickers' to build, not the config's.\n */\nexport const filterField = (): NamedGroupField => ({\n\tname: 'filter',\n\ttype: 'group',\n\tlabel: labelForKey(keys.widgetFieldFilter),\n\tadmin: { description: labelForKey(keys.widgetFieldFilterDescription) },\n\tfields: [\n\t\t{\n\t\t\tname: 'dimension',\n\t\t\ttype: 'text',\n\t\t\tlabel: labelForKey(keys.widgetFieldFilterDimension),\n\t\t\tadmin: { components: { Field: { path: FILTER_DIMENSION_COMPONENT } } },\n\t\t},\n\t\t{\n\t\t\tname: 'operator',\n\t\t\ttype: 'text',\n\t\t\tdefaultValue: 'eq',\n\t\t\tlabel: labelForKey(keys.widgetFieldFilterOperator),\n\t\t\tadmin: { components: { Field: { path: FILTER_OPERATOR_COMPONENT } } },\n\t\t},\n\t\t{\n\t\t\tname: 'value',\n\t\t\ttype: 'text',\n\t\t\tmaxLength: MAX_QUERY_FILTER_VALUE_LENGTH,\n\t\t\tlabel: labelForKey(keys.widgetFieldFilterValue),\n\t\t\tvalidate: validateValue,\n\t\t},\n\t],\n})\n"],"mappings":";;;;;AAQA,MAAa,6BAA6B;AAC1C,MAAa,4BAA4B;;;;;AAMzC,MAAM,iBAA4C,OAAO,EAAE,KAAK,kBAAkB;CACjF,MAAM,YAAa,aAAqD;CACxE,IAAI,OAAO,cAAc,YAAY,UAAU,KAAK,MAAM,IAAI,OAAO;CACrE,MAAM,UAAU,OAAO,UAAU,WAAW,MAAM,KAAK,IAAI;CAC3D,IAAI,YAAY,IAAI,OAAO,YAAY,IAAI,CAAC,EAAE,KAAK,yBAAyB;CAC5E,OAAO,QAAQ,UAAA,MACZ,OACA,YAAY,IAAI,CAAC,EAAE,KAAK,wBAAwB;AACpD;;;;;;;;;;;AAYA,MAAa,iBAAiB,SAAuD;CACpF,MAAM,EAAE,WAAW,UAAU,UAAU,KAAK,UAAU,CAAC;CACvD,MAAM,UAAU,OAAO,UAAU,WAAW,MAAM,KAAK,IAAI;CAC3D,IAAI,CAAC,aAAa,CAAC,eAAe,SAAS,SAAS,KAAK,YAAY,IACpE,OAAO,CAAC;CAET,OAAO,CACN;EACC;EACA,UAAU,YAAY,iBAAiB,SAAS,QAAQ,IAAI,WAAW;EACvE,OAAO,QAAQ,MAAM,GAAA,GAAgC;CACtD,CACD;AACD;;;;;;AAOA,MAAa,qBAAsC;CAClD,MAAM;CACN,MAAM;CACN,OAAO,YAAY,KAAK,iBAAiB;CACzC,OAAO,EAAE,aAAa,YAAY,KAAK,4BAA4B,EAAE;CACrE,QAAQ;EACP;GACC,MAAM;GACN,MAAM;GACN,OAAO,YAAY,KAAK,0BAA0B;GAClD,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,2BAA2B,EAAE,EAAE;EACtE;EACA;GACC,MAAM;GACN,MAAM;GACN,cAAc;GACd,OAAO,YAAY,KAAK,yBAAyB;GACjD,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,0BAA0B,EAAE,EAAE;EACrE;EACA;GACC,MAAM;GACN,MAAM;GACN,WAAA;GACA,OAAO,YAAY,KAAK,sBAAsB;GAC9C,UAAU;EACX;CACD;AACD"}
1
+ {"version":3,"file":"filterField.js","names":[],"sources":["../../src/widgets/filterField.ts"],"sourcesContent":["import type { NamedGroupField, TextFieldSingleValidation } from 'payload'\nimport { type AnalyticsFilter, DIMENSION_KEYS, FILTER_OPERATORS } from '../core/contract'\nimport { isRecord } from '../core/values'\nimport { MAX_QUERY_FILTER_VALUE_LENGTH } from '../query/limits'\nimport { keys } from '../translations/keys'\nimport { asTranslate, labelForKey } from '../translations/server'\nimport { THIRD } from './fieldRows'\nimport type { WidgetFilter } from './types'\n\n/** importMap paths of the scoped pickers; the factory never imports the components. */\nexport const FILTER_DIMENSION_COMPONENT =\n\t'@10x-media/analytics/rsc#FilterDimensionSelectFieldServer'\nexport const FILTER_OPERATOR_COMPONENT = '@10x-media/analytics/rsc#FilterOperatorSelectFieldServer'\nexport const FILTER_VALUE_COMPONENT = '@10x-media/analytics/rsc#FilterValueFieldServer'\n\n/**\n * The dimension is the gate: without one there is no filter, so an empty value is fine.\n * With one, a blank value would filter on nothing and read as an accident.\n */\nconst validateValue: TextFieldSingleValidation = (value, { req, siblingData }) => {\n\tconst dimension = isRecord(siblingData) ? siblingData.dimension : undefined\n\tif (typeof dimension !== 'string' || dimension.trim() === '') return true\n\tconst trimmed = typeof value === 'string' ? value.trim() : ''\n\tif (trimmed === '') return asTranslate(req.t)(keys.widgetFilterValueRequired)\n\treturn trimmed.length <= MAX_QUERY_FILTER_VALUE_LENGTH\n\t\t? true\n\t\t: asTranslate(req.t)(keys.widgetFilterValueTooLong)\n}\n\n/**\n * The stored group as zero or one query filter; the value is stored as typed, so it is trimmed\n * and capped here. An unknown dimension is no filter; an unknown operator becomes `eq`.\n *\n * @beta\n */\nexport const widgetFilters = (data: { filter?: WidgetFilter }): AnalyticsFilter[] => {\n\tconst { dimension, operator, value } = data.filter ?? {}\n\tconst trimmed = typeof value === 'string' ? value.trim() : ''\n\tif (!dimension || !DIMENSION_KEYS.includes(dimension) || trimmed === '') {\n\t\treturn []\n\t}\n\treturn [\n\t\t{\n\t\t\tdimension,\n\t\t\toperator: operator && FILTER_OPERATORS.includes(operator) ? operator : 'eq',\n\t\t\tvalue: trimmed.slice(0, MAX_QUERY_FILTER_VALUE_LENGTH),\n\t\t},\n\t]\n}\n\n/**\n * Optional one-filter group every filterable widget carries. Text- rather than select-backed:\n * servable dimensions and operators vary per source and request, so client pickers list them.\n */\nexport const filterField = (): NamedGroupField => ({\n\tname: 'filter',\n\ttype: 'group',\n\tlabel: labelForKey(keys.widgetFieldFilter),\n\tadmin: { description: labelForKey(keys.widgetFieldFilterDescription) },\n\tfields: [\n\t\t{\n\t\t\t// A row carries no name, so the three keep their `filter.<name>` paths.\n\t\t\ttype: 'row',\n\t\t\tfields: [\n\t\t\t\t{\n\t\t\t\t\tname: 'dimension',\n\t\t\t\t\ttype: 'text',\n\t\t\t\t\tlabel: labelForKey(keys.widgetFieldFilterDimension),\n\t\t\t\t\tadmin: { width: THIRD, components: { Field: { path: FILTER_DIMENSION_COMPONENT } } },\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\tname: 'operator',\n\t\t\t\t\ttype: 'text',\n\t\t\t\t\tdefaultValue: 'eq',\n\t\t\t\t\tlabel: labelForKey(keys.widgetFieldFilterOperator),\n\t\t\t\t\tadmin: { width: THIRD, components: { Field: { path: FILTER_OPERATOR_COMPONENT } } },\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\tname: 'value',\n\t\t\t\t\ttype: 'text',\n\t\t\t\t\tmaxLength: MAX_QUERY_FILTER_VALUE_LENGTH,\n\t\t\t\t\tlabel: labelForKey(keys.widgetFieldFilterValue),\n\t\t\t\t\tvalidate: validateValue,\n\t\t\t\t\tadmin: { width: THIRD, components: { Field: { path: FILTER_VALUE_COMPONENT } } },\n\t\t\t\t},\n\t\t\t],\n\t\t},\n\t],\n})\n"],"mappings":";;;;;;;AAUA,MAAa,6BACZ;AACD,MAAa,4BAA4B;AACzC,MAAa,yBAAyB;;;;;AAMtC,MAAM,iBAA4C,OAAO,EAAE,KAAK,kBAAkB;CACjF,MAAM,YAAY,SAAS,WAAW,IAAI,YAAY,YAAY,KAAA;CAClE,IAAI,OAAO,cAAc,YAAY,UAAU,KAAK,MAAM,IAAI,OAAO;CACrE,MAAM,UAAU,OAAO,UAAU,WAAW,MAAM,KAAK,IAAI;CAC3D,IAAI,YAAY,IAAI,OAAO,YAAY,IAAI,CAAC,EAAE,KAAK,yBAAyB;CAC5E,OAAO,QAAQ,UAAA,MACZ,OACA,YAAY,IAAI,CAAC,EAAE,KAAK,wBAAwB;AACpD;;;;;;;AAQA,MAAa,iBAAiB,SAAuD;CACpF,MAAM,EAAE,WAAW,UAAU,UAAU,KAAK,UAAU,CAAC;CACvD,MAAM,UAAU,OAAO,UAAU,WAAW,MAAM,KAAK,IAAI;CAC3D,IAAI,CAAC,aAAa,CAAC,eAAe,SAAS,SAAS,KAAK,YAAY,IACpE,OAAO,CAAC;CAET,OAAO,CACN;EACC;EACA,UAAU,YAAY,iBAAiB,SAAS,QAAQ,IAAI,WAAW;EACvE,OAAO,QAAQ,MAAM,GAAA,GAAgC;CACtD,CACD;AACD;;;;;AAMA,MAAa,qBAAsC;CAClD,MAAM;CACN,MAAM;CACN,OAAO,YAAY,KAAK,iBAAiB;CACzC,OAAO,EAAE,aAAa,YAAY,KAAK,4BAA4B,EAAE;CACrE,QAAQ,CACP;EAEC,MAAM;EACN,QAAQ;GACP;IACC,MAAM;IACN,MAAM;IACN,OAAO,YAAY,KAAK,0BAA0B;IAClD,OAAO;KAAE,OAAO;KAAO,YAAY,EAAE,OAAO,EAAE,MAAM,2BAA2B,EAAE;IAAE;GACpF;GACA;IACC,MAAM;IACN,MAAM;IACN,cAAc;IACd,OAAO,YAAY,KAAK,yBAAyB;IACjD,OAAO;KAAE,OAAO;KAAO,YAAY,EAAE,OAAO,EAAE,MAAM,0BAA0B,EAAE;IAAE;GACnF;GACA;IACC,MAAM;IACN,MAAM;IACN,WAAA;IACA,OAAO,YAAY,KAAK,sBAAsB;IAC9C,UAAU;IACV,OAAO;KAAE,OAAO;KAAO,YAAY,EAAE,OAAO,EAAE,MAAM,uBAAuB,EAAE;IAAE;GAChF;EACD;CACD,CACD;AACD"}
@@ -0,0 +1 @@
1
+ import { PayloadRequest } from "payload";
@@ -0,0 +1,45 @@
1
+ import { getRuntime, resolveGoalsFor } from "../plugin/runtime.js";
2
+ import { asTranslate } from "../translations/server.js";
3
+ import { intlLocale } from "../translations/intl.js";
4
+ import { resolveItemLabels } from "../plugin/itemLabels.js";
5
+ import { valueLabel } from "../view/labels.js";
6
+ //#region src/widgets/filterValueLabel.ts
7
+ const goalNames = async (req) => {
8
+ const runtime = getRuntime(req.payload);
9
+ if (!runtime) return [];
10
+ return (await resolveGoalsFor(runtime, req).catch(() => [])).map(({ slug, name }) => ({
11
+ slug,
12
+ name
13
+ }));
14
+ };
15
+ /**
16
+ * A filter value as the view's chip names it (via {@link valueLabel}). A goal or item the
17
+ * widget cannot look up keeps its stored value rather than reading as loading or removed.
18
+ */
19
+ const filterValueLabel = async (req, filter, { provider, goals }) => {
20
+ const translate = req.i18n?.t;
21
+ if (translate === void 0) return filter.value;
22
+ const args = {
23
+ dimension: filter.dimension,
24
+ value: filter.value,
25
+ provider: provider ?? "",
26
+ t: asTranslate(translate),
27
+ locale: intlLocale(req.i18n.language)
28
+ };
29
+ if (filter.dimension === "goal") return valueLabel({
30
+ ...args,
31
+ goals: goals ?? await goalNames(req)
32
+ });
33
+ if (filter.dimension === "item") {
34
+ const itemLabels = await resolveItemLabels(req, [filter.value]).catch(() => void 0);
35
+ return itemLabels === void 0 ? filter.value : valueLabel({
36
+ ...args,
37
+ itemLabels
38
+ });
39
+ }
40
+ return valueLabel(args);
41
+ };
42
+ //#endregion
43
+ export { filterValueLabel };
44
+
45
+ //# sourceMappingURL=filterValueLabel.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"filterValueLabel.js","names":[],"sources":["../../src/widgets/filterValueLabel.ts"],"sourcesContent":["import type { PayloadRequest } from 'payload'\nimport type { AnalyticsFilter } from '../core/contract'\nimport { resolveItemLabels } from '../plugin/itemLabels'\nimport { getRuntime, resolveGoalsFor } from '../plugin/runtime'\nimport { intlLocale } from '../translations/intl'\nimport { asTranslate } from '../translations/server'\nimport { valueLabel } from '../view/labels'\n\ntype GoalName = { slug: string; name: string }\n\n/** What the read says about its labels: the source that answered and the goals it named. */\nexport interface LabelledRead {\n\tprovider?: string | undefined\n\tgoals?: ReadonlyArray<GoalName> | undefined\n}\n\nconst goalNames = async (req: PayloadRequest): Promise<GoalName[]> => {\n\tconst runtime = getRuntime(req.payload)\n\tif (!runtime) {\n\t\treturn []\n\t}\n\tconst goals = await resolveGoalsFor(runtime, req).catch((): GoalName[] => [])\n\treturn goals.map(({ slug, name }) => ({ slug, name }))\n}\n\n/**\n * A filter value as the view's chip names it (via {@link valueLabel}). A goal or item the\n * widget cannot look up keeps its stored value rather than reading as loading or removed.\n */\nexport const filterValueLabel = async (\n\treq: PayloadRequest,\n\tfilter: AnalyticsFilter,\n\t{ provider, goals }: LabelledRead\n): Promise<string> => {\n\tconst translate = req.i18n?.t\n\tif (translate === undefined) {\n\t\treturn filter.value\n\t}\n\tconst args = {\n\t\tdimension: filter.dimension,\n\t\tvalue: filter.value,\n\t\tprovider: provider ?? '',\n\t\tt: asTranslate(translate),\n\t\tlocale: intlLocale(req.i18n.language),\n\t}\n\tif (filter.dimension === 'goal') {\n\t\treturn valueLabel({ ...args, goals: goals ?? (await goalNames(req)) })\n\t}\n\tif (filter.dimension === 'item') {\n\t\tconst itemLabels = await resolveItemLabels(req, [filter.value]).catch(\n\t\t\t(): undefined => undefined\n\t\t)\n\t\treturn itemLabels === undefined ? filter.value : valueLabel({ ...args, itemLabels })\n\t}\n\treturn valueLabel(args)\n}\n"],"mappings":";;;;;;AAgBA,MAAM,YAAY,OAAO,QAA6C;CACrE,MAAM,UAAU,WAAW,IAAI,OAAO;CACtC,IAAI,CAAC,SACJ,OAAO,CAAC;CAGT,QAAO,MADa,gBAAgB,SAAS,GAAG,EAAE,YAAwB,CAAC,CAAC,GAC/D,KAAK,EAAE,MAAM,YAAY;EAAE;EAAM;CAAK,EAAE;AACtD;;;;;AAMA,MAAa,mBAAmB,OAC/B,KACA,QACA,EAAE,UAAU,YACS;CACrB,MAAM,YAAY,IAAI,MAAM;CAC5B,IAAI,cAAc,KAAA,GACjB,OAAO,OAAO;CAEf,MAAM,OAAO;EACZ,WAAW,OAAO;EAClB,OAAO,OAAO;EACd,UAAU,YAAY;EACtB,GAAG,YAAY,SAAS;EACxB,QAAQ,WAAW,IAAI,KAAK,QAAQ;CACrC;CACA,IAAI,OAAO,cAAc,QACxB,OAAO,WAAW;EAAE,GAAG;EAAM,OAAO,SAAU,MAAM,UAAU,GAAG;CAAG,CAAC;CAEtE,IAAI,OAAO,cAAc,QAAQ;EAChC,MAAM,aAAa,MAAM,kBAAkB,KAAK,CAAC,OAAO,KAAK,CAAC,EAAE,YAC9C,KAAA,CAClB;EACA,OAAO,eAAe,KAAA,IAAY,OAAO,QAAQ,WAAW;GAAE,GAAG;GAAM;EAAW,CAAC;CACpF;CACA,OAAO,WAAW,IAAI;AACvB"}
@@ -0,0 +1,74 @@
1
+ import { keys } from "../translations/keys.js";
2
+ import { dateTimeFormat, listFormat, relativeTimeFormat } from "../translations/intl.js";
3
+ //#region src/widgets/notices.ts
4
+ /** Between notices on the one line: a list separator, not sentence punctuation. */
5
+ const NOTICE_SEPARATOR = " · ";
6
+ const SECOND = 1e3;
7
+ const MINUTE = 60 * SECOND;
8
+ const HOUR = 60 * MINUTE;
9
+ const relativeFormat = (locale) => relativeTimeFormat(locale, { numeric: "auto" });
10
+ /** How long ago `asOf` was, in the reader's language: "3 minutes ago". */
11
+ const timeAgo = (asOf, now, locale) => {
12
+ const elapsed = Math.max(0, now.getTime() - Date.parse(asOf));
13
+ const format = relativeFormat(locale);
14
+ if (elapsed < MINUTE) return format.format(-Math.round(elapsed / SECOND), "second");
15
+ if (elapsed < HOUR) return format.format(-Math.floor(elapsed / MINUTE), "minute");
16
+ return format.format(-Math.floor(elapsed / HOUR), "hour");
17
+ };
18
+ /** The day an instant falls on in the reader's language and the reporting zone: "Mar 3, 2026". */
19
+ const dayOf = (instant, context) => dateTimeFormat(context.locale, {
20
+ month: "short",
21
+ day: "numeric",
22
+ year: "numeric",
23
+ timeZone: context.timeZone ?? "UTC"
24
+ }).format(new Date(instant));
25
+ /** What a clamped read covers, by the bounds it kept, else the generic wording. */
26
+ const clampedText = (flags, context) => {
27
+ const { t } = context;
28
+ const from = flags.dataFrom;
29
+ const to = flags.dataTo;
30
+ if (from && to) return t(keys.stateClampedBetween, {
31
+ from: dayOf(from, context),
32
+ to: dayOf(to, context)
33
+ });
34
+ if (from) return t(keys.stateClampedFrom, { date: dayOf(from, context) });
35
+ if (to) return t(keys.stateClampedTo, { date: dayOf(to, context) });
36
+ return t(keys.stateClamped);
37
+ };
38
+ /**
39
+ * The caveats a read carries, each a sentence, widest-reaching first, so the one that changes what
40
+ * the number means the most is read first. Empty when the read carries none, the common case.
41
+ */
42
+ const noticeTexts = (flags, context) => {
43
+ const { t } = context;
44
+ const texts = [];
45
+ if (flags.substitutedFrom !== void 0) texts.push(t(keys.stateSourceSubstituted));
46
+ if (flags.stale) texts.push(t(keys.viewStale));
47
+ if (flags.hostRefused) texts.push(t(keys.viewErrorHostRefused));
48
+ else if (flags.sourceError) texts.push(t(keys.viewErrorMisconfigured));
49
+ if (flags.timezoneUnresolved) texts.push(t(keys.stateTimezoneUnresolved));
50
+ if (flags.partial) texts.push(t(keys.statePartial));
51
+ if (flags.capped) texts.push(t(keys.stateCapped));
52
+ if (flags.failed) texts.push(t(keys.stateFailed));
53
+ if (flags.clamped) texts.push(clampedText(flags, context));
54
+ if (flags.filtersUnapplied) texts.push(t(keys.stateFiltersUnapplied));
55
+ if (flags.sampled) texts.push(t(keys.stateSampled));
56
+ const currencies = flags.mixedCurrencies ?? [];
57
+ if (currencies.length > 1) {
58
+ const named = listFormat(context.locale, { type: "conjunction" }).format(currencies);
59
+ texts.push(t(keys.stateMixedCurrencies, { currencies: named }));
60
+ }
61
+ if (flags.goalsUnresolved) texts.push(t(keys.stateGoalsUnresolved));
62
+ else if (flags.noGoals) texts.push(t(keys.stateNoGoals));
63
+ if (flags.asOf) texts.push(t(keys.stateUpdated, { ago: timeAgo(flags.asOf, context.now, context.locale) }));
64
+ return texts;
65
+ };
66
+ /**
67
+ * The caveats as one line: a card is a few centimetres tall, and notices stacked under it would
68
+ * push the number itself out of view.
69
+ */
70
+ const widgetNotice = (flags, context) => noticeTexts(flags, context).join(NOTICE_SEPARATOR);
71
+ //#endregion
72
+ export { noticeTexts, widgetNotice };
73
+
74
+ //# sourceMappingURL=notices.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"notices.js","names":[],"sources":["../../src/widgets/notices.ts"],"sourcesContent":["import { dateTimeFormat, listFormat, relativeTimeFormat } from '../translations/intl'\nimport { keys } from '../translations/keys'\nimport type { Translate } from '../translations/server'\nimport type { SubstitutedSource } from './prepareWidgetRead'\nimport type { ReadNotices } from './readMeta'\n\n/** What a read can carry beyond its numbers, each of which earns a word of caveat. */\nexport type WidgetNoticeFlags = Partial<ReadNotices> &\n\tSubstitutedSource & {\n\t\t/** The read asked about goals and the scope declared none of its own. */\n\t\tnoGoals?: boolean\n\t}\n\n/** What wording a notice needs beyond its key: the reader's language and the moment it is read. */\nexport interface NoticeContext {\n\tt: Translate\n\tlocale: string\n\tnow: Date\n\t/** The reporting timezone a clamped window's days are named in; UTC when absent. */\n\ttimeZone?: string\n}\n\n/** Between notices on the one line: a list separator, not sentence punctuation. */\nexport const NOTICE_SEPARATOR = ' · '\n\nconst SECOND = 1000\nconst MINUTE = 60 * SECOND\nconst HOUR = 60 * MINUTE\n\nconst relativeFormat = (locale: string): Intl.RelativeTimeFormat =>\n\trelativeTimeFormat(locale, { numeric: 'auto' })\n\n/** How long ago `asOf` was, in the reader's language: \"3 minutes ago\". */\nexport const timeAgo = (asOf: string, now: Date, locale: string): string => {\n\tconst elapsed = Math.max(0, now.getTime() - Date.parse(asOf))\n\tconst format = relativeFormat(locale)\n\tif (elapsed < MINUTE) {\n\t\treturn format.format(-Math.round(elapsed / SECOND), 'second')\n\t}\n\tif (elapsed < HOUR) {\n\t\treturn format.format(-Math.floor(elapsed / MINUTE), 'minute')\n\t}\n\treturn format.format(-Math.floor(elapsed / HOUR), 'hour')\n}\n\n/** The day an instant falls on in the reader's language and the reporting zone: \"Mar 3, 2026\". */\nconst dayOf = (instant: string, context: NoticeContext): string =>\n\tdateTimeFormat(context.locale, {\n\t\tmonth: 'short',\n\t\tday: 'numeric',\n\t\tyear: 'numeric',\n\t\ttimeZone: context.timeZone ?? 'UTC',\n\t}).format(new Date(instant))\n\n/** What a clamped read covers, by the bounds it kept, else the generic wording. */\nconst clampedText = (flags: WidgetNoticeFlags, context: NoticeContext): string => {\n\tconst { t } = context\n\tconst from = flags.dataFrom\n\tconst to = flags.dataTo\n\tif (from && to) {\n\t\treturn t(keys.stateClampedBetween, { from: dayOf(from, context), to: dayOf(to, context) })\n\t}\n\tif (from) return t(keys.stateClampedFrom, { date: dayOf(from, context) })\n\tif (to) return t(keys.stateClampedTo, { date: dayOf(to, context) })\n\treturn t(keys.stateClamped)\n}\n\n/**\n * The caveats a read carries, each a sentence, widest-reaching first, so the one that changes what\n * the number means the most is read first. Empty when the read carries none, the common case.\n */\nexport const noticeTexts = (flags: WidgetNoticeFlags, context: NoticeContext): string[] => {\n\tconst { t } = context\n\tconst texts: string[] = []\n\t// The id is not named: it can be an internal one, such as a provider document's.\n\tif (flags.substitutedFrom !== undefined) texts.push(t(keys.stateSourceSubstituted))\n\tif (flags.stale) texts.push(t(keys.viewStale))\n\tif (flags.hostRefused) texts.push(t(keys.viewErrorHostRefused))\n\telse if (flags.sourceError) texts.push(t(keys.viewErrorMisconfigured))\n\tif (flags.timezoneUnresolved) texts.push(t(keys.stateTimezoneUnresolved))\n\tif (flags.partial) texts.push(t(keys.statePartial))\n\tif (flags.capped) texts.push(t(keys.stateCapped))\n\tif (flags.failed) texts.push(t(keys.stateFailed))\n\tif (flags.clamped) texts.push(clampedText(flags, context))\n\tif (flags.filtersUnapplied) texts.push(t(keys.stateFiltersUnapplied))\n\tif (flags.sampled) texts.push(t(keys.stateSampled))\n\tconst currencies = flags.mixedCurrencies ?? []\n\tif (currencies.length > 1) {\n\t\tconst named = listFormat(context.locale, { type: 'conjunction' }).format(currencies)\n\t\ttexts.push(t(keys.stateMixedCurrencies, { currencies: named }))\n\t}\n\t// A conversions number with no goals behind it is a number about nothing, which the plain\n\t// caption would read as \"nobody converted\".\n\tif (flags.goalsUnresolved) texts.push(t(keys.stateGoalsUnresolved))\n\telse if (flags.noGoals) texts.push(t(keys.stateNoGoals))\n\tif (flags.asOf) {\n\t\ttexts.push(t(keys.stateUpdated, { ago: timeAgo(flags.asOf, context.now, context.locale) }))\n\t}\n\treturn texts\n}\n\n/**\n * The caveats as one line: a card is a few centimetres tall, and notices stacked under it would\n * push the number itself out of view.\n */\nexport const widgetNotice = (flags: WidgetNoticeFlags, context: NoticeContext): string =>\n\tnoticeTexts(flags, context).join(NOTICE_SEPARATOR)\n"],"mappings":";;;;AAuBA,MAAa,mBAAmB;AAEhC,MAAM,SAAS;AACf,MAAM,SAAS,KAAK;AACpB,MAAM,OAAO,KAAK;AAElB,MAAM,kBAAkB,WACvB,mBAAmB,QAAQ,EAAE,SAAS,OAAO,CAAC;;AAG/C,MAAa,WAAW,MAAc,KAAW,WAA2B;CAC3E,MAAM,UAAU,KAAK,IAAI,GAAG,IAAI,QAAQ,IAAI,KAAK,MAAM,IAAI,CAAC;CAC5D,MAAM,SAAS,eAAe,MAAM;CACpC,IAAI,UAAU,QACb,OAAO,OAAO,OAAO,CAAC,KAAK,MAAM,UAAU,MAAM,GAAG,QAAQ;CAE7D,IAAI,UAAU,MACb,OAAO,OAAO,OAAO,CAAC,KAAK,MAAM,UAAU,MAAM,GAAG,QAAQ;CAE7D,OAAO,OAAO,OAAO,CAAC,KAAK,MAAM,UAAU,IAAI,GAAG,MAAM;AACzD;;AAGA,MAAM,SAAS,SAAiB,YAC/B,eAAe,QAAQ,QAAQ;CAC9B,OAAO;CACP,KAAK;CACL,MAAM;CACN,UAAU,QAAQ,YAAY;AAC/B,CAAC,EAAE,OAAO,IAAI,KAAK,OAAO,CAAC;;AAG5B,MAAM,eAAe,OAA0B,YAAmC;CACjF,MAAM,EAAE,MAAM;CACd,MAAM,OAAO,MAAM;CACnB,MAAM,KAAK,MAAM;CACjB,IAAI,QAAQ,IACX,OAAO,EAAE,KAAK,qBAAqB;EAAE,MAAM,MAAM,MAAM,OAAO;EAAG,IAAI,MAAM,IAAI,OAAO;CAAE,CAAC;CAE1F,IAAI,MAAM,OAAO,EAAE,KAAK,kBAAkB,EAAE,MAAM,MAAM,MAAM,OAAO,EAAE,CAAC;CACxE,IAAI,IAAI,OAAO,EAAE,KAAK,gBAAgB,EAAE,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;CAClE,OAAO,EAAE,KAAK,YAAY;AAC3B;;;;;AAMA,MAAa,eAAe,OAA0B,YAAqC;CAC1F,MAAM,EAAE,MAAM;CACd,MAAM,QAAkB,CAAC;CAEzB,IAAI,MAAM,oBAAoB,KAAA,GAAW,MAAM,KAAK,EAAE,KAAK,sBAAsB,CAAC;CAClF,IAAI,MAAM,OAAO,MAAM,KAAK,EAAE,KAAK,SAAS,CAAC;CAC7C,IAAI,MAAM,aAAa,MAAM,KAAK,EAAE,KAAK,oBAAoB,CAAC;MACzD,IAAI,MAAM,aAAa,MAAM,KAAK,EAAE,KAAK,sBAAsB,CAAC;CACrE,IAAI,MAAM,oBAAoB,MAAM,KAAK,EAAE,KAAK,uBAAuB,CAAC;CACxE,IAAI,MAAM,SAAS,MAAM,KAAK,EAAE,KAAK,YAAY,CAAC;CAClD,IAAI,MAAM,QAAQ,MAAM,KAAK,EAAE,KAAK,WAAW,CAAC;CAChD,IAAI,MAAM,QAAQ,MAAM,KAAK,EAAE,KAAK,WAAW,CAAC;CAChD,IAAI,MAAM,SAAS,MAAM,KAAK,YAAY,OAAO,OAAO,CAAC;CACzD,IAAI,MAAM,kBAAkB,MAAM,KAAK,EAAE,KAAK,qBAAqB,CAAC;CACpE,IAAI,MAAM,SAAS,MAAM,KAAK,EAAE,KAAK,YAAY,CAAC;CAClD,MAAM,aAAa,MAAM,mBAAmB,CAAC;CAC7C,IAAI,WAAW,SAAS,GAAG;EAC1B,MAAM,QAAQ,WAAW,QAAQ,QAAQ,EAAE,MAAM,cAAc,CAAC,EAAE,OAAO,UAAU;EACnF,MAAM,KAAK,EAAE,KAAK,sBAAsB,EAAE,YAAY,MAAM,CAAC,CAAC;CAC/D;CAGA,IAAI,MAAM,iBAAiB,MAAM,KAAK,EAAE,KAAK,oBAAoB,CAAC;MAC7D,IAAI,MAAM,SAAS,MAAM,KAAK,EAAE,KAAK,YAAY,CAAC;CACvD,IAAI,MAAM,MACT,MAAM,KAAK,EAAE,KAAK,cAAc,EAAE,KAAK,QAAQ,MAAM,MAAM,QAAQ,KAAK,QAAQ,MAAM,EAAE,CAAC,CAAC;CAE3F,OAAO;AACR;;;;;AAMA,MAAa,gBAAgB,OAA0B,YACtD,YAAY,OAAO,OAAO,EAAE,KAAK,gBAAgB"}
@@ -1,7 +1,24 @@
1
1
  import { PayloadRequest } from "payload";
2
2
 
3
3
  //#region src/widgets/prepareWidgetRead.d.ts
4
- type WidgetReadStatus = 'ok' | 'not-configured' | 'unavailable' | 'filter-unsupported';
4
+ /**
5
+ * `unavailable` is a source that cannot serve the read at all, `busy` one that failed for now
6
+ * (a retry can fix it), `invalid` a read refused as asked, `range-too-long` over the query cap.
7
+ */
8
+ type WidgetReadStatus = 'ok' | 'not-configured' | 'unavailable' | 'busy' | 'invalid' | 'range-too-long' | 'filter-unsupported' | 'no-access' | 'no-scope' | 'misconfigured' | 'host-refused';
9
+ /** What a read of a stored source (a widget's `dataSource`) may take. */
10
+ interface StoredSourceRead {
11
+ /**
12
+ * Read the scope's default when `adapterId` names a source this reader cannot read, saying so
13
+ * in `substitutedFrom`. For a stored choice only, never a source a caller just picked.
14
+ */
15
+ fallbackWhenUnreadable?: boolean;
16
+ }
17
+ /** What a read says when it did not read the source it was asked for. */
18
+ interface SubstitutedSource {
19
+ /** The source asked for, which this reader cannot read; the scope default answered instead. */
20
+ substitutedFrom?: string;
21
+ }
5
22
  //#endregion
6
- export { WidgetReadStatus };
23
+ export { StoredSourceRead, SubstitutedSource, WidgetReadStatus };
7
24
  //# sourceMappingURL=prepareWidgetRead.d.ts.map
@@ -1,24 +1,44 @@
1
- import { getRuntime, resolveTimezoneFor } from "../plugin/runtime.js";
2
- import { resolveTimeframe } from "../timeframe/presets.js";
3
- import { satisfiesCapabilities } from "../core/capabilities.js";
1
+ import { readPrincipalOf } from "../access/principal.js";
4
2
  import { supportsGranularity } from "../core/granularity.js";
3
+ import { getRuntime, resolveTimezoneFor } from "../plugin/runtime.js";
4
+ import { exceedsRangeCap } from "../query/limits.js";
5
5
  import { resolveReadContext } from "../core/scopedRead.js";
6
- import { goalSlugsFor } from "../plugin/goalHint.js";
6
+ import { resolveTimeframe } from "../timeframe/presets.js";
7
+ import { comparisonOf, filterOperatorsFor, satisfiesCapabilities, unsupportedFilter } from "../core/capabilities.js";
8
+ import { previousWindow, withinLookback } from "../timeframe/comparison.js";
9
+ import { readAsAsked, servedName } from "../core/metricAliases.js";
10
+ import { goalHintFor } from "../plugin/goalHint.js";
7
11
  //#region src/widgets/prepareWidgetRead.ts
8
12
  /**
9
- * Whether the serving source can apply every filter the read carries. Answered before the
10
- * query so a source that cannot filter says so rather than returning site-wide numbers a
11
- * reader would take for filtered ones.
13
+ * Whether the serving source can apply every filter, asked before the query so a source that
14
+ * cannot filter says so rather than returning site-wide numbers that pass for filtered ones.
15
+ */
16
+ const supportsFilters = (caps, filters) => !filters || unsupportedFilter(caps, filters) === void 0;
17
+ /** The substitution a prepared read made, spread into the helper's own result. */
18
+ const substitutionOf = (prepared) => prepared.substitutedFrom === void 0 ? {} : { substitutedFrom: prepared.substitutedFrom };
19
+ /** The engine read of a prepared source, each metric asked under the name the source serves. */
20
+ const engineRead = ({ runtime, adapter }, timeframe) => (query) => readAsAsked((served) => runtime.engine.read(adapter, served, { timeframe }), query, adapter.capabilities.metrics);
21
+ /**
22
+ * The `scope` a result names for a link to it, only on a read the caller scoped itself: a needless
23
+ * one refuses every reader without `access.crossScope`.
12
24
  */
13
- const supportsFilters = (caps, filters) => !filters || filters.length === 0 || satisfiesCapabilities(caps, {
14
- filters: filters.map((f) => f.dimension),
15
- filterOperators: filters.map((f) => f.operator)
16
- });
25
+ const pinnedScope = (args, queryScope) => args.scope === void 0 || queryScope === void 0 ? {} : { scope: queryScope };
17
26
  /**
18
- * The prologue every widget read shares: the runtime, the read's scope and adapter, the
19
- * reporting timezone, the window, and the gates a source has to pass before it is worth
20
- * querying. A refusal carries the status the widget renders and the window it would have
21
- * read, so a helper's own failure shape is one spread rather than five early returns.
27
+ * The previous window a read compares against: only when the install and the source both compare
28
+ * and the source still keeps data that far back.
29
+ */
30
+ const comparisonWindow = (read, now) => {
31
+ const { runtime, adapter, tz } = read;
32
+ if (!runtime.comparison || !comparisonOf(adapter.capabilities)) return;
33
+ const previous = previousWindow(read.dateRange, tz);
34
+ return previous && withinLookback(previous, adapter.capabilities.maxLookbackDays, {
35
+ tz,
36
+ now
37
+ }) ? previous : void 0;
38
+ };
39
+ /**
40
+ * Prologue every widget read shares: runtime, scope, adapter, timezone, window and capability
41
+ * gates. A refusal carries the widget's status and window, so a helper's failure is one spread.
22
42
  */
23
43
  const prepareWidgetRead = async (args) => {
24
44
  const { req, now } = args;
@@ -28,15 +48,19 @@ const prepareWidgetRead = async (args) => {
28
48
  runtime,
29
49
  req,
30
50
  adapterId: args.adapterId,
31
- scope: args.scope
51
+ ...readPrincipalOf(args),
52
+ ...args.fallbackWhenUnreadable ? { fallbackWhenUnreadable: true } : {}
32
53
  }) : { ok: false };
33
- if (!runtime || !ctx.ok) return {
34
- ok: false,
35
- status: "unavailable",
36
- adapterId: args.adapterId ?? "",
37
- dateRange: windowIn(args.timezone),
38
- tz: args.timezone ?? "UTC"
39
- };
54
+ if (!runtime || !ctx.ok) {
55
+ const reason = ctx.ok ? void 0 : ctx.reason;
56
+ return {
57
+ ok: false,
58
+ status: reason === "no-access" || reason === "not-member" ? "no-access" : reason === "no-scope" ? "no-scope" : "unavailable",
59
+ adapterId: args.adapterId ?? "",
60
+ dateRange: windowIn(args.timezone),
61
+ tz: args.timezone ?? "UTC"
62
+ };
63
+ }
40
64
  const tz = args.timezone ?? await resolveTimezoneFor(runtime, req, ctx.scope);
41
65
  const dateRange = windowIn(tz);
42
66
  const adapter = ctx.adapter;
@@ -48,15 +72,23 @@ const prepareWidgetRead = async (args) => {
48
72
  tz
49
73
  });
50
74
  if (!adapter.isConfigured()) return refuse("not-configured");
51
- if (args.requires && !satisfiesCapabilities(adapter.capabilities, args.requires)) return refuse("unavailable");
75
+ if (args.range && exceedsRangeCap(args.range)) return refuse("range-too-long");
76
+ const filteredBy = (args.filters ?? []).map((filter) => filter.dimension).filter((dimension) => filterOperatorsFor(adapter.capabilities, dimension).length > 0);
77
+ const metrics = args.requires?.metrics?.map((m) => servedName(m, adapter.capabilities.metrics));
78
+ if (args.requires && !satisfiesCapabilities(adapter.capabilities, {
79
+ ...args.requires,
80
+ ...metrics ? { metrics } : {},
81
+ filters: [...args.requires.filters ?? [], ...filteredBy]
82
+ })) return refuse("unavailable");
52
83
  if (args.granularity && !supportsGranularity(adapter.capabilities, args.granularity)) return refuse("unavailable");
53
84
  if (!supportsFilters(adapter.capabilities, args.filters)) return refuse("filter-unsupported");
54
- const goalSlugs = args.goalSlugs ?? (args.goalRead ? await goalSlugsFor({
85
+ const resolved = args.goalSlugs === void 0 && args.goalRead ? await goalHintFor({
55
86
  runtime,
56
87
  req,
57
88
  scope: ctx.scope,
58
89
  ...args.goalRead(adapter)
59
- }) : void 0);
90
+ }) : void 0;
91
+ const goalSlugs = args.goalSlugs ?? resolved?.slugs;
60
92
  return {
61
93
  ok: true,
62
94
  runtime,
@@ -64,11 +96,15 @@ const prepareWidgetRead = async (args) => {
64
96
  tz,
65
97
  dateRange,
66
98
  scope: ctx.scope,
99
+ pin: ctx.pin,
100
+ builtinGoalSlugs: args.builtinGoalSlugs ?? resolved?.builtin ?? [],
101
+ goalNames: resolved?.names ?? [],
102
+ ...substitutionOf(ctx),
67
103
  ...ctx.queryScope === void 0 ? {} : { queryScope: ctx.queryScope },
68
104
  ...goalSlugs === void 0 ? {} : { goalSlugs }
69
105
  };
70
106
  };
71
107
  //#endregion
72
- export { prepareWidgetRead };
108
+ export { comparisonWindow, engineRead, pinnedScope, prepareWidgetRead, substitutionOf };
73
109
 
74
110
  //# sourceMappingURL=prepareWidgetRead.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"prepareWidgetRead.js","names":[],"sources":["../../src/widgets/prepareWidgetRead.ts"],"sourcesContent":["import type { PayloadRequest } from 'payload'\nimport { type CapabilityRequirement, satisfiesCapabilities } from '../core/capabilities'\nimport type {\n\tAnalyticsAdapter,\n\tAnalyticsCapabilities,\n\tAnalyticsFilter,\n\tDateRange,\n\tGranularity,\n} from '../core/contract'\nimport { supportsGranularity } from '../core/granularity'\nimport { resolveReadContext } from '../core/scopedRead'\nimport { type GoalRead, goalSlugsFor } from '../plugin/goalHint'\nimport { type AnalyticsRuntime, getRuntime, resolveTimezoneFor } from '../plugin/runtime'\nimport { resolveTimeframe, type TimeframePreset } from '../timeframe/presets'\nimport { DEFAULT_TIMEZONE } from '../timeframe/tz'\n\nexport type WidgetReadStatus = 'ok' | 'not-configured' | 'unavailable' | 'filter-unsupported'\n\n/**\n * Whether the serving source can apply every filter the read carries. Answered before the\n * query so a source that cannot filter says so rather than returning site-wide numbers a\n * reader would take for filtered ones.\n */\nexport const supportsFilters = (\n\tcaps: AnalyticsCapabilities,\n\tfilters?: AnalyticsFilter[]\n): boolean =>\n\t!filters ||\n\tfilters.length === 0 ||\n\tsatisfiesCapabilities(caps, {\n\t\tfilters: filters.map((f) => f.dimension),\n\t\tfilterOperators: filters.map((f) => f.operator),\n\t})\n\ninterface PrepareWidgetReadBase {\n\treq: PayloadRequest\n\tnow: Date\n\tadapterId?: string\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\tfilters?: AnalyticsFilter[]\n\t/** What the source must serve for the read to be worth making. */\n\trequires?: CapabilityRequirement\n\t/** The finest bucket the read needs, gated against the source's `minGranularity`. */\n\tgranularity?: Granularity\n\t/**\n\t * The read the goal hint is resolved for, answered once the adapter is known so a caller\n\t * that narrows its metrics against the source hints on the list it will actually ask for.\n\t * Omitted asks about no goals.\n\t */\n\tgoalRead?: (adapter: AnalyticsAdapter) => GoalRead\n\t/** A hint the caller already resolved, which wins over `goalRead`. */\n\tgoalSlugs?: string[] | 'unresolved'\n}\n\n/** Either a preset to resolve the window from or the window itself. */\nexport type PrepareWidgetReadArgs = PrepareWidgetReadBase &\n\t({ timeframe: TimeframePreset; range?: DateRange } | { timeframe?: undefined; range: DateRange })\n\nexport type PreparedWidgetRead =\n\t| {\n\t\t\tok: true\n\t\t\truntime: AnalyticsRuntime\n\t\t\tadapter: AnalyticsAdapter\n\t\t\t/** Reporting timezone the window was resolved in. */\n\t\t\ttz: string\n\t\t\tdateRange: DateRange\n\t\t\t/** The read's own scope, which sub-reads pin so all of them answer about one thing. */\n\t\t\tscope: string | null\n\t\t\t/** The scope to stamp on the adapter query; undefined for install-wide reads. */\n\t\t\tqueryScope?: string\n\t\t\t/** The scope's goal slugs, `'unresolved'`, or absent for a read about no goals. */\n\t\t\tgoalSlugs?: string[] | 'unresolved'\n\t }\n\t| {\n\t\t\tok: false\n\t\t\tstatus: WidgetReadStatus\n\t\t\tadapterId: string\n\t\t\tdateRange: DateRange\n\t\t\t/** The timezone the window was read in: the resolved one, or the caller's own, or UTC. */\n\t\t\ttz: string\n\t }\n\n/**\n * The prologue every widget read shares: the runtime, the read's scope and adapter, the\n * reporting timezone, the window, and the gates a source has to pass before it is worth\n * querying. A refusal carries the status the widget renders and the window it would have\n * read, so a helper's own failure shape is one spread rather than five early returns.\n */\nexport const prepareWidgetRead = async (\n\targs: PrepareWidgetReadArgs\n): Promise<PreparedWidgetRead> => {\n\tconst { req, now } = args\n\tconst windowIn = (zone?: string): DateRange =>\n\t\targs.timeframe === undefined\n\t\t\t? args.range\n\t\t\t: (args.range ?? resolveTimeframe(args.timeframe, now, zone))\n\n\tconst runtime = getRuntime(req.payload)\n\tconst ctx = runtime\n\t\t? await resolveReadContext({ runtime, req, adapterId: args.adapterId, scope: args.scope })\n\t\t: { ok: false as const }\n\tif (!runtime || !ctx.ok) {\n\t\treturn {\n\t\t\tok: false,\n\t\t\tstatus: 'unavailable',\n\t\t\tadapterId: args.adapterId ?? '',\n\t\t\tdateRange: windowIn(args.timezone),\n\t\t\ttz: args.timezone ?? DEFAULT_TIMEZONE,\n\t\t}\n\t}\n\n\tconst tz = args.timezone ?? (await resolveTimezoneFor(runtime, req, ctx.scope))\n\tconst dateRange = windowIn(tz)\n\tconst adapter = ctx.adapter\n\tconst refuse = (status: WidgetReadStatus): PreparedWidgetRead => ({\n\t\tok: false,\n\t\tstatus,\n\t\tadapterId: adapter.id,\n\t\tdateRange,\n\t\ttz,\n\t})\n\tif (!adapter.isConfigured()) {\n\t\treturn refuse('not-configured')\n\t}\n\tif (args.requires && !satisfiesCapabilities(adapter.capabilities, args.requires)) {\n\t\treturn refuse('unavailable')\n\t}\n\tif (args.granularity && !supportsGranularity(adapter.capabilities, args.granularity)) {\n\t\treturn refuse('unavailable')\n\t}\n\tif (!supportsFilters(adapter.capabilities, args.filters)) {\n\t\treturn refuse('filter-unsupported')\n\t}\n\n\tconst goalSlugs =\n\t\targs.goalSlugs ??\n\t\t(args.goalRead\n\t\t\t? await goalSlugsFor({ runtime, req, scope: ctx.scope, ...args.goalRead(adapter) })\n\t\t\t: undefined)\n\treturn {\n\t\tok: true,\n\t\truntime,\n\t\tadapter,\n\t\ttz,\n\t\tdateRange,\n\t\tscope: ctx.scope,\n\t\t...(ctx.queryScope === undefined ? {} : { queryScope: ctx.queryScope }),\n\t\t...(goalSlugs === undefined ? {} : { goalSlugs }),\n\t}\n}\n"],"mappings":";;;;;;;;;;;;AAuBA,MAAa,mBACZ,MACA,YAEA,CAAC,WACD,QAAQ,WAAW,KACnB,sBAAsB,MAAM;CAC3B,SAAS,QAAQ,KAAK,MAAM,EAAE,SAAS;CACvC,iBAAiB,QAAQ,KAAK,MAAM,EAAE,QAAQ;AAC/C,CAAC;;;;;;;AA8DF,MAAa,oBAAoB,OAChC,SACiC;CACjC,MAAM,EAAE,KAAK,QAAQ;CACrB,MAAM,YAAY,SACjB,KAAK,cAAc,KAAA,IAChB,KAAK,QACJ,KAAK,SAAS,iBAAiB,KAAK,WAAW,KAAK,IAAI;CAE7D,MAAM,UAAU,WAAW,IAAI,OAAO;CACtC,MAAM,MAAM,UACT,MAAM,mBAAmB;EAAE;EAAS;EAAK,WAAW,KAAK;EAAW,OAAO,KAAK;CAAM,CAAC,IACvF,EAAE,IAAI,MAAe;CACxB,IAAI,CAAC,WAAW,CAAC,IAAI,IACpB,OAAO;EACN,IAAI;EACJ,QAAQ;EACR,WAAW,KAAK,aAAa;EAC7B,WAAW,SAAS,KAAK,QAAQ;EACjC,IAAI,KAAK,YAAA;CACV;CAGD,MAAM,KAAK,KAAK,YAAa,MAAM,mBAAmB,SAAS,KAAK,IAAI,KAAK;CAC7E,MAAM,YAAY,SAAS,EAAE;CAC7B,MAAM,UAAU,IAAI;CACpB,MAAM,UAAU,YAAkD;EACjE,IAAI;EACJ;EACA,WAAW,QAAQ;EACnB;EACA;CACD;CACA,IAAI,CAAC,QAAQ,aAAa,GACzB,OAAO,OAAO,gBAAgB;CAE/B,IAAI,KAAK,YAAY,CAAC,sBAAsB,QAAQ,cAAc,KAAK,QAAQ,GAC9E,OAAO,OAAO,aAAa;CAE5B,IAAI,KAAK,eAAe,CAAC,oBAAoB,QAAQ,cAAc,KAAK,WAAW,GAClF,OAAO,OAAO,aAAa;CAE5B,IAAI,CAAC,gBAAgB,QAAQ,cAAc,KAAK,OAAO,GACtD,OAAO,OAAO,oBAAoB;CAGnC,MAAM,YACL,KAAK,cACJ,KAAK,WACH,MAAM,aAAa;EAAE;EAAS;EAAK,OAAO,IAAI;EAAO,GAAG,KAAK,SAAS,OAAO;CAAE,CAAC,IAChF,KAAA;CACJ,OAAO;EACN,IAAI;EACJ;EACA;EACA;EACA;EACA,OAAO,IAAI;EACX,GAAI,IAAI,eAAe,KAAA,IAAY,CAAC,IAAI,EAAE,YAAY,IAAI,WAAW;EACrE,GAAI,cAAc,KAAA,IAAY,CAAC,IAAI,EAAE,UAAU;CAChD;AACD"}
1
+ {"version":3,"file":"prepareWidgetRead.js","names":[],"sources":["../../src/widgets/prepareWidgetRead.ts"],"sourcesContent":["import type { PayloadRequest } from 'payload'\nimport { type ReadPrincipal, readPrincipalOf } from '../access/principal'\nimport {\n\ttype CapabilityRequirement,\n\tcomparisonOf,\n\tfilterOperatorsFor,\n\tsatisfiesCapabilities,\n\tunsupportedFilter,\n} from '../core/capabilities'\nimport type {\n\tAnalyticsAdapter,\n\tAnalyticsCapabilities,\n\tAnalyticsFilter,\n\tAnalyticsQuery,\n\tAnalyticsResult,\n\tDateRange,\n\tGranularity,\n} from '../core/contract'\nimport { supportsGranularity } from '../core/granularity'\nimport { readAsAsked, servedName } from '../core/metricAliases'\nimport { resolveReadContext } from '../core/scopedRead'\nimport { type GoalRead, goalHintFor } from '../plugin/goalHint'\nimport { type AnalyticsRuntime, getRuntime, resolveTimezoneFor } from '../plugin/runtime'\nimport { exceedsRangeCap } from '../query/limits'\nimport { previousWindow, withinLookback } from '../timeframe/comparison'\nimport { resolveTimeframe, type TimeframePreset } from '../timeframe/presets'\nimport { DEFAULT_TIMEZONE } from '../timeframe/tz'\n\n/**\n * `unavailable` is a source that cannot serve the read at all, `busy` one that failed for now\n * (a retry can fix it), `invalid` a read refused as asked, `range-too-long` over the query cap.\n */\nexport type WidgetReadStatus =\n\t| 'ok'\n\t| 'not-configured'\n\t| 'unavailable'\n\t| 'busy'\n\t| 'invalid'\n\t| 'range-too-long'\n\t| 'filter-unsupported'\n\t| 'no-access'\n\t| 'no-scope'\n\t| 'misconfigured'\n\t| 'host-refused'\n\n/**\n * Whether the serving source can apply every filter, asked before the query so a source that\n * cannot filter says so rather than returning site-wide numbers that pass for filtered ones.\n */\nconst supportsFilters = (caps: AnalyticsCapabilities, filters?: AnalyticsFilter[]): boolean =>\n\t!filters || unsupportedFilter(caps, filters) === undefined\n\n/** What a read of a stored source (a widget's `dataSource`) may take. */\nexport interface StoredSourceRead {\n\t/**\n\t * Read the scope's default when `adapterId` names a source this reader cannot read, saying so\n\t * in `substitutedFrom`. For a stored choice only, never a source a caller just picked.\n\t */\n\tfallbackWhenUnreadable?: boolean\n}\n\n/** What a read says when it did not read the source it was asked for. */\nexport interface SubstitutedSource {\n\t/** The source asked for, which this reader cannot read; the scope default answered instead. */\n\tsubstitutedFrom?: string\n}\n\n/** The substitution a prepared read made, spread into the helper's own result. */\nexport const substitutionOf = (prepared: SubstitutedSource): SubstitutedSource =>\n\tprepared.substitutedFrom === undefined ? {} : { substitutedFrom: prepared.substitutedFrom }\n\ninterface PrepareWidgetReadBase extends StoredSourceRead {\n\treq: PayloadRequest\n\tnow: Date\n\tadapterId?: string\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\tfilters?: AnalyticsFilter[]\n\t/** What the source must serve for the read to be worth making. */\n\trequires?: CapabilityRequirement\n\t/** The finest bucket the read needs, gated against the source's `minGranularity`. */\n\tgranularity?: Granularity\n\t/**\n\t * Goal hint read, resolved once the adapter is known so a caller narrowing metrics against the\n\t * source hints on the list it will ask for. Omitted asks about no goals.\n\t */\n\tgoalRead?: (adapter: AnalyticsAdapter) => GoalRead\n\t/** A hint the caller already resolved, which wins over `goalRead`. */\n\tgoalSlugs?: string[] | 'unresolved'\n\t/** The latent built-in slugs behind that hint; read together with `goalSlugs`. */\n\tbuiltinGoalSlugs?: string[]\n}\n\n/**\n * A preset or the window itself. Without `scope` the read is the request's own; a `scope` must\n * be already cleared for this request, or be a job's own with `principal: SYSTEM`.\n */\nexport type PrepareWidgetReadArgs = PrepareWidgetReadBase &\n\tReadPrincipal &\n\t({ timeframe: TimeframePreset; range?: DateRange } | { timeframe?: undefined; range: DateRange })\n\nexport type PreparedWidgetRead =\n\t| ({\n\t\t\tok: true\n\t\t\truntime: AnalyticsRuntime\n\t\t\tadapter: AnalyticsAdapter\n\t\t\t/** Reporting timezone the window was resolved in. */\n\t\t\ttz: string\n\t\t\tdateRange: DateRange\n\t\t\t/** The read's own scope, null for install-wide and aggregate reads. */\n\t\t\tscope: string | null\n\t\t\t/** Principal and scope that sub-reads pin so all of them answer about one thing. */\n\t\t\tpin: ReadPrincipal\n\t\t\t/** The scope to stamp on the adapter query; undefined for install-wide reads. */\n\t\t\tqueryScope?: string\n\t\t\t/** The scope's goal slugs, `'unresolved'`, or absent for a read about no goals. */\n\t\t\tgoalSlugs?: string[] | 'unresolved'\n\t\t\t/**\n\t\t\t * Slugs among them the install never declared: the latent built-in goal. A report\n\t\t\t * lists one only once it has conversions, and never counts it as having goals.\n\t\t\t */\n\t\t\tbuiltinGoalSlugs: string[]\n\t\t\t/** The resolved goals' names, when this read resolved the goals itself. */\n\t\t\tgoalNames: Array<{ slug: string; name: string }>\n\t } & SubstitutedSource)\n\t| {\n\t\t\tok: false\n\t\t\tstatus: WidgetReadStatus\n\t\t\tadapterId: string\n\t\t\tdateRange: DateRange\n\t\t\t/** The timezone the window was read in: the resolved one, or the caller's own, or UTC. */\n\t\t\ttz: string\n\t }\n\ntype PreparedSource = Pick<\n\tExtract<PreparedWidgetRead, { ok: true }>,\n\t'runtime' | 'adapter' | 'tz' | 'dateRange'\n>\n\n/** The engine read of a prepared source, each metric asked under the name the source serves. */\nexport const engineRead =\n\t({ runtime, adapter }: Pick<PreparedSource, 'runtime' | 'adapter'>, timeframe: TimeframePreset) =>\n\t(query: AnalyticsQuery): Promise<AnalyticsResult> =>\n\t\treadAsAsked(\n\t\t\t(served) => runtime.engine.read(adapter, served, { timeframe }),\n\t\t\tquery,\n\t\t\tadapter.capabilities.metrics\n\t\t)\n\n/**\n * The `scope` a result names for a link to it, only on a read the caller scoped itself: a needless\n * one refuses every reader without `access.crossScope`.\n */\nexport const pinnedScope = (\n\targs: ReadPrincipal,\n\tqueryScope: string | undefined\n): { scope?: string } =>\n\targs.scope === undefined || queryScope === undefined ? {} : { scope: queryScope }\n\n/**\n * The previous window a read compares against: only when the install and the source both compare\n * and the source still keeps data that far back.\n */\nexport const comparisonWindow = (read: PreparedSource, now: Date): DateRange | undefined => {\n\tconst { runtime, adapter, tz } = read\n\tif (!runtime.comparison || !comparisonOf(adapter.capabilities)) {\n\t\treturn undefined\n\t}\n\tconst previous = previousWindow(read.dateRange, tz)\n\treturn previous && withinLookback(previous, adapter.capabilities.maxLookbackDays, { tz, now })\n\t\t? previous\n\t\t: undefined\n}\n\n/**\n * Prologue every widget read shares: runtime, scope, adapter, timezone, window and capability\n * gates. A refusal carries the widget's status and window, so a helper's failure is one spread.\n */\nexport const prepareWidgetRead = async (\n\targs: PrepareWidgetReadArgs\n): Promise<PreparedWidgetRead> => {\n\tconst { req, now } = args\n\tconst windowIn = (zone?: string): DateRange =>\n\t\targs.timeframe === undefined\n\t\t\t? args.range\n\t\t\t: (args.range ?? resolveTimeframe(args.timeframe, now, zone))\n\n\tconst runtime = getRuntime(req.payload)\n\tconst ctx = runtime\n\t\t? await resolveReadContext({\n\t\t\t\truntime,\n\t\t\t\treq,\n\t\t\t\tadapterId: args.adapterId,\n\t\t\t\t...readPrincipalOf(args),\n\t\t\t\t...(args.fallbackWhenUnreadable ? { fallbackWhenUnreadable: true } : {}),\n\t\t\t})\n\t\t: { ok: false as const }\n\tif (!runtime || !ctx.ok) {\n\t\tconst reason = ctx.ok ? undefined : ctx.reason\n\t\tconst status: WidgetReadStatus =\n\t\t\treason === 'no-access' || reason === 'not-member'\n\t\t\t\t? 'no-access'\n\t\t\t\t: reason === 'no-scope'\n\t\t\t\t\t? 'no-scope'\n\t\t\t\t\t: 'unavailable'\n\t\treturn {\n\t\t\tok: false,\n\t\t\tstatus,\n\t\t\tadapterId: args.adapterId ?? '',\n\t\t\tdateRange: windowIn(args.timezone),\n\t\t\ttz: args.timezone ?? DEFAULT_TIMEZONE,\n\t\t}\n\t}\n\n\tconst tz = args.timezone ?? (await resolveTimezoneFor(runtime, req, ctx.scope))\n\tconst dateRange = windowIn(tz)\n\tconst adapter = ctx.adapter\n\tconst refuse = (status: WidgetReadStatus): PreparedWidgetRead => ({\n\t\tok: false,\n\t\tstatus,\n\t\tadapterId: adapter.id,\n\t\tdateRange,\n\t\ttz,\n\t})\n\tif (!adapter.isConfigured()) {\n\t\treturn refuse('not-configured')\n\t}\n\tif (args.range && exceedsRangeCap(args.range)) {\n\t\treturn refuse('range-too-long')\n\t}\n\t// The widget's own filters count toward where its metric reads (a page filter for a metric\n\t// read only per page); one the source cannot apply at all is the filter check's to report.\n\tconst filteredBy = (args.filters ?? [])\n\t\t.map((filter) => filter.dimension)\n\t\t.filter((dimension) => filterOperatorsFor(adapter.capabilities, dimension).length > 0)\n\t// A metric served under another name (`visits` as `sessions`) is read under that one.\n\tconst metrics = args.requires?.metrics?.map((m) => servedName(m, adapter.capabilities.metrics))\n\tif (\n\t\targs.requires &&\n\t\t!satisfiesCapabilities(adapter.capabilities, {\n\t\t\t...args.requires,\n\t\t\t...(metrics ? { metrics } : {}),\n\t\t\tfilters: [...(args.requires.filters ?? []), ...filteredBy],\n\t\t})\n\t) {\n\t\treturn refuse('unavailable')\n\t}\n\tif (args.granularity && !supportsGranularity(adapter.capabilities, args.granularity)) {\n\t\treturn refuse('unavailable')\n\t}\n\tif (!supportsFilters(adapter.capabilities, args.filters)) {\n\t\treturn refuse('filter-unsupported')\n\t}\n\n\tconst resolved =\n\t\targs.goalSlugs === undefined && args.goalRead\n\t\t\t? await goalHintFor({ runtime, req, scope: ctx.scope, ...args.goalRead(adapter) })\n\t\t\t: undefined\n\tconst goalSlugs = args.goalSlugs ?? resolved?.slugs\n\treturn {\n\t\tok: true,\n\t\truntime,\n\t\tadapter,\n\t\ttz,\n\t\tdateRange,\n\t\tscope: ctx.scope,\n\t\tpin: ctx.pin,\n\t\tbuiltinGoalSlugs: args.builtinGoalSlugs ?? resolved?.builtin ?? [],\n\t\tgoalNames: resolved?.names ?? [],\n\t\t...substitutionOf(ctx),\n\t\t...(ctx.queryScope === undefined ? {} : { queryScope: ctx.queryScope }),\n\t\t...(goalSlugs === undefined ? {} : { goalSlugs }),\n\t}\n}\n"],"mappings":";;;;;;;;;;;;;;;AAiDA,MAAM,mBAAmB,MAA6B,YACrD,CAAC,WAAW,kBAAkB,MAAM,OAAO,MAAM,KAAA;;AAkBlD,MAAa,kBAAkB,aAC9B,SAAS,oBAAoB,KAAA,IAAY,CAAC,IAAI,EAAE,iBAAiB,SAAS,gBAAgB;;AA0E3F,MAAa,cACX,EAAE,SAAS,WAAwD,eACnE,UACA,aACE,WAAW,QAAQ,OAAO,KAAK,SAAS,QAAQ,EAAE,UAAU,CAAC,GAC9D,OACA,QAAQ,aAAa,OACtB;;;;;AAMF,MAAa,eACZ,MACA,eAEA,KAAK,UAAU,KAAA,KAAa,eAAe,KAAA,IAAY,CAAC,IAAI,EAAE,OAAO,WAAW;;;;;AAMjF,MAAa,oBAAoB,MAAsB,QAAqC;CAC3F,MAAM,EAAE,SAAS,SAAS,OAAO;CACjC,IAAI,CAAC,QAAQ,cAAc,CAAC,aAAa,QAAQ,YAAY,GAC5D;CAED,MAAM,WAAW,eAAe,KAAK,WAAW,EAAE;CAClD,OAAO,YAAY,eAAe,UAAU,QAAQ,aAAa,iBAAiB;EAAE;EAAI;CAAI,CAAC,IAC1F,WACA,KAAA;AACJ;;;;;AAMA,MAAa,oBAAoB,OAChC,SACiC;CACjC,MAAM,EAAE,KAAK,QAAQ;CACrB,MAAM,YAAY,SACjB,KAAK,cAAc,KAAA,IAChB,KAAK,QACJ,KAAK,SAAS,iBAAiB,KAAK,WAAW,KAAK,IAAI;CAE7D,MAAM,UAAU,WAAW,IAAI,OAAO;CACtC,MAAM,MAAM,UACT,MAAM,mBAAmB;EACzB;EACA;EACA,WAAW,KAAK;EAChB,GAAG,gBAAgB,IAAI;EACvB,GAAI,KAAK,yBAAyB,EAAE,wBAAwB,KAAK,IAAI,CAAC;CACvE,CAAC,IACA,EAAE,IAAI,MAAe;CACxB,IAAI,CAAC,WAAW,CAAC,IAAI,IAAI;EACxB,MAAM,SAAS,IAAI,KAAK,KAAA,IAAY,IAAI;EAOxC,OAAO;GACN,IAAI;GACJ,QAPA,WAAW,eAAe,WAAW,eAClC,cACA,WAAW,aACV,aACA;GAIJ,WAAW,KAAK,aAAa;GAC7B,WAAW,SAAS,KAAK,QAAQ;GACjC,IAAI,KAAK,YAAA;EACV;CACD;CAEA,MAAM,KAAK,KAAK,YAAa,MAAM,mBAAmB,SAAS,KAAK,IAAI,KAAK;CAC7E,MAAM,YAAY,SAAS,EAAE;CAC7B,MAAM,UAAU,IAAI;CACpB,MAAM,UAAU,YAAkD;EACjE,IAAI;EACJ;EACA,WAAW,QAAQ;EACnB;EACA;CACD;CACA,IAAI,CAAC,QAAQ,aAAa,GACzB,OAAO,OAAO,gBAAgB;CAE/B,IAAI,KAAK,SAAS,gBAAgB,KAAK,KAAK,GAC3C,OAAO,OAAO,gBAAgB;CAI/B,MAAM,cAAc,KAAK,WAAW,CAAC,GACnC,KAAK,WAAW,OAAO,SAAS,EAChC,QAAQ,cAAc,mBAAmB,QAAQ,cAAc,SAAS,EAAE,SAAS,CAAC;CAEtF,MAAM,UAAU,KAAK,UAAU,SAAS,KAAK,MAAM,WAAW,GAAG,QAAQ,aAAa,OAAO,CAAC;CAC9F,IACC,KAAK,YACL,CAAC,sBAAsB,QAAQ,cAAc;EAC5C,GAAG,KAAK;EACR,GAAI,UAAU,EAAE,QAAQ,IAAI,CAAC;EAC7B,SAAS,CAAC,GAAI,KAAK,SAAS,WAAW,CAAC,GAAI,GAAG,UAAU;CAC1D,CAAC,GAED,OAAO,OAAO,aAAa;CAE5B,IAAI,KAAK,eAAe,CAAC,oBAAoB,QAAQ,cAAc,KAAK,WAAW,GAClF,OAAO,OAAO,aAAa;CAE5B,IAAI,CAAC,gBAAgB,QAAQ,cAAc,KAAK,OAAO,GACtD,OAAO,OAAO,oBAAoB;CAGnC,MAAM,WACL,KAAK,cAAc,KAAA,KAAa,KAAK,WAClC,MAAM,YAAY;EAAE;EAAS;EAAK,OAAO,IAAI;EAAO,GAAG,KAAK,SAAS,OAAO;CAAE,CAAC,IAC/E,KAAA;CACJ,MAAM,YAAY,KAAK,aAAa,UAAU;CAC9C,OAAO;EACN,IAAI;EACJ;EACA;EACA;EACA;EACA,OAAO,IAAI;EACX,KAAK,IAAI;EACT,kBAAkB,KAAK,oBAAoB,UAAU,WAAW,CAAC;EACjE,WAAW,UAAU,SAAS,CAAC;EAC/B,GAAG,eAAe,GAAG;EACrB,GAAI,IAAI,eAAe,KAAA,IAAY,CAAC,IAAI,EAAE,YAAY,IAAI,WAAW;EACrE,GAAI,cAAc,KAAA,IAAY,CAAC,IAAI,EAAE,UAAU;CAChD;AACD"}
@@ -1,13 +1,11 @@
1
1
  import { zonedCalendarDay } from "../timeframe/tz.js";
2
+ import { dateTimeFormat } from "../translations/intl.js";
2
3
  import { DATE_ONLY, parseDayOrInstant } from "../query/dates.js";
3
4
  //#region src/widgets/range.ts
4
5
  const NOON_MS = 12 * 36e5;
5
6
  /**
6
- * The calendar day a stored bound names. The `dayOnly` picker stores the picked day at the
7
- * admin browser's local midnight, so the instant lands on that day or the one before it in
8
- * UTC depending on the browser's offset; a 12-hour shift recovers the picked day for every
9
- * offset in (-12, +12]. Zones at +12:45 and beyond (Chatham in DST, Kiritimati) recover the
10
- * day before, and the uninhabited UTC-12 the day after.
7
+ * Calendar day a stored bound names. The `dayOnly` picker stores the browser's local midnight,
8
+ * so a 12-hour shift recovers the picked day for every offset in (-12, +12].
11
9
  */
12
10
  const pickedDay = (raw) => {
13
11
  if (DATE_ONLY.test(raw)) return raw;
@@ -16,11 +14,8 @@ const pickedDay = (raw) => {
16
14
  return zonedCalendarDay(new Date(instant.getTime() + NOON_MS), "UTC");
17
15
  };
18
16
  /**
19
- * Resolve a widget's explicit custom range to a concrete DateRange, or undefined when the
20
- * widget is on a relative preset, the custom range is incomplete, or either bound names no
21
- * real day (a corrupt or hand-set widgetData would otherwise reach the cache key and throw
22
- * on `toISOString`). The two picked days are read inclusively in `timezone`, the reporting
23
- * timezone the read resolves in: `from` at the first instant of its day, `to` at the last.
17
+ * A widget's custom range, inclusive in `timezone`; undefined on a preset, when incomplete, or
18
+ * when a bound names no real day (corrupt widgetData would otherwise throw in the cache key).
24
19
  */
25
20
  const resolveCustomRange = (timeframe, range, timezone) => {
26
21
  if (timeframe !== "custom" || !range?.from || !range?.to) return;
@@ -41,19 +36,29 @@ const resolveCustomRange = (timeframe, range, timezone) => {
41
36
  end
42
37
  };
43
38
  };
44
- const formatDay = (d, locale, timeZone) => d.toLocaleDateString(locale, {
45
- month: "short",
46
- day: "numeric",
47
- year: "numeric",
48
- timeZone
49
- });
50
39
  /**
51
- * Server-side caption for a custom range, e.g. "Jun 1, 2026 - Jun 23, 2026". Both bounds
52
- * render in the reporting timezone, so the caption names the days that were read rather
53
- * than the days the server's own zone would spell them as.
40
+ * Whether a custom range sets both bounds yet one names no real day or a day before 1970: the
41
+ * widget says the read is invalid rather than reading the last 30 days in its place.
54
42
  */
55
- const formatRangeCaption = (range, locale, timezone) => `${formatDay(range.start, locale, timezone)} - ${formatDay(range.end, locale, timezone)}`;
43
+ const isUnreadableCustomRange = (timeframe, range) => timeframe === "custom" && Boolean(range?.from && range?.to) && resolveCustomRange(timeframe, range, "UTC") === void 0;
44
+ /**
45
+ * Caption for a range as the language writes a span of days ("Jun 1 to 23, 2026"), in the
46
+ * reporting timezone so it names the days that were read, not the server zone's.
47
+ */
48
+ const formatRangeCaption = (range, locale, timezone) => {
49
+ const format = dateTimeFormat(locale, {
50
+ month: "short",
51
+ day: "numeric",
52
+ year: "numeric",
53
+ timeZone: timezone
54
+ });
55
+ try {
56
+ return format.formatRange(range.start, range.end).replace(/[\u2009\u202f]/g, " ");
57
+ } catch {
58
+ return `${format.format(range.start)} - ${format.format(range.end)}`;
59
+ }
60
+ };
56
61
  //#endregion
57
- export { formatRangeCaption, resolveCustomRange };
62
+ export { formatRangeCaption, isUnreadableCustomRange, pickedDay, resolveCustomRange };
58
63
 
59
64
  //# sourceMappingURL=range.js.map