@10x-media/analytics 1.0.0-beta.8 → 4.0.0-alpha.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (1273) hide show
  1. package/CHANGELOG.md +780 -0
  2. package/LICENSE +21 -21
  3. package/README.md +35 -36
  4. package/dist/access/adminUser.d.ts +15 -0
  5. package/dist/access/adminUser.js +13 -0
  6. package/dist/access/adminUser.js.map +1 -0
  7. package/dist/access/decideOnce.js +16 -0
  8. package/dist/access/decideOnce.js.map +1 -0
  9. package/dist/access/membership.d.ts +23 -0
  10. package/dist/access/membership.js +63 -0
  11. package/dist/access/membership.js.map +1 -0
  12. package/dist/access/principal.d.ts +37 -0
  13. package/dist/access/principal.js +29 -0
  14. package/dist/access/principal.js.map +1 -0
  15. package/dist/access/readGate.js +16 -0
  16. package/dist/access/readGate.js.map +1 -0
  17. package/dist/adapters/ga4/disableKey.js +19 -0
  18. package/dist/adapters/ga4/disableKey.js.map +1 -0
  19. package/dist/adapters/ga4/eventName.d.ts +9 -0
  20. package/dist/adapters/ga4/eventName.js +13 -0
  21. package/dist/adapters/ga4/eventName.js.map +1 -0
  22. package/dist/adapters/ga4/ga4.d.ts +29 -0
  23. package/dist/adapters/ga4/ga4.js +324 -112
  24. package/dist/adapters/ga4/ga4.js.map +1 -1
  25. package/dist/adapters/ga4/measurementId.js +14 -0
  26. package/dist/adapters/ga4/measurementId.js.map +1 -0
  27. package/dist/adapters/goalRead.js +112 -0
  28. package/dist/adapters/goalRead.js.map +1 -0
  29. package/dist/adapters/http/baseUrl.js +15 -0
  30. package/dist/adapters/http/baseUrl.js.map +1 -0
  31. package/dist/adapters/http/fetchJson.d.ts +19 -0
  32. package/dist/adapters/http/fetchJson.js +27 -8
  33. package/dist/adapters/http/fetchJson.js.map +1 -1
  34. package/dist/adapters/mapping.js +52 -0
  35. package/dist/adapters/mapping.js.map +1 -0
  36. package/dist/adapters/plausible/plausible.d.ts +30 -3
  37. package/dist/adapters/plausible/plausible.js +198 -110
  38. package/dist/adapters/plausible/plausible.js.map +1 -1
  39. package/dist/adapters/plausible/scriptId.js +19 -0
  40. package/dist/adapters/plausible/scriptId.js.map +1 -0
  41. package/dist/adapters/posthog/posthog.d.ts +33 -9
  42. package/dist/adapters/posthog/posthog.js +307 -127
  43. package/dist/adapters/posthog/posthog.js.map +1 -1
  44. package/dist/adapters/posthog/projectCheck.js +56 -0
  45. package/dist/adapters/posthog/projectCheck.js.map +1 -0
  46. package/dist/adapters/readTime.js +7 -0
  47. package/dist/adapters/readTime.js.map +1 -0
  48. package/dist/adapters/series.js +14 -8
  49. package/dist/adapters/series.js.map +1 -1
  50. package/dist/adapters/umami/umami.d.ts +21 -3
  51. package/dist/adapters/umami/umami.js +334 -95
  52. package/dist/adapters/umami/umami.js.map +1 -1
  53. package/dist/adapters/upstream.js +16 -0
  54. package/dist/adapters/upstream.js.map +1 -0
  55. package/dist/binding/report.d.ts +8 -0
  56. package/dist/binding/report.js +24 -0
  57. package/dist/binding/report.js.map +1 -0
  58. package/dist/binding/resolvePath.js +28 -25
  59. package/dist/binding/resolvePath.js.map +1 -1
  60. package/dist/binding/types.d.ts +14 -29
  61. package/dist/capture/captureRequest.js +28 -0
  62. package/dist/capture/captureRequest.js.map +1 -0
  63. package/dist/capture/exclusionEndpoint.js +98 -0
  64. package/dist/capture/exclusionEndpoint.js.map +1 -0
  65. package/dist/capture/exclusionPrelude.js +14 -0
  66. package/dist/capture/exclusionPrelude.js.map +1 -0
  67. package/dist/capture/exclusionToken.js +23 -0
  68. package/dist/capture/exclusionToken.js.map +1 -0
  69. package/dist/capture/jsLiteral.js +19 -0
  70. package/dist/capture/jsLiteral.js.map +1 -0
  71. package/dist/capture/mountPath.js +2 -3
  72. package/dist/capture/mountPath.js.map +1 -1
  73. package/dist/capture/proxyEndpoint.js +49 -92
  74. package/dist/capture/proxyEndpoint.js.map +1 -1
  75. package/dist/capture/proxyRoutes.js +58 -21
  76. package/dist/capture/proxyRoutes.js.map +1 -1
  77. package/dist/capture/relay.js +91 -0
  78. package/dist/capture/relay.js.map +1 -0
  79. package/dist/capture/requestBody.js +2 -6
  80. package/dist/capture/requestBody.js.map +1 -1
  81. package/dist/capture/requestTrust.js +45 -0
  82. package/dist/capture/requestTrust.js.map +1 -0
  83. package/dist/capture/sameSite.js +40 -0
  84. package/dist/capture/sameSite.js.map +1 -0
  85. package/dist/capture/slots.js +50 -25
  86. package/dist/capture/slots.js.map +1 -1
  87. package/dist/capture/trackerConfig.js +131 -36
  88. package/dist/capture/trackerConfig.js.map +1 -1
  89. package/dist/capture/trackerEndpoint.js +22 -21
  90. package/dist/capture/trackerEndpoint.js.map +1 -1
  91. package/dist/capture/withoutConsent.js +91 -0
  92. package/dist/capture/withoutConsent.js.map +1 -0
  93. package/dist/charts/BarList.d.ts +27 -13
  94. package/dist/charts/BarList.js +38 -77
  95. package/dist/charts/BarList.js.map +1 -1
  96. package/dist/charts/TrendChart.d.ts +40 -7
  97. package/dist/charts/TrendChart.js +243 -215
  98. package/dist/charts/TrendChart.js.map +1 -1
  99. package/dist/charts/bars.d.ts +17 -1
  100. package/dist/charts/bars.js +12 -11
  101. package/dist/charts/bars.js.map +1 -1
  102. package/dist/charts/bucket.js +106 -73
  103. package/dist/charts/bucket.js.map +1 -1
  104. package/dist/charts/inProgress.js +22 -0
  105. package/dist/charts/inProgress.js.map +1 -0
  106. package/dist/charts/series.d.ts +15 -0
  107. package/dist/charts/series.js +123 -0
  108. package/dist/charts/series.js.map +1 -0
  109. package/dist/charts/spline.js +91 -25
  110. package/dist/charts/spline.js.map +1 -1
  111. package/dist/charts/trendGeometry.js +91 -0
  112. package/dist/charts/trendGeometry.js.map +1 -0
  113. package/dist/core/adminOptions.d.ts +1 -0
  114. package/dist/core/adminOptions.js +198 -0
  115. package/dist/core/adminOptions.js.map +1 -0
  116. package/dist/core/budget.js +24 -0
  117. package/dist/core/budget.js.map +1 -0
  118. package/dist/core/cacheKey.d.ts +1 -0
  119. package/dist/core/cacheKey.js +51 -29
  120. package/dist/core/cacheKey.js.map +1 -1
  121. package/dist/core/cacheOptions.js +165 -0
  122. package/dist/core/cacheOptions.js.map +1 -0
  123. package/dist/core/capabilities.d.ts +24 -11
  124. package/dist/core/capabilities.js +101 -17
  125. package/dist/core/capabilities.js.map +1 -1
  126. package/dist/core/capture.d.ts +59 -26
  127. package/dist/core/captureOptions.d.ts +1 -0
  128. package/dist/core/captureOptions.js +347 -0
  129. package/dist/core/captureOptions.js.map +1 -0
  130. package/dist/core/clock.js +13 -0
  131. package/dist/core/clock.js.map +1 -0
  132. package/dist/core/collectionOption.d.ts +17 -0
  133. package/dist/core/collectionOption.js +105 -0
  134. package/dist/core/collectionOption.js.map +1 -0
  135. package/dist/core/collectionSlug.js +7 -0
  136. package/dist/core/collectionSlug.js.map +1 -0
  137. package/dist/core/contract.d.ts +340 -49
  138. package/dist/core/contract.js +7 -4
  139. package/dist/core/contract.js.map +1 -1
  140. package/dist/core/cron.js +57 -0
  141. package/dist/core/cron.js.map +1 -0
  142. package/dist/core/fetch.d.ts +17 -0
  143. package/dist/core/goalOptions.d.ts +1 -0
  144. package/dist/core/goalOptions.js +166 -0
  145. package/dist/core/goalOptions.js.map +1 -0
  146. package/dist/core/granularity.js +3 -2
  147. package/dist/core/granularity.js.map +1 -1
  148. package/dist/core/guards.js +17 -0
  149. package/dist/core/guards.js.map +1 -0
  150. package/dist/core/jobs.d.ts +40 -0
  151. package/dist/core/jobs.js +132 -0
  152. package/dist/core/jobs.js.map +1 -0
  153. package/dist/core/legacyOptions.js +145 -0
  154. package/dist/core/legacyOptions.js.map +1 -0
  155. package/dist/core/metricAliases.js +81 -0
  156. package/dist/core/metricAliases.js.map +1 -0
  157. package/dist/core/metricValues.js +57 -0
  158. package/dist/core/metricValues.js.map +1 -0
  159. package/dist/core/monotonic.js +10 -0
  160. package/dist/core/monotonic.js.map +1 -0
  161. package/dist/core/optionChecks.js +51 -0
  162. package/dist/core/optionChecks.js.map +1 -0
  163. package/dist/core/options.d.ts +535 -151
  164. package/dist/core/options.js +158 -214
  165. package/dist/core/options.js.map +1 -1
  166. package/dist/core/registry.js +45 -5
  167. package/dist/core/registry.js.map +1 -1
  168. package/dist/core/scopeList.js +7 -9
  169. package/dist/core/scopeList.js.map +1 -1
  170. package/dist/core/scopeOptions.d.ts +1 -0
  171. package/dist/core/scopeOptions.js +114 -0
  172. package/dist/core/scopeOptions.js.map +1 -0
  173. package/dist/core/scopedRead.js +349 -36
  174. package/dist/core/scopedRead.js.map +1 -1
  175. package/dist/core/sdks.d.ts +81 -0
  176. package/dist/core/sdks.js +23 -0
  177. package/dist/core/sdks.js.map +1 -0
  178. package/dist/core/serverEvent.d.ts +50 -14
  179. package/dist/core/serverEvent.js.map +1 -1
  180. package/dist/core/siteAddress.js +20 -0
  181. package/dist/core/siteAddress.js.map +1 -0
  182. package/dist/core/sourceErrors.js +109 -0
  183. package/dist/core/sourceErrors.js.map +1 -0
  184. package/dist/core/sourceLabel.d.ts +10 -0
  185. package/dist/core/sourceLabel.js +63 -0
  186. package/dist/core/sourceLabel.js.map +1 -0
  187. package/dist/core/sourceOptions.js +107 -0
  188. package/dist/core/sourceOptions.js.map +1 -0
  189. package/dist/core/sourcePolicy.d.ts +55 -0
  190. package/dist/core/sourcePolicy.js +51 -0
  191. package/dist/core/sourcePolicy.js.map +1 -0
  192. package/dist/core/throttle.js +18 -0
  193. package/dist/core/throttle.js.map +1 -0
  194. package/dist/core/values.js +61 -0
  195. package/dist/core/values.js.map +1 -0
  196. package/dist/core/widgetSlugs.d.ts +17 -0
  197. package/dist/core/widgetSlugs.js +29 -0
  198. package/dist/core/widgetSlugs.js.map +1 -0
  199. package/dist/db/detachedWrite.js +36 -0
  200. package/dist/db/detachedWrite.js.map +1 -0
  201. package/dist/db/errors.js +182 -0
  202. package/dist/db/errors.js.map +1 -0
  203. package/dist/db/kind.js +32 -0
  204. package/dist/db/kind.js.map +1 -0
  205. package/dist/db/openTransaction.js +51 -0
  206. package/dist/db/openTransaction.js.map +1 -0
  207. package/dist/exports/adapters/contract.d.ts +15 -0
  208. package/dist/exports/adapters/ga4.d.ts +17 -1
  209. package/dist/exports/adapters/ga4.js +2 -1
  210. package/dist/exports/adapters/native.d.ts +29 -2
  211. package/dist/exports/adapters/native.js +5 -1
  212. package/dist/exports/adapters/plausible.d.ts +16 -1
  213. package/dist/exports/adapters/posthog.d.ts +16 -1
  214. package/dist/exports/adapters/umami.d.ts +16 -1
  215. package/dist/exports/attributes.d.ts +42 -0
  216. package/dist/exports/attributes.js +83 -0
  217. package/dist/exports/attributes.js.map +1 -0
  218. package/dist/exports/client.d.ts +45 -11
  219. package/dist/exports/client.js +23 -6
  220. package/dist/exports/geo.d.ts +4 -2
  221. package/dist/exports/geo.js +1 -1
  222. package/dist/exports/i18n.d.ts +2 -2
  223. package/dist/exports/i18n.js +2 -2
  224. package/dist/exports/migrations.d.ts +2 -0
  225. package/dist/exports/migrations.js +2 -0
  226. package/dist/exports/react.d.ts +5 -3
  227. package/dist/exports/react.js +1 -2
  228. package/dist/exports/routes.d.ts +19 -0
  229. package/dist/exports/routes.js +3 -0
  230. package/dist/exports/rsc.d.ts +33 -14
  231. package/dist/exports/rsc.js +11 -6
  232. package/dist/exports/site.d.ts +5 -0
  233. package/dist/exports/site.js +3 -0
  234. package/dist/exports/testing.d.ts +18 -0
  235. package/dist/exports/testing.js +3 -0
  236. package/dist/exports/tracker.d.ts +6 -17
  237. package/dist/exports/tracker.js +3 -11
  238. package/dist/exports/types.d.ts +46 -14
  239. package/dist/exports/types.js +7 -1
  240. package/dist/fields/AnalyticsPanelClient.js +265 -154
  241. package/dist/fields/AnalyticsPanelClient.js.map +1 -1
  242. package/dist/fields/AnalyticsPanelField.d.ts +19 -7
  243. package/dist/fields/AnalyticsPanelField.js +123 -30
  244. package/dist/fields/AnalyticsPanelField.js.map +1 -1
  245. package/dist/fields/AnalyticsStatField.d.ts +17 -6
  246. package/dist/fields/AnalyticsStatField.js +98 -63
  247. package/dist/fields/AnalyticsStatField.js.map +1 -1
  248. package/dist/fields/FieldShimmer.js +15 -0
  249. package/dist/fields/FieldShimmer.js.map +1 -0
  250. package/dist/fields/PanelContent.js +222 -0
  251. package/dist/fields/PanelContent.js.map +1 -0
  252. package/dist/fields/PanelList.js +82 -0
  253. package/dist/fields/PanelList.js.map +1 -0
  254. package/dist/fields/PanelLiveCounter.js +63 -0
  255. package/dist/fields/PanelLiveCounter.js.map +1 -0
  256. package/dist/fields/PanelSkeleton.js +63 -0
  257. package/dist/fields/PanelSkeleton.js.map +1 -0
  258. package/dist/fields/componentPaths.js +8 -0
  259. package/dist/fields/componentPaths.js.map +1 -0
  260. package/dist/fields/config/FilterDimensionSelectField.d.ts +14 -0
  261. package/dist/fields/config/FilterDimensionSelectField.js +49 -0
  262. package/dist/fields/config/FilterDimensionSelectField.js.map +1 -0
  263. package/dist/fields/config/FilterKeySelect.js +66 -0
  264. package/dist/fields/config/FilterKeySelect.js.map +1 -0
  265. package/dist/fields/config/FilterOperatorSelectField.d.ts +19 -0
  266. package/dist/fields/config/FilterOperatorSelectField.js +59 -0
  267. package/dist/fields/config/FilterOperatorSelectField.js.map +1 -0
  268. package/dist/fields/config/FilterValueField.d.ts +17 -0
  269. package/dist/fields/config/FilterValueField.js +130 -0
  270. package/dist/fields/config/FilterValueField.js.map +1 -0
  271. package/dist/fields/config/MetricSelectField.d.ts +5 -12
  272. package/dist/fields/config/MetricSelectField.js +19 -31
  273. package/dist/fields/config/MetricSelectField.js.map +1 -1
  274. package/dist/fields/config/OptionSelect.js +52 -0
  275. package/dist/fields/config/OptionSelect.js.map +1 -0
  276. package/dist/fields/config/SourceSelectField.js +16 -31
  277. package/dist/fields/config/SourceSelectField.js.map +1 -1
  278. package/dist/fields/config/fetchSources.d.ts +3 -0
  279. package/dist/fields/config/fetchSources.js +17 -23
  280. package/dist/fields/config/fetchSources.js.map +1 -1
  281. package/dist/fields/config/filterValues.js +106 -0
  282. package/dist/fields/config/filterValues.js.map +1 -0
  283. package/dist/fields/config/narrow.js +8 -10
  284. package/dist/fields/config/narrow.js.map +1 -1
  285. package/dist/fields/config/retiredPickers.d.ts +45 -0
  286. package/dist/fields/config/retiredPickers.js +46 -0
  287. package/dist/fields/config/retiredPickers.js.map +1 -0
  288. package/dist/fields/config/scopedFields.d.ts +40 -0
  289. package/dist/fields/config/scopedFields.js +68 -0
  290. package/dist/fields/config/scopedFields.js.map +1 -0
  291. package/dist/fields/config/sourcesState.js +19 -3
  292. package/dist/fields/config/sourcesState.js.map +1 -1
  293. package/dist/fields/config/toSelectOption.js +13 -7
  294. package/dist/fields/config/toSelectOption.js.map +1 -1
  295. package/dist/fields/config/useAnalyticsSources.d.ts +10 -7
  296. package/dist/fields/config/useAnalyticsSources.js +23 -24
  297. package/dist/fields/config/useAnalyticsSources.js.map +1 -1
  298. package/dist/fields/config/useFilterCapabilities.d.ts +31 -0
  299. package/dist/fields/config/useFilterCapabilities.js +60 -0
  300. package/dist/fields/config/useFilterCapabilities.js.map +1 -0
  301. package/dist/fields/config/useFormString.js +12 -0
  302. package/dist/fields/config/useFormString.js.map +1 -0
  303. package/dist/fields/dateRange/field.js +7 -19
  304. package/dist/fields/dateRange/field.js.map +1 -1
  305. package/dist/fields/dateRange/types.d.ts +5 -1
  306. package/dist/fields/dateRange/ui.d.ts +3 -2
  307. package/dist/fields/dateRange/ui.js +57 -319
  308. package/dist/fields/dateRange/ui.js.map +1 -1
  309. package/dist/fields/documentScope.js +21 -0
  310. package/dist/fields/documentScope.js.map +1 -0
  311. package/dist/fields/emptyState.js +30 -26
  312. package/dist/fields/emptyState.js.map +1 -1
  313. package/dist/fields/factories.d.ts +35 -16
  314. package/dist/fields/factories.js +67 -38
  315. package/dist/fields/factories.js.map +1 -1
  316. package/dist/fields/format.d.ts +12 -3
  317. package/dist/fields/format.js +77 -13
  318. package/dist/fields/format.js.map +1 -1
  319. package/dist/fields/itemReport.js +45 -0
  320. package/dist/fields/itemReport.js.map +1 -0
  321. package/dist/fields/readForDocument.d.ts +79 -26
  322. package/dist/fields/readForDocument.js +451 -105
  323. package/dist/fields/readForDocument.js.map +1 -1
  324. package/dist/fields/stateKeys.js +20 -0
  325. package/dist/fields/stateKeys.js.map +1 -0
  326. package/dist/goals/GoalAmountField.d.ts +10 -0
  327. package/dist/goals/GoalAmountField.js +179 -0
  328. package/dist/goals/GoalAmountField.js.map +1 -0
  329. package/dist/goals/GoalSelectField.js +89 -40
  330. package/dist/goals/GoalSelectField.js.map +1 -1
  331. package/dist/goals/GoalSelectFieldServer.d.ts +13 -0
  332. package/dist/goals/GoalSelectFieldServer.js +21 -0
  333. package/dist/goals/GoalSelectFieldServer.js.map +1 -0
  334. package/dist/goals/amountField.d.ts +20 -0
  335. package/dist/goals/amountField.js +37 -0
  336. package/dist/goals/amountField.js.map +1 -0
  337. package/dist/goals/builtin.js +17 -0
  338. package/dist/goals/builtin.js.map +1 -0
  339. package/dist/goals/collection.d.ts +22 -0
  340. package/dist/goals/collection.js +143 -124
  341. package/dist/goals/collection.js.map +1 -1
  342. package/dist/goals/constants.d.ts +38 -0
  343. package/dist/goals/constants.js +49 -0
  344. package/dist/goals/constants.js.map +1 -0
  345. package/dist/goals/currency.d.ts +16 -0
  346. package/dist/goals/currency.js +46 -4
  347. package/dist/goals/currency.js.map +1 -1
  348. package/dist/goals/currencyOptions.js +70 -0
  349. package/dist/goals/currencyOptions.js.map +1 -0
  350. package/dist/goals/fetchGoals.d.ts +10 -0
  351. package/dist/goals/fetchGoals.js +12 -22
  352. package/dist/goals/fetchGoals.js.map +1 -1
  353. package/dist/goals/goalField.d.ts +4 -6
  354. package/dist/goals/goalField.js +9 -19
  355. package/dist/goals/goalField.js.map +1 -1
  356. package/dist/goals/goalsEndpoint.js +40 -38
  357. package/dist/goals/goalsEndpoint.js.map +1 -1
  358. package/dist/goals/items.js +35 -0
  359. package/dist/goals/items.js.map +1 -0
  360. package/dist/goals/latent.js +9 -0
  361. package/dist/goals/latent.js.map +1 -0
  362. package/dist/goals/linkFields.d.ts +35 -0
  363. package/dist/goals/linkFields.js +31 -0
  364. package/dist/goals/linkFields.js.map +1 -0
  365. package/dist/goals/match.d.ts +14 -0
  366. package/dist/goals/match.js +67 -46
  367. package/dist/goals/match.js.map +1 -1
  368. package/dist/goals/moneyFields.js +56 -0
  369. package/dist/goals/moneyFields.js.map +1 -0
  370. package/dist/goals/pathMatch.js +122 -0
  371. package/dist/goals/pathMatch.js.map +1 -0
  372. package/dist/goals/placeholder.js +12 -0
  373. package/dist/goals/placeholder.js.map +1 -0
  374. package/dist/goals/resolver.d.ts +3 -3
  375. package/dist/goals/resolver.js +155 -47
  376. package/dist/goals/resolver.js.map +1 -1
  377. package/dist/goals/serverRevenue.d.ts +60 -0
  378. package/dist/goals/serverRevenue.js +41 -0
  379. package/dist/goals/serverRevenue.js.map +1 -0
  380. package/dist/goals/trackGoalAction.d.ts +26 -25
  381. package/dist/goals/trackGoalAction.js +71 -66
  382. package/dist/goals/trackGoalAction.js.map +1 -1
  383. package/dist/goals/types.d.ts +13 -28
  384. package/dist/goals/types.js +1 -1
  385. package/dist/goals/types.js.map +1 -1
  386. package/dist/goals/useAnalyticsGoals.d.ts +6 -5
  387. package/dist/goals/useAnalyticsGoals.js +17 -18
  388. package/dist/goals/useAnalyticsGoals.js.map +1 -1
  389. package/dist/index.d.ts +69 -11
  390. package/dist/index.js +262 -192
  391. package/dist/index.js.map +1 -1
  392. package/dist/items/collectionIdType.js +20 -0
  393. package/dist/items/collectionIdType.js.map +1 -0
  394. package/dist/items/idType.js +31 -0
  395. package/dist/items/idType.js.map +1 -0
  396. package/dist/items/ref.js +73 -0
  397. package/dist/items/ref.js.map +1 -0
  398. package/dist/maintenance/apiTaskState.js +141 -0
  399. package/dist/maintenance/apiTaskState.js.map +1 -0
  400. package/dist/maintenance/heartbeat.js +51 -0
  401. package/dist/maintenance/heartbeat.js.map +1 -0
  402. package/dist/maintenance/lease.d.ts +1 -0
  403. package/dist/maintenance/lease.js +79 -0
  404. package/dist/maintenance/lease.js.map +1 -0
  405. package/dist/maintenance/taskSchedule.js +27 -0
  406. package/dist/maintenance/taskSchedule.js.map +1 -0
  407. package/dist/maintenance/underLease.js +35 -0
  408. package/dist/maintenance/underLease.js.map +1 -0
  409. package/dist/migrations/legacy.d.ts +54 -0
  410. package/dist/migrations/legacy.js +117 -0
  411. package/dist/migrations/legacy.js.map +1 -0
  412. package/dist/migrations/predefined/dropLegacyMongo.d.ts +11 -0
  413. package/dist/migrations/predefined/dropLegacyMongo.js +12 -0
  414. package/dist/migrations/predefined/dropLegacyMongo.js.map +1 -0
  415. package/dist/native/collections/aggregates.js +54 -0
  416. package/dist/native/collections/aggregates.js.map +1 -0
  417. package/dist/native/collections/hits.js +103 -0
  418. package/dist/native/collections/hits.js.map +1 -0
  419. package/dist/native/collections/slugs.d.ts +10 -0
  420. package/dist/native/collections/slugs.js +16 -0
  421. package/dist/native/collections/slugs.js.map +1 -0
  422. package/dist/native/collections/state.js +84 -0
  423. package/dist/native/collections/state.js.map +1 -0
  424. package/dist/native/collections/storeCollection.js +31 -0
  425. package/dist/native/collections/storeCollection.js.map +1 -0
  426. package/dist/native/engine/buckets.d.ts +1 -0
  427. package/dist/native/engine/buckets.js +53 -0
  428. package/dist/native/engine/buckets.js.map +1 -0
  429. package/dist/native/engine/capabilities.js +87 -0
  430. package/dist/native/engine/capabilities.js.map +1 -0
  431. package/dist/native/engine/cost.js +72 -0
  432. package/dist/native/engine/cost.js.map +1 -0
  433. package/dist/native/engine/days.d.ts +1 -0
  434. package/dist/native/engine/days.js +182 -0
  435. package/dist/native/engine/days.js.map +1 -0
  436. package/dist/native/engine/engine.d.ts +1 -0
  437. package/dist/native/engine/engine.js +1627 -0
  438. package/dist/native/engine/engine.js.map +1 -0
  439. package/dist/native/engine/instance.js +58 -0
  440. package/dist/native/engine/instance.js.map +1 -0
  441. package/dist/native/engine/maintenance.d.ts +1 -0
  442. package/dist/native/engine/maintenance.js +677 -0
  443. package/dist/native/engine/maintenance.js.map +1 -0
  444. package/dist/native/engine/merge.js +41 -0
  445. package/dist/native/engine/merge.js.map +1 -0
  446. package/dist/native/engine/nudge.js +26 -0
  447. package/dist/native/engine/nudge.js.map +1 -0
  448. package/dist/native/engine/planner.js +199 -0
  449. package/dist/native/engine/planner.js.map +1 -0
  450. package/dist/native/engine/rebuild.d.ts +22 -0
  451. package/dist/native/engine/rebuild.js +76 -0
  452. package/dist/native/engine/rebuild.js.map +1 -0
  453. package/dist/native/engine/recent.js +17 -0
  454. package/dist/native/engine/recent.js.map +1 -0
  455. package/dist/native/engine/salt.d.ts +1 -0
  456. package/dist/native/engine/salt.js +98 -0
  457. package/dist/native/engine/salt.js.map +1 -0
  458. package/dist/native/engine/siteHosts.d.ts +1 -0
  459. package/dist/native/engine/siteHosts.js +58 -0
  460. package/dist/native/engine/siteHosts.js.map +1 -0
  461. package/dist/native/engine/toHit.js +110 -0
  462. package/dist/native/engine/toHit.js.map +1 -0
  463. package/dist/native/engine/writeBuffer.d.ts +14 -0
  464. package/dist/native/engine/writeBuffer.js +317 -0
  465. package/dist/native/engine/writeBuffer.js.map +1 -0
  466. package/dist/native/geo/composeGeoResolvers.d.ts +1 -0
  467. package/dist/native/geo/composeGeoResolvers.js +5 -2
  468. package/dist/native/geo/composeGeoResolvers.js.map +1 -1
  469. package/dist/native/geo/geoResolver.d.ts +27 -2
  470. package/dist/native/geo/geoResolver.js +42 -6
  471. package/dist/native/geo/geoResolver.js.map +1 -1
  472. package/dist/native/geo/maxmindResolver.d.ts +8 -4
  473. package/dist/native/geo/maxmindResolver.js +20 -16
  474. package/dist/native/geo/maxmindResolver.js.map +1 -1
  475. package/dist/native/geo/resolveGeo.js +31 -0
  476. package/dist/native/geo/resolveGeo.js.map +1 -0
  477. package/dist/native/ingest/bots.d.ts +10 -0
  478. package/dist/native/ingest/bots.js +66 -0
  479. package/dist/native/ingest/bots.js.map +1 -0
  480. package/dist/native/ingest/browser.js +45 -0
  481. package/dist/native/ingest/browser.js.map +1 -0
  482. package/dist/native/ingest/clientIp.js +34 -8
  483. package/dist/native/ingest/clientIp.js.map +1 -1
  484. package/dist/native/ingest/device.js +4 -6
  485. package/dist/native/ingest/device.js.map +1 -1
  486. package/dist/native/ingest/endpoint.d.ts +1 -1
  487. package/dist/native/ingest/endpoint.js +185 -32
  488. package/dist/native/ingest/endpoint.js.map +1 -1
  489. package/dist/native/ingest/itemSignature.d.ts +26 -0
  490. package/dist/native/ingest/itemSignature.js +45 -0
  491. package/dist/native/ingest/itemSignature.js.map +1 -0
  492. package/dist/native/ingest/language.js +13 -0
  493. package/dist/native/ingest/language.js.map +1 -0
  494. package/dist/native/ingest/normalizeEvent.d.ts +73 -5
  495. package/dist/native/ingest/normalizeEvent.js +257 -51
  496. package/dist/native/ingest/normalizeEvent.js.map +1 -1
  497. package/dist/native/ingest/orderSignature.d.ts +13 -0
  498. package/dist/native/ingest/orderSignature.js +50 -0
  499. package/dist/native/ingest/orderSignature.js.map +1 -0
  500. package/dist/native/ingest/referrer.js +46 -0
  501. package/dist/native/ingest/referrer.js.map +1 -0
  502. package/dist/native/ingest/requestHost.js +44 -0
  503. package/dist/native/ingest/requestHost.js.map +1 -0
  504. package/dist/native/ingest/resolveHostname.d.ts +20 -0
  505. package/dist/native/ingest/resolveHostname.js +51 -0
  506. package/dist/native/ingest/resolveHostname.js.map +1 -0
  507. package/dist/native/ingest/revenue.d.ts +1 -0
  508. package/dist/native/ingest/revenue.js +121 -0
  509. package/dist/native/ingest/revenue.js.map +1 -0
  510. package/dist/native/ingest/route.d.ts +10 -0
  511. package/dist/native/ingest/route.js +85 -0
  512. package/dist/native/ingest/route.js.map +1 -0
  513. package/dist/native/ingest/serverTrack.d.ts +2 -10
  514. package/dist/native/ingest/serverTrack.js +188 -68
  515. package/dist/native/ingest/serverTrack.js.map +1 -1
  516. package/dist/native/ingest/signature.js +28 -0
  517. package/dist/native/ingest/signature.js.map +1 -0
  518. package/dist/native/ingest/source.d.ts +10 -0
  519. package/dist/native/ingest/source.js +245 -16
  520. package/dist/native/ingest/source.js.map +1 -1
  521. package/dist/native/ingest/utm.js +33 -0
  522. package/dist/native/ingest/utm.js.map +1 -0
  523. package/dist/native/ingest/validate.js +25 -13
  524. package/dist/native/ingest/validate.js.map +1 -1
  525. package/dist/native/ingest/visitorHash.js +6 -8
  526. package/dist/native/ingest/visitorHash.js.map +1 -1
  527. package/dist/native/nativeAdapter.d.ts +128 -9
  528. package/dist/native/nativeAdapter.js +395 -281
  529. package/dist/native/nativeAdapter.js.map +1 -1
  530. package/dist/native/rebuildDays.d.ts +12 -0
  531. package/dist/native/rebuildDays.js +16 -0
  532. package/dist/native/rebuildDays.js.map +1 -0
  533. package/dist/native/store/aggregate.js +450 -0
  534. package/dist/native/store/aggregate.js.map +1 -0
  535. package/dist/native/store/caps.d.ts +18 -0
  536. package/dist/native/store/caps.js +76 -0
  537. package/dist/native/store/caps.js.map +1 -0
  538. package/dist/native/store/chunks.js +34 -0
  539. package/dist/native/store/chunks.js.map +1 -0
  540. package/dist/native/store/columnValues.js +31 -0
  541. package/dist/native/store/columnValues.js.map +1 -0
  542. package/dist/native/store/dialect.js +106 -0
  543. package/dist/native/store/dialect.js.map +1 -0
  544. package/dist/native/store/eventStore.js +44 -0
  545. package/dist/native/store/eventStore.js.map +1 -0
  546. package/dist/native/store/hitRow.js +119 -0
  547. package/dist/native/store/hitRow.js.map +1 -0
  548. package/dist/native/store/hits.js +65 -0
  549. package/dist/native/store/hits.js.map +1 -0
  550. package/dist/native/store/ids.js +105 -0
  551. package/dist/native/store/ids.js.map +1 -0
  552. package/dist/native/store/mongo/aggregatePipelines.js +438 -0
  553. package/dist/native/store/mongo/aggregatePipelines.js.map +1 -0
  554. package/dist/native/store/mongo/mongoState.js +375 -0
  555. package/dist/native/store/mongo/mongoState.js.map +1 -0
  556. package/dist/native/store/mongo/mongoStore.js +618 -0
  557. package/dist/native/store/mongo/mongoStore.js.map +1 -0
  558. package/dist/native/store/mongo/pipelines.js +705 -0
  559. package/dist/native/store/mongo/pipelines.js.map +1 -0
  560. package/dist/native/store/mongo/results.js +20 -0
  561. package/dist/native/store/mongo/results.js.map +1 -0
  562. package/dist/native/store/parts.d.ts +1 -0
  563. package/dist/native/store/parts.js +101 -0
  564. package/dist/native/store/parts.js.map +1 -0
  565. package/dist/native/store/pattern.js +213 -0
  566. package/dist/native/store/pattern.js.map +1 -0
  567. package/dist/native/store/rawRead.d.ts +23 -0
  568. package/dist/native/store/rawRead.js +387 -0
  569. package/dist/native/store/rawRead.js.map +1 -0
  570. package/dist/native/store/reclassify.js +53 -0
  571. package/dist/native/store/reclassify.js.map +1 -0
  572. package/dist/native/store/sql/aggregateSql.js +349 -0
  573. package/dist/native/store/sql/aggregateSql.js.map +1 -0
  574. package/dist/native/store/sql/columns.js +49 -0
  575. package/dist/native/store/sql/columns.js.map +1 -0
  576. package/dist/native/store/sql/compile.js +668 -0
  577. package/dist/native/store/sql/compile.js.map +1 -0
  578. package/dist/native/store/sql/drivers.js +218 -0
  579. package/dist/native/store/sql/drivers.js.map +1 -0
  580. package/dist/native/store/sql/executor.js +132 -0
  581. package/dist/native/store/sql/executor.js.map +1 -0
  582. package/dist/native/store/sql/fragment.js +104 -0
  583. package/dist/native/store/sql/fragment.js.map +1 -0
  584. package/dist/native/store/sql/maintenanceSql.js +59 -0
  585. package/dist/native/store/sql/maintenanceSql.js.map +1 -0
  586. package/dist/native/store/sql/ownConnection.js +107 -0
  587. package/dist/native/store/sql/ownConnection.js.map +1 -0
  588. package/dist/native/store/sql/poolShare.js +101 -0
  589. package/dist/native/store/sql/poolShare.js.map +1 -0
  590. package/dist/native/store/sql/sqlState.js +325 -0
  591. package/dist/native/store/sql/sqlState.js.map +1 -0
  592. package/dist/native/store/sql/sqlStore.js +355 -0
  593. package/dist/native/store/sql/sqlStore.js.map +1 -0
  594. package/dist/native/store/sql/sqliteThread.d.ts +9 -0
  595. package/dist/native/store/sql/sqliteThread.js +314 -0
  596. package/dist/native/store/sql/sqliteThread.js.map +1 -0
  597. package/dist/native/store/sql/sqliteWorker.js +327 -0
  598. package/dist/native/store/sql/sqliteWorker.js.map +1 -0
  599. package/dist/native/store/sql/sqliteWorkerSource.js +347 -0
  600. package/dist/native/store/sql/sqliteWorkerSource.js.map +1 -0
  601. package/dist/native/store/state.js +151 -0
  602. package/dist/native/store/state.js.map +1 -0
  603. package/dist/native/store/stateStore.js +29 -0
  604. package/dist/native/store/stateStore.js.map +1 -0
  605. package/dist/native/store/types.d.ts +15 -0
  606. package/dist/native/store/types.js +10 -0
  607. package/dist/native/store/types.js.map +1 -0
  608. package/dist/native/tasks/maintainTask.d.ts +19 -0
  609. package/dist/native/tasks/maintainTask.js +57 -0
  610. package/dist/native/tasks/maintainTask.js.map +1 -0
  611. package/dist/net/guardedFetch.d.ts +32 -0
  612. package/dist/net/guardedFetch.js +220 -0
  613. package/dist/net/guardedFetch.js.map +1 -0
  614. package/dist/net/origin.js +40 -0
  615. package/dist/net/origin.js.map +1 -0
  616. package/dist/net/platform.d.ts +9 -0
  617. package/dist/net/platform.js +35 -0
  618. package/dist/net/platform.js.map +1 -0
  619. package/dist/plugin/adminDependencies.js +34 -0
  620. package/dist/plugin/adminDependencies.js.map +1 -0
  621. package/dist/plugin/apiPath.js +23 -0
  622. package/dist/plugin/apiPath.js.map +1 -0
  623. package/dist/plugin/boundDocument.js +58 -0
  624. package/dist/plugin/boundDocument.js.map +1 -0
  625. package/dist/plugin/buildPhase.js +10 -0
  626. package/dist/plugin/buildPhase.js.map +1 -0
  627. package/dist/plugin/collectionChecks.js +232 -0
  628. package/dist/plugin/collectionChecks.js.map +1 -0
  629. package/dist/plugin/collectionFields.d.ts +13 -0
  630. package/dist/plugin/collectionFields.js +22 -0
  631. package/dist/plugin/collectionFields.js.map +1 -0
  632. package/dist/plugin/createRuntime.js +346 -0
  633. package/dist/plugin/createRuntime.js.map +1 -0
  634. package/dist/plugin/destroy.js +58 -0
  635. package/dist/plugin/destroy.js.map +1 -0
  636. package/dist/plugin/documentEndpoint.js +106 -53
  637. package/dist/plugin/documentEndpoint.js.map +1 -1
  638. package/dist/plugin/documentScopes.js +37 -0
  639. package/dist/plugin/documentScopes.js.map +1 -0
  640. package/dist/plugin/encrypted.js +25 -0
  641. package/dist/plugin/encrypted.js.map +1 -0
  642. package/dist/plugin/errors.d.ts +24 -0
  643. package/dist/plugin/errors.js +86 -0
  644. package/dist/plugin/errors.js.map +1 -0
  645. package/dist/plugin/flagsEndpoint.js +41 -0
  646. package/dist/plugin/flagsEndpoint.js.map +1 -0
  647. package/dist/plugin/goalHint.d.ts +1 -0
  648. package/dist/plugin/goalHint.js +35 -0
  649. package/dist/plugin/goalHint.js.map +1 -0
  650. package/dist/plugin/itemLabels.js +114 -0
  651. package/dist/plugin/itemLabels.js.map +1 -0
  652. package/dist/plugin/keepAlive.js +48 -0
  653. package/dist/plugin/keepAlive.js.map +1 -0
  654. package/dist/plugin/peerImportError.js +3 -6
  655. package/dist/plugin/peerImportError.js.map +1 -1
  656. package/dist/plugin/peers.js +64 -0
  657. package/dist/plugin/peers.js.map +1 -0
  658. package/dist/plugin/pluginCollections.js +161 -0
  659. package/dist/plugin/pluginCollections.js.map +1 -0
  660. package/dist/plugin/queryEndpoint.js +88 -52
  661. package/dist/plugin/queryEndpoint.js.map +1 -1
  662. package/dist/plugin/queryParams.js +7 -0
  663. package/dist/plugin/queryParams.js.map +1 -0
  664. package/dist/plugin/readContextForRequest.d.ts +11 -0
  665. package/dist/plugin/readContextForRequest.js +79 -32
  666. package/dist/plugin/readContextForRequest.js.map +1 -1
  667. package/dist/plugin/readFailure.js +22 -0
  668. package/dist/plugin/readFailure.js.map +1 -0
  669. package/dist/plugin/readableProviders.js +67 -0
  670. package/dist/plugin/readableProviders.js.map +1 -0
  671. package/dist/plugin/realtimeEndpoint.js +91 -21
  672. package/dist/plugin/realtimeEndpoint.js.map +1 -1
  673. package/dist/plugin/refreshEndpoint.js +138 -0
  674. package/dist/plugin/refreshEndpoint.js.map +1 -0
  675. package/dist/plugin/relabelFields.js +36 -0
  676. package/dist/plugin/relabelFields.js.map +1 -0
  677. package/dist/plugin/requestMemo.js +35 -0
  678. package/dist/plugin/requestMemo.js.map +1 -0
  679. package/dist/plugin/routeChecks.js +39 -0
  680. package/dist/plugin/routeChecks.js.map +1 -0
  681. package/dist/plugin/routes.d.ts +53 -0
  682. package/dist/plugin/routes.js +92 -0
  683. package/dist/plugin/routes.js.map +1 -0
  684. package/dist/plugin/runtime.d.ts +1 -1
  685. package/dist/plugin/runtime.js +235 -29
  686. package/dist/plugin/runtime.js.map +1 -1
  687. package/dist/plugin/schemaOnly.js +61 -0
  688. package/dist/plugin/schemaOnly.js.map +1 -0
  689. package/dist/plugin/scopeChange.js +23 -0
  690. package/dist/plugin/scopeChange.js.map +1 -0
  691. package/dist/plugin/scopeFieldBoot.js +4 -4
  692. package/dist/plugin/scopeFieldBoot.js.map +1 -1
  693. package/dist/plugin/scopeToken.js +33 -0
  694. package/dist/plugin/scopeToken.js.map +1 -0
  695. package/dist/plugin/sourcesEndpoint.js +50 -16
  696. package/dist/plugin/sourcesEndpoint.js.map +1 -1
  697. package/dist/plugin/unbundledLanguages.js +25 -0
  698. package/dist/plugin/unbundledLanguages.js.map +1 -0
  699. package/dist/plugin/walkFields.js +24 -0
  700. package/dist/plugin/walkFields.js.map +1 -0
  701. package/dist/plugin/warmTask.js +0 -0
  702. package/dist/plugin/warmTask.js.map +1 -1
  703. package/dist/providers/ProvidersListNotice.d.ts +11 -0
  704. package/dist/providers/ProvidersListNotice.js +36 -0
  705. package/dist/providers/ProvidersListNotice.js.map +1 -0
  706. package/dist/providers/access.d.ts +1 -0
  707. package/dist/providers/access.js +35 -26
  708. package/dist/providers/access.js.map +1 -1
  709. package/dist/providers/adapterPool.js +121 -0
  710. package/dist/providers/adapterPool.js.map +1 -0
  711. package/dist/providers/collection.d.ts +63 -0
  712. package/dist/providers/collection.js +372 -143
  713. package/dist/providers/collection.js.map +1 -1
  714. package/dist/providers/factory.d.ts +84 -0
  715. package/dist/providers/factory.js +86 -25
  716. package/dist/providers/factory.js.map +1 -1
  717. package/dist/providers/hosts.d.ts +25 -0
  718. package/dist/providers/hosts.js +128 -0
  719. package/dist/providers/hosts.js.map +1 -0
  720. package/dist/providers/probe.d.ts +1 -0
  721. package/dist/providers/probe.js +105 -0
  722. package/dist/providers/probe.js.map +1 -0
  723. package/dist/providers/refresh.d.ts +18 -0
  724. package/dist/providers/refresh.js +49 -0
  725. package/dist/providers/refresh.js.map +1 -0
  726. package/dist/providers/registry.js +329 -0
  727. package/dist/providers/registry.js.map +1 -0
  728. package/dist/providers/resolver.js +26 -88
  729. package/dist/providers/resolver.js.map +1 -1
  730. package/dist/providers/retarget.js +45 -0
  731. package/dist/providers/retarget.js.map +1 -0
  732. package/dist/providers/scopeUnique.js +41 -0
  733. package/dist/providers/scopeUnique.js.map +1 -0
  734. package/dist/providers/secrets.d.ts +26 -0
  735. package/dist/providers/secrets.js +61 -4
  736. package/dist/providers/secrets.js.map +1 -1
  737. package/dist/providers/stampScope.js +9 -6
  738. package/dist/providers/stampScope.js.map +1 -1
  739. package/dist/query/dates.js +10 -12
  740. package/dist/query/dates.js.map +1 -1
  741. package/dist/query/errors.d.ts +6 -13
  742. package/dist/query/fetchQuery.d.ts +36 -23
  743. package/dist/query/fetchQuery.js +96 -89
  744. package/dist/query/fetchQuery.js.map +1 -1
  745. package/dist/query/limits.js +8 -0
  746. package/dist/query/limits.js.map +1 -0
  747. package/dist/query/parse.d.ts +8 -2
  748. package/dist/query/parse.js +155 -108
  749. package/dist/query/parse.js.map +1 -1
  750. package/dist/query/response.d.ts +27 -4
  751. package/dist/query/response.js +18 -0
  752. package/dist/query/response.js.map +1 -0
  753. package/dist/react/AnalyticsProvider.d.ts +42 -20
  754. package/dist/react/AnalyticsProvider.js +24 -22
  755. package/dist/react/AnalyticsProvider.js.map +1 -1
  756. package/dist/react/TrackerBoot.js +15 -9
  757. package/dist/react/TrackerBoot.js.map +1 -1
  758. package/dist/react/useAnalytics.d.ts +2 -8
  759. package/dist/react/useAnalytics.js +31 -13
  760. package/dist/react/useAnalytics.js.map +1 -1
  761. package/dist/routes/captureRoute.d.ts +28 -0
  762. package/dist/routes/captureRoute.js +67 -0
  763. package/dist/routes/captureRoute.js.map +1 -0
  764. package/dist/routes/ingestRoute.d.ts +17 -0
  765. package/dist/routes/ingestRoute.js +17 -0
  766. package/dist/routes/ingestRoute.js.map +1 -0
  767. package/dist/site/AnalyticsScripts.d.ts +35 -0
  768. package/dist/site/AnalyticsScripts.js +44 -0
  769. package/dist/site/AnalyticsScripts.js.map +1 -0
  770. package/dist/site/getTrackerConfig.d.ts +15 -0
  771. package/dist/site/getTrackerConfig.js +43 -0
  772. package/dist/site/getTrackerConfig.js.map +1 -0
  773. package/dist/surfacing/afterRead.d.ts +37 -0
  774. package/dist/surfacing/bounded.js +38 -0
  775. package/dist/surfacing/bounded.js.map +1 -0
  776. package/dist/surfacing/breaker.js +107 -0
  777. package/dist/surfacing/breaker.js.map +1 -0
  778. package/dist/surfacing/cacheCollection.d.ts +8 -0
  779. package/dist/surfacing/cacheCollection.js +71 -0
  780. package/dist/surfacing/cacheCollection.js.map +1 -0
  781. package/dist/surfacing/cacheStore.d.ts +71 -1
  782. package/dist/surfacing/cacheStore.js +16 -37
  783. package/dist/surfacing/cacheStore.js.map +1 -1
  784. package/dist/surfacing/cacheSweep.d.ts +1 -0
  785. package/dist/surfacing/cacheSweep.js +59 -0
  786. package/dist/surfacing/cacheSweep.js.map +1 -0
  787. package/dist/surfacing/classifyError.js +282 -0
  788. package/dist/surfacing/classifyError.js.map +1 -0
  789. package/dist/surfacing/coalesce.js +2 -1
  790. package/dist/surfacing/coalesce.js.map +1 -1
  791. package/dist/surfacing/coldBudget.js +60 -0
  792. package/dist/surfacing/coldBudget.js.map +1 -0
  793. package/dist/surfacing/collectionCacheStore.js +183 -0
  794. package/dist/surfacing/collectionCacheStore.js.map +1 -0
  795. package/dist/surfacing/engine.d.ts +1 -1
  796. package/dist/surfacing/engine.js +514 -71
  797. package/dist/surfacing/engine.js.map +1 -1
  798. package/dist/surfacing/epoch.d.ts +1 -0
  799. package/dist/surfacing/epoch.js +116 -0
  800. package/dist/surfacing/epoch.js.map +1 -0
  801. package/dist/surfacing/lanes.d.ts +1 -0
  802. package/dist/surfacing/lanes.js +297 -0
  803. package/dist/surfacing/lanes.js.map +1 -0
  804. package/dist/surfacing/memo.js +40 -0
  805. package/dist/surfacing/memo.js.map +1 -0
  806. package/dist/surfacing/rateLimiter.d.ts +1 -0
  807. package/dist/surfacing/rateLimiter.js +69 -94
  808. package/dist/surfacing/rateLimiter.js.map +1 -1
  809. package/dist/surfacing/rebucket.js +178 -0
  810. package/dist/surfacing/rebucket.js.map +1 -0
  811. package/dist/surfacing/recipe.js +28 -0
  812. package/dist/surfacing/recipe.js.map +1 -0
  813. package/dist/surfacing/shape.js +22 -0
  814. package/dist/surfacing/shape.js.map +1 -0
  815. package/dist/surfacing/todaySplit.js +119 -0
  816. package/dist/surfacing/todaySplit.js.map +1 -0
  817. package/dist/sync/collection.d.ts +8 -0
  818. package/dist/sync/collection.js +30 -18
  819. package/dist/sync/collection.js.map +1 -1
  820. package/dist/sync/rekeyDurations.js +70 -0
  821. package/dist/sync/rekeyDurations.js.map +1 -0
  822. package/dist/sync/syncTask.js +222 -109
  823. package/dist/sync/syncTask.js.map +1 -1
  824. package/dist/testing/memoryAdapter.d.ts +6 -3
  825. package/dist/testing/memoryAdapter.js +12 -11
  826. package/dist/testing/memoryAdapter.js.map +1 -1
  827. package/dist/testing/settle.d.ts +11 -0
  828. package/dist/testing/settle.js +19 -0
  829. package/dist/testing/settle.js.map +1 -0
  830. package/dist/timeframe/calendar.js +65 -0
  831. package/dist/timeframe/calendar.js.map +1 -0
  832. package/dist/timeframe/comparison.js +46 -0
  833. package/dist/timeframe/comparison.js.map +1 -0
  834. package/dist/timeframe/presets.d.ts +1 -1
  835. package/dist/timeframe/presets.js +5 -5
  836. package/dist/timeframe/presets.js.map +1 -1
  837. package/dist/timeframe/reportingTimezone.d.ts +1 -0
  838. package/dist/timeframe/reportingTimezone.js +64 -0
  839. package/dist/timeframe/reportingTimezone.js.map +1 -0
  840. package/dist/timeframe/tz.js +55 -39
  841. package/dist/timeframe/tz.js.map +1 -1
  842. package/dist/tracker/autoCapture.js +125 -38
  843. package/dist/tracker/autoCapture.js.map +1 -1
  844. package/dist/tracker/campaign.js +52 -0
  845. package/dist/tracker/campaign.js.map +1 -0
  846. package/dist/tracker/config.d.ts +174 -0
  847. package/dist/tracker/config.js +25 -0
  848. package/dist/tracker/config.js.map +1 -0
  849. package/dist/tracker/createTracker.d.ts +5 -10
  850. package/dist/tracker/createTracker.js +437 -82
  851. package/dist/tracker/createTracker.js.map +1 -1
  852. package/dist/tracker/digest.js +28 -0
  853. package/dist/tracker/digest.js.map +1 -0
  854. package/dist/tracker/engagement.js +100 -0
  855. package/dist/tracker/engagement.js.map +1 -0
  856. package/dist/tracker/events.js +37 -0
  857. package/dist/tracker/events.js.map +1 -0
  858. package/dist/tracker/exclusion.d.ts +8 -0
  859. package/dist/tracker/exclusion.js +82 -0
  860. package/dist/tracker/exclusion.js.map +1 -0
  861. package/dist/tracker/gate.d.ts +8 -0
  862. package/dist/tracker/gate.js +244 -0
  863. package/dist/tracker/gate.js.map +1 -0
  864. package/dist/tracker/initTracker.d.ts +5 -8
  865. package/dist/tracker/initTracker.js +42 -14
  866. package/dist/tracker/initTracker.js.map +1 -1
  867. package/dist/tracker/itemCapture.js +224 -0
  868. package/dist/tracker/itemCapture.js.map +1 -0
  869. package/dist/tracker/loadScript.js +23 -15
  870. package/dist/tracker/loadScript.js.map +1 -1
  871. package/dist/tracker/pageTracking.js +6 -6
  872. package/dist/tracker/pageTracking.js.map +1 -1
  873. package/dist/tracker/registry.js +129 -30
  874. package/dist/tracker/registry.js.map +1 -1
  875. package/dist/tracker/sinks/createSink.js +60 -0
  876. package/dist/tracker/sinks/createSink.js.map +1 -0
  877. package/dist/tracker/sinks/ga4.js +106 -0
  878. package/dist/tracker/sinks/ga4.js.map +1 -0
  879. package/dist/tracker/sinks/native.js +21 -42
  880. package/dist/tracker/sinks/native.js.map +1 -1
  881. package/dist/tracker/sinks/plausible.js +36 -18
  882. package/dist/tracker/sinks/plausible.js.map +1 -1
  883. package/dist/tracker/sinks/posthog.js +145 -9
  884. package/dist/tracker/sinks/posthog.js.map +1 -1
  885. package/dist/tracker/sinks/umami.js +18 -10
  886. package/dist/tracker/sinks/umami.js.map +1 -1
  887. package/dist/tracker/sinks/vendor.js +54 -22
  888. package/dist/tracker/sinks/vendor.js.map +1 -1
  889. package/dist/tracker/skip.js +81 -0
  890. package/dist/tracker/skip.js.map +1 -0
  891. package/dist/tracker/storage.js +23 -0
  892. package/dist/tracker/storage.js.map +1 -0
  893. package/dist/tracker/transport.js +2 -5
  894. package/dist/tracker/transport.js.map +1 -1
  895. package/dist/tracker/types.d.ts +99 -44
  896. package/dist/tracker/window.js +7 -0
  897. package/dist/tracker/window.js.map +1 -0
  898. package/dist/translations/ar.js +266 -56
  899. package/dist/translations/ar.js.map +1 -1
  900. package/dist/translations/de.js +256 -55
  901. package/dist/translations/de.js.map +1 -1
  902. package/dist/translations/en.js +253 -56
  903. package/dist/translations/en.js.map +1 -1
  904. package/dist/translations/es.js +261 -57
  905. package/dist/translations/es.js.map +1 -1
  906. package/dist/translations/fr.js +265 -61
  907. package/dist/translations/fr.js.map +1 -1
  908. package/dist/translations/id.js +256 -56
  909. package/dist/translations/id.js.map +1 -1
  910. package/dist/translations/index.d.ts +1 -1
  911. package/dist/translations/index.js +5 -7
  912. package/dist/translations/index.js.map +1 -1
  913. package/dist/translations/intl.js +71 -0
  914. package/dist/translations/intl.js.map +1 -0
  915. package/dist/translations/keys.d.ts +240 -14
  916. package/dist/translations/keys.js +245 -14
  917. package/dist/translations/keys.js.map +1 -1
  918. package/dist/translations/ko.js +258 -58
  919. package/dist/translations/ko.js.map +1 -1
  920. package/dist/translations/labelMap.d.ts +10 -0
  921. package/dist/translations/labelMap.js +22 -0
  922. package/dist/translations/labelMap.js.map +1 -0
  923. package/dist/translations/metricKeys.js +16 -2
  924. package/dist/translations/metricKeys.js.map +1 -1
  925. package/dist/translations/parts.js +20 -0
  926. package/dist/translations/parts.js.map +1 -0
  927. package/dist/translations/plural.js +61 -0
  928. package/dist/translations/plural.js.map +1 -0
  929. package/dist/translations/pt.js +270 -66
  930. package/dist/translations/pt.js.map +1 -1
  931. package/dist/translations/ru.js +261 -55
  932. package/dist/translations/ru.js.map +1 -1
  933. package/dist/translations/server.d.ts +1 -0
  934. package/dist/translations/server.js +2 -3
  935. package/dist/translations/server.js.map +1 -1
  936. package/dist/translations/staticLabel.js +69 -0
  937. package/dist/translations/staticLabel.js.map +1 -0
  938. package/dist/translations/uk.js +261 -55
  939. package/dist/translations/uk.js.map +1 -1
  940. package/dist/translations/zh.js +256 -56
  941. package/dist/translations/zh.js.map +1 -1
  942. package/dist/ui/RangePicker.js +110 -0
  943. package/dist/ui/RangePicker.js.map +1 -0
  944. package/dist/ui/analytics.css +1667 -0
  945. package/dist/ui/calendarDays.js +27 -0
  946. package/dist/ui/calendarDays.js.map +1 -0
  947. package/dist/ui/classNames.js +7 -0
  948. package/dist/ui/classNames.js.map +1 -0
  949. package/dist/ui/components/Card.d.ts +28 -0
  950. package/dist/ui/components/Card.js +21 -0
  951. package/dist/ui/components/Card.js.map +1 -0
  952. package/dist/ui/components/ChartDataTable.d.ts +41 -0
  953. package/dist/ui/components/ChartDataTable.js +48 -0
  954. package/dist/ui/components/ChartDataTable.js.map +1 -0
  955. package/dist/ui/components/ChoiceMenu.js +48 -0
  956. package/dist/ui/components/ChoiceMenu.js.map +1 -0
  957. package/dist/ui/components/DataTable.d.ts +82 -0
  958. package/dist/ui/components/DataTable.js +214 -0
  959. package/dist/ui/components/DataTable.js.map +1 -0
  960. package/dist/ui/components/LabeledSelect.js +62 -0
  961. package/dist/ui/components/LabeledSelect.js.map +1 -0
  962. package/dist/ui/components/LiveAnnouncement.js +21 -0
  963. package/dist/ui/components/LiveAnnouncement.js.map +1 -0
  964. package/dist/ui/components/MetricCard.d.ts +38 -0
  965. package/dist/ui/components/MetricCard.js +39 -0
  966. package/dist/ui/components/MetricCard.js.map +1 -0
  967. package/dist/ui/components/NoValue.js +22 -0
  968. package/dist/ui/components/NoValue.js.map +1 -0
  969. package/dist/ui/components/ReadState.js +27 -0
  970. package/dist/ui/components/ReadState.js.map +1 -0
  971. package/dist/ui/components/RefreshButton.js +25 -0
  972. package/dist/ui/components/RefreshButton.js.map +1 -0
  973. package/dist/ui/components/SourcesNoticeBanner.js +20 -0
  974. package/dist/ui/components/SourcesNoticeBanner.js.map +1 -0
  975. package/dist/ui/cssVars.js +7 -0
  976. package/dist/ui/cssVars.js.map +1 -0
  977. package/dist/ui/data/WithScopeToken.d.ts +20 -0
  978. package/dist/ui/data/WithScopeToken.js +20 -0
  979. package/dist/ui/data/WithScopeToken.js.map +1 -0
  980. package/dist/ui/data/clientFieldProps.js +16 -0
  981. package/dist/ui/data/clientFieldProps.js.map +1 -0
  982. package/dist/ui/data/request.d.ts +46 -0
  983. package/dist/ui/data/request.js +119 -0
  984. package/dist/ui/data/request.js.map +1 -0
  985. package/dist/ui/data/scopeTokenContext.js +18 -0
  986. package/dist/ui/data/scopeTokenContext.js.map +1 -0
  987. package/dist/ui/data/sharedCache.js +48 -0
  988. package/dist/ui/data/sharedCache.js.map +1 -0
  989. package/dist/ui/data/useRequest.d.ts +19 -0
  990. package/dist/ui/data/useRequest.js +123 -0
  991. package/dist/ui/data/useRequest.js.map +1 -0
  992. package/dist/ui/data/useRequestScope.js +25 -0
  993. package/dist/ui/data/useRequestScope.js.map +1 -0
  994. package/dist/ui/hooks/useDirection.js +47 -0
  995. package/dist/ui/hooks/useDirection.js.map +1 -0
  996. package/dist/ui/hooks/useDismissOnEscape.js +25 -0
  997. package/dist/ui/hooks/useDismissOnEscape.js.map +1 -0
  998. package/dist/ui/hooks/useLiveAnnouncement.js +57 -0
  999. package/dist/ui/hooks/useLiveAnnouncement.js.map +1 -0
  1000. package/dist/ui/hooks/useRealtimePoll.js +112 -0
  1001. package/dist/ui/hooks/useRealtimePoll.js.map +1 -0
  1002. package/dist/ui/readState.js +19 -0
  1003. package/dist/ui/readState.js.map +1 -0
  1004. package/dist/ui/rows/toDisplayRows.js +49 -0
  1005. package/dist/ui/rows/toDisplayRows.js.map +1 -0
  1006. package/dist/ui/viewerClock.js +7 -0
  1007. package/dist/ui/viewerClock.js.map +1 -0
  1008. package/dist/view/AnalyticsNavLink.d.ts +5 -3
  1009. package/dist/view/AnalyticsNavLink.js +12 -8
  1010. package/dist/view/AnalyticsNavLink.js.map +1 -1
  1011. package/dist/view/AnalyticsView.d.ts +9 -10
  1012. package/dist/view/AnalyticsView.js +47 -19
  1013. package/dist/view/AnalyticsView.js.map +1 -1
  1014. package/dist/view/AnalyticsViewClient.d.ts +4 -7
  1015. package/dist/view/AnalyticsViewClient.js +15 -174
  1016. package/dist/view/AnalyticsViewClient.js.map +1 -1
  1017. package/dist/view/CountryFlag.d.ts +27 -0
  1018. package/dist/view/CountryFlag.js +44 -0
  1019. package/dist/view/CountryFlag.js.map +1 -0
  1020. package/dist/view/DocumentTitle.js +27 -0
  1021. package/dist/view/DocumentTitle.js.map +1 -0
  1022. package/dist/view/ViewRoot.d.ts +21 -0
  1023. package/dist/view/ViewRoot.js +155 -0
  1024. package/dist/view/ViewRoot.js.map +1 -0
  1025. package/dist/view/ViewSections.d.ts +38 -0
  1026. package/dist/view/ViewSections.js +190 -0
  1027. package/dist/view/ViewSections.js.map +1 -0
  1028. package/dist/view/authRedirect.js +2 -4
  1029. package/dist/view/authRedirect.js.map +1 -1
  1030. package/dist/view/consentShare.js +15 -0
  1031. package/dist/view/consentShare.js.map +1 -0
  1032. package/dist/view/conversionRate.js +9 -7
  1033. package/dist/view/conversionRate.js.map +1 -1
  1034. package/dist/view/dayRange.js +6 -10
  1035. package/dist/view/dayRange.js.map +1 -1
  1036. package/dist/view/exclusionLink.d.ts +27 -0
  1037. package/dist/view/exclusionLink.js +46 -0
  1038. package/dist/view/exclusionLink.js.map +1 -0
  1039. package/dist/view/flagSrc.js +14 -0
  1040. package/dist/view/flagSrc.js.map +1 -0
  1041. package/dist/view/gating.d.ts +15 -1
  1042. package/dist/view/gating.js +92 -20
  1043. package/dist/view/gating.js.map +1 -1
  1044. package/dist/view/hostCountryFlag.js +41 -0
  1045. package/dist/view/hostCountryFlag.js.map +1 -0
  1046. package/dist/view/labels.js +120 -3
  1047. package/dist/view/labels.js.map +1 -1
  1048. package/dist/view/metricAliases.js +10 -0
  1049. package/dist/view/metricAliases.js.map +1 -0
  1050. package/dist/view/navLabel.js +15 -0
  1051. package/dist/view/navLabel.js.map +1 -0
  1052. package/dist/view/registerView.js +13 -11
  1053. package/dist/view/registerView.js.map +1 -1
  1054. package/dist/view/scopeLabel.js +21 -0
  1055. package/dist/view/scopeLabel.js.map +1 -0
  1056. package/dist/view/sections/Breakdowns.js +221 -118
  1057. package/dist/view/sections/Breakdowns.js.map +1 -1
  1058. package/dist/view/sections/EmptyStates.js +120 -32
  1059. package/dist/view/sections/EmptyStates.js.map +1 -1
  1060. package/dist/view/sections/ExcludeBrowser.js +188 -0
  1061. package/dist/view/sections/ExcludeBrowser.js.map +1 -0
  1062. package/dist/view/sections/FilterChips.js +130 -25
  1063. package/dist/view/sections/FilterChips.js.map +1 -1
  1064. package/dist/view/sections/GoalsPanel.js +68 -59
  1065. package/dist/view/sections/GoalsPanel.js.map +1 -1
  1066. package/dist/view/sections/OverviewCards.js +42 -36
  1067. package/dist/view/sections/OverviewCards.js.map +1 -1
  1068. package/dist/view/sections/RealtimeStrip.js +70 -56
  1069. package/dist/view/sections/RealtimeStrip.js.map +1 -1
  1070. package/dist/view/sections/SectionBoundary.js +34 -0
  1071. package/dist/view/sections/SectionBoundary.js.map +1 -0
  1072. package/dist/view/sections/Toolbar.d.ts +11 -0
  1073. package/dist/view/sections/Toolbar.js +182 -116
  1074. package/dist/view/sections/Toolbar.js.map +1 -1
  1075. package/dist/view/sections/Trend.js +179 -73
  1076. package/dist/view/sections/Trend.js.map +1 -1
  1077. package/dist/view/state.d.ts +42 -0
  1078. package/dist/view/state.js +97 -53
  1079. package/dist/view/state.js.map +1 -1
  1080. package/dist/view/useViewClock.js +31 -0
  1081. package/dist/view/useViewClock.js.map +1 -0
  1082. package/dist/view/useViewQueries.d.ts +21 -0
  1083. package/dist/view/useViewQueries.js +50 -79
  1084. package/dist/view/useViewQueries.js.map +1 -1
  1085. package/dist/view/useViewState.js +42 -0
  1086. package/dist/view/useViewState.js.map +1 -0
  1087. package/dist/view/useViewUrl.js +52 -0
  1088. package/dist/view/useViewUrl.js.map +1 -0
  1089. package/dist/view/viewBody.js +30 -0
  1090. package/dist/view/viewBody.js.map +1 -0
  1091. package/dist/view/viewContext.d.ts +81 -0
  1092. package/dist/view/viewContext.js +49 -0
  1093. package/dist/view/viewContext.js.map +1 -0
  1094. package/dist/view/viewProps.d.ts +65 -8
  1095. package/dist/view/viewProps.js +123 -36
  1096. package/dist/view/viewProps.js.map +1 -1
  1097. package/dist/widgets/AnalyticsBreakdownWidget.d.ts +7 -3
  1098. package/dist/widgets/AnalyticsBreakdownWidget.js +153 -78
  1099. package/dist/widgets/AnalyticsBreakdownWidget.js.map +1 -1
  1100. package/dist/widgets/AnalyticsGoalsWidget.d.ts +6 -7
  1101. package/dist/widgets/AnalyticsGoalsWidget.js +126 -159
  1102. package/dist/widgets/AnalyticsGoalsWidget.js.map +1 -1
  1103. package/dist/widgets/AnalyticsMetricWidget.d.ts +7 -3
  1104. package/dist/widgets/AnalyticsMetricWidget.js +85 -83
  1105. package/dist/widgets/AnalyticsMetricWidget.js.map +1 -1
  1106. package/dist/widgets/AnalyticsRealtimeWidget.d.ts +7 -3
  1107. package/dist/widgets/AnalyticsRealtimeWidget.js +81 -61
  1108. package/dist/widgets/AnalyticsRealtimeWidget.js.map +1 -1
  1109. package/dist/widgets/AnalyticsTrendWidget.d.ts +7 -3
  1110. package/dist/widgets/AnalyticsTrendWidget.js +134 -100
  1111. package/dist/widgets/AnalyticsTrendWidget.js.map +1 -1
  1112. package/dist/widgets/ComparisonDelta.js +33 -42
  1113. package/dist/widgets/ComparisonDelta.js.map +1 -1
  1114. package/dist/widgets/RealtimeCounter.d.ts +27 -3
  1115. package/dist/widgets/RealtimeCounter.js +90 -62
  1116. package/dist/widgets/RealtimeCounter.js.map +1 -1
  1117. package/dist/widgets/WidgetCard.d.ts +80 -0
  1118. package/dist/widgets/WidgetCard.js +99 -0
  1119. package/dist/widgets/WidgetCard.js.map +1 -0
  1120. package/dist/widgets/WidgetFrame.js +42 -0
  1121. package/dist/widgets/WidgetFrame.js.map +1 -0
  1122. package/dist/widgets/WidgetShimmer.d.ts +55 -0
  1123. package/dist/widgets/WidgetShimmer.js +86 -0
  1124. package/dist/widgets/WidgetShimmer.js.map +1 -0
  1125. package/dist/widgets/breakdownTypes.js +18 -2
  1126. package/dist/widgets/breakdownTypes.js.map +1 -1
  1127. package/dist/widgets/customWidget.d.ts +5 -1
  1128. package/dist/widgets/customWidget.js +6 -7
  1129. package/dist/widgets/customWidget.js.map +1 -1
  1130. package/dist/widgets/defaultLayout.d.ts +26 -0
  1131. package/dist/widgets/defaultLayout.js +51 -0
  1132. package/dist/widgets/defaultLayout.js.map +1 -0
  1133. package/dist/widgets/defaults.d.ts +4 -3
  1134. package/dist/widgets/defaults.js +76 -24
  1135. package/dist/widgets/defaults.js.map +1 -1
  1136. package/dist/widgets/fieldRows.js +14 -0
  1137. package/dist/widgets/fieldRows.js.map +1 -0
  1138. package/dist/widgets/filterCaption.js +26 -0
  1139. package/dist/widgets/filterCaption.js.map +1 -0
  1140. package/dist/widgets/filterField.d.ts +15 -0
  1141. package/dist/widgets/filterField.js +86 -0
  1142. package/dist/widgets/filterField.js.map +1 -0
  1143. package/dist/widgets/filterValueLabel.d.ts +1 -0
  1144. package/dist/widgets/filterValueLabel.js +45 -0
  1145. package/dist/widgets/filterValueLabel.js.map +1 -0
  1146. package/dist/widgets/notices.js +79 -0
  1147. package/dist/widgets/notices.js.map +1 -0
  1148. package/dist/widgets/prepareWidgetRead.d.ts +24 -0
  1149. package/dist/widgets/prepareWidgetRead.js +110 -0
  1150. package/dist/widgets/prepareWidgetRead.js.map +1 -0
  1151. package/dist/widgets/range.js +26 -21
  1152. package/dist/widgets/range.js.map +1 -1
  1153. package/dist/widgets/readForWidget.d.ts +32 -13
  1154. package/dist/widgets/readForWidget.js +52 -63
  1155. package/dist/widgets/readForWidget.js.map +1 -1
  1156. package/dist/widgets/readForWidgetBreakdown.d.ts +45 -18
  1157. package/dist/widgets/readForWidgetBreakdown.js +71 -58
  1158. package/dist/widgets/readForWidgetBreakdown.js.map +1 -1
  1159. package/dist/widgets/readForWidgetGoals.d.ts +21 -17
  1160. package/dist/widgets/readForWidgetGoals.js +72 -52
  1161. package/dist/widgets/readForWidgetGoals.js.map +1 -1
  1162. package/dist/widgets/readForWidgetRealtime.d.ts +24 -11
  1163. package/dist/widgets/readForWidgetRealtime.js +69 -41
  1164. package/dist/widgets/readForWidgetRealtime.js.map +1 -1
  1165. package/dist/widgets/readForWidgetSeries.d.ts +29 -24
  1166. package/dist/widgets/readForWidgetSeries.js +66 -114
  1167. package/dist/widgets/readForWidgetSeries.js.map +1 -1
  1168. package/dist/widgets/readMeta.d.ts +48 -0
  1169. package/dist/widgets/readMeta.js +66 -0
  1170. package/dist/widgets/readMeta.js.map +1 -0
  1171. package/dist/widgets/realtimePoll.d.ts +1 -0
  1172. package/dist/widgets/realtimePoll.js +56 -16
  1173. package/dist/widgets/realtimePoll.js.map +1 -1
  1174. package/dist/widgets/registerWidgets.js +207 -124
  1175. package/dist/widgets/registerWidgets.js.map +1 -1
  1176. package/dist/widgets/stateKeys.js +30 -0
  1177. package/dist/widgets/stateKeys.js.map +1 -0
  1178. package/dist/widgets/titleForecast.js +89 -0
  1179. package/dist/widgets/titleForecast.js.map +1 -0
  1180. package/dist/widgets/types.d.ts +16 -0
  1181. package/dist/widgets/types.js +2 -0
  1182. package/dist/widgets/types.js.map +1 -1
  1183. package/dist/widgets/viewLink.d.ts +24 -6
  1184. package/dist/widgets/viewLink.js +36 -26
  1185. package/dist/widgets/viewLink.js.map +1 -1
  1186. package/dist/widgets/widgetData.js +34 -0
  1187. package/dist/widgets/widgetData.js.map +1 -0
  1188. package/dist/widgets/widgetWindow.d.ts +1 -0
  1189. package/dist/widgets/widgetWindow.js +51 -0
  1190. package/dist/widgets/widgetWindow.js.map +1 -0
  1191. package/package.json +61 -42
  1192. package/dist/capture/getTrackerConfig.d.ts +0 -20
  1193. package/dist/capture/getTrackerConfig.js +0 -31
  1194. package/dist/capture/getTrackerConfig.js.map +0 -1
  1195. package/dist/capture/slots.d.ts +0 -8
  1196. package/dist/capture/trackerConfig.d.ts +0 -33
  1197. package/dist/charts/styles.js +0 -59
  1198. package/dist/charts/styles.js.map +0 -1
  1199. package/dist/exports/next.d.ts +0 -3
  1200. package/dist/exports/next.js +0 -3
  1201. package/dist/fields/config/SourceSelectField.d.ts +0 -14
  1202. package/dist/fields/dateRange/styles.js +0 -23
  1203. package/dist/fields/dateRange/styles.js.map +0 -1
  1204. package/dist/goals/GoalSelectField.d.ts +0 -7
  1205. package/dist/native/collections/events.js +0 -121
  1206. package/dist/native/collections/events.js.map +0 -1
  1207. package/dist/native/collections/rollups.js +0 -151
  1208. package/dist/native/collections/rollups.js.map +0 -1
  1209. package/dist/native/collections/seen.js +0 -47
  1210. package/dist/native/collections/seen.js.map +0 -1
  1211. package/dist/native/ingest/flushBatch.js +0 -60
  1212. package/dist/native/ingest/flushBatch.js.map +0 -1
  1213. package/dist/native/ingest/salt.js +0 -14
  1214. package/dist/native/ingest/salt.js.map +0 -1
  1215. package/dist/native/ingest/writeBuffer.js +0 -55
  1216. package/dist/native/ingest/writeBuffer.js.map +0 -1
  1217. package/dist/native/ingest/writeEvent.js +0 -14
  1218. package/dist/native/ingest/writeEvent.js.map +0 -1
  1219. package/dist/native/query/eventAgg.js +0 -161
  1220. package/dist/native/query/eventAgg.js.map +0 -1
  1221. package/dist/native/realtime/buildRealtime.js +0 -53
  1222. package/dist/native/realtime/buildRealtime.js.map +0 -1
  1223. package/dist/native/retention/pruneTask.js +0 -29
  1224. package/dist/native/retention/pruneTask.js.map +0 -1
  1225. package/dist/native/rollupAcc.js +0 -64
  1226. package/dist/native/rollupAcc.js.map +0 -1
  1227. package/dist/native/rollups/applyDistinctDeltas.js +0 -9
  1228. package/dist/native/rollups/applyDistinctDeltas.js.map +0 -1
  1229. package/dist/native/rollups/bumpRollup.js +0 -73
  1230. package/dist/native/rollups/bumpRollup.js.map +0 -1
  1231. package/dist/native/rollups/deltas.js +0 -90
  1232. package/dist/native/rollups/deltas.js.map +0 -1
  1233. package/dist/native/rollups/insertIfNew.js +0 -53
  1234. package/dist/native/rollups/insertIfNew.js.map +0 -1
  1235. package/dist/next/captureRewrites.d.ts +0 -41
  1236. package/dist/next/captureRewrites.js +0 -56
  1237. package/dist/next/captureRewrites.js.map +0 -1
  1238. package/dist/next/posthogProxyRewrites.d.ts +0 -41
  1239. package/dist/next/posthogProxyRewrites.js +0 -45
  1240. package/dist/next/posthogProxyRewrites.js.map +0 -1
  1241. package/dist/plugin/paths.js +0 -27
  1242. package/dist/plugin/paths.js.map +0 -1
  1243. package/dist/query/errors.js +0 -10
  1244. package/dist/query/errors.js.map +0 -1
  1245. package/dist/react/TrackerBoot.d.ts +0 -22
  1246. package/dist/rsc/AnalyticsScripts.d.ts +0 -30
  1247. package/dist/rsc/AnalyticsScripts.js +0 -41
  1248. package/dist/rsc/AnalyticsScripts.js.map +0 -1
  1249. package/dist/surfacing/queue.js +0 -60
  1250. package/dist/surfacing/queue.js.map +0 -1
  1251. package/dist/surfacing/retryPolicy.js +0 -15
  1252. package/dist/surfacing/retryPolicy.js.map +0 -1
  1253. package/dist/tracker/autoCapture.d.ts +0 -48
  1254. package/dist/tracker/consent.d.ts +0 -24
  1255. package/dist/tracker/consent.js +0 -48
  1256. package/dist/tracker/consent.js.map +0 -1
  1257. package/dist/tracker/loadScript.d.ts +0 -14
  1258. package/dist/tracker/pageTracking.d.ts +0 -17
  1259. package/dist/tracker/registry.d.ts +0 -27
  1260. package/dist/tracker/sinks/native.d.ts +0 -22
  1261. package/dist/tracker/sinks/plausible.d.ts +0 -14
  1262. package/dist/tracker/sinks/posthog.d.ts +0 -14
  1263. package/dist/tracker/sinks/umami.d.ts +0 -13
  1264. package/dist/tracker/sinks/vendor.d.ts +0 -14
  1265. package/dist/view/sections/styles.js +0 -74
  1266. package/dist/view/sections/styles.js.map +0 -1
  1267. package/dist/widgets/WidgetViewLink.js +0 -17
  1268. package/dist/widgets/WidgetViewLink.js.map +0 -1
  1269. package/dist/widgets/cardChrome.d.ts +0 -8
  1270. package/dist/widgets/cardChrome.js +0 -46
  1271. package/dist/widgets/cardChrome.js.map +0 -1
  1272. package/dist/widgets/comparison.js +0 -43
  1273. package/dist/widgets/comparison.js.map +0 -1
@@ -1,9 +1,8 @@
1
1
  //#region src/charts/spline.ts
2
2
  const round = (n) => Math.round(n * 100) / 100;
3
3
  /**
4
- * Fritsch-Carlson monotone tangents for a unit-spaced series: endpoints take the
5
- * adjacent secant, interior points the average of neighbouring secants, then each is
6
- * clamped so the cubic never overshoots (no wiggle between points).
4
+ * Fritsch-Carlson monotone tangents for a unit-spaced series, clamped so the cubic never overshoots
5
+ * between points.
7
6
  */
8
7
  const computeTangents = (ys) => {
9
8
  const n = ys.length;
@@ -35,30 +34,26 @@ const computeTangents = (ys) => {
35
34
  return m;
36
35
  };
37
36
  /**
38
- * Build SVG path strings for a monotone-cubic line and its closed area fill, mapping a
39
- * value series into a `width` x `height` box (y normalized to the value range; flat or
40
- * single-value series sit on the vertical midline).
37
+ * Maps a reading onto the box's height, unrounded: the domain (else the readings' own range) spans
38
+ * the box inside its padding, and a flat or single-value series sits on the midline.
41
39
  */
42
- const monotoneAreaPath = (values, opts) => {
43
- const { width, height } = opts;
40
+ const plotY = (readings, opts) => {
41
+ const { height } = opts;
44
42
  const padding = opts.padding ?? 0;
45
- if (values.length === 0) return {
46
- line: "",
47
- area: ""
48
- };
49
43
  const innerH = height - padding * 2;
50
- const max = opts.domain?.max ?? Math.max(...values);
51
- const min = opts.domain?.min ?? Math.min(...values);
44
+ const max = opts.domain?.max ?? Math.max(...readings);
45
+ const min = opts.domain?.min ?? Math.min(...readings);
52
46
  const span = max - min || 1;
53
- const x = (i) => round(values.length > 1 ? i / (values.length - 1) * width : 0);
54
- const y = (v) => round(max === min ? height / 2 : padding + innerH - (v - min) / span * innerH);
55
- const v0 = values[0] ?? 0;
56
- if (values.length === 1) return {
57
- line: `M0,${y(v0)} L${round(width)},${y(v0)}`,
58
- area: ""
59
- };
47
+ return (v) => max === min ? height / 2 : padding + innerH - (v - min) / span * innerH;
48
+ };
49
+ const yScale = (readings, opts) => {
50
+ const y = plotY(readings, opts);
51
+ return (v) => round(y(v));
52
+ };
53
+ /** The monotone cubic through `values`, each placed at `x` of its index within them. */
54
+ const curveThrough = (values, x, y) => {
60
55
  const tangents = computeTangents(values);
61
- let line = `M${x(0)},${y(v0)}`;
56
+ let line = `M${x(0)},${y(values[0] ?? 0)}`;
62
57
  for (let i = 0; i < values.length - 1; i++) {
63
58
  const x0 = i;
64
59
  const x1 = i + 1;
@@ -72,13 +67,84 @@ const monotoneAreaPath = (values, opts) => {
72
67
  const cp2y = round(y(vi1 - ti1 / 3));
73
68
  line += ` C${cp1x},${cp1y} ${cp2x},${cp2y} ${x(x1)},${y(vi1)}`;
74
69
  }
75
- const area = `${line} L${x(values.length - 1)},${round(height)} L${x(0)},${round(height)} Z`;
70
+ return line;
71
+ };
72
+ /**
73
+ * SVG paths for a monotone-cubic line and its closed area fill in a `width` x `height` box; a flat
74
+ * or single-value series sits on the vertical midline.
75
+ */
76
+ const monotoneAreaPath = (values, opts) => {
77
+ const { width, height } = opts;
78
+ if (values.length === 0) return {
79
+ line: "",
80
+ area: ""
81
+ };
82
+ const x = (i) => round(values.length > 1 ? i / (values.length - 1) * width : 0);
83
+ const y = yScale(values, opts);
84
+ const v0 = values[0] ?? 0;
85
+ if (values.length === 1) return {
86
+ line: `M0,${y(v0)} L${round(width)},${y(v0)}`,
87
+ area: ""
88
+ };
89
+ const line = curveThrough(values, x, y);
76
90
  return {
77
91
  line,
78
- area
92
+ area: `${line} L${x(values.length - 1)},${round(height)} L${x(0)},${round(height)} Z`
93
+ };
94
+ };
95
+ /** Index ranges of the unbroken runs of readings in a series, `end` inclusive. */
96
+ const readingRuns = (values) => {
97
+ const runs = [];
98
+ let start = null;
99
+ values.forEach((value, i) => {
100
+ if (value === null) {
101
+ if (start !== null) {
102
+ runs.push({
103
+ start,
104
+ end: i - 1
105
+ });
106
+ start = null;
107
+ }
108
+ return;
109
+ }
110
+ start ??= i;
111
+ });
112
+ if (start !== null) runs.push({
113
+ start,
114
+ end: values.length - 1
115
+ });
116
+ return runs;
117
+ };
118
+ /**
119
+ * {@link monotoneAreaPath} broken at every `null`, each run kept on the shared axes. A lone
120
+ * reading has no line to stroke, so the caller marks it with a dot.
121
+ */
122
+ const monotoneAreaSegments = (values, opts) => {
123
+ const readings = values.filter((value) => value !== null);
124
+ if (readings.length === values.length) return monotoneAreaPath(readings, opts);
125
+ if (readings.length === 0) return {
126
+ line: "",
127
+ area: ""
128
+ };
129
+ const y = yScale(readings, opts);
130
+ const step = values.length > 1 ? opts.width / (values.length - 1) : 0;
131
+ const floor = round(opts.height);
132
+ const lines = [];
133
+ const areas = [];
134
+ for (const { start, end } of readingRuns(values)) {
135
+ if (end === start) continue;
136
+ const run = values.slice(start, end + 1).filter((value) => value !== null);
137
+ const x = (i) => round((start + i) * step);
138
+ const line = curveThrough(run, x, y);
139
+ lines.push(line);
140
+ areas.push(`${line} L${x(run.length - 1)},${floor} L${x(0)},${floor} Z`);
141
+ }
142
+ return {
143
+ line: lines.join(" "),
144
+ area: areas.join(" ")
79
145
  };
80
146
  };
81
147
  //#endregion
82
- export { monotoneAreaPath };
148
+ export { monotoneAreaSegments, plotY, readingRuns };
83
149
 
84
150
  //# sourceMappingURL=spline.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"spline.js","names":[],"sources":["../../src/charts/spline.ts"],"sourcesContent":["export interface SplineGeometry {\n\tline: string\n\tarea: string\n}\n\nexport interface SplineOptions {\n\twidth: number\n\theight: number\n\tpadding?: number\n\t/** Explicit value domain, so two series drawn on one chart share a y-scale. */\n\tdomain?: { min: number; max: number }\n}\n\nconst round = (n: number): number => Math.round(n * 100) / 100\n\n/**\n * Fritsch-Carlson monotone tangents for a unit-spaced series: endpoints take the\n * adjacent secant, interior points the average of neighbouring secants, then each is\n * clamped so the cubic never overshoots (no wiggle between points).\n */\nexport const computeTangents = (ys: number[]): number[] => {\n\tconst n = ys.length\n\tif (n < 2) {\n\t\treturn ys.map(() => 0)\n\t}\n\tconst d = ys.slice(0, -1).map((y, i) => (ys[i + 1] ?? 0) - y)\n\tconst m = ys.map((_, i) => {\n\t\tif (i === 0) return d[0] ?? 0\n\t\tif (i === n - 1) return d[n - 2] ?? 0\n\t\treturn ((d[i - 1] ?? 0) + (d[i] ?? 0)) / 2\n\t})\n\tfor (let i = 0; i < n - 1; i++) {\n\t\tconst di = d[i] ?? 0\n\t\tif (di === 0) {\n\t\t\tm[i] = 0\n\t\t\tm[i + 1] = 0\n\t\t\tcontinue\n\t\t}\n\t\tconst mi = m[i] ?? 0\n\t\tconst mi1 = m[i + 1] ?? 0\n\t\tconst a = mi / di\n\t\tconst b = mi1 / di\n\t\tconst s = a * a + b * b\n\t\tif (s > 9) {\n\t\t\tconst t = 3 / Math.sqrt(s)\n\t\t\tm[i] = t * a * di\n\t\t\tm[i + 1] = t * b * di\n\t\t}\n\t}\n\treturn m\n}\n\n/**\n * Build SVG path strings for a monotone-cubic line and its closed area fill, mapping a\n * value series into a `width` x `height` box (y normalized to the value range; flat or\n * single-value series sit on the vertical midline).\n */\nexport const monotoneAreaPath = (values: number[], opts: SplineOptions): SplineGeometry => {\n\tconst { width, height } = opts\n\tconst padding = opts.padding ?? 0\n\tif (values.length === 0) {\n\t\treturn { line: '', area: '' }\n\t}\n\tconst innerH = height - padding * 2\n\tconst max = opts.domain?.max ?? Math.max(...values)\n\tconst min = opts.domain?.min ?? Math.min(...values)\n\tconst span = max - min || 1\n\tconst x = (i: number): number => round(values.length > 1 ? (i / (values.length - 1)) * width : 0)\n\tconst y = (v: number): number =>\n\t\tround(max === min ? height / 2 : padding + innerH - ((v - min) / span) * innerH)\n\tconst v0 = values[0] ?? 0\n\tif (values.length === 1) {\n\t\tconst line = `M0,${y(v0)} L${round(width)},${y(v0)}`\n\t\treturn { line, area: '' }\n\t}\n\tconst tangents = computeTangents(values)\n\tlet line = `M${x(0)},${y(v0)}`\n\tfor (let i = 0; i < values.length - 1; i++) {\n\t\tconst x0 = i\n\t\tconst x1 = i + 1\n\t\tconst vi = values[i] ?? 0\n\t\tconst vi1 = values[i + 1] ?? 0\n\t\tconst ti = tangents[i] ?? 0\n\t\tconst ti1 = tangents[i + 1] ?? 0\n\t\tconst cp1x = round(x(x0 + 1 / 3))\n\t\tconst cp1y = round(y(vi + ti / 3))\n\t\tconst cp2x = round(x(x1 - 1 / 3))\n\t\tconst cp2y = round(y(vi1 - ti1 / 3))\n\t\tline += ` C${cp1x},${cp1y} ${cp2x},${cp2y} ${x(x1)},${y(vi1)}`\n\t}\n\tconst area = `${line} L${x(values.length - 1)},${round(height)} L${x(0)},${round(height)} Z`\n\treturn { line, area }\n}\n"],"mappings":";AAaA,MAAM,SAAS,MAAsB,KAAK,MAAM,IAAI,GAAG,IAAI;;;;;;AAO3D,MAAa,mBAAmB,OAA2B;CAC1D,MAAM,IAAI,GAAG;CACb,IAAI,IAAI,GACP,OAAO,GAAG,UAAU,CAAC;CAEtB,MAAM,IAAI,GAAG,MAAM,GAAG,EAAE,EAAE,KAAK,GAAG,OAAO,GAAG,IAAI,MAAM,KAAK,CAAC;CAC5D,MAAM,IAAI,GAAG,KAAK,GAAG,MAAM;EAC1B,IAAI,MAAM,GAAG,OAAO,EAAE,MAAM;EAC5B,IAAI,MAAM,IAAI,GAAG,OAAO,EAAE,IAAI,MAAM;EACpC,SAAS,EAAE,IAAI,MAAM,MAAM,EAAE,MAAM,MAAM;CAC1C,CAAC;CACD,KAAK,IAAI,IAAI,GAAG,IAAI,IAAI,GAAG,KAAK;EAC/B,MAAM,KAAK,EAAE,MAAM;EACnB,IAAI,OAAO,GAAG;GACb,EAAE,KAAK;GACP,EAAE,IAAI,KAAK;GACX;EACD;EACA,MAAM,KAAK,EAAE,MAAM;EACnB,MAAM,MAAM,EAAE,IAAI,MAAM;EACxB,MAAM,IAAI,KAAK;EACf,MAAM,IAAI,MAAM;EAChB,MAAM,IAAI,IAAI,IAAI,IAAI;EACtB,IAAI,IAAI,GAAG;GACV,MAAM,IAAI,IAAI,KAAK,KAAK,CAAC;GACzB,EAAE,KAAK,IAAI,IAAI;GACf,EAAE,IAAI,KAAK,IAAI,IAAI;EACpB;CACD;CACA,OAAO;AACR;;;;;;AAOA,MAAa,oBAAoB,QAAkB,SAAwC;CAC1F,MAAM,EAAE,OAAO,WAAW;CAC1B,MAAM,UAAU,KAAK,WAAW;CAChC,IAAI,OAAO,WAAW,GACrB,OAAO;EAAE,MAAM;EAAI,MAAM;CAAG;CAE7B,MAAM,SAAS,SAAS,UAAU;CAClC,MAAM,MAAM,KAAK,QAAQ,OAAO,KAAK,IAAI,GAAG,MAAM;CAClD,MAAM,MAAM,KAAK,QAAQ,OAAO,KAAK,IAAI,GAAG,MAAM;CAClD,MAAM,OAAO,MAAM,OAAO;CAC1B,MAAM,KAAK,MAAsB,MAAM,OAAO,SAAS,IAAK,KAAK,OAAO,SAAS,KAAM,QAAQ,CAAC;CAChG,MAAM,KAAK,MACV,MAAM,QAAQ,MAAM,SAAS,IAAI,UAAU,UAAW,IAAI,OAAO,OAAQ,MAAM;CAChF,MAAM,KAAK,OAAO,MAAM;CACxB,IAAI,OAAO,WAAW,GAErB,OAAO;EAAE,MAAA,MADU,EAAE,EAAE,EAAE,IAAI,MAAM,KAAK,EAAE,GAAG,EAAE,EAAE;EAClC,MAAM;CAAG;CAEzB,MAAM,WAAW,gBAAgB,MAAM;CACvC,IAAI,OAAO,IAAI,EAAE,CAAC,EAAE,GAAG,EAAE,EAAE;CAC3B,KAAK,IAAI,IAAI,GAAG,IAAI,OAAO,SAAS,GAAG,KAAK;EAC3C,MAAM,KAAK;EACX,MAAM,KAAK,IAAI;EACf,MAAM,KAAK,OAAO,MAAM;EACxB,MAAM,MAAM,OAAO,IAAI,MAAM;EAC7B,MAAM,KAAK,SAAS,MAAM;EAC1B,MAAM,MAAM,SAAS,IAAI,MAAM;EAC/B,MAAM,OAAO,MAAM,EAAE,KAAK,IAAI,CAAC,CAAC;EAChC,MAAM,OAAO,MAAM,EAAE,KAAK,KAAK,CAAC,CAAC;EACjC,MAAM,OAAO,MAAM,EAAE,KAAK,IAAI,CAAC,CAAC;EAChC,MAAM,OAAO,MAAM,EAAE,MAAM,MAAM,CAAC,CAAC;EACnC,QAAQ,KAAK,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,EAAE,EAAE,EAAE,GAAG,EAAE,GAAG;CAC5D;CACA,MAAM,OAAO,GAAG,KAAK,IAAI,EAAE,OAAO,SAAS,CAAC,EAAE,GAAG,MAAM,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,GAAG,MAAM,MAAM,EAAE;CACzF,OAAO;EAAE;EAAM;CAAK;AACrB"}
1
+ {"version":3,"file":"spline.js","names":[],"sources":["../../src/charts/spline.ts"],"sourcesContent":["export interface SplineGeometry {\n\tline: string\n\tarea: string\n}\n\nexport interface SplineOptions {\n\twidth: number\n\theight: number\n\tpadding?: number\n\t/** Explicit value domain, so two series drawn on one chart share a y-scale. */\n\tdomain?: { min: number; max: number }\n}\n\nconst round = (n: number): number => Math.round(n * 100) / 100\n\n/**\n * Fritsch-Carlson monotone tangents for a unit-spaced series, clamped so the cubic never overshoots\n * between points.\n */\nexport const computeTangents = (ys: number[]): number[] => {\n\tconst n = ys.length\n\tif (n < 2) {\n\t\treturn ys.map(() => 0)\n\t}\n\tconst d = ys.slice(0, -1).map((y, i) => (ys[i + 1] ?? 0) - y)\n\tconst m = ys.map((_, i) => {\n\t\tif (i === 0) return d[0] ?? 0\n\t\tif (i === n - 1) return d[n - 2] ?? 0\n\t\treturn ((d[i - 1] ?? 0) + (d[i] ?? 0)) / 2\n\t})\n\tfor (let i = 0; i < n - 1; i++) {\n\t\tconst di = d[i] ?? 0\n\t\tif (di === 0) {\n\t\t\tm[i] = 0\n\t\t\tm[i + 1] = 0\n\t\t\tcontinue\n\t\t}\n\t\tconst mi = m[i] ?? 0\n\t\tconst mi1 = m[i + 1] ?? 0\n\t\tconst a = mi / di\n\t\tconst b = mi1 / di\n\t\tconst s = a * a + b * b\n\t\tif (s > 9) {\n\t\t\tconst t = 3 / Math.sqrt(s)\n\t\t\tm[i] = t * a * di\n\t\t\tm[i + 1] = t * b * di\n\t\t}\n\t}\n\treturn m\n}\n\n/**\n * Maps a reading onto the box's height, unrounded: the domain (else the readings' own range) spans\n * the box inside its padding, and a flat or single-value series sits on the midline.\n */\nexport const plotY = (readings: number[], opts: SplineOptions): ((v: number) => number) => {\n\tconst { height } = opts\n\tconst padding = opts.padding ?? 0\n\tconst innerH = height - padding * 2\n\tconst max = opts.domain?.max ?? Math.max(...readings)\n\tconst min = opts.domain?.min ?? Math.min(...readings)\n\tconst span = max - min || 1\n\treturn (v) => (max === min ? height / 2 : padding + innerH - ((v - min) / span) * innerH)\n}\n\nconst yScale = (readings: number[], opts: SplineOptions): ((v: number) => number) => {\n\tconst y = plotY(readings, opts)\n\treturn (v) => round(y(v))\n}\n\n/** The monotone cubic through `values`, each placed at `x` of its index within them. */\nconst curveThrough = (\n\tvalues: number[],\n\tx: (i: number) => number,\n\ty: (v: number) => number\n): string => {\n\tconst tangents = computeTangents(values)\n\tlet line = `M${x(0)},${y(values[0] ?? 0)}`\n\tfor (let i = 0; i < values.length - 1; i++) {\n\t\tconst x0 = i\n\t\tconst x1 = i + 1\n\t\tconst vi = values[i] ?? 0\n\t\tconst vi1 = values[i + 1] ?? 0\n\t\tconst ti = tangents[i] ?? 0\n\t\tconst ti1 = tangents[i + 1] ?? 0\n\t\tconst cp1x = round(x(x0 + 1 / 3))\n\t\tconst cp1y = round(y(vi + ti / 3))\n\t\tconst cp2x = round(x(x1 - 1 / 3))\n\t\tconst cp2y = round(y(vi1 - ti1 / 3))\n\t\tline += ` C${cp1x},${cp1y} ${cp2x},${cp2y} ${x(x1)},${y(vi1)}`\n\t}\n\treturn line\n}\n\n/**\n * SVG paths for a monotone-cubic line and its closed area fill in a `width` x `height` box; a flat\n * or single-value series sits on the vertical midline.\n */\nexport const monotoneAreaPath = (values: number[], opts: SplineOptions): SplineGeometry => {\n\tconst { width, height } = opts\n\tif (values.length === 0) {\n\t\treturn { line: '', area: '' }\n\t}\n\tconst x = (i: number): number => round(values.length > 1 ? (i / (values.length - 1)) * width : 0)\n\tconst y = yScale(values, opts)\n\tconst v0 = values[0] ?? 0\n\tif (values.length === 1) {\n\t\tconst line = `M0,${y(v0)} L${round(width)},${y(v0)}`\n\t\treturn { line, area: '' }\n\t}\n\tconst line = curveThrough(values, x, y)\n\tconst area = `${line} L${x(values.length - 1)},${round(height)} L${x(0)},${round(height)} Z`\n\treturn { line, area }\n}\n\n/** Index ranges of the unbroken runs of readings in a series, `end` inclusive. */\nexport const readingRuns = (\n\tvalues: Array<number | null>\n): Array<{ start: number; end: number }> => {\n\tconst runs: Array<{ start: number; end: number }> = []\n\tlet start: number | null = null\n\tvalues.forEach((value, i) => {\n\t\tif (value === null) {\n\t\t\tif (start !== null) {\n\t\t\t\truns.push({ start, end: i - 1 })\n\t\t\t\tstart = null\n\t\t\t}\n\t\t\treturn\n\t\t}\n\t\tstart ??= i\n\t})\n\tif (start !== null) {\n\t\truns.push({ start, end: values.length - 1 })\n\t}\n\treturn runs\n}\n\n/**\n * {@link monotoneAreaPath} broken at every `null`, each run kept on the shared axes. A lone\n * reading has no line to stroke, so the caller marks it with a dot.\n */\nexport const monotoneAreaSegments = (\n\tvalues: Array<number | null>,\n\topts: SplineOptions\n): SplineGeometry => {\n\tconst readings = values.filter((value): value is number => value !== null)\n\tif (readings.length === values.length) {\n\t\treturn monotoneAreaPath(readings, opts)\n\t}\n\tif (readings.length === 0) {\n\t\treturn { line: '', area: '' }\n\t}\n\tconst y = yScale(readings, opts)\n\tconst step = values.length > 1 ? opts.width / (values.length - 1) : 0\n\tconst floor = round(opts.height)\n\tconst lines: string[] = []\n\tconst areas: string[] = []\n\tfor (const { start, end } of readingRuns(values)) {\n\t\tif (end === start) {\n\t\t\tcontinue\n\t\t}\n\t\tconst run = values.slice(start, end + 1).filter((value): value is number => value !== null)\n\t\tconst x = (i: number): number => round((start + i) * step)\n\t\tconst line = curveThrough(run, x, y)\n\t\tlines.push(line)\n\t\tareas.push(`${line} L${x(run.length - 1)},${floor} L${x(0)},${floor} Z`)\n\t}\n\treturn { line: lines.join(' '), area: areas.join(' ') }\n}\n"],"mappings":";AAaA,MAAM,SAAS,MAAsB,KAAK,MAAM,IAAI,GAAG,IAAI;;;;;AAM3D,MAAa,mBAAmB,OAA2B;CAC1D,MAAM,IAAI,GAAG;CACb,IAAI,IAAI,GACP,OAAO,GAAG,UAAU,CAAC;CAEtB,MAAM,IAAI,GAAG,MAAM,GAAG,EAAE,EAAE,KAAK,GAAG,OAAO,GAAG,IAAI,MAAM,KAAK,CAAC;CAC5D,MAAM,IAAI,GAAG,KAAK,GAAG,MAAM;EAC1B,IAAI,MAAM,GAAG,OAAO,EAAE,MAAM;EAC5B,IAAI,MAAM,IAAI,GAAG,OAAO,EAAE,IAAI,MAAM;EACpC,SAAS,EAAE,IAAI,MAAM,MAAM,EAAE,MAAM,MAAM;CAC1C,CAAC;CACD,KAAK,IAAI,IAAI,GAAG,IAAI,IAAI,GAAG,KAAK;EAC/B,MAAM,KAAK,EAAE,MAAM;EACnB,IAAI,OAAO,GAAG;GACb,EAAE,KAAK;GACP,EAAE,IAAI,KAAK;GACX;EACD;EACA,MAAM,KAAK,EAAE,MAAM;EACnB,MAAM,MAAM,EAAE,IAAI,MAAM;EACxB,MAAM,IAAI,KAAK;EACf,MAAM,IAAI,MAAM;EAChB,MAAM,IAAI,IAAI,IAAI,IAAI;EACtB,IAAI,IAAI,GAAG;GACV,MAAM,IAAI,IAAI,KAAK,KAAK,CAAC;GACzB,EAAE,KAAK,IAAI,IAAI;GACf,EAAE,IAAI,KAAK,IAAI,IAAI;EACpB;CACD;CACA,OAAO;AACR;;;;;AAMA,MAAa,SAAS,UAAoB,SAAiD;CAC1F,MAAM,EAAE,WAAW;CACnB,MAAM,UAAU,KAAK,WAAW;CAChC,MAAM,SAAS,SAAS,UAAU;CAClC,MAAM,MAAM,KAAK,QAAQ,OAAO,KAAK,IAAI,GAAG,QAAQ;CACpD,MAAM,MAAM,KAAK,QAAQ,OAAO,KAAK,IAAI,GAAG,QAAQ;CACpD,MAAM,OAAO,MAAM,OAAO;CAC1B,QAAQ,MAAO,QAAQ,MAAM,SAAS,IAAI,UAAU,UAAW,IAAI,OAAO,OAAQ;AACnF;AAEA,MAAM,UAAU,UAAoB,SAAiD;CACpF,MAAM,IAAI,MAAM,UAAU,IAAI;CAC9B,QAAQ,MAAM,MAAM,EAAE,CAAC,CAAC;AACzB;;AAGA,MAAM,gBACL,QACA,GACA,MACY;CACZ,MAAM,WAAW,gBAAgB,MAAM;CACvC,IAAI,OAAO,IAAI,EAAE,CAAC,EAAE,GAAG,EAAE,OAAO,MAAM,CAAC;CACvC,KAAK,IAAI,IAAI,GAAG,IAAI,OAAO,SAAS,GAAG,KAAK;EAC3C,MAAM,KAAK;EACX,MAAM,KAAK,IAAI;EACf,MAAM,KAAK,OAAO,MAAM;EACxB,MAAM,MAAM,OAAO,IAAI,MAAM;EAC7B,MAAM,KAAK,SAAS,MAAM;EAC1B,MAAM,MAAM,SAAS,IAAI,MAAM;EAC/B,MAAM,OAAO,MAAM,EAAE,KAAK,IAAI,CAAC,CAAC;EAChC,MAAM,OAAO,MAAM,EAAE,KAAK,KAAK,CAAC,CAAC;EACjC,MAAM,OAAO,MAAM,EAAE,KAAK,IAAI,CAAC,CAAC;EAChC,MAAM,OAAO,MAAM,EAAE,MAAM,MAAM,CAAC,CAAC;EACnC,QAAQ,KAAK,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,EAAE,EAAE,EAAE,GAAG,EAAE,GAAG;CAC5D;CACA,OAAO;AACR;;;;;AAMA,MAAa,oBAAoB,QAAkB,SAAwC;CAC1F,MAAM,EAAE,OAAO,WAAW;CAC1B,IAAI,OAAO,WAAW,GACrB,OAAO;EAAE,MAAM;EAAI,MAAM;CAAG;CAE7B,MAAM,KAAK,MAAsB,MAAM,OAAO,SAAS,IAAK,KAAK,OAAO,SAAS,KAAM,QAAQ,CAAC;CAChG,MAAM,IAAI,OAAO,QAAQ,IAAI;CAC7B,MAAM,KAAK,OAAO,MAAM;CACxB,IAAI,OAAO,WAAW,GAErB,OAAO;EAAE,MAAA,MADU,EAAE,EAAE,EAAE,IAAI,MAAM,KAAK,EAAE,GAAG,EAAE,EAAE;EAClC,MAAM;CAAG;CAEzB,MAAM,OAAO,aAAa,QAAQ,GAAG,CAAC;CAEtC,OAAO;EAAE;EAAM,MAAA,GADC,KAAK,IAAI,EAAE,OAAO,SAAS,CAAC,EAAE,GAAG,MAAM,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,GAAG,MAAM,MAAM,EAAE;CACrE;AACrB;;AAGA,MAAa,eACZ,WAC2C;CAC3C,MAAM,OAA8C,CAAC;CACrD,IAAI,QAAuB;CAC3B,OAAO,SAAS,OAAO,MAAM;EAC5B,IAAI,UAAU,MAAM;GACnB,IAAI,UAAU,MAAM;IACnB,KAAK,KAAK;KAAE;KAAO,KAAK,IAAI;IAAE,CAAC;IAC/B,QAAQ;GACT;GACA;EACD;EACA,UAAU;CACX,CAAC;CACD,IAAI,UAAU,MACb,KAAK,KAAK;EAAE;EAAO,KAAK,OAAO,SAAS;CAAE,CAAC;CAE5C,OAAO;AACR;;;;;AAMA,MAAa,wBACZ,QACA,SACoB;CACpB,MAAM,WAAW,OAAO,QAAQ,UAA2B,UAAU,IAAI;CACzE,IAAI,SAAS,WAAW,OAAO,QAC9B,OAAO,iBAAiB,UAAU,IAAI;CAEvC,IAAI,SAAS,WAAW,GACvB,OAAO;EAAE,MAAM;EAAI,MAAM;CAAG;CAE7B,MAAM,IAAI,OAAO,UAAU,IAAI;CAC/B,MAAM,OAAO,OAAO,SAAS,IAAI,KAAK,SAAS,OAAO,SAAS,KAAK;CACpE,MAAM,QAAQ,MAAM,KAAK,MAAM;CAC/B,MAAM,QAAkB,CAAC;CACzB,MAAM,QAAkB,CAAC;CACzB,KAAK,MAAM,EAAE,OAAO,SAAS,YAAY,MAAM,GAAG;EACjD,IAAI,QAAQ,OACX;EAED,MAAM,MAAM,OAAO,MAAM,OAAO,MAAM,CAAC,EAAE,QAAQ,UAA2B,UAAU,IAAI;EAC1F,MAAM,KAAK,MAAsB,OAAO,QAAQ,KAAK,IAAI;EACzD,MAAM,OAAO,aAAa,KAAK,GAAG,CAAC;EACnC,MAAM,KAAK,IAAI;EACf,MAAM,KAAK,GAAG,KAAK,IAAI,EAAE,IAAI,SAAS,CAAC,EAAE,GAAG,MAAM,IAAI,EAAE,CAAC,EAAE,GAAG,MAAM,GAAG;CACxE;CACA,OAAO;EAAE,MAAM,MAAM,KAAK,GAAG;EAAG,MAAM,MAAM,KAAK,GAAG;CAAE;AACvD"}
@@ -0,0 +1,91 @@
1
+ import { monotoneAreaSegments, plotY, readingRuns } from "./spline.js";
2
+ //#region src/charts/trendGeometry.ts
3
+ /** The plot's own coordinates; the SVG stretches them over whatever box the card gives it. */
4
+ const VIEW = 1e3;
5
+ const PAD = 12;
6
+ /** Past this many buckets only a lone reading, with no line through it, gets a dot. */
7
+ const DOT_LIMIT = 12;
8
+ /** Up to `most` evenly spaced indices of `n` buckets, the first and the last among them. */
9
+ const tickIndices = (n, most) => {
10
+ if (n <= most) return Array.from({ length: n }, (_, i) => i);
11
+ if (most < 2) return [n - 1];
12
+ const step = (n - 1) / (most - 1);
13
+ return Array.from({ length: most }, (_, i) => Math.round(i * step));
14
+ };
15
+ const EMPTY_POINT = {
16
+ at: "",
17
+ label: "",
18
+ value: 0,
19
+ display: "0"
20
+ };
21
+ /** Both windows have equal bucket counts by construction; a stray length normalizes silently. */
22
+ const alignTo = (series, length) => series.length === length ? series : Array.from({ length }, (_, i) => series[i] ?? { ...EMPTY_POINT });
23
+ /** Two buckets can carry the same label ("Mon" twice over a fortnight); their starts cannot. */
24
+ const keyAt = (point, i) => point?.at || String(i);
25
+ /** How the tooltip and the data table name a bucket: its tooltip label, else its axis tick. */
26
+ const tooltipLabelOf = (point) => point?.tooltipLabel ?? point?.label ?? "";
27
+ const isReading = (value) => typeof value === "number";
28
+ /** Indices of readings with no neighbour to draw a line to, which only a dot can show. */
29
+ const loneIndices = (values) => new Set(readingRuns(values).filter((run) => run.start === run.end).map((run) => run.start));
30
+ /**
31
+ * The chart's paths, dots and ticks, laid out once per series in the fixed {@link VIEW} box, both
32
+ * series on one y-scale. An upcoming bucket keeps its place on the axis with no reading.
33
+ */
34
+ const trendGeometry = (buckets, comparison, maxTicks) => {
35
+ const upcoming = (i) => buckets[i]?.upcoming === true;
36
+ const values = buckets.map((bucket, i) => upcoming(i) ? null : bucket.value);
37
+ const n = values.length;
38
+ const previous = comparison ? alignTo(comparison, n) : void 0;
39
+ const previousValues = previous?.map((point, i) => upcoming(i) ? null : point.value);
40
+ const readings = [...values, ...previousValues ?? []].filter(isReading);
41
+ const box = {
42
+ width: VIEW,
43
+ height: VIEW,
44
+ padding: PAD,
45
+ domain: readings.length > 0 ? {
46
+ min: Math.min(...readings),
47
+ max: Math.max(...readings)
48
+ } : {
49
+ min: 0,
50
+ max: 0
51
+ }
52
+ };
53
+ const { line, area } = monotoneAreaSegments(values, box);
54
+ const x = (i) => n > 1 ? i / (n - 1) : .5;
55
+ const yInBox = plotY(readings, box);
56
+ const y = (value) => yInBox(value) / VIEW;
57
+ const dotsOf = (series, isPrevious) => {
58
+ const lone = loneIndices(series);
59
+ return series.flatMap((value, i) => isReading(value) && (n <= DOT_LIMIT || lone.has(i)) ? [{
60
+ key: `${isPrevious ? "previous-" : ""}${keyAt(buckets[i], i)}`,
61
+ x: x(i),
62
+ y: y(value),
63
+ comparison: isPrevious
64
+ }] : []);
65
+ };
66
+ const counting = buckets.findIndex((bucket) => bucket.inProgress === true);
67
+ return {
68
+ values,
69
+ reached: buckets.findLastIndex((_, i) => !upcoming(i)),
70
+ previous,
71
+ line,
72
+ area,
73
+ previousLine: previousValues ? monotoneAreaSegments(previousValues, box).line : "",
74
+ dots: [...previousValues ? dotsOf(previousValues, true) : [], ...dotsOf(values, false)],
75
+ ticks: tickIndices(n, maxTicks).map((i) => ({
76
+ i,
77
+ x: x(i),
78
+ anchor: i === 0 ? "start" : i === n - 1 ? "end" : "middle"
79
+ })),
80
+ partial: counting > 0 ? {
81
+ from: x(counting - 1) * VIEW,
82
+ to: x(counting) * VIEW
83
+ } : null,
84
+ x,
85
+ y
86
+ };
87
+ };
88
+ //#endregion
89
+ export { VIEW, isReading, keyAt, tooltipLabelOf, trendGeometry };
90
+
91
+ //# sourceMappingURL=trendGeometry.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"trendGeometry.js","names":[],"sources":["../../src/charts/trendGeometry.ts"],"sourcesContent":["import type { MetricValue } from '../core/contract'\nimport { monotoneAreaSegments, plotY, readingRuns } from './spline'\nimport type { TrendPoint } from './TrendChart'\n\n/** The plot's own coordinates; the SVG stretches them over whatever box the card gives it. */\nexport const VIEW = 1000\nconst PAD = 12\n/** Past this many buckets only a lone reading, with no line through it, gets a dot. */\nconst DOT_LIMIT = 12\n\nexport interface Tick {\n\ti: number\n\t/** The tick's position across the plot, `0` to `1`. */\n\tx: number\n\tanchor: 'start' | 'middle' | 'end'\n}\n\nexport interface Dot {\n\tkey: string\n\tx: number\n\ty: number\n\tcomparison: boolean\n}\n\n/** Everything drawn from the data alone, so a hover redraws only the cursor and the readout. */\nexport interface TrendGeometry {\n\tvalues: MetricValue[]\n\t/** The last bucket that has begun: the readout walks no further, into the hours to come. */\n\treached: number\n\tprevious: TrendPoint[] | undefined\n\tline: string\n\tarea: string\n\tpreviousLine: string\n\t/** The comparison's dots, then the series' own. */\n\tdots: Dot[]\n\tticks: Tick[]\n\t/**\n\t * The stretch of the plot, in its own units, between the last finished bucket and the one still\n\t * counting; null when every bucket drawn is finished.\n\t */\n\tpartial: { from: number; to: number } | null\n\t/** A bucket's position across the plot, `0` to `1`, in reading order. */\n\tx: (i: number) => number\n\t/** A reading's position down the plot, `0` to `1`. */\n\ty: (value: number) => number\n}\n\n/** Up to `most` evenly spaced indices of `n` buckets, the first and the last among them. */\nconst tickIndices = (n: number, most: number): number[] => {\n\tif (n <= most) {\n\t\treturn Array.from({ length: n }, (_, i) => i)\n\t}\n\tif (most < 2) {\n\t\treturn [n - 1]\n\t}\n\tconst step = (n - 1) / (most - 1)\n\treturn Array.from({ length: most }, (_, i) => Math.round(i * step))\n}\n\nconst EMPTY_POINT: TrendPoint = { at: '', label: '', value: 0, display: '0' }\n\n/** Both windows have equal bucket counts by construction; a stray length normalizes silently. */\nconst alignTo = (series: TrendPoint[], length: number): TrendPoint[] =>\n\tseries.length === length\n\t\t? series\n\t\t: Array.from({ length }, (_, i) => series[i] ?? { ...EMPTY_POINT })\n\n/** Two buckets can carry the same label (\"Mon\" twice over a fortnight); their starts cannot. */\nexport const keyAt = (point: TrendPoint | undefined, i: number): string => point?.at || String(i)\n\n/** How the tooltip and the data table name a bucket: its tooltip label, else its axis tick. */\nexport const tooltipLabelOf = (point: TrendPoint | undefined): string =>\n\tpoint?.tooltipLabel ?? point?.label ?? ''\n\nexport const isReading = (value: MetricValue | undefined): value is number =>\n\ttypeof value === 'number'\n\n/** Indices of readings with no neighbour to draw a line to, which only a dot can show. */\nconst loneIndices = (values: MetricValue[]): Set<number> =>\n\tnew Set(\n\t\treadingRuns(values)\n\t\t\t.filter((run) => run.start === run.end)\n\t\t\t.map((run) => run.start)\n\t)\n\n/**\n * The chart's paths, dots and ticks, laid out once per series in the fixed {@link VIEW} box, both\n * series on one y-scale. An upcoming bucket keeps its place on the axis with no reading.\n */\nexport const trendGeometry = (\n\tbuckets: TrendPoint[],\n\tcomparison: TrendPoint[] | undefined,\n\tmaxTicks: number\n): TrendGeometry => {\n\tconst upcoming = (i: number): boolean => buckets[i]?.upcoming === true\n\tconst values = buckets.map((bucket, i) => (upcoming(i) ? null : bucket.value))\n\tconst n = values.length\n\tconst previous = comparison ? alignTo(comparison, n) : undefined\n\tconst previousValues = previous?.map((point, i) => (upcoming(i) ? null : point.value))\n\tconst readings = [...values, ...(previousValues ?? [])].filter(isReading)\n\tconst domain =\n\t\treadings.length > 0\n\t\t\t? { min: Math.min(...readings), max: Math.max(...readings) }\n\t\t\t: { min: 0, max: 0 }\n\tconst box = { width: VIEW, height: VIEW, padding: PAD, domain }\n\tconst { line, area } = monotoneAreaSegments(values, box)\n\tconst x = (i: number): number => (n > 1 ? i / (n - 1) : 0.5)\n\tconst yInBox = plotY(readings, box)\n\tconst y = (value: number): number => yInBox(value) / VIEW\n\tconst dotsOf = (series: MetricValue[], isPrevious: boolean): Dot[] => {\n\t\tconst lone = loneIndices(series)\n\t\treturn series.flatMap((value, i) =>\n\t\t\tisReading(value) && (n <= DOT_LIMIT || lone.has(i))\n\t\t\t\t? [\n\t\t\t\t\t\t{\n\t\t\t\t\t\t\tkey: `${isPrevious ? 'previous-' : ''}${keyAt(buckets[i], i)}`,\n\t\t\t\t\t\t\tx: x(i),\n\t\t\t\t\t\t\ty: y(value),\n\t\t\t\t\t\t\tcomparison: isPrevious,\n\t\t\t\t\t\t},\n\t\t\t\t\t]\n\t\t\t\t: []\n\t\t)\n\t}\n\tconst counting = buckets.findIndex((bucket) => bucket.inProgress === true)\n\treturn {\n\t\tvalues,\n\t\treached: buckets.findLastIndex((_, i) => !upcoming(i)),\n\t\tprevious,\n\t\tline,\n\t\tarea,\n\t\tpreviousLine: previousValues ? monotoneAreaSegments(previousValues, box).line : '',\n\t\tdots: [...(previousValues ? dotsOf(previousValues, true) : []), ...dotsOf(values, false)],\n\t\tticks: tickIndices(n, maxTicks).map((i) => ({\n\t\t\ti,\n\t\t\tx: x(i),\n\t\t\tanchor: i === 0 ? 'start' : i === n - 1 ? 'end' : 'middle',\n\t\t})),\n\t\tpartial: counting > 0 ? { from: x(counting - 1) * VIEW, to: x(counting) * VIEW } : null,\n\t\tx,\n\t\ty,\n\t}\n}\n"],"mappings":"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"}
@@ -0,0 +1 @@
1
+ export { };
@@ -0,0 +1,198 @@
1
+ import { isRecord, kindOf, listOf, onlyKeys } from "./values.js";
2
+ import { METRIC_KEYS } from "../translations/metricKeys.js";
3
+ import { keysOf, optionalBoolean, optionalList, optionsObject } from "./optionChecks.js";
4
+ import { TIMEFRAME_PRESETS } from "../timeframe/presets.js";
5
+ import { assertRequirementKeys } from "./capabilities.js";
6
+ import { BUILT_IN_WIDGET_SLUGS, isBuiltInWidgetSlug } from "./widgetSlugs.js";
7
+ //#region src/core/adminOptions.ts
8
+ const VIEW_KEYS = keysOf({
9
+ path: true,
10
+ defaultRange: true,
11
+ defaultMetric: true,
12
+ navLabel: true,
13
+ navLink: true,
14
+ Component: true
15
+ });
16
+ const WIDGETS_KEYS = keysOf({
17
+ disabled: true,
18
+ register: true,
19
+ localizeText: true,
20
+ comparison: true,
21
+ overrides: true
22
+ });
23
+ const WIDGET_DEF_KEYS = keysOf({
24
+ slug: true,
25
+ component: true,
26
+ label: true,
27
+ fields: true,
28
+ requires: true,
29
+ minWidth: true,
30
+ maxWidth: true
31
+ });
32
+ const WIDGET_WIDTHS = keysOf({
33
+ "x-small": true,
34
+ small: true,
35
+ medium: true,
36
+ large: true,
37
+ "x-large": true,
38
+ full: true
39
+ });
40
+ const DEFAULT_VIEW = {
41
+ path: "/analytics",
42
+ defaultRange: "last30days",
43
+ defaultMetric: "pageviews",
44
+ navLink: true
45
+ };
46
+ /** A label as Payload takes one without a function: a string, or a map of strings by language. */
47
+ const isStaticLabel = (value) => typeof value === "string" || isRecord(value) && Object.values(value).every((text) => typeof text === "string");
48
+ /**
49
+ * A component option as Payload takes one, checked at boot: a typo'd shape would otherwise
50
+ * surface only as an empty slot once an admin page renders.
51
+ */
52
+ const resolveComponent = (value, path) => {
53
+ if (typeof value === "string" && value.trim() !== "") return value;
54
+ if (isRecord(value)) {
55
+ onlyKeys(value, [
56
+ "path",
57
+ "exportName",
58
+ "clientProps",
59
+ "serverProps"
60
+ ], path);
61
+ const { exportName, clientProps, serverProps } = value;
62
+ if (typeof value.path === "string" && value.path.trim() !== "" && (exportName === void 0 || typeof exportName === "string") && (clientProps === void 0 || isRecord(clientProps)) && (serverProps === void 0 || isRecord(serverProps))) return {
63
+ path: value.path,
64
+ ...exportName === void 0 ? {} : { exportName },
65
+ ...clientProps === void 0 ? {} : { clientProps },
66
+ ...serverProps === void 0 ? {} : { serverProps }
67
+ };
68
+ }
69
+ throw new Error(`analytics: ${path} must be a component path such as '/components/Flag#Flag', or { path, exportName?, clientProps?, serverProps? }, got ${kindOf(value)}`);
70
+ };
71
+ /** `view`: off with `false`, else its path, opening range and metric, nav label and component. */
72
+ const resolveView = (option) => {
73
+ if (option === false) return false;
74
+ if (option !== void 0) {
75
+ optionsObject(option, {
76
+ path: "view",
77
+ known: VIEW_KEYS,
78
+ example: "false, or an object such as { path: '/analytics' }"
79
+ });
80
+ const navLabel = option.navLabel;
81
+ if (navLabel !== void 0 && (!isStaticLabel(navLabel) || Array.isArray(navLabel))) throw new Error(`analytics: view.navLabel must be a label, or a map of labels by language such as { en: 'Stats' }, got ${kindOf(navLabel)}`);
82
+ }
83
+ const path = option?.path ?? DEFAULT_VIEW.path;
84
+ if (typeof path !== "string" || !path.startsWith("/")) throw new Error(`analytics: view.path must start with "/", got "${String(path)}"`);
85
+ const defaultRange = option?.defaultRange ?? DEFAULT_VIEW.defaultRange;
86
+ if (!TIMEFRAME_PRESETS.includes(defaultRange)) throw new Error(`analytics: unknown view.defaultRange "${String(defaultRange)}"`);
87
+ const defaultMetric = option?.defaultMetric ?? DEFAULT_VIEW.defaultMetric;
88
+ if (!(defaultMetric in METRIC_KEYS)) throw new Error(`analytics: unknown view.defaultMetric "${String(defaultMetric)}"`);
89
+ const navLink = option?.navLink ?? DEFAULT_VIEW.navLink;
90
+ if (typeof navLink !== "boolean") throw new Error(`analytics: view.navLink must be a boolean, got ${kindOf(navLink)}`);
91
+ return {
92
+ path,
93
+ defaultRange,
94
+ defaultMetric,
95
+ navLink,
96
+ ...option?.navLabel !== void 0 ? { navLabel: option.navLabel } : {},
97
+ ...option?.Component !== void 0 ? { Component: resolveComponent(option.Component, "view.Component") } : {}
98
+ };
99
+ };
100
+ /** `countryFlags`: a switch, or the host's own flag component. */
101
+ const resolveCountryFlags = (option) => {
102
+ if (option === void 0 || typeof option === "boolean") return option ?? true;
103
+ if (!isRecord(option)) throw new Error(`analytics: countryFlags must be a boolean or { Component }, got ${kindOf(option)}`);
104
+ onlyKeys(option, ["Component"], "countryFlags");
105
+ return { Component: resolveComponent(option.Component, "countryFlags.Component") };
106
+ };
107
+ /** `widgets.overrides`, each entry naming a built-in widget and holding only what can change. */
108
+ const resolveWidgetOverrides = (overrides) => {
109
+ if (overrides === void 0) return {};
110
+ if (!isRecord(overrides)) throw new Error(`analytics: widgets.overrides must be an object keyed by widget slug, got ${kindOf(overrides)}`);
111
+ const out = {};
112
+ for (const [slug, override] of Object.entries(overrides)) {
113
+ if (!isBuiltInWidgetSlug(slug)) throw new Error(`analytics: widgets.overrides names "${slug}", which is no built-in widget. The built-in ones are ${listOf(BUILT_IN_WIDGET_SLUGS)}; a widget of your own goes in widgets.register`);
114
+ if (override === void 0) continue;
115
+ const path = `widgets.overrides.${slug}`;
116
+ if (!isRecord(override)) throw new Error(`analytics: ${path} must be an object, got ${kindOf(override)}`);
117
+ onlyKeys(override, [
118
+ "Component",
119
+ "label",
120
+ "fields"
121
+ ], path);
122
+ const { Component, label, fields } = overrides[slug] ?? {};
123
+ if (label !== void 0 && typeof label !== "function" && !isStaticLabel(label)) throw new Error(`analytics: ${path}.label must be a string, a map of strings by language, or a label function, got ${kindOf(label)}`);
124
+ if (fields !== void 0 && typeof fields !== "function") throw new Error(`analytics: ${path}.fields must be a function receiving { defaultFields }, the widget's own fields, got ${kindOf(fields)}`);
125
+ out[slug] = {
126
+ ...Component === void 0 ? {} : { Component: resolveComponent(Component, `${path}.Component`) },
127
+ ...label === void 0 ? {} : { label },
128
+ ...fields === void 0 ? {} : { fields }
129
+ };
130
+ }
131
+ return out;
132
+ };
133
+ /** One `widgets.register` entry at `at`; answers its slug. */
134
+ const assertWidgetDef = (def, at) => {
135
+ const entry = optionsObject(def, {
136
+ path: at,
137
+ known: WIDGET_DEF_KEYS,
138
+ example: "a widget such as { slug: 'my-widget', component: '/widgets/My#My', label: 'Mine' }"
139
+ });
140
+ const { slug, component, label, requires } = entry;
141
+ if (typeof slug !== "string" || slug.trim() === "") throw new Error(`analytics: ${at}.slug must be a widget slug, got ${kindOf(slug)}`);
142
+ if (typeof component !== "string" || component.trim() === "") throw new Error(`analytics: ${at}.component must be a component path such as '/widgets/My#My', got ${kindOf(component)}`);
143
+ if (typeof label !== "function" && !isStaticLabel(label)) throw new Error(`analytics: ${at}.label must be a label, a map of labels by language, or a label function, got ${kindOf(label)}`);
144
+ optionalList(entry.fields, `${at}.fields`, "[{ name: 'title', type: 'text' }]");
145
+ if (requires !== void 0) {
146
+ if (!isRecord(requires) || Array.isArray(requires)) throw new Error(`analytics: ${at}.requires must be a capability requirement such as { metrics: ['pageviews'] }, got ${kindOf(requires)}`);
147
+ assertRequirementKeys(requires, `${at}.requires`);
148
+ }
149
+ for (const key of ["minWidth", "maxWidth"]) {
150
+ const width = entry[key];
151
+ if (width !== void 0 && (typeof width !== "string" || !WIDGET_WIDTHS.includes(width))) throw new Error(`analytics: ${at}.${key} must be one of ${listOf(WIDGET_WIDTHS)}, got ${kindOf(width)}`);
152
+ }
153
+ return slug;
154
+ };
155
+ /** `widgets` in its object form: its switches, the widgets it adds, and the ones it leaves out. */
156
+ const assertWidgetsShape = (option) => {
157
+ const shaped = optionsObject(option, {
158
+ path: "widgets",
159
+ known: WIDGETS_KEYS,
160
+ example: "true, false or an object such as { disabled: [] }"
161
+ });
162
+ optionalBoolean(shaped.localizeText, "widgets.localizeText");
163
+ optionalBoolean(shaped.comparison, "widgets.comparison");
164
+ const defs = optionalList(shaped.register, "widgets.register", "[{ slug: 'my-widget', component: '/widgets/My#My', label: 'Mine' }]");
165
+ const registered = new Set(defs.map((def, index) => assertWidgetDef(def, `widgets.register[${index}]`)));
166
+ for (const slug of optionalList(shaped.disabled, "widgets.disabled", "['analytics-realtime']")) if (typeof slug !== "string" || !isBuiltInWidgetSlug(slug) && !registered.has(slug)) throw new Error(`analytics: widgets.disabled names ${kindOf(slug)}, which is no widget of this install. The built-in ones are ${listOf(BUILT_IN_WIDGET_SLUGS)}; a widget of your own is named by its widgets.register slug`);
167
+ };
168
+ /** `widgets`: on by default, off with `false`, or an object of switches, additions, overrides. */
169
+ const resolveWidgets = (option) => {
170
+ const defaults = {
171
+ disabled: [],
172
+ register: [],
173
+ localizeText: false,
174
+ comparison: true,
175
+ overrides: {}
176
+ };
177
+ if (option === false) return {
178
+ enabled: false,
179
+ ...defaults
180
+ };
181
+ if (option === void 0 || option === true) return {
182
+ enabled: true,
183
+ ...defaults
184
+ };
185
+ assertWidgetsShape(option);
186
+ return {
187
+ enabled: true,
188
+ disabled: option.disabled ?? [],
189
+ register: option.register ?? [],
190
+ localizeText: option.localizeText ?? false,
191
+ comparison: option.comparison ?? true,
192
+ overrides: resolveWidgetOverrides(option.overrides)
193
+ };
194
+ };
195
+ //#endregion
196
+ export { DEFAULT_VIEW, resolveCountryFlags, resolveView, resolveWidgets };
197
+
198
+ //# sourceMappingURL=adminOptions.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"adminOptions.js","names":[],"sources":["../../src/core/adminOptions.ts"],"sourcesContent":["import type { WidgetWidth } from 'payload'\nimport { TIMEFRAME_PRESETS } from '../timeframe/presets'\nimport { METRIC_KEYS } from '../translations/metricKeys'\nimport type { CustomWidgetDef } from '../widgets/customWidget'\nimport { assertRequirementKeys } from './capabilities'\nimport { keysOf, optionalBoolean, optionalList, optionsObject } from './optionChecks'\nimport type {\n\tAnalyticsComponent,\n\tAnalyticsCountryFlags,\n\tAnalyticsPluginOptions,\n\tAnalyticsViewOptions,\n\tAnalyticsWidgetOverride,\n\tAnalyticsWidgetOverrides,\n\tAnalyticsWidgetsOptions,\n\tResolvedOptions,\n\tResolvedView,\n} from './options'\nimport { isRecord, kindOf, listOf, onlyKeys } from './values'\nimport { BUILT_IN_WIDGET_SLUGS, isBuiltInWidgetSlug } from './widgetSlugs'\n\nconst VIEW_KEYS = keysOf<AnalyticsViewOptions>({\n\tpath: true,\n\tdefaultRange: true,\n\tdefaultMetric: true,\n\tnavLabel: true,\n\tnavLink: true,\n\tComponent: true,\n})\nconst WIDGETS_KEYS = keysOf<AnalyticsWidgetsOptions>({\n\tdisabled: true,\n\tregister: true,\n\tlocalizeText: true,\n\tcomparison: true,\n\toverrides: true,\n})\nconst WIDGET_DEF_KEYS = keysOf<CustomWidgetDef>({\n\tslug: true,\n\tcomponent: true,\n\tlabel: true,\n\tfields: true,\n\trequires: true,\n\tminWidth: true,\n\tmaxWidth: true,\n})\nconst WIDGET_WIDTHS = keysOf<Record<WidgetWidth, true>>({\n\t'x-small': true,\n\tsmall: true,\n\tmedium: true,\n\tlarge: true,\n\t'x-large': true,\n\tfull: true,\n})\n\nexport const DEFAULT_VIEW: ResolvedView = {\n\tpath: '/analytics',\n\tdefaultRange: 'last30days',\n\tdefaultMetric: 'pageviews',\n\tnavLink: true,\n}\n\n/** A label as Payload takes one without a function: a string, or a map of strings by language. */\nconst isStaticLabel = (value: unknown): boolean =>\n\ttypeof value === 'string' ||\n\t(isRecord(value) && Object.values(value).every((text) => typeof text === 'string'))\n\n/**\n * A component option as Payload takes one, checked at boot: a typo'd shape would otherwise\n * surface only as an empty slot once an admin page renders.\n */\nconst resolveComponent = (value: unknown, path: string): AnalyticsComponent => {\n\tif (typeof value === 'string' && value.trim() !== '') {\n\t\treturn value\n\t}\n\tif (isRecord(value)) {\n\t\tonlyKeys(value, ['path', 'exportName', 'clientProps', 'serverProps'], path)\n\t\tconst { exportName, clientProps, serverProps } = value\n\t\tif (\n\t\t\ttypeof value.path === 'string' &&\n\t\t\tvalue.path.trim() !== '' &&\n\t\t\t(exportName === undefined || typeof exportName === 'string') &&\n\t\t\t(clientProps === undefined || isRecord(clientProps)) &&\n\t\t\t(serverProps === undefined || isRecord(serverProps))\n\t\t) {\n\t\t\treturn {\n\t\t\t\tpath: value.path,\n\t\t\t\t...(exportName === undefined ? {} : { exportName }),\n\t\t\t\t...(clientProps === undefined ? {} : { clientProps }),\n\t\t\t\t...(serverProps === undefined ? {} : { serverProps }),\n\t\t\t}\n\t\t}\n\t}\n\tthrow new Error(\n\t\t`analytics: ${path} must be a component path such as '/components/Flag#Flag', or { path, exportName?, clientProps?, serverProps? }, got ${kindOf(value)}`\n\t)\n}\n\n/** `view`: off with `false`, else its path, opening range and metric, nav label and component. */\nexport const resolveView = (option: AnalyticsPluginOptions['view']): false | ResolvedView => {\n\tif (option === false) {\n\t\treturn false\n\t}\n\tif (option !== undefined) {\n\t\toptionsObject(option, {\n\t\t\tpath: 'view',\n\t\t\tknown: VIEW_KEYS,\n\t\t\texample: \"false, or an object such as { path: '/analytics' }\",\n\t\t})\n\t\tconst navLabel: unknown = option.navLabel\n\t\tif (navLabel !== undefined && (!isStaticLabel(navLabel) || Array.isArray(navLabel))) {\n\t\t\tthrow new Error(\n\t\t\t\t`analytics: view.navLabel must be a label, or a map of labels by language such as { en: 'Stats' }, got ${kindOf(navLabel)}`\n\t\t\t)\n\t\t}\n\t}\n\tconst path = option?.path ?? DEFAULT_VIEW.path\n\tif (typeof path !== 'string' || !path.startsWith('/')) {\n\t\tthrow new Error(`analytics: view.path must start with \"/\", got \"${String(path)}\"`)\n\t}\n\tconst defaultRange = option?.defaultRange ?? DEFAULT_VIEW.defaultRange\n\tif (!TIMEFRAME_PRESETS.includes(defaultRange)) {\n\t\tthrow new Error(`analytics: unknown view.defaultRange \"${String(defaultRange)}\"`)\n\t}\n\tconst defaultMetric = option?.defaultMetric ?? DEFAULT_VIEW.defaultMetric\n\tif (!(defaultMetric in METRIC_KEYS)) {\n\t\tthrow new Error(`analytics: unknown view.defaultMetric \"${String(defaultMetric)}\"`)\n\t}\n\tconst navLink: unknown = option?.navLink ?? DEFAULT_VIEW.navLink\n\tif (typeof navLink !== 'boolean') {\n\t\tthrow new Error(`analytics: view.navLink must be a boolean, got ${kindOf(navLink)}`)\n\t}\n\treturn {\n\t\tpath,\n\t\tdefaultRange,\n\t\tdefaultMetric,\n\t\tnavLink,\n\t\t...(option?.navLabel !== undefined ? { navLabel: option.navLabel } : {}),\n\t\t...(option?.Component !== undefined\n\t\t\t? { Component: resolveComponent(option.Component, 'view.Component') }\n\t\t\t: {}),\n\t}\n}\n\n/** `countryFlags`: a switch, or the host's own flag component. */\nexport const resolveCountryFlags = (\n\toption: AnalyticsPluginOptions['countryFlags']\n): boolean | AnalyticsCountryFlags => {\n\tif (option === undefined || typeof option === 'boolean') {\n\t\treturn option ?? true\n\t}\n\tif (!isRecord(option)) {\n\t\tthrow new Error(\n\t\t\t`analytics: countryFlags must be a boolean or { Component }, got ${kindOf(option)}`\n\t\t)\n\t}\n\tonlyKeys(option, ['Component'], 'countryFlags')\n\treturn { Component: resolveComponent(option.Component, 'countryFlags.Component') }\n}\n\n/** `widgets.overrides`, each entry naming a built-in widget and holding only what can change. */\nconst resolveWidgetOverrides = (\n\toverrides: AnalyticsWidgetOverrides | undefined\n): AnalyticsWidgetOverrides => {\n\tif (overrides === undefined) {\n\t\treturn {}\n\t}\n\tif (!isRecord(overrides)) {\n\t\tthrow new Error(\n\t\t\t`analytics: widgets.overrides must be an object keyed by widget slug, got ${kindOf(overrides)}`\n\t\t)\n\t}\n\tconst out: AnalyticsWidgetOverrides = {}\n\tfor (const [slug, override] of Object.entries(overrides)) {\n\t\tif (!isBuiltInWidgetSlug(slug)) {\n\t\t\tthrow new Error(\n\t\t\t\t`analytics: widgets.overrides names \"${slug}\", which is no built-in widget. The built-in ones are ${listOf(BUILT_IN_WIDGET_SLUGS)}; a widget of your own goes in widgets.register`\n\t\t\t)\n\t\t}\n\t\tif (override === undefined) {\n\t\t\tcontinue\n\t\t}\n\t\tconst path = `widgets.overrides.${slug}`\n\t\tif (!isRecord(override)) {\n\t\t\tthrow new Error(`analytics: ${path} must be an object, got ${kindOf(override)}`)\n\t\t}\n\t\tonlyKeys(override, ['Component', 'label', 'fields'], path)\n\t\tconst { Component, label, fields }: AnalyticsWidgetOverride = overrides[slug] ?? {}\n\t\tif (label !== undefined && typeof label !== 'function' && !isStaticLabel(label)) {\n\t\t\tthrow new Error(\n\t\t\t\t`analytics: ${path}.label must be a string, a map of strings by language, or a label function, got ${kindOf(label)}`\n\t\t\t)\n\t\t}\n\t\tif (fields !== undefined && typeof fields !== 'function') {\n\t\t\tthrow new Error(\n\t\t\t\t`analytics: ${path}.fields must be a function receiving { defaultFields }, the widget's own fields, got ${kindOf(fields)}`\n\t\t\t)\n\t\t}\n\t\tout[slug] = {\n\t\t\t...(Component === undefined\n\t\t\t\t? {}\n\t\t\t\t: { Component: resolveComponent(Component, `${path}.Component`) }),\n\t\t\t...(label === undefined ? {} : { label }),\n\t\t\t...(fields === undefined ? {} : { fields }),\n\t\t}\n\t}\n\treturn out\n}\n\n/** One `widgets.register` entry at `at`; answers its slug. */\nconst assertWidgetDef = (def: unknown, at: string): string => {\n\tconst entry = optionsObject(def, {\n\t\tpath: at,\n\t\tknown: WIDGET_DEF_KEYS,\n\t\texample: \"a widget such as { slug: 'my-widget', component: '/widgets/My#My', label: 'Mine' }\",\n\t})\n\tconst { slug, component, label, requires } = entry\n\tif (typeof slug !== 'string' || slug.trim() === '') {\n\t\tthrow new Error(`analytics: ${at}.slug must be a widget slug, got ${kindOf(slug)}`)\n\t}\n\tif (typeof component !== 'string' || component.trim() === '') {\n\t\tthrow new Error(\n\t\t\t`analytics: ${at}.component must be a component path such as '/widgets/My#My', got ${kindOf(component)}`\n\t\t)\n\t}\n\tif (typeof label !== 'function' && !isStaticLabel(label)) {\n\t\tthrow new Error(\n\t\t\t`analytics: ${at}.label must be a label, a map of labels by language, or a label function, got ${kindOf(label)}`\n\t\t)\n\t}\n\toptionalList(entry.fields, `${at}.fields`, \"[{ name: 'title', type: 'text' }]\")\n\tif (requires !== undefined) {\n\t\tif (!isRecord(requires) || Array.isArray(requires)) {\n\t\t\tthrow new Error(\n\t\t\t\t`analytics: ${at}.requires must be a capability requirement such as { metrics: ['pageviews'] }, got ${kindOf(requires)}`\n\t\t\t)\n\t\t}\n\t\tassertRequirementKeys(requires, `${at}.requires`)\n\t}\n\tfor (const key of ['minWidth', 'maxWidth'] as const) {\n\t\tconst width = entry[key]\n\t\tif (width !== undefined && (typeof width !== 'string' || !WIDGET_WIDTHS.includes(width))) {\n\t\t\tthrow new Error(\n\t\t\t\t`analytics: ${at}.${key} must be one of ${listOf(WIDGET_WIDTHS)}, got ${kindOf(width)}`\n\t\t\t)\n\t\t}\n\t}\n\treturn slug\n}\n\n/** `widgets` in its object form: its switches, the widgets it adds, and the ones it leaves out. */\nconst assertWidgetsShape = (option: AnalyticsWidgetsOptions): void => {\n\tconst shaped = optionsObject(option, {\n\t\tpath: 'widgets',\n\t\tknown: WIDGETS_KEYS,\n\t\texample: 'true, false or an object such as { disabled: [] }',\n\t})\n\toptionalBoolean(shaped.localizeText, 'widgets.localizeText')\n\toptionalBoolean(shaped.comparison, 'widgets.comparison')\n\tconst defs = optionalList(\n\t\tshaped.register,\n\t\t'widgets.register',\n\t\t\"[{ slug: 'my-widget', component: '/widgets/My#My', label: 'Mine' }]\"\n\t)\n\tconst registered = new Set(\n\t\tdefs.map((def, index) => assertWidgetDef(def, `widgets.register[${index}]`))\n\t)\n\tfor (const slug of optionalList(shaped.disabled, 'widgets.disabled', \"['analytics-realtime']\")) {\n\t\tif (typeof slug !== 'string' || (!isBuiltInWidgetSlug(slug) && !registered.has(slug))) {\n\t\t\tthrow new Error(\n\t\t\t\t`analytics: widgets.disabled names ${kindOf(slug)}, which is no widget of this install. The built-in ones are ${listOf(BUILT_IN_WIDGET_SLUGS)}; a widget of your own is named by its widgets.register slug`\n\t\t\t)\n\t\t}\n\t}\n}\n\n/** `widgets`: on by default, off with `false`, or an object of switches, additions, overrides. */\nexport const resolveWidgets = (\n\toption: AnalyticsPluginOptions['widgets']\n): ResolvedOptions['widgets'] => {\n\tconst defaults = {\n\t\tdisabled: [],\n\t\tregister: [],\n\t\tlocalizeText: false,\n\t\tcomparison: true,\n\t\toverrides: {},\n\t}\n\tif (option === false) {\n\t\treturn { enabled: false, ...defaults }\n\t}\n\tif (option === undefined || option === true) {\n\t\treturn { enabled: true, ...defaults }\n\t}\n\tassertWidgetsShape(option)\n\treturn {\n\t\tenabled: true,\n\t\tdisabled: option.disabled ?? [],\n\t\tregister: option.register ?? [],\n\t\tlocalizeText: option.localizeText ?? false,\n\t\tcomparison: option.comparison ?? true,\n\t\toverrides: resolveWidgetOverrides(option.overrides),\n\t}\n}\n"],"mappings":"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"}
@@ -0,0 +1,24 @@
1
+ //#region src/core/budget.ts
2
+ /** What {@link withinBudget} answers when the time ran out first. */
3
+ const OVER_BUDGET = Symbol("analytics/overBudget");
4
+ /**
5
+ * Settles with `work`, or with {@link OVER_BUDGET} once `ms` pass. The work is not cancelled: it
6
+ * runs on, and a failure after the budget is dropped rather than left unhandled.
7
+ */
8
+ const withinBudget = async (work, ms) => {
9
+ let timer;
10
+ const elapsed = new Promise((resolve) => {
11
+ timer = setTimeout(() => resolve(OVER_BUDGET), ms);
12
+ timer.unref?.();
13
+ });
14
+ work.catch(() => {});
15
+ try {
16
+ return await Promise.race([work, elapsed]);
17
+ } finally {
18
+ clearTimeout(timer);
19
+ }
20
+ };
21
+ //#endregion
22
+ export { OVER_BUDGET, withinBudget };
23
+
24
+ //# sourceMappingURL=budget.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"budget.js","names":[],"sources":["../../src/core/budget.ts"],"sourcesContent":["/** What {@link withinBudget} answers when the time ran out first. */\nexport const OVER_BUDGET: unique symbol = Symbol('analytics/overBudget')\n\n/**\n * Settles with `work`, or with {@link OVER_BUDGET} once `ms` pass. The work is not cancelled: it\n * runs on, and a failure after the budget is dropped rather than left unhandled.\n */\nexport const withinBudget = async <T>(\n\twork: Promise<T>,\n\tms: number\n): Promise<T | typeof OVER_BUDGET> => {\n\tlet timer: ReturnType<typeof setTimeout> | undefined\n\tconst elapsed = new Promise<typeof OVER_BUDGET>((resolve) => {\n\t\ttimer = setTimeout(() => resolve(OVER_BUDGET), ms)\n\t\ttimer.unref?.()\n\t})\n\twork.catch(() => {})\n\ttry {\n\t\treturn await Promise.race([work, elapsed])\n\t} finally {\n\t\tclearTimeout(timer)\n\t}\n}\n"],"mappings":";;AACA,MAAa,cAA6B,OAAO,sBAAsB;;;;;AAMvE,MAAa,eAAe,OAC3B,MACA,OACqC;CACrC,IAAI;CACJ,MAAM,UAAU,IAAI,SAA6B,YAAY;EAC5D,QAAQ,iBAAiB,QAAQ,WAAW,GAAG,EAAE;EACjD,MAAM,QAAQ;CACf,CAAC;CACD,KAAK,YAAY,CAAC,CAAC;CACnB,IAAI;EACH,OAAO,MAAM,QAAQ,KAAK,CAAC,MAAM,OAAO,CAAC;CAC1C,UAAU;EACT,aAAa,KAAK;CACnB;AACD"}
@@ -0,0 +1 @@
1
+ export { };