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

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 (515) hide show
  1. package/CHANGELOG.md +270 -0
  2. package/LICENSE +21 -21
  3. package/README.md +15 -4
  4. package/dist/adapters/ga4/disableKey.d.ts +9 -0
  5. package/dist/adapters/ga4/disableKey.js +21 -0
  6. package/dist/adapters/ga4/disableKey.js.map +1 -0
  7. package/dist/adapters/ga4/eventName.d.ts +15 -0
  8. package/dist/adapters/ga4/eventName.js +19 -0
  9. package/dist/adapters/ga4/eventName.js.map +1 -0
  10. package/dist/adapters/ga4/ga4.d.ts +5 -0
  11. package/dist/adapters/ga4/ga4.js +186 -58
  12. package/dist/adapters/ga4/ga4.js.map +1 -1
  13. package/dist/adapters/ga4/measurementId.js +15 -0
  14. package/dist/adapters/ga4/measurementId.js.map +1 -0
  15. package/dist/adapters/goalRead.js +126 -0
  16. package/dist/adapters/goalRead.js.map +1 -0
  17. package/dist/adapters/http/fetchJson.js +1 -1
  18. package/dist/adapters/plausible/plausible.d.ts +25 -0
  19. package/dist/adapters/plausible/plausible.js +159 -38
  20. package/dist/adapters/plausible/plausible.js.map +1 -1
  21. package/dist/adapters/posthog/posthog.d.ts +10 -1
  22. package/dist/adapters/posthog/posthog.js +130 -21
  23. package/dist/adapters/posthog/posthog.js.map +1 -1
  24. package/dist/adapters/series.js +11 -1
  25. package/dist/adapters/series.js.map +1 -1
  26. package/dist/adapters/umami/umami.d.ts +13 -1
  27. package/dist/adapters/umami/umami.js +278 -26
  28. package/dist/adapters/umami/umami.js.map +1 -1
  29. package/dist/binding/resolvePath.js +18 -2
  30. package/dist/binding/resolvePath.js.map +1 -1
  31. package/dist/capture/getTrackerConfig.d.ts +20 -0
  32. package/dist/capture/getTrackerConfig.js +31 -0
  33. package/dist/capture/getTrackerConfig.js.map +1 -0
  34. package/dist/capture/mountPath.js +14 -0
  35. package/dist/capture/mountPath.js.map +1 -0
  36. package/dist/capture/proxyEndpoint.js +127 -0
  37. package/dist/capture/proxyEndpoint.js.map +1 -0
  38. package/dist/capture/proxyRoutes.js +108 -0
  39. package/dist/capture/proxyRoutes.js.map +1 -0
  40. package/dist/capture/requestBody.js +68 -0
  41. package/dist/capture/requestBody.js.map +1 -0
  42. package/dist/capture/slots.d.ts +8 -0
  43. package/dist/capture/slots.js +54 -0
  44. package/dist/capture/slots.js.map +1 -0
  45. package/dist/capture/trackerConfig.d.ts +33 -0
  46. package/dist/capture/trackerConfig.js +95 -0
  47. package/dist/capture/trackerConfig.js.map +1 -0
  48. package/dist/capture/trackerEndpoint.js +35 -0
  49. package/dist/capture/trackerEndpoint.js.map +1 -0
  50. package/dist/charts/BarList.d.ts +16 -1
  51. package/dist/charts/BarList.js +41 -19
  52. package/dist/charts/BarList.js.map +1 -1
  53. package/dist/charts/TrendChart.d.ts +16 -3
  54. package/dist/charts/TrendChart.js +172 -106
  55. package/dist/charts/TrendChart.js.map +1 -1
  56. package/dist/charts/bars.d.ts +4 -0
  57. package/dist/charts/bars.js +3 -1
  58. package/dist/charts/bars.js.map +1 -1
  59. package/dist/charts/bucket.js +10 -1
  60. package/dist/charts/bucket.js.map +1 -1
  61. package/dist/charts/spline.js +2 -2
  62. package/dist/charts/spline.js.map +1 -1
  63. package/dist/charts/styles.js +18 -1
  64. package/dist/charts/styles.js.map +1 -1
  65. package/dist/core/cacheKey.js +26 -3
  66. package/dist/core/cacheKey.js.map +1 -1
  67. package/dist/core/capabilities.d.ts +5 -1
  68. package/dist/core/capabilities.js +11 -2
  69. package/dist/core/capabilities.js.map +1 -1
  70. package/dist/core/capture.d.ts +49 -0
  71. package/dist/core/contract.d.ts +74 -5
  72. package/dist/core/contract.js +30 -1
  73. package/dist/core/contract.js.map +1 -1
  74. package/dist/core/granularity.js +1 -1
  75. package/dist/core/options.d.ts +164 -6
  76. package/dist/core/options.js +126 -3
  77. package/dist/core/options.js.map +1 -1
  78. package/dist/core/registry.d.ts +1 -0
  79. package/dist/core/scopeList.js +32 -0
  80. package/dist/core/scopeList.js.map +1 -0
  81. package/dist/core/scopedRead.js +101 -30
  82. package/dist/core/scopedRead.js.map +1 -1
  83. package/dist/core/serverEvent.d.ts +60 -0
  84. package/dist/core/serverEvent.js +12 -0
  85. package/dist/core/serverEvent.js.map +1 -0
  86. package/dist/exports/adapters/ga4.d.ts +2 -1
  87. package/dist/exports/adapters/ga4.js +2 -1
  88. package/dist/exports/adapters/native.d.ts +3 -1
  89. package/dist/exports/adapters/native.js +2 -1
  90. package/dist/exports/client.d.ts +13 -3
  91. package/dist/exports/client.js +10 -1
  92. package/dist/exports/geo.d.ts +2 -2
  93. package/dist/exports/next.d.ts +2 -1
  94. package/dist/exports/next.js +2 -1
  95. package/dist/exports/react.d.ts +4 -0
  96. package/dist/exports/react.js +5 -0
  97. package/dist/exports/rsc.d.ts +11 -3
  98. package/dist/exports/rsc.js +7 -2
  99. package/dist/exports/tracker.d.ts +21 -0
  100. package/dist/exports/tracker.js +15 -0
  101. package/dist/exports/types.d.ts +16 -3
  102. package/dist/exports/types.js +4 -2
  103. package/dist/fields/AnalyticsPanelClient.js +2 -2
  104. package/dist/fields/AnalyticsPanelField.js +1 -1
  105. package/dist/fields/AnalyticsStatField.js +2 -2
  106. package/dist/fields/config/FilterDimensionSelectField.d.ts +14 -0
  107. package/dist/fields/config/FilterDimensionSelectField.js +77 -0
  108. package/dist/fields/config/FilterDimensionSelectField.js.map +1 -0
  109. package/dist/fields/config/FilterOperatorSelectField.d.ts +14 -0
  110. package/dist/fields/config/FilterOperatorSelectField.js +75 -0
  111. package/dist/fields/config/FilterOperatorSelectField.js.map +1 -0
  112. package/dist/fields/config/MetricSelectField.js +3 -3
  113. package/dist/fields/config/MetricSelectField.js.map +1 -1
  114. package/dist/fields/config/SourceSelectField.js +3 -3
  115. package/dist/fields/config/SourceSelectField.js.map +1 -1
  116. package/dist/fields/config/fetchSources.d.ts +5 -1
  117. package/dist/fields/config/fetchSources.js +7 -3
  118. package/dist/fields/config/fetchSources.js.map +1 -1
  119. package/dist/fields/config/narrow.js +2 -0
  120. package/dist/fields/config/narrow.js.map +1 -1
  121. package/dist/fields/config/sourcesState.js +19 -3
  122. package/dist/fields/config/sourcesState.js.map +1 -1
  123. package/dist/fields/config/useAnalyticsSources.d.ts +8 -3
  124. package/dist/fields/config/useAnalyticsSources.js +9 -6
  125. package/dist/fields/config/useAnalyticsSources.js.map +1 -1
  126. package/dist/fields/config/useFilterCapabilities.d.ts +28 -0
  127. package/dist/fields/config/useFilterCapabilities.js +52 -0
  128. package/dist/fields/config/useFilterCapabilities.js.map +1 -0
  129. package/dist/fields/readForDocument.d.ts +5 -0
  130. package/dist/fields/readForDocument.js +22 -10
  131. package/dist/fields/readForDocument.js.map +1 -1
  132. package/dist/goals/GoalSelectField.d.ts +7 -0
  133. package/dist/goals/GoalSelectField.js +77 -0
  134. package/dist/goals/GoalSelectField.js.map +1 -0
  135. package/dist/goals/collection.js +254 -0
  136. package/dist/goals/collection.js.map +1 -0
  137. package/dist/goals/currency.js +14 -0
  138. package/dist/goals/currency.js.map +1 -0
  139. package/dist/goals/fetchGoals.d.ts +18 -0
  140. package/dist/goals/fetchGoals.js +33 -0
  141. package/dist/goals/fetchGoals.js.map +1 -0
  142. package/dist/goals/goalField.d.ts +31 -0
  143. package/dist/goals/goalField.js +56 -0
  144. package/dist/goals/goalField.js.map +1 -0
  145. package/dist/goals/goalsEndpoint.d.ts +1 -0
  146. package/dist/goals/goalsEndpoint.js +58 -0
  147. package/dist/goals/goalsEndpoint.js.map +1 -0
  148. package/dist/goals/match.js +64 -0
  149. package/dist/goals/match.js.map +1 -0
  150. package/dist/goals/resolver.d.ts +8 -0
  151. package/dist/goals/resolver.js +147 -0
  152. package/dist/goals/resolver.js.map +1 -0
  153. package/dist/goals/trackGoalAction.d.ts +76 -0
  154. package/dist/goals/trackGoalAction.js +158 -0
  155. package/dist/goals/trackGoalAction.js.map +1 -0
  156. package/dist/goals/types.d.ts +33 -0
  157. package/dist/goals/types.js +7 -0
  158. package/dist/goals/types.js.map +1 -0
  159. package/dist/goals/useAnalyticsGoals.d.ts +20 -0
  160. package/dist/goals/useAnalyticsGoals.js +67 -0
  161. package/dist/goals/useAnalyticsGoals.js.map +1 -0
  162. package/dist/index.d.ts +14 -3
  163. package/dist/index.js +174 -19
  164. package/dist/index.js.map +1 -1
  165. package/dist/native/collections/events.js +65 -1
  166. package/dist/native/collections/events.js.map +1 -1
  167. package/dist/native/collections/rollups.js +39 -3
  168. package/dist/native/collections/rollups.js.map +1 -1
  169. package/dist/native/eventScan.js +25 -0
  170. package/dist/native/eventScan.js.map +1 -0
  171. package/dist/native/geo/composeGeoResolvers.js +2 -2
  172. package/dist/native/geo/composeGeoResolvers.js.map +1 -1
  173. package/dist/native/geo/geoResolver.d.ts +9 -2
  174. package/dist/native/geo/geoResolver.js.map +1 -1
  175. package/dist/native/geo/maxmindResolver.js +3 -5
  176. package/dist/native/geo/maxmindResolver.js.map +1 -1
  177. package/dist/native/ingest/bots.d.ts +11 -0
  178. package/dist/native/ingest/bots.js +71 -0
  179. package/dist/native/ingest/bots.js.map +1 -0
  180. package/dist/native/ingest/browser.js +47 -0
  181. package/dist/native/ingest/browser.js.map +1 -0
  182. package/dist/native/ingest/clientIp.js +20 -0
  183. package/dist/native/ingest/clientIp.js.map +1 -0
  184. package/dist/native/ingest/device.js +11 -3
  185. package/dist/native/ingest/device.js.map +1 -1
  186. package/dist/native/ingest/endpoint.d.ts +1 -0
  187. package/dist/native/ingest/endpoint.js +107 -21
  188. package/dist/native/ingest/endpoint.js.map +1 -1
  189. package/dist/native/ingest/flushBatch.js +29 -38
  190. package/dist/native/ingest/flushBatch.js.map +1 -1
  191. package/dist/native/ingest/language.js +14 -0
  192. package/dist/native/ingest/language.js.map +1 -0
  193. package/dist/native/ingest/normalizeEvent.d.ts +30 -0
  194. package/dist/native/ingest/normalizeEvent.js +115 -16
  195. package/dist/native/ingest/normalizeEvent.js.map +1 -1
  196. package/dist/native/ingest/referrer.js +48 -0
  197. package/dist/native/ingest/referrer.js.map +1 -0
  198. package/dist/native/ingest/requestHost.js +57 -0
  199. package/dist/native/ingest/requestHost.js.map +1 -0
  200. package/dist/native/ingest/resolveHostname.d.ts +29 -0
  201. package/dist/native/ingest/resolveHostname.js +52 -0
  202. package/dist/native/ingest/resolveHostname.js.map +1 -0
  203. package/dist/native/ingest/salt.js +27 -2
  204. package/dist/native/ingest/salt.js.map +1 -1
  205. package/dist/native/ingest/serverTrack.d.ts +20 -0
  206. package/dist/native/ingest/serverTrack.js +109 -0
  207. package/dist/native/ingest/serverTrack.js.map +1 -0
  208. package/dist/native/ingest/source.d.ts +11 -0
  209. package/dist/native/ingest/source.js +264 -16
  210. package/dist/native/ingest/source.js.map +1 -1
  211. package/dist/native/ingest/utm.js +33 -0
  212. package/dist/native/ingest/utm.js.map +1 -0
  213. package/dist/native/ingest/validate.js +26 -0
  214. package/dist/native/ingest/validate.js.map +1 -0
  215. package/dist/native/nativeAdapter.d.ts +37 -1
  216. package/dist/native/nativeAdapter.js +175 -22
  217. package/dist/native/nativeAdapter.js.map +1 -1
  218. package/dist/native/query/eventAgg.js +175 -0
  219. package/dist/native/query/eventAgg.js.map +1 -0
  220. package/dist/native/retention/pruneTask.js +53 -13
  221. package/dist/native/retention/pruneTask.js.map +1 -1
  222. package/dist/native/rollupAcc.js +12 -1
  223. package/dist/native/rollupAcc.js.map +1 -1
  224. package/dist/native/rollups/bucketKey.js +15 -0
  225. package/dist/native/rollups/bucketKey.js.map +1 -0
  226. package/dist/native/rollups/bumpRollups.js +116 -0
  227. package/dist/native/rollups/bumpRollups.js.map +1 -0
  228. package/dist/native/rollups/deltas.js +86 -11
  229. package/dist/native/rollups/deltas.js.map +1 -1
  230. package/dist/native/rollups/insertManyIfNew.js +93 -0
  231. package/dist/native/rollups/insertManyIfNew.js.map +1 -0
  232. package/dist/next/captureRewrites.d.ts +42 -0
  233. package/dist/next/captureRewrites.js +57 -0
  234. package/dist/next/captureRewrites.js.map +1 -0
  235. package/dist/next/posthogProxyRewrites.d.ts +5 -0
  236. package/dist/next/posthogProxyRewrites.js +16 -21
  237. package/dist/next/posthogProxyRewrites.js.map +1 -1
  238. package/dist/plugin/documentEndpoint.js +71 -24
  239. package/dist/plugin/documentEndpoint.js.map +1 -1
  240. package/dist/plugin/errors.d.ts +31 -0
  241. package/dist/plugin/errors.js +79 -0
  242. package/dist/plugin/errors.js.map +1 -0
  243. package/dist/plugin/goalHint.d.ts +1 -0
  244. package/dist/plugin/goalHint.js +24 -0
  245. package/dist/plugin/goalHint.js.map +1 -0
  246. package/dist/plugin/paths.js +17 -1
  247. package/dist/plugin/paths.js.map +1 -1
  248. package/dist/plugin/queryEndpoint.js +124 -0
  249. package/dist/plugin/queryEndpoint.js.map +1 -0
  250. package/dist/plugin/readContextForRequest.js +73 -0
  251. package/dist/plugin/readContextForRequest.js.map +1 -0
  252. package/dist/plugin/realtimeEndpoint.js +37 -16
  253. package/dist/plugin/realtimeEndpoint.js.map +1 -1
  254. package/dist/plugin/refreshEndpoint.js +113 -0
  255. package/dist/plugin/refreshEndpoint.js.map +1 -0
  256. package/dist/plugin/runtime.d.ts +1 -0
  257. package/dist/plugin/runtime.js +33 -1
  258. package/dist/plugin/runtime.js.map +1 -1
  259. package/dist/plugin/scopeChange.js +22 -0
  260. package/dist/plugin/scopeChange.js.map +1 -0
  261. package/dist/plugin/scopeFieldBoot.js +22 -0
  262. package/dist/plugin/scopeFieldBoot.js.map +1 -0
  263. package/dist/plugin/sourcesEndpoint.js +16 -41
  264. package/dist/plugin/sourcesEndpoint.js.map +1 -1
  265. package/dist/plugin/warmTask.js +0 -0
  266. package/dist/plugin/warmTask.js.map +1 -1
  267. package/dist/providers/collection.js +89 -29
  268. package/dist/providers/collection.js.map +1 -1
  269. package/dist/providers/factory.js +11 -3
  270. package/dist/providers/factory.js.map +1 -1
  271. package/dist/providers/resolver.js.map +1 -1
  272. package/dist/query/dates.js +64 -0
  273. package/dist/query/dates.js.map +1 -0
  274. package/dist/query/errors.d.ts +14 -0
  275. package/dist/query/fetchQuery.d.ts +79 -0
  276. package/dist/query/fetchQuery.js +117 -0
  277. package/dist/query/fetchQuery.js.map +1 -0
  278. package/dist/query/parse.d.ts +22 -0
  279. package/dist/query/parse.js +168 -0
  280. package/dist/query/parse.js.map +1 -0
  281. package/dist/query/response.d.ts +39 -0
  282. package/dist/query/response.js +11 -0
  283. package/dist/query/response.js.map +1 -0
  284. package/dist/react/AnalyticsProvider.d.ts +50 -0
  285. package/dist/react/AnalyticsProvider.js +67 -0
  286. package/dist/react/AnalyticsProvider.js.map +1 -0
  287. package/dist/react/TrackerBoot.d.ts +22 -0
  288. package/dist/react/TrackerBoot.js +30 -0
  289. package/dist/react/TrackerBoot.js.map +1 -0
  290. package/dist/react/useAnalytics.d.ts +20 -0
  291. package/dist/react/useAnalytics.js +52 -0
  292. package/dist/react/useAnalytics.js.map +1 -0
  293. package/dist/rsc/AnalyticsScripts.d.ts +30 -0
  294. package/dist/rsc/AnalyticsScripts.js +41 -0
  295. package/dist/rsc/AnalyticsScripts.js.map +1 -0
  296. package/dist/surfacing/cacheStore.d.ts +1 -0
  297. package/dist/surfacing/cacheStore.js +18 -2
  298. package/dist/surfacing/cacheStore.js.map +1 -1
  299. package/dist/surfacing/engine.d.ts +1 -0
  300. package/dist/surfacing/engine.js +47 -6
  301. package/dist/surfacing/engine.js.map +1 -1
  302. package/dist/surfacing/epoch.d.ts +1 -0
  303. package/dist/surfacing/epoch.js +72 -0
  304. package/dist/surfacing/epoch.js.map +1 -0
  305. package/dist/surfacing/queue.js +22 -6
  306. package/dist/surfacing/queue.js.map +1 -1
  307. package/dist/surfacing/rateLimiter.js +130 -0
  308. package/dist/surfacing/rateLimiter.js.map +1 -0
  309. package/dist/surfacing/retryPolicy.js +15 -0
  310. package/dist/surfacing/retryPolicy.js.map +1 -0
  311. package/dist/sync/collection.js +23 -7
  312. package/dist/sync/collection.js.map +1 -1
  313. package/dist/sync/syncTask.js +68 -33
  314. package/dist/sync/syncTask.js.map +1 -1
  315. package/dist/testing/memoryAdapter.d.ts +2 -0
  316. package/dist/testing/memoryAdapter.js +17 -1
  317. package/dist/testing/memoryAdapter.js.map +1 -1
  318. package/dist/timeframe/tz.js +17 -6
  319. package/dist/timeframe/tz.js.map +1 -1
  320. package/dist/tracker/autoCapture.d.ts +48 -0
  321. package/dist/tracker/autoCapture.js +129 -0
  322. package/dist/tracker/autoCapture.js.map +1 -0
  323. package/dist/tracker/consent.d.ts +24 -0
  324. package/dist/tracker/consent.js +48 -0
  325. package/dist/tracker/consent.js.map +1 -0
  326. package/dist/tracker/createTracker.d.ts +18 -0
  327. package/dist/tracker/createTracker.js +215 -0
  328. package/dist/tracker/createTracker.js.map +1 -0
  329. package/dist/tracker/exclusion.d.ts +28 -0
  330. package/dist/tracker/exclusion.js +50 -0
  331. package/dist/tracker/exclusion.js.map +1 -0
  332. package/dist/tracker/initTracker.d.ts +22 -0
  333. package/dist/tracker/initTracker.js +33 -0
  334. package/dist/tracker/initTracker.js.map +1 -0
  335. package/dist/tracker/loadScript.d.ts +14 -0
  336. package/dist/tracker/loadScript.js +41 -0
  337. package/dist/tracker/loadScript.js.map +1 -0
  338. package/dist/tracker/pageTracking.d.ts +17 -0
  339. package/dist/tracker/pageTracking.js +38 -0
  340. package/dist/tracker/pageTracking.js.map +1 -0
  341. package/dist/tracker/registry.d.ts +27 -0
  342. package/dist/tracker/registry.js +73 -0
  343. package/dist/tracker/registry.js.map +1 -0
  344. package/dist/tracker/sinks/ga4.d.ts +29 -0
  345. package/dist/tracker/sinks/ga4.js +30 -0
  346. package/dist/tracker/sinks/ga4.js.map +1 -0
  347. package/dist/tracker/sinks/native.d.ts +22 -0
  348. package/dist/tracker/sinks/native.js +56 -0
  349. package/dist/tracker/sinks/native.js.map +1 -0
  350. package/dist/tracker/sinks/plausible.d.ts +20 -0
  351. package/dist/tracker/sinks/plausible.js +32 -0
  352. package/dist/tracker/sinks/plausible.js.map +1 -0
  353. package/dist/tracker/sinks/posthog.d.ts +18 -0
  354. package/dist/tracker/sinks/posthog.js +30 -0
  355. package/dist/tracker/sinks/posthog.js.map +1 -0
  356. package/dist/tracker/sinks/umami.d.ts +18 -0
  357. package/dist/tracker/sinks/umami.js +23 -0
  358. package/dist/tracker/sinks/umami.js.map +1 -0
  359. package/dist/tracker/sinks/vendor.d.ts +14 -0
  360. package/dist/tracker/sinks/vendor.js +81 -0
  361. package/dist/tracker/sinks/vendor.js.map +1 -0
  362. package/dist/tracker/transport.js +28 -0
  363. package/dist/tracker/transport.js.map +1 -0
  364. package/dist/tracker/types.d.ts +91 -0
  365. package/dist/translations/ar.js +221 -0
  366. package/dist/translations/ar.js.map +1 -0
  367. package/dist/translations/de.js +145 -1
  368. package/dist/translations/de.js.map +1 -1
  369. package/dist/translations/en.js +145 -1
  370. package/dist/translations/en.js.map +1 -1
  371. package/dist/translations/es.js +221 -0
  372. package/dist/translations/es.js.map +1 -0
  373. package/dist/translations/fr.js +221 -0
  374. package/dist/translations/fr.js.map +1 -0
  375. package/dist/translations/id.js +221 -0
  376. package/dist/translations/id.js.map +1 -0
  377. package/dist/translations/index.d.ts +10 -1
  378. package/dist/translations/index.js +19 -1
  379. package/dist/translations/index.js.map +1 -1
  380. package/dist/translations/keys.d.ts +144 -0
  381. package/dist/translations/keys.js +145 -1
  382. package/dist/translations/keys.js.map +1 -1
  383. package/dist/translations/ko.js +221 -0
  384. package/dist/translations/ko.js.map +1 -0
  385. package/dist/translations/metricKeys.js +8 -2
  386. package/dist/translations/metricKeys.js.map +1 -1
  387. package/dist/translations/pt.js +221 -0
  388. package/dist/translations/pt.js.map +1 -0
  389. package/dist/translations/ru.js +221 -0
  390. package/dist/translations/ru.js.map +1 -0
  391. package/dist/translations/server.js.map +1 -1
  392. package/dist/translations/uk.js +221 -0
  393. package/dist/translations/uk.js.map +1 -0
  394. package/dist/translations/zh.js +221 -0
  395. package/dist/translations/zh.js.map +1 -0
  396. package/dist/view/AnalyticsNavLink.d.ts +19 -0
  397. package/dist/view/AnalyticsNavLink.js +40 -0
  398. package/dist/view/AnalyticsNavLink.js.map +1 -0
  399. package/dist/view/AnalyticsView.d.ts +23 -0
  400. package/dist/view/AnalyticsView.js +45 -0
  401. package/dist/view/AnalyticsView.js.map +1 -0
  402. package/dist/view/AnalyticsViewClient.d.ts +15 -0
  403. package/dist/view/AnalyticsViewClient.js +244 -0
  404. package/dist/view/AnalyticsViewClient.js.map +1 -0
  405. package/dist/view/authRedirect.js +32 -0
  406. package/dist/view/authRedirect.js.map +1 -0
  407. package/dist/view/conversionRate.js +18 -0
  408. package/dist/view/conversionRate.js.map +1 -0
  409. package/dist/view/dayRange.js +68 -0
  410. package/dist/view/dayRange.js.map +1 -0
  411. package/dist/view/gating.d.ts +1 -0
  412. package/dist/view/gating.js +142 -0
  413. package/dist/view/gating.js.map +1 -0
  414. package/dist/view/labels.js +76 -0
  415. package/dist/view/labels.js.map +1 -0
  416. package/dist/view/registerView.js +48 -0
  417. package/dist/view/registerView.js.map +1 -0
  418. package/dist/view/sections/Breakdowns.js +198 -0
  419. package/dist/view/sections/Breakdowns.js.map +1 -0
  420. package/dist/view/sections/EmptyStates.js +92 -0
  421. package/dist/view/sections/EmptyStates.js.map +1 -0
  422. package/dist/view/sections/FilterChips.js +46 -0
  423. package/dist/view/sections/FilterChips.js.map +1 -0
  424. package/dist/view/sections/GoalsPanel.js +82 -0
  425. package/dist/view/sections/GoalsPanel.js.map +1 -0
  426. package/dist/view/sections/OverviewCards.js +65 -0
  427. package/dist/view/sections/OverviewCards.js.map +1 -0
  428. package/dist/view/sections/RealtimeStrip.js +80 -0
  429. package/dist/view/sections/RealtimeStrip.js.map +1 -0
  430. package/dist/view/sections/Toolbar.js +207 -0
  431. package/dist/view/sections/Toolbar.js.map +1 -0
  432. package/dist/view/sections/Trend.js +125 -0
  433. package/dist/view/sections/Trend.js.map +1 -0
  434. package/dist/view/sections/styles.js +76 -0
  435. package/dist/view/sections/styles.js.map +1 -0
  436. package/dist/view/state.js +211 -0
  437. package/dist/view/state.js.map +1 -0
  438. package/dist/view/useViewQueries.js +153 -0
  439. package/dist/view/useViewQueries.js.map +1 -0
  440. package/dist/view/viewProps.d.ts +40 -0
  441. package/dist/view/viewProps.js +90 -0
  442. package/dist/view/viewProps.js.map +1 -0
  443. package/dist/widgets/AnalyticsBreakdownWidget.d.ts +2 -1
  444. package/dist/widgets/AnalyticsBreakdownWidget.js +78 -11
  445. package/dist/widgets/AnalyticsBreakdownWidget.js.map +1 -1
  446. package/dist/widgets/AnalyticsGoalsWidget.d.ts +14 -0
  447. package/dist/widgets/AnalyticsGoalsWidget.js +196 -0
  448. package/dist/widgets/AnalyticsGoalsWidget.js.map +1 -0
  449. package/dist/widgets/AnalyticsMetricWidget.d.ts +2 -1
  450. package/dist/widgets/AnalyticsMetricWidget.js +63 -13
  451. package/dist/widgets/AnalyticsMetricWidget.js.map +1 -1
  452. package/dist/widgets/AnalyticsRealtimeWidget.d.ts +2 -1
  453. package/dist/widgets/AnalyticsRealtimeWidget.js +44 -22
  454. package/dist/widgets/AnalyticsRealtimeWidget.js.map +1 -1
  455. package/dist/widgets/AnalyticsTrendWidget.d.ts +2 -1
  456. package/dist/widgets/AnalyticsTrendWidget.js +79 -16
  457. package/dist/widgets/AnalyticsTrendWidget.js.map +1 -1
  458. package/dist/widgets/RealtimeCounter.d.ts +4 -0
  459. package/dist/widgets/RealtimeCounter.js +18 -4
  460. package/dist/widgets/RealtimeCounter.js.map +1 -1
  461. package/dist/widgets/WidgetViewLink.js +17 -0
  462. package/dist/widgets/WidgetViewLink.js.map +1 -0
  463. package/dist/widgets/breakdownTypes.js +38 -0
  464. package/dist/widgets/breakdownTypes.js.map +1 -1
  465. package/dist/widgets/cardChrome.js +31 -7
  466. package/dist/widgets/cardChrome.js.map +1 -1
  467. package/dist/widgets/comparison.js +15 -1
  468. package/dist/widgets/comparison.js.map +1 -1
  469. package/dist/widgets/defaults.d.ts +6 -2
  470. package/dist/widgets/defaults.js +78 -23
  471. package/dist/widgets/defaults.js.map +1 -1
  472. package/dist/widgets/filterCaption.js +27 -0
  473. package/dist/widgets/filterCaption.js.map +1 -0
  474. package/dist/widgets/filterField.d.ts +19 -0
  475. package/dist/widgets/filterField.js +75 -0
  476. package/dist/widgets/filterField.js.map +1 -0
  477. package/dist/widgets/prepareWidgetRead.d.ts +7 -0
  478. package/dist/widgets/prepareWidgetRead.js +74 -0
  479. package/dist/widgets/prepareWidgetRead.js.map +1 -0
  480. package/dist/widgets/range.js +43 -12
  481. package/dist/widgets/range.js.map +1 -1
  482. package/dist/widgets/readForWidget.d.ts +26 -3
  483. package/dist/widgets/readForWidget.js +48 -44
  484. package/dist/widgets/readForWidget.js.map +1 -1
  485. package/dist/widgets/readForWidgetBreakdown.d.ts +34 -2
  486. package/dist/widgets/readForWidgetBreakdown.js +53 -49
  487. package/dist/widgets/readForWidgetBreakdown.js.map +1 -1
  488. package/dist/widgets/readForWidgetGoals.d.ts +67 -0
  489. package/dist/widgets/readForWidgetGoals.js +140 -0
  490. package/dist/widgets/readForWidgetGoals.js.map +1 -0
  491. package/dist/widgets/readForWidgetRealtime.d.ts +8 -0
  492. package/dist/widgets/readForWidgetRealtime.js +23 -21
  493. package/dist/widgets/readForWidgetRealtime.js.map +1 -1
  494. package/dist/widgets/readForWidgetSeries.d.ts +26 -2
  495. package/dist/widgets/readForWidgetSeries.js +78 -53
  496. package/dist/widgets/readForWidgetSeries.js.map +1 -1
  497. package/dist/widgets/readMeta.js +18 -0
  498. package/dist/widgets/readMeta.js.map +1 -0
  499. package/dist/widgets/realtimePoll.js +13 -1
  500. package/dist/widgets/realtimePoll.js.map +1 -1
  501. package/dist/widgets/registerWidgets.js +62 -10
  502. package/dist/widgets/registerWidgets.js.map +1 -1
  503. package/dist/widgets/types.d.ts +15 -0
  504. package/dist/widgets/types.js +16 -2
  505. package/dist/widgets/types.js.map +1 -1
  506. package/dist/widgets/viewLink.d.ts +22 -0
  507. package/dist/widgets/viewLink.js +86 -0
  508. package/dist/widgets/viewLink.js.map +1 -0
  509. package/package.json +28 -8
  510. package/dist/native/rollups/applyDistinctDeltas.js +0 -9
  511. package/dist/native/rollups/applyDistinctDeltas.js.map +0 -1
  512. package/dist/native/rollups/bumpRollup.js +0 -68
  513. package/dist/native/rollups/bumpRollup.js.map +0 -1
  514. package/dist/native/rollups/insertIfNew.js +0 -19
  515. package/dist/native/rollups/insertIfNew.js.map +0 -1
@@ -0,0 +1,45 @@
1
+ import { keys } from "../translations/keys.js";
2
+ import { asTranslate } from "../translations/server.js";
3
+ import { resolveOptions } from "../core/options.js";
4
+ import { AnalyticsViewClient } from "./AnalyticsViewClient.js";
5
+ import { loginRedirectUrl } from "./authRedirect.js";
6
+ import { resolveViewProps } from "./viewProps.js";
7
+ import { jsx } from "react/jsx-runtime";
8
+ import { Gutter } from "@payloadcms/ui";
9
+ import { redirect } from "next/navigation";
10
+ import { DefaultTemplate } from "@payloadcms/next/templates";
11
+ //#region src/view/AnalyticsView.tsx
12
+ /**
13
+ * The analytics dashboard's server shell. It resolves the request's sources, goals and
14
+ * timezone once, then hands them to the client body, which reads everything else through
15
+ * the public query endpoint. A reader `access.view` denies gets the admin chrome with a
16
+ * message rather than a redirect: they are signed in, and bouncing them to a login form
17
+ * they already passed would loop.
18
+ */
19
+ async function AnalyticsView({ initPageResult, params, searchParams, pluginOptions }) {
20
+ const { req } = initPageResult;
21
+ const { user } = req;
22
+ const t = asTranslate(req.i18n.t);
23
+ if (!user) redirect(loginRedirectUrl({
24
+ config: req.payload.config,
25
+ params,
26
+ searchParams
27
+ }));
28
+ const result = await resolveViewProps(req, resolveOptions(pluginOptions));
29
+ return /* @__PURE__ */ jsx(DefaultTemplate, {
30
+ i18n: req.i18n,
31
+ locale: initPageResult.locale,
32
+ params,
33
+ payload: req.payload,
34
+ permissions: initPageResult.permissions,
35
+ searchParams,
36
+ user,
37
+ visibleEntities: initPageResult.visibleEntities,
38
+ req,
39
+ children: /* @__PURE__ */ jsx(Gutter, { children: result.denied ? /* @__PURE__ */ jsx("p", { children: t(keys.viewNoAccess) }) : /* @__PURE__ */ jsx(AnalyticsViewClient, { ...result.props }, result.props.scopeKey) })
40
+ });
41
+ }
42
+ //#endregion
43
+ export { AnalyticsView };
44
+
45
+ //# sourceMappingURL=AnalyticsView.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"AnalyticsView.js","names":[],"sources":["../../src/view/AnalyticsView.tsx"],"sourcesContent":["import { DefaultTemplate } from '@payloadcms/next/templates'\nimport { Gutter } from '@payloadcms/ui'\nimport { redirect } from 'next/navigation'\nimport type { AdminViewServerProps } from 'payload'\nimport { type AnalyticsPluginOptions, resolveOptions } from '../core/options'\nimport { keys } from '../translations/keys'\nimport { asTranslate } from '../translations/server'\nimport { AnalyticsViewClient } from './AnalyticsViewClient'\nimport { loginRedirectUrl } from './authRedirect'\nimport { resolveViewProps } from './viewProps'\n\nexport type AnalyticsViewProps = AdminViewServerProps & {\n\tpluginOptions: AnalyticsPluginOptions\n}\n\n/**\n * The analytics dashboard's server shell. It resolves the request's sources, goals and\n * timezone once, then hands them to the client body, which reads everything else through\n * the public query endpoint. A reader `access.view` denies gets the admin chrome with a\n * message rather than a redirect: they are signed in, and bouncing them to a login form\n * they already passed would loop.\n */\nexport async function AnalyticsView({\n\tinitPageResult,\n\tparams,\n\tsearchParams,\n\tpluginOptions,\n}: AnalyticsViewProps) {\n\tconst { req } = initPageResult\n\tconst { user } = req\n\tconst t = asTranslate(req.i18n.t)\n\n\tif (!user) {\n\t\tredirect(loginRedirectUrl({ config: req.payload.config, params, searchParams }))\n\t}\n\n\tconst resolved = resolveOptions(pluginOptions)\n\tconst result = await resolveViewProps(req, resolved)\n\n\treturn (\n\t\t<DefaultTemplate\n\t\t\ti18n={req.i18n}\n\t\t\tlocale={initPageResult.locale}\n\t\t\tparams={params}\n\t\t\tpayload={req.payload}\n\t\t\tpermissions={initPageResult.permissions}\n\t\t\tsearchParams={searchParams}\n\t\t\tuser={user}\n\t\t\tvisibleEntities={initPageResult.visibleEntities}\n\t\t\treq={req}\n\t\t>\n\t\t\t<Gutter>\n\t\t\t\t{result.denied ? (\n\t\t\t\t\t<p>{t(keys.viewNoAccess)}</p>\n\t\t\t\t) : (\n\t\t\t\t\t<AnalyticsViewClient key={result.props.scopeKey} {...result.props} />\n\t\t\t\t)}\n\t\t\t</Gutter>\n\t\t</DefaultTemplate>\n\t)\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAsBA,eAAsB,cAAc,EACnC,gBACA,QACA,cACA,iBACsB;CACtB,MAAM,EAAE,QAAQ;CAChB,MAAM,EAAE,SAAS;CACjB,MAAM,IAAI,YAAY,IAAI,KAAK,CAAC;CAEhC,IAAI,CAAC,MACJ,SAAS,iBAAiB;EAAE,QAAQ,IAAI,QAAQ;EAAQ;EAAQ;CAAa,CAAC,CAAC;CAIhF,MAAM,SAAS,MAAM,iBAAiB,KADrB,eAAe,aACkB,CAAC;CAEnD,OACC,oBAAC,iBAAD;EACC,MAAM,IAAI;EACV,QAAQ,eAAe;EACf;EACR,SAAS,IAAI;EACb,aAAa,eAAe;EACd;EACR;EACN,iBAAiB,eAAe;EAC3B;YAEL,oBAAC,QAAD,EAAA,UACE,OAAO,SACP,oBAAC,KAAD,EAAA,UAAI,EAAE,KAAK,YAAY,EAAK,CAAA,IAE5B,oBAAC,qBAAD,EAAiD,GAAI,OAAO,MAAQ,GAA1C,OAAO,MAAM,QAA6B,EAE9D,CAAA;CACQ,CAAA;AAEnB"}
@@ -0,0 +1,15 @@
1
+ import { AnalyticsViewClientProps } from "./viewProps.js";
2
+
3
+ //#region src/view/AnalyticsViewClient.d.ts
4
+ /**
5
+ * The analytics dashboard. Its whole state is the URL, so a link is a view: the query
6
+ * string is parsed on every render, coerced to what the selected source serves, and
7
+ * written back through `router.push` as the reader works (a debounced day edit uses
8
+ * `replace`, so Back skips the typing). A coerced value is applied to
9
+ * the reads but deliberately not written back, so a link built for a richer source still
10
+ * opens as intended once that source is selected again.
11
+ */
12
+ declare function AnalyticsViewClient(props: AnalyticsViewClientProps): import("react/jsx-runtime").JSX.Element;
13
+ //#endregion
14
+ export { AnalyticsViewClient };
15
+ //# sourceMappingURL=AnalyticsViewClient.d.ts.map
@@ -0,0 +1,244 @@
1
+ "use client";
2
+ import { keys } from "../translations/keys.js";
3
+ import { useTranslation } from "../translations/useTranslation.js";
4
+ import { refreshCache } from "../query/fetchQuery.js";
5
+ import { dayRangeCaption } from "./dayRange.js";
6
+ import { autoGranularity, gate, resolveSource } from "./gating.js";
7
+ import { coerceState, parseViewState, rangeFor, serializeViewState } from "./state.js";
8
+ import { useViewQueries } from "./useViewQueries.js";
9
+ import { NoSources } from "./sections/EmptyStates.js";
10
+ import { Breakdowns } from "./sections/Breakdowns.js";
11
+ import { GoalsPanel } from "./sections/GoalsPanel.js";
12
+ import { OverviewCards } from "./sections/OverviewCards.js";
13
+ import { RealtimeStrip } from "./sections/RealtimeStrip.js";
14
+ import { ViewStyles } from "./sections/styles.js";
15
+ import { Toolbar } from "./sections/Toolbar.js";
16
+ import { Trend } from "./sections/Trend.js";
17
+ import { useCallback, useEffect, useMemo, useRef, useState } from "react";
18
+ import { jsx, jsxs } from "react/jsx-runtime";
19
+ import { usePathname, useRouter, useSearchParams } from "next/navigation";
20
+ //#region src/view/AnalyticsViewClient.tsx
21
+ /** A day input fires on every keystroke; only the pause between them is worth a history entry. */
22
+ const COMMIT_DELAY_MS = 400;
23
+ /**
24
+ * The analytics dashboard. Its whole state is the URL, so a link is a view: the query
25
+ * string is parsed on every render, coerced to what the selected source serves, and
26
+ * written back through `router.push` as the reader works (a debounced day edit uses
27
+ * `replace`, so Back skips the typing). A coerced value is applied to
28
+ * the reads but deliberately not written back, so a link built for a richer source still
29
+ * opens as intended once that source is selected again.
30
+ */
31
+ function AnalyticsViewClient(props) {
32
+ const { t } = useTranslation();
33
+ const router = useRouter();
34
+ const pathname = usePathname();
35
+ const search = useSearchParams().toString();
36
+ const parsed = useMemo(() => parseViewState(new URLSearchParams(search), props.defaults), [search, props.defaults]);
37
+ const source = resolveSource(props.sources, parsed.source);
38
+ const served = useMemo(() => source ? gate(source.capabilities) : null, [source]);
39
+ const state = served ? coerceState(parsed, served) : parsed;
40
+ const queries = useViewQueries(props, state);
41
+ const query = useCallback((next) => serializeViewState(next, props.defaults).toString(), [props.defaults]);
42
+ const href = useCallback((next) => {
43
+ const search = query(next);
44
+ return search === "" ? pathname : `${pathname}?${search}`;
45
+ }, [pathname, query]);
46
+ const pending = useRef(null);
47
+ const refreshing = useRef(null);
48
+ const [refreshPending, setRefreshPending] = useState(false);
49
+ const [refreshFailed, setRefreshFailed] = useState(false);
50
+ /**
51
+ * Retires this scope's cached reads, then reissues every section against the new epoch.
52
+ * The realtime strip is left alone: it polls its own short-lived window and never reads
53
+ * through the aggregate cache the epoch keys. Starting an attempt clears the previous
54
+ * failure notice, so the notice always describes the attempt that is in flight.
55
+ */
56
+ const refreshCards = queries.cards.refetch;
57
+ const refreshTrend = queries.trend.refetch;
58
+ const refreshBreakdown = queries.breakdown.refetch;
59
+ const refreshGoals = queries.goals?.refetch;
60
+ const refresh = useCallback(() => {
61
+ if (refreshPending) return;
62
+ const controller = new AbortController();
63
+ refreshing.current = controller;
64
+ setRefreshPending(true);
65
+ setRefreshFailed(false);
66
+ refreshCache(props.apiRoute, { signal: controller.signal }).then(() => {
67
+ if (controller.signal.aborted) return;
68
+ setRefreshPending(false);
69
+ refreshCards();
70
+ refreshTrend();
71
+ refreshBreakdown();
72
+ refreshGoals?.();
73
+ }, () => {
74
+ if (controller.signal.aborted) return;
75
+ setRefreshPending(false);
76
+ setRefreshFailed(true);
77
+ });
78
+ }, [
79
+ props.apiRoute,
80
+ refreshPending,
81
+ refreshCards,
82
+ refreshTrend,
83
+ refreshBreakdown,
84
+ refreshGoals
85
+ ]);
86
+ /**
87
+ * A click is a step the reader took, so Back undoes it rather than leaving the view. It
88
+ * also drops any day edit still waiting out its debounce, whose later `replace` would
89
+ * otherwise overwrite the click with the state as it stood before it.
90
+ */
91
+ const write = useCallback((next) => {
92
+ if (pending.current !== null) {
93
+ clearTimeout(pending.current);
94
+ pending.current = null;
95
+ }
96
+ router.push(href(next), { scroll: false });
97
+ }, [router, href]);
98
+ /**
99
+ * Typing in a day input is one edit, not a history of them: the committed value replaces
100
+ * the entry the picker already wrote rather than stacking one per keystroke pause.
101
+ */
102
+ const writeLater = useCallback((next) => {
103
+ if (pending.current !== null) clearTimeout(pending.current);
104
+ pending.current = setTimeout(() => {
105
+ pending.current = null;
106
+ router.replace(href(next), { scroll: false });
107
+ }, COMMIT_DELAY_MS);
108
+ }, [router, href]);
109
+ useEffect(() => () => {
110
+ if (pending.current !== null) clearTimeout(pending.current);
111
+ refreshing.current?.abort();
112
+ }, []);
113
+ if (!source || !served) return /* @__PURE__ */ jsxs("div", {
114
+ className: "analytics-view",
115
+ children: [
116
+ /* @__PURE__ */ jsx(ViewStyles, {}),
117
+ /* @__PURE__ */ jsx("h1", {
118
+ className: "analytics-view__title",
119
+ children: t(keys.viewTitle)
120
+ }),
121
+ /* @__PURE__ */ jsx(NoSources, {})
122
+ ]
123
+ });
124
+ const now = /* @__PURE__ */ new Date();
125
+ const range = rangeFor(state, props.timezone, now);
126
+ const sections = [
127
+ queries.cards,
128
+ queries.trend,
129
+ queries.breakdown,
130
+ ...queries.goals ? [queries.goals] : []
131
+ ];
132
+ const provider = sections.find((section) => section.data)?.data?.result.meta.provider ?? "";
133
+ const dimensions = served.dimensionsFor(state.tab);
134
+ const dimension = state.dim ?? dimensions[0] ?? null;
135
+ const canFilter = dimension !== null && served.canFilter(dimension);
136
+ const addFilter = (value) => {
137
+ if (dimension === null || state.filters.length >= 10) return;
138
+ if (state.filters.some((filter) => filter.dimension === dimension && filter.operator === "eq" && filter.value === value)) return;
139
+ write({
140
+ ...state,
141
+ filters: [...state.filters, {
142
+ dimension,
143
+ operator: "eq",
144
+ value
145
+ }]
146
+ });
147
+ };
148
+ return /* @__PURE__ */ jsxs("div", {
149
+ className: "analytics-view",
150
+ children: [
151
+ /* @__PURE__ */ jsx(ViewStyles, {}),
152
+ /* @__PURE__ */ jsx("h1", {
153
+ className: "analytics-view__title",
154
+ children: t(keys.viewTitle)
155
+ }),
156
+ /* @__PURE__ */ jsx(Toolbar, {
157
+ clamped: sections.some((section) => section.data?.result.meta.clamped === true),
158
+ filtersUnapplied: sections.some((section) => (section.data?.result.meta.unappliedFilters?.length ?? 0) > 0),
159
+ gate: served,
160
+ locale: props.locale,
161
+ now,
162
+ onChange: write,
163
+ onChangeDeferred: writeLater,
164
+ onRefresh: refresh,
165
+ provider,
166
+ range,
167
+ refreshFailed,
168
+ refreshing: refreshPending,
169
+ sampled: sections.some((section) => section.data?.result.meta.sampled === true),
170
+ sourceId: source.id,
171
+ sources: props.sources.sources,
172
+ stale: sections.some((section) => section.data?.result.meta.stale === true),
173
+ state,
174
+ stateKey: query(state),
175
+ timezone: props.timezone
176
+ }),
177
+ /* @__PURE__ */ jsx(OverviewCards, {
178
+ compare: state.compare,
179
+ locale: props.locale,
180
+ metrics: served.metrics,
181
+ onSelect: (metric) => write({
182
+ ...state,
183
+ metric
184
+ }),
185
+ query: queries.cards,
186
+ selected: state.metric
187
+ }),
188
+ /* @__PURE__ */ jsx(Trend, {
189
+ compare: state.compare,
190
+ granularity: state.granularity ?? autoGranularity(range, source.capabilities),
191
+ locale: props.locale,
192
+ metric: state.metric,
193
+ query: queries.trend,
194
+ rangeCaption: dayRangeCaption(range, props.locale, props.timezone),
195
+ timezone: props.timezone
196
+ }),
197
+ /* @__PURE__ */ jsx(Breakdowns, {
198
+ canFilter,
199
+ dimension,
200
+ dimensions,
201
+ limit: state.limit,
202
+ locale: props.locale,
203
+ metric: state.metric,
204
+ onDimensionChange: (dim) => write({
205
+ ...state,
206
+ dim: dim === dimensions[0] ? void 0 : dim
207
+ }),
208
+ onLimitChange: (limit) => write({
209
+ ...state,
210
+ limit
211
+ }),
212
+ onRowSelect: addFilter,
213
+ onSortChange: (order) => write({
214
+ ...state,
215
+ order
216
+ }),
217
+ onTabChange: (tab) => write({
218
+ ...state,
219
+ tab,
220
+ dim: void 0
221
+ }),
222
+ ...state.order === void 0 ? {} : { order: state.order },
223
+ query: queries.breakdown,
224
+ tab: state.tab,
225
+ tabs: served.tabs
226
+ }),
227
+ served.goals && queries.goals ? /* @__PURE__ */ jsx(GoalsPanel, {
228
+ goals: props.goals,
229
+ locale: props.locale,
230
+ query: queries.goals,
231
+ ...queries.cards.data?.result.totals?.visitors === void 0 ? {} : { siteVisitors: queries.cards.data.result.totals.visitors }
232
+ }) : null,
233
+ served.realtime ? /* @__PURE__ */ jsx(RealtimeStrip, {
234
+ apiRoute: props.apiRoute,
235
+ locale: props.locale,
236
+ sourceId: source.id
237
+ }) : null
238
+ ]
239
+ });
240
+ }
241
+ //#endregion
242
+ export { AnalyticsViewClient };
243
+
244
+ //# sourceMappingURL=AnalyticsViewClient.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"AnalyticsViewClient.js","names":[],"sources":["../../src/view/AnalyticsViewClient.tsx"],"sourcesContent":["'use client'\n\nimport { usePathname, useRouter, useSearchParams } from 'next/navigation'\nimport { useCallback, useEffect, useMemo, useRef, useState } from 'react'\nimport type { MetricKey } from '../core/contract'\nimport { refreshCache } from '../query/fetchQuery'\nimport { MAX_QUERY_FILTERS } from '../query/limits'\nimport { keys } from '../translations/keys'\nimport { useTranslation } from '../translations/useTranslation'\nimport { dayRangeCaption } from './dayRange'\nimport { autoGranularity, gate, resolveSource } from './gating'\nimport { Breakdowns } from './sections/Breakdowns'\nimport { NoSources } from './sections/EmptyStates'\nimport { GoalsPanel } from './sections/GoalsPanel'\nimport { OverviewCards } from './sections/OverviewCards'\nimport { RealtimeStrip } from './sections/RealtimeStrip'\nimport { ViewStyles } from './sections/styles'\nimport { Toolbar } from './sections/Toolbar'\nimport { Trend } from './sections/Trend'\nimport { coerceState, parseViewState, rangeFor, serializeViewState, type ViewState } from './state'\nimport { useViewQueries } from './useViewQueries'\nimport type { AnalyticsViewClientProps } from './viewProps'\n\n/** A day input fires on every keystroke; only the pause between them is worth a history entry. */\nconst COMMIT_DELAY_MS = 400\n\n/**\n * The analytics dashboard. Its whole state is the URL, so a link is a view: the query\n * string is parsed on every render, coerced to what the selected source serves, and\n * written back through `router.push` as the reader works (a debounced day edit uses\n * `replace`, so Back skips the typing). A coerced value is applied to\n * the reads but deliberately not written back, so a link built for a richer source still\n * opens as intended once that source is selected again.\n */\nexport function AnalyticsViewClient(props: AnalyticsViewClientProps) {\n\tconst { t } = useTranslation()\n\tconst router = useRouter()\n\tconst pathname = usePathname()\n\tconst searchParams = useSearchParams()\n\tconst search = searchParams.toString()\n\n\tconst parsed = useMemo(\n\t\t() => parseViewState(new URLSearchParams(search), props.defaults),\n\t\t[search, props.defaults]\n\t)\n\tconst source = resolveSource(props.sources, parsed.source)\n\tconst served = useMemo(() => (source ? gate(source.capabilities) : null), [source])\n\tconst state = served ? coerceState(parsed, served) : parsed\n\tconst queries = useViewQueries(props, state)\n\n\tconst query = useCallback(\n\t\t(next: ViewState) => serializeViewState(next, props.defaults).toString(),\n\t\t[props.defaults]\n\t)\n\n\tconst href = useCallback(\n\t\t(next: ViewState) => {\n\t\t\tconst search = query(next)\n\t\t\treturn search === '' ? pathname : `${pathname}?${search}`\n\t\t},\n\t\t[pathname, query]\n\t)\n\n\tconst pending = useRef<ReturnType<typeof setTimeout> | null>(null)\n\tconst refreshing = useRef<AbortController | null>(null)\n\tconst [refreshPending, setRefreshPending] = useState(false)\n\tconst [refreshFailed, setRefreshFailed] = useState(false)\n\n\t/**\n\t * Retires this scope's cached reads, then reissues every section against the new epoch.\n\t * The realtime strip is left alone: it polls its own short-lived window and never reads\n\t * through the aggregate cache the epoch keys. Starting an attempt clears the previous\n\t * failure notice, so the notice always describes the attempt that is in flight.\n\t */\n\tconst refreshCards = queries.cards.refetch\n\tconst refreshTrend = queries.trend.refetch\n\tconst refreshBreakdown = queries.breakdown.refetch\n\tconst refreshGoals = queries.goals?.refetch\n\tconst refresh = useCallback((): void => {\n\t\tif (refreshPending) {\n\t\t\treturn\n\t\t}\n\t\tconst controller = new AbortController()\n\t\trefreshing.current = controller\n\t\tsetRefreshPending(true)\n\t\tsetRefreshFailed(false)\n\t\trefreshCache(props.apiRoute, { signal: controller.signal }).then(\n\t\t\t() => {\n\t\t\t\tif (controller.signal.aborted) return\n\t\t\t\tsetRefreshPending(false)\n\t\t\t\trefreshCards()\n\t\t\t\trefreshTrend()\n\t\t\t\trefreshBreakdown()\n\t\t\t\trefreshGoals?.()\n\t\t\t},\n\t\t\t() => {\n\t\t\t\tif (controller.signal.aborted) return\n\t\t\t\tsetRefreshPending(false)\n\t\t\t\tsetRefreshFailed(true)\n\t\t\t}\n\t\t)\n\t}, [props.apiRoute, refreshPending, refreshCards, refreshTrend, refreshBreakdown, refreshGoals])\n\n\t/**\n\t * A click is a step the reader took, so Back undoes it rather than leaving the view. It\n\t * also drops any day edit still waiting out its debounce, whose later `replace` would\n\t * otherwise overwrite the click with the state as it stood before it.\n\t */\n\tconst write = useCallback(\n\t\t(next: ViewState) => {\n\t\t\tif (pending.current !== null) {\n\t\t\t\tclearTimeout(pending.current)\n\t\t\t\tpending.current = null\n\t\t\t}\n\t\t\trouter.push(href(next), { scroll: false })\n\t\t},\n\t\t[router, href]\n\t)\n\n\t/**\n\t * Typing in a day input is one edit, not a history of them: the committed value replaces\n\t * the entry the picker already wrote rather than stacking one per keystroke pause.\n\t */\n\tconst writeLater = useCallback(\n\t\t(next: ViewState) => {\n\t\t\tif (pending.current !== null) {\n\t\t\t\tclearTimeout(pending.current)\n\t\t\t}\n\t\t\tpending.current = setTimeout(() => {\n\t\t\t\tpending.current = null\n\t\t\t\trouter.replace(href(next), { scroll: false })\n\t\t\t}, COMMIT_DELAY_MS)\n\t\t},\n\t\t[router, href]\n\t)\n\tuseEffect(\n\t\t() => () => {\n\t\t\tif (pending.current !== null) {\n\t\t\t\tclearTimeout(pending.current)\n\t\t\t}\n\t\t\trefreshing.current?.abort()\n\t\t},\n\t\t[]\n\t)\n\n\tif (!source || !served) {\n\t\treturn (\n\t\t\t<div className=\"analytics-view\">\n\t\t\t\t<ViewStyles />\n\t\t\t\t<h1 className=\"analytics-view__title\">{t(keys.viewTitle)}</h1>\n\t\t\t\t<NoSources />\n\t\t\t</div>\n\t\t)\n\t}\n\n\tconst now = new Date()\n\tconst range = rangeFor(state, props.timezone, now)\n\tconst sections = [\n\t\tqueries.cards,\n\t\tqueries.trend,\n\t\tqueries.breakdown,\n\t\t...(queries.goals ? [queries.goals] : []),\n\t]\n\t// Whichever section has answered names the source that answered it; every section reads\n\t// through the same one.\n\tconst provider = sections.find((section) => section.data)?.data?.result.meta.provider ?? ''\n\tconst dimensions = served.dimensionsFor(state.tab)\n\tconst dimension = state.dim ?? dimensions[0] ?? null\n\tconst canFilter = dimension !== null && served.canFilter(dimension)\n\n\tconst addFilter = (value: string): void => {\n\t\tif (dimension === null || state.filters.length >= MAX_QUERY_FILTERS) {\n\t\t\treturn\n\t\t}\n\t\tconst already = state.filters.some(\n\t\t\t(filter) =>\n\t\t\t\tfilter.dimension === dimension && filter.operator === 'eq' && filter.value === value\n\t\t)\n\t\tif (already) {\n\t\t\treturn\n\t\t}\n\t\twrite({\n\t\t\t...state,\n\t\t\tfilters: [...state.filters, { dimension, operator: 'eq', value }],\n\t\t})\n\t}\n\n\treturn (\n\t\t<div className=\"analytics-view\">\n\t\t\t<ViewStyles />\n\t\t\t<h1 className=\"analytics-view__title\">{t(keys.viewTitle)}</h1>\n\t\t\t<Toolbar\n\t\t\t\tclamped={sections.some((section) => section.data?.result.meta.clamped === true)}\n\t\t\t\tfiltersUnapplied={sections.some(\n\t\t\t\t\t(section) => (section.data?.result.meta.unappliedFilters?.length ?? 0) > 0\n\t\t\t\t)}\n\t\t\t\tgate={served}\n\t\t\t\tlocale={props.locale}\n\t\t\t\tnow={now}\n\t\t\t\tonChange={write}\n\t\t\t\tonChangeDeferred={writeLater}\n\t\t\t\tonRefresh={refresh}\n\t\t\t\tprovider={provider}\n\t\t\t\trange={range}\n\t\t\t\trefreshFailed={refreshFailed}\n\t\t\t\trefreshing={refreshPending}\n\t\t\t\tsampled={sections.some((section) => section.data?.result.meta.sampled === true)}\n\t\t\t\tsourceId={source.id}\n\t\t\t\tsources={props.sources.sources}\n\t\t\t\tstale={sections.some((section) => section.data?.result.meta.stale === true)}\n\t\t\t\tstate={state}\n\t\t\t\tstateKey={query(state)}\n\t\t\t\ttimezone={props.timezone}\n\t\t\t/>\n\t\t\t<OverviewCards\n\t\t\t\tcompare={state.compare}\n\t\t\t\tlocale={props.locale}\n\t\t\t\tmetrics={served.metrics}\n\t\t\t\tonSelect={(metric: MetricKey) => write({ ...state, metric })}\n\t\t\t\tquery={queries.cards}\n\t\t\t\tselected={state.metric}\n\t\t\t/>\n\t\t\t<Trend\n\t\t\t\tcompare={state.compare}\n\t\t\t\tgranularity={state.granularity ?? autoGranularity(range, source.capabilities)}\n\t\t\t\tlocale={props.locale}\n\t\t\t\tmetric={state.metric}\n\t\t\t\tquery={queries.trend}\n\t\t\t\trangeCaption={dayRangeCaption(range, props.locale, props.timezone)}\n\t\t\t\ttimezone={props.timezone}\n\t\t\t/>\n\t\t\t<Breakdowns\n\t\t\t\tcanFilter={canFilter}\n\t\t\t\tdimension={dimension}\n\t\t\t\tdimensions={dimensions}\n\t\t\t\tlimit={state.limit}\n\t\t\t\tlocale={props.locale}\n\t\t\t\tmetric={state.metric}\n\t\t\t\t// The tab's default is its absence, so picking it back writes a link without `dim`.\n\t\t\t\tonDimensionChange={(dim) =>\n\t\t\t\t\twrite({ ...state, dim: dim === dimensions[0] ? undefined : dim })\n\t\t\t\t}\n\t\t\t\tonLimitChange={(limit) => write({ ...state, limit })}\n\t\t\t\tonRowSelect={addFilter}\n\t\t\t\tonSortChange={(order) => write({ ...state, order })}\n\t\t\t\t// A grouping belongs to the tab that offered it, so a new tab starts on its own default.\n\t\t\t\tonTabChange={(tab) => write({ ...state, tab, dim: undefined })}\n\t\t\t\t{...(state.order === undefined ? {} : { order: state.order })}\n\t\t\t\tquery={queries.breakdown}\n\t\t\t\ttab={state.tab}\n\t\t\t\ttabs={served.tabs}\n\t\t\t/>\n\t\t\t{served.goals && queries.goals ? (\n\t\t\t\t<GoalsPanel\n\t\t\t\t\tgoals={props.goals}\n\t\t\t\t\tlocale={props.locale}\n\t\t\t\t\tquery={queries.goals}\n\t\t\t\t\t{...(queries.cards.data?.result.totals?.visitors === undefined\n\t\t\t\t\t\t? {}\n\t\t\t\t\t\t: { siteVisitors: queries.cards.data.result.totals.visitors })}\n\t\t\t\t/>\n\t\t\t) : null}\n\t\t\t{served.realtime ? (\n\t\t\t\t<RealtimeStrip apiRoute={props.apiRoute} locale={props.locale} sourceId={source.id} />\n\t\t\t) : null}\n\t\t</div>\n\t)\n}\n"],"mappings":"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"}
@@ -0,0 +1,32 @@
1
+ import { formatAdminURL } from "payload/shared";
2
+ //#region src/view/authRedirect.ts
3
+ /** The admin path the reader asked for, with the state they had, ready to come back to. */
4
+ const returnPath = (config, params, searchParams) => {
5
+ const segments = Array.isArray(params?.segments) ? params.segments : [];
6
+ const path = formatAdminURL({
7
+ adminRoute: config.routes.admin,
8
+ path: segments.length > 0 ? `/${segments.join("/")}` : null
9
+ });
10
+ const query = new URLSearchParams();
11
+ for (const [key, value] of Object.entries(searchParams ?? {})) {
12
+ if (key === "redirect" || value === void 0) continue;
13
+ for (const entry of Array.isArray(value) ? value : [value]) query.append(key, entry);
14
+ }
15
+ const queryString = query.toString();
16
+ return queryString ? `${path}?${queryString}` : path;
17
+ };
18
+ /**
19
+ * Where to send a reader who is not signed in. Custom admin views bypass the root router's
20
+ * auth redirect, so the view enforces this itself. The view's whole state lives in the query
21
+ * string, so it travels along and the reader lands back on the same dashboard.
22
+ */
23
+ const loginRedirectUrl = ({ config, params, searchParams }) => {
24
+ return `${formatAdminURL({
25
+ adminRoute: config.routes.admin,
26
+ path: config.admin.routes.login
27
+ })}?redirect=${encodeURIComponent(returnPath(config, params, searchParams))}`;
28
+ };
29
+ //#endregion
30
+ export { loginRedirectUrl };
31
+
32
+ //# sourceMappingURL=authRedirect.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"authRedirect.js","names":[],"sources":["../../src/view/authRedirect.ts"],"sourcesContent":["import type { Params, SanitizedConfig } from 'payload'\nimport { formatAdminURL } from 'payload/shared'\n\n/** The admin path the reader asked for, with the state they had, ready to come back to. */\nconst returnPath = (config: SanitizedConfig, params?: Params, searchParams?: Params): string => {\n\tconst segments = Array.isArray(params?.segments) ? params.segments : []\n\tconst path = formatAdminURL({\n\t\tadminRoute: config.routes.admin,\n\t\tpath: segments.length > 0 ? `/${segments.join('/')}` : null,\n\t})\n\n\tconst query = new URLSearchParams()\n\tfor (const [key, value] of Object.entries(searchParams ?? {})) {\n\t\t// An inherited `redirect` would nest one round trip inside another.\n\t\tif (key === 'redirect' || value === undefined) continue\n\t\tfor (const entry of Array.isArray(value) ? value : [value]) query.append(key, entry)\n\t}\n\n\tconst queryString = query.toString()\n\treturn queryString ? `${path}?${queryString}` : path\n}\n\n/**\n * Where to send a reader who is not signed in. Custom admin views bypass the root router's\n * auth redirect, so the view enforces this itself. The view's whole state lives in the query\n * string, so it travels along and the reader lands back on the same dashboard.\n */\nexport const loginRedirectUrl = ({\n\tconfig,\n\tparams,\n\tsearchParams,\n}: {\n\tconfig: SanitizedConfig\n\tparams?: Params\n\tsearchParams?: Params\n}): string => {\n\tconst target = formatAdminURL({\n\t\tadminRoute: config.routes.admin,\n\t\tpath: config.admin.routes.login,\n\t})\n\treturn `${target}?redirect=${encodeURIComponent(returnPath(config, params, searchParams))}`\n}\n"],"mappings":";;;AAIA,MAAM,cAAc,QAAyB,QAAiB,iBAAkC;CAC/F,MAAM,WAAW,MAAM,QAAQ,QAAQ,QAAQ,IAAI,OAAO,WAAW,CAAC;CACtE,MAAM,OAAO,eAAe;EAC3B,YAAY,OAAO,OAAO;EAC1B,MAAM,SAAS,SAAS,IAAI,IAAI,SAAS,KAAK,GAAG,MAAM;CACxD,CAAC;CAED,MAAM,QAAQ,IAAI,gBAAgB;CAClC,KAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,gBAAgB,CAAC,CAAC,GAAG;EAE9D,IAAI,QAAQ,cAAc,UAAU,KAAA,GAAW;EAC/C,KAAK,MAAM,SAAS,MAAM,QAAQ,KAAK,IAAI,QAAQ,CAAC,KAAK,GAAG,MAAM,OAAO,KAAK,KAAK;CACpF;CAEA,MAAM,cAAc,MAAM,SAAS;CACnC,OAAO,cAAc,GAAG,KAAK,GAAG,gBAAgB;AACjD;;;;;;AAOA,MAAa,oBAAoB,EAChC,QACA,QACA,mBAKa;CAKb,OAAO,GAJQ,eAAe;EAC7B,YAAY,OAAO,OAAO;EAC1B,MAAM,OAAO,MAAM,OAAO;CAC3B,CACe,EAAE,YAAY,mBAAmB,WAAW,QAAQ,QAAQ,YAAY,CAAC;AACzF"}
@@ -0,0 +1,18 @@
1
+ //#region src/view/conversionRate.ts
2
+ /**
3
+ * Share of the site's visitors a goal converted, as a 0..1 ratio rounded to four decimals.
4
+ * Null when either side is missing, unreadable, or the site total is zero, where a rate is
5
+ * undefined rather than zero. The two numbers come from separate reads (a goal breakdown
6
+ * row and the range totals), so a bucket wider than the total is clamped instead of
7
+ * reported as more than 100 percent.
8
+ */
9
+ const conversionRate = (goalVisitors, siteVisitors) => {
10
+ if (goalVisitors === void 0 || siteVisitors === void 0) return null;
11
+ if (!Number.isFinite(goalVisitors) || !Number.isFinite(siteVisitors) || siteVisitors === 0) return null;
12
+ const ratio = Math.min(Math.max(goalVisitors / siteVisitors, 0), 1);
13
+ return Math.round(ratio * 1e4) / 1e4;
14
+ };
15
+ //#endregion
16
+ export { conversionRate };
17
+
18
+ //# sourceMappingURL=conversionRate.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"conversionRate.js","names":[],"sources":["../../src/view/conversionRate.ts"],"sourcesContent":["/**\n * Share of the site's visitors a goal converted, as a 0..1 ratio rounded to four decimals.\n * Null when either side is missing, unreadable, or the site total is zero, where a rate is\n * undefined rather than zero. The two numbers come from separate reads (a goal breakdown\n * row and the range totals), so a bucket wider than the total is clamped instead of\n * reported as more than 100 percent.\n */\nexport const conversionRate = (\n\tgoalVisitors: number | undefined,\n\tsiteVisitors: number | undefined\n): number | null => {\n\tif (goalVisitors === undefined || siteVisitors === undefined) {\n\t\treturn null\n\t}\n\tif (!Number.isFinite(goalVisitors) || !Number.isFinite(siteVisitors) || siteVisitors === 0) {\n\t\treturn null\n\t}\n\tconst ratio = Math.min(Math.max(goalVisitors / siteVisitors, 0), 1)\n\treturn Math.round(ratio * 10_000) / 10_000\n}\n"],"mappings":";;;;;;;;AAOA,MAAa,kBACZ,cACA,iBACmB;CACnB,IAAI,iBAAiB,KAAA,KAAa,iBAAiB,KAAA,GAClD,OAAO;CAER,IAAI,CAAC,OAAO,SAAS,YAAY,KAAK,CAAC,OAAO,SAAS,YAAY,KAAK,iBAAiB,GACxF,OAAO;CAER,MAAM,QAAQ,KAAK,IAAI,KAAK,IAAI,eAAe,cAAc,CAAC,GAAG,CAAC;CAClE,OAAO,KAAK,MAAM,QAAQ,GAAM,IAAI;AACrC"}
@@ -0,0 +1,68 @@
1
+ import { parseDayOrInstant } from "../query/dates.js";
2
+ import { formatRangeCaption } from "../widgets/range.js";
3
+ //#region src/view/dayRange.ts
4
+ const DAY_MS = 864e5;
5
+ /** Epoch ms of a `YYYY-MM-DD` day read as UTC, or null when it is not one. */
6
+ const dayValue = (day) => {
7
+ const ms = Date.parse(`${day}T00:00:00.000Z`);
8
+ return Number.isNaN(ms) ? null : ms;
9
+ };
10
+ const asDay = (ms) => new Date(ms).toISOString().slice(0, 10);
11
+ /** Calendar days a window covers, counting both ends; 1 for an unreadable or inverted one. */
12
+ const dayRangeDays = (range) => {
13
+ const from = dayValue(range.from);
14
+ const to = dayValue(range.to);
15
+ if (from === null || to === null || to < from) return 1;
16
+ return Math.round((to - from) / DAY_MS) + 1;
17
+ };
18
+ /**
19
+ * The nearest window the source and the endpoint can both serve, keeping the bound the
20
+ * admin just picked and moving the other one. A window longer than the source's lookback
21
+ * would answer for a shorter span than the picker shows, and one past the endpoint's own
22
+ * cap would not answer at all.
23
+ */
24
+ const clampDayRange = (range, edited, maxDays) => {
25
+ const from = dayValue(range.from);
26
+ const to = dayValue(range.to);
27
+ if (from === null || to === null) return range;
28
+ const cap = Math.max(1, Math.min(maxDays ?? 366, 366));
29
+ if (to < from) return edited === "from" ? {
30
+ from: range.from,
31
+ to: range.from
32
+ } : {
33
+ from: range.to,
34
+ to: range.to
35
+ };
36
+ if (Math.round((to - from) / DAY_MS) + 1 <= cap) return range;
37
+ return edited === "from" ? {
38
+ from: range.from,
39
+ to: asDay(from + (cap - 1) * DAY_MS)
40
+ } : {
41
+ from: asDay(to - (cap - 1) * DAY_MS),
42
+ to: range.to
43
+ };
44
+ };
45
+ /**
46
+ * Caption for a day window, rendered in the reporting timezone the days are read in. Falls
47
+ * back to the raw days when a bound names no calendar day, so a hand-edited URL captions
48
+ * what it asked for rather than rendering `Invalid Date`.
49
+ */
50
+ const dayRangeCaption = (range, locale, timezone) => {
51
+ const start = parseDayOrInstant(range.from, {
52
+ timezone,
53
+ edge: "start"
54
+ });
55
+ const end = parseDayOrInstant(range.to, {
56
+ timezone,
57
+ edge: "end"
58
+ });
59
+ if (!start || !end) return `${range.from} - ${range.to}`;
60
+ return formatRangeCaption({
61
+ start,
62
+ end
63
+ }, locale, timezone);
64
+ };
65
+ //#endregion
66
+ export { clampDayRange, dayRangeCaption, dayRangeDays };
67
+
68
+ //# sourceMappingURL=dayRange.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"dayRange.js","names":[],"sources":["../../src/view/dayRange.ts"],"sourcesContent":["import { parseDayOrInstant } from '../query/dates'\nimport { MAX_QUERY_RANGE_DAYS } from '../query/limits'\nimport { formatRangeCaption } from '../widgets/range'\nimport type { DayRange } from './gating'\n\nconst DAY_MS = 86_400_000\n\n/** Epoch ms of a `YYYY-MM-DD` day read as UTC, or null when it is not one. */\nconst dayValue = (day: string): number | null => {\n\tconst ms = Date.parse(`${day}T00:00:00.000Z`)\n\treturn Number.isNaN(ms) ? null : ms\n}\n\nconst asDay = (ms: number): string => new Date(ms).toISOString().slice(0, 10)\n\n/** Calendar days a window covers, counting both ends; 1 for an unreadable or inverted one. */\nexport const dayRangeDays = (range: DayRange): number => {\n\tconst from = dayValue(range.from)\n\tconst to = dayValue(range.to)\n\tif (from === null || to === null || to < from) {\n\t\treturn 1\n\t}\n\treturn Math.round((to - from) / DAY_MS) + 1\n}\n\n/**\n * The nearest window the source and the endpoint can both serve, keeping the bound the\n * admin just picked and moving the other one. A window longer than the source's lookback\n * would answer for a shorter span than the picker shows, and one past the endpoint's own\n * cap would not answer at all.\n */\nexport const clampDayRange = (\n\trange: DayRange,\n\tedited: 'from' | 'to',\n\tmaxDays: number | null\n): DayRange => {\n\tconst from = dayValue(range.from)\n\tconst to = dayValue(range.to)\n\tif (from === null || to === null) {\n\t\treturn range\n\t}\n\tconst cap = Math.max(1, Math.min(maxDays ?? MAX_QUERY_RANGE_DAYS, MAX_QUERY_RANGE_DAYS))\n\tif (to < from) {\n\t\treturn edited === 'from'\n\t\t\t? { from: range.from, to: range.from }\n\t\t\t: { from: range.to, to: range.to }\n\t}\n\tif (Math.round((to - from) / DAY_MS) + 1 <= cap) {\n\t\treturn range\n\t}\n\treturn edited === 'from'\n\t\t? { from: range.from, to: asDay(from + (cap - 1) * DAY_MS) }\n\t\t: { from: asDay(to - (cap - 1) * DAY_MS), to: range.to }\n}\n\n/**\n * Caption for a day window, rendered in the reporting timezone the days are read in. Falls\n * back to the raw days when a bound names no calendar day, so a hand-edited URL captions\n * what it asked for rather than rendering `Invalid Date`.\n */\nexport const dayRangeCaption = (range: DayRange, locale: string, timezone: string): string => {\n\tconst start = parseDayOrInstant(range.from, { timezone, edge: 'start' })\n\tconst end = parseDayOrInstant(range.to, { timezone, edge: 'end' })\n\tif (!start || !end) {\n\t\treturn `${range.from} - ${range.to}`\n\t}\n\treturn formatRangeCaption({ start, end }, locale, timezone)\n}\n"],"mappings":";;;AAKA,MAAM,SAAS;;AAGf,MAAM,YAAY,QAA+B;CAChD,MAAM,KAAK,KAAK,MAAM,GAAG,IAAI,eAAe;CAC5C,OAAO,OAAO,MAAM,EAAE,IAAI,OAAO;AAClC;AAEA,MAAM,SAAS,OAAuB,IAAI,KAAK,EAAE,EAAE,YAAY,EAAE,MAAM,GAAG,EAAE;;AAG5E,MAAa,gBAAgB,UAA4B;CACxD,MAAM,OAAO,SAAS,MAAM,IAAI;CAChC,MAAM,KAAK,SAAS,MAAM,EAAE;CAC5B,IAAI,SAAS,QAAQ,OAAO,QAAQ,KAAK,MACxC,OAAO;CAER,OAAO,KAAK,OAAO,KAAK,QAAQ,MAAM,IAAI;AAC3C;;;;;;;AAQA,MAAa,iBACZ,OACA,QACA,YACc;CACd,MAAM,OAAO,SAAS,MAAM,IAAI;CAChC,MAAM,KAAK,SAAS,MAAM,EAAE;CAC5B,IAAI,SAAS,QAAQ,OAAO,MAC3B,OAAO;CAER,MAAM,MAAM,KAAK,IAAI,GAAG,KAAK,IAAI,WAAA,KAAA,GAAqD,CAAC;CACvF,IAAI,KAAK,MACR,OAAO,WAAW,SACf;EAAE,MAAM,MAAM;EAAM,IAAI,MAAM;CAAK,IACnC;EAAE,MAAM,MAAM;EAAI,IAAI,MAAM;CAAG;CAEnC,IAAI,KAAK,OAAO,KAAK,QAAQ,MAAM,IAAI,KAAK,KAC3C,OAAO;CAER,OAAO,WAAW,SACf;EAAE,MAAM,MAAM;EAAM,IAAI,MAAM,QAAQ,MAAM,KAAK,MAAM;CAAE,IACzD;EAAE,MAAM,MAAM,MAAM,MAAM,KAAK,MAAM;EAAG,IAAI,MAAM;CAAG;AACzD;;;;;;AAOA,MAAa,mBAAmB,OAAiB,QAAgB,aAA6B;CAC7F,MAAM,QAAQ,kBAAkB,MAAM,MAAM;EAAE;EAAU,MAAM;CAAQ,CAAC;CACvE,MAAM,MAAM,kBAAkB,MAAM,IAAI;EAAE;EAAU,MAAM;CAAM,CAAC;CACjE,IAAI,CAAC,SAAS,CAAC,KACd,OAAO,GAAG,MAAM,KAAK,KAAK,MAAM;CAEjC,OAAO,mBAAmB;EAAE;EAAO;CAAI,GAAG,QAAQ,QAAQ;AAC3D"}
@@ -0,0 +1 @@
1
+ export { };
@@ -0,0 +1,142 @@
1
+ import { FILTER_OPERATORS } from "../core/contract.js";
2
+ import { GRANULARITY_ORDER } from "../core/granularity.js";
3
+ import { previousWindow, withinLookback } from "../widgets/comparison.js";
4
+ import { parseDayOrInstant } from "../query/dates.js";
5
+ import { dayRangeDays } from "./dayRange.js";
6
+ //#region src/view/gating.ts
7
+ /** Every metric the view can show, in the order the overview cards read. */
8
+ const VIEW_METRIC_ORDER = [
9
+ "pageviews",
10
+ "visitors",
11
+ "visits",
12
+ "sessions",
13
+ "avgDuration",
14
+ "bounceRate",
15
+ "scrollDepth",
16
+ "events",
17
+ "conversions",
18
+ "revenue"
19
+ ];
20
+ const BREAKDOWN_TABS = [
21
+ "pages",
22
+ "sources",
23
+ "technology",
24
+ "geography",
25
+ "events",
26
+ "goals"
27
+ ];
28
+ /**
29
+ * The dimensions each breakdown tab offers, most useful first. Every contract dimension
30
+ * belongs to exactly one tab, so a source that serves a new dimension gains a column
31
+ * rather than an unreachable capability. The first one a source serves is the tab's default,
32
+ * which the reader changes through the breakdown's group-by picker, so the order decides what
33
+ * a link carrying no `dim` opens on and is not free to change.
34
+ *
35
+ * `sources` leads with `channel` rather than `referrer`: a channel mix is the acquisition
36
+ * question a reader opens this tab to ask, and it answers in a dozen buckets where the origins
37
+ * below it run to hundreds of rows. `source` and `referrer` are each one pick away.
38
+ */
39
+ const TAB_DIMENSIONS = {
40
+ pages: ["page"],
41
+ sources: [
42
+ "channel",
43
+ "source",
44
+ "referrer",
45
+ "medium",
46
+ "campaign",
47
+ "utmSource",
48
+ "utmMedium",
49
+ "utmCampaign",
50
+ "utmContent",
51
+ "utmTerm"
52
+ ],
53
+ technology: [
54
+ "device",
55
+ "browser",
56
+ "os"
57
+ ],
58
+ geography: [
59
+ "country",
60
+ "region",
61
+ "city",
62
+ "language"
63
+ ],
64
+ events: ["event"],
65
+ goals: ["goal"]
66
+ };
67
+ const HOUR_INDEX = GRANULARITY_ORDER.indexOf("hour");
68
+ const gate = (caps) => {
69
+ const metricSet = new Set(caps.metrics);
70
+ const dimensionSet = new Set(caps.dimensions);
71
+ const filterSet = new Set(caps.filters);
72
+ const operatorSet = new Set(caps.filterOperators);
73
+ const served = Object.fromEntries(BREAKDOWN_TABS.map((tab) => [tab, TAB_DIMENSIONS[tab].filter((d) => dimensionSet.has(d))]));
74
+ const finest = Math.max(GRANULARITY_ORDER.indexOf(caps.minGranularity), HOUR_INDEX);
75
+ const granularities = GRANULARITY_ORDER.slice(finest);
76
+ return {
77
+ metrics: VIEW_METRIC_ORDER.filter((metric) => metricSet.has(metric)),
78
+ tabs: BREAKDOWN_TABS.filter((tab) => served[tab].length > 0),
79
+ dimensionsFor: (tab) => served[tab],
80
+ canFilter: (dimension) => filterSet.has(dimension),
81
+ operators: FILTER_OPERATORS.filter((operator) => operatorSet.has(operator)),
82
+ granularities,
83
+ maxRangeDays: caps.maxLookbackDays,
84
+ canCompare: caps.comparison,
85
+ canHour: granularities.includes("hour"),
86
+ realtime: caps.realtime,
87
+ goals: metricSet.has("conversions") && dimensionSet.has("goal")
88
+ };
89
+ };
90
+ /**
91
+ * Whether the view may compare this window. `ViewGate.canCompare` answers for the source
92
+ * alone; the previous period must also still be inside the source's lookback, or the
93
+ * endpoint drops the comparison from its answer. The gate sees only capabilities, so every
94
+ * surface that knows the selected window (the toolbar's toggle, the request builder) asks
95
+ * here instead.
96
+ */
97
+ const canCompareRange = (served, range, args) => {
98
+ if (!served.canCompare) return false;
99
+ const { timezone, now } = args;
100
+ const start = parseDayOrInstant(range.from, {
101
+ timezone,
102
+ edge: "start"
103
+ });
104
+ const end = parseDayOrInstant(range.to, {
105
+ timezone,
106
+ edge: "end"
107
+ });
108
+ if (!start || !end) return false;
109
+ const previous = previousWindow({
110
+ start,
111
+ end
112
+ }, timezone);
113
+ return previous !== null && withinLookback(previous, served.maxRangeDays, {
114
+ tz: timezone,
115
+ now
116
+ });
117
+ };
118
+ /**
119
+ * The bucket a range reads best at: hours for a window of a day or two, weeks past four
120
+ * months, days between. Never finer than the source serves, so the endpoint's granularity
121
+ * check cannot reject what the view picked for itself.
122
+ */
123
+ const autoGranularity = (range, caps) => {
124
+ const days = dayRangeDays(range);
125
+ const finest = GRANULARITY_ORDER.indexOf(caps.minGranularity);
126
+ const serves = (granularity) => GRANULARITY_ORDER.indexOf(granularity) >= finest;
127
+ const candidate = days <= 2 && serves("hour") ? "hour" : days > 120 && serves("week") ? "week" : "day";
128
+ return serves(candidate) ? candidate : caps.minGranularity;
129
+ };
130
+ /**
131
+ * The source a view state reads from: the selected one, else the scope's default, else
132
+ * the first readable one. Null when the scope has no readable source at all.
133
+ */
134
+ const resolveSource = (sources, sourceId) => {
135
+ const selected = sourceId ? sources.sources.find((source) => source.id === sourceId) : void 0;
136
+ const fallback = sources.sources.find((source) => source.id === sources.defaultId);
137
+ return selected ?? fallback ?? sources.sources[0] ?? null;
138
+ };
139
+ //#endregion
140
+ export { BREAKDOWN_TABS, TAB_DIMENSIONS, VIEW_METRIC_ORDER, autoGranularity, canCompareRange, gate, resolveSource };
141
+
142
+ //# sourceMappingURL=gating.js.map