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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (1241) hide show
  1. package/CHANGELOG.md +463 -0
  2. package/README.md +30 -37
  3. package/dist/access/adminUser.d.ts +15 -0
  4. package/dist/access/adminUser.js +13 -0
  5. package/dist/access/adminUser.js.map +1 -0
  6. package/dist/access/decideOnce.js +16 -0
  7. package/dist/access/decideOnce.js.map +1 -0
  8. package/dist/access/membership.d.ts +23 -0
  9. package/dist/access/membership.js +63 -0
  10. package/dist/access/membership.js.map +1 -0
  11. package/dist/access/principal.d.ts +37 -0
  12. package/dist/access/principal.js +29 -0
  13. package/dist/access/principal.js.map +1 -0
  14. package/dist/access/readGate.js +16 -0
  15. package/dist/access/readGate.js.map +1 -0
  16. package/dist/adapters/ga4/disableKey.js +7 -9
  17. package/dist/adapters/ga4/disableKey.js.map +1 -1
  18. package/dist/adapters/ga4/eventName.d.ts +2 -8
  19. package/dist/adapters/ga4/eventName.js +2 -8
  20. package/dist/adapters/ga4/eventName.js.map +1 -1
  21. package/dist/adapters/ga4/ga4.d.ts +11 -0
  22. package/dist/adapters/ga4/ga4.js +206 -123
  23. package/dist/adapters/ga4/ga4.js.map +1 -1
  24. package/dist/adapters/ga4/measurementId.js +2 -3
  25. package/dist/adapters/ga4/measurementId.js.map +1 -1
  26. package/dist/adapters/goalRead.js +15 -29
  27. package/dist/adapters/goalRead.js.map +1 -1
  28. package/dist/adapters/http/baseUrl.js +15 -0
  29. package/dist/adapters/http/baseUrl.js.map +1 -0
  30. package/dist/adapters/http/fetchJson.d.ts +19 -0
  31. package/dist/adapters/http/fetchJson.js +27 -8
  32. package/dist/adapters/http/fetchJson.js.map +1 -1
  33. package/dist/adapters/mapping.js +52 -0
  34. package/dist/adapters/mapping.js.map +1 -0
  35. package/dist/adapters/plausible/plausible.d.ts +13 -13
  36. package/dist/adapters/plausible/plausible.js +137 -122
  37. package/dist/adapters/plausible/plausible.js.map +1 -1
  38. package/dist/adapters/plausible/scriptId.js +19 -0
  39. package/dist/adapters/plausible/scriptId.js.map +1 -0
  40. package/dist/adapters/posthog/posthog.d.ts +20 -9
  41. package/dist/adapters/posthog/posthog.js +179 -113
  42. package/dist/adapters/posthog/posthog.js.map +1 -1
  43. package/dist/adapters/readTime.js +7 -0
  44. package/dist/adapters/readTime.js.map +1 -0
  45. package/dist/adapters/series.js +14 -8
  46. package/dist/adapters/series.js.map +1 -1
  47. package/dist/adapters/umami/umami.d.ts +7 -9
  48. package/dist/adapters/umami/umami.js +184 -172
  49. package/dist/adapters/umami/umami.js.map +1 -1
  50. package/dist/adapters/upstream.js +16 -0
  51. package/dist/adapters/upstream.js.map +1 -0
  52. package/dist/binding/report.d.ts +8 -0
  53. package/dist/binding/report.js +24 -0
  54. package/dist/binding/report.js.map +1 -0
  55. package/dist/binding/resolvePath.js +16 -29
  56. package/dist/binding/resolvePath.js.map +1 -1
  57. package/dist/binding/types.d.ts +14 -29
  58. package/dist/capture/captureRequest.js +28 -0
  59. package/dist/capture/captureRequest.js.map +1 -0
  60. package/dist/capture/exclusionEndpoint.js +98 -0
  61. package/dist/capture/exclusionEndpoint.js.map +1 -0
  62. package/dist/capture/exclusionPrelude.js +14 -0
  63. package/dist/capture/exclusionPrelude.js.map +1 -0
  64. package/dist/capture/exclusionToken.js +23 -0
  65. package/dist/capture/exclusionToken.js.map +1 -0
  66. package/dist/capture/jsLiteral.js +19 -0
  67. package/dist/capture/jsLiteral.js.map +1 -0
  68. package/dist/capture/mountPath.js +2 -3
  69. package/dist/capture/mountPath.js.map +1 -1
  70. package/dist/capture/proxyEndpoint.js +48 -95
  71. package/dist/capture/proxyEndpoint.js.map +1 -1
  72. package/dist/capture/proxyRoutes.js +58 -21
  73. package/dist/capture/proxyRoutes.js.map +1 -1
  74. package/dist/capture/relay.js +91 -0
  75. package/dist/capture/relay.js.map +1 -0
  76. package/dist/capture/requestBody.js +2 -6
  77. package/dist/capture/requestBody.js.map +1 -1
  78. package/dist/capture/requestTrust.js +45 -0
  79. package/dist/capture/requestTrust.js.map +1 -0
  80. package/dist/capture/sameSite.js +40 -0
  81. package/dist/capture/sameSite.js.map +1 -0
  82. package/dist/capture/slots.js +50 -25
  83. package/dist/capture/slots.js.map +1 -1
  84. package/dist/capture/trackerConfig.js +100 -36
  85. package/dist/capture/trackerConfig.js.map +1 -1
  86. package/dist/capture/trackerEndpoint.js +22 -21
  87. package/dist/capture/trackerEndpoint.js.map +1 -1
  88. package/dist/charts/BarList.d.ts +27 -14
  89. package/dist/charts/BarList.js +38 -83
  90. package/dist/charts/BarList.js.map +1 -1
  91. package/dist/charts/TrendChart.d.ts +40 -7
  92. package/dist/charts/TrendChart.js +243 -215
  93. package/dist/charts/TrendChart.js.map +1 -1
  94. package/dist/charts/bars.d.ts +15 -1
  95. package/dist/charts/bars.js +12 -12
  96. package/dist/charts/bars.js.map +1 -1
  97. package/dist/charts/bucket.js +106 -73
  98. package/dist/charts/bucket.js.map +1 -1
  99. package/dist/charts/inProgress.js +22 -0
  100. package/dist/charts/inProgress.js.map +1 -0
  101. package/dist/charts/series.d.ts +15 -0
  102. package/dist/charts/series.js +123 -0
  103. package/dist/charts/series.js.map +1 -0
  104. package/dist/charts/spline.js +91 -25
  105. package/dist/charts/spline.js.map +1 -1
  106. package/dist/charts/trendGeometry.js +91 -0
  107. package/dist/charts/trendGeometry.js.map +1 -0
  108. package/dist/core/adminOptions.d.ts +1 -0
  109. package/dist/core/adminOptions.js +193 -0
  110. package/dist/core/adminOptions.js.map +1 -0
  111. package/dist/core/budget.js +24 -0
  112. package/dist/core/budget.js.map +1 -0
  113. package/dist/core/cacheKey.d.ts +1 -0
  114. package/dist/core/cacheKey.js +48 -37
  115. package/dist/core/cacheKey.js.map +1 -1
  116. package/dist/core/cacheOptions.js +165 -0
  117. package/dist/core/cacheOptions.js.map +1 -0
  118. package/dist/core/capabilities.d.ts +24 -11
  119. package/dist/core/capabilities.js +96 -17
  120. package/dist/core/capabilities.js.map +1 -1
  121. package/dist/core/capture.d.ts +26 -25
  122. package/dist/core/captureOptions.d.ts +1 -0
  123. package/dist/core/captureOptions.js +258 -0
  124. package/dist/core/captureOptions.js.map +1 -0
  125. package/dist/core/clock.js +13 -0
  126. package/dist/core/clock.js.map +1 -0
  127. package/dist/core/collectionOption.d.ts +17 -0
  128. package/dist/core/collectionOption.js +104 -0
  129. package/dist/core/collectionOption.js.map +1 -0
  130. package/dist/core/collectionSlug.js +7 -0
  131. package/dist/core/collectionSlug.js.map +1 -0
  132. package/dist/core/contract.d.ts +285 -59
  133. package/dist/core/contract.js +6 -4
  134. package/dist/core/contract.js.map +1 -1
  135. package/dist/core/cron.js +57 -0
  136. package/dist/core/cron.js.map +1 -0
  137. package/dist/core/fetch.d.ts +17 -0
  138. package/dist/core/goalOptions.d.ts +1 -0
  139. package/dist/core/goalOptions.js +166 -0
  140. package/dist/core/goalOptions.js.map +1 -0
  141. package/dist/core/granularity.js +3 -2
  142. package/dist/core/granularity.js.map +1 -1
  143. package/dist/core/guards.js +17 -0
  144. package/dist/core/guards.js.map +1 -0
  145. package/dist/core/jobs.d.ts +40 -0
  146. package/dist/core/jobs.js +132 -0
  147. package/dist/core/jobs.js.map +1 -0
  148. package/dist/core/legacyOptions.js +145 -0
  149. package/dist/core/legacyOptions.js.map +1 -0
  150. package/dist/core/metricAliases.js +81 -0
  151. package/dist/core/metricAliases.js.map +1 -0
  152. package/dist/core/metricValues.js +57 -0
  153. package/dist/core/metricValues.js.map +1 -0
  154. package/dist/core/monotonic.js +10 -0
  155. package/dist/core/monotonic.js.map +1 -0
  156. package/dist/core/optionChecks.js +51 -0
  157. package/dist/core/optionChecks.js.map +1 -0
  158. package/dist/core/options.d.ts +473 -157
  159. package/dist/core/options.js +154 -219
  160. package/dist/core/options.js.map +1 -1
  161. package/dist/core/registry.js +45 -5
  162. package/dist/core/registry.js.map +1 -1
  163. package/dist/core/scopeList.js +7 -9
  164. package/dist/core/scopeList.js.map +1 -1
  165. package/dist/core/scopeOptions.d.ts +1 -0
  166. package/dist/core/scopeOptions.js +112 -0
  167. package/dist/core/scopeOptions.js.map +1 -0
  168. package/dist/core/scopedRead.js +182 -72
  169. package/dist/core/scopedRead.js.map +1 -1
  170. package/dist/core/sdks.d.ts +81 -0
  171. package/dist/core/sdks.js +23 -0
  172. package/dist/core/sdks.js.map +1 -0
  173. package/dist/core/serverEvent.d.ts +38 -20
  174. package/dist/core/serverEvent.js.map +1 -1
  175. package/dist/core/siteAddress.js +20 -0
  176. package/dist/core/siteAddress.js.map +1 -0
  177. package/dist/core/sourceErrors.js +109 -0
  178. package/dist/core/sourceErrors.js.map +1 -0
  179. package/dist/core/sourceOptions.js +94 -0
  180. package/dist/core/sourceOptions.js.map +1 -0
  181. package/dist/core/throttle.js +18 -0
  182. package/dist/core/throttle.js.map +1 -0
  183. package/dist/core/values.js +61 -0
  184. package/dist/core/values.js.map +1 -0
  185. package/dist/core/widgetSlugs.d.ts +17 -0
  186. package/dist/core/widgetSlugs.js +29 -0
  187. package/dist/core/widgetSlugs.js.map +1 -0
  188. package/dist/db/detachedWrite.js +36 -0
  189. package/dist/db/detachedWrite.js.map +1 -0
  190. package/dist/db/errors.js +182 -0
  191. package/dist/db/errors.js.map +1 -0
  192. package/dist/db/kind.js +32 -0
  193. package/dist/db/kind.js.map +1 -0
  194. package/dist/db/openTransaction.js +51 -0
  195. package/dist/db/openTransaction.js.map +1 -0
  196. package/dist/exports/adapters/contract.d.ts +14 -0
  197. package/dist/exports/adapters/ga4.d.ts +15 -1
  198. package/dist/exports/adapters/native.d.ts +26 -2
  199. package/dist/exports/adapters/native.js +4 -1
  200. package/dist/exports/adapters/plausible.d.ts +15 -1
  201. package/dist/exports/adapters/posthog.d.ts +15 -1
  202. package/dist/exports/adapters/umami.d.ts +15 -1
  203. package/dist/exports/attributes.d.ts +42 -0
  204. package/dist/exports/attributes.js +83 -0
  205. package/dist/exports/attributes.js.map +1 -0
  206. package/dist/exports/client.d.ts +41 -13
  207. package/dist/exports/client.js +21 -9
  208. package/dist/exports/geo.d.ts +3 -1
  209. package/dist/exports/geo.js +1 -1
  210. package/dist/exports/i18n.d.ts +2 -2
  211. package/dist/exports/i18n.js +2 -2
  212. package/dist/exports/migrations.d.ts +2 -0
  213. package/dist/exports/migrations.js +2 -0
  214. package/dist/exports/next.d.ts +18 -1
  215. package/dist/exports/next.js +3 -1
  216. package/dist/exports/react.d.ts +3 -2
  217. package/dist/exports/react.js +1 -2
  218. package/dist/exports/rsc.d.ts +31 -14
  219. package/dist/exports/rsc.js +11 -6
  220. package/dist/exports/site.d.ts +5 -0
  221. package/dist/exports/site.js +3 -0
  222. package/dist/exports/testing.d.ts +17 -0
  223. package/dist/exports/testing.js +3 -0
  224. package/dist/exports/tracker.d.ts +5 -20
  225. package/dist/exports/tracker.js +3 -14
  226. package/dist/exports/types.d.ts +40 -14
  227. package/dist/exports/types.js +5 -1
  228. package/dist/fields/AnalyticsPanelClient.js +265 -154
  229. package/dist/fields/AnalyticsPanelClient.js.map +1 -1
  230. package/dist/fields/AnalyticsPanelField.d.ts +20 -8
  231. package/dist/fields/AnalyticsPanelField.js +121 -30
  232. package/dist/fields/AnalyticsPanelField.js.map +1 -1
  233. package/dist/fields/AnalyticsStatField.d.ts +18 -7
  234. package/dist/fields/AnalyticsStatField.js +98 -63
  235. package/dist/fields/AnalyticsStatField.js.map +1 -1
  236. package/dist/fields/FieldShimmer.js +15 -0
  237. package/dist/fields/FieldShimmer.js.map +1 -0
  238. package/dist/fields/PanelContent.js +217 -0
  239. package/dist/fields/PanelContent.js.map +1 -0
  240. package/dist/fields/PanelList.js +82 -0
  241. package/dist/fields/PanelList.js.map +1 -0
  242. package/dist/fields/PanelLiveCounter.js +63 -0
  243. package/dist/fields/PanelLiveCounter.js.map +1 -0
  244. package/dist/fields/PanelSkeleton.js +63 -0
  245. package/dist/fields/PanelSkeleton.js.map +1 -0
  246. package/dist/fields/componentPaths.js +8 -0
  247. package/dist/fields/componentPaths.js.map +1 -0
  248. package/dist/fields/config/FilterDimensionSelectField.d.ts +2 -2
  249. package/dist/fields/config/FilterDimensionSelectField.js +26 -54
  250. package/dist/fields/config/FilterDimensionSelectField.js.map +1 -1
  251. package/dist/fields/config/FilterKeySelect.js +66 -0
  252. package/dist/fields/config/FilterKeySelect.js.map +1 -0
  253. package/dist/fields/config/FilterOperatorSelectField.d.ts +7 -2
  254. package/dist/fields/config/FilterOperatorSelectField.js +37 -53
  255. package/dist/fields/config/FilterOperatorSelectField.js.map +1 -1
  256. package/dist/fields/config/FilterValueField.d.ts +17 -0
  257. package/dist/fields/config/FilterValueField.js +130 -0
  258. package/dist/fields/config/FilterValueField.js.map +1 -0
  259. package/dist/fields/config/MetricSelectField.d.ts +5 -12
  260. package/dist/fields/config/MetricSelectField.js +18 -30
  261. package/dist/fields/config/MetricSelectField.js.map +1 -1
  262. package/dist/fields/config/OptionSelect.js +52 -0
  263. package/dist/fields/config/OptionSelect.js.map +1 -0
  264. package/dist/fields/config/SourceSelectField.js +16 -31
  265. package/dist/fields/config/SourceSelectField.js.map +1 -1
  266. package/dist/fields/config/fetchSources.js +14 -26
  267. package/dist/fields/config/fetchSources.js.map +1 -1
  268. package/dist/fields/config/filterValues.js +106 -0
  269. package/dist/fields/config/filterValues.js.map +1 -0
  270. package/dist/fields/config/narrow.js +8 -10
  271. package/dist/fields/config/narrow.js.map +1 -1
  272. package/dist/fields/config/retiredPickers.d.ts +45 -0
  273. package/dist/fields/config/retiredPickers.js +46 -0
  274. package/dist/fields/config/retiredPickers.js.map +1 -0
  275. package/dist/fields/config/scopedFields.d.ts +40 -0
  276. package/dist/fields/config/scopedFields.js +68 -0
  277. package/dist/fields/config/scopedFields.js.map +1 -0
  278. package/dist/fields/config/toSelectOption.js +13 -7
  279. package/dist/fields/config/toSelectOption.js.map +1 -1
  280. package/dist/fields/config/useAnalyticsSources.d.ts +5 -7
  281. package/dist/fields/config/useAnalyticsSources.js +17 -21
  282. package/dist/fields/config/useAnalyticsSources.js.map +1 -1
  283. package/dist/fields/config/useFilterCapabilities.d.ts +9 -6
  284. package/dist/fields/config/useFilterCapabilities.js +23 -15
  285. package/dist/fields/config/useFilterCapabilities.js.map +1 -1
  286. package/dist/fields/config/useFormString.js +12 -0
  287. package/dist/fields/config/useFormString.js.map +1 -0
  288. package/dist/fields/dateRange/field.js +7 -19
  289. package/dist/fields/dateRange/field.js.map +1 -1
  290. package/dist/fields/dateRange/types.d.ts +5 -1
  291. package/dist/fields/dateRange/ui.d.ts +3 -2
  292. package/dist/fields/dateRange/ui.js +57 -319
  293. package/dist/fields/dateRange/ui.js.map +1 -1
  294. package/dist/fields/documentScope.js +21 -0
  295. package/dist/fields/documentScope.js.map +1 -0
  296. package/dist/fields/emptyState.js +31 -26
  297. package/dist/fields/emptyState.js.map +1 -1
  298. package/dist/fields/factories.d.ts +35 -16
  299. package/dist/fields/factories.js +66 -37
  300. package/dist/fields/factories.js.map +1 -1
  301. package/dist/fields/format.d.ts +12 -3
  302. package/dist/fields/format.js +77 -13
  303. package/dist/fields/format.js.map +1 -1
  304. package/dist/fields/itemReport.js +45 -0
  305. package/dist/fields/itemReport.js.map +1 -0
  306. package/dist/fields/readForDocument.d.ts +78 -26
  307. package/dist/fields/readForDocument.js +446 -116
  308. package/dist/fields/readForDocument.js.map +1 -1
  309. package/dist/fields/stateKeys.js +20 -0
  310. package/dist/fields/stateKeys.js.map +1 -0
  311. package/dist/goals/GoalAmountField.d.ts +10 -0
  312. package/dist/goals/GoalAmountField.js +162 -0
  313. package/dist/goals/GoalAmountField.js.map +1 -0
  314. package/dist/goals/GoalSelectField.js +89 -40
  315. package/dist/goals/GoalSelectField.js.map +1 -1
  316. package/dist/goals/GoalSelectFieldServer.d.ts +13 -0
  317. package/dist/goals/GoalSelectFieldServer.js +21 -0
  318. package/dist/goals/GoalSelectFieldServer.js.map +1 -0
  319. package/dist/goals/amountField.d.ts +20 -0
  320. package/dist/goals/amountField.js +37 -0
  321. package/dist/goals/amountField.js.map +1 -0
  322. package/dist/goals/builtin.js +17 -0
  323. package/dist/goals/builtin.js.map +1 -0
  324. package/dist/goals/collection.d.ts +22 -0
  325. package/dist/goals/collection.js +141 -100
  326. package/dist/goals/collection.js.map +1 -1
  327. package/dist/goals/constants.d.ts +38 -0
  328. package/dist/goals/constants.js +49 -0
  329. package/dist/goals/constants.js.map +1 -0
  330. package/dist/goals/currency.d.ts +16 -0
  331. package/dist/goals/currency.js +46 -4
  332. package/dist/goals/currency.js.map +1 -1
  333. package/dist/goals/currencyOptions.js +70 -0
  334. package/dist/goals/currencyOptions.js.map +1 -0
  335. package/dist/goals/fetchGoals.d.ts +10 -0
  336. package/dist/goals/fetchGoals.js +12 -26
  337. package/dist/goals/fetchGoals.js.map +1 -1
  338. package/dist/goals/goalField.d.ts +4 -6
  339. package/dist/goals/goalField.js +9 -19
  340. package/dist/goals/goalField.js.map +1 -1
  341. package/dist/goals/goalsEndpoint.js +39 -40
  342. package/dist/goals/goalsEndpoint.js.map +1 -1
  343. package/dist/goals/items.js +35 -0
  344. package/dist/goals/items.js.map +1 -0
  345. package/dist/goals/latent.js +9 -0
  346. package/dist/goals/latent.js.map +1 -0
  347. package/dist/goals/linkFields.d.ts +35 -0
  348. package/dist/goals/linkFields.js +31 -0
  349. package/dist/goals/linkFields.js.map +1 -0
  350. package/dist/goals/match.d.ts +14 -0
  351. package/dist/goals/match.js +67 -46
  352. package/dist/goals/match.js.map +1 -1
  353. package/dist/goals/moneyFields.js +56 -0
  354. package/dist/goals/moneyFields.js.map +1 -0
  355. package/dist/goals/pathMatch.js +122 -0
  356. package/dist/goals/pathMatch.js.map +1 -0
  357. package/dist/goals/placeholder.js +12 -0
  358. package/dist/goals/placeholder.js.map +1 -0
  359. package/dist/goals/resolver.d.ts +3 -3
  360. package/dist/goals/resolver.js +154 -46
  361. package/dist/goals/resolver.js.map +1 -1
  362. package/dist/goals/serverRevenue.d.ts +60 -0
  363. package/dist/goals/serverRevenue.js +41 -0
  364. package/dist/goals/serverRevenue.js.map +1 -0
  365. package/dist/goals/trackGoalAction.d.ts +26 -27
  366. package/dist/goals/trackGoalAction.js +38 -52
  367. package/dist/goals/trackGoalAction.js.map +1 -1
  368. package/dist/goals/types.d.ts +13 -28
  369. package/dist/goals/types.js +1 -1
  370. package/dist/goals/types.js.map +1 -1
  371. package/dist/goals/useAnalyticsGoals.d.ts +6 -5
  372. package/dist/goals/useAnalyticsGoals.js +17 -18
  373. package/dist/goals/useAnalyticsGoals.js.map +1 -1
  374. package/dist/index.d.ts +63 -11
  375. package/dist/index.js +257 -247
  376. package/dist/index.js.map +1 -1
  377. package/dist/items/collectionIdType.js +20 -0
  378. package/dist/items/collectionIdType.js.map +1 -0
  379. package/dist/items/idType.js +31 -0
  380. package/dist/items/idType.js.map +1 -0
  381. package/dist/items/ref.js +73 -0
  382. package/dist/items/ref.js.map +1 -0
  383. package/dist/maintenance/apiTaskState.js +141 -0
  384. package/dist/maintenance/apiTaskState.js.map +1 -0
  385. package/dist/maintenance/heartbeat.js +51 -0
  386. package/dist/maintenance/heartbeat.js.map +1 -0
  387. package/dist/maintenance/lease.d.ts +1 -0
  388. package/dist/maintenance/lease.js +81 -0
  389. package/dist/maintenance/lease.js.map +1 -0
  390. package/dist/maintenance/taskSchedule.d.ts +1 -0
  391. package/dist/maintenance/taskSchedule.js +62 -0
  392. package/dist/maintenance/taskSchedule.js.map +1 -0
  393. package/dist/maintenance/underLease.js +35 -0
  394. package/dist/maintenance/underLease.js.map +1 -0
  395. package/dist/migrations/legacy.d.ts +54 -0
  396. package/dist/migrations/legacy.js +117 -0
  397. package/dist/migrations/legacy.js.map +1 -0
  398. package/dist/migrations/predefined/dropLegacyMongo.d.ts +11 -0
  399. package/dist/migrations/predefined/dropLegacyMongo.js +12 -0
  400. package/dist/migrations/predefined/dropLegacyMongo.js.map +1 -0
  401. package/dist/native/collections/aggregates.js +54 -0
  402. package/dist/native/collections/aggregates.js.map +1 -0
  403. package/dist/native/collections/hits.js +102 -0
  404. package/dist/native/collections/hits.js.map +1 -0
  405. package/dist/native/collections/slugs.d.ts +10 -0
  406. package/dist/native/collections/slugs.js +16 -0
  407. package/dist/native/collections/slugs.js.map +1 -0
  408. package/dist/native/collections/state.js +84 -0
  409. package/dist/native/collections/state.js.map +1 -0
  410. package/dist/native/collections/storeCollection.js +29 -0
  411. package/dist/native/collections/storeCollection.js.map +1 -0
  412. package/dist/native/engine/buckets.d.ts +1 -0
  413. package/dist/native/engine/buckets.js +53 -0
  414. package/dist/native/engine/buckets.js.map +1 -0
  415. package/dist/native/engine/capabilities.js +87 -0
  416. package/dist/native/engine/capabilities.js.map +1 -0
  417. package/dist/native/engine/cost.js +72 -0
  418. package/dist/native/engine/cost.js.map +1 -0
  419. package/dist/native/engine/days.d.ts +1 -0
  420. package/dist/native/engine/days.js +182 -0
  421. package/dist/native/engine/days.js.map +1 -0
  422. package/dist/native/engine/engine.d.ts +1 -0
  423. package/dist/native/engine/engine.js +1623 -0
  424. package/dist/native/engine/engine.js.map +1 -0
  425. package/dist/native/engine/instance.js +58 -0
  426. package/dist/native/engine/instance.js.map +1 -0
  427. package/dist/native/engine/maintenance.d.ts +1 -0
  428. package/dist/native/engine/maintenance.js +677 -0
  429. package/dist/native/engine/maintenance.js.map +1 -0
  430. package/dist/native/engine/merge.js +41 -0
  431. package/dist/native/engine/merge.js.map +1 -0
  432. package/dist/native/engine/nudge.js +26 -0
  433. package/dist/native/engine/nudge.js.map +1 -0
  434. package/dist/native/engine/planner.js +198 -0
  435. package/dist/native/engine/planner.js.map +1 -0
  436. package/dist/native/engine/rebuild.d.ts +22 -0
  437. package/dist/native/engine/rebuild.js +76 -0
  438. package/dist/native/engine/rebuild.js.map +1 -0
  439. package/dist/native/engine/recent.js +17 -0
  440. package/dist/native/engine/recent.js.map +1 -0
  441. package/dist/native/engine/salt.d.ts +1 -0
  442. package/dist/native/engine/salt.js +98 -0
  443. package/dist/native/engine/salt.js.map +1 -0
  444. package/dist/native/engine/siteHosts.d.ts +1 -0
  445. package/dist/native/engine/siteHosts.js +58 -0
  446. package/dist/native/engine/siteHosts.js.map +1 -0
  447. package/dist/native/engine/toHit.js +108 -0
  448. package/dist/native/engine/toHit.js.map +1 -0
  449. package/dist/native/engine/writeBuffer.d.ts +14 -0
  450. package/dist/native/engine/writeBuffer.js +317 -0
  451. package/dist/native/engine/writeBuffer.js.map +1 -0
  452. package/dist/native/geo/composeGeoResolvers.d.ts +1 -0
  453. package/dist/native/geo/composeGeoResolvers.js +4 -1
  454. package/dist/native/geo/composeGeoResolvers.js.map +1 -1
  455. package/dist/native/geo/geoResolver.d.ts +20 -2
  456. package/dist/native/geo/geoResolver.js +42 -6
  457. package/dist/native/geo/geoResolver.js.map +1 -1
  458. package/dist/native/geo/maxmindResolver.d.ts +8 -4
  459. package/dist/native/geo/maxmindResolver.js +20 -16
  460. package/dist/native/geo/maxmindResolver.js.map +1 -1
  461. package/dist/native/geo/resolveGeo.js +31 -0
  462. package/dist/native/geo/resolveGeo.js.map +1 -0
  463. package/dist/native/ingest/bots.d.ts +2 -3
  464. package/dist/native/ingest/bots.js +8 -13
  465. package/dist/native/ingest/bots.js.map +1 -1
  466. package/dist/native/ingest/browser.js +4 -6
  467. package/dist/native/ingest/browser.js.map +1 -1
  468. package/dist/native/ingest/clientIp.js +30 -9
  469. package/dist/native/ingest/clientIp.js.map +1 -1
  470. package/dist/native/ingest/device.js +4 -6
  471. package/dist/native/ingest/device.js.map +1 -1
  472. package/dist/native/ingest/endpoint.d.ts +1 -1
  473. package/dist/native/ingest/endpoint.js +119 -34
  474. package/dist/native/ingest/endpoint.js.map +1 -1
  475. package/dist/native/ingest/itemSignature.d.ts +26 -0
  476. package/dist/native/ingest/itemSignature.js +45 -0
  477. package/dist/native/ingest/itemSignature.js.map +1 -0
  478. package/dist/native/ingest/language.js +2 -3
  479. package/dist/native/ingest/language.js.map +1 -1
  480. package/dist/native/ingest/normalizeEvent.d.ts +60 -7
  481. package/dist/native/ingest/normalizeEvent.js +226 -61
  482. package/dist/native/ingest/normalizeEvent.js.map +1 -1
  483. package/dist/native/ingest/orderSignature.d.ts +13 -0
  484. package/dist/native/ingest/orderSignature.js +50 -0
  485. package/dist/native/ingest/orderSignature.js.map +1 -0
  486. package/dist/native/ingest/referrer.js +30 -32
  487. package/dist/native/ingest/referrer.js.map +1 -1
  488. package/dist/native/ingest/requestHost.js +10 -23
  489. package/dist/native/ingest/requestHost.js.map +1 -1
  490. package/dist/native/ingest/resolveHostname.d.ts +4 -13
  491. package/dist/native/ingest/resolveHostname.js +5 -6
  492. package/dist/native/ingest/resolveHostname.js.map +1 -1
  493. package/dist/native/ingest/revenue.d.ts +1 -0
  494. package/dist/native/ingest/revenue.js +121 -0
  495. package/dist/native/ingest/revenue.js.map +1 -0
  496. package/dist/native/ingest/route.d.ts +10 -0
  497. package/dist/native/ingest/route.js +82 -0
  498. package/dist/native/ingest/route.js.map +1 -0
  499. package/dist/native/ingest/serverTrack.d.ts +2 -10
  500. package/dist/native/ingest/serverTrack.js +181 -72
  501. package/dist/native/ingest/serverTrack.js.map +1 -1
  502. package/dist/native/ingest/signature.js +28 -0
  503. package/dist/native/ingest/signature.js.map +1 -0
  504. package/dist/native/ingest/source.d.ts +2 -3
  505. package/dist/native/ingest/source.js +35 -54
  506. package/dist/native/ingest/source.js.map +1 -1
  507. package/dist/native/ingest/utm.js +9 -9
  508. package/dist/native/ingest/utm.js.map +1 -1
  509. package/dist/native/ingest/validate.js +20 -10
  510. package/dist/native/ingest/validate.js.map +1 -1
  511. package/dist/native/ingest/visitorHash.js +6 -8
  512. package/dist/native/ingest/visitorHash.js.map +1 -1
  513. package/dist/native/nativeAdapter.d.ts +101 -33
  514. package/dist/native/nativeAdapter.js +375 -317
  515. package/dist/native/nativeAdapter.js.map +1 -1
  516. package/dist/native/rebuildDays.d.ts +12 -0
  517. package/dist/native/rebuildDays.js +16 -0
  518. package/dist/native/rebuildDays.js.map +1 -0
  519. package/dist/native/store/aggregate.js +450 -0
  520. package/dist/native/store/aggregate.js.map +1 -0
  521. package/dist/native/store/caps.d.ts +18 -0
  522. package/dist/native/store/caps.js +76 -0
  523. package/dist/native/store/caps.js.map +1 -0
  524. package/dist/native/store/chunks.js +34 -0
  525. package/dist/native/store/chunks.js.map +1 -0
  526. package/dist/native/store/columnValues.js +31 -0
  527. package/dist/native/store/columnValues.js.map +1 -0
  528. package/dist/native/store/dialect.js +106 -0
  529. package/dist/native/store/dialect.js.map +1 -0
  530. package/dist/native/store/eventStore.js +44 -0
  531. package/dist/native/store/eventStore.js.map +1 -0
  532. package/dist/native/store/hitRow.js +116 -0
  533. package/dist/native/store/hitRow.js.map +1 -0
  534. package/dist/native/store/hits.js +63 -0
  535. package/dist/native/store/hits.js.map +1 -0
  536. package/dist/native/store/ids.js +105 -0
  537. package/dist/native/store/ids.js.map +1 -0
  538. package/dist/native/store/mongo/aggregatePipelines.js +430 -0
  539. package/dist/native/store/mongo/aggregatePipelines.js.map +1 -0
  540. package/dist/native/store/mongo/mongoState.js +375 -0
  541. package/dist/native/store/mongo/mongoState.js.map +1 -0
  542. package/dist/native/store/mongo/mongoStore.js +618 -0
  543. package/dist/native/store/mongo/mongoStore.js.map +1 -0
  544. package/dist/native/store/mongo/pipelines.js +695 -0
  545. package/dist/native/store/mongo/pipelines.js.map +1 -0
  546. package/dist/native/store/mongo/results.js +20 -0
  547. package/dist/native/store/mongo/results.js.map +1 -0
  548. package/dist/native/store/parts.d.ts +1 -0
  549. package/dist/native/store/parts.js +95 -0
  550. package/dist/native/store/parts.js.map +1 -0
  551. package/dist/native/store/pattern.js +213 -0
  552. package/dist/native/store/pattern.js.map +1 -0
  553. package/dist/native/store/rawRead.d.ts +23 -0
  554. package/dist/native/store/rawRead.js +384 -0
  555. package/dist/native/store/rawRead.js.map +1 -0
  556. package/dist/native/store/reclassify.js +53 -0
  557. package/dist/native/store/reclassify.js.map +1 -0
  558. package/dist/native/store/sql/aggregateSql.js +345 -0
  559. package/dist/native/store/sql/aggregateSql.js.map +1 -0
  560. package/dist/native/store/sql/columns.js +48 -0
  561. package/dist/native/store/sql/columns.js.map +1 -0
  562. package/dist/native/store/sql/compile.js +656 -0
  563. package/dist/native/store/sql/compile.js.map +1 -0
  564. package/dist/native/store/sql/drivers.js +218 -0
  565. package/dist/native/store/sql/drivers.js.map +1 -0
  566. package/dist/native/store/sql/executor.js +132 -0
  567. package/dist/native/store/sql/executor.js.map +1 -0
  568. package/dist/native/store/sql/fragment.js +104 -0
  569. package/dist/native/store/sql/fragment.js.map +1 -0
  570. package/dist/native/store/sql/maintenanceSql.js +59 -0
  571. package/dist/native/store/sql/maintenanceSql.js.map +1 -0
  572. package/dist/native/store/sql/ownConnection.js +107 -0
  573. package/dist/native/store/sql/ownConnection.js.map +1 -0
  574. package/dist/native/store/sql/poolShare.js +101 -0
  575. package/dist/native/store/sql/poolShare.js.map +1 -0
  576. package/dist/native/store/sql/sqlState.js +325 -0
  577. package/dist/native/store/sql/sqlState.js.map +1 -0
  578. package/dist/native/store/sql/sqlStore.js +355 -0
  579. package/dist/native/store/sql/sqlStore.js.map +1 -0
  580. package/dist/native/store/sql/sqliteThread.d.ts +9 -0
  581. package/dist/native/store/sql/sqliteThread.js +314 -0
  582. package/dist/native/store/sql/sqliteThread.js.map +1 -0
  583. package/dist/native/store/sql/sqliteWorker.js +327 -0
  584. package/dist/native/store/sql/sqliteWorker.js.map +1 -0
  585. package/dist/native/store/sql/sqliteWorkerSource.js +347 -0
  586. package/dist/native/store/sql/sqliteWorkerSource.js.map +1 -0
  587. package/dist/native/store/state.js +151 -0
  588. package/dist/native/store/state.js.map +1 -0
  589. package/dist/native/store/stateStore.js +29 -0
  590. package/dist/native/store/stateStore.js.map +1 -0
  591. package/dist/native/store/types.d.ts +9 -0
  592. package/dist/native/tasks/maintainTask.d.ts +19 -0
  593. package/dist/native/tasks/maintainTask.js +68 -0
  594. package/dist/native/tasks/maintainTask.js.map +1 -0
  595. package/dist/net/guardedFetch.d.ts +32 -0
  596. package/dist/net/guardedFetch.js +220 -0
  597. package/dist/net/guardedFetch.js.map +1 -0
  598. package/dist/net/origin.js +40 -0
  599. package/dist/net/origin.js.map +1 -0
  600. package/dist/net/platform.d.ts +9 -0
  601. package/dist/net/platform.js +35 -0
  602. package/dist/net/platform.js.map +1 -0
  603. package/dist/next/captureRewrites.d.ts +4 -24
  604. package/dist/next/captureRewrites.js +6 -50
  605. package/dist/next/captureRewrites.js.map +1 -1
  606. package/dist/next/captureRoute.d.ts +28 -0
  607. package/dist/next/captureRoute.js +67 -0
  608. package/dist/next/captureRoute.js.map +1 -0
  609. package/dist/next/ingestRoute.d.ts +17 -0
  610. package/dist/next/ingestRoute.js +17 -0
  611. package/dist/next/ingestRoute.js.map +1 -0
  612. package/dist/next/posthogProxyRewrites.d.ts +3 -25
  613. package/dist/next/posthogProxyRewrites.js +5 -37
  614. package/dist/next/posthogProxyRewrites.js.map +1 -1
  615. package/dist/plugin/adminDependencies.js +34 -0
  616. package/dist/plugin/adminDependencies.js.map +1 -0
  617. package/dist/plugin/apiPath.js +23 -0
  618. package/dist/plugin/apiPath.js.map +1 -0
  619. package/dist/plugin/boundDocument.js +58 -0
  620. package/dist/plugin/boundDocument.js.map +1 -0
  621. package/dist/plugin/buildPhase.js +10 -0
  622. package/dist/plugin/buildPhase.js.map +1 -0
  623. package/dist/plugin/collectionChecks.js +232 -0
  624. package/dist/plugin/collectionChecks.js.map +1 -0
  625. package/dist/plugin/collectionFields.d.ts +13 -0
  626. package/dist/plugin/collectionFields.js +22 -0
  627. package/dist/plugin/collectionFields.js.map +1 -0
  628. package/dist/plugin/createRuntime.js +336 -0
  629. package/dist/plugin/createRuntime.js.map +1 -0
  630. package/dist/plugin/destroy.js +58 -0
  631. package/dist/plugin/destroy.js.map +1 -0
  632. package/dist/plugin/documentEndpoint.js +76 -53
  633. package/dist/plugin/documentEndpoint.js.map +1 -1
  634. package/dist/plugin/documentScopes.js +37 -0
  635. package/dist/plugin/documentScopes.js.map +1 -0
  636. package/dist/plugin/encrypted.js +25 -0
  637. package/dist/plugin/encrypted.js.map +1 -0
  638. package/dist/plugin/errors.d.ts +5 -12
  639. package/dist/plugin/errors.js +23 -16
  640. package/dist/plugin/errors.js.map +1 -1
  641. package/dist/plugin/flagsEndpoint.js +41 -0
  642. package/dist/plugin/flagsEndpoint.js.map +1 -0
  643. package/dist/plugin/goalHint.js +22 -11
  644. package/dist/plugin/goalHint.js.map +1 -1
  645. package/dist/plugin/itemLabels.js +114 -0
  646. package/dist/plugin/itemLabels.js.map +1 -0
  647. package/dist/plugin/jobsAccess.js +91 -0
  648. package/dist/plugin/jobsAccess.js.map +1 -0
  649. package/dist/plugin/keepAlive.js +48 -0
  650. package/dist/plugin/keepAlive.js.map +1 -0
  651. package/dist/plugin/peerImportError.js +3 -6
  652. package/dist/plugin/peerImportError.js.map +1 -1
  653. package/dist/plugin/peers.js +64 -0
  654. package/dist/plugin/peers.js.map +1 -0
  655. package/dist/plugin/pluginCollections.js +155 -0
  656. package/dist/plugin/pluginCollections.js.map +1 -0
  657. package/dist/plugin/queryEndpoint.js +69 -44
  658. package/dist/plugin/queryEndpoint.js.map +1 -1
  659. package/dist/plugin/queryParams.js +7 -0
  660. package/dist/plugin/queryParams.js.map +1 -0
  661. package/dist/plugin/readContextForRequest.js +52 -17
  662. package/dist/plugin/readContextForRequest.js.map +1 -1
  663. package/dist/plugin/readFailure.js +22 -0
  664. package/dist/plugin/readFailure.js.map +1 -0
  665. package/dist/plugin/readableProviders.js +64 -0
  666. package/dist/plugin/readableProviders.js.map +1 -0
  667. package/dist/plugin/realtimeEndpoint.js +77 -25
  668. package/dist/plugin/realtimeEndpoint.js.map +1 -1
  669. package/dist/plugin/refreshEndpoint.js +69 -44
  670. package/dist/plugin/refreshEndpoint.js.map +1 -1
  671. package/dist/plugin/relabelFields.js +36 -0
  672. package/dist/plugin/relabelFields.js.map +1 -0
  673. package/dist/plugin/requestMemo.js +35 -0
  674. package/dist/plugin/requestMemo.js.map +1 -0
  675. package/dist/plugin/routeChecks.js +39 -0
  676. package/dist/plugin/routeChecks.js.map +1 -0
  677. package/dist/plugin/routes.d.ts +53 -0
  678. package/dist/plugin/routes.js +92 -0
  679. package/dist/plugin/routes.js.map +1 -0
  680. package/dist/plugin/runtime.d.ts +1 -1
  681. package/dist/plugin/runtime.js +226 -30
  682. package/dist/plugin/runtime.js.map +1 -1
  683. package/dist/plugin/schemaOnly.js +63 -0
  684. package/dist/plugin/schemaOnly.js.map +1 -0
  685. package/dist/plugin/scopeChange.js +6 -5
  686. package/dist/plugin/scopeChange.js.map +1 -1
  687. package/dist/plugin/scopeFieldBoot.js +4 -4
  688. package/dist/plugin/scopeFieldBoot.js.map +1 -1
  689. package/dist/plugin/scopeToken.js +33 -0
  690. package/dist/plugin/scopeToken.js.map +1 -0
  691. package/dist/plugin/sourcesEndpoint.js +46 -12
  692. package/dist/plugin/sourcesEndpoint.js.map +1 -1
  693. package/dist/plugin/unbundledLanguages.js +25 -0
  694. package/dist/plugin/unbundledLanguages.js.map +1 -0
  695. package/dist/plugin/walkFields.js +22 -0
  696. package/dist/plugin/walkFields.js.map +1 -0
  697. package/dist/plugin/warmTask.js +0 -0
  698. package/dist/plugin/warmTask.js.map +1 -1
  699. package/dist/providers/access.d.ts +1 -0
  700. package/dist/providers/access.js +35 -26
  701. package/dist/providers/access.js.map +1 -1
  702. package/dist/providers/adapterPool.js +121 -0
  703. package/dist/providers/adapterPool.js.map +1 -0
  704. package/dist/providers/collection.d.ts +53 -0
  705. package/dist/providers/collection.js +274 -150
  706. package/dist/providers/collection.js.map +1 -1
  707. package/dist/providers/factory.d.ts +76 -0
  708. package/dist/providers/factory.js +76 -23
  709. package/dist/providers/factory.js.map +1 -1
  710. package/dist/providers/hosts.d.ts +25 -0
  711. package/dist/providers/hosts.js +128 -0
  712. package/dist/providers/hosts.js.map +1 -0
  713. package/dist/providers/probe.d.ts +1 -0
  714. package/dist/providers/probe.js +101 -0
  715. package/dist/providers/probe.js.map +1 -0
  716. package/dist/providers/refresh.d.ts +18 -0
  717. package/dist/providers/refresh.js +49 -0
  718. package/dist/providers/refresh.js.map +1 -0
  719. package/dist/providers/registry.js +318 -0
  720. package/dist/providers/registry.js.map +1 -0
  721. package/dist/providers/resolver.js +23 -88
  722. package/dist/providers/resolver.js.map +1 -1
  723. package/dist/providers/retarget.js +45 -0
  724. package/dist/providers/retarget.js.map +1 -0
  725. package/dist/providers/secrets.d.ts +26 -0
  726. package/dist/providers/secrets.js +61 -4
  727. package/dist/providers/secrets.js.map +1 -1
  728. package/dist/providers/stampScope.js +9 -6
  729. package/dist/providers/stampScope.js.map +1 -1
  730. package/dist/query/dates.js +10 -12
  731. package/dist/query/dates.js.map +1 -1
  732. package/dist/query/errors.d.ts +1 -5
  733. package/dist/query/fetchQuery.d.ts +25 -32
  734. package/dist/query/fetchQuery.js +91 -91
  735. package/dist/query/fetchQuery.js.map +1 -1
  736. package/dist/query/limits.js +8 -0
  737. package/dist/query/limits.js.map +1 -0
  738. package/dist/query/parse.d.ts +6 -0
  739. package/dist/query/parse.js +153 -106
  740. package/dist/query/parse.js.map +1 -1
  741. package/dist/query/response.d.ts +23 -3
  742. package/dist/query/response.js +12 -5
  743. package/dist/query/response.js.map +1 -1
  744. package/dist/react/AnalyticsProvider.d.ts +26 -17
  745. package/dist/react/AnalyticsProvider.js +23 -22
  746. package/dist/react/AnalyticsProvider.js.map +1 -1
  747. package/dist/react/TrackerBoot.js +15 -9
  748. package/dist/react/TrackerBoot.js.map +1 -1
  749. package/dist/react/useAnalytics.d.ts +2 -11
  750. package/dist/react/useAnalytics.js +22 -24
  751. package/dist/react/useAnalytics.js.map +1 -1
  752. package/dist/site/AnalyticsScripts.d.ts +34 -0
  753. package/dist/site/AnalyticsScripts.js +30 -0
  754. package/dist/site/AnalyticsScripts.js.map +1 -0
  755. package/dist/site/getTrackerConfig.d.ts +15 -0
  756. package/dist/site/getTrackerConfig.js +40 -0
  757. package/dist/site/getTrackerConfig.js.map +1 -0
  758. package/dist/surfacing/afterRead.d.ts +37 -0
  759. package/dist/surfacing/bounded.js +38 -0
  760. package/dist/surfacing/bounded.js.map +1 -0
  761. package/dist/surfacing/breaker.js +107 -0
  762. package/dist/surfacing/breaker.js.map +1 -0
  763. package/dist/surfacing/cacheCollection.d.ts +8 -0
  764. package/dist/surfacing/cacheCollection.js +69 -0
  765. package/dist/surfacing/cacheCollection.js.map +1 -0
  766. package/dist/surfacing/cacheStore.d.ts +71 -1
  767. package/dist/surfacing/cacheStore.js +16 -37
  768. package/dist/surfacing/cacheStore.js.map +1 -1
  769. package/dist/surfacing/cacheSweep.d.ts +1 -0
  770. package/dist/surfacing/cacheSweep.js +59 -0
  771. package/dist/surfacing/cacheSweep.js.map +1 -0
  772. package/dist/surfacing/classifyError.js +282 -0
  773. package/dist/surfacing/classifyError.js.map +1 -0
  774. package/dist/surfacing/coalesce.js +2 -1
  775. package/dist/surfacing/coalesce.js.map +1 -1
  776. package/dist/surfacing/coldBudget.js +60 -0
  777. package/dist/surfacing/coldBudget.js.map +1 -0
  778. package/dist/surfacing/collectionCacheStore.js +183 -0
  779. package/dist/surfacing/collectionCacheStore.js.map +1 -0
  780. package/dist/surfacing/engine.d.ts +1 -1
  781. package/dist/surfacing/engine.js +514 -72
  782. package/dist/surfacing/engine.js.map +1 -1
  783. package/dist/surfacing/epoch.js +70 -26
  784. package/dist/surfacing/epoch.js.map +1 -1
  785. package/dist/surfacing/lanes.d.ts +1 -0
  786. package/dist/surfacing/lanes.js +297 -0
  787. package/dist/surfacing/lanes.js.map +1 -0
  788. package/dist/surfacing/memo.js +40 -0
  789. package/dist/surfacing/memo.js.map +1 -0
  790. package/dist/surfacing/rateLimiter.d.ts +1 -0
  791. package/dist/surfacing/rateLimiter.js +69 -94
  792. package/dist/surfacing/rateLimiter.js.map +1 -1
  793. package/dist/surfacing/rebucket.js +178 -0
  794. package/dist/surfacing/rebucket.js.map +1 -0
  795. package/dist/surfacing/recipe.js +28 -0
  796. package/dist/surfacing/recipe.js.map +1 -0
  797. package/dist/surfacing/shape.js +22 -0
  798. package/dist/surfacing/shape.js.map +1 -0
  799. package/dist/surfacing/todaySplit.js +113 -0
  800. package/dist/surfacing/todaySplit.js.map +1 -0
  801. package/dist/sync/collection.d.ts +8 -0
  802. package/dist/sync/collection.js +28 -18
  803. package/dist/sync/collection.js.map +1 -1
  804. package/dist/sync/rekeyDurations.js +70 -0
  805. package/dist/sync/rekeyDurations.js.map +1 -0
  806. package/dist/sync/syncTask.js +226 -109
  807. package/dist/sync/syncTask.js.map +1 -1
  808. package/dist/testing/memoryAdapter.d.ts +6 -3
  809. package/dist/testing/memoryAdapter.js +12 -10
  810. package/dist/testing/memoryAdapter.js.map +1 -1
  811. package/dist/testing/settle.d.ts +11 -0
  812. package/dist/testing/settle.js +19 -0
  813. package/dist/testing/settle.js.map +1 -0
  814. package/dist/timeframe/calendar.js +65 -0
  815. package/dist/timeframe/calendar.js.map +1 -0
  816. package/dist/timeframe/comparison.js +46 -0
  817. package/dist/timeframe/comparison.js.map +1 -0
  818. package/dist/timeframe/presets.d.ts +1 -1
  819. package/dist/timeframe/presets.js +5 -5
  820. package/dist/timeframe/presets.js.map +1 -1
  821. package/dist/timeframe/reportingTimezone.d.ts +1 -0
  822. package/dist/timeframe/reportingTimezone.js +64 -0
  823. package/dist/timeframe/reportingTimezone.js.map +1 -0
  824. package/dist/timeframe/tz.js +55 -39
  825. package/dist/timeframe/tz.js.map +1 -1
  826. package/dist/tracker/autoCapture.js +125 -38
  827. package/dist/tracker/autoCapture.js.map +1 -1
  828. package/dist/tracker/campaign.js +52 -0
  829. package/dist/tracker/campaign.js.map +1 -0
  830. package/dist/tracker/config.d.ts +144 -0
  831. package/dist/tracker/config.js +25 -0
  832. package/dist/tracker/config.js.map +1 -0
  833. package/dist/tracker/createTracker.d.ts +4 -10
  834. package/dist/tracker/createTracker.js +386 -115
  835. package/dist/tracker/createTracker.js.map +1 -1
  836. package/dist/tracker/digest.js +28 -0
  837. package/dist/tracker/digest.js.map +1 -0
  838. package/dist/tracker/engagement.js +100 -0
  839. package/dist/tracker/engagement.js.map +1 -0
  840. package/dist/tracker/events.js +37 -0
  841. package/dist/tracker/events.js.map +1 -0
  842. package/dist/tracker/exclusion.d.ts +2 -22
  843. package/dist/tracker/exclusion.js +53 -21
  844. package/dist/tracker/exclusion.js.map +1 -1
  845. package/dist/tracker/gate.js +194 -0
  846. package/dist/tracker/gate.js.map +1 -0
  847. package/dist/tracker/initTracker.d.ts +5 -8
  848. package/dist/tracker/initTracker.js +42 -14
  849. package/dist/tracker/initTracker.js.map +1 -1
  850. package/dist/tracker/itemCapture.js +224 -0
  851. package/dist/tracker/itemCapture.js.map +1 -0
  852. package/dist/tracker/loadScript.js +21 -14
  853. package/dist/tracker/loadScript.js.map +1 -1
  854. package/dist/tracker/pageTracking.js +6 -6
  855. package/dist/tracker/pageTracking.js.map +1 -1
  856. package/dist/tracker/registry.js +118 -30
  857. package/dist/tracker/registry.js.map +1 -1
  858. package/dist/tracker/sinks/createSink.js +38 -0
  859. package/dist/tracker/sinks/createSink.js.map +1 -0
  860. package/dist/tracker/sinks/ga4.js +64 -20
  861. package/dist/tracker/sinks/ga4.js.map +1 -1
  862. package/dist/tracker/sinks/native.js +7 -42
  863. package/dist/tracker/sinks/native.js.map +1 -1
  864. package/dist/tracker/sinks/plausible.js +27 -22
  865. package/dist/tracker/sinks/plausible.js.map +1 -1
  866. package/dist/tracker/sinks/posthog.js +26 -22
  867. package/dist/tracker/sinks/posthog.js.map +1 -1
  868. package/dist/tracker/sinks/umami.js +14 -12
  869. package/dist/tracker/sinks/umami.js.map +1 -1
  870. package/dist/tracker/sinks/vendor.js +30 -27
  871. package/dist/tracker/sinks/vendor.js.map +1 -1
  872. package/dist/tracker/skip.js +81 -0
  873. package/dist/tracker/skip.js.map +1 -0
  874. package/dist/tracker/storage.js +23 -0
  875. package/dist/tracker/storage.js.map +1 -0
  876. package/dist/tracker/transport.js +2 -5
  877. package/dist/tracker/transport.js.map +1 -1
  878. package/dist/tracker/types.d.ts +86 -63
  879. package/dist/tracker/window.js +7 -0
  880. package/dist/tracker/window.js.map +1 -0
  881. package/dist/translations/ar.js +226 -71
  882. package/dist/translations/ar.js.map +1 -1
  883. package/dist/translations/de.js +215 -69
  884. package/dist/translations/de.js.map +1 -1
  885. package/dist/translations/en.js +209 -67
  886. package/dist/translations/en.js.map +1 -1
  887. package/dist/translations/es.js +217 -68
  888. package/dist/translations/es.js.map +1 -1
  889. package/dist/translations/fr.js +221 -72
  890. package/dist/translations/fr.js.map +1 -1
  891. package/dist/translations/id.js +212 -67
  892. package/dist/translations/id.js.map +1 -1
  893. package/dist/translations/index.d.ts +1 -1
  894. package/dist/translations/index.js +5 -7
  895. package/dist/translations/index.js.map +1 -1
  896. package/dist/translations/intl.js +71 -0
  897. package/dist/translations/intl.js.map +1 -0
  898. package/dist/translations/keys.d.ts +185 -14
  899. package/dist/translations/keys.js +190 -14
  900. package/dist/translations/keys.js.map +1 -1
  901. package/dist/translations/ko.js +214 -69
  902. package/dist/translations/ko.js.map +1 -1
  903. package/dist/translations/labelMap.d.ts +10 -0
  904. package/dist/translations/labelMap.js +22 -0
  905. package/dist/translations/labelMap.js.map +1 -0
  906. package/dist/translations/metricKeys.js +10 -2
  907. package/dist/translations/metricKeys.js.map +1 -1
  908. package/dist/translations/parts.js +20 -0
  909. package/dist/translations/parts.js.map +1 -0
  910. package/dist/translations/plural.js +61 -0
  911. package/dist/translations/plural.js.map +1 -0
  912. package/dist/translations/pt.js +226 -77
  913. package/dist/translations/pt.js.map +1 -1
  914. package/dist/translations/ru.js +217 -66
  915. package/dist/translations/ru.js.map +1 -1
  916. package/dist/translations/server.d.ts +1 -0
  917. package/dist/translations/server.js +2 -3
  918. package/dist/translations/server.js.map +1 -1
  919. package/dist/translations/staticLabel.js +69 -0
  920. package/dist/translations/staticLabel.js.map +1 -0
  921. package/dist/translations/uk.js +217 -66
  922. package/dist/translations/uk.js.map +1 -1
  923. package/dist/translations/zh.js +212 -67
  924. package/dist/translations/zh.js.map +1 -1
  925. package/dist/ui/RangePicker.js +112 -0
  926. package/dist/ui/RangePicker.js.map +1 -0
  927. package/dist/ui/analytics.css +1528 -0
  928. package/dist/ui/calendarDays.js +27 -0
  929. package/dist/ui/calendarDays.js.map +1 -0
  930. package/dist/ui/classNames.js +7 -0
  931. package/dist/ui/classNames.js.map +1 -0
  932. package/dist/ui/components/Card.d.ts +28 -0
  933. package/dist/ui/components/Card.js +21 -0
  934. package/dist/ui/components/Card.js.map +1 -0
  935. package/dist/ui/components/ChartDataTable.d.ts +41 -0
  936. package/dist/ui/components/ChartDataTable.js +48 -0
  937. package/dist/ui/components/ChartDataTable.js.map +1 -0
  938. package/dist/ui/components/DataTable.d.ts +82 -0
  939. package/dist/ui/components/DataTable.js +214 -0
  940. package/dist/ui/components/DataTable.js.map +1 -0
  941. package/dist/ui/components/LabeledSelect.js +62 -0
  942. package/dist/ui/components/LabeledSelect.js.map +1 -0
  943. package/dist/ui/components/LiveAnnouncement.js +21 -0
  944. package/dist/ui/components/LiveAnnouncement.js.map +1 -0
  945. package/dist/ui/components/MetricCard.d.ts +38 -0
  946. package/dist/ui/components/MetricCard.js +39 -0
  947. package/dist/ui/components/MetricCard.js.map +1 -0
  948. package/dist/ui/components/NoValue.js +22 -0
  949. package/dist/ui/components/NoValue.js.map +1 -0
  950. package/dist/ui/components/ReadState.js +27 -0
  951. package/dist/ui/components/ReadState.js.map +1 -0
  952. package/dist/ui/components/RefreshButton.js +26 -0
  953. package/dist/ui/components/RefreshButton.js.map +1 -0
  954. package/dist/ui/cssVars.js +7 -0
  955. package/dist/ui/cssVars.js.map +1 -0
  956. package/dist/ui/data/WithScopeToken.d.ts +20 -0
  957. package/dist/ui/data/WithScopeToken.js +20 -0
  958. package/dist/ui/data/WithScopeToken.js.map +1 -0
  959. package/dist/ui/data/clientFieldProps.js +16 -0
  960. package/dist/ui/data/clientFieldProps.js.map +1 -0
  961. package/dist/ui/data/request.d.ts +46 -0
  962. package/dist/ui/data/request.js +119 -0
  963. package/dist/ui/data/request.js.map +1 -0
  964. package/dist/ui/data/scopeTokenContext.js +18 -0
  965. package/dist/ui/data/scopeTokenContext.js.map +1 -0
  966. package/dist/ui/data/sharedCache.js +48 -0
  967. package/dist/ui/data/sharedCache.js.map +1 -0
  968. package/dist/ui/data/useRequest.d.ts +19 -0
  969. package/dist/ui/data/useRequest.js +123 -0
  970. package/dist/ui/data/useRequest.js.map +1 -0
  971. package/dist/ui/data/useRequestScope.js +25 -0
  972. package/dist/ui/data/useRequestScope.js.map +1 -0
  973. package/dist/ui/hooks/useDirection.js +47 -0
  974. package/dist/ui/hooks/useDirection.js.map +1 -0
  975. package/dist/ui/hooks/useDismissOnEscape.js +25 -0
  976. package/dist/ui/hooks/useDismissOnEscape.js.map +1 -0
  977. package/dist/ui/hooks/useLiveAnnouncement.js +57 -0
  978. package/dist/ui/hooks/useLiveAnnouncement.js.map +1 -0
  979. package/dist/ui/hooks/useRealtimePoll.js +112 -0
  980. package/dist/ui/hooks/useRealtimePoll.js.map +1 -0
  981. package/dist/ui/readState.js +19 -0
  982. package/dist/ui/readState.js.map +1 -0
  983. package/dist/ui/rows/toDisplayRows.js +49 -0
  984. package/dist/ui/rows/toDisplayRows.js.map +1 -0
  985. package/dist/ui/viewerClock.js +7 -0
  986. package/dist/ui/viewerClock.js.map +1 -0
  987. package/dist/view/AnalyticsNavLink.d.ts +5 -3
  988. package/dist/view/AnalyticsNavLink.js +11 -6
  989. package/dist/view/AnalyticsNavLink.js.map +1 -1
  990. package/dist/view/AnalyticsView.d.ts +8 -10
  991. package/dist/view/AnalyticsView.js +47 -18
  992. package/dist/view/AnalyticsView.js.map +1 -1
  993. package/dist/view/AnalyticsViewClient.d.ts +4 -7
  994. package/dist/view/AnalyticsViewClient.js +15 -229
  995. package/dist/view/AnalyticsViewClient.js.map +1 -1
  996. package/dist/view/CountryFlag.d.ts +27 -0
  997. package/dist/view/CountryFlag.js +44 -0
  998. package/dist/view/CountryFlag.js.map +1 -0
  999. package/dist/view/DocumentTitle.js +27 -0
  1000. package/dist/view/DocumentTitle.js.map +1 -0
  1001. package/dist/view/ViewRoot.d.ts +21 -0
  1002. package/dist/view/ViewRoot.js +150 -0
  1003. package/dist/view/ViewRoot.js.map +1 -0
  1004. package/dist/view/ViewSections.d.ts +38 -0
  1005. package/dist/view/ViewSections.js +190 -0
  1006. package/dist/view/ViewSections.js.map +1 -0
  1007. package/dist/view/authRedirect.js +2 -4
  1008. package/dist/view/authRedirect.js.map +1 -1
  1009. package/dist/view/conversionRate.js +9 -7
  1010. package/dist/view/conversionRate.js.map +1 -1
  1011. package/dist/view/dayRange.js +6 -10
  1012. package/dist/view/dayRange.js.map +1 -1
  1013. package/dist/view/exclusionLink.d.ts +27 -0
  1014. package/dist/view/exclusionLink.js +46 -0
  1015. package/dist/view/exclusionLink.js.map +1 -0
  1016. package/dist/view/flagSrc.js +14 -0
  1017. package/dist/view/flagSrc.js.map +1 -0
  1018. package/dist/view/gating.d.ts +15 -1
  1019. package/dist/view/gating.js +66 -31
  1020. package/dist/view/gating.js.map +1 -1
  1021. package/dist/view/hostCountryFlag.js +41 -0
  1022. package/dist/view/hostCountryFlag.js.map +1 -0
  1023. package/dist/view/labels.js +95 -10
  1024. package/dist/view/labels.js.map +1 -1
  1025. package/dist/view/metricAliases.js +10 -0
  1026. package/dist/view/metricAliases.js.map +1 -0
  1027. package/dist/view/navLabel.js +15 -0
  1028. package/dist/view/navLabel.js.map +1 -0
  1029. package/dist/view/registerView.js +10 -9
  1030. package/dist/view/registerView.js.map +1 -1
  1031. package/dist/view/scopeLabel.js +21 -0
  1032. package/dist/view/scopeLabel.js.map +1 -0
  1033. package/dist/view/sections/Breakdowns.js +196 -134
  1034. package/dist/view/sections/Breakdowns.js.map +1 -1
  1035. package/dist/view/sections/EmptyStates.js +118 -30
  1036. package/dist/view/sections/EmptyStates.js.map +1 -1
  1037. package/dist/view/sections/ExcludeBrowser.js +188 -0
  1038. package/dist/view/sections/ExcludeBrowser.js.map +1 -0
  1039. package/dist/view/sections/FilterChips.js +124 -27
  1040. package/dist/view/sections/FilterChips.js.map +1 -1
  1041. package/dist/view/sections/GoalsPanel.js +68 -60
  1042. package/dist/view/sections/GoalsPanel.js.map +1 -1
  1043. package/dist/view/sections/OverviewCards.js +29 -33
  1044. package/dist/view/sections/OverviewCards.js.map +1 -1
  1045. package/dist/view/sections/RealtimeStrip.js +70 -59
  1046. package/dist/view/sections/RealtimeStrip.js.map +1 -1
  1047. package/dist/view/sections/SectionBoundary.js +34 -0
  1048. package/dist/view/sections/SectionBoundary.js.map +1 -0
  1049. package/dist/view/sections/Toolbar.d.ts +11 -0
  1050. package/dist/view/sections/Toolbar.js +123 -82
  1051. package/dist/view/sections/Toolbar.js.map +1 -1
  1052. package/dist/view/sections/Trend.js +176 -76
  1053. package/dist/view/sections/Trend.js.map +1 -1
  1054. package/dist/view/state.d.ts +42 -0
  1055. package/dist/view/state.js +93 -54
  1056. package/dist/view/state.js.map +1 -1
  1057. package/dist/view/useViewClock.js +31 -0
  1058. package/dist/view/useViewClock.js.map +1 -0
  1059. package/dist/view/useViewQueries.d.ts +21 -0
  1060. package/dist/view/useViewQueries.js +45 -77
  1061. package/dist/view/useViewQueries.js.map +1 -1
  1062. package/dist/view/useViewState.js +42 -0
  1063. package/dist/view/useViewState.js.map +1 -0
  1064. package/dist/view/useViewUrl.js +47 -0
  1065. package/dist/view/useViewUrl.js.map +1 -0
  1066. package/dist/view/viewBody.js +30 -0
  1067. package/dist/view/viewBody.js.map +1 -0
  1068. package/dist/view/viewContext.d.ts +81 -0
  1069. package/dist/view/viewContext.js +49 -0
  1070. package/dist/view/viewContext.js.map +1 -0
  1071. package/dist/view/viewProps.d.ts +64 -7
  1072. package/dist/view/viewProps.js +121 -35
  1073. package/dist/view/viewProps.js.map +1 -1
  1074. package/dist/widgets/AnalyticsBreakdownWidget.d.ts +7 -3
  1075. package/dist/widgets/AnalyticsBreakdownWidget.js +143 -118
  1076. package/dist/widgets/AnalyticsBreakdownWidget.js.map +1 -1
  1077. package/dist/widgets/AnalyticsGoalsWidget.d.ts +6 -7
  1078. package/dist/widgets/AnalyticsGoalsWidget.js +124 -167
  1079. package/dist/widgets/AnalyticsGoalsWidget.js.map +1 -1
  1080. package/dist/widgets/AnalyticsMetricWidget.d.ts +7 -3
  1081. package/dist/widgets/AnalyticsMetricWidget.js +80 -106
  1082. package/dist/widgets/AnalyticsMetricWidget.js.map +1 -1
  1083. package/dist/widgets/AnalyticsRealtimeWidget.d.ts +7 -3
  1084. package/dist/widgets/AnalyticsRealtimeWidget.js +74 -64
  1085. package/dist/widgets/AnalyticsRealtimeWidget.js.map +1 -1
  1086. package/dist/widgets/AnalyticsTrendWidget.d.ts +7 -3
  1087. package/dist/widgets/AnalyticsTrendWidget.js +129 -123
  1088. package/dist/widgets/AnalyticsTrendWidget.js.map +1 -1
  1089. package/dist/widgets/ComparisonDelta.js +33 -42
  1090. package/dist/widgets/ComparisonDelta.js.map +1 -1
  1091. package/dist/widgets/RealtimeCounter.d.ts +24 -4
  1092. package/dist/widgets/RealtimeCounter.js +91 -77
  1093. package/dist/widgets/RealtimeCounter.js.map +1 -1
  1094. package/dist/widgets/WidgetCard.d.ts +80 -0
  1095. package/dist/widgets/WidgetCard.js +99 -0
  1096. package/dist/widgets/WidgetCard.js.map +1 -0
  1097. package/dist/widgets/WidgetFrame.js +42 -0
  1098. package/dist/widgets/WidgetFrame.js.map +1 -0
  1099. package/dist/widgets/WidgetShimmer.d.ts +55 -0
  1100. package/dist/widgets/WidgetShimmer.js +86 -0
  1101. package/dist/widgets/WidgetShimmer.js.map +1 -0
  1102. package/dist/widgets/breakdownTypes.js +12 -2
  1103. package/dist/widgets/breakdownTypes.js.map +1 -1
  1104. package/dist/widgets/customWidget.d.ts +5 -1
  1105. package/dist/widgets/customWidget.js +6 -7
  1106. package/dist/widgets/customWidget.js.map +1 -1
  1107. package/dist/widgets/defaults.d.ts +4 -7
  1108. package/dist/widgets/defaults.js +4 -7
  1109. package/dist/widgets/defaults.js.map +1 -1
  1110. package/dist/widgets/fieldRows.js +14 -0
  1111. package/dist/widgets/fieldRows.js.map +1 -0
  1112. package/dist/widgets/filterCaption.js +6 -7
  1113. package/dist/widgets/filterCaption.js.map +1 -1
  1114. package/dist/widgets/filterField.d.ts +3 -7
  1115. package/dist/widgets/filterField.js +46 -35
  1116. package/dist/widgets/filterField.js.map +1 -1
  1117. package/dist/widgets/filterValueLabel.d.ts +1 -0
  1118. package/dist/widgets/filterValueLabel.js +45 -0
  1119. package/dist/widgets/filterValueLabel.js.map +1 -0
  1120. package/dist/widgets/notices.js +73 -0
  1121. package/dist/widgets/notices.js.map +1 -0
  1122. package/dist/widgets/prepareWidgetRead.d.ts +5 -1
  1123. package/dist/widgets/prepareWidgetRead.js +59 -27
  1124. package/dist/widgets/prepareWidgetRead.js.map +1 -1
  1125. package/dist/widgets/range.js +26 -21
  1126. package/dist/widgets/range.js.map +1 -1
  1127. package/dist/widgets/readForWidget.d.ts +27 -18
  1128. package/dist/widgets/readForWidget.js +31 -29
  1129. package/dist/widgets/readForWidget.js.map +1 -1
  1130. package/dist/widgets/readForWidgetBreakdown.d.ts +39 -28
  1131. package/dist/widgets/readForWidgetBreakdown.js +46 -22
  1132. package/dist/widgets/readForWidgetBreakdown.js.map +1 -1
  1133. package/dist/widgets/readForWidgetGoals.d.ts +17 -23
  1134. package/dist/widgets/readForWidgetGoals.js +50 -46
  1135. package/dist/widgets/readForWidgetGoals.js.map +1 -1
  1136. package/dist/widgets/readForWidgetRealtime.d.ts +21 -17
  1137. package/dist/widgets/readForWidgetRealtime.js +51 -27
  1138. package/dist/widgets/readForWidgetRealtime.js.map +1 -1
  1139. package/dist/widgets/readForWidgetSeries.d.ts +26 -31
  1140. package/dist/widgets/readForWidgetSeries.js +43 -82
  1141. package/dist/widgets/readForWidgetSeries.js.map +1 -1
  1142. package/dist/widgets/readMeta.d.ts +44 -0
  1143. package/dist/widgets/readMeta.js +47 -4
  1144. package/dist/widgets/readMeta.js.map +1 -1
  1145. package/dist/widgets/realtimePoll.d.ts +1 -0
  1146. package/dist/widgets/realtimePoll.js +53 -25
  1147. package/dist/widgets/realtimePoll.js.map +1 -1
  1148. package/dist/widgets/registerWidgets.js +204 -126
  1149. package/dist/widgets/registerWidgets.js.map +1 -1
  1150. package/dist/widgets/stateKeys.js +30 -0
  1151. package/dist/widgets/stateKeys.js.map +1 -0
  1152. package/dist/widgets/titleForecast.js +89 -0
  1153. package/dist/widgets/titleForecast.js.map +1 -0
  1154. package/dist/widgets/types.d.ts +4 -3
  1155. package/dist/widgets/types.js +2 -0
  1156. package/dist/widgets/types.js.map +1 -1
  1157. package/dist/widgets/viewLink.d.ts +24 -6
  1158. package/dist/widgets/viewLink.js +31 -24
  1159. package/dist/widgets/viewLink.js.map +1 -1
  1160. package/dist/widgets/widgetData.js +34 -0
  1161. package/dist/widgets/widgetData.js.map +1 -0
  1162. package/dist/widgets/widgetWindow.d.ts +1 -0
  1163. package/dist/widgets/widgetWindow.js +51 -0
  1164. package/dist/widgets/widgetWindow.js.map +1 -0
  1165. package/package.json +44 -22
  1166. package/dist/adapters/ga4/disableKey.d.ts +0 -9
  1167. package/dist/capture/getTrackerConfig.d.ts +0 -20
  1168. package/dist/capture/getTrackerConfig.js +0 -31
  1169. package/dist/capture/getTrackerConfig.js.map +0 -1
  1170. package/dist/capture/slots.d.ts +0 -8
  1171. package/dist/capture/trackerConfig.d.ts +0 -33
  1172. package/dist/charts/styles.js +0 -59
  1173. package/dist/charts/styles.js.map +0 -1
  1174. package/dist/fields/config/SourceSelectField.d.ts +0 -14
  1175. package/dist/fields/dateRange/styles.js +0 -23
  1176. package/dist/fields/dateRange/styles.js.map +0 -1
  1177. package/dist/goals/GoalSelectField.d.ts +0 -7
  1178. package/dist/native/collections/events.js +0 -165
  1179. package/dist/native/collections/events.js.map +0 -1
  1180. package/dist/native/collections/rollups.js +0 -151
  1181. package/dist/native/collections/rollups.js.map +0 -1
  1182. package/dist/native/collections/seen.js +0 -47
  1183. package/dist/native/collections/seen.js.map +0 -1
  1184. package/dist/native/eventScan.js +0 -25
  1185. package/dist/native/eventScan.js.map +0 -1
  1186. package/dist/native/ingest/flushBatch.js +0 -60
  1187. package/dist/native/ingest/flushBatch.js.map +0 -1
  1188. package/dist/native/ingest/salt.js +0 -39
  1189. package/dist/native/ingest/salt.js.map +0 -1
  1190. package/dist/native/ingest/writeBuffer.js +0 -55
  1191. package/dist/native/ingest/writeBuffer.js.map +0 -1
  1192. package/dist/native/ingest/writeEvent.js +0 -14
  1193. package/dist/native/ingest/writeEvent.js.map +0 -1
  1194. package/dist/native/query/eventAgg.js +0 -175
  1195. package/dist/native/query/eventAgg.js.map +0 -1
  1196. package/dist/native/realtime/buildRealtime.js +0 -53
  1197. package/dist/native/realtime/buildRealtime.js.map +0 -1
  1198. package/dist/native/retention/pruneTask.js +0 -69
  1199. package/dist/native/retention/pruneTask.js.map +0 -1
  1200. package/dist/native/rollupAcc.js +0 -64
  1201. package/dist/native/rollupAcc.js.map +0 -1
  1202. package/dist/native/rollups/bucketKey.js +0 -15
  1203. package/dist/native/rollups/bucketKey.js.map +0 -1
  1204. package/dist/native/rollups/bumpRollups.js +0 -116
  1205. package/dist/native/rollups/bumpRollups.js.map +0 -1
  1206. package/dist/native/rollups/deltas.js +0 -106
  1207. package/dist/native/rollups/deltas.js.map +0 -1
  1208. package/dist/native/rollups/insertManyIfNew.js +0 -93
  1209. package/dist/native/rollups/insertManyIfNew.js.map +0 -1
  1210. package/dist/plugin/paths.js +0 -29
  1211. package/dist/plugin/paths.js.map +0 -1
  1212. package/dist/react/TrackerBoot.d.ts +0 -22
  1213. package/dist/rsc/AnalyticsScripts.d.ts +0 -30
  1214. package/dist/rsc/AnalyticsScripts.js +0 -41
  1215. package/dist/rsc/AnalyticsScripts.js.map +0 -1
  1216. package/dist/surfacing/queue.js +0 -60
  1217. package/dist/surfacing/queue.js.map +0 -1
  1218. package/dist/surfacing/retryPolicy.js +0 -15
  1219. package/dist/surfacing/retryPolicy.js.map +0 -1
  1220. package/dist/tracker/autoCapture.d.ts +0 -48
  1221. package/dist/tracker/consent.d.ts +0 -24
  1222. package/dist/tracker/consent.js +0 -48
  1223. package/dist/tracker/consent.js.map +0 -1
  1224. package/dist/tracker/loadScript.d.ts +0 -14
  1225. package/dist/tracker/pageTracking.d.ts +0 -17
  1226. package/dist/tracker/registry.d.ts +0 -27
  1227. package/dist/tracker/sinks/ga4.d.ts +0 -29
  1228. package/dist/tracker/sinks/native.d.ts +0 -22
  1229. package/dist/tracker/sinks/plausible.d.ts +0 -20
  1230. package/dist/tracker/sinks/posthog.d.ts +0 -18
  1231. package/dist/tracker/sinks/umami.d.ts +0 -18
  1232. package/dist/tracker/sinks/vendor.d.ts +0 -14
  1233. package/dist/view/sections/styles.js +0 -76
  1234. package/dist/view/sections/styles.js.map +0 -1
  1235. package/dist/widgets/WidgetViewLink.js +0 -17
  1236. package/dist/widgets/WidgetViewLink.js.map +0 -1
  1237. package/dist/widgets/cardChrome.d.ts +0 -8
  1238. package/dist/widgets/cardChrome.js +0 -46
  1239. package/dist/widgets/cardChrome.js.map +0 -1
  1240. package/dist/widgets/comparison.js +0 -57
  1241. package/dist/widgets/comparison.js.map +0 -1
@@ -1 +1 @@
1
- {"version":3,"file":"engine.js","names":[],"sources":["../../src/surfacing/engine.ts"],"sourcesContent":["import { buildCacheKey } from '../core/cacheKey'\nimport type { AnalyticsAdapter, AnalyticsQuery, AnalyticsResult } from '../core/contract'\nimport { DEFAULT_TIMEZONE, startOfDayInTz } from '../timeframe/tz'\nimport type { CacheStore } from './cacheStore'\nimport { createCoalescer } from './coalesce'\nimport { type EpochStore, INITIAL_EPOCH } from './epoch'\nimport { createQueue, type QueueOptions } from './queue'\nimport { limiterFor, type RateLimiter } from './rateLimiter'\nimport { PROVIDER_READ_TIMEOUT_MESSAGE, shouldRetryProviderError } from './retryPolicy'\n\nconst DAY_MS = 86_400_000\n\nconst clampRange = (\n\trange: AnalyticsQuery['dateRange'],\n\tmaxLookbackDays: number | null,\n\ttz: string = DEFAULT_TIMEZONE\n): { range: AnalyticsQuery['dateRange']; clamped: boolean } => {\n\tif (maxLookbackDays == null) {\n\t\treturn { range, clamped: false }\n\t}\n\tconst floor = new Date(startOfDayInTz(range.end, tz).getTime() - maxLookbackDays * DAY_MS)\n\tif (range.start.getTime() >= floor.getTime()) {\n\t\treturn { range, clamped: false }\n\t}\n\treturn { range: { start: floor, end: range.end }, clamped: true }\n}\n\nexport interface EngineOptions {\n\tstore: CacheStore\n\tqueue: QueueOptions\n\t/** Explicit TTL overrides; when a value is unset the adapter's recommendedTtl applies. */\n\tttl: { aggregate?: number; realtime?: number }\n\t/** Budget for a single adapter read; the in-flight request is aborted past this. */\n\ttimeoutMs: number\n\t/** Called once per failed adapter fetch, before falling back to a stale cache entry. */\n\tonError?: (err: unknown, adapterId: string) => void\n\t/**\n\t * Per-scope cache epoch carried by every key. Absent, every read keys on the initial\n\t * token and a provider change only clears the in-process maps, as it did before the\n\t * epoch shipped.\n\t */\n\tepoch?: Pick<EpochStore, 'get'>\n}\n\nexport interface Engine {\n\tread(adapter: AnalyticsAdapter, query: AnalyticsQuery): Promise<AnalyticsResult>\n}\n\nconst emptyResult = (provider: string, q: AnalyticsQuery): AnalyticsResult => ({\n\trows: [],\n\tmeta: { provider, fetchedAt: q.dateRange.end.toISOString() },\n})\n\nexport function createEngine(opts: EngineOptions): Engine {\n\tconst coalesce = createCoalescer<AnalyticsResult>()\n\tconst limiters = new Map<string, RateLimiter>()\n\tconst queue = createQueue({\n\t\t...opts.queue,\n\t\tshouldRetry: shouldRetryProviderError,\n\t\tbaseDelayMs: 500,\n\t})\n\n\treturn {\n\t\tasync read(adapter, query) {\n\t\t\tif (!adapter.isConfigured()) return emptyResult(adapter.id, query)\n\n\t\t\tconst { range, clamped } = clampRange(\n\t\t\t\tquery.dateRange,\n\t\t\t\tadapter.capabilities.maxLookbackDays,\n\t\t\t\tquery.timezone\n\t\t\t)\n\t\t\tconst q = clamped ? { ...query, dateRange: range } : query\n\t\t\t// Resolved before the key so the coalescer key carries the epoch too: two reads\n\t\t\t// across a bump must not share one in-flight answer.\n\t\t\tconst epoch = (await opts.epoch?.get(q.scope)) ?? INITIAL_EPOCH\n\t\t\tconst key = buildCacheKey(adapter.id, q, { epoch })\n\t\t\treturn coalesce(key, async () => {\n\t\t\t\tlet fresh: AnalyticsResult\n\t\t\t\tconst controller = new AbortController()\n\t\t\t\tconst timer = setTimeout(\n\t\t\t\t\t() => controller.abort(new Error(PROVIDER_READ_TIMEOUT_MESSAGE)),\n\t\t\t\t\topts.timeoutMs\n\t\t\t\t)\n\t\t\t\ttimer.unref?.()\n\t\t\t\ttry {\n\t\t\t\t\tconst cached = await opts.store.get<AnalyticsResult>(key)\n\t\t\t\t\tif (cached) return cached\n\n\t\t\t\t\t// Races the queued attempt itself, not just its backoff waits, so a signal-blind\n\t\t\t\t\t// adapter (one that never checks ctx.signal) still bounds the read at timeoutMs.\n\t\t\t\t\t// The orphaned attempt keeps its queue slot until the underlying client gives up;\n\t\t\t\t\t// this only bounds how long read() waits for it.\n\t\t\t\t\tconst aborted = new Promise<never>((_resolve, reject) => {\n\t\t\t\t\t\tcontroller.signal.addEventListener('abort', () => reject(controller.signal.reason), {\n\t\t\t\t\t\t\tonce: true,\n\t\t\t\t\t\t})\n\t\t\t\t\t})\n\t\t\t\t\tconst attempt = queue.run(async () => {\n\t\t\t\t\t\tconst release = await limiterFor(limiters, adapter).take(controller.signal)\n\t\t\t\t\t\ttry {\n\t\t\t\t\t\t\treturn await adapter.query(q, { signal: controller.signal })\n\t\t\t\t\t\t} finally {\n\t\t\t\t\t\t\trelease()\n\t\t\t\t\t\t}\n\t\t\t\t\t}, controller.signal)\n\t\t\t\t\tattempt.catch(() => {})\n\t\t\t\t\tfresh = await Promise.race([attempt, aborted])\n\t\t\t\t} catch (err) {\n\t\t\t\t\topts.onError?.(err, adapter.id)\n\t\t\t\t\ttry {\n\t\t\t\t\t\tconst stale = await opts.store.getStale<AnalyticsResult>(key)\n\t\t\t\t\t\tif (stale) return { ...stale, meta: { ...stale.meta, stale: true } }\n\t\t\t\t\t} catch {\n\t\t\t\t\t\t// A broken store fails getStale too; surface the original read error, not this one.\n\t\t\t\t\t}\n\t\t\t\t\tthrow err\n\t\t\t\t} finally {\n\t\t\t\t\tclearTimeout(timer)\n\t\t\t\t}\n\t\t\t\tconst result: AnalyticsResult = clamped\n\t\t\t\t\t? { ...fresh, meta: { ...fresh.meta, clamped: true } }\n\t\t\t\t\t: fresh\n\t\t\t\t// `goalsUnresolved` is always a failure to resolve, whatever hint the read carried:\n\t\t\t\t// a scope with no goals answers empty rows unflagged. At the aggregate TTL one\n\t\t\t\t// transient error would pin \"no conversions\" for an hour. A direct engine caller\n\t\t\t\t// that never hints is flagged on every read and so stays at the short TTL.\n\t\t\t\tconst degraded = result.meta.goalsUnresolved === true\n\t\t\t\tconst ttl = degraded\n\t\t\t\t\t? (opts.ttl.realtime ?? adapter.capabilities.recommendedTtl.realtime)\n\t\t\t\t\t: (opts.ttl.aggregate ?? adapter.capabilities.recommendedTtl.aggregate)\n\t\t\t\tawait opts.store.set(key, result, ttl)\n\t\t\t\treturn result\n\t\t\t})\n\t\t},\n\t}\n}\n"],"mappings":";;;;;;;AAUA,MAAM,SAAS;AAEf,MAAM,cACL,OACA,iBACA,KAAA,UAC8D;CAC9D,IAAI,mBAAmB,MACtB,OAAO;EAAE;EAAO,SAAS;CAAM;CAEhC,MAAM,wBAAQ,IAAI,KAAK,eAAe,MAAM,KAAK,EAAE,EAAE,QAAQ,IAAI,kBAAkB,MAAM;CACzF,IAAI,MAAM,MAAM,QAAQ,KAAK,MAAM,QAAQ,GAC1C,OAAO;EAAE;EAAO,SAAS;CAAM;CAEhC,OAAO;EAAE,OAAO;GAAE,OAAO;GAAO,KAAK,MAAM;EAAI;EAAG,SAAS;CAAK;AACjE;AAuBA,MAAM,eAAe,UAAkB,OAAwC;CAC9E,MAAM,CAAC;CACP,MAAM;EAAE;EAAU,WAAW,EAAE,UAAU,IAAI,YAAY;CAAE;AAC5D;AAEA,SAAgB,aAAa,MAA6B;CACzD,MAAM,WAAW,gBAAiC;CAClD,MAAM,2BAAW,IAAI,IAAyB;CAC9C,MAAM,QAAQ,YAAY;EACzB,GAAG,KAAK;EACR,aAAa;EACb,aAAa;CACd,CAAC;CAED,OAAO,EACN,MAAM,KAAK,SAAS,OAAO;EAC1B,IAAI,CAAC,QAAQ,aAAa,GAAG,OAAO,YAAY,QAAQ,IAAI,KAAK;EAEjE,MAAM,EAAE,OAAO,YAAY,WAC1B,MAAM,WACN,QAAQ,aAAa,iBACrB,MAAM,QACP;EACA,MAAM,IAAI,UAAU;GAAE,GAAG;GAAO,WAAW;EAAM,IAAI;EAGrD,MAAM,QAAS,MAAM,KAAK,OAAO,IAAI,EAAE,KAAK,KAAA;EAC5C,MAAM,MAAM,cAAc,QAAQ,IAAI,GAAG,EAAE,MAAM,CAAC;EAClD,OAAO,SAAS,KAAK,YAAY;GAChC,IAAI;GACJ,MAAM,aAAa,IAAI,gBAAgB;GACvC,MAAM,QAAQ,iBACP,WAAW,MAAM,IAAI,MAAM,6BAA6B,CAAC,GAC/D,KAAK,SACN;GACA,MAAM,QAAQ;GACd,IAAI;IACH,MAAM,SAAS,MAAM,KAAK,MAAM,IAAqB,GAAG;IACxD,IAAI,QAAQ,OAAO;IAMnB,MAAM,UAAU,IAAI,SAAgB,UAAU,WAAW;KACxD,WAAW,OAAO,iBAAiB,eAAe,OAAO,WAAW,OAAO,MAAM,GAAG,EACnF,MAAM,KACP,CAAC;IACF,CAAC;IACD,MAAM,UAAU,MAAM,IAAI,YAAY;KACrC,MAAM,UAAU,MAAM,WAAW,UAAU,OAAO,EAAE,KAAK,WAAW,MAAM;KAC1E,IAAI;MACH,OAAO,MAAM,QAAQ,MAAM,GAAG,EAAE,QAAQ,WAAW,OAAO,CAAC;KAC5D,UAAU;MACT,QAAQ;KACT;IACD,GAAG,WAAW,MAAM;IACpB,QAAQ,YAAY,CAAC,CAAC;IACtB,QAAQ,MAAM,QAAQ,KAAK,CAAC,SAAS,OAAO,CAAC;GAC9C,SAAS,KAAK;IACb,KAAK,UAAU,KAAK,QAAQ,EAAE;IAC9B,IAAI;KACH,MAAM,QAAQ,MAAM,KAAK,MAAM,SAA0B,GAAG;KAC5D,IAAI,OAAO,OAAO;MAAE,GAAG;MAAO,MAAM;OAAE,GAAG,MAAM;OAAM,OAAO;MAAK;KAAE;IACpE,QAAQ,CAER;IACA,MAAM;GACP,UAAU;IACT,aAAa,KAAK;GACnB;GACA,MAAM,SAA0B,UAC7B;IAAE,GAAG;IAAO,MAAM;KAAE,GAAG,MAAM;KAAM,SAAS;IAAK;GAAE,IACnD;GAMH,MAAM,MADW,OAAO,KAAK,oBAAoB,OAE7C,KAAK,IAAI,YAAY,QAAQ,aAAa,eAAe,WACzD,KAAK,IAAI,aAAa,QAAQ,aAAa,eAAe;GAC9D,MAAM,KAAK,MAAM,IAAI,KAAK,QAAQ,GAAG;GACrC,OAAO;EACR,CAAC;CACF,EACD;AACD"}
1
+ {"version":3,"file":"engine.js","names":[],"sources":["../../src/surfacing/engine.ts"],"sourcesContent":["import type { Payload } from 'payload'\nimport { OVER_BUDGET, withinBudget } from '../core/budget'\nimport { buildCacheKey, type CacheKeyEpochs } from '../core/cacheKey'\nimport { unsupportedFilter } from '../core/capabilities'\nimport { currentTime } from '../core/clock'\nimport type {\n\tAdapterContext,\n\tAnalyticsAdapter,\n\tAnalyticsQuery,\n\tAnalyticsResult,\n\tSourceErrorKind,\n} from '../core/contract'\nimport { monotonicMs } from '../core/monotonic'\nimport { UnsupportedFilterError } from '../core/sourceErrors'\nimport { earlierInstant, isRecord } from '../core/values'\nimport type { TimeframePreset } from '../timeframe/presets'\nimport { DAY_MS, DEFAULT_TIMEZONE, startOfDayInTz } from '../timeframe/tz'\nimport type { AfterReadAnswer, AfterReadHook, ReadOrigin } from './afterRead'\nimport {\n\ttype CacheEntry,\n\ttype CacheStore,\n\tisCachedResult,\n\ttype ReadRecipe,\n\tSTALE_WINDOW_SECONDS,\n} from './cacheStore'\nimport {\n\tclassifyError,\n\tisLaneRefused,\n\tPROVIDER_READ_TIMEOUT_MESSAGE,\n\tReadFailedError,\n\ttype ReadFailure,\n\tScopeBusyError,\n} from './classifyError'\nimport { createCoalescer } from './coalesce'\nimport { BUSY_RETRY_AFTER_MS, createColdBudget, DEFAULT_COLD_READS_PER_SCOPE } from './coldBudget'\nimport { type EpochSources, epochsFor } from './epoch'\nimport { createLanes, type LaneHealth, type Lanes, type Priority, runUpstream } from './lanes'\nimport { AGGREGATE_MEMO_MS, createMemo, type Memo } from './memo'\nimport { dayRead, foldResult, type RebucketPlan, rebucketPlan } from './rebucket'\nimport { RECIPE_WINDOWS, recipeWindow } from './recipe'\nimport { shapeResult } from './shape'\nimport { mergeAtToday, splitAtToday } from './todaySplit'\n\n/** How often a read carrying a recipe stamps the entry it was served as read. */\nconst TOUCH_EVERY_MS = 3_600_000\n\n/** How long a key's last failed refresh is remembered, to word or refuse its stale answers. */\nconst FAILURE_MEMO_MS = 60_000\n\n/** How long a peek waits on the store before it answers that nothing is there. */\nexport const PEEK_BUDGET_MS = 150\n\n/** How long a read waits on the store before reading the source as if nothing were cached. */\nconst STORE_GET_BUDGET_MS = 1_000\n\n/** An instant a store handed back: finite epoch milliseconds. */\nconst isInstant = (value: unknown): value is number =>\n\ttypeof value === 'number' && Number.isFinite(value)\n\n/** Whether an entry's instants are what the store contract says: finite epoch milliseconds. */\nconst hasInstants = (entry: CacheEntry): boolean =>\n\tisInstant(entry.fetchedAt) &&\n\tisInstant(entry.expiresAt) &&\n\tisInstant(entry.staleUntil) &&\n\t(entry.readAt === undefined || entry.readAt === null || isInstant(entry.readAt))\n\n/**\n * The clock deadlines, waits and durations run on: the one timers run on. The cache clock (`now`)\n * may be moved by a test, or by Payload's job-system globals, without any timer moving with it.\n */\nconst timerNow = monotonicMs\n\n/**\n * The window a source is asked for, from its lookback on; one that declares none still starts no\n * earlier than 1970, before which nothing was counted, so no read walks centuries of days.\n */\nconst clampRange = (\n\trange: AnalyticsQuery['dateRange'],\n\tmaxLookbackDays: number | null,\n\ttz: string = DEFAULT_TIMEZONE\n): { range: AnalyticsQuery['dateRange']; clamped: boolean } => {\n\tconst floor =\n\t\tmaxLookbackDays == null ? 0 : startOfDayInTz(range.end, tz).getTime() - maxLookbackDays * DAY_MS\n\tif (range.start.getTime() >= floor) {\n\t\treturn { range, clamped: false }\n\t}\n\treturn { range: { start: new Date(floor), end: range.end }, clamped: true }\n}\n\n/**\n * A breakdown cut by `limit` with no `order` asks its source for its first metric's top rows: a\n * source ranking by anything else would hand over a subset the engine cannot rank back.\n */\nconst rankedQuery = (query: AnalyticsQuery): AnalyticsQuery => {\n\tconst metric = query.metrics[0]\n\treturn query.limit !== undefined &&\n\t\tquery.order === undefined &&\n\t\t(query.dimensions?.length ?? 0) > 0 &&\n\t\tmetric !== undefined\n\t\t? { ...query, order: { metric, direction: 'desc' } }\n\t\t: query\n}\n\nexport type CacheOperation = 'get' | 'set' | 'touch'\n\nexport interface EngineOptions {\n\tstore: CacheStore\n\t/** The instance's in-process memo; a private one of the default size when absent. */\n\tmemo?: Memo<AnalyticsResult>\n\t/** Lanes reads reach their sources through; a private set with default caps when absent. */\n\tlanes?: Lanes\n\t/** Cold reads one scope may have waiting on its sources at once; default 8. */\n\tcoldReadsPerScope?: number\n\t/** Explicit TTL overrides; when a value is unset the adapter's recommendedTtl applies. */\n\tttl: { aggregate?: number; realtime?: number }\n\t/**\n\t * Budget for one fetch from a source, every wait and retry included; the request in flight is\n\t * aborted past it.\n\t */\n\ttimeoutMs: number\n\t/** Called once per failed fetch, before falling back to a stale cache entry. */\n\tonError?: (err: unknown, adapterId: string) => void\n\t/** Called when the store fails; the read carries on as if the entry were absent or unwritten. */\n\tonStoreError?: (err: unknown, operation: CacheOperation) => void\n\t/** Called after each value the store accepted. */\n\tonWrite?: () => void\n\t/**\n\t * The scope's refresh epoch, which every key carries. Absent, every read keys on the initial\n\t * token.\n\t */\n\tepoch?: EpochSources['refresh']\n\t/** The scope's configuration epoch, which every key carries; absent, a fixed one. */\n\tconfigEpoch?: EpochSources['config']\n\t/** The instance every read is for, handed to adapters as `AdapterContext.payload`. */\n\tpayload?: Payload\n\t/** Epoch milliseconds; the plugin's clock (`currentDate`) by default. */\n\tnow?: () => number\n\t/**\n\t * Keeps a background refresh running past the response that started it: Next's `after()` inside\n\t * a request. The engine tracks every refresh itself as well, so `idle()` waits for all of them.\n\t */\n\tkeepAlive?: (work: Promise<unknown>) => void | Promise<void>\n\t/** `hooks.afterRead`, run only on an engine built with `payload`, which the hook is handed. */\n\tafterRead?: AfterReadHook\n\t/** Told each time the hook throws; the read is answered as if it had returned nothing. */\n\tonHookError?: (err: unknown) => void\n\t/** Called as each read starts, before anything is looked up. */\n\tonRead?: () => void\n}\n\nexport interface ReadOptions {\n\t/**\n\t * False waits for an expired entry's refresh instead of answering with it, falling back to it\n\t * only when the refresh fails; for work that keeps what it reads (sync). Default true.\n\t */\n\tallowStale?: boolean\n\t/**\n\t * The named timeframe the read's window came from; when the window is that preset's as of now,\n\t * the read's recipe is stored with its entry so the warm task keeps it warm.\n\t */\n\ttimeframe?: TimeframePreset\n\t/**\n\t * `interactive` for an open panel or view, served first; `background` for work nobody waits on,\n\t * held to half a source's slots like every refresh. Default `normal`.\n\t */\n\tpriority?: Priority\n\t/**\n\t * On a full scope (`coldReadsPerScope`) a cold read waits within `timeoutMs` (default), or with\n\t * `refuse` fails at once as `rate_limited`; a read matching one already waiting joins it anyway.\n\t */\n\twhenBusy?: 'wait' | 'refuse'\n\t/**\n\t * False answers without `hooks.afterRead`: work that keeps what it reads (sync) stores the\n\t * source's own answer, never what the hook made of it for one reader. Default true.\n\t */\n\tafterRead?: boolean\n}\n\nexport interface RefreshOptions {\n\t/** An entry still fresh for this many more milliseconds is left as it is. */\n\tfreshForMs: number\n\t/** Default `background`. */\n\tpriority?: Priority\n}\n\n/** What a refresh did: left an entry fresh enough, or read the source again and stored it. */\nexport type RefreshOutcome = 'fresh' | 'refreshed'\n\nexport interface PeekOptions {\n\t/** Milliseconds the memo and the store may take to answer; default {@link PEEK_BUDGET_MS}. */\n\tbudgetMs?: number\n}\n\nexport interface Engine {\n\tread(\n\t\tadapter: AnalyticsAdapter,\n\t\tquery: AnalyticsQuery,\n\t\toptions?: ReadOptions\n\t): Promise<AnalyticsResult>\n\t/**\n\t * The warm task's read: re-reads `query` and stores the answer unless its entry stays fresh for\n\t * `freshForMs` more, never touching its recipe or read time. Absent when nothing caches.\n\t */\n\trefresh?(\n\t\tadapter: AnalyticsAdapter,\n\t\tquery: AnalyticsQuery,\n\t\toptions: RefreshOptions\n\t): Promise<RefreshOutcome>\n\t/**\n\t * What a read would answer from memory or the store, never asking the source or refreshing;\n\t * undefined when neither holds it within the budget. Absent on an engine that caches nothing.\n\t */\n\tpeek?(\n\t\tadapter: AnalyticsAdapter,\n\t\tquery: AnalyticsQuery,\n\t\toptions?: PeekOptions\n\t): Promise<AnalyticsResult | undefined>\n\t/**\n\t * A live count from the adapter's `realtime`, through its lane at interactive priority and\n\t * within the read timeout; never cached here. Absent on an engine without lanes.\n\t */\n\trealtime?(adapter: AnalyticsAdapter, query: AnalyticsQuery): Promise<AnalyticsResult>\n\t/** Settles once every background refresh has finished; absent on one starting none. */\n\tidle?(): Promise<void>\n\t/**\n\t * Keeps `work` a caller stopped waiting for running past the response, counted until it settles\n\t * so `idle()` and `close()` wait for it. Absent on an engine starting no background work.\n\t */\n\tkeep?(work: Promise<unknown>): void\n\t/**\n\t * Starts no background work from now on (refreshes, cache writes) and settles what is running:\n\t * the runtime holding the engine is retired. Reads still answer.\n\t */\n\tclose?(): Promise<void>\n\t/**\n\t * The state of the lane an adapter's reads go through for `scope`; absent on an engine without\n\t * lanes.\n\t */\n\thealth?(adapter: AnalyticsAdapter, scope?: string | null): LaneHealth\n}\n\n/**\n * An adapter drops a filter it cannot apply and answers unfiltered, which would read as filtered\n * numbers: every caller gates first, and this is the gate behind them all.\n */\nconst checkFilters = (adapter: AnalyticsAdapter, query: AnalyticsQuery): void => {\n\tconst refused = unsupportedFilter(adapter.capabilities, query.filters ?? [])\n\tif (refused) {\n\t\tthrow new UnsupportedFilterError(adapter.id, refused)\n\t}\n}\n\n/** A hook's answer that replaces the read's, rather than nothing. */\nconst replaces = (answer: AfterReadAnswer): answer is AnalyticsResult => isRecord(answer)\n\nconst emptyResult = (provider: string, at: number): AnalyticsResult => ({\n\trows: [],\n\tmeta: { provider, fetchedAt: new Date(at).toISOString() },\n})\n\n/** `result` with `meta.fetchedAt` no later than `answeredAt`, replacing a later or bad one. */\nconst readAt = (result: AnalyticsResult, answeredAt: number): AnalyticsResult => {\n\tconst stamped = Date.parse(result.meta.fetchedAt)\n\treturn Number.isFinite(stamped) && stamped <= answeredAt\n\t\t? result\n\t\t: { ...result, meta: { ...result.meta, fetchedAt: new Date(answeredAt).toISOString() } }\n}\n\n/** An expired entry as served: stale, dated to its fetch, and why its source needs a look. */\nconst staleResult = (entry: CacheEntry, sourceError?: SourceErrorKind): AnalyticsResult => ({\n\t...entry.value,\n\tmeta: {\n\t\t...entry.value.meta,\n\t\tstale: true,\n\t\tasOf: earlierInstant(entry.value.meta.asOf, new Date(entry.fetchedAt).toISOString()),\n\t\t...(sourceError ? { sourceError } : {}),\n\t},\n})\n\n/**\n * Why a stale answer's source needs a look: the key's own last failure when there is one, else the\n * failure its lane last counted, but only a failure about setup, never an outage.\n */\nconst sourceErrorOf = (\n\tfailure: ReadFailure | undefined,\n\thealth: LaneHealth\n): SourceErrorKind | undefined => {\n\tif (failure) {\n\t\tif (failure.kind !== 'source_misconfigured') {\n\t\t\treturn undefined\n\t\t}\n\t\treturn failure.hostRefused ? 'host-refused' : 'misconfigured'\n\t}\n\tif (health.lastFailure !== 'source_misconfigured') {\n\t\treturn undefined\n\t}\n\treturn health.hostRefused ? 'host-refused' : 'misconfigured'\n}\n\n/** A failure as it is thrown: an outage says how long to wait when its lane knows. */\nconst withLaneRetryAfter = (failure: ReadFailure, health: LaneHealth): ReadFailure =>\n\tfailure.kind === 'unavailable' &&\n\tfailure.retryAfterMs === undefined &&\n\thealth.retryAfterMs !== undefined\n\t\t? { ...failure, retryAfterMs: health.retryAfterMs }\n\t\t: failure\n\n/** What a peek found kept for a query, and where. */\ninterface Kept {\n\tq: AnalyticsQuery\n\tresult: AnalyticsResult\n\tfrom: ReadOrigin\n}\n\n/** One read made ready: its query as keyed, the request its source gets, and its cache key. */\ninterface Prepared {\n\t/** The query as asked, its window clamped to the source's lookback. */\n\tq: AnalyticsQuery\n\tclamped: boolean\n\trange: AnalyticsQuery['dateRange']\n\tplan: RebucketPlan | undefined\n\t/** What the adapter is asked: the query, or its days where weeks or months are folded here. */\n\tadapterQuery: AnalyticsQuery\n\tepochs: CacheKeyEpochs\n\tkey: string\n}\n\nexport function createEngine(opts: EngineOptions): Required<Engine> {\n\tconst now = opts.now ?? currentTime\n\tconst memo = opts.memo ?? createMemo<AnalyticsResult>({ now })\n\tconst failures = createMemo<ReadFailure>({ now })\n\tconst coalesce = createCoalescer<AnalyticsResult>()\n\tconst lanes = opts.lanes ?? createLanes()\n\tconst budget = createColdBudget(opts.coldReadsPerScope ?? DEFAULT_COLD_READS_PER_SCOPE)\n\tconst background = new Set<Promise<unknown>>()\n\tconst storeGetMs = Math.min(STORE_GET_BUDGET_MS, opts.timeoutMs)\n\tlet closed = false\n\n\t/**\n\t * The store's entry for `key`, or null: a store that fails, answers past\n\t * {@link STORE_GET_BUDGET_MS} or breaks the entry contract is reported and read as a miss.\n\t */\n\tconst cached = async (key: string): Promise<CacheEntry | null> => {\n\t\tlet entry: CacheEntry | null | typeof OVER_BUDGET\n\t\ttry {\n\t\t\tentry = await withinBudget(opts.store.get(key), storeGetMs)\n\t\t} catch (err) {\n\t\t\topts.onStoreError?.(err, 'get')\n\t\t\treturn null\n\t\t}\n\t\tif (entry === OVER_BUDGET) {\n\t\t\topts.onStoreError?.(\n\t\t\t\tnew Error(`analytics: the read cache did not answer within ${storeGetMs} ms`),\n\t\t\t\t'get'\n\t\t\t)\n\t\t\treturn null\n\t\t}\n\t\tif (!entry || !isCachedResult(entry.value)) {\n\t\t\treturn null\n\t\t}\n\t\tif (!hasInstants(entry)) {\n\t\t\topts.onStoreError?.(\n\t\t\t\tnew Error(\n\t\t\t\t\t'analytics: the read cache answered an entry whose fetchedAt, expiresAt or staleUntil is not a finite number of milliseconds'\n\t\t\t\t),\n\t\t\t\t'get'\n\t\t\t)\n\t\t\treturn null\n\t\t}\n\t\treturn entry\n\t}\n\n\t/** Tracks `work` until it settles, keeping it alive past the response; answers once settled. */\n\tconst inBackground = (work: Promise<unknown>): Promise<void> => {\n\t\tconst settled = work.then(\n\t\t\t() => undefined,\n\t\t\t() => undefined\n\t\t)\n\t\tbackground.add(settled)\n\t\tvoid settled.finally(() => background.delete(settled))\n\t\ttry {\n\t\t\tconst kept = opts.keepAlive?.(settled)\n\t\t\tif (kept instanceof Promise) {\n\t\t\t\tkept.catch(() => {})\n\t\t\t}\n\t\t} catch {\n\t\t\t// Outside a request there is nothing to keep alive; the engine's own tracking still holds it.\n\t\t}\n\t\treturn settled\n\t}\n\n\tconst idle = async (): Promise<void> => {\n\t\twhile (background.size > 0) {\n\t\t\tawait Promise.all([...background])\n\t\t}\n\t}\n\n\t/** Writes an answer to the store, never failing the read: a store that fails is reported. */\n\tconst store = async (\n\t\tkey: string,\n\t\tresult: AnalyticsResult,\n\t\toptions: Parameters<CacheStore['set']>[2]\n\t): Promise<void> => {\n\t\ttry {\n\t\t\tawait opts.store.set(key, result, options)\n\t\t\topts.onWrite?.()\n\t\t} catch (err) {\n\t\t\topts.onStoreError?.(err, 'set')\n\t\t}\n\t}\n\n\t/**\n\t * One call to the source through the adapter's lane: per request when the adapter sends through\n\t * `upstream`, else one token and slot for the whole call.\n\t */\n\tconst throughLane = (\n\t\tadapter: AnalyticsAdapter,\n\t\tcall: (ctx: AdapterContext) => Promise<AnalyticsResult>,\n\t\trun: { signal: AbortSignal; priority: Priority; deadline: number; scope: string | null }\n\t): Promise<AnalyticsResult> => {\n\t\tconst lane = lanes.for(adapter, run.scope)\n\t\tconst options = { ...run, now: timerNow }\n\t\tconst base: AdapterContext = {\n\t\t\t...(opts.payload ? { payload: opts.payload } : {}),\n\t\t\tsignal: run.signal,\n\t\t\tnow: () => new Date(now()),\n\t\t\tremainingMs: () => Math.max(0, run.deadline - timerNow()),\n\t\t}\n\t\tif (adapter.capabilities.upstreamAware) {\n\t\t\treturn call({\n\t\t\t\t...base,\n\t\t\t\tupstream: <T>(fn: (signal?: AbortSignal) => Promise<T>) => runUpstream(lane, fn, options),\n\t\t\t})\n\t\t}\n\t\treturn runUpstream(\n\t\t\tlane,\n\t\t\t(signal) =>\n\t\t\t\tcall({\n\t\t\t\t\t...base,\n\t\t\t\t\tsignal,\n\t\t\t\t\tupstream: <T>(fn: (signal?: AbortSignal) => Promise<T>) => fn(signal),\n\t\t\t\t}),\n\t\t\toptions\n\t\t)\n\t}\n\n\t/** Runs `hooks.afterRead` on one answer; a hook that throws answers as if it returned nothing. */\n\tconst answered = async (args: {\n\t\tadapter: AnalyticsAdapter\n\t\tq: AnalyticsQuery\n\t\tresult: AnalyticsResult\n\t\tfrom: ReadOrigin\n\t\tstartedAt: number\n\t}): Promise<AnalyticsResult> => {\n\t\tconst { afterRead: hook, payload } = opts\n\t\tif (!hook || !payload) {\n\t\t\treturn args.result\n\t\t}\n\t\ttry {\n\t\t\tconst adjusted = await hook({\n\t\t\t\tadapterId: args.adapter.id,\n\t\t\t\tquery: args.q,\n\t\t\t\tresult: args.result,\n\t\t\t\tfrom: args.from,\n\t\t\t\tdurationMs: Math.max(0, timerNow() - args.startedAt),\n\t\t\t\tpayload,\n\t\t\t})\n\t\t\treturn replaces(adjusted) ? adjusted : args.result\n\t\t} catch (err) {\n\t\t\topts.onHookError?.(err)\n\t\t\treturn args.result\n\t\t}\n\t}\n\n\t/**\n\t * Settles with `work` or rejects after `timeoutMs`, aborting the signal; the race also bounds an\n\t * adapter that never checks it. Lane slots return once the request settles or is abandoned.\n\t */\n\tconst withinTimeout = async <T>(\n\t\twork: (run: { signal: AbortSignal; deadline: number }) => Promise<T>\n\t): Promise<T> => {\n\t\tconst controller = new AbortController()\n\t\tconst deadline = timerNow() + opts.timeoutMs\n\t\tconst timer = setTimeout(\n\t\t\t() => controller.abort(new Error(PROVIDER_READ_TIMEOUT_MESSAGE)),\n\t\t\topts.timeoutMs\n\t\t)\n\t\ttimer.unref?.()\n\t\ttry {\n\t\t\tconst aborted = new Promise<never>((_resolve, reject) => {\n\t\t\t\tcontroller.signal.addEventListener('abort', () => reject(controller.signal.reason), {\n\t\t\t\t\tonce: true,\n\t\t\t\t})\n\t\t\t})\n\t\t\tconst attempt = work({ signal: controller.signal, deadline })\n\t\t\tattempt.catch(() => {})\n\t\t\taborted.catch(() => {})\n\t\t\treturn await Promise.race([attempt, aborted])\n\t\t} finally {\n\t\t\tclearTimeout(timer)\n\t\t}\n\t}\n\n\tconst prepare = async (\n\t\tadapter: AnalyticsAdapter,\n\t\tquery: AnalyticsQuery,\n\t\tknown?: CacheKeyEpochs\n\t): Promise<Prepared> => {\n\t\tconst { range, clamped } = clampRange(\n\t\t\tquery.dateRange,\n\t\t\tadapter.capabilities.maxLookbackDays,\n\t\t\tquery.timezone\n\t\t)\n\t\tconst ranked = rankedQuery(query)\n\t\tconst q = range === query.dateRange ? ranked : { ...ranked, dateRange: range }\n\t\t// Weeks and months are folded here from days, exactly the same way for every source\n\t\t// that cannot answer them itself; the cache keys on the bucket the caller asked for.\n\t\tconst plan = rebucketPlan(q, adapter.capabilities)\n\t\tconst adapterQuery = plan ? dayRead(q, plan) : q\n\t\t// Resolved before the key so the coalescer key carries the epochs too: two reads\n\t\t// across a bump must not share one in-flight answer.\n\t\tconst epochs =\n\t\t\tknown ?? (await epochsFor({ refresh: opts.epoch, config: opts.configEpoch }, q.scope))\n\t\treturn {\n\t\t\tq,\n\t\t\tclamped,\n\t\t\trange,\n\t\t\tplan,\n\t\t\tadapterQuery,\n\t\t\tepochs,\n\t\t\tkey: buildCacheKey(adapter.id, q, epochs),\n\t\t}\n\t}\n\n\t/** The instant today began in the read's zone. */\n\tconst todayStart = (q: AnalyticsQuery): number =>\n\t\tstartOfDayInTz(new Date(now()), q.timezone ?? DEFAULT_TIMEZONE).getTime()\n\n\t/**\n\t * How long the source's answer for `q` stays fresh, when the source bounds a window reaching into\n\t * the current day (native's `recommendedTtl.today`); undefined for every other read.\n\t */\n\tconst todayTtl = (adapter: AnalyticsAdapter, q: AnalyticsQuery): number | undefined => {\n\t\tconst bound = adapter.capabilities.recommendedTtl.today\n\t\tif (bound === undefined) {\n\t\t\treturn undefined\n\t\t}\n\t\treturn q.dateRange.end.getTime() >= todayStart(q) ? bound : undefined\n\t}\n\n\t/** Holds a fresh store entry in memory until it expires, at most {@link AGGREGATE_MEMO_MS}. */\n\tconst memoizeEntry = (key: string, entry: CacheEntry, at: number): void => {\n\t\tmemo.set(key, entry.value, Math.min(AGGREGATE_MEMO_MS, entry.expiresAt - at))\n\t}\n\n\t/**\n\t * The read's recipe when its window is its timeframe's as of now, matched on the key a recipe\n\t * replayed now would read: the window as the key cuts it, after the same clamp.\n\t */\n\tconst recipeOf = async (\n\t\tadapter: AnalyticsAdapter,\n\t\tprepared: Prepared,\n\t\ttimeframe: TimeframePreset | undefined\n\t): Promise<ReadRecipe | undefined> => {\n\t\tif (timeframe === undefined) {\n\t\t\treturn undefined\n\t\t}\n\t\tconst at = new Date(now())\n\t\tconst { q } = prepared\n\t\tconst tz = q.timezone ?? DEFAULT_TIMEZONE\n\t\tconst { dateRange: _window, ...rest } = q\n\t\t// MongoDB stores an absent field as null, which a replay would then key on.\n\t\tfor (const key of Object.keys(rest)) {\n\t\t\tif (Reflect.get(rest, key) === undefined) {\n\t\t\t\tReflect.deleteProperty(rest, key)\n\t\t\t}\n\t\t}\n\t\tfor (const window of RECIPE_WINDOWS) {\n\t\t\tconst candidate = recipeWindow({ timeframe, window }, at, tz)\n\t\t\tif (!candidate) {\n\t\t\t\tcontinue\n\t\t\t}\n\t\t\tconst replayed = await prepare(adapter, { ...q, dateRange: candidate }, prepared.epochs)\n\t\t\tif (replayed.key === prepared.key) {\n\t\t\t\treturn { adapterRef: adapter.id, scope: q.scope ?? null, timeframe, window, query: rest }\n\t\t\t}\n\t\t}\n\t\treturn undefined\n\t}\n\n\t/**\n\t * Reads the source within the read timeout, memoizes and stores the answer (before answering\n\t * with `awaitStore`); a failure is remembered for a minute and thrown classified.\n\t */\n\tconst fetchFresh = async (\n\t\tadapter: AnalyticsAdapter,\n\t\tprepared: Prepared,\n\t\trun: {\n\t\t\tpriority: Priority\n\t\t\tgate?: (signal: AbortSignal) => Promise<() => void>\n\t\t\trecipe?: ReadRecipe\n\t\t\tawaitStore?: boolean\n\t\t}\n\t): Promise<AnalyticsResult> => {\n\t\tconst { key, q, plan, clamped, range } = prepared\n\t\tconst scope = q.scope ?? null\n\t\tlet fresh: AnalyticsResult\n\t\ttry {\n\t\t\tfresh = await withinTimeout(async ({ signal, deadline }) => {\n\t\t\t\tconst release = await run.gate?.(signal)\n\t\t\t\ttry {\n\t\t\t\t\treturn await throughLane(adapter, (ctx) => adapter.query(prepared.adapterQuery, ctx), {\n\t\t\t\t\t\tsignal,\n\t\t\t\t\t\tpriority: run.priority,\n\t\t\t\t\t\tdeadline,\n\t\t\t\t\t\tscope,\n\t\t\t\t\t})\n\t\t\t\t} finally {\n\t\t\t\t\trelease?.()\n\t\t\t\t}\n\t\t\t})\n\t\t} catch (err) {\n\t\t\tconst failure = classifyError(err)\n\t\t\tfailures.set(key, failure, FAILURE_MEMO_MS)\n\t\t\t// A lane refusal sent nothing: the failure that opened or paused the lane was told already.\n\t\t\tif (!isLaneRefused(err)) {\n\t\t\t\topts.onError?.(err, adapter.id)\n\t\t\t}\n\t\t\tthrow new ReadFailedError(\n\t\t\t\twithLaneRetryAfter(failure, lanes.for(adapter, scope).health()),\n\t\t\t\terr\n\t\t\t)\n\t\t}\n\t\tfailures.delete(key)\n\t\tconst answered = readAt(fresh, now())\n\t\tconst folded = plan ? foldResult(answered, q, plan) : answered\n\t\tconst shaped = shapeResult(folded, q)\n\t\tconst result: AnalyticsResult = clamped\n\t\t\t? {\n\t\t\t\t\t...shaped,\n\t\t\t\t\tmeta: { ...shaped.meta, clamped: true, dataFrom: range.start.toISOString() },\n\t\t\t\t}\n\t\t\t: shaped\n\t\t// Each passes (a failed goal resolver, a stand-in zone, days still being counted) and would\n\t\t// stay pinned for the aggregate TTL; a capped read stays capped, so it keeps that TTL.\n\t\tconst degraded =\n\t\t\tresult.meta.goalsUnresolved === true ||\n\t\t\tresult.meta.timezoneUnresolved === true ||\n\t\t\t(result.meta.partial?.missingDays ?? 0) > 0\n\t\tconst kept = degraded\n\t\t\t? (opts.ttl.realtime ?? adapter.capabilities.recommendedTtl.realtime)\n\t\t\t: (opts.ttl.aggregate ?? adapter.capabilities.recommendedTtl.aggregate)\n\t\tconst today = todayTtl(adapter, q)\n\t\tconst ttl = today === undefined ? kept : Math.min(kept, today)\n\t\tmemo.set(key, result, Math.min(AGGREGATE_MEMO_MS, ttl * 1000))\n\t\t// A store that is slow or hangs never holds up an answer the source already gave, nor `idle()`\n\t\t// past the read timeout.\n\t\tif (!closed) {\n\t\t\tconst write = store(key, result, {\n\t\t\t\tttlSeconds: ttl,\n\t\t\t\tstaleSeconds: STALE_WINDOW_SECONDS,\n\t\t\t\t...(q.scope === undefined ? {} : { scope: q.scope }),\n\t\t\t\t...(run.recipe ? { recipe: run.recipe } : {}),\n\t\t\t})\n\t\t\tconst stored = inBackground(\n\t\t\t\twithinBudget(write, opts.timeoutMs).then((done) => {\n\t\t\t\t\tif (done === OVER_BUDGET) {\n\t\t\t\t\t\topts.onStoreError?.(\n\t\t\t\t\t\t\tnew Error(`analytics: the read cache did not store within ${opts.timeoutMs} ms`),\n\t\t\t\t\t\t\t'set'\n\t\t\t\t\t\t)\n\t\t\t\t\t}\n\t\t\t\t})\n\t\t\t)\n\t\t\tif (run.awaitStore) {\n\t\t\t\tawait stored\n\t\t\t}\n\t\t}\n\t\treturn result\n\t}\n\n\t/** One read's answer as kept or fetched, and where it came from, before `hooks.afterRead`. */\n\tconst keep = async (\n\t\tadapter: AnalyticsAdapter,\n\t\tprepared: Prepared,\n\t\toptions: ReadOptions\n\t): Promise<Kept> => {\n\t\tconst { key, q } = prepared\n\t\tconst memoized = memo.get(key)\n\t\tif (memoized) return { q, result: memoized, from: 'memory' }\n\n\t\tconst scope = q.scope ?? null\n\t\tconst lane = lanes.for(adapter, scope)\n\t\tconst recipe = await recipeOf(adapter, prepared, options.timeframe)\n\t\tconst fetchFor = (\n\t\t\tpriority: Priority,\n\t\t\tgate?: (signal: AbortSignal) => Promise<() => void>\n\t\t): Promise<AnalyticsResult> =>\n\t\t\tfetchFresh(adapter, prepared, {\n\t\t\t\tpriority,\n\t\t\t\t...(gate ? { gate } : {}),\n\t\t\t\t...(recipe ? { recipe } : {}),\n\t\t\t})\n\t\tconst kept = (result: AnalyticsResult, from: ReadOrigin): Kept => ({ q, result, from })\n\n\t\tconst entry = await cached(key)\n\t\tconst at = now()\n\t\tif (entry && recipe && (entry.readAt == null || at - entry.readAt >= TOUCH_EVERY_MS)) {\n\t\t\topts.store\n\t\t\t\t.touch(key, new Date(at), recipe)\n\t\t\t\t.catch((err: unknown) => opts.onStoreError?.(err, 'touch'))\n\t\t}\n\t\tif (entry && entry.expiresAt > at) {\n\t\t\tmemoizeEntry(key, entry, at)\n\t\t\treturn kept(entry.value, 'store')\n\t\t}\n\t\tconst priority = options.priority ?? 'normal'\n\t\tconst usable = entry && entry.staleUntil > at ? entry : null\n\t\t// A source that bounds today's answers is read again before it answers one expired, rather\n\t\t// than serving it while a refresh runs: the expired one stands in only if that read fails.\n\t\tconst allowStale = options.allowStale !== false && todayTtl(adapter, q) === undefined\n\t\tif (usable && allowStale) {\n\t\t\tconst failure = failures.get(key)\n\t\t\t// A source that refuses the query as asked has nothing saved worth showing for it.\n\t\t\tif (failure?.kind === 'invalid_param') {\n\t\t\t\tthrow new ReadFailedError(failure)\n\t\t\t}\n\t\t\tconst health = lane.health()\n\t\t\t// An open breaker answers every refresh at once with a failure: skip it rather than log\n\t\t\t// one per read. Once its wait is over, the next refresh goes out as the probe.\n\t\t\tif (!health.open && !closed) {\n\t\t\t\tinBackground(coalesce(key, () => fetchFor('background')))\n\t\t\t}\n\t\t\treturn kept(staleResult(usable, sourceErrorOf(failure, health)), 'stale')\n\t\t}\n\t\tconst busy = options.whenBusy === 'refuse' && !coalesce.has(key) && !budget.available(scope)\n\t\tif (usable) {\n\t\t\t// Waiting for the source here is a cold read like any other, so it takes the scope's\n\t\t\t// place first; one refused a place falls back to the expired entry, as a failure does.\n\t\t\tif (busy) {\n\t\t\t\tconst failure = failures.get(key)\n\t\t\t\tif (failure?.kind === 'invalid_param') {\n\t\t\t\t\tthrow new ReadFailedError(failure)\n\t\t\t\t}\n\t\t\t\treturn kept(staleResult(usable, sourceErrorOf(failure, lane.health())), 'stale')\n\t\t\t}\n\t\t\ttry {\n\t\t\t\treturn kept(\n\t\t\t\t\tawait coalesce(key, () => fetchFor(priority, (signal) => budget.take(scope, signal))),\n\t\t\t\t\t'source'\n\t\t\t\t)\n\t\t\t} catch (err) {\n\t\t\t\tconst failure = classifyError(err)\n\t\t\t\tif (failure.kind === 'invalid_param') {\n\t\t\t\t\tthrow err\n\t\t\t\t}\n\t\t\t\treturn kept(staleResult(usable, sourceErrorOf(failure, lane.health())), 'stale')\n\t\t\t}\n\t\t}\n\t\tif (busy) {\n\t\t\tthrow new ReadFailedError(\n\t\t\t\t{ kind: 'rate_limited', retryAfterMs: BUSY_RETRY_AFTER_MS },\n\t\t\t\tnew ScopeBusyError(BUSY_RETRY_AFTER_MS)\n\t\t\t)\n\t\t}\n\t\tconst fresh = await coalesce(key, () =>\n\t\t\tfetchFor(priority, (signal) => budget.take(scope, signal))\n\t\t)\n\t\treturn kept(fresh, 'source')\n\t}\n\n\t/**\n\t * A window from a closed day into today, on a source that bounds today's answers, read as its\n\t * closed days (kept for the aggregate TTL) and today (re-read as often as today's TTL asks).\n\t */\n\tconst keepSplit = async (\n\t\tadapter: AnalyticsAdapter,\n\t\tprepared: Prepared,\n\t\toptions: ReadOptions\n\t): Promise<Kept | undefined> => {\n\t\tif (adapter.capabilities.recommendedTtl.today === undefined) {\n\t\t\treturn undefined\n\t\t}\n\t\tconst { q } = prepared\n\t\tconst split = splitAtToday(q, todayStart(q))\n\t\tif (!split) {\n\t\t\treturn undefined\n\t\t}\n\t\tconst { timeframe: _whole, ...partOptions } = options\n\t\tconst keepPart = async (part: AnalyticsQuery): Promise<Kept> =>\n\t\t\tkeep(adapter, await prepare(adapter, part, prepared.epochs), partOptions)\n\t\tconst [closedPart, todayPart] = await Promise.all([\n\t\t\tkeepPart(split.closed),\n\t\t\tkeepPart(split.today),\n\t\t])\n\t\tconst from: ReadOrigin =\n\t\t\tclosedPart.from === 'source' || todayPart.from === 'source'\n\t\t\t\t? 'source'\n\t\t\t\t: closedPart.from === 'stale' || todayPart.from === 'stale'\n\t\t\t\t\t? 'stale'\n\t\t\t\t\t: todayPart.from\n\t\treturn { q, result: mergeAtToday(closedPart.result, todayPart.result, q), from }\n\t}\n\n\treturn {\n\t\tasync read(adapter, query, options = {}) {\n\t\t\tconst startedAt = timerNow()\n\t\t\topts.onRead?.()\n\t\t\tif (!adapter.isConfigured()) return emptyResult(adapter.id, now())\n\t\t\tcheckFilters(adapter, query)\n\t\t\tconst prepared = await prepare(adapter, query)\n\t\t\tconst found =\n\t\t\t\t(await keepSplit(adapter, prepared, options)) ?? (await keep(adapter, prepared, options))\n\t\t\treturn options.afterRead === false ? found.result : answered({ adapter, ...found, startedAt })\n\t\t},\n\n\t\tasync refresh(adapter, query, options) {\n\t\t\tif (!adapter.isConfigured()) {\n\t\t\t\treturn 'fresh'\n\t\t\t}\n\t\t\tcheckFilters(adapter, query)\n\t\t\tconst prepared = await prepare(adapter, query)\n\t\t\tconst entry = await cached(prepared.key)\n\t\t\tif (entry && entry.expiresAt - now() > options.freshForMs) {\n\t\t\t\treturn 'fresh'\n\t\t\t}\n\t\t\tawait coalesce(prepared.key, () =>\n\t\t\t\tfetchFresh(adapter, prepared, {\n\t\t\t\t\tpriority: options.priority ?? 'background',\n\t\t\t\t\tawaitStore: true,\n\t\t\t\t})\n\t\t\t)\n\t\t\treturn 'refreshed'\n\t\t},\n\t\tasync peek(adapter, query, options = {}) {\n\t\t\tconst startedAt = timerNow()\n\t\t\tif (!adapter.isConfigured()) return emptyResult(adapter.id, now())\n\t\t\tcheckFilters(adapter, query)\n\t\t\tconst look = async (): Promise<Kept | null> => {\n\t\t\t\tconst prepared = await prepare(adapter, query)\n\t\t\t\tconst { key, q } = prepared\n\t\t\t\tconst memoized = memo.get(key)\n\t\t\t\tif (memoized) {\n\t\t\t\t\treturn { q, result: memoized, from: 'memory' }\n\t\t\t\t}\n\t\t\t\tconst entry = await cached(key)\n\t\t\t\tconst at = now()\n\t\t\t\tif (!entry || entry.staleUntil <= at) {\n\t\t\t\t\treturn null\n\t\t\t\t}\n\t\t\t\tif (entry.expiresAt > at) {\n\t\t\t\t\tmemoizeEntry(key, entry, at)\n\t\t\t\t\treturn { q, result: entry.value, from: 'store' }\n\t\t\t\t}\n\t\t\t\tconst failure = failures.get(key)\n\t\t\t\tif (failure?.kind === 'invalid_param') {\n\t\t\t\t\treturn null\n\t\t\t\t}\n\t\t\t\tconst result = staleResult(\n\t\t\t\t\tentry,\n\t\t\t\t\tsourceErrorOf(failure, lanes.for(adapter, q.scope ?? null).health())\n\t\t\t\t)\n\t\t\t\treturn { q, result, from: 'stale' }\n\t\t\t}\n\t\t\t// A store or an epoch lookup that fails is a miss like any other: the caller reads instead.\n\t\t\tconst found = await withinBudget(look(), options.budgetMs ?? PEEK_BUDGET_MS).catch(() => null)\n\t\t\treturn found && found !== OVER_BUDGET ? answered({ adapter, ...found, startedAt }) : undefined\n\t\t},\n\t\tasync realtime(adapter, query) {\n\t\t\tconst realtime = adapter.realtime\n\t\t\tif (!realtime) {\n\t\t\t\tthrow new Error(`analytics: the \"${adapter.id}\" source counts no live visitors`)\n\t\t\t}\n\t\t\tconst scope = query.scope ?? null\n\t\t\ttry {\n\t\t\t\treturn await withinTimeout(({ signal, deadline }) =>\n\t\t\t\t\tthroughLane(adapter, (ctx) => realtime.call(adapter, query, ctx), {\n\t\t\t\t\t\tsignal,\n\t\t\t\t\t\tpriority: 'interactive',\n\t\t\t\t\t\tdeadline,\n\t\t\t\t\t\tscope,\n\t\t\t\t\t})\n\t\t\t\t)\n\t\t\t} catch (err) {\n\t\t\t\tif (!isLaneRefused(err)) {\n\t\t\t\t\topts.onError?.(err, adapter.id)\n\t\t\t\t}\n\t\t\t\tthrow new ReadFailedError(\n\t\t\t\t\twithLaneRetryAfter(classifyError(err), lanes.for(adapter, scope).health()),\n\t\t\t\t\terr\n\t\t\t\t)\n\t\t\t}\n\t\t},\n\t\tidle,\n\t\tkeep(work) {\n\t\t\tinBackground(work)\n\t\t},\n\t\tasync close() {\n\t\t\tclosed = true\n\t\t\tawait idle()\n\t\t},\n\t\thealth(adapter, scope) {\n\t\t\treturn lanes.for(adapter, scope ?? null).health()\n\t\t},\n\t}\n}\n"],"mappings":"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"}
@@ -1,51 +1,95 @@
1
+ import { currentTime } from "../core/clock.js";
2
+ import { remember } from "./bounded.js";
1
3
  //#region src/surfacing/epoch.ts
2
4
  const DEFAULT_MEMO_MS = 1e4;
5
+ /** Scopes one fallback remembers a last good epoch for, before it forgets them all at once. */
6
+ const FALLBACK_SCOPES = 1e4;
7
+ /** A token no read has keyed on before: `<base36 time>-<8 random hex>`. */
8
+ const freshToken = (at) => `${at.toString(36)}-${crypto.randomUUID().slice(0, 8)}`;
9
+ const createEpochFallback = (now = currentTime) => {
10
+ const good = /* @__PURE__ */ new Map();
11
+ const outages = /* @__PURE__ */ new Map();
12
+ const keyOf = (scope) => scope ?? "";
13
+ const outage = (scope) => {
14
+ const key = keyOf(scope);
15
+ const known = outages.get(key);
16
+ if (known !== void 0) return known;
17
+ if (outages.size >= FALLBACK_SCOPES) outages.clear();
18
+ const token = `outage-${freshToken(now())}`;
19
+ outages.set(key, token);
20
+ return token;
21
+ };
22
+ return {
23
+ read(scope, epoch) {
24
+ const key = keyOf(scope);
25
+ if (good.size >= FALLBACK_SCOPES && !good.has(key)) good.clear();
26
+ good.set(key, epoch);
27
+ outages.delete(key);
28
+ return epoch;
29
+ },
30
+ failed: (scope) => good.get(keyOf(scope)) ?? outage(scope),
31
+ outage
32
+ };
33
+ };
34
+ /** Both epochs a scope's cache keys carry right now. */
35
+ const epochsFor = async (sources, scope) => {
36
+ const [config, refresh] = await Promise.all([sources.config?.(scope) ?? "0", sources.refresh?.get(scope) ?? "0"]);
37
+ return {
38
+ config,
39
+ refresh
40
+ };
41
+ };
3
42
  /**
4
- * KV key for a scope's token. A null, undefined or empty scope is the install-wide token;
5
- * every other scope, the platform wildcard included, is keyed under its own `s:` prefix, so
6
- * a scope literally named `global` cannot reach the install-wide token. The scope is encoded
7
- * so no value can forge another key.
43
+ * A scope's key under `prefix`; an empty scope is install-wide. Every other scope is encoded under
44
+ * an `s:` prefix, so no scope name (`global` included) can reach or forge another's key.
8
45
  */
9
- const epochKeyFor = (scope) => scope === null || scope === void 0 || scope === "" ? "analytics:epoch:global" : `analytics:epoch:s:${encodeURIComponent(scope)}`;
46
+ const scopedKey = (prefix, scope) => scope === null || scope === void 0 || scope === "" ? `${prefix}:global` : `${prefix}:s:${encodeURIComponent(scope)}`;
47
+ /** KV key for a scope's refresh token. */
48
+ const epochKeyFor = (scope) => scopedKey("analytics:epoch", scope);
49
+ /** KV key for a scope's configuration token, keyed as {@link epochKeyFor} keys the refresh one. */
50
+ const configEpochKeyFor = (scope) => scopedKey("analytics:config-epoch", scope);
10
51
  const readValue = (stored) => {
11
52
  const value = stored?.value;
12
53
  return typeof value === "string" && value !== "" ? value : "0";
13
54
  };
55
+ /** Tokens in `payload.kv`, under the keys `keyFor` names. */
56
+ const kvEpochBackend = (payload, keyFor = epochKeyFor) => ({
57
+ get: async (scope) => readValue(await payload.kv.get(keyFor(scope))),
58
+ set: async (scope, token) => {
59
+ await payload.kv.set(keyFor(scope), { value: token });
60
+ }
61
+ });
14
62
  /**
15
- * Per-scope cache epoch in `payload.kv`. Every cached analytics read carries its scope's
16
- * token in the key, so bumping retires that scope's entries at once on every instance
17
- * without deleting anything: the old keys simply stop being asked for and expire.
18
- *
19
- * The token is opaque and a bump writes a fresh one rather than incrementing. A
20
- * read-modify-write counter can move backwards under concurrent bumps and land on a value
21
- * whose entries are still live; a value never used before is always safe, and nothing reads
22
- * the token as a count of how many changes happened.
63
+ * Per-scope cache epoch carried in every cache key, so a bump retires a scope's entries everywhere
64
+ * without deleting. Bumps write a fresh opaque token, since a counter can move backwards in a race.
23
65
  */
24
66
  function createEpochStore(payload, opts = {}) {
25
67
  const memoMs = opts.memoMs ?? DEFAULT_MEMO_MS;
26
- const now = opts.now ?? Date.now;
68
+ const now = opts.now ?? currentTime;
69
+ const backend = opts.backend ?? kvEpochBackend(payload);
27
70
  const memo = /* @__PURE__ */ new Map();
71
+ const fallback = createEpochFallback(now);
28
72
  let warned = false;
29
- const freshToken = (at) => `${at.toString(36)}-${crypto.randomUUID().slice(0, 8)}`;
30
73
  return {
31
74
  async get(scope) {
32
75
  const key = epochKeyFor(scope);
33
76
  const at = now();
34
77
  const hit = memo.get(key);
35
78
  if (hit && hit.expiresAt > at) return hit.value;
36
- let value = "0";
79
+ let value;
37
80
  try {
38
- value = readValue(await payload.kv.get(key));
81
+ value = fallback.read(scope, await backend.get(scope));
39
82
  } catch (err) {
83
+ value = fallback.failed(scope);
40
84
  if (!warned) {
41
85
  warned = true;
42
- payload.logger?.warn(`analytics: cache epoch read failed, falling back to epoch 0: ${String(err)}`);
86
+ payload.logger?.warn(`analytics: cache epoch read failed, falling back to the last epoch this instance read: ${String(err)}`);
43
87
  }
44
88
  }
45
- memo.set(key, {
89
+ remember(memo, [key, {
46
90
  value,
47
91
  expiresAt: at + memoMs
48
- });
92
+ }]);
49
93
  return value;
50
94
  },
51
95
  async bump(scope) {
@@ -53,20 +97,20 @@ function createEpochStore(payload, opts = {}) {
53
97
  const at = now();
54
98
  const next = freshToken(at);
55
99
  try {
56
- await payload.kv.set(key, { value: next });
57
- memo.set(key, {
58
- value: next,
100
+ await backend.set(scope, next);
101
+ remember(memo, [key, {
102
+ value: fallback.read(scope, next),
59
103
  expiresAt: at + memoMs
60
- });
104
+ }]);
61
105
  return next;
62
106
  } catch (err) {
63
- payload.logger?.warn(`analytics: cache epoch bump failed for "${key}": ${String(err)}`);
107
+ payload.logger?.warn(`analytics: cache epoch bump failed for scope "${scope || "global"}": ${String(err)}`);
64
108
  throw err;
65
109
  }
66
110
  }
67
111
  };
68
112
  }
69
113
  //#endregion
70
- export { createEpochStore, epochKeyFor };
114
+ export { configEpochKeyFor, createEpochFallback, createEpochStore, epochKeyFor, epochsFor, kvEpochBackend };
71
115
 
72
116
  //# sourceMappingURL=epoch.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"epoch.js","names":[],"sources":["../../src/surfacing/epoch.ts"],"sourcesContent":["import type { Payload } from 'payload'\n\nexport interface EpochStore {\n\t/** The scope's current epoch token, served from an in-process memo inside the window. */\n\tget(scope?: string | null): Promise<string>\n\t/** Retires the scope's cached reads by storing a token nothing has used before. */\n\tbump(scope?: string | null): Promise<string>\n}\n\nexport interface EpochStoreOptions {\n\t/** How long a read epoch is trusted in process; the upper bound on bump propagation. */\n\tmemoMs?: number\n\tnow?: () => number\n}\n\nconst DEFAULT_MEMO_MS = 10_000\n\n/** The token a scope reads as until something bumps it, and after an unreadable get. */\nexport const INITIAL_EPOCH = '0'\n\n/**\n * KV key for a scope's token. A null, undefined or empty scope is the install-wide token;\n * every other scope, the platform wildcard included, is keyed under its own `s:` prefix, so\n * a scope literally named `global` cannot reach the install-wide token. The scope is encoded\n * so no value can forge another key.\n */\nexport const epochKeyFor = (scope?: string | null): string =>\n\tscope === null || scope === undefined || scope === ''\n\t\t? 'analytics:epoch:global'\n\t\t: `analytics:epoch:s:${encodeURIComponent(scope)}`\n\ninterface StoredEpoch {\n\tvalue: string\n}\n\nconst readValue = (stored: StoredEpoch | null): string => {\n\tconst value = stored?.value\n\treturn typeof value === 'string' && value !== '' ? value : INITIAL_EPOCH\n}\n\n/**\n * Per-scope cache epoch in `payload.kv`. Every cached analytics read carries its scope's\n * token in the key, so bumping retires that scope's entries at once on every instance\n * without deleting anything: the old keys simply stop being asked for and expire.\n *\n * The token is opaque and a bump writes a fresh one rather than incrementing. A\n * read-modify-write counter can move backwards under concurrent bumps and land on a value\n * whose entries are still live; a value never used before is always safe, and nothing reads\n * the token as a count of how many changes happened.\n */\nexport function createEpochStore(payload: Payload, opts: EpochStoreOptions = {}): EpochStore {\n\tconst memoMs = opts.memoMs ?? DEFAULT_MEMO_MS\n\tconst now = opts.now ?? Date.now\n\tconst memo = new Map<string, { value: string; expiresAt: number }>()\n\tlet warned = false\n\n\tconst freshToken = (at: number): string => `${at.toString(36)}-${crypto.randomUUID().slice(0, 8)}`\n\n\treturn {\n\t\tasync get(scope) {\n\t\t\tconst key = epochKeyFor(scope)\n\t\t\tconst at = now()\n\t\t\tconst hit = memo.get(key)\n\t\t\tif (hit && hit.expiresAt > at) {\n\t\t\t\treturn hit.value\n\t\t\t}\n\t\t\tlet value = INITIAL_EPOCH\n\t\t\ttry {\n\t\t\t\tvalue = readValue(await payload.kv.get<StoredEpoch>(key))\n\t\t\t} catch (err) {\n\t\t\t\t// A read must never fail over an unreachable token. The failure is memoized like a\n\t\t\t\t// hit, so a broken KV is asked once per window rather than once per read; for that\n\t\t\t\t// window this instance may serve entries written before the last bump.\n\t\t\t\tif (!warned) {\n\t\t\t\t\twarned = true\n\t\t\t\t\tpayload.logger?.warn(\n\t\t\t\t\t\t`analytics: cache epoch read failed, falling back to epoch ${INITIAL_EPOCH}: ${String(err)}`\n\t\t\t\t\t)\n\t\t\t\t}\n\t\t\t}\n\t\t\tmemo.set(key, { value, expiresAt: at + memoMs })\n\t\t\treturn value\n\t\t},\n\t\tasync bump(scope) {\n\t\t\tconst key = epochKeyFor(scope)\n\t\t\tconst at = now()\n\t\t\tconst next = freshToken(at)\n\t\t\ttry {\n\t\t\t\tawait payload.kv.set(key, { value: next })\n\t\t\t\tmemo.set(key, { value: next, expiresAt: at + memoMs })\n\t\t\t\treturn next\n\t\t\t} catch (err) {\n\t\t\t\t// Rethrown, unlike a failed get: a caller asking to invalidate has to learn that\n\t\t\t\t// the old numbers are still being served.\n\t\t\t\tpayload.logger?.warn(`analytics: cache epoch bump failed for \"${key}\": ${String(err)}`)\n\t\t\t\tthrow err\n\t\t\t}\n\t\t},\n\t}\n}\n"],"mappings":";AAeA,MAAM,kBAAkB;;;;;;;AAWxB,MAAa,eAAe,UAC3B,UAAU,QAAQ,UAAU,KAAA,KAAa,UAAU,KAChD,2BACA,qBAAqB,mBAAmB,KAAK;AAMjD,MAAM,aAAa,WAAuC;CACzD,MAAM,QAAQ,QAAQ;CACtB,OAAO,OAAO,UAAU,YAAY,UAAU,KAAK,QAAA;AACpD;;;;;;;;;;;AAYA,SAAgB,iBAAiB,SAAkB,OAA0B,CAAC,GAAe;CAC5F,MAAM,SAAS,KAAK,UAAU;CAC9B,MAAM,MAAM,KAAK,OAAO,KAAK;CAC7B,MAAM,uBAAO,IAAI,IAAkD;CACnE,IAAI,SAAS;CAEb,MAAM,cAAc,OAAuB,GAAG,GAAG,SAAS,EAAE,EAAE,GAAG,OAAO,WAAW,EAAE,MAAM,GAAG,CAAC;CAE/F,OAAO;EACN,MAAM,IAAI,OAAO;GAChB,MAAM,MAAM,YAAY,KAAK;GAC7B,MAAM,KAAK,IAAI;GACf,MAAM,MAAM,KAAK,IAAI,GAAG;GACxB,IAAI,OAAO,IAAI,YAAY,IAC1B,OAAO,IAAI;GAEZ,IAAI,QAAA;GACJ,IAAI;IACH,QAAQ,UAAU,MAAM,QAAQ,GAAG,IAAiB,GAAG,CAAC;GACzD,SAAS,KAAK;IAIb,IAAI,CAAC,QAAQ;KACZ,SAAS;KACT,QAAQ,QAAQ,KACf,gEAA+E,OAAO,GAAG,GAC1F;IACD;GACD;GACA,KAAK,IAAI,KAAK;IAAE;IAAO,WAAW,KAAK;GAAO,CAAC;GAC/C,OAAO;EACR;EACA,MAAM,KAAK,OAAO;GACjB,MAAM,MAAM,YAAY,KAAK;GAC7B,MAAM,KAAK,IAAI;GACf,MAAM,OAAO,WAAW,EAAE;GAC1B,IAAI;IACH,MAAM,QAAQ,GAAG,IAAI,KAAK,EAAE,OAAO,KAAK,CAAC;IACzC,KAAK,IAAI,KAAK;KAAE,OAAO;KAAM,WAAW,KAAK;IAAO,CAAC;IACrD,OAAO;GACR,SAAS,KAAK;IAGb,QAAQ,QAAQ,KAAK,2CAA2C,IAAI,KAAK,OAAO,GAAG,GAAG;IACtF,MAAM;GACP;EACD;CACD;AACD"}
1
+ {"version":3,"file":"epoch.js","names":[],"sources":["../../src/surfacing/epoch.ts"],"sourcesContent":["import type { Payload } from 'payload'\nimport type { CacheKeyEpochs } from '../core/cacheKey'\nimport { currentTime } from '../core/clock'\nimport { remember } from './bounded'\n\nexport interface EpochStore {\n\t/** The scope's current epoch token, served from an in-process memo inside the window. */\n\tget(scope?: string | null): Promise<string>\n\t/** Retires the scope's cached reads by storing a token nothing has used before. */\n\tbump(scope?: string | null): Promise<string>\n}\n\nexport interface EpochStoreOptions {\n\t/** How long a read epoch is trusted in process; the upper bound on bump propagation. */\n\tmemoMs?: number\n\tnow?: () => number\n\t/** Where the tokens are kept; `payload.kv` under {@link epochKeyFor} by default. */\n\tbackend?: EpochBackend\n}\n\nconst DEFAULT_MEMO_MS = 10_000\n\n/** The token a scope reads as until something bumps it. */\nexport const INITIAL_EPOCH = '0'\n\n/** The configuration epoch of a scope on an install whose providers and goals live in code. */\nexport const FIXED_CONFIG_EPOCH = '0'\n\n/** Scopes one fallback remembers a last good epoch for, before it forgets them all at once. */\nconst FALLBACK_SCOPES = 10_000\n\n/** A token no read has keyed on before: `<base36 time>-<8 random hex>`. */\nconst freshToken = (at: number): string => `${at.toString(36)}-${crypto.randomUUID().slice(0, 8)}`\n\n/**\n * What a scope keys on while its epoch is unreadable: its last epoch read here, else one token per\n * outage. Never a constant shared across outages, which would mix two configurations' numbers.\n */\nexport interface EpochFallback {\n\t/** Records `epoch`, read now, as the scope's last good one and ends its outage; answers it. */\n\tread(scope: string | null | undefined, epoch: string): string\n\t/** The scope's last good epoch, else its outage's token. */\n\tfailed(scope: string | null | undefined): string\n\t/** The scope's outage's token alone: for answers built differently while the read fails. */\n\toutage(scope: string | null | undefined): string\n}\n\nexport const createEpochFallback = (now: () => number = currentTime): EpochFallback => {\n\tconst good = new Map<string, string>()\n\tconst outages = new Map<string, string>()\n\tconst keyOf = (scope: string | null | undefined): string => scope ?? ''\n\tconst outage = (scope: string | null | undefined): string => {\n\t\tconst key = keyOf(scope)\n\t\tconst known = outages.get(key)\n\t\tif (known !== undefined) {\n\t\t\treturn known\n\t\t}\n\t\tif (outages.size >= FALLBACK_SCOPES) {\n\t\t\toutages.clear()\n\t\t}\n\t\tconst token = `outage-${freshToken(now())}`\n\t\toutages.set(key, token)\n\t\treturn token\n\t}\n\treturn {\n\t\tread(scope, epoch) {\n\t\t\tconst key = keyOf(scope)\n\t\t\tif (good.size >= FALLBACK_SCOPES && !good.has(key)) {\n\t\t\t\tgood.clear()\n\t\t\t}\n\t\t\tgood.set(key, epoch)\n\t\t\toutages.delete(key)\n\t\t\treturn epoch\n\t\t},\n\t\tfailed: (scope) => good.get(keyOf(scope)) ?? outage(scope),\n\t\toutage,\n\t}\n}\n\n/** Where a scope's two key epochs come from; either left out reads as its fixed starting value. */\nexport interface EpochSources {\n\trefresh?: Pick<EpochStore, 'get'>\n\t/** The scope's provider and goal configuration epoch. */\n\tconfig?: (scope?: string | null) => Promise<string>\n}\n\n/** Both epochs a scope's cache keys carry right now. */\nexport const epochsFor = async (\n\tsources: EpochSources,\n\tscope?: string | null\n): Promise<CacheKeyEpochs> => {\n\tconst [config, refresh] = await Promise.all([\n\t\tsources.config?.(scope) ?? FIXED_CONFIG_EPOCH,\n\t\tsources.refresh?.get(scope) ?? INITIAL_EPOCH,\n\t])\n\treturn { config, refresh }\n}\n\n/**\n * A scope's key under `prefix`; an empty scope is install-wide. Every other scope is encoded under\n * an `s:` prefix, so no scope name (`global` included) can reach or forge another's key.\n */\nconst scopedKey = (prefix: string, scope?: string | null): string =>\n\tscope === null || scope === undefined || scope === ''\n\t\t? `${prefix}:global`\n\t\t: `${prefix}:s:${encodeURIComponent(scope)}`\n\n/** KV key for a scope's refresh token. */\nexport const epochKeyFor = (scope?: string | null): string => scopedKey('analytics:epoch', scope)\n\n/** KV key for a scope's configuration token, keyed as {@link epochKeyFor} keys the refresh one. */\nexport const configEpochKeyFor = (scope?: string | null): string =>\n\tscopedKey('analytics:config-epoch', scope)\n\ninterface StoredEpoch {\n\tvalue: string\n}\n\nconst readValue = (stored: StoredEpoch | null): string => {\n\tconst value = stored?.value\n\treturn typeof value === 'string' && value !== '' ? value : INITIAL_EPOCH\n}\n\n/** Where a store keeps each scope's token. */\nexport interface EpochBackend {\n\t/** The scope's token, the initial one while none was ever stored. */\n\tget(scope?: string | null): Promise<string>\n\tset(scope: string | null | undefined, token: string): Promise<void>\n}\n\n/** Tokens in `payload.kv`, under the keys `keyFor` names. */\nexport const kvEpochBackend = (\n\tpayload: Payload,\n\tkeyFor: (scope?: string | null) => string = epochKeyFor\n): EpochBackend => ({\n\tget: async (scope) => readValue(await payload.kv.get<StoredEpoch>(keyFor(scope))),\n\tset: async (scope, token) => {\n\t\tawait payload.kv.set(keyFor(scope), { value: token })\n\t},\n})\n\n/**\n * Per-scope cache epoch carried in every cache key, so a bump retires a scope's entries everywhere\n * without deleting. Bumps write a fresh opaque token, since a counter can move backwards in a race.\n */\nexport function createEpochStore(payload: Payload, opts: EpochStoreOptions = {}): EpochStore {\n\tconst memoMs = opts.memoMs ?? DEFAULT_MEMO_MS\n\tconst now = opts.now ?? currentTime\n\tconst backend = opts.backend ?? kvEpochBackend(payload)\n\tconst memo = new Map<string, { value: string; expiresAt: number }>()\n\tconst fallback = createEpochFallback(now)\n\tlet warned = false\n\n\treturn {\n\t\tasync get(scope) {\n\t\t\tconst key = epochKeyFor(scope)\n\t\t\tconst at = now()\n\t\t\tconst hit = memo.get(key)\n\t\t\tif (hit && hit.expiresAt > at) {\n\t\t\t\treturn hit.value\n\t\t\t}\n\t\t\tlet value: string\n\t\t\ttry {\n\t\t\t\tvalue = fallback.read(scope, await backend.get(scope))\n\t\t\t} catch (err) {\n\t\t\t\t// A read never fails over an unreachable token; the failure is memoized like a hit, so a\n\t\t\t\t// broken store is asked once per window, not once per read.\n\t\t\t\tvalue = fallback.failed(scope)\n\t\t\t\tif (!warned) {\n\t\t\t\t\twarned = true\n\t\t\t\t\tpayload.logger?.warn(\n\t\t\t\t\t\t`analytics: cache epoch read failed, falling back to the last epoch this instance read: ${String(err)}`\n\t\t\t\t\t)\n\t\t\t\t}\n\t\t\t}\n\t\t\tremember(memo, [key, { value, expiresAt: at + memoMs }])\n\t\t\treturn value\n\t\t},\n\t\tasync bump(scope) {\n\t\t\tconst key = epochKeyFor(scope)\n\t\t\tconst at = now()\n\t\t\tconst next = freshToken(at)\n\t\t\ttry {\n\t\t\t\tawait backend.set(scope, next)\n\t\t\t\tremember(memo, [key, { value: fallback.read(scope, next), expiresAt: at + memoMs }])\n\t\t\t\treturn next\n\t\t\t} catch (err) {\n\t\t\t\t// Rethrown, unlike a failed get: a caller asking to invalidate has to learn that\n\t\t\t\t// the old numbers are still being served.\n\t\t\t\tpayload.logger?.warn(\n\t\t\t\t\t`analytics: cache epoch bump failed for scope \"${scope || 'global'}\": ${String(err)}`\n\t\t\t\t)\n\t\t\t\tthrow err\n\t\t\t}\n\t\t},\n\t}\n}\n"],"mappings":"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"}
@@ -0,0 +1 @@
1
+ export { };
@@ -0,0 +1,297 @@
1
+ import { recallOr } from "./bounded.js";
2
+ import { monotonicMs } from "../core/monotonic.js";
3
+ import { BREAKER_MAX_MS, createBreaker } from "./breaker.js";
4
+ import { LaneRefusedError, classifyError, isLaneRefused } from "./classifyError.js";
5
+ import { createTokenSource, mostUrgent } from "./rateLimiter.js";
6
+ /** Reads in flight on a local source (native), which stays outside the global cap. */
7
+ const DEFAULT_LOCAL_CONCURRENCY = 8;
8
+ /** The fewest and most native reads in flight when the lane is sized from a Postgres pool. */
9
+ const MIN_POOLED_CONCURRENCY = 1;
10
+ /**
11
+ * Native lane size on a host Postgres pool of `poolMax`: a third, capped at the engine's long-work
12
+ * share, so reads queue in the lane (deadline and priority aware), not unseen for a connection.
13
+ */
14
+ const pooledConcurrency = (poolMax) => Math.min(8, Math.max(MIN_POOLED_CONCURRENCY, Math.floor(poolMax / 3)));
15
+ /** The slots one scope may hold at once in a lane every scope shares: half, rounded up. */
16
+ const scopeShareOf = (capacity) => Math.max(1, Math.ceil(capacity / 2));
17
+ /** Retries of an upstream request that failed as `unavailable`, with backoff between them. */
18
+ const MAX_RETRIES = 2;
19
+ /**
20
+ * How long a request may stay out after its signal aborted before its slots are given back: one
21
+ * that honours the signal settles at once, and GA4's own gRPC deadline ends with the read.
22
+ */
23
+ const ABANDON_AFTER_MS = 5e3;
24
+ /** The install-wide scope (null) is keyed `''`; it never counts against a scope's share. */
25
+ const UNSCOPED = "";
26
+ const scopeKeyOf = (scope) => scope === null || scope === void 0 ? UNSCOPED : `s:${scope}`;
27
+ /**
28
+ * A counting semaphore serving the most urgent waiter first, never more than `backgroundCap` slots
29
+ * to background work, and, given a `scopeCap`, never more than that many to one scope.
30
+ */
31
+ const createSlots = (capacity, backgroundCap, scopeCap) => {
32
+ let active = 0;
33
+ let background = 0;
34
+ const waiters = [];
35
+ const heldBy = /* @__PURE__ */ new Map();
36
+ const withinShare = (waiter) => scopeCap === void 0 || waiter.scope === UNSCOPED || (heldBy.get(waiter.scope) ?? 0) < scopeCap;
37
+ const pick = () => mostUrgent(waiters.filter((waiter) => withinShare(waiter) && (waiter.priority !== "background" || background < backgroundCap)));
38
+ const hold = (scope, by) => {
39
+ const next = (heldBy.get(scope) ?? 0) + by;
40
+ if (next > 0) heldBy.set(scope, next);
41
+ else heldBy.delete(scope);
42
+ };
43
+ const pump = () => {
44
+ while (active < capacity) {
45
+ const chosen = pick();
46
+ if (!chosen) return;
47
+ waiters.splice(waiters.indexOf(chosen), 1);
48
+ active++;
49
+ hold(chosen.scope, 1);
50
+ if (chosen.priority === "background") background++;
51
+ chosen.grant();
52
+ }
53
+ };
54
+ return { acquire(priority, signal, scope = UNSCOPED) {
55
+ if (signal.aborted) return Promise.reject(signal.reason);
56
+ return new Promise((resolve, reject) => {
57
+ let released = false;
58
+ const release = () => {
59
+ if (released) return;
60
+ released = true;
61
+ active--;
62
+ hold(scope, -1);
63
+ if (priority === "background") background--;
64
+ pump();
65
+ };
66
+ const onAbort = () => {
67
+ const index = waiters.indexOf(waiter);
68
+ if (index !== -1) waiters.splice(index, 1);
69
+ reject(signal.reason);
70
+ };
71
+ const waiter = {
72
+ priority,
73
+ scope,
74
+ grant: () => {
75
+ signal.removeEventListener("abort", onAbort);
76
+ resolve(release);
77
+ }
78
+ };
79
+ waiters.push(waiter);
80
+ signal.addEventListener("abort", onAbort, { once: true });
81
+ pump();
82
+ });
83
+ } };
84
+ };
85
+ /** Resolves after `ms`, or rejects with the signal's reason once it aborts. */
86
+ const sleep = (ms, signal) => {
87
+ if (signal.aborted) return Promise.reject(signal.reason);
88
+ return new Promise((resolve, reject) => {
89
+ const onAbort = () => {
90
+ clearTimeout(timer);
91
+ reject(signal.reason);
92
+ };
93
+ const timer = setTimeout(() => {
94
+ signal.removeEventListener("abort", onAbort);
95
+ resolve();
96
+ }, ms);
97
+ signal.addEventListener("abort", onAbort, { once: true });
98
+ });
99
+ };
100
+ /**
101
+ * Settles with `work`, or rejects with the signal's reason first: the slot stays held until `work`
102
+ * settles, or until {@link ABANDON_AFTER_MS} after the abort for work that never does.
103
+ */
104
+ const untilAborted = (work, signal) => {
105
+ if (signal.aborted) return Promise.reject(signal.reason);
106
+ let onAbort;
107
+ const aborted = new Promise((_resolve, reject) => {
108
+ onAbort = () => reject(signal.reason);
109
+ signal.addEventListener("abort", onAbort, { once: true });
110
+ });
111
+ return Promise.race([work, aborted]).finally(() => {
112
+ if (onAbort) signal.removeEventListener("abort", onAbort);
113
+ });
114
+ };
115
+ const noRelease = () => {};
116
+ /** What a request that ignored its abort counts as against the breaker. */
117
+ const ABANDONED = {
118
+ kind: "unavailable",
119
+ timeout: true
120
+ };
121
+ /** A breaker with nothing to remember: closed, no failure counted since its last answer. */
122
+ const isClean = (breaker) => {
123
+ const snapshot = breaker.snapshot();
124
+ return snapshot.state === "closed" && snapshot.lastFailure === void 0;
125
+ };
126
+ /** One adapter's pause, tokens and slots, and one breaker per scope reading through them. */
127
+ const createLaneCore = (setup) => {
128
+ const { now } = setup;
129
+ const tokens = createTokenSource(setup.adapter.capabilities.rateLimit, now);
130
+ const slots = createSlots(setup.capacity, Math.max(1, Math.floor(setup.capacity / 2)), setup.shared ? scopeShareOf(setup.capacity) : void 0);
131
+ const breakers = /* @__PURE__ */ new Map();
132
+ const views = /* @__PURE__ */ new Map();
133
+ let pausedUntil = 0;
134
+ let abandoned = 0;
135
+ const breakerOf = (key) => recallOr(breakers, [key, () => createBreaker({
136
+ now,
137
+ ...setup.breaker
138
+ })], (breaker) => !isClean(breaker));
139
+ const waitOutPause = async (options) => {
140
+ for (;;) {
141
+ const pausedFor = pausedUntil - now();
142
+ if (pausedFor <= 0) return;
143
+ if (options.deadline !== void 0 && pausedUntil > options.deadline) throw new LaneRefusedError("paused", pausedFor);
144
+ await sleep(pausedFor, options.signal);
145
+ }
146
+ };
147
+ const viewOf = (key) => ({
148
+ async run(fn, options) {
149
+ const { signal, priority } = options;
150
+ if (signal.aborted) throw signal.reason;
151
+ const breaker = breakerOf(key);
152
+ const refusedOpen = (retryAfterMs) => new LaneRefusedError("open", retryAfterMs, breaker.snapshot().lastFailure);
153
+ const peek = breaker.peek();
154
+ if (!peek.ok) throw refusedOpen(peek.retryAfterMs);
155
+ const claimed = peek.probe ? breaker.admit() : void 0;
156
+ if (claimed && !claimed.ok) throw refusedOpen(claimed.retryAfterMs);
157
+ let releaseLane = noRelease;
158
+ let releaseGlobal = noRelease;
159
+ const releaseSlots = () => {
160
+ releaseGlobal();
161
+ releaseLane();
162
+ };
163
+ try {
164
+ await waitOutPause(options);
165
+ await tokens.take({
166
+ signal,
167
+ priority
168
+ });
169
+ releaseLane = await slots.acquire(priority, signal, key);
170
+ releaseGlobal = setup.global ? await setup.global.acquire(priority, signal) : noRelease;
171
+ } catch (err) {
172
+ releaseSlots();
173
+ if (claimed?.probe) breaker.release();
174
+ throw err;
175
+ }
176
+ const admission = claimed ?? breaker.admit();
177
+ if (!admission.ok) {
178
+ releaseSlots();
179
+ throw refusedOpen(admission.retryAfterMs);
180
+ }
181
+ let counted = false;
182
+ const record = (outcome) => {
183
+ if (!counted) {
184
+ counted = true;
185
+ breaker.record(outcome, admission.probe);
186
+ }
187
+ };
188
+ const settled = (async () => fn(signal))().then((value) => {
189
+ record("success");
190
+ return value;
191
+ }, (err) => {
192
+ const failure = classifyError(err);
193
+ record(failure);
194
+ if (failure.kind === "unavailable" && failure.retryAfterMs !== void 0) pausedUntil = Math.max(pausedUntil, now() + Math.min(failure.retryAfterMs, BREAKER_MAX_MS));
195
+ throw err;
196
+ });
197
+ let abandonTimer;
198
+ const abandon = () => {
199
+ abandonTimer = setTimeout(() => {
200
+ releaseSlots();
201
+ record(ABANDONED);
202
+ abandoned++;
203
+ if (abandoned === 1) setup.onAbandon?.(setup.adapter);
204
+ }, setup.abandonAfterMs);
205
+ abandonTimer.unref?.();
206
+ };
207
+ if (signal.aborted) abandon();
208
+ else signal.addEventListener("abort", abandon, { once: true });
209
+ const done = settled.finally(() => {
210
+ signal.removeEventListener("abort", abandon);
211
+ clearTimeout(abandonTimer);
212
+ releaseSlots();
213
+ });
214
+ done.catch(() => {});
215
+ return untilAborted(done, signal);
216
+ },
217
+ health() {
218
+ const breaker = breakers.get(key);
219
+ const snapshot = breaker?.snapshot();
220
+ const peek = breaker?.peek() ?? {
221
+ ok: true,
222
+ probe: false
223
+ };
224
+ const pausedFor = pausedUntil - now();
225
+ const retryAfterMs = Math.max(peek.ok ? 0 : peek.retryAfterMs, pausedFor > 0 ? pausedFor : 0);
226
+ const last = snapshot?.lastFailure;
227
+ return {
228
+ open: !peek.ok,
229
+ ...retryAfterMs > 0 ? { retryAfterMs } : {},
230
+ ...last ? { lastFailure: last.kind } : {},
231
+ ...last?.hostRefused ? { hostRefused: true } : {},
232
+ ...abandoned > 0 ? { abandoned } : {}
233
+ };
234
+ }
235
+ });
236
+ return (scope) => {
237
+ const key = scopeKeyOf(scope);
238
+ return recallOr(views, [key, () => viewOf(key)]);
239
+ };
240
+ };
241
+ /**
242
+ * One lane per adapter object, so a re-saved provider starts fresh. Vendor lanes share the global
243
+ * slots; local (native) lanes do not, so a slow vendor never queues the plugin's own reads.
244
+ */
245
+ const createLanes = (options = {}) => {
246
+ const now = options.now ?? monotonicMs;
247
+ const globalCapacity = options.global ?? 16;
248
+ const global = createSlots(globalCapacity, globalCapacity);
249
+ const cores = /* @__PURE__ */ new WeakMap();
250
+ const lanesById = /* @__PURE__ */ new Map();
251
+ const coreFor = (adapter) => {
252
+ const local = options.local?.is(adapter) === true;
253
+ const declared = adapter.capabilities.rateLimit?.maxConcurrent;
254
+ const fallback = local ? options.local?.capacity ?? DEFAULT_LOCAL_CONCURRENCY : options.perSource ?? 4;
255
+ return createLaneCore({
256
+ adapter,
257
+ capacity: declared !== void 0 && declared > 0 ? declared : fallback,
258
+ global: local ? void 0 : global,
259
+ now,
260
+ shared: options.shared?.(adapter) === true,
261
+ ...options.breaker ? { breaker: options.breaker } : {},
262
+ abandonAfterMs: options.abandonAfterMs ?? 5e3,
263
+ ...options.onAbandon ? { onAbandon: options.onAbandon } : {}
264
+ });
265
+ };
266
+ return { for(adapter, scope) {
267
+ if (options.rebuilt?.(adapter) === true) return recallOr(lanesById, [JSON.stringify([scope ?? null, adapter.id]), () => coreFor(adapter)(scope)]);
268
+ const core = cores.get(adapter) ?? coreFor(adapter);
269
+ cores.set(adapter, core);
270
+ return core(scope);
271
+ } };
272
+ };
273
+ /**
274
+ * One upstream request, retried up to {@link MAX_RETRIES} times on a transient `unavailable` but
275
+ * never after a timeout or spent quota, nor past the deadline; a lane refusal ends it at once.
276
+ */
277
+ const runUpstream = async (lane, fn, options) => {
278
+ const base = options.baseDelayMs ?? 500;
279
+ for (let attempt = 0;; attempt++) try {
280
+ return await lane.run(fn, options);
281
+ } catch (err) {
282
+ if (isLaneRefused(err) || options.signal.aborted) throw err;
283
+ const failure = classifyError(err);
284
+ if (failure.kind !== "unavailable" || failure.timeout || failure.quota || attempt >= MAX_RETRIES) throw err;
285
+ const delay = base * 2 ** attempt + base * .5 * attempt;
286
+ if (options.deadline !== void 0 && options.now() + delay >= options.deadline) throw err;
287
+ try {
288
+ await sleep(delay, options.signal);
289
+ } catch {
290
+ throw err;
291
+ }
292
+ }
293
+ };
294
+ //#endregion
295
+ export { ABANDON_AFTER_MS, createLanes, pooledConcurrency, runUpstream };
296
+
297
+ //# sourceMappingURL=lanes.js.map