@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 +1 @@
1
- {"version":3,"file":"parse.js","names":[],"sources":["../../src/query/parse.ts"],"sourcesContent":["import type { SerializedCapabilities } from '../core/capabilities'\nimport {\n\ttype AnalyticsFilter,\n\ttype AnalyticsQuery,\n\tDIMENSION_KEYS,\n\ttype DimensionKey,\n\tFILTER_OPERATORS,\n\ttype FilterOperator,\n\ttype Granularity,\n\ttype MetricKey,\n} from '../core/contract'\nimport { GRANULARITY_ORDER } from '../core/granularity'\nimport { type AnalyticsError, analyticsError } from '../plugin/errors'\nimport { isValidTimeZone } from '../timeframe/tz'\nimport { METRIC_KEYS } from '../translations/metricKeys'\nimport { parseDayOrInstant } from './dates'\nimport {\n\tDEFAULT_QUERY_LIMIT,\n\tMAX_QUERY_DIMENSIONS,\n\tMAX_QUERY_FILTER_VALUE_LENGTH,\n\tMAX_QUERY_FILTERS,\n\tMAX_QUERY_HOSTNAME_LENGTH,\n\tMAX_QUERY_LIMIT,\n\tMAX_QUERY_METRICS,\n\tMAX_QUERY_PATH_LENGTH,\n\tMAX_QUERY_RANGE_DAYS,\n\tMIN_QUERY_LIMIT,\n} from './limits'\n\n/**\n * A validated read request. `source` and `scope` are absent by design: the handler must\n * resolve both before the parser can run, and reads them itself through {@link readParam}.\n */\nexport interface ParsedQuery {\n\tquery: AnalyticsQuery\n\tcompare: 'previous' | null\n}\n\nexport type ParseResult = { ok: true; value: ParsedQuery } | { ok: false; error: AnalyticsError }\n\nexport interface ParseQueryArgs {\n\tcapabilities: SerializedCapabilities\n\t/** Reporting timezone the plugin resolved for this request; the `timezone` param overrides it. */\n\ttimezone: string\n}\n\nconst KNOWN_METRICS = new Set<string>(Object.keys(METRIC_KEYS))\nconst KNOWN_DIMENSIONS = new Set<string>(DIMENSION_KEYS)\nconst KNOWN_OPERATORS = new Set<string>(FILTER_OPERATORS)\nconst KNOWN_GRANULARITIES = new Set<string>(GRANULARITY_ORDER)\nconst DAY_MS = 86_400_000\n\nconst fail = (code: AnalyticsError['code'], message: string, param: string): ParseResult => ({\n\tok: false,\n\terror: analyticsError(code, message, param),\n})\n\n/** Echo a rejected value back in a message without letting a caller inflate the response. */\nconst echo = (value: string): string => (value.length > 40 ? `${value.slice(0, 40)}...` : value)\n\n/**\n * A trimmed non-empty parameter, or null when absent or blank. Exported so the handler\n * reads `source` and `scope` (which it must resolve before the parser can run) exactly\n * the way the parser reads everything else.\n */\nexport const readParam = (params: URLSearchParams, name: string): string | null => {\n\tconst raw = params.get(name)?.trim()\n\treturn raw ? raw : null\n}\n\nconst commaList = (raw: string): string[] =>\n\traw\n\t\t.split(',')\n\t\t.map((part) => part.trim())\n\t\t.filter((part) => part.length > 0)\n\nconst dedupe = <T extends string>(values: T[]): T[] => [...new Set(values)]\n\nconst isRecord = (value: unknown): value is Record<string, unknown> =>\n\ttypeof value === 'object' && value !== null && !Array.isArray(value)\n\nconst parseFilters = (\n\traw: string,\n\tcapabilities: SerializedCapabilities\n): AnalyticsFilter[] | ParseResult => {\n\tlet decoded: unknown\n\ttry {\n\t\tdecoded = JSON.parse(raw)\n\t} catch {\n\t\treturn fail('invalid_param', 'filters must be a JSON array', 'filters')\n\t}\n\tif (!Array.isArray(decoded)) {\n\t\treturn fail('invalid_param', 'filters must be a JSON array', 'filters')\n\t}\n\tif (decoded.length > MAX_QUERY_FILTERS) {\n\t\treturn fail('invalid_param', `at most ${MAX_QUERY_FILTERS} filters are allowed`, 'filters')\n\t}\n\tconst filterable = new Set<string>(capabilities.filters)\n\tconst operators = new Set<string>(capabilities.filterOperators)\n\tconst parsed: AnalyticsFilter[] = []\n\tfor (const item of decoded) {\n\t\tif (!isRecord(item)) {\n\t\t\treturn fail('invalid_param', 'each filter must be an object', 'filters')\n\t\t}\n\t\tconst { dimension, operator, value } = item\n\t\tif (typeof dimension !== 'string' || !KNOWN_DIMENSIONS.has(dimension)) {\n\t\t\treturn fail(\n\t\t\t\t'invalid_param',\n\t\t\t\t`unknown filter dimension: ${echo(String(dimension))}`,\n\t\t\t\t'filters'\n\t\t\t)\n\t\t}\n\t\tif (typeof operator !== 'string' || !KNOWN_OPERATORS.has(operator)) {\n\t\t\treturn fail('invalid_param', `unknown filter operator: ${echo(String(operator))}`, 'filters')\n\t\t}\n\t\tif (typeof value !== 'string') {\n\t\t\treturn fail('invalid_param', 'each filter value must be a string', 'filters')\n\t\t}\n\t\tconst trimmed = value.trim()\n\t\tif (trimmed.length < 1 || trimmed.length > MAX_QUERY_FILTER_VALUE_LENGTH) {\n\t\t\treturn fail(\n\t\t\t\t'invalid_param',\n\t\t\t\t`each filter value must be 1 to ${MAX_QUERY_FILTER_VALUE_LENGTH} characters`,\n\t\t\t\t'filters'\n\t\t\t)\n\t\t}\n\t\tif (!filterable.has(dimension)) {\n\t\t\treturn fail('unsupported_filter', `source cannot filter on ${dimension}`, 'filters')\n\t\t}\n\t\tif (!operators.has(operator)) {\n\t\t\treturn fail('unsupported_operator', `source does not support ${operator}`, 'filters')\n\t\t}\n\t\tparsed.push({\n\t\t\tdimension: dimension as DimensionKey,\n\t\t\toperator: operator as FilterOperator,\n\t\t\tvalue: trimmed,\n\t\t})\n\t}\n\treturn parsed\n}\n\n/**\n * Validate a query string against a source's serialized capabilities. Rules are evaluated\n * in a fixed order and the first failure wins: timezone, metrics, dimensions, from/to,\n * granularity, filters, limit, order, compare, path, hostname. Within each, a value\n * outside the contract's own union is `invalid_param` and a contract value the source\n * lacks is its `unsupported_*` code. Unknown parameters are ignored; `source` and `scope`\n * pass through unvalidated, since only the handler knows whether they are trusted.\n */\nexport const parseQueryParams = (params: URLSearchParams, args: ParseQueryArgs): ParseResult => {\n\tconst rawTimezone = readParam(params, 'timezone')\n\tif (rawTimezone !== null && !isValidTimeZone(rawTimezone)) {\n\t\treturn fail('invalid_param', `unknown timezone: ${echo(rawTimezone)}`, 'timezone')\n\t}\n\tconst timezone = rawTimezone ?? args.timezone\n\n\tconst rawMetrics = readParam(params, 'metrics')\n\tconst metricList = rawMetrics ? commaList(rawMetrics) : []\n\tif (metricList.length === 0) {\n\t\treturn fail('invalid_param', 'metrics is required', 'metrics')\n\t}\n\tconst unknownMetric = metricList.find((m) => !KNOWN_METRICS.has(m))\n\tif (unknownMetric !== undefined) {\n\t\treturn fail('invalid_param', `unknown metric: ${echo(unknownMetric)}`, 'metrics')\n\t}\n\tconst metrics = dedupe(metricList) as MetricKey[]\n\tif (metrics.length > MAX_QUERY_METRICS) {\n\t\treturn fail('invalid_param', `at most ${MAX_QUERY_METRICS} metrics are allowed`, 'metrics')\n\t}\n\tconst servedMetrics = new Set<string>(args.capabilities.metrics)\n\tconst unsupportedMetric = metrics.find((m) => !servedMetrics.has(m))\n\tif (unsupportedMetric !== undefined) {\n\t\treturn fail('unsupported_metric', `source does not serve ${unsupportedMetric}`, 'metrics')\n\t}\n\n\tconst rawDimensions = readParam(params, 'dimensions')\n\tconst dimensionList = rawDimensions ? commaList(rawDimensions) : []\n\tconst unknownDimension = dimensionList.find((d) => !KNOWN_DIMENSIONS.has(d))\n\tif (unknownDimension !== undefined) {\n\t\treturn fail('invalid_param', `unknown dimension: ${echo(unknownDimension)}`, 'dimensions')\n\t}\n\tconst dimensions = dedupe(dimensionList) as DimensionKey[]\n\tif (dimensions.length > MAX_QUERY_DIMENSIONS) {\n\t\treturn fail(\n\t\t\t'invalid_param',\n\t\t\t`at most ${MAX_QUERY_DIMENSIONS} dimensions are allowed`,\n\t\t\t'dimensions'\n\t\t)\n\t}\n\tconst servedDimensions = new Set<string>(args.capabilities.dimensions)\n\tconst unsupportedDimension = dimensions.find((d) => !servedDimensions.has(d))\n\tif (unsupportedDimension !== undefined) {\n\t\treturn fail(\n\t\t\t'unsupported_dimension',\n\t\t\t`source does not break down by ${unsupportedDimension}`,\n\t\t\t'dimensions'\n\t\t)\n\t}\n\n\tconst rawFrom = readParam(params, 'from')\n\tconst rawTo = readParam(params, 'to')\n\tif (!rawFrom) {\n\t\treturn fail('invalid_param', 'from is required', 'from')\n\t}\n\tconst start = parseDayOrInstant(rawFrom, { timezone, edge: 'start' })\n\tif (!start) {\n\t\treturn fail('invalid_param', `from is not a date: ${echo(rawFrom)}`, 'from')\n\t}\n\tif (!rawTo) {\n\t\treturn fail('invalid_param', 'to is required', 'to')\n\t}\n\tconst end = parseDayOrInstant(rawTo, { timezone, edge: 'end' })\n\tif (!end) {\n\t\treturn fail('invalid_param', `to is not a date: ${echo(rawTo)}`, 'to')\n\t}\n\tif (end.getTime() < start.getTime()) {\n\t\treturn fail('invalid_param', 'to must not be before from', 'to')\n\t}\n\tif (end.getTime() - start.getTime() > MAX_QUERY_RANGE_DAYS * DAY_MS) {\n\t\treturn fail('range_too_long', `the range must not exceed ${MAX_QUERY_RANGE_DAYS} days`, 'to')\n\t}\n\n\tconst rawGranularity = readParam(params, 'granularity')\n\tif (rawGranularity !== null && !KNOWN_GRANULARITIES.has(rawGranularity)) {\n\t\treturn fail('invalid_param', `unknown granularity: ${echo(rawGranularity)}`, 'granularity')\n\t}\n\tconst granularity = rawGranularity as Granularity | null\n\tif (\n\t\tgranularity !== null &&\n\t\tGRANULARITY_ORDER.indexOf(granularity) <\n\t\t\tGRANULARITY_ORDER.indexOf(args.capabilities.minGranularity)\n\t) {\n\t\treturn fail(\n\t\t\t'unsupported_granularity',\n\t\t\t`source buckets no finer than ${args.capabilities.minGranularity}`,\n\t\t\t'granularity'\n\t\t)\n\t}\n\n\tconst rawFilters = readParam(params, 'filters')\n\tconst filters = rawFilters === null ? [] : parseFilters(rawFilters, args.capabilities)\n\tif (!Array.isArray(filters)) {\n\t\treturn filters\n\t}\n\n\tconst rawLimit = readParam(params, 'limit')\n\tlet limit = DEFAULT_QUERY_LIMIT\n\tif (rawLimit !== null) {\n\t\tif (!/^\\d+$/.test(rawLimit)) {\n\t\t\treturn fail('invalid_param', `limit must be an integer: ${echo(rawLimit)}`, 'limit')\n\t\t}\n\t\tlimit = Number(rawLimit)\n\t\tif (limit < MIN_QUERY_LIMIT || limit > MAX_QUERY_LIMIT) {\n\t\t\treturn fail(\n\t\t\t\t'invalid_param',\n\t\t\t\t`limit must be between ${MIN_QUERY_LIMIT} and ${MAX_QUERY_LIMIT}`,\n\t\t\t\t'limit'\n\t\t\t)\n\t\t}\n\t}\n\n\tconst rawOrder = readParam(params, 'order')\n\tlet order: AnalyticsQuery['order']\n\tif (rawOrder !== null) {\n\t\tconst parts = rawOrder.split(':')\n\t\tconst metric = parts[0] ?? ''\n\t\tconst direction = parts[1] ?? ''\n\t\tif (parts.length !== 2 || (direction !== 'asc' && direction !== 'desc')) {\n\t\t\treturn fail('invalid_param', 'order must be <metric>:<asc|desc>', 'order')\n\t\t}\n\t\tconst ordered = metrics.find((m) => m === metric)\n\t\tif (ordered === undefined) {\n\t\t\treturn fail('invalid_param', `order metric is not in metrics: ${echo(metric)}`, 'order')\n\t\t}\n\t\torder = { metric: ordered, direction }\n\t}\n\n\tconst rawCompare = readParam(params, 'compare')\n\tif (rawCompare !== null && rawCompare !== 'previous') {\n\t\treturn fail('invalid_param', `compare must be \"previous\": ${echo(rawCompare)}`, 'compare')\n\t}\n\tif (rawCompare === 'previous' && !args.capabilities.comparison) {\n\t\treturn fail('invalid_param', 'source does not support comparison', 'compare')\n\t}\n\n\tconst path = readParam(params, 'path')\n\tif (path !== null && path.length > MAX_QUERY_PATH_LENGTH) {\n\t\treturn fail('invalid_param', `path must be at most ${MAX_QUERY_PATH_LENGTH} characters`, 'path')\n\t}\n\tconst hostname = readParam(params, 'hostname')\n\tif (hostname !== null && hostname.length > MAX_QUERY_HOSTNAME_LENGTH) {\n\t\treturn fail(\n\t\t\t'invalid_param',\n\t\t\t`hostname must be at most ${MAX_QUERY_HOSTNAME_LENGTH} characters`,\n\t\t\t'hostname'\n\t\t)\n\t}\n\n\tconst query: AnalyticsQuery = {\n\t\tmetrics,\n\t\tdateRange: { start, end },\n\t\tlimit,\n\t\ttimezone,\n\t\t...(dimensions.length > 0 ? { dimensions } : {}),\n\t\t...(granularity !== null ? { granularity } : {}),\n\t\t...(filters.length > 0 ? { filters } : {}),\n\t\t...(order ? { order } : {}),\n\t\t...(path !== null ? { path } : {}),\n\t\t...(hostname !== null ? { hostname } : {}),\n\t}\n\treturn {\n\t\tok: true,\n\t\tvalue: { query, compare: rawCompare === 'previous' ? 'previous' : null },\n\t}\n}\n"],"mappings":"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"}
1
+ {"version":3,"file":"parse.js","names":[],"sources":["../../src/query/parse.ts"],"sourcesContent":["import {\n\tfilterOperatorsFor,\n\tmetricOutOfReach,\n\ttype SerializedCapabilities,\n} from '../core/capabilities'\nimport type {\n\tAnalyticsFilter,\n\tAnalyticsQuery,\n\tDateRange,\n\tDimensionKey,\n\tGranularity,\n\tMetricKey,\n} from '../core/contract'\nimport { supportsGranularity } from '../core/granularity'\nimport { isDimensionKey, isFilterOperator, isGranularity, isMetricKey } from '../core/guards'\nimport { servedName } from '../core/metricAliases'\nimport { isOneOf, isRecord } from '../core/values'\nimport { parseItemRef } from '../items/ref'\nimport { type AnalyticsError, analyticsError } from '../plugin/errors'\nimport { isTimeframePreset, TIMEFRAME_PRESETS, type TimeframePreset } from '../timeframe/presets'\nimport { isValidTimeZone } from '../timeframe/tz'\nimport { parseDayOrInstant } from './dates'\nimport {\n\tDEFAULT_QUERY_LIMIT,\n\texceedsRangeCap,\n\tMAX_QUERY_DIMENSIONS,\n\tMAX_QUERY_FILTER_VALUE_LENGTH,\n\tMAX_QUERY_FILTERS,\n\tMAX_QUERY_HOSTNAME_LENGTH,\n\tMAX_QUERY_LIMIT,\n\tMAX_QUERY_METRICS,\n\tMAX_QUERY_PATH_LENGTH,\n\tMAX_QUERY_RANGE_DAYS,\n\tMIN_QUERY_LIMIT,\n} from './limits'\n\n/**\n * A validated read request. `source` and `scope` are absent by design: the handler must\n * resolve both before the parser can run, and reads them itself through {@link readParam}.\n */\nexport interface ParsedQuery {\n\tquery: AnalyticsQuery\n\tcompare: 'previous' | null\n\t/**\n\t * The named timeframe the caller resolved `from` and `to` from, which lets the read be stored\n\t * for the warm task to repeat; null when the caller named none.\n\t */\n\ttimeframe: TimeframePreset | null\n}\n\nexport type ParseResult = { ok: true; value: ParsedQuery } | { ok: false; error: AnalyticsError }\n\ninterface ParseQueryArgs {\n\tcapabilities: SerializedCapabilities\n\t/** Reporting timezone the plugin resolved for this request; the `timezone` param overrides it. */\n\ttimezone: string\n}\n\ntype Failure = Extract<ParseResult, { ok: false }>\n\n/** One parameter's parsed value, or the failure that ends the parse. */\ntype Parsed<T> = { ok: true; value: T } | Failure\n\nconst parsed = <T>(value: T): Parsed<T> => ({ ok: true, value })\n\nconst fail = (code: AnalyticsError['code'], message: string, param: string): Failure => ({\n\tok: false,\n\terror: analyticsError(code, message, param),\n})\n\n/** Echo a rejected value back in a message without letting a caller inflate the response. */\nconst echo = (value: string): string => (value.length > 40 ? `${value.slice(0, 40)}...` : value)\n\n/**\n * A trimmed non-empty parameter, or null. Exported so the handler reads `source` and `scope`\n * exactly as the parser reads everything else.\n */\nexport const readParam = (params: URLSearchParams, name: string): string | null => {\n\tconst raw = params.get(name)?.trim()\n\treturn raw ? raw : null\n}\n\nconst commaList = (raw: string): string[] =>\n\traw\n\t\t.split(',')\n\t\t.map((part) => part.trim())\n\t\t.filter((part) => part.length > 0)\n\nconst dedupe = <T extends string>(values: T[]): T[] => [...new Set(values)]\n\n/**\n * Dimension list as the query parser reads it, for callers outside the query endpoint (document\n * panel). Unknown names are dropped, not refused: the caller wants blocks to draw, not an error.\n */\nexport const readDimensionList = (\n\traw: string | null,\n\tmax: number = MAX_QUERY_DIMENSIONS\n): DimensionKey[] => dedupe(commaList(raw ?? '').filter(isDimensionKey)).slice(0, max)\n\nconst parseMetrics = (\n\tparams: URLSearchParams,\n\tcapabilities: SerializedCapabilities\n): Parsed<MetricKey[]> => {\n\tconst listed = commaList(readParam(params, 'metrics') ?? '')\n\tif (listed.length === 0) {\n\t\treturn fail('invalid_param', 'metrics is required', 'metrics')\n\t}\n\tconst unknown = listed.find((m) => !isMetricKey(m))\n\tif (unknown !== undefined) {\n\t\treturn fail('invalid_param', `unknown metric: ${echo(unknown)}`, 'metrics')\n\t}\n\tconst metrics = dedupe(listed.filter(isMetricKey))\n\tif (metrics.length > MAX_QUERY_METRICS) {\n\t\treturn fail('invalid_param', `at most ${MAX_QUERY_METRICS} metrics are allowed`, 'metrics')\n\t}\n\t// A source serving one of `visits` and `sessions` answers the other under the name asked for.\n\tconst unsupported = metrics.find(\n\t\t(m) => !capabilities.metrics.includes(servedName(m, capabilities.metrics))\n\t)\n\tif (unsupported !== undefined) {\n\t\treturn fail('unsupported_metric', `source does not serve ${unsupported}`, 'metrics')\n\t}\n\treturn parsed(metrics)\n}\n\nconst parseDimensions = (\n\tparams: URLSearchParams,\n\tcapabilities: SerializedCapabilities\n): Parsed<DimensionKey[]> => {\n\tconst listed = commaList(readParam(params, 'dimensions') ?? '')\n\tconst unknown = listed.find((d) => !isDimensionKey(d))\n\tif (unknown !== undefined) {\n\t\treturn fail('invalid_param', `unknown dimension: ${echo(unknown)}`, 'dimensions')\n\t}\n\tconst dimensions = dedupe(listed.filter(isDimensionKey))\n\tif (dimensions.length > MAX_QUERY_DIMENSIONS) {\n\t\treturn fail(\n\t\t\t'invalid_param',\n\t\t\t`at most ${MAX_QUERY_DIMENSIONS} dimensions are allowed`,\n\t\t\t'dimensions'\n\t\t)\n\t}\n\tconst unsupported = dimensions.find((d) => !capabilities.dimensions.includes(d))\n\tif (unsupported !== undefined) {\n\t\treturn fail(\n\t\t\t'unsupported_dimension',\n\t\t\t`source does not break down by ${unsupported}`,\n\t\t\t'dimensions'\n\t\t)\n\t}\n\treturn parsed(dimensions)\n}\n\nconst parseRange = (params: URLSearchParams, timezone: string): Parsed<DateRange> => {\n\tconst rawFrom = readParam(params, 'from')\n\tconst rawTo = readParam(params, 'to')\n\tif (!rawFrom) {\n\t\treturn fail('invalid_param', 'from is required', 'from')\n\t}\n\tconst start = parseDayOrInstant(rawFrom, { timezone, edge: 'start' })\n\tif (!start) {\n\t\treturn fail('invalid_param', `from is not a date: ${echo(rawFrom)}`, 'from')\n\t}\n\tif (!rawTo) {\n\t\treturn fail('invalid_param', 'to is required', 'to')\n\t}\n\tconst end = parseDayOrInstant(rawTo, { timezone, edge: 'end' })\n\tif (!end) {\n\t\treturn fail('invalid_param', `to is not a date: ${echo(rawTo)}`, 'to')\n\t}\n\tif (end.getTime() < start.getTime()) {\n\t\treturn fail('invalid_param', 'to must not be before from', 'to')\n\t}\n\tif (exceedsRangeCap({ start, end })) {\n\t\treturn fail('range_too_long', `the range must not exceed ${MAX_QUERY_RANGE_DAYS} days`, 'to')\n\t}\n\treturn parsed({ start, end })\n}\n\nconst parseGranularity = (\n\tparams: URLSearchParams,\n\tcapabilities: SerializedCapabilities\n): Parsed<Granularity | null> => {\n\tconst raw = readParam(params, 'granularity')\n\tif (raw === null) {\n\t\treturn parsed(null)\n\t}\n\tif (!isGranularity(raw)) {\n\t\treturn fail('invalid_param', `unknown granularity: ${echo(raw)}`, 'granularity')\n\t}\n\tif (!supportsGranularity(capabilities, raw)) {\n\t\treturn fail(\n\t\t\t'unsupported_granularity',\n\t\t\t`source buckets no finer than ${capabilities.minGranularity}`,\n\t\t\t'granularity'\n\t\t)\n\t}\n\treturn parsed(raw)\n}\n\nconst parseFilters = (\n\tparams: URLSearchParams,\n\tcapabilities: SerializedCapabilities\n): Parsed<AnalyticsFilter[]> => {\n\tconst raw = readParam(params, 'filters')\n\tif (raw === null) {\n\t\treturn parsed([])\n\t}\n\tlet decoded: unknown\n\ttry {\n\t\tdecoded = JSON.parse(raw)\n\t} catch {\n\t\treturn fail('invalid_param', 'filters must be a JSON array', 'filters')\n\t}\n\tif (!Array.isArray(decoded)) {\n\t\treturn fail('invalid_param', 'filters must be a JSON array', 'filters')\n\t}\n\tif (decoded.length > MAX_QUERY_FILTERS) {\n\t\treturn fail('invalid_param', `at most ${MAX_QUERY_FILTERS} filters are allowed`, 'filters')\n\t}\n\tconst filters: AnalyticsFilter[] = []\n\tfor (const item of decoded) {\n\t\tif (!isRecord(item) || Array.isArray(item)) {\n\t\t\treturn fail('invalid_param', 'each filter must be an object', 'filters')\n\t\t}\n\t\tconst { dimension, operator, value } = item\n\t\tif (!isDimensionKey(dimension)) {\n\t\t\treturn fail(\n\t\t\t\t'invalid_param',\n\t\t\t\t`unknown filter dimension: ${echo(String(dimension))}`,\n\t\t\t\t'filters'\n\t\t\t)\n\t\t}\n\t\tif (!isFilterOperator(operator)) {\n\t\t\treturn fail('invalid_param', `unknown filter operator: ${echo(String(operator))}`, 'filters')\n\t\t}\n\t\tif (typeof value !== 'string') {\n\t\t\treturn fail('invalid_param', 'each filter value must be a string', 'filters')\n\t\t}\n\t\tconst trimmed = value.trim()\n\t\tif (trimmed.length < 1 || trimmed.length > MAX_QUERY_FILTER_VALUE_LENGTH) {\n\t\t\treturn fail(\n\t\t\t\t'invalid_param',\n\t\t\t\t`each filter value must be 1 to ${MAX_QUERY_FILTER_VALUE_LENGTH} characters`,\n\t\t\t\t'filters'\n\t\t\t)\n\t\t}\n\t\t// Per pair, not per list: a source can take `contains` on one dimension and not another.\n\t\tconst offered = filterOperatorsFor(capabilities, dimension)\n\t\tif (offered.length === 0) {\n\t\t\treturn fail('unsupported_filter', `source cannot filter on ${dimension}`, 'filters')\n\t\t}\n\t\tif (!offered.includes(operator)) {\n\t\t\treturn fail(\n\t\t\t\t'unsupported_operator',\n\t\t\t\t`source cannot filter ${dimension} with ${operator}`,\n\t\t\t\t'filters'\n\t\t\t)\n\t\t}\n\t\tfilters.push({ dimension, operator, value: trimmed })\n\t}\n\treturn parsed(filters)\n}\n\nconst parseLimit = (params: URLSearchParams): Parsed<number> => {\n\tconst raw = readParam(params, 'limit')\n\tif (raw === null) {\n\t\treturn parsed(DEFAULT_QUERY_LIMIT)\n\t}\n\tif (!/^\\d+$/.test(raw)) {\n\t\treturn fail('invalid_param', `limit must be an integer: ${echo(raw)}`, 'limit')\n\t}\n\tconst limit = Number(raw)\n\tif (limit < MIN_QUERY_LIMIT || limit > MAX_QUERY_LIMIT) {\n\t\treturn fail(\n\t\t\t'invalid_param',\n\t\t\t`limit must be between ${MIN_QUERY_LIMIT} and ${MAX_QUERY_LIMIT}`,\n\t\t\t'limit'\n\t\t)\n\t}\n\treturn parsed(limit)\n}\n\nconst parseOrder = (\n\tparams: URLSearchParams,\n\tmetrics: readonly MetricKey[]\n): Parsed<AnalyticsQuery['order']> => {\n\tconst raw = readParam(params, 'order')\n\tif (raw === null) {\n\t\treturn parsed(undefined)\n\t}\n\tconst parts = raw.split(':')\n\tconst metric = parts[0] ?? ''\n\tconst direction = parts[1] ?? ''\n\tif (parts.length !== 2 || (direction !== 'asc' && direction !== 'desc')) {\n\t\treturn fail('invalid_param', 'order must be <metric>:<asc|desc>', 'order')\n\t}\n\tif (!isOneOf(metrics, metric)) {\n\t\treturn fail('invalid_param', `order metric is not in metrics: ${echo(metric)}`, 'order')\n\t}\n\treturn parsed({ metric, direction })\n}\n\n/** The refusal of the first metric the source cannot read for a read of this shape. */\nconst outOfReach = (\n\tcapabilities: SerializedCapabilities,\n\tmetrics: readonly MetricKey[],\n\tshape: { dimensions: DimensionKey[]; filters: AnalyticsFilter[]; path: boolean }\n): Failure | undefined => {\n\tfor (const metric of metrics) {\n\t\tconst out = metricOutOfReach(capabilities, servedName(metric, capabilities.metrics), shape)\n\t\tif (out !== null) {\n\t\t\treturn fail(\n\t\t\t\t'unsupported_metric',\n\t\t\t\t'breakdown' in out\n\t\t\t\t\t? `source does not serve ${metric} by ${out.breakdown}`\n\t\t\t\t\t: `source serves ${metric} only by ${out.needs} or filtered by it`,\n\t\t\t\t'metrics'\n\t\t\t)\n\t\t}\n\t}\n\treturn undefined\n}\n\n/**\n * First failing rule wins, in a fixed order: a value outside the contract is `invalid_param`, one\n * the source lacks its `unsupported_*` code; `source` and `scope` pass unvalidated.\n */\nexport const parseQueryParams = (params: URLSearchParams, args: ParseQueryArgs): ParseResult => {\n\tconst { capabilities } = args\n\tconst rawTimezone = readParam(params, 'timezone')\n\tif (rawTimezone !== null && !isValidTimeZone(rawTimezone)) {\n\t\treturn fail('invalid_param', `unknown timezone: ${echo(rawTimezone)}`, 'timezone')\n\t}\n\tconst timezone = rawTimezone ?? args.timezone\n\tconst metrics = parseMetrics(params, capabilities)\n\tif (!metrics.ok) {\n\t\treturn metrics\n\t}\n\tconst dimensions = parseDimensions(params, capabilities)\n\tif (!dimensions.ok) {\n\t\treturn dimensions\n\t}\n\tconst range = parseRange(params, timezone)\n\tif (!range.ok) {\n\t\treturn range\n\t}\n\tconst granularity = parseGranularity(params, capabilities)\n\tif (!granularity.ok) {\n\t\treturn granularity\n\t}\n\tconst filters = parseFilters(params, capabilities)\n\tif (!filters.ok) {\n\t\treturn filters\n\t}\n\tconst limit = parseLimit(params)\n\tif (!limit.ok) {\n\t\treturn limit\n\t}\n\tconst order = parseOrder(params, metrics.value)\n\tif (!order.ok) {\n\t\treturn order\n\t}\n\n\tconst rawCompare = readParam(params, 'compare')\n\tif (rawCompare !== null && rawCompare !== 'previous') {\n\t\treturn fail('invalid_param', `compare must be \"previous\": ${echo(rawCompare)}`, 'compare')\n\t}\n\tif (rawCompare === 'previous' && !capabilities.comparison) {\n\t\treturn fail('invalid_param', 'source does not support comparison', 'compare')\n\t}\n\n\tconst path = readParam(params, 'path')\n\tif (path !== null && path.length > MAX_QUERY_PATH_LENGTH) {\n\t\treturn fail('invalid_param', `path must be at most ${MAX_QUERY_PATH_LENGTH} characters`, 'path')\n\t}\n\tconst hostname = readParam(params, 'hostname')\n\tif (hostname !== null && hostname.length > MAX_QUERY_HOSTNAME_LENGTH) {\n\t\treturn fail(\n\t\t\t'invalid_param',\n\t\t\t`hostname must be at most ${MAX_QUERY_HOSTNAME_LENGTH} characters`,\n\t\t\t'hostname'\n\t\t)\n\t}\n\n\tconst item = readParam(params, 'item')\n\tif (item !== null && parseItemRef(item) === null) {\n\t\treturn fail('invalid_param', `item must be a <collection>:<id> ref: ${echo(item)}`, 'item')\n\t}\n\tif (item !== null && capabilities.perItemQuery !== true) {\n\t\treturn fail('invalid_param', 'source cannot read one item', 'item')\n\t}\n\n\tconst unreachable = outOfReach(capabilities, metrics.value, {\n\t\tdimensions: dimensions.value,\n\t\tfilters: filters.value,\n\t\tpath: path !== null,\n\t})\n\tif (unreachable) {\n\t\treturn unreachable\n\t}\n\n\tconst rawTimeframe = readParam(params, 'timeframe')\n\tif (rawTimeframe !== null && !isTimeframePreset(rawTimeframe)) {\n\t\treturn fail(\n\t\t\t'invalid_param',\n\t\t\t`timeframe must be one of ${TIMEFRAME_PRESETS.join(', ')}: ${echo(rawTimeframe)}`,\n\t\t\t'timeframe'\n\t\t)\n\t}\n\n\tconst query: AnalyticsQuery = {\n\t\tmetrics: metrics.value,\n\t\tdateRange: range.value,\n\t\tlimit: limit.value,\n\t\ttimezone,\n\t\t...(dimensions.value.length > 0 ? { dimensions: dimensions.value } : {}),\n\t\t...(granularity.value !== null ? { granularity: granularity.value } : {}),\n\t\t...(filters.value.length > 0 ? { filters: filters.value } : {}),\n\t\t...(order.value ? { order: order.value } : {}),\n\t\t...(path !== null ? { path } : {}),\n\t\t...(hostname !== null ? { hostname } : {}),\n\t\t...(item !== null ? { item } : {}),\n\t}\n\treturn {\n\t\tok: true,\n\t\tvalue: {\n\t\t\tquery,\n\t\t\tcompare: rawCompare === 'previous' ? 'previous' : null,\n\t\t\ttimeframe: isTimeframePreset(rawTimeframe) ? rawTimeframe : null,\n\t\t},\n\t}\n}\n"],"mappings":"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"}
@@ -10,6 +10,11 @@ interface QuerySourceRef {
10
10
  /** `config` for an adapter every scope shares, `runtime` for one resolved per scope. */
11
11
  kind: 'config' | 'runtime';
12
12
  }
13
+ /**
14
+ * What each content item a read names is called, keyed by its ref: the document's title as the
15
+ * reader may see it, or `null` for one that is removed, hidden from them or not an item at all.
16
+ */
17
+ type ItemLabels = Record<string, string | null>;
13
18
  /** An `AnalyticsQuery` as it survives JSON: the date range's instants are ISO strings. */
14
19
  type SerializedAnalyticsQuery = Omit<AnalyticsQuery, 'dateRange'> & {
15
20
  dateRange: {
@@ -17,7 +22,7 @@ type SerializedAnalyticsQuery = Omit<AnalyticsQuery, 'dateRange'> & {
17
22
  end: string;
18
23
  };
19
24
  };
20
- /** Successful answer of `GET /analytics/query`. */
25
+ /** Successful answer of the query endpoint (`GET <routes.api><routes.base>/query`). */
21
26
  interface QueryResponse {
22
27
  result: AnalyticsResult;
23
28
  /**
@@ -25,15 +30,30 @@ interface QueryResponse {
25
30
  * Omitted when the source does not compare or that window is beyond its lookback.
26
31
  */
27
32
  comparison?: AnalyticsResult;
33
+ /**
34
+ * ISO 4217 code of the read's revenue: the install's `revenue.currency`, or the code `currency`
35
+ * is filtered to, counted as sent. Absent means revenue is a plain number.
36
+ */
37
+ currency?: string;
28
38
  source: QuerySourceRef;
29
39
  capabilities: SerializedCapabilities;
30
40
  /** The query after validation and defaulting, so a client renders what it actually got. */
31
41
  query: SerializedAnalyticsQuery;
42
+ /**
43
+ * Slugs in `query.goalSlugs` the install never declared (latent built-in `purchase`); a report
44
+ * hides such a row until it converts and never counts it as the install having goals.
45
+ */
46
+ builtinGoalSlugs?: string[];
47
+ /**
48
+ * Titles for every item ref the read names (in its rows, its filters, or `query.item`), read
49
+ * with the caller's own access. Absent when it names none.
50
+ */
51
+ itemLabels?: ItemLabels;
32
52
  }
33
- /** Every non-2xx answer of `GET /analytics/query`. */
53
+ /** Every non-2xx answer of the query endpoint. */
34
54
  interface QueryErrorResponse {
35
55
  error: QueryError;
36
56
  }
37
57
  //#endregion
38
- export { QueryErrorResponse, QueryResponse, QuerySourceRef, SerializedAnalyticsQuery };
58
+ export { ItemLabels, QueryErrorResponse, QueryResponse, QuerySourceRef, SerializedAnalyticsQuery };
39
59
  //# sourceMappingURL=response.d.ts.map
@@ -1,11 +1,18 @@
1
+ import { isRecord } from "../core/values.js";
2
+ import { hasNoDeclaredGoals } from "../goals/latent.js";
1
3
  //#region src/query/response.ts
2
4
  /**
3
- * Whether the echoed query asked about goals and the scope configured none. The hint is
4
- * set only for a goal read, so an empty list is a scope with nothing to convert on: an
5
- * empty table rather than a source that could not answer, which is `meta.goalsUnresolved`.
5
+ * Whether a goal read found no declared goals in scope: an empty table, unlike a source that could
6
+ * not answer (`meta.goalsUnresolved`).
6
7
  */
7
- const askedAboutNoGoals = (query) => Array.isArray(query?.goalSlugs) && query.goalSlugs.length === 0;
8
+ const askedAboutNoGoals = (response) => {
9
+ const slugs = response?.query?.goalSlugs;
10
+ return Array.isArray(slugs) && hasNoDeclaredGoals(slugs, response?.builtinGoalSlugs);
11
+ };
12
+ const isResult = (value) => isRecord(value) && Array.isArray(value.rows) && value.rows.every((row) => isRecord(row) && isRecord(row.metrics)) && isRecord(value.meta) && typeof value.meta.provider === "string";
13
+ /** The parts of an answer every surface reads before it renders: the rows, their source, the query. */
14
+ const isQueryResponse = (value) => isRecord(value) && isResult(value.result) && (value.comparison === void 0 || isResult(value.comparison)) && isRecord(value.source) && typeof value.source.id === "string" && isRecord(value.capabilities) && isRecord(value.query) && Array.isArray(value.query.metrics);
8
15
  //#endregion
9
- export { askedAboutNoGoals };
16
+ export { askedAboutNoGoals, isQueryResponse };
10
17
 
11
18
  //# sourceMappingURL=response.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"response.js","names":[],"sources":["../../src/query/response.ts"],"sourcesContent":["import type { SerializedCapabilities } from '../core/capabilities'\nimport type { AnalyticsQuery, AnalyticsResult } from '../core/contract'\nimport type { QueryError } from './errors'\n\n/** Identity of the source a read was served by; its capabilities travel beside it. */\nexport interface QuerySourceRef {\n\tid: string\n\tlabel: string\n\t/** `config` for an adapter every scope shares, `runtime` for one resolved per scope. */\n\tkind: 'config' | 'runtime'\n}\n\n/** An `AnalyticsQuery` as it survives JSON: the date range's instants are ISO strings. */\nexport type SerializedAnalyticsQuery = Omit<AnalyticsQuery, 'dateRange'> & {\n\tdateRange: { start: string; end: string }\n}\n\n/** Successful answer of `GET /analytics/query`. */\nexport interface QueryResponse {\n\tresult: AnalyticsResult\n\t/**\n\t * The equal-length window before `query.dateRange`, asked for with `compare=previous`.\n\t * Omitted when the source does not compare or that window is beyond its lookback.\n\t */\n\tcomparison?: AnalyticsResult\n\tsource: QuerySourceRef\n\tcapabilities: SerializedCapabilities\n\t/** The query after validation and defaulting, so a client renders what it actually got. */\n\tquery: SerializedAnalyticsQuery\n}\n\n/**\n * Whether the echoed query asked about goals and the scope configured none. The hint is\n * set only for a goal read, so an empty list is a scope with nothing to convert on: an\n * empty table rather than a source that could not answer, which is `meta.goalsUnresolved`.\n */\nexport const askedAboutNoGoals = (query?: SerializedAnalyticsQuery): boolean =>\n\tArray.isArray(query?.goalSlugs) && query.goalSlugs.length === 0\n\n/** Every non-2xx answer of `GET /analytics/query`. */\nexport interface QueryErrorResponse {\n\terror: QueryError\n}\n"],"mappings":";;;;;;AAoCA,MAAa,qBAAqB,UACjC,MAAM,QAAQ,OAAO,SAAS,KAAK,MAAM,UAAU,WAAW"}
1
+ {"version":3,"file":"response.js","names":[],"sources":["../../src/query/response.ts"],"sourcesContent":["import type { SerializedCapabilities } from '../core/capabilities'\nimport type { AnalyticsQuery, AnalyticsResult } from '../core/contract'\nimport { isRecord } from '../core/values'\nimport { hasNoDeclaredGoals } from '../goals/latent'\nimport type { QueryError } from './errors'\n\n/** Identity of the source a read was served by; its capabilities travel beside it. */\nexport interface QuerySourceRef {\n\tid: string\n\tlabel: string\n\t/** `config` for an adapter every scope shares, `runtime` for one resolved per scope. */\n\tkind: 'config' | 'runtime'\n}\n\n/**\n * What each content item a read names is called, keyed by its ref: the document's title as the\n * reader may see it, or `null` for one that is removed, hidden from them or not an item at all.\n */\nexport type ItemLabels = Record<string, string | null>\n\n/** An `AnalyticsQuery` as it survives JSON: the date range's instants are ISO strings. */\nexport type SerializedAnalyticsQuery = Omit<AnalyticsQuery, 'dateRange'> & {\n\tdateRange: { start: string; end: string }\n}\n\n/** Successful answer of the query endpoint (`GET <routes.api><routes.base>/query`). */\nexport interface QueryResponse {\n\tresult: AnalyticsResult\n\t/**\n\t * The equal-length window before `query.dateRange`, asked for with `compare=previous`.\n\t * Omitted when the source does not compare or that window is beyond its lookback.\n\t */\n\tcomparison?: AnalyticsResult\n\t/**\n\t * ISO 4217 code of the read's revenue: the install's `revenue.currency`, or the code `currency`\n\t * is filtered to, counted as sent. Absent means revenue is a plain number.\n\t */\n\tcurrency?: string\n\tsource: QuerySourceRef\n\tcapabilities: SerializedCapabilities\n\t/** The query after validation and defaulting, so a client renders what it actually got. */\n\tquery: SerializedAnalyticsQuery\n\t/**\n\t * Slugs in `query.goalSlugs` the install never declared (latent built-in `purchase`); a report\n\t * hides such a row until it converts and never counts it as the install having goals.\n\t */\n\tbuiltinGoalSlugs?: string[]\n\t/**\n\t * Titles for every item ref the read names (in its rows, its filters, or `query.item`), read\n\t * with the caller's own access. Absent when it names none.\n\t */\n\titemLabels?: ItemLabels\n}\n\n/**\n * Whether a goal read found no declared goals in scope: an empty table, unlike a source that could\n * not answer (`meta.goalsUnresolved`).\n */\nexport const askedAboutNoGoals = (\n\tresponse?: Pick<QueryResponse, 'builtinGoalSlugs'> & { query?: SerializedAnalyticsQuery }\n): boolean => {\n\tconst slugs = response?.query?.goalSlugs\n\treturn Array.isArray(slugs) && hasNoDeclaredGoals(slugs, response?.builtinGoalSlugs)\n}\n\nconst isResult = (value: unknown): value is AnalyticsResult =>\n\tisRecord(value) &&\n\tArray.isArray(value.rows) &&\n\tvalue.rows.every((row) => isRecord(row) && isRecord(row.metrics)) &&\n\tisRecord(value.meta) &&\n\ttypeof value.meta.provider === 'string'\n\n/** The parts of an answer every surface reads before it renders: the rows, their source, the query. */\nexport const isQueryResponse = (value: unknown): value is QueryResponse =>\n\tisRecord(value) &&\n\tisResult(value.result) &&\n\t(value.comparison === undefined || isResult(value.comparison)) &&\n\tisRecord(value.source) &&\n\ttypeof value.source.id === 'string' &&\n\tisRecord(value.capabilities) &&\n\tisRecord(value.query) &&\n\tArray.isArray(value.query.metrics)\n\n/** Every non-2xx answer of the query endpoint. */\nexport interface QueryErrorResponse {\n\terror: QueryError\n}\n"],"mappings":";;;;;;;AA0DA,MAAa,qBACZ,aACa;CACb,MAAM,QAAQ,UAAU,OAAO;CAC/B,OAAO,MAAM,QAAQ,KAAK,KAAK,mBAAmB,OAAO,UAAU,gBAAgB;AACpF;AAEA,MAAM,YAAY,UACjB,SAAS,KAAK,KACd,MAAM,QAAQ,MAAM,IAAI,KACxB,MAAM,KAAK,OAAO,QAAQ,SAAS,GAAG,KAAK,SAAS,IAAI,OAAO,CAAC,KAChE,SAAS,MAAM,IAAI,KACnB,OAAO,MAAM,KAAK,aAAa;;AAGhC,MAAa,mBAAmB,UAC/B,SAAS,KAAK,KACd,SAAS,MAAM,MAAM,MACpB,MAAM,eAAe,KAAA,KAAa,SAAS,MAAM,UAAU,MAC5D,SAAS,MAAM,MAAM,KACrB,OAAO,MAAM,OAAO,OAAO,YAC3B,SAAS,MAAM,YAAY,KAC3B,SAAS,MAAM,KAAK,KACpB,MAAM,QAAQ,MAAM,MAAM,OAAO"}
@@ -1,5 +1,5 @@
1
- import { TrackerConfig } from "../capture/trackerConfig.js";
2
- import { LoadScript, Tracker } from "../tracker/types.js";
1
+ import { CaptureSlot, TrackerConfig } from "../tracker/config.js";
2
+ import { GateState, GateStatus, LoadScript, Tracker } from "../tracker/types.js";
3
3
  import { ReactElement, ReactNode } from "react";
4
4
 
5
5
  //#region src/react/AnalyticsProvider.d.ts
@@ -7,7 +7,15 @@ import { ReactElement, ReactNode } from "react";
7
7
  interface AnalyticsCommands {
8
8
  track: Tracker['track'];
9
9
  trackGoal: Tracker['trackGoal'];
10
- consent: Tracker['consent'];
10
+ /** Records a sale, with the amount that actually moved rather than the goal's own. */
11
+ purchase: Tracker['purchase'];
12
+ /** A no-op in the browser, with a development warning: refunds are server-side. */
13
+ refund: Tracker['refund'];
14
+ /**
15
+ * Opens or closes capture slots for the host's consent manager. Safe before the tracker has
16
+ * booted: the answer is kept for the window and applied at boot.
17
+ */
18
+ setGate: (state: GateState) => void;
11
19
  /** Takes this browser out of capture, or puts it back. */
12
20
  setExcluded: Tracker['exclude'];
13
21
  }
@@ -15,6 +23,8 @@ interface AnalyticsCommands {
15
23
  interface AnalyticsApi extends AnalyticsCommands {
16
24
  /** True while this browser is excluded from capture. Flipping it re-renders the caller. */
17
25
  excluded: boolean;
26
+ /** Each capture slot's gate. A change re-renders the caller. */
27
+ gate: Readonly<Record<CaptureSlot, GateStatus>>;
18
28
  }
19
29
  interface AnalyticsProviderProps {
20
30
  /** Resolved server-side by `getTrackerConfig`, or fetched from the tracker endpoint. */
@@ -22,28 +32,27 @@ interface AnalyticsProviderProps {
22
32
  children?: ReactNode;
23
33
  /** CSP nonce applied to the vendor scripts the tracker injects. */
24
34
  nonce?: string;
25
- /** Replaces script injection, for a consent manager or a framework script loader. */
35
+ /**
36
+ * Replaces script injection, for a framework script loader. A function cannot cross from a
37
+ * server component, so pass it from a client component of your own.
38
+ */
26
39
  loadScript?: LoadScript;
40
+ /** The answer the host already has at boot, as `<AnalyticsScripts gate>` takes it. */
41
+ gate?: GateState;
42
+ /** `false` injects no vendor script at all, for a consent manager that loads them itself. */
43
+ snippets?: boolean;
27
44
  }
28
45
  /**
29
- * Shares the window's tracker with the tree through `useAnalytics`. Use it when components
30
- * need to call `track`, `trackGoal`, or `consent` themselves; a page that only needs
31
- * pageviews and auto-capture can render `<AnalyticsScripts />` (which boots
32
- * `<TrackerBoot />`) and skip the provider. Rendering both is fine: the tracker is leased
33
- * from a per-window registry, so there is still only one.
34
- *
35
- * The lease is taken lazily in the browser rather than during render, so server rendering
36
- * stays inert and React's double-invoked render cannot leak a second tracker.
37
- *
38
- * Whichever component boots the tracker first owns its options, so a `nonce` or
39
- * `loadScript` passed to a provider that mounts after `<TrackerBoot />` is ignored: give
40
- * them to whatever boots first, or render only one of the two.
46
+ * Shares the window's one tracker with the tree through `useAnalytics`, leased after mount. The
47
+ * first component to boot it owns its options: after `<AnalyticsScripts />`, this one's are ignored.
41
48
  */
42
49
  declare const AnalyticsProvider: ({
43
50
  config,
44
51
  children,
45
52
  nonce,
46
- loadScript
53
+ loadScript,
54
+ gate,
55
+ snippets
47
56
  }: AnalyticsProviderProps) => ReactElement;
48
57
  //#endregion
49
58
  export { AnalyticsApi, AnalyticsCommands, AnalyticsProvider, AnalyticsProviderProps };
@@ -1,42 +1,38 @@
1
1
  "use client";
2
- import { acquireTracker } from "../tracker/registry.js";
2
+ import { acquireTracker, setWindowGate } from "../tracker/registry.js";
3
3
  import { createContext, useCallback, useEffect, useMemo, useRef } from "react";
4
4
  import { jsx } from "react/jsx-runtime";
5
5
  //#region src/react/AnalyticsProvider.tsx
6
6
  const AnalyticsContext = createContext(null);
7
7
  /**
8
- * Shares the window's tracker with the tree through `useAnalytics`. Use it when components
9
- * need to call `track`, `trackGoal`, or `consent` themselves; a page that only needs
10
- * pageviews and auto-capture can render `<AnalyticsScripts />` (which boots
11
- * `<TrackerBoot />`) and skip the provider. Rendering both is fine: the tracker is leased
12
- * from a per-window registry, so there is still only one.
13
- *
14
- * The lease is taken lazily in the browser rather than during render, so server rendering
15
- * stays inert and React's double-invoked render cannot leak a second tracker.
16
- *
17
- * Whichever component boots the tracker first owns its options, so a `nonce` or
18
- * `loadScript` passed to a provider that mounts after `<TrackerBoot />` is ignored: give
19
- * them to whatever boots first, or render only one of the two.
8
+ * Shares the window's one tracker with the tree through `useAnalytics`, leased after mount. The
9
+ * first component to boot it owns its options: after `<AnalyticsScripts />`, this one's are ignored.
20
10
  */
21
- const AnalyticsProvider = ({ config, children, nonce, loadScript }) => {
11
+ const AnalyticsProvider = ({ config, children, nonce, loadScript, gate, snippets }) => {
22
12
  const boot = useRef({
23
13
  config,
24
14
  nonce,
25
- loadScript
15
+ loadScript,
16
+ gate,
17
+ snippets
26
18
  });
27
19
  boot.current = {
28
20
  config,
29
21
  nonce,
30
- loadScript
22
+ loadScript,
23
+ gate,
24
+ snippets
31
25
  };
32
26
  const lease = useRef(null);
33
27
  const unmounted = useRef(false);
34
28
  const ensure = useCallback(() => {
35
29
  if (!lease.current && !unmounted.current && typeof window !== "undefined") {
36
- const { config: current, nonce: currentNonce, loadScript: currentLoad } = boot.current;
37
- lease.current = acquireTracker(current, {
38
- nonce: currentNonce,
39
- loadScript: currentLoad
30
+ const current = boot.current;
31
+ lease.current = acquireTracker(current.config, {
32
+ nonce: current.nonce,
33
+ loadScript: current.loadScript,
34
+ gate: current.gate,
35
+ snippets: current.snippets
40
36
  });
41
37
  }
42
38
  return lease.current?.tracker ?? null;
@@ -51,9 +47,14 @@ const AnalyticsProvider = ({ config, children, nonce, loadScript }) => {
51
47
  };
52
48
  }, [ensure]);
53
49
  const api = useMemo(() => ({
54
- track: (name, props) => ensure()?.track(name, props),
50
+ track: (name, props, opts) => ensure()?.track(name, props, opts),
55
51
  trackGoal: (slug, opts) => ensure()?.trackGoal(slug, opts),
56
- consent: (state) => ensure()?.consent(state),
52
+ purchase: (input) => ensure()?.purchase(input),
53
+ refund: (input) => ensure()?.refund(input),
54
+ setGate: (state) => {
55
+ setWindowGate(state);
56
+ ensure();
57
+ },
57
58
  setExcluded: (next) => ensure()?.exclude(next)
58
59
  }), [ensure]);
59
60
  return /* @__PURE__ */ jsx(AnalyticsContext.Provider, {
@@ -1 +1 @@
1
- {"version":3,"file":"AnalyticsProvider.js","names":[],"sources":["../../src/react/AnalyticsProvider.tsx"],"sourcesContent":["'use client'\n\nimport {\n\tcreateContext,\n\ttype ReactElement,\n\ttype ReactNode,\n\tuseCallback,\n\tuseEffect,\n\tuseMemo,\n\tuseRef,\n} from 'react'\nimport type { TrackerConfig } from '../capture/trackerConfig'\nimport { acquireTracker, type TrackerLease } from '../tracker/registry'\nimport type { LoadScript, Tracker } from '../tracker/types'\n\n/** What a component can ask the tracker to do. Stable for the life of the provider. */\nexport interface AnalyticsCommands {\n\ttrack: Tracker['track']\n\ttrackGoal: Tracker['trackGoal']\n\tconsent: Tracker['consent']\n\t/** Takes this browser out of capture, or puts it back. */\n\tsetExcluded: Tracker['exclude']\n}\n\n/** The tracker surface a component gets from `useAnalytics`. */\nexport interface AnalyticsApi extends AnalyticsCommands {\n\t/** True while this browser is excluded from capture. Flipping it re-renders the caller. */\n\texcluded: boolean\n}\n\nexport const AnalyticsContext = createContext<AnalyticsCommands | null>(null)\n\nexport interface AnalyticsProviderProps {\n\t/** Resolved server-side by `getTrackerConfig`, or fetched from the tracker endpoint. */\n\tconfig: TrackerConfig\n\tchildren?: ReactNode\n\t/** CSP nonce applied to the vendor scripts the tracker injects. */\n\tnonce?: string\n\t/** Replaces script injection, for a consent manager or a framework script loader. */\n\tloadScript?: LoadScript\n}\n\n/**\n * Shares the window's tracker with the tree through `useAnalytics`. Use it when components\n * need to call `track`, `trackGoal`, or `consent` themselves; a page that only needs\n * pageviews and auto-capture can render `<AnalyticsScripts />` (which boots\n * `<TrackerBoot />`) and skip the provider. Rendering both is fine: the tracker is leased\n * from a per-window registry, so there is still only one.\n *\n * The lease is taken lazily in the browser rather than during render, so server rendering\n * stays inert and React's double-invoked render cannot leak a second tracker.\n *\n * Whichever component boots the tracker first owns its options, so a `nonce` or\n * `loadScript` passed to a provider that mounts after `<TrackerBoot />` is ignored: give\n * them to whatever boots first, or render only one of the two.\n */\nexport const AnalyticsProvider = ({\n\tconfig,\n\tchildren,\n\tnonce,\n\tloadScript,\n}: AnalyticsProviderProps): ReactElement => {\n\tconst boot = useRef({ config, nonce, loadScript })\n\tboot.current = { config, nonce, loadScript }\n\tconst lease = useRef<TrackerLease | null>(null)\n\tconst unmounted = useRef(false)\n\n\tconst ensure = useCallback((): Tracker | null => {\n\t\tif (!lease.current && !unmounted.current && typeof window !== 'undefined') {\n\t\t\tconst { config: current, nonce: currentNonce, loadScript: currentLoad } = boot.current\n\t\t\tlease.current = acquireTracker(current, { nonce: currentNonce, loadScript: currentLoad })\n\t\t}\n\t\treturn lease.current?.tracker ?? null\n\t}, [])\n\n\tuseEffect(() => {\n\t\tunmounted.current = false\n\t\tensure()\n\t\treturn () => {\n\t\t\t// A stale `track` call held past unmount must not resurrect the tracker.\n\t\t\tunmounted.current = true\n\t\t\tlease.current?.release()\n\t\t\tlease.current = null\n\t\t}\n\t}, [ensure])\n\n\tconst api = useMemo<AnalyticsCommands>(\n\t\t() => ({\n\t\t\ttrack: (name, props) => ensure()?.track(name, props),\n\t\t\ttrackGoal: (slug, opts) => ensure()?.trackGoal(slug, opts),\n\t\t\tconsent: (state) => ensure()?.consent(state),\n\t\t\tsetExcluded: (next) => ensure()?.exclude(next),\n\t\t}),\n\t\t[ensure]\n\t)\n\n\treturn <AnalyticsContext.Provider value={api}>{children}</AnalyticsContext.Provider>\n}\n"],"mappings":";;;;;AA8BA,MAAa,mBAAmB,cAAwC,IAAI;;;;;;;;;;;;;;;AA0B5E,MAAa,qBAAqB,EACjC,QACA,UACA,OACA,iBAC2C;CAC3C,MAAM,OAAO,OAAO;EAAE;EAAQ;EAAO;CAAW,CAAC;CACjD,KAAK,UAAU;EAAE;EAAQ;EAAO;CAAW;CAC3C,MAAM,QAAQ,OAA4B,IAAI;CAC9C,MAAM,YAAY,OAAO,KAAK;CAE9B,MAAM,SAAS,kBAAkC;EAChD,IAAI,CAAC,MAAM,WAAW,CAAC,UAAU,WAAW,OAAO,WAAW,aAAa;GAC1E,MAAM,EAAE,QAAQ,SAAS,OAAO,cAAc,YAAY,gBAAgB,KAAK;GAC/E,MAAM,UAAU,eAAe,SAAS;IAAE,OAAO;IAAc,YAAY;GAAY,CAAC;EACzF;EACA,OAAO,MAAM,SAAS,WAAW;CAClC,GAAG,CAAC,CAAC;CAEL,gBAAgB;EACf,UAAU,UAAU;EACpB,OAAO;EACP,aAAa;GAEZ,UAAU,UAAU;GACpB,MAAM,SAAS,QAAQ;GACvB,MAAM,UAAU;EACjB;CACD,GAAG,CAAC,MAAM,CAAC;CAEX,MAAM,MAAM,eACJ;EACN,QAAQ,MAAM,UAAU,OAAO,GAAG,MAAM,MAAM,KAAK;EACnD,YAAY,MAAM,SAAS,OAAO,GAAG,UAAU,MAAM,IAAI;EACzD,UAAU,UAAU,OAAO,GAAG,QAAQ,KAAK;EAC3C,cAAc,SAAS,OAAO,GAAG,QAAQ,IAAI;CAC9C,IACA,CAAC,MAAM,CACR;CAEA,OAAO,oBAAC,iBAAiB,UAAlB;EAA2B,OAAO;EAAM;CAAoC,CAAA;AACpF"}
1
+ {"version":3,"file":"AnalyticsProvider.js","names":[],"sources":["../../src/react/AnalyticsProvider.tsx"],"sourcesContent":["'use client'\n\nimport {\n\tcreateContext,\n\ttype ReactElement,\n\ttype ReactNode,\n\tuseCallback,\n\tuseEffect,\n\tuseMemo,\n\tuseRef,\n} from 'react'\nimport type { CaptureSlot, TrackerConfig } from '../tracker/config'\nimport { acquireTracker, setWindowGate, type TrackerLease } from '../tracker/registry'\nimport type { GateState, GateStatus, LoadScript, Tracker } from '../tracker/types'\n\n/** What a component can ask the tracker to do. Stable for the life of the provider. */\nexport interface AnalyticsCommands {\n\ttrack: Tracker['track']\n\ttrackGoal: Tracker['trackGoal']\n\t/** Records a sale, with the amount that actually moved rather than the goal's own. */\n\tpurchase: Tracker['purchase']\n\t/** A no-op in the browser, with a development warning: refunds are server-side. */\n\trefund: Tracker['refund']\n\t/**\n\t * Opens or closes capture slots for the host's consent manager. Safe before the tracker has\n\t * booted: the answer is kept for the window and applied at boot.\n\t */\n\tsetGate: (state: GateState) => void\n\t/** Takes this browser out of capture, or puts it back. */\n\tsetExcluded: Tracker['exclude']\n}\n\n/** The tracker surface a component gets from `useAnalytics`. */\nexport interface AnalyticsApi extends AnalyticsCommands {\n\t/** True while this browser is excluded from capture. Flipping it re-renders the caller. */\n\texcluded: boolean\n\t/** Each capture slot's gate. A change re-renders the caller. */\n\tgate: Readonly<Record<CaptureSlot, GateStatus>>\n}\n\nexport const AnalyticsContext = createContext<AnalyticsCommands | null>(null)\n\nexport interface AnalyticsProviderProps {\n\t/** Resolved server-side by `getTrackerConfig`, or fetched from the tracker endpoint. */\n\tconfig: TrackerConfig\n\tchildren?: ReactNode\n\t/** CSP nonce applied to the vendor scripts the tracker injects. */\n\tnonce?: string\n\t/**\n\t * Replaces script injection, for a framework script loader. A function cannot cross from a\n\t * server component, so pass it from a client component of your own.\n\t */\n\tloadScript?: LoadScript\n\t/** The answer the host already has at boot, as `<AnalyticsScripts gate>` takes it. */\n\tgate?: GateState\n\t/** `false` injects no vendor script at all, for a consent manager that loads them itself. */\n\tsnippets?: boolean\n}\n\n/**\n * Shares the window's one tracker with the tree through `useAnalytics`, leased after mount. The\n * first component to boot it owns its options: after `<AnalyticsScripts />`, this one's are ignored.\n */\nexport const AnalyticsProvider = ({\n\tconfig,\n\tchildren,\n\tnonce,\n\tloadScript,\n\tgate,\n\tsnippets,\n}: AnalyticsProviderProps): ReactElement => {\n\tconst boot = useRef({ config, nonce, loadScript, gate, snippets })\n\tboot.current = { config, nonce, loadScript, gate, snippets }\n\tconst lease = useRef<TrackerLease | null>(null)\n\tconst unmounted = useRef(false)\n\n\tconst ensure = useCallback((): Tracker | null => {\n\t\tif (!lease.current && !unmounted.current && typeof window !== 'undefined') {\n\t\t\tconst current = boot.current\n\t\t\tlease.current = acquireTracker(current.config, {\n\t\t\t\tnonce: current.nonce,\n\t\t\t\tloadScript: current.loadScript,\n\t\t\t\tgate: current.gate,\n\t\t\t\tsnippets: current.snippets,\n\t\t\t})\n\t\t}\n\t\treturn lease.current?.tracker ?? null\n\t}, [])\n\n\tuseEffect(() => {\n\t\tunmounted.current = false\n\t\tensure()\n\t\treturn () => {\n\t\t\t// A stale `track` call held past unmount must not resurrect the tracker.\n\t\t\tunmounted.current = true\n\t\t\tlease.current?.release()\n\t\t\tlease.current = null\n\t\t}\n\t}, [ensure])\n\n\tconst api = useMemo<AnalyticsCommands>(\n\t\t() => ({\n\t\t\ttrack: (name, props, opts) => ensure()?.track(name, props, opts),\n\t\t\ttrackGoal: (slug, opts) => ensure()?.trackGoal(slug, opts),\n\t\t\tpurchase: (input) => ensure()?.purchase(input),\n\t\t\trefund: (input) => ensure()?.refund(input),\n\t\t\t// Recorded before the boot, which a child's effect can trigger ahead of the provider's own:\n\t\t\t// a tracker booted first would load and send under the previous answer.\n\t\t\tsetGate: (state) => {\n\t\t\t\tsetWindowGate(state)\n\t\t\t\tensure()\n\t\t\t},\n\t\t\tsetExcluded: (next) => ensure()?.exclude(next),\n\t\t}),\n\t\t[ensure]\n\t)\n\n\treturn <AnalyticsContext.Provider value={api}>{children}</AnalyticsContext.Provider>\n}\n"],"mappings":";;;;;AAwCA,MAAa,mBAAmB,cAAwC,IAAI;;;;;AAuB5E,MAAa,qBAAqB,EACjC,QACA,UACA,OACA,YACA,MACA,eAC2C;CAC3C,MAAM,OAAO,OAAO;EAAE;EAAQ;EAAO;EAAY;EAAM;CAAS,CAAC;CACjE,KAAK,UAAU;EAAE;EAAQ;EAAO;EAAY;EAAM;CAAS;CAC3D,MAAM,QAAQ,OAA4B,IAAI;CAC9C,MAAM,YAAY,OAAO,KAAK;CAE9B,MAAM,SAAS,kBAAkC;EAChD,IAAI,CAAC,MAAM,WAAW,CAAC,UAAU,WAAW,OAAO,WAAW,aAAa;GAC1E,MAAM,UAAU,KAAK;GACrB,MAAM,UAAU,eAAe,QAAQ,QAAQ;IAC9C,OAAO,QAAQ;IACf,YAAY,QAAQ;IACpB,MAAM,QAAQ;IACd,UAAU,QAAQ;GACnB,CAAC;EACF;EACA,OAAO,MAAM,SAAS,WAAW;CAClC,GAAG,CAAC,CAAC;CAEL,gBAAgB;EACf,UAAU,UAAU;EACpB,OAAO;EACP,aAAa;GAEZ,UAAU,UAAU;GACpB,MAAM,SAAS,QAAQ;GACvB,MAAM,UAAU;EACjB;CACD,GAAG,CAAC,MAAM,CAAC;CAEX,MAAM,MAAM,eACJ;EACN,QAAQ,MAAM,OAAO,SAAS,OAAO,GAAG,MAAM,MAAM,OAAO,IAAI;EAC/D,YAAY,MAAM,SAAS,OAAO,GAAG,UAAU,MAAM,IAAI;EACzD,WAAW,UAAU,OAAO,GAAG,SAAS,KAAK;EAC7C,SAAS,UAAU,OAAO,GAAG,OAAO,KAAK;EAGzC,UAAU,UAAU;GACnB,cAAc,KAAK;GACnB,OAAO;EACR;EACA,cAAc,SAAS,OAAO,GAAG,QAAQ,IAAI;CAC9C,IACA,CAAC,MAAM,CACR;CAEA,OAAO,oBAAC,iBAAiB,UAAlB;EAA2B,OAAO;EAAM;CAAoC,CAAA;AACpF"}
@@ -3,23 +3,29 @@ import { acquireTracker } from "../tracker/registry.js";
3
3
  import { useEffect, useRef } from "react";
4
4
  //#region src/react/TrackerBoot.tsx
5
5
  /**
6
- * Boots the browser tracker from a server-resolved config and renders nothing. This is the
7
- * RSC path: `<AnalyticsScripts />` renders it after the slot snippets, so a page gets
8
- * pageviews and auto-capture with no provider and no client state. Wrap the tree in
9
- * `<AnalyticsProvider>` as well when components need to call `track` themselves: both take
10
- * a lease on the window's one tracker, so neither double-counts.
6
+ * Internal: what `<AnalyticsScripts />` renders to boot the tracker with server-passable props. It
7
+ * leases the window's one tracker, so it and `<AnalyticsProvider>` never double-count.
11
8
  */
12
- const TrackerBoot = ({ config, nonce }) => {
9
+ const TrackerBoot = ({ config, nonce, gate, snippets }) => {
13
10
  const boot = useRef({
14
11
  config,
15
- nonce
12
+ nonce,
13
+ gate,
14
+ snippets
16
15
  });
17
16
  boot.current = {
18
17
  config,
19
- nonce
18
+ nonce,
19
+ gate,
20
+ snippets
20
21
  };
21
22
  useEffect(() => {
22
- const lease = acquireTracker(boot.current.config, { nonce: boot.current.nonce });
23
+ const current = boot.current;
24
+ const lease = acquireTracker(current.config, {
25
+ nonce: current.nonce,
26
+ gate: current.gate,
27
+ snippets: current.snippets
28
+ });
23
29
  return () => lease.release();
24
30
  }, []);
25
31
  return null;
@@ -1 +1 @@
1
- {"version":3,"file":"TrackerBoot.js","names":[],"sources":["../../src/react/TrackerBoot.tsx"],"sourcesContent":["'use client'\n\nimport { useEffect, useRef } from 'react'\nimport type { TrackerConfig } from '../capture/trackerConfig'\nimport { acquireTracker } from '../tracker/registry'\n\nexport interface TrackerBootProps {\n\tconfig: TrackerConfig\n\t/** CSP nonce for any script this component injects. */\n\tnonce?: string\n}\n\n/**\n * Boots the browser tracker from a server-resolved config and renders nothing. This is the\n * RSC path: `<AnalyticsScripts />` renders it after the slot snippets, so a page gets\n * pageviews and auto-capture with no provider and no client state. Wrap the tree in\n * `<AnalyticsProvider>` as well when components need to call `track` themselves: both take\n * a lease on the window's one tracker, so neither double-counts.\n */\nexport const TrackerBoot = ({ config, nonce }: TrackerBootProps): null => {\n\tconst boot = useRef({ config, nonce })\n\tboot.current = { config, nonce }\n\n\tuseEffect(() => {\n\t\tconst lease = acquireTracker(boot.current.config, { nonce: boot.current.nonce })\n\t\treturn () => lease.release()\n\t}, [])\n\n\treturn null\n}\n"],"mappings":";;;;;;;;;;;AAmBA,MAAa,eAAe,EAAE,QAAQ,YAAoC;CACzE,MAAM,OAAO,OAAO;EAAE;EAAQ;CAAM,CAAC;CACrC,KAAK,UAAU;EAAE;EAAQ;CAAM;CAE/B,gBAAgB;EACf,MAAM,QAAQ,eAAe,KAAK,QAAQ,QAAQ,EAAE,OAAO,KAAK,QAAQ,MAAM,CAAC;EAC/E,aAAa,MAAM,QAAQ;CAC5B,GAAG,CAAC,CAAC;CAEL,OAAO;AACR"}
1
+ {"version":3,"file":"TrackerBoot.js","names":[],"sources":["../../src/react/TrackerBoot.tsx"],"sourcesContent":["'use client'\n\nimport { useEffect, useRef } from 'react'\nimport type { TrackerConfig } from '../tracker/config'\nimport { acquireTracker } from '../tracker/registry'\nimport type { GateState } from '../tracker/types'\n\nexport interface TrackerBootProps {\n\tconfig: TrackerConfig\n\t/** CSP nonce for any script the tracker injects. */\n\tnonce?: string\n\t/** The answer the server rendered the page with, applied at boot. */\n\tgate?: GateState\n\t/** `false` injects no vendor script at all. */\n\tsnippets?: boolean\n}\n\n/**\n * Internal: what `<AnalyticsScripts />` renders to boot the tracker with server-passable props. It\n * leases the window's one tracker, so it and `<AnalyticsProvider>` never double-count.\n */\nexport const TrackerBoot = ({ config, nonce, gate, snippets }: TrackerBootProps): null => {\n\tconst boot = useRef({ config, nonce, gate, snippets })\n\tboot.current = { config, nonce, gate, snippets }\n\n\tuseEffect(() => {\n\t\tconst current = boot.current\n\t\tconst lease = acquireTracker(current.config, {\n\t\t\tnonce: current.nonce,\n\t\t\tgate: current.gate,\n\t\t\tsnippets: current.snippets,\n\t\t})\n\t\treturn () => lease.release()\n\t}, [])\n\n\treturn null\n}\n"],"mappings":";;;;;;;;AAqBA,MAAa,eAAe,EAAE,QAAQ,OAAO,MAAM,eAAuC;CACzF,MAAM,OAAO,OAAO;EAAE;EAAQ;EAAO;EAAM;CAAS,CAAC;CACrD,KAAK,UAAU;EAAE;EAAQ;EAAO;EAAM;CAAS;CAE/C,gBAAgB;EACf,MAAM,UAAU,KAAK;EACrB,MAAM,QAAQ,eAAe,QAAQ,QAAQ;GAC5C,OAAO,QAAQ;GACf,MAAM,QAAQ;GACd,UAAU,QAAQ;EACnB,CAAC;EACD,aAAa,MAAM,QAAQ;CAC5B,GAAG,CAAC,CAAC;CAEL,OAAO;AACR"}
@@ -2,17 +2,8 @@ import { AnalyticsApi } from "./AnalyticsProvider.js";
2
2
 
3
3
  //#region src/react/useAnalytics.d.ts
4
4
  /**
5
- * The window's tracker: the surrounding `<AnalyticsProvider>`'s when there is one, else
6
- * whichever instance `<AnalyticsScripts />` booted, so the RSC path alone is enough for a
7
- * client component to send its own events.
8
- *
9
- * The tracker is resolved per call, not per render: `<TrackerBoot />`'s effect may not have
10
- * run when a sibling renders, and an eagerly resolved null would never recover. A call that
11
- * finds neither a provider nor a booted tracker throws, because a silently dead `track` is
12
- * worse than a build-time mistake.
13
- *
14
- * `excluded` is read from the tracker rather than held in state, so every component sees the
15
- * same flag however it was flipped.
5
+ * The window's tracker, from `<AnalyticsProvider>` or else whatever `<AnalyticsScripts />` booted.
6
+ * A call with neither throws, except `setGate`, which is kept until a tracker boots.
16
7
  */
17
8
  declare const useAnalytics: () => AnalyticsApi;
18
9
  //#endregion
@@ -1,32 +1,23 @@
1
1
  "use client";
2
- import { readExclusion, subscribeExclusion } from "../tracker/exclusion.js";
3
- import { liveTracker } from "../tracker/registry.js";
2
+ import { subscribeExclusion } from "../tracker/exclusion.js";
3
+ import { ALL_PENDING } from "../tracker/gate.js";
4
+ import { liveTracker, setWindowGate, subscribeWindowGate, windowGateSnapshot } from "../tracker/registry.js";
4
5
  import { AnalyticsContext } from "./AnalyticsProvider.js";
5
6
  import { useContext, useMemo, useSyncExternalStore } from "react";
6
7
  //#region src/react/useAnalytics.tsx
7
8
  const NO_TRACKER = "analytics: useAnalytics found no tracker. Render <AnalyticsScripts /> (or <AnalyticsProvider>) above this component.";
8
- /** The live tracker's flag, so a blocked storage still reports this page's exclusion. */
9
- const exclusionSnapshot = () => {
10
- if (typeof window === "undefined") return false;
11
- return liveTracker(window)?.excluded ?? readExclusion(window);
12
- };
13
- const serverSnapshot = () => false;
9
+ /** The live tracker's flag, never storage: false until a tracker has read it, once a slot opened. */
10
+ const exclusionSnapshot = () => liveTracker()?.excluded ?? false;
11
+ const serverExclusionSnapshot = () => false;
12
+ const serverGateSnapshot = () => ALL_PENDING;
14
13
  /**
15
- * The window's tracker: the surrounding `<AnalyticsProvider>`'s when there is one, else
16
- * whichever instance `<AnalyticsScripts />` booted, so the RSC path alone is enough for a
17
- * client component to send its own events.
18
- *
19
- * The tracker is resolved per call, not per render: `<TrackerBoot />`'s effect may not have
20
- * run when a sibling renders, and an eagerly resolved null would never recover. A call that
21
- * finds neither a provider nor a booted tracker throws, because a silently dead `track` is
22
- * worse than a build-time mistake.
23
- *
24
- * `excluded` is read from the tracker rather than held in state, so every component sees the
25
- * same flag however it was flipped.
14
+ * The window's tracker, from `<AnalyticsProvider>` or else whatever `<AnalyticsScripts />` booted.
15
+ * A call with neither throws, except `setGate`, which is kept until a tracker boots.
26
16
  */
27
17
  const useAnalytics = () => {
28
18
  const provided = useContext(AnalyticsContext);
29
- const excluded = useSyncExternalStore(subscribeExclusion, exclusionSnapshot, serverSnapshot);
19
+ const excluded = useSyncExternalStore(subscribeExclusion, exclusionSnapshot, serverExclusionSnapshot);
20
+ const gate = useSyncExternalStore(subscribeWindowGate, windowGateSnapshot, serverGateSnapshot);
30
21
  const commands = useMemo(() => {
31
22
  if (provided) return provided;
32
23
  const tracker = () => {
@@ -35,16 +26,23 @@ const useAnalytics = () => {
35
26
  return live;
36
27
  };
37
28
  return {
38
- track: (name, props) => tracker().track(name, props),
29
+ track: (name, props, opts) => tracker().track(name, props, opts),
39
30
  trackGoal: (slug, opts) => tracker().trackGoal(slug, opts),
40
- consent: (state) => tracker().consent(state),
31
+ purchase: (input) => tracker().purchase(input),
32
+ refund: (input) => tracker().refund(input),
33
+ setGate: (state) => setWindowGate(state),
41
34
  setExcluded: (next) => tracker().exclude(next)
42
35
  };
43
36
  }, [provided]);
44
37
  return useMemo(() => ({
45
38
  ...commands,
46
- excluded
47
- }), [commands, excluded]);
39
+ excluded,
40
+ gate
41
+ }), [
42
+ commands,
43
+ excluded,
44
+ gate
45
+ ]);
48
46
  };
49
47
  //#endregion
50
48
  export { useAnalytics };
@@ -1 +1 @@
1
- {"version":3,"file":"useAnalytics.js","names":[],"sources":["../../src/react/useAnalytics.tsx"],"sourcesContent":["'use client'\n\nimport { useContext, useMemo, useSyncExternalStore } from 'react'\nimport { readExclusion, subscribeExclusion } from '../tracker/exclusion'\nimport { liveTracker } from '../tracker/registry'\nimport type { Tracker } from '../tracker/types'\nimport { type AnalyticsApi, type AnalyticsCommands, AnalyticsContext } from './AnalyticsProvider'\n\nconst NO_TRACKER =\n\t'analytics: useAnalytics found no tracker. Render <AnalyticsScripts /> (or <AnalyticsProvider>) above this component.'\n\n/** The live tracker's flag, so a blocked storage still reports this page's exclusion. */\nconst exclusionSnapshot = (): boolean => {\n\tif (typeof window === 'undefined') {\n\t\treturn false\n\t}\n\treturn liveTracker(window)?.excluded ?? readExclusion(window)\n}\n\nconst serverSnapshot = (): boolean => false\n\n/**\n * The window's tracker: the surrounding `<AnalyticsProvider>`'s when there is one, else\n * whichever instance `<AnalyticsScripts />` booted, so the RSC path alone is enough for a\n * client component to send its own events.\n *\n * The tracker is resolved per call, not per render: `<TrackerBoot />`'s effect may not have\n * run when a sibling renders, and an eagerly resolved null would never recover. A call that\n * finds neither a provider nor a booted tracker throws, because a silently dead `track` is\n * worse than a build-time mistake.\n *\n * `excluded` is read from the tracker rather than held in state, so every component sees the\n * same flag however it was flipped.\n */\nexport const useAnalytics = (): AnalyticsApi => {\n\tconst provided = useContext(AnalyticsContext)\n\tconst excluded = useSyncExternalStore(subscribeExclusion, exclusionSnapshot, serverSnapshot)\n\tconst commands = useMemo<AnalyticsCommands>(() => {\n\t\tif (provided) {\n\t\t\treturn provided\n\t\t}\n\t\tconst tracker = (): Tracker => {\n\t\t\tconst live = liveTracker()\n\t\t\tif (!live) {\n\t\t\t\tthrow new Error(NO_TRACKER)\n\t\t\t}\n\t\t\treturn live\n\t\t}\n\t\treturn {\n\t\t\ttrack: (name, props) => tracker().track(name, props),\n\t\t\ttrackGoal: (slug, opts) => tracker().trackGoal(slug, opts),\n\t\t\tconsent: (state) => tracker().consent(state),\n\t\t\tsetExcluded: (next) => tracker().exclude(next),\n\t\t}\n\t}, [provided])\n\n\treturn useMemo<AnalyticsApi>(() => ({ ...commands, excluded }), [commands, excluded])\n}\n"],"mappings":";;;;;;AAQA,MAAM,aACL;;AAGD,MAAM,0BAAmC;CACxC,IAAI,OAAO,WAAW,aACrB,OAAO;CAER,OAAO,YAAY,MAAM,GAAG,YAAY,cAAc,MAAM;AAC7D;AAEA,MAAM,uBAAgC;;;;;;;;;;;;;;AAetC,MAAa,qBAAmC;CAC/C,MAAM,WAAW,WAAW,gBAAgB;CAC5C,MAAM,WAAW,qBAAqB,oBAAoB,mBAAmB,cAAc;CAC3F,MAAM,WAAW,cAAiC;EACjD,IAAI,UACH,OAAO;EAER,MAAM,gBAAyB;GAC9B,MAAM,OAAO,YAAY;GACzB,IAAI,CAAC,MACJ,MAAM,IAAI,MAAM,UAAU;GAE3B,OAAO;EACR;EACA,OAAO;GACN,QAAQ,MAAM,UAAU,QAAQ,EAAE,MAAM,MAAM,KAAK;GACnD,YAAY,MAAM,SAAS,QAAQ,EAAE,UAAU,MAAM,IAAI;GACzD,UAAU,UAAU,QAAQ,EAAE,QAAQ,KAAK;GAC3C,cAAc,SAAS,QAAQ,EAAE,QAAQ,IAAI;EAC9C;CACD,GAAG,CAAC,QAAQ,CAAC;CAEb,OAAO,eAA6B;EAAE,GAAG;EAAU;CAAS,IAAI,CAAC,UAAU,QAAQ,CAAC;AACrF"}
1
+ {"version":3,"file":"useAnalytics.js","names":[],"sources":["../../src/react/useAnalytics.tsx"],"sourcesContent":["'use client'\n\nimport { useContext, useMemo, useSyncExternalStore } from 'react'\nimport { subscribeExclusion } from '../tracker/exclusion'\nimport { ALL_PENDING, type GateSnapshot } from '../tracker/gate'\nimport {\n\tliveTracker,\n\tsetWindowGate,\n\tsubscribeWindowGate,\n\twindowGateSnapshot,\n} from '../tracker/registry'\nimport type { Tracker } from '../tracker/types'\nimport { type AnalyticsApi, type AnalyticsCommands, AnalyticsContext } from './AnalyticsProvider'\n\nconst NO_TRACKER =\n\t'analytics: useAnalytics found no tracker. Render <AnalyticsScripts /> (or <AnalyticsProvider>) above this component.'\n\n/** The live tracker's flag, never storage: false until a tracker has read it, once a slot opened. */\nconst exclusionSnapshot = (): boolean => liveTracker()?.excluded ?? false\n\nconst serverExclusionSnapshot = (): boolean => false\n\nconst serverGateSnapshot = (): GateSnapshot => ALL_PENDING\n\n/**\n * The window's tracker, from `<AnalyticsProvider>` or else whatever `<AnalyticsScripts />` booted.\n * A call with neither throws, except `setGate`, which is kept until a tracker boots.\n */\nexport const useAnalytics = (): AnalyticsApi => {\n\tconst provided = useContext(AnalyticsContext)\n\tconst excluded = useSyncExternalStore(\n\t\tsubscribeExclusion,\n\t\texclusionSnapshot,\n\t\tserverExclusionSnapshot\n\t)\n\tconst gate = useSyncExternalStore(subscribeWindowGate, windowGateSnapshot, serverGateSnapshot)\n\tconst commands = useMemo<AnalyticsCommands>(() => {\n\t\tif (provided) {\n\t\t\treturn provided\n\t\t}\n\t\t// Per call, not per render: the boot effect may not have run yet when a sibling renders.\n\t\tconst tracker = (): Tracker => {\n\t\t\tconst live = liveTracker()\n\t\t\tif (!live) {\n\t\t\t\tthrow new Error(NO_TRACKER)\n\t\t\t}\n\t\t\treturn live\n\t\t}\n\t\treturn {\n\t\t\ttrack: (name, props, opts) => tracker().track(name, props, opts),\n\t\t\ttrackGoal: (slug, opts) => tracker().trackGoal(slug, opts),\n\t\t\tpurchase: (input) => tracker().purchase(input),\n\t\t\trefund: (input) => tracker().refund(input),\n\t\t\tsetGate: (state) => setWindowGate(state),\n\t\t\tsetExcluded: (next) => tracker().exclude(next),\n\t\t}\n\t}, [provided])\n\n\treturn useMemo<AnalyticsApi>(() => ({ ...commands, excluded, gate }), [commands, excluded, gate])\n}\n"],"mappings":";;;;;;;AAcA,MAAM,aACL;;AAGD,MAAM,0BAAmC,YAAY,GAAG,YAAY;AAEpE,MAAM,gCAAyC;AAE/C,MAAM,2BAAyC;;;;;AAM/C,MAAa,qBAAmC;CAC/C,MAAM,WAAW,WAAW,gBAAgB;CAC5C,MAAM,WAAW,qBAChB,oBACA,mBACA,uBACD;CACA,MAAM,OAAO,qBAAqB,qBAAqB,oBAAoB,kBAAkB;CAC7F,MAAM,WAAW,cAAiC;EACjD,IAAI,UACH,OAAO;EAGR,MAAM,gBAAyB;GAC9B,MAAM,OAAO,YAAY;GACzB,IAAI,CAAC,MACJ,MAAM,IAAI,MAAM,UAAU;GAE3B,OAAO;EACR;EACA,OAAO;GACN,QAAQ,MAAM,OAAO,SAAS,QAAQ,EAAE,MAAM,MAAM,OAAO,IAAI;GAC/D,YAAY,MAAM,SAAS,QAAQ,EAAE,UAAU,MAAM,IAAI;GACzD,WAAW,UAAU,QAAQ,EAAE,SAAS,KAAK;GAC7C,SAAS,UAAU,QAAQ,EAAE,OAAO,KAAK;GACzC,UAAU,UAAU,cAAc,KAAK;GACvC,cAAc,SAAS,QAAQ,EAAE,QAAQ,IAAI;EAC9C;CACD,GAAG,CAAC,QAAQ,CAAC;CAEb,OAAO,eAA6B;EAAE,GAAG;EAAU;EAAU;CAAK,IAAI;EAAC;EAAU;EAAU;CAAI,CAAC;AACjG"}
@@ -0,0 +1,34 @@
1
+ import { TrackerConfig } from "../tracker/config.js";
2
+ import { GateState } from "../tracker/types.js";
3
+ import { ReactElement } from "react";
4
+
5
+ //#region src/site/AnalyticsScripts.d.ts
6
+ interface AnalyticsScriptsProps {
7
+ /** Resolved server-side, by `getTrackerConfig` or the tracker endpoint. */
8
+ config: TrackerConfig;
9
+ /**
10
+ * The visitor's decision when the server knows it: opened slots render and boot open, closed ones
11
+ * render nothing. Omitted, every held slot waits for `setGate` in the browser.
12
+ */
13
+ gate?: GateState;
14
+ /**
15
+ * `false` renders no vendor snippet and has the tracker inject none either, for a consent
16
+ * manager that loads the vendor SDKs itself. Default true.
17
+ */
18
+ snippets?: boolean;
19
+ /** CSP nonce, applied to every script this renders and the tracker injects. */
20
+ nonce?: string;
21
+ }
22
+ /**
23
+ * Renders each boot-open slot's snippet, then boots the tracker; a held slot's snippet is injected
24
+ * once `setGate` opens it. A draft page renders none while `capture.skip.previews` is on.
25
+ */
26
+ declare const AnalyticsScripts: ({
27
+ config,
28
+ gate,
29
+ snippets,
30
+ nonce
31
+ }: AnalyticsScriptsProps) => ReactElement;
32
+ //#endregion
33
+ export { AnalyticsScripts, AnalyticsScriptsProps };
34
+ //# sourceMappingURL=AnalyticsScripts.d.ts.map
@@ -0,0 +1,30 @@
1
+ import { skipsDraft } from "../tracker/skip.js";
2
+ import { openAtBoot } from "../tracker/gate.js";
3
+ import { TrackerBoot } from "../react/TrackerBoot.js";
4
+ import { Fragment, jsx, jsxs } from "react/jsx-runtime";
5
+ //#region src/site/AnalyticsScripts.tsx
6
+ /**
7
+ * Renders each boot-open slot's snippet, then boots the tracker; a held slot's snippet is injected
8
+ * once `setGate` opens it. A draft page renders none while `capture.skip.previews` is on.
9
+ */
10
+ const AnalyticsScripts = ({ config, gate, snippets = true, nonce }) => {
11
+ const rendersSnippets = snippets && !skipsDraft(config);
12
+ return /* @__PURE__ */ jsxs(Fragment, { children: [config.slots.flatMap((slot) => rendersSnippets && openAtBoot(slot, gate) ? slot.snippet.scripts.map((script, index) => /* @__PURE__ */ jsx("script", {
13
+ ...script.attrs,
14
+ async: script.async,
15
+ defer: script.defer,
16
+ dangerouslySetInnerHTML: script.inline ? { __html: script.inline } : void 0,
17
+ nonce,
18
+ src: script.inline ? void 0 : script.src,
19
+ type: script.type
20
+ }, `${slot.slot}-${index}`)) : []), /* @__PURE__ */ jsx(TrackerBoot, {
21
+ config,
22
+ gate,
23
+ nonce,
24
+ snippets
25
+ })] });
26
+ };
27
+ //#endregion
28
+ export { AnalyticsScripts };
29
+
30
+ //# sourceMappingURL=AnalyticsScripts.js.map