@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,10 +1,11 @@
1
+ import { getRuntime, resolveTimezoneFor } from "../plugin/runtime.js";
2
+ import { resolveTimeframe } from "../timeframe/presets.js";
1
3
  import { resolveHostname, resolvePathCached } from "../binding/resolvePath.js";
2
- import { satisfiesCapabilities } from "../core/capabilities.js";
4
+ import { comparisonOf, satisfiesCapabilities } from "../core/capabilities.js";
3
5
  import { supportsGranularity } from "../core/granularity.js";
4
- import { getRuntime, resolveTimezoneFor } from "../plugin/runtime.js";
5
6
  import { resolveReadContext } from "../core/scopedRead.js";
6
- import { resolveTimeframe } from "../timeframe/presets.js";
7
- import { previousWindow } from "../widgets/comparison.js";
7
+ import { goalSlugsFor } from "../plugin/goalHint.js";
8
+ import { previousWindow, withinLookback } from "../widgets/comparison.js";
8
9
  import { fillDailySeries } from "../widgets/readForWidgetSeries.js";
9
10
  //#region src/fields/readForDocument.ts
10
11
  /**
@@ -30,7 +31,7 @@ const readForField = async (args) => {
30
31
  status: "not-bound",
31
32
  adapterId: adapterId ?? "",
32
33
  dateRange,
33
- timezone: "UTC",
34
+ timezone: args.timezone ?? "UTC",
34
35
  ...empty
35
36
  };
36
37
  const binding = runtime.bindings[collectionSlug];
@@ -38,7 +39,7 @@ const readForField = async (args) => {
38
39
  status: "not-bound",
39
40
  adapterId: adapterId ?? "",
40
41
  dateRange,
41
- timezone: "UTC",
42
+ timezone: args.timezone ?? "UTC",
42
43
  ...empty
43
44
  };
44
45
  const ctx = await resolveReadContext({
@@ -51,10 +52,10 @@ const readForField = async (args) => {
51
52
  status: "unavailable",
52
53
  adapterId: adapterId ?? "",
53
54
  dateRange,
54
- timezone: "UTC",
55
+ timezone: args.timezone ?? "UTC",
55
56
  ...empty
56
57
  };
57
- const tz = await resolveTimezoneFor(runtime, req, ctx.scope);
58
+ const tz = args.timezone ?? await resolveTimezoneFor(runtime, req, ctx.scope);
58
59
  dateRange = range ?? resolveTimeframe(timeframe, now, tz);
59
60
  const adapter = ctx.adapter;
60
61
  const bindingCtx = {
@@ -97,13 +98,24 @@ const readForField = async (args) => {
97
98
  droppedMetrics: metrics
98
99
  };
99
100
  const hostname = await resolveHostname(binding, data, bindingCtx);
101
+ const goalSlugs = await goalSlugsFor({
102
+ runtime,
103
+ req,
104
+ scope: ctx.scope,
105
+ metrics: supportedMetrics
106
+ });
100
107
  const base = {
101
108
  path,
102
109
  hostname,
103
110
  timezone: tz,
104
- scope: ctx.queryScope
111
+ scope: ctx.queryScope,
112
+ ...goalSlugs === void 0 ? {} : { goalSlugs }
105
113
  };
106
- const comparisonRange = args.compare && runtime.comparison && adapter.capabilities.comparison ? previousWindow(dateRange, tz) ?? void 0 : void 0;
114
+ const previousRange = args.compare && runtime.comparison && comparisonOf(adapter.capabilities) ? previousWindow(dateRange, tz) : null;
115
+ const comparisonRange = previousRange && withinLookback(previousRange, adapter.capabilities.maxLookbackDays, {
116
+ tz,
117
+ now
118
+ }) ? previousRange : void 0;
107
119
  const wantsSeries = args.series && supportsGranularity(adapter.capabilities, "day");
108
120
  const [result, previous, seriesResult] = await Promise.all([
109
121
  runtime.engine.read(adapter, {
@@ -1 +1 @@
1
- {"version":3,"file":"readForDocument.js","names":[],"sources":["../../src/fields/readForDocument.ts"],"sourcesContent":["import type { PayloadRequest } from 'payload'\nimport { resolveHostname, resolvePathCached } from '../binding/resolvePath'\nimport type { BindingDoc } from '../binding/types'\nimport { satisfiesCapabilities } from '../core/capabilities'\nimport type { AnalyticsAdapter, DateRange, MetricKey } from '../core/contract'\nimport { supportsGranularity } from '../core/granularity'\nimport { resolveReadContext } from '../core/scopedRead'\nimport { getRuntime, resolveTimezoneFor } from '../plugin/runtime'\nimport { resolveTimeframe, type TimeframePreset } from '../timeframe/presets'\nimport { DEFAULT_TIMEZONE } from '../timeframe/tz'\nimport { previousWindow } from '../widgets/comparison'\nimport { fillDailySeries, type SeriesPoint } from '../widgets/readForWidgetSeries'\n\nexport type FieldReadStatus = 'ok' | 'no-path' | 'not-bound' | 'not-configured' | 'unavailable'\n\nexport interface FieldReadResult {\n\tstatus: FieldReadStatus\n\tadapterId: string\n\tdateRange: DateRange\n\t/** The reporting timezone the read resolved in; the trend axis buckets in it. */\n\ttimezone: string\n\tmetrics: Partial<Record<MetricKey, number>>\n\t/** Requested metrics the adapter supports, in request order; the set actually read. */\n\tsupportedMetrics: MetricKey[]\n\t/** Requested metrics the adapter cannot serve, dropped from the read. */\n\tdroppedMetrics: MetricKey[]\n\t/** Previous-window totals, present only when comparison was requested and supported. */\n\tpreviousMetrics?: Partial<Record<MetricKey, number>>\n\t/** The previous comparable window, present only when comparison ran. */\n\tcomparisonRange?: DateRange\n\t/** Per-day series for the first supported metric, present only when requested. */\n\tpoints?: SeriesPoint[]\n}\n\nexport interface ReadForFieldArgs {\n\treq: PayloadRequest\n\tcollectionSlug: string\n\tdata: BindingDoc\n\tmetrics: MetricKey[]\n\ttimeframe: TimeframePreset\n\t/** Overrides the preset window (custom range). */\n\trange?: DateRange\n\tadapterId?: string\n\tnow: Date\n\t/** Explicit scope override; omitted resolves via the plugin's scopeResolver. */\n\tscope?: string | null\n\t/** Also read the previous comparable window when the adapter supports comparison. */\n\tcompare?: boolean\n\t/** Also read a daily series for the first supported metric when the adapter can. */\n\tseries?: boolean\n}\n\n/**\n * Resolve a document's analytics for one display field: look up the runtime, resolve\n * the bound path, capability-gate the requested metrics against the active adapter,\n * then read through the surfacing engine. Returns a discriminated status so the\n * rendering component can show the right empty state without throwing.\n *\n * A metric the adapter does not support is dropped (with one warning per field\n * render), not fatal; `unavailable` is returned only when no requested metric\n * survives or the adapter cannot query per page at all.\n */\nexport const readForField = async (args: ReadForFieldArgs): Promise<FieldReadResult> => {\n\tconst { req, collectionSlug, data, metrics, timeframe, range, adapterId, now } = args\n\tlet dateRange = range ?? resolveTimeframe(timeframe, now)\n\tconst empty = { metrics: {}, supportedMetrics: [], droppedMetrics: [] }\n\tconst runtime = getRuntime(req.payload)\n\tif (!runtime) {\n\t\treturn {\n\t\t\tstatus: 'not-bound',\n\t\t\tadapterId: adapterId ?? '',\n\t\t\tdateRange,\n\t\t\ttimezone: DEFAULT_TIMEZONE,\n\t\t\t...empty,\n\t\t}\n\t}\n\tconst binding = runtime.bindings[collectionSlug]\n\tif (!binding) {\n\t\treturn {\n\t\t\tstatus: 'not-bound',\n\t\t\tadapterId: adapterId ?? '',\n\t\t\tdateRange,\n\t\t\ttimezone: DEFAULT_TIMEZONE,\n\t\t\t...empty,\n\t\t}\n\t}\n\tconst ctx = await resolveReadContext({ runtime, req, adapterId, scope: args.scope })\n\tif (!ctx.ok) {\n\t\treturn {\n\t\t\tstatus: 'unavailable',\n\t\t\tadapterId: adapterId ?? '',\n\t\t\tdateRange,\n\t\t\ttimezone: DEFAULT_TIMEZONE,\n\t\t\t...empty,\n\t\t}\n\t}\n\tconst tz = await resolveTimezoneFor(runtime, req, ctx.scope)\n\tdateRange = range ?? resolveTimeframe(timeframe, now, tz)\n\tconst adapter: AnalyticsAdapter = ctx.adapter\n\tconst bindingCtx = { req, locale: req.locale ?? undefined }\n\tlet path: string | null\n\ttry {\n\t\tpath = await resolvePathCached(binding, data, bindingCtx)\n\t} catch {\n\t\tpath = null\n\t}\n\tif (!path) {\n\t\treturn { status: 'no-path', adapterId: adapter.id, dateRange, timezone: tz, ...empty }\n\t}\n\tif (!adapter.isConfigured()) {\n\t\treturn { status: 'not-configured', adapterId: adapter.id, dateRange, timezone: tz, ...empty }\n\t}\n\tconst supportedMetrics = metrics.filter((m) => adapter.capabilities.metrics.has(m))\n\tconst droppedMetrics = metrics.filter((m) => !adapter.capabilities.metrics.has(m))\n\tif (droppedMetrics.length > 0) {\n\t\treq.payload.logger.warn(\n\t\t\t`analytics: adapter \"${adapter.id}\" does not support metric(s) ${droppedMetrics.join(', ')}; dropped from the \"${collectionSlug}\" display field`\n\t\t)\n\t}\n\tif (\n\t\tsupportedMetrics.length === 0 ||\n\t\t!satisfiesCapabilities(adapter.capabilities, { metrics: supportedMetrics, perPageQuery: true })\n\t) {\n\t\treturn {\n\t\t\tstatus: 'unavailable',\n\t\t\tadapterId: adapter.id,\n\t\t\tdateRange,\n\t\t\ttimezone: tz,\n\t\t\tmetrics: {},\n\t\t\tsupportedMetrics: [],\n\t\t\tdroppedMetrics: metrics,\n\t\t}\n\t}\n\tconst hostname = await resolveHostname(binding, data, bindingCtx)\n\tconst base = { path, hostname, timezone: tz, scope: ctx.queryScope }\n\tconst comparisonRange =\n\t\targs.compare && runtime.comparison && adapter.capabilities.comparison\n\t\t\t? (previousWindow(dateRange, tz) ?? undefined)\n\t\t\t: undefined\n\tconst wantsSeries = args.series && supportsGranularity(adapter.capabilities, 'day')\n\tconst [result, previous, seriesResult] = await Promise.all([\n\t\truntime.engine.read(adapter, { ...base, metrics: supportedMetrics, dateRange }),\n\t\tcomparisonRange\n\t\t\t? runtime.engine.read(adapter, {\n\t\t\t\t\t...base,\n\t\t\t\t\tmetrics: supportedMetrics,\n\t\t\t\t\tdateRange: comparisonRange,\n\t\t\t\t})\n\t\t\t: undefined,\n\t\twantsSeries\n\t\t\t? runtime.engine.read(adapter, {\n\t\t\t\t\t...base,\n\t\t\t\t\tmetrics: [supportedMetrics[0] as MetricKey],\n\t\t\t\t\tdateRange,\n\t\t\t\t\tgranularity: 'day',\n\t\t\t\t})\n\t\t\t: undefined,\n\t])\n\treturn {\n\t\tstatus: 'ok',\n\t\tadapterId: adapter.id,\n\t\tdateRange,\n\t\ttimezone: tz,\n\t\tmetrics: result.totals ?? {},\n\t\tsupportedMetrics,\n\t\tdroppedMetrics,\n\t\tpreviousMetrics: previous ? (previous.totals ?? {}) : undefined,\n\t\tcomparisonRange,\n\t\tpoints: seriesResult\n\t\t\t? fillDailySeries({\n\t\t\t\t\trows: seriesResult.rows,\n\t\t\t\t\tdateRange,\n\t\t\t\t\tmetric: supportedMetrics[0] as MetricKey,\n\t\t\t\t\ttz,\n\t\t\t\t})\n\t\t\t: undefined,\n\t}\n}\n"],"mappings":"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"}
1
+ {"version":3,"file":"readForDocument.js","names":[],"sources":["../../src/fields/readForDocument.ts"],"sourcesContent":["import type { PayloadRequest } from 'payload'\nimport { resolveHostname, resolvePathCached } from '../binding/resolvePath'\nimport type { BindingDoc } from '../binding/types'\nimport { comparisonOf, satisfiesCapabilities } from '../core/capabilities'\nimport type { AnalyticsAdapter, DateRange, MetricKey } from '../core/contract'\nimport { supportsGranularity } from '../core/granularity'\nimport { resolveReadContext } from '../core/scopedRead'\nimport { goalSlugsFor } from '../plugin/goalHint'\nimport { getRuntime, resolveTimezoneFor } from '../plugin/runtime'\nimport { resolveTimeframe, type TimeframePreset } from '../timeframe/presets'\nimport { DEFAULT_TIMEZONE } from '../timeframe/tz'\nimport { previousWindow, withinLookback } from '../widgets/comparison'\nimport { fillDailySeries, type SeriesPoint } from '../widgets/readForWidgetSeries'\n\nexport type FieldReadStatus = 'ok' | 'no-path' | 'not-bound' | 'not-configured' | 'unavailable'\n\nexport interface FieldReadResult {\n\tstatus: FieldReadStatus\n\tadapterId: string\n\tdateRange: DateRange\n\t/** The reporting timezone the read resolved in; the trend axis buckets in it. */\n\ttimezone: string\n\tmetrics: Partial<Record<MetricKey, number>>\n\t/** Requested metrics the adapter supports, in request order; the set actually read. */\n\tsupportedMetrics: MetricKey[]\n\t/** Requested metrics the adapter cannot serve, dropped from the read. */\n\tdroppedMetrics: MetricKey[]\n\t/** Previous-window totals, present only when comparison was requested and supported. */\n\tpreviousMetrics?: Partial<Record<MetricKey, number>>\n\t/** The previous comparable window, present only when comparison ran. */\n\tcomparisonRange?: DateRange\n\t/** Per-day series for the first supported metric, present only when requested. */\n\tpoints?: SeriesPoint[]\n}\n\nexport interface ReadForFieldArgs {\n\treq: PayloadRequest\n\tcollectionSlug: string\n\tdata: BindingDoc\n\tmetrics: MetricKey[]\n\ttimeframe: TimeframePreset\n\t/** Overrides the preset window (custom range). */\n\trange?: DateRange\n\tadapterId?: string\n\tnow: Date\n\t/** Explicit scope override; omitted resolves via the plugin's scopeResolver. */\n\tscope?: string | null\n\t/**\n\t * Reporting timezone the caller already resolved, reused rather than resolved again so\n\t * a caller-supplied `range` is read in the very timezone it was interpreted in.\n\t */\n\ttimezone?: string\n\t/** Also read the previous comparable window when the adapter supports comparison. */\n\tcompare?: boolean\n\t/** Also read a daily series for the first supported metric when the adapter can. */\n\tseries?: boolean\n}\n\n/**\n * Resolve a document's analytics for one display field: look up the runtime, resolve\n * the bound path, capability-gate the requested metrics against the active adapter,\n * then read through the surfacing engine. Returns a discriminated status so the\n * rendering component can show the right empty state without throwing.\n *\n * A metric the adapter does not support is dropped (with one warning per field\n * render), not fatal; `unavailable` is returned only when no requested metric\n * survives or the adapter cannot query per page at all.\n */\nexport const readForField = async (args: ReadForFieldArgs): Promise<FieldReadResult> => {\n\tconst { req, collectionSlug, data, metrics, timeframe, range, adapterId, now } = args\n\tlet dateRange = range ?? resolveTimeframe(timeframe, now)\n\tconst empty = { metrics: {}, supportedMetrics: [], droppedMetrics: [] }\n\tconst runtime = getRuntime(req.payload)\n\tif (!runtime) {\n\t\treturn {\n\t\t\tstatus: 'not-bound',\n\t\t\tadapterId: adapterId ?? '',\n\t\t\tdateRange,\n\t\t\ttimezone: args.timezone ?? DEFAULT_TIMEZONE,\n\t\t\t...empty,\n\t\t}\n\t}\n\tconst binding = runtime.bindings[collectionSlug]\n\tif (!binding) {\n\t\treturn {\n\t\t\tstatus: 'not-bound',\n\t\t\tadapterId: adapterId ?? '',\n\t\t\tdateRange,\n\t\t\ttimezone: args.timezone ?? DEFAULT_TIMEZONE,\n\t\t\t...empty,\n\t\t}\n\t}\n\tconst ctx = await resolveReadContext({ runtime, req, adapterId, scope: args.scope })\n\tif (!ctx.ok) {\n\t\treturn {\n\t\t\tstatus: 'unavailable',\n\t\t\tadapterId: adapterId ?? '',\n\t\t\tdateRange,\n\t\t\ttimezone: args.timezone ?? DEFAULT_TIMEZONE,\n\t\t\t...empty,\n\t\t}\n\t}\n\tconst tz = args.timezone ?? (await resolveTimezoneFor(runtime, req, ctx.scope))\n\tdateRange = range ?? resolveTimeframe(timeframe, now, tz)\n\tconst adapter: AnalyticsAdapter = ctx.adapter\n\tconst bindingCtx = { req, locale: req.locale ?? undefined }\n\tlet path: string | null\n\ttry {\n\t\tpath = await resolvePathCached(binding, data, bindingCtx)\n\t} catch {\n\t\tpath = null\n\t}\n\tif (!path) {\n\t\treturn { status: 'no-path', adapterId: adapter.id, dateRange, timezone: tz, ...empty }\n\t}\n\tif (!adapter.isConfigured()) {\n\t\treturn { status: 'not-configured', adapterId: adapter.id, dateRange, timezone: tz, ...empty }\n\t}\n\tconst supportedMetrics = metrics.filter((m) => adapter.capabilities.metrics.has(m))\n\tconst droppedMetrics = metrics.filter((m) => !adapter.capabilities.metrics.has(m))\n\tif (droppedMetrics.length > 0) {\n\t\treq.payload.logger.warn(\n\t\t\t`analytics: adapter \"${adapter.id}\" does not support metric(s) ${droppedMetrics.join(', ')}; dropped from the \"${collectionSlug}\" display field`\n\t\t)\n\t}\n\tif (\n\t\tsupportedMetrics.length === 0 ||\n\t\t!satisfiesCapabilities(adapter.capabilities, { metrics: supportedMetrics, perPageQuery: true })\n\t) {\n\t\treturn {\n\t\t\tstatus: 'unavailable',\n\t\t\tadapterId: adapter.id,\n\t\t\tdateRange,\n\t\t\ttimezone: tz,\n\t\t\tmetrics: {},\n\t\t\tsupportedMetrics: [],\n\t\t\tdroppedMetrics: metrics,\n\t\t}\n\t}\n\tconst hostname = await resolveHostname(binding, data, bindingCtx)\n\tconst goalSlugs = await goalSlugsFor({\n\t\truntime,\n\t\treq,\n\t\tscope: ctx.scope,\n\t\tmetrics: supportedMetrics,\n\t})\n\tconst base = {\n\t\tpath,\n\t\thostname,\n\t\ttimezone: tz,\n\t\tscope: ctx.queryScope,\n\t\t...(goalSlugs === undefined ? {} : { goalSlugs }),\n\t}\n\tconst previousRange =\n\t\targs.compare && runtime.comparison && comparisonOf(adapter.capabilities)\n\t\t\t? previousWindow(dateRange, tz)\n\t\t\t: null\n\tconst comparisonRange =\n\t\tpreviousRange &&\n\t\twithinLookback(previousRange, adapter.capabilities.maxLookbackDays, { tz, now })\n\t\t\t? previousRange\n\t\t\t: undefined\n\tconst wantsSeries = args.series && supportsGranularity(adapter.capabilities, 'day')\n\tconst [result, previous, seriesResult] = await Promise.all([\n\t\truntime.engine.read(adapter, { ...base, metrics: supportedMetrics, dateRange }),\n\t\tcomparisonRange\n\t\t\t? runtime.engine.read(adapter, {\n\t\t\t\t\t...base,\n\t\t\t\t\tmetrics: supportedMetrics,\n\t\t\t\t\tdateRange: comparisonRange,\n\t\t\t\t})\n\t\t\t: undefined,\n\t\twantsSeries\n\t\t\t? runtime.engine.read(adapter, {\n\t\t\t\t\t...base,\n\t\t\t\t\tmetrics: [supportedMetrics[0] as MetricKey],\n\t\t\t\t\tdateRange,\n\t\t\t\t\tgranularity: 'day',\n\t\t\t\t})\n\t\t\t: undefined,\n\t])\n\treturn {\n\t\tstatus: 'ok',\n\t\tadapterId: adapter.id,\n\t\tdateRange,\n\t\ttimezone: tz,\n\t\tmetrics: result.totals ?? {},\n\t\tsupportedMetrics,\n\t\tdroppedMetrics,\n\t\tpreviousMetrics: previous ? (previous.totals ?? {}) : undefined,\n\t\tcomparisonRange,\n\t\tpoints: seriesResult\n\t\t\t? fillDailySeries({\n\t\t\t\t\trows: seriesResult.rows,\n\t\t\t\t\tdateRange,\n\t\t\t\t\tmetric: supportedMetrics[0] as MetricKey,\n\t\t\t\t\ttz,\n\t\t\t\t})\n\t\t\t: undefined,\n\t}\n}\n"],"mappings":"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"}
@@ -0,0 +1,7 @@
1
+ import { TextFieldClientProps } from "payload";
2
+
3
+ //#region src/goals/GoalSelectField.d.ts
4
+ declare const GoalSelectField: import("react").FC<TextFieldClientProps>;
5
+ //#endregion
6
+ export { GoalSelectField };
7
+ //# sourceMappingURL=GoalSelectField.d.ts.map
@@ -0,0 +1,77 @@
1
+ "use client";
2
+ import { keys } from "../translations/keys.js";
3
+ import { useTranslation as useTranslation$1 } from "../translations/useTranslation.js";
4
+ import { useAnalyticsGoals } from "./useAnalyticsGoals.js";
5
+ import { useMemo } from "react";
6
+ import { Fragment, jsx, jsxs } from "react/jsx-runtime";
7
+ import { FieldDescription, SelectInput, useConfig, useField, withCondition } from "@payloadcms/ui";
8
+ import { mergeFieldStyles } from "@payloadcms/ui/shared";
9
+ //#region src/goals/GoalSelectField.tsx
10
+ /** Admin placeholders are a plain string or a locale map; SelectInput wants one string. */
11
+ const resolvePlaceholder = (placeholder, locale) => typeof placeholder === "string" ? placeholder : placeholder?.[locale] ?? placeholder?.en;
12
+ /**
13
+ * Goal picker for a {@link goalField}: lists the config goals merged with the goals
14
+ * collection for the caller's scope and stores the picked goal's slug. While the fetch is
15
+ * in flight the picker renders with no options rather than a notice, so a slow answer
16
+ * never reads as "this install has no goals". Once it settles, an empty scope and a failed
17
+ * fetch each say so below the input, next to the field's own description rather than in
18
+ * place of it, and the picker stays editable either way so a stored slug can still be
19
+ * cleared.
20
+ */
21
+ const GoalSelectFieldComponent = (props) => {
22
+ const { field, path: pathFromProps, readOnly } = props;
23
+ const { i18n, t } = useTranslation$1();
24
+ const { collection, error, goals } = useAnalyticsGoals();
25
+ const { customComponents: { AfterInput, BeforeInput, Description, Error: ErrorComponent, Label } = {}, disabled, path, setValue, showError, value } = useField({ potentiallyStalePath: pathFromProps });
26
+ const { config: { routes: { admin: adminRoute } } } = useConfig();
27
+ const options = useMemo(() => (goals ?? []).map((goal) => ({
28
+ label: goal.name,
29
+ value: goal.slug
30
+ })), [goals]);
31
+ const style = useMemo(() => mergeFieldStyles(field), [field]);
32
+ const empty = goals !== null && goals.length === 0;
33
+ const manageHref = collection ? `${adminRoute}/collections/${collection.slug}` : null;
34
+ const notice = empty ? /* @__PURE__ */ jsxs("div", {
35
+ className: "field-description",
36
+ children: [t(keys.fieldGoalEmpty), manageHref ? /* @__PURE__ */ jsxs(Fragment, { children: [" ", /* @__PURE__ */ jsx("a", {
37
+ href: manageHref,
38
+ children: t(keys.fieldGoalManage)
39
+ })] }) : null]
40
+ }) : error ? /* @__PURE__ */ jsx("div", {
41
+ className: "field-description",
42
+ children: t(keys.fieldGoalError)
43
+ }) : null;
44
+ return /* @__PURE__ */ jsx(SelectInput, {
45
+ AfterInput,
46
+ BeforeInput,
47
+ className: field.admin?.className,
48
+ Description: notice ? /* @__PURE__ */ jsxs(Fragment, { children: [Description ?? /* @__PURE__ */ jsx(FieldDescription, {
49
+ description: field.admin?.description,
50
+ path
51
+ }), notice] }) : Description,
52
+ description: field.admin?.description,
53
+ Error: ErrorComponent,
54
+ isClearable: !field.required,
55
+ Label,
56
+ label: field.label,
57
+ localized: field.localized,
58
+ name: field.name,
59
+ onChange: (selected) => {
60
+ const option = Array.isArray(selected) ? selected[0] : selected;
61
+ setValue(option?.value ? String(option.value) : null);
62
+ },
63
+ options,
64
+ path,
65
+ placeholder: resolvePlaceholder(field.admin?.placeholder, i18n.language),
66
+ readOnly: readOnly || disabled || field.admin?.readOnly,
67
+ required: field.required,
68
+ showError,
69
+ style,
70
+ value
71
+ });
72
+ };
73
+ const GoalSelectField = withCondition(GoalSelectFieldComponent);
74
+ //#endregion
75
+ export { GoalSelectField };
76
+
77
+ //# sourceMappingURL=GoalSelectField.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"GoalSelectField.js","names":["useTranslation"],"sources":["../../src/goals/GoalSelectField.tsx"],"sourcesContent":["'use client'\n\nimport {\n\tFieldDescription,\n\ttype ReactSelectOption,\n\tSelectInput,\n\tuseConfig,\n\tuseField,\n\twithCondition,\n} from '@payloadcms/ui'\nimport { mergeFieldStyles } from '@payloadcms/ui/shared'\nimport type { TextFieldClientProps } from 'payload'\nimport { useMemo } from 'react'\nimport { keys } from '../translations/keys'\nimport { useTranslation } from '../translations/useTranslation'\nimport { useAnalyticsGoals } from './useAnalyticsGoals'\n\n/** Admin placeholders are a plain string or a locale map; SelectInput wants one string. */\nconst resolvePlaceholder = (\n\tplaceholder: Record<string, string> | string | undefined,\n\tlocale: string\n): string | undefined =>\n\ttypeof placeholder === 'string' ? placeholder : (placeholder?.[locale] ?? placeholder?.en)\n\n/**\n * Goal picker for a {@link goalField}: lists the config goals merged with the goals\n * collection for the caller's scope and stores the picked goal's slug. While the fetch is\n * in flight the picker renders with no options rather than a notice, so a slow answer\n * never reads as \"this install has no goals\". Once it settles, an empty scope and a failed\n * fetch each say so below the input, next to the field's own description rather than in\n * place of it, and the picker stays editable either way so a stored slug can still be\n * cleared.\n */\nconst GoalSelectFieldComponent = (props: TextFieldClientProps) => {\n\tconst { field, path: pathFromProps, readOnly } = props\n\tconst { i18n, t } = useTranslation()\n\tconst { collection, error, goals } = useAnalyticsGoals()\n\tconst {\n\t\tcustomComponents: { AfterInput, BeforeInput, Description, Error: ErrorComponent, Label } = {},\n\t\tdisabled,\n\t\tpath,\n\t\tsetValue,\n\t\tshowError,\n\t\tvalue,\n\t} = useField<string>({ potentiallyStalePath: pathFromProps })\n\tconst {\n\t\tconfig: {\n\t\t\troutes: { admin: adminRoute },\n\t\t},\n\t} = useConfig()\n\n\tconst options = useMemo(\n\t\t() => (goals ?? []).map((goal) => ({ label: goal.name, value: goal.slug })),\n\t\t[goals]\n\t)\n\tconst style = useMemo(() => mergeFieldStyles(field), [field])\n\n\tconst empty = goals !== null && goals.length === 0\n\tconst manageHref = collection ? `${adminRoute}/collections/${collection.slug}` : null\n\tconst notice = empty ? (\n\t\t<div className=\"field-description\">\n\t\t\t{t(keys.fieldGoalEmpty)}\n\t\t\t{manageHref ? (\n\t\t\t\t<>\n\t\t\t\t\t{' '}\n\t\t\t\t\t<a href={manageHref}>{t(keys.fieldGoalManage)}</a>\n\t\t\t\t</>\n\t\t\t) : null}\n\t\t</div>\n\t) : error ? (\n\t\t<div className=\"field-description\">{t(keys.fieldGoalError)}</div>\n\t) : null\n\n\treturn (\n\t\t<SelectInput\n\t\t\tAfterInput={AfterInput}\n\t\t\tBeforeInput={BeforeInput}\n\t\t\tclassName={field.admin?.className}\n\t\t\tDescription={\n\t\t\t\tnotice ? (\n\t\t\t\t\t<>\n\t\t\t\t\t\t{Description ?? <FieldDescription description={field.admin?.description} path={path} />}\n\t\t\t\t\t\t{notice}\n\t\t\t\t\t</>\n\t\t\t\t) : (\n\t\t\t\t\tDescription\n\t\t\t\t)\n\t\t\t}\n\t\t\tdescription={field.admin?.description}\n\t\t\tError={ErrorComponent}\n\t\t\tisClearable={!field.required}\n\t\t\tLabel={Label}\n\t\t\tlabel={field.label}\n\t\t\tlocalized={field.localized}\n\t\t\tname={field.name}\n\t\t\tonChange={(selected: ReactSelectOption | ReactSelectOption[]) => {\n\t\t\t\tconst option = Array.isArray(selected) ? selected[0] : selected\n\t\t\t\tsetValue(option?.value ? String(option.value) : null)\n\t\t\t}}\n\t\t\toptions={options}\n\t\t\tpath={path}\n\t\t\tplaceholder={resolvePlaceholder(field.admin?.placeholder, i18n.language)}\n\t\t\treadOnly={readOnly || disabled || field.admin?.readOnly}\n\t\t\trequired={field.required}\n\t\t\tshowError={showError}\n\t\t\tstyle={style}\n\t\t\tvalue={value}\n\t\t/>\n\t)\n}\n\nexport const GoalSelectField = withCondition(GoalSelectFieldComponent)\n"],"mappings":";;;;;;;;;;AAkBA,MAAM,sBACL,aACA,WAEA,OAAO,gBAAgB,WAAW,cAAe,cAAc,WAAW,aAAa;;;;;;;;;;AAWxF,MAAM,4BAA4B,UAAgC;CACjE,MAAM,EAAE,OAAO,MAAM,eAAe,aAAa;CACjD,MAAM,EAAE,MAAM,MAAMA,iBAAe;CACnC,MAAM,EAAE,YAAY,OAAO,UAAU,kBAAkB;CACvD,MAAM,EACL,kBAAkB,EAAE,YAAY,aAAa,aAAa,OAAO,gBAAgB,UAAU,CAAC,GAC5F,UACA,MACA,UACA,WACA,UACG,SAAiB,EAAE,sBAAsB,cAAc,CAAC;CAC5D,MAAM,EACL,QAAQ,EACP,QAAQ,EAAE,OAAO,mBAEf,UAAU;CAEd,MAAM,UAAU,eACR,SAAS,CAAC,GAAG,KAAK,UAAU;EAAE,OAAO,KAAK;EAAM,OAAO,KAAK;CAAK,EAAE,GAC1E,CAAC,KAAK,CACP;CACA,MAAM,QAAQ,cAAc,iBAAiB,KAAK,GAAG,CAAC,KAAK,CAAC;CAE5D,MAAM,QAAQ,UAAU,QAAQ,MAAM,WAAW;CACjD,MAAM,aAAa,aAAa,GAAG,WAAW,eAAe,WAAW,SAAS;CACjF,MAAM,SAAS,QACd,qBAAC,OAAD;EAAK,WAAU;YAAf,CACE,EAAE,KAAK,cAAc,GACrB,aACA,qBAAA,UAAA,EAAA,UAAA,CACE,KACD,oBAAC,KAAD;GAAG,MAAM;aAAa,EAAE,KAAK,eAAe;EAAK,CAAA,CAChD,EAAA,CAAA,IACC,IACA;MACF,QACH,oBAAC,OAAD;EAAK,WAAU;YAAqB,EAAE,KAAK,cAAc;CAAO,CAAA,IAC7D;CAEJ,OACC,oBAAC,aAAD;EACa;EACC;EACb,WAAW,MAAM,OAAO;EACxB,aACC,SACC,qBAAA,UAAA,EAAA,UAAA,CACE,eAAe,oBAAC,kBAAD;GAAkB,aAAa,MAAM,OAAO;GAAmB;EAAO,CAAA,GACrF,MACA,EAAA,CAAA,IAEF;EAGF,aAAa,MAAM,OAAO;EAC1B,OAAO;EACP,aAAa,CAAC,MAAM;EACb;EACP,OAAO,MAAM;EACb,WAAW,MAAM;EACjB,MAAM,MAAM;EACZ,WAAW,aAAsD;GAChE,MAAM,SAAS,MAAM,QAAQ,QAAQ,IAAI,SAAS,KAAK;GACvD,SAAS,QAAQ,QAAQ,OAAO,OAAO,KAAK,IAAI,IAAI;EACrD;EACS;EACH;EACN,aAAa,mBAAmB,MAAM,OAAO,aAAa,KAAK,QAAQ;EACvE,UAAU,YAAY,YAAY,MAAM,OAAO;EAC/C,UAAU,MAAM;EACL;EACJ;EACA;CACP,CAAA;AAEH;AAEA,MAAa,kBAAkB,cAAc,wBAAwB"}
@@ -0,0 +1,254 @@
1
+ import { docScope } from "../plugin/scopeChange.js";
2
+ import { providerCreateAccess, providerRowAccess } from "../providers/access.js";
3
+ import { stampScope } from "../providers/stampScope.js";
4
+ import { keys } from "../translations/keys.js";
5
+ import { asTranslate, labelForKey } from "../translations/server.js";
6
+ import { validateCurrency } from "./currency.js";
7
+ import { GOAL_SLUG_PATTERN } from "./types.js";
8
+ import { goalScopeWhere } from "./resolver.js";
9
+ import { ValidationError } from "payload";
10
+ //#region src/goals/collection.ts
11
+ const GOALS_SLUG = "analytics-goals";
12
+ const validateSlug = (value, { req }) => typeof value === "string" && GOAL_SLUG_PATTERN.test(value) ? true : asTranslate(req.t)(keys.goalErrorSlug);
13
+ const asScope = (value) => value === null || value === void 0 || value === "" ? null : String(value);
14
+ /**
15
+ * The scope the stamp will land the write in, resolved with stampScope's precedence. Only a
16
+ * platform admin's declared scope is honoured: taking an ordinary tenant's body scope on
17
+ * trust would turn "slug taken" into an oracle for what another tenant owns, since the stamp
18
+ * refuses the write either way.
19
+ */
20
+ const writeScope = async (args, write) => {
21
+ const { data, originalDoc, req } = write;
22
+ try {
23
+ if (await args.platformRead({ req })) return asScope(data?.[args.scopeField]) ?? asScope(originalDoc?.[args.scopeField]);
24
+ return asScope(await args.resolveScope(req));
25
+ } catch {
26
+ return null;
27
+ }
28
+ };
29
+ /**
30
+ * Slugs stay editable, so uniqueness is checked on every write: the same slug may exist once
31
+ * per scope, and the tracker and the rollups key on it. The compound index backs this up
32
+ * where it can, but it cannot cover install-wide rows on Postgres or a host-owned scope field.
33
+ */
34
+ const uniqueSlug = (args) => {
35
+ return async ({ data, originalDoc, req }) => {
36
+ const slug = data?.slug;
37
+ if (typeof slug !== "string" || slug === "") return data;
38
+ const where = [{ slug: { equals: slug } }];
39
+ if (args.scoped) where.push(goalScopeWhere(args.scopeField, await writeScope(args, {
40
+ data,
41
+ originalDoc,
42
+ req
43
+ })));
44
+ const id = originalDoc?.id;
45
+ if (id !== void 0 && id !== null) where.push({ id: { not_equals: id } });
46
+ const { docs } = await req.payload.find({
47
+ collection: args.slug,
48
+ where: { and: where },
49
+ limit: 1,
50
+ pagination: false,
51
+ depth: 0,
52
+ overrideAccess: true,
53
+ req
54
+ });
55
+ if (docs.length > 0) throw new ValidationError({
56
+ collection: args.slug,
57
+ errors: [{
58
+ label: labelForKey(keys.goalFieldSlug),
59
+ message: asTranslate(req.t)(keys.goalErrorSlugTaken),
60
+ path: "slug"
61
+ }]
62
+ });
63
+ return data;
64
+ };
65
+ };
66
+ /**
67
+ * Database-level backstop for the hook, and only where the plugin owns the scope field: a
68
+ * host-owned one (a tenant plugin's relationship) is not ours to index. Postgres treats a
69
+ * NULL scope as distinct from every other, so install-wide rows stay hook-guarded.
70
+ */
71
+ const uniqueSlugIndex = (args) => {
72
+ if (!args.scoped) return {
73
+ fields: ["slug"],
74
+ unique: true
75
+ };
76
+ return args.scopeField === "scope" ? {
77
+ fields: ["slug", "scope"],
78
+ unique: true
79
+ } : void 0;
80
+ };
81
+ /**
82
+ * The plugin's own scope field, and only when `scopeField` still names it: a host-owned
83
+ * field (a tenant plugin's relationship) is the host's to register, and shadowing it with a
84
+ * hidden text field of another name would store the scope twice.
85
+ */
86
+ const scopeField = (args) => args.scopeField === "scope" ? [{
87
+ name: "scope",
88
+ type: "text",
89
+ index: true,
90
+ label: labelForKey(keys.providerFieldScope),
91
+ admin: { hidden: true }
92
+ }] : [];
93
+ const matchField = () => ({
94
+ name: "match",
95
+ type: "group",
96
+ label: labelForKey(keys.goalFieldMatch),
97
+ fields: [
98
+ {
99
+ name: "kind",
100
+ type: "select",
101
+ required: true,
102
+ defaultValue: "goal",
103
+ label: labelForKey(keys.goalFieldMatchKind),
104
+ options: [
105
+ {
106
+ label: labelForKey(keys.goalKindGoal),
107
+ value: "goal"
108
+ },
109
+ {
110
+ label: labelForKey(keys.goalKindEvent),
111
+ value: "event"
112
+ },
113
+ {
114
+ label: labelForKey(keys.goalKindPath),
115
+ value: "path"
116
+ }
117
+ ]
118
+ },
119
+ {
120
+ name: "name",
121
+ type: "text",
122
+ label: labelForKey(keys.goalFieldMatchEventName),
123
+ admin: { condition: (_data, siblingData) => siblingData?.kind === "event" }
124
+ },
125
+ {
126
+ name: "pattern",
127
+ type: "text",
128
+ label: labelForKey(keys.goalFieldMatchPathPattern),
129
+ admin: {
130
+ condition: (_data, siblingData) => siblingData?.kind === "path",
131
+ description: labelForKey(keys.goalFieldMatchPathPatternHelp)
132
+ }
133
+ }
134
+ ]
135
+ });
136
+ const valueField = () => ({
137
+ name: "value",
138
+ type: "group",
139
+ label: labelForKey(keys.goalFieldValue),
140
+ fields: [{
141
+ type: "row",
142
+ fields: [{
143
+ name: "fixed",
144
+ type: "number",
145
+ min: 0,
146
+ label: labelForKey(keys.goalFieldValueFixed),
147
+ admin: { width: "50%" }
148
+ }, {
149
+ name: "prop",
150
+ type: "text",
151
+ label: labelForKey(keys.goalFieldValueProp),
152
+ admin: {
153
+ width: "50%",
154
+ description: labelForKey(keys.goalFieldValuePropHelp)
155
+ }
156
+ }]
157
+ }]
158
+ });
159
+ /**
160
+ * The editor-managed goals collection: one document per goal (and per scope in scoped
161
+ * installs), merged over the config goals by the resolver. Admin-only by default; `access`
162
+ * entries override individual operations and `overrides` reshapes the whole config last,
163
+ * so slugs, labels, fields, and access all stay overridable.
164
+ */
165
+ const buildGoalsCollection = (args) => {
166
+ const unique = uniqueSlugIndex(args);
167
+ const collection = {
168
+ slug: args.slug,
169
+ ...unique ? { indexes: [unique] } : {},
170
+ labels: {
171
+ singular: labelForKey(keys.goalsCollectionSingular),
172
+ plural: labelForKey(keys.goalsCollectionPlural)
173
+ },
174
+ disableDuplicate: true,
175
+ admin: {
176
+ useAsTitle: "name",
177
+ defaultColumns: [
178
+ "name",
179
+ "slug",
180
+ "match.kind",
181
+ "enabled"
182
+ ],
183
+ group: "Analytics"
184
+ },
185
+ access: {
186
+ read: providerRowAccess(args),
187
+ create: providerCreateAccess(args),
188
+ update: providerRowAccess(args),
189
+ delete: providerRowAccess(args),
190
+ ...args.access
191
+ },
192
+ hooks: {
193
+ beforeValidate: [uniqueSlug(args)],
194
+ beforeChange: [stampScope(args)],
195
+ afterChange: [async ({ doc, operation, previousDoc }) => {
196
+ await args.onChange({
197
+ scope: docScope(doc, args.scopeField),
198
+ ...operation === "update" ? { previousScope: docScope(previousDoc, args.scopeField) } : {}
199
+ });
200
+ return doc;
201
+ }],
202
+ afterDelete: [async ({ doc }) => {
203
+ await args.onChange({ scope: docScope(doc, args.scopeField) });
204
+ return doc;
205
+ }]
206
+ },
207
+ fields: [
208
+ {
209
+ name: "name",
210
+ type: "text",
211
+ required: true,
212
+ label: labelForKey(keys.goalFieldName)
213
+ },
214
+ {
215
+ type: "row",
216
+ fields: [{
217
+ name: "slug",
218
+ type: "text",
219
+ required: true,
220
+ index: unique === void 0,
221
+ label: labelForKey(keys.goalFieldSlug),
222
+ validate: validateSlug,
223
+ admin: {
224
+ width: "50%",
225
+ description: labelForKey(keys.goalFieldSlugHelp)
226
+ }
227
+ }, {
228
+ name: "enabled",
229
+ type: "checkbox",
230
+ defaultValue: true,
231
+ label: labelForKey(keys.goalFieldEnabled),
232
+ admin: {
233
+ width: "50%",
234
+ style: { alignSelf: "flex-end" }
235
+ }
236
+ }]
237
+ },
238
+ matchField(),
239
+ valueField(),
240
+ {
241
+ name: "currency",
242
+ type: "text",
243
+ label: labelForKey(keys.goalFieldCurrency),
244
+ validate: validateCurrency
245
+ },
246
+ ...scopeField(args)
247
+ ]
248
+ };
249
+ return args.overrides ? args.overrides(collection) : collection;
250
+ };
251
+ //#endregion
252
+ export { GOALS_SLUG, buildGoalsCollection };
253
+
254
+ //# sourceMappingURL=collection.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"collection.js","names":[],"sources":["../../src/goals/collection.ts"],"sourcesContent":["import type {\n\tCollectionBeforeValidateHook,\n\tCollectionConfig,\n\tCompoundIndex,\n\tField,\n\tPayloadRequest,\n\tTextFieldSingleValidation,\n\tWhere,\n} from 'payload'\nimport { ValidationError } from 'payload'\nimport { docScope, type ScopeChange } from '../plugin/scopeChange'\nimport type { ProviderAccessArgs } from '../providers/access'\nimport { providerCreateAccess, providerRowAccess } from '../providers/access'\nimport { stampScope } from '../providers/stampScope'\nimport { keys } from '../translations/keys'\nimport { asTranslate, labelForKey } from '../translations/server'\nimport { validateCurrency } from './currency'\nimport { goalScopeWhere } from './resolver'\nimport { GOAL_SLUG_PATTERN } from './types'\n\nexport const GOALS_SLUG = 'analytics-goals'\n\nexport interface BuildGoalsCollectionArgs 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 merged\n\t * resolver drops its cached goals and the scope's cached reads are retired.\n\t */\n\tonChange: (change: ScopeChange) => void | Promise<void>\n}\n\nconst validateSlug: TextFieldSingleValidation = (value, { req }) =>\n\ttypeof value === 'string' && GOAL_SLUG_PATTERN.test(value)\n\t\t? true\n\t\t: asTranslate(req.t)(keys.goalErrorSlug)\n\nconst asScope = (value: unknown): string | null =>\n\tvalue === null || value === undefined || value === '' ? null : String(value)\n\n/**\n * The scope the stamp will land the write in, resolved with stampScope's precedence. Only a\n * platform admin's declared scope is honoured: taking an ordinary tenant's body scope on\n * trust would turn \"slug taken\" into an oracle for what another tenant owns, since the stamp\n * refuses the write either way.\n */\nconst writeScope = async (\n\targs: BuildGoalsCollectionArgs,\n\twrite: {\n\t\tdata?: Record<string, unknown>\n\t\toriginalDoc?: Record<string, unknown>\n\t\treq: PayloadRequest\n\t}\n): Promise<string | null> => {\n\tconst { data, originalDoc, req } = write\n\ttry {\n\t\tif (await args.platformRead({ req })) {\n\t\t\t// No declared scope means an install-wide goal, not one in whatever scope the\n\t\t\t// admin's own request happens to resolve to.\n\t\t\treturn asScope(data?.[args.scopeField]) ?? asScope(originalDoc?.[args.scopeField])\n\t\t}\n\t\treturn asScope(await args.resolveScope(req))\n\t} catch {\n\t\treturn null\n\t}\n}\n\n/**\n * Slugs stay editable, so uniqueness is checked on every write: the same slug may exist once\n * per scope, and the tracker and the rollups key on it. The compound index backs this up\n * where it can, but it cannot cover install-wide rows on Postgres or a host-owned scope field.\n */\nconst uniqueSlug = (args: BuildGoalsCollectionArgs): CollectionBeforeValidateHook => {\n\treturn async ({ data, originalDoc, req }) => {\n\t\tconst slug = data?.slug\n\t\tif (typeof slug !== 'string' || slug === '') {\n\t\t\treturn data\n\t\t}\n\t\tconst where: Where[] = [{ slug: { equals: slug } }]\n\t\tif (args.scoped) {\n\t\t\twhere.push(\n\t\t\t\tgoalScopeWhere(args.scopeField, await writeScope(args, { data, originalDoc, req }))\n\t\t\t)\n\t\t}\n\t\tconst id = originalDoc?.id\n\t\tif (id !== undefined && id !== null) {\n\t\t\twhere.push({ id: { not_equals: id } })\n\t\t}\n\t\t// pagination:false is load-bearing: a paginated read fires its count and its find in\n\t\t// parallel on one Mongo session, which the write's open transaction refuses.\n\t\tconst { docs } = await req.payload.find({\n\t\t\tcollection: args.slug as never,\n\t\t\twhere: { and: where },\n\t\t\tlimit: 1,\n\t\t\tpagination: false,\n\t\t\tdepth: 0,\n\t\t\toverrideAccess: true,\n\t\t\treq,\n\t\t})\n\t\tif (docs.length > 0) {\n\t\t\tthrow new ValidationError({\n\t\t\t\tcollection: args.slug,\n\t\t\t\terrors: [\n\t\t\t\t\t{\n\t\t\t\t\t\tlabel: labelForKey(keys.goalFieldSlug),\n\t\t\t\t\t\tmessage: asTranslate(req.t)(keys.goalErrorSlugTaken),\n\t\t\t\t\t\tpath: 'slug',\n\t\t\t\t\t},\n\t\t\t\t],\n\t\t\t})\n\t\t}\n\t\treturn data\n\t}\n}\n\n/**\n * Database-level backstop for the hook, and only where the plugin owns the scope field: a\n * host-owned one (a tenant plugin's relationship) is not ours to index. Postgres treats a\n * NULL scope as distinct from every other, so install-wide rows stay hook-guarded.\n */\nconst uniqueSlugIndex = (args: BuildGoalsCollectionArgs): CompoundIndex | undefined => {\n\tif (!args.scoped) {\n\t\treturn { fields: ['slug'], unique: true }\n\t}\n\treturn args.scopeField === 'scope' ? { fields: ['slug', 'scope'], unique: true } : undefined\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: BuildGoalsCollectionArgs): 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 matchField = (): Field => ({\n\tname: 'match',\n\ttype: 'group',\n\tlabel: labelForKey(keys.goalFieldMatch),\n\tfields: [\n\t\t{\n\t\t\tname: 'kind',\n\t\t\ttype: 'select',\n\t\t\trequired: true,\n\t\t\tdefaultValue: 'goal',\n\t\t\tlabel: labelForKey(keys.goalFieldMatchKind),\n\t\t\toptions: [\n\t\t\t\t{ label: labelForKey(keys.goalKindGoal), value: 'goal' },\n\t\t\t\t{ label: labelForKey(keys.goalKindEvent), value: 'event' },\n\t\t\t\t{ label: labelForKey(keys.goalKindPath), value: 'path' },\n\t\t\t],\n\t\t},\n\t\t{\n\t\t\tname: 'name',\n\t\t\ttype: 'text',\n\t\t\tlabel: labelForKey(keys.goalFieldMatchEventName),\n\t\t\tadmin: { condition: (_data, siblingData) => siblingData?.kind === 'event' },\n\t\t},\n\t\t{\n\t\t\tname: 'pattern',\n\t\t\ttype: 'text',\n\t\t\tlabel: labelForKey(keys.goalFieldMatchPathPattern),\n\t\t\tadmin: {\n\t\t\t\tcondition: (_data, siblingData) => siblingData?.kind === 'path',\n\t\t\t\tdescription: labelForKey(keys.goalFieldMatchPathPatternHelp),\n\t\t\t},\n\t\t},\n\t],\n})\n\nconst valueField = (): Field => ({\n\tname: 'value',\n\ttype: 'group',\n\tlabel: labelForKey(keys.goalFieldValue),\n\tfields: [\n\t\t{\n\t\t\ttype: 'row',\n\t\t\tfields: [\n\t\t\t\t{\n\t\t\t\t\tname: 'fixed',\n\t\t\t\t\ttype: 'number',\n\t\t\t\t\tmin: 0,\n\t\t\t\t\tlabel: labelForKey(keys.goalFieldValueFixed),\n\t\t\t\t\tadmin: { width: '50%' },\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\tname: 'prop',\n\t\t\t\t\ttype: 'text',\n\t\t\t\t\tlabel: labelForKey(keys.goalFieldValueProp),\n\t\t\t\t\tadmin: {\n\t\t\t\t\t\twidth: '50%',\n\t\t\t\t\t\tdescription: labelForKey(keys.goalFieldValuePropHelp),\n\t\t\t\t\t},\n\t\t\t\t},\n\t\t\t],\n\t\t},\n\t],\n})\n\n/**\n * The editor-managed goals collection: one document per goal (and per scope in scoped\n * installs), merged over the config goals by the resolver. Admin-only by default; `access`\n * entries override individual operations and `overrides` reshapes the whole config last,\n * so slugs, labels, fields, and access all stay overridable.\n */\nexport const buildGoalsCollection = (args: BuildGoalsCollectionArgs): CollectionConfig => {\n\tconst unique = uniqueSlugIndex(args)\n\tconst collection: CollectionConfig = {\n\t\tslug: args.slug,\n\t\t...(unique ? { indexes: [unique] } : {}),\n\t\tlabels: {\n\t\t\tsingular: labelForKey(keys.goalsCollectionSingular),\n\t\t\tplural: labelForKey(keys.goalsCollectionPlural),\n\t\t},\n\t\t// A duplicate would carry the slug over, which the uniqueness hook refuses anyway.\n\t\tdisableDuplicate: true,\n\t\tadmin: {\n\t\t\tuseAsTitle: 'name',\n\t\t\tdefaultColumns: ['name', 'slug', 'match.kind', '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\tbeforeValidate: [uniqueSlug(args)],\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.goalFieldName),\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: 'slug',\n\t\t\t\t\t\ttype: 'text',\n\t\t\t\t\t\trequired: true,\n\t\t\t\t\t\t// Mongoose refuses a field index and a compound index that share a key\n\t\t\t\t\t\t// spec, and the compound one already covers a lookup by slug.\n\t\t\t\t\t\tindex: unique === undefined,\n\t\t\t\t\t\tlabel: labelForKey(keys.goalFieldSlug),\n\t\t\t\t\t\tvalidate: validateSlug,\n\t\t\t\t\t\tadmin: {\n\t\t\t\t\t\t\twidth: '50%',\n\t\t\t\t\t\t\tdescription: labelForKey(keys.goalFieldSlugHelp),\n\t\t\t\t\t\t},\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.goalFieldEnabled),\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\tmatchField(),\n\t\t\tvalueField(),\n\t\t\t{\n\t\t\t\tname: 'currency',\n\t\t\t\ttype: 'text',\n\t\t\t\tlabel: labelForKey(keys.goalFieldCurrency),\n\t\t\t\tvalidate: validateCurrency,\n\t\t\t},\n\t\t\t...scopeField(args),\n\t\t],\n\t}\n\treturn args.overrides ? args.overrides(collection) : collection\n}\n"],"mappings":";;;;;;;;;;AAoBA,MAAa,aAAa;AAa1B,MAAM,gBAA2C,OAAO,EAAE,UACzD,OAAO,UAAU,YAAY,kBAAkB,KAAK,KAAK,IACtD,OACA,YAAY,IAAI,CAAC,EAAE,KAAK,aAAa;AAEzC,MAAM,WAAW,UAChB,UAAU,QAAQ,UAAU,KAAA,KAAa,UAAU,KAAK,OAAO,OAAO,KAAK;;;;;;;AAQ5E,MAAM,aAAa,OAClB,MACA,UAK4B;CAC5B,MAAM,EAAE,MAAM,aAAa,QAAQ;CACnC,IAAI;EACH,IAAI,MAAM,KAAK,aAAa,EAAE,IAAI,CAAC,GAGlC,OAAO,QAAQ,OAAO,KAAK,WAAW,KAAK,QAAQ,cAAc,KAAK,WAAW;EAElF,OAAO,QAAQ,MAAM,KAAK,aAAa,GAAG,CAAC;CAC5C,QAAQ;EACP,OAAO;CACR;AACD;;;;;;AAOA,MAAM,cAAc,SAAiE;CACpF,OAAO,OAAO,EAAE,MAAM,aAAa,UAAU;EAC5C,MAAM,OAAO,MAAM;EACnB,IAAI,OAAO,SAAS,YAAY,SAAS,IACxC,OAAO;EAER,MAAM,QAAiB,CAAC,EAAE,MAAM,EAAE,QAAQ,KAAK,EAAE,CAAC;EAClD,IAAI,KAAK,QACR,MAAM,KACL,eAAe,KAAK,YAAY,MAAM,WAAW,MAAM;GAAE;GAAM;GAAa;EAAI,CAAC,CAAC,CACnF;EAED,MAAM,KAAK,aAAa;EACxB,IAAI,OAAO,KAAA,KAAa,OAAO,MAC9B,MAAM,KAAK,EAAE,IAAI,EAAE,YAAY,GAAG,EAAE,CAAC;EAItC,MAAM,EAAE,SAAS,MAAM,IAAI,QAAQ,KAAK;GACvC,YAAY,KAAK;GACjB,OAAO,EAAE,KAAK,MAAM;GACpB,OAAO;GACP,YAAY;GACZ,OAAO;GACP,gBAAgB;GAChB;EACD,CAAC;EACD,IAAI,KAAK,SAAS,GACjB,MAAM,IAAI,gBAAgB;GACzB,YAAY,KAAK;GACjB,QAAQ,CACP;IACC,OAAO,YAAY,KAAK,aAAa;IACrC,SAAS,YAAY,IAAI,CAAC,EAAE,KAAK,kBAAkB;IACnD,MAAM;GACP,CACD;EACD,CAAC;EAEF,OAAO;CACR;AACD;;;;;;AAOA,MAAM,mBAAmB,SAA8D;CACtF,IAAI,CAAC,KAAK,QACT,OAAO;EAAE,QAAQ,CAAC,MAAM;EAAG,QAAQ;CAAK;CAEzC,OAAO,KAAK,eAAe,UAAU;EAAE,QAAQ,CAAC,QAAQ,OAAO;EAAG,QAAQ;CAAK,IAAI,KAAA;AACpF;;;;;;AAOA,MAAM,cAAc,SACnB,KAAK,eAAe,UACjB,CACA;CAEC,MAAM;CACN,MAAM;CACN,OAAO;CACP,OAAO,YAAY,KAAK,kBAAkB;CAC1C,OAAO,EAAE,QAAQ,KAAK;AACvB,CACD,IACC,CAAC;AAEL,MAAM,oBAA2B;CAChC,MAAM;CACN,MAAM;CACN,OAAO,YAAY,KAAK,cAAc;CACtC,QAAQ;EACP;GACC,MAAM;GACN,MAAM;GACN,UAAU;GACV,cAAc;GACd,OAAO,YAAY,KAAK,kBAAkB;GAC1C,SAAS;IACR;KAAE,OAAO,YAAY,KAAK,YAAY;KAAG,OAAO;IAAO;IACvD;KAAE,OAAO,YAAY,KAAK,aAAa;KAAG,OAAO;IAAQ;IACzD;KAAE,OAAO,YAAY,KAAK,YAAY;KAAG,OAAO;IAAO;GACxD;EACD;EACA;GACC,MAAM;GACN,MAAM;GACN,OAAO,YAAY,KAAK,uBAAuB;GAC/C,OAAO,EAAE,YAAY,OAAO,gBAAgB,aAAa,SAAS,QAAQ;EAC3E;EACA;GACC,MAAM;GACN,MAAM;GACN,OAAO,YAAY,KAAK,yBAAyB;GACjD,OAAO;IACN,YAAY,OAAO,gBAAgB,aAAa,SAAS;IACzD,aAAa,YAAY,KAAK,6BAA6B;GAC5D;EACD;CACD;AACD;AAEA,MAAM,oBAA2B;CAChC,MAAM;CACN,MAAM;CACN,OAAO,YAAY,KAAK,cAAc;CACtC,QAAQ,CACP;EACC,MAAM;EACN,QAAQ,CACP;GACC,MAAM;GACN,MAAM;GACN,KAAK;GACL,OAAO,YAAY,KAAK,mBAAmB;GAC3C,OAAO,EAAE,OAAO,MAAM;EACvB,GACA;GACC,MAAM;GACN,MAAM;GACN,OAAO,YAAY,KAAK,kBAAkB;GAC1C,OAAO;IACN,OAAO;IACP,aAAa,YAAY,KAAK,sBAAsB;GACrD;EACD,CACD;CACD,CACD;AACD;;;;;;;AAQA,MAAa,wBAAwB,SAAqD;CACzF,MAAM,SAAS,gBAAgB,IAAI;CACnC,MAAM,aAA+B;EACpC,MAAM,KAAK;EACX,GAAI,SAAS,EAAE,SAAS,CAAC,MAAM,EAAE,IAAI,CAAC;EACtC,QAAQ;GACP,UAAU,YAAY,KAAK,uBAAuB;GAClD,QAAQ,YAAY,KAAK,qBAAqB;EAC/C;EAEA,kBAAkB;EAClB,OAAO;GACN,YAAY;GACZ,gBAAgB;IAAC;IAAQ;IAAQ;IAAc;GAAS;GACxD,OAAO;EACR;EACA,QAAQ;GACP,MAAM,kBAAkB,IAAI;GAC5B,QAAQ,qBAAqB,IAAI;GACjC,QAAQ,kBAAkB,IAAI;GAC9B,QAAQ,kBAAkB,IAAI;GAC9B,GAAG,KAAK;EACT;EACA,OAAO;GACN,gBAAgB,CAAC,WAAW,IAAI,CAAC;GACjC,cAAc,CAAC,WAAW,IAAI,CAAC;GAC/B,aAAa,CACZ,OAAO,EAAE,KAAK,WAAW,kBAAkB;IAC1C,MAAM,KAAK,SAAS;KACnB,OAAO,SAAS,KAAK,KAAK,UAAU;KACpC,GAAI,cAAc,WACf,EAAE,eAAe,SAAS,aAAa,KAAK,UAAU,EAAE,IACxD,CAAC;IACL,CAAC;IACD,OAAO;GACR,CACD;GACA,aAAa,CACZ,OAAO,EAAE,UAAU;IAClB,MAAM,KAAK,SAAS,EAAE,OAAO,SAAS,KAAK,KAAK,UAAU,EAAE,CAAC;IAC7D,OAAO;GACR,CACD;EACD;EACA,QAAQ;GACP;IACC,MAAM;IACN,MAAM;IACN,UAAU;IACV,OAAO,YAAY,KAAK,aAAa;GACtC;GACA;IACC,MAAM;IACN,QAAQ,CACP;KACC,MAAM;KACN,MAAM;KACN,UAAU;KAGV,OAAO,WAAW,KAAA;KAClB,OAAO,YAAY,KAAK,aAAa;KACrC,UAAU;KACV,OAAO;MACN,OAAO;MACP,aAAa,YAAY,KAAK,iBAAiB;KAChD;IACD,GACA;KACC,MAAM;KACN,MAAM;KACN,cAAc;KACd,OAAO,YAAY,KAAK,gBAAgB;KACxC,OAAO;MAAE,OAAO;MAAO,OAAO,EAAE,WAAW,WAAW;KAAE;IACzD,CACD;GACD;GACA,WAAW;GACX,WAAW;GACX;IACC,MAAM;IACN,MAAM;IACN,OAAO,YAAY,KAAK,iBAAiB;IACzC,UAAU;GACX;GACA,GAAG,WAAW,IAAI;EACnB;CACD;CACA,OAAO,KAAK,YAAY,KAAK,UAAU,UAAU,IAAI;AACtD"}
@@ -0,0 +1,14 @@
1
+ import { keys } from "../translations/keys.js";
2
+ import { asTranslate } from "../translations/server.js";
3
+ //#region src/goals/currency.ts
4
+ /** ISO 4217: three uppercase letters. */
5
+ const CURRENCY_PATTERN = /^[A-Z]{3}$/;
6
+ /**
7
+ * Shared by the goals collection and the form-builder goal action so a currency authored in
8
+ * either place is accepted on the same terms. Empty is allowed: the currency is optional.
9
+ */
10
+ const validateCurrency = (value, { req }) => !value || CURRENCY_PATTERN.test(value) ? true : asTranslate(req.t)(keys.goalErrorCurrency);
11
+ //#endregion
12
+ export { validateCurrency };
13
+
14
+ //# sourceMappingURL=currency.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"currency.js","names":[],"sources":["../../src/goals/currency.ts"],"sourcesContent":["import type { TextFieldSingleValidation } from 'payload'\nimport { keys } from '../translations/keys'\nimport { asTranslate } from '../translations/server'\n\n/** ISO 4217: three uppercase letters. */\nexport const CURRENCY_PATTERN = /^[A-Z]{3}$/\n\n/**\n * Shared by the goals collection and the form-builder goal action so a currency authored in\n * either place is accepted on the same terms. Empty is allowed: the currency is optional.\n */\nexport const validateCurrency: TextFieldSingleValidation = (value, { req }) =>\n\t!value || CURRENCY_PATTERN.test(value) ? true : asTranslate(req.t)(keys.goalErrorCurrency)\n"],"mappings":";;;;AAKA,MAAa,mBAAmB;;;;;AAMhC,MAAa,oBAA+C,OAAO,EAAE,UACpE,CAAC,SAAS,iBAAiB,KAAK,KAAK,IAAI,OAAO,YAAY,IAAI,CAAC,EAAE,KAAK,iBAAiB"}
@@ -0,0 +1,18 @@
1
+ import { GoalSource } from "./resolver.js";
2
+
3
+ //#region src/goals/fetchGoals.d.ts
4
+ interface WireGoal {
5
+ slug: string;
6
+ name: string;
7
+ source: GoalSource;
8
+ }
9
+ interface GoalsResponse {
10
+ goals: WireGoal[];
11
+ /** The goals collection, when the install enabled it, so a picker can link to it. */
12
+ collection: {
13
+ slug: string;
14
+ } | null;
15
+ }
16
+ //#endregion
17
+ export { GoalsResponse, WireGoal };
18
+ //# sourceMappingURL=fetchGoals.d.ts.map
@@ -0,0 +1,33 @@
1
+ import { GOALS_PATH } from "../plugin/paths.js";
2
+ import { readResponseError } from "../plugin/errors.js";
3
+ //#region src/goals/fetchGoals.ts
4
+ const cache = /* @__PURE__ */ new Map();
5
+ /**
6
+ * Fetch the caller-scope goal list once per user per admin session and share it between
7
+ * every picker on the page (a document can carry several goal fields). A failed fetch
8
+ * clears its cache entry so a later mount retries instead of pinning the error, and the
9
+ * user id in the key keeps a soft-navigation logout/login from serving the previous
10
+ * user's goals.
11
+ */
12
+ const fetchGoals = (serverURL, apiRoute, userKey) => {
13
+ const url = `${serverURL}${apiRoute}${GOALS_PATH}`;
14
+ const key = `${userKey}:${url}`;
15
+ const hit = cache.get(key);
16
+ if (hit) return hit;
17
+ const pending = fetch(url, { credentials: "include" }).then(async (res) => {
18
+ if (!res.ok) {
19
+ const code = (await readResponseError(res))?.code;
20
+ throw new Error(`analytics: goals ${res.status}${code ? ` ${code}` : ""}`);
21
+ }
22
+ return await res.json();
23
+ }).catch((err) => {
24
+ cache.delete(key);
25
+ throw err;
26
+ });
27
+ cache.set(key, pending);
28
+ return pending;
29
+ };
30
+ //#endregion
31
+ export { fetchGoals };
32
+
33
+ //# sourceMappingURL=fetchGoals.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"fetchGoals.js","names":[],"sources":["../../src/goals/fetchGoals.ts"],"sourcesContent":["import { readResponseError } from '../plugin/errors'\nimport { GOALS_PATH } from '../plugin/paths'\nimport type { GoalSource } from './resolver'\n\nexport interface WireGoal {\n\tslug: string\n\tname: string\n\tsource: GoalSource\n}\n\nexport interface GoalsResponse {\n\tgoals: WireGoal[]\n\t/** The goals collection, when the install enabled it, so a picker can link to it. */\n\tcollection: { slug: string } | null\n}\n\nconst cache = new Map<string, Promise<GoalsResponse>>()\n\n/**\n * Fetch the caller-scope goal list once per user per admin session and share it between\n * every picker on the page (a document can carry several goal fields). A failed fetch\n * clears its cache entry so a later mount retries instead of pinning the error, and the\n * user id in the key keeps a soft-navigation logout/login from serving the previous\n * user's goals.\n */\nexport const fetchGoals = (\n\tserverURL: string,\n\tapiRoute: string,\n\tuserKey: string\n): Promise<GoalsResponse> => {\n\tconst url = `${serverURL}${apiRoute}${GOALS_PATH}`\n\tconst key = `${userKey}:${url}`\n\tconst hit = cache.get(key)\n\tif (hit) return hit\n\tconst pending = fetch(url, { credentials: 'include' })\n\t\t.then(async (res) => {\n\t\t\tif (!res.ok) {\n\t\t\t\t// One failed state covers every refusal the picker can get, so the code rides in\n\t\t\t\t// the message rather than becoming a second state nothing would render.\n\t\t\t\tconst code = (await readResponseError(res))?.code\n\t\t\t\tthrow new Error(`analytics: goals ${res.status}${code ? ` ${code}` : ''}`)\n\t\t\t}\n\t\t\treturn (await res.json()) as GoalsResponse\n\t\t})\n\t\t.catch((err) => {\n\t\t\tcache.delete(key)\n\t\t\tthrow err\n\t\t})\n\tcache.set(key, pending)\n\treturn pending\n}\n"],"mappings":";;;AAgBA,MAAM,wBAAQ,IAAI,IAAoC;;;;;;;;AAStD,MAAa,cACZ,WACA,UACA,YAC4B;CAC5B,MAAM,MAAM,GAAG,YAAY,WAAW;CACtC,MAAM,MAAM,GAAG,QAAQ,GAAG;CAC1B,MAAM,MAAM,MAAM,IAAI,GAAG;CACzB,IAAI,KAAK,OAAO;CAChB,MAAM,UAAU,MAAM,KAAK,EAAE,aAAa,UAAU,CAAC,EACnD,KAAK,OAAO,QAAQ;EACpB,IAAI,CAAC,IAAI,IAAI;GAGZ,MAAM,QAAQ,MAAM,kBAAkB,GAAG,IAAI;GAC7C,MAAM,IAAI,MAAM,oBAAoB,IAAI,SAAS,OAAO,IAAI,SAAS,IAAI;EAC1E;EACA,OAAQ,MAAM,IAAI,KAAK;CACxB,CAAC,EACA,OAAO,QAAQ;EACf,MAAM,OAAO,GAAG;EAChB,MAAM;CACP,CAAC;CACF,MAAM,IAAI,KAAK,OAAO;CACtB,OAAO;AACR"}
@@ -0,0 +1,31 @@
1
+ import { LabelFunction, StaticLabel, TextField } from "payload";
2
+
3
+ //#region src/goals/goalField.d.ts
4
+ interface GoalFieldOptions {
5
+ /** Field name, and therefore the property the slug is stored under. Default `'goal'`. */
6
+ name?: string;
7
+ /** Default: the translated "Goal". */
8
+ label?: LabelFunction | StaticLabel;
9
+ required?: boolean;
10
+ /** Merged over the factory's own admin config; the Field component is not replaceable here. */
11
+ admin?: TextField['admin'];
12
+ /** Last word on the built field. Spread the field, never deep-merge it. */
13
+ overrides?: (args: {
14
+ field: TextField;
15
+ }) => TextField;
16
+ }
17
+ /**
18
+ * A goal picker for any collection or global: a text field storing the goal slug, rendered
19
+ * by the client picker that lists the config goals merged with the goals collection for the
20
+ * requesting scope. Pair it with {@link goalSlug} wherever the stored value is read back.
21
+ */
22
+ declare const goalField: (options?: GoalFieldOptions) => TextField;
23
+ /**
24
+ * The slug out of a stored goal value, for renderers that read a {@link goalField} back.
25
+ * Accepts the stored string and the `{ slug }` shape a populated document carries; anything
26
+ * else is not a goal reference and resolves to null rather than a guess.
27
+ */
28
+ declare const goalSlug: (value: unknown) => string | null;
29
+ //#endregion
30
+ export { GoalFieldOptions, goalField, goalSlug };
31
+ //# sourceMappingURL=goalField.d.ts.map