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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (1273) hide show
  1. package/CHANGELOG.md +780 -0
  2. package/LICENSE +21 -21
  3. package/README.md +35 -36
  4. package/dist/access/adminUser.d.ts +15 -0
  5. package/dist/access/adminUser.js +13 -0
  6. package/dist/access/adminUser.js.map +1 -0
  7. package/dist/access/decideOnce.js +16 -0
  8. package/dist/access/decideOnce.js.map +1 -0
  9. package/dist/access/membership.d.ts +23 -0
  10. package/dist/access/membership.js +63 -0
  11. package/dist/access/membership.js.map +1 -0
  12. package/dist/access/principal.d.ts +37 -0
  13. package/dist/access/principal.js +29 -0
  14. package/dist/access/principal.js.map +1 -0
  15. package/dist/access/readGate.js +16 -0
  16. package/dist/access/readGate.js.map +1 -0
  17. package/dist/adapters/ga4/disableKey.js +19 -0
  18. package/dist/adapters/ga4/disableKey.js.map +1 -0
  19. package/dist/adapters/ga4/eventName.d.ts +9 -0
  20. package/dist/adapters/ga4/eventName.js +13 -0
  21. package/dist/adapters/ga4/eventName.js.map +1 -0
  22. package/dist/adapters/ga4/ga4.d.ts +29 -0
  23. package/dist/adapters/ga4/ga4.js +324 -112
  24. package/dist/adapters/ga4/ga4.js.map +1 -1
  25. package/dist/adapters/ga4/measurementId.js +14 -0
  26. package/dist/adapters/ga4/measurementId.js.map +1 -0
  27. package/dist/adapters/goalRead.js +112 -0
  28. package/dist/adapters/goalRead.js.map +1 -0
  29. package/dist/adapters/http/baseUrl.js +15 -0
  30. package/dist/adapters/http/baseUrl.js.map +1 -0
  31. package/dist/adapters/http/fetchJson.d.ts +19 -0
  32. package/dist/adapters/http/fetchJson.js +27 -8
  33. package/dist/adapters/http/fetchJson.js.map +1 -1
  34. package/dist/adapters/mapping.js +52 -0
  35. package/dist/adapters/mapping.js.map +1 -0
  36. package/dist/adapters/plausible/plausible.d.ts +30 -3
  37. package/dist/adapters/plausible/plausible.js +198 -110
  38. package/dist/adapters/plausible/plausible.js.map +1 -1
  39. package/dist/adapters/plausible/scriptId.js +19 -0
  40. package/dist/adapters/plausible/scriptId.js.map +1 -0
  41. package/dist/adapters/posthog/posthog.d.ts +33 -9
  42. package/dist/adapters/posthog/posthog.js +307 -127
  43. package/dist/adapters/posthog/posthog.js.map +1 -1
  44. package/dist/adapters/posthog/projectCheck.js +56 -0
  45. package/dist/adapters/posthog/projectCheck.js.map +1 -0
  46. package/dist/adapters/readTime.js +7 -0
  47. package/dist/adapters/readTime.js.map +1 -0
  48. package/dist/adapters/series.js +14 -8
  49. package/dist/adapters/series.js.map +1 -1
  50. package/dist/adapters/umami/umami.d.ts +21 -3
  51. package/dist/adapters/umami/umami.js +334 -95
  52. package/dist/adapters/umami/umami.js.map +1 -1
  53. package/dist/adapters/upstream.js +16 -0
  54. package/dist/adapters/upstream.js.map +1 -0
  55. package/dist/binding/report.d.ts +8 -0
  56. package/dist/binding/report.js +24 -0
  57. package/dist/binding/report.js.map +1 -0
  58. package/dist/binding/resolvePath.js +28 -25
  59. package/dist/binding/resolvePath.js.map +1 -1
  60. package/dist/binding/types.d.ts +14 -29
  61. package/dist/capture/captureRequest.js +28 -0
  62. package/dist/capture/captureRequest.js.map +1 -0
  63. package/dist/capture/exclusionEndpoint.js +98 -0
  64. package/dist/capture/exclusionEndpoint.js.map +1 -0
  65. package/dist/capture/exclusionPrelude.js +14 -0
  66. package/dist/capture/exclusionPrelude.js.map +1 -0
  67. package/dist/capture/exclusionToken.js +23 -0
  68. package/dist/capture/exclusionToken.js.map +1 -0
  69. package/dist/capture/jsLiteral.js +19 -0
  70. package/dist/capture/jsLiteral.js.map +1 -0
  71. package/dist/capture/mountPath.js +2 -3
  72. package/dist/capture/mountPath.js.map +1 -1
  73. package/dist/capture/proxyEndpoint.js +49 -92
  74. package/dist/capture/proxyEndpoint.js.map +1 -1
  75. package/dist/capture/proxyRoutes.js +58 -21
  76. package/dist/capture/proxyRoutes.js.map +1 -1
  77. package/dist/capture/relay.js +91 -0
  78. package/dist/capture/relay.js.map +1 -0
  79. package/dist/capture/requestBody.js +2 -6
  80. package/dist/capture/requestBody.js.map +1 -1
  81. package/dist/capture/requestTrust.js +45 -0
  82. package/dist/capture/requestTrust.js.map +1 -0
  83. package/dist/capture/sameSite.js +40 -0
  84. package/dist/capture/sameSite.js.map +1 -0
  85. package/dist/capture/slots.js +50 -25
  86. package/dist/capture/slots.js.map +1 -1
  87. package/dist/capture/trackerConfig.js +131 -36
  88. package/dist/capture/trackerConfig.js.map +1 -1
  89. package/dist/capture/trackerEndpoint.js +22 -21
  90. package/dist/capture/trackerEndpoint.js.map +1 -1
  91. package/dist/capture/withoutConsent.js +91 -0
  92. package/dist/capture/withoutConsent.js.map +1 -0
  93. package/dist/charts/BarList.d.ts +27 -13
  94. package/dist/charts/BarList.js +38 -77
  95. package/dist/charts/BarList.js.map +1 -1
  96. package/dist/charts/TrendChart.d.ts +40 -7
  97. package/dist/charts/TrendChart.js +243 -215
  98. package/dist/charts/TrendChart.js.map +1 -1
  99. package/dist/charts/bars.d.ts +17 -1
  100. package/dist/charts/bars.js +12 -11
  101. package/dist/charts/bars.js.map +1 -1
  102. package/dist/charts/bucket.js +106 -73
  103. package/dist/charts/bucket.js.map +1 -1
  104. package/dist/charts/inProgress.js +22 -0
  105. package/dist/charts/inProgress.js.map +1 -0
  106. package/dist/charts/series.d.ts +15 -0
  107. package/dist/charts/series.js +123 -0
  108. package/dist/charts/series.js.map +1 -0
  109. package/dist/charts/spline.js +91 -25
  110. package/dist/charts/spline.js.map +1 -1
  111. package/dist/charts/trendGeometry.js +91 -0
  112. package/dist/charts/trendGeometry.js.map +1 -0
  113. package/dist/core/adminOptions.d.ts +1 -0
  114. package/dist/core/adminOptions.js +198 -0
  115. package/dist/core/adminOptions.js.map +1 -0
  116. package/dist/core/budget.js +24 -0
  117. package/dist/core/budget.js.map +1 -0
  118. package/dist/core/cacheKey.d.ts +1 -0
  119. package/dist/core/cacheKey.js +51 -29
  120. package/dist/core/cacheKey.js.map +1 -1
  121. package/dist/core/cacheOptions.js +165 -0
  122. package/dist/core/cacheOptions.js.map +1 -0
  123. package/dist/core/capabilities.d.ts +24 -11
  124. package/dist/core/capabilities.js +101 -17
  125. package/dist/core/capabilities.js.map +1 -1
  126. package/dist/core/capture.d.ts +59 -26
  127. package/dist/core/captureOptions.d.ts +1 -0
  128. package/dist/core/captureOptions.js +347 -0
  129. package/dist/core/captureOptions.js.map +1 -0
  130. package/dist/core/clock.js +13 -0
  131. package/dist/core/clock.js.map +1 -0
  132. package/dist/core/collectionOption.d.ts +17 -0
  133. package/dist/core/collectionOption.js +105 -0
  134. package/dist/core/collectionOption.js.map +1 -0
  135. package/dist/core/collectionSlug.js +7 -0
  136. package/dist/core/collectionSlug.js.map +1 -0
  137. package/dist/core/contract.d.ts +340 -49
  138. package/dist/core/contract.js +7 -4
  139. package/dist/core/contract.js.map +1 -1
  140. package/dist/core/cron.js +57 -0
  141. package/dist/core/cron.js.map +1 -0
  142. package/dist/core/fetch.d.ts +17 -0
  143. package/dist/core/goalOptions.d.ts +1 -0
  144. package/dist/core/goalOptions.js +166 -0
  145. package/dist/core/goalOptions.js.map +1 -0
  146. package/dist/core/granularity.js +3 -2
  147. package/dist/core/granularity.js.map +1 -1
  148. package/dist/core/guards.js +17 -0
  149. package/dist/core/guards.js.map +1 -0
  150. package/dist/core/jobs.d.ts +40 -0
  151. package/dist/core/jobs.js +132 -0
  152. package/dist/core/jobs.js.map +1 -0
  153. package/dist/core/legacyOptions.js +145 -0
  154. package/dist/core/legacyOptions.js.map +1 -0
  155. package/dist/core/metricAliases.js +81 -0
  156. package/dist/core/metricAliases.js.map +1 -0
  157. package/dist/core/metricValues.js +57 -0
  158. package/dist/core/metricValues.js.map +1 -0
  159. package/dist/core/monotonic.js +10 -0
  160. package/dist/core/monotonic.js.map +1 -0
  161. package/dist/core/optionChecks.js +51 -0
  162. package/dist/core/optionChecks.js.map +1 -0
  163. package/dist/core/options.d.ts +535 -151
  164. package/dist/core/options.js +158 -214
  165. package/dist/core/options.js.map +1 -1
  166. package/dist/core/registry.js +45 -5
  167. package/dist/core/registry.js.map +1 -1
  168. package/dist/core/scopeList.js +7 -9
  169. package/dist/core/scopeList.js.map +1 -1
  170. package/dist/core/scopeOptions.d.ts +1 -0
  171. package/dist/core/scopeOptions.js +114 -0
  172. package/dist/core/scopeOptions.js.map +1 -0
  173. package/dist/core/scopedRead.js +349 -36
  174. package/dist/core/scopedRead.js.map +1 -1
  175. package/dist/core/sdks.d.ts +81 -0
  176. package/dist/core/sdks.js +23 -0
  177. package/dist/core/sdks.js.map +1 -0
  178. package/dist/core/serverEvent.d.ts +50 -14
  179. package/dist/core/serverEvent.js.map +1 -1
  180. package/dist/core/siteAddress.js +20 -0
  181. package/dist/core/siteAddress.js.map +1 -0
  182. package/dist/core/sourceErrors.js +109 -0
  183. package/dist/core/sourceErrors.js.map +1 -0
  184. package/dist/core/sourceLabel.d.ts +10 -0
  185. package/dist/core/sourceLabel.js +63 -0
  186. package/dist/core/sourceLabel.js.map +1 -0
  187. package/dist/core/sourceOptions.js +107 -0
  188. package/dist/core/sourceOptions.js.map +1 -0
  189. package/dist/core/sourcePolicy.d.ts +55 -0
  190. package/dist/core/sourcePolicy.js +51 -0
  191. package/dist/core/sourcePolicy.js.map +1 -0
  192. package/dist/core/throttle.js +18 -0
  193. package/dist/core/throttle.js.map +1 -0
  194. package/dist/core/values.js +61 -0
  195. package/dist/core/values.js.map +1 -0
  196. package/dist/core/widgetSlugs.d.ts +17 -0
  197. package/dist/core/widgetSlugs.js +29 -0
  198. package/dist/core/widgetSlugs.js.map +1 -0
  199. package/dist/db/detachedWrite.js +36 -0
  200. package/dist/db/detachedWrite.js.map +1 -0
  201. package/dist/db/errors.js +182 -0
  202. package/dist/db/errors.js.map +1 -0
  203. package/dist/db/kind.js +32 -0
  204. package/dist/db/kind.js.map +1 -0
  205. package/dist/db/openTransaction.js +51 -0
  206. package/dist/db/openTransaction.js.map +1 -0
  207. package/dist/exports/adapters/contract.d.ts +15 -0
  208. package/dist/exports/adapters/ga4.d.ts +17 -1
  209. package/dist/exports/adapters/ga4.js +2 -1
  210. package/dist/exports/adapters/native.d.ts +29 -2
  211. package/dist/exports/adapters/native.js +5 -1
  212. package/dist/exports/adapters/plausible.d.ts +16 -1
  213. package/dist/exports/adapters/posthog.d.ts +16 -1
  214. package/dist/exports/adapters/umami.d.ts +16 -1
  215. package/dist/exports/attributes.d.ts +42 -0
  216. package/dist/exports/attributes.js +83 -0
  217. package/dist/exports/attributes.js.map +1 -0
  218. package/dist/exports/client.d.ts +45 -11
  219. package/dist/exports/client.js +23 -6
  220. package/dist/exports/geo.d.ts +4 -2
  221. package/dist/exports/geo.js +1 -1
  222. package/dist/exports/i18n.d.ts +2 -2
  223. package/dist/exports/i18n.js +2 -2
  224. package/dist/exports/migrations.d.ts +2 -0
  225. package/dist/exports/migrations.js +2 -0
  226. package/dist/exports/react.d.ts +5 -3
  227. package/dist/exports/react.js +1 -2
  228. package/dist/exports/routes.d.ts +19 -0
  229. package/dist/exports/routes.js +3 -0
  230. package/dist/exports/rsc.d.ts +33 -14
  231. package/dist/exports/rsc.js +11 -6
  232. package/dist/exports/site.d.ts +5 -0
  233. package/dist/exports/site.js +3 -0
  234. package/dist/exports/testing.d.ts +18 -0
  235. package/dist/exports/testing.js +3 -0
  236. package/dist/exports/tracker.d.ts +6 -17
  237. package/dist/exports/tracker.js +3 -11
  238. package/dist/exports/types.d.ts +46 -14
  239. package/dist/exports/types.js +7 -1
  240. package/dist/fields/AnalyticsPanelClient.js +265 -154
  241. package/dist/fields/AnalyticsPanelClient.js.map +1 -1
  242. package/dist/fields/AnalyticsPanelField.d.ts +19 -7
  243. package/dist/fields/AnalyticsPanelField.js +123 -30
  244. package/dist/fields/AnalyticsPanelField.js.map +1 -1
  245. package/dist/fields/AnalyticsStatField.d.ts +17 -6
  246. package/dist/fields/AnalyticsStatField.js +98 -63
  247. package/dist/fields/AnalyticsStatField.js.map +1 -1
  248. package/dist/fields/FieldShimmer.js +15 -0
  249. package/dist/fields/FieldShimmer.js.map +1 -0
  250. package/dist/fields/PanelContent.js +222 -0
  251. package/dist/fields/PanelContent.js.map +1 -0
  252. package/dist/fields/PanelList.js +82 -0
  253. package/dist/fields/PanelList.js.map +1 -0
  254. package/dist/fields/PanelLiveCounter.js +63 -0
  255. package/dist/fields/PanelLiveCounter.js.map +1 -0
  256. package/dist/fields/PanelSkeleton.js +63 -0
  257. package/dist/fields/PanelSkeleton.js.map +1 -0
  258. package/dist/fields/componentPaths.js +8 -0
  259. package/dist/fields/componentPaths.js.map +1 -0
  260. package/dist/fields/config/FilterDimensionSelectField.d.ts +14 -0
  261. package/dist/fields/config/FilterDimensionSelectField.js +49 -0
  262. package/dist/fields/config/FilterDimensionSelectField.js.map +1 -0
  263. package/dist/fields/config/FilterKeySelect.js +66 -0
  264. package/dist/fields/config/FilterKeySelect.js.map +1 -0
  265. package/dist/fields/config/FilterOperatorSelectField.d.ts +19 -0
  266. package/dist/fields/config/FilterOperatorSelectField.js +59 -0
  267. package/dist/fields/config/FilterOperatorSelectField.js.map +1 -0
  268. package/dist/fields/config/FilterValueField.d.ts +17 -0
  269. package/dist/fields/config/FilterValueField.js +130 -0
  270. package/dist/fields/config/FilterValueField.js.map +1 -0
  271. package/dist/fields/config/MetricSelectField.d.ts +5 -12
  272. package/dist/fields/config/MetricSelectField.js +19 -31
  273. package/dist/fields/config/MetricSelectField.js.map +1 -1
  274. package/dist/fields/config/OptionSelect.js +52 -0
  275. package/dist/fields/config/OptionSelect.js.map +1 -0
  276. package/dist/fields/config/SourceSelectField.js +16 -31
  277. package/dist/fields/config/SourceSelectField.js.map +1 -1
  278. package/dist/fields/config/fetchSources.d.ts +3 -0
  279. package/dist/fields/config/fetchSources.js +17 -23
  280. package/dist/fields/config/fetchSources.js.map +1 -1
  281. package/dist/fields/config/filterValues.js +106 -0
  282. package/dist/fields/config/filterValues.js.map +1 -0
  283. package/dist/fields/config/narrow.js +8 -10
  284. package/dist/fields/config/narrow.js.map +1 -1
  285. package/dist/fields/config/retiredPickers.d.ts +45 -0
  286. package/dist/fields/config/retiredPickers.js +46 -0
  287. package/dist/fields/config/retiredPickers.js.map +1 -0
  288. package/dist/fields/config/scopedFields.d.ts +40 -0
  289. package/dist/fields/config/scopedFields.js +68 -0
  290. package/dist/fields/config/scopedFields.js.map +1 -0
  291. package/dist/fields/config/sourcesState.js +19 -3
  292. package/dist/fields/config/sourcesState.js.map +1 -1
  293. package/dist/fields/config/toSelectOption.js +13 -7
  294. package/dist/fields/config/toSelectOption.js.map +1 -1
  295. package/dist/fields/config/useAnalyticsSources.d.ts +10 -7
  296. package/dist/fields/config/useAnalyticsSources.js +23 -24
  297. package/dist/fields/config/useAnalyticsSources.js.map +1 -1
  298. package/dist/fields/config/useFilterCapabilities.d.ts +31 -0
  299. package/dist/fields/config/useFilterCapabilities.js +60 -0
  300. package/dist/fields/config/useFilterCapabilities.js.map +1 -0
  301. package/dist/fields/config/useFormString.js +12 -0
  302. package/dist/fields/config/useFormString.js.map +1 -0
  303. package/dist/fields/dateRange/field.js +7 -19
  304. package/dist/fields/dateRange/field.js.map +1 -1
  305. package/dist/fields/dateRange/types.d.ts +5 -1
  306. package/dist/fields/dateRange/ui.d.ts +3 -2
  307. package/dist/fields/dateRange/ui.js +57 -319
  308. package/dist/fields/dateRange/ui.js.map +1 -1
  309. package/dist/fields/documentScope.js +21 -0
  310. package/dist/fields/documentScope.js.map +1 -0
  311. package/dist/fields/emptyState.js +30 -26
  312. package/dist/fields/emptyState.js.map +1 -1
  313. package/dist/fields/factories.d.ts +35 -16
  314. package/dist/fields/factories.js +67 -38
  315. package/dist/fields/factories.js.map +1 -1
  316. package/dist/fields/format.d.ts +12 -3
  317. package/dist/fields/format.js +77 -13
  318. package/dist/fields/format.js.map +1 -1
  319. package/dist/fields/itemReport.js +45 -0
  320. package/dist/fields/itemReport.js.map +1 -0
  321. package/dist/fields/readForDocument.d.ts +79 -26
  322. package/dist/fields/readForDocument.js +451 -105
  323. package/dist/fields/readForDocument.js.map +1 -1
  324. package/dist/fields/stateKeys.js +20 -0
  325. package/dist/fields/stateKeys.js.map +1 -0
  326. package/dist/goals/GoalAmountField.d.ts +10 -0
  327. package/dist/goals/GoalAmountField.js +179 -0
  328. package/dist/goals/GoalAmountField.js.map +1 -0
  329. package/dist/goals/GoalSelectField.js +89 -40
  330. package/dist/goals/GoalSelectField.js.map +1 -1
  331. package/dist/goals/GoalSelectFieldServer.d.ts +13 -0
  332. package/dist/goals/GoalSelectFieldServer.js +21 -0
  333. package/dist/goals/GoalSelectFieldServer.js.map +1 -0
  334. package/dist/goals/amountField.d.ts +20 -0
  335. package/dist/goals/amountField.js +37 -0
  336. package/dist/goals/amountField.js.map +1 -0
  337. package/dist/goals/builtin.js +17 -0
  338. package/dist/goals/builtin.js.map +1 -0
  339. package/dist/goals/collection.d.ts +22 -0
  340. package/dist/goals/collection.js +143 -124
  341. package/dist/goals/collection.js.map +1 -1
  342. package/dist/goals/constants.d.ts +38 -0
  343. package/dist/goals/constants.js +49 -0
  344. package/dist/goals/constants.js.map +1 -0
  345. package/dist/goals/currency.d.ts +16 -0
  346. package/dist/goals/currency.js +46 -4
  347. package/dist/goals/currency.js.map +1 -1
  348. package/dist/goals/currencyOptions.js +70 -0
  349. package/dist/goals/currencyOptions.js.map +1 -0
  350. package/dist/goals/fetchGoals.d.ts +10 -0
  351. package/dist/goals/fetchGoals.js +12 -22
  352. package/dist/goals/fetchGoals.js.map +1 -1
  353. package/dist/goals/goalField.d.ts +4 -6
  354. package/dist/goals/goalField.js +9 -19
  355. package/dist/goals/goalField.js.map +1 -1
  356. package/dist/goals/goalsEndpoint.js +40 -38
  357. package/dist/goals/goalsEndpoint.js.map +1 -1
  358. package/dist/goals/items.js +35 -0
  359. package/dist/goals/items.js.map +1 -0
  360. package/dist/goals/latent.js +9 -0
  361. package/dist/goals/latent.js.map +1 -0
  362. package/dist/goals/linkFields.d.ts +35 -0
  363. package/dist/goals/linkFields.js +31 -0
  364. package/dist/goals/linkFields.js.map +1 -0
  365. package/dist/goals/match.d.ts +14 -0
  366. package/dist/goals/match.js +67 -46
  367. package/dist/goals/match.js.map +1 -1
  368. package/dist/goals/moneyFields.js +56 -0
  369. package/dist/goals/moneyFields.js.map +1 -0
  370. package/dist/goals/pathMatch.js +122 -0
  371. package/dist/goals/pathMatch.js.map +1 -0
  372. package/dist/goals/placeholder.js +12 -0
  373. package/dist/goals/placeholder.js.map +1 -0
  374. package/dist/goals/resolver.d.ts +3 -3
  375. package/dist/goals/resolver.js +155 -47
  376. package/dist/goals/resolver.js.map +1 -1
  377. package/dist/goals/serverRevenue.d.ts +60 -0
  378. package/dist/goals/serverRevenue.js +41 -0
  379. package/dist/goals/serverRevenue.js.map +1 -0
  380. package/dist/goals/trackGoalAction.d.ts +26 -25
  381. package/dist/goals/trackGoalAction.js +71 -66
  382. package/dist/goals/trackGoalAction.js.map +1 -1
  383. package/dist/goals/types.d.ts +13 -28
  384. package/dist/goals/types.js +1 -1
  385. package/dist/goals/types.js.map +1 -1
  386. package/dist/goals/useAnalyticsGoals.d.ts +6 -5
  387. package/dist/goals/useAnalyticsGoals.js +17 -18
  388. package/dist/goals/useAnalyticsGoals.js.map +1 -1
  389. package/dist/index.d.ts +69 -11
  390. package/dist/index.js +262 -192
  391. package/dist/index.js.map +1 -1
  392. package/dist/items/collectionIdType.js +20 -0
  393. package/dist/items/collectionIdType.js.map +1 -0
  394. package/dist/items/idType.js +31 -0
  395. package/dist/items/idType.js.map +1 -0
  396. package/dist/items/ref.js +73 -0
  397. package/dist/items/ref.js.map +1 -0
  398. package/dist/maintenance/apiTaskState.js +141 -0
  399. package/dist/maintenance/apiTaskState.js.map +1 -0
  400. package/dist/maintenance/heartbeat.js +51 -0
  401. package/dist/maintenance/heartbeat.js.map +1 -0
  402. package/dist/maintenance/lease.d.ts +1 -0
  403. package/dist/maintenance/lease.js +79 -0
  404. package/dist/maintenance/lease.js.map +1 -0
  405. package/dist/maintenance/taskSchedule.js +27 -0
  406. package/dist/maintenance/taskSchedule.js.map +1 -0
  407. package/dist/maintenance/underLease.js +35 -0
  408. package/dist/maintenance/underLease.js.map +1 -0
  409. package/dist/migrations/legacy.d.ts +54 -0
  410. package/dist/migrations/legacy.js +117 -0
  411. package/dist/migrations/legacy.js.map +1 -0
  412. package/dist/migrations/predefined/dropLegacyMongo.d.ts +11 -0
  413. package/dist/migrations/predefined/dropLegacyMongo.js +12 -0
  414. package/dist/migrations/predefined/dropLegacyMongo.js.map +1 -0
  415. package/dist/native/collections/aggregates.js +54 -0
  416. package/dist/native/collections/aggregates.js.map +1 -0
  417. package/dist/native/collections/hits.js +103 -0
  418. package/dist/native/collections/hits.js.map +1 -0
  419. package/dist/native/collections/slugs.d.ts +10 -0
  420. package/dist/native/collections/slugs.js +16 -0
  421. package/dist/native/collections/slugs.js.map +1 -0
  422. package/dist/native/collections/state.js +84 -0
  423. package/dist/native/collections/state.js.map +1 -0
  424. package/dist/native/collections/storeCollection.js +31 -0
  425. package/dist/native/collections/storeCollection.js.map +1 -0
  426. package/dist/native/engine/buckets.d.ts +1 -0
  427. package/dist/native/engine/buckets.js +53 -0
  428. package/dist/native/engine/buckets.js.map +1 -0
  429. package/dist/native/engine/capabilities.js +87 -0
  430. package/dist/native/engine/capabilities.js.map +1 -0
  431. package/dist/native/engine/cost.js +72 -0
  432. package/dist/native/engine/cost.js.map +1 -0
  433. package/dist/native/engine/days.d.ts +1 -0
  434. package/dist/native/engine/days.js +182 -0
  435. package/dist/native/engine/days.js.map +1 -0
  436. package/dist/native/engine/engine.d.ts +1 -0
  437. package/dist/native/engine/engine.js +1627 -0
  438. package/dist/native/engine/engine.js.map +1 -0
  439. package/dist/native/engine/instance.js +58 -0
  440. package/dist/native/engine/instance.js.map +1 -0
  441. package/dist/native/engine/maintenance.d.ts +1 -0
  442. package/dist/native/engine/maintenance.js +677 -0
  443. package/dist/native/engine/maintenance.js.map +1 -0
  444. package/dist/native/engine/merge.js +41 -0
  445. package/dist/native/engine/merge.js.map +1 -0
  446. package/dist/native/engine/nudge.js +26 -0
  447. package/dist/native/engine/nudge.js.map +1 -0
  448. package/dist/native/engine/planner.js +199 -0
  449. package/dist/native/engine/planner.js.map +1 -0
  450. package/dist/native/engine/rebuild.d.ts +22 -0
  451. package/dist/native/engine/rebuild.js +76 -0
  452. package/dist/native/engine/rebuild.js.map +1 -0
  453. package/dist/native/engine/recent.js +17 -0
  454. package/dist/native/engine/recent.js.map +1 -0
  455. package/dist/native/engine/salt.d.ts +1 -0
  456. package/dist/native/engine/salt.js +98 -0
  457. package/dist/native/engine/salt.js.map +1 -0
  458. package/dist/native/engine/siteHosts.d.ts +1 -0
  459. package/dist/native/engine/siteHosts.js +58 -0
  460. package/dist/native/engine/siteHosts.js.map +1 -0
  461. package/dist/native/engine/toHit.js +110 -0
  462. package/dist/native/engine/toHit.js.map +1 -0
  463. package/dist/native/engine/writeBuffer.d.ts +14 -0
  464. package/dist/native/engine/writeBuffer.js +317 -0
  465. package/dist/native/engine/writeBuffer.js.map +1 -0
  466. package/dist/native/geo/composeGeoResolvers.d.ts +1 -0
  467. package/dist/native/geo/composeGeoResolvers.js +5 -2
  468. package/dist/native/geo/composeGeoResolvers.js.map +1 -1
  469. package/dist/native/geo/geoResolver.d.ts +27 -2
  470. package/dist/native/geo/geoResolver.js +42 -6
  471. package/dist/native/geo/geoResolver.js.map +1 -1
  472. package/dist/native/geo/maxmindResolver.d.ts +8 -4
  473. package/dist/native/geo/maxmindResolver.js +20 -16
  474. package/dist/native/geo/maxmindResolver.js.map +1 -1
  475. package/dist/native/geo/resolveGeo.js +31 -0
  476. package/dist/native/geo/resolveGeo.js.map +1 -0
  477. package/dist/native/ingest/bots.d.ts +10 -0
  478. package/dist/native/ingest/bots.js +66 -0
  479. package/dist/native/ingest/bots.js.map +1 -0
  480. package/dist/native/ingest/browser.js +45 -0
  481. package/dist/native/ingest/browser.js.map +1 -0
  482. package/dist/native/ingest/clientIp.js +34 -8
  483. package/dist/native/ingest/clientIp.js.map +1 -1
  484. package/dist/native/ingest/device.js +4 -6
  485. package/dist/native/ingest/device.js.map +1 -1
  486. package/dist/native/ingest/endpoint.d.ts +1 -1
  487. package/dist/native/ingest/endpoint.js +185 -32
  488. package/dist/native/ingest/endpoint.js.map +1 -1
  489. package/dist/native/ingest/itemSignature.d.ts +26 -0
  490. package/dist/native/ingest/itemSignature.js +45 -0
  491. package/dist/native/ingest/itemSignature.js.map +1 -0
  492. package/dist/native/ingest/language.js +13 -0
  493. package/dist/native/ingest/language.js.map +1 -0
  494. package/dist/native/ingest/normalizeEvent.d.ts +73 -5
  495. package/dist/native/ingest/normalizeEvent.js +257 -51
  496. package/dist/native/ingest/normalizeEvent.js.map +1 -1
  497. package/dist/native/ingest/orderSignature.d.ts +13 -0
  498. package/dist/native/ingest/orderSignature.js +50 -0
  499. package/dist/native/ingest/orderSignature.js.map +1 -0
  500. package/dist/native/ingest/referrer.js +46 -0
  501. package/dist/native/ingest/referrer.js.map +1 -0
  502. package/dist/native/ingest/requestHost.js +44 -0
  503. package/dist/native/ingest/requestHost.js.map +1 -0
  504. package/dist/native/ingest/resolveHostname.d.ts +20 -0
  505. package/dist/native/ingest/resolveHostname.js +51 -0
  506. package/dist/native/ingest/resolveHostname.js.map +1 -0
  507. package/dist/native/ingest/revenue.d.ts +1 -0
  508. package/dist/native/ingest/revenue.js +121 -0
  509. package/dist/native/ingest/revenue.js.map +1 -0
  510. package/dist/native/ingest/route.d.ts +10 -0
  511. package/dist/native/ingest/route.js +85 -0
  512. package/dist/native/ingest/route.js.map +1 -0
  513. package/dist/native/ingest/serverTrack.d.ts +2 -10
  514. package/dist/native/ingest/serverTrack.js +188 -68
  515. package/dist/native/ingest/serverTrack.js.map +1 -1
  516. package/dist/native/ingest/signature.js +28 -0
  517. package/dist/native/ingest/signature.js.map +1 -0
  518. package/dist/native/ingest/source.d.ts +10 -0
  519. package/dist/native/ingest/source.js +245 -16
  520. package/dist/native/ingest/source.js.map +1 -1
  521. package/dist/native/ingest/utm.js +33 -0
  522. package/dist/native/ingest/utm.js.map +1 -0
  523. package/dist/native/ingest/validate.js +25 -13
  524. package/dist/native/ingest/validate.js.map +1 -1
  525. package/dist/native/ingest/visitorHash.js +6 -8
  526. package/dist/native/ingest/visitorHash.js.map +1 -1
  527. package/dist/native/nativeAdapter.d.ts +128 -9
  528. package/dist/native/nativeAdapter.js +395 -281
  529. package/dist/native/nativeAdapter.js.map +1 -1
  530. package/dist/native/rebuildDays.d.ts +12 -0
  531. package/dist/native/rebuildDays.js +16 -0
  532. package/dist/native/rebuildDays.js.map +1 -0
  533. package/dist/native/store/aggregate.js +450 -0
  534. package/dist/native/store/aggregate.js.map +1 -0
  535. package/dist/native/store/caps.d.ts +18 -0
  536. package/dist/native/store/caps.js +76 -0
  537. package/dist/native/store/caps.js.map +1 -0
  538. package/dist/native/store/chunks.js +34 -0
  539. package/dist/native/store/chunks.js.map +1 -0
  540. package/dist/native/store/columnValues.js +31 -0
  541. package/dist/native/store/columnValues.js.map +1 -0
  542. package/dist/native/store/dialect.js +106 -0
  543. package/dist/native/store/dialect.js.map +1 -0
  544. package/dist/native/store/eventStore.js +44 -0
  545. package/dist/native/store/eventStore.js.map +1 -0
  546. package/dist/native/store/hitRow.js +119 -0
  547. package/dist/native/store/hitRow.js.map +1 -0
  548. package/dist/native/store/hits.js +65 -0
  549. package/dist/native/store/hits.js.map +1 -0
  550. package/dist/native/store/ids.js +105 -0
  551. package/dist/native/store/ids.js.map +1 -0
  552. package/dist/native/store/mongo/aggregatePipelines.js +438 -0
  553. package/dist/native/store/mongo/aggregatePipelines.js.map +1 -0
  554. package/dist/native/store/mongo/mongoState.js +375 -0
  555. package/dist/native/store/mongo/mongoState.js.map +1 -0
  556. package/dist/native/store/mongo/mongoStore.js +618 -0
  557. package/dist/native/store/mongo/mongoStore.js.map +1 -0
  558. package/dist/native/store/mongo/pipelines.js +705 -0
  559. package/dist/native/store/mongo/pipelines.js.map +1 -0
  560. package/dist/native/store/mongo/results.js +20 -0
  561. package/dist/native/store/mongo/results.js.map +1 -0
  562. package/dist/native/store/parts.d.ts +1 -0
  563. package/dist/native/store/parts.js +101 -0
  564. package/dist/native/store/parts.js.map +1 -0
  565. package/dist/native/store/pattern.js +213 -0
  566. package/dist/native/store/pattern.js.map +1 -0
  567. package/dist/native/store/rawRead.d.ts +23 -0
  568. package/dist/native/store/rawRead.js +387 -0
  569. package/dist/native/store/rawRead.js.map +1 -0
  570. package/dist/native/store/reclassify.js +53 -0
  571. package/dist/native/store/reclassify.js.map +1 -0
  572. package/dist/native/store/sql/aggregateSql.js +349 -0
  573. package/dist/native/store/sql/aggregateSql.js.map +1 -0
  574. package/dist/native/store/sql/columns.js +49 -0
  575. package/dist/native/store/sql/columns.js.map +1 -0
  576. package/dist/native/store/sql/compile.js +668 -0
  577. package/dist/native/store/sql/compile.js.map +1 -0
  578. package/dist/native/store/sql/drivers.js +218 -0
  579. package/dist/native/store/sql/drivers.js.map +1 -0
  580. package/dist/native/store/sql/executor.js +132 -0
  581. package/dist/native/store/sql/executor.js.map +1 -0
  582. package/dist/native/store/sql/fragment.js +104 -0
  583. package/dist/native/store/sql/fragment.js.map +1 -0
  584. package/dist/native/store/sql/maintenanceSql.js +59 -0
  585. package/dist/native/store/sql/maintenanceSql.js.map +1 -0
  586. package/dist/native/store/sql/ownConnection.js +107 -0
  587. package/dist/native/store/sql/ownConnection.js.map +1 -0
  588. package/dist/native/store/sql/poolShare.js +101 -0
  589. package/dist/native/store/sql/poolShare.js.map +1 -0
  590. package/dist/native/store/sql/sqlState.js +325 -0
  591. package/dist/native/store/sql/sqlState.js.map +1 -0
  592. package/dist/native/store/sql/sqlStore.js +355 -0
  593. package/dist/native/store/sql/sqlStore.js.map +1 -0
  594. package/dist/native/store/sql/sqliteThread.d.ts +9 -0
  595. package/dist/native/store/sql/sqliteThread.js +314 -0
  596. package/dist/native/store/sql/sqliteThread.js.map +1 -0
  597. package/dist/native/store/sql/sqliteWorker.js +327 -0
  598. package/dist/native/store/sql/sqliteWorker.js.map +1 -0
  599. package/dist/native/store/sql/sqliteWorkerSource.js +347 -0
  600. package/dist/native/store/sql/sqliteWorkerSource.js.map +1 -0
  601. package/dist/native/store/state.js +151 -0
  602. package/dist/native/store/state.js.map +1 -0
  603. package/dist/native/store/stateStore.js +29 -0
  604. package/dist/native/store/stateStore.js.map +1 -0
  605. package/dist/native/store/types.d.ts +15 -0
  606. package/dist/native/store/types.js +10 -0
  607. package/dist/native/store/types.js.map +1 -0
  608. package/dist/native/tasks/maintainTask.d.ts +19 -0
  609. package/dist/native/tasks/maintainTask.js +57 -0
  610. package/dist/native/tasks/maintainTask.js.map +1 -0
  611. package/dist/net/guardedFetch.d.ts +32 -0
  612. package/dist/net/guardedFetch.js +220 -0
  613. package/dist/net/guardedFetch.js.map +1 -0
  614. package/dist/net/origin.js +40 -0
  615. package/dist/net/origin.js.map +1 -0
  616. package/dist/net/platform.d.ts +9 -0
  617. package/dist/net/platform.js +35 -0
  618. package/dist/net/platform.js.map +1 -0
  619. package/dist/plugin/adminDependencies.js +34 -0
  620. package/dist/plugin/adminDependencies.js.map +1 -0
  621. package/dist/plugin/apiPath.js +23 -0
  622. package/dist/plugin/apiPath.js.map +1 -0
  623. package/dist/plugin/boundDocument.js +58 -0
  624. package/dist/plugin/boundDocument.js.map +1 -0
  625. package/dist/plugin/buildPhase.js +10 -0
  626. package/dist/plugin/buildPhase.js.map +1 -0
  627. package/dist/plugin/collectionChecks.js +232 -0
  628. package/dist/plugin/collectionChecks.js.map +1 -0
  629. package/dist/plugin/collectionFields.d.ts +13 -0
  630. package/dist/plugin/collectionFields.js +22 -0
  631. package/dist/plugin/collectionFields.js.map +1 -0
  632. package/dist/plugin/createRuntime.js +346 -0
  633. package/dist/plugin/createRuntime.js.map +1 -0
  634. package/dist/plugin/destroy.js +58 -0
  635. package/dist/plugin/destroy.js.map +1 -0
  636. package/dist/plugin/documentEndpoint.js +106 -53
  637. package/dist/plugin/documentEndpoint.js.map +1 -1
  638. package/dist/plugin/documentScopes.js +37 -0
  639. package/dist/plugin/documentScopes.js.map +1 -0
  640. package/dist/plugin/encrypted.js +25 -0
  641. package/dist/plugin/encrypted.js.map +1 -0
  642. package/dist/plugin/errors.d.ts +24 -0
  643. package/dist/plugin/errors.js +86 -0
  644. package/dist/plugin/errors.js.map +1 -0
  645. package/dist/plugin/flagsEndpoint.js +41 -0
  646. package/dist/plugin/flagsEndpoint.js.map +1 -0
  647. package/dist/plugin/goalHint.d.ts +1 -0
  648. package/dist/plugin/goalHint.js +35 -0
  649. package/dist/plugin/goalHint.js.map +1 -0
  650. package/dist/plugin/itemLabels.js +114 -0
  651. package/dist/plugin/itemLabels.js.map +1 -0
  652. package/dist/plugin/keepAlive.js +48 -0
  653. package/dist/plugin/keepAlive.js.map +1 -0
  654. package/dist/plugin/peerImportError.js +3 -6
  655. package/dist/plugin/peerImportError.js.map +1 -1
  656. package/dist/plugin/peers.js +64 -0
  657. package/dist/plugin/peers.js.map +1 -0
  658. package/dist/plugin/pluginCollections.js +161 -0
  659. package/dist/plugin/pluginCollections.js.map +1 -0
  660. package/dist/plugin/queryEndpoint.js +88 -52
  661. package/dist/plugin/queryEndpoint.js.map +1 -1
  662. package/dist/plugin/queryParams.js +7 -0
  663. package/dist/plugin/queryParams.js.map +1 -0
  664. package/dist/plugin/readContextForRequest.d.ts +11 -0
  665. package/dist/plugin/readContextForRequest.js +79 -32
  666. package/dist/plugin/readContextForRequest.js.map +1 -1
  667. package/dist/plugin/readFailure.js +22 -0
  668. package/dist/plugin/readFailure.js.map +1 -0
  669. package/dist/plugin/readableProviders.js +67 -0
  670. package/dist/plugin/readableProviders.js.map +1 -0
  671. package/dist/plugin/realtimeEndpoint.js +91 -21
  672. package/dist/plugin/realtimeEndpoint.js.map +1 -1
  673. package/dist/plugin/refreshEndpoint.js +138 -0
  674. package/dist/plugin/refreshEndpoint.js.map +1 -0
  675. package/dist/plugin/relabelFields.js +36 -0
  676. package/dist/plugin/relabelFields.js.map +1 -0
  677. package/dist/plugin/requestMemo.js +35 -0
  678. package/dist/plugin/requestMemo.js.map +1 -0
  679. package/dist/plugin/routeChecks.js +39 -0
  680. package/dist/plugin/routeChecks.js.map +1 -0
  681. package/dist/plugin/routes.d.ts +53 -0
  682. package/dist/plugin/routes.js +92 -0
  683. package/dist/plugin/routes.js.map +1 -0
  684. package/dist/plugin/runtime.d.ts +1 -1
  685. package/dist/plugin/runtime.js +235 -29
  686. package/dist/plugin/runtime.js.map +1 -1
  687. package/dist/plugin/schemaOnly.js +61 -0
  688. package/dist/plugin/schemaOnly.js.map +1 -0
  689. package/dist/plugin/scopeChange.js +23 -0
  690. package/dist/plugin/scopeChange.js.map +1 -0
  691. package/dist/plugin/scopeFieldBoot.js +4 -4
  692. package/dist/plugin/scopeFieldBoot.js.map +1 -1
  693. package/dist/plugin/scopeToken.js +33 -0
  694. package/dist/plugin/scopeToken.js.map +1 -0
  695. package/dist/plugin/sourcesEndpoint.js +50 -16
  696. package/dist/plugin/sourcesEndpoint.js.map +1 -1
  697. package/dist/plugin/unbundledLanguages.js +25 -0
  698. package/dist/plugin/unbundledLanguages.js.map +1 -0
  699. package/dist/plugin/walkFields.js +24 -0
  700. package/dist/plugin/walkFields.js.map +1 -0
  701. package/dist/plugin/warmTask.js +0 -0
  702. package/dist/plugin/warmTask.js.map +1 -1
  703. package/dist/providers/ProvidersListNotice.d.ts +11 -0
  704. package/dist/providers/ProvidersListNotice.js +36 -0
  705. package/dist/providers/ProvidersListNotice.js.map +1 -0
  706. package/dist/providers/access.d.ts +1 -0
  707. package/dist/providers/access.js +35 -26
  708. package/dist/providers/access.js.map +1 -1
  709. package/dist/providers/adapterPool.js +121 -0
  710. package/dist/providers/adapterPool.js.map +1 -0
  711. package/dist/providers/collection.d.ts +63 -0
  712. package/dist/providers/collection.js +372 -143
  713. package/dist/providers/collection.js.map +1 -1
  714. package/dist/providers/factory.d.ts +84 -0
  715. package/dist/providers/factory.js +86 -25
  716. package/dist/providers/factory.js.map +1 -1
  717. package/dist/providers/hosts.d.ts +25 -0
  718. package/dist/providers/hosts.js +128 -0
  719. package/dist/providers/hosts.js.map +1 -0
  720. package/dist/providers/probe.d.ts +1 -0
  721. package/dist/providers/probe.js +105 -0
  722. package/dist/providers/probe.js.map +1 -0
  723. package/dist/providers/refresh.d.ts +18 -0
  724. package/dist/providers/refresh.js +49 -0
  725. package/dist/providers/refresh.js.map +1 -0
  726. package/dist/providers/registry.js +329 -0
  727. package/dist/providers/registry.js.map +1 -0
  728. package/dist/providers/resolver.js +26 -88
  729. package/dist/providers/resolver.js.map +1 -1
  730. package/dist/providers/retarget.js +45 -0
  731. package/dist/providers/retarget.js.map +1 -0
  732. package/dist/providers/scopeUnique.js +41 -0
  733. package/dist/providers/scopeUnique.js.map +1 -0
  734. package/dist/providers/secrets.d.ts +26 -0
  735. package/dist/providers/secrets.js +61 -4
  736. package/dist/providers/secrets.js.map +1 -1
  737. package/dist/providers/stampScope.js +9 -6
  738. package/dist/providers/stampScope.js.map +1 -1
  739. package/dist/query/dates.js +10 -12
  740. package/dist/query/dates.js.map +1 -1
  741. package/dist/query/errors.d.ts +6 -13
  742. package/dist/query/fetchQuery.d.ts +36 -23
  743. package/dist/query/fetchQuery.js +96 -89
  744. package/dist/query/fetchQuery.js.map +1 -1
  745. package/dist/query/limits.js +8 -0
  746. package/dist/query/limits.js.map +1 -0
  747. package/dist/query/parse.d.ts +8 -2
  748. package/dist/query/parse.js +155 -108
  749. package/dist/query/parse.js.map +1 -1
  750. package/dist/query/response.d.ts +27 -4
  751. package/dist/query/response.js +18 -0
  752. package/dist/query/response.js.map +1 -0
  753. package/dist/react/AnalyticsProvider.d.ts +42 -20
  754. package/dist/react/AnalyticsProvider.js +24 -22
  755. package/dist/react/AnalyticsProvider.js.map +1 -1
  756. package/dist/react/TrackerBoot.js +15 -9
  757. package/dist/react/TrackerBoot.js.map +1 -1
  758. package/dist/react/useAnalytics.d.ts +2 -8
  759. package/dist/react/useAnalytics.js +31 -13
  760. package/dist/react/useAnalytics.js.map +1 -1
  761. package/dist/routes/captureRoute.d.ts +28 -0
  762. package/dist/routes/captureRoute.js +67 -0
  763. package/dist/routes/captureRoute.js.map +1 -0
  764. package/dist/routes/ingestRoute.d.ts +17 -0
  765. package/dist/routes/ingestRoute.js +17 -0
  766. package/dist/routes/ingestRoute.js.map +1 -0
  767. package/dist/site/AnalyticsScripts.d.ts +35 -0
  768. package/dist/site/AnalyticsScripts.js +44 -0
  769. package/dist/site/AnalyticsScripts.js.map +1 -0
  770. package/dist/site/getTrackerConfig.d.ts +15 -0
  771. package/dist/site/getTrackerConfig.js +43 -0
  772. package/dist/site/getTrackerConfig.js.map +1 -0
  773. package/dist/surfacing/afterRead.d.ts +37 -0
  774. package/dist/surfacing/bounded.js +38 -0
  775. package/dist/surfacing/bounded.js.map +1 -0
  776. package/dist/surfacing/breaker.js +107 -0
  777. package/dist/surfacing/breaker.js.map +1 -0
  778. package/dist/surfacing/cacheCollection.d.ts +8 -0
  779. package/dist/surfacing/cacheCollection.js +71 -0
  780. package/dist/surfacing/cacheCollection.js.map +1 -0
  781. package/dist/surfacing/cacheStore.d.ts +71 -1
  782. package/dist/surfacing/cacheStore.js +16 -37
  783. package/dist/surfacing/cacheStore.js.map +1 -1
  784. package/dist/surfacing/cacheSweep.d.ts +1 -0
  785. package/dist/surfacing/cacheSweep.js +59 -0
  786. package/dist/surfacing/cacheSweep.js.map +1 -0
  787. package/dist/surfacing/classifyError.js +282 -0
  788. package/dist/surfacing/classifyError.js.map +1 -0
  789. package/dist/surfacing/coalesce.js +2 -1
  790. package/dist/surfacing/coalesce.js.map +1 -1
  791. package/dist/surfacing/coldBudget.js +60 -0
  792. package/dist/surfacing/coldBudget.js.map +1 -0
  793. package/dist/surfacing/collectionCacheStore.js +183 -0
  794. package/dist/surfacing/collectionCacheStore.js.map +1 -0
  795. package/dist/surfacing/engine.d.ts +1 -1
  796. package/dist/surfacing/engine.js +514 -71
  797. package/dist/surfacing/engine.js.map +1 -1
  798. package/dist/surfacing/epoch.d.ts +1 -0
  799. package/dist/surfacing/epoch.js +116 -0
  800. package/dist/surfacing/epoch.js.map +1 -0
  801. package/dist/surfacing/lanes.d.ts +1 -0
  802. package/dist/surfacing/lanes.js +297 -0
  803. package/dist/surfacing/lanes.js.map +1 -0
  804. package/dist/surfacing/memo.js +40 -0
  805. package/dist/surfacing/memo.js.map +1 -0
  806. package/dist/surfacing/rateLimiter.d.ts +1 -0
  807. package/dist/surfacing/rateLimiter.js +69 -94
  808. package/dist/surfacing/rateLimiter.js.map +1 -1
  809. package/dist/surfacing/rebucket.js +178 -0
  810. package/dist/surfacing/rebucket.js.map +1 -0
  811. package/dist/surfacing/recipe.js +28 -0
  812. package/dist/surfacing/recipe.js.map +1 -0
  813. package/dist/surfacing/shape.js +22 -0
  814. package/dist/surfacing/shape.js.map +1 -0
  815. package/dist/surfacing/todaySplit.js +119 -0
  816. package/dist/surfacing/todaySplit.js.map +1 -0
  817. package/dist/sync/collection.d.ts +8 -0
  818. package/dist/sync/collection.js +30 -18
  819. package/dist/sync/collection.js.map +1 -1
  820. package/dist/sync/rekeyDurations.js +70 -0
  821. package/dist/sync/rekeyDurations.js.map +1 -0
  822. package/dist/sync/syncTask.js +222 -109
  823. package/dist/sync/syncTask.js.map +1 -1
  824. package/dist/testing/memoryAdapter.d.ts +6 -3
  825. package/dist/testing/memoryAdapter.js +12 -11
  826. package/dist/testing/memoryAdapter.js.map +1 -1
  827. package/dist/testing/settle.d.ts +11 -0
  828. package/dist/testing/settle.js +19 -0
  829. package/dist/testing/settle.js.map +1 -0
  830. package/dist/timeframe/calendar.js +65 -0
  831. package/dist/timeframe/calendar.js.map +1 -0
  832. package/dist/timeframe/comparison.js +46 -0
  833. package/dist/timeframe/comparison.js.map +1 -0
  834. package/dist/timeframe/presets.d.ts +1 -1
  835. package/dist/timeframe/presets.js +5 -5
  836. package/dist/timeframe/presets.js.map +1 -1
  837. package/dist/timeframe/reportingTimezone.d.ts +1 -0
  838. package/dist/timeframe/reportingTimezone.js +64 -0
  839. package/dist/timeframe/reportingTimezone.js.map +1 -0
  840. package/dist/timeframe/tz.js +55 -39
  841. package/dist/timeframe/tz.js.map +1 -1
  842. package/dist/tracker/autoCapture.js +125 -38
  843. package/dist/tracker/autoCapture.js.map +1 -1
  844. package/dist/tracker/campaign.js +52 -0
  845. package/dist/tracker/campaign.js.map +1 -0
  846. package/dist/tracker/config.d.ts +174 -0
  847. package/dist/tracker/config.js +25 -0
  848. package/dist/tracker/config.js.map +1 -0
  849. package/dist/tracker/createTracker.d.ts +5 -10
  850. package/dist/tracker/createTracker.js +437 -82
  851. package/dist/tracker/createTracker.js.map +1 -1
  852. package/dist/tracker/digest.js +28 -0
  853. package/dist/tracker/digest.js.map +1 -0
  854. package/dist/tracker/engagement.js +100 -0
  855. package/dist/tracker/engagement.js.map +1 -0
  856. package/dist/tracker/events.js +37 -0
  857. package/dist/tracker/events.js.map +1 -0
  858. package/dist/tracker/exclusion.d.ts +8 -0
  859. package/dist/tracker/exclusion.js +82 -0
  860. package/dist/tracker/exclusion.js.map +1 -0
  861. package/dist/tracker/gate.d.ts +8 -0
  862. package/dist/tracker/gate.js +244 -0
  863. package/dist/tracker/gate.js.map +1 -0
  864. package/dist/tracker/initTracker.d.ts +5 -8
  865. package/dist/tracker/initTracker.js +42 -14
  866. package/dist/tracker/initTracker.js.map +1 -1
  867. package/dist/tracker/itemCapture.js +224 -0
  868. package/dist/tracker/itemCapture.js.map +1 -0
  869. package/dist/tracker/loadScript.js +23 -15
  870. package/dist/tracker/loadScript.js.map +1 -1
  871. package/dist/tracker/pageTracking.js +6 -6
  872. package/dist/tracker/pageTracking.js.map +1 -1
  873. package/dist/tracker/registry.js +129 -30
  874. package/dist/tracker/registry.js.map +1 -1
  875. package/dist/tracker/sinks/createSink.js +60 -0
  876. package/dist/tracker/sinks/createSink.js.map +1 -0
  877. package/dist/tracker/sinks/ga4.js +106 -0
  878. package/dist/tracker/sinks/ga4.js.map +1 -0
  879. package/dist/tracker/sinks/native.js +21 -42
  880. package/dist/tracker/sinks/native.js.map +1 -1
  881. package/dist/tracker/sinks/plausible.js +36 -18
  882. package/dist/tracker/sinks/plausible.js.map +1 -1
  883. package/dist/tracker/sinks/posthog.js +145 -9
  884. package/dist/tracker/sinks/posthog.js.map +1 -1
  885. package/dist/tracker/sinks/umami.js +18 -10
  886. package/dist/tracker/sinks/umami.js.map +1 -1
  887. package/dist/tracker/sinks/vendor.js +54 -22
  888. package/dist/tracker/sinks/vendor.js.map +1 -1
  889. package/dist/tracker/skip.js +81 -0
  890. package/dist/tracker/skip.js.map +1 -0
  891. package/dist/tracker/storage.js +23 -0
  892. package/dist/tracker/storage.js.map +1 -0
  893. package/dist/tracker/transport.js +2 -5
  894. package/dist/tracker/transport.js.map +1 -1
  895. package/dist/tracker/types.d.ts +99 -44
  896. package/dist/tracker/window.js +7 -0
  897. package/dist/tracker/window.js.map +1 -0
  898. package/dist/translations/ar.js +266 -56
  899. package/dist/translations/ar.js.map +1 -1
  900. package/dist/translations/de.js +256 -55
  901. package/dist/translations/de.js.map +1 -1
  902. package/dist/translations/en.js +253 -56
  903. package/dist/translations/en.js.map +1 -1
  904. package/dist/translations/es.js +261 -57
  905. package/dist/translations/es.js.map +1 -1
  906. package/dist/translations/fr.js +265 -61
  907. package/dist/translations/fr.js.map +1 -1
  908. package/dist/translations/id.js +256 -56
  909. package/dist/translations/id.js.map +1 -1
  910. package/dist/translations/index.d.ts +1 -1
  911. package/dist/translations/index.js +5 -7
  912. package/dist/translations/index.js.map +1 -1
  913. package/dist/translations/intl.js +71 -0
  914. package/dist/translations/intl.js.map +1 -0
  915. package/dist/translations/keys.d.ts +240 -14
  916. package/dist/translations/keys.js +245 -14
  917. package/dist/translations/keys.js.map +1 -1
  918. package/dist/translations/ko.js +258 -58
  919. package/dist/translations/ko.js.map +1 -1
  920. package/dist/translations/labelMap.d.ts +10 -0
  921. package/dist/translations/labelMap.js +22 -0
  922. package/dist/translations/labelMap.js.map +1 -0
  923. package/dist/translations/metricKeys.js +16 -2
  924. package/dist/translations/metricKeys.js.map +1 -1
  925. package/dist/translations/parts.js +20 -0
  926. package/dist/translations/parts.js.map +1 -0
  927. package/dist/translations/plural.js +61 -0
  928. package/dist/translations/plural.js.map +1 -0
  929. package/dist/translations/pt.js +270 -66
  930. package/dist/translations/pt.js.map +1 -1
  931. package/dist/translations/ru.js +261 -55
  932. package/dist/translations/ru.js.map +1 -1
  933. package/dist/translations/server.d.ts +1 -0
  934. package/dist/translations/server.js +2 -3
  935. package/dist/translations/server.js.map +1 -1
  936. package/dist/translations/staticLabel.js +69 -0
  937. package/dist/translations/staticLabel.js.map +1 -0
  938. package/dist/translations/uk.js +261 -55
  939. package/dist/translations/uk.js.map +1 -1
  940. package/dist/translations/zh.js +256 -56
  941. package/dist/translations/zh.js.map +1 -1
  942. package/dist/ui/RangePicker.js +110 -0
  943. package/dist/ui/RangePicker.js.map +1 -0
  944. package/dist/ui/analytics.css +1667 -0
  945. package/dist/ui/calendarDays.js +27 -0
  946. package/dist/ui/calendarDays.js.map +1 -0
  947. package/dist/ui/classNames.js +7 -0
  948. package/dist/ui/classNames.js.map +1 -0
  949. package/dist/ui/components/Card.d.ts +28 -0
  950. package/dist/ui/components/Card.js +21 -0
  951. package/dist/ui/components/Card.js.map +1 -0
  952. package/dist/ui/components/ChartDataTable.d.ts +41 -0
  953. package/dist/ui/components/ChartDataTable.js +48 -0
  954. package/dist/ui/components/ChartDataTable.js.map +1 -0
  955. package/dist/ui/components/ChoiceMenu.js +48 -0
  956. package/dist/ui/components/ChoiceMenu.js.map +1 -0
  957. package/dist/ui/components/DataTable.d.ts +82 -0
  958. package/dist/ui/components/DataTable.js +214 -0
  959. package/dist/ui/components/DataTable.js.map +1 -0
  960. package/dist/ui/components/LabeledSelect.js +62 -0
  961. package/dist/ui/components/LabeledSelect.js.map +1 -0
  962. package/dist/ui/components/LiveAnnouncement.js +21 -0
  963. package/dist/ui/components/LiveAnnouncement.js.map +1 -0
  964. package/dist/ui/components/MetricCard.d.ts +38 -0
  965. package/dist/ui/components/MetricCard.js +39 -0
  966. package/dist/ui/components/MetricCard.js.map +1 -0
  967. package/dist/ui/components/NoValue.js +22 -0
  968. package/dist/ui/components/NoValue.js.map +1 -0
  969. package/dist/ui/components/ReadState.js +27 -0
  970. package/dist/ui/components/ReadState.js.map +1 -0
  971. package/dist/ui/components/RefreshButton.js +25 -0
  972. package/dist/ui/components/RefreshButton.js.map +1 -0
  973. package/dist/ui/components/SourcesNoticeBanner.js +20 -0
  974. package/dist/ui/components/SourcesNoticeBanner.js.map +1 -0
  975. package/dist/ui/cssVars.js +7 -0
  976. package/dist/ui/cssVars.js.map +1 -0
  977. package/dist/ui/data/WithScopeToken.d.ts +20 -0
  978. package/dist/ui/data/WithScopeToken.js +20 -0
  979. package/dist/ui/data/WithScopeToken.js.map +1 -0
  980. package/dist/ui/data/clientFieldProps.js +16 -0
  981. package/dist/ui/data/clientFieldProps.js.map +1 -0
  982. package/dist/ui/data/request.d.ts +46 -0
  983. package/dist/ui/data/request.js +119 -0
  984. package/dist/ui/data/request.js.map +1 -0
  985. package/dist/ui/data/scopeTokenContext.js +18 -0
  986. package/dist/ui/data/scopeTokenContext.js.map +1 -0
  987. package/dist/ui/data/sharedCache.js +48 -0
  988. package/dist/ui/data/sharedCache.js.map +1 -0
  989. package/dist/ui/data/useRequest.d.ts +19 -0
  990. package/dist/ui/data/useRequest.js +123 -0
  991. package/dist/ui/data/useRequest.js.map +1 -0
  992. package/dist/ui/data/useRequestScope.js +25 -0
  993. package/dist/ui/data/useRequestScope.js.map +1 -0
  994. package/dist/ui/hooks/useDirection.js +47 -0
  995. package/dist/ui/hooks/useDirection.js.map +1 -0
  996. package/dist/ui/hooks/useDismissOnEscape.js +25 -0
  997. package/dist/ui/hooks/useDismissOnEscape.js.map +1 -0
  998. package/dist/ui/hooks/useLiveAnnouncement.js +57 -0
  999. package/dist/ui/hooks/useLiveAnnouncement.js.map +1 -0
  1000. package/dist/ui/hooks/useRealtimePoll.js +112 -0
  1001. package/dist/ui/hooks/useRealtimePoll.js.map +1 -0
  1002. package/dist/ui/readState.js +19 -0
  1003. package/dist/ui/readState.js.map +1 -0
  1004. package/dist/ui/rows/toDisplayRows.js +49 -0
  1005. package/dist/ui/rows/toDisplayRows.js.map +1 -0
  1006. package/dist/ui/viewerClock.js +7 -0
  1007. package/dist/ui/viewerClock.js.map +1 -0
  1008. package/dist/view/AnalyticsNavLink.d.ts +5 -3
  1009. package/dist/view/AnalyticsNavLink.js +12 -8
  1010. package/dist/view/AnalyticsNavLink.js.map +1 -1
  1011. package/dist/view/AnalyticsView.d.ts +9 -10
  1012. package/dist/view/AnalyticsView.js +47 -19
  1013. package/dist/view/AnalyticsView.js.map +1 -1
  1014. package/dist/view/AnalyticsViewClient.d.ts +4 -7
  1015. package/dist/view/AnalyticsViewClient.js +15 -174
  1016. package/dist/view/AnalyticsViewClient.js.map +1 -1
  1017. package/dist/view/CountryFlag.d.ts +27 -0
  1018. package/dist/view/CountryFlag.js +44 -0
  1019. package/dist/view/CountryFlag.js.map +1 -0
  1020. package/dist/view/DocumentTitle.js +27 -0
  1021. package/dist/view/DocumentTitle.js.map +1 -0
  1022. package/dist/view/ViewRoot.d.ts +21 -0
  1023. package/dist/view/ViewRoot.js +155 -0
  1024. package/dist/view/ViewRoot.js.map +1 -0
  1025. package/dist/view/ViewSections.d.ts +38 -0
  1026. package/dist/view/ViewSections.js +190 -0
  1027. package/dist/view/ViewSections.js.map +1 -0
  1028. package/dist/view/authRedirect.js +2 -4
  1029. package/dist/view/authRedirect.js.map +1 -1
  1030. package/dist/view/consentShare.js +15 -0
  1031. package/dist/view/consentShare.js.map +1 -0
  1032. package/dist/view/conversionRate.js +9 -7
  1033. package/dist/view/conversionRate.js.map +1 -1
  1034. package/dist/view/dayRange.js +6 -10
  1035. package/dist/view/dayRange.js.map +1 -1
  1036. package/dist/view/exclusionLink.d.ts +27 -0
  1037. package/dist/view/exclusionLink.js +46 -0
  1038. package/dist/view/exclusionLink.js.map +1 -0
  1039. package/dist/view/flagSrc.js +14 -0
  1040. package/dist/view/flagSrc.js.map +1 -0
  1041. package/dist/view/gating.d.ts +15 -1
  1042. package/dist/view/gating.js +92 -20
  1043. package/dist/view/gating.js.map +1 -1
  1044. package/dist/view/hostCountryFlag.js +41 -0
  1045. package/dist/view/hostCountryFlag.js.map +1 -0
  1046. package/dist/view/labels.js +120 -3
  1047. package/dist/view/labels.js.map +1 -1
  1048. package/dist/view/metricAliases.js +10 -0
  1049. package/dist/view/metricAliases.js.map +1 -0
  1050. package/dist/view/navLabel.js +15 -0
  1051. package/dist/view/navLabel.js.map +1 -0
  1052. package/dist/view/registerView.js +13 -11
  1053. package/dist/view/registerView.js.map +1 -1
  1054. package/dist/view/scopeLabel.js +21 -0
  1055. package/dist/view/scopeLabel.js.map +1 -0
  1056. package/dist/view/sections/Breakdowns.js +221 -118
  1057. package/dist/view/sections/Breakdowns.js.map +1 -1
  1058. package/dist/view/sections/EmptyStates.js +120 -32
  1059. package/dist/view/sections/EmptyStates.js.map +1 -1
  1060. package/dist/view/sections/ExcludeBrowser.js +188 -0
  1061. package/dist/view/sections/ExcludeBrowser.js.map +1 -0
  1062. package/dist/view/sections/FilterChips.js +130 -25
  1063. package/dist/view/sections/FilterChips.js.map +1 -1
  1064. package/dist/view/sections/GoalsPanel.js +68 -59
  1065. package/dist/view/sections/GoalsPanel.js.map +1 -1
  1066. package/dist/view/sections/OverviewCards.js +42 -36
  1067. package/dist/view/sections/OverviewCards.js.map +1 -1
  1068. package/dist/view/sections/RealtimeStrip.js +70 -56
  1069. package/dist/view/sections/RealtimeStrip.js.map +1 -1
  1070. package/dist/view/sections/SectionBoundary.js +34 -0
  1071. package/dist/view/sections/SectionBoundary.js.map +1 -0
  1072. package/dist/view/sections/Toolbar.d.ts +11 -0
  1073. package/dist/view/sections/Toolbar.js +182 -116
  1074. package/dist/view/sections/Toolbar.js.map +1 -1
  1075. package/dist/view/sections/Trend.js +179 -73
  1076. package/dist/view/sections/Trend.js.map +1 -1
  1077. package/dist/view/state.d.ts +42 -0
  1078. package/dist/view/state.js +97 -53
  1079. package/dist/view/state.js.map +1 -1
  1080. package/dist/view/useViewClock.js +31 -0
  1081. package/dist/view/useViewClock.js.map +1 -0
  1082. package/dist/view/useViewQueries.d.ts +21 -0
  1083. package/dist/view/useViewQueries.js +50 -79
  1084. package/dist/view/useViewQueries.js.map +1 -1
  1085. package/dist/view/useViewState.js +42 -0
  1086. package/dist/view/useViewState.js.map +1 -0
  1087. package/dist/view/useViewUrl.js +52 -0
  1088. package/dist/view/useViewUrl.js.map +1 -0
  1089. package/dist/view/viewBody.js +30 -0
  1090. package/dist/view/viewBody.js.map +1 -0
  1091. package/dist/view/viewContext.d.ts +81 -0
  1092. package/dist/view/viewContext.js +49 -0
  1093. package/dist/view/viewContext.js.map +1 -0
  1094. package/dist/view/viewProps.d.ts +65 -8
  1095. package/dist/view/viewProps.js +123 -36
  1096. package/dist/view/viewProps.js.map +1 -1
  1097. package/dist/widgets/AnalyticsBreakdownWidget.d.ts +7 -3
  1098. package/dist/widgets/AnalyticsBreakdownWidget.js +153 -78
  1099. package/dist/widgets/AnalyticsBreakdownWidget.js.map +1 -1
  1100. package/dist/widgets/AnalyticsGoalsWidget.d.ts +6 -7
  1101. package/dist/widgets/AnalyticsGoalsWidget.js +126 -159
  1102. package/dist/widgets/AnalyticsGoalsWidget.js.map +1 -1
  1103. package/dist/widgets/AnalyticsMetricWidget.d.ts +7 -3
  1104. package/dist/widgets/AnalyticsMetricWidget.js +85 -83
  1105. package/dist/widgets/AnalyticsMetricWidget.js.map +1 -1
  1106. package/dist/widgets/AnalyticsRealtimeWidget.d.ts +7 -3
  1107. package/dist/widgets/AnalyticsRealtimeWidget.js +81 -61
  1108. package/dist/widgets/AnalyticsRealtimeWidget.js.map +1 -1
  1109. package/dist/widgets/AnalyticsTrendWidget.d.ts +7 -3
  1110. package/dist/widgets/AnalyticsTrendWidget.js +134 -100
  1111. package/dist/widgets/AnalyticsTrendWidget.js.map +1 -1
  1112. package/dist/widgets/ComparisonDelta.js +33 -42
  1113. package/dist/widgets/ComparisonDelta.js.map +1 -1
  1114. package/dist/widgets/RealtimeCounter.d.ts +27 -3
  1115. package/dist/widgets/RealtimeCounter.js +90 -62
  1116. package/dist/widgets/RealtimeCounter.js.map +1 -1
  1117. package/dist/widgets/WidgetCard.d.ts +80 -0
  1118. package/dist/widgets/WidgetCard.js +99 -0
  1119. package/dist/widgets/WidgetCard.js.map +1 -0
  1120. package/dist/widgets/WidgetFrame.js +42 -0
  1121. package/dist/widgets/WidgetFrame.js.map +1 -0
  1122. package/dist/widgets/WidgetShimmer.d.ts +55 -0
  1123. package/dist/widgets/WidgetShimmer.js +86 -0
  1124. package/dist/widgets/WidgetShimmer.js.map +1 -0
  1125. package/dist/widgets/breakdownTypes.js +18 -2
  1126. package/dist/widgets/breakdownTypes.js.map +1 -1
  1127. package/dist/widgets/customWidget.d.ts +5 -1
  1128. package/dist/widgets/customWidget.js +6 -7
  1129. package/dist/widgets/customWidget.js.map +1 -1
  1130. package/dist/widgets/defaultLayout.d.ts +26 -0
  1131. package/dist/widgets/defaultLayout.js +51 -0
  1132. package/dist/widgets/defaultLayout.js.map +1 -0
  1133. package/dist/widgets/defaults.d.ts +4 -3
  1134. package/dist/widgets/defaults.js +76 -24
  1135. package/dist/widgets/defaults.js.map +1 -1
  1136. package/dist/widgets/fieldRows.js +14 -0
  1137. package/dist/widgets/fieldRows.js.map +1 -0
  1138. package/dist/widgets/filterCaption.js +26 -0
  1139. package/dist/widgets/filterCaption.js.map +1 -0
  1140. package/dist/widgets/filterField.d.ts +15 -0
  1141. package/dist/widgets/filterField.js +86 -0
  1142. package/dist/widgets/filterField.js.map +1 -0
  1143. package/dist/widgets/filterValueLabel.d.ts +1 -0
  1144. package/dist/widgets/filterValueLabel.js +45 -0
  1145. package/dist/widgets/filterValueLabel.js.map +1 -0
  1146. package/dist/widgets/notices.js +79 -0
  1147. package/dist/widgets/notices.js.map +1 -0
  1148. package/dist/widgets/prepareWidgetRead.d.ts +24 -0
  1149. package/dist/widgets/prepareWidgetRead.js +110 -0
  1150. package/dist/widgets/prepareWidgetRead.js.map +1 -0
  1151. package/dist/widgets/range.js +26 -21
  1152. package/dist/widgets/range.js.map +1 -1
  1153. package/dist/widgets/readForWidget.d.ts +32 -13
  1154. package/dist/widgets/readForWidget.js +52 -63
  1155. package/dist/widgets/readForWidget.js.map +1 -1
  1156. package/dist/widgets/readForWidgetBreakdown.d.ts +45 -18
  1157. package/dist/widgets/readForWidgetBreakdown.js +71 -58
  1158. package/dist/widgets/readForWidgetBreakdown.js.map +1 -1
  1159. package/dist/widgets/readForWidgetGoals.d.ts +21 -17
  1160. package/dist/widgets/readForWidgetGoals.js +72 -52
  1161. package/dist/widgets/readForWidgetGoals.js.map +1 -1
  1162. package/dist/widgets/readForWidgetRealtime.d.ts +24 -11
  1163. package/dist/widgets/readForWidgetRealtime.js +69 -41
  1164. package/dist/widgets/readForWidgetRealtime.js.map +1 -1
  1165. package/dist/widgets/readForWidgetSeries.d.ts +29 -24
  1166. package/dist/widgets/readForWidgetSeries.js +66 -114
  1167. package/dist/widgets/readForWidgetSeries.js.map +1 -1
  1168. package/dist/widgets/readMeta.d.ts +48 -0
  1169. package/dist/widgets/readMeta.js +66 -0
  1170. package/dist/widgets/readMeta.js.map +1 -0
  1171. package/dist/widgets/realtimePoll.d.ts +1 -0
  1172. package/dist/widgets/realtimePoll.js +56 -16
  1173. package/dist/widgets/realtimePoll.js.map +1 -1
  1174. package/dist/widgets/registerWidgets.js +207 -124
  1175. package/dist/widgets/registerWidgets.js.map +1 -1
  1176. package/dist/widgets/stateKeys.js +30 -0
  1177. package/dist/widgets/stateKeys.js.map +1 -0
  1178. package/dist/widgets/titleForecast.js +89 -0
  1179. package/dist/widgets/titleForecast.js.map +1 -0
  1180. package/dist/widgets/types.d.ts +16 -0
  1181. package/dist/widgets/types.js +2 -0
  1182. package/dist/widgets/types.js.map +1 -1
  1183. package/dist/widgets/viewLink.d.ts +24 -6
  1184. package/dist/widgets/viewLink.js +36 -26
  1185. package/dist/widgets/viewLink.js.map +1 -1
  1186. package/dist/widgets/widgetData.js +34 -0
  1187. package/dist/widgets/widgetData.js.map +1 -0
  1188. package/dist/widgets/widgetWindow.d.ts +1 -0
  1189. package/dist/widgets/widgetWindow.js +51 -0
  1190. package/dist/widgets/widgetWindow.js.map +1 -0
  1191. package/package.json +61 -42
  1192. package/dist/capture/getTrackerConfig.d.ts +0 -20
  1193. package/dist/capture/getTrackerConfig.js +0 -31
  1194. package/dist/capture/getTrackerConfig.js.map +0 -1
  1195. package/dist/capture/slots.d.ts +0 -8
  1196. package/dist/capture/trackerConfig.d.ts +0 -33
  1197. package/dist/charts/styles.js +0 -59
  1198. package/dist/charts/styles.js.map +0 -1
  1199. package/dist/exports/next.d.ts +0 -3
  1200. package/dist/exports/next.js +0 -3
  1201. package/dist/fields/config/SourceSelectField.d.ts +0 -14
  1202. package/dist/fields/dateRange/styles.js +0 -23
  1203. package/dist/fields/dateRange/styles.js.map +0 -1
  1204. package/dist/goals/GoalSelectField.d.ts +0 -7
  1205. package/dist/native/collections/events.js +0 -121
  1206. package/dist/native/collections/events.js.map +0 -1
  1207. package/dist/native/collections/rollups.js +0 -151
  1208. package/dist/native/collections/rollups.js.map +0 -1
  1209. package/dist/native/collections/seen.js +0 -47
  1210. package/dist/native/collections/seen.js.map +0 -1
  1211. package/dist/native/ingest/flushBatch.js +0 -60
  1212. package/dist/native/ingest/flushBatch.js.map +0 -1
  1213. package/dist/native/ingest/salt.js +0 -14
  1214. package/dist/native/ingest/salt.js.map +0 -1
  1215. package/dist/native/ingest/writeBuffer.js +0 -55
  1216. package/dist/native/ingest/writeBuffer.js.map +0 -1
  1217. package/dist/native/ingest/writeEvent.js +0 -14
  1218. package/dist/native/ingest/writeEvent.js.map +0 -1
  1219. package/dist/native/query/eventAgg.js +0 -161
  1220. package/dist/native/query/eventAgg.js.map +0 -1
  1221. package/dist/native/realtime/buildRealtime.js +0 -53
  1222. package/dist/native/realtime/buildRealtime.js.map +0 -1
  1223. package/dist/native/retention/pruneTask.js +0 -29
  1224. package/dist/native/retention/pruneTask.js.map +0 -1
  1225. package/dist/native/rollupAcc.js +0 -64
  1226. package/dist/native/rollupAcc.js.map +0 -1
  1227. package/dist/native/rollups/applyDistinctDeltas.js +0 -9
  1228. package/dist/native/rollups/applyDistinctDeltas.js.map +0 -1
  1229. package/dist/native/rollups/bumpRollup.js +0 -73
  1230. package/dist/native/rollups/bumpRollup.js.map +0 -1
  1231. package/dist/native/rollups/deltas.js +0 -90
  1232. package/dist/native/rollups/deltas.js.map +0 -1
  1233. package/dist/native/rollups/insertIfNew.js +0 -53
  1234. package/dist/native/rollups/insertIfNew.js.map +0 -1
  1235. package/dist/next/captureRewrites.d.ts +0 -41
  1236. package/dist/next/captureRewrites.js +0 -56
  1237. package/dist/next/captureRewrites.js.map +0 -1
  1238. package/dist/next/posthogProxyRewrites.d.ts +0 -41
  1239. package/dist/next/posthogProxyRewrites.js +0 -45
  1240. package/dist/next/posthogProxyRewrites.js.map +0 -1
  1241. package/dist/plugin/paths.js +0 -27
  1242. package/dist/plugin/paths.js.map +0 -1
  1243. package/dist/query/errors.js +0 -10
  1244. package/dist/query/errors.js.map +0 -1
  1245. package/dist/react/TrackerBoot.d.ts +0 -22
  1246. package/dist/rsc/AnalyticsScripts.d.ts +0 -30
  1247. package/dist/rsc/AnalyticsScripts.js +0 -41
  1248. package/dist/rsc/AnalyticsScripts.js.map +0 -1
  1249. package/dist/surfacing/queue.js +0 -60
  1250. package/dist/surfacing/queue.js.map +0 -1
  1251. package/dist/surfacing/retryPolicy.js +0 -15
  1252. package/dist/surfacing/retryPolicy.js.map +0 -1
  1253. package/dist/tracker/autoCapture.d.ts +0 -48
  1254. package/dist/tracker/consent.d.ts +0 -24
  1255. package/dist/tracker/consent.js +0 -48
  1256. package/dist/tracker/consent.js.map +0 -1
  1257. package/dist/tracker/loadScript.d.ts +0 -14
  1258. package/dist/tracker/pageTracking.d.ts +0 -17
  1259. package/dist/tracker/registry.d.ts +0 -27
  1260. package/dist/tracker/sinks/native.d.ts +0 -22
  1261. package/dist/tracker/sinks/plausible.d.ts +0 -14
  1262. package/dist/tracker/sinks/posthog.d.ts +0 -14
  1263. package/dist/tracker/sinks/umami.d.ts +0 -13
  1264. package/dist/tracker/sinks/vendor.d.ts +0 -14
  1265. package/dist/view/sections/styles.js +0 -74
  1266. package/dist/view/sections/styles.js.map +0 -1
  1267. package/dist/widgets/WidgetViewLink.js +0 -17
  1268. package/dist/widgets/WidgetViewLink.js.map +0 -1
  1269. package/dist/widgets/cardChrome.d.ts +0 -8
  1270. package/dist/widgets/cardChrome.js +0 -46
  1271. package/dist/widgets/cardChrome.js.map +0 -1
  1272. package/dist/widgets/comparison.js +0 -43
  1273. package/dist/widgets/comparison.js.map +0 -1
@@ -1 +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 { 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}\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\tconst key = buildCacheKey(adapter.id, q)\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\tconst ttl = 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":";;;;;;;AASA,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;AAiBA,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;EACrD,MAAM,MAAM,cAAc,QAAQ,IAAI,CAAC;EACvC,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;GACH,MAAM,MAAM,KAAK,IAAI,aAAa,QAAQ,aAAa,eAAe;GACtE,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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"}
@@ -0,0 +1 @@
1
+ import { Payload } from "payload";
@@ -0,0 +1,116 @@
1
+ import { currentTime } from "../core/clock.js";
2
+ import { remember } from "./bounded.js";
3
+ //#region src/surfacing/epoch.ts
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
+ };
42
+ /**
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.
45
+ */
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);
51
+ const readValue = (stored) => {
52
+ const value = stored?.value;
53
+ return typeof value === "string" && value !== "" ? value : "0";
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
+ });
62
+ /**
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.
65
+ */
66
+ function createEpochStore(payload, opts = {}) {
67
+ const memoMs = opts.memoMs ?? DEFAULT_MEMO_MS;
68
+ const now = opts.now ?? currentTime;
69
+ const backend = opts.backend ?? kvEpochBackend(payload);
70
+ const memo = /* @__PURE__ */ new Map();
71
+ const fallback = createEpochFallback(now);
72
+ let warned = false;
73
+ return {
74
+ async get(scope) {
75
+ const key = epochKeyFor(scope);
76
+ const at = now();
77
+ const hit = memo.get(key);
78
+ if (hit && hit.expiresAt > at) return hit.value;
79
+ let value;
80
+ try {
81
+ value = fallback.read(scope, await backend.get(scope));
82
+ } catch (err) {
83
+ value = fallback.failed(scope);
84
+ if (!warned) {
85
+ warned = true;
86
+ payload.logger?.warn(`analytics: cache epoch read failed, falling back to the last epoch this instance read: ${String(err)}`);
87
+ }
88
+ }
89
+ remember(memo, [key, {
90
+ value,
91
+ expiresAt: at + memoMs
92
+ }]);
93
+ return value;
94
+ },
95
+ async bump(scope) {
96
+ const key = epochKeyFor(scope);
97
+ const at = now();
98
+ const next = freshToken(at);
99
+ try {
100
+ await backend.set(scope, next);
101
+ remember(memo, [key, {
102
+ value: fallback.read(scope, next),
103
+ expiresAt: at + memoMs
104
+ }]);
105
+ return next;
106
+ } catch (err) {
107
+ payload.logger?.warn(`analytics: cache epoch bump failed for scope "${scope || "global"}": ${String(err)}`);
108
+ throw err;
109
+ }
110
+ }
111
+ };
112
+ }
113
+ //#endregion
114
+ export { configEpochKeyFor, createEpochFallback, createEpochStore, epochKeyFor, epochsFor, kvEpochBackend };
115
+
116
+ //# sourceMappingURL=epoch.js.map
@@ -0,0 +1 @@
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":";;;AAoBA,MAAM,kBAAkB;;AASxB,MAAM,kBAAkB;;AAGxB,MAAM,cAAc,OAAuB,GAAG,GAAG,SAAS,EAAE,EAAE,GAAG,OAAO,WAAW,EAAE,MAAM,GAAG,CAAC;AAe/F,MAAa,uBAAuB,MAAoB,gBAA+B;CACtF,MAAM,uBAAO,IAAI,IAAoB;CACrC,MAAM,0BAAU,IAAI,IAAoB;CACxC,MAAM,SAAS,UAA6C,SAAS;CACrE,MAAM,UAAU,UAA6C;EAC5D,MAAM,MAAM,MAAM,KAAK;EACvB,MAAM,QAAQ,QAAQ,IAAI,GAAG;EAC7B,IAAI,UAAU,KAAA,GACb,OAAO;EAER,IAAI,QAAQ,QAAQ,iBACnB,QAAQ,MAAM;EAEf,MAAM,QAAQ,UAAU,WAAW,IAAI,CAAC;EACxC,QAAQ,IAAI,KAAK,KAAK;EACtB,OAAO;CACR;CACA,OAAO;EACN,KAAK,OAAO,OAAO;GAClB,MAAM,MAAM,MAAM,KAAK;GACvB,IAAI,KAAK,QAAQ,mBAAmB,CAAC,KAAK,IAAI,GAAG,GAChD,KAAK,MAAM;GAEZ,KAAK,IAAI,KAAK,KAAK;GACnB,QAAQ,OAAO,GAAG;GAClB,OAAO;EACR;EACA,SAAS,UAAU,KAAK,IAAI,MAAM,KAAK,CAAC,KAAK,OAAO,KAAK;EACzD;CACD;AACD;;AAUA,MAAa,YAAY,OACxB,SACA,UAC6B;CAC7B,MAAM,CAAC,QAAQ,WAAW,MAAM,QAAQ,IAAI,CAC3C,QAAQ,SAAS,KAAK,KAAA,KACtB,QAAQ,SAAS,IAAI,KAAK,KAAA,GAC3B,CAAC;CACD,OAAO;EAAE;EAAQ;CAAQ;AAC1B;;;;;AAMA,MAAM,aAAa,QAAgB,UAClC,UAAU,QAAQ,UAAU,KAAA,KAAa,UAAU,KAChD,GAAG,OAAO,WACV,GAAG,OAAO,KAAK,mBAAmB,KAAK;;AAG3C,MAAa,eAAe,UAAkC,UAAU,mBAAmB,KAAK;;AAGhG,MAAa,qBAAqB,UACjC,UAAU,0BAA0B,KAAK;AAM1C,MAAM,aAAa,WAAuC;CACzD,MAAM,QAAQ,QAAQ;CACtB,OAAO,OAAO,UAAU,YAAY,UAAU,KAAK,QAAA;AACpD;;AAUA,MAAa,kBACZ,SACA,SAA4C,iBACzB;CACnB,KAAK,OAAO,UAAU,UAAU,MAAM,QAAQ,GAAG,IAAiB,OAAO,KAAK,CAAC,CAAC;CAChF,KAAK,OAAO,OAAO,UAAU;EAC5B,MAAM,QAAQ,GAAG,IAAI,OAAO,KAAK,GAAG,EAAE,OAAO,MAAM,CAAC;CACrD;AACD;;;;;AAMA,SAAgB,iBAAiB,SAAkB,OAA0B,CAAC,GAAe;CAC5F,MAAM,SAAS,KAAK,UAAU;CAC9B,MAAM,MAAM,KAAK,OAAO;CACxB,MAAM,UAAU,KAAK,WAAW,eAAe,OAAO;CACtD,MAAM,uBAAO,IAAI,IAAkD;CACnE,MAAM,WAAW,oBAAoB,GAAG;CACxC,IAAI,SAAS;CAEb,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;GACJ,IAAI;IACH,QAAQ,SAAS,KAAK,OAAO,MAAM,QAAQ,IAAI,KAAK,CAAC;GACtD,SAAS,KAAK;IAGb,QAAQ,SAAS,OAAO,KAAK;IAC7B,IAAI,CAAC,QAAQ;KACZ,SAAS;KACT,QAAQ,QAAQ,KACf,0FAA0F,OAAO,GAAG,GACrG;IACD;GACD;GACA,SAAS,MAAM,CAAC,KAAK;IAAE;IAAO,WAAW,KAAK;GAAO,CAAC,CAAC;GACvD,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,IAAI,OAAO,IAAI;IAC7B,SAAS,MAAM,CAAC,KAAK;KAAE,OAAO,SAAS,KAAK,OAAO,IAAI;KAAG,WAAW,KAAK;IAAO,CAAC,CAAC;IACnF,OAAO;GACR,SAAS,KAAK;IAGb,QAAQ,QAAQ,KACf,iDAAiD,SAAS,SAAS,KAAK,OAAO,GAAG,GACnF;IACA,MAAM;GACP;EACD;CACD;AACD"}
@@ -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
@@ -0,0 +1 @@
1
+ {"version":3,"file":"lanes.js","names":[],"sources":["../../src/surfacing/lanes.ts"],"sourcesContent":["import type { AnalyticsAdapter } from '../core/contract'\nimport { monotonicMs } from '../core/monotonic'\nimport { recallOr } from './bounded'\nimport { BREAKER_MAX_MS, type Breaker, type BreakerOptions, createBreaker } from './breaker'\nimport {\n\tclassifyError,\n\tisLaneRefused,\n\tLaneRefusedError,\n\ttype ReadFailure,\n\ttype ReadFailureKind,\n} from './classifyError'\nimport { createTokenSource, mostUrgent, type Priority } from './rateLimiter'\n\nexport type { Priority } from './rateLimiter'\n\n/** Upstream requests in flight across every vendor source of one instance, by default. */\nexport const DEFAULT_GLOBAL_CONCURRENCY = 16\n\n/** Upstream requests in flight per vendor source that declares no `rateLimit.maxConcurrent`. */\nexport const DEFAULT_SOURCE_CONCURRENCY = 4\n\n/** Reads in flight on a local source (native), which stays outside the global cap. */\nconst DEFAULT_LOCAL_CONCURRENCY = 8\n\n/** The fewest and most native reads in flight when the lane is sized from a Postgres pool. */\nconst MIN_POOLED_CONCURRENCY = 1\nexport const MAX_POOLED_CONCURRENCY = 8\n\n/**\n * Native lane size on a host Postgres pool of `poolMax`: a third, capped at the engine's long-work\n * share, so reads queue in the lane (deadline and priority aware), not unseen for a connection.\n */\nexport const pooledConcurrency = (poolMax: number): number =>\n\tMath.min(MAX_POOLED_CONCURRENCY, Math.max(MIN_POOLED_CONCURRENCY, Math.floor(poolMax / 3)))\n\n/** The slots one scope may hold at once in a lane every scope shares: half, rounded up. */\nconst scopeShareOf = (capacity: number): number => Math.max(1, Math.ceil(capacity / 2))\n\n/** Retries of an upstream request that failed as `unavailable`, with backoff between them. */\nconst MAX_RETRIES = 2\n\n/** The first backoff, 0.5 s; the second is 1.25 s (see {@link runUpstream}). */\nexport const RETRY_BASE_MS = 500\n\n/**\n * How long a request may stay out after its signal aborted before its slots are given back: one\n * that honours the signal settles at once, and GA4's own gRPC deadline ends with the read.\n */\nexport const ABANDON_AFTER_MS = 5_000\n\nexport interface LaneRunOptions {\n\tsignal: AbortSignal\n\tpriority: Priority\n\t/** Epoch milliseconds the caller gives up at: a wait that would outlast it is refused at once. */\n\tdeadline?: number\n}\n\nexport interface LaneHealth {\n\t/** The lane refuses new requests right now: its breaker is open. */\n\topen: boolean\n\t/** Until the lane takes requests again, when open or the vendor asked it to wait. */\n\tretryAfterMs?: number\n\t/** What the failure that last counted against the lane meant, cleared by a success. */\n\tlastFailure?: ReadFailureKind\n\t/** That failure was a refused host. */\n\thostRefused?: true\n\t/**\n\t * Requests whose slots were given back while they were still out, having ignored their abort\n\t * signal for {@link ABANDON_AFTER_MS}; absent while there are none.\n\t */\n\tabandoned?: number\n}\n\n/**\n * One adapter's requests for one scope. A `run` takes a rate token, a lane slot and a global slot\n * in that order; the pause, tokens and slots are the adapter's, the breaker each scope's own.\n */\nexport interface Lane {\n\trun<T>(fn: (signal: AbortSignal) => Promise<T>, options: LaneRunOptions): Promise<T>\n\thealth(): LaneHealth\n}\n\nexport interface Lanes {\n\t/**\n\t * The lane of one adapter instance for `scope`, made on first use; for an adapter built anew on\n\t * every read, the lane of its id within `scope`.\n\t */\n\tfor(adapter: AnalyticsAdapter, scope?: string | null): Lane\n}\n\nexport interface LanesOptions {\n\t/** Slots shared by every vendor source; default {@link DEFAULT_GLOBAL_CONCURRENCY}. */\n\tglobal?: number\n\t/** Slots of a source without `maxConcurrent`; default {@link DEFAULT_SOURCE_CONCURRENCY}. */\n\tperSource?: number\n\t/** Which sources are local (native), which get their own lane outside the global cap. */\n\tlocal?: { is: (adapter: AnalyticsAdapter) => boolean; capacity?: number }\n\t/** Clock for waits and deadlines; the timers' monotonic one (`monotonicMs`) by default. */\n\tnow?: () => number\n\t/**\n\t * Adapters built anew per read (`providers.resolve`): keyed by scope and id rather than object,\n\t * so each keeps one lane, and two tenants' sources of one id never share a breaker.\n\t */\n\trebuilt?: (adapter: AnalyticsAdapter) => boolean\n\t/**\n\t * Which adapters serve every scope through one lane (the config adapters of a scoped install):\n\t * one scope holds at most {@link scopeShareOf} of their slots, so another always gets one.\n\t */\n\tshared?: (adapter: AnalyticsAdapter) => boolean\n\tbreaker?: Omit<BreakerOptions, 'now'>\n\t/** How long a request may ignore its abort before its slots return; {@link ABANDON_AFTER_MS}. */\n\tabandonAfterMs?: number\n\t/** Told the first time a lane gives back the slots of a request that ignored its abort signal. */\n\tonAbandon?: (adapter: AnalyticsAdapter) => void\n}\n\ntype Release = () => void\n\n/** The install-wide scope (null) is keyed `''`; it never counts against a scope's share. */\nconst UNSCOPED = ''\n\nconst scopeKeyOf = (scope: string | null | undefined): string =>\n\tscope === null || scope === undefined ? UNSCOPED : `s:${scope}`\n\ninterface Slots {\n\tacquire(priority: Priority, signal: AbortSignal, scope?: string): Promise<Release>\n}\n\ninterface SlotWaiter {\n\tpriority: Priority\n\tscope: string\n\tgrant: () => void\n}\n\n/**\n * A counting semaphore serving the most urgent waiter first, never more than `backgroundCap` slots\n * to background work, and, given a `scopeCap`, never more than that many to one scope.\n */\nconst createSlots = (capacity: number, backgroundCap: number, scopeCap?: number): Slots => {\n\tlet active = 0\n\tlet background = 0\n\tconst waiters: SlotWaiter[] = []\n\tconst heldBy = new Map<string, number>()\n\n\tconst withinShare = (waiter: SlotWaiter): boolean =>\n\t\tscopeCap === undefined ||\n\t\twaiter.scope === UNSCOPED ||\n\t\t(heldBy.get(waiter.scope) ?? 0) < scopeCap\n\n\tconst pick = (): SlotWaiter | undefined =>\n\t\tmostUrgent(\n\t\t\twaiters.filter(\n\t\t\t\t(waiter) =>\n\t\t\t\t\twithinShare(waiter) && (waiter.priority !== 'background' || background < backgroundCap)\n\t\t\t)\n\t\t)\n\n\tconst hold = (scope: string, by: number): void => {\n\t\tconst next = (heldBy.get(scope) ?? 0) + by\n\t\tif (next > 0) {\n\t\t\theldBy.set(scope, next)\n\t\t} else {\n\t\t\theldBy.delete(scope)\n\t\t}\n\t}\n\n\tconst pump = (): void => {\n\t\twhile (active < capacity) {\n\t\t\tconst chosen = pick()\n\t\t\tif (!chosen) {\n\t\t\t\treturn\n\t\t\t}\n\t\t\twaiters.splice(waiters.indexOf(chosen), 1)\n\t\t\tactive++\n\t\t\thold(chosen.scope, 1)\n\t\t\tif (chosen.priority === 'background') {\n\t\t\t\tbackground++\n\t\t\t}\n\t\t\tchosen.grant()\n\t\t}\n\t}\n\n\treturn {\n\t\tacquire(priority, signal, scope = UNSCOPED) {\n\t\t\tif (signal.aborted) {\n\t\t\t\treturn Promise.reject(signal.reason)\n\t\t\t}\n\t\t\treturn new Promise<Release>((resolve, reject) => {\n\t\t\t\tlet released = false\n\t\t\t\tconst release = (): void => {\n\t\t\t\t\tif (released) {\n\t\t\t\t\t\treturn\n\t\t\t\t\t}\n\t\t\t\t\treleased = true\n\t\t\t\t\tactive--\n\t\t\t\t\thold(scope, -1)\n\t\t\t\t\tif (priority === 'background') {\n\t\t\t\t\t\tbackground--\n\t\t\t\t\t}\n\t\t\t\t\tpump()\n\t\t\t\t}\n\t\t\t\tconst onAbort = (): void => {\n\t\t\t\t\tconst index = waiters.indexOf(waiter)\n\t\t\t\t\tif (index !== -1) {\n\t\t\t\t\t\twaiters.splice(index, 1)\n\t\t\t\t\t}\n\t\t\t\t\treject(signal.reason)\n\t\t\t\t}\n\t\t\t\tconst waiter: SlotWaiter = {\n\t\t\t\t\tpriority,\n\t\t\t\t\tscope,\n\t\t\t\t\tgrant: () => {\n\t\t\t\t\t\tsignal.removeEventListener('abort', onAbort)\n\t\t\t\t\t\tresolve(release)\n\t\t\t\t\t},\n\t\t\t\t}\n\t\t\t\twaiters.push(waiter)\n\t\t\t\tsignal.addEventListener('abort', onAbort, { once: true })\n\t\t\t\tpump()\n\t\t\t})\n\t\t},\n\t}\n}\n\n/** Resolves after `ms`, or rejects with the signal's reason once it aborts. */\nconst sleep = (ms: number, signal: AbortSignal): Promise<void> => {\n\tif (signal.aborted) {\n\t\treturn Promise.reject(signal.reason)\n\t}\n\treturn new Promise<void>((resolve, reject) => {\n\t\tconst onAbort = (): void => {\n\t\t\tclearTimeout(timer)\n\t\t\treject(signal.reason)\n\t\t}\n\t\tconst timer = setTimeout(() => {\n\t\t\tsignal.removeEventListener('abort', onAbort)\n\t\t\tresolve()\n\t\t}, ms)\n\t\tsignal.addEventListener('abort', onAbort, { once: true })\n\t})\n}\n\n/**\n * Settles with `work`, or rejects with the signal's reason first: the slot stays held until `work`\n * settles, or until {@link ABANDON_AFTER_MS} after the abort for work that never does.\n */\nconst untilAborted = <T>(work: Promise<T>, signal: AbortSignal): Promise<T> => {\n\tif (signal.aborted) {\n\t\treturn Promise.reject(signal.reason)\n\t}\n\tlet onAbort: (() => void) | undefined\n\tconst aborted = new Promise<never>((_resolve, reject) => {\n\t\tonAbort = () => reject(signal.reason)\n\t\tsignal.addEventListener('abort', onAbort, { once: true })\n\t})\n\treturn Promise.race([work, aborted]).finally(() => {\n\t\tif (onAbort) {\n\t\t\tsignal.removeEventListener('abort', onAbort)\n\t\t}\n\t})\n}\n\nconst noRelease: Release = () => {}\n\ninterface LaneSetup {\n\tadapter: AnalyticsAdapter\n\tcapacity: number\n\tglobal: Slots | undefined\n\tnow: () => number\n\t/** Every scope reads through this lane: each holds at most its share of the slots. */\n\tshared: boolean\n\tbreaker?: Omit<BreakerOptions, 'now'>\n\tabandonAfterMs: number\n\tonAbandon?: (adapter: AnalyticsAdapter) => void\n}\n\n/** What a request that ignored its abort counts as against the breaker. */\nconst ABANDONED: ReadFailure = { kind: 'unavailable', timeout: true }\n\n/** A breaker with nothing to remember: closed, no failure counted since its last answer. */\nconst isClean = (breaker: Breaker): boolean => {\n\tconst snapshot = breaker.snapshot()\n\treturn snapshot.state === 'closed' && snapshot.lastFailure === undefined\n}\n\n/** One adapter's pause, tokens and slots, and one breaker per scope reading through them. */\nconst createLaneCore = (setup: LaneSetup): ((scope: string | null | undefined) => Lane) => {\n\tconst { now } = setup\n\tconst tokens = createTokenSource(setup.adapter.capabilities.rateLimit, now)\n\tconst slots = createSlots(\n\t\tsetup.capacity,\n\t\tMath.max(1, Math.floor(setup.capacity / 2)),\n\t\tsetup.shared ? scopeShareOf(setup.capacity) : undefined\n\t)\n\tconst breakers = new Map<string, Breaker>()\n\tconst views = new Map<string, Lane>()\n\tlet pausedUntil = 0\n\tlet abandoned = 0\n\n\tconst breakerOf = (key: string): Breaker =>\n\t\trecallOr(\n\t\t\tbreakers,\n\t\t\t[key, () => createBreaker({ now, ...setup.breaker })],\n\t\t\t(breaker) => !isClean(breaker)\n\t\t)\n\n\tconst waitOutPause = async (options: LaneRunOptions): Promise<void> => {\n\t\tfor (;;) {\n\t\t\tconst pausedFor = pausedUntil - now()\n\t\t\tif (pausedFor <= 0) {\n\t\t\t\treturn\n\t\t\t}\n\t\t\tif (options.deadline !== undefined && pausedUntil > options.deadline) {\n\t\t\t\tthrow new LaneRefusedError('paused', pausedFor)\n\t\t\t}\n\t\t\tawait sleep(pausedFor, options.signal)\n\t\t}\n\t}\n\n\tconst viewOf = (key: string): Lane => ({\n\t\tasync run(fn, options) {\n\t\t\tconst { signal, priority } = options\n\t\t\tif (signal.aborted) {\n\t\t\t\tthrow signal.reason\n\t\t\t}\n\t\t\tconst breaker = breakerOf(key)\n\t\t\tconst refusedOpen = (retryAfterMs: number): LaneRefusedError =>\n\t\t\t\tnew LaneRefusedError('open', retryAfterMs, breaker.snapshot().lastFailure)\n\t\t\tconst peek = breaker.peek()\n\t\t\tif (!peek.ok) {\n\t\t\t\tthrow refusedOpen(peek.retryAfterMs)\n\t\t\t}\n\t\t\t// A breaker due its probe lets one run through: it is claimed before the run spends a rate\n\t\t\t// token or waits for a slot, so the runs it turns away spend nothing.\n\t\t\tconst claimed = peek.probe ? breaker.admit() : undefined\n\t\t\tif (claimed && !claimed.ok) {\n\t\t\t\tthrow refusedOpen(claimed.retryAfterMs)\n\t\t\t}\n\t\t\tlet releaseLane = noRelease\n\t\t\tlet releaseGlobal = noRelease\n\t\t\tconst releaseSlots = (): void => {\n\t\t\t\treleaseGlobal()\n\t\t\t\treleaseLane()\n\t\t\t}\n\t\t\ttry {\n\t\t\t\tawait waitOutPause(options)\n\t\t\t\tawait tokens.take({ signal, priority })\n\t\t\t\treleaseLane = await slots.acquire(priority, signal, key)\n\t\t\t\treleaseGlobal = setup.global ? await setup.global.acquire(priority, signal) : noRelease\n\t\t\t} catch (err) {\n\t\t\t\treleaseSlots()\n\t\t\t\tif (claimed?.probe) {\n\t\t\t\t\tbreaker.release()\n\t\t\t\t}\n\t\t\t\tthrow err\n\t\t\t}\n\t\t\tconst admission = claimed ?? breaker.admit()\n\t\t\tif (!admission.ok) {\n\t\t\t\treleaseSlots()\n\t\t\t\tthrow refusedOpen(admission.retryAfterMs)\n\t\t\t}\n\t\t\tlet counted = false\n\t\t\tconst record = (outcome: 'success' | ReadFailure): void => {\n\t\t\t\tif (!counted) {\n\t\t\t\t\tcounted = true\n\t\t\t\t\tbreaker.record(outcome, admission.probe)\n\t\t\t\t}\n\t\t\t}\n\t\t\tconst settled = (async () => fn(signal))().then(\n\t\t\t\t(value) => {\n\t\t\t\t\trecord('success')\n\t\t\t\t\treturn value\n\t\t\t\t},\n\t\t\t\t(err: unknown) => {\n\t\t\t\t\tconst failure = classifyError(err)\n\t\t\t\t\trecord(failure)\n\t\t\t\t\tif (failure.kind === 'unavailable' && failure.retryAfterMs !== undefined) {\n\t\t\t\t\t\tpausedUntil = Math.max(\n\t\t\t\t\t\t\tpausedUntil,\n\t\t\t\t\t\t\tnow() + Math.min(failure.retryAfterMs, BREAKER_MAX_MS)\n\t\t\t\t\t\t)\n\t\t\t\t\t}\n\t\t\t\t\tthrow err\n\t\t\t\t}\n\t\t\t)\n\t\t\tlet abandonTimer: ReturnType<typeof setTimeout> | undefined\n\t\t\t// Past the grace a request that ignores its abort gives its slots back, counted as a timeout.\n\t\t\tconst abandon = (): void => {\n\t\t\t\tabandonTimer = setTimeout(() => {\n\t\t\t\t\treleaseSlots()\n\t\t\t\t\trecord(ABANDONED)\n\t\t\t\t\tabandoned++\n\t\t\t\t\tif (abandoned === 1) {\n\t\t\t\t\t\tsetup.onAbandon?.(setup.adapter)\n\t\t\t\t\t}\n\t\t\t\t}, setup.abandonAfterMs)\n\t\t\t\tabandonTimer.unref?.()\n\t\t\t}\n\t\t\tif (signal.aborted) {\n\t\t\t\tabandon()\n\t\t\t} else {\n\t\t\t\tsignal.addEventListener('abort', abandon, { once: true })\n\t\t\t}\n\t\t\tconst done = settled.finally(() => {\n\t\t\t\tsignal.removeEventListener('abort', abandon)\n\t\t\t\tclearTimeout(abandonTimer)\n\t\t\t\treleaseSlots()\n\t\t\t})\n\t\t\t// The caller may stop waiting at the abort; the request still settles, and is not unhandled.\n\t\t\tdone.catch(() => {})\n\t\t\treturn untilAborted(done, signal)\n\t\t},\n\t\thealth() {\n\t\t\tconst breaker = breakers.get(key)\n\t\t\tconst snapshot = breaker?.snapshot()\n\t\t\tconst peek = breaker?.peek() ?? { ok: true as const, probe: false }\n\t\t\tconst pausedFor = pausedUntil - now()\n\t\t\tconst retryAfterMs = Math.max(peek.ok ? 0 : peek.retryAfterMs, pausedFor > 0 ? pausedFor : 0)\n\t\t\tconst last = snapshot?.lastFailure\n\t\t\treturn {\n\t\t\t\topen: !peek.ok,\n\t\t\t\t...(retryAfterMs > 0 ? { retryAfterMs } : {}),\n\t\t\t\t...(last ? { lastFailure: last.kind } : {}),\n\t\t\t\t...(last?.hostRefused ? { hostRefused: true as const } : {}),\n\t\t\t\t...(abandoned > 0 ? { abandoned } : {}),\n\t\t\t}\n\t\t},\n\t})\n\n\treturn (scope) => {\n\t\tconst key = scopeKeyOf(scope)\n\t\treturn recallOr(views, [key, () => viewOf(key)])\n\t}\n}\n\n/**\n * One lane per adapter object, so a re-saved provider starts fresh. Vendor lanes share the global\n * slots; local (native) lanes do not, so a slow vendor never queues the plugin's own reads.\n */\nexport const createLanes = (options: LanesOptions = {}): Lanes => {\n\tconst now = options.now ?? monotonicMs\n\tconst globalCapacity = options.global ?? DEFAULT_GLOBAL_CONCURRENCY\n\tconst global = createSlots(globalCapacity, globalCapacity)\n\tconst cores = new WeakMap<AnalyticsAdapter, (scope: string | null | undefined) => Lane>()\n\tconst lanesById = new Map<string, Lane>()\n\n\tconst coreFor = (adapter: AnalyticsAdapter): ((scope: string | null | undefined) => Lane) => {\n\t\tconst local = options.local?.is(adapter) === true\n\t\tconst declared = adapter.capabilities.rateLimit?.maxConcurrent\n\t\tconst fallback = local\n\t\t\t? (options.local?.capacity ?? DEFAULT_LOCAL_CONCURRENCY)\n\t\t\t: (options.perSource ?? DEFAULT_SOURCE_CONCURRENCY)\n\t\treturn createLaneCore({\n\t\t\tadapter,\n\t\t\tcapacity: declared !== undefined && declared > 0 ? declared : fallback,\n\t\t\tglobal: local ? undefined : global,\n\t\t\tnow,\n\t\t\tshared: options.shared?.(adapter) === true,\n\t\t\t...(options.breaker ? { breaker: options.breaker } : {}),\n\t\t\tabandonAfterMs: options.abandonAfterMs ?? ABANDON_AFTER_MS,\n\t\t\t...(options.onAbandon ? { onAbandon: options.onAbandon } : {}),\n\t\t})\n\t}\n\n\treturn {\n\t\tfor(adapter, scope) {\n\t\t\tif (options.rebuilt?.(adapter) === true) {\n\t\t\t\tconst id = JSON.stringify([scope ?? null, adapter.id])\n\t\t\t\treturn recallOr(lanesById, [id, () => coreFor(adapter)(scope)])\n\t\t\t}\n\t\t\tconst core = cores.get(adapter) ?? coreFor(adapter)\n\t\t\tcores.set(adapter, core)\n\t\t\treturn core(scope)\n\t\t},\n\t}\n}\n\n/**\n * One upstream request, retried up to {@link MAX_RETRIES} times on a transient `unavailable` but\n * never after a timeout or spent quota, nor past the deadline; a lane refusal ends it at once.\n */\nexport const runUpstream = async <T>(\n\tlane: Lane,\n\tfn: (signal: AbortSignal) => Promise<T>,\n\toptions: LaneRunOptions & { now: () => number; baseDelayMs?: number }\n): Promise<T> => {\n\tconst base = options.baseDelayMs ?? RETRY_BASE_MS\n\tfor (let attempt = 0; ; attempt++) {\n\t\ttry {\n\t\t\treturn await lane.run(fn, options)\n\t\t} catch (err) {\n\t\t\tif (isLaneRefused(err) || options.signal.aborted) {\n\t\t\t\tthrow err\n\t\t\t}\n\t\t\tconst failure = classifyError(err)\n\t\t\tif (\n\t\t\t\tfailure.kind !== 'unavailable' ||\n\t\t\t\tfailure.timeout ||\n\t\t\t\tfailure.quota ||\n\t\t\t\tattempt >= MAX_RETRIES\n\t\t\t) {\n\t\t\t\tthrow err\n\t\t\t}\n\t\t\t// Fixed rather than random, so the schedule is testable: 0.5 s, then 1.25 s.\n\t\t\tconst delay = base * 2 ** attempt + base * 0.5 * attempt\n\t\t\tif (options.deadline !== undefined && options.now() + delay >= options.deadline) {\n\t\t\t\tthrow err\n\t\t\t}\n\t\t\ttry {\n\t\t\t\tawait sleep(delay, options.signal)\n\t\t\t} catch {\n\t\t\t\tthrow err\n\t\t\t}\n\t\t}\n\t}\n}\n"],"mappings":"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"}