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

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 (514) hide show
  1. package/CHANGELOG.md +277 -0
  2. package/README.md +15 -4
  3. package/dist/adapters/ga4/disableKey.d.ts +9 -0
  4. package/dist/adapters/ga4/disableKey.js +21 -0
  5. package/dist/adapters/ga4/disableKey.js.map +1 -0
  6. package/dist/adapters/ga4/eventName.d.ts +15 -0
  7. package/dist/adapters/ga4/eventName.js +19 -0
  8. package/dist/adapters/ga4/eventName.js.map +1 -0
  9. package/dist/adapters/ga4/ga4.d.ts +5 -0
  10. package/dist/adapters/ga4/ga4.js +186 -58
  11. package/dist/adapters/ga4/ga4.js.map +1 -1
  12. package/dist/adapters/ga4/measurementId.js +15 -0
  13. package/dist/adapters/ga4/measurementId.js.map +1 -0
  14. package/dist/adapters/goalRead.js +126 -0
  15. package/dist/adapters/goalRead.js.map +1 -0
  16. package/dist/adapters/http/fetchJson.js +1 -1
  17. package/dist/adapters/plausible/plausible.d.ts +25 -0
  18. package/dist/adapters/plausible/plausible.js +159 -38
  19. package/dist/adapters/plausible/plausible.js.map +1 -1
  20. package/dist/adapters/posthog/posthog.d.ts +10 -1
  21. package/dist/adapters/posthog/posthog.js +130 -21
  22. package/dist/adapters/posthog/posthog.js.map +1 -1
  23. package/dist/adapters/series.js +11 -1
  24. package/dist/adapters/series.js.map +1 -1
  25. package/dist/adapters/umami/umami.d.ts +13 -1
  26. package/dist/adapters/umami/umami.js +278 -26
  27. package/dist/adapters/umami/umami.js.map +1 -1
  28. package/dist/binding/resolvePath.js +18 -2
  29. package/dist/binding/resolvePath.js.map +1 -1
  30. package/dist/capture/getTrackerConfig.d.ts +20 -0
  31. package/dist/capture/getTrackerConfig.js +31 -0
  32. package/dist/capture/getTrackerConfig.js.map +1 -0
  33. package/dist/capture/mountPath.js +14 -0
  34. package/dist/capture/mountPath.js.map +1 -0
  35. package/dist/capture/proxyEndpoint.js +127 -0
  36. package/dist/capture/proxyEndpoint.js.map +1 -0
  37. package/dist/capture/proxyRoutes.js +108 -0
  38. package/dist/capture/proxyRoutes.js.map +1 -0
  39. package/dist/capture/requestBody.js +68 -0
  40. package/dist/capture/requestBody.js.map +1 -0
  41. package/dist/capture/slots.d.ts +8 -0
  42. package/dist/capture/slots.js +54 -0
  43. package/dist/capture/slots.js.map +1 -0
  44. package/dist/capture/trackerConfig.d.ts +33 -0
  45. package/dist/capture/trackerConfig.js +95 -0
  46. package/dist/capture/trackerConfig.js.map +1 -0
  47. package/dist/capture/trackerEndpoint.js +35 -0
  48. package/dist/capture/trackerEndpoint.js.map +1 -0
  49. package/dist/charts/BarList.d.ts +16 -1
  50. package/dist/charts/BarList.js +41 -19
  51. package/dist/charts/BarList.js.map +1 -1
  52. package/dist/charts/TrendChart.d.ts +16 -3
  53. package/dist/charts/TrendChart.js +172 -106
  54. package/dist/charts/TrendChart.js.map +1 -1
  55. package/dist/charts/bars.d.ts +4 -0
  56. package/dist/charts/bars.js +3 -1
  57. package/dist/charts/bars.js.map +1 -1
  58. package/dist/charts/bucket.js +10 -1
  59. package/dist/charts/bucket.js.map +1 -1
  60. package/dist/charts/spline.js +2 -2
  61. package/dist/charts/spline.js.map +1 -1
  62. package/dist/charts/styles.js +18 -1
  63. package/dist/charts/styles.js.map +1 -1
  64. package/dist/core/cacheKey.js +26 -3
  65. package/dist/core/cacheKey.js.map +1 -1
  66. package/dist/core/capabilities.d.ts +5 -1
  67. package/dist/core/capabilities.js +11 -2
  68. package/dist/core/capabilities.js.map +1 -1
  69. package/dist/core/capture.d.ts +49 -0
  70. package/dist/core/contract.d.ts +74 -5
  71. package/dist/core/contract.js +30 -1
  72. package/dist/core/contract.js.map +1 -1
  73. package/dist/core/granularity.js +1 -1
  74. package/dist/core/options.d.ts +164 -6
  75. package/dist/core/options.js +126 -3
  76. package/dist/core/options.js.map +1 -1
  77. package/dist/core/registry.d.ts +1 -0
  78. package/dist/core/scopeList.js +32 -0
  79. package/dist/core/scopeList.js.map +1 -0
  80. package/dist/core/scopedRead.js +101 -30
  81. package/dist/core/scopedRead.js.map +1 -1
  82. package/dist/core/serverEvent.d.ts +60 -0
  83. package/dist/core/serverEvent.js +12 -0
  84. package/dist/core/serverEvent.js.map +1 -0
  85. package/dist/exports/adapters/ga4.d.ts +2 -1
  86. package/dist/exports/adapters/ga4.js +2 -1
  87. package/dist/exports/adapters/native.d.ts +3 -1
  88. package/dist/exports/adapters/native.js +2 -1
  89. package/dist/exports/client.d.ts +13 -3
  90. package/dist/exports/client.js +10 -1
  91. package/dist/exports/geo.d.ts +2 -2
  92. package/dist/exports/next.d.ts +2 -1
  93. package/dist/exports/next.js +2 -1
  94. package/dist/exports/react.d.ts +4 -0
  95. package/dist/exports/react.js +5 -0
  96. package/dist/exports/rsc.d.ts +11 -3
  97. package/dist/exports/rsc.js +7 -2
  98. package/dist/exports/tracker.d.ts +21 -0
  99. package/dist/exports/tracker.js +15 -0
  100. package/dist/exports/types.d.ts +16 -3
  101. package/dist/exports/types.js +4 -2
  102. package/dist/fields/AnalyticsPanelClient.js +2 -2
  103. package/dist/fields/AnalyticsPanelField.js +1 -1
  104. package/dist/fields/AnalyticsStatField.js +2 -2
  105. package/dist/fields/config/FilterDimensionSelectField.d.ts +14 -0
  106. package/dist/fields/config/FilterDimensionSelectField.js +77 -0
  107. package/dist/fields/config/FilterDimensionSelectField.js.map +1 -0
  108. package/dist/fields/config/FilterOperatorSelectField.d.ts +14 -0
  109. package/dist/fields/config/FilterOperatorSelectField.js +75 -0
  110. package/dist/fields/config/FilterOperatorSelectField.js.map +1 -0
  111. package/dist/fields/config/MetricSelectField.js +3 -3
  112. package/dist/fields/config/MetricSelectField.js.map +1 -1
  113. package/dist/fields/config/SourceSelectField.js +3 -3
  114. package/dist/fields/config/SourceSelectField.js.map +1 -1
  115. package/dist/fields/config/fetchSources.d.ts +5 -1
  116. package/dist/fields/config/fetchSources.js +7 -3
  117. package/dist/fields/config/fetchSources.js.map +1 -1
  118. package/dist/fields/config/narrow.js +2 -0
  119. package/dist/fields/config/narrow.js.map +1 -1
  120. package/dist/fields/config/sourcesState.js +19 -3
  121. package/dist/fields/config/sourcesState.js.map +1 -1
  122. package/dist/fields/config/useAnalyticsSources.d.ts +8 -3
  123. package/dist/fields/config/useAnalyticsSources.js +9 -6
  124. package/dist/fields/config/useAnalyticsSources.js.map +1 -1
  125. package/dist/fields/config/useFilterCapabilities.d.ts +28 -0
  126. package/dist/fields/config/useFilterCapabilities.js +52 -0
  127. package/dist/fields/config/useFilterCapabilities.js.map +1 -0
  128. package/dist/fields/readForDocument.d.ts +5 -0
  129. package/dist/fields/readForDocument.js +22 -10
  130. package/dist/fields/readForDocument.js.map +1 -1
  131. package/dist/goals/GoalSelectField.d.ts +7 -0
  132. package/dist/goals/GoalSelectField.js +77 -0
  133. package/dist/goals/GoalSelectField.js.map +1 -0
  134. package/dist/goals/collection.js +254 -0
  135. package/dist/goals/collection.js.map +1 -0
  136. package/dist/goals/currency.js +14 -0
  137. package/dist/goals/currency.js.map +1 -0
  138. package/dist/goals/fetchGoals.d.ts +18 -0
  139. package/dist/goals/fetchGoals.js +33 -0
  140. package/dist/goals/fetchGoals.js.map +1 -0
  141. package/dist/goals/goalField.d.ts +31 -0
  142. package/dist/goals/goalField.js +56 -0
  143. package/dist/goals/goalField.js.map +1 -0
  144. package/dist/goals/goalsEndpoint.d.ts +1 -0
  145. package/dist/goals/goalsEndpoint.js +58 -0
  146. package/dist/goals/goalsEndpoint.js.map +1 -0
  147. package/dist/goals/match.js +64 -0
  148. package/dist/goals/match.js.map +1 -0
  149. package/dist/goals/resolver.d.ts +8 -0
  150. package/dist/goals/resolver.js +147 -0
  151. package/dist/goals/resolver.js.map +1 -0
  152. package/dist/goals/trackGoalAction.d.ts +76 -0
  153. package/dist/goals/trackGoalAction.js +158 -0
  154. package/dist/goals/trackGoalAction.js.map +1 -0
  155. package/dist/goals/types.d.ts +33 -0
  156. package/dist/goals/types.js +7 -0
  157. package/dist/goals/types.js.map +1 -0
  158. package/dist/goals/useAnalyticsGoals.d.ts +20 -0
  159. package/dist/goals/useAnalyticsGoals.js +67 -0
  160. package/dist/goals/useAnalyticsGoals.js.map +1 -0
  161. package/dist/index.d.ts +14 -3
  162. package/dist/index.js +174 -19
  163. package/dist/index.js.map +1 -1
  164. package/dist/native/collections/events.js +65 -1
  165. package/dist/native/collections/events.js.map +1 -1
  166. package/dist/native/collections/rollups.js +39 -3
  167. package/dist/native/collections/rollups.js.map +1 -1
  168. package/dist/native/eventScan.js +25 -0
  169. package/dist/native/eventScan.js.map +1 -0
  170. package/dist/native/geo/composeGeoResolvers.js +2 -2
  171. package/dist/native/geo/composeGeoResolvers.js.map +1 -1
  172. package/dist/native/geo/geoResolver.d.ts +9 -2
  173. package/dist/native/geo/geoResolver.js.map +1 -1
  174. package/dist/native/geo/maxmindResolver.js +3 -5
  175. package/dist/native/geo/maxmindResolver.js.map +1 -1
  176. package/dist/native/ingest/bots.d.ts +11 -0
  177. package/dist/native/ingest/bots.js +71 -0
  178. package/dist/native/ingest/bots.js.map +1 -0
  179. package/dist/native/ingest/browser.js +47 -0
  180. package/dist/native/ingest/browser.js.map +1 -0
  181. package/dist/native/ingest/clientIp.js +20 -0
  182. package/dist/native/ingest/clientIp.js.map +1 -0
  183. package/dist/native/ingest/device.js +11 -3
  184. package/dist/native/ingest/device.js.map +1 -1
  185. package/dist/native/ingest/endpoint.d.ts +1 -0
  186. package/dist/native/ingest/endpoint.js +107 -21
  187. package/dist/native/ingest/endpoint.js.map +1 -1
  188. package/dist/native/ingest/flushBatch.js +29 -38
  189. package/dist/native/ingest/flushBatch.js.map +1 -1
  190. package/dist/native/ingest/language.js +14 -0
  191. package/dist/native/ingest/language.js.map +1 -0
  192. package/dist/native/ingest/normalizeEvent.d.ts +30 -0
  193. package/dist/native/ingest/normalizeEvent.js +115 -16
  194. package/dist/native/ingest/normalizeEvent.js.map +1 -1
  195. package/dist/native/ingest/referrer.js +48 -0
  196. package/dist/native/ingest/referrer.js.map +1 -0
  197. package/dist/native/ingest/requestHost.js +57 -0
  198. package/dist/native/ingest/requestHost.js.map +1 -0
  199. package/dist/native/ingest/resolveHostname.d.ts +29 -0
  200. package/dist/native/ingest/resolveHostname.js +52 -0
  201. package/dist/native/ingest/resolveHostname.js.map +1 -0
  202. package/dist/native/ingest/salt.js +27 -2
  203. package/dist/native/ingest/salt.js.map +1 -1
  204. package/dist/native/ingest/serverTrack.d.ts +20 -0
  205. package/dist/native/ingest/serverTrack.js +109 -0
  206. package/dist/native/ingest/serverTrack.js.map +1 -0
  207. package/dist/native/ingest/source.d.ts +11 -0
  208. package/dist/native/ingest/source.js +264 -16
  209. package/dist/native/ingest/source.js.map +1 -1
  210. package/dist/native/ingest/utm.js +33 -0
  211. package/dist/native/ingest/utm.js.map +1 -0
  212. package/dist/native/ingest/validate.js +26 -0
  213. package/dist/native/ingest/validate.js.map +1 -0
  214. package/dist/native/nativeAdapter.d.ts +37 -1
  215. package/dist/native/nativeAdapter.js +175 -22
  216. package/dist/native/nativeAdapter.js.map +1 -1
  217. package/dist/native/query/eventAgg.js +175 -0
  218. package/dist/native/query/eventAgg.js.map +1 -0
  219. package/dist/native/retention/pruneTask.js +53 -13
  220. package/dist/native/retention/pruneTask.js.map +1 -1
  221. package/dist/native/rollupAcc.js +12 -1
  222. package/dist/native/rollupAcc.js.map +1 -1
  223. package/dist/native/rollups/bucketKey.js +15 -0
  224. package/dist/native/rollups/bucketKey.js.map +1 -0
  225. package/dist/native/rollups/bumpRollups.js +116 -0
  226. package/dist/native/rollups/bumpRollups.js.map +1 -0
  227. package/dist/native/rollups/deltas.js +86 -11
  228. package/dist/native/rollups/deltas.js.map +1 -1
  229. package/dist/native/rollups/insertManyIfNew.js +93 -0
  230. package/dist/native/rollups/insertManyIfNew.js.map +1 -0
  231. package/dist/next/captureRewrites.d.ts +42 -0
  232. package/dist/next/captureRewrites.js +57 -0
  233. package/dist/next/captureRewrites.js.map +1 -0
  234. package/dist/next/posthogProxyRewrites.d.ts +5 -0
  235. package/dist/next/posthogProxyRewrites.js +16 -21
  236. package/dist/next/posthogProxyRewrites.js.map +1 -1
  237. package/dist/plugin/documentEndpoint.js +71 -24
  238. package/dist/plugin/documentEndpoint.js.map +1 -1
  239. package/dist/plugin/errors.d.ts +31 -0
  240. package/dist/plugin/errors.js +79 -0
  241. package/dist/plugin/errors.js.map +1 -0
  242. package/dist/plugin/goalHint.d.ts +1 -0
  243. package/dist/plugin/goalHint.js +24 -0
  244. package/dist/plugin/goalHint.js.map +1 -0
  245. package/dist/plugin/paths.js +17 -1
  246. package/dist/plugin/paths.js.map +1 -1
  247. package/dist/plugin/queryEndpoint.js +124 -0
  248. package/dist/plugin/queryEndpoint.js.map +1 -0
  249. package/dist/plugin/readContextForRequest.js +73 -0
  250. package/dist/plugin/readContextForRequest.js.map +1 -0
  251. package/dist/plugin/realtimeEndpoint.js +37 -16
  252. package/dist/plugin/realtimeEndpoint.js.map +1 -1
  253. package/dist/plugin/refreshEndpoint.js +113 -0
  254. package/dist/plugin/refreshEndpoint.js.map +1 -0
  255. package/dist/plugin/runtime.d.ts +1 -0
  256. package/dist/plugin/runtime.js +33 -1
  257. package/dist/plugin/runtime.js.map +1 -1
  258. package/dist/plugin/scopeChange.js +22 -0
  259. package/dist/plugin/scopeChange.js.map +1 -0
  260. package/dist/plugin/scopeFieldBoot.js +22 -0
  261. package/dist/plugin/scopeFieldBoot.js.map +1 -0
  262. package/dist/plugin/sourcesEndpoint.js +16 -41
  263. package/dist/plugin/sourcesEndpoint.js.map +1 -1
  264. package/dist/plugin/warmTask.js +0 -0
  265. package/dist/plugin/warmTask.js.map +1 -1
  266. package/dist/providers/collection.js +89 -29
  267. package/dist/providers/collection.js.map +1 -1
  268. package/dist/providers/factory.js +11 -3
  269. package/dist/providers/factory.js.map +1 -1
  270. package/dist/providers/resolver.js.map +1 -1
  271. package/dist/query/dates.js +64 -0
  272. package/dist/query/dates.js.map +1 -0
  273. package/dist/query/errors.d.ts +14 -0
  274. package/dist/query/fetchQuery.d.ts +79 -0
  275. package/dist/query/fetchQuery.js +117 -0
  276. package/dist/query/fetchQuery.js.map +1 -0
  277. package/dist/query/parse.d.ts +22 -0
  278. package/dist/query/parse.js +168 -0
  279. package/dist/query/parse.js.map +1 -0
  280. package/dist/query/response.d.ts +39 -0
  281. package/dist/query/response.js +11 -0
  282. package/dist/query/response.js.map +1 -0
  283. package/dist/react/AnalyticsProvider.d.ts +50 -0
  284. package/dist/react/AnalyticsProvider.js +67 -0
  285. package/dist/react/AnalyticsProvider.js.map +1 -0
  286. package/dist/react/TrackerBoot.d.ts +22 -0
  287. package/dist/react/TrackerBoot.js +30 -0
  288. package/dist/react/TrackerBoot.js.map +1 -0
  289. package/dist/react/useAnalytics.d.ts +20 -0
  290. package/dist/react/useAnalytics.js +52 -0
  291. package/dist/react/useAnalytics.js.map +1 -0
  292. package/dist/rsc/AnalyticsScripts.d.ts +30 -0
  293. package/dist/rsc/AnalyticsScripts.js +41 -0
  294. package/dist/rsc/AnalyticsScripts.js.map +1 -0
  295. package/dist/surfacing/cacheStore.d.ts +1 -0
  296. package/dist/surfacing/cacheStore.js +18 -2
  297. package/dist/surfacing/cacheStore.js.map +1 -1
  298. package/dist/surfacing/engine.d.ts +1 -0
  299. package/dist/surfacing/engine.js +47 -6
  300. package/dist/surfacing/engine.js.map +1 -1
  301. package/dist/surfacing/epoch.d.ts +1 -0
  302. package/dist/surfacing/epoch.js +72 -0
  303. package/dist/surfacing/epoch.js.map +1 -0
  304. package/dist/surfacing/queue.js +22 -6
  305. package/dist/surfacing/queue.js.map +1 -1
  306. package/dist/surfacing/rateLimiter.js +130 -0
  307. package/dist/surfacing/rateLimiter.js.map +1 -0
  308. package/dist/surfacing/retryPolicy.js +15 -0
  309. package/dist/surfacing/retryPolicy.js.map +1 -0
  310. package/dist/sync/collection.js +23 -7
  311. package/dist/sync/collection.js.map +1 -1
  312. package/dist/sync/syncTask.js +68 -33
  313. package/dist/sync/syncTask.js.map +1 -1
  314. package/dist/testing/memoryAdapter.d.ts +2 -0
  315. package/dist/testing/memoryAdapter.js +17 -1
  316. package/dist/testing/memoryAdapter.js.map +1 -1
  317. package/dist/timeframe/tz.js +17 -6
  318. package/dist/timeframe/tz.js.map +1 -1
  319. package/dist/tracker/autoCapture.d.ts +48 -0
  320. package/dist/tracker/autoCapture.js +129 -0
  321. package/dist/tracker/autoCapture.js.map +1 -0
  322. package/dist/tracker/consent.d.ts +24 -0
  323. package/dist/tracker/consent.js +48 -0
  324. package/dist/tracker/consent.js.map +1 -0
  325. package/dist/tracker/createTracker.d.ts +18 -0
  326. package/dist/tracker/createTracker.js +215 -0
  327. package/dist/tracker/createTracker.js.map +1 -0
  328. package/dist/tracker/exclusion.d.ts +28 -0
  329. package/dist/tracker/exclusion.js +50 -0
  330. package/dist/tracker/exclusion.js.map +1 -0
  331. package/dist/tracker/initTracker.d.ts +22 -0
  332. package/dist/tracker/initTracker.js +33 -0
  333. package/dist/tracker/initTracker.js.map +1 -0
  334. package/dist/tracker/loadScript.d.ts +14 -0
  335. package/dist/tracker/loadScript.js +41 -0
  336. package/dist/tracker/loadScript.js.map +1 -0
  337. package/dist/tracker/pageTracking.d.ts +17 -0
  338. package/dist/tracker/pageTracking.js +38 -0
  339. package/dist/tracker/pageTracking.js.map +1 -0
  340. package/dist/tracker/registry.d.ts +27 -0
  341. package/dist/tracker/registry.js +73 -0
  342. package/dist/tracker/registry.js.map +1 -0
  343. package/dist/tracker/sinks/ga4.d.ts +29 -0
  344. package/dist/tracker/sinks/ga4.js +30 -0
  345. package/dist/tracker/sinks/ga4.js.map +1 -0
  346. package/dist/tracker/sinks/native.d.ts +22 -0
  347. package/dist/tracker/sinks/native.js +56 -0
  348. package/dist/tracker/sinks/native.js.map +1 -0
  349. package/dist/tracker/sinks/plausible.d.ts +20 -0
  350. package/dist/tracker/sinks/plausible.js +32 -0
  351. package/dist/tracker/sinks/plausible.js.map +1 -0
  352. package/dist/tracker/sinks/posthog.d.ts +18 -0
  353. package/dist/tracker/sinks/posthog.js +30 -0
  354. package/dist/tracker/sinks/posthog.js.map +1 -0
  355. package/dist/tracker/sinks/umami.d.ts +18 -0
  356. package/dist/tracker/sinks/umami.js +23 -0
  357. package/dist/tracker/sinks/umami.js.map +1 -0
  358. package/dist/tracker/sinks/vendor.d.ts +14 -0
  359. package/dist/tracker/sinks/vendor.js +81 -0
  360. package/dist/tracker/sinks/vendor.js.map +1 -0
  361. package/dist/tracker/transport.js +28 -0
  362. package/dist/tracker/transport.js.map +1 -0
  363. package/dist/tracker/types.d.ts +91 -0
  364. package/dist/translations/ar.js +221 -0
  365. package/dist/translations/ar.js.map +1 -0
  366. package/dist/translations/de.js +145 -1
  367. package/dist/translations/de.js.map +1 -1
  368. package/dist/translations/en.js +145 -1
  369. package/dist/translations/en.js.map +1 -1
  370. package/dist/translations/es.js +221 -0
  371. package/dist/translations/es.js.map +1 -0
  372. package/dist/translations/fr.js +221 -0
  373. package/dist/translations/fr.js.map +1 -0
  374. package/dist/translations/id.js +221 -0
  375. package/dist/translations/id.js.map +1 -0
  376. package/dist/translations/index.d.ts +10 -1
  377. package/dist/translations/index.js +19 -1
  378. package/dist/translations/index.js.map +1 -1
  379. package/dist/translations/keys.d.ts +144 -0
  380. package/dist/translations/keys.js +145 -1
  381. package/dist/translations/keys.js.map +1 -1
  382. package/dist/translations/ko.js +221 -0
  383. package/dist/translations/ko.js.map +1 -0
  384. package/dist/translations/metricKeys.js +8 -2
  385. package/dist/translations/metricKeys.js.map +1 -1
  386. package/dist/translations/pt.js +221 -0
  387. package/dist/translations/pt.js.map +1 -0
  388. package/dist/translations/ru.js +221 -0
  389. package/dist/translations/ru.js.map +1 -0
  390. package/dist/translations/server.js.map +1 -1
  391. package/dist/translations/uk.js +221 -0
  392. package/dist/translations/uk.js.map +1 -0
  393. package/dist/translations/zh.js +221 -0
  394. package/dist/translations/zh.js.map +1 -0
  395. package/dist/view/AnalyticsNavLink.d.ts +19 -0
  396. package/dist/view/AnalyticsNavLink.js +40 -0
  397. package/dist/view/AnalyticsNavLink.js.map +1 -0
  398. package/dist/view/AnalyticsView.d.ts +23 -0
  399. package/dist/view/AnalyticsView.js +45 -0
  400. package/dist/view/AnalyticsView.js.map +1 -0
  401. package/dist/view/AnalyticsViewClient.d.ts +15 -0
  402. package/dist/view/AnalyticsViewClient.js +244 -0
  403. package/dist/view/AnalyticsViewClient.js.map +1 -0
  404. package/dist/view/authRedirect.js +32 -0
  405. package/dist/view/authRedirect.js.map +1 -0
  406. package/dist/view/conversionRate.js +18 -0
  407. package/dist/view/conversionRate.js.map +1 -0
  408. package/dist/view/dayRange.js +68 -0
  409. package/dist/view/dayRange.js.map +1 -0
  410. package/dist/view/gating.d.ts +1 -0
  411. package/dist/view/gating.js +142 -0
  412. package/dist/view/gating.js.map +1 -0
  413. package/dist/view/labels.js +76 -0
  414. package/dist/view/labels.js.map +1 -0
  415. package/dist/view/registerView.js +48 -0
  416. package/dist/view/registerView.js.map +1 -0
  417. package/dist/view/sections/Breakdowns.js +198 -0
  418. package/dist/view/sections/Breakdowns.js.map +1 -0
  419. package/dist/view/sections/EmptyStates.js +92 -0
  420. package/dist/view/sections/EmptyStates.js.map +1 -0
  421. package/dist/view/sections/FilterChips.js +46 -0
  422. package/dist/view/sections/FilterChips.js.map +1 -0
  423. package/dist/view/sections/GoalsPanel.js +82 -0
  424. package/dist/view/sections/GoalsPanel.js.map +1 -0
  425. package/dist/view/sections/OverviewCards.js +65 -0
  426. package/dist/view/sections/OverviewCards.js.map +1 -0
  427. package/dist/view/sections/RealtimeStrip.js +80 -0
  428. package/dist/view/sections/RealtimeStrip.js.map +1 -0
  429. package/dist/view/sections/Toolbar.js +207 -0
  430. package/dist/view/sections/Toolbar.js.map +1 -0
  431. package/dist/view/sections/Trend.js +125 -0
  432. package/dist/view/sections/Trend.js.map +1 -0
  433. package/dist/view/sections/styles.js +76 -0
  434. package/dist/view/sections/styles.js.map +1 -0
  435. package/dist/view/state.js +211 -0
  436. package/dist/view/state.js.map +1 -0
  437. package/dist/view/useViewQueries.js +153 -0
  438. package/dist/view/useViewQueries.js.map +1 -0
  439. package/dist/view/viewProps.d.ts +40 -0
  440. package/dist/view/viewProps.js +90 -0
  441. package/dist/view/viewProps.js.map +1 -0
  442. package/dist/widgets/AnalyticsBreakdownWidget.d.ts +2 -1
  443. package/dist/widgets/AnalyticsBreakdownWidget.js +78 -11
  444. package/dist/widgets/AnalyticsBreakdownWidget.js.map +1 -1
  445. package/dist/widgets/AnalyticsGoalsWidget.d.ts +14 -0
  446. package/dist/widgets/AnalyticsGoalsWidget.js +196 -0
  447. package/dist/widgets/AnalyticsGoalsWidget.js.map +1 -0
  448. package/dist/widgets/AnalyticsMetricWidget.d.ts +2 -1
  449. package/dist/widgets/AnalyticsMetricWidget.js +63 -13
  450. package/dist/widgets/AnalyticsMetricWidget.js.map +1 -1
  451. package/dist/widgets/AnalyticsRealtimeWidget.d.ts +2 -1
  452. package/dist/widgets/AnalyticsRealtimeWidget.js +44 -22
  453. package/dist/widgets/AnalyticsRealtimeWidget.js.map +1 -1
  454. package/dist/widgets/AnalyticsTrendWidget.d.ts +2 -1
  455. package/dist/widgets/AnalyticsTrendWidget.js +79 -16
  456. package/dist/widgets/AnalyticsTrendWidget.js.map +1 -1
  457. package/dist/widgets/RealtimeCounter.d.ts +4 -0
  458. package/dist/widgets/RealtimeCounter.js +18 -4
  459. package/dist/widgets/RealtimeCounter.js.map +1 -1
  460. package/dist/widgets/WidgetViewLink.js +17 -0
  461. package/dist/widgets/WidgetViewLink.js.map +1 -0
  462. package/dist/widgets/breakdownTypes.js +38 -0
  463. package/dist/widgets/breakdownTypes.js.map +1 -1
  464. package/dist/widgets/cardChrome.js +31 -7
  465. package/dist/widgets/cardChrome.js.map +1 -1
  466. package/dist/widgets/comparison.js +15 -1
  467. package/dist/widgets/comparison.js.map +1 -1
  468. package/dist/widgets/defaults.d.ts +6 -2
  469. package/dist/widgets/defaults.js +78 -23
  470. package/dist/widgets/defaults.js.map +1 -1
  471. package/dist/widgets/filterCaption.js +27 -0
  472. package/dist/widgets/filterCaption.js.map +1 -0
  473. package/dist/widgets/filterField.d.ts +19 -0
  474. package/dist/widgets/filterField.js +75 -0
  475. package/dist/widgets/filterField.js.map +1 -0
  476. package/dist/widgets/prepareWidgetRead.d.ts +7 -0
  477. package/dist/widgets/prepareWidgetRead.js +74 -0
  478. package/dist/widgets/prepareWidgetRead.js.map +1 -0
  479. package/dist/widgets/range.js +43 -12
  480. package/dist/widgets/range.js.map +1 -1
  481. package/dist/widgets/readForWidget.d.ts +26 -3
  482. package/dist/widgets/readForWidget.js +48 -44
  483. package/dist/widgets/readForWidget.js.map +1 -1
  484. package/dist/widgets/readForWidgetBreakdown.d.ts +34 -2
  485. package/dist/widgets/readForWidgetBreakdown.js +53 -49
  486. package/dist/widgets/readForWidgetBreakdown.js.map +1 -1
  487. package/dist/widgets/readForWidgetGoals.d.ts +67 -0
  488. package/dist/widgets/readForWidgetGoals.js +140 -0
  489. package/dist/widgets/readForWidgetGoals.js.map +1 -0
  490. package/dist/widgets/readForWidgetRealtime.d.ts +8 -0
  491. package/dist/widgets/readForWidgetRealtime.js +23 -21
  492. package/dist/widgets/readForWidgetRealtime.js.map +1 -1
  493. package/dist/widgets/readForWidgetSeries.d.ts +26 -2
  494. package/dist/widgets/readForWidgetSeries.js +78 -53
  495. package/dist/widgets/readForWidgetSeries.js.map +1 -1
  496. package/dist/widgets/readMeta.js +18 -0
  497. package/dist/widgets/readMeta.js.map +1 -0
  498. package/dist/widgets/realtimePoll.js +13 -1
  499. package/dist/widgets/realtimePoll.js.map +1 -1
  500. package/dist/widgets/registerWidgets.js +62 -10
  501. package/dist/widgets/registerWidgets.js.map +1 -1
  502. package/dist/widgets/types.d.ts +15 -0
  503. package/dist/widgets/types.js +16 -2
  504. package/dist/widgets/types.js.map +1 -1
  505. package/dist/widgets/viewLink.d.ts +22 -0
  506. package/dist/widgets/viewLink.js +86 -0
  507. package/dist/widgets/viewLink.js.map +1 -0
  508. package/package.json +27 -7
  509. package/dist/native/rollups/applyDistinctDeltas.js +0 -9
  510. package/dist/native/rollups/applyDistinctDeltas.js.map +0 -1
  511. package/dist/native/rollups/bumpRollup.js +0 -68
  512. package/dist/native/rollups/bumpRollup.js.map +0 -1
  513. package/dist/native/rollups/insertIfNew.js +0 -19
  514. package/dist/native/rollups/insertIfNew.js.map +0 -1
@@ -0,0 +1 @@
1
+ {"version":3,"file":"trackGoalAction.js","names":[],"sources":["../../src/goals/trackGoalAction.ts"],"sourcesContent":["import type { Field, Payload, PayloadRequest } from 'payload'\nimport { AnalyticsTrackError } from '../core/serverEvent'\nimport { normalizeHostname, requestHostname } from '../native/ingest/requestHost'\nimport { ingestAdapter, trackServerEvent } from '../native/ingest/serverTrack'\nimport { getRuntime } from '../plugin/runtime'\nimport { keys } from '../translations/keys'\nimport { labelForKey } from '../translations/server'\nimport { validateCurrency } from './currency'\nimport { goalField, goalSlug } from './goalField'\n\n/** The action type form-builder stores as the block slug on a form's `actions` array. */\nexport const GOAL_ACTION_TYPE = 'analyticsGoal'\n\n/**\n * The run context form-builder hands a post-submit action, narrowed to what goal tracking\n * reads. A structural subset rather than an import: analytics never depends on form-builder\n * at runtime, so an install without it still resolves this module.\n */\nexport interface GoalActionRunArgs {\n\tform: { id: number | string; title?: string }\n\tsubmissionId: number | string\n\t/** One entry per answered field, keyed by the field's machine name. */\n\tvalues: Array<{ field: string; value: unknown }>\n\tconfig: Record<string, unknown>\n\tpayload: Payload\n\t/**\n\t * The request the action runs under. On a queued dispatch this is the job runner's own\n\t * request, not the visitor's, so it carries neither the submitting host nor the tenant.\n\t */\n\treq?: PayloadRequest\n}\n\n/**\n * Structural counterpart of form-builder's `ActionDefinition<Record<string, unknown>>`; a\n * value of this type is assignable to it, which `trackGoalAction.test.ts` pins.\n */\nexport interface GoalActionDefinition {\n\ttype: typeof GOAL_ACTION_TYPE\n\tlabel: string | Record<string, string>\n\tconfig: Field[]\n\trun: (args: GoalActionRunArgs) => Promise<void>\n}\n\nexport interface TrackGoalActionOptions {\n\t/**\n\t * Site the completion belongs to. Falls back to the submitting request's host as the\n\t * native adapter's `hostname` policy judges it, then to the host of `serverURL`. With none\n\t * of the three the completion is not recorded at all, and one warning names the install.\n\t * Set it whenever a jobs runner queues actions: the runner's request carries the CMS host\n\t * at best, and often no host at all.\n\t */\n\thostname?: string | ((args: GoalActionRunArgs) => string)\n\t/** Page the completion is attributed to. Defaults to `/forms/<form id>`. */\n\tpath?: string | ((args: GoalActionRunArgs) => string)\n\t/**\n\t * Analytics boundary to stamp; `null` is install-wide. Leave unset and the scope resolves\n\t * from the action's request, which on a queued dispatch is the runner's rather than the\n\t * submitter's and so usually lands install-wide. Set it on any scoped install whose\n\t * actions are queued, since the submitter's tenant cannot be recovered there.\n\t */\n\tscope?: string | null | ((args: GoalActionRunArgs) => string | null | Promise<string | null>)\n}\n\nconst configFields = (): Field[] => [\n\tgoalField({ name: 'goal', required: true }),\n\t{\n\t\tname: 'value',\n\t\ttype: 'number',\n\t\tmin: 0,\n\t\tlabel: labelForKey(keys.goalFieldValue),\n\t},\n\t{\n\t\tname: 'valueFrom',\n\t\ttype: 'text',\n\t\tlabel: labelForKey(keys.actionGoalFieldValueFrom),\n\t\tadmin: { description: labelForKey(keys.actionGoalFieldValueFromHelp) },\n\t},\n\t{\n\t\tname: 'currency',\n\t\ttype: 'text',\n\t\tlabel: labelForKey(keys.goalFieldCurrency),\n\t\tvalidate: validateCurrency,\n\t},\n]\n\nconst finiteNumber = (value: unknown): number | undefined => {\n\tif (typeof value === 'number') {\n\t\treturn Number.isFinite(value) ? value : undefined\n\t}\n\tif (typeof value === 'string' && value.trim() !== '') {\n\t\tconst parsed = Number(value)\n\t\treturn Number.isFinite(parsed) ? parsed : undefined\n\t}\n\treturn undefined\n}\n\nconst nonEmpty = (value: unknown): string | undefined => {\n\tif (typeof value !== 'string') {\n\t\treturn undefined\n\t}\n\tconst trimmed = value.trim()\n\treturn trimmed === '' ? undefined : trimmed\n}\n\nconst fromOption = (\n\toption: string | ((args: GoalActionRunArgs) => string) | undefined,\n\targs: GoalActionRunArgs\n): string | undefined =>\n\tnonEmpty(typeof option === 'function' ? option(args) : (option ?? undefined))\n\nconst serverUrlHost = (payload: Payload): string | null => {\n\tconst serverURL = nonEmpty(payload.config?.serverURL)\n\tif (!serverURL) {\n\t\treturn null\n\t}\n\ttry {\n\t\treturn normalizeHostname(new URL(serverURL).hostname)\n\t} catch {\n\t\treturn null\n\t}\n}\n\n/**\n * The submitting request's host as the hostname policy of the very adapter the event is written\n * through judges it: a `Host` header is forgeable, and a conversion must not be able to mint a\n * hostname the ingest endpoint would have refused. Without that adapter exposing the seam the\n * request's own host stands in, which is the policy's default anyway.\n */\nconst policyHostname = async (\n\targs: GoalActionRunArgs,\n\tscope: string | null\n): Promise<string | null> => {\n\tif (!args.req) {\n\t\treturn null\n\t}\n\tconst policy = ingestAdapter(args.payload)?.ingest?.hostname\n\tif (policy) {\n\t\treturn policy({ req: args.req, scope })\n\t}\n\treturn requestHostname(args.req.headers, {\n\t\ttrustedProxyHops: getRuntime(args.payload)?.trustedProxyHops,\n\t})\n}\n\n/**\n * The option, then the submitting request under the ingest hostname policy, then the install's\n * own `serverURL`. Every rung is normalized to the one hostname shape, and null means the\n * conversion cannot be attributed to any site at all. The queued dispatch path reaches the last\n * two with the runner's request, so an install that queues actions and serves more than one\n * site has to say which site in the option.\n */\nconst hostnameFor = async (\n\toptions: TrackGoalActionOptions,\n\targs: GoalActionRunArgs,\n\tscope: string | null\n): Promise<string | null> => {\n\tconst configured = normalizeHostname(fromOption(options.hostname, args))\n\tif (configured) {\n\t\treturn configured\n\t}\n\treturn (await policyHostname(args, scope)) ?? serverUrlHost(args.payload)\n}\n\nlet warnedNoHostname = false\n\n/**\n * Once per process: a public form would otherwise let a repeated submission choose how much the\n * log grows, and a whole install misconfigured this way is one line's worth of news.\n */\nconst warnNoHostname = (payload: Payload): void => {\n\tif (warnedNoHostname) {\n\t\treturn\n\t}\n\twarnedNoHostname = true\n\tpayload.logger?.warn(\n\t\t\"analytics: a form goal could not be recorded because no hostname resolved: set serverURL or check the adapter's hostname policy\"\n\t)\n}\n\n/** The fixed value wins; otherwise the named answer, and only when it reads as a number. */\nconst valueFor = (args: GoalActionRunArgs): number | undefined => {\n\tconst fixed = finiteNumber(args.config.value)\n\tif (fixed !== undefined) {\n\t\treturn fixed\n\t}\n\tconst field = nonEmpty(args.config.valueFrom)\n\tif (!field) {\n\t\treturn undefined\n\t}\n\treturn finiteNumber(args.values.find((entry) => entry.field === field)?.value)\n}\n\nconst propsFor = (args: GoalActionRunArgs): Record<string, unknown> => {\n\tconst props: Record<string, unknown> = {\n\t\tformId: String(args.form.id),\n\t\tsubmissionId: String(args.submissionId),\n\t}\n\tconst title = nonEmpty(args.form.title)\n\tif (title) {\n\t\tprops.formTitle = title\n\t}\n\treturn props\n}\n\nconst scopeFor = async (\n\toptions: TrackGoalActionOptions,\n\targs: GoalActionRunArgs\n): Promise<{ scope?: string | null }> => {\n\tif (options.scope === undefined) {\n\t\treturn {}\n\t}\n\treturn { scope: typeof options.scope === 'function' ? await options.scope(args) : options.scope }\n}\n\n/**\n * A form-builder post-submit action that completes an analytics goal, authored per form in\n * the admin: pick the goal, optionally a revenue value (fixed, or read from a submission\n * field) and its currency. Register it through form-builder's `actions` option under\n * {@link GOAL_ACTION_TYPE}.\n *\n * Needs the native adapter, since it records through {@link trackServerEvent}. `essential`\n * is deliberately unset: a goal is a measurement, so a failed write is logged and the\n * submission still succeeds.\n *\n * On any install with a jobs runner, form-builder queues non-essential actions, and the\n * queued run carries the runner's request rather than the visitor's. Set `hostname` (and\n * `scope`, on a scoped install) there, since neither can be recovered from that request.\n */\nexport const trackGoalAction = (options: TrackGoalActionOptions = {}): GoalActionDefinition => ({\n\ttype: GOAL_ACTION_TYPE,\n\tlabel: keys.actionGoalLabel,\n\tconfig: configFields(),\n\trun: async (args) => {\n\t\tconst slug = goalSlug(args.config.goal)\n\t\tif (!slug) {\n\t\t\tthrow new AnalyticsTrackError('analytics: trackGoalAction has no goal configured')\n\t\t}\n\t\tconst scope = await scopeFor(options, args)\n\t\tconst hostname = await hostnameFor(options, args, scope.scope ?? null)\n\t\tif (!hostname) {\n\t\t\twarnNoHostname(args.payload)\n\t\t\treturn\n\t\t}\n\t\tawait trackServerEvent(\n\t\t\targs.payload,\n\t\t\t{\n\t\t\t\ttype: 'goal',\n\t\t\t\tname: slug,\n\t\t\t\tpath: fromOption(options.path, args) ?? `/forms/${args.form.id}`,\n\t\t\t\thostname,\n\t\t\t\tvalue: valueFor(args),\n\t\t\t\tcurrency: nonEmpty(args.config.currency),\n\t\t\t\tprops: propsFor(args),\n\t\t\t\t...scope,\n\t\t\t},\n\t\t\t{ req: args.req }\n\t\t)\n\t},\n})\n"],"mappings":"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"}
@@ -0,0 +1,33 @@
1
+ //#region src/goals/types.d.ts
2
+ /**
3
+ * How an incoming event is recognized as a completion of this goal. `goal` matches an
4
+ * explicit `trackGoal(slug)` call, which is what the attribute and action hookups emit.
5
+ */
6
+ type GoalMatch = {
7
+ kind: 'event';
8
+ name: string;
9
+ } | {
10
+ kind: 'path';
11
+ pattern: string;
12
+ } | {
13
+ kind: 'goal';
14
+ };
15
+ interface Goal {
16
+ /** Stable identifier, kebab-case; unique across the install's goals. */
17
+ slug: string;
18
+ /** Admin-facing label. Never leaves the server: the tracker config carries slugs only. */
19
+ name: string;
20
+ match: GoalMatch;
21
+ /** Revenue for one completion: a fixed amount, or read from an event property. */
22
+ value?: {
23
+ fixed?: number;
24
+ prop?: string;
25
+ };
26
+ /** ISO 4217 code the goal's value is denominated in. */
27
+ currency?: string;
28
+ }
29
+ /** The goal fields the browser tracker needs; `name` is admin-facing only. */
30
+ type TrackerGoal = Pick<Goal, 'slug' | 'match' | 'value' | 'currency'>;
31
+ //#endregion
32
+ export { Goal, GoalMatch, TrackerGoal };
33
+ //# sourceMappingURL=types.d.ts.map
@@ -0,0 +1,7 @@
1
+ //#region src/goals/types.ts
2
+ /** Kebab-case, so a slug is safe in a URL, a data attribute, and a rollup bucket key. */
3
+ const GOAL_SLUG_PATTERN = /^[a-z0-9]+(?:-[a-z0-9]+)*$/;
4
+ //#endregion
5
+ export { GOAL_SLUG_PATTERN };
6
+
7
+ //# sourceMappingURL=types.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.js","names":[],"sources":["../../src/goals/types.ts"],"sourcesContent":["/**\n * How an incoming event is recognized as a completion of this goal. `goal` matches an\n * explicit `trackGoal(slug)` call, which is what the attribute and action hookups emit.\n */\nexport type GoalMatch =\n\t| { kind: 'event'; name: string }\n\t| { kind: 'path'; pattern: string }\n\t| { kind: 'goal' }\n\nexport interface Goal {\n\t/** Stable identifier, kebab-case; unique across the install's goals. */\n\tslug: string\n\t/** Admin-facing label. Never leaves the server: the tracker config carries slugs only. */\n\tname: string\n\tmatch: GoalMatch\n\t/** Revenue for one completion: a fixed amount, or read from an event property. */\n\tvalue?: { fixed?: number; prop?: string }\n\t/** ISO 4217 code the goal's value is denominated in. */\n\tcurrency?: string\n}\n\n/** The goal fields the browser tracker needs; `name` is admin-facing only. */\nexport type TrackerGoal = Pick<Goal, 'slug' | 'match' | 'value' | 'currency'>\n\n/** Kebab-case, so a slug is safe in a URL, a data attribute, and a rollup bucket key. */\nexport const GOAL_SLUG_PATTERN = /^[a-z0-9]+(?:-[a-z0-9]+)*$/\n"],"mappings":";;AAyBA,MAAa,oBAAoB"}
@@ -0,0 +1,20 @@
1
+ import { GoalsResponse } from "./fetchGoals.js";
2
+
3
+ //#region src/goals/useAnalyticsGoals.d.ts
4
+ interface AnalyticsGoals {
5
+ /** Null until the fetch settles, and on a failed one: not the same thing as none. */
6
+ goals: GoalsResponse['goals'] | null;
7
+ collection: GoalsResponse['collection'];
8
+ /** The fetch settled in failure, so a picker can say so instead of claiming none exist. */
9
+ error: boolean;
10
+ }
11
+ /**
12
+ * Fetches the caller-scope goal list for the admin goal picker. `goals` stays null while
13
+ * the fetch is in flight, when it fails, and when there is no authenticated user yet, so
14
+ * a picker can tell "still loading" from "this scope has no goals". Goals fetched for a
15
+ * previous user are never returned while a new user's fetch is pending.
16
+ */
17
+ declare const useAnalyticsGoals: () => AnalyticsGoals;
18
+ //#endregion
19
+ export { useAnalyticsGoals };
20
+ //# sourceMappingURL=useAnalyticsGoals.d.ts.map
@@ -0,0 +1,67 @@
1
+ "use client";
2
+ import { fetchGoals } from "./fetchGoals.js";
3
+ import { useEffect, useState } from "react";
4
+ import { useAuth, useConfig } from "@payloadcms/ui";
5
+ //#region src/goals/useAnalyticsGoals.ts
6
+ const EMPTY = {
7
+ collection: null,
8
+ error: false,
9
+ goals: null
10
+ };
11
+ const FAILED = {
12
+ collection: null,
13
+ error: true,
14
+ goals: null
15
+ };
16
+ /**
17
+ * Fetches the caller-scope goal list for the admin goal picker. `goals` stays null while
18
+ * the fetch is in flight, when it fails, and when there is no authenticated user yet, so
19
+ * a picker can tell "still loading" from "this scope has no goals". Goals fetched for a
20
+ * previous user are never returned while a new user's fetch is pending.
21
+ */
22
+ const useAnalyticsGoals = () => {
23
+ const { user } = useAuth();
24
+ const { config: { routes: { api }, serverURL } } = useConfig();
25
+ const userKey = String(user?.id ?? "");
26
+ const [state, setState] = useState({
27
+ data: EMPTY,
28
+ key: ""
29
+ });
30
+ useEffect(() => {
31
+ if (!userKey) {
32
+ setState({
33
+ data: EMPTY,
34
+ key: ""
35
+ });
36
+ return;
37
+ }
38
+ let cancelled = false;
39
+ fetchGoals(serverURL ?? "", api, userKey).then(({ collection, goals }) => {
40
+ if (!cancelled) setState({
41
+ data: {
42
+ collection,
43
+ error: false,
44
+ goals
45
+ },
46
+ key: userKey
47
+ });
48
+ }).catch(() => {
49
+ if (!cancelled) setState({
50
+ data: FAILED,
51
+ key: userKey
52
+ });
53
+ });
54
+ return () => {
55
+ cancelled = true;
56
+ };
57
+ }, [
58
+ api,
59
+ serverURL,
60
+ userKey
61
+ ]);
62
+ return state.key === userKey ? state.data : EMPTY;
63
+ };
64
+ //#endregion
65
+ export { useAnalyticsGoals };
66
+
67
+ //# sourceMappingURL=useAnalyticsGoals.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"useAnalyticsGoals.js","names":[],"sources":["../../src/goals/useAnalyticsGoals.ts"],"sourcesContent":["'use client'\n\nimport { useAuth, useConfig } from '@payloadcms/ui'\nimport { useEffect, useState } from 'react'\nimport { fetchGoals, type GoalsResponse } from './fetchGoals'\n\nexport interface AnalyticsGoals {\n\t/** Null until the fetch settles, and on a failed one: not the same thing as none. */\n\tgoals: GoalsResponse['goals'] | null\n\tcollection: GoalsResponse['collection']\n\t/** The fetch settled in failure, so a picker can say so instead of claiming none exist. */\n\terror: boolean\n}\n\nconst EMPTY: AnalyticsGoals = { collection: null, error: false, goals: null }\nconst FAILED: AnalyticsGoals = { collection: null, error: true, goals: null }\n\n/**\n * Fetches the caller-scope goal list for the admin goal picker. `goals` stays null while\n * the fetch is in flight, when it fails, and when there is no authenticated user yet, so\n * a picker can tell \"still loading\" from \"this scope has no goals\". Goals fetched for a\n * previous user are never returned while a new user's fetch is pending.\n */\nexport const useAnalyticsGoals = (): AnalyticsGoals => {\n\tconst { user } = useAuth()\n\tconst {\n\t\tconfig: {\n\t\t\troutes: { api },\n\t\t\tserverURL,\n\t\t},\n\t} = useConfig()\n\tconst userKey = String(user?.id ?? '')\n\tconst [state, setState] = useState<{ key: string; data: AnalyticsGoals }>({\n\t\tdata: EMPTY,\n\t\tkey: '',\n\t})\n\n\tuseEffect(() => {\n\t\tif (!userKey) {\n\t\t\tsetState({ data: EMPTY, key: '' })\n\t\t\treturn\n\t\t}\n\t\tlet cancelled = false\n\t\tfetchGoals(serverURL ?? '', api, userKey)\n\t\t\t.then(({ collection, goals }) => {\n\t\t\t\tif (!cancelled) setState({ data: { collection, error: false, goals }, key: userKey })\n\t\t\t})\n\t\t\t.catch(() => {\n\t\t\t\tif (!cancelled) setState({ data: FAILED, key: userKey })\n\t\t\t})\n\t\treturn () => {\n\t\t\tcancelled = true\n\t\t}\n\t}, [api, serverURL, userKey])\n\n\treturn state.key === userKey ? state.data : EMPTY\n}\n"],"mappings":";;;;;AAcA,MAAM,QAAwB;CAAE,YAAY;CAAM,OAAO;CAAO,OAAO;AAAK;AAC5E,MAAM,SAAyB;CAAE,YAAY;CAAM,OAAO;CAAM,OAAO;AAAK;;;;;;;AAQ5E,MAAa,0BAA0C;CACtD,MAAM,EAAE,SAAS,QAAQ;CACzB,MAAM,EACL,QAAQ,EACP,QAAQ,EAAE,OACV,gBAEE,UAAU;CACd,MAAM,UAAU,OAAO,MAAM,MAAM,EAAE;CACrC,MAAM,CAAC,OAAO,YAAY,SAAgD;EACzE,MAAM;EACN,KAAK;CACN,CAAC;CAED,gBAAgB;EACf,IAAI,CAAC,SAAS;GACb,SAAS;IAAE,MAAM;IAAO,KAAK;GAAG,CAAC;GACjC;EACD;EACA,IAAI,YAAY;EAChB,WAAW,aAAa,IAAI,KAAK,OAAO,EACtC,MAAM,EAAE,YAAY,YAAY;GAChC,IAAI,CAAC,WAAW,SAAS;IAAE,MAAM;KAAE;KAAY,OAAO;KAAO;IAAM;IAAG,KAAK;GAAQ,CAAC;EACrF,CAAC,EACA,YAAY;GACZ,IAAI,CAAC,WAAW,SAAS;IAAE,MAAM;IAAQ,KAAK;GAAQ,CAAC;EACxD,CAAC;EACF,aAAa;GACZ,YAAY;EACb;CACD,GAAG;EAAC;EAAK;EAAW;CAAO,CAAC;CAE5B,OAAO,MAAM,QAAQ,UAAU,MAAM,OAAO;AAC7C"}
package/dist/index.d.ts CHANGED
@@ -1,10 +1,21 @@
1
+ import { Goal, GoalMatch, TrackerGoal } from "./goals/types.js";
2
+ import { AnalyticsTrackError, ServerEventInput, ServerTrack, ServerTrackOptions } from "./core/serverEvent.js";
1
3
  import { PLATFORM_SCOPE } from "./core/contract.js";
4
+ import { GoalsResponse, WireGoal } from "./goals/fetchGoals.js";
5
+ import { ANALYTICS_ERROR_CODES, AnalyticsError, AnalyticsErrorCode, analyticsError, readErrorCode } from "./plugin/errors.js";
6
+ import { QueryError, QueryErrorCode } from "./query/errors.js";
7
+ import { QueryErrorResponse, QueryResponse, QuerySourceRef, SerializedAnalyticsQuery } from "./query/response.js";
2
8
  import { AnalyticsBinding, BindingContext, HostnameResolver, PathResolver } from "./binding/types.js";
3
9
  import { TimeframePreset } from "./timeframe/presets.js";
4
- import { AnalyticsFieldsOptions, AnalyticsMetricLabel, AnalyticsMetricLabels, AnalyticsStatOptions, AnalyticsStatRowOptions, AnalyticsTabOptions, analyticsFields, analyticsStat, analyticsStatRow, analyticsTab, analyticsTabsField } from "./fields/factories.js";
5
10
  import { CustomWidgetDef } from "./widgets/customWidget.js";
6
- import { AnalyticsAccessOptions, AnalyticsPluginOptions, PlatformReadAccess, ProvidersCollectionOptions, ProvidersOptions, ProvidersResolve, ScopeResolver, TimezoneResolver } from "./core/options.js";
11
+ import { AnalyticsAccessOptions, AnalyticsCaptureOptions, AnalyticsGoalsCollectionOptions, AnalyticsGoalsOptions, AnalyticsPluginOptions, AnalyticsReadAccess, AnalyticsViewAccess, AnalyticsViewOptions, AutoCaptureOptions, CaptureConsentOption, ConsentMode, ConsentResolver, PlatformReadAccess, ProvidersCollectionOptions, ProvidersOptions, ProvidersResolve, ScopeResolver, ScopesResolver, TimezoneResolver } from "./core/options.js";
12
+ import { AnalyticsFieldsOptions, AnalyticsMetricLabel, AnalyticsMetricLabels, AnalyticsStatOptions, AnalyticsStatRowOptions, AnalyticsTabOptions, analyticsFields, analyticsStat, analyticsStatRow, analyticsTab, analyticsTabsField } from "./fields/factories.js";
13
+ import { GoalFieldOptions, goalField, goalSlug } from "./goals/goalField.js";
14
+ import { GOAL_ACTION_TYPE, GoalActionDefinition, GoalActionRunArgs, TrackGoalActionOptions, trackGoalAction } from "./goals/trackGoalAction.js";
15
+ import { trackServerEvent } from "./native/ingest/serverTrack.js";
7
16
  import { analyticsDefaultWidgets } from "./widgets/defaults.js";
17
+ import { WidgetFilter } from "./widgets/types.js";
18
+ import { widgetFilters } from "./widgets/filterField.js";
8
19
 
9
20
  //#region src/index.d.ts
10
21
  declare module 'payload' {
@@ -14,5 +25,5 @@ declare module 'payload' {
14
25
  }
15
26
  declare const analytics: (options: AnalyticsPluginOptions) => import("payload").Plugin;
16
27
  //#endregion
17
- export { type AnalyticsAccessOptions, type AnalyticsBinding, type AnalyticsFieldsOptions, type AnalyticsMetricLabel, type AnalyticsMetricLabels, type AnalyticsPluginOptions, type AnalyticsStatOptions, type AnalyticsStatRowOptions, type AnalyticsTabOptions, type BindingContext, type CustomWidgetDef, type HostnameResolver, PLATFORM_SCOPE, type PathResolver, type PlatformReadAccess, type AnalyticsPluginOptions as PluginOptions, type ProvidersCollectionOptions, type ProvidersOptions, type ProvidersResolve, type ScopeResolver, type TimeframePreset, type TimezoneResolver, analytics, analyticsDefaultWidgets, analyticsFields, analyticsStat, analyticsStatRow, analyticsTab, analyticsTabsField };
28
+ export { ANALYTICS_ERROR_CODES, type AnalyticsAccessOptions, type AnalyticsBinding, type AnalyticsCaptureOptions, type AnalyticsError, type AnalyticsErrorCode, type AnalyticsFieldsOptions, type AnalyticsGoalsCollectionOptions, type AnalyticsGoalsOptions, type AnalyticsMetricLabel, type AnalyticsMetricLabels, type AnalyticsPluginOptions, type AnalyticsReadAccess, type AnalyticsStatOptions, type AnalyticsStatRowOptions, type AnalyticsTabOptions, AnalyticsTrackError, type AnalyticsViewAccess, type AnalyticsViewOptions, type AutoCaptureOptions, type BindingContext, type CaptureConsentOption, type ConsentMode, type ConsentResolver, type CustomWidgetDef, GOAL_ACTION_TYPE, type Goal, type GoalActionDefinition, type GoalActionRunArgs, type GoalFieldOptions, type GoalMatch, type GoalsResponse, type HostnameResolver, PLATFORM_SCOPE, type PathResolver, type PlatformReadAccess, type AnalyticsPluginOptions as PluginOptions, type ProvidersCollectionOptions, type ProvidersOptions, type ProvidersResolve, type QueryError, type QueryErrorCode, type QueryErrorResponse, type QueryResponse, type QuerySourceRef, type ScopeResolver, type ScopesResolver, type SerializedAnalyticsQuery, type ServerEventInput, type ServerTrack, type ServerTrackOptions, type TimeframePreset, type TimezoneResolver, type TrackGoalActionOptions, type TrackerGoal, type WidgetFilter, type WireGoal, analytics, analyticsDefaultWidgets, analyticsError, analyticsFields, analyticsStat, analyticsStatRow, analyticsTab, analyticsTabsField, goalField, goalSlug, readErrorCode, trackGoalAction, trackServerEvent, widgetFilters };
18
29
  //# sourceMappingURL=index.d.ts.map
package/dist/index.js CHANGED
@@ -1,31 +1,66 @@
1
+ import { DOCUMENT_PATH, GOALS_PATH, QUERY_PATH, REALTIME_PATH, REFRESH_PATH, SOURCES_PATH } from "./plugin/paths.js";
2
+ import { PLATFORM_SCOPE } from "./core/contract.js";
3
+ import { createEpochStore } from "./surfacing/epoch.js";
4
+ import { isValidTimeZone } from "./timeframe/tz.js";
5
+ import { setRuntime } from "./plugin/runtime.js";
6
+ import { proxyEndpoints } from "./capture/proxyEndpoint.js";
7
+ import { configGoalsResolver, createGoalsResolver } from "./goals/resolver.js";
8
+ import { buildGoalsCollection } from "./goals/collection.js";
1
9
  import { buildProvidersCollection } from "./providers/collection.js";
2
10
  import { resolveOptions } from "./core/options.js";
11
+ import { trackerEndpoint } from "./capture/trackerEndpoint.js";
3
12
  import { createRegistry, staticRegistryResolver } from "./core/registry.js";
4
- import { isValidTimeZone } from "./timeframe/tz.js";
5
- import { setRuntime } from "./plugin/runtime.js";
6
- import { PLATFORM_SCOPE } from "./core/contract.js";
7
- import { DOCUMENT_PATH, REALTIME_PATH, SOURCES_PATH } from "./plugin/paths.js";
13
+ import { ANALYTICS_ERROR_CODES, analyticsError, readErrorCode } from "./plugin/errors.js";
14
+ import { makeGoalsHandler } from "./goals/goalsEndpoint.js";
15
+ import { AnalyticsTrackError } from "./core/serverEvent.js";
16
+ import { trackServerEvent } from "./native/ingest/serverTrack.js";
8
17
  import { makeDocumentHandler } from "./plugin/documentEndpoint.js";
9
18
  import { isModuleNotFoundError } from "./plugin/peerImportError.js";
19
+ import { makeQueryHandler } from "./plugin/queryEndpoint.js";
10
20
  import { kvCacheStore } from "./surfacing/cacheStore.js";
11
21
  import { makeRealtimeHandler } from "./plugin/realtimeEndpoint.js";
22
+ import { makeRefreshHandler } from "./plugin/refreshEndpoint.js";
12
23
  import { registerTranslations } from "./plugin/registerTranslations.js";
24
+ import { validateScopeField } from "./plugin/scopeFieldBoot.js";
13
25
  import { makeSourcesHandler } from "./plugin/sourcesEndpoint.js";
14
26
  import { warmTask } from "./plugin/warmTask.js";
15
27
  import { collectionProvidersSource, combineRegistries, createScopedRegistryResolver } from "./providers/resolver.js";
16
28
  import { createEngine } from "./surfacing/engine.js";
17
29
  import { syncCollection } from "./sync/collection.js";
18
30
  import { syncTask } from "./sync/syncTask.js";
31
+ import { registerView } from "./view/registerView.js";
32
+ import { widgetFilters } from "./widgets/filterField.js";
19
33
  import { registerWidgets } from "./widgets/registerWidgets.js";
20
34
  import { analyticsFields, analyticsStat, analyticsStatRow, analyticsTab, analyticsTabsField } from "./fields/factories.js";
35
+ import { goalField, goalSlug } from "./goals/goalField.js";
36
+ import { GOAL_ACTION_TYPE, trackGoalAction } from "./goals/trackGoalAction.js";
21
37
  import { analyticsDefaultWidgets } from "./widgets/defaults.js";
22
38
  import { definePlugin } from "payload";
23
39
  //#region src/index.ts
40
+ /** How long a collection write waits on its cache epoch bumps, however many scopes they cover. */
41
+ const EPOCH_BUMP_DEADLINE_MS = 2e3;
42
+ /**
43
+ * Settles with `work`, or rejects once `ms` has passed. A KV that hangs rather than failing
44
+ * would otherwise hold an editor's save open for as long as it hangs; the race keeps a
45
+ * handler on `work`, so a rejection arriving after the deadline stays handled.
46
+ */
47
+ const withDeadline = async (work, ms) => {
48
+ let timer;
49
+ const deadline = new Promise((_resolve, reject) => {
50
+ timer = setTimeout(() => reject(/* @__PURE__ */ new Error(`timed out after ${ms}ms`)), ms);
51
+ });
52
+ try {
53
+ await Promise.race([work, deadline]);
54
+ } finally {
55
+ clearTimeout(timer);
56
+ }
57
+ };
24
58
  const analytics = definePlugin({
25
59
  slug: "@10x-media/analytics",
26
60
  plugin: async ({ config, plugins: _plugins, ...options }) => {
27
61
  if (options.disabled === true) return config;
28
62
  const resolved = resolveOptions(options);
63
+ const providersEnabled = resolved.providers.collection.enabled || Boolean(resolved.providers.resolve);
29
64
  const defaultLayout = config.admin?.dashboard?.defaultLayout;
30
65
  registerTranslations(config, options.translations);
31
66
  const registry = createRegistry(resolved.adapters, resolved.defaultAdapter);
@@ -35,6 +70,14 @@ const analytics = definePlugin({
35
70
  };
36
71
  let resolveRegistry = staticRegistryResolver(registry);
37
72
  let invalidateProviders = () => {};
73
+ /**
74
+ * Retires the cached reads of every scope a collection write touched. Bound at init,
75
+ * where the epoch store exists; goals defined in plugin config cannot change at
76
+ * runtime, so only the collections ever bump. A bump that fails or outlives its
77
+ * deadline is logged and swallowed: an unreachable token store must never fail or
78
+ * stall an editor's save.
79
+ */
80
+ let bumpScopes = async () => {};
38
81
  const providersResolve = resolved.providers.resolve;
39
82
  if (providersResolve) resolveRegistry = async (args) => combineRegistries(registryBase, await providersResolve({
40
83
  payload: args.payload,
@@ -66,7 +109,10 @@ const analytics = definePlugin({
66
109
  slug: resolved.providers.collection.slug,
67
110
  access: resolved.providers.collection.access,
68
111
  overrides: resolved.providers.collection.overrides,
69
- onChange: () => invalidateProviders(),
112
+ onChange: (change) => {
113
+ invalidateProviders();
114
+ return bumpScopes(change);
115
+ },
70
116
  scoped: resolved.scoped,
71
117
  scopeField: resolved.providers.collection.scopeField,
72
118
  resolveScope,
@@ -75,6 +121,25 @@ const analytics = definePlugin({
75
121
  });
76
122
  config.collections = [...config.collections ?? [], withEncryptedQueryRewrite(providersCollection)];
77
123
  }
124
+ const goalsResolver = resolved.goalsCollection.enabled ? createGoalsResolver({
125
+ slug: resolved.goalsCollection.slug,
126
+ scopeField: resolved.goalsCollection.scopeField,
127
+ scoped: resolved.scoped,
128
+ config: resolved.goals
129
+ }) : configGoalsResolver(resolved.goals);
130
+ if (resolved.goalsCollection.enabled) config.collections = [...config.collections ?? [], buildGoalsCollection({
131
+ slug: resolved.goalsCollection.slug,
132
+ access: resolved.goalsCollection.access,
133
+ overrides: resolved.goalsCollection.overrides,
134
+ onChange: (change) => {
135
+ goalsResolver.invalidate();
136
+ return bumpScopes(change);
137
+ },
138
+ scoped: resolved.scoped,
139
+ scopeField: resolved.goalsCollection.scopeField,
140
+ resolveScope,
141
+ platformRead: resolved.access.platformRead
142
+ })];
78
143
  const resolveTimezone = async (req, scope) => {
79
144
  const opt = resolved.reportingTimezone;
80
145
  if (opt === void 0) return "UTC";
@@ -92,9 +157,11 @@ const analytics = definePlugin({
92
157
  for (const adapter of resolved.adapters) adapter.register?.(config, {
93
158
  scoped: resolved.scoped,
94
159
  resolveScope,
95
- resolveTimezone
160
+ resolveTimezone,
161
+ resolveGoals: goalsResolver.resolve,
162
+ trustedProxyHops: resolved.trustedProxyHops
96
163
  });
97
- if (resolved.adapters.some((a) => a.capabilities.realtime && typeof a.realtime === "function")) config.endpoints = [...config.endpoints ?? [], {
164
+ if (resolved.adapters.some((a) => a.capabilities.realtime && typeof a.realtime === "function") || providersEnabled) config.endpoints = [...config.endpoints ?? [], {
98
165
  method: "get",
99
166
  path: REALTIME_PATH,
100
167
  handler: makeRealtimeHandler()
@@ -104,48 +171,121 @@ const analytics = definePlugin({
104
171
  path: DOCUMENT_PATH,
105
172
  handler: makeDocumentHandler()
106
173
  }];
107
- config.endpoints = [...config.endpoints ?? [], {
108
- method: "get",
109
- path: SOURCES_PATH,
110
- handler: makeSourcesHandler()
111
- }];
174
+ config.endpoints = [
175
+ ...config.endpoints ?? [],
176
+ {
177
+ method: "get",
178
+ path: SOURCES_PATH,
179
+ handler: makeSourcesHandler()
180
+ },
181
+ {
182
+ method: "get",
183
+ path: GOALS_PATH,
184
+ handler: makeGoalsHandler()
185
+ },
186
+ {
187
+ method: "get",
188
+ path: QUERY_PATH,
189
+ handler: makeQueryHandler()
190
+ },
191
+ {
192
+ method: "post",
193
+ path: REFRESH_PATH,
194
+ handler: makeRefreshHandler()
195
+ }
196
+ ];
197
+ if (resolved.adapters.some((a) => a.capture) || providersEnabled) config.endpoints = [
198
+ ...config.endpoints,
199
+ ...proxyEndpoints(),
200
+ trackerEndpoint()
201
+ ];
112
202
  if (resolved.widgets.enabled) {
113
- const multiProvider = registry.isMultiProvider() || resolved.providers.collection.enabled || Boolean(resolved.providers.resolve);
203
+ const multiProvider = registry.isMultiProvider() || providersEnabled;
114
204
  registerWidgets(config, {
115
205
  adapters: resolved.adapters,
116
206
  multiProvider,
207
+ providersEnabled,
117
208
  disabled: resolved.widgets.disabled,
118
209
  register: resolved.widgets.register,
119
210
  localizeText: resolved.widgets.localizeText,
120
- defaultId: resolved.defaultAdapter
211
+ defaultId: resolved.defaultAdapter,
212
+ comparison: resolved.widgets.comparison,
213
+ view: resolved.view === false ? false : {
214
+ path: resolved.view.path,
215
+ defaultRange: resolved.view.defaultRange,
216
+ defaultMetric: resolved.view.defaultMetric
217
+ }
121
218
  });
122
219
  }
220
+ registerView(config, {
221
+ view: resolved.view,
222
+ pluginOptions: options
223
+ });
123
224
  if (resolved.cache.warm.enabled) config.jobs = {
124
225
  ...config.jobs,
125
- tasks: [...config.jobs?.tasks ?? [], warmTask(resolved.cache.warm.cron, defaultLayout)]
226
+ tasks: [...config.jobs?.tasks ?? [], warmTask(resolved.cache.warm.cron, defaultLayout, resolved.scopes)]
126
227
  };
127
228
  if (resolved.sync.enabled) {
128
- config.collections = [...config.collections ?? [], syncCollection(resolved.sync.collectionSlug, resolved.sync.hidden)];
229
+ config.collections = [...config.collections ?? [], syncCollection(resolved.sync.collectionSlug, resolved.sync.hidden, {
230
+ scoped: resolved.scoped,
231
+ scopeField: "scope",
232
+ resolveScope,
233
+ platformRead: resolved.access.platformRead
234
+ })];
129
235
  config.jobs = {
130
236
  ...config.jobs,
131
237
  tasks: [...config.jobs?.tasks ?? [], syncTask({
132
238
  cron: resolved.sync.cron,
133
239
  lookbackDays: resolved.sync.lookbackDays,
134
240
  collectionSlug: resolved.sync.collectionSlug,
135
- adapterIds: resolved.sync.adapters
241
+ adapterIds: resolved.sync.adapters,
242
+ scopes: resolved.scopes
136
243
  })]
137
244
  };
138
245
  }
139
246
  const prevOnInit = config.onInit;
140
247
  config.onInit = async (payload) => {
248
+ if (resolved.scoped && resolved.goalsCollection.enabled) validateScopeField(payload, {
249
+ option: "goals.collection.scopeField",
250
+ slug: resolved.goalsCollection.slug,
251
+ scopeField: resolved.goalsCollection.scopeField
252
+ });
253
+ if (resolved.scoped && resolved.providers.collection.enabled) validateScopeField(payload, {
254
+ option: "providers.collection.scopeField",
255
+ slug: resolved.providers.collection.slug,
256
+ scopeField: resolved.providers.collection.scopeField
257
+ });
141
258
  if (resolved.providers.collection.enabled) {
142
259
  const { validateEncryptedBoot } = await import("@10x-media/fields/encrypted");
143
260
  await validateEncryptedBoot(payload, resolved.providers.collection.encryption?.keys);
144
261
  }
262
+ const epoch = createEpochStore(payload);
263
+ bumpScopes = async (change) => {
264
+ const scopes = new Set([change.scope]);
265
+ if (change.previousScope !== void 0) scopes.add(change.previousScope);
266
+ const bumps = [...scopes].map(async (scope) => {
267
+ try {
268
+ await epoch.bump(scope);
269
+ } catch (err) {
270
+ payload.logger?.warn(`analytics: cache epoch bump failed for scope "${scope ?? "global"}", cached reads stay until their ttl: ${String(err)}`);
271
+ }
272
+ });
273
+ try {
274
+ await withDeadline(Promise.allSettled(bumps), EPOCH_BUMP_DEADLINE_MS);
275
+ } catch (err) {
276
+ const named = [...scopes].map((scope) => `"${scope ?? "global"}"`).join(", ");
277
+ payload.logger?.warn(`analytics: cache epoch bump did not settle for ${named}, cached reads stay until their ttl: ${String(err)}`);
278
+ }
279
+ };
145
280
  const engine = createEngine({
146
281
  store: kvCacheStore(payload.kv),
147
282
  queue: { concurrency: 4 },
148
- ttl: resolved.cache.ttl
283
+ ttl: resolved.cache.ttl,
284
+ timeoutMs: resolved.cache.timeoutMs,
285
+ epoch,
286
+ onError: (err, adapterId) => {
287
+ payload.logger?.warn(`analytics: read failed for adapter "${adapterId}": ${String(err)}`);
288
+ }
149
289
  });
150
290
  setRuntime(payload, {
151
291
  registry,
@@ -153,10 +293,25 @@ const analytics = definePlugin({
153
293
  resolveScope,
154
294
  resolveTimezone,
155
295
  platformAdapterId: resolved.platformAdapter,
296
+ captureSlots: resolved.capture.slots,
297
+ capturePaths: resolved.capture.paths,
298
+ captureProxy: resolved.capture.proxy,
299
+ trustedProxyHops: resolved.trustedProxyHops,
300
+ consentFor: resolved.capture.consent,
301
+ autoCapture: resolved.capture.autoCapture,
302
+ goals: resolved.goals,
303
+ resolveGoals: goalsResolver.resolve,
304
+ resolveGoalsDetailed: goalsResolver.resolveDetailed,
305
+ ...resolved.goalsCollection.enabled ? { goalsCollectionSlug: resolved.goalsCollection.slug } : {},
306
+ ingestPath: resolved.adapters.find((a) => a.ingest)?.ingest?.path,
307
+ track: (event, opts) => trackServerEvent(payload, event, opts),
308
+ scoped: resolved.scoped,
156
309
  configAdapterIds: new Set(resolved.adapters.map((a) => a.id)),
157
310
  platformRead: resolved.access.platformRead,
311
+ readAccess: resolved.access.read,
158
312
  bindings: resolved.bindings,
159
313
  engine,
314
+ epoch,
160
315
  ttl: resolved.cache.ttl,
161
316
  comparison: resolved.widgets.comparison
162
317
  });
@@ -166,6 +321,6 @@ const analytics = definePlugin({
166
321
  }
167
322
  });
168
323
  //#endregion
169
- export { PLATFORM_SCOPE, analytics, analyticsDefaultWidgets, analyticsFields, analyticsStat, analyticsStatRow, analyticsTab, analyticsTabsField };
324
+ export { ANALYTICS_ERROR_CODES, AnalyticsTrackError, GOAL_ACTION_TYPE, PLATFORM_SCOPE, analytics, analyticsDefaultWidgets, analyticsError, analyticsFields, analyticsStat, analyticsStatRow, analyticsTab, analyticsTabsField, goalField, goalSlug, readErrorCode, trackGoalAction, trackServerEvent, widgetFilters };
170
325
 
171
326
  //# sourceMappingURL=index.js.map
package/dist/index.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"index.js","names":[],"sources":["../src/index.ts"],"sourcesContent":["import { type Config, definePlugin, type PayloadRequest } from 'payload'\n\nimport { type AnalyticsPluginOptions, resolveOptions } from './core/options'\nimport { createRegistry, staticRegistryResolver } from './core/registry'\nimport { DOCUMENT_PATH, makeDocumentHandler } from './plugin/documentEndpoint'\nimport { isModuleNotFoundError } from './plugin/peerImportError'\nimport { makeRealtimeHandler, REALTIME_PATH } from './plugin/realtimeEndpoint'\nimport { registerTranslations } from './plugin/registerTranslations'\nimport { setRuntime } from './plugin/runtime'\nimport { makeSourcesHandler, SOURCES_PATH } from './plugin/sourcesEndpoint'\nimport { warmTask } from './plugin/warmTask'\nimport type { BuildSecretField } from './providers/collection'\nimport { buildProvidersCollection } from './providers/collection'\nimport {\n\tcollectionProvidersSource,\n\tcombineRegistries,\n\tcreateScopedRegistryResolver,\n} from './providers/resolver'\nimport { kvCacheStore } from './surfacing/cacheStore'\nimport { createEngine } from './surfacing/engine'\nimport { syncCollection } from './sync/collection'\nimport { syncTask } from './sync/syncTask'\nimport { DEFAULT_TIMEZONE, isValidTimeZone } from './timeframe/tz'\nimport { registerWidgets } from './widgets/registerWidgets'\n\ndeclare module 'payload' {\n\tinterface RegisteredPlugins {\n\t\t'@10x-media/analytics': AnalyticsPluginOptions\n\t}\n}\n\nexport const analytics = definePlugin<AnalyticsPluginOptions>({\n\tslug: '@10x-media/analytics',\n\tplugin: async ({ config, plugins: _plugins, ...options }): Promise<Config> => {\n\t\tif (options.disabled === true) {\n\t\t\treturn config\n\t\t}\n\t\tconst resolved = resolveOptions(options)\n\t\tconst defaultLayout = config.admin?.dashboard?.defaultLayout\n\t\tregisterTranslations(config, options.translations)\n\t\tconst registry = createRegistry(resolved.adapters, resolved.defaultAdapter)\n\t\tconst registryBase = { adapters: resolved.adapters, defaultId: resolved.defaultAdapter }\n\t\tlet resolveRegistry = staticRegistryResolver(registry)\n\t\tlet invalidateProviders = () => {}\n\t\tconst providersResolve = resolved.providers.resolve\n\t\tif (providersResolve) {\n\t\t\tresolveRegistry = async (args) =>\n\t\t\t\tcombineRegistries(\n\t\t\t\t\tregistryBase,\n\t\t\t\t\tawait providersResolve({ payload: args.payload, req: args.req, scope: args.scope })\n\t\t\t\t)\n\t\t} else if (resolved.providers.collection.enabled) {\n\t\t\tconst scoped = createScopedRegistryResolver({\n\t\t\t\tbase: registryBase,\n\t\t\t\tsource: collectionProvidersSource(\n\t\t\t\t\tresolved.providers.collection.slug,\n\t\t\t\t\tresolved.providers.collection.scopeField\n\t\t\t\t),\n\t\t\t})\n\t\t\tresolveRegistry = scoped.resolver\n\t\t\tinvalidateProviders = scoped.invalidate\n\t\t}\n\t\tconst resolveScope = async (req: PayloadRequest) => resolved.scopeResolver({ req })\n\t\tif (resolved.providers.collection.enabled) {\n\t\t\tconst { encryptedField, withEncryptedQueryRewrite } = await import(\n\t\t\t\t'@10x-media/fields/encrypted'\n\t\t\t).catch((err: unknown) => {\n\t\t\t\tif (isModuleNotFoundError(err)) {\n\t\t\t\t\tthrow new Error(\n\t\t\t\t\t\t'analytics: providers.collection requires @10x-media/fields (peer). Install it: pnpm add @10x-media/fields'\n\t\t\t\t\t)\n\t\t\t\t}\n\t\t\t\tthrow err\n\t\t\t})\n\t\t\tconst encryption = resolved.providers.collection.encryption\n\t\t\tconst buildSecret: BuildSecretField = (source) =>\n\t\t\t\tencryptedField(source, {\n\t\t\t\t\tprotection: 'writeOnly',\n\t\t\t\t\taadScope: '10x-analytics:providers',\n\t\t\t\t\t...(source.type === 'text' ? { hint: { suffix: 4 } } : {}),\n\t\t\t\t\t...(encryption?.keys ? { keys: encryption.keys } : {}),\n\t\t\t\t})\n\t\t\tconst providersCollection = buildProvidersCollection({\n\t\t\t\tslug: resolved.providers.collection.slug,\n\t\t\t\taccess: resolved.providers.collection.access,\n\t\t\t\toverrides: resolved.providers.collection.overrides,\n\t\t\t\tonChange: () => invalidateProviders(),\n\t\t\t\tscoped: resolved.scoped,\n\t\t\t\tscopeField: resolved.providers.collection.scopeField,\n\t\t\t\tresolveScope,\n\t\t\t\tplatformRead: resolved.access.platformRead,\n\t\t\t\tbuildSecret,\n\t\t\t})\n\t\t\t// Always wrap, even though a consumer's own @10x-media/fields plugin (if\n\t\t\t// registered) may wrap this collection again later: double application is\n\t\t\t// inert here (writeOnly forbids queryable, so there are no blind-index\n\t\t\t// markers to rewrite and the response strip is an idempotent delete),\n\t\t\t// while skipping would leak ciphertext whenever fields() runs before this\n\t\t\t// collection exists (e.g. an earlier plugin `order`).\n\t\t\tconfig.collections = [\n\t\t\t\t...(config.collections ?? []),\n\t\t\t\twithEncryptedQueryRewrite(providersCollection),\n\t\t\t]\n\t\t}\n\t\tconst resolveTimezone = async (req: PayloadRequest, scope?: string | null): Promise<string> => {\n\t\t\tconst opt = resolved.reportingTimezone\n\t\t\tif (opt === undefined) {\n\t\t\t\treturn DEFAULT_TIMEZONE\n\t\t\t}\n\t\t\ttry {\n\t\t\t\tconst tz =\n\t\t\t\t\ttypeof opt === 'string'\n\t\t\t\t\t\t? opt\n\t\t\t\t\t\t: await opt({ req, scope: scope !== undefined ? scope : await resolveScope(req) })\n\t\t\t\treturn tz && isValidTimeZone(tz) ? tz : DEFAULT_TIMEZONE\n\t\t\t} catch (err) {\n\t\t\t\treq.payload?.logger?.warn?.(\n\t\t\t\t\t`analytics: reportingTimezone resolution failed, falling back to UTC: ${String(err)}`\n\t\t\t\t)\n\t\t\t\treturn DEFAULT_TIMEZONE\n\t\t\t}\n\t\t}\n\t\tfor (const adapter of resolved.adapters) {\n\t\t\tadapter.register?.(config, { scoped: resolved.scoped, resolveScope, resolveTimezone })\n\t\t}\n\t\tif (\n\t\t\tresolved.adapters.some((a) => a.capabilities.realtime && typeof a.realtime === 'function')\n\t\t) {\n\t\t\tconfig.endpoints = [\n\t\t\t\t...(config.endpoints ?? []),\n\t\t\t\t{ method: 'get', path: REALTIME_PATH, handler: makeRealtimeHandler() },\n\t\t\t]\n\t\t}\n\t\tif (Object.keys(resolved.bindings).length > 0) {\n\t\t\tconfig.endpoints = [\n\t\t\t\t...(config.endpoints ?? []),\n\t\t\t\t{ method: 'get', path: DOCUMENT_PATH, handler: makeDocumentHandler() },\n\t\t\t]\n\t\t}\n\t\tconfig.endpoints = [\n\t\t\t...(config.endpoints ?? []),\n\t\t\t{ method: 'get', path: SOURCES_PATH, handler: makeSourcesHandler() },\n\t\t]\n\t\tif (resolved.widgets.enabled) {\n\t\t\tconst multiProvider =\n\t\t\t\tregistry.isMultiProvider() ||\n\t\t\t\tresolved.providers.collection.enabled ||\n\t\t\t\tBoolean(resolved.providers.resolve)\n\t\t\tregisterWidgets(config, {\n\t\t\t\tadapters: resolved.adapters,\n\t\t\t\tmultiProvider,\n\t\t\t\tdisabled: resolved.widgets.disabled,\n\t\t\t\tregister: resolved.widgets.register,\n\t\t\t\tlocalizeText: resolved.widgets.localizeText,\n\t\t\t\tdefaultId: resolved.defaultAdapter,\n\t\t\t})\n\t\t}\n\t\tif (resolved.cache.warm.enabled) {\n\t\t\tconfig.jobs = {\n\t\t\t\t...config.jobs,\n\t\t\t\ttasks: [...(config.jobs?.tasks ?? []), warmTask(resolved.cache.warm.cron, defaultLayout)],\n\t\t\t}\n\t\t}\n\t\tif (resolved.sync.enabled) {\n\t\t\tconfig.collections = [\n\t\t\t\t...(config.collections ?? []),\n\t\t\t\tsyncCollection(resolved.sync.collectionSlug, resolved.sync.hidden),\n\t\t\t]\n\t\t\tconfig.jobs = {\n\t\t\t\t...config.jobs,\n\t\t\t\ttasks: [\n\t\t\t\t\t...(config.jobs?.tasks ?? []),\n\t\t\t\t\tsyncTask({\n\t\t\t\t\t\tcron: resolved.sync.cron,\n\t\t\t\t\t\tlookbackDays: resolved.sync.lookbackDays,\n\t\t\t\t\t\tcollectionSlug: resolved.sync.collectionSlug,\n\t\t\t\t\t\tadapterIds: resolved.sync.adapters,\n\t\t\t\t\t}),\n\t\t\t\t],\n\t\t\t}\n\t\t}\n\t\tconst prevOnInit = config.onInit\n\t\t// The runtime is installed before the app's own onInit runs so consumer init code\n\t\t// (seeding, cache warming, sync passes) can already read through the plugin.\n\t\tconfig.onInit = async (payload) => {\n\t\t\tif (resolved.providers.collection.enabled) {\n\t\t\t\tconst { validateEncryptedBoot } = await import('@10x-media/fields/encrypted')\n\t\t\t\tawait validateEncryptedBoot(payload, resolved.providers.collection.encryption?.keys)\n\t\t\t}\n\t\t\tconst engine = createEngine({\n\t\t\t\tstore: kvCacheStore(payload.kv),\n\t\t\t\tqueue: { concurrency: 4 },\n\t\t\t\tttl: resolved.cache.ttl,\n\t\t\t})\n\t\t\tsetRuntime(payload, {\n\t\t\t\tregistry,\n\t\t\t\tresolveRegistry,\n\t\t\t\tresolveScope,\n\t\t\t\tresolveTimezone,\n\t\t\t\tplatformAdapterId: resolved.platformAdapter,\n\t\t\t\tconfigAdapterIds: new Set(resolved.adapters.map((a) => a.id)),\n\t\t\t\tplatformRead: resolved.access.platformRead,\n\t\t\t\tbindings: resolved.bindings,\n\t\t\t\tengine,\n\t\t\t\tttl: resolved.cache.ttl,\n\t\t\t\tcomparison: resolved.widgets.comparison,\n\t\t\t})\n\t\t\tawait prevOnInit?.(payload)\n\t\t}\n\t\treturn config\n\t},\n})\n\nexport type {\n\tAnalyticsBinding,\n\tBindingContext,\n\tHostnameResolver,\n\tPathResolver,\n} from './binding/types'\nexport { PLATFORM_SCOPE } from './core/contract'\nexport type {\n\tAnalyticsAccessOptions,\n\tAnalyticsPluginOptions,\n\tAnalyticsPluginOptions as PluginOptions,\n\tPlatformReadAccess,\n\tProvidersCollectionOptions,\n\tProvidersOptions,\n\tProvidersResolve,\n\tScopeResolver,\n\tTimezoneResolver,\n} from './core/options'\nexport type {\n\tAnalyticsFieldsOptions,\n\tAnalyticsMetricLabel,\n\tAnalyticsMetricLabels,\n\tAnalyticsStatOptions,\n\tAnalyticsStatRowOptions,\n\tAnalyticsTabOptions,\n} from './fields/factories'\nexport {\n\tanalyticsFields,\n\tanalyticsStat,\n\tanalyticsStatRow,\n\tanalyticsTab,\n\tanalyticsTabsField,\n} from './fields/factories'\nexport type { TimeframePreset } from './timeframe/presets'\nexport type { CustomWidgetDef } from './widgets/customWidget'\nexport { analyticsDefaultWidgets } from './widgets/defaults'\n"],"mappings":"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"}
1
+ {"version":3,"file":"index.js","names":[],"sources":["../src/index.ts"],"sourcesContent":["import { type Config, definePlugin, type PayloadRequest } from 'payload'\n\nimport { proxyEndpoints } from './capture/proxyEndpoint'\nimport { trackerEndpoint } from './capture/trackerEndpoint'\nimport { type AnalyticsPluginOptions, resolveOptions } from './core/options'\nimport { createRegistry, staticRegistryResolver } from './core/registry'\nimport { buildGoalsCollection } from './goals/collection'\nimport { GOALS_PATH, makeGoalsHandler } from './goals/goalsEndpoint'\nimport { configGoalsResolver, createGoalsResolver } from './goals/resolver'\nimport { trackServerEvent } from './native/ingest/serverTrack'\nimport { DOCUMENT_PATH, makeDocumentHandler } from './plugin/documentEndpoint'\nimport { isModuleNotFoundError } from './plugin/peerImportError'\nimport { makeQueryHandler, QUERY_PATH } from './plugin/queryEndpoint'\nimport { makeRealtimeHandler, REALTIME_PATH } from './plugin/realtimeEndpoint'\nimport { makeRefreshHandler, REFRESH_PATH } from './plugin/refreshEndpoint'\nimport { registerTranslations } from './plugin/registerTranslations'\nimport { setRuntime } from './plugin/runtime'\nimport type { ScopeChange } from './plugin/scopeChange'\nimport { validateScopeField } from './plugin/scopeFieldBoot'\nimport { makeSourcesHandler, SOURCES_PATH } from './plugin/sourcesEndpoint'\nimport { warmTask } from './plugin/warmTask'\nimport type { BuildSecretField } from './providers/collection'\nimport { buildProvidersCollection } from './providers/collection'\nimport {\n\tcollectionProvidersSource,\n\tcombineRegistries,\n\tcreateScopedRegistryResolver,\n} from './providers/resolver'\nimport { kvCacheStore } from './surfacing/cacheStore'\nimport { createEngine } from './surfacing/engine'\nimport { createEpochStore } from './surfacing/epoch'\nimport { syncCollection } from './sync/collection'\nimport { syncTask } from './sync/syncTask'\nimport { DEFAULT_TIMEZONE, isValidTimeZone } from './timeframe/tz'\nimport { registerView } from './view/registerView'\nimport { registerWidgets } from './widgets/registerWidgets'\n\ndeclare module 'payload' {\n\tinterface RegisteredPlugins {\n\t\t'@10x-media/analytics': AnalyticsPluginOptions\n\t}\n}\n\n/** How long a collection write waits on its cache epoch bumps, however many scopes they cover. */\nconst EPOCH_BUMP_DEADLINE_MS = 2_000\n\n/**\n * Settles with `work`, or rejects once `ms` has passed. A KV that hangs rather than failing\n * would otherwise hold an editor's save open for as long as it hangs; the race keeps a\n * handler on `work`, so a rejection arriving after the deadline stays handled.\n */\nconst withDeadline = async (work: Promise<unknown>, ms: number): Promise<void> => {\n\tlet timer: ReturnType<typeof setTimeout> | undefined\n\tconst deadline = new Promise<never>((_resolve, reject) => {\n\t\ttimer = setTimeout(() => reject(new Error(`timed out after ${ms}ms`)), ms)\n\t})\n\ttry {\n\t\tawait Promise.race([work, deadline])\n\t} finally {\n\t\tclearTimeout(timer)\n\t}\n}\n\nexport const analytics = definePlugin<AnalyticsPluginOptions>({\n\tslug: '@10x-media/analytics',\n\tplugin: async ({ config, plugins: _plugins, ...options }): Promise<Config> => {\n\t\tif (options.disabled === true) {\n\t\t\treturn config\n\t\t}\n\t\tconst resolved = resolveOptions(options)\n\t\t// A tenant's own runtime adapter (providers.collection or providers.resolve) has\n\t\t// capabilities unknown at config time, so it opens the widget/endpoint gates that\n\t\t// otherwise key off the config-adapter capability union.\n\t\tconst providersEnabled =\n\t\t\tresolved.providers.collection.enabled || Boolean(resolved.providers.resolve)\n\t\tconst defaultLayout = config.admin?.dashboard?.defaultLayout\n\t\tregisterTranslations(config, options.translations)\n\t\tconst registry = createRegistry(resolved.adapters, resolved.defaultAdapter)\n\t\tconst registryBase = { adapters: resolved.adapters, defaultId: resolved.defaultAdapter }\n\t\tlet resolveRegistry = staticRegistryResolver(registry)\n\t\tlet invalidateProviders = () => {}\n\t\t/**\n\t\t * Retires the cached reads of every scope a collection write touched. Bound at init,\n\t\t * where the epoch store exists; goals defined in plugin config cannot change at\n\t\t * runtime, so only the collections ever bump. A bump that fails or outlives its\n\t\t * deadline is logged and swallowed: an unreachable token store must never fail or\n\t\t * stall an editor's save.\n\t\t */\n\t\tlet bumpScopes: (change: ScopeChange) => Promise<void> = async () => {}\n\t\tconst providersResolve = resolved.providers.resolve\n\t\tif (providersResolve) {\n\t\t\tresolveRegistry = async (args) =>\n\t\t\t\tcombineRegistries(\n\t\t\t\t\tregistryBase,\n\t\t\t\t\tawait providersResolve({ payload: args.payload, req: args.req, scope: args.scope })\n\t\t\t\t)\n\t\t} else if (resolved.providers.collection.enabled) {\n\t\t\tconst scoped = createScopedRegistryResolver({\n\t\t\t\tbase: registryBase,\n\t\t\t\tsource: collectionProvidersSource(\n\t\t\t\t\tresolved.providers.collection.slug,\n\t\t\t\t\tresolved.providers.collection.scopeField\n\t\t\t\t),\n\t\t\t})\n\t\t\tresolveRegistry = scoped.resolver\n\t\t\tinvalidateProviders = scoped.invalidate\n\t\t}\n\t\tconst resolveScope = async (req: PayloadRequest) => resolved.scopeResolver({ req })\n\t\tif (resolved.providers.collection.enabled) {\n\t\t\tconst { encryptedField, withEncryptedQueryRewrite } = await import(\n\t\t\t\t'@10x-media/fields/encrypted'\n\t\t\t).catch((err: unknown) => {\n\t\t\t\tif (isModuleNotFoundError(err)) {\n\t\t\t\t\tthrow new Error(\n\t\t\t\t\t\t'analytics: providers.collection requires @10x-media/fields (peer). Install it: pnpm add @10x-media/fields'\n\t\t\t\t\t)\n\t\t\t\t}\n\t\t\t\tthrow err\n\t\t\t})\n\t\t\tconst encryption = resolved.providers.collection.encryption\n\t\t\tconst buildSecret: BuildSecretField = (source) =>\n\t\t\t\tencryptedField(source, {\n\t\t\t\t\tprotection: 'writeOnly',\n\t\t\t\t\taadScope: '10x-analytics:providers',\n\t\t\t\t\t...(source.type === 'text' ? { hint: { suffix: 4 } } : {}),\n\t\t\t\t\t...(encryption?.keys ? { keys: encryption.keys } : {}),\n\t\t\t\t})\n\t\t\tconst providersCollection = buildProvidersCollection({\n\t\t\t\tslug: resolved.providers.collection.slug,\n\t\t\t\taccess: resolved.providers.collection.access,\n\t\t\t\toverrides: resolved.providers.collection.overrides,\n\t\t\t\tonChange: (change) => {\n\t\t\t\t\tinvalidateProviders()\n\t\t\t\t\treturn bumpScopes(change)\n\t\t\t\t},\n\t\t\t\tscoped: resolved.scoped,\n\t\t\t\tscopeField: resolved.providers.collection.scopeField,\n\t\t\t\tresolveScope,\n\t\t\t\tplatformRead: resolved.access.platformRead,\n\t\t\t\tbuildSecret,\n\t\t\t})\n\t\t\t// Always wrap, even though a consumer's own @10x-media/fields plugin (if\n\t\t\t// registered) may wrap this collection again later: double application is\n\t\t\t// inert here (writeOnly forbids queryable, so there are no blind-index\n\t\t\t// markers to rewrite and the response strip is an idempotent delete),\n\t\t\t// while skipping would leak ciphertext whenever fields() runs before this\n\t\t\t// collection exists (e.g. an earlier plugin `order`).\n\t\t\tconfig.collections = [\n\t\t\t\t...(config.collections ?? []),\n\t\t\t\twithEncryptedQueryRewrite(providersCollection),\n\t\t\t]\n\t\t}\n\t\t// Config goals are install-wide; the collection resolves per scope and merges over\n\t\t// them behind the same signature, so ingest and the tracker config read one source.\n\t\tconst goalsResolver = resolved.goalsCollection.enabled\n\t\t\t? createGoalsResolver({\n\t\t\t\t\tslug: resolved.goalsCollection.slug,\n\t\t\t\t\tscopeField: resolved.goalsCollection.scopeField,\n\t\t\t\t\tscoped: resolved.scoped,\n\t\t\t\t\tconfig: resolved.goals,\n\t\t\t\t})\n\t\t\t: configGoalsResolver(resolved.goals)\n\t\tif (resolved.goalsCollection.enabled) {\n\t\t\tconfig.collections = [\n\t\t\t\t...(config.collections ?? []),\n\t\t\t\tbuildGoalsCollection({\n\t\t\t\t\tslug: resolved.goalsCollection.slug,\n\t\t\t\t\taccess: resolved.goalsCollection.access,\n\t\t\t\t\toverrides: resolved.goalsCollection.overrides,\n\t\t\t\t\tonChange: (change) => {\n\t\t\t\t\t\tgoalsResolver.invalidate()\n\t\t\t\t\t\treturn bumpScopes(change)\n\t\t\t\t\t},\n\t\t\t\t\tscoped: resolved.scoped,\n\t\t\t\t\tscopeField: resolved.goalsCollection.scopeField,\n\t\t\t\t\tresolveScope,\n\t\t\t\t\tplatformRead: resolved.access.platformRead,\n\t\t\t\t}),\n\t\t\t]\n\t\t}\n\t\tconst resolveTimezone = async (req: PayloadRequest, scope?: string | null): Promise<string> => {\n\t\t\tconst opt = resolved.reportingTimezone\n\t\t\tif (opt === undefined) {\n\t\t\t\treturn DEFAULT_TIMEZONE\n\t\t\t}\n\t\t\ttry {\n\t\t\t\tconst tz =\n\t\t\t\t\ttypeof opt === 'string'\n\t\t\t\t\t\t? opt\n\t\t\t\t\t\t: await opt({ req, scope: scope !== undefined ? scope : await resolveScope(req) })\n\t\t\t\treturn tz && isValidTimeZone(tz) ? tz : DEFAULT_TIMEZONE\n\t\t\t} catch (err) {\n\t\t\t\treq.payload?.logger?.warn?.(\n\t\t\t\t\t`analytics: reportingTimezone resolution failed, falling back to UTC: ${String(err)}`\n\t\t\t\t)\n\t\t\t\treturn DEFAULT_TIMEZONE\n\t\t\t}\n\t\t}\n\t\tfor (const adapter of resolved.adapters) {\n\t\t\tadapter.register?.(config, {\n\t\t\t\tscoped: resolved.scoped,\n\t\t\t\tresolveScope,\n\t\t\t\tresolveTimezone,\n\t\t\t\tresolveGoals: goalsResolver.resolve,\n\t\t\t\ttrustedProxyHops: resolved.trustedProxyHops,\n\t\t\t})\n\t\t}\n\t\tif (\n\t\t\tresolved.adapters.some((a) => a.capabilities.realtime && typeof a.realtime === 'function') ||\n\t\t\tprovidersEnabled\n\t\t) {\n\t\t\tconfig.endpoints = [\n\t\t\t\t...(config.endpoints ?? []),\n\t\t\t\t{ method: 'get', path: REALTIME_PATH, handler: makeRealtimeHandler() },\n\t\t\t]\n\t\t}\n\t\tif (Object.keys(resolved.bindings).length > 0) {\n\t\t\tconfig.endpoints = [\n\t\t\t\t...(config.endpoints ?? []),\n\t\t\t\t{ method: 'get', path: DOCUMENT_PATH, handler: makeDocumentHandler() },\n\t\t\t]\n\t\t}\n\t\tconfig.endpoints = [\n\t\t\t...(config.endpoints ?? []),\n\t\t\t{ method: 'get', path: SOURCES_PATH, handler: makeSourcesHandler() },\n\t\t\t{ method: 'get', path: GOALS_PATH, handler: makeGoalsHandler() },\n\t\t\t{ method: 'get', path: QUERY_PATH, handler: makeQueryHandler() },\n\t\t\t{ method: 'post', path: REFRESH_PATH, handler: makeRefreshHandler() },\n\t\t]\n\t\t// A runtime provider's capture support is unknown at config time, so providers\n\t\t// alone are enough to mount the proxy; every slot is still resolved per request.\n\t\tif (resolved.adapters.some((a) => a.capture) || providersEnabled) {\n\t\t\tconfig.endpoints = [...config.endpoints, ...proxyEndpoints(), trackerEndpoint()]\n\t\t}\n\t\tif (resolved.widgets.enabled) {\n\t\t\tconst multiProvider = registry.isMultiProvider() || providersEnabled\n\t\t\tregisterWidgets(config, {\n\t\t\t\tadapters: resolved.adapters,\n\t\t\t\tmultiProvider,\n\t\t\t\tprovidersEnabled,\n\t\t\t\tdisabled: resolved.widgets.disabled,\n\t\t\t\tregister: resolved.widgets.register,\n\t\t\t\tlocalizeText: resolved.widgets.localizeText,\n\t\t\t\tdefaultId: resolved.defaultAdapter,\n\t\t\t\tcomparison: resolved.widgets.comparison,\n\t\t\t\tview:\n\t\t\t\t\tresolved.view === false\n\t\t\t\t\t\t? false\n\t\t\t\t\t\t: {\n\t\t\t\t\t\t\t\tpath: resolved.view.path,\n\t\t\t\t\t\t\t\tdefaultRange: resolved.view.defaultRange,\n\t\t\t\t\t\t\t\tdefaultMetric: resolved.view.defaultMetric,\n\t\t\t\t\t\t\t},\n\t\t\t})\n\t\t}\n\t\tregisterView(config, { view: resolved.view, pluginOptions: options })\n\t\tif (resolved.cache.warm.enabled) {\n\t\t\tconfig.jobs = {\n\t\t\t\t...config.jobs,\n\t\t\t\ttasks: [\n\t\t\t\t\t...(config.jobs?.tasks ?? []),\n\t\t\t\t\twarmTask(resolved.cache.warm.cron, defaultLayout, resolved.scopes),\n\t\t\t\t],\n\t\t\t}\n\t\t}\n\t\tif (resolved.sync.enabled) {\n\t\t\tconfig.collections = [\n\t\t\t\t...(config.collections ?? []),\n\t\t\t\tsyncCollection(resolved.sync.collectionSlug, resolved.sync.hidden, {\n\t\t\t\t\tscoped: resolved.scoped,\n\t\t\t\t\tscopeField: 'scope',\n\t\t\t\t\tresolveScope,\n\t\t\t\t\tplatformRead: resolved.access.platformRead,\n\t\t\t\t}),\n\t\t\t]\n\t\t\tconfig.jobs = {\n\t\t\t\t...config.jobs,\n\t\t\t\ttasks: [\n\t\t\t\t\t...(config.jobs?.tasks ?? []),\n\t\t\t\t\tsyncTask({\n\t\t\t\t\t\tcron: resolved.sync.cron,\n\t\t\t\t\t\tlookbackDays: resolved.sync.lookbackDays,\n\t\t\t\t\t\tcollectionSlug: resolved.sync.collectionSlug,\n\t\t\t\t\t\tadapterIds: resolved.sync.adapters,\n\t\t\t\t\t\tscopes: resolved.scopes,\n\t\t\t\t\t}),\n\t\t\t\t],\n\t\t\t}\n\t\t}\n\t\tconst prevOnInit = config.onInit\n\t\t// The runtime is installed before the app's own onInit runs so consumer init code\n\t\t// (seeding, cache warming, sync passes) can already read through the plugin.\n\t\tconfig.onInit = async (payload) => {\n\t\t\t// Host-owned scope fields only exist once every plugin has run, so the collections\n\t\t\t// are checked against the assembled config rather than at config time.\n\t\t\tif (resolved.scoped && resolved.goalsCollection.enabled) {\n\t\t\t\tvalidateScopeField(payload, {\n\t\t\t\t\toption: 'goals.collection.scopeField',\n\t\t\t\t\tslug: resolved.goalsCollection.slug,\n\t\t\t\t\tscopeField: resolved.goalsCollection.scopeField,\n\t\t\t\t})\n\t\t\t}\n\t\t\tif (resolved.scoped && resolved.providers.collection.enabled) {\n\t\t\t\tvalidateScopeField(payload, {\n\t\t\t\t\toption: 'providers.collection.scopeField',\n\t\t\t\t\tslug: resolved.providers.collection.slug,\n\t\t\t\t\tscopeField: resolved.providers.collection.scopeField,\n\t\t\t\t})\n\t\t\t}\n\t\t\tif (resolved.providers.collection.enabled) {\n\t\t\t\tconst { validateEncryptedBoot } = await import('@10x-media/fields/encrypted')\n\t\t\t\tawait validateEncryptedBoot(payload, resolved.providers.collection.encryption?.keys)\n\t\t\t}\n\t\t\tconst epoch = createEpochStore(payload)\n\t\t\tbumpScopes = async (change) => {\n\t\t\t\tconst scopes = new Set<string | null>([change.scope])\n\t\t\t\tif (change.previousScope !== undefined) {\n\t\t\t\t\tscopes.add(change.previousScope)\n\t\t\t\t}\n\t\t\t\tconst bumps = [...scopes].map(async (scope) => {\n\t\t\t\t\ttry {\n\t\t\t\t\t\tawait epoch.bump(scope)\n\t\t\t\t\t} catch (err) {\n\t\t\t\t\t\tpayload.logger?.warn(\n\t\t\t\t\t\t\t`analytics: cache epoch bump failed for scope \"${scope ?? 'global'}\", cached reads stay until their ttl: ${String(err)}`\n\t\t\t\t\t\t)\n\t\t\t\t\t}\n\t\t\t\t})\n\t\t\t\t// One deadline covers every scope a save touches: a document moving between two\n\t\t\t\t// of them must not be able to hold the write open for one deadline each.\n\t\t\t\ttry {\n\t\t\t\t\tawait withDeadline(Promise.allSettled(bumps), EPOCH_BUMP_DEADLINE_MS)\n\t\t\t\t} catch (err) {\n\t\t\t\t\tconst named = [...scopes].map((scope) => `\"${scope ?? 'global'}\"`).join(', ')\n\t\t\t\t\tpayload.logger?.warn(\n\t\t\t\t\t\t`analytics: cache epoch bump did not settle for ${named}, cached reads stay until their ttl: ${String(err)}`\n\t\t\t\t\t)\n\t\t\t\t}\n\t\t\t}\n\t\t\tconst engine = createEngine({\n\t\t\t\tstore: kvCacheStore(payload.kv),\n\t\t\t\tqueue: { concurrency: 4 },\n\t\t\t\tttl: resolved.cache.ttl,\n\t\t\t\ttimeoutMs: resolved.cache.timeoutMs,\n\t\t\t\tepoch,\n\t\t\t\tonError: (err, adapterId) => {\n\t\t\t\t\tpayload.logger?.warn(`analytics: read failed for adapter \"${adapterId}\": ${String(err)}`)\n\t\t\t\t},\n\t\t\t})\n\t\t\tsetRuntime(payload, {\n\t\t\t\tregistry,\n\t\t\t\tresolveRegistry,\n\t\t\t\tresolveScope,\n\t\t\t\tresolveTimezone,\n\t\t\t\tplatformAdapterId: resolved.platformAdapter,\n\t\t\t\tcaptureSlots: resolved.capture.slots,\n\t\t\t\tcapturePaths: resolved.capture.paths,\n\t\t\t\tcaptureProxy: resolved.capture.proxy,\n\t\t\t\ttrustedProxyHops: resolved.trustedProxyHops,\n\t\t\t\tconsentFor: resolved.capture.consent,\n\t\t\t\tautoCapture: resolved.capture.autoCapture,\n\t\t\t\tgoals: resolved.goals,\n\t\t\t\tresolveGoals: goalsResolver.resolve,\n\t\t\t\tresolveGoalsDetailed: goalsResolver.resolveDetailed,\n\t\t\t\t...(resolved.goalsCollection.enabled\n\t\t\t\t\t? { goalsCollectionSlug: resolved.goalsCollection.slug }\n\t\t\t\t\t: {}),\n\t\t\t\tingestPath: resolved.adapters.find((a) => a.ingest)?.ingest?.path,\n\t\t\t\ttrack: (event, opts) => trackServerEvent(payload, event, opts),\n\t\t\t\tscoped: resolved.scoped,\n\t\t\t\tconfigAdapterIds: new Set(resolved.adapters.map((a) => a.id)),\n\t\t\t\tplatformRead: resolved.access.platformRead,\n\t\t\t\treadAccess: resolved.access.read,\n\t\t\t\tbindings: resolved.bindings,\n\t\t\t\tengine,\n\t\t\t\tepoch,\n\t\t\t\tttl: resolved.cache.ttl,\n\t\t\t\tcomparison: resolved.widgets.comparison,\n\t\t\t})\n\t\t\tawait prevOnInit?.(payload)\n\t\t}\n\t\treturn config\n\t},\n})\n\nexport type {\n\tAnalyticsBinding,\n\tBindingContext,\n\tHostnameResolver,\n\tPathResolver,\n} from './binding/types'\nexport { PLATFORM_SCOPE } from './core/contract'\nexport type {\n\tAnalyticsAccessOptions,\n\tAnalyticsCaptureOptions,\n\tAnalyticsGoalsCollectionOptions,\n\tAnalyticsGoalsOptions,\n\tAnalyticsPluginOptions,\n\tAnalyticsPluginOptions as PluginOptions,\n\tAnalyticsReadAccess,\n\tAnalyticsViewAccess,\n\tAnalyticsViewOptions,\n\tAutoCaptureOptions,\n\tCaptureConsentOption,\n\tConsentMode,\n\tConsentResolver,\n\tPlatformReadAccess,\n\tProvidersCollectionOptions,\n\tProvidersOptions,\n\tProvidersResolve,\n\tScopeResolver,\n\tScopesResolver,\n\tTimezoneResolver,\n} from './core/options'\nexport type { ServerEventInput, ServerTrack, ServerTrackOptions } from './core/serverEvent'\nexport { AnalyticsTrackError } from './core/serverEvent'\nexport type {\n\tAnalyticsFieldsOptions,\n\tAnalyticsMetricLabel,\n\tAnalyticsMetricLabels,\n\tAnalyticsStatOptions,\n\tAnalyticsStatRowOptions,\n\tAnalyticsTabOptions,\n} from './fields/factories'\nexport {\n\tanalyticsFields,\n\tanalyticsStat,\n\tanalyticsStatRow,\n\tanalyticsTab,\n\tanalyticsTabsField,\n} from './fields/factories'\nexport type { GoalFieldOptions } from './goals/goalField'\nexport { goalField, goalSlug } from './goals/goalField'\nexport type { GoalsResponse, WireGoal } from './goals/goalsEndpoint'\nexport type {\n\tGoalActionDefinition,\n\tGoalActionRunArgs,\n\tTrackGoalActionOptions,\n} from './goals/trackGoalAction'\nexport { GOAL_ACTION_TYPE, trackGoalAction } from './goals/trackGoalAction'\nexport type { Goal, GoalMatch, TrackerGoal } from './goals/types'\nexport { trackServerEvent } from './native/ingest/serverTrack'\nexport {\n\tANALYTICS_ERROR_CODES,\n\ttype AnalyticsError,\n\ttype AnalyticsErrorCode,\n\tanalyticsError,\n\treadErrorCode,\n} from './plugin/errors'\nexport type { QueryError, QueryErrorCode } from './query/errors'\nexport type {\n\tQueryErrorResponse,\n\tQueryResponse,\n\tQuerySourceRef,\n\tSerializedAnalyticsQuery,\n} from './query/response'\nexport type { TimeframePreset } from './timeframe/presets'\nexport type { CustomWidgetDef } from './widgets/customWidget'\nexport { analyticsDefaultWidgets } from './widgets/defaults'\nexport { widgetFilters } from './widgets/filterField'\nexport type { WidgetFilter } from './widgets/types'\n"],"mappings":"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"}