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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (1242) hide show
  1. package/CHANGELOG.md +470 -0
  2. package/LICENSE +21 -21
  3. package/README.md +30 -37
  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 +7 -9
  18. package/dist/adapters/ga4/disableKey.js.map +1 -1
  19. package/dist/adapters/ga4/eventName.d.ts +2 -8
  20. package/dist/adapters/ga4/eventName.js +2 -8
  21. package/dist/adapters/ga4/eventName.js.map +1 -1
  22. package/dist/adapters/ga4/ga4.d.ts +11 -0
  23. package/dist/adapters/ga4/ga4.js +206 -123
  24. package/dist/adapters/ga4/ga4.js.map +1 -1
  25. package/dist/adapters/ga4/measurementId.js +2 -3
  26. package/dist/adapters/ga4/measurementId.js.map +1 -1
  27. package/dist/adapters/goalRead.js +15 -29
  28. package/dist/adapters/goalRead.js.map +1 -1
  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 +13 -13
  37. package/dist/adapters/plausible/plausible.js +137 -122
  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 +20 -9
  42. package/dist/adapters/posthog/posthog.js +179 -113
  43. package/dist/adapters/posthog/posthog.js.map +1 -1
  44. package/dist/adapters/readTime.js +7 -0
  45. package/dist/adapters/readTime.js.map +1 -0
  46. package/dist/adapters/series.js +14 -8
  47. package/dist/adapters/series.js.map +1 -1
  48. package/dist/adapters/umami/umami.d.ts +7 -9
  49. package/dist/adapters/umami/umami.js +184 -172
  50. package/dist/adapters/umami/umami.js.map +1 -1
  51. package/dist/adapters/upstream.js +16 -0
  52. package/dist/adapters/upstream.js.map +1 -0
  53. package/dist/binding/report.d.ts +8 -0
  54. package/dist/binding/report.js +24 -0
  55. package/dist/binding/report.js.map +1 -0
  56. package/dist/binding/resolvePath.js +16 -29
  57. package/dist/binding/resolvePath.js.map +1 -1
  58. package/dist/binding/types.d.ts +14 -29
  59. package/dist/capture/captureRequest.js +28 -0
  60. package/dist/capture/captureRequest.js.map +1 -0
  61. package/dist/capture/exclusionEndpoint.js +98 -0
  62. package/dist/capture/exclusionEndpoint.js.map +1 -0
  63. package/dist/capture/exclusionPrelude.js +14 -0
  64. package/dist/capture/exclusionPrelude.js.map +1 -0
  65. package/dist/capture/exclusionToken.js +23 -0
  66. package/dist/capture/exclusionToken.js.map +1 -0
  67. package/dist/capture/jsLiteral.js +19 -0
  68. package/dist/capture/jsLiteral.js.map +1 -0
  69. package/dist/capture/mountPath.js +2 -3
  70. package/dist/capture/mountPath.js.map +1 -1
  71. package/dist/capture/proxyEndpoint.js +48 -95
  72. package/dist/capture/proxyEndpoint.js.map +1 -1
  73. package/dist/capture/proxyRoutes.js +58 -21
  74. package/dist/capture/proxyRoutes.js.map +1 -1
  75. package/dist/capture/relay.js +91 -0
  76. package/dist/capture/relay.js.map +1 -0
  77. package/dist/capture/requestBody.js +2 -6
  78. package/dist/capture/requestBody.js.map +1 -1
  79. package/dist/capture/requestTrust.js +45 -0
  80. package/dist/capture/requestTrust.js.map +1 -0
  81. package/dist/capture/sameSite.js +40 -0
  82. package/dist/capture/sameSite.js.map +1 -0
  83. package/dist/capture/slots.js +50 -25
  84. package/dist/capture/slots.js.map +1 -1
  85. package/dist/capture/trackerConfig.js +100 -36
  86. package/dist/capture/trackerConfig.js.map +1 -1
  87. package/dist/capture/trackerEndpoint.js +22 -21
  88. package/dist/capture/trackerEndpoint.js.map +1 -1
  89. package/dist/charts/BarList.d.ts +27 -14
  90. package/dist/charts/BarList.js +38 -83
  91. package/dist/charts/BarList.js.map +1 -1
  92. package/dist/charts/TrendChart.d.ts +40 -7
  93. package/dist/charts/TrendChart.js +243 -215
  94. package/dist/charts/TrendChart.js.map +1 -1
  95. package/dist/charts/bars.d.ts +15 -1
  96. package/dist/charts/bars.js +12 -12
  97. package/dist/charts/bars.js.map +1 -1
  98. package/dist/charts/bucket.js +106 -73
  99. package/dist/charts/bucket.js.map +1 -1
  100. package/dist/charts/inProgress.js +22 -0
  101. package/dist/charts/inProgress.js.map +1 -0
  102. package/dist/charts/series.d.ts +15 -0
  103. package/dist/charts/series.js +123 -0
  104. package/dist/charts/series.js.map +1 -0
  105. package/dist/charts/spline.js +91 -25
  106. package/dist/charts/spline.js.map +1 -1
  107. package/dist/charts/trendGeometry.js +91 -0
  108. package/dist/charts/trendGeometry.js.map +1 -0
  109. package/dist/core/adminOptions.d.ts +1 -0
  110. package/dist/core/adminOptions.js +193 -0
  111. package/dist/core/adminOptions.js.map +1 -0
  112. package/dist/core/budget.js +24 -0
  113. package/dist/core/budget.js.map +1 -0
  114. package/dist/core/cacheKey.d.ts +1 -0
  115. package/dist/core/cacheKey.js +48 -37
  116. package/dist/core/cacheKey.js.map +1 -1
  117. package/dist/core/cacheOptions.js +165 -0
  118. package/dist/core/cacheOptions.js.map +1 -0
  119. package/dist/core/capabilities.d.ts +24 -11
  120. package/dist/core/capabilities.js +96 -17
  121. package/dist/core/capabilities.js.map +1 -1
  122. package/dist/core/capture.d.ts +26 -25
  123. package/dist/core/captureOptions.d.ts +1 -0
  124. package/dist/core/captureOptions.js +258 -0
  125. package/dist/core/captureOptions.js.map +1 -0
  126. package/dist/core/clock.js +13 -0
  127. package/dist/core/clock.js.map +1 -0
  128. package/dist/core/collectionOption.d.ts +17 -0
  129. package/dist/core/collectionOption.js +104 -0
  130. package/dist/core/collectionOption.js.map +1 -0
  131. package/dist/core/collectionSlug.js +7 -0
  132. package/dist/core/collectionSlug.js.map +1 -0
  133. package/dist/core/contract.d.ts +285 -59
  134. package/dist/core/contract.js +6 -4
  135. package/dist/core/contract.js.map +1 -1
  136. package/dist/core/cron.js +57 -0
  137. package/dist/core/cron.js.map +1 -0
  138. package/dist/core/fetch.d.ts +17 -0
  139. package/dist/core/goalOptions.d.ts +1 -0
  140. package/dist/core/goalOptions.js +166 -0
  141. package/dist/core/goalOptions.js.map +1 -0
  142. package/dist/core/granularity.js +3 -2
  143. package/dist/core/granularity.js.map +1 -1
  144. package/dist/core/guards.js +17 -0
  145. package/dist/core/guards.js.map +1 -0
  146. package/dist/core/jobs.d.ts +40 -0
  147. package/dist/core/jobs.js +132 -0
  148. package/dist/core/jobs.js.map +1 -0
  149. package/dist/core/legacyOptions.js +145 -0
  150. package/dist/core/legacyOptions.js.map +1 -0
  151. package/dist/core/metricAliases.js +81 -0
  152. package/dist/core/metricAliases.js.map +1 -0
  153. package/dist/core/metricValues.js +57 -0
  154. package/dist/core/metricValues.js.map +1 -0
  155. package/dist/core/monotonic.js +10 -0
  156. package/dist/core/monotonic.js.map +1 -0
  157. package/dist/core/optionChecks.js +51 -0
  158. package/dist/core/optionChecks.js.map +1 -0
  159. package/dist/core/options.d.ts +473 -157
  160. package/dist/core/options.js +154 -219
  161. package/dist/core/options.js.map +1 -1
  162. package/dist/core/registry.js +45 -5
  163. package/dist/core/registry.js.map +1 -1
  164. package/dist/core/scopeList.js +7 -9
  165. package/dist/core/scopeList.js.map +1 -1
  166. package/dist/core/scopeOptions.d.ts +1 -0
  167. package/dist/core/scopeOptions.js +112 -0
  168. package/dist/core/scopeOptions.js.map +1 -0
  169. package/dist/core/scopedRead.js +182 -72
  170. package/dist/core/scopedRead.js.map +1 -1
  171. package/dist/core/sdks.d.ts +81 -0
  172. package/dist/core/sdks.js +23 -0
  173. package/dist/core/sdks.js.map +1 -0
  174. package/dist/core/serverEvent.d.ts +38 -20
  175. package/dist/core/serverEvent.js.map +1 -1
  176. package/dist/core/siteAddress.js +20 -0
  177. package/dist/core/siteAddress.js.map +1 -0
  178. package/dist/core/sourceErrors.js +109 -0
  179. package/dist/core/sourceErrors.js.map +1 -0
  180. package/dist/core/sourceOptions.js +94 -0
  181. package/dist/core/sourceOptions.js.map +1 -0
  182. package/dist/core/throttle.js +18 -0
  183. package/dist/core/throttle.js.map +1 -0
  184. package/dist/core/values.js +61 -0
  185. package/dist/core/values.js.map +1 -0
  186. package/dist/core/widgetSlugs.d.ts +17 -0
  187. package/dist/core/widgetSlugs.js +29 -0
  188. package/dist/core/widgetSlugs.js.map +1 -0
  189. package/dist/db/detachedWrite.js +36 -0
  190. package/dist/db/detachedWrite.js.map +1 -0
  191. package/dist/db/errors.js +182 -0
  192. package/dist/db/errors.js.map +1 -0
  193. package/dist/db/kind.js +32 -0
  194. package/dist/db/kind.js.map +1 -0
  195. package/dist/db/openTransaction.js +51 -0
  196. package/dist/db/openTransaction.js.map +1 -0
  197. package/dist/exports/adapters/contract.d.ts +14 -0
  198. package/dist/exports/adapters/ga4.d.ts +15 -1
  199. package/dist/exports/adapters/native.d.ts +26 -2
  200. package/dist/exports/adapters/native.js +4 -1
  201. package/dist/exports/adapters/plausible.d.ts +15 -1
  202. package/dist/exports/adapters/posthog.d.ts +15 -1
  203. package/dist/exports/adapters/umami.d.ts +15 -1
  204. package/dist/exports/attributes.d.ts +42 -0
  205. package/dist/exports/attributes.js +83 -0
  206. package/dist/exports/attributes.js.map +1 -0
  207. package/dist/exports/client.d.ts +41 -13
  208. package/dist/exports/client.js +21 -9
  209. package/dist/exports/geo.d.ts +3 -1
  210. package/dist/exports/geo.js +1 -1
  211. package/dist/exports/i18n.d.ts +2 -2
  212. package/dist/exports/i18n.js +2 -2
  213. package/dist/exports/migrations.d.ts +2 -0
  214. package/dist/exports/migrations.js +2 -0
  215. package/dist/exports/next.d.ts +18 -1
  216. package/dist/exports/next.js +3 -1
  217. package/dist/exports/react.d.ts +3 -2
  218. package/dist/exports/react.js +1 -2
  219. package/dist/exports/rsc.d.ts +31 -14
  220. package/dist/exports/rsc.js +11 -6
  221. package/dist/exports/site.d.ts +5 -0
  222. package/dist/exports/site.js +3 -0
  223. package/dist/exports/testing.d.ts +17 -0
  224. package/dist/exports/testing.js +3 -0
  225. package/dist/exports/tracker.d.ts +5 -20
  226. package/dist/exports/tracker.js +3 -14
  227. package/dist/exports/types.d.ts +40 -14
  228. package/dist/exports/types.js +5 -1
  229. package/dist/fields/AnalyticsPanelClient.js +265 -154
  230. package/dist/fields/AnalyticsPanelClient.js.map +1 -1
  231. package/dist/fields/AnalyticsPanelField.d.ts +20 -8
  232. package/dist/fields/AnalyticsPanelField.js +121 -30
  233. package/dist/fields/AnalyticsPanelField.js.map +1 -1
  234. package/dist/fields/AnalyticsStatField.d.ts +18 -7
  235. package/dist/fields/AnalyticsStatField.js +98 -63
  236. package/dist/fields/AnalyticsStatField.js.map +1 -1
  237. package/dist/fields/FieldShimmer.js +15 -0
  238. package/dist/fields/FieldShimmer.js.map +1 -0
  239. package/dist/fields/PanelContent.js +217 -0
  240. package/dist/fields/PanelContent.js.map +1 -0
  241. package/dist/fields/PanelList.js +82 -0
  242. package/dist/fields/PanelList.js.map +1 -0
  243. package/dist/fields/PanelLiveCounter.js +63 -0
  244. package/dist/fields/PanelLiveCounter.js.map +1 -0
  245. package/dist/fields/PanelSkeleton.js +63 -0
  246. package/dist/fields/PanelSkeleton.js.map +1 -0
  247. package/dist/fields/componentPaths.js +8 -0
  248. package/dist/fields/componentPaths.js.map +1 -0
  249. package/dist/fields/config/FilterDimensionSelectField.d.ts +2 -2
  250. package/dist/fields/config/FilterDimensionSelectField.js +26 -54
  251. package/dist/fields/config/FilterDimensionSelectField.js.map +1 -1
  252. package/dist/fields/config/FilterKeySelect.js +66 -0
  253. package/dist/fields/config/FilterKeySelect.js.map +1 -0
  254. package/dist/fields/config/FilterOperatorSelectField.d.ts +7 -2
  255. package/dist/fields/config/FilterOperatorSelectField.js +37 -53
  256. package/dist/fields/config/FilterOperatorSelectField.js.map +1 -1
  257. package/dist/fields/config/FilterValueField.d.ts +17 -0
  258. package/dist/fields/config/FilterValueField.js +130 -0
  259. package/dist/fields/config/FilterValueField.js.map +1 -0
  260. package/dist/fields/config/MetricSelectField.d.ts +5 -12
  261. package/dist/fields/config/MetricSelectField.js +18 -30
  262. package/dist/fields/config/MetricSelectField.js.map +1 -1
  263. package/dist/fields/config/OptionSelect.js +52 -0
  264. package/dist/fields/config/OptionSelect.js.map +1 -0
  265. package/dist/fields/config/SourceSelectField.js +16 -31
  266. package/dist/fields/config/SourceSelectField.js.map +1 -1
  267. package/dist/fields/config/fetchSources.js +14 -26
  268. package/dist/fields/config/fetchSources.js.map +1 -1
  269. package/dist/fields/config/filterValues.js +106 -0
  270. package/dist/fields/config/filterValues.js.map +1 -0
  271. package/dist/fields/config/narrow.js +8 -10
  272. package/dist/fields/config/narrow.js.map +1 -1
  273. package/dist/fields/config/retiredPickers.d.ts +45 -0
  274. package/dist/fields/config/retiredPickers.js +46 -0
  275. package/dist/fields/config/retiredPickers.js.map +1 -0
  276. package/dist/fields/config/scopedFields.d.ts +40 -0
  277. package/dist/fields/config/scopedFields.js +68 -0
  278. package/dist/fields/config/scopedFields.js.map +1 -0
  279. package/dist/fields/config/toSelectOption.js +13 -7
  280. package/dist/fields/config/toSelectOption.js.map +1 -1
  281. package/dist/fields/config/useAnalyticsSources.d.ts +5 -7
  282. package/dist/fields/config/useAnalyticsSources.js +17 -21
  283. package/dist/fields/config/useAnalyticsSources.js.map +1 -1
  284. package/dist/fields/config/useFilterCapabilities.d.ts +9 -6
  285. package/dist/fields/config/useFilterCapabilities.js +23 -15
  286. package/dist/fields/config/useFilterCapabilities.js.map +1 -1
  287. package/dist/fields/config/useFormString.js +12 -0
  288. package/dist/fields/config/useFormString.js.map +1 -0
  289. package/dist/fields/dateRange/field.js +7 -19
  290. package/dist/fields/dateRange/field.js.map +1 -1
  291. package/dist/fields/dateRange/types.d.ts +5 -1
  292. package/dist/fields/dateRange/ui.d.ts +3 -2
  293. package/dist/fields/dateRange/ui.js +57 -319
  294. package/dist/fields/dateRange/ui.js.map +1 -1
  295. package/dist/fields/documentScope.js +21 -0
  296. package/dist/fields/documentScope.js.map +1 -0
  297. package/dist/fields/emptyState.js +31 -26
  298. package/dist/fields/emptyState.js.map +1 -1
  299. package/dist/fields/factories.d.ts +35 -16
  300. package/dist/fields/factories.js +66 -37
  301. package/dist/fields/factories.js.map +1 -1
  302. package/dist/fields/format.d.ts +12 -3
  303. package/dist/fields/format.js +77 -13
  304. package/dist/fields/format.js.map +1 -1
  305. package/dist/fields/itemReport.js +45 -0
  306. package/dist/fields/itemReport.js.map +1 -0
  307. package/dist/fields/readForDocument.d.ts +78 -26
  308. package/dist/fields/readForDocument.js +446 -116
  309. package/dist/fields/readForDocument.js.map +1 -1
  310. package/dist/fields/stateKeys.js +20 -0
  311. package/dist/fields/stateKeys.js.map +1 -0
  312. package/dist/goals/GoalAmountField.d.ts +10 -0
  313. package/dist/goals/GoalAmountField.js +162 -0
  314. package/dist/goals/GoalAmountField.js.map +1 -0
  315. package/dist/goals/GoalSelectField.js +89 -40
  316. package/dist/goals/GoalSelectField.js.map +1 -1
  317. package/dist/goals/GoalSelectFieldServer.d.ts +13 -0
  318. package/dist/goals/GoalSelectFieldServer.js +21 -0
  319. package/dist/goals/GoalSelectFieldServer.js.map +1 -0
  320. package/dist/goals/amountField.d.ts +20 -0
  321. package/dist/goals/amountField.js +37 -0
  322. package/dist/goals/amountField.js.map +1 -0
  323. package/dist/goals/builtin.js +17 -0
  324. package/dist/goals/builtin.js.map +1 -0
  325. package/dist/goals/collection.d.ts +22 -0
  326. package/dist/goals/collection.js +141 -100
  327. package/dist/goals/collection.js.map +1 -1
  328. package/dist/goals/constants.d.ts +38 -0
  329. package/dist/goals/constants.js +49 -0
  330. package/dist/goals/constants.js.map +1 -0
  331. package/dist/goals/currency.d.ts +16 -0
  332. package/dist/goals/currency.js +46 -4
  333. package/dist/goals/currency.js.map +1 -1
  334. package/dist/goals/currencyOptions.js +70 -0
  335. package/dist/goals/currencyOptions.js.map +1 -0
  336. package/dist/goals/fetchGoals.d.ts +10 -0
  337. package/dist/goals/fetchGoals.js +12 -26
  338. package/dist/goals/fetchGoals.js.map +1 -1
  339. package/dist/goals/goalField.d.ts +4 -6
  340. package/dist/goals/goalField.js +9 -19
  341. package/dist/goals/goalField.js.map +1 -1
  342. package/dist/goals/goalsEndpoint.js +39 -40
  343. package/dist/goals/goalsEndpoint.js.map +1 -1
  344. package/dist/goals/items.js +35 -0
  345. package/dist/goals/items.js.map +1 -0
  346. package/dist/goals/latent.js +9 -0
  347. package/dist/goals/latent.js.map +1 -0
  348. package/dist/goals/linkFields.d.ts +35 -0
  349. package/dist/goals/linkFields.js +31 -0
  350. package/dist/goals/linkFields.js.map +1 -0
  351. package/dist/goals/match.d.ts +14 -0
  352. package/dist/goals/match.js +67 -46
  353. package/dist/goals/match.js.map +1 -1
  354. package/dist/goals/moneyFields.js +56 -0
  355. package/dist/goals/moneyFields.js.map +1 -0
  356. package/dist/goals/pathMatch.js +122 -0
  357. package/dist/goals/pathMatch.js.map +1 -0
  358. package/dist/goals/placeholder.js +12 -0
  359. package/dist/goals/placeholder.js.map +1 -0
  360. package/dist/goals/resolver.d.ts +3 -3
  361. package/dist/goals/resolver.js +154 -46
  362. package/dist/goals/resolver.js.map +1 -1
  363. package/dist/goals/serverRevenue.d.ts +60 -0
  364. package/dist/goals/serverRevenue.js +41 -0
  365. package/dist/goals/serverRevenue.js.map +1 -0
  366. package/dist/goals/trackGoalAction.d.ts +26 -27
  367. package/dist/goals/trackGoalAction.js +38 -52
  368. package/dist/goals/trackGoalAction.js.map +1 -1
  369. package/dist/goals/types.d.ts +13 -28
  370. package/dist/goals/types.js +1 -1
  371. package/dist/goals/types.js.map +1 -1
  372. package/dist/goals/useAnalyticsGoals.d.ts +6 -5
  373. package/dist/goals/useAnalyticsGoals.js +17 -18
  374. package/dist/goals/useAnalyticsGoals.js.map +1 -1
  375. package/dist/index.d.ts +63 -11
  376. package/dist/index.js +257 -247
  377. package/dist/index.js.map +1 -1
  378. package/dist/items/collectionIdType.js +20 -0
  379. package/dist/items/collectionIdType.js.map +1 -0
  380. package/dist/items/idType.js +31 -0
  381. package/dist/items/idType.js.map +1 -0
  382. package/dist/items/ref.js +73 -0
  383. package/dist/items/ref.js.map +1 -0
  384. package/dist/maintenance/apiTaskState.js +141 -0
  385. package/dist/maintenance/apiTaskState.js.map +1 -0
  386. package/dist/maintenance/heartbeat.js +51 -0
  387. package/dist/maintenance/heartbeat.js.map +1 -0
  388. package/dist/maintenance/lease.d.ts +1 -0
  389. package/dist/maintenance/lease.js +81 -0
  390. package/dist/maintenance/lease.js.map +1 -0
  391. package/dist/maintenance/taskSchedule.d.ts +1 -0
  392. package/dist/maintenance/taskSchedule.js +62 -0
  393. package/dist/maintenance/taskSchedule.js.map +1 -0
  394. package/dist/maintenance/underLease.js +35 -0
  395. package/dist/maintenance/underLease.js.map +1 -0
  396. package/dist/migrations/legacy.d.ts +54 -0
  397. package/dist/migrations/legacy.js +117 -0
  398. package/dist/migrations/legacy.js.map +1 -0
  399. package/dist/migrations/predefined/dropLegacyMongo.d.ts +11 -0
  400. package/dist/migrations/predefined/dropLegacyMongo.js +12 -0
  401. package/dist/migrations/predefined/dropLegacyMongo.js.map +1 -0
  402. package/dist/native/collections/aggregates.js +54 -0
  403. package/dist/native/collections/aggregates.js.map +1 -0
  404. package/dist/native/collections/hits.js +102 -0
  405. package/dist/native/collections/hits.js.map +1 -0
  406. package/dist/native/collections/slugs.d.ts +10 -0
  407. package/dist/native/collections/slugs.js +16 -0
  408. package/dist/native/collections/slugs.js.map +1 -0
  409. package/dist/native/collections/state.js +84 -0
  410. package/dist/native/collections/state.js.map +1 -0
  411. package/dist/native/collections/storeCollection.js +29 -0
  412. package/dist/native/collections/storeCollection.js.map +1 -0
  413. package/dist/native/engine/buckets.d.ts +1 -0
  414. package/dist/native/engine/buckets.js +53 -0
  415. package/dist/native/engine/buckets.js.map +1 -0
  416. package/dist/native/engine/capabilities.js +87 -0
  417. package/dist/native/engine/capabilities.js.map +1 -0
  418. package/dist/native/engine/cost.js +72 -0
  419. package/dist/native/engine/cost.js.map +1 -0
  420. package/dist/native/engine/days.d.ts +1 -0
  421. package/dist/native/engine/days.js +182 -0
  422. package/dist/native/engine/days.js.map +1 -0
  423. package/dist/native/engine/engine.d.ts +1 -0
  424. package/dist/native/engine/engine.js +1623 -0
  425. package/dist/native/engine/engine.js.map +1 -0
  426. package/dist/native/engine/instance.js +58 -0
  427. package/dist/native/engine/instance.js.map +1 -0
  428. package/dist/native/engine/maintenance.d.ts +1 -0
  429. package/dist/native/engine/maintenance.js +677 -0
  430. package/dist/native/engine/maintenance.js.map +1 -0
  431. package/dist/native/engine/merge.js +41 -0
  432. package/dist/native/engine/merge.js.map +1 -0
  433. package/dist/native/engine/nudge.js +26 -0
  434. package/dist/native/engine/nudge.js.map +1 -0
  435. package/dist/native/engine/planner.js +198 -0
  436. package/dist/native/engine/planner.js.map +1 -0
  437. package/dist/native/engine/rebuild.d.ts +22 -0
  438. package/dist/native/engine/rebuild.js +76 -0
  439. package/dist/native/engine/rebuild.js.map +1 -0
  440. package/dist/native/engine/recent.js +17 -0
  441. package/dist/native/engine/recent.js.map +1 -0
  442. package/dist/native/engine/salt.d.ts +1 -0
  443. package/dist/native/engine/salt.js +98 -0
  444. package/dist/native/engine/salt.js.map +1 -0
  445. package/dist/native/engine/siteHosts.d.ts +1 -0
  446. package/dist/native/engine/siteHosts.js +58 -0
  447. package/dist/native/engine/siteHosts.js.map +1 -0
  448. package/dist/native/engine/toHit.js +108 -0
  449. package/dist/native/engine/toHit.js.map +1 -0
  450. package/dist/native/engine/writeBuffer.d.ts +14 -0
  451. package/dist/native/engine/writeBuffer.js +317 -0
  452. package/dist/native/engine/writeBuffer.js.map +1 -0
  453. package/dist/native/geo/composeGeoResolvers.d.ts +1 -0
  454. package/dist/native/geo/composeGeoResolvers.js +4 -1
  455. package/dist/native/geo/composeGeoResolvers.js.map +1 -1
  456. package/dist/native/geo/geoResolver.d.ts +20 -2
  457. package/dist/native/geo/geoResolver.js +42 -6
  458. package/dist/native/geo/geoResolver.js.map +1 -1
  459. package/dist/native/geo/maxmindResolver.d.ts +8 -4
  460. package/dist/native/geo/maxmindResolver.js +20 -16
  461. package/dist/native/geo/maxmindResolver.js.map +1 -1
  462. package/dist/native/geo/resolveGeo.js +31 -0
  463. package/dist/native/geo/resolveGeo.js.map +1 -0
  464. package/dist/native/ingest/bots.d.ts +2 -3
  465. package/dist/native/ingest/bots.js +8 -13
  466. package/dist/native/ingest/bots.js.map +1 -1
  467. package/dist/native/ingest/browser.js +4 -6
  468. package/dist/native/ingest/browser.js.map +1 -1
  469. package/dist/native/ingest/clientIp.js +30 -9
  470. package/dist/native/ingest/clientIp.js.map +1 -1
  471. package/dist/native/ingest/device.js +4 -6
  472. package/dist/native/ingest/device.js.map +1 -1
  473. package/dist/native/ingest/endpoint.d.ts +1 -1
  474. package/dist/native/ingest/endpoint.js +119 -34
  475. package/dist/native/ingest/endpoint.js.map +1 -1
  476. package/dist/native/ingest/itemSignature.d.ts +26 -0
  477. package/dist/native/ingest/itemSignature.js +45 -0
  478. package/dist/native/ingest/itemSignature.js.map +1 -0
  479. package/dist/native/ingest/language.js +2 -3
  480. package/dist/native/ingest/language.js.map +1 -1
  481. package/dist/native/ingest/normalizeEvent.d.ts +60 -7
  482. package/dist/native/ingest/normalizeEvent.js +226 -61
  483. package/dist/native/ingest/normalizeEvent.js.map +1 -1
  484. package/dist/native/ingest/orderSignature.d.ts +13 -0
  485. package/dist/native/ingest/orderSignature.js +50 -0
  486. package/dist/native/ingest/orderSignature.js.map +1 -0
  487. package/dist/native/ingest/referrer.js +30 -32
  488. package/dist/native/ingest/referrer.js.map +1 -1
  489. package/dist/native/ingest/requestHost.js +10 -23
  490. package/dist/native/ingest/requestHost.js.map +1 -1
  491. package/dist/native/ingest/resolveHostname.d.ts +4 -13
  492. package/dist/native/ingest/resolveHostname.js +5 -6
  493. package/dist/native/ingest/resolveHostname.js.map +1 -1
  494. package/dist/native/ingest/revenue.d.ts +1 -0
  495. package/dist/native/ingest/revenue.js +121 -0
  496. package/dist/native/ingest/revenue.js.map +1 -0
  497. package/dist/native/ingest/route.d.ts +10 -0
  498. package/dist/native/ingest/route.js +82 -0
  499. package/dist/native/ingest/route.js.map +1 -0
  500. package/dist/native/ingest/serverTrack.d.ts +2 -10
  501. package/dist/native/ingest/serverTrack.js +181 -72
  502. package/dist/native/ingest/serverTrack.js.map +1 -1
  503. package/dist/native/ingest/signature.js +28 -0
  504. package/dist/native/ingest/signature.js.map +1 -0
  505. package/dist/native/ingest/source.d.ts +2 -3
  506. package/dist/native/ingest/source.js +35 -54
  507. package/dist/native/ingest/source.js.map +1 -1
  508. package/dist/native/ingest/utm.js +9 -9
  509. package/dist/native/ingest/utm.js.map +1 -1
  510. package/dist/native/ingest/validate.js +20 -10
  511. package/dist/native/ingest/validate.js.map +1 -1
  512. package/dist/native/ingest/visitorHash.js +6 -8
  513. package/dist/native/ingest/visitorHash.js.map +1 -1
  514. package/dist/native/nativeAdapter.d.ts +101 -33
  515. package/dist/native/nativeAdapter.js +375 -317
  516. package/dist/native/nativeAdapter.js.map +1 -1
  517. package/dist/native/rebuildDays.d.ts +12 -0
  518. package/dist/native/rebuildDays.js +16 -0
  519. package/dist/native/rebuildDays.js.map +1 -0
  520. package/dist/native/store/aggregate.js +450 -0
  521. package/dist/native/store/aggregate.js.map +1 -0
  522. package/dist/native/store/caps.d.ts +18 -0
  523. package/dist/native/store/caps.js +76 -0
  524. package/dist/native/store/caps.js.map +1 -0
  525. package/dist/native/store/chunks.js +34 -0
  526. package/dist/native/store/chunks.js.map +1 -0
  527. package/dist/native/store/columnValues.js +31 -0
  528. package/dist/native/store/columnValues.js.map +1 -0
  529. package/dist/native/store/dialect.js +106 -0
  530. package/dist/native/store/dialect.js.map +1 -0
  531. package/dist/native/store/eventStore.js +44 -0
  532. package/dist/native/store/eventStore.js.map +1 -0
  533. package/dist/native/store/hitRow.js +116 -0
  534. package/dist/native/store/hitRow.js.map +1 -0
  535. package/dist/native/store/hits.js +63 -0
  536. package/dist/native/store/hits.js.map +1 -0
  537. package/dist/native/store/ids.js +105 -0
  538. package/dist/native/store/ids.js.map +1 -0
  539. package/dist/native/store/mongo/aggregatePipelines.js +430 -0
  540. package/dist/native/store/mongo/aggregatePipelines.js.map +1 -0
  541. package/dist/native/store/mongo/mongoState.js +375 -0
  542. package/dist/native/store/mongo/mongoState.js.map +1 -0
  543. package/dist/native/store/mongo/mongoStore.js +618 -0
  544. package/dist/native/store/mongo/mongoStore.js.map +1 -0
  545. package/dist/native/store/mongo/pipelines.js +695 -0
  546. package/dist/native/store/mongo/pipelines.js.map +1 -0
  547. package/dist/native/store/mongo/results.js +20 -0
  548. package/dist/native/store/mongo/results.js.map +1 -0
  549. package/dist/native/store/parts.d.ts +1 -0
  550. package/dist/native/store/parts.js +95 -0
  551. package/dist/native/store/parts.js.map +1 -0
  552. package/dist/native/store/pattern.js +213 -0
  553. package/dist/native/store/pattern.js.map +1 -0
  554. package/dist/native/store/rawRead.d.ts +23 -0
  555. package/dist/native/store/rawRead.js +384 -0
  556. package/dist/native/store/rawRead.js.map +1 -0
  557. package/dist/native/store/reclassify.js +53 -0
  558. package/dist/native/store/reclassify.js.map +1 -0
  559. package/dist/native/store/sql/aggregateSql.js +345 -0
  560. package/dist/native/store/sql/aggregateSql.js.map +1 -0
  561. package/dist/native/store/sql/columns.js +48 -0
  562. package/dist/native/store/sql/columns.js.map +1 -0
  563. package/dist/native/store/sql/compile.js +656 -0
  564. package/dist/native/store/sql/compile.js.map +1 -0
  565. package/dist/native/store/sql/drivers.js +218 -0
  566. package/dist/native/store/sql/drivers.js.map +1 -0
  567. package/dist/native/store/sql/executor.js +132 -0
  568. package/dist/native/store/sql/executor.js.map +1 -0
  569. package/dist/native/store/sql/fragment.js +104 -0
  570. package/dist/native/store/sql/fragment.js.map +1 -0
  571. package/dist/native/store/sql/maintenanceSql.js +59 -0
  572. package/dist/native/store/sql/maintenanceSql.js.map +1 -0
  573. package/dist/native/store/sql/ownConnection.js +107 -0
  574. package/dist/native/store/sql/ownConnection.js.map +1 -0
  575. package/dist/native/store/sql/poolShare.js +101 -0
  576. package/dist/native/store/sql/poolShare.js.map +1 -0
  577. package/dist/native/store/sql/sqlState.js +325 -0
  578. package/dist/native/store/sql/sqlState.js.map +1 -0
  579. package/dist/native/store/sql/sqlStore.js +355 -0
  580. package/dist/native/store/sql/sqlStore.js.map +1 -0
  581. package/dist/native/store/sql/sqliteThread.d.ts +9 -0
  582. package/dist/native/store/sql/sqliteThread.js +314 -0
  583. package/dist/native/store/sql/sqliteThread.js.map +1 -0
  584. package/dist/native/store/sql/sqliteWorker.js +327 -0
  585. package/dist/native/store/sql/sqliteWorker.js.map +1 -0
  586. package/dist/native/store/sql/sqliteWorkerSource.js +347 -0
  587. package/dist/native/store/sql/sqliteWorkerSource.js.map +1 -0
  588. package/dist/native/store/state.js +151 -0
  589. package/dist/native/store/state.js.map +1 -0
  590. package/dist/native/store/stateStore.js +29 -0
  591. package/dist/native/store/stateStore.js.map +1 -0
  592. package/dist/native/store/types.d.ts +9 -0
  593. package/dist/native/tasks/maintainTask.d.ts +19 -0
  594. package/dist/native/tasks/maintainTask.js +68 -0
  595. package/dist/native/tasks/maintainTask.js.map +1 -0
  596. package/dist/net/guardedFetch.d.ts +32 -0
  597. package/dist/net/guardedFetch.js +220 -0
  598. package/dist/net/guardedFetch.js.map +1 -0
  599. package/dist/net/origin.js +40 -0
  600. package/dist/net/origin.js.map +1 -0
  601. package/dist/net/platform.d.ts +9 -0
  602. package/dist/net/platform.js +35 -0
  603. package/dist/net/platform.js.map +1 -0
  604. package/dist/next/captureRewrites.d.ts +4 -24
  605. package/dist/next/captureRewrites.js +6 -50
  606. package/dist/next/captureRewrites.js.map +1 -1
  607. package/dist/next/captureRoute.d.ts +28 -0
  608. package/dist/next/captureRoute.js +67 -0
  609. package/dist/next/captureRoute.js.map +1 -0
  610. package/dist/next/ingestRoute.d.ts +17 -0
  611. package/dist/next/ingestRoute.js +17 -0
  612. package/dist/next/ingestRoute.js.map +1 -0
  613. package/dist/next/posthogProxyRewrites.d.ts +3 -25
  614. package/dist/next/posthogProxyRewrites.js +5 -37
  615. package/dist/next/posthogProxyRewrites.js.map +1 -1
  616. package/dist/plugin/adminDependencies.js +34 -0
  617. package/dist/plugin/adminDependencies.js.map +1 -0
  618. package/dist/plugin/apiPath.js +23 -0
  619. package/dist/plugin/apiPath.js.map +1 -0
  620. package/dist/plugin/boundDocument.js +58 -0
  621. package/dist/plugin/boundDocument.js.map +1 -0
  622. package/dist/plugin/buildPhase.js +10 -0
  623. package/dist/plugin/buildPhase.js.map +1 -0
  624. package/dist/plugin/collectionChecks.js +232 -0
  625. package/dist/plugin/collectionChecks.js.map +1 -0
  626. package/dist/plugin/collectionFields.d.ts +13 -0
  627. package/dist/plugin/collectionFields.js +22 -0
  628. package/dist/plugin/collectionFields.js.map +1 -0
  629. package/dist/plugin/createRuntime.js +336 -0
  630. package/dist/plugin/createRuntime.js.map +1 -0
  631. package/dist/plugin/destroy.js +58 -0
  632. package/dist/plugin/destroy.js.map +1 -0
  633. package/dist/plugin/documentEndpoint.js +76 -53
  634. package/dist/plugin/documentEndpoint.js.map +1 -1
  635. package/dist/plugin/documentScopes.js +37 -0
  636. package/dist/plugin/documentScopes.js.map +1 -0
  637. package/dist/plugin/encrypted.js +25 -0
  638. package/dist/plugin/encrypted.js.map +1 -0
  639. package/dist/plugin/errors.d.ts +5 -12
  640. package/dist/plugin/errors.js +23 -16
  641. package/dist/plugin/errors.js.map +1 -1
  642. package/dist/plugin/flagsEndpoint.js +41 -0
  643. package/dist/plugin/flagsEndpoint.js.map +1 -0
  644. package/dist/plugin/goalHint.js +22 -11
  645. package/dist/plugin/goalHint.js.map +1 -1
  646. package/dist/plugin/itemLabels.js +114 -0
  647. package/dist/plugin/itemLabels.js.map +1 -0
  648. package/dist/plugin/jobsAccess.js +91 -0
  649. package/dist/plugin/jobsAccess.js.map +1 -0
  650. package/dist/plugin/keepAlive.js +48 -0
  651. package/dist/plugin/keepAlive.js.map +1 -0
  652. package/dist/plugin/peerImportError.js +3 -6
  653. package/dist/plugin/peerImportError.js.map +1 -1
  654. package/dist/plugin/peers.js +64 -0
  655. package/dist/plugin/peers.js.map +1 -0
  656. package/dist/plugin/pluginCollections.js +155 -0
  657. package/dist/plugin/pluginCollections.js.map +1 -0
  658. package/dist/plugin/queryEndpoint.js +69 -44
  659. package/dist/plugin/queryEndpoint.js.map +1 -1
  660. package/dist/plugin/queryParams.js +7 -0
  661. package/dist/plugin/queryParams.js.map +1 -0
  662. package/dist/plugin/readContextForRequest.js +52 -17
  663. package/dist/plugin/readContextForRequest.js.map +1 -1
  664. package/dist/plugin/readFailure.js +22 -0
  665. package/dist/plugin/readFailure.js.map +1 -0
  666. package/dist/plugin/readableProviders.js +64 -0
  667. package/dist/plugin/readableProviders.js.map +1 -0
  668. package/dist/plugin/realtimeEndpoint.js +77 -25
  669. package/dist/plugin/realtimeEndpoint.js.map +1 -1
  670. package/dist/plugin/refreshEndpoint.js +69 -44
  671. package/dist/plugin/refreshEndpoint.js.map +1 -1
  672. package/dist/plugin/relabelFields.js +36 -0
  673. package/dist/plugin/relabelFields.js.map +1 -0
  674. package/dist/plugin/requestMemo.js +35 -0
  675. package/dist/plugin/requestMemo.js.map +1 -0
  676. package/dist/plugin/routeChecks.js +39 -0
  677. package/dist/plugin/routeChecks.js.map +1 -0
  678. package/dist/plugin/routes.d.ts +53 -0
  679. package/dist/plugin/routes.js +92 -0
  680. package/dist/plugin/routes.js.map +1 -0
  681. package/dist/plugin/runtime.d.ts +1 -1
  682. package/dist/plugin/runtime.js +226 -30
  683. package/dist/plugin/runtime.js.map +1 -1
  684. package/dist/plugin/schemaOnly.js +63 -0
  685. package/dist/plugin/schemaOnly.js.map +1 -0
  686. package/dist/plugin/scopeChange.js +6 -5
  687. package/dist/plugin/scopeChange.js.map +1 -1
  688. package/dist/plugin/scopeFieldBoot.js +4 -4
  689. package/dist/plugin/scopeFieldBoot.js.map +1 -1
  690. package/dist/plugin/scopeToken.js +33 -0
  691. package/dist/plugin/scopeToken.js.map +1 -0
  692. package/dist/plugin/sourcesEndpoint.js +46 -12
  693. package/dist/plugin/sourcesEndpoint.js.map +1 -1
  694. package/dist/plugin/unbundledLanguages.js +25 -0
  695. package/dist/plugin/unbundledLanguages.js.map +1 -0
  696. package/dist/plugin/walkFields.js +22 -0
  697. package/dist/plugin/walkFields.js.map +1 -0
  698. package/dist/plugin/warmTask.js +0 -0
  699. package/dist/plugin/warmTask.js.map +1 -1
  700. package/dist/providers/access.d.ts +1 -0
  701. package/dist/providers/access.js +35 -26
  702. package/dist/providers/access.js.map +1 -1
  703. package/dist/providers/adapterPool.js +121 -0
  704. package/dist/providers/adapterPool.js.map +1 -0
  705. package/dist/providers/collection.d.ts +53 -0
  706. package/dist/providers/collection.js +274 -150
  707. package/dist/providers/collection.js.map +1 -1
  708. package/dist/providers/factory.d.ts +76 -0
  709. package/dist/providers/factory.js +76 -23
  710. package/dist/providers/factory.js.map +1 -1
  711. package/dist/providers/hosts.d.ts +25 -0
  712. package/dist/providers/hosts.js +128 -0
  713. package/dist/providers/hosts.js.map +1 -0
  714. package/dist/providers/probe.d.ts +1 -0
  715. package/dist/providers/probe.js +101 -0
  716. package/dist/providers/probe.js.map +1 -0
  717. package/dist/providers/refresh.d.ts +18 -0
  718. package/dist/providers/refresh.js +49 -0
  719. package/dist/providers/refresh.js.map +1 -0
  720. package/dist/providers/registry.js +318 -0
  721. package/dist/providers/registry.js.map +1 -0
  722. package/dist/providers/resolver.js +23 -88
  723. package/dist/providers/resolver.js.map +1 -1
  724. package/dist/providers/retarget.js +45 -0
  725. package/dist/providers/retarget.js.map +1 -0
  726. package/dist/providers/secrets.d.ts +26 -0
  727. package/dist/providers/secrets.js +61 -4
  728. package/dist/providers/secrets.js.map +1 -1
  729. package/dist/providers/stampScope.js +9 -6
  730. package/dist/providers/stampScope.js.map +1 -1
  731. package/dist/query/dates.js +10 -12
  732. package/dist/query/dates.js.map +1 -1
  733. package/dist/query/errors.d.ts +1 -5
  734. package/dist/query/fetchQuery.d.ts +25 -32
  735. package/dist/query/fetchQuery.js +91 -91
  736. package/dist/query/fetchQuery.js.map +1 -1
  737. package/dist/query/limits.js +8 -0
  738. package/dist/query/limits.js.map +1 -0
  739. package/dist/query/parse.d.ts +6 -0
  740. package/dist/query/parse.js +153 -106
  741. package/dist/query/parse.js.map +1 -1
  742. package/dist/query/response.d.ts +23 -3
  743. package/dist/query/response.js +12 -5
  744. package/dist/query/response.js.map +1 -1
  745. package/dist/react/AnalyticsProvider.d.ts +26 -17
  746. package/dist/react/AnalyticsProvider.js +23 -22
  747. package/dist/react/AnalyticsProvider.js.map +1 -1
  748. package/dist/react/TrackerBoot.js +15 -9
  749. package/dist/react/TrackerBoot.js.map +1 -1
  750. package/dist/react/useAnalytics.d.ts +2 -11
  751. package/dist/react/useAnalytics.js +22 -24
  752. package/dist/react/useAnalytics.js.map +1 -1
  753. package/dist/site/AnalyticsScripts.d.ts +34 -0
  754. package/dist/site/AnalyticsScripts.js +30 -0
  755. package/dist/site/AnalyticsScripts.js.map +1 -0
  756. package/dist/site/getTrackerConfig.d.ts +15 -0
  757. package/dist/site/getTrackerConfig.js +40 -0
  758. package/dist/site/getTrackerConfig.js.map +1 -0
  759. package/dist/surfacing/afterRead.d.ts +37 -0
  760. package/dist/surfacing/bounded.js +38 -0
  761. package/dist/surfacing/bounded.js.map +1 -0
  762. package/dist/surfacing/breaker.js +107 -0
  763. package/dist/surfacing/breaker.js.map +1 -0
  764. package/dist/surfacing/cacheCollection.d.ts +8 -0
  765. package/dist/surfacing/cacheCollection.js +69 -0
  766. package/dist/surfacing/cacheCollection.js.map +1 -0
  767. package/dist/surfacing/cacheStore.d.ts +71 -1
  768. package/dist/surfacing/cacheStore.js +16 -37
  769. package/dist/surfacing/cacheStore.js.map +1 -1
  770. package/dist/surfacing/cacheSweep.d.ts +1 -0
  771. package/dist/surfacing/cacheSweep.js +59 -0
  772. package/dist/surfacing/cacheSweep.js.map +1 -0
  773. package/dist/surfacing/classifyError.js +282 -0
  774. package/dist/surfacing/classifyError.js.map +1 -0
  775. package/dist/surfacing/coalesce.js +2 -1
  776. package/dist/surfacing/coalesce.js.map +1 -1
  777. package/dist/surfacing/coldBudget.js +60 -0
  778. package/dist/surfacing/coldBudget.js.map +1 -0
  779. package/dist/surfacing/collectionCacheStore.js +183 -0
  780. package/dist/surfacing/collectionCacheStore.js.map +1 -0
  781. package/dist/surfacing/engine.d.ts +1 -1
  782. package/dist/surfacing/engine.js +514 -72
  783. package/dist/surfacing/engine.js.map +1 -1
  784. package/dist/surfacing/epoch.js +70 -26
  785. package/dist/surfacing/epoch.js.map +1 -1
  786. package/dist/surfacing/lanes.d.ts +1 -0
  787. package/dist/surfacing/lanes.js +297 -0
  788. package/dist/surfacing/lanes.js.map +1 -0
  789. package/dist/surfacing/memo.js +40 -0
  790. package/dist/surfacing/memo.js.map +1 -0
  791. package/dist/surfacing/rateLimiter.d.ts +1 -0
  792. package/dist/surfacing/rateLimiter.js +69 -94
  793. package/dist/surfacing/rateLimiter.js.map +1 -1
  794. package/dist/surfacing/rebucket.js +178 -0
  795. package/dist/surfacing/rebucket.js.map +1 -0
  796. package/dist/surfacing/recipe.js +28 -0
  797. package/dist/surfacing/recipe.js.map +1 -0
  798. package/dist/surfacing/shape.js +22 -0
  799. package/dist/surfacing/shape.js.map +1 -0
  800. package/dist/surfacing/todaySplit.js +113 -0
  801. package/dist/surfacing/todaySplit.js.map +1 -0
  802. package/dist/sync/collection.d.ts +8 -0
  803. package/dist/sync/collection.js +28 -18
  804. package/dist/sync/collection.js.map +1 -1
  805. package/dist/sync/rekeyDurations.js +70 -0
  806. package/dist/sync/rekeyDurations.js.map +1 -0
  807. package/dist/sync/syncTask.js +226 -109
  808. package/dist/sync/syncTask.js.map +1 -1
  809. package/dist/testing/memoryAdapter.d.ts +6 -3
  810. package/dist/testing/memoryAdapter.js +12 -10
  811. package/dist/testing/memoryAdapter.js.map +1 -1
  812. package/dist/testing/settle.d.ts +11 -0
  813. package/dist/testing/settle.js +19 -0
  814. package/dist/testing/settle.js.map +1 -0
  815. package/dist/timeframe/calendar.js +65 -0
  816. package/dist/timeframe/calendar.js.map +1 -0
  817. package/dist/timeframe/comparison.js +46 -0
  818. package/dist/timeframe/comparison.js.map +1 -0
  819. package/dist/timeframe/presets.d.ts +1 -1
  820. package/dist/timeframe/presets.js +5 -5
  821. package/dist/timeframe/presets.js.map +1 -1
  822. package/dist/timeframe/reportingTimezone.d.ts +1 -0
  823. package/dist/timeframe/reportingTimezone.js +64 -0
  824. package/dist/timeframe/reportingTimezone.js.map +1 -0
  825. package/dist/timeframe/tz.js +55 -39
  826. package/dist/timeframe/tz.js.map +1 -1
  827. package/dist/tracker/autoCapture.js +125 -38
  828. package/dist/tracker/autoCapture.js.map +1 -1
  829. package/dist/tracker/campaign.js +52 -0
  830. package/dist/tracker/campaign.js.map +1 -0
  831. package/dist/tracker/config.d.ts +144 -0
  832. package/dist/tracker/config.js +25 -0
  833. package/dist/tracker/config.js.map +1 -0
  834. package/dist/tracker/createTracker.d.ts +4 -10
  835. package/dist/tracker/createTracker.js +386 -115
  836. package/dist/tracker/createTracker.js.map +1 -1
  837. package/dist/tracker/digest.js +28 -0
  838. package/dist/tracker/digest.js.map +1 -0
  839. package/dist/tracker/engagement.js +100 -0
  840. package/dist/tracker/engagement.js.map +1 -0
  841. package/dist/tracker/events.js +37 -0
  842. package/dist/tracker/events.js.map +1 -0
  843. package/dist/tracker/exclusion.d.ts +2 -22
  844. package/dist/tracker/exclusion.js +53 -21
  845. package/dist/tracker/exclusion.js.map +1 -1
  846. package/dist/tracker/gate.js +194 -0
  847. package/dist/tracker/gate.js.map +1 -0
  848. package/dist/tracker/initTracker.d.ts +5 -8
  849. package/dist/tracker/initTracker.js +42 -14
  850. package/dist/tracker/initTracker.js.map +1 -1
  851. package/dist/tracker/itemCapture.js +224 -0
  852. package/dist/tracker/itemCapture.js.map +1 -0
  853. package/dist/tracker/loadScript.js +21 -14
  854. package/dist/tracker/loadScript.js.map +1 -1
  855. package/dist/tracker/pageTracking.js +6 -6
  856. package/dist/tracker/pageTracking.js.map +1 -1
  857. package/dist/tracker/registry.js +118 -30
  858. package/dist/tracker/registry.js.map +1 -1
  859. package/dist/tracker/sinks/createSink.js +38 -0
  860. package/dist/tracker/sinks/createSink.js.map +1 -0
  861. package/dist/tracker/sinks/ga4.js +64 -20
  862. package/dist/tracker/sinks/ga4.js.map +1 -1
  863. package/dist/tracker/sinks/native.js +7 -42
  864. package/dist/tracker/sinks/native.js.map +1 -1
  865. package/dist/tracker/sinks/plausible.js +27 -22
  866. package/dist/tracker/sinks/plausible.js.map +1 -1
  867. package/dist/tracker/sinks/posthog.js +26 -22
  868. package/dist/tracker/sinks/posthog.js.map +1 -1
  869. package/dist/tracker/sinks/umami.js +14 -12
  870. package/dist/tracker/sinks/umami.js.map +1 -1
  871. package/dist/tracker/sinks/vendor.js +30 -27
  872. package/dist/tracker/sinks/vendor.js.map +1 -1
  873. package/dist/tracker/skip.js +81 -0
  874. package/dist/tracker/skip.js.map +1 -0
  875. package/dist/tracker/storage.js +23 -0
  876. package/dist/tracker/storage.js.map +1 -0
  877. package/dist/tracker/transport.js +2 -5
  878. package/dist/tracker/transport.js.map +1 -1
  879. package/dist/tracker/types.d.ts +86 -63
  880. package/dist/tracker/window.js +7 -0
  881. package/dist/tracker/window.js.map +1 -0
  882. package/dist/translations/ar.js +226 -71
  883. package/dist/translations/ar.js.map +1 -1
  884. package/dist/translations/de.js +215 -69
  885. package/dist/translations/de.js.map +1 -1
  886. package/dist/translations/en.js +209 -67
  887. package/dist/translations/en.js.map +1 -1
  888. package/dist/translations/es.js +217 -68
  889. package/dist/translations/es.js.map +1 -1
  890. package/dist/translations/fr.js +221 -72
  891. package/dist/translations/fr.js.map +1 -1
  892. package/dist/translations/id.js +212 -67
  893. package/dist/translations/id.js.map +1 -1
  894. package/dist/translations/index.d.ts +1 -1
  895. package/dist/translations/index.js +5 -7
  896. package/dist/translations/index.js.map +1 -1
  897. package/dist/translations/intl.js +71 -0
  898. package/dist/translations/intl.js.map +1 -0
  899. package/dist/translations/keys.d.ts +185 -14
  900. package/dist/translations/keys.js +190 -14
  901. package/dist/translations/keys.js.map +1 -1
  902. package/dist/translations/ko.js +214 -69
  903. package/dist/translations/ko.js.map +1 -1
  904. package/dist/translations/labelMap.d.ts +10 -0
  905. package/dist/translations/labelMap.js +22 -0
  906. package/dist/translations/labelMap.js.map +1 -0
  907. package/dist/translations/metricKeys.js +10 -2
  908. package/dist/translations/metricKeys.js.map +1 -1
  909. package/dist/translations/parts.js +20 -0
  910. package/dist/translations/parts.js.map +1 -0
  911. package/dist/translations/plural.js +61 -0
  912. package/dist/translations/plural.js.map +1 -0
  913. package/dist/translations/pt.js +226 -77
  914. package/dist/translations/pt.js.map +1 -1
  915. package/dist/translations/ru.js +217 -66
  916. package/dist/translations/ru.js.map +1 -1
  917. package/dist/translations/server.d.ts +1 -0
  918. package/dist/translations/server.js +2 -3
  919. package/dist/translations/server.js.map +1 -1
  920. package/dist/translations/staticLabel.js +69 -0
  921. package/dist/translations/staticLabel.js.map +1 -0
  922. package/dist/translations/uk.js +217 -66
  923. package/dist/translations/uk.js.map +1 -1
  924. package/dist/translations/zh.js +212 -67
  925. package/dist/translations/zh.js.map +1 -1
  926. package/dist/ui/RangePicker.js +112 -0
  927. package/dist/ui/RangePicker.js.map +1 -0
  928. package/dist/ui/analytics.css +1528 -0
  929. package/dist/ui/calendarDays.js +27 -0
  930. package/dist/ui/calendarDays.js.map +1 -0
  931. package/dist/ui/classNames.js +7 -0
  932. package/dist/ui/classNames.js.map +1 -0
  933. package/dist/ui/components/Card.d.ts +28 -0
  934. package/dist/ui/components/Card.js +21 -0
  935. package/dist/ui/components/Card.js.map +1 -0
  936. package/dist/ui/components/ChartDataTable.d.ts +41 -0
  937. package/dist/ui/components/ChartDataTable.js +48 -0
  938. package/dist/ui/components/ChartDataTable.js.map +1 -0
  939. package/dist/ui/components/DataTable.d.ts +82 -0
  940. package/dist/ui/components/DataTable.js +214 -0
  941. package/dist/ui/components/DataTable.js.map +1 -0
  942. package/dist/ui/components/LabeledSelect.js +62 -0
  943. package/dist/ui/components/LabeledSelect.js.map +1 -0
  944. package/dist/ui/components/LiveAnnouncement.js +21 -0
  945. package/dist/ui/components/LiveAnnouncement.js.map +1 -0
  946. package/dist/ui/components/MetricCard.d.ts +38 -0
  947. package/dist/ui/components/MetricCard.js +39 -0
  948. package/dist/ui/components/MetricCard.js.map +1 -0
  949. package/dist/ui/components/NoValue.js +22 -0
  950. package/dist/ui/components/NoValue.js.map +1 -0
  951. package/dist/ui/components/ReadState.js +27 -0
  952. package/dist/ui/components/ReadState.js.map +1 -0
  953. package/dist/ui/components/RefreshButton.js +26 -0
  954. package/dist/ui/components/RefreshButton.js.map +1 -0
  955. package/dist/ui/cssVars.js +7 -0
  956. package/dist/ui/cssVars.js.map +1 -0
  957. package/dist/ui/data/WithScopeToken.d.ts +20 -0
  958. package/dist/ui/data/WithScopeToken.js +20 -0
  959. package/dist/ui/data/WithScopeToken.js.map +1 -0
  960. package/dist/ui/data/clientFieldProps.js +16 -0
  961. package/dist/ui/data/clientFieldProps.js.map +1 -0
  962. package/dist/ui/data/request.d.ts +46 -0
  963. package/dist/ui/data/request.js +119 -0
  964. package/dist/ui/data/request.js.map +1 -0
  965. package/dist/ui/data/scopeTokenContext.js +18 -0
  966. package/dist/ui/data/scopeTokenContext.js.map +1 -0
  967. package/dist/ui/data/sharedCache.js +48 -0
  968. package/dist/ui/data/sharedCache.js.map +1 -0
  969. package/dist/ui/data/useRequest.d.ts +19 -0
  970. package/dist/ui/data/useRequest.js +123 -0
  971. package/dist/ui/data/useRequest.js.map +1 -0
  972. package/dist/ui/data/useRequestScope.js +25 -0
  973. package/dist/ui/data/useRequestScope.js.map +1 -0
  974. package/dist/ui/hooks/useDirection.js +47 -0
  975. package/dist/ui/hooks/useDirection.js.map +1 -0
  976. package/dist/ui/hooks/useDismissOnEscape.js +25 -0
  977. package/dist/ui/hooks/useDismissOnEscape.js.map +1 -0
  978. package/dist/ui/hooks/useLiveAnnouncement.js +57 -0
  979. package/dist/ui/hooks/useLiveAnnouncement.js.map +1 -0
  980. package/dist/ui/hooks/useRealtimePoll.js +112 -0
  981. package/dist/ui/hooks/useRealtimePoll.js.map +1 -0
  982. package/dist/ui/readState.js +19 -0
  983. package/dist/ui/readState.js.map +1 -0
  984. package/dist/ui/rows/toDisplayRows.js +49 -0
  985. package/dist/ui/rows/toDisplayRows.js.map +1 -0
  986. package/dist/ui/viewerClock.js +7 -0
  987. package/dist/ui/viewerClock.js.map +1 -0
  988. package/dist/view/AnalyticsNavLink.d.ts +5 -3
  989. package/dist/view/AnalyticsNavLink.js +11 -6
  990. package/dist/view/AnalyticsNavLink.js.map +1 -1
  991. package/dist/view/AnalyticsView.d.ts +8 -10
  992. package/dist/view/AnalyticsView.js +47 -18
  993. package/dist/view/AnalyticsView.js.map +1 -1
  994. package/dist/view/AnalyticsViewClient.d.ts +4 -7
  995. package/dist/view/AnalyticsViewClient.js +15 -229
  996. package/dist/view/AnalyticsViewClient.js.map +1 -1
  997. package/dist/view/CountryFlag.d.ts +27 -0
  998. package/dist/view/CountryFlag.js +44 -0
  999. package/dist/view/CountryFlag.js.map +1 -0
  1000. package/dist/view/DocumentTitle.js +27 -0
  1001. package/dist/view/DocumentTitle.js.map +1 -0
  1002. package/dist/view/ViewRoot.d.ts +21 -0
  1003. package/dist/view/ViewRoot.js +150 -0
  1004. package/dist/view/ViewRoot.js.map +1 -0
  1005. package/dist/view/ViewSections.d.ts +38 -0
  1006. package/dist/view/ViewSections.js +190 -0
  1007. package/dist/view/ViewSections.js.map +1 -0
  1008. package/dist/view/authRedirect.js +2 -4
  1009. package/dist/view/authRedirect.js.map +1 -1
  1010. package/dist/view/conversionRate.js +9 -7
  1011. package/dist/view/conversionRate.js.map +1 -1
  1012. package/dist/view/dayRange.js +6 -10
  1013. package/dist/view/dayRange.js.map +1 -1
  1014. package/dist/view/exclusionLink.d.ts +27 -0
  1015. package/dist/view/exclusionLink.js +46 -0
  1016. package/dist/view/exclusionLink.js.map +1 -0
  1017. package/dist/view/flagSrc.js +14 -0
  1018. package/dist/view/flagSrc.js.map +1 -0
  1019. package/dist/view/gating.d.ts +15 -1
  1020. package/dist/view/gating.js +66 -31
  1021. package/dist/view/gating.js.map +1 -1
  1022. package/dist/view/hostCountryFlag.js +41 -0
  1023. package/dist/view/hostCountryFlag.js.map +1 -0
  1024. package/dist/view/labels.js +95 -10
  1025. package/dist/view/labels.js.map +1 -1
  1026. package/dist/view/metricAliases.js +10 -0
  1027. package/dist/view/metricAliases.js.map +1 -0
  1028. package/dist/view/navLabel.js +15 -0
  1029. package/dist/view/navLabel.js.map +1 -0
  1030. package/dist/view/registerView.js +10 -9
  1031. package/dist/view/registerView.js.map +1 -1
  1032. package/dist/view/scopeLabel.js +21 -0
  1033. package/dist/view/scopeLabel.js.map +1 -0
  1034. package/dist/view/sections/Breakdowns.js +196 -134
  1035. package/dist/view/sections/Breakdowns.js.map +1 -1
  1036. package/dist/view/sections/EmptyStates.js +118 -30
  1037. package/dist/view/sections/EmptyStates.js.map +1 -1
  1038. package/dist/view/sections/ExcludeBrowser.js +188 -0
  1039. package/dist/view/sections/ExcludeBrowser.js.map +1 -0
  1040. package/dist/view/sections/FilterChips.js +124 -27
  1041. package/dist/view/sections/FilterChips.js.map +1 -1
  1042. package/dist/view/sections/GoalsPanel.js +68 -60
  1043. package/dist/view/sections/GoalsPanel.js.map +1 -1
  1044. package/dist/view/sections/OverviewCards.js +29 -33
  1045. package/dist/view/sections/OverviewCards.js.map +1 -1
  1046. package/dist/view/sections/RealtimeStrip.js +70 -59
  1047. package/dist/view/sections/RealtimeStrip.js.map +1 -1
  1048. package/dist/view/sections/SectionBoundary.js +34 -0
  1049. package/dist/view/sections/SectionBoundary.js.map +1 -0
  1050. package/dist/view/sections/Toolbar.d.ts +11 -0
  1051. package/dist/view/sections/Toolbar.js +123 -82
  1052. package/dist/view/sections/Toolbar.js.map +1 -1
  1053. package/dist/view/sections/Trend.js +176 -76
  1054. package/dist/view/sections/Trend.js.map +1 -1
  1055. package/dist/view/state.d.ts +42 -0
  1056. package/dist/view/state.js +93 -54
  1057. package/dist/view/state.js.map +1 -1
  1058. package/dist/view/useViewClock.js +31 -0
  1059. package/dist/view/useViewClock.js.map +1 -0
  1060. package/dist/view/useViewQueries.d.ts +21 -0
  1061. package/dist/view/useViewQueries.js +45 -77
  1062. package/dist/view/useViewQueries.js.map +1 -1
  1063. package/dist/view/useViewState.js +42 -0
  1064. package/dist/view/useViewState.js.map +1 -0
  1065. package/dist/view/useViewUrl.js +47 -0
  1066. package/dist/view/useViewUrl.js.map +1 -0
  1067. package/dist/view/viewBody.js +30 -0
  1068. package/dist/view/viewBody.js.map +1 -0
  1069. package/dist/view/viewContext.d.ts +81 -0
  1070. package/dist/view/viewContext.js +49 -0
  1071. package/dist/view/viewContext.js.map +1 -0
  1072. package/dist/view/viewProps.d.ts +64 -7
  1073. package/dist/view/viewProps.js +121 -35
  1074. package/dist/view/viewProps.js.map +1 -1
  1075. package/dist/widgets/AnalyticsBreakdownWidget.d.ts +7 -3
  1076. package/dist/widgets/AnalyticsBreakdownWidget.js +143 -118
  1077. package/dist/widgets/AnalyticsBreakdownWidget.js.map +1 -1
  1078. package/dist/widgets/AnalyticsGoalsWidget.d.ts +6 -7
  1079. package/dist/widgets/AnalyticsGoalsWidget.js +124 -167
  1080. package/dist/widgets/AnalyticsGoalsWidget.js.map +1 -1
  1081. package/dist/widgets/AnalyticsMetricWidget.d.ts +7 -3
  1082. package/dist/widgets/AnalyticsMetricWidget.js +80 -106
  1083. package/dist/widgets/AnalyticsMetricWidget.js.map +1 -1
  1084. package/dist/widgets/AnalyticsRealtimeWidget.d.ts +7 -3
  1085. package/dist/widgets/AnalyticsRealtimeWidget.js +74 -64
  1086. package/dist/widgets/AnalyticsRealtimeWidget.js.map +1 -1
  1087. package/dist/widgets/AnalyticsTrendWidget.d.ts +7 -3
  1088. package/dist/widgets/AnalyticsTrendWidget.js +129 -123
  1089. package/dist/widgets/AnalyticsTrendWidget.js.map +1 -1
  1090. package/dist/widgets/ComparisonDelta.js +33 -42
  1091. package/dist/widgets/ComparisonDelta.js.map +1 -1
  1092. package/dist/widgets/RealtimeCounter.d.ts +24 -4
  1093. package/dist/widgets/RealtimeCounter.js +91 -77
  1094. package/dist/widgets/RealtimeCounter.js.map +1 -1
  1095. package/dist/widgets/WidgetCard.d.ts +80 -0
  1096. package/dist/widgets/WidgetCard.js +99 -0
  1097. package/dist/widgets/WidgetCard.js.map +1 -0
  1098. package/dist/widgets/WidgetFrame.js +42 -0
  1099. package/dist/widgets/WidgetFrame.js.map +1 -0
  1100. package/dist/widgets/WidgetShimmer.d.ts +55 -0
  1101. package/dist/widgets/WidgetShimmer.js +86 -0
  1102. package/dist/widgets/WidgetShimmer.js.map +1 -0
  1103. package/dist/widgets/breakdownTypes.js +12 -2
  1104. package/dist/widgets/breakdownTypes.js.map +1 -1
  1105. package/dist/widgets/customWidget.d.ts +5 -1
  1106. package/dist/widgets/customWidget.js +6 -7
  1107. package/dist/widgets/customWidget.js.map +1 -1
  1108. package/dist/widgets/defaults.d.ts +4 -7
  1109. package/dist/widgets/defaults.js +4 -7
  1110. package/dist/widgets/defaults.js.map +1 -1
  1111. package/dist/widgets/fieldRows.js +14 -0
  1112. package/dist/widgets/fieldRows.js.map +1 -0
  1113. package/dist/widgets/filterCaption.js +6 -7
  1114. package/dist/widgets/filterCaption.js.map +1 -1
  1115. package/dist/widgets/filterField.d.ts +3 -7
  1116. package/dist/widgets/filterField.js +46 -35
  1117. package/dist/widgets/filterField.js.map +1 -1
  1118. package/dist/widgets/filterValueLabel.d.ts +1 -0
  1119. package/dist/widgets/filterValueLabel.js +45 -0
  1120. package/dist/widgets/filterValueLabel.js.map +1 -0
  1121. package/dist/widgets/notices.js +73 -0
  1122. package/dist/widgets/notices.js.map +1 -0
  1123. package/dist/widgets/prepareWidgetRead.d.ts +5 -1
  1124. package/dist/widgets/prepareWidgetRead.js +59 -27
  1125. package/dist/widgets/prepareWidgetRead.js.map +1 -1
  1126. package/dist/widgets/range.js +26 -21
  1127. package/dist/widgets/range.js.map +1 -1
  1128. package/dist/widgets/readForWidget.d.ts +27 -18
  1129. package/dist/widgets/readForWidget.js +31 -29
  1130. package/dist/widgets/readForWidget.js.map +1 -1
  1131. package/dist/widgets/readForWidgetBreakdown.d.ts +39 -28
  1132. package/dist/widgets/readForWidgetBreakdown.js +46 -22
  1133. package/dist/widgets/readForWidgetBreakdown.js.map +1 -1
  1134. package/dist/widgets/readForWidgetGoals.d.ts +17 -23
  1135. package/dist/widgets/readForWidgetGoals.js +50 -46
  1136. package/dist/widgets/readForWidgetGoals.js.map +1 -1
  1137. package/dist/widgets/readForWidgetRealtime.d.ts +21 -17
  1138. package/dist/widgets/readForWidgetRealtime.js +51 -27
  1139. package/dist/widgets/readForWidgetRealtime.js.map +1 -1
  1140. package/dist/widgets/readForWidgetSeries.d.ts +26 -31
  1141. package/dist/widgets/readForWidgetSeries.js +43 -82
  1142. package/dist/widgets/readForWidgetSeries.js.map +1 -1
  1143. package/dist/widgets/readMeta.d.ts +44 -0
  1144. package/dist/widgets/readMeta.js +47 -4
  1145. package/dist/widgets/readMeta.js.map +1 -1
  1146. package/dist/widgets/realtimePoll.d.ts +1 -0
  1147. package/dist/widgets/realtimePoll.js +53 -25
  1148. package/dist/widgets/realtimePoll.js.map +1 -1
  1149. package/dist/widgets/registerWidgets.js +204 -126
  1150. package/dist/widgets/registerWidgets.js.map +1 -1
  1151. package/dist/widgets/stateKeys.js +30 -0
  1152. package/dist/widgets/stateKeys.js.map +1 -0
  1153. package/dist/widgets/titleForecast.js +89 -0
  1154. package/dist/widgets/titleForecast.js.map +1 -0
  1155. package/dist/widgets/types.d.ts +4 -3
  1156. package/dist/widgets/types.js +2 -0
  1157. package/dist/widgets/types.js.map +1 -1
  1158. package/dist/widgets/viewLink.d.ts +24 -6
  1159. package/dist/widgets/viewLink.js +31 -24
  1160. package/dist/widgets/viewLink.js.map +1 -1
  1161. package/dist/widgets/widgetData.js +34 -0
  1162. package/dist/widgets/widgetData.js.map +1 -0
  1163. package/dist/widgets/widgetWindow.d.ts +1 -0
  1164. package/dist/widgets/widgetWindow.js +51 -0
  1165. package/dist/widgets/widgetWindow.js.map +1 -0
  1166. package/package.json +44 -22
  1167. package/dist/adapters/ga4/disableKey.d.ts +0 -9
  1168. package/dist/capture/getTrackerConfig.d.ts +0 -20
  1169. package/dist/capture/getTrackerConfig.js +0 -31
  1170. package/dist/capture/getTrackerConfig.js.map +0 -1
  1171. package/dist/capture/slots.d.ts +0 -8
  1172. package/dist/capture/trackerConfig.d.ts +0 -33
  1173. package/dist/charts/styles.js +0 -59
  1174. package/dist/charts/styles.js.map +0 -1
  1175. package/dist/fields/config/SourceSelectField.d.ts +0 -14
  1176. package/dist/fields/dateRange/styles.js +0 -23
  1177. package/dist/fields/dateRange/styles.js.map +0 -1
  1178. package/dist/goals/GoalSelectField.d.ts +0 -7
  1179. package/dist/native/collections/events.js +0 -165
  1180. package/dist/native/collections/events.js.map +0 -1
  1181. package/dist/native/collections/rollups.js +0 -151
  1182. package/dist/native/collections/rollups.js.map +0 -1
  1183. package/dist/native/collections/seen.js +0 -47
  1184. package/dist/native/collections/seen.js.map +0 -1
  1185. package/dist/native/eventScan.js +0 -25
  1186. package/dist/native/eventScan.js.map +0 -1
  1187. package/dist/native/ingest/flushBatch.js +0 -60
  1188. package/dist/native/ingest/flushBatch.js.map +0 -1
  1189. package/dist/native/ingest/salt.js +0 -39
  1190. package/dist/native/ingest/salt.js.map +0 -1
  1191. package/dist/native/ingest/writeBuffer.js +0 -55
  1192. package/dist/native/ingest/writeBuffer.js.map +0 -1
  1193. package/dist/native/ingest/writeEvent.js +0 -14
  1194. package/dist/native/ingest/writeEvent.js.map +0 -1
  1195. package/dist/native/query/eventAgg.js +0 -175
  1196. package/dist/native/query/eventAgg.js.map +0 -1
  1197. package/dist/native/realtime/buildRealtime.js +0 -53
  1198. package/dist/native/realtime/buildRealtime.js.map +0 -1
  1199. package/dist/native/retention/pruneTask.js +0 -69
  1200. package/dist/native/retention/pruneTask.js.map +0 -1
  1201. package/dist/native/rollupAcc.js +0 -64
  1202. package/dist/native/rollupAcc.js.map +0 -1
  1203. package/dist/native/rollups/bucketKey.js +0 -15
  1204. package/dist/native/rollups/bucketKey.js.map +0 -1
  1205. package/dist/native/rollups/bumpRollups.js +0 -116
  1206. package/dist/native/rollups/bumpRollups.js.map +0 -1
  1207. package/dist/native/rollups/deltas.js +0 -106
  1208. package/dist/native/rollups/deltas.js.map +0 -1
  1209. package/dist/native/rollups/insertManyIfNew.js +0 -93
  1210. package/dist/native/rollups/insertManyIfNew.js.map +0 -1
  1211. package/dist/plugin/paths.js +0 -29
  1212. package/dist/plugin/paths.js.map +0 -1
  1213. package/dist/react/TrackerBoot.d.ts +0 -22
  1214. package/dist/rsc/AnalyticsScripts.d.ts +0 -30
  1215. package/dist/rsc/AnalyticsScripts.js +0 -41
  1216. package/dist/rsc/AnalyticsScripts.js.map +0 -1
  1217. package/dist/surfacing/queue.js +0 -60
  1218. package/dist/surfacing/queue.js.map +0 -1
  1219. package/dist/surfacing/retryPolicy.js +0 -15
  1220. package/dist/surfacing/retryPolicy.js.map +0 -1
  1221. package/dist/tracker/autoCapture.d.ts +0 -48
  1222. package/dist/tracker/consent.d.ts +0 -24
  1223. package/dist/tracker/consent.js +0 -48
  1224. package/dist/tracker/consent.js.map +0 -1
  1225. package/dist/tracker/loadScript.d.ts +0 -14
  1226. package/dist/tracker/pageTracking.d.ts +0 -17
  1227. package/dist/tracker/registry.d.ts +0 -27
  1228. package/dist/tracker/sinks/ga4.d.ts +0 -29
  1229. package/dist/tracker/sinks/native.d.ts +0 -22
  1230. package/dist/tracker/sinks/plausible.d.ts +0 -20
  1231. package/dist/tracker/sinks/posthog.d.ts +0 -18
  1232. package/dist/tracker/sinks/umami.d.ts +0 -18
  1233. package/dist/tracker/sinks/vendor.d.ts +0 -14
  1234. package/dist/view/sections/styles.js +0 -76
  1235. package/dist/view/sections/styles.js.map +0 -1
  1236. package/dist/widgets/WidgetViewLink.js +0 -17
  1237. package/dist/widgets/WidgetViewLink.js.map +0 -1
  1238. package/dist/widgets/cardChrome.d.ts +0 -8
  1239. package/dist/widgets/cardChrome.js +0 -46
  1240. package/dist/widgets/cardChrome.js.map +0 -1
  1241. package/dist/widgets/comparison.js +0 -57
  1242. package/dist/widgets/comparison.js.map +0 -1
@@ -1,8 +1,19 @@
1
+ import { isRecord } from "../core/values.js";
2
+ import { HostRefusedError } from "../core/sourceErrors.js";
3
+ import { checkDocumentHost } from "./hosts.js";
1
4
  import { ga4 } from "../adapters/ga4/ga4.js";
2
5
  import { plausible } from "../adapters/plausible/plausible.js";
3
6
  import { posthog } from "../adapters/posthog/posthog.js";
4
7
  import { umami } from "../adapters/umami/umami.js";
5
8
  //#region src/providers/factory.ts
9
+ const PROVIDER_IDS = [
10
+ "native",
11
+ "plausible",
12
+ "umami",
13
+ "ga4",
14
+ "posthog"
15
+ ];
16
+ /** A stored blank reads as unset. */
6
17
  const orUndefined = (value) => value || void 0;
7
18
  /** An unset or unrecognized stored region falls back to host-derived detection. */
8
19
  const posthogRegion = (value) => value === "us" || value === "eu" ? value : void 0;
@@ -12,36 +23,72 @@ const posthogRegion = (value) => value === "us" || value === "eu" ? value : void
12
23
  */
13
24
  const normalizePrivateKey = (key) => key.replace(/\\n/g, "\n");
14
25
  const shortId = (id) => String(id).slice(-6);
15
- /** Runtime adapters carry a per-document instance id so two projects of one provider type never collide in a registry; config adapters keep their plain ids. */
26
+ /** The registry id of a provider document's adapter, which grants and stand-ins must match. */
27
+ const documentAdapterId = (provider, id) => `${String(provider)}:${String(id)}`;
28
+ /** A lent `native` adapter under the document's name, so a source reads as its tenant named it. */
29
+ const withDocumentLabel = (adapter, doc) => doc.name ? {
30
+ ...adapter,
31
+ label: doc.name
32
+ } : adapter;
33
+ /** Per-document ids keep two projects of one provider type apart in a registry. */
16
34
  const withInstanceIdentity = (adapter, doc) => {
17
35
  if (doc.id === void 0 || doc.id === null || doc.id === "") return adapter;
18
36
  return {
19
37
  ...adapter,
20
- id: `${doc.provider}:${doc.id}`,
38
+ id: documentAdapterId(doc.provider, doc.id),
21
39
  label: doc.name || `${adapter.label} ${shortId(doc.id)}`
22
40
  };
23
41
  };
24
- const buildBaseAdapter = (doc) => {
42
+ /**
43
+ * Keeps `shape`'s identity and capabilities so the source still lists, but every read throws
44
+ * `error()` and it declares no capture, so its proxy mount answers 404.
45
+ */
46
+ const failingAdapter = (shape, error) => {
47
+ const fail = async () => {
48
+ throw error();
49
+ };
50
+ return {
51
+ id: shape.id,
52
+ label: shape.label,
53
+ capabilities: shape.capabilities,
54
+ isConfigured: () => true,
55
+ query: fail,
56
+ ...shape.realtime ? { realtime: fail } : {}
57
+ };
58
+ };
59
+ /**
60
+ * Builds a hosted vendor's adapter on the address its host check allowed, none being the vendor's
61
+ * cloud; a refused host builds one whose reads fail with a `HostRefusedError`.
62
+ */
63
+ const onDocumentHost = (verdict, build) => {
64
+ if (verdict.ok) return build(verdict.address ?? void 0);
65
+ const { host, reason } = verdict;
66
+ return failingAdapter(build(void 0), () => new HostRefusedError(host, reason));
67
+ };
68
+ const buildBaseAdapter = (doc, ctx) => {
25
69
  switch (doc.provider) {
70
+ case "native": return ctx.native ?? null;
26
71
  case "plausible": {
27
72
  const cfg = doc.plausible ?? {};
28
- return plausible({
73
+ return onDocumentHost(checkDocumentHost("plausible", cfg.host, ctx.hosts), (host) => plausible({
29
74
  siteId: cfg.siteId ?? "",
30
75
  apiKey: cfg.apiKey ?? "",
31
- host: orUndefined(cfg.host),
76
+ host,
32
77
  domain: orUndefined(cfg.domain),
33
78
  scriptId: orUndefined(cfg.scriptId),
34
- revenueCurrency: orUndefined(cfg.revenueCurrency)
35
- });
79
+ revenueCurrency: orUndefined(cfg.revenueCurrency),
80
+ fetch: ctx.fetch
81
+ }));
36
82
  }
37
83
  case "umami": {
38
84
  const cfg = doc.umami ?? {};
39
- return umami({
85
+ return onDocumentHost(checkDocumentHost("umami", cfg.host, ctx.hosts), (host) => umami({
40
86
  websiteId: cfg.websiteId ?? "",
41
87
  apiKey: orUndefined(cfg.apiKey),
42
88
  token: orUndefined(cfg.token),
43
- host: orUndefined(cfg.host)
44
- });
89
+ host,
90
+ fetch: ctx.fetch
91
+ }));
45
92
  }
46
93
  case "ga4": {
47
94
  const cfg = doc.ga4 ?? {};
@@ -52,33 +99,39 @@ const buildBaseAdapter = (doc) => {
52
99
  private_key: normalizePrivateKey(cfg.privateKey ?? "")
53
100
  },
54
101
  projectId: orUndefined(cfg.projectId),
55
- measurementId: orUndefined(cfg.measurementId)
102
+ measurementId: orUndefined(cfg.measurementId),
103
+ currency: orUndefined(cfg.currency),
104
+ ...ctx.sdks?.ga4 ? { sdk: ctx.sdks.ga4 } : {}
56
105
  });
57
106
  }
58
107
  case "posthog": {
59
108
  const cfg = doc.posthog ?? {};
60
- return posthog({
109
+ return onDocumentHost(checkDocumentHost("posthog", cfg.host, ctx.hosts), (host) => posthog({
61
110
  projectId: cfg.projectId ?? "",
62
111
  apiKey: cfg.apiKey ?? "",
63
- host: orUndefined(cfg.host),
112
+ host,
64
113
  projectToken: orUndefined(cfg.projectToken),
65
- region: posthogRegion(cfg.region)
66
- });
114
+ region: posthogRegion(cfg.region),
115
+ scopeProperty: orUndefined(cfg.scopeProperty?.trim()),
116
+ fetch: ctx.fetch
117
+ }));
67
118
  }
68
119
  default: return null;
69
120
  }
70
121
  };
122
+ /** Checked at runtime: a JavaScript caller can leave the guards out, which would go out unguarded. */
123
+ const isGuarded = (ctx) => isRecord(ctx) && typeof ctx.fetch === "function" && isRecord(ctx.hosts) && Array.isArray(ctx.hosts.allow);
71
124
  /**
72
- * Build an adapter instance from a provider-settings document using the same
73
- * constructors as config-time adapters. Missing credentials are passed through as
74
- * empty strings so the adapter reports `isConfigured() === false` instead of the
75
- * factory throwing; an unknown provider value returns null and is skipped.
125
+ * Builds a provider document's adapter: missing credentials read as `isConfigured() === false`, an
126
+ * unknown provider as null, and a `native` document lends the config adapter under its label.
76
127
  */
77
- const adapterFromProviderDoc = (doc) => {
78
- const base = buildBaseAdapter(doc);
79
- return base ? withInstanceIdentity(base, doc) : null;
128
+ const adapterFromProviderDoc = (doc, ctx) => {
129
+ if (!isGuarded(ctx)) throw new Error("analytics: adapterFromProviderDoc needs { fetch, hosts }: pass the ones providers.resolve receives");
130
+ const base = buildBaseAdapter(doc, ctx);
131
+ if (!base) return null;
132
+ return doc.provider === "native" ? withDocumentLabel(base, doc) : withInstanceIdentity(base, doc);
80
133
  };
81
134
  //#endregion
82
- export { adapterFromProviderDoc };
135
+ export { PROVIDER_IDS, adapterFromProviderDoc, documentAdapterId, failingAdapter };
83
136
 
84
137
  //# sourceMappingURL=factory.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"factory.js","names":[],"sources":["../../src/providers/factory.ts"],"sourcesContent":["import { ga4 } from '../adapters/ga4/ga4'\nimport { plausible } from '../adapters/plausible/plausible'\nimport { posthog } from '../adapters/posthog/posthog'\nimport { umami } from '../adapters/umami/umami'\nimport type { AnalyticsAdapter } from '../core/contract'\n\nexport const PROVIDER_IDS = ['plausible', 'umami', 'ga4', 'posthog'] as const\nexport type ProviderId = (typeof PROVIDER_IDS)[number]\n\n/** The provider-settings document shape the adapter factory reads (depth 0, secrets revealed). */\nexport type ProviderDoc = {\n\tid?: number | string\n\tname?: string | null\n\tprovider?: string | null\n\tenabled?: boolean | null\n\tscope?: string | null\n\tplausible?: {\n\t\tsiteId?: string | null\n\t\tapiKey?: string | null\n\t\thost?: string | null\n\t\tdomain?: string | null\n\t\tscriptId?: string | null\n\t\trevenueCurrency?: string | null\n\t} | null\n\tumami?: {\n\t\twebsiteId?: string | null\n\t\tapiKey?: string | null\n\t\ttoken?: string | null\n\t\thost?: string | null\n\t} | null\n\tga4?: {\n\t\tpropertyId?: string | null\n\t\tclientEmail?: string | null\n\t\tprivateKey?: string | null\n\t\tprojectId?: string | null\n\t\tmeasurementId?: string | null\n\t} | null\n\tposthog?: {\n\t\tprojectId?: string | null\n\t\tapiKey?: string | null\n\t\thost?: string | null\n\t\tprojectToken?: string | null\n\t\tregion?: string | null\n\t} | null\n}\n\nconst orUndefined = (value: string | null | undefined): string | undefined => value || undefined\n\n/** An unset or unrecognized stored region falls back to host-derived detection. */\nconst posthogRegion = (value: string | null | undefined): 'us' | 'eu' | undefined =>\n\tvalue === 'us' || value === 'eu' ? value : undefined\n\n/**\n * Keys pasted from a service-account JSON often carry escaped newlines; the gRPC\n * client needs real ones.\n */\nexport const normalizePrivateKey = (key: string): string => key.replace(/\\\\n/g, '\\n')\n\nconst shortId = (id: number | string): string => String(id).slice(-6)\n\n/** Runtime adapters carry a per-document instance id so two projects of one provider type never collide in a registry; config adapters keep their plain ids. */\nconst withInstanceIdentity = (adapter: AnalyticsAdapter, doc: ProviderDoc): AnalyticsAdapter => {\n\tif (doc.id === undefined || doc.id === null || doc.id === '') {\n\t\treturn adapter\n\t}\n\treturn {\n\t\t...adapter,\n\t\tid: `${doc.provider}:${doc.id}`,\n\t\tlabel: doc.name || `${adapter.label} ${shortId(doc.id)}`,\n\t}\n}\n\nconst buildBaseAdapter = (doc: ProviderDoc): AnalyticsAdapter | null => {\n\tswitch (doc.provider) {\n\t\tcase 'plausible': {\n\t\t\tconst cfg = doc.plausible ?? {}\n\t\t\treturn plausible({\n\t\t\t\tsiteId: cfg.siteId ?? '',\n\t\t\t\tapiKey: cfg.apiKey ?? '',\n\t\t\t\thost: orUndefined(cfg.host),\n\t\t\t\tdomain: orUndefined(cfg.domain),\n\t\t\t\tscriptId: orUndefined(cfg.scriptId),\n\t\t\t\trevenueCurrency: orUndefined(cfg.revenueCurrency),\n\t\t\t})\n\t\t}\n\t\tcase 'umami': {\n\t\t\tconst cfg = doc.umami ?? {}\n\t\t\treturn umami({\n\t\t\t\twebsiteId: cfg.websiteId ?? '',\n\t\t\t\tapiKey: orUndefined(cfg.apiKey),\n\t\t\t\ttoken: orUndefined(cfg.token),\n\t\t\t\thost: orUndefined(cfg.host),\n\t\t\t})\n\t\t}\n\t\tcase 'ga4': {\n\t\t\tconst cfg = doc.ga4 ?? {}\n\t\t\treturn ga4({\n\t\t\t\tpropertyId: cfg.propertyId ?? '',\n\t\t\t\tcredentials: {\n\t\t\t\t\tclient_email: cfg.clientEmail ?? '',\n\t\t\t\t\tprivate_key: normalizePrivateKey(cfg.privateKey ?? ''),\n\t\t\t\t},\n\t\t\t\tprojectId: orUndefined(cfg.projectId),\n\t\t\t\tmeasurementId: orUndefined(cfg.measurementId),\n\t\t\t})\n\t\t}\n\t\tcase 'posthog': {\n\t\t\tconst cfg = doc.posthog ?? {}\n\t\t\treturn posthog({\n\t\t\t\tprojectId: cfg.projectId ?? '',\n\t\t\t\tapiKey: cfg.apiKey ?? '',\n\t\t\t\thost: orUndefined(cfg.host),\n\t\t\t\tprojectToken: orUndefined(cfg.projectToken),\n\t\t\t\tregion: posthogRegion(cfg.region),\n\t\t\t})\n\t\t}\n\t\tdefault:\n\t\t\treturn null\n\t}\n}\n\n/**\n * Build an adapter instance from a provider-settings document using the same\n * constructors as config-time adapters. Missing credentials are passed through as\n * empty strings so the adapter reports `isConfigured() === false` instead of the\n * factory throwing; an unknown provider value returns null and is skipped.\n */\nexport const adapterFromProviderDoc = (doc: ProviderDoc): AnalyticsAdapter | null => {\n\tconst base = buildBaseAdapter(doc)\n\treturn base ? withInstanceIdentity(base, doc) : null\n}\n"],"mappings":";;;;;AA8CA,MAAM,eAAe,UAAyD,SAAS,KAAA;;AAGvF,MAAM,iBAAiB,UACtB,UAAU,QAAQ,UAAU,OAAO,QAAQ,KAAA;;;;;AAM5C,MAAa,uBAAuB,QAAwB,IAAI,QAAQ,QAAQ,IAAI;AAEpF,MAAM,WAAW,OAAgC,OAAO,EAAE,EAAE,MAAM,EAAE;;AAGpE,MAAM,wBAAwB,SAA2B,QAAuC;CAC/F,IAAI,IAAI,OAAO,KAAA,KAAa,IAAI,OAAO,QAAQ,IAAI,OAAO,IACzD,OAAO;CAER,OAAO;EACN,GAAG;EACH,IAAI,GAAG,IAAI,SAAS,GAAG,IAAI;EAC3B,OAAO,IAAI,QAAQ,GAAG,QAAQ,MAAM,GAAG,QAAQ,IAAI,EAAE;CACtD;AACD;AAEA,MAAM,oBAAoB,QAA8C;CACvE,QAAQ,IAAI,UAAZ;EACC,KAAK,aAAa;GACjB,MAAM,MAAM,IAAI,aAAa,CAAC;GAC9B,OAAO,UAAU;IAChB,QAAQ,IAAI,UAAU;IACtB,QAAQ,IAAI,UAAU;IACtB,MAAM,YAAY,IAAI,IAAI;IAC1B,QAAQ,YAAY,IAAI,MAAM;IAC9B,UAAU,YAAY,IAAI,QAAQ;IAClC,iBAAiB,YAAY,IAAI,eAAe;GACjD,CAAC;EACF;EACA,KAAK,SAAS;GACb,MAAM,MAAM,IAAI,SAAS,CAAC;GAC1B,OAAO,MAAM;IACZ,WAAW,IAAI,aAAa;IAC5B,QAAQ,YAAY,IAAI,MAAM;IAC9B,OAAO,YAAY,IAAI,KAAK;IAC5B,MAAM,YAAY,IAAI,IAAI;GAC3B,CAAC;EACF;EACA,KAAK,OAAO;GACX,MAAM,MAAM,IAAI,OAAO,CAAC;GACxB,OAAO,IAAI;IACV,YAAY,IAAI,cAAc;IAC9B,aAAa;KACZ,cAAc,IAAI,eAAe;KACjC,aAAa,oBAAoB,IAAI,cAAc,EAAE;IACtD;IACA,WAAW,YAAY,IAAI,SAAS;IACpC,eAAe,YAAY,IAAI,aAAa;GAC7C,CAAC;EACF;EACA,KAAK,WAAW;GACf,MAAM,MAAM,IAAI,WAAW,CAAC;GAC5B,OAAO,QAAQ;IACd,WAAW,IAAI,aAAa;IAC5B,QAAQ,IAAI,UAAU;IACtB,MAAM,YAAY,IAAI,IAAI;IAC1B,cAAc,YAAY,IAAI,YAAY;IAC1C,QAAQ,cAAc,IAAI,MAAM;GACjC,CAAC;EACF;EACA,SACC,OAAO;CACT;AACD;;;;;;;AAQA,MAAa,0BAA0B,QAA8C;CACpF,MAAM,OAAO,iBAAiB,GAAG;CACjC,OAAO,OAAO,qBAAqB,MAAM,GAAG,IAAI;AACjD"}
1
+ {"version":3,"file":"factory.js","names":[],"sources":["../../src/providers/factory.ts"],"sourcesContent":["import { ga4 } from '../adapters/ga4/ga4'\nimport { plausible } from '../adapters/plausible/plausible'\nimport { posthog } from '../adapters/posthog/posthog'\nimport { umami } from '../adapters/umami/umami'\nimport type { AnalyticsAdapter, AnalyticsResult } from '../core/contract'\nimport type { FetchLike } from '../core/fetch'\nimport type { AnalyticsSdks } from '../core/sdks'\nimport { HostRefusedError } from '../core/sourceErrors'\nimport { isRecord } from '../core/values'\nimport { checkDocumentHost, type DocumentHost, type ProviderHostPolicy } from './hosts'\n\nexport const PROVIDER_IDS = ['native', 'plausible', 'umami', 'ga4', 'posthog'] as const\nexport type ProviderId = (typeof PROVIDER_IDS)[number]\n\n/** The provider-settings document shape the adapter factory reads (depth 0, secrets revealed). */\nexport type ProviderDoc = {\n\tid?: number | string\n\tname?: string | null\n\tprovider?: string | null\n\tenabled?: boolean | null\n\tscope?: string | null\n\tplausible?: {\n\t\tsiteId?: string | null\n\t\tapiKey?: string | null\n\t\thost?: string | null\n\t\tdomain?: string | null\n\t\tscriptId?: string | null\n\t\trevenueCurrency?: string | null\n\t} | null\n\tumami?: {\n\t\twebsiteId?: string | null\n\t\tapiKey?: string | null\n\t\ttoken?: string | null\n\t\thost?: string | null\n\t} | null\n\tga4?: {\n\t\tpropertyId?: string | null\n\t\tclientEmail?: string | null\n\t\tprivateKey?: string | null\n\t\tprojectId?: string | null\n\t\tmeasurementId?: string | null\n\t\tcurrency?: string | null\n\t} | null\n\tposthog?: {\n\t\tprojectId?: string | null\n\t\tapiKey?: string | null\n\t\thost?: string | null\n\t\tprojectToken?: string | null\n\t\tregion?: string | null\n\t\tscopeProperty?: string | null\n\t} | null\n}\n\n/** A stored blank reads as unset. */\nconst orUndefined = (value: string | null | undefined): string | undefined => value || undefined\n\n/** An unset or unrecognized stored region falls back to host-derived detection. */\nconst posthogRegion = (value: string | null | undefined): 'us' | 'eu' | undefined =>\n\tvalue === 'us' || value === 'eu' ? value : undefined\n\n/**\n * Keys pasted from a service-account JSON often carry escaped newlines; the gRPC\n * client needs real ones.\n */\nexport const normalizePrivateKey = (key: string): string => key.replace(/\\\\n/g, '\\n')\n\nconst shortId = (id: number | string): string => String(id).slice(-6)\n\n/** The registry id of a provider document's adapter, which grants and stand-ins must match. */\nexport const documentAdapterId = (provider: unknown, id: unknown): string =>\n\t`${String(provider)}:${String(id)}`\n\n/** A lent `native` adapter under the document's name, so a source reads as its tenant named it. */\nconst withDocumentLabel = (adapter: AnalyticsAdapter, doc: ProviderDoc): AnalyticsAdapter =>\n\tdoc.name ? { ...adapter, label: doc.name } : adapter\n\n/** Per-document ids keep two projects of one provider type apart in a registry. */\nconst withInstanceIdentity = (adapter: AnalyticsAdapter, doc: ProviderDoc): AnalyticsAdapter => {\n\tif (doc.id === undefined || doc.id === null || doc.id === '') {\n\t\treturn adapter\n\t}\n\treturn {\n\t\t...adapter,\n\t\tid: documentAdapterId(doc.provider, doc.id),\n\t\tlabel: doc.name || `${adapter.label} ${shortId(doc.id)}`,\n\t}\n}\n\n/**\n * Keeps `shape`'s identity and capabilities so the source still lists, but every read throws\n * `error()` and it declares no capture, so its proxy mount answers 404.\n */\nexport const failingAdapter = (\n\tshape: Pick<AnalyticsAdapter, 'id' | 'label' | 'capabilities' | 'realtime'>,\n\terror: () => Error\n): AnalyticsAdapter => {\n\tconst fail = async (): Promise<AnalyticsResult> => {\n\t\tthrow error()\n\t}\n\treturn {\n\t\tid: shape.id,\n\t\tlabel: shape.label,\n\t\tcapabilities: shape.capabilities,\n\t\tisConfigured: () => true,\n\t\tquery: fail,\n\t\t...(shape.realtime ? { realtime: fail } : {}),\n\t}\n}\n\n/**\n * Builds a hosted vendor's adapter on the address its host check allowed, none being the vendor's\n * cloud; a refused host builds one whose reads fail with a `HostRefusedError`.\n */\nconst onDocumentHost = (\n\tverdict: DocumentHost,\n\tbuild: (host: string | undefined) => AnalyticsAdapter\n): AnalyticsAdapter => {\n\tif (verdict.ok) {\n\t\treturn build(verdict.address ?? undefined)\n\t}\n\tconst { host, reason } = verdict\n\treturn failingAdapter(build(undefined), () => new HostRefusedError(host, reason))\n}\n\nconst buildBaseAdapter = (\n\tdoc: ProviderDoc,\n\tctx: ProviderFactoryContext\n): AnalyticsAdapter | null => {\n\tswitch (doc.provider) {\n\t\tcase 'native':\n\t\t\treturn ctx.native ?? null\n\t\tcase 'plausible': {\n\t\t\tconst cfg = doc.plausible ?? {}\n\t\t\treturn onDocumentHost(checkDocumentHost('plausible', cfg.host, ctx.hosts), (host) =>\n\t\t\t\tplausible({\n\t\t\t\t\tsiteId: cfg.siteId ?? '',\n\t\t\t\t\tapiKey: cfg.apiKey ?? '',\n\t\t\t\t\thost,\n\t\t\t\t\tdomain: orUndefined(cfg.domain),\n\t\t\t\t\tscriptId: orUndefined(cfg.scriptId),\n\t\t\t\t\trevenueCurrency: orUndefined(cfg.revenueCurrency),\n\t\t\t\t\tfetch: ctx.fetch,\n\t\t\t\t})\n\t\t\t)\n\t\t}\n\t\tcase 'umami': {\n\t\t\tconst cfg = doc.umami ?? {}\n\t\t\treturn onDocumentHost(checkDocumentHost('umami', cfg.host, ctx.hosts), (host) =>\n\t\t\t\tumami({\n\t\t\t\t\twebsiteId: cfg.websiteId ?? '',\n\t\t\t\t\tapiKey: orUndefined(cfg.apiKey),\n\t\t\t\t\ttoken: orUndefined(cfg.token),\n\t\t\t\t\thost,\n\t\t\t\t\tfetch: ctx.fetch,\n\t\t\t\t})\n\t\t\t)\n\t\t}\n\t\tcase 'ga4': {\n\t\t\tconst cfg = doc.ga4 ?? {}\n\t\t\treturn ga4({\n\t\t\t\tpropertyId: cfg.propertyId ?? '',\n\t\t\t\tcredentials: {\n\t\t\t\t\tclient_email: cfg.clientEmail ?? '',\n\t\t\t\t\tprivate_key: normalizePrivateKey(cfg.privateKey ?? ''),\n\t\t\t\t},\n\t\t\t\tprojectId: orUndefined(cfg.projectId),\n\t\t\t\tmeasurementId: orUndefined(cfg.measurementId),\n\t\t\t\tcurrency: orUndefined(cfg.currency),\n\t\t\t\t...(ctx.sdks?.ga4 ? { sdk: ctx.sdks.ga4 } : {}),\n\t\t\t})\n\t\t}\n\t\tcase 'posthog': {\n\t\t\tconst cfg = doc.posthog ?? {}\n\t\t\treturn onDocumentHost(checkDocumentHost('posthog', cfg.host, ctx.hosts), (host) =>\n\t\t\t\tposthog({\n\t\t\t\t\tprojectId: cfg.projectId ?? '',\n\t\t\t\t\tapiKey: cfg.apiKey ?? '',\n\t\t\t\t\thost,\n\t\t\t\t\tprojectToken: orUndefined(cfg.projectToken),\n\t\t\t\t\tregion: posthogRegion(cfg.region),\n\t\t\t\t\tscopeProperty: orUndefined(cfg.scopeProperty?.trim()),\n\t\t\t\t\tfetch: ctx.fetch,\n\t\t\t\t})\n\t\t\t)\n\t\t}\n\t\tdefault:\n\t\t\treturn null\n\t}\n}\n\n/**\n * What the factory needs to build a document's adapter: `fetch` and `hosts` keep a stored key on a\n * host the install allows.\n *\n * @beta\n */\nexport interface ProviderFactoryContext {\n\t/** The guarded fetch `providers.resolve` receives, or one from `createGuardedFetch`. */\n\tfetch: FetchLike\n\t/**\n\t * The policy `providers.resolve` receives, or one from `resolveHostPolicy`: a host outside it\n\t * builds an adapter that reads as `source_misconfigured` and captures nothing.\n\t */\n\thosts: ProviderHostPolicy\n\t/**\n\t * The install's config native adapter, which a `native` document grants rather than building a\n\t * second one.\n\t */\n\tnative?: AnalyticsAdapter\n\t/** The plugin's `sdks`: a GA4 document's adapter reads through `sdks.ga4`. */\n\tsdks?: AnalyticsSdks\n}\n\n/** Checked at runtime: a JavaScript caller can leave the guards out, which would go out unguarded. */\nconst isGuarded = (ctx: unknown): ctx is ProviderFactoryContext =>\n\tisRecord(ctx) &&\n\ttypeof ctx.fetch === 'function' &&\n\tisRecord(ctx.hosts) &&\n\tArray.isArray(ctx.hosts.allow)\n\n/**\n * Builds a provider document's adapter: missing credentials read as `isConfigured() === false`, an\n * unknown provider as null, and a `native` document lends the config adapter under its label.\n */\nexport const adapterFromProviderDoc = (\n\tdoc: ProviderDoc,\n\tctx: ProviderFactoryContext\n): AnalyticsAdapter | null => {\n\tif (!isGuarded(ctx)) {\n\t\tthrow new Error(\n\t\t\t'analytics: adapterFromProviderDoc needs { fetch, hosts }: pass the ones providers.resolve receives'\n\t\t)\n\t}\n\tconst base = buildBaseAdapter(doc, ctx)\n\tif (!base) {\n\t\treturn null\n\t}\n\treturn doc.provider === 'native' ? withDocumentLabel(base, doc) : withInstanceIdentity(base, doc)\n}\n"],"mappings":"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"}
@@ -0,0 +1,25 @@
1
+ //#region src/providers/hosts.d.ts
2
+ /** One `providers.hosts.allow` entry, parsed. */
3
+ type HostPattern = {
4
+ kind: 'exact';
5
+ origin: string;
6
+ } | {
7
+ kind: 'subdomains';
8
+ protocol: string;
9
+ port: string;
10
+ suffix: string;
11
+ };
12
+ /** `providers.hosts`, resolved. */
13
+ interface ProviderHostPolicy {
14
+ allow: readonly HostPattern[];
15
+ allowPrivateNetwork: boolean;
16
+ }
17
+ /**
18
+ * `providers.hosts` checked at boot.
19
+ *
20
+ * @beta
21
+ */
22
+ declare const resolveHostPolicy: (option: unknown) => ProviderHostPolicy;
23
+ //#endregion
24
+ export { HostPattern, ProviderHostPolicy, resolveHostPolicy };
25
+ //# sourceMappingURL=hosts.d.ts.map
@@ -0,0 +1,128 @@
1
+ import { isRecord, onlyKeys } from "../core/values.js";
2
+ import { keys } from "../translations/keys.js";
3
+ import { parseHttpUrl, parseOrigin } from "../net/origin.js";
4
+ import { asTranslate } from "../translations/server.js";
5
+ //#region src/providers/hosts.ts
6
+ /**
7
+ * Each vendor's own cloud, always allowed: its default origin, Umami Cloud's app address, and
8
+ * PostHog's other region and legacy US address.
9
+ */
10
+ const CLOUD_ORIGINS = {
11
+ plausible: ["https://plausible.io"],
12
+ umami: ["https://api.umami.is", "https://cloud.umami.is"],
13
+ posthog: [
14
+ "https://us.posthog.com",
15
+ "https://eu.posthog.com",
16
+ "https://app.posthog.com"
17
+ ]
18
+ };
19
+ const DEFAULT_HOST_POLICY = {
20
+ allow: [],
21
+ allowPrivateNetwork: false
22
+ };
23
+ /**
24
+ * The address `value` names: an origin and an optional base path, with no credentials, query or
25
+ * fragment and its trailing slash dropped. `http` only when the install allows private networks.
26
+ */
27
+ const parseHostAddress = (value, allowPrivateNetwork) => {
28
+ const url = parseHttpUrl(value, allowPrivateNetwork);
29
+ if (!(url instanceof URL)) return url;
30
+ return {
31
+ origin: url.origin,
32
+ address: `${url.origin}${url.pathname.replace(/\/+$/, "")}`
33
+ };
34
+ };
35
+ const WILDCARD = "*.";
36
+ /**
37
+ * One allow entry: `https://analytics.example.com`, or `https://*.example.com` for every
38
+ * subdomain of example.com (not example.com itself). Throws a boot error naming the entry.
39
+ */
40
+ const parseHostPattern = (entry, allowPrivateNetwork) => {
41
+ const fail = (reason) => {
42
+ throw new Error(`analytics: providers.hosts.allow entry ${JSON.stringify(entry)} ${reason}`);
43
+ };
44
+ if (typeof entry !== "string" || entry.trim() === "") return fail("must be an origin such as \"https://analytics.example.com\"");
45
+ const trimmed = entry.trim();
46
+ const scheme = trimmed.indexOf("://");
47
+ const wildcard = scheme !== -1 && trimmed.startsWith(WILDCARD, scheme + 3);
48
+ const candidate = wildcard ? `${trimmed.slice(0, scheme + 3)}${trimmed.slice(scheme + 3 + 2)}` : trimmed;
49
+ if (candidate.includes("*")) return fail("may only start its host with \"*.\", as in \"https://*.example.com\"");
50
+ const parsed = parseOrigin(candidate, allowPrivateNetwork);
51
+ if ("problem" in parsed) return fail(parsed.problem === "insecure" ? "uses http, which needs providers.hosts.allowPrivateNetwork" : "must be an origin with no path, query or credentials, such as \"https://analytics.example.com\"");
52
+ if (!wildcard) return {
53
+ kind: "exact",
54
+ origin: parsed.origin
55
+ };
56
+ const url = new URL(parsed.origin);
57
+ if (!url.hostname.includes(".")) return fail("would match every site under one top-level domain; name a domain, as in \"https://*.example.com\"");
58
+ return {
59
+ kind: "subdomains",
60
+ protocol: url.protocol,
61
+ port: url.port,
62
+ suffix: url.hostname
63
+ };
64
+ };
65
+ /**
66
+ * `providers.hosts` checked at boot.
67
+ *
68
+ * @beta
69
+ */
70
+ const resolveHostPolicy = (option) => {
71
+ if (option === void 0) return DEFAULT_HOST_POLICY;
72
+ if (!isRecord(option) || Array.isArray(option)) throw new Error("analytics: providers.hosts must be an object such as { allow: [\"https://analytics.example.com\"] }");
73
+ onlyKeys(option, ["allow", "allowPrivateNetwork"], "providers.hosts");
74
+ const allowPrivateNetwork = option.allowPrivateNetwork ?? false;
75
+ if (typeof allowPrivateNetwork !== "boolean") throw new Error("analytics: providers.hosts.allowPrivateNetwork must be a boolean");
76
+ const allow = option.allow ?? [];
77
+ if (!Array.isArray(allow)) throw new Error("analytics: providers.hosts.allow must be a list of origins");
78
+ return {
79
+ allow: allow.map((entry) => parseHostPattern(entry, allowPrivateNetwork)),
80
+ allowPrivateNetwork
81
+ };
82
+ };
83
+ const matches = (pattern, url) => pattern.kind === "exact" ? url.origin === pattern.origin : url.protocol === pattern.protocol && url.port === pattern.port && url.hostname.endsWith(`.${pattern.suffix}`);
84
+ /**
85
+ * A document's `host` under the install's policy: blank is the vendor's cloud, anything else needs
86
+ * an origin that is that cloud or in `allow`. The allowlist is about which server, not which path.
87
+ */
88
+ const checkDocumentHost = (provider, raw, policy) => {
89
+ const value = raw?.trim() ?? "";
90
+ if (value === "") return {
91
+ ok: true,
92
+ address: null
93
+ };
94
+ const parsed = parseHostAddress(value, policy.allowPrivateNetwork);
95
+ if ("problem" in parsed) return {
96
+ ok: false,
97
+ host: value,
98
+ reason: parsed.problem === "insecure" ? "it uses http, which needs providers.hosts.allowPrivateNetwork" : "it is not an address this install accepts"
99
+ };
100
+ if (CLOUD_ORIGINS[provider].includes(parsed.origin)) return {
101
+ ok: true,
102
+ address: parsed.address
103
+ };
104
+ const url = new URL(parsed.origin);
105
+ if (policy.allow.some((pattern) => matches(pattern, url))) return {
106
+ ok: true,
107
+ address: parsed.address
108
+ };
109
+ return {
110
+ ok: false,
111
+ host: parsed.origin,
112
+ reason: "it is not listed in providers.hosts.allow"
113
+ };
114
+ };
115
+ /**
116
+ * The `validate` of every provider `host` field: blank, or the address of the service with an
117
+ * optional base path and nothing else, over https unless the install allows private networks.
118
+ */
119
+ const validateProviderHost = (allowPrivateNetwork) => (value, { req }) => {
120
+ if (!value || value.trim() === "") return true;
121
+ const parsed = parseHostAddress(value, allowPrivateNetwork);
122
+ if (!("problem" in parsed)) return true;
123
+ return asTranslate(req.t)(parsed.problem === "insecure" ? keys.providerErrorHostInsecure : keys.providerErrorHostFormat);
124
+ };
125
+ //#endregion
126
+ export { checkDocumentHost, resolveHostPolicy, validateProviderHost };
127
+
128
+ //# sourceMappingURL=hosts.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"hosts.js","names":[],"sources":["../../src/providers/hosts.ts"],"sourcesContent":["import type { TextFieldSingleValidation } from 'payload'\nimport { isRecord, onlyKeys } from '../core/values'\nimport { type OriginProblem, parseHttpUrl, parseOrigin } from '../net/origin'\nimport { keys } from '../translations/keys'\nimport { asTranslate } from '../translations/server'\n\n/** The providers whose document names a host. GA4 always talks to Google. */\nexport type HostedProvider = 'plausible' | 'umami' | 'posthog'\n\n/**\n * Each vendor's own cloud, always allowed: its default origin, Umami Cloud's app address, and\n * PostHog's other region and legacy US address.\n */\nexport const CLOUD_ORIGINS: Readonly<Record<HostedProvider, readonly string[]>> = {\n\tplausible: ['https://plausible.io'],\n\tumami: ['https://api.umami.is', 'https://cloud.umami.is'],\n\tposthog: ['https://us.posthog.com', 'https://eu.posthog.com', 'https://app.posthog.com'],\n}\n\n/** One `providers.hosts.allow` entry, parsed. */\nexport type HostPattern =\n\t| { kind: 'exact'; origin: string }\n\t| { kind: 'subdomains'; protocol: string; port: string; suffix: string }\n\n/** `providers.hosts`, resolved. */\nexport interface ProviderHostPolicy {\n\tallow: readonly HostPattern[]\n\tallowPrivateNetwork: boolean\n}\n\nexport const DEFAULT_HOST_POLICY: ProviderHostPolicy = { allow: [], allowPrivateNetwork: false }\n\n/** A vendor's address, as a document's `host` names it. */\ninterface HostAddress {\n\t/** Scheme, host and port: what the allowlist matches. */\n\torigin: string\n\t/** The origin and the base path a vendor served under a sub-path needs, with no trailing slash. */\n\taddress: string\n}\n\n/**\n * The address `value` names: an origin and an optional base path, with no credentials, query or\n * fragment and its trailing slash dropped. `http` only when the install allows private networks.\n */\nexport const parseHostAddress = (\n\tvalue: string,\n\tallowPrivateNetwork: boolean\n): HostAddress | { problem: OriginProblem } => {\n\tconst url = parseHttpUrl(value, allowPrivateNetwork)\n\tif (!(url instanceof URL)) {\n\t\treturn url\n\t}\n\treturn { origin: url.origin, address: `${url.origin}${url.pathname.replace(/\\/+$/, '')}` }\n}\n\nconst WILDCARD = '*.'\n\n/**\n * One allow entry: `https://analytics.example.com`, or `https://*.example.com` for every\n * subdomain of example.com (not example.com itself). Throws a boot error naming the entry.\n */\nexport const parseHostPattern = (entry: unknown, allowPrivateNetwork: boolean): HostPattern => {\n\tconst fail = (reason: string): never => {\n\t\tthrow new Error(`analytics: providers.hosts.allow entry ${JSON.stringify(entry)} ${reason}`)\n\t}\n\tif (typeof entry !== 'string' || entry.trim() === '') {\n\t\treturn fail('must be an origin such as \"https://analytics.example.com\"')\n\t}\n\tconst trimmed = entry.trim()\n\tconst scheme = trimmed.indexOf('://')\n\tconst wildcard = scheme !== -1 && trimmed.startsWith(WILDCARD, scheme + 3)\n\tconst candidate = wildcard\n\t\t? `${trimmed.slice(0, scheme + 3)}${trimmed.slice(scheme + 3 + WILDCARD.length)}`\n\t\t: trimmed\n\tif (candidate.includes('*')) {\n\t\treturn fail('may only start its host with \"*.\", as in \"https://*.example.com\"')\n\t}\n\tconst parsed = parseOrigin(candidate, allowPrivateNetwork)\n\tif ('problem' in parsed) {\n\t\treturn fail(\n\t\t\tparsed.problem === 'insecure'\n\t\t\t\t? 'uses http, which needs providers.hosts.allowPrivateNetwork'\n\t\t\t\t: 'must be an origin with no path, query or credentials, such as \"https://analytics.example.com\"'\n\t\t)\n\t}\n\tif (!wildcard) {\n\t\treturn { kind: 'exact', origin: parsed.origin }\n\t}\n\tconst url = new URL(parsed.origin)\n\tif (!url.hostname.includes('.')) {\n\t\treturn fail(\n\t\t\t'would match every site under one top-level domain; name a domain, as in \"https://*.example.com\"'\n\t\t)\n\t}\n\treturn { kind: 'subdomains', protocol: url.protocol, port: url.port, suffix: url.hostname }\n}\n\n/**\n * `providers.hosts` checked at boot.\n *\n * @beta\n */\nexport const resolveHostPolicy = (option: unknown): ProviderHostPolicy => {\n\tif (option === undefined) {\n\t\treturn DEFAULT_HOST_POLICY\n\t}\n\tif (!isRecord(option) || Array.isArray(option)) {\n\t\tthrow new Error(\n\t\t\t'analytics: providers.hosts must be an object such as { allow: [\"https://analytics.example.com\"] }'\n\t\t)\n\t}\n\tonlyKeys(option, ['allow', 'allowPrivateNetwork'], 'providers.hosts')\n\tconst allowPrivateNetwork = option.allowPrivateNetwork ?? false\n\tif (typeof allowPrivateNetwork !== 'boolean') {\n\t\tthrow new Error('analytics: providers.hosts.allowPrivateNetwork must be a boolean')\n\t}\n\tconst allow = option.allow ?? []\n\tif (!Array.isArray(allow)) {\n\t\tthrow new Error('analytics: providers.hosts.allow must be a list of origins')\n\t}\n\treturn {\n\t\tallow: allow.map((entry: unknown) => parseHostPattern(entry, allowPrivateNetwork)),\n\t\tallowPrivateNetwork,\n\t}\n}\n\nconst matches = (pattern: HostPattern, url: URL): boolean =>\n\tpattern.kind === 'exact'\n\t\t? url.origin === pattern.origin\n\t\t: url.protocol === pattern.protocol &&\n\t\t\turl.port === pattern.port &&\n\t\t\turl.hostname.endsWith(`.${pattern.suffix}`)\n\n/** Whether a document's host may be reached, and the address it names; null for the vendor's cloud. */\nexport type DocumentHost =\n\t| { ok: true; address: string | null }\n\t| { ok: false; host: string; reason: string }\n\n/**\n * A document's `host` under the install's policy: blank is the vendor's cloud, anything else needs\n * an origin that is that cloud or in `allow`. The allowlist is about which server, not which path.\n */\nexport const checkDocumentHost = (\n\tprovider: HostedProvider,\n\traw: string | null | undefined,\n\tpolicy: ProviderHostPolicy\n): DocumentHost => {\n\tconst value = raw?.trim() ?? ''\n\tif (value === '') {\n\t\treturn { ok: true, address: null }\n\t}\n\tconst parsed = parseHostAddress(value, policy.allowPrivateNetwork)\n\tif ('problem' in parsed) {\n\t\treturn {\n\t\t\tok: false,\n\t\t\thost: value,\n\t\t\treason:\n\t\t\t\tparsed.problem === 'insecure'\n\t\t\t\t\t? 'it uses http, which needs providers.hosts.allowPrivateNetwork'\n\t\t\t\t\t: 'it is not an address this install accepts',\n\t\t}\n\t}\n\tif (CLOUD_ORIGINS[provider].includes(parsed.origin)) {\n\t\treturn { ok: true, address: parsed.address }\n\t}\n\tconst url = new URL(parsed.origin)\n\tif (policy.allow.some((pattern) => matches(pattern, url))) {\n\t\treturn { ok: true, address: parsed.address }\n\t}\n\treturn { ok: false, host: parsed.origin, reason: 'it is not listed in providers.hosts.allow' }\n}\n\n/**\n * The `validate` of every provider `host` field: blank, or the address of the service with an\n * optional base path and nothing else, over https unless the install allows private networks.\n */\nexport const validateProviderHost =\n\t(allowPrivateNetwork: boolean): TextFieldSingleValidation =>\n\t(value, { req }) => {\n\t\tif (!value || value.trim() === '') {\n\t\t\treturn true\n\t\t}\n\t\tconst parsed = parseHostAddress(value, allowPrivateNetwork)\n\t\tif (!('problem' in parsed)) {\n\t\t\treturn true\n\t\t}\n\t\treturn asTranslate(req.t)(\n\t\t\tparsed.problem === 'insecure' ? keys.providerErrorHostInsecure : keys.providerErrorHostFormat\n\t\t)\n\t}\n"],"mappings":"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"}
@@ -0,0 +1 @@
1
+ import { Payload } from "payload";
@@ -0,0 +1,101 @@
1
+ import { canonicalJson, isRecord } from "../core/values.js";
2
+ import { currentTime } from "../core/clock.js";
3
+ import { remember } from "../surfacing/bounded.js";
4
+ import { docScope } from "../plugin/scopeChange.js";
5
+ import { isCollectionSlug } from "../core/collectionSlug.js";
6
+ import { DETACHED } from "../db/openTransaction.js";
7
+ import { createHash } from "node:crypto";
8
+ //#region src/providers/probe.ts
9
+ /** How long an instance trusts a probe before asking the database again: the bound on convergence. */
10
+ const PROBE_MEMO_MS = 1e4;
11
+ /** Far above any realistic document count for one scope. */
12
+ const MAX_ROWS = 1e3;
13
+ /** Scopes memoized before the expired ones are dropped. */
14
+ const PRUNE_AT = 1e3;
15
+ /** A stored date as an ISO instant, or empty when there is none. */
16
+ const versionOf = (value) => {
17
+ if (!(value instanceof Date) && typeof value !== "string" && typeof value !== "number") return "";
18
+ const ms = new Date(value).getTime();
19
+ return Number.isNaN(ms) ? "" : new Date(ms).toISOString();
20
+ };
21
+ const byId = (a, b) => a.id < b.id ? -1 : a.id > b.id ? 1 : 0;
22
+ /** A digest of the rows that ignores their order. */
23
+ const probeEpoch = (rows) => createHash("sha256").update(canonicalJson([...rows].sort(byId))).digest("base64url");
24
+ /** A scope as every read keys it: absent or empty is the install-wide scope, null. */
25
+ const scopeOf = (scope) => scope === void 0 || scope === "" ? null : scope;
26
+ /**
27
+ * Committed state of a collection's documents per scope, read on a detached request: an uncommitted
28
+ * row is never seen, so nothing keyed on an epoch can roll back.
29
+ */
30
+ const createCollectionProbe = (options) => {
31
+ const { payload, slug, scopeField } = options;
32
+ const memoMs = options.memoMs ?? 1e4;
33
+ const now = options.now ?? currentTime;
34
+ const select = {
35
+ updatedAt: true,
36
+ enabled: true,
37
+ [scopeField]: true,
38
+ ...options.provider ? { provider: true } : {}
39
+ };
40
+ const memo = /* @__PURE__ */ new Map();
41
+ const expedited = /* @__PURE__ */ new Map();
42
+ const rowOf = (doc) => ({
43
+ id: String(doc.id),
44
+ updatedAt: versionOf(doc.updatedAt),
45
+ enabled: doc.enabled === true,
46
+ ...options.provider ? { provider: typeof doc.provider === "string" ? doc.provider : "" } : {},
47
+ scope: docScope(doc, scopeField)
48
+ });
49
+ const query = async (scope) => {
50
+ if (!isCollectionSlug(payload, slug)) throw new Error(`analytics: no "${slug}" collection is registered`);
51
+ const { docs } = await payload.db.find({
52
+ collection: slug,
53
+ limit: MAX_ROWS,
54
+ pagination: false,
55
+ req: DETACHED,
56
+ select,
57
+ ...options.where ? { where: options.where(scope) } : {}
58
+ });
59
+ const rows = docs.filter(isRecord).map(rowOf);
60
+ return {
61
+ rows,
62
+ epoch: probeEpoch(rows)
63
+ };
64
+ };
65
+ const prune = (at) => {
66
+ for (const [key, entry] of memo) if (at - entry.at >= memoMs) memo.delete(key);
67
+ for (const [key, until] of expedited) if (until <= at) expedited.delete(key);
68
+ };
69
+ return {
70
+ read(raw) {
71
+ const scope = scopeOf(raw);
72
+ const key = scope ?? "";
73
+ const at = now();
74
+ if ((expedited.get(key) ?? 0) > at) return query(scope);
75
+ const hit = memo.get(key);
76
+ if (hit && at - hit.at < memoMs) return hit.probe;
77
+ if (memo.size >= PRUNE_AT) prune(at);
78
+ const probe = query(scope);
79
+ remember(memo, [key, {
80
+ at,
81
+ probe
82
+ }]);
83
+ probe.catch(() => {
84
+ if (memo.get(key)?.probe === probe) memo.delete(key);
85
+ });
86
+ return probe;
87
+ },
88
+ expedite(scopes) {
89
+ const until = now() + memoMs;
90
+ for (const raw of scopes) {
91
+ const key = scopeOf(raw) ?? "";
92
+ memo.delete(key);
93
+ remember(expedited, [key, until]);
94
+ }
95
+ }
96
+ };
97
+ };
98
+ //#endregion
99
+ export { PROBE_MEMO_MS, createCollectionProbe, scopeOf, versionOf };
100
+
101
+ //# sourceMappingURL=probe.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"probe.js","names":[],"sources":["../../src/providers/probe.ts"],"sourcesContent":["import { createHash } from 'node:crypto'\nimport type { Payload, SelectType, Where } from 'payload'\nimport { currentTime } from '../core/clock'\nimport { isCollectionSlug } from '../core/collectionSlug'\nimport { canonicalJson, isRecord } from '../core/values'\nimport { DETACHED } from '../db/openTransaction'\nimport { docScope } from '../plugin/scopeChange'\nimport { remember } from '../surfacing/bounded'\n\n/** How long an instance trusts a probe before asking the database again: the bound on convergence. */\nexport const PROBE_MEMO_MS = 10_000\n\n/** Far above any realistic document count for one scope. */\nconst MAX_ROWS = 1_000\n\n/** Scopes memoized before the expired ones are dropped. */\nconst PRUNE_AT = 1_000\n\n/** One document as the probe reads it: what tells a change apart, never a credential. */\nexport interface ProbeRow {\n\tid: string\n\t/** The last save as an ISO instant; empty for a document without one. */\n\tupdatedAt: string\n\tenabled: boolean\n\t/** The provider type, on rows of the providers collection only. */\n\tprovider?: string\n\tscope: string | null\n}\n\nexport interface Probe {\n\t/** In the order the database answers a lookup without a sort, which is the registry's order. */\n\trows: readonly ProbeRow[]\n\t/** Equal for equal committed states, whatever order the rows came in. */\n\tepoch: string\n}\n\n/** A stored date as an ISO instant, or empty when there is none. */\nexport const versionOf = (value: unknown): string => {\n\tif (!(value instanceof Date) && typeof value !== 'string' && typeof value !== 'number') {\n\t\treturn ''\n\t}\n\tconst ms = new Date(value).getTime()\n\treturn Number.isNaN(ms) ? '' : new Date(ms).toISOString()\n}\n\nconst byId = (a: ProbeRow, b: ProbeRow): number => (a.id < b.id ? -1 : a.id > b.id ? 1 : 0)\n\n/** A digest of the rows that ignores their order. */\nexport const probeEpoch = (rows: readonly ProbeRow[]): string =>\n\tcreateHash('sha256')\n\t\t.update(canonicalJson([...rows].sort(byId)))\n\t\t.digest('base64url')\n\n/** A scope as every read keys it: absent or empty is the install-wide scope, null. */\nexport const scopeOf = (scope: string | null | undefined): string | null =>\n\tscope === undefined || scope === '' ? null : scope\n\nexport interface CollectionProbe {\n\t/** The scope's rows and epoch as committed, read outside any transaction and memoized per instance. */\n\tread(scope: string | null | undefined): Promise<Probe>\n\t/**\n\t * A save on this instance touched these scopes: they are asked of the database on every read\n\t * for one memo window, so this instance sees the save as soon as it commits. Writes nothing.\n\t */\n\texpedite(scopes: Iterable<string | null>): void\n}\n\ninterface CollectionProbeOptions {\n\tpayload: Payload\n\tslug: string\n\tscopeField: string\n\t/** The clause selecting one scope's documents; absent, every scope reads every document. */\n\twhere?: (scope: string | null) => Where\n\t/** Whether the collection's rows carry a `provider`. */\n\tprovider?: boolean\n\tmemoMs?: number\n\tnow?: () => number\n}\n\ninterface Memoized {\n\tat: number\n\tprobe: Promise<Probe>\n}\n\n/**\n * Committed state of a collection's documents per scope, read on a detached request: an uncommitted\n * row is never seen, so nothing keyed on an epoch can roll back.\n */\nexport const createCollectionProbe = (options: CollectionProbeOptions): CollectionProbe => {\n\tconst { payload, slug, scopeField } = options\n\tconst memoMs = options.memoMs ?? PROBE_MEMO_MS\n\tconst now = options.now ?? currentTime\n\tconst select: SelectType = {\n\t\tupdatedAt: true,\n\t\tenabled: true,\n\t\t[scopeField]: true,\n\t\t...(options.provider ? { provider: true } : {}),\n\t}\n\tconst memo = new Map<string, Memoized>()\n\tconst expedited = new Map<string, number>()\n\n\tconst rowOf = (doc: Record<string, unknown>): ProbeRow => ({\n\t\tid: String(doc.id),\n\t\tupdatedAt: versionOf(doc.updatedAt),\n\t\tenabled: doc.enabled === true,\n\t\t...(options.provider ? { provider: typeof doc.provider === 'string' ? doc.provider : '' } : {}),\n\t\tscope: docScope(doc, scopeField),\n\t})\n\n\tconst query = async (scope: string | null): Promise<Probe> => {\n\t\tif (!isCollectionSlug(payload, slug)) {\n\t\t\tthrow new Error(`analytics: no \"${slug}\" collection is registered`)\n\t\t}\n\t\tconst { docs } = await payload.db.find<Record<string, unknown>>({\n\t\t\tcollection: slug,\n\t\t\tlimit: MAX_ROWS,\n\t\t\tpagination: false,\n\t\t\treq: DETACHED,\n\t\t\tselect,\n\t\t\t...(options.where ? { where: options.where(scope) } : {}),\n\t\t})\n\t\tconst rows = docs.filter(isRecord).map(rowOf)\n\t\treturn { rows, epoch: probeEpoch(rows) }\n\t}\n\n\tconst prune = (at: number): void => {\n\t\tfor (const [key, entry] of memo) {\n\t\t\tif (at - entry.at >= memoMs) {\n\t\t\t\tmemo.delete(key)\n\t\t\t}\n\t\t}\n\t\tfor (const [key, until] of expedited) {\n\t\t\tif (until <= at) {\n\t\t\t\texpedited.delete(key)\n\t\t\t}\n\t\t}\n\t}\n\n\treturn {\n\t\tread(raw) {\n\t\t\tconst scope = scopeOf(raw)\n\t\t\tconst key = scope ?? ''\n\t\t\tconst at = now()\n\t\t\tif ((expedited.get(key) ?? 0) > at) {\n\t\t\t\treturn query(scope)\n\t\t\t}\n\t\t\tconst hit = memo.get(key)\n\t\t\tif (hit && at - hit.at < memoMs) {\n\t\t\t\treturn hit.probe\n\t\t\t}\n\t\t\tif (memo.size >= PRUNE_AT) {\n\t\t\t\tprune(at)\n\t\t\t}\n\t\t\tconst probe = query(scope)\n\t\t\tremember(memo, [key, { at, probe }])\n\t\t\tprobe.catch(() => {\n\t\t\t\tif (memo.get(key)?.probe === probe) {\n\t\t\t\t\tmemo.delete(key)\n\t\t\t\t}\n\t\t\t})\n\t\t\treturn probe\n\t\t},\n\t\texpedite(scopes) {\n\t\t\tconst until = now() + memoMs\n\t\t\tfor (const raw of scopes) {\n\t\t\t\tconst key = scopeOf(raw) ?? ''\n\t\t\t\tmemo.delete(key)\n\t\t\t\tremember(expedited, [key, until])\n\t\t\t}\n\t\t},\n\t}\n}\n"],"mappings":"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"}
@@ -0,0 +1,18 @@
1
+ import { Payload, PayloadRequest } from "payload";
2
+
3
+ //#region src/providers/refresh.d.ts
4
+ interface RefreshProvidersOptions {
5
+ /**
6
+ * The changing save's request, from inside a hook: the token is written once its transaction ends
7
+ * so nobody reads old settings under it; resolves at once, logging failures.
8
+ */
9
+ req?: PayloadRequest;
10
+ }
11
+ /**
12
+ * Retires one scope's cached reads on every instance (this one at once, others within ten seconds)
13
+ * for a `providers.resolve` install. Rejects when the token could not be stored.
14
+ */
15
+ declare const refreshProviders: (payload: Payload, scope?: string | null, options?: RefreshProvidersOptions) => Promise<void>;
16
+ //#endregion
17
+ export { RefreshProvidersOptions, refreshProviders };
18
+ //# sourceMappingURL=refresh.d.ts.map
@@ -0,0 +1,49 @@
1
+ import { configEpochKeyFor, kvEpochBackend } from "../surfacing/epoch.js";
2
+ import { getRuntime } from "../plugin/runtime.js";
3
+ import { afterTransaction, openTransactionOf } from "../db/openTransaction.js";
4
+ import { nativeInstanceOf } from "../native/engine/instance.js";
5
+ //#region src/providers/refresh.ts
6
+ /**
7
+ * Where a `providers.resolve` install keeps each scope's configuration token: `analytics-state`
8
+ * while the native engine runs on the instance, `payload.kv` otherwise.
9
+ */
10
+ const configTokenBackend = (payload) => {
11
+ const kv = kvEpochBackend(payload, configEpochKeyFor);
12
+ return {
13
+ get: async (scope) => {
14
+ const state = nativeInstanceOf(payload)?.state;
15
+ if (!state) return kv.get(scope);
16
+ return await state.configToken(scope ?? "") ?? "0";
17
+ },
18
+ set: async (scope, token) => {
19
+ const state = nativeInstanceOf(payload)?.state;
20
+ if (!state) {
21
+ await kv.set(scope, token);
22
+ return;
23
+ }
24
+ await state.setConfigToken(scope ?? "", token);
25
+ }
26
+ };
27
+ };
28
+ /**
29
+ * Retires one scope's cached reads on every instance (this one at once, others within ten seconds)
30
+ * for a `providers.resolve` install. Rejects when the token could not be stored.
31
+ */
32
+ const refreshProviders = async (payload, scope = null, options = {}) => {
33
+ const runtime = getRuntime(payload);
34
+ const refresh = runtime?.refreshProviders;
35
+ if (!runtime || !refresh) return;
36
+ const open = await openTransactionOf(payload, options.req);
37
+ if (!open) {
38
+ await refresh(scope);
39
+ return;
40
+ }
41
+ const deferred = afterTransaction(open, () => refresh(scope)).catch((err) => {
42
+ payload.logger?.warn(`analytics: refreshing the providers of scope "${scope ?? ""}" after its save failed: ${String(err)}`);
43
+ });
44
+ runtime.engine.keep?.(deferred);
45
+ };
46
+ //#endregion
47
+ export { configTokenBackend, refreshProviders };
48
+
49
+ //# sourceMappingURL=refresh.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"refresh.js","names":[],"sources":["../../src/providers/refresh.ts"],"sourcesContent":["import type { Payload, PayloadRequest } from 'payload'\nimport { afterTransaction, openTransactionOf } from '../db/openTransaction'\nimport { nativeInstanceOf } from '../native/engine/instance'\nimport { getRuntime } from '../plugin/runtime'\nimport {\n\tconfigEpochKeyFor,\n\ttype EpochBackend,\n\tINITIAL_EPOCH,\n\tkvEpochBackend,\n} from '../surfacing/epoch'\n\n/**\n * Where a `providers.resolve` install keeps each scope's configuration token: `analytics-state`\n * while the native engine runs on the instance, `payload.kv` otherwise.\n */\nexport const configTokenBackend = (payload: Payload): EpochBackend => {\n\tconst kv = kvEpochBackend(payload, configEpochKeyFor)\n\treturn {\n\t\tget: async (scope) => {\n\t\t\tconst state = nativeInstanceOf(payload)?.state\n\t\t\tif (!state) {\n\t\t\t\treturn kv.get(scope)\n\t\t\t}\n\t\t\treturn (await state.configToken(scope ?? '')) ?? INITIAL_EPOCH\n\t\t},\n\t\tset: async (scope, token) => {\n\t\t\tconst state = nativeInstanceOf(payload)?.state\n\t\t\tif (!state) {\n\t\t\t\tawait kv.set(scope, token)\n\t\t\t\treturn\n\t\t\t}\n\t\t\tawait state.setConfigToken(scope ?? '', token)\n\t\t},\n\t}\n}\n\nexport interface RefreshProvidersOptions {\n\t/**\n\t * The changing save's request, from inside a hook: the token is written once its transaction ends\n\t * so nobody reads old settings under it; resolves at once, logging failures.\n\t */\n\treq?: PayloadRequest\n}\n\n/**\n * Retires one scope's cached reads on every instance (this one at once, others within ten seconds)\n * for a `providers.resolve` install. Rejects when the token could not be stored.\n */\nexport const refreshProviders = async (\n\tpayload: Payload,\n\tscope: string | null = null,\n\toptions: RefreshProvidersOptions = {}\n): Promise<void> => {\n\tconst runtime = getRuntime(payload)\n\tconst refresh = runtime?.refreshProviders\n\tif (!runtime || !refresh) {\n\t\treturn\n\t}\n\tconst open = await openTransactionOf(payload, options.req)\n\tif (!open) {\n\t\tawait refresh(scope)\n\t\treturn\n\t}\n\tconst deferred = afterTransaction(open, () => refresh(scope)).catch((err: unknown) => {\n\t\tpayload.logger?.warn(\n\t\t\t`analytics: refreshing the providers of scope \"${scope ?? ''}\" after its save failed: ${String(err)}`\n\t\t)\n\t})\n\truntime.engine.keep?.(deferred)\n}\n"],"mappings":";;;;;;;;;AAeA,MAAa,sBAAsB,YAAmC;CACrE,MAAM,KAAK,eAAe,SAAS,iBAAiB;CACpD,OAAO;EACN,KAAK,OAAO,UAAU;GACrB,MAAM,QAAQ,iBAAiB,OAAO,GAAG;GACzC,IAAI,CAAC,OACJ,OAAO,GAAG,IAAI,KAAK;GAEpB,OAAQ,MAAM,MAAM,YAAY,SAAS,EAAE,KAAA;EAC5C;EACA,KAAK,OAAO,OAAO,UAAU;GAC5B,MAAM,QAAQ,iBAAiB,OAAO,GAAG;GACzC,IAAI,CAAC,OAAO;IACX,MAAM,GAAG,IAAI,OAAO,KAAK;IACzB;GACD;GACA,MAAM,MAAM,eAAe,SAAS,IAAI,KAAK;EAC9C;CACD;AACD;;;;;AAcA,MAAa,mBAAmB,OAC/B,SACA,QAAuB,MACvB,UAAmC,CAAC,MACjB;CACnB,MAAM,UAAU,WAAW,OAAO;CAClC,MAAM,UAAU,SAAS;CACzB,IAAI,CAAC,WAAW,CAAC,SAChB;CAED,MAAM,OAAO,MAAM,kBAAkB,SAAS,QAAQ,GAAG;CACzD,IAAI,CAAC,MAAM;EACV,MAAM,QAAQ,KAAK;EACnB;CACD;CACA,MAAM,WAAW,iBAAiB,YAAY,QAAQ,KAAK,CAAC,EAAE,OAAO,QAAiB;EACrF,QAAQ,QAAQ,KACf,iDAAiD,SAAS,GAAG,2BAA2B,OAAO,GAAG,GACnG;CACD,CAAC;CACD,QAAQ,OAAO,OAAO,QAAQ;AAC/B"}