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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (1273) hide show
  1. package/CHANGELOG.md +780 -0
  2. package/LICENSE +21 -21
  3. package/README.md +35 -36
  4. package/dist/access/adminUser.d.ts +15 -0
  5. package/dist/access/adminUser.js +13 -0
  6. package/dist/access/adminUser.js.map +1 -0
  7. package/dist/access/decideOnce.js +16 -0
  8. package/dist/access/decideOnce.js.map +1 -0
  9. package/dist/access/membership.d.ts +23 -0
  10. package/dist/access/membership.js +63 -0
  11. package/dist/access/membership.js.map +1 -0
  12. package/dist/access/principal.d.ts +37 -0
  13. package/dist/access/principal.js +29 -0
  14. package/dist/access/principal.js.map +1 -0
  15. package/dist/access/readGate.js +16 -0
  16. package/dist/access/readGate.js.map +1 -0
  17. package/dist/adapters/ga4/disableKey.js +19 -0
  18. package/dist/adapters/ga4/disableKey.js.map +1 -0
  19. package/dist/adapters/ga4/eventName.d.ts +9 -0
  20. package/dist/adapters/ga4/eventName.js +13 -0
  21. package/dist/adapters/ga4/eventName.js.map +1 -0
  22. package/dist/adapters/ga4/ga4.d.ts +29 -0
  23. package/dist/adapters/ga4/ga4.js +324 -112
  24. package/dist/adapters/ga4/ga4.js.map +1 -1
  25. package/dist/adapters/ga4/measurementId.js +14 -0
  26. package/dist/adapters/ga4/measurementId.js.map +1 -0
  27. package/dist/adapters/goalRead.js +112 -0
  28. package/dist/adapters/goalRead.js.map +1 -0
  29. package/dist/adapters/http/baseUrl.js +15 -0
  30. package/dist/adapters/http/baseUrl.js.map +1 -0
  31. package/dist/adapters/http/fetchJson.d.ts +19 -0
  32. package/dist/adapters/http/fetchJson.js +27 -8
  33. package/dist/adapters/http/fetchJson.js.map +1 -1
  34. package/dist/adapters/mapping.js +52 -0
  35. package/dist/adapters/mapping.js.map +1 -0
  36. package/dist/adapters/plausible/plausible.d.ts +30 -3
  37. package/dist/adapters/plausible/plausible.js +198 -110
  38. package/dist/adapters/plausible/plausible.js.map +1 -1
  39. package/dist/adapters/plausible/scriptId.js +19 -0
  40. package/dist/adapters/plausible/scriptId.js.map +1 -0
  41. package/dist/adapters/posthog/posthog.d.ts +33 -9
  42. package/dist/adapters/posthog/posthog.js +307 -127
  43. package/dist/adapters/posthog/posthog.js.map +1 -1
  44. package/dist/adapters/posthog/projectCheck.js +56 -0
  45. package/dist/adapters/posthog/projectCheck.js.map +1 -0
  46. package/dist/adapters/readTime.js +7 -0
  47. package/dist/adapters/readTime.js.map +1 -0
  48. package/dist/adapters/series.js +14 -8
  49. package/dist/adapters/series.js.map +1 -1
  50. package/dist/adapters/umami/umami.d.ts +21 -3
  51. package/dist/adapters/umami/umami.js +334 -95
  52. package/dist/adapters/umami/umami.js.map +1 -1
  53. package/dist/adapters/upstream.js +16 -0
  54. package/dist/adapters/upstream.js.map +1 -0
  55. package/dist/binding/report.d.ts +8 -0
  56. package/dist/binding/report.js +24 -0
  57. package/dist/binding/report.js.map +1 -0
  58. package/dist/binding/resolvePath.js +28 -25
  59. package/dist/binding/resolvePath.js.map +1 -1
  60. package/dist/binding/types.d.ts +14 -29
  61. package/dist/capture/captureRequest.js +28 -0
  62. package/dist/capture/captureRequest.js.map +1 -0
  63. package/dist/capture/exclusionEndpoint.js +98 -0
  64. package/dist/capture/exclusionEndpoint.js.map +1 -0
  65. package/dist/capture/exclusionPrelude.js +14 -0
  66. package/dist/capture/exclusionPrelude.js.map +1 -0
  67. package/dist/capture/exclusionToken.js +23 -0
  68. package/dist/capture/exclusionToken.js.map +1 -0
  69. package/dist/capture/jsLiteral.js +19 -0
  70. package/dist/capture/jsLiteral.js.map +1 -0
  71. package/dist/capture/mountPath.js +2 -3
  72. package/dist/capture/mountPath.js.map +1 -1
  73. package/dist/capture/proxyEndpoint.js +49 -92
  74. package/dist/capture/proxyEndpoint.js.map +1 -1
  75. package/dist/capture/proxyRoutes.js +58 -21
  76. package/dist/capture/proxyRoutes.js.map +1 -1
  77. package/dist/capture/relay.js +91 -0
  78. package/dist/capture/relay.js.map +1 -0
  79. package/dist/capture/requestBody.js +2 -6
  80. package/dist/capture/requestBody.js.map +1 -1
  81. package/dist/capture/requestTrust.js +45 -0
  82. package/dist/capture/requestTrust.js.map +1 -0
  83. package/dist/capture/sameSite.js +40 -0
  84. package/dist/capture/sameSite.js.map +1 -0
  85. package/dist/capture/slots.js +50 -25
  86. package/dist/capture/slots.js.map +1 -1
  87. package/dist/capture/trackerConfig.js +131 -36
  88. package/dist/capture/trackerConfig.js.map +1 -1
  89. package/dist/capture/trackerEndpoint.js +22 -21
  90. package/dist/capture/trackerEndpoint.js.map +1 -1
  91. package/dist/capture/withoutConsent.js +91 -0
  92. package/dist/capture/withoutConsent.js.map +1 -0
  93. package/dist/charts/BarList.d.ts +27 -13
  94. package/dist/charts/BarList.js +38 -77
  95. package/dist/charts/BarList.js.map +1 -1
  96. package/dist/charts/TrendChart.d.ts +40 -7
  97. package/dist/charts/TrendChart.js +243 -215
  98. package/dist/charts/TrendChart.js.map +1 -1
  99. package/dist/charts/bars.d.ts +17 -1
  100. package/dist/charts/bars.js +12 -11
  101. package/dist/charts/bars.js.map +1 -1
  102. package/dist/charts/bucket.js +106 -73
  103. package/dist/charts/bucket.js.map +1 -1
  104. package/dist/charts/inProgress.js +22 -0
  105. package/dist/charts/inProgress.js.map +1 -0
  106. package/dist/charts/series.d.ts +15 -0
  107. package/dist/charts/series.js +123 -0
  108. package/dist/charts/series.js.map +1 -0
  109. package/dist/charts/spline.js +91 -25
  110. package/dist/charts/spline.js.map +1 -1
  111. package/dist/charts/trendGeometry.js +91 -0
  112. package/dist/charts/trendGeometry.js.map +1 -0
  113. package/dist/core/adminOptions.d.ts +1 -0
  114. package/dist/core/adminOptions.js +198 -0
  115. package/dist/core/adminOptions.js.map +1 -0
  116. package/dist/core/budget.js +24 -0
  117. package/dist/core/budget.js.map +1 -0
  118. package/dist/core/cacheKey.d.ts +1 -0
  119. package/dist/core/cacheKey.js +51 -29
  120. package/dist/core/cacheKey.js.map +1 -1
  121. package/dist/core/cacheOptions.js +165 -0
  122. package/dist/core/cacheOptions.js.map +1 -0
  123. package/dist/core/capabilities.d.ts +24 -11
  124. package/dist/core/capabilities.js +101 -17
  125. package/dist/core/capabilities.js.map +1 -1
  126. package/dist/core/capture.d.ts +59 -26
  127. package/dist/core/captureOptions.d.ts +1 -0
  128. package/dist/core/captureOptions.js +347 -0
  129. package/dist/core/captureOptions.js.map +1 -0
  130. package/dist/core/clock.js +13 -0
  131. package/dist/core/clock.js.map +1 -0
  132. package/dist/core/collectionOption.d.ts +17 -0
  133. package/dist/core/collectionOption.js +105 -0
  134. package/dist/core/collectionOption.js.map +1 -0
  135. package/dist/core/collectionSlug.js +7 -0
  136. package/dist/core/collectionSlug.js.map +1 -0
  137. package/dist/core/contract.d.ts +340 -49
  138. package/dist/core/contract.js +7 -4
  139. package/dist/core/contract.js.map +1 -1
  140. package/dist/core/cron.js +57 -0
  141. package/dist/core/cron.js.map +1 -0
  142. package/dist/core/fetch.d.ts +17 -0
  143. package/dist/core/goalOptions.d.ts +1 -0
  144. package/dist/core/goalOptions.js +166 -0
  145. package/dist/core/goalOptions.js.map +1 -0
  146. package/dist/core/granularity.js +3 -2
  147. package/dist/core/granularity.js.map +1 -1
  148. package/dist/core/guards.js +17 -0
  149. package/dist/core/guards.js.map +1 -0
  150. package/dist/core/jobs.d.ts +40 -0
  151. package/dist/core/jobs.js +132 -0
  152. package/dist/core/jobs.js.map +1 -0
  153. package/dist/core/legacyOptions.js +145 -0
  154. package/dist/core/legacyOptions.js.map +1 -0
  155. package/dist/core/metricAliases.js +81 -0
  156. package/dist/core/metricAliases.js.map +1 -0
  157. package/dist/core/metricValues.js +57 -0
  158. package/dist/core/metricValues.js.map +1 -0
  159. package/dist/core/monotonic.js +10 -0
  160. package/dist/core/monotonic.js.map +1 -0
  161. package/dist/core/optionChecks.js +51 -0
  162. package/dist/core/optionChecks.js.map +1 -0
  163. package/dist/core/options.d.ts +535 -151
  164. package/dist/core/options.js +158 -214
  165. package/dist/core/options.js.map +1 -1
  166. package/dist/core/registry.js +45 -5
  167. package/dist/core/registry.js.map +1 -1
  168. package/dist/core/scopeList.js +7 -9
  169. package/dist/core/scopeList.js.map +1 -1
  170. package/dist/core/scopeOptions.d.ts +1 -0
  171. package/dist/core/scopeOptions.js +114 -0
  172. package/dist/core/scopeOptions.js.map +1 -0
  173. package/dist/core/scopedRead.js +349 -36
  174. package/dist/core/scopedRead.js.map +1 -1
  175. package/dist/core/sdks.d.ts +81 -0
  176. package/dist/core/sdks.js +23 -0
  177. package/dist/core/sdks.js.map +1 -0
  178. package/dist/core/serverEvent.d.ts +50 -14
  179. package/dist/core/serverEvent.js.map +1 -1
  180. package/dist/core/siteAddress.js +20 -0
  181. package/dist/core/siteAddress.js.map +1 -0
  182. package/dist/core/sourceErrors.js +109 -0
  183. package/dist/core/sourceErrors.js.map +1 -0
  184. package/dist/core/sourceLabel.d.ts +10 -0
  185. package/dist/core/sourceLabel.js +63 -0
  186. package/dist/core/sourceLabel.js.map +1 -0
  187. package/dist/core/sourceOptions.js +107 -0
  188. package/dist/core/sourceOptions.js.map +1 -0
  189. package/dist/core/sourcePolicy.d.ts +55 -0
  190. package/dist/core/sourcePolicy.js +51 -0
  191. package/dist/core/sourcePolicy.js.map +1 -0
  192. package/dist/core/throttle.js +18 -0
  193. package/dist/core/throttle.js.map +1 -0
  194. package/dist/core/values.js +61 -0
  195. package/dist/core/values.js.map +1 -0
  196. package/dist/core/widgetSlugs.d.ts +17 -0
  197. package/dist/core/widgetSlugs.js +29 -0
  198. package/dist/core/widgetSlugs.js.map +1 -0
  199. package/dist/db/detachedWrite.js +36 -0
  200. package/dist/db/detachedWrite.js.map +1 -0
  201. package/dist/db/errors.js +182 -0
  202. package/dist/db/errors.js.map +1 -0
  203. package/dist/db/kind.js +32 -0
  204. package/dist/db/kind.js.map +1 -0
  205. package/dist/db/openTransaction.js +51 -0
  206. package/dist/db/openTransaction.js.map +1 -0
  207. package/dist/exports/adapters/contract.d.ts +15 -0
  208. package/dist/exports/adapters/ga4.d.ts +17 -1
  209. package/dist/exports/adapters/ga4.js +2 -1
  210. package/dist/exports/adapters/native.d.ts +29 -2
  211. package/dist/exports/adapters/native.js +5 -1
  212. package/dist/exports/adapters/plausible.d.ts +16 -1
  213. package/dist/exports/adapters/posthog.d.ts +16 -1
  214. package/dist/exports/adapters/umami.d.ts +16 -1
  215. package/dist/exports/attributes.d.ts +42 -0
  216. package/dist/exports/attributes.js +83 -0
  217. package/dist/exports/attributes.js.map +1 -0
  218. package/dist/exports/client.d.ts +45 -11
  219. package/dist/exports/client.js +23 -6
  220. package/dist/exports/geo.d.ts +4 -2
  221. package/dist/exports/geo.js +1 -1
  222. package/dist/exports/i18n.d.ts +2 -2
  223. package/dist/exports/i18n.js +2 -2
  224. package/dist/exports/migrations.d.ts +2 -0
  225. package/dist/exports/migrations.js +2 -0
  226. package/dist/exports/react.d.ts +5 -3
  227. package/dist/exports/react.js +1 -2
  228. package/dist/exports/routes.d.ts +19 -0
  229. package/dist/exports/routes.js +3 -0
  230. package/dist/exports/rsc.d.ts +33 -14
  231. package/dist/exports/rsc.js +11 -6
  232. package/dist/exports/site.d.ts +5 -0
  233. package/dist/exports/site.js +3 -0
  234. package/dist/exports/testing.d.ts +18 -0
  235. package/dist/exports/testing.js +3 -0
  236. package/dist/exports/tracker.d.ts +6 -17
  237. package/dist/exports/tracker.js +3 -11
  238. package/dist/exports/types.d.ts +46 -14
  239. package/dist/exports/types.js +7 -1
  240. package/dist/fields/AnalyticsPanelClient.js +265 -154
  241. package/dist/fields/AnalyticsPanelClient.js.map +1 -1
  242. package/dist/fields/AnalyticsPanelField.d.ts +19 -7
  243. package/dist/fields/AnalyticsPanelField.js +123 -30
  244. package/dist/fields/AnalyticsPanelField.js.map +1 -1
  245. package/dist/fields/AnalyticsStatField.d.ts +17 -6
  246. package/dist/fields/AnalyticsStatField.js +98 -63
  247. package/dist/fields/AnalyticsStatField.js.map +1 -1
  248. package/dist/fields/FieldShimmer.js +15 -0
  249. package/dist/fields/FieldShimmer.js.map +1 -0
  250. package/dist/fields/PanelContent.js +222 -0
  251. package/dist/fields/PanelContent.js.map +1 -0
  252. package/dist/fields/PanelList.js +82 -0
  253. package/dist/fields/PanelList.js.map +1 -0
  254. package/dist/fields/PanelLiveCounter.js +63 -0
  255. package/dist/fields/PanelLiveCounter.js.map +1 -0
  256. package/dist/fields/PanelSkeleton.js +63 -0
  257. package/dist/fields/PanelSkeleton.js.map +1 -0
  258. package/dist/fields/componentPaths.js +8 -0
  259. package/dist/fields/componentPaths.js.map +1 -0
  260. package/dist/fields/config/FilterDimensionSelectField.d.ts +14 -0
  261. package/dist/fields/config/FilterDimensionSelectField.js +49 -0
  262. package/dist/fields/config/FilterDimensionSelectField.js.map +1 -0
  263. package/dist/fields/config/FilterKeySelect.js +66 -0
  264. package/dist/fields/config/FilterKeySelect.js.map +1 -0
  265. package/dist/fields/config/FilterOperatorSelectField.d.ts +19 -0
  266. package/dist/fields/config/FilterOperatorSelectField.js +59 -0
  267. package/dist/fields/config/FilterOperatorSelectField.js.map +1 -0
  268. package/dist/fields/config/FilterValueField.d.ts +17 -0
  269. package/dist/fields/config/FilterValueField.js +130 -0
  270. package/dist/fields/config/FilterValueField.js.map +1 -0
  271. package/dist/fields/config/MetricSelectField.d.ts +5 -12
  272. package/dist/fields/config/MetricSelectField.js +19 -31
  273. package/dist/fields/config/MetricSelectField.js.map +1 -1
  274. package/dist/fields/config/OptionSelect.js +52 -0
  275. package/dist/fields/config/OptionSelect.js.map +1 -0
  276. package/dist/fields/config/SourceSelectField.js +16 -31
  277. package/dist/fields/config/SourceSelectField.js.map +1 -1
  278. package/dist/fields/config/fetchSources.d.ts +3 -0
  279. package/dist/fields/config/fetchSources.js +17 -23
  280. package/dist/fields/config/fetchSources.js.map +1 -1
  281. package/dist/fields/config/filterValues.js +106 -0
  282. package/dist/fields/config/filterValues.js.map +1 -0
  283. package/dist/fields/config/narrow.js +8 -10
  284. package/dist/fields/config/narrow.js.map +1 -1
  285. package/dist/fields/config/retiredPickers.d.ts +45 -0
  286. package/dist/fields/config/retiredPickers.js +46 -0
  287. package/dist/fields/config/retiredPickers.js.map +1 -0
  288. package/dist/fields/config/scopedFields.d.ts +40 -0
  289. package/dist/fields/config/scopedFields.js +68 -0
  290. package/dist/fields/config/scopedFields.js.map +1 -0
  291. package/dist/fields/config/sourcesState.js +19 -3
  292. package/dist/fields/config/sourcesState.js.map +1 -1
  293. package/dist/fields/config/toSelectOption.js +13 -7
  294. package/dist/fields/config/toSelectOption.js.map +1 -1
  295. package/dist/fields/config/useAnalyticsSources.d.ts +10 -7
  296. package/dist/fields/config/useAnalyticsSources.js +23 -24
  297. package/dist/fields/config/useAnalyticsSources.js.map +1 -1
  298. package/dist/fields/config/useFilterCapabilities.d.ts +31 -0
  299. package/dist/fields/config/useFilterCapabilities.js +60 -0
  300. package/dist/fields/config/useFilterCapabilities.js.map +1 -0
  301. package/dist/fields/config/useFormString.js +12 -0
  302. package/dist/fields/config/useFormString.js.map +1 -0
  303. package/dist/fields/dateRange/field.js +7 -19
  304. package/dist/fields/dateRange/field.js.map +1 -1
  305. package/dist/fields/dateRange/types.d.ts +5 -1
  306. package/dist/fields/dateRange/ui.d.ts +3 -2
  307. package/dist/fields/dateRange/ui.js +57 -319
  308. package/dist/fields/dateRange/ui.js.map +1 -1
  309. package/dist/fields/documentScope.js +21 -0
  310. package/dist/fields/documentScope.js.map +1 -0
  311. package/dist/fields/emptyState.js +30 -26
  312. package/dist/fields/emptyState.js.map +1 -1
  313. package/dist/fields/factories.d.ts +35 -16
  314. package/dist/fields/factories.js +67 -38
  315. package/dist/fields/factories.js.map +1 -1
  316. package/dist/fields/format.d.ts +12 -3
  317. package/dist/fields/format.js +77 -13
  318. package/dist/fields/format.js.map +1 -1
  319. package/dist/fields/itemReport.js +45 -0
  320. package/dist/fields/itemReport.js.map +1 -0
  321. package/dist/fields/readForDocument.d.ts +79 -26
  322. package/dist/fields/readForDocument.js +451 -105
  323. package/dist/fields/readForDocument.js.map +1 -1
  324. package/dist/fields/stateKeys.js +20 -0
  325. package/dist/fields/stateKeys.js.map +1 -0
  326. package/dist/goals/GoalAmountField.d.ts +10 -0
  327. package/dist/goals/GoalAmountField.js +179 -0
  328. package/dist/goals/GoalAmountField.js.map +1 -0
  329. package/dist/goals/GoalSelectField.js +89 -40
  330. package/dist/goals/GoalSelectField.js.map +1 -1
  331. package/dist/goals/GoalSelectFieldServer.d.ts +13 -0
  332. package/dist/goals/GoalSelectFieldServer.js +21 -0
  333. package/dist/goals/GoalSelectFieldServer.js.map +1 -0
  334. package/dist/goals/amountField.d.ts +20 -0
  335. package/dist/goals/amountField.js +37 -0
  336. package/dist/goals/amountField.js.map +1 -0
  337. package/dist/goals/builtin.js +17 -0
  338. package/dist/goals/builtin.js.map +1 -0
  339. package/dist/goals/collection.d.ts +22 -0
  340. package/dist/goals/collection.js +143 -124
  341. package/dist/goals/collection.js.map +1 -1
  342. package/dist/goals/constants.d.ts +38 -0
  343. package/dist/goals/constants.js +49 -0
  344. package/dist/goals/constants.js.map +1 -0
  345. package/dist/goals/currency.d.ts +16 -0
  346. package/dist/goals/currency.js +46 -4
  347. package/dist/goals/currency.js.map +1 -1
  348. package/dist/goals/currencyOptions.js +70 -0
  349. package/dist/goals/currencyOptions.js.map +1 -0
  350. package/dist/goals/fetchGoals.d.ts +10 -0
  351. package/dist/goals/fetchGoals.js +12 -22
  352. package/dist/goals/fetchGoals.js.map +1 -1
  353. package/dist/goals/goalField.d.ts +4 -6
  354. package/dist/goals/goalField.js +9 -19
  355. package/dist/goals/goalField.js.map +1 -1
  356. package/dist/goals/goalsEndpoint.js +40 -38
  357. package/dist/goals/goalsEndpoint.js.map +1 -1
  358. package/dist/goals/items.js +35 -0
  359. package/dist/goals/items.js.map +1 -0
  360. package/dist/goals/latent.js +9 -0
  361. package/dist/goals/latent.js.map +1 -0
  362. package/dist/goals/linkFields.d.ts +35 -0
  363. package/dist/goals/linkFields.js +31 -0
  364. package/dist/goals/linkFields.js.map +1 -0
  365. package/dist/goals/match.d.ts +14 -0
  366. package/dist/goals/match.js +67 -46
  367. package/dist/goals/match.js.map +1 -1
  368. package/dist/goals/moneyFields.js +56 -0
  369. package/dist/goals/moneyFields.js.map +1 -0
  370. package/dist/goals/pathMatch.js +122 -0
  371. package/dist/goals/pathMatch.js.map +1 -0
  372. package/dist/goals/placeholder.js +12 -0
  373. package/dist/goals/placeholder.js.map +1 -0
  374. package/dist/goals/resolver.d.ts +3 -3
  375. package/dist/goals/resolver.js +155 -47
  376. package/dist/goals/resolver.js.map +1 -1
  377. package/dist/goals/serverRevenue.d.ts +60 -0
  378. package/dist/goals/serverRevenue.js +41 -0
  379. package/dist/goals/serverRevenue.js.map +1 -0
  380. package/dist/goals/trackGoalAction.d.ts +26 -25
  381. package/dist/goals/trackGoalAction.js +71 -66
  382. package/dist/goals/trackGoalAction.js.map +1 -1
  383. package/dist/goals/types.d.ts +13 -28
  384. package/dist/goals/types.js +1 -1
  385. package/dist/goals/types.js.map +1 -1
  386. package/dist/goals/useAnalyticsGoals.d.ts +6 -5
  387. package/dist/goals/useAnalyticsGoals.js +17 -18
  388. package/dist/goals/useAnalyticsGoals.js.map +1 -1
  389. package/dist/index.d.ts +69 -11
  390. package/dist/index.js +262 -192
  391. package/dist/index.js.map +1 -1
  392. package/dist/items/collectionIdType.js +20 -0
  393. package/dist/items/collectionIdType.js.map +1 -0
  394. package/dist/items/idType.js +31 -0
  395. package/dist/items/idType.js.map +1 -0
  396. package/dist/items/ref.js +73 -0
  397. package/dist/items/ref.js.map +1 -0
  398. package/dist/maintenance/apiTaskState.js +141 -0
  399. package/dist/maintenance/apiTaskState.js.map +1 -0
  400. package/dist/maintenance/heartbeat.js +51 -0
  401. package/dist/maintenance/heartbeat.js.map +1 -0
  402. package/dist/maintenance/lease.d.ts +1 -0
  403. package/dist/maintenance/lease.js +79 -0
  404. package/dist/maintenance/lease.js.map +1 -0
  405. package/dist/maintenance/taskSchedule.js +27 -0
  406. package/dist/maintenance/taskSchedule.js.map +1 -0
  407. package/dist/maintenance/underLease.js +35 -0
  408. package/dist/maintenance/underLease.js.map +1 -0
  409. package/dist/migrations/legacy.d.ts +54 -0
  410. package/dist/migrations/legacy.js +117 -0
  411. package/dist/migrations/legacy.js.map +1 -0
  412. package/dist/migrations/predefined/dropLegacyMongo.d.ts +11 -0
  413. package/dist/migrations/predefined/dropLegacyMongo.js +12 -0
  414. package/dist/migrations/predefined/dropLegacyMongo.js.map +1 -0
  415. package/dist/native/collections/aggregates.js +54 -0
  416. package/dist/native/collections/aggregates.js.map +1 -0
  417. package/dist/native/collections/hits.js +103 -0
  418. package/dist/native/collections/hits.js.map +1 -0
  419. package/dist/native/collections/slugs.d.ts +10 -0
  420. package/dist/native/collections/slugs.js +16 -0
  421. package/dist/native/collections/slugs.js.map +1 -0
  422. package/dist/native/collections/state.js +84 -0
  423. package/dist/native/collections/state.js.map +1 -0
  424. package/dist/native/collections/storeCollection.js +31 -0
  425. package/dist/native/collections/storeCollection.js.map +1 -0
  426. package/dist/native/engine/buckets.d.ts +1 -0
  427. package/dist/native/engine/buckets.js +53 -0
  428. package/dist/native/engine/buckets.js.map +1 -0
  429. package/dist/native/engine/capabilities.js +87 -0
  430. package/dist/native/engine/capabilities.js.map +1 -0
  431. package/dist/native/engine/cost.js +72 -0
  432. package/dist/native/engine/cost.js.map +1 -0
  433. package/dist/native/engine/days.d.ts +1 -0
  434. package/dist/native/engine/days.js +182 -0
  435. package/dist/native/engine/days.js.map +1 -0
  436. package/dist/native/engine/engine.d.ts +1 -0
  437. package/dist/native/engine/engine.js +1627 -0
  438. package/dist/native/engine/engine.js.map +1 -0
  439. package/dist/native/engine/instance.js +58 -0
  440. package/dist/native/engine/instance.js.map +1 -0
  441. package/dist/native/engine/maintenance.d.ts +1 -0
  442. package/dist/native/engine/maintenance.js +677 -0
  443. package/dist/native/engine/maintenance.js.map +1 -0
  444. package/dist/native/engine/merge.js +41 -0
  445. package/dist/native/engine/merge.js.map +1 -0
  446. package/dist/native/engine/nudge.js +26 -0
  447. package/dist/native/engine/nudge.js.map +1 -0
  448. package/dist/native/engine/planner.js +199 -0
  449. package/dist/native/engine/planner.js.map +1 -0
  450. package/dist/native/engine/rebuild.d.ts +22 -0
  451. package/dist/native/engine/rebuild.js +76 -0
  452. package/dist/native/engine/rebuild.js.map +1 -0
  453. package/dist/native/engine/recent.js +17 -0
  454. package/dist/native/engine/recent.js.map +1 -0
  455. package/dist/native/engine/salt.d.ts +1 -0
  456. package/dist/native/engine/salt.js +98 -0
  457. package/dist/native/engine/salt.js.map +1 -0
  458. package/dist/native/engine/siteHosts.d.ts +1 -0
  459. package/dist/native/engine/siteHosts.js +58 -0
  460. package/dist/native/engine/siteHosts.js.map +1 -0
  461. package/dist/native/engine/toHit.js +110 -0
  462. package/dist/native/engine/toHit.js.map +1 -0
  463. package/dist/native/engine/writeBuffer.d.ts +14 -0
  464. package/dist/native/engine/writeBuffer.js +317 -0
  465. package/dist/native/engine/writeBuffer.js.map +1 -0
  466. package/dist/native/geo/composeGeoResolvers.d.ts +1 -0
  467. package/dist/native/geo/composeGeoResolvers.js +5 -2
  468. package/dist/native/geo/composeGeoResolvers.js.map +1 -1
  469. package/dist/native/geo/geoResolver.d.ts +27 -2
  470. package/dist/native/geo/geoResolver.js +42 -6
  471. package/dist/native/geo/geoResolver.js.map +1 -1
  472. package/dist/native/geo/maxmindResolver.d.ts +8 -4
  473. package/dist/native/geo/maxmindResolver.js +20 -16
  474. package/dist/native/geo/maxmindResolver.js.map +1 -1
  475. package/dist/native/geo/resolveGeo.js +31 -0
  476. package/dist/native/geo/resolveGeo.js.map +1 -0
  477. package/dist/native/ingest/bots.d.ts +10 -0
  478. package/dist/native/ingest/bots.js +66 -0
  479. package/dist/native/ingest/bots.js.map +1 -0
  480. package/dist/native/ingest/browser.js +45 -0
  481. package/dist/native/ingest/browser.js.map +1 -0
  482. package/dist/native/ingest/clientIp.js +34 -8
  483. package/dist/native/ingest/clientIp.js.map +1 -1
  484. package/dist/native/ingest/device.js +4 -6
  485. package/dist/native/ingest/device.js.map +1 -1
  486. package/dist/native/ingest/endpoint.d.ts +1 -1
  487. package/dist/native/ingest/endpoint.js +185 -32
  488. package/dist/native/ingest/endpoint.js.map +1 -1
  489. package/dist/native/ingest/itemSignature.d.ts +26 -0
  490. package/dist/native/ingest/itemSignature.js +45 -0
  491. package/dist/native/ingest/itemSignature.js.map +1 -0
  492. package/dist/native/ingest/language.js +13 -0
  493. package/dist/native/ingest/language.js.map +1 -0
  494. package/dist/native/ingest/normalizeEvent.d.ts +73 -5
  495. package/dist/native/ingest/normalizeEvent.js +257 -51
  496. package/dist/native/ingest/normalizeEvent.js.map +1 -1
  497. package/dist/native/ingest/orderSignature.d.ts +13 -0
  498. package/dist/native/ingest/orderSignature.js +50 -0
  499. package/dist/native/ingest/orderSignature.js.map +1 -0
  500. package/dist/native/ingest/referrer.js +46 -0
  501. package/dist/native/ingest/referrer.js.map +1 -0
  502. package/dist/native/ingest/requestHost.js +44 -0
  503. package/dist/native/ingest/requestHost.js.map +1 -0
  504. package/dist/native/ingest/resolveHostname.d.ts +20 -0
  505. package/dist/native/ingest/resolveHostname.js +51 -0
  506. package/dist/native/ingest/resolveHostname.js.map +1 -0
  507. package/dist/native/ingest/revenue.d.ts +1 -0
  508. package/dist/native/ingest/revenue.js +121 -0
  509. package/dist/native/ingest/revenue.js.map +1 -0
  510. package/dist/native/ingest/route.d.ts +10 -0
  511. package/dist/native/ingest/route.js +85 -0
  512. package/dist/native/ingest/route.js.map +1 -0
  513. package/dist/native/ingest/serverTrack.d.ts +2 -10
  514. package/dist/native/ingest/serverTrack.js +188 -68
  515. package/dist/native/ingest/serverTrack.js.map +1 -1
  516. package/dist/native/ingest/signature.js +28 -0
  517. package/dist/native/ingest/signature.js.map +1 -0
  518. package/dist/native/ingest/source.d.ts +10 -0
  519. package/dist/native/ingest/source.js +245 -16
  520. package/dist/native/ingest/source.js.map +1 -1
  521. package/dist/native/ingest/utm.js +33 -0
  522. package/dist/native/ingest/utm.js.map +1 -0
  523. package/dist/native/ingest/validate.js +25 -13
  524. package/dist/native/ingest/validate.js.map +1 -1
  525. package/dist/native/ingest/visitorHash.js +6 -8
  526. package/dist/native/ingest/visitorHash.js.map +1 -1
  527. package/dist/native/nativeAdapter.d.ts +128 -9
  528. package/dist/native/nativeAdapter.js +395 -281
  529. package/dist/native/nativeAdapter.js.map +1 -1
  530. package/dist/native/rebuildDays.d.ts +12 -0
  531. package/dist/native/rebuildDays.js +16 -0
  532. package/dist/native/rebuildDays.js.map +1 -0
  533. package/dist/native/store/aggregate.js +450 -0
  534. package/dist/native/store/aggregate.js.map +1 -0
  535. package/dist/native/store/caps.d.ts +18 -0
  536. package/dist/native/store/caps.js +76 -0
  537. package/dist/native/store/caps.js.map +1 -0
  538. package/dist/native/store/chunks.js +34 -0
  539. package/dist/native/store/chunks.js.map +1 -0
  540. package/dist/native/store/columnValues.js +31 -0
  541. package/dist/native/store/columnValues.js.map +1 -0
  542. package/dist/native/store/dialect.js +106 -0
  543. package/dist/native/store/dialect.js.map +1 -0
  544. package/dist/native/store/eventStore.js +44 -0
  545. package/dist/native/store/eventStore.js.map +1 -0
  546. package/dist/native/store/hitRow.js +119 -0
  547. package/dist/native/store/hitRow.js.map +1 -0
  548. package/dist/native/store/hits.js +65 -0
  549. package/dist/native/store/hits.js.map +1 -0
  550. package/dist/native/store/ids.js +105 -0
  551. package/dist/native/store/ids.js.map +1 -0
  552. package/dist/native/store/mongo/aggregatePipelines.js +438 -0
  553. package/dist/native/store/mongo/aggregatePipelines.js.map +1 -0
  554. package/dist/native/store/mongo/mongoState.js +375 -0
  555. package/dist/native/store/mongo/mongoState.js.map +1 -0
  556. package/dist/native/store/mongo/mongoStore.js +618 -0
  557. package/dist/native/store/mongo/mongoStore.js.map +1 -0
  558. package/dist/native/store/mongo/pipelines.js +705 -0
  559. package/dist/native/store/mongo/pipelines.js.map +1 -0
  560. package/dist/native/store/mongo/results.js +20 -0
  561. package/dist/native/store/mongo/results.js.map +1 -0
  562. package/dist/native/store/parts.d.ts +1 -0
  563. package/dist/native/store/parts.js +101 -0
  564. package/dist/native/store/parts.js.map +1 -0
  565. package/dist/native/store/pattern.js +213 -0
  566. package/dist/native/store/pattern.js.map +1 -0
  567. package/dist/native/store/rawRead.d.ts +23 -0
  568. package/dist/native/store/rawRead.js +387 -0
  569. package/dist/native/store/rawRead.js.map +1 -0
  570. package/dist/native/store/reclassify.js +53 -0
  571. package/dist/native/store/reclassify.js.map +1 -0
  572. package/dist/native/store/sql/aggregateSql.js +349 -0
  573. package/dist/native/store/sql/aggregateSql.js.map +1 -0
  574. package/dist/native/store/sql/columns.js +49 -0
  575. package/dist/native/store/sql/columns.js.map +1 -0
  576. package/dist/native/store/sql/compile.js +668 -0
  577. package/dist/native/store/sql/compile.js.map +1 -0
  578. package/dist/native/store/sql/drivers.js +218 -0
  579. package/dist/native/store/sql/drivers.js.map +1 -0
  580. package/dist/native/store/sql/executor.js +132 -0
  581. package/dist/native/store/sql/executor.js.map +1 -0
  582. package/dist/native/store/sql/fragment.js +104 -0
  583. package/dist/native/store/sql/fragment.js.map +1 -0
  584. package/dist/native/store/sql/maintenanceSql.js +59 -0
  585. package/dist/native/store/sql/maintenanceSql.js.map +1 -0
  586. package/dist/native/store/sql/ownConnection.js +107 -0
  587. package/dist/native/store/sql/ownConnection.js.map +1 -0
  588. package/dist/native/store/sql/poolShare.js +101 -0
  589. package/dist/native/store/sql/poolShare.js.map +1 -0
  590. package/dist/native/store/sql/sqlState.js +325 -0
  591. package/dist/native/store/sql/sqlState.js.map +1 -0
  592. package/dist/native/store/sql/sqlStore.js +355 -0
  593. package/dist/native/store/sql/sqlStore.js.map +1 -0
  594. package/dist/native/store/sql/sqliteThread.d.ts +9 -0
  595. package/dist/native/store/sql/sqliteThread.js +314 -0
  596. package/dist/native/store/sql/sqliteThread.js.map +1 -0
  597. package/dist/native/store/sql/sqliteWorker.js +327 -0
  598. package/dist/native/store/sql/sqliteWorker.js.map +1 -0
  599. package/dist/native/store/sql/sqliteWorkerSource.js +347 -0
  600. package/dist/native/store/sql/sqliteWorkerSource.js.map +1 -0
  601. package/dist/native/store/state.js +151 -0
  602. package/dist/native/store/state.js.map +1 -0
  603. package/dist/native/store/stateStore.js +29 -0
  604. package/dist/native/store/stateStore.js.map +1 -0
  605. package/dist/native/store/types.d.ts +15 -0
  606. package/dist/native/store/types.js +10 -0
  607. package/dist/native/store/types.js.map +1 -0
  608. package/dist/native/tasks/maintainTask.d.ts +19 -0
  609. package/dist/native/tasks/maintainTask.js +57 -0
  610. package/dist/native/tasks/maintainTask.js.map +1 -0
  611. package/dist/net/guardedFetch.d.ts +32 -0
  612. package/dist/net/guardedFetch.js +220 -0
  613. package/dist/net/guardedFetch.js.map +1 -0
  614. package/dist/net/origin.js +40 -0
  615. package/dist/net/origin.js.map +1 -0
  616. package/dist/net/platform.d.ts +9 -0
  617. package/dist/net/platform.js +35 -0
  618. package/dist/net/platform.js.map +1 -0
  619. package/dist/plugin/adminDependencies.js +34 -0
  620. package/dist/plugin/adminDependencies.js.map +1 -0
  621. package/dist/plugin/apiPath.js +23 -0
  622. package/dist/plugin/apiPath.js.map +1 -0
  623. package/dist/plugin/boundDocument.js +58 -0
  624. package/dist/plugin/boundDocument.js.map +1 -0
  625. package/dist/plugin/buildPhase.js +10 -0
  626. package/dist/plugin/buildPhase.js.map +1 -0
  627. package/dist/plugin/collectionChecks.js +232 -0
  628. package/dist/plugin/collectionChecks.js.map +1 -0
  629. package/dist/plugin/collectionFields.d.ts +13 -0
  630. package/dist/plugin/collectionFields.js +22 -0
  631. package/dist/plugin/collectionFields.js.map +1 -0
  632. package/dist/plugin/createRuntime.js +346 -0
  633. package/dist/plugin/createRuntime.js.map +1 -0
  634. package/dist/plugin/destroy.js +58 -0
  635. package/dist/plugin/destroy.js.map +1 -0
  636. package/dist/plugin/documentEndpoint.js +106 -53
  637. package/dist/plugin/documentEndpoint.js.map +1 -1
  638. package/dist/plugin/documentScopes.js +37 -0
  639. package/dist/plugin/documentScopes.js.map +1 -0
  640. package/dist/plugin/encrypted.js +25 -0
  641. package/dist/plugin/encrypted.js.map +1 -0
  642. package/dist/plugin/errors.d.ts +24 -0
  643. package/dist/plugin/errors.js +86 -0
  644. package/dist/plugin/errors.js.map +1 -0
  645. package/dist/plugin/flagsEndpoint.js +41 -0
  646. package/dist/plugin/flagsEndpoint.js.map +1 -0
  647. package/dist/plugin/goalHint.d.ts +1 -0
  648. package/dist/plugin/goalHint.js +35 -0
  649. package/dist/plugin/goalHint.js.map +1 -0
  650. package/dist/plugin/itemLabels.js +114 -0
  651. package/dist/plugin/itemLabels.js.map +1 -0
  652. package/dist/plugin/keepAlive.js +48 -0
  653. package/dist/plugin/keepAlive.js.map +1 -0
  654. package/dist/plugin/peerImportError.js +3 -6
  655. package/dist/plugin/peerImportError.js.map +1 -1
  656. package/dist/plugin/peers.js +64 -0
  657. package/dist/plugin/peers.js.map +1 -0
  658. package/dist/plugin/pluginCollections.js +161 -0
  659. package/dist/plugin/pluginCollections.js.map +1 -0
  660. package/dist/plugin/queryEndpoint.js +88 -52
  661. package/dist/plugin/queryEndpoint.js.map +1 -1
  662. package/dist/plugin/queryParams.js +7 -0
  663. package/dist/plugin/queryParams.js.map +1 -0
  664. package/dist/plugin/readContextForRequest.d.ts +11 -0
  665. package/dist/plugin/readContextForRequest.js +79 -32
  666. package/dist/plugin/readContextForRequest.js.map +1 -1
  667. package/dist/plugin/readFailure.js +22 -0
  668. package/dist/plugin/readFailure.js.map +1 -0
  669. package/dist/plugin/readableProviders.js +67 -0
  670. package/dist/plugin/readableProviders.js.map +1 -0
  671. package/dist/plugin/realtimeEndpoint.js +91 -21
  672. package/dist/plugin/realtimeEndpoint.js.map +1 -1
  673. package/dist/plugin/refreshEndpoint.js +138 -0
  674. package/dist/plugin/refreshEndpoint.js.map +1 -0
  675. package/dist/plugin/relabelFields.js +36 -0
  676. package/dist/plugin/relabelFields.js.map +1 -0
  677. package/dist/plugin/requestMemo.js +35 -0
  678. package/dist/plugin/requestMemo.js.map +1 -0
  679. package/dist/plugin/routeChecks.js +39 -0
  680. package/dist/plugin/routeChecks.js.map +1 -0
  681. package/dist/plugin/routes.d.ts +53 -0
  682. package/dist/plugin/routes.js +92 -0
  683. package/dist/plugin/routes.js.map +1 -0
  684. package/dist/plugin/runtime.d.ts +1 -1
  685. package/dist/plugin/runtime.js +235 -29
  686. package/dist/plugin/runtime.js.map +1 -1
  687. package/dist/plugin/schemaOnly.js +61 -0
  688. package/dist/plugin/schemaOnly.js.map +1 -0
  689. package/dist/plugin/scopeChange.js +23 -0
  690. package/dist/plugin/scopeChange.js.map +1 -0
  691. package/dist/plugin/scopeFieldBoot.js +4 -4
  692. package/dist/plugin/scopeFieldBoot.js.map +1 -1
  693. package/dist/plugin/scopeToken.js +33 -0
  694. package/dist/plugin/scopeToken.js.map +1 -0
  695. package/dist/plugin/sourcesEndpoint.js +50 -16
  696. package/dist/plugin/sourcesEndpoint.js.map +1 -1
  697. package/dist/plugin/unbundledLanguages.js +25 -0
  698. package/dist/plugin/unbundledLanguages.js.map +1 -0
  699. package/dist/plugin/walkFields.js +24 -0
  700. package/dist/plugin/walkFields.js.map +1 -0
  701. package/dist/plugin/warmTask.js +0 -0
  702. package/dist/plugin/warmTask.js.map +1 -1
  703. package/dist/providers/ProvidersListNotice.d.ts +11 -0
  704. package/dist/providers/ProvidersListNotice.js +36 -0
  705. package/dist/providers/ProvidersListNotice.js.map +1 -0
  706. package/dist/providers/access.d.ts +1 -0
  707. package/dist/providers/access.js +35 -26
  708. package/dist/providers/access.js.map +1 -1
  709. package/dist/providers/adapterPool.js +121 -0
  710. package/dist/providers/adapterPool.js.map +1 -0
  711. package/dist/providers/collection.d.ts +63 -0
  712. package/dist/providers/collection.js +372 -143
  713. package/dist/providers/collection.js.map +1 -1
  714. package/dist/providers/factory.d.ts +84 -0
  715. package/dist/providers/factory.js +86 -25
  716. package/dist/providers/factory.js.map +1 -1
  717. package/dist/providers/hosts.d.ts +25 -0
  718. package/dist/providers/hosts.js +128 -0
  719. package/dist/providers/hosts.js.map +1 -0
  720. package/dist/providers/probe.d.ts +1 -0
  721. package/dist/providers/probe.js +105 -0
  722. package/dist/providers/probe.js.map +1 -0
  723. package/dist/providers/refresh.d.ts +18 -0
  724. package/dist/providers/refresh.js +49 -0
  725. package/dist/providers/refresh.js.map +1 -0
  726. package/dist/providers/registry.js +329 -0
  727. package/dist/providers/registry.js.map +1 -0
  728. package/dist/providers/resolver.js +26 -88
  729. package/dist/providers/resolver.js.map +1 -1
  730. package/dist/providers/retarget.js +45 -0
  731. package/dist/providers/retarget.js.map +1 -0
  732. package/dist/providers/scopeUnique.js +41 -0
  733. package/dist/providers/scopeUnique.js.map +1 -0
  734. package/dist/providers/secrets.d.ts +26 -0
  735. package/dist/providers/secrets.js +61 -4
  736. package/dist/providers/secrets.js.map +1 -1
  737. package/dist/providers/stampScope.js +9 -6
  738. package/dist/providers/stampScope.js.map +1 -1
  739. package/dist/query/dates.js +10 -12
  740. package/dist/query/dates.js.map +1 -1
  741. package/dist/query/errors.d.ts +6 -13
  742. package/dist/query/fetchQuery.d.ts +36 -23
  743. package/dist/query/fetchQuery.js +96 -89
  744. package/dist/query/fetchQuery.js.map +1 -1
  745. package/dist/query/limits.js +8 -0
  746. package/dist/query/limits.js.map +1 -0
  747. package/dist/query/parse.d.ts +8 -2
  748. package/dist/query/parse.js +155 -108
  749. package/dist/query/parse.js.map +1 -1
  750. package/dist/query/response.d.ts +27 -4
  751. package/dist/query/response.js +18 -0
  752. package/dist/query/response.js.map +1 -0
  753. package/dist/react/AnalyticsProvider.d.ts +42 -20
  754. package/dist/react/AnalyticsProvider.js +24 -22
  755. package/dist/react/AnalyticsProvider.js.map +1 -1
  756. package/dist/react/TrackerBoot.js +15 -9
  757. package/dist/react/TrackerBoot.js.map +1 -1
  758. package/dist/react/useAnalytics.d.ts +2 -8
  759. package/dist/react/useAnalytics.js +31 -13
  760. package/dist/react/useAnalytics.js.map +1 -1
  761. package/dist/routes/captureRoute.d.ts +28 -0
  762. package/dist/routes/captureRoute.js +67 -0
  763. package/dist/routes/captureRoute.js.map +1 -0
  764. package/dist/routes/ingestRoute.d.ts +17 -0
  765. package/dist/routes/ingestRoute.js +17 -0
  766. package/dist/routes/ingestRoute.js.map +1 -0
  767. package/dist/site/AnalyticsScripts.d.ts +35 -0
  768. package/dist/site/AnalyticsScripts.js +44 -0
  769. package/dist/site/AnalyticsScripts.js.map +1 -0
  770. package/dist/site/getTrackerConfig.d.ts +15 -0
  771. package/dist/site/getTrackerConfig.js +43 -0
  772. package/dist/site/getTrackerConfig.js.map +1 -0
  773. package/dist/surfacing/afterRead.d.ts +37 -0
  774. package/dist/surfacing/bounded.js +38 -0
  775. package/dist/surfacing/bounded.js.map +1 -0
  776. package/dist/surfacing/breaker.js +107 -0
  777. package/dist/surfacing/breaker.js.map +1 -0
  778. package/dist/surfacing/cacheCollection.d.ts +8 -0
  779. package/dist/surfacing/cacheCollection.js +71 -0
  780. package/dist/surfacing/cacheCollection.js.map +1 -0
  781. package/dist/surfacing/cacheStore.d.ts +71 -1
  782. package/dist/surfacing/cacheStore.js +16 -37
  783. package/dist/surfacing/cacheStore.js.map +1 -1
  784. package/dist/surfacing/cacheSweep.d.ts +1 -0
  785. package/dist/surfacing/cacheSweep.js +59 -0
  786. package/dist/surfacing/cacheSweep.js.map +1 -0
  787. package/dist/surfacing/classifyError.js +282 -0
  788. package/dist/surfacing/classifyError.js.map +1 -0
  789. package/dist/surfacing/coalesce.js +2 -1
  790. package/dist/surfacing/coalesce.js.map +1 -1
  791. package/dist/surfacing/coldBudget.js +60 -0
  792. package/dist/surfacing/coldBudget.js.map +1 -0
  793. package/dist/surfacing/collectionCacheStore.js +183 -0
  794. package/dist/surfacing/collectionCacheStore.js.map +1 -0
  795. package/dist/surfacing/engine.d.ts +1 -1
  796. package/dist/surfacing/engine.js +514 -71
  797. package/dist/surfacing/engine.js.map +1 -1
  798. package/dist/surfacing/epoch.d.ts +1 -0
  799. package/dist/surfacing/epoch.js +116 -0
  800. package/dist/surfacing/epoch.js.map +1 -0
  801. package/dist/surfacing/lanes.d.ts +1 -0
  802. package/dist/surfacing/lanes.js +297 -0
  803. package/dist/surfacing/lanes.js.map +1 -0
  804. package/dist/surfacing/memo.js +40 -0
  805. package/dist/surfacing/memo.js.map +1 -0
  806. package/dist/surfacing/rateLimiter.d.ts +1 -0
  807. package/dist/surfacing/rateLimiter.js +69 -94
  808. package/dist/surfacing/rateLimiter.js.map +1 -1
  809. package/dist/surfacing/rebucket.js +178 -0
  810. package/dist/surfacing/rebucket.js.map +1 -0
  811. package/dist/surfacing/recipe.js +28 -0
  812. package/dist/surfacing/recipe.js.map +1 -0
  813. package/dist/surfacing/shape.js +22 -0
  814. package/dist/surfacing/shape.js.map +1 -0
  815. package/dist/surfacing/todaySplit.js +119 -0
  816. package/dist/surfacing/todaySplit.js.map +1 -0
  817. package/dist/sync/collection.d.ts +8 -0
  818. package/dist/sync/collection.js +30 -18
  819. package/dist/sync/collection.js.map +1 -1
  820. package/dist/sync/rekeyDurations.js +70 -0
  821. package/dist/sync/rekeyDurations.js.map +1 -0
  822. package/dist/sync/syncTask.js +222 -109
  823. package/dist/sync/syncTask.js.map +1 -1
  824. package/dist/testing/memoryAdapter.d.ts +6 -3
  825. package/dist/testing/memoryAdapter.js +12 -11
  826. package/dist/testing/memoryAdapter.js.map +1 -1
  827. package/dist/testing/settle.d.ts +11 -0
  828. package/dist/testing/settle.js +19 -0
  829. package/dist/testing/settle.js.map +1 -0
  830. package/dist/timeframe/calendar.js +65 -0
  831. package/dist/timeframe/calendar.js.map +1 -0
  832. package/dist/timeframe/comparison.js +46 -0
  833. package/dist/timeframe/comparison.js.map +1 -0
  834. package/dist/timeframe/presets.d.ts +1 -1
  835. package/dist/timeframe/presets.js +5 -5
  836. package/dist/timeframe/presets.js.map +1 -1
  837. package/dist/timeframe/reportingTimezone.d.ts +1 -0
  838. package/dist/timeframe/reportingTimezone.js +64 -0
  839. package/dist/timeframe/reportingTimezone.js.map +1 -0
  840. package/dist/timeframe/tz.js +55 -39
  841. package/dist/timeframe/tz.js.map +1 -1
  842. package/dist/tracker/autoCapture.js +125 -38
  843. package/dist/tracker/autoCapture.js.map +1 -1
  844. package/dist/tracker/campaign.js +52 -0
  845. package/dist/tracker/campaign.js.map +1 -0
  846. package/dist/tracker/config.d.ts +174 -0
  847. package/dist/tracker/config.js +25 -0
  848. package/dist/tracker/config.js.map +1 -0
  849. package/dist/tracker/createTracker.d.ts +5 -10
  850. package/dist/tracker/createTracker.js +437 -82
  851. package/dist/tracker/createTracker.js.map +1 -1
  852. package/dist/tracker/digest.js +28 -0
  853. package/dist/tracker/digest.js.map +1 -0
  854. package/dist/tracker/engagement.js +100 -0
  855. package/dist/tracker/engagement.js.map +1 -0
  856. package/dist/tracker/events.js +37 -0
  857. package/dist/tracker/events.js.map +1 -0
  858. package/dist/tracker/exclusion.d.ts +8 -0
  859. package/dist/tracker/exclusion.js +82 -0
  860. package/dist/tracker/exclusion.js.map +1 -0
  861. package/dist/tracker/gate.d.ts +8 -0
  862. package/dist/tracker/gate.js +244 -0
  863. package/dist/tracker/gate.js.map +1 -0
  864. package/dist/tracker/initTracker.d.ts +5 -8
  865. package/dist/tracker/initTracker.js +42 -14
  866. package/dist/tracker/initTracker.js.map +1 -1
  867. package/dist/tracker/itemCapture.js +224 -0
  868. package/dist/tracker/itemCapture.js.map +1 -0
  869. package/dist/tracker/loadScript.js +23 -15
  870. package/dist/tracker/loadScript.js.map +1 -1
  871. package/dist/tracker/pageTracking.js +6 -6
  872. package/dist/tracker/pageTracking.js.map +1 -1
  873. package/dist/tracker/registry.js +129 -30
  874. package/dist/tracker/registry.js.map +1 -1
  875. package/dist/tracker/sinks/createSink.js +60 -0
  876. package/dist/tracker/sinks/createSink.js.map +1 -0
  877. package/dist/tracker/sinks/ga4.js +106 -0
  878. package/dist/tracker/sinks/ga4.js.map +1 -0
  879. package/dist/tracker/sinks/native.js +21 -42
  880. package/dist/tracker/sinks/native.js.map +1 -1
  881. package/dist/tracker/sinks/plausible.js +36 -18
  882. package/dist/tracker/sinks/plausible.js.map +1 -1
  883. package/dist/tracker/sinks/posthog.js +145 -9
  884. package/dist/tracker/sinks/posthog.js.map +1 -1
  885. package/dist/tracker/sinks/umami.js +18 -10
  886. package/dist/tracker/sinks/umami.js.map +1 -1
  887. package/dist/tracker/sinks/vendor.js +54 -22
  888. package/dist/tracker/sinks/vendor.js.map +1 -1
  889. package/dist/tracker/skip.js +81 -0
  890. package/dist/tracker/skip.js.map +1 -0
  891. package/dist/tracker/storage.js +23 -0
  892. package/dist/tracker/storage.js.map +1 -0
  893. package/dist/tracker/transport.js +2 -5
  894. package/dist/tracker/transport.js.map +1 -1
  895. package/dist/tracker/types.d.ts +99 -44
  896. package/dist/tracker/window.js +7 -0
  897. package/dist/tracker/window.js.map +1 -0
  898. package/dist/translations/ar.js +266 -56
  899. package/dist/translations/ar.js.map +1 -1
  900. package/dist/translations/de.js +256 -55
  901. package/dist/translations/de.js.map +1 -1
  902. package/dist/translations/en.js +253 -56
  903. package/dist/translations/en.js.map +1 -1
  904. package/dist/translations/es.js +261 -57
  905. package/dist/translations/es.js.map +1 -1
  906. package/dist/translations/fr.js +265 -61
  907. package/dist/translations/fr.js.map +1 -1
  908. package/dist/translations/id.js +256 -56
  909. package/dist/translations/id.js.map +1 -1
  910. package/dist/translations/index.d.ts +1 -1
  911. package/dist/translations/index.js +5 -7
  912. package/dist/translations/index.js.map +1 -1
  913. package/dist/translations/intl.js +71 -0
  914. package/dist/translations/intl.js.map +1 -0
  915. package/dist/translations/keys.d.ts +240 -14
  916. package/dist/translations/keys.js +245 -14
  917. package/dist/translations/keys.js.map +1 -1
  918. package/dist/translations/ko.js +258 -58
  919. package/dist/translations/ko.js.map +1 -1
  920. package/dist/translations/labelMap.d.ts +10 -0
  921. package/dist/translations/labelMap.js +22 -0
  922. package/dist/translations/labelMap.js.map +1 -0
  923. package/dist/translations/metricKeys.js +16 -2
  924. package/dist/translations/metricKeys.js.map +1 -1
  925. package/dist/translations/parts.js +20 -0
  926. package/dist/translations/parts.js.map +1 -0
  927. package/dist/translations/plural.js +61 -0
  928. package/dist/translations/plural.js.map +1 -0
  929. package/dist/translations/pt.js +270 -66
  930. package/dist/translations/pt.js.map +1 -1
  931. package/dist/translations/ru.js +261 -55
  932. package/dist/translations/ru.js.map +1 -1
  933. package/dist/translations/server.d.ts +1 -0
  934. package/dist/translations/server.js +2 -3
  935. package/dist/translations/server.js.map +1 -1
  936. package/dist/translations/staticLabel.js +69 -0
  937. package/dist/translations/staticLabel.js.map +1 -0
  938. package/dist/translations/uk.js +261 -55
  939. package/dist/translations/uk.js.map +1 -1
  940. package/dist/translations/zh.js +256 -56
  941. package/dist/translations/zh.js.map +1 -1
  942. package/dist/ui/RangePicker.js +110 -0
  943. package/dist/ui/RangePicker.js.map +1 -0
  944. package/dist/ui/analytics.css +1667 -0
  945. package/dist/ui/calendarDays.js +27 -0
  946. package/dist/ui/calendarDays.js.map +1 -0
  947. package/dist/ui/classNames.js +7 -0
  948. package/dist/ui/classNames.js.map +1 -0
  949. package/dist/ui/components/Card.d.ts +28 -0
  950. package/dist/ui/components/Card.js +21 -0
  951. package/dist/ui/components/Card.js.map +1 -0
  952. package/dist/ui/components/ChartDataTable.d.ts +41 -0
  953. package/dist/ui/components/ChartDataTable.js +48 -0
  954. package/dist/ui/components/ChartDataTable.js.map +1 -0
  955. package/dist/ui/components/ChoiceMenu.js +48 -0
  956. package/dist/ui/components/ChoiceMenu.js.map +1 -0
  957. package/dist/ui/components/DataTable.d.ts +82 -0
  958. package/dist/ui/components/DataTable.js +214 -0
  959. package/dist/ui/components/DataTable.js.map +1 -0
  960. package/dist/ui/components/LabeledSelect.js +62 -0
  961. package/dist/ui/components/LabeledSelect.js.map +1 -0
  962. package/dist/ui/components/LiveAnnouncement.js +21 -0
  963. package/dist/ui/components/LiveAnnouncement.js.map +1 -0
  964. package/dist/ui/components/MetricCard.d.ts +38 -0
  965. package/dist/ui/components/MetricCard.js +39 -0
  966. package/dist/ui/components/MetricCard.js.map +1 -0
  967. package/dist/ui/components/NoValue.js +22 -0
  968. package/dist/ui/components/NoValue.js.map +1 -0
  969. package/dist/ui/components/ReadState.js +27 -0
  970. package/dist/ui/components/ReadState.js.map +1 -0
  971. package/dist/ui/components/RefreshButton.js +25 -0
  972. package/dist/ui/components/RefreshButton.js.map +1 -0
  973. package/dist/ui/components/SourcesNoticeBanner.js +20 -0
  974. package/dist/ui/components/SourcesNoticeBanner.js.map +1 -0
  975. package/dist/ui/cssVars.js +7 -0
  976. package/dist/ui/cssVars.js.map +1 -0
  977. package/dist/ui/data/WithScopeToken.d.ts +20 -0
  978. package/dist/ui/data/WithScopeToken.js +20 -0
  979. package/dist/ui/data/WithScopeToken.js.map +1 -0
  980. package/dist/ui/data/clientFieldProps.js +16 -0
  981. package/dist/ui/data/clientFieldProps.js.map +1 -0
  982. package/dist/ui/data/request.d.ts +46 -0
  983. package/dist/ui/data/request.js +119 -0
  984. package/dist/ui/data/request.js.map +1 -0
  985. package/dist/ui/data/scopeTokenContext.js +18 -0
  986. package/dist/ui/data/scopeTokenContext.js.map +1 -0
  987. package/dist/ui/data/sharedCache.js +48 -0
  988. package/dist/ui/data/sharedCache.js.map +1 -0
  989. package/dist/ui/data/useRequest.d.ts +19 -0
  990. package/dist/ui/data/useRequest.js +123 -0
  991. package/dist/ui/data/useRequest.js.map +1 -0
  992. package/dist/ui/data/useRequestScope.js +25 -0
  993. package/dist/ui/data/useRequestScope.js.map +1 -0
  994. package/dist/ui/hooks/useDirection.js +47 -0
  995. package/dist/ui/hooks/useDirection.js.map +1 -0
  996. package/dist/ui/hooks/useDismissOnEscape.js +25 -0
  997. package/dist/ui/hooks/useDismissOnEscape.js.map +1 -0
  998. package/dist/ui/hooks/useLiveAnnouncement.js +57 -0
  999. package/dist/ui/hooks/useLiveAnnouncement.js.map +1 -0
  1000. package/dist/ui/hooks/useRealtimePoll.js +112 -0
  1001. package/dist/ui/hooks/useRealtimePoll.js.map +1 -0
  1002. package/dist/ui/readState.js +19 -0
  1003. package/dist/ui/readState.js.map +1 -0
  1004. package/dist/ui/rows/toDisplayRows.js +49 -0
  1005. package/dist/ui/rows/toDisplayRows.js.map +1 -0
  1006. package/dist/ui/viewerClock.js +7 -0
  1007. package/dist/ui/viewerClock.js.map +1 -0
  1008. package/dist/view/AnalyticsNavLink.d.ts +5 -3
  1009. package/dist/view/AnalyticsNavLink.js +12 -8
  1010. package/dist/view/AnalyticsNavLink.js.map +1 -1
  1011. package/dist/view/AnalyticsView.d.ts +9 -10
  1012. package/dist/view/AnalyticsView.js +47 -19
  1013. package/dist/view/AnalyticsView.js.map +1 -1
  1014. package/dist/view/AnalyticsViewClient.d.ts +4 -7
  1015. package/dist/view/AnalyticsViewClient.js +15 -174
  1016. package/dist/view/AnalyticsViewClient.js.map +1 -1
  1017. package/dist/view/CountryFlag.d.ts +27 -0
  1018. package/dist/view/CountryFlag.js +44 -0
  1019. package/dist/view/CountryFlag.js.map +1 -0
  1020. package/dist/view/DocumentTitle.js +27 -0
  1021. package/dist/view/DocumentTitle.js.map +1 -0
  1022. package/dist/view/ViewRoot.d.ts +21 -0
  1023. package/dist/view/ViewRoot.js +155 -0
  1024. package/dist/view/ViewRoot.js.map +1 -0
  1025. package/dist/view/ViewSections.d.ts +38 -0
  1026. package/dist/view/ViewSections.js +190 -0
  1027. package/dist/view/ViewSections.js.map +1 -0
  1028. package/dist/view/authRedirect.js +2 -4
  1029. package/dist/view/authRedirect.js.map +1 -1
  1030. package/dist/view/consentShare.js +15 -0
  1031. package/dist/view/consentShare.js.map +1 -0
  1032. package/dist/view/conversionRate.js +9 -7
  1033. package/dist/view/conversionRate.js.map +1 -1
  1034. package/dist/view/dayRange.js +6 -10
  1035. package/dist/view/dayRange.js.map +1 -1
  1036. package/dist/view/exclusionLink.d.ts +27 -0
  1037. package/dist/view/exclusionLink.js +46 -0
  1038. package/dist/view/exclusionLink.js.map +1 -0
  1039. package/dist/view/flagSrc.js +14 -0
  1040. package/dist/view/flagSrc.js.map +1 -0
  1041. package/dist/view/gating.d.ts +15 -1
  1042. package/dist/view/gating.js +92 -20
  1043. package/dist/view/gating.js.map +1 -1
  1044. package/dist/view/hostCountryFlag.js +41 -0
  1045. package/dist/view/hostCountryFlag.js.map +1 -0
  1046. package/dist/view/labels.js +120 -3
  1047. package/dist/view/labels.js.map +1 -1
  1048. package/dist/view/metricAliases.js +10 -0
  1049. package/dist/view/metricAliases.js.map +1 -0
  1050. package/dist/view/navLabel.js +15 -0
  1051. package/dist/view/navLabel.js.map +1 -0
  1052. package/dist/view/registerView.js +13 -11
  1053. package/dist/view/registerView.js.map +1 -1
  1054. package/dist/view/scopeLabel.js +21 -0
  1055. package/dist/view/scopeLabel.js.map +1 -0
  1056. package/dist/view/sections/Breakdowns.js +221 -118
  1057. package/dist/view/sections/Breakdowns.js.map +1 -1
  1058. package/dist/view/sections/EmptyStates.js +120 -32
  1059. package/dist/view/sections/EmptyStates.js.map +1 -1
  1060. package/dist/view/sections/ExcludeBrowser.js +188 -0
  1061. package/dist/view/sections/ExcludeBrowser.js.map +1 -0
  1062. package/dist/view/sections/FilterChips.js +130 -25
  1063. package/dist/view/sections/FilterChips.js.map +1 -1
  1064. package/dist/view/sections/GoalsPanel.js +68 -59
  1065. package/dist/view/sections/GoalsPanel.js.map +1 -1
  1066. package/dist/view/sections/OverviewCards.js +42 -36
  1067. package/dist/view/sections/OverviewCards.js.map +1 -1
  1068. package/dist/view/sections/RealtimeStrip.js +70 -56
  1069. package/dist/view/sections/RealtimeStrip.js.map +1 -1
  1070. package/dist/view/sections/SectionBoundary.js +34 -0
  1071. package/dist/view/sections/SectionBoundary.js.map +1 -0
  1072. package/dist/view/sections/Toolbar.d.ts +11 -0
  1073. package/dist/view/sections/Toolbar.js +182 -116
  1074. package/dist/view/sections/Toolbar.js.map +1 -1
  1075. package/dist/view/sections/Trend.js +179 -73
  1076. package/dist/view/sections/Trend.js.map +1 -1
  1077. package/dist/view/state.d.ts +42 -0
  1078. package/dist/view/state.js +97 -53
  1079. package/dist/view/state.js.map +1 -1
  1080. package/dist/view/useViewClock.js +31 -0
  1081. package/dist/view/useViewClock.js.map +1 -0
  1082. package/dist/view/useViewQueries.d.ts +21 -0
  1083. package/dist/view/useViewQueries.js +50 -79
  1084. package/dist/view/useViewQueries.js.map +1 -1
  1085. package/dist/view/useViewState.js +42 -0
  1086. package/dist/view/useViewState.js.map +1 -0
  1087. package/dist/view/useViewUrl.js +52 -0
  1088. package/dist/view/useViewUrl.js.map +1 -0
  1089. package/dist/view/viewBody.js +30 -0
  1090. package/dist/view/viewBody.js.map +1 -0
  1091. package/dist/view/viewContext.d.ts +81 -0
  1092. package/dist/view/viewContext.js +49 -0
  1093. package/dist/view/viewContext.js.map +1 -0
  1094. package/dist/view/viewProps.d.ts +65 -8
  1095. package/dist/view/viewProps.js +123 -36
  1096. package/dist/view/viewProps.js.map +1 -1
  1097. package/dist/widgets/AnalyticsBreakdownWidget.d.ts +7 -3
  1098. package/dist/widgets/AnalyticsBreakdownWidget.js +153 -78
  1099. package/dist/widgets/AnalyticsBreakdownWidget.js.map +1 -1
  1100. package/dist/widgets/AnalyticsGoalsWidget.d.ts +6 -7
  1101. package/dist/widgets/AnalyticsGoalsWidget.js +126 -159
  1102. package/dist/widgets/AnalyticsGoalsWidget.js.map +1 -1
  1103. package/dist/widgets/AnalyticsMetricWidget.d.ts +7 -3
  1104. package/dist/widgets/AnalyticsMetricWidget.js +85 -83
  1105. package/dist/widgets/AnalyticsMetricWidget.js.map +1 -1
  1106. package/dist/widgets/AnalyticsRealtimeWidget.d.ts +7 -3
  1107. package/dist/widgets/AnalyticsRealtimeWidget.js +81 -61
  1108. package/dist/widgets/AnalyticsRealtimeWidget.js.map +1 -1
  1109. package/dist/widgets/AnalyticsTrendWidget.d.ts +7 -3
  1110. package/dist/widgets/AnalyticsTrendWidget.js +134 -100
  1111. package/dist/widgets/AnalyticsTrendWidget.js.map +1 -1
  1112. package/dist/widgets/ComparisonDelta.js +33 -42
  1113. package/dist/widgets/ComparisonDelta.js.map +1 -1
  1114. package/dist/widgets/RealtimeCounter.d.ts +27 -3
  1115. package/dist/widgets/RealtimeCounter.js +90 -62
  1116. package/dist/widgets/RealtimeCounter.js.map +1 -1
  1117. package/dist/widgets/WidgetCard.d.ts +80 -0
  1118. package/dist/widgets/WidgetCard.js +99 -0
  1119. package/dist/widgets/WidgetCard.js.map +1 -0
  1120. package/dist/widgets/WidgetFrame.js +42 -0
  1121. package/dist/widgets/WidgetFrame.js.map +1 -0
  1122. package/dist/widgets/WidgetShimmer.d.ts +55 -0
  1123. package/dist/widgets/WidgetShimmer.js +86 -0
  1124. package/dist/widgets/WidgetShimmer.js.map +1 -0
  1125. package/dist/widgets/breakdownTypes.js +18 -2
  1126. package/dist/widgets/breakdownTypes.js.map +1 -1
  1127. package/dist/widgets/customWidget.d.ts +5 -1
  1128. package/dist/widgets/customWidget.js +6 -7
  1129. package/dist/widgets/customWidget.js.map +1 -1
  1130. package/dist/widgets/defaultLayout.d.ts +26 -0
  1131. package/dist/widgets/defaultLayout.js +51 -0
  1132. package/dist/widgets/defaultLayout.js.map +1 -0
  1133. package/dist/widgets/defaults.d.ts +4 -3
  1134. package/dist/widgets/defaults.js +76 -24
  1135. package/dist/widgets/defaults.js.map +1 -1
  1136. package/dist/widgets/fieldRows.js +14 -0
  1137. package/dist/widgets/fieldRows.js.map +1 -0
  1138. package/dist/widgets/filterCaption.js +26 -0
  1139. package/dist/widgets/filterCaption.js.map +1 -0
  1140. package/dist/widgets/filterField.d.ts +15 -0
  1141. package/dist/widgets/filterField.js +86 -0
  1142. package/dist/widgets/filterField.js.map +1 -0
  1143. package/dist/widgets/filterValueLabel.d.ts +1 -0
  1144. package/dist/widgets/filterValueLabel.js +45 -0
  1145. package/dist/widgets/filterValueLabel.js.map +1 -0
  1146. package/dist/widgets/notices.js +79 -0
  1147. package/dist/widgets/notices.js.map +1 -0
  1148. package/dist/widgets/prepareWidgetRead.d.ts +24 -0
  1149. package/dist/widgets/prepareWidgetRead.js +110 -0
  1150. package/dist/widgets/prepareWidgetRead.js.map +1 -0
  1151. package/dist/widgets/range.js +26 -21
  1152. package/dist/widgets/range.js.map +1 -1
  1153. package/dist/widgets/readForWidget.d.ts +32 -13
  1154. package/dist/widgets/readForWidget.js +52 -63
  1155. package/dist/widgets/readForWidget.js.map +1 -1
  1156. package/dist/widgets/readForWidgetBreakdown.d.ts +45 -18
  1157. package/dist/widgets/readForWidgetBreakdown.js +71 -58
  1158. package/dist/widgets/readForWidgetBreakdown.js.map +1 -1
  1159. package/dist/widgets/readForWidgetGoals.d.ts +21 -17
  1160. package/dist/widgets/readForWidgetGoals.js +72 -52
  1161. package/dist/widgets/readForWidgetGoals.js.map +1 -1
  1162. package/dist/widgets/readForWidgetRealtime.d.ts +24 -11
  1163. package/dist/widgets/readForWidgetRealtime.js +69 -41
  1164. package/dist/widgets/readForWidgetRealtime.js.map +1 -1
  1165. package/dist/widgets/readForWidgetSeries.d.ts +29 -24
  1166. package/dist/widgets/readForWidgetSeries.js +66 -114
  1167. package/dist/widgets/readForWidgetSeries.js.map +1 -1
  1168. package/dist/widgets/readMeta.d.ts +48 -0
  1169. package/dist/widgets/readMeta.js +66 -0
  1170. package/dist/widgets/readMeta.js.map +1 -0
  1171. package/dist/widgets/realtimePoll.d.ts +1 -0
  1172. package/dist/widgets/realtimePoll.js +56 -16
  1173. package/dist/widgets/realtimePoll.js.map +1 -1
  1174. package/dist/widgets/registerWidgets.js +207 -124
  1175. package/dist/widgets/registerWidgets.js.map +1 -1
  1176. package/dist/widgets/stateKeys.js +30 -0
  1177. package/dist/widgets/stateKeys.js.map +1 -0
  1178. package/dist/widgets/titleForecast.js +89 -0
  1179. package/dist/widgets/titleForecast.js.map +1 -0
  1180. package/dist/widgets/types.d.ts +16 -0
  1181. package/dist/widgets/types.js +2 -0
  1182. package/dist/widgets/types.js.map +1 -1
  1183. package/dist/widgets/viewLink.d.ts +24 -6
  1184. package/dist/widgets/viewLink.js +36 -26
  1185. package/dist/widgets/viewLink.js.map +1 -1
  1186. package/dist/widgets/widgetData.js +34 -0
  1187. package/dist/widgets/widgetData.js.map +1 -0
  1188. package/dist/widgets/widgetWindow.d.ts +1 -0
  1189. package/dist/widgets/widgetWindow.js +51 -0
  1190. package/dist/widgets/widgetWindow.js.map +1 -0
  1191. package/package.json +61 -42
  1192. package/dist/capture/getTrackerConfig.d.ts +0 -20
  1193. package/dist/capture/getTrackerConfig.js +0 -31
  1194. package/dist/capture/getTrackerConfig.js.map +0 -1
  1195. package/dist/capture/slots.d.ts +0 -8
  1196. package/dist/capture/trackerConfig.d.ts +0 -33
  1197. package/dist/charts/styles.js +0 -59
  1198. package/dist/charts/styles.js.map +0 -1
  1199. package/dist/exports/next.d.ts +0 -3
  1200. package/dist/exports/next.js +0 -3
  1201. package/dist/fields/config/SourceSelectField.d.ts +0 -14
  1202. package/dist/fields/dateRange/styles.js +0 -23
  1203. package/dist/fields/dateRange/styles.js.map +0 -1
  1204. package/dist/goals/GoalSelectField.d.ts +0 -7
  1205. package/dist/native/collections/events.js +0 -121
  1206. package/dist/native/collections/events.js.map +0 -1
  1207. package/dist/native/collections/rollups.js +0 -151
  1208. package/dist/native/collections/rollups.js.map +0 -1
  1209. package/dist/native/collections/seen.js +0 -47
  1210. package/dist/native/collections/seen.js.map +0 -1
  1211. package/dist/native/ingest/flushBatch.js +0 -60
  1212. package/dist/native/ingest/flushBatch.js.map +0 -1
  1213. package/dist/native/ingest/salt.js +0 -14
  1214. package/dist/native/ingest/salt.js.map +0 -1
  1215. package/dist/native/ingest/writeBuffer.js +0 -55
  1216. package/dist/native/ingest/writeBuffer.js.map +0 -1
  1217. package/dist/native/ingest/writeEvent.js +0 -14
  1218. package/dist/native/ingest/writeEvent.js.map +0 -1
  1219. package/dist/native/query/eventAgg.js +0 -161
  1220. package/dist/native/query/eventAgg.js.map +0 -1
  1221. package/dist/native/realtime/buildRealtime.js +0 -53
  1222. package/dist/native/realtime/buildRealtime.js.map +0 -1
  1223. package/dist/native/retention/pruneTask.js +0 -29
  1224. package/dist/native/retention/pruneTask.js.map +0 -1
  1225. package/dist/native/rollupAcc.js +0 -64
  1226. package/dist/native/rollupAcc.js.map +0 -1
  1227. package/dist/native/rollups/applyDistinctDeltas.js +0 -9
  1228. package/dist/native/rollups/applyDistinctDeltas.js.map +0 -1
  1229. package/dist/native/rollups/bumpRollup.js +0 -73
  1230. package/dist/native/rollups/bumpRollup.js.map +0 -1
  1231. package/dist/native/rollups/deltas.js +0 -90
  1232. package/dist/native/rollups/deltas.js.map +0 -1
  1233. package/dist/native/rollups/insertIfNew.js +0 -53
  1234. package/dist/native/rollups/insertIfNew.js.map +0 -1
  1235. package/dist/next/captureRewrites.d.ts +0 -41
  1236. package/dist/next/captureRewrites.js +0 -56
  1237. package/dist/next/captureRewrites.js.map +0 -1
  1238. package/dist/next/posthogProxyRewrites.d.ts +0 -41
  1239. package/dist/next/posthogProxyRewrites.js +0 -45
  1240. package/dist/next/posthogProxyRewrites.js.map +0 -1
  1241. package/dist/plugin/paths.js +0 -27
  1242. package/dist/plugin/paths.js.map +0 -1
  1243. package/dist/query/errors.js +0 -10
  1244. package/dist/query/errors.js.map +0 -1
  1245. package/dist/react/TrackerBoot.d.ts +0 -22
  1246. package/dist/rsc/AnalyticsScripts.d.ts +0 -30
  1247. package/dist/rsc/AnalyticsScripts.js +0 -41
  1248. package/dist/rsc/AnalyticsScripts.js.map +0 -1
  1249. package/dist/surfacing/queue.js +0 -60
  1250. package/dist/surfacing/queue.js.map +0 -1
  1251. package/dist/surfacing/retryPolicy.js +0 -15
  1252. package/dist/surfacing/retryPolicy.js.map +0 -1
  1253. package/dist/tracker/autoCapture.d.ts +0 -48
  1254. package/dist/tracker/consent.d.ts +0 -24
  1255. package/dist/tracker/consent.js +0 -48
  1256. package/dist/tracker/consent.js.map +0 -1
  1257. package/dist/tracker/loadScript.d.ts +0 -14
  1258. package/dist/tracker/pageTracking.d.ts +0 -17
  1259. package/dist/tracker/registry.d.ts +0 -27
  1260. package/dist/tracker/sinks/native.d.ts +0 -22
  1261. package/dist/tracker/sinks/plausible.d.ts +0 -14
  1262. package/dist/tracker/sinks/posthog.d.ts +0 -14
  1263. package/dist/tracker/sinks/umami.d.ts +0 -13
  1264. package/dist/tracker/sinks/vendor.d.ts +0 -14
  1265. package/dist/view/sections/styles.js +0 -74
  1266. package/dist/view/sections/styles.js.map +0 -1
  1267. package/dist/widgets/WidgetViewLink.js +0 -17
  1268. package/dist/widgets/WidgetViewLink.js.map +0 -1
  1269. package/dist/widgets/cardChrome.d.ts +0 -8
  1270. package/dist/widgets/cardChrome.js +0 -46
  1271. package/dist/widgets/cardChrome.js.map +0 -1
  1272. package/dist/widgets/comparison.js +0 -43
  1273. package/dist/widgets/comparison.js.map +0 -1
@@ -0,0 +1 @@
1
+ {"version":3,"file":"writeBuffer.js","names":["startTimer","stopTimer"],"sources":["../../../src/native/engine/writeBuffer.ts"],"sourcesContent":["import { setTimeout as startTimer, clearTimeout as stopTimer } from 'node:timers'\nimport { monotonicMs } from '../../core/monotonic'\nimport { isRecord } from '../../core/values'\nimport { isRowError } from '../../db/errors'\nimport { isOrderHitId } from '../store/ids'\nimport type { AppendResult, EventStore, HitRow } from '../store/types'\n\nexport interface WriteBufferLimits {\n\t/** Hits one write to the store carries at most. */\n\tmaxSize: number\n\t/** How long the first hit of a batch waits for its write. */\n\tmaxAgeMs: number\n\t/** Hits held at once, waiting or being written; past it, a new one waits for a write. */\n\tmaxPending: number\n}\n\nexport const DEFAULT_WRITE_BUFFER: Readonly<WriteBufferLimits> = {\n\tmaxSize: 200,\n\tmaxAgeMs: 1000,\n\tmaxPending: 5000,\n}\n\n/** `native({ buffer })`: off unless set; `true` takes defaults, an object overrides any of them. */\nexport type WriteBufferOption = boolean | Partial<WriteBufferLimits>\n\nconst wholeLimit = (value: unknown, name: keyof WriteBufferLimits): number => {\n\tif (typeof value !== 'number' || !Number.isInteger(value) || value < 1) {\n\t\tthrow new Error(\n\t\t\t`analytics: native buffer.${name} must be a whole number of at least 1, got ${String(value)}`\n\t\t)\n\t}\n\treturn value\n}\n\n/** The limits an option asks for, null for no buffer; limits no buffer could keep fail the boot. */\nexport const resolveWriteBuffer = (\n\toption: WriteBufferOption | undefined\n): WriteBufferLimits | null => {\n\tif (option === undefined || option === false) {\n\t\treturn null\n\t}\n\tif (option !== true && (!isRecord(option) || Array.isArray(option))) {\n\t\tthrow new Error('analytics: native buffer must be true, false or an object of limits')\n\t}\n\tconst given = option === true ? {} : option\n\tconst limits: WriteBufferLimits = {\n\t\tmaxSize: wholeLimit(given.maxSize ?? DEFAULT_WRITE_BUFFER.maxSize, 'maxSize'),\n\t\tmaxAgeMs: wholeLimit(given.maxAgeMs ?? DEFAULT_WRITE_BUFFER.maxAgeMs, 'maxAgeMs'),\n\t\tmaxPending: wholeLimit(given.maxPending ?? DEFAULT_WRITE_BUFFER.maxPending, 'maxPending'),\n\t}\n\tif (limits.maxPending < limits.maxSize) {\n\t\tthrow new Error(\n\t\t\t`analytics: native buffer.maxPending (${limits.maxPending}) must be at least buffer.maxSize (${limits.maxSize})`\n\t\t)\n\t}\n\treturn limits\n}\n\n/** Environment variables a serverless platform sets in every function it runs. */\nconst SERVERLESS_ENV: readonly string[] = ['VERCEL', 'AWS_LAMBDA_FUNCTION_NAME', 'NETLIFY']\n\n/** The variable that gives a serverless platform away, or undefined when none is set. */\nexport const serverlessPlatformOf = (\n\tenv: Readonly<Record<string, string | undefined>>\n): string | undefined => SERVERLESS_ENV.find((name) => (env[name] ?? '') !== '')\n\n/** One line about dropped hits at most this often, whatever the database does. */\nconst DROP_LOG_INTERVAL_MS = 60_000\n\n/** How long a batch the database refused as a whole waits before its one retry. */\nexport const BATCH_RETRY_MS = 500\n\n/** How long a SIGTERM or SIGINT waits for the last write before the signal is handed on. */\nconst SIGNAL_FLUSH_MS = 5_000\n\n/** How often deferred work asks whether it may run. */\nconst DEFER_POLL_MS = 50\n\n/** How long deferred work waits at most before it runs anyway. */\nexport const DEFER_MAX_MS = 600_000\n\n/** Deferred work held at once, waiting or running: past it, more is dropped and logged. */\nexport const MAX_DEFERRED = 10_000\n\n/** The signals that stop a process and that a writer answers by writing what it holds first. */\ntype StopSignal = 'SIGTERM' | 'SIGINT'\n\nconst STOP_SIGNALS: readonly StopSignal[] = ['SIGTERM', 'SIGINT']\n\n/** What the writer needs of a process to write what it holds when the process is told to stop. */\nexport interface ShutdownSignals {\n\treadonly pid: number\n\ton(event: 'beforeExit' | 'exit' | StopSignal, listener: () => void): unknown\n\toff(event: 'beforeExit' | 'exit' | StopSignal, listener: () => void): unknown\n\tlistenerCount(event: StopSignal): number\n\tkill(pid: number, signal: StopSignal): unknown\n}\n\n/** The slice of Payload's logger the writer speaks through. */\ninterface WriterLogger {\n\twarn(message: string): void\n\terror(details: { err: unknown; msg: string }): void\n}\n\nexport interface HitWriterOptions {\n\tstore: Pick<EventStore, 'append'>\n\tbuffer?: WriteBufferOption\n\tlogger?: WriterLogger\n\t/** The process whose shutdown writes the buffer out: Node's own unless a test hands one in. */\n\tsignals?: ShutdownSignals\n\t/** What the serverless check reads: `process.env` unless a test hands one in. */\n\tenv?: Readonly<Record<string, string | undefined>>\n\tnow?: () => number\n\t/** Starts a one-shot timer and answers how to cancel it. */\n\tsetTimer?: (run: () => void, ms: number) => () => void\n}\n\nexport interface HitWriter {\n\t/**\n\t * Stores one hit, buffered unless an order, `flush: true` or a closed writer. A buffered write\n\t * resolves once queued (waiting only at `maxPending`) and answers nothing; a direct one does.\n\t */\n\twrite(hit: HitRow, options?: { flush?: boolean }): Promise<AppendResult | undefined>\n\t/**\n\t * Runs `work` once `blocked` answers false, for a hit recorded inside a host's open SQLite\n\t * transaction. Never rejects; past {@link DEFER_MAX_MS}, or on `close`, it runs anyway.\n\t */\n\tdefer(work: () => Promise<void>, blocked: () => boolean): void\n\t/** Runs the deferred work that may run, then writes everything buffered so far; never rejects. */\n\tflush(): Promise<void>\n\t/** Runs every deferred work, writes what is buffered and takes the process listeners back. */\n\tclose(): Promise<void>\n\t/** Hits held in the buffer: waiting, and in the write under way. Deferred work is not one. */\n\tpending(): number\n}\n\nconst unrefTimer = (run: () => void, ms: number): (() => void) => {\n\t// A pending write must never be what keeps a process, or a test run, alive.\n\tconst handle = startTimer(run, ms).unref()\n\treturn () => stopTimer(handle)\n}\n\n/** Resolves when `work` settles or `ms` has passed, whichever comes first. */\nconst settleWithin = (work: Promise<void>, ms: number): Promise<void> =>\n\tnew Promise((resolve) => {\n\t\tconst cancel = unrefTimer(resolve, ms)\n\t\tvoid work.finally(() => {\n\t\t\tcancel()\n\t\t\tresolve()\n\t\t})\n\t})\n\n/** Reports failures at most once a minute, with how many there were since the last line. */\nconst rateLimitedReport = (\n\tlogger: WriterLogger | undefined,\n\tnow: () => number,\n\tmessage: (count: number) => string\n): ((count: number, error: unknown) => void) => {\n\tlet missed = 0\n\tlet loggedAt: number | null = null\n\treturn (count, error) => {\n\t\tmissed += count\n\t\tconst at = now()\n\t\tif (loggedAt !== null && at - loggedAt < DROP_LOG_INTERVAL_MS) {\n\t\t\treturn\n\t\t}\n\t\tloggedAt = at\n\t\tlogger?.error({ err: error, msg: message(missed) })\n\t\tmissed = 0\n\t}\n}\n\ninterface DeferredWork {\n\twork: () => Promise<void>\n\tblocked: () => boolean\n\tsince: number\n}\n\n/** Work that waits its turn, asked on a timer whether it may run yet; at most `MAX_DEFERRED`. */\nconst createDeferrals = (args: {\n\tnow: () => number\n\tsetTimer: (run: () => void, ms: number) => () => void\n\tfailed: (error: unknown) => void\n\t/** Work refused, `MAX_DEFERRED` waiting or running already. */\n\tdropped: () => void\n}) => {\n\tlet waiting: DeferredWork[] = []\n\tconst running = new Set<Promise<void>>()\n\tlet cancel: (() => void) | null = null\n\n\tconst mayRun = (entry: DeferredWork, force: boolean): boolean => {\n\t\tif (force || args.now() - entry.since >= DEFER_MAX_MS) {\n\t\t\treturn true\n\t\t}\n\t\ttry {\n\t\t\treturn !entry.blocked()\n\t\t} catch {\n\t\t\treturn true\n\t\t}\n\t}\n\n\tconst start = (entry: DeferredWork): void => {\n\t\tconst task = entry.work().catch(args.failed)\n\t\trunning.add(task)\n\t\tvoid task.then(() => running.delete(task))\n\t}\n\n\tconst poll = (force: boolean): void => {\n\t\tcancel?.()\n\t\tcancel = null\n\t\tconst still: DeferredWork[] = []\n\t\tfor (const entry of waiting) {\n\t\t\tif (mayRun(entry, force)) {\n\t\t\t\tstart(entry)\n\t\t\t} else {\n\t\t\t\tstill.push(entry)\n\t\t\t}\n\t\t}\n\t\twaiting = still\n\t\tif (waiting.length > 0) {\n\t\t\tcancel = args.setTimer(() => poll(false), DEFER_POLL_MS)\n\t\t}\n\t}\n\n\treturn {\n\t\tadd(work: () => Promise<void>, blocked: () => boolean): void {\n\t\t\tif (waiting.length + running.size >= MAX_DEFERRED) {\n\t\t\t\targs.dropped()\n\t\t\t\treturn\n\t\t\t}\n\t\t\twaiting.push({ work, blocked, since: args.now() })\n\t\t\tpoll(false)\n\t\t},\n\t\t/** Work not finished yet, waiting or running. */\n\t\theld: (): number => waiting.length + running.size,\n\t\t/** Starts what may run (everything, when forced) and waits for all of it to finish. */\n\t\tasync settle(force: boolean): Promise<void> {\n\t\t\tpoll(force)\n\t\t\twhile (running.size > 0) {\n\t\t\t\tawait Promise.allSettled([...running])\n\t\t\t}\n\t\t},\n\t}\n}\n\n/**\n * Writes what a writer holds before the process goes: on SIGTERM and SIGINT, then hands the signal\n * back; when the event loop runs dry; and on `exit`, where no write can run, warns what is lost.\n */\nconst guardShutdown = (args: {\n\tsignals: ShutdownSignals\n\tlogger: WriterLogger | undefined\n\t/** Hits and deferred work not stored yet. */\n\theld: () => number\n\t/** Runs every deferred work and writes everything held; `stopping` once the process goes. */\n\tsettle: (stopping: boolean) => Promise<void>\n}) => {\n\tconst { signals } = args\n\tlet listening = false\n\tlet settling: Promise<void> | null = null\n\tconst settleOnce = (stopping: boolean): Promise<void> => {\n\t\tsettling ??= args.settle(stopping).finally(() => {\n\t\t\tsettling = null\n\t\t})\n\t\treturn settling\n\t}\n\tconst onBeforeExit = (): void => {\n\t\t// Writing schedules more work, which empties the loop again: only start while work is held.\n\t\tif (args.held() > 0 && settling === null) {\n\t\t\tvoid settleOnce(false)\n\t\t}\n\t}\n\tconst onExit = (): void => {\n\t\tconst lost = args.held()\n\t\tif (lost > 0) {\n\t\t\targs.logger?.warn(\n\t\t\t\t`analytics: the process exited with ${lost} hits not stored yet, and they are lost. Destroy Payload (await payload.destroy()) before calling process.exit() to store them.`\n\t\t\t)\n\t\t}\n\t}\n\t// Each writer lets go only once its own write is done, so with several instances in one process\n\t// the last one out hands the signal back: a listener otherwise keeps Node from stopping.\n\tconst onSignal = (signal: StopSignal) => (): void => {\n\t\tvoid settleWithin(settleOnce(true), SIGNAL_FLUSH_MS).then(() => {\n\t\t\trelease()\n\t\t\tif (signals.listenerCount(signal) === 0) {\n\t\t\t\tsignals.kill(signals.pid, signal)\n\t\t\t}\n\t\t})\n\t}\n\tconst handlers = new Map(STOP_SIGNALS.map((signal) => [signal, onSignal(signal)]))\n\tconst release = (): void => {\n\t\tif (!listening) {\n\t\t\treturn\n\t\t}\n\t\tlistening = false\n\t\tsignals.off('beforeExit', onBeforeExit)\n\t\tsignals.off('exit', onExit)\n\t\tfor (const [signal, handler] of handlers) {\n\t\t\tsignals.off(signal, handler)\n\t\t}\n\t}\n\treturn {\n\t\tlisten(): void {\n\t\t\tif (listening) {\n\t\t\t\treturn\n\t\t\t}\n\t\t\tlistening = true\n\t\t\tsignals.on('beforeExit', onBeforeExit)\n\t\t\tsignals.on('exit', onExit)\n\t\t\tfor (const [signal, handler] of handlers) {\n\t\t\t\tsignals.on(signal, handler)\n\t\t\t}\n\t\t},\n\t\trelease,\n\t}\n}\n\nconst DEFERRED_FAILED = (count: number): string =>\n\t`analytics: ${count} server events recorded inside a database transaction could not be stored once it ended. Logged at most once a minute.`\n\nconst DEFERRED_DROPPED = (count: number): string =>\n\t`analytics: ${count} server events recorded inside a database transaction were dropped: ${MAX_DEFERRED} were already waiting for theirs to end. Logged at most once a minute.`\n\nconst BUFFERED_DROPPED = (count: number): string =>\n\t`analytics: ${count} buffered hits could not be written and were dropped. Logged at most once a minute.`\n\n/**\n * Writes hits through an optional buffer bounded by size, age and hits held; a batch refused for\n * its rows goes again hit by hit, one refused for the database's state again whole, once.\n */\nexport const createHitWriter = (options: HitWriterOptions): HitWriter => {\n\tconst { store, logger } = options\n\tconst limits = resolveWriteBuffer(options.buffer)\n\tconst now = options.now ?? monotonicMs\n\tconst setTimer = options.setTimer ?? unrefTimer\n\tconst deferredFailed = rateLimitedReport(logger, now, DEFERRED_FAILED)\n\tconst deferredDropped = rateLimitedReport(logger, now, DEFERRED_DROPPED)\n\tconst deferrals = createDeferrals({\n\t\tnow,\n\t\tsetTimer,\n\t\tfailed: (error) => deferredFailed(1, error),\n\t\tdropped: () => deferredDropped(1, new Error('too many server events waiting')),\n\t})\n\tconst direct = (hit: HitRow): Promise<AppendResult> => store.append([hit])\n\tconst signals = options.signals ?? process\n\tif (limits === null) {\n\t\t// Without a buffer only deferred work can be lost, so the process is listened to once some\n\t\t// is waiting.\n\t\tconst shutdown = guardShutdown({\n\t\t\tsignals,\n\t\t\tlogger,\n\t\t\theld: deferrals.held,\n\t\t\tsettle: () => deferrals.settle(true),\n\t\t})\n\t\treturn {\n\t\t\twrite: direct,\n\t\t\tdefer(work, blocked) {\n\t\t\t\tshutdown.listen()\n\t\t\t\tdeferrals.add(work, blocked)\n\t\t\t},\n\t\t\tflush: () => deferrals.settle(false),\n\t\t\tasync close() {\n\t\t\t\tshutdown.release()\n\t\t\t\tawait deferrals.settle(true)\n\t\t\t},\n\t\t\tpending: () => 0,\n\t\t}\n\t}\n\t// biome-ignore lint/plugin/noProcessEnv: the platform's own markers, read once to warn at boot\n\tconst platform = serverlessPlatformOf(options.env ?? process.env)\n\tif (platform !== undefined) {\n\t\tlogger?.warn(\n\t\t\t`analytics: native buffer is on, and ${platform} is set. On a serverless platform a function can be frozen or stopped between requests, and the hits it still holds in memory are lost: turn the buffer off there.`\n\t\t)\n\t}\n\n\tlet waiting: HitRow[] = []\n\tlet writing = 0\n\tlet flushing: Promise<void> = Promise.resolve()\n\t/** A drain is chained behind the current one and has not started yet. */\n\tlet queued = false\n\tlet cancelTimer: (() => void) | null = null\n\tlet closed = false\n\tconst report = rateLimitedReport(logger, now, BUFFERED_DROPPED)\n\n\t/** Resolves with the store's refusal of `hits`, or null once they are written. */\n\tconst attempt = (hits: HitRow[]): Promise<unknown> =>\n\t\tstore.append(hits).then(\n\t\t\t() => null,\n\t\t\t(error: unknown) => error ?? new Error('analytics: the store refused a write')\n\t\t)\n\n\tconst pause = (ms: number): Promise<void> =>\n\t\tnew Promise((resolve) => {\n\t\t\tsetTimer(resolve, ms)\n\t\t})\n\n\tconst writeBatch = async (batch: HitRow[]): Promise<void> => {\n\t\tlet failure = await attempt(batch)\n\t\tif (failure === null) {\n\t\t\treturn\n\t\t}\n\t\tif (!isRowError(failure)) {\n\t\t\tawait pause(BATCH_RETRY_MS)\n\t\t\tfailure = await attempt(batch)\n\t\t\tif (failure === null) {\n\t\t\t\treturn\n\t\t\t}\n\t\t\tif (!isRowError(failure)) {\n\t\t\t\treport(batch.length, failure)\n\t\t\t\treturn\n\t\t\t}\n\t\t}\n\t\tlet lost = 0\n\t\tfor (const [index, hit] of batch.entries()) {\n\t\t\tconst refused = await attempt([hit])\n\t\t\tif (refused === null) {\n\t\t\t\tcontinue\n\t\t\t}\n\t\t\tif (!isRowError(refused)) {\n\t\t\t\treport(lost + batch.length - index, refused)\n\t\t\t\treturn\n\t\t\t}\n\t\t\tlost += 1\n\t\t}\n\t\tif (lost > 0) {\n\t\t\treport(lost, failure)\n\t\t}\n\t}\n\n\tconst drain = async (): Promise<void> => {\n\t\tcancelTimer?.()\n\t\tcancelTimer = null\n\t\twhile (waiting.length > 0) {\n\t\t\tconst batch = waiting.slice(0, limits.maxSize)\n\t\t\twaiting = waiting.slice(batch.length)\n\t\t\twriting = batch.length\n\t\t\ttry {\n\t\t\t\tawait writeBatch(batch)\n\t\t\t} finally {\n\t\t\t\twriting = 0\n\t\t\t}\n\t\t}\n\t}\n\n\tconst drainBuffer = (): Promise<void> => {\n\t\tif (!queued) {\n\t\t\tqueued = true\n\t\t\tflushing = flushing\n\t\t\t\t.then(() => {\n\t\t\t\t\tqueued = false\n\t\t\t\t\treturn drain()\n\t\t\t\t})\n\t\t\t\t.catch(() => undefined)\n\t\t}\n\t\treturn flushing\n\t}\n\n\tconst flush = async (): Promise<void> => {\n\t\tawait deferrals.settle(false)\n\t\tawait drainBuffer()\n\t}\n\n\tconst pending = (): number => waiting.length + writing\n\n\tconst shutdown = guardShutdown({\n\t\tsignals,\n\t\tlogger,\n\t\theld: () => pending() + deferrals.held(),\n\t\tsettle: async (stopping) => {\n\t\t\tclosed ||= stopping\n\t\t\tawait deferrals.settle(true)\n\t\t\tawait drainBuffer()\n\t\t},\n\t})\n\tshutdown.listen()\n\n\treturn {\n\t\tasync write(hit, writeOptions) {\n\t\t\tconst bypass = writeOptions?.flush === true || isOrderHitId(hit.id)\n\t\t\twhile (!bypass && !closed && pending() >= limits.maxPending) {\n\t\t\t\tawait drainBuffer()\n\t\t\t}\n\t\t\tif (bypass || closed) {\n\t\t\t\treturn direct(hit)\n\t\t\t}\n\t\t\twaiting.push(hit)\n\t\t\tif (waiting.length >= limits.maxSize) {\n\t\t\t\tvoid drainBuffer()\n\t\t\t} else if (cancelTimer === null) {\n\t\t\t\tcancelTimer = setTimer(() => {\n\t\t\t\t\tcancelTimer = null\n\t\t\t\t\tvoid drainBuffer()\n\t\t\t\t}, limits.maxAgeMs)\n\t\t\t}\n\t\t\treturn undefined\n\t\t},\n\t\tdefer: deferrals.add,\n\t\tflush,\n\t\tasync close() {\n\t\t\tclosed = true\n\t\t\tshutdown.release()\n\t\t\tawait deferrals.settle(true)\n\t\t\tawait drainBuffer()\n\t\t},\n\t\tpending,\n\t}\n}\n"],"mappings":";;;;;;AAgBA,MAAa,uBAAoD;CAChE,SAAS;CACT,UAAU;CACV,YAAY;AACb;AAKA,MAAM,cAAc,OAAgB,SAA0C;CAC7E,IAAI,OAAO,UAAU,YAAY,CAAC,OAAO,UAAU,KAAK,KAAK,QAAQ,GACpE,MAAM,IAAI,MACT,4BAA4B,KAAK,6CAA6C,OAAO,KAAK,GAC3F;CAED,OAAO;AACR;;AAGA,MAAa,sBACZ,WAC8B;CAC9B,IAAI,WAAW,KAAA,KAAa,WAAW,OACtC,OAAO;CAER,IAAI,WAAW,SAAS,CAAC,SAAS,MAAM,KAAK,MAAM,QAAQ,MAAM,IAChE,MAAM,IAAI,MAAM,qEAAqE;CAEtF,MAAM,QAAQ,WAAW,OAAO,CAAC,IAAI;CACrC,MAAM,SAA4B;EACjC,SAAS,WAAW,MAAM,WAAW,qBAAqB,SAAS,SAAS;EAC5E,UAAU,WAAW,MAAM,YAAY,qBAAqB,UAAU,UAAU;EAChF,YAAY,WAAW,MAAM,cAAc,qBAAqB,YAAY,YAAY;CACzF;CACA,IAAI,OAAO,aAAa,OAAO,SAC9B,MAAM,IAAI,MACT,wCAAwC,OAAO,WAAW,qCAAqC,OAAO,QAAQ,EAC/G;CAED,OAAO;AACR;;AAGA,MAAM,iBAAoC;CAAC;CAAU;CAA4B;AAAS;;AAG1F,MAAa,wBACZ,QACwB,eAAe,MAAM,UAAU,IAAI,SAAS,QAAQ,EAAE;;AAG/E,MAAM,uBAAuB;;AAM7B,MAAM,kBAAkB;;AAGxB,MAAM,gBAAgB;;AAMtB,MAAa,eAAe;AAK5B,MAAM,eAAsC,CAAC,WAAW,QAAQ;AAiDhE,MAAM,cAAc,KAAiB,OAA6B;CAEjE,MAAM,SAASA,WAAW,KAAK,EAAE,EAAE,MAAM;CACzC,aAAaC,aAAU,MAAM;AAC9B;;AAGA,MAAM,gBAAgB,MAAqB,OAC1C,IAAI,SAAS,YAAY;CACxB,MAAM,SAAS,WAAW,SAAS,EAAE;CACrC,KAAU,cAAc;EACvB,OAAO;EACP,QAAQ;CACT,CAAC;AACF,CAAC;;AAGF,MAAM,qBACL,QACA,KACA,YAC+C;CAC/C,IAAI,SAAS;CACb,IAAI,WAA0B;CAC9B,QAAQ,OAAO,UAAU;EACxB,UAAU;EACV,MAAM,KAAK,IAAI;EACf,IAAI,aAAa,QAAQ,KAAK,WAAW,sBACxC;EAED,WAAW;EACX,QAAQ,MAAM;GAAE,KAAK;GAAO,KAAK,QAAQ,MAAM;EAAE,CAAC;EAClD,SAAS;CACV;AACD;;AASA,MAAM,mBAAmB,SAMnB;CACL,IAAI,UAA0B,CAAC;CAC/B,MAAM,0BAAU,IAAI,IAAmB;CACvC,IAAI,SAA8B;CAElC,MAAM,UAAU,OAAqB,UAA4B;EAChE,IAAI,SAAS,KAAK,IAAI,IAAI,MAAM,SAAA,KAC/B,OAAO;EAER,IAAI;GACH,OAAO,CAAC,MAAM,QAAQ;EACvB,QAAQ;GACP,OAAO;EACR;CACD;CAEA,MAAM,SAAS,UAA8B;EAC5C,MAAM,OAAO,MAAM,KAAK,EAAE,MAAM,KAAK,MAAM;EAC3C,QAAQ,IAAI,IAAI;EAChB,KAAU,WAAW,QAAQ,OAAO,IAAI,CAAC;CAC1C;CAEA,MAAM,QAAQ,UAAyB;EACtC,SAAS;EACT,SAAS;EACT,MAAM,QAAwB,CAAC;EAC/B,KAAK,MAAM,SAAS,SACnB,IAAI,OAAO,OAAO,KAAK,GACtB,MAAM,KAAK;OAEX,MAAM,KAAK,KAAK;EAGlB,UAAU;EACV,IAAI,QAAQ,SAAS,GACpB,SAAS,KAAK,eAAe,KAAK,KAAK,GAAG,aAAa;CAEzD;CAEA,OAAO;EACN,IAAI,MAA2B,SAA8B;GAC5D,IAAI,QAAQ,SAAS,QAAQ,QAAA,KAAsB;IAClD,KAAK,QAAQ;IACb;GACD;GACA,QAAQ,KAAK;IAAE;IAAM;IAAS,OAAO,KAAK,IAAI;GAAE,CAAC;GACjD,KAAK,KAAK;EACX;;EAEA,YAAoB,QAAQ,SAAS,QAAQ;;EAE7C,MAAM,OAAO,OAA+B;GAC3C,KAAK,KAAK;GACV,OAAO,QAAQ,OAAO,GACrB,MAAM,QAAQ,WAAW,CAAC,GAAG,OAAO,CAAC;EAEvC;CACD;AACD;;;;;AAMA,MAAM,iBAAiB,SAOjB;CACL,MAAM,EAAE,YAAY;CACpB,IAAI,YAAY;CAChB,IAAI,WAAiC;CACrC,MAAM,cAAc,aAAqC;EACxD,aAAa,KAAK,OAAO,QAAQ,EAAE,cAAc;GAChD,WAAW;EACZ,CAAC;EACD,OAAO;CACR;CACA,MAAM,qBAA2B;EAEhC,IAAI,KAAK,KAAK,IAAI,KAAK,aAAa,MACnC,WAAgB,KAAK;CAEvB;CACA,MAAM,eAAqB;EAC1B,MAAM,OAAO,KAAK,KAAK;EACvB,IAAI,OAAO,GACV,KAAK,QAAQ,KACZ,sCAAsC,KAAK,gIAC5C;CAEF;CAGA,MAAM,YAAY,iBAAmC;EACpD,aAAkB,WAAW,IAAI,GAAG,eAAe,EAAE,WAAW;GAC/D,QAAQ;GACR,IAAI,QAAQ,cAAc,MAAM,MAAM,GACrC,QAAQ,KAAK,QAAQ,KAAK,MAAM;EAElC,CAAC;CACF;CACA,MAAM,WAAW,IAAI,IAAI,aAAa,KAAK,WAAW,CAAC,QAAQ,SAAS,MAAM,CAAC,CAAC,CAAC;CACjF,MAAM,gBAAsB;EAC3B,IAAI,CAAC,WACJ;EAED,YAAY;EACZ,QAAQ,IAAI,cAAc,YAAY;EACtC,QAAQ,IAAI,QAAQ,MAAM;EAC1B,KAAK,MAAM,CAAC,QAAQ,YAAY,UAC/B,QAAQ,IAAI,QAAQ,OAAO;CAE7B;CACA,OAAO;EACN,SAAe;GACd,IAAI,WACH;GAED,YAAY;GACZ,QAAQ,GAAG,cAAc,YAAY;GACrC,QAAQ,GAAG,QAAQ,MAAM;GACzB,KAAK,MAAM,CAAC,QAAQ,YAAY,UAC/B,QAAQ,GAAG,QAAQ,OAAO;EAE5B;EACA;CACD;AACD;AAEA,MAAM,mBAAmB,UACxB,cAAc,MAAM;AAErB,MAAM,oBAAoB,UACzB,cAAc,MAAM,sEAAsE,aAAa;AAExG,MAAM,oBAAoB,UACzB,cAAc,MAAM;;;;;AAMrB,MAAa,mBAAmB,YAAyC;CACxE,MAAM,EAAE,OAAO,WAAW;CAC1B,MAAM,SAAS,mBAAmB,QAAQ,MAAM;CAChD,MAAM,MAAM,QAAQ,OAAO;CAC3B,MAAM,WAAW,QAAQ,YAAY;CACrC,MAAM,iBAAiB,kBAAkB,QAAQ,KAAK,eAAe;CACrE,MAAM,kBAAkB,kBAAkB,QAAQ,KAAK,gBAAgB;CACvE,MAAM,YAAY,gBAAgB;EACjC;EACA;EACA,SAAS,UAAU,eAAe,GAAG,KAAK;EAC1C,eAAe,gBAAgB,mBAAG,IAAI,MAAM,gCAAgC,CAAC;CAC9E,CAAC;CACD,MAAM,UAAU,QAAuC,MAAM,OAAO,CAAC,GAAG,CAAC;CACzE,MAAM,UAAU,QAAQ,WAAW;CACnC,IAAI,WAAW,MAAM;EAGpB,MAAM,WAAW,cAAc;GAC9B;GACA;GACA,MAAM,UAAU;GAChB,cAAc,UAAU,OAAO,IAAI;EACpC,CAAC;EACD,OAAO;GACN,OAAO;GACP,MAAM,MAAM,SAAS;IACpB,SAAS,OAAO;IAChB,UAAU,IAAI,MAAM,OAAO;GAC5B;GACA,aAAa,UAAU,OAAO,KAAK;GACnC,MAAM,QAAQ;IACb,SAAS,QAAQ;IACjB,MAAM,UAAU,OAAO,IAAI;GAC5B;GACA,eAAe;EAChB;CACD;CAEA,MAAM,WAAW,qBAAqB,QAAQ,OAAO,QAAQ,GAAG;CAChE,IAAI,aAAa,KAAA,GAChB,QAAQ,KACP,uCAAuC,SAAS,mKACjD;CAGD,IAAI,UAAoB,CAAC;CACzB,IAAI,UAAU;CACd,IAAI,WAA0B,QAAQ,QAAQ;;CAE9C,IAAI,SAAS;CACb,IAAI,cAAmC;CACvC,IAAI,SAAS;CACb,MAAM,SAAS,kBAAkB,QAAQ,KAAK,gBAAgB;;CAG9D,MAAM,WAAW,SAChB,MAAM,OAAO,IAAI,EAAE,WACZ,OACL,UAAmB,yBAAS,IAAI,MAAM,sCAAsC,CAC9E;CAED,MAAM,SAAS,OACd,IAAI,SAAS,YAAY;EACxB,SAAS,SAAS,EAAE;CACrB,CAAC;CAEF,MAAM,aAAa,OAAO,UAAmC;EAC5D,IAAI,UAAU,MAAM,QAAQ,KAAK;EACjC,IAAI,YAAY,MACf;EAED,IAAI,CAAC,WAAW,OAAO,GAAG;GACzB,MAAM,MAAA,GAAoB;GAC1B,UAAU,MAAM,QAAQ,KAAK;GAC7B,IAAI,YAAY,MACf;GAED,IAAI,CAAC,WAAW,OAAO,GAAG;IACzB,OAAO,MAAM,QAAQ,OAAO;IAC5B;GACD;EACD;EACA,IAAI,OAAO;EACX,KAAK,MAAM,CAAC,OAAO,QAAQ,MAAM,QAAQ,GAAG;GAC3C,MAAM,UAAU,MAAM,QAAQ,CAAC,GAAG,CAAC;GACnC,IAAI,YAAY,MACf;GAED,IAAI,CAAC,WAAW,OAAO,GAAG;IACzB,OAAO,OAAO,MAAM,SAAS,OAAO,OAAO;IAC3C;GACD;GACA,QAAQ;EACT;EACA,IAAI,OAAO,GACV,OAAO,MAAM,OAAO;CAEtB;CAEA,MAAM,QAAQ,YAA2B;EACxC,cAAc;EACd,cAAc;EACd,OAAO,QAAQ,SAAS,GAAG;GAC1B,MAAM,QAAQ,QAAQ,MAAM,GAAG,OAAO,OAAO;GAC7C,UAAU,QAAQ,MAAM,MAAM,MAAM;GACpC,UAAU,MAAM;GAChB,IAAI;IACH,MAAM,WAAW,KAAK;GACvB,UAAU;IACT,UAAU;GACX;EACD;CACD;CAEA,MAAM,oBAAmC;EACxC,IAAI,CAAC,QAAQ;GACZ,SAAS;GACT,WAAW,SACT,WAAW;IACX,SAAS;IACT,OAAO,MAAM;GACd,CAAC,EACA,YAAY,KAAA,CAAS;EACxB;EACA,OAAO;CACR;CAEA,MAAM,QAAQ,YAA2B;EACxC,MAAM,UAAU,OAAO,KAAK;EAC5B,MAAM,YAAY;CACnB;CAEA,MAAM,gBAAwB,QAAQ,SAAS;CAE/C,MAAM,WAAW,cAAc;EAC9B;EACA;EACA,YAAY,QAAQ,IAAI,UAAU,KAAK;EACvC,QAAQ,OAAO,aAAa;GAC3B,WAAW;GACX,MAAM,UAAU,OAAO,IAAI;GAC3B,MAAM,YAAY;EACnB;CACD,CAAC;CACD,SAAS,OAAO;CAEhB,OAAO;EACN,MAAM,MAAM,KAAK,cAAc;GAC9B,MAAM,SAAS,cAAc,UAAU,QAAQ,aAAa,IAAI,EAAE;GAClE,OAAO,CAAC,UAAU,CAAC,UAAU,QAAQ,KAAK,OAAO,YAChD,MAAM,YAAY;GAEnB,IAAI,UAAU,QACb,OAAO,OAAO,GAAG;GAElB,QAAQ,KAAK,GAAG;GAChB,IAAI,QAAQ,UAAU,OAAO,SAC5B,YAAiB;QACX,IAAI,gBAAgB,MAC1B,cAAc,eAAe;IAC5B,cAAc;IACd,YAAiB;GAClB,GAAG,OAAO,QAAQ;EAGpB;EACA,OAAO,UAAU;EACjB;EACA,MAAM,QAAQ;GACb,SAAS;GACT,SAAS,QAAQ;GACjB,MAAM,UAAU,OAAO,IAAI;GAC3B,MAAM,YAAY;EACnB;EACA;CACD;AACD"}
@@ -1,6 +1,7 @@
1
1
  import { GeoResolver } from "./geoResolver.js";
2
2
 
3
3
  //#region src/native/geo/composeGeoResolvers.d.ts
4
+ /** Asks each resolver in turn and answers the first location with a country, else an empty one. */
4
5
  declare function composeGeoResolvers(...resolvers: GeoResolver[]): GeoResolver;
5
6
  //#endregion
6
7
  export { composeGeoResolvers };
@@ -1,12 +1,15 @@
1
+ import { loadsMaxmindAtRuntime, needsMaxmindSdk } from "./geoResolver.js";
1
2
  //#region src/native/geo/composeGeoResolvers.ts
3
+ /** Asks each resolver in turn and answers the first location with a country, else an empty one. */
2
4
  function composeGeoResolvers(...resolvers) {
3
- return async (headers) => {
5
+ const composed = async (headers, opts) => {
4
6
  for (const resolve of resolvers) {
5
- const geo = await resolve(headers);
7
+ const geo = await resolve(headers, opts);
6
8
  if (geo.country) return geo;
7
9
  }
8
10
  return {};
9
11
  };
12
+ return resolvers.some(needsMaxmindSdk) ? loadsMaxmindAtRuntime(composed) : composed;
10
13
  }
11
14
  //#endregion
12
15
  export { composeGeoResolvers };
@@ -1 +1 @@
1
- {"version":3,"file":"composeGeoResolvers.js","names":[],"sources":["../../../src/native/geo/composeGeoResolvers.ts"],"sourcesContent":["import type { Geo, GeoResolver } from './geoResolver'\n\nexport function composeGeoResolvers(...resolvers: GeoResolver[]): GeoResolver {\n\treturn async (headers: Headers): Promise<Geo> => {\n\t\tfor (const resolve of resolvers) {\n\t\t\tconst geo = await resolve(headers)\n\t\t\tif (geo.country) {\n\t\t\t\treturn geo\n\t\t\t}\n\t\t}\n\t\treturn {}\n\t}\n}\n"],"mappings":";AAEA,SAAgB,oBAAoB,GAAG,WAAuC;CAC7E,OAAO,OAAO,YAAmC;EAChD,KAAK,MAAM,WAAW,WAAW;GAChC,MAAM,MAAM,MAAM,QAAQ,OAAO;GACjC,IAAI,IAAI,SACP,OAAO;EAET;EACA,OAAO,CAAC;CACT;AACD"}
1
+ {"version":3,"file":"composeGeoResolvers.js","names":[],"sources":["../../../src/native/geo/composeGeoResolvers.ts"],"sourcesContent":["import {\n\ttype Geo,\n\ttype GeoResolver,\n\ttype GeoResolverOptions,\n\tloadsMaxmindAtRuntime,\n\tneedsMaxmindSdk,\n} from './geoResolver'\n\n/** Asks each resolver in turn and answers the first location with a country, else an empty one. */\nexport function composeGeoResolvers(...resolvers: GeoResolver[]): GeoResolver {\n\tconst composed = async (headers: Headers, opts?: GeoResolverOptions): Promise<Geo> => {\n\t\tfor (const resolve of resolvers) {\n\t\t\tconst geo = await resolve(headers, opts)\n\t\t\tif (geo.country) {\n\t\t\t\treturn geo\n\t\t\t}\n\t\t}\n\t\treturn {}\n\t}\n\treturn resolvers.some(needsMaxmindSdk) ? loadsMaxmindAtRuntime(composed) : composed\n}\n"],"mappings":";;;AASA,SAAgB,oBAAoB,GAAG,WAAuC;CAC7E,MAAM,WAAW,OAAO,SAAkB,SAA4C;EACrF,KAAK,MAAM,WAAW,WAAW;GAChC,MAAM,MAAM,MAAM,QAAQ,SAAS,IAAI;GACvC,IAAI,IAAI,SACP,OAAO;EAET;EACA,OAAO,CAAC;CACT;CACA,OAAO,UAAU,KAAK,eAAe,IAAI,sBAAsB,QAAQ,IAAI;AAC5E"}
@@ -1,12 +1,37 @@
1
+ import { TrustedPlatform } from "../../net/platform.js";
2
+ import { MaxmindSdk } from "../../core/sdks.js";
3
+
1
4
  //#region src/native/geo/geoResolver.d.ts
2
5
  interface Geo {
3
6
  country?: string;
4
7
  region?: string;
5
8
  city?: string;
6
9
  }
7
- type GeoResolver = (headers: Headers) => Geo | Promise<Geo>;
10
+ /** The install's request trust, handed to every resolver in a chain. */
11
+ interface GeoResolverOptions {
12
+ trustedProxyHops?: number;
13
+ /**
14
+ * The platform whose location headers may be read. Unset, no platform header is trusted: a
15
+ * visitor can send `cf-ipcountry` or `x-vercel-ip-country` themselves.
16
+ */
17
+ trustedPlatform?: TrustedPlatform;
18
+ /**
19
+ * The plugin's `sdks.maxmind`, for a resolver that opens a MaxMind database and was handed no
20
+ * reader of its own.
21
+ */
22
+ maxmind?: MaxmindSdk;
23
+ }
24
+ /**
25
+ * `opts` carries the install's request trust. A resolver reading platform headers must read them
26
+ * only for `trustedPlatform`.
27
+ */
28
+ type GeoResolver = (headers: Headers, opts?: GeoResolverOptions) => Geo | Promise<Geo>;
29
+ /**
30
+ * The location the install's `trustedPlatform` wrote into the request, and nothing at all
31
+ * without one, whichever platform headers the request carries.
32
+ */
8
33
  declare const platformHeaderResolver: GeoResolver;
9
34
  declare const noopResolver: GeoResolver;
10
35
  //#endregion
11
- export { Geo, GeoResolver, noopResolver, platformHeaderResolver };
36
+ export { Geo, GeoResolver, GeoResolverOptions, noopResolver, platformHeaderResolver };
12
37
  //# sourceMappingURL=geoResolver.d.ts.map
@@ -1,11 +1,47 @@
1
+ import { PLATFORM_HEADERS } from "../../net/platform.js";
1
2
  //#region src/native/geo/geoResolver.ts
2
- const platformHeaderResolver = (headers) => ({
3
- country: headers.get("x-vercel-ip-country") ?? headers.get("cf-ipcountry") ?? void 0,
4
- region: headers.get("x-vercel-ip-country-region") ?? void 0,
5
- city: headers.get("x-vercel-ip-city") ?? void 0
6
- });
3
+ const GEO_FIELDS = [
4
+ "country",
5
+ "region",
6
+ "city"
7
+ ];
8
+ /** The location fields of `values` that are non-empty text, any other value left out. */
9
+ const geoOf = (values) => {
10
+ const geo = {};
11
+ for (const field of GEO_FIELDS) {
12
+ const value = values[field];
13
+ if (typeof value === "string" && value !== "") geo[field] = value;
14
+ }
15
+ return geo;
16
+ };
17
+ /**
18
+ * The location the install's `trustedPlatform` wrote into the request, and nothing at all
19
+ * without one, whichever platform headers the request carries.
20
+ */
21
+ const platformHeaderResolver = (headers, opts) => {
22
+ const platform = opts?.trustedPlatform;
23
+ if (platform === void 0) return {};
24
+ const names = PLATFORM_HEADERS[platform];
25
+ return {
26
+ country: headers.get(names.country) ?? void 0,
27
+ region: headers.get(names.region) ?? void 0,
28
+ city: headers.get(names.city) ?? void 0
29
+ };
30
+ };
7
31
  const noopResolver = () => ({});
32
+ /** `Symbol.for`, so the `/geo` entry and the native adapter agree on it from separate bundles. */
33
+ const LOADS_MAXMIND = Symbol.for("@10x-media/analytics/geo-loads-maxmind");
34
+ /**
35
+ * Marks a resolver that loads `maxmind` at runtime unless the plugin hands it `sdks.maxmind`, so
36
+ * the native engine can warn at boot rather than at the first lookup.
37
+ */
38
+ const loadsMaxmindAtRuntime = (resolver) => {
39
+ Reflect.set(resolver, LOADS_MAXMIND, true);
40
+ return resolver;
41
+ };
42
+ /** Whether a resolver, or one it composes, loads `maxmind` at runtime without `sdks.maxmind`. */
43
+ const needsMaxmindSdk = (resolver) => Reflect.get(resolver, LOADS_MAXMIND) === true;
8
44
  //#endregion
9
- export { noopResolver, platformHeaderResolver };
45
+ export { geoOf, loadsMaxmindAtRuntime, needsMaxmindSdk, noopResolver, platformHeaderResolver };
10
46
 
11
47
  //# sourceMappingURL=geoResolver.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"geoResolver.js","names":[],"sources":["../../../src/native/geo/geoResolver.ts"],"sourcesContent":["export interface Geo {\n\tcountry?: string\n\tregion?: string\n\tcity?: string\n}\n\nexport type GeoResolver = (headers: Headers) => Geo | Promise<Geo>\n\nexport const platformHeaderResolver: GeoResolver = (headers) => ({\n\tcountry: headers.get('x-vercel-ip-country') ?? headers.get('cf-ipcountry') ?? undefined,\n\tregion: headers.get('x-vercel-ip-country-region') ?? undefined,\n\tcity: headers.get('x-vercel-ip-city') ?? undefined,\n})\n\nexport const noopResolver: GeoResolver = () => ({})\n"],"mappings":";AAQA,MAAa,0BAAuC,aAAa;CAChE,SAAS,QAAQ,IAAI,qBAAqB,KAAK,QAAQ,IAAI,cAAc,KAAK,KAAA;CAC9E,QAAQ,QAAQ,IAAI,4BAA4B,KAAK,KAAA;CACrD,MAAM,QAAQ,IAAI,kBAAkB,KAAK,KAAA;AAC1C;AAEA,MAAa,sBAAmC,CAAC"}
1
+ {"version":3,"file":"geoResolver.js","names":[],"sources":["../../../src/native/geo/geoResolver.ts"],"sourcesContent":["import type { MaxmindSdk } from '../../core/sdks'\nimport { PLATFORM_HEADERS, type TrustedPlatform } from '../../net/platform'\n\nexport interface Geo {\n\tcountry?: string\n\tregion?: string\n\tcity?: string\n}\n\nconst GEO_FIELDS = ['country', 'region', 'city'] as const satisfies ReadonlyArray<keyof Geo>\n\n/** The location fields of `values` that are non-empty text, any other value left out. */\nexport const geoOf = (values: Readonly<Partial<Record<keyof Geo, unknown>>>): Geo => {\n\tconst geo: Geo = {}\n\tfor (const field of GEO_FIELDS) {\n\t\tconst value = values[field]\n\t\tif (typeof value === 'string' && value !== '') {\n\t\t\tgeo[field] = value\n\t\t}\n\t}\n\treturn geo\n}\n\n/** The install's request trust, handed to every resolver in a chain. */\nexport interface GeoResolverOptions {\n\ttrustedProxyHops?: number\n\t/**\n\t * The platform whose location headers may be read. Unset, no platform header is trusted: a\n\t * visitor can send `cf-ipcountry` or `x-vercel-ip-country` themselves.\n\t */\n\ttrustedPlatform?: TrustedPlatform\n\t/**\n\t * The plugin's `sdks.maxmind`, for a resolver that opens a MaxMind database and was handed no\n\t * reader of its own.\n\t */\n\tmaxmind?: MaxmindSdk\n}\n\n/**\n * `opts` carries the install's request trust. A resolver reading platform headers must read them\n * only for `trustedPlatform`.\n */\nexport type GeoResolver = (headers: Headers, opts?: GeoResolverOptions) => Geo | Promise<Geo>\n\n/**\n * The location the install's `trustedPlatform` wrote into the request, and nothing at all\n * without one, whichever platform headers the request carries.\n */\nexport const platformHeaderResolver: GeoResolver = (headers, opts) => {\n\tconst platform = opts?.trustedPlatform\n\tif (platform === undefined) {\n\t\treturn {}\n\t}\n\tconst names = PLATFORM_HEADERS[platform]\n\treturn {\n\t\tcountry: headers.get(names.country) ?? undefined,\n\t\tregion: headers.get(names.region) ?? undefined,\n\t\tcity: headers.get(names.city) ?? undefined,\n\t}\n}\n\nexport const noopResolver: GeoResolver = () => ({})\n\n/** `Symbol.for`, so the `/geo` entry and the native adapter agree on it from separate bundles. */\nconst LOADS_MAXMIND = Symbol.for('@10x-media/analytics/geo-loads-maxmind')\n\n/**\n * Marks a resolver that loads `maxmind` at runtime unless the plugin hands it `sdks.maxmind`, so\n * the native engine can warn at boot rather than at the first lookup.\n */\nexport const loadsMaxmindAtRuntime = (resolver: GeoResolver): GeoResolver => {\n\tReflect.set(resolver, LOADS_MAXMIND, true)\n\treturn resolver\n}\n\n/** Whether a resolver, or one it composes, loads `maxmind` at runtime without `sdks.maxmind`. */\nexport const needsMaxmindSdk = (resolver: GeoResolver): boolean =>\n\tReflect.get(resolver, LOADS_MAXMIND) === true\n"],"mappings":";;AASA,MAAM,aAAa;CAAC;CAAW;CAAU;AAAM;;AAG/C,MAAa,SAAS,WAA+D;CACpF,MAAM,MAAW,CAAC;CAClB,KAAK,MAAM,SAAS,YAAY;EAC/B,MAAM,QAAQ,OAAO;EACrB,IAAI,OAAO,UAAU,YAAY,UAAU,IAC1C,IAAI,SAAS;CAEf;CACA,OAAO;AACR;;;;;AA2BA,MAAa,0BAAuC,SAAS,SAAS;CACrE,MAAM,WAAW,MAAM;CACvB,IAAI,aAAa,KAAA,GAChB,OAAO,CAAC;CAET,MAAM,QAAQ,iBAAiB;CAC/B,OAAO;EACN,SAAS,QAAQ,IAAI,MAAM,OAAO,KAAK,KAAA;EACvC,QAAQ,QAAQ,IAAI,MAAM,MAAM,KAAK,KAAA;EACrC,MAAM,QAAQ,IAAI,MAAM,IAAI,KAAK,KAAA;CAClC;AACD;AAEA,MAAa,sBAAmC,CAAC;;AAGjD,MAAM,gBAAgB,OAAO,IAAI,wCAAwC;;;;;AAMzE,MAAa,yBAAyB,aAAuC;CAC5E,QAAQ,IAAI,UAAU,eAAe,IAAI;CACzC,OAAO;AACR;;AAGA,MAAa,mBAAmB,aAC/B,QAAQ,IAAI,UAAU,aAAa,MAAM"}
@@ -1,14 +1,18 @@
1
+ import { MaxmindSdk } from "../../core/sdks.js";
1
2
  import { GeoResolver } from "./geoResolver.js";
2
3
 
3
4
  //#region src/native/geo/maxmindResolver.d.ts
4
5
  interface MaxmindOptions {
5
6
  dbPath: string;
7
+ /**
8
+ * `{ open }` from `maxmind`. Unset, the plugin's `sdks.maxmind` serves, and without either it is
9
+ * loaded at runtime, which a standalone build does not ship.
10
+ */
11
+ sdk?: MaxmindSdk;
6
12
  }
7
13
  /**
8
- * Optional MaxMind GeoLite2 resolver. The mmdb and the maxmind lib are loaded
9
- * lazily on first use. Any failure (lib not installed, file missing/unreadable,
10
- * lookup error) degrades to empty geo after a single warning, so a missing or
11
- * unconfigured database never breaks ingestion.
14
+ * MaxMind GeoLite2 resolver, opened on first use. Any failure degrades to empty geo after one
15
+ * warning, so a missing or unconfigured database never breaks ingestion.
12
16
  */
13
17
  declare function maxmindResolver(options: MaxmindOptions): GeoResolver;
14
18
  //#endregion
@@ -1,10 +1,11 @@
1
+ import { valueAt } from "../../core/values.js";
1
2
  import { clientIpFromHeaders } from "../ingest/clientIp.js";
3
+ import { loadMaxmind } from "../../plugin/peers.js";
4
+ import { geoOf, loadsMaxmindAtRuntime } from "./geoResolver.js";
2
5
  //#region src/native/geo/maxmindResolver.ts
3
6
  /**
4
- * Optional MaxMind GeoLite2 resolver. The mmdb and the maxmind lib are loaded
5
- * lazily on first use. Any failure (lib not installed, file missing/unreadable,
6
- * lookup error) degrades to empty geo after a single warning, so a missing or
7
- * unconfigured database never breaks ingestion.
7
+ * MaxMind GeoLite2 resolver, opened on first use. Any failure degrades to empty geo after one
8
+ * warning, so a missing or unconfigured database never breaks ingestion.
8
9
  */
9
10
  function maxmindResolver(options) {
10
11
  let readerPromise;
@@ -16,36 +17,39 @@ function maxmindResolver(options) {
16
17
  }
17
18
  return null;
18
19
  };
19
- const getReader = () => {
20
+ const getReader = (pluginSdk) => {
20
21
  if (!readerPromise) readerPromise = (async () => {
21
- const { open } = await import("maxmind");
22
+ const { open } = options.sdk ?? pluginSdk ?? await loadMaxmind();
22
23
  return open(options.dbPath);
23
24
  })();
24
25
  return readerPromise;
25
26
  };
26
- return async (headers) => {
27
- const ip = clientIpFromHeaders(headers);
27
+ const resolve = async (headers, opts) => {
28
+ const ip = clientIpFromHeaders(headers, {
29
+ trustedProxyHops: opts?.trustedProxyHops,
30
+ trustedPlatform: opts?.trustedPlatform
31
+ });
28
32
  if (!ip) return {};
29
33
  let reader;
30
34
  try {
31
- reader = await getReader();
35
+ reader = await getReader(opts?.maxmind);
32
36
  } catch (err) {
33
37
  warn(err);
34
38
  return {};
35
39
  }
36
40
  try {
37
- const r = reader.get(ip);
38
- if (!r) return {};
39
- return {
40
- country: r.country?.iso_code ?? void 0,
41
- region: r.subdivisions?.[0]?.iso_code ?? void 0,
42
- city: r.city?.names.en ?? void 0
43
- };
41
+ const found = reader.get(ip);
42
+ return geoOf({
43
+ country: valueAt(found, "country.iso_code"),
44
+ region: valueAt(found, "subdivisions.0.iso_code"),
45
+ city: valueAt(found, "city.names.en")
46
+ });
44
47
  } catch (err) {
45
48
  warn(err);
46
49
  return {};
47
50
  }
48
51
  };
52
+ return options.sdk ? resolve : loadsMaxmindAtRuntime(resolve);
49
53
  }
50
54
  //#endregion
51
55
  export { maxmindResolver };
@@ -1 +1 @@
1
- {"version":3,"file":"maxmindResolver.js","names":[],"sources":["../../../src/native/geo/maxmindResolver.ts"],"sourcesContent":["import type { CityResponse, Reader } from 'maxmind'\nimport { clientIpFromHeaders } from '../ingest/clientIp'\nimport type { Geo, GeoResolver } from './geoResolver'\n\nexport interface MaxmindOptions {\n\tdbPath: string\n}\n\n/**\n * Optional MaxMind GeoLite2 resolver. The mmdb and the maxmind lib are loaded\n * lazily on first use. Any failure (lib not installed, file missing/unreadable,\n * lookup error) degrades to empty geo after a single warning, so a missing or\n * unconfigured database never breaks ingestion.\n */\nexport function maxmindResolver(options: MaxmindOptions): GeoResolver {\n\tlet readerPromise: Promise<Reader<CityResponse>> | undefined\n\tlet warned = false\n\n\tconst warn = (detail: unknown): null => {\n\t\tif (!warned) {\n\t\t\twarned = true\n\t\t\tconsole.warn(\n\t\t\t\t`[analytics] MaxMind geo unavailable for \"${options.dbPath}\"; geo will be empty.`,\n\t\t\t\tdetail instanceof Error ? detail.message : detail\n\t\t\t)\n\t\t}\n\t\treturn null\n\t}\n\n\tconst getReader = (): Promise<Reader<CityResponse>> => {\n\t\tif (!readerPromise) {\n\t\t\treaderPromise = (async () => {\n\t\t\t\tconst { open } = await import('maxmind')\n\t\t\t\treturn open<CityResponse>(options.dbPath)\n\t\t\t})()\n\t\t}\n\t\treturn readerPromise\n\t}\n\n\treturn async (headers: Headers): Promise<Geo> => {\n\t\tconst ip = clientIpFromHeaders(headers)\n\t\tif (!ip) {\n\t\t\treturn {}\n\t\t}\n\t\tlet reader: Reader<CityResponse> | null\n\t\ttry {\n\t\t\treader = await getReader()\n\t\t} catch (err) {\n\t\t\twarn(err)\n\t\t\treturn {}\n\t\t}\n\t\ttry {\n\t\t\tconst r = reader.get(ip)\n\t\t\tif (!r) {\n\t\t\t\treturn {}\n\t\t\t}\n\t\t\treturn {\n\t\t\t\tcountry: r.country?.iso_code ?? undefined,\n\t\t\t\tregion: r.subdivisions?.[0]?.iso_code ?? undefined,\n\t\t\t\tcity: r.city?.names.en ?? undefined,\n\t\t\t}\n\t\t} catch (err) {\n\t\t\twarn(err)\n\t\t\treturn {}\n\t\t}\n\t}\n}\n"],"mappings":";;;;;;;;AAcA,SAAgB,gBAAgB,SAAsC;CACrE,IAAI;CACJ,IAAI,SAAS;CAEb,MAAM,QAAQ,WAA0B;EACvC,IAAI,CAAC,QAAQ;GACZ,SAAS;GACT,QAAQ,KACP,4CAA4C,QAAQ,OAAO,wBAC3D,kBAAkB,QAAQ,OAAO,UAAU,MAC5C;EACD;EACA,OAAO;CACR;CAEA,MAAM,kBAAiD;EACtD,IAAI,CAAC,eACJ,iBAAiB,YAAY;GAC5B,MAAM,EAAE,SAAS,MAAM,OAAO;GAC9B,OAAO,KAAmB,QAAQ,MAAM;EACzC,GAAG;EAEJ,OAAO;CACR;CAEA,OAAO,OAAO,YAAmC;EAChD,MAAM,KAAK,oBAAoB,OAAO;EACtC,IAAI,CAAC,IACJ,OAAO,CAAC;EAET,IAAI;EACJ,IAAI;GACH,SAAS,MAAM,UAAU;EAC1B,SAAS,KAAK;GACb,KAAK,GAAG;GACR,OAAO,CAAC;EACT;EACA,IAAI;GACH,MAAM,IAAI,OAAO,IAAI,EAAE;GACvB,IAAI,CAAC,GACJ,OAAO,CAAC;GAET,OAAO;IACN,SAAS,EAAE,SAAS,YAAY,KAAA;IAChC,QAAQ,EAAE,eAAe,IAAI,YAAY,KAAA;IACzC,MAAM,EAAE,MAAM,MAAM,MAAM,KAAA;GAC3B;EACD,SAAS,KAAK;GACb,KAAK,GAAG;GACR,OAAO,CAAC;EACT;CACD;AACD"}
1
+ {"version":3,"file":"maxmindResolver.js","names":[],"sources":["../../../src/native/geo/maxmindResolver.ts"],"sourcesContent":["import type { MaxmindReader, MaxmindSdk } from '../../core/sdks'\nimport { valueAt } from '../../core/values'\nimport { loadMaxmind } from '../../plugin/peers'\nimport { clientIpFromHeaders } from '../ingest/clientIp'\nimport {\n\ttype Geo,\n\ttype GeoResolver,\n\ttype GeoResolverOptions,\n\tgeoOf,\n\tloadsMaxmindAtRuntime,\n} from './geoResolver'\n\nexport interface MaxmindOptions {\n\tdbPath: string\n\t/**\n\t * `{ open }` from `maxmind`. Unset, the plugin's `sdks.maxmind` serves, and without either it is\n\t * loaded at runtime, which a standalone build does not ship.\n\t */\n\tsdk?: MaxmindSdk\n}\n\n/**\n * MaxMind GeoLite2 resolver, opened on first use. Any failure degrades to empty geo after one\n * warning, so a missing or unconfigured database never breaks ingestion.\n */\nexport function maxmindResolver(options: MaxmindOptions): GeoResolver {\n\tlet readerPromise: Promise<MaxmindReader> | undefined\n\tlet warned = false\n\n\tconst warn = (detail: unknown): null => {\n\t\tif (!warned) {\n\t\t\twarned = true\n\t\t\tconsole.warn(\n\t\t\t\t`[analytics] MaxMind geo unavailable for \"${options.dbPath}\"; geo will be empty.`,\n\t\t\t\tdetail instanceof Error ? detail.message : detail\n\t\t\t)\n\t\t}\n\t\treturn null\n\t}\n\n\tconst getReader = (pluginSdk: MaxmindSdk | undefined): Promise<MaxmindReader> => {\n\t\tif (!readerPromise) {\n\t\t\treaderPromise = (async () => {\n\t\t\t\tconst { open } = options.sdk ?? pluginSdk ?? (await loadMaxmind())\n\t\t\t\treturn open(options.dbPath)\n\t\t\t})()\n\t\t}\n\t\treturn readerPromise\n\t}\n\n\tconst resolve = async (headers: Headers, opts?: GeoResolverOptions): Promise<Geo> => {\n\t\tconst ip = clientIpFromHeaders(headers, {\n\t\t\ttrustedProxyHops: opts?.trustedProxyHops,\n\t\t\ttrustedPlatform: opts?.trustedPlatform,\n\t\t})\n\t\tif (!ip) {\n\t\t\treturn {}\n\t\t}\n\t\tlet reader: MaxmindReader\n\t\ttry {\n\t\t\treader = await getReader(opts?.maxmind)\n\t\t} catch (err) {\n\t\t\twarn(err)\n\t\t\treturn {}\n\t\t}\n\t\ttry {\n\t\t\tconst found = reader.get(ip)\n\t\t\treturn geoOf({\n\t\t\t\tcountry: valueAt(found, 'country.iso_code'),\n\t\t\t\tregion: valueAt(found, 'subdivisions.0.iso_code'),\n\t\t\t\tcity: valueAt(found, 'city.names.en'),\n\t\t\t})\n\t\t} catch (err) {\n\t\t\twarn(err)\n\t\t\treturn {}\n\t\t}\n\t}\n\treturn options.sdk ? resolve : loadsMaxmindAtRuntime(resolve)\n}\n"],"mappings":";;;;;;;;;AAyBA,SAAgB,gBAAgB,SAAsC;CACrE,IAAI;CACJ,IAAI,SAAS;CAEb,MAAM,QAAQ,WAA0B;EACvC,IAAI,CAAC,QAAQ;GACZ,SAAS;GACT,QAAQ,KACP,4CAA4C,QAAQ,OAAO,wBAC3D,kBAAkB,QAAQ,OAAO,UAAU,MAC5C;EACD;EACA,OAAO;CACR;CAEA,MAAM,aAAa,cAA8D;EAChF,IAAI,CAAC,eACJ,iBAAiB,YAAY;GAC5B,MAAM,EAAE,SAAS,QAAQ,OAAO,aAAc,MAAM,YAAY;GAChE,OAAO,KAAK,QAAQ,MAAM;EAC3B,GAAG;EAEJ,OAAO;CACR;CAEA,MAAM,UAAU,OAAO,SAAkB,SAA4C;EACpF,MAAM,KAAK,oBAAoB,SAAS;GACvC,kBAAkB,MAAM;GACxB,iBAAiB,MAAM;EACxB,CAAC;EACD,IAAI,CAAC,IACJ,OAAO,CAAC;EAET,IAAI;EACJ,IAAI;GACH,SAAS,MAAM,UAAU,MAAM,OAAO;EACvC,SAAS,KAAK;GACb,KAAK,GAAG;GACR,OAAO,CAAC;EACT;EACA,IAAI;GACH,MAAM,QAAQ,OAAO,IAAI,EAAE;GAC3B,OAAO,MAAM;IACZ,SAAS,QAAQ,OAAO,kBAAkB;IAC1C,QAAQ,QAAQ,OAAO,yBAAyB;IAChD,MAAM,QAAQ,OAAO,eAAe;GACrC,CAAC;EACF,SAAS,KAAK;GACb,KAAK,GAAG;GACR,OAAO,CAAC;EACT;CACD;CACA,OAAO,QAAQ,MAAM,UAAU,sBAAsB,OAAO;AAC7D"}
@@ -0,0 +1,31 @@
1
+ import { isRecord } from "../../core/values.js";
2
+ import { monotonicMs } from "../../core/monotonic.js";
3
+ import { geoOf } from "./geoResolver.js";
4
+ //#region src/native/geo/resolveGeo.ts
5
+ /** How often one resolver that keeps failing is reported, at most. */
6
+ const GEO_WARN_EVERY_MS = 60 * 6e4;
7
+ const warnedAt = /* @__PURE__ */ new WeakMap();
8
+ /**
9
+ * A failing or malformed resolver costs the event its location, never the event. Failures are
10
+ * reported at most once an hour per resolver.
11
+ */
12
+ const resolveGeo = async (resolver, headers, options) => {
13
+ const { trust, warn } = options;
14
+ let answer;
15
+ try {
16
+ answer = await resolver(headers, trust);
17
+ } catch (err) {
18
+ const at = monotonicMs();
19
+ const last = warnedAt.get(resolver);
20
+ if (last === void 0 || at - last >= GEO_WARN_EVERY_MS) {
21
+ warnedAt.set(resolver, at);
22
+ warn?.(`analytics: the geo resolver threw, so events are stored without a location while it fails: ${String(err)}`);
23
+ }
24
+ return {};
25
+ }
26
+ return isRecord(answer) ? geoOf(answer) : {};
27
+ };
28
+ //#endregion
29
+ export { resolveGeo };
30
+
31
+ //# sourceMappingURL=resolveGeo.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"resolveGeo.js","names":[],"sources":["../../../src/native/geo/resolveGeo.ts"],"sourcesContent":["import { monotonicMs } from '../../core/monotonic'\nimport { isRecord } from '../../core/values'\nimport { type Geo, type GeoResolver, type GeoResolverOptions, geoOf } from './geoResolver'\n\n/** How often one resolver that keeps failing is reported, at most. */\nconst GEO_WARN_EVERY_MS = 60 * 60_000\n\nconst warnedAt = new WeakMap<GeoResolver, number>()\n\n/**\n * A failing or malformed resolver costs the event its location, never the event. Failures are\n * reported at most once an hour per resolver.\n */\nexport const resolveGeo = async (\n\tresolver: GeoResolver,\n\theaders: Headers,\n\toptions: { trust: GeoResolverOptions; warn?: (message: string) => void }\n): Promise<Geo> => {\n\tconst { trust, warn } = options\n\tlet answer: unknown\n\ttry {\n\t\tanswer = await resolver(headers, trust)\n\t} catch (err) {\n\t\tconst at = monotonicMs()\n\t\tconst last = warnedAt.get(resolver)\n\t\tif (last === undefined || at - last >= GEO_WARN_EVERY_MS) {\n\t\t\twarnedAt.set(resolver, at)\n\t\t\twarn?.(\n\t\t\t\t`analytics: the geo resolver threw, so events are stored without a location while it fails: ${String(err)}`\n\t\t\t)\n\t\t}\n\t\treturn {}\n\t}\n\treturn isRecord(answer) ? geoOf(answer) : {}\n}\n"],"mappings":";;;;;AAKA,MAAM,oBAAoB,KAAK;AAE/B,MAAM,2BAAW,IAAI,QAA6B;;;;;AAMlD,MAAa,aAAa,OACzB,UACA,SACA,YACkB;CAClB,MAAM,EAAE,OAAO,SAAS;CACxB,IAAI;CACJ,IAAI;EACH,SAAS,MAAM,SAAS,SAAS,KAAK;CACvC,SAAS,KAAK;EACb,MAAM,KAAK,YAAY;EACvB,MAAM,OAAO,SAAS,IAAI,QAAQ;EAClC,IAAI,SAAS,KAAA,KAAa,KAAK,QAAQ,mBAAmB;GACzD,SAAS,IAAI,UAAU,EAAE;GACzB,OACC,8FAA8F,OAAO,GAAG,GACzG;EACD;EACA,OAAO,CAAC;CACT;CACA,OAAO,SAAS,MAAM,IAAI,MAAM,MAAM,IAAI,CAAC;AAC5C"}
@@ -0,0 +1,10 @@
1
+ //#region src/native/ingest/bots.d.ts
2
+ /**
3
+ * An empty agent counts as automated (every real browser sends one); the synthetic server agent
4
+ * never does, since that call is trusted host code.
5
+ */
6
+ declare const isBot: (ua: string) => boolean;
7
+ type BotFilter = (ua: string) => boolean;
8
+ //#endregion
9
+ export { BotFilter, isBot };
10
+ //# sourceMappingURL=bots.d.ts.map
@@ -0,0 +1,66 @@
1
+ import "./device.js";
2
+ //#region src/native/ingest/bots.ts
3
+ /**
4
+ * Lowercase user-agent substrings of automated traffic. Hand-picked rather than a vendor list, so
5
+ * every entry is justified against real agents and none can match a browser.
6
+ */
7
+ const BOT_MARKERS = new Set([
8
+ "bot",
9
+ "crawl",
10
+ "spider",
11
+ "slurp",
12
+ "headless",
13
+ "lighthouse",
14
+ "pagespeed",
15
+ "gtmetrix",
16
+ "pingdom",
17
+ "statuscake",
18
+ "datadog",
19
+ "newrelic",
20
+ "facebookexternalhit",
21
+ "whatsapp",
22
+ "embedly",
23
+ "phantomjs",
24
+ "puppeteer",
25
+ "playwright",
26
+ "selenium",
27
+ "python-requests",
28
+ "curl/",
29
+ "wget/",
30
+ "go-http-client",
31
+ "okhttp",
32
+ "axios/",
33
+ "node-fetch",
34
+ "java/",
35
+ "libwww",
36
+ "httpclient"
37
+ ]);
38
+ /**
39
+ * Phone tokens stripped before scanning: `bot` must match mid-word (Googlebot) without counting
40
+ * every Cubot handset as a crawler.
41
+ */
42
+ const NOT_BOT_TOKENS = ["cubot"];
43
+ /**
44
+ * An empty agent counts as automated (every real browser sends one); the synthetic server agent
45
+ * never does, since that call is trusted host code.
46
+ */
47
+ const isBot = (ua) => {
48
+ if (ua === "analytics-server") return false;
49
+ let agent = ua.trim().toLowerCase();
50
+ if (agent === "") return true;
51
+ for (const token of NOT_BOT_TOKENS) agent = agent.replaceAll(token, "");
52
+ for (const marker of BOT_MARKERS) if (agent.includes(marker)) return true;
53
+ return false;
54
+ };
55
+ /**
56
+ * `filterBots` option as one predicate. A throwing host filter propagates to the handler, which
57
+ * keeps the event and logs once; swallowing it here would hide a broken predicate.
58
+ */
59
+ const resolveBotFilter = (option) => {
60
+ if (option === false) return () => false;
61
+ return typeof option === "function" ? option : isBot;
62
+ };
63
+ //#endregion
64
+ export { isBot, resolveBotFilter };
65
+
66
+ //# sourceMappingURL=bots.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"bots.js","names":[],"sources":["../../../src/native/ingest/bots.ts"],"sourcesContent":["import { SERVER_USER_AGENT } from './device'\n\n/**\n * Lowercase user-agent substrings of automated traffic. Hand-picked rather than a vendor list, so\n * every entry is justified against real agents and none can match a browser.\n */\nexport const BOT_MARKERS: ReadonlySet<string> = new Set([\n\t'bot',\n\t'crawl',\n\t'spider',\n\t'slurp',\n\t'headless',\n\t'lighthouse',\n\t'pagespeed',\n\t'gtmetrix',\n\t'pingdom',\n\t'statuscake',\n\t'datadog',\n\t'newrelic',\n\t'facebookexternalhit',\n\t'whatsapp',\n\t'embedly',\n\t'phantomjs',\n\t'puppeteer',\n\t'playwright',\n\t'selenium',\n\t'python-requests',\n\t'curl/',\n\t'wget/',\n\t'go-http-client',\n\t'okhttp',\n\t'axios/',\n\t'node-fetch',\n\t'java/',\n\t'libwww',\n\t'httpclient',\n])\n\n/**\n * Phone tokens stripped before scanning: `bot` must match mid-word (Googlebot) without counting\n * every Cubot handset as a crawler.\n */\nconst NOT_BOT_TOKENS: readonly string[] = ['cubot']\n\n/**\n * An empty agent counts as automated (every real browser sends one); the synthetic server agent\n * never does, since that call is trusted host code.\n */\nexport const isBot = (ua: string): boolean => {\n\tif (ua === SERVER_USER_AGENT) {\n\t\treturn false\n\t}\n\tlet agent = ua.trim().toLowerCase()\n\tif (agent === '') {\n\t\treturn true\n\t}\n\tfor (const token of NOT_BOT_TOKENS) {\n\t\tagent = agent.replaceAll(token, '')\n\t}\n\tfor (const marker of BOT_MARKERS) {\n\t\tif (agent.includes(marker)) {\n\t\t\treturn true\n\t\t}\n\t}\n\treturn false\n}\n\nexport type BotFilter = (ua: string) => boolean\n\n/**\n * `filterBots` option as one predicate. A throwing host filter propagates to the handler, which\n * keeps the event and logs once; swallowing it here would hide a broken predicate.\n */\nexport const resolveBotFilter = (option: boolean | BotFilter | undefined): BotFilter => {\n\tif (option === false) {\n\t\treturn () => false\n\t}\n\treturn typeof option === 'function' ? option : isBot\n}\n"],"mappings":";;;;;;AAMA,MAAa,cAAmC,IAAI,IAAI;CACvD;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AACD,CAAC;;;;;AAMD,MAAM,iBAAoC,CAAC,OAAO;;;;;AAMlD,MAAa,SAAS,OAAwB;CAC7C,IAAI,OAAA,oBACH,OAAO;CAER,IAAI,QAAQ,GAAG,KAAK,EAAE,YAAY;CAClC,IAAI,UAAU,IACb,OAAO;CAER,KAAK,MAAM,SAAS,gBACnB,QAAQ,MAAM,WAAW,OAAO,EAAE;CAEnC,KAAK,MAAM,UAAU,aACpB,IAAI,MAAM,SAAS,MAAM,GACxB,OAAO;CAGT,OAAO;AACR;;;;;AAQA,MAAa,oBAAoB,WAAuD;CACvF,IAAI,WAAW,OACd,aAAa;CAEd,OAAO,OAAO,WAAW,aAAa,SAAS;AAChD"}
@@ -0,0 +1,45 @@
1
+ import "./device.js";
2
+ //#region src/native/ingest/browser.ts
3
+ /**
4
+ * Order matters: Chromium forks still claim Chrome and iOS browsers still claim Safari, so a fork
5
+ * must match before the engine it borrowed the token from.
6
+ */
7
+ const BROWSERS = [
8
+ [/edg(?:a|ios|e)?\//, "edge"],
9
+ [/\bopr\/|\bopt\/|\bopera\b/, "opera"],
10
+ [/samsungbrowser/, "samsung"],
11
+ [/firefox\/|fxios\//, "firefox"],
12
+ [/chrome\/|crios\/|chromium\//, "chrome"],
13
+ [/safari\//, "safari"]
14
+ ];
15
+ /**
16
+ * `CrOS` and `Android` both sit inside an `X11`/`Linux` UA, so they are matched ahead of it.
17
+ * `cros` needs its word boundaries: it is also a substring of `Microsoft`.
18
+ */
19
+ const PLATFORMS = [
20
+ [/iphone|ipad|ipod/, "ios"],
21
+ [/android/, "android"],
22
+ [/\bcros\b/, "chromeos"],
23
+ [/windows|win64|win32/, "windows"],
24
+ [/macintosh|mac os x/, "macos"],
25
+ [/linux|x11/, "linux"]
26
+ ];
27
+ const lookup = (table, ua, fallback) => {
28
+ if (ua === "analytics-server") return;
29
+ const s = ua.toLowerCase();
30
+ return table.find(([pattern]) => pattern.test(s))?.[1] ?? fallback;
31
+ };
32
+ /**
33
+ * Coarse browser family, `other` when unrecognized, undefined for the synthetic server agent so
34
+ * server events abstain from the breakdown rather than skewing it.
35
+ */
36
+ const classifyBrowser = (ua) => lookup(BROWSERS, ua, "other");
37
+ /**
38
+ * Operating system from a user-agent's platform tokens, on the same terms as
39
+ * `classifyBrowser`: `other` when nothing matches, undefined for the server agent.
40
+ */
41
+ const classifyOs = (ua) => lookup(PLATFORMS, ua, "other");
42
+ //#endregion
43
+ export { classifyBrowser, classifyOs };
44
+
45
+ //# sourceMappingURL=browser.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"browser.js","names":[],"sources":["../../../src/native/ingest/browser.ts"],"sourcesContent":["import { SERVER_USER_AGENT } from './device'\n\nexport type BrowserName = 'chrome' | 'safari' | 'firefox' | 'edge' | 'opera' | 'samsung' | 'other'\n\nexport type OsName = 'ios' | 'android' | 'windows' | 'macos' | 'linux' | 'chromeos' | 'other'\n\n/**\n * Order matters: Chromium forks still claim Chrome and iOS browsers still claim Safari, so a fork\n * must match before the engine it borrowed the token from.\n */\nconst BROWSERS: ReadonlyArray<[RegExp, BrowserName]> = [\n\t[/edg(?:a|ios|e)?\\//, 'edge'],\n\t[/\\bopr\\/|\\bopt\\/|\\bopera\\b/, 'opera'],\n\t[/samsungbrowser/, 'samsung'],\n\t[/firefox\\/|fxios\\//, 'firefox'],\n\t[/chrome\\/|crios\\/|chromium\\//, 'chrome'],\n\t[/safari\\//, 'safari'],\n]\n\n/**\n * `CrOS` and `Android` both sit inside an `X11`/`Linux` UA, so they are matched ahead of it.\n * `cros` needs its word boundaries: it is also a substring of `Microsoft`.\n */\nconst PLATFORMS: ReadonlyArray<[RegExp, OsName]> = [\n\t[/iphone|ipad|ipod/, 'ios'],\n\t[/android/, 'android'],\n\t[/\\bcros\\b/, 'chromeos'],\n\t[/windows|win64|win32/, 'windows'],\n\t[/macintosh|mac os x/, 'macos'],\n\t[/linux|x11/, 'linux'],\n]\n\nconst lookup = <T>(table: ReadonlyArray<[RegExp, T]>, ua: string, fallback: T): T | undefined => {\n\tif (ua === SERVER_USER_AGENT) {\n\t\treturn undefined\n\t}\n\tconst s = ua.toLowerCase()\n\treturn table.find(([pattern]) => pattern.test(s))?.[1] ?? fallback\n}\n\n/**\n * Coarse browser family, `other` when unrecognized, undefined for the synthetic server agent so\n * server events abstain from the breakdown rather than skewing it.\n */\nexport const classifyBrowser = (ua: string): BrowserName | undefined =>\n\tlookup(BROWSERS, ua, 'other')\n\n/**\n * Operating system from a user-agent's platform tokens, on the same terms as\n * `classifyBrowser`: `other` when nothing matches, undefined for the server agent.\n */\nexport const classifyOs = (ua: string): OsName | undefined => lookup(PLATFORMS, ua, 'other')\n"],"mappings":";;;;;;AAUA,MAAM,WAAiD;CACtD,CAAC,qBAAqB,MAAM;CAC5B,CAAC,6BAA6B,OAAO;CACrC,CAAC,kBAAkB,SAAS;CAC5B,CAAC,qBAAqB,SAAS;CAC/B,CAAC,+BAA+B,QAAQ;CACxC,CAAC,YAAY,QAAQ;AACtB;;;;;AAMA,MAAM,YAA6C;CAClD,CAAC,oBAAoB,KAAK;CAC1B,CAAC,WAAW,SAAS;CACrB,CAAC,YAAY,UAAU;CACvB,CAAC,uBAAuB,SAAS;CACjC,CAAC,sBAAsB,OAAO;CAC9B,CAAC,aAAa,OAAO;AACtB;AAEA,MAAM,UAAa,OAAmC,IAAY,aAA+B;CAChG,IAAI,OAAA,oBACH;CAED,MAAM,IAAI,GAAG,YAAY;CACzB,OAAO,MAAM,MAAM,CAAC,aAAa,QAAQ,KAAK,CAAC,CAAC,IAAI,MAAM;AAC3D;;;;;AAMA,MAAa,mBAAmB,OAC/B,OAAO,UAAU,IAAI,OAAO;;;;;AAM7B,MAAa,cAAc,OAAmC,OAAO,WAAW,IAAI,OAAO"}
@@ -1,15 +1,41 @@
1
+ import { PLATFORM_HEADERS } from "../../net/platform.js";
2
+ import { headerEntries } from "./requestHost.js";
1
3
  //#region src/native/ingest/clientIp.ts
4
+ const forwardedChain = (headers) => headerEntries(headers, "x-forwarded-for");
2
5
  /**
3
- * The originating client IP a proxy chain reported: the first hop of
4
- * `x-forwarded-for`, else `x-real-ip`. Null when the request carries neither, so
5
- * callers can omit the value instead of forwarding a fabricated one.
6
+ * First hop of `x-forwarded-for`, else `x-real-ip`, else null. With trusted hops or a platform set,
7
+ * only that source counts: a short chain or missing header answers null, never a fallback.
6
8
  */
7
- const clientIpFromHeaders = (headers) => {
8
- const forwarded = headers.get("x-forwarded-for")?.split(",")[0]?.trim();
9
- if (forwarded) return forwarded;
10
- return headers.get("x-real-ip")?.trim() || null;
9
+ const clientIpFromHeaders = (headers, opts = {}) => {
10
+ if (opts.trustedPlatform !== void 0) return headers.get(PLATFORM_HEADERS[opts.trustedPlatform].ip)?.trim() || null;
11
+ const chain = forwardedChain(headers);
12
+ const hops = opts.trustedProxyHops ?? 0;
13
+ if (hops >= 1) return chain[chain.length - hops] ?? null;
14
+ return chain[0] ?? (headers.get("x-real-ip")?.trim() || null);
15
+ };
16
+ /**
17
+ * Whether `headers` came through two or more proxies while the install trusts none of them, so
18
+ * the address read from them is the one the visitor wrote.
19
+ */
20
+ const forwardedUntrusted = (headers, opts) => opts.trustedPlatform === void 0 && (opts.trustedProxyHops ?? 0) === 0 && forwardedChain(headers).length >= 2;
21
+ /**
22
+ * `headers` as if the request came from `ip`, written where {@link clientIpFromHeaders} reads it.
23
+ * Platform location headers are dropped: they describe the request's own address.
24
+ */
25
+ const overlayClientIp = (headers, ip, opts) => {
26
+ const out = new Headers(headers);
27
+ for (const platform of Object.values(PLATFORM_HEADERS)) {
28
+ out.delete(platform.ip);
29
+ out.delete(platform.country);
30
+ out.delete(platform.region);
31
+ out.delete(platform.city);
32
+ }
33
+ if (opts.trustedPlatform !== void 0) out.set(PLATFORM_HEADERS[opts.trustedPlatform].ip, ip);
34
+ const hops = Math.max(1, opts.trustedProxyHops ?? 0);
35
+ out.set("x-forwarded-for", Array.from({ length: hops }, () => ip).join(", "));
36
+ return out;
11
37
  };
12
38
  //#endregion
13
- export { clientIpFromHeaders };
39
+ export { clientIpFromHeaders, forwardedUntrusted, overlayClientIp };
14
40
 
15
41
  //# sourceMappingURL=clientIp.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"clientIp.js","names":[],"sources":["../../../src/native/ingest/clientIp.ts"],"sourcesContent":["/**\n * The originating client IP a proxy chain reported: the first hop of\n * `x-forwarded-for`, else `x-real-ip`. Null when the request carries neither, so\n * callers can omit the value instead of forwarding a fabricated one.\n */\nexport const clientIpFromHeaders = (headers: Headers): string | null => {\n\tconst forwarded = headers.get('x-forwarded-for')?.split(',')[0]?.trim()\n\tif (forwarded) {\n\t\treturn forwarded\n\t}\n\treturn headers.get('x-real-ip')?.trim() || null\n}\n"],"mappings":";;;;;;AAKA,MAAa,uBAAuB,YAAoC;CACvE,MAAM,YAAY,QAAQ,IAAI,iBAAiB,GAAG,MAAM,GAAG,EAAE,IAAI,KAAK;CACtE,IAAI,WACH,OAAO;CAER,OAAO,QAAQ,IAAI,WAAW,GAAG,KAAK,KAAK;AAC5C"}
1
+ {"version":3,"file":"clientIp.js","names":[],"sources":["../../../src/native/ingest/clientIp.ts"],"sourcesContent":["import { PLATFORM_HEADERS, type TrustedPlatform } from '../../net/platform'\nimport { headerEntries } from './requestHost'\n\nexport interface ClientIpOptions {\n\t/**\n\t * Trusted proxies counted from the right of `x-forwarded-for`; unset reads the leftmost entry.\n\t * No default of 1: behind a CDN plus a proxy it would collapse every visitor onto the CDN.\n\t */\n\ttrustedProxyHops?: number\n\t/**\n\t * The platform whose edge header carries the address instead: `x-real-ip` on Vercel,\n\t * `cf-connecting-ip` on Cloudflare. Never set together with `trustedProxyHops`.\n\t */\n\ttrustedPlatform?: TrustedPlatform\n}\n\nconst forwardedChain = (headers: Headers): string[] => headerEntries(headers, 'x-forwarded-for')\n\n/**\n * First hop of `x-forwarded-for`, else `x-real-ip`, else null. With trusted hops or a platform set,\n * only that source counts: a short chain or missing header answers null, never a fallback.\n */\nexport const clientIpFromHeaders = (\n\theaders: Headers,\n\topts: ClientIpOptions = {}\n): string | null => {\n\tif (opts.trustedPlatform !== undefined) {\n\t\treturn headers.get(PLATFORM_HEADERS[opts.trustedPlatform].ip)?.trim() || null\n\t}\n\tconst chain = forwardedChain(headers)\n\tconst hops = opts.trustedProxyHops ?? 0\n\tif (hops >= 1) {\n\t\treturn chain[chain.length - hops] ?? null\n\t}\n\treturn chain[0] ?? (headers.get('x-real-ip')?.trim() || null)\n}\n\n/**\n * Whether `headers` came through two or more proxies while the install trusts none of them, so\n * the address read from them is the one the visitor wrote.\n */\nexport const forwardedUntrusted = (headers: Headers, opts: ClientIpOptions): boolean =>\n\topts.trustedPlatform === undefined &&\n\t(opts.trustedProxyHops ?? 0) === 0 &&\n\tforwardedChain(headers).length >= 2\n\n/**\n * `headers` as if the request came from `ip`, written where {@link clientIpFromHeaders} reads it.\n * Platform location headers are dropped: they describe the request's own address.\n */\nexport const overlayClientIp = (headers: Headers, ip: string, opts: ClientIpOptions): Headers => {\n\tconst out = new Headers(headers)\n\tfor (const platform of Object.values(PLATFORM_HEADERS)) {\n\t\tout.delete(platform.ip)\n\t\tout.delete(platform.country)\n\t\tout.delete(platform.region)\n\t\tout.delete(platform.city)\n\t}\n\tif (opts.trustedPlatform !== undefined) {\n\t\tout.set(PLATFORM_HEADERS[opts.trustedPlatform].ip, ip)\n\t}\n\tconst hops = Math.max(1, opts.trustedProxyHops ?? 0)\n\tout.set('x-forwarded-for', Array.from({ length: hops }, () => ip).join(', '))\n\treturn out\n}\n"],"mappings":";;;AAgBA,MAAM,kBAAkB,YAA+B,cAAc,SAAS,iBAAiB;;;;;AAM/F,MAAa,uBACZ,SACA,OAAwB,CAAC,MACN;CACnB,IAAI,KAAK,oBAAoB,KAAA,GAC5B,OAAO,QAAQ,IAAI,iBAAiB,KAAK,iBAAiB,EAAE,GAAG,KAAK,KAAK;CAE1E,MAAM,QAAQ,eAAe,OAAO;CACpC,MAAM,OAAO,KAAK,oBAAoB;CACtC,IAAI,QAAQ,GACX,OAAO,MAAM,MAAM,SAAS,SAAS;CAEtC,OAAO,MAAM,OAAO,QAAQ,IAAI,WAAW,GAAG,KAAK,KAAK;AACzD;;;;;AAMA,MAAa,sBAAsB,SAAkB,SACpD,KAAK,oBAAoB,KAAA,MACxB,KAAK,oBAAoB,OAAO,KACjC,eAAe,OAAO,EAAE,UAAU;;;;;AAMnC,MAAa,mBAAmB,SAAkB,IAAY,SAAmC;CAChG,MAAM,MAAM,IAAI,QAAQ,OAAO;CAC/B,KAAK,MAAM,YAAY,OAAO,OAAO,gBAAgB,GAAG;EACvD,IAAI,OAAO,SAAS,EAAE;EACtB,IAAI,OAAO,SAAS,OAAO;EAC3B,IAAI,OAAO,SAAS,MAAM;EAC1B,IAAI,OAAO,SAAS,IAAI;CACzB;CACA,IAAI,KAAK,oBAAoB,KAAA,GAC5B,IAAI,IAAI,iBAAiB,KAAK,iBAAiB,IAAI,EAAE;CAEtD,MAAM,OAAO,KAAK,IAAI,GAAG,KAAK,oBAAoB,CAAC;CACnD,IAAI,IAAI,mBAAmB,MAAM,KAAK,EAAE,QAAQ,KAAK,SAAS,EAAE,EAAE,KAAK,IAAI,CAAC;CAC5E,OAAO;AACR"}
@@ -1,14 +1,12 @@
1
1
  //#region src/native/ingest/device.ts
2
2
  /**
3
- * The user agent server-side tracking stamps when the event has no browser request behind
4
- * it. There is no device to report, so events carrying it abstain from the device breakdown
5
- * rather than piling into `desktop` and skewing it.
3
+ * User agent stamped on server events with no browser request behind them; they abstain from the
4
+ * device breakdown rather than piling into `desktop`.
6
5
  */
7
6
  const SERVER_USER_AGENT = "analytics-server";
8
7
  /**
9
- * Coarse device class from a user-agent string, or undefined when the agent is not a device
10
- * at all. Tablets are checked before phones because an Android tablet UA lacks the `Mobile`
11
- * token an Android phone carries.
8
+ * Coarse device class, undefined for the server agent. Tablets are checked first because an
9
+ * Android tablet UA lacks the `Mobile` token an Android phone carries.
12
10
  */
13
11
  const classifyDevice = (ua) => {
14
12
  if (ua === "analytics-server") return;
@@ -1 +1 @@
1
- {"version":3,"file":"device.js","names":[],"sources":["../../../src/native/ingest/device.ts"],"sourcesContent":["export type DeviceType = 'desktop' | 'mobile' | 'tablet'\n\n/**\n * The user agent server-side tracking stamps when the event has no browser request behind\n * it. There is no device to report, so events carrying it abstain from the device breakdown\n * rather than piling into `desktop` and skewing it.\n */\nexport const SERVER_USER_AGENT = 'analytics-server'\n\n/**\n * Coarse device class from a user-agent string, or undefined when the agent is not a device\n * at all. Tablets are checked before phones because an Android tablet UA lacks the `Mobile`\n * token an Android phone carries.\n */\nexport const classifyDevice = (ua: string): DeviceType | undefined => {\n\tif (ua === SERVER_USER_AGENT) {\n\t\treturn undefined\n\t}\n\tconst s = ua.toLowerCase()\n\tif (/ipad|tablet|playbook|silk|kindle/.test(s) || (/android/.test(s) && !/mobi/.test(s))) {\n\t\treturn 'tablet'\n\t}\n\tif (/mobi|iphone|ipod|android|blackberry|iemobile|opera mini|windows phone/.test(s)) {\n\t\treturn 'mobile'\n\t}\n\treturn 'desktop'\n}\n"],"mappings":";;;;;;AAOA,MAAa,oBAAoB;;;;;;AAOjC,MAAa,kBAAkB,OAAuC;CACrE,IAAI,OAAA,oBACH;CAED,MAAM,IAAI,GAAG,YAAY;CACzB,IAAI,mCAAmC,KAAK,CAAC,KAAM,UAAU,KAAK,CAAC,KAAK,CAAC,OAAO,KAAK,CAAC,GACrF,OAAO;CAER,IAAI,wEAAwE,KAAK,CAAC,GACjF,OAAO;CAER,OAAO;AACR"}
1
+ {"version":3,"file":"device.js","names":[],"sources":["../../../src/native/ingest/device.ts"],"sourcesContent":["export type DeviceType = 'desktop' | 'mobile' | 'tablet'\n\n/**\n * User agent stamped on server events with no browser request behind them; they abstain from the\n * device breakdown rather than piling into `desktop`.\n */\nexport const SERVER_USER_AGENT = 'analytics-server'\n\n/**\n * Coarse device class, undefined for the server agent. Tablets are checked first because an\n * Android tablet UA lacks the `Mobile` token an Android phone carries.\n */\nexport const classifyDevice = (ua: string): DeviceType | undefined => {\n\tif (ua === SERVER_USER_AGENT) {\n\t\treturn undefined\n\t}\n\tconst s = ua.toLowerCase()\n\tif (/ipad|tablet|playbook|silk|kindle/.test(s) || (/android/.test(s) && !/mobi/.test(s))) {\n\t\treturn 'tablet'\n\t}\n\tif (/mobi|iphone|ipod|android|blackberry|iemobile|opera mini|windows phone/.test(s)) {\n\t\treturn 'mobile'\n\t}\n\treturn 'desktop'\n}\n"],"mappings":";;;;;AAMA,MAAa,oBAAoB;;;;;AAMjC,MAAa,kBAAkB,OAAuC;CACrE,IAAI,OAAA,oBACH;CAED,MAAM,IAAI,GAAG,YAAY;CACzB,IAAI,mCAAmC,KAAK,CAAC,KAAM,UAAU,KAAK,CAAC,KAAK,CAAC,OAAO,KAAK,CAAC,GACrF,OAAO;CAER,IAAI,wEAAwE,KAAK,CAAC,GACjF,OAAO;CAER,OAAO;AACR"}
@@ -1 +1 @@
1
- import { PayloadRequest } from "payload";
1
+ import { Payload, PayloadRequest } from "payload";