@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,40 +1,62 @@
1
+ import { canonicalJson } from "./values.js";
1
2
  import { addDaysInTz, startOfDayInTz } from "../timeframe/tz.js";
3
+ import { createHash } from "node:crypto";
2
4
  //#region src/core/cacheKey.ts
3
- const stable = (xs) => xs ? [...xs].sort().join(",") : "";
4
5
  /**
5
- * The window segment. A live window (a preset ends at `now`) snaps to whole days, so every
6
- * render within one day shares one entry. A closed window, whose end is the final instant
7
- * of its day in `tz`, keys on its exact bounds instead: snapping those too would let two
8
- * windows that differ only inside their last day share an entry, and an instant-comparing
9
- * adapter read the narrower one's answer.
6
+ * Written into every key. Bump it when the key layout or what a metric means changes, so no entry
7
+ * written under the old meaning is ever read.
10
8
  */
11
- const rangeKey = (range, tz) => {
9
+ const CACHE_KEY_VERSION = 3;
10
+ /**
11
+ * A live window snaps to whole days so renders within a day share an entry; a closed one keys on
12
+ * exact bounds, or two windows differing inside their last day would share one.
13
+ */
14
+ const windowOf = (range, tz) => {
12
15
  const nextDay = addDaysInTz(range.end, 1, tz);
13
16
  if (nextDay.getTime() - 1 === range.end.getTime()) return `${range.start.toISOString()}_${range.end.toISOString()}`;
14
17
  return `${startOfDayInTz(range.start, tz).toISOString()}_${nextDay.toISOString()}`;
15
18
  };
16
- function buildCacheKey(provider, q) {
17
- const pathKey = q.path ?? "site";
18
- const tz = q.timezone ?? "UTC";
19
- const range = rangeKey(q.dateRange, tz);
20
- const filters = (q.filters ?? []).map((f) => `${f.dimension}${f.operator}${f.value}`).sort().join(";");
21
- return [
22
- "analytics",
23
- provider,
24
- q.hostname ?? "_",
25
- pathKey,
26
- stable(q.metrics),
27
- stable(q.dimensions),
28
- range,
29
- q.granularity ?? "_",
30
- filters,
31
- String(q.limit ?? "_"),
32
- q.order ? `${q.order.metric}:${q.order.direction}` : "_",
33
- ...q.timezone !== void 0 && q.timezone !== "UTC" ? [q.timezone] : [],
34
- ...q.scope !== void 0 ? [encodeURIComponent(q.scope)] : []
35
- ].join("|");
36
- }
19
+ /** A set, sorted and without repeats; an empty one keys like an absent one, asking the same. */
20
+ const setOf = (values) => values && values.length > 0 ? [...new Set(values)].sort() : void 0;
21
+ const filtersOf = (filters) => setOf(filters?.map((filter) => canonicalJson(filter)));
22
+ /**
23
+ * The query as keyed: every field it carries, so a later field is never left out, with the window
24
+ * snapped and sets sorted. `'unresolved'` stays a string, apart from a goal of that name.
25
+ */
26
+ const keyedQuery = (q) => {
27
+ const { dateRange, ...rest } = q;
28
+ const timezone = q.timezone ?? "UTC";
29
+ return {
30
+ ...rest,
31
+ window: windowOf(dateRange, timezone),
32
+ timezone,
33
+ metrics: setOf(q.metrics),
34
+ dimensions: setOf(q.dimensions),
35
+ filters: filtersOf(q.filters),
36
+ goalSlugs: q.goalSlugs === "unresolved" ? q.goalSlugs : setOf(q.goalSlugs)
37
+ };
38
+ };
39
+ const hashed = (prefix, value) => `${prefix}${createHash("sha256").update(canonicalJson(value)).digest("base64url")}`;
40
+ /**
41
+ * `r:` plus the base64url SHA-256 of the canonical key fields: fixed length, and no value can be
42
+ * spelled to look like another field.
43
+ */
44
+ const buildCacheKey = (source, q, epochs) => hashed("r:", {
45
+ v: CACHE_KEY_VERSION,
46
+ source,
47
+ configEpoch: epochs.config,
48
+ refreshEpoch: epochs.refresh,
49
+ q: keyedQuery(q)
50
+ });
51
+ /** `rt:` and the same digest over a live count's parts; such a key is only ever held in memory. */
52
+ const buildRealtimeKey = (source, parts, epochs) => hashed("rt:", {
53
+ v: CACHE_KEY_VERSION,
54
+ source,
55
+ configEpoch: epochs.config,
56
+ refreshEpoch: epochs.refresh,
57
+ parts
58
+ });
37
59
  //#endregion
38
- export { buildCacheKey };
60
+ export { buildCacheKey, buildRealtimeKey };
39
61
 
40
62
  //# sourceMappingURL=cacheKey.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"cacheKey.js","names":[],"sources":["../../src/core/cacheKey.ts"],"sourcesContent":["import { addDaysInTz, DEFAULT_TIMEZONE, startOfDayInTz } from '../timeframe/tz'\nimport type { AnalyticsQuery } from './contract'\n\nconst stable = (xs?: string[]): string => (xs ? [...xs].sort().join(',') : '')\n\n/**\n * The window segment. A live window (a preset ends at `now`) snaps to whole days, so every\n * render within one day shares one entry. A closed window, whose end is the final instant\n * of its day in `tz`, keys on its exact bounds instead: snapping those too would let two\n * windows that differ only inside their last day share an entry, and an instant-comparing\n * adapter read the narrower one's answer.\n */\nconst rangeKey = (range: AnalyticsQuery['dateRange'], tz: string): string => {\n\tconst nextDay = addDaysInTz(range.end, 1, tz)\n\tif (nextDay.getTime() - 1 === range.end.getTime()) {\n\t\treturn `${range.start.toISOString()}_${range.end.toISOString()}`\n\t}\n\treturn `${startOfDayInTz(range.start, tz).toISOString()}_${nextDay.toISOString()}`\n}\n\nexport function buildCacheKey(provider: string, q: AnalyticsQuery): string {\n\tconst pathKey = q.path ?? 'site'\n\tconst tz = q.timezone ?? DEFAULT_TIMEZONE\n\tconst range = rangeKey(q.dateRange, tz)\n\tconst filters = (q.filters ?? [])\n\t\t.map((f) => `${f.dimension}${f.operator}${f.value}`)\n\t\t.sort()\n\t\t.join(';')\n\treturn [\n\t\t'analytics',\n\t\tprovider,\n\t\tq.hostname ?? '_',\n\t\tpathKey,\n\t\tstable(q.metrics),\n\t\tstable(q.dimensions),\n\t\trange,\n\t\tq.granularity ?? '_',\n\t\tfilters,\n\t\tString(q.limit ?? '_'),\n\t\tq.order ? `${q.order.metric}:${q.order.direction}` : '_',\n\t\t// Appended only for a non-UTC timezone so default (UTC) keys keep their format.\n\t\t...(q.timezone !== undefined && q.timezone !== DEFAULT_TIMEZONE ? [q.timezone] : []),\n\t\t...(q.scope !== undefined ? [encodeURIComponent(q.scope)] : []),\n\t].join('|')\n}\n"],"mappings":";;AAGA,MAAM,UAAU,OAA2B,KAAK,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,KAAK,GAAG,IAAI;;;;;;;;AAS3E,MAAM,YAAY,OAAoC,OAAuB;CAC5E,MAAM,UAAU,YAAY,MAAM,KAAK,GAAG,EAAE;CAC5C,IAAI,QAAQ,QAAQ,IAAI,MAAM,MAAM,IAAI,QAAQ,GAC/C,OAAO,GAAG,MAAM,MAAM,YAAY,EAAE,GAAG,MAAM,IAAI,YAAY;CAE9D,OAAO,GAAG,eAAe,MAAM,OAAO,EAAE,EAAE,YAAY,EAAE,GAAG,QAAQ,YAAY;AAChF;AAEA,SAAgB,cAAc,UAAkB,GAA2B;CAC1E,MAAM,UAAU,EAAE,QAAQ;CAC1B,MAAM,KAAK,EAAE,YAAA;CACb,MAAM,QAAQ,SAAS,EAAE,WAAW,EAAE;CACtC,MAAM,WAAW,EAAE,WAAW,CAAC,GAC7B,KAAK,MAAM,GAAG,EAAE,YAAY,EAAE,WAAW,EAAE,OAAO,EAClD,KAAK,EACL,KAAK,GAAG;CACV,OAAO;EACN;EACA;EACA,EAAE,YAAY;EACd;EACA,OAAO,EAAE,OAAO;EAChB,OAAO,EAAE,UAAU;EACnB;EACA,EAAE,eAAe;EACjB;EACA,OAAO,EAAE,SAAS,GAAG;EACrB,EAAE,QAAQ,GAAG,EAAE,MAAM,OAAO,GAAG,EAAE,MAAM,cAAc;EAErD,GAAI,EAAE,aAAa,KAAA,KAAa,EAAE,aAAA,QAAgC,CAAC,EAAE,QAAQ,IAAI,CAAC;EAClF,GAAI,EAAE,UAAU,KAAA,IAAY,CAAC,mBAAmB,EAAE,KAAK,CAAC,IAAI,CAAC;CAC9D,EAAE,KAAK,GAAG;AACX"}
1
+ {"version":3,"file":"cacheKey.js","names":[],"sources":["../../src/core/cacheKey.ts"],"sourcesContent":["import { createHash } from 'node:crypto'\nimport { addDaysInTz, DEFAULT_TIMEZONE, startOfDayInTz } from '../timeframe/tz'\nimport type { AnalyticsFilter, AnalyticsQuery } from './contract'\nimport { canonicalJson } from './values'\n\n/**\n * Written into every key. Bump it when the key layout or what a metric means changes, so no entry\n * written under the old meaning is ever read.\n */\nconst CACHE_KEY_VERSION = 3\n\n/** The two tokens a cached read is keyed on; a new value of either retires it on every instance. */\nexport interface CacheKeyEpochs {\n\t/** The scope's provider and goal configuration. */\n\tconfig: string\n\t/** The scope's manual refresh token. */\n\trefresh: string\n}\n\n/**\n * A live window snaps to whole days so renders within a day share an entry; a closed one keys on\n * exact bounds, or two windows differing inside their last day would share one.\n */\nconst windowOf = (range: AnalyticsQuery['dateRange'], tz: string): string => {\n\tconst nextDay = addDaysInTz(range.end, 1, tz)\n\tif (nextDay.getTime() - 1 === range.end.getTime()) {\n\t\treturn `${range.start.toISOString()}_${range.end.toISOString()}`\n\t}\n\treturn `${startOfDayInTz(range.start, tz).toISOString()}_${nextDay.toISOString()}`\n}\n\n/** A set, sorted and without repeats; an empty one keys like an absent one, asking the same. */\nconst setOf = <T extends string>(values: readonly T[] | undefined): T[] | undefined =>\n\tvalues && values.length > 0 ? [...new Set(values)].sort() : undefined\n\nconst filtersOf = (filters: readonly AnalyticsFilter[] | undefined): string[] | undefined =>\n\tsetOf(filters?.map((filter) => canonicalJson(filter)))\n\n/**\n * The query as keyed: every field it carries, so a later field is never left out, with the window\n * snapped and sets sorted. `'unresolved'` stays a string, apart from a goal of that name.\n */\nexport const keyedQuery = (q: AnalyticsQuery): Record<string, unknown> => {\n\tconst { dateRange, ...rest } = q\n\tconst timezone = q.timezone ?? DEFAULT_TIMEZONE\n\treturn {\n\t\t...rest,\n\t\twindow: windowOf(dateRange, timezone),\n\t\ttimezone,\n\t\tmetrics: setOf(q.metrics),\n\t\tdimensions: setOf(q.dimensions),\n\t\tfilters: filtersOf(q.filters),\n\t\tgoalSlugs: q.goalSlugs === 'unresolved' ? q.goalSlugs : setOf(q.goalSlugs),\n\t}\n}\n\nconst hashed = (prefix: string, value: unknown): string =>\n\t`${prefix}${createHash('sha256').update(canonicalJson(value)).digest('base64url')}`\n\n/**\n * `r:` plus the base64url SHA-256 of the canonical key fields: fixed length, and no value can be\n * spelled to look like another field.\n */\nexport const buildCacheKey = (source: string, q: AnalyticsQuery, epochs: CacheKeyEpochs): string =>\n\thashed('r:', {\n\t\tv: CACHE_KEY_VERSION,\n\t\tsource,\n\t\tconfigEpoch: epochs.config,\n\t\trefreshEpoch: epochs.refresh,\n\t\tq: keyedQuery(q),\n\t})\n\n/** What a live count is keyed on; its window always ends now, so it carries a length instead. */\ninterface RealtimeKeyParts {\n\tmetric: string\n\twindowMinutes: number\n\tscope?: string\n\tpath?: string\n\tseries: boolean\n}\n\n/** `rt:` and the same digest over a live count's parts; such a key is only ever held in memory. */\nexport const buildRealtimeKey = (\n\tsource: string,\n\tparts: RealtimeKeyParts,\n\tepochs: CacheKeyEpochs\n): string =>\n\thashed('rt:', {\n\t\tv: CACHE_KEY_VERSION,\n\t\tsource,\n\t\tconfigEpoch: epochs.config,\n\t\trefreshEpoch: epochs.refresh,\n\t\tparts,\n\t})\n"],"mappings":";;;;;;;;AASA,MAAM,oBAAoB;;;;;AAc1B,MAAM,YAAY,OAAoC,OAAuB;CAC5E,MAAM,UAAU,YAAY,MAAM,KAAK,GAAG,EAAE;CAC5C,IAAI,QAAQ,QAAQ,IAAI,MAAM,MAAM,IAAI,QAAQ,GAC/C,OAAO,GAAG,MAAM,MAAM,YAAY,EAAE,GAAG,MAAM,IAAI,YAAY;CAE9D,OAAO,GAAG,eAAe,MAAM,OAAO,EAAE,EAAE,YAAY,EAAE,GAAG,QAAQ,YAAY;AAChF;;AAGA,MAAM,SAA2B,WAChC,UAAU,OAAO,SAAS,IAAI,CAAC,GAAG,IAAI,IAAI,MAAM,CAAC,EAAE,KAAK,IAAI,KAAA;AAE7D,MAAM,aAAa,YAClB,MAAM,SAAS,KAAK,WAAW,cAAc,MAAM,CAAC,CAAC;;;;;AAMtD,MAAa,cAAc,MAA+C;CACzE,MAAM,EAAE,WAAW,GAAG,SAAS;CAC/B,MAAM,WAAW,EAAE,YAAA;CACnB,OAAO;EACN,GAAG;EACH,QAAQ,SAAS,WAAW,QAAQ;EACpC;EACA,SAAS,MAAM,EAAE,OAAO;EACxB,YAAY,MAAM,EAAE,UAAU;EAC9B,SAAS,UAAU,EAAE,OAAO;EAC5B,WAAW,EAAE,cAAc,eAAe,EAAE,YAAY,MAAM,EAAE,SAAS;CAC1E;AACD;AAEA,MAAM,UAAU,QAAgB,UAC/B,GAAG,SAAS,WAAW,QAAQ,EAAE,OAAO,cAAc,KAAK,CAAC,EAAE,OAAO,WAAW;;;;;AAMjF,MAAa,iBAAiB,QAAgB,GAAmB,WAChE,OAAO,MAAM;CACZ,GAAG;CACH;CACA,aAAa,OAAO;CACpB,cAAc,OAAO;CACrB,GAAG,WAAW,CAAC;AAChB,CAAC;;AAYF,MAAa,oBACZ,QACA,OACA,WAEA,OAAO,OAAO;CACb,GAAG;CACH;CACA,aAAa,OAAO;CACpB,cAAc,OAAO;CACrB;AACD,CAAC"}
@@ -0,0 +1,165 @@
1
+ import { kindOf } from "./values.js";
2
+ import { keysOf, optionalBoolean, optionalFunction, optionalList, optionalSeconds, optionsObject, positiveWhole } from "./optionChecks.js";
3
+ import { resolveCollectionOption } from "./collectionOption.js";
4
+ import { CACHE_SLUG } from "../surfacing/cacheCollection.js";
5
+ import { isCacheStore } from "../surfacing/cacheStore.js";
6
+ import { SYNC_SLUG } from "../sync/collection.js";
7
+ //#region src/core/cacheOptions.ts
8
+ const DEFAULT_TIMEOUT_MS = 15e3;
9
+ const DEFAULT_WARM_WINDOW_HOURS = 24;
10
+ const DEFAULT_WARM_MAX_READS = 200;
11
+ const DEFAULT_SYNC_LOOKBACK = 3;
12
+ const CACHE_KEYS = keysOf({
13
+ ttl: true,
14
+ warm: true,
15
+ timeoutMs: true,
16
+ concurrency: true,
17
+ store: true,
18
+ collection: true
19
+ });
20
+ const TTL_KEYS = keysOf({
21
+ aggregate: true,
22
+ realtime: true
23
+ });
24
+ const CONCURRENCY_KEYS = keysOf({
25
+ global: true,
26
+ perSource: true,
27
+ perScope: true
28
+ });
29
+ const WARM_KEYS = keysOf({
30
+ windowHours: true,
31
+ maxReads: true
32
+ });
33
+ const SYNC_KEYS = keysOf({
34
+ lookbackDays: true,
35
+ adapters: true,
36
+ collection: true
37
+ });
38
+ const HOOKS_KEYS = keysOf({ afterRead: true });
39
+ const resolveWarm = (option) => {
40
+ const defaults = {
41
+ windowHours: DEFAULT_WARM_WINDOW_HOURS,
42
+ maxReads: DEFAULT_WARM_MAX_READS
43
+ };
44
+ if (option === void 0 || option === false) return {
45
+ enabled: false,
46
+ ...defaults
47
+ };
48
+ if (option === true) return {
49
+ enabled: true,
50
+ ...defaults
51
+ };
52
+ optionsObject(option, {
53
+ path: "cache.warm",
54
+ known: WARM_KEYS,
55
+ example: "true, false or an object such as { windowHours: 24 }"
56
+ });
57
+ return {
58
+ enabled: true,
59
+ windowHours: positiveWhole(option.windowHours, "cache.warm.windowHours", defaults.windowHours),
60
+ maxReads: positiveWhole(option.maxReads, "cache.warm.maxReads", defaults.maxReads)
61
+ };
62
+ };
63
+ const resolveConcurrency = (option) => {
64
+ if (option !== void 0) optionsObject(option, {
65
+ path: "cache.concurrency",
66
+ known: CONCURRENCY_KEYS,
67
+ example: "an object such as { perSource: 4 }"
68
+ });
69
+ return {
70
+ global: positiveWhole(option?.global, "cache.concurrency.global", 16),
71
+ perSource: positiveWhole(option?.perSource, "cache.concurrency.perSource", 4),
72
+ perScope: positiveWhole(option?.perScope, "cache.concurrency.perScope", 8)
73
+ };
74
+ };
75
+ /** The host's store, or the `analytics-cache` collection it replaces: never both. */
76
+ const resolveCacheStorage = (option) => {
77
+ const store = option?.store;
78
+ const collection = option?.collection;
79
+ if (store !== void 0 && !isCacheStore(store)) throw new Error(`analytics: cache.store must be an object with get, set, touch, sweep and recentRecipes methods, got ${kindOf(store)}`);
80
+ if (store !== void 0 && collection !== void 0) throw new Error("analytics: cache.collection shapes the analytics-cache collection, which cache.store replaces; set one of them");
81
+ return {
82
+ ...store === void 0 ? {} : { store },
83
+ collection: resolveCollectionOption(collection, {
84
+ path: "cache.collection",
85
+ fallback: CACHE_SLUG
86
+ })
87
+ };
88
+ };
89
+ /** `cache`: TTLs, warming, the source deadline, concurrency and where reads are stored. */
90
+ const resolveCache = (option) => {
91
+ if (option !== void 0) {
92
+ optionsObject(option, {
93
+ path: "cache",
94
+ known: CACHE_KEYS,
95
+ example: "an object such as { timeoutMs: 15000 }"
96
+ });
97
+ if (option.ttl !== void 0) optionsObject(option.ttl, {
98
+ path: "cache.ttl",
99
+ known: TTL_KEYS,
100
+ example: "an object such as { aggregate: 300 }"
101
+ });
102
+ }
103
+ return {
104
+ ttl: {
105
+ aggregate: optionalSeconds(option?.ttl?.aggregate, "cache.ttl.aggregate"),
106
+ realtime: optionalSeconds(option?.ttl?.realtime, "cache.ttl.realtime")
107
+ },
108
+ warm: resolveWarm(option?.warm),
109
+ timeoutMs: positiveWhole(option?.timeoutMs, "cache.timeoutMs", DEFAULT_TIMEOUT_MS),
110
+ concurrency: resolveConcurrency(option?.concurrency),
111
+ ...resolveCacheStorage(option)
112
+ };
113
+ };
114
+ /** `sync`: off unless set; `true` copies every vendor source with the defaults. */
115
+ const resolveSync = (option) => {
116
+ const off = {
117
+ enabled: false,
118
+ lookbackDays: DEFAULT_SYNC_LOOKBACK,
119
+ collection: {
120
+ slug: SYNC_SLUG,
121
+ hidden: true
122
+ }
123
+ };
124
+ if (!option) return off;
125
+ if (option === true) return {
126
+ ...off,
127
+ enabled: true
128
+ };
129
+ const shaped = optionsObject(option, {
130
+ path: "sync",
131
+ known: SYNC_KEYS,
132
+ example: "true, or an object such as { lookbackDays: 3 }"
133
+ });
134
+ for (const entry of optionalList(shaped.adapters, "sync.adapters", "['plausible']")) if (typeof entry !== "string" || entry.trim() === "") throw new Error(`analytics: sync.adapters entries must each be an adapter id or a provider type, got ${kindOf(entry)}`);
135
+ optionalBoolean(option.collection?.hidden, "sync.collection.hidden");
136
+ const collection = resolveCollectionOption(option.collection, {
137
+ path: "sync.collection",
138
+ fallback: SYNC_SLUG,
139
+ extra: ["hidden"]
140
+ });
141
+ return {
142
+ enabled: true,
143
+ lookbackDays: positiveWhole(option.lookbackDays, "sync.lookbackDays", DEFAULT_SYNC_LOOKBACK),
144
+ ...option.adapters ? { adapters: option.adapters } : {},
145
+ collection: {
146
+ ...collection,
147
+ hidden: option.collection?.hidden ?? true
148
+ }
149
+ };
150
+ };
151
+ /** `hooks`: functions the plugin calls around what it does. */
152
+ const resolveHooks = (option) => {
153
+ if (option === void 0) return {};
154
+ optionsObject(option, {
155
+ path: "hooks",
156
+ known: HOOKS_KEYS,
157
+ example: "an object such as { afterRead }"
158
+ });
159
+ const afterRead = optionalFunction(option.afterRead, "hooks.afterRead");
160
+ return afterRead ? { afterRead } : {};
161
+ };
162
+ //#endregion
163
+ export { resolveCache, resolveHooks, resolveSync };
164
+
165
+ //# sourceMappingURL=cacheOptions.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"cacheOptions.js","names":[],"sources":["../../src/core/cacheOptions.ts"],"sourcesContent":["import { CACHE_SLUG } from '../surfacing/cacheCollection'\nimport { isCacheStore } from '../surfacing/cacheStore'\nimport { DEFAULT_COLD_READS_PER_SCOPE } from '../surfacing/coldBudget'\nimport { DEFAULT_GLOBAL_CONCURRENCY, DEFAULT_SOURCE_CONCURRENCY } from '../surfacing/lanes'\nimport { SYNC_SLUG } from '../sync/collection'\nimport { resolveCollectionOption } from './collectionOption'\nimport {\n\tkeysOf,\n\toptionalBoolean,\n\toptionalFunction,\n\toptionalList,\n\toptionalSeconds,\n\toptionsObject,\n\tpositiveWhole,\n} from './optionChecks'\nimport type {\n\tAnalyticsCacheOptions,\n\tAnalyticsConcurrencyOptions,\n\tAnalyticsHooksOptions,\n\tAnalyticsPluginOptions,\n\tAnalyticsSyncOptions,\n\tAnalyticsWarmOptions,\n\tResolvedOptions,\n} from './options'\nimport { kindOf } from './values'\n\nconst DEFAULT_TIMEOUT_MS = 15_000\nconst DEFAULT_WARM_WINDOW_HOURS = 24\nconst DEFAULT_WARM_MAX_READS = 200\nconst DEFAULT_SYNC_LOOKBACK = 3\n\nconst CACHE_KEYS = keysOf<AnalyticsCacheOptions>({\n\tttl: true,\n\twarm: true,\n\ttimeoutMs: true,\n\tconcurrency: true,\n\tstore: true,\n\tcollection: true,\n})\nconst TTL_KEYS = keysOf<NonNullable<AnalyticsCacheOptions['ttl']>>({\n\taggregate: true,\n\trealtime: true,\n})\nconst CONCURRENCY_KEYS = keysOf<AnalyticsConcurrencyOptions>({\n\tglobal: true,\n\tperSource: true,\n\tperScope: true,\n})\nconst WARM_KEYS = keysOf<AnalyticsWarmOptions>({ windowHours: true, maxReads: true })\nconst SYNC_KEYS = keysOf<AnalyticsSyncOptions>({\n\tlookbackDays: true,\n\tadapters: true,\n\tcollection: true,\n})\nconst HOOKS_KEYS = keysOf<AnalyticsHooksOptions>({ afterRead: true })\n\ntype ResolvedCache = ResolvedOptions['cache']\n\nconst resolveWarm = (option: AnalyticsCacheOptions['warm']): ResolvedCache['warm'] => {\n\tconst defaults = { windowHours: DEFAULT_WARM_WINDOW_HOURS, maxReads: DEFAULT_WARM_MAX_READS }\n\tif (option === undefined || option === false) {\n\t\treturn { enabled: false, ...defaults }\n\t}\n\tif (option === true) {\n\t\treturn { enabled: true, ...defaults }\n\t}\n\toptionsObject(option, {\n\t\tpath: 'cache.warm',\n\t\tknown: WARM_KEYS,\n\t\texample: 'true, false or an object such as { windowHours: 24 }',\n\t})\n\treturn {\n\t\tenabled: true,\n\t\twindowHours: positiveWhole(option.windowHours, 'cache.warm.windowHours', defaults.windowHours),\n\t\tmaxReads: positiveWhole(option.maxReads, 'cache.warm.maxReads', defaults.maxReads),\n\t}\n}\n\nconst resolveConcurrency = (\n\toption: AnalyticsConcurrencyOptions | undefined\n): ResolvedCache['concurrency'] => {\n\tif (option !== undefined) {\n\t\toptionsObject(option, {\n\t\t\tpath: 'cache.concurrency',\n\t\t\tknown: CONCURRENCY_KEYS,\n\t\t\texample: 'an object such as { perSource: 4 }',\n\t\t})\n\t}\n\treturn {\n\t\tglobal: positiveWhole(option?.global, 'cache.concurrency.global', DEFAULT_GLOBAL_CONCURRENCY),\n\t\tperSource: positiveWhole(\n\t\t\toption?.perSource,\n\t\t\t'cache.concurrency.perSource',\n\t\t\tDEFAULT_SOURCE_CONCURRENCY\n\t\t),\n\t\tperScope: positiveWhole(\n\t\t\toption?.perScope,\n\t\t\t'cache.concurrency.perScope',\n\t\t\tDEFAULT_COLD_READS_PER_SCOPE\n\t\t),\n\t}\n}\n\n/** The host's store, or the `analytics-cache` collection it replaces: never both. */\nconst resolveCacheStorage = (\n\toption: AnalyticsCacheOptions | undefined\n): Pick<ResolvedCache, 'store' | 'collection'> => {\n\tconst store: unknown = option?.store\n\tconst collection = option?.collection\n\tif (store !== undefined && !isCacheStore(store)) {\n\t\tthrow new Error(\n\t\t\t`analytics: cache.store must be an object with get, set, touch, sweep and recentRecipes methods, got ${kindOf(store)}`\n\t\t)\n\t}\n\tif (store !== undefined && collection !== undefined) {\n\t\tthrow new Error(\n\t\t\t'analytics: cache.collection shapes the analytics-cache collection, which cache.store replaces; set one of them'\n\t\t)\n\t}\n\treturn {\n\t\t...(store === undefined ? {} : { store }),\n\t\tcollection: resolveCollectionOption(collection, {\n\t\t\tpath: 'cache.collection',\n\t\t\tfallback: CACHE_SLUG,\n\t\t}),\n\t}\n}\n\n/** `cache`: TTLs, warming, the source deadline, concurrency and where reads are stored. */\nexport const resolveCache = (option: AnalyticsCacheOptions | undefined): ResolvedCache => {\n\tif (option !== undefined) {\n\t\toptionsObject(option, {\n\t\t\tpath: 'cache',\n\t\t\tknown: CACHE_KEYS,\n\t\t\texample: 'an object such as { timeoutMs: 15000 }',\n\t\t})\n\t\tif (option.ttl !== undefined) {\n\t\t\toptionsObject(option.ttl, {\n\t\t\t\tpath: 'cache.ttl',\n\t\t\t\tknown: TTL_KEYS,\n\t\t\t\texample: 'an object such as { aggregate: 300 }',\n\t\t\t})\n\t\t}\n\t}\n\treturn {\n\t\tttl: {\n\t\t\taggregate: optionalSeconds(option?.ttl?.aggregate, 'cache.ttl.aggregate'),\n\t\t\trealtime: optionalSeconds(option?.ttl?.realtime, 'cache.ttl.realtime'),\n\t\t},\n\t\twarm: resolveWarm(option?.warm),\n\t\ttimeoutMs: positiveWhole(option?.timeoutMs, 'cache.timeoutMs', DEFAULT_TIMEOUT_MS),\n\t\tconcurrency: resolveConcurrency(option?.concurrency),\n\t\t...resolveCacheStorage(option),\n\t}\n}\n\n/** `sync`: off unless set; `true` copies every vendor source with the defaults. */\nexport const resolveSync = (option: AnalyticsPluginOptions['sync']): ResolvedOptions['sync'] => {\n\tconst off: ResolvedOptions['sync'] = {\n\t\tenabled: false,\n\t\tlookbackDays: DEFAULT_SYNC_LOOKBACK,\n\t\tcollection: { slug: SYNC_SLUG, hidden: true },\n\t}\n\tif (!option) {\n\t\treturn off\n\t}\n\tif (option === true) {\n\t\treturn { ...off, enabled: true }\n\t}\n\tconst shaped = optionsObject(option, {\n\t\tpath: 'sync',\n\t\tknown: SYNC_KEYS,\n\t\texample: 'true, or an object such as { lookbackDays: 3 }',\n\t})\n\tfor (const entry of optionalList(shaped.adapters, 'sync.adapters', \"['plausible']\")) {\n\t\tif (typeof entry !== 'string' || entry.trim() === '') {\n\t\t\tthrow new Error(\n\t\t\t\t`analytics: sync.adapters entries must each be an adapter id or a provider type, got ${kindOf(entry)}`\n\t\t\t)\n\t\t}\n\t}\n\toptionalBoolean(option.collection?.hidden, 'sync.collection.hidden')\n\tconst collection = resolveCollectionOption(option.collection, {\n\t\tpath: 'sync.collection',\n\t\tfallback: SYNC_SLUG,\n\t\textra: ['hidden'],\n\t})\n\treturn {\n\t\tenabled: true,\n\t\tlookbackDays: positiveWhole(option.lookbackDays, 'sync.lookbackDays', DEFAULT_SYNC_LOOKBACK),\n\t\t...(option.adapters ? { adapters: option.adapters } : {}),\n\t\tcollection: { ...collection, hidden: option.collection?.hidden ?? true },\n\t}\n}\n\n/** `hooks`: functions the plugin calls around what it does. */\nexport const resolveHooks = (\n\toption: AnalyticsHooksOptions | undefined\n): ResolvedOptions['hooks'] => {\n\tif (option === undefined) {\n\t\treturn {}\n\t}\n\toptionsObject(option, {\n\t\tpath: 'hooks',\n\t\tknown: HOOKS_KEYS,\n\t\texample: 'an object such as { afterRead }',\n\t})\n\tconst afterRead = optionalFunction(option.afterRead, 'hooks.afterRead')\n\treturn afterRead ? { afterRead } : {}\n}\n"],"mappings":"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"}
@@ -1,27 +1,40 @@
1
- import { DimensionKey, FilterOperator, Granularity, MetricKey } from "./contract.js";
1
+ import { AnalyticsFilter, DimensionKey, FilterOperator, Granularity, MetricKey } from "./contract.js";
2
2
 
3
3
  //#region src/core/capabilities.d.ts
4
+ /** A filter's dimension and operator: what a source has to accept for the filter to apply. */
5
+ type FilterPair = Pick<AnalyticsFilter, 'dimension' | 'operator'>;
4
6
  interface CapabilityRequirement {
5
7
  metrics?: MetricKey[];
6
8
  dimensions?: DimensionKey[];
7
- filters?: DimensionKey[];
8
- filterOperators?: FilterOperator[];
9
+ /**
10
+ * Filters the source must accept: a dimension alone asks that it filter by that dimension at
11
+ * all, a pair that it filter by it with that operator.
12
+ */
13
+ filters?: ReadonlyArray<DimensionKey | FilterPair>;
9
14
  realtime?: boolean;
10
- perPageQuery?: boolean;
15
+ perItemQuery?: boolean;
16
+ /** The read is about one page (`AnalyticsQuery.path`), which a metric needing `page` accepts. */
17
+ path?: boolean;
11
18
  }
12
- /** Wire form of AnalyticsCapabilities for client pickers: a deliberate allowlist, so adapter internals (rate limits, TTLs) never become client contract by accident. */
19
+ /**
20
+ * Wire form of AnalyticsCapabilities for client pickers: an allowlist, so adapter internals (rate
21
+ * limits, TTLs) never become client contract by accident.
22
+ */
13
23
  type SerializedCapabilities = {
14
24
  metrics: MetricKey[];
15
- dimensions: DimensionKey[];
16
- filters: DimensionKey[];
17
- filterOperators: FilterOperator[];
25
+ dimensions: DimensionKey[]; /** The operators each filterable dimension takes, both in contract order. */
26
+ filters: Partial<Record<DimensionKey, FilterOperator[]>>; /** Where each metric the source cannot read under every breakdown is read; absent when none. */
27
+ metricReach?: Partial<Record<MetricKey, {
28
+ dimensions?: DimensionKey[];
29
+ requires?: DimensionKey;
30
+ }>>;
18
31
  realtime: boolean;
19
- realtimeWindowMinutes?: number;
20
- perPageQuery: boolean;
32
+ realtimeWindowMinutes?: number; /** Present, and true, only on a source that answers one content item's reads. */
33
+ perItemQuery?: boolean;
21
34
  comparison: boolean;
22
35
  minGranularity: Granularity;
23
36
  maxLookbackDays: number | null;
24
37
  };
25
38
  //#endregion
26
- export { CapabilityRequirement, SerializedCapabilities };
39
+ export { CapabilityRequirement, FilterPair, SerializedCapabilities };
27
40
  //# sourceMappingURL=capabilities.d.ts.map
@@ -1,26 +1,110 @@
1
+ import { DIMENSION_KEYS, FILTER_OPERATORS } from "./contract.js";
2
+ import { onlyKeys } from "./values.js";
1
3
  //#region src/core/capabilities.ts
4
+ /** Every key a {@link CapabilityRequirement} takes. */
5
+ const CAPABILITY_REQUIREMENT_KEYS = [
6
+ "metrics",
7
+ "dimensions",
8
+ "filters",
9
+ "realtime",
10
+ "perItemQuery",
11
+ "path"
12
+ ];
13
+ /** Retired requirement keys and their replacements; a Map, so no caller's key hits a prototype. */
14
+ const RETIRED_REQUIREMENT_KEYS = new Map([["perPageQuery", "path: true, for a widget that reads one page's numbers"], ["filterOperators", "filters naming each operator with its dimension, such as filters: [{ dimension: 'page', operator: 'contains' }]"]]);
15
+ /**
16
+ * Refuses a requirement key no source is checked against, naming the replacement of a retired one:
17
+ * an ignored key would register the widget where it should be left out.
18
+ */
19
+ const assertRequirementKeys = (value, path) => {
20
+ for (const key of Object.keys(value)) {
21
+ const replacement = RETIRED_REQUIREMENT_KEYS.get(key);
22
+ if (replacement !== void 0) throw new Error(`analytics: ${path}.${key} is gone since 1.0.0-beta.12; use ${replacement}`);
23
+ }
24
+ onlyKeys(value, CAPABILITY_REQUIREMENT_KEYS, path);
25
+ };
26
+ /** The operators a source filters one dimension with, in contract order; empty when it cannot. */
27
+ const filterOperatorsFor = (caps, dimension) => {
28
+ const offered = caps.filters?.[dimension] ?? [];
29
+ return FILTER_OPERATORS.filter((operator) => offered.includes(operator));
30
+ };
31
+ /** Whether a source applies a filter of this dimension and operator. */
32
+ const supportsFilter = (caps, filter) => filterOperatorsFor(caps, filter.dimension).includes(filter.operator);
33
+ /** The first filter the source cannot apply, named so a refusal can say which one it was. */
34
+ const unsupportedFilter = (caps, filters) => filters.find((filter) => !supportsFilter(caps, filter));
35
+ /** The dimensions a source filters by at all, in contract order. */
36
+ const filterableDimensions = (caps) => DIMENSION_KEYS.filter((dimension) => filterOperatorsFor(caps, dimension).length > 0);
37
+ /** Whether a source meets one entry of a requirement's `filters`. */
38
+ const meetsFilter = (caps, wanted) => typeof wanted === "string" ? filterOperatorsFor(caps, wanted).length > 0 : supportsFilter(caps, wanted);
39
+ const filtersBy = (shape, dimension) => shape.filters?.some((filter) => (typeof filter === "string" ? filter : filter.dimension) === dimension) ?? false;
40
+ /**
41
+ * Why a source cannot read `metric` for a read of this shape: the dimension it cannot break the
42
+ * metric down by, or the one the read lacks. Null when it can.
43
+ */
44
+ const metricOutOfReach = (caps, metric, shape) => {
45
+ const reach = caps.metricReach?.[metric];
46
+ if (!reach) return null;
47
+ const allowed = reach.dimensions;
48
+ const breakdown = allowed ? shape.dimensions?.find((d) => !allowed.includes(d)) : void 0;
49
+ if (breakdown !== void 0) return { breakdown };
50
+ const needs = reach.requires;
51
+ if (needs !== void 0 && !shape.dimensions?.includes(needs) && !filtersBy(shape, needs) && !(needs === "page" && shape.path === true)) return { needs };
52
+ return null;
53
+ };
54
+ /** Whether a source reads `metric` for a read of this shape, per its `metricReach`. */
55
+ const metricReaches = (caps, metric, shape) => metricOutOfReach(caps, metric, shape) === null;
56
+ /** Whether each of a requirement's metrics is read for the shape the requirement describes. */
57
+ const metricsReach = (caps, req) => req.metrics?.every((metric) => metricReaches(caps, metric, {
58
+ ...req.dimensions ? { dimensions: req.dimensions } : {},
59
+ ...req.filters ? { filters: req.filters } : {},
60
+ ...req.path ? { path: true } : {}
61
+ })) ?? true;
62
+ /** Whether a source meets every part of a requirement. */
2
63
  function satisfiesCapabilities(caps, req) {
3
64
  if (req.realtime && !caps.realtime) return false;
4
- if (req.perPageQuery && !caps.perPageQuery) return false;
65
+ if (req.perItemQuery && caps.perItemQuery !== true) return false;
5
66
  if (req.metrics?.some((m) => !caps.metrics.has(m))) return false;
6
67
  if (req.dimensions?.some((d) => !caps.dimensions.has(d))) return false;
7
- if (req.filters?.some((d) => !caps.filters.has(d))) return false;
8
- if (req.filterOperators?.some((op) => !caps.filterOperators.has(op))) return false;
9
- return true;
68
+ if (req.filters?.some((wanted) => !meetsFilter(caps, wanted))) return false;
69
+ return metricsReach(caps, req);
10
70
  }
11
- const serializeCapabilities = (caps) => ({
12
- metrics: [...caps.metrics],
13
- dimensions: [...caps.dimensions],
14
- filters: [...caps.filters],
15
- filterOperators: [...caps.filterOperators],
16
- realtime: caps.realtime,
17
- ...caps.realtimeWindowMinutes !== void 0 ? { realtimeWindowMinutes: caps.realtimeWindowMinutes } : {},
18
- perPageQuery: caps.perPageQuery,
19
- comparison: caps.comparison,
20
- minGranularity: caps.minGranularity,
21
- maxLookbackDays: caps.maxLookbackDays
22
- });
71
+ /**
72
+ * Whether a source compares against its previous period. The engine does that read
73
+ * generically, so it is on unless an adapter opted out.
74
+ */
75
+ const comparisonOf = (caps) => caps.comparison ?? true;
76
+ const serializeFilters = (caps) => {
77
+ const filters = {};
78
+ for (const dimension of filterableDimensions(caps)) filters[dimension] = filterOperatorsFor(caps, dimension);
79
+ return filters;
80
+ };
81
+ const serializeReach = (caps) => {
82
+ const out = {};
83
+ for (const metric of caps.metrics) {
84
+ const reach = caps.metricReach?.[metric];
85
+ if (reach) out[metric] = {
86
+ ...reach.dimensions ? { dimensions: [...reach.dimensions] } : {},
87
+ ...reach.requires !== void 0 ? { requires: reach.requires } : {}
88
+ };
89
+ }
90
+ return Object.keys(out).length > 0 ? out : void 0;
91
+ };
92
+ const serializeCapabilities = (caps) => {
93
+ const metricReach = serializeReach(caps);
94
+ return {
95
+ metrics: [...caps.metrics],
96
+ dimensions: [...caps.dimensions],
97
+ filters: serializeFilters(caps),
98
+ ...metricReach ? { metricReach } : {},
99
+ realtime: caps.realtime,
100
+ ...caps.realtimeWindowMinutes !== void 0 ? { realtimeWindowMinutes: caps.realtimeWindowMinutes } : {},
101
+ ...caps.perItemQuery === true ? { perItemQuery: true } : {},
102
+ comparison: comparisonOf(caps),
103
+ minGranularity: caps.minGranularity,
104
+ maxLookbackDays: caps.maxLookbackDays
105
+ };
106
+ };
23
107
  //#endregion
24
- export { satisfiesCapabilities, serializeCapabilities };
108
+ export { assertRequirementKeys, comparisonOf, filterOperatorsFor, filterableDimensions, meetsFilter, metricOutOfReach, metricReaches, metricsReach, satisfiesCapabilities, serializeCapabilities, supportsFilter, unsupportedFilter };
25
109
 
26
110
  //# sourceMappingURL=capabilities.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"capabilities.js","names":[],"sources":["../../src/core/capabilities.ts"],"sourcesContent":["import type {\n\tAnalyticsCapabilities,\n\tDimensionKey,\n\tFilterOperator,\n\tGranularity,\n\tMetricKey,\n} from './contract'\n\nexport interface CapabilityRequirement {\n\tmetrics?: MetricKey[]\n\tdimensions?: DimensionKey[]\n\tfilters?: DimensionKey[]\n\tfilterOperators?: FilterOperator[]\n\trealtime?: boolean\n\tperPageQuery?: boolean\n}\n\nexport function satisfiesCapabilities(\n\tcaps: AnalyticsCapabilities,\n\treq: CapabilityRequirement\n): boolean {\n\tif (req.realtime && !caps.realtime) return false\n\tif (req.perPageQuery && !caps.perPageQuery) return false\n\tif (req.metrics?.some((m) => !caps.metrics.has(m))) return false\n\tif (req.dimensions?.some((d) => !caps.dimensions.has(d))) return false\n\tif (req.filters?.some((d) => !caps.filters.has(d))) return false\n\tif (req.filterOperators?.some((op) => !caps.filterOperators.has(op))) return false\n\treturn true\n}\n\n/** Wire form of AnalyticsCapabilities for client pickers: a deliberate allowlist, so adapter internals (rate limits, TTLs) never become client contract by accident. */\nexport type SerializedCapabilities = {\n\tmetrics: MetricKey[]\n\tdimensions: DimensionKey[]\n\tfilters: DimensionKey[]\n\tfilterOperators: FilterOperator[]\n\trealtime: boolean\n\trealtimeWindowMinutes?: number\n\tperPageQuery: boolean\n\tcomparison: boolean\n\tminGranularity: Granularity\n\tmaxLookbackDays: number | null\n}\n\nexport const serializeCapabilities = (caps: AnalyticsCapabilities): SerializedCapabilities => ({\n\tmetrics: [...caps.metrics],\n\tdimensions: [...caps.dimensions],\n\tfilters: [...caps.filters],\n\tfilterOperators: [...caps.filterOperators],\n\trealtime: caps.realtime,\n\t...(caps.realtimeWindowMinutes !== undefined\n\t\t? { realtimeWindowMinutes: caps.realtimeWindowMinutes }\n\t\t: {}),\n\tperPageQuery: caps.perPageQuery,\n\tcomparison: caps.comparison,\n\tminGranularity: caps.minGranularity,\n\tmaxLookbackDays: caps.maxLookbackDays,\n})\n"],"mappings":";AAiBA,SAAgB,sBACf,MACA,KACU;CACV,IAAI,IAAI,YAAY,CAAC,KAAK,UAAU,OAAO;CAC3C,IAAI,IAAI,gBAAgB,CAAC,KAAK,cAAc,OAAO;CACnD,IAAI,IAAI,SAAS,MAAM,MAAM,CAAC,KAAK,QAAQ,IAAI,CAAC,CAAC,GAAG,OAAO;CAC3D,IAAI,IAAI,YAAY,MAAM,MAAM,CAAC,KAAK,WAAW,IAAI,CAAC,CAAC,GAAG,OAAO;CACjE,IAAI,IAAI,SAAS,MAAM,MAAM,CAAC,KAAK,QAAQ,IAAI,CAAC,CAAC,GAAG,OAAO;CAC3D,IAAI,IAAI,iBAAiB,MAAM,OAAO,CAAC,KAAK,gBAAgB,IAAI,EAAE,CAAC,GAAG,OAAO;CAC7E,OAAO;AACR;AAgBA,MAAa,yBAAyB,UAAyD;CAC9F,SAAS,CAAC,GAAG,KAAK,OAAO;CACzB,YAAY,CAAC,GAAG,KAAK,UAAU;CAC/B,SAAS,CAAC,GAAG,KAAK,OAAO;CACzB,iBAAiB,CAAC,GAAG,KAAK,eAAe;CACzC,UAAU,KAAK;CACf,GAAI,KAAK,0BAA0B,KAAA,IAChC,EAAE,uBAAuB,KAAK,sBAAsB,IACpD,CAAC;CACJ,cAAc,KAAK;CACnB,YAAY,KAAK;CACjB,gBAAgB,KAAK;CACrB,iBAAiB,KAAK;AACvB"}
1
+ {"version":3,"file":"capabilities.js","names":[],"sources":["../../src/core/capabilities.ts"],"sourcesContent":["import {\n\ttype AnalyticsCapabilities,\n\ttype AnalyticsFilter,\n\tDIMENSION_KEYS,\n\ttype DimensionKey,\n\tFILTER_OPERATORS,\n\ttype FilterOperator,\n\ttype FilterOperatorMap,\n\ttype Granularity,\n\ttype MetricKey,\n\ttype MetricReach,\n} from './contract'\nimport { onlyKeys } from './values'\n\n/** A filter's dimension and operator: what a source has to accept for the filter to apply. */\nexport type FilterPair = Pick<AnalyticsFilter, 'dimension' | 'operator'>\n\nexport interface CapabilityRequirement {\n\tmetrics?: MetricKey[]\n\tdimensions?: DimensionKey[]\n\t/**\n\t * Filters the source must accept: a dimension alone asks that it filter by that dimension at\n\t * all, a pair that it filter by it with that operator.\n\t */\n\tfilters?: ReadonlyArray<DimensionKey | FilterPair>\n\trealtime?: boolean\n\tperItemQuery?: boolean\n\t/** The read is about one page (`AnalyticsQuery.path`), which a metric needing `page` accepts. */\n\tpath?: boolean\n}\n\n/** Every key a {@link CapabilityRequirement} takes. */\nexport const CAPABILITY_REQUIREMENT_KEYS = [\n\t'metrics',\n\t'dimensions',\n\t'filters',\n\t'realtime',\n\t'perItemQuery',\n\t'path',\n] as const satisfies ReadonlyArray<keyof CapabilityRequirement>\n\n/** Retired requirement keys and their replacements; a Map, so no caller's key hits a prototype. */\nconst RETIRED_REQUIREMENT_KEYS: ReadonlyMap<string, string> = new Map([\n\t['perPageQuery', \"path: true, for a widget that reads one page's numbers\"],\n\t[\n\t\t'filterOperators',\n\t\t\"filters naming each operator with its dimension, such as filters: [{ dimension: 'page', operator: 'contains' }]\",\n\t],\n])\n\n/**\n * Refuses a requirement key no source is checked against, naming the replacement of a retired one:\n * an ignored key would register the widget where it should be left out.\n */\nexport const assertRequirementKeys = (value: Record<string, unknown>, path: string): void => {\n\tfor (const key of Object.keys(value)) {\n\t\tconst replacement = RETIRED_REQUIREMENT_KEYS.get(key)\n\t\tif (replacement !== undefined) {\n\t\t\tthrow new Error(`analytics: ${path}.${key} is gone since 1.0.0-beta.12; use ${replacement}`)\n\t\t}\n\t}\n\tonlyKeys(value, CAPABILITY_REQUIREMENT_KEYS, path)\n}\n\n/** The operators a source filters one dimension with, in contract order; empty when it cannot. */\nexport const filterOperatorsFor = (\n\tcaps: { filters?: FilterOperatorMap },\n\tdimension: DimensionKey\n): FilterOperator[] => {\n\tconst offered = caps.filters?.[dimension] ?? []\n\treturn FILTER_OPERATORS.filter((operator) => offered.includes(operator))\n}\n\n/** Whether a source applies a filter of this dimension and operator. */\nexport const supportsFilter = (\n\tcaps: { filters?: FilterOperatorMap },\n\tfilter: FilterPair\n): boolean => filterOperatorsFor(caps, filter.dimension).includes(filter.operator)\n\n/** The first filter the source cannot apply, named so a refusal can say which one it was. */\nexport const unsupportedFilter = <F extends FilterPair>(\n\tcaps: { filters?: FilterOperatorMap },\n\tfilters: readonly F[]\n): F | undefined => filters.find((filter) => !supportsFilter(caps, filter))\n\n/** The dimensions a source filters by at all, in contract order. */\nexport const filterableDimensions = (caps: { filters?: FilterOperatorMap }): DimensionKey[] =>\n\tDIMENSION_KEYS.filter((dimension) => filterOperatorsFor(caps, dimension).length > 0)\n\n/** Whether a source meets one entry of a requirement's `filters`. */\nexport const meetsFilter = (\n\tcaps: { filters?: FilterOperatorMap },\n\twanted: DimensionKey | FilterPair\n): boolean =>\n\ttypeof wanted === 'string'\n\t\t? filterOperatorsFor(caps, wanted).length > 0\n\t\t: supportsFilter(caps, wanted)\n\n/** What a read is about, as far as where a source reads a metric depends on it. */\nexport interface ReadShape {\n\tdimensions?: readonly DimensionKey[]\n\t/** The read's filters, or only the dimensions it filters by. */\n\tfilters?: ReadonlyArray<DimensionKey | FilterPair>\n\t/** The read is about one page (`AnalyticsQuery.path`). */\n\tpath?: boolean\n}\n\ntype ReachMap = Partial<Record<MetricKey, MetricReach>>\n\nconst filtersBy = (shape: ReadShape, dimension: DimensionKey): boolean =>\n\tshape.filters?.some(\n\t\t(filter) => (typeof filter === 'string' ? filter : filter.dimension) === dimension\n\t) ?? false\n\n/**\n * Why a source cannot read `metric` for a read of this shape: the dimension it cannot break the\n * metric down by, or the one the read lacks. Null when it can.\n */\nexport const metricOutOfReach = (\n\tcaps: { metricReach?: ReachMap },\n\tmetric: MetricKey,\n\tshape: ReadShape\n): { breakdown: DimensionKey } | { needs: DimensionKey } | null => {\n\tconst reach = caps.metricReach?.[metric]\n\tif (!reach) {\n\t\treturn null\n\t}\n\tconst allowed = reach.dimensions\n\tconst breakdown = allowed ? shape.dimensions?.find((d) => !allowed.includes(d)) : undefined\n\tif (breakdown !== undefined) {\n\t\treturn { breakdown }\n\t}\n\tconst needs = reach.requires\n\tif (\n\t\tneeds !== undefined &&\n\t\t!shape.dimensions?.includes(needs) &&\n\t\t!filtersBy(shape, needs) &&\n\t\t!(needs === 'page' && shape.path === true)\n\t) {\n\t\treturn { needs }\n\t}\n\treturn null\n}\n\n/** Whether a source reads `metric` for a read of this shape, per its `metricReach`. */\nexport const metricReaches = (\n\tcaps: { metricReach?: ReachMap },\n\tmetric: MetricKey,\n\tshape: ReadShape\n): boolean => metricOutOfReach(caps, metric, shape) === null\n\n/** Whether each of a requirement's metrics is read for the shape the requirement describes. */\nexport const metricsReach = (\n\tcaps: { metricReach?: ReachMap },\n\treq: CapabilityRequirement\n): boolean =>\n\treq.metrics?.every((metric) =>\n\t\tmetricReaches(caps, metric, {\n\t\t\t...(req.dimensions ? { dimensions: req.dimensions } : {}),\n\t\t\t...(req.filters ? { filters: req.filters } : {}),\n\t\t\t...(req.path ? { path: true } : {}),\n\t\t})\n\t) ?? true\n\n/** Whether a source meets every part of a requirement. */\nexport function satisfiesCapabilities(\n\tcaps: AnalyticsCapabilities,\n\treq: CapabilityRequirement\n): boolean {\n\tif (req.realtime && !caps.realtime) return false\n\tif (req.perItemQuery && caps.perItemQuery !== true) return false\n\tif (req.metrics?.some((m) => !caps.metrics.has(m))) return false\n\tif (req.dimensions?.some((d) => !caps.dimensions.has(d))) return false\n\tif (req.filters?.some((wanted) => !meetsFilter(caps, wanted))) return false\n\treturn metricsReach(caps, req)\n}\n\n/**\n * Whether a source compares against its previous period. The engine does that read\n * generically, so it is on unless an adapter opted out.\n */\nexport const comparisonOf = (caps: AnalyticsCapabilities): boolean => caps.comparison ?? true\n\n/**\n * Wire form of AnalyticsCapabilities for client pickers: an allowlist, so adapter internals (rate\n * limits, TTLs) never become client contract by accident.\n */\nexport type SerializedCapabilities = {\n\tmetrics: MetricKey[]\n\tdimensions: DimensionKey[]\n\t/** The operators each filterable dimension takes, both in contract order. */\n\tfilters: Partial<Record<DimensionKey, FilterOperator[]>>\n\t/** Where each metric the source cannot read under every breakdown is read; absent when none. */\n\tmetricReach?: Partial<Record<MetricKey, { dimensions?: DimensionKey[]; requires?: DimensionKey }>>\n\trealtime: boolean\n\trealtimeWindowMinutes?: number\n\t/** Present, and true, only on a source that answers one content item's reads. */\n\tperItemQuery?: boolean\n\tcomparison: boolean\n\tminGranularity: Granularity\n\tmaxLookbackDays: number | null\n}\n\nconst serializeFilters = (\n\tcaps: AnalyticsCapabilities\n): Partial<Record<DimensionKey, FilterOperator[]>> => {\n\tconst filters: Partial<Record<DimensionKey, FilterOperator[]>> = {}\n\tfor (const dimension of filterableDimensions(caps)) {\n\t\tfilters[dimension] = filterOperatorsFor(caps, dimension)\n\t}\n\treturn filters\n}\n\nconst serializeReach = (\n\tcaps: AnalyticsCapabilities\n): SerializedCapabilities['metricReach'] | undefined => {\n\tconst out: NonNullable<SerializedCapabilities['metricReach']> = {}\n\tfor (const metric of caps.metrics) {\n\t\tconst reach = caps.metricReach?.[metric]\n\t\tif (reach) {\n\t\t\tout[metric] = {\n\t\t\t\t...(reach.dimensions ? { dimensions: [...reach.dimensions] } : {}),\n\t\t\t\t...(reach.requires !== undefined ? { requires: reach.requires } : {}),\n\t\t\t}\n\t\t}\n\t}\n\treturn Object.keys(out).length > 0 ? out : undefined\n}\n\nexport const serializeCapabilities = (caps: AnalyticsCapabilities): SerializedCapabilities => {\n\tconst metricReach = serializeReach(caps)\n\treturn {\n\t\tmetrics: [...caps.metrics],\n\t\tdimensions: [...caps.dimensions],\n\t\tfilters: serializeFilters(caps),\n\t\t...(metricReach ? { metricReach } : {}),\n\t\trealtime: caps.realtime,\n\t\t...(caps.realtimeWindowMinutes !== undefined\n\t\t\t? { realtimeWindowMinutes: caps.realtimeWindowMinutes }\n\t\t\t: {}),\n\t\t...(caps.perItemQuery === true ? { perItemQuery: true } : {}),\n\t\tcomparison: comparisonOf(caps),\n\t\tminGranularity: caps.minGranularity,\n\t\tmaxLookbackDays: caps.maxLookbackDays,\n\t}\n}\n"],"mappings":"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"}
@@ -1,49 +1,82 @@
1
+ import { CaptureSnippet, HeldSlotMode, TrackerSlotConfig, WithoutConsentLevel } from "../tracker/config.js";
2
+ import { FetchLike } from "./fetch.js";
3
+
1
4
  //#region src/core/capture.d.ts
5
+ /** What a proxied route serves: a script the browser runs, or data its tracker sends and reads. */
6
+ type ProxyRouteKind = 'script' | 'data';
2
7
  /** One rewrite the runtime proxy endpoint answers, source pattern to vendor upstream. */
3
8
  interface ProxyRoute {
4
9
  source: string;
5
10
  upstream: string;
11
+ /**
12
+ * How the runtime proxy labels the answer: `script` as JavaScript; `data` keeps JSON or plain
13
+ * text, else becomes plain text, and is sandboxed so it never runs as a page of the site.
14
+ */
15
+ kind: ProxyRouteKind;
6
16
  }
7
17
  /** Routes a Next rewrites helper and the runtime proxy endpoint both consume. */
8
18
  interface ProxyDescriptor {
9
19
  routes: ProxyRoute[];
10
20
  forwardHeaders?: string[];
11
21
  /**
12
- * The vendor serves some paths only with a trailing slash (PostHog's capture
13
- * endpoints). Both slash forms always match; this decides what reaches the vendor:
14
- * true keeps the request's trailing slash on the upstream path, absent or false
15
- * normalizes it away. Next apps proxying such a vendor through rewrites also need
16
- * `skipTrailingSlashRedirect: true`.
22
+ * True keeps the request's trailing slash upstream (PostHog's capture endpoints need it); absent
23
+ * or false strips it. Next rewrites to such a vendor also need `skipTrailingSlashRedirect: true`.
17
24
  */
18
25
  trailingSlashes?: boolean;
26
+ /**
27
+ * The fetch the runtime proxy reaches these routes with, the same one the adapter reads with.
28
+ * Unset, the global fetch.
29
+ */
30
+ fetch?: FetchLike;
19
31
  }
20
- interface SnippetScript {
21
- src?: string;
22
- inline?: string;
23
- attrs?: Record<string, string>;
24
- async?: boolean;
25
- defer?: boolean;
26
- type?: string;
32
+ /**
33
+ * How a vendor counts without consent. `inherent`: it never stores anything, so one snippet serves
34
+ * every phase. `switched`: its sink switches the vendor's client between cookieless and full.
35
+ * `default` is the level `capture.withoutConsent: 'cookieless'` gives it (GA4: `off`).
36
+ */
37
+ interface CookielessSupport {
38
+ kind: 'inherent' | 'switched';
39
+ default?: WithoutConsentLevel;
27
40
  }
28
- interface CaptureSnippet {
29
- scripts: SnippetScript[];
41
+ /** What a snippet starts in: `cookieless` for a held slot counting before an answer, else `full`. */
42
+ type SnippetMode = 'cookieless' | 'full';
43
+ interface SnippetArgs {
44
+ path: string;
45
+ /**
46
+ * The request's resolved scope, which a vendor able to carry it stamps on every event. Null when
47
+ * unscoped or unresolved.
48
+ */
49
+ scope?: string | null;
50
+ /**
51
+ * The client the snippet initialises, set only for a vendor that runs a second client beside the
52
+ * other slot's (PostHog).
53
+ */
54
+ instance?: string;
55
+ /** Absent (a caller from before 1.0.0-beta.15) means `full`. */
56
+ mode?: SnippetMode;
57
+ /**
58
+ * True when the slot drops to a cookieless level in some phase without consent, so the snippet
59
+ * boots a client able to switch (PostHog: `cookieless_mode: 'on_reject'`). False keeps the
60
+ * strict boot of 1.0.0-beta.14.
61
+ */
62
+ withoutConsent?: boolean;
30
63
  }
31
- type CaptureClientKind = 'native' | 'posthog' | 'plausible' | 'umami';
32
64
  /**
33
- * Pure descriptor of how a vendor's browser tracker is proxied and booted, consumed by
34
- * a later runtime proxy endpoint, a Next rewrites helper, and a snippet renderer. Never
35
- * carries private/secret credentials (e.g. PostHog's Query API key); only what the
36
- * browser is allowed to see.
65
+ * How a vendor's browser tracker is proxied and booted. Carries only what the browser may see,
66
+ * never a secret credential such as PostHog's Query API key.
37
67
  */
38
68
  interface CaptureSupport {
39
69
  proxy: ProxyDescriptor;
40
- snippet(args: {
41
- path: string;
42
- }): CaptureSnippet;
43
- client: {
44
- kind: CaptureClientKind;
45
- } & Record<string, string | number | boolean>;
70
+ snippet(args: SnippetArgs): CaptureSnippet;
71
+ client: TrackerSlotConfig['client'];
72
+ /** Absent: the vendor cannot count without consent, so its held slot sends nothing until then. */
73
+ cookieless?: CookielessSupport;
74
+ /**
75
+ * The adapter's own `withoutConsent` (factory option or provider document), which beats
76
+ * `capture.withoutConsent` for its slot in both phases. Ignored without `cookieless`.
77
+ */
78
+ withoutConsent?: HeldSlotMode;
46
79
  }
47
80
  //#endregion
48
- export { CaptureClientKind, CaptureSnippet, CaptureSupport, ProxyDescriptor, ProxyRoute, SnippetScript };
81
+ export { CaptureSupport, CookielessSupport, ProxyDescriptor, ProxyRoute, ProxyRouteKind, SnippetArgs, SnippetMode };
49
82
  //# sourceMappingURL=capture.d.ts.map
@@ -0,0 +1 @@
1
+ export { };