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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (1259) hide show
  1. package/CHANGELOG.md +530 -0
  2. package/README.md +30 -37
  3. package/dist/access/adminUser.d.ts +15 -0
  4. package/dist/access/adminUser.js +13 -0
  5. package/dist/access/adminUser.js.map +1 -0
  6. package/dist/access/decideOnce.js +16 -0
  7. package/dist/access/decideOnce.js.map +1 -0
  8. package/dist/access/membership.d.ts +23 -0
  9. package/dist/access/membership.js +63 -0
  10. package/dist/access/membership.js.map +1 -0
  11. package/dist/access/principal.d.ts +37 -0
  12. package/dist/access/principal.js +29 -0
  13. package/dist/access/principal.js.map +1 -0
  14. package/dist/access/readGate.js +16 -0
  15. package/dist/access/readGate.js.map +1 -0
  16. package/dist/adapters/ga4/disableKey.js +7 -9
  17. package/dist/adapters/ga4/disableKey.js.map +1 -1
  18. package/dist/adapters/ga4/eventName.d.ts +2 -8
  19. package/dist/adapters/ga4/eventName.js +2 -8
  20. package/dist/adapters/ga4/eventName.js.map +1 -1
  21. package/dist/adapters/ga4/ga4.d.ts +17 -0
  22. package/dist/adapters/ga4/ga4.js +208 -124
  23. package/dist/adapters/ga4/ga4.js.map +1 -1
  24. package/dist/adapters/ga4/measurementId.js +2 -3
  25. package/dist/adapters/ga4/measurementId.js.map +1 -1
  26. package/dist/adapters/goalRead.js +15 -29
  27. package/dist/adapters/goalRead.js.map +1 -1
  28. package/dist/adapters/http/baseUrl.js +15 -0
  29. package/dist/adapters/http/baseUrl.js.map +1 -0
  30. package/dist/adapters/http/fetchJson.d.ts +19 -0
  31. package/dist/adapters/http/fetchJson.js +27 -8
  32. package/dist/adapters/http/fetchJson.js.map +1 -1
  33. package/dist/adapters/mapping.js +52 -0
  34. package/dist/adapters/mapping.js.map +1 -0
  35. package/dist/adapters/plausible/plausible.d.ts +19 -13
  36. package/dist/adapters/plausible/plausible.js +139 -123
  37. package/dist/adapters/plausible/plausible.js.map +1 -1
  38. package/dist/adapters/plausible/scriptId.js +19 -0
  39. package/dist/adapters/plausible/scriptId.js.map +1 -0
  40. package/dist/adapters/posthog/posthog.d.ts +26 -9
  41. package/dist/adapters/posthog/posthog.js +194 -115
  42. package/dist/adapters/posthog/posthog.js.map +1 -1
  43. package/dist/adapters/readTime.js +7 -0
  44. package/dist/adapters/readTime.js.map +1 -0
  45. package/dist/adapters/series.js +14 -8
  46. package/dist/adapters/series.js.map +1 -1
  47. package/dist/adapters/umami/umami.d.ts +13 -9
  48. package/dist/adapters/umami/umami.js +186 -173
  49. package/dist/adapters/umami/umami.js.map +1 -1
  50. package/dist/adapters/upstream.js +16 -0
  51. package/dist/adapters/upstream.js.map +1 -0
  52. package/dist/binding/report.d.ts +8 -0
  53. package/dist/binding/report.js +24 -0
  54. package/dist/binding/report.js.map +1 -0
  55. package/dist/binding/resolvePath.js +16 -29
  56. package/dist/binding/resolvePath.js.map +1 -1
  57. package/dist/binding/types.d.ts +14 -29
  58. package/dist/capture/captureRequest.js +28 -0
  59. package/dist/capture/captureRequest.js.map +1 -0
  60. package/dist/capture/exclusionEndpoint.js +98 -0
  61. package/dist/capture/exclusionEndpoint.js.map +1 -0
  62. package/dist/capture/exclusionPrelude.js +14 -0
  63. package/dist/capture/exclusionPrelude.js.map +1 -0
  64. package/dist/capture/exclusionToken.js +23 -0
  65. package/dist/capture/exclusionToken.js.map +1 -0
  66. package/dist/capture/jsLiteral.js +19 -0
  67. package/dist/capture/jsLiteral.js.map +1 -0
  68. package/dist/capture/mountPath.js +2 -3
  69. package/dist/capture/mountPath.js.map +1 -1
  70. package/dist/capture/proxyEndpoint.js +48 -95
  71. package/dist/capture/proxyEndpoint.js.map +1 -1
  72. package/dist/capture/proxyRoutes.js +58 -21
  73. package/dist/capture/proxyRoutes.js.map +1 -1
  74. package/dist/capture/relay.js +91 -0
  75. package/dist/capture/relay.js.map +1 -0
  76. package/dist/capture/requestBody.js +2 -6
  77. package/dist/capture/requestBody.js.map +1 -1
  78. package/dist/capture/requestTrust.js +45 -0
  79. package/dist/capture/requestTrust.js.map +1 -0
  80. package/dist/capture/sameSite.js +40 -0
  81. package/dist/capture/sameSite.js.map +1 -0
  82. package/dist/capture/slots.js +50 -25
  83. package/dist/capture/slots.js.map +1 -1
  84. package/dist/capture/trackerConfig.js +108 -36
  85. package/dist/capture/trackerConfig.js.map +1 -1
  86. package/dist/capture/trackerEndpoint.js +22 -21
  87. package/dist/capture/trackerEndpoint.js.map +1 -1
  88. package/dist/charts/BarList.d.ts +27 -14
  89. package/dist/charts/BarList.js +38 -83
  90. package/dist/charts/BarList.js.map +1 -1
  91. package/dist/charts/TrendChart.d.ts +40 -7
  92. package/dist/charts/TrendChart.js +243 -215
  93. package/dist/charts/TrendChart.js.map +1 -1
  94. package/dist/charts/bars.d.ts +15 -1
  95. package/dist/charts/bars.js +12 -12
  96. package/dist/charts/bars.js.map +1 -1
  97. package/dist/charts/bucket.js +106 -73
  98. package/dist/charts/bucket.js.map +1 -1
  99. package/dist/charts/inProgress.js +22 -0
  100. package/dist/charts/inProgress.js.map +1 -0
  101. package/dist/charts/series.d.ts +15 -0
  102. package/dist/charts/series.js +123 -0
  103. package/dist/charts/series.js.map +1 -0
  104. package/dist/charts/spline.js +91 -25
  105. package/dist/charts/spline.js.map +1 -1
  106. package/dist/charts/trendGeometry.js +91 -0
  107. package/dist/charts/trendGeometry.js.map +1 -0
  108. package/dist/core/adminOptions.d.ts +1 -0
  109. package/dist/core/adminOptions.js +198 -0
  110. package/dist/core/adminOptions.js.map +1 -0
  111. package/dist/core/budget.js +24 -0
  112. package/dist/core/budget.js.map +1 -0
  113. package/dist/core/cacheKey.d.ts +1 -0
  114. package/dist/core/cacheKey.js +48 -37
  115. package/dist/core/cacheKey.js.map +1 -1
  116. package/dist/core/cacheOptions.js +165 -0
  117. package/dist/core/cacheOptions.js.map +1 -0
  118. package/dist/core/capabilities.d.ts +24 -11
  119. package/dist/core/capabilities.js +96 -17
  120. package/dist/core/capabilities.js.map +1 -1
  121. package/dist/core/capture.d.ts +28 -25
  122. package/dist/core/captureOptions.d.ts +1 -0
  123. package/dist/core/captureOptions.js +258 -0
  124. package/dist/core/captureOptions.js.map +1 -0
  125. package/dist/core/clock.js +13 -0
  126. package/dist/core/clock.js.map +1 -0
  127. package/dist/core/collectionOption.d.ts +17 -0
  128. package/dist/core/collectionOption.js +104 -0
  129. package/dist/core/collectionOption.js.map +1 -0
  130. package/dist/core/collectionSlug.js +7 -0
  131. package/dist/core/collectionSlug.js.map +1 -0
  132. package/dist/core/contract.d.ts +297 -59
  133. package/dist/core/contract.js +6 -4
  134. package/dist/core/contract.js.map +1 -1
  135. package/dist/core/cron.js +57 -0
  136. package/dist/core/cron.js.map +1 -0
  137. package/dist/core/fetch.d.ts +17 -0
  138. package/dist/core/goalOptions.d.ts +1 -0
  139. package/dist/core/goalOptions.js +166 -0
  140. package/dist/core/goalOptions.js.map +1 -0
  141. package/dist/core/granularity.js +3 -2
  142. package/dist/core/granularity.js.map +1 -1
  143. package/dist/core/guards.js +17 -0
  144. package/dist/core/guards.js.map +1 -0
  145. package/dist/core/jobs.d.ts +40 -0
  146. package/dist/core/jobs.js +132 -0
  147. package/dist/core/jobs.js.map +1 -0
  148. package/dist/core/legacyOptions.js +145 -0
  149. package/dist/core/legacyOptions.js.map +1 -0
  150. package/dist/core/metricAliases.js +81 -0
  151. package/dist/core/metricAliases.js.map +1 -0
  152. package/dist/core/metricValues.js +57 -0
  153. package/dist/core/metricValues.js.map +1 -0
  154. package/dist/core/monotonic.js +10 -0
  155. package/dist/core/monotonic.js.map +1 -0
  156. package/dist/core/optionChecks.js +51 -0
  157. package/dist/core/optionChecks.js.map +1 -0
  158. package/dist/core/options.d.ts +505 -157
  159. package/dist/core/options.js +158 -219
  160. package/dist/core/options.js.map +1 -1
  161. package/dist/core/registry.js +45 -5
  162. package/dist/core/registry.js.map +1 -1
  163. package/dist/core/scopeList.js +7 -9
  164. package/dist/core/scopeList.js.map +1 -1
  165. package/dist/core/scopeOptions.d.ts +1 -0
  166. package/dist/core/scopeOptions.js +114 -0
  167. package/dist/core/scopeOptions.js.map +1 -0
  168. package/dist/core/scopedRead.js +330 -71
  169. package/dist/core/scopedRead.js.map +1 -1
  170. package/dist/core/sdks.d.ts +81 -0
  171. package/dist/core/sdks.js +23 -0
  172. package/dist/core/sdks.js.map +1 -0
  173. package/dist/core/serverEvent.d.ts +38 -20
  174. package/dist/core/serverEvent.js.map +1 -1
  175. package/dist/core/siteAddress.js +20 -0
  176. package/dist/core/siteAddress.js.map +1 -0
  177. package/dist/core/sourceErrors.js +109 -0
  178. package/dist/core/sourceErrors.js.map +1 -0
  179. package/dist/core/sourceLabel.d.ts +10 -0
  180. package/dist/core/sourceLabel.js +63 -0
  181. package/dist/core/sourceLabel.js.map +1 -0
  182. package/dist/core/sourceOptions.js +106 -0
  183. package/dist/core/sourceOptions.js.map +1 -0
  184. package/dist/core/sourcePolicy.d.ts +55 -0
  185. package/dist/core/sourcePolicy.js +51 -0
  186. package/dist/core/sourcePolicy.js.map +1 -0
  187. package/dist/core/throttle.js +18 -0
  188. package/dist/core/throttle.js.map +1 -0
  189. package/dist/core/values.js +61 -0
  190. package/dist/core/values.js.map +1 -0
  191. package/dist/core/widgetSlugs.d.ts +17 -0
  192. package/dist/core/widgetSlugs.js +29 -0
  193. package/dist/core/widgetSlugs.js.map +1 -0
  194. package/dist/db/detachedWrite.js +36 -0
  195. package/dist/db/detachedWrite.js.map +1 -0
  196. package/dist/db/errors.js +182 -0
  197. package/dist/db/errors.js.map +1 -0
  198. package/dist/db/kind.js +32 -0
  199. package/dist/db/kind.js.map +1 -0
  200. package/dist/db/openTransaction.js +51 -0
  201. package/dist/db/openTransaction.js.map +1 -0
  202. package/dist/exports/adapters/contract.d.ts +15 -0
  203. package/dist/exports/adapters/ga4.d.ts +16 -1
  204. package/dist/exports/adapters/native.d.ts +27 -2
  205. package/dist/exports/adapters/native.js +4 -1
  206. package/dist/exports/adapters/plausible.d.ts +16 -1
  207. package/dist/exports/adapters/posthog.d.ts +16 -1
  208. package/dist/exports/adapters/umami.d.ts +16 -1
  209. package/dist/exports/attributes.d.ts +42 -0
  210. package/dist/exports/attributes.js +83 -0
  211. package/dist/exports/attributes.js.map +1 -0
  212. package/dist/exports/client.d.ts +43 -13
  213. package/dist/exports/client.js +22 -9
  214. package/dist/exports/geo.d.ts +3 -1
  215. package/dist/exports/geo.js +1 -1
  216. package/dist/exports/i18n.d.ts +2 -2
  217. package/dist/exports/i18n.js +2 -2
  218. package/dist/exports/migrations.d.ts +2 -0
  219. package/dist/exports/migrations.js +2 -0
  220. package/dist/exports/next.d.ts +19 -1
  221. package/dist/exports/next.js +3 -1
  222. package/dist/exports/react.d.ts +3 -2
  223. package/dist/exports/react.js +1 -2
  224. package/dist/exports/rsc.d.ts +32 -14
  225. package/dist/exports/rsc.js +11 -6
  226. package/dist/exports/site.d.ts +5 -0
  227. package/dist/exports/site.js +3 -0
  228. package/dist/exports/testing.d.ts +18 -0
  229. package/dist/exports/testing.js +3 -0
  230. package/dist/exports/tracker.d.ts +5 -20
  231. package/dist/exports/tracker.js +3 -14
  232. package/dist/exports/types.d.ts +44 -14
  233. package/dist/exports/types.js +5 -1
  234. package/dist/fields/AnalyticsPanelClient.js +265 -154
  235. package/dist/fields/AnalyticsPanelClient.js.map +1 -1
  236. package/dist/fields/AnalyticsPanelField.d.ts +19 -7
  237. package/dist/fields/AnalyticsPanelField.js +123 -30
  238. package/dist/fields/AnalyticsPanelField.js.map +1 -1
  239. package/dist/fields/AnalyticsStatField.d.ts +17 -6
  240. package/dist/fields/AnalyticsStatField.js +98 -63
  241. package/dist/fields/AnalyticsStatField.js.map +1 -1
  242. package/dist/fields/FieldShimmer.js +15 -0
  243. package/dist/fields/FieldShimmer.js.map +1 -0
  244. package/dist/fields/PanelContent.js +222 -0
  245. package/dist/fields/PanelContent.js.map +1 -0
  246. package/dist/fields/PanelList.js +82 -0
  247. package/dist/fields/PanelList.js.map +1 -0
  248. package/dist/fields/PanelLiveCounter.js +63 -0
  249. package/dist/fields/PanelLiveCounter.js.map +1 -0
  250. package/dist/fields/PanelSkeleton.js +63 -0
  251. package/dist/fields/PanelSkeleton.js.map +1 -0
  252. package/dist/fields/componentPaths.js +8 -0
  253. package/dist/fields/componentPaths.js.map +1 -0
  254. package/dist/fields/config/FilterDimensionSelectField.d.ts +2 -2
  255. package/dist/fields/config/FilterDimensionSelectField.js +26 -54
  256. package/dist/fields/config/FilterDimensionSelectField.js.map +1 -1
  257. package/dist/fields/config/FilterKeySelect.js +66 -0
  258. package/dist/fields/config/FilterKeySelect.js.map +1 -0
  259. package/dist/fields/config/FilterOperatorSelectField.d.ts +7 -2
  260. package/dist/fields/config/FilterOperatorSelectField.js +37 -53
  261. package/dist/fields/config/FilterOperatorSelectField.js.map +1 -1
  262. package/dist/fields/config/FilterValueField.d.ts +17 -0
  263. package/dist/fields/config/FilterValueField.js +130 -0
  264. package/dist/fields/config/FilterValueField.js.map +1 -0
  265. package/dist/fields/config/MetricSelectField.d.ts +5 -12
  266. package/dist/fields/config/MetricSelectField.js +18 -30
  267. package/dist/fields/config/MetricSelectField.js.map +1 -1
  268. package/dist/fields/config/OptionSelect.js +52 -0
  269. package/dist/fields/config/OptionSelect.js.map +1 -0
  270. package/dist/fields/config/SourceSelectField.js +16 -31
  271. package/dist/fields/config/SourceSelectField.js.map +1 -1
  272. package/dist/fields/config/fetchSources.d.ts +3 -0
  273. package/dist/fields/config/fetchSources.js +17 -27
  274. package/dist/fields/config/fetchSources.js.map +1 -1
  275. package/dist/fields/config/filterValues.js +106 -0
  276. package/dist/fields/config/filterValues.js.map +1 -0
  277. package/dist/fields/config/narrow.js +8 -10
  278. package/dist/fields/config/narrow.js.map +1 -1
  279. package/dist/fields/config/retiredPickers.d.ts +45 -0
  280. package/dist/fields/config/retiredPickers.js +46 -0
  281. package/dist/fields/config/retiredPickers.js.map +1 -0
  282. package/dist/fields/config/scopedFields.d.ts +40 -0
  283. package/dist/fields/config/scopedFields.js +68 -0
  284. package/dist/fields/config/scopedFields.js.map +1 -0
  285. package/dist/fields/config/toSelectOption.js +13 -7
  286. package/dist/fields/config/toSelectOption.js.map +1 -1
  287. package/dist/fields/config/useAnalyticsSources.d.ts +5 -7
  288. package/dist/fields/config/useAnalyticsSources.js +17 -21
  289. package/dist/fields/config/useAnalyticsSources.js.map +1 -1
  290. package/dist/fields/config/useFilterCapabilities.d.ts +9 -6
  291. package/dist/fields/config/useFilterCapabilities.js +23 -15
  292. package/dist/fields/config/useFilterCapabilities.js.map +1 -1
  293. package/dist/fields/config/useFormString.js +12 -0
  294. package/dist/fields/config/useFormString.js.map +1 -0
  295. package/dist/fields/dateRange/field.js +7 -19
  296. package/dist/fields/dateRange/field.js.map +1 -1
  297. package/dist/fields/dateRange/types.d.ts +5 -1
  298. package/dist/fields/dateRange/ui.d.ts +3 -2
  299. package/dist/fields/dateRange/ui.js +57 -319
  300. package/dist/fields/dateRange/ui.js.map +1 -1
  301. package/dist/fields/documentScope.js +21 -0
  302. package/dist/fields/documentScope.js.map +1 -0
  303. package/dist/fields/emptyState.js +31 -26
  304. package/dist/fields/emptyState.js.map +1 -1
  305. package/dist/fields/factories.d.ts +35 -16
  306. package/dist/fields/factories.js +66 -37
  307. package/dist/fields/factories.js.map +1 -1
  308. package/dist/fields/format.d.ts +12 -3
  309. package/dist/fields/format.js +77 -13
  310. package/dist/fields/format.js.map +1 -1
  311. package/dist/fields/itemReport.js +45 -0
  312. package/dist/fields/itemReport.js.map +1 -0
  313. package/dist/fields/readForDocument.d.ts +79 -26
  314. package/dist/fields/readForDocument.js +450 -116
  315. package/dist/fields/readForDocument.js.map +1 -1
  316. package/dist/fields/stateKeys.js +20 -0
  317. package/dist/fields/stateKeys.js.map +1 -0
  318. package/dist/goals/GoalAmountField.d.ts +10 -0
  319. package/dist/goals/GoalAmountField.js +162 -0
  320. package/dist/goals/GoalAmountField.js.map +1 -0
  321. package/dist/goals/GoalSelectField.js +89 -40
  322. package/dist/goals/GoalSelectField.js.map +1 -1
  323. package/dist/goals/GoalSelectFieldServer.d.ts +13 -0
  324. package/dist/goals/GoalSelectFieldServer.js +21 -0
  325. package/dist/goals/GoalSelectFieldServer.js.map +1 -0
  326. package/dist/goals/amountField.d.ts +20 -0
  327. package/dist/goals/amountField.js +37 -0
  328. package/dist/goals/amountField.js.map +1 -0
  329. package/dist/goals/builtin.js +17 -0
  330. package/dist/goals/builtin.js.map +1 -0
  331. package/dist/goals/collection.d.ts +22 -0
  332. package/dist/goals/collection.js +139 -125
  333. package/dist/goals/collection.js.map +1 -1
  334. package/dist/goals/constants.d.ts +38 -0
  335. package/dist/goals/constants.js +49 -0
  336. package/dist/goals/constants.js.map +1 -0
  337. package/dist/goals/currency.d.ts +16 -0
  338. package/dist/goals/currency.js +46 -4
  339. package/dist/goals/currency.js.map +1 -1
  340. package/dist/goals/currencyOptions.js +70 -0
  341. package/dist/goals/currencyOptions.js.map +1 -0
  342. package/dist/goals/fetchGoals.d.ts +10 -0
  343. package/dist/goals/fetchGoals.js +12 -26
  344. package/dist/goals/fetchGoals.js.map +1 -1
  345. package/dist/goals/goalField.d.ts +4 -6
  346. package/dist/goals/goalField.js +9 -19
  347. package/dist/goals/goalField.js.map +1 -1
  348. package/dist/goals/goalsEndpoint.js +39 -40
  349. package/dist/goals/goalsEndpoint.js.map +1 -1
  350. package/dist/goals/items.js +35 -0
  351. package/dist/goals/items.js.map +1 -0
  352. package/dist/goals/latent.js +9 -0
  353. package/dist/goals/latent.js.map +1 -0
  354. package/dist/goals/linkFields.d.ts +35 -0
  355. package/dist/goals/linkFields.js +31 -0
  356. package/dist/goals/linkFields.js.map +1 -0
  357. package/dist/goals/match.d.ts +14 -0
  358. package/dist/goals/match.js +67 -46
  359. package/dist/goals/match.js.map +1 -1
  360. package/dist/goals/moneyFields.js +56 -0
  361. package/dist/goals/moneyFields.js.map +1 -0
  362. package/dist/goals/pathMatch.js +122 -0
  363. package/dist/goals/pathMatch.js.map +1 -0
  364. package/dist/goals/placeholder.js +12 -0
  365. package/dist/goals/placeholder.js.map +1 -0
  366. package/dist/goals/resolver.d.ts +3 -3
  367. package/dist/goals/resolver.js +155 -47
  368. package/dist/goals/resolver.js.map +1 -1
  369. package/dist/goals/serverRevenue.d.ts +60 -0
  370. package/dist/goals/serverRevenue.js +41 -0
  371. package/dist/goals/serverRevenue.js.map +1 -0
  372. package/dist/goals/trackGoalAction.d.ts +26 -27
  373. package/dist/goals/trackGoalAction.js +38 -52
  374. package/dist/goals/trackGoalAction.js.map +1 -1
  375. package/dist/goals/types.d.ts +13 -28
  376. package/dist/goals/types.js +1 -1
  377. package/dist/goals/types.js.map +1 -1
  378. package/dist/goals/useAnalyticsGoals.d.ts +6 -5
  379. package/dist/goals/useAnalyticsGoals.js +17 -18
  380. package/dist/goals/useAnalyticsGoals.js.map +1 -1
  381. package/dist/index.d.ts +67 -12
  382. package/dist/index.js +258 -247
  383. package/dist/index.js.map +1 -1
  384. package/dist/items/collectionIdType.js +20 -0
  385. package/dist/items/collectionIdType.js.map +1 -0
  386. package/dist/items/idType.js +31 -0
  387. package/dist/items/idType.js.map +1 -0
  388. package/dist/items/ref.js +73 -0
  389. package/dist/items/ref.js.map +1 -0
  390. package/dist/maintenance/apiTaskState.js +141 -0
  391. package/dist/maintenance/apiTaskState.js.map +1 -0
  392. package/dist/maintenance/heartbeat.js +51 -0
  393. package/dist/maintenance/heartbeat.js.map +1 -0
  394. package/dist/maintenance/lease.d.ts +1 -0
  395. package/dist/maintenance/lease.js +81 -0
  396. package/dist/maintenance/lease.js.map +1 -0
  397. package/dist/maintenance/taskSchedule.d.ts +1 -0
  398. package/dist/maintenance/taskSchedule.js +62 -0
  399. package/dist/maintenance/taskSchedule.js.map +1 -0
  400. package/dist/maintenance/underLease.js +35 -0
  401. package/dist/maintenance/underLease.js.map +1 -0
  402. package/dist/migrations/legacy.d.ts +54 -0
  403. package/dist/migrations/legacy.js +117 -0
  404. package/dist/migrations/legacy.js.map +1 -0
  405. package/dist/migrations/predefined/dropLegacyMongo.d.ts +11 -0
  406. package/dist/migrations/predefined/dropLegacyMongo.js +12 -0
  407. package/dist/migrations/predefined/dropLegacyMongo.js.map +1 -0
  408. package/dist/native/collections/aggregates.js +54 -0
  409. package/dist/native/collections/aggregates.js.map +1 -0
  410. package/dist/native/collections/hits.js +102 -0
  411. package/dist/native/collections/hits.js.map +1 -0
  412. package/dist/native/collections/slugs.d.ts +10 -0
  413. package/dist/native/collections/slugs.js +16 -0
  414. package/dist/native/collections/slugs.js.map +1 -0
  415. package/dist/native/collections/state.js +84 -0
  416. package/dist/native/collections/state.js.map +1 -0
  417. package/dist/native/collections/storeCollection.js +29 -0
  418. package/dist/native/collections/storeCollection.js.map +1 -0
  419. package/dist/native/engine/buckets.d.ts +1 -0
  420. package/dist/native/engine/buckets.js +53 -0
  421. package/dist/native/engine/buckets.js.map +1 -0
  422. package/dist/native/engine/capabilities.js +87 -0
  423. package/dist/native/engine/capabilities.js.map +1 -0
  424. package/dist/native/engine/cost.js +72 -0
  425. package/dist/native/engine/cost.js.map +1 -0
  426. package/dist/native/engine/days.d.ts +1 -0
  427. package/dist/native/engine/days.js +182 -0
  428. package/dist/native/engine/days.js.map +1 -0
  429. package/dist/native/engine/engine.d.ts +1 -0
  430. package/dist/native/engine/engine.js +1623 -0
  431. package/dist/native/engine/engine.js.map +1 -0
  432. package/dist/native/engine/instance.js +58 -0
  433. package/dist/native/engine/instance.js.map +1 -0
  434. package/dist/native/engine/maintenance.d.ts +1 -0
  435. package/dist/native/engine/maintenance.js +677 -0
  436. package/dist/native/engine/maintenance.js.map +1 -0
  437. package/dist/native/engine/merge.js +41 -0
  438. package/dist/native/engine/merge.js.map +1 -0
  439. package/dist/native/engine/nudge.js +26 -0
  440. package/dist/native/engine/nudge.js.map +1 -0
  441. package/dist/native/engine/planner.js +198 -0
  442. package/dist/native/engine/planner.js.map +1 -0
  443. package/dist/native/engine/rebuild.d.ts +22 -0
  444. package/dist/native/engine/rebuild.js +76 -0
  445. package/dist/native/engine/rebuild.js.map +1 -0
  446. package/dist/native/engine/recent.js +17 -0
  447. package/dist/native/engine/recent.js.map +1 -0
  448. package/dist/native/engine/salt.d.ts +1 -0
  449. package/dist/native/engine/salt.js +98 -0
  450. package/dist/native/engine/salt.js.map +1 -0
  451. package/dist/native/engine/siteHosts.d.ts +1 -0
  452. package/dist/native/engine/siteHosts.js +58 -0
  453. package/dist/native/engine/siteHosts.js.map +1 -0
  454. package/dist/native/engine/toHit.js +108 -0
  455. package/dist/native/engine/toHit.js.map +1 -0
  456. package/dist/native/engine/writeBuffer.d.ts +14 -0
  457. package/dist/native/engine/writeBuffer.js +317 -0
  458. package/dist/native/engine/writeBuffer.js.map +1 -0
  459. package/dist/native/geo/composeGeoResolvers.d.ts +1 -0
  460. package/dist/native/geo/composeGeoResolvers.js +4 -1
  461. package/dist/native/geo/composeGeoResolvers.js.map +1 -1
  462. package/dist/native/geo/geoResolver.d.ts +20 -2
  463. package/dist/native/geo/geoResolver.js +42 -6
  464. package/dist/native/geo/geoResolver.js.map +1 -1
  465. package/dist/native/geo/maxmindResolver.d.ts +8 -4
  466. package/dist/native/geo/maxmindResolver.js +20 -16
  467. package/dist/native/geo/maxmindResolver.js.map +1 -1
  468. package/dist/native/geo/resolveGeo.js +31 -0
  469. package/dist/native/geo/resolveGeo.js.map +1 -0
  470. package/dist/native/ingest/bots.d.ts +2 -3
  471. package/dist/native/ingest/bots.js +8 -13
  472. package/dist/native/ingest/bots.js.map +1 -1
  473. package/dist/native/ingest/browser.js +4 -6
  474. package/dist/native/ingest/browser.js.map +1 -1
  475. package/dist/native/ingest/clientIp.js +30 -9
  476. package/dist/native/ingest/clientIp.js.map +1 -1
  477. package/dist/native/ingest/device.js +4 -6
  478. package/dist/native/ingest/device.js.map +1 -1
  479. package/dist/native/ingest/endpoint.d.ts +1 -1
  480. package/dist/native/ingest/endpoint.js +119 -34
  481. package/dist/native/ingest/endpoint.js.map +1 -1
  482. package/dist/native/ingest/itemSignature.d.ts +26 -0
  483. package/dist/native/ingest/itemSignature.js +45 -0
  484. package/dist/native/ingest/itemSignature.js.map +1 -0
  485. package/dist/native/ingest/language.js +2 -3
  486. package/dist/native/ingest/language.js.map +1 -1
  487. package/dist/native/ingest/normalizeEvent.d.ts +60 -7
  488. package/dist/native/ingest/normalizeEvent.js +226 -61
  489. package/dist/native/ingest/normalizeEvent.js.map +1 -1
  490. package/dist/native/ingest/orderSignature.d.ts +13 -0
  491. package/dist/native/ingest/orderSignature.js +50 -0
  492. package/dist/native/ingest/orderSignature.js.map +1 -0
  493. package/dist/native/ingest/referrer.js +30 -32
  494. package/dist/native/ingest/referrer.js.map +1 -1
  495. package/dist/native/ingest/requestHost.js +10 -23
  496. package/dist/native/ingest/requestHost.js.map +1 -1
  497. package/dist/native/ingest/resolveHostname.d.ts +4 -13
  498. package/dist/native/ingest/resolveHostname.js +5 -6
  499. package/dist/native/ingest/resolveHostname.js.map +1 -1
  500. package/dist/native/ingest/revenue.d.ts +1 -0
  501. package/dist/native/ingest/revenue.js +121 -0
  502. package/dist/native/ingest/revenue.js.map +1 -0
  503. package/dist/native/ingest/route.d.ts +10 -0
  504. package/dist/native/ingest/route.js +82 -0
  505. package/dist/native/ingest/route.js.map +1 -0
  506. package/dist/native/ingest/serverTrack.d.ts +2 -10
  507. package/dist/native/ingest/serverTrack.js +181 -72
  508. package/dist/native/ingest/serverTrack.js.map +1 -1
  509. package/dist/native/ingest/signature.js +28 -0
  510. package/dist/native/ingest/signature.js.map +1 -0
  511. package/dist/native/ingest/source.d.ts +2 -3
  512. package/dist/native/ingest/source.js +35 -54
  513. package/dist/native/ingest/source.js.map +1 -1
  514. package/dist/native/ingest/utm.js +9 -9
  515. package/dist/native/ingest/utm.js.map +1 -1
  516. package/dist/native/ingest/validate.js +20 -10
  517. package/dist/native/ingest/validate.js.map +1 -1
  518. package/dist/native/ingest/visitorHash.js +6 -8
  519. package/dist/native/ingest/visitorHash.js.map +1 -1
  520. package/dist/native/nativeAdapter.d.ts +107 -33
  521. package/dist/native/nativeAdapter.js +376 -317
  522. package/dist/native/nativeAdapter.js.map +1 -1
  523. package/dist/native/rebuildDays.d.ts +12 -0
  524. package/dist/native/rebuildDays.js +16 -0
  525. package/dist/native/rebuildDays.js.map +1 -0
  526. package/dist/native/store/aggregate.js +450 -0
  527. package/dist/native/store/aggregate.js.map +1 -0
  528. package/dist/native/store/caps.d.ts +18 -0
  529. package/dist/native/store/caps.js +76 -0
  530. package/dist/native/store/caps.js.map +1 -0
  531. package/dist/native/store/chunks.js +34 -0
  532. package/dist/native/store/chunks.js.map +1 -0
  533. package/dist/native/store/columnValues.js +31 -0
  534. package/dist/native/store/columnValues.js.map +1 -0
  535. package/dist/native/store/dialect.js +106 -0
  536. package/dist/native/store/dialect.js.map +1 -0
  537. package/dist/native/store/eventStore.js +44 -0
  538. package/dist/native/store/eventStore.js.map +1 -0
  539. package/dist/native/store/hitRow.js +116 -0
  540. package/dist/native/store/hitRow.js.map +1 -0
  541. package/dist/native/store/hits.js +63 -0
  542. package/dist/native/store/hits.js.map +1 -0
  543. package/dist/native/store/ids.js +105 -0
  544. package/dist/native/store/ids.js.map +1 -0
  545. package/dist/native/store/mongo/aggregatePipelines.js +430 -0
  546. package/dist/native/store/mongo/aggregatePipelines.js.map +1 -0
  547. package/dist/native/store/mongo/mongoState.js +375 -0
  548. package/dist/native/store/mongo/mongoState.js.map +1 -0
  549. package/dist/native/store/mongo/mongoStore.js +618 -0
  550. package/dist/native/store/mongo/mongoStore.js.map +1 -0
  551. package/dist/native/store/mongo/pipelines.js +695 -0
  552. package/dist/native/store/mongo/pipelines.js.map +1 -0
  553. package/dist/native/store/mongo/results.js +20 -0
  554. package/dist/native/store/mongo/results.js.map +1 -0
  555. package/dist/native/store/parts.d.ts +1 -0
  556. package/dist/native/store/parts.js +95 -0
  557. package/dist/native/store/parts.js.map +1 -0
  558. package/dist/native/store/pattern.js +213 -0
  559. package/dist/native/store/pattern.js.map +1 -0
  560. package/dist/native/store/rawRead.d.ts +23 -0
  561. package/dist/native/store/rawRead.js +384 -0
  562. package/dist/native/store/rawRead.js.map +1 -0
  563. package/dist/native/store/reclassify.js +53 -0
  564. package/dist/native/store/reclassify.js.map +1 -0
  565. package/dist/native/store/sql/aggregateSql.js +345 -0
  566. package/dist/native/store/sql/aggregateSql.js.map +1 -0
  567. package/dist/native/store/sql/columns.js +48 -0
  568. package/dist/native/store/sql/columns.js.map +1 -0
  569. package/dist/native/store/sql/compile.js +656 -0
  570. package/dist/native/store/sql/compile.js.map +1 -0
  571. package/dist/native/store/sql/drivers.js +218 -0
  572. package/dist/native/store/sql/drivers.js.map +1 -0
  573. package/dist/native/store/sql/executor.js +132 -0
  574. package/dist/native/store/sql/executor.js.map +1 -0
  575. package/dist/native/store/sql/fragment.js +104 -0
  576. package/dist/native/store/sql/fragment.js.map +1 -0
  577. package/dist/native/store/sql/maintenanceSql.js +59 -0
  578. package/dist/native/store/sql/maintenanceSql.js.map +1 -0
  579. package/dist/native/store/sql/ownConnection.js +107 -0
  580. package/dist/native/store/sql/ownConnection.js.map +1 -0
  581. package/dist/native/store/sql/poolShare.js +101 -0
  582. package/dist/native/store/sql/poolShare.js.map +1 -0
  583. package/dist/native/store/sql/sqlState.js +325 -0
  584. package/dist/native/store/sql/sqlState.js.map +1 -0
  585. package/dist/native/store/sql/sqlStore.js +355 -0
  586. package/dist/native/store/sql/sqlStore.js.map +1 -0
  587. package/dist/native/store/sql/sqliteThread.d.ts +9 -0
  588. package/dist/native/store/sql/sqliteThread.js +314 -0
  589. package/dist/native/store/sql/sqliteThread.js.map +1 -0
  590. package/dist/native/store/sql/sqliteWorker.js +327 -0
  591. package/dist/native/store/sql/sqliteWorker.js.map +1 -0
  592. package/dist/native/store/sql/sqliteWorkerSource.js +347 -0
  593. package/dist/native/store/sql/sqliteWorkerSource.js.map +1 -0
  594. package/dist/native/store/state.js +151 -0
  595. package/dist/native/store/state.js.map +1 -0
  596. package/dist/native/store/stateStore.js +29 -0
  597. package/dist/native/store/stateStore.js.map +1 -0
  598. package/dist/native/store/types.d.ts +9 -0
  599. package/dist/native/tasks/maintainTask.d.ts +19 -0
  600. package/dist/native/tasks/maintainTask.js +68 -0
  601. package/dist/native/tasks/maintainTask.js.map +1 -0
  602. package/dist/net/guardedFetch.d.ts +32 -0
  603. package/dist/net/guardedFetch.js +220 -0
  604. package/dist/net/guardedFetch.js.map +1 -0
  605. package/dist/net/origin.js +40 -0
  606. package/dist/net/origin.js.map +1 -0
  607. package/dist/net/platform.d.ts +9 -0
  608. package/dist/net/platform.js +35 -0
  609. package/dist/net/platform.js.map +1 -0
  610. package/dist/next/captureRewrites.d.ts +4 -24
  611. package/dist/next/captureRewrites.js +6 -50
  612. package/dist/next/captureRewrites.js.map +1 -1
  613. package/dist/next/captureRoute.d.ts +28 -0
  614. package/dist/next/captureRoute.js +67 -0
  615. package/dist/next/captureRoute.js.map +1 -0
  616. package/dist/next/ingestRoute.d.ts +17 -0
  617. package/dist/next/ingestRoute.js +17 -0
  618. package/dist/next/ingestRoute.js.map +1 -0
  619. package/dist/next/posthogProxyRewrites.d.ts +3 -25
  620. package/dist/next/posthogProxyRewrites.js +5 -37
  621. package/dist/next/posthogProxyRewrites.js.map +1 -1
  622. package/dist/plugin/adminDependencies.js +34 -0
  623. package/dist/plugin/adminDependencies.js.map +1 -0
  624. package/dist/plugin/apiPath.js +23 -0
  625. package/dist/plugin/apiPath.js.map +1 -0
  626. package/dist/plugin/boundDocument.js +58 -0
  627. package/dist/plugin/boundDocument.js.map +1 -0
  628. package/dist/plugin/buildPhase.js +10 -0
  629. package/dist/plugin/buildPhase.js.map +1 -0
  630. package/dist/plugin/collectionChecks.js +232 -0
  631. package/dist/plugin/collectionChecks.js.map +1 -0
  632. package/dist/plugin/collectionFields.d.ts +13 -0
  633. package/dist/plugin/collectionFields.js +22 -0
  634. package/dist/plugin/collectionFields.js.map +1 -0
  635. package/dist/plugin/createRuntime.js +339 -0
  636. package/dist/plugin/createRuntime.js.map +1 -0
  637. package/dist/plugin/destroy.js +58 -0
  638. package/dist/plugin/destroy.js.map +1 -0
  639. package/dist/plugin/documentEndpoint.js +77 -53
  640. package/dist/plugin/documentEndpoint.js.map +1 -1
  641. package/dist/plugin/documentScopes.js +37 -0
  642. package/dist/plugin/documentScopes.js.map +1 -0
  643. package/dist/plugin/encrypted.js +25 -0
  644. package/dist/plugin/encrypted.js.map +1 -0
  645. package/dist/plugin/errors.d.ts +5 -12
  646. package/dist/plugin/errors.js +23 -16
  647. package/dist/plugin/errors.js.map +1 -1
  648. package/dist/plugin/flagsEndpoint.js +41 -0
  649. package/dist/plugin/flagsEndpoint.js.map +1 -0
  650. package/dist/plugin/goalHint.js +22 -11
  651. package/dist/plugin/goalHint.js.map +1 -1
  652. package/dist/plugin/itemLabels.js +114 -0
  653. package/dist/plugin/itemLabels.js.map +1 -0
  654. package/dist/plugin/jobsAccess.js +91 -0
  655. package/dist/plugin/jobsAccess.js.map +1 -0
  656. package/dist/plugin/keepAlive.js +48 -0
  657. package/dist/plugin/keepAlive.js.map +1 -0
  658. package/dist/plugin/peerImportError.js +3 -6
  659. package/dist/plugin/peerImportError.js.map +1 -1
  660. package/dist/plugin/peers.js +64 -0
  661. package/dist/plugin/peers.js.map +1 -0
  662. package/dist/plugin/pluginCollections.js +161 -0
  663. package/dist/plugin/pluginCollections.js.map +1 -0
  664. package/dist/plugin/queryEndpoint.js +70 -45
  665. package/dist/plugin/queryEndpoint.js.map +1 -1
  666. package/dist/plugin/queryParams.js +7 -0
  667. package/dist/plugin/queryParams.js.map +1 -0
  668. package/dist/plugin/readContextForRequest.d.ts +11 -0
  669. package/dist/plugin/readContextForRequest.js +70 -25
  670. package/dist/plugin/readContextForRequest.js.map +1 -1
  671. package/dist/plugin/readFailure.js +22 -0
  672. package/dist/plugin/readFailure.js.map +1 -0
  673. package/dist/plugin/readableProviders.js +64 -0
  674. package/dist/plugin/readableProviders.js.map +1 -0
  675. package/dist/plugin/realtimeEndpoint.js +77 -25
  676. package/dist/plugin/realtimeEndpoint.js.map +1 -1
  677. package/dist/plugin/refreshEndpoint.js +69 -44
  678. package/dist/plugin/refreshEndpoint.js.map +1 -1
  679. package/dist/plugin/relabelFields.js +36 -0
  680. package/dist/plugin/relabelFields.js.map +1 -0
  681. package/dist/plugin/requestMemo.js +35 -0
  682. package/dist/plugin/requestMemo.js.map +1 -0
  683. package/dist/plugin/routeChecks.js +39 -0
  684. package/dist/plugin/routeChecks.js.map +1 -0
  685. package/dist/plugin/routes.d.ts +53 -0
  686. package/dist/plugin/routes.js +92 -0
  687. package/dist/plugin/routes.js.map +1 -0
  688. package/dist/plugin/runtime.d.ts +1 -1
  689. package/dist/plugin/runtime.js +234 -30
  690. package/dist/plugin/runtime.js.map +1 -1
  691. package/dist/plugin/schemaOnly.js +63 -0
  692. package/dist/plugin/schemaOnly.js.map +1 -0
  693. package/dist/plugin/scopeChange.js +6 -5
  694. package/dist/plugin/scopeChange.js.map +1 -1
  695. package/dist/plugin/scopeFieldBoot.js +4 -4
  696. package/dist/plugin/scopeFieldBoot.js.map +1 -1
  697. package/dist/plugin/scopeToken.js +33 -0
  698. package/dist/plugin/scopeToken.js.map +1 -0
  699. package/dist/plugin/sourcesEndpoint.js +50 -17
  700. package/dist/plugin/sourcesEndpoint.js.map +1 -1
  701. package/dist/plugin/unbundledLanguages.js +25 -0
  702. package/dist/plugin/unbundledLanguages.js.map +1 -0
  703. package/dist/plugin/walkFields.js +22 -0
  704. package/dist/plugin/walkFields.js.map +1 -0
  705. package/dist/plugin/warmTask.js +0 -0
  706. package/dist/plugin/warmTask.js.map +1 -1
  707. package/dist/providers/ProvidersListNotice.d.ts +11 -0
  708. package/dist/providers/ProvidersListNotice.js +36 -0
  709. package/dist/providers/ProvidersListNotice.js.map +1 -0
  710. package/dist/providers/access.d.ts +1 -0
  711. package/dist/providers/access.js +35 -26
  712. package/dist/providers/access.js.map +1 -1
  713. package/dist/providers/adapterPool.js +121 -0
  714. package/dist/providers/adapterPool.js.map +1 -0
  715. package/dist/providers/collection.d.ts +61 -0
  716. package/dist/providers/collection.js +340 -151
  717. package/dist/providers/collection.js.map +1 -1
  718. package/dist/providers/factory.d.ts +76 -0
  719. package/dist/providers/factory.js +75 -25
  720. package/dist/providers/factory.js.map +1 -1
  721. package/dist/providers/hosts.d.ts +25 -0
  722. package/dist/providers/hosts.js +128 -0
  723. package/dist/providers/hosts.js.map +1 -0
  724. package/dist/providers/probe.d.ts +1 -0
  725. package/dist/providers/probe.js +105 -0
  726. package/dist/providers/probe.js.map +1 -0
  727. package/dist/providers/refresh.d.ts +18 -0
  728. package/dist/providers/refresh.js +49 -0
  729. package/dist/providers/refresh.js.map +1 -0
  730. package/dist/providers/registry.js +328 -0
  731. package/dist/providers/registry.js.map +1 -0
  732. package/dist/providers/resolver.js +26 -88
  733. package/dist/providers/resolver.js.map +1 -1
  734. package/dist/providers/retarget.js +45 -0
  735. package/dist/providers/retarget.js.map +1 -0
  736. package/dist/providers/scopeUnique.js +41 -0
  737. package/dist/providers/scopeUnique.js.map +1 -0
  738. package/dist/providers/secrets.d.ts +26 -0
  739. package/dist/providers/secrets.js +61 -4
  740. package/dist/providers/secrets.js.map +1 -1
  741. package/dist/providers/stampScope.js +9 -6
  742. package/dist/providers/stampScope.js.map +1 -1
  743. package/dist/query/dates.js +10 -12
  744. package/dist/query/dates.js.map +1 -1
  745. package/dist/query/errors.d.ts +1 -5
  746. package/dist/query/fetchQuery.d.ts +25 -32
  747. package/dist/query/fetchQuery.js +91 -91
  748. package/dist/query/fetchQuery.js.map +1 -1
  749. package/dist/query/limits.js +8 -0
  750. package/dist/query/limits.js.map +1 -0
  751. package/dist/query/parse.d.ts +6 -0
  752. package/dist/query/parse.js +153 -106
  753. package/dist/query/parse.js.map +1 -1
  754. package/dist/query/response.d.ts +23 -3
  755. package/dist/query/response.js +12 -5
  756. package/dist/query/response.js.map +1 -1
  757. package/dist/react/AnalyticsProvider.d.ts +26 -17
  758. package/dist/react/AnalyticsProvider.js +23 -22
  759. package/dist/react/AnalyticsProvider.js.map +1 -1
  760. package/dist/react/TrackerBoot.js +15 -9
  761. package/dist/react/TrackerBoot.js.map +1 -1
  762. package/dist/react/useAnalytics.d.ts +2 -11
  763. package/dist/react/useAnalytics.js +22 -24
  764. package/dist/react/useAnalytics.js.map +1 -1
  765. package/dist/site/AnalyticsScripts.d.ts +34 -0
  766. package/dist/site/AnalyticsScripts.js +30 -0
  767. package/dist/site/AnalyticsScripts.js.map +1 -0
  768. package/dist/site/getTrackerConfig.d.ts +15 -0
  769. package/dist/site/getTrackerConfig.js +40 -0
  770. package/dist/site/getTrackerConfig.js.map +1 -0
  771. package/dist/surfacing/afterRead.d.ts +37 -0
  772. package/dist/surfacing/bounded.js +38 -0
  773. package/dist/surfacing/bounded.js.map +1 -0
  774. package/dist/surfacing/breaker.js +107 -0
  775. package/dist/surfacing/breaker.js.map +1 -0
  776. package/dist/surfacing/cacheCollection.d.ts +8 -0
  777. package/dist/surfacing/cacheCollection.js +69 -0
  778. package/dist/surfacing/cacheCollection.js.map +1 -0
  779. package/dist/surfacing/cacheStore.d.ts +71 -1
  780. package/dist/surfacing/cacheStore.js +16 -37
  781. package/dist/surfacing/cacheStore.js.map +1 -1
  782. package/dist/surfacing/cacheSweep.d.ts +1 -0
  783. package/dist/surfacing/cacheSweep.js +59 -0
  784. package/dist/surfacing/cacheSweep.js.map +1 -0
  785. package/dist/surfacing/classifyError.js +282 -0
  786. package/dist/surfacing/classifyError.js.map +1 -0
  787. package/dist/surfacing/coalesce.js +2 -1
  788. package/dist/surfacing/coalesce.js.map +1 -1
  789. package/dist/surfacing/coldBudget.js +60 -0
  790. package/dist/surfacing/coldBudget.js.map +1 -0
  791. package/dist/surfacing/collectionCacheStore.js +183 -0
  792. package/dist/surfacing/collectionCacheStore.js.map +1 -0
  793. package/dist/surfacing/engine.d.ts +1 -1
  794. package/dist/surfacing/engine.js +514 -72
  795. package/dist/surfacing/engine.js.map +1 -1
  796. package/dist/surfacing/epoch.js +70 -26
  797. package/dist/surfacing/epoch.js.map +1 -1
  798. package/dist/surfacing/lanes.d.ts +1 -0
  799. package/dist/surfacing/lanes.js +297 -0
  800. package/dist/surfacing/lanes.js.map +1 -0
  801. package/dist/surfacing/memo.js +40 -0
  802. package/dist/surfacing/memo.js.map +1 -0
  803. package/dist/surfacing/rateLimiter.d.ts +1 -0
  804. package/dist/surfacing/rateLimiter.js +69 -94
  805. package/dist/surfacing/rateLimiter.js.map +1 -1
  806. package/dist/surfacing/rebucket.js +178 -0
  807. package/dist/surfacing/rebucket.js.map +1 -0
  808. package/dist/surfacing/recipe.js +28 -0
  809. package/dist/surfacing/recipe.js.map +1 -0
  810. package/dist/surfacing/shape.js +22 -0
  811. package/dist/surfacing/shape.js.map +1 -0
  812. package/dist/surfacing/todaySplit.js +113 -0
  813. package/dist/surfacing/todaySplit.js.map +1 -0
  814. package/dist/sync/collection.d.ts +8 -0
  815. package/dist/sync/collection.js +28 -18
  816. package/dist/sync/collection.js.map +1 -1
  817. package/dist/sync/rekeyDurations.js +70 -0
  818. package/dist/sync/rekeyDurations.js.map +1 -0
  819. package/dist/sync/syncTask.js +226 -109
  820. package/dist/sync/syncTask.js.map +1 -1
  821. package/dist/testing/memoryAdapter.d.ts +6 -3
  822. package/dist/testing/memoryAdapter.js +12 -10
  823. package/dist/testing/memoryAdapter.js.map +1 -1
  824. package/dist/testing/settle.d.ts +11 -0
  825. package/dist/testing/settle.js +19 -0
  826. package/dist/testing/settle.js.map +1 -0
  827. package/dist/timeframe/calendar.js +65 -0
  828. package/dist/timeframe/calendar.js.map +1 -0
  829. package/dist/timeframe/comparison.js +46 -0
  830. package/dist/timeframe/comparison.js.map +1 -0
  831. package/dist/timeframe/presets.d.ts +1 -1
  832. package/dist/timeframe/presets.js +5 -5
  833. package/dist/timeframe/presets.js.map +1 -1
  834. package/dist/timeframe/reportingTimezone.d.ts +1 -0
  835. package/dist/timeframe/reportingTimezone.js +64 -0
  836. package/dist/timeframe/reportingTimezone.js.map +1 -0
  837. package/dist/timeframe/tz.js +55 -39
  838. package/dist/timeframe/tz.js.map +1 -1
  839. package/dist/tracker/autoCapture.js +125 -38
  840. package/dist/tracker/autoCapture.js.map +1 -1
  841. package/dist/tracker/campaign.js +52 -0
  842. package/dist/tracker/campaign.js.map +1 -0
  843. package/dist/tracker/config.d.ts +149 -0
  844. package/dist/tracker/config.js +25 -0
  845. package/dist/tracker/config.js.map +1 -0
  846. package/dist/tracker/createTracker.d.ts +4 -10
  847. package/dist/tracker/createTracker.js +386 -115
  848. package/dist/tracker/createTracker.js.map +1 -1
  849. package/dist/tracker/digest.js +28 -0
  850. package/dist/tracker/digest.js.map +1 -0
  851. package/dist/tracker/engagement.js +100 -0
  852. package/dist/tracker/engagement.js.map +1 -0
  853. package/dist/tracker/events.js +37 -0
  854. package/dist/tracker/events.js.map +1 -0
  855. package/dist/tracker/exclusion.d.ts +2 -22
  856. package/dist/tracker/exclusion.js +53 -21
  857. package/dist/tracker/exclusion.js.map +1 -1
  858. package/dist/tracker/gate.js +194 -0
  859. package/dist/tracker/gate.js.map +1 -0
  860. package/dist/tracker/initTracker.d.ts +5 -8
  861. package/dist/tracker/initTracker.js +42 -14
  862. package/dist/tracker/initTracker.js.map +1 -1
  863. package/dist/tracker/itemCapture.js +224 -0
  864. package/dist/tracker/itemCapture.js.map +1 -0
  865. package/dist/tracker/loadScript.js +21 -14
  866. package/dist/tracker/loadScript.js.map +1 -1
  867. package/dist/tracker/pageTracking.js +6 -6
  868. package/dist/tracker/pageTracking.js.map +1 -1
  869. package/dist/tracker/registry.js +118 -30
  870. package/dist/tracker/registry.js.map +1 -1
  871. package/dist/tracker/sinks/createSink.js +41 -0
  872. package/dist/tracker/sinks/createSink.js.map +1 -0
  873. package/dist/tracker/sinks/ga4.js +64 -20
  874. package/dist/tracker/sinks/ga4.js.map +1 -1
  875. package/dist/tracker/sinks/native.js +7 -42
  876. package/dist/tracker/sinks/native.js.map +1 -1
  877. package/dist/tracker/sinks/plausible.js +27 -22
  878. package/dist/tracker/sinks/plausible.js.map +1 -1
  879. package/dist/tracker/sinks/posthog.js +54 -22
  880. package/dist/tracker/sinks/posthog.js.map +1 -1
  881. package/dist/tracker/sinks/umami.js +14 -12
  882. package/dist/tracker/sinks/umami.js.map +1 -1
  883. package/dist/tracker/sinks/vendor.js +30 -27
  884. package/dist/tracker/sinks/vendor.js.map +1 -1
  885. package/dist/tracker/skip.js +81 -0
  886. package/dist/tracker/skip.js.map +1 -0
  887. package/dist/tracker/storage.js +23 -0
  888. package/dist/tracker/storage.js.map +1 -0
  889. package/dist/tracker/transport.js +2 -5
  890. package/dist/tracker/transport.js.map +1 -1
  891. package/dist/tracker/types.d.ts +86 -63
  892. package/dist/tracker/window.js +7 -0
  893. package/dist/tracker/window.js.map +1 -0
  894. package/dist/translations/ar.js +232 -71
  895. package/dist/translations/ar.js.map +1 -1
  896. package/dist/translations/de.js +221 -69
  897. package/dist/translations/de.js.map +1 -1
  898. package/dist/translations/en.js +215 -67
  899. package/dist/translations/en.js.map +1 -1
  900. package/dist/translations/es.js +223 -68
  901. package/dist/translations/es.js.map +1 -1
  902. package/dist/translations/fr.js +227 -72
  903. package/dist/translations/fr.js.map +1 -1
  904. package/dist/translations/id.js +218 -67
  905. package/dist/translations/id.js.map +1 -1
  906. package/dist/translations/index.d.ts +1 -1
  907. package/dist/translations/index.js +5 -7
  908. package/dist/translations/index.js.map +1 -1
  909. package/dist/translations/intl.js +71 -0
  910. package/dist/translations/intl.js.map +1 -0
  911. package/dist/translations/keys.d.ts +191 -14
  912. package/dist/translations/keys.js +196 -14
  913. package/dist/translations/keys.js.map +1 -1
  914. package/dist/translations/ko.js +220 -69
  915. package/dist/translations/ko.js.map +1 -1
  916. package/dist/translations/labelMap.d.ts +10 -0
  917. package/dist/translations/labelMap.js +22 -0
  918. package/dist/translations/labelMap.js.map +1 -0
  919. package/dist/translations/metricKeys.js +10 -2
  920. package/dist/translations/metricKeys.js.map +1 -1
  921. package/dist/translations/parts.js +20 -0
  922. package/dist/translations/parts.js.map +1 -0
  923. package/dist/translations/plural.js +61 -0
  924. package/dist/translations/plural.js.map +1 -0
  925. package/dist/translations/pt.js +232 -77
  926. package/dist/translations/pt.js.map +1 -1
  927. package/dist/translations/ru.js +223 -66
  928. package/dist/translations/ru.js.map +1 -1
  929. package/dist/translations/server.d.ts +1 -0
  930. package/dist/translations/server.js +2 -3
  931. package/dist/translations/server.js.map +1 -1
  932. package/dist/translations/staticLabel.js +69 -0
  933. package/dist/translations/staticLabel.js.map +1 -0
  934. package/dist/translations/uk.js +223 -66
  935. package/dist/translations/uk.js.map +1 -1
  936. package/dist/translations/zh.js +218 -67
  937. package/dist/translations/zh.js.map +1 -1
  938. package/dist/ui/RangePicker.js +112 -0
  939. package/dist/ui/RangePicker.js.map +1 -0
  940. package/dist/ui/analytics.css +1533 -0
  941. package/dist/ui/calendarDays.js +27 -0
  942. package/dist/ui/calendarDays.js.map +1 -0
  943. package/dist/ui/classNames.js +7 -0
  944. package/dist/ui/classNames.js.map +1 -0
  945. package/dist/ui/components/Card.d.ts +28 -0
  946. package/dist/ui/components/Card.js +21 -0
  947. package/dist/ui/components/Card.js.map +1 -0
  948. package/dist/ui/components/ChartDataTable.d.ts +41 -0
  949. package/dist/ui/components/ChartDataTable.js +48 -0
  950. package/dist/ui/components/ChartDataTable.js.map +1 -0
  951. package/dist/ui/components/DataTable.d.ts +82 -0
  952. package/dist/ui/components/DataTable.js +214 -0
  953. package/dist/ui/components/DataTable.js.map +1 -0
  954. package/dist/ui/components/LabeledSelect.js +62 -0
  955. package/dist/ui/components/LabeledSelect.js.map +1 -0
  956. package/dist/ui/components/LiveAnnouncement.js +21 -0
  957. package/dist/ui/components/LiveAnnouncement.js.map +1 -0
  958. package/dist/ui/components/MetricCard.d.ts +38 -0
  959. package/dist/ui/components/MetricCard.js +39 -0
  960. package/dist/ui/components/MetricCard.js.map +1 -0
  961. package/dist/ui/components/NoValue.js +22 -0
  962. package/dist/ui/components/NoValue.js.map +1 -0
  963. package/dist/ui/components/ReadState.js +27 -0
  964. package/dist/ui/components/ReadState.js.map +1 -0
  965. package/dist/ui/components/RefreshButton.js +26 -0
  966. package/dist/ui/components/RefreshButton.js.map +1 -0
  967. package/dist/ui/components/SourcesNoticeBanner.js +20 -0
  968. package/dist/ui/components/SourcesNoticeBanner.js.map +1 -0
  969. package/dist/ui/cssVars.js +7 -0
  970. package/dist/ui/cssVars.js.map +1 -0
  971. package/dist/ui/data/WithScopeToken.d.ts +20 -0
  972. package/dist/ui/data/WithScopeToken.js +20 -0
  973. package/dist/ui/data/WithScopeToken.js.map +1 -0
  974. package/dist/ui/data/clientFieldProps.js +16 -0
  975. package/dist/ui/data/clientFieldProps.js.map +1 -0
  976. package/dist/ui/data/request.d.ts +46 -0
  977. package/dist/ui/data/request.js +119 -0
  978. package/dist/ui/data/request.js.map +1 -0
  979. package/dist/ui/data/scopeTokenContext.js +18 -0
  980. package/dist/ui/data/scopeTokenContext.js.map +1 -0
  981. package/dist/ui/data/sharedCache.js +48 -0
  982. package/dist/ui/data/sharedCache.js.map +1 -0
  983. package/dist/ui/data/useRequest.d.ts +19 -0
  984. package/dist/ui/data/useRequest.js +123 -0
  985. package/dist/ui/data/useRequest.js.map +1 -0
  986. package/dist/ui/data/useRequestScope.js +25 -0
  987. package/dist/ui/data/useRequestScope.js.map +1 -0
  988. package/dist/ui/hooks/useDirection.js +47 -0
  989. package/dist/ui/hooks/useDirection.js.map +1 -0
  990. package/dist/ui/hooks/useDismissOnEscape.js +25 -0
  991. package/dist/ui/hooks/useDismissOnEscape.js.map +1 -0
  992. package/dist/ui/hooks/useLiveAnnouncement.js +57 -0
  993. package/dist/ui/hooks/useLiveAnnouncement.js.map +1 -0
  994. package/dist/ui/hooks/useRealtimePoll.js +112 -0
  995. package/dist/ui/hooks/useRealtimePoll.js.map +1 -0
  996. package/dist/ui/readState.js +19 -0
  997. package/dist/ui/readState.js.map +1 -0
  998. package/dist/ui/rows/toDisplayRows.js +49 -0
  999. package/dist/ui/rows/toDisplayRows.js.map +1 -0
  1000. package/dist/ui/viewerClock.js +7 -0
  1001. package/dist/ui/viewerClock.js.map +1 -0
  1002. package/dist/view/AnalyticsNavLink.d.ts +5 -3
  1003. package/dist/view/AnalyticsNavLink.js +11 -6
  1004. package/dist/view/AnalyticsNavLink.js.map +1 -1
  1005. package/dist/view/AnalyticsView.d.ts +8 -10
  1006. package/dist/view/AnalyticsView.js +47 -18
  1007. package/dist/view/AnalyticsView.js.map +1 -1
  1008. package/dist/view/AnalyticsViewClient.d.ts +4 -7
  1009. package/dist/view/AnalyticsViewClient.js +15 -229
  1010. package/dist/view/AnalyticsViewClient.js.map +1 -1
  1011. package/dist/view/CountryFlag.d.ts +27 -0
  1012. package/dist/view/CountryFlag.js +44 -0
  1013. package/dist/view/CountryFlag.js.map +1 -0
  1014. package/dist/view/DocumentTitle.js +27 -0
  1015. package/dist/view/DocumentTitle.js.map +1 -0
  1016. package/dist/view/ViewRoot.d.ts +21 -0
  1017. package/dist/view/ViewRoot.js +152 -0
  1018. package/dist/view/ViewRoot.js.map +1 -0
  1019. package/dist/view/ViewSections.d.ts +38 -0
  1020. package/dist/view/ViewSections.js +190 -0
  1021. package/dist/view/ViewSections.js.map +1 -0
  1022. package/dist/view/authRedirect.js +2 -4
  1023. package/dist/view/authRedirect.js.map +1 -1
  1024. package/dist/view/conversionRate.js +9 -7
  1025. package/dist/view/conversionRate.js.map +1 -1
  1026. package/dist/view/dayRange.js +6 -10
  1027. package/dist/view/dayRange.js.map +1 -1
  1028. package/dist/view/exclusionLink.d.ts +27 -0
  1029. package/dist/view/exclusionLink.js +46 -0
  1030. package/dist/view/exclusionLink.js.map +1 -0
  1031. package/dist/view/flagSrc.js +14 -0
  1032. package/dist/view/flagSrc.js.map +1 -0
  1033. package/dist/view/gating.d.ts +15 -1
  1034. package/dist/view/gating.js +66 -31
  1035. package/dist/view/gating.js.map +1 -1
  1036. package/dist/view/hostCountryFlag.js +41 -0
  1037. package/dist/view/hostCountryFlag.js.map +1 -0
  1038. package/dist/view/labels.js +95 -10
  1039. package/dist/view/labels.js.map +1 -1
  1040. package/dist/view/metricAliases.js +10 -0
  1041. package/dist/view/metricAliases.js.map +1 -0
  1042. package/dist/view/navLabel.js +15 -0
  1043. package/dist/view/navLabel.js.map +1 -0
  1044. package/dist/view/registerView.js +13 -11
  1045. package/dist/view/registerView.js.map +1 -1
  1046. package/dist/view/scopeLabel.js +21 -0
  1047. package/dist/view/scopeLabel.js.map +1 -0
  1048. package/dist/view/sections/Breakdowns.js +196 -134
  1049. package/dist/view/sections/Breakdowns.js.map +1 -1
  1050. package/dist/view/sections/EmptyStates.js +118 -30
  1051. package/dist/view/sections/EmptyStates.js.map +1 -1
  1052. package/dist/view/sections/ExcludeBrowser.js +188 -0
  1053. package/dist/view/sections/ExcludeBrowser.js.map +1 -0
  1054. package/dist/view/sections/FilterChips.js +124 -27
  1055. package/dist/view/sections/FilterChips.js.map +1 -1
  1056. package/dist/view/sections/GoalsPanel.js +68 -60
  1057. package/dist/view/sections/GoalsPanel.js.map +1 -1
  1058. package/dist/view/sections/OverviewCards.js +29 -33
  1059. package/dist/view/sections/OverviewCards.js.map +1 -1
  1060. package/dist/view/sections/RealtimeStrip.js +70 -59
  1061. package/dist/view/sections/RealtimeStrip.js.map +1 -1
  1062. package/dist/view/sections/SectionBoundary.js +34 -0
  1063. package/dist/view/sections/SectionBoundary.js.map +1 -0
  1064. package/dist/view/sections/Toolbar.d.ts +11 -0
  1065. package/dist/view/sections/Toolbar.js +123 -82
  1066. package/dist/view/sections/Toolbar.js.map +1 -1
  1067. package/dist/view/sections/Trend.js +176 -76
  1068. package/dist/view/sections/Trend.js.map +1 -1
  1069. package/dist/view/state.d.ts +42 -0
  1070. package/dist/view/state.js +93 -54
  1071. package/dist/view/state.js.map +1 -1
  1072. package/dist/view/useViewClock.js +31 -0
  1073. package/dist/view/useViewClock.js.map +1 -0
  1074. package/dist/view/useViewQueries.d.ts +21 -0
  1075. package/dist/view/useViewQueries.js +45 -77
  1076. package/dist/view/useViewQueries.js.map +1 -1
  1077. package/dist/view/useViewState.js +42 -0
  1078. package/dist/view/useViewState.js.map +1 -0
  1079. package/dist/view/useViewUrl.js +47 -0
  1080. package/dist/view/useViewUrl.js.map +1 -0
  1081. package/dist/view/viewBody.js +30 -0
  1082. package/dist/view/viewBody.js.map +1 -0
  1083. package/dist/view/viewContext.d.ts +81 -0
  1084. package/dist/view/viewContext.js +49 -0
  1085. package/dist/view/viewContext.js.map +1 -0
  1086. package/dist/view/viewProps.d.ts +65 -8
  1087. package/dist/view/viewProps.js +123 -36
  1088. package/dist/view/viewProps.js.map +1 -1
  1089. package/dist/widgets/AnalyticsBreakdownWidget.d.ts +7 -3
  1090. package/dist/widgets/AnalyticsBreakdownWidget.js +144 -118
  1091. package/dist/widgets/AnalyticsBreakdownWidget.js.map +1 -1
  1092. package/dist/widgets/AnalyticsGoalsWidget.d.ts +6 -7
  1093. package/dist/widgets/AnalyticsGoalsWidget.js +125 -167
  1094. package/dist/widgets/AnalyticsGoalsWidget.js.map +1 -1
  1095. package/dist/widgets/AnalyticsMetricWidget.d.ts +7 -3
  1096. package/dist/widgets/AnalyticsMetricWidget.js +81 -106
  1097. package/dist/widgets/AnalyticsMetricWidget.js.map +1 -1
  1098. package/dist/widgets/AnalyticsRealtimeWidget.d.ts +7 -3
  1099. package/dist/widgets/AnalyticsRealtimeWidget.js +81 -63
  1100. package/dist/widgets/AnalyticsRealtimeWidget.js.map +1 -1
  1101. package/dist/widgets/AnalyticsTrendWidget.d.ts +7 -3
  1102. package/dist/widgets/AnalyticsTrendWidget.js +130 -123
  1103. package/dist/widgets/AnalyticsTrendWidget.js.map +1 -1
  1104. package/dist/widgets/ComparisonDelta.js +33 -42
  1105. package/dist/widgets/ComparisonDelta.js.map +1 -1
  1106. package/dist/widgets/RealtimeCounter.d.ts +24 -4
  1107. package/dist/widgets/RealtimeCounter.js +91 -77
  1108. package/dist/widgets/RealtimeCounter.js.map +1 -1
  1109. package/dist/widgets/WidgetCard.d.ts +80 -0
  1110. package/dist/widgets/WidgetCard.js +99 -0
  1111. package/dist/widgets/WidgetCard.js.map +1 -0
  1112. package/dist/widgets/WidgetFrame.js +42 -0
  1113. package/dist/widgets/WidgetFrame.js.map +1 -0
  1114. package/dist/widgets/WidgetShimmer.d.ts +55 -0
  1115. package/dist/widgets/WidgetShimmer.js +86 -0
  1116. package/dist/widgets/WidgetShimmer.js.map +1 -0
  1117. package/dist/widgets/breakdownTypes.js +12 -2
  1118. package/dist/widgets/breakdownTypes.js.map +1 -1
  1119. package/dist/widgets/customWidget.d.ts +5 -1
  1120. package/dist/widgets/customWidget.js +6 -7
  1121. package/dist/widgets/customWidget.js.map +1 -1
  1122. package/dist/widgets/defaultLayout.d.ts +26 -0
  1123. package/dist/widgets/defaultLayout.js +51 -0
  1124. package/dist/widgets/defaultLayout.js.map +1 -0
  1125. package/dist/widgets/defaults.d.ts +4 -7
  1126. package/dist/widgets/defaults.js +4 -7
  1127. package/dist/widgets/defaults.js.map +1 -1
  1128. package/dist/widgets/fieldRows.js +14 -0
  1129. package/dist/widgets/fieldRows.js.map +1 -0
  1130. package/dist/widgets/filterCaption.js +6 -7
  1131. package/dist/widgets/filterCaption.js.map +1 -1
  1132. package/dist/widgets/filterField.d.ts +3 -7
  1133. package/dist/widgets/filterField.js +46 -35
  1134. package/dist/widgets/filterField.js.map +1 -1
  1135. package/dist/widgets/filterValueLabel.d.ts +1 -0
  1136. package/dist/widgets/filterValueLabel.js +45 -0
  1137. package/dist/widgets/filterValueLabel.js.map +1 -0
  1138. package/dist/widgets/notices.js +74 -0
  1139. package/dist/widgets/notices.js.map +1 -0
  1140. package/dist/widgets/prepareWidgetRead.d.ts +19 -2
  1141. package/dist/widgets/prepareWidgetRead.js +63 -27
  1142. package/dist/widgets/prepareWidgetRead.js.map +1 -1
  1143. package/dist/widgets/range.js +26 -21
  1144. package/dist/widgets/range.js.map +1 -1
  1145. package/dist/widgets/readForWidget.d.ts +28 -19
  1146. package/dist/widgets/readForWidget.js +33 -29
  1147. package/dist/widgets/readForWidget.js.map +1 -1
  1148. package/dist/widgets/readForWidgetBreakdown.d.ts +40 -29
  1149. package/dist/widgets/readForWidgetBreakdown.js +48 -22
  1150. package/dist/widgets/readForWidgetBreakdown.js.map +1 -1
  1151. package/dist/widgets/readForWidgetGoals.d.ts +18 -24
  1152. package/dist/widgets/readForWidgetGoals.js +52 -46
  1153. package/dist/widgets/readForWidgetGoals.js.map +1 -1
  1154. package/dist/widgets/readForWidgetRealtime.d.ts +22 -17
  1155. package/dist/widgets/readForWidgetRealtime.js +54 -28
  1156. package/dist/widgets/readForWidgetRealtime.js.map +1 -1
  1157. package/dist/widgets/readForWidgetSeries.d.ts +27 -32
  1158. package/dist/widgets/readForWidgetSeries.js +45 -82
  1159. package/dist/widgets/readForWidgetSeries.js.map +1 -1
  1160. package/dist/widgets/readMeta.d.ts +44 -0
  1161. package/dist/widgets/readMeta.js +47 -4
  1162. package/dist/widgets/readMeta.js.map +1 -1
  1163. package/dist/widgets/realtimePoll.d.ts +1 -0
  1164. package/dist/widgets/realtimePoll.js +53 -25
  1165. package/dist/widgets/realtimePoll.js.map +1 -1
  1166. package/dist/widgets/registerWidgets.js +207 -127
  1167. package/dist/widgets/registerWidgets.js.map +1 -1
  1168. package/dist/widgets/stateKeys.js +30 -0
  1169. package/dist/widgets/stateKeys.js.map +1 -0
  1170. package/dist/widgets/titleForecast.js +89 -0
  1171. package/dist/widgets/titleForecast.js.map +1 -0
  1172. package/dist/widgets/types.d.ts +4 -3
  1173. package/dist/widgets/types.js +2 -0
  1174. package/dist/widgets/types.js.map +1 -1
  1175. package/dist/widgets/viewLink.d.ts +24 -6
  1176. package/dist/widgets/viewLink.js +31 -24
  1177. package/dist/widgets/viewLink.js.map +1 -1
  1178. package/dist/widgets/widgetData.js +34 -0
  1179. package/dist/widgets/widgetData.js.map +1 -0
  1180. package/dist/widgets/widgetWindow.d.ts +1 -0
  1181. package/dist/widgets/widgetWindow.js +51 -0
  1182. package/dist/widgets/widgetWindow.js.map +1 -0
  1183. package/package.json +44 -22
  1184. package/dist/adapters/ga4/disableKey.d.ts +0 -9
  1185. package/dist/capture/getTrackerConfig.d.ts +0 -20
  1186. package/dist/capture/getTrackerConfig.js +0 -31
  1187. package/dist/capture/getTrackerConfig.js.map +0 -1
  1188. package/dist/capture/slots.d.ts +0 -8
  1189. package/dist/capture/trackerConfig.d.ts +0 -33
  1190. package/dist/charts/styles.js +0 -59
  1191. package/dist/charts/styles.js.map +0 -1
  1192. package/dist/fields/config/SourceSelectField.d.ts +0 -14
  1193. package/dist/fields/dateRange/styles.js +0 -23
  1194. package/dist/fields/dateRange/styles.js.map +0 -1
  1195. package/dist/goals/GoalSelectField.d.ts +0 -7
  1196. package/dist/native/collections/events.js +0 -165
  1197. package/dist/native/collections/events.js.map +0 -1
  1198. package/dist/native/collections/rollups.js +0 -151
  1199. package/dist/native/collections/rollups.js.map +0 -1
  1200. package/dist/native/collections/seen.js +0 -47
  1201. package/dist/native/collections/seen.js.map +0 -1
  1202. package/dist/native/eventScan.js +0 -25
  1203. package/dist/native/eventScan.js.map +0 -1
  1204. package/dist/native/ingest/flushBatch.js +0 -60
  1205. package/dist/native/ingest/flushBatch.js.map +0 -1
  1206. package/dist/native/ingest/salt.js +0 -39
  1207. package/dist/native/ingest/salt.js.map +0 -1
  1208. package/dist/native/ingest/writeBuffer.js +0 -55
  1209. package/dist/native/ingest/writeBuffer.js.map +0 -1
  1210. package/dist/native/ingest/writeEvent.js +0 -14
  1211. package/dist/native/ingest/writeEvent.js.map +0 -1
  1212. package/dist/native/query/eventAgg.js +0 -175
  1213. package/dist/native/query/eventAgg.js.map +0 -1
  1214. package/dist/native/realtime/buildRealtime.js +0 -53
  1215. package/dist/native/realtime/buildRealtime.js.map +0 -1
  1216. package/dist/native/retention/pruneTask.js +0 -69
  1217. package/dist/native/retention/pruneTask.js.map +0 -1
  1218. package/dist/native/rollupAcc.js +0 -64
  1219. package/dist/native/rollupAcc.js.map +0 -1
  1220. package/dist/native/rollups/bucketKey.js +0 -15
  1221. package/dist/native/rollups/bucketKey.js.map +0 -1
  1222. package/dist/native/rollups/bumpRollups.js +0 -116
  1223. package/dist/native/rollups/bumpRollups.js.map +0 -1
  1224. package/dist/native/rollups/deltas.js +0 -106
  1225. package/dist/native/rollups/deltas.js.map +0 -1
  1226. package/dist/native/rollups/insertManyIfNew.js +0 -93
  1227. package/dist/native/rollups/insertManyIfNew.js.map +0 -1
  1228. package/dist/plugin/paths.js +0 -29
  1229. package/dist/plugin/paths.js.map +0 -1
  1230. package/dist/react/TrackerBoot.d.ts +0 -22
  1231. package/dist/rsc/AnalyticsScripts.d.ts +0 -30
  1232. package/dist/rsc/AnalyticsScripts.js +0 -41
  1233. package/dist/rsc/AnalyticsScripts.js.map +0 -1
  1234. package/dist/surfacing/queue.js +0 -60
  1235. package/dist/surfacing/queue.js.map +0 -1
  1236. package/dist/surfacing/retryPolicy.js +0 -15
  1237. package/dist/surfacing/retryPolicy.js.map +0 -1
  1238. package/dist/tracker/autoCapture.d.ts +0 -48
  1239. package/dist/tracker/consent.d.ts +0 -24
  1240. package/dist/tracker/consent.js +0 -48
  1241. package/dist/tracker/consent.js.map +0 -1
  1242. package/dist/tracker/loadScript.d.ts +0 -14
  1243. package/dist/tracker/pageTracking.d.ts +0 -17
  1244. package/dist/tracker/registry.d.ts +0 -27
  1245. package/dist/tracker/sinks/ga4.d.ts +0 -29
  1246. package/dist/tracker/sinks/native.d.ts +0 -22
  1247. package/dist/tracker/sinks/plausible.d.ts +0 -20
  1248. package/dist/tracker/sinks/posthog.d.ts +0 -18
  1249. package/dist/tracker/sinks/umami.d.ts +0 -18
  1250. package/dist/tracker/sinks/vendor.d.ts +0 -14
  1251. package/dist/view/sections/styles.js +0 -76
  1252. package/dist/view/sections/styles.js.map +0 -1
  1253. package/dist/widgets/WidgetViewLink.js +0 -17
  1254. package/dist/widgets/WidgetViewLink.js.map +0 -1
  1255. package/dist/widgets/cardChrome.d.ts +0 -8
  1256. package/dist/widgets/cardChrome.js +0 -46
  1257. package/dist/widgets/cardChrome.js.map +0 -1
  1258. package/dist/widgets/comparison.js +0 -57
  1259. package/dist/widgets/comparison.js.map +0 -1
@@ -0,0 +1 @@
1
+ {"version":3,"file":"AnalyticsScripts.js","names":[],"sources":["../../src/site/AnalyticsScripts.tsx"],"sourcesContent":["import type { ReactElement } from 'react'\nimport { TrackerBoot } from '../react/TrackerBoot'\nimport type { TrackerConfig } from '../tracker/config'\nimport { openAtBoot } from '../tracker/gate'\nimport { skipsDraft } from '../tracker/skip'\nimport type { GateState } from '../tracker/types'\n\nexport interface AnalyticsScriptsProps {\n\t/** Resolved server-side, by `getTrackerConfig` or the tracker endpoint. */\n\tconfig: TrackerConfig\n\t/**\n\t * The visitor's decision when the server knows it: opened slots render and boot open, closed ones\n\t * render nothing. Omitted, every held slot waits for `setGate` in the browser.\n\t */\n\tgate?: GateState\n\t/**\n\t * `false` renders no vendor snippet and has the tracker inject none either, for a consent\n\t * manager that loads the vendor SDKs itself. Default true.\n\t */\n\tsnippets?: boolean\n\t/** CSP nonce, applied to every script this renders and the tracker injects. */\n\tnonce?: string\n}\n\n/**\n * Renders each boot-open slot's snippet, then boots the tracker; a held slot's snippet is injected\n * once `setGate` opens it. A draft page renders none while `capture.skip.previews` is on.\n */\nexport const AnalyticsScripts = ({\n\tconfig,\n\tgate,\n\tsnippets = true,\n\tnonce,\n}: AnalyticsScriptsProps): ReactElement => {\n\tconst rendersSnippets = snippets && !skipsDraft(config)\n\treturn (\n\t\t<>\n\t\t\t{config.slots.flatMap((slot) =>\n\t\t\t\trendersSnippets && openAtBoot(slot, gate)\n\t\t\t\t\t? slot.snippet.scripts.map((script, index) => (\n\t\t\t\t\t\t\t<script\n\t\t\t\t\t\t\t\t// biome-ignore lint/suspicious/noArrayIndexKey: a snippet's scripts are a fixed list, never reordered\n\t\t\t\t\t\t\t\tkey={`${slot.slot}-${index}`}\n\t\t\t\t\t\t\t\t{...script.attrs}\n\t\t\t\t\t\t\t\tasync={script.async}\n\t\t\t\t\t\t\t\tdefer={script.defer}\n\t\t\t\t\t\t\t\t// biome-ignore lint/security/noDangerouslySetInnerHtml: adapter-authored vendor init\n\t\t\t\t\t\t\t\tdangerouslySetInnerHTML={script.inline ? { __html: script.inline } : undefined}\n\t\t\t\t\t\t\t\tnonce={nonce}\n\t\t\t\t\t\t\t\tsrc={script.inline ? undefined : script.src}\n\t\t\t\t\t\t\t\ttype={script.type}\n\t\t\t\t\t\t\t/>\n\t\t\t\t\t\t))\n\t\t\t\t\t: []\n\t\t\t)}\n\t\t\t<TrackerBoot config={config} gate={gate} nonce={nonce} snippets={snippets} />\n\t\t</>\n\t)\n}\n"],"mappings":";;;;;;;;;AA4BA,MAAa,oBAAoB,EAChC,QACA,MACA,WAAW,MACX,YAC0C;CAC1C,MAAM,kBAAkB,YAAY,CAAC,WAAW,MAAM;CACtD,OACC,qBAAA,UAAA,EAAA,UAAA,CACE,OAAO,MAAM,SAAS,SACtB,mBAAmB,WAAW,MAAM,IAAI,IACrC,KAAK,QAAQ,QAAQ,KAAK,QAAQ,UAClC,oBAAC,UAAD;EAGC,GAAI,OAAO;EACX,OAAO,OAAO;EACd,OAAO,OAAO;EAEd,yBAAyB,OAAO,SAAS,EAAE,QAAQ,OAAO,OAAO,IAAI,KAAA;EAC9D;EACP,KAAK,OAAO,SAAS,KAAA,IAAY,OAAO;EACxC,MAAM,OAAO;CACb,GATK,GAAG,KAAK,KAAK,GAAG,OASrB,CACD,IACA,CAAC,CACL,GACA,oBAAC,aAAD;EAAqB;EAAc;EAAa;EAAiB;CAAW,CAAA,CAC3E,EAAA,CAAA;AAEJ"}
@@ -0,0 +1,15 @@
1
+ import { TrackerConfig } from "../tracker/config.js";
2
+ import { Payload, PayloadRequest } from "payload";
3
+
4
+ //#region src/site/getTrackerConfig.d.ts
5
+ /**
6
+ * Server-side twin of the tracker endpoint: pass the request's `headers()` so the host's resolver
7
+ * sees the visitor's request. Pass `draft: (await draftMode()).isEnabled`, else the cookie decides.
8
+ */
9
+ declare const getTrackerConfig: (payload: Payload, args?: {
10
+ headers?: Headers;
11
+ draft?: boolean;
12
+ }) => Promise<TrackerConfig>;
13
+ //#endregion
14
+ export { getTrackerConfig };
15
+ //# sourceMappingURL=getTrackerConfig.d.ts.map
@@ -0,0 +1,40 @@
1
+ import { isRecord } from "../core/values.js";
2
+ import { ANALYTICS_CONFIG_KEY, analyticsRoutes } from "../plugin/routes.js";
3
+ import { apiPath } from "../plugin/apiPath.js";
4
+ import { DEFAULT_AUTO_CAPTURE } from "../tracker/config.js";
5
+ import { createLocalReq } from "payload";
6
+ /**
7
+ * Whether the request carries Next's draft mode cookie. Unverified, so a stale or forged cookie reads
8
+ * as draft; `(await draftMode()).isEnabled` checks it against the preview id.
9
+ */
10
+ const draftModeCookie = (headers) => (headers.get("cookie") ?? "").split(";").some((pair) => {
11
+ const [name, ...value] = pair.trim().split("=");
12
+ return name === "__prerender_bypass" && value.join("=") !== "";
13
+ });
14
+ const isTrackerConfigSource = (value) => isRecord(value) && typeof value.trackerConfig === "function";
15
+ /** The config for an install with no runtime: no slots, but still a usable ingest path. */
16
+ const emptyTrackerConfig = (req) => ({
17
+ slots: [],
18
+ autoCapture: DEFAULT_AUTO_CAPTURE,
19
+ goals: [],
20
+ ingestPath: apiPath(req.payload?.config ?? {}, analyticsRoutes(req.payload?.config).ingest)
21
+ });
22
+ /**
23
+ * Server-side twin of the tracker endpoint: pass the request's `headers()` so the host's resolver
24
+ * sees the visitor's request. Pass `draft: (await draftMode()).isEnabled`, else the cookie decides.
25
+ */
26
+ const getTrackerConfig = async (payload, args) => {
27
+ const headers = args?.headers ?? new Headers();
28
+ const host = headers.get("host");
29
+ const req = await createLocalReq({ req: {
30
+ headers,
31
+ ...host ? { host } : {}
32
+ } }, payload);
33
+ const draft = args?.draft ?? draftModeCookie(headers);
34
+ const source = payload.config.custom?.[ANALYTICS_CONFIG_KEY];
35
+ return isTrackerConfigSource(source) ? source.trackerConfig(payload, req, draft) : emptyTrackerConfig(req);
36
+ };
37
+ //#endregion
38
+ export { draftModeCookie, emptyTrackerConfig, getTrackerConfig };
39
+
40
+ //# sourceMappingURL=getTrackerConfig.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"getTrackerConfig.js","names":[],"sources":["../../src/site/getTrackerConfig.ts"],"sourcesContent":["import { createLocalReq, type Payload, type PayloadRequest } from 'payload'\nimport { isRecord } from '../core/values'\nimport { apiPath } from '../plugin/apiPath'\nimport { ANALYTICS_CONFIG_KEY, analyticsRoutes } from '../plugin/routes'\nimport { DEFAULT_AUTO_CAPTURE, type TrackerConfig } from '../tracker/config'\n\n/**\n * The cookie Next's `draftMode().enable()` sets and `disable()` clears, which is how Payload's\n * preview route turns draft mode on (`__prerender_bypass` in `next/dist/server/api-utils`).\n */\nexport const NEXT_DRAFT_COOKIE = '__prerender_bypass'\n\n/**\n * Whether the request carries Next's draft mode cookie. Unverified, so a stale or forged cookie reads\n * as draft; `(await draftMode()).isEnabled` checks it against the preview id.\n */\nexport const draftModeCookie = (headers: Headers): boolean =>\n\t(headers.get('cookie') ?? '').split(';').some((pair) => {\n\t\tconst [name, ...value] = pair.trim().split('=')\n\t\treturn name === NEXT_DRAFT_COOKIE && value.join('=') !== ''\n\t})\n\n/**\n * What the plugin's `config.custom` entry answers a site render with, so a site page reaches the\n * runtime without loading the engine, the adapters or the admin.\n */\nexport interface TrackerConfigSource {\n\ttrackerConfig: (payload: Payload, req: PayloadRequest, draft: boolean) => Promise<TrackerConfig>\n}\n\nconst isTrackerConfigSource = (value: unknown): value is TrackerConfigSource =>\n\tisRecord(value) && typeof value.trackerConfig === 'function'\n\n/** The config for an install with no runtime: no slots, but still a usable ingest path. */\nexport const emptyTrackerConfig = (req: PayloadRequest): TrackerConfig => ({\n\tslots: [],\n\tautoCapture: DEFAULT_AUTO_CAPTURE,\n\tgoals: [],\n\tingestPath: apiPath(req.payload?.config ?? {}, analyticsRoutes(req.payload?.config).ingest),\n})\n\n/**\n * Server-side twin of the tracker endpoint: pass the request's `headers()` so the host's resolver\n * sees the visitor's request. Pass `draft: (await draftMode()).isEnabled`, else the cookie decides.\n */\nexport const getTrackerConfig = async (\n\tpayload: Payload,\n\targs?: { headers?: Headers; draft?: boolean }\n): Promise<TrackerConfig> => {\n\tconst headers = args?.headers ?? new Headers()\n\t// Payload derives `req.host` from the URL, and hostname scoping needs the header's.\n\tconst host = headers.get('host')\n\t// A fresh literal per call: `createLocalReq` mutates the request it is given.\n\tconst req = await createLocalReq({ req: { headers, ...(host ? { host } : {}) } }, payload)\n\tconst draft = args?.draft ?? draftModeCookie(headers)\n\tconst source = payload.config.custom?.[ANALYTICS_CONFIG_KEY]\n\treturn isTrackerConfigSource(source)\n\t\t? source.trackerConfig(payload, req, draft)\n\t\t: emptyTrackerConfig(req)\n}\n"],"mappings":";;;;;;;;;AAgBA,MAAa,mBAAmB,aAC9B,QAAQ,IAAI,QAAQ,KAAK,IAAI,MAAM,GAAG,EAAE,MAAM,SAAS;CACvD,MAAM,CAAC,MAAM,GAAG,SAAS,KAAK,KAAK,EAAE,MAAM,GAAG;CAC9C,OAAO,SAAA,wBAA8B,MAAM,KAAK,GAAG,MAAM;AAC1D,CAAC;AAUF,MAAM,yBAAyB,UAC9B,SAAS,KAAK,KAAK,OAAO,MAAM,kBAAkB;;AAGnD,MAAa,sBAAsB,SAAwC;CAC1E,OAAO,CAAC;CACR,aAAa;CACb,OAAO,CAAC;CACR,YAAY,QAAQ,IAAI,SAAS,UAAU,CAAC,GAAG,gBAAgB,IAAI,SAAS,MAAM,EAAE,MAAM;AAC3F;;;;;AAMA,MAAa,mBAAmB,OAC/B,SACA,SAC4B;CAC5B,MAAM,UAAU,MAAM,WAAW,IAAI,QAAQ;CAE7C,MAAM,OAAO,QAAQ,IAAI,MAAM;CAE/B,MAAM,MAAM,MAAM,eAAe,EAAE,KAAK;EAAE;EAAS,GAAI,OAAO,EAAE,KAAK,IAAI,CAAC;CAAG,EAAE,GAAG,OAAO;CACzF,MAAM,QAAQ,MAAM,SAAS,gBAAgB,OAAO;CACpD,MAAM,SAAS,QAAQ,OAAO,SAAS;CACvC,OAAO,sBAAsB,MAAM,IAChC,OAAO,cAAc,SAAS,KAAK,KAAK,IACxC,mBAAmB,GAAG;AAC1B"}
@@ -0,0 +1,37 @@
1
+ import { AnalyticsQuery, AnalyticsResult } from "../core/contract.js";
2
+ import { Payload } from "payload";
3
+
4
+ //#region src/surfacing/afterRead.d.ts
5
+ /**
6
+ * Where an answered read came from: this instance's memory, a fresh entry of the cache store, an
7
+ * expired entry served while it refreshes (`meta.stale`), or the source itself just now.
8
+ */
9
+ type ReadOrigin = 'memory' | 'store' | 'stale' | 'source';
10
+ interface AfterReadArgs {
11
+ /** The id of the source that answered. */
12
+ adapterId: string;
13
+ /**
14
+ * The query as the engine read it: clamped to the source's lookback, with the scope, timezone and
15
+ * goal slugs the surface resolved. Weeks and months are as asked, not the days they were read as.
16
+ */
17
+ query: AnalyticsQuery;
18
+ /**
19
+ * The answer, already shaped (ranked, cut to `limit`) and cached. Other readers share this very
20
+ * object, so the hook never changes it: it returns a new one to answer differently.
21
+ */
22
+ result: AnalyticsResult;
23
+ from: ReadOrigin;
24
+ /** Milliseconds from the start of the read to its answer, every wait included. */
25
+ durationMs: number;
26
+ payload: Payload;
27
+ }
28
+ /** What `hooks.afterRead` answers with: a new result for this one read, or nothing to keep it. */
29
+ type AfterReadAnswer = AnalyticsResult | undefined | void;
30
+ /**
31
+ * `hooks.afterRead`: runs for every read answered to a reader, once cached; its return answers that
32
+ * one read uncached. Awaited, so a slow hook slows every read; a throw is logged and ignored.
33
+ */
34
+ type AfterReadHook = (args: AfterReadArgs) => AfterReadAnswer | Promise<AfterReadAnswer>;
35
+ //#endregion
36
+ export { AfterReadAnswer, AfterReadArgs, AfterReadHook, ReadOrigin };
37
+ //# sourceMappingURL=afterRead.d.ts.map
@@ -0,0 +1,38 @@
1
+ /**
2
+ * Makes `key` the most recent entry and evicts the least recent past {@link SCOPE_STATE_CAPACITY}
3
+ * (those `keep` holds on to last), so a scope-keyed map never grows with the names asked for.
4
+ */
5
+ const remember = (map, [key, value], keep) => {
6
+ map.delete(key);
7
+ map.set(key, value);
8
+ if (map.size <= 2e3) return;
9
+ for (const [oldest, held] of map) {
10
+ if (map.size <= 2e3) return;
11
+ if (oldest !== key && !keep?.(held)) map.delete(oldest);
12
+ }
13
+ for (const oldest of map.keys()) {
14
+ if (map.size <= 2e3) return;
15
+ if (oldest !== key) map.delete(oldest);
16
+ }
17
+ };
18
+ /** The entry under `key`, made the most recent one. */
19
+ const recall = (map, key) => {
20
+ const found = map.get(key);
21
+ if (found !== void 0) {
22
+ map.delete(key);
23
+ map.set(key, found);
24
+ }
25
+ return found;
26
+ };
27
+ /** The entry under `key` as {@link recall} finds it, else one `make` builds, remembered. */
28
+ const recallOr = (map, [key, make], keep) => {
29
+ const known = recall(map, key);
30
+ if (known !== void 0) return known;
31
+ const made = make();
32
+ remember(map, [key, made], keep);
33
+ return made;
34
+ };
35
+ //#endregion
36
+ export { recall, recallOr, remember };
37
+
38
+ //# sourceMappingURL=bounded.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"bounded.js","names":[],"sources":["../../src/surfacing/bounded.ts"],"sourcesContent":["/** Scopes one instance keeps per-scope state for (lanes, breakers, epochs, registries) at most. */\nexport const SCOPE_STATE_CAPACITY = 2_000\n\n/**\n * Makes `key` the most recent entry and evicts the least recent past {@link SCOPE_STATE_CAPACITY}\n * (those `keep` holds on to last), so a scope-keyed map never grows with the names asked for.\n */\nexport const remember = <K, V>(\n\tmap: Map<K, V>,\n\t[key, value]: readonly [K, V],\n\tkeep?: (value: V) => boolean\n): void => {\n\tmap.delete(key)\n\tmap.set(key, value)\n\tif (map.size <= SCOPE_STATE_CAPACITY) {\n\t\treturn\n\t}\n\tfor (const [oldest, held] of map) {\n\t\tif (map.size <= SCOPE_STATE_CAPACITY) {\n\t\t\treturn\n\t\t}\n\t\tif (oldest !== key && !keep?.(held)) {\n\t\t\tmap.delete(oldest)\n\t\t}\n\t}\n\tfor (const oldest of map.keys()) {\n\t\tif (map.size <= SCOPE_STATE_CAPACITY) {\n\t\t\treturn\n\t\t}\n\t\tif (oldest !== key) {\n\t\t\tmap.delete(oldest)\n\t\t}\n\t}\n}\n\n/** The entry under `key`, made the most recent one. */\nexport const recall = <K, V>(map: Map<K, V>, key: K): V | undefined => {\n\tconst found = map.get(key)\n\tif (found !== undefined) {\n\t\tmap.delete(key)\n\t\tmap.set(key, found)\n\t}\n\treturn found\n}\n\n/** The entry under `key` as {@link recall} finds it, else one `make` builds, remembered. */\nexport const recallOr = <K, V>(\n\tmap: Map<K, V>,\n\t[key, make]: readonly [K, () => V],\n\tkeep?: (value: V) => boolean\n): V => {\n\tconst known = recall(map, key)\n\tif (known !== undefined) {\n\t\treturn known\n\t}\n\tconst made = make()\n\tremember(map, [key, made], keep)\n\treturn made\n}\n"],"mappings":";;;;AAOA,MAAa,YACZ,KACA,CAAC,KAAK,QACN,SACU;CACV,IAAI,OAAO,GAAG;CACd,IAAI,IAAI,KAAK,KAAK;CAClB,IAAI,IAAI,QAAA,KACP;CAED,KAAK,MAAM,CAAC,QAAQ,SAAS,KAAK;EACjC,IAAI,IAAI,QAAA,KACP;EAED,IAAI,WAAW,OAAO,CAAC,OAAO,IAAI,GACjC,IAAI,OAAO,MAAM;CAEnB;CACA,KAAK,MAAM,UAAU,IAAI,KAAK,GAAG;EAChC,IAAI,IAAI,QAAA,KACP;EAED,IAAI,WAAW,KACd,IAAI,OAAO,MAAM;CAEnB;AACD;;AAGA,MAAa,UAAgB,KAAgB,QAA0B;CACtE,MAAM,QAAQ,IAAI,IAAI,GAAG;CACzB,IAAI,UAAU,KAAA,GAAW;EACxB,IAAI,OAAO,GAAG;EACd,IAAI,IAAI,KAAK,KAAK;CACnB;CACA,OAAO;AACR;;AAGA,MAAa,YACZ,KACA,CAAC,KAAK,OACN,SACO;CACP,MAAM,QAAQ,OAAO,KAAK,GAAG;CAC7B,IAAI,UAAU,KAAA,GACb,OAAO;CAER,MAAM,OAAO,KAAK;CAClB,SAAS,KAAK,CAAC,KAAK,IAAI,GAAG,IAAI;CAC/B,OAAO;AACR"}
@@ -0,0 +1,107 @@
1
+ //#region src/surfacing/breaker.ts
2
+ /** Consecutive `unavailable` failures that open the breaker. */
3
+ const BREAKER_THRESHOLD = 5;
4
+ /** The longest a breaker stays open between probes. */
5
+ const BREAKER_MAX_MS = 6e5;
6
+ /** How long a run is told to wait while another run is the half-open probe. */
7
+ const PROBE_WAIT_MS = 1e3;
8
+ /** What a failure does: an outage counts, a setup failure opens the breaker, a refusal answers. */
9
+ const effectOf = (failure) => {
10
+ if (failure.kind === "source_misconfigured") return "open";
11
+ if (failure.kind === "unavailable" && !failure.refused) return "count";
12
+ return "answer";
13
+ };
14
+ /**
15
+ * Opens after `threshold` consecutive `unavailable` failures or one `source_misconfigured`, for
16
+ * `baseMs` doubling per failed probe up to `maxMs`; `invalid_param` still answered, so it succeeds.
17
+ */
18
+ const createBreaker = (options) => {
19
+ const threshold = options.threshold ?? BREAKER_THRESHOLD;
20
+ const baseMs = options.baseMs ?? 3e4;
21
+ const maxMs = options.maxMs ?? 6e5;
22
+ const probeExpiresMs = options.probeExpiresMs ?? 6e4;
23
+ let state = "closed";
24
+ let consecutive = 0;
25
+ let periodMs = baseMs;
26
+ let openUntil = 0;
27
+ let probing = false;
28
+ let probedAt = 0;
29
+ let lastFailure;
30
+ const open = (at) => {
31
+ state = "open";
32
+ openUntil = at + periodMs;
33
+ probing = false;
34
+ };
35
+ const decide = (claim) => {
36
+ if (state === "closed") return {
37
+ ok: true,
38
+ probe: false
39
+ };
40
+ const at = options.now();
41
+ if (state === "open" && at < openUntil) return {
42
+ ok: false,
43
+ retryAfterMs: openUntil - at
44
+ };
45
+ if (probing && at - probedAt < probeExpiresMs) return {
46
+ ok: false,
47
+ retryAfterMs: Math.min(PROBE_WAIT_MS, probeExpiresMs - (at - probedAt))
48
+ };
49
+ if (claim) {
50
+ state = "half-open";
51
+ probing = true;
52
+ probedAt = at;
53
+ }
54
+ return {
55
+ ok: true,
56
+ probe: true
57
+ };
58
+ };
59
+ return {
60
+ peek: () => decide(false),
61
+ admit: () => decide(true),
62
+ release() {
63
+ if (probing) {
64
+ probing = false;
65
+ state = "open";
66
+ }
67
+ },
68
+ record(outcome, probe) {
69
+ const effect = outcome === "success" ? "answer" : effectOf(outcome);
70
+ if (outcome === "success" || effect === "answer") {
71
+ consecutive = 0;
72
+ lastFailure = void 0;
73
+ if (probe || state !== "closed") {
74
+ state = "closed";
75
+ periodMs = baseMs;
76
+ probing = false;
77
+ }
78
+ return;
79
+ }
80
+ lastFailure = outcome;
81
+ const at = options.now();
82
+ if (probe) {
83
+ periodMs = Math.min(periodMs * 2, maxMs);
84
+ open(at);
85
+ return;
86
+ }
87
+ if (state !== "closed") return;
88
+ consecutive++;
89
+ if (effect === "open" || consecutive >= threshold) {
90
+ consecutive = 0;
91
+ open(at);
92
+ }
93
+ },
94
+ snapshot() {
95
+ const at = options.now();
96
+ return {
97
+ state,
98
+ ...state === "open" && at < openUntil ? { retryAfterMs: openUntil - at } : {},
99
+ ...lastFailure ? { lastFailure } : {}
100
+ };
101
+ }
102
+ };
103
+ };
104
+ //#endregion
105
+ export { BREAKER_MAX_MS, createBreaker };
106
+
107
+ //# sourceMappingURL=breaker.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"breaker.js","names":[],"sources":["../../src/surfacing/breaker.ts"],"sourcesContent":["import type { ReadFailure } from './classifyError'\n\n/** Consecutive `unavailable` failures that open the breaker. */\nconst BREAKER_THRESHOLD = 5\n\n/** How long a breaker first stays open; each failed probe doubles it. */\nexport const BREAKER_BASE_MS = 30_000\n\n/** The longest a breaker stays open between probes. */\nexport const BREAKER_MAX_MS = 600_000\n\n/** How long a run is told to wait while another run is the half-open probe. */\nconst PROBE_WAIT_MS = 1_000\n\n/**\n * How long a probe may go unanswered before another run may probe: a request that never settles\n * would otherwise keep the breaker half-open, refusing every run, for good.\n */\nexport const PROBE_EXPIRES_MS = 60_000\n\nexport type BreakerState = 'closed' | 'open' | 'half-open'\n\nexport interface BreakerSnapshot {\n\tstate: BreakerState\n\t/** Until the next probe may go, while the breaker refuses. */\n\tretryAfterMs?: number\n\t/** The failure that last counted, cleared by a success. */\n\tlastFailure?: ReadFailure\n}\n\nexport type Admission = { ok: true; probe: boolean } | { ok: false; retryAfterMs: number }\n\n/**\n * One source's circuit breaker: `peek` claims nothing (should a run queue at all); `admit`, asked\n * once a run holds its slots, may make it the half-open probe. Admitted runs must `record`.\n */\nexport interface Breaker {\n\tpeek(): Admission\n\tadmit(): Admission\n\t/** A run's outcome: `success`, or what its failure means; only an admitted run reports. */\n\trecord(outcome: 'success' | ReadFailure, probe: boolean): void\n\t/** Gives back a probe `admit` claimed for a run that stopped before its request went out. */\n\trelease(): void\n\tsnapshot(): BreakerSnapshot\n}\n\nexport interface BreakerOptions {\n\tnow: () => number\n\tthreshold?: number\n\tbaseMs?: number\n\tmaxMs?: number\n\t/** How long a probe may go unanswered before the next run may probe; {@link PROBE_EXPIRES_MS}. */\n\tprobeExpiresMs?: number\n}\n\n/** What a failure does: an outage counts, a setup failure opens the breaker, a refusal answers. */\nconst effectOf = (failure: ReadFailure): 'count' | 'open' | 'answer' => {\n\tif (failure.kind === 'source_misconfigured') return 'open'\n\tif (failure.kind === 'unavailable' && !failure.refused) return 'count'\n\treturn 'answer'\n}\n\n/**\n * Opens after `threshold` consecutive `unavailable` failures or one `source_misconfigured`, for\n * `baseMs` doubling per failed probe up to `maxMs`; `invalid_param` still answered, so it succeeds.\n */\nexport const createBreaker = (options: BreakerOptions): Breaker => {\n\tconst threshold = options.threshold ?? BREAKER_THRESHOLD\n\tconst baseMs = options.baseMs ?? BREAKER_BASE_MS\n\tconst maxMs = options.maxMs ?? BREAKER_MAX_MS\n\tconst probeExpiresMs = options.probeExpiresMs ?? PROBE_EXPIRES_MS\n\tlet state: BreakerState = 'closed'\n\tlet consecutive = 0\n\tlet periodMs = baseMs\n\tlet openUntil = 0\n\tlet probing = false\n\tlet probedAt = 0\n\tlet lastFailure: ReadFailure | undefined\n\n\tconst open = (at: number): void => {\n\t\tstate = 'open'\n\t\topenUntil = at + periodMs\n\t\tprobing = false\n\t}\n\n\tconst decide = (claim: boolean): Admission => {\n\t\tif (state === 'closed') {\n\t\t\treturn { ok: true, probe: false }\n\t\t}\n\t\tconst at = options.now()\n\t\tif (state === 'open' && at < openUntil) {\n\t\t\treturn { ok: false, retryAfterMs: openUntil - at }\n\t\t}\n\t\tif (probing && at - probedAt < probeExpiresMs) {\n\t\t\treturn { ok: false, retryAfterMs: Math.min(PROBE_WAIT_MS, probeExpiresMs - (at - probedAt)) }\n\t\t}\n\t\tif (claim) {\n\t\t\tstate = 'half-open'\n\t\t\tprobing = true\n\t\t\tprobedAt = at\n\t\t}\n\t\treturn { ok: true, probe: true }\n\t}\n\n\treturn {\n\t\tpeek: () => decide(false),\n\t\tadmit: () => decide(true),\n\t\trelease() {\n\t\t\tif (probing) {\n\t\t\t\tprobing = false\n\t\t\t\tstate = 'open'\n\t\t\t}\n\t\t},\n\t\trecord(outcome, probe) {\n\t\t\tconst effect = outcome === 'success' ? 'answer' : effectOf(outcome)\n\t\t\tif (outcome === 'success' || effect === 'answer') {\n\t\t\t\tconsecutive = 0\n\t\t\t\tlastFailure = undefined\n\t\t\t\tif (probe || state !== 'closed') {\n\t\t\t\t\tstate = 'closed'\n\t\t\t\t\tperiodMs = baseMs\n\t\t\t\t\tprobing = false\n\t\t\t\t}\n\t\t\t\treturn\n\t\t\t}\n\t\t\tlastFailure = outcome\n\t\t\tconst at = options.now()\n\t\t\tif (probe) {\n\t\t\t\tperiodMs = Math.min(periodMs * 2, maxMs)\n\t\t\t\topen(at)\n\t\t\t\treturn\n\t\t\t}\n\t\t\tif (state !== 'closed') {\n\t\t\t\treturn\n\t\t\t}\n\t\t\tconsecutive++\n\t\t\tif (effect === 'open' || consecutive >= threshold) {\n\t\t\t\tconsecutive = 0\n\t\t\t\topen(at)\n\t\t\t}\n\t\t},\n\t\tsnapshot() {\n\t\t\tconst at = options.now()\n\t\t\tconst waiting = state === 'open' && at < openUntil\n\t\t\treturn {\n\t\t\t\tstate,\n\t\t\t\t...(waiting ? { retryAfterMs: openUntil - at } : {}),\n\t\t\t\t...(lastFailure ? { lastFailure } : {}),\n\t\t\t}\n\t\t},\n\t}\n}\n"],"mappings":";;AAGA,MAAM,oBAAoB;;AAM1B,MAAa,iBAAiB;;AAG9B,MAAM,gBAAgB;;AA4CtB,MAAM,YAAY,YAAsD;CACvE,IAAI,QAAQ,SAAS,wBAAwB,OAAO;CACpD,IAAI,QAAQ,SAAS,iBAAiB,CAAC,QAAQ,SAAS,OAAO;CAC/D,OAAO;AACR;;;;;AAMA,MAAa,iBAAiB,YAAqC;CAClE,MAAM,YAAY,QAAQ,aAAa;CACvC,MAAM,SAAS,QAAQ,UAAA;CACvB,MAAM,QAAQ,QAAQ,SAAA;CACtB,MAAM,iBAAiB,QAAQ,kBAAA;CAC/B,IAAI,QAAsB;CAC1B,IAAI,cAAc;CAClB,IAAI,WAAW;CACf,IAAI,YAAY;CAChB,IAAI,UAAU;CACd,IAAI,WAAW;CACf,IAAI;CAEJ,MAAM,QAAQ,OAAqB;EAClC,QAAQ;EACR,YAAY,KAAK;EACjB,UAAU;CACX;CAEA,MAAM,UAAU,UAA8B;EAC7C,IAAI,UAAU,UACb,OAAO;GAAE,IAAI;GAAM,OAAO;EAAM;EAEjC,MAAM,KAAK,QAAQ,IAAI;EACvB,IAAI,UAAU,UAAU,KAAK,WAC5B,OAAO;GAAE,IAAI;GAAO,cAAc,YAAY;EAAG;EAElD,IAAI,WAAW,KAAK,WAAW,gBAC9B,OAAO;GAAE,IAAI;GAAO,cAAc,KAAK,IAAI,eAAe,kBAAkB,KAAK,SAAS;EAAE;EAE7F,IAAI,OAAO;GACV,QAAQ;GACR,UAAU;GACV,WAAW;EACZ;EACA,OAAO;GAAE,IAAI;GAAM,OAAO;EAAK;CAChC;CAEA,OAAO;EACN,YAAY,OAAO,KAAK;EACxB,aAAa,OAAO,IAAI;EACxB,UAAU;GACT,IAAI,SAAS;IACZ,UAAU;IACV,QAAQ;GACT;EACD;EACA,OAAO,SAAS,OAAO;GACtB,MAAM,SAAS,YAAY,YAAY,WAAW,SAAS,OAAO;GAClE,IAAI,YAAY,aAAa,WAAW,UAAU;IACjD,cAAc;IACd,cAAc,KAAA;IACd,IAAI,SAAS,UAAU,UAAU;KAChC,QAAQ;KACR,WAAW;KACX,UAAU;IACX;IACA;GACD;GACA,cAAc;GACd,MAAM,KAAK,QAAQ,IAAI;GACvB,IAAI,OAAO;IACV,WAAW,KAAK,IAAI,WAAW,GAAG,KAAK;IACvC,KAAK,EAAE;IACP;GACD;GACA,IAAI,UAAU,UACb;GAED;GACA,IAAI,WAAW,UAAU,eAAe,WAAW;IAClD,cAAc;IACd,KAAK,EAAE;GACR;EACD;EACA,WAAW;GACV,MAAM,KAAK,QAAQ,IAAI;GAEvB,OAAO;IACN;IACA,GAHe,UAAU,UAAU,KAAK,YAG1B,EAAE,cAAc,YAAY,GAAG,IAAI,CAAC;IAClD,GAAI,cAAc,EAAE,YAAY,IAAI,CAAC;GACtC;EACD;CACD;AACD"}
@@ -0,0 +1,8 @@
1
+ import { CollectionConfig } from "payload";
2
+
3
+ //#region src/surfacing/cacheCollection.d.ts
4
+ /** The read cache's slug, unless `cache.collection.slug` names another. */
5
+ declare const CACHE_SLUG = "analytics-cache";
6
+ //#endregion
7
+ export { CACHE_SLUG };
8
+ //# sourceMappingURL=cacheCollection.d.ts.map
@@ -0,0 +1,69 @@
1
+ //#region src/surfacing/cacheCollection.ts
2
+ /** The read cache's slug, unless `cache.collection.slug` names another. */
3
+ const CACHE_SLUG = "analytics-cache";
4
+ const nobody = () => false;
5
+ /**
6
+ * The read cache, one row per key, reached only through `payload.db`. On MongoDB `staleUntil` has
7
+ * no Payload index, which would conflict with the TTL index the plugin creates on it.
8
+ */
9
+ const cacheCollection = (args) => ({
10
+ slug: args.slug,
11
+ admin: { hidden: true },
12
+ access: {
13
+ read: nobody,
14
+ create: nobody,
15
+ update: nobody,
16
+ delete: nobody
17
+ },
18
+ endpoints: false,
19
+ graphQL: false,
20
+ timestamps: false,
21
+ lockDocuments: false,
22
+ fields: [
23
+ {
24
+ name: "key",
25
+ type: "text",
26
+ required: true,
27
+ unique: true,
28
+ index: true
29
+ },
30
+ {
31
+ name: "value",
32
+ type: "json",
33
+ required: true
34
+ },
35
+ {
36
+ name: "owner",
37
+ type: "text"
38
+ },
39
+ {
40
+ name: "fetchedAt",
41
+ type: "date",
42
+ required: true
43
+ },
44
+ {
45
+ name: "expiresAt",
46
+ type: "date",
47
+ required: true
48
+ },
49
+ {
50
+ name: "staleUntil",
51
+ type: "date",
52
+ required: true,
53
+ ...args.mongo ? {} : { index: true }
54
+ },
55
+ {
56
+ name: "readAt",
57
+ type: "date",
58
+ index: true
59
+ },
60
+ {
61
+ name: "recipe",
62
+ type: "json"
63
+ }
64
+ ]
65
+ });
66
+ //#endregion
67
+ export { CACHE_SLUG, cacheCollection };
68
+
69
+ //# sourceMappingURL=cacheCollection.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"cacheCollection.js","names":[],"sources":["../../src/surfacing/cacheCollection.ts"],"sourcesContent":["import type { CollectionConfig } from 'payload'\n\n/** The read cache's slug, unless `cache.collection.slug` names another. */\nexport const CACHE_SLUG = 'analytics-cache'\n\nconst nobody = (): boolean => false\n\n/**\n * The read cache, one row per key, reached only through `payload.db`. On MongoDB `staleUntil` has\n * no Payload index, which would conflict with the TTL index the plugin creates on it.\n */\nexport const cacheCollection = (args: { slug: string; mongo: boolean }): CollectionConfig => ({\n\tslug: args.slug,\n\tadmin: { hidden: true },\n\taccess: { read: nobody, create: nobody, update: nobody, delete: nobody },\n\tendpoints: false,\n\tgraphQL: false,\n\ttimestamps: false,\n\tlockDocuments: false,\n\tfields: [\n\t\t{ name: 'key', type: 'text', required: true, unique: true, index: true },\n\t\t{ name: 'value', type: 'json', required: true },\n\t\t{ name: 'owner', type: 'text' },\n\t\t{ name: 'fetchedAt', type: 'date', required: true },\n\t\t{ name: 'expiresAt', type: 'date', required: true },\n\t\t{ name: 'staleUntil', type: 'date', required: true, ...(args.mongo ? {} : { index: true }) },\n\t\t{ name: 'readAt', type: 'date', index: true },\n\t\t{ name: 'recipe', type: 'json' },\n\t],\n})\n"],"mappings":";;AAGA,MAAa,aAAa;AAE1B,MAAM,eAAwB;;;;;AAM9B,MAAa,mBAAmB,UAA8D;CAC7F,MAAM,KAAK;CACX,OAAO,EAAE,QAAQ,KAAK;CACtB,QAAQ;EAAE,MAAM;EAAQ,QAAQ;EAAQ,QAAQ;EAAQ,QAAQ;CAAO;CACvE,WAAW;CACX,SAAS;CACT,YAAY;CACZ,eAAe;CACf,QAAQ;EACP;GAAE,MAAM;GAAO,MAAM;GAAQ,UAAU;GAAM,QAAQ;GAAM,OAAO;EAAK;EACvE;GAAE,MAAM;GAAS,MAAM;GAAQ,UAAU;EAAK;EAC9C;GAAE,MAAM;GAAS,MAAM;EAAO;EAC9B;GAAE,MAAM;GAAa,MAAM;GAAQ,UAAU;EAAK;EAClD;GAAE,MAAM;GAAa,MAAM;GAAQ,UAAU;EAAK;EAClD;GAAE,MAAM;GAAc,MAAM;GAAQ,UAAU;GAAM,GAAI,KAAK,QAAQ,CAAC,IAAI,EAAE,OAAO,KAAK;EAAG;EAC3F;GAAE,MAAM;GAAU,MAAM;GAAQ,OAAO;EAAK;EAC5C;GAAE,MAAM;GAAU,MAAM;EAAO;CAChC;AACD"}
@@ -1 +1,71 @@
1
- export { };
1
+ import { AnalyticsQuery, AnalyticsResult } from "../core/contract.js";
2
+ import { TimeframePreset } from "../timeframe/presets.js";
3
+
4
+ //#region src/surfacing/cacheStore.d.ts
5
+ /**
6
+ * Which window of its timeframe a recipe's read covered: up to the read (`live`), the preset's
7
+ * whole calendar days (`days`), or as many days before it (`previous`, a comparison).
8
+ */
9
+ type RecipeWindow = 'live' | 'days' | 'previous';
10
+ /**
11
+ * What it takes to repeat a reader's read: source, scope, timeframe and window, and the query
12
+ * without its window, which is worked out again on each repeat.
13
+ */
14
+ interface ReadRecipe {
15
+ /** The source's adapter id, as the scope's sources list it. */
16
+ adapterRef: string;
17
+ scope: string | null;
18
+ timeframe: TimeframePreset;
19
+ window: RecipeWindow;
20
+ query: Omit<AnalyticsQuery, 'dateRange'>;
21
+ }
22
+ /** One cached read. Instants are epoch milliseconds. */
23
+ interface CacheEntry {
24
+ value: AnalyticsResult;
25
+ /** When the value was fetched from its source. */
26
+ fetchedAt: number;
27
+ /** Until when the value is fresh. */
28
+ expiresAt: number;
29
+ /** Until when it is served at all: stale past `expiresAt`, while a refresh runs. */
30
+ staleUntil: number;
31
+ /** When a read carrying a recipe last asked for it; null or absent when none did. */
32
+ readAt?: number | null;
33
+ }
34
+ interface CacheSetOptions {
35
+ /** Seconds the value is fresh, from now. */
36
+ ttlSeconds: number;
37
+ /** Seconds past that it may still be served stale. */
38
+ staleSeconds: number;
39
+ /** The scope the read was made for, absent for an install-wide read. */
40
+ scope?: string;
41
+ /**
42
+ * Present when a reader's read can be repeated by the warm task; the entry then counts as read
43
+ * now. The warm task's own writes carry none, which leaves the entry's recipe and read time be.
44
+ */
45
+ recipe?: ReadRecipe;
46
+ }
47
+ /**
48
+ * Where reads are cached across instances (`cache.store`; built in: `analytics-cache`). Every call
49
+ * is best effort: a throw makes a hit a miss and a write nothing, and never fails the read.
50
+ */
51
+ interface CacheStore {
52
+ /** The entry under `key`; null when there is none or it is past its `staleUntil`. */
53
+ get(key: string): Promise<CacheEntry | null>;
54
+ /** Stores `value` under `key`, replacing any entry, stamped with the store's own clock. */
55
+ set(key: string, value: AnalyticsResult, options: CacheSetOptions): Promise<void>;
56
+ /**
57
+ * Records that a read carrying `recipe` asked for the entry at `at`, storing the recipe with it
58
+ * when given: an entry the warm task wrote has none until a reader asks for it.
59
+ */
60
+ touch(key: string, at: Date, recipe?: ReadRecipe): Promise<void>;
61
+ /**
62
+ * Deletes at most `batch` entries whose `staleUntil` is before `now` and answers how many. A
63
+ * store that expires entries itself answers 0.
64
+ */
65
+ sweep(now: Date, batch: number): Promise<number>;
66
+ /** The recipes of entries read since `since`, most recently read first, each once. */
67
+ recentRecipes(since: Date, limit: number): Promise<ReadRecipe[]>;
68
+ }
69
+ //#endregion
70
+ export { CacheEntry, CacheSetOptions, CacheStore, ReadRecipe, RecipeWindow };
71
+ //# sourceMappingURL=cacheStore.d.ts.map
@@ -1,42 +1,21 @@
1
+ import { hasMethods, isRecord } from "../core/values.js";
2
+ import { isTimeframePreset } from "../timeframe/presets.js";
3
+ import { isRecipeWindow } from "./recipe.js";
1
4
  //#region src/surfacing/cacheStore.ts
2
- /** How long past expiry a value stays eligible for stale-while-error serving. */
5
+ /** How long past its expiry an entry is still served, stale, while a refresh runs. */
3
6
  const STALE_WINDOW_SECONDS = 86400;
4
- function kvCacheStore(kv) {
5
- const store = {
6
- now: () => Date.now(),
7
- async get(key) {
8
- const hit = await kv.get(key);
9
- if (!hit) return null;
10
- if ((hit.staleUntil ?? hit.expiresAt) <= store.now()) {
11
- await kv.delete(key);
12
- return null;
13
- }
14
- if (hit.expiresAt <= store.now()) return null;
15
- return hit.value;
16
- },
17
- async getStale(key) {
18
- const hit = await kv.get(key);
19
- if (!hit) return null;
20
- const now = store.now();
21
- if ((hit.staleUntil ?? hit.expiresAt) <= now) {
22
- await kv.delete(key);
23
- return null;
24
- }
25
- if (hit.expiresAt > now) return null;
26
- return hit.value;
27
- },
28
- async set(key, value, ttlSeconds) {
29
- const expiresAt = store.now() + ttlSeconds * 1e3;
30
- await kv.set(key, {
31
- value,
32
- expiresAt,
33
- staleUntil: expiresAt + STALE_WINDOW_SECONDS * 1e3
34
- });
35
- }
36
- };
37
- return store;
38
- }
7
+ const CACHE_STORE_METHODS = [
8
+ "get",
9
+ "set",
10
+ "touch",
11
+ "sweep",
12
+ "recentRecipes"
13
+ ];
14
+ const isCacheStore = (value) => hasMethods(value, CACHE_STORE_METHODS);
15
+ /** Whether a stored value still has the shape of a read result; anything else reads as a miss. */
16
+ const isCachedResult = (value) => isRecord(value) && Array.isArray(value.rows) && isRecord(value.meta) && typeof value.meta.provider === "string" && typeof value.meta.fetchedAt === "string";
17
+ const isReadRecipe = (value) => isRecord(value) && typeof value.adapterRef === "string" && (value.scope === null || typeof value.scope === "string") && isTimeframePreset(value.timeframe) && isRecipeWindow(value.window) && isRecord(value.query) && Array.isArray(value.query.metrics);
39
18
  //#endregion
40
- export { kvCacheStore };
19
+ export { STALE_WINDOW_SECONDS, isCacheStore, isCachedResult, isReadRecipe };
41
20
 
42
21
  //# sourceMappingURL=cacheStore.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"cacheStore.js","names":[],"sources":["../../src/surfacing/cacheStore.ts"],"sourcesContent":["import type { KVAdapter } from 'payload'\n\nexport interface CacheStore {\n\tget<T>(key: string): Promise<T | null>\n\t/** Serves a value past `expiresAt` but still within the stale window; null once cold or past it. */\n\tgetStale<T>(key: string): Promise<T | null>\n\tset<T>(key: string, value: T, ttlSeconds: number): Promise<void>\n\t// Injected for testing; defaults to Date.now\n\tnow: () => number\n}\n\n/** How long past expiry a value stays eligible for stale-while-error serving. */\nexport const STALE_WINDOW_SECONDS = 86_400\n\ninterface Wrapped<T> {\n\tvalue: T\n\texpiresAt: number\n\t// Absent on entries written before stale-while-error shipped; treated as expiresAt (never stale-served).\n\tstaleUntil?: number\n}\n\nexport function kvCacheStore(kv: KVAdapter): CacheStore {\n\tconst store: CacheStore = {\n\t\tnow: () => Date.now(),\n\t\tasync get<T>(key: string): Promise<T | null> {\n\t\t\tconst hit = await kv.get<Wrapped<T>>(key)\n\t\t\tif (!hit) return null\n\t\t\tconst staleUntil = hit.staleUntil ?? hit.expiresAt\n\t\t\tif (staleUntil <= store.now()) {\n\t\t\t\tawait kv.delete(key)\n\t\t\t\treturn null\n\t\t\t}\n\t\t\tif (hit.expiresAt <= store.now()) return null\n\t\t\treturn hit.value\n\t\t},\n\t\tasync getStale<T>(key: string): Promise<T | null> {\n\t\t\tconst hit = await kv.get<Wrapped<T>>(key)\n\t\t\tif (!hit) return null\n\t\t\tconst now = store.now()\n\t\t\tconst staleUntil = hit.staleUntil ?? hit.expiresAt\n\t\t\tif (staleUntil <= now) {\n\t\t\t\tawait kv.delete(key)\n\t\t\t\treturn null\n\t\t\t}\n\t\t\tif (hit.expiresAt > now) return null\n\t\t\treturn hit.value\n\t\t},\n\t\tasync set<T>(key: string, value: T, ttlSeconds: number): Promise<void> {\n\t\t\tconst expiresAt = store.now() + ttlSeconds * 1000\n\t\t\tawait kv.set(key, {\n\t\t\t\tvalue,\n\t\t\t\texpiresAt,\n\t\t\t\tstaleUntil: expiresAt + STALE_WINDOW_SECONDS * 1000,\n\t\t\t} satisfies Wrapped<T>)\n\t\t},\n\t}\n\treturn store\n}\n"],"mappings":";;AAYA,MAAa,uBAAuB;AASpC,SAAgB,aAAa,IAA2B;CACvD,MAAM,QAAoB;EACzB,WAAW,KAAK,IAAI;EACpB,MAAM,IAAO,KAAgC;GAC5C,MAAM,MAAM,MAAM,GAAG,IAAgB,GAAG;GACxC,IAAI,CAAC,KAAK,OAAO;GAEjB,KADmB,IAAI,cAAc,IAAI,cACvB,MAAM,IAAI,GAAG;IAC9B,MAAM,GAAG,OAAO,GAAG;IACnB,OAAO;GACR;GACA,IAAI,IAAI,aAAa,MAAM,IAAI,GAAG,OAAO;GACzC,OAAO,IAAI;EACZ;EACA,MAAM,SAAY,KAAgC;GACjD,MAAM,MAAM,MAAM,GAAG,IAAgB,GAAG;GACxC,IAAI,CAAC,KAAK,OAAO;GACjB,MAAM,MAAM,MAAM,IAAI;GAEtB,KADmB,IAAI,cAAc,IAAI,cACvB,KAAK;IACtB,MAAM,GAAG,OAAO,GAAG;IACnB,OAAO;GACR;GACA,IAAI,IAAI,YAAY,KAAK,OAAO;GAChC,OAAO,IAAI;EACZ;EACA,MAAM,IAAO,KAAa,OAAU,YAAmC;GACtE,MAAM,YAAY,MAAM,IAAI,IAAI,aAAa;GAC7C,MAAM,GAAG,IAAI,KAAK;IACjB;IACA;IACA,YAAY,YAAY,uBAAuB;GAChD,CAAsB;EACvB;CACD;CACA,OAAO;AACR"}
1
+ {"version":3,"file":"cacheStore.js","names":[],"sources":["../../src/surfacing/cacheStore.ts"],"sourcesContent":["import type { AnalyticsQuery, AnalyticsResult } from '../core/contract'\nimport { hasMethods, isRecord } from '../core/values'\nimport { isTimeframePreset, type TimeframePreset } from '../timeframe/presets'\nimport { isRecipeWindow } from './recipe'\n\n/** How long past its expiry an entry is still served, stale, while a refresh runs. */\nexport const STALE_WINDOW_SECONDS = 86_400\n\n/**\n * Which window of its timeframe a recipe's read covered: up to the read (`live`), the preset's\n * whole calendar days (`days`), or as many days before it (`previous`, a comparison).\n */\nexport type RecipeWindow = 'live' | 'days' | 'previous'\n\n/**\n * What it takes to repeat a reader's read: source, scope, timeframe and window, and the query\n * without its window, which is worked out again on each repeat.\n */\nexport interface ReadRecipe {\n\t/** The source's adapter id, as the scope's sources list it. */\n\tadapterRef: string\n\tscope: string | null\n\ttimeframe: TimeframePreset\n\twindow: RecipeWindow\n\tquery: Omit<AnalyticsQuery, 'dateRange'>\n}\n\n/** One cached read. Instants are epoch milliseconds. */\nexport interface CacheEntry {\n\tvalue: AnalyticsResult\n\t/** When the value was fetched from its source. */\n\tfetchedAt: number\n\t/** Until when the value is fresh. */\n\texpiresAt: number\n\t/** Until when it is served at all: stale past `expiresAt`, while a refresh runs. */\n\tstaleUntil: number\n\t/** When a read carrying a recipe last asked for it; null or absent when none did. */\n\treadAt?: number | null\n}\n\nexport interface CacheSetOptions {\n\t/** Seconds the value is fresh, from now. */\n\tttlSeconds: number\n\t/** Seconds past that it may still be served stale. */\n\tstaleSeconds: number\n\t/** The scope the read was made for, absent for an install-wide read. */\n\tscope?: string\n\t/**\n\t * Present when a reader's read can be repeated by the warm task; the entry then counts as read\n\t * now. The warm task's own writes carry none, which leaves the entry's recipe and read time be.\n\t */\n\trecipe?: ReadRecipe\n}\n\n/**\n * Where reads are cached across instances (`cache.store`; built in: `analytics-cache`). Every call\n * is best effort: a throw makes a hit a miss and a write nothing, and never fails the read.\n */\nexport interface CacheStore {\n\t/** The entry under `key`; null when there is none or it is past its `staleUntil`. */\n\tget(key: string): Promise<CacheEntry | null>\n\t/** Stores `value` under `key`, replacing any entry, stamped with the store's own clock. */\n\tset(key: string, value: AnalyticsResult, options: CacheSetOptions): Promise<void>\n\t/**\n\t * Records that a read carrying `recipe` asked for the entry at `at`, storing the recipe with it\n\t * when given: an entry the warm task wrote has none until a reader asks for it.\n\t */\n\ttouch(key: string, at: Date, recipe?: ReadRecipe): Promise<void>\n\t/**\n\t * Deletes at most `batch` entries whose `staleUntil` is before `now` and answers how many. A\n\t * store that expires entries itself answers 0.\n\t */\n\tsweep(now: Date, batch: number): Promise<number>\n\t/** The recipes of entries read since `since`, most recently read first, each once. */\n\trecentRecipes(since: Date, limit: number): Promise<ReadRecipe[]>\n}\n\nconst CACHE_STORE_METHODS = ['get', 'set', 'touch', 'sweep', 'recentRecipes'] as const\n\nexport const isCacheStore = (value: unknown): value is CacheStore =>\n\thasMethods(value, CACHE_STORE_METHODS)\n\n/** Whether a stored value still has the shape of a read result; anything else reads as a miss. */\nexport const isCachedResult = (value: unknown): value is AnalyticsResult =>\n\tisRecord(value) &&\n\tArray.isArray(value.rows) &&\n\tisRecord(value.meta) &&\n\ttypeof value.meta.provider === 'string' &&\n\ttypeof value.meta.fetchedAt === 'string'\n\nexport const isReadRecipe = (value: unknown): value is ReadRecipe =>\n\tisRecord(value) &&\n\ttypeof value.adapterRef === 'string' &&\n\t(value.scope === null || typeof value.scope === 'string') &&\n\tisTimeframePreset(value.timeframe) &&\n\tisRecipeWindow(value.window) &&\n\tisRecord(value.query) &&\n\tArray.isArray(value.query.metrics)\n"],"mappings":";;;;;AAMA,MAAa,uBAAuB;AAuEpC,MAAM,sBAAsB;CAAC;CAAO;CAAO;CAAS;CAAS;AAAe;AAE5E,MAAa,gBAAgB,UAC5B,WAAW,OAAO,mBAAmB;;AAGtC,MAAa,kBAAkB,UAC9B,SAAS,KAAK,KACd,MAAM,QAAQ,MAAM,IAAI,KACxB,SAAS,MAAM,IAAI,KACnB,OAAO,MAAM,KAAK,aAAa,YAC/B,OAAO,MAAM,KAAK,cAAc;AAEjC,MAAa,gBAAgB,UAC5B,SAAS,KAAK,KACd,OAAO,MAAM,eAAe,aAC3B,MAAM,UAAU,QAAQ,OAAO,MAAM,UAAU,aAChD,kBAAkB,MAAM,SAAS,KACjC,eAAe,MAAM,MAAM,KAC3B,SAAS,MAAM,KAAK,KACpB,MAAM,QAAQ,MAAM,MAAM,OAAO"}
@@ -0,0 +1 @@
1
+ export { };
@@ -0,0 +1,59 @@
1
+ /** How long a sweep holds its lease: a sweep that froze lets the next one in after this. */
2
+ const SWEEP_LEASE_MS = 2 * 6e4;
3
+ /** The name of the lease every sweep takes, `lease:cache-sweep` in `analytics-state`. */
4
+ const SWEEP_LEASE = "cache-sweep";
5
+ const createCacheSweeper = (options) => {
6
+ const intervalMs = options.intervalMs ?? 6e5;
7
+ const batch = options.batch ?? 1e3;
8
+ let startedAt;
9
+ let running;
10
+ const sweep = async (batches = 1) => {
11
+ if (options.deferred?.()) return {
12
+ ran: false,
13
+ swept: 0
14
+ };
15
+ const lease = options.lease();
16
+ if (lease && !await lease.claim()) return {
17
+ ran: false,
18
+ swept: 0
19
+ };
20
+ try {
21
+ let swept = 0;
22
+ for (let round = 0; round < batches; round++) {
23
+ const deleted = await options.store.sweep(options.now(), batch);
24
+ swept += deleted;
25
+ if (deleted < batch) break;
26
+ }
27
+ return {
28
+ ran: true,
29
+ swept
30
+ };
31
+ } finally {
32
+ try {
33
+ await lease?.release();
34
+ } catch (err) {
35
+ options.warn?.(`analytics: releasing the cache sweep lease failed: ${String(err)}`);
36
+ }
37
+ }
38
+ };
39
+ return {
40
+ sweep,
41
+ maybeSweep() {
42
+ const at = options.now().getTime();
43
+ if (running || startedAt !== void 0 && at - startedAt < intervalMs) return;
44
+ startedAt = at;
45
+ running = sweep(1).then(() => void 0).catch((err) => {
46
+ options.warn?.(`analytics: sweeping expired cache entries failed: ${String(err)}`);
47
+ }).finally(() => {
48
+ running = void 0;
49
+ });
50
+ },
51
+ idle: async () => {
52
+ await running;
53
+ }
54
+ };
55
+ };
56
+ //#endregion
57
+ export { SWEEP_LEASE, SWEEP_LEASE_MS, createCacheSweeper };
58
+
59
+ //# sourceMappingURL=cacheSweep.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"cacheSweep.js","names":[],"sources":["../../src/surfacing/cacheSweep.ts"],"sourcesContent":["import type { Lease } from '../maintenance/lease'\nimport type { CacheStore } from './cacheStore'\n\n/** Entries one batch deletes at most. */\nexport const SWEEP_BATCH = 1_000\n\n/** How long one instance waits between the sweeps it starts on its own. */\nexport const SWEEP_INTERVAL_MS = 10 * 60_000\n\n/** How long a sweep holds its lease: a sweep that froze lets the next one in after this. */\nexport const SWEEP_LEASE_MS = 2 * 60_000\n\n/** The name of the lease every sweep takes, `lease:cache-sweep` in `analytics-state`. */\nexport const SWEEP_LEASE = 'cache-sweep'\n\n/** The most batches one run of `analytics-maintain` deletes. */\nexport const TASK_SWEEP_BATCHES = 10\n\nexport interface SweepReport {\n\t/**\n\t * False when another instance held the lease, or the sweep was left for later, so this one\n\t * deleted nothing.\n\t */\n\tran: boolean\n\tswept: number\n}\n\nexport interface CacheSweeper {\n\t/**\n\t * Starts one batch in the background unless this instance started one within the interval or\n\t * one is still running. Never rejects: a failure is reported through `warn`.\n\t */\n\tmaybeSweep(): void\n\t/** Sweeps now under the lease, batch after batch while each comes back full, up to `batches`. */\n\tsweep(batches?: number): Promise<SweepReport>\n\t/** Settles once the background sweep, if one runs, has finished. */\n\tidle(): Promise<void>\n}\n\nexport interface CacheSweeperOptions {\n\tstore: CacheStore\n\t/**\n\t * The lease a sweep runs under, asked for per sweep; undefined sweeps without one. Sweeping is\n\t * idempotent, so the lease only keeps two instances from deleting the same rows at once.\n\t */\n\tlease: () => Lease | undefined\n\tnow: () => Date\n\twarn?: (message: string) => void\n\tintervalMs?: number\n\tbatch?: number\n\t/**\n\t * Whether to leave this sweep for a later one, asked before its lease: true while its writes\n\t * would wait on a lock this process holds (`hostHoldsWriteLock`).\n\t */\n\tdeferred?: () => boolean\n}\n\nexport const createCacheSweeper = (options: CacheSweeperOptions): CacheSweeper => {\n\tconst intervalMs = options.intervalMs ?? SWEEP_INTERVAL_MS\n\tconst batch = options.batch ?? SWEEP_BATCH\n\tlet startedAt: number | undefined\n\tlet running: Promise<void> | undefined\n\n\tconst sweep = async (batches = 1): Promise<SweepReport> => {\n\t\tif (options.deferred?.()) {\n\t\t\treturn { ran: false, swept: 0 }\n\t\t}\n\t\tconst lease = options.lease()\n\t\tif (lease && !(await lease.claim())) {\n\t\t\treturn { ran: false, swept: 0 }\n\t\t}\n\t\ttry {\n\t\t\tlet swept = 0\n\t\t\tfor (let round = 0; round < batches; round++) {\n\t\t\t\tconst deleted = await options.store.sweep(options.now(), batch)\n\t\t\t\tswept += deleted\n\t\t\t\tif (deleted < batch) {\n\t\t\t\t\tbreak\n\t\t\t\t}\n\t\t\t}\n\t\t\treturn { ran: true, swept }\n\t\t} finally {\n\t\t\ttry {\n\t\t\t\tawait lease?.release()\n\t\t\t} catch (err) {\n\t\t\t\toptions.warn?.(`analytics: releasing the cache sweep lease failed: ${String(err)}`)\n\t\t\t}\n\t\t}\n\t}\n\n\treturn {\n\t\tsweep,\n\t\tmaybeSweep() {\n\t\t\tconst at = options.now().getTime()\n\t\t\tif (running || (startedAt !== undefined && at - startedAt < intervalMs)) {\n\t\t\t\treturn\n\t\t\t}\n\t\t\tstartedAt = at\n\t\t\trunning = sweep(1)\n\t\t\t\t.then(() => undefined)\n\t\t\t\t.catch((err: unknown) => {\n\t\t\t\t\toptions.warn?.(`analytics: sweeping expired cache entries failed: ${String(err)}`)\n\t\t\t\t})\n\t\t\t\t.finally(() => {\n\t\t\t\t\trunning = undefined\n\t\t\t\t})\n\t\t},\n\t\tidle: async () => {\n\t\t\tawait running\n\t\t},\n\t}\n}\n"],"mappings":";AAUA,MAAa,iBAAiB,IAAI;;AAGlC,MAAa,cAAc;AA4C3B,MAAa,sBAAsB,YAA+C;CACjF,MAAM,aAAa,QAAQ,cAAA;CAC3B,MAAM,QAAQ,QAAQ,SAAA;CACtB,IAAI;CACJ,IAAI;CAEJ,MAAM,QAAQ,OAAO,UAAU,MAA4B;EAC1D,IAAI,QAAQ,WAAW,GACtB,OAAO;GAAE,KAAK;GAAO,OAAO;EAAE;EAE/B,MAAM,QAAQ,QAAQ,MAAM;EAC5B,IAAI,SAAS,CAAE,MAAM,MAAM,MAAM,GAChC,OAAO;GAAE,KAAK;GAAO,OAAO;EAAE;EAE/B,IAAI;GACH,IAAI,QAAQ;GACZ,KAAK,IAAI,QAAQ,GAAG,QAAQ,SAAS,SAAS;IAC7C,MAAM,UAAU,MAAM,QAAQ,MAAM,MAAM,QAAQ,IAAI,GAAG,KAAK;IAC9D,SAAS;IACT,IAAI,UAAU,OACb;GAEF;GACA,OAAO;IAAE,KAAK;IAAM;GAAM;EAC3B,UAAU;GACT,IAAI;IACH,MAAM,OAAO,QAAQ;GACtB,SAAS,KAAK;IACb,QAAQ,OAAO,sDAAsD,OAAO,GAAG,GAAG;GACnF;EACD;CACD;CAEA,OAAO;EACN;EACA,aAAa;GACZ,MAAM,KAAK,QAAQ,IAAI,EAAE,QAAQ;GACjC,IAAI,WAAY,cAAc,KAAA,KAAa,KAAK,YAAY,YAC3D;GAED,YAAY;GACZ,UAAU,MAAM,CAAC,EACf,WAAW,KAAA,CAAS,EACpB,OAAO,QAAiB;IACxB,QAAQ,OAAO,qDAAqD,OAAO,GAAG,GAAG;GAClF,CAAC,EACA,cAAc;IACd,UAAU,KAAA;GACX,CAAC;EACH;EACA,MAAM,YAAY;GACjB,MAAM;EACP;CACD;AACD"}