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

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 (1241) hide show
  1. package/CHANGELOG.md +463 -0
  2. package/README.md +30 -37
  3. package/dist/access/adminUser.d.ts +15 -0
  4. package/dist/access/adminUser.js +13 -0
  5. package/dist/access/adminUser.js.map +1 -0
  6. package/dist/access/decideOnce.js +16 -0
  7. package/dist/access/decideOnce.js.map +1 -0
  8. package/dist/access/membership.d.ts +23 -0
  9. package/dist/access/membership.js +63 -0
  10. package/dist/access/membership.js.map +1 -0
  11. package/dist/access/principal.d.ts +37 -0
  12. package/dist/access/principal.js +29 -0
  13. package/dist/access/principal.js.map +1 -0
  14. package/dist/access/readGate.js +16 -0
  15. package/dist/access/readGate.js.map +1 -0
  16. package/dist/adapters/ga4/disableKey.js +7 -9
  17. package/dist/adapters/ga4/disableKey.js.map +1 -1
  18. package/dist/adapters/ga4/eventName.d.ts +2 -8
  19. package/dist/adapters/ga4/eventName.js +2 -8
  20. package/dist/adapters/ga4/eventName.js.map +1 -1
  21. package/dist/adapters/ga4/ga4.d.ts +11 -0
  22. package/dist/adapters/ga4/ga4.js +206 -123
  23. package/dist/adapters/ga4/ga4.js.map +1 -1
  24. package/dist/adapters/ga4/measurementId.js +2 -3
  25. package/dist/adapters/ga4/measurementId.js.map +1 -1
  26. package/dist/adapters/goalRead.js +15 -29
  27. package/dist/adapters/goalRead.js.map +1 -1
  28. package/dist/adapters/http/baseUrl.js +15 -0
  29. package/dist/adapters/http/baseUrl.js.map +1 -0
  30. package/dist/adapters/http/fetchJson.d.ts +19 -0
  31. package/dist/adapters/http/fetchJson.js +27 -8
  32. package/dist/adapters/http/fetchJson.js.map +1 -1
  33. package/dist/adapters/mapping.js +52 -0
  34. package/dist/adapters/mapping.js.map +1 -0
  35. package/dist/adapters/plausible/plausible.d.ts +13 -13
  36. package/dist/adapters/plausible/plausible.js +137 -122
  37. package/dist/adapters/plausible/plausible.js.map +1 -1
  38. package/dist/adapters/plausible/scriptId.js +19 -0
  39. package/dist/adapters/plausible/scriptId.js.map +1 -0
  40. package/dist/adapters/posthog/posthog.d.ts +20 -9
  41. package/dist/adapters/posthog/posthog.js +179 -113
  42. package/dist/adapters/posthog/posthog.js.map +1 -1
  43. package/dist/adapters/readTime.js +7 -0
  44. package/dist/adapters/readTime.js.map +1 -0
  45. package/dist/adapters/series.js +14 -8
  46. package/dist/adapters/series.js.map +1 -1
  47. package/dist/adapters/umami/umami.d.ts +7 -9
  48. package/dist/adapters/umami/umami.js +184 -172
  49. package/dist/adapters/umami/umami.js.map +1 -1
  50. package/dist/adapters/upstream.js +16 -0
  51. package/dist/adapters/upstream.js.map +1 -0
  52. package/dist/binding/report.d.ts +8 -0
  53. package/dist/binding/report.js +24 -0
  54. package/dist/binding/report.js.map +1 -0
  55. package/dist/binding/resolvePath.js +16 -29
  56. package/dist/binding/resolvePath.js.map +1 -1
  57. package/dist/binding/types.d.ts +14 -29
  58. package/dist/capture/captureRequest.js +28 -0
  59. package/dist/capture/captureRequest.js.map +1 -0
  60. package/dist/capture/exclusionEndpoint.js +98 -0
  61. package/dist/capture/exclusionEndpoint.js.map +1 -0
  62. package/dist/capture/exclusionPrelude.js +14 -0
  63. package/dist/capture/exclusionPrelude.js.map +1 -0
  64. package/dist/capture/exclusionToken.js +23 -0
  65. package/dist/capture/exclusionToken.js.map +1 -0
  66. package/dist/capture/jsLiteral.js +19 -0
  67. package/dist/capture/jsLiteral.js.map +1 -0
  68. package/dist/capture/mountPath.js +2 -3
  69. package/dist/capture/mountPath.js.map +1 -1
  70. package/dist/capture/proxyEndpoint.js +48 -95
  71. package/dist/capture/proxyEndpoint.js.map +1 -1
  72. package/dist/capture/proxyRoutes.js +58 -21
  73. package/dist/capture/proxyRoutes.js.map +1 -1
  74. package/dist/capture/relay.js +91 -0
  75. package/dist/capture/relay.js.map +1 -0
  76. package/dist/capture/requestBody.js +2 -6
  77. package/dist/capture/requestBody.js.map +1 -1
  78. package/dist/capture/requestTrust.js +45 -0
  79. package/dist/capture/requestTrust.js.map +1 -0
  80. package/dist/capture/sameSite.js +40 -0
  81. package/dist/capture/sameSite.js.map +1 -0
  82. package/dist/capture/slots.js +50 -25
  83. package/dist/capture/slots.js.map +1 -1
  84. package/dist/capture/trackerConfig.js +100 -36
  85. package/dist/capture/trackerConfig.js.map +1 -1
  86. package/dist/capture/trackerEndpoint.js +22 -21
  87. package/dist/capture/trackerEndpoint.js.map +1 -1
  88. package/dist/charts/BarList.d.ts +27 -14
  89. package/dist/charts/BarList.js +38 -83
  90. package/dist/charts/BarList.js.map +1 -1
  91. package/dist/charts/TrendChart.d.ts +40 -7
  92. package/dist/charts/TrendChart.js +243 -215
  93. package/dist/charts/TrendChart.js.map +1 -1
  94. package/dist/charts/bars.d.ts +15 -1
  95. package/dist/charts/bars.js +12 -12
  96. package/dist/charts/bars.js.map +1 -1
  97. package/dist/charts/bucket.js +106 -73
  98. package/dist/charts/bucket.js.map +1 -1
  99. package/dist/charts/inProgress.js +22 -0
  100. package/dist/charts/inProgress.js.map +1 -0
  101. package/dist/charts/series.d.ts +15 -0
  102. package/dist/charts/series.js +123 -0
  103. package/dist/charts/series.js.map +1 -0
  104. package/dist/charts/spline.js +91 -25
  105. package/dist/charts/spline.js.map +1 -1
  106. package/dist/charts/trendGeometry.js +91 -0
  107. package/dist/charts/trendGeometry.js.map +1 -0
  108. package/dist/core/adminOptions.d.ts +1 -0
  109. package/dist/core/adminOptions.js +193 -0
  110. package/dist/core/adminOptions.js.map +1 -0
  111. package/dist/core/budget.js +24 -0
  112. package/dist/core/budget.js.map +1 -0
  113. package/dist/core/cacheKey.d.ts +1 -0
  114. package/dist/core/cacheKey.js +48 -37
  115. package/dist/core/cacheKey.js.map +1 -1
  116. package/dist/core/cacheOptions.js +165 -0
  117. package/dist/core/cacheOptions.js.map +1 -0
  118. package/dist/core/capabilities.d.ts +24 -11
  119. package/dist/core/capabilities.js +96 -17
  120. package/dist/core/capabilities.js.map +1 -1
  121. package/dist/core/capture.d.ts +26 -25
  122. package/dist/core/captureOptions.d.ts +1 -0
  123. package/dist/core/captureOptions.js +258 -0
  124. package/dist/core/captureOptions.js.map +1 -0
  125. package/dist/core/clock.js +13 -0
  126. package/dist/core/clock.js.map +1 -0
  127. package/dist/core/collectionOption.d.ts +17 -0
  128. package/dist/core/collectionOption.js +104 -0
  129. package/dist/core/collectionOption.js.map +1 -0
  130. package/dist/core/collectionSlug.js +7 -0
  131. package/dist/core/collectionSlug.js.map +1 -0
  132. package/dist/core/contract.d.ts +285 -59
  133. package/dist/core/contract.js +6 -4
  134. package/dist/core/contract.js.map +1 -1
  135. package/dist/core/cron.js +57 -0
  136. package/dist/core/cron.js.map +1 -0
  137. package/dist/core/fetch.d.ts +17 -0
  138. package/dist/core/goalOptions.d.ts +1 -0
  139. package/dist/core/goalOptions.js +166 -0
  140. package/dist/core/goalOptions.js.map +1 -0
  141. package/dist/core/granularity.js +3 -2
  142. package/dist/core/granularity.js.map +1 -1
  143. package/dist/core/guards.js +17 -0
  144. package/dist/core/guards.js.map +1 -0
  145. package/dist/core/jobs.d.ts +40 -0
  146. package/dist/core/jobs.js +132 -0
  147. package/dist/core/jobs.js.map +1 -0
  148. package/dist/core/legacyOptions.js +145 -0
  149. package/dist/core/legacyOptions.js.map +1 -0
  150. package/dist/core/metricAliases.js +81 -0
  151. package/dist/core/metricAliases.js.map +1 -0
  152. package/dist/core/metricValues.js +57 -0
  153. package/dist/core/metricValues.js.map +1 -0
  154. package/dist/core/monotonic.js +10 -0
  155. package/dist/core/monotonic.js.map +1 -0
  156. package/dist/core/optionChecks.js +51 -0
  157. package/dist/core/optionChecks.js.map +1 -0
  158. package/dist/core/options.d.ts +473 -157
  159. package/dist/core/options.js +154 -219
  160. package/dist/core/options.js.map +1 -1
  161. package/dist/core/registry.js +45 -5
  162. package/dist/core/registry.js.map +1 -1
  163. package/dist/core/scopeList.js +7 -9
  164. package/dist/core/scopeList.js.map +1 -1
  165. package/dist/core/scopeOptions.d.ts +1 -0
  166. package/dist/core/scopeOptions.js +112 -0
  167. package/dist/core/scopeOptions.js.map +1 -0
  168. package/dist/core/scopedRead.js +182 -72
  169. package/dist/core/scopedRead.js.map +1 -1
  170. package/dist/core/sdks.d.ts +81 -0
  171. package/dist/core/sdks.js +23 -0
  172. package/dist/core/sdks.js.map +1 -0
  173. package/dist/core/serverEvent.d.ts +38 -20
  174. package/dist/core/serverEvent.js.map +1 -1
  175. package/dist/core/siteAddress.js +20 -0
  176. package/dist/core/siteAddress.js.map +1 -0
  177. package/dist/core/sourceErrors.js +109 -0
  178. package/dist/core/sourceErrors.js.map +1 -0
  179. package/dist/core/sourceOptions.js +94 -0
  180. package/dist/core/sourceOptions.js.map +1 -0
  181. package/dist/core/throttle.js +18 -0
  182. package/dist/core/throttle.js.map +1 -0
  183. package/dist/core/values.js +61 -0
  184. package/dist/core/values.js.map +1 -0
  185. package/dist/core/widgetSlugs.d.ts +17 -0
  186. package/dist/core/widgetSlugs.js +29 -0
  187. package/dist/core/widgetSlugs.js.map +1 -0
  188. package/dist/db/detachedWrite.js +36 -0
  189. package/dist/db/detachedWrite.js.map +1 -0
  190. package/dist/db/errors.js +182 -0
  191. package/dist/db/errors.js.map +1 -0
  192. package/dist/db/kind.js +32 -0
  193. package/dist/db/kind.js.map +1 -0
  194. package/dist/db/openTransaction.js +51 -0
  195. package/dist/db/openTransaction.js.map +1 -0
  196. package/dist/exports/adapters/contract.d.ts +14 -0
  197. package/dist/exports/adapters/ga4.d.ts +15 -1
  198. package/dist/exports/adapters/native.d.ts +26 -2
  199. package/dist/exports/adapters/native.js +4 -1
  200. package/dist/exports/adapters/plausible.d.ts +15 -1
  201. package/dist/exports/adapters/posthog.d.ts +15 -1
  202. package/dist/exports/adapters/umami.d.ts +15 -1
  203. package/dist/exports/attributes.d.ts +42 -0
  204. package/dist/exports/attributes.js +83 -0
  205. package/dist/exports/attributes.js.map +1 -0
  206. package/dist/exports/client.d.ts +41 -13
  207. package/dist/exports/client.js +21 -9
  208. package/dist/exports/geo.d.ts +3 -1
  209. package/dist/exports/geo.js +1 -1
  210. package/dist/exports/i18n.d.ts +2 -2
  211. package/dist/exports/i18n.js +2 -2
  212. package/dist/exports/migrations.d.ts +2 -0
  213. package/dist/exports/migrations.js +2 -0
  214. package/dist/exports/next.d.ts +18 -1
  215. package/dist/exports/next.js +3 -1
  216. package/dist/exports/react.d.ts +3 -2
  217. package/dist/exports/react.js +1 -2
  218. package/dist/exports/rsc.d.ts +31 -14
  219. package/dist/exports/rsc.js +11 -6
  220. package/dist/exports/site.d.ts +5 -0
  221. package/dist/exports/site.js +3 -0
  222. package/dist/exports/testing.d.ts +17 -0
  223. package/dist/exports/testing.js +3 -0
  224. package/dist/exports/tracker.d.ts +5 -20
  225. package/dist/exports/tracker.js +3 -14
  226. package/dist/exports/types.d.ts +40 -14
  227. package/dist/exports/types.js +5 -1
  228. package/dist/fields/AnalyticsPanelClient.js +265 -154
  229. package/dist/fields/AnalyticsPanelClient.js.map +1 -1
  230. package/dist/fields/AnalyticsPanelField.d.ts +20 -8
  231. package/dist/fields/AnalyticsPanelField.js +121 -30
  232. package/dist/fields/AnalyticsPanelField.js.map +1 -1
  233. package/dist/fields/AnalyticsStatField.d.ts +18 -7
  234. package/dist/fields/AnalyticsStatField.js +98 -63
  235. package/dist/fields/AnalyticsStatField.js.map +1 -1
  236. package/dist/fields/FieldShimmer.js +15 -0
  237. package/dist/fields/FieldShimmer.js.map +1 -0
  238. package/dist/fields/PanelContent.js +217 -0
  239. package/dist/fields/PanelContent.js.map +1 -0
  240. package/dist/fields/PanelList.js +82 -0
  241. package/dist/fields/PanelList.js.map +1 -0
  242. package/dist/fields/PanelLiveCounter.js +63 -0
  243. package/dist/fields/PanelLiveCounter.js.map +1 -0
  244. package/dist/fields/PanelSkeleton.js +63 -0
  245. package/dist/fields/PanelSkeleton.js.map +1 -0
  246. package/dist/fields/componentPaths.js +8 -0
  247. package/dist/fields/componentPaths.js.map +1 -0
  248. package/dist/fields/config/FilterDimensionSelectField.d.ts +2 -2
  249. package/dist/fields/config/FilterDimensionSelectField.js +26 -54
  250. package/dist/fields/config/FilterDimensionSelectField.js.map +1 -1
  251. package/dist/fields/config/FilterKeySelect.js +66 -0
  252. package/dist/fields/config/FilterKeySelect.js.map +1 -0
  253. package/dist/fields/config/FilterOperatorSelectField.d.ts +7 -2
  254. package/dist/fields/config/FilterOperatorSelectField.js +37 -53
  255. package/dist/fields/config/FilterOperatorSelectField.js.map +1 -1
  256. package/dist/fields/config/FilterValueField.d.ts +17 -0
  257. package/dist/fields/config/FilterValueField.js +130 -0
  258. package/dist/fields/config/FilterValueField.js.map +1 -0
  259. package/dist/fields/config/MetricSelectField.d.ts +5 -12
  260. package/dist/fields/config/MetricSelectField.js +18 -30
  261. package/dist/fields/config/MetricSelectField.js.map +1 -1
  262. package/dist/fields/config/OptionSelect.js +52 -0
  263. package/dist/fields/config/OptionSelect.js.map +1 -0
  264. package/dist/fields/config/SourceSelectField.js +16 -31
  265. package/dist/fields/config/SourceSelectField.js.map +1 -1
  266. package/dist/fields/config/fetchSources.js +14 -26
  267. package/dist/fields/config/fetchSources.js.map +1 -1
  268. package/dist/fields/config/filterValues.js +106 -0
  269. package/dist/fields/config/filterValues.js.map +1 -0
  270. package/dist/fields/config/narrow.js +8 -10
  271. package/dist/fields/config/narrow.js.map +1 -1
  272. package/dist/fields/config/retiredPickers.d.ts +45 -0
  273. package/dist/fields/config/retiredPickers.js +46 -0
  274. package/dist/fields/config/retiredPickers.js.map +1 -0
  275. package/dist/fields/config/scopedFields.d.ts +40 -0
  276. package/dist/fields/config/scopedFields.js +68 -0
  277. package/dist/fields/config/scopedFields.js.map +1 -0
  278. package/dist/fields/config/toSelectOption.js +13 -7
  279. package/dist/fields/config/toSelectOption.js.map +1 -1
  280. package/dist/fields/config/useAnalyticsSources.d.ts +5 -7
  281. package/dist/fields/config/useAnalyticsSources.js +17 -21
  282. package/dist/fields/config/useAnalyticsSources.js.map +1 -1
  283. package/dist/fields/config/useFilterCapabilities.d.ts +9 -6
  284. package/dist/fields/config/useFilterCapabilities.js +23 -15
  285. package/dist/fields/config/useFilterCapabilities.js.map +1 -1
  286. package/dist/fields/config/useFormString.js +12 -0
  287. package/dist/fields/config/useFormString.js.map +1 -0
  288. package/dist/fields/dateRange/field.js +7 -19
  289. package/dist/fields/dateRange/field.js.map +1 -1
  290. package/dist/fields/dateRange/types.d.ts +5 -1
  291. package/dist/fields/dateRange/ui.d.ts +3 -2
  292. package/dist/fields/dateRange/ui.js +57 -319
  293. package/dist/fields/dateRange/ui.js.map +1 -1
  294. package/dist/fields/documentScope.js +21 -0
  295. package/dist/fields/documentScope.js.map +1 -0
  296. package/dist/fields/emptyState.js +31 -26
  297. package/dist/fields/emptyState.js.map +1 -1
  298. package/dist/fields/factories.d.ts +35 -16
  299. package/dist/fields/factories.js +66 -37
  300. package/dist/fields/factories.js.map +1 -1
  301. package/dist/fields/format.d.ts +12 -3
  302. package/dist/fields/format.js +77 -13
  303. package/dist/fields/format.js.map +1 -1
  304. package/dist/fields/itemReport.js +45 -0
  305. package/dist/fields/itemReport.js.map +1 -0
  306. package/dist/fields/readForDocument.d.ts +78 -26
  307. package/dist/fields/readForDocument.js +446 -116
  308. package/dist/fields/readForDocument.js.map +1 -1
  309. package/dist/fields/stateKeys.js +20 -0
  310. package/dist/fields/stateKeys.js.map +1 -0
  311. package/dist/goals/GoalAmountField.d.ts +10 -0
  312. package/dist/goals/GoalAmountField.js +162 -0
  313. package/dist/goals/GoalAmountField.js.map +1 -0
  314. package/dist/goals/GoalSelectField.js +89 -40
  315. package/dist/goals/GoalSelectField.js.map +1 -1
  316. package/dist/goals/GoalSelectFieldServer.d.ts +13 -0
  317. package/dist/goals/GoalSelectFieldServer.js +21 -0
  318. package/dist/goals/GoalSelectFieldServer.js.map +1 -0
  319. package/dist/goals/amountField.d.ts +20 -0
  320. package/dist/goals/amountField.js +37 -0
  321. package/dist/goals/amountField.js.map +1 -0
  322. package/dist/goals/builtin.js +17 -0
  323. package/dist/goals/builtin.js.map +1 -0
  324. package/dist/goals/collection.d.ts +22 -0
  325. package/dist/goals/collection.js +141 -100
  326. package/dist/goals/collection.js.map +1 -1
  327. package/dist/goals/constants.d.ts +38 -0
  328. package/dist/goals/constants.js +49 -0
  329. package/dist/goals/constants.js.map +1 -0
  330. package/dist/goals/currency.d.ts +16 -0
  331. package/dist/goals/currency.js +46 -4
  332. package/dist/goals/currency.js.map +1 -1
  333. package/dist/goals/currencyOptions.js +70 -0
  334. package/dist/goals/currencyOptions.js.map +1 -0
  335. package/dist/goals/fetchGoals.d.ts +10 -0
  336. package/dist/goals/fetchGoals.js +12 -26
  337. package/dist/goals/fetchGoals.js.map +1 -1
  338. package/dist/goals/goalField.d.ts +4 -6
  339. package/dist/goals/goalField.js +9 -19
  340. package/dist/goals/goalField.js.map +1 -1
  341. package/dist/goals/goalsEndpoint.js +39 -40
  342. package/dist/goals/goalsEndpoint.js.map +1 -1
  343. package/dist/goals/items.js +35 -0
  344. package/dist/goals/items.js.map +1 -0
  345. package/dist/goals/latent.js +9 -0
  346. package/dist/goals/latent.js.map +1 -0
  347. package/dist/goals/linkFields.d.ts +35 -0
  348. package/dist/goals/linkFields.js +31 -0
  349. package/dist/goals/linkFields.js.map +1 -0
  350. package/dist/goals/match.d.ts +14 -0
  351. package/dist/goals/match.js +67 -46
  352. package/dist/goals/match.js.map +1 -1
  353. package/dist/goals/moneyFields.js +56 -0
  354. package/dist/goals/moneyFields.js.map +1 -0
  355. package/dist/goals/pathMatch.js +122 -0
  356. package/dist/goals/pathMatch.js.map +1 -0
  357. package/dist/goals/placeholder.js +12 -0
  358. package/dist/goals/placeholder.js.map +1 -0
  359. package/dist/goals/resolver.d.ts +3 -3
  360. package/dist/goals/resolver.js +154 -46
  361. package/dist/goals/resolver.js.map +1 -1
  362. package/dist/goals/serverRevenue.d.ts +60 -0
  363. package/dist/goals/serverRevenue.js +41 -0
  364. package/dist/goals/serverRevenue.js.map +1 -0
  365. package/dist/goals/trackGoalAction.d.ts +26 -27
  366. package/dist/goals/trackGoalAction.js +38 -52
  367. package/dist/goals/trackGoalAction.js.map +1 -1
  368. package/dist/goals/types.d.ts +13 -28
  369. package/dist/goals/types.js +1 -1
  370. package/dist/goals/types.js.map +1 -1
  371. package/dist/goals/useAnalyticsGoals.d.ts +6 -5
  372. package/dist/goals/useAnalyticsGoals.js +17 -18
  373. package/dist/goals/useAnalyticsGoals.js.map +1 -1
  374. package/dist/index.d.ts +63 -11
  375. package/dist/index.js +257 -247
  376. package/dist/index.js.map +1 -1
  377. package/dist/items/collectionIdType.js +20 -0
  378. package/dist/items/collectionIdType.js.map +1 -0
  379. package/dist/items/idType.js +31 -0
  380. package/dist/items/idType.js.map +1 -0
  381. package/dist/items/ref.js +73 -0
  382. package/dist/items/ref.js.map +1 -0
  383. package/dist/maintenance/apiTaskState.js +141 -0
  384. package/dist/maintenance/apiTaskState.js.map +1 -0
  385. package/dist/maintenance/heartbeat.js +51 -0
  386. package/dist/maintenance/heartbeat.js.map +1 -0
  387. package/dist/maintenance/lease.d.ts +1 -0
  388. package/dist/maintenance/lease.js +81 -0
  389. package/dist/maintenance/lease.js.map +1 -0
  390. package/dist/maintenance/taskSchedule.d.ts +1 -0
  391. package/dist/maintenance/taskSchedule.js +62 -0
  392. package/dist/maintenance/taskSchedule.js.map +1 -0
  393. package/dist/maintenance/underLease.js +35 -0
  394. package/dist/maintenance/underLease.js.map +1 -0
  395. package/dist/migrations/legacy.d.ts +54 -0
  396. package/dist/migrations/legacy.js +117 -0
  397. package/dist/migrations/legacy.js.map +1 -0
  398. package/dist/migrations/predefined/dropLegacyMongo.d.ts +11 -0
  399. package/dist/migrations/predefined/dropLegacyMongo.js +12 -0
  400. package/dist/migrations/predefined/dropLegacyMongo.js.map +1 -0
  401. package/dist/native/collections/aggregates.js +54 -0
  402. package/dist/native/collections/aggregates.js.map +1 -0
  403. package/dist/native/collections/hits.js +102 -0
  404. package/dist/native/collections/hits.js.map +1 -0
  405. package/dist/native/collections/slugs.d.ts +10 -0
  406. package/dist/native/collections/slugs.js +16 -0
  407. package/dist/native/collections/slugs.js.map +1 -0
  408. package/dist/native/collections/state.js +84 -0
  409. package/dist/native/collections/state.js.map +1 -0
  410. package/dist/native/collections/storeCollection.js +29 -0
  411. package/dist/native/collections/storeCollection.js.map +1 -0
  412. package/dist/native/engine/buckets.d.ts +1 -0
  413. package/dist/native/engine/buckets.js +53 -0
  414. package/dist/native/engine/buckets.js.map +1 -0
  415. package/dist/native/engine/capabilities.js +87 -0
  416. package/dist/native/engine/capabilities.js.map +1 -0
  417. package/dist/native/engine/cost.js +72 -0
  418. package/dist/native/engine/cost.js.map +1 -0
  419. package/dist/native/engine/days.d.ts +1 -0
  420. package/dist/native/engine/days.js +182 -0
  421. package/dist/native/engine/days.js.map +1 -0
  422. package/dist/native/engine/engine.d.ts +1 -0
  423. package/dist/native/engine/engine.js +1623 -0
  424. package/dist/native/engine/engine.js.map +1 -0
  425. package/dist/native/engine/instance.js +58 -0
  426. package/dist/native/engine/instance.js.map +1 -0
  427. package/dist/native/engine/maintenance.d.ts +1 -0
  428. package/dist/native/engine/maintenance.js +677 -0
  429. package/dist/native/engine/maintenance.js.map +1 -0
  430. package/dist/native/engine/merge.js +41 -0
  431. package/dist/native/engine/merge.js.map +1 -0
  432. package/dist/native/engine/nudge.js +26 -0
  433. package/dist/native/engine/nudge.js.map +1 -0
  434. package/dist/native/engine/planner.js +198 -0
  435. package/dist/native/engine/planner.js.map +1 -0
  436. package/dist/native/engine/rebuild.d.ts +22 -0
  437. package/dist/native/engine/rebuild.js +76 -0
  438. package/dist/native/engine/rebuild.js.map +1 -0
  439. package/dist/native/engine/recent.js +17 -0
  440. package/dist/native/engine/recent.js.map +1 -0
  441. package/dist/native/engine/salt.d.ts +1 -0
  442. package/dist/native/engine/salt.js +98 -0
  443. package/dist/native/engine/salt.js.map +1 -0
  444. package/dist/native/engine/siteHosts.d.ts +1 -0
  445. package/dist/native/engine/siteHosts.js +58 -0
  446. package/dist/native/engine/siteHosts.js.map +1 -0
  447. package/dist/native/engine/toHit.js +108 -0
  448. package/dist/native/engine/toHit.js.map +1 -0
  449. package/dist/native/engine/writeBuffer.d.ts +14 -0
  450. package/dist/native/engine/writeBuffer.js +317 -0
  451. package/dist/native/engine/writeBuffer.js.map +1 -0
  452. package/dist/native/geo/composeGeoResolvers.d.ts +1 -0
  453. package/dist/native/geo/composeGeoResolvers.js +4 -1
  454. package/dist/native/geo/composeGeoResolvers.js.map +1 -1
  455. package/dist/native/geo/geoResolver.d.ts +20 -2
  456. package/dist/native/geo/geoResolver.js +42 -6
  457. package/dist/native/geo/geoResolver.js.map +1 -1
  458. package/dist/native/geo/maxmindResolver.d.ts +8 -4
  459. package/dist/native/geo/maxmindResolver.js +20 -16
  460. package/dist/native/geo/maxmindResolver.js.map +1 -1
  461. package/dist/native/geo/resolveGeo.js +31 -0
  462. package/dist/native/geo/resolveGeo.js.map +1 -0
  463. package/dist/native/ingest/bots.d.ts +2 -3
  464. package/dist/native/ingest/bots.js +8 -13
  465. package/dist/native/ingest/bots.js.map +1 -1
  466. package/dist/native/ingest/browser.js +4 -6
  467. package/dist/native/ingest/browser.js.map +1 -1
  468. package/dist/native/ingest/clientIp.js +30 -9
  469. package/dist/native/ingest/clientIp.js.map +1 -1
  470. package/dist/native/ingest/device.js +4 -6
  471. package/dist/native/ingest/device.js.map +1 -1
  472. package/dist/native/ingest/endpoint.d.ts +1 -1
  473. package/dist/native/ingest/endpoint.js +119 -34
  474. package/dist/native/ingest/endpoint.js.map +1 -1
  475. package/dist/native/ingest/itemSignature.d.ts +26 -0
  476. package/dist/native/ingest/itemSignature.js +45 -0
  477. package/dist/native/ingest/itemSignature.js.map +1 -0
  478. package/dist/native/ingest/language.js +2 -3
  479. package/dist/native/ingest/language.js.map +1 -1
  480. package/dist/native/ingest/normalizeEvent.d.ts +60 -7
  481. package/dist/native/ingest/normalizeEvent.js +226 -61
  482. package/dist/native/ingest/normalizeEvent.js.map +1 -1
  483. package/dist/native/ingest/orderSignature.d.ts +13 -0
  484. package/dist/native/ingest/orderSignature.js +50 -0
  485. package/dist/native/ingest/orderSignature.js.map +1 -0
  486. package/dist/native/ingest/referrer.js +30 -32
  487. package/dist/native/ingest/referrer.js.map +1 -1
  488. package/dist/native/ingest/requestHost.js +10 -23
  489. package/dist/native/ingest/requestHost.js.map +1 -1
  490. package/dist/native/ingest/resolveHostname.d.ts +4 -13
  491. package/dist/native/ingest/resolveHostname.js +5 -6
  492. package/dist/native/ingest/resolveHostname.js.map +1 -1
  493. package/dist/native/ingest/revenue.d.ts +1 -0
  494. package/dist/native/ingest/revenue.js +121 -0
  495. package/dist/native/ingest/revenue.js.map +1 -0
  496. package/dist/native/ingest/route.d.ts +10 -0
  497. package/dist/native/ingest/route.js +82 -0
  498. package/dist/native/ingest/route.js.map +1 -0
  499. package/dist/native/ingest/serverTrack.d.ts +2 -10
  500. package/dist/native/ingest/serverTrack.js +181 -72
  501. package/dist/native/ingest/serverTrack.js.map +1 -1
  502. package/dist/native/ingest/signature.js +28 -0
  503. package/dist/native/ingest/signature.js.map +1 -0
  504. package/dist/native/ingest/source.d.ts +2 -3
  505. package/dist/native/ingest/source.js +35 -54
  506. package/dist/native/ingest/source.js.map +1 -1
  507. package/dist/native/ingest/utm.js +9 -9
  508. package/dist/native/ingest/utm.js.map +1 -1
  509. package/dist/native/ingest/validate.js +20 -10
  510. package/dist/native/ingest/validate.js.map +1 -1
  511. package/dist/native/ingest/visitorHash.js +6 -8
  512. package/dist/native/ingest/visitorHash.js.map +1 -1
  513. package/dist/native/nativeAdapter.d.ts +101 -33
  514. package/dist/native/nativeAdapter.js +375 -317
  515. package/dist/native/nativeAdapter.js.map +1 -1
  516. package/dist/native/rebuildDays.d.ts +12 -0
  517. package/dist/native/rebuildDays.js +16 -0
  518. package/dist/native/rebuildDays.js.map +1 -0
  519. package/dist/native/store/aggregate.js +450 -0
  520. package/dist/native/store/aggregate.js.map +1 -0
  521. package/dist/native/store/caps.d.ts +18 -0
  522. package/dist/native/store/caps.js +76 -0
  523. package/dist/native/store/caps.js.map +1 -0
  524. package/dist/native/store/chunks.js +34 -0
  525. package/dist/native/store/chunks.js.map +1 -0
  526. package/dist/native/store/columnValues.js +31 -0
  527. package/dist/native/store/columnValues.js.map +1 -0
  528. package/dist/native/store/dialect.js +106 -0
  529. package/dist/native/store/dialect.js.map +1 -0
  530. package/dist/native/store/eventStore.js +44 -0
  531. package/dist/native/store/eventStore.js.map +1 -0
  532. package/dist/native/store/hitRow.js +116 -0
  533. package/dist/native/store/hitRow.js.map +1 -0
  534. package/dist/native/store/hits.js +63 -0
  535. package/dist/native/store/hits.js.map +1 -0
  536. package/dist/native/store/ids.js +105 -0
  537. package/dist/native/store/ids.js.map +1 -0
  538. package/dist/native/store/mongo/aggregatePipelines.js +430 -0
  539. package/dist/native/store/mongo/aggregatePipelines.js.map +1 -0
  540. package/dist/native/store/mongo/mongoState.js +375 -0
  541. package/dist/native/store/mongo/mongoState.js.map +1 -0
  542. package/dist/native/store/mongo/mongoStore.js +618 -0
  543. package/dist/native/store/mongo/mongoStore.js.map +1 -0
  544. package/dist/native/store/mongo/pipelines.js +695 -0
  545. package/dist/native/store/mongo/pipelines.js.map +1 -0
  546. package/dist/native/store/mongo/results.js +20 -0
  547. package/dist/native/store/mongo/results.js.map +1 -0
  548. package/dist/native/store/parts.d.ts +1 -0
  549. package/dist/native/store/parts.js +95 -0
  550. package/dist/native/store/parts.js.map +1 -0
  551. package/dist/native/store/pattern.js +213 -0
  552. package/dist/native/store/pattern.js.map +1 -0
  553. package/dist/native/store/rawRead.d.ts +23 -0
  554. package/dist/native/store/rawRead.js +384 -0
  555. package/dist/native/store/rawRead.js.map +1 -0
  556. package/dist/native/store/reclassify.js +53 -0
  557. package/dist/native/store/reclassify.js.map +1 -0
  558. package/dist/native/store/sql/aggregateSql.js +345 -0
  559. package/dist/native/store/sql/aggregateSql.js.map +1 -0
  560. package/dist/native/store/sql/columns.js +48 -0
  561. package/dist/native/store/sql/columns.js.map +1 -0
  562. package/dist/native/store/sql/compile.js +656 -0
  563. package/dist/native/store/sql/compile.js.map +1 -0
  564. package/dist/native/store/sql/drivers.js +218 -0
  565. package/dist/native/store/sql/drivers.js.map +1 -0
  566. package/dist/native/store/sql/executor.js +132 -0
  567. package/dist/native/store/sql/executor.js.map +1 -0
  568. package/dist/native/store/sql/fragment.js +104 -0
  569. package/dist/native/store/sql/fragment.js.map +1 -0
  570. package/dist/native/store/sql/maintenanceSql.js +59 -0
  571. package/dist/native/store/sql/maintenanceSql.js.map +1 -0
  572. package/dist/native/store/sql/ownConnection.js +107 -0
  573. package/dist/native/store/sql/ownConnection.js.map +1 -0
  574. package/dist/native/store/sql/poolShare.js +101 -0
  575. package/dist/native/store/sql/poolShare.js.map +1 -0
  576. package/dist/native/store/sql/sqlState.js +325 -0
  577. package/dist/native/store/sql/sqlState.js.map +1 -0
  578. package/dist/native/store/sql/sqlStore.js +355 -0
  579. package/dist/native/store/sql/sqlStore.js.map +1 -0
  580. package/dist/native/store/sql/sqliteThread.d.ts +9 -0
  581. package/dist/native/store/sql/sqliteThread.js +314 -0
  582. package/dist/native/store/sql/sqliteThread.js.map +1 -0
  583. package/dist/native/store/sql/sqliteWorker.js +327 -0
  584. package/dist/native/store/sql/sqliteWorker.js.map +1 -0
  585. package/dist/native/store/sql/sqliteWorkerSource.js +347 -0
  586. package/dist/native/store/sql/sqliteWorkerSource.js.map +1 -0
  587. package/dist/native/store/state.js +151 -0
  588. package/dist/native/store/state.js.map +1 -0
  589. package/dist/native/store/stateStore.js +29 -0
  590. package/dist/native/store/stateStore.js.map +1 -0
  591. package/dist/native/store/types.d.ts +9 -0
  592. package/dist/native/tasks/maintainTask.d.ts +19 -0
  593. package/dist/native/tasks/maintainTask.js +68 -0
  594. package/dist/native/tasks/maintainTask.js.map +1 -0
  595. package/dist/net/guardedFetch.d.ts +32 -0
  596. package/dist/net/guardedFetch.js +220 -0
  597. package/dist/net/guardedFetch.js.map +1 -0
  598. package/dist/net/origin.js +40 -0
  599. package/dist/net/origin.js.map +1 -0
  600. package/dist/net/platform.d.ts +9 -0
  601. package/dist/net/platform.js +35 -0
  602. package/dist/net/platform.js.map +1 -0
  603. package/dist/next/captureRewrites.d.ts +4 -24
  604. package/dist/next/captureRewrites.js +6 -50
  605. package/dist/next/captureRewrites.js.map +1 -1
  606. package/dist/next/captureRoute.d.ts +28 -0
  607. package/dist/next/captureRoute.js +67 -0
  608. package/dist/next/captureRoute.js.map +1 -0
  609. package/dist/next/ingestRoute.d.ts +17 -0
  610. package/dist/next/ingestRoute.js +17 -0
  611. package/dist/next/ingestRoute.js.map +1 -0
  612. package/dist/next/posthogProxyRewrites.d.ts +3 -25
  613. package/dist/next/posthogProxyRewrites.js +5 -37
  614. package/dist/next/posthogProxyRewrites.js.map +1 -1
  615. package/dist/plugin/adminDependencies.js +34 -0
  616. package/dist/plugin/adminDependencies.js.map +1 -0
  617. package/dist/plugin/apiPath.js +23 -0
  618. package/dist/plugin/apiPath.js.map +1 -0
  619. package/dist/plugin/boundDocument.js +58 -0
  620. package/dist/plugin/boundDocument.js.map +1 -0
  621. package/dist/plugin/buildPhase.js +10 -0
  622. package/dist/plugin/buildPhase.js.map +1 -0
  623. package/dist/plugin/collectionChecks.js +232 -0
  624. package/dist/plugin/collectionChecks.js.map +1 -0
  625. package/dist/plugin/collectionFields.d.ts +13 -0
  626. package/dist/plugin/collectionFields.js +22 -0
  627. package/dist/plugin/collectionFields.js.map +1 -0
  628. package/dist/plugin/createRuntime.js +336 -0
  629. package/dist/plugin/createRuntime.js.map +1 -0
  630. package/dist/plugin/destroy.js +58 -0
  631. package/dist/plugin/destroy.js.map +1 -0
  632. package/dist/plugin/documentEndpoint.js +76 -53
  633. package/dist/plugin/documentEndpoint.js.map +1 -1
  634. package/dist/plugin/documentScopes.js +37 -0
  635. package/dist/plugin/documentScopes.js.map +1 -0
  636. package/dist/plugin/encrypted.js +25 -0
  637. package/dist/plugin/encrypted.js.map +1 -0
  638. package/dist/plugin/errors.d.ts +5 -12
  639. package/dist/plugin/errors.js +23 -16
  640. package/dist/plugin/errors.js.map +1 -1
  641. package/dist/plugin/flagsEndpoint.js +41 -0
  642. package/dist/plugin/flagsEndpoint.js.map +1 -0
  643. package/dist/plugin/goalHint.js +22 -11
  644. package/dist/plugin/goalHint.js.map +1 -1
  645. package/dist/plugin/itemLabels.js +114 -0
  646. package/dist/plugin/itemLabels.js.map +1 -0
  647. package/dist/plugin/jobsAccess.js +91 -0
  648. package/dist/plugin/jobsAccess.js.map +1 -0
  649. package/dist/plugin/keepAlive.js +48 -0
  650. package/dist/plugin/keepAlive.js.map +1 -0
  651. package/dist/plugin/peerImportError.js +3 -6
  652. package/dist/plugin/peerImportError.js.map +1 -1
  653. package/dist/plugin/peers.js +64 -0
  654. package/dist/plugin/peers.js.map +1 -0
  655. package/dist/plugin/pluginCollections.js +155 -0
  656. package/dist/plugin/pluginCollections.js.map +1 -0
  657. package/dist/plugin/queryEndpoint.js +69 -44
  658. package/dist/plugin/queryEndpoint.js.map +1 -1
  659. package/dist/plugin/queryParams.js +7 -0
  660. package/dist/plugin/queryParams.js.map +1 -0
  661. package/dist/plugin/readContextForRequest.js +52 -17
  662. package/dist/plugin/readContextForRequest.js.map +1 -1
  663. package/dist/plugin/readFailure.js +22 -0
  664. package/dist/plugin/readFailure.js.map +1 -0
  665. package/dist/plugin/readableProviders.js +64 -0
  666. package/dist/plugin/readableProviders.js.map +1 -0
  667. package/dist/plugin/realtimeEndpoint.js +77 -25
  668. package/dist/plugin/realtimeEndpoint.js.map +1 -1
  669. package/dist/plugin/refreshEndpoint.js +69 -44
  670. package/dist/plugin/refreshEndpoint.js.map +1 -1
  671. package/dist/plugin/relabelFields.js +36 -0
  672. package/dist/plugin/relabelFields.js.map +1 -0
  673. package/dist/plugin/requestMemo.js +35 -0
  674. package/dist/plugin/requestMemo.js.map +1 -0
  675. package/dist/plugin/routeChecks.js +39 -0
  676. package/dist/plugin/routeChecks.js.map +1 -0
  677. package/dist/plugin/routes.d.ts +53 -0
  678. package/dist/plugin/routes.js +92 -0
  679. package/dist/plugin/routes.js.map +1 -0
  680. package/dist/plugin/runtime.d.ts +1 -1
  681. package/dist/plugin/runtime.js +226 -30
  682. package/dist/plugin/runtime.js.map +1 -1
  683. package/dist/plugin/schemaOnly.js +63 -0
  684. package/dist/plugin/schemaOnly.js.map +1 -0
  685. package/dist/plugin/scopeChange.js +6 -5
  686. package/dist/plugin/scopeChange.js.map +1 -1
  687. package/dist/plugin/scopeFieldBoot.js +4 -4
  688. package/dist/plugin/scopeFieldBoot.js.map +1 -1
  689. package/dist/plugin/scopeToken.js +33 -0
  690. package/dist/plugin/scopeToken.js.map +1 -0
  691. package/dist/plugin/sourcesEndpoint.js +46 -12
  692. package/dist/plugin/sourcesEndpoint.js.map +1 -1
  693. package/dist/plugin/unbundledLanguages.js +25 -0
  694. package/dist/plugin/unbundledLanguages.js.map +1 -0
  695. package/dist/plugin/walkFields.js +22 -0
  696. package/dist/plugin/walkFields.js.map +1 -0
  697. package/dist/plugin/warmTask.js +0 -0
  698. package/dist/plugin/warmTask.js.map +1 -1
  699. package/dist/providers/access.d.ts +1 -0
  700. package/dist/providers/access.js +35 -26
  701. package/dist/providers/access.js.map +1 -1
  702. package/dist/providers/adapterPool.js +121 -0
  703. package/dist/providers/adapterPool.js.map +1 -0
  704. package/dist/providers/collection.d.ts +53 -0
  705. package/dist/providers/collection.js +274 -150
  706. package/dist/providers/collection.js.map +1 -1
  707. package/dist/providers/factory.d.ts +76 -0
  708. package/dist/providers/factory.js +76 -23
  709. package/dist/providers/factory.js.map +1 -1
  710. package/dist/providers/hosts.d.ts +25 -0
  711. package/dist/providers/hosts.js +128 -0
  712. package/dist/providers/hosts.js.map +1 -0
  713. package/dist/providers/probe.d.ts +1 -0
  714. package/dist/providers/probe.js +101 -0
  715. package/dist/providers/probe.js.map +1 -0
  716. package/dist/providers/refresh.d.ts +18 -0
  717. package/dist/providers/refresh.js +49 -0
  718. package/dist/providers/refresh.js.map +1 -0
  719. package/dist/providers/registry.js +318 -0
  720. package/dist/providers/registry.js.map +1 -0
  721. package/dist/providers/resolver.js +23 -88
  722. package/dist/providers/resolver.js.map +1 -1
  723. package/dist/providers/retarget.js +45 -0
  724. package/dist/providers/retarget.js.map +1 -0
  725. package/dist/providers/secrets.d.ts +26 -0
  726. package/dist/providers/secrets.js +61 -4
  727. package/dist/providers/secrets.js.map +1 -1
  728. package/dist/providers/stampScope.js +9 -6
  729. package/dist/providers/stampScope.js.map +1 -1
  730. package/dist/query/dates.js +10 -12
  731. package/dist/query/dates.js.map +1 -1
  732. package/dist/query/errors.d.ts +1 -5
  733. package/dist/query/fetchQuery.d.ts +25 -32
  734. package/dist/query/fetchQuery.js +91 -91
  735. package/dist/query/fetchQuery.js.map +1 -1
  736. package/dist/query/limits.js +8 -0
  737. package/dist/query/limits.js.map +1 -0
  738. package/dist/query/parse.d.ts +6 -0
  739. package/dist/query/parse.js +153 -106
  740. package/dist/query/parse.js.map +1 -1
  741. package/dist/query/response.d.ts +23 -3
  742. package/dist/query/response.js +12 -5
  743. package/dist/query/response.js.map +1 -1
  744. package/dist/react/AnalyticsProvider.d.ts +26 -17
  745. package/dist/react/AnalyticsProvider.js +23 -22
  746. package/dist/react/AnalyticsProvider.js.map +1 -1
  747. package/dist/react/TrackerBoot.js +15 -9
  748. package/dist/react/TrackerBoot.js.map +1 -1
  749. package/dist/react/useAnalytics.d.ts +2 -11
  750. package/dist/react/useAnalytics.js +22 -24
  751. package/dist/react/useAnalytics.js.map +1 -1
  752. package/dist/site/AnalyticsScripts.d.ts +34 -0
  753. package/dist/site/AnalyticsScripts.js +30 -0
  754. package/dist/site/AnalyticsScripts.js.map +1 -0
  755. package/dist/site/getTrackerConfig.d.ts +15 -0
  756. package/dist/site/getTrackerConfig.js +40 -0
  757. package/dist/site/getTrackerConfig.js.map +1 -0
  758. package/dist/surfacing/afterRead.d.ts +37 -0
  759. package/dist/surfacing/bounded.js +38 -0
  760. package/dist/surfacing/bounded.js.map +1 -0
  761. package/dist/surfacing/breaker.js +107 -0
  762. package/dist/surfacing/breaker.js.map +1 -0
  763. package/dist/surfacing/cacheCollection.d.ts +8 -0
  764. package/dist/surfacing/cacheCollection.js +69 -0
  765. package/dist/surfacing/cacheCollection.js.map +1 -0
  766. package/dist/surfacing/cacheStore.d.ts +71 -1
  767. package/dist/surfacing/cacheStore.js +16 -37
  768. package/dist/surfacing/cacheStore.js.map +1 -1
  769. package/dist/surfacing/cacheSweep.d.ts +1 -0
  770. package/dist/surfacing/cacheSweep.js +59 -0
  771. package/dist/surfacing/cacheSweep.js.map +1 -0
  772. package/dist/surfacing/classifyError.js +282 -0
  773. package/dist/surfacing/classifyError.js.map +1 -0
  774. package/dist/surfacing/coalesce.js +2 -1
  775. package/dist/surfacing/coalesce.js.map +1 -1
  776. package/dist/surfacing/coldBudget.js +60 -0
  777. package/dist/surfacing/coldBudget.js.map +1 -0
  778. package/dist/surfacing/collectionCacheStore.js +183 -0
  779. package/dist/surfacing/collectionCacheStore.js.map +1 -0
  780. package/dist/surfacing/engine.d.ts +1 -1
  781. package/dist/surfacing/engine.js +514 -72
  782. package/dist/surfacing/engine.js.map +1 -1
  783. package/dist/surfacing/epoch.js +70 -26
  784. package/dist/surfacing/epoch.js.map +1 -1
  785. package/dist/surfacing/lanes.d.ts +1 -0
  786. package/dist/surfacing/lanes.js +297 -0
  787. package/dist/surfacing/lanes.js.map +1 -0
  788. package/dist/surfacing/memo.js +40 -0
  789. package/dist/surfacing/memo.js.map +1 -0
  790. package/dist/surfacing/rateLimiter.d.ts +1 -0
  791. package/dist/surfacing/rateLimiter.js +69 -94
  792. package/dist/surfacing/rateLimiter.js.map +1 -1
  793. package/dist/surfacing/rebucket.js +178 -0
  794. package/dist/surfacing/rebucket.js.map +1 -0
  795. package/dist/surfacing/recipe.js +28 -0
  796. package/dist/surfacing/recipe.js.map +1 -0
  797. package/dist/surfacing/shape.js +22 -0
  798. package/dist/surfacing/shape.js.map +1 -0
  799. package/dist/surfacing/todaySplit.js +113 -0
  800. package/dist/surfacing/todaySplit.js.map +1 -0
  801. package/dist/sync/collection.d.ts +8 -0
  802. package/dist/sync/collection.js +28 -18
  803. package/dist/sync/collection.js.map +1 -1
  804. package/dist/sync/rekeyDurations.js +70 -0
  805. package/dist/sync/rekeyDurations.js.map +1 -0
  806. package/dist/sync/syncTask.js +226 -109
  807. package/dist/sync/syncTask.js.map +1 -1
  808. package/dist/testing/memoryAdapter.d.ts +6 -3
  809. package/dist/testing/memoryAdapter.js +12 -10
  810. package/dist/testing/memoryAdapter.js.map +1 -1
  811. package/dist/testing/settle.d.ts +11 -0
  812. package/dist/testing/settle.js +19 -0
  813. package/dist/testing/settle.js.map +1 -0
  814. package/dist/timeframe/calendar.js +65 -0
  815. package/dist/timeframe/calendar.js.map +1 -0
  816. package/dist/timeframe/comparison.js +46 -0
  817. package/dist/timeframe/comparison.js.map +1 -0
  818. package/dist/timeframe/presets.d.ts +1 -1
  819. package/dist/timeframe/presets.js +5 -5
  820. package/dist/timeframe/presets.js.map +1 -1
  821. package/dist/timeframe/reportingTimezone.d.ts +1 -0
  822. package/dist/timeframe/reportingTimezone.js +64 -0
  823. package/dist/timeframe/reportingTimezone.js.map +1 -0
  824. package/dist/timeframe/tz.js +55 -39
  825. package/dist/timeframe/tz.js.map +1 -1
  826. package/dist/tracker/autoCapture.js +125 -38
  827. package/dist/tracker/autoCapture.js.map +1 -1
  828. package/dist/tracker/campaign.js +52 -0
  829. package/dist/tracker/campaign.js.map +1 -0
  830. package/dist/tracker/config.d.ts +144 -0
  831. package/dist/tracker/config.js +25 -0
  832. package/dist/tracker/config.js.map +1 -0
  833. package/dist/tracker/createTracker.d.ts +4 -10
  834. package/dist/tracker/createTracker.js +386 -115
  835. package/dist/tracker/createTracker.js.map +1 -1
  836. package/dist/tracker/digest.js +28 -0
  837. package/dist/tracker/digest.js.map +1 -0
  838. package/dist/tracker/engagement.js +100 -0
  839. package/dist/tracker/engagement.js.map +1 -0
  840. package/dist/tracker/events.js +37 -0
  841. package/dist/tracker/events.js.map +1 -0
  842. package/dist/tracker/exclusion.d.ts +2 -22
  843. package/dist/tracker/exclusion.js +53 -21
  844. package/dist/tracker/exclusion.js.map +1 -1
  845. package/dist/tracker/gate.js +194 -0
  846. package/dist/tracker/gate.js.map +1 -0
  847. package/dist/tracker/initTracker.d.ts +5 -8
  848. package/dist/tracker/initTracker.js +42 -14
  849. package/dist/tracker/initTracker.js.map +1 -1
  850. package/dist/tracker/itemCapture.js +224 -0
  851. package/dist/tracker/itemCapture.js.map +1 -0
  852. package/dist/tracker/loadScript.js +21 -14
  853. package/dist/tracker/loadScript.js.map +1 -1
  854. package/dist/tracker/pageTracking.js +6 -6
  855. package/dist/tracker/pageTracking.js.map +1 -1
  856. package/dist/tracker/registry.js +118 -30
  857. package/dist/tracker/registry.js.map +1 -1
  858. package/dist/tracker/sinks/createSink.js +38 -0
  859. package/dist/tracker/sinks/createSink.js.map +1 -0
  860. package/dist/tracker/sinks/ga4.js +64 -20
  861. package/dist/tracker/sinks/ga4.js.map +1 -1
  862. package/dist/tracker/sinks/native.js +7 -42
  863. package/dist/tracker/sinks/native.js.map +1 -1
  864. package/dist/tracker/sinks/plausible.js +27 -22
  865. package/dist/tracker/sinks/plausible.js.map +1 -1
  866. package/dist/tracker/sinks/posthog.js +26 -22
  867. package/dist/tracker/sinks/posthog.js.map +1 -1
  868. package/dist/tracker/sinks/umami.js +14 -12
  869. package/dist/tracker/sinks/umami.js.map +1 -1
  870. package/dist/tracker/sinks/vendor.js +30 -27
  871. package/dist/tracker/sinks/vendor.js.map +1 -1
  872. package/dist/tracker/skip.js +81 -0
  873. package/dist/tracker/skip.js.map +1 -0
  874. package/dist/tracker/storage.js +23 -0
  875. package/dist/tracker/storage.js.map +1 -0
  876. package/dist/tracker/transport.js +2 -5
  877. package/dist/tracker/transport.js.map +1 -1
  878. package/dist/tracker/types.d.ts +86 -63
  879. package/dist/tracker/window.js +7 -0
  880. package/dist/tracker/window.js.map +1 -0
  881. package/dist/translations/ar.js +226 -71
  882. package/dist/translations/ar.js.map +1 -1
  883. package/dist/translations/de.js +215 -69
  884. package/dist/translations/de.js.map +1 -1
  885. package/dist/translations/en.js +209 -67
  886. package/dist/translations/en.js.map +1 -1
  887. package/dist/translations/es.js +217 -68
  888. package/dist/translations/es.js.map +1 -1
  889. package/dist/translations/fr.js +221 -72
  890. package/dist/translations/fr.js.map +1 -1
  891. package/dist/translations/id.js +212 -67
  892. package/dist/translations/id.js.map +1 -1
  893. package/dist/translations/index.d.ts +1 -1
  894. package/dist/translations/index.js +5 -7
  895. package/dist/translations/index.js.map +1 -1
  896. package/dist/translations/intl.js +71 -0
  897. package/dist/translations/intl.js.map +1 -0
  898. package/dist/translations/keys.d.ts +185 -14
  899. package/dist/translations/keys.js +190 -14
  900. package/dist/translations/keys.js.map +1 -1
  901. package/dist/translations/ko.js +214 -69
  902. package/dist/translations/ko.js.map +1 -1
  903. package/dist/translations/labelMap.d.ts +10 -0
  904. package/dist/translations/labelMap.js +22 -0
  905. package/dist/translations/labelMap.js.map +1 -0
  906. package/dist/translations/metricKeys.js +10 -2
  907. package/dist/translations/metricKeys.js.map +1 -1
  908. package/dist/translations/parts.js +20 -0
  909. package/dist/translations/parts.js.map +1 -0
  910. package/dist/translations/plural.js +61 -0
  911. package/dist/translations/plural.js.map +1 -0
  912. package/dist/translations/pt.js +226 -77
  913. package/dist/translations/pt.js.map +1 -1
  914. package/dist/translations/ru.js +217 -66
  915. package/dist/translations/ru.js.map +1 -1
  916. package/dist/translations/server.d.ts +1 -0
  917. package/dist/translations/server.js +2 -3
  918. package/dist/translations/server.js.map +1 -1
  919. package/dist/translations/staticLabel.js +69 -0
  920. package/dist/translations/staticLabel.js.map +1 -0
  921. package/dist/translations/uk.js +217 -66
  922. package/dist/translations/uk.js.map +1 -1
  923. package/dist/translations/zh.js +212 -67
  924. package/dist/translations/zh.js.map +1 -1
  925. package/dist/ui/RangePicker.js +112 -0
  926. package/dist/ui/RangePicker.js.map +1 -0
  927. package/dist/ui/analytics.css +1528 -0
  928. package/dist/ui/calendarDays.js +27 -0
  929. package/dist/ui/calendarDays.js.map +1 -0
  930. package/dist/ui/classNames.js +7 -0
  931. package/dist/ui/classNames.js.map +1 -0
  932. package/dist/ui/components/Card.d.ts +28 -0
  933. package/dist/ui/components/Card.js +21 -0
  934. package/dist/ui/components/Card.js.map +1 -0
  935. package/dist/ui/components/ChartDataTable.d.ts +41 -0
  936. package/dist/ui/components/ChartDataTable.js +48 -0
  937. package/dist/ui/components/ChartDataTable.js.map +1 -0
  938. package/dist/ui/components/DataTable.d.ts +82 -0
  939. package/dist/ui/components/DataTable.js +214 -0
  940. package/dist/ui/components/DataTable.js.map +1 -0
  941. package/dist/ui/components/LabeledSelect.js +62 -0
  942. package/dist/ui/components/LabeledSelect.js.map +1 -0
  943. package/dist/ui/components/LiveAnnouncement.js +21 -0
  944. package/dist/ui/components/LiveAnnouncement.js.map +1 -0
  945. package/dist/ui/components/MetricCard.d.ts +38 -0
  946. package/dist/ui/components/MetricCard.js +39 -0
  947. package/dist/ui/components/MetricCard.js.map +1 -0
  948. package/dist/ui/components/NoValue.js +22 -0
  949. package/dist/ui/components/NoValue.js.map +1 -0
  950. package/dist/ui/components/ReadState.js +27 -0
  951. package/dist/ui/components/ReadState.js.map +1 -0
  952. package/dist/ui/components/RefreshButton.js +26 -0
  953. package/dist/ui/components/RefreshButton.js.map +1 -0
  954. package/dist/ui/cssVars.js +7 -0
  955. package/dist/ui/cssVars.js.map +1 -0
  956. package/dist/ui/data/WithScopeToken.d.ts +20 -0
  957. package/dist/ui/data/WithScopeToken.js +20 -0
  958. package/dist/ui/data/WithScopeToken.js.map +1 -0
  959. package/dist/ui/data/clientFieldProps.js +16 -0
  960. package/dist/ui/data/clientFieldProps.js.map +1 -0
  961. package/dist/ui/data/request.d.ts +46 -0
  962. package/dist/ui/data/request.js +119 -0
  963. package/dist/ui/data/request.js.map +1 -0
  964. package/dist/ui/data/scopeTokenContext.js +18 -0
  965. package/dist/ui/data/scopeTokenContext.js.map +1 -0
  966. package/dist/ui/data/sharedCache.js +48 -0
  967. package/dist/ui/data/sharedCache.js.map +1 -0
  968. package/dist/ui/data/useRequest.d.ts +19 -0
  969. package/dist/ui/data/useRequest.js +123 -0
  970. package/dist/ui/data/useRequest.js.map +1 -0
  971. package/dist/ui/data/useRequestScope.js +25 -0
  972. package/dist/ui/data/useRequestScope.js.map +1 -0
  973. package/dist/ui/hooks/useDirection.js +47 -0
  974. package/dist/ui/hooks/useDirection.js.map +1 -0
  975. package/dist/ui/hooks/useDismissOnEscape.js +25 -0
  976. package/dist/ui/hooks/useDismissOnEscape.js.map +1 -0
  977. package/dist/ui/hooks/useLiveAnnouncement.js +57 -0
  978. package/dist/ui/hooks/useLiveAnnouncement.js.map +1 -0
  979. package/dist/ui/hooks/useRealtimePoll.js +112 -0
  980. package/dist/ui/hooks/useRealtimePoll.js.map +1 -0
  981. package/dist/ui/readState.js +19 -0
  982. package/dist/ui/readState.js.map +1 -0
  983. package/dist/ui/rows/toDisplayRows.js +49 -0
  984. package/dist/ui/rows/toDisplayRows.js.map +1 -0
  985. package/dist/ui/viewerClock.js +7 -0
  986. package/dist/ui/viewerClock.js.map +1 -0
  987. package/dist/view/AnalyticsNavLink.d.ts +5 -3
  988. package/dist/view/AnalyticsNavLink.js +11 -6
  989. package/dist/view/AnalyticsNavLink.js.map +1 -1
  990. package/dist/view/AnalyticsView.d.ts +8 -10
  991. package/dist/view/AnalyticsView.js +47 -18
  992. package/dist/view/AnalyticsView.js.map +1 -1
  993. package/dist/view/AnalyticsViewClient.d.ts +4 -7
  994. package/dist/view/AnalyticsViewClient.js +15 -229
  995. package/dist/view/AnalyticsViewClient.js.map +1 -1
  996. package/dist/view/CountryFlag.d.ts +27 -0
  997. package/dist/view/CountryFlag.js +44 -0
  998. package/dist/view/CountryFlag.js.map +1 -0
  999. package/dist/view/DocumentTitle.js +27 -0
  1000. package/dist/view/DocumentTitle.js.map +1 -0
  1001. package/dist/view/ViewRoot.d.ts +21 -0
  1002. package/dist/view/ViewRoot.js +150 -0
  1003. package/dist/view/ViewRoot.js.map +1 -0
  1004. package/dist/view/ViewSections.d.ts +38 -0
  1005. package/dist/view/ViewSections.js +190 -0
  1006. package/dist/view/ViewSections.js.map +1 -0
  1007. package/dist/view/authRedirect.js +2 -4
  1008. package/dist/view/authRedirect.js.map +1 -1
  1009. package/dist/view/conversionRate.js +9 -7
  1010. package/dist/view/conversionRate.js.map +1 -1
  1011. package/dist/view/dayRange.js +6 -10
  1012. package/dist/view/dayRange.js.map +1 -1
  1013. package/dist/view/exclusionLink.d.ts +27 -0
  1014. package/dist/view/exclusionLink.js +46 -0
  1015. package/dist/view/exclusionLink.js.map +1 -0
  1016. package/dist/view/flagSrc.js +14 -0
  1017. package/dist/view/flagSrc.js.map +1 -0
  1018. package/dist/view/gating.d.ts +15 -1
  1019. package/dist/view/gating.js +66 -31
  1020. package/dist/view/gating.js.map +1 -1
  1021. package/dist/view/hostCountryFlag.js +41 -0
  1022. package/dist/view/hostCountryFlag.js.map +1 -0
  1023. package/dist/view/labels.js +95 -10
  1024. package/dist/view/labels.js.map +1 -1
  1025. package/dist/view/metricAliases.js +10 -0
  1026. package/dist/view/metricAliases.js.map +1 -0
  1027. package/dist/view/navLabel.js +15 -0
  1028. package/dist/view/navLabel.js.map +1 -0
  1029. package/dist/view/registerView.js +10 -9
  1030. package/dist/view/registerView.js.map +1 -1
  1031. package/dist/view/scopeLabel.js +21 -0
  1032. package/dist/view/scopeLabel.js.map +1 -0
  1033. package/dist/view/sections/Breakdowns.js +196 -134
  1034. package/dist/view/sections/Breakdowns.js.map +1 -1
  1035. package/dist/view/sections/EmptyStates.js +118 -30
  1036. package/dist/view/sections/EmptyStates.js.map +1 -1
  1037. package/dist/view/sections/ExcludeBrowser.js +188 -0
  1038. package/dist/view/sections/ExcludeBrowser.js.map +1 -0
  1039. package/dist/view/sections/FilterChips.js +124 -27
  1040. package/dist/view/sections/FilterChips.js.map +1 -1
  1041. package/dist/view/sections/GoalsPanel.js +68 -60
  1042. package/dist/view/sections/GoalsPanel.js.map +1 -1
  1043. package/dist/view/sections/OverviewCards.js +29 -33
  1044. package/dist/view/sections/OverviewCards.js.map +1 -1
  1045. package/dist/view/sections/RealtimeStrip.js +70 -59
  1046. package/dist/view/sections/RealtimeStrip.js.map +1 -1
  1047. package/dist/view/sections/SectionBoundary.js +34 -0
  1048. package/dist/view/sections/SectionBoundary.js.map +1 -0
  1049. package/dist/view/sections/Toolbar.d.ts +11 -0
  1050. package/dist/view/sections/Toolbar.js +123 -82
  1051. package/dist/view/sections/Toolbar.js.map +1 -1
  1052. package/dist/view/sections/Trend.js +176 -76
  1053. package/dist/view/sections/Trend.js.map +1 -1
  1054. package/dist/view/state.d.ts +42 -0
  1055. package/dist/view/state.js +93 -54
  1056. package/dist/view/state.js.map +1 -1
  1057. package/dist/view/useViewClock.js +31 -0
  1058. package/dist/view/useViewClock.js.map +1 -0
  1059. package/dist/view/useViewQueries.d.ts +21 -0
  1060. package/dist/view/useViewQueries.js +45 -77
  1061. package/dist/view/useViewQueries.js.map +1 -1
  1062. package/dist/view/useViewState.js +42 -0
  1063. package/dist/view/useViewState.js.map +1 -0
  1064. package/dist/view/useViewUrl.js +47 -0
  1065. package/dist/view/useViewUrl.js.map +1 -0
  1066. package/dist/view/viewBody.js +30 -0
  1067. package/dist/view/viewBody.js.map +1 -0
  1068. package/dist/view/viewContext.d.ts +81 -0
  1069. package/dist/view/viewContext.js +49 -0
  1070. package/dist/view/viewContext.js.map +1 -0
  1071. package/dist/view/viewProps.d.ts +64 -7
  1072. package/dist/view/viewProps.js +121 -35
  1073. package/dist/view/viewProps.js.map +1 -1
  1074. package/dist/widgets/AnalyticsBreakdownWidget.d.ts +7 -3
  1075. package/dist/widgets/AnalyticsBreakdownWidget.js +143 -118
  1076. package/dist/widgets/AnalyticsBreakdownWidget.js.map +1 -1
  1077. package/dist/widgets/AnalyticsGoalsWidget.d.ts +6 -7
  1078. package/dist/widgets/AnalyticsGoalsWidget.js +124 -167
  1079. package/dist/widgets/AnalyticsGoalsWidget.js.map +1 -1
  1080. package/dist/widgets/AnalyticsMetricWidget.d.ts +7 -3
  1081. package/dist/widgets/AnalyticsMetricWidget.js +80 -106
  1082. package/dist/widgets/AnalyticsMetricWidget.js.map +1 -1
  1083. package/dist/widgets/AnalyticsRealtimeWidget.d.ts +7 -3
  1084. package/dist/widgets/AnalyticsRealtimeWidget.js +74 -64
  1085. package/dist/widgets/AnalyticsRealtimeWidget.js.map +1 -1
  1086. package/dist/widgets/AnalyticsTrendWidget.d.ts +7 -3
  1087. package/dist/widgets/AnalyticsTrendWidget.js +129 -123
  1088. package/dist/widgets/AnalyticsTrendWidget.js.map +1 -1
  1089. package/dist/widgets/ComparisonDelta.js +33 -42
  1090. package/dist/widgets/ComparisonDelta.js.map +1 -1
  1091. package/dist/widgets/RealtimeCounter.d.ts +24 -4
  1092. package/dist/widgets/RealtimeCounter.js +91 -77
  1093. package/dist/widgets/RealtimeCounter.js.map +1 -1
  1094. package/dist/widgets/WidgetCard.d.ts +80 -0
  1095. package/dist/widgets/WidgetCard.js +99 -0
  1096. package/dist/widgets/WidgetCard.js.map +1 -0
  1097. package/dist/widgets/WidgetFrame.js +42 -0
  1098. package/dist/widgets/WidgetFrame.js.map +1 -0
  1099. package/dist/widgets/WidgetShimmer.d.ts +55 -0
  1100. package/dist/widgets/WidgetShimmer.js +86 -0
  1101. package/dist/widgets/WidgetShimmer.js.map +1 -0
  1102. package/dist/widgets/breakdownTypes.js +12 -2
  1103. package/dist/widgets/breakdownTypes.js.map +1 -1
  1104. package/dist/widgets/customWidget.d.ts +5 -1
  1105. package/dist/widgets/customWidget.js +6 -7
  1106. package/dist/widgets/customWidget.js.map +1 -1
  1107. package/dist/widgets/defaults.d.ts +4 -7
  1108. package/dist/widgets/defaults.js +4 -7
  1109. package/dist/widgets/defaults.js.map +1 -1
  1110. package/dist/widgets/fieldRows.js +14 -0
  1111. package/dist/widgets/fieldRows.js.map +1 -0
  1112. package/dist/widgets/filterCaption.js +6 -7
  1113. package/dist/widgets/filterCaption.js.map +1 -1
  1114. package/dist/widgets/filterField.d.ts +3 -7
  1115. package/dist/widgets/filterField.js +46 -35
  1116. package/dist/widgets/filterField.js.map +1 -1
  1117. package/dist/widgets/filterValueLabel.d.ts +1 -0
  1118. package/dist/widgets/filterValueLabel.js +45 -0
  1119. package/dist/widgets/filterValueLabel.js.map +1 -0
  1120. package/dist/widgets/notices.js +73 -0
  1121. package/dist/widgets/notices.js.map +1 -0
  1122. package/dist/widgets/prepareWidgetRead.d.ts +5 -1
  1123. package/dist/widgets/prepareWidgetRead.js +59 -27
  1124. package/dist/widgets/prepareWidgetRead.js.map +1 -1
  1125. package/dist/widgets/range.js +26 -21
  1126. package/dist/widgets/range.js.map +1 -1
  1127. package/dist/widgets/readForWidget.d.ts +27 -18
  1128. package/dist/widgets/readForWidget.js +31 -29
  1129. package/dist/widgets/readForWidget.js.map +1 -1
  1130. package/dist/widgets/readForWidgetBreakdown.d.ts +39 -28
  1131. package/dist/widgets/readForWidgetBreakdown.js +46 -22
  1132. package/dist/widgets/readForWidgetBreakdown.js.map +1 -1
  1133. package/dist/widgets/readForWidgetGoals.d.ts +17 -23
  1134. package/dist/widgets/readForWidgetGoals.js +50 -46
  1135. package/dist/widgets/readForWidgetGoals.js.map +1 -1
  1136. package/dist/widgets/readForWidgetRealtime.d.ts +21 -17
  1137. package/dist/widgets/readForWidgetRealtime.js +51 -27
  1138. package/dist/widgets/readForWidgetRealtime.js.map +1 -1
  1139. package/dist/widgets/readForWidgetSeries.d.ts +26 -31
  1140. package/dist/widgets/readForWidgetSeries.js +43 -82
  1141. package/dist/widgets/readForWidgetSeries.js.map +1 -1
  1142. package/dist/widgets/readMeta.d.ts +44 -0
  1143. package/dist/widgets/readMeta.js +47 -4
  1144. package/dist/widgets/readMeta.js.map +1 -1
  1145. package/dist/widgets/realtimePoll.d.ts +1 -0
  1146. package/dist/widgets/realtimePoll.js +53 -25
  1147. package/dist/widgets/realtimePoll.js.map +1 -1
  1148. package/dist/widgets/registerWidgets.js +204 -126
  1149. package/dist/widgets/registerWidgets.js.map +1 -1
  1150. package/dist/widgets/stateKeys.js +30 -0
  1151. package/dist/widgets/stateKeys.js.map +1 -0
  1152. package/dist/widgets/titleForecast.js +89 -0
  1153. package/dist/widgets/titleForecast.js.map +1 -0
  1154. package/dist/widgets/types.d.ts +4 -3
  1155. package/dist/widgets/types.js +2 -0
  1156. package/dist/widgets/types.js.map +1 -1
  1157. package/dist/widgets/viewLink.d.ts +24 -6
  1158. package/dist/widgets/viewLink.js +31 -24
  1159. package/dist/widgets/viewLink.js.map +1 -1
  1160. package/dist/widgets/widgetData.js +34 -0
  1161. package/dist/widgets/widgetData.js.map +1 -0
  1162. package/dist/widgets/widgetWindow.d.ts +1 -0
  1163. package/dist/widgets/widgetWindow.js +51 -0
  1164. package/dist/widgets/widgetWindow.js.map +1 -0
  1165. package/package.json +44 -22
  1166. package/dist/adapters/ga4/disableKey.d.ts +0 -9
  1167. package/dist/capture/getTrackerConfig.d.ts +0 -20
  1168. package/dist/capture/getTrackerConfig.js +0 -31
  1169. package/dist/capture/getTrackerConfig.js.map +0 -1
  1170. package/dist/capture/slots.d.ts +0 -8
  1171. package/dist/capture/trackerConfig.d.ts +0 -33
  1172. package/dist/charts/styles.js +0 -59
  1173. package/dist/charts/styles.js.map +0 -1
  1174. package/dist/fields/config/SourceSelectField.d.ts +0 -14
  1175. package/dist/fields/dateRange/styles.js +0 -23
  1176. package/dist/fields/dateRange/styles.js.map +0 -1
  1177. package/dist/goals/GoalSelectField.d.ts +0 -7
  1178. package/dist/native/collections/events.js +0 -165
  1179. package/dist/native/collections/events.js.map +0 -1
  1180. package/dist/native/collections/rollups.js +0 -151
  1181. package/dist/native/collections/rollups.js.map +0 -1
  1182. package/dist/native/collections/seen.js +0 -47
  1183. package/dist/native/collections/seen.js.map +0 -1
  1184. package/dist/native/eventScan.js +0 -25
  1185. package/dist/native/eventScan.js.map +0 -1
  1186. package/dist/native/ingest/flushBatch.js +0 -60
  1187. package/dist/native/ingest/flushBatch.js.map +0 -1
  1188. package/dist/native/ingest/salt.js +0 -39
  1189. package/dist/native/ingest/salt.js.map +0 -1
  1190. package/dist/native/ingest/writeBuffer.js +0 -55
  1191. package/dist/native/ingest/writeBuffer.js.map +0 -1
  1192. package/dist/native/ingest/writeEvent.js +0 -14
  1193. package/dist/native/ingest/writeEvent.js.map +0 -1
  1194. package/dist/native/query/eventAgg.js +0 -175
  1195. package/dist/native/query/eventAgg.js.map +0 -1
  1196. package/dist/native/realtime/buildRealtime.js +0 -53
  1197. package/dist/native/realtime/buildRealtime.js.map +0 -1
  1198. package/dist/native/retention/pruneTask.js +0 -69
  1199. package/dist/native/retention/pruneTask.js.map +0 -1
  1200. package/dist/native/rollupAcc.js +0 -64
  1201. package/dist/native/rollupAcc.js.map +0 -1
  1202. package/dist/native/rollups/bucketKey.js +0 -15
  1203. package/dist/native/rollups/bucketKey.js.map +0 -1
  1204. package/dist/native/rollups/bumpRollups.js +0 -116
  1205. package/dist/native/rollups/bumpRollups.js.map +0 -1
  1206. package/dist/native/rollups/deltas.js +0 -106
  1207. package/dist/native/rollups/deltas.js.map +0 -1
  1208. package/dist/native/rollups/insertManyIfNew.js +0 -93
  1209. package/dist/native/rollups/insertManyIfNew.js.map +0 -1
  1210. package/dist/plugin/paths.js +0 -29
  1211. package/dist/plugin/paths.js.map +0 -1
  1212. package/dist/react/TrackerBoot.d.ts +0 -22
  1213. package/dist/rsc/AnalyticsScripts.d.ts +0 -30
  1214. package/dist/rsc/AnalyticsScripts.js +0 -41
  1215. package/dist/rsc/AnalyticsScripts.js.map +0 -1
  1216. package/dist/surfacing/queue.js +0 -60
  1217. package/dist/surfacing/queue.js.map +0 -1
  1218. package/dist/surfacing/retryPolicy.js +0 -15
  1219. package/dist/surfacing/retryPolicy.js.map +0 -1
  1220. package/dist/tracker/autoCapture.d.ts +0 -48
  1221. package/dist/tracker/consent.d.ts +0 -24
  1222. package/dist/tracker/consent.js +0 -48
  1223. package/dist/tracker/consent.js.map +0 -1
  1224. package/dist/tracker/loadScript.d.ts +0 -14
  1225. package/dist/tracker/pageTracking.d.ts +0 -17
  1226. package/dist/tracker/registry.d.ts +0 -27
  1227. package/dist/tracker/sinks/ga4.d.ts +0 -29
  1228. package/dist/tracker/sinks/native.d.ts +0 -22
  1229. package/dist/tracker/sinks/plausible.d.ts +0 -20
  1230. package/dist/tracker/sinks/posthog.d.ts +0 -18
  1231. package/dist/tracker/sinks/umami.d.ts +0 -18
  1232. package/dist/tracker/sinks/vendor.d.ts +0 -14
  1233. package/dist/view/sections/styles.js +0 -76
  1234. package/dist/view/sections/styles.js.map +0 -1
  1235. package/dist/widgets/WidgetViewLink.js +0 -17
  1236. package/dist/widgets/WidgetViewLink.js.map +0 -1
  1237. package/dist/widgets/cardChrome.d.ts +0 -8
  1238. package/dist/widgets/cardChrome.js +0 -46
  1239. package/dist/widgets/cardChrome.js.map +0 -1
  1240. package/dist/widgets/comparison.js +0 -57
  1241. package/dist/widgets/comparison.js.map +0 -1
@@ -1 +1 @@
1
- {"version":3,"file":"referrer.js","names":[],"sources":["../../../src/native/ingest/referrer.ts"],"sourcesContent":["import { MAX_QUERY_HOSTNAME_LENGTH, MAX_REFERRER_LENGTH } from '../../query/limits'\n\n/** A hostname as it is compared: lowercased, without a leading `www.`. */\nconst bareHost = (host: string): string => host.toLowerCase().replace(/^www\\./, '')\n\n/**\n * The referrer as it is stored: everything from the first `#` or `?` onwards removed, then\n * capped. A same-origin navigation puts the previous page's whole URL in `document.referrer`,\n * so the query string routinely carries a reset token, a session id or an email address that\n * has no business in an analytics row. Origin and path are kept verbatim, case included,\n * because they are what makes a referrer readable. The fragment goes first: a `?` after a\n * `#` belongs to the fragment, not to a query.\n *\n * An unparseable referrer is stripped on the same terms rather than trusted, and a value that\n * is not a string at all is dropped: the wire field is public and unvalidated, so a body\n * carrying `\"referrer\": {}` must cost the event its referrer, not the request its response.\n */\nexport const storedReferrer = (raw: unknown): string | undefined => {\n\tif (typeof raw !== 'string') {\n\t\treturn undefined\n\t}\n\tconst stripped = raw.split('#')[0]?.split('?')[0]\n\treturn stripped ? stripped.slice(0, MAX_REFERRER_LENGTH) : undefined\n}\n\n/**\n * The referrer's bare host, which is what the `referrer` dimension buckets and reads by:\n * lowercased, without scheme, port, path, query or a leading `www.`. Nothing is reported for\n * a missing, non-string, hostless or unparseable referrer, so the event contributes no\n * referrer bucket.\n *\n * A self-referral reports nothing either: internal navigation is the bulk of any site's\n * traffic, and counting it would put the site's own domain at the top of its referrers\n * breakdown forever. `selfHostname` is the event's own hostname, compared on the same terms\n * (case-insensitively, `www.` stripped). The `source` dimension reads the same absence as its\n * `direct` channel.\n */\nexport const referrerHost = (raw: unknown, selfHostname: string): string | undefined => {\n\tif (typeof raw !== 'string' || !raw) {\n\t\treturn undefined\n\t}\n\tlet host: string\n\ttry {\n\t\thost = new URL(raw).hostname\n\t} catch {\n\t\treturn undefined\n\t}\n\tconst bare = bareHost(host)\n\tif (!bare || bare === bareHost(selfHostname)) {\n\t\treturn undefined\n\t}\n\treturn bare.slice(0, MAX_QUERY_HOSTNAME_LENGTH)\n}\n"],"mappings":";;AAGA,MAAM,YAAY,SAAyB,KAAK,YAAY,EAAE,QAAQ,UAAU,EAAE;;;;;;;;;;;;;AAclF,MAAa,kBAAkB,QAAqC;CACnE,IAAI,OAAO,QAAQ,UAClB;CAED,MAAM,WAAW,IAAI,MAAM,GAAG,EAAE,IAAI,MAAM,GAAG,EAAE;CAC/C,OAAO,WAAW,SAAS,MAAM,GAAA,GAAsB,IAAI,KAAA;AAC5D;;;;;;;;;;;;;AAcA,MAAa,gBAAgB,KAAc,iBAA6C;CACvF,IAAI,OAAO,QAAQ,YAAY,CAAC,KAC/B;CAED,IAAI;CACJ,IAAI;EACH,OAAO,IAAI,IAAI,GAAG,EAAE;CACrB,QAAQ;EACP;CACD;CACA,MAAM,OAAO,SAAS,IAAI;CAC1B,IAAI,CAAC,QAAQ,SAAS,SAAS,YAAY,GAC1C;CAED,OAAO,KAAK,MAAM,GAAA,GAA4B;AAC/C"}
1
+ {"version":3,"file":"referrer.js","names":[],"sources":["../../../src/native/ingest/referrer.ts"],"sourcesContent":["import { MAX_QUERY_HOSTNAME_LENGTH, MAX_REFERRER_LENGTH } from '../../query/limits'\n\n/** A host lowercased and without `www.`, the form every referrer comparison uses. */\nexport const bareHost = (host: string): string => host.toLowerCase().replace(/^www\\./, '')\n\nconst parsedHost = (raw: unknown): string | undefined => {\n\tif (typeof raw !== 'string' || !raw) {\n\t\treturn undefined\n\t}\n\ttry {\n\t\treturn bareHost(new URL(raw).hostname) || undefined\n\t} catch {\n\t\treturn undefined\n\t}\n}\n\n/**\n * Referrer cut at the first `#` or `?`, then capped: a same-origin referrer's query can carry a\n * reset token or an email address. A non-string is dropped, since the wire field is unvalidated.\n */\nexport const storedReferrer = (raw: unknown): string | undefined => {\n\tif (typeof raw !== 'string') {\n\t\treturn undefined\n\t}\n\tconst stripped = raw.split('#')[0]?.split('?')[0]\n\treturn stripped ? stripped.slice(0, MAX_REFERRER_LENGTH) : undefined\n}\n\n/**\n * Whether a referrer is a page of the event's own site: its own hostname, or another one its\n * scope records hits under (`siblings`, bare hosts), compared the way {@link referrerHost} does.\n */\nexport const isSiteReferral = (\n\traw: unknown,\n\tselfHostname: string,\n\tsiblings?: ReadonlySet<string>\n): boolean => {\n\tconst bare = parsedHost(raw)\n\treturn bare !== undefined && (bare === bareHost(selfHostname) || (siblings?.has(bare) ?? false))\n}\n\n/**\n * Bare host the `referrer` dimension groups by; undefined when unparseable or for the site itself\n * (`selfHostname` and `siblings`), which `source` then reads as direct.\n */\nexport const referrerHost = (\n\traw: unknown,\n\tselfHostname: string,\n\tsiblings?: ReadonlySet<string>\n): string | undefined => {\n\tconst bare = parsedHost(raw)\n\tif (!bare || isSiteReferral(raw, selfHostname, siblings)) {\n\t\treturn undefined\n\t}\n\treturn bare.slice(0, MAX_QUERY_HOSTNAME_LENGTH)\n}\n\n/** A link inside the hit's own site moves a visit along rather than opening one. */\nexport const isSelfReferral = (raw: unknown, selfHostname: string): boolean => {\n\tconst bare = parsedHost(raw)\n\treturn bare !== undefined && bare === bareHost(selfHostname)\n}\n"],"mappings":";;AAGA,MAAa,YAAY,SAAyB,KAAK,YAAY,EAAE,QAAQ,UAAU,EAAE;AAEzF,MAAM,cAAc,QAAqC;CACxD,IAAI,OAAO,QAAQ,YAAY,CAAC,KAC/B;CAED,IAAI;EACH,OAAO,SAAS,IAAI,IAAI,GAAG,EAAE,QAAQ,KAAK,KAAA;CAC3C,QAAQ;EACP;CACD;AACD;;;;;AAMA,MAAa,kBAAkB,QAAqC;CACnE,IAAI,OAAO,QAAQ,UAClB;CAED,MAAM,WAAW,IAAI,MAAM,GAAG,EAAE,IAAI,MAAM,GAAG,EAAE;CAC/C,OAAO,WAAW,SAAS,MAAM,GAAA,GAAsB,IAAI,KAAA;AAC5D;;;;;AAMA,MAAa,kBACZ,KACA,cACA,aACa;CACb,MAAM,OAAO,WAAW,GAAG;CAC3B,OAAO,SAAS,KAAA,MAAc,SAAS,SAAS,YAAY,MAAM,UAAU,IAAI,IAAI,KAAK;AAC1F;;;;;AAMA,MAAa,gBACZ,KACA,cACA,aACwB;CACxB,MAAM,OAAO,WAAW,GAAG;CAC3B,IAAI,CAAC,QAAQ,eAAe,KAAK,cAAc,QAAQ,GACtD;CAED,OAAO,KAAK,MAAM,GAAA,GAA4B;AAC/C;;AAGA,MAAa,kBAAkB,KAAc,iBAAkC;CAC9E,MAAM,OAAO,WAAW,GAAG;CAC3B,OAAO,SAAS,KAAA,KAAa,SAAS,SAAS,YAAY;AAC5D"}
@@ -3,11 +3,8 @@ const DNS_NAME = /^[a-z0-9_-]+(\.[a-z0-9_-]+)*$/;
3
3
  /** An IPv6 literal as a `Host` header spells it, minus the brackets: hex groups and colons. */
4
4
  const IPV6 = /^[0-9a-f]{0,4}(:[0-9a-f]{0,4}){2,7}$/;
5
5
  /**
6
- * The one shape a hostname has anywhere in this plugin: config entries, `platformHostnames`,
7
- * the host a request carried and a resolver's answer are all held to it. A host that can only
8
- * be spelled one way can only open one rollup bucket family, and nothing prunes those, so a
9
- * public endpoint that accepted several spellings of one name would hand a client an unbounded
10
- * write.
6
+ * The one hostname shape everywhere in this plugin: a public endpoint accepting several spellings
7
+ * of one name would hand a client an unbounded write of daily totals.
11
8
  */
12
9
  const isHostname = (value) => value.length > 0 && value.length <= 253 && (DNS_NAME.test(value) || IPV6.test(value));
13
10
  /** `host[:port]`, or the bracketed IPv6 form a `Host` header uses, which loses its brackets. */
@@ -17,9 +14,8 @@ const stripPort = (value) => {
17
14
  return /^([^:]*)(?::\d+)?$/.exec(value)?.[1] ?? value;
18
15
  };
19
16
  /**
20
- * A hostname as it is stored and compared: lowercased, without port, brackets or trailing root
21
- * dots. Null for anything that is not {@link isHostname} afterwards, so a caller drops it
22
- * rather than opening a rollup bucket family for junk.
17
+ * Hostname as stored and compared: lowercased, without port, brackets or trailing dots. Null for
18
+ * junk, so a caller drops it rather than opening a family of daily totals.
23
19
  */
24
20
  const normalizeHostname = (value) => {
25
21
  const raw = value?.trim().toLowerCase();
@@ -27,31 +23,22 @@ const normalizeHostname = (value) => {
27
23
  const host = stripPort(raw).replace(/\.+$/, "");
28
24
  return isHostname(host) ? host : null;
29
25
  };
26
+ /** A comma-separated header's entries (`x-forwarded-for`), trimmed, empty ones dropped. */
27
+ const headerEntries = (headers, name) => (headers.get(name) ?? "").split(",").map((entry) => entry.trim()).filter(Boolean);
30
28
  /**
31
- * The host the request itself carries: the `x-forwarded-host` entry `n` from the right where
32
- * `n` proxy hops are trusted, which is the value the outermost trusted proxy wrote, else the
33
- * `Host` header. Counting from the left would read the attacker-controlled end, since a proxy
34
- * that appends rather than replaces keeps whatever the client sent ahead of its own value.
35
- *
36
- * `Host` is the fallback whenever the forwarded chain yields nothing usable, whether it is
37
- * shorter than the trusted count or carries junk: the peer is still the trusted proxy, so
38
- * `Host` is what that proxy sent.
39
- *
40
- * The `Origin` header is deliberately never read: a scripted client can pair a valid `Host`
41
- * with any `Origin` it likes and mint unlimited hostnames inside one scope, which is the hole
42
- * request attribution exists to close. A split deployment whose page host differs from its API
43
- * host validates `Origin` itself, through the `hostname` resolver form.
29
+ * `x-forwarded-host` entry `n` from the right under `n` trusted hops (the left is client-written),
30
+ * else `Host`. Never `Origin`: a scripted client can send any, minting unlimited hostnames.
44
31
  */
45
32
  const requestHostname = (headers, opts) => {
46
33
  const hops = opts.trustedProxyHops ?? 0;
47
34
  if (hops >= 1) {
48
- const chain = (headers.get("x-forwarded-host") ?? "").split(",").map((entry) => entry.trim()).filter(Boolean);
35
+ const chain = headerEntries(headers, "x-forwarded-host");
49
36
  const forwarded = normalizeHostname(chain[chain.length - hops]);
50
37
  if (forwarded) return forwarded;
51
38
  }
52
39
  return normalizeHostname(headers.get("host"));
53
40
  };
54
41
  //#endregion
55
- export { isHostname, normalizeHostname, requestHostname };
42
+ export { headerEntries, isHostname, normalizeHostname, requestHostname };
56
43
 
57
44
  //# sourceMappingURL=requestHost.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"requestHost.js","names":[],"sources":["../../../src/native/ingest/requestHost.ts"],"sourcesContent":["/** Longest legal DNS name, and the cap every stored hostname carries. */\nexport const MAX_HOSTNAME_LENGTH = 253\n\n/** Dot-separated labels, which is also every IPv4 literal. */\nconst DNS_NAME = /^[a-z0-9_-]+(\\.[a-z0-9_-]+)*$/\n\n/** An IPv6 literal as a `Host` header spells it, minus the brackets: hex groups and colons. */\nconst IPV6 = /^[0-9a-f]{0,4}(:[0-9a-f]{0,4}){2,7}$/\n\n/**\n * The one shape a hostname has anywhere in this plugin: config entries, `platformHostnames`,\n * the host a request carried and a resolver's answer are all held to it. A host that can only\n * be spelled one way can only open one rollup bucket family, and nothing prunes those, so a\n * public endpoint that accepted several spellings of one name would hand a client an unbounded\n * write.\n */\nexport const isHostname = (value: string): boolean =>\n\tvalue.length > 0 &&\n\tvalue.length <= MAX_HOSTNAME_LENGTH &&\n\t(DNS_NAME.test(value) || IPV6.test(value))\n\n/** `host[:port]`, or the bracketed IPv6 form a `Host` header uses, which loses its brackets. */\nconst stripPort = (value: string): string => {\n\tconst bracketed = /^\\[([^\\]]*)\\](?::\\d+)?$/.exec(value)\n\tif (bracketed) {\n\t\treturn bracketed[1] ?? ''\n\t}\n\tconst named = /^([^:]*)(?::\\d+)?$/.exec(value)\n\treturn named?.[1] ?? value\n}\n\n/**\n * A hostname as it is stored and compared: lowercased, without port, brackets or trailing root\n * dots. Null for anything that is not {@link isHostname} afterwards, so a caller drops it\n * rather than opening a rollup bucket family for junk.\n */\nexport const normalizeHostname = (value: string | null | undefined): string | null => {\n\tconst raw = value?.trim().toLowerCase()\n\tif (!raw) {\n\t\treturn null\n\t}\n\t// Every trailing dot rather than one: `example.com.` and `example.com..` name the same\n\t// host, and each extra spelling left standing would be its own bucket family.\n\tconst host = stripPort(raw).replace(/\\.+$/, '')\n\treturn isHostname(host) ? host : null\n}\n\nexport interface RequestHostnameOptions {\n\t/** Trusted proxies in front of the app; `x-forwarded-host` is only read at one or more. */\n\ttrustedProxyHops?: number\n}\n\n/**\n * The host the request itself carries: the `x-forwarded-host` entry `n` from the right where\n * `n` proxy hops are trusted, which is the value the outermost trusted proxy wrote, else the\n * `Host` header. Counting from the left would read the attacker-controlled end, since a proxy\n * that appends rather than replaces keeps whatever the client sent ahead of its own value.\n *\n * `Host` is the fallback whenever the forwarded chain yields nothing usable, whether it is\n * shorter than the trusted count or carries junk: the peer is still the trusted proxy, so\n * `Host` is what that proxy sent.\n *\n * The `Origin` header is deliberately never read: a scripted client can pair a valid `Host`\n * with any `Origin` it likes and mint unlimited hostnames inside one scope, which is the hole\n * request attribution exists to close. A split deployment whose page host differs from its API\n * host validates `Origin` itself, through the `hostname` resolver form.\n */\nexport const requestHostname = (headers: Headers, opts: RequestHostnameOptions): string | null => {\n\tconst hops = opts.trustedProxyHops ?? 0\n\tif (hops >= 1) {\n\t\tconst chain = (headers.get('x-forwarded-host') ?? '')\n\t\t\t.split(',')\n\t\t\t.map((entry) => entry.trim())\n\t\t\t.filter(Boolean)\n\t\tconst forwarded = normalizeHostname(chain[chain.length - hops])\n\t\tif (forwarded) {\n\t\t\treturn forwarded\n\t\t}\n\t}\n\treturn normalizeHostname(headers.get('host'))\n}\n"],"mappings":";AAIA,MAAM,WAAW;;AAGjB,MAAM,OAAO;;;;;;;;AASb,MAAa,cAAc,UAC1B,MAAM,SAAS,KACf,MAAM,UAAA,QACL,SAAS,KAAK,KAAK,KAAK,KAAK,KAAK,KAAK;;AAGzC,MAAM,aAAa,UAA0B;CAC5C,MAAM,YAAY,0BAA0B,KAAK,KAAK;CACtD,IAAI,WACH,OAAO,UAAU,MAAM;CAGxB,OADc,qBAAqB,KAAK,KAC7B,IAAI,MAAM;AACtB;;;;;;AAOA,MAAa,qBAAqB,UAAoD;CACrF,MAAM,MAAM,OAAO,KAAK,EAAE,YAAY;CACtC,IAAI,CAAC,KACJ,OAAO;CAIR,MAAM,OAAO,UAAU,GAAG,EAAE,QAAQ,QAAQ,EAAE;CAC9C,OAAO,WAAW,IAAI,IAAI,OAAO;AAClC;;;;;;;;;;;;;;;;AAsBA,MAAa,mBAAmB,SAAkB,SAAgD;CACjG,MAAM,OAAO,KAAK,oBAAoB;CACtC,IAAI,QAAQ,GAAG;EACd,MAAM,SAAS,QAAQ,IAAI,kBAAkB,KAAK,IAChD,MAAM,GAAG,EACT,KAAK,UAAU,MAAM,KAAK,CAAC,EAC3B,OAAO,OAAO;EAChB,MAAM,YAAY,kBAAkB,MAAM,MAAM,SAAS,KAAK;EAC9D,IAAI,WACH,OAAO;CAET;CACA,OAAO,kBAAkB,QAAQ,IAAI,MAAM,CAAC;AAC7C"}
1
+ {"version":3,"file":"requestHost.js","names":[],"sources":["../../../src/native/ingest/requestHost.ts"],"sourcesContent":["/** Longest legal DNS name, and the cap every stored hostname carries. */\nexport const MAX_HOSTNAME_LENGTH = 253\n\n/** Dot-separated labels, which is also every IPv4 literal. */\nconst DNS_NAME = /^[a-z0-9_-]+(\\.[a-z0-9_-]+)*$/\n\n/** An IPv6 literal as a `Host` header spells it, minus the brackets: hex groups and colons. */\nconst IPV6 = /^[0-9a-f]{0,4}(:[0-9a-f]{0,4}){2,7}$/\n\n/**\n * The one hostname shape everywhere in this plugin: a public endpoint accepting several spellings\n * of one name would hand a client an unbounded write of daily totals.\n */\nexport const isHostname = (value: string): boolean =>\n\tvalue.length > 0 &&\n\tvalue.length <= MAX_HOSTNAME_LENGTH &&\n\t(DNS_NAME.test(value) || IPV6.test(value))\n\n/** `host[:port]`, or the bracketed IPv6 form a `Host` header uses, which loses its brackets. */\nconst stripPort = (value: string): string => {\n\tconst bracketed = /^\\[([^\\]]*)\\](?::\\d+)?$/.exec(value)\n\tif (bracketed) {\n\t\treturn bracketed[1] ?? ''\n\t}\n\tconst named = /^([^:]*)(?::\\d+)?$/.exec(value)\n\treturn named?.[1] ?? value\n}\n\n/**\n * Hostname as stored and compared: lowercased, without port, brackets or trailing dots. Null for\n * junk, so a caller drops it rather than opening a family of daily totals.\n */\nexport const normalizeHostname = (value: string | null | undefined): string | null => {\n\tconst raw = value?.trim().toLowerCase()\n\tif (!raw) {\n\t\treturn null\n\t}\n\t// Every trailing dot rather than one: `example.com.` and `example.com..` name the same\n\t// host, and each extra spelling left standing would be its own family of daily totals.\n\tconst host = stripPort(raw).replace(/\\.+$/, '')\n\treturn isHostname(host) ? host : null\n}\n\ninterface RequestHostnameOptions {\n\t/** Trusted proxies in front of the app; `x-forwarded-host` is only read at one or more. */\n\ttrustedProxyHops?: number\n}\n\n/** A comma-separated header's entries (`x-forwarded-for`), trimmed, empty ones dropped. */\nexport const headerEntries = (headers: Headers, name: string): string[] =>\n\t(headers.get(name) ?? '')\n\t\t.split(',')\n\t\t.map((entry) => entry.trim())\n\t\t.filter(Boolean)\n\n/**\n * `x-forwarded-host` entry `n` from the right under `n` trusted hops (the left is client-written),\n * else `Host`. Never `Origin`: a scripted client can send any, minting unlimited hostnames.\n */\nexport const requestHostname = (headers: Headers, opts: RequestHostnameOptions): string | null => {\n\tconst hops = opts.trustedProxyHops ?? 0\n\tif (hops >= 1) {\n\t\tconst chain = headerEntries(headers, 'x-forwarded-host')\n\t\tconst forwarded = normalizeHostname(chain[chain.length - hops])\n\t\tif (forwarded) {\n\t\t\treturn forwarded\n\t\t}\n\t}\n\treturn normalizeHostname(headers.get('host'))\n}\n"],"mappings":";AAIA,MAAM,WAAW;;AAGjB,MAAM,OAAO;;;;;AAMb,MAAa,cAAc,UAC1B,MAAM,SAAS,KACf,MAAM,UAAA,QACL,SAAS,KAAK,KAAK,KAAK,KAAK,KAAK,KAAK;;AAGzC,MAAM,aAAa,UAA0B;CAC5C,MAAM,YAAY,0BAA0B,KAAK,KAAK;CACtD,IAAI,WACH,OAAO,UAAU,MAAM;CAGxB,OADc,qBAAqB,KAAK,KAC7B,IAAI,MAAM;AACtB;;;;;AAMA,MAAa,qBAAqB,UAAoD;CACrF,MAAM,MAAM,OAAO,KAAK,EAAE,YAAY;CACtC,IAAI,CAAC,KACJ,OAAO;CAIR,MAAM,OAAO,UAAU,GAAG,EAAE,QAAQ,QAAQ,EAAE;CAC9C,OAAO,WAAW,IAAI,IAAI,OAAO;AAClC;;AAQA,MAAa,iBAAiB,SAAkB,UAC9C,QAAQ,IAAI,IAAI,KAAK,IACpB,MAAM,GAAG,EACT,KAAK,UAAU,MAAM,KAAK,CAAC,EAC3B,OAAO,OAAO;;;;;AAMjB,MAAa,mBAAmB,SAAkB,SAAgD;CACjG,MAAM,OAAO,KAAK,oBAAoB;CACtC,IAAI,QAAQ,GAAG;EACd,MAAM,QAAQ,cAAc,SAAS,kBAAkB;EACvD,MAAM,YAAY,kBAAkB,MAAM,MAAM,SAAS,KAAK;EAC9D,IAAI,WACH,OAAO;CAET;CACA,OAAO,kBAAkB,QAAQ,IAAI,MAAM,CAAC;AAC7C"}
@@ -2,16 +2,8 @@ import { PayloadRequest } from "payload";
2
2
 
3
3
  //#region src/native/ingest/resolveHostname.d.ts
4
4
  /**
5
- * Decides the hostname an event is stored under, or null to drop it. `claimed` is what the
6
- * body sent, which is never trusted on its own; `scope` is the scope the request already
7
- * resolved to, so a split deployment can validate `Origin` against that tenant's own domains.
8
- *
9
- * The answer must be a hostname: it is normalized and then held to the same shape a request
10
- * host is, and anything else (a slug, a tenant id, free text) drops the event rather than
11
- * storing per-event text no rollup family can ever be pruned from.
12
- *
13
- * Distinct from the binding `HostnameResolver`, which names the hostname a document is read
14
- * under rather than the one an event is written under.
5
+ * Hostname to store an event under; null or a non-hostname drops it. `claimed` is untrusted body
6
+ * input. Not the binding `HostnameResolver`, which names where a document is read.
15
7
  */
16
8
  type EventHostnameResolver = (args: {
17
9
  claimed: string | undefined;
@@ -19,9 +11,8 @@ type EventHostnameResolver = (args: {
19
11
  scope: string | null;
20
12
  }) => string | null | Promise<string | null>;
21
13
  /**
22
- * `'request'` stores the host the request carried. A list stores the request host only when it
23
- * is one of those, for a single-site install behind no host validation. A function decides for
24
- * itself.
14
+ * `'request'` stores the request's host; a list stores it only when listed, for a single-site
15
+ * install behind no host validation; a function decides for itself.
25
16
  */
26
17
  type HostnameOption = 'request' | string[] | EventHostnameResolver;
27
18
  //#endregion
@@ -1,9 +1,8 @@
1
1
  import { isHostname, normalizeHostname, requestHostname } from "./requestHost.js";
2
2
  //#region src/native/ingest/resolveHostname.ts
3
3
  /**
4
- * Config-time list validation: entries are lowercased here, so the ingest compare is exact.
5
- * The port is not stripped the way a request host's is, because an entry carrying one would
6
- * otherwise be accepted and then silently never match what is stored.
4
+ * Config-time list validation, lowercased so the ingest compare is exact. Ports are not stripped:
5
+ * an entry carrying one would be accepted and then never match what is stored.
7
6
  */
8
7
  const hostnameSet = (values, option) => {
9
8
  const hosts = /* @__PURE__ */ new Set();
@@ -14,6 +13,7 @@ const hostnameSet = (values, option) => {
14
13
  }
15
14
  return hosts;
16
15
  };
16
+ /** The `hostname` option checked at config time, in the shape ingest reads it. */
17
17
  const resolveHostnameOption = (option) => {
18
18
  if (option === void 0 || option === "request") return { kind: "request" };
19
19
  if (typeof option === "function") return {
@@ -28,9 +28,8 @@ const resolveHostnameOption = (option) => {
28
28
  };
29
29
  };
30
30
  /**
31
- * The hostname to store for one event, or null to drop it. A resolver that throws drops the
32
- * event too: ingest is a public path, so a broken lookup loses the event rather than the
33
- * response.
31
+ * Hostname to store for one event, or null to drop it. A throwing resolver drops the event too:
32
+ * on a public path a broken lookup loses the event, not the response.
34
33
  */
35
34
  const resolveEventHostname = async ({ option, claimed, req, scope, trustedProxyHops }) => {
36
35
  const host = requestHostname(req.headers, { trustedProxyHops });
@@ -1 +1 @@
1
- {"version":3,"file":"resolveHostname.js","names":[],"sources":["../../../src/native/ingest/resolveHostname.ts"],"sourcesContent":["import type { PayloadRequest } from 'payload'\nimport { isHostname, normalizeHostname, requestHostname } from './requestHost'\n\n/**\n * Decides the hostname an event is stored under, or null to drop it. `claimed` is what the\n * body sent, which is never trusted on its own; `scope` is the scope the request already\n * resolved to, so a split deployment can validate `Origin` against that tenant's own domains.\n *\n * The answer must be a hostname: it is normalized and then held to the same shape a request\n * host is, and anything else (a slug, a tenant id, free text) drops the event rather than\n * storing per-event text no rollup family can ever be pruned from.\n *\n * Distinct from the binding `HostnameResolver`, which names the hostname a document is read\n * under rather than the one an event is written under.\n */\nexport type EventHostnameResolver = (args: {\n\tclaimed: string | undefined\n\treq: PayloadRequest\n\tscope: string | null\n}) => string | null | Promise<string | null>\n\n/**\n * `'request'` stores the host the request carried. A list stores the request host only when it\n * is one of those, for a single-site install behind no host validation. A function decides for\n * itself.\n */\nexport type HostnameOption = 'request' | string[] | EventHostnameResolver\n\nexport type ResolvedHostnameOption =\n\t| { kind: 'request' }\n\t| { kind: 'list'; hosts: ReadonlySet<string> }\n\t| { kind: 'resolver'; resolve: EventHostnameResolver }\n\n/**\n * Config-time list validation: entries are lowercased here, so the ingest compare is exact.\n * The port is not stripped the way a request host's is, because an entry carrying one would\n * otherwise be accepted and then silently never match what is stored.\n */\nexport const hostnameSet = (values: string[] | undefined, option: string): ReadonlySet<string> => {\n\tconst hosts = new Set<string>()\n\tfor (const value of values ?? []) {\n\t\tconst host = typeof value === 'string' ? value.trim().toLowerCase().replace(/\\.+$/, '') : ''\n\t\tif (!isHostname(host)) {\n\t\t\tthrow new Error(\n\t\t\t\t`analytics: ${option} entries must each be a bare hostname, got \"${String(value)}\"`\n\t\t\t)\n\t\t}\n\t\thosts.add(host)\n\t}\n\treturn hosts\n}\n\nexport const resolveHostnameOption = (\n\toption: HostnameOption | undefined\n): ResolvedHostnameOption => {\n\tif (option === undefined || option === 'request') {\n\t\treturn { kind: 'request' }\n\t}\n\tif (typeof option === 'function') {\n\t\treturn { kind: 'resolver', resolve: option }\n\t}\n\tif (!Array.isArray(option)) {\n\t\tthrow new Error(\n\t\t\t`analytics: hostname must be \"request\", a list of hostnames, or a resolver, got ${typeof option}`\n\t\t)\n\t}\n\tif (option.length === 0) {\n\t\tthrow new Error('analytics: hostname must name at least one hostname, or every event drops')\n\t}\n\treturn { kind: 'list', hosts: hostnameSet(option, 'hostname') }\n}\n\nexport interface ResolveEventHostnameArgs {\n\toption: ResolvedHostnameOption\n\tclaimed: string | undefined\n\treq: PayloadRequest\n\tscope: string | null\n\ttrustedProxyHops?: number\n}\n\n/**\n * The hostname to store for one event, or null to drop it. A resolver that throws drops the\n * event too: ingest is a public path, so a broken lookup loses the event rather than the\n * response.\n */\nexport const resolveEventHostname = async ({\n\toption,\n\tclaimed,\n\treq,\n\tscope,\n\ttrustedProxyHops,\n}: ResolveEventHostnameArgs): Promise<string | null> => {\n\tconst host = requestHostname(req.headers, { trustedProxyHops })\n\tif (option.kind === 'request') {\n\t\treturn host\n\t}\n\tif (option.kind === 'list') {\n\t\treturn host && option.hosts.has(host) ? host : null\n\t}\n\ttry {\n\t\treturn normalizeHostname(await option.resolve({ claimed, req, scope }))\n\t} catch {\n\t\treturn null\n\t}\n}\n"],"mappings":";;;;;;;AAsCA,MAAa,eAAe,QAA8B,WAAwC;CACjG,MAAM,wBAAQ,IAAI,IAAY;CAC9B,KAAK,MAAM,SAAS,UAAU,CAAC,GAAG;EACjC,MAAM,OAAO,OAAO,UAAU,WAAW,MAAM,KAAK,EAAE,YAAY,EAAE,QAAQ,QAAQ,EAAE,IAAI;EAC1F,IAAI,CAAC,WAAW,IAAI,GACnB,MAAM,IAAI,MACT,cAAc,OAAO,8CAA8C,OAAO,KAAK,EAAE,EAClF;EAED,MAAM,IAAI,IAAI;CACf;CACA,OAAO;AACR;AAEA,MAAa,yBACZ,WAC4B;CAC5B,IAAI,WAAW,KAAA,KAAa,WAAW,WACtC,OAAO,EAAE,MAAM,UAAU;CAE1B,IAAI,OAAO,WAAW,YACrB,OAAO;EAAE,MAAM;EAAY,SAAS;CAAO;CAE5C,IAAI,CAAC,MAAM,QAAQ,MAAM,GACxB,MAAM,IAAI,MACT,kFAAkF,OAAO,QAC1F;CAED,IAAI,OAAO,WAAW,GACrB,MAAM,IAAI,MAAM,2EAA2E;CAE5F,OAAO;EAAE,MAAM;EAAQ,OAAO,YAAY,QAAQ,UAAU;CAAE;AAC/D;;;;;;AAeA,MAAa,uBAAuB,OAAO,EAC1C,QACA,SACA,KACA,OACA,uBACuD;CACvD,MAAM,OAAO,gBAAgB,IAAI,SAAS,EAAE,iBAAiB,CAAC;CAC9D,IAAI,OAAO,SAAS,WACnB,OAAO;CAER,IAAI,OAAO,SAAS,QACnB,OAAO,QAAQ,OAAO,MAAM,IAAI,IAAI,IAAI,OAAO;CAEhD,IAAI;EACH,OAAO,kBAAkB,MAAM,OAAO,QAAQ;GAAE;GAAS;GAAK;EAAM,CAAC,CAAC;CACvE,QAAQ;EACP,OAAO;CACR;AACD"}
1
+ {"version":3,"file":"resolveHostname.js","names":[],"sources":["../../../src/native/ingest/resolveHostname.ts"],"sourcesContent":["import type { PayloadRequest } from 'payload'\nimport { isHostname, normalizeHostname, requestHostname } from './requestHost'\n\n/**\n * Hostname to store an event under; null or a non-hostname drops it. `claimed` is untrusted body\n * input. Not the binding `HostnameResolver`, which names where a document is read.\n */\nexport type EventHostnameResolver = (args: {\n\tclaimed: string | undefined\n\treq: PayloadRequest\n\tscope: string | null\n}) => string | null | Promise<string | null>\n\n/**\n * `'request'` stores the request's host; a list stores it only when listed, for a single-site\n * install behind no host validation; a function decides for itself.\n */\nexport type HostnameOption = 'request' | string[] | EventHostnameResolver\n\nexport type ResolvedHostnameOption =\n\t| { kind: 'request' }\n\t| { kind: 'list'; hosts: ReadonlySet<string> }\n\t| { kind: 'resolver'; resolve: EventHostnameResolver }\n\n/**\n * Config-time list validation, lowercased so the ingest compare is exact. Ports are not stripped:\n * an entry carrying one would be accepted and then never match what is stored.\n */\nexport const hostnameSet = (values: string[] | undefined, option: string): ReadonlySet<string> => {\n\tconst hosts = new Set<string>()\n\tfor (const value of values ?? []) {\n\t\tconst host = typeof value === 'string' ? value.trim().toLowerCase().replace(/\\.+$/, '') : ''\n\t\tif (!isHostname(host)) {\n\t\t\tthrow new Error(\n\t\t\t\t`analytics: ${option} entries must each be a bare hostname, got \"${String(value)}\"`\n\t\t\t)\n\t\t}\n\t\thosts.add(host)\n\t}\n\treturn hosts\n}\n\n/** The `hostname` option checked at config time, in the shape ingest reads it. */\nexport const resolveHostnameOption = (\n\toption: HostnameOption | undefined\n): ResolvedHostnameOption => {\n\tif (option === undefined || option === 'request') {\n\t\treturn { kind: 'request' }\n\t}\n\tif (typeof option === 'function') {\n\t\treturn { kind: 'resolver', resolve: option }\n\t}\n\tif (!Array.isArray(option)) {\n\t\tthrow new Error(\n\t\t\t`analytics: hostname must be \"request\", a list of hostnames, or a resolver, got ${typeof option}`\n\t\t)\n\t}\n\tif (option.length === 0) {\n\t\tthrow new Error('analytics: hostname must name at least one hostname, or every event drops')\n\t}\n\treturn { kind: 'list', hosts: hostnameSet(option, 'hostname') }\n}\n\ninterface ResolveEventHostnameArgs {\n\toption: ResolvedHostnameOption\n\tclaimed: string | undefined\n\treq: PayloadRequest\n\tscope: string | null\n\ttrustedProxyHops?: number\n}\n\n/**\n * Hostname to store for one event, or null to drop it. A throwing resolver drops the event too:\n * on a public path a broken lookup loses the event, not the response.\n */\nexport const resolveEventHostname = async ({\n\toption,\n\tclaimed,\n\treq,\n\tscope,\n\ttrustedProxyHops,\n}: ResolveEventHostnameArgs): Promise<string | null> => {\n\tconst host = requestHostname(req.headers, { trustedProxyHops })\n\tif (option.kind === 'request') {\n\t\treturn host\n\t}\n\tif (option.kind === 'list') {\n\t\treturn host && option.hosts.has(host) ? host : null\n\t}\n\ttry {\n\t\treturn normalizeHostname(await option.resolve({ claimed, req, scope }))\n\t} catch {\n\t\treturn null\n\t}\n}\n"],"mappings":";;;;;;AA4BA,MAAa,eAAe,QAA8B,WAAwC;CACjG,MAAM,wBAAQ,IAAI,IAAY;CAC9B,KAAK,MAAM,SAAS,UAAU,CAAC,GAAG;EACjC,MAAM,OAAO,OAAO,UAAU,WAAW,MAAM,KAAK,EAAE,YAAY,EAAE,QAAQ,QAAQ,EAAE,IAAI;EAC1F,IAAI,CAAC,WAAW,IAAI,GACnB,MAAM,IAAI,MACT,cAAc,OAAO,8CAA8C,OAAO,KAAK,EAAE,EAClF;EAED,MAAM,IAAI,IAAI;CACf;CACA,OAAO;AACR;;AAGA,MAAa,yBACZ,WAC4B;CAC5B,IAAI,WAAW,KAAA,KAAa,WAAW,WACtC,OAAO,EAAE,MAAM,UAAU;CAE1B,IAAI,OAAO,WAAW,YACrB,OAAO;EAAE,MAAM;EAAY,SAAS;CAAO;CAE5C,IAAI,CAAC,MAAM,QAAQ,MAAM,GACxB,MAAM,IAAI,MACT,kFAAkF,OAAO,QAC1F;CAED,IAAI,OAAO,WAAW,GACrB,MAAM,IAAI,MAAM,2EAA2E;CAE5F,OAAO;EAAE,MAAM;EAAQ,OAAO,YAAY,QAAQ,UAAU;CAAE;AAC/D;;;;;AAcA,MAAa,uBAAuB,OAAO,EAC1C,QACA,SACA,KACA,OACA,uBACuD;CACvD,MAAM,OAAO,gBAAgB,IAAI,SAAS,EAAE,iBAAiB,CAAC;CAC9D,IAAI,OAAO,SAAS,WACnB,OAAO;CAER,IAAI,OAAO,SAAS,QACnB,OAAO,QAAQ,OAAO,MAAM,IAAI,IAAI,IAAI,OAAO;CAEhD,IAAI;EACH,OAAO,kBAAkB,MAAM,OAAO,QAAQ;GAAE;GAAS;GAAK;EAAM,CAAC,CAAC;CACvE,QAAQ;EACP,OAAO;CACR;AACD"}
@@ -0,0 +1 @@
1
+ export { };
@@ -0,0 +1,121 @@
1
+ import { labelledKey } from "./signature.js";
2
+ import { createHash, createHmac } from "node:crypto";
3
+ /** A finite amount within {@link MAX_EVENT_VALUE} of zero, else undefined. */
4
+ const boundedValue = (value) => typeof value === "number" && Number.isFinite(value) && Math.abs(value) <= 0xe8d4a51000 ? value : void 0;
5
+ const CONTROL_CHARACTER = /\p{Cc}/u;
6
+ /**
7
+ * No charset assumed: an order id is whatever the provider calls it. Past the cap it is refused,
8
+ * not truncated, so two ids sharing a prefix cannot collapse into one dedupe key.
9
+ */
10
+ const sanitizeOrderId = (value) => {
11
+ if (typeof value !== "string") return;
12
+ const trimmed = value.trim();
13
+ if (trimmed === "" || trimmed.length > 255) return;
14
+ return CONTROL_CHARACTER.test(trimmed) ? void 0 : trimmed;
15
+ };
16
+ /**
17
+ * A conversion must be bounded and keep the money's sign: a rate table that answers a sale with a
18
+ * refund has answered about something else.
19
+ */
20
+ const usableConversion = (converted, from) => {
21
+ const bounded = boundedValue(converted);
22
+ if (bounded === void 0) return;
23
+ if (from > 0 && bounded < 0 || from < 0 && bounded > 0) return;
24
+ return bounded;
25
+ };
26
+ /**
27
+ * Without a usable conversion the completion still counts, with zero revenue and the original kept
28
+ * for later reconciliation. An event with no currency is taken as already in the reporting one.
29
+ */
30
+ const reconcileMoney = async (args) => {
31
+ const { at, convertCurrency, currency, reportingCurrency, value, warn } = args;
32
+ if (!reportingCurrency) return {
33
+ ...value !== void 0 ? { value } : {},
34
+ ...currency ? { currency } : {}
35
+ };
36
+ if (!currency || currency === reportingCurrency) return {
37
+ ...value !== void 0 ? { value } : {},
38
+ currency: reportingCurrency
39
+ };
40
+ if (value === void 0) return {
41
+ currency: reportingCurrency,
42
+ originalCurrency: currency
43
+ };
44
+ let converted;
45
+ if (convertCurrency) try {
46
+ converted = usableConversion(await convertCurrency({
47
+ amount: value,
48
+ from: currency,
49
+ to: reportingCurrency,
50
+ at
51
+ }), value);
52
+ } catch {
53
+ converted = void 0;
54
+ }
55
+ if (converted === void 0) warn?.();
56
+ return {
57
+ value: converted ?? 0,
58
+ currency: reportingCurrency,
59
+ originalValue: value,
60
+ originalCurrency: currency
61
+ };
62
+ };
63
+ const UNCONVERTED_WARNING = "analytics: an event arrived in a currency other than revenue.currency and no revenue.convert hook answered for it. It counts as a conversion, but its amount is left out of revenue and kept in originalValue/originalCurrency. Logged once per process.";
64
+ let warnedUnconverted = false;
65
+ /** One line per process: ingest is a public path and must not be a log amplifier. */
66
+ const warnUnconvertedOnce = (logger) => {
67
+ if (warnedUnconverted) return;
68
+ warnedUnconverted = true;
69
+ logger?.warn?.(UNCONVERTED_WARNING);
70
+ };
71
+ /** One line per slug, up to this many slugs: the set is fed by whatever a caller sends. */
72
+ const MAX_WARNED_GOALS = 64;
73
+ const warnedGoals = /* @__PURE__ */ new Set();
74
+ /**
75
+ * An unmatched revenue goal stores the event but counts no conversion or revenue, which looks like
76
+ * a working integration, hence the line. One per slug per process: a payment provider retries.
77
+ */
78
+ const warnUnmatchedRevenueGoal = (logger, slug) => {
79
+ if (warnedGoals.has(slug)) return;
80
+ if (warnedGoals.size >= MAX_WARNED_GOALS) warnedGoals.clear();
81
+ warnedGoals.add(slug);
82
+ logger?.warn?.(`analytics: a server purchase or refund recorded an event for goal "${slug}", which no configured goal matches, so it counts no conversion and no revenue. Define that goal, or drop the "goal" argument to use the built-in "purchase" goal. Logged once per slug per process.`);
83
+ };
84
+ /** What a dedupe key starts with, by origin; the digest after it is the same for both. */
85
+ const DEDUPE_KEY_PREFIX = {
86
+ wire: "w.",
87
+ server: "s."
88
+ };
89
+ /**
90
+ * A negative amount, `-0` included (what `refund()` makes of a refund of nothing). A refund counts
91
+ * its amount in revenue and no conversion.
92
+ */
93
+ const isRefund = (revenue, value) => {
94
+ const amount = boundedValue(value);
95
+ return revenue && amount !== void 0 && (amount < 0 || Object.is(amount, -0));
96
+ };
97
+ const digestKeyOf = labelledKey("analytics:order-digest:v1");
98
+ /**
99
+ * The key an order's dedupe digest is made with, derived from the instance's secret: every instance
100
+ * sharing the secret keys an order alike, and nobody without it can test a guessed order number.
101
+ */
102
+ const orderDigestKey = (secret) => typeof secret === "string" && secret !== "" ? digestKeyOf(secret) : void 0;
103
+ /**
104
+ * The primary key a retried order lands on: the origin, then a keyed digest of the parts as JSON,
105
+ * which leaves the origin out so a browser's and the server's record of one sale share it.
106
+ */
107
+ const dedupeKeyFor = ({ goal, key, orderId, origin, refund, refundId, tenant }) => {
108
+ const parts = [
109
+ tenant ?? "",
110
+ refund === true,
111
+ goal,
112
+ orderId
113
+ ];
114
+ if (refund === true && refundId !== void 0) parts.push(refundId);
115
+ const hash = key ? createHmac("sha256", key) : createHash("sha256");
116
+ return `${DEDUPE_KEY_PREFIX[origin]}${hash.update(JSON.stringify(parts)).digest("hex")}`;
117
+ };
118
+ //#endregion
119
+ export { DEDUPE_KEY_PREFIX, boundedValue, dedupeKeyFor, isRefund, orderDigestKey, reconcileMoney, sanitizeOrderId, warnUnconvertedOnce, warnUnmatchedRevenueGoal };
120
+
121
+ //# sourceMappingURL=revenue.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"revenue.js","names":[],"sources":["../../../src/native/ingest/revenue.ts"],"sourcesContent":["import { createHash, createHmac } from 'node:crypto'\nimport type { CurrencyConverter } from '../../goals/currency'\nimport { labelledKey } from './signature'\n\n/**\n * The longest order id ingest takes. Only its digest is stored, so the length costs nothing, and a\n * payment provider's own ids run long: a Stripe checkout session's is 66 characters.\n */\nexport const MAX_ORDER_ID_LENGTH = 255\n\n/**\n * Largest amount ingest stores, in any currency: above it a value is a broken integration or a\n * probe, and one such row poisons every revenue sum it lands in for good.\n */\nexport const MAX_EVENT_VALUE = 1e12\n\n/** A finite amount within {@link MAX_EVENT_VALUE} of zero, else undefined. */\nexport const boundedValue = (value: unknown): number | undefined =>\n\ttypeof value === 'number' && Number.isFinite(value) && Math.abs(value) <= MAX_EVENT_VALUE\n\t\t? value\n\t\t: undefined\n\nconst CONTROL_CHARACTER = /\\p{Cc}/u\n\n/**\n * No charset assumed: an order id is whatever the provider calls it. Past the cap it is refused,\n * not truncated, so two ids sharing a prefix cannot collapse into one dedupe key.\n */\nexport const sanitizeOrderId = (value: unknown): string | undefined => {\n\tif (typeof value !== 'string') {\n\t\treturn undefined\n\t}\n\tconst trimmed = value.trim()\n\tif (trimmed === '' || trimmed.length > MAX_ORDER_ID_LENGTH) {\n\t\treturn undefined\n\t}\n\treturn CONTROL_CHARACTER.test(trimmed) ? undefined : trimmed\n}\n\ninterface MoneyArgs {\n\t/** Sanitized event value, already signed for a revenue call. */\n\tvalue?: number\n\t/** Sanitized ISO 4217 code the value is denominated in. */\n\tcurrency?: string\n\treportingCurrency?: string\n\tconvertCurrency?: CurrencyConverter\n\tat: Date\n\t/** Called at most once per process when an amount could not be converted. */\n\twarn?: () => void\n}\n\nexport interface Money {\n\t/** What the `value` column stores, and therefore what revenue sums. */\n\tvalue?: number\n\tcurrency?: string\n\t/** The amount as sent, kept whenever it is not what `value` holds. */\n\toriginalValue?: number\n\toriginalCurrency?: string\n}\n\n/**\n * A conversion must be bounded and keep the money's sign: a rate table that answers a sale with a\n * refund has answered about something else.\n */\nconst usableConversion = (converted: unknown, from: number): number | undefined => {\n\tconst bounded = boundedValue(converted)\n\tif (bounded === undefined) {\n\t\treturn undefined\n\t}\n\tif ((from > 0 && bounded < 0) || (from < 0 && bounded > 0)) {\n\t\treturn undefined\n\t}\n\treturn bounded\n}\n\n/**\n * Without a usable conversion the completion still counts, with zero revenue and the original kept\n * for later reconciliation. An event with no currency is taken as already in the reporting one.\n */\nexport const reconcileMoney = async (args: MoneyArgs): Promise<Money> => {\n\tconst { at, convertCurrency, currency, reportingCurrency, value, warn } = args\n\tif (!reportingCurrency) {\n\t\treturn { ...(value !== undefined ? { value } : {}), ...(currency ? { currency } : {}) }\n\t}\n\tif (!currency || currency === reportingCurrency) {\n\t\treturn { ...(value !== undefined ? { value } : {}), currency: reportingCurrency }\n\t}\n\tif (value === undefined) {\n\t\treturn { currency: reportingCurrency, originalCurrency: currency }\n\t}\n\tlet converted: number | undefined\n\tif (convertCurrency) {\n\t\ttry {\n\t\t\tconverted = usableConversion(\n\t\t\t\tawait convertCurrency({ amount: value, from: currency, to: reportingCurrency, at }),\n\t\t\t\tvalue\n\t\t\t)\n\t\t} catch {\n\t\t\tconverted = undefined\n\t\t}\n\t}\n\tif (converted === undefined) {\n\t\twarn?.()\n\t}\n\t// Unconverted is zero, not absent: the completion has declared its own money, so falling back\n\t// to the goal's fixed value would put an unrelated figure in the revenue sum.\n\treturn {\n\t\tvalue: converted ?? 0,\n\t\tcurrency: reportingCurrency,\n\t\toriginalValue: value,\n\t\toriginalCurrency: currency,\n\t}\n}\n\nconst UNCONVERTED_WARNING =\n\t'analytics: an event arrived in a currency other than revenue.currency and no revenue.convert hook answered for it. It counts as a conversion, but its amount is left out of revenue and kept in originalValue/originalCurrency. Logged once per process.'\n\nlet warnedUnconverted = false\n\n/** One line per process: ingest is a public path and must not be a log amplifier. */\nexport const warnUnconvertedOnce = (logger?: { warn?: (msg: string) => void }): void => {\n\tif (warnedUnconverted) {\n\t\treturn\n\t}\n\twarnedUnconverted = true\n\tlogger?.warn?.(UNCONVERTED_WARNING)\n}\n\n/** One line per slug, up to this many slugs: the set is fed by whatever a caller sends. */\nconst MAX_WARNED_GOALS = 64\nconst warnedGoals = new Set<string>()\n\n/**\n * An unmatched revenue goal stores the event but counts no conversion or revenue, which looks like\n * a working integration, hence the line. One per slug per process: a payment provider retries.\n */\nexport const warnUnmatchedRevenueGoal = (\n\tlogger: { warn?: (msg: string) => void } | undefined,\n\tslug: string\n): void => {\n\tif (warnedGoals.has(slug)) {\n\t\treturn\n\t}\n\tif (warnedGoals.size >= MAX_WARNED_GOALS) {\n\t\twarnedGoals.clear()\n\t}\n\twarnedGoals.add(slug)\n\tlogger?.warn?.(\n\t\t`analytics: a server purchase or refund recorded an event for goal \"${slug}\", which no configured goal matches, so it counts no conversion and no revenue. Define that goal, or drop the \"goal\" argument to use the built-in \"purchase\" goal. Logged once per slug per process.`\n\t)\n}\n\n/**\n * Which side recorded an idempotent event. The two never share a key: a browser can guess an\n * order id, and a guessed one must not be able to block the payment webhook's own write.\n */\nexport type IngestOrigin = 'wire' | 'server'\n\n/** What a dedupe key starts with, by origin; the digest after it is the same for both. */\nexport const DEDUPE_KEY_PREFIX: Readonly<Record<IngestOrigin, string>> = {\n\twire: 'w.',\n\tserver: 's.',\n}\n\n/**\n * A negative amount, `-0` included (what `refund()` makes of a refund of nothing). A refund counts\n * its amount in revenue and no conversion.\n */\nexport const isRefund = (revenue: boolean, value: unknown): boolean => {\n\tconst amount = boundedValue(value)\n\treturn revenue && amount !== undefined && (amount < 0 || Object.is(amount, -0))\n}\n\ninterface DedupeKeyArgs {\n\torigin: IngestOrigin\n\t/** The tenant this order belongs to, so two tenants can retry the same order id. */\n\ttenant?: string\n\tgoal: string\n\torderId: string\n\t/** A refund of an order already counted is a row of its own, never a swallowed duplicate. */\n\trefund?: boolean\n\t/**\n\t * On a refund, its own id: two partial refunds of one order are two rows, and a retried refund\n\t * meets the key it was stored under.\n\t */\n\trefundId?: string\n\t/** {@link orderDigestKey} of the secret; absent, a plain digest anyone can recompute. */\n\tkey?: Buffer\n}\n\nconst digestKeyOf = labelledKey('analytics:order-digest:v1')\n\n/**\n * The key an order's dedupe digest is made with, derived from the instance's secret: every instance\n * sharing the secret keys an order alike, and nobody without it can test a guessed order number.\n */\nexport const orderDigestKey = (secret: unknown): Buffer | undefined =>\n\ttypeof secret === 'string' && secret !== '' ? digestKeyOf(secret) : undefined\n\n/**\n * The primary key a retried order lands on: the origin, then a keyed digest of the parts as JSON,\n * which leaves the origin out so a browser's and the server's record of one sale share it.\n */\nexport const dedupeKeyFor = ({\n\tgoal,\n\tkey,\n\torderId,\n\torigin,\n\trefund,\n\trefundId,\n\ttenant,\n}: DedupeKeyArgs): string => {\n\tconst parts: unknown[] = [tenant ?? '', refund === true, goal, orderId]\n\tif (refund === true && refundId !== undefined) {\n\t\tparts.push(refundId)\n\t}\n\tconst hash = key ? createHmac('sha256', key) : createHash('sha256')\n\treturn `${DEDUPE_KEY_PREFIX[origin]}${hash.update(JSON.stringify(parts)).digest('hex')}`\n}\n"],"mappings":";;;AAiBA,MAAa,gBAAgB,UAC5B,OAAO,UAAU,YAAY,OAAO,SAAS,KAAK,KAAK,KAAK,IAAI,KAAK,KAAA,eAClE,QACA,KAAA;AAEJ,MAAM,oBAAoB;;;;;AAM1B,MAAa,mBAAmB,UAAuC;CACtE,IAAI,OAAO,UAAU,UACpB;CAED,MAAM,UAAU,MAAM,KAAK;CAC3B,IAAI,YAAY,MAAM,QAAQ,SAAA,KAC7B;CAED,OAAO,kBAAkB,KAAK,OAAO,IAAI,KAAA,IAAY;AACtD;;;;;AA2BA,MAAM,oBAAoB,WAAoB,SAAqC;CAClF,MAAM,UAAU,aAAa,SAAS;CACtC,IAAI,YAAY,KAAA,GACf;CAED,IAAK,OAAO,KAAK,UAAU,KAAO,OAAO,KAAK,UAAU,GACvD;CAED,OAAO;AACR;;;;;AAMA,MAAa,iBAAiB,OAAO,SAAoC;CACxE,MAAM,EAAE,IAAI,iBAAiB,UAAU,mBAAmB,OAAO,SAAS;CAC1E,IAAI,CAAC,mBACJ,OAAO;EAAE,GAAI,UAAU,KAAA,IAAY,EAAE,MAAM,IAAI,CAAC;EAAI,GAAI,WAAW,EAAE,SAAS,IAAI,CAAC;CAAG;CAEvF,IAAI,CAAC,YAAY,aAAa,mBAC7B,OAAO;EAAE,GAAI,UAAU,KAAA,IAAY,EAAE,MAAM,IAAI,CAAC;EAAI,UAAU;CAAkB;CAEjF,IAAI,UAAU,KAAA,GACb,OAAO;EAAE,UAAU;EAAmB,kBAAkB;CAAS;CAElE,IAAI;CACJ,IAAI,iBACH,IAAI;EACH,YAAY,iBACX,MAAM,gBAAgB;GAAE,QAAQ;GAAO,MAAM;GAAU,IAAI;GAAmB;EAAG,CAAC,GAClF,KACD;CACD,QAAQ;EACP,YAAY,KAAA;CACb;CAED,IAAI,cAAc,KAAA,GACjB,OAAO;CAIR,OAAO;EACN,OAAO,aAAa;EACpB,UAAU;EACV,eAAe;EACf,kBAAkB;CACnB;AACD;AAEA,MAAM,sBACL;AAED,IAAI,oBAAoB;;AAGxB,MAAa,uBAAuB,WAAoD;CACvF,IAAI,mBACH;CAED,oBAAoB;CACpB,QAAQ,OAAO,mBAAmB;AACnC;;AAGA,MAAM,mBAAmB;AACzB,MAAM,8BAAc,IAAI,IAAY;;;;;AAMpC,MAAa,4BACZ,QACA,SACU;CACV,IAAI,YAAY,IAAI,IAAI,GACvB;CAED,IAAI,YAAY,QAAQ,kBACvB,YAAY,MAAM;CAEnB,YAAY,IAAI,IAAI;CACpB,QAAQ,OACP,sEAAsE,KAAK,qMAC5E;AACD;;AASA,MAAa,oBAA4D;CACxE,MAAM;CACN,QAAQ;AACT;;;;;AAMA,MAAa,YAAY,SAAkB,UAA4B;CACtE,MAAM,SAAS,aAAa,KAAK;CACjC,OAAO,WAAW,WAAW,KAAA,MAAc,SAAS,KAAK,OAAO,GAAG,QAAQ,EAAE;AAC9E;AAmBA,MAAM,cAAc,YAAY,2BAA2B;;;;;AAM3D,MAAa,kBAAkB,WAC9B,OAAO,WAAW,YAAY,WAAW,KAAK,YAAY,MAAM,IAAI,KAAA;;;;;AAMrE,MAAa,gBAAgB,EAC5B,MACA,KACA,SACA,QACA,QACA,UACA,aAC4B;CAC5B,MAAM,QAAmB;EAAC,UAAU;EAAI,WAAW;EAAM;EAAM;CAAO;CACtE,IAAI,WAAW,QAAQ,aAAa,KAAA,GACnC,MAAM,KAAK,QAAQ;CAEpB,MAAM,OAAO,MAAM,WAAW,UAAU,GAAG,IAAI,WAAW,QAAQ;CAClE,OAAO,GAAG,kBAAkB,UAAU,KAAK,OAAO,KAAK,UAAU,KAAK,CAAC,EAAE,OAAO,KAAK;AACtF"}
@@ -0,0 +1,10 @@
1
+ import { SanitizedConfig } from "payload";
2
+
3
+ //#region src/native/ingest/route.d.ts
4
+ interface IngestRouteOptions {
5
+ /** `getPayload` cache key of the instance hits are stored through; Payload's own when unset. */
6
+ key?: string;
7
+ }
8
+ //#endregion
9
+ export { IngestRouteOptions };
10
+ //# sourceMappingURL=route.d.ts.map
@@ -0,0 +1,82 @@
1
+ import { getRuntime } from "../../plugin/runtime.js";
2
+ import { analyticsError, errorResponse } from "../../plugin/errors.js";
3
+ import { normalizeOrigin } from "../../net/origin.js";
4
+ import { beaconFailureLog } from "./endpoint.js";
5
+ import { isNativeAdapter } from "../nativeAdapter.js";
6
+ import { createLocalReq, getPayload } from "payload";
7
+ //#region src/native/ingest/route.ts
8
+ const PREFLIGHT_MAX_AGE_S = 86400;
9
+ const failureLogs = /* @__PURE__ */ new WeakMap();
10
+ const logFailure = (payload, err) => {
11
+ const log = failureLogs.get(payload) ?? beaconFailureLog("taken");
12
+ failureLogs.set(payload, log);
13
+ log(payload, err);
14
+ };
15
+ const instanceOf = (config, options) => getPayload({
16
+ config,
17
+ cron: true,
18
+ ...options.key === void 0 ? {} : { key: options.key }
19
+ });
20
+ /**
21
+ * The CORS headers a response to `request` carries: the request's own origin, echoed only when
22
+ * `capture.allowedOrigins` lists it, so another listed site's page may post here.
23
+ */
24
+ const corsHeaders = (request, payload) => {
25
+ const origin = request.headers.get("origin");
26
+ const normalized = origin === null ? null : normalizeOrigin(origin);
27
+ if (origin === null || normalized === null || !getRuntime(payload)?.allowedOrigins?.has(normalized)) return {};
28
+ return {
29
+ "Access-Control-Allow-Origin": origin,
30
+ Vary: "Origin"
31
+ };
32
+ };
33
+ const withHeaders = (response, extra) => {
34
+ if (Object.keys(extra).length === 0) return response;
35
+ const headers = new Headers(response.headers);
36
+ for (const [name, value] of Object.entries(extra)) headers.set(name, value);
37
+ return new Response(response.body, {
38
+ status: response.status,
39
+ statusText: response.statusText,
40
+ headers
41
+ });
42
+ };
43
+ /**
44
+ * One beacon outside Payload's REST routing, made a Payload request without running auth
45
+ * strategies, so resolvers see a capture call site without a user, cookies or authorization.
46
+ */
47
+ const receiveBeacon = async (request, config, options) => {
48
+ const payload = await instanceOf(config, options);
49
+ const adapter = getRuntime(payload)?.adapters?.find(isNativeAdapter);
50
+ if (!adapter) return errorResponse(404, analyticsError("not_found", "analytics: this install runs no native adapter to take beacons"));
51
+ const cors = corsHeaders(request, payload);
52
+ let response;
53
+ try {
54
+ const req = await createLocalReq({ req: Object.assign(request, { payloadAPI: "REST" }) }, payload);
55
+ response = await adapter.receive(req);
56
+ } catch (err) {
57
+ logFailure(payload, err);
58
+ response = errorResponse(500, analyticsError("internal", "analytics: the beacon failed"));
59
+ }
60
+ return withHeaders(response, cors);
61
+ };
62
+ /**
63
+ * The answer to a browser's preflight before a beacon from another site: allowed for an origin
64
+ * `capture.allowedOrigins` lists, and refused (no CORS headers) for any other.
65
+ */
66
+ const answerPreflight = async (request, config, options) => {
67
+ const cors = corsHeaders(request, await instanceOf(config, options));
68
+ const allowed = Object.keys(cors).length > 0;
69
+ return new Response(null, {
70
+ status: 204,
71
+ headers: allowed ? {
72
+ ...cors,
73
+ "Access-Control-Allow-Methods": "POST",
74
+ "Access-Control-Allow-Headers": "content-type",
75
+ "Access-Control-Max-Age": String(PREFLIGHT_MAX_AGE_S)
76
+ } : { Vary: "Origin" }
77
+ });
78
+ };
79
+ //#endregion
80
+ export { answerPreflight, receiveBeacon };
81
+
82
+ //# sourceMappingURL=route.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"route.js","names":[],"sources":["../../../src/native/ingest/route.ts"],"sourcesContent":["import { createLocalReq, getPayload, type Payload, type SanitizedConfig } from 'payload'\nimport { normalizeOrigin } from '../../net/origin'\nimport { analyticsError, errorResponse } from '../../plugin/errors'\nimport { getRuntime } from '../../plugin/runtime'\nimport { isNativeAdapter } from '../nativeAdapter'\nimport { type BeaconFailureLog, beaconFailureLog } from './endpoint'\n\nexport interface IngestRouteOptions {\n\t/** `getPayload` cache key of the instance hits are stored through; Payload's own when unset. */\n\tkey?: string\n}\n\ntype Config = Promise<SanitizedConfig> | SanitizedConfig\n\nconst PREFLIGHT_MAX_AGE_S = 86_400\n\nconst failureLogs = new WeakMap<Payload, BeaconFailureLog>()\n\nconst logFailure = (payload: Payload, err: unknown): void => {\n\tconst log = failureLogs.get(payload) ?? beaconFailureLog('taken')\n\tfailureLogs.set(payload, log)\n\tlog(payload, err)\n}\n\nconst instanceOf = (config: Config, options: IngestRouteOptions): Promise<Payload> =>\n\tgetPayload({ config, cron: true, ...(options.key === undefined ? {} : { key: options.key }) })\n\n/**\n * The CORS headers a response to `request` carries: the request's own origin, echoed only when\n * `capture.allowedOrigins` lists it, so another listed site's page may post here.\n */\nconst corsHeaders = (request: Request, payload: Payload): Record<string, string> => {\n\tconst origin = request.headers.get('origin')\n\tconst normalized = origin === null ? null : normalizeOrigin(origin)\n\tif (\n\t\torigin === null ||\n\t\tnormalized === null ||\n\t\t!getRuntime(payload)?.allowedOrigins?.has(normalized)\n\t) {\n\t\treturn {}\n\t}\n\treturn { 'Access-Control-Allow-Origin': origin, Vary: 'Origin' }\n}\n\nconst withHeaders = (response: Response, extra: Record<string, string>): Response => {\n\tif (Object.keys(extra).length === 0) {\n\t\treturn response\n\t}\n\tconst headers = new Headers(response.headers)\n\tfor (const [name, value] of Object.entries(extra)) {\n\t\theaders.set(name, value)\n\t}\n\treturn new Response(response.body, {\n\t\tstatus: response.status,\n\t\tstatusText: response.statusText,\n\t\theaders,\n\t})\n}\n\n/**\n * One beacon outside Payload's REST routing, made a Payload request without running auth\n * strategies, so resolvers see a capture call site without a user, cookies or authorization.\n */\nexport const receiveBeacon = async (\n\trequest: Request,\n\tconfig: Config,\n\toptions: IngestRouteOptions\n): Promise<Response> => {\n\tconst payload = await instanceOf(config, options)\n\tconst adapter = getRuntime(payload)?.adapters?.find(isNativeAdapter)\n\tif (!adapter) {\n\t\treturn errorResponse(\n\t\t\t404,\n\t\t\tanalyticsError('not_found', 'analytics: this install runs no native adapter to take beacons')\n\t\t)\n\t}\n\tconst cors = corsHeaders(request, payload)\n\tlet response: Response\n\ttry {\n\t\tconst req = await createLocalReq(\n\t\t\t{ req: Object.assign(request, { payloadAPI: 'REST' as const }) },\n\t\t\tpayload\n\t\t)\n\t\tresponse = await adapter.receive(req)\n\t} catch (err) {\n\t\tlogFailure(payload, err)\n\t\tresponse = errorResponse(500, analyticsError('internal', 'analytics: the beacon failed'))\n\t}\n\treturn withHeaders(response, cors)\n}\n\n/**\n * The answer to a browser's preflight before a beacon from another site: allowed for an origin\n * `capture.allowedOrigins` lists, and refused (no CORS headers) for any other.\n */\nexport const answerPreflight = async (\n\trequest: Request,\n\tconfig: Config,\n\toptions: IngestRouteOptions\n): Promise<Response> => {\n\tconst cors = corsHeaders(request, await instanceOf(config, options))\n\tconst allowed = Object.keys(cors).length > 0\n\treturn new Response(null, {\n\t\tstatus: 204,\n\t\theaders: allowed\n\t\t\t? {\n\t\t\t\t\t...cors,\n\t\t\t\t\t'Access-Control-Allow-Methods': 'POST',\n\t\t\t\t\t'Access-Control-Allow-Headers': 'content-type',\n\t\t\t\t\t'Access-Control-Max-Age': String(PREFLIGHT_MAX_AGE_S),\n\t\t\t\t}\n\t\t\t: { Vary: 'Origin' },\n\t})\n}\n"],"mappings":";;;;;;;AAcA,MAAM,sBAAsB;AAE5B,MAAM,8BAAc,IAAI,QAAmC;AAE3D,MAAM,cAAc,SAAkB,QAAuB;CAC5D,MAAM,MAAM,YAAY,IAAI,OAAO,KAAK,iBAAiB,OAAO;CAChE,YAAY,IAAI,SAAS,GAAG;CAC5B,IAAI,SAAS,GAAG;AACjB;AAEA,MAAM,cAAc,QAAgB,YACnC,WAAW;CAAE;CAAQ,MAAM;CAAM,GAAI,QAAQ,QAAQ,KAAA,IAAY,CAAC,IAAI,EAAE,KAAK,QAAQ,IAAI;AAAG,CAAC;;;;;AAM9F,MAAM,eAAe,SAAkB,YAA6C;CACnF,MAAM,SAAS,QAAQ,QAAQ,IAAI,QAAQ;CAC3C,MAAM,aAAa,WAAW,OAAO,OAAO,gBAAgB,MAAM;CAClE,IACC,WAAW,QACX,eAAe,QACf,CAAC,WAAW,OAAO,GAAG,gBAAgB,IAAI,UAAU,GAEpD,OAAO,CAAC;CAET,OAAO;EAAE,+BAA+B;EAAQ,MAAM;CAAS;AAChE;AAEA,MAAM,eAAe,UAAoB,UAA4C;CACpF,IAAI,OAAO,KAAK,KAAK,EAAE,WAAW,GACjC,OAAO;CAER,MAAM,UAAU,IAAI,QAAQ,SAAS,OAAO;CAC5C,KAAK,MAAM,CAAC,MAAM,UAAU,OAAO,QAAQ,KAAK,GAC/C,QAAQ,IAAI,MAAM,KAAK;CAExB,OAAO,IAAI,SAAS,SAAS,MAAM;EAClC,QAAQ,SAAS;EACjB,YAAY,SAAS;EACrB;CACD,CAAC;AACF;;;;;AAMA,MAAa,gBAAgB,OAC5B,SACA,QACA,YACuB;CACvB,MAAM,UAAU,MAAM,WAAW,QAAQ,OAAO;CAChD,MAAM,UAAU,WAAW,OAAO,GAAG,UAAU,KAAK,eAAe;CACnE,IAAI,CAAC,SACJ,OAAO,cACN,KACA,eAAe,aAAa,gEAAgE,CAC7F;CAED,MAAM,OAAO,YAAY,SAAS,OAAO;CACzC,IAAI;CACJ,IAAI;EACH,MAAM,MAAM,MAAM,eACjB,EAAE,KAAK,OAAO,OAAO,SAAS,EAAE,YAAY,OAAgB,CAAC,EAAE,GAC/D,OACD;EACA,WAAW,MAAM,QAAQ,QAAQ,GAAG;CACrC,SAAS,KAAK;EACb,WAAW,SAAS,GAAG;EACvB,WAAW,cAAc,KAAK,eAAe,YAAY,8BAA8B,CAAC;CACzF;CACA,OAAO,YAAY,UAAU,IAAI;AAClC;;;;;AAMA,MAAa,kBAAkB,OAC9B,SACA,QACA,YACuB;CACvB,MAAM,OAAO,YAAY,SAAS,MAAM,WAAW,QAAQ,OAAO,CAAC;CACnE,MAAM,UAAU,OAAO,KAAK,IAAI,EAAE,SAAS;CAC3C,OAAO,IAAI,SAAS,MAAM;EACzB,QAAQ;EACR,SAAS,UACN;GACA,GAAG;GACH,gCAAgC;GAChC,gCAAgC;GAChC,0BAA0B,OAAO,mBAAmB;EACrD,IACC,EAAE,MAAM,SAAS;CACrB,CAAC;AACF"}
@@ -3,16 +3,8 @@ import { Payload } from "payload";
3
3
 
4
4
  //#region src/native/ingest/serverTrack.d.ts
5
5
  /**
6
- * Records an analytics event from server code: a webhook, a job, a server action. The event
7
- * goes through the same normalization, sanitization and goal matching a browser event does.
8
- * Pass `opts.req` whenever there is a request behind the event, so it inherits that request's
9
- * attribution, scope and reporting timezone.
10
- *
11
- * `event.scope` overrides the request's scope; it is ignored on an unscoped install and is
12
- * never checked against the scopes that exist, so the caller owns what it stamps.
13
- *
14
- * Needs the native adapter: a provider slot (Plausible, GA4) has no server ingestion seam
15
- * here yet, so an install without the native adapter throws rather than dropping the event.
6
+ * Records an event from server code through the native adapter, normalized as a beacon is. Without
7
+ * `opts.identity` it is no visitor's while `capture.gate` holds the native slot.
16
8
  */
17
9
  declare const trackServerEvent: (payload: Payload, event: ServerEventInput, opts?: ServerTrackOptions) => Promise<void>;
18
10
  //#endregion