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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (1273) hide show
  1. package/CHANGELOG.md +780 -0
  2. package/LICENSE +21 -21
  3. package/README.md +35 -36
  4. package/dist/access/adminUser.d.ts +15 -0
  5. package/dist/access/adminUser.js +13 -0
  6. package/dist/access/adminUser.js.map +1 -0
  7. package/dist/access/decideOnce.js +16 -0
  8. package/dist/access/decideOnce.js.map +1 -0
  9. package/dist/access/membership.d.ts +23 -0
  10. package/dist/access/membership.js +63 -0
  11. package/dist/access/membership.js.map +1 -0
  12. package/dist/access/principal.d.ts +37 -0
  13. package/dist/access/principal.js +29 -0
  14. package/dist/access/principal.js.map +1 -0
  15. package/dist/access/readGate.js +16 -0
  16. package/dist/access/readGate.js.map +1 -0
  17. package/dist/adapters/ga4/disableKey.js +19 -0
  18. package/dist/adapters/ga4/disableKey.js.map +1 -0
  19. package/dist/adapters/ga4/eventName.d.ts +9 -0
  20. package/dist/adapters/ga4/eventName.js +13 -0
  21. package/dist/adapters/ga4/eventName.js.map +1 -0
  22. package/dist/adapters/ga4/ga4.d.ts +29 -0
  23. package/dist/adapters/ga4/ga4.js +324 -112
  24. package/dist/adapters/ga4/ga4.js.map +1 -1
  25. package/dist/adapters/ga4/measurementId.js +14 -0
  26. package/dist/adapters/ga4/measurementId.js.map +1 -0
  27. package/dist/adapters/goalRead.js +112 -0
  28. package/dist/adapters/goalRead.js.map +1 -0
  29. package/dist/adapters/http/baseUrl.js +15 -0
  30. package/dist/adapters/http/baseUrl.js.map +1 -0
  31. package/dist/adapters/http/fetchJson.d.ts +19 -0
  32. package/dist/adapters/http/fetchJson.js +27 -8
  33. package/dist/adapters/http/fetchJson.js.map +1 -1
  34. package/dist/adapters/mapping.js +52 -0
  35. package/dist/adapters/mapping.js.map +1 -0
  36. package/dist/adapters/plausible/plausible.d.ts +30 -3
  37. package/dist/adapters/plausible/plausible.js +198 -110
  38. package/dist/adapters/plausible/plausible.js.map +1 -1
  39. package/dist/adapters/plausible/scriptId.js +19 -0
  40. package/dist/adapters/plausible/scriptId.js.map +1 -0
  41. package/dist/adapters/posthog/posthog.d.ts +33 -9
  42. package/dist/adapters/posthog/posthog.js +307 -127
  43. package/dist/adapters/posthog/posthog.js.map +1 -1
  44. package/dist/adapters/posthog/projectCheck.js +56 -0
  45. package/dist/adapters/posthog/projectCheck.js.map +1 -0
  46. package/dist/adapters/readTime.js +7 -0
  47. package/dist/adapters/readTime.js.map +1 -0
  48. package/dist/adapters/series.js +14 -8
  49. package/dist/adapters/series.js.map +1 -1
  50. package/dist/adapters/umami/umami.d.ts +21 -3
  51. package/dist/adapters/umami/umami.js +334 -95
  52. package/dist/adapters/umami/umami.js.map +1 -1
  53. package/dist/adapters/upstream.js +16 -0
  54. package/dist/adapters/upstream.js.map +1 -0
  55. package/dist/binding/report.d.ts +8 -0
  56. package/dist/binding/report.js +24 -0
  57. package/dist/binding/report.js.map +1 -0
  58. package/dist/binding/resolvePath.js +28 -25
  59. package/dist/binding/resolvePath.js.map +1 -1
  60. package/dist/binding/types.d.ts +14 -29
  61. package/dist/capture/captureRequest.js +28 -0
  62. package/dist/capture/captureRequest.js.map +1 -0
  63. package/dist/capture/exclusionEndpoint.js +98 -0
  64. package/dist/capture/exclusionEndpoint.js.map +1 -0
  65. package/dist/capture/exclusionPrelude.js +14 -0
  66. package/dist/capture/exclusionPrelude.js.map +1 -0
  67. package/dist/capture/exclusionToken.js +23 -0
  68. package/dist/capture/exclusionToken.js.map +1 -0
  69. package/dist/capture/jsLiteral.js +19 -0
  70. package/dist/capture/jsLiteral.js.map +1 -0
  71. package/dist/capture/mountPath.js +2 -3
  72. package/dist/capture/mountPath.js.map +1 -1
  73. package/dist/capture/proxyEndpoint.js +49 -92
  74. package/dist/capture/proxyEndpoint.js.map +1 -1
  75. package/dist/capture/proxyRoutes.js +58 -21
  76. package/dist/capture/proxyRoutes.js.map +1 -1
  77. package/dist/capture/relay.js +91 -0
  78. package/dist/capture/relay.js.map +1 -0
  79. package/dist/capture/requestBody.js +2 -6
  80. package/dist/capture/requestBody.js.map +1 -1
  81. package/dist/capture/requestTrust.js +45 -0
  82. package/dist/capture/requestTrust.js.map +1 -0
  83. package/dist/capture/sameSite.js +40 -0
  84. package/dist/capture/sameSite.js.map +1 -0
  85. package/dist/capture/slots.js +50 -25
  86. package/dist/capture/slots.js.map +1 -1
  87. package/dist/capture/trackerConfig.js +131 -36
  88. package/dist/capture/trackerConfig.js.map +1 -1
  89. package/dist/capture/trackerEndpoint.js +22 -21
  90. package/dist/capture/trackerEndpoint.js.map +1 -1
  91. package/dist/capture/withoutConsent.js +91 -0
  92. package/dist/capture/withoutConsent.js.map +1 -0
  93. package/dist/charts/BarList.d.ts +27 -13
  94. package/dist/charts/BarList.js +38 -77
  95. package/dist/charts/BarList.js.map +1 -1
  96. package/dist/charts/TrendChart.d.ts +40 -7
  97. package/dist/charts/TrendChart.js +243 -215
  98. package/dist/charts/TrendChart.js.map +1 -1
  99. package/dist/charts/bars.d.ts +17 -1
  100. package/dist/charts/bars.js +12 -11
  101. package/dist/charts/bars.js.map +1 -1
  102. package/dist/charts/bucket.js +106 -73
  103. package/dist/charts/bucket.js.map +1 -1
  104. package/dist/charts/inProgress.js +22 -0
  105. package/dist/charts/inProgress.js.map +1 -0
  106. package/dist/charts/series.d.ts +15 -0
  107. package/dist/charts/series.js +123 -0
  108. package/dist/charts/series.js.map +1 -0
  109. package/dist/charts/spline.js +91 -25
  110. package/dist/charts/spline.js.map +1 -1
  111. package/dist/charts/trendGeometry.js +91 -0
  112. package/dist/charts/trendGeometry.js.map +1 -0
  113. package/dist/core/adminOptions.d.ts +1 -0
  114. package/dist/core/adminOptions.js +198 -0
  115. package/dist/core/adminOptions.js.map +1 -0
  116. package/dist/core/budget.js +24 -0
  117. package/dist/core/budget.js.map +1 -0
  118. package/dist/core/cacheKey.d.ts +1 -0
  119. package/dist/core/cacheKey.js +51 -29
  120. package/dist/core/cacheKey.js.map +1 -1
  121. package/dist/core/cacheOptions.js +165 -0
  122. package/dist/core/cacheOptions.js.map +1 -0
  123. package/dist/core/capabilities.d.ts +24 -11
  124. package/dist/core/capabilities.js +101 -17
  125. package/dist/core/capabilities.js.map +1 -1
  126. package/dist/core/capture.d.ts +59 -26
  127. package/dist/core/captureOptions.d.ts +1 -0
  128. package/dist/core/captureOptions.js +347 -0
  129. package/dist/core/captureOptions.js.map +1 -0
  130. package/dist/core/clock.js +13 -0
  131. package/dist/core/clock.js.map +1 -0
  132. package/dist/core/collectionOption.d.ts +17 -0
  133. package/dist/core/collectionOption.js +105 -0
  134. package/dist/core/collectionOption.js.map +1 -0
  135. package/dist/core/collectionSlug.js +7 -0
  136. package/dist/core/collectionSlug.js.map +1 -0
  137. package/dist/core/contract.d.ts +340 -49
  138. package/dist/core/contract.js +7 -4
  139. package/dist/core/contract.js.map +1 -1
  140. package/dist/core/cron.js +57 -0
  141. package/dist/core/cron.js.map +1 -0
  142. package/dist/core/fetch.d.ts +17 -0
  143. package/dist/core/goalOptions.d.ts +1 -0
  144. package/dist/core/goalOptions.js +166 -0
  145. package/dist/core/goalOptions.js.map +1 -0
  146. package/dist/core/granularity.js +3 -2
  147. package/dist/core/granularity.js.map +1 -1
  148. package/dist/core/guards.js +17 -0
  149. package/dist/core/guards.js.map +1 -0
  150. package/dist/core/jobs.d.ts +40 -0
  151. package/dist/core/jobs.js +132 -0
  152. package/dist/core/jobs.js.map +1 -0
  153. package/dist/core/legacyOptions.js +145 -0
  154. package/dist/core/legacyOptions.js.map +1 -0
  155. package/dist/core/metricAliases.js +81 -0
  156. package/dist/core/metricAliases.js.map +1 -0
  157. package/dist/core/metricValues.js +57 -0
  158. package/dist/core/metricValues.js.map +1 -0
  159. package/dist/core/monotonic.js +10 -0
  160. package/dist/core/monotonic.js.map +1 -0
  161. package/dist/core/optionChecks.js +51 -0
  162. package/dist/core/optionChecks.js.map +1 -0
  163. package/dist/core/options.d.ts +535 -151
  164. package/dist/core/options.js +158 -214
  165. package/dist/core/options.js.map +1 -1
  166. package/dist/core/registry.js +45 -5
  167. package/dist/core/registry.js.map +1 -1
  168. package/dist/core/scopeList.js +7 -9
  169. package/dist/core/scopeList.js.map +1 -1
  170. package/dist/core/scopeOptions.d.ts +1 -0
  171. package/dist/core/scopeOptions.js +114 -0
  172. package/dist/core/scopeOptions.js.map +1 -0
  173. package/dist/core/scopedRead.js +349 -36
  174. package/dist/core/scopedRead.js.map +1 -1
  175. package/dist/core/sdks.d.ts +81 -0
  176. package/dist/core/sdks.js +23 -0
  177. package/dist/core/sdks.js.map +1 -0
  178. package/dist/core/serverEvent.d.ts +50 -14
  179. package/dist/core/serverEvent.js.map +1 -1
  180. package/dist/core/siteAddress.js +20 -0
  181. package/dist/core/siteAddress.js.map +1 -0
  182. package/dist/core/sourceErrors.js +109 -0
  183. package/dist/core/sourceErrors.js.map +1 -0
  184. package/dist/core/sourceLabel.d.ts +10 -0
  185. package/dist/core/sourceLabel.js +63 -0
  186. package/dist/core/sourceLabel.js.map +1 -0
  187. package/dist/core/sourceOptions.js +107 -0
  188. package/dist/core/sourceOptions.js.map +1 -0
  189. package/dist/core/sourcePolicy.d.ts +55 -0
  190. package/dist/core/sourcePolicy.js +51 -0
  191. package/dist/core/sourcePolicy.js.map +1 -0
  192. package/dist/core/throttle.js +18 -0
  193. package/dist/core/throttle.js.map +1 -0
  194. package/dist/core/values.js +61 -0
  195. package/dist/core/values.js.map +1 -0
  196. package/dist/core/widgetSlugs.d.ts +17 -0
  197. package/dist/core/widgetSlugs.js +29 -0
  198. package/dist/core/widgetSlugs.js.map +1 -0
  199. package/dist/db/detachedWrite.js +36 -0
  200. package/dist/db/detachedWrite.js.map +1 -0
  201. package/dist/db/errors.js +182 -0
  202. package/dist/db/errors.js.map +1 -0
  203. package/dist/db/kind.js +32 -0
  204. package/dist/db/kind.js.map +1 -0
  205. package/dist/db/openTransaction.js +51 -0
  206. package/dist/db/openTransaction.js.map +1 -0
  207. package/dist/exports/adapters/contract.d.ts +15 -0
  208. package/dist/exports/adapters/ga4.d.ts +17 -1
  209. package/dist/exports/adapters/ga4.js +2 -1
  210. package/dist/exports/adapters/native.d.ts +29 -2
  211. package/dist/exports/adapters/native.js +5 -1
  212. package/dist/exports/adapters/plausible.d.ts +16 -1
  213. package/dist/exports/adapters/posthog.d.ts +16 -1
  214. package/dist/exports/adapters/umami.d.ts +16 -1
  215. package/dist/exports/attributes.d.ts +42 -0
  216. package/dist/exports/attributes.js +83 -0
  217. package/dist/exports/attributes.js.map +1 -0
  218. package/dist/exports/client.d.ts +45 -11
  219. package/dist/exports/client.js +23 -6
  220. package/dist/exports/geo.d.ts +4 -2
  221. package/dist/exports/geo.js +1 -1
  222. package/dist/exports/i18n.d.ts +2 -2
  223. package/dist/exports/i18n.js +2 -2
  224. package/dist/exports/migrations.d.ts +2 -0
  225. package/dist/exports/migrations.js +2 -0
  226. package/dist/exports/react.d.ts +5 -3
  227. package/dist/exports/react.js +1 -2
  228. package/dist/exports/routes.d.ts +19 -0
  229. package/dist/exports/routes.js +3 -0
  230. package/dist/exports/rsc.d.ts +33 -14
  231. package/dist/exports/rsc.js +11 -6
  232. package/dist/exports/site.d.ts +5 -0
  233. package/dist/exports/site.js +3 -0
  234. package/dist/exports/testing.d.ts +18 -0
  235. package/dist/exports/testing.js +3 -0
  236. package/dist/exports/tracker.d.ts +6 -17
  237. package/dist/exports/tracker.js +3 -11
  238. package/dist/exports/types.d.ts +46 -14
  239. package/dist/exports/types.js +7 -1
  240. package/dist/fields/AnalyticsPanelClient.js +265 -154
  241. package/dist/fields/AnalyticsPanelClient.js.map +1 -1
  242. package/dist/fields/AnalyticsPanelField.d.ts +19 -7
  243. package/dist/fields/AnalyticsPanelField.js +123 -30
  244. package/dist/fields/AnalyticsPanelField.js.map +1 -1
  245. package/dist/fields/AnalyticsStatField.d.ts +17 -6
  246. package/dist/fields/AnalyticsStatField.js +98 -63
  247. package/dist/fields/AnalyticsStatField.js.map +1 -1
  248. package/dist/fields/FieldShimmer.js +15 -0
  249. package/dist/fields/FieldShimmer.js.map +1 -0
  250. package/dist/fields/PanelContent.js +222 -0
  251. package/dist/fields/PanelContent.js.map +1 -0
  252. package/dist/fields/PanelList.js +82 -0
  253. package/dist/fields/PanelList.js.map +1 -0
  254. package/dist/fields/PanelLiveCounter.js +63 -0
  255. package/dist/fields/PanelLiveCounter.js.map +1 -0
  256. package/dist/fields/PanelSkeleton.js +63 -0
  257. package/dist/fields/PanelSkeleton.js.map +1 -0
  258. package/dist/fields/componentPaths.js +8 -0
  259. package/dist/fields/componentPaths.js.map +1 -0
  260. package/dist/fields/config/FilterDimensionSelectField.d.ts +14 -0
  261. package/dist/fields/config/FilterDimensionSelectField.js +49 -0
  262. package/dist/fields/config/FilterDimensionSelectField.js.map +1 -0
  263. package/dist/fields/config/FilterKeySelect.js +66 -0
  264. package/dist/fields/config/FilterKeySelect.js.map +1 -0
  265. package/dist/fields/config/FilterOperatorSelectField.d.ts +19 -0
  266. package/dist/fields/config/FilterOperatorSelectField.js +59 -0
  267. package/dist/fields/config/FilterOperatorSelectField.js.map +1 -0
  268. package/dist/fields/config/FilterValueField.d.ts +17 -0
  269. package/dist/fields/config/FilterValueField.js +130 -0
  270. package/dist/fields/config/FilterValueField.js.map +1 -0
  271. package/dist/fields/config/MetricSelectField.d.ts +5 -12
  272. package/dist/fields/config/MetricSelectField.js +19 -31
  273. package/dist/fields/config/MetricSelectField.js.map +1 -1
  274. package/dist/fields/config/OptionSelect.js +52 -0
  275. package/dist/fields/config/OptionSelect.js.map +1 -0
  276. package/dist/fields/config/SourceSelectField.js +16 -31
  277. package/dist/fields/config/SourceSelectField.js.map +1 -1
  278. package/dist/fields/config/fetchSources.d.ts +3 -0
  279. package/dist/fields/config/fetchSources.js +17 -23
  280. package/dist/fields/config/fetchSources.js.map +1 -1
  281. package/dist/fields/config/filterValues.js +106 -0
  282. package/dist/fields/config/filterValues.js.map +1 -0
  283. package/dist/fields/config/narrow.js +8 -10
  284. package/dist/fields/config/narrow.js.map +1 -1
  285. package/dist/fields/config/retiredPickers.d.ts +45 -0
  286. package/dist/fields/config/retiredPickers.js +46 -0
  287. package/dist/fields/config/retiredPickers.js.map +1 -0
  288. package/dist/fields/config/scopedFields.d.ts +40 -0
  289. package/dist/fields/config/scopedFields.js +68 -0
  290. package/dist/fields/config/scopedFields.js.map +1 -0
  291. package/dist/fields/config/sourcesState.js +19 -3
  292. package/dist/fields/config/sourcesState.js.map +1 -1
  293. package/dist/fields/config/toSelectOption.js +13 -7
  294. package/dist/fields/config/toSelectOption.js.map +1 -1
  295. package/dist/fields/config/useAnalyticsSources.d.ts +10 -7
  296. package/dist/fields/config/useAnalyticsSources.js +23 -24
  297. package/dist/fields/config/useAnalyticsSources.js.map +1 -1
  298. package/dist/fields/config/useFilterCapabilities.d.ts +31 -0
  299. package/dist/fields/config/useFilterCapabilities.js +60 -0
  300. package/dist/fields/config/useFilterCapabilities.js.map +1 -0
  301. package/dist/fields/config/useFormString.js +12 -0
  302. package/dist/fields/config/useFormString.js.map +1 -0
  303. package/dist/fields/dateRange/field.js +7 -19
  304. package/dist/fields/dateRange/field.js.map +1 -1
  305. package/dist/fields/dateRange/types.d.ts +5 -1
  306. package/dist/fields/dateRange/ui.d.ts +3 -2
  307. package/dist/fields/dateRange/ui.js +57 -319
  308. package/dist/fields/dateRange/ui.js.map +1 -1
  309. package/dist/fields/documentScope.js +21 -0
  310. package/dist/fields/documentScope.js.map +1 -0
  311. package/dist/fields/emptyState.js +30 -26
  312. package/dist/fields/emptyState.js.map +1 -1
  313. package/dist/fields/factories.d.ts +35 -16
  314. package/dist/fields/factories.js +67 -38
  315. package/dist/fields/factories.js.map +1 -1
  316. package/dist/fields/format.d.ts +12 -3
  317. package/dist/fields/format.js +77 -13
  318. package/dist/fields/format.js.map +1 -1
  319. package/dist/fields/itemReport.js +45 -0
  320. package/dist/fields/itemReport.js.map +1 -0
  321. package/dist/fields/readForDocument.d.ts +79 -26
  322. package/dist/fields/readForDocument.js +451 -105
  323. package/dist/fields/readForDocument.js.map +1 -1
  324. package/dist/fields/stateKeys.js +20 -0
  325. package/dist/fields/stateKeys.js.map +1 -0
  326. package/dist/goals/GoalAmountField.d.ts +10 -0
  327. package/dist/goals/GoalAmountField.js +179 -0
  328. package/dist/goals/GoalAmountField.js.map +1 -0
  329. package/dist/goals/GoalSelectField.js +89 -40
  330. package/dist/goals/GoalSelectField.js.map +1 -1
  331. package/dist/goals/GoalSelectFieldServer.d.ts +13 -0
  332. package/dist/goals/GoalSelectFieldServer.js +21 -0
  333. package/dist/goals/GoalSelectFieldServer.js.map +1 -0
  334. package/dist/goals/amountField.d.ts +20 -0
  335. package/dist/goals/amountField.js +37 -0
  336. package/dist/goals/amountField.js.map +1 -0
  337. package/dist/goals/builtin.js +17 -0
  338. package/dist/goals/builtin.js.map +1 -0
  339. package/dist/goals/collection.d.ts +22 -0
  340. package/dist/goals/collection.js +143 -124
  341. package/dist/goals/collection.js.map +1 -1
  342. package/dist/goals/constants.d.ts +38 -0
  343. package/dist/goals/constants.js +49 -0
  344. package/dist/goals/constants.js.map +1 -0
  345. package/dist/goals/currency.d.ts +16 -0
  346. package/dist/goals/currency.js +46 -4
  347. package/dist/goals/currency.js.map +1 -1
  348. package/dist/goals/currencyOptions.js +70 -0
  349. package/dist/goals/currencyOptions.js.map +1 -0
  350. package/dist/goals/fetchGoals.d.ts +10 -0
  351. package/dist/goals/fetchGoals.js +12 -22
  352. package/dist/goals/fetchGoals.js.map +1 -1
  353. package/dist/goals/goalField.d.ts +4 -6
  354. package/dist/goals/goalField.js +9 -19
  355. package/dist/goals/goalField.js.map +1 -1
  356. package/dist/goals/goalsEndpoint.js +40 -38
  357. package/dist/goals/goalsEndpoint.js.map +1 -1
  358. package/dist/goals/items.js +35 -0
  359. package/dist/goals/items.js.map +1 -0
  360. package/dist/goals/latent.js +9 -0
  361. package/dist/goals/latent.js.map +1 -0
  362. package/dist/goals/linkFields.d.ts +35 -0
  363. package/dist/goals/linkFields.js +31 -0
  364. package/dist/goals/linkFields.js.map +1 -0
  365. package/dist/goals/match.d.ts +14 -0
  366. package/dist/goals/match.js +67 -46
  367. package/dist/goals/match.js.map +1 -1
  368. package/dist/goals/moneyFields.js +56 -0
  369. package/dist/goals/moneyFields.js.map +1 -0
  370. package/dist/goals/pathMatch.js +122 -0
  371. package/dist/goals/pathMatch.js.map +1 -0
  372. package/dist/goals/placeholder.js +12 -0
  373. package/dist/goals/placeholder.js.map +1 -0
  374. package/dist/goals/resolver.d.ts +3 -3
  375. package/dist/goals/resolver.js +155 -47
  376. package/dist/goals/resolver.js.map +1 -1
  377. package/dist/goals/serverRevenue.d.ts +60 -0
  378. package/dist/goals/serverRevenue.js +41 -0
  379. package/dist/goals/serverRevenue.js.map +1 -0
  380. package/dist/goals/trackGoalAction.d.ts +26 -25
  381. package/dist/goals/trackGoalAction.js +71 -66
  382. package/dist/goals/trackGoalAction.js.map +1 -1
  383. package/dist/goals/types.d.ts +13 -28
  384. package/dist/goals/types.js +1 -1
  385. package/dist/goals/types.js.map +1 -1
  386. package/dist/goals/useAnalyticsGoals.d.ts +6 -5
  387. package/dist/goals/useAnalyticsGoals.js +17 -18
  388. package/dist/goals/useAnalyticsGoals.js.map +1 -1
  389. package/dist/index.d.ts +69 -11
  390. package/dist/index.js +262 -192
  391. package/dist/index.js.map +1 -1
  392. package/dist/items/collectionIdType.js +20 -0
  393. package/dist/items/collectionIdType.js.map +1 -0
  394. package/dist/items/idType.js +31 -0
  395. package/dist/items/idType.js.map +1 -0
  396. package/dist/items/ref.js +73 -0
  397. package/dist/items/ref.js.map +1 -0
  398. package/dist/maintenance/apiTaskState.js +141 -0
  399. package/dist/maintenance/apiTaskState.js.map +1 -0
  400. package/dist/maintenance/heartbeat.js +51 -0
  401. package/dist/maintenance/heartbeat.js.map +1 -0
  402. package/dist/maintenance/lease.d.ts +1 -0
  403. package/dist/maintenance/lease.js +79 -0
  404. package/dist/maintenance/lease.js.map +1 -0
  405. package/dist/maintenance/taskSchedule.js +27 -0
  406. package/dist/maintenance/taskSchedule.js.map +1 -0
  407. package/dist/maintenance/underLease.js +35 -0
  408. package/dist/maintenance/underLease.js.map +1 -0
  409. package/dist/migrations/legacy.d.ts +54 -0
  410. package/dist/migrations/legacy.js +117 -0
  411. package/dist/migrations/legacy.js.map +1 -0
  412. package/dist/migrations/predefined/dropLegacyMongo.d.ts +11 -0
  413. package/dist/migrations/predefined/dropLegacyMongo.js +12 -0
  414. package/dist/migrations/predefined/dropLegacyMongo.js.map +1 -0
  415. package/dist/native/collections/aggregates.js +54 -0
  416. package/dist/native/collections/aggregates.js.map +1 -0
  417. package/dist/native/collections/hits.js +103 -0
  418. package/dist/native/collections/hits.js.map +1 -0
  419. package/dist/native/collections/slugs.d.ts +10 -0
  420. package/dist/native/collections/slugs.js +16 -0
  421. package/dist/native/collections/slugs.js.map +1 -0
  422. package/dist/native/collections/state.js +84 -0
  423. package/dist/native/collections/state.js.map +1 -0
  424. package/dist/native/collections/storeCollection.js +31 -0
  425. package/dist/native/collections/storeCollection.js.map +1 -0
  426. package/dist/native/engine/buckets.d.ts +1 -0
  427. package/dist/native/engine/buckets.js +53 -0
  428. package/dist/native/engine/buckets.js.map +1 -0
  429. package/dist/native/engine/capabilities.js +87 -0
  430. package/dist/native/engine/capabilities.js.map +1 -0
  431. package/dist/native/engine/cost.js +72 -0
  432. package/dist/native/engine/cost.js.map +1 -0
  433. package/dist/native/engine/days.d.ts +1 -0
  434. package/dist/native/engine/days.js +182 -0
  435. package/dist/native/engine/days.js.map +1 -0
  436. package/dist/native/engine/engine.d.ts +1 -0
  437. package/dist/native/engine/engine.js +1627 -0
  438. package/dist/native/engine/engine.js.map +1 -0
  439. package/dist/native/engine/instance.js +58 -0
  440. package/dist/native/engine/instance.js.map +1 -0
  441. package/dist/native/engine/maintenance.d.ts +1 -0
  442. package/dist/native/engine/maintenance.js +677 -0
  443. package/dist/native/engine/maintenance.js.map +1 -0
  444. package/dist/native/engine/merge.js +41 -0
  445. package/dist/native/engine/merge.js.map +1 -0
  446. package/dist/native/engine/nudge.js +26 -0
  447. package/dist/native/engine/nudge.js.map +1 -0
  448. package/dist/native/engine/planner.js +199 -0
  449. package/dist/native/engine/planner.js.map +1 -0
  450. package/dist/native/engine/rebuild.d.ts +22 -0
  451. package/dist/native/engine/rebuild.js +76 -0
  452. package/dist/native/engine/rebuild.js.map +1 -0
  453. package/dist/native/engine/recent.js +17 -0
  454. package/dist/native/engine/recent.js.map +1 -0
  455. package/dist/native/engine/salt.d.ts +1 -0
  456. package/dist/native/engine/salt.js +98 -0
  457. package/dist/native/engine/salt.js.map +1 -0
  458. package/dist/native/engine/siteHosts.d.ts +1 -0
  459. package/dist/native/engine/siteHosts.js +58 -0
  460. package/dist/native/engine/siteHosts.js.map +1 -0
  461. package/dist/native/engine/toHit.js +110 -0
  462. package/dist/native/engine/toHit.js.map +1 -0
  463. package/dist/native/engine/writeBuffer.d.ts +14 -0
  464. package/dist/native/engine/writeBuffer.js +317 -0
  465. package/dist/native/engine/writeBuffer.js.map +1 -0
  466. package/dist/native/geo/composeGeoResolvers.d.ts +1 -0
  467. package/dist/native/geo/composeGeoResolvers.js +5 -2
  468. package/dist/native/geo/composeGeoResolvers.js.map +1 -1
  469. package/dist/native/geo/geoResolver.d.ts +27 -2
  470. package/dist/native/geo/geoResolver.js +42 -6
  471. package/dist/native/geo/geoResolver.js.map +1 -1
  472. package/dist/native/geo/maxmindResolver.d.ts +8 -4
  473. package/dist/native/geo/maxmindResolver.js +20 -16
  474. package/dist/native/geo/maxmindResolver.js.map +1 -1
  475. package/dist/native/geo/resolveGeo.js +31 -0
  476. package/dist/native/geo/resolveGeo.js.map +1 -0
  477. package/dist/native/ingest/bots.d.ts +10 -0
  478. package/dist/native/ingest/bots.js +66 -0
  479. package/dist/native/ingest/bots.js.map +1 -0
  480. package/dist/native/ingest/browser.js +45 -0
  481. package/dist/native/ingest/browser.js.map +1 -0
  482. package/dist/native/ingest/clientIp.js +34 -8
  483. package/dist/native/ingest/clientIp.js.map +1 -1
  484. package/dist/native/ingest/device.js +4 -6
  485. package/dist/native/ingest/device.js.map +1 -1
  486. package/dist/native/ingest/endpoint.d.ts +1 -1
  487. package/dist/native/ingest/endpoint.js +185 -32
  488. package/dist/native/ingest/endpoint.js.map +1 -1
  489. package/dist/native/ingest/itemSignature.d.ts +26 -0
  490. package/dist/native/ingest/itemSignature.js +45 -0
  491. package/dist/native/ingest/itemSignature.js.map +1 -0
  492. package/dist/native/ingest/language.js +13 -0
  493. package/dist/native/ingest/language.js.map +1 -0
  494. package/dist/native/ingest/normalizeEvent.d.ts +73 -5
  495. package/dist/native/ingest/normalizeEvent.js +257 -51
  496. package/dist/native/ingest/normalizeEvent.js.map +1 -1
  497. package/dist/native/ingest/orderSignature.d.ts +13 -0
  498. package/dist/native/ingest/orderSignature.js +50 -0
  499. package/dist/native/ingest/orderSignature.js.map +1 -0
  500. package/dist/native/ingest/referrer.js +46 -0
  501. package/dist/native/ingest/referrer.js.map +1 -0
  502. package/dist/native/ingest/requestHost.js +44 -0
  503. package/dist/native/ingest/requestHost.js.map +1 -0
  504. package/dist/native/ingest/resolveHostname.d.ts +20 -0
  505. package/dist/native/ingest/resolveHostname.js +51 -0
  506. package/dist/native/ingest/resolveHostname.js.map +1 -0
  507. package/dist/native/ingest/revenue.d.ts +1 -0
  508. package/dist/native/ingest/revenue.js +121 -0
  509. package/dist/native/ingest/revenue.js.map +1 -0
  510. package/dist/native/ingest/route.d.ts +10 -0
  511. package/dist/native/ingest/route.js +85 -0
  512. package/dist/native/ingest/route.js.map +1 -0
  513. package/dist/native/ingest/serverTrack.d.ts +2 -10
  514. package/dist/native/ingest/serverTrack.js +188 -68
  515. package/dist/native/ingest/serverTrack.js.map +1 -1
  516. package/dist/native/ingest/signature.js +28 -0
  517. package/dist/native/ingest/signature.js.map +1 -0
  518. package/dist/native/ingest/source.d.ts +10 -0
  519. package/dist/native/ingest/source.js +245 -16
  520. package/dist/native/ingest/source.js.map +1 -1
  521. package/dist/native/ingest/utm.js +33 -0
  522. package/dist/native/ingest/utm.js.map +1 -0
  523. package/dist/native/ingest/validate.js +25 -13
  524. package/dist/native/ingest/validate.js.map +1 -1
  525. package/dist/native/ingest/visitorHash.js +6 -8
  526. package/dist/native/ingest/visitorHash.js.map +1 -1
  527. package/dist/native/nativeAdapter.d.ts +128 -9
  528. package/dist/native/nativeAdapter.js +395 -281
  529. package/dist/native/nativeAdapter.js.map +1 -1
  530. package/dist/native/rebuildDays.d.ts +12 -0
  531. package/dist/native/rebuildDays.js +16 -0
  532. package/dist/native/rebuildDays.js.map +1 -0
  533. package/dist/native/store/aggregate.js +450 -0
  534. package/dist/native/store/aggregate.js.map +1 -0
  535. package/dist/native/store/caps.d.ts +18 -0
  536. package/dist/native/store/caps.js +76 -0
  537. package/dist/native/store/caps.js.map +1 -0
  538. package/dist/native/store/chunks.js +34 -0
  539. package/dist/native/store/chunks.js.map +1 -0
  540. package/dist/native/store/columnValues.js +31 -0
  541. package/dist/native/store/columnValues.js.map +1 -0
  542. package/dist/native/store/dialect.js +106 -0
  543. package/dist/native/store/dialect.js.map +1 -0
  544. package/dist/native/store/eventStore.js +44 -0
  545. package/dist/native/store/eventStore.js.map +1 -0
  546. package/dist/native/store/hitRow.js +119 -0
  547. package/dist/native/store/hitRow.js.map +1 -0
  548. package/dist/native/store/hits.js +65 -0
  549. package/dist/native/store/hits.js.map +1 -0
  550. package/dist/native/store/ids.js +105 -0
  551. package/dist/native/store/ids.js.map +1 -0
  552. package/dist/native/store/mongo/aggregatePipelines.js +438 -0
  553. package/dist/native/store/mongo/aggregatePipelines.js.map +1 -0
  554. package/dist/native/store/mongo/mongoState.js +375 -0
  555. package/dist/native/store/mongo/mongoState.js.map +1 -0
  556. package/dist/native/store/mongo/mongoStore.js +618 -0
  557. package/dist/native/store/mongo/mongoStore.js.map +1 -0
  558. package/dist/native/store/mongo/pipelines.js +705 -0
  559. package/dist/native/store/mongo/pipelines.js.map +1 -0
  560. package/dist/native/store/mongo/results.js +20 -0
  561. package/dist/native/store/mongo/results.js.map +1 -0
  562. package/dist/native/store/parts.d.ts +1 -0
  563. package/dist/native/store/parts.js +101 -0
  564. package/dist/native/store/parts.js.map +1 -0
  565. package/dist/native/store/pattern.js +213 -0
  566. package/dist/native/store/pattern.js.map +1 -0
  567. package/dist/native/store/rawRead.d.ts +23 -0
  568. package/dist/native/store/rawRead.js +387 -0
  569. package/dist/native/store/rawRead.js.map +1 -0
  570. package/dist/native/store/reclassify.js +53 -0
  571. package/dist/native/store/reclassify.js.map +1 -0
  572. package/dist/native/store/sql/aggregateSql.js +349 -0
  573. package/dist/native/store/sql/aggregateSql.js.map +1 -0
  574. package/dist/native/store/sql/columns.js +49 -0
  575. package/dist/native/store/sql/columns.js.map +1 -0
  576. package/dist/native/store/sql/compile.js +668 -0
  577. package/dist/native/store/sql/compile.js.map +1 -0
  578. package/dist/native/store/sql/drivers.js +218 -0
  579. package/dist/native/store/sql/drivers.js.map +1 -0
  580. package/dist/native/store/sql/executor.js +132 -0
  581. package/dist/native/store/sql/executor.js.map +1 -0
  582. package/dist/native/store/sql/fragment.js +104 -0
  583. package/dist/native/store/sql/fragment.js.map +1 -0
  584. package/dist/native/store/sql/maintenanceSql.js +59 -0
  585. package/dist/native/store/sql/maintenanceSql.js.map +1 -0
  586. package/dist/native/store/sql/ownConnection.js +107 -0
  587. package/dist/native/store/sql/ownConnection.js.map +1 -0
  588. package/dist/native/store/sql/poolShare.js +101 -0
  589. package/dist/native/store/sql/poolShare.js.map +1 -0
  590. package/dist/native/store/sql/sqlState.js +325 -0
  591. package/dist/native/store/sql/sqlState.js.map +1 -0
  592. package/dist/native/store/sql/sqlStore.js +355 -0
  593. package/dist/native/store/sql/sqlStore.js.map +1 -0
  594. package/dist/native/store/sql/sqliteThread.d.ts +9 -0
  595. package/dist/native/store/sql/sqliteThread.js +314 -0
  596. package/dist/native/store/sql/sqliteThread.js.map +1 -0
  597. package/dist/native/store/sql/sqliteWorker.js +327 -0
  598. package/dist/native/store/sql/sqliteWorker.js.map +1 -0
  599. package/dist/native/store/sql/sqliteWorkerSource.js +347 -0
  600. package/dist/native/store/sql/sqliteWorkerSource.js.map +1 -0
  601. package/dist/native/store/state.js +151 -0
  602. package/dist/native/store/state.js.map +1 -0
  603. package/dist/native/store/stateStore.js +29 -0
  604. package/dist/native/store/stateStore.js.map +1 -0
  605. package/dist/native/store/types.d.ts +15 -0
  606. package/dist/native/store/types.js +10 -0
  607. package/dist/native/store/types.js.map +1 -0
  608. package/dist/native/tasks/maintainTask.d.ts +19 -0
  609. package/dist/native/tasks/maintainTask.js +57 -0
  610. package/dist/native/tasks/maintainTask.js.map +1 -0
  611. package/dist/net/guardedFetch.d.ts +32 -0
  612. package/dist/net/guardedFetch.js +220 -0
  613. package/dist/net/guardedFetch.js.map +1 -0
  614. package/dist/net/origin.js +40 -0
  615. package/dist/net/origin.js.map +1 -0
  616. package/dist/net/platform.d.ts +9 -0
  617. package/dist/net/platform.js +35 -0
  618. package/dist/net/platform.js.map +1 -0
  619. package/dist/plugin/adminDependencies.js +34 -0
  620. package/dist/plugin/adminDependencies.js.map +1 -0
  621. package/dist/plugin/apiPath.js +23 -0
  622. package/dist/plugin/apiPath.js.map +1 -0
  623. package/dist/plugin/boundDocument.js +58 -0
  624. package/dist/plugin/boundDocument.js.map +1 -0
  625. package/dist/plugin/buildPhase.js +10 -0
  626. package/dist/plugin/buildPhase.js.map +1 -0
  627. package/dist/plugin/collectionChecks.js +232 -0
  628. package/dist/plugin/collectionChecks.js.map +1 -0
  629. package/dist/plugin/collectionFields.d.ts +13 -0
  630. package/dist/plugin/collectionFields.js +22 -0
  631. package/dist/plugin/collectionFields.js.map +1 -0
  632. package/dist/plugin/createRuntime.js +346 -0
  633. package/dist/plugin/createRuntime.js.map +1 -0
  634. package/dist/plugin/destroy.js +58 -0
  635. package/dist/plugin/destroy.js.map +1 -0
  636. package/dist/plugin/documentEndpoint.js +106 -53
  637. package/dist/plugin/documentEndpoint.js.map +1 -1
  638. package/dist/plugin/documentScopes.js +37 -0
  639. package/dist/plugin/documentScopes.js.map +1 -0
  640. package/dist/plugin/encrypted.js +25 -0
  641. package/dist/plugin/encrypted.js.map +1 -0
  642. package/dist/plugin/errors.d.ts +24 -0
  643. package/dist/plugin/errors.js +86 -0
  644. package/dist/plugin/errors.js.map +1 -0
  645. package/dist/plugin/flagsEndpoint.js +41 -0
  646. package/dist/plugin/flagsEndpoint.js.map +1 -0
  647. package/dist/plugin/goalHint.d.ts +1 -0
  648. package/dist/plugin/goalHint.js +35 -0
  649. package/dist/plugin/goalHint.js.map +1 -0
  650. package/dist/plugin/itemLabels.js +114 -0
  651. package/dist/plugin/itemLabels.js.map +1 -0
  652. package/dist/plugin/keepAlive.js +48 -0
  653. package/dist/plugin/keepAlive.js.map +1 -0
  654. package/dist/plugin/peerImportError.js +3 -6
  655. package/dist/plugin/peerImportError.js.map +1 -1
  656. package/dist/plugin/peers.js +64 -0
  657. package/dist/plugin/peers.js.map +1 -0
  658. package/dist/plugin/pluginCollections.js +161 -0
  659. package/dist/plugin/pluginCollections.js.map +1 -0
  660. package/dist/plugin/queryEndpoint.js +88 -52
  661. package/dist/plugin/queryEndpoint.js.map +1 -1
  662. package/dist/plugin/queryParams.js +7 -0
  663. package/dist/plugin/queryParams.js.map +1 -0
  664. package/dist/plugin/readContextForRequest.d.ts +11 -0
  665. package/dist/plugin/readContextForRequest.js +79 -32
  666. package/dist/plugin/readContextForRequest.js.map +1 -1
  667. package/dist/plugin/readFailure.js +22 -0
  668. package/dist/plugin/readFailure.js.map +1 -0
  669. package/dist/plugin/readableProviders.js +67 -0
  670. package/dist/plugin/readableProviders.js.map +1 -0
  671. package/dist/plugin/realtimeEndpoint.js +91 -21
  672. package/dist/plugin/realtimeEndpoint.js.map +1 -1
  673. package/dist/plugin/refreshEndpoint.js +138 -0
  674. package/dist/plugin/refreshEndpoint.js.map +1 -0
  675. package/dist/plugin/relabelFields.js +36 -0
  676. package/dist/plugin/relabelFields.js.map +1 -0
  677. package/dist/plugin/requestMemo.js +35 -0
  678. package/dist/plugin/requestMemo.js.map +1 -0
  679. package/dist/plugin/routeChecks.js +39 -0
  680. package/dist/plugin/routeChecks.js.map +1 -0
  681. package/dist/plugin/routes.d.ts +53 -0
  682. package/dist/plugin/routes.js +92 -0
  683. package/dist/plugin/routes.js.map +1 -0
  684. package/dist/plugin/runtime.d.ts +1 -1
  685. package/dist/plugin/runtime.js +235 -29
  686. package/dist/plugin/runtime.js.map +1 -1
  687. package/dist/plugin/schemaOnly.js +61 -0
  688. package/dist/plugin/schemaOnly.js.map +1 -0
  689. package/dist/plugin/scopeChange.js +23 -0
  690. package/dist/plugin/scopeChange.js.map +1 -0
  691. package/dist/plugin/scopeFieldBoot.js +4 -4
  692. package/dist/plugin/scopeFieldBoot.js.map +1 -1
  693. package/dist/plugin/scopeToken.js +33 -0
  694. package/dist/plugin/scopeToken.js.map +1 -0
  695. package/dist/plugin/sourcesEndpoint.js +50 -16
  696. package/dist/plugin/sourcesEndpoint.js.map +1 -1
  697. package/dist/plugin/unbundledLanguages.js +25 -0
  698. package/dist/plugin/unbundledLanguages.js.map +1 -0
  699. package/dist/plugin/walkFields.js +24 -0
  700. package/dist/plugin/walkFields.js.map +1 -0
  701. package/dist/plugin/warmTask.js +0 -0
  702. package/dist/plugin/warmTask.js.map +1 -1
  703. package/dist/providers/ProvidersListNotice.d.ts +11 -0
  704. package/dist/providers/ProvidersListNotice.js +36 -0
  705. package/dist/providers/ProvidersListNotice.js.map +1 -0
  706. package/dist/providers/access.d.ts +1 -0
  707. package/dist/providers/access.js +35 -26
  708. package/dist/providers/access.js.map +1 -1
  709. package/dist/providers/adapterPool.js +121 -0
  710. package/dist/providers/adapterPool.js.map +1 -0
  711. package/dist/providers/collection.d.ts +63 -0
  712. package/dist/providers/collection.js +372 -143
  713. package/dist/providers/collection.js.map +1 -1
  714. package/dist/providers/factory.d.ts +84 -0
  715. package/dist/providers/factory.js +86 -25
  716. package/dist/providers/factory.js.map +1 -1
  717. package/dist/providers/hosts.d.ts +25 -0
  718. package/dist/providers/hosts.js +128 -0
  719. package/dist/providers/hosts.js.map +1 -0
  720. package/dist/providers/probe.d.ts +1 -0
  721. package/dist/providers/probe.js +105 -0
  722. package/dist/providers/probe.js.map +1 -0
  723. package/dist/providers/refresh.d.ts +18 -0
  724. package/dist/providers/refresh.js +49 -0
  725. package/dist/providers/refresh.js.map +1 -0
  726. package/dist/providers/registry.js +329 -0
  727. package/dist/providers/registry.js.map +1 -0
  728. package/dist/providers/resolver.js +26 -88
  729. package/dist/providers/resolver.js.map +1 -1
  730. package/dist/providers/retarget.js +45 -0
  731. package/dist/providers/retarget.js.map +1 -0
  732. package/dist/providers/scopeUnique.js +41 -0
  733. package/dist/providers/scopeUnique.js.map +1 -0
  734. package/dist/providers/secrets.d.ts +26 -0
  735. package/dist/providers/secrets.js +61 -4
  736. package/dist/providers/secrets.js.map +1 -1
  737. package/dist/providers/stampScope.js +9 -6
  738. package/dist/providers/stampScope.js.map +1 -1
  739. package/dist/query/dates.js +10 -12
  740. package/dist/query/dates.js.map +1 -1
  741. package/dist/query/errors.d.ts +6 -13
  742. package/dist/query/fetchQuery.d.ts +36 -23
  743. package/dist/query/fetchQuery.js +96 -89
  744. package/dist/query/fetchQuery.js.map +1 -1
  745. package/dist/query/limits.js +8 -0
  746. package/dist/query/limits.js.map +1 -0
  747. package/dist/query/parse.d.ts +8 -2
  748. package/dist/query/parse.js +155 -108
  749. package/dist/query/parse.js.map +1 -1
  750. package/dist/query/response.d.ts +27 -4
  751. package/dist/query/response.js +18 -0
  752. package/dist/query/response.js.map +1 -0
  753. package/dist/react/AnalyticsProvider.d.ts +42 -20
  754. package/dist/react/AnalyticsProvider.js +24 -22
  755. package/dist/react/AnalyticsProvider.js.map +1 -1
  756. package/dist/react/TrackerBoot.js +15 -9
  757. package/dist/react/TrackerBoot.js.map +1 -1
  758. package/dist/react/useAnalytics.d.ts +2 -8
  759. package/dist/react/useAnalytics.js +31 -13
  760. package/dist/react/useAnalytics.js.map +1 -1
  761. package/dist/routes/captureRoute.d.ts +28 -0
  762. package/dist/routes/captureRoute.js +67 -0
  763. package/dist/routes/captureRoute.js.map +1 -0
  764. package/dist/routes/ingestRoute.d.ts +17 -0
  765. package/dist/routes/ingestRoute.js +17 -0
  766. package/dist/routes/ingestRoute.js.map +1 -0
  767. package/dist/site/AnalyticsScripts.d.ts +35 -0
  768. package/dist/site/AnalyticsScripts.js +44 -0
  769. package/dist/site/AnalyticsScripts.js.map +1 -0
  770. package/dist/site/getTrackerConfig.d.ts +15 -0
  771. package/dist/site/getTrackerConfig.js +43 -0
  772. package/dist/site/getTrackerConfig.js.map +1 -0
  773. package/dist/surfacing/afterRead.d.ts +37 -0
  774. package/dist/surfacing/bounded.js +38 -0
  775. package/dist/surfacing/bounded.js.map +1 -0
  776. package/dist/surfacing/breaker.js +107 -0
  777. package/dist/surfacing/breaker.js.map +1 -0
  778. package/dist/surfacing/cacheCollection.d.ts +8 -0
  779. package/dist/surfacing/cacheCollection.js +71 -0
  780. package/dist/surfacing/cacheCollection.js.map +1 -0
  781. package/dist/surfacing/cacheStore.d.ts +71 -1
  782. package/dist/surfacing/cacheStore.js +16 -37
  783. package/dist/surfacing/cacheStore.js.map +1 -1
  784. package/dist/surfacing/cacheSweep.d.ts +1 -0
  785. package/dist/surfacing/cacheSweep.js +59 -0
  786. package/dist/surfacing/cacheSweep.js.map +1 -0
  787. package/dist/surfacing/classifyError.js +282 -0
  788. package/dist/surfacing/classifyError.js.map +1 -0
  789. package/dist/surfacing/coalesce.js +2 -1
  790. package/dist/surfacing/coalesce.js.map +1 -1
  791. package/dist/surfacing/coldBudget.js +60 -0
  792. package/dist/surfacing/coldBudget.js.map +1 -0
  793. package/dist/surfacing/collectionCacheStore.js +183 -0
  794. package/dist/surfacing/collectionCacheStore.js.map +1 -0
  795. package/dist/surfacing/engine.d.ts +1 -1
  796. package/dist/surfacing/engine.js +514 -71
  797. package/dist/surfacing/engine.js.map +1 -1
  798. package/dist/surfacing/epoch.d.ts +1 -0
  799. package/dist/surfacing/epoch.js +116 -0
  800. package/dist/surfacing/epoch.js.map +1 -0
  801. package/dist/surfacing/lanes.d.ts +1 -0
  802. package/dist/surfacing/lanes.js +297 -0
  803. package/dist/surfacing/lanes.js.map +1 -0
  804. package/dist/surfacing/memo.js +40 -0
  805. package/dist/surfacing/memo.js.map +1 -0
  806. package/dist/surfacing/rateLimiter.d.ts +1 -0
  807. package/dist/surfacing/rateLimiter.js +69 -94
  808. package/dist/surfacing/rateLimiter.js.map +1 -1
  809. package/dist/surfacing/rebucket.js +178 -0
  810. package/dist/surfacing/rebucket.js.map +1 -0
  811. package/dist/surfacing/recipe.js +28 -0
  812. package/dist/surfacing/recipe.js.map +1 -0
  813. package/dist/surfacing/shape.js +22 -0
  814. package/dist/surfacing/shape.js.map +1 -0
  815. package/dist/surfacing/todaySplit.js +119 -0
  816. package/dist/surfacing/todaySplit.js.map +1 -0
  817. package/dist/sync/collection.d.ts +8 -0
  818. package/dist/sync/collection.js +30 -18
  819. package/dist/sync/collection.js.map +1 -1
  820. package/dist/sync/rekeyDurations.js +70 -0
  821. package/dist/sync/rekeyDurations.js.map +1 -0
  822. package/dist/sync/syncTask.js +222 -109
  823. package/dist/sync/syncTask.js.map +1 -1
  824. package/dist/testing/memoryAdapter.d.ts +6 -3
  825. package/dist/testing/memoryAdapter.js +12 -11
  826. package/dist/testing/memoryAdapter.js.map +1 -1
  827. package/dist/testing/settle.d.ts +11 -0
  828. package/dist/testing/settle.js +19 -0
  829. package/dist/testing/settle.js.map +1 -0
  830. package/dist/timeframe/calendar.js +65 -0
  831. package/dist/timeframe/calendar.js.map +1 -0
  832. package/dist/timeframe/comparison.js +46 -0
  833. package/dist/timeframe/comparison.js.map +1 -0
  834. package/dist/timeframe/presets.d.ts +1 -1
  835. package/dist/timeframe/presets.js +5 -5
  836. package/dist/timeframe/presets.js.map +1 -1
  837. package/dist/timeframe/reportingTimezone.d.ts +1 -0
  838. package/dist/timeframe/reportingTimezone.js +64 -0
  839. package/dist/timeframe/reportingTimezone.js.map +1 -0
  840. package/dist/timeframe/tz.js +55 -39
  841. package/dist/timeframe/tz.js.map +1 -1
  842. package/dist/tracker/autoCapture.js +125 -38
  843. package/dist/tracker/autoCapture.js.map +1 -1
  844. package/dist/tracker/campaign.js +52 -0
  845. package/dist/tracker/campaign.js.map +1 -0
  846. package/dist/tracker/config.d.ts +174 -0
  847. package/dist/tracker/config.js +25 -0
  848. package/dist/tracker/config.js.map +1 -0
  849. package/dist/tracker/createTracker.d.ts +5 -10
  850. package/dist/tracker/createTracker.js +437 -82
  851. package/dist/tracker/createTracker.js.map +1 -1
  852. package/dist/tracker/digest.js +28 -0
  853. package/dist/tracker/digest.js.map +1 -0
  854. package/dist/tracker/engagement.js +100 -0
  855. package/dist/tracker/engagement.js.map +1 -0
  856. package/dist/tracker/events.js +37 -0
  857. package/dist/tracker/events.js.map +1 -0
  858. package/dist/tracker/exclusion.d.ts +8 -0
  859. package/dist/tracker/exclusion.js +82 -0
  860. package/dist/tracker/exclusion.js.map +1 -0
  861. package/dist/tracker/gate.d.ts +8 -0
  862. package/dist/tracker/gate.js +244 -0
  863. package/dist/tracker/gate.js.map +1 -0
  864. package/dist/tracker/initTracker.d.ts +5 -8
  865. package/dist/tracker/initTracker.js +42 -14
  866. package/dist/tracker/initTracker.js.map +1 -1
  867. package/dist/tracker/itemCapture.js +224 -0
  868. package/dist/tracker/itemCapture.js.map +1 -0
  869. package/dist/tracker/loadScript.js +23 -15
  870. package/dist/tracker/loadScript.js.map +1 -1
  871. package/dist/tracker/pageTracking.js +6 -6
  872. package/dist/tracker/pageTracking.js.map +1 -1
  873. package/dist/tracker/registry.js +129 -30
  874. package/dist/tracker/registry.js.map +1 -1
  875. package/dist/tracker/sinks/createSink.js +60 -0
  876. package/dist/tracker/sinks/createSink.js.map +1 -0
  877. package/dist/tracker/sinks/ga4.js +106 -0
  878. package/dist/tracker/sinks/ga4.js.map +1 -0
  879. package/dist/tracker/sinks/native.js +21 -42
  880. package/dist/tracker/sinks/native.js.map +1 -1
  881. package/dist/tracker/sinks/plausible.js +36 -18
  882. package/dist/tracker/sinks/plausible.js.map +1 -1
  883. package/dist/tracker/sinks/posthog.js +145 -9
  884. package/dist/tracker/sinks/posthog.js.map +1 -1
  885. package/dist/tracker/sinks/umami.js +18 -10
  886. package/dist/tracker/sinks/umami.js.map +1 -1
  887. package/dist/tracker/sinks/vendor.js +54 -22
  888. package/dist/tracker/sinks/vendor.js.map +1 -1
  889. package/dist/tracker/skip.js +81 -0
  890. package/dist/tracker/skip.js.map +1 -0
  891. package/dist/tracker/storage.js +23 -0
  892. package/dist/tracker/storage.js.map +1 -0
  893. package/dist/tracker/transport.js +2 -5
  894. package/dist/tracker/transport.js.map +1 -1
  895. package/dist/tracker/types.d.ts +99 -44
  896. package/dist/tracker/window.js +7 -0
  897. package/dist/tracker/window.js.map +1 -0
  898. package/dist/translations/ar.js +266 -56
  899. package/dist/translations/ar.js.map +1 -1
  900. package/dist/translations/de.js +256 -55
  901. package/dist/translations/de.js.map +1 -1
  902. package/dist/translations/en.js +253 -56
  903. package/dist/translations/en.js.map +1 -1
  904. package/dist/translations/es.js +261 -57
  905. package/dist/translations/es.js.map +1 -1
  906. package/dist/translations/fr.js +265 -61
  907. package/dist/translations/fr.js.map +1 -1
  908. package/dist/translations/id.js +256 -56
  909. package/dist/translations/id.js.map +1 -1
  910. package/dist/translations/index.d.ts +1 -1
  911. package/dist/translations/index.js +5 -7
  912. package/dist/translations/index.js.map +1 -1
  913. package/dist/translations/intl.js +71 -0
  914. package/dist/translations/intl.js.map +1 -0
  915. package/dist/translations/keys.d.ts +240 -14
  916. package/dist/translations/keys.js +245 -14
  917. package/dist/translations/keys.js.map +1 -1
  918. package/dist/translations/ko.js +258 -58
  919. package/dist/translations/ko.js.map +1 -1
  920. package/dist/translations/labelMap.d.ts +10 -0
  921. package/dist/translations/labelMap.js +22 -0
  922. package/dist/translations/labelMap.js.map +1 -0
  923. package/dist/translations/metricKeys.js +16 -2
  924. package/dist/translations/metricKeys.js.map +1 -1
  925. package/dist/translations/parts.js +20 -0
  926. package/dist/translations/parts.js.map +1 -0
  927. package/dist/translations/plural.js +61 -0
  928. package/dist/translations/plural.js.map +1 -0
  929. package/dist/translations/pt.js +270 -66
  930. package/dist/translations/pt.js.map +1 -1
  931. package/dist/translations/ru.js +261 -55
  932. package/dist/translations/ru.js.map +1 -1
  933. package/dist/translations/server.d.ts +1 -0
  934. package/dist/translations/server.js +2 -3
  935. package/dist/translations/server.js.map +1 -1
  936. package/dist/translations/staticLabel.js +69 -0
  937. package/dist/translations/staticLabel.js.map +1 -0
  938. package/dist/translations/uk.js +261 -55
  939. package/dist/translations/uk.js.map +1 -1
  940. package/dist/translations/zh.js +256 -56
  941. package/dist/translations/zh.js.map +1 -1
  942. package/dist/ui/RangePicker.js +110 -0
  943. package/dist/ui/RangePicker.js.map +1 -0
  944. package/dist/ui/analytics.css +1667 -0
  945. package/dist/ui/calendarDays.js +27 -0
  946. package/dist/ui/calendarDays.js.map +1 -0
  947. package/dist/ui/classNames.js +7 -0
  948. package/dist/ui/classNames.js.map +1 -0
  949. package/dist/ui/components/Card.d.ts +28 -0
  950. package/dist/ui/components/Card.js +21 -0
  951. package/dist/ui/components/Card.js.map +1 -0
  952. package/dist/ui/components/ChartDataTable.d.ts +41 -0
  953. package/dist/ui/components/ChartDataTable.js +48 -0
  954. package/dist/ui/components/ChartDataTable.js.map +1 -0
  955. package/dist/ui/components/ChoiceMenu.js +48 -0
  956. package/dist/ui/components/ChoiceMenu.js.map +1 -0
  957. package/dist/ui/components/DataTable.d.ts +82 -0
  958. package/dist/ui/components/DataTable.js +214 -0
  959. package/dist/ui/components/DataTable.js.map +1 -0
  960. package/dist/ui/components/LabeledSelect.js +62 -0
  961. package/dist/ui/components/LabeledSelect.js.map +1 -0
  962. package/dist/ui/components/LiveAnnouncement.js +21 -0
  963. package/dist/ui/components/LiveAnnouncement.js.map +1 -0
  964. package/dist/ui/components/MetricCard.d.ts +38 -0
  965. package/dist/ui/components/MetricCard.js +39 -0
  966. package/dist/ui/components/MetricCard.js.map +1 -0
  967. package/dist/ui/components/NoValue.js +22 -0
  968. package/dist/ui/components/NoValue.js.map +1 -0
  969. package/dist/ui/components/ReadState.js +27 -0
  970. package/dist/ui/components/ReadState.js.map +1 -0
  971. package/dist/ui/components/RefreshButton.js +25 -0
  972. package/dist/ui/components/RefreshButton.js.map +1 -0
  973. package/dist/ui/components/SourcesNoticeBanner.js +20 -0
  974. package/dist/ui/components/SourcesNoticeBanner.js.map +1 -0
  975. package/dist/ui/cssVars.js +7 -0
  976. package/dist/ui/cssVars.js.map +1 -0
  977. package/dist/ui/data/WithScopeToken.d.ts +20 -0
  978. package/dist/ui/data/WithScopeToken.js +20 -0
  979. package/dist/ui/data/WithScopeToken.js.map +1 -0
  980. package/dist/ui/data/clientFieldProps.js +16 -0
  981. package/dist/ui/data/clientFieldProps.js.map +1 -0
  982. package/dist/ui/data/request.d.ts +46 -0
  983. package/dist/ui/data/request.js +119 -0
  984. package/dist/ui/data/request.js.map +1 -0
  985. package/dist/ui/data/scopeTokenContext.js +18 -0
  986. package/dist/ui/data/scopeTokenContext.js.map +1 -0
  987. package/dist/ui/data/sharedCache.js +48 -0
  988. package/dist/ui/data/sharedCache.js.map +1 -0
  989. package/dist/ui/data/useRequest.d.ts +19 -0
  990. package/dist/ui/data/useRequest.js +123 -0
  991. package/dist/ui/data/useRequest.js.map +1 -0
  992. package/dist/ui/data/useRequestScope.js +25 -0
  993. package/dist/ui/data/useRequestScope.js.map +1 -0
  994. package/dist/ui/hooks/useDirection.js +47 -0
  995. package/dist/ui/hooks/useDirection.js.map +1 -0
  996. package/dist/ui/hooks/useDismissOnEscape.js +25 -0
  997. package/dist/ui/hooks/useDismissOnEscape.js.map +1 -0
  998. package/dist/ui/hooks/useLiveAnnouncement.js +57 -0
  999. package/dist/ui/hooks/useLiveAnnouncement.js.map +1 -0
  1000. package/dist/ui/hooks/useRealtimePoll.js +112 -0
  1001. package/dist/ui/hooks/useRealtimePoll.js.map +1 -0
  1002. package/dist/ui/readState.js +19 -0
  1003. package/dist/ui/readState.js.map +1 -0
  1004. package/dist/ui/rows/toDisplayRows.js +49 -0
  1005. package/dist/ui/rows/toDisplayRows.js.map +1 -0
  1006. package/dist/ui/viewerClock.js +7 -0
  1007. package/dist/ui/viewerClock.js.map +1 -0
  1008. package/dist/view/AnalyticsNavLink.d.ts +5 -3
  1009. package/dist/view/AnalyticsNavLink.js +12 -8
  1010. package/dist/view/AnalyticsNavLink.js.map +1 -1
  1011. package/dist/view/AnalyticsView.d.ts +9 -10
  1012. package/dist/view/AnalyticsView.js +47 -19
  1013. package/dist/view/AnalyticsView.js.map +1 -1
  1014. package/dist/view/AnalyticsViewClient.d.ts +4 -7
  1015. package/dist/view/AnalyticsViewClient.js +15 -174
  1016. package/dist/view/AnalyticsViewClient.js.map +1 -1
  1017. package/dist/view/CountryFlag.d.ts +27 -0
  1018. package/dist/view/CountryFlag.js +44 -0
  1019. package/dist/view/CountryFlag.js.map +1 -0
  1020. package/dist/view/DocumentTitle.js +27 -0
  1021. package/dist/view/DocumentTitle.js.map +1 -0
  1022. package/dist/view/ViewRoot.d.ts +21 -0
  1023. package/dist/view/ViewRoot.js +155 -0
  1024. package/dist/view/ViewRoot.js.map +1 -0
  1025. package/dist/view/ViewSections.d.ts +38 -0
  1026. package/dist/view/ViewSections.js +190 -0
  1027. package/dist/view/ViewSections.js.map +1 -0
  1028. package/dist/view/authRedirect.js +2 -4
  1029. package/dist/view/authRedirect.js.map +1 -1
  1030. package/dist/view/consentShare.js +15 -0
  1031. package/dist/view/consentShare.js.map +1 -0
  1032. package/dist/view/conversionRate.js +9 -7
  1033. package/dist/view/conversionRate.js.map +1 -1
  1034. package/dist/view/dayRange.js +6 -10
  1035. package/dist/view/dayRange.js.map +1 -1
  1036. package/dist/view/exclusionLink.d.ts +27 -0
  1037. package/dist/view/exclusionLink.js +46 -0
  1038. package/dist/view/exclusionLink.js.map +1 -0
  1039. package/dist/view/flagSrc.js +14 -0
  1040. package/dist/view/flagSrc.js.map +1 -0
  1041. package/dist/view/gating.d.ts +15 -1
  1042. package/dist/view/gating.js +92 -20
  1043. package/dist/view/gating.js.map +1 -1
  1044. package/dist/view/hostCountryFlag.js +41 -0
  1045. package/dist/view/hostCountryFlag.js.map +1 -0
  1046. package/dist/view/labels.js +120 -3
  1047. package/dist/view/labels.js.map +1 -1
  1048. package/dist/view/metricAliases.js +10 -0
  1049. package/dist/view/metricAliases.js.map +1 -0
  1050. package/dist/view/navLabel.js +15 -0
  1051. package/dist/view/navLabel.js.map +1 -0
  1052. package/dist/view/registerView.js +13 -11
  1053. package/dist/view/registerView.js.map +1 -1
  1054. package/dist/view/scopeLabel.js +21 -0
  1055. package/dist/view/scopeLabel.js.map +1 -0
  1056. package/dist/view/sections/Breakdowns.js +221 -118
  1057. package/dist/view/sections/Breakdowns.js.map +1 -1
  1058. package/dist/view/sections/EmptyStates.js +120 -32
  1059. package/dist/view/sections/EmptyStates.js.map +1 -1
  1060. package/dist/view/sections/ExcludeBrowser.js +188 -0
  1061. package/dist/view/sections/ExcludeBrowser.js.map +1 -0
  1062. package/dist/view/sections/FilterChips.js +130 -25
  1063. package/dist/view/sections/FilterChips.js.map +1 -1
  1064. package/dist/view/sections/GoalsPanel.js +68 -59
  1065. package/dist/view/sections/GoalsPanel.js.map +1 -1
  1066. package/dist/view/sections/OverviewCards.js +42 -36
  1067. package/dist/view/sections/OverviewCards.js.map +1 -1
  1068. package/dist/view/sections/RealtimeStrip.js +70 -56
  1069. package/dist/view/sections/RealtimeStrip.js.map +1 -1
  1070. package/dist/view/sections/SectionBoundary.js +34 -0
  1071. package/dist/view/sections/SectionBoundary.js.map +1 -0
  1072. package/dist/view/sections/Toolbar.d.ts +11 -0
  1073. package/dist/view/sections/Toolbar.js +182 -116
  1074. package/dist/view/sections/Toolbar.js.map +1 -1
  1075. package/dist/view/sections/Trend.js +179 -73
  1076. package/dist/view/sections/Trend.js.map +1 -1
  1077. package/dist/view/state.d.ts +42 -0
  1078. package/dist/view/state.js +97 -53
  1079. package/dist/view/state.js.map +1 -1
  1080. package/dist/view/useViewClock.js +31 -0
  1081. package/dist/view/useViewClock.js.map +1 -0
  1082. package/dist/view/useViewQueries.d.ts +21 -0
  1083. package/dist/view/useViewQueries.js +50 -79
  1084. package/dist/view/useViewQueries.js.map +1 -1
  1085. package/dist/view/useViewState.js +42 -0
  1086. package/dist/view/useViewState.js.map +1 -0
  1087. package/dist/view/useViewUrl.js +52 -0
  1088. package/dist/view/useViewUrl.js.map +1 -0
  1089. package/dist/view/viewBody.js +30 -0
  1090. package/dist/view/viewBody.js.map +1 -0
  1091. package/dist/view/viewContext.d.ts +81 -0
  1092. package/dist/view/viewContext.js +49 -0
  1093. package/dist/view/viewContext.js.map +1 -0
  1094. package/dist/view/viewProps.d.ts +65 -8
  1095. package/dist/view/viewProps.js +123 -36
  1096. package/dist/view/viewProps.js.map +1 -1
  1097. package/dist/widgets/AnalyticsBreakdownWidget.d.ts +7 -3
  1098. package/dist/widgets/AnalyticsBreakdownWidget.js +153 -78
  1099. package/dist/widgets/AnalyticsBreakdownWidget.js.map +1 -1
  1100. package/dist/widgets/AnalyticsGoalsWidget.d.ts +6 -7
  1101. package/dist/widgets/AnalyticsGoalsWidget.js +126 -159
  1102. package/dist/widgets/AnalyticsGoalsWidget.js.map +1 -1
  1103. package/dist/widgets/AnalyticsMetricWidget.d.ts +7 -3
  1104. package/dist/widgets/AnalyticsMetricWidget.js +85 -83
  1105. package/dist/widgets/AnalyticsMetricWidget.js.map +1 -1
  1106. package/dist/widgets/AnalyticsRealtimeWidget.d.ts +7 -3
  1107. package/dist/widgets/AnalyticsRealtimeWidget.js +81 -61
  1108. package/dist/widgets/AnalyticsRealtimeWidget.js.map +1 -1
  1109. package/dist/widgets/AnalyticsTrendWidget.d.ts +7 -3
  1110. package/dist/widgets/AnalyticsTrendWidget.js +134 -100
  1111. package/dist/widgets/AnalyticsTrendWidget.js.map +1 -1
  1112. package/dist/widgets/ComparisonDelta.js +33 -42
  1113. package/dist/widgets/ComparisonDelta.js.map +1 -1
  1114. package/dist/widgets/RealtimeCounter.d.ts +27 -3
  1115. package/dist/widgets/RealtimeCounter.js +90 -62
  1116. package/dist/widgets/RealtimeCounter.js.map +1 -1
  1117. package/dist/widgets/WidgetCard.d.ts +80 -0
  1118. package/dist/widgets/WidgetCard.js +99 -0
  1119. package/dist/widgets/WidgetCard.js.map +1 -0
  1120. package/dist/widgets/WidgetFrame.js +42 -0
  1121. package/dist/widgets/WidgetFrame.js.map +1 -0
  1122. package/dist/widgets/WidgetShimmer.d.ts +55 -0
  1123. package/dist/widgets/WidgetShimmer.js +86 -0
  1124. package/dist/widgets/WidgetShimmer.js.map +1 -0
  1125. package/dist/widgets/breakdownTypes.js +18 -2
  1126. package/dist/widgets/breakdownTypes.js.map +1 -1
  1127. package/dist/widgets/customWidget.d.ts +5 -1
  1128. package/dist/widgets/customWidget.js +6 -7
  1129. package/dist/widgets/customWidget.js.map +1 -1
  1130. package/dist/widgets/defaultLayout.d.ts +26 -0
  1131. package/dist/widgets/defaultLayout.js +51 -0
  1132. package/dist/widgets/defaultLayout.js.map +1 -0
  1133. package/dist/widgets/defaults.d.ts +4 -3
  1134. package/dist/widgets/defaults.js +76 -24
  1135. package/dist/widgets/defaults.js.map +1 -1
  1136. package/dist/widgets/fieldRows.js +14 -0
  1137. package/dist/widgets/fieldRows.js.map +1 -0
  1138. package/dist/widgets/filterCaption.js +26 -0
  1139. package/dist/widgets/filterCaption.js.map +1 -0
  1140. package/dist/widgets/filterField.d.ts +15 -0
  1141. package/dist/widgets/filterField.js +86 -0
  1142. package/dist/widgets/filterField.js.map +1 -0
  1143. package/dist/widgets/filterValueLabel.d.ts +1 -0
  1144. package/dist/widgets/filterValueLabel.js +45 -0
  1145. package/dist/widgets/filterValueLabel.js.map +1 -0
  1146. package/dist/widgets/notices.js +79 -0
  1147. package/dist/widgets/notices.js.map +1 -0
  1148. package/dist/widgets/prepareWidgetRead.d.ts +24 -0
  1149. package/dist/widgets/prepareWidgetRead.js +110 -0
  1150. package/dist/widgets/prepareWidgetRead.js.map +1 -0
  1151. package/dist/widgets/range.js +26 -21
  1152. package/dist/widgets/range.js.map +1 -1
  1153. package/dist/widgets/readForWidget.d.ts +32 -13
  1154. package/dist/widgets/readForWidget.js +52 -63
  1155. package/dist/widgets/readForWidget.js.map +1 -1
  1156. package/dist/widgets/readForWidgetBreakdown.d.ts +45 -18
  1157. package/dist/widgets/readForWidgetBreakdown.js +71 -58
  1158. package/dist/widgets/readForWidgetBreakdown.js.map +1 -1
  1159. package/dist/widgets/readForWidgetGoals.d.ts +21 -17
  1160. package/dist/widgets/readForWidgetGoals.js +72 -52
  1161. package/dist/widgets/readForWidgetGoals.js.map +1 -1
  1162. package/dist/widgets/readForWidgetRealtime.d.ts +24 -11
  1163. package/dist/widgets/readForWidgetRealtime.js +69 -41
  1164. package/dist/widgets/readForWidgetRealtime.js.map +1 -1
  1165. package/dist/widgets/readForWidgetSeries.d.ts +29 -24
  1166. package/dist/widgets/readForWidgetSeries.js +66 -114
  1167. package/dist/widgets/readForWidgetSeries.js.map +1 -1
  1168. package/dist/widgets/readMeta.d.ts +48 -0
  1169. package/dist/widgets/readMeta.js +66 -0
  1170. package/dist/widgets/readMeta.js.map +1 -0
  1171. package/dist/widgets/realtimePoll.d.ts +1 -0
  1172. package/dist/widgets/realtimePoll.js +56 -16
  1173. package/dist/widgets/realtimePoll.js.map +1 -1
  1174. package/dist/widgets/registerWidgets.js +207 -124
  1175. package/dist/widgets/registerWidgets.js.map +1 -1
  1176. package/dist/widgets/stateKeys.js +30 -0
  1177. package/dist/widgets/stateKeys.js.map +1 -0
  1178. package/dist/widgets/titleForecast.js +89 -0
  1179. package/dist/widgets/titleForecast.js.map +1 -0
  1180. package/dist/widgets/types.d.ts +16 -0
  1181. package/dist/widgets/types.js +2 -0
  1182. package/dist/widgets/types.js.map +1 -1
  1183. package/dist/widgets/viewLink.d.ts +24 -6
  1184. package/dist/widgets/viewLink.js +36 -26
  1185. package/dist/widgets/viewLink.js.map +1 -1
  1186. package/dist/widgets/widgetData.js +34 -0
  1187. package/dist/widgets/widgetData.js.map +1 -0
  1188. package/dist/widgets/widgetWindow.d.ts +1 -0
  1189. package/dist/widgets/widgetWindow.js +51 -0
  1190. package/dist/widgets/widgetWindow.js.map +1 -0
  1191. package/package.json +61 -42
  1192. package/dist/capture/getTrackerConfig.d.ts +0 -20
  1193. package/dist/capture/getTrackerConfig.js +0 -31
  1194. package/dist/capture/getTrackerConfig.js.map +0 -1
  1195. package/dist/capture/slots.d.ts +0 -8
  1196. package/dist/capture/trackerConfig.d.ts +0 -33
  1197. package/dist/charts/styles.js +0 -59
  1198. package/dist/charts/styles.js.map +0 -1
  1199. package/dist/exports/next.d.ts +0 -3
  1200. package/dist/exports/next.js +0 -3
  1201. package/dist/fields/config/SourceSelectField.d.ts +0 -14
  1202. package/dist/fields/dateRange/styles.js +0 -23
  1203. package/dist/fields/dateRange/styles.js.map +0 -1
  1204. package/dist/goals/GoalSelectField.d.ts +0 -7
  1205. package/dist/native/collections/events.js +0 -121
  1206. package/dist/native/collections/events.js.map +0 -1
  1207. package/dist/native/collections/rollups.js +0 -151
  1208. package/dist/native/collections/rollups.js.map +0 -1
  1209. package/dist/native/collections/seen.js +0 -47
  1210. package/dist/native/collections/seen.js.map +0 -1
  1211. package/dist/native/ingest/flushBatch.js +0 -60
  1212. package/dist/native/ingest/flushBatch.js.map +0 -1
  1213. package/dist/native/ingest/salt.js +0 -14
  1214. package/dist/native/ingest/salt.js.map +0 -1
  1215. package/dist/native/ingest/writeBuffer.js +0 -55
  1216. package/dist/native/ingest/writeBuffer.js.map +0 -1
  1217. package/dist/native/ingest/writeEvent.js +0 -14
  1218. package/dist/native/ingest/writeEvent.js.map +0 -1
  1219. package/dist/native/query/eventAgg.js +0 -161
  1220. package/dist/native/query/eventAgg.js.map +0 -1
  1221. package/dist/native/realtime/buildRealtime.js +0 -53
  1222. package/dist/native/realtime/buildRealtime.js.map +0 -1
  1223. package/dist/native/retention/pruneTask.js +0 -29
  1224. package/dist/native/retention/pruneTask.js.map +0 -1
  1225. package/dist/native/rollupAcc.js +0 -64
  1226. package/dist/native/rollupAcc.js.map +0 -1
  1227. package/dist/native/rollups/applyDistinctDeltas.js +0 -9
  1228. package/dist/native/rollups/applyDistinctDeltas.js.map +0 -1
  1229. package/dist/native/rollups/bumpRollup.js +0 -73
  1230. package/dist/native/rollups/bumpRollup.js.map +0 -1
  1231. package/dist/native/rollups/deltas.js +0 -90
  1232. package/dist/native/rollups/deltas.js.map +0 -1
  1233. package/dist/native/rollups/insertIfNew.js +0 -53
  1234. package/dist/native/rollups/insertIfNew.js.map +0 -1
  1235. package/dist/next/captureRewrites.d.ts +0 -41
  1236. package/dist/next/captureRewrites.js +0 -56
  1237. package/dist/next/captureRewrites.js.map +0 -1
  1238. package/dist/next/posthogProxyRewrites.d.ts +0 -41
  1239. package/dist/next/posthogProxyRewrites.js +0 -45
  1240. package/dist/next/posthogProxyRewrites.js.map +0 -1
  1241. package/dist/plugin/paths.js +0 -27
  1242. package/dist/plugin/paths.js.map +0 -1
  1243. package/dist/query/errors.js +0 -10
  1244. package/dist/query/errors.js.map +0 -1
  1245. package/dist/react/TrackerBoot.d.ts +0 -22
  1246. package/dist/rsc/AnalyticsScripts.d.ts +0 -30
  1247. package/dist/rsc/AnalyticsScripts.js +0 -41
  1248. package/dist/rsc/AnalyticsScripts.js.map +0 -1
  1249. package/dist/surfacing/queue.js +0 -60
  1250. package/dist/surfacing/queue.js.map +0 -1
  1251. package/dist/surfacing/retryPolicy.js +0 -15
  1252. package/dist/surfacing/retryPolicy.js.map +0 -1
  1253. package/dist/tracker/autoCapture.d.ts +0 -48
  1254. package/dist/tracker/consent.d.ts +0 -24
  1255. package/dist/tracker/consent.js +0 -48
  1256. package/dist/tracker/consent.js.map +0 -1
  1257. package/dist/tracker/loadScript.d.ts +0 -14
  1258. package/dist/tracker/pageTracking.d.ts +0 -17
  1259. package/dist/tracker/registry.d.ts +0 -27
  1260. package/dist/tracker/sinks/native.d.ts +0 -22
  1261. package/dist/tracker/sinks/plausible.d.ts +0 -14
  1262. package/dist/tracker/sinks/posthog.d.ts +0 -14
  1263. package/dist/tracker/sinks/umami.d.ts +0 -13
  1264. package/dist/tracker/sinks/vendor.d.ts +0 -14
  1265. package/dist/view/sections/styles.js +0 -74
  1266. package/dist/view/sections/styles.js.map +0 -1
  1267. package/dist/widgets/WidgetViewLink.js +0 -17
  1268. package/dist/widgets/WidgetViewLink.js.map +0 -1
  1269. package/dist/widgets/cardChrome.d.ts +0 -8
  1270. package/dist/widgets/cardChrome.js +0 -46
  1271. package/dist/widgets/cardChrome.js.map +0 -1
  1272. package/dist/widgets/comparison.js +0 -43
  1273. package/dist/widgets/comparison.js.map +0 -1
@@ -1,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,15 @@ 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
+ },
58
+ setExcluded: (next) => ensure()?.exclude(next)
57
59
  }), [ensure]);
58
60
  return /* @__PURE__ */ jsx(AnalyticsContext.Provider, {
59
61
  value: api,
@@ -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/** The tracker surface a component gets from `useAnalytics`. */\nexport interface AnalyticsApi {\n\ttrack: Tracker['track']\n\ttrackGoal: Tracker['trackGoal']\n\tconsent: Tracker['consent']\n}\n\nexport const AnalyticsContext = createContext<AnalyticsApi | 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<AnalyticsApi>(\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}),\n\t\t[ensure]\n\t)\n\n\treturn <AnalyticsContext.Provider value={api}>{children}</AnalyticsContext.Provider>\n}\n"],"mappings":";;;;;AAsBA,MAAa,mBAAmB,cAAmC,IAAI;;;;;;;;;;;;;;;AA0BvE,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;CAC5C,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 type { ModeSnapshot } from '../tracker/gate'\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\t/**\n\t * What each capture slot captures with: `full` once open, else its level without consent (`off`,\n\t * `cookieless`, `anonymous`). All `off` until a tracker booted. A change re-renders the caller.\n\t */\n\tmode: ModeSnapshot\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":";;;;;AA8CA,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,14 +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.
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.
13
7
  */
14
8
  declare const useAnalytics: () => AnalyticsApi;
15
9
  //#endregion
@@ -1,22 +1,26 @@
1
1
  "use client";
2
- import { liveTracker } from "../tracker/registry.js";
2
+ import { subscribeExclusion } from "../tracker/exclusion.js";
3
+ import { ALL_OFF, ALL_PENDING } from "../tracker/gate.js";
4
+ import { liveTracker, setWindowGate, subscribeWindowGate, windowGateSnapshot, windowModeSnapshot } from "../tracker/registry.js";
3
5
  import { AnalyticsContext } from "./AnalyticsProvider.js";
4
- import { useContext, useMemo } from "react";
6
+ import { useContext, useMemo, useSyncExternalStore } from "react";
5
7
  //#region src/react/useAnalytics.tsx
6
8
  const NO_TRACKER = "analytics: useAnalytics found no tracker. Render <AnalyticsScripts /> (or <AnalyticsProvider>) above this component.";
9
+ /** The live tracker's flag, never storage: false until a tracker has read it, once a slot ran in full. */
10
+ const exclusionSnapshot = () => liveTracker()?.excluded ?? false;
11
+ const serverExclusionSnapshot = () => false;
12
+ const serverGateSnapshot = () => ALL_PENDING;
13
+ const serverModeSnapshot = () => ALL_OFF;
7
14
  /**
8
- * The window's tracker: the surrounding `<AnalyticsProvider>`'s when there is one, else
9
- * whichever instance `<AnalyticsScripts />` booted, so the RSC path alone is enough for a
10
- * client component to send its own events.
11
- *
12
- * The tracker is resolved per call, not per render: `<TrackerBoot />`'s effect may not have
13
- * run when a sibling renders, and an eagerly resolved null would never recover. A call that
14
- * finds neither a provider nor a booted tracker throws, because a silently dead `track` is
15
- * worse than a build-time mistake.
15
+ * The window's tracker, from `<AnalyticsProvider>` or else whatever `<AnalyticsScripts />` booted.
16
+ * A call with neither throws, except `setGate`, which is kept until a tracker boots.
16
17
  */
17
18
  const useAnalytics = () => {
18
19
  const provided = useContext(AnalyticsContext);
19
- return useMemo(() => {
20
+ const excluded = useSyncExternalStore(subscribeExclusion, exclusionSnapshot, serverExclusionSnapshot);
21
+ const gate = useSyncExternalStore(subscribeWindowGate, windowGateSnapshot, serverGateSnapshot);
22
+ const mode = useSyncExternalStore(subscribeWindowGate, windowModeSnapshot, serverModeSnapshot);
23
+ const commands = useMemo(() => {
20
24
  if (provided) return provided;
21
25
  const tracker = () => {
22
26
  const live = liveTracker();
@@ -24,11 +28,25 @@ const useAnalytics = () => {
24
28
  return live;
25
29
  };
26
30
  return {
27
- track: (name, props) => tracker().track(name, props),
31
+ track: (name, props, opts) => tracker().track(name, props, opts),
28
32
  trackGoal: (slug, opts) => tracker().trackGoal(slug, opts),
29
- consent: (state) => tracker().consent(state)
33
+ purchase: (input) => tracker().purchase(input),
34
+ refund: (input) => tracker().refund(input),
35
+ setGate: (state) => setWindowGate(state),
36
+ setExcluded: (next) => tracker().exclude(next)
30
37
  };
31
38
  }, [provided]);
39
+ return useMemo(() => ({
40
+ ...commands,
41
+ excluded,
42
+ gate,
43
+ mode
44
+ }), [
45
+ commands,
46
+ excluded,
47
+ gate,
48
+ mode
49
+ ]);
32
50
  };
33
51
  //#endregion
34
52
  export { useAnalytics };
@@ -1 +1 @@
1
- {"version":3,"file":"useAnalytics.js","names":[],"sources":["../../src/react/useAnalytics.tsx"],"sourcesContent":["'use client'\n\nimport { useContext, useMemo } from 'react'\nimport { liveTracker } from '../tracker/registry'\nimport type { Tracker } from '../tracker/types'\nimport { type AnalyticsApi, AnalyticsContext } from './AnalyticsProvider'\n\nconst NO_TRACKER =\n\t'analytics: useAnalytics found no tracker. Render <AnalyticsScripts /> (or <AnalyticsProvider>) above this component.'\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 */\nexport const useAnalytics = (): AnalyticsApi => {\n\tconst provided = useContext(AnalyticsContext)\n\treturn useMemo<AnalyticsApi>(() => {\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}\n\t}, [provided])\n}\n"],"mappings":";;;;;AAOA,MAAM,aACL;;;;;;;;;;;AAYD,MAAa,qBAAmC;CAC/C,MAAM,WAAW,WAAW,gBAAgB;CAC5C,OAAO,cAA4B;EAClC,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;EAC5C;CACD,GAAG,CAAC,QAAQ,CAAC;AACd"}
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_OFF, ALL_PENDING, type GateSnapshot, type ModeSnapshot } from '../tracker/gate'\nimport {\n\tliveTracker,\n\tsetWindowGate,\n\tsubscribeWindowGate,\n\twindowGateSnapshot,\n\twindowModeSnapshot,\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 ran in full. */\nconst exclusionSnapshot = (): boolean => liveTracker()?.excluded ?? false\n\nconst serverExclusionSnapshot = (): boolean => false\n\nconst serverGateSnapshot = (): GateSnapshot => ALL_PENDING\n\nconst serverModeSnapshot = (): ModeSnapshot => ALL_OFF\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 mode = useSyncExternalStore(subscribeWindowGate, windowModeSnapshot, serverModeSnapshot)\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>(\n\t\t() => ({ ...commands, excluded, gate, mode }),\n\t\t[commands, excluded, gate, mode]\n\t)\n}\n"],"mappings":";;;;;;;AAeA,MAAM,aACL;;AAGD,MAAM,0BAAmC,YAAY,GAAG,YAAY;AAEpE,MAAM,gCAAyC;AAE/C,MAAM,2BAAyC;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,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,eACC;EAAE,GAAG;EAAU;EAAU;EAAM;CAAK,IAC3C;EAAC;EAAU;EAAU;EAAM;CAAI,CAChC;AACD"}
@@ -0,0 +1,28 @@
1
+ import { TrustedPlatform } from "../net/platform.js";
2
+ import { AnalyticsAdapter } from "../core/contract.js";
3
+
4
+ //#region src/routes/captureRoute.d.ts
5
+ interface CaptureRouteOptions {
6
+ /** Where the route handler is mounted: `'/ph'` for `app/ph/[...path]/route.ts`. */
7
+ path: string;
8
+ /** The adapter whose `capture.proxy` routes the handler relays, as `adapters` builds it. */
9
+ adapter: AnalyticsAdapter;
10
+ /** The plugin's `trustedProxyHops`: the address forwarded upstream is the one it resolves. */
11
+ trustedProxyHops?: number;
12
+ /** The plugin's `trustedPlatform`, in place of `trustedProxyHops`. */
13
+ trustedPlatform?: TrustedPlatform;
14
+ /** The plugin's `capture.allowedOrigins`: other sites whose pages may post through the relay. */
15
+ allowedOrigins?: string[];
16
+ /** Deadline for the vendor's response headers. Default 10 seconds. */
17
+ timeoutMs?: number;
18
+ /** Largest body relayed. Default 1 MB. */
19
+ maxBodyBytes?: number;
20
+ }
21
+ /**
22
+ * A Next.js route handler relaying one adapter's vendor tracker at a `capture.paths` mount, exported
23
+ * as GET, POST and OPTIONS. No cookie or credential goes upstream, and no `set-cookie` comes back.
24
+ */
25
+ declare const captureRoute: (options: CaptureRouteOptions) => ((request: Request) => Promise<Response>);
26
+ //#endregion
27
+ export { CaptureRouteOptions, captureRoute };
28
+ //# sourceMappingURL=captureRoute.d.ts.map
@@ -0,0 +1,67 @@
1
+ import { isTrustedPlatform } from "../net/platform.js";
2
+ import { DEFAULT_PROXY_MAX_BODY_BYTES, DEFAULT_PROXY_TIMEOUT_MS, emptyResponse, pathBelowMount, relayToVendor, unforwardedMethodResponse } from "../capture/relay.js";
3
+ import { refusedCrossSite, resolveAllowedOrigins } from "../capture/requestTrust.js";
4
+ import { normalizeMountPath } from "../capture/mountPath.js";
5
+ //#region src/routes/captureRoute.ts
6
+ const positiveNumber = (value, name, fallback) => {
7
+ if (value === void 0) return fallback;
8
+ if (!Number.isFinite(value) || value <= 0) throw new Error(`analytics: captureRoute's ${name} must be a positive number`);
9
+ return value;
10
+ };
11
+ const resolveTrust = ({ trustedProxyHops: hops, trustedPlatform }) => {
12
+ if (hops !== void 0 && !(Number.isInteger(hops) && hops >= 0)) throw new Error("analytics: captureRoute trustedProxyHops must be a non-negative integer");
13
+ if (trustedPlatform !== void 0 && !isTrustedPlatform(trustedPlatform)) throw new Error("analytics: captureRoute trustedPlatform must be 'vercel' or 'cloudflare'");
14
+ if (hops !== void 0 && trustedPlatform !== void 0) throw new Error("analytics: captureRoute takes trustedProxyHops or trustedPlatform, not both");
15
+ return {
16
+ ...hops === void 0 ? {} : { trustedProxyHops: hops },
17
+ ...trustedPlatform === void 0 ? {} : { trustedPlatform }
18
+ };
19
+ };
20
+ /**
21
+ * A Next.js route handler relaying one adapter's vendor tracker at a `capture.paths` mount, exported
22
+ * as GET, POST and OPTIONS. No cookie or credential goes upstream, and no `set-cookie` comes back.
23
+ */
24
+ const captureRoute = (options) => {
25
+ const mount = normalizeMountPath(options.path);
26
+ if (mount === "/") throw new Error("analytics: captureRoute must not be mounted at the site root");
27
+ const descriptor = options.adapter.capture?.proxy;
28
+ if (!descriptor || descriptor.routes.length === 0) throw new Error(`analytics: captureRoute needs an adapter whose capture declares proxy routes; "${options.adapter.id}" declares none`);
29
+ const trust = resolveTrust(options);
30
+ const allowed = resolveAllowedOrigins(options.allowedOrigins);
31
+ const limits = {
32
+ timeoutMs: positiveNumber(options.timeoutMs, "timeoutMs", DEFAULT_PROXY_TIMEOUT_MS),
33
+ maxBodyBytes: positiveNumber(options.maxBodyBytes, "maxBodyBytes", DEFAULT_PROXY_MAX_BODY_BYTES)
34
+ };
35
+ return async (request) => {
36
+ const method = request.method.toUpperCase();
37
+ const unforwarded = unforwardedMethodResponse(method);
38
+ if (unforwarded) return unforwarded;
39
+ if (method === "POST" && refusedCrossSite(request.headers, allowed)) return emptyResponse(403);
40
+ const url = new URL(request.url);
41
+ const path = pathBelowMount(url.pathname, mount);
42
+ if (path === null) return emptyResponse(404);
43
+ try {
44
+ return await relayToVendor({
45
+ method,
46
+ headers: request.headers,
47
+ path,
48
+ search: url.search,
49
+ body: request
50
+ }, {
51
+ descriptor,
52
+ ...limits,
53
+ trust,
54
+ warn: (message) => {
55
+ console.warn(`analytics: captureRoute upstream failed for "${options.adapter.id}": ${message}`);
56
+ }
57
+ });
58
+ } catch (err) {
59
+ console.warn(`analytics: captureRoute request failed: ${String(err)}`);
60
+ return emptyResponse(500);
61
+ }
62
+ };
63
+ };
64
+ //#endregion
65
+ export { captureRoute };
66
+
67
+ //# sourceMappingURL=captureRoute.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"captureRoute.js","names":[],"sources":["../../src/routes/captureRoute.ts"],"sourcesContent":["import { normalizeMountPath } from '../capture/mountPath'\nimport {\n\tDEFAULT_PROXY_MAX_BODY_BYTES,\n\tDEFAULT_PROXY_TIMEOUT_MS,\n\temptyResponse,\n\tpathBelowMount,\n\trelayToVendor,\n\tunforwardedMethodResponse,\n} from '../capture/relay'\nimport { refusedCrossSite, resolveAllowedOrigins } from '../capture/requestTrust'\nimport type { AnalyticsAdapter } from '../core/contract'\nimport type { ClientIpOptions } from '../native/ingest/clientIp'\nimport { isTrustedPlatform, type TrustedPlatform } from '../net/platform'\n\nexport interface CaptureRouteOptions {\n\t/** Where the route handler is mounted: `'/ph'` for `app/ph/[...path]/route.ts`. */\n\tpath: string\n\t/** The adapter whose `capture.proxy` routes the handler relays, as `adapters` builds it. */\n\tadapter: AnalyticsAdapter\n\t/** The plugin's `trustedProxyHops`: the address forwarded upstream is the one it resolves. */\n\ttrustedProxyHops?: number\n\t/** The plugin's `trustedPlatform`, in place of `trustedProxyHops`. */\n\ttrustedPlatform?: TrustedPlatform\n\t/** The plugin's `capture.allowedOrigins`: other sites whose pages may post through the relay. */\n\tallowedOrigins?: string[]\n\t/** Deadline for the vendor's response headers. Default 10 seconds. */\n\ttimeoutMs?: number\n\t/** Largest body relayed. Default 1 MB. */\n\tmaxBodyBytes?: number\n}\n\nconst positiveNumber = (value: number | undefined, name: string, fallback: number): number => {\n\tif (value === undefined) {\n\t\treturn fallback\n\t}\n\tif (!Number.isFinite(value) || value <= 0) {\n\t\tthrow new Error(`analytics: captureRoute's ${name} must be a positive number`)\n\t}\n\treturn value\n}\n\nconst resolveTrust = ({\n\ttrustedProxyHops: hops,\n\ttrustedPlatform,\n}: CaptureRouteOptions): ClientIpOptions => {\n\tif (hops !== undefined && !(Number.isInteger(hops) && hops >= 0)) {\n\t\tthrow new Error('analytics: captureRoute trustedProxyHops must be a non-negative integer')\n\t}\n\tif (trustedPlatform !== undefined && !isTrustedPlatform(trustedPlatform)) {\n\t\tthrow new Error(\"analytics: captureRoute trustedPlatform must be 'vercel' or 'cloudflare'\")\n\t}\n\tif (hops !== undefined && trustedPlatform !== undefined) {\n\t\tthrow new Error('analytics: captureRoute takes trustedProxyHops or trustedPlatform, not both')\n\t}\n\treturn {\n\t\t...(hops === undefined ? {} : { trustedProxyHops: hops }),\n\t\t...(trustedPlatform === undefined ? {} : { trustedPlatform }),\n\t}\n}\n\n/**\n * A Next.js route handler relaying one adapter's vendor tracker at a `capture.paths` mount, exported\n * as GET, POST and OPTIONS. No cookie or credential goes upstream, and no `set-cookie` comes back.\n */\nexport const captureRoute = (\n\toptions: CaptureRouteOptions\n): ((request: Request) => Promise<Response>) => {\n\tconst mount = normalizeMountPath(options.path)\n\tif (mount === '/') {\n\t\tthrow new Error('analytics: captureRoute must not be mounted at the site root')\n\t}\n\tconst descriptor = options.adapter.capture?.proxy\n\tif (!descriptor || descriptor.routes.length === 0) {\n\t\tthrow new Error(\n\t\t\t`analytics: captureRoute needs an adapter whose capture declares proxy routes; \"${options.adapter.id}\" declares none`\n\t\t)\n\t}\n\tconst trust = resolveTrust(options)\n\tconst allowed = resolveAllowedOrigins(options.allowedOrigins)\n\tconst limits = {\n\t\ttimeoutMs: positiveNumber(options.timeoutMs, 'timeoutMs', DEFAULT_PROXY_TIMEOUT_MS),\n\t\tmaxBodyBytes: positiveNumber(\n\t\t\toptions.maxBodyBytes,\n\t\t\t'maxBodyBytes',\n\t\t\tDEFAULT_PROXY_MAX_BODY_BYTES\n\t\t),\n\t}\n\treturn async (request) => {\n\t\tconst method = request.method.toUpperCase()\n\t\tconst unforwarded = unforwardedMethodResponse(method)\n\t\tif (unforwarded) {\n\t\t\treturn unforwarded\n\t\t}\n\t\tif (method === 'POST' && refusedCrossSite(request.headers, allowed)) {\n\t\t\treturn emptyResponse(403)\n\t\t}\n\t\tconst url = new URL(request.url)\n\t\tconst path = pathBelowMount(url.pathname, mount)\n\t\tif (path === null) {\n\t\t\treturn emptyResponse(404)\n\t\t}\n\t\ttry {\n\t\t\treturn await relayToVendor(\n\t\t\t\t{ method, headers: request.headers, path, search: url.search, body: request },\n\t\t\t\t{\n\t\t\t\t\tdescriptor,\n\t\t\t\t\t...limits,\n\t\t\t\t\ttrust,\n\t\t\t\t\twarn: (message) => {\n\t\t\t\t\t\tconsole.warn(\n\t\t\t\t\t\t\t`analytics: captureRoute upstream failed for \"${options.adapter.id}\": ${message}`\n\t\t\t\t\t\t)\n\t\t\t\t\t},\n\t\t\t\t}\n\t\t\t)\n\t\t} catch (err) {\n\t\t\tconsole.warn(`analytics: captureRoute request failed: ${String(err)}`)\n\t\t\treturn emptyResponse(500)\n\t\t}\n\t}\n}\n"],"mappings":";;;;;AA+BA,MAAM,kBAAkB,OAA2B,MAAc,aAA6B;CAC7F,IAAI,UAAU,KAAA,GACb,OAAO;CAER,IAAI,CAAC,OAAO,SAAS,KAAK,KAAK,SAAS,GACvC,MAAM,IAAI,MAAM,6BAA6B,KAAK,2BAA2B;CAE9E,OAAO;AACR;AAEA,MAAM,gBAAgB,EACrB,kBAAkB,MAClB,sBAC2C;CAC3C,IAAI,SAAS,KAAA,KAAa,EAAE,OAAO,UAAU,IAAI,KAAK,QAAQ,IAC7D,MAAM,IAAI,MAAM,yEAAyE;CAE1F,IAAI,oBAAoB,KAAA,KAAa,CAAC,kBAAkB,eAAe,GACtE,MAAM,IAAI,MAAM,0EAA0E;CAE3F,IAAI,SAAS,KAAA,KAAa,oBAAoB,KAAA,GAC7C,MAAM,IAAI,MAAM,6EAA6E;CAE9F,OAAO;EACN,GAAI,SAAS,KAAA,IAAY,CAAC,IAAI,EAAE,kBAAkB,KAAK;EACvD,GAAI,oBAAoB,KAAA,IAAY,CAAC,IAAI,EAAE,gBAAgB;CAC5D;AACD;;;;;AAMA,MAAa,gBACZ,YAC+C;CAC/C,MAAM,QAAQ,mBAAmB,QAAQ,IAAI;CAC7C,IAAI,UAAU,KACb,MAAM,IAAI,MAAM,8DAA8D;CAE/E,MAAM,aAAa,QAAQ,QAAQ,SAAS;CAC5C,IAAI,CAAC,cAAc,WAAW,OAAO,WAAW,GAC/C,MAAM,IAAI,MACT,kFAAkF,QAAQ,QAAQ,GAAG,gBACtG;CAED,MAAM,QAAQ,aAAa,OAAO;CAClC,MAAM,UAAU,sBAAsB,QAAQ,cAAc;CAC5D,MAAM,SAAS;EACd,WAAW,eAAe,QAAQ,WAAW,aAAa,wBAAwB;EAClF,cAAc,eACb,QAAQ,cACR,gBACA,4BACD;CACD;CACA,OAAO,OAAO,YAAY;EACzB,MAAM,SAAS,QAAQ,OAAO,YAAY;EAC1C,MAAM,cAAc,0BAA0B,MAAM;EACpD,IAAI,aACH,OAAO;EAER,IAAI,WAAW,UAAU,iBAAiB,QAAQ,SAAS,OAAO,GACjE,OAAO,cAAc,GAAG;EAEzB,MAAM,MAAM,IAAI,IAAI,QAAQ,GAAG;EAC/B,MAAM,OAAO,eAAe,IAAI,UAAU,KAAK;EAC/C,IAAI,SAAS,MACZ,OAAO,cAAc,GAAG;EAEzB,IAAI;GACH,OAAO,MAAM,cACZ;IAAE;IAAQ,SAAS,QAAQ;IAAS;IAAM,QAAQ,IAAI;IAAQ,MAAM;GAAQ,GAC5E;IACC;IACA,GAAG;IACH;IACA,OAAO,YAAY;KAClB,QAAQ,KACP,gDAAgD,QAAQ,QAAQ,GAAG,KAAK,SACzE;IACD;GACD,CACD;EACD,SAAS,KAAK;GACb,QAAQ,KAAK,2CAA2C,OAAO,GAAG,GAAG;GACrE,OAAO,cAAc,GAAG;EACzB;CACD;AACD"}
@@ -0,0 +1,17 @@
1
+ import { IngestRouteOptions } from "../native/ingest/route.js";
2
+ import { SanitizedConfig } from "payload";
3
+
4
+ //#region src/routes/ingestRoute.d.ts
5
+ /**
6
+ * A Next.js POST handler for native beacons at the tracker's `ingestPath`, with every ingest rule
7
+ * applied but without Payload's REST routing and auth strategies.
8
+ */
9
+ declare const ingestRoute: (config: Promise<SanitizedConfig> | SanitizedConfig, options?: IngestRouteOptions) => ((request: Request) => Promise<Response>);
10
+ /**
11
+ * The `OPTIONS` handler beside {@link ingestRoute}, for pages on another domain: only an origin
12
+ * `capture.allowedOrigins` lists passes the browser's preflight.
13
+ */
14
+ declare const ingestPreflight: (config: Promise<SanitizedConfig> | SanitizedConfig, options?: IngestRouteOptions) => ((request: Request) => Promise<Response>);
15
+ //#endregion
16
+ export { ingestPreflight, ingestRoute };
17
+ //# sourceMappingURL=ingestRoute.d.ts.map
@@ -0,0 +1,17 @@
1
+ //#region src/routes/ingestRoute.ts
2
+ /** Loaded on the first request, so importing this entry, as a `next.config` may, never loads Payload. */
3
+ const loadIngestRoute = () => import("../native/ingest/route.js");
4
+ /**
5
+ * A Next.js POST handler for native beacons at the tracker's `ingestPath`, with every ingest rule
6
+ * applied but without Payload's REST routing and auth strategies.
7
+ */
8
+ const ingestRoute = (config, options = {}) => async (request) => (await loadIngestRoute()).receiveBeacon(request, config, options);
9
+ /**
10
+ * The `OPTIONS` handler beside {@link ingestRoute}, for pages on another domain: only an origin
11
+ * `capture.allowedOrigins` lists passes the browser's preflight.
12
+ */
13
+ const ingestPreflight = (config, options = {}) => async (request) => (await loadIngestRoute()).answerPreflight(request, config, options);
14
+ //#endregion
15
+ export { ingestPreflight, ingestRoute };
16
+
17
+ //# sourceMappingURL=ingestRoute.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"ingestRoute.js","names":[],"sources":["../../src/routes/ingestRoute.ts"],"sourcesContent":["import type { SanitizedConfig } from 'payload'\nimport type { IngestRouteOptions } from '../native/ingest/route'\n\nexport type { IngestRouteOptions } from '../native/ingest/route'\n\n/** Loaded on the first request, so importing this entry, as a `next.config` may, never loads Payload. */\nconst loadIngestRoute = () => import('../native/ingest/route')\n\n/**\n * A Next.js POST handler for native beacons at the tracker's `ingestPath`, with every ingest rule\n * applied but without Payload's REST routing and auth strategies.\n */\nexport const ingestRoute =\n\t(\n\t\tconfig: Promise<SanitizedConfig> | SanitizedConfig,\n\t\toptions: IngestRouteOptions = {}\n\t): ((request: Request) => Promise<Response>) =>\n\tasync (request) =>\n\t\t(await loadIngestRoute()).receiveBeacon(request, config, options)\n\n/**\n * The `OPTIONS` handler beside {@link ingestRoute}, for pages on another domain: only an origin\n * `capture.allowedOrigins` lists passes the browser's preflight.\n */\nexport const ingestPreflight =\n\t(\n\t\tconfig: Promise<SanitizedConfig> | SanitizedConfig,\n\t\toptions: IngestRouteOptions = {}\n\t): ((request: Request) => Promise<Response>) =>\n\tasync (request) =>\n\t\t(await loadIngestRoute()).answerPreflight(request, config, options)\n"],"mappings":";;AAMA,MAAM,wBAAwB,OAAO;;;;;AAMrC,MAAa,eAEX,QACA,UAA8B,CAAC,MAEhC,OAAO,aACL,MAAM,gBAAgB,GAAG,cAAc,SAAS,QAAQ,OAAO;;;;;AAMlE,MAAa,mBAEX,QACA,UAA8B,CAAC,MAEhC,OAAO,aACL,MAAM,gBAAgB,GAAG,gBAAgB,SAAS,QAAQ,OAAO"}
@@ -0,0 +1,35 @@
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 only when they count after a refusal. Omitted, every held slot boots pending.
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 the snippet of each slot capturing at boot, then boots the tracker; a slot sending
24
+ * nothing yet gets its snippet once `setGate` opens it. A draft page renders none while
25
+ * `capture.skip.previews` is on.
26
+ */
27
+ declare const AnalyticsScripts: ({
28
+ config,
29
+ gate,
30
+ snippets,
31
+ nonce
32
+ }: AnalyticsScriptsProps) => ReactElement;
33
+ //#endregion
34
+ export { AnalyticsScripts, AnalyticsScriptsProps };
35
+ //# sourceMappingURL=AnalyticsScripts.d.ts.map
@@ -0,0 +1,44 @@
1
+ import { skipsDraft } from "../tracker/skip.js";
2
+ import { gateAnswer, openAtBoot, slotIsGated, slotMode } 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
+ const bootStatus = (slot, gate) => {
7
+ if (openAtBoot(slot, gate)) return "open";
8
+ return gateAnswer(gate, slot.slot, slotIsGated(slot)) === false ? "closed" : "pending";
9
+ };
10
+ /**
11
+ * The snippet a slot renders with the page, so its first pageview is counted with it: the full
12
+ * variant when open, the slot's own while it counts without consent, none while it sends nothing.
13
+ */
14
+ const bootSnippet = (slot, gate) => {
15
+ const status = bootStatus(slot, gate);
16
+ if (slotMode(slot, status) === "off") return;
17
+ return status === "open" ? slot.fullSnippet ?? slot.snippet : slot.snippet;
18
+ };
19
+ /**
20
+ * Renders the snippet of each slot capturing at boot, then boots the tracker; a slot sending
21
+ * nothing yet gets its snippet once `setGate` opens it. A draft page renders none while
22
+ * `capture.skip.previews` is on.
23
+ */
24
+ const AnalyticsScripts = ({ config, gate, snippets = true, nonce }) => {
25
+ const rendersSnippets = snippets && !skipsDraft(config);
26
+ return /* @__PURE__ */ jsxs(Fragment, { children: [config.slots.flatMap((slot) => rendersSnippets ? (bootSnippet(slot, gate)?.scripts ?? []).map((script, index) => /* @__PURE__ */ jsx("script", {
27
+ ...script.attrs,
28
+ async: script.async,
29
+ defer: script.defer,
30
+ dangerouslySetInnerHTML: script.inline ? { __html: script.inline } : void 0,
31
+ nonce,
32
+ src: script.inline ? void 0 : script.src,
33
+ type: script.type
34
+ }, `${slot.slot}-${index}`)) : []), /* @__PURE__ */ jsx(TrackerBoot, {
35
+ config,
36
+ gate,
37
+ nonce,
38
+ snippets
39
+ })] });
40
+ };
41
+ //#endregion
42
+ export { AnalyticsScripts };
43
+
44
+ //# sourceMappingURL=AnalyticsScripts.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"AnalyticsScripts.js","names":[],"sources":["../../src/site/AnalyticsScripts.tsx"],"sourcesContent":["import type { ReactElement } from 'react'\nimport { TrackerBoot } from '../react/TrackerBoot'\nimport type { CaptureSnippet, TrackerConfig, TrackerSlotConfig } from '../tracker/config'\nimport { gateAnswer, openAtBoot, slotIsGated, slotMode } from '../tracker/gate'\nimport { skipsDraft } from '../tracker/skip'\nimport type { GateState, GateStatus } from '../tracker/types'\n\nexport interface AnalyticsScriptsProps {\n\t/** Resolved server-side, by `getTrackerConfig` or the tracker endpoint. */\n\tconfig: TrackerConfig\n\t/**\n\t * The visitor's decision when the server knows it: opened slots render and boot open, closed ones\n\t * render only when they count after a refusal. Omitted, every held slot boots pending.\n\t */\n\tgate?: GateState\n\t/**\n\t * `false` renders no vendor snippet and has the tracker inject none either, for a consent\n\t * manager that loads the vendor SDKs itself. Default true.\n\t */\n\tsnippets?: boolean\n\t/** CSP nonce, applied to every script this renders and the tracker injects. */\n\tnonce?: string\n}\n\nconst bootStatus = (slot: TrackerSlotConfig, gate: GateState | undefined): GateStatus => {\n\tif (openAtBoot(slot, gate)) {\n\t\treturn 'open'\n\t}\n\treturn gateAnswer(gate, slot.slot, slotIsGated(slot)) === false ? 'closed' : 'pending'\n}\n\n/**\n * The snippet a slot renders with the page, so its first pageview is counted with it: the full\n * variant when open, the slot's own while it counts without consent, none while it sends nothing.\n */\nconst bootSnippet = (\n\tslot: TrackerSlotConfig,\n\tgate: GateState | undefined\n): CaptureSnippet | undefined => {\n\tconst status = bootStatus(slot, gate)\n\tif (slotMode(slot, status) === 'off') {\n\t\treturn undefined\n\t}\n\treturn status === 'open' ? (slot.fullSnippet ?? slot.snippet) : slot.snippet\n}\n\n/**\n * Renders the snippet of each slot capturing at boot, then boots the tracker; a slot sending\n * nothing yet gets its snippet once `setGate` opens it. A draft page renders none while\n * `capture.skip.previews` is on.\n */\nexport const AnalyticsScripts = ({\n\tconfig,\n\tgate,\n\tsnippets = true,\n\tnonce,\n}: AnalyticsScriptsProps): ReactElement => {\n\tconst rendersSnippets = snippets && !skipsDraft(config)\n\treturn (\n\t\t<>\n\t\t\t{config.slots.flatMap((slot) =>\n\t\t\t\trendersSnippets\n\t\t\t\t\t? (bootSnippet(slot, gate)?.scripts ?? []).map((script, index) => (\n\t\t\t\t\t\t\t<script\n\t\t\t\t\t\t\t\t// biome-ignore lint/suspicious/noArrayIndexKey: a snippet's scripts are a fixed list, never reordered\n\t\t\t\t\t\t\t\tkey={`${slot.slot}-${index}`}\n\t\t\t\t\t\t\t\t{...script.attrs}\n\t\t\t\t\t\t\t\tasync={script.async}\n\t\t\t\t\t\t\t\tdefer={script.defer}\n\t\t\t\t\t\t\t\t// biome-ignore lint/security/noDangerouslySetInnerHtml: adapter-authored vendor init\n\t\t\t\t\t\t\t\tdangerouslySetInnerHTML={script.inline ? { __html: script.inline } : undefined}\n\t\t\t\t\t\t\t\tnonce={nonce}\n\t\t\t\t\t\t\t\tsrc={script.inline ? undefined : script.src}\n\t\t\t\t\t\t\t\ttype={script.type}\n\t\t\t\t\t\t\t/>\n\t\t\t\t\t\t))\n\t\t\t\t\t: []\n\t\t\t)}\n\t\t\t<TrackerBoot config={config} gate={gate} nonce={nonce} snippets={snippets} />\n\t\t</>\n\t)\n}\n"],"mappings":";;;;;AAwBA,MAAM,cAAc,MAAyB,SAA4C;CACxF,IAAI,WAAW,MAAM,IAAI,GACxB,OAAO;CAER,OAAO,WAAW,MAAM,KAAK,MAAM,YAAY,IAAI,CAAC,MAAM,QAAQ,WAAW;AAC9E;;;;;AAMA,MAAM,eACL,MACA,SACgC;CAChC,MAAM,SAAS,WAAW,MAAM,IAAI;CACpC,IAAI,SAAS,MAAM,MAAM,MAAM,OAC9B;CAED,OAAO,WAAW,SAAU,KAAK,eAAe,KAAK,UAAW,KAAK;AACtE;;;;;;AAOA,MAAa,oBAAoB,EAChC,QACA,MACA,WAAW,MACX,YAC0C;CAC1C,MAAM,kBAAkB,YAAY,CAAC,WAAW,MAAM;CACtD,OACC,qBAAA,UAAA,EAAA,UAAA,CACE,OAAO,MAAM,SAAS,SACtB,mBACI,YAAY,MAAM,IAAI,GAAG,WAAW,CAAC,GAAG,KAAK,QAAQ,UACtD,oBAAC,UAAD;EAGC,GAAI,OAAO;EACX,OAAO,OAAO;EACd,OAAO,OAAO;EAEd,yBAAyB,OAAO,SAAS,EAAE,QAAQ,OAAO,OAAO,IAAI,KAAA;EAC9D;EACP,KAAK,OAAO,SAAS,KAAA,IAAY,OAAO;EACxC,MAAM,OAAO;CACb,GATK,GAAG,KAAK,KAAK,GAAG,OASrB,CACD,IACA,CAAC,CACL,GACA,oBAAC,aAAD;EAAqB;EAAc;EAAa;EAAiB;CAAW,CAAA,CAC3E,EAAA,CAAA;AAEJ"}
@@ -0,0 +1,15 @@
1
+ import { TrackerConfig } from "../tracker/config.js";
2
+ import { Payload, PayloadRequest } from "payload";
3
+
4
+ //#region src/site/getTrackerConfig.d.ts
5
+ /**
6
+ * Server-side twin of the tracker endpoint: pass the request's `headers()` so the host's resolver
7
+ * sees the visitor's request. Pass `draft: (await draftMode()).isEnabled`, else the cookie decides.
8
+ */
9
+ declare const getTrackerConfig: (payload: Payload, args?: {
10
+ headers?: Headers;
11
+ draft?: boolean;
12
+ }) => Promise<TrackerConfig>;
13
+ //#endregion
14
+ export { getTrackerConfig };
15
+ //# sourceMappingURL=getTrackerConfig.d.ts.map
@@ -0,0 +1,43 @@
1
+ import { isRecord } from "../core/values.js";
2
+ import { ANALYTICS_CONFIG_KEY, analyticsRoutes } from "../plugin/routes.js";
3
+ import { apiPath } from "../plugin/apiPath.js";
4
+ import { DEFAULT_AUTO_CAPTURE } from "../tracker/config.js";
5
+ import { createPayloadRequest } from "payload";
6
+ /**
7
+ * Whether the request carries Next's draft mode cookie. Unverified, so a stale or forged cookie reads
8
+ * as draft; `(await draftMode()).isEnabled` checks it against the preview id.
9
+ */
10
+ const draftModeCookie = (headers) => (headers.get("cookie") ?? "").split(";").some((pair) => {
11
+ const [name, ...value] = pair.trim().split("=");
12
+ return name === "__prerender_bypass" && value.join("=") !== "";
13
+ });
14
+ const isTrackerConfigSource = (value) => isRecord(value) && typeof value.trackerConfig === "function";
15
+ /** The config for an install with no runtime: no slots, but still a usable ingest path. */
16
+ const emptyTrackerConfig = (req) => ({
17
+ slots: [],
18
+ autoCapture: DEFAULT_AUTO_CAPTURE,
19
+ goals: [],
20
+ ingestPath: apiPath(req.payload?.config ?? {}, analyticsRoutes(req.payload?.config).ingest)
21
+ });
22
+ /**
23
+ * Server-side twin of the tracker endpoint: pass the request's `headers()` so the host's resolver
24
+ * sees the visitor's request. Pass `draft: (await draftMode()).isEnabled`, else the cookie decides.
25
+ */
26
+ const getTrackerConfig = async (payload, args) => {
27
+ const headers = args?.headers ?? new Headers();
28
+ const host = headers.get("host");
29
+ const req = await createPayloadRequest({
30
+ payload,
31
+ req: {
32
+ headers,
33
+ ...host ? { host } : {}
34
+ }
35
+ });
36
+ const draft = args?.draft ?? draftModeCookie(headers);
37
+ const source = payload.config.custom?.[ANALYTICS_CONFIG_KEY];
38
+ return isTrackerConfigSource(source) ? source.trackerConfig(payload, req, draft) : emptyTrackerConfig(req);
39
+ };
40
+ //#endregion
41
+ export { draftModeCookie, emptyTrackerConfig, getTrackerConfig };
42
+
43
+ //# sourceMappingURL=getTrackerConfig.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"getTrackerConfig.js","names":[],"sources":["../../src/site/getTrackerConfig.ts"],"sourcesContent":["import { createPayloadRequest, type Payload, type PayloadRequest } from 'payload'\nimport { isRecord } from '../core/values'\nimport { apiPath } from '../plugin/apiPath'\nimport { ANALYTICS_CONFIG_KEY, analyticsRoutes } from '../plugin/routes'\nimport { DEFAULT_AUTO_CAPTURE, type TrackerConfig } from '../tracker/config'\n\n/**\n * The cookie Next's `draftMode().enable()` sets and `disable()` clears, which is how Payload's\n * preview route turns draft mode on (`__prerender_bypass` in `next/dist/server/api-utils`).\n */\nexport const NEXT_DRAFT_COOKIE = '__prerender_bypass'\n\n/**\n * Whether the request carries Next's draft mode cookie. Unverified, so a stale or forged cookie reads\n * as draft; `(await draftMode()).isEnabled` checks it against the preview id.\n */\nexport const draftModeCookie = (headers: Headers): boolean =>\n\t(headers.get('cookie') ?? '').split(';').some((pair) => {\n\t\tconst [name, ...value] = pair.trim().split('=')\n\t\treturn name === NEXT_DRAFT_COOKIE && value.join('=') !== ''\n\t})\n\n/**\n * What the plugin's `config.custom` entry answers a site render with, so a site page reaches the\n * runtime without loading the engine, the adapters or the admin.\n */\nexport interface TrackerConfigSource {\n\ttrackerConfig: (payload: Payload, req: PayloadRequest, draft: boolean) => Promise<TrackerConfig>\n}\n\nconst isTrackerConfigSource = (value: unknown): value is TrackerConfigSource =>\n\tisRecord(value) && typeof value.trackerConfig === 'function'\n\n/** The config for an install with no runtime: no slots, but still a usable ingest path. */\nexport const emptyTrackerConfig = (req: PayloadRequest): TrackerConfig => ({\n\tslots: [],\n\tautoCapture: DEFAULT_AUTO_CAPTURE,\n\tgoals: [],\n\tingestPath: apiPath(req.payload?.config ?? {}, analyticsRoutes(req.payload?.config).ingest),\n})\n\n/**\n * Server-side twin of the tracker endpoint: pass the request's `headers()` so the host's resolver\n * sees the visitor's request. Pass `draft: (await draftMode()).isEnabled`, else the cookie decides.\n */\nexport const getTrackerConfig = async (\n\tpayload: Payload,\n\targs?: { headers?: Headers; draft?: boolean }\n): Promise<TrackerConfig> => {\n\tconst headers = args?.headers ?? new Headers()\n\t// Payload derives `req.host` from the URL, and hostname scoping needs the header's.\n\tconst host = headers.get('host')\n\t// A fresh literal per call: `createPayloadRequest` mutates the request it is given.\n\tconst req = await createPayloadRequest({ payload, req: { headers, ...(host ? { host } : {}) } })\n\tconst draft = args?.draft ?? draftModeCookie(headers)\n\tconst source = payload.config.custom?.[ANALYTICS_CONFIG_KEY]\n\treturn isTrackerConfigSource(source)\n\t\t? source.trackerConfig(payload, req, draft)\n\t\t: emptyTrackerConfig(req)\n}\n"],"mappings":";;;;;;;;;AAgBA,MAAa,mBAAmB,aAC9B,QAAQ,IAAI,QAAQ,KAAK,IAAI,MAAM,GAAG,EAAE,MAAM,SAAS;CACvD,MAAM,CAAC,MAAM,GAAG,SAAS,KAAK,KAAK,EAAE,MAAM,GAAG;CAC9C,OAAO,SAAA,wBAA8B,MAAM,KAAK,GAAG,MAAM;AAC1D,CAAC;AAUF,MAAM,yBAAyB,UAC9B,SAAS,KAAK,KAAK,OAAO,MAAM,kBAAkB;;AAGnD,MAAa,sBAAsB,SAAwC;CAC1E,OAAO,CAAC;CACR,aAAa;CACb,OAAO,CAAC;CACR,YAAY,QAAQ,IAAI,SAAS,UAAU,CAAC,GAAG,gBAAgB,IAAI,SAAS,MAAM,EAAE,MAAM;AAC3F;;;;;AAMA,MAAa,mBAAmB,OAC/B,SACA,SAC4B;CAC5B,MAAM,UAAU,MAAM,WAAW,IAAI,QAAQ;CAE7C,MAAM,OAAO,QAAQ,IAAI,MAAM;CAE/B,MAAM,MAAM,MAAM,qBAAqB;EAAE;EAAS,KAAK;GAAE;GAAS,GAAI,OAAO,EAAE,KAAK,IAAI,CAAC;EAAG;CAAE,CAAC;CAC/F,MAAM,QAAQ,MAAM,SAAS,gBAAgB,OAAO;CACpD,MAAM,SAAS,QAAQ,OAAO,SAAS;CACvC,OAAO,sBAAsB,MAAM,IAChC,OAAO,cAAc,SAAS,KAAK,KAAK,IACxC,mBAAmB,GAAG;AAC1B"}