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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (1273) hide show
  1. package/CHANGELOG.md +780 -0
  2. package/LICENSE +21 -21
  3. package/README.md +35 -36
  4. package/dist/access/adminUser.d.ts +15 -0
  5. package/dist/access/adminUser.js +13 -0
  6. package/dist/access/adminUser.js.map +1 -0
  7. package/dist/access/decideOnce.js +16 -0
  8. package/dist/access/decideOnce.js.map +1 -0
  9. package/dist/access/membership.d.ts +23 -0
  10. package/dist/access/membership.js +63 -0
  11. package/dist/access/membership.js.map +1 -0
  12. package/dist/access/principal.d.ts +37 -0
  13. package/dist/access/principal.js +29 -0
  14. package/dist/access/principal.js.map +1 -0
  15. package/dist/access/readGate.js +16 -0
  16. package/dist/access/readGate.js.map +1 -0
  17. package/dist/adapters/ga4/disableKey.js +19 -0
  18. package/dist/adapters/ga4/disableKey.js.map +1 -0
  19. package/dist/adapters/ga4/eventName.d.ts +9 -0
  20. package/dist/adapters/ga4/eventName.js +13 -0
  21. package/dist/adapters/ga4/eventName.js.map +1 -0
  22. package/dist/adapters/ga4/ga4.d.ts +29 -0
  23. package/dist/adapters/ga4/ga4.js +324 -112
  24. package/dist/adapters/ga4/ga4.js.map +1 -1
  25. package/dist/adapters/ga4/measurementId.js +14 -0
  26. package/dist/adapters/ga4/measurementId.js.map +1 -0
  27. package/dist/adapters/goalRead.js +112 -0
  28. package/dist/adapters/goalRead.js.map +1 -0
  29. package/dist/adapters/http/baseUrl.js +15 -0
  30. package/dist/adapters/http/baseUrl.js.map +1 -0
  31. package/dist/adapters/http/fetchJson.d.ts +19 -0
  32. package/dist/adapters/http/fetchJson.js +27 -8
  33. package/dist/adapters/http/fetchJson.js.map +1 -1
  34. package/dist/adapters/mapping.js +52 -0
  35. package/dist/adapters/mapping.js.map +1 -0
  36. package/dist/adapters/plausible/plausible.d.ts +30 -3
  37. package/dist/adapters/plausible/plausible.js +198 -110
  38. package/dist/adapters/plausible/plausible.js.map +1 -1
  39. package/dist/adapters/plausible/scriptId.js +19 -0
  40. package/dist/adapters/plausible/scriptId.js.map +1 -0
  41. package/dist/adapters/posthog/posthog.d.ts +33 -9
  42. package/dist/adapters/posthog/posthog.js +307 -127
  43. package/dist/adapters/posthog/posthog.js.map +1 -1
  44. package/dist/adapters/posthog/projectCheck.js +56 -0
  45. package/dist/adapters/posthog/projectCheck.js.map +1 -0
  46. package/dist/adapters/readTime.js +7 -0
  47. package/dist/adapters/readTime.js.map +1 -0
  48. package/dist/adapters/series.js +14 -8
  49. package/dist/adapters/series.js.map +1 -1
  50. package/dist/adapters/umami/umami.d.ts +21 -3
  51. package/dist/adapters/umami/umami.js +334 -95
  52. package/dist/adapters/umami/umami.js.map +1 -1
  53. package/dist/adapters/upstream.js +16 -0
  54. package/dist/adapters/upstream.js.map +1 -0
  55. package/dist/binding/report.d.ts +8 -0
  56. package/dist/binding/report.js +24 -0
  57. package/dist/binding/report.js.map +1 -0
  58. package/dist/binding/resolvePath.js +28 -25
  59. package/dist/binding/resolvePath.js.map +1 -1
  60. package/dist/binding/types.d.ts +14 -29
  61. package/dist/capture/captureRequest.js +28 -0
  62. package/dist/capture/captureRequest.js.map +1 -0
  63. package/dist/capture/exclusionEndpoint.js +98 -0
  64. package/dist/capture/exclusionEndpoint.js.map +1 -0
  65. package/dist/capture/exclusionPrelude.js +14 -0
  66. package/dist/capture/exclusionPrelude.js.map +1 -0
  67. package/dist/capture/exclusionToken.js +23 -0
  68. package/dist/capture/exclusionToken.js.map +1 -0
  69. package/dist/capture/jsLiteral.js +19 -0
  70. package/dist/capture/jsLiteral.js.map +1 -0
  71. package/dist/capture/mountPath.js +2 -3
  72. package/dist/capture/mountPath.js.map +1 -1
  73. package/dist/capture/proxyEndpoint.js +49 -92
  74. package/dist/capture/proxyEndpoint.js.map +1 -1
  75. package/dist/capture/proxyRoutes.js +58 -21
  76. package/dist/capture/proxyRoutes.js.map +1 -1
  77. package/dist/capture/relay.js +91 -0
  78. package/dist/capture/relay.js.map +1 -0
  79. package/dist/capture/requestBody.js +2 -6
  80. package/dist/capture/requestBody.js.map +1 -1
  81. package/dist/capture/requestTrust.js +45 -0
  82. package/dist/capture/requestTrust.js.map +1 -0
  83. package/dist/capture/sameSite.js +40 -0
  84. package/dist/capture/sameSite.js.map +1 -0
  85. package/dist/capture/slots.js +50 -25
  86. package/dist/capture/slots.js.map +1 -1
  87. package/dist/capture/trackerConfig.js +131 -36
  88. package/dist/capture/trackerConfig.js.map +1 -1
  89. package/dist/capture/trackerEndpoint.js +22 -21
  90. package/dist/capture/trackerEndpoint.js.map +1 -1
  91. package/dist/capture/withoutConsent.js +91 -0
  92. package/dist/capture/withoutConsent.js.map +1 -0
  93. package/dist/charts/BarList.d.ts +27 -13
  94. package/dist/charts/BarList.js +38 -77
  95. package/dist/charts/BarList.js.map +1 -1
  96. package/dist/charts/TrendChart.d.ts +40 -7
  97. package/dist/charts/TrendChart.js +243 -215
  98. package/dist/charts/TrendChart.js.map +1 -1
  99. package/dist/charts/bars.d.ts +17 -1
  100. package/dist/charts/bars.js +12 -11
  101. package/dist/charts/bars.js.map +1 -1
  102. package/dist/charts/bucket.js +106 -73
  103. package/dist/charts/bucket.js.map +1 -1
  104. package/dist/charts/inProgress.js +22 -0
  105. package/dist/charts/inProgress.js.map +1 -0
  106. package/dist/charts/series.d.ts +15 -0
  107. package/dist/charts/series.js +123 -0
  108. package/dist/charts/series.js.map +1 -0
  109. package/dist/charts/spline.js +91 -25
  110. package/dist/charts/spline.js.map +1 -1
  111. package/dist/charts/trendGeometry.js +91 -0
  112. package/dist/charts/trendGeometry.js.map +1 -0
  113. package/dist/core/adminOptions.d.ts +1 -0
  114. package/dist/core/adminOptions.js +198 -0
  115. package/dist/core/adminOptions.js.map +1 -0
  116. package/dist/core/budget.js +24 -0
  117. package/dist/core/budget.js.map +1 -0
  118. package/dist/core/cacheKey.d.ts +1 -0
  119. package/dist/core/cacheKey.js +51 -29
  120. package/dist/core/cacheKey.js.map +1 -1
  121. package/dist/core/cacheOptions.js +165 -0
  122. package/dist/core/cacheOptions.js.map +1 -0
  123. package/dist/core/capabilities.d.ts +24 -11
  124. package/dist/core/capabilities.js +101 -17
  125. package/dist/core/capabilities.js.map +1 -1
  126. package/dist/core/capture.d.ts +59 -26
  127. package/dist/core/captureOptions.d.ts +1 -0
  128. package/dist/core/captureOptions.js +347 -0
  129. package/dist/core/captureOptions.js.map +1 -0
  130. package/dist/core/clock.js +13 -0
  131. package/dist/core/clock.js.map +1 -0
  132. package/dist/core/collectionOption.d.ts +17 -0
  133. package/dist/core/collectionOption.js +105 -0
  134. package/dist/core/collectionOption.js.map +1 -0
  135. package/dist/core/collectionSlug.js +7 -0
  136. package/dist/core/collectionSlug.js.map +1 -0
  137. package/dist/core/contract.d.ts +340 -49
  138. package/dist/core/contract.js +7 -4
  139. package/dist/core/contract.js.map +1 -1
  140. package/dist/core/cron.js +57 -0
  141. package/dist/core/cron.js.map +1 -0
  142. package/dist/core/fetch.d.ts +17 -0
  143. package/dist/core/goalOptions.d.ts +1 -0
  144. package/dist/core/goalOptions.js +166 -0
  145. package/dist/core/goalOptions.js.map +1 -0
  146. package/dist/core/granularity.js +3 -2
  147. package/dist/core/granularity.js.map +1 -1
  148. package/dist/core/guards.js +17 -0
  149. package/dist/core/guards.js.map +1 -0
  150. package/dist/core/jobs.d.ts +40 -0
  151. package/dist/core/jobs.js +132 -0
  152. package/dist/core/jobs.js.map +1 -0
  153. package/dist/core/legacyOptions.js +145 -0
  154. package/dist/core/legacyOptions.js.map +1 -0
  155. package/dist/core/metricAliases.js +81 -0
  156. package/dist/core/metricAliases.js.map +1 -0
  157. package/dist/core/metricValues.js +57 -0
  158. package/dist/core/metricValues.js.map +1 -0
  159. package/dist/core/monotonic.js +10 -0
  160. package/dist/core/monotonic.js.map +1 -0
  161. package/dist/core/optionChecks.js +51 -0
  162. package/dist/core/optionChecks.js.map +1 -0
  163. package/dist/core/options.d.ts +535 -151
  164. package/dist/core/options.js +158 -214
  165. package/dist/core/options.js.map +1 -1
  166. package/dist/core/registry.js +45 -5
  167. package/dist/core/registry.js.map +1 -1
  168. package/dist/core/scopeList.js +7 -9
  169. package/dist/core/scopeList.js.map +1 -1
  170. package/dist/core/scopeOptions.d.ts +1 -0
  171. package/dist/core/scopeOptions.js +114 -0
  172. package/dist/core/scopeOptions.js.map +1 -0
  173. package/dist/core/scopedRead.js +349 -36
  174. package/dist/core/scopedRead.js.map +1 -1
  175. package/dist/core/sdks.d.ts +81 -0
  176. package/dist/core/sdks.js +23 -0
  177. package/dist/core/sdks.js.map +1 -0
  178. package/dist/core/serverEvent.d.ts +50 -14
  179. package/dist/core/serverEvent.js.map +1 -1
  180. package/dist/core/siteAddress.js +20 -0
  181. package/dist/core/siteAddress.js.map +1 -0
  182. package/dist/core/sourceErrors.js +109 -0
  183. package/dist/core/sourceErrors.js.map +1 -0
  184. package/dist/core/sourceLabel.d.ts +10 -0
  185. package/dist/core/sourceLabel.js +63 -0
  186. package/dist/core/sourceLabel.js.map +1 -0
  187. package/dist/core/sourceOptions.js +107 -0
  188. package/dist/core/sourceOptions.js.map +1 -0
  189. package/dist/core/sourcePolicy.d.ts +55 -0
  190. package/dist/core/sourcePolicy.js +51 -0
  191. package/dist/core/sourcePolicy.js.map +1 -0
  192. package/dist/core/throttle.js +18 -0
  193. package/dist/core/throttle.js.map +1 -0
  194. package/dist/core/values.js +61 -0
  195. package/dist/core/values.js.map +1 -0
  196. package/dist/core/widgetSlugs.d.ts +17 -0
  197. package/dist/core/widgetSlugs.js +29 -0
  198. package/dist/core/widgetSlugs.js.map +1 -0
  199. package/dist/db/detachedWrite.js +36 -0
  200. package/dist/db/detachedWrite.js.map +1 -0
  201. package/dist/db/errors.js +182 -0
  202. package/dist/db/errors.js.map +1 -0
  203. package/dist/db/kind.js +32 -0
  204. package/dist/db/kind.js.map +1 -0
  205. package/dist/db/openTransaction.js +51 -0
  206. package/dist/db/openTransaction.js.map +1 -0
  207. package/dist/exports/adapters/contract.d.ts +15 -0
  208. package/dist/exports/adapters/ga4.d.ts +17 -1
  209. package/dist/exports/adapters/ga4.js +2 -1
  210. package/dist/exports/adapters/native.d.ts +29 -2
  211. package/dist/exports/adapters/native.js +5 -1
  212. package/dist/exports/adapters/plausible.d.ts +16 -1
  213. package/dist/exports/adapters/posthog.d.ts +16 -1
  214. package/dist/exports/adapters/umami.d.ts +16 -1
  215. package/dist/exports/attributes.d.ts +42 -0
  216. package/dist/exports/attributes.js +83 -0
  217. package/dist/exports/attributes.js.map +1 -0
  218. package/dist/exports/client.d.ts +45 -11
  219. package/dist/exports/client.js +23 -6
  220. package/dist/exports/geo.d.ts +4 -2
  221. package/dist/exports/geo.js +1 -1
  222. package/dist/exports/i18n.d.ts +2 -2
  223. package/dist/exports/i18n.js +2 -2
  224. package/dist/exports/migrations.d.ts +2 -0
  225. package/dist/exports/migrations.js +2 -0
  226. package/dist/exports/react.d.ts +5 -3
  227. package/dist/exports/react.js +1 -2
  228. package/dist/exports/routes.d.ts +19 -0
  229. package/dist/exports/routes.js +3 -0
  230. package/dist/exports/rsc.d.ts +33 -14
  231. package/dist/exports/rsc.js +11 -6
  232. package/dist/exports/site.d.ts +5 -0
  233. package/dist/exports/site.js +3 -0
  234. package/dist/exports/testing.d.ts +18 -0
  235. package/dist/exports/testing.js +3 -0
  236. package/dist/exports/tracker.d.ts +6 -17
  237. package/dist/exports/tracker.js +3 -11
  238. package/dist/exports/types.d.ts +46 -14
  239. package/dist/exports/types.js +7 -1
  240. package/dist/fields/AnalyticsPanelClient.js +265 -154
  241. package/dist/fields/AnalyticsPanelClient.js.map +1 -1
  242. package/dist/fields/AnalyticsPanelField.d.ts +19 -7
  243. package/dist/fields/AnalyticsPanelField.js +123 -30
  244. package/dist/fields/AnalyticsPanelField.js.map +1 -1
  245. package/dist/fields/AnalyticsStatField.d.ts +17 -6
  246. package/dist/fields/AnalyticsStatField.js +98 -63
  247. package/dist/fields/AnalyticsStatField.js.map +1 -1
  248. package/dist/fields/FieldShimmer.js +15 -0
  249. package/dist/fields/FieldShimmer.js.map +1 -0
  250. package/dist/fields/PanelContent.js +222 -0
  251. package/dist/fields/PanelContent.js.map +1 -0
  252. package/dist/fields/PanelList.js +82 -0
  253. package/dist/fields/PanelList.js.map +1 -0
  254. package/dist/fields/PanelLiveCounter.js +63 -0
  255. package/dist/fields/PanelLiveCounter.js.map +1 -0
  256. package/dist/fields/PanelSkeleton.js +63 -0
  257. package/dist/fields/PanelSkeleton.js.map +1 -0
  258. package/dist/fields/componentPaths.js +8 -0
  259. package/dist/fields/componentPaths.js.map +1 -0
  260. package/dist/fields/config/FilterDimensionSelectField.d.ts +14 -0
  261. package/dist/fields/config/FilterDimensionSelectField.js +49 -0
  262. package/dist/fields/config/FilterDimensionSelectField.js.map +1 -0
  263. package/dist/fields/config/FilterKeySelect.js +66 -0
  264. package/dist/fields/config/FilterKeySelect.js.map +1 -0
  265. package/dist/fields/config/FilterOperatorSelectField.d.ts +19 -0
  266. package/dist/fields/config/FilterOperatorSelectField.js +59 -0
  267. package/dist/fields/config/FilterOperatorSelectField.js.map +1 -0
  268. package/dist/fields/config/FilterValueField.d.ts +17 -0
  269. package/dist/fields/config/FilterValueField.js +130 -0
  270. package/dist/fields/config/FilterValueField.js.map +1 -0
  271. package/dist/fields/config/MetricSelectField.d.ts +5 -12
  272. package/dist/fields/config/MetricSelectField.js +19 -31
  273. package/dist/fields/config/MetricSelectField.js.map +1 -1
  274. package/dist/fields/config/OptionSelect.js +52 -0
  275. package/dist/fields/config/OptionSelect.js.map +1 -0
  276. package/dist/fields/config/SourceSelectField.js +16 -31
  277. package/dist/fields/config/SourceSelectField.js.map +1 -1
  278. package/dist/fields/config/fetchSources.d.ts +3 -0
  279. package/dist/fields/config/fetchSources.js +17 -23
  280. package/dist/fields/config/fetchSources.js.map +1 -1
  281. package/dist/fields/config/filterValues.js +106 -0
  282. package/dist/fields/config/filterValues.js.map +1 -0
  283. package/dist/fields/config/narrow.js +8 -10
  284. package/dist/fields/config/narrow.js.map +1 -1
  285. package/dist/fields/config/retiredPickers.d.ts +45 -0
  286. package/dist/fields/config/retiredPickers.js +46 -0
  287. package/dist/fields/config/retiredPickers.js.map +1 -0
  288. package/dist/fields/config/scopedFields.d.ts +40 -0
  289. package/dist/fields/config/scopedFields.js +68 -0
  290. package/dist/fields/config/scopedFields.js.map +1 -0
  291. package/dist/fields/config/sourcesState.js +19 -3
  292. package/dist/fields/config/sourcesState.js.map +1 -1
  293. package/dist/fields/config/toSelectOption.js +13 -7
  294. package/dist/fields/config/toSelectOption.js.map +1 -1
  295. package/dist/fields/config/useAnalyticsSources.d.ts +10 -7
  296. package/dist/fields/config/useAnalyticsSources.js +23 -24
  297. package/dist/fields/config/useAnalyticsSources.js.map +1 -1
  298. package/dist/fields/config/useFilterCapabilities.d.ts +31 -0
  299. package/dist/fields/config/useFilterCapabilities.js +60 -0
  300. package/dist/fields/config/useFilterCapabilities.js.map +1 -0
  301. package/dist/fields/config/useFormString.js +12 -0
  302. package/dist/fields/config/useFormString.js.map +1 -0
  303. package/dist/fields/dateRange/field.js +7 -19
  304. package/dist/fields/dateRange/field.js.map +1 -1
  305. package/dist/fields/dateRange/types.d.ts +5 -1
  306. package/dist/fields/dateRange/ui.d.ts +3 -2
  307. package/dist/fields/dateRange/ui.js +57 -319
  308. package/dist/fields/dateRange/ui.js.map +1 -1
  309. package/dist/fields/documentScope.js +21 -0
  310. package/dist/fields/documentScope.js.map +1 -0
  311. package/dist/fields/emptyState.js +30 -26
  312. package/dist/fields/emptyState.js.map +1 -1
  313. package/dist/fields/factories.d.ts +35 -16
  314. package/dist/fields/factories.js +67 -38
  315. package/dist/fields/factories.js.map +1 -1
  316. package/dist/fields/format.d.ts +12 -3
  317. package/dist/fields/format.js +77 -13
  318. package/dist/fields/format.js.map +1 -1
  319. package/dist/fields/itemReport.js +45 -0
  320. package/dist/fields/itemReport.js.map +1 -0
  321. package/dist/fields/readForDocument.d.ts +79 -26
  322. package/dist/fields/readForDocument.js +451 -105
  323. package/dist/fields/readForDocument.js.map +1 -1
  324. package/dist/fields/stateKeys.js +20 -0
  325. package/dist/fields/stateKeys.js.map +1 -0
  326. package/dist/goals/GoalAmountField.d.ts +10 -0
  327. package/dist/goals/GoalAmountField.js +179 -0
  328. package/dist/goals/GoalAmountField.js.map +1 -0
  329. package/dist/goals/GoalSelectField.js +89 -40
  330. package/dist/goals/GoalSelectField.js.map +1 -1
  331. package/dist/goals/GoalSelectFieldServer.d.ts +13 -0
  332. package/dist/goals/GoalSelectFieldServer.js +21 -0
  333. package/dist/goals/GoalSelectFieldServer.js.map +1 -0
  334. package/dist/goals/amountField.d.ts +20 -0
  335. package/dist/goals/amountField.js +37 -0
  336. package/dist/goals/amountField.js.map +1 -0
  337. package/dist/goals/builtin.js +17 -0
  338. package/dist/goals/builtin.js.map +1 -0
  339. package/dist/goals/collection.d.ts +22 -0
  340. package/dist/goals/collection.js +143 -124
  341. package/dist/goals/collection.js.map +1 -1
  342. package/dist/goals/constants.d.ts +38 -0
  343. package/dist/goals/constants.js +49 -0
  344. package/dist/goals/constants.js.map +1 -0
  345. package/dist/goals/currency.d.ts +16 -0
  346. package/dist/goals/currency.js +46 -4
  347. package/dist/goals/currency.js.map +1 -1
  348. package/dist/goals/currencyOptions.js +70 -0
  349. package/dist/goals/currencyOptions.js.map +1 -0
  350. package/dist/goals/fetchGoals.d.ts +10 -0
  351. package/dist/goals/fetchGoals.js +12 -22
  352. package/dist/goals/fetchGoals.js.map +1 -1
  353. package/dist/goals/goalField.d.ts +4 -6
  354. package/dist/goals/goalField.js +9 -19
  355. package/dist/goals/goalField.js.map +1 -1
  356. package/dist/goals/goalsEndpoint.js +40 -38
  357. package/dist/goals/goalsEndpoint.js.map +1 -1
  358. package/dist/goals/items.js +35 -0
  359. package/dist/goals/items.js.map +1 -0
  360. package/dist/goals/latent.js +9 -0
  361. package/dist/goals/latent.js.map +1 -0
  362. package/dist/goals/linkFields.d.ts +35 -0
  363. package/dist/goals/linkFields.js +31 -0
  364. package/dist/goals/linkFields.js.map +1 -0
  365. package/dist/goals/match.d.ts +14 -0
  366. package/dist/goals/match.js +67 -46
  367. package/dist/goals/match.js.map +1 -1
  368. package/dist/goals/moneyFields.js +56 -0
  369. package/dist/goals/moneyFields.js.map +1 -0
  370. package/dist/goals/pathMatch.js +122 -0
  371. package/dist/goals/pathMatch.js.map +1 -0
  372. package/dist/goals/placeholder.js +12 -0
  373. package/dist/goals/placeholder.js.map +1 -0
  374. package/dist/goals/resolver.d.ts +3 -3
  375. package/dist/goals/resolver.js +155 -47
  376. package/dist/goals/resolver.js.map +1 -1
  377. package/dist/goals/serverRevenue.d.ts +60 -0
  378. package/dist/goals/serverRevenue.js +41 -0
  379. package/dist/goals/serverRevenue.js.map +1 -0
  380. package/dist/goals/trackGoalAction.d.ts +26 -25
  381. package/dist/goals/trackGoalAction.js +71 -66
  382. package/dist/goals/trackGoalAction.js.map +1 -1
  383. package/dist/goals/types.d.ts +13 -28
  384. package/dist/goals/types.js +1 -1
  385. package/dist/goals/types.js.map +1 -1
  386. package/dist/goals/useAnalyticsGoals.d.ts +6 -5
  387. package/dist/goals/useAnalyticsGoals.js +17 -18
  388. package/dist/goals/useAnalyticsGoals.js.map +1 -1
  389. package/dist/index.d.ts +69 -11
  390. package/dist/index.js +262 -192
  391. package/dist/index.js.map +1 -1
  392. package/dist/items/collectionIdType.js +20 -0
  393. package/dist/items/collectionIdType.js.map +1 -0
  394. package/dist/items/idType.js +31 -0
  395. package/dist/items/idType.js.map +1 -0
  396. package/dist/items/ref.js +73 -0
  397. package/dist/items/ref.js.map +1 -0
  398. package/dist/maintenance/apiTaskState.js +141 -0
  399. package/dist/maintenance/apiTaskState.js.map +1 -0
  400. package/dist/maintenance/heartbeat.js +51 -0
  401. package/dist/maintenance/heartbeat.js.map +1 -0
  402. package/dist/maintenance/lease.d.ts +1 -0
  403. package/dist/maintenance/lease.js +79 -0
  404. package/dist/maintenance/lease.js.map +1 -0
  405. package/dist/maintenance/taskSchedule.js +27 -0
  406. package/dist/maintenance/taskSchedule.js.map +1 -0
  407. package/dist/maintenance/underLease.js +35 -0
  408. package/dist/maintenance/underLease.js.map +1 -0
  409. package/dist/migrations/legacy.d.ts +54 -0
  410. package/dist/migrations/legacy.js +117 -0
  411. package/dist/migrations/legacy.js.map +1 -0
  412. package/dist/migrations/predefined/dropLegacyMongo.d.ts +11 -0
  413. package/dist/migrations/predefined/dropLegacyMongo.js +12 -0
  414. package/dist/migrations/predefined/dropLegacyMongo.js.map +1 -0
  415. package/dist/native/collections/aggregates.js +54 -0
  416. package/dist/native/collections/aggregates.js.map +1 -0
  417. package/dist/native/collections/hits.js +103 -0
  418. package/dist/native/collections/hits.js.map +1 -0
  419. package/dist/native/collections/slugs.d.ts +10 -0
  420. package/dist/native/collections/slugs.js +16 -0
  421. package/dist/native/collections/slugs.js.map +1 -0
  422. package/dist/native/collections/state.js +84 -0
  423. package/dist/native/collections/state.js.map +1 -0
  424. package/dist/native/collections/storeCollection.js +31 -0
  425. package/dist/native/collections/storeCollection.js.map +1 -0
  426. package/dist/native/engine/buckets.d.ts +1 -0
  427. package/dist/native/engine/buckets.js +53 -0
  428. package/dist/native/engine/buckets.js.map +1 -0
  429. package/dist/native/engine/capabilities.js +87 -0
  430. package/dist/native/engine/capabilities.js.map +1 -0
  431. package/dist/native/engine/cost.js +72 -0
  432. package/dist/native/engine/cost.js.map +1 -0
  433. package/dist/native/engine/days.d.ts +1 -0
  434. package/dist/native/engine/days.js +182 -0
  435. package/dist/native/engine/days.js.map +1 -0
  436. package/dist/native/engine/engine.d.ts +1 -0
  437. package/dist/native/engine/engine.js +1627 -0
  438. package/dist/native/engine/engine.js.map +1 -0
  439. package/dist/native/engine/instance.js +58 -0
  440. package/dist/native/engine/instance.js.map +1 -0
  441. package/dist/native/engine/maintenance.d.ts +1 -0
  442. package/dist/native/engine/maintenance.js +677 -0
  443. package/dist/native/engine/maintenance.js.map +1 -0
  444. package/dist/native/engine/merge.js +41 -0
  445. package/dist/native/engine/merge.js.map +1 -0
  446. package/dist/native/engine/nudge.js +26 -0
  447. package/dist/native/engine/nudge.js.map +1 -0
  448. package/dist/native/engine/planner.js +199 -0
  449. package/dist/native/engine/planner.js.map +1 -0
  450. package/dist/native/engine/rebuild.d.ts +22 -0
  451. package/dist/native/engine/rebuild.js +76 -0
  452. package/dist/native/engine/rebuild.js.map +1 -0
  453. package/dist/native/engine/recent.js +17 -0
  454. package/dist/native/engine/recent.js.map +1 -0
  455. package/dist/native/engine/salt.d.ts +1 -0
  456. package/dist/native/engine/salt.js +98 -0
  457. package/dist/native/engine/salt.js.map +1 -0
  458. package/dist/native/engine/siteHosts.d.ts +1 -0
  459. package/dist/native/engine/siteHosts.js +58 -0
  460. package/dist/native/engine/siteHosts.js.map +1 -0
  461. package/dist/native/engine/toHit.js +110 -0
  462. package/dist/native/engine/toHit.js.map +1 -0
  463. package/dist/native/engine/writeBuffer.d.ts +14 -0
  464. package/dist/native/engine/writeBuffer.js +317 -0
  465. package/dist/native/engine/writeBuffer.js.map +1 -0
  466. package/dist/native/geo/composeGeoResolvers.d.ts +1 -0
  467. package/dist/native/geo/composeGeoResolvers.js +5 -2
  468. package/dist/native/geo/composeGeoResolvers.js.map +1 -1
  469. package/dist/native/geo/geoResolver.d.ts +27 -2
  470. package/dist/native/geo/geoResolver.js +42 -6
  471. package/dist/native/geo/geoResolver.js.map +1 -1
  472. package/dist/native/geo/maxmindResolver.d.ts +8 -4
  473. package/dist/native/geo/maxmindResolver.js +20 -16
  474. package/dist/native/geo/maxmindResolver.js.map +1 -1
  475. package/dist/native/geo/resolveGeo.js +31 -0
  476. package/dist/native/geo/resolveGeo.js.map +1 -0
  477. package/dist/native/ingest/bots.d.ts +10 -0
  478. package/dist/native/ingest/bots.js +66 -0
  479. package/dist/native/ingest/bots.js.map +1 -0
  480. package/dist/native/ingest/browser.js +45 -0
  481. package/dist/native/ingest/browser.js.map +1 -0
  482. package/dist/native/ingest/clientIp.js +34 -8
  483. package/dist/native/ingest/clientIp.js.map +1 -1
  484. package/dist/native/ingest/device.js +4 -6
  485. package/dist/native/ingest/device.js.map +1 -1
  486. package/dist/native/ingest/endpoint.d.ts +1 -1
  487. package/dist/native/ingest/endpoint.js +185 -32
  488. package/dist/native/ingest/endpoint.js.map +1 -1
  489. package/dist/native/ingest/itemSignature.d.ts +26 -0
  490. package/dist/native/ingest/itemSignature.js +45 -0
  491. package/dist/native/ingest/itemSignature.js.map +1 -0
  492. package/dist/native/ingest/language.js +13 -0
  493. package/dist/native/ingest/language.js.map +1 -0
  494. package/dist/native/ingest/normalizeEvent.d.ts +73 -5
  495. package/dist/native/ingest/normalizeEvent.js +257 -51
  496. package/dist/native/ingest/normalizeEvent.js.map +1 -1
  497. package/dist/native/ingest/orderSignature.d.ts +13 -0
  498. package/dist/native/ingest/orderSignature.js +50 -0
  499. package/dist/native/ingest/orderSignature.js.map +1 -0
  500. package/dist/native/ingest/referrer.js +46 -0
  501. package/dist/native/ingest/referrer.js.map +1 -0
  502. package/dist/native/ingest/requestHost.js +44 -0
  503. package/dist/native/ingest/requestHost.js.map +1 -0
  504. package/dist/native/ingest/resolveHostname.d.ts +20 -0
  505. package/dist/native/ingest/resolveHostname.js +51 -0
  506. package/dist/native/ingest/resolveHostname.js.map +1 -0
  507. package/dist/native/ingest/revenue.d.ts +1 -0
  508. package/dist/native/ingest/revenue.js +121 -0
  509. package/dist/native/ingest/revenue.js.map +1 -0
  510. package/dist/native/ingest/route.d.ts +10 -0
  511. package/dist/native/ingest/route.js +85 -0
  512. package/dist/native/ingest/route.js.map +1 -0
  513. package/dist/native/ingest/serverTrack.d.ts +2 -10
  514. package/dist/native/ingest/serverTrack.js +188 -68
  515. package/dist/native/ingest/serverTrack.js.map +1 -1
  516. package/dist/native/ingest/signature.js +28 -0
  517. package/dist/native/ingest/signature.js.map +1 -0
  518. package/dist/native/ingest/source.d.ts +10 -0
  519. package/dist/native/ingest/source.js +245 -16
  520. package/dist/native/ingest/source.js.map +1 -1
  521. package/dist/native/ingest/utm.js +33 -0
  522. package/dist/native/ingest/utm.js.map +1 -0
  523. package/dist/native/ingest/validate.js +25 -13
  524. package/dist/native/ingest/validate.js.map +1 -1
  525. package/dist/native/ingest/visitorHash.js +6 -8
  526. package/dist/native/ingest/visitorHash.js.map +1 -1
  527. package/dist/native/nativeAdapter.d.ts +128 -9
  528. package/dist/native/nativeAdapter.js +395 -281
  529. package/dist/native/nativeAdapter.js.map +1 -1
  530. package/dist/native/rebuildDays.d.ts +12 -0
  531. package/dist/native/rebuildDays.js +16 -0
  532. package/dist/native/rebuildDays.js.map +1 -0
  533. package/dist/native/store/aggregate.js +450 -0
  534. package/dist/native/store/aggregate.js.map +1 -0
  535. package/dist/native/store/caps.d.ts +18 -0
  536. package/dist/native/store/caps.js +76 -0
  537. package/dist/native/store/caps.js.map +1 -0
  538. package/dist/native/store/chunks.js +34 -0
  539. package/dist/native/store/chunks.js.map +1 -0
  540. package/dist/native/store/columnValues.js +31 -0
  541. package/dist/native/store/columnValues.js.map +1 -0
  542. package/dist/native/store/dialect.js +106 -0
  543. package/dist/native/store/dialect.js.map +1 -0
  544. package/dist/native/store/eventStore.js +44 -0
  545. package/dist/native/store/eventStore.js.map +1 -0
  546. package/dist/native/store/hitRow.js +119 -0
  547. package/dist/native/store/hitRow.js.map +1 -0
  548. package/dist/native/store/hits.js +65 -0
  549. package/dist/native/store/hits.js.map +1 -0
  550. package/dist/native/store/ids.js +105 -0
  551. package/dist/native/store/ids.js.map +1 -0
  552. package/dist/native/store/mongo/aggregatePipelines.js +438 -0
  553. package/dist/native/store/mongo/aggregatePipelines.js.map +1 -0
  554. package/dist/native/store/mongo/mongoState.js +375 -0
  555. package/dist/native/store/mongo/mongoState.js.map +1 -0
  556. package/dist/native/store/mongo/mongoStore.js +618 -0
  557. package/dist/native/store/mongo/mongoStore.js.map +1 -0
  558. package/dist/native/store/mongo/pipelines.js +705 -0
  559. package/dist/native/store/mongo/pipelines.js.map +1 -0
  560. package/dist/native/store/mongo/results.js +20 -0
  561. package/dist/native/store/mongo/results.js.map +1 -0
  562. package/dist/native/store/parts.d.ts +1 -0
  563. package/dist/native/store/parts.js +101 -0
  564. package/dist/native/store/parts.js.map +1 -0
  565. package/dist/native/store/pattern.js +213 -0
  566. package/dist/native/store/pattern.js.map +1 -0
  567. package/dist/native/store/rawRead.d.ts +23 -0
  568. package/dist/native/store/rawRead.js +387 -0
  569. package/dist/native/store/rawRead.js.map +1 -0
  570. package/dist/native/store/reclassify.js +53 -0
  571. package/dist/native/store/reclassify.js.map +1 -0
  572. package/dist/native/store/sql/aggregateSql.js +349 -0
  573. package/dist/native/store/sql/aggregateSql.js.map +1 -0
  574. package/dist/native/store/sql/columns.js +49 -0
  575. package/dist/native/store/sql/columns.js.map +1 -0
  576. package/dist/native/store/sql/compile.js +668 -0
  577. package/dist/native/store/sql/compile.js.map +1 -0
  578. package/dist/native/store/sql/drivers.js +218 -0
  579. package/dist/native/store/sql/drivers.js.map +1 -0
  580. package/dist/native/store/sql/executor.js +132 -0
  581. package/dist/native/store/sql/executor.js.map +1 -0
  582. package/dist/native/store/sql/fragment.js +104 -0
  583. package/dist/native/store/sql/fragment.js.map +1 -0
  584. package/dist/native/store/sql/maintenanceSql.js +59 -0
  585. package/dist/native/store/sql/maintenanceSql.js.map +1 -0
  586. package/dist/native/store/sql/ownConnection.js +107 -0
  587. package/dist/native/store/sql/ownConnection.js.map +1 -0
  588. package/dist/native/store/sql/poolShare.js +101 -0
  589. package/dist/native/store/sql/poolShare.js.map +1 -0
  590. package/dist/native/store/sql/sqlState.js +325 -0
  591. package/dist/native/store/sql/sqlState.js.map +1 -0
  592. package/dist/native/store/sql/sqlStore.js +355 -0
  593. package/dist/native/store/sql/sqlStore.js.map +1 -0
  594. package/dist/native/store/sql/sqliteThread.d.ts +9 -0
  595. package/dist/native/store/sql/sqliteThread.js +314 -0
  596. package/dist/native/store/sql/sqliteThread.js.map +1 -0
  597. package/dist/native/store/sql/sqliteWorker.js +327 -0
  598. package/dist/native/store/sql/sqliteWorker.js.map +1 -0
  599. package/dist/native/store/sql/sqliteWorkerSource.js +347 -0
  600. package/dist/native/store/sql/sqliteWorkerSource.js.map +1 -0
  601. package/dist/native/store/state.js +151 -0
  602. package/dist/native/store/state.js.map +1 -0
  603. package/dist/native/store/stateStore.js +29 -0
  604. package/dist/native/store/stateStore.js.map +1 -0
  605. package/dist/native/store/types.d.ts +15 -0
  606. package/dist/native/store/types.js +10 -0
  607. package/dist/native/store/types.js.map +1 -0
  608. package/dist/native/tasks/maintainTask.d.ts +19 -0
  609. package/dist/native/tasks/maintainTask.js +57 -0
  610. package/dist/native/tasks/maintainTask.js.map +1 -0
  611. package/dist/net/guardedFetch.d.ts +32 -0
  612. package/dist/net/guardedFetch.js +220 -0
  613. package/dist/net/guardedFetch.js.map +1 -0
  614. package/dist/net/origin.js +40 -0
  615. package/dist/net/origin.js.map +1 -0
  616. package/dist/net/platform.d.ts +9 -0
  617. package/dist/net/platform.js +35 -0
  618. package/dist/net/platform.js.map +1 -0
  619. package/dist/plugin/adminDependencies.js +34 -0
  620. package/dist/plugin/adminDependencies.js.map +1 -0
  621. package/dist/plugin/apiPath.js +23 -0
  622. package/dist/plugin/apiPath.js.map +1 -0
  623. package/dist/plugin/boundDocument.js +58 -0
  624. package/dist/plugin/boundDocument.js.map +1 -0
  625. package/dist/plugin/buildPhase.js +10 -0
  626. package/dist/plugin/buildPhase.js.map +1 -0
  627. package/dist/plugin/collectionChecks.js +232 -0
  628. package/dist/plugin/collectionChecks.js.map +1 -0
  629. package/dist/plugin/collectionFields.d.ts +13 -0
  630. package/dist/plugin/collectionFields.js +22 -0
  631. package/dist/plugin/collectionFields.js.map +1 -0
  632. package/dist/plugin/createRuntime.js +346 -0
  633. package/dist/plugin/createRuntime.js.map +1 -0
  634. package/dist/plugin/destroy.js +58 -0
  635. package/dist/plugin/destroy.js.map +1 -0
  636. package/dist/plugin/documentEndpoint.js +106 -53
  637. package/dist/plugin/documentEndpoint.js.map +1 -1
  638. package/dist/plugin/documentScopes.js +37 -0
  639. package/dist/plugin/documentScopes.js.map +1 -0
  640. package/dist/plugin/encrypted.js +25 -0
  641. package/dist/plugin/encrypted.js.map +1 -0
  642. package/dist/plugin/errors.d.ts +24 -0
  643. package/dist/plugin/errors.js +86 -0
  644. package/dist/plugin/errors.js.map +1 -0
  645. package/dist/plugin/flagsEndpoint.js +41 -0
  646. package/dist/plugin/flagsEndpoint.js.map +1 -0
  647. package/dist/plugin/goalHint.d.ts +1 -0
  648. package/dist/plugin/goalHint.js +35 -0
  649. package/dist/plugin/goalHint.js.map +1 -0
  650. package/dist/plugin/itemLabels.js +114 -0
  651. package/dist/plugin/itemLabels.js.map +1 -0
  652. package/dist/plugin/keepAlive.js +48 -0
  653. package/dist/plugin/keepAlive.js.map +1 -0
  654. package/dist/plugin/peerImportError.js +3 -6
  655. package/dist/plugin/peerImportError.js.map +1 -1
  656. package/dist/plugin/peers.js +64 -0
  657. package/dist/plugin/peers.js.map +1 -0
  658. package/dist/plugin/pluginCollections.js +161 -0
  659. package/dist/plugin/pluginCollections.js.map +1 -0
  660. package/dist/plugin/queryEndpoint.js +88 -52
  661. package/dist/plugin/queryEndpoint.js.map +1 -1
  662. package/dist/plugin/queryParams.js +7 -0
  663. package/dist/plugin/queryParams.js.map +1 -0
  664. package/dist/plugin/readContextForRequest.d.ts +11 -0
  665. package/dist/plugin/readContextForRequest.js +79 -32
  666. package/dist/plugin/readContextForRequest.js.map +1 -1
  667. package/dist/plugin/readFailure.js +22 -0
  668. package/dist/plugin/readFailure.js.map +1 -0
  669. package/dist/plugin/readableProviders.js +67 -0
  670. package/dist/plugin/readableProviders.js.map +1 -0
  671. package/dist/plugin/realtimeEndpoint.js +91 -21
  672. package/dist/plugin/realtimeEndpoint.js.map +1 -1
  673. package/dist/plugin/refreshEndpoint.js +138 -0
  674. package/dist/plugin/refreshEndpoint.js.map +1 -0
  675. package/dist/plugin/relabelFields.js +36 -0
  676. package/dist/plugin/relabelFields.js.map +1 -0
  677. package/dist/plugin/requestMemo.js +35 -0
  678. package/dist/plugin/requestMemo.js.map +1 -0
  679. package/dist/plugin/routeChecks.js +39 -0
  680. package/dist/plugin/routeChecks.js.map +1 -0
  681. package/dist/plugin/routes.d.ts +53 -0
  682. package/dist/plugin/routes.js +92 -0
  683. package/dist/plugin/routes.js.map +1 -0
  684. package/dist/plugin/runtime.d.ts +1 -1
  685. package/dist/plugin/runtime.js +235 -29
  686. package/dist/plugin/runtime.js.map +1 -1
  687. package/dist/plugin/schemaOnly.js +61 -0
  688. package/dist/plugin/schemaOnly.js.map +1 -0
  689. package/dist/plugin/scopeChange.js +23 -0
  690. package/dist/plugin/scopeChange.js.map +1 -0
  691. package/dist/plugin/scopeFieldBoot.js +4 -4
  692. package/dist/plugin/scopeFieldBoot.js.map +1 -1
  693. package/dist/plugin/scopeToken.js +33 -0
  694. package/dist/plugin/scopeToken.js.map +1 -0
  695. package/dist/plugin/sourcesEndpoint.js +50 -16
  696. package/dist/plugin/sourcesEndpoint.js.map +1 -1
  697. package/dist/plugin/unbundledLanguages.js +25 -0
  698. package/dist/plugin/unbundledLanguages.js.map +1 -0
  699. package/dist/plugin/walkFields.js +24 -0
  700. package/dist/plugin/walkFields.js.map +1 -0
  701. package/dist/plugin/warmTask.js +0 -0
  702. package/dist/plugin/warmTask.js.map +1 -1
  703. package/dist/providers/ProvidersListNotice.d.ts +11 -0
  704. package/dist/providers/ProvidersListNotice.js +36 -0
  705. package/dist/providers/ProvidersListNotice.js.map +1 -0
  706. package/dist/providers/access.d.ts +1 -0
  707. package/dist/providers/access.js +35 -26
  708. package/dist/providers/access.js.map +1 -1
  709. package/dist/providers/adapterPool.js +121 -0
  710. package/dist/providers/adapterPool.js.map +1 -0
  711. package/dist/providers/collection.d.ts +63 -0
  712. package/dist/providers/collection.js +372 -143
  713. package/dist/providers/collection.js.map +1 -1
  714. package/dist/providers/factory.d.ts +84 -0
  715. package/dist/providers/factory.js +86 -25
  716. package/dist/providers/factory.js.map +1 -1
  717. package/dist/providers/hosts.d.ts +25 -0
  718. package/dist/providers/hosts.js +128 -0
  719. package/dist/providers/hosts.js.map +1 -0
  720. package/dist/providers/probe.d.ts +1 -0
  721. package/dist/providers/probe.js +105 -0
  722. package/dist/providers/probe.js.map +1 -0
  723. package/dist/providers/refresh.d.ts +18 -0
  724. package/dist/providers/refresh.js +49 -0
  725. package/dist/providers/refresh.js.map +1 -0
  726. package/dist/providers/registry.js +329 -0
  727. package/dist/providers/registry.js.map +1 -0
  728. package/dist/providers/resolver.js +26 -88
  729. package/dist/providers/resolver.js.map +1 -1
  730. package/dist/providers/retarget.js +45 -0
  731. package/dist/providers/retarget.js.map +1 -0
  732. package/dist/providers/scopeUnique.js +41 -0
  733. package/dist/providers/scopeUnique.js.map +1 -0
  734. package/dist/providers/secrets.d.ts +26 -0
  735. package/dist/providers/secrets.js +61 -4
  736. package/dist/providers/secrets.js.map +1 -1
  737. package/dist/providers/stampScope.js +9 -6
  738. package/dist/providers/stampScope.js.map +1 -1
  739. package/dist/query/dates.js +10 -12
  740. package/dist/query/dates.js.map +1 -1
  741. package/dist/query/errors.d.ts +6 -13
  742. package/dist/query/fetchQuery.d.ts +36 -23
  743. package/dist/query/fetchQuery.js +96 -89
  744. package/dist/query/fetchQuery.js.map +1 -1
  745. package/dist/query/limits.js +8 -0
  746. package/dist/query/limits.js.map +1 -0
  747. package/dist/query/parse.d.ts +8 -2
  748. package/dist/query/parse.js +155 -108
  749. package/dist/query/parse.js.map +1 -1
  750. package/dist/query/response.d.ts +27 -4
  751. package/dist/query/response.js +18 -0
  752. package/dist/query/response.js.map +1 -0
  753. package/dist/react/AnalyticsProvider.d.ts +42 -20
  754. package/dist/react/AnalyticsProvider.js +24 -22
  755. package/dist/react/AnalyticsProvider.js.map +1 -1
  756. package/dist/react/TrackerBoot.js +15 -9
  757. package/dist/react/TrackerBoot.js.map +1 -1
  758. package/dist/react/useAnalytics.d.ts +2 -8
  759. package/dist/react/useAnalytics.js +31 -13
  760. package/dist/react/useAnalytics.js.map +1 -1
  761. package/dist/routes/captureRoute.d.ts +28 -0
  762. package/dist/routes/captureRoute.js +67 -0
  763. package/dist/routes/captureRoute.js.map +1 -0
  764. package/dist/routes/ingestRoute.d.ts +17 -0
  765. package/dist/routes/ingestRoute.js +17 -0
  766. package/dist/routes/ingestRoute.js.map +1 -0
  767. package/dist/site/AnalyticsScripts.d.ts +35 -0
  768. package/dist/site/AnalyticsScripts.js +44 -0
  769. package/dist/site/AnalyticsScripts.js.map +1 -0
  770. package/dist/site/getTrackerConfig.d.ts +15 -0
  771. package/dist/site/getTrackerConfig.js +43 -0
  772. package/dist/site/getTrackerConfig.js.map +1 -0
  773. package/dist/surfacing/afterRead.d.ts +37 -0
  774. package/dist/surfacing/bounded.js +38 -0
  775. package/dist/surfacing/bounded.js.map +1 -0
  776. package/dist/surfacing/breaker.js +107 -0
  777. package/dist/surfacing/breaker.js.map +1 -0
  778. package/dist/surfacing/cacheCollection.d.ts +8 -0
  779. package/dist/surfacing/cacheCollection.js +71 -0
  780. package/dist/surfacing/cacheCollection.js.map +1 -0
  781. package/dist/surfacing/cacheStore.d.ts +71 -1
  782. package/dist/surfacing/cacheStore.js +16 -37
  783. package/dist/surfacing/cacheStore.js.map +1 -1
  784. package/dist/surfacing/cacheSweep.d.ts +1 -0
  785. package/dist/surfacing/cacheSweep.js +59 -0
  786. package/dist/surfacing/cacheSweep.js.map +1 -0
  787. package/dist/surfacing/classifyError.js +282 -0
  788. package/dist/surfacing/classifyError.js.map +1 -0
  789. package/dist/surfacing/coalesce.js +2 -1
  790. package/dist/surfacing/coalesce.js.map +1 -1
  791. package/dist/surfacing/coldBudget.js +60 -0
  792. package/dist/surfacing/coldBudget.js.map +1 -0
  793. package/dist/surfacing/collectionCacheStore.js +183 -0
  794. package/dist/surfacing/collectionCacheStore.js.map +1 -0
  795. package/dist/surfacing/engine.d.ts +1 -1
  796. package/dist/surfacing/engine.js +514 -71
  797. package/dist/surfacing/engine.js.map +1 -1
  798. package/dist/surfacing/epoch.d.ts +1 -0
  799. package/dist/surfacing/epoch.js +116 -0
  800. package/dist/surfacing/epoch.js.map +1 -0
  801. package/dist/surfacing/lanes.d.ts +1 -0
  802. package/dist/surfacing/lanes.js +297 -0
  803. package/dist/surfacing/lanes.js.map +1 -0
  804. package/dist/surfacing/memo.js +40 -0
  805. package/dist/surfacing/memo.js.map +1 -0
  806. package/dist/surfacing/rateLimiter.d.ts +1 -0
  807. package/dist/surfacing/rateLimiter.js +69 -94
  808. package/dist/surfacing/rateLimiter.js.map +1 -1
  809. package/dist/surfacing/rebucket.js +178 -0
  810. package/dist/surfacing/rebucket.js.map +1 -0
  811. package/dist/surfacing/recipe.js +28 -0
  812. package/dist/surfacing/recipe.js.map +1 -0
  813. package/dist/surfacing/shape.js +22 -0
  814. package/dist/surfacing/shape.js.map +1 -0
  815. package/dist/surfacing/todaySplit.js +119 -0
  816. package/dist/surfacing/todaySplit.js.map +1 -0
  817. package/dist/sync/collection.d.ts +8 -0
  818. package/dist/sync/collection.js +30 -18
  819. package/dist/sync/collection.js.map +1 -1
  820. package/dist/sync/rekeyDurations.js +70 -0
  821. package/dist/sync/rekeyDurations.js.map +1 -0
  822. package/dist/sync/syncTask.js +222 -109
  823. package/dist/sync/syncTask.js.map +1 -1
  824. package/dist/testing/memoryAdapter.d.ts +6 -3
  825. package/dist/testing/memoryAdapter.js +12 -11
  826. package/dist/testing/memoryAdapter.js.map +1 -1
  827. package/dist/testing/settle.d.ts +11 -0
  828. package/dist/testing/settle.js +19 -0
  829. package/dist/testing/settle.js.map +1 -0
  830. package/dist/timeframe/calendar.js +65 -0
  831. package/dist/timeframe/calendar.js.map +1 -0
  832. package/dist/timeframe/comparison.js +46 -0
  833. package/dist/timeframe/comparison.js.map +1 -0
  834. package/dist/timeframe/presets.d.ts +1 -1
  835. package/dist/timeframe/presets.js +5 -5
  836. package/dist/timeframe/presets.js.map +1 -1
  837. package/dist/timeframe/reportingTimezone.d.ts +1 -0
  838. package/dist/timeframe/reportingTimezone.js +64 -0
  839. package/dist/timeframe/reportingTimezone.js.map +1 -0
  840. package/dist/timeframe/tz.js +55 -39
  841. package/dist/timeframe/tz.js.map +1 -1
  842. package/dist/tracker/autoCapture.js +125 -38
  843. package/dist/tracker/autoCapture.js.map +1 -1
  844. package/dist/tracker/campaign.js +52 -0
  845. package/dist/tracker/campaign.js.map +1 -0
  846. package/dist/tracker/config.d.ts +174 -0
  847. package/dist/tracker/config.js +25 -0
  848. package/dist/tracker/config.js.map +1 -0
  849. package/dist/tracker/createTracker.d.ts +5 -10
  850. package/dist/tracker/createTracker.js +437 -82
  851. package/dist/tracker/createTracker.js.map +1 -1
  852. package/dist/tracker/digest.js +28 -0
  853. package/dist/tracker/digest.js.map +1 -0
  854. package/dist/tracker/engagement.js +100 -0
  855. package/dist/tracker/engagement.js.map +1 -0
  856. package/dist/tracker/events.js +37 -0
  857. package/dist/tracker/events.js.map +1 -0
  858. package/dist/tracker/exclusion.d.ts +8 -0
  859. package/dist/tracker/exclusion.js +82 -0
  860. package/dist/tracker/exclusion.js.map +1 -0
  861. package/dist/tracker/gate.d.ts +8 -0
  862. package/dist/tracker/gate.js +244 -0
  863. package/dist/tracker/gate.js.map +1 -0
  864. package/dist/tracker/initTracker.d.ts +5 -8
  865. package/dist/tracker/initTracker.js +42 -14
  866. package/dist/tracker/initTracker.js.map +1 -1
  867. package/dist/tracker/itemCapture.js +224 -0
  868. package/dist/tracker/itemCapture.js.map +1 -0
  869. package/dist/tracker/loadScript.js +23 -15
  870. package/dist/tracker/loadScript.js.map +1 -1
  871. package/dist/tracker/pageTracking.js +6 -6
  872. package/dist/tracker/pageTracking.js.map +1 -1
  873. package/dist/tracker/registry.js +129 -30
  874. package/dist/tracker/registry.js.map +1 -1
  875. package/dist/tracker/sinks/createSink.js +60 -0
  876. package/dist/tracker/sinks/createSink.js.map +1 -0
  877. package/dist/tracker/sinks/ga4.js +106 -0
  878. package/dist/tracker/sinks/ga4.js.map +1 -0
  879. package/dist/tracker/sinks/native.js +21 -42
  880. package/dist/tracker/sinks/native.js.map +1 -1
  881. package/dist/tracker/sinks/plausible.js +36 -18
  882. package/dist/tracker/sinks/plausible.js.map +1 -1
  883. package/dist/tracker/sinks/posthog.js +145 -9
  884. package/dist/tracker/sinks/posthog.js.map +1 -1
  885. package/dist/tracker/sinks/umami.js +18 -10
  886. package/dist/tracker/sinks/umami.js.map +1 -1
  887. package/dist/tracker/sinks/vendor.js +54 -22
  888. package/dist/tracker/sinks/vendor.js.map +1 -1
  889. package/dist/tracker/skip.js +81 -0
  890. package/dist/tracker/skip.js.map +1 -0
  891. package/dist/tracker/storage.js +23 -0
  892. package/dist/tracker/storage.js.map +1 -0
  893. package/dist/tracker/transport.js +2 -5
  894. package/dist/tracker/transport.js.map +1 -1
  895. package/dist/tracker/types.d.ts +99 -44
  896. package/dist/tracker/window.js +7 -0
  897. package/dist/tracker/window.js.map +1 -0
  898. package/dist/translations/ar.js +266 -56
  899. package/dist/translations/ar.js.map +1 -1
  900. package/dist/translations/de.js +256 -55
  901. package/dist/translations/de.js.map +1 -1
  902. package/dist/translations/en.js +253 -56
  903. package/dist/translations/en.js.map +1 -1
  904. package/dist/translations/es.js +261 -57
  905. package/dist/translations/es.js.map +1 -1
  906. package/dist/translations/fr.js +265 -61
  907. package/dist/translations/fr.js.map +1 -1
  908. package/dist/translations/id.js +256 -56
  909. package/dist/translations/id.js.map +1 -1
  910. package/dist/translations/index.d.ts +1 -1
  911. package/dist/translations/index.js +5 -7
  912. package/dist/translations/index.js.map +1 -1
  913. package/dist/translations/intl.js +71 -0
  914. package/dist/translations/intl.js.map +1 -0
  915. package/dist/translations/keys.d.ts +240 -14
  916. package/dist/translations/keys.js +245 -14
  917. package/dist/translations/keys.js.map +1 -1
  918. package/dist/translations/ko.js +258 -58
  919. package/dist/translations/ko.js.map +1 -1
  920. package/dist/translations/labelMap.d.ts +10 -0
  921. package/dist/translations/labelMap.js +22 -0
  922. package/dist/translations/labelMap.js.map +1 -0
  923. package/dist/translations/metricKeys.js +16 -2
  924. package/dist/translations/metricKeys.js.map +1 -1
  925. package/dist/translations/parts.js +20 -0
  926. package/dist/translations/parts.js.map +1 -0
  927. package/dist/translations/plural.js +61 -0
  928. package/dist/translations/plural.js.map +1 -0
  929. package/dist/translations/pt.js +270 -66
  930. package/dist/translations/pt.js.map +1 -1
  931. package/dist/translations/ru.js +261 -55
  932. package/dist/translations/ru.js.map +1 -1
  933. package/dist/translations/server.d.ts +1 -0
  934. package/dist/translations/server.js +2 -3
  935. package/dist/translations/server.js.map +1 -1
  936. package/dist/translations/staticLabel.js +69 -0
  937. package/dist/translations/staticLabel.js.map +1 -0
  938. package/dist/translations/uk.js +261 -55
  939. package/dist/translations/uk.js.map +1 -1
  940. package/dist/translations/zh.js +256 -56
  941. package/dist/translations/zh.js.map +1 -1
  942. package/dist/ui/RangePicker.js +110 -0
  943. package/dist/ui/RangePicker.js.map +1 -0
  944. package/dist/ui/analytics.css +1667 -0
  945. package/dist/ui/calendarDays.js +27 -0
  946. package/dist/ui/calendarDays.js.map +1 -0
  947. package/dist/ui/classNames.js +7 -0
  948. package/dist/ui/classNames.js.map +1 -0
  949. package/dist/ui/components/Card.d.ts +28 -0
  950. package/dist/ui/components/Card.js +21 -0
  951. package/dist/ui/components/Card.js.map +1 -0
  952. package/dist/ui/components/ChartDataTable.d.ts +41 -0
  953. package/dist/ui/components/ChartDataTable.js +48 -0
  954. package/dist/ui/components/ChartDataTable.js.map +1 -0
  955. package/dist/ui/components/ChoiceMenu.js +48 -0
  956. package/dist/ui/components/ChoiceMenu.js.map +1 -0
  957. package/dist/ui/components/DataTable.d.ts +82 -0
  958. package/dist/ui/components/DataTable.js +214 -0
  959. package/dist/ui/components/DataTable.js.map +1 -0
  960. package/dist/ui/components/LabeledSelect.js +62 -0
  961. package/dist/ui/components/LabeledSelect.js.map +1 -0
  962. package/dist/ui/components/LiveAnnouncement.js +21 -0
  963. package/dist/ui/components/LiveAnnouncement.js.map +1 -0
  964. package/dist/ui/components/MetricCard.d.ts +38 -0
  965. package/dist/ui/components/MetricCard.js +39 -0
  966. package/dist/ui/components/MetricCard.js.map +1 -0
  967. package/dist/ui/components/NoValue.js +22 -0
  968. package/dist/ui/components/NoValue.js.map +1 -0
  969. package/dist/ui/components/ReadState.js +27 -0
  970. package/dist/ui/components/ReadState.js.map +1 -0
  971. package/dist/ui/components/RefreshButton.js +25 -0
  972. package/dist/ui/components/RefreshButton.js.map +1 -0
  973. package/dist/ui/components/SourcesNoticeBanner.js +20 -0
  974. package/dist/ui/components/SourcesNoticeBanner.js.map +1 -0
  975. package/dist/ui/cssVars.js +7 -0
  976. package/dist/ui/cssVars.js.map +1 -0
  977. package/dist/ui/data/WithScopeToken.d.ts +20 -0
  978. package/dist/ui/data/WithScopeToken.js +20 -0
  979. package/dist/ui/data/WithScopeToken.js.map +1 -0
  980. package/dist/ui/data/clientFieldProps.js +16 -0
  981. package/dist/ui/data/clientFieldProps.js.map +1 -0
  982. package/dist/ui/data/request.d.ts +46 -0
  983. package/dist/ui/data/request.js +119 -0
  984. package/dist/ui/data/request.js.map +1 -0
  985. package/dist/ui/data/scopeTokenContext.js +18 -0
  986. package/dist/ui/data/scopeTokenContext.js.map +1 -0
  987. package/dist/ui/data/sharedCache.js +48 -0
  988. package/dist/ui/data/sharedCache.js.map +1 -0
  989. package/dist/ui/data/useRequest.d.ts +19 -0
  990. package/dist/ui/data/useRequest.js +123 -0
  991. package/dist/ui/data/useRequest.js.map +1 -0
  992. package/dist/ui/data/useRequestScope.js +25 -0
  993. package/dist/ui/data/useRequestScope.js.map +1 -0
  994. package/dist/ui/hooks/useDirection.js +47 -0
  995. package/dist/ui/hooks/useDirection.js.map +1 -0
  996. package/dist/ui/hooks/useDismissOnEscape.js +25 -0
  997. package/dist/ui/hooks/useDismissOnEscape.js.map +1 -0
  998. package/dist/ui/hooks/useLiveAnnouncement.js +57 -0
  999. package/dist/ui/hooks/useLiveAnnouncement.js.map +1 -0
  1000. package/dist/ui/hooks/useRealtimePoll.js +112 -0
  1001. package/dist/ui/hooks/useRealtimePoll.js.map +1 -0
  1002. package/dist/ui/readState.js +19 -0
  1003. package/dist/ui/readState.js.map +1 -0
  1004. package/dist/ui/rows/toDisplayRows.js +49 -0
  1005. package/dist/ui/rows/toDisplayRows.js.map +1 -0
  1006. package/dist/ui/viewerClock.js +7 -0
  1007. package/dist/ui/viewerClock.js.map +1 -0
  1008. package/dist/view/AnalyticsNavLink.d.ts +5 -3
  1009. package/dist/view/AnalyticsNavLink.js +12 -8
  1010. package/dist/view/AnalyticsNavLink.js.map +1 -1
  1011. package/dist/view/AnalyticsView.d.ts +9 -10
  1012. package/dist/view/AnalyticsView.js +47 -19
  1013. package/dist/view/AnalyticsView.js.map +1 -1
  1014. package/dist/view/AnalyticsViewClient.d.ts +4 -7
  1015. package/dist/view/AnalyticsViewClient.js +15 -174
  1016. package/dist/view/AnalyticsViewClient.js.map +1 -1
  1017. package/dist/view/CountryFlag.d.ts +27 -0
  1018. package/dist/view/CountryFlag.js +44 -0
  1019. package/dist/view/CountryFlag.js.map +1 -0
  1020. package/dist/view/DocumentTitle.js +27 -0
  1021. package/dist/view/DocumentTitle.js.map +1 -0
  1022. package/dist/view/ViewRoot.d.ts +21 -0
  1023. package/dist/view/ViewRoot.js +155 -0
  1024. package/dist/view/ViewRoot.js.map +1 -0
  1025. package/dist/view/ViewSections.d.ts +38 -0
  1026. package/dist/view/ViewSections.js +190 -0
  1027. package/dist/view/ViewSections.js.map +1 -0
  1028. package/dist/view/authRedirect.js +2 -4
  1029. package/dist/view/authRedirect.js.map +1 -1
  1030. package/dist/view/consentShare.js +15 -0
  1031. package/dist/view/consentShare.js.map +1 -0
  1032. package/dist/view/conversionRate.js +9 -7
  1033. package/dist/view/conversionRate.js.map +1 -1
  1034. package/dist/view/dayRange.js +6 -10
  1035. package/dist/view/dayRange.js.map +1 -1
  1036. package/dist/view/exclusionLink.d.ts +27 -0
  1037. package/dist/view/exclusionLink.js +46 -0
  1038. package/dist/view/exclusionLink.js.map +1 -0
  1039. package/dist/view/flagSrc.js +14 -0
  1040. package/dist/view/flagSrc.js.map +1 -0
  1041. package/dist/view/gating.d.ts +15 -1
  1042. package/dist/view/gating.js +92 -20
  1043. package/dist/view/gating.js.map +1 -1
  1044. package/dist/view/hostCountryFlag.js +41 -0
  1045. package/dist/view/hostCountryFlag.js.map +1 -0
  1046. package/dist/view/labels.js +120 -3
  1047. package/dist/view/labels.js.map +1 -1
  1048. package/dist/view/metricAliases.js +10 -0
  1049. package/dist/view/metricAliases.js.map +1 -0
  1050. package/dist/view/navLabel.js +15 -0
  1051. package/dist/view/navLabel.js.map +1 -0
  1052. package/dist/view/registerView.js +13 -11
  1053. package/dist/view/registerView.js.map +1 -1
  1054. package/dist/view/scopeLabel.js +21 -0
  1055. package/dist/view/scopeLabel.js.map +1 -0
  1056. package/dist/view/sections/Breakdowns.js +221 -118
  1057. package/dist/view/sections/Breakdowns.js.map +1 -1
  1058. package/dist/view/sections/EmptyStates.js +120 -32
  1059. package/dist/view/sections/EmptyStates.js.map +1 -1
  1060. package/dist/view/sections/ExcludeBrowser.js +188 -0
  1061. package/dist/view/sections/ExcludeBrowser.js.map +1 -0
  1062. package/dist/view/sections/FilterChips.js +130 -25
  1063. package/dist/view/sections/FilterChips.js.map +1 -1
  1064. package/dist/view/sections/GoalsPanel.js +68 -59
  1065. package/dist/view/sections/GoalsPanel.js.map +1 -1
  1066. package/dist/view/sections/OverviewCards.js +42 -36
  1067. package/dist/view/sections/OverviewCards.js.map +1 -1
  1068. package/dist/view/sections/RealtimeStrip.js +70 -56
  1069. package/dist/view/sections/RealtimeStrip.js.map +1 -1
  1070. package/dist/view/sections/SectionBoundary.js +34 -0
  1071. package/dist/view/sections/SectionBoundary.js.map +1 -0
  1072. package/dist/view/sections/Toolbar.d.ts +11 -0
  1073. package/dist/view/sections/Toolbar.js +182 -116
  1074. package/dist/view/sections/Toolbar.js.map +1 -1
  1075. package/dist/view/sections/Trend.js +179 -73
  1076. package/dist/view/sections/Trend.js.map +1 -1
  1077. package/dist/view/state.d.ts +42 -0
  1078. package/dist/view/state.js +97 -53
  1079. package/dist/view/state.js.map +1 -1
  1080. package/dist/view/useViewClock.js +31 -0
  1081. package/dist/view/useViewClock.js.map +1 -0
  1082. package/dist/view/useViewQueries.d.ts +21 -0
  1083. package/dist/view/useViewQueries.js +50 -79
  1084. package/dist/view/useViewQueries.js.map +1 -1
  1085. package/dist/view/useViewState.js +42 -0
  1086. package/dist/view/useViewState.js.map +1 -0
  1087. package/dist/view/useViewUrl.js +52 -0
  1088. package/dist/view/useViewUrl.js.map +1 -0
  1089. package/dist/view/viewBody.js +30 -0
  1090. package/dist/view/viewBody.js.map +1 -0
  1091. package/dist/view/viewContext.d.ts +81 -0
  1092. package/dist/view/viewContext.js +49 -0
  1093. package/dist/view/viewContext.js.map +1 -0
  1094. package/dist/view/viewProps.d.ts +65 -8
  1095. package/dist/view/viewProps.js +123 -36
  1096. package/dist/view/viewProps.js.map +1 -1
  1097. package/dist/widgets/AnalyticsBreakdownWidget.d.ts +7 -3
  1098. package/dist/widgets/AnalyticsBreakdownWidget.js +153 -78
  1099. package/dist/widgets/AnalyticsBreakdownWidget.js.map +1 -1
  1100. package/dist/widgets/AnalyticsGoalsWidget.d.ts +6 -7
  1101. package/dist/widgets/AnalyticsGoalsWidget.js +126 -159
  1102. package/dist/widgets/AnalyticsGoalsWidget.js.map +1 -1
  1103. package/dist/widgets/AnalyticsMetricWidget.d.ts +7 -3
  1104. package/dist/widgets/AnalyticsMetricWidget.js +85 -83
  1105. package/dist/widgets/AnalyticsMetricWidget.js.map +1 -1
  1106. package/dist/widgets/AnalyticsRealtimeWidget.d.ts +7 -3
  1107. package/dist/widgets/AnalyticsRealtimeWidget.js +81 -61
  1108. package/dist/widgets/AnalyticsRealtimeWidget.js.map +1 -1
  1109. package/dist/widgets/AnalyticsTrendWidget.d.ts +7 -3
  1110. package/dist/widgets/AnalyticsTrendWidget.js +134 -100
  1111. package/dist/widgets/AnalyticsTrendWidget.js.map +1 -1
  1112. package/dist/widgets/ComparisonDelta.js +33 -42
  1113. package/dist/widgets/ComparisonDelta.js.map +1 -1
  1114. package/dist/widgets/RealtimeCounter.d.ts +27 -3
  1115. package/dist/widgets/RealtimeCounter.js +90 -62
  1116. package/dist/widgets/RealtimeCounter.js.map +1 -1
  1117. package/dist/widgets/WidgetCard.d.ts +80 -0
  1118. package/dist/widgets/WidgetCard.js +99 -0
  1119. package/dist/widgets/WidgetCard.js.map +1 -0
  1120. package/dist/widgets/WidgetFrame.js +42 -0
  1121. package/dist/widgets/WidgetFrame.js.map +1 -0
  1122. package/dist/widgets/WidgetShimmer.d.ts +55 -0
  1123. package/dist/widgets/WidgetShimmer.js +86 -0
  1124. package/dist/widgets/WidgetShimmer.js.map +1 -0
  1125. package/dist/widgets/breakdownTypes.js +18 -2
  1126. package/dist/widgets/breakdownTypes.js.map +1 -1
  1127. package/dist/widgets/customWidget.d.ts +5 -1
  1128. package/dist/widgets/customWidget.js +6 -7
  1129. package/dist/widgets/customWidget.js.map +1 -1
  1130. package/dist/widgets/defaultLayout.d.ts +26 -0
  1131. package/dist/widgets/defaultLayout.js +51 -0
  1132. package/dist/widgets/defaultLayout.js.map +1 -0
  1133. package/dist/widgets/defaults.d.ts +4 -3
  1134. package/dist/widgets/defaults.js +76 -24
  1135. package/dist/widgets/defaults.js.map +1 -1
  1136. package/dist/widgets/fieldRows.js +14 -0
  1137. package/dist/widgets/fieldRows.js.map +1 -0
  1138. package/dist/widgets/filterCaption.js +26 -0
  1139. package/dist/widgets/filterCaption.js.map +1 -0
  1140. package/dist/widgets/filterField.d.ts +15 -0
  1141. package/dist/widgets/filterField.js +86 -0
  1142. package/dist/widgets/filterField.js.map +1 -0
  1143. package/dist/widgets/filterValueLabel.d.ts +1 -0
  1144. package/dist/widgets/filterValueLabel.js +45 -0
  1145. package/dist/widgets/filterValueLabel.js.map +1 -0
  1146. package/dist/widgets/notices.js +79 -0
  1147. package/dist/widgets/notices.js.map +1 -0
  1148. package/dist/widgets/prepareWidgetRead.d.ts +24 -0
  1149. package/dist/widgets/prepareWidgetRead.js +110 -0
  1150. package/dist/widgets/prepareWidgetRead.js.map +1 -0
  1151. package/dist/widgets/range.js +26 -21
  1152. package/dist/widgets/range.js.map +1 -1
  1153. package/dist/widgets/readForWidget.d.ts +32 -13
  1154. package/dist/widgets/readForWidget.js +52 -63
  1155. package/dist/widgets/readForWidget.js.map +1 -1
  1156. package/dist/widgets/readForWidgetBreakdown.d.ts +45 -18
  1157. package/dist/widgets/readForWidgetBreakdown.js +71 -58
  1158. package/dist/widgets/readForWidgetBreakdown.js.map +1 -1
  1159. package/dist/widgets/readForWidgetGoals.d.ts +21 -17
  1160. package/dist/widgets/readForWidgetGoals.js +72 -52
  1161. package/dist/widgets/readForWidgetGoals.js.map +1 -1
  1162. package/dist/widgets/readForWidgetRealtime.d.ts +24 -11
  1163. package/dist/widgets/readForWidgetRealtime.js +69 -41
  1164. package/dist/widgets/readForWidgetRealtime.js.map +1 -1
  1165. package/dist/widgets/readForWidgetSeries.d.ts +29 -24
  1166. package/dist/widgets/readForWidgetSeries.js +66 -114
  1167. package/dist/widgets/readForWidgetSeries.js.map +1 -1
  1168. package/dist/widgets/readMeta.d.ts +48 -0
  1169. package/dist/widgets/readMeta.js +66 -0
  1170. package/dist/widgets/readMeta.js.map +1 -0
  1171. package/dist/widgets/realtimePoll.d.ts +1 -0
  1172. package/dist/widgets/realtimePoll.js +56 -16
  1173. package/dist/widgets/realtimePoll.js.map +1 -1
  1174. package/dist/widgets/registerWidgets.js +207 -124
  1175. package/dist/widgets/registerWidgets.js.map +1 -1
  1176. package/dist/widgets/stateKeys.js +30 -0
  1177. package/dist/widgets/stateKeys.js.map +1 -0
  1178. package/dist/widgets/titleForecast.js +89 -0
  1179. package/dist/widgets/titleForecast.js.map +1 -0
  1180. package/dist/widgets/types.d.ts +16 -0
  1181. package/dist/widgets/types.js +2 -0
  1182. package/dist/widgets/types.js.map +1 -1
  1183. package/dist/widgets/viewLink.d.ts +24 -6
  1184. package/dist/widgets/viewLink.js +36 -26
  1185. package/dist/widgets/viewLink.js.map +1 -1
  1186. package/dist/widgets/widgetData.js +34 -0
  1187. package/dist/widgets/widgetData.js.map +1 -0
  1188. package/dist/widgets/widgetWindow.d.ts +1 -0
  1189. package/dist/widgets/widgetWindow.js +51 -0
  1190. package/dist/widgets/widgetWindow.js.map +1 -0
  1191. package/package.json +61 -42
  1192. package/dist/capture/getTrackerConfig.d.ts +0 -20
  1193. package/dist/capture/getTrackerConfig.js +0 -31
  1194. package/dist/capture/getTrackerConfig.js.map +0 -1
  1195. package/dist/capture/slots.d.ts +0 -8
  1196. package/dist/capture/trackerConfig.d.ts +0 -33
  1197. package/dist/charts/styles.js +0 -59
  1198. package/dist/charts/styles.js.map +0 -1
  1199. package/dist/exports/next.d.ts +0 -3
  1200. package/dist/exports/next.js +0 -3
  1201. package/dist/fields/config/SourceSelectField.d.ts +0 -14
  1202. package/dist/fields/dateRange/styles.js +0 -23
  1203. package/dist/fields/dateRange/styles.js.map +0 -1
  1204. package/dist/goals/GoalSelectField.d.ts +0 -7
  1205. package/dist/native/collections/events.js +0 -121
  1206. package/dist/native/collections/events.js.map +0 -1
  1207. package/dist/native/collections/rollups.js +0 -151
  1208. package/dist/native/collections/rollups.js.map +0 -1
  1209. package/dist/native/collections/seen.js +0 -47
  1210. package/dist/native/collections/seen.js.map +0 -1
  1211. package/dist/native/ingest/flushBatch.js +0 -60
  1212. package/dist/native/ingest/flushBatch.js.map +0 -1
  1213. package/dist/native/ingest/salt.js +0 -14
  1214. package/dist/native/ingest/salt.js.map +0 -1
  1215. package/dist/native/ingest/writeBuffer.js +0 -55
  1216. package/dist/native/ingest/writeBuffer.js.map +0 -1
  1217. package/dist/native/ingest/writeEvent.js +0 -14
  1218. package/dist/native/ingest/writeEvent.js.map +0 -1
  1219. package/dist/native/query/eventAgg.js +0 -161
  1220. package/dist/native/query/eventAgg.js.map +0 -1
  1221. package/dist/native/realtime/buildRealtime.js +0 -53
  1222. package/dist/native/realtime/buildRealtime.js.map +0 -1
  1223. package/dist/native/retention/pruneTask.js +0 -29
  1224. package/dist/native/retention/pruneTask.js.map +0 -1
  1225. package/dist/native/rollupAcc.js +0 -64
  1226. package/dist/native/rollupAcc.js.map +0 -1
  1227. package/dist/native/rollups/applyDistinctDeltas.js +0 -9
  1228. package/dist/native/rollups/applyDistinctDeltas.js.map +0 -1
  1229. package/dist/native/rollups/bumpRollup.js +0 -73
  1230. package/dist/native/rollups/bumpRollup.js.map +0 -1
  1231. package/dist/native/rollups/deltas.js +0 -90
  1232. package/dist/native/rollups/deltas.js.map +0 -1
  1233. package/dist/native/rollups/insertIfNew.js +0 -53
  1234. package/dist/native/rollups/insertIfNew.js.map +0 -1
  1235. package/dist/next/captureRewrites.d.ts +0 -41
  1236. package/dist/next/captureRewrites.js +0 -56
  1237. package/dist/next/captureRewrites.js.map +0 -1
  1238. package/dist/next/posthogProxyRewrites.d.ts +0 -41
  1239. package/dist/next/posthogProxyRewrites.js +0 -45
  1240. package/dist/next/posthogProxyRewrites.js.map +0 -1
  1241. package/dist/plugin/paths.js +0 -27
  1242. package/dist/plugin/paths.js.map +0 -1
  1243. package/dist/query/errors.js +0 -10
  1244. package/dist/query/errors.js.map +0 -1
  1245. package/dist/react/TrackerBoot.d.ts +0 -22
  1246. package/dist/rsc/AnalyticsScripts.d.ts +0 -30
  1247. package/dist/rsc/AnalyticsScripts.js +0 -41
  1248. package/dist/rsc/AnalyticsScripts.js.map +0 -1
  1249. package/dist/surfacing/queue.js +0 -60
  1250. package/dist/surfacing/queue.js.map +0 -1
  1251. package/dist/surfacing/retryPolicy.js +0 -15
  1252. package/dist/surfacing/retryPolicy.js.map +0 -1
  1253. package/dist/tracker/autoCapture.d.ts +0 -48
  1254. package/dist/tracker/consent.d.ts +0 -24
  1255. package/dist/tracker/consent.js +0 -48
  1256. package/dist/tracker/consent.js.map +0 -1
  1257. package/dist/tracker/loadScript.d.ts +0 -14
  1258. package/dist/tracker/pageTracking.d.ts +0 -17
  1259. package/dist/tracker/registry.d.ts +0 -27
  1260. package/dist/tracker/sinks/native.d.ts +0 -22
  1261. package/dist/tracker/sinks/plausible.d.ts +0 -14
  1262. package/dist/tracker/sinks/posthog.d.ts +0 -14
  1263. package/dist/tracker/sinks/umami.d.ts +0 -13
  1264. package/dist/tracker/sinks/vendor.d.ts +0 -14
  1265. package/dist/view/sections/styles.js +0 -74
  1266. package/dist/view/sections/styles.js.map +0 -1
  1267. package/dist/widgets/WidgetViewLink.js +0 -17
  1268. package/dist/widgets/WidgetViewLink.js.map +0 -1
  1269. package/dist/widgets/cardChrome.d.ts +0 -8
  1270. package/dist/widgets/cardChrome.js +0 -46
  1271. package/dist/widgets/cardChrome.js.map +0 -1
  1272. package/dist/widgets/comparison.js +0 -43
  1273. package/dist/widgets/comparison.js.map +0 -1
@@ -1,20 +1,12 @@
1
- import { clientIpFromHeaders } from "../native/ingest/clientIp.js";
2
- import { PROXY_PATH } from "../plugin/paths.js";
3
- import { getRuntime } from "../plugin/runtime.js";
4
- import { buildDownstreamHeaders, buildUpstreamHeaders, matchProxyRoute } from "./proxyRoutes.js";
5
- import { readCappedBody } from "./requestBody.js";
1
+ import { getRuntime, resolveCaptureScopeFor } from "../plugin/runtime.js";
2
+ import { emptyResponse, pathBelowMount, relayToVendor, unforwardedMethodResponse } from "./relay.js";
3
+ import { refusedCrossSite, warnUntrustedForwarding } from "./requestTrust.js";
4
+ import { refusedSameSite } from "./sameSite.js";
6
5
  import { isCaptureSlot, resolveSlotAdapter } from "./slots.js";
7
6
  //#region src/capture/proxyEndpoint.ts
8
- /** Deadline for the upstream response headers, not for the body download. */
9
- const DEFAULT_PROXY_TIMEOUT_MS = 1e4;
10
- /** PostHog batches carrying session-replay data routinely exceed 64 KB. */
11
- const DEFAULT_PROXY_MAX_BODY_BYTES = 1024 * 1024;
12
- /** The path pattern the proxy is registered at, one entry per method. */
13
- const PROXY_ENDPOINT_PATH = `${PROXY_PATH}/:slot/:path*`;
14
7
  /**
15
- * Payload matches an endpoint by exact method, and `@payloadcms/next` only routes these
16
- * six, so the handler is registered for all of them: the three it serves, and the three
17
- * it must answer 405 for rather than leaving to Payload's generic 404.
8
+ * Payload matches endpoints by exact method and `@payloadcms/next` routes only these six: three
9
+ * served, three answered 405 rather than left to Payload's generic 404.
18
10
  */
19
11
  const PROXY_METHODS = [
20
12
  "get",
@@ -24,100 +16,65 @@ const PROXY_METHODS = [
24
16
  "patch",
25
17
  "delete"
26
18
  ];
27
- const ALLOWED_METHODS = "GET, POST, OPTIONS";
28
- const SERVED_METHODS = new Set([
29
- "GET",
30
- "POST",
31
- "OPTIONS"
32
- ]);
33
- const empty = (status, headers) => new Response(null, {
34
- status,
35
- headers
36
- });
37
19
  /**
38
- * The request path relative to the slot mount, still percent-encoded: path-to-regexp
39
- * decodes it per segment, so re-encoding here would turn legal path characters
40
- * (`,=+:@`) into escapes the vendor never sent.
20
+ * Whether a POST comes from a page that may not relay through this slot: another site's, which
21
+ * cannot use this site's vendor accounts, or on the tenant slot a sibling subdomain's posting into
22
+ * another tenant's vendor project.
41
23
  */
42
- const subPath = (req, slot) => {
43
- const pathname = req.pathname ?? (req.url ? new URL(req.url).pathname : "");
44
- const mount = `${PROXY_PATH}/${slot}`;
45
- const start = pathname.indexOf(mount);
46
- if (start === -1) return "/";
47
- return pathname.slice(start + mount.length) || "/";
48
- };
49
- const proxyLimits = (runtime) => ({
50
- timeoutMs: runtime.captureProxy?.timeoutMs ?? 1e4,
51
- maxBodyBytes: runtime.captureProxy?.maxBodyBytes ?? 1048576
52
- });
24
+ const refusedPost = async (req, runtime, slot) => refusedCrossSite(req.headers, runtime.allowedOrigins) || slot === "tenant" && await refusedSameSite(req, () => resolveCaptureScopeFor(runtime, req), (twin) => resolveCaptureScopeFor(runtime, twin));
53
25
  /**
54
- * Public first-party proxy for a slot's vendor tracker: `${PROXY_PATH}/:slot/:path*`,
55
- * registered for every method Payload routes.
56
- *
57
- * The only URLs it ever fetches are compiled from the slot adapter's own
58
- * `capture.proxy.routes` templates, so an unfilled slot, an adapter without capture, or
59
- * a path outside the declared routes is a 404 and nothing leaves the server. Credentials
60
- * (`cookie`, `authorization`) never go upstream and `set-cookie` never comes back; a
61
- * body over `capture.proxy.maxBodyBytes` is refused with 413 and one that dies in
62
- * transit with 400, both before anything is forwarded; upstream failures answer 502
63
- * without echoing the URL or the error.
26
+ * Public first-party proxy for a slot's vendor tracker at `<proxyMount>/:slot/:path*`, relaying only
27
+ * the slot adapter's declared routes; another site's or another tenant's page is refused with 403.
64
28
  */
65
- const makeProxyHandler = () => async (req) => {
29
+ const makeProxyHandler = (proxyMount) => async (req) => {
30
+ try {
31
+ return await relay(req, proxyMount);
32
+ } catch (err) {
33
+ req.payload?.logger?.warn(`analytics: capture proxy request failed: ${String(err)}`);
34
+ return emptyResponse(500);
35
+ }
36
+ };
37
+ const relay = async (req, proxyMount) => {
66
38
  const method = (req.method ?? "get").toUpperCase();
67
- if (!SERVED_METHODS.has(method)) return empty(405, { allow: ALLOWED_METHODS });
68
- if (method === "OPTIONS") return empty(204, { allow: ALLOWED_METHODS });
39
+ const unforwarded = unforwardedMethodResponse(method);
40
+ if (unforwarded) return unforwarded;
69
41
  const runtime = getRuntime(req.payload);
70
42
  const slot = req.routeParams?.slot;
71
- if (!runtime || typeof slot !== "string" || !isCaptureSlot(slot)) return empty(404);
43
+ if (!runtime || typeof slot !== "string" || !isCaptureSlot(slot)) return emptyResponse(404);
44
+ if (method === "POST" && await refusedPost(req, runtime, slot)) return emptyResponse(403);
72
45
  const adapter = await resolveSlotAdapter(runtime, req, slot);
73
46
  const descriptor = adapter?.capture?.proxy;
74
- if (!descriptor || descriptor.routes.length === 0) return empty(404);
75
- const matched = matchProxyRoute(descriptor.routes, subPath(req, slot), { trailingSlashes: descriptor.trailingSlashes });
76
- if (!matched) return empty(404);
77
- const { upstreamUrl } = matched;
78
- const search = req.search ?? (req.url ? new URL(req.url).search : "");
79
- if (search && search !== "?") {
80
- const incoming = search.startsWith("?") ? search.slice(1) : search;
81
- upstreamUrl.search = upstreamUrl.search ? `${upstreamUrl.search}&${incoming}` : `?${incoming}`;
82
- }
83
- const limits = proxyLimits(runtime);
84
- let body;
85
- if (method === "POST") {
86
- const read = await readCappedBody(req, limits.maxBodyBytes);
87
- if (!read.ok) return empty(read.reason === "too-large" ? 413 : 400);
88
- body = read.body;
89
- }
90
- const controller = new AbortController();
91
- const timer = setTimeout(() => controller.abort(), limits.timeoutMs);
92
- try {
93
- const upstream = await fetch(upstreamUrl, {
94
- method,
95
- headers: buildUpstreamHeaders(req.headers, clientIpFromHeaders(req.headers), descriptor.forwardHeaders ?? []),
96
- body,
97
- redirect: "manual",
98
- signal: controller.signal
99
- });
100
- return new Response(upstream.body, {
101
- status: upstream.status,
102
- headers: buildDownstreamHeaders(upstream.headers)
103
- });
104
- } catch (err) {
105
- req.payload?.logger?.warn(`analytics: capture proxy upstream failed for "${adapter?.id}": ${String(err)}`);
106
- return empty(502);
107
- } finally {
108
- clearTimeout(timer);
109
- }
47
+ if (!adapter || !descriptor || descriptor.routes.length === 0) return emptyResponse(404);
48
+ const trust = {
49
+ trustedProxyHops: runtime.trustedProxyHops,
50
+ trustedPlatform: runtime.trustedPlatform
51
+ };
52
+ warnUntrustedForwarding(req.payload, req.headers, trust);
53
+ const pathname = req.pathname ?? (req.url ? new URL(req.url).pathname : "");
54
+ return relayToVendor({
55
+ method,
56
+ headers: req.headers,
57
+ path: pathBelowMount(pathname, `${proxyMount}/${slot}`) ?? "/",
58
+ search: req.search ?? (req.url ? new URL(req.url).search : ""),
59
+ body: req
60
+ }, {
61
+ descriptor,
62
+ timeoutMs: runtime.captureProxy?.timeoutMs ?? 1e4,
63
+ maxBodyBytes: runtime.captureProxy?.maxBodyBytes ?? 1048576,
64
+ trust,
65
+ warn: (message) => req.payload?.logger?.warn(`analytics: capture proxy upstream failed for "${adapter.id}": ${message}`)
66
+ });
110
67
  };
111
68
  /** The six endpoint entries the plugin registers, all sharing one handler. */
112
- const proxyEndpoints = () => {
113
- const handler = makeProxyHandler();
69
+ const proxyEndpoints = (routes) => {
70
+ const handler = makeProxyHandler(routes.proxy);
114
71
  return PROXY_METHODS.map((method) => ({
115
72
  method,
116
- path: PROXY_ENDPOINT_PATH,
73
+ path: routes.proxyPattern,
117
74
  handler
118
75
  }));
119
76
  };
120
77
  //#endregion
121
- export { DEFAULT_PROXY_MAX_BODY_BYTES, DEFAULT_PROXY_TIMEOUT_MS, proxyEndpoints };
78
+ export { proxyEndpoints };
122
79
 
123
80
  //# sourceMappingURL=proxyEndpoint.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"proxyEndpoint.js","names":[],"sources":["../../src/capture/proxyEndpoint.ts"],"sourcesContent":["import type { Endpoint, PayloadHandler, PayloadRequest } from 'payload'\nimport { clientIpFromHeaders } from '../native/ingest/clientIp'\nimport { PROXY_PATH } from '../plugin/paths'\nimport { type AnalyticsRuntime, getRuntime } from '../plugin/runtime'\nimport { buildDownstreamHeaders, buildUpstreamHeaders, matchProxyRoute } from './proxyRoutes'\nimport { readCappedBody } from './requestBody'\nimport { type CaptureSlot, isCaptureSlot, resolveSlotAdapter } from './slots'\n\nexport { PROXY_PATH }\n\n/** Deadline for the upstream response headers, not for the body download. */\nexport const DEFAULT_PROXY_TIMEOUT_MS = 10_000\n\n/** PostHog batches carrying session-replay data routinely exceed 64 KB. */\nexport const DEFAULT_PROXY_MAX_BODY_BYTES = 1024 * 1024\n\n/** The path pattern the proxy is registered at, one entry per method. */\nexport const PROXY_ENDPOINT_PATH = `${PROXY_PATH}/:slot/:path*`\n\n/**\n * Payload matches an endpoint by exact method, and `@payloadcms/next` only routes these\n * six, so the handler is registered for all of them: the three it serves, and the three\n * it must answer 405 for rather than leaving to Payload's generic 404.\n */\nexport const PROXY_METHODS: ReadonlyArray<Endpoint['method']> = [\n\t'get',\n\t'post',\n\t'options',\n\t'put',\n\t'patch',\n\t'delete',\n]\n\nconst ALLOWED_METHODS = 'GET, POST, OPTIONS'\nconst SERVED_METHODS = new Set(['GET', 'POST', 'OPTIONS'])\n\nconst empty = (status: number, headers?: HeadersInit) => new Response(null, { status, headers })\n\n/**\n * The request path relative to the slot mount, still percent-encoded: path-to-regexp\n * decodes it per segment, so re-encoding here would turn legal path characters\n * (`,=+:@`) into escapes the vendor never sent.\n */\nconst subPath = (req: PayloadRequest, slot: CaptureSlot): string => {\n\tconst pathname = req.pathname ?? (req.url ? new URL(req.url).pathname : '')\n\tconst mount = `${PROXY_PATH}/${slot}`\n\tconst start = pathname.indexOf(mount)\n\tif (start === -1) {\n\t\treturn '/'\n\t}\n\treturn pathname.slice(start + mount.length) || '/'\n}\n\nconst proxyLimits = (runtime: AnalyticsRuntime) => ({\n\ttimeoutMs: runtime.captureProxy?.timeoutMs ?? DEFAULT_PROXY_TIMEOUT_MS,\n\tmaxBodyBytes: runtime.captureProxy?.maxBodyBytes ?? DEFAULT_PROXY_MAX_BODY_BYTES,\n})\n\n/**\n * Public first-party proxy for a slot's vendor tracker: `${PROXY_PATH}/:slot/:path*`,\n * registered for every method Payload routes.\n *\n * The only URLs it ever fetches are compiled from the slot adapter's own\n * `capture.proxy.routes` templates, so an unfilled slot, an adapter without capture, or\n * a path outside the declared routes is a 404 and nothing leaves the server. Credentials\n * (`cookie`, `authorization`) never go upstream and `set-cookie` never comes back; a\n * body over `capture.proxy.maxBodyBytes` is refused with 413 and one that dies in\n * transit with 400, both before anything is forwarded; upstream failures answer 502\n * without echoing the URL or the error.\n */\nexport const makeProxyHandler = (): PayloadHandler => async (req) => {\n\tconst method = (req.method ?? 'get').toUpperCase()\n\tif (!SERVED_METHODS.has(method)) {\n\t\treturn empty(405, { allow: ALLOWED_METHODS })\n\t}\n\t// The tracker is same-origin, so a preflight never reaches a real deployment. Answering\n\t// locally beats forwarding one and stripping the CORS headers that made it meaningful.\n\tif (method === 'OPTIONS') {\n\t\treturn empty(204, { allow: ALLOWED_METHODS })\n\t}\n\tconst runtime = getRuntime(req.payload)\n\tconst slot = (req.routeParams as { slot?: unknown } | undefined)?.slot\n\tif (!runtime || typeof slot !== 'string' || !isCaptureSlot(slot)) {\n\t\treturn empty(404)\n\t}\n\tconst adapter = await resolveSlotAdapter(runtime, req, slot)\n\tconst descriptor = adapter?.capture?.proxy\n\tif (!descriptor || descriptor.routes.length === 0) {\n\t\treturn empty(404)\n\t}\n\tconst matched = matchProxyRoute(descriptor.routes, subPath(req, slot), {\n\t\ttrailingSlashes: descriptor.trailingSlashes,\n\t})\n\tif (!matched) {\n\t\treturn empty(404)\n\t}\n\tconst { upstreamUrl } = matched\n\tconst search = req.search ?? (req.url ? new URL(req.url).search : '')\n\tif (search && search !== '?') {\n\t\tconst incoming = search.startsWith('?') ? search.slice(1) : search\n\t\tupstreamUrl.search = upstreamUrl.search ? `${upstreamUrl.search}&${incoming}` : `?${incoming}`\n\t}\n\tconst limits = proxyLimits(runtime)\n\t// Buffered rather than streamed: a duplex request stream fails as a hung upstream\n\t// connection, and the cap has to be enforced before any of it is forwarded anyway.\n\tlet body: ArrayBuffer | undefined\n\tif (method === 'POST') {\n\t\tconst read = await readCappedBody(req, limits.maxBodyBytes)\n\t\tif (!read.ok) {\n\t\t\treturn empty(read.reason === 'too-large' ? 413 : 400)\n\t\t}\n\t\tbody = read.body\n\t}\n\t// The deadline covers time-to-headers only. AbortSignal.timeout would keep running\n\t// against the body stream and truncate a slow but healthy download.\n\tconst controller = new AbortController()\n\tconst timer = setTimeout(() => controller.abort(), limits.timeoutMs)\n\ttry {\n\t\tconst upstream = await fetch(upstreamUrl, {\n\t\t\tmethod,\n\t\t\theaders: buildUpstreamHeaders(\n\t\t\t\treq.headers,\n\t\t\t\tclientIpFromHeaders(req.headers),\n\t\t\t\tdescriptor.forwardHeaders ?? []\n\t\t\t),\n\t\t\tbody,\n\t\t\tredirect: 'manual',\n\t\t\tsignal: controller.signal,\n\t\t})\n\t\treturn new Response(upstream.body, {\n\t\t\tstatus: upstream.status,\n\t\t\theaders: buildDownstreamHeaders(upstream.headers),\n\t\t})\n\t} catch (err) {\n\t\treq.payload?.logger?.warn(\n\t\t\t`analytics: capture proxy upstream failed for \"${adapter?.id}\": ${String(err)}`\n\t\t)\n\t\treturn empty(502)\n\t} finally {\n\t\tclearTimeout(timer)\n\t}\n}\n\n/** The six endpoint entries the plugin registers, all sharing one handler. */\nexport const proxyEndpoints = (): Endpoint[] => {\n\tconst handler = makeProxyHandler()\n\treturn PROXY_METHODS.map((method) => ({ method, path: PROXY_ENDPOINT_PATH, handler }))\n}\n"],"mappings":";;;;;;;;AAWA,MAAa,2BAA2B;;AAGxC,MAAa,+BAA+B,OAAO;;AAGnD,MAAa,sBAAsB,GAAG,WAAW;;;;;;AAOjD,MAAa,gBAAmD;CAC/D;CACA;CACA;CACA;CACA;CACA;AACD;AAEA,MAAM,kBAAkB;AACxB,MAAM,iBAAiB,IAAI,IAAI;CAAC;CAAO;CAAQ;AAAS,CAAC;AAEzD,MAAM,SAAS,QAAgB,YAA0B,IAAI,SAAS,MAAM;CAAE;CAAQ;AAAQ,CAAC;;;;;;AAO/F,MAAM,WAAW,KAAqB,SAA8B;CACnE,MAAM,WAAW,IAAI,aAAa,IAAI,MAAM,IAAI,IAAI,IAAI,GAAG,EAAE,WAAW;CACxE,MAAM,QAAQ,GAAG,WAAW,GAAG;CAC/B,MAAM,QAAQ,SAAS,QAAQ,KAAK;CACpC,IAAI,UAAU,IACb,OAAO;CAER,OAAO,SAAS,MAAM,QAAQ,MAAM,MAAM,KAAK;AAChD;AAEA,MAAM,eAAe,aAA+B;CACnD,WAAW,QAAQ,cAAc,aAAA;CACjC,cAAc,QAAQ,cAAc,gBAAA;AACrC;;;;;;;;;;;;;AAcA,MAAa,yBAAyC,OAAO,QAAQ;CACpE,MAAM,UAAU,IAAI,UAAU,OAAO,YAAY;CACjD,IAAI,CAAC,eAAe,IAAI,MAAM,GAC7B,OAAO,MAAM,KAAK,EAAE,OAAO,gBAAgB,CAAC;CAI7C,IAAI,WAAW,WACd,OAAO,MAAM,KAAK,EAAE,OAAO,gBAAgB,CAAC;CAE7C,MAAM,UAAU,WAAW,IAAI,OAAO;CACtC,MAAM,OAAQ,IAAI,aAAgD;CAClE,IAAI,CAAC,WAAW,OAAO,SAAS,YAAY,CAAC,cAAc,IAAI,GAC9D,OAAO,MAAM,GAAG;CAEjB,MAAM,UAAU,MAAM,mBAAmB,SAAS,KAAK,IAAI;CAC3D,MAAM,aAAa,SAAS,SAAS;CACrC,IAAI,CAAC,cAAc,WAAW,OAAO,WAAW,GAC/C,OAAO,MAAM,GAAG;CAEjB,MAAM,UAAU,gBAAgB,WAAW,QAAQ,QAAQ,KAAK,IAAI,GAAG,EACtE,iBAAiB,WAAW,gBAC7B,CAAC;CACD,IAAI,CAAC,SACJ,OAAO,MAAM,GAAG;CAEjB,MAAM,EAAE,gBAAgB;CACxB,MAAM,SAAS,IAAI,WAAW,IAAI,MAAM,IAAI,IAAI,IAAI,GAAG,EAAE,SAAS;CAClE,IAAI,UAAU,WAAW,KAAK;EAC7B,MAAM,WAAW,OAAO,WAAW,GAAG,IAAI,OAAO,MAAM,CAAC,IAAI;EAC5D,YAAY,SAAS,YAAY,SAAS,GAAG,YAAY,OAAO,GAAG,aAAa,IAAI;CACrF;CACA,MAAM,SAAS,YAAY,OAAO;CAGlC,IAAI;CACJ,IAAI,WAAW,QAAQ;EACtB,MAAM,OAAO,MAAM,eAAe,KAAK,OAAO,YAAY;EAC1D,IAAI,CAAC,KAAK,IACT,OAAO,MAAM,KAAK,WAAW,cAAc,MAAM,GAAG;EAErD,OAAO,KAAK;CACb;CAGA,MAAM,aAAa,IAAI,gBAAgB;CACvC,MAAM,QAAQ,iBAAiB,WAAW,MAAM,GAAG,OAAO,SAAS;CACnE,IAAI;EACH,MAAM,WAAW,MAAM,MAAM,aAAa;GACzC;GACA,SAAS,qBACR,IAAI,SACJ,oBAAoB,IAAI,OAAO,GAC/B,WAAW,kBAAkB,CAAC,CAC/B;GACA;GACA,UAAU;GACV,QAAQ,WAAW;EACpB,CAAC;EACD,OAAO,IAAI,SAAS,SAAS,MAAM;GAClC,QAAQ,SAAS;GACjB,SAAS,uBAAuB,SAAS,OAAO;EACjD,CAAC;CACF,SAAS,KAAK;EACb,IAAI,SAAS,QAAQ,KACpB,iDAAiD,SAAS,GAAG,KAAK,OAAO,GAAG,GAC7E;EACA,OAAO,MAAM,GAAG;CACjB,UAAU;EACT,aAAa,KAAK;CACnB;AACD;;AAGA,MAAa,uBAAmC;CAC/C,MAAM,UAAU,iBAAiB;CACjC,OAAO,cAAc,KAAK,YAAY;EAAE;EAAQ,MAAM;EAAqB;CAAQ,EAAE;AACtF"}
1
+ {"version":3,"file":"proxyEndpoint.js","names":[],"sources":["../../src/capture/proxyEndpoint.ts"],"sourcesContent":["import type { Endpoint, PayloadHandler, PayloadRequest } from 'payload'\nimport type { RoutePaths } from '../plugin/routes'\nimport { type AnalyticsRuntime, getRuntime, resolveCaptureScopeFor } from '../plugin/runtime'\nimport type { CaptureSlot } from '../tracker/config'\nimport {\n\tDEFAULT_PROXY_MAX_BODY_BYTES,\n\tDEFAULT_PROXY_TIMEOUT_MS,\n\temptyResponse,\n\tpathBelowMount,\n\trelayToVendor,\n\tunforwardedMethodResponse,\n} from './relay'\nimport { refusedCrossSite, warnUntrustedForwarding } from './requestTrust'\nimport { refusedSameSite } from './sameSite'\nimport { isCaptureSlot, resolveSlotAdapter } from './slots'\n\nexport { DEFAULT_PROXY_MAX_BODY_BYTES, DEFAULT_PROXY_TIMEOUT_MS } from './relay'\n\n/**\n * Payload matches endpoints by exact method and `@payloadcms/next` routes only these six: three\n * served, three answered 405 rather than left to Payload's generic 404.\n */\nconst PROXY_METHODS: ReadonlyArray<Endpoint['method']> = [\n\t'get',\n\t'post',\n\t'options',\n\t'put',\n\t'patch',\n\t'delete',\n]\n\n/**\n * Whether a POST comes from a page that may not relay through this slot: another site's, which\n * cannot use this site's vendor accounts, or on the tenant slot a sibling subdomain's posting into\n * another tenant's vendor project.\n */\nconst refusedPost = async (\n\treq: PayloadRequest,\n\truntime: AnalyticsRuntime,\n\tslot: CaptureSlot\n): Promise<boolean> =>\n\trefusedCrossSite(req.headers, runtime.allowedOrigins) ||\n\t(slot === 'tenant' &&\n\t\t(await refusedSameSite(\n\t\t\treq,\n\t\t\t() => resolveCaptureScopeFor(runtime, req),\n\t\t\t(twin) => resolveCaptureScopeFor(runtime, twin)\n\t\t)))\n\n/**\n * Public first-party proxy for a slot's vendor tracker at `<proxyMount>/:slot/:path*`, relaying only\n * the slot adapter's declared routes; another site's or another tenant's page is refused with 403.\n */\nexport const makeProxyHandler =\n\t(proxyMount: string): PayloadHandler =>\n\tasync (req) => {\n\t\ttry {\n\t\t\treturn await relay(req, proxyMount)\n\t\t} catch (err) {\n\t\t\treq.payload?.logger?.warn(`analytics: capture proxy request failed: ${String(err)}`)\n\t\t\treturn emptyResponse(500)\n\t\t}\n\t}\n\nconst relay = async (req: PayloadRequest, proxyMount: string): Promise<Response> => {\n\tconst method = (req.method ?? 'get').toUpperCase()\n\tconst unforwarded = unforwardedMethodResponse(method)\n\tif (unforwarded) {\n\t\treturn unforwarded\n\t}\n\tconst runtime = getRuntime(req.payload)\n\tconst slot = req.routeParams?.slot\n\tif (!runtime || typeof slot !== 'string' || !isCaptureSlot(slot)) {\n\t\treturn emptyResponse(404)\n\t}\n\tif (method === 'POST' && (await refusedPost(req, runtime, slot))) {\n\t\treturn emptyResponse(403)\n\t}\n\tconst adapter = await resolveSlotAdapter(runtime, req, slot)\n\tconst descriptor = adapter?.capture?.proxy\n\tif (!adapter || !descriptor || descriptor.routes.length === 0) {\n\t\treturn emptyResponse(404)\n\t}\n\tconst trust = {\n\t\ttrustedProxyHops: runtime.trustedProxyHops,\n\t\ttrustedPlatform: runtime.trustedPlatform,\n\t}\n\twarnUntrustedForwarding(req.payload, req.headers, trust)\n\tconst pathname = req.pathname ?? (req.url ? new URL(req.url).pathname : '')\n\treturn relayToVendor(\n\t\t{\n\t\t\tmethod,\n\t\t\theaders: req.headers,\n\t\t\tpath: pathBelowMount(pathname, `${proxyMount}/${slot}`) ?? '/',\n\t\t\tsearch: req.search ?? (req.url ? new URL(req.url).search : ''),\n\t\t\tbody: req,\n\t\t},\n\t\t{\n\t\t\tdescriptor,\n\t\t\ttimeoutMs: runtime.captureProxy?.timeoutMs ?? DEFAULT_PROXY_TIMEOUT_MS,\n\t\t\tmaxBodyBytes: runtime.captureProxy?.maxBodyBytes ?? DEFAULT_PROXY_MAX_BODY_BYTES,\n\t\t\ttrust,\n\t\t\twarn: (message) =>\n\t\t\t\treq.payload?.logger?.warn(\n\t\t\t\t\t`analytics: capture proxy upstream failed for \"${adapter.id}\": ${message}`\n\t\t\t\t),\n\t\t}\n\t)\n}\n\n/** The six endpoint entries the plugin registers, all sharing one handler. */\nexport const proxyEndpoints = (routes: Pick<RoutePaths, 'proxy' | 'proxyPattern'>): Endpoint[] => {\n\tconst handler = makeProxyHandler(routes.proxy)\n\treturn PROXY_METHODS.map((method) => ({ method, path: routes.proxyPattern, handler }))\n}\n"],"mappings":";;;;;;;;;;AAsBA,MAAM,gBAAmD;CACxD;CACA;CACA;CACA;CACA;CACA;AACD;;;;;;AAOA,MAAM,cAAc,OACnB,KACA,SACA,SAEA,iBAAiB,IAAI,SAAS,QAAQ,cAAc,KACnD,SAAS,YACR,MAAM,gBACN,WACM,uBAAuB,SAAS,GAAG,IACxC,SAAS,uBAAuB,SAAS,IAAI,CAC/C;;;;;AAMF,MAAa,oBACX,eACD,OAAO,QAAQ;CACd,IAAI;EACH,OAAO,MAAM,MAAM,KAAK,UAAU;CACnC,SAAS,KAAK;EACb,IAAI,SAAS,QAAQ,KAAK,4CAA4C,OAAO,GAAG,GAAG;EACnF,OAAO,cAAc,GAAG;CACzB;AACD;AAED,MAAM,QAAQ,OAAO,KAAqB,eAA0C;CACnF,MAAM,UAAU,IAAI,UAAU,OAAO,YAAY;CACjD,MAAM,cAAc,0BAA0B,MAAM;CACpD,IAAI,aACH,OAAO;CAER,MAAM,UAAU,WAAW,IAAI,OAAO;CACtC,MAAM,OAAO,IAAI,aAAa;CAC9B,IAAI,CAAC,WAAW,OAAO,SAAS,YAAY,CAAC,cAAc,IAAI,GAC9D,OAAO,cAAc,GAAG;CAEzB,IAAI,WAAW,UAAW,MAAM,YAAY,KAAK,SAAS,IAAI,GAC7D,OAAO,cAAc,GAAG;CAEzB,MAAM,UAAU,MAAM,mBAAmB,SAAS,KAAK,IAAI;CAC3D,MAAM,aAAa,SAAS,SAAS;CACrC,IAAI,CAAC,WAAW,CAAC,cAAc,WAAW,OAAO,WAAW,GAC3D,OAAO,cAAc,GAAG;CAEzB,MAAM,QAAQ;EACb,kBAAkB,QAAQ;EAC1B,iBAAiB,QAAQ;CAC1B;CACA,wBAAwB,IAAI,SAAS,IAAI,SAAS,KAAK;CACvD,MAAM,WAAW,IAAI,aAAa,IAAI,MAAM,IAAI,IAAI,IAAI,GAAG,EAAE,WAAW;CACxE,OAAO,cACN;EACC;EACA,SAAS,IAAI;EACb,MAAM,eAAe,UAAU,GAAG,WAAW,GAAG,MAAM,KAAK;EAC3D,QAAQ,IAAI,WAAW,IAAI,MAAM,IAAI,IAAI,IAAI,GAAG,EAAE,SAAS;EAC3D,MAAM;CACP,GACA;EACC;EACA,WAAW,QAAQ,cAAc,aAAA;EACjC,cAAc,QAAQ,cAAc,gBAAA;EACpC;EACA,OAAO,YACN,IAAI,SAAS,QAAQ,KACpB,iDAAiD,QAAQ,GAAG,KAAK,SAClE;CACF,CACD;AACD;;AAGA,MAAa,kBAAkB,WAAmE;CACjG,MAAM,UAAU,iBAAiB,OAAO,KAAK;CAC7C,OAAO,cAAc,KAAK,YAAY;EAAE;EAAQ,MAAM,OAAO;EAAc;CAAQ,EAAE;AACtF"}
@@ -1,3 +1,4 @@
1
+ import { VISITOR_HEADERS } from "../net/platform.js";
1
2
  import { compile, match } from "path-to-regexp";
2
3
  //#region src/capture/proxyRoutes.ts
3
4
  /** Request headers every vendor proxy forwards upstream. */
@@ -13,8 +14,8 @@ const FORWARDED_REQUEST_HEADERS = [
13
14
  "if-modified-since"
14
15
  ];
15
16
  /**
16
- * Never forwarded, whatever a descriptor's `forwardHeaders` asks for: credentials
17
- * the vendor has no business seeing, and the forwarding chain the proxy sets itself.
17
+ * Never forwarded, whatever `forwardHeaders` asks: credentials, the forwarding chain the proxy sets
18
+ * itself, and platform headers about the visitor's address or location.
18
19
  */
19
20
  const NEVER_FORWARDED_REQUEST_HEADERS = new Set([
20
21
  "cookie",
@@ -25,31 +26,49 @@ const NEVER_FORWARDED_REQUEST_HEADERS = new Set([
25
26
  "x-forwarded-for",
26
27
  "x-forwarded-host",
27
28
  "x-forwarded-proto",
28
- "x-real-ip"
29
+ "x-real-ip",
30
+ ...VISITOR_HEADERS
29
31
  ]);
30
32
  /**
31
- * The only upstream response headers passed back. `content-encoding` and
32
- * `content-length` are deliberately absent: fetch decodes the body but leaves both
33
- * describing the compressed bytes, so forwarding either corrupts the response.
33
+ * The upstream response headers passed back as they came. Not `content-encoding` or
34
+ * `content-length`: fetch decodes the body but leaves both describing the compressed bytes.
34
35
  */
35
36
  const FORWARDED_RESPONSE_HEADERS = [
36
- "content-type",
37
37
  "cache-control",
38
38
  "etag",
39
39
  "last-modified",
40
40
  "vary"
41
41
  ];
42
+ /**
43
+ * The validators and freshness a data route never passes on: its answer is about one visitor, so
44
+ * no cache between the site and the browser may keep it, whatever the vendor said.
45
+ */
46
+ const SCRIPT_ONLY_RESPONSE_HEADERS = new Set([
47
+ "cache-control",
48
+ "etag",
49
+ "last-modified"
50
+ ]);
51
+ /** What every data route answers with in place of the vendor's own caching headers. */
52
+ const DATA_CACHE_CONTROL = "private, no-store";
53
+ /** What a script route is always served as, whatever the vendor labelled it. */
54
+ const SCRIPT_CONTENT_TYPE = "text/javascript; charset=utf-8";
55
+ /** What a data route answer becomes unless the vendor sent JSON or plain text. */
56
+ const DATA_FALLBACK_CONTENT_TYPE = "text/plain; charset=utf-8";
57
+ /** A data answer can never be a document of this origin, even one a browser opens directly. */
58
+ const DATA_CONTENT_SECURITY_POLICY = "sandbox; default-src 'none'";
59
+ const DATA_CONTENT_TYPES = new Set(["application/json", "text/plain"]);
42
60
  const isSafeUpstream = (url) => url.protocol === "https:" || url.protocol === "http:";
43
61
  const PATH_SAFE_ESCAPES = /%(24|26|2B|2C|3A|3D|40)/gi;
44
62
  const encodeSegment = (segment) => encodeURIComponent(segment).replace(PATH_SAFE_ESCAPES, (_, hex) => String.fromCharCode(Number.parseInt(hex, 16)));
45
63
  const paramSegments = (value) => Array.isArray(value) ? value.map(String) : typeof value === "string" ? [value] : [];
46
- /** A dot segment would collapse when assigned to `URL.pathname`, escaping the route prefix. */
47
- const hasDotSegment = (params) => Object.values(params).flatMap(paramSegments).some((segment) => segment === "." || segment === "..");
48
64
  /**
49
- * First declared route whose `source` matches `path` (percent-encoded, relative to the
50
- * slot mount), compiled into its absolute upstream URL. Null when no route matches, so
51
- * the caller answers 404: an upstream URL only ever comes from a descriptor template,
52
- * never from the request.
65
+ * A segment that could leave the route prefix: a dot segment collapses when assigned to
66
+ * `URL.pathname`, and an encoded `/` or `\` is a separator to an upstream that decodes it.
67
+ */
68
+ const escapesRoute = (params) => Object.values(params).flatMap(paramSegments).some((segment) => segment === "." || segment === ".." || segment.includes("/") || segment.includes("\\"));
69
+ /**
70
+ * The first route whose `source` matches `path`, compiled into its upstream URL, or null for a 404:
71
+ * an upstream URL only ever comes from a descriptor template, never from the request.
53
72
  */
54
73
  const matchProxyRoute = (routes, path, options = {}) => {
55
74
  for (const route of routes) {
@@ -62,8 +81,8 @@ const matchProxyRoute = (routes, path, options = {}) => {
62
81
  if (!isSafeUpstream(template)) continue;
63
82
  const matched = match(route.source, { decode: decodeURIComponent })(path);
64
83
  if (!matched) continue;
65
- const params = matched.params;
66
- if (hasDotSegment(params)) return null;
84
+ const { params } = matched;
85
+ if (escapesRoute(params)) return null;
67
86
  let compiled;
68
87
  try {
69
88
  compiled = compile(template.pathname, { encode: encodeSegment })(params);
@@ -73,14 +92,16 @@ const matchProxyRoute = (routes, path, options = {}) => {
73
92
  const keepSlash = options.trailingSlashes === true && path.endsWith("/") && !compiled.endsWith("/");
74
93
  const upstreamUrl = new URL(template.href);
75
94
  upstreamUrl.pathname = compiled === "" ? "/" : `${compiled}${keepSlash ? "/" : ""}`;
76
- return { upstreamUrl };
95
+ return {
96
+ upstreamUrl,
97
+ kind: route.kind
98
+ };
77
99
  }
78
100
  return null;
79
101
  };
80
102
  /**
81
- * The headers the upstream request carries: the allowlist plus a descriptor's own
82
- * extras, and `X-Forwarded-For` from the resolved client IP so vendor geo stays
83
- * correct. An absent IP sends no header rather than a fabricated one.
103
+ * The allowlist plus a descriptor's extras, and `X-Forwarded-For` from the resolved client IP so
104
+ * vendor geo stays right; an absent IP sends no header rather than a fabricated one.
84
105
  */
85
106
  const buildUpstreamHeaders = (incoming, clientIp, extra = []) => {
86
107
  const out = new Headers();
@@ -93,13 +114,29 @@ const buildUpstreamHeaders = (incoming, clientIp, extra = []) => {
93
114
  if (clientIp) out.set("x-forwarded-for", clientIp);
94
115
  return out;
95
116
  };
96
- /** The headers the client sees: the response allowlist, so `set-cookie` can never pass. */
97
- const buildDownstreamHeaders = (upstream) => {
117
+ /** A JSON or plain-text type as the vendor wrote it; anything else, or nothing, as plain text. */
118
+ const dataContentType = (value) => {
119
+ const media = value?.split(";")[0]?.trim().toLowerCase();
120
+ return value !== null && media !== void 0 && DATA_CONTENT_TYPES.has(media) ? value : DATA_FALLBACK_CONTENT_TYPE;
121
+ };
122
+ /**
123
+ * The response allowlist (so `set-cookie` never passes) and a content type the route's kind decides.
124
+ * A data route is sandboxed and uncached, so an upstream answering HTML cannot put a page on the site.
125
+ */
126
+ const buildDownstreamHeaders = (upstream, kind) => {
98
127
  const out = new Headers();
99
128
  for (const name of FORWARDED_RESPONSE_HEADERS) {
129
+ if (kind === "data" && SCRIPT_ONLY_RESPONSE_HEADERS.has(name)) continue;
100
130
  const value = upstream.get(name);
101
131
  if (value !== null) out.set(name, value);
102
132
  }
133
+ out.set("x-content-type-options", "nosniff");
134
+ if (kind === "script") out.set("content-type", SCRIPT_CONTENT_TYPE);
135
+ else {
136
+ out.set("content-type", dataContentType(upstream.get("content-type")));
137
+ out.set("cache-control", DATA_CACHE_CONTROL);
138
+ out.set("content-security-policy", DATA_CONTENT_SECURITY_POLICY);
139
+ }
103
140
  return out;
104
141
  };
105
142
  //#endregion
@@ -1 +1 @@
1
- {"version":3,"file":"proxyRoutes.js","names":[],"sources":["../../src/capture/proxyRoutes.ts"],"sourcesContent":["import { compile, match } from 'path-to-regexp'\nimport type { ProxyRoute } from '../core/capture'\n\n/** Request headers every vendor proxy forwards upstream. */\nexport const FORWARDED_REQUEST_HEADERS = [\n\t'content-type',\n\t'accept',\n\t'accept-encoding',\n\t'accept-language',\n\t'user-agent',\n\t'origin',\n\t'referer',\n\t'if-none-match',\n\t'if-modified-since',\n]\n\n/**\n * Never forwarded, whatever a descriptor's `forwardHeaders` asks for: credentials\n * the vendor has no business seeing, and the forwarding chain the proxy sets itself.\n */\nconst NEVER_FORWARDED_REQUEST_HEADERS = new Set([\n\t'cookie',\n\t'authorization',\n\t'proxy-authorization',\n\t'host',\n\t'forwarded',\n\t'x-forwarded-for',\n\t'x-forwarded-host',\n\t'x-forwarded-proto',\n\t'x-real-ip',\n])\n\n/**\n * The only upstream response headers passed back. `content-encoding` and\n * `content-length` are deliberately absent: fetch decodes the body but leaves both\n * describing the compressed bytes, so forwarding either corrupts the response.\n */\nexport const FORWARDED_RESPONSE_HEADERS = [\n\t'content-type',\n\t'cache-control',\n\t'etag',\n\t'last-modified',\n\t'vary',\n]\n\nexport interface ProxyMatch {\n\tupstreamUrl: URL\n}\n\nexport interface MatchProxyRouteOptions {\n\t/** `ProxyDescriptor.trailingSlashes`: keep a request's trailing slash upstream. */\n\ttrailingSlashes?: boolean\n}\n\nconst isSafeUpstream = (url: URL): boolean => url.protocol === 'https:' || url.protocol === 'http:'\n\n// encodeURIComponent escapes every RFC 3986 sub-delim plus ':' and '@', all of which are\n// legal inside a path segment, so a vendor URL would not round-trip byte for byte. Restore\n// exactly those; '/', '?' and '#' stay escaped because they would change the URL's shape,\n// and ';' because some upstreams read it as a matrix-param separator.\nconst PATH_SAFE_ESCAPES = /%(24|26|2B|2C|3A|3D|40)/gi\n\nconst encodeSegment = (segment: string): string =>\n\tencodeURIComponent(segment).replace(PATH_SAFE_ESCAPES, (_, hex: string) =>\n\t\tString.fromCharCode(Number.parseInt(hex, 16))\n\t)\n\nconst paramSegments = (value: unknown): string[] =>\n\tArray.isArray(value) ? value.map(String) : typeof value === 'string' ? [value] : []\n\n/** A dot segment would collapse when assigned to `URL.pathname`, escaping the route prefix. */\nconst hasDotSegment = (params: Record<string, unknown>): boolean =>\n\tObject.values(params)\n\t\t.flatMap(paramSegments)\n\t\t.some((segment) => segment === '.' || segment === '..')\n\n/**\n * First declared route whose `source` matches `path` (percent-encoded, relative to the\n * slot mount), compiled into its absolute upstream URL. Null when no route matches, so\n * the caller answers 404: an upstream URL only ever comes from a descriptor template,\n * never from the request.\n */\nexport const matchProxyRoute = (\n\troutes: ProxyRoute[],\n\tpath: string,\n\toptions: MatchProxyRouteOptions = {}\n): ProxyMatch | null => {\n\tfor (const route of routes) {\n\t\tlet template: URL\n\t\ttry {\n\t\t\ttemplate = new URL(route.upstream)\n\t\t} catch {\n\t\t\tcontinue\n\t\t}\n\t\tif (!isSafeUpstream(template)) {\n\t\t\tcontinue\n\t\t}\n\t\tconst matched = match(route.source, { decode: decodeURIComponent })(path)\n\t\tif (!matched) {\n\t\t\tcontinue\n\t\t}\n\t\tconst params = matched.params as Record<string, unknown>\n\t\tif (hasDotSegment(params)) {\n\t\t\treturn null\n\t\t}\n\t\tlet compiled: string\n\t\ttry {\n\t\t\tcompiled = compile(template.pathname, { encode: encodeSegment })(params)\n\t\t} catch {\n\t\t\t// A template naming a param its source never produces is a broken descriptor,\n\t\t\t// not a request the client can fix: skip it rather than throwing a public 500.\n\t\t\tcontinue\n\t\t}\n\t\t// path-to-regexp drops the trailing slash a wildcard consumed. Only a descriptor\n\t\t// that asks for it gets it back, because only PostHog's capture endpoints need it.\n\t\tconst keepSlash =\n\t\t\toptions.trailingSlashes === true && path.endsWith('/') && !compiled.endsWith('/')\n\t\tconst upstreamUrl = new URL(template.href)\n\t\tupstreamUrl.pathname = compiled === '' ? '/' : `${compiled}${keepSlash ? '/' : ''}`\n\t\treturn { upstreamUrl }\n\t}\n\treturn null\n}\n\n/**\n * The headers the upstream request carries: the allowlist plus a descriptor's own\n * extras, and `X-Forwarded-For` from the resolved client IP so vendor geo stays\n * correct. An absent IP sends no header rather than a fabricated one.\n */\nexport const buildUpstreamHeaders = (\n\tincoming: Headers,\n\tclientIp: string | null,\n\textra: string[] = []\n): Headers => {\n\tconst out = new Headers()\n\tconst names = [...FORWARDED_REQUEST_HEADERS, ...extra.map((name) => name.toLowerCase())]\n\tfor (const name of names) {\n\t\tif (NEVER_FORWARDED_REQUEST_HEADERS.has(name)) {\n\t\t\tcontinue\n\t\t}\n\t\tconst value = incoming.get(name)\n\t\tif (value !== null) {\n\t\t\tout.set(name, value)\n\t\t}\n\t}\n\tif (clientIp) {\n\t\tout.set('x-forwarded-for', clientIp)\n\t}\n\treturn out\n}\n\n/** The headers the client sees: the response allowlist, so `set-cookie` can never pass. */\nexport const buildDownstreamHeaders = (upstream: Headers): Headers => {\n\tconst out = new Headers()\n\tfor (const name of FORWARDED_RESPONSE_HEADERS) {\n\t\tconst value = upstream.get(name)\n\t\tif (value !== null) {\n\t\t\tout.set(name, value)\n\t\t}\n\t}\n\treturn out\n}\n"],"mappings":";;;AAIA,MAAa,4BAA4B;CACxC;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AACD;;;;;AAMA,MAAM,kCAAkC,IAAI,IAAI;CAC/C;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AACD,CAAC;;;;;;AAOD,MAAa,6BAA6B;CACzC;CACA;CACA;CACA;CACA;AACD;AAWA,MAAM,kBAAkB,QAAsB,IAAI,aAAa,YAAY,IAAI,aAAa;AAM5F,MAAM,oBAAoB;AAE1B,MAAM,iBAAiB,YACtB,mBAAmB,OAAO,EAAE,QAAQ,oBAAoB,GAAG,QAC1D,OAAO,aAAa,OAAO,SAAS,KAAK,EAAE,CAAC,CAC7C;AAED,MAAM,iBAAiB,UACtB,MAAM,QAAQ,KAAK,IAAI,MAAM,IAAI,MAAM,IAAI,OAAO,UAAU,WAAW,CAAC,KAAK,IAAI,CAAC;;AAGnF,MAAM,iBAAiB,WACtB,OAAO,OAAO,MAAM,EAClB,QAAQ,aAAa,EACrB,MAAM,YAAY,YAAY,OAAO,YAAY,IAAI;;;;;;;AAQxD,MAAa,mBACZ,QACA,MACA,UAAkC,CAAC,MACZ;CACvB,KAAK,MAAM,SAAS,QAAQ;EAC3B,IAAI;EACJ,IAAI;GACH,WAAW,IAAI,IAAI,MAAM,QAAQ;EAClC,QAAQ;GACP;EACD;EACA,IAAI,CAAC,eAAe,QAAQ,GAC3B;EAED,MAAM,UAAU,MAAM,MAAM,QAAQ,EAAE,QAAQ,mBAAmB,CAAC,EAAE,IAAI;EACxE,IAAI,CAAC,SACJ;EAED,MAAM,SAAS,QAAQ;EACvB,IAAI,cAAc,MAAM,GACvB,OAAO;EAER,IAAI;EACJ,IAAI;GACH,WAAW,QAAQ,SAAS,UAAU,EAAE,QAAQ,cAAc,CAAC,EAAE,MAAM;EACxE,QAAQ;GAGP;EACD;EAGA,MAAM,YACL,QAAQ,oBAAoB,QAAQ,KAAK,SAAS,GAAG,KAAK,CAAC,SAAS,SAAS,GAAG;EACjF,MAAM,cAAc,IAAI,IAAI,SAAS,IAAI;EACzC,YAAY,WAAW,aAAa,KAAK,MAAM,GAAG,WAAW,YAAY,MAAM;EAC/E,OAAO,EAAE,YAAY;CACtB;CACA,OAAO;AACR;;;;;;AAOA,MAAa,wBACZ,UACA,UACA,QAAkB,CAAC,MACN;CACb,MAAM,MAAM,IAAI,QAAQ;CACxB,MAAM,QAAQ,CAAC,GAAG,2BAA2B,GAAG,MAAM,KAAK,SAAS,KAAK,YAAY,CAAC,CAAC;CACvF,KAAK,MAAM,QAAQ,OAAO;EACzB,IAAI,gCAAgC,IAAI,IAAI,GAC3C;EAED,MAAM,QAAQ,SAAS,IAAI,IAAI;EAC/B,IAAI,UAAU,MACb,IAAI,IAAI,MAAM,KAAK;CAErB;CACA,IAAI,UACH,IAAI,IAAI,mBAAmB,QAAQ;CAEpC,OAAO;AACR;;AAGA,MAAa,0BAA0B,aAA+B;CACrE,MAAM,MAAM,IAAI,QAAQ;CACxB,KAAK,MAAM,QAAQ,4BAA4B;EAC9C,MAAM,QAAQ,SAAS,IAAI,IAAI;EAC/B,IAAI,UAAU,MACb,IAAI,IAAI,MAAM,KAAK;CAErB;CACA,OAAO;AACR"}
1
+ {"version":3,"file":"proxyRoutes.js","names":[],"sources":["../../src/capture/proxyRoutes.ts"],"sourcesContent":["import { compile, match } from 'path-to-regexp'\nimport type { ProxyRoute, ProxyRouteKind } from '../core/capture'\nimport { VISITOR_HEADERS } from '../net/platform'\n\n/** Request headers every vendor proxy forwards upstream. */\nexport const FORWARDED_REQUEST_HEADERS = [\n\t'content-type',\n\t'accept',\n\t'accept-encoding',\n\t'accept-language',\n\t'user-agent',\n\t'origin',\n\t'referer',\n\t'if-none-match',\n\t'if-modified-since',\n]\n\n/**\n * Never forwarded, whatever `forwardHeaders` asks: credentials, the forwarding chain the proxy sets\n * itself, and platform headers about the visitor's address or location.\n */\nconst NEVER_FORWARDED_REQUEST_HEADERS = new Set([\n\t'cookie',\n\t'authorization',\n\t'proxy-authorization',\n\t'host',\n\t'forwarded',\n\t'x-forwarded-for',\n\t'x-forwarded-host',\n\t'x-forwarded-proto',\n\t'x-real-ip',\n\t...VISITOR_HEADERS,\n])\n\n/**\n * The upstream response headers passed back as they came. Not `content-encoding` or\n * `content-length`: fetch decodes the body but leaves both describing the compressed bytes.\n */\nconst FORWARDED_RESPONSE_HEADERS = ['cache-control', 'etag', 'last-modified', 'vary']\n\n/**\n * The validators and freshness a data route never passes on: its answer is about one visitor, so\n * no cache between the site and the browser may keep it, whatever the vendor said.\n */\nconst SCRIPT_ONLY_RESPONSE_HEADERS: ReadonlySet<string> = new Set([\n\t'cache-control',\n\t'etag',\n\t'last-modified',\n])\n\n/** What every data route answers with in place of the vendor's own caching headers. */\nexport const DATA_CACHE_CONTROL = 'private, no-store'\n\n/** What a script route is always served as, whatever the vendor labelled it. */\nexport const SCRIPT_CONTENT_TYPE = 'text/javascript; charset=utf-8'\n\n/** What a data route answer becomes unless the vendor sent JSON or plain text. */\nexport const DATA_FALLBACK_CONTENT_TYPE = 'text/plain; charset=utf-8'\n\n/** A data answer can never be a document of this origin, even one a browser opens directly. */\nexport const DATA_CONTENT_SECURITY_POLICY = \"sandbox; default-src 'none'\"\n\nconst DATA_CONTENT_TYPES: ReadonlySet<string> = new Set(['application/json', 'text/plain'])\n\nexport interface ProxyMatch {\n\tupstreamUrl: URL\n\tkind: ProxyRouteKind\n}\n\nexport interface MatchProxyRouteOptions {\n\t/** `ProxyDescriptor.trailingSlashes`: keep a request's trailing slash upstream. */\n\ttrailingSlashes?: boolean\n}\n\nconst isSafeUpstream = (url: URL): boolean => url.protocol === 'https:' || url.protocol === 'http:'\n\n// encodeURIComponent escapes sub-delims, ':' and '@', all legal in a segment, so those come\n// back; '/', '?' and '#' would reshape the URL, and some upstreams split on ';'.\nconst PATH_SAFE_ESCAPES = /%(24|26|2B|2C|3A|3D|40)/gi\n\nconst encodeSegment = (segment: string): string =>\n\tencodeURIComponent(segment).replace(PATH_SAFE_ESCAPES, (_, hex: string) =>\n\t\tString.fromCharCode(Number.parseInt(hex, 16))\n\t)\n\nconst paramSegments = (value: unknown): string[] =>\n\tArray.isArray(value) ? value.map(String) : typeof value === 'string' ? [value] : []\n\n/**\n * A segment that could leave the route prefix: a dot segment collapses when assigned to\n * `URL.pathname`, and an encoded `/` or `\\` is a separator to an upstream that decodes it.\n */\nconst escapesRoute = (params: Record<string, unknown>): boolean =>\n\tObject.values(params)\n\t\t.flatMap(paramSegments)\n\t\t.some(\n\t\t\t(segment) =>\n\t\t\t\tsegment === '.' || segment === '..' || segment.includes('/') || segment.includes('\\\\')\n\t\t)\n\n/**\n * The first route whose `source` matches `path`, compiled into its upstream URL, or null for a 404:\n * an upstream URL only ever comes from a descriptor template, never from the request.\n */\nexport const matchProxyRoute = (\n\troutes: ProxyRoute[],\n\tpath: string,\n\toptions: MatchProxyRouteOptions = {}\n): ProxyMatch | null => {\n\tfor (const route of routes) {\n\t\tlet template: URL\n\t\ttry {\n\t\t\ttemplate = new URL(route.upstream)\n\t\t} catch {\n\t\t\tcontinue\n\t\t}\n\t\tif (!isSafeUpstream(template)) {\n\t\t\tcontinue\n\t\t}\n\t\tconst matched = match<Record<string, unknown>>(route.source, { decode: decodeURIComponent })(\n\t\t\tpath\n\t\t)\n\t\tif (!matched) {\n\t\t\tcontinue\n\t\t}\n\t\tconst { params } = matched\n\t\tif (escapesRoute(params)) {\n\t\t\treturn null\n\t\t}\n\t\tlet compiled: string\n\t\ttry {\n\t\t\tcompiled = compile(template.pathname, { encode: encodeSegment })(params)\n\t\t} catch {\n\t\t\t// A template naming a param its source never produces is a broken descriptor,\n\t\t\t// not a request the client can fix: skip it rather than throwing a public 500.\n\t\t\tcontinue\n\t\t}\n\t\t// path-to-regexp drops the trailing slash a wildcard consumed. Only a descriptor\n\t\t// that asks for it gets it back, because only PostHog's capture endpoints need it.\n\t\tconst keepSlash =\n\t\t\toptions.trailingSlashes === true && path.endsWith('/') && !compiled.endsWith('/')\n\t\tconst upstreamUrl = new URL(template.href)\n\t\tupstreamUrl.pathname = compiled === '' ? '/' : `${compiled}${keepSlash ? '/' : ''}`\n\t\treturn { upstreamUrl, kind: route.kind }\n\t}\n\treturn null\n}\n\n/**\n * The allowlist plus a descriptor's extras, and `X-Forwarded-For` from the resolved client IP so\n * vendor geo stays right; an absent IP sends no header rather than a fabricated one.\n */\nexport const buildUpstreamHeaders = (\n\tincoming: Headers,\n\tclientIp: string | null,\n\textra: string[] = []\n): Headers => {\n\tconst out = new Headers()\n\tconst names = [...FORWARDED_REQUEST_HEADERS, ...extra.map((name) => name.toLowerCase())]\n\tfor (const name of names) {\n\t\tif (NEVER_FORWARDED_REQUEST_HEADERS.has(name)) {\n\t\t\tcontinue\n\t\t}\n\t\tconst value = incoming.get(name)\n\t\tif (value !== null) {\n\t\t\tout.set(name, value)\n\t\t}\n\t}\n\tif (clientIp) {\n\t\tout.set('x-forwarded-for', clientIp)\n\t}\n\treturn out\n}\n\n/** A JSON or plain-text type as the vendor wrote it; anything else, or nothing, as plain text. */\nconst dataContentType = (value: string | null): string => {\n\tconst media = value?.split(';')[0]?.trim().toLowerCase()\n\treturn value !== null && media !== undefined && DATA_CONTENT_TYPES.has(media)\n\t\t? value\n\t\t: DATA_FALLBACK_CONTENT_TYPE\n}\n\n/**\n * The response allowlist (so `set-cookie` never passes) and a content type the route's kind decides.\n * A data route is sandboxed and uncached, so an upstream answering HTML cannot put a page on the site.\n */\nexport const buildDownstreamHeaders = (upstream: Headers, kind: ProxyRouteKind): Headers => {\n\tconst out = new Headers()\n\tfor (const name of FORWARDED_RESPONSE_HEADERS) {\n\t\tif (kind === 'data' && SCRIPT_ONLY_RESPONSE_HEADERS.has(name)) {\n\t\t\tcontinue\n\t\t}\n\t\tconst value = upstream.get(name)\n\t\tif (value !== null) {\n\t\t\tout.set(name, value)\n\t\t}\n\t}\n\tout.set('x-content-type-options', 'nosniff')\n\tif (kind === 'script') {\n\t\tout.set('content-type', SCRIPT_CONTENT_TYPE)\n\t} else {\n\t\tout.set('content-type', dataContentType(upstream.get('content-type')))\n\t\tout.set('cache-control', DATA_CACHE_CONTROL)\n\t\tout.set('content-security-policy', DATA_CONTENT_SECURITY_POLICY)\n\t}\n\treturn out\n}\n"],"mappings":";;;;AAKA,MAAa,4BAA4B;CACxC;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AACD;;;;;AAMA,MAAM,kCAAkC,IAAI,IAAI;CAC/C;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA,GAAG;AACJ,CAAC;;;;;AAMD,MAAM,6BAA6B;CAAC;CAAiB;CAAQ;CAAiB;AAAM;;;;;AAMpF,MAAM,+BAAoD,IAAI,IAAI;CACjE;CACA;CACA;AACD,CAAC;;AAGD,MAAa,qBAAqB;;AAGlC,MAAa,sBAAsB;;AAGnC,MAAa,6BAA6B;;AAG1C,MAAa,+BAA+B;AAE5C,MAAM,qBAA0C,IAAI,IAAI,CAAC,oBAAoB,YAAY,CAAC;AAY1F,MAAM,kBAAkB,QAAsB,IAAI,aAAa,YAAY,IAAI,aAAa;AAI5F,MAAM,oBAAoB;AAE1B,MAAM,iBAAiB,YACtB,mBAAmB,OAAO,EAAE,QAAQ,oBAAoB,GAAG,QAC1D,OAAO,aAAa,OAAO,SAAS,KAAK,EAAE,CAAC,CAC7C;AAED,MAAM,iBAAiB,UACtB,MAAM,QAAQ,KAAK,IAAI,MAAM,IAAI,MAAM,IAAI,OAAO,UAAU,WAAW,CAAC,KAAK,IAAI,CAAC;;;;;AAMnF,MAAM,gBAAgB,WACrB,OAAO,OAAO,MAAM,EAClB,QAAQ,aAAa,EACrB,MACC,YACA,YAAY,OAAO,YAAY,QAAQ,QAAQ,SAAS,GAAG,KAAK,QAAQ,SAAS,IAAI,CACvF;;;;;AAMF,MAAa,mBACZ,QACA,MACA,UAAkC,CAAC,MACZ;CACvB,KAAK,MAAM,SAAS,QAAQ;EAC3B,IAAI;EACJ,IAAI;GACH,WAAW,IAAI,IAAI,MAAM,QAAQ;EAClC,QAAQ;GACP;EACD;EACA,IAAI,CAAC,eAAe,QAAQ,GAC3B;EAED,MAAM,UAAU,MAA+B,MAAM,QAAQ,EAAE,QAAQ,mBAAmB,CAAC,EAC1F,IACD;EACA,IAAI,CAAC,SACJ;EAED,MAAM,EAAE,WAAW;EACnB,IAAI,aAAa,MAAM,GACtB,OAAO;EAER,IAAI;EACJ,IAAI;GACH,WAAW,QAAQ,SAAS,UAAU,EAAE,QAAQ,cAAc,CAAC,EAAE,MAAM;EACxE,QAAQ;GAGP;EACD;EAGA,MAAM,YACL,QAAQ,oBAAoB,QAAQ,KAAK,SAAS,GAAG,KAAK,CAAC,SAAS,SAAS,GAAG;EACjF,MAAM,cAAc,IAAI,IAAI,SAAS,IAAI;EACzC,YAAY,WAAW,aAAa,KAAK,MAAM,GAAG,WAAW,YAAY,MAAM;EAC/E,OAAO;GAAE;GAAa,MAAM,MAAM;EAAK;CACxC;CACA,OAAO;AACR;;;;;AAMA,MAAa,wBACZ,UACA,UACA,QAAkB,CAAC,MACN;CACb,MAAM,MAAM,IAAI,QAAQ;CACxB,MAAM,QAAQ,CAAC,GAAG,2BAA2B,GAAG,MAAM,KAAK,SAAS,KAAK,YAAY,CAAC,CAAC;CACvF,KAAK,MAAM,QAAQ,OAAO;EACzB,IAAI,gCAAgC,IAAI,IAAI,GAC3C;EAED,MAAM,QAAQ,SAAS,IAAI,IAAI;EAC/B,IAAI,UAAU,MACb,IAAI,IAAI,MAAM,KAAK;CAErB;CACA,IAAI,UACH,IAAI,IAAI,mBAAmB,QAAQ;CAEpC,OAAO;AACR;;AAGA,MAAM,mBAAmB,UAAiC;CACzD,MAAM,QAAQ,OAAO,MAAM,GAAG,EAAE,IAAI,KAAK,EAAE,YAAY;CACvD,OAAO,UAAU,QAAQ,UAAU,KAAA,KAAa,mBAAmB,IAAI,KAAK,IACzE,QACA;AACJ;;;;;AAMA,MAAa,0BAA0B,UAAmB,SAAkC;CAC3F,MAAM,MAAM,IAAI,QAAQ;CACxB,KAAK,MAAM,QAAQ,4BAA4B;EAC9C,IAAI,SAAS,UAAU,6BAA6B,IAAI,IAAI,GAC3D;EAED,MAAM,QAAQ,SAAS,IAAI,IAAI;EAC/B,IAAI,UAAU,MACb,IAAI,IAAI,MAAM,KAAK;CAErB;CACA,IAAI,IAAI,0BAA0B,SAAS;CAC3C,IAAI,SAAS,UACZ,IAAI,IAAI,gBAAgB,mBAAmB;MACrC;EACN,IAAI,IAAI,gBAAgB,gBAAgB,SAAS,IAAI,cAAc,CAAC,CAAC;EACrE,IAAI,IAAI,iBAAiB,kBAAkB;EAC3C,IAAI,IAAI,2BAA2B,4BAA4B;CAChE;CACA,OAAO;AACR"}
@@ -0,0 +1,91 @@
1
+ import { clientIpFromHeaders } from "../native/ingest/clientIp.js";
2
+ import { buildDownstreamHeaders, buildUpstreamHeaders, matchProxyRoute } from "./proxyRoutes.js";
3
+ import { readCappedBody } from "./requestBody.js";
4
+ //#region src/capture/relay.ts
5
+ /** Deadline for the upstream response headers, not for the body download. */
6
+ const DEFAULT_PROXY_TIMEOUT_MS = 1e4;
7
+ /** PostHog batches carrying session-replay data routinely exceed 64 KB. */
8
+ const DEFAULT_PROXY_MAX_BODY_BYTES = 1024 * 1024;
9
+ const ALLOWED_METHODS = "GET, POST, OPTIONS";
10
+ const SERVED_METHODS = new Set([
11
+ "GET",
12
+ "POST",
13
+ "OPTIONS"
14
+ ]);
15
+ /** A script route only ever serves the vendor's bundle: nothing is posted to it. */
16
+ const SCRIPT_METHODS = "GET, OPTIONS";
17
+ /**
18
+ * A relay's only error answer, and no error envelope: it relays a vendor SDK's own traffic, and that
19
+ * SDK, not admin code, reads the answer.
20
+ */
21
+ const emptyResponse = (status, headers = {}) => new Response(null, {
22
+ status,
23
+ headers: {
24
+ ...headers,
25
+ "x-content-type-options": "nosniff"
26
+ }
27
+ });
28
+ /**
29
+ * The answer to an upper-case method a relay never forwards: 405 for one it does not serve, 204 for a
30
+ * preflight. Null for GET and POST. The tracker is same-origin, so a preflight never reaches a real
31
+ * deployment, and answering it locally beats forwarding one and stripping the CORS headers it asks for.
32
+ */
33
+ const unforwardedMethodResponse = (method) => {
34
+ if (!SERVED_METHODS.has(method)) return emptyResponse(405, { allow: ALLOWED_METHODS });
35
+ return method === "OPTIONS" ? emptyResponse(204, { allow: ALLOWED_METHODS }) : null;
36
+ };
37
+ /**
38
+ * The path below `mount` in `pathname`, still percent-encoded (re-encoding would escape legal
39
+ * characters the vendor never sent). Found anywhere, so a basePath before the mount is kept; null
40
+ * when `pathname` does not pass through the mount.
41
+ */
42
+ const pathBelowMount = (pathname, mount) => {
43
+ const at = `${pathname}/`.indexOf(`${mount}/`);
44
+ return at === -1 ? null : pathname.slice(at + mount.length) || "/";
45
+ };
46
+ /**
47
+ * Relays one request to the vendor URL its path compiles to under the descriptor's routes. Cookies
48
+ * and credentials never go upstream, and `set-cookie` never comes back.
49
+ */
50
+ const relayToVendor = async (request, options) => {
51
+ const { descriptor } = options;
52
+ const matched = matchProxyRoute(descriptor.routes, request.path, { trailingSlashes: descriptor.trailingSlashes });
53
+ if (!matched) return emptyResponse(404);
54
+ if (request.method === "POST" && matched.kind === "script") return emptyResponse(405, { allow: SCRIPT_METHODS });
55
+ const { upstreamUrl } = matched;
56
+ if (request.search && request.search !== "?") {
57
+ const incoming = request.search.startsWith("?") ? request.search.slice(1) : request.search;
58
+ upstreamUrl.search = upstreamUrl.search ? `${upstreamUrl.search}&${incoming}` : `?${incoming}`;
59
+ }
60
+ let body;
61
+ if (request.method === "POST") {
62
+ const read = await readCappedBody(request.body, options.maxBodyBytes);
63
+ if (!read.ok) return emptyResponse(read.reason === "too-large" ? 413 : 400);
64
+ body = read.body;
65
+ }
66
+ const controller = new AbortController();
67
+ const timer = setTimeout(() => controller.abort(), options.timeoutMs);
68
+ const send = descriptor.fetch ?? fetch;
69
+ try {
70
+ const upstream = await send(upstreamUrl, {
71
+ method: request.method,
72
+ headers: buildUpstreamHeaders(request.headers, clientIpFromHeaders(request.headers, options.trust), descriptor.forwardHeaders ?? []),
73
+ body,
74
+ redirect: "manual",
75
+ signal: controller.signal
76
+ });
77
+ return new Response(upstream.body, {
78
+ status: upstream.status,
79
+ headers: buildDownstreamHeaders(upstream.headers, matched.kind)
80
+ });
81
+ } catch (err) {
82
+ options.warn(String(err));
83
+ return emptyResponse(502);
84
+ } finally {
85
+ clearTimeout(timer);
86
+ }
87
+ };
88
+ //#endregion
89
+ export { DEFAULT_PROXY_MAX_BODY_BYTES, DEFAULT_PROXY_TIMEOUT_MS, emptyResponse, pathBelowMount, relayToVendor, unforwardedMethodResponse };
90
+
91
+ //# sourceMappingURL=relay.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"relay.js","names":[],"sources":["../../src/capture/relay.ts"],"sourcesContent":["import type { ProxyDescriptor } from '../core/capture'\nimport type { FetchLike } from '../core/fetch'\nimport { type ClientIpOptions, clientIpFromHeaders } from '../native/ingest/clientIp'\nimport { buildDownstreamHeaders, buildUpstreamHeaders, matchProxyRoute } from './proxyRoutes'\nimport { type CappedBodySource, readCappedBody } from './requestBody'\n\n/** Deadline for the upstream response headers, not for the body download. */\nexport const DEFAULT_PROXY_TIMEOUT_MS = 10_000\n\n/** PostHog batches carrying session-replay data routinely exceed 64 KB. */\nexport const DEFAULT_PROXY_MAX_BODY_BYTES = 1024 * 1024\n\nconst ALLOWED_METHODS = 'GET, POST, OPTIONS'\n\nconst SERVED_METHODS: ReadonlySet<string> = new Set(['GET', 'POST', 'OPTIONS'])\n\n/** A script route only ever serves the vendor's bundle: nothing is posted to it. */\nconst SCRIPT_METHODS = 'GET, OPTIONS'\n\n/**\n * A relay's only error answer, and no error envelope: it relays a vendor SDK's own traffic, and that\n * SDK, not admin code, reads the answer.\n */\nexport const emptyResponse = (status: number, headers: Record<string, string> = {}): Response =>\n\tnew Response(null, { status, headers: { ...headers, 'x-content-type-options': 'nosniff' } })\n\n/**\n * The answer to an upper-case method a relay never forwards: 405 for one it does not serve, 204 for a\n * preflight. Null for GET and POST. The tracker is same-origin, so a preflight never reaches a real\n * deployment, and answering it locally beats forwarding one and stripping the CORS headers it asks for.\n */\nexport const unforwardedMethodResponse = (method: string): Response | null => {\n\tif (!SERVED_METHODS.has(method)) {\n\t\treturn emptyResponse(405, { allow: ALLOWED_METHODS })\n\t}\n\treturn method === 'OPTIONS' ? emptyResponse(204, { allow: ALLOWED_METHODS }) : null\n}\n\n/**\n * The path below `mount` in `pathname`, still percent-encoded (re-encoding would escape legal\n * characters the vendor never sent). Found anywhere, so a basePath before the mount is kept; null\n * when `pathname` does not pass through the mount.\n */\nexport const pathBelowMount = (pathname: string, mount: string): string | null => {\n\tconst at = `${pathname}/`.indexOf(`${mount}/`)\n\treturn at === -1 ? null : pathname.slice(at + mount.length) || '/'\n}\n\n/** One request to relay, as either relay reads it. */\nexport interface RelayRequest {\n\t/** Upper case. */\n\tmethod: string\n\theaders: Headers\n\t/** Below the relay's mount, still percent-encoded: the route templates decode it per segment. */\n\tpath: string\n\t/** With or without its leading `?`; empty for none. */\n\tsearch: string\n\tbody: CappedBodySource\n}\n\nexport interface RelayOptions {\n\tdescriptor: ProxyDescriptor\n\ttimeoutMs: number\n\tmaxBodyBytes: number\n\ttrust: ClientIpOptions\n\t/** Told why an upstream failed, which the answer never says. */\n\twarn: (message: string) => void\n}\n\n/**\n * Relays one request to the vendor URL its path compiles to under the descriptor's routes. Cookies\n * and credentials never go upstream, and `set-cookie` never comes back.\n */\nexport const relayToVendor = async (\n\trequest: RelayRequest,\n\toptions: RelayOptions\n): Promise<Response> => {\n\tconst { descriptor } = options\n\tconst matched = matchProxyRoute(descriptor.routes, request.path, {\n\t\ttrailingSlashes: descriptor.trailingSlashes,\n\t})\n\tif (!matched) {\n\t\treturn emptyResponse(404)\n\t}\n\tif (request.method === 'POST' && matched.kind === 'script') {\n\t\treturn emptyResponse(405, { allow: SCRIPT_METHODS })\n\t}\n\tconst { upstreamUrl } = matched\n\tif (request.search && request.search !== '?') {\n\t\tconst incoming = request.search.startsWith('?') ? request.search.slice(1) : request.search\n\t\tupstreamUrl.search = upstreamUrl.search ? `${upstreamUrl.search}&${incoming}` : `?${incoming}`\n\t}\n\t// Buffered rather than streamed: a duplex request stream fails as a hung upstream\n\t// connection, and the cap has to be enforced before any of it is forwarded anyway.\n\tlet body: ArrayBuffer | undefined\n\tif (request.method === 'POST') {\n\t\tconst read = await readCappedBody(request.body, options.maxBodyBytes)\n\t\tif (!read.ok) {\n\t\t\treturn emptyResponse(read.reason === 'too-large' ? 413 : 400)\n\t\t}\n\t\tbody = read.body\n\t}\n\t// The deadline covers time-to-headers only. AbortSignal.timeout would keep running\n\t// against the body stream and truncate a slow but healthy download.\n\tconst controller = new AbortController()\n\tconst timer = setTimeout(() => controller.abort(), options.timeoutMs)\n\tconst send: FetchLike = descriptor.fetch ?? fetch\n\ttry {\n\t\tconst upstream = await send(upstreamUrl, {\n\t\t\tmethod: request.method,\n\t\t\theaders: buildUpstreamHeaders(\n\t\t\t\trequest.headers,\n\t\t\t\tclientIpFromHeaders(request.headers, options.trust),\n\t\t\t\tdescriptor.forwardHeaders ?? []\n\t\t\t),\n\t\t\tbody,\n\t\t\tredirect: 'manual',\n\t\t\tsignal: controller.signal,\n\t\t})\n\t\treturn new Response(upstream.body, {\n\t\t\tstatus: upstream.status,\n\t\t\theaders: buildDownstreamHeaders(upstream.headers, matched.kind),\n\t\t})\n\t} catch (err) {\n\t\toptions.warn(String(err))\n\t\treturn emptyResponse(502)\n\t} finally {\n\t\tclearTimeout(timer)\n\t}\n}\n"],"mappings":";;;;;AAOA,MAAa,2BAA2B;;AAGxC,MAAa,+BAA+B,OAAO;AAEnD,MAAM,kBAAkB;AAExB,MAAM,iBAAsC,IAAI,IAAI;CAAC;CAAO;CAAQ;AAAS,CAAC;;AAG9E,MAAM,iBAAiB;;;;;AAMvB,MAAa,iBAAiB,QAAgB,UAAkC,CAAC,MAChF,IAAI,SAAS,MAAM;CAAE;CAAQ,SAAS;EAAE,GAAG;EAAS,0BAA0B;CAAU;AAAE,CAAC;;;;;;AAO5F,MAAa,6BAA6B,WAAoC;CAC7E,IAAI,CAAC,eAAe,IAAI,MAAM,GAC7B,OAAO,cAAc,KAAK,EAAE,OAAO,gBAAgB,CAAC;CAErD,OAAO,WAAW,YAAY,cAAc,KAAK,EAAE,OAAO,gBAAgB,CAAC,IAAI;AAChF;;;;;;AAOA,MAAa,kBAAkB,UAAkB,UAAiC;CACjF,MAAM,KAAK,GAAG,SAAS,GAAG,QAAQ,GAAG,MAAM,EAAE;CAC7C,OAAO,OAAO,KAAK,OAAO,SAAS,MAAM,KAAK,MAAM,MAAM,KAAK;AAChE;;;;;AA2BA,MAAa,gBAAgB,OAC5B,SACA,YACuB;CACvB,MAAM,EAAE,eAAe;CACvB,MAAM,UAAU,gBAAgB,WAAW,QAAQ,QAAQ,MAAM,EAChE,iBAAiB,WAAW,gBAC7B,CAAC;CACD,IAAI,CAAC,SACJ,OAAO,cAAc,GAAG;CAEzB,IAAI,QAAQ,WAAW,UAAU,QAAQ,SAAS,UACjD,OAAO,cAAc,KAAK,EAAE,OAAO,eAAe,CAAC;CAEpD,MAAM,EAAE,gBAAgB;CACxB,IAAI,QAAQ,UAAU,QAAQ,WAAW,KAAK;EAC7C,MAAM,WAAW,QAAQ,OAAO,WAAW,GAAG,IAAI,QAAQ,OAAO,MAAM,CAAC,IAAI,QAAQ;EACpF,YAAY,SAAS,YAAY,SAAS,GAAG,YAAY,OAAO,GAAG,aAAa,IAAI;CACrF;CAGA,IAAI;CACJ,IAAI,QAAQ,WAAW,QAAQ;EAC9B,MAAM,OAAO,MAAM,eAAe,QAAQ,MAAM,QAAQ,YAAY;EACpE,IAAI,CAAC,KAAK,IACT,OAAO,cAAc,KAAK,WAAW,cAAc,MAAM,GAAG;EAE7D,OAAO,KAAK;CACb;CAGA,MAAM,aAAa,IAAI,gBAAgB;CACvC,MAAM,QAAQ,iBAAiB,WAAW,MAAM,GAAG,QAAQ,SAAS;CACpE,MAAM,OAAkB,WAAW,SAAS;CAC5C,IAAI;EACH,MAAM,WAAW,MAAM,KAAK,aAAa;GACxC,QAAQ,QAAQ;GAChB,SAAS,qBACR,QAAQ,SACR,oBAAoB,QAAQ,SAAS,QAAQ,KAAK,GAClD,WAAW,kBAAkB,CAAC,CAC/B;GACA;GACA,UAAU;GACV,QAAQ,WAAW;EACpB,CAAC;EACD,OAAO,IAAI,SAAS,SAAS,MAAM;GAClC,QAAQ,SAAS;GACjB,SAAS,uBAAuB,SAAS,SAAS,QAAQ,IAAI;EAC/D,CAAC;CACF,SAAS,KAAK;EACb,QAAQ,KAAK,OAAO,GAAG,CAAC;EACxB,OAAO,cAAc,GAAG;CACzB,UAAU;EACT,aAAa,KAAK;CACnB;AACD"}
@@ -17,12 +17,8 @@ const concat = (chunks, total) => {
17
17
  return out.buffer;
18
18
  };
19
19
  /**
20
- * Buffers a request body, refusing anything over `maxBytes`. A declared `content-length`
21
- * short-circuits before a byte is read; a chunked body declares no length at all, so the
22
- * running total is checked per chunk and the read is cancelled the moment it passes the
23
- * cap. A stream that errors mid-read (a beacon from a tab that is already unloading is
24
- * routine, not exceptional) resolves as `unreadable` rather than throwing, which would
25
- * escape the handler into Payload's routeError as a 500.
20
+ * Buffers a request body, cancelling the read once it passes `maxBytes` (chunked bodies declare no
21
+ * length). A stream erroring mid-read, routine for an unloading tab, resolves `unreadable`, never a 500.
26
22
  */
27
23
  const readCappedBody = async (req, maxBytes) => {
28
24
  const declared = req.headers.get("content-length");
@@ -1 +1 @@
1
- {"version":3,"file":"requestBody.js","names":[],"sources":["../../src/capture/requestBody.ts"],"sourcesContent":["/** The subset of a Request the capped reader needs, so a PayloadRequest satisfies it. */\nexport interface CappedBodySource {\n\theaders: Headers\n\tbody?: ReadableStream<Uint8Array> | null\n\tarrayBuffer?: () => Promise<ArrayBuffer>\n}\n\n/**\n * `too-large` is the caller's 413; `unreadable` is its 400. They are distinct because a\n * body that died in transit is the client's problem to retry, not a limit it exceeded.\n */\nexport type CappedBodyResult =\n\t| { ok: true; body: ArrayBuffer }\n\t| { ok: false; reason: 'too-large' | 'unreadable' }\n\nconst tooLarge = { ok: false, reason: 'too-large' } as const\nconst unreadable = { ok: false, reason: 'unreadable' } as const\n\nconst concat = (chunks: Uint8Array[], total: number): ArrayBuffer => {\n\tconst out = new Uint8Array(total)\n\tlet offset = 0\n\tfor (const chunk of chunks) {\n\t\tout.set(chunk, offset)\n\t\toffset += chunk.byteLength\n\t}\n\treturn out.buffer\n}\n\n/**\n * Buffers a request body, refusing anything over `maxBytes`. A declared `content-length`\n * short-circuits before a byte is read; a chunked body declares no length at all, so the\n * running total is checked per chunk and the read is cancelled the moment it passes the\n * cap. A stream that errors mid-read (a beacon from a tab that is already unloading is\n * routine, not exceptional) resolves as `unreadable` rather than throwing, which would\n * escape the handler into Payload's routeError as a 500.\n */\nexport const readCappedBody = async (\n\treq: CappedBodySource,\n\tmaxBytes: number\n): Promise<CappedBodyResult> => {\n\tconst declared = req.headers.get('content-length')\n\tif (declared !== null) {\n\t\tconst length = Number(declared)\n\t\tif (Number.isFinite(length) && length > maxBytes) {\n\t\t\treturn tooLarge\n\t\t}\n\t}\n\tconst stream = req.body\n\tif (!stream) {\n\t\ttry {\n\t\t\tconst buffered = (await req.arrayBuffer?.()) ?? new ArrayBuffer(0)\n\t\t\treturn buffered.byteLength > maxBytes ? tooLarge : { ok: true, body: buffered }\n\t\t} catch {\n\t\t\treturn unreadable\n\t\t}\n\t}\n\tconst reader = stream.getReader()\n\tconst chunks: Uint8Array[] = []\n\tlet total = 0\n\ttry {\n\t\twhile (true) {\n\t\t\tconst { done, value } = await reader.read()\n\t\t\tif (done) {\n\t\t\t\tbreak\n\t\t\t}\n\t\t\ttotal += value.byteLength\n\t\t\tif (total > maxBytes) {\n\t\t\t\tawait reader.cancel()\n\t\t\t\treturn tooLarge\n\t\t\t}\n\t\t\tchunks.push(value)\n\t\t}\n\t} catch {\n\t\treturn unreadable\n\t}\n\treturn { ok: true, body: concat(chunks, total) }\n}\n"],"mappings":";AAeA,MAAM,WAAW;CAAE,IAAI;CAAO,QAAQ;AAAY;AAClD,MAAM,aAAa;CAAE,IAAI;CAAO,QAAQ;AAAa;AAErD,MAAM,UAAU,QAAsB,UAA+B;CACpE,MAAM,MAAM,IAAI,WAAW,KAAK;CAChC,IAAI,SAAS;CACb,KAAK,MAAM,SAAS,QAAQ;EAC3B,IAAI,IAAI,OAAO,MAAM;EACrB,UAAU,MAAM;CACjB;CACA,OAAO,IAAI;AACZ;;;;;;;;;AAUA,MAAa,iBAAiB,OAC7B,KACA,aAC+B;CAC/B,MAAM,WAAW,IAAI,QAAQ,IAAI,gBAAgB;CACjD,IAAI,aAAa,MAAM;EACtB,MAAM,SAAS,OAAO,QAAQ;EAC9B,IAAI,OAAO,SAAS,MAAM,KAAK,SAAS,UACvC,OAAO;CAET;CACA,MAAM,SAAS,IAAI;CACnB,IAAI,CAAC,QACJ,IAAI;EACH,MAAM,WAAY,MAAM,IAAI,cAAc,qBAAM,IAAI,YAAY,CAAC;EACjE,OAAO,SAAS,aAAa,WAAW,WAAW;GAAE,IAAI;GAAM,MAAM;EAAS;CAC/E,QAAQ;EACP,OAAO;CACR;CAED,MAAM,SAAS,OAAO,UAAU;CAChC,MAAM,SAAuB,CAAC;CAC9B,IAAI,QAAQ;CACZ,IAAI;EACH,OAAO,MAAM;GACZ,MAAM,EAAE,MAAM,UAAU,MAAM,OAAO,KAAK;GAC1C,IAAI,MACH;GAED,SAAS,MAAM;GACf,IAAI,QAAQ,UAAU;IACrB,MAAM,OAAO,OAAO;IACpB,OAAO;GACR;GACA,OAAO,KAAK,KAAK;EAClB;CACD,QAAQ;EACP,OAAO;CACR;CACA,OAAO;EAAE,IAAI;EAAM,MAAM,OAAO,QAAQ,KAAK;CAAE;AAChD"}
1
+ {"version":3,"file":"requestBody.js","names":[],"sources":["../../src/capture/requestBody.ts"],"sourcesContent":["/** The subset of a Request the capped reader needs, so a PayloadRequest satisfies it. */\nexport interface CappedBodySource {\n\theaders: Headers\n\tbody?: ReadableStream<Uint8Array> | null\n\tarrayBuffer?: () => Promise<ArrayBuffer>\n}\n\n/**\n * `too-large` is the caller's 413; `unreadable` is its 400. They are distinct because a\n * body that died in transit is the client's problem to retry, not a limit it exceeded.\n */\nexport type CappedBodyResult =\n\t| { ok: true; body: ArrayBuffer }\n\t| { ok: false; reason: 'too-large' | 'unreadable' }\n\nconst tooLarge = { ok: false, reason: 'too-large' } as const\nconst unreadable = { ok: false, reason: 'unreadable' } as const\n\nconst concat = (chunks: Uint8Array[], total: number): ArrayBuffer => {\n\tconst out = new Uint8Array(total)\n\tlet offset = 0\n\tfor (const chunk of chunks) {\n\t\tout.set(chunk, offset)\n\t\toffset += chunk.byteLength\n\t}\n\treturn out.buffer\n}\n\n/**\n * Buffers a request body, cancelling the read once it passes `maxBytes` (chunked bodies declare no\n * length). A stream erroring mid-read, routine for an unloading tab, resolves `unreadable`, never a 500.\n */\nexport const readCappedBody = async (\n\treq: CappedBodySource,\n\tmaxBytes: number\n): Promise<CappedBodyResult> => {\n\tconst declared = req.headers.get('content-length')\n\tif (declared !== null) {\n\t\tconst length = Number(declared)\n\t\tif (Number.isFinite(length) && length > maxBytes) {\n\t\t\treturn tooLarge\n\t\t}\n\t}\n\tconst stream = req.body\n\tif (!stream) {\n\t\ttry {\n\t\t\tconst buffered = (await req.arrayBuffer?.()) ?? new ArrayBuffer(0)\n\t\t\treturn buffered.byteLength > maxBytes ? tooLarge : { ok: true, body: buffered }\n\t\t} catch {\n\t\t\treturn unreadable\n\t\t}\n\t}\n\tconst reader = stream.getReader()\n\tconst chunks: Uint8Array[] = []\n\tlet total = 0\n\ttry {\n\t\twhile (true) {\n\t\t\tconst { done, value } = await reader.read()\n\t\t\tif (done) {\n\t\t\t\tbreak\n\t\t\t}\n\t\t\ttotal += value.byteLength\n\t\t\tif (total > maxBytes) {\n\t\t\t\tawait reader.cancel()\n\t\t\t\treturn tooLarge\n\t\t\t}\n\t\t\tchunks.push(value)\n\t\t}\n\t} catch {\n\t\treturn unreadable\n\t}\n\treturn { ok: true, body: concat(chunks, total) }\n}\n"],"mappings":";AAeA,MAAM,WAAW;CAAE,IAAI;CAAO,QAAQ;AAAY;AAClD,MAAM,aAAa;CAAE,IAAI;CAAO,QAAQ;AAAa;AAErD,MAAM,UAAU,QAAsB,UAA+B;CACpE,MAAM,MAAM,IAAI,WAAW,KAAK;CAChC,IAAI,SAAS;CACb,KAAK,MAAM,SAAS,QAAQ;EAC3B,IAAI,IAAI,OAAO,MAAM;EACrB,UAAU,MAAM;CACjB;CACA,OAAO,IAAI;AACZ;;;;;AAMA,MAAa,iBAAiB,OAC7B,KACA,aAC+B;CAC/B,MAAM,WAAW,IAAI,QAAQ,IAAI,gBAAgB;CACjD,IAAI,aAAa,MAAM;EACtB,MAAM,SAAS,OAAO,QAAQ;EAC9B,IAAI,OAAO,SAAS,MAAM,KAAK,SAAS,UACvC,OAAO;CAET;CACA,MAAM,SAAS,IAAI;CACnB,IAAI,CAAC,QACJ,IAAI;EACH,MAAM,WAAY,MAAM,IAAI,cAAc,qBAAM,IAAI,YAAY,CAAC;EACjE,OAAO,SAAS,aAAa,WAAW,WAAW;GAAE,IAAI;GAAM,MAAM;EAAS;CAC/E,QAAQ;EACP,OAAO;CACR;CAED,MAAM,SAAS,OAAO,UAAU;CAChC,MAAM,SAAuB,CAAC;CAC9B,IAAI,QAAQ;CACZ,IAAI;EACH,OAAO,MAAM;GACZ,MAAM,EAAE,MAAM,UAAU,MAAM,OAAO,KAAK;GAC1C,IAAI,MACH;GAED,SAAS,MAAM;GACf,IAAI,QAAQ,UAAU;IACrB,MAAM,OAAO,OAAO;IACpB,OAAO;GACR;GACA,OAAO,KAAK,KAAK;EAClB;CACD,QAAQ;EACP,OAAO;CACR;CACA,OAAO;EAAE,IAAI;EAAM,MAAM,OAAO,QAAQ,KAAK;CAAE;AAChD"}
@@ -0,0 +1,45 @@
1
+ import { kindOf } from "../core/values.js";
2
+ import { forwardedUntrusted } from "../native/ingest/clientIp.js";
3
+ import { normalizeOrigin, parseOrigin } from "../net/origin.js";
4
+ //#region src/capture/requestTrust.ts
5
+ /** `capture.allowedOrigins` checked at boot: exact origins, compared as browsers send them. */
6
+ const resolveAllowedOrigins = (value) => {
7
+ if (value === void 0) return /* @__PURE__ */ new Set();
8
+ if (!Array.isArray(value)) throw new Error(`analytics: capture.allowedOrigins must be a list of origins such as "https://shop.example.com", got ${kindOf(value)}`);
9
+ const origins = /* @__PURE__ */ new Set();
10
+ for (const entry of value) {
11
+ const parsed = typeof entry === "string" ? parseOrigin(entry, true) : null;
12
+ if (parsed === null || "problem" in parsed) throw new Error(`analytics: capture.allowedOrigins entries must each be one exact origin, a scheme and host with an optional port and no path or wildcard, such as "https://shop.example.com", got ${kindOf(entry)}`);
13
+ origins.add(parsed.origin);
14
+ }
15
+ return origins;
16
+ };
17
+ /** The browser's `Sec-Fetch-Site` relation of the requesting page to this site, lowercased. */
18
+ const fetchSiteOf = (headers) => headers.get("sec-fetch-site")?.trim().toLowerCase();
19
+ /** The request's `Origin` as a browser writes it; null when absent or not an http(s) origin. */
20
+ const requestOrigin = (headers) => {
21
+ const origin = headers.get("origin");
22
+ return origin === null ? null : normalizeOrigin(origin);
23
+ };
24
+ /**
25
+ * Whether a capture POST came from another site's page: `Sec-Fetch-Site: cross-site` with an
26
+ * `Origin` outside `capture.allowedOrigins`. A request without the header passes, as non-browsers do.
27
+ */
28
+ const refusedCrossSite = (headers, allowed) => {
29
+ if (fetchSiteOf(headers) !== "cross-site") return false;
30
+ const origin = requestOrigin(headers);
31
+ return origin === null || !allowed?.has(origin);
32
+ };
33
+ /** The Payload instances that already said so, so a busy site hears it once. */
34
+ const warnedForwarding = /* @__PURE__ */ new WeakSet();
35
+ const UNTRUSTED_FORWARDING_WARNING = "analytics: a request came through two or more proxies (its x-forwarded-for header lists several addresses), but neither trustedProxyHops nor trustedPlatform is set, so the plugin used the first address, which the visitor can write. Set trustedProxyHops to the number of proxies in front of the app, or trustedPlatform to \"vercel\" or \"cloudflare\". Logged once.";
36
+ /** Warns once per instance about the first request whose forwarded chain nothing vouches for. */
37
+ const warnUntrustedForwarding = (payload, headers, trust) => {
38
+ if (warnedForwarding.has(payload) || !forwardedUntrusted(headers, trust)) return;
39
+ warnedForwarding.add(payload);
40
+ payload.logger?.warn(UNTRUSTED_FORWARDING_WARNING);
41
+ };
42
+ //#endregion
43
+ export { fetchSiteOf, refusedCrossSite, requestOrigin, resolveAllowedOrigins, warnUntrustedForwarding };
44
+
45
+ //# sourceMappingURL=requestTrust.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"requestTrust.js","names":[],"sources":["../../src/capture/requestTrust.ts"],"sourcesContent":["import type { Payload } from 'payload'\nimport { kindOf } from '../core/values'\nimport { type ClientIpOptions, forwardedUntrusted } from '../native/ingest/clientIp'\nimport { normalizeOrigin, parseOrigin } from '../net/origin'\n\n/** `capture.allowedOrigins` checked at boot: exact origins, compared as browsers send them. */\nexport const resolveAllowedOrigins = (value: unknown): ReadonlySet<string> => {\n\tif (value === undefined) {\n\t\treturn new Set()\n\t}\n\tif (!Array.isArray(value)) {\n\t\tthrow new Error(\n\t\t\t`analytics: capture.allowedOrigins must be a list of origins such as \"https://shop.example.com\", got ${kindOf(value)}`\n\t\t)\n\t}\n\tconst origins = new Set<string>()\n\tfor (const entry of value) {\n\t\tconst parsed = typeof entry === 'string' ? parseOrigin(entry, true) : null\n\t\tif (parsed === null || 'problem' in parsed) {\n\t\t\tthrow new Error(\n\t\t\t\t`analytics: capture.allowedOrigins entries must each be one exact origin, a scheme and host with an optional port and no path or wildcard, such as \"https://shop.example.com\", got ${kindOf(entry)}`\n\t\t\t)\n\t\t}\n\t\torigins.add(parsed.origin)\n\t}\n\treturn origins\n}\n\n/** The browser's `Sec-Fetch-Site` relation of the requesting page to this site, lowercased. */\nexport const fetchSiteOf = (headers: Headers): string | undefined =>\n\theaders.get('sec-fetch-site')?.trim().toLowerCase()\n\n/** The request's `Origin` as a browser writes it; null when absent or not an http(s) origin. */\nexport const requestOrigin = (headers: Headers): string | null => {\n\tconst origin = headers.get('origin')\n\treturn origin === null ? null : normalizeOrigin(origin)\n}\n\n/**\n * Whether a capture POST came from another site's page: `Sec-Fetch-Site: cross-site` with an\n * `Origin` outside `capture.allowedOrigins`. A request without the header passes, as non-browsers do.\n */\nexport const refusedCrossSite = (\n\theaders: Headers,\n\tallowed: ReadonlySet<string> | undefined\n): boolean => {\n\tif (fetchSiteOf(headers) !== 'cross-site') {\n\t\treturn false\n\t}\n\tconst origin = requestOrigin(headers)\n\treturn origin === null || !allowed?.has(origin)\n}\n\n/** The Payload instances that already said so, so a busy site hears it once. */\nconst warnedForwarding = new WeakSet<Payload>()\n\nexport const UNTRUSTED_FORWARDING_WARNING =\n\t'analytics: a request came through two or more proxies (its x-forwarded-for header lists several addresses), but neither trustedProxyHops nor trustedPlatform is set, so the plugin used the first address, which the visitor can write. Set trustedProxyHops to the number of proxies in front of the app, or trustedPlatform to \"vercel\" or \"cloudflare\". Logged once.'\n\n/** Warns once per instance about the first request whose forwarded chain nothing vouches for. */\nexport const warnUntrustedForwarding = (\n\tpayload: Payload,\n\theaders: Headers,\n\ttrust: ClientIpOptions\n): void => {\n\tif (warnedForwarding.has(payload) || !forwardedUntrusted(headers, trust)) {\n\t\treturn\n\t}\n\twarnedForwarding.add(payload)\n\tpayload.logger?.warn(UNTRUSTED_FORWARDING_WARNING)\n}\n"],"mappings":";;;;;AAMA,MAAa,yBAAyB,UAAwC;CAC7E,IAAI,UAAU,KAAA,GACb,uBAAO,IAAI,IAAI;CAEhB,IAAI,CAAC,MAAM,QAAQ,KAAK,GACvB,MAAM,IAAI,MACT,uGAAuG,OAAO,KAAK,GACpH;CAED,MAAM,0BAAU,IAAI,IAAY;CAChC,KAAK,MAAM,SAAS,OAAO;EAC1B,MAAM,SAAS,OAAO,UAAU,WAAW,YAAY,OAAO,IAAI,IAAI;EACtE,IAAI,WAAW,QAAQ,aAAa,QACnC,MAAM,IAAI,MACT,qLAAqL,OAAO,KAAK,GAClM;EAED,QAAQ,IAAI,OAAO,MAAM;CAC1B;CACA,OAAO;AACR;;AAGA,MAAa,eAAe,YAC3B,QAAQ,IAAI,gBAAgB,GAAG,KAAK,EAAE,YAAY;;AAGnD,MAAa,iBAAiB,YAAoC;CACjE,MAAM,SAAS,QAAQ,IAAI,QAAQ;CACnC,OAAO,WAAW,OAAO,OAAO,gBAAgB,MAAM;AACvD;;;;;AAMA,MAAa,oBACZ,SACA,YACa;CACb,IAAI,YAAY,OAAO,MAAM,cAC5B,OAAO;CAER,MAAM,SAAS,cAAc,OAAO;CACpC,OAAO,WAAW,QAAQ,CAAC,SAAS,IAAI,MAAM;AAC/C;;AAGA,MAAM,mCAAmB,IAAI,QAAiB;AAE9C,MAAa,+BACZ;;AAGD,MAAa,2BACZ,SACA,SACA,UACU;CACV,IAAI,iBAAiB,IAAI,OAAO,KAAK,CAAC,mBAAmB,SAAS,KAAK,GACtE;CAED,iBAAiB,IAAI,OAAO;CAC5B,QAAQ,QAAQ,KAAK,4BAA4B;AAClD"}