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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (1242) hide show
  1. package/CHANGELOG.md +470 -0
  2. package/LICENSE +21 -21
  3. package/README.md +30 -37
  4. package/dist/access/adminUser.d.ts +15 -0
  5. package/dist/access/adminUser.js +13 -0
  6. package/dist/access/adminUser.js.map +1 -0
  7. package/dist/access/decideOnce.js +16 -0
  8. package/dist/access/decideOnce.js.map +1 -0
  9. package/dist/access/membership.d.ts +23 -0
  10. package/dist/access/membership.js +63 -0
  11. package/dist/access/membership.js.map +1 -0
  12. package/dist/access/principal.d.ts +37 -0
  13. package/dist/access/principal.js +29 -0
  14. package/dist/access/principal.js.map +1 -0
  15. package/dist/access/readGate.js +16 -0
  16. package/dist/access/readGate.js.map +1 -0
  17. package/dist/adapters/ga4/disableKey.js +7 -9
  18. package/dist/adapters/ga4/disableKey.js.map +1 -1
  19. package/dist/adapters/ga4/eventName.d.ts +2 -8
  20. package/dist/adapters/ga4/eventName.js +2 -8
  21. package/dist/adapters/ga4/eventName.js.map +1 -1
  22. package/dist/adapters/ga4/ga4.d.ts +11 -0
  23. package/dist/adapters/ga4/ga4.js +206 -123
  24. package/dist/adapters/ga4/ga4.js.map +1 -1
  25. package/dist/adapters/ga4/measurementId.js +2 -3
  26. package/dist/adapters/ga4/measurementId.js.map +1 -1
  27. package/dist/adapters/goalRead.js +15 -29
  28. package/dist/adapters/goalRead.js.map +1 -1
  29. package/dist/adapters/http/baseUrl.js +15 -0
  30. package/dist/adapters/http/baseUrl.js.map +1 -0
  31. package/dist/adapters/http/fetchJson.d.ts +19 -0
  32. package/dist/adapters/http/fetchJson.js +27 -8
  33. package/dist/adapters/http/fetchJson.js.map +1 -1
  34. package/dist/adapters/mapping.js +52 -0
  35. package/dist/adapters/mapping.js.map +1 -0
  36. package/dist/adapters/plausible/plausible.d.ts +13 -13
  37. package/dist/adapters/plausible/plausible.js +137 -122
  38. package/dist/adapters/plausible/plausible.js.map +1 -1
  39. package/dist/adapters/plausible/scriptId.js +19 -0
  40. package/dist/adapters/plausible/scriptId.js.map +1 -0
  41. package/dist/adapters/posthog/posthog.d.ts +20 -9
  42. package/dist/adapters/posthog/posthog.js +179 -113
  43. package/dist/adapters/posthog/posthog.js.map +1 -1
  44. package/dist/adapters/readTime.js +7 -0
  45. package/dist/adapters/readTime.js.map +1 -0
  46. package/dist/adapters/series.js +14 -8
  47. package/dist/adapters/series.js.map +1 -1
  48. package/dist/adapters/umami/umami.d.ts +7 -9
  49. package/dist/adapters/umami/umami.js +184 -172
  50. package/dist/adapters/umami/umami.js.map +1 -1
  51. package/dist/adapters/upstream.js +16 -0
  52. package/dist/adapters/upstream.js.map +1 -0
  53. package/dist/binding/report.d.ts +8 -0
  54. package/dist/binding/report.js +24 -0
  55. package/dist/binding/report.js.map +1 -0
  56. package/dist/binding/resolvePath.js +16 -29
  57. package/dist/binding/resolvePath.js.map +1 -1
  58. package/dist/binding/types.d.ts +14 -29
  59. package/dist/capture/captureRequest.js +28 -0
  60. package/dist/capture/captureRequest.js.map +1 -0
  61. package/dist/capture/exclusionEndpoint.js +98 -0
  62. package/dist/capture/exclusionEndpoint.js.map +1 -0
  63. package/dist/capture/exclusionPrelude.js +14 -0
  64. package/dist/capture/exclusionPrelude.js.map +1 -0
  65. package/dist/capture/exclusionToken.js +23 -0
  66. package/dist/capture/exclusionToken.js.map +1 -0
  67. package/dist/capture/jsLiteral.js +19 -0
  68. package/dist/capture/jsLiteral.js.map +1 -0
  69. package/dist/capture/mountPath.js +2 -3
  70. package/dist/capture/mountPath.js.map +1 -1
  71. package/dist/capture/proxyEndpoint.js +48 -95
  72. package/dist/capture/proxyEndpoint.js.map +1 -1
  73. package/dist/capture/proxyRoutes.js +58 -21
  74. package/dist/capture/proxyRoutes.js.map +1 -1
  75. package/dist/capture/relay.js +91 -0
  76. package/dist/capture/relay.js.map +1 -0
  77. package/dist/capture/requestBody.js +2 -6
  78. package/dist/capture/requestBody.js.map +1 -1
  79. package/dist/capture/requestTrust.js +45 -0
  80. package/dist/capture/requestTrust.js.map +1 -0
  81. package/dist/capture/sameSite.js +40 -0
  82. package/dist/capture/sameSite.js.map +1 -0
  83. package/dist/capture/slots.js +50 -25
  84. package/dist/capture/slots.js.map +1 -1
  85. package/dist/capture/trackerConfig.js +100 -36
  86. package/dist/capture/trackerConfig.js.map +1 -1
  87. package/dist/capture/trackerEndpoint.js +22 -21
  88. package/dist/capture/trackerEndpoint.js.map +1 -1
  89. package/dist/charts/BarList.d.ts +27 -14
  90. package/dist/charts/BarList.js +38 -83
  91. package/dist/charts/BarList.js.map +1 -1
  92. package/dist/charts/TrendChart.d.ts +40 -7
  93. package/dist/charts/TrendChart.js +243 -215
  94. package/dist/charts/TrendChart.js.map +1 -1
  95. package/dist/charts/bars.d.ts +15 -1
  96. package/dist/charts/bars.js +12 -12
  97. package/dist/charts/bars.js.map +1 -1
  98. package/dist/charts/bucket.js +106 -73
  99. package/dist/charts/bucket.js.map +1 -1
  100. package/dist/charts/inProgress.js +22 -0
  101. package/dist/charts/inProgress.js.map +1 -0
  102. package/dist/charts/series.d.ts +15 -0
  103. package/dist/charts/series.js +123 -0
  104. package/dist/charts/series.js.map +1 -0
  105. package/dist/charts/spline.js +91 -25
  106. package/dist/charts/spline.js.map +1 -1
  107. package/dist/charts/trendGeometry.js +91 -0
  108. package/dist/charts/trendGeometry.js.map +1 -0
  109. package/dist/core/adminOptions.d.ts +1 -0
  110. package/dist/core/adminOptions.js +193 -0
  111. package/dist/core/adminOptions.js.map +1 -0
  112. package/dist/core/budget.js +24 -0
  113. package/dist/core/budget.js.map +1 -0
  114. package/dist/core/cacheKey.d.ts +1 -0
  115. package/dist/core/cacheKey.js +48 -37
  116. package/dist/core/cacheKey.js.map +1 -1
  117. package/dist/core/cacheOptions.js +165 -0
  118. package/dist/core/cacheOptions.js.map +1 -0
  119. package/dist/core/capabilities.d.ts +24 -11
  120. package/dist/core/capabilities.js +96 -17
  121. package/dist/core/capabilities.js.map +1 -1
  122. package/dist/core/capture.d.ts +26 -25
  123. package/dist/core/captureOptions.d.ts +1 -0
  124. package/dist/core/captureOptions.js +258 -0
  125. package/dist/core/captureOptions.js.map +1 -0
  126. package/dist/core/clock.js +13 -0
  127. package/dist/core/clock.js.map +1 -0
  128. package/dist/core/collectionOption.d.ts +17 -0
  129. package/dist/core/collectionOption.js +104 -0
  130. package/dist/core/collectionOption.js.map +1 -0
  131. package/dist/core/collectionSlug.js +7 -0
  132. package/dist/core/collectionSlug.js.map +1 -0
  133. package/dist/core/contract.d.ts +285 -59
  134. package/dist/core/contract.js +6 -4
  135. package/dist/core/contract.js.map +1 -1
  136. package/dist/core/cron.js +57 -0
  137. package/dist/core/cron.js.map +1 -0
  138. package/dist/core/fetch.d.ts +17 -0
  139. package/dist/core/goalOptions.d.ts +1 -0
  140. package/dist/core/goalOptions.js +166 -0
  141. package/dist/core/goalOptions.js.map +1 -0
  142. package/dist/core/granularity.js +3 -2
  143. package/dist/core/granularity.js.map +1 -1
  144. package/dist/core/guards.js +17 -0
  145. package/dist/core/guards.js.map +1 -0
  146. package/dist/core/jobs.d.ts +40 -0
  147. package/dist/core/jobs.js +132 -0
  148. package/dist/core/jobs.js.map +1 -0
  149. package/dist/core/legacyOptions.js +145 -0
  150. package/dist/core/legacyOptions.js.map +1 -0
  151. package/dist/core/metricAliases.js +81 -0
  152. package/dist/core/metricAliases.js.map +1 -0
  153. package/dist/core/metricValues.js +57 -0
  154. package/dist/core/metricValues.js.map +1 -0
  155. package/dist/core/monotonic.js +10 -0
  156. package/dist/core/monotonic.js.map +1 -0
  157. package/dist/core/optionChecks.js +51 -0
  158. package/dist/core/optionChecks.js.map +1 -0
  159. package/dist/core/options.d.ts +473 -157
  160. package/dist/core/options.js +154 -219
  161. package/dist/core/options.js.map +1 -1
  162. package/dist/core/registry.js +45 -5
  163. package/dist/core/registry.js.map +1 -1
  164. package/dist/core/scopeList.js +7 -9
  165. package/dist/core/scopeList.js.map +1 -1
  166. package/dist/core/scopeOptions.d.ts +1 -0
  167. package/dist/core/scopeOptions.js +112 -0
  168. package/dist/core/scopeOptions.js.map +1 -0
  169. package/dist/core/scopedRead.js +182 -72
  170. package/dist/core/scopedRead.js.map +1 -1
  171. package/dist/core/sdks.d.ts +81 -0
  172. package/dist/core/sdks.js +23 -0
  173. package/dist/core/sdks.js.map +1 -0
  174. package/dist/core/serverEvent.d.ts +38 -20
  175. package/dist/core/serverEvent.js.map +1 -1
  176. package/dist/core/siteAddress.js +20 -0
  177. package/dist/core/siteAddress.js.map +1 -0
  178. package/dist/core/sourceErrors.js +109 -0
  179. package/dist/core/sourceErrors.js.map +1 -0
  180. package/dist/core/sourceOptions.js +94 -0
  181. package/dist/core/sourceOptions.js.map +1 -0
  182. package/dist/core/throttle.js +18 -0
  183. package/dist/core/throttle.js.map +1 -0
  184. package/dist/core/values.js +61 -0
  185. package/dist/core/values.js.map +1 -0
  186. package/dist/core/widgetSlugs.d.ts +17 -0
  187. package/dist/core/widgetSlugs.js +29 -0
  188. package/dist/core/widgetSlugs.js.map +1 -0
  189. package/dist/db/detachedWrite.js +36 -0
  190. package/dist/db/detachedWrite.js.map +1 -0
  191. package/dist/db/errors.js +182 -0
  192. package/dist/db/errors.js.map +1 -0
  193. package/dist/db/kind.js +32 -0
  194. package/dist/db/kind.js.map +1 -0
  195. package/dist/db/openTransaction.js +51 -0
  196. package/dist/db/openTransaction.js.map +1 -0
  197. package/dist/exports/adapters/contract.d.ts +14 -0
  198. package/dist/exports/adapters/ga4.d.ts +15 -1
  199. package/dist/exports/adapters/native.d.ts +26 -2
  200. package/dist/exports/adapters/native.js +4 -1
  201. package/dist/exports/adapters/plausible.d.ts +15 -1
  202. package/dist/exports/adapters/posthog.d.ts +15 -1
  203. package/dist/exports/adapters/umami.d.ts +15 -1
  204. package/dist/exports/attributes.d.ts +42 -0
  205. package/dist/exports/attributes.js +83 -0
  206. package/dist/exports/attributes.js.map +1 -0
  207. package/dist/exports/client.d.ts +41 -13
  208. package/dist/exports/client.js +21 -9
  209. package/dist/exports/geo.d.ts +3 -1
  210. package/dist/exports/geo.js +1 -1
  211. package/dist/exports/i18n.d.ts +2 -2
  212. package/dist/exports/i18n.js +2 -2
  213. package/dist/exports/migrations.d.ts +2 -0
  214. package/dist/exports/migrations.js +2 -0
  215. package/dist/exports/next.d.ts +18 -1
  216. package/dist/exports/next.js +3 -1
  217. package/dist/exports/react.d.ts +3 -2
  218. package/dist/exports/react.js +1 -2
  219. package/dist/exports/rsc.d.ts +31 -14
  220. package/dist/exports/rsc.js +11 -6
  221. package/dist/exports/site.d.ts +5 -0
  222. package/dist/exports/site.js +3 -0
  223. package/dist/exports/testing.d.ts +17 -0
  224. package/dist/exports/testing.js +3 -0
  225. package/dist/exports/tracker.d.ts +5 -20
  226. package/dist/exports/tracker.js +3 -14
  227. package/dist/exports/types.d.ts +40 -14
  228. package/dist/exports/types.js +5 -1
  229. package/dist/fields/AnalyticsPanelClient.js +265 -154
  230. package/dist/fields/AnalyticsPanelClient.js.map +1 -1
  231. package/dist/fields/AnalyticsPanelField.d.ts +20 -8
  232. package/dist/fields/AnalyticsPanelField.js +121 -30
  233. package/dist/fields/AnalyticsPanelField.js.map +1 -1
  234. package/dist/fields/AnalyticsStatField.d.ts +18 -7
  235. package/dist/fields/AnalyticsStatField.js +98 -63
  236. package/dist/fields/AnalyticsStatField.js.map +1 -1
  237. package/dist/fields/FieldShimmer.js +15 -0
  238. package/dist/fields/FieldShimmer.js.map +1 -0
  239. package/dist/fields/PanelContent.js +217 -0
  240. package/dist/fields/PanelContent.js.map +1 -0
  241. package/dist/fields/PanelList.js +82 -0
  242. package/dist/fields/PanelList.js.map +1 -0
  243. package/dist/fields/PanelLiveCounter.js +63 -0
  244. package/dist/fields/PanelLiveCounter.js.map +1 -0
  245. package/dist/fields/PanelSkeleton.js +63 -0
  246. package/dist/fields/PanelSkeleton.js.map +1 -0
  247. package/dist/fields/componentPaths.js +8 -0
  248. package/dist/fields/componentPaths.js.map +1 -0
  249. package/dist/fields/config/FilterDimensionSelectField.d.ts +2 -2
  250. package/dist/fields/config/FilterDimensionSelectField.js +26 -54
  251. package/dist/fields/config/FilterDimensionSelectField.js.map +1 -1
  252. package/dist/fields/config/FilterKeySelect.js +66 -0
  253. package/dist/fields/config/FilterKeySelect.js.map +1 -0
  254. package/dist/fields/config/FilterOperatorSelectField.d.ts +7 -2
  255. package/dist/fields/config/FilterOperatorSelectField.js +37 -53
  256. package/dist/fields/config/FilterOperatorSelectField.js.map +1 -1
  257. package/dist/fields/config/FilterValueField.d.ts +17 -0
  258. package/dist/fields/config/FilterValueField.js +130 -0
  259. package/dist/fields/config/FilterValueField.js.map +1 -0
  260. package/dist/fields/config/MetricSelectField.d.ts +5 -12
  261. package/dist/fields/config/MetricSelectField.js +18 -30
  262. package/dist/fields/config/MetricSelectField.js.map +1 -1
  263. package/dist/fields/config/OptionSelect.js +52 -0
  264. package/dist/fields/config/OptionSelect.js.map +1 -0
  265. package/dist/fields/config/SourceSelectField.js +16 -31
  266. package/dist/fields/config/SourceSelectField.js.map +1 -1
  267. package/dist/fields/config/fetchSources.js +14 -26
  268. package/dist/fields/config/fetchSources.js.map +1 -1
  269. package/dist/fields/config/filterValues.js +106 -0
  270. package/dist/fields/config/filterValues.js.map +1 -0
  271. package/dist/fields/config/narrow.js +8 -10
  272. package/dist/fields/config/narrow.js.map +1 -1
  273. package/dist/fields/config/retiredPickers.d.ts +45 -0
  274. package/dist/fields/config/retiredPickers.js +46 -0
  275. package/dist/fields/config/retiredPickers.js.map +1 -0
  276. package/dist/fields/config/scopedFields.d.ts +40 -0
  277. package/dist/fields/config/scopedFields.js +68 -0
  278. package/dist/fields/config/scopedFields.js.map +1 -0
  279. package/dist/fields/config/toSelectOption.js +13 -7
  280. package/dist/fields/config/toSelectOption.js.map +1 -1
  281. package/dist/fields/config/useAnalyticsSources.d.ts +5 -7
  282. package/dist/fields/config/useAnalyticsSources.js +17 -21
  283. package/dist/fields/config/useAnalyticsSources.js.map +1 -1
  284. package/dist/fields/config/useFilterCapabilities.d.ts +9 -6
  285. package/dist/fields/config/useFilterCapabilities.js +23 -15
  286. package/dist/fields/config/useFilterCapabilities.js.map +1 -1
  287. package/dist/fields/config/useFormString.js +12 -0
  288. package/dist/fields/config/useFormString.js.map +1 -0
  289. package/dist/fields/dateRange/field.js +7 -19
  290. package/dist/fields/dateRange/field.js.map +1 -1
  291. package/dist/fields/dateRange/types.d.ts +5 -1
  292. package/dist/fields/dateRange/ui.d.ts +3 -2
  293. package/dist/fields/dateRange/ui.js +57 -319
  294. package/dist/fields/dateRange/ui.js.map +1 -1
  295. package/dist/fields/documentScope.js +21 -0
  296. package/dist/fields/documentScope.js.map +1 -0
  297. package/dist/fields/emptyState.js +31 -26
  298. package/dist/fields/emptyState.js.map +1 -1
  299. package/dist/fields/factories.d.ts +35 -16
  300. package/dist/fields/factories.js +66 -37
  301. package/dist/fields/factories.js.map +1 -1
  302. package/dist/fields/format.d.ts +12 -3
  303. package/dist/fields/format.js +77 -13
  304. package/dist/fields/format.js.map +1 -1
  305. package/dist/fields/itemReport.js +45 -0
  306. package/dist/fields/itemReport.js.map +1 -0
  307. package/dist/fields/readForDocument.d.ts +78 -26
  308. package/dist/fields/readForDocument.js +446 -116
  309. package/dist/fields/readForDocument.js.map +1 -1
  310. package/dist/fields/stateKeys.js +20 -0
  311. package/dist/fields/stateKeys.js.map +1 -0
  312. package/dist/goals/GoalAmountField.d.ts +10 -0
  313. package/dist/goals/GoalAmountField.js +162 -0
  314. package/dist/goals/GoalAmountField.js.map +1 -0
  315. package/dist/goals/GoalSelectField.js +89 -40
  316. package/dist/goals/GoalSelectField.js.map +1 -1
  317. package/dist/goals/GoalSelectFieldServer.d.ts +13 -0
  318. package/dist/goals/GoalSelectFieldServer.js +21 -0
  319. package/dist/goals/GoalSelectFieldServer.js.map +1 -0
  320. package/dist/goals/amountField.d.ts +20 -0
  321. package/dist/goals/amountField.js +37 -0
  322. package/dist/goals/amountField.js.map +1 -0
  323. package/dist/goals/builtin.js +17 -0
  324. package/dist/goals/builtin.js.map +1 -0
  325. package/dist/goals/collection.d.ts +22 -0
  326. package/dist/goals/collection.js +141 -100
  327. package/dist/goals/collection.js.map +1 -1
  328. package/dist/goals/constants.d.ts +38 -0
  329. package/dist/goals/constants.js +49 -0
  330. package/dist/goals/constants.js.map +1 -0
  331. package/dist/goals/currency.d.ts +16 -0
  332. package/dist/goals/currency.js +46 -4
  333. package/dist/goals/currency.js.map +1 -1
  334. package/dist/goals/currencyOptions.js +70 -0
  335. package/dist/goals/currencyOptions.js.map +1 -0
  336. package/dist/goals/fetchGoals.d.ts +10 -0
  337. package/dist/goals/fetchGoals.js +12 -26
  338. package/dist/goals/fetchGoals.js.map +1 -1
  339. package/dist/goals/goalField.d.ts +4 -6
  340. package/dist/goals/goalField.js +9 -19
  341. package/dist/goals/goalField.js.map +1 -1
  342. package/dist/goals/goalsEndpoint.js +39 -40
  343. package/dist/goals/goalsEndpoint.js.map +1 -1
  344. package/dist/goals/items.js +35 -0
  345. package/dist/goals/items.js.map +1 -0
  346. package/dist/goals/latent.js +9 -0
  347. package/dist/goals/latent.js.map +1 -0
  348. package/dist/goals/linkFields.d.ts +35 -0
  349. package/dist/goals/linkFields.js +31 -0
  350. package/dist/goals/linkFields.js.map +1 -0
  351. package/dist/goals/match.d.ts +14 -0
  352. package/dist/goals/match.js +67 -46
  353. package/dist/goals/match.js.map +1 -1
  354. package/dist/goals/moneyFields.js +56 -0
  355. package/dist/goals/moneyFields.js.map +1 -0
  356. package/dist/goals/pathMatch.js +122 -0
  357. package/dist/goals/pathMatch.js.map +1 -0
  358. package/dist/goals/placeholder.js +12 -0
  359. package/dist/goals/placeholder.js.map +1 -0
  360. package/dist/goals/resolver.d.ts +3 -3
  361. package/dist/goals/resolver.js +154 -46
  362. package/dist/goals/resolver.js.map +1 -1
  363. package/dist/goals/serverRevenue.d.ts +60 -0
  364. package/dist/goals/serverRevenue.js +41 -0
  365. package/dist/goals/serverRevenue.js.map +1 -0
  366. package/dist/goals/trackGoalAction.d.ts +26 -27
  367. package/dist/goals/trackGoalAction.js +38 -52
  368. package/dist/goals/trackGoalAction.js.map +1 -1
  369. package/dist/goals/types.d.ts +13 -28
  370. package/dist/goals/types.js +1 -1
  371. package/dist/goals/types.js.map +1 -1
  372. package/dist/goals/useAnalyticsGoals.d.ts +6 -5
  373. package/dist/goals/useAnalyticsGoals.js +17 -18
  374. package/dist/goals/useAnalyticsGoals.js.map +1 -1
  375. package/dist/index.d.ts +63 -11
  376. package/dist/index.js +257 -247
  377. package/dist/index.js.map +1 -1
  378. package/dist/items/collectionIdType.js +20 -0
  379. package/dist/items/collectionIdType.js.map +1 -0
  380. package/dist/items/idType.js +31 -0
  381. package/dist/items/idType.js.map +1 -0
  382. package/dist/items/ref.js +73 -0
  383. package/dist/items/ref.js.map +1 -0
  384. package/dist/maintenance/apiTaskState.js +141 -0
  385. package/dist/maintenance/apiTaskState.js.map +1 -0
  386. package/dist/maintenance/heartbeat.js +51 -0
  387. package/dist/maintenance/heartbeat.js.map +1 -0
  388. package/dist/maintenance/lease.d.ts +1 -0
  389. package/dist/maintenance/lease.js +81 -0
  390. package/dist/maintenance/lease.js.map +1 -0
  391. package/dist/maintenance/taskSchedule.d.ts +1 -0
  392. package/dist/maintenance/taskSchedule.js +62 -0
  393. package/dist/maintenance/taskSchedule.js.map +1 -0
  394. package/dist/maintenance/underLease.js +35 -0
  395. package/dist/maintenance/underLease.js.map +1 -0
  396. package/dist/migrations/legacy.d.ts +54 -0
  397. package/dist/migrations/legacy.js +117 -0
  398. package/dist/migrations/legacy.js.map +1 -0
  399. package/dist/migrations/predefined/dropLegacyMongo.d.ts +11 -0
  400. package/dist/migrations/predefined/dropLegacyMongo.js +12 -0
  401. package/dist/migrations/predefined/dropLegacyMongo.js.map +1 -0
  402. package/dist/native/collections/aggregates.js +54 -0
  403. package/dist/native/collections/aggregates.js.map +1 -0
  404. package/dist/native/collections/hits.js +102 -0
  405. package/dist/native/collections/hits.js.map +1 -0
  406. package/dist/native/collections/slugs.d.ts +10 -0
  407. package/dist/native/collections/slugs.js +16 -0
  408. package/dist/native/collections/slugs.js.map +1 -0
  409. package/dist/native/collections/state.js +84 -0
  410. package/dist/native/collections/state.js.map +1 -0
  411. package/dist/native/collections/storeCollection.js +29 -0
  412. package/dist/native/collections/storeCollection.js.map +1 -0
  413. package/dist/native/engine/buckets.d.ts +1 -0
  414. package/dist/native/engine/buckets.js +53 -0
  415. package/dist/native/engine/buckets.js.map +1 -0
  416. package/dist/native/engine/capabilities.js +87 -0
  417. package/dist/native/engine/capabilities.js.map +1 -0
  418. package/dist/native/engine/cost.js +72 -0
  419. package/dist/native/engine/cost.js.map +1 -0
  420. package/dist/native/engine/days.d.ts +1 -0
  421. package/dist/native/engine/days.js +182 -0
  422. package/dist/native/engine/days.js.map +1 -0
  423. package/dist/native/engine/engine.d.ts +1 -0
  424. package/dist/native/engine/engine.js +1623 -0
  425. package/dist/native/engine/engine.js.map +1 -0
  426. package/dist/native/engine/instance.js +58 -0
  427. package/dist/native/engine/instance.js.map +1 -0
  428. package/dist/native/engine/maintenance.d.ts +1 -0
  429. package/dist/native/engine/maintenance.js +677 -0
  430. package/dist/native/engine/maintenance.js.map +1 -0
  431. package/dist/native/engine/merge.js +41 -0
  432. package/dist/native/engine/merge.js.map +1 -0
  433. package/dist/native/engine/nudge.js +26 -0
  434. package/dist/native/engine/nudge.js.map +1 -0
  435. package/dist/native/engine/planner.js +198 -0
  436. package/dist/native/engine/planner.js.map +1 -0
  437. package/dist/native/engine/rebuild.d.ts +22 -0
  438. package/dist/native/engine/rebuild.js +76 -0
  439. package/dist/native/engine/rebuild.js.map +1 -0
  440. package/dist/native/engine/recent.js +17 -0
  441. package/dist/native/engine/recent.js.map +1 -0
  442. package/dist/native/engine/salt.d.ts +1 -0
  443. package/dist/native/engine/salt.js +98 -0
  444. package/dist/native/engine/salt.js.map +1 -0
  445. package/dist/native/engine/siteHosts.d.ts +1 -0
  446. package/dist/native/engine/siteHosts.js +58 -0
  447. package/dist/native/engine/siteHosts.js.map +1 -0
  448. package/dist/native/engine/toHit.js +108 -0
  449. package/dist/native/engine/toHit.js.map +1 -0
  450. package/dist/native/engine/writeBuffer.d.ts +14 -0
  451. package/dist/native/engine/writeBuffer.js +317 -0
  452. package/dist/native/engine/writeBuffer.js.map +1 -0
  453. package/dist/native/geo/composeGeoResolvers.d.ts +1 -0
  454. package/dist/native/geo/composeGeoResolvers.js +4 -1
  455. package/dist/native/geo/composeGeoResolvers.js.map +1 -1
  456. package/dist/native/geo/geoResolver.d.ts +20 -2
  457. package/dist/native/geo/geoResolver.js +42 -6
  458. package/dist/native/geo/geoResolver.js.map +1 -1
  459. package/dist/native/geo/maxmindResolver.d.ts +8 -4
  460. package/dist/native/geo/maxmindResolver.js +20 -16
  461. package/dist/native/geo/maxmindResolver.js.map +1 -1
  462. package/dist/native/geo/resolveGeo.js +31 -0
  463. package/dist/native/geo/resolveGeo.js.map +1 -0
  464. package/dist/native/ingest/bots.d.ts +2 -3
  465. package/dist/native/ingest/bots.js +8 -13
  466. package/dist/native/ingest/bots.js.map +1 -1
  467. package/dist/native/ingest/browser.js +4 -6
  468. package/dist/native/ingest/browser.js.map +1 -1
  469. package/dist/native/ingest/clientIp.js +30 -9
  470. package/dist/native/ingest/clientIp.js.map +1 -1
  471. package/dist/native/ingest/device.js +4 -6
  472. package/dist/native/ingest/device.js.map +1 -1
  473. package/dist/native/ingest/endpoint.d.ts +1 -1
  474. package/dist/native/ingest/endpoint.js +119 -34
  475. package/dist/native/ingest/endpoint.js.map +1 -1
  476. package/dist/native/ingest/itemSignature.d.ts +26 -0
  477. package/dist/native/ingest/itemSignature.js +45 -0
  478. package/dist/native/ingest/itemSignature.js.map +1 -0
  479. package/dist/native/ingest/language.js +2 -3
  480. package/dist/native/ingest/language.js.map +1 -1
  481. package/dist/native/ingest/normalizeEvent.d.ts +60 -7
  482. package/dist/native/ingest/normalizeEvent.js +226 -61
  483. package/dist/native/ingest/normalizeEvent.js.map +1 -1
  484. package/dist/native/ingest/orderSignature.d.ts +13 -0
  485. package/dist/native/ingest/orderSignature.js +50 -0
  486. package/dist/native/ingest/orderSignature.js.map +1 -0
  487. package/dist/native/ingest/referrer.js +30 -32
  488. package/dist/native/ingest/referrer.js.map +1 -1
  489. package/dist/native/ingest/requestHost.js +10 -23
  490. package/dist/native/ingest/requestHost.js.map +1 -1
  491. package/dist/native/ingest/resolveHostname.d.ts +4 -13
  492. package/dist/native/ingest/resolveHostname.js +5 -6
  493. package/dist/native/ingest/resolveHostname.js.map +1 -1
  494. package/dist/native/ingest/revenue.d.ts +1 -0
  495. package/dist/native/ingest/revenue.js +121 -0
  496. package/dist/native/ingest/revenue.js.map +1 -0
  497. package/dist/native/ingest/route.d.ts +10 -0
  498. package/dist/native/ingest/route.js +82 -0
  499. package/dist/native/ingest/route.js.map +1 -0
  500. package/dist/native/ingest/serverTrack.d.ts +2 -10
  501. package/dist/native/ingest/serverTrack.js +181 -72
  502. package/dist/native/ingest/serverTrack.js.map +1 -1
  503. package/dist/native/ingest/signature.js +28 -0
  504. package/dist/native/ingest/signature.js.map +1 -0
  505. package/dist/native/ingest/source.d.ts +2 -3
  506. package/dist/native/ingest/source.js +35 -54
  507. package/dist/native/ingest/source.js.map +1 -1
  508. package/dist/native/ingest/utm.js +9 -9
  509. package/dist/native/ingest/utm.js.map +1 -1
  510. package/dist/native/ingest/validate.js +20 -10
  511. package/dist/native/ingest/validate.js.map +1 -1
  512. package/dist/native/ingest/visitorHash.js +6 -8
  513. package/dist/native/ingest/visitorHash.js.map +1 -1
  514. package/dist/native/nativeAdapter.d.ts +101 -33
  515. package/dist/native/nativeAdapter.js +375 -317
  516. package/dist/native/nativeAdapter.js.map +1 -1
  517. package/dist/native/rebuildDays.d.ts +12 -0
  518. package/dist/native/rebuildDays.js +16 -0
  519. package/dist/native/rebuildDays.js.map +1 -0
  520. package/dist/native/store/aggregate.js +450 -0
  521. package/dist/native/store/aggregate.js.map +1 -0
  522. package/dist/native/store/caps.d.ts +18 -0
  523. package/dist/native/store/caps.js +76 -0
  524. package/dist/native/store/caps.js.map +1 -0
  525. package/dist/native/store/chunks.js +34 -0
  526. package/dist/native/store/chunks.js.map +1 -0
  527. package/dist/native/store/columnValues.js +31 -0
  528. package/dist/native/store/columnValues.js.map +1 -0
  529. package/dist/native/store/dialect.js +106 -0
  530. package/dist/native/store/dialect.js.map +1 -0
  531. package/dist/native/store/eventStore.js +44 -0
  532. package/dist/native/store/eventStore.js.map +1 -0
  533. package/dist/native/store/hitRow.js +116 -0
  534. package/dist/native/store/hitRow.js.map +1 -0
  535. package/dist/native/store/hits.js +63 -0
  536. package/dist/native/store/hits.js.map +1 -0
  537. package/dist/native/store/ids.js +105 -0
  538. package/dist/native/store/ids.js.map +1 -0
  539. package/dist/native/store/mongo/aggregatePipelines.js +430 -0
  540. package/dist/native/store/mongo/aggregatePipelines.js.map +1 -0
  541. package/dist/native/store/mongo/mongoState.js +375 -0
  542. package/dist/native/store/mongo/mongoState.js.map +1 -0
  543. package/dist/native/store/mongo/mongoStore.js +618 -0
  544. package/dist/native/store/mongo/mongoStore.js.map +1 -0
  545. package/dist/native/store/mongo/pipelines.js +695 -0
  546. package/dist/native/store/mongo/pipelines.js.map +1 -0
  547. package/dist/native/store/mongo/results.js +20 -0
  548. package/dist/native/store/mongo/results.js.map +1 -0
  549. package/dist/native/store/parts.d.ts +1 -0
  550. package/dist/native/store/parts.js +95 -0
  551. package/dist/native/store/parts.js.map +1 -0
  552. package/dist/native/store/pattern.js +213 -0
  553. package/dist/native/store/pattern.js.map +1 -0
  554. package/dist/native/store/rawRead.d.ts +23 -0
  555. package/dist/native/store/rawRead.js +384 -0
  556. package/dist/native/store/rawRead.js.map +1 -0
  557. package/dist/native/store/reclassify.js +53 -0
  558. package/dist/native/store/reclassify.js.map +1 -0
  559. package/dist/native/store/sql/aggregateSql.js +345 -0
  560. package/dist/native/store/sql/aggregateSql.js.map +1 -0
  561. package/dist/native/store/sql/columns.js +48 -0
  562. package/dist/native/store/sql/columns.js.map +1 -0
  563. package/dist/native/store/sql/compile.js +656 -0
  564. package/dist/native/store/sql/compile.js.map +1 -0
  565. package/dist/native/store/sql/drivers.js +218 -0
  566. package/dist/native/store/sql/drivers.js.map +1 -0
  567. package/dist/native/store/sql/executor.js +132 -0
  568. package/dist/native/store/sql/executor.js.map +1 -0
  569. package/dist/native/store/sql/fragment.js +104 -0
  570. package/dist/native/store/sql/fragment.js.map +1 -0
  571. package/dist/native/store/sql/maintenanceSql.js +59 -0
  572. package/dist/native/store/sql/maintenanceSql.js.map +1 -0
  573. package/dist/native/store/sql/ownConnection.js +107 -0
  574. package/dist/native/store/sql/ownConnection.js.map +1 -0
  575. package/dist/native/store/sql/poolShare.js +101 -0
  576. package/dist/native/store/sql/poolShare.js.map +1 -0
  577. package/dist/native/store/sql/sqlState.js +325 -0
  578. package/dist/native/store/sql/sqlState.js.map +1 -0
  579. package/dist/native/store/sql/sqlStore.js +355 -0
  580. package/dist/native/store/sql/sqlStore.js.map +1 -0
  581. package/dist/native/store/sql/sqliteThread.d.ts +9 -0
  582. package/dist/native/store/sql/sqliteThread.js +314 -0
  583. package/dist/native/store/sql/sqliteThread.js.map +1 -0
  584. package/dist/native/store/sql/sqliteWorker.js +327 -0
  585. package/dist/native/store/sql/sqliteWorker.js.map +1 -0
  586. package/dist/native/store/sql/sqliteWorkerSource.js +347 -0
  587. package/dist/native/store/sql/sqliteWorkerSource.js.map +1 -0
  588. package/dist/native/store/state.js +151 -0
  589. package/dist/native/store/state.js.map +1 -0
  590. package/dist/native/store/stateStore.js +29 -0
  591. package/dist/native/store/stateStore.js.map +1 -0
  592. package/dist/native/store/types.d.ts +9 -0
  593. package/dist/native/tasks/maintainTask.d.ts +19 -0
  594. package/dist/native/tasks/maintainTask.js +68 -0
  595. package/dist/native/tasks/maintainTask.js.map +1 -0
  596. package/dist/net/guardedFetch.d.ts +32 -0
  597. package/dist/net/guardedFetch.js +220 -0
  598. package/dist/net/guardedFetch.js.map +1 -0
  599. package/dist/net/origin.js +40 -0
  600. package/dist/net/origin.js.map +1 -0
  601. package/dist/net/platform.d.ts +9 -0
  602. package/dist/net/platform.js +35 -0
  603. package/dist/net/platform.js.map +1 -0
  604. package/dist/next/captureRewrites.d.ts +4 -24
  605. package/dist/next/captureRewrites.js +6 -50
  606. package/dist/next/captureRewrites.js.map +1 -1
  607. package/dist/next/captureRoute.d.ts +28 -0
  608. package/dist/next/captureRoute.js +67 -0
  609. package/dist/next/captureRoute.js.map +1 -0
  610. package/dist/next/ingestRoute.d.ts +17 -0
  611. package/dist/next/ingestRoute.js +17 -0
  612. package/dist/next/ingestRoute.js.map +1 -0
  613. package/dist/next/posthogProxyRewrites.d.ts +3 -25
  614. package/dist/next/posthogProxyRewrites.js +5 -37
  615. package/dist/next/posthogProxyRewrites.js.map +1 -1
  616. package/dist/plugin/adminDependencies.js +34 -0
  617. package/dist/plugin/adminDependencies.js.map +1 -0
  618. package/dist/plugin/apiPath.js +23 -0
  619. package/dist/plugin/apiPath.js.map +1 -0
  620. package/dist/plugin/boundDocument.js +58 -0
  621. package/dist/plugin/boundDocument.js.map +1 -0
  622. package/dist/plugin/buildPhase.js +10 -0
  623. package/dist/plugin/buildPhase.js.map +1 -0
  624. package/dist/plugin/collectionChecks.js +232 -0
  625. package/dist/plugin/collectionChecks.js.map +1 -0
  626. package/dist/plugin/collectionFields.d.ts +13 -0
  627. package/dist/plugin/collectionFields.js +22 -0
  628. package/dist/plugin/collectionFields.js.map +1 -0
  629. package/dist/plugin/createRuntime.js +336 -0
  630. package/dist/plugin/createRuntime.js.map +1 -0
  631. package/dist/plugin/destroy.js +58 -0
  632. package/dist/plugin/destroy.js.map +1 -0
  633. package/dist/plugin/documentEndpoint.js +76 -53
  634. package/dist/plugin/documentEndpoint.js.map +1 -1
  635. package/dist/plugin/documentScopes.js +37 -0
  636. package/dist/plugin/documentScopes.js.map +1 -0
  637. package/dist/plugin/encrypted.js +25 -0
  638. package/dist/plugin/encrypted.js.map +1 -0
  639. package/dist/plugin/errors.d.ts +5 -12
  640. package/dist/plugin/errors.js +23 -16
  641. package/dist/plugin/errors.js.map +1 -1
  642. package/dist/plugin/flagsEndpoint.js +41 -0
  643. package/dist/plugin/flagsEndpoint.js.map +1 -0
  644. package/dist/plugin/goalHint.js +22 -11
  645. package/dist/plugin/goalHint.js.map +1 -1
  646. package/dist/plugin/itemLabels.js +114 -0
  647. package/dist/plugin/itemLabels.js.map +1 -0
  648. package/dist/plugin/jobsAccess.js +91 -0
  649. package/dist/plugin/jobsAccess.js.map +1 -0
  650. package/dist/plugin/keepAlive.js +48 -0
  651. package/dist/plugin/keepAlive.js.map +1 -0
  652. package/dist/plugin/peerImportError.js +3 -6
  653. package/dist/plugin/peerImportError.js.map +1 -1
  654. package/dist/plugin/peers.js +64 -0
  655. package/dist/plugin/peers.js.map +1 -0
  656. package/dist/plugin/pluginCollections.js +155 -0
  657. package/dist/plugin/pluginCollections.js.map +1 -0
  658. package/dist/plugin/queryEndpoint.js +69 -44
  659. package/dist/plugin/queryEndpoint.js.map +1 -1
  660. package/dist/plugin/queryParams.js +7 -0
  661. package/dist/plugin/queryParams.js.map +1 -0
  662. package/dist/plugin/readContextForRequest.js +52 -17
  663. package/dist/plugin/readContextForRequest.js.map +1 -1
  664. package/dist/plugin/readFailure.js +22 -0
  665. package/dist/plugin/readFailure.js.map +1 -0
  666. package/dist/plugin/readableProviders.js +64 -0
  667. package/dist/plugin/readableProviders.js.map +1 -0
  668. package/dist/plugin/realtimeEndpoint.js +77 -25
  669. package/dist/plugin/realtimeEndpoint.js.map +1 -1
  670. package/dist/plugin/refreshEndpoint.js +69 -44
  671. package/dist/plugin/refreshEndpoint.js.map +1 -1
  672. package/dist/plugin/relabelFields.js +36 -0
  673. package/dist/plugin/relabelFields.js.map +1 -0
  674. package/dist/plugin/requestMemo.js +35 -0
  675. package/dist/plugin/requestMemo.js.map +1 -0
  676. package/dist/plugin/routeChecks.js +39 -0
  677. package/dist/plugin/routeChecks.js.map +1 -0
  678. package/dist/plugin/routes.d.ts +53 -0
  679. package/dist/plugin/routes.js +92 -0
  680. package/dist/plugin/routes.js.map +1 -0
  681. package/dist/plugin/runtime.d.ts +1 -1
  682. package/dist/plugin/runtime.js +226 -30
  683. package/dist/plugin/runtime.js.map +1 -1
  684. package/dist/plugin/schemaOnly.js +63 -0
  685. package/dist/plugin/schemaOnly.js.map +1 -0
  686. package/dist/plugin/scopeChange.js +6 -5
  687. package/dist/plugin/scopeChange.js.map +1 -1
  688. package/dist/plugin/scopeFieldBoot.js +4 -4
  689. package/dist/plugin/scopeFieldBoot.js.map +1 -1
  690. package/dist/plugin/scopeToken.js +33 -0
  691. package/dist/plugin/scopeToken.js.map +1 -0
  692. package/dist/plugin/sourcesEndpoint.js +46 -12
  693. package/dist/plugin/sourcesEndpoint.js.map +1 -1
  694. package/dist/plugin/unbundledLanguages.js +25 -0
  695. package/dist/plugin/unbundledLanguages.js.map +1 -0
  696. package/dist/plugin/walkFields.js +22 -0
  697. package/dist/plugin/walkFields.js.map +1 -0
  698. package/dist/plugin/warmTask.js +0 -0
  699. package/dist/plugin/warmTask.js.map +1 -1
  700. package/dist/providers/access.d.ts +1 -0
  701. package/dist/providers/access.js +35 -26
  702. package/dist/providers/access.js.map +1 -1
  703. package/dist/providers/adapterPool.js +121 -0
  704. package/dist/providers/adapterPool.js.map +1 -0
  705. package/dist/providers/collection.d.ts +53 -0
  706. package/dist/providers/collection.js +274 -150
  707. package/dist/providers/collection.js.map +1 -1
  708. package/dist/providers/factory.d.ts +76 -0
  709. package/dist/providers/factory.js +76 -23
  710. package/dist/providers/factory.js.map +1 -1
  711. package/dist/providers/hosts.d.ts +25 -0
  712. package/dist/providers/hosts.js +128 -0
  713. package/dist/providers/hosts.js.map +1 -0
  714. package/dist/providers/probe.d.ts +1 -0
  715. package/dist/providers/probe.js +101 -0
  716. package/dist/providers/probe.js.map +1 -0
  717. package/dist/providers/refresh.d.ts +18 -0
  718. package/dist/providers/refresh.js +49 -0
  719. package/dist/providers/refresh.js.map +1 -0
  720. package/dist/providers/registry.js +318 -0
  721. package/dist/providers/registry.js.map +1 -0
  722. package/dist/providers/resolver.js +23 -88
  723. package/dist/providers/resolver.js.map +1 -1
  724. package/dist/providers/retarget.js +45 -0
  725. package/dist/providers/retarget.js.map +1 -0
  726. package/dist/providers/secrets.d.ts +26 -0
  727. package/dist/providers/secrets.js +61 -4
  728. package/dist/providers/secrets.js.map +1 -1
  729. package/dist/providers/stampScope.js +9 -6
  730. package/dist/providers/stampScope.js.map +1 -1
  731. package/dist/query/dates.js +10 -12
  732. package/dist/query/dates.js.map +1 -1
  733. package/dist/query/errors.d.ts +1 -5
  734. package/dist/query/fetchQuery.d.ts +25 -32
  735. package/dist/query/fetchQuery.js +91 -91
  736. package/dist/query/fetchQuery.js.map +1 -1
  737. package/dist/query/limits.js +8 -0
  738. package/dist/query/limits.js.map +1 -0
  739. package/dist/query/parse.d.ts +6 -0
  740. package/dist/query/parse.js +153 -106
  741. package/dist/query/parse.js.map +1 -1
  742. package/dist/query/response.d.ts +23 -3
  743. package/dist/query/response.js +12 -5
  744. package/dist/query/response.js.map +1 -1
  745. package/dist/react/AnalyticsProvider.d.ts +26 -17
  746. package/dist/react/AnalyticsProvider.js +23 -22
  747. package/dist/react/AnalyticsProvider.js.map +1 -1
  748. package/dist/react/TrackerBoot.js +15 -9
  749. package/dist/react/TrackerBoot.js.map +1 -1
  750. package/dist/react/useAnalytics.d.ts +2 -11
  751. package/dist/react/useAnalytics.js +22 -24
  752. package/dist/react/useAnalytics.js.map +1 -1
  753. package/dist/site/AnalyticsScripts.d.ts +34 -0
  754. package/dist/site/AnalyticsScripts.js +30 -0
  755. package/dist/site/AnalyticsScripts.js.map +1 -0
  756. package/dist/site/getTrackerConfig.d.ts +15 -0
  757. package/dist/site/getTrackerConfig.js +40 -0
  758. package/dist/site/getTrackerConfig.js.map +1 -0
  759. package/dist/surfacing/afterRead.d.ts +37 -0
  760. package/dist/surfacing/bounded.js +38 -0
  761. package/dist/surfacing/bounded.js.map +1 -0
  762. package/dist/surfacing/breaker.js +107 -0
  763. package/dist/surfacing/breaker.js.map +1 -0
  764. package/dist/surfacing/cacheCollection.d.ts +8 -0
  765. package/dist/surfacing/cacheCollection.js +69 -0
  766. package/dist/surfacing/cacheCollection.js.map +1 -0
  767. package/dist/surfacing/cacheStore.d.ts +71 -1
  768. package/dist/surfacing/cacheStore.js +16 -37
  769. package/dist/surfacing/cacheStore.js.map +1 -1
  770. package/dist/surfacing/cacheSweep.d.ts +1 -0
  771. package/dist/surfacing/cacheSweep.js +59 -0
  772. package/dist/surfacing/cacheSweep.js.map +1 -0
  773. package/dist/surfacing/classifyError.js +282 -0
  774. package/dist/surfacing/classifyError.js.map +1 -0
  775. package/dist/surfacing/coalesce.js +2 -1
  776. package/dist/surfacing/coalesce.js.map +1 -1
  777. package/dist/surfacing/coldBudget.js +60 -0
  778. package/dist/surfacing/coldBudget.js.map +1 -0
  779. package/dist/surfacing/collectionCacheStore.js +183 -0
  780. package/dist/surfacing/collectionCacheStore.js.map +1 -0
  781. package/dist/surfacing/engine.d.ts +1 -1
  782. package/dist/surfacing/engine.js +514 -72
  783. package/dist/surfacing/engine.js.map +1 -1
  784. package/dist/surfacing/epoch.js +70 -26
  785. package/dist/surfacing/epoch.js.map +1 -1
  786. package/dist/surfacing/lanes.d.ts +1 -0
  787. package/dist/surfacing/lanes.js +297 -0
  788. package/dist/surfacing/lanes.js.map +1 -0
  789. package/dist/surfacing/memo.js +40 -0
  790. package/dist/surfacing/memo.js.map +1 -0
  791. package/dist/surfacing/rateLimiter.d.ts +1 -0
  792. package/dist/surfacing/rateLimiter.js +69 -94
  793. package/dist/surfacing/rateLimiter.js.map +1 -1
  794. package/dist/surfacing/rebucket.js +178 -0
  795. package/dist/surfacing/rebucket.js.map +1 -0
  796. package/dist/surfacing/recipe.js +28 -0
  797. package/dist/surfacing/recipe.js.map +1 -0
  798. package/dist/surfacing/shape.js +22 -0
  799. package/dist/surfacing/shape.js.map +1 -0
  800. package/dist/surfacing/todaySplit.js +113 -0
  801. package/dist/surfacing/todaySplit.js.map +1 -0
  802. package/dist/sync/collection.d.ts +8 -0
  803. package/dist/sync/collection.js +28 -18
  804. package/dist/sync/collection.js.map +1 -1
  805. package/dist/sync/rekeyDurations.js +70 -0
  806. package/dist/sync/rekeyDurations.js.map +1 -0
  807. package/dist/sync/syncTask.js +226 -109
  808. package/dist/sync/syncTask.js.map +1 -1
  809. package/dist/testing/memoryAdapter.d.ts +6 -3
  810. package/dist/testing/memoryAdapter.js +12 -10
  811. package/dist/testing/memoryAdapter.js.map +1 -1
  812. package/dist/testing/settle.d.ts +11 -0
  813. package/dist/testing/settle.js +19 -0
  814. package/dist/testing/settle.js.map +1 -0
  815. package/dist/timeframe/calendar.js +65 -0
  816. package/dist/timeframe/calendar.js.map +1 -0
  817. package/dist/timeframe/comparison.js +46 -0
  818. package/dist/timeframe/comparison.js.map +1 -0
  819. package/dist/timeframe/presets.d.ts +1 -1
  820. package/dist/timeframe/presets.js +5 -5
  821. package/dist/timeframe/presets.js.map +1 -1
  822. package/dist/timeframe/reportingTimezone.d.ts +1 -0
  823. package/dist/timeframe/reportingTimezone.js +64 -0
  824. package/dist/timeframe/reportingTimezone.js.map +1 -0
  825. package/dist/timeframe/tz.js +55 -39
  826. package/dist/timeframe/tz.js.map +1 -1
  827. package/dist/tracker/autoCapture.js +125 -38
  828. package/dist/tracker/autoCapture.js.map +1 -1
  829. package/dist/tracker/campaign.js +52 -0
  830. package/dist/tracker/campaign.js.map +1 -0
  831. package/dist/tracker/config.d.ts +144 -0
  832. package/dist/tracker/config.js +25 -0
  833. package/dist/tracker/config.js.map +1 -0
  834. package/dist/tracker/createTracker.d.ts +4 -10
  835. package/dist/tracker/createTracker.js +386 -115
  836. package/dist/tracker/createTracker.js.map +1 -1
  837. package/dist/tracker/digest.js +28 -0
  838. package/dist/tracker/digest.js.map +1 -0
  839. package/dist/tracker/engagement.js +100 -0
  840. package/dist/tracker/engagement.js.map +1 -0
  841. package/dist/tracker/events.js +37 -0
  842. package/dist/tracker/events.js.map +1 -0
  843. package/dist/tracker/exclusion.d.ts +2 -22
  844. package/dist/tracker/exclusion.js +53 -21
  845. package/dist/tracker/exclusion.js.map +1 -1
  846. package/dist/tracker/gate.js +194 -0
  847. package/dist/tracker/gate.js.map +1 -0
  848. package/dist/tracker/initTracker.d.ts +5 -8
  849. package/dist/tracker/initTracker.js +42 -14
  850. package/dist/tracker/initTracker.js.map +1 -1
  851. package/dist/tracker/itemCapture.js +224 -0
  852. package/dist/tracker/itemCapture.js.map +1 -0
  853. package/dist/tracker/loadScript.js +21 -14
  854. package/dist/tracker/loadScript.js.map +1 -1
  855. package/dist/tracker/pageTracking.js +6 -6
  856. package/dist/tracker/pageTracking.js.map +1 -1
  857. package/dist/tracker/registry.js +118 -30
  858. package/dist/tracker/registry.js.map +1 -1
  859. package/dist/tracker/sinks/createSink.js +38 -0
  860. package/dist/tracker/sinks/createSink.js.map +1 -0
  861. package/dist/tracker/sinks/ga4.js +64 -20
  862. package/dist/tracker/sinks/ga4.js.map +1 -1
  863. package/dist/tracker/sinks/native.js +7 -42
  864. package/dist/tracker/sinks/native.js.map +1 -1
  865. package/dist/tracker/sinks/plausible.js +27 -22
  866. package/dist/tracker/sinks/plausible.js.map +1 -1
  867. package/dist/tracker/sinks/posthog.js +26 -22
  868. package/dist/tracker/sinks/posthog.js.map +1 -1
  869. package/dist/tracker/sinks/umami.js +14 -12
  870. package/dist/tracker/sinks/umami.js.map +1 -1
  871. package/dist/tracker/sinks/vendor.js +30 -27
  872. package/dist/tracker/sinks/vendor.js.map +1 -1
  873. package/dist/tracker/skip.js +81 -0
  874. package/dist/tracker/skip.js.map +1 -0
  875. package/dist/tracker/storage.js +23 -0
  876. package/dist/tracker/storage.js.map +1 -0
  877. package/dist/tracker/transport.js +2 -5
  878. package/dist/tracker/transport.js.map +1 -1
  879. package/dist/tracker/types.d.ts +86 -63
  880. package/dist/tracker/window.js +7 -0
  881. package/dist/tracker/window.js.map +1 -0
  882. package/dist/translations/ar.js +226 -71
  883. package/dist/translations/ar.js.map +1 -1
  884. package/dist/translations/de.js +215 -69
  885. package/dist/translations/de.js.map +1 -1
  886. package/dist/translations/en.js +209 -67
  887. package/dist/translations/en.js.map +1 -1
  888. package/dist/translations/es.js +217 -68
  889. package/dist/translations/es.js.map +1 -1
  890. package/dist/translations/fr.js +221 -72
  891. package/dist/translations/fr.js.map +1 -1
  892. package/dist/translations/id.js +212 -67
  893. package/dist/translations/id.js.map +1 -1
  894. package/dist/translations/index.d.ts +1 -1
  895. package/dist/translations/index.js +5 -7
  896. package/dist/translations/index.js.map +1 -1
  897. package/dist/translations/intl.js +71 -0
  898. package/dist/translations/intl.js.map +1 -0
  899. package/dist/translations/keys.d.ts +185 -14
  900. package/dist/translations/keys.js +190 -14
  901. package/dist/translations/keys.js.map +1 -1
  902. package/dist/translations/ko.js +214 -69
  903. package/dist/translations/ko.js.map +1 -1
  904. package/dist/translations/labelMap.d.ts +10 -0
  905. package/dist/translations/labelMap.js +22 -0
  906. package/dist/translations/labelMap.js.map +1 -0
  907. package/dist/translations/metricKeys.js +10 -2
  908. package/dist/translations/metricKeys.js.map +1 -1
  909. package/dist/translations/parts.js +20 -0
  910. package/dist/translations/parts.js.map +1 -0
  911. package/dist/translations/plural.js +61 -0
  912. package/dist/translations/plural.js.map +1 -0
  913. package/dist/translations/pt.js +226 -77
  914. package/dist/translations/pt.js.map +1 -1
  915. package/dist/translations/ru.js +217 -66
  916. package/dist/translations/ru.js.map +1 -1
  917. package/dist/translations/server.d.ts +1 -0
  918. package/dist/translations/server.js +2 -3
  919. package/dist/translations/server.js.map +1 -1
  920. package/dist/translations/staticLabel.js +69 -0
  921. package/dist/translations/staticLabel.js.map +1 -0
  922. package/dist/translations/uk.js +217 -66
  923. package/dist/translations/uk.js.map +1 -1
  924. package/dist/translations/zh.js +212 -67
  925. package/dist/translations/zh.js.map +1 -1
  926. package/dist/ui/RangePicker.js +112 -0
  927. package/dist/ui/RangePicker.js.map +1 -0
  928. package/dist/ui/analytics.css +1528 -0
  929. package/dist/ui/calendarDays.js +27 -0
  930. package/dist/ui/calendarDays.js.map +1 -0
  931. package/dist/ui/classNames.js +7 -0
  932. package/dist/ui/classNames.js.map +1 -0
  933. package/dist/ui/components/Card.d.ts +28 -0
  934. package/dist/ui/components/Card.js +21 -0
  935. package/dist/ui/components/Card.js.map +1 -0
  936. package/dist/ui/components/ChartDataTable.d.ts +41 -0
  937. package/dist/ui/components/ChartDataTable.js +48 -0
  938. package/dist/ui/components/ChartDataTable.js.map +1 -0
  939. package/dist/ui/components/DataTable.d.ts +82 -0
  940. package/dist/ui/components/DataTable.js +214 -0
  941. package/dist/ui/components/DataTable.js.map +1 -0
  942. package/dist/ui/components/LabeledSelect.js +62 -0
  943. package/dist/ui/components/LabeledSelect.js.map +1 -0
  944. package/dist/ui/components/LiveAnnouncement.js +21 -0
  945. package/dist/ui/components/LiveAnnouncement.js.map +1 -0
  946. package/dist/ui/components/MetricCard.d.ts +38 -0
  947. package/dist/ui/components/MetricCard.js +39 -0
  948. package/dist/ui/components/MetricCard.js.map +1 -0
  949. package/dist/ui/components/NoValue.js +22 -0
  950. package/dist/ui/components/NoValue.js.map +1 -0
  951. package/dist/ui/components/ReadState.js +27 -0
  952. package/dist/ui/components/ReadState.js.map +1 -0
  953. package/dist/ui/components/RefreshButton.js +26 -0
  954. package/dist/ui/components/RefreshButton.js.map +1 -0
  955. package/dist/ui/cssVars.js +7 -0
  956. package/dist/ui/cssVars.js.map +1 -0
  957. package/dist/ui/data/WithScopeToken.d.ts +20 -0
  958. package/dist/ui/data/WithScopeToken.js +20 -0
  959. package/dist/ui/data/WithScopeToken.js.map +1 -0
  960. package/dist/ui/data/clientFieldProps.js +16 -0
  961. package/dist/ui/data/clientFieldProps.js.map +1 -0
  962. package/dist/ui/data/request.d.ts +46 -0
  963. package/dist/ui/data/request.js +119 -0
  964. package/dist/ui/data/request.js.map +1 -0
  965. package/dist/ui/data/scopeTokenContext.js +18 -0
  966. package/dist/ui/data/scopeTokenContext.js.map +1 -0
  967. package/dist/ui/data/sharedCache.js +48 -0
  968. package/dist/ui/data/sharedCache.js.map +1 -0
  969. package/dist/ui/data/useRequest.d.ts +19 -0
  970. package/dist/ui/data/useRequest.js +123 -0
  971. package/dist/ui/data/useRequest.js.map +1 -0
  972. package/dist/ui/data/useRequestScope.js +25 -0
  973. package/dist/ui/data/useRequestScope.js.map +1 -0
  974. package/dist/ui/hooks/useDirection.js +47 -0
  975. package/dist/ui/hooks/useDirection.js.map +1 -0
  976. package/dist/ui/hooks/useDismissOnEscape.js +25 -0
  977. package/dist/ui/hooks/useDismissOnEscape.js.map +1 -0
  978. package/dist/ui/hooks/useLiveAnnouncement.js +57 -0
  979. package/dist/ui/hooks/useLiveAnnouncement.js.map +1 -0
  980. package/dist/ui/hooks/useRealtimePoll.js +112 -0
  981. package/dist/ui/hooks/useRealtimePoll.js.map +1 -0
  982. package/dist/ui/readState.js +19 -0
  983. package/dist/ui/readState.js.map +1 -0
  984. package/dist/ui/rows/toDisplayRows.js +49 -0
  985. package/dist/ui/rows/toDisplayRows.js.map +1 -0
  986. package/dist/ui/viewerClock.js +7 -0
  987. package/dist/ui/viewerClock.js.map +1 -0
  988. package/dist/view/AnalyticsNavLink.d.ts +5 -3
  989. package/dist/view/AnalyticsNavLink.js +11 -6
  990. package/dist/view/AnalyticsNavLink.js.map +1 -1
  991. package/dist/view/AnalyticsView.d.ts +8 -10
  992. package/dist/view/AnalyticsView.js +47 -18
  993. package/dist/view/AnalyticsView.js.map +1 -1
  994. package/dist/view/AnalyticsViewClient.d.ts +4 -7
  995. package/dist/view/AnalyticsViewClient.js +15 -229
  996. package/dist/view/AnalyticsViewClient.js.map +1 -1
  997. package/dist/view/CountryFlag.d.ts +27 -0
  998. package/dist/view/CountryFlag.js +44 -0
  999. package/dist/view/CountryFlag.js.map +1 -0
  1000. package/dist/view/DocumentTitle.js +27 -0
  1001. package/dist/view/DocumentTitle.js.map +1 -0
  1002. package/dist/view/ViewRoot.d.ts +21 -0
  1003. package/dist/view/ViewRoot.js +150 -0
  1004. package/dist/view/ViewRoot.js.map +1 -0
  1005. package/dist/view/ViewSections.d.ts +38 -0
  1006. package/dist/view/ViewSections.js +190 -0
  1007. package/dist/view/ViewSections.js.map +1 -0
  1008. package/dist/view/authRedirect.js +2 -4
  1009. package/dist/view/authRedirect.js.map +1 -1
  1010. package/dist/view/conversionRate.js +9 -7
  1011. package/dist/view/conversionRate.js.map +1 -1
  1012. package/dist/view/dayRange.js +6 -10
  1013. package/dist/view/dayRange.js.map +1 -1
  1014. package/dist/view/exclusionLink.d.ts +27 -0
  1015. package/dist/view/exclusionLink.js +46 -0
  1016. package/dist/view/exclusionLink.js.map +1 -0
  1017. package/dist/view/flagSrc.js +14 -0
  1018. package/dist/view/flagSrc.js.map +1 -0
  1019. package/dist/view/gating.d.ts +15 -1
  1020. package/dist/view/gating.js +66 -31
  1021. package/dist/view/gating.js.map +1 -1
  1022. package/dist/view/hostCountryFlag.js +41 -0
  1023. package/dist/view/hostCountryFlag.js.map +1 -0
  1024. package/dist/view/labels.js +95 -10
  1025. package/dist/view/labels.js.map +1 -1
  1026. package/dist/view/metricAliases.js +10 -0
  1027. package/dist/view/metricAliases.js.map +1 -0
  1028. package/dist/view/navLabel.js +15 -0
  1029. package/dist/view/navLabel.js.map +1 -0
  1030. package/dist/view/registerView.js +10 -9
  1031. package/dist/view/registerView.js.map +1 -1
  1032. package/dist/view/scopeLabel.js +21 -0
  1033. package/dist/view/scopeLabel.js.map +1 -0
  1034. package/dist/view/sections/Breakdowns.js +196 -134
  1035. package/dist/view/sections/Breakdowns.js.map +1 -1
  1036. package/dist/view/sections/EmptyStates.js +118 -30
  1037. package/dist/view/sections/EmptyStates.js.map +1 -1
  1038. package/dist/view/sections/ExcludeBrowser.js +188 -0
  1039. package/dist/view/sections/ExcludeBrowser.js.map +1 -0
  1040. package/dist/view/sections/FilterChips.js +124 -27
  1041. package/dist/view/sections/FilterChips.js.map +1 -1
  1042. package/dist/view/sections/GoalsPanel.js +68 -60
  1043. package/dist/view/sections/GoalsPanel.js.map +1 -1
  1044. package/dist/view/sections/OverviewCards.js +29 -33
  1045. package/dist/view/sections/OverviewCards.js.map +1 -1
  1046. package/dist/view/sections/RealtimeStrip.js +70 -59
  1047. package/dist/view/sections/RealtimeStrip.js.map +1 -1
  1048. package/dist/view/sections/SectionBoundary.js +34 -0
  1049. package/dist/view/sections/SectionBoundary.js.map +1 -0
  1050. package/dist/view/sections/Toolbar.d.ts +11 -0
  1051. package/dist/view/sections/Toolbar.js +123 -82
  1052. package/dist/view/sections/Toolbar.js.map +1 -1
  1053. package/dist/view/sections/Trend.js +176 -76
  1054. package/dist/view/sections/Trend.js.map +1 -1
  1055. package/dist/view/state.d.ts +42 -0
  1056. package/dist/view/state.js +93 -54
  1057. package/dist/view/state.js.map +1 -1
  1058. package/dist/view/useViewClock.js +31 -0
  1059. package/dist/view/useViewClock.js.map +1 -0
  1060. package/dist/view/useViewQueries.d.ts +21 -0
  1061. package/dist/view/useViewQueries.js +45 -77
  1062. package/dist/view/useViewQueries.js.map +1 -1
  1063. package/dist/view/useViewState.js +42 -0
  1064. package/dist/view/useViewState.js.map +1 -0
  1065. package/dist/view/useViewUrl.js +47 -0
  1066. package/dist/view/useViewUrl.js.map +1 -0
  1067. package/dist/view/viewBody.js +30 -0
  1068. package/dist/view/viewBody.js.map +1 -0
  1069. package/dist/view/viewContext.d.ts +81 -0
  1070. package/dist/view/viewContext.js +49 -0
  1071. package/dist/view/viewContext.js.map +1 -0
  1072. package/dist/view/viewProps.d.ts +64 -7
  1073. package/dist/view/viewProps.js +121 -35
  1074. package/dist/view/viewProps.js.map +1 -1
  1075. package/dist/widgets/AnalyticsBreakdownWidget.d.ts +7 -3
  1076. package/dist/widgets/AnalyticsBreakdownWidget.js +143 -118
  1077. package/dist/widgets/AnalyticsBreakdownWidget.js.map +1 -1
  1078. package/dist/widgets/AnalyticsGoalsWidget.d.ts +6 -7
  1079. package/dist/widgets/AnalyticsGoalsWidget.js +124 -167
  1080. package/dist/widgets/AnalyticsGoalsWidget.js.map +1 -1
  1081. package/dist/widgets/AnalyticsMetricWidget.d.ts +7 -3
  1082. package/dist/widgets/AnalyticsMetricWidget.js +80 -106
  1083. package/dist/widgets/AnalyticsMetricWidget.js.map +1 -1
  1084. package/dist/widgets/AnalyticsRealtimeWidget.d.ts +7 -3
  1085. package/dist/widgets/AnalyticsRealtimeWidget.js +74 -64
  1086. package/dist/widgets/AnalyticsRealtimeWidget.js.map +1 -1
  1087. package/dist/widgets/AnalyticsTrendWidget.d.ts +7 -3
  1088. package/dist/widgets/AnalyticsTrendWidget.js +129 -123
  1089. package/dist/widgets/AnalyticsTrendWidget.js.map +1 -1
  1090. package/dist/widgets/ComparisonDelta.js +33 -42
  1091. package/dist/widgets/ComparisonDelta.js.map +1 -1
  1092. package/dist/widgets/RealtimeCounter.d.ts +24 -4
  1093. package/dist/widgets/RealtimeCounter.js +91 -77
  1094. package/dist/widgets/RealtimeCounter.js.map +1 -1
  1095. package/dist/widgets/WidgetCard.d.ts +80 -0
  1096. package/dist/widgets/WidgetCard.js +99 -0
  1097. package/dist/widgets/WidgetCard.js.map +1 -0
  1098. package/dist/widgets/WidgetFrame.js +42 -0
  1099. package/dist/widgets/WidgetFrame.js.map +1 -0
  1100. package/dist/widgets/WidgetShimmer.d.ts +55 -0
  1101. package/dist/widgets/WidgetShimmer.js +86 -0
  1102. package/dist/widgets/WidgetShimmer.js.map +1 -0
  1103. package/dist/widgets/breakdownTypes.js +12 -2
  1104. package/dist/widgets/breakdownTypes.js.map +1 -1
  1105. package/dist/widgets/customWidget.d.ts +5 -1
  1106. package/dist/widgets/customWidget.js +6 -7
  1107. package/dist/widgets/customWidget.js.map +1 -1
  1108. package/dist/widgets/defaults.d.ts +4 -7
  1109. package/dist/widgets/defaults.js +4 -7
  1110. package/dist/widgets/defaults.js.map +1 -1
  1111. package/dist/widgets/fieldRows.js +14 -0
  1112. package/dist/widgets/fieldRows.js.map +1 -0
  1113. package/dist/widgets/filterCaption.js +6 -7
  1114. package/dist/widgets/filterCaption.js.map +1 -1
  1115. package/dist/widgets/filterField.d.ts +3 -7
  1116. package/dist/widgets/filterField.js +46 -35
  1117. package/dist/widgets/filterField.js.map +1 -1
  1118. package/dist/widgets/filterValueLabel.d.ts +1 -0
  1119. package/dist/widgets/filterValueLabel.js +45 -0
  1120. package/dist/widgets/filterValueLabel.js.map +1 -0
  1121. package/dist/widgets/notices.js +73 -0
  1122. package/dist/widgets/notices.js.map +1 -0
  1123. package/dist/widgets/prepareWidgetRead.d.ts +5 -1
  1124. package/dist/widgets/prepareWidgetRead.js +59 -27
  1125. package/dist/widgets/prepareWidgetRead.js.map +1 -1
  1126. package/dist/widgets/range.js +26 -21
  1127. package/dist/widgets/range.js.map +1 -1
  1128. package/dist/widgets/readForWidget.d.ts +27 -18
  1129. package/dist/widgets/readForWidget.js +31 -29
  1130. package/dist/widgets/readForWidget.js.map +1 -1
  1131. package/dist/widgets/readForWidgetBreakdown.d.ts +39 -28
  1132. package/dist/widgets/readForWidgetBreakdown.js +46 -22
  1133. package/dist/widgets/readForWidgetBreakdown.js.map +1 -1
  1134. package/dist/widgets/readForWidgetGoals.d.ts +17 -23
  1135. package/dist/widgets/readForWidgetGoals.js +50 -46
  1136. package/dist/widgets/readForWidgetGoals.js.map +1 -1
  1137. package/dist/widgets/readForWidgetRealtime.d.ts +21 -17
  1138. package/dist/widgets/readForWidgetRealtime.js +51 -27
  1139. package/dist/widgets/readForWidgetRealtime.js.map +1 -1
  1140. package/dist/widgets/readForWidgetSeries.d.ts +26 -31
  1141. package/dist/widgets/readForWidgetSeries.js +43 -82
  1142. package/dist/widgets/readForWidgetSeries.js.map +1 -1
  1143. package/dist/widgets/readMeta.d.ts +44 -0
  1144. package/dist/widgets/readMeta.js +47 -4
  1145. package/dist/widgets/readMeta.js.map +1 -1
  1146. package/dist/widgets/realtimePoll.d.ts +1 -0
  1147. package/dist/widgets/realtimePoll.js +53 -25
  1148. package/dist/widgets/realtimePoll.js.map +1 -1
  1149. package/dist/widgets/registerWidgets.js +204 -126
  1150. package/dist/widgets/registerWidgets.js.map +1 -1
  1151. package/dist/widgets/stateKeys.js +30 -0
  1152. package/dist/widgets/stateKeys.js.map +1 -0
  1153. package/dist/widgets/titleForecast.js +89 -0
  1154. package/dist/widgets/titleForecast.js.map +1 -0
  1155. package/dist/widgets/types.d.ts +4 -3
  1156. package/dist/widgets/types.js +2 -0
  1157. package/dist/widgets/types.js.map +1 -1
  1158. package/dist/widgets/viewLink.d.ts +24 -6
  1159. package/dist/widgets/viewLink.js +31 -24
  1160. package/dist/widgets/viewLink.js.map +1 -1
  1161. package/dist/widgets/widgetData.js +34 -0
  1162. package/dist/widgets/widgetData.js.map +1 -0
  1163. package/dist/widgets/widgetWindow.d.ts +1 -0
  1164. package/dist/widgets/widgetWindow.js +51 -0
  1165. package/dist/widgets/widgetWindow.js.map +1 -0
  1166. package/package.json +44 -22
  1167. package/dist/adapters/ga4/disableKey.d.ts +0 -9
  1168. package/dist/capture/getTrackerConfig.d.ts +0 -20
  1169. package/dist/capture/getTrackerConfig.js +0 -31
  1170. package/dist/capture/getTrackerConfig.js.map +0 -1
  1171. package/dist/capture/slots.d.ts +0 -8
  1172. package/dist/capture/trackerConfig.d.ts +0 -33
  1173. package/dist/charts/styles.js +0 -59
  1174. package/dist/charts/styles.js.map +0 -1
  1175. package/dist/fields/config/SourceSelectField.d.ts +0 -14
  1176. package/dist/fields/dateRange/styles.js +0 -23
  1177. package/dist/fields/dateRange/styles.js.map +0 -1
  1178. package/dist/goals/GoalSelectField.d.ts +0 -7
  1179. package/dist/native/collections/events.js +0 -165
  1180. package/dist/native/collections/events.js.map +0 -1
  1181. package/dist/native/collections/rollups.js +0 -151
  1182. package/dist/native/collections/rollups.js.map +0 -1
  1183. package/dist/native/collections/seen.js +0 -47
  1184. package/dist/native/collections/seen.js.map +0 -1
  1185. package/dist/native/eventScan.js +0 -25
  1186. package/dist/native/eventScan.js.map +0 -1
  1187. package/dist/native/ingest/flushBatch.js +0 -60
  1188. package/dist/native/ingest/flushBatch.js.map +0 -1
  1189. package/dist/native/ingest/salt.js +0 -39
  1190. package/dist/native/ingest/salt.js.map +0 -1
  1191. package/dist/native/ingest/writeBuffer.js +0 -55
  1192. package/dist/native/ingest/writeBuffer.js.map +0 -1
  1193. package/dist/native/ingest/writeEvent.js +0 -14
  1194. package/dist/native/ingest/writeEvent.js.map +0 -1
  1195. package/dist/native/query/eventAgg.js +0 -175
  1196. package/dist/native/query/eventAgg.js.map +0 -1
  1197. package/dist/native/realtime/buildRealtime.js +0 -53
  1198. package/dist/native/realtime/buildRealtime.js.map +0 -1
  1199. package/dist/native/retention/pruneTask.js +0 -69
  1200. package/dist/native/retention/pruneTask.js.map +0 -1
  1201. package/dist/native/rollupAcc.js +0 -64
  1202. package/dist/native/rollupAcc.js.map +0 -1
  1203. package/dist/native/rollups/bucketKey.js +0 -15
  1204. package/dist/native/rollups/bucketKey.js.map +0 -1
  1205. package/dist/native/rollups/bumpRollups.js +0 -116
  1206. package/dist/native/rollups/bumpRollups.js.map +0 -1
  1207. package/dist/native/rollups/deltas.js +0 -106
  1208. package/dist/native/rollups/deltas.js.map +0 -1
  1209. package/dist/native/rollups/insertManyIfNew.js +0 -93
  1210. package/dist/native/rollups/insertManyIfNew.js.map +0 -1
  1211. package/dist/plugin/paths.js +0 -29
  1212. package/dist/plugin/paths.js.map +0 -1
  1213. package/dist/react/TrackerBoot.d.ts +0 -22
  1214. package/dist/rsc/AnalyticsScripts.d.ts +0 -30
  1215. package/dist/rsc/AnalyticsScripts.js +0 -41
  1216. package/dist/rsc/AnalyticsScripts.js.map +0 -1
  1217. package/dist/surfacing/queue.js +0 -60
  1218. package/dist/surfacing/queue.js.map +0 -1
  1219. package/dist/surfacing/retryPolicy.js +0 -15
  1220. package/dist/surfacing/retryPolicy.js.map +0 -1
  1221. package/dist/tracker/autoCapture.d.ts +0 -48
  1222. package/dist/tracker/consent.d.ts +0 -24
  1223. package/dist/tracker/consent.js +0 -48
  1224. package/dist/tracker/consent.js.map +0 -1
  1225. package/dist/tracker/loadScript.d.ts +0 -14
  1226. package/dist/tracker/pageTracking.d.ts +0 -17
  1227. package/dist/tracker/registry.d.ts +0 -27
  1228. package/dist/tracker/sinks/ga4.d.ts +0 -29
  1229. package/dist/tracker/sinks/native.d.ts +0 -22
  1230. package/dist/tracker/sinks/plausible.d.ts +0 -20
  1231. package/dist/tracker/sinks/posthog.d.ts +0 -18
  1232. package/dist/tracker/sinks/umami.d.ts +0 -18
  1233. package/dist/tracker/sinks/vendor.d.ts +0 -14
  1234. package/dist/view/sections/styles.js +0 -76
  1235. package/dist/view/sections/styles.js.map +0 -1
  1236. package/dist/widgets/WidgetViewLink.js +0 -17
  1237. package/dist/widgets/WidgetViewLink.js.map +0 -1
  1238. package/dist/widgets/cardChrome.d.ts +0 -8
  1239. package/dist/widgets/cardChrome.js +0 -46
  1240. package/dist/widgets/cardChrome.js.map +0 -1
  1241. package/dist/widgets/comparison.js +0 -57
  1242. package/dist/widgets/comparison.js.map +0 -1
@@ -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,73 @@
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.stale) texts.push(t(keys.viewStale));
46
+ if (flags.hostRefused) texts.push(t(keys.viewErrorHostRefused));
47
+ else if (flags.sourceError) texts.push(t(keys.viewErrorMisconfigured));
48
+ if (flags.timezoneUnresolved) texts.push(t(keys.stateTimezoneUnresolved));
49
+ if (flags.partial) texts.push(t(keys.statePartial));
50
+ if (flags.capped) texts.push(t(keys.stateCapped));
51
+ if (flags.failed) texts.push(t(keys.stateFailed));
52
+ if (flags.clamped) texts.push(clampedText(flags, context));
53
+ if (flags.filtersUnapplied) texts.push(t(keys.stateFiltersUnapplied));
54
+ if (flags.sampled) texts.push(t(keys.stateSampled));
55
+ const currencies = flags.mixedCurrencies ?? [];
56
+ if (currencies.length > 1) {
57
+ const named = listFormat(context.locale, { type: "conjunction" }).format(currencies);
58
+ texts.push(t(keys.stateMixedCurrencies, { currencies: named }));
59
+ }
60
+ if (flags.goalsUnresolved) texts.push(t(keys.stateGoalsUnresolved));
61
+ else if (flags.noGoals) texts.push(t(keys.stateNoGoals));
62
+ if (flags.asOf) texts.push(t(keys.stateUpdated, { ago: timeAgo(flags.asOf, context.now, context.locale) }));
63
+ return texts;
64
+ };
65
+ /**
66
+ * The caveats as one line: a card is a few centimetres tall, and notices stacked under it would
67
+ * push the number itself out of view.
68
+ */
69
+ const widgetNotice = (flags, context) => noticeTexts(flags, context).join(NOTICE_SEPARATOR);
70
+ //#endregion
71
+ export { noticeTexts, widgetNotice };
72
+
73
+ //# 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 { 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\t/** The read asked about goals and the scope declared none of its own. */\n\tnoGoals?: boolean\n}\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\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":";;;;AAqBA,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;CACzB,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,11 @@
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';
5
9
  //#endregion
6
10
  export { WidgetReadStatus };
7
11
  //# sourceMappingURL=prepareWidgetRead.d.ts.map
@@ -1,24 +1,42 @@
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 engine read of a prepared source, each metric asked under the name the source serves. */
18
+ const engineRead = ({ runtime, adapter }, timeframe) => (query) => readAsAsked((served) => runtime.engine.read(adapter, served, { timeframe }), query, adapter.capabilities.metrics);
19
+ /**
20
+ * The `scope` a result names for a link to it, only on a read the caller scoped itself: a needless
21
+ * one refuses every reader without `access.crossScope`.
12
22
  */
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
- });
23
+ const pinnedScope = (args, queryScope) => args.scope === void 0 || queryScope === void 0 ? {} : { scope: queryScope };
17
24
  /**
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.
25
+ * The previous window a read compares against: only when the install and the source both compare
26
+ * and the source still keeps data that far back.
27
+ */
28
+ const comparisonWindow = (read, now) => {
29
+ const { runtime, adapter, tz } = read;
30
+ if (!runtime.comparison || !comparisonOf(adapter.capabilities)) return;
31
+ const previous = previousWindow(read.dateRange, tz);
32
+ return previous && withinLookback(previous, adapter.capabilities.maxLookbackDays, {
33
+ tz,
34
+ now
35
+ }) ? previous : void 0;
36
+ };
37
+ /**
38
+ * Prologue every widget read shares: runtime, scope, adapter, timezone, window and capability
39
+ * gates. A refusal carries the widget's status and window, so a helper's failure is one spread.
22
40
  */
23
41
  const prepareWidgetRead = async (args) => {
24
42
  const { req, now } = args;
@@ -28,15 +46,18 @@ const prepareWidgetRead = async (args) => {
28
46
  runtime,
29
47
  req,
30
48
  adapterId: args.adapterId,
31
- scope: args.scope
49
+ ...readPrincipalOf(args)
32
50
  }) : { 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
- };
51
+ if (!runtime || !ctx.ok) {
52
+ const reason = ctx.ok ? void 0 : ctx.reason;
53
+ return {
54
+ ok: false,
55
+ status: reason === "no-access" || reason === "not-member" ? "no-access" : reason === "no-scope" ? "no-scope" : "unavailable",
56
+ adapterId: args.adapterId ?? "",
57
+ dateRange: windowIn(args.timezone),
58
+ tz: args.timezone ?? "UTC"
59
+ };
60
+ }
40
61
  const tz = args.timezone ?? await resolveTimezoneFor(runtime, req, ctx.scope);
41
62
  const dateRange = windowIn(tz);
42
63
  const adapter = ctx.adapter;
@@ -48,15 +69,23 @@ const prepareWidgetRead = async (args) => {
48
69
  tz
49
70
  });
50
71
  if (!adapter.isConfigured()) return refuse("not-configured");
51
- if (args.requires && !satisfiesCapabilities(adapter.capabilities, args.requires)) return refuse("unavailable");
72
+ if (args.range && exceedsRangeCap(args.range)) return refuse("range-too-long");
73
+ const filteredBy = (args.filters ?? []).map((filter) => filter.dimension).filter((dimension) => filterOperatorsFor(adapter.capabilities, dimension).length > 0);
74
+ const metrics = args.requires?.metrics?.map((m) => servedName(m, adapter.capabilities.metrics));
75
+ if (args.requires && !satisfiesCapabilities(adapter.capabilities, {
76
+ ...args.requires,
77
+ ...metrics ? { metrics } : {},
78
+ filters: [...args.requires.filters ?? [], ...filteredBy]
79
+ })) return refuse("unavailable");
52
80
  if (args.granularity && !supportsGranularity(adapter.capabilities, args.granularity)) return refuse("unavailable");
53
81
  if (!supportsFilters(adapter.capabilities, args.filters)) return refuse("filter-unsupported");
54
- const goalSlugs = args.goalSlugs ?? (args.goalRead ? await goalSlugsFor({
82
+ const resolved = args.goalSlugs === void 0 && args.goalRead ? await goalHintFor({
55
83
  runtime,
56
84
  req,
57
85
  scope: ctx.scope,
58
86
  ...args.goalRead(adapter)
59
- }) : void 0);
87
+ }) : void 0;
88
+ const goalSlugs = args.goalSlugs ?? resolved?.slugs;
60
89
  return {
61
90
  ok: true,
62
91
  runtime,
@@ -64,11 +93,14 @@ const prepareWidgetRead = async (args) => {
64
93
  tz,
65
94
  dateRange,
66
95
  scope: ctx.scope,
96
+ pin: ctx.pin,
97
+ builtinGoalSlugs: args.builtinGoalSlugs ?? resolved?.builtin ?? [],
98
+ goalNames: resolved?.names ?? [],
67
99
  ...ctx.queryScope === void 0 ? {} : { queryScope: ctx.queryScope },
68
100
  ...goalSlugs === void 0 ? {} : { goalSlugs }
69
101
  };
70
102
  };
71
103
  //#endregion
72
- export { prepareWidgetRead };
104
+ export { comparisonWindow, engineRead, pinnedScope, prepareWidgetRead };
73
105
 
74
106
  //# 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\ninterface PrepareWidgetReadBase {\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 }\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})\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...(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;;AA0ElD,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;CACxB,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,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
@@ -1 +1 @@
1
- {"version":3,"file":"range.js","names":[],"sources":["../../src/widgets/range.ts"],"sourcesContent":["import type { DateRange } from '../core/contract'\nimport { DATE_ONLY, parseDayOrInstant } from '../query/dates'\nimport { zonedCalendarDay } from '../timeframe/tz'\nimport type { WidgetRange } from './types'\n\nconst NOON_MS = 12 * 3_600_000\n\n/**\n * The calendar day a stored bound names. The `dayOnly` picker stores the picked day at the\n * admin browser's local midnight, so the instant lands on that day or the one before it in\n * UTC depending on the browser's offset; a 12-hour shift recovers the picked day for every\n * offset in (-12, +12]. Zones at +12:45 and beyond (Chatham in DST, Kiritimati) recover the\n * day before, and the uninhabited UTC-12 the day after.\n */\nconst pickedDay = (raw: string): string | null => {\n\tif (DATE_ONLY.test(raw)) {\n\t\treturn raw\n\t}\n\tconst instant = new Date(raw)\n\tif (Number.isNaN(instant.getTime())) {\n\t\treturn null\n\t}\n\treturn zonedCalendarDay(new Date(instant.getTime() + NOON_MS), 'UTC')\n}\n\n/**\n * Resolve a widget's explicit custom range to a concrete DateRange, or undefined when the\n * widget is on a relative preset, the custom range is incomplete, or either bound names no\n * real day (a corrupt or hand-set widgetData would otherwise reach the cache key and throw\n * on `toISOString`). The two picked days are read inclusively in `timezone`, the reporting\n * timezone the read resolves in: `from` at the first instant of its day, `to` at the last.\n */\nexport const resolveCustomRange = (\n\ttimeframe: string | undefined,\n\trange: WidgetRange | undefined,\n\ttimezone: string\n): DateRange | undefined => {\n\tif (timeframe !== 'custom' || !range?.from || !range?.to) {\n\t\treturn undefined\n\t}\n\tconst fromDay = pickedDay(range.from)\n\tconst toDay = pickedDay(range.to)\n\tif (!fromDay || !toDay) {\n\t\treturn undefined\n\t}\n\tconst start = parseDayOrInstant(fromDay, { timezone, edge: 'start' })\n\tconst end = parseDayOrInstant(toDay, { timezone, edge: 'end' })\n\tif (!start || !end) {\n\t\treturn undefined\n\t}\n\treturn { start, end }\n}\n\nconst formatDay = (d: Date, locale: string, timeZone: string): string =>\n\td.toLocaleDateString(locale, { month: 'short', day: 'numeric', year: 'numeric', timeZone })\n\n/**\n * Server-side caption for a custom range, e.g. \"Jun 1, 2026 - Jun 23, 2026\". Both bounds\n * render in the reporting timezone, so the caption names the days that were read rather\n * than the days the server's own zone would spell them as.\n */\nexport const formatRangeCaption = (range: DateRange, locale: string, timezone: string): string =>\n\t`${formatDay(range.start, locale, timezone)} - ${formatDay(range.end, locale, timezone)}`\n"],"mappings":";;;AAKA,MAAM,UAAU,KAAK;;;;;;;;AASrB,MAAM,aAAa,QAA+B;CACjD,IAAI,UAAU,KAAK,GAAG,GACrB,OAAO;CAER,MAAM,UAAU,IAAI,KAAK,GAAG;CAC5B,IAAI,OAAO,MAAM,QAAQ,QAAQ,CAAC,GACjC,OAAO;CAER,OAAO,iBAAiB,IAAI,KAAK,QAAQ,QAAQ,IAAI,OAAO,GAAG,KAAK;AACrE;;;;;;;;AASA,MAAa,sBACZ,WACA,OACA,aAC2B;CAC3B,IAAI,cAAc,YAAY,CAAC,OAAO,QAAQ,CAAC,OAAO,IACrD;CAED,MAAM,UAAU,UAAU,MAAM,IAAI;CACpC,MAAM,QAAQ,UAAU,MAAM,EAAE;CAChC,IAAI,CAAC,WAAW,CAAC,OAChB;CAED,MAAM,QAAQ,kBAAkB,SAAS;EAAE;EAAU,MAAM;CAAQ,CAAC;CACpE,MAAM,MAAM,kBAAkB,OAAO;EAAE;EAAU,MAAM;CAAM,CAAC;CAC9D,IAAI,CAAC,SAAS,CAAC,KACd;CAED,OAAO;EAAE;EAAO;CAAI;AACrB;AAEA,MAAM,aAAa,GAAS,QAAgB,aAC3C,EAAE,mBAAmB,QAAQ;CAAE,OAAO;CAAS,KAAK;CAAW,MAAM;CAAW;AAAS,CAAC;;;;;;AAO3F,MAAa,sBAAsB,OAAkB,QAAgB,aACpE,GAAG,UAAU,MAAM,OAAO,QAAQ,QAAQ,EAAE,KAAK,UAAU,MAAM,KAAK,QAAQ,QAAQ"}
1
+ {"version":3,"file":"range.js","names":[],"sources":["../../src/widgets/range.ts"],"sourcesContent":["import type { DateRange } from '../core/contract'\nimport { DATE_ONLY, parseDayOrInstant } from '../query/dates'\nimport { zonedCalendarDay } from '../timeframe/tz'\nimport { dateTimeFormat } from '../translations/intl'\nimport type { WidgetRange } from './types'\n\nconst NOON_MS = 12 * 3_600_000\n\n/**\n * Calendar day a stored bound names. The `dayOnly` picker stores the browser's local midnight,\n * so a 12-hour shift recovers the picked day for every offset in (-12, +12].\n */\nexport const pickedDay = (raw: string): string | null => {\n\tif (DATE_ONLY.test(raw)) {\n\t\treturn raw\n\t}\n\tconst instant = new Date(raw)\n\tif (Number.isNaN(instant.getTime())) {\n\t\treturn null\n\t}\n\treturn zonedCalendarDay(new Date(instant.getTime() + NOON_MS), 'UTC')\n}\n\n/**\n * A widget's custom range, inclusive in `timezone`; undefined on a preset, when incomplete, or\n * when a bound names no real day (corrupt widgetData would otherwise throw in the cache key).\n */\nexport const resolveCustomRange = (\n\ttimeframe: string | undefined,\n\trange: WidgetRange | undefined,\n\ttimezone: string\n): DateRange | undefined => {\n\tif (timeframe !== 'custom' || !range?.from || !range?.to) {\n\t\treturn undefined\n\t}\n\tconst fromDay = pickedDay(range.from)\n\tconst toDay = pickedDay(range.to)\n\tif (!fromDay || !toDay) {\n\t\treturn undefined\n\t}\n\tconst start = parseDayOrInstant(fromDay, { timezone, edge: 'start' })\n\tconst end = parseDayOrInstant(toDay, { timezone, edge: 'end' })\n\tif (!start || !end) {\n\t\treturn undefined\n\t}\n\treturn { start, end }\n}\n\n/**\n * Whether a custom range sets both bounds yet one names no real day or a day before 1970: the\n * widget says the read is invalid rather than reading the last 30 days in its place.\n */\nexport const isUnreadableCustomRange = (\n\ttimeframe: string | undefined,\n\trange: WidgetRange | undefined\n): boolean =>\n\ttimeframe === 'custom' &&\n\tBoolean(range?.from && range?.to) &&\n\tresolveCustomRange(timeframe, range, 'UTC') === undefined\n\n/**\n * Caption for a range as the language writes a span of days (\"Jun 1 to 23, 2026\"), in the\n * reporting timezone so it names the days that were read, not the server zone's.\n */\nexport const formatRangeCaption = (range: DateRange, locale: string, timezone: string): string => {\n\tconst format = dateTimeFormat(locale, {\n\t\tmonth: 'short',\n\t\tday: 'numeric',\n\t\tyear: 'numeric',\n\t\ttimeZone: timezone,\n\t})\n\ttry {\n\t\t// Node's ICU writes thin spaces around the span's dash where browsers write plain ones, and\n\t\t// the toolbar renders on both sides of a hydration.\n\t\treturn format.formatRange(range.start, range.end).replace(/[\\u2009\\u202f]/g, ' ')\n\t} catch {\n\t\treturn `${format.format(range.start)} - ${format.format(range.end)}`\n\t}\n}\n"],"mappings":";;;;AAMA,MAAM,UAAU,KAAK;;;;;AAMrB,MAAa,aAAa,QAA+B;CACxD,IAAI,UAAU,KAAK,GAAG,GACrB,OAAO;CAER,MAAM,UAAU,IAAI,KAAK,GAAG;CAC5B,IAAI,OAAO,MAAM,QAAQ,QAAQ,CAAC,GACjC,OAAO;CAER,OAAO,iBAAiB,IAAI,KAAK,QAAQ,QAAQ,IAAI,OAAO,GAAG,KAAK;AACrE;;;;;AAMA,MAAa,sBACZ,WACA,OACA,aAC2B;CAC3B,IAAI,cAAc,YAAY,CAAC,OAAO,QAAQ,CAAC,OAAO,IACrD;CAED,MAAM,UAAU,UAAU,MAAM,IAAI;CACpC,MAAM,QAAQ,UAAU,MAAM,EAAE;CAChC,IAAI,CAAC,WAAW,CAAC,OAChB;CAED,MAAM,QAAQ,kBAAkB,SAAS;EAAE;EAAU,MAAM;CAAQ,CAAC;CACpE,MAAM,MAAM,kBAAkB,OAAO;EAAE;EAAU,MAAM;CAAM,CAAC;CAC9D,IAAI,CAAC,SAAS,CAAC,KACd;CAED,OAAO;EAAE;EAAO;CAAI;AACrB;;;;;AAMA,MAAa,2BACZ,WACA,UAEA,cAAc,YACd,QAAQ,OAAO,QAAQ,OAAO,EAAE,KAChC,mBAAmB,WAAW,OAAO,KAAK,MAAM,KAAA;;;;;AAMjD,MAAa,sBAAsB,OAAkB,QAAgB,aAA6B;CACjG,MAAM,SAAS,eAAe,QAAQ;EACrC,OAAO;EACP,KAAK;EACL,MAAM;EACN,UAAU;CACX,CAAC;CACD,IAAI;EAGH,OAAO,OAAO,YAAY,MAAM,OAAO,MAAM,GAAG,EAAE,QAAQ,mBAAmB,GAAG;CACjF,QAAQ;EACP,OAAO,GAAG,OAAO,OAAO,MAAM,KAAK,EAAE,KAAK,OAAO,OAAO,MAAM,GAAG;CAClE;AACD"}