@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
@@ -1,51 +1,26 @@
1
- import { serializeCapabilities } from "../core/capabilities.js";
2
- import { getRuntime, resolveRegistryFor, resolveScopeFor } from "./runtime.js";
3
1
  import "./paths.js";
2
+ import { getRuntime, readAccessFor } from "./runtime.js";
3
+ import { NO_STORE, analyticsError, errorResponse } from "./errors.js";
4
+ import { resolveSourcesForRequest } from "./readContextForRequest.js";
4
5
  //#region src/plugin/sourcesEndpoint.ts
5
6
  /**
6
7
  * Authenticated GET listing the adapters visible to the requesting scope, with
7
- * serialized capabilities for client-side pickers. Always answers for the
8
- * caller's own resolved scope; there is deliberately no scope parameter, so a
9
- * tenant can never enumerate another tenant's sources. Resolution failures
10
- * degrade to the static config registry the same way reads do.
8
+ * serialized capabilities for client-side pickers. Gated by `access.read` like
9
+ * every other read endpoint. Always answers for the caller's own resolved scope;
10
+ * there is deliberately no scope parameter, so a tenant can never enumerate
11
+ * another tenant's sources. Everything else about the resolution, including how a
12
+ * null scope and a failed resolution fail closed, lives in
13
+ * {@link resolveSourcesForRequest}, which the query endpoint shares.
11
14
  */
12
15
  const makeSourcesHandler = () => async (req) => {
13
- if (!req.user) return Response.json({ error: "unauthorized" }, { status: 401 });
16
+ if (!req.user) return errorResponse(401, analyticsError("unauthorized", "analytics: authentication required"));
14
17
  const runtime = getRuntime(req.payload);
15
- if (!runtime) return Response.json({
16
- defaultId: null,
17
- sources: []
18
- });
19
- try {
20
- const scope = await resolveScopeFor(runtime, req);
21
- const registry = await resolveRegistryFor(runtime, {
22
- payload: req.payload,
23
- req,
24
- scope
25
- });
26
- const sources = registry.all().map((a) => ({
27
- id: a.id,
28
- label: a.label,
29
- kind: runtime.configAdapterIds.has(a.id) ? "config" : "runtime",
30
- capabilities: serializeCapabilities(a.capabilities)
31
- }));
32
- return Response.json({
33
- defaultId: registry.default().id,
34
- sources
35
- });
36
- } catch (err) {
37
- req.payload.logger?.warn(`analytics: sources listing failed: ${String(err)}`);
38
- const sources = runtime.registry.all().map((a) => ({
39
- id: a.id,
40
- label: a.label,
41
- kind: "config",
42
- capabilities: serializeCapabilities(a.capabilities)
43
- }));
44
- return Response.json({
45
- defaultId: runtime.registry.default().id,
46
- sources
47
- });
48
- }
18
+ if (runtime && !await readAccessFor(runtime, req)) return errorResponse(403, analyticsError("forbidden", "analytics: read access denied"));
19
+ const { sources, defaultId } = await resolveSourcesForRequest(req);
20
+ return Response.json({
21
+ defaultId,
22
+ sources
23
+ }, { headers: NO_STORE });
49
24
  };
50
25
  //#endregion
51
26
  export { makeSourcesHandler };
@@ -1 +1 @@
1
- {"version":3,"file":"sourcesEndpoint.js","names":[],"sources":["../../src/plugin/sourcesEndpoint.ts"],"sourcesContent":["import type { PayloadHandler } from 'payload'\nimport { serializeCapabilities } from '../core/capabilities'\nimport { SOURCES_PATH } from './paths'\nimport { getRuntime, resolveRegistryFor, resolveScopeFor } from './runtime'\n\nexport { SOURCES_PATH }\n\n/**\n * Authenticated GET listing the adapters visible to the requesting scope, with\n * serialized capabilities for client-side pickers. Always answers for the\n * caller's own resolved scope; there is deliberately no scope parameter, so a\n * tenant can never enumerate another tenant's sources. Resolution failures\n * degrade to the static config registry the same way reads do.\n */\nexport const makeSourcesHandler = (): PayloadHandler => async (req) => {\n\tif (!req.user) {\n\t\treturn Response.json({ error: 'unauthorized' }, { status: 401 })\n\t}\n\tconst runtime = getRuntime(req.payload)\n\tif (!runtime) {\n\t\treturn Response.json({ defaultId: null, sources: [] })\n\t}\n\ttry {\n\t\tconst scope = await resolveScopeFor(runtime, req)\n\t\tconst registry = await resolveRegistryFor(runtime, { payload: req.payload, req, scope })\n\t\tconst sources = registry.all().map((a) => ({\n\t\t\tid: a.id,\n\t\t\tlabel: a.label,\n\t\t\tkind: runtime.configAdapterIds.has(a.id) ? ('config' as const) : ('runtime' as const),\n\t\t\tcapabilities: serializeCapabilities(a.capabilities),\n\t\t}))\n\t\treturn Response.json({ defaultId: registry.default().id, sources })\n\t} catch (err) {\n\t\treq.payload.logger?.warn(`analytics: sources listing failed: ${String(err)}`)\n\t\tconst sources = runtime.registry.all().map((a) => ({\n\t\t\tid: a.id,\n\t\t\tlabel: a.label,\n\t\t\tkind: 'config' as const,\n\t\t\tcapabilities: serializeCapabilities(a.capabilities),\n\t\t}))\n\t\treturn Response.json({ defaultId: runtime.registry.default().id, sources })\n\t}\n}\n"],"mappings":";;;;;;;;;;;AAcA,MAAa,2BAA2C,OAAO,QAAQ;CACtE,IAAI,CAAC,IAAI,MACR,OAAO,SAAS,KAAK,EAAE,OAAO,eAAe,GAAG,EAAE,QAAQ,IAAI,CAAC;CAEhE,MAAM,UAAU,WAAW,IAAI,OAAO;CACtC,IAAI,CAAC,SACJ,OAAO,SAAS,KAAK;EAAE,WAAW;EAAM,SAAS,CAAC;CAAE,CAAC;CAEtD,IAAI;EACH,MAAM,QAAQ,MAAM,gBAAgB,SAAS,GAAG;EAChD,MAAM,WAAW,MAAM,mBAAmB,SAAS;GAAE,SAAS,IAAI;GAAS;GAAK;EAAM,CAAC;EACvF,MAAM,UAAU,SAAS,IAAI,EAAE,KAAK,OAAO;GAC1C,IAAI,EAAE;GACN,OAAO,EAAE;GACT,MAAM,QAAQ,iBAAiB,IAAI,EAAE,EAAE,IAAK,WAAsB;GAClE,cAAc,sBAAsB,EAAE,YAAY;EACnD,EAAE;EACF,OAAO,SAAS,KAAK;GAAE,WAAW,SAAS,QAAQ,EAAE;GAAI;EAAQ,CAAC;CACnE,SAAS,KAAK;EACb,IAAI,QAAQ,QAAQ,KAAK,sCAAsC,OAAO,GAAG,GAAG;EAC5E,MAAM,UAAU,QAAQ,SAAS,IAAI,EAAE,KAAK,OAAO;GAClD,IAAI,EAAE;GACN,OAAO,EAAE;GACT,MAAM;GACN,cAAc,sBAAsB,EAAE,YAAY;EACnD,EAAE;EACF,OAAO,SAAS,KAAK;GAAE,WAAW,QAAQ,SAAS,QAAQ,EAAE;GAAI;EAAQ,CAAC;CAC3E;AACD"}
1
+ {"version":3,"file":"sourcesEndpoint.js","names":[],"sources":["../../src/plugin/sourcesEndpoint.ts"],"sourcesContent":["import type { PayloadHandler } from 'payload'\nimport { analyticsError, errorResponse, NO_STORE } from './errors'\nimport { SOURCES_PATH } from './paths'\nimport { resolveSourcesForRequest } from './readContextForRequest'\nimport { getRuntime, readAccessFor } from './runtime'\n\nexport { SOURCES_PATH }\n\n/**\n * Authenticated GET listing the adapters visible to the requesting scope, with\n * serialized capabilities for client-side pickers. Gated by `access.read` like\n * every other read endpoint. Always answers for the caller's own resolved scope;\n * there is deliberately no scope parameter, so a tenant can never enumerate\n * another tenant's sources. Everything else about the resolution, including how a\n * null scope and a failed resolution fail closed, lives in\n * {@link resolveSourcesForRequest}, which the query endpoint shares.\n */\nexport const makeSourcesHandler = (): PayloadHandler => async (req) => {\n\tif (!req.user) {\n\t\treturn errorResponse(401, analyticsError('unauthorized', 'analytics: authentication required'))\n\t}\n\tconst runtime = getRuntime(req.payload)\n\t// No runtime means the plugin served nothing to gate: the listing below is empty anyway.\n\tif (runtime && !(await readAccessFor(runtime, req))) {\n\t\treturn errorResponse(403, analyticsError('forbidden', 'analytics: read access denied'))\n\t}\n\tconst { sources, defaultId } = await resolveSourcesForRequest(req)\n\treturn Response.json({ defaultId, sources }, { headers: NO_STORE })\n}\n"],"mappings":";;;;;;;;;;;;;;AAiBA,MAAa,2BAA2C,OAAO,QAAQ;CACtE,IAAI,CAAC,IAAI,MACR,OAAO,cAAc,KAAK,eAAe,gBAAgB,oCAAoC,CAAC;CAE/F,MAAM,UAAU,WAAW,IAAI,OAAO;CAEtC,IAAI,WAAW,CAAE,MAAM,cAAc,SAAS,GAAG,GAChD,OAAO,cAAc,KAAK,eAAe,aAAa,+BAA+B,CAAC;CAEvF,MAAM,EAAE,SAAS,cAAc,MAAM,yBAAyB,GAAG;CACjE,OAAO,SAAS,KAAK;EAAE;EAAW;CAAQ,GAAG,EAAE,SAAS,SAAS,CAAC;AACnE"}
Binary file
@@ -1 +1 @@
1
- {"version":3,"file":"warmTask.js","names":[],"sources":["../../src/plugin/warmTask.ts"],"sourcesContent":["import type { PayloadRequest, TaskConfig, WidgetInstance } from 'payload'\nimport type { DateRange, DimensionKey, MetricKey } from '../core/contract'\nimport { TIMEFRAME_PRESETS, type TimeframePreset } from '../timeframe/presets'\nimport { breakdownSpecBySlug } from '../widgets/breakdownTypes'\nimport { resolveCustomRange } from '../widgets/range'\nimport { readForWidget } from '../widgets/readForWidget'\nimport { readForWidgetBreakdown } from '../widgets/readForWidgetBreakdown'\nimport { readForWidgetSeries } from '../widgets/readForWidgetSeries'\nimport { WIDGET_METRICS, type WidgetRange } from '../widgets/types'\n\n/** Minimal shape of a dashboard widget instance the warm job reads. */\nexport interface WarmWidgetInstance {\n\twidgetSlug?: string\n\tdata?: Record<string, unknown>\n}\n\nexport type WarmTarget =\n\t| {\n\t\t\tkind: 'metric'\n\t\t\tmetric: MetricKey\n\t\t\ttimeframe: TimeframePreset\n\t\t\trange?: DateRange\n\t\t\tadapterId?: string\n\t }\n\t| {\n\t\t\tkind: 'series'\n\t\t\tmetric: MetricKey\n\t\t\ttimeframe: TimeframePreset\n\t\t\trange?: DateRange\n\t\t\tadapterId?: string\n\t }\n\t| {\n\t\t\tkind: 'breakdown'\n\t\t\tmetric: MetricKey\n\t\t\tdimension: DimensionKey\n\t\t\ttimeframe: TimeframePreset\n\t\t\tlimit: number\n\t\t\trange?: DateRange\n\t\t\tadapterId?: string\n\t }\n\nconst asString = (v: unknown): string | undefined => (typeof v === 'string' ? v : undefined)\n\nconst asMetric = (v: unknown): MetricKey =>\n\ttypeof v === 'string' && (WIDGET_METRICS as readonly string[]).includes(v)\n\t\t? (v as MetricKey)\n\t\t: 'pageviews'\n\nconst asTimeframe = (v: unknown): TimeframePreset | 'custom' => {\n\tif (v === 'custom') {\n\t\treturn 'custom'\n\t}\n\tif (typeof v === 'string' && (TIMEFRAME_PRESETS as readonly string[]).includes(v)) {\n\t\treturn v as TimeframePreset\n\t}\n\treturn 'last30days'\n}\n\nconst asLimit = (v: unknown): number => (typeof v === 'number' && v > 0 ? v : 5)\n\nconst asRange = (v: unknown): WidgetRange | undefined => {\n\tif (!v || typeof v !== 'object') {\n\t\treturn undefined\n\t}\n\tconst r = v as { from?: unknown; to?: unknown }\n\treturn { from: asString(r.from), to: asString(r.to) }\n}\n\nconst targetKey = (t: WarmTarget): string => {\n\tconst range = t.range ? `${t.range.start.toISOString()}:${t.range.end.toISOString()}` : ''\n\tconst dimension = t.kind === 'breakdown' ? t.dimension : ''\n\tconst limit = t.kind === 'breakdown' ? String(t.limit) : ''\n\treturn `${t.kind}:${t.metric}:${dimension}:${t.timeframe}:${limit}:${t.adapterId ?? ''}:${range}`\n}\n\n/**\n * Map a dashboard's widget layout to the set of reads that warm its cache. Built-in\n * metric, trend, and breakdown widgets become targets; the realtime widget is skipped\n * (its short-TTL key is kept warm by the live poller) and any other slug is a custom app\n * widget whose read shape the plugin does not know. A `custom` timeframe is kept only when\n * its range resolves (the read takes an explicit range; `timeframe` is then unused).\n * Identical targets are de-duplicated so a repeated widget warms its tuple once.\n */\nexport const deriveWarmTargets = (widgets: readonly WarmWidgetInstance[]): WarmTarget[] => {\n\tconst out: WarmTarget[] = []\n\tconst seen = new Set<string>()\n\tfor (const widget of widgets) {\n\t\tconst slug = widget.widgetSlug\n\t\tif (!slug || slug === 'analytics-realtime') {\n\t\t\tcontinue\n\t\t}\n\t\tconst data = widget.data ?? {}\n\t\tconst metric = asMetric(data.metric)\n\t\tconst adapterId = asString(data.dataSource)\n\t\tconst timeframeRaw = asTimeframe(data.timeframe)\n\t\tlet timeframe: TimeframePreset = 'last30days'\n\t\tlet range: DateRange | undefined\n\t\tif (timeframeRaw === 'custom') {\n\t\t\tconst resolved = resolveCustomRange('custom', asRange(data.range))\n\t\t\tif (!resolved) {\n\t\t\t\tcontinue\n\t\t\t}\n\t\t\trange = resolved\n\t\t} else {\n\t\t\ttimeframe = timeframeRaw\n\t\t}\n\n\t\tlet target: WarmTarget | undefined\n\t\tif (slug === 'analytics-metric') {\n\t\t\ttarget = { kind: 'metric', metric, timeframe, range, adapterId }\n\t\t} else if (slug === 'analytics-trend') {\n\t\t\ttarget = { kind: 'series', metric, timeframe, range, adapterId }\n\t\t} else {\n\t\t\tconst spec = breakdownSpecBySlug(slug)\n\t\t\tif (spec) {\n\t\t\t\ttarget = {\n\t\t\t\t\tkind: 'breakdown',\n\t\t\t\t\tmetric,\n\t\t\t\t\tdimension: spec.dimension,\n\t\t\t\t\ttimeframe,\n\t\t\t\t\tlimit: asLimit(data.limit),\n\t\t\t\t\trange,\n\t\t\t\t\tadapterId,\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\t\tif (!target) {\n\t\t\tcontinue\n\t\t}\n\t\tconst key = targetKey(target)\n\t\tif (seen.has(key)) {\n\t\t\tcontinue\n\t\t}\n\t\tseen.add(key)\n\t\tout.push(target)\n\t}\n\treturn out\n}\n\nexport const WARM_TASK_SLUG = 'analytics-warm-cache'\n\n/** A dashboard `defaultLayout`: an array, or a function resolving one per request. */\nexport type WarmLayout =\n\t| ((args: { req: PayloadRequest }) => WidgetInstance[] | Promise<WidgetInstance[]>)\n\t| WidgetInstance[]\n\t| undefined\n\nconst resolveLayout = async (\n\tlayout: WarmLayout,\n\treq: PayloadRequest\n): Promise<WarmWidgetInstance[]> => {\n\ttry {\n\t\tconst list = typeof layout === 'function' ? await layout({ req }) : (layout ?? [])\n\t\treturn list.map((w) => ({ widgetSlug: w.widgetSlug, data: w.data }))\n\t} catch (err) {\n\t\treq.payload.logger.warn(\n\t\t\t`analytics warm-cache: could not resolve the dashboard layout: ${String(err)}`\n\t\t)\n\t\treturn []\n\t}\n}\n\n/** Run one target's read; returns true when the read served data (status `ok`). */\nconst runTarget = async (target: WarmTarget, req: PayloadRequest, now: Date): Promise<boolean> => {\n\tif (target.kind === 'metric') {\n\t\tconst result = await readForWidget({\n\t\t\treq,\n\t\t\tmetrics: [target.metric],\n\t\t\ttimeframe: target.timeframe,\n\t\t\tadapterId: target.adapterId,\n\t\t\tnow,\n\t\t\trange: target.range,\n\t\t})\n\t\treturn result.status === 'ok'\n\t}\n\tif (target.kind === 'series') {\n\t\tconst result = await readForWidgetSeries({\n\t\t\treq,\n\t\t\tmetric: target.metric,\n\t\t\ttimeframe: target.timeframe,\n\t\t\tadapterId: target.adapterId,\n\t\t\tnow,\n\t\t\trange: target.range,\n\t\t})\n\t\treturn result.status === 'ok'\n\t}\n\tconst result = await readForWidgetBreakdown({\n\t\treq,\n\t\tmetric: target.metric,\n\t\tdimension: target.dimension,\n\t\ttimeframe: target.timeframe,\n\t\tlimit: target.limit,\n\t\tadapterId: target.adapterId,\n\t\tnow,\n\t\trange: target.range,\n\t})\n\treturn result.status === 'ok'\n}\n\n/**\n * Opt-in Payload task that pre-runs the dashboard's widget reads through the surfacing\n * engine so `payload.kv` is warm before a user opens the dashboard. Targets are derived\n * from `layout` (the app's `defaultLayout`, captured at registration and resolved here);\n * each read is isolated so one failing provider does not abort the rest. Most valuable\n * for slow or rate-limited provider adapters; native reads are cheap and harmless to warm.\n */\nexport const warmTask = (\n\tcron: string,\n\tlayout: WarmLayout\n): TaskConfig<{ input: Record<string, never>; output: { warmed: number; failed: number } }> => ({\n\tslug: WARM_TASK_SLUG,\n\thandler: async ({ req }) => {\n\t\tconst targets = deriveWarmTargets(await resolveLayout(layout, req))\n\t\tconst now = new Date()\n\t\tlet warmed = 0\n\t\tlet failed = 0\n\t\tfor (const target of targets) {\n\t\t\ttry {\n\t\t\t\tif (await runTarget(target, req, now)) {\n\t\t\t\t\twarmed++\n\t\t\t\t}\n\t\t\t} catch (err) {\n\t\t\t\tfailed++\n\t\t\t\treq.payload.logger.warn(\n\t\t\t\t\t`analytics warm-cache: ${target.kind} read for \"${target.metric}\" failed: ${String(err)}`\n\t\t\t\t)\n\t\t\t}\n\t\t}\n\t\treturn { output: { warmed, failed } }\n\t},\n\tschedule: [{ cron, queue: 'default' }],\n})\n"],"mappings":"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"}
1
+ {"version":3,"file":"warmTask.js","names":[],"sources":["../../src/plugin/warmTask.ts"],"sourcesContent":["import type { PayloadRequest, TaskConfig, WidgetInstance } from 'payload'\nimport type { DimensionKey, MetricKey } from '../core/contract'\nimport type { ScopesResolver } from '../core/options'\nimport { resolveScopeList } from '../core/scopeList'\nimport { TIMEFRAME_PRESETS, type TimeframePreset } from '../timeframe/presets'\nimport { DEFAULT_TIMEZONE } from '../timeframe/tz'\nimport { breakdownSpecBySlug } from '../widgets/breakdownTypes'\nimport { resolveCustomRange } from '../widgets/range'\nimport { readForWidget, type WidgetReadStatus } from '../widgets/readForWidget'\nimport { readForWidgetBreakdown } from '../widgets/readForWidgetBreakdown'\nimport { readForWidgetSeries } from '../widgets/readForWidgetSeries'\nimport { WIDGET_METRICS, type WidgetRange } from '../widgets/types'\nimport { getRuntime, resolveTimezoneFor } from './runtime'\n\n/** Minimal shape of a dashboard widget instance the warm job reads. */\nexport interface WarmWidgetInstance {\n\twidgetSlug?: string\n\tdata?: Record<string, unknown>\n}\n\nexport type WarmTarget =\n\t| {\n\t\t\tkind: 'metric'\n\t\t\tmetric: MetricKey\n\t\t\ttimeframe: TimeframePreset\n\t\t\trange?: WidgetRange\n\t\t\tadapterId?: string\n\t }\n\t| {\n\t\t\tkind: 'series'\n\t\t\tmetric: MetricKey\n\t\t\ttimeframe: TimeframePreset\n\t\t\trange?: WidgetRange\n\t\t\tadapterId?: string\n\t }\n\t| {\n\t\t\tkind: 'breakdown'\n\t\t\tmetric: MetricKey\n\t\t\tdimension: DimensionKey\n\t\t\ttimeframe: TimeframePreset\n\t\t\tlimit: number\n\t\t\trange?: WidgetRange\n\t\t\tadapterId?: string\n\t }\n\nconst asString = (v: unknown): string | undefined => (typeof v === 'string' ? v : undefined)\n\nconst asMetric = (v: unknown): MetricKey =>\n\ttypeof v === 'string' && (WIDGET_METRICS as readonly string[]).includes(v)\n\t\t? (v as MetricKey)\n\t\t: 'pageviews'\n\nconst asTimeframe = (v: unknown): TimeframePreset | 'custom' => {\n\tif (v === 'custom') {\n\t\treturn 'custom'\n\t}\n\tif (typeof v === 'string' && (TIMEFRAME_PRESETS as readonly string[]).includes(v)) {\n\t\treturn v as TimeframePreset\n\t}\n\treturn 'last30days'\n}\n\nconst asLimit = (v: unknown): number => (typeof v === 'number' && v > 0 ? v : 5)\n\nconst asRange = (v: unknown): WidgetRange | undefined => {\n\tif (!v || typeof v !== 'object') {\n\t\treturn undefined\n\t}\n\tconst r = v as { from?: unknown; to?: unknown }\n\treturn { from: asString(r.from), to: asString(r.to) }\n}\n\nconst targetKey = (t: WarmTarget): string => {\n\tconst range = t.range ? `${t.range.from ?? ''}:${t.range.to ?? ''}` : ''\n\tconst dimension = t.kind === 'breakdown' ? t.dimension : ''\n\tconst limit = t.kind === 'breakdown' ? String(t.limit) : ''\n\treturn `${t.kind}:${t.metric}:${dimension}:${t.timeframe}:${limit}:${t.adapterId ?? ''}:${range}`\n}\n\n/**\n * Map a dashboard's widget layout to the set of reads that warm its cache. Built-in\n * metric, trend, and breakdown widgets become targets; the realtime widget is skipped\n * (its short-TTL key is kept warm by the live poller) and any other slug is a custom app\n * widget whose read shape the plugin does not know. A `custom` timeframe is kept only when\n * its range resolves (the read takes an explicit range; `timeframe` is then unused), and\n * the stored bounds travel with the target rather than concrete instants: which instants\n * two picked days span depends on the reporting timezone, which is per scope and so only\n * known inside the warm loop. Identical targets are de-duplicated so a repeated widget\n * warms its tuple once.\n */\nexport const deriveWarmTargets = (widgets: readonly WarmWidgetInstance[]): WarmTarget[] => {\n\tconst out: WarmTarget[] = []\n\tconst seen = new Set<string>()\n\tfor (const widget of widgets) {\n\t\tconst slug = widget.widgetSlug\n\t\tif (!slug || slug === 'analytics-realtime') {\n\t\t\tcontinue\n\t\t}\n\t\tconst data = widget.data ?? {}\n\t\tconst metric = asMetric(data.metric)\n\t\tconst adapterId = asString(data.dataSource)\n\t\tconst timeframeRaw = asTimeframe(data.timeframe)\n\t\tlet timeframe: TimeframePreset = 'last30days'\n\t\tlet range: WidgetRange | undefined\n\t\tif (timeframeRaw === 'custom') {\n\t\t\tconst stored = asRange(data.range)\n\t\t\t// Whether the bounds name real days is timezone-independent, so the skip decision\n\t\t\t// can be taken here even though the window itself cannot.\n\t\t\tif (!resolveCustomRange('custom', stored, DEFAULT_TIMEZONE)) {\n\t\t\t\tcontinue\n\t\t\t}\n\t\t\trange = stored\n\t\t} else {\n\t\t\ttimeframe = timeframeRaw\n\t\t}\n\n\t\tlet target: WarmTarget | undefined\n\t\tif (slug === 'analytics-metric') {\n\t\t\ttarget = { kind: 'metric', metric, timeframe, range, adapterId }\n\t\t} else if (slug === 'analytics-trend') {\n\t\t\ttarget = { kind: 'series', metric, timeframe, range, adapterId }\n\t\t} else {\n\t\t\tconst spec = breakdownSpecBySlug(slug)\n\t\t\tif (spec) {\n\t\t\t\ttarget = {\n\t\t\t\t\tkind: 'breakdown',\n\t\t\t\t\tmetric,\n\t\t\t\t\tdimension: spec.dimension,\n\t\t\t\t\ttimeframe,\n\t\t\t\t\tlimit: asLimit(data.limit),\n\t\t\t\t\trange,\n\t\t\t\t\tadapterId,\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\t\tif (!target) {\n\t\t\tcontinue\n\t\t}\n\t\tconst key = targetKey(target)\n\t\tif (seen.has(key)) {\n\t\t\tcontinue\n\t\t}\n\t\tseen.add(key)\n\t\tout.push(target)\n\t}\n\treturn out\n}\n\nexport const WARM_TASK_SLUG = 'analytics-warm-cache'\n\n/** A dashboard `defaultLayout`: an array, or a function resolving one per request. */\nexport type WarmLayout =\n\t| ((args: { req: PayloadRequest }) => WidgetInstance[] | Promise<WidgetInstance[]>)\n\t| WidgetInstance[]\n\t| undefined\n\nconst resolveLayout = async (\n\tlayout: WarmLayout,\n\treq: PayloadRequest\n): Promise<WarmWidgetInstance[]> => {\n\ttry {\n\t\tconst list = typeof layout === 'function' ? await layout({ req }) : (layout ?? [])\n\t\treturn list.map((w) => ({ widgetSlug: w.widgetSlug, data: w.data }))\n\t} catch (err) {\n\t\treq.payload.logger.warn(\n\t\t\t`analytics warm-cache: could not resolve the dashboard layout: ${String(err)}`\n\t\t)\n\t\treturn []\n\t}\n}\n\ninterface TargetRunResult {\n\tstatus: WidgetReadStatus\n\tadapterId: string\n}\n\n/**\n * Run one target's read for one scope; the caller decides how to count/log the status. The\n * stored custom bounds resolve here, in that scope's reporting timezone, so the warmed key\n * is the one the rendered widget will ask for.\n */\nconst runTarget = async (args: {\n\ttarget: WarmTarget\n\treq: PayloadRequest\n\tnow: Date\n\tscope: string | null\n\ttimezone: string\n}): Promise<TargetRunResult> => {\n\tconst { target, req, now, scope, timezone } = args\n\tconst range = resolveCustomRange('custom', target.range, timezone)\n\tif (target.kind === 'metric') {\n\t\tconst result = await readForWidget({\n\t\t\treq,\n\t\t\tmetrics: [target.metric],\n\t\t\ttimeframe: target.timeframe,\n\t\t\tadapterId: target.adapterId,\n\t\t\tnow,\n\t\t\trange,\n\t\t\tscope,\n\t\t\ttimezone,\n\t\t})\n\t\treturn { status: result.status, adapterId: result.adapterId }\n\t}\n\tif (target.kind === 'series') {\n\t\tconst result = await readForWidgetSeries({\n\t\t\treq,\n\t\t\tmetric: target.metric,\n\t\t\ttimeframe: target.timeframe,\n\t\t\tadapterId: target.adapterId,\n\t\t\tnow,\n\t\t\trange,\n\t\t\tscope,\n\t\t\ttimezone,\n\t\t})\n\t\treturn { status: result.status, adapterId: result.adapterId }\n\t}\n\tconst result = await readForWidgetBreakdown({\n\t\treq,\n\t\tmetric: target.metric,\n\t\tdimension: target.dimension,\n\t\ttimeframe: target.timeframe,\n\t\tlimit: target.limit,\n\t\tadapterId: target.adapterId,\n\t\tnow,\n\t\trange,\n\t\tscope,\n\t\ttimezone,\n\t})\n\treturn { status: result.status, adapterId: result.adapterId }\n}\n\n/**\n * Opt-in Payload task that pre-runs the dashboard's widget reads through the surfacing\n * engine so `payload.kv` is warm before a user opens the dashboard. Targets are derived\n * from `layout` (the app's `defaultLayout`, captured at registration and resolved here);\n * each read is isolated so one failing provider does not abort the rest. Most valuable\n * for slow or rate-limited provider adapters; native reads are cheap and harmless to warm.\n * With `scopes` configured, every target runs once per tenant scope (plus the install-wide\n * scope) so a multi-tenant install warms every tenant's dashboard, not just the null one.\n */\nexport const warmTask = (\n\tcron: string,\n\tlayout: WarmLayout,\n\tscopes?: ScopesResolver\n): TaskConfig<{ input: Record<string, never>; output: { warmed: number; failed: number } }> => ({\n\tslug: WARM_TASK_SLUG,\n\thandler: async ({ req }) => {\n\t\tconst targets = deriveWarmTargets(await resolveLayout(layout, req))\n\t\tif (targets.length === 0) {\n\t\t\treturn { output: { warmed: 0, failed: 0 } }\n\t\t}\n\t\tconst scopeList = await resolveScopeList(scopes, req.payload)\n\t\tconst now = new Date()\n\t\tlet warmed = 0\n\t\tlet failed = 0\n\t\t// A tenant-pass target that degrades (e.g. a shared config adapter gated for\n\t\t// that scope) is not a failure, but a silent one leaves `warmed` unexplainably\n\t\t// short of `scopes x targets`; warn once per (scope, adapter) so it is visible.\n\t\tconst warnedGated = new Set<string>()\n\t\tconst runtime = getRuntime(req.payload)\n\t\tfor (const scope of scopeList) {\n\t\t\tconst timezone = runtime ? await resolveTimezoneFor(runtime, req, scope) : DEFAULT_TIMEZONE\n\t\t\tfor (const target of targets) {\n\t\t\t\ttry {\n\t\t\t\t\tconst result = await runTarget({ target, req, now, scope, timezone })\n\t\t\t\t\tif (result.status === 'ok') {\n\t\t\t\t\t\twarmed++\n\t\t\t\t\t} else if (scope !== null) {\n\t\t\t\t\t\tconst key = `${scope}\u0000${result.adapterId}`\n\t\t\t\t\t\tif (!warnedGated.has(key)) {\n\t\t\t\t\t\t\twarnedGated.add(key)\n\t\t\t\t\t\t\treq.payload.logger.warn(\n\t\t\t\t\t\t\t\t`analytics warm-cache: scope \"${scope}\" adapter \"${result.adapterId}\" returned \"${result.status}\", skipping`\n\t\t\t\t\t\t\t)\n\t\t\t\t\t\t}\n\t\t\t\t\t}\n\t\t\t\t} catch (err) {\n\t\t\t\t\tfailed++\n\t\t\t\t\treq.payload.logger.warn(\n\t\t\t\t\t\t`analytics warm-cache: ${target.kind} read for \"${target.metric}\" (scope \"${scope ?? ''}\") failed: ${String(err)}`\n\t\t\t\t\t)\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\t\treturn { output: { warmed, failed } }\n\t},\n\tschedule: [{ cron, queue: 'default' }],\n})\n"],"mappings":";;;;;;;;;;AA6CA,MAAM,YAAY,MAAoC,OAAO,MAAM,WAAW,IAAI,KAAA;AAElF,MAAM,YAAY,MACjB,OAAO,MAAM,YAAa,eAAqC,SAAS,CAAC,IACrE,IACD;AAEJ,MAAM,eAAe,MAA2C;CAC/D,IAAI,MAAM,UACT,OAAO;CAER,IAAI,OAAO,MAAM,YAAa,kBAAwC,SAAS,CAAC,GAC/E,OAAO;CAER,OAAO;AACR;AAEA,MAAM,WAAW,MAAwB,OAAO,MAAM,YAAY,IAAI,IAAI,IAAI;AAE9E,MAAM,WAAW,MAAwC;CACxD,IAAI,CAAC,KAAK,OAAO,MAAM,UACtB;CAED,MAAM,IAAI;CACV,OAAO;EAAE,MAAM,SAAS,EAAE,IAAI;EAAG,IAAI,SAAS,EAAE,EAAE;CAAE;AACrD;AAEA,MAAM,aAAa,MAA0B;CAC5C,MAAM,QAAQ,EAAE,QAAQ,GAAG,EAAE,MAAM,QAAQ,GAAG,GAAG,EAAE,MAAM,MAAM,OAAO;CACtE,MAAM,YAAY,EAAE,SAAS,cAAc,EAAE,YAAY;CACzD,MAAM,QAAQ,EAAE,SAAS,cAAc,OAAO,EAAE,KAAK,IAAI;CACzD,OAAO,GAAG,EAAE,KAAK,GAAG,EAAE,OAAO,GAAG,UAAU,GAAG,EAAE,UAAU,GAAG,MAAM,GAAG,EAAE,aAAa,GAAG,GAAG;AAC3F;;;;;;;;;;;;AAaA,MAAa,qBAAqB,YAAyD;CAC1F,MAAM,MAAoB,CAAC;CAC3B,MAAM,uBAAO,IAAI,IAAY;CAC7B,KAAK,MAAM,UAAU,SAAS;EAC7B,MAAM,OAAO,OAAO;EACpB,IAAI,CAAC,QAAQ,SAAS,sBACrB;EAED,MAAM,OAAO,OAAO,QAAQ,CAAC;EAC7B,MAAM,SAAS,SAAS,KAAK,MAAM;EACnC,MAAM,YAAY,SAAS,KAAK,UAAU;EAC1C,MAAM,eAAe,YAAY,KAAK,SAAS;EAC/C,IAAI,YAA6B;EACjC,IAAI;EACJ,IAAI,iBAAiB,UAAU;GAC9B,MAAM,SAAS,QAAQ,KAAK,KAAK;GAGjC,IAAI,CAAC,mBAAmB,UAAU,QAAA,KAAwB,GACzD;GAED,QAAQ;EACT,OACC,YAAY;EAGb,IAAI;EACJ,IAAI,SAAS,oBACZ,SAAS;GAAE,MAAM;GAAU;GAAQ;GAAW;GAAO;EAAU;OACzD,IAAI,SAAS,mBACnB,SAAS;GAAE,MAAM;GAAU;GAAQ;GAAW;GAAO;EAAU;OACzD;GACN,MAAM,OAAO,oBAAoB,IAAI;GACrC,IAAI,MACH,SAAS;IACR,MAAM;IACN;IACA,WAAW,KAAK;IAChB;IACA,OAAO,QAAQ,KAAK,KAAK;IACzB;IACA;GACD;EAEF;EACA,IAAI,CAAC,QACJ;EAED,MAAM,MAAM,UAAU,MAAM;EAC5B,IAAI,KAAK,IAAI,GAAG,GACf;EAED,KAAK,IAAI,GAAG;EACZ,IAAI,KAAK,MAAM;CAChB;CACA,OAAO;AACR;AAEA,MAAa,iBAAiB;AAQ9B,MAAM,gBAAgB,OACrB,QACA,QACmC;CACnC,IAAI;EAEH,QADa,OAAO,WAAW,aAAa,MAAM,OAAO,EAAE,IAAI,CAAC,IAAK,UAAU,CAAC,GACpE,KAAK,OAAO;GAAE,YAAY,EAAE;GAAY,MAAM,EAAE;EAAK,EAAE;CACpE,SAAS,KAAK;EACb,IAAI,QAAQ,OAAO,KAClB,iEAAiE,OAAO,GAAG,GAC5E;EACA,OAAO,CAAC;CACT;AACD;;;;;;AAYA,MAAM,YAAY,OAAO,SAMO;CAC/B,MAAM,EAAE,QAAQ,KAAK,KAAK,OAAO,aAAa;CAC9C,MAAM,QAAQ,mBAAmB,UAAU,OAAO,OAAO,QAAQ;CACjE,IAAI,OAAO,SAAS,UAAU;EAC7B,MAAM,SAAS,MAAM,cAAc;GAClC;GACA,SAAS,CAAC,OAAO,MAAM;GACvB,WAAW,OAAO;GAClB,WAAW,OAAO;GAClB;GACA;GACA;GACA;EACD,CAAC;EACD,OAAO;GAAE,QAAQ,OAAO;GAAQ,WAAW,OAAO;EAAU;CAC7D;CACA,IAAI,OAAO,SAAS,UAAU;EAC7B,MAAM,SAAS,MAAM,oBAAoB;GACxC;GACA,QAAQ,OAAO;GACf,WAAW,OAAO;GAClB,WAAW,OAAO;GAClB;GACA;GACA;GACA;EACD,CAAC;EACD,OAAO;GAAE,QAAQ,OAAO;GAAQ,WAAW,OAAO;EAAU;CAC7D;CACA,MAAM,SAAS,MAAM,uBAAuB;EAC3C;EACA,QAAQ,OAAO;EACf,WAAW,OAAO;EAClB,WAAW,OAAO;EAClB,OAAO,OAAO;EACd,WAAW,OAAO;EAClB;EACA;EACA;EACA;CACD,CAAC;CACD,OAAO;EAAE,QAAQ,OAAO;EAAQ,WAAW,OAAO;CAAU;AAC7D;;;;;;;;;;AAWA,MAAa,YACZ,MACA,QACA,YAC+F;CAC/F,MAAM;CACN,SAAS,OAAO,EAAE,UAAU;EAC3B,MAAM,UAAU,kBAAkB,MAAM,cAAc,QAAQ,GAAG,CAAC;EAClE,IAAI,QAAQ,WAAW,GACtB,OAAO,EAAE,QAAQ;GAAE,QAAQ;GAAG,QAAQ;EAAE,EAAE;EAE3C,MAAM,YAAY,MAAM,iBAAiB,QAAQ,IAAI,OAAO;EAC5D,MAAM,sBAAM,IAAI,KAAK;EACrB,IAAI,SAAS;EACb,IAAI,SAAS;EAIb,MAAM,8BAAc,IAAI,IAAY;EACpC,MAAM,UAAU,WAAW,IAAI,OAAO;EACtC,KAAK,MAAM,SAAS,WAAW;GAC9B,MAAM,WAAW,UAAU,MAAM,mBAAmB,SAAS,KAAK,KAAK,IAAA;GACvE,KAAK,MAAM,UAAU,SACpB,IAAI;IACH,MAAM,SAAS,MAAM,UAAU;KAAE;KAAQ;KAAK;KAAK;KAAO;IAAS,CAAC;IACpE,IAAI,OAAO,WAAW,MACrB;SACM,IAAI,UAAU,MAAM;KAC1B,MAAM,MAAM,GAAG,MAAM,GAAG,OAAO;KAC/B,IAAI,CAAC,YAAY,IAAI,GAAG,GAAG;MAC1B,YAAY,IAAI,GAAG;MACnB,IAAI,QAAQ,OAAO,KAClB,gCAAgC,MAAM,aAAa,OAAO,UAAU,cAAc,OAAO,OAAO,YACjG;KACD;IACD;GACD,SAAS,KAAK;IACb;IACA,IAAI,QAAQ,OAAO,KAClB,yBAAyB,OAAO,KAAK,aAAa,OAAO,OAAO,YAAY,SAAS,GAAG,aAAa,OAAO,GAAG,GAChH;GACD;EAEF;EACA,OAAO,EAAE,QAAQ;GAAE;GAAQ;EAAO,EAAE;CACrC;CACA,UAAU,CAAC;EAAE;EAAM,OAAO;CAAU,CAAC;AACtC"}
@@ -1,7 +1,10 @@
1
- import { keys } from "../translations/keys.js";
2
- import { labelForKey } from "../translations/server.js";
1
+ import { docScope } from "../plugin/scopeChange.js";
3
2
  import { providerCreateAccess, providerRowAccess } from "./access.js";
4
3
  import { stampScope } from "./stampScope.js";
4
+ import { keys } from "../translations/keys.js";
5
+ import { labelForKey } from "../translations/server.js";
6
+ import { validateCurrency } from "../goals/currency.js";
7
+ import { validateMeasurementId } from "../adapters/ga4/measurementId.js";
5
8
  //#region src/providers/collection.ts
6
9
  const PROVIDERS_SLUG = "analytics-providers";
7
10
  const textField = (name, label, width) => ({
@@ -16,6 +19,33 @@ const secretField = (args, opts) => args.buildSecret({
16
19
  label: labelForKey(opts.label),
17
20
  ...opts.width ? { admin: { width: opts.width } } : {}
18
21
  });
22
+ /**
23
+ * Public capture config: plain text, never a sealed secret, because the tracker config
24
+ * serves it to the browser. An adapter declares `capture` only when its public field is
25
+ * filled, so these are what let a provider document fill a capture slot.
26
+ */
27
+ const captureField = (name, label, opts = {}) => ({
28
+ name,
29
+ type: "text",
30
+ label: labelForKey(label),
31
+ ...opts.validate ? { validate: opts.validate } : {},
32
+ admin: {
33
+ description: labelForKey(keys.providerFieldCaptureHelp),
34
+ ...opts.width ? { width: opts.width } : {}
35
+ }
36
+ });
37
+ /**
38
+ * The plugin's own scope field, and only when `scopeField` still names it: a host-owned
39
+ * field (a tenant plugin's relationship) is the host's to register, and shadowing it with a
40
+ * hidden text field of another name would store the scope twice.
41
+ */
42
+ const scopeField = (args) => args.scopeField === "scope" ? [{
43
+ name: "scope",
44
+ type: "text",
45
+ index: true,
46
+ label: labelForKey(keys.providerFieldScope),
47
+ admin: { hidden: true }
48
+ }] : [];
19
49
  const hostField = () => ({
20
50
  name: "host",
21
51
  type: "text",
@@ -61,12 +91,15 @@ const buildProvidersCollection = (args) => {
61
91
  },
62
92
  hooks: {
63
93
  beforeChange: [stampScope(args)],
64
- afterChange: [({ doc }) => {
65
- args.onChange();
94
+ afterChange: [async ({ doc, operation, previousDoc }) => {
95
+ await args.onChange({
96
+ scope: docScope(doc, args.scopeField),
97
+ ...operation === "update" ? { previousScope: docScope(previousDoc, args.scopeField) } : {}
98
+ });
66
99
  return doc;
67
100
  }],
68
- afterDelete: [({ doc }) => {
69
- args.onChange();
101
+ afterDelete: [async ({ doc }) => {
102
+ await args.onChange({ scope: docScope(doc, args.scopeField) });
70
103
  return doc;
71
104
  }]
72
105
  },
@@ -114,21 +147,28 @@ const buildProvidersCollection = (args) => {
114
147
  }
115
148
  }]
116
149
  },
117
- {
118
- name: "scope",
119
- type: "text",
120
- index: true,
121
- label: labelForKey(keys.providerFieldScope),
122
- admin: { hidden: true }
123
- },
124
- providerGroup("plausible", keys.providerNamePlausible, [{
125
- type: "row",
126
- fields: [textField("siteId", keys.providerFieldSiteId, "50%"), ...secretField(args, {
127
- name: "apiKey",
128
- label: keys.providerFieldApiKey,
129
- width: "50%"
130
- })]
131
- }, hostField()]),
150
+ ...scopeField(args),
151
+ providerGroup("plausible", keys.providerNamePlausible, [
152
+ {
153
+ type: "row",
154
+ fields: [textField("siteId", keys.providerFieldSiteId, "50%"), ...secretField(args, {
155
+ name: "apiKey",
156
+ label: keys.providerFieldApiKey,
157
+ width: "50%"
158
+ })]
159
+ },
160
+ {
161
+ type: "row",
162
+ fields: [captureField("domain", keys.providerFieldDomain, { width: "50%" }), captureField("scriptId", keys.providerFieldScriptId, { width: "50%" })]
163
+ },
164
+ {
165
+ name: "revenueCurrency",
166
+ type: "text",
167
+ label: labelForKey(keys.providerFieldRevenueCurrency),
168
+ validate: validateCurrency
169
+ },
170
+ hostField()
171
+ ]),
132
172
  providerGroup("umami", keys.providerNameUmami, [
133
173
  {
134
174
  type: "row",
@@ -150,20 +190,40 @@ const buildProvidersCollection = (args) => {
150
190
  fields: [textField("propertyId", keys.providerFieldPropertyId, "50%"), textField("projectId", keys.providerFieldProjectId, "50%")]
151
191
  },
152
192
  textField("clientEmail", keys.providerFieldClientEmail),
193
+ captureField("measurementId", keys.providerFieldMeasurementId, { validate: validateMeasurementId }),
153
194
  ...args.buildSecret({
154
195
  name: "privateKey",
155
196
  type: "textarea",
156
197
  label: labelForKey(keys.providerFieldPrivateKey)
157
198
  })
158
199
  ]),
159
- providerGroup("posthog", keys.providerNamePosthog, [{
160
- type: "row",
161
- fields: [textField("projectId", keys.providerFieldProjectId, "50%"), ...secretField(args, {
162
- name: "apiKey",
163
- label: keys.providerFieldApiKey,
164
- width: "50%"
165
- })]
166
- }, hostField()])
200
+ providerGroup("posthog", keys.providerNamePosthog, [
201
+ {
202
+ type: "row",
203
+ fields: [textField("projectId", keys.providerFieldProjectId, "50%"), ...secretField(args, {
204
+ name: "apiKey",
205
+ label: keys.providerFieldApiKey,
206
+ width: "50%"
207
+ })]
208
+ },
209
+ {
210
+ type: "row",
211
+ fields: [captureField("projectToken", keys.providerFieldProjectToken, { width: "50%" }), {
212
+ name: "region",
213
+ type: "select",
214
+ label: labelForKey(keys.providerFieldRegion),
215
+ options: [{
216
+ label: "US",
217
+ value: "us"
218
+ }, {
219
+ label: "EU",
220
+ value: "eu"
221
+ }],
222
+ admin: { width: "50%" }
223
+ }]
224
+ },
225
+ hostField()
226
+ ])
167
227
  ]
168
228
  };
169
229
  return args.overrides ? args.overrides(collection) : collection;
@@ -1 +1 @@
1
- {"version":3,"file":"collection.js","names":[],"sources":["../../src/providers/collection.ts"],"sourcesContent":["import type { CollectionConfig, Field, TextareaField, TextField } from 'payload'\nimport { keys, type TranslationKey } from '../translations/keys'\nimport { labelForKey } from '../translations/server'\nimport type { ProviderAccessArgs } from './access'\nimport { providerCreateAccess, providerRowAccess } from './access'\nimport type { ProviderId } from './factory'\nimport { stampScope } from './stampScope'\n\nexport const PROVIDERS_SLUG = 'analytics-providers'\n\n/** Builds the sealed variant of a secret source field; injected so the fields peer stays lazy. */\nexport type BuildSecretField = (source: TextField | TextareaField) => Field[]\n\nexport interface BuildProvidersCollectionArgs extends ProviderAccessArgs {\n\tslug: string\n\taccess?: Partial<CollectionConfig['access']>\n\toverrides?: (collection: CollectionConfig) => CollectionConfig\n\t/** Called after any change or delete so the per-scope registry cache drops stale adapters. */\n\tonChange: () => void\n\tbuildSecret: BuildSecretField\n}\n\nconst textField = (name: string, label: TranslationKey, width?: string): Field => ({\n\tname,\n\ttype: 'text',\n\tlabel: labelForKey(label),\n\t...(width ? { admin: { width } } : {}),\n})\n\nconst secretField = (\n\targs: BuildProvidersCollectionArgs,\n\topts: { name: string; label: TranslationKey; width?: string }\n): Field[] =>\n\targs.buildSecret({\n\t\tname: opts.name,\n\t\ttype: 'text',\n\t\tlabel: labelForKey(opts.label),\n\t\t...(opts.width ? { admin: { width: opts.width } } : {}),\n\t})\n\nconst hostField = (): Field => ({\n\tname: 'host',\n\ttype: 'text',\n\tlabel: labelForKey(keys.providerFieldHost),\n\tadmin: { description: labelForKey(keys.providerFieldHostHelp) },\n})\n\nconst providerGroup = (provider: ProviderId, label: TranslationKey, fields: Field[]): Field => ({\n\tname: provider,\n\ttype: 'group',\n\tlabel: labelForKey(label),\n\tadmin: { condition: (data) => data?.provider === provider },\n\tfields,\n})\n\n/**\n * The runtime provider-settings collection: one document per provider (and per scope\n * in scoped installs). Admin-only by default; `access` entries override individual\n * operations and `overrides` reshapes the whole config last, so slugs, labels,\n * fields, and access all stay overridable.\n */\nexport const buildProvidersCollection = (args: BuildProvidersCollectionArgs): CollectionConfig => {\n\tconst collection: CollectionConfig = {\n\t\tslug: args.slug,\n\t\tlabels: {\n\t\t\tsingular: labelForKey(keys.providersCollectionSingular),\n\t\t\tplural: labelForKey(keys.providersCollectionPlural),\n\t\t},\n\t\tdisableDuplicate: true,\n\t\tadmin: {\n\t\t\tuseAsTitle: 'name',\n\t\t\tdefaultColumns: ['name', 'provider', 'enabled'],\n\t\t\tgroup: 'Analytics',\n\t\t},\n\t\taccess: {\n\t\t\tread: providerRowAccess(args),\n\t\t\tcreate: providerCreateAccess(args),\n\t\t\tupdate: providerRowAccess(args),\n\t\t\tdelete: providerRowAccess(args),\n\t\t\t...args.access,\n\t\t},\n\t\thooks: {\n\t\t\tbeforeChange: [stampScope(args)],\n\t\t\tafterChange: [\n\t\t\t\t({ doc }) => {\n\t\t\t\t\targs.onChange()\n\t\t\t\t\treturn doc\n\t\t\t\t},\n\t\t\t],\n\t\t\tafterDelete: [\n\t\t\t\t({ doc }) => {\n\t\t\t\t\targs.onChange()\n\t\t\t\t\treturn doc\n\t\t\t\t},\n\t\t\t],\n\t\t},\n\t\tfields: [\n\t\t\t{\n\t\t\t\tname: 'name',\n\t\t\t\ttype: 'text',\n\t\t\t\trequired: true,\n\t\t\t\tlabel: labelForKey(keys.providerFieldName),\n\t\t\t},\n\t\t\t{\n\t\t\t\ttype: 'row',\n\t\t\t\tfields: [\n\t\t\t\t\t{\n\t\t\t\t\t\tname: 'provider',\n\t\t\t\t\t\ttype: 'select',\n\t\t\t\t\t\trequired: true,\n\t\t\t\t\t\tlabel: labelForKey(keys.providerFieldProvider),\n\t\t\t\t\t\toptions: [\n\t\t\t\t\t\t\t{ label: labelForKey(keys.providerNamePlausible), value: 'plausible' },\n\t\t\t\t\t\t\t{ label: labelForKey(keys.providerNameUmami), value: 'umami' },\n\t\t\t\t\t\t\t{ label: labelForKey(keys.providerNameGa4), value: 'ga4' },\n\t\t\t\t\t\t\t{ label: labelForKey(keys.providerNamePosthog), value: 'posthog' },\n\t\t\t\t\t\t],\n\t\t\t\t\t\tadmin: { width: '50%' },\n\t\t\t\t\t},\n\t\t\t\t\t{\n\t\t\t\t\t\tname: 'enabled',\n\t\t\t\t\t\ttype: 'checkbox',\n\t\t\t\t\t\tdefaultValue: true,\n\t\t\t\t\t\tlabel: labelForKey(keys.providerFieldEnabled),\n\t\t\t\t\t\tadmin: { width: '50%', style: { alignSelf: 'flex-end' } },\n\t\t\t\t\t},\n\t\t\t\t],\n\t\t\t},\n\t\t\t{\n\t\t\t\t// Written by scoped setups (or a tenant plugin's own field via `scopeField`);\n\t\t\t\t// hidden because single-site installs never touch it.\n\t\t\t\tname: 'scope',\n\t\t\t\ttype: 'text',\n\t\t\t\tindex: true,\n\t\t\t\tlabel: labelForKey(keys.providerFieldScope),\n\t\t\t\tadmin: { hidden: true },\n\t\t\t},\n\t\t\tproviderGroup('plausible', keys.providerNamePlausible, [\n\t\t\t\t{\n\t\t\t\t\ttype: 'row',\n\t\t\t\t\tfields: [\n\t\t\t\t\t\ttextField('siteId', keys.providerFieldSiteId, '50%'),\n\t\t\t\t\t\t...secretField(args, { name: 'apiKey', label: keys.providerFieldApiKey, width: '50%' }),\n\t\t\t\t\t],\n\t\t\t\t},\n\t\t\t\thostField(),\n\t\t\t]),\n\t\t\tproviderGroup('umami', keys.providerNameUmami, [\n\t\t\t\t{\n\t\t\t\t\ttype: 'row',\n\t\t\t\t\tfields: [\n\t\t\t\t\t\ttextField('websiteId', keys.providerFieldWebsiteId, '50%'),\n\t\t\t\t\t\t...secretField(args, { name: 'apiKey', label: keys.providerFieldApiKey, width: '50%' }),\n\t\t\t\t\t],\n\t\t\t\t},\n\t\t\t\t...secretField(args, { name: 'token', label: keys.providerFieldToken }),\n\t\t\t\thostField(),\n\t\t\t]),\n\t\t\tproviderGroup('ga4', keys.providerNameGa4, [\n\t\t\t\t{\n\t\t\t\t\ttype: 'row',\n\t\t\t\t\tfields: [\n\t\t\t\t\t\ttextField('propertyId', keys.providerFieldPropertyId, '50%'),\n\t\t\t\t\t\ttextField('projectId', keys.providerFieldProjectId, '50%'),\n\t\t\t\t\t],\n\t\t\t\t},\n\t\t\t\ttextField('clientEmail', keys.providerFieldClientEmail),\n\t\t\t\t...args.buildSecret({\n\t\t\t\t\tname: 'privateKey',\n\t\t\t\t\ttype: 'textarea',\n\t\t\t\t\tlabel: labelForKey(keys.providerFieldPrivateKey),\n\t\t\t\t}),\n\t\t\t]),\n\t\t\tproviderGroup('posthog', keys.providerNamePosthog, [\n\t\t\t\t{\n\t\t\t\t\ttype: 'row',\n\t\t\t\t\tfields: [\n\t\t\t\t\t\ttextField('projectId', keys.providerFieldProjectId, '50%'),\n\t\t\t\t\t\t...secretField(args, { name: 'apiKey', label: keys.providerFieldApiKey, width: '50%' }),\n\t\t\t\t\t],\n\t\t\t\t},\n\t\t\t\thostField(),\n\t\t\t]),\n\t\t],\n\t}\n\treturn args.overrides ? args.overrides(collection) : collection\n}\n"],"mappings":"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"}
1
+ {"version":3,"file":"collection.js","names":[],"sources":["../../src/providers/collection.ts"],"sourcesContent":["import type {\n\tCollectionConfig,\n\tField,\n\tTextareaField,\n\tTextField,\n\tTextFieldSingleValidation,\n} from 'payload'\nimport { validateMeasurementId } from '../adapters/ga4/measurementId'\nimport { validateCurrency } from '../goals/currency'\nimport { docScope, type ScopeChange } from '../plugin/scopeChange'\nimport { keys, type TranslationKey } from '../translations/keys'\nimport { labelForKey } from '../translations/server'\nimport type { ProviderAccessArgs } from './access'\nimport { providerCreateAccess, providerRowAccess } from './access'\nimport type { ProviderId } from './factory'\nimport { stampScope } from './stampScope'\n\nexport const PROVIDERS_SLUG = 'analytics-providers'\n\n/** Builds the sealed variant of a secret source field; injected so the fields peer stays lazy. */\nexport type BuildSecretField = (source: TextField | TextareaField) => Field[]\n\nexport interface BuildProvidersCollectionArgs extends ProviderAccessArgs {\n\tslug: string\n\taccess?: Partial<CollectionConfig['access']>\n\toverrides?: (collection: CollectionConfig) => CollectionConfig\n\t/**\n\t * Called after any change or delete with the scopes the write touched, so the per-scope\n\t * registry cache drops stale adapters and the scope's cached reads are retired.\n\t */\n\tonChange: (change: ScopeChange) => void | Promise<void>\n\tbuildSecret: BuildSecretField\n}\n\nconst textField = (name: string, label: TranslationKey, width?: string): Field => ({\n\tname,\n\ttype: 'text',\n\tlabel: labelForKey(label),\n\t...(width ? { admin: { width } } : {}),\n})\n\nconst secretField = (\n\targs: BuildProvidersCollectionArgs,\n\topts: { name: string; label: TranslationKey; width?: string }\n): Field[] =>\n\targs.buildSecret({\n\t\tname: opts.name,\n\t\ttype: 'text',\n\t\tlabel: labelForKey(opts.label),\n\t\t...(opts.width ? { admin: { width: opts.width } } : {}),\n\t})\n\n/**\n * Public capture config: plain text, never a sealed secret, because the tracker config\n * serves it to the browser. An adapter declares `capture` only when its public field is\n * filled, so these are what let a provider document fill a capture slot.\n */\nconst captureField = (\n\tname: string,\n\tlabel: TranslationKey,\n\topts: { width?: string; validate?: TextFieldSingleValidation } = {}\n): Field => ({\n\tname,\n\ttype: 'text',\n\tlabel: labelForKey(label),\n\t...(opts.validate ? { validate: opts.validate } : {}),\n\tadmin: {\n\t\tdescription: labelForKey(keys.providerFieldCaptureHelp),\n\t\t...(opts.width ? { width: opts.width } : {}),\n\t},\n})\n\n/**\n * The plugin's own scope field, and only when `scopeField` still names it: a host-owned\n * field (a tenant plugin's relationship) is the host's to register, and shadowing it with a\n * hidden text field of another name would store the scope twice.\n */\nconst scopeField = (args: BuildProvidersCollectionArgs): Field[] =>\n\targs.scopeField === 'scope'\n\t\t? [\n\t\t\t\t{\n\t\t\t\t\t// Written by scoped setups; hidden because single-site installs never touch it.\n\t\t\t\t\tname: 'scope',\n\t\t\t\t\ttype: 'text',\n\t\t\t\t\tindex: true,\n\t\t\t\t\tlabel: labelForKey(keys.providerFieldScope),\n\t\t\t\t\tadmin: { hidden: true },\n\t\t\t\t},\n\t\t\t]\n\t\t: []\n\nconst hostField = (): Field => ({\n\tname: 'host',\n\ttype: 'text',\n\tlabel: labelForKey(keys.providerFieldHost),\n\tadmin: { description: labelForKey(keys.providerFieldHostHelp) },\n})\n\nconst providerGroup = (provider: ProviderId, label: TranslationKey, fields: Field[]): Field => ({\n\tname: provider,\n\ttype: 'group',\n\tlabel: labelForKey(label),\n\tadmin: { condition: (data) => data?.provider === provider },\n\tfields,\n})\n\n/**\n * The runtime provider-settings collection: one document per provider (and per scope\n * in scoped installs). Admin-only by default; `access` entries override individual\n * operations and `overrides` reshapes the whole config last, so slugs, labels,\n * fields, and access all stay overridable.\n */\nexport const buildProvidersCollection = (args: BuildProvidersCollectionArgs): CollectionConfig => {\n\tconst collection: CollectionConfig = {\n\t\tslug: args.slug,\n\t\tlabels: {\n\t\t\tsingular: labelForKey(keys.providersCollectionSingular),\n\t\t\tplural: labelForKey(keys.providersCollectionPlural),\n\t\t},\n\t\tdisableDuplicate: true,\n\t\tadmin: {\n\t\t\tuseAsTitle: 'name',\n\t\t\tdefaultColumns: ['name', 'provider', 'enabled'],\n\t\t\tgroup: 'Analytics',\n\t\t},\n\t\taccess: {\n\t\t\tread: providerRowAccess(args),\n\t\t\tcreate: providerCreateAccess(args),\n\t\t\tupdate: providerRowAccess(args),\n\t\t\tdelete: providerRowAccess(args),\n\t\t\t...args.access,\n\t\t},\n\t\thooks: {\n\t\t\tbeforeChange: [stampScope(args)],\n\t\t\tafterChange: [\n\t\t\t\tasync ({ doc, operation, previousDoc }) => {\n\t\t\t\t\tawait args.onChange({\n\t\t\t\t\t\tscope: docScope(doc, args.scopeField),\n\t\t\t\t\t\t...(operation === 'update'\n\t\t\t\t\t\t\t? { previousScope: docScope(previousDoc, args.scopeField) }\n\t\t\t\t\t\t\t: {}),\n\t\t\t\t\t})\n\t\t\t\t\treturn doc\n\t\t\t\t},\n\t\t\t],\n\t\t\tafterDelete: [\n\t\t\t\tasync ({ doc }) => {\n\t\t\t\t\tawait args.onChange({ scope: docScope(doc, args.scopeField) })\n\t\t\t\t\treturn doc\n\t\t\t\t},\n\t\t\t],\n\t\t},\n\t\tfields: [\n\t\t\t{\n\t\t\t\tname: 'name',\n\t\t\t\ttype: 'text',\n\t\t\t\trequired: true,\n\t\t\t\tlabel: labelForKey(keys.providerFieldName),\n\t\t\t},\n\t\t\t{\n\t\t\t\ttype: 'row',\n\t\t\t\tfields: [\n\t\t\t\t\t{\n\t\t\t\t\t\tname: 'provider',\n\t\t\t\t\t\ttype: 'select',\n\t\t\t\t\t\trequired: true,\n\t\t\t\t\t\tlabel: labelForKey(keys.providerFieldProvider),\n\t\t\t\t\t\toptions: [\n\t\t\t\t\t\t\t{ label: labelForKey(keys.providerNamePlausible), value: 'plausible' },\n\t\t\t\t\t\t\t{ label: labelForKey(keys.providerNameUmami), value: 'umami' },\n\t\t\t\t\t\t\t{ label: labelForKey(keys.providerNameGa4), value: 'ga4' },\n\t\t\t\t\t\t\t{ label: labelForKey(keys.providerNamePosthog), value: 'posthog' },\n\t\t\t\t\t\t],\n\t\t\t\t\t\tadmin: { width: '50%' },\n\t\t\t\t\t},\n\t\t\t\t\t{\n\t\t\t\t\t\tname: 'enabled',\n\t\t\t\t\t\ttype: 'checkbox',\n\t\t\t\t\t\tdefaultValue: true,\n\t\t\t\t\t\tlabel: labelForKey(keys.providerFieldEnabled),\n\t\t\t\t\t\tadmin: { width: '50%', style: { alignSelf: 'flex-end' } },\n\t\t\t\t\t},\n\t\t\t\t],\n\t\t\t},\n\t\t\t...scopeField(args),\n\t\t\tproviderGroup('plausible', keys.providerNamePlausible, [\n\t\t\t\t{\n\t\t\t\t\ttype: 'row',\n\t\t\t\t\tfields: [\n\t\t\t\t\t\ttextField('siteId', keys.providerFieldSiteId, '50%'),\n\t\t\t\t\t\t...secretField(args, { name: 'apiKey', label: keys.providerFieldApiKey, width: '50%' }),\n\t\t\t\t\t],\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\ttype: 'row',\n\t\t\t\t\tfields: [\n\t\t\t\t\t\tcaptureField('domain', keys.providerFieldDomain, { width: '50%' }),\n\t\t\t\t\t\tcaptureField('scriptId', keys.providerFieldScriptId, { width: '50%' }),\n\t\t\t\t\t],\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\tname: 'revenueCurrency',\n\t\t\t\t\ttype: 'text',\n\t\t\t\t\tlabel: labelForKey(keys.providerFieldRevenueCurrency),\n\t\t\t\t\tvalidate: validateCurrency,\n\t\t\t\t},\n\t\t\t\thostField(),\n\t\t\t]),\n\t\t\tproviderGroup('umami', keys.providerNameUmami, [\n\t\t\t\t{\n\t\t\t\t\ttype: 'row',\n\t\t\t\t\tfields: [\n\t\t\t\t\t\ttextField('websiteId', keys.providerFieldWebsiteId, '50%'),\n\t\t\t\t\t\t...secretField(args, { name: 'apiKey', label: keys.providerFieldApiKey, width: '50%' }),\n\t\t\t\t\t],\n\t\t\t\t},\n\t\t\t\t...secretField(args, { name: 'token', label: keys.providerFieldToken }),\n\t\t\t\thostField(),\n\t\t\t]),\n\t\t\tproviderGroup('ga4', keys.providerNameGa4, [\n\t\t\t\t{\n\t\t\t\t\ttype: 'row',\n\t\t\t\t\tfields: [\n\t\t\t\t\t\ttextField('propertyId', keys.providerFieldPropertyId, '50%'),\n\t\t\t\t\t\ttextField('projectId', keys.providerFieldProjectId, '50%'),\n\t\t\t\t\t],\n\t\t\t\t},\n\t\t\t\ttextField('clientEmail', keys.providerFieldClientEmail),\n\t\t\t\tcaptureField('measurementId', keys.providerFieldMeasurementId, {\n\t\t\t\t\tvalidate: validateMeasurementId,\n\t\t\t\t}),\n\t\t\t\t...args.buildSecret({\n\t\t\t\t\tname: 'privateKey',\n\t\t\t\t\ttype: 'textarea',\n\t\t\t\t\tlabel: labelForKey(keys.providerFieldPrivateKey),\n\t\t\t\t}),\n\t\t\t]),\n\t\t\tproviderGroup('posthog', keys.providerNamePosthog, [\n\t\t\t\t{\n\t\t\t\t\ttype: 'row',\n\t\t\t\t\tfields: [\n\t\t\t\t\t\ttextField('projectId', keys.providerFieldProjectId, '50%'),\n\t\t\t\t\t\t...secretField(args, { name: 'apiKey', label: keys.providerFieldApiKey, width: '50%' }),\n\t\t\t\t\t],\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\ttype: 'row',\n\t\t\t\t\tfields: [\n\t\t\t\t\t\tcaptureField('projectToken', keys.providerFieldProjectToken, { width: '50%' }),\n\t\t\t\t\t\t{\n\t\t\t\t\t\t\tname: 'region',\n\t\t\t\t\t\t\ttype: 'select',\n\t\t\t\t\t\t\tlabel: labelForKey(keys.providerFieldRegion),\n\t\t\t\t\t\t\toptions: [\n\t\t\t\t\t\t\t\t{ label: 'US', value: 'us' },\n\t\t\t\t\t\t\t\t{ label: 'EU', value: 'eu' },\n\t\t\t\t\t\t\t],\n\t\t\t\t\t\t\tadmin: { width: '50%' },\n\t\t\t\t\t\t},\n\t\t\t\t\t],\n\t\t\t\t},\n\t\t\t\thostField(),\n\t\t\t]),\n\t\t],\n\t}\n\treturn args.overrides ? args.overrides(collection) : collection\n}\n"],"mappings":"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"}
@@ -4,6 +4,8 @@ import { posthog } from "../adapters/posthog/posthog.js";
4
4
  import { umami } from "../adapters/umami/umami.js";
5
5
  //#region src/providers/factory.ts
6
6
  const orUndefined = (value) => value || void 0;
7
+ /** An unset or unrecognized stored region falls back to host-derived detection. */
8
+ const posthogRegion = (value) => value === "us" || value === "eu" ? value : void 0;
7
9
  /**
8
10
  * Keys pasted from a service-account JSON often carry escaped newlines; the gRPC
9
11
  * client needs real ones.
@@ -26,7 +28,10 @@ const buildBaseAdapter = (doc) => {
26
28
  return plausible({
27
29
  siteId: cfg.siteId ?? "",
28
30
  apiKey: cfg.apiKey ?? "",
29
- host: orUndefined(cfg.host)
31
+ host: orUndefined(cfg.host),
32
+ domain: orUndefined(cfg.domain),
33
+ scriptId: orUndefined(cfg.scriptId),
34
+ revenueCurrency: orUndefined(cfg.revenueCurrency)
30
35
  });
31
36
  }
32
37
  case "umami": {
@@ -46,7 +51,8 @@ const buildBaseAdapter = (doc) => {
46
51
  client_email: cfg.clientEmail ?? "",
47
52
  private_key: normalizePrivateKey(cfg.privateKey ?? "")
48
53
  },
49
- projectId: orUndefined(cfg.projectId)
54
+ projectId: orUndefined(cfg.projectId),
55
+ measurementId: orUndefined(cfg.measurementId)
50
56
  });
51
57
  }
52
58
  case "posthog": {
@@ -54,7 +60,9 @@ const buildBaseAdapter = (doc) => {
54
60
  return posthog({
55
61
  projectId: cfg.projectId ?? "",
56
62
  apiKey: cfg.apiKey ?? "",
57
- host: orUndefined(cfg.host)
63
+ host: orUndefined(cfg.host),
64
+ projectToken: orUndefined(cfg.projectToken),
65
+ region: posthogRegion(cfg.region)
58
66
  });
59
67
  }
60
68
  default: return null;
@@ -1 +1 @@
1
- {"version":3,"file":"factory.js","names":[],"sources":["../../src/providers/factory.ts"],"sourcesContent":["import { ga4 } from '../adapters/ga4/ga4'\nimport { plausible } from '../adapters/plausible/plausible'\nimport { posthog } from '../adapters/posthog/posthog'\nimport { umami } from '../adapters/umami/umami'\nimport type { AnalyticsAdapter } from '../core/contract'\n\nexport const PROVIDER_IDS = ['plausible', 'umami', 'ga4', 'posthog'] as const\nexport type ProviderId = (typeof PROVIDER_IDS)[number]\n\n/** The provider-settings document shape the adapter factory reads (depth 0, secrets revealed). */\nexport type ProviderDoc = {\n\tid?: number | string\n\tname?: string | null\n\tprovider?: string | null\n\tenabled?: boolean | null\n\tscope?: string | null\n\tplausible?: { siteId?: string | null; apiKey?: string | null; host?: string | null } | null\n\tumami?: {\n\t\twebsiteId?: string | null\n\t\tapiKey?: string | null\n\t\ttoken?: string | null\n\t\thost?: string | null\n\t} | null\n\tga4?: {\n\t\tpropertyId?: string | null\n\t\tclientEmail?: string | null\n\t\tprivateKey?: string | null\n\t\tprojectId?: string | null\n\t} | null\n\tposthog?: { projectId?: string | null; apiKey?: string | null; host?: string | null } | null\n}\n\nconst orUndefined = (value: string | null | undefined): string | undefined => value || undefined\n\n/**\n * Keys pasted from a service-account JSON often carry escaped newlines; the gRPC\n * client needs real ones.\n */\nexport const normalizePrivateKey = (key: string): string => key.replace(/\\\\n/g, '\\n')\n\nconst shortId = (id: number | string): string => String(id).slice(-6)\n\n/** Runtime adapters carry a per-document instance id so two projects of one provider type never collide in a registry; config adapters keep their plain ids. */\nconst withInstanceIdentity = (adapter: AnalyticsAdapter, doc: ProviderDoc): AnalyticsAdapter => {\n\tif (doc.id === undefined || doc.id === null || doc.id === '') {\n\t\treturn adapter\n\t}\n\treturn {\n\t\t...adapter,\n\t\tid: `${doc.provider}:${doc.id}`,\n\t\tlabel: doc.name || `${adapter.label} ${shortId(doc.id)}`,\n\t}\n}\n\nconst buildBaseAdapter = (doc: ProviderDoc): AnalyticsAdapter | null => {\n\tswitch (doc.provider) {\n\t\tcase 'plausible': {\n\t\t\tconst cfg = doc.plausible ?? {}\n\t\t\treturn plausible({\n\t\t\t\tsiteId: cfg.siteId ?? '',\n\t\t\t\tapiKey: cfg.apiKey ?? '',\n\t\t\t\thost: orUndefined(cfg.host),\n\t\t\t})\n\t\t}\n\t\tcase 'umami': {\n\t\t\tconst cfg = doc.umami ?? {}\n\t\t\treturn umami({\n\t\t\t\twebsiteId: cfg.websiteId ?? '',\n\t\t\t\tapiKey: orUndefined(cfg.apiKey),\n\t\t\t\ttoken: orUndefined(cfg.token),\n\t\t\t\thost: orUndefined(cfg.host),\n\t\t\t})\n\t\t}\n\t\tcase 'ga4': {\n\t\t\tconst cfg = doc.ga4 ?? {}\n\t\t\treturn ga4({\n\t\t\t\tpropertyId: cfg.propertyId ?? '',\n\t\t\t\tcredentials: {\n\t\t\t\t\tclient_email: cfg.clientEmail ?? '',\n\t\t\t\t\tprivate_key: normalizePrivateKey(cfg.privateKey ?? ''),\n\t\t\t\t},\n\t\t\t\tprojectId: orUndefined(cfg.projectId),\n\t\t\t})\n\t\t}\n\t\tcase 'posthog': {\n\t\t\tconst cfg = doc.posthog ?? {}\n\t\t\treturn posthog({\n\t\t\t\tprojectId: cfg.projectId ?? '',\n\t\t\t\tapiKey: cfg.apiKey ?? '',\n\t\t\t\thost: orUndefined(cfg.host),\n\t\t\t})\n\t\t}\n\t\tdefault:\n\t\t\treturn null\n\t}\n}\n\n/**\n * Build an adapter instance from a provider-settings document using the same\n * constructors as config-time adapters. Missing credentials are passed through as\n * empty strings so the adapter reports `isConfigured() === false` instead of the\n * factory throwing; an unknown provider value returns null and is skipped.\n */\nexport const adapterFromProviderDoc = (doc: ProviderDoc): AnalyticsAdapter | null => {\n\tconst base = buildBaseAdapter(doc)\n\treturn base ? withInstanceIdentity(base, doc) : null\n}\n"],"mappings":";;;;;AAgCA,MAAM,eAAe,UAAyD,SAAS,KAAA;;;;;AAMvF,MAAa,uBAAuB,QAAwB,IAAI,QAAQ,QAAQ,IAAI;AAEpF,MAAM,WAAW,OAAgC,OAAO,EAAE,EAAE,MAAM,EAAE;;AAGpE,MAAM,wBAAwB,SAA2B,QAAuC;CAC/F,IAAI,IAAI,OAAO,KAAA,KAAa,IAAI,OAAO,QAAQ,IAAI,OAAO,IACzD,OAAO;CAER,OAAO;EACN,GAAG;EACH,IAAI,GAAG,IAAI,SAAS,GAAG,IAAI;EAC3B,OAAO,IAAI,QAAQ,GAAG,QAAQ,MAAM,GAAG,QAAQ,IAAI,EAAE;CACtD;AACD;AAEA,MAAM,oBAAoB,QAA8C;CACvE,QAAQ,IAAI,UAAZ;EACC,KAAK,aAAa;GACjB,MAAM,MAAM,IAAI,aAAa,CAAC;GAC9B,OAAO,UAAU;IAChB,QAAQ,IAAI,UAAU;IACtB,QAAQ,IAAI,UAAU;IACtB,MAAM,YAAY,IAAI,IAAI;GAC3B,CAAC;EACF;EACA,KAAK,SAAS;GACb,MAAM,MAAM,IAAI,SAAS,CAAC;GAC1B,OAAO,MAAM;IACZ,WAAW,IAAI,aAAa;IAC5B,QAAQ,YAAY,IAAI,MAAM;IAC9B,OAAO,YAAY,IAAI,KAAK;IAC5B,MAAM,YAAY,IAAI,IAAI;GAC3B,CAAC;EACF;EACA,KAAK,OAAO;GACX,MAAM,MAAM,IAAI,OAAO,CAAC;GACxB,OAAO,IAAI;IACV,YAAY,IAAI,cAAc;IAC9B,aAAa;KACZ,cAAc,IAAI,eAAe;KACjC,aAAa,oBAAoB,IAAI,cAAc,EAAE;IACtD;IACA,WAAW,YAAY,IAAI,SAAS;GACrC,CAAC;EACF;EACA,KAAK,WAAW;GACf,MAAM,MAAM,IAAI,WAAW,CAAC;GAC5B,OAAO,QAAQ;IACd,WAAW,IAAI,aAAa;IAC5B,QAAQ,IAAI,UAAU;IACtB,MAAM,YAAY,IAAI,IAAI;GAC3B,CAAC;EACF;EACA,SACC,OAAO;CACT;AACD;;;;;;;AAQA,MAAa,0BAA0B,QAA8C;CACpF,MAAM,OAAO,iBAAiB,GAAG;CACjC,OAAO,OAAO,qBAAqB,MAAM,GAAG,IAAI;AACjD"}
1
+ {"version":3,"file":"factory.js","names":[],"sources":["../../src/providers/factory.ts"],"sourcesContent":["import { ga4 } from '../adapters/ga4/ga4'\nimport { plausible } from '../adapters/plausible/plausible'\nimport { posthog } from '../adapters/posthog/posthog'\nimport { umami } from '../adapters/umami/umami'\nimport type { AnalyticsAdapter } from '../core/contract'\n\nexport const PROVIDER_IDS = ['plausible', 'umami', 'ga4', 'posthog'] as const\nexport type ProviderId = (typeof PROVIDER_IDS)[number]\n\n/** The provider-settings document shape the adapter factory reads (depth 0, secrets revealed). */\nexport type ProviderDoc = {\n\tid?: number | string\n\tname?: string | null\n\tprovider?: string | null\n\tenabled?: boolean | null\n\tscope?: string | null\n\tplausible?: {\n\t\tsiteId?: string | null\n\t\tapiKey?: string | null\n\t\thost?: string | null\n\t\tdomain?: string | null\n\t\tscriptId?: string | null\n\t\trevenueCurrency?: string | null\n\t} | null\n\tumami?: {\n\t\twebsiteId?: string | null\n\t\tapiKey?: string | null\n\t\ttoken?: string | null\n\t\thost?: string | null\n\t} | null\n\tga4?: {\n\t\tpropertyId?: string | null\n\t\tclientEmail?: string | null\n\t\tprivateKey?: string | null\n\t\tprojectId?: string | null\n\t\tmeasurementId?: string | null\n\t} | null\n\tposthog?: {\n\t\tprojectId?: string | null\n\t\tapiKey?: string | null\n\t\thost?: string | null\n\t\tprojectToken?: string | null\n\t\tregion?: string | null\n\t} | null\n}\n\nconst orUndefined = (value: string | null | undefined): string | undefined => value || undefined\n\n/** An unset or unrecognized stored region falls back to host-derived detection. */\nconst posthogRegion = (value: string | null | undefined): 'us' | 'eu' | undefined =>\n\tvalue === 'us' || value === 'eu' ? value : undefined\n\n/**\n * Keys pasted from a service-account JSON often carry escaped newlines; the gRPC\n * client needs real ones.\n */\nexport const normalizePrivateKey = (key: string): string => key.replace(/\\\\n/g, '\\n')\n\nconst shortId = (id: number | string): string => String(id).slice(-6)\n\n/** Runtime adapters carry a per-document instance id so two projects of one provider type never collide in a registry; config adapters keep their plain ids. */\nconst withInstanceIdentity = (adapter: AnalyticsAdapter, doc: ProviderDoc): AnalyticsAdapter => {\n\tif (doc.id === undefined || doc.id === null || doc.id === '') {\n\t\treturn adapter\n\t}\n\treturn {\n\t\t...adapter,\n\t\tid: `${doc.provider}:${doc.id}`,\n\t\tlabel: doc.name || `${adapter.label} ${shortId(doc.id)}`,\n\t}\n}\n\nconst buildBaseAdapter = (doc: ProviderDoc): AnalyticsAdapter | null => {\n\tswitch (doc.provider) {\n\t\tcase 'plausible': {\n\t\t\tconst cfg = doc.plausible ?? {}\n\t\t\treturn plausible({\n\t\t\t\tsiteId: cfg.siteId ?? '',\n\t\t\t\tapiKey: cfg.apiKey ?? '',\n\t\t\t\thost: orUndefined(cfg.host),\n\t\t\t\tdomain: orUndefined(cfg.domain),\n\t\t\t\tscriptId: orUndefined(cfg.scriptId),\n\t\t\t\trevenueCurrency: orUndefined(cfg.revenueCurrency),\n\t\t\t})\n\t\t}\n\t\tcase 'umami': {\n\t\t\tconst cfg = doc.umami ?? {}\n\t\t\treturn umami({\n\t\t\t\twebsiteId: cfg.websiteId ?? '',\n\t\t\t\tapiKey: orUndefined(cfg.apiKey),\n\t\t\t\ttoken: orUndefined(cfg.token),\n\t\t\t\thost: orUndefined(cfg.host),\n\t\t\t})\n\t\t}\n\t\tcase 'ga4': {\n\t\t\tconst cfg = doc.ga4 ?? {}\n\t\t\treturn ga4({\n\t\t\t\tpropertyId: cfg.propertyId ?? '',\n\t\t\t\tcredentials: {\n\t\t\t\t\tclient_email: cfg.clientEmail ?? '',\n\t\t\t\t\tprivate_key: normalizePrivateKey(cfg.privateKey ?? ''),\n\t\t\t\t},\n\t\t\t\tprojectId: orUndefined(cfg.projectId),\n\t\t\t\tmeasurementId: orUndefined(cfg.measurementId),\n\t\t\t})\n\t\t}\n\t\tcase 'posthog': {\n\t\t\tconst cfg = doc.posthog ?? {}\n\t\t\treturn posthog({\n\t\t\t\tprojectId: cfg.projectId ?? '',\n\t\t\t\tapiKey: cfg.apiKey ?? '',\n\t\t\t\thost: orUndefined(cfg.host),\n\t\t\t\tprojectToken: orUndefined(cfg.projectToken),\n\t\t\t\tregion: posthogRegion(cfg.region),\n\t\t\t})\n\t\t}\n\t\tdefault:\n\t\t\treturn null\n\t}\n}\n\n/**\n * Build an adapter instance from a provider-settings document using the same\n * constructors as config-time adapters. Missing credentials are passed through as\n * empty strings so the adapter reports `isConfigured() === false` instead of the\n * factory throwing; an unknown provider value returns null and is skipped.\n */\nexport const adapterFromProviderDoc = (doc: ProviderDoc): AnalyticsAdapter | null => {\n\tconst base = buildBaseAdapter(doc)\n\treturn base ? withInstanceIdentity(base, doc) : null\n}\n"],"mappings":";;;;;AA8CA,MAAM,eAAe,UAAyD,SAAS,KAAA;;AAGvF,MAAM,iBAAiB,UACtB,UAAU,QAAQ,UAAU,OAAO,QAAQ,KAAA;;;;;AAM5C,MAAa,uBAAuB,QAAwB,IAAI,QAAQ,QAAQ,IAAI;AAEpF,MAAM,WAAW,OAAgC,OAAO,EAAE,EAAE,MAAM,EAAE;;AAGpE,MAAM,wBAAwB,SAA2B,QAAuC;CAC/F,IAAI,IAAI,OAAO,KAAA,KAAa,IAAI,OAAO,QAAQ,IAAI,OAAO,IACzD,OAAO;CAER,OAAO;EACN,GAAG;EACH,IAAI,GAAG,IAAI,SAAS,GAAG,IAAI;EAC3B,OAAO,IAAI,QAAQ,GAAG,QAAQ,MAAM,GAAG,QAAQ,IAAI,EAAE;CACtD;AACD;AAEA,MAAM,oBAAoB,QAA8C;CACvE,QAAQ,IAAI,UAAZ;EACC,KAAK,aAAa;GACjB,MAAM,MAAM,IAAI,aAAa,CAAC;GAC9B,OAAO,UAAU;IAChB,QAAQ,IAAI,UAAU;IACtB,QAAQ,IAAI,UAAU;IACtB,MAAM,YAAY,IAAI,IAAI;IAC1B,QAAQ,YAAY,IAAI,MAAM;IAC9B,UAAU,YAAY,IAAI,QAAQ;IAClC,iBAAiB,YAAY,IAAI,eAAe;GACjD,CAAC;EACF;EACA,KAAK,SAAS;GACb,MAAM,MAAM,IAAI,SAAS,CAAC;GAC1B,OAAO,MAAM;IACZ,WAAW,IAAI,aAAa;IAC5B,QAAQ,YAAY,IAAI,MAAM;IAC9B,OAAO,YAAY,IAAI,KAAK;IAC5B,MAAM,YAAY,IAAI,IAAI;GAC3B,CAAC;EACF;EACA,KAAK,OAAO;GACX,MAAM,MAAM,IAAI,OAAO,CAAC;GACxB,OAAO,IAAI;IACV,YAAY,IAAI,cAAc;IAC9B,aAAa;KACZ,cAAc,IAAI,eAAe;KACjC,aAAa,oBAAoB,IAAI,cAAc,EAAE;IACtD;IACA,WAAW,YAAY,IAAI,SAAS;IACpC,eAAe,YAAY,IAAI,aAAa;GAC7C,CAAC;EACF;EACA,KAAK,WAAW;GACf,MAAM,MAAM,IAAI,WAAW,CAAC;GAC5B,OAAO,QAAQ;IACd,WAAW,IAAI,aAAa;IAC5B,QAAQ,IAAI,UAAU;IACtB,MAAM,YAAY,IAAI,IAAI;IAC1B,cAAc,YAAY,IAAI,YAAY;IAC1C,QAAQ,cAAc,IAAI,MAAM;GACjC,CAAC;EACF;EACA,SACC,OAAO;CACT;AACD;;;;;;;AAQA,MAAa,0BAA0B,QAA8C;CACpF,MAAM,OAAO,iBAAiB,GAAG;CACjC,OAAO,OAAO,qBAAqB,MAAM,GAAG,IAAI;AACjD"}
@@ -1 +1 @@
1
- {"version":3,"file":"resolver.js","names":[],"sources":["../../src/providers/resolver.ts"],"sourcesContent":["import { createLocalReq, type Where } from 'payload'\nimport type { AnalyticsAdapter } from '../core/contract'\nimport {\n\ttype AdapterRegistry,\n\tcreateRegistry,\n\ttype RegistryResolver,\n\ttype ResolveRegistryArgs,\n} from '../core/registry'\nimport { adapterFromProviderDoc, type ProviderDoc } from './factory'\nimport { SECRET_PATHS } from './secrets'\n\nexport const PROVIDERS_CACHE_TTL_MS = 30_000\n\n/** Produces the runtime adapters layered onto the static base for one scope. */\nexport type ProvidersSource = (args: ResolveRegistryArgs) => Promise<AnalyticsAdapter[]>\n\nexport interface RegistryBase {\n\tadapters: AnalyticsAdapter[]\n\tdefaultId?: string\n}\n\n/**\n * Append runtime adapters after the static base. Ids are disjoint by\n * construction (instance ids carry a ':', config ids do not); an extra that\n * still collides with a base id (a custom providers.resolve returning a plain\n * provider id) is skipped so config adapters always win, and the default\n * adapter is always a config adapter.\n */\nexport const combineRegistries = (\n\tbase: RegistryBase,\n\textra: AnalyticsAdapter[]\n): AdapterRegistry => {\n\tif (extra.length === 0) {\n\t\treturn createRegistry(base.adapters, base.defaultId)\n\t}\n\tconst seen = new Set(base.adapters.map((a) => a.id))\n\tconst merged = [...base.adapters]\n\tfor (const adapter of extra) {\n\t\tif (!seen.has(adapter.id)) {\n\t\t\tmerged.push(adapter)\n\t\t\tseen.add(adapter.id)\n\t\t}\n\t}\n\treturn createRegistry(merged, base.defaultId)\n}\n\nconst setAtPath = (doc: Record<string, unknown>, path: string, value: unknown): void => {\n\tconst [group, field] = path.split('.') as [string, string]\n\tconst target = doc[group]\n\tif (target && typeof target === 'object') {\n\t\t;(target as Record<string, unknown>)[field] = value\n\t}\n}\n\nconst getAtPath = (doc: Record<string, unknown>, path: string): unknown => {\n\tconst [group, field] = path.split('.') as [string, string]\n\tconst target = doc[group]\n\treturn target && typeof target === 'object'\n\t\t? (target as Record<string, unknown>)[field]\n\t\t: undefined\n}\n\n/**\n * Look up a scope's enabled provider documents and build adapters from them.\n * Reads raw ciphertext inside a withRawEncrypted window (write-only secrets\n * are stripped from ordinary reads), then decrypts each credential through\n * the fields key ring. Legacy plaintext rows pass through decryptFieldValue\n * unchanged, so pre-encryption documents keep working until re-saved.\n */\nexport const collectionProvidersSource = (slug: string, scopeField: string): ProvidersSource => {\n\treturn async ({ payload, req, scope }) => {\n\t\tconst { decryptFieldValue, withRawEncrypted } = await import('@10x-media/fields/encrypted')\n\t\tconst readReq = req ?? (await createLocalReq({}, payload))\n\t\tconst scopeWhere: Where =\n\t\t\tscope === null\n\t\t\t\t? { or: [{ [scopeField]: { equals: null } }, { [scopeField]: { equals: '' } }] }\n\t\t\t\t: { [scopeField]: { equals: scope } }\n\t\tconst { docs } = await withRawEncrypted(readReq, () =>\n\t\t\tpayload.find({\n\t\t\t\tcollection: slug as never,\n\t\t\t\twhere: { and: [{ enabled: { equals: true } }, scopeWhere] },\n\t\t\t\tlimit: 100,\n\t\t\t\tpagination: false,\n\t\t\t\tdepth: 0,\n\t\t\t\toverrideAccess: true,\n\t\t\t\treq: readReq,\n\t\t\t})\n\t\t)\n\t\tconst adapters: AnalyticsAdapter[] = []\n\t\tfor (const raw of docs as Array<Record<string, unknown>>) {\n\t\t\ttry {\n\t\t\t\tconst doc = structuredClone(raw) as Record<string, unknown>\n\t\t\t\tfor (const { path } of SECRET_PATHS) {\n\t\t\t\t\tconst value = getAtPath(doc, path)\n\t\t\t\t\tif (typeof value === 'string' && value !== '') {\n\t\t\t\t\t\tconst plain = await decryptFieldValue(payload, { collection: slug, path, value })\n\t\t\t\t\t\tsetAtPath(doc, path, typeof plain === 'string' ? plain : '')\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t\tconst adapter = adapterFromProviderDoc(doc as ProviderDoc)\n\t\t\t\tif (adapter) adapters.push(adapter)\n\t\t\t} catch (err) {\n\t\t\t\t// A corrupted or key-rotated-away ciphertext must not take the whole\n\t\t\t\t// scope's registry down; skip just this document's adapter.\n\t\t\t\tpayload.logger.warn(\n\t\t\t\t\t`analytics: provider document \"${String(raw.id)}\" (${String(raw.provider)}) failed to decrypt, skipping it: ${String(err)}`\n\t\t\t\t)\n\t\t\t}\n\t\t}\n\t\treturn adapters\n\t}\n}\n\nexport interface ScopedRegistryResolver {\n\tresolver: RegistryResolver\n\t/** Drops every cached scope registry; wired to the provider collection's change hooks. */\n\tinvalidate: () => void\n}\n\n/**\n * Cache resolved registries per scope for a short TTL so widget-heavy dashboards\n * do not re-query the provider collection on every read. Invalidation clears all\n * scopes at once: a document's scope binding can itself change, so per-scope\n * eviction could leave a stale entry under the old scope.\n */\nexport const createScopedRegistryResolver = (args: {\n\tbase: RegistryBase\n\tsource: ProvidersSource\n\tttlMs?: number\n}): ScopedRegistryResolver => {\n\tconst ttlMs = args.ttlMs ?? PROVIDERS_CACHE_TTL_MS\n\tconst cache = new Map<string | null, { registry: AdapterRegistry; expiresAt: number }>()\n\treturn {\n\t\tresolver: async (resolveArgs) => {\n\t\t\tconst now = Date.now()\n\t\t\tconst hit = cache.get(resolveArgs.scope)\n\t\t\tif (hit && hit.expiresAt > now) {\n\t\t\t\treturn hit.registry\n\t\t\t}\n\t\t\tconst registry = combineRegistries(args.base, await args.source(resolveArgs))\n\t\t\tcache.set(resolveArgs.scope, { registry, expiresAt: now + ttlMs })\n\t\t\treturn registry\n\t\t},\n\t\tinvalidate: () => cache.clear(),\n\t}\n}\n"],"mappings":"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"}
1
+ {"version":3,"file":"resolver.js","names":[],"sources":["../../src/providers/resolver.ts"],"sourcesContent":["import { createLocalReq, type Where } from 'payload'\nimport type { AnalyticsAdapter } from '../core/contract'\nimport {\n\ttype AdapterRegistry,\n\tcreateRegistry,\n\ttype RegistryResolver,\n\ttype ResolveRegistryArgs,\n} from '../core/registry'\nimport { adapterFromProviderDoc, type ProviderDoc } from './factory'\nimport { SECRET_PATHS } from './secrets'\n\nexport const PROVIDERS_CACHE_TTL_MS = 30_000\n\n/** Produces the runtime adapters layered onto the static base for one scope. */\nexport type ProvidersSource = (args: ResolveRegistryArgs) => Promise<AnalyticsAdapter[]>\n\nexport interface RegistryBase {\n\tadapters: AnalyticsAdapter[]\n\tdefaultId?: string\n}\n\n/**\n * Append runtime adapters after the static base. Ids are disjoint by\n * construction (instance ids carry a ':', config ids do not); an extra that\n * still collides with a base id (a custom providers.resolve returning a plain\n * provider id) is skipped so config adapters always win, and the default\n * adapter is always a config adapter.\n */\nexport const combineRegistries = (\n\tbase: RegistryBase,\n\textra: AnalyticsAdapter[]\n): AdapterRegistry => {\n\tif (extra.length === 0) {\n\t\treturn createRegistry(base.adapters, base.defaultId)\n\t}\n\tconst seen = new Set(base.adapters.map((a) => a.id))\n\tconst merged = [...base.adapters]\n\tfor (const adapter of extra) {\n\t\tif (!seen.has(adapter.id)) {\n\t\t\tmerged.push(adapter)\n\t\t\tseen.add(adapter.id)\n\t\t}\n\t}\n\treturn createRegistry(merged, base.defaultId)\n}\n\nconst setAtPath = (doc: Record<string, unknown>, path: string, value: unknown): void => {\n\tconst [group, field] = path.split('.') as [string, string]\n\tconst target = doc[group]\n\tif (target && typeof target === 'object') {\n\t\t;(target as Record<string, unknown>)[field] = value\n\t}\n}\n\nconst getAtPath = (doc: Record<string, unknown>, path: string): unknown => {\n\tconst [group, field] = path.split('.') as [string, string]\n\tconst target = doc[group]\n\treturn target && typeof target === 'object'\n\t\t? (target as Record<string, unknown>)[field]\n\t\t: undefined\n}\n\n/**\n * Look up a scope's enabled provider documents and build adapters from them.\n * Reads raw ciphertext inside a withRawEncrypted window (write-only secrets\n * are stripped from ordinary reads), then decrypts each credential through\n * the fields key ring. Legacy plaintext rows pass through decryptFieldValue\n * unchanged, so pre-encryption documents keep working until re-saved.\n */\nexport const collectionProvidersSource = (slug: string, scopeField: string): ProvidersSource => {\n\treturn async ({ payload, req, scope }) => {\n\t\tconst { decryptFieldValue, withRawEncrypted } = await import('@10x-media/fields/encrypted')\n\t\tconst readReq = req ?? (await createLocalReq({}, payload))\n\t\t// The empty string is not castable on a relationship-typed scopeField, so install-wide\n\t\t// lookups on a host-owned relationship field resolve the config adapters only.\n\t\tconst scopeWhere: Where =\n\t\t\tscope === null\n\t\t\t\t? { or: [{ [scopeField]: { equals: null } }, { [scopeField]: { equals: '' } }] }\n\t\t\t\t: { [scopeField]: { equals: scope } }\n\t\tconst { docs } = await withRawEncrypted(readReq, () =>\n\t\t\tpayload.find({\n\t\t\t\tcollection: slug as never,\n\t\t\t\twhere: { and: [{ enabled: { equals: true } }, scopeWhere] },\n\t\t\t\tlimit: 100,\n\t\t\t\tpagination: false,\n\t\t\t\tdepth: 0,\n\t\t\t\toverrideAccess: true,\n\t\t\t\treq: readReq,\n\t\t\t})\n\t\t)\n\t\tconst adapters: AnalyticsAdapter[] = []\n\t\tfor (const raw of docs as Array<Record<string, unknown>>) {\n\t\t\ttry {\n\t\t\t\tconst doc = structuredClone(raw) as Record<string, unknown>\n\t\t\t\tfor (const { path } of SECRET_PATHS) {\n\t\t\t\t\tconst value = getAtPath(doc, path)\n\t\t\t\t\tif (typeof value === 'string' && value !== '') {\n\t\t\t\t\t\tconst plain = await decryptFieldValue(payload, { collection: slug, path, value })\n\t\t\t\t\t\tsetAtPath(doc, path, typeof plain === 'string' ? plain : '')\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t\tconst adapter = adapterFromProviderDoc(doc as ProviderDoc)\n\t\t\t\tif (adapter) adapters.push(adapter)\n\t\t\t} catch (err) {\n\t\t\t\t// A corrupted or key-rotated-away ciphertext must not take the whole\n\t\t\t\t// scope's registry down; skip just this document's adapter.\n\t\t\t\tpayload.logger.warn(\n\t\t\t\t\t`analytics: provider document \"${String(raw.id)}\" (${String(raw.provider)}) failed to decrypt, skipping it: ${String(err)}`\n\t\t\t\t)\n\t\t\t}\n\t\t}\n\t\treturn adapters\n\t}\n}\n\nexport interface ScopedRegistryResolver {\n\tresolver: RegistryResolver\n\t/** Drops every cached scope registry; wired to the provider collection's change hooks. */\n\tinvalidate: () => void\n}\n\n/**\n * Cache resolved registries per scope for a short TTL so widget-heavy dashboards\n * do not re-query the provider collection on every read. Invalidation clears all\n * scopes at once: a document's scope binding can itself change, so per-scope\n * eviction could leave a stale entry under the old scope.\n */\nexport const createScopedRegistryResolver = (args: {\n\tbase: RegistryBase\n\tsource: ProvidersSource\n\tttlMs?: number\n}): ScopedRegistryResolver => {\n\tconst ttlMs = args.ttlMs ?? PROVIDERS_CACHE_TTL_MS\n\tconst cache = new Map<string | null, { registry: AdapterRegistry; expiresAt: number }>()\n\treturn {\n\t\tresolver: async (resolveArgs) => {\n\t\t\tconst now = Date.now()\n\t\t\tconst hit = cache.get(resolveArgs.scope)\n\t\t\tif (hit && hit.expiresAt > now) {\n\t\t\t\treturn hit.registry\n\t\t\t}\n\t\t\tconst registry = combineRegistries(args.base, await args.source(resolveArgs))\n\t\t\tcache.set(resolveArgs.scope, { registry, expiresAt: now + ttlMs })\n\t\t\treturn registry\n\t\t},\n\t\tinvalidate: () => cache.clear(),\n\t}\n}\n"],"mappings":";;;;;;;;;;;AA4BA,MAAa,qBACZ,MACA,UACqB;CACrB,IAAI,MAAM,WAAW,GACpB,OAAO,eAAe,KAAK,UAAU,KAAK,SAAS;CAEpD,MAAM,OAAO,IAAI,IAAI,KAAK,SAAS,KAAK,MAAM,EAAE,EAAE,CAAC;CACnD,MAAM,SAAS,CAAC,GAAG,KAAK,QAAQ;CAChC,KAAK,MAAM,WAAW,OACrB,IAAI,CAAC,KAAK,IAAI,QAAQ,EAAE,GAAG;EAC1B,OAAO,KAAK,OAAO;EACnB,KAAK,IAAI,QAAQ,EAAE;CACpB;CAED,OAAO,eAAe,QAAQ,KAAK,SAAS;AAC7C;AAEA,MAAM,aAAa,KAA8B,MAAc,UAAyB;CACvF,MAAM,CAAC,OAAO,SAAS,KAAK,MAAM,GAAG;CACrC,MAAM,SAAS,IAAI;CACnB,IAAI,UAAU,OAAO,WAAW,UAC9B,OAAoC,SAAS;AAEhD;AAEA,MAAM,aAAa,KAA8B,SAA0B;CAC1E,MAAM,CAAC,OAAO,SAAS,KAAK,MAAM,GAAG;CACrC,MAAM,SAAS,IAAI;CACnB,OAAO,UAAU,OAAO,WAAW,WAC/B,OAAmC,SACpC,KAAA;AACJ;;;;;;;;AASA,MAAa,6BAA6B,MAAc,eAAwC;CAC/F,OAAO,OAAO,EAAE,SAAS,KAAK,YAAY;EACzC,MAAM,EAAE,mBAAmB,qBAAqB,MAAM,OAAO;EAC7D,MAAM,UAAU,OAAQ,MAAM,eAAe,CAAC,GAAG,OAAO;EAGxD,MAAM,aACL,UAAU,OACP,EAAE,IAAI,CAAC,GAAG,aAAa,EAAE,QAAQ,KAAK,EAAE,GAAG,GAAG,aAAa,EAAE,QAAQ,GAAG,EAAE,CAAC,EAAE,IAC7E,GAAG,aAAa,EAAE,QAAQ,MAAM,EAAE;EACtC,MAAM,EAAE,SAAS,MAAM,iBAAiB,eACvC,QAAQ,KAAK;GACZ,YAAY;GACZ,OAAO,EAAE,KAAK,CAAC,EAAE,SAAS,EAAE,QAAQ,KAAK,EAAE,GAAG,UAAU,EAAE;GAC1D,OAAO;GACP,YAAY;GACZ,OAAO;GACP,gBAAgB;GAChB,KAAK;EACN,CAAC,CACF;EACA,MAAM,WAA+B,CAAC;EACtC,KAAK,MAAM,OAAO,MACjB,IAAI;GACH,MAAM,MAAM,gBAAgB,GAAG;GAC/B,KAAK,MAAM,EAAE,UAAU,cAAc;IACpC,MAAM,QAAQ,UAAU,KAAK,IAAI;IACjC,IAAI,OAAO,UAAU,YAAY,UAAU,IAAI;KAC9C,MAAM,QAAQ,MAAM,kBAAkB,SAAS;MAAE,YAAY;MAAM;MAAM;KAAM,CAAC;KAChF,UAAU,KAAK,MAAM,OAAO,UAAU,WAAW,QAAQ,EAAE;IAC5D;GACD;GACA,MAAM,UAAU,uBAAuB,GAAkB;GACzD,IAAI,SAAS,SAAS,KAAK,OAAO;EACnC,SAAS,KAAK;GAGb,QAAQ,OAAO,KACd,iCAAiC,OAAO,IAAI,EAAE,EAAE,KAAK,OAAO,IAAI,QAAQ,EAAE,oCAAoC,OAAO,GAAG,GACzH;EACD;EAED,OAAO;CACR;AACD;;;;;;;AAcA,MAAa,gCAAgC,SAIf;CAC7B,MAAM,QAAQ,KAAK,SAAA;CACnB,MAAM,wBAAQ,IAAI,IAAqE;CACvF,OAAO;EACN,UAAU,OAAO,gBAAgB;GAChC,MAAM,MAAM,KAAK,IAAI;GACrB,MAAM,MAAM,MAAM,IAAI,YAAY,KAAK;GACvC,IAAI,OAAO,IAAI,YAAY,KAC1B,OAAO,IAAI;GAEZ,MAAM,WAAW,kBAAkB,KAAK,MAAM,MAAM,KAAK,OAAO,WAAW,CAAC;GAC5E,MAAM,IAAI,YAAY,OAAO;IAAE;IAAU,WAAW,MAAM;GAAM,CAAC;GACjE,OAAO;EACR;EACA,kBAAkB,MAAM,MAAM;CAC/B;AACD"}
@@ -0,0 +1,64 @@
1
+ import { addDaysInTz, startOfCalendarDayInTz } from "../timeframe/tz.js";
2
+ //#region src/query/dates.ts
3
+ /**
4
+ * Range-bound parsing, shared by every surface that takes `from`/`to` from outside: the
5
+ * query endpoint's parser, the document panel endpoint, and the widgets' stored custom
6
+ * range. A leaf module so those cannot drift apart on what a calendar day means.
7
+ */
8
+ /** The only offset-free bound form: a `YYYY-MM-DD` calendar day. */
9
+ const DATE_ONLY = /^\d{4}-\d{2}-\d{2}$/;
10
+ const DATE_TIME = /^(\d{4}-\d{2}-\d{2})T\d{2}:\d{2}(:\d{2}(\.\d{1,9})?)?([Zz]|[+-]\d{2}:\d{2})$/;
11
+ const DAYS_IN_MONTH = [
12
+ 31,
13
+ 28,
14
+ 31,
15
+ 30,
16
+ 31,
17
+ 30,
18
+ 31,
19
+ 31,
20
+ 30,
21
+ 31,
22
+ 30,
23
+ 31
24
+ ];
25
+ const isLeapYear = (year) => year % 4 === 0 && year % 100 !== 0 || year % 400 === 0;
26
+ /** Calendar parts of a `YYYY-MM-DD` string, or null when it names no real day. */
27
+ const calendarParts = (raw) => {
28
+ const year = Number(raw.slice(0, 4));
29
+ const month = Number(raw.slice(5, 7));
30
+ const day = Number(raw.slice(8, 10));
31
+ if (month < 1 || month > 12) return null;
32
+ const lastDay = month === 2 && isLeapYear(year) ? 29 : DAYS_IN_MONTH[month - 1];
33
+ if (lastDay === void 0 || day < 1 || day > lastDay) return null;
34
+ return {
35
+ year,
36
+ month,
37
+ day
38
+ };
39
+ };
40
+ /**
41
+ * A range bound. `YYYY-MM-DD` is the whole calendar day in `timezone`: the start edge is
42
+ * its first instant, the end edge its last, matching the inclusive `end` every adapter
43
+ * reads (`less_than_equal`, `timestamp <=`, GA4's inclusive `endDate`). The only other
44
+ * accepted form is a full datetime carrying `Z` or a `±HH:MM` offset, taken as the instant
45
+ * it names. A datetime without an offset is rejected rather than silently read in the
46
+ * server's own zone, and so are the loose forms `Date` would otherwise accept (`2026`,
47
+ * `Sep 1 2026`).
48
+ */
49
+ const parseDayOrInstant = (raw, args) => {
50
+ if (DATE_ONLY.test(raw)) {
51
+ const ymd = calendarParts(raw);
52
+ if (!ymd) return null;
53
+ const dayStart = startOfCalendarDayInTz(ymd, args.timezone);
54
+ return args.edge === "start" ? dayStart : /* @__PURE__ */ new Date(addDaysInTz(dayStart, 1, args.timezone).getTime() - 1);
55
+ }
56
+ const datePart = DATE_TIME.exec(raw)?.[1];
57
+ if (datePart === void 0 || !calendarParts(datePart)) return null;
58
+ const parsed = new Date(raw);
59
+ return Number.isNaN(parsed.getTime()) ? null : parsed;
60
+ };
61
+ //#endregion
62
+ export { DATE_ONLY, parseDayOrInstant };
63
+
64
+ //# sourceMappingURL=dates.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"dates.js","names":[],"sources":["../../src/query/dates.ts"],"sourcesContent":["import { addDaysInTz, startOfCalendarDayInTz } from '../timeframe/tz'\n\n/**\n * Range-bound parsing, shared by every surface that takes `from`/`to` from outside: the\n * query endpoint's parser, the document panel endpoint, and the widgets' stored custom\n * range. A leaf module so those cannot drift apart on what a calendar day means.\n */\n\n/** The only offset-free bound form: a `YYYY-MM-DD` calendar day. */\nexport const DATE_ONLY = /^\\d{4}-\\d{2}-\\d{2}$/\n\n// Fractional seconds run to nanoseconds because Python emits microseconds; `Date` truncates.\nconst DATE_TIME = /^(\\d{4}-\\d{2}-\\d{2})T\\d{2}:\\d{2}(:\\d{2}(\\.\\d{1,9})?)?([Zz]|[+-]\\d{2}:\\d{2})$/\n\nconst DAYS_IN_MONTH = [31, 28, 31, 30, 31, 30, 31, 31, 30, 31, 30, 31]\n\nconst isLeapYear = (year: number): boolean =>\n\t(year % 4 === 0 && year % 100 !== 0) || year % 400 === 0\n\n/** Calendar parts of a `YYYY-MM-DD` string, or null when it names no real day. */\nconst calendarParts = (raw: string): { year: number; month: number; day: number } | null => {\n\tconst year = Number(raw.slice(0, 4))\n\tconst month = Number(raw.slice(5, 7))\n\tconst day = Number(raw.slice(8, 10))\n\tif (month < 1 || month > 12) {\n\t\treturn null\n\t}\n\tconst lastDay = month === 2 && isLeapYear(year) ? 29 : DAYS_IN_MONTH[month - 1]\n\tif (lastDay === undefined || day < 1 || day > lastDay) {\n\t\treturn null\n\t}\n\treturn { year, month, day }\n}\n\nexport interface BoundArgs {\n\t/** Reporting timezone a day string is read in; ignored for an instant. */\n\ttimezone: string\n\t/** Which end of the window this value bounds. */\n\tedge: 'start' | 'end'\n}\n\n/**\n * A range bound. `YYYY-MM-DD` is the whole calendar day in `timezone`: the start edge is\n * its first instant, the end edge its last, matching the inclusive `end` every adapter\n * reads (`less_than_equal`, `timestamp <=`, GA4's inclusive `endDate`). The only other\n * accepted form is a full datetime carrying `Z` or a `±HH:MM` offset, taken as the instant\n * it names. A datetime without an offset is rejected rather than silently read in the\n * server's own zone, and so are the loose forms `Date` would otherwise accept (`2026`,\n * `Sep 1 2026`).\n */\nexport const parseDayOrInstant = (raw: string, args: BoundArgs): Date | null => {\n\tif (DATE_ONLY.test(raw)) {\n\t\tconst ymd = calendarParts(raw)\n\t\tif (!ymd) {\n\t\t\treturn null\n\t\t}\n\t\tconst dayStart = startOfCalendarDayInTz(ymd, args.timezone)\n\t\treturn args.edge === 'start'\n\t\t\t? dayStart\n\t\t\t: new Date(addDaysInTz(dayStart, 1, args.timezone).getTime() - 1)\n\t}\n\tconst datePart = DATE_TIME.exec(raw)?.[1]\n\tif (datePart === undefined || !calendarParts(datePart)) {\n\t\treturn null\n\t}\n\tconst parsed = new Date(raw)\n\treturn Number.isNaN(parsed.getTime()) ? null : parsed\n}\n"],"mappings":";;;;;;;;AASA,MAAa,YAAY;AAGzB,MAAM,YAAY;AAElB,MAAM,gBAAgB;CAAC;CAAI;CAAI;CAAI;CAAI;CAAI;CAAI;CAAI;CAAI;CAAI;CAAI;CAAI;AAAE;AAErE,MAAM,cAAc,SAClB,OAAO,MAAM,KAAK,OAAO,QAAQ,KAAM,OAAO,QAAQ;;AAGxD,MAAM,iBAAiB,QAAqE;CAC3F,MAAM,OAAO,OAAO,IAAI,MAAM,GAAG,CAAC,CAAC;CACnC,MAAM,QAAQ,OAAO,IAAI,MAAM,GAAG,CAAC,CAAC;CACpC,MAAM,MAAM,OAAO,IAAI,MAAM,GAAG,EAAE,CAAC;CACnC,IAAI,QAAQ,KAAK,QAAQ,IACxB,OAAO;CAER,MAAM,UAAU,UAAU,KAAK,WAAW,IAAI,IAAI,KAAK,cAAc,QAAQ;CAC7E,IAAI,YAAY,KAAA,KAAa,MAAM,KAAK,MAAM,SAC7C,OAAO;CAER,OAAO;EAAE;EAAM;EAAO;CAAI;AAC3B;;;;;;;;;;AAkBA,MAAa,qBAAqB,KAAa,SAAiC;CAC/E,IAAI,UAAU,KAAK,GAAG,GAAG;EACxB,MAAM,MAAM,cAAc,GAAG;EAC7B,IAAI,CAAC,KACJ,OAAO;EAER,MAAM,WAAW,uBAAuB,KAAK,KAAK,QAAQ;EAC1D,OAAO,KAAK,SAAS,UAClB,2BACA,IAAI,KAAK,YAAY,UAAU,GAAG,KAAK,QAAQ,EAAE,QAAQ,IAAI,CAAC;CAClE;CACA,MAAM,WAAW,UAAU,KAAK,GAAG,IAAI;CACvC,IAAI,aAAa,KAAA,KAAa,CAAC,cAAc,QAAQ,GACpD,OAAO;CAER,MAAM,SAAS,IAAI,KAAK,GAAG;CAC3B,OAAO,OAAO,MAAM,OAAO,QAAQ,CAAC,IAAI,OAAO;AAChD"}
@@ -0,0 +1,14 @@
1
+ import { AnalyticsError, AnalyticsErrorCode, analyticsError } from "../plugin/errors.js";
2
+
3
+ //#region src/query/errors.d.ts
4
+ /**
5
+ * The query endpoint's vocabulary, which is the whole plugin's since every endpoint
6
+ * answers in one envelope. Kept under its old name so consumers importing it still
7
+ * compile; new code reads {@link AnalyticsErrorCode}.
8
+ */
9
+ type QueryErrorCode = AnalyticsErrorCode;
10
+ /** Alias of {@link AnalyticsError}, kept for consumers that imported this name. */
11
+ type QueryError = AnalyticsError;
12
+ //#endregion
13
+ export { QueryError, QueryErrorCode };
14
+ //# sourceMappingURL=errors.d.ts.map