@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,76 @@
1
+ "use client";
2
+ import { CARD_CHROME, CARD_LABEL } from "../../widgets/cardChrome.js";
3
+ import { jsx } from "react/jsx-runtime";
4
+ //#region src/view/sections/styles.tsx
5
+ const card = `padding: ${CARD_CHROME.padding}; background: ${CARD_CHROME.background}; border: ${CARD_CHROME.border}; border-radius: ${CARD_CHROME.radius}; box-sizing: border-box;`;
6
+ const VIEW_CSS = `
7
+ .analytics-view { display: flex; flex-direction: column; gap: 1.25rem; padding-bottom: 1.5rem; }
8
+ .analytics-view__title { margin: 0; }
9
+ .analytics-view__toolbar { display: flex; flex-direction: column; gap: 0.75rem; }
10
+ .analytics-view__controls { display: flex; flex-wrap: wrap; align-items: flex-end; gap: 0.75rem; }
11
+ .analytics-view__control { min-width: 10rem; }
12
+ .analytics-view__control .field-type { margin-bottom: 0; }
13
+ .analytics-view__field-label { display: block; font-size: 0.8125rem; color: var(--theme-elevation-600); margin-bottom: 0.35rem; }
14
+ .analytics-view__date { box-sizing: border-box; height: 40px; width: 100%; padding: 0 0.625rem; color: var(--theme-elevation-800); background: var(--theme-input-bg); border: 1px solid var(--theme-elevation-150); border-radius: var(--style-radius-s, 3px); font-family: inherit; font-size: 1rem; transition: border-color 100ms cubic-bezier(0, 0.2, 0.2, 1); }
15
+ .analytics-view__date:hover { border-color: var(--theme-elevation-250); }
16
+ .analytics-view__date:focus { outline: 0; border-color: var(--theme-elevation-400); }
17
+ .analytics-view__toggle { height: 40px; align-items: center; margin: 0; }
18
+ /* Wide enough for the pending label in every locale, so the row never moves mid-refresh. */
19
+ .analytics-view__refresh { height: 40px; min-width: 10.5rem; align-items: center; justify-content: center; margin: 0; }
20
+ .analytics-view__captions { display: flex; flex-wrap: wrap; align-items: center; gap: 0.5rem; margin-inline-start: auto; font-size: 0.8125rem; color: var(--theme-elevation-500); }
21
+ .analytics-view__chips { display: flex; flex-wrap: wrap; align-items: center; gap: 0.4rem; }
22
+ .analytics-view__chip-remove { display: inline-flex; align-items: center; justify-content: center; margin-inline-start: 0.15rem; padding: 0; background: none; border: 0; color: inherit; cursor: pointer; }
23
+ .analytics-view__chip-remove:focus-visible { outline: var(--accessibility-outline, 2px solid var(--theme-elevation-800)); outline-offset: 2px; }
24
+ .analytics-view__cards { display: grid; grid-template-columns: repeat(auto-fit, minmax(10.5rem, 1fr)); gap: 0.75rem; }
25
+ .analytics-view__card { display: flex; flex-direction: column; gap: ${CARD_CHROME.gap}; text-align: start; font: inherit; color: inherit; cursor: pointer; transition: border-color 100ms cubic-bezier(0, 0.2, 0.2, 1); ${card} }
26
+ .analytics-view__card:hover { border-color: var(--theme-elevation-250); }
27
+ .analytics-view__card[aria-pressed='true'] { border-color: var(--theme-elevation-400); background: var(--theme-elevation-100); }
28
+ .analytics-view__card:focus-visible { outline: var(--accessibility-outline, 2px solid var(--theme-elevation-800)); outline-offset: 2px; }
29
+ .analytics-view__label { font-size: ${CARD_LABEL.fontSize}; font-weight: ${CARD_LABEL.fontWeight}; letter-spacing: ${CARD_LABEL.letterSpacing}; text-transform: ${CARD_LABEL.textTransform}; color: ${CARD_LABEL.color}; }
30
+ .analytics-view__value { font-size: 1.5rem; font-weight: 700; line-height: 1.1; font-variant-numeric: tabular-nums; color: var(--theme-elevation-800); }
31
+ .analytics-view__panel { display: flex; flex-direction: column; gap: 0.625rem; ${card} }
32
+ .analytics-view__error { display: flex; flex-direction: column; align-items: flex-start; gap: 0.5rem; }
33
+ .analytics-view__caption { font-size: 0.75rem; color: var(--theme-elevation-400); }
34
+ .analytics-view__section[aria-busy='true'] { opacity: 0.6; transition: opacity 100ms ease-out; }
35
+ .analytics-view__tabs { display: flex; flex-wrap: wrap; gap: 0.25rem; border-bottom: 1px solid var(--theme-elevation-150); }
36
+ .analytics-view__tab { height: 40px; padding: 0 0.75rem; font: inherit; font-size: 0.8125rem; color: var(--theme-elevation-500); background: none; border: 0; border-bottom: 2px solid transparent; cursor: pointer; }
37
+ .analytics-view__tab:hover { color: var(--theme-elevation-800); }
38
+ .analytics-view__tab[aria-selected='true'] { color: var(--theme-elevation-800); border-bottom-color: var(--theme-elevation-800); }
39
+ .analytics-view__tab:focus-visible { outline: var(--accessibility-outline, 2px solid var(--theme-elevation-800)); outline-offset: -2px; }
40
+ .analytics-view__bars-head { display: flex; align-items: center; gap: 0.6rem; padding-bottom: 0.35rem; }
41
+ .analytics-view__bars-head-dimension { flex: 1; min-width: 0; font-size: 0.6875rem; font-weight: 600; letter-spacing: 0.04em; text-transform: uppercase; color: var(--theme-elevation-500); }
42
+ .analytics-view__sort { flex: none; padding: 0; font: inherit; font-size: 0.6875rem; font-weight: 600; letter-spacing: 0.04em; text-transform: uppercase; color: var(--theme-elevation-500); background: none; border: 0; cursor: pointer; }
43
+ .analytics-view__sort:hover, .analytics-view__sort[aria-pressed='true'] { color: var(--theme-elevation-800); }
44
+ .analytics-view__sort:focus-visible { outline: var(--accessibility-outline, 2px solid var(--theme-elevation-800)); outline-offset: 2px; }
45
+ .analytics-view__sort--metric { min-width: 5.5rem; text-align: end; }
46
+ .analytics-view__sort--secondary { min-width: 4.5rem; text-align: end; }
47
+ .analytics-view__breakdown .analytics-bars__value { min-width: 5.5rem; text-align: end; }
48
+ .analytics-view__breakdown .analytics-bars__secondary { min-width: 4.5rem; text-align: end; }
49
+ .analytics-view__table { width: 100%; border-collapse: collapse; font-size: 0.8125rem; }
50
+ .analytics-view__table th { padding: 0.35rem 0.5rem; font-size: 0.6875rem; font-weight: 600; letter-spacing: 0.04em; text-transform: uppercase; color: var(--theme-elevation-500); text-align: end; border-bottom: 1px solid var(--theme-elevation-150); }
51
+ .analytics-view__table th:first-child, .analytics-view__table td:first-child { text-align: start; }
52
+ .analytics-view__table td { padding: 0.4rem 0.5rem; color: var(--theme-elevation-800); font-variant-numeric: tabular-nums; text-align: end; border-bottom: 1px solid var(--theme-elevation-100); }
53
+ .analytics-view__scroll { overflow-x: auto; }
54
+ .analytics-view__skeleton { height: 4.5rem; border-radius: var(--style-radius-m, 6px); background: var(--theme-elevation-100); animation: analytics-view-pulse 1.2s ease-in-out infinite; }
55
+ .analytics-view__skeleton--row { height: 1.85rem; border-radius: var(--style-radius-s, 3px); }
56
+ .analytics-view__skeleton--chart { height: 10rem; }
57
+ .analytics-view__empty { color: var(--theme-elevation-400); font-size: 0.8125rem; }
58
+ .analytics-view__no-sources { display: flex; flex-direction: column; align-items: flex-start; gap: 0.5rem; padding: 2rem 1rem; }
59
+ @keyframes analytics-view-pulse { 50% { opacity: 0.45; } }
60
+ @media (max-width: 768px) {
61
+ .analytics-view__captions { margin-inline-start: 0; }
62
+ .analytics-view__control { flex: 1 1 100%; }
63
+ }
64
+ `;
65
+ /**
66
+ * The analytics view's stylesheet, injected as a `<style>` element: the package has no CSS
67
+ * pipeline (see `ChartStyles`), so the rules ship as a JS string and behave the same in dev
68
+ * and when installed from npm. Every color is a Payload token, so dark mode comes free.
69
+ */
70
+ function ViewStyles() {
71
+ return /* @__PURE__ */ jsx("style", { dangerouslySetInnerHTML: { __html: VIEW_CSS } });
72
+ }
73
+ //#endregion
74
+ export { ViewStyles };
75
+
76
+ //# sourceMappingURL=styles.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"styles.js","names":[],"sources":["../../../src/view/sections/styles.tsx"],"sourcesContent":["'use client'\n\nimport { CARD_CHROME, CARD_LABEL } from '../../widgets/cardChrome'\n\nconst card = `padding: ${CARD_CHROME.padding}; background: ${CARD_CHROME.background}; border: ${CARD_CHROME.border}; border-radius: ${CARD_CHROME.radius}; box-sizing: border-box;`\n\nconst VIEW_CSS = `\n.analytics-view { display: flex; flex-direction: column; gap: 1.25rem; padding-bottom: 1.5rem; }\n.analytics-view__title { margin: 0; }\n.analytics-view__toolbar { display: flex; flex-direction: column; gap: 0.75rem; }\n.analytics-view__controls { display: flex; flex-wrap: wrap; align-items: flex-end; gap: 0.75rem; }\n.analytics-view__control { min-width: 10rem; }\n.analytics-view__control .field-type { margin-bottom: 0; }\n.analytics-view__field-label { display: block; font-size: 0.8125rem; color: var(--theme-elevation-600); margin-bottom: 0.35rem; }\n.analytics-view__date { box-sizing: border-box; height: 40px; width: 100%; padding: 0 0.625rem; color: var(--theme-elevation-800); background: var(--theme-input-bg); border: 1px solid var(--theme-elevation-150); border-radius: var(--style-radius-s, 3px); font-family: inherit; font-size: 1rem; transition: border-color 100ms cubic-bezier(0, 0.2, 0.2, 1); }\n.analytics-view__date:hover { border-color: var(--theme-elevation-250); }\n.analytics-view__date:focus { outline: 0; border-color: var(--theme-elevation-400); }\n.analytics-view__toggle { height: 40px; align-items: center; margin: 0; }\n/* Wide enough for the pending label in every locale, so the row never moves mid-refresh. */\n.analytics-view__refresh { height: 40px; min-width: 10.5rem; align-items: center; justify-content: center; margin: 0; }\n.analytics-view__captions { display: flex; flex-wrap: wrap; align-items: center; gap: 0.5rem; margin-inline-start: auto; font-size: 0.8125rem; color: var(--theme-elevation-500); }\n.analytics-view__chips { display: flex; flex-wrap: wrap; align-items: center; gap: 0.4rem; }\n.analytics-view__chip-remove { display: inline-flex; align-items: center; justify-content: center; margin-inline-start: 0.15rem; padding: 0; background: none; border: 0; color: inherit; cursor: pointer; }\n.analytics-view__chip-remove:focus-visible { outline: var(--accessibility-outline, 2px solid var(--theme-elevation-800)); outline-offset: 2px; }\n.analytics-view__cards { display: grid; grid-template-columns: repeat(auto-fit, minmax(10.5rem, 1fr)); gap: 0.75rem; }\n.analytics-view__card { display: flex; flex-direction: column; gap: ${CARD_CHROME.gap}; text-align: start; font: inherit; color: inherit; cursor: pointer; transition: border-color 100ms cubic-bezier(0, 0.2, 0.2, 1); ${card} }\n.analytics-view__card:hover { border-color: var(--theme-elevation-250); }\n.analytics-view__card[aria-pressed='true'] { border-color: var(--theme-elevation-400); background: var(--theme-elevation-100); }\n.analytics-view__card:focus-visible { outline: var(--accessibility-outline, 2px solid var(--theme-elevation-800)); outline-offset: 2px; }\n.analytics-view__label { font-size: ${CARD_LABEL.fontSize}; font-weight: ${CARD_LABEL.fontWeight}; letter-spacing: ${CARD_LABEL.letterSpacing}; text-transform: ${CARD_LABEL.textTransform}; color: ${CARD_LABEL.color}; }\n.analytics-view__value { font-size: 1.5rem; font-weight: 700; line-height: 1.1; font-variant-numeric: tabular-nums; color: var(--theme-elevation-800); }\n.analytics-view__panel { display: flex; flex-direction: column; gap: 0.625rem; ${card} }\n.analytics-view__error { display: flex; flex-direction: column; align-items: flex-start; gap: 0.5rem; }\n.analytics-view__caption { font-size: 0.75rem; color: var(--theme-elevation-400); }\n.analytics-view__section[aria-busy='true'] { opacity: 0.6; transition: opacity 100ms ease-out; }\n.analytics-view__tabs { display: flex; flex-wrap: wrap; gap: 0.25rem; border-bottom: 1px solid var(--theme-elevation-150); }\n.analytics-view__tab { height: 40px; padding: 0 0.75rem; font: inherit; font-size: 0.8125rem; color: var(--theme-elevation-500); background: none; border: 0; border-bottom: 2px solid transparent; cursor: pointer; }\n.analytics-view__tab:hover { color: var(--theme-elevation-800); }\n.analytics-view__tab[aria-selected='true'] { color: var(--theme-elevation-800); border-bottom-color: var(--theme-elevation-800); }\n.analytics-view__tab:focus-visible { outline: var(--accessibility-outline, 2px solid var(--theme-elevation-800)); outline-offset: -2px; }\n.analytics-view__bars-head { display: flex; align-items: center; gap: 0.6rem; padding-bottom: 0.35rem; }\n.analytics-view__bars-head-dimension { flex: 1; min-width: 0; font-size: 0.6875rem; font-weight: 600; letter-spacing: 0.04em; text-transform: uppercase; color: var(--theme-elevation-500); }\n.analytics-view__sort { flex: none; padding: 0; font: inherit; font-size: 0.6875rem; font-weight: 600; letter-spacing: 0.04em; text-transform: uppercase; color: var(--theme-elevation-500); background: none; border: 0; cursor: pointer; }\n.analytics-view__sort:hover, .analytics-view__sort[aria-pressed='true'] { color: var(--theme-elevation-800); }\n.analytics-view__sort:focus-visible { outline: var(--accessibility-outline, 2px solid var(--theme-elevation-800)); outline-offset: 2px; }\n.analytics-view__sort--metric { min-width: 5.5rem; text-align: end; }\n.analytics-view__sort--secondary { min-width: 4.5rem; text-align: end; }\n.analytics-view__breakdown .analytics-bars__value { min-width: 5.5rem; text-align: end; }\n.analytics-view__breakdown .analytics-bars__secondary { min-width: 4.5rem; text-align: end; }\n.analytics-view__table { width: 100%; border-collapse: collapse; font-size: 0.8125rem; }\n.analytics-view__table th { padding: 0.35rem 0.5rem; font-size: 0.6875rem; font-weight: 600; letter-spacing: 0.04em; text-transform: uppercase; color: var(--theme-elevation-500); text-align: end; border-bottom: 1px solid var(--theme-elevation-150); }\n.analytics-view__table th:first-child, .analytics-view__table td:first-child { text-align: start; }\n.analytics-view__table td { padding: 0.4rem 0.5rem; color: var(--theme-elevation-800); font-variant-numeric: tabular-nums; text-align: end; border-bottom: 1px solid var(--theme-elevation-100); }\n.analytics-view__scroll { overflow-x: auto; }\n.analytics-view__skeleton { height: 4.5rem; border-radius: var(--style-radius-m, 6px); background: var(--theme-elevation-100); animation: analytics-view-pulse 1.2s ease-in-out infinite; }\n.analytics-view__skeleton--row { height: 1.85rem; border-radius: var(--style-radius-s, 3px); }\n.analytics-view__skeleton--chart { height: 10rem; }\n.analytics-view__empty { color: var(--theme-elevation-400); font-size: 0.8125rem; }\n.analytics-view__no-sources { display: flex; flex-direction: column; align-items: flex-start; gap: 0.5rem; padding: 2rem 1rem; }\n@keyframes analytics-view-pulse { 50% { opacity: 0.45; } }\n@media (max-width: 768px) {\n\t.analytics-view__captions { margin-inline-start: 0; }\n\t.analytics-view__control { flex: 1 1 100%; }\n}\n`\n\n/**\n * The analytics view's stylesheet, injected as a `<style>` element: the package has no CSS\n * pipeline (see `ChartStyles`), so the rules ship as a JS string and behave the same in dev\n * and when installed from npm. Every color is a Payload token, so dark mode comes free.\n */\nexport function ViewStyles() {\n\t// biome-ignore lint/security/noDangerouslySetInnerHtml: static build-time CSS constant, no user input\n\treturn <style dangerouslySetInnerHTML={{ __html: VIEW_CSS }} />\n}\n"],"mappings":";;;;AAIA,MAAM,OAAO,YAAY,YAAY,QAAQ,gBAAgB,YAAY,WAAW,YAAY,YAAY,OAAO,mBAAmB,YAAY,OAAO;AAEzJ,MAAM,WAAW;;;;;;;;;;;;;;;;;;;sEAmBqD,YAAY,IAAI,oIAAoI,KAAK;;;;sCAIzL,WAAW,SAAS,iBAAiB,WAAW,WAAW,oBAAoB,WAAW,cAAc,oBAAoB,WAAW,cAAc,WAAW,WAAW,MAAM;;iFAEtI,KAAK;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAwCtF,SAAgB,aAAa;CAE5B,OAAO,oBAAC,SAAD,EAAO,yBAAyB,EAAE,QAAQ,SAAS,EAAI,CAAA;AAC/D"}
@@ -0,0 +1,211 @@
1
+ import { DIMENSION_KEYS, FILTER_OPERATORS } from "../core/contract.js";
2
+ import { zonedCalendarDay } from "../timeframe/tz.js";
3
+ import { TIMEFRAME_PRESETS, resolveTimeframe } from "../timeframe/presets.js";
4
+ import { GRANULARITY_ORDER } from "../core/granularity.js";
5
+ import { BREAKDOWN_TABS, VIEW_METRIC_ORDER } from "./gating.js";
6
+ //#region src/view/state.ts
7
+ /**
8
+ * The presets the toolbar offers. `allTime` is deliberately absent: it is unbounded, and
9
+ * the query endpoint refuses any window longer than a year.
10
+ */
11
+ const VIEW_RANGE_PRESETS = [
12
+ "today",
13
+ "last7days",
14
+ "last30days",
15
+ "last90days",
16
+ "lastYear"
17
+ ];
18
+ const DEFAULT_VIEW_RANGE = "last30days";
19
+ const VIEW_LIMITS = [
20
+ 10,
21
+ 25,
22
+ 50,
23
+ 100
24
+ ];
25
+ const DEFAULT_VIEW_TAB = "pages";
26
+ const KNOWN_METRICS = new Set(VIEW_METRIC_ORDER);
27
+ const KNOWN_DIMENSIONS = new Set(DIMENSION_KEYS);
28
+ const KNOWN_OPERATORS = new Set(FILTER_OPERATORS);
29
+ const KNOWN_GRANULARITIES = new Set(GRANULARITY_ORDER);
30
+ const KNOWN_PRESETS = new Set(TIMEFRAME_PRESETS);
31
+ const DAY_MS = 864e5;
32
+ const DAY_PATTERN = /^\d{4}-\d{2}-\d{2}$/;
33
+ const isRecord = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
34
+ const read = (search, name) => {
35
+ const raw = search.get(name)?.trim();
36
+ return raw ? raw : null;
37
+ };
38
+ /**
39
+ * Epoch ms of a `YYYY-MM-DD` day, or null when it names no real calendar day. The
40
+ * round trip is the validation: `Date.parse` rolls February 30 forward instead of failing.
41
+ */
42
+ const dayValue = (raw) => {
43
+ if (raw === null || !DAY_PATTERN.test(raw)) return null;
44
+ const ms = Date.parse(`${raw}T00:00:00.000Z`);
45
+ if (Number.isNaN(ms) || new Date(ms).toISOString().slice(0, 10) !== raw) return null;
46
+ return ms;
47
+ };
48
+ /** A configured default the view cannot serve falls back to the built-in range. */
49
+ const defaultRange = (defaults) => defaults.range === "allTime" ? DEFAULT_VIEW_RANGE : defaults.range;
50
+ const parseRange = (search, defaults) => {
51
+ const fallback = { range: defaultRange(defaults) };
52
+ const raw = read(search, "range");
53
+ if (raw === null) return fallback;
54
+ if (raw === "custom") {
55
+ const from = dayValue(read(search, "from"));
56
+ const to = dayValue(read(search, "to"));
57
+ if (from === null || to === null || to < from) return fallback;
58
+ if (Math.round((to - from) / DAY_MS) + 1 > 366) return fallback;
59
+ return {
60
+ range: "custom",
61
+ from: new Date(from).toISOString().slice(0, 10),
62
+ to: new Date(to).toISOString().slice(0, 10)
63
+ };
64
+ }
65
+ if (!KNOWN_PRESETS.has(raw) || raw === "allTime") return fallback;
66
+ return { range: raw };
67
+ };
68
+ /**
69
+ * Filters as the endpoint's own parser would accept them, minus its errors: an entry
70
+ * naming a dimension, operator or value outside the contract is dropped rather than
71
+ * failing the whole URL, since a hand-edited link should still open a working view.
72
+ */
73
+ const parseFilters = (search) => {
74
+ const raw = read(search, "filters");
75
+ if (raw === null) return [];
76
+ let decoded;
77
+ try {
78
+ decoded = JSON.parse(raw);
79
+ } catch {
80
+ return [];
81
+ }
82
+ if (!Array.isArray(decoded)) return [];
83
+ const filters = [];
84
+ for (const item of decoded) {
85
+ if (filters.length === 10) break;
86
+ if (!isRecord(item)) continue;
87
+ const { dimension, operator, value } = item;
88
+ if (typeof dimension !== "string" || !KNOWN_DIMENSIONS.has(dimension)) continue;
89
+ if (typeof operator !== "string" || !KNOWN_OPERATORS.has(operator)) continue;
90
+ if (typeof value !== "string") continue;
91
+ const trimmed = value.trim();
92
+ if (trimmed.length < 1 || trimmed.length > 256) continue;
93
+ filters.push({
94
+ dimension,
95
+ operator,
96
+ value: trimmed
97
+ });
98
+ }
99
+ return filters;
100
+ };
101
+ const parseOrder = (search) => {
102
+ const raw = read(search, "order");
103
+ if (raw === null) return;
104
+ const parts = raw.split(":");
105
+ const metric = parts[0] ?? "";
106
+ const direction = parts[1] ?? "";
107
+ if (parts.length !== 2 || !KNOWN_METRICS.has(metric)) return;
108
+ if (direction !== "asc" && direction !== "desc") return;
109
+ return {
110
+ metric,
111
+ direction
112
+ };
113
+ };
114
+ /**
115
+ * Total by construction: every value the URL cannot justify falls back to the install
116
+ * default, so a truncated, stale or hand-edited link always opens a working view.
117
+ */
118
+ const parseViewState = (search, defaults) => {
119
+ const metric = read(search, "metric");
120
+ const granularity = read(search, "granularity");
121
+ const tab = read(search, "tab");
122
+ const dim = read(search, "dim");
123
+ const source = read(search, "source");
124
+ const limit = Number(read(search, "limit"));
125
+ const compare = read(search, "compare");
126
+ const order = parseOrder(search);
127
+ return {
128
+ ...parseRange(search, defaults),
129
+ compare: compare === "1" || compare === "true",
130
+ ...source === null ? {} : { source },
131
+ metric: metric !== null && KNOWN_METRICS.has(metric) ? metric : defaults.metric,
132
+ ...granularity !== null && KNOWN_GRANULARITIES.has(granularity) ? { granularity } : {},
133
+ tab: tab !== null && BREAKDOWN_TABS.includes(tab) ? tab : DEFAULT_VIEW_TAB,
134
+ ...dim !== null && KNOWN_DIMENSIONS.has(dim) ? { dim } : {},
135
+ filters: parseFilters(search),
136
+ limit: VIEW_LIMITS.includes(limit) ? limit : 10,
137
+ ...order === void 0 ? {} : { order }
138
+ };
139
+ };
140
+ /**
141
+ * The shortest URL that parses back to `state`: anything equal to a default is left out,
142
+ * and the keys are written in one fixed order so an unchanged view never rewrites history.
143
+ */
144
+ const serializeViewState = (state, defaults) => {
145
+ const params = new URLSearchParams();
146
+ if (state.range !== defaultRange(defaults)) params.set("range", state.range);
147
+ if (state.range === "custom" && state.from !== void 0 && state.to !== void 0) {
148
+ params.set("from", state.from);
149
+ params.set("to", state.to);
150
+ }
151
+ if (state.compare) params.set("compare", "1");
152
+ if (state.source !== void 0) params.set("source", state.source);
153
+ if (state.metric !== defaults.metric) params.set("metric", state.metric);
154
+ if (state.granularity !== void 0) params.set("granularity", state.granularity);
155
+ if (state.tab !== "pages") params.set("tab", state.tab);
156
+ if (state.dim !== void 0) params.set("dim", state.dim);
157
+ if (state.filters.length > 0) params.set("filters", JSON.stringify(state.filters));
158
+ if (state.limit !== 10) params.set("limit", String(state.limit));
159
+ if (state.order !== void 0) params.set("order", `${state.order.metric}:${state.order.direction}`);
160
+ return params;
161
+ };
162
+ /**
163
+ * The nearest state the selected source can actually serve. The URL outlives a source
164
+ * switch, so a metric, tab, grouping, filter, comparison, bucket or sort the new source lacks is
165
+ * replaced or dropped here rather than sent to the endpoint to be rejected. Returns the
166
+ * same object when the gate forbids nothing, so a render can compare by identity.
167
+ */
168
+ const coerceState = (state, gate) => {
169
+ const metric = gate.metrics.includes(state.metric) ? state.metric : gate.metrics[0] ?? state.metric;
170
+ const tab = gate.tabs.includes(state.tab) ? state.tab : gate.tabs[0] ?? state.tab;
171
+ const dim = state.dim !== void 0 && gate.dimensionsFor(tab).includes(state.dim) ? state.dim : void 0;
172
+ const compare = state.compare && gate.canCompare;
173
+ const filters = state.filters.filter((filter) => gate.canFilter(filter.dimension) && gate.operators.includes(filter.operator));
174
+ const granularity = state.granularity !== void 0 && gate.granularities.includes(state.granularity) ? state.granularity : void 0;
175
+ const order = state.order !== void 0 && gate.metrics.includes(state.order.metric) ? state.order : void 0;
176
+ if (metric === state.metric && tab === state.tab && dim === state.dim && compare === state.compare && filters.length === state.filters.length && granularity === state.granularity && order === state.order) return state;
177
+ return {
178
+ range: state.range,
179
+ ...state.from === void 0 ? {} : { from: state.from },
180
+ ...state.to === void 0 ? {} : { to: state.to },
181
+ compare,
182
+ ...state.source === void 0 ? {} : { source: state.source },
183
+ metric,
184
+ ...granularity === void 0 ? {} : { granularity },
185
+ tab,
186
+ ...dim === void 0 ? {} : { dim },
187
+ filters,
188
+ limit: state.limit,
189
+ ...order === void 0 ? {} : { order }
190
+ };
191
+ };
192
+ /**
193
+ * The inclusive day window a state reads, in the reporting timezone. The endpoint reads
194
+ * `from`/`to` in that same timezone, so the toolbar caption and every request share one
195
+ * answer. `now` is injected to keep callers deterministic.
196
+ */
197
+ const rangeFor = (state, timezone, now) => {
198
+ if (state.range === "custom" && state.from !== void 0 && state.to !== void 0) return {
199
+ from: state.from,
200
+ to: state.to
201
+ };
202
+ const { start, end } = resolveTimeframe(state.range === "custom" ? DEFAULT_VIEW_RANGE : state.range, now, timezone);
203
+ return {
204
+ from: zonedCalendarDay(start, timezone),
205
+ to: zonedCalendarDay(end, timezone)
206
+ };
207
+ };
208
+ //#endregion
209
+ export { DEFAULT_VIEW_RANGE, DEFAULT_VIEW_TAB, VIEW_LIMITS, VIEW_RANGE_PRESETS, coerceState, parseViewState, rangeFor, serializeViewState };
210
+
211
+ //# sourceMappingURL=state.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"state.js","names":[],"sources":["../../src/view/state.ts"],"sourcesContent":["import {\n\ttype AnalyticsFilter,\n\tDIMENSION_KEYS,\n\ttype DimensionKey,\n\tFILTER_OPERATORS,\n\ttype FilterOperator,\n\ttype Granularity,\n\ttype MetricKey,\n} from '../core/contract'\nimport { GRANULARITY_ORDER } from '../core/granularity'\nimport {\n\tMAX_QUERY_FILTER_VALUE_LENGTH,\n\tMAX_QUERY_FILTERS,\n\tMAX_QUERY_RANGE_DAYS,\n} from '../query/limits'\nimport { resolveTimeframe, TIMEFRAME_PRESETS, type TimeframePreset } from '../timeframe/presets'\nimport { zonedCalendarDay } from '../timeframe/tz'\nimport {\n\tBREAKDOWN_TABS,\n\ttype BreakdownTab,\n\ttype DayRange,\n\tVIEW_METRIC_ORDER,\n\ttype ViewGate,\n} from './gating'\n\n/**\n * The presets the toolbar offers. `allTime` is deliberately absent: it is unbounded, and\n * the query endpoint refuses any window longer than a year.\n */\nexport const VIEW_RANGE_PRESETS: TimeframePreset[] = [\n\t'today',\n\t'last7days',\n\t'last30days',\n\t'last90days',\n\t'lastYear',\n]\n\nexport const DEFAULT_VIEW_RANGE: TimeframePreset = 'last30days'\n\nexport const VIEW_LIMITS = [10, 25, 50, 100] as const\n\nexport type ViewLimit = (typeof VIEW_LIMITS)[number]\n\nexport const DEFAULT_VIEW_LIMIT: ViewLimit = 10\n\nexport const DEFAULT_VIEW_TAB: BreakdownTab = 'pages'\n\n/** Everything the view reads from the URL. A view is its state, so a link is a view. */\nexport interface ViewState {\n\trange: TimeframePreset | 'custom'\n\t/** Set only on a custom range: an inclusive `YYYY-MM-DD` day in the reporting timezone. */\n\tfrom?: string\n\tto?: string\n\tcompare: boolean\n\tsource?: string\n\tmetric: MetricKey\n\t/** Absent means automatic; {@link autoGranularity} picks one from the range. */\n\tgranularity?: Granularity\n\ttab: BreakdownTab\n\t/** The dimension the tab groups by. Absent means its default, the first one served. */\n\tdim?: DimensionKey\n\tfilters: AnalyticsFilter[]\n\tlimit: ViewLimit\n\torder?: { metric: MetricKey; direction: 'asc' | 'desc' }\n}\n\n/** The install's configured starting point, as `AnalyticsViewClientProps.defaults` carries it. */\nexport interface ViewDefaults {\n\trange: TimeframePreset\n\tmetric: MetricKey\n}\n\nconst KNOWN_METRICS = new Set<string>(VIEW_METRIC_ORDER)\nconst KNOWN_DIMENSIONS = new Set<string>(DIMENSION_KEYS)\nconst KNOWN_OPERATORS = new Set<string>(FILTER_OPERATORS)\nconst KNOWN_GRANULARITIES = new Set<string>(GRANULARITY_ORDER)\nconst KNOWN_PRESETS = new Set<string>(TIMEFRAME_PRESETS)\nconst DAY_MS = 86_400_000\nconst DAY_PATTERN = /^\\d{4}-\\d{2}-\\d{2}$/\n\nconst isRecord = (value: unknown): value is Record<string, unknown> =>\n\ttypeof value === 'object' && value !== null && !Array.isArray(value)\n\nconst read = (search: URLSearchParams, name: string): string | null => {\n\tconst raw = search.get(name)?.trim()\n\treturn raw ? raw : null\n}\n\n/**\n * Epoch ms of a `YYYY-MM-DD` day, or null when it names no real calendar day. The\n * round trip is the validation: `Date.parse` rolls February 30 forward instead of failing.\n */\nconst dayValue = (raw: string | null): number | null => {\n\tif (raw === null || !DAY_PATTERN.test(raw)) {\n\t\treturn null\n\t}\n\tconst ms = Date.parse(`${raw}T00:00:00.000Z`)\n\tif (Number.isNaN(ms) || new Date(ms).toISOString().slice(0, 10) !== raw) {\n\t\treturn null\n\t}\n\treturn ms\n}\n\n/** A configured default the view cannot serve falls back to the built-in range. */\nconst defaultRange = (defaults: ViewDefaults): TimeframePreset =>\n\tdefaults.range === 'allTime' ? DEFAULT_VIEW_RANGE : defaults.range\n\nconst parseRange = (\n\tsearch: URLSearchParams,\n\tdefaults: ViewDefaults\n): Pick<ViewState, 'range' | 'from' | 'to'> => {\n\tconst fallback = { range: defaultRange(defaults) }\n\tconst raw = read(search, 'range')\n\tif (raw === null) {\n\t\treturn fallback\n\t}\n\tif (raw === 'custom') {\n\t\tconst from = dayValue(read(search, 'from'))\n\t\tconst to = dayValue(read(search, 'to'))\n\t\tif (from === null || to === null || to < from) {\n\t\t\treturn fallback\n\t\t}\n\t\t// Beyond the endpoint's own cap the read would only ever answer `range_too_long`.\n\t\tif (Math.round((to - from) / DAY_MS) + 1 > MAX_QUERY_RANGE_DAYS) {\n\t\t\treturn fallback\n\t\t}\n\t\treturn {\n\t\t\trange: 'custom',\n\t\t\tfrom: new Date(from).toISOString().slice(0, 10),\n\t\t\tto: new Date(to).toISOString().slice(0, 10),\n\t\t}\n\t}\n\tif (!KNOWN_PRESETS.has(raw) || raw === 'allTime') {\n\t\treturn fallback\n\t}\n\treturn { range: raw as TimeframePreset }\n}\n\n/**\n * Filters as the endpoint's own parser would accept them, minus its errors: an entry\n * naming a dimension, operator or value outside the contract is dropped rather than\n * failing the whole URL, since a hand-edited link should still open a working view.\n */\nconst parseFilters = (search: URLSearchParams): AnalyticsFilter[] => {\n\tconst raw = read(search, 'filters')\n\tif (raw === null) {\n\t\treturn []\n\t}\n\tlet decoded: unknown\n\ttry {\n\t\tdecoded = JSON.parse(raw)\n\t} catch {\n\t\treturn []\n\t}\n\tif (!Array.isArray(decoded)) {\n\t\treturn []\n\t}\n\tconst filters: AnalyticsFilter[] = []\n\tfor (const item of decoded) {\n\t\tif (filters.length === MAX_QUERY_FILTERS) {\n\t\t\tbreak\n\t\t}\n\t\tif (!isRecord(item)) {\n\t\t\tcontinue\n\t\t}\n\t\tconst { dimension, operator, value } = item\n\t\tif (typeof dimension !== 'string' || !KNOWN_DIMENSIONS.has(dimension)) {\n\t\t\tcontinue\n\t\t}\n\t\tif (typeof operator !== 'string' || !KNOWN_OPERATORS.has(operator)) {\n\t\t\tcontinue\n\t\t}\n\t\tif (typeof value !== 'string') {\n\t\t\tcontinue\n\t\t}\n\t\tconst trimmed = value.trim()\n\t\tif (trimmed.length < 1 || trimmed.length > MAX_QUERY_FILTER_VALUE_LENGTH) {\n\t\t\tcontinue\n\t\t}\n\t\tfilters.push({\n\t\t\tdimension: dimension as DimensionKey,\n\t\t\toperator: operator as FilterOperator,\n\t\t\tvalue: trimmed,\n\t\t})\n\t}\n\treturn filters\n}\n\nconst parseOrder = (search: URLSearchParams): ViewState['order'] => {\n\tconst raw = read(search, 'order')\n\tif (raw === null) {\n\t\treturn undefined\n\t}\n\tconst parts = raw.split(':')\n\tconst metric = parts[0] ?? ''\n\tconst direction = parts[1] ?? ''\n\tif (parts.length !== 2 || !KNOWN_METRICS.has(metric)) {\n\t\treturn undefined\n\t}\n\tif (direction !== 'asc' && direction !== 'desc') {\n\t\treturn undefined\n\t}\n\treturn { metric: metric as MetricKey, direction }\n}\n\n/**\n * Total by construction: every value the URL cannot justify falls back to the install\n * default, so a truncated, stale or hand-edited link always opens a working view.\n */\nexport const parseViewState = (search: URLSearchParams, defaults: ViewDefaults): ViewState => {\n\tconst metric = read(search, 'metric')\n\tconst granularity = read(search, 'granularity')\n\tconst tab = read(search, 'tab')\n\tconst dim = read(search, 'dim')\n\tconst source = read(search, 'source')\n\tconst limit = Number(read(search, 'limit'))\n\tconst compare = read(search, 'compare')\n\tconst order = parseOrder(search)\n\treturn {\n\t\t...parseRange(search, defaults),\n\t\tcompare: compare === '1' || compare === 'true',\n\t\t...(source === null ? {} : { source }),\n\t\tmetric: metric !== null && KNOWN_METRICS.has(metric) ? (metric as MetricKey) : defaults.metric,\n\t\t...(granularity !== null && KNOWN_GRANULARITIES.has(granularity)\n\t\t\t? { granularity: granularity as Granularity }\n\t\t\t: {}),\n\t\ttab:\n\t\t\ttab !== null && BREAKDOWN_TABS.includes(tab as BreakdownTab)\n\t\t\t\t? (tab as BreakdownTab)\n\t\t\t\t: DEFAULT_VIEW_TAB,\n\t\t...(dim !== null && KNOWN_DIMENSIONS.has(dim) ? { dim: dim as DimensionKey } : {}),\n\t\tfilters: parseFilters(search),\n\t\tlimit: VIEW_LIMITS.includes(limit as ViewLimit) ? (limit as ViewLimit) : DEFAULT_VIEW_LIMIT,\n\t\t...(order === undefined ? {} : { order }),\n\t}\n}\n\n/**\n * The shortest URL that parses back to `state`: anything equal to a default is left out,\n * and the keys are written in one fixed order so an unchanged view never rewrites history.\n */\nexport const serializeViewState = (state: ViewState, defaults: ViewDefaults): URLSearchParams => {\n\tconst params = new URLSearchParams()\n\tif (state.range !== defaultRange(defaults)) {\n\t\tparams.set('range', state.range)\n\t}\n\tif (state.range === 'custom' && state.from !== undefined && state.to !== undefined) {\n\t\tparams.set('from', state.from)\n\t\tparams.set('to', state.to)\n\t}\n\tif (state.compare) {\n\t\tparams.set('compare', '1')\n\t}\n\tif (state.source !== undefined) {\n\t\tparams.set('source', state.source)\n\t}\n\tif (state.metric !== defaults.metric) {\n\t\tparams.set('metric', state.metric)\n\t}\n\tif (state.granularity !== undefined) {\n\t\tparams.set('granularity', state.granularity)\n\t}\n\tif (state.tab !== DEFAULT_VIEW_TAB) {\n\t\tparams.set('tab', state.tab)\n\t}\n\tif (state.dim !== undefined) {\n\t\tparams.set('dim', state.dim)\n\t}\n\tif (state.filters.length > 0) {\n\t\tparams.set('filters', JSON.stringify(state.filters))\n\t}\n\tif (state.limit !== DEFAULT_VIEW_LIMIT) {\n\t\tparams.set('limit', String(state.limit))\n\t}\n\tif (state.order !== undefined) {\n\t\tparams.set('order', `${state.order.metric}:${state.order.direction}`)\n\t}\n\treturn params\n}\n\n/**\n * The nearest state the selected source can actually serve. The URL outlives a source\n * switch, so a metric, tab, grouping, filter, comparison, bucket or sort the new source lacks is\n * replaced or dropped here rather than sent to the endpoint to be rejected. Returns the\n * same object when the gate forbids nothing, so a render can compare by identity.\n */\nexport const coerceState = (state: ViewState, gate: ViewGate): ViewState => {\n\tconst metric = gate.metrics.includes(state.metric)\n\t\t? state.metric\n\t\t: (gate.metrics[0] ?? state.metric)\n\tconst tab = gate.tabs.includes(state.tab) ? state.tab : (gate.tabs[0] ?? state.tab)\n\tconst dim =\n\t\tstate.dim !== undefined && gate.dimensionsFor(tab).includes(state.dim) ? state.dim : undefined\n\tconst compare = state.compare && gate.canCompare\n\tconst filters = state.filters.filter(\n\t\t(filter) => gate.canFilter(filter.dimension) && gate.operators.includes(filter.operator)\n\t)\n\tconst granularity =\n\t\tstate.granularity !== undefined && gate.granularities.includes(state.granularity)\n\t\t\t? state.granularity\n\t\t\t: undefined\n\tconst order =\n\t\tstate.order !== undefined && gate.metrics.includes(state.order.metric) ? state.order : undefined\n\tconst unchanged =\n\t\tmetric === state.metric &&\n\t\ttab === state.tab &&\n\t\tdim === state.dim &&\n\t\tcompare === state.compare &&\n\t\tfilters.length === state.filters.length &&\n\t\tgranularity === state.granularity &&\n\t\torder === state.order\n\tif (unchanged) {\n\t\treturn state\n\t}\n\treturn {\n\t\trange: state.range,\n\t\t...(state.from === undefined ? {} : { from: state.from }),\n\t\t...(state.to === undefined ? {} : { to: state.to }),\n\t\tcompare,\n\t\t...(state.source === undefined ? {} : { source: state.source }),\n\t\tmetric,\n\t\t...(granularity === undefined ? {} : { granularity }),\n\t\ttab,\n\t\t...(dim === undefined ? {} : { dim }),\n\t\tfilters,\n\t\tlimit: state.limit,\n\t\t...(order === undefined ? {} : { order }),\n\t}\n}\n\n/**\n * The inclusive day window a state reads, in the reporting timezone. The endpoint reads\n * `from`/`to` in that same timezone, so the toolbar caption and every request share one\n * answer. `now` is injected to keep callers deterministic.\n */\nexport const rangeFor = (state: ViewState, timezone: string, now: Date): DayRange => {\n\tif (state.range === 'custom' && state.from !== undefined && state.to !== undefined) {\n\t\treturn { from: state.from, to: state.to }\n\t}\n\tconst preset = state.range === 'custom' ? DEFAULT_VIEW_RANGE : state.range\n\tconst { start, end } = resolveTimeframe(preset, now, timezone)\n\treturn { from: zonedCalendarDay(start, timezone), to: zonedCalendarDay(end, timezone) }\n}\n"],"mappings":"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"}
@@ -0,0 +1,153 @@
1
+ "use client";
2
+ import { fetchQuery } from "../query/fetchQuery.js";
3
+ import { autoGranularity, canCompareRange, gate, resolveSource } from "./gating.js";
4
+ import { coerceState, rangeFor } from "./state.js";
5
+ import { useCallback, useEffect, useRef, useState } from "react";
6
+ //#region src/view/useViewQueries.ts
7
+ /**
8
+ * `QueryState.error.message` for a section with nothing to ask for: the scope has no
9
+ * readable source, or the source serves no metric or dimension the section needs. It is
10
+ * never an endpoint failure, so a caller can tell the two apart without a `QueryFetchError`.
11
+ */
12
+ const SECTION_UNAVAILABLE = "analytics: this source serves no data for this section";
13
+ const NO_REQUESTS = {
14
+ cards: null,
15
+ trend: null,
16
+ breakdown: null,
17
+ goals: null
18
+ };
19
+ /**
20
+ * Derives the four reads from the view state and the selected source's capabilities.
21
+ * Pure and total: the state is coerced to what the source serves first, so no request
22
+ * here can carry a metric, dimension, filter, bucket or comparison the endpoint would
23
+ * reject. `now` is injected to keep callers deterministic.
24
+ */
25
+ const buildViewRequests = (props, state, now) => {
26
+ const source = resolveSource(props.sources, state.source);
27
+ if (!source) return NO_REQUESTS;
28
+ const served = gate(source.capabilities);
29
+ if (served.metrics.length === 0) return NO_REQUESTS;
30
+ const view = coerceState(state, served);
31
+ const range = rangeFor(view, props.timezone, now);
32
+ const shared = {
33
+ from: range.from,
34
+ to: range.to,
35
+ ...view.filters.length > 0 ? { filters: view.filters } : {},
36
+ source: source.id,
37
+ timezone: props.timezone
38
+ };
39
+ const compare = view.compare && canCompareRange(served, range, {
40
+ timezone: props.timezone,
41
+ now
42
+ }) ? { compare: "previous" } : {};
43
+ const breakdownMetrics = [view.metric, ...served.metrics.includes("visitors") && view.metric !== "visitors" ? ["visitors"] : []];
44
+ const dimension = view.dim ?? served.dimensionsFor(view.tab)[0];
45
+ const order = view.order !== void 0 && breakdownMetrics.includes(view.order.metric) ? view.order : {
46
+ metric: view.metric,
47
+ direction: "desc"
48
+ };
49
+ return {
50
+ cards: {
51
+ metrics: served.metrics,
52
+ ...shared,
53
+ ...compare
54
+ },
55
+ trend: {
56
+ metrics: [view.metric],
57
+ ...shared,
58
+ granularity: view.granularity ?? autoGranularity(range, source.capabilities),
59
+ ...compare
60
+ },
61
+ breakdown: dimension === void 0 ? null : {
62
+ metrics: breakdownMetrics,
63
+ dimensions: [dimension],
64
+ ...shared,
65
+ limit: view.limit,
66
+ order
67
+ },
68
+ goals: served.goals ? {
69
+ metrics: [
70
+ "conversions",
71
+ ...served.metrics.includes("revenue") ? ["revenue"] : [],
72
+ ...served.metrics.includes("visitors") ? ["visitors"] : []
73
+ ],
74
+ dimensions: ["goal"],
75
+ ...shared
76
+ } : null
77
+ };
78
+ };
79
+ const asError = (err) => err instanceof Error ? err : new Error(String(err));
80
+ /**
81
+ * Runs one section's read. The request is keyed by its serialized form, so a state change
82
+ * that leaves a section's query identical never refetches it, and one that changes it
83
+ * aborts the in-flight read before issuing the new one.
84
+ */
85
+ const useQuerySection = (apiRoute, request) => {
86
+ const [section, setSection] = useState({ status: "loading" });
87
+ const pending = useRef(null);
88
+ const key = request === null ? null : JSON.stringify(request);
89
+ const run = useCallback((serialized) => {
90
+ pending.current?.abort();
91
+ if (serialized === null) {
92
+ pending.current = null;
93
+ setSection({
94
+ status: "error",
95
+ error: /* @__PURE__ */ new Error(SECTION_UNAVAILABLE)
96
+ });
97
+ return;
98
+ }
99
+ const controller = new AbortController();
100
+ pending.current = controller;
101
+ setSection((prev) => prev.status === "loading" ? prev : {
102
+ status: "loading",
103
+ ...prev.data === void 0 ? {} : { data: prev.data }
104
+ });
105
+ fetchQuery(apiRoute, JSON.parse(serialized), { signal: controller.signal }).then((data) => {
106
+ if (!controller.signal.aborted) setSection({
107
+ status: "ok",
108
+ data
109
+ });
110
+ }, (err) => {
111
+ if (!controller.signal.aborted) setSection((prev) => ({
112
+ status: "error",
113
+ error: asError(err),
114
+ ...prev.data === void 0 ? {} : { data: prev.data }
115
+ }));
116
+ });
117
+ }, [apiRoute]);
118
+ const refetch = useCallback(() => {
119
+ run(key);
120
+ }, [run, key]);
121
+ useEffect(() => {
122
+ run(key);
123
+ return () => {
124
+ pending.current?.abort();
125
+ };
126
+ }, [run, key]);
127
+ return {
128
+ ...section,
129
+ isRefetching: section.status === "loading" && section.data !== void 0,
130
+ refetch
131
+ };
132
+ };
133
+ /**
134
+ * The view's four reads for one state, each with its own lifecycle: a section refetches
135
+ * only when its own request changes, and an in-flight read is aborted when it does.
136
+ */
137
+ const useViewQueries = (props, state) => {
138
+ const requests = buildViewRequests(props, state, /* @__PURE__ */ new Date());
139
+ const cards = useQuerySection(props.apiRoute, requests.cards);
140
+ const trend = useQuerySection(props.apiRoute, requests.trend);
141
+ const breakdown = useQuerySection(props.apiRoute, requests.breakdown);
142
+ const goals = useQuerySection(props.apiRoute, requests.goals);
143
+ return {
144
+ cards,
145
+ trend,
146
+ breakdown,
147
+ goals: requests.goals === null ? null : goals
148
+ };
149
+ };
150
+ //#endregion
151
+ export { SECTION_UNAVAILABLE, useViewQueries };
152
+
153
+ //# sourceMappingURL=useViewQueries.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"useViewQueries.js","names":[],"sources":["../../src/view/useViewQueries.ts"],"sourcesContent":["'use client'\n\nimport { useCallback, useEffect, useRef, useState } from 'react'\nimport type { MetricKey } from '../core/contract'\nimport { fetchQuery, type QueryRequest } from '../query/fetchQuery'\nimport type { QueryResponse } from '../query/response'\nimport { autoGranularity, canCompareRange, gate, resolveSource } from './gating'\nimport { coerceState, rangeFor, type ViewState } from './state'\nimport type { AnalyticsViewClientProps } from './viewProps'\n\n/**\n * One section's read. `error` is a `QueryFetchError` whenever the endpoint answered.\n *\n * `data` survives into the next `loading` and into an `error`, so changing the range or\n * hitting a transient failure dims or annotates the chart it already shows instead of\n * blanking it; `isRefetching` is the loading half of that, and is the flag to render a\n * subtle busy affordance on. `status === 'loading'` with no `data` is the only real empty\n * load, and the only one that earns a skeleton. A section that stops being servable at all\n * drops its data, since it belongs to a source or tab the view is no longer showing.\n */\nexport interface QueryState<T> {\n\tstatus: 'loading' | 'ok' | 'error'\n\t/** May be the previous read's answer while `status` is `loading` or `error`. */\n\tdata?: T\n\terror?: Error\n\tisRefetching: boolean\n\trefetch: () => void\n}\n\nexport interface ViewQueries {\n\tcards: QueryState<QueryResponse>\n\ttrend: QueryState<QueryResponse>\n\tbreakdown: QueryState<QueryResponse>\n\t/** Null when the source serves no goal breakdown, so the panel is not rendered at all. */\n\tgoals: QueryState<QueryResponse> | null\n}\n\n/** The four reads a view state implies; a null section is one this source cannot serve. */\nexport interface ViewRequests {\n\tcards: QueryRequest | null\n\ttrend: QueryRequest | null\n\tbreakdown: QueryRequest | null\n\tgoals: QueryRequest | null\n}\n\n/**\n * `QueryState.error.message` for a section with nothing to ask for: the scope has no\n * readable source, or the source serves no metric or dimension the section needs. It is\n * never an endpoint failure, so a caller can tell the two apart without a `QueryFetchError`.\n */\nexport const SECTION_UNAVAILABLE = 'analytics: this source serves no data for this section'\n\nconst NO_REQUESTS: ViewRequests = { cards: null, trend: null, breakdown: null, goals: null }\n\n/**\n * Derives the four reads from the view state and the selected source's capabilities.\n * Pure and total: the state is coerced to what the source serves first, so no request\n * here can carry a metric, dimension, filter, bucket or comparison the endpoint would\n * reject. `now` is injected to keep callers deterministic.\n */\nexport const buildViewRequests = (\n\tprops: AnalyticsViewClientProps,\n\tstate: ViewState,\n\tnow: Date\n): ViewRequests => {\n\tconst source = resolveSource(props.sources, state.source)\n\tif (!source) {\n\t\treturn NO_REQUESTS\n\t}\n\tconst served = gate(source.capabilities)\n\tif (served.metrics.length === 0) {\n\t\treturn NO_REQUESTS\n\t}\n\tconst view = coerceState(state, served)\n\tconst range = rangeFor(view, props.timezone, now)\n\t// The resolved id, not the state's: a stale one in the URL would otherwise ask the\n\t// endpoint for a source that is gone while the gate describes the fallback.\n\tconst shared = {\n\t\tfrom: range.from,\n\t\tto: range.to,\n\t\t...(view.filters.length > 0 ? { filters: view.filters } : {}),\n\t\tsource: source.id,\n\t\ttimezone: props.timezone,\n\t}\n\tconst compare =\n\t\tview.compare && canCompareRange(served, range, { timezone: props.timezone, now })\n\t\t\t? ({ compare: 'previous' } as const)\n\t\t\t: {}\n\tconst breakdownMetrics: MetricKey[] = [\n\t\tview.metric,\n\t\t...(served.metrics.includes('visitors') && view.metric !== 'visitors'\n\t\t\t? (['visitors'] as const)\n\t\t\t: []),\n\t]\n\t// The coerced state only carries a `dim` the tab actually offers, so the picked one can\n\t// be taken as-is and the tab's default is the fallback.\n\tconst dimension = view.dim ?? served.dimensionsFor(view.tab)[0]\n\tconst order: QueryRequest['order'] =\n\t\tview.order !== undefined && breakdownMetrics.includes(view.order.metric)\n\t\t\t? view.order\n\t\t\t: { metric: view.metric, direction: 'desc' }\n\treturn {\n\t\tcards: { metrics: served.metrics, ...shared, ...compare },\n\t\ttrend: {\n\t\t\tmetrics: [view.metric],\n\t\t\t...shared,\n\t\t\tgranularity: view.granularity ?? autoGranularity(range, source.capabilities),\n\t\t\t...compare,\n\t\t},\n\t\tbreakdown:\n\t\t\tdimension === undefined\n\t\t\t\t? null\n\t\t\t\t: {\n\t\t\t\t\t\tmetrics: breakdownMetrics,\n\t\t\t\t\t\tdimensions: [dimension],\n\t\t\t\t\t\t...shared,\n\t\t\t\t\t\tlimit: view.limit,\n\t\t\t\t\t\torder,\n\t\t\t\t\t},\n\t\tgoals: served.goals\n\t\t\t? {\n\t\t\t\t\tmetrics: [\n\t\t\t\t\t\t'conversions',\n\t\t\t\t\t\t...(served.metrics.includes('revenue') ? (['revenue'] as const) : []),\n\t\t\t\t\t\t...(served.metrics.includes('visitors') ? (['visitors'] as const) : []),\n\t\t\t\t\t],\n\t\t\t\t\tdimensions: ['goal'],\n\t\t\t\t\t...shared,\n\t\t\t\t}\n\t\t\t: null,\n\t}\n}\n\nconst asError = (err: unknown): Error => (err instanceof Error ? err : new Error(String(err)))\n\ntype SectionState = Omit<QueryState<QueryResponse>, 'isRefetching' | 'refetch'>\n\n/**\n * Runs one section's read. The request is keyed by its serialized form, so a state change\n * that leaves a section's query identical never refetches it, and one that changes it\n * aborts the in-flight read before issuing the new one.\n */\nconst useQuerySection = (\n\tapiRoute: string,\n\trequest: QueryRequest | null\n): QueryState<QueryResponse> => {\n\tconst [section, setSection] = useState<SectionState>({ status: 'loading' })\n\tconst pending = useRef<AbortController | null>(null)\n\tconst key = request === null ? null : JSON.stringify(request)\n\n\tconst run = useCallback(\n\t\t(serialized: string | null) => {\n\t\t\tpending.current?.abort()\n\t\t\tif (serialized === null) {\n\t\t\t\tpending.current = null\n\t\t\t\tsetSection({ status: 'error', error: new Error(SECTION_UNAVAILABLE) })\n\t\t\t\treturn\n\t\t\t}\n\t\t\tconst controller = new AbortController()\n\t\t\tpending.current = controller\n\t\t\t// Returning `prev` unchanged makes the first read a no-op update rather than a\n\t\t\t// second render; any later one keeps what is on screen until the answer lands.\n\t\t\tsetSection((prev) =>\n\t\t\t\tprev.status === 'loading'\n\t\t\t\t\t? prev\n\t\t\t\t\t: { status: 'loading', ...(prev.data === undefined ? {} : { data: prev.data }) }\n\t\t\t)\n\t\t\tfetchQuery(apiRoute, JSON.parse(serialized) as QueryRequest, {\n\t\t\t\tsignal: controller.signal,\n\t\t\t}).then(\n\t\t\t\t(data) => {\n\t\t\t\t\tif (!controller.signal.aborted) setSection({ status: 'ok', data })\n\t\t\t\t},\n\t\t\t\t(err: unknown) => {\n\t\t\t\t\t// The failure is reported beside whatever is on screen: a transient 503 on a\n\t\t\t\t\t// refetch shows a retry banner over the last good read instead of a blank panel.\n\t\t\t\t\tif (!controller.signal.aborted) {\n\t\t\t\t\t\tsetSection((prev) => ({\n\t\t\t\t\t\t\tstatus: 'error',\n\t\t\t\t\t\t\terror: asError(err),\n\t\t\t\t\t\t\t...(prev.data === undefined ? {} : { data: prev.data }),\n\t\t\t\t\t\t}))\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t)\n\t\t},\n\t\t[apiRoute]\n\t)\n\n\tconst refetch = useCallback(() => {\n\t\trun(key)\n\t}, [run, key])\n\n\tuseEffect(() => {\n\t\trun(key)\n\t\treturn () => {\n\t\t\tpending.current?.abort()\n\t\t}\n\t}, [run, key])\n\n\treturn {\n\t\t...section,\n\t\tisRefetching: section.status === 'loading' && section.data !== undefined,\n\t\trefetch,\n\t}\n}\n\n/**\n * The view's four reads for one state, each with its own lifecycle: a section refetches\n * only when its own request changes, and an in-flight read is aborted when it does.\n */\nexport const useViewQueries = (props: AnalyticsViewClientProps, state: ViewState): ViewQueries => {\n\tconst requests = buildViewRequests(props, state, new Date())\n\tconst cards = useQuerySection(props.apiRoute, requests.cards)\n\tconst trend = useQuerySection(props.apiRoute, requests.trend)\n\tconst breakdown = useQuerySection(props.apiRoute, requests.breakdown)\n\tconst goals = useQuerySection(props.apiRoute, requests.goals)\n\treturn { cards, trend, breakdown, goals: requests.goals === null ? null : goals }\n}\n"],"mappings":"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"}
@@ -0,0 +1,40 @@
1
+ import { MetricKey } from "../core/contract.js";
2
+ import { SourcesResponse } from "../fields/config/fetchSources.js";
3
+ import { TimeframePreset } from "../timeframe/presets.js";
4
+ import { PayloadRequest } from "payload";
5
+
6
+ //#region src/view/viewProps.d.ts
7
+ /** A goal as the view lists it: the picker needs no match or value details. */
8
+ interface ViewGoal {
9
+ slug: string;
10
+ name: string;
11
+ }
12
+ /**
13
+ * Everything the client shell needs to render without a second round trip. Serializable
14
+ * by construction: the RSC boundary drops functions, so only wire shapes appear here.
15
+ */
16
+ interface AnalyticsViewClientProps {
17
+ /** Same payload the sources endpoint answers, resolved for this request's scope. */
18
+ sources: SourcesResponse;
19
+ goals: ViewGoal[];
20
+ defaults: {
21
+ range: TimeframePreset;
22
+ metric: MetricKey;
23
+ };
24
+ apiRoute: string;
25
+ adminRoute: string;
26
+ /** IANA reporting timezone the day boundaries align to. */
27
+ timezone: string;
28
+ /** Admin UI language (`req.i18n.language`), for number and date formatting. */
29
+ locale: string;
30
+ /**
31
+ * The analytics scope this render resolved to, `''` when there is none. The tenant
32
+ * selector sets its cookie and calls `router.refresh()`, which re-renders this shell but
33
+ * keeps client state, and the reads are identical strings for two tenants sharing an
34
+ * adapter id. Keying the client body on this remounts it instead, so a switch refetches.
35
+ */
36
+ scopeKey: string;
37
+ }
38
+ //#endregion
39
+ export { AnalyticsViewClientProps, ViewGoal };
40
+ //# sourceMappingURL=viewProps.d.ts.map