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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (514) hide show
  1. package/CHANGELOG.md +277 -0
  2. package/README.md +15 -4
  3. package/dist/adapters/ga4/disableKey.d.ts +9 -0
  4. package/dist/adapters/ga4/disableKey.js +21 -0
  5. package/dist/adapters/ga4/disableKey.js.map +1 -0
  6. package/dist/adapters/ga4/eventName.d.ts +15 -0
  7. package/dist/adapters/ga4/eventName.js +19 -0
  8. package/dist/adapters/ga4/eventName.js.map +1 -0
  9. package/dist/adapters/ga4/ga4.d.ts +5 -0
  10. package/dist/adapters/ga4/ga4.js +186 -58
  11. package/dist/adapters/ga4/ga4.js.map +1 -1
  12. package/dist/adapters/ga4/measurementId.js +15 -0
  13. package/dist/adapters/ga4/measurementId.js.map +1 -0
  14. package/dist/adapters/goalRead.js +126 -0
  15. package/dist/adapters/goalRead.js.map +1 -0
  16. package/dist/adapters/http/fetchJson.js +1 -1
  17. package/dist/adapters/plausible/plausible.d.ts +25 -0
  18. package/dist/adapters/plausible/plausible.js +159 -38
  19. package/dist/adapters/plausible/plausible.js.map +1 -1
  20. package/dist/adapters/posthog/posthog.d.ts +10 -1
  21. package/dist/adapters/posthog/posthog.js +130 -21
  22. package/dist/adapters/posthog/posthog.js.map +1 -1
  23. package/dist/adapters/series.js +11 -1
  24. package/dist/adapters/series.js.map +1 -1
  25. package/dist/adapters/umami/umami.d.ts +13 -1
  26. package/dist/adapters/umami/umami.js +278 -26
  27. package/dist/adapters/umami/umami.js.map +1 -1
  28. package/dist/binding/resolvePath.js +18 -2
  29. package/dist/binding/resolvePath.js.map +1 -1
  30. package/dist/capture/getTrackerConfig.d.ts +20 -0
  31. package/dist/capture/getTrackerConfig.js +31 -0
  32. package/dist/capture/getTrackerConfig.js.map +1 -0
  33. package/dist/capture/mountPath.js +14 -0
  34. package/dist/capture/mountPath.js.map +1 -0
  35. package/dist/capture/proxyEndpoint.js +127 -0
  36. package/dist/capture/proxyEndpoint.js.map +1 -0
  37. package/dist/capture/proxyRoutes.js +108 -0
  38. package/dist/capture/proxyRoutes.js.map +1 -0
  39. package/dist/capture/requestBody.js +68 -0
  40. package/dist/capture/requestBody.js.map +1 -0
  41. package/dist/capture/slots.d.ts +8 -0
  42. package/dist/capture/slots.js +54 -0
  43. package/dist/capture/slots.js.map +1 -0
  44. package/dist/capture/trackerConfig.d.ts +33 -0
  45. package/dist/capture/trackerConfig.js +95 -0
  46. package/dist/capture/trackerConfig.js.map +1 -0
  47. package/dist/capture/trackerEndpoint.js +35 -0
  48. package/dist/capture/trackerEndpoint.js.map +1 -0
  49. package/dist/charts/BarList.d.ts +16 -1
  50. package/dist/charts/BarList.js +41 -19
  51. package/dist/charts/BarList.js.map +1 -1
  52. package/dist/charts/TrendChart.d.ts +16 -3
  53. package/dist/charts/TrendChart.js +172 -106
  54. package/dist/charts/TrendChart.js.map +1 -1
  55. package/dist/charts/bars.d.ts +4 -0
  56. package/dist/charts/bars.js +3 -1
  57. package/dist/charts/bars.js.map +1 -1
  58. package/dist/charts/bucket.js +10 -1
  59. package/dist/charts/bucket.js.map +1 -1
  60. package/dist/charts/spline.js +2 -2
  61. package/dist/charts/spline.js.map +1 -1
  62. package/dist/charts/styles.js +18 -1
  63. package/dist/charts/styles.js.map +1 -1
  64. package/dist/core/cacheKey.js +26 -3
  65. package/dist/core/cacheKey.js.map +1 -1
  66. package/dist/core/capabilities.d.ts +5 -1
  67. package/dist/core/capabilities.js +11 -2
  68. package/dist/core/capabilities.js.map +1 -1
  69. package/dist/core/capture.d.ts +49 -0
  70. package/dist/core/contract.d.ts +74 -5
  71. package/dist/core/contract.js +30 -1
  72. package/dist/core/contract.js.map +1 -1
  73. package/dist/core/granularity.js +1 -1
  74. package/dist/core/options.d.ts +164 -6
  75. package/dist/core/options.js +126 -3
  76. package/dist/core/options.js.map +1 -1
  77. package/dist/core/registry.d.ts +1 -0
  78. package/dist/core/scopeList.js +32 -0
  79. package/dist/core/scopeList.js.map +1 -0
  80. package/dist/core/scopedRead.js +101 -30
  81. package/dist/core/scopedRead.js.map +1 -1
  82. package/dist/core/serverEvent.d.ts +60 -0
  83. package/dist/core/serverEvent.js +12 -0
  84. package/dist/core/serverEvent.js.map +1 -0
  85. package/dist/exports/adapters/ga4.d.ts +2 -1
  86. package/dist/exports/adapters/ga4.js +2 -1
  87. package/dist/exports/adapters/native.d.ts +3 -1
  88. package/dist/exports/adapters/native.js +2 -1
  89. package/dist/exports/client.d.ts +13 -3
  90. package/dist/exports/client.js +10 -1
  91. package/dist/exports/geo.d.ts +2 -2
  92. package/dist/exports/next.d.ts +2 -1
  93. package/dist/exports/next.js +2 -1
  94. package/dist/exports/react.d.ts +4 -0
  95. package/dist/exports/react.js +5 -0
  96. package/dist/exports/rsc.d.ts +11 -3
  97. package/dist/exports/rsc.js +7 -2
  98. package/dist/exports/tracker.d.ts +21 -0
  99. package/dist/exports/tracker.js +15 -0
  100. package/dist/exports/types.d.ts +16 -3
  101. package/dist/exports/types.js +4 -2
  102. package/dist/fields/AnalyticsPanelClient.js +2 -2
  103. package/dist/fields/AnalyticsPanelField.js +1 -1
  104. package/dist/fields/AnalyticsStatField.js +2 -2
  105. package/dist/fields/config/FilterDimensionSelectField.d.ts +14 -0
  106. package/dist/fields/config/FilterDimensionSelectField.js +77 -0
  107. package/dist/fields/config/FilterDimensionSelectField.js.map +1 -0
  108. package/dist/fields/config/FilterOperatorSelectField.d.ts +14 -0
  109. package/dist/fields/config/FilterOperatorSelectField.js +75 -0
  110. package/dist/fields/config/FilterOperatorSelectField.js.map +1 -0
  111. package/dist/fields/config/MetricSelectField.js +3 -3
  112. package/dist/fields/config/MetricSelectField.js.map +1 -1
  113. package/dist/fields/config/SourceSelectField.js +3 -3
  114. package/dist/fields/config/SourceSelectField.js.map +1 -1
  115. package/dist/fields/config/fetchSources.d.ts +5 -1
  116. package/dist/fields/config/fetchSources.js +7 -3
  117. package/dist/fields/config/fetchSources.js.map +1 -1
  118. package/dist/fields/config/narrow.js +2 -0
  119. package/dist/fields/config/narrow.js.map +1 -1
  120. package/dist/fields/config/sourcesState.js +19 -3
  121. package/dist/fields/config/sourcesState.js.map +1 -1
  122. package/dist/fields/config/useAnalyticsSources.d.ts +8 -3
  123. package/dist/fields/config/useAnalyticsSources.js +9 -6
  124. package/dist/fields/config/useAnalyticsSources.js.map +1 -1
  125. package/dist/fields/config/useFilterCapabilities.d.ts +28 -0
  126. package/dist/fields/config/useFilterCapabilities.js +52 -0
  127. package/dist/fields/config/useFilterCapabilities.js.map +1 -0
  128. package/dist/fields/readForDocument.d.ts +5 -0
  129. package/dist/fields/readForDocument.js +22 -10
  130. package/dist/fields/readForDocument.js.map +1 -1
  131. package/dist/goals/GoalSelectField.d.ts +7 -0
  132. package/dist/goals/GoalSelectField.js +77 -0
  133. package/dist/goals/GoalSelectField.js.map +1 -0
  134. package/dist/goals/collection.js +254 -0
  135. package/dist/goals/collection.js.map +1 -0
  136. package/dist/goals/currency.js +14 -0
  137. package/dist/goals/currency.js.map +1 -0
  138. package/dist/goals/fetchGoals.d.ts +18 -0
  139. package/dist/goals/fetchGoals.js +33 -0
  140. package/dist/goals/fetchGoals.js.map +1 -0
  141. package/dist/goals/goalField.d.ts +31 -0
  142. package/dist/goals/goalField.js +56 -0
  143. package/dist/goals/goalField.js.map +1 -0
  144. package/dist/goals/goalsEndpoint.d.ts +1 -0
  145. package/dist/goals/goalsEndpoint.js +58 -0
  146. package/dist/goals/goalsEndpoint.js.map +1 -0
  147. package/dist/goals/match.js +64 -0
  148. package/dist/goals/match.js.map +1 -0
  149. package/dist/goals/resolver.d.ts +8 -0
  150. package/dist/goals/resolver.js +147 -0
  151. package/dist/goals/resolver.js.map +1 -0
  152. package/dist/goals/trackGoalAction.d.ts +76 -0
  153. package/dist/goals/trackGoalAction.js +158 -0
  154. package/dist/goals/trackGoalAction.js.map +1 -0
  155. package/dist/goals/types.d.ts +33 -0
  156. package/dist/goals/types.js +7 -0
  157. package/dist/goals/types.js.map +1 -0
  158. package/dist/goals/useAnalyticsGoals.d.ts +20 -0
  159. package/dist/goals/useAnalyticsGoals.js +67 -0
  160. package/dist/goals/useAnalyticsGoals.js.map +1 -0
  161. package/dist/index.d.ts +14 -3
  162. package/dist/index.js +174 -19
  163. package/dist/index.js.map +1 -1
  164. package/dist/native/collections/events.js +65 -1
  165. package/dist/native/collections/events.js.map +1 -1
  166. package/dist/native/collections/rollups.js +39 -3
  167. package/dist/native/collections/rollups.js.map +1 -1
  168. package/dist/native/eventScan.js +25 -0
  169. package/dist/native/eventScan.js.map +1 -0
  170. package/dist/native/geo/composeGeoResolvers.js +2 -2
  171. package/dist/native/geo/composeGeoResolvers.js.map +1 -1
  172. package/dist/native/geo/geoResolver.d.ts +9 -2
  173. package/dist/native/geo/geoResolver.js.map +1 -1
  174. package/dist/native/geo/maxmindResolver.js +3 -5
  175. package/dist/native/geo/maxmindResolver.js.map +1 -1
  176. package/dist/native/ingest/bots.d.ts +11 -0
  177. package/dist/native/ingest/bots.js +71 -0
  178. package/dist/native/ingest/bots.js.map +1 -0
  179. package/dist/native/ingest/browser.js +47 -0
  180. package/dist/native/ingest/browser.js.map +1 -0
  181. package/dist/native/ingest/clientIp.js +20 -0
  182. package/dist/native/ingest/clientIp.js.map +1 -0
  183. package/dist/native/ingest/device.js +11 -3
  184. package/dist/native/ingest/device.js.map +1 -1
  185. package/dist/native/ingest/endpoint.d.ts +1 -0
  186. package/dist/native/ingest/endpoint.js +107 -21
  187. package/dist/native/ingest/endpoint.js.map +1 -1
  188. package/dist/native/ingest/flushBatch.js +29 -38
  189. package/dist/native/ingest/flushBatch.js.map +1 -1
  190. package/dist/native/ingest/language.js +14 -0
  191. package/dist/native/ingest/language.js.map +1 -0
  192. package/dist/native/ingest/normalizeEvent.d.ts +30 -0
  193. package/dist/native/ingest/normalizeEvent.js +115 -16
  194. package/dist/native/ingest/normalizeEvent.js.map +1 -1
  195. package/dist/native/ingest/referrer.js +48 -0
  196. package/dist/native/ingest/referrer.js.map +1 -0
  197. package/dist/native/ingest/requestHost.js +57 -0
  198. package/dist/native/ingest/requestHost.js.map +1 -0
  199. package/dist/native/ingest/resolveHostname.d.ts +29 -0
  200. package/dist/native/ingest/resolveHostname.js +52 -0
  201. package/dist/native/ingest/resolveHostname.js.map +1 -0
  202. package/dist/native/ingest/salt.js +27 -2
  203. package/dist/native/ingest/salt.js.map +1 -1
  204. package/dist/native/ingest/serverTrack.d.ts +20 -0
  205. package/dist/native/ingest/serverTrack.js +109 -0
  206. package/dist/native/ingest/serverTrack.js.map +1 -0
  207. package/dist/native/ingest/source.d.ts +11 -0
  208. package/dist/native/ingest/source.js +264 -16
  209. package/dist/native/ingest/source.js.map +1 -1
  210. package/dist/native/ingest/utm.js +33 -0
  211. package/dist/native/ingest/utm.js.map +1 -0
  212. package/dist/native/ingest/validate.js +26 -0
  213. package/dist/native/ingest/validate.js.map +1 -0
  214. package/dist/native/nativeAdapter.d.ts +37 -1
  215. package/dist/native/nativeAdapter.js +175 -22
  216. package/dist/native/nativeAdapter.js.map +1 -1
  217. package/dist/native/query/eventAgg.js +175 -0
  218. package/dist/native/query/eventAgg.js.map +1 -0
  219. package/dist/native/retention/pruneTask.js +53 -13
  220. package/dist/native/retention/pruneTask.js.map +1 -1
  221. package/dist/native/rollupAcc.js +12 -1
  222. package/dist/native/rollupAcc.js.map +1 -1
  223. package/dist/native/rollups/bucketKey.js +15 -0
  224. package/dist/native/rollups/bucketKey.js.map +1 -0
  225. package/dist/native/rollups/bumpRollups.js +116 -0
  226. package/dist/native/rollups/bumpRollups.js.map +1 -0
  227. package/dist/native/rollups/deltas.js +86 -11
  228. package/dist/native/rollups/deltas.js.map +1 -1
  229. package/dist/native/rollups/insertManyIfNew.js +93 -0
  230. package/dist/native/rollups/insertManyIfNew.js.map +1 -0
  231. package/dist/next/captureRewrites.d.ts +42 -0
  232. package/dist/next/captureRewrites.js +57 -0
  233. package/dist/next/captureRewrites.js.map +1 -0
  234. package/dist/next/posthogProxyRewrites.d.ts +5 -0
  235. package/dist/next/posthogProxyRewrites.js +16 -21
  236. package/dist/next/posthogProxyRewrites.js.map +1 -1
  237. package/dist/plugin/documentEndpoint.js +71 -24
  238. package/dist/plugin/documentEndpoint.js.map +1 -1
  239. package/dist/plugin/errors.d.ts +31 -0
  240. package/dist/plugin/errors.js +79 -0
  241. package/dist/plugin/errors.js.map +1 -0
  242. package/dist/plugin/goalHint.d.ts +1 -0
  243. package/dist/plugin/goalHint.js +24 -0
  244. package/dist/plugin/goalHint.js.map +1 -0
  245. package/dist/plugin/paths.js +17 -1
  246. package/dist/plugin/paths.js.map +1 -1
  247. package/dist/plugin/queryEndpoint.js +124 -0
  248. package/dist/plugin/queryEndpoint.js.map +1 -0
  249. package/dist/plugin/readContextForRequest.js +73 -0
  250. package/dist/plugin/readContextForRequest.js.map +1 -0
  251. package/dist/plugin/realtimeEndpoint.js +37 -16
  252. package/dist/plugin/realtimeEndpoint.js.map +1 -1
  253. package/dist/plugin/refreshEndpoint.js +113 -0
  254. package/dist/plugin/refreshEndpoint.js.map +1 -0
  255. package/dist/plugin/runtime.d.ts +1 -0
  256. package/dist/plugin/runtime.js +33 -1
  257. package/dist/plugin/runtime.js.map +1 -1
  258. package/dist/plugin/scopeChange.js +22 -0
  259. package/dist/plugin/scopeChange.js.map +1 -0
  260. package/dist/plugin/scopeFieldBoot.js +22 -0
  261. package/dist/plugin/scopeFieldBoot.js.map +1 -0
  262. package/dist/plugin/sourcesEndpoint.js +16 -41
  263. package/dist/plugin/sourcesEndpoint.js.map +1 -1
  264. package/dist/plugin/warmTask.js +0 -0
  265. package/dist/plugin/warmTask.js.map +1 -1
  266. package/dist/providers/collection.js +89 -29
  267. package/dist/providers/collection.js.map +1 -1
  268. package/dist/providers/factory.js +11 -3
  269. package/dist/providers/factory.js.map +1 -1
  270. package/dist/providers/resolver.js.map +1 -1
  271. package/dist/query/dates.js +64 -0
  272. package/dist/query/dates.js.map +1 -0
  273. package/dist/query/errors.d.ts +14 -0
  274. package/dist/query/fetchQuery.d.ts +79 -0
  275. package/dist/query/fetchQuery.js +117 -0
  276. package/dist/query/fetchQuery.js.map +1 -0
  277. package/dist/query/parse.d.ts +22 -0
  278. package/dist/query/parse.js +168 -0
  279. package/dist/query/parse.js.map +1 -0
  280. package/dist/query/response.d.ts +39 -0
  281. package/dist/query/response.js +11 -0
  282. package/dist/query/response.js.map +1 -0
  283. package/dist/react/AnalyticsProvider.d.ts +50 -0
  284. package/dist/react/AnalyticsProvider.js +67 -0
  285. package/dist/react/AnalyticsProvider.js.map +1 -0
  286. package/dist/react/TrackerBoot.d.ts +22 -0
  287. package/dist/react/TrackerBoot.js +30 -0
  288. package/dist/react/TrackerBoot.js.map +1 -0
  289. package/dist/react/useAnalytics.d.ts +20 -0
  290. package/dist/react/useAnalytics.js +52 -0
  291. package/dist/react/useAnalytics.js.map +1 -0
  292. package/dist/rsc/AnalyticsScripts.d.ts +30 -0
  293. package/dist/rsc/AnalyticsScripts.js +41 -0
  294. package/dist/rsc/AnalyticsScripts.js.map +1 -0
  295. package/dist/surfacing/cacheStore.d.ts +1 -0
  296. package/dist/surfacing/cacheStore.js +18 -2
  297. package/dist/surfacing/cacheStore.js.map +1 -1
  298. package/dist/surfacing/engine.d.ts +1 -0
  299. package/dist/surfacing/engine.js +47 -6
  300. package/dist/surfacing/engine.js.map +1 -1
  301. package/dist/surfacing/epoch.d.ts +1 -0
  302. package/dist/surfacing/epoch.js +72 -0
  303. package/dist/surfacing/epoch.js.map +1 -0
  304. package/dist/surfacing/queue.js +22 -6
  305. package/dist/surfacing/queue.js.map +1 -1
  306. package/dist/surfacing/rateLimiter.js +130 -0
  307. package/dist/surfacing/rateLimiter.js.map +1 -0
  308. package/dist/surfacing/retryPolicy.js +15 -0
  309. package/dist/surfacing/retryPolicy.js.map +1 -0
  310. package/dist/sync/collection.js +23 -7
  311. package/dist/sync/collection.js.map +1 -1
  312. package/dist/sync/syncTask.js +68 -33
  313. package/dist/sync/syncTask.js.map +1 -1
  314. package/dist/testing/memoryAdapter.d.ts +2 -0
  315. package/dist/testing/memoryAdapter.js +17 -1
  316. package/dist/testing/memoryAdapter.js.map +1 -1
  317. package/dist/timeframe/tz.js +17 -6
  318. package/dist/timeframe/tz.js.map +1 -1
  319. package/dist/tracker/autoCapture.d.ts +48 -0
  320. package/dist/tracker/autoCapture.js +129 -0
  321. package/dist/tracker/autoCapture.js.map +1 -0
  322. package/dist/tracker/consent.d.ts +24 -0
  323. package/dist/tracker/consent.js +48 -0
  324. package/dist/tracker/consent.js.map +1 -0
  325. package/dist/tracker/createTracker.d.ts +18 -0
  326. package/dist/tracker/createTracker.js +215 -0
  327. package/dist/tracker/createTracker.js.map +1 -0
  328. package/dist/tracker/exclusion.d.ts +28 -0
  329. package/dist/tracker/exclusion.js +50 -0
  330. package/dist/tracker/exclusion.js.map +1 -0
  331. package/dist/tracker/initTracker.d.ts +22 -0
  332. package/dist/tracker/initTracker.js +33 -0
  333. package/dist/tracker/initTracker.js.map +1 -0
  334. package/dist/tracker/loadScript.d.ts +14 -0
  335. package/dist/tracker/loadScript.js +41 -0
  336. package/dist/tracker/loadScript.js.map +1 -0
  337. package/dist/tracker/pageTracking.d.ts +17 -0
  338. package/dist/tracker/pageTracking.js +38 -0
  339. package/dist/tracker/pageTracking.js.map +1 -0
  340. package/dist/tracker/registry.d.ts +27 -0
  341. package/dist/tracker/registry.js +73 -0
  342. package/dist/tracker/registry.js.map +1 -0
  343. package/dist/tracker/sinks/ga4.d.ts +29 -0
  344. package/dist/tracker/sinks/ga4.js +30 -0
  345. package/dist/tracker/sinks/ga4.js.map +1 -0
  346. package/dist/tracker/sinks/native.d.ts +22 -0
  347. package/dist/tracker/sinks/native.js +56 -0
  348. package/dist/tracker/sinks/native.js.map +1 -0
  349. package/dist/tracker/sinks/plausible.d.ts +20 -0
  350. package/dist/tracker/sinks/plausible.js +32 -0
  351. package/dist/tracker/sinks/plausible.js.map +1 -0
  352. package/dist/tracker/sinks/posthog.d.ts +18 -0
  353. package/dist/tracker/sinks/posthog.js +30 -0
  354. package/dist/tracker/sinks/posthog.js.map +1 -0
  355. package/dist/tracker/sinks/umami.d.ts +18 -0
  356. package/dist/tracker/sinks/umami.js +23 -0
  357. package/dist/tracker/sinks/umami.js.map +1 -0
  358. package/dist/tracker/sinks/vendor.d.ts +14 -0
  359. package/dist/tracker/sinks/vendor.js +81 -0
  360. package/dist/tracker/sinks/vendor.js.map +1 -0
  361. package/dist/tracker/transport.js +28 -0
  362. package/dist/tracker/transport.js.map +1 -0
  363. package/dist/tracker/types.d.ts +91 -0
  364. package/dist/translations/ar.js +221 -0
  365. package/dist/translations/ar.js.map +1 -0
  366. package/dist/translations/de.js +145 -1
  367. package/dist/translations/de.js.map +1 -1
  368. package/dist/translations/en.js +145 -1
  369. package/dist/translations/en.js.map +1 -1
  370. package/dist/translations/es.js +221 -0
  371. package/dist/translations/es.js.map +1 -0
  372. package/dist/translations/fr.js +221 -0
  373. package/dist/translations/fr.js.map +1 -0
  374. package/dist/translations/id.js +221 -0
  375. package/dist/translations/id.js.map +1 -0
  376. package/dist/translations/index.d.ts +10 -1
  377. package/dist/translations/index.js +19 -1
  378. package/dist/translations/index.js.map +1 -1
  379. package/dist/translations/keys.d.ts +144 -0
  380. package/dist/translations/keys.js +145 -1
  381. package/dist/translations/keys.js.map +1 -1
  382. package/dist/translations/ko.js +221 -0
  383. package/dist/translations/ko.js.map +1 -0
  384. package/dist/translations/metricKeys.js +8 -2
  385. package/dist/translations/metricKeys.js.map +1 -1
  386. package/dist/translations/pt.js +221 -0
  387. package/dist/translations/pt.js.map +1 -0
  388. package/dist/translations/ru.js +221 -0
  389. package/dist/translations/ru.js.map +1 -0
  390. package/dist/translations/server.js.map +1 -1
  391. package/dist/translations/uk.js +221 -0
  392. package/dist/translations/uk.js.map +1 -0
  393. package/dist/translations/zh.js +221 -0
  394. package/dist/translations/zh.js.map +1 -0
  395. package/dist/view/AnalyticsNavLink.d.ts +19 -0
  396. package/dist/view/AnalyticsNavLink.js +40 -0
  397. package/dist/view/AnalyticsNavLink.js.map +1 -0
  398. package/dist/view/AnalyticsView.d.ts +23 -0
  399. package/dist/view/AnalyticsView.js +45 -0
  400. package/dist/view/AnalyticsView.js.map +1 -0
  401. package/dist/view/AnalyticsViewClient.d.ts +15 -0
  402. package/dist/view/AnalyticsViewClient.js +244 -0
  403. package/dist/view/AnalyticsViewClient.js.map +1 -0
  404. package/dist/view/authRedirect.js +32 -0
  405. package/dist/view/authRedirect.js.map +1 -0
  406. package/dist/view/conversionRate.js +18 -0
  407. package/dist/view/conversionRate.js.map +1 -0
  408. package/dist/view/dayRange.js +68 -0
  409. package/dist/view/dayRange.js.map +1 -0
  410. package/dist/view/gating.d.ts +1 -0
  411. package/dist/view/gating.js +142 -0
  412. package/dist/view/gating.js.map +1 -0
  413. package/dist/view/labels.js +76 -0
  414. package/dist/view/labels.js.map +1 -0
  415. package/dist/view/registerView.js +48 -0
  416. package/dist/view/registerView.js.map +1 -0
  417. package/dist/view/sections/Breakdowns.js +198 -0
  418. package/dist/view/sections/Breakdowns.js.map +1 -0
  419. package/dist/view/sections/EmptyStates.js +92 -0
  420. package/dist/view/sections/EmptyStates.js.map +1 -0
  421. package/dist/view/sections/FilterChips.js +46 -0
  422. package/dist/view/sections/FilterChips.js.map +1 -0
  423. package/dist/view/sections/GoalsPanel.js +82 -0
  424. package/dist/view/sections/GoalsPanel.js.map +1 -0
  425. package/dist/view/sections/OverviewCards.js +65 -0
  426. package/dist/view/sections/OverviewCards.js.map +1 -0
  427. package/dist/view/sections/RealtimeStrip.js +80 -0
  428. package/dist/view/sections/RealtimeStrip.js.map +1 -0
  429. package/dist/view/sections/Toolbar.js +207 -0
  430. package/dist/view/sections/Toolbar.js.map +1 -0
  431. package/dist/view/sections/Trend.js +125 -0
  432. package/dist/view/sections/Trend.js.map +1 -0
  433. package/dist/view/sections/styles.js +76 -0
  434. package/dist/view/sections/styles.js.map +1 -0
  435. package/dist/view/state.js +211 -0
  436. package/dist/view/state.js.map +1 -0
  437. package/dist/view/useViewQueries.js +153 -0
  438. package/dist/view/useViewQueries.js.map +1 -0
  439. package/dist/view/viewProps.d.ts +40 -0
  440. package/dist/view/viewProps.js +90 -0
  441. package/dist/view/viewProps.js.map +1 -0
  442. package/dist/widgets/AnalyticsBreakdownWidget.d.ts +2 -1
  443. package/dist/widgets/AnalyticsBreakdownWidget.js +78 -11
  444. package/dist/widgets/AnalyticsBreakdownWidget.js.map +1 -1
  445. package/dist/widgets/AnalyticsGoalsWidget.d.ts +14 -0
  446. package/dist/widgets/AnalyticsGoalsWidget.js +196 -0
  447. package/dist/widgets/AnalyticsGoalsWidget.js.map +1 -0
  448. package/dist/widgets/AnalyticsMetricWidget.d.ts +2 -1
  449. package/dist/widgets/AnalyticsMetricWidget.js +63 -13
  450. package/dist/widgets/AnalyticsMetricWidget.js.map +1 -1
  451. package/dist/widgets/AnalyticsRealtimeWidget.d.ts +2 -1
  452. package/dist/widgets/AnalyticsRealtimeWidget.js +44 -22
  453. package/dist/widgets/AnalyticsRealtimeWidget.js.map +1 -1
  454. package/dist/widgets/AnalyticsTrendWidget.d.ts +2 -1
  455. package/dist/widgets/AnalyticsTrendWidget.js +79 -16
  456. package/dist/widgets/AnalyticsTrendWidget.js.map +1 -1
  457. package/dist/widgets/RealtimeCounter.d.ts +4 -0
  458. package/dist/widgets/RealtimeCounter.js +18 -4
  459. package/dist/widgets/RealtimeCounter.js.map +1 -1
  460. package/dist/widgets/WidgetViewLink.js +17 -0
  461. package/dist/widgets/WidgetViewLink.js.map +1 -0
  462. package/dist/widgets/breakdownTypes.js +38 -0
  463. package/dist/widgets/breakdownTypes.js.map +1 -1
  464. package/dist/widgets/cardChrome.js +31 -7
  465. package/dist/widgets/cardChrome.js.map +1 -1
  466. package/dist/widgets/comparison.js +15 -1
  467. package/dist/widgets/comparison.js.map +1 -1
  468. package/dist/widgets/defaults.d.ts +6 -2
  469. package/dist/widgets/defaults.js +78 -23
  470. package/dist/widgets/defaults.js.map +1 -1
  471. package/dist/widgets/filterCaption.js +27 -0
  472. package/dist/widgets/filterCaption.js.map +1 -0
  473. package/dist/widgets/filterField.d.ts +19 -0
  474. package/dist/widgets/filterField.js +75 -0
  475. package/dist/widgets/filterField.js.map +1 -0
  476. package/dist/widgets/prepareWidgetRead.d.ts +7 -0
  477. package/dist/widgets/prepareWidgetRead.js +74 -0
  478. package/dist/widgets/prepareWidgetRead.js.map +1 -0
  479. package/dist/widgets/range.js +43 -12
  480. package/dist/widgets/range.js.map +1 -1
  481. package/dist/widgets/readForWidget.d.ts +26 -3
  482. package/dist/widgets/readForWidget.js +48 -44
  483. package/dist/widgets/readForWidget.js.map +1 -1
  484. package/dist/widgets/readForWidgetBreakdown.d.ts +34 -2
  485. package/dist/widgets/readForWidgetBreakdown.js +53 -49
  486. package/dist/widgets/readForWidgetBreakdown.js.map +1 -1
  487. package/dist/widgets/readForWidgetGoals.d.ts +67 -0
  488. package/dist/widgets/readForWidgetGoals.js +140 -0
  489. package/dist/widgets/readForWidgetGoals.js.map +1 -0
  490. package/dist/widgets/readForWidgetRealtime.d.ts +8 -0
  491. package/dist/widgets/readForWidgetRealtime.js +23 -21
  492. package/dist/widgets/readForWidgetRealtime.js.map +1 -1
  493. package/dist/widgets/readForWidgetSeries.d.ts +26 -2
  494. package/dist/widgets/readForWidgetSeries.js +78 -53
  495. package/dist/widgets/readForWidgetSeries.js.map +1 -1
  496. package/dist/widgets/readMeta.js +18 -0
  497. package/dist/widgets/readMeta.js.map +1 -0
  498. package/dist/widgets/realtimePoll.js +13 -1
  499. package/dist/widgets/realtimePoll.js.map +1 -1
  500. package/dist/widgets/registerWidgets.js +62 -10
  501. package/dist/widgets/registerWidgets.js.map +1 -1
  502. package/dist/widgets/types.d.ts +15 -0
  503. package/dist/widgets/types.js +16 -2
  504. package/dist/widgets/types.js.map +1 -1
  505. package/dist/widgets/viewLink.d.ts +22 -0
  506. package/dist/widgets/viewLink.js +86 -0
  507. package/dist/widgets/viewLink.js.map +1 -0
  508. package/package.json +27 -7
  509. package/dist/native/rollups/applyDistinctDeltas.js +0 -9
  510. package/dist/native/rollups/applyDistinctDeltas.js.map +0 -1
  511. package/dist/native/rollups/bumpRollup.js +0 -68
  512. package/dist/native/rollups/bumpRollup.js.map +0 -1
  513. package/dist/native/rollups/insertIfNew.js +0 -19
  514. package/dist/native/rollups/insertIfNew.js.map +0 -1
@@ -11,6 +11,12 @@ const BREAKDOWN_SPECS = [
11
11
  dimension: "source",
12
12
  label: keys.widgetBreakdownSources
13
13
  },
14
+ {
15
+ slug: "analytics-breakdown-channels",
16
+ dimension: "channel",
17
+ label: keys.widgetBreakdownChannels,
18
+ preferredDefault: "visitors"
19
+ },
14
20
  {
15
21
  slug: "analytics-breakdown-devices",
16
22
  dimension: "device",
@@ -20,6 +26,38 @@ const BREAKDOWN_SPECS = [
20
26
  slug: "analytics-breakdown-countries",
21
27
  dimension: "country",
22
28
  label: keys.widgetBreakdownCountries
29
+ },
30
+ {
31
+ slug: "analytics-breakdown-goals",
32
+ dimension: "goal",
33
+ label: keys.widgetBreakdownGoals,
34
+ preferredDefault: "conversions"
35
+ },
36
+ {
37
+ slug: "analytics-breakdown-referrers",
38
+ dimension: "referrer",
39
+ label: keys.widgetBreakdownReferrers
40
+ },
41
+ {
42
+ slug: "analytics-breakdown-browsers",
43
+ dimension: "browser",
44
+ label: keys.widgetBreakdownBrowsers
45
+ },
46
+ {
47
+ slug: "analytics-breakdown-os",
48
+ dimension: "os",
49
+ label: keys.widgetBreakdownOs
50
+ },
51
+ {
52
+ slug: "analytics-breakdown-campaigns",
53
+ dimension: "utmCampaign",
54
+ label: keys.widgetBreakdownCampaigns
55
+ },
56
+ {
57
+ slug: "analytics-breakdown-events",
58
+ dimension: "event",
59
+ label: keys.widgetBreakdownEvents,
60
+ preferredDefault: "events"
23
61
  }
24
62
  ];
25
63
  const breakdownSpecBySlug = (slug) => BREAKDOWN_SPECS.find((s) => s.slug === slug);
@@ -1 +1 @@
1
- {"version":3,"file":"breakdownTypes.js","names":[],"sources":["../../src/widgets/breakdownTypes.ts"],"sourcesContent":["import type { DimensionKey, MetricKey } from '../core/contract'\nimport type { TimeframePreset } from '../timeframe/presets'\nimport { keys, type TranslationKey } from '../translations/keys'\nimport type { WidgetRange } from './types'\n\nexport interface BreakdownWidgetData {\n\ttitle?: string\n\tmetric?: MetricKey\n\ttimeframe?: TimeframePreset | 'custom'\n\trange?: WidgetRange\n\tlimit?: number\n\tdataSource?: string\n}\n\nexport interface BreakdownSpec {\n\tslug: string\n\tdimension: DimensionKey\n\tlabel: TranslationKey\n}\n\nexport const BREAKDOWN_SPECS: BreakdownSpec[] = [\n\t{ slug: 'analytics-breakdown-pages', dimension: 'page', label: keys.widgetBreakdownPages },\n\t{ slug: 'analytics-breakdown-sources', dimension: 'source', label: keys.widgetBreakdownSources },\n\t{ slug: 'analytics-breakdown-devices', dimension: 'device', label: keys.widgetBreakdownDevices },\n\t{\n\t\tslug: 'analytics-breakdown-countries',\n\t\tdimension: 'country',\n\t\tlabel: keys.widgetBreakdownCountries,\n\t},\n]\n\nexport const breakdownSpecBySlug = (slug: string): BreakdownSpec | undefined =>\n\tBREAKDOWN_SPECS.find((s) => s.slug === slug)\n"],"mappings":";;AAoBA,MAAa,kBAAmC;CAC/C;EAAE,MAAM;EAA6B,WAAW;EAAQ,OAAO,KAAK;CAAqB;CACzF;EAAE,MAAM;EAA+B,WAAW;EAAU,OAAO,KAAK;CAAuB;CAC/F;EAAE,MAAM;EAA+B,WAAW;EAAU,OAAO,KAAK;CAAuB;CAC/F;EACC,MAAM;EACN,WAAW;EACX,OAAO,KAAK;CACb;AACD;AAEA,MAAa,uBAAuB,SACnC,gBAAgB,MAAM,MAAM,EAAE,SAAS,IAAI"}
1
+ {"version":3,"file":"breakdownTypes.js","names":[],"sources":["../../src/widgets/breakdownTypes.ts"],"sourcesContent":["import type { DimensionKey, MetricKey } from '../core/contract'\nimport type { TimeframePreset } from '../timeframe/presets'\nimport { keys, type TranslationKey } from '../translations/keys'\nimport type { WidgetFilter, WidgetRange } from './types'\n\nexport interface BreakdownWidgetData {\n\ttitle?: string\n\tmetric?: MetricKey\n\ttimeframe?: TimeframePreset | 'custom'\n\trange?: WidgetRange\n\tlimit?: number\n\tdataSource?: string\n\tfilter?: WidgetFilter\n}\n\nexport interface BreakdownSpec {\n\tslug: string\n\tdimension: DimensionKey\n\tlabel: TranslationKey\n\tpreferredDefault?: MetricKey\n}\n\nexport const BREAKDOWN_SPECS: BreakdownSpec[] = [\n\t{ slug: 'analytics-breakdown-pages', dimension: 'page', label: keys.widgetBreakdownPages },\n\t{ slug: 'analytics-breakdown-sources', dimension: 'source', label: keys.widgetBreakdownSources },\n\t{\n\t\tslug: 'analytics-breakdown-channels',\n\t\tdimension: 'channel',\n\t\tlabel: keys.widgetBreakdownChannels,\n\t\t// Channels are an acquisition mix, which is a question about people rather than pages.\n\t\tpreferredDefault: 'visitors',\n\t},\n\t{ slug: 'analytics-breakdown-devices', dimension: 'device', label: keys.widgetBreakdownDevices },\n\t{\n\t\tslug: 'analytics-breakdown-countries',\n\t\tdimension: 'country',\n\t\tlabel: keys.widgetBreakdownCountries,\n\t},\n\t{\n\t\tslug: 'analytics-breakdown-goals',\n\t\tdimension: 'goal',\n\t\tlabel: keys.widgetBreakdownGoals,\n\t\t// A goals breakdown is a conversion table: pageviews per goal is a stranger default.\n\t\tpreferredDefault: 'conversions',\n\t},\n\t{\n\t\tslug: 'analytics-breakdown-referrers',\n\t\tdimension: 'referrer',\n\t\tlabel: keys.widgetBreakdownReferrers,\n\t},\n\t{\n\t\tslug: 'analytics-breakdown-browsers',\n\t\tdimension: 'browser',\n\t\tlabel: keys.widgetBreakdownBrowsers,\n\t},\n\t{ slug: 'analytics-breakdown-os', dimension: 'os', label: keys.widgetBreakdownOs },\n\t{\n\t\tslug: 'analytics-breakdown-campaigns',\n\t\tdimension: 'utmCampaign',\n\t\tlabel: keys.widgetBreakdownCampaigns,\n\t},\n\t{\n\t\tslug: 'analytics-breakdown-events',\n\t\tdimension: 'event',\n\t\tlabel: keys.widgetBreakdownEvents,\n\t\tpreferredDefault: 'events',\n\t},\n]\n\nexport const breakdownSpecBySlug = (slug: string): BreakdownSpec | undefined =>\n\tBREAKDOWN_SPECS.find((s) => s.slug === slug)\n"],"mappings":";;AAsBA,MAAa,kBAAmC;CAC/C;EAAE,MAAM;EAA6B,WAAW;EAAQ,OAAO,KAAK;CAAqB;CACzF;EAAE,MAAM;EAA+B,WAAW;EAAU,OAAO,KAAK;CAAuB;CAC/F;EACC,MAAM;EACN,WAAW;EACX,OAAO,KAAK;EAEZ,kBAAkB;CACnB;CACA;EAAE,MAAM;EAA+B,WAAW;EAAU,OAAO,KAAK;CAAuB;CAC/F;EACC,MAAM;EACN,WAAW;EACX,OAAO,KAAK;CACb;CACA;EACC,MAAM;EACN,WAAW;EACX,OAAO,KAAK;EAEZ,kBAAkB;CACnB;CACA;EACC,MAAM;EACN,WAAW;EACX,OAAO,KAAK;CACb;CACA;EACC,MAAM;EACN,WAAW;EACX,OAAO,KAAK;CACb;CACA;EAAE,MAAM;EAA0B,WAAW;EAAM,OAAO,KAAK;CAAkB;CACjF;EACC,MAAM;EACN,WAAW;EACX,OAAO,KAAK;CACb;CACA;EACC,MAAM;EACN,WAAW;EACX,OAAO,KAAK;EACZ,kBAAkB;CACnB;AACD;AAEA,MAAa,uBAAuB,SACnC,gBAAgB,MAAM,MAAM,EAAE,SAAS,IAAI"}
@@ -1,22 +1,46 @@
1
1
  //#region src/widgets/cardChrome.ts
2
- const cardStyle = {
3
- display: "flex",
4
- flexDirection: "column",
2
+ /**
3
+ * The card chrome, as token values rather than only as style objects: the widgets apply them
4
+ * inline (they are server-rendered and the package ships no stylesheet), while the analytics
5
+ * view interpolates the same values into its own injected CSS, where hover and pressed states
6
+ * need real selectors. One definition, so the two surfaces cannot drift apart.
7
+ */
8
+ const CARD_CHROME = {
5
9
  gap: "0.375rem",
6
10
  padding: "var(--base, 1rem)",
7
11
  background: "var(--theme-elevation-50)",
8
12
  border: "1px solid var(--theme-elevation-150)",
9
- borderRadius: "var(--style-radius-m, 6px)",
10
- boxSizing: "border-box"
13
+ radius: "var(--style-radius-m, 6px)"
11
14
  };
12
- const labelStyle = {
15
+ const CARD_LABEL = {
13
16
  fontSize: "0.6875rem",
14
17
  fontWeight: 600,
15
18
  letterSpacing: "0.04em",
16
19
  textTransform: "uppercase",
17
20
  color: "var(--theme-elevation-500)"
18
21
  };
22
+ const cardStyle = {
23
+ display: "flex",
24
+ flexDirection: "column",
25
+ gap: CARD_CHROME.gap,
26
+ padding: CARD_CHROME.padding,
27
+ background: CARD_CHROME.background,
28
+ border: CARD_CHROME.border,
29
+ borderRadius: CARD_CHROME.radius,
30
+ boxSizing: "border-box"
31
+ };
32
+ const labelStyle = { ...CARD_LABEL };
33
+ /** The card's footer link. `marginTop: auto` floors it, so cards of a row line their links up. */
34
+ const linkStyle = {
35
+ marginTop: "auto",
36
+ alignSelf: "flex-start",
37
+ fontSize: "0.75rem",
38
+ fontWeight: 500,
39
+ color: "var(--theme-elevation-500)",
40
+ textDecoration: "underline",
41
+ textUnderlineOffset: "2px"
42
+ };
19
43
  //#endregion
20
- export { cardStyle, labelStyle };
44
+ export { CARD_CHROME, CARD_LABEL, cardStyle, labelStyle, linkStyle };
21
45
 
22
46
  //# sourceMappingURL=cardChrome.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"cardChrome.js","names":[],"sources":["../../src/widgets/cardChrome.ts"],"sourcesContent":["import type { CSSProperties } from 'react'\n\nexport const cardStyle: CSSProperties = {\n\tdisplay: 'flex',\n\tflexDirection: 'column',\n\tgap: '0.375rem',\n\tpadding: 'var(--base, 1rem)',\n\tbackground: 'var(--theme-elevation-50)',\n\tborder: '1px solid var(--theme-elevation-150)',\n\tborderRadius: 'var(--style-radius-m, 6px)',\n\tboxSizing: 'border-box',\n}\n\nexport const labelStyle: CSSProperties = {\n\tfontSize: '0.6875rem',\n\tfontWeight: 600,\n\tletterSpacing: '0.04em',\n\ttextTransform: 'uppercase',\n\tcolor: 'var(--theme-elevation-500)',\n}\n"],"mappings":";AAEA,MAAa,YAA2B;CACvC,SAAS;CACT,eAAe;CACf,KAAK;CACL,SAAS;CACT,YAAY;CACZ,QAAQ;CACR,cAAc;CACd,WAAW;AACZ;AAEA,MAAa,aAA4B;CACxC,UAAU;CACV,YAAY;CACZ,eAAe;CACf,eAAe;CACf,OAAO;AACR"}
1
+ {"version":3,"file":"cardChrome.js","names":[],"sources":["../../src/widgets/cardChrome.ts"],"sourcesContent":["import type { CSSProperties } from 'react'\n\n/**\n * The card chrome, as token values rather than only as style objects: the widgets apply them\n * inline (they are server-rendered and the package ships no stylesheet), while the analytics\n * view interpolates the same values into its own injected CSS, where hover and pressed states\n * need real selectors. One definition, so the two surfaces cannot drift apart.\n */\nexport const CARD_CHROME = {\n\tgap: '0.375rem',\n\tpadding: 'var(--base, 1rem)',\n\tbackground: 'var(--theme-elevation-50)',\n\tborder: '1px solid var(--theme-elevation-150)',\n\tradius: 'var(--style-radius-m, 6px)',\n} as const\n\nexport const CARD_LABEL = {\n\tfontSize: '0.6875rem',\n\tfontWeight: 600,\n\tletterSpacing: '0.04em',\n\ttextTransform: 'uppercase',\n\tcolor: 'var(--theme-elevation-500)',\n} as const\n\nexport const cardStyle: CSSProperties = {\n\tdisplay: 'flex',\n\tflexDirection: 'column',\n\tgap: CARD_CHROME.gap,\n\tpadding: CARD_CHROME.padding,\n\tbackground: CARD_CHROME.background,\n\tborder: CARD_CHROME.border,\n\tborderRadius: CARD_CHROME.radius,\n\tboxSizing: 'border-box',\n}\n\nexport const labelStyle: CSSProperties = { ...CARD_LABEL }\n\n/** The card's footer link. `marginTop: auto` floors it, so cards of a row line their links up. */\nexport const linkStyle: CSSProperties = {\n\tmarginTop: 'auto',\n\talignSelf: 'flex-start',\n\tfontSize: '0.75rem',\n\tfontWeight: 500,\n\tcolor: 'var(--theme-elevation-500)',\n\ttextDecoration: 'underline',\n\ttextUnderlineOffset: '2px',\n}\n"],"mappings":";;;;;;;AAQA,MAAa,cAAc;CAC1B,KAAK;CACL,SAAS;CACT,YAAY;CACZ,QAAQ;CACR,QAAQ;AACT;AAEA,MAAa,aAAa;CACzB,UAAU;CACV,YAAY;CACZ,eAAe;CACf,eAAe;CACf,OAAO;AACR;AAEA,MAAa,YAA2B;CACvC,SAAS;CACT,eAAe;CACf,KAAK,YAAY;CACjB,SAAS,YAAY;CACrB,YAAY,YAAY;CACxB,QAAQ,YAAY;CACpB,cAAc,YAAY;CAC1B,WAAW;AACZ;AAEA,MAAa,aAA4B,EAAE,GAAG,WAAW;;AAGzD,MAAa,YAA2B;CACvC,WAAW;CACX,WAAW;CACX,UAAU;CACV,YAAY;CACZ,OAAO;CACP,gBAAgB;CAChB,qBAAqB;AACtB"}
@@ -26,6 +26,20 @@ const previousWindow = (range, tz = "UTC") => {
26
26
  };
27
27
  };
28
28
  /**
29
+ * Whether a source can still answer for `window`. The engine's clamp floors a read at that
30
+ * read's own end minus the lookback, so a previous window is clamped only when it is itself
31
+ * longer than the lookback: a 60-day range on a 90-day source reads 120 days back unmarked.
32
+ * Callers check this first and omit the comparison instead. The floor uses the clamp's formula
33
+ * but anchors on `now` rather than the read's end, because a provider measures its lookback from
34
+ * today. Fixed-day arithmetic can put it an hour off across a DST change, which is harmless while
35
+ * every caller goes through this one helper.
36
+ */
37
+ const withinLookback = (window, maxLookbackDays, args = {}) => {
38
+ if (maxLookbackDays == null) return true;
39
+ const floor = startOfDayInTz(args.now ?? /* @__PURE__ */ new Date(), args.tz ?? "UTC").getTime() - maxLookbackDays * DAY_MS;
40
+ return window.start.getTime() >= floor;
41
+ };
42
+ /**
29
43
  * Period-over-period delta for one metric value against its previous-window value.
30
44
  * Returns null when either side is missing so the caller can omit the comparison.
31
45
  */
@@ -38,6 +52,6 @@ const computeDelta = (current, previous) => {
38
52
  };
39
53
  };
40
54
  //#endregion
41
- export { computeDelta, previousWindow };
55
+ export { computeDelta, previousWindow, withinLookback };
42
56
 
43
57
  //# sourceMappingURL=comparison.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"comparison.js","names":[],"sources":["../../src/widgets/comparison.ts"],"sourcesContent":["import type { DateRange } from '../core/contract'\nimport { addDaysInTz, DEFAULT_TIMEZONE, startOfDayInTz } from '../timeframe/tz'\n\nexport type DeltaDirection = 'up' | 'down' | 'none'\n\nexport interface MetricDelta {\n\tdirection: DeltaDirection\n\t/**\n\t * Signed percentage change vs the previous value, or null when the previous value is\n\t * 0 (the baseline is undefined, so a percentage would be infinite/meaningless).\n\t */\n\tpercent: number | null\n}\n\nconst DAY_MS = 86_400_000\n\n/**\n * Comparison windows beyond a year are not meaningful period-over-period reads; the cap\n * also rejects the unbounded `allTime` range, which would otherwise compare against a\n * pre-1970 window.\n */\nconst MAX_COMPARISON_DAYS = 366\n\n/**\n * The comparable window immediately preceding `range`, aligned to whole reporting-timezone\n * days so daily rollup stores (which stamp each day at its local midnight) never lose their\n * first day to a mid-day window start. It spans the same count of calendar days the current\n * range touches (the current partial day counts as one) and ends 1ms before the current\n * range's first day. Returns null when the range spans more than\n * {@link MAX_COMPARISON_DAYS} days, where a previous period is not meaningful.\n */\nexport const previousWindow = (\n\trange: DateRange,\n\ttz: string = DEFAULT_TIMEZONE\n): DateRange | null => {\n\tconst firstDay = startOfDayInTz(range.start, tz)\n\tconst lastDay = startOfDayInTz(range.end, tz)\n\tconst days = Math.round((lastDay.getTime() - firstDay.getTime()) / DAY_MS) + 1\n\tif (!Number.isFinite(days) || days < 1 || days > MAX_COMPARISON_DAYS) {\n\t\treturn null\n\t}\n\treturn { start: addDaysInTz(firstDay, -days, tz), end: new Date(firstDay.getTime() - 1) }\n}\n\n/**\n * Period-over-period delta for one metric value against its previous-window value.\n * Returns null when either side is missing so the caller can omit the comparison.\n */\nexport const computeDelta = (current?: number, previous?: number): MetricDelta | null => {\n\tif (current === undefined || previous === undefined) {\n\t\treturn null\n\t}\n\tconst diff = current - previous\n\tconst direction: DeltaDirection = diff > 0 ? 'up' : diff < 0 ? 'down' : 'none'\n\tconst percent = previous === 0 ? null : (diff / previous) * 100\n\treturn { direction, percent }\n}\n"],"mappings":";;AAcA,MAAM,SAAS;;;;;;AAOf,MAAM,sBAAsB;;;;;;;;;AAU5B,MAAa,kBACZ,OACA,KAAA,UACsB;CACtB,MAAM,WAAW,eAAe,MAAM,OAAO,EAAE;CAC/C,MAAM,UAAU,eAAe,MAAM,KAAK,EAAE;CAC5C,MAAM,OAAO,KAAK,OAAO,QAAQ,QAAQ,IAAI,SAAS,QAAQ,KAAK,MAAM,IAAI;CAC7E,IAAI,CAAC,OAAO,SAAS,IAAI,KAAK,OAAO,KAAK,OAAO,qBAChD,OAAO;CAER,OAAO;EAAE,OAAO,YAAY,UAAU,CAAC,MAAM,EAAE;EAAG,qBAAK,IAAI,KAAK,SAAS,QAAQ,IAAI,CAAC;CAAE;AACzF;;;;;AAMA,MAAa,gBAAgB,SAAkB,aAA0C;CACxF,IAAI,YAAY,KAAA,KAAa,aAAa,KAAA,GACzC,OAAO;CAER,MAAM,OAAO,UAAU;CAGvB,OAAO;EAAE,WAFyB,OAAO,IAAI,OAAO,OAAO,IAAI,SAAS;EAEpD,SADJ,aAAa,IAAI,OAAQ,OAAO,WAAY;CAChC;AAC7B"}
1
+ {"version":3,"file":"comparison.js","names":[],"sources":["../../src/widgets/comparison.ts"],"sourcesContent":["import type { DateRange } from '../core/contract'\nimport { addDaysInTz, DEFAULT_TIMEZONE, startOfDayInTz } from '../timeframe/tz'\n\nexport type DeltaDirection = 'up' | 'down' | 'none'\n\nexport interface MetricDelta {\n\tdirection: DeltaDirection\n\t/**\n\t * Signed percentage change vs the previous value, or null when the previous value is\n\t * 0 (the baseline is undefined, so a percentage would be infinite/meaningless).\n\t */\n\tpercent: number | null\n}\n\nconst DAY_MS = 86_400_000\n\n/**\n * Comparison windows beyond a year are not meaningful period-over-period reads; the cap\n * also rejects the unbounded `allTime` range, which would otherwise compare against a\n * pre-1970 window.\n */\nconst MAX_COMPARISON_DAYS = 366\n\n/**\n * The comparable window immediately preceding `range`, aligned to whole reporting-timezone\n * days so daily rollup stores (which stamp each day at its local midnight) never lose their\n * first day to a mid-day window start. It spans the same count of calendar days the current\n * range touches (the current partial day counts as one) and ends 1ms before the current\n * range's first day. Returns null when the range spans more than\n * {@link MAX_COMPARISON_DAYS} days, where a previous period is not meaningful.\n */\nexport const previousWindow = (\n\trange: DateRange,\n\ttz: string = DEFAULT_TIMEZONE\n): DateRange | null => {\n\tconst firstDay = startOfDayInTz(range.start, tz)\n\tconst lastDay = startOfDayInTz(range.end, tz)\n\tconst days = Math.round((lastDay.getTime() - firstDay.getTime()) / DAY_MS) + 1\n\tif (!Number.isFinite(days) || days < 1 || days > MAX_COMPARISON_DAYS) {\n\t\treturn null\n\t}\n\treturn { start: addDaysInTz(firstDay, -days, tz), end: new Date(firstDay.getTime() - 1) }\n}\n\n/**\n * Whether a source can still answer for `window`. The engine's clamp floors a read at that\n * read's own end minus the lookback, so a previous window is clamped only when it is itself\n * longer than the lookback: a 60-day range on a 90-day source reads 120 days back unmarked.\n * Callers check this first and omit the comparison instead. The floor uses the clamp's formula\n * but anchors on `now` rather than the read's end, because a provider measures its lookback from\n * today. Fixed-day arithmetic can put it an hour off across a DST change, which is harmless while\n * every caller goes through this one helper.\n */\nexport const withinLookback = (\n\twindow: DateRange,\n\tmaxLookbackDays: number | null,\n\targs: { tz?: string; now?: Date } = {}\n): boolean => {\n\tif (maxLookbackDays == null) {\n\t\treturn true\n\t}\n\tconst floor =\n\t\tstartOfDayInTz(args.now ?? new Date(), args.tz ?? DEFAULT_TIMEZONE).getTime() -\n\t\tmaxLookbackDays * DAY_MS\n\treturn window.start.getTime() >= floor\n}\n\n/**\n * Period-over-period delta for one metric value against its previous-window value.\n * Returns null when either side is missing so the caller can omit the comparison.\n */\nexport const computeDelta = (current?: number, previous?: number): MetricDelta | null => {\n\tif (current === undefined || previous === undefined) {\n\t\treturn null\n\t}\n\tconst diff = current - previous\n\tconst direction: DeltaDirection = diff > 0 ? 'up' : diff < 0 ? 'down' : 'none'\n\tconst percent = previous === 0 ? null : (diff / previous) * 100\n\treturn { direction, percent }\n}\n"],"mappings":";;AAcA,MAAM,SAAS;;;;;;AAOf,MAAM,sBAAsB;;;;;;;;;AAU5B,MAAa,kBACZ,OACA,KAAA,UACsB;CACtB,MAAM,WAAW,eAAe,MAAM,OAAO,EAAE;CAC/C,MAAM,UAAU,eAAe,MAAM,KAAK,EAAE;CAC5C,MAAM,OAAO,KAAK,OAAO,QAAQ,QAAQ,IAAI,SAAS,QAAQ,KAAK,MAAM,IAAI;CAC7E,IAAI,CAAC,OAAO,SAAS,IAAI,KAAK,OAAO,KAAK,OAAO,qBAChD,OAAO;CAER,OAAO;EAAE,OAAO,YAAY,UAAU,CAAC,MAAM,EAAE;EAAG,qBAAK,IAAI,KAAK,SAAS,QAAQ,IAAI,CAAC;CAAE;AACzF;;;;;;;;;;AAWA,MAAa,kBACZ,QACA,iBACA,OAAoC,CAAC,MACxB;CACb,IAAI,mBAAmB,MACtB,OAAO;CAER,MAAM,QACL,eAAe,KAAK,uBAAO,IAAI,KAAK,GAAG,KAAK,MAAA,KAAsB,EAAE,QAAQ,IAC5E,kBAAkB;CACnB,OAAO,OAAO,MAAM,QAAQ,KAAK;AAClC;;;;;AAMA,MAAa,gBAAgB,SAAkB,aAA0C;CACxF,IAAI,YAAY,KAAA,KAAa,aAAa,KAAA,GACzC,OAAO;CAER,MAAM,OAAO,UAAU;CAGvB,OAAO;EAAE,WAFyB,OAAO,IAAI,OAAO,OAAO,IAAI,SAAS;EAEpD,SADJ,aAAa,IAAI,OAAQ,OAAO,WAAY;CAChC;AAC7B"}
@@ -3,8 +3,12 @@ import { WidgetInstance } from "payload";
3
3
  //#region src/widgets/defaults.d.ts
4
4
  /**
5
5
  * Default analytics widget instances to spread into an app's own
6
- * `admin.dashboard.defaultLayout`. A plugin must never set `defaultLayout` itself
7
- * (Payload applies it with `??=`, so any setter would clobber the app's layout).
6
+ * `admin.dashboard.defaultLayout`: every built-in widget, headline numbers first, then the
7
+ * trend, the goals table, the realtime counter and one card per breakdown. A plugin must
8
+ * never set `defaultLayout` itself (Payload applies it with `??=`, so any setter would
9
+ * clobber the app's layout). Each slug is spelled out rather than mapped from
10
+ * `BREAKDOWN_SPECS`, because an app's generated types narrow `widgetSlug` to its own
11
+ * registered widgets; `defaults.test.ts` is what keeps the list complete.
8
12
  */
9
13
  declare const analyticsDefaultWidgets: () => WidgetInstance[];
10
14
  //#endregion
@@ -1,68 +1,123 @@
1
1
  //#region src/widgets/defaults.ts
2
+ const TIMEFRAME = "last30days";
3
+ /** The data every breakdown card opens with: its dimension's top five by pageviews. */
4
+ const BREAKDOWN_DATA = {
5
+ metric: "pageviews",
6
+ timeframe: TIMEFRAME,
7
+ limit: 5
8
+ };
2
9
  /**
3
10
  * Default analytics widget instances to spread into an app's own
4
- * `admin.dashboard.defaultLayout`. A plugin must never set `defaultLayout` itself
5
- * (Payload applies it with `??=`, so any setter would clobber the app's layout).
11
+ * `admin.dashboard.defaultLayout`: every built-in widget, headline numbers first, then the
12
+ * trend, the goals table, the realtime counter and one card per breakdown. A plugin must
13
+ * never set `defaultLayout` itself (Payload applies it with `??=`, so any setter would
14
+ * clobber the app's layout). Each slug is spelled out rather than mapped from
15
+ * `BREAKDOWN_SPECS`, because an app's generated types narrow `widgetSlug` to its own
16
+ * registered widgets; `defaults.test.ts` is what keeps the list complete.
6
17
  */
7
18
  const analyticsDefaultWidgets = () => [
8
19
  {
9
- widgetSlug: "analytics-trend",
10
- width: "large",
20
+ widgetSlug: "analytics-metric",
21
+ width: "small",
11
22
  data: {
12
23
  metric: "pageviews",
13
- timeframe: "last30days"
24
+ timeframe: TIMEFRAME
14
25
  }
15
26
  },
16
27
  {
17
28
  widgetSlug: "analytics-metric",
18
29
  width: "small",
30
+ data: {
31
+ metric: "visitors",
32
+ timeframe: TIMEFRAME
33
+ }
34
+ },
35
+ {
36
+ widgetSlug: "analytics-trend",
37
+ width: "large",
19
38
  data: {
20
39
  metric: "pageviews",
21
- timeframe: "last30days"
40
+ timeframe: TIMEFRAME
22
41
  }
23
42
  },
24
43
  {
25
- widgetSlug: "analytics-metric",
44
+ widgetSlug: "analytics-goals",
45
+ width: "medium",
46
+ data: {
47
+ timeframe: TIMEFRAME,
48
+ limit: "10"
49
+ }
50
+ },
51
+ {
52
+ widgetSlug: "analytics-realtime",
26
53
  width: "small",
27
54
  data: {
28
55
  metric: "visitors",
29
- timeframe: "last30days"
56
+ windowMinutes: "30"
30
57
  }
31
58
  },
32
59
  {
33
60
  widgetSlug: "analytics-breakdown-pages",
34
61
  width: "medium",
35
- data: {
36
- metric: "pageviews",
37
- timeframe: "last30days",
38
- limit: 5
39
- }
62
+ data: BREAKDOWN_DATA
40
63
  },
41
64
  {
42
65
  widgetSlug: "analytics-breakdown-sources",
43
66
  width: "medium",
67
+ data: BREAKDOWN_DATA
68
+ },
69
+ {
70
+ widgetSlug: "analytics-breakdown-channels",
71
+ width: "medium",
44
72
  data: {
45
- metric: "pageviews",
46
- timeframe: "last30days",
47
- limit: 5
73
+ ...BREAKDOWN_DATA,
74
+ metric: "visitors"
48
75
  }
49
76
  },
50
77
  {
51
78
  widgetSlug: "analytics-breakdown-devices",
52
79
  width: "medium",
80
+ data: BREAKDOWN_DATA
81
+ },
82
+ {
83
+ widgetSlug: "analytics-breakdown-countries",
84
+ width: "medium",
85
+ data: BREAKDOWN_DATA
86
+ },
87
+ {
88
+ widgetSlug: "analytics-breakdown-goals",
89
+ width: "medium",
53
90
  data: {
54
- metric: "pageviews",
55
- timeframe: "last30days",
56
- limit: 5
91
+ ...BREAKDOWN_DATA,
92
+ metric: "conversions"
57
93
  }
58
94
  },
59
95
  {
60
- widgetSlug: "analytics-breakdown-countries",
96
+ widgetSlug: "analytics-breakdown-referrers",
97
+ width: "medium",
98
+ data: BREAKDOWN_DATA
99
+ },
100
+ {
101
+ widgetSlug: "analytics-breakdown-browsers",
102
+ width: "medium",
103
+ data: BREAKDOWN_DATA
104
+ },
105
+ {
106
+ widgetSlug: "analytics-breakdown-os",
107
+ width: "medium",
108
+ data: BREAKDOWN_DATA
109
+ },
110
+ {
111
+ widgetSlug: "analytics-breakdown-campaigns",
112
+ width: "medium",
113
+ data: BREAKDOWN_DATA
114
+ },
115
+ {
116
+ widgetSlug: "analytics-breakdown-events",
61
117
  width: "medium",
62
118
  data: {
63
- metric: "pageviews",
64
- timeframe: "last30days",
65
- limit: 5
119
+ ...BREAKDOWN_DATA,
120
+ metric: "events"
66
121
  }
67
122
  }
68
123
  ];
@@ -1 +1 @@
1
- {"version":3,"file":"defaults.js","names":[],"sources":["../../src/widgets/defaults.ts"],"sourcesContent":["import type { WidgetInstance } from 'payload'\n\n/**\n * Default analytics widget instances to spread into an app's own\n * `admin.dashboard.defaultLayout`. A plugin must never set `defaultLayout` itself\n * (Payload applies it with `??=`, so any setter would clobber the app's layout).\n */\nexport const analyticsDefaultWidgets = (): WidgetInstance[] => [\n\t{\n\t\twidgetSlug: 'analytics-trend',\n\t\twidth: 'large',\n\t\tdata: { metric: 'pageviews', timeframe: 'last30days' },\n\t},\n\t{\n\t\twidgetSlug: 'analytics-metric',\n\t\twidth: 'small',\n\t\tdata: { metric: 'pageviews', timeframe: 'last30days' },\n\t},\n\t{\n\t\twidgetSlug: 'analytics-metric',\n\t\twidth: 'small',\n\t\tdata: { metric: 'visitors', timeframe: 'last30days' },\n\t},\n\t{\n\t\twidgetSlug: 'analytics-breakdown-pages',\n\t\twidth: 'medium',\n\t\tdata: { metric: 'pageviews', timeframe: 'last30days', limit: 5 },\n\t},\n\t{\n\t\twidgetSlug: 'analytics-breakdown-sources',\n\t\twidth: 'medium',\n\t\tdata: { metric: 'pageviews', timeframe: 'last30days', limit: 5 },\n\t},\n\t{\n\t\twidgetSlug: 'analytics-breakdown-devices',\n\t\twidth: 'medium',\n\t\tdata: { metric: 'pageviews', timeframe: 'last30days', limit: 5 },\n\t},\n\t{\n\t\twidgetSlug: 'analytics-breakdown-countries',\n\t\twidth: 'medium',\n\t\tdata: { metric: 'pageviews', timeframe: 'last30days', limit: 5 },\n\t},\n]\n"],"mappings":";;;;;;AAOA,MAAa,gCAAkD;CAC9D;EACC,YAAY;EACZ,OAAO;EACP,MAAM;GAAE,QAAQ;GAAa,WAAW;EAAa;CACtD;CACA;EACC,YAAY;EACZ,OAAO;EACP,MAAM;GAAE,QAAQ;GAAa,WAAW;EAAa;CACtD;CACA;EACC,YAAY;EACZ,OAAO;EACP,MAAM;GAAE,QAAQ;GAAY,WAAW;EAAa;CACrD;CACA;EACC,YAAY;EACZ,OAAO;EACP,MAAM;GAAE,QAAQ;GAAa,WAAW;GAAc,OAAO;EAAE;CAChE;CACA;EACC,YAAY;EACZ,OAAO;EACP,MAAM;GAAE,QAAQ;GAAa,WAAW;GAAc,OAAO;EAAE;CAChE;CACA;EACC,YAAY;EACZ,OAAO;EACP,MAAM;GAAE,QAAQ;GAAa,WAAW;GAAc,OAAO;EAAE;CAChE;CACA;EACC,YAAY;EACZ,OAAO;EACP,MAAM;GAAE,QAAQ;GAAa,WAAW;GAAc,OAAO;EAAE;CAChE;AACD"}
1
+ {"version":3,"file":"defaults.js","names":[],"sources":["../../src/widgets/defaults.ts"],"sourcesContent":["import type { WidgetInstance } from 'payload'\n\nconst TIMEFRAME = 'last30days'\n\n/** The data every breakdown card opens with: its dimension's top five by pageviews. */\nconst BREAKDOWN_DATA = { metric: 'pageviews', timeframe: TIMEFRAME, limit: 5 } as const\n\n/**\n * Default analytics widget instances to spread into an app's own\n * `admin.dashboard.defaultLayout`: every built-in widget, headline numbers first, then the\n * trend, the goals table, the realtime counter and one card per breakdown. A plugin must\n * never set `defaultLayout` itself (Payload applies it with `??=`, so any setter would\n * clobber the app's layout). Each slug is spelled out rather than mapped from\n * `BREAKDOWN_SPECS`, because an app's generated types narrow `widgetSlug` to its own\n * registered widgets; `defaults.test.ts` is what keeps the list complete.\n */\nexport const analyticsDefaultWidgets = (): WidgetInstance[] => [\n\t{\n\t\twidgetSlug: 'analytics-metric',\n\t\twidth: 'small',\n\t\tdata: { metric: 'pageviews', timeframe: TIMEFRAME },\n\t},\n\t{\n\t\twidgetSlug: 'analytics-metric',\n\t\twidth: 'small',\n\t\tdata: { metric: 'visitors', timeframe: TIMEFRAME },\n\t},\n\t{\n\t\twidgetSlug: 'analytics-trend',\n\t\twidth: 'large',\n\t\tdata: { metric: 'pageviews', timeframe: TIMEFRAME },\n\t},\n\t{\n\t\twidgetSlug: 'analytics-goals',\n\t\twidth: 'medium',\n\t\t// The goals table stores its row count as its select's own string value.\n\t\tdata: { timeframe: TIMEFRAME, limit: '10' },\n\t},\n\t{\n\t\twidgetSlug: 'analytics-realtime',\n\t\twidth: 'small',\n\t\tdata: { metric: 'visitors', windowMinutes: '30' },\n\t},\n\t{ widgetSlug: 'analytics-breakdown-pages', width: 'medium', data: BREAKDOWN_DATA },\n\t{ widgetSlug: 'analytics-breakdown-sources', width: 'medium', data: BREAKDOWN_DATA },\n\t{\n\t\twidgetSlug: 'analytics-breakdown-channels',\n\t\twidth: 'medium',\n\t\tdata: { ...BREAKDOWN_DATA, metric: 'visitors' },\n\t},\n\t{ widgetSlug: 'analytics-breakdown-devices', width: 'medium', data: BREAKDOWN_DATA },\n\t{ widgetSlug: 'analytics-breakdown-countries', width: 'medium', data: BREAKDOWN_DATA },\n\t{\n\t\twidgetSlug: 'analytics-breakdown-goals',\n\t\twidth: 'medium',\n\t\tdata: { ...BREAKDOWN_DATA, metric: 'conversions' },\n\t},\n\t{ widgetSlug: 'analytics-breakdown-referrers', width: 'medium', data: BREAKDOWN_DATA },\n\t{ widgetSlug: 'analytics-breakdown-browsers', width: 'medium', data: BREAKDOWN_DATA },\n\t{ widgetSlug: 'analytics-breakdown-os', width: 'medium', data: BREAKDOWN_DATA },\n\t{ widgetSlug: 'analytics-breakdown-campaigns', width: 'medium', data: BREAKDOWN_DATA },\n\t{\n\t\twidgetSlug: 'analytics-breakdown-events',\n\t\twidth: 'medium',\n\t\tdata: { ...BREAKDOWN_DATA, metric: 'events' },\n\t},\n]\n"],"mappings":";AAEA,MAAM,YAAY;;AAGlB,MAAM,iBAAiB;CAAE,QAAQ;CAAa,WAAW;CAAW,OAAO;AAAE;;;;;;;;;;AAW7E,MAAa,gCAAkD;CAC9D;EACC,YAAY;EACZ,OAAO;EACP,MAAM;GAAE,QAAQ;GAAa,WAAW;EAAU;CACnD;CACA;EACC,YAAY;EACZ,OAAO;EACP,MAAM;GAAE,QAAQ;GAAY,WAAW;EAAU;CAClD;CACA;EACC,YAAY;EACZ,OAAO;EACP,MAAM;GAAE,QAAQ;GAAa,WAAW;EAAU;CACnD;CACA;EACC,YAAY;EACZ,OAAO;EAEP,MAAM;GAAE,WAAW;GAAW,OAAO;EAAK;CAC3C;CACA;EACC,YAAY;EACZ,OAAO;EACP,MAAM;GAAE,QAAQ;GAAY,eAAe;EAAK;CACjD;CACA;EAAE,YAAY;EAA6B,OAAO;EAAU,MAAM;CAAe;CACjF;EAAE,YAAY;EAA+B,OAAO;EAAU,MAAM;CAAe;CACnF;EACC,YAAY;EACZ,OAAO;EACP,MAAM;GAAE,GAAG;GAAgB,QAAQ;EAAW;CAC/C;CACA;EAAE,YAAY;EAA+B,OAAO;EAAU,MAAM;CAAe;CACnF;EAAE,YAAY;EAAiC,OAAO;EAAU,MAAM;CAAe;CACrF;EACC,YAAY;EACZ,OAAO;EACP,MAAM;GAAE,GAAG;GAAgB,QAAQ;EAAc;CAClD;CACA;EAAE,YAAY;EAAiC,OAAO;EAAU,MAAM;CAAe;CACrF;EAAE,YAAY;EAAgC,OAAO;EAAU,MAAM;CAAe;CACpF;EAAE,YAAY;EAA0B,OAAO;EAAU,MAAM;CAAe;CAC9E;EAAE,YAAY;EAAiC,OAAO;EAAU,MAAM;CAAe;CACrF;EACC,YAAY;EACZ,OAAO;EACP,MAAM;GAAE,GAAG;GAAgB,QAAQ;EAAS;CAC7C;AACD"}
@@ -0,0 +1,27 @@
1
+ import { keys } from "../translations/keys.js";
2
+ import { FILTER_OPERATOR_KEYS } from "../translations/metricKeys.js";
3
+ import { DIMENSION_LABELS } from "../view/labels.js";
4
+ //#region src/widgets/filterCaption.ts
5
+ /**
6
+ * One filter as a sentence a caption can end on ("where Country is DE"). Both parts are
7
+ * translated before they reach the sentence, which is itself a translated template, so a
8
+ * locale can reorder them. The value is the editor's own text and is never translated.
9
+ */
10
+ const filterCaption = (filter, t) => t(keys.widgetFilterCaption, {
11
+ dimension: t(DIMENSION_LABELS[filter.dimension]),
12
+ operator: t(FILTER_OPERATOR_KEYS[filter.operator]),
13
+ value: filter.value
14
+ });
15
+ /**
16
+ * A widget's caption: its window, and the filter sentence after it when there is one. The
17
+ * join is a translated template too, so a locale that does not separate the two with a
18
+ * space (zh) does not get one.
19
+ */
20
+ const captionWithFilter = (windowCaption, filter, t) => filter ? t(keys.widgetCaptionWithFilter, {
21
+ window: windowCaption,
22
+ filter: filterCaption(filter, t)
23
+ }) : windowCaption;
24
+ //#endregion
25
+ export { captionWithFilter };
26
+
27
+ //# sourceMappingURL=filterCaption.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"filterCaption.js","names":[],"sources":["../../src/widgets/filterCaption.ts"],"sourcesContent":["import type { AnalyticsFilter } from '../core/contract'\nimport { keys } from '../translations/keys'\nimport { FILTER_OPERATOR_KEYS } from '../translations/metricKeys'\nimport type { Translate } from '../translations/server'\nimport { DIMENSION_LABELS } from '../view/labels'\n\n/**\n * One filter as a sentence a caption can end on (\"where Country is DE\"). Both parts are\n * translated before they reach the sentence, which is itself a translated template, so a\n * locale can reorder them. The value is the editor's own text and is never translated.\n */\nexport const filterCaption = (filter: AnalyticsFilter, t: Translate): string =>\n\tt(keys.widgetFilterCaption, {\n\t\tdimension: t(DIMENSION_LABELS[filter.dimension]),\n\t\toperator: t(FILTER_OPERATOR_KEYS[filter.operator]),\n\t\tvalue: filter.value,\n\t})\n\n/**\n * A widget's caption: its window, and the filter sentence after it when there is one. The\n * join is a translated template too, so a locale that does not separate the two with a\n * space (zh) does not get one.\n */\nexport const captionWithFilter = (\n\twindowCaption: string,\n\tfilter: AnalyticsFilter | undefined,\n\tt: Translate\n): string =>\n\tfilter\n\t\t? t(keys.widgetCaptionWithFilter, {\n\t\t\t\twindow: windowCaption,\n\t\t\t\tfilter: filterCaption(filter, t),\n\t\t\t})\n\t\t: windowCaption\n"],"mappings":";;;;;;;;;AAWA,MAAa,iBAAiB,QAAyB,MACtD,EAAE,KAAK,qBAAqB;CAC3B,WAAW,EAAE,iBAAiB,OAAO,UAAU;CAC/C,UAAU,EAAE,qBAAqB,OAAO,SAAS;CACjD,OAAO,OAAO;AACf,CAAC;;;;;;AAOF,MAAa,qBACZ,eACA,QACA,MAEA,SACG,EAAE,KAAK,yBAAyB;CAChC,QAAQ;CACR,QAAQ,cAAc,QAAQ,CAAC;AAChC,CAAC,IACA"}
@@ -0,0 +1,19 @@
1
+ import { AnalyticsFilter } from "../core/contract.js";
2
+ import { WidgetFilter } from "./types.js";
3
+ //#region src/widgets/filterField.d.ts
4
+ /**
5
+ * The stored group as query filters: one entry, or none at all. A group without both a
6
+ * dimension and a value is still being configured, and the value is stored exactly as it
7
+ * was typed, so the query's own trimming and cap are applied here rather than assumed.
8
+ *
9
+ * Both keys are text fields the pickers fill, so a hand-edited layout or a widget saved
10
+ * against an older contract can hold anything. A dimension the contract does not define
11
+ * has no label to caption it with, so it is no filter at all; an undefined operator falls
12
+ * back to `eq`, the field's own default.
13
+ */
14
+ declare const widgetFilters: (data: {
15
+ filter?: WidgetFilter;
16
+ }) => AnalyticsFilter[];
17
+ //#endregion
18
+ export { widgetFilters };
19
+ //# sourceMappingURL=filterField.d.ts.map
@@ -0,0 +1,75 @@
1
+ import { DIMENSION_KEYS, FILTER_OPERATORS } from "../core/contract.js";
2
+ import { keys } from "../translations/keys.js";
3
+ import { asTranslate, labelForKey } from "../translations/server.js";
4
+ //#region src/widgets/filterField.ts
5
+ /** importMap paths of the scoped pickers; the factory never imports the components. */
6
+ const FILTER_DIMENSION_COMPONENT = "@10x-media/analytics/client#FilterDimensionSelectField";
7
+ const FILTER_OPERATOR_COMPONENT = "@10x-media/analytics/client#FilterOperatorSelectField";
8
+ /**
9
+ * The dimension is the gate: without one there is no filter, so an empty value is fine.
10
+ * With one, a blank value would filter on nothing and read as an accident.
11
+ */
12
+ const validateValue = (value, { req, siblingData }) => {
13
+ const dimension = siblingData?.dimension;
14
+ if (typeof dimension !== "string" || dimension.trim() === "") return true;
15
+ const trimmed = typeof value === "string" ? value.trim() : "";
16
+ if (trimmed === "") return asTranslate(req.t)(keys.widgetFilterValueRequired);
17
+ return trimmed.length <= 256 ? true : asTranslate(req.t)(keys.widgetFilterValueTooLong);
18
+ };
19
+ /**
20
+ * The stored group as query filters: one entry, or none at all. A group without both a
21
+ * dimension and a value is still being configured, and the value is stored exactly as it
22
+ * was typed, so the query's own trimming and cap are applied here rather than assumed.
23
+ *
24
+ * Both keys are text fields the pickers fill, so a hand-edited layout or a widget saved
25
+ * against an older contract can hold anything. A dimension the contract does not define
26
+ * has no label to caption it with, so it is no filter at all; an undefined operator falls
27
+ * back to `eq`, the field's own default.
28
+ */
29
+ const widgetFilters = (data) => {
30
+ const { dimension, operator, value } = data.filter ?? {};
31
+ const trimmed = typeof value === "string" ? value.trim() : "";
32
+ if (!dimension || !DIMENSION_KEYS.includes(dimension) || trimmed === "") return [];
33
+ return [{
34
+ dimension,
35
+ operator: operator && FILTER_OPERATORS.includes(operator) ? operator : "eq",
36
+ value: trimmed.slice(0, 256)
37
+ }];
38
+ };
39
+ /**
40
+ * The optional one-filter group every filterable widget carries. Text-backed rather than
41
+ * select-backed on purpose: the servable dimensions and operators are per source and per
42
+ * request, so the option lists are the client pickers' to build, not the config's.
43
+ */
44
+ const filterField = () => ({
45
+ name: "filter",
46
+ type: "group",
47
+ label: labelForKey(keys.widgetFieldFilter),
48
+ admin: { description: labelForKey(keys.widgetFieldFilterDescription) },
49
+ fields: [
50
+ {
51
+ name: "dimension",
52
+ type: "text",
53
+ label: labelForKey(keys.widgetFieldFilterDimension),
54
+ admin: { components: { Field: { path: FILTER_DIMENSION_COMPONENT } } }
55
+ },
56
+ {
57
+ name: "operator",
58
+ type: "text",
59
+ defaultValue: "eq",
60
+ label: labelForKey(keys.widgetFieldFilterOperator),
61
+ admin: { components: { Field: { path: FILTER_OPERATOR_COMPONENT } } }
62
+ },
63
+ {
64
+ name: "value",
65
+ type: "text",
66
+ maxLength: 256,
67
+ label: labelForKey(keys.widgetFieldFilterValue),
68
+ validate: validateValue
69
+ }
70
+ ]
71
+ });
72
+ //#endregion
73
+ export { filterField, widgetFilters };
74
+
75
+ //# sourceMappingURL=filterField.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"filterField.js","names":[],"sources":["../../src/widgets/filterField.ts"],"sourcesContent":["import type { NamedGroupField, TextFieldSingleValidation } from 'payload'\nimport { type AnalyticsFilter, DIMENSION_KEYS, FILTER_OPERATORS } from '../core/contract'\nimport { MAX_QUERY_FILTER_VALUE_LENGTH } from '../query/limits'\nimport { keys } from '../translations/keys'\nimport { asTranslate, labelForKey } from '../translations/server'\nimport type { WidgetFilter } from './types'\n\n/** importMap paths of the scoped pickers; the factory never imports the components. */\nexport const FILTER_DIMENSION_COMPONENT = '@10x-media/analytics/client#FilterDimensionSelectField'\nexport const FILTER_OPERATOR_COMPONENT = '@10x-media/analytics/client#FilterOperatorSelectField'\n\n/**\n * The dimension is the gate: without one there is no filter, so an empty value is fine.\n * With one, a blank value would filter on nothing and read as an accident.\n */\nconst validateValue: TextFieldSingleValidation = (value, { req, siblingData }) => {\n\tconst dimension = (siblingData as { dimension?: unknown } | undefined)?.dimension\n\tif (typeof dimension !== 'string' || dimension.trim() === '') return true\n\tconst trimmed = typeof value === 'string' ? value.trim() : ''\n\tif (trimmed === '') return asTranslate(req.t)(keys.widgetFilterValueRequired)\n\treturn trimmed.length <= MAX_QUERY_FILTER_VALUE_LENGTH\n\t\t? true\n\t\t: asTranslate(req.t)(keys.widgetFilterValueTooLong)\n}\n\n/**\n * The stored group as query filters: one entry, or none at all. A group without both a\n * dimension and a value is still being configured, and the value is stored exactly as it\n * was typed, so the query's own trimming and cap are applied here rather than assumed.\n *\n * Both keys are text fields the pickers fill, so a hand-edited layout or a widget saved\n * against an older contract can hold anything. A dimension the contract does not define\n * has no label to caption it with, so it is no filter at all; an undefined operator falls\n * back to `eq`, the field's own default.\n */\nexport const widgetFilters = (data: { filter?: WidgetFilter }): AnalyticsFilter[] => {\n\tconst { dimension, operator, value } = data.filter ?? {}\n\tconst trimmed = typeof value === 'string' ? value.trim() : ''\n\tif (!dimension || !DIMENSION_KEYS.includes(dimension) || trimmed === '') {\n\t\treturn []\n\t}\n\treturn [\n\t\t{\n\t\t\tdimension,\n\t\t\toperator: operator && FILTER_OPERATORS.includes(operator) ? operator : 'eq',\n\t\t\tvalue: trimmed.slice(0, MAX_QUERY_FILTER_VALUE_LENGTH),\n\t\t},\n\t]\n}\n\n/**\n * The optional one-filter group every filterable widget carries. Text-backed rather than\n * select-backed on purpose: the servable dimensions and operators are per source and per\n * request, so the option lists are the client pickers' to build, not the config's.\n */\nexport const filterField = (): NamedGroupField => ({\n\tname: 'filter',\n\ttype: 'group',\n\tlabel: labelForKey(keys.widgetFieldFilter),\n\tadmin: { description: labelForKey(keys.widgetFieldFilterDescription) },\n\tfields: [\n\t\t{\n\t\t\tname: 'dimension',\n\t\t\ttype: 'text',\n\t\t\tlabel: labelForKey(keys.widgetFieldFilterDimension),\n\t\t\tadmin: { components: { Field: { path: FILTER_DIMENSION_COMPONENT } } },\n\t\t},\n\t\t{\n\t\t\tname: 'operator',\n\t\t\ttype: 'text',\n\t\t\tdefaultValue: 'eq',\n\t\t\tlabel: labelForKey(keys.widgetFieldFilterOperator),\n\t\t\tadmin: { components: { Field: { path: FILTER_OPERATOR_COMPONENT } } },\n\t\t},\n\t\t{\n\t\t\tname: 'value',\n\t\t\ttype: 'text',\n\t\t\tmaxLength: MAX_QUERY_FILTER_VALUE_LENGTH,\n\t\t\tlabel: labelForKey(keys.widgetFieldFilterValue),\n\t\t\tvalidate: validateValue,\n\t\t},\n\t],\n})\n"],"mappings":";;;;;AAQA,MAAa,6BAA6B;AAC1C,MAAa,4BAA4B;;;;;AAMzC,MAAM,iBAA4C,OAAO,EAAE,KAAK,kBAAkB;CACjF,MAAM,YAAa,aAAqD;CACxE,IAAI,OAAO,cAAc,YAAY,UAAU,KAAK,MAAM,IAAI,OAAO;CACrE,MAAM,UAAU,OAAO,UAAU,WAAW,MAAM,KAAK,IAAI;CAC3D,IAAI,YAAY,IAAI,OAAO,YAAY,IAAI,CAAC,EAAE,KAAK,yBAAyB;CAC5E,OAAO,QAAQ,UAAA,MACZ,OACA,YAAY,IAAI,CAAC,EAAE,KAAK,wBAAwB;AACpD;;;;;;;;;;;AAYA,MAAa,iBAAiB,SAAuD;CACpF,MAAM,EAAE,WAAW,UAAU,UAAU,KAAK,UAAU,CAAC;CACvD,MAAM,UAAU,OAAO,UAAU,WAAW,MAAM,KAAK,IAAI;CAC3D,IAAI,CAAC,aAAa,CAAC,eAAe,SAAS,SAAS,KAAK,YAAY,IACpE,OAAO,CAAC;CAET,OAAO,CACN;EACC;EACA,UAAU,YAAY,iBAAiB,SAAS,QAAQ,IAAI,WAAW;EACvE,OAAO,QAAQ,MAAM,GAAA,GAAgC;CACtD,CACD;AACD;;;;;;AAOA,MAAa,qBAAsC;CAClD,MAAM;CACN,MAAM;CACN,OAAO,YAAY,KAAK,iBAAiB;CACzC,OAAO,EAAE,aAAa,YAAY,KAAK,4BAA4B,EAAE;CACrE,QAAQ;EACP;GACC,MAAM;GACN,MAAM;GACN,OAAO,YAAY,KAAK,0BAA0B;GAClD,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,2BAA2B,EAAE,EAAE;EACtE;EACA;GACC,MAAM;GACN,MAAM;GACN,cAAc;GACd,OAAO,YAAY,KAAK,yBAAyB;GACjD,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,0BAA0B,EAAE,EAAE;EACrE;EACA;GACC,MAAM;GACN,MAAM;GACN,WAAA;GACA,OAAO,YAAY,KAAK,sBAAsB;GAC9C,UAAU;EACX;CACD;AACD"}
@@ -0,0 +1,7 @@
1
+ import { PayloadRequest } from "payload";
2
+
3
+ //#region src/widgets/prepareWidgetRead.d.ts
4
+ type WidgetReadStatus = 'ok' | 'not-configured' | 'unavailable' | 'filter-unsupported';
5
+ //#endregion
6
+ export { WidgetReadStatus };
7
+ //# sourceMappingURL=prepareWidgetRead.d.ts.map
@@ -0,0 +1,74 @@
1
+ import { getRuntime, resolveTimezoneFor } from "../plugin/runtime.js";
2
+ import { resolveTimeframe } from "../timeframe/presets.js";
3
+ import { satisfiesCapabilities } from "../core/capabilities.js";
4
+ import { supportsGranularity } from "../core/granularity.js";
5
+ import { resolveReadContext } from "../core/scopedRead.js";
6
+ import { goalSlugsFor } from "../plugin/goalHint.js";
7
+ //#region src/widgets/prepareWidgetRead.ts
8
+ /**
9
+ * Whether the serving source can apply every filter the read carries. Answered before the
10
+ * query so a source that cannot filter says so rather than returning site-wide numbers a
11
+ * reader would take for filtered ones.
12
+ */
13
+ const supportsFilters = (caps, filters) => !filters || filters.length === 0 || satisfiesCapabilities(caps, {
14
+ filters: filters.map((f) => f.dimension),
15
+ filterOperators: filters.map((f) => f.operator)
16
+ });
17
+ /**
18
+ * The prologue every widget read shares: the runtime, the read's scope and adapter, the
19
+ * reporting timezone, the window, and the gates a source has to pass before it is worth
20
+ * querying. A refusal carries the status the widget renders and the window it would have
21
+ * read, so a helper's own failure shape is one spread rather than five early returns.
22
+ */
23
+ const prepareWidgetRead = async (args) => {
24
+ const { req, now } = args;
25
+ const windowIn = (zone) => args.timeframe === void 0 ? args.range : args.range ?? resolveTimeframe(args.timeframe, now, zone);
26
+ const runtime = getRuntime(req.payload);
27
+ const ctx = runtime ? await resolveReadContext({
28
+ runtime,
29
+ req,
30
+ adapterId: args.adapterId,
31
+ scope: args.scope
32
+ }) : { ok: false };
33
+ if (!runtime || !ctx.ok) return {
34
+ ok: false,
35
+ status: "unavailable",
36
+ adapterId: args.adapterId ?? "",
37
+ dateRange: windowIn(args.timezone),
38
+ tz: args.timezone ?? "UTC"
39
+ };
40
+ const tz = args.timezone ?? await resolveTimezoneFor(runtime, req, ctx.scope);
41
+ const dateRange = windowIn(tz);
42
+ const adapter = ctx.adapter;
43
+ const refuse = (status) => ({
44
+ ok: false,
45
+ status,
46
+ adapterId: adapter.id,
47
+ dateRange,
48
+ tz
49
+ });
50
+ if (!adapter.isConfigured()) return refuse("not-configured");
51
+ if (args.requires && !satisfiesCapabilities(adapter.capabilities, args.requires)) return refuse("unavailable");
52
+ if (args.granularity && !supportsGranularity(adapter.capabilities, args.granularity)) return refuse("unavailable");
53
+ if (!supportsFilters(adapter.capabilities, args.filters)) return refuse("filter-unsupported");
54
+ const goalSlugs = args.goalSlugs ?? (args.goalRead ? await goalSlugsFor({
55
+ runtime,
56
+ req,
57
+ scope: ctx.scope,
58
+ ...args.goalRead(adapter)
59
+ }) : void 0);
60
+ return {
61
+ ok: true,
62
+ runtime,
63
+ adapter,
64
+ tz,
65
+ dateRange,
66
+ scope: ctx.scope,
67
+ ...ctx.queryScope === void 0 ? {} : { queryScope: ctx.queryScope },
68
+ ...goalSlugs === void 0 ? {} : { goalSlugs }
69
+ };
70
+ };
71
+ //#endregion
72
+ export { prepareWidgetRead };
73
+
74
+ //# sourceMappingURL=prepareWidgetRead.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"prepareWidgetRead.js","names":[],"sources":["../../src/widgets/prepareWidgetRead.ts"],"sourcesContent":["import type { PayloadRequest } from 'payload'\nimport { type CapabilityRequirement, satisfiesCapabilities } from '../core/capabilities'\nimport type {\n\tAnalyticsAdapter,\n\tAnalyticsCapabilities,\n\tAnalyticsFilter,\n\tDateRange,\n\tGranularity,\n} from '../core/contract'\nimport { supportsGranularity } from '../core/granularity'\nimport { resolveReadContext } from '../core/scopedRead'\nimport { type GoalRead, goalSlugsFor } from '../plugin/goalHint'\nimport { type AnalyticsRuntime, getRuntime, resolveTimezoneFor } from '../plugin/runtime'\nimport { resolveTimeframe, type TimeframePreset } from '../timeframe/presets'\nimport { DEFAULT_TIMEZONE } from '../timeframe/tz'\n\nexport type WidgetReadStatus = 'ok' | 'not-configured' | 'unavailable' | 'filter-unsupported'\n\n/**\n * Whether the serving source can apply every filter the read carries. Answered before the\n * query so a source that cannot filter says so rather than returning site-wide numbers a\n * reader would take for filtered ones.\n */\nexport const supportsFilters = (\n\tcaps: AnalyticsCapabilities,\n\tfilters?: AnalyticsFilter[]\n): boolean =>\n\t!filters ||\n\tfilters.length === 0 ||\n\tsatisfiesCapabilities(caps, {\n\t\tfilters: filters.map((f) => f.dimension),\n\t\tfilterOperators: filters.map((f) => f.operator),\n\t})\n\ninterface PrepareWidgetReadBase {\n\treq: PayloadRequest\n\tnow: Date\n\tadapterId?: string\n\t/** Explicit scope override; omitted resolves via the plugin's scopeResolver. */\n\tscope?: string | null\n\t/**\n\t * Reporting timezone the caller already resolved, reused rather than resolved again so\n\t * a caller-supplied `range` is read in the very timezone it was interpreted in.\n\t */\n\ttimezone?: string\n\tfilters?: AnalyticsFilter[]\n\t/** What the source must serve for the read to be worth making. */\n\trequires?: CapabilityRequirement\n\t/** The finest bucket the read needs, gated against the source's `minGranularity`. */\n\tgranularity?: Granularity\n\t/**\n\t * The read the goal hint is resolved for, answered once the adapter is known so a caller\n\t * that narrows its metrics against the source hints on the list it will actually ask for.\n\t * Omitted asks about no goals.\n\t */\n\tgoalRead?: (adapter: AnalyticsAdapter) => GoalRead\n\t/** A hint the caller already resolved, which wins over `goalRead`. */\n\tgoalSlugs?: string[] | 'unresolved'\n}\n\n/** Either a preset to resolve the window from or the window itself. */\nexport type PrepareWidgetReadArgs = PrepareWidgetReadBase &\n\t({ timeframe: TimeframePreset; range?: DateRange } | { timeframe?: undefined; range: DateRange })\n\nexport type PreparedWidgetRead =\n\t| {\n\t\t\tok: true\n\t\t\truntime: AnalyticsRuntime\n\t\t\tadapter: AnalyticsAdapter\n\t\t\t/** Reporting timezone the window was resolved in. */\n\t\t\ttz: string\n\t\t\tdateRange: DateRange\n\t\t\t/** The read's own scope, which sub-reads pin so all of them answer about one thing. */\n\t\t\tscope: string | null\n\t\t\t/** The scope to stamp on the adapter query; undefined for install-wide reads. */\n\t\t\tqueryScope?: string\n\t\t\t/** The scope's goal slugs, `'unresolved'`, or absent for a read about no goals. */\n\t\t\tgoalSlugs?: string[] | 'unresolved'\n\t }\n\t| {\n\t\t\tok: false\n\t\t\tstatus: WidgetReadStatus\n\t\t\tadapterId: string\n\t\t\tdateRange: DateRange\n\t\t\t/** The timezone the window was read in: the resolved one, or the caller's own, or UTC. */\n\t\t\ttz: string\n\t }\n\n/**\n * The prologue every widget read shares: the runtime, the read's scope and adapter, the\n * reporting timezone, the window, and the gates a source has to pass before it is worth\n * querying. A refusal carries the status the widget renders and the window it would have\n * read, so a helper's own failure shape is one spread rather than five early returns.\n */\nexport const prepareWidgetRead = async (\n\targs: PrepareWidgetReadArgs\n): Promise<PreparedWidgetRead> => {\n\tconst { req, now } = args\n\tconst windowIn = (zone?: string): DateRange =>\n\t\targs.timeframe === undefined\n\t\t\t? args.range\n\t\t\t: (args.range ?? resolveTimeframe(args.timeframe, now, zone))\n\n\tconst runtime = getRuntime(req.payload)\n\tconst ctx = runtime\n\t\t? await resolveReadContext({ runtime, req, adapterId: args.adapterId, scope: args.scope })\n\t\t: { ok: false as const }\n\tif (!runtime || !ctx.ok) {\n\t\treturn {\n\t\t\tok: false,\n\t\t\tstatus: 'unavailable',\n\t\t\tadapterId: args.adapterId ?? '',\n\t\t\tdateRange: windowIn(args.timezone),\n\t\t\ttz: args.timezone ?? DEFAULT_TIMEZONE,\n\t\t}\n\t}\n\n\tconst tz = args.timezone ?? (await resolveTimezoneFor(runtime, req, ctx.scope))\n\tconst dateRange = windowIn(tz)\n\tconst adapter = ctx.adapter\n\tconst refuse = (status: WidgetReadStatus): PreparedWidgetRead => ({\n\t\tok: false,\n\t\tstatus,\n\t\tadapterId: adapter.id,\n\t\tdateRange,\n\t\ttz,\n\t})\n\tif (!adapter.isConfigured()) {\n\t\treturn refuse('not-configured')\n\t}\n\tif (args.requires && !satisfiesCapabilities(adapter.capabilities, args.requires)) {\n\t\treturn refuse('unavailable')\n\t}\n\tif (args.granularity && !supportsGranularity(adapter.capabilities, args.granularity)) {\n\t\treturn refuse('unavailable')\n\t}\n\tif (!supportsFilters(adapter.capabilities, args.filters)) {\n\t\treturn refuse('filter-unsupported')\n\t}\n\n\tconst goalSlugs =\n\t\targs.goalSlugs ??\n\t\t(args.goalRead\n\t\t\t? await goalSlugsFor({ runtime, req, scope: ctx.scope, ...args.goalRead(adapter) })\n\t\t\t: undefined)\n\treturn {\n\t\tok: true,\n\t\truntime,\n\t\tadapter,\n\t\ttz,\n\t\tdateRange,\n\t\tscope: ctx.scope,\n\t\t...(ctx.queryScope === undefined ? {} : { queryScope: ctx.queryScope }),\n\t\t...(goalSlugs === undefined ? {} : { goalSlugs }),\n\t}\n}\n"],"mappings":";;;;;;;;;;;;AAuBA,MAAa,mBACZ,MACA,YAEA,CAAC,WACD,QAAQ,WAAW,KACnB,sBAAsB,MAAM;CAC3B,SAAS,QAAQ,KAAK,MAAM,EAAE,SAAS;CACvC,iBAAiB,QAAQ,KAAK,MAAM,EAAE,QAAQ;AAC/C,CAAC;;;;;;;AA8DF,MAAa,oBAAoB,OAChC,SACiC;CACjC,MAAM,EAAE,KAAK,QAAQ;CACrB,MAAM,YAAY,SACjB,KAAK,cAAc,KAAA,IAChB,KAAK,QACJ,KAAK,SAAS,iBAAiB,KAAK,WAAW,KAAK,IAAI;CAE7D,MAAM,UAAU,WAAW,IAAI,OAAO;CACtC,MAAM,MAAM,UACT,MAAM,mBAAmB;EAAE;EAAS;EAAK,WAAW,KAAK;EAAW,OAAO,KAAK;CAAM,CAAC,IACvF,EAAE,IAAI,MAAe;CACxB,IAAI,CAAC,WAAW,CAAC,IAAI,IACpB,OAAO;EACN,IAAI;EACJ,QAAQ;EACR,WAAW,KAAK,aAAa;EAC7B,WAAW,SAAS,KAAK,QAAQ;EACjC,IAAI,KAAK,YAAA;CACV;CAGD,MAAM,KAAK,KAAK,YAAa,MAAM,mBAAmB,SAAS,KAAK,IAAI,KAAK;CAC7E,MAAM,YAAY,SAAS,EAAE;CAC7B,MAAM,UAAU,IAAI;CACpB,MAAM,UAAU,YAAkD;EACjE,IAAI;EACJ;EACA,WAAW,QAAQ;EACnB;EACA;CACD;CACA,IAAI,CAAC,QAAQ,aAAa,GACzB,OAAO,OAAO,gBAAgB;CAE/B,IAAI,KAAK,YAAY,CAAC,sBAAsB,QAAQ,cAAc,KAAK,QAAQ,GAC9E,OAAO,OAAO,aAAa;CAE5B,IAAI,KAAK,eAAe,CAAC,oBAAoB,QAAQ,cAAc,KAAK,WAAW,GAClF,OAAO,OAAO,aAAa;CAE5B,IAAI,CAAC,gBAAgB,QAAQ,cAAc,KAAK,OAAO,GACtD,OAAO,OAAO,oBAAoB;CAGnC,MAAM,YACL,KAAK,cACJ,KAAK,WACH,MAAM,aAAa;EAAE;EAAS;EAAK,OAAO,IAAI;EAAO,GAAG,KAAK,SAAS,OAAO;CAAE,CAAC,IAChF,KAAA;CACJ,OAAO;EACN,IAAI;EACJ;EACA;EACA;EACA;EACA,OAAO,IAAI;EACX,GAAI,IAAI,eAAe,KAAA,IAAY,CAAC,IAAI,EAAE,YAAY,IAAI,WAAW;EACrE,GAAI,cAAc,KAAA,IAAY,CAAC,IAAI,EAAE,UAAU;CAChD;AACD"}