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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (1259) hide show
  1. package/CHANGELOG.md +530 -0
  2. package/README.md +30 -37
  3. package/dist/access/adminUser.d.ts +15 -0
  4. package/dist/access/adminUser.js +13 -0
  5. package/dist/access/adminUser.js.map +1 -0
  6. package/dist/access/decideOnce.js +16 -0
  7. package/dist/access/decideOnce.js.map +1 -0
  8. package/dist/access/membership.d.ts +23 -0
  9. package/dist/access/membership.js +63 -0
  10. package/dist/access/membership.js.map +1 -0
  11. package/dist/access/principal.d.ts +37 -0
  12. package/dist/access/principal.js +29 -0
  13. package/dist/access/principal.js.map +1 -0
  14. package/dist/access/readGate.js +16 -0
  15. package/dist/access/readGate.js.map +1 -0
  16. package/dist/adapters/ga4/disableKey.js +7 -9
  17. package/dist/adapters/ga4/disableKey.js.map +1 -1
  18. package/dist/adapters/ga4/eventName.d.ts +2 -8
  19. package/dist/adapters/ga4/eventName.js +2 -8
  20. package/dist/adapters/ga4/eventName.js.map +1 -1
  21. package/dist/adapters/ga4/ga4.d.ts +17 -0
  22. package/dist/adapters/ga4/ga4.js +208 -124
  23. package/dist/adapters/ga4/ga4.js.map +1 -1
  24. package/dist/adapters/ga4/measurementId.js +2 -3
  25. package/dist/adapters/ga4/measurementId.js.map +1 -1
  26. package/dist/adapters/goalRead.js +15 -29
  27. package/dist/adapters/goalRead.js.map +1 -1
  28. package/dist/adapters/http/baseUrl.js +15 -0
  29. package/dist/adapters/http/baseUrl.js.map +1 -0
  30. package/dist/adapters/http/fetchJson.d.ts +19 -0
  31. package/dist/adapters/http/fetchJson.js +27 -8
  32. package/dist/adapters/http/fetchJson.js.map +1 -1
  33. package/dist/adapters/mapping.js +52 -0
  34. package/dist/adapters/mapping.js.map +1 -0
  35. package/dist/adapters/plausible/plausible.d.ts +19 -13
  36. package/dist/adapters/plausible/plausible.js +139 -123
  37. package/dist/adapters/plausible/plausible.js.map +1 -1
  38. package/dist/adapters/plausible/scriptId.js +19 -0
  39. package/dist/adapters/plausible/scriptId.js.map +1 -0
  40. package/dist/adapters/posthog/posthog.d.ts +26 -9
  41. package/dist/adapters/posthog/posthog.js +194 -115
  42. package/dist/adapters/posthog/posthog.js.map +1 -1
  43. package/dist/adapters/readTime.js +7 -0
  44. package/dist/adapters/readTime.js.map +1 -0
  45. package/dist/adapters/series.js +14 -8
  46. package/dist/adapters/series.js.map +1 -1
  47. package/dist/adapters/umami/umami.d.ts +13 -9
  48. package/dist/adapters/umami/umami.js +186 -173
  49. package/dist/adapters/umami/umami.js.map +1 -1
  50. package/dist/adapters/upstream.js +16 -0
  51. package/dist/adapters/upstream.js.map +1 -0
  52. package/dist/binding/report.d.ts +8 -0
  53. package/dist/binding/report.js +24 -0
  54. package/dist/binding/report.js.map +1 -0
  55. package/dist/binding/resolvePath.js +16 -29
  56. package/dist/binding/resolvePath.js.map +1 -1
  57. package/dist/binding/types.d.ts +14 -29
  58. package/dist/capture/captureRequest.js +28 -0
  59. package/dist/capture/captureRequest.js.map +1 -0
  60. package/dist/capture/exclusionEndpoint.js +98 -0
  61. package/dist/capture/exclusionEndpoint.js.map +1 -0
  62. package/dist/capture/exclusionPrelude.js +14 -0
  63. package/dist/capture/exclusionPrelude.js.map +1 -0
  64. package/dist/capture/exclusionToken.js +23 -0
  65. package/dist/capture/exclusionToken.js.map +1 -0
  66. package/dist/capture/jsLiteral.js +19 -0
  67. package/dist/capture/jsLiteral.js.map +1 -0
  68. package/dist/capture/mountPath.js +2 -3
  69. package/dist/capture/mountPath.js.map +1 -1
  70. package/dist/capture/proxyEndpoint.js +48 -95
  71. package/dist/capture/proxyEndpoint.js.map +1 -1
  72. package/dist/capture/proxyRoutes.js +58 -21
  73. package/dist/capture/proxyRoutes.js.map +1 -1
  74. package/dist/capture/relay.js +91 -0
  75. package/dist/capture/relay.js.map +1 -0
  76. package/dist/capture/requestBody.js +2 -6
  77. package/dist/capture/requestBody.js.map +1 -1
  78. package/dist/capture/requestTrust.js +45 -0
  79. package/dist/capture/requestTrust.js.map +1 -0
  80. package/dist/capture/sameSite.js +40 -0
  81. package/dist/capture/sameSite.js.map +1 -0
  82. package/dist/capture/slots.js +50 -25
  83. package/dist/capture/slots.js.map +1 -1
  84. package/dist/capture/trackerConfig.js +108 -36
  85. package/dist/capture/trackerConfig.js.map +1 -1
  86. package/dist/capture/trackerEndpoint.js +22 -21
  87. package/dist/capture/trackerEndpoint.js.map +1 -1
  88. package/dist/charts/BarList.d.ts +27 -14
  89. package/dist/charts/BarList.js +38 -83
  90. package/dist/charts/BarList.js.map +1 -1
  91. package/dist/charts/TrendChart.d.ts +40 -7
  92. package/dist/charts/TrendChart.js +243 -215
  93. package/dist/charts/TrendChart.js.map +1 -1
  94. package/dist/charts/bars.d.ts +15 -1
  95. package/dist/charts/bars.js +12 -12
  96. package/dist/charts/bars.js.map +1 -1
  97. package/dist/charts/bucket.js +106 -73
  98. package/dist/charts/bucket.js.map +1 -1
  99. package/dist/charts/inProgress.js +22 -0
  100. package/dist/charts/inProgress.js.map +1 -0
  101. package/dist/charts/series.d.ts +15 -0
  102. package/dist/charts/series.js +123 -0
  103. package/dist/charts/series.js.map +1 -0
  104. package/dist/charts/spline.js +91 -25
  105. package/dist/charts/spline.js.map +1 -1
  106. package/dist/charts/trendGeometry.js +91 -0
  107. package/dist/charts/trendGeometry.js.map +1 -0
  108. package/dist/core/adminOptions.d.ts +1 -0
  109. package/dist/core/adminOptions.js +198 -0
  110. package/dist/core/adminOptions.js.map +1 -0
  111. package/dist/core/budget.js +24 -0
  112. package/dist/core/budget.js.map +1 -0
  113. package/dist/core/cacheKey.d.ts +1 -0
  114. package/dist/core/cacheKey.js +48 -37
  115. package/dist/core/cacheKey.js.map +1 -1
  116. package/dist/core/cacheOptions.js +165 -0
  117. package/dist/core/cacheOptions.js.map +1 -0
  118. package/dist/core/capabilities.d.ts +24 -11
  119. package/dist/core/capabilities.js +96 -17
  120. package/dist/core/capabilities.js.map +1 -1
  121. package/dist/core/capture.d.ts +28 -25
  122. package/dist/core/captureOptions.d.ts +1 -0
  123. package/dist/core/captureOptions.js +258 -0
  124. package/dist/core/captureOptions.js.map +1 -0
  125. package/dist/core/clock.js +13 -0
  126. package/dist/core/clock.js.map +1 -0
  127. package/dist/core/collectionOption.d.ts +17 -0
  128. package/dist/core/collectionOption.js +104 -0
  129. package/dist/core/collectionOption.js.map +1 -0
  130. package/dist/core/collectionSlug.js +7 -0
  131. package/dist/core/collectionSlug.js.map +1 -0
  132. package/dist/core/contract.d.ts +297 -59
  133. package/dist/core/contract.js +6 -4
  134. package/dist/core/contract.js.map +1 -1
  135. package/dist/core/cron.js +57 -0
  136. package/dist/core/cron.js.map +1 -0
  137. package/dist/core/fetch.d.ts +17 -0
  138. package/dist/core/goalOptions.d.ts +1 -0
  139. package/dist/core/goalOptions.js +166 -0
  140. package/dist/core/goalOptions.js.map +1 -0
  141. package/dist/core/granularity.js +3 -2
  142. package/dist/core/granularity.js.map +1 -1
  143. package/dist/core/guards.js +17 -0
  144. package/dist/core/guards.js.map +1 -0
  145. package/dist/core/jobs.d.ts +40 -0
  146. package/dist/core/jobs.js +132 -0
  147. package/dist/core/jobs.js.map +1 -0
  148. package/dist/core/legacyOptions.js +145 -0
  149. package/dist/core/legacyOptions.js.map +1 -0
  150. package/dist/core/metricAliases.js +81 -0
  151. package/dist/core/metricAliases.js.map +1 -0
  152. package/dist/core/metricValues.js +57 -0
  153. package/dist/core/metricValues.js.map +1 -0
  154. package/dist/core/monotonic.js +10 -0
  155. package/dist/core/monotonic.js.map +1 -0
  156. package/dist/core/optionChecks.js +51 -0
  157. package/dist/core/optionChecks.js.map +1 -0
  158. package/dist/core/options.d.ts +505 -157
  159. package/dist/core/options.js +158 -219
  160. package/dist/core/options.js.map +1 -1
  161. package/dist/core/registry.js +45 -5
  162. package/dist/core/registry.js.map +1 -1
  163. package/dist/core/scopeList.js +7 -9
  164. package/dist/core/scopeList.js.map +1 -1
  165. package/dist/core/scopeOptions.d.ts +1 -0
  166. package/dist/core/scopeOptions.js +114 -0
  167. package/dist/core/scopeOptions.js.map +1 -0
  168. package/dist/core/scopedRead.js +330 -71
  169. package/dist/core/scopedRead.js.map +1 -1
  170. package/dist/core/sdks.d.ts +81 -0
  171. package/dist/core/sdks.js +23 -0
  172. package/dist/core/sdks.js.map +1 -0
  173. package/dist/core/serverEvent.d.ts +38 -20
  174. package/dist/core/serverEvent.js.map +1 -1
  175. package/dist/core/siteAddress.js +20 -0
  176. package/dist/core/siteAddress.js.map +1 -0
  177. package/dist/core/sourceErrors.js +109 -0
  178. package/dist/core/sourceErrors.js.map +1 -0
  179. package/dist/core/sourceLabel.d.ts +10 -0
  180. package/dist/core/sourceLabel.js +63 -0
  181. package/dist/core/sourceLabel.js.map +1 -0
  182. package/dist/core/sourceOptions.js +106 -0
  183. package/dist/core/sourceOptions.js.map +1 -0
  184. package/dist/core/sourcePolicy.d.ts +55 -0
  185. package/dist/core/sourcePolicy.js +51 -0
  186. package/dist/core/sourcePolicy.js.map +1 -0
  187. package/dist/core/throttle.js +18 -0
  188. package/dist/core/throttle.js.map +1 -0
  189. package/dist/core/values.js +61 -0
  190. package/dist/core/values.js.map +1 -0
  191. package/dist/core/widgetSlugs.d.ts +17 -0
  192. package/dist/core/widgetSlugs.js +29 -0
  193. package/dist/core/widgetSlugs.js.map +1 -0
  194. package/dist/db/detachedWrite.js +36 -0
  195. package/dist/db/detachedWrite.js.map +1 -0
  196. package/dist/db/errors.js +182 -0
  197. package/dist/db/errors.js.map +1 -0
  198. package/dist/db/kind.js +32 -0
  199. package/dist/db/kind.js.map +1 -0
  200. package/dist/db/openTransaction.js +51 -0
  201. package/dist/db/openTransaction.js.map +1 -0
  202. package/dist/exports/adapters/contract.d.ts +15 -0
  203. package/dist/exports/adapters/ga4.d.ts +16 -1
  204. package/dist/exports/adapters/native.d.ts +27 -2
  205. package/dist/exports/adapters/native.js +4 -1
  206. package/dist/exports/adapters/plausible.d.ts +16 -1
  207. package/dist/exports/adapters/posthog.d.ts +16 -1
  208. package/dist/exports/adapters/umami.d.ts +16 -1
  209. package/dist/exports/attributes.d.ts +42 -0
  210. package/dist/exports/attributes.js +83 -0
  211. package/dist/exports/attributes.js.map +1 -0
  212. package/dist/exports/client.d.ts +43 -13
  213. package/dist/exports/client.js +22 -9
  214. package/dist/exports/geo.d.ts +3 -1
  215. package/dist/exports/geo.js +1 -1
  216. package/dist/exports/i18n.d.ts +2 -2
  217. package/dist/exports/i18n.js +2 -2
  218. package/dist/exports/migrations.d.ts +2 -0
  219. package/dist/exports/migrations.js +2 -0
  220. package/dist/exports/next.d.ts +19 -1
  221. package/dist/exports/next.js +3 -1
  222. package/dist/exports/react.d.ts +3 -2
  223. package/dist/exports/react.js +1 -2
  224. package/dist/exports/rsc.d.ts +32 -14
  225. package/dist/exports/rsc.js +11 -6
  226. package/dist/exports/site.d.ts +5 -0
  227. package/dist/exports/site.js +3 -0
  228. package/dist/exports/testing.d.ts +18 -0
  229. package/dist/exports/testing.js +3 -0
  230. package/dist/exports/tracker.d.ts +5 -20
  231. package/dist/exports/tracker.js +3 -14
  232. package/dist/exports/types.d.ts +44 -14
  233. package/dist/exports/types.js +5 -1
  234. package/dist/fields/AnalyticsPanelClient.js +265 -154
  235. package/dist/fields/AnalyticsPanelClient.js.map +1 -1
  236. package/dist/fields/AnalyticsPanelField.d.ts +19 -7
  237. package/dist/fields/AnalyticsPanelField.js +123 -30
  238. package/dist/fields/AnalyticsPanelField.js.map +1 -1
  239. package/dist/fields/AnalyticsStatField.d.ts +17 -6
  240. package/dist/fields/AnalyticsStatField.js +98 -63
  241. package/dist/fields/AnalyticsStatField.js.map +1 -1
  242. package/dist/fields/FieldShimmer.js +15 -0
  243. package/dist/fields/FieldShimmer.js.map +1 -0
  244. package/dist/fields/PanelContent.js +222 -0
  245. package/dist/fields/PanelContent.js.map +1 -0
  246. package/dist/fields/PanelList.js +82 -0
  247. package/dist/fields/PanelList.js.map +1 -0
  248. package/dist/fields/PanelLiveCounter.js +63 -0
  249. package/dist/fields/PanelLiveCounter.js.map +1 -0
  250. package/dist/fields/PanelSkeleton.js +63 -0
  251. package/dist/fields/PanelSkeleton.js.map +1 -0
  252. package/dist/fields/componentPaths.js +8 -0
  253. package/dist/fields/componentPaths.js.map +1 -0
  254. package/dist/fields/config/FilterDimensionSelectField.d.ts +2 -2
  255. package/dist/fields/config/FilterDimensionSelectField.js +26 -54
  256. package/dist/fields/config/FilterDimensionSelectField.js.map +1 -1
  257. package/dist/fields/config/FilterKeySelect.js +66 -0
  258. package/dist/fields/config/FilterKeySelect.js.map +1 -0
  259. package/dist/fields/config/FilterOperatorSelectField.d.ts +7 -2
  260. package/dist/fields/config/FilterOperatorSelectField.js +37 -53
  261. package/dist/fields/config/FilterOperatorSelectField.js.map +1 -1
  262. package/dist/fields/config/FilterValueField.d.ts +17 -0
  263. package/dist/fields/config/FilterValueField.js +130 -0
  264. package/dist/fields/config/FilterValueField.js.map +1 -0
  265. package/dist/fields/config/MetricSelectField.d.ts +5 -12
  266. package/dist/fields/config/MetricSelectField.js +18 -30
  267. package/dist/fields/config/MetricSelectField.js.map +1 -1
  268. package/dist/fields/config/OptionSelect.js +52 -0
  269. package/dist/fields/config/OptionSelect.js.map +1 -0
  270. package/dist/fields/config/SourceSelectField.js +16 -31
  271. package/dist/fields/config/SourceSelectField.js.map +1 -1
  272. package/dist/fields/config/fetchSources.d.ts +3 -0
  273. package/dist/fields/config/fetchSources.js +17 -27
  274. package/dist/fields/config/fetchSources.js.map +1 -1
  275. package/dist/fields/config/filterValues.js +106 -0
  276. package/dist/fields/config/filterValues.js.map +1 -0
  277. package/dist/fields/config/narrow.js +8 -10
  278. package/dist/fields/config/narrow.js.map +1 -1
  279. package/dist/fields/config/retiredPickers.d.ts +45 -0
  280. package/dist/fields/config/retiredPickers.js +46 -0
  281. package/dist/fields/config/retiredPickers.js.map +1 -0
  282. package/dist/fields/config/scopedFields.d.ts +40 -0
  283. package/dist/fields/config/scopedFields.js +68 -0
  284. package/dist/fields/config/scopedFields.js.map +1 -0
  285. package/dist/fields/config/toSelectOption.js +13 -7
  286. package/dist/fields/config/toSelectOption.js.map +1 -1
  287. package/dist/fields/config/useAnalyticsSources.d.ts +5 -7
  288. package/dist/fields/config/useAnalyticsSources.js +17 -21
  289. package/dist/fields/config/useAnalyticsSources.js.map +1 -1
  290. package/dist/fields/config/useFilterCapabilities.d.ts +9 -6
  291. package/dist/fields/config/useFilterCapabilities.js +23 -15
  292. package/dist/fields/config/useFilterCapabilities.js.map +1 -1
  293. package/dist/fields/config/useFormString.js +12 -0
  294. package/dist/fields/config/useFormString.js.map +1 -0
  295. package/dist/fields/dateRange/field.js +7 -19
  296. package/dist/fields/dateRange/field.js.map +1 -1
  297. package/dist/fields/dateRange/types.d.ts +5 -1
  298. package/dist/fields/dateRange/ui.d.ts +3 -2
  299. package/dist/fields/dateRange/ui.js +57 -319
  300. package/dist/fields/dateRange/ui.js.map +1 -1
  301. package/dist/fields/documentScope.js +21 -0
  302. package/dist/fields/documentScope.js.map +1 -0
  303. package/dist/fields/emptyState.js +31 -26
  304. package/dist/fields/emptyState.js.map +1 -1
  305. package/dist/fields/factories.d.ts +35 -16
  306. package/dist/fields/factories.js +66 -37
  307. package/dist/fields/factories.js.map +1 -1
  308. package/dist/fields/format.d.ts +12 -3
  309. package/dist/fields/format.js +77 -13
  310. package/dist/fields/format.js.map +1 -1
  311. package/dist/fields/itemReport.js +45 -0
  312. package/dist/fields/itemReport.js.map +1 -0
  313. package/dist/fields/readForDocument.d.ts +79 -26
  314. package/dist/fields/readForDocument.js +450 -116
  315. package/dist/fields/readForDocument.js.map +1 -1
  316. package/dist/fields/stateKeys.js +20 -0
  317. package/dist/fields/stateKeys.js.map +1 -0
  318. package/dist/goals/GoalAmountField.d.ts +10 -0
  319. package/dist/goals/GoalAmountField.js +162 -0
  320. package/dist/goals/GoalAmountField.js.map +1 -0
  321. package/dist/goals/GoalSelectField.js +89 -40
  322. package/dist/goals/GoalSelectField.js.map +1 -1
  323. package/dist/goals/GoalSelectFieldServer.d.ts +13 -0
  324. package/dist/goals/GoalSelectFieldServer.js +21 -0
  325. package/dist/goals/GoalSelectFieldServer.js.map +1 -0
  326. package/dist/goals/amountField.d.ts +20 -0
  327. package/dist/goals/amountField.js +37 -0
  328. package/dist/goals/amountField.js.map +1 -0
  329. package/dist/goals/builtin.js +17 -0
  330. package/dist/goals/builtin.js.map +1 -0
  331. package/dist/goals/collection.d.ts +22 -0
  332. package/dist/goals/collection.js +139 -125
  333. package/dist/goals/collection.js.map +1 -1
  334. package/dist/goals/constants.d.ts +38 -0
  335. package/dist/goals/constants.js +49 -0
  336. package/dist/goals/constants.js.map +1 -0
  337. package/dist/goals/currency.d.ts +16 -0
  338. package/dist/goals/currency.js +46 -4
  339. package/dist/goals/currency.js.map +1 -1
  340. package/dist/goals/currencyOptions.js +70 -0
  341. package/dist/goals/currencyOptions.js.map +1 -0
  342. package/dist/goals/fetchGoals.d.ts +10 -0
  343. package/dist/goals/fetchGoals.js +12 -26
  344. package/dist/goals/fetchGoals.js.map +1 -1
  345. package/dist/goals/goalField.d.ts +4 -6
  346. package/dist/goals/goalField.js +9 -19
  347. package/dist/goals/goalField.js.map +1 -1
  348. package/dist/goals/goalsEndpoint.js +39 -40
  349. package/dist/goals/goalsEndpoint.js.map +1 -1
  350. package/dist/goals/items.js +35 -0
  351. package/dist/goals/items.js.map +1 -0
  352. package/dist/goals/latent.js +9 -0
  353. package/dist/goals/latent.js.map +1 -0
  354. package/dist/goals/linkFields.d.ts +35 -0
  355. package/dist/goals/linkFields.js +31 -0
  356. package/dist/goals/linkFields.js.map +1 -0
  357. package/dist/goals/match.d.ts +14 -0
  358. package/dist/goals/match.js +67 -46
  359. package/dist/goals/match.js.map +1 -1
  360. package/dist/goals/moneyFields.js +56 -0
  361. package/dist/goals/moneyFields.js.map +1 -0
  362. package/dist/goals/pathMatch.js +122 -0
  363. package/dist/goals/pathMatch.js.map +1 -0
  364. package/dist/goals/placeholder.js +12 -0
  365. package/dist/goals/placeholder.js.map +1 -0
  366. package/dist/goals/resolver.d.ts +3 -3
  367. package/dist/goals/resolver.js +155 -47
  368. package/dist/goals/resolver.js.map +1 -1
  369. package/dist/goals/serverRevenue.d.ts +60 -0
  370. package/dist/goals/serverRevenue.js +41 -0
  371. package/dist/goals/serverRevenue.js.map +1 -0
  372. package/dist/goals/trackGoalAction.d.ts +26 -27
  373. package/dist/goals/trackGoalAction.js +38 -52
  374. package/dist/goals/trackGoalAction.js.map +1 -1
  375. package/dist/goals/types.d.ts +13 -28
  376. package/dist/goals/types.js +1 -1
  377. package/dist/goals/types.js.map +1 -1
  378. package/dist/goals/useAnalyticsGoals.d.ts +6 -5
  379. package/dist/goals/useAnalyticsGoals.js +17 -18
  380. package/dist/goals/useAnalyticsGoals.js.map +1 -1
  381. package/dist/index.d.ts +67 -12
  382. package/dist/index.js +258 -247
  383. package/dist/index.js.map +1 -1
  384. package/dist/items/collectionIdType.js +20 -0
  385. package/dist/items/collectionIdType.js.map +1 -0
  386. package/dist/items/idType.js +31 -0
  387. package/dist/items/idType.js.map +1 -0
  388. package/dist/items/ref.js +73 -0
  389. package/dist/items/ref.js.map +1 -0
  390. package/dist/maintenance/apiTaskState.js +141 -0
  391. package/dist/maintenance/apiTaskState.js.map +1 -0
  392. package/dist/maintenance/heartbeat.js +51 -0
  393. package/dist/maintenance/heartbeat.js.map +1 -0
  394. package/dist/maintenance/lease.d.ts +1 -0
  395. package/dist/maintenance/lease.js +81 -0
  396. package/dist/maintenance/lease.js.map +1 -0
  397. package/dist/maintenance/taskSchedule.d.ts +1 -0
  398. package/dist/maintenance/taskSchedule.js +62 -0
  399. package/dist/maintenance/taskSchedule.js.map +1 -0
  400. package/dist/maintenance/underLease.js +35 -0
  401. package/dist/maintenance/underLease.js.map +1 -0
  402. package/dist/migrations/legacy.d.ts +54 -0
  403. package/dist/migrations/legacy.js +117 -0
  404. package/dist/migrations/legacy.js.map +1 -0
  405. package/dist/migrations/predefined/dropLegacyMongo.d.ts +11 -0
  406. package/dist/migrations/predefined/dropLegacyMongo.js +12 -0
  407. package/dist/migrations/predefined/dropLegacyMongo.js.map +1 -0
  408. package/dist/native/collections/aggregates.js +54 -0
  409. package/dist/native/collections/aggregates.js.map +1 -0
  410. package/dist/native/collections/hits.js +102 -0
  411. package/dist/native/collections/hits.js.map +1 -0
  412. package/dist/native/collections/slugs.d.ts +10 -0
  413. package/dist/native/collections/slugs.js +16 -0
  414. package/dist/native/collections/slugs.js.map +1 -0
  415. package/dist/native/collections/state.js +84 -0
  416. package/dist/native/collections/state.js.map +1 -0
  417. package/dist/native/collections/storeCollection.js +29 -0
  418. package/dist/native/collections/storeCollection.js.map +1 -0
  419. package/dist/native/engine/buckets.d.ts +1 -0
  420. package/dist/native/engine/buckets.js +53 -0
  421. package/dist/native/engine/buckets.js.map +1 -0
  422. package/dist/native/engine/capabilities.js +87 -0
  423. package/dist/native/engine/capabilities.js.map +1 -0
  424. package/dist/native/engine/cost.js +72 -0
  425. package/dist/native/engine/cost.js.map +1 -0
  426. package/dist/native/engine/days.d.ts +1 -0
  427. package/dist/native/engine/days.js +182 -0
  428. package/dist/native/engine/days.js.map +1 -0
  429. package/dist/native/engine/engine.d.ts +1 -0
  430. package/dist/native/engine/engine.js +1623 -0
  431. package/dist/native/engine/engine.js.map +1 -0
  432. package/dist/native/engine/instance.js +58 -0
  433. package/dist/native/engine/instance.js.map +1 -0
  434. package/dist/native/engine/maintenance.d.ts +1 -0
  435. package/dist/native/engine/maintenance.js +677 -0
  436. package/dist/native/engine/maintenance.js.map +1 -0
  437. package/dist/native/engine/merge.js +41 -0
  438. package/dist/native/engine/merge.js.map +1 -0
  439. package/dist/native/engine/nudge.js +26 -0
  440. package/dist/native/engine/nudge.js.map +1 -0
  441. package/dist/native/engine/planner.js +198 -0
  442. package/dist/native/engine/planner.js.map +1 -0
  443. package/dist/native/engine/rebuild.d.ts +22 -0
  444. package/dist/native/engine/rebuild.js +76 -0
  445. package/dist/native/engine/rebuild.js.map +1 -0
  446. package/dist/native/engine/recent.js +17 -0
  447. package/dist/native/engine/recent.js.map +1 -0
  448. package/dist/native/engine/salt.d.ts +1 -0
  449. package/dist/native/engine/salt.js +98 -0
  450. package/dist/native/engine/salt.js.map +1 -0
  451. package/dist/native/engine/siteHosts.d.ts +1 -0
  452. package/dist/native/engine/siteHosts.js +58 -0
  453. package/dist/native/engine/siteHosts.js.map +1 -0
  454. package/dist/native/engine/toHit.js +108 -0
  455. package/dist/native/engine/toHit.js.map +1 -0
  456. package/dist/native/engine/writeBuffer.d.ts +14 -0
  457. package/dist/native/engine/writeBuffer.js +317 -0
  458. package/dist/native/engine/writeBuffer.js.map +1 -0
  459. package/dist/native/geo/composeGeoResolvers.d.ts +1 -0
  460. package/dist/native/geo/composeGeoResolvers.js +4 -1
  461. package/dist/native/geo/composeGeoResolvers.js.map +1 -1
  462. package/dist/native/geo/geoResolver.d.ts +20 -2
  463. package/dist/native/geo/geoResolver.js +42 -6
  464. package/dist/native/geo/geoResolver.js.map +1 -1
  465. package/dist/native/geo/maxmindResolver.d.ts +8 -4
  466. package/dist/native/geo/maxmindResolver.js +20 -16
  467. package/dist/native/geo/maxmindResolver.js.map +1 -1
  468. package/dist/native/geo/resolveGeo.js +31 -0
  469. package/dist/native/geo/resolveGeo.js.map +1 -0
  470. package/dist/native/ingest/bots.d.ts +2 -3
  471. package/dist/native/ingest/bots.js +8 -13
  472. package/dist/native/ingest/bots.js.map +1 -1
  473. package/dist/native/ingest/browser.js +4 -6
  474. package/dist/native/ingest/browser.js.map +1 -1
  475. package/dist/native/ingest/clientIp.js +30 -9
  476. package/dist/native/ingest/clientIp.js.map +1 -1
  477. package/dist/native/ingest/device.js +4 -6
  478. package/dist/native/ingest/device.js.map +1 -1
  479. package/dist/native/ingest/endpoint.d.ts +1 -1
  480. package/dist/native/ingest/endpoint.js +119 -34
  481. package/dist/native/ingest/endpoint.js.map +1 -1
  482. package/dist/native/ingest/itemSignature.d.ts +26 -0
  483. package/dist/native/ingest/itemSignature.js +45 -0
  484. package/dist/native/ingest/itemSignature.js.map +1 -0
  485. package/dist/native/ingest/language.js +2 -3
  486. package/dist/native/ingest/language.js.map +1 -1
  487. package/dist/native/ingest/normalizeEvent.d.ts +60 -7
  488. package/dist/native/ingest/normalizeEvent.js +226 -61
  489. package/dist/native/ingest/normalizeEvent.js.map +1 -1
  490. package/dist/native/ingest/orderSignature.d.ts +13 -0
  491. package/dist/native/ingest/orderSignature.js +50 -0
  492. package/dist/native/ingest/orderSignature.js.map +1 -0
  493. package/dist/native/ingest/referrer.js +30 -32
  494. package/dist/native/ingest/referrer.js.map +1 -1
  495. package/dist/native/ingest/requestHost.js +10 -23
  496. package/dist/native/ingest/requestHost.js.map +1 -1
  497. package/dist/native/ingest/resolveHostname.d.ts +4 -13
  498. package/dist/native/ingest/resolveHostname.js +5 -6
  499. package/dist/native/ingest/resolveHostname.js.map +1 -1
  500. package/dist/native/ingest/revenue.d.ts +1 -0
  501. package/dist/native/ingest/revenue.js +121 -0
  502. package/dist/native/ingest/revenue.js.map +1 -0
  503. package/dist/native/ingest/route.d.ts +10 -0
  504. package/dist/native/ingest/route.js +82 -0
  505. package/dist/native/ingest/route.js.map +1 -0
  506. package/dist/native/ingest/serverTrack.d.ts +2 -10
  507. package/dist/native/ingest/serverTrack.js +181 -72
  508. package/dist/native/ingest/serverTrack.js.map +1 -1
  509. package/dist/native/ingest/signature.js +28 -0
  510. package/dist/native/ingest/signature.js.map +1 -0
  511. package/dist/native/ingest/source.d.ts +2 -3
  512. package/dist/native/ingest/source.js +35 -54
  513. package/dist/native/ingest/source.js.map +1 -1
  514. package/dist/native/ingest/utm.js +9 -9
  515. package/dist/native/ingest/utm.js.map +1 -1
  516. package/dist/native/ingest/validate.js +20 -10
  517. package/dist/native/ingest/validate.js.map +1 -1
  518. package/dist/native/ingest/visitorHash.js +6 -8
  519. package/dist/native/ingest/visitorHash.js.map +1 -1
  520. package/dist/native/nativeAdapter.d.ts +107 -33
  521. package/dist/native/nativeAdapter.js +376 -317
  522. package/dist/native/nativeAdapter.js.map +1 -1
  523. package/dist/native/rebuildDays.d.ts +12 -0
  524. package/dist/native/rebuildDays.js +16 -0
  525. package/dist/native/rebuildDays.js.map +1 -0
  526. package/dist/native/store/aggregate.js +450 -0
  527. package/dist/native/store/aggregate.js.map +1 -0
  528. package/dist/native/store/caps.d.ts +18 -0
  529. package/dist/native/store/caps.js +76 -0
  530. package/dist/native/store/caps.js.map +1 -0
  531. package/dist/native/store/chunks.js +34 -0
  532. package/dist/native/store/chunks.js.map +1 -0
  533. package/dist/native/store/columnValues.js +31 -0
  534. package/dist/native/store/columnValues.js.map +1 -0
  535. package/dist/native/store/dialect.js +106 -0
  536. package/dist/native/store/dialect.js.map +1 -0
  537. package/dist/native/store/eventStore.js +44 -0
  538. package/dist/native/store/eventStore.js.map +1 -0
  539. package/dist/native/store/hitRow.js +116 -0
  540. package/dist/native/store/hitRow.js.map +1 -0
  541. package/dist/native/store/hits.js +63 -0
  542. package/dist/native/store/hits.js.map +1 -0
  543. package/dist/native/store/ids.js +105 -0
  544. package/dist/native/store/ids.js.map +1 -0
  545. package/dist/native/store/mongo/aggregatePipelines.js +430 -0
  546. package/dist/native/store/mongo/aggregatePipelines.js.map +1 -0
  547. package/dist/native/store/mongo/mongoState.js +375 -0
  548. package/dist/native/store/mongo/mongoState.js.map +1 -0
  549. package/dist/native/store/mongo/mongoStore.js +618 -0
  550. package/dist/native/store/mongo/mongoStore.js.map +1 -0
  551. package/dist/native/store/mongo/pipelines.js +695 -0
  552. package/dist/native/store/mongo/pipelines.js.map +1 -0
  553. package/dist/native/store/mongo/results.js +20 -0
  554. package/dist/native/store/mongo/results.js.map +1 -0
  555. package/dist/native/store/parts.d.ts +1 -0
  556. package/dist/native/store/parts.js +95 -0
  557. package/dist/native/store/parts.js.map +1 -0
  558. package/dist/native/store/pattern.js +213 -0
  559. package/dist/native/store/pattern.js.map +1 -0
  560. package/dist/native/store/rawRead.d.ts +23 -0
  561. package/dist/native/store/rawRead.js +384 -0
  562. package/dist/native/store/rawRead.js.map +1 -0
  563. package/dist/native/store/reclassify.js +53 -0
  564. package/dist/native/store/reclassify.js.map +1 -0
  565. package/dist/native/store/sql/aggregateSql.js +345 -0
  566. package/dist/native/store/sql/aggregateSql.js.map +1 -0
  567. package/dist/native/store/sql/columns.js +48 -0
  568. package/dist/native/store/sql/columns.js.map +1 -0
  569. package/dist/native/store/sql/compile.js +656 -0
  570. package/dist/native/store/sql/compile.js.map +1 -0
  571. package/dist/native/store/sql/drivers.js +218 -0
  572. package/dist/native/store/sql/drivers.js.map +1 -0
  573. package/dist/native/store/sql/executor.js +132 -0
  574. package/dist/native/store/sql/executor.js.map +1 -0
  575. package/dist/native/store/sql/fragment.js +104 -0
  576. package/dist/native/store/sql/fragment.js.map +1 -0
  577. package/dist/native/store/sql/maintenanceSql.js +59 -0
  578. package/dist/native/store/sql/maintenanceSql.js.map +1 -0
  579. package/dist/native/store/sql/ownConnection.js +107 -0
  580. package/dist/native/store/sql/ownConnection.js.map +1 -0
  581. package/dist/native/store/sql/poolShare.js +101 -0
  582. package/dist/native/store/sql/poolShare.js.map +1 -0
  583. package/dist/native/store/sql/sqlState.js +325 -0
  584. package/dist/native/store/sql/sqlState.js.map +1 -0
  585. package/dist/native/store/sql/sqlStore.js +355 -0
  586. package/dist/native/store/sql/sqlStore.js.map +1 -0
  587. package/dist/native/store/sql/sqliteThread.d.ts +9 -0
  588. package/dist/native/store/sql/sqliteThread.js +314 -0
  589. package/dist/native/store/sql/sqliteThread.js.map +1 -0
  590. package/dist/native/store/sql/sqliteWorker.js +327 -0
  591. package/dist/native/store/sql/sqliteWorker.js.map +1 -0
  592. package/dist/native/store/sql/sqliteWorkerSource.js +347 -0
  593. package/dist/native/store/sql/sqliteWorkerSource.js.map +1 -0
  594. package/dist/native/store/state.js +151 -0
  595. package/dist/native/store/state.js.map +1 -0
  596. package/dist/native/store/stateStore.js +29 -0
  597. package/dist/native/store/stateStore.js.map +1 -0
  598. package/dist/native/store/types.d.ts +9 -0
  599. package/dist/native/tasks/maintainTask.d.ts +19 -0
  600. package/dist/native/tasks/maintainTask.js +68 -0
  601. package/dist/native/tasks/maintainTask.js.map +1 -0
  602. package/dist/net/guardedFetch.d.ts +32 -0
  603. package/dist/net/guardedFetch.js +220 -0
  604. package/dist/net/guardedFetch.js.map +1 -0
  605. package/dist/net/origin.js +40 -0
  606. package/dist/net/origin.js.map +1 -0
  607. package/dist/net/platform.d.ts +9 -0
  608. package/dist/net/platform.js +35 -0
  609. package/dist/net/platform.js.map +1 -0
  610. package/dist/next/captureRewrites.d.ts +4 -24
  611. package/dist/next/captureRewrites.js +6 -50
  612. package/dist/next/captureRewrites.js.map +1 -1
  613. package/dist/next/captureRoute.d.ts +28 -0
  614. package/dist/next/captureRoute.js +67 -0
  615. package/dist/next/captureRoute.js.map +1 -0
  616. package/dist/next/ingestRoute.d.ts +17 -0
  617. package/dist/next/ingestRoute.js +17 -0
  618. package/dist/next/ingestRoute.js.map +1 -0
  619. package/dist/next/posthogProxyRewrites.d.ts +3 -25
  620. package/dist/next/posthogProxyRewrites.js +5 -37
  621. package/dist/next/posthogProxyRewrites.js.map +1 -1
  622. package/dist/plugin/adminDependencies.js +34 -0
  623. package/dist/plugin/adminDependencies.js.map +1 -0
  624. package/dist/plugin/apiPath.js +23 -0
  625. package/dist/plugin/apiPath.js.map +1 -0
  626. package/dist/plugin/boundDocument.js +58 -0
  627. package/dist/plugin/boundDocument.js.map +1 -0
  628. package/dist/plugin/buildPhase.js +10 -0
  629. package/dist/plugin/buildPhase.js.map +1 -0
  630. package/dist/plugin/collectionChecks.js +232 -0
  631. package/dist/plugin/collectionChecks.js.map +1 -0
  632. package/dist/plugin/collectionFields.d.ts +13 -0
  633. package/dist/plugin/collectionFields.js +22 -0
  634. package/dist/plugin/collectionFields.js.map +1 -0
  635. package/dist/plugin/createRuntime.js +339 -0
  636. package/dist/plugin/createRuntime.js.map +1 -0
  637. package/dist/plugin/destroy.js +58 -0
  638. package/dist/plugin/destroy.js.map +1 -0
  639. package/dist/plugin/documentEndpoint.js +77 -53
  640. package/dist/plugin/documentEndpoint.js.map +1 -1
  641. package/dist/plugin/documentScopes.js +37 -0
  642. package/dist/plugin/documentScopes.js.map +1 -0
  643. package/dist/plugin/encrypted.js +25 -0
  644. package/dist/plugin/encrypted.js.map +1 -0
  645. package/dist/plugin/errors.d.ts +5 -12
  646. package/dist/plugin/errors.js +23 -16
  647. package/dist/plugin/errors.js.map +1 -1
  648. package/dist/plugin/flagsEndpoint.js +41 -0
  649. package/dist/plugin/flagsEndpoint.js.map +1 -0
  650. package/dist/plugin/goalHint.js +22 -11
  651. package/dist/plugin/goalHint.js.map +1 -1
  652. package/dist/plugin/itemLabels.js +114 -0
  653. package/dist/plugin/itemLabels.js.map +1 -0
  654. package/dist/plugin/jobsAccess.js +91 -0
  655. package/dist/plugin/jobsAccess.js.map +1 -0
  656. package/dist/plugin/keepAlive.js +48 -0
  657. package/dist/plugin/keepAlive.js.map +1 -0
  658. package/dist/plugin/peerImportError.js +3 -6
  659. package/dist/plugin/peerImportError.js.map +1 -1
  660. package/dist/plugin/peers.js +64 -0
  661. package/dist/plugin/peers.js.map +1 -0
  662. package/dist/plugin/pluginCollections.js +161 -0
  663. package/dist/plugin/pluginCollections.js.map +1 -0
  664. package/dist/plugin/queryEndpoint.js +70 -45
  665. package/dist/plugin/queryEndpoint.js.map +1 -1
  666. package/dist/plugin/queryParams.js +7 -0
  667. package/dist/plugin/queryParams.js.map +1 -0
  668. package/dist/plugin/readContextForRequest.d.ts +11 -0
  669. package/dist/plugin/readContextForRequest.js +70 -25
  670. package/dist/plugin/readContextForRequest.js.map +1 -1
  671. package/dist/plugin/readFailure.js +22 -0
  672. package/dist/plugin/readFailure.js.map +1 -0
  673. package/dist/plugin/readableProviders.js +64 -0
  674. package/dist/plugin/readableProviders.js.map +1 -0
  675. package/dist/plugin/realtimeEndpoint.js +77 -25
  676. package/dist/plugin/realtimeEndpoint.js.map +1 -1
  677. package/dist/plugin/refreshEndpoint.js +69 -44
  678. package/dist/plugin/refreshEndpoint.js.map +1 -1
  679. package/dist/plugin/relabelFields.js +36 -0
  680. package/dist/plugin/relabelFields.js.map +1 -0
  681. package/dist/plugin/requestMemo.js +35 -0
  682. package/dist/plugin/requestMemo.js.map +1 -0
  683. package/dist/plugin/routeChecks.js +39 -0
  684. package/dist/plugin/routeChecks.js.map +1 -0
  685. package/dist/plugin/routes.d.ts +53 -0
  686. package/dist/plugin/routes.js +92 -0
  687. package/dist/plugin/routes.js.map +1 -0
  688. package/dist/plugin/runtime.d.ts +1 -1
  689. package/dist/plugin/runtime.js +234 -30
  690. package/dist/plugin/runtime.js.map +1 -1
  691. package/dist/plugin/schemaOnly.js +63 -0
  692. package/dist/plugin/schemaOnly.js.map +1 -0
  693. package/dist/plugin/scopeChange.js +6 -5
  694. package/dist/plugin/scopeChange.js.map +1 -1
  695. package/dist/plugin/scopeFieldBoot.js +4 -4
  696. package/dist/plugin/scopeFieldBoot.js.map +1 -1
  697. package/dist/plugin/scopeToken.js +33 -0
  698. package/dist/plugin/scopeToken.js.map +1 -0
  699. package/dist/plugin/sourcesEndpoint.js +50 -17
  700. package/dist/plugin/sourcesEndpoint.js.map +1 -1
  701. package/dist/plugin/unbundledLanguages.js +25 -0
  702. package/dist/plugin/unbundledLanguages.js.map +1 -0
  703. package/dist/plugin/walkFields.js +22 -0
  704. package/dist/plugin/walkFields.js.map +1 -0
  705. package/dist/plugin/warmTask.js +0 -0
  706. package/dist/plugin/warmTask.js.map +1 -1
  707. package/dist/providers/ProvidersListNotice.d.ts +11 -0
  708. package/dist/providers/ProvidersListNotice.js +36 -0
  709. package/dist/providers/ProvidersListNotice.js.map +1 -0
  710. package/dist/providers/access.d.ts +1 -0
  711. package/dist/providers/access.js +35 -26
  712. package/dist/providers/access.js.map +1 -1
  713. package/dist/providers/adapterPool.js +121 -0
  714. package/dist/providers/adapterPool.js.map +1 -0
  715. package/dist/providers/collection.d.ts +61 -0
  716. package/dist/providers/collection.js +340 -151
  717. package/dist/providers/collection.js.map +1 -1
  718. package/dist/providers/factory.d.ts +76 -0
  719. package/dist/providers/factory.js +75 -25
  720. package/dist/providers/factory.js.map +1 -1
  721. package/dist/providers/hosts.d.ts +25 -0
  722. package/dist/providers/hosts.js +128 -0
  723. package/dist/providers/hosts.js.map +1 -0
  724. package/dist/providers/probe.d.ts +1 -0
  725. package/dist/providers/probe.js +105 -0
  726. package/dist/providers/probe.js.map +1 -0
  727. package/dist/providers/refresh.d.ts +18 -0
  728. package/dist/providers/refresh.js +49 -0
  729. package/dist/providers/refresh.js.map +1 -0
  730. package/dist/providers/registry.js +328 -0
  731. package/dist/providers/registry.js.map +1 -0
  732. package/dist/providers/resolver.js +26 -88
  733. package/dist/providers/resolver.js.map +1 -1
  734. package/dist/providers/retarget.js +45 -0
  735. package/dist/providers/retarget.js.map +1 -0
  736. package/dist/providers/scopeUnique.js +41 -0
  737. package/dist/providers/scopeUnique.js.map +1 -0
  738. package/dist/providers/secrets.d.ts +26 -0
  739. package/dist/providers/secrets.js +61 -4
  740. package/dist/providers/secrets.js.map +1 -1
  741. package/dist/providers/stampScope.js +9 -6
  742. package/dist/providers/stampScope.js.map +1 -1
  743. package/dist/query/dates.js +10 -12
  744. package/dist/query/dates.js.map +1 -1
  745. package/dist/query/errors.d.ts +1 -5
  746. package/dist/query/fetchQuery.d.ts +25 -32
  747. package/dist/query/fetchQuery.js +91 -91
  748. package/dist/query/fetchQuery.js.map +1 -1
  749. package/dist/query/limits.js +8 -0
  750. package/dist/query/limits.js.map +1 -0
  751. package/dist/query/parse.d.ts +6 -0
  752. package/dist/query/parse.js +153 -106
  753. package/dist/query/parse.js.map +1 -1
  754. package/dist/query/response.d.ts +23 -3
  755. package/dist/query/response.js +12 -5
  756. package/dist/query/response.js.map +1 -1
  757. package/dist/react/AnalyticsProvider.d.ts +26 -17
  758. package/dist/react/AnalyticsProvider.js +23 -22
  759. package/dist/react/AnalyticsProvider.js.map +1 -1
  760. package/dist/react/TrackerBoot.js +15 -9
  761. package/dist/react/TrackerBoot.js.map +1 -1
  762. package/dist/react/useAnalytics.d.ts +2 -11
  763. package/dist/react/useAnalytics.js +22 -24
  764. package/dist/react/useAnalytics.js.map +1 -1
  765. package/dist/site/AnalyticsScripts.d.ts +34 -0
  766. package/dist/site/AnalyticsScripts.js +30 -0
  767. package/dist/site/AnalyticsScripts.js.map +1 -0
  768. package/dist/site/getTrackerConfig.d.ts +15 -0
  769. package/dist/site/getTrackerConfig.js +40 -0
  770. package/dist/site/getTrackerConfig.js.map +1 -0
  771. package/dist/surfacing/afterRead.d.ts +37 -0
  772. package/dist/surfacing/bounded.js +38 -0
  773. package/dist/surfacing/bounded.js.map +1 -0
  774. package/dist/surfacing/breaker.js +107 -0
  775. package/dist/surfacing/breaker.js.map +1 -0
  776. package/dist/surfacing/cacheCollection.d.ts +8 -0
  777. package/dist/surfacing/cacheCollection.js +69 -0
  778. package/dist/surfacing/cacheCollection.js.map +1 -0
  779. package/dist/surfacing/cacheStore.d.ts +71 -1
  780. package/dist/surfacing/cacheStore.js +16 -37
  781. package/dist/surfacing/cacheStore.js.map +1 -1
  782. package/dist/surfacing/cacheSweep.d.ts +1 -0
  783. package/dist/surfacing/cacheSweep.js +59 -0
  784. package/dist/surfacing/cacheSweep.js.map +1 -0
  785. package/dist/surfacing/classifyError.js +282 -0
  786. package/dist/surfacing/classifyError.js.map +1 -0
  787. package/dist/surfacing/coalesce.js +2 -1
  788. package/dist/surfacing/coalesce.js.map +1 -1
  789. package/dist/surfacing/coldBudget.js +60 -0
  790. package/dist/surfacing/coldBudget.js.map +1 -0
  791. package/dist/surfacing/collectionCacheStore.js +183 -0
  792. package/dist/surfacing/collectionCacheStore.js.map +1 -0
  793. package/dist/surfacing/engine.d.ts +1 -1
  794. package/dist/surfacing/engine.js +514 -72
  795. package/dist/surfacing/engine.js.map +1 -1
  796. package/dist/surfacing/epoch.js +70 -26
  797. package/dist/surfacing/epoch.js.map +1 -1
  798. package/dist/surfacing/lanes.d.ts +1 -0
  799. package/dist/surfacing/lanes.js +297 -0
  800. package/dist/surfacing/lanes.js.map +1 -0
  801. package/dist/surfacing/memo.js +40 -0
  802. package/dist/surfacing/memo.js.map +1 -0
  803. package/dist/surfacing/rateLimiter.d.ts +1 -0
  804. package/dist/surfacing/rateLimiter.js +69 -94
  805. package/dist/surfacing/rateLimiter.js.map +1 -1
  806. package/dist/surfacing/rebucket.js +178 -0
  807. package/dist/surfacing/rebucket.js.map +1 -0
  808. package/dist/surfacing/recipe.js +28 -0
  809. package/dist/surfacing/recipe.js.map +1 -0
  810. package/dist/surfacing/shape.js +22 -0
  811. package/dist/surfacing/shape.js.map +1 -0
  812. package/dist/surfacing/todaySplit.js +113 -0
  813. package/dist/surfacing/todaySplit.js.map +1 -0
  814. package/dist/sync/collection.d.ts +8 -0
  815. package/dist/sync/collection.js +28 -18
  816. package/dist/sync/collection.js.map +1 -1
  817. package/dist/sync/rekeyDurations.js +70 -0
  818. package/dist/sync/rekeyDurations.js.map +1 -0
  819. package/dist/sync/syncTask.js +226 -109
  820. package/dist/sync/syncTask.js.map +1 -1
  821. package/dist/testing/memoryAdapter.d.ts +6 -3
  822. package/dist/testing/memoryAdapter.js +12 -10
  823. package/dist/testing/memoryAdapter.js.map +1 -1
  824. package/dist/testing/settle.d.ts +11 -0
  825. package/dist/testing/settle.js +19 -0
  826. package/dist/testing/settle.js.map +1 -0
  827. package/dist/timeframe/calendar.js +65 -0
  828. package/dist/timeframe/calendar.js.map +1 -0
  829. package/dist/timeframe/comparison.js +46 -0
  830. package/dist/timeframe/comparison.js.map +1 -0
  831. package/dist/timeframe/presets.d.ts +1 -1
  832. package/dist/timeframe/presets.js +5 -5
  833. package/dist/timeframe/presets.js.map +1 -1
  834. package/dist/timeframe/reportingTimezone.d.ts +1 -0
  835. package/dist/timeframe/reportingTimezone.js +64 -0
  836. package/dist/timeframe/reportingTimezone.js.map +1 -0
  837. package/dist/timeframe/tz.js +55 -39
  838. package/dist/timeframe/tz.js.map +1 -1
  839. package/dist/tracker/autoCapture.js +125 -38
  840. package/dist/tracker/autoCapture.js.map +1 -1
  841. package/dist/tracker/campaign.js +52 -0
  842. package/dist/tracker/campaign.js.map +1 -0
  843. package/dist/tracker/config.d.ts +149 -0
  844. package/dist/tracker/config.js +25 -0
  845. package/dist/tracker/config.js.map +1 -0
  846. package/dist/tracker/createTracker.d.ts +4 -10
  847. package/dist/tracker/createTracker.js +386 -115
  848. package/dist/tracker/createTracker.js.map +1 -1
  849. package/dist/tracker/digest.js +28 -0
  850. package/dist/tracker/digest.js.map +1 -0
  851. package/dist/tracker/engagement.js +100 -0
  852. package/dist/tracker/engagement.js.map +1 -0
  853. package/dist/tracker/events.js +37 -0
  854. package/dist/tracker/events.js.map +1 -0
  855. package/dist/tracker/exclusion.d.ts +2 -22
  856. package/dist/tracker/exclusion.js +53 -21
  857. package/dist/tracker/exclusion.js.map +1 -1
  858. package/dist/tracker/gate.js +194 -0
  859. package/dist/tracker/gate.js.map +1 -0
  860. package/dist/tracker/initTracker.d.ts +5 -8
  861. package/dist/tracker/initTracker.js +42 -14
  862. package/dist/tracker/initTracker.js.map +1 -1
  863. package/dist/tracker/itemCapture.js +224 -0
  864. package/dist/tracker/itemCapture.js.map +1 -0
  865. package/dist/tracker/loadScript.js +21 -14
  866. package/dist/tracker/loadScript.js.map +1 -1
  867. package/dist/tracker/pageTracking.js +6 -6
  868. package/dist/tracker/pageTracking.js.map +1 -1
  869. package/dist/tracker/registry.js +118 -30
  870. package/dist/tracker/registry.js.map +1 -1
  871. package/dist/tracker/sinks/createSink.js +41 -0
  872. package/dist/tracker/sinks/createSink.js.map +1 -0
  873. package/dist/tracker/sinks/ga4.js +64 -20
  874. package/dist/tracker/sinks/ga4.js.map +1 -1
  875. package/dist/tracker/sinks/native.js +7 -42
  876. package/dist/tracker/sinks/native.js.map +1 -1
  877. package/dist/tracker/sinks/plausible.js +27 -22
  878. package/dist/tracker/sinks/plausible.js.map +1 -1
  879. package/dist/tracker/sinks/posthog.js +54 -22
  880. package/dist/tracker/sinks/posthog.js.map +1 -1
  881. package/dist/tracker/sinks/umami.js +14 -12
  882. package/dist/tracker/sinks/umami.js.map +1 -1
  883. package/dist/tracker/sinks/vendor.js +30 -27
  884. package/dist/tracker/sinks/vendor.js.map +1 -1
  885. package/dist/tracker/skip.js +81 -0
  886. package/dist/tracker/skip.js.map +1 -0
  887. package/dist/tracker/storage.js +23 -0
  888. package/dist/tracker/storage.js.map +1 -0
  889. package/dist/tracker/transport.js +2 -5
  890. package/dist/tracker/transport.js.map +1 -1
  891. package/dist/tracker/types.d.ts +86 -63
  892. package/dist/tracker/window.js +7 -0
  893. package/dist/tracker/window.js.map +1 -0
  894. package/dist/translations/ar.js +232 -71
  895. package/dist/translations/ar.js.map +1 -1
  896. package/dist/translations/de.js +221 -69
  897. package/dist/translations/de.js.map +1 -1
  898. package/dist/translations/en.js +215 -67
  899. package/dist/translations/en.js.map +1 -1
  900. package/dist/translations/es.js +223 -68
  901. package/dist/translations/es.js.map +1 -1
  902. package/dist/translations/fr.js +227 -72
  903. package/dist/translations/fr.js.map +1 -1
  904. package/dist/translations/id.js +218 -67
  905. package/dist/translations/id.js.map +1 -1
  906. package/dist/translations/index.d.ts +1 -1
  907. package/dist/translations/index.js +5 -7
  908. package/dist/translations/index.js.map +1 -1
  909. package/dist/translations/intl.js +71 -0
  910. package/dist/translations/intl.js.map +1 -0
  911. package/dist/translations/keys.d.ts +191 -14
  912. package/dist/translations/keys.js +196 -14
  913. package/dist/translations/keys.js.map +1 -1
  914. package/dist/translations/ko.js +220 -69
  915. package/dist/translations/ko.js.map +1 -1
  916. package/dist/translations/labelMap.d.ts +10 -0
  917. package/dist/translations/labelMap.js +22 -0
  918. package/dist/translations/labelMap.js.map +1 -0
  919. package/dist/translations/metricKeys.js +10 -2
  920. package/dist/translations/metricKeys.js.map +1 -1
  921. package/dist/translations/parts.js +20 -0
  922. package/dist/translations/parts.js.map +1 -0
  923. package/dist/translations/plural.js +61 -0
  924. package/dist/translations/plural.js.map +1 -0
  925. package/dist/translations/pt.js +232 -77
  926. package/dist/translations/pt.js.map +1 -1
  927. package/dist/translations/ru.js +223 -66
  928. package/dist/translations/ru.js.map +1 -1
  929. package/dist/translations/server.d.ts +1 -0
  930. package/dist/translations/server.js +2 -3
  931. package/dist/translations/server.js.map +1 -1
  932. package/dist/translations/staticLabel.js +69 -0
  933. package/dist/translations/staticLabel.js.map +1 -0
  934. package/dist/translations/uk.js +223 -66
  935. package/dist/translations/uk.js.map +1 -1
  936. package/dist/translations/zh.js +218 -67
  937. package/dist/translations/zh.js.map +1 -1
  938. package/dist/ui/RangePicker.js +112 -0
  939. package/dist/ui/RangePicker.js.map +1 -0
  940. package/dist/ui/analytics.css +1533 -0
  941. package/dist/ui/calendarDays.js +27 -0
  942. package/dist/ui/calendarDays.js.map +1 -0
  943. package/dist/ui/classNames.js +7 -0
  944. package/dist/ui/classNames.js.map +1 -0
  945. package/dist/ui/components/Card.d.ts +28 -0
  946. package/dist/ui/components/Card.js +21 -0
  947. package/dist/ui/components/Card.js.map +1 -0
  948. package/dist/ui/components/ChartDataTable.d.ts +41 -0
  949. package/dist/ui/components/ChartDataTable.js +48 -0
  950. package/dist/ui/components/ChartDataTable.js.map +1 -0
  951. package/dist/ui/components/DataTable.d.ts +82 -0
  952. package/dist/ui/components/DataTable.js +214 -0
  953. package/dist/ui/components/DataTable.js.map +1 -0
  954. package/dist/ui/components/LabeledSelect.js +62 -0
  955. package/dist/ui/components/LabeledSelect.js.map +1 -0
  956. package/dist/ui/components/LiveAnnouncement.js +21 -0
  957. package/dist/ui/components/LiveAnnouncement.js.map +1 -0
  958. package/dist/ui/components/MetricCard.d.ts +38 -0
  959. package/dist/ui/components/MetricCard.js +39 -0
  960. package/dist/ui/components/MetricCard.js.map +1 -0
  961. package/dist/ui/components/NoValue.js +22 -0
  962. package/dist/ui/components/NoValue.js.map +1 -0
  963. package/dist/ui/components/ReadState.js +27 -0
  964. package/dist/ui/components/ReadState.js.map +1 -0
  965. package/dist/ui/components/RefreshButton.js +26 -0
  966. package/dist/ui/components/RefreshButton.js.map +1 -0
  967. package/dist/ui/components/SourcesNoticeBanner.js +20 -0
  968. package/dist/ui/components/SourcesNoticeBanner.js.map +1 -0
  969. package/dist/ui/cssVars.js +7 -0
  970. package/dist/ui/cssVars.js.map +1 -0
  971. package/dist/ui/data/WithScopeToken.d.ts +20 -0
  972. package/dist/ui/data/WithScopeToken.js +20 -0
  973. package/dist/ui/data/WithScopeToken.js.map +1 -0
  974. package/dist/ui/data/clientFieldProps.js +16 -0
  975. package/dist/ui/data/clientFieldProps.js.map +1 -0
  976. package/dist/ui/data/request.d.ts +46 -0
  977. package/dist/ui/data/request.js +119 -0
  978. package/dist/ui/data/request.js.map +1 -0
  979. package/dist/ui/data/scopeTokenContext.js +18 -0
  980. package/dist/ui/data/scopeTokenContext.js.map +1 -0
  981. package/dist/ui/data/sharedCache.js +48 -0
  982. package/dist/ui/data/sharedCache.js.map +1 -0
  983. package/dist/ui/data/useRequest.d.ts +19 -0
  984. package/dist/ui/data/useRequest.js +123 -0
  985. package/dist/ui/data/useRequest.js.map +1 -0
  986. package/dist/ui/data/useRequestScope.js +25 -0
  987. package/dist/ui/data/useRequestScope.js.map +1 -0
  988. package/dist/ui/hooks/useDirection.js +47 -0
  989. package/dist/ui/hooks/useDirection.js.map +1 -0
  990. package/dist/ui/hooks/useDismissOnEscape.js +25 -0
  991. package/dist/ui/hooks/useDismissOnEscape.js.map +1 -0
  992. package/dist/ui/hooks/useLiveAnnouncement.js +57 -0
  993. package/dist/ui/hooks/useLiveAnnouncement.js.map +1 -0
  994. package/dist/ui/hooks/useRealtimePoll.js +112 -0
  995. package/dist/ui/hooks/useRealtimePoll.js.map +1 -0
  996. package/dist/ui/readState.js +19 -0
  997. package/dist/ui/readState.js.map +1 -0
  998. package/dist/ui/rows/toDisplayRows.js +49 -0
  999. package/dist/ui/rows/toDisplayRows.js.map +1 -0
  1000. package/dist/ui/viewerClock.js +7 -0
  1001. package/dist/ui/viewerClock.js.map +1 -0
  1002. package/dist/view/AnalyticsNavLink.d.ts +5 -3
  1003. package/dist/view/AnalyticsNavLink.js +11 -6
  1004. package/dist/view/AnalyticsNavLink.js.map +1 -1
  1005. package/dist/view/AnalyticsView.d.ts +8 -10
  1006. package/dist/view/AnalyticsView.js +47 -18
  1007. package/dist/view/AnalyticsView.js.map +1 -1
  1008. package/dist/view/AnalyticsViewClient.d.ts +4 -7
  1009. package/dist/view/AnalyticsViewClient.js +15 -229
  1010. package/dist/view/AnalyticsViewClient.js.map +1 -1
  1011. package/dist/view/CountryFlag.d.ts +27 -0
  1012. package/dist/view/CountryFlag.js +44 -0
  1013. package/dist/view/CountryFlag.js.map +1 -0
  1014. package/dist/view/DocumentTitle.js +27 -0
  1015. package/dist/view/DocumentTitle.js.map +1 -0
  1016. package/dist/view/ViewRoot.d.ts +21 -0
  1017. package/dist/view/ViewRoot.js +152 -0
  1018. package/dist/view/ViewRoot.js.map +1 -0
  1019. package/dist/view/ViewSections.d.ts +38 -0
  1020. package/dist/view/ViewSections.js +190 -0
  1021. package/dist/view/ViewSections.js.map +1 -0
  1022. package/dist/view/authRedirect.js +2 -4
  1023. package/dist/view/authRedirect.js.map +1 -1
  1024. package/dist/view/conversionRate.js +9 -7
  1025. package/dist/view/conversionRate.js.map +1 -1
  1026. package/dist/view/dayRange.js +6 -10
  1027. package/dist/view/dayRange.js.map +1 -1
  1028. package/dist/view/exclusionLink.d.ts +27 -0
  1029. package/dist/view/exclusionLink.js +46 -0
  1030. package/dist/view/exclusionLink.js.map +1 -0
  1031. package/dist/view/flagSrc.js +14 -0
  1032. package/dist/view/flagSrc.js.map +1 -0
  1033. package/dist/view/gating.d.ts +15 -1
  1034. package/dist/view/gating.js +66 -31
  1035. package/dist/view/gating.js.map +1 -1
  1036. package/dist/view/hostCountryFlag.js +41 -0
  1037. package/dist/view/hostCountryFlag.js.map +1 -0
  1038. package/dist/view/labels.js +95 -10
  1039. package/dist/view/labels.js.map +1 -1
  1040. package/dist/view/metricAliases.js +10 -0
  1041. package/dist/view/metricAliases.js.map +1 -0
  1042. package/dist/view/navLabel.js +15 -0
  1043. package/dist/view/navLabel.js.map +1 -0
  1044. package/dist/view/registerView.js +13 -11
  1045. package/dist/view/registerView.js.map +1 -1
  1046. package/dist/view/scopeLabel.js +21 -0
  1047. package/dist/view/scopeLabel.js.map +1 -0
  1048. package/dist/view/sections/Breakdowns.js +196 -134
  1049. package/dist/view/sections/Breakdowns.js.map +1 -1
  1050. package/dist/view/sections/EmptyStates.js +118 -30
  1051. package/dist/view/sections/EmptyStates.js.map +1 -1
  1052. package/dist/view/sections/ExcludeBrowser.js +188 -0
  1053. package/dist/view/sections/ExcludeBrowser.js.map +1 -0
  1054. package/dist/view/sections/FilterChips.js +124 -27
  1055. package/dist/view/sections/FilterChips.js.map +1 -1
  1056. package/dist/view/sections/GoalsPanel.js +68 -60
  1057. package/dist/view/sections/GoalsPanel.js.map +1 -1
  1058. package/dist/view/sections/OverviewCards.js +29 -33
  1059. package/dist/view/sections/OverviewCards.js.map +1 -1
  1060. package/dist/view/sections/RealtimeStrip.js +70 -59
  1061. package/dist/view/sections/RealtimeStrip.js.map +1 -1
  1062. package/dist/view/sections/SectionBoundary.js +34 -0
  1063. package/dist/view/sections/SectionBoundary.js.map +1 -0
  1064. package/dist/view/sections/Toolbar.d.ts +11 -0
  1065. package/dist/view/sections/Toolbar.js +123 -82
  1066. package/dist/view/sections/Toolbar.js.map +1 -1
  1067. package/dist/view/sections/Trend.js +176 -76
  1068. package/dist/view/sections/Trend.js.map +1 -1
  1069. package/dist/view/state.d.ts +42 -0
  1070. package/dist/view/state.js +93 -54
  1071. package/dist/view/state.js.map +1 -1
  1072. package/dist/view/useViewClock.js +31 -0
  1073. package/dist/view/useViewClock.js.map +1 -0
  1074. package/dist/view/useViewQueries.d.ts +21 -0
  1075. package/dist/view/useViewQueries.js +45 -77
  1076. package/dist/view/useViewQueries.js.map +1 -1
  1077. package/dist/view/useViewState.js +42 -0
  1078. package/dist/view/useViewState.js.map +1 -0
  1079. package/dist/view/useViewUrl.js +47 -0
  1080. package/dist/view/useViewUrl.js.map +1 -0
  1081. package/dist/view/viewBody.js +30 -0
  1082. package/dist/view/viewBody.js.map +1 -0
  1083. package/dist/view/viewContext.d.ts +81 -0
  1084. package/dist/view/viewContext.js +49 -0
  1085. package/dist/view/viewContext.js.map +1 -0
  1086. package/dist/view/viewProps.d.ts +65 -8
  1087. package/dist/view/viewProps.js +123 -36
  1088. package/dist/view/viewProps.js.map +1 -1
  1089. package/dist/widgets/AnalyticsBreakdownWidget.d.ts +7 -3
  1090. package/dist/widgets/AnalyticsBreakdownWidget.js +144 -118
  1091. package/dist/widgets/AnalyticsBreakdownWidget.js.map +1 -1
  1092. package/dist/widgets/AnalyticsGoalsWidget.d.ts +6 -7
  1093. package/dist/widgets/AnalyticsGoalsWidget.js +125 -167
  1094. package/dist/widgets/AnalyticsGoalsWidget.js.map +1 -1
  1095. package/dist/widgets/AnalyticsMetricWidget.d.ts +7 -3
  1096. package/dist/widgets/AnalyticsMetricWidget.js +81 -106
  1097. package/dist/widgets/AnalyticsMetricWidget.js.map +1 -1
  1098. package/dist/widgets/AnalyticsRealtimeWidget.d.ts +7 -3
  1099. package/dist/widgets/AnalyticsRealtimeWidget.js +81 -63
  1100. package/dist/widgets/AnalyticsRealtimeWidget.js.map +1 -1
  1101. package/dist/widgets/AnalyticsTrendWidget.d.ts +7 -3
  1102. package/dist/widgets/AnalyticsTrendWidget.js +130 -123
  1103. package/dist/widgets/AnalyticsTrendWidget.js.map +1 -1
  1104. package/dist/widgets/ComparisonDelta.js +33 -42
  1105. package/dist/widgets/ComparisonDelta.js.map +1 -1
  1106. package/dist/widgets/RealtimeCounter.d.ts +24 -4
  1107. package/dist/widgets/RealtimeCounter.js +91 -77
  1108. package/dist/widgets/RealtimeCounter.js.map +1 -1
  1109. package/dist/widgets/WidgetCard.d.ts +80 -0
  1110. package/dist/widgets/WidgetCard.js +99 -0
  1111. package/dist/widgets/WidgetCard.js.map +1 -0
  1112. package/dist/widgets/WidgetFrame.js +42 -0
  1113. package/dist/widgets/WidgetFrame.js.map +1 -0
  1114. package/dist/widgets/WidgetShimmer.d.ts +55 -0
  1115. package/dist/widgets/WidgetShimmer.js +86 -0
  1116. package/dist/widgets/WidgetShimmer.js.map +1 -0
  1117. package/dist/widgets/breakdownTypes.js +12 -2
  1118. package/dist/widgets/breakdownTypes.js.map +1 -1
  1119. package/dist/widgets/customWidget.d.ts +5 -1
  1120. package/dist/widgets/customWidget.js +6 -7
  1121. package/dist/widgets/customWidget.js.map +1 -1
  1122. package/dist/widgets/defaultLayout.d.ts +26 -0
  1123. package/dist/widgets/defaultLayout.js +51 -0
  1124. package/dist/widgets/defaultLayout.js.map +1 -0
  1125. package/dist/widgets/defaults.d.ts +4 -7
  1126. package/dist/widgets/defaults.js +4 -7
  1127. package/dist/widgets/defaults.js.map +1 -1
  1128. package/dist/widgets/fieldRows.js +14 -0
  1129. package/dist/widgets/fieldRows.js.map +1 -0
  1130. package/dist/widgets/filterCaption.js +6 -7
  1131. package/dist/widgets/filterCaption.js.map +1 -1
  1132. package/dist/widgets/filterField.d.ts +3 -7
  1133. package/dist/widgets/filterField.js +46 -35
  1134. package/dist/widgets/filterField.js.map +1 -1
  1135. package/dist/widgets/filterValueLabel.d.ts +1 -0
  1136. package/dist/widgets/filterValueLabel.js +45 -0
  1137. package/dist/widgets/filterValueLabel.js.map +1 -0
  1138. package/dist/widgets/notices.js +74 -0
  1139. package/dist/widgets/notices.js.map +1 -0
  1140. package/dist/widgets/prepareWidgetRead.d.ts +19 -2
  1141. package/dist/widgets/prepareWidgetRead.js +63 -27
  1142. package/dist/widgets/prepareWidgetRead.js.map +1 -1
  1143. package/dist/widgets/range.js +26 -21
  1144. package/dist/widgets/range.js.map +1 -1
  1145. package/dist/widgets/readForWidget.d.ts +28 -19
  1146. package/dist/widgets/readForWidget.js +33 -29
  1147. package/dist/widgets/readForWidget.js.map +1 -1
  1148. package/dist/widgets/readForWidgetBreakdown.d.ts +40 -29
  1149. package/dist/widgets/readForWidgetBreakdown.js +48 -22
  1150. package/dist/widgets/readForWidgetBreakdown.js.map +1 -1
  1151. package/dist/widgets/readForWidgetGoals.d.ts +18 -24
  1152. package/dist/widgets/readForWidgetGoals.js +52 -46
  1153. package/dist/widgets/readForWidgetGoals.js.map +1 -1
  1154. package/dist/widgets/readForWidgetRealtime.d.ts +22 -17
  1155. package/dist/widgets/readForWidgetRealtime.js +54 -28
  1156. package/dist/widgets/readForWidgetRealtime.js.map +1 -1
  1157. package/dist/widgets/readForWidgetSeries.d.ts +27 -32
  1158. package/dist/widgets/readForWidgetSeries.js +45 -82
  1159. package/dist/widgets/readForWidgetSeries.js.map +1 -1
  1160. package/dist/widgets/readMeta.d.ts +44 -0
  1161. package/dist/widgets/readMeta.js +47 -4
  1162. package/dist/widgets/readMeta.js.map +1 -1
  1163. package/dist/widgets/realtimePoll.d.ts +1 -0
  1164. package/dist/widgets/realtimePoll.js +53 -25
  1165. package/dist/widgets/realtimePoll.js.map +1 -1
  1166. package/dist/widgets/registerWidgets.js +207 -127
  1167. package/dist/widgets/registerWidgets.js.map +1 -1
  1168. package/dist/widgets/stateKeys.js +30 -0
  1169. package/dist/widgets/stateKeys.js.map +1 -0
  1170. package/dist/widgets/titleForecast.js +89 -0
  1171. package/dist/widgets/titleForecast.js.map +1 -0
  1172. package/dist/widgets/types.d.ts +4 -3
  1173. package/dist/widgets/types.js +2 -0
  1174. package/dist/widgets/types.js.map +1 -1
  1175. package/dist/widgets/viewLink.d.ts +24 -6
  1176. package/dist/widgets/viewLink.js +31 -24
  1177. package/dist/widgets/viewLink.js.map +1 -1
  1178. package/dist/widgets/widgetData.js +34 -0
  1179. package/dist/widgets/widgetData.js.map +1 -0
  1180. package/dist/widgets/widgetWindow.d.ts +1 -0
  1181. package/dist/widgets/widgetWindow.js +51 -0
  1182. package/dist/widgets/widgetWindow.js.map +1 -0
  1183. package/package.json +44 -22
  1184. package/dist/adapters/ga4/disableKey.d.ts +0 -9
  1185. package/dist/capture/getTrackerConfig.d.ts +0 -20
  1186. package/dist/capture/getTrackerConfig.js +0 -31
  1187. package/dist/capture/getTrackerConfig.js.map +0 -1
  1188. package/dist/capture/slots.d.ts +0 -8
  1189. package/dist/capture/trackerConfig.d.ts +0 -33
  1190. package/dist/charts/styles.js +0 -59
  1191. package/dist/charts/styles.js.map +0 -1
  1192. package/dist/fields/config/SourceSelectField.d.ts +0 -14
  1193. package/dist/fields/dateRange/styles.js +0 -23
  1194. package/dist/fields/dateRange/styles.js.map +0 -1
  1195. package/dist/goals/GoalSelectField.d.ts +0 -7
  1196. package/dist/native/collections/events.js +0 -165
  1197. package/dist/native/collections/events.js.map +0 -1
  1198. package/dist/native/collections/rollups.js +0 -151
  1199. package/dist/native/collections/rollups.js.map +0 -1
  1200. package/dist/native/collections/seen.js +0 -47
  1201. package/dist/native/collections/seen.js.map +0 -1
  1202. package/dist/native/eventScan.js +0 -25
  1203. package/dist/native/eventScan.js.map +0 -1
  1204. package/dist/native/ingest/flushBatch.js +0 -60
  1205. package/dist/native/ingest/flushBatch.js.map +0 -1
  1206. package/dist/native/ingest/salt.js +0 -39
  1207. package/dist/native/ingest/salt.js.map +0 -1
  1208. package/dist/native/ingest/writeBuffer.js +0 -55
  1209. package/dist/native/ingest/writeBuffer.js.map +0 -1
  1210. package/dist/native/ingest/writeEvent.js +0 -14
  1211. package/dist/native/ingest/writeEvent.js.map +0 -1
  1212. package/dist/native/query/eventAgg.js +0 -175
  1213. package/dist/native/query/eventAgg.js.map +0 -1
  1214. package/dist/native/realtime/buildRealtime.js +0 -53
  1215. package/dist/native/realtime/buildRealtime.js.map +0 -1
  1216. package/dist/native/retention/pruneTask.js +0 -69
  1217. package/dist/native/retention/pruneTask.js.map +0 -1
  1218. package/dist/native/rollupAcc.js +0 -64
  1219. package/dist/native/rollupAcc.js.map +0 -1
  1220. package/dist/native/rollups/bucketKey.js +0 -15
  1221. package/dist/native/rollups/bucketKey.js.map +0 -1
  1222. package/dist/native/rollups/bumpRollups.js +0 -116
  1223. package/dist/native/rollups/bumpRollups.js.map +0 -1
  1224. package/dist/native/rollups/deltas.js +0 -106
  1225. package/dist/native/rollups/deltas.js.map +0 -1
  1226. package/dist/native/rollups/insertManyIfNew.js +0 -93
  1227. package/dist/native/rollups/insertManyIfNew.js.map +0 -1
  1228. package/dist/plugin/paths.js +0 -29
  1229. package/dist/plugin/paths.js.map +0 -1
  1230. package/dist/react/TrackerBoot.d.ts +0 -22
  1231. package/dist/rsc/AnalyticsScripts.d.ts +0 -30
  1232. package/dist/rsc/AnalyticsScripts.js +0 -41
  1233. package/dist/rsc/AnalyticsScripts.js.map +0 -1
  1234. package/dist/surfacing/queue.js +0 -60
  1235. package/dist/surfacing/queue.js.map +0 -1
  1236. package/dist/surfacing/retryPolicy.js +0 -15
  1237. package/dist/surfacing/retryPolicy.js.map +0 -1
  1238. package/dist/tracker/autoCapture.d.ts +0 -48
  1239. package/dist/tracker/consent.d.ts +0 -24
  1240. package/dist/tracker/consent.js +0 -48
  1241. package/dist/tracker/consent.js.map +0 -1
  1242. package/dist/tracker/loadScript.d.ts +0 -14
  1243. package/dist/tracker/pageTracking.d.ts +0 -17
  1244. package/dist/tracker/registry.d.ts +0 -27
  1245. package/dist/tracker/sinks/ga4.d.ts +0 -29
  1246. package/dist/tracker/sinks/native.d.ts +0 -22
  1247. package/dist/tracker/sinks/plausible.d.ts +0 -20
  1248. package/dist/tracker/sinks/posthog.d.ts +0 -18
  1249. package/dist/tracker/sinks/umami.d.ts +0 -18
  1250. package/dist/tracker/sinks/vendor.d.ts +0 -14
  1251. package/dist/view/sections/styles.js +0 -76
  1252. package/dist/view/sections/styles.js.map +0 -1
  1253. package/dist/widgets/WidgetViewLink.js +0 -17
  1254. package/dist/widgets/WidgetViewLink.js.map +0 -1
  1255. package/dist/widgets/cardChrome.d.ts +0 -8
  1256. package/dist/widgets/cardChrome.js +0 -46
  1257. package/dist/widgets/cardChrome.js.map +0 -1
  1258. package/dist/widgets/comparison.js +0 -57
  1259. package/dist/widgets/comparison.js.map +0 -1
@@ -0,0 +1,68 @@
1
+ import { isRecord } from "../../core/values.js";
2
+ import { TASK_SLUGS } from "../../core/jobs.js";
3
+ import { DAY_LEASE_MS, MAINTAIN_LEASE_NAME } from "../store/state.js";
4
+ import { leaseHeld } from "../../maintenance/lease.js";
5
+ import { concurrencyFor, scheduleFor, stuckJobGuard } from "../../maintenance/taskSchedule.js";
6
+ import { checkRebuildInput } from "../engine/rebuild.js";
7
+ //#region src/native/tasks/maintainTask.ts
8
+ const MAINTAIN_TASK_SLUG = TASK_SLUGS.maintain;
9
+ /** How long one run of the task works before it leaves the rest to the next. */
10
+ const MAINTAIN_TASK_BUDGET_MS = 24e4;
11
+ /**
12
+ * Marks a killed run failed, then Payload's own rule: no second run while one is queued or
13
+ * processing. A run renewing the maintenance lease is alive however long its job has run.
14
+ */
15
+ const beforeMaintainSchedule = stuckJobGuard({
16
+ slug: MAINTAIN_TASK_SLUG,
17
+ deadAfterMs: MAINTAIN_TASK_BUDGET_MS + DAY_LEASE_MS,
18
+ alive: (req) => leaseHeld(req.payload, MAINTAIN_LEASE_NAME)
19
+ });
20
+ const refuse = (message) => {
21
+ throw new Error(`analytics: the ${MAINTAIN_TASK_SLUG} task's ${message}`);
22
+ };
23
+ const instantOf = (value, name) => {
24
+ const date = value instanceof Date ? value : typeof value === "string" ? new Date(value) : null;
25
+ return date !== null && !Number.isNaN(date.getTime()) ? date : refuse(`rebuild.${name} must be an ISO instant`);
26
+ };
27
+ /** The task's input checked: a rebuild needs two instants, and anything malformed fails the job. */
28
+ const parseMaintainInput = (input) => {
29
+ if (input === void 0 || input === null) return {};
30
+ if (!isRecord(input) || Array.isArray(input)) return refuse("input must be an object such as { rebuild: { from, to } }");
31
+ const { rebuild } = input;
32
+ if (rebuild === void 0 || rebuild === null) return {};
33
+ if (!isRecord(rebuild) || Array.isArray(rebuild)) return refuse("rebuild must be an object such as { from, to }");
34
+ const { scope, reclassify } = rebuild;
35
+ if (scope !== void 0 && typeof scope !== "string") refuse("rebuild.scope must be a scope id");
36
+ if (reclassify !== void 0 && typeof reclassify !== "boolean") refuse("rebuild.reclassify must be true or false");
37
+ return { rebuild: checkRebuildInput({
38
+ from: instantOf(rebuild.from, "from"),
39
+ to: instantOf(rebuild.to, "to"),
40
+ ...typeof scope === "string" ? { scope } : {},
41
+ ...typeof reclassify === "boolean" ? { reclassify } : {}
42
+ }) };
43
+ };
44
+ /**
45
+ * The concurrency key of a run: `analytics:maintain` for upkeep, and one per rebuild window, so a
46
+ * scheduled run never replaces a rebuild someone queued.
47
+ */
48
+ const maintainKey = (input) => {
49
+ const rebuild = isRecord(input) ? input.rebuild : void 0;
50
+ if (!isRecord(rebuild)) return "analytics:maintain";
51
+ const part = (value) => value instanceof Date ? value.toISOString() : typeof value === "string" ? value : "";
52
+ return `analytics:maintain:rebuild:${part(rebuild.scope)}:${part(rebuild.from)}:${part(rebuild.to)}`;
53
+ };
54
+ /**
55
+ * Never retried: the next run carries on. The leases a run takes, not Payload's concurrency keys,
56
+ * keep two runs from doing the work twice.
57
+ */
58
+ const maintainTask = (args) => ({
59
+ slug: MAINTAIN_TASK_SLUG,
60
+ retries: 0,
61
+ handler: async ({ input, req }) => ({ output: await args.run(req, parseMaintainInput(input)) }),
62
+ ...scheduleFor(args.schedule, beforeMaintainSchedule),
63
+ ...concurrencyFor("maintain", args.concurrency === true, maintainKey)
64
+ });
65
+ //#endregion
66
+ export { MAINTAIN_TASK_BUDGET_MS, MAINTAIN_TASK_SLUG, maintainTask };
67
+
68
+ //# sourceMappingURL=maintainTask.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"maintainTask.js","names":[],"sources":["../../../src/native/tasks/maintainTask.ts"],"sourcesContent":["import type { PayloadRequest, TaskConfig } from 'payload'\nimport { type ScheduledTask, TASK_SLUGS } from '../../core/jobs'\nimport { isRecord } from '../../core/values'\nimport { leaseHeld } from '../../maintenance/lease'\nimport {\n\ttype BeforeSchedule,\n\tconcurrencyFor,\n\tscheduleFor,\n\tstuckJobGuard,\n} from '../../maintenance/taskSchedule'\nimport type { MaintainReport } from '../engine/maintenance'\nimport { checkRebuildInput, type RebuildDaysInput } from '../engine/rebuild'\nimport { DAY_LEASE_MS, MAINTAIN_LEASE_NAME } from '../store/state'\n\nexport const MAINTAIN_TASK_SLUG = TASK_SLUGS.maintain\n\n/** How long one run of the task works before it leaves the rest to the next. */\nexport const MAINTAIN_TASK_BUDGET_MS = 240_000\n\n/** A run still processing this long after its last update was killed: no live run lasts longer. */\nexport const MAINTAIN_DEAD_AFTER_MS = MAINTAIN_TASK_BUDGET_MS + DAY_LEASE_MS\n\n/**\n * Marks a killed run failed, then Payload's own rule: no second run while one is queued or\n * processing. A run renewing the maintenance lease is alive however long its job has run.\n */\nexport const beforeMaintainSchedule: BeforeSchedule = stuckJobGuard({\n\tslug: MAINTAIN_TASK_SLUG,\n\tdeadAfterMs: MAINTAIN_DEAD_AFTER_MS,\n\talive: (req) => leaseHeld(req.payload, MAINTAIN_LEASE_NAME),\n})\n\n/**\n * The task's input when queued by hand: a stretch of days to count again. A job's input is stored\n * as JSON, so the instants arrive as ISO text whichever way they were queued.\n */\nexport interface MaintainTaskInput {\n\trebuild?: {\n\t\tscope?: string\n\t\tfrom: string | Date\n\t\tto: string | Date\n\t\treclassify?: boolean\n\t}\n}\n\nconst refuse = (message: string): never => {\n\tthrow new Error(`analytics: the ${MAINTAIN_TASK_SLUG} task's ${message}`)\n}\n\nconst instantOf = (value: unknown, name: string): Date => {\n\tconst date = value instanceof Date ? value : typeof value === 'string' ? new Date(value) : null\n\treturn date !== null && !Number.isNaN(date.getTime())\n\t\t? date\n\t\t: refuse(`rebuild.${name} must be an ISO instant`)\n}\n\n/** The task's input checked: a rebuild needs two instants, and anything malformed fails the job. */\nexport const parseMaintainInput = (input: unknown): { rebuild?: RebuildDaysInput } => {\n\tif (input === undefined || input === null) {\n\t\treturn {}\n\t}\n\tif (!isRecord(input) || Array.isArray(input)) {\n\t\treturn refuse('input must be an object such as { rebuild: { from, to } }')\n\t}\n\tconst { rebuild } = input\n\tif (rebuild === undefined || rebuild === null) {\n\t\treturn {}\n\t}\n\tif (!isRecord(rebuild) || Array.isArray(rebuild)) {\n\t\treturn refuse('rebuild must be an object such as { from, to }')\n\t}\n\tconst { scope, reclassify } = rebuild\n\tif (scope !== undefined && typeof scope !== 'string') {\n\t\trefuse('rebuild.scope must be a scope id')\n\t}\n\tif (reclassify !== undefined && typeof reclassify !== 'boolean') {\n\t\trefuse('rebuild.reclassify must be true or false')\n\t}\n\treturn {\n\t\trebuild: checkRebuildInput({\n\t\t\tfrom: instantOf(rebuild.from, 'from'),\n\t\t\tto: instantOf(rebuild.to, 'to'),\n\t\t\t...(typeof scope === 'string' ? { scope } : {}),\n\t\t\t...(typeof reclassify === 'boolean' ? { reclassify } : {}),\n\t\t}),\n\t}\n}\n\n/** What one run did: the engine's upkeep, and the expired read cache entries it deleted. */\nexport interface MaintainTaskOutput extends MaintainReport {\n\tsweptCache: number\n}\n\n/**\n * The concurrency key of a run: `analytics:maintain` for upkeep, and one per rebuild window, so a\n * scheduled run never replaces a rebuild someone queued.\n */\nconst maintainKey = (input: unknown): string => {\n\tconst rebuild = isRecord(input) ? input.rebuild : undefined\n\tif (!isRecord(rebuild)) {\n\t\treturn 'analytics:maintain'\n\t}\n\tconst part = (value: unknown): string =>\n\t\tvalue instanceof Date ? value.toISOString() : typeof value === 'string' ? value : ''\n\treturn `analytics:maintain:rebuild:${part(rebuild.scope)}:${part(rebuild.from)}:${part(rebuild.to)}`\n}\n\n/**\n * Never retried: the next run carries on. The leases a run takes, not Payload's concurrency keys,\n * keep two runs from doing the work twice.\n */\nexport const maintainTask = (args: {\n\tschedule: ScheduledTask\n\trun: (req: PayloadRequest, input: { rebuild?: RebuildDaysInput }) => Promise<MaintainTaskOutput>\n\t/** Host's `jobs.enableConcurrencyControl`, without which Payload refuses a concurrency key. */\n\tconcurrency?: boolean\n}): TaskConfig<{ input: MaintainTaskInput; output: MaintainTaskOutput }> => ({\n\tslug: MAINTAIN_TASK_SLUG,\n\tretries: 0,\n\thandler: async ({ input, req }) => ({ output: await args.run(req, parseMaintainInput(input)) }),\n\t...scheduleFor(args.schedule, beforeMaintainSchedule),\n\t...concurrencyFor('maintain', args.concurrency === true, maintainKey),\n})\n"],"mappings":";;;;;;;AAcA,MAAa,qBAAqB,WAAW;;AAG7C,MAAa,0BAA0B;;;;;AASvC,MAAa,yBAAyC,cAAc;CACnE,MAAM;CACN,aARqC,0BAA0B;CAS/D,QAAQ,QAAQ,UAAU,IAAI,SAAS,mBAAmB;AAC3D,CAAC;AAeD,MAAM,UAAU,YAA2B;CAC1C,MAAM,IAAI,MAAM,kBAAkB,mBAAmB,UAAU,SAAS;AACzE;AAEA,MAAM,aAAa,OAAgB,SAAuB;CACzD,MAAM,OAAO,iBAAiB,OAAO,QAAQ,OAAO,UAAU,WAAW,IAAI,KAAK,KAAK,IAAI;CAC3F,OAAO,SAAS,QAAQ,CAAC,OAAO,MAAM,KAAK,QAAQ,CAAC,IACjD,OACA,OAAO,WAAW,KAAK,wBAAwB;AACnD;;AAGA,MAAa,sBAAsB,UAAmD;CACrF,IAAI,UAAU,KAAA,KAAa,UAAU,MACpC,OAAO,CAAC;CAET,IAAI,CAAC,SAAS,KAAK,KAAK,MAAM,QAAQ,KAAK,GAC1C,OAAO,OAAO,2DAA2D;CAE1E,MAAM,EAAE,YAAY;CACpB,IAAI,YAAY,KAAA,KAAa,YAAY,MACxC,OAAO,CAAC;CAET,IAAI,CAAC,SAAS,OAAO,KAAK,MAAM,QAAQ,OAAO,GAC9C,OAAO,OAAO,gDAAgD;CAE/D,MAAM,EAAE,OAAO,eAAe;CAC9B,IAAI,UAAU,KAAA,KAAa,OAAO,UAAU,UAC3C,OAAO,kCAAkC;CAE1C,IAAI,eAAe,KAAA,KAAa,OAAO,eAAe,WACrD,OAAO,0CAA0C;CAElD,OAAO,EACN,SAAS,kBAAkB;EAC1B,MAAM,UAAU,QAAQ,MAAM,MAAM;EACpC,IAAI,UAAU,QAAQ,IAAI,IAAI;EAC9B,GAAI,OAAO,UAAU,WAAW,EAAE,MAAM,IAAI,CAAC;EAC7C,GAAI,OAAO,eAAe,YAAY,EAAE,WAAW,IAAI,CAAC;CACzD,CAAC,EACF;AACD;;;;;AAWA,MAAM,eAAe,UAA2B;CAC/C,MAAM,UAAU,SAAS,KAAK,IAAI,MAAM,UAAU,KAAA;CAClD,IAAI,CAAC,SAAS,OAAO,GACpB,OAAO;CAER,MAAM,QAAQ,UACb,iBAAiB,OAAO,MAAM,YAAY,IAAI,OAAO,UAAU,WAAW,QAAQ;CACnF,OAAO,8BAA8B,KAAK,QAAQ,KAAK,EAAE,GAAG,KAAK,QAAQ,IAAI,EAAE,GAAG,KAAK,QAAQ,EAAE;AAClG;;;;;AAMA,MAAa,gBAAgB,UAKgD;CAC5E,MAAM;CACN,SAAS;CACT,SAAS,OAAO,EAAE,OAAO,WAAW,EAAE,QAAQ,MAAM,KAAK,IAAI,KAAK,mBAAmB,KAAK,CAAC,EAAE;CAC7F,GAAG,YAAY,KAAK,UAAU,sBAAsB;CACpD,GAAG,eAAe,YAAY,KAAK,gBAAgB,MAAM,WAAW;AACrE"}
@@ -0,0 +1,32 @@
1
+ import { FetchLike } from "../core/fetch.js";
2
+ import { fetch } from "undici";
3
+ import { LookupFunction } from "node:net";
4
+
5
+ //#region src/net/guardedFetch.d.ts
6
+ /** @beta */
7
+ interface GuardedFetchOptions {
8
+ /** Resolves a name for each new connection. Node's own `dns.lookup` unless a test swaps it. */
9
+ lookup?: LookupFunction;
10
+ /** Reaches every address over http or https, private networks included, with no checks at all. */
11
+ allowPrivateNetwork?: boolean;
12
+ /** Where the hint about a local proxy's fake-IP mode goes (see {@link fakeIpHint}). */
13
+ warn?: (message: string) => void;
14
+ /** The clock that hint is limited by; `monotonicMs` unless a test swaps it. */
15
+ now?: () => number;
16
+ }
17
+ /** @beta */
18
+ interface GuardedFetch {
19
+ fetch: FetchLike;
20
+ /** Closes the connection pool once the requests in flight finish. */
21
+ close: () => Promise<void>;
22
+ }
23
+ /**
24
+ * Fetch for adapters built from provider documents: refuses a host resolving to a non-public
25
+ * address, on every connection and redirect hop, with a `HostRefusedError`.
26
+ *
27
+ * @beta
28
+ */
29
+ declare const createGuardedFetch: (options?: GuardedFetchOptions) => GuardedFetch;
30
+ //#endregion
31
+ export { GuardedFetch, GuardedFetchOptions, createGuardedFetch };
32
+ //# sourceMappingURL=guardedFetch.d.ts.map
@@ -0,0 +1,220 @@
1
+ import { HostRefusedError } from "../core/sourceErrors.js";
2
+ import { monotonicMs } from "../core/monotonic.js";
3
+ import { lookup } from "node:dns";
4
+ import ipaddr from "ipaddr.js";
5
+ import { Agent, fetch as fetch$1 } from "undici";
6
+ const REDIRECT_STATUSES = new Set([
7
+ 301,
8
+ 302,
9
+ 303,
10
+ 307,
11
+ 308
12
+ ]);
13
+ const NULL_BODY_STATUSES = new Set([
14
+ 101,
15
+ 103,
16
+ 204,
17
+ 205,
18
+ 304
19
+ ]);
20
+ /** What a hop to another origin keeps: none of these can carry a credential. */
21
+ const CROSS_ORIGIN_HEADERS = new Set([
22
+ "accept",
23
+ "accept-language",
24
+ "content-language",
25
+ "content-type",
26
+ "user-agent"
27
+ ]);
28
+ /**
29
+ * Only a public unicast address is reachable. Loopback, private, link-local, carrier-grade NAT,
30
+ * IPv4-mapped IPv6 and every other special range ipaddr.js knows are refused.
31
+ */
32
+ const isPublicAddress = (ip) => {
33
+ if (!ipaddr.isValid(ip)) return false;
34
+ try {
35
+ return ipaddr.parse(ip).range() === "unicast";
36
+ } catch {
37
+ return false;
38
+ }
39
+ };
40
+ const FAKE_IP_RANGE = ipaddr.IPv4.parseCIDR("198.18.0.0/15");
41
+ /**
42
+ * Whether `ip` is in 198.18.0.0/15, the benchmarking range local proxies such as Clash or Surge
43
+ * hand out in fake-IP mode, written as IPv4 or as IPv4-mapped IPv6.
44
+ */
45
+ const isFakeIpAddress = (ip) => {
46
+ if (!ipaddr.isValid(ip)) return false;
47
+ const parsed = ipaddr.process(ip);
48
+ return parsed instanceof ipaddr.IPv4 && parsed.match(FAKE_IP_RANGE);
49
+ };
50
+ /**
51
+ * A lookup that hands on public addresses only. It runs for every new connection, so a name that
52
+ * answers a public address first and a private one later is refused the second time.
53
+ */
54
+ const guardLookup = (lookup, onRefused) => (hostname, options, callback) => {
55
+ lookup(hostname, options, (err, address, family) => {
56
+ if (err) {
57
+ callback(err, address, family);
58
+ return;
59
+ }
60
+ const addresses = Array.isArray(address) ? address.map((entry) => entry.address) : [address];
61
+ if (addresses.length === 0 || !addresses.every((ip) => isPublicAddress(ip))) {
62
+ onRefused?.(hostname, addresses);
63
+ callback(new HostRefusedError(hostname, "it resolves to a private or reserved address"), address, family);
64
+ return;
65
+ }
66
+ callback(null, address, family);
67
+ });
68
+ };
69
+ /**
70
+ * Explains, at most once per {@link FAKE_IP_HINT_MS}, a refusal into 198.18.0.0/15: most likely a
71
+ * local proxy's fake-IP mode, which only a development machine should let past.
72
+ */
73
+ const fakeIpHint = (warn, now) => {
74
+ let saidAt = null;
75
+ return (hostname, addresses) => {
76
+ const fake = addresses.find(isFakeIpAddress);
77
+ const at = now();
78
+ if (fake === void 0 || saidAt !== null && at - saidAt < 6e4) return;
79
+ saidAt = at;
80
+ warn(`analytics: ${hostname} is refused because it resolves to ${fake}, in 198.18.0.0/15, which looks like a local proxy's fake-IP mode (Clash, Surge). In development, set providers.hosts.allowPrivateNetwork to reach it through the proxy. Logged at most once a minute.`);
81
+ };
82
+ };
83
+ /** The host without an IPv6 literal's brackets, which `URL.hostname` keeps. */
84
+ const literalHost = (url) => url.hostname.startsWith("[") && url.hostname.endsWith("]") ? url.hostname.slice(1, -1) : url.hostname;
85
+ /**
86
+ * What every hop has to pass before it is sent: https, and a host that is not a private address
87
+ * written out. A name is checked at connect time instead, by {@link guardLookup}.
88
+ */
89
+ const assertReachable = (url) => {
90
+ if (url.protocol !== "https:") throw new HostRefusedError(url.host, `${url.protocol} is not https`);
91
+ const host = literalHost(url);
92
+ if (ipaddr.isValid(host) && !isPublicAddress(host)) throw new HostRefusedError(url.host, "it is a private or reserved address");
93
+ };
94
+ const headerRecord = (init) => {
95
+ const record = {};
96
+ new Headers(init).forEach((value, name) => {
97
+ record[name] = value;
98
+ });
99
+ return record;
100
+ };
101
+ const pickHeaders = (headers, keep) => Object.fromEntries(Object.entries(headers).filter(([name]) => keep(name)));
102
+ /**
103
+ * Next hop as fetch would send it: a 303, or a 301/302 answering a POST, becomes a bodiless GET; a
104
+ * hop to another origin drops every header that could carry a credential.
105
+ */
106
+ const nextHop = (hop, status, url) => {
107
+ const headers = url.origin === hop.url.origin ? hop.headers : pickHeaders(hop.headers, (name) => CROSS_ORIGIN_HEADERS.has(name));
108
+ if (!(status === 303 ? hop.method !== "HEAD" : (status === 301 || status === 302) && hop.method === "POST")) return {
109
+ url,
110
+ method: hop.method,
111
+ headers,
112
+ body: hop.body
113
+ };
114
+ return {
115
+ url,
116
+ method: "GET",
117
+ headers: pickHeaders(headers, (name) => !name.startsWith("content-")),
118
+ body: null
119
+ };
120
+ };
121
+ /**
122
+ * Follows at most {@link MAX_REDIRECTS} redirects itself so each hop passes the first's checks.
123
+ * `redirect: 'manual'` hands a redirect back unfollowed, `'error'` refuses it.
124
+ */
125
+ const followRedirects = async (send, input, init = {}) => {
126
+ const mode = init.redirect ?? "follow";
127
+ const signal = init.signal ?? void 0;
128
+ let hop = {
129
+ url: new URL(input),
130
+ method: (init.method ?? "GET").toUpperCase(),
131
+ headers: headerRecord(init.headers),
132
+ body: init.body ?? null
133
+ };
134
+ for (let redirects = 0;; redirects++) {
135
+ assertReachable(hop.url);
136
+ const res = await send(hop, signal);
137
+ const location = res.headers.get("location");
138
+ if (mode === "manual" || !REDIRECT_STATUSES.has(res.status) || location === null) return res;
139
+ await res.body?.cancel();
140
+ if (mode === "error") throw new TypeError(`analytics: ${hop.url.host} answered a redirect`);
141
+ if (redirects >= 3) throw new HostRefusedError(hop.url.host, `it redirected more than 3 times`);
142
+ hop = nextHop(hop, res.status, new URL(location, hop.url));
143
+ }
144
+ };
145
+ /** How deep undici may wrap a lookup's refusal in `cause`s. */
146
+ const MAX_CAUSE_DEPTH = 5;
147
+ /** The refusal behind an undici failure, so callers see the `HostRefusedError` itself. */
148
+ const refusalIn = (err) => {
149
+ let current = err;
150
+ for (let depth = 0; depth < MAX_CAUSE_DEPTH; depth++) {
151
+ if (current instanceof HostRefusedError) return current;
152
+ if (typeof current !== "object" || current === null) return null;
153
+ current = Reflect.get(current, "cause");
154
+ }
155
+ return null;
156
+ };
157
+ const standardBody = (res) => {
158
+ const source = res.body;
159
+ if (source === null || NULL_BODY_STATUSES.has(res.status)) return null;
160
+ const reader = source.getReader();
161
+ return new ReadableStream({
162
+ pull: async (controller) => {
163
+ const chunk = await reader.read();
164
+ if (chunk.done) {
165
+ controller.close();
166
+ return;
167
+ }
168
+ controller.enqueue(chunk.value);
169
+ },
170
+ cancel: (reason) => reader.cancel(reason)
171
+ });
172
+ };
173
+ /** undici's answer as a standard `Response`, its body still streaming. */
174
+ const toStandardResponse = (res) => {
175
+ const headers = new Headers();
176
+ res.headers.forEach((value, name) => {
177
+ headers.append(name, value);
178
+ });
179
+ return new Response(standardBody(res), {
180
+ status: res.status,
181
+ statusText: res.statusText,
182
+ headers
183
+ });
184
+ };
185
+ /**
186
+ * Fetch for adapters built from provider documents: refuses a host resolving to a non-public
187
+ * address, on every connection and redirect hop, with a `HostRefusedError`.
188
+ *
189
+ * @beta
190
+ */
191
+ const createGuardedFetch = (options = {}) => {
192
+ if (options.allowPrivateNetwork === true) return {
193
+ fetch: (input, init) => fetch(input, init),
194
+ close: async () => void 0
195
+ };
196
+ const onRefused = options.warn ? fakeIpHint(options.warn, options.now ?? monotonicMs) : void 0;
197
+ const agent = new Agent({ connect: { lookup: guardLookup(options.lookup ?? lookup, onRefused) } });
198
+ const send = async (hop, signal) => {
199
+ try {
200
+ return toStandardResponse(await fetch$1(hop.url.href, {
201
+ method: hop.method,
202
+ headers: hop.headers,
203
+ body: hop.body,
204
+ redirect: "manual",
205
+ dispatcher: agent,
206
+ ...signal ? { signal } : {}
207
+ }));
208
+ } catch (err) {
209
+ throw refusalIn(err) ?? err;
210
+ }
211
+ };
212
+ return {
213
+ fetch: (input, init) => followRedirects(send, input, init),
214
+ close: () => agent.close()
215
+ };
216
+ };
217
+ //#endregion
218
+ export { createGuardedFetch };
219
+
220
+ //# sourceMappingURL=guardedFetch.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"guardedFetch.js","names":["dnsLookup","undiciFetch"],"sources":["../../src/net/guardedFetch.ts"],"sourcesContent":["import { lookup as dnsLookup } from 'node:dns'\nimport type { LookupFunction } from 'node:net'\nimport ipaddr from 'ipaddr.js'\nimport { Agent, fetch as undiciFetch } from 'undici'\nimport type { FetchInit, FetchLike } from '../core/fetch'\nimport { monotonicMs } from '../core/monotonic'\nimport { HostRefusedError } from '../core/sourceErrors'\n\n/** Redirects followed before a request gives up; every hop is checked like the first. */\nexport const MAX_REDIRECTS = 3\n\nconst REDIRECT_STATUSES: ReadonlySet<number> = new Set([301, 302, 303, 307, 308])\n\nconst NULL_BODY_STATUSES: ReadonlySet<number> = new Set([101, 103, 204, 205, 304])\n\n/** What a hop to another origin keeps: none of these can carry a credential. */\nconst CROSS_ORIGIN_HEADERS: ReadonlySet<string> = new Set([\n\t'accept',\n\t'accept-language',\n\t'content-language',\n\t'content-type',\n\t'user-agent',\n])\n\n/**\n * Only a public unicast address is reachable. Loopback, private, link-local, carrier-grade NAT,\n * IPv4-mapped IPv6 and every other special range ipaddr.js knows are refused.\n */\nexport const isPublicAddress = (ip: string): boolean => {\n\tif (!ipaddr.isValid(ip)) {\n\t\treturn false\n\t}\n\ttry {\n\t\treturn ipaddr.parse(ip).range() === 'unicast'\n\t} catch {\n\t\treturn false\n\t}\n}\n\nconst FAKE_IP_RANGE = ipaddr.IPv4.parseCIDR('198.18.0.0/15')\n\n/**\n * Whether `ip` is in 198.18.0.0/15, the benchmarking range local proxies such as Clash or Surge\n * hand out in fake-IP mode, written as IPv4 or as IPv4-mapped IPv6.\n */\nexport const isFakeIpAddress = (ip: string): boolean => {\n\tif (!ipaddr.isValid(ip)) {\n\t\treturn false\n\t}\n\tconst parsed = ipaddr.process(ip)\n\treturn parsed instanceof ipaddr.IPv4 && parsed.match(FAKE_IP_RANGE)\n}\n\n/** Told the name and every address of each lookup refused. */\ntype OnRefused = (hostname: string, addresses: readonly string[]) => void\n\n/**\n * A lookup that hands on public addresses only. It runs for every new connection, so a name that\n * answers a public address first and a private one later is refused the second time.\n */\nexport const guardLookup =\n\t(lookup: LookupFunction, onRefused?: OnRefused): LookupFunction =>\n\t(hostname, options, callback) => {\n\t\tlookup(hostname, options, (err, address, family) => {\n\t\t\tif (err) {\n\t\t\t\tcallback(err, address, family)\n\t\t\t\treturn\n\t\t\t}\n\t\t\tconst addresses = Array.isArray(address) ? address.map((entry) => entry.address) : [address]\n\t\t\tif (addresses.length === 0 || !addresses.every((ip) => isPublicAddress(ip))) {\n\t\t\t\tonRefused?.(hostname, addresses)\n\t\t\t\tcallback(\n\t\t\t\t\tnew HostRefusedError(hostname, 'it resolves to a private or reserved address'),\n\t\t\t\t\taddress,\n\t\t\t\t\tfamily\n\t\t\t\t)\n\t\t\t\treturn\n\t\t\t}\n\t\t\tcallback(null, address, family)\n\t\t})\n\t}\n\n/** One fake-IP hint at most this often: on such a machine every vendor is refused the same way. */\nexport const FAKE_IP_HINT_MS = 60_000\n\n/**\n * Explains, at most once per {@link FAKE_IP_HINT_MS}, a refusal into 198.18.0.0/15: most likely a\n * local proxy's fake-IP mode, which only a development machine should let past.\n */\nexport const fakeIpHint = (warn: (message: string) => void, now: () => number): OnRefused => {\n\tlet saidAt: number | null = null\n\treturn (hostname, addresses) => {\n\t\tconst fake = addresses.find(isFakeIpAddress)\n\t\tconst at = now()\n\t\tif (fake === undefined || (saidAt !== null && at - saidAt < FAKE_IP_HINT_MS)) {\n\t\t\treturn\n\t\t}\n\t\tsaidAt = at\n\t\twarn(\n\t\t\t`analytics: ${hostname} is refused because it resolves to ${fake}, in 198.18.0.0/15, which looks like a local proxy's fake-IP mode (Clash, Surge). In development, set providers.hosts.allowPrivateNetwork to reach it through the proxy. Logged at most once a minute.`\n\t\t)\n\t}\n}\n\n/** One request of a chain, before redirects are followed. */\nexport interface Hop {\n\turl: URL\n\tmethod: string\n\theaders: Record<string, string>\n\tbody: string | ArrayBuffer | null\n}\n\n/** Sends one hop as it stands, following nothing. */\nexport type SendHop = (hop: Hop, signal?: AbortSignal) => Promise<Response>\n\n/** The host without an IPv6 literal's brackets, which `URL.hostname` keeps. */\nconst literalHost = (url: URL): string =>\n\turl.hostname.startsWith('[') && url.hostname.endsWith(']')\n\t\t? url.hostname.slice(1, -1)\n\t\t: url.hostname\n\n/**\n * What every hop has to pass before it is sent: https, and a host that is not a private address\n * written out. A name is checked at connect time instead, by {@link guardLookup}.\n */\nconst assertReachable = (url: URL): void => {\n\tif (url.protocol !== 'https:') {\n\t\tthrow new HostRefusedError(url.host, `${url.protocol} is not https`)\n\t}\n\tconst host = literalHost(url)\n\tif (ipaddr.isValid(host) && !isPublicAddress(host)) {\n\t\tthrow new HostRefusedError(url.host, 'it is a private or reserved address')\n\t}\n}\n\nconst headerRecord = (init: HeadersInit | undefined): Record<string, string> => {\n\tconst record: Record<string, string> = {}\n\tnew Headers(init).forEach((value, name) => {\n\t\trecord[name] = value\n\t})\n\treturn record\n}\n\nconst pickHeaders = (\n\theaders: Record<string, string>,\n\tkeep: (name: string) => boolean\n): Record<string, string> =>\n\tObject.fromEntries(Object.entries(headers).filter(([name]) => keep(name)))\n\n/**\n * Next hop as fetch would send it: a 303, or a 301/302 answering a POST, becomes a bodiless GET; a\n * hop to another origin drops every header that could carry a credential.\n */\nconst nextHop = (hop: Hop, status: number, url: URL): Hop => {\n\tconst headers =\n\t\turl.origin === hop.url.origin\n\t\t\t? hop.headers\n\t\t\t: pickHeaders(hop.headers, (name) => CROSS_ORIGIN_HEADERS.has(name))\n\tconst toGet =\n\t\tstatus === 303\n\t\t\t? hop.method !== 'HEAD'\n\t\t\t: (status === 301 || status === 302) && hop.method === 'POST'\n\tif (!toGet) {\n\t\treturn { url, method: hop.method, headers, body: hop.body }\n\t}\n\treturn {\n\t\turl,\n\t\tmethod: 'GET',\n\t\theaders: pickHeaders(headers, (name) => !name.startsWith('content-')),\n\t\tbody: null,\n\t}\n}\n\n/**\n * Follows at most {@link MAX_REDIRECTS} redirects itself so each hop passes the first's checks.\n * `redirect: 'manual'` hands a redirect back unfollowed, `'error'` refuses it.\n */\nexport const followRedirects = async (\n\tsend: SendHop,\n\tinput: string | URL,\n\tinit: FetchInit = {}\n): Promise<Response> => {\n\tconst mode = init.redirect ?? 'follow'\n\tconst signal = init.signal ?? undefined\n\tlet hop: Hop = {\n\t\turl: new URL(input),\n\t\tmethod: (init.method ?? 'GET').toUpperCase(),\n\t\theaders: headerRecord(init.headers),\n\t\tbody: init.body ?? null,\n\t}\n\tfor (let redirects = 0; ; redirects++) {\n\t\tassertReachable(hop.url)\n\t\tconst res = await send(hop, signal)\n\t\tconst location = res.headers.get('location')\n\t\tif (mode === 'manual' || !REDIRECT_STATUSES.has(res.status) || location === null) {\n\t\t\treturn res\n\t\t}\n\t\tawait res.body?.cancel()\n\t\tif (mode === 'error') {\n\t\t\tthrow new TypeError(`analytics: ${hop.url.host} answered a redirect`)\n\t\t}\n\t\tif (redirects >= MAX_REDIRECTS) {\n\t\t\tthrow new HostRefusedError(hop.url.host, `it redirected more than ${MAX_REDIRECTS} times`)\n\t\t}\n\t\thop = nextHop(hop, res.status, new URL(location, hop.url))\n\t}\n}\n\n/** How deep undici may wrap a lookup's refusal in `cause`s. */\nconst MAX_CAUSE_DEPTH = 5\n\n/** The refusal behind an undici failure, so callers see the `HostRefusedError` itself. */\nconst refusalIn = (err: unknown): HostRefusedError | null => {\n\tlet current: unknown = err\n\tfor (let depth = 0; depth < MAX_CAUSE_DEPTH; depth++) {\n\t\tif (current instanceof HostRefusedError) {\n\t\t\treturn current\n\t\t}\n\t\tif (typeof current !== 'object' || current === null) {\n\t\t\treturn null\n\t\t}\n\t\tcurrent = Reflect.get(current, 'cause')\n\t}\n\treturn null\n}\n\ntype UndiciResponse = Awaited<ReturnType<typeof undiciFetch>>\n\nconst standardBody = (res: UndiciResponse): ReadableStream<Uint8Array> | null => {\n\tconst source = res.body\n\tif (source === null || NULL_BODY_STATUSES.has(res.status)) {\n\t\treturn null\n\t}\n\tconst reader = source.getReader()\n\treturn new ReadableStream<Uint8Array>({\n\t\tpull: async (controller) => {\n\t\t\tconst chunk = await reader.read()\n\t\t\tif (chunk.done) {\n\t\t\t\tcontroller.close()\n\t\t\t\treturn\n\t\t\t}\n\t\t\tcontroller.enqueue(chunk.value)\n\t\t},\n\t\tcancel: (reason) => reader.cancel(reason),\n\t})\n}\n\n/** undici's answer as a standard `Response`, its body still streaming. */\nexport const toStandardResponse = (res: UndiciResponse): Response => {\n\tconst headers = new Headers()\n\tres.headers.forEach((value, name) => {\n\t\theaders.append(name, value)\n\t})\n\treturn new Response(standardBody(res), {\n\t\tstatus: res.status,\n\t\tstatusText: res.statusText,\n\t\theaders,\n\t})\n}\n\n/** @beta */\nexport interface GuardedFetchOptions {\n\t/** Resolves a name for each new connection. Node's own `dns.lookup` unless a test swaps it. */\n\tlookup?: LookupFunction\n\t/** Reaches every address over http or https, private networks included, with no checks at all. */\n\tallowPrivateNetwork?: boolean\n\t/** Where the hint about a local proxy's fake-IP mode goes (see {@link fakeIpHint}). */\n\twarn?: (message: string) => void\n\t/** The clock that hint is limited by; `monotonicMs` unless a test swaps it. */\n\tnow?: () => number\n}\n\n/** @beta */\nexport interface GuardedFetch {\n\tfetch: FetchLike\n\t/** Closes the connection pool once the requests in flight finish. */\n\tclose: () => Promise<void>\n}\n\n/**\n * Fetch for adapters built from provider documents: refuses a host resolving to a non-public\n * address, on every connection and redirect hop, with a `HostRefusedError`.\n *\n * @beta\n */\nexport const createGuardedFetch = (options: GuardedFetchOptions = {}): GuardedFetch => {\n\tif (options.allowPrivateNetwork === true) {\n\t\treturn { fetch: (input, init) => fetch(input, init), close: async () => undefined }\n\t}\n\tconst onRefused = options.warn ? fakeIpHint(options.warn, options.now ?? monotonicMs) : undefined\n\tconst agent = new Agent({\n\t\tconnect: { lookup: guardLookup(options.lookup ?? dnsLookup, onRefused) },\n\t})\n\tconst send: SendHop = async (hop, signal) => {\n\t\ttry {\n\t\t\tconst res = await undiciFetch(hop.url.href, {\n\t\t\t\tmethod: hop.method,\n\t\t\t\theaders: hop.headers,\n\t\t\t\tbody: hop.body,\n\t\t\t\tredirect: 'manual',\n\t\t\t\tdispatcher: agent,\n\t\t\t\t...(signal ? { signal } : {}),\n\t\t\t})\n\t\t\treturn toStandardResponse(res)\n\t\t} catch (err) {\n\t\t\tthrow refusalIn(err) ?? err\n\t\t}\n\t}\n\treturn {\n\t\tfetch: (input, init) => followRedirects(send, input, init),\n\t\tclose: () => agent.close(),\n\t}\n}\n"],"mappings":";;;;;AAWA,MAAM,oBAAyC,IAAI,IAAI;CAAC;CAAK;CAAK;CAAK;CAAK;AAAG,CAAC;AAEhF,MAAM,qBAA0C,IAAI,IAAI;CAAC;CAAK;CAAK;CAAK;CAAK;AAAG,CAAC;;AAGjF,MAAM,uBAA4C,IAAI,IAAI;CACzD;CACA;CACA;CACA;CACA;AACD,CAAC;;;;;AAMD,MAAa,mBAAmB,OAAwB;CACvD,IAAI,CAAC,OAAO,QAAQ,EAAE,GACrB,OAAO;CAER,IAAI;EACH,OAAO,OAAO,MAAM,EAAE,EAAE,MAAM,MAAM;CACrC,QAAQ;EACP,OAAO;CACR;AACD;AAEA,MAAM,gBAAgB,OAAO,KAAK,UAAU,eAAe;;;;;AAM3D,MAAa,mBAAmB,OAAwB;CACvD,IAAI,CAAC,OAAO,QAAQ,EAAE,GACrB,OAAO;CAER,MAAM,SAAS,OAAO,QAAQ,EAAE;CAChC,OAAO,kBAAkB,OAAO,QAAQ,OAAO,MAAM,aAAa;AACnE;;;;;AASA,MAAa,eACX,QAAwB,eACxB,UAAU,SAAS,aAAa;CAChC,OAAO,UAAU,UAAU,KAAK,SAAS,WAAW;EACnD,IAAI,KAAK;GACR,SAAS,KAAK,SAAS,MAAM;GAC7B;EACD;EACA,MAAM,YAAY,MAAM,QAAQ,OAAO,IAAI,QAAQ,KAAK,UAAU,MAAM,OAAO,IAAI,CAAC,OAAO;EAC3F,IAAI,UAAU,WAAW,KAAK,CAAC,UAAU,OAAO,OAAO,gBAAgB,EAAE,CAAC,GAAG;GAC5E,YAAY,UAAU,SAAS;GAC/B,SACC,IAAI,iBAAiB,UAAU,8CAA8C,GAC7E,SACA,MACD;GACA;EACD;EACA,SAAS,MAAM,SAAS,MAAM;CAC/B,CAAC;AACF;;;;;AASD,MAAa,cAAc,MAAiC,QAAiC;CAC5F,IAAI,SAAwB;CAC5B,QAAQ,UAAU,cAAc;EAC/B,MAAM,OAAO,UAAU,KAAK,eAAe;EAC3C,MAAM,KAAK,IAAI;EACf,IAAI,SAAS,KAAA,KAAc,WAAW,QAAQ,KAAK,SAAA,KAClD;EAED,SAAS;EACT,KACC,cAAc,SAAS,qCAAqC,KAAK,uMAClE;CACD;AACD;;AAcA,MAAM,eAAe,QACpB,IAAI,SAAS,WAAW,GAAG,KAAK,IAAI,SAAS,SAAS,GAAG,IACtD,IAAI,SAAS,MAAM,GAAG,EAAE,IACxB,IAAI;;;;;AAMR,MAAM,mBAAmB,QAAmB;CAC3C,IAAI,IAAI,aAAa,UACpB,MAAM,IAAI,iBAAiB,IAAI,MAAM,GAAG,IAAI,SAAS,cAAc;CAEpE,MAAM,OAAO,YAAY,GAAG;CAC5B,IAAI,OAAO,QAAQ,IAAI,KAAK,CAAC,gBAAgB,IAAI,GAChD,MAAM,IAAI,iBAAiB,IAAI,MAAM,qCAAqC;AAE5E;AAEA,MAAM,gBAAgB,SAA0D;CAC/E,MAAM,SAAiC,CAAC;CACxC,IAAI,QAAQ,IAAI,EAAE,SAAS,OAAO,SAAS;EAC1C,OAAO,QAAQ;CAChB,CAAC;CACD,OAAO;AACR;AAEA,MAAM,eACL,SACA,SAEA,OAAO,YAAY,OAAO,QAAQ,OAAO,EAAE,QAAQ,CAAC,UAAU,KAAK,IAAI,CAAC,CAAC;;;;;AAM1E,MAAM,WAAW,KAAU,QAAgB,QAAkB;CAC5D,MAAM,UACL,IAAI,WAAW,IAAI,IAAI,SACpB,IAAI,UACJ,YAAY,IAAI,UAAU,SAAS,qBAAqB,IAAI,IAAI,CAAC;CAKrE,IAAI,EAHH,WAAW,MACR,IAAI,WAAW,UACd,WAAW,OAAO,WAAW,QAAQ,IAAI,WAAW,SAExD,OAAO;EAAE;EAAK,QAAQ,IAAI;EAAQ;EAAS,MAAM,IAAI;CAAK;CAE3D,OAAO;EACN;EACA,QAAQ;EACR,SAAS,YAAY,UAAU,SAAS,CAAC,KAAK,WAAW,UAAU,CAAC;EACpE,MAAM;CACP;AACD;;;;;AAMA,MAAa,kBAAkB,OAC9B,MACA,OACA,OAAkB,CAAC,MACI;CACvB,MAAM,OAAO,KAAK,YAAY;CAC9B,MAAM,SAAS,KAAK,UAAU,KAAA;CAC9B,IAAI,MAAW;EACd,KAAK,IAAI,IAAI,KAAK;EAClB,SAAS,KAAK,UAAU,OAAO,YAAY;EAC3C,SAAS,aAAa,KAAK,OAAO;EAClC,MAAM,KAAK,QAAQ;CACpB;CACA,KAAK,IAAI,YAAY,IAAK,aAAa;EACtC,gBAAgB,IAAI,GAAG;EACvB,MAAM,MAAM,MAAM,KAAK,KAAK,MAAM;EAClC,MAAM,WAAW,IAAI,QAAQ,IAAI,UAAU;EAC3C,IAAI,SAAS,YAAY,CAAC,kBAAkB,IAAI,IAAI,MAAM,KAAK,aAAa,MAC3E,OAAO;EAER,MAAM,IAAI,MAAM,OAAO;EACvB,IAAI,SAAS,SACZ,MAAM,IAAI,UAAU,cAAc,IAAI,IAAI,KAAK,qBAAqB;EAErE,IAAI,aAAA,GACH,MAAM,IAAI,iBAAiB,IAAI,IAAI,MAAM,iCAAgD;EAE1F,MAAM,QAAQ,KAAK,IAAI,QAAQ,IAAI,IAAI,UAAU,IAAI,GAAG,CAAC;CAC1D;AACD;;AAGA,MAAM,kBAAkB;;AAGxB,MAAM,aAAa,QAA0C;CAC5D,IAAI,UAAmB;CACvB,KAAK,IAAI,QAAQ,GAAG,QAAQ,iBAAiB,SAAS;EACrD,IAAI,mBAAmB,kBACtB,OAAO;EAER,IAAI,OAAO,YAAY,YAAY,YAAY,MAC9C,OAAO;EAER,UAAU,QAAQ,IAAI,SAAS,OAAO;CACvC;CACA,OAAO;AACR;AAIA,MAAM,gBAAgB,QAA2D;CAChF,MAAM,SAAS,IAAI;CACnB,IAAI,WAAW,QAAQ,mBAAmB,IAAI,IAAI,MAAM,GACvD,OAAO;CAER,MAAM,SAAS,OAAO,UAAU;CAChC,OAAO,IAAI,eAA2B;EACrC,MAAM,OAAO,eAAe;GAC3B,MAAM,QAAQ,MAAM,OAAO,KAAK;GAChC,IAAI,MAAM,MAAM;IACf,WAAW,MAAM;IACjB;GACD;GACA,WAAW,QAAQ,MAAM,KAAK;EAC/B;EACA,SAAS,WAAW,OAAO,OAAO,MAAM;CACzC,CAAC;AACF;;AAGA,MAAa,sBAAsB,QAAkC;CACpE,MAAM,UAAU,IAAI,QAAQ;CAC5B,IAAI,QAAQ,SAAS,OAAO,SAAS;EACpC,QAAQ,OAAO,MAAM,KAAK;CAC3B,CAAC;CACD,OAAO,IAAI,SAAS,aAAa,GAAG,GAAG;EACtC,QAAQ,IAAI;EACZ,YAAY,IAAI;EAChB;CACD,CAAC;AACF;;;;;;;AA2BA,MAAa,sBAAsB,UAA+B,CAAC,MAAoB;CACtF,IAAI,QAAQ,wBAAwB,MACnC,OAAO;EAAE,QAAQ,OAAO,SAAS,MAAM,OAAO,IAAI;EAAG,OAAO,YAAY,KAAA;CAAU;CAEnF,MAAM,YAAY,QAAQ,OAAO,WAAW,QAAQ,MAAM,QAAQ,OAAO,WAAW,IAAI,KAAA;CACxF,MAAM,QAAQ,IAAI,MAAM,EACvB,SAAS,EAAE,QAAQ,YAAY,QAAQ,UAAUA,QAAW,SAAS,EAAE,EACxE,CAAC;CACD,MAAM,OAAgB,OAAO,KAAK,WAAW;EAC5C,IAAI;GASH,OAAO,mBAAmB,MARRC,QAAY,IAAI,IAAI,MAAM;IAC3C,QAAQ,IAAI;IACZ,SAAS,IAAI;IACb,MAAM,IAAI;IACV,UAAU;IACV,YAAY;IACZ,GAAI,SAAS,EAAE,OAAO,IAAI,CAAC;GAC5B,CAAC,CAC4B;EAC9B,SAAS,KAAK;GACb,MAAM,UAAU,GAAG,KAAK;EACzB;CACD;CACA,OAAO;EACN,QAAQ,OAAO,SAAS,gBAAgB,MAAM,OAAO,IAAI;EACzD,aAAa,MAAM,MAAM;CAC1B;AACD"}
@@ -0,0 +1,40 @@
1
+ //#region src/net/origin.ts
2
+ const urlOf = (value) => {
3
+ try {
4
+ return new URL(value.trim());
5
+ } catch {
6
+ return null;
7
+ }
8
+ };
9
+ const isHttp = (url) => url.protocol === "https:" || url.protocol === "http:";
10
+ /** `value` as an http(s) URL with no credentials, query or fragment; http only with `allowHttp`. */
11
+ const parseHttpUrl = (value, allowHttp) => {
12
+ const url = urlOf(value);
13
+ if (!url) return { problem: "format" };
14
+ if (url.protocol === "http:" && !allowHttp) return { problem: "insecure" };
15
+ if (!isHttp(url)) return { problem: "format" };
16
+ if (url.username || url.password || url.search || url.hash) return { problem: "format" };
17
+ return url;
18
+ };
19
+ /**
20
+ * The origin `value` names when it is nothing but one: a scheme, a host and maybe a port, with no
21
+ * credentials, path, query, fragment or wildcard. `http` only when `allowHttp`.
22
+ */
23
+ const parseOrigin = (value, allowHttp) => {
24
+ if (value.includes("*")) return { problem: "format" };
25
+ const url = parseHttpUrl(value, allowHttp);
26
+ if (!(url instanceof URL)) return url;
27
+ return url.pathname === "/" ? { origin: url.origin } : { problem: "format" };
28
+ };
29
+ /**
30
+ * An origin as a browser writes `Origin`: lowercased, default port dropped. Null for anything not
31
+ * http(s), the literal `null` of an opaque document included.
32
+ */
33
+ const normalizeOrigin = (value) => {
34
+ const url = urlOf(value);
35
+ return url && isHttp(url) ? url.origin : null;
36
+ };
37
+ //#endregion
38
+ export { normalizeOrigin, parseHttpUrl, parseOrigin };
39
+
40
+ //# sourceMappingURL=origin.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"origin.js","names":[],"sources":["../../src/net/origin.ts"],"sourcesContent":["/** Why a value is not an address the plugin accepts: malformed, or http where https is due. */\nexport type OriginProblem = 'format' | 'insecure'\n\nconst urlOf = (value: string): URL | null => {\n\ttry {\n\t\treturn new URL(value.trim())\n\t} catch {\n\t\treturn null\n\t}\n}\n\nconst isHttp = (url: URL): boolean => url.protocol === 'https:' || url.protocol === 'http:'\n\n/** `value` as an http(s) URL with no credentials, query or fragment; http only with `allowHttp`. */\nexport const parseHttpUrl = (\n\tvalue: string,\n\tallowHttp: boolean\n): URL | { problem: OriginProblem } => {\n\tconst url = urlOf(value)\n\tif (!url) {\n\t\treturn { problem: 'format' }\n\t}\n\tif (url.protocol === 'http:' && !allowHttp) {\n\t\treturn { problem: 'insecure' }\n\t}\n\tif (!isHttp(url)) {\n\t\treturn { problem: 'format' }\n\t}\n\tif (url.username || url.password || url.search || url.hash) {\n\t\treturn { problem: 'format' }\n\t}\n\treturn url\n}\n\n/**\n * The origin `value` names when it is nothing but one: a scheme, a host and maybe a port, with no\n * credentials, path, query, fragment or wildcard. `http` only when `allowHttp`.\n */\nexport const parseOrigin = (\n\tvalue: string,\n\tallowHttp: boolean\n): { origin: string } | { problem: OriginProblem } => {\n\tif (value.includes('*')) {\n\t\treturn { problem: 'format' }\n\t}\n\tconst url = parseHttpUrl(value, allowHttp)\n\tif (!(url instanceof URL)) {\n\t\treturn url\n\t}\n\treturn url.pathname === '/' ? { origin: url.origin } : { problem: 'format' }\n}\n\n/**\n * An origin as a browser writes `Origin`: lowercased, default port dropped. Null for anything not\n * http(s), the literal `null` of an opaque document included.\n */\nexport const normalizeOrigin = (value: string): string | null => {\n\tconst url = urlOf(value)\n\treturn url && isHttp(url) ? url.origin : null\n}\n"],"mappings":";AAGA,MAAM,SAAS,UAA8B;CAC5C,IAAI;EACH,OAAO,IAAI,IAAI,MAAM,KAAK,CAAC;CAC5B,QAAQ;EACP,OAAO;CACR;AACD;AAEA,MAAM,UAAU,QAAsB,IAAI,aAAa,YAAY,IAAI,aAAa;;AAGpF,MAAa,gBACZ,OACA,cACsC;CACtC,MAAM,MAAM,MAAM,KAAK;CACvB,IAAI,CAAC,KACJ,OAAO,EAAE,SAAS,SAAS;CAE5B,IAAI,IAAI,aAAa,WAAW,CAAC,WAChC,OAAO,EAAE,SAAS,WAAW;CAE9B,IAAI,CAAC,OAAO,GAAG,GACd,OAAO,EAAE,SAAS,SAAS;CAE5B,IAAI,IAAI,YAAY,IAAI,YAAY,IAAI,UAAU,IAAI,MACrD,OAAO,EAAE,SAAS,SAAS;CAE5B,OAAO;AACR;;;;;AAMA,MAAa,eACZ,OACA,cACqD;CACrD,IAAI,MAAM,SAAS,GAAG,GACrB,OAAO,EAAE,SAAS,SAAS;CAE5B,MAAM,MAAM,aAAa,OAAO,SAAS;CACzC,IAAI,EAAE,eAAe,MACpB,OAAO;CAER,OAAO,IAAI,aAAa,MAAM,EAAE,QAAQ,IAAI,OAAO,IAAI,EAAE,SAAS,SAAS;AAC5E;;;;;AAMA,MAAa,mBAAmB,UAAiC;CAChE,MAAM,MAAM,MAAM,KAAK;CACvB,OAAO,OAAO,OAAO,GAAG,IAAI,IAAI,SAAS;AAC1C"}
@@ -0,0 +1,9 @@
1
+ //#region src/net/platform.d.ts
2
+ /**
3
+ * A hosting platform whose edge writes the visitor's address and location into request headers,
4
+ * replacing whatever the visitor sent under those names. Only then is reading them safe.
5
+ */
6
+ type TrustedPlatform = 'vercel' | 'cloudflare';
7
+ //#endregion
8
+ export { TrustedPlatform };
9
+ //# sourceMappingURL=platform.d.ts.map
@@ -0,0 +1,35 @@
1
+ //#region src/net/platform.ts
2
+ const isTrustedPlatform = (value) => value === "vercel" || value === "cloudflare";
3
+ /**
4
+ * Cloudflare sends `cf-region-code` and `cf-ipcity` only once its visitor location headers are
5
+ * turned on.
6
+ */
7
+ const PLATFORM_HEADERS = {
8
+ vercel: {
9
+ ip: "x-real-ip",
10
+ country: "x-vercel-ip-country",
11
+ region: "x-vercel-ip-country-region",
12
+ city: "x-vercel-ip-city"
13
+ },
14
+ cloudflare: {
15
+ ip: "cf-connecting-ip",
16
+ country: "cf-ipcountry",
17
+ region: "cf-region-code",
18
+ city: "cf-ipcity"
19
+ }
20
+ };
21
+ /**
22
+ * Every header an edge writes about the visitor. None is relayed raw: an upstream learns only the
23
+ * address the install's own trust settings resolved.
24
+ */
25
+ const VISITOR_HEADERS = [
26
+ ...Object.values(PLATFORM_HEADERS).flatMap((headers) => Object.values(headers)),
27
+ "x-vercel-forwarded-for",
28
+ "cf-connecting-ipv6",
29
+ "cf-region",
30
+ "true-client-ip"
31
+ ];
32
+ //#endregion
33
+ export { PLATFORM_HEADERS, VISITOR_HEADERS, isTrustedPlatform };
34
+
35
+ //# sourceMappingURL=platform.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"platform.js","names":[],"sources":["../../src/net/platform.ts"],"sourcesContent":["/**\n * A hosting platform whose edge writes the visitor's address and location into request headers,\n * replacing whatever the visitor sent under those names. Only then is reading them safe.\n */\nexport type TrustedPlatform = 'vercel' | 'cloudflare'\n\nexport const isTrustedPlatform = (value: unknown): value is TrustedPlatform =>\n\tvalue === 'vercel' || value === 'cloudflare'\n\n/** Where one platform puts the visitor's address and location. */\ninterface PlatformHeaders {\n\tip: string\n\tcountry: string\n\tregion: string\n\tcity: string\n}\n\n/**\n * Cloudflare sends `cf-region-code` and `cf-ipcity` only once its visitor location headers are\n * turned on.\n */\nexport const PLATFORM_HEADERS: Readonly<Record<TrustedPlatform, PlatformHeaders>> = {\n\tvercel: {\n\t\tip: 'x-real-ip',\n\t\tcountry: 'x-vercel-ip-country',\n\t\tregion: 'x-vercel-ip-country-region',\n\t\tcity: 'x-vercel-ip-city',\n\t},\n\tcloudflare: {\n\t\tip: 'cf-connecting-ip',\n\t\tcountry: 'cf-ipcountry',\n\t\tregion: 'cf-region-code',\n\t\tcity: 'cf-ipcity',\n\t},\n}\n\n/**\n * Every header an edge writes about the visitor. None is relayed raw: an upstream learns only the\n * address the install's own trust settings resolved.\n */\nexport const VISITOR_HEADERS: readonly string[] = [\n\t...Object.values(PLATFORM_HEADERS).flatMap((headers) => Object.values(headers)),\n\t'x-vercel-forwarded-for',\n\t'cf-connecting-ipv6',\n\t'cf-region',\n\t'true-client-ip',\n]\n"],"mappings":";AAMA,MAAa,qBAAqB,UACjC,UAAU,YAAY,UAAU;;;;;AAcjC,MAAa,mBAAuE;CACnF,QAAQ;EACP,IAAI;EACJ,SAAS;EACT,QAAQ;EACR,MAAM;CACP;CACA,YAAY;EACX,IAAI;EACJ,SAAS;EACT,QAAQ;EACR,MAAM;CACP;AACD;;;;;AAMA,MAAa,kBAAqC;CACjD,GAAG,OAAO,OAAO,gBAAgB,EAAE,SAAS,YAAY,OAAO,OAAO,OAAO,CAAC;CAC9E;CACA;CACA;CACA;AACD"}
@@ -8,35 +8,15 @@ interface CaptureRewrite {
8
8
  }
9
9
  /** An adapter's capture proxy mounted at a base path in the consumer's Next app. */
10
10
  interface CaptureRewriteMount {
11
- /** Base path this adapter's proxy is mounted at, e.g. '/ph' or '/api/analytics/p/global'. */
11
+ /** Base path this adapter's proxy is mounted at, e.g. '/ph' or '/api/_x/p/global'. */
12
12
  path: string;
13
13
  adapter: AnalyticsAdapter;
14
14
  }
15
15
  /**
16
- * Next.js `rewrites()` entries for every adapter's capture proxy, one mount at a time.
17
- * Each route's `source`/`upstream` already share `path-to-regexp` param names (e.g.
18
- * `:p*`), so no translation happens beyond prefixing `source` with the mount's
19
- * (normalized) path; `upstream` is used verbatim as `destination`. Next always strips a
20
- * trailing slash from the matched path before substituting it into `destination` (unlike
21
- * the runtime proxy, which can be told to keep one via `trailingSlashes`); harmless for
22
- * every vendor this helper supports today.
23
- *
24
- * An adapter without `capture`, or with no proxy routes (the native adapter, and GA4 whose
25
- * tag is served from Google's own CDN), contributes nothing rather than throwing, so one
26
- * broken slot never blanks the rest.
27
- * Output preserves mount order, then each mount's declared route order.
28
- *
29
- * Throws for a mount path that normalizes to the site root (an unprefixed catch-all
30
- * route would swallow the whole app) or for two mounts whose normalized paths are equal
31
- * or nested (Next matches rewrites first-match-wins, so an earlier catch-all would
32
- * silently shadow a later mount's routes). Distinct sibling paths that merely share a
33
- * string prefix, e.g. `/ph` and `/phx`, are unaffected.
34
- *
35
- * When any mounted adapter's descriptor sets `capture.proxy.trailingSlashes`, add
36
- * `skipTrailingSlashRedirect: true` to `next.config` (see `posthogProxyRewrites`'s
37
- * JSDoc for why PostHog needs it).
16
+ * @deprecated Throws {@link CAPTURE_REWRITES_REMOVED}: a rewrite to a vendor cannot keep the
17
+ * visitor's cookies from it. Use `captureRoute` in a route handler, or the plugin's own proxy.
38
18
  */
39
- declare const captureRewrites: (mounts: CaptureRewriteMount[]) => CaptureRewrite[];
19
+ declare const captureRewrites: (_mounts: CaptureRewriteMount[]) => CaptureRewrite[];
40
20
  //#endregion
41
21
  export { CaptureRewrite, CaptureRewriteMount, captureRewrites };
42
22
  //# sourceMappingURL=captureRewrites.d.ts.map
@@ -1,57 +1,13 @@
1
- import { normalizeMountPath } from "../capture/mountPath.js";
2
1
  //#region src/next/captureRewrites.ts
3
- const assertNotRoot = (path) => {
4
- if (path === "/") throw new Error("captureRewrites: mount path must not be the site root");
5
- };
6
- const isPrefixOrEqual = (a, b) => a === b || b.startsWith(`${a}/`);
7
- const assertNoCollisions = (paths) => {
8
- for (let i = 0; i < paths.length; i++) for (let j = i + 1; j < paths.length; j++) {
9
- const a = paths[i];
10
- const b = paths[j];
11
- if (isPrefixOrEqual(a, b) || isPrefixOrEqual(b, a)) throw new Error(`captureRewrites: mount paths collide: '${a}' and '${b}'`);
12
- }
13
- };
2
+ const CAPTURE_REWRITES_REMOVED = "analytics: captureRewrites no longer returns rewrites: a Next rewrite to a vendor forwards every request header, the visitor's cookies and the site's payload-token among them, and passes the vendor's set-cookie back to the site. Relay the vendor through captureRoute from '@10x-media/analytics/next' in a route handler (app/<mount>/[...path]/route.ts) instead, or leave capture.paths unset to use the plugin's own proxy.";
14
3
  /**
15
- * Next.js `rewrites()` entries for every adapter's capture proxy, one mount at a time.
16
- * Each route's `source`/`upstream` already share `path-to-regexp` param names (e.g.
17
- * `:p*`), so no translation happens beyond prefixing `source` with the mount's
18
- * (normalized) path; `upstream` is used verbatim as `destination`. Next always strips a
19
- * trailing slash from the matched path before substituting it into `destination` (unlike
20
- * the runtime proxy, which can be told to keep one via `trailingSlashes`); harmless for
21
- * every vendor this helper supports today.
22
- *
23
- * An adapter without `capture`, or with no proxy routes (the native adapter, and GA4 whose
24
- * tag is served from Google's own CDN), contributes nothing rather than throwing, so one
25
- * broken slot never blanks the rest.
26
- * Output preserves mount order, then each mount's declared route order.
27
- *
28
- * Throws for a mount path that normalizes to the site root (an unprefixed catch-all
29
- * route would swallow the whole app) or for two mounts whose normalized paths are equal
30
- * or nested (Next matches rewrites first-match-wins, so an earlier catch-all would
31
- * silently shadow a later mount's routes). Distinct sibling paths that merely share a
32
- * string prefix, e.g. `/ph` and `/phx`, are unaffected.
33
- *
34
- * When any mounted adapter's descriptor sets `capture.proxy.trailingSlashes`, add
35
- * `skipTrailingSlashRedirect: true` to `next.config` (see `posthogProxyRewrites`'s
36
- * JSDoc for why PostHog needs it).
4
+ * @deprecated Throws {@link CAPTURE_REWRITES_REMOVED}: a rewrite to a vendor cannot keep the
5
+ * visitor's cookies from it. Use `captureRoute` in a route handler, or the plugin's own proxy.
37
6
  */
38
- const captureRewrites = (mounts) => {
39
- const normalized = mounts.map((mount) => normalizeMountPath(mount.path));
40
- for (const path of normalized) assertNotRoot(path);
41
- assertNoCollisions(normalized);
42
- const rewrites = [];
43
- for (let i = 0; i < mounts.length; i++) {
44
- const routes = mounts[i].adapter.capture?.proxy.routes;
45
- if (!routes?.length) continue;
46
- const base = normalized[i];
47
- for (const route of routes) rewrites.push({
48
- source: `${base}${route.source}`,
49
- destination: route.upstream
50
- });
51
- }
52
- return rewrites;
7
+ const captureRewrites = (_mounts) => {
8
+ throw new Error(CAPTURE_REWRITES_REMOVED);
53
9
  };
54
10
  //#endregion
55
- export { captureRewrites };
11
+ export { CAPTURE_REWRITES_REMOVED, captureRewrites };
56
12
 
57
13
  //# sourceMappingURL=captureRewrites.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"captureRewrites.js","names":[],"sources":["../../src/next/captureRewrites.ts"],"sourcesContent":["import { normalizeMountPath } from '../capture/mountPath'\nimport type { AnalyticsAdapter } from '../core/contract'\n\n/** One Next.js rewrite entry (the shape `next.config` `rewrites()` returns). */\nexport interface CaptureRewrite {\n\tsource: string\n\tdestination: string\n}\n\n/** An adapter's capture proxy mounted at a base path in the consumer's Next app. */\nexport interface CaptureRewriteMount {\n\t/** Base path this adapter's proxy is mounted at, e.g. '/ph' or '/api/analytics/p/global'. */\n\tpath: string\n\tadapter: AnalyticsAdapter\n}\n\nconst assertNotRoot = (path: string): void => {\n\tif (path === '/') {\n\t\tthrow new Error('captureRewrites: mount path must not be the site root')\n\t}\n}\n\n// One base is a prefix of another when they're equal or the longer one continues past a\n// '/' boundary, so '/ph' collides with '/ph' and '/ph/x' but not the mere string-prefix\n// sibling '/phx'.\nconst isPrefixOrEqual = (a: string, b: string): boolean => a === b || b.startsWith(`${a}/`)\n\nconst assertNoCollisions = (paths: string[]): void => {\n\tfor (let i = 0; i < paths.length; i++) {\n\t\tfor (let j = i + 1; j < paths.length; j++) {\n\t\t\tconst a = paths[i] as string\n\t\t\tconst b = paths[j] as string\n\t\t\tif (isPrefixOrEqual(a, b) || isPrefixOrEqual(b, a)) {\n\t\t\t\tthrow new Error(`captureRewrites: mount paths collide: '${a}' and '${b}'`)\n\t\t\t}\n\t\t}\n\t}\n}\n\n/**\n * Next.js `rewrites()` entries for every adapter's capture proxy, one mount at a time.\n * Each route's `source`/`upstream` already share `path-to-regexp` param names (e.g.\n * `:p*`), so no translation happens beyond prefixing `source` with the mount's\n * (normalized) path; `upstream` is used verbatim as `destination`. Next always strips a\n * trailing slash from the matched path before substituting it into `destination` (unlike\n * the runtime proxy, which can be told to keep one via `trailingSlashes`); harmless for\n * every vendor this helper supports today.\n *\n * An adapter without `capture`, or with no proxy routes (the native adapter, and GA4 whose\n * tag is served from Google's own CDN), contributes nothing rather than throwing, so one\n * broken slot never blanks the rest.\n * Output preserves mount order, then each mount's declared route order.\n *\n * Throws for a mount path that normalizes to the site root (an unprefixed catch-all\n * route would swallow the whole app) or for two mounts whose normalized paths are equal\n * or nested (Next matches rewrites first-match-wins, so an earlier catch-all would\n * silently shadow a later mount's routes). Distinct sibling paths that merely share a\n * string prefix, e.g. `/ph` and `/phx`, are unaffected.\n *\n * When any mounted adapter's descriptor sets `capture.proxy.trailingSlashes`, add\n * `skipTrailingSlashRedirect: true` to `next.config` (see `posthogProxyRewrites`'s\n * JSDoc for why PostHog needs it).\n */\nexport const captureRewrites = (mounts: CaptureRewriteMount[]): CaptureRewrite[] => {\n\tconst normalized = mounts.map((mount) => normalizeMountPath(mount.path))\n\tfor (const path of normalized) {\n\t\tassertNotRoot(path)\n\t}\n\tassertNoCollisions(normalized)\n\n\tconst rewrites: CaptureRewrite[] = []\n\tfor (let i = 0; i < mounts.length; i++) {\n\t\tconst mount = mounts[i] as CaptureRewriteMount\n\t\tconst routes = mount.adapter.capture?.proxy.routes\n\t\tif (!routes?.length) {\n\t\t\tcontinue\n\t\t}\n\t\tconst base = normalized[i] as string\n\t\tfor (const route of routes) {\n\t\t\trewrites.push({ source: `${base}${route.source}`, destination: route.upstream })\n\t\t}\n\t}\n\treturn rewrites\n}\n"],"mappings":";;AAgBA,MAAM,iBAAiB,SAAuB;CAC7C,IAAI,SAAS,KACZ,MAAM,IAAI,MAAM,uDAAuD;AAEzE;AAKA,MAAM,mBAAmB,GAAW,MAAuB,MAAM,KAAK,EAAE,WAAW,GAAG,EAAE,EAAE;AAE1F,MAAM,sBAAsB,UAA0B;CACrD,KAAK,IAAI,IAAI,GAAG,IAAI,MAAM,QAAQ,KACjC,KAAK,IAAI,IAAI,IAAI,GAAG,IAAI,MAAM,QAAQ,KAAK;EAC1C,MAAM,IAAI,MAAM;EAChB,MAAM,IAAI,MAAM;EAChB,IAAI,gBAAgB,GAAG,CAAC,KAAK,gBAAgB,GAAG,CAAC,GAChD,MAAM,IAAI,MAAM,0CAA0C,EAAE,SAAS,EAAE,EAAE;CAE3E;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;AA0BA,MAAa,mBAAmB,WAAoD;CACnF,MAAM,aAAa,OAAO,KAAK,UAAU,mBAAmB,MAAM,IAAI,CAAC;CACvE,KAAK,MAAM,QAAQ,YAClB,cAAc,IAAI;CAEnB,mBAAmB,UAAU;CAE7B,MAAM,WAA6B,CAAC;CACpC,KAAK,IAAI,IAAI,GAAG,IAAI,OAAO,QAAQ,KAAK;EAEvC,MAAM,SADQ,OAAO,GACA,QAAQ,SAAS,MAAM;EAC5C,IAAI,CAAC,QAAQ,QACZ;EAED,MAAM,OAAO,WAAW;EACxB,KAAK,MAAM,SAAS,QACnB,SAAS,KAAK;GAAE,QAAQ,GAAG,OAAO,MAAM;GAAU,aAAa,MAAM;EAAS,CAAC;CAEjF;CACA,OAAO;AACR"}
1
+ {"version":3,"file":"captureRewrites.js","names":[],"sources":["../../src/next/captureRewrites.ts"],"sourcesContent":["import type { AnalyticsAdapter } from '../core/contract'\n\n/** One Next.js rewrite entry (the shape `next.config` `rewrites()` returns). */\nexport interface CaptureRewrite {\n\tsource: string\n\tdestination: string\n}\n\n/** An adapter's capture proxy mounted at a base path in the consumer's Next app. */\nexport interface CaptureRewriteMount {\n\t/** Base path this adapter's proxy is mounted at, e.g. '/ph' or '/api/_x/p/global'. */\n\tpath: string\n\tadapter: AnalyticsAdapter\n}\n\nexport const CAPTURE_REWRITES_REMOVED =\n\t\"analytics: captureRewrites no longer returns rewrites: a Next rewrite to a vendor forwards every request header, the visitor's cookies and the site's payload-token among them, and passes the vendor's set-cookie back to the site. Relay the vendor through captureRoute from '@10x-media/analytics/next' in a route handler (app/<mount>/[...path]/route.ts) instead, or leave capture.paths unset to use the plugin's own proxy.\"\n\n/**\n * @deprecated Throws {@link CAPTURE_REWRITES_REMOVED}: a rewrite to a vendor cannot keep the\n * visitor's cookies from it. Use `captureRoute` in a route handler, or the plugin's own proxy.\n */\nexport const captureRewrites = (_mounts: CaptureRewriteMount[]): CaptureRewrite[] => {\n\tthrow new Error(CAPTURE_REWRITES_REMOVED)\n}\n"],"mappings":";AAeA,MAAa,2BACZ;;;;;AAMD,MAAa,mBAAmB,YAAqD;CACpF,MAAM,IAAI,MAAM,wBAAwB;AACzC"}
@@ -0,0 +1,28 @@
1
+ import { TrustedPlatform } from "../net/platform.js";
2
+ import { AnalyticsAdapter } from "../core/contract.js";
3
+
4
+ //#region src/next/captureRoute.d.ts
5
+ interface CaptureRouteOptions {
6
+ /** Where the route handler is mounted: `'/ph'` for `app/ph/[...path]/route.ts`. */
7
+ path: string;
8
+ /** The adapter whose `capture.proxy` routes the handler relays, as `adapters` builds it. */
9
+ adapter: AnalyticsAdapter;
10
+ /** The plugin's `trustedProxyHops`: the address forwarded upstream is the one it resolves. */
11
+ trustedProxyHops?: number;
12
+ /** The plugin's `trustedPlatform`, in place of `trustedProxyHops`. */
13
+ trustedPlatform?: TrustedPlatform;
14
+ /** The plugin's `capture.allowedOrigins`: other sites whose pages may post through the relay. */
15
+ allowedOrigins?: string[];
16
+ /** Deadline for the vendor's response headers. Default 10 seconds. */
17
+ timeoutMs?: number;
18
+ /** Largest body relayed. Default 1 MB. */
19
+ maxBodyBytes?: number;
20
+ }
21
+ /**
22
+ * A Next.js route handler relaying one adapter's vendor tracker at a `capture.paths` mount, exported
23
+ * as GET, POST and OPTIONS. No cookie or credential goes upstream, and no `set-cookie` comes back.
24
+ */
25
+ declare const captureRoute: (options: CaptureRouteOptions) => ((request: Request) => Promise<Response>);
26
+ //#endregion
27
+ export { CaptureRouteOptions, captureRoute };
28
+ //# sourceMappingURL=captureRoute.d.ts.map