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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (1259) hide show
  1. package/CHANGELOG.md +530 -0
  2. package/README.md +30 -37
  3. package/dist/access/adminUser.d.ts +15 -0
  4. package/dist/access/adminUser.js +13 -0
  5. package/dist/access/adminUser.js.map +1 -0
  6. package/dist/access/decideOnce.js +16 -0
  7. package/dist/access/decideOnce.js.map +1 -0
  8. package/dist/access/membership.d.ts +23 -0
  9. package/dist/access/membership.js +63 -0
  10. package/dist/access/membership.js.map +1 -0
  11. package/dist/access/principal.d.ts +37 -0
  12. package/dist/access/principal.js +29 -0
  13. package/dist/access/principal.js.map +1 -0
  14. package/dist/access/readGate.js +16 -0
  15. package/dist/access/readGate.js.map +1 -0
  16. package/dist/adapters/ga4/disableKey.js +7 -9
  17. package/dist/adapters/ga4/disableKey.js.map +1 -1
  18. package/dist/adapters/ga4/eventName.d.ts +2 -8
  19. package/dist/adapters/ga4/eventName.js +2 -8
  20. package/dist/adapters/ga4/eventName.js.map +1 -1
  21. package/dist/adapters/ga4/ga4.d.ts +17 -0
  22. package/dist/adapters/ga4/ga4.js +208 -124
  23. package/dist/adapters/ga4/ga4.js.map +1 -1
  24. package/dist/adapters/ga4/measurementId.js +2 -3
  25. package/dist/adapters/ga4/measurementId.js.map +1 -1
  26. package/dist/adapters/goalRead.js +15 -29
  27. package/dist/adapters/goalRead.js.map +1 -1
  28. package/dist/adapters/http/baseUrl.js +15 -0
  29. package/dist/adapters/http/baseUrl.js.map +1 -0
  30. package/dist/adapters/http/fetchJson.d.ts +19 -0
  31. package/dist/adapters/http/fetchJson.js +27 -8
  32. package/dist/adapters/http/fetchJson.js.map +1 -1
  33. package/dist/adapters/mapping.js +52 -0
  34. package/dist/adapters/mapping.js.map +1 -0
  35. package/dist/adapters/plausible/plausible.d.ts +19 -13
  36. package/dist/adapters/plausible/plausible.js +139 -123
  37. package/dist/adapters/plausible/plausible.js.map +1 -1
  38. package/dist/adapters/plausible/scriptId.js +19 -0
  39. package/dist/adapters/plausible/scriptId.js.map +1 -0
  40. package/dist/adapters/posthog/posthog.d.ts +26 -9
  41. package/dist/adapters/posthog/posthog.js +194 -115
  42. package/dist/adapters/posthog/posthog.js.map +1 -1
  43. package/dist/adapters/readTime.js +7 -0
  44. package/dist/adapters/readTime.js.map +1 -0
  45. package/dist/adapters/series.js +14 -8
  46. package/dist/adapters/series.js.map +1 -1
  47. package/dist/adapters/umami/umami.d.ts +13 -9
  48. package/dist/adapters/umami/umami.js +186 -173
  49. package/dist/adapters/umami/umami.js.map +1 -1
  50. package/dist/adapters/upstream.js +16 -0
  51. package/dist/adapters/upstream.js.map +1 -0
  52. package/dist/binding/report.d.ts +8 -0
  53. package/dist/binding/report.js +24 -0
  54. package/dist/binding/report.js.map +1 -0
  55. package/dist/binding/resolvePath.js +16 -29
  56. package/dist/binding/resolvePath.js.map +1 -1
  57. package/dist/binding/types.d.ts +14 -29
  58. package/dist/capture/captureRequest.js +28 -0
  59. package/dist/capture/captureRequest.js.map +1 -0
  60. package/dist/capture/exclusionEndpoint.js +98 -0
  61. package/dist/capture/exclusionEndpoint.js.map +1 -0
  62. package/dist/capture/exclusionPrelude.js +14 -0
  63. package/dist/capture/exclusionPrelude.js.map +1 -0
  64. package/dist/capture/exclusionToken.js +23 -0
  65. package/dist/capture/exclusionToken.js.map +1 -0
  66. package/dist/capture/jsLiteral.js +19 -0
  67. package/dist/capture/jsLiteral.js.map +1 -0
  68. package/dist/capture/mountPath.js +2 -3
  69. package/dist/capture/mountPath.js.map +1 -1
  70. package/dist/capture/proxyEndpoint.js +48 -95
  71. package/dist/capture/proxyEndpoint.js.map +1 -1
  72. package/dist/capture/proxyRoutes.js +58 -21
  73. package/dist/capture/proxyRoutes.js.map +1 -1
  74. package/dist/capture/relay.js +91 -0
  75. package/dist/capture/relay.js.map +1 -0
  76. package/dist/capture/requestBody.js +2 -6
  77. package/dist/capture/requestBody.js.map +1 -1
  78. package/dist/capture/requestTrust.js +45 -0
  79. package/dist/capture/requestTrust.js.map +1 -0
  80. package/dist/capture/sameSite.js +40 -0
  81. package/dist/capture/sameSite.js.map +1 -0
  82. package/dist/capture/slots.js +50 -25
  83. package/dist/capture/slots.js.map +1 -1
  84. package/dist/capture/trackerConfig.js +108 -36
  85. package/dist/capture/trackerConfig.js.map +1 -1
  86. package/dist/capture/trackerEndpoint.js +22 -21
  87. package/dist/capture/trackerEndpoint.js.map +1 -1
  88. package/dist/charts/BarList.d.ts +27 -14
  89. package/dist/charts/BarList.js +38 -83
  90. package/dist/charts/BarList.js.map +1 -1
  91. package/dist/charts/TrendChart.d.ts +40 -7
  92. package/dist/charts/TrendChart.js +243 -215
  93. package/dist/charts/TrendChart.js.map +1 -1
  94. package/dist/charts/bars.d.ts +15 -1
  95. package/dist/charts/bars.js +12 -12
  96. package/dist/charts/bars.js.map +1 -1
  97. package/dist/charts/bucket.js +106 -73
  98. package/dist/charts/bucket.js.map +1 -1
  99. package/dist/charts/inProgress.js +22 -0
  100. package/dist/charts/inProgress.js.map +1 -0
  101. package/dist/charts/series.d.ts +15 -0
  102. package/dist/charts/series.js +123 -0
  103. package/dist/charts/series.js.map +1 -0
  104. package/dist/charts/spline.js +91 -25
  105. package/dist/charts/spline.js.map +1 -1
  106. package/dist/charts/trendGeometry.js +91 -0
  107. package/dist/charts/trendGeometry.js.map +1 -0
  108. package/dist/core/adminOptions.d.ts +1 -0
  109. package/dist/core/adminOptions.js +198 -0
  110. package/dist/core/adminOptions.js.map +1 -0
  111. package/dist/core/budget.js +24 -0
  112. package/dist/core/budget.js.map +1 -0
  113. package/dist/core/cacheKey.d.ts +1 -0
  114. package/dist/core/cacheKey.js +48 -37
  115. package/dist/core/cacheKey.js.map +1 -1
  116. package/dist/core/cacheOptions.js +165 -0
  117. package/dist/core/cacheOptions.js.map +1 -0
  118. package/dist/core/capabilities.d.ts +24 -11
  119. package/dist/core/capabilities.js +96 -17
  120. package/dist/core/capabilities.js.map +1 -1
  121. package/dist/core/capture.d.ts +28 -25
  122. package/dist/core/captureOptions.d.ts +1 -0
  123. package/dist/core/captureOptions.js +258 -0
  124. package/dist/core/captureOptions.js.map +1 -0
  125. package/dist/core/clock.js +13 -0
  126. package/dist/core/clock.js.map +1 -0
  127. package/dist/core/collectionOption.d.ts +17 -0
  128. package/dist/core/collectionOption.js +104 -0
  129. package/dist/core/collectionOption.js.map +1 -0
  130. package/dist/core/collectionSlug.js +7 -0
  131. package/dist/core/collectionSlug.js.map +1 -0
  132. package/dist/core/contract.d.ts +297 -59
  133. package/dist/core/contract.js +6 -4
  134. package/dist/core/contract.js.map +1 -1
  135. package/dist/core/cron.js +57 -0
  136. package/dist/core/cron.js.map +1 -0
  137. package/dist/core/fetch.d.ts +17 -0
  138. package/dist/core/goalOptions.d.ts +1 -0
  139. package/dist/core/goalOptions.js +166 -0
  140. package/dist/core/goalOptions.js.map +1 -0
  141. package/dist/core/granularity.js +3 -2
  142. package/dist/core/granularity.js.map +1 -1
  143. package/dist/core/guards.js +17 -0
  144. package/dist/core/guards.js.map +1 -0
  145. package/dist/core/jobs.d.ts +40 -0
  146. package/dist/core/jobs.js +132 -0
  147. package/dist/core/jobs.js.map +1 -0
  148. package/dist/core/legacyOptions.js +145 -0
  149. package/dist/core/legacyOptions.js.map +1 -0
  150. package/dist/core/metricAliases.js +81 -0
  151. package/dist/core/metricAliases.js.map +1 -0
  152. package/dist/core/metricValues.js +57 -0
  153. package/dist/core/metricValues.js.map +1 -0
  154. package/dist/core/monotonic.js +10 -0
  155. package/dist/core/monotonic.js.map +1 -0
  156. package/dist/core/optionChecks.js +51 -0
  157. package/dist/core/optionChecks.js.map +1 -0
  158. package/dist/core/options.d.ts +505 -157
  159. package/dist/core/options.js +158 -219
  160. package/dist/core/options.js.map +1 -1
  161. package/dist/core/registry.js +45 -5
  162. package/dist/core/registry.js.map +1 -1
  163. package/dist/core/scopeList.js +7 -9
  164. package/dist/core/scopeList.js.map +1 -1
  165. package/dist/core/scopeOptions.d.ts +1 -0
  166. package/dist/core/scopeOptions.js +114 -0
  167. package/dist/core/scopeOptions.js.map +1 -0
  168. package/dist/core/scopedRead.js +330 -71
  169. package/dist/core/scopedRead.js.map +1 -1
  170. package/dist/core/sdks.d.ts +81 -0
  171. package/dist/core/sdks.js +23 -0
  172. package/dist/core/sdks.js.map +1 -0
  173. package/dist/core/serverEvent.d.ts +38 -20
  174. package/dist/core/serverEvent.js.map +1 -1
  175. package/dist/core/siteAddress.js +20 -0
  176. package/dist/core/siteAddress.js.map +1 -0
  177. package/dist/core/sourceErrors.js +109 -0
  178. package/dist/core/sourceErrors.js.map +1 -0
  179. package/dist/core/sourceLabel.d.ts +10 -0
  180. package/dist/core/sourceLabel.js +63 -0
  181. package/dist/core/sourceLabel.js.map +1 -0
  182. package/dist/core/sourceOptions.js +106 -0
  183. package/dist/core/sourceOptions.js.map +1 -0
  184. package/dist/core/sourcePolicy.d.ts +55 -0
  185. package/dist/core/sourcePolicy.js +51 -0
  186. package/dist/core/sourcePolicy.js.map +1 -0
  187. package/dist/core/throttle.js +18 -0
  188. package/dist/core/throttle.js.map +1 -0
  189. package/dist/core/values.js +61 -0
  190. package/dist/core/values.js.map +1 -0
  191. package/dist/core/widgetSlugs.d.ts +17 -0
  192. package/dist/core/widgetSlugs.js +29 -0
  193. package/dist/core/widgetSlugs.js.map +1 -0
  194. package/dist/db/detachedWrite.js +36 -0
  195. package/dist/db/detachedWrite.js.map +1 -0
  196. package/dist/db/errors.js +182 -0
  197. package/dist/db/errors.js.map +1 -0
  198. package/dist/db/kind.js +32 -0
  199. package/dist/db/kind.js.map +1 -0
  200. package/dist/db/openTransaction.js +51 -0
  201. package/dist/db/openTransaction.js.map +1 -0
  202. package/dist/exports/adapters/contract.d.ts +15 -0
  203. package/dist/exports/adapters/ga4.d.ts +16 -1
  204. package/dist/exports/adapters/native.d.ts +27 -2
  205. package/dist/exports/adapters/native.js +4 -1
  206. package/dist/exports/adapters/plausible.d.ts +16 -1
  207. package/dist/exports/adapters/posthog.d.ts +16 -1
  208. package/dist/exports/adapters/umami.d.ts +16 -1
  209. package/dist/exports/attributes.d.ts +42 -0
  210. package/dist/exports/attributes.js +83 -0
  211. package/dist/exports/attributes.js.map +1 -0
  212. package/dist/exports/client.d.ts +43 -13
  213. package/dist/exports/client.js +22 -9
  214. package/dist/exports/geo.d.ts +3 -1
  215. package/dist/exports/geo.js +1 -1
  216. package/dist/exports/i18n.d.ts +2 -2
  217. package/dist/exports/i18n.js +2 -2
  218. package/dist/exports/migrations.d.ts +2 -0
  219. package/dist/exports/migrations.js +2 -0
  220. package/dist/exports/next.d.ts +19 -1
  221. package/dist/exports/next.js +3 -1
  222. package/dist/exports/react.d.ts +3 -2
  223. package/dist/exports/react.js +1 -2
  224. package/dist/exports/rsc.d.ts +32 -14
  225. package/dist/exports/rsc.js +11 -6
  226. package/dist/exports/site.d.ts +5 -0
  227. package/dist/exports/site.js +3 -0
  228. package/dist/exports/testing.d.ts +18 -0
  229. package/dist/exports/testing.js +3 -0
  230. package/dist/exports/tracker.d.ts +5 -20
  231. package/dist/exports/tracker.js +3 -14
  232. package/dist/exports/types.d.ts +44 -14
  233. package/dist/exports/types.js +5 -1
  234. package/dist/fields/AnalyticsPanelClient.js +265 -154
  235. package/dist/fields/AnalyticsPanelClient.js.map +1 -1
  236. package/dist/fields/AnalyticsPanelField.d.ts +19 -7
  237. package/dist/fields/AnalyticsPanelField.js +123 -30
  238. package/dist/fields/AnalyticsPanelField.js.map +1 -1
  239. package/dist/fields/AnalyticsStatField.d.ts +17 -6
  240. package/dist/fields/AnalyticsStatField.js +98 -63
  241. package/dist/fields/AnalyticsStatField.js.map +1 -1
  242. package/dist/fields/FieldShimmer.js +15 -0
  243. package/dist/fields/FieldShimmer.js.map +1 -0
  244. package/dist/fields/PanelContent.js +222 -0
  245. package/dist/fields/PanelContent.js.map +1 -0
  246. package/dist/fields/PanelList.js +82 -0
  247. package/dist/fields/PanelList.js.map +1 -0
  248. package/dist/fields/PanelLiveCounter.js +63 -0
  249. package/dist/fields/PanelLiveCounter.js.map +1 -0
  250. package/dist/fields/PanelSkeleton.js +63 -0
  251. package/dist/fields/PanelSkeleton.js.map +1 -0
  252. package/dist/fields/componentPaths.js +8 -0
  253. package/dist/fields/componentPaths.js.map +1 -0
  254. package/dist/fields/config/FilterDimensionSelectField.d.ts +2 -2
  255. package/dist/fields/config/FilterDimensionSelectField.js +26 -54
  256. package/dist/fields/config/FilterDimensionSelectField.js.map +1 -1
  257. package/dist/fields/config/FilterKeySelect.js +66 -0
  258. package/dist/fields/config/FilterKeySelect.js.map +1 -0
  259. package/dist/fields/config/FilterOperatorSelectField.d.ts +7 -2
  260. package/dist/fields/config/FilterOperatorSelectField.js +37 -53
  261. package/dist/fields/config/FilterOperatorSelectField.js.map +1 -1
  262. package/dist/fields/config/FilterValueField.d.ts +17 -0
  263. package/dist/fields/config/FilterValueField.js +130 -0
  264. package/dist/fields/config/FilterValueField.js.map +1 -0
  265. package/dist/fields/config/MetricSelectField.d.ts +5 -12
  266. package/dist/fields/config/MetricSelectField.js +18 -30
  267. package/dist/fields/config/MetricSelectField.js.map +1 -1
  268. package/dist/fields/config/OptionSelect.js +52 -0
  269. package/dist/fields/config/OptionSelect.js.map +1 -0
  270. package/dist/fields/config/SourceSelectField.js +16 -31
  271. package/dist/fields/config/SourceSelectField.js.map +1 -1
  272. package/dist/fields/config/fetchSources.d.ts +3 -0
  273. package/dist/fields/config/fetchSources.js +17 -27
  274. package/dist/fields/config/fetchSources.js.map +1 -1
  275. package/dist/fields/config/filterValues.js +106 -0
  276. package/dist/fields/config/filterValues.js.map +1 -0
  277. package/dist/fields/config/narrow.js +8 -10
  278. package/dist/fields/config/narrow.js.map +1 -1
  279. package/dist/fields/config/retiredPickers.d.ts +45 -0
  280. package/dist/fields/config/retiredPickers.js +46 -0
  281. package/dist/fields/config/retiredPickers.js.map +1 -0
  282. package/dist/fields/config/scopedFields.d.ts +40 -0
  283. package/dist/fields/config/scopedFields.js +68 -0
  284. package/dist/fields/config/scopedFields.js.map +1 -0
  285. package/dist/fields/config/toSelectOption.js +13 -7
  286. package/dist/fields/config/toSelectOption.js.map +1 -1
  287. package/dist/fields/config/useAnalyticsSources.d.ts +5 -7
  288. package/dist/fields/config/useAnalyticsSources.js +17 -21
  289. package/dist/fields/config/useAnalyticsSources.js.map +1 -1
  290. package/dist/fields/config/useFilterCapabilities.d.ts +9 -6
  291. package/dist/fields/config/useFilterCapabilities.js +23 -15
  292. package/dist/fields/config/useFilterCapabilities.js.map +1 -1
  293. package/dist/fields/config/useFormString.js +12 -0
  294. package/dist/fields/config/useFormString.js.map +1 -0
  295. package/dist/fields/dateRange/field.js +7 -19
  296. package/dist/fields/dateRange/field.js.map +1 -1
  297. package/dist/fields/dateRange/types.d.ts +5 -1
  298. package/dist/fields/dateRange/ui.d.ts +3 -2
  299. package/dist/fields/dateRange/ui.js +57 -319
  300. package/dist/fields/dateRange/ui.js.map +1 -1
  301. package/dist/fields/documentScope.js +21 -0
  302. package/dist/fields/documentScope.js.map +1 -0
  303. package/dist/fields/emptyState.js +31 -26
  304. package/dist/fields/emptyState.js.map +1 -1
  305. package/dist/fields/factories.d.ts +35 -16
  306. package/dist/fields/factories.js +66 -37
  307. package/dist/fields/factories.js.map +1 -1
  308. package/dist/fields/format.d.ts +12 -3
  309. package/dist/fields/format.js +77 -13
  310. package/dist/fields/format.js.map +1 -1
  311. package/dist/fields/itemReport.js +45 -0
  312. package/dist/fields/itemReport.js.map +1 -0
  313. package/dist/fields/readForDocument.d.ts +79 -26
  314. package/dist/fields/readForDocument.js +450 -116
  315. package/dist/fields/readForDocument.js.map +1 -1
  316. package/dist/fields/stateKeys.js +20 -0
  317. package/dist/fields/stateKeys.js.map +1 -0
  318. package/dist/goals/GoalAmountField.d.ts +10 -0
  319. package/dist/goals/GoalAmountField.js +162 -0
  320. package/dist/goals/GoalAmountField.js.map +1 -0
  321. package/dist/goals/GoalSelectField.js +89 -40
  322. package/dist/goals/GoalSelectField.js.map +1 -1
  323. package/dist/goals/GoalSelectFieldServer.d.ts +13 -0
  324. package/dist/goals/GoalSelectFieldServer.js +21 -0
  325. package/dist/goals/GoalSelectFieldServer.js.map +1 -0
  326. package/dist/goals/amountField.d.ts +20 -0
  327. package/dist/goals/amountField.js +37 -0
  328. package/dist/goals/amountField.js.map +1 -0
  329. package/dist/goals/builtin.js +17 -0
  330. package/dist/goals/builtin.js.map +1 -0
  331. package/dist/goals/collection.d.ts +22 -0
  332. package/dist/goals/collection.js +139 -125
  333. package/dist/goals/collection.js.map +1 -1
  334. package/dist/goals/constants.d.ts +38 -0
  335. package/dist/goals/constants.js +49 -0
  336. package/dist/goals/constants.js.map +1 -0
  337. package/dist/goals/currency.d.ts +16 -0
  338. package/dist/goals/currency.js +46 -4
  339. package/dist/goals/currency.js.map +1 -1
  340. package/dist/goals/currencyOptions.js +70 -0
  341. package/dist/goals/currencyOptions.js.map +1 -0
  342. package/dist/goals/fetchGoals.d.ts +10 -0
  343. package/dist/goals/fetchGoals.js +12 -26
  344. package/dist/goals/fetchGoals.js.map +1 -1
  345. package/dist/goals/goalField.d.ts +4 -6
  346. package/dist/goals/goalField.js +9 -19
  347. package/dist/goals/goalField.js.map +1 -1
  348. package/dist/goals/goalsEndpoint.js +39 -40
  349. package/dist/goals/goalsEndpoint.js.map +1 -1
  350. package/dist/goals/items.js +35 -0
  351. package/dist/goals/items.js.map +1 -0
  352. package/dist/goals/latent.js +9 -0
  353. package/dist/goals/latent.js.map +1 -0
  354. package/dist/goals/linkFields.d.ts +35 -0
  355. package/dist/goals/linkFields.js +31 -0
  356. package/dist/goals/linkFields.js.map +1 -0
  357. package/dist/goals/match.d.ts +14 -0
  358. package/dist/goals/match.js +67 -46
  359. package/dist/goals/match.js.map +1 -1
  360. package/dist/goals/moneyFields.js +56 -0
  361. package/dist/goals/moneyFields.js.map +1 -0
  362. package/dist/goals/pathMatch.js +122 -0
  363. package/dist/goals/pathMatch.js.map +1 -0
  364. package/dist/goals/placeholder.js +12 -0
  365. package/dist/goals/placeholder.js.map +1 -0
  366. package/dist/goals/resolver.d.ts +3 -3
  367. package/dist/goals/resolver.js +155 -47
  368. package/dist/goals/resolver.js.map +1 -1
  369. package/dist/goals/serverRevenue.d.ts +60 -0
  370. package/dist/goals/serverRevenue.js +41 -0
  371. package/dist/goals/serverRevenue.js.map +1 -0
  372. package/dist/goals/trackGoalAction.d.ts +26 -27
  373. package/dist/goals/trackGoalAction.js +38 -52
  374. package/dist/goals/trackGoalAction.js.map +1 -1
  375. package/dist/goals/types.d.ts +13 -28
  376. package/dist/goals/types.js +1 -1
  377. package/dist/goals/types.js.map +1 -1
  378. package/dist/goals/useAnalyticsGoals.d.ts +6 -5
  379. package/dist/goals/useAnalyticsGoals.js +17 -18
  380. package/dist/goals/useAnalyticsGoals.js.map +1 -1
  381. package/dist/index.d.ts +67 -12
  382. package/dist/index.js +258 -247
  383. package/dist/index.js.map +1 -1
  384. package/dist/items/collectionIdType.js +20 -0
  385. package/dist/items/collectionIdType.js.map +1 -0
  386. package/dist/items/idType.js +31 -0
  387. package/dist/items/idType.js.map +1 -0
  388. package/dist/items/ref.js +73 -0
  389. package/dist/items/ref.js.map +1 -0
  390. package/dist/maintenance/apiTaskState.js +141 -0
  391. package/dist/maintenance/apiTaskState.js.map +1 -0
  392. package/dist/maintenance/heartbeat.js +51 -0
  393. package/dist/maintenance/heartbeat.js.map +1 -0
  394. package/dist/maintenance/lease.d.ts +1 -0
  395. package/dist/maintenance/lease.js +81 -0
  396. package/dist/maintenance/lease.js.map +1 -0
  397. package/dist/maintenance/taskSchedule.d.ts +1 -0
  398. package/dist/maintenance/taskSchedule.js +62 -0
  399. package/dist/maintenance/taskSchedule.js.map +1 -0
  400. package/dist/maintenance/underLease.js +35 -0
  401. package/dist/maintenance/underLease.js.map +1 -0
  402. package/dist/migrations/legacy.d.ts +54 -0
  403. package/dist/migrations/legacy.js +117 -0
  404. package/dist/migrations/legacy.js.map +1 -0
  405. package/dist/migrations/predefined/dropLegacyMongo.d.ts +11 -0
  406. package/dist/migrations/predefined/dropLegacyMongo.js +12 -0
  407. package/dist/migrations/predefined/dropLegacyMongo.js.map +1 -0
  408. package/dist/native/collections/aggregates.js +54 -0
  409. package/dist/native/collections/aggregates.js.map +1 -0
  410. package/dist/native/collections/hits.js +102 -0
  411. package/dist/native/collections/hits.js.map +1 -0
  412. package/dist/native/collections/slugs.d.ts +10 -0
  413. package/dist/native/collections/slugs.js +16 -0
  414. package/dist/native/collections/slugs.js.map +1 -0
  415. package/dist/native/collections/state.js +84 -0
  416. package/dist/native/collections/state.js.map +1 -0
  417. package/dist/native/collections/storeCollection.js +29 -0
  418. package/dist/native/collections/storeCollection.js.map +1 -0
  419. package/dist/native/engine/buckets.d.ts +1 -0
  420. package/dist/native/engine/buckets.js +53 -0
  421. package/dist/native/engine/buckets.js.map +1 -0
  422. package/dist/native/engine/capabilities.js +87 -0
  423. package/dist/native/engine/capabilities.js.map +1 -0
  424. package/dist/native/engine/cost.js +72 -0
  425. package/dist/native/engine/cost.js.map +1 -0
  426. package/dist/native/engine/days.d.ts +1 -0
  427. package/dist/native/engine/days.js +182 -0
  428. package/dist/native/engine/days.js.map +1 -0
  429. package/dist/native/engine/engine.d.ts +1 -0
  430. package/dist/native/engine/engine.js +1623 -0
  431. package/dist/native/engine/engine.js.map +1 -0
  432. package/dist/native/engine/instance.js +58 -0
  433. package/dist/native/engine/instance.js.map +1 -0
  434. package/dist/native/engine/maintenance.d.ts +1 -0
  435. package/dist/native/engine/maintenance.js +677 -0
  436. package/dist/native/engine/maintenance.js.map +1 -0
  437. package/dist/native/engine/merge.js +41 -0
  438. package/dist/native/engine/merge.js.map +1 -0
  439. package/dist/native/engine/nudge.js +26 -0
  440. package/dist/native/engine/nudge.js.map +1 -0
  441. package/dist/native/engine/planner.js +198 -0
  442. package/dist/native/engine/planner.js.map +1 -0
  443. package/dist/native/engine/rebuild.d.ts +22 -0
  444. package/dist/native/engine/rebuild.js +76 -0
  445. package/dist/native/engine/rebuild.js.map +1 -0
  446. package/dist/native/engine/recent.js +17 -0
  447. package/dist/native/engine/recent.js.map +1 -0
  448. package/dist/native/engine/salt.d.ts +1 -0
  449. package/dist/native/engine/salt.js +98 -0
  450. package/dist/native/engine/salt.js.map +1 -0
  451. package/dist/native/engine/siteHosts.d.ts +1 -0
  452. package/dist/native/engine/siteHosts.js +58 -0
  453. package/dist/native/engine/siteHosts.js.map +1 -0
  454. package/dist/native/engine/toHit.js +108 -0
  455. package/dist/native/engine/toHit.js.map +1 -0
  456. package/dist/native/engine/writeBuffer.d.ts +14 -0
  457. package/dist/native/engine/writeBuffer.js +317 -0
  458. package/dist/native/engine/writeBuffer.js.map +1 -0
  459. package/dist/native/geo/composeGeoResolvers.d.ts +1 -0
  460. package/dist/native/geo/composeGeoResolvers.js +4 -1
  461. package/dist/native/geo/composeGeoResolvers.js.map +1 -1
  462. package/dist/native/geo/geoResolver.d.ts +20 -2
  463. package/dist/native/geo/geoResolver.js +42 -6
  464. package/dist/native/geo/geoResolver.js.map +1 -1
  465. package/dist/native/geo/maxmindResolver.d.ts +8 -4
  466. package/dist/native/geo/maxmindResolver.js +20 -16
  467. package/dist/native/geo/maxmindResolver.js.map +1 -1
  468. package/dist/native/geo/resolveGeo.js +31 -0
  469. package/dist/native/geo/resolveGeo.js.map +1 -0
  470. package/dist/native/ingest/bots.d.ts +2 -3
  471. package/dist/native/ingest/bots.js +8 -13
  472. package/dist/native/ingest/bots.js.map +1 -1
  473. package/dist/native/ingest/browser.js +4 -6
  474. package/dist/native/ingest/browser.js.map +1 -1
  475. package/dist/native/ingest/clientIp.js +30 -9
  476. package/dist/native/ingest/clientIp.js.map +1 -1
  477. package/dist/native/ingest/device.js +4 -6
  478. package/dist/native/ingest/device.js.map +1 -1
  479. package/dist/native/ingest/endpoint.d.ts +1 -1
  480. package/dist/native/ingest/endpoint.js +119 -34
  481. package/dist/native/ingest/endpoint.js.map +1 -1
  482. package/dist/native/ingest/itemSignature.d.ts +26 -0
  483. package/dist/native/ingest/itemSignature.js +45 -0
  484. package/dist/native/ingest/itemSignature.js.map +1 -0
  485. package/dist/native/ingest/language.js +2 -3
  486. package/dist/native/ingest/language.js.map +1 -1
  487. package/dist/native/ingest/normalizeEvent.d.ts +60 -7
  488. package/dist/native/ingest/normalizeEvent.js +226 -61
  489. package/dist/native/ingest/normalizeEvent.js.map +1 -1
  490. package/dist/native/ingest/orderSignature.d.ts +13 -0
  491. package/dist/native/ingest/orderSignature.js +50 -0
  492. package/dist/native/ingest/orderSignature.js.map +1 -0
  493. package/dist/native/ingest/referrer.js +30 -32
  494. package/dist/native/ingest/referrer.js.map +1 -1
  495. package/dist/native/ingest/requestHost.js +10 -23
  496. package/dist/native/ingest/requestHost.js.map +1 -1
  497. package/dist/native/ingest/resolveHostname.d.ts +4 -13
  498. package/dist/native/ingest/resolveHostname.js +5 -6
  499. package/dist/native/ingest/resolveHostname.js.map +1 -1
  500. package/dist/native/ingest/revenue.d.ts +1 -0
  501. package/dist/native/ingest/revenue.js +121 -0
  502. package/dist/native/ingest/revenue.js.map +1 -0
  503. package/dist/native/ingest/route.d.ts +10 -0
  504. package/dist/native/ingest/route.js +82 -0
  505. package/dist/native/ingest/route.js.map +1 -0
  506. package/dist/native/ingest/serverTrack.d.ts +2 -10
  507. package/dist/native/ingest/serverTrack.js +181 -72
  508. package/dist/native/ingest/serverTrack.js.map +1 -1
  509. package/dist/native/ingest/signature.js +28 -0
  510. package/dist/native/ingest/signature.js.map +1 -0
  511. package/dist/native/ingest/source.d.ts +2 -3
  512. package/dist/native/ingest/source.js +35 -54
  513. package/dist/native/ingest/source.js.map +1 -1
  514. package/dist/native/ingest/utm.js +9 -9
  515. package/dist/native/ingest/utm.js.map +1 -1
  516. package/dist/native/ingest/validate.js +20 -10
  517. package/dist/native/ingest/validate.js.map +1 -1
  518. package/dist/native/ingest/visitorHash.js +6 -8
  519. package/dist/native/ingest/visitorHash.js.map +1 -1
  520. package/dist/native/nativeAdapter.d.ts +107 -33
  521. package/dist/native/nativeAdapter.js +376 -317
  522. package/dist/native/nativeAdapter.js.map +1 -1
  523. package/dist/native/rebuildDays.d.ts +12 -0
  524. package/dist/native/rebuildDays.js +16 -0
  525. package/dist/native/rebuildDays.js.map +1 -0
  526. package/dist/native/store/aggregate.js +450 -0
  527. package/dist/native/store/aggregate.js.map +1 -0
  528. package/dist/native/store/caps.d.ts +18 -0
  529. package/dist/native/store/caps.js +76 -0
  530. package/dist/native/store/caps.js.map +1 -0
  531. package/dist/native/store/chunks.js +34 -0
  532. package/dist/native/store/chunks.js.map +1 -0
  533. package/dist/native/store/columnValues.js +31 -0
  534. package/dist/native/store/columnValues.js.map +1 -0
  535. package/dist/native/store/dialect.js +106 -0
  536. package/dist/native/store/dialect.js.map +1 -0
  537. package/dist/native/store/eventStore.js +44 -0
  538. package/dist/native/store/eventStore.js.map +1 -0
  539. package/dist/native/store/hitRow.js +116 -0
  540. package/dist/native/store/hitRow.js.map +1 -0
  541. package/dist/native/store/hits.js +63 -0
  542. package/dist/native/store/hits.js.map +1 -0
  543. package/dist/native/store/ids.js +105 -0
  544. package/dist/native/store/ids.js.map +1 -0
  545. package/dist/native/store/mongo/aggregatePipelines.js +430 -0
  546. package/dist/native/store/mongo/aggregatePipelines.js.map +1 -0
  547. package/dist/native/store/mongo/mongoState.js +375 -0
  548. package/dist/native/store/mongo/mongoState.js.map +1 -0
  549. package/dist/native/store/mongo/mongoStore.js +618 -0
  550. package/dist/native/store/mongo/mongoStore.js.map +1 -0
  551. package/dist/native/store/mongo/pipelines.js +695 -0
  552. package/dist/native/store/mongo/pipelines.js.map +1 -0
  553. package/dist/native/store/mongo/results.js +20 -0
  554. package/dist/native/store/mongo/results.js.map +1 -0
  555. package/dist/native/store/parts.d.ts +1 -0
  556. package/dist/native/store/parts.js +95 -0
  557. package/dist/native/store/parts.js.map +1 -0
  558. package/dist/native/store/pattern.js +213 -0
  559. package/dist/native/store/pattern.js.map +1 -0
  560. package/dist/native/store/rawRead.d.ts +23 -0
  561. package/dist/native/store/rawRead.js +384 -0
  562. package/dist/native/store/rawRead.js.map +1 -0
  563. package/dist/native/store/reclassify.js +53 -0
  564. package/dist/native/store/reclassify.js.map +1 -0
  565. package/dist/native/store/sql/aggregateSql.js +345 -0
  566. package/dist/native/store/sql/aggregateSql.js.map +1 -0
  567. package/dist/native/store/sql/columns.js +48 -0
  568. package/dist/native/store/sql/columns.js.map +1 -0
  569. package/dist/native/store/sql/compile.js +656 -0
  570. package/dist/native/store/sql/compile.js.map +1 -0
  571. package/dist/native/store/sql/drivers.js +218 -0
  572. package/dist/native/store/sql/drivers.js.map +1 -0
  573. package/dist/native/store/sql/executor.js +132 -0
  574. package/dist/native/store/sql/executor.js.map +1 -0
  575. package/dist/native/store/sql/fragment.js +104 -0
  576. package/dist/native/store/sql/fragment.js.map +1 -0
  577. package/dist/native/store/sql/maintenanceSql.js +59 -0
  578. package/dist/native/store/sql/maintenanceSql.js.map +1 -0
  579. package/dist/native/store/sql/ownConnection.js +107 -0
  580. package/dist/native/store/sql/ownConnection.js.map +1 -0
  581. package/dist/native/store/sql/poolShare.js +101 -0
  582. package/dist/native/store/sql/poolShare.js.map +1 -0
  583. package/dist/native/store/sql/sqlState.js +325 -0
  584. package/dist/native/store/sql/sqlState.js.map +1 -0
  585. package/dist/native/store/sql/sqlStore.js +355 -0
  586. package/dist/native/store/sql/sqlStore.js.map +1 -0
  587. package/dist/native/store/sql/sqliteThread.d.ts +9 -0
  588. package/dist/native/store/sql/sqliteThread.js +314 -0
  589. package/dist/native/store/sql/sqliteThread.js.map +1 -0
  590. package/dist/native/store/sql/sqliteWorker.js +327 -0
  591. package/dist/native/store/sql/sqliteWorker.js.map +1 -0
  592. package/dist/native/store/sql/sqliteWorkerSource.js +347 -0
  593. package/dist/native/store/sql/sqliteWorkerSource.js.map +1 -0
  594. package/dist/native/store/state.js +151 -0
  595. package/dist/native/store/state.js.map +1 -0
  596. package/dist/native/store/stateStore.js +29 -0
  597. package/dist/native/store/stateStore.js.map +1 -0
  598. package/dist/native/store/types.d.ts +9 -0
  599. package/dist/native/tasks/maintainTask.d.ts +19 -0
  600. package/dist/native/tasks/maintainTask.js +68 -0
  601. package/dist/native/tasks/maintainTask.js.map +1 -0
  602. package/dist/net/guardedFetch.d.ts +32 -0
  603. package/dist/net/guardedFetch.js +220 -0
  604. package/dist/net/guardedFetch.js.map +1 -0
  605. package/dist/net/origin.js +40 -0
  606. package/dist/net/origin.js.map +1 -0
  607. package/dist/net/platform.d.ts +9 -0
  608. package/dist/net/platform.js +35 -0
  609. package/dist/net/platform.js.map +1 -0
  610. package/dist/next/captureRewrites.d.ts +4 -24
  611. package/dist/next/captureRewrites.js +6 -50
  612. package/dist/next/captureRewrites.js.map +1 -1
  613. package/dist/next/captureRoute.d.ts +28 -0
  614. package/dist/next/captureRoute.js +67 -0
  615. package/dist/next/captureRoute.js.map +1 -0
  616. package/dist/next/ingestRoute.d.ts +17 -0
  617. package/dist/next/ingestRoute.js +17 -0
  618. package/dist/next/ingestRoute.js.map +1 -0
  619. package/dist/next/posthogProxyRewrites.d.ts +3 -25
  620. package/dist/next/posthogProxyRewrites.js +5 -37
  621. package/dist/next/posthogProxyRewrites.js.map +1 -1
  622. package/dist/plugin/adminDependencies.js +34 -0
  623. package/dist/plugin/adminDependencies.js.map +1 -0
  624. package/dist/plugin/apiPath.js +23 -0
  625. package/dist/plugin/apiPath.js.map +1 -0
  626. package/dist/plugin/boundDocument.js +58 -0
  627. package/dist/plugin/boundDocument.js.map +1 -0
  628. package/dist/plugin/buildPhase.js +10 -0
  629. package/dist/plugin/buildPhase.js.map +1 -0
  630. package/dist/plugin/collectionChecks.js +232 -0
  631. package/dist/plugin/collectionChecks.js.map +1 -0
  632. package/dist/plugin/collectionFields.d.ts +13 -0
  633. package/dist/plugin/collectionFields.js +22 -0
  634. package/dist/plugin/collectionFields.js.map +1 -0
  635. package/dist/plugin/createRuntime.js +339 -0
  636. package/dist/plugin/createRuntime.js.map +1 -0
  637. package/dist/plugin/destroy.js +58 -0
  638. package/dist/plugin/destroy.js.map +1 -0
  639. package/dist/plugin/documentEndpoint.js +77 -53
  640. package/dist/plugin/documentEndpoint.js.map +1 -1
  641. package/dist/plugin/documentScopes.js +37 -0
  642. package/dist/plugin/documentScopes.js.map +1 -0
  643. package/dist/plugin/encrypted.js +25 -0
  644. package/dist/plugin/encrypted.js.map +1 -0
  645. package/dist/plugin/errors.d.ts +5 -12
  646. package/dist/plugin/errors.js +23 -16
  647. package/dist/plugin/errors.js.map +1 -1
  648. package/dist/plugin/flagsEndpoint.js +41 -0
  649. package/dist/plugin/flagsEndpoint.js.map +1 -0
  650. package/dist/plugin/goalHint.js +22 -11
  651. package/dist/plugin/goalHint.js.map +1 -1
  652. package/dist/plugin/itemLabels.js +114 -0
  653. package/dist/plugin/itemLabels.js.map +1 -0
  654. package/dist/plugin/jobsAccess.js +91 -0
  655. package/dist/plugin/jobsAccess.js.map +1 -0
  656. package/dist/plugin/keepAlive.js +48 -0
  657. package/dist/plugin/keepAlive.js.map +1 -0
  658. package/dist/plugin/peerImportError.js +3 -6
  659. package/dist/plugin/peerImportError.js.map +1 -1
  660. package/dist/plugin/peers.js +64 -0
  661. package/dist/plugin/peers.js.map +1 -0
  662. package/dist/plugin/pluginCollections.js +161 -0
  663. package/dist/plugin/pluginCollections.js.map +1 -0
  664. package/dist/plugin/queryEndpoint.js +70 -45
  665. package/dist/plugin/queryEndpoint.js.map +1 -1
  666. package/dist/plugin/queryParams.js +7 -0
  667. package/dist/plugin/queryParams.js.map +1 -0
  668. package/dist/plugin/readContextForRequest.d.ts +11 -0
  669. package/dist/plugin/readContextForRequest.js +70 -25
  670. package/dist/plugin/readContextForRequest.js.map +1 -1
  671. package/dist/plugin/readFailure.js +22 -0
  672. package/dist/plugin/readFailure.js.map +1 -0
  673. package/dist/plugin/readableProviders.js +64 -0
  674. package/dist/plugin/readableProviders.js.map +1 -0
  675. package/dist/plugin/realtimeEndpoint.js +77 -25
  676. package/dist/plugin/realtimeEndpoint.js.map +1 -1
  677. package/dist/plugin/refreshEndpoint.js +69 -44
  678. package/dist/plugin/refreshEndpoint.js.map +1 -1
  679. package/dist/plugin/relabelFields.js +36 -0
  680. package/dist/plugin/relabelFields.js.map +1 -0
  681. package/dist/plugin/requestMemo.js +35 -0
  682. package/dist/plugin/requestMemo.js.map +1 -0
  683. package/dist/plugin/routeChecks.js +39 -0
  684. package/dist/plugin/routeChecks.js.map +1 -0
  685. package/dist/plugin/routes.d.ts +53 -0
  686. package/dist/plugin/routes.js +92 -0
  687. package/dist/plugin/routes.js.map +1 -0
  688. package/dist/plugin/runtime.d.ts +1 -1
  689. package/dist/plugin/runtime.js +234 -30
  690. package/dist/plugin/runtime.js.map +1 -1
  691. package/dist/plugin/schemaOnly.js +63 -0
  692. package/dist/plugin/schemaOnly.js.map +1 -0
  693. package/dist/plugin/scopeChange.js +6 -5
  694. package/dist/plugin/scopeChange.js.map +1 -1
  695. package/dist/plugin/scopeFieldBoot.js +4 -4
  696. package/dist/plugin/scopeFieldBoot.js.map +1 -1
  697. package/dist/plugin/scopeToken.js +33 -0
  698. package/dist/plugin/scopeToken.js.map +1 -0
  699. package/dist/plugin/sourcesEndpoint.js +50 -17
  700. package/dist/plugin/sourcesEndpoint.js.map +1 -1
  701. package/dist/plugin/unbundledLanguages.js +25 -0
  702. package/dist/plugin/unbundledLanguages.js.map +1 -0
  703. package/dist/plugin/walkFields.js +22 -0
  704. package/dist/plugin/walkFields.js.map +1 -0
  705. package/dist/plugin/warmTask.js +0 -0
  706. package/dist/plugin/warmTask.js.map +1 -1
  707. package/dist/providers/ProvidersListNotice.d.ts +11 -0
  708. package/dist/providers/ProvidersListNotice.js +36 -0
  709. package/dist/providers/ProvidersListNotice.js.map +1 -0
  710. package/dist/providers/access.d.ts +1 -0
  711. package/dist/providers/access.js +35 -26
  712. package/dist/providers/access.js.map +1 -1
  713. package/dist/providers/adapterPool.js +121 -0
  714. package/dist/providers/adapterPool.js.map +1 -0
  715. package/dist/providers/collection.d.ts +61 -0
  716. package/dist/providers/collection.js +340 -151
  717. package/dist/providers/collection.js.map +1 -1
  718. package/dist/providers/factory.d.ts +76 -0
  719. package/dist/providers/factory.js +75 -25
  720. package/dist/providers/factory.js.map +1 -1
  721. package/dist/providers/hosts.d.ts +25 -0
  722. package/dist/providers/hosts.js +128 -0
  723. package/dist/providers/hosts.js.map +1 -0
  724. package/dist/providers/probe.d.ts +1 -0
  725. package/dist/providers/probe.js +105 -0
  726. package/dist/providers/probe.js.map +1 -0
  727. package/dist/providers/refresh.d.ts +18 -0
  728. package/dist/providers/refresh.js +49 -0
  729. package/dist/providers/refresh.js.map +1 -0
  730. package/dist/providers/registry.js +328 -0
  731. package/dist/providers/registry.js.map +1 -0
  732. package/dist/providers/resolver.js +26 -88
  733. package/dist/providers/resolver.js.map +1 -1
  734. package/dist/providers/retarget.js +45 -0
  735. package/dist/providers/retarget.js.map +1 -0
  736. package/dist/providers/scopeUnique.js +41 -0
  737. package/dist/providers/scopeUnique.js.map +1 -0
  738. package/dist/providers/secrets.d.ts +26 -0
  739. package/dist/providers/secrets.js +61 -4
  740. package/dist/providers/secrets.js.map +1 -1
  741. package/dist/providers/stampScope.js +9 -6
  742. package/dist/providers/stampScope.js.map +1 -1
  743. package/dist/query/dates.js +10 -12
  744. package/dist/query/dates.js.map +1 -1
  745. package/dist/query/errors.d.ts +1 -5
  746. package/dist/query/fetchQuery.d.ts +25 -32
  747. package/dist/query/fetchQuery.js +91 -91
  748. package/dist/query/fetchQuery.js.map +1 -1
  749. package/dist/query/limits.js +8 -0
  750. package/dist/query/limits.js.map +1 -0
  751. package/dist/query/parse.d.ts +6 -0
  752. package/dist/query/parse.js +153 -106
  753. package/dist/query/parse.js.map +1 -1
  754. package/dist/query/response.d.ts +23 -3
  755. package/dist/query/response.js +12 -5
  756. package/dist/query/response.js.map +1 -1
  757. package/dist/react/AnalyticsProvider.d.ts +26 -17
  758. package/dist/react/AnalyticsProvider.js +23 -22
  759. package/dist/react/AnalyticsProvider.js.map +1 -1
  760. package/dist/react/TrackerBoot.js +15 -9
  761. package/dist/react/TrackerBoot.js.map +1 -1
  762. package/dist/react/useAnalytics.d.ts +2 -11
  763. package/dist/react/useAnalytics.js +22 -24
  764. package/dist/react/useAnalytics.js.map +1 -1
  765. package/dist/site/AnalyticsScripts.d.ts +34 -0
  766. package/dist/site/AnalyticsScripts.js +30 -0
  767. package/dist/site/AnalyticsScripts.js.map +1 -0
  768. package/dist/site/getTrackerConfig.d.ts +15 -0
  769. package/dist/site/getTrackerConfig.js +40 -0
  770. package/dist/site/getTrackerConfig.js.map +1 -0
  771. package/dist/surfacing/afterRead.d.ts +37 -0
  772. package/dist/surfacing/bounded.js +38 -0
  773. package/dist/surfacing/bounded.js.map +1 -0
  774. package/dist/surfacing/breaker.js +107 -0
  775. package/dist/surfacing/breaker.js.map +1 -0
  776. package/dist/surfacing/cacheCollection.d.ts +8 -0
  777. package/dist/surfacing/cacheCollection.js +69 -0
  778. package/dist/surfacing/cacheCollection.js.map +1 -0
  779. package/dist/surfacing/cacheStore.d.ts +71 -1
  780. package/dist/surfacing/cacheStore.js +16 -37
  781. package/dist/surfacing/cacheStore.js.map +1 -1
  782. package/dist/surfacing/cacheSweep.d.ts +1 -0
  783. package/dist/surfacing/cacheSweep.js +59 -0
  784. package/dist/surfacing/cacheSweep.js.map +1 -0
  785. package/dist/surfacing/classifyError.js +282 -0
  786. package/dist/surfacing/classifyError.js.map +1 -0
  787. package/dist/surfacing/coalesce.js +2 -1
  788. package/dist/surfacing/coalesce.js.map +1 -1
  789. package/dist/surfacing/coldBudget.js +60 -0
  790. package/dist/surfacing/coldBudget.js.map +1 -0
  791. package/dist/surfacing/collectionCacheStore.js +183 -0
  792. package/dist/surfacing/collectionCacheStore.js.map +1 -0
  793. package/dist/surfacing/engine.d.ts +1 -1
  794. package/dist/surfacing/engine.js +514 -72
  795. package/dist/surfacing/engine.js.map +1 -1
  796. package/dist/surfacing/epoch.js +70 -26
  797. package/dist/surfacing/epoch.js.map +1 -1
  798. package/dist/surfacing/lanes.d.ts +1 -0
  799. package/dist/surfacing/lanes.js +297 -0
  800. package/dist/surfacing/lanes.js.map +1 -0
  801. package/dist/surfacing/memo.js +40 -0
  802. package/dist/surfacing/memo.js.map +1 -0
  803. package/dist/surfacing/rateLimiter.d.ts +1 -0
  804. package/dist/surfacing/rateLimiter.js +69 -94
  805. package/dist/surfacing/rateLimiter.js.map +1 -1
  806. package/dist/surfacing/rebucket.js +178 -0
  807. package/dist/surfacing/rebucket.js.map +1 -0
  808. package/dist/surfacing/recipe.js +28 -0
  809. package/dist/surfacing/recipe.js.map +1 -0
  810. package/dist/surfacing/shape.js +22 -0
  811. package/dist/surfacing/shape.js.map +1 -0
  812. package/dist/surfacing/todaySplit.js +113 -0
  813. package/dist/surfacing/todaySplit.js.map +1 -0
  814. package/dist/sync/collection.d.ts +8 -0
  815. package/dist/sync/collection.js +28 -18
  816. package/dist/sync/collection.js.map +1 -1
  817. package/dist/sync/rekeyDurations.js +70 -0
  818. package/dist/sync/rekeyDurations.js.map +1 -0
  819. package/dist/sync/syncTask.js +226 -109
  820. package/dist/sync/syncTask.js.map +1 -1
  821. package/dist/testing/memoryAdapter.d.ts +6 -3
  822. package/dist/testing/memoryAdapter.js +12 -10
  823. package/dist/testing/memoryAdapter.js.map +1 -1
  824. package/dist/testing/settle.d.ts +11 -0
  825. package/dist/testing/settle.js +19 -0
  826. package/dist/testing/settle.js.map +1 -0
  827. package/dist/timeframe/calendar.js +65 -0
  828. package/dist/timeframe/calendar.js.map +1 -0
  829. package/dist/timeframe/comparison.js +46 -0
  830. package/dist/timeframe/comparison.js.map +1 -0
  831. package/dist/timeframe/presets.d.ts +1 -1
  832. package/dist/timeframe/presets.js +5 -5
  833. package/dist/timeframe/presets.js.map +1 -1
  834. package/dist/timeframe/reportingTimezone.d.ts +1 -0
  835. package/dist/timeframe/reportingTimezone.js +64 -0
  836. package/dist/timeframe/reportingTimezone.js.map +1 -0
  837. package/dist/timeframe/tz.js +55 -39
  838. package/dist/timeframe/tz.js.map +1 -1
  839. package/dist/tracker/autoCapture.js +125 -38
  840. package/dist/tracker/autoCapture.js.map +1 -1
  841. package/dist/tracker/campaign.js +52 -0
  842. package/dist/tracker/campaign.js.map +1 -0
  843. package/dist/tracker/config.d.ts +149 -0
  844. package/dist/tracker/config.js +25 -0
  845. package/dist/tracker/config.js.map +1 -0
  846. package/dist/tracker/createTracker.d.ts +4 -10
  847. package/dist/tracker/createTracker.js +386 -115
  848. package/dist/tracker/createTracker.js.map +1 -1
  849. package/dist/tracker/digest.js +28 -0
  850. package/dist/tracker/digest.js.map +1 -0
  851. package/dist/tracker/engagement.js +100 -0
  852. package/dist/tracker/engagement.js.map +1 -0
  853. package/dist/tracker/events.js +37 -0
  854. package/dist/tracker/events.js.map +1 -0
  855. package/dist/tracker/exclusion.d.ts +2 -22
  856. package/dist/tracker/exclusion.js +53 -21
  857. package/dist/tracker/exclusion.js.map +1 -1
  858. package/dist/tracker/gate.js +194 -0
  859. package/dist/tracker/gate.js.map +1 -0
  860. package/dist/tracker/initTracker.d.ts +5 -8
  861. package/dist/tracker/initTracker.js +42 -14
  862. package/dist/tracker/initTracker.js.map +1 -1
  863. package/dist/tracker/itemCapture.js +224 -0
  864. package/dist/tracker/itemCapture.js.map +1 -0
  865. package/dist/tracker/loadScript.js +21 -14
  866. package/dist/tracker/loadScript.js.map +1 -1
  867. package/dist/tracker/pageTracking.js +6 -6
  868. package/dist/tracker/pageTracking.js.map +1 -1
  869. package/dist/tracker/registry.js +118 -30
  870. package/dist/tracker/registry.js.map +1 -1
  871. package/dist/tracker/sinks/createSink.js +41 -0
  872. package/dist/tracker/sinks/createSink.js.map +1 -0
  873. package/dist/tracker/sinks/ga4.js +64 -20
  874. package/dist/tracker/sinks/ga4.js.map +1 -1
  875. package/dist/tracker/sinks/native.js +7 -42
  876. package/dist/tracker/sinks/native.js.map +1 -1
  877. package/dist/tracker/sinks/plausible.js +27 -22
  878. package/dist/tracker/sinks/plausible.js.map +1 -1
  879. package/dist/tracker/sinks/posthog.js +54 -22
  880. package/dist/tracker/sinks/posthog.js.map +1 -1
  881. package/dist/tracker/sinks/umami.js +14 -12
  882. package/dist/tracker/sinks/umami.js.map +1 -1
  883. package/dist/tracker/sinks/vendor.js +30 -27
  884. package/dist/tracker/sinks/vendor.js.map +1 -1
  885. package/dist/tracker/skip.js +81 -0
  886. package/dist/tracker/skip.js.map +1 -0
  887. package/dist/tracker/storage.js +23 -0
  888. package/dist/tracker/storage.js.map +1 -0
  889. package/dist/tracker/transport.js +2 -5
  890. package/dist/tracker/transport.js.map +1 -1
  891. package/dist/tracker/types.d.ts +86 -63
  892. package/dist/tracker/window.js +7 -0
  893. package/dist/tracker/window.js.map +1 -0
  894. package/dist/translations/ar.js +232 -71
  895. package/dist/translations/ar.js.map +1 -1
  896. package/dist/translations/de.js +221 -69
  897. package/dist/translations/de.js.map +1 -1
  898. package/dist/translations/en.js +215 -67
  899. package/dist/translations/en.js.map +1 -1
  900. package/dist/translations/es.js +223 -68
  901. package/dist/translations/es.js.map +1 -1
  902. package/dist/translations/fr.js +227 -72
  903. package/dist/translations/fr.js.map +1 -1
  904. package/dist/translations/id.js +218 -67
  905. package/dist/translations/id.js.map +1 -1
  906. package/dist/translations/index.d.ts +1 -1
  907. package/dist/translations/index.js +5 -7
  908. package/dist/translations/index.js.map +1 -1
  909. package/dist/translations/intl.js +71 -0
  910. package/dist/translations/intl.js.map +1 -0
  911. package/dist/translations/keys.d.ts +191 -14
  912. package/dist/translations/keys.js +196 -14
  913. package/dist/translations/keys.js.map +1 -1
  914. package/dist/translations/ko.js +220 -69
  915. package/dist/translations/ko.js.map +1 -1
  916. package/dist/translations/labelMap.d.ts +10 -0
  917. package/dist/translations/labelMap.js +22 -0
  918. package/dist/translations/labelMap.js.map +1 -0
  919. package/dist/translations/metricKeys.js +10 -2
  920. package/dist/translations/metricKeys.js.map +1 -1
  921. package/dist/translations/parts.js +20 -0
  922. package/dist/translations/parts.js.map +1 -0
  923. package/dist/translations/plural.js +61 -0
  924. package/dist/translations/plural.js.map +1 -0
  925. package/dist/translations/pt.js +232 -77
  926. package/dist/translations/pt.js.map +1 -1
  927. package/dist/translations/ru.js +223 -66
  928. package/dist/translations/ru.js.map +1 -1
  929. package/dist/translations/server.d.ts +1 -0
  930. package/dist/translations/server.js +2 -3
  931. package/dist/translations/server.js.map +1 -1
  932. package/dist/translations/staticLabel.js +69 -0
  933. package/dist/translations/staticLabel.js.map +1 -0
  934. package/dist/translations/uk.js +223 -66
  935. package/dist/translations/uk.js.map +1 -1
  936. package/dist/translations/zh.js +218 -67
  937. package/dist/translations/zh.js.map +1 -1
  938. package/dist/ui/RangePicker.js +112 -0
  939. package/dist/ui/RangePicker.js.map +1 -0
  940. package/dist/ui/analytics.css +1533 -0
  941. package/dist/ui/calendarDays.js +27 -0
  942. package/dist/ui/calendarDays.js.map +1 -0
  943. package/dist/ui/classNames.js +7 -0
  944. package/dist/ui/classNames.js.map +1 -0
  945. package/dist/ui/components/Card.d.ts +28 -0
  946. package/dist/ui/components/Card.js +21 -0
  947. package/dist/ui/components/Card.js.map +1 -0
  948. package/dist/ui/components/ChartDataTable.d.ts +41 -0
  949. package/dist/ui/components/ChartDataTable.js +48 -0
  950. package/dist/ui/components/ChartDataTable.js.map +1 -0
  951. package/dist/ui/components/DataTable.d.ts +82 -0
  952. package/dist/ui/components/DataTable.js +214 -0
  953. package/dist/ui/components/DataTable.js.map +1 -0
  954. package/dist/ui/components/LabeledSelect.js +62 -0
  955. package/dist/ui/components/LabeledSelect.js.map +1 -0
  956. package/dist/ui/components/LiveAnnouncement.js +21 -0
  957. package/dist/ui/components/LiveAnnouncement.js.map +1 -0
  958. package/dist/ui/components/MetricCard.d.ts +38 -0
  959. package/dist/ui/components/MetricCard.js +39 -0
  960. package/dist/ui/components/MetricCard.js.map +1 -0
  961. package/dist/ui/components/NoValue.js +22 -0
  962. package/dist/ui/components/NoValue.js.map +1 -0
  963. package/dist/ui/components/ReadState.js +27 -0
  964. package/dist/ui/components/ReadState.js.map +1 -0
  965. package/dist/ui/components/RefreshButton.js +26 -0
  966. package/dist/ui/components/RefreshButton.js.map +1 -0
  967. package/dist/ui/components/SourcesNoticeBanner.js +20 -0
  968. package/dist/ui/components/SourcesNoticeBanner.js.map +1 -0
  969. package/dist/ui/cssVars.js +7 -0
  970. package/dist/ui/cssVars.js.map +1 -0
  971. package/dist/ui/data/WithScopeToken.d.ts +20 -0
  972. package/dist/ui/data/WithScopeToken.js +20 -0
  973. package/dist/ui/data/WithScopeToken.js.map +1 -0
  974. package/dist/ui/data/clientFieldProps.js +16 -0
  975. package/dist/ui/data/clientFieldProps.js.map +1 -0
  976. package/dist/ui/data/request.d.ts +46 -0
  977. package/dist/ui/data/request.js +119 -0
  978. package/dist/ui/data/request.js.map +1 -0
  979. package/dist/ui/data/scopeTokenContext.js +18 -0
  980. package/dist/ui/data/scopeTokenContext.js.map +1 -0
  981. package/dist/ui/data/sharedCache.js +48 -0
  982. package/dist/ui/data/sharedCache.js.map +1 -0
  983. package/dist/ui/data/useRequest.d.ts +19 -0
  984. package/dist/ui/data/useRequest.js +123 -0
  985. package/dist/ui/data/useRequest.js.map +1 -0
  986. package/dist/ui/data/useRequestScope.js +25 -0
  987. package/dist/ui/data/useRequestScope.js.map +1 -0
  988. package/dist/ui/hooks/useDirection.js +47 -0
  989. package/dist/ui/hooks/useDirection.js.map +1 -0
  990. package/dist/ui/hooks/useDismissOnEscape.js +25 -0
  991. package/dist/ui/hooks/useDismissOnEscape.js.map +1 -0
  992. package/dist/ui/hooks/useLiveAnnouncement.js +57 -0
  993. package/dist/ui/hooks/useLiveAnnouncement.js.map +1 -0
  994. package/dist/ui/hooks/useRealtimePoll.js +112 -0
  995. package/dist/ui/hooks/useRealtimePoll.js.map +1 -0
  996. package/dist/ui/readState.js +19 -0
  997. package/dist/ui/readState.js.map +1 -0
  998. package/dist/ui/rows/toDisplayRows.js +49 -0
  999. package/dist/ui/rows/toDisplayRows.js.map +1 -0
  1000. package/dist/ui/viewerClock.js +7 -0
  1001. package/dist/ui/viewerClock.js.map +1 -0
  1002. package/dist/view/AnalyticsNavLink.d.ts +5 -3
  1003. package/dist/view/AnalyticsNavLink.js +11 -6
  1004. package/dist/view/AnalyticsNavLink.js.map +1 -1
  1005. package/dist/view/AnalyticsView.d.ts +8 -10
  1006. package/dist/view/AnalyticsView.js +47 -18
  1007. package/dist/view/AnalyticsView.js.map +1 -1
  1008. package/dist/view/AnalyticsViewClient.d.ts +4 -7
  1009. package/dist/view/AnalyticsViewClient.js +15 -229
  1010. package/dist/view/AnalyticsViewClient.js.map +1 -1
  1011. package/dist/view/CountryFlag.d.ts +27 -0
  1012. package/dist/view/CountryFlag.js +44 -0
  1013. package/dist/view/CountryFlag.js.map +1 -0
  1014. package/dist/view/DocumentTitle.js +27 -0
  1015. package/dist/view/DocumentTitle.js.map +1 -0
  1016. package/dist/view/ViewRoot.d.ts +21 -0
  1017. package/dist/view/ViewRoot.js +152 -0
  1018. package/dist/view/ViewRoot.js.map +1 -0
  1019. package/dist/view/ViewSections.d.ts +38 -0
  1020. package/dist/view/ViewSections.js +190 -0
  1021. package/dist/view/ViewSections.js.map +1 -0
  1022. package/dist/view/authRedirect.js +2 -4
  1023. package/dist/view/authRedirect.js.map +1 -1
  1024. package/dist/view/conversionRate.js +9 -7
  1025. package/dist/view/conversionRate.js.map +1 -1
  1026. package/dist/view/dayRange.js +6 -10
  1027. package/dist/view/dayRange.js.map +1 -1
  1028. package/dist/view/exclusionLink.d.ts +27 -0
  1029. package/dist/view/exclusionLink.js +46 -0
  1030. package/dist/view/exclusionLink.js.map +1 -0
  1031. package/dist/view/flagSrc.js +14 -0
  1032. package/dist/view/flagSrc.js.map +1 -0
  1033. package/dist/view/gating.d.ts +15 -1
  1034. package/dist/view/gating.js +66 -31
  1035. package/dist/view/gating.js.map +1 -1
  1036. package/dist/view/hostCountryFlag.js +41 -0
  1037. package/dist/view/hostCountryFlag.js.map +1 -0
  1038. package/dist/view/labels.js +95 -10
  1039. package/dist/view/labels.js.map +1 -1
  1040. package/dist/view/metricAliases.js +10 -0
  1041. package/dist/view/metricAliases.js.map +1 -0
  1042. package/dist/view/navLabel.js +15 -0
  1043. package/dist/view/navLabel.js.map +1 -0
  1044. package/dist/view/registerView.js +13 -11
  1045. package/dist/view/registerView.js.map +1 -1
  1046. package/dist/view/scopeLabel.js +21 -0
  1047. package/dist/view/scopeLabel.js.map +1 -0
  1048. package/dist/view/sections/Breakdowns.js +196 -134
  1049. package/dist/view/sections/Breakdowns.js.map +1 -1
  1050. package/dist/view/sections/EmptyStates.js +118 -30
  1051. package/dist/view/sections/EmptyStates.js.map +1 -1
  1052. package/dist/view/sections/ExcludeBrowser.js +188 -0
  1053. package/dist/view/sections/ExcludeBrowser.js.map +1 -0
  1054. package/dist/view/sections/FilterChips.js +124 -27
  1055. package/dist/view/sections/FilterChips.js.map +1 -1
  1056. package/dist/view/sections/GoalsPanel.js +68 -60
  1057. package/dist/view/sections/GoalsPanel.js.map +1 -1
  1058. package/dist/view/sections/OverviewCards.js +29 -33
  1059. package/dist/view/sections/OverviewCards.js.map +1 -1
  1060. package/dist/view/sections/RealtimeStrip.js +70 -59
  1061. package/dist/view/sections/RealtimeStrip.js.map +1 -1
  1062. package/dist/view/sections/SectionBoundary.js +34 -0
  1063. package/dist/view/sections/SectionBoundary.js.map +1 -0
  1064. package/dist/view/sections/Toolbar.d.ts +11 -0
  1065. package/dist/view/sections/Toolbar.js +123 -82
  1066. package/dist/view/sections/Toolbar.js.map +1 -1
  1067. package/dist/view/sections/Trend.js +176 -76
  1068. package/dist/view/sections/Trend.js.map +1 -1
  1069. package/dist/view/state.d.ts +42 -0
  1070. package/dist/view/state.js +93 -54
  1071. package/dist/view/state.js.map +1 -1
  1072. package/dist/view/useViewClock.js +31 -0
  1073. package/dist/view/useViewClock.js.map +1 -0
  1074. package/dist/view/useViewQueries.d.ts +21 -0
  1075. package/dist/view/useViewQueries.js +45 -77
  1076. package/dist/view/useViewQueries.js.map +1 -1
  1077. package/dist/view/useViewState.js +42 -0
  1078. package/dist/view/useViewState.js.map +1 -0
  1079. package/dist/view/useViewUrl.js +47 -0
  1080. package/dist/view/useViewUrl.js.map +1 -0
  1081. package/dist/view/viewBody.js +30 -0
  1082. package/dist/view/viewBody.js.map +1 -0
  1083. package/dist/view/viewContext.d.ts +81 -0
  1084. package/dist/view/viewContext.js +49 -0
  1085. package/dist/view/viewContext.js.map +1 -0
  1086. package/dist/view/viewProps.d.ts +65 -8
  1087. package/dist/view/viewProps.js +123 -36
  1088. package/dist/view/viewProps.js.map +1 -1
  1089. package/dist/widgets/AnalyticsBreakdownWidget.d.ts +7 -3
  1090. package/dist/widgets/AnalyticsBreakdownWidget.js +144 -118
  1091. package/dist/widgets/AnalyticsBreakdownWidget.js.map +1 -1
  1092. package/dist/widgets/AnalyticsGoalsWidget.d.ts +6 -7
  1093. package/dist/widgets/AnalyticsGoalsWidget.js +125 -167
  1094. package/dist/widgets/AnalyticsGoalsWidget.js.map +1 -1
  1095. package/dist/widgets/AnalyticsMetricWidget.d.ts +7 -3
  1096. package/dist/widgets/AnalyticsMetricWidget.js +81 -106
  1097. package/dist/widgets/AnalyticsMetricWidget.js.map +1 -1
  1098. package/dist/widgets/AnalyticsRealtimeWidget.d.ts +7 -3
  1099. package/dist/widgets/AnalyticsRealtimeWidget.js +81 -63
  1100. package/dist/widgets/AnalyticsRealtimeWidget.js.map +1 -1
  1101. package/dist/widgets/AnalyticsTrendWidget.d.ts +7 -3
  1102. package/dist/widgets/AnalyticsTrendWidget.js +130 -123
  1103. package/dist/widgets/AnalyticsTrendWidget.js.map +1 -1
  1104. package/dist/widgets/ComparisonDelta.js +33 -42
  1105. package/dist/widgets/ComparisonDelta.js.map +1 -1
  1106. package/dist/widgets/RealtimeCounter.d.ts +24 -4
  1107. package/dist/widgets/RealtimeCounter.js +91 -77
  1108. package/dist/widgets/RealtimeCounter.js.map +1 -1
  1109. package/dist/widgets/WidgetCard.d.ts +80 -0
  1110. package/dist/widgets/WidgetCard.js +99 -0
  1111. package/dist/widgets/WidgetCard.js.map +1 -0
  1112. package/dist/widgets/WidgetFrame.js +42 -0
  1113. package/dist/widgets/WidgetFrame.js.map +1 -0
  1114. package/dist/widgets/WidgetShimmer.d.ts +55 -0
  1115. package/dist/widgets/WidgetShimmer.js +86 -0
  1116. package/dist/widgets/WidgetShimmer.js.map +1 -0
  1117. package/dist/widgets/breakdownTypes.js +12 -2
  1118. package/dist/widgets/breakdownTypes.js.map +1 -1
  1119. package/dist/widgets/customWidget.d.ts +5 -1
  1120. package/dist/widgets/customWidget.js +6 -7
  1121. package/dist/widgets/customWidget.js.map +1 -1
  1122. package/dist/widgets/defaultLayout.d.ts +26 -0
  1123. package/dist/widgets/defaultLayout.js +51 -0
  1124. package/dist/widgets/defaultLayout.js.map +1 -0
  1125. package/dist/widgets/defaults.d.ts +4 -7
  1126. package/dist/widgets/defaults.js +4 -7
  1127. package/dist/widgets/defaults.js.map +1 -1
  1128. package/dist/widgets/fieldRows.js +14 -0
  1129. package/dist/widgets/fieldRows.js.map +1 -0
  1130. package/dist/widgets/filterCaption.js +6 -7
  1131. package/dist/widgets/filterCaption.js.map +1 -1
  1132. package/dist/widgets/filterField.d.ts +3 -7
  1133. package/dist/widgets/filterField.js +46 -35
  1134. package/dist/widgets/filterField.js.map +1 -1
  1135. package/dist/widgets/filterValueLabel.d.ts +1 -0
  1136. package/dist/widgets/filterValueLabel.js +45 -0
  1137. package/dist/widgets/filterValueLabel.js.map +1 -0
  1138. package/dist/widgets/notices.js +74 -0
  1139. package/dist/widgets/notices.js.map +1 -0
  1140. package/dist/widgets/prepareWidgetRead.d.ts +19 -2
  1141. package/dist/widgets/prepareWidgetRead.js +63 -27
  1142. package/dist/widgets/prepareWidgetRead.js.map +1 -1
  1143. package/dist/widgets/range.js +26 -21
  1144. package/dist/widgets/range.js.map +1 -1
  1145. package/dist/widgets/readForWidget.d.ts +28 -19
  1146. package/dist/widgets/readForWidget.js +33 -29
  1147. package/dist/widgets/readForWidget.js.map +1 -1
  1148. package/dist/widgets/readForWidgetBreakdown.d.ts +40 -29
  1149. package/dist/widgets/readForWidgetBreakdown.js +48 -22
  1150. package/dist/widgets/readForWidgetBreakdown.js.map +1 -1
  1151. package/dist/widgets/readForWidgetGoals.d.ts +18 -24
  1152. package/dist/widgets/readForWidgetGoals.js +52 -46
  1153. package/dist/widgets/readForWidgetGoals.js.map +1 -1
  1154. package/dist/widgets/readForWidgetRealtime.d.ts +22 -17
  1155. package/dist/widgets/readForWidgetRealtime.js +54 -28
  1156. package/dist/widgets/readForWidgetRealtime.js.map +1 -1
  1157. package/dist/widgets/readForWidgetSeries.d.ts +27 -32
  1158. package/dist/widgets/readForWidgetSeries.js +45 -82
  1159. package/dist/widgets/readForWidgetSeries.js.map +1 -1
  1160. package/dist/widgets/readMeta.d.ts +44 -0
  1161. package/dist/widgets/readMeta.js +47 -4
  1162. package/dist/widgets/readMeta.js.map +1 -1
  1163. package/dist/widgets/realtimePoll.d.ts +1 -0
  1164. package/dist/widgets/realtimePoll.js +53 -25
  1165. package/dist/widgets/realtimePoll.js.map +1 -1
  1166. package/dist/widgets/registerWidgets.js +207 -127
  1167. package/dist/widgets/registerWidgets.js.map +1 -1
  1168. package/dist/widgets/stateKeys.js +30 -0
  1169. package/dist/widgets/stateKeys.js.map +1 -0
  1170. package/dist/widgets/titleForecast.js +89 -0
  1171. package/dist/widgets/titleForecast.js.map +1 -0
  1172. package/dist/widgets/types.d.ts +4 -3
  1173. package/dist/widgets/types.js +2 -0
  1174. package/dist/widgets/types.js.map +1 -1
  1175. package/dist/widgets/viewLink.d.ts +24 -6
  1176. package/dist/widgets/viewLink.js +31 -24
  1177. package/dist/widgets/viewLink.js.map +1 -1
  1178. package/dist/widgets/widgetData.js +34 -0
  1179. package/dist/widgets/widgetData.js.map +1 -0
  1180. package/dist/widgets/widgetWindow.d.ts +1 -0
  1181. package/dist/widgets/widgetWindow.js +51 -0
  1182. package/dist/widgets/widgetWindow.js.map +1 -0
  1183. package/package.json +44 -22
  1184. package/dist/adapters/ga4/disableKey.d.ts +0 -9
  1185. package/dist/capture/getTrackerConfig.d.ts +0 -20
  1186. package/dist/capture/getTrackerConfig.js +0 -31
  1187. package/dist/capture/getTrackerConfig.js.map +0 -1
  1188. package/dist/capture/slots.d.ts +0 -8
  1189. package/dist/capture/trackerConfig.d.ts +0 -33
  1190. package/dist/charts/styles.js +0 -59
  1191. package/dist/charts/styles.js.map +0 -1
  1192. package/dist/fields/config/SourceSelectField.d.ts +0 -14
  1193. package/dist/fields/dateRange/styles.js +0 -23
  1194. package/dist/fields/dateRange/styles.js.map +0 -1
  1195. package/dist/goals/GoalSelectField.d.ts +0 -7
  1196. package/dist/native/collections/events.js +0 -165
  1197. package/dist/native/collections/events.js.map +0 -1
  1198. package/dist/native/collections/rollups.js +0 -151
  1199. package/dist/native/collections/rollups.js.map +0 -1
  1200. package/dist/native/collections/seen.js +0 -47
  1201. package/dist/native/collections/seen.js.map +0 -1
  1202. package/dist/native/eventScan.js +0 -25
  1203. package/dist/native/eventScan.js.map +0 -1
  1204. package/dist/native/ingest/flushBatch.js +0 -60
  1205. package/dist/native/ingest/flushBatch.js.map +0 -1
  1206. package/dist/native/ingest/salt.js +0 -39
  1207. package/dist/native/ingest/salt.js.map +0 -1
  1208. package/dist/native/ingest/writeBuffer.js +0 -55
  1209. package/dist/native/ingest/writeBuffer.js.map +0 -1
  1210. package/dist/native/ingest/writeEvent.js +0 -14
  1211. package/dist/native/ingest/writeEvent.js.map +0 -1
  1212. package/dist/native/query/eventAgg.js +0 -175
  1213. package/dist/native/query/eventAgg.js.map +0 -1
  1214. package/dist/native/realtime/buildRealtime.js +0 -53
  1215. package/dist/native/realtime/buildRealtime.js.map +0 -1
  1216. package/dist/native/retention/pruneTask.js +0 -69
  1217. package/dist/native/retention/pruneTask.js.map +0 -1
  1218. package/dist/native/rollupAcc.js +0 -64
  1219. package/dist/native/rollupAcc.js.map +0 -1
  1220. package/dist/native/rollups/bucketKey.js +0 -15
  1221. package/dist/native/rollups/bucketKey.js.map +0 -1
  1222. package/dist/native/rollups/bumpRollups.js +0 -116
  1223. package/dist/native/rollups/bumpRollups.js.map +0 -1
  1224. package/dist/native/rollups/deltas.js +0 -106
  1225. package/dist/native/rollups/deltas.js.map +0 -1
  1226. package/dist/native/rollups/insertManyIfNew.js +0 -93
  1227. package/dist/native/rollups/insertManyIfNew.js.map +0 -1
  1228. package/dist/plugin/paths.js +0 -29
  1229. package/dist/plugin/paths.js.map +0 -1
  1230. package/dist/react/TrackerBoot.d.ts +0 -22
  1231. package/dist/rsc/AnalyticsScripts.d.ts +0 -30
  1232. package/dist/rsc/AnalyticsScripts.js +0 -41
  1233. package/dist/rsc/AnalyticsScripts.js.map +0 -1
  1234. package/dist/surfacing/queue.js +0 -60
  1235. package/dist/surfacing/queue.js.map +0 -1
  1236. package/dist/surfacing/retryPolicy.js +0 -15
  1237. package/dist/surfacing/retryPolicy.js.map +0 -1
  1238. package/dist/tracker/autoCapture.d.ts +0 -48
  1239. package/dist/tracker/consent.d.ts +0 -24
  1240. package/dist/tracker/consent.js +0 -48
  1241. package/dist/tracker/consent.js.map +0 -1
  1242. package/dist/tracker/loadScript.d.ts +0 -14
  1243. package/dist/tracker/pageTracking.d.ts +0 -17
  1244. package/dist/tracker/registry.d.ts +0 -27
  1245. package/dist/tracker/sinks/ga4.d.ts +0 -29
  1246. package/dist/tracker/sinks/native.d.ts +0 -22
  1247. package/dist/tracker/sinks/plausible.d.ts +0 -20
  1248. package/dist/tracker/sinks/posthog.d.ts +0 -18
  1249. package/dist/tracker/sinks/umami.d.ts +0 -18
  1250. package/dist/tracker/sinks/vendor.d.ts +0 -14
  1251. package/dist/view/sections/styles.js +0 -76
  1252. package/dist/view/sections/styles.js.map +0 -1
  1253. package/dist/widgets/WidgetViewLink.js +0 -17
  1254. package/dist/widgets/WidgetViewLink.js.map +0 -1
  1255. package/dist/widgets/cardChrome.d.ts +0 -8
  1256. package/dist/widgets/cardChrome.js +0 -46
  1257. package/dist/widgets/cardChrome.js.map +0 -1
  1258. package/dist/widgets/comparison.js +0 -57
  1259. package/dist/widgets/comparison.js.map +0 -1
@@ -1,51 +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
  };
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)));
16
22
  /**
17
- * The goal segment, absent for a read with no hint and for an install with no goals, which
18
- * both ask the provider for the same rows. The failed-resolver segment carries a `!`, which
19
- * `GOAL_SLUG_PATTERN` forbids, so no list of slugs can be written to look like it.
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.
20
25
  */
21
- const goalKey = (goalSlugs) => {
22
- if (goalSlugs === "unresolved") return ["goals:!unresolved"];
23
- return goalSlugs?.length ? [`goals:${stable(goalSlugs)}`] : [];
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
+ };
24
38
  };
25
- function buildCacheKey(provider, q, opts = {}) {
26
- const pathKey = q.path ?? "site";
27
- const tz = q.timezone ?? "UTC";
28
- const range = rangeKey(q.dateRange, tz);
29
- const filters = (q.filters ?? []).map((f) => `${f.dimension}${f.operator}${f.value}`).sort().join(";");
30
- return [
31
- "analytics",
32
- `e${opts.epoch ?? "0"}`,
33
- provider,
34
- q.hostname ?? "_",
35
- pathKey,
36
- stable(q.metrics),
37
- stable(q.dimensions),
38
- range,
39
- q.granularity ?? "_",
40
- filters,
41
- String(q.limit ?? "_"),
42
- q.order ? `${q.order.metric}:${q.order.direction}` : "_",
43
- ...q.timezone !== void 0 && q.timezone !== "UTC" ? [q.timezone] : [],
44
- ...q.scope !== void 0 ? [encodeURIComponent(q.scope)] : [],
45
- ...goalKey(q.goalSlugs)
46
- ].join("|");
47
- }
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
+ });
48
59
  //#endregion
49
- export { buildCacheKey };
60
+ export { buildCacheKey, buildRealtimeKey };
50
61
 
51
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\n/**\n * The goal segment, absent for a read with no hint and for an install with no goals, which\n * both ask the provider for the same rows. The failed-resolver segment carries a `!`, which\n * `GOAL_SLUG_PATTERN` forbids, so no list of slugs can be written to look like it.\n */\nconst goalKey = (goalSlugs: AnalyticsQuery['goalSlugs']): string[] => {\n\tif (goalSlugs === 'unresolved') {\n\t\treturn ['goals:!unresolved']\n\t}\n\treturn goalSlugs?.length ? [`goals:${stable(goalSlugs)}`] : []\n}\n\nexport interface CacheKeyOptions {\n\t/** The scope's cache epoch token; bumping it retires every entry keyed on the old one. */\n\tepoch?: string\n}\n\nexport function buildCacheKey(\n\tprovider: string,\n\tq: AnalyticsQuery,\n\topts: CacheKeyOptions = {}\n): 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\t// Fixed second segment, always written, so there is one key format rather than two;\n\t\t// its position keeps an adapter id spelled like an epoch from ever colliding with one.\n\t\t`e${opts.epoch ?? '0'}`,\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\t// A provider read restricts its goal rows to the hint, so two hints answer differently\n\t\t// and must never share an entry. A failed resolver keys on its own segment rather than\n\t\t// on the healthy no-hint key. Prefixed, so the segment cannot read as a scope.\n\t\t...goalKey(q.goalSlugs),\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;;;;;;AAOA,MAAM,WAAW,cAAqD;CACrE,IAAI,cAAc,cACjB,OAAO,CAAC,mBAAmB;CAE5B,OAAO,WAAW,SAAS,CAAC,SAAS,OAAO,SAAS,GAAG,IAAI,CAAC;AAC9D;AAOA,SAAgB,cACf,UACA,GACA,OAAwB,CAAC,GAChB;CACT,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;EAGA,IAAI,KAAK,SAAS;EAClB;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;EAI7D,GAAG,QAAQ,EAAE,SAAS;CACvB,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,31 +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
71
  /**
12
72
  * Whether a source compares against its previous period. The engine does that read
13
73
  * generically, so it is on unless an adapter opted out.
14
74
  */
15
75
  const comparisonOf = (caps) => caps.comparison ?? true;
16
- const serializeCapabilities = (caps) => ({
17
- metrics: [...caps.metrics],
18
- dimensions: [...caps.dimensions],
19
- filters: [...caps.filters],
20
- filterOperators: [...caps.filterOperators],
21
- realtime: caps.realtime,
22
- ...caps.realtimeWindowMinutes !== void 0 ? { realtimeWindowMinutes: caps.realtimeWindowMinutes } : {},
23
- perPageQuery: caps.perPageQuery,
24
- comparison: comparisonOf(caps),
25
- minGranularity: caps.minGranularity,
26
- maxLookbackDays: caps.maxLookbackDays
27
- });
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
+ };
28
107
  //#endregion
29
- export { comparisonOf, satisfiesCapabilities, serializeCapabilities };
108
+ export { assertRequirementKeys, comparisonOf, filterOperatorsFor, filterableDimensions, meetsFilter, metricOutOfReach, metricReaches, metricsReach, satisfiesCapabilities, serializeCapabilities, supportsFilter, unsupportedFilter };
30
109
 
31
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/**\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/** 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: comparisonOf(caps),\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;;;;;AAMA,MAAa,gBAAgB,SAAyC,KAAK,cAAc;AAgBzF,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,aAAa,IAAI;CAC7B,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,52 @@
1
+ import { CaptureSnippet, TrackerSlotConfig } 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;
27
- }
28
- interface CaptureSnippet {
29
- scripts: SnippetScript[];
30
- }
31
- type CaptureClientKind = 'native' | 'posthog' | 'plausible' | 'umami' | 'ga4';
32
32
  /**
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.
33
+ * How a vendor's browser tracker is proxied and booted. Carries only what the browser may see,
34
+ * never a secret credential such as PostHog's Query API key.
37
35
  */
38
36
  interface CaptureSupport {
39
37
  proxy: ProxyDescriptor;
38
+ /**
39
+ * `scope` is the request's resolved scope, which a vendor able to carry it stamps on every event.
40
+ * Null when unscoped or unresolved. `instance` names the client the snippet initialises, set
41
+ * only for a vendor that runs a second client beside the other slot's (PostHog).
42
+ */
40
43
  snippet(args: {
41
44
  path: string;
45
+ scope?: string | null;
46
+ instance?: string;
42
47
  }): CaptureSnippet;
43
- client: {
44
- kind: CaptureClientKind;
45
- } & Record<string, string | number | boolean>;
48
+ client: TrackerSlotConfig['client'];
46
49
  }
47
50
  //#endregion
48
- export { CaptureClientKind, CaptureSnippet, CaptureSupport, ProxyDescriptor, ProxyRoute, SnippetScript };
51
+ export { CaptureSupport, ProxyDescriptor, ProxyRoute, ProxyRouteKind };
49
52
  //# sourceMappingURL=capture.d.ts.map
@@ -0,0 +1 @@
1
+ export { };