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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (515) hide show
  1. package/CHANGELOG.md +270 -0
  2. package/LICENSE +21 -21
  3. package/README.md +15 -4
  4. package/dist/adapters/ga4/disableKey.d.ts +9 -0
  5. package/dist/adapters/ga4/disableKey.js +21 -0
  6. package/dist/adapters/ga4/disableKey.js.map +1 -0
  7. package/dist/adapters/ga4/eventName.d.ts +15 -0
  8. package/dist/adapters/ga4/eventName.js +19 -0
  9. package/dist/adapters/ga4/eventName.js.map +1 -0
  10. package/dist/adapters/ga4/ga4.d.ts +5 -0
  11. package/dist/adapters/ga4/ga4.js +186 -58
  12. package/dist/adapters/ga4/ga4.js.map +1 -1
  13. package/dist/adapters/ga4/measurementId.js +15 -0
  14. package/dist/adapters/ga4/measurementId.js.map +1 -0
  15. package/dist/adapters/goalRead.js +126 -0
  16. package/dist/adapters/goalRead.js.map +1 -0
  17. package/dist/adapters/http/fetchJson.js +1 -1
  18. package/dist/adapters/plausible/plausible.d.ts +25 -0
  19. package/dist/adapters/plausible/plausible.js +159 -38
  20. package/dist/adapters/plausible/plausible.js.map +1 -1
  21. package/dist/adapters/posthog/posthog.d.ts +10 -1
  22. package/dist/adapters/posthog/posthog.js +130 -21
  23. package/dist/adapters/posthog/posthog.js.map +1 -1
  24. package/dist/adapters/series.js +11 -1
  25. package/dist/adapters/series.js.map +1 -1
  26. package/dist/adapters/umami/umami.d.ts +13 -1
  27. package/dist/adapters/umami/umami.js +278 -26
  28. package/dist/adapters/umami/umami.js.map +1 -1
  29. package/dist/binding/resolvePath.js +18 -2
  30. package/dist/binding/resolvePath.js.map +1 -1
  31. package/dist/capture/getTrackerConfig.d.ts +20 -0
  32. package/dist/capture/getTrackerConfig.js +31 -0
  33. package/dist/capture/getTrackerConfig.js.map +1 -0
  34. package/dist/capture/mountPath.js +14 -0
  35. package/dist/capture/mountPath.js.map +1 -0
  36. package/dist/capture/proxyEndpoint.js +127 -0
  37. package/dist/capture/proxyEndpoint.js.map +1 -0
  38. package/dist/capture/proxyRoutes.js +108 -0
  39. package/dist/capture/proxyRoutes.js.map +1 -0
  40. package/dist/capture/requestBody.js +68 -0
  41. package/dist/capture/requestBody.js.map +1 -0
  42. package/dist/capture/slots.d.ts +8 -0
  43. package/dist/capture/slots.js +54 -0
  44. package/dist/capture/slots.js.map +1 -0
  45. package/dist/capture/trackerConfig.d.ts +33 -0
  46. package/dist/capture/trackerConfig.js +95 -0
  47. package/dist/capture/trackerConfig.js.map +1 -0
  48. package/dist/capture/trackerEndpoint.js +35 -0
  49. package/dist/capture/trackerEndpoint.js.map +1 -0
  50. package/dist/charts/BarList.d.ts +16 -1
  51. package/dist/charts/BarList.js +41 -19
  52. package/dist/charts/BarList.js.map +1 -1
  53. package/dist/charts/TrendChart.d.ts +16 -3
  54. package/dist/charts/TrendChart.js +172 -106
  55. package/dist/charts/TrendChart.js.map +1 -1
  56. package/dist/charts/bars.d.ts +4 -0
  57. package/dist/charts/bars.js +3 -1
  58. package/dist/charts/bars.js.map +1 -1
  59. package/dist/charts/bucket.js +10 -1
  60. package/dist/charts/bucket.js.map +1 -1
  61. package/dist/charts/spline.js +2 -2
  62. package/dist/charts/spline.js.map +1 -1
  63. package/dist/charts/styles.js +18 -1
  64. package/dist/charts/styles.js.map +1 -1
  65. package/dist/core/cacheKey.js +26 -3
  66. package/dist/core/cacheKey.js.map +1 -1
  67. package/dist/core/capabilities.d.ts +5 -1
  68. package/dist/core/capabilities.js +11 -2
  69. package/dist/core/capabilities.js.map +1 -1
  70. package/dist/core/capture.d.ts +49 -0
  71. package/dist/core/contract.d.ts +74 -5
  72. package/dist/core/contract.js +30 -1
  73. package/dist/core/contract.js.map +1 -1
  74. package/dist/core/granularity.js +1 -1
  75. package/dist/core/options.d.ts +164 -6
  76. package/dist/core/options.js +126 -3
  77. package/dist/core/options.js.map +1 -1
  78. package/dist/core/registry.d.ts +1 -0
  79. package/dist/core/scopeList.js +32 -0
  80. package/dist/core/scopeList.js.map +1 -0
  81. package/dist/core/scopedRead.js +101 -30
  82. package/dist/core/scopedRead.js.map +1 -1
  83. package/dist/core/serverEvent.d.ts +60 -0
  84. package/dist/core/serverEvent.js +12 -0
  85. package/dist/core/serverEvent.js.map +1 -0
  86. package/dist/exports/adapters/ga4.d.ts +2 -1
  87. package/dist/exports/adapters/ga4.js +2 -1
  88. package/dist/exports/adapters/native.d.ts +3 -1
  89. package/dist/exports/adapters/native.js +2 -1
  90. package/dist/exports/client.d.ts +13 -3
  91. package/dist/exports/client.js +10 -1
  92. package/dist/exports/geo.d.ts +2 -2
  93. package/dist/exports/next.d.ts +2 -1
  94. package/dist/exports/next.js +2 -1
  95. package/dist/exports/react.d.ts +4 -0
  96. package/dist/exports/react.js +5 -0
  97. package/dist/exports/rsc.d.ts +11 -3
  98. package/dist/exports/rsc.js +7 -2
  99. package/dist/exports/tracker.d.ts +21 -0
  100. package/dist/exports/tracker.js +15 -0
  101. package/dist/exports/types.d.ts +16 -3
  102. package/dist/exports/types.js +4 -2
  103. package/dist/fields/AnalyticsPanelClient.js +2 -2
  104. package/dist/fields/AnalyticsPanelField.js +1 -1
  105. package/dist/fields/AnalyticsStatField.js +2 -2
  106. package/dist/fields/config/FilterDimensionSelectField.d.ts +14 -0
  107. package/dist/fields/config/FilterDimensionSelectField.js +77 -0
  108. package/dist/fields/config/FilterDimensionSelectField.js.map +1 -0
  109. package/dist/fields/config/FilterOperatorSelectField.d.ts +14 -0
  110. package/dist/fields/config/FilterOperatorSelectField.js +75 -0
  111. package/dist/fields/config/FilterOperatorSelectField.js.map +1 -0
  112. package/dist/fields/config/MetricSelectField.js +3 -3
  113. package/dist/fields/config/MetricSelectField.js.map +1 -1
  114. package/dist/fields/config/SourceSelectField.js +3 -3
  115. package/dist/fields/config/SourceSelectField.js.map +1 -1
  116. package/dist/fields/config/fetchSources.d.ts +5 -1
  117. package/dist/fields/config/fetchSources.js +7 -3
  118. package/dist/fields/config/fetchSources.js.map +1 -1
  119. package/dist/fields/config/narrow.js +2 -0
  120. package/dist/fields/config/narrow.js.map +1 -1
  121. package/dist/fields/config/sourcesState.js +19 -3
  122. package/dist/fields/config/sourcesState.js.map +1 -1
  123. package/dist/fields/config/useAnalyticsSources.d.ts +8 -3
  124. package/dist/fields/config/useAnalyticsSources.js +9 -6
  125. package/dist/fields/config/useAnalyticsSources.js.map +1 -1
  126. package/dist/fields/config/useFilterCapabilities.d.ts +28 -0
  127. package/dist/fields/config/useFilterCapabilities.js +52 -0
  128. package/dist/fields/config/useFilterCapabilities.js.map +1 -0
  129. package/dist/fields/readForDocument.d.ts +5 -0
  130. package/dist/fields/readForDocument.js +22 -10
  131. package/dist/fields/readForDocument.js.map +1 -1
  132. package/dist/goals/GoalSelectField.d.ts +7 -0
  133. package/dist/goals/GoalSelectField.js +77 -0
  134. package/dist/goals/GoalSelectField.js.map +1 -0
  135. package/dist/goals/collection.js +254 -0
  136. package/dist/goals/collection.js.map +1 -0
  137. package/dist/goals/currency.js +14 -0
  138. package/dist/goals/currency.js.map +1 -0
  139. package/dist/goals/fetchGoals.d.ts +18 -0
  140. package/dist/goals/fetchGoals.js +33 -0
  141. package/dist/goals/fetchGoals.js.map +1 -0
  142. package/dist/goals/goalField.d.ts +31 -0
  143. package/dist/goals/goalField.js +56 -0
  144. package/dist/goals/goalField.js.map +1 -0
  145. package/dist/goals/goalsEndpoint.d.ts +1 -0
  146. package/dist/goals/goalsEndpoint.js +58 -0
  147. package/dist/goals/goalsEndpoint.js.map +1 -0
  148. package/dist/goals/match.js +64 -0
  149. package/dist/goals/match.js.map +1 -0
  150. package/dist/goals/resolver.d.ts +8 -0
  151. package/dist/goals/resolver.js +147 -0
  152. package/dist/goals/resolver.js.map +1 -0
  153. package/dist/goals/trackGoalAction.d.ts +76 -0
  154. package/dist/goals/trackGoalAction.js +158 -0
  155. package/dist/goals/trackGoalAction.js.map +1 -0
  156. package/dist/goals/types.d.ts +33 -0
  157. package/dist/goals/types.js +7 -0
  158. package/dist/goals/types.js.map +1 -0
  159. package/dist/goals/useAnalyticsGoals.d.ts +20 -0
  160. package/dist/goals/useAnalyticsGoals.js +67 -0
  161. package/dist/goals/useAnalyticsGoals.js.map +1 -0
  162. package/dist/index.d.ts +14 -3
  163. package/dist/index.js +174 -19
  164. package/dist/index.js.map +1 -1
  165. package/dist/native/collections/events.js +65 -1
  166. package/dist/native/collections/events.js.map +1 -1
  167. package/dist/native/collections/rollups.js +39 -3
  168. package/dist/native/collections/rollups.js.map +1 -1
  169. package/dist/native/eventScan.js +25 -0
  170. package/dist/native/eventScan.js.map +1 -0
  171. package/dist/native/geo/composeGeoResolvers.js +2 -2
  172. package/dist/native/geo/composeGeoResolvers.js.map +1 -1
  173. package/dist/native/geo/geoResolver.d.ts +9 -2
  174. package/dist/native/geo/geoResolver.js.map +1 -1
  175. package/dist/native/geo/maxmindResolver.js +3 -5
  176. package/dist/native/geo/maxmindResolver.js.map +1 -1
  177. package/dist/native/ingest/bots.d.ts +11 -0
  178. package/dist/native/ingest/bots.js +71 -0
  179. package/dist/native/ingest/bots.js.map +1 -0
  180. package/dist/native/ingest/browser.js +47 -0
  181. package/dist/native/ingest/browser.js.map +1 -0
  182. package/dist/native/ingest/clientIp.js +20 -0
  183. package/dist/native/ingest/clientIp.js.map +1 -0
  184. package/dist/native/ingest/device.js +11 -3
  185. package/dist/native/ingest/device.js.map +1 -1
  186. package/dist/native/ingest/endpoint.d.ts +1 -0
  187. package/dist/native/ingest/endpoint.js +107 -21
  188. package/dist/native/ingest/endpoint.js.map +1 -1
  189. package/dist/native/ingest/flushBatch.js +29 -38
  190. package/dist/native/ingest/flushBatch.js.map +1 -1
  191. package/dist/native/ingest/language.js +14 -0
  192. package/dist/native/ingest/language.js.map +1 -0
  193. package/dist/native/ingest/normalizeEvent.d.ts +30 -0
  194. package/dist/native/ingest/normalizeEvent.js +115 -16
  195. package/dist/native/ingest/normalizeEvent.js.map +1 -1
  196. package/dist/native/ingest/referrer.js +48 -0
  197. package/dist/native/ingest/referrer.js.map +1 -0
  198. package/dist/native/ingest/requestHost.js +57 -0
  199. package/dist/native/ingest/requestHost.js.map +1 -0
  200. package/dist/native/ingest/resolveHostname.d.ts +29 -0
  201. package/dist/native/ingest/resolveHostname.js +52 -0
  202. package/dist/native/ingest/resolveHostname.js.map +1 -0
  203. package/dist/native/ingest/salt.js +27 -2
  204. package/dist/native/ingest/salt.js.map +1 -1
  205. package/dist/native/ingest/serverTrack.d.ts +20 -0
  206. package/dist/native/ingest/serverTrack.js +109 -0
  207. package/dist/native/ingest/serverTrack.js.map +1 -0
  208. package/dist/native/ingest/source.d.ts +11 -0
  209. package/dist/native/ingest/source.js +264 -16
  210. package/dist/native/ingest/source.js.map +1 -1
  211. package/dist/native/ingest/utm.js +33 -0
  212. package/dist/native/ingest/utm.js.map +1 -0
  213. package/dist/native/ingest/validate.js +26 -0
  214. package/dist/native/ingest/validate.js.map +1 -0
  215. package/dist/native/nativeAdapter.d.ts +37 -1
  216. package/dist/native/nativeAdapter.js +175 -22
  217. package/dist/native/nativeAdapter.js.map +1 -1
  218. package/dist/native/query/eventAgg.js +175 -0
  219. package/dist/native/query/eventAgg.js.map +1 -0
  220. package/dist/native/retention/pruneTask.js +53 -13
  221. package/dist/native/retention/pruneTask.js.map +1 -1
  222. package/dist/native/rollupAcc.js +12 -1
  223. package/dist/native/rollupAcc.js.map +1 -1
  224. package/dist/native/rollups/bucketKey.js +15 -0
  225. package/dist/native/rollups/bucketKey.js.map +1 -0
  226. package/dist/native/rollups/bumpRollups.js +116 -0
  227. package/dist/native/rollups/bumpRollups.js.map +1 -0
  228. package/dist/native/rollups/deltas.js +86 -11
  229. package/dist/native/rollups/deltas.js.map +1 -1
  230. package/dist/native/rollups/insertManyIfNew.js +93 -0
  231. package/dist/native/rollups/insertManyIfNew.js.map +1 -0
  232. package/dist/next/captureRewrites.d.ts +42 -0
  233. package/dist/next/captureRewrites.js +57 -0
  234. package/dist/next/captureRewrites.js.map +1 -0
  235. package/dist/next/posthogProxyRewrites.d.ts +5 -0
  236. package/dist/next/posthogProxyRewrites.js +16 -21
  237. package/dist/next/posthogProxyRewrites.js.map +1 -1
  238. package/dist/plugin/documentEndpoint.js +71 -24
  239. package/dist/plugin/documentEndpoint.js.map +1 -1
  240. package/dist/plugin/errors.d.ts +31 -0
  241. package/dist/plugin/errors.js +79 -0
  242. package/dist/plugin/errors.js.map +1 -0
  243. package/dist/plugin/goalHint.d.ts +1 -0
  244. package/dist/plugin/goalHint.js +24 -0
  245. package/dist/plugin/goalHint.js.map +1 -0
  246. package/dist/plugin/paths.js +17 -1
  247. package/dist/plugin/paths.js.map +1 -1
  248. package/dist/plugin/queryEndpoint.js +124 -0
  249. package/dist/plugin/queryEndpoint.js.map +1 -0
  250. package/dist/plugin/readContextForRequest.js +73 -0
  251. package/dist/plugin/readContextForRequest.js.map +1 -0
  252. package/dist/plugin/realtimeEndpoint.js +37 -16
  253. package/dist/plugin/realtimeEndpoint.js.map +1 -1
  254. package/dist/plugin/refreshEndpoint.js +113 -0
  255. package/dist/plugin/refreshEndpoint.js.map +1 -0
  256. package/dist/plugin/runtime.d.ts +1 -0
  257. package/dist/plugin/runtime.js +33 -1
  258. package/dist/plugin/runtime.js.map +1 -1
  259. package/dist/plugin/scopeChange.js +22 -0
  260. package/dist/plugin/scopeChange.js.map +1 -0
  261. package/dist/plugin/scopeFieldBoot.js +22 -0
  262. package/dist/plugin/scopeFieldBoot.js.map +1 -0
  263. package/dist/plugin/sourcesEndpoint.js +16 -41
  264. package/dist/plugin/sourcesEndpoint.js.map +1 -1
  265. package/dist/plugin/warmTask.js +0 -0
  266. package/dist/plugin/warmTask.js.map +1 -1
  267. package/dist/providers/collection.js +89 -29
  268. package/dist/providers/collection.js.map +1 -1
  269. package/dist/providers/factory.js +11 -3
  270. package/dist/providers/factory.js.map +1 -1
  271. package/dist/providers/resolver.js.map +1 -1
  272. package/dist/query/dates.js +64 -0
  273. package/dist/query/dates.js.map +1 -0
  274. package/dist/query/errors.d.ts +14 -0
  275. package/dist/query/fetchQuery.d.ts +79 -0
  276. package/dist/query/fetchQuery.js +117 -0
  277. package/dist/query/fetchQuery.js.map +1 -0
  278. package/dist/query/parse.d.ts +22 -0
  279. package/dist/query/parse.js +168 -0
  280. package/dist/query/parse.js.map +1 -0
  281. package/dist/query/response.d.ts +39 -0
  282. package/dist/query/response.js +11 -0
  283. package/dist/query/response.js.map +1 -0
  284. package/dist/react/AnalyticsProvider.d.ts +50 -0
  285. package/dist/react/AnalyticsProvider.js +67 -0
  286. package/dist/react/AnalyticsProvider.js.map +1 -0
  287. package/dist/react/TrackerBoot.d.ts +22 -0
  288. package/dist/react/TrackerBoot.js +30 -0
  289. package/dist/react/TrackerBoot.js.map +1 -0
  290. package/dist/react/useAnalytics.d.ts +20 -0
  291. package/dist/react/useAnalytics.js +52 -0
  292. package/dist/react/useAnalytics.js.map +1 -0
  293. package/dist/rsc/AnalyticsScripts.d.ts +30 -0
  294. package/dist/rsc/AnalyticsScripts.js +41 -0
  295. package/dist/rsc/AnalyticsScripts.js.map +1 -0
  296. package/dist/surfacing/cacheStore.d.ts +1 -0
  297. package/dist/surfacing/cacheStore.js +18 -2
  298. package/dist/surfacing/cacheStore.js.map +1 -1
  299. package/dist/surfacing/engine.d.ts +1 -0
  300. package/dist/surfacing/engine.js +47 -6
  301. package/dist/surfacing/engine.js.map +1 -1
  302. package/dist/surfacing/epoch.d.ts +1 -0
  303. package/dist/surfacing/epoch.js +72 -0
  304. package/dist/surfacing/epoch.js.map +1 -0
  305. package/dist/surfacing/queue.js +22 -6
  306. package/dist/surfacing/queue.js.map +1 -1
  307. package/dist/surfacing/rateLimiter.js +130 -0
  308. package/dist/surfacing/rateLimiter.js.map +1 -0
  309. package/dist/surfacing/retryPolicy.js +15 -0
  310. package/dist/surfacing/retryPolicy.js.map +1 -0
  311. package/dist/sync/collection.js +23 -7
  312. package/dist/sync/collection.js.map +1 -1
  313. package/dist/sync/syncTask.js +68 -33
  314. package/dist/sync/syncTask.js.map +1 -1
  315. package/dist/testing/memoryAdapter.d.ts +2 -0
  316. package/dist/testing/memoryAdapter.js +17 -1
  317. package/dist/testing/memoryAdapter.js.map +1 -1
  318. package/dist/timeframe/tz.js +17 -6
  319. package/dist/timeframe/tz.js.map +1 -1
  320. package/dist/tracker/autoCapture.d.ts +48 -0
  321. package/dist/tracker/autoCapture.js +129 -0
  322. package/dist/tracker/autoCapture.js.map +1 -0
  323. package/dist/tracker/consent.d.ts +24 -0
  324. package/dist/tracker/consent.js +48 -0
  325. package/dist/tracker/consent.js.map +1 -0
  326. package/dist/tracker/createTracker.d.ts +18 -0
  327. package/dist/tracker/createTracker.js +215 -0
  328. package/dist/tracker/createTracker.js.map +1 -0
  329. package/dist/tracker/exclusion.d.ts +28 -0
  330. package/dist/tracker/exclusion.js +50 -0
  331. package/dist/tracker/exclusion.js.map +1 -0
  332. package/dist/tracker/initTracker.d.ts +22 -0
  333. package/dist/tracker/initTracker.js +33 -0
  334. package/dist/tracker/initTracker.js.map +1 -0
  335. package/dist/tracker/loadScript.d.ts +14 -0
  336. package/dist/tracker/loadScript.js +41 -0
  337. package/dist/tracker/loadScript.js.map +1 -0
  338. package/dist/tracker/pageTracking.d.ts +17 -0
  339. package/dist/tracker/pageTracking.js +38 -0
  340. package/dist/tracker/pageTracking.js.map +1 -0
  341. package/dist/tracker/registry.d.ts +27 -0
  342. package/dist/tracker/registry.js +73 -0
  343. package/dist/tracker/registry.js.map +1 -0
  344. package/dist/tracker/sinks/ga4.d.ts +29 -0
  345. package/dist/tracker/sinks/ga4.js +30 -0
  346. package/dist/tracker/sinks/ga4.js.map +1 -0
  347. package/dist/tracker/sinks/native.d.ts +22 -0
  348. package/dist/tracker/sinks/native.js +56 -0
  349. package/dist/tracker/sinks/native.js.map +1 -0
  350. package/dist/tracker/sinks/plausible.d.ts +20 -0
  351. package/dist/tracker/sinks/plausible.js +32 -0
  352. package/dist/tracker/sinks/plausible.js.map +1 -0
  353. package/dist/tracker/sinks/posthog.d.ts +18 -0
  354. package/dist/tracker/sinks/posthog.js +30 -0
  355. package/dist/tracker/sinks/posthog.js.map +1 -0
  356. package/dist/tracker/sinks/umami.d.ts +18 -0
  357. package/dist/tracker/sinks/umami.js +23 -0
  358. package/dist/tracker/sinks/umami.js.map +1 -0
  359. package/dist/tracker/sinks/vendor.d.ts +14 -0
  360. package/dist/tracker/sinks/vendor.js +81 -0
  361. package/dist/tracker/sinks/vendor.js.map +1 -0
  362. package/dist/tracker/transport.js +28 -0
  363. package/dist/tracker/transport.js.map +1 -0
  364. package/dist/tracker/types.d.ts +91 -0
  365. package/dist/translations/ar.js +221 -0
  366. package/dist/translations/ar.js.map +1 -0
  367. package/dist/translations/de.js +145 -1
  368. package/dist/translations/de.js.map +1 -1
  369. package/dist/translations/en.js +145 -1
  370. package/dist/translations/en.js.map +1 -1
  371. package/dist/translations/es.js +221 -0
  372. package/dist/translations/es.js.map +1 -0
  373. package/dist/translations/fr.js +221 -0
  374. package/dist/translations/fr.js.map +1 -0
  375. package/dist/translations/id.js +221 -0
  376. package/dist/translations/id.js.map +1 -0
  377. package/dist/translations/index.d.ts +10 -1
  378. package/dist/translations/index.js +19 -1
  379. package/dist/translations/index.js.map +1 -1
  380. package/dist/translations/keys.d.ts +144 -0
  381. package/dist/translations/keys.js +145 -1
  382. package/dist/translations/keys.js.map +1 -1
  383. package/dist/translations/ko.js +221 -0
  384. package/dist/translations/ko.js.map +1 -0
  385. package/dist/translations/metricKeys.js +8 -2
  386. package/dist/translations/metricKeys.js.map +1 -1
  387. package/dist/translations/pt.js +221 -0
  388. package/dist/translations/pt.js.map +1 -0
  389. package/dist/translations/ru.js +221 -0
  390. package/dist/translations/ru.js.map +1 -0
  391. package/dist/translations/server.js.map +1 -1
  392. package/dist/translations/uk.js +221 -0
  393. package/dist/translations/uk.js.map +1 -0
  394. package/dist/translations/zh.js +221 -0
  395. package/dist/translations/zh.js.map +1 -0
  396. package/dist/view/AnalyticsNavLink.d.ts +19 -0
  397. package/dist/view/AnalyticsNavLink.js +40 -0
  398. package/dist/view/AnalyticsNavLink.js.map +1 -0
  399. package/dist/view/AnalyticsView.d.ts +23 -0
  400. package/dist/view/AnalyticsView.js +45 -0
  401. package/dist/view/AnalyticsView.js.map +1 -0
  402. package/dist/view/AnalyticsViewClient.d.ts +15 -0
  403. package/dist/view/AnalyticsViewClient.js +244 -0
  404. package/dist/view/AnalyticsViewClient.js.map +1 -0
  405. package/dist/view/authRedirect.js +32 -0
  406. package/dist/view/authRedirect.js.map +1 -0
  407. package/dist/view/conversionRate.js +18 -0
  408. package/dist/view/conversionRate.js.map +1 -0
  409. package/dist/view/dayRange.js +68 -0
  410. package/dist/view/dayRange.js.map +1 -0
  411. package/dist/view/gating.d.ts +1 -0
  412. package/dist/view/gating.js +142 -0
  413. package/dist/view/gating.js.map +1 -0
  414. package/dist/view/labels.js +76 -0
  415. package/dist/view/labels.js.map +1 -0
  416. package/dist/view/registerView.js +48 -0
  417. package/dist/view/registerView.js.map +1 -0
  418. package/dist/view/sections/Breakdowns.js +198 -0
  419. package/dist/view/sections/Breakdowns.js.map +1 -0
  420. package/dist/view/sections/EmptyStates.js +92 -0
  421. package/dist/view/sections/EmptyStates.js.map +1 -0
  422. package/dist/view/sections/FilterChips.js +46 -0
  423. package/dist/view/sections/FilterChips.js.map +1 -0
  424. package/dist/view/sections/GoalsPanel.js +82 -0
  425. package/dist/view/sections/GoalsPanel.js.map +1 -0
  426. package/dist/view/sections/OverviewCards.js +65 -0
  427. package/dist/view/sections/OverviewCards.js.map +1 -0
  428. package/dist/view/sections/RealtimeStrip.js +80 -0
  429. package/dist/view/sections/RealtimeStrip.js.map +1 -0
  430. package/dist/view/sections/Toolbar.js +207 -0
  431. package/dist/view/sections/Toolbar.js.map +1 -0
  432. package/dist/view/sections/Trend.js +125 -0
  433. package/dist/view/sections/Trend.js.map +1 -0
  434. package/dist/view/sections/styles.js +76 -0
  435. package/dist/view/sections/styles.js.map +1 -0
  436. package/dist/view/state.js +211 -0
  437. package/dist/view/state.js.map +1 -0
  438. package/dist/view/useViewQueries.js +153 -0
  439. package/dist/view/useViewQueries.js.map +1 -0
  440. package/dist/view/viewProps.d.ts +40 -0
  441. package/dist/view/viewProps.js +90 -0
  442. package/dist/view/viewProps.js.map +1 -0
  443. package/dist/widgets/AnalyticsBreakdownWidget.d.ts +2 -1
  444. package/dist/widgets/AnalyticsBreakdownWidget.js +78 -11
  445. package/dist/widgets/AnalyticsBreakdownWidget.js.map +1 -1
  446. package/dist/widgets/AnalyticsGoalsWidget.d.ts +14 -0
  447. package/dist/widgets/AnalyticsGoalsWidget.js +196 -0
  448. package/dist/widgets/AnalyticsGoalsWidget.js.map +1 -0
  449. package/dist/widgets/AnalyticsMetricWidget.d.ts +2 -1
  450. package/dist/widgets/AnalyticsMetricWidget.js +63 -13
  451. package/dist/widgets/AnalyticsMetricWidget.js.map +1 -1
  452. package/dist/widgets/AnalyticsRealtimeWidget.d.ts +2 -1
  453. package/dist/widgets/AnalyticsRealtimeWidget.js +44 -22
  454. package/dist/widgets/AnalyticsRealtimeWidget.js.map +1 -1
  455. package/dist/widgets/AnalyticsTrendWidget.d.ts +2 -1
  456. package/dist/widgets/AnalyticsTrendWidget.js +79 -16
  457. package/dist/widgets/AnalyticsTrendWidget.js.map +1 -1
  458. package/dist/widgets/RealtimeCounter.d.ts +4 -0
  459. package/dist/widgets/RealtimeCounter.js +18 -4
  460. package/dist/widgets/RealtimeCounter.js.map +1 -1
  461. package/dist/widgets/WidgetViewLink.js +17 -0
  462. package/dist/widgets/WidgetViewLink.js.map +1 -0
  463. package/dist/widgets/breakdownTypes.js +38 -0
  464. package/dist/widgets/breakdownTypes.js.map +1 -1
  465. package/dist/widgets/cardChrome.js +31 -7
  466. package/dist/widgets/cardChrome.js.map +1 -1
  467. package/dist/widgets/comparison.js +15 -1
  468. package/dist/widgets/comparison.js.map +1 -1
  469. package/dist/widgets/defaults.d.ts +6 -2
  470. package/dist/widgets/defaults.js +78 -23
  471. package/dist/widgets/defaults.js.map +1 -1
  472. package/dist/widgets/filterCaption.js +27 -0
  473. package/dist/widgets/filterCaption.js.map +1 -0
  474. package/dist/widgets/filterField.d.ts +19 -0
  475. package/dist/widgets/filterField.js +75 -0
  476. package/dist/widgets/filterField.js.map +1 -0
  477. package/dist/widgets/prepareWidgetRead.d.ts +7 -0
  478. package/dist/widgets/prepareWidgetRead.js +74 -0
  479. package/dist/widgets/prepareWidgetRead.js.map +1 -0
  480. package/dist/widgets/range.js +43 -12
  481. package/dist/widgets/range.js.map +1 -1
  482. package/dist/widgets/readForWidget.d.ts +26 -3
  483. package/dist/widgets/readForWidget.js +48 -44
  484. package/dist/widgets/readForWidget.js.map +1 -1
  485. package/dist/widgets/readForWidgetBreakdown.d.ts +34 -2
  486. package/dist/widgets/readForWidgetBreakdown.js +53 -49
  487. package/dist/widgets/readForWidgetBreakdown.js.map +1 -1
  488. package/dist/widgets/readForWidgetGoals.d.ts +67 -0
  489. package/dist/widgets/readForWidgetGoals.js +140 -0
  490. package/dist/widgets/readForWidgetGoals.js.map +1 -0
  491. package/dist/widgets/readForWidgetRealtime.d.ts +8 -0
  492. package/dist/widgets/readForWidgetRealtime.js +23 -21
  493. package/dist/widgets/readForWidgetRealtime.js.map +1 -1
  494. package/dist/widgets/readForWidgetSeries.d.ts +26 -2
  495. package/dist/widgets/readForWidgetSeries.js +78 -53
  496. package/dist/widgets/readForWidgetSeries.js.map +1 -1
  497. package/dist/widgets/readMeta.js +18 -0
  498. package/dist/widgets/readMeta.js.map +1 -0
  499. package/dist/widgets/realtimePoll.js +13 -1
  500. package/dist/widgets/realtimePoll.js.map +1 -1
  501. package/dist/widgets/registerWidgets.js +62 -10
  502. package/dist/widgets/registerWidgets.js.map +1 -1
  503. package/dist/widgets/types.d.ts +15 -0
  504. package/dist/widgets/types.js +16 -2
  505. package/dist/widgets/types.js.map +1 -1
  506. package/dist/widgets/viewLink.d.ts +22 -0
  507. package/dist/widgets/viewLink.js +86 -0
  508. package/dist/widgets/viewLink.js.map +1 -0
  509. package/package.json +28 -8
  510. package/dist/native/rollups/applyDistinctDeltas.js +0 -9
  511. package/dist/native/rollups/applyDistinctDeltas.js.map +0 -1
  512. package/dist/native/rollups/bumpRollup.js +0 -68
  513. package/dist/native/rollups/bumpRollup.js.map +0 -1
  514. package/dist/native/rollups/insertIfNew.js +0 -19
  515. package/dist/native/rollups/insertIfNew.js.map +0 -1
@@ -0,0 +1,130 @@
1
+ //#region src/surfacing/rateLimiter.ts
2
+ const MINUTE_MS = 6e4;
3
+ const HOUR_MS = 36e5;
4
+ const createBucket = (capacity, windowMs) => {
5
+ const intervalMs = windowMs / capacity;
6
+ let tokens = capacity;
7
+ let last;
8
+ const sync = (now) => {
9
+ if (last === void 0) {
10
+ last = now;
11
+ return;
12
+ }
13
+ const elapsed = now - last;
14
+ if (elapsed > 0) {
15
+ tokens = Math.min(capacity, tokens + elapsed / intervalMs);
16
+ last = now;
17
+ }
18
+ };
19
+ return {
20
+ waitMs(now) {
21
+ sync(now);
22
+ if (tokens >= 1) return 0;
23
+ return Math.ceil((1 - tokens) * intervalMs);
24
+ },
25
+ take(now) {
26
+ sync(now);
27
+ tokens -= 1;
28
+ }
29
+ };
30
+ };
31
+ const sleep = (ms, signal) => {
32
+ if (signal?.aborted) return Promise.reject(signal.reason);
33
+ return new Promise((resolve, reject) => {
34
+ const timer = setTimeout(() => {
35
+ signal?.removeEventListener("abort", onAbort);
36
+ resolve();
37
+ }, ms);
38
+ const onAbort = () => {
39
+ clearTimeout(timer);
40
+ reject(signal?.reason);
41
+ };
42
+ signal?.addEventListener("abort", onAbort, { once: true });
43
+ });
44
+ };
45
+ /**
46
+ * Waits until every bucket holds a token, then deducts one from each. Bucket checks and
47
+ * deductions happen synchronously (no await between them) so a zero-wait pass can never
48
+ * race; a non-zero wait rechecks after sleeping since a concurrent taker may have spent
49
+ * the token first.
50
+ */
51
+ const acquireTokens = async (buckets, clock, signal) => {
52
+ for (;;) {
53
+ if (signal?.aborted) throw signal.reason;
54
+ const now = clock();
55
+ const maxWait = buckets.reduce((max, bucket) => Math.max(max, bucket.waitMs(now)), 0);
56
+ if (maxWait === 0) {
57
+ for (const bucket of buckets) bucket.take(now);
58
+ return;
59
+ }
60
+ await sleep(maxWait, signal);
61
+ }
62
+ };
63
+ const createSemaphore = (capacity) => {
64
+ let active = 0;
65
+ const waiters = [];
66
+ const release = () => {
67
+ active--;
68
+ waiters.shift()?.();
69
+ };
70
+ return { acquire(signal) {
71
+ if (signal?.aborted) return Promise.reject(signal.reason);
72
+ if (active < capacity) {
73
+ active++;
74
+ return Promise.resolve(release);
75
+ }
76
+ return new Promise((resolve, reject) => {
77
+ const onAbort = () => {
78
+ const idx = waiters.indexOf(grant);
79
+ if (idx !== -1) waiters.splice(idx, 1);
80
+ reject(signal?.reason);
81
+ };
82
+ const grant = () => {
83
+ signal?.removeEventListener("abort", onAbort);
84
+ active++;
85
+ resolve(release);
86
+ };
87
+ waiters.push(grant);
88
+ signal?.addEventListener("abort", onAbort, { once: true });
89
+ });
90
+ } };
91
+ };
92
+ const noopRelease = () => {};
93
+ /**
94
+ * Builds a limiter from an adapter's declared RateLimitDescriptor; a null descriptor
95
+ * returns an unlimited pass-through. requestsPerMinute and requestsPerHour each maintain
96
+ * their own continuously refilling token bucket and a take needs a token from every
97
+ * configured bucket; maxConcurrent is a plain semaphore released by the returned function.
98
+ * Token deductions are never released; they represent quota already spent.
99
+ */
100
+ const createRateLimiter = (descriptor, clock = Date.now) => {
101
+ if (!descriptor) return { take: async () => noopRelease };
102
+ const buckets = [];
103
+ if (descriptor.requestsPerMinute) buckets.push(createBucket(descriptor.requestsPerMinute, MINUTE_MS));
104
+ if (descriptor.requestsPerHour) buckets.push(createBucket(descriptor.requestsPerHour, HOUR_MS));
105
+ const semaphore = descriptor.maxConcurrent ? createSemaphore(descriptor.maxConcurrent) : void 0;
106
+ return { async take(signal) {
107
+ if (signal?.aborted) throw signal.reason;
108
+ const releaseConcurrency = semaphore ? await semaphore.acquire(signal) : noopRelease;
109
+ try {
110
+ if (buckets.length) await acquireTokens(buckets, clock, signal);
111
+ return releaseConcurrency;
112
+ } catch (err) {
113
+ releaseConcurrency();
114
+ throw err;
115
+ }
116
+ } };
117
+ };
118
+ /** Returns the adapter's limiter, building and caching it from its declared rateLimit on first use. */
119
+ const limiterFor = (map, adapter, clock) => {
120
+ let limiter = map.get(adapter.id);
121
+ if (!limiter) {
122
+ limiter = createRateLimiter(adapter.capabilities.rateLimit, clock);
123
+ map.set(adapter.id, limiter);
124
+ }
125
+ return limiter;
126
+ };
127
+ //#endregion
128
+ export { limiterFor };
129
+
130
+ //# sourceMappingURL=rateLimiter.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"rateLimiter.js","names":[],"sources":["../../src/surfacing/rateLimiter.ts"],"sourcesContent":["import type { AnalyticsAdapter, RateLimitDescriptor } from '../core/contract'\n\nexport interface RateLimiter {\n\t/** Resolves when a request slot is available; rejects with the signal's reason when aborted while waiting. Release must be called exactly once per successful take. */\n\ttake(signal?: AbortSignal): Promise<() => void>\n}\n\nconst MINUTE_MS = 60_000\nconst HOUR_MS = 3_600_000\n\ninterface TokenBucket {\n\twaitMs(now: number): number\n\ttake(now: number): void\n}\n\nconst createBucket = (capacity: number, windowMs: number): TokenBucket => {\n\t// ms per token, rather than tokens-per-ms: for every descriptor value in this codebase\n\t// windowMs divides evenly by capacity, so this stays exact and sidesteps the float\n\t// drift a capacity/windowMs rate would reintroduce on the multiply-then-divide round trip.\n\tconst intervalMs = windowMs / capacity\n\tlet tokens = capacity\n\tlet last: number | undefined\n\n\tconst sync = (now: number): void => {\n\t\tif (last === undefined) {\n\t\t\tlast = now\n\t\t\treturn\n\t\t}\n\t\tconst elapsed = now - last\n\t\tif (elapsed > 0) {\n\t\t\ttokens = Math.min(capacity, tokens + elapsed / intervalMs)\n\t\t\tlast = now\n\t\t}\n\t}\n\n\treturn {\n\t\twaitMs(now) {\n\t\t\tsync(now)\n\t\t\tif (tokens >= 1) return 0\n\t\t\treturn Math.ceil((1 - tokens) * intervalMs)\n\t\t},\n\t\ttake(now) {\n\t\t\tsync(now)\n\t\t\ttokens -= 1\n\t\t},\n\t}\n}\n\nconst sleep = (ms: number, signal?: AbortSignal): Promise<void> => {\n\tif (signal?.aborted) return Promise.reject(signal.reason)\n\treturn new Promise<void>((resolve, reject) => {\n\t\tconst timer = setTimeout(() => {\n\t\t\tsignal?.removeEventListener('abort', onAbort)\n\t\t\tresolve()\n\t\t}, ms)\n\t\tconst onAbort = (): void => {\n\t\t\tclearTimeout(timer)\n\t\t\treject(signal?.reason)\n\t\t}\n\t\tsignal?.addEventListener('abort', onAbort, { once: true })\n\t})\n}\n\n/**\n * Waits until every bucket holds a token, then deducts one from each. Bucket checks and\n * deductions happen synchronously (no await between them) so a zero-wait pass can never\n * race; a non-zero wait rechecks after sleeping since a concurrent taker may have spent\n * the token first.\n */\nconst acquireTokens = async (\n\tbuckets: TokenBucket[],\n\tclock: () => number,\n\tsignal?: AbortSignal\n): Promise<void> => {\n\tfor (;;) {\n\t\tif (signal?.aborted) throw signal.reason\n\t\tconst now = clock()\n\t\tconst maxWait = buckets.reduce((max, bucket) => Math.max(max, bucket.waitMs(now)), 0)\n\t\tif (maxWait === 0) {\n\t\t\tfor (const bucket of buckets) bucket.take(now)\n\t\t\treturn\n\t\t}\n\t\tawait sleep(maxWait, signal)\n\t}\n}\n\ninterface Semaphore {\n\tacquire(signal?: AbortSignal): Promise<() => void>\n}\n\nconst createSemaphore = (capacity: number): Semaphore => {\n\tlet active = 0\n\tconst waiters: Array<() => void> = []\n\n\tconst release = (): void => {\n\t\tactive--\n\t\twaiters.shift()?.()\n\t}\n\n\treturn {\n\t\tacquire(signal) {\n\t\t\tif (signal?.aborted) return Promise.reject(signal.reason)\n\t\t\tif (active < capacity) {\n\t\t\t\tactive++\n\t\t\t\treturn Promise.resolve(release)\n\t\t\t}\n\t\t\treturn new Promise<() => void>((resolve, reject) => {\n\t\t\t\tconst onAbort = (): void => {\n\t\t\t\t\tconst idx = waiters.indexOf(grant)\n\t\t\t\t\tif (idx !== -1) waiters.splice(idx, 1)\n\t\t\t\t\treject(signal?.reason)\n\t\t\t\t}\n\t\t\t\tconst grant = (): void => {\n\t\t\t\t\tsignal?.removeEventListener('abort', onAbort)\n\t\t\t\t\tactive++\n\t\t\t\t\tresolve(release)\n\t\t\t\t}\n\t\t\t\twaiters.push(grant)\n\t\t\t\tsignal?.addEventListener('abort', onAbort, { once: true })\n\t\t\t})\n\t\t},\n\t}\n}\n\nconst noopRelease = (): void => {}\n\n/**\n * Builds a limiter from an adapter's declared RateLimitDescriptor; a null descriptor\n * returns an unlimited pass-through. requestsPerMinute and requestsPerHour each maintain\n * their own continuously refilling token bucket and a take needs a token from every\n * configured bucket; maxConcurrent is a plain semaphore released by the returned function.\n * Token deductions are never released; they represent quota already spent.\n */\nexport const createRateLimiter = (\n\tdescriptor: RateLimitDescriptor | null,\n\tclock: () => number = Date.now\n): RateLimiter => {\n\tif (!descriptor) {\n\t\treturn { take: async () => noopRelease }\n\t}\n\n\tconst buckets: TokenBucket[] = []\n\tif (descriptor.requestsPerMinute)\n\t\tbuckets.push(createBucket(descriptor.requestsPerMinute, MINUTE_MS))\n\tif (descriptor.requestsPerHour) buckets.push(createBucket(descriptor.requestsPerHour, HOUR_MS))\n\tconst semaphore = descriptor.maxConcurrent ? createSemaphore(descriptor.maxConcurrent) : undefined\n\n\treturn {\n\t\tasync take(signal) {\n\t\t\tif (signal?.aborted) throw signal.reason\n\t\t\tconst releaseConcurrency = semaphore ? await semaphore.acquire(signal) : noopRelease\n\t\t\ttry {\n\t\t\t\tif (buckets.length) await acquireTokens(buckets, clock, signal)\n\t\t\t\treturn releaseConcurrency\n\t\t\t} catch (err) {\n\t\t\t\treleaseConcurrency()\n\t\t\t\tthrow err\n\t\t\t}\n\t\t},\n\t}\n}\n\n/** Returns the adapter's limiter, building and caching it from its declared rateLimit on first use. */\nexport const limiterFor = (\n\tmap: Map<string, RateLimiter>,\n\tadapter: AnalyticsAdapter,\n\tclock?: () => number\n): RateLimiter => {\n\tlet limiter = map.get(adapter.id)\n\tif (!limiter) {\n\t\tlimiter = createRateLimiter(adapter.capabilities.rateLimit, clock)\n\t\tmap.set(adapter.id, limiter)\n\t}\n\treturn limiter\n}\n"],"mappings":"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"}
@@ -0,0 +1,15 @@
1
+ import { ProviderHttpError } from "../adapters/http/fetchJson.js";
2
+ //#region src/surfacing/retryPolicy.ts
3
+ /** Reason message the engine's own read-timeout abort uses; shared so classification and the abort reason cannot drift apart. */
4
+ const PROVIDER_READ_TIMEOUT_MESSAGE = "analytics: provider read timed out";
5
+ const isAbortError = (err) => err instanceof Error && (err.name === "AbortError" || err.message === "analytics: provider read timed out");
6
+ /** Retry classification for provider reads: 429 and 5xx back off (transient quota/server trouble), other HTTP statuses are the caller's bug and never retry, aborts never retry, anything non-HTTP is presumed a transient network failure and gets one more try. */
7
+ const shouldRetryProviderError = (err, attempt) => {
8
+ if (err instanceof ProviderHttpError) return (err.status === 429 || err.status >= 500) && attempt < 2;
9
+ if (isAbortError(err)) return false;
10
+ return attempt < 1;
11
+ };
12
+ //#endregion
13
+ export { PROVIDER_READ_TIMEOUT_MESSAGE, shouldRetryProviderError };
14
+
15
+ //# sourceMappingURL=retryPolicy.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"retryPolicy.js","names":[],"sources":["../../src/surfacing/retryPolicy.ts"],"sourcesContent":["import { ProviderHttpError } from '../adapters/http/fetchJson'\n\n/** Reason message the engine's own read-timeout abort uses; shared so classification and the abort reason cannot drift apart. */\nexport const PROVIDER_READ_TIMEOUT_MESSAGE = 'analytics: provider read timed out'\n\nconst isAbortError = (err: unknown): boolean =>\n\terr instanceof Error &&\n\t(err.name === 'AbortError' || err.message === PROVIDER_READ_TIMEOUT_MESSAGE)\n\n/** Retry classification for provider reads: 429 and 5xx back off (transient quota/server trouble), other HTTP statuses are the caller's bug and never retry, aborts never retry, anything non-HTTP is presumed a transient network failure and gets one more try. */\nexport const shouldRetryProviderError = (err: unknown, attempt: number): boolean => {\n\tif (err instanceof ProviderHttpError) {\n\t\treturn (err.status === 429 || err.status >= 500) && attempt < 2\n\t}\n\tif (isAbortError(err)) return false\n\treturn attempt < 1\n}\n"],"mappings":";;;AAGA,MAAa,gCAAgC;AAE7C,MAAM,gBAAgB,QACrB,eAAe,UACd,IAAI,SAAS,gBAAgB,IAAI,YAAA;;AAGnC,MAAa,4BAA4B,KAAc,YAA6B;CACnF,IAAI,eAAe,mBAClB,QAAQ,IAAI,WAAW,OAAO,IAAI,UAAU,QAAQ,UAAU;CAE/D,IAAI,aAAa,GAAG,GAAG,OAAO;CAC9B,OAAO,UAAU;AAClB"}
@@ -1,3 +1,4 @@
1
+ import { providerRowAccess } from "../providers/access.js";
1
2
  //#region src/sync/collection.ts
2
3
  const METRIC_FIELDS = [
3
4
  "pageviews",
@@ -14,12 +15,15 @@ const METRIC_FIELDS = [
14
15
  * substrate for custom reporting rather than something to browse and edit; pass
15
16
  * `sync: { hidden: false }` to surface it. `admin.hidden` only hides the nav entry, so
16
17
  * the collection stays fully queryable through the REST/local API either way. The unique
17
- * (source, date) index makes re-syncs idempotent and is cross-DB clean (both key columns
18
- * are required, so NOT NULL on Postgres, which would otherwise treat repeated rows as
19
- * distinct). Metric fields are nullable so a provider that omits a metric is
20
- * distinguishable from a real zero.
18
+ * (source, date, scope) index makes re-syncs idempotent and is cross-DB clean (all key
19
+ * columns are required, so NOT NULL on Postgres, which would otherwise treat repeated rows
20
+ * as distinct). Metric fields are nullable so a provider that omits a metric is
21
+ * distinguishable from a real zero. Read access reuses `providerRowAccess`: unscoped
22
+ * installs keep the any-authenticated-user behavior, scoped installs constrain reads to the
23
+ * request's resolved scope (or lift the constraint for a platform-read grant). Writes stay
24
+ * locked to the sync job, which writes with `overrideAccess: true`.
21
25
  */
22
- const syncCollection = (slug, hidden = true) => ({
26
+ const syncCollection = (slug, hidden, access) => ({
23
27
  slug,
24
28
  admin: {
25
29
  hidden,
@@ -32,7 +36,7 @@ const syncCollection = (slug, hidden = true) => ({
32
36
  ]
33
37
  },
34
38
  access: {
35
- read: ({ req }) => Boolean(req.user),
39
+ read: providerRowAccess(access),
36
40
  create: () => false,
37
41
  update: () => false,
38
42
  delete: () => false
@@ -50,6 +54,14 @@ const syncCollection = (slug, hidden = true) => ({
50
54
  required: true,
51
55
  index: true
52
56
  },
57
+ {
58
+ name: "scope",
59
+ type: "text",
60
+ required: true,
61
+ defaultValue: "",
62
+ index: true,
63
+ validate: ((value) => typeof value === "string" ? true : "invalid scope")
64
+ },
53
65
  ...METRIC_FIELDS.map((name) => ({
54
66
  name,
55
67
  type: "number"
@@ -60,7 +72,11 @@ const syncCollection = (slug, hidden = true) => ({
60
72
  }
61
73
  ],
62
74
  indexes: [{
63
- fields: ["source", "date"],
75
+ fields: [
76
+ "source",
77
+ "date",
78
+ "scope"
79
+ ],
64
80
  unique: true
65
81
  }]
66
82
  });
@@ -1 +1 @@
1
- {"version":3,"file":"collection.js","names":[],"sources":["../../src/sync/collection.ts"],"sourcesContent":["import type { CollectionConfig, Field } from 'payload'\n\nexport const SYNC_DEFAULT_SLUG = 'analytics-daily'\n\nexport const METRIC_FIELDS = [\n\t'pageviews',\n\t'visitors',\n\t'sessions',\n\t'avgDuration',\n\t'bounceRate',\n\t'events',\n] as const\n\nexport type SyncMetric = (typeof METRIC_FIELDS)[number]\n\n/**\n * The sync tier's queryable collection: one row per (source, date) of a provider's daily\n * metrics. It is read-only and machine-written (writes are locked to the sync job, which\n * uses overrideAccess), and hidden from the admin nav by default because it is a query\n * substrate for custom reporting rather than something to browse and edit; pass\n * `sync: { hidden: false }` to surface it. `admin.hidden` only hides the nav entry, so\n * the collection stays fully queryable through the REST/local API either way. The unique\n * (source, date) index makes re-syncs idempotent and is cross-DB clean (both key columns\n * are required, so NOT NULL on Postgres, which would otherwise treat repeated rows as\n * distinct). Metric fields are nullable so a provider that omits a metric is\n * distinguishable from a real zero.\n */\nexport const syncCollection = (slug: string, hidden = true): CollectionConfig => ({\n\tslug,\n\tadmin: {\n\t\thidden,\n\t\tuseAsTitle: 'source',\n\t\tdefaultColumns: ['source', 'date', 'pageviews', 'visitors'],\n\t},\n\taccess: {\n\t\tread: ({ req }) => Boolean(req.user),\n\t\tcreate: () => false,\n\t\tupdate: () => false,\n\t\tdelete: () => false,\n\t},\n\tfields: [\n\t\t{ name: 'source', type: 'text', required: true, index: true },\n\t\t{ name: 'date', type: 'date', required: true, index: true },\n\t\t...METRIC_FIELDS.map((name): Field => ({ name, type: 'number' })),\n\t\t{ name: 'syncedAt', type: 'date' },\n\t],\n\tindexes: [{ fields: ['source', 'date'], unique: true }],\n})\n"],"mappings":";AAIA,MAAa,gBAAgB;CAC5B;CACA;CACA;CACA;CACA;CACA;AACD;;;;;;;;;;;;;AAgBA,MAAa,kBAAkB,MAAc,SAAS,UAA4B;CACjF;CACA,OAAO;EACN;EACA,YAAY;EACZ,gBAAgB;GAAC;GAAU;GAAQ;GAAa;EAAU;CAC3D;CACA,QAAQ;EACP,OAAO,EAAE,UAAU,QAAQ,IAAI,IAAI;EACnC,cAAc;EACd,cAAc;EACd,cAAc;CACf;CACA,QAAQ;EACP;GAAE,MAAM;GAAU,MAAM;GAAQ,UAAU;GAAM,OAAO;EAAK;EAC5D;GAAE,MAAM;GAAQ,MAAM;GAAQ,UAAU;GAAM,OAAO;EAAK;EAC1D,GAAG,cAAc,KAAK,UAAiB;GAAE;GAAM,MAAM;EAAS,EAAE;EAChE;GAAE,MAAM;GAAY,MAAM;EAAO;CAClC;CACA,SAAS,CAAC;EAAE,QAAQ,CAAC,UAAU,MAAM;EAAG,QAAQ;CAAK,CAAC;AACvD"}
1
+ {"version":3,"file":"collection.js","names":[],"sources":["../../src/sync/collection.ts"],"sourcesContent":["import type { CollectionConfig, Field, TextFieldSingleValidation } from 'payload'\nimport type { ProviderAccessArgs } from '../providers/access'\nimport { providerRowAccess } from '../providers/access'\n\nexport const SYNC_DEFAULT_SLUG = 'analytics-daily'\n\nexport const METRIC_FIELDS = [\n\t'pageviews',\n\t'visitors',\n\t'sessions',\n\t'avgDuration',\n\t'bounceRate',\n\t'events',\n] as const\n\nexport type SyncMetric = (typeof METRIC_FIELDS)[number]\n\n/**\n * The sync tier's queryable collection: one row per (source, date) of a provider's daily\n * metrics. It is read-only and machine-written (writes are locked to the sync job, which\n * uses overrideAccess), and hidden from the admin nav by default because it is a query\n * substrate for custom reporting rather than something to browse and edit; pass\n * `sync: { hidden: false }` to surface it. `admin.hidden` only hides the nav entry, so\n * the collection stays fully queryable through the REST/local API either way. The unique\n * (source, date, scope) index makes re-syncs idempotent and is cross-DB clean (all key\n * columns are required, so NOT NULL on Postgres, which would otherwise treat repeated rows\n * as distinct). Metric fields are nullable so a provider that omits a metric is\n * distinguishable from a real zero. Read access reuses `providerRowAccess`: unscoped\n * installs keep the any-authenticated-user behavior, scoped installs constrain reads to the\n * request's resolved scope (or lift the constraint for a platform-read grant). Writes stay\n * locked to the sync job, which writes with `overrideAccess: true`.\n */\nexport const syncCollection = (\n\tslug: string,\n\thidden: boolean,\n\taccess: ProviderAccessArgs\n): CollectionConfig => ({\n\tslug,\n\tadmin: {\n\t\thidden,\n\t\tuseAsTitle: 'source',\n\t\tdefaultColumns: ['source', 'date', 'pageviews', 'visitors'],\n\t},\n\taccess: {\n\t\tread: providerRowAccess(access),\n\t\tcreate: () => false,\n\t\tupdate: () => false,\n\t\tdelete: () => false,\n\t},\n\tfields: [\n\t\t{ name: 'source', type: 'text', required: true, index: true },\n\t\t{ name: 'date', type: 'date', required: true, index: true },\n\t\t{\n\t\t\tname: 'scope',\n\t\t\ttype: 'text',\n\t\t\trequired: true,\n\t\t\tdefaultValue: '',\n\t\t\tindex: true,\n\t\t\t// '' is the deliberate sentinel for \"no scope\"; Payload's default text\n\t\t\t// validator treats it as failing `required`, so accept any string.\n\t\t\tvalidate: ((value) =>\n\t\t\t\ttypeof value === 'string' ? true : 'invalid scope') as TextFieldSingleValidation,\n\t\t},\n\t\t...METRIC_FIELDS.map((name): Field => ({ name, type: 'number' })),\n\t\t{ name: 'syncedAt', type: 'date' },\n\t],\n\tindexes: [{ fields: ['source', 'date', 'scope'], unique: true }],\n})\n"],"mappings":";;AAMA,MAAa,gBAAgB;CAC5B;CACA;CACA;CACA;CACA;CACA;AACD;;;;;;;;;;;;;;;;AAmBA,MAAa,kBACZ,MACA,QACA,YACuB;CACvB;CACA,OAAO;EACN;EACA,YAAY;EACZ,gBAAgB;GAAC;GAAU;GAAQ;GAAa;EAAU;CAC3D;CACA,QAAQ;EACP,MAAM,kBAAkB,MAAM;EAC9B,cAAc;EACd,cAAc;EACd,cAAc;CACf;CACA,QAAQ;EACP;GAAE,MAAM;GAAU,MAAM;GAAQ,UAAU;GAAM,OAAO;EAAK;EAC5D;GAAE,MAAM;GAAQ,MAAM;GAAQ,UAAU;GAAM,OAAO;EAAK;EAC1D;GACC,MAAM;GACN,MAAM;GACN,UAAU;GACV,cAAc;GACd,OAAO;GAGP,YAAY,UACX,OAAO,UAAU,WAAW,OAAO;EACrC;EACA,GAAG,cAAc,KAAK,UAAiB;GAAE;GAAM,MAAM;EAAS,EAAE;EAChE;GAAE,MAAM;GAAY,MAAM;EAAO;CAClC;CACA,SAAS,CAAC;EAAE,QAAQ;GAAC;GAAU;GAAQ;EAAO;EAAG,QAAQ;CAAK,CAAC;AAChE"}
@@ -1,5 +1,6 @@
1
+ import { getRuntime, resolveRegistryFor } from "../plugin/runtime.js";
1
2
  import { supportsGranularity } from "../core/granularity.js";
2
- import { getRuntime, resolveRegistryFor, resolveScopeFor } from "../plugin/runtime.js";
3
+ import { resolveScopeList } from "../core/scopeList.js";
3
4
  import { METRIC_FIELDS } from "./collection.js";
4
5
  //#region src/sync/syncTask.ts
5
6
  const SYNC_TASK_SLUG = "analytics-sync";
@@ -9,14 +10,15 @@ const DAY_MS = 864e5;
9
10
  * `date`, each present numeric metric is copied, absent metrics are omitted (stored null).
10
11
  * Returns null when the row has no usable timestamp, so a malformed row is skipped not written.
11
12
  */
12
- const toSyncRow = (source, row, syncedAt) => {
13
+ const toSyncRow = (source, row, opts) => {
13
14
  if (!row.timestamp) return null;
14
15
  const date = new Date(row.timestamp);
15
16
  if (Number.isNaN(date.getTime())) return null;
16
17
  const doc = {
17
18
  source,
18
19
  date,
19
- syncedAt
20
+ syncedAt: opts.syncedAt,
21
+ scope: opts.scope ?? ""
20
22
  };
21
23
  for (const metric of METRIC_FIELDS) {
22
24
  const value = row.metrics[metric];
@@ -24,11 +26,24 @@ const toSyncRow = (source, row, syncedAt) => {
24
26
  }
25
27
  return doc;
26
28
  };
29
+ /**
30
+ * True when `adapterIds` is unset, or `adapterId` is listed exactly, or (for a
31
+ * runtime instance id shaped `<provider>:<docId>`) its provider type is listed.
32
+ */
33
+ const matchesAdapterFilter = (adapterIds, adapterId) => {
34
+ if (!adapterIds) return true;
35
+ if (adapterIds.includes(adapterId)) return true;
36
+ return adapterIds.includes(adapterId.split(":")[0] ?? adapterId);
37
+ };
27
38
  const startOfUtcDay = (d) => new Date(Date.UTC(d.getUTCFullYear(), d.getUTCMonth(), d.getUTCDate()));
28
39
  const upsertDailyRow = async (req, collectionSlug, row) => {
29
40
  const found = (await req.payload.find({
30
41
  collection: collectionSlug,
31
- where: { and: [{ source: { equals: row.source } }, { date: { equals: row.date.toISOString() } }] },
42
+ where: { and: [
43
+ { source: { equals: row.source } },
44
+ { date: { equals: row.date.toISOString() } },
45
+ { scope: { equals: row.scope } }
46
+ ] },
32
47
  limit: 1,
33
48
  depth: 0,
34
49
  overrideAccess: true
@@ -50,10 +65,12 @@ const upsertDailyRow = async (req, collectionSlug, row) => {
50
65
  };
51
66
  /**
52
67
  * Opt-in Payload task that ETLs each configured provider adapter's last `lookbackDays` of
53
- * daily metrics into the sync collection (one upserted row per source + day), reading
54
- * through the surfacing engine so the pull rides its queue / backoff / cache. Native is
55
- * excluded (its data already lives in the rollups collection); each provider runs in its
56
- * own try/catch so one failure does not abort the rest.
68
+ * daily metrics into the sync collection (one upserted row per scope + source + day),
69
+ * reading through the surfacing engine so the pull rides its queue / backoff / cache.
70
+ * Native is excluded (its data already lives in the rollups collection); each provider
71
+ * runs in its own try/catch so one failure does not abort the rest. With `scopes`
72
+ * configured, the whole per-adapter pull runs once per tenant scope (plus the
73
+ * install-wide scope) so a multi-tenant install syncs every tenant, not just the null one.
57
74
  */
58
75
  const syncTask = (opts) => ({
59
76
  slug: SYNC_TASK_SLUG,
@@ -70,40 +87,58 @@ const syncTask = (opts) => ({
70
87
  };
71
88
  let synced = 0;
72
89
  let failed = 0;
73
- const scope = await resolveScopeFor(runtime, req).catch(() => null);
74
- const registry = await resolveRegistryFor(runtime, {
75
- payload: req.payload,
76
- req,
77
- scope
78
- });
79
- for (const adapter of registry.all()) {
80
- if (adapter.id === "native") continue;
81
- if (opts.adapterIds && !opts.adapterIds.includes(adapter.id)) continue;
82
- if (!adapter.isConfigured() || !supportsGranularity(adapter.capabilities, "day")) continue;
83
- const metrics = METRIC_FIELDS.filter((m) => adapter.capabilities.metrics.has(m));
84
- if (metrics.length === 0) continue;
85
- let result;
90
+ const scopeList = await resolveScopeList(opts.scopes, req.payload);
91
+ for (const scope of scopeList) {
92
+ let registry;
86
93
  try {
87
- result = await runtime.engine.read(adapter, {
88
- metrics,
89
- dateRange,
90
- granularity: "day",
91
- scope: scope ?? void 0
94
+ registry = await resolveRegistryFor(runtime, {
95
+ payload: req.payload,
96
+ req,
97
+ scope
92
98
  });
93
99
  } catch (err) {
94
100
  failed++;
95
- req.payload.logger.warn(`analytics sync: adapter "${adapter.id}" read failed: ${String(err)}`);
101
+ req.payload.logger.warn(`analytics sync: registry resolution failed for scope "${scope ?? "install-wide"}": ${String(err)}`);
96
102
  continue;
97
103
  }
98
- for (const row of result.rows) {
99
- const doc = toSyncRow(adapter.id, row, now);
100
- if (!doc) continue;
104
+ for (const adapter of registry.all()) {
105
+ if (adapter.id === "native") continue;
106
+ if (!matchesAdapterFilter(opts.adapterIds, adapter.id)) continue;
107
+ if (scope !== null && runtime.configAdapterIds.has(adapter.id) && !adapter.capabilities.scopedQueries) continue;
108
+ if (!adapter.isConfigured() || !supportsGranularity(adapter.capabilities, "day")) continue;
109
+ const metrics = METRIC_FIELDS.filter((m) => adapter.capabilities.metrics.has(m));
110
+ if (metrics.length === 0) continue;
111
+ let result;
101
112
  try {
102
- await upsertDailyRow(req, opts.collectionSlug, doc);
103
- synced++;
113
+ result = await runtime.engine.read(adapter, {
114
+ metrics,
115
+ dateRange,
116
+ granularity: "day",
117
+ scope: scope ?? void 0
118
+ });
104
119
  } catch (err) {
105
120
  failed++;
106
- req.payload.logger.warn(`analytics sync: upsert for "${adapter.id}" on ${doc.date.toISOString()} failed: ${String(err)}`);
121
+ req.payload.logger.warn(`analytics sync: adapter "${adapter.id}" read failed (scope "${scope ?? ""}"): ${String(err)}`);
122
+ continue;
123
+ }
124
+ if (result.meta.stale) {
125
+ failed++;
126
+ req.payload.logger.warn(`analytics sync: adapter "${adapter.id}" read was stale-served, skipping sync (scope "${scope ?? ""}")`);
127
+ continue;
128
+ }
129
+ for (const row of result.rows) {
130
+ const doc = toSyncRow(adapter.id, row, {
131
+ syncedAt: now,
132
+ scope: scope ?? ""
133
+ });
134
+ if (!doc) continue;
135
+ try {
136
+ await upsertDailyRow(req, opts.collectionSlug, doc);
137
+ synced++;
138
+ } catch (err) {
139
+ failed++;
140
+ req.payload.logger.warn(`analytics sync: upsert for "${adapter.id}" on ${doc.date.toISOString()} failed: ${String(err)}`);
141
+ }
107
142
  }
108
143
  }
109
144
  }
@@ -1 +1 @@
1
- {"version":3,"file":"syncTask.js","names":[],"sources":["../../src/sync/syncTask.ts"],"sourcesContent":["import type { PayloadRequest, TaskConfig } from 'payload'\nimport type { AnalyticsResult, AnalyticsRow } from '../core/contract'\nimport { supportsGranularity } from '../core/granularity'\nimport { getRuntime, resolveRegistryFor, resolveScopeFor } from '../plugin/runtime'\nimport { METRIC_FIELDS, type SyncMetric } from './collection'\n\nexport const SYNC_TASK_SLUG = 'analytics-sync'\n\nconst DAY_MS = 86_400_000\n\nexport type SyncRow = { source: string; date: Date; syncedAt: Date } & Partial<\n\tRecord<SyncMetric, number>\n>\n\nexport interface SyncTaskOptions {\n\tcron: string\n\tlookbackDays: number\n\tcollectionSlug: string\n\tadapterIds?: string[]\n}\n\n/**\n * Map one daily `AnalyticsRow` to a sync-collection doc: the row's UTC-day timestamp becomes\n * `date`, each present numeric metric is copied, absent metrics are omitted (stored null).\n * Returns null when the row has no usable timestamp, so a malformed row is skipped not written.\n */\nexport const toSyncRow = (source: string, row: AnalyticsRow, syncedAt: Date): SyncRow | null => {\n\tif (!row.timestamp) {\n\t\treturn null\n\t}\n\tconst date = new Date(row.timestamp)\n\tif (Number.isNaN(date.getTime())) {\n\t\treturn null\n\t}\n\tconst doc: SyncRow = { source, date, syncedAt }\n\tfor (const metric of METRIC_FIELDS) {\n\t\tconst value = row.metrics[metric]\n\t\tif (typeof value === 'number') {\n\t\t\tdoc[metric] = value\n\t\t}\n\t}\n\treturn doc\n}\n\nconst startOfUtcDay = (d: Date): Date =>\n\tnew Date(Date.UTC(d.getUTCFullYear(), d.getUTCMonth(), d.getUTCDate()))\n\nconst upsertDailyRow = async (\n\treq: PayloadRequest,\n\tcollectionSlug: string,\n\trow: SyncRow\n): Promise<void> => {\n\tconst existing = await req.payload.find({\n\t\tcollection: collectionSlug as never,\n\t\twhere: {\n\t\t\tand: [{ source: { equals: row.source } }, { date: { equals: row.date.toISOString() } }],\n\t\t},\n\t\tlimit: 1,\n\t\tdepth: 0,\n\t\toverrideAccess: true,\n\t})\n\tconst found = existing.docs[0] as { id: string | number } | undefined\n\tif (found) {\n\t\tawait req.payload.update({\n\t\t\tcollection: collectionSlug as never,\n\t\t\tid: found.id,\n\t\t\tdata: row as never,\n\t\t\toverrideAccess: true,\n\t\t})\n\t\treturn\n\t}\n\tawait req.payload.create({\n\t\tcollection: collectionSlug as never,\n\t\tdata: row as never,\n\t\toverrideAccess: true,\n\t})\n}\n\n/**\n * Opt-in Payload task that ETLs each configured provider adapter's last `lookbackDays` of\n * daily metrics into the sync collection (one upserted row per source + day), reading\n * through the surfacing engine so the pull rides its queue / backoff / cache. Native is\n * excluded (its data already lives in the rollups collection); each provider runs in its\n * own try/catch so one failure does not abort the rest.\n */\nexport const syncTask = (\n\topts: SyncTaskOptions\n): TaskConfig<{ input: Record<string, never>; output: { synced: number; failed: number } }> => ({\n\tslug: SYNC_TASK_SLUG,\n\thandler: async ({ req }) => {\n\t\tconst runtime = getRuntime(req.payload)\n\t\tif (!runtime) {\n\t\t\treturn { output: { synced: 0, failed: 0 } }\n\t\t}\n\t\tconst now = new Date()\n\t\tconst dateRange = {\n\t\t\tstart: new Date(startOfUtcDay(now).getTime() - (opts.lookbackDays - 1) * DAY_MS),\n\t\t\tend: now,\n\t\t}\n\t\tlet synced = 0\n\t\tlet failed = 0\n\t\t// A job req may lack the request shape an app's scopeResolver expects;\n\t\t// degrade to the install scope rather than failing the whole run.\n\t\tconst scope = await resolveScopeFor(runtime, req).catch(() => null)\n\t\tconst registry = await resolveRegistryFor(runtime, { payload: req.payload, req, scope })\n\t\tfor (const adapter of registry.all()) {\n\t\t\tif (adapter.id === 'native') {\n\t\t\t\tcontinue\n\t\t\t}\n\t\t\tif (opts.adapterIds && !opts.adapterIds.includes(adapter.id)) {\n\t\t\t\tcontinue\n\t\t\t}\n\t\t\tif (!adapter.isConfigured() || !supportsGranularity(adapter.capabilities, 'day')) {\n\t\t\t\tcontinue\n\t\t\t}\n\t\t\tconst metrics = METRIC_FIELDS.filter((m) => adapter.capabilities.metrics.has(m))\n\t\t\tif (metrics.length === 0) {\n\t\t\t\tcontinue\n\t\t\t}\n\t\t\tlet result: AnalyticsResult\n\t\t\ttry {\n\t\t\t\tresult = await runtime.engine.read(adapter, {\n\t\t\t\t\tmetrics,\n\t\t\t\t\tdateRange,\n\t\t\t\t\tgranularity: 'day',\n\t\t\t\t\tscope: scope ?? undefined,\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 sync: adapter \"${adapter.id}\" read failed: ${String(err)}`\n\t\t\t\t)\n\t\t\t\tcontinue\n\t\t\t}\n\t\t\tfor (const row of result.rows) {\n\t\t\t\tconst doc = toSyncRow(adapter.id, row, now)\n\t\t\t\tif (!doc) {\n\t\t\t\t\tcontinue\n\t\t\t\t}\n\t\t\t\ttry {\n\t\t\t\t\tawait upsertDailyRow(req, opts.collectionSlug, doc)\n\t\t\t\t\tsynced++\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 sync: upsert for \"${adapter.id}\" on ${doc.date.toISOString()} 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: { synced, failed } }\n\t},\n\tschedule: [{ cron: opts.cron, queue: 'default' }],\n})\n"],"mappings":"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"}
1
+ {"version":3,"file":"syncTask.js","names":[],"sources":["../../src/sync/syncTask.ts"],"sourcesContent":["import type { PayloadRequest, TaskConfig } from 'payload'\nimport type { AnalyticsResult, AnalyticsRow } from '../core/contract'\nimport { supportsGranularity } from '../core/granularity'\nimport type { ScopesResolver } from '../core/options'\nimport { resolveScopeList } from '../core/scopeList'\nimport { getRuntime, resolveRegistryFor } from '../plugin/runtime'\nimport { METRIC_FIELDS, type SyncMetric } from './collection'\n\nexport const SYNC_TASK_SLUG = 'analytics-sync'\n\nconst DAY_MS = 86_400_000\n\nexport type SyncRow = { source: string; date: Date; syncedAt: Date; scope: string } & Partial<\n\tRecord<SyncMetric, number>\n>\n\nexport interface SyncTaskOptions {\n\tcron: string\n\tlookbackDays: number\n\tcollectionSlug: string\n\t/** Entries match a config adapter id exactly, and a runtime provider instance (`<provider>:<docId>`) by its provider type. */\n\tadapterIds?: string[]\n\t/** Tenant scopes to fan out over, in addition to the install-wide scope every run already covers. */\n\tscopes?: ScopesResolver\n}\n\n/**\n * Map one daily `AnalyticsRow` to a sync-collection doc: the row's UTC-day timestamp becomes\n * `date`, each present numeric metric is copied, absent metrics are omitted (stored null).\n * Returns null when the row has no usable timestamp, so a malformed row is skipped not written.\n */\nexport const toSyncRow = (\n\tsource: string,\n\trow: AnalyticsRow,\n\topts: { syncedAt: Date; scope?: string }\n): SyncRow | null => {\n\tif (!row.timestamp) {\n\t\treturn null\n\t}\n\tconst date = new Date(row.timestamp)\n\tif (Number.isNaN(date.getTime())) {\n\t\treturn null\n\t}\n\tconst doc: SyncRow = { source, date, syncedAt: opts.syncedAt, scope: opts.scope ?? '' }\n\tfor (const metric of METRIC_FIELDS) {\n\t\tconst value = row.metrics[metric]\n\t\tif (typeof value === 'number') {\n\t\t\tdoc[metric] = value\n\t\t}\n\t}\n\treturn doc\n}\n\n/**\n * True when `adapterIds` is unset, or `adapterId` is listed exactly, or (for a\n * runtime instance id shaped `<provider>:<docId>`) its provider type is listed.\n */\nexport const matchesAdapterFilter = (\n\tadapterIds: string[] | undefined,\n\tadapterId: string\n): boolean => {\n\tif (!adapterIds) {\n\t\treturn true\n\t}\n\tif (adapterIds.includes(adapterId)) {\n\t\treturn true\n\t}\n\treturn adapterIds.includes(adapterId.split(':')[0] ?? adapterId)\n}\n\nconst startOfUtcDay = (d: Date): Date =>\n\tnew Date(Date.UTC(d.getUTCFullYear(), d.getUTCMonth(), d.getUTCDate()))\n\nconst upsertDailyRow = async (\n\treq: PayloadRequest,\n\tcollectionSlug: string,\n\trow: SyncRow\n): Promise<void> => {\n\tconst existing = await req.payload.find({\n\t\tcollection: collectionSlug as never,\n\t\twhere: {\n\t\t\tand: [\n\t\t\t\t{ source: { equals: row.source } },\n\t\t\t\t{ date: { equals: row.date.toISOString() } },\n\t\t\t\t{ scope: { equals: row.scope } },\n\t\t\t],\n\t\t},\n\t\tlimit: 1,\n\t\tdepth: 0,\n\t\toverrideAccess: true,\n\t})\n\tconst found = existing.docs[0] as { id: string | number } | undefined\n\tif (found) {\n\t\tawait req.payload.update({\n\t\t\tcollection: collectionSlug as never,\n\t\t\tid: found.id,\n\t\t\tdata: row as never,\n\t\t\toverrideAccess: true,\n\t\t})\n\t\treturn\n\t}\n\tawait req.payload.create({\n\t\tcollection: collectionSlug as never,\n\t\tdata: row as never,\n\t\toverrideAccess: true,\n\t})\n}\n\n/**\n * Opt-in Payload task that ETLs each configured provider adapter's last `lookbackDays` of\n * daily metrics into the sync collection (one upserted row per scope + source + day),\n * reading through the surfacing engine so the pull rides its queue / backoff / cache.\n * Native is excluded (its data already lives in the rollups collection); each provider\n * runs in its own try/catch so one failure does not abort the rest. With `scopes`\n * configured, the whole per-adapter pull runs once per tenant scope (plus the\n * install-wide scope) so a multi-tenant install syncs every tenant, not just the null one.\n */\nexport const syncTask = (\n\topts: SyncTaskOptions\n): TaskConfig<{ input: Record<string, never>; output: { synced: number; failed: number } }> => ({\n\tslug: SYNC_TASK_SLUG,\n\thandler: async ({ req }) => {\n\t\tconst runtime = getRuntime(req.payload)\n\t\tif (!runtime) {\n\t\t\treturn { output: { synced: 0, failed: 0 } }\n\t\t}\n\t\tconst now = new Date()\n\t\tconst dateRange = {\n\t\t\tstart: new Date(startOfUtcDay(now).getTime() - (opts.lookbackDays - 1) * DAY_MS),\n\t\t\tend: now,\n\t\t}\n\t\tlet synced = 0\n\t\tlet failed = 0\n\t\tconst scopeList = await resolveScopeList(opts.scopes, req.payload)\n\t\tfor (const scope of scopeList) {\n\t\t\tlet registry: Awaited<ReturnType<typeof resolveRegistryFor>>\n\t\t\ttry {\n\t\t\t\tregistry = await resolveRegistryFor(runtime, { payload: req.payload, req, scope })\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 sync: registry resolution failed for scope \"${scope ?? 'install-wide'}\": ${String(err)}`\n\t\t\t\t)\n\t\t\t\tcontinue\n\t\t\t}\n\t\t\tfor (const adapter of registry.all()) {\n\t\t\t\tif (adapter.id === 'native') {\n\t\t\t\t\tcontinue\n\t\t\t\t}\n\t\t\t\tif (!matchesAdapterFilter(opts.adapterIds, adapter.id)) {\n\t\t\t\t\tcontinue\n\t\t\t\t}\n\t\t\t\t// A shared config adapter that cannot narrow its query to one tenant would\n\t\t\t\t// otherwise return install-wide totals here, which then get stamped as this\n\t\t\t\t// scope's row; skip it for every tenant pass, same as the read path's gate.\n\t\t\t\tif (\n\t\t\t\t\tscope !== null &&\n\t\t\t\t\truntime.configAdapterIds.has(adapter.id) &&\n\t\t\t\t\t!adapter.capabilities.scopedQueries\n\t\t\t\t) {\n\t\t\t\t\tcontinue\n\t\t\t\t}\n\t\t\t\tif (!adapter.isConfigured() || !supportsGranularity(adapter.capabilities, 'day')) {\n\t\t\t\t\tcontinue\n\t\t\t\t}\n\t\t\t\tconst metrics = METRIC_FIELDS.filter((m) => adapter.capabilities.metrics.has(m))\n\t\t\t\tif (metrics.length === 0) {\n\t\t\t\t\tcontinue\n\t\t\t\t}\n\t\t\t\tlet result: AnalyticsResult\n\t\t\t\ttry {\n\t\t\t\t\tresult = await runtime.engine.read(adapter, {\n\t\t\t\t\t\tmetrics,\n\t\t\t\t\t\tdateRange,\n\t\t\t\t\t\tgranularity: 'day',\n\t\t\t\t\t\tscope: scope ?? undefined,\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 sync: adapter \"${adapter.id}\" read failed (scope \"${scope ?? ''}\"): ${String(err)}`\n\t\t\t\t\t)\n\t\t\t\t\tcontinue\n\t\t\t\t}\n\t\t\t\tif (result.meta.stale) {\n\t\t\t\t\tfailed++\n\t\t\t\t\treq.payload.logger.warn(\n\t\t\t\t\t\t`analytics sync: adapter \"${adapter.id}\" read was stale-served, skipping sync (scope \"${scope ?? ''}\")`\n\t\t\t\t\t)\n\t\t\t\t\tcontinue\n\t\t\t\t}\n\t\t\t\tfor (const row of result.rows) {\n\t\t\t\t\tconst doc = toSyncRow(adapter.id, row, { syncedAt: now, scope: scope ?? '' })\n\t\t\t\t\tif (!doc) {\n\t\t\t\t\t\tcontinue\n\t\t\t\t\t}\n\t\t\t\t\ttry {\n\t\t\t\t\t\tawait upsertDailyRow(req, opts.collectionSlug, doc)\n\t\t\t\t\t\tsynced++\n\t\t\t\t\t} catch (err) {\n\t\t\t\t\t\tfailed++\n\t\t\t\t\t\treq.payload.logger.warn(\n\t\t\t\t\t\t\t`analytics sync: upsert for \"${adapter.id}\" on ${doc.date.toISOString()} failed: ${String(err)}`\n\t\t\t\t\t\t)\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\t\treturn { output: { synced, failed } }\n\t},\n\tschedule: [{ cron: opts.cron, queue: 'default' }],\n})\n"],"mappings":"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"}
@@ -9,6 +9,8 @@ interface MemoryEvent {
9
9
  interface MemoryAnalyticsAdapter extends AnalyticsAdapter {
10
10
  record(event: MemoryEvent): void;
11
11
  reset(): void;
12
+ /** Test seam for engine resilience: the next query() call rejects with err, then resets. */
13
+ failNext(err?: Error): void;
12
14
  }
13
15
  declare function memoryAdapter(): MemoryAnalyticsAdapter;
14
16
  //#endregion
@@ -1,9 +1,9 @@
1
+ import { ProviderHttpError } from "../adapters/http/fetchJson.js";
1
2
  //#region src/testing/memoryAdapter.ts
2
3
  const capabilities = {
3
4
  perPageQuery: true,
4
5
  realtime: true,
5
6
  realtimeWindowMinutes: 5,
6
- comparison: true,
7
7
  minGranularity: "minute",
8
8
  maxLookbackDays: null,
9
9
  metrics: new Set([
@@ -20,6 +20,8 @@ const capabilities = {
20
20
  "country",
21
21
  "device"
22
22
  ]),
23
+ filters: new Set(["page"]),
24
+ filterOperators: new Set(["eq"]),
23
25
  batchPageReport: true,
24
26
  rateLimit: null,
25
27
  recommendedTtl: {
@@ -29,8 +31,14 @@ const capabilities = {
29
31
  };
30
32
  function memoryAdapter() {
31
33
  const events = [];
34
+ let pendingFailure;
35
+ const matchesFilters = (e, q) => (q.filters ?? []).every((filter) => {
36
+ if (filter.dimension !== "page" || filter.operator !== "eq") return true;
37
+ return e.path === filter.value;
38
+ });
32
39
  const inRange = (e, q) => {
33
40
  if (q.path && e.path !== q.path) return false;
41
+ if (!matchesFilters(e, q)) return false;
34
42
  return e.timestamp >= q.dateRange.start && e.timestamp <= q.dateRange.end;
35
43
  };
36
44
  return {
@@ -44,7 +52,15 @@ function memoryAdapter() {
44
52
  reset: () => {
45
53
  events.length = 0;
46
54
  },
55
+ failNext: (err) => {
56
+ pendingFailure = err ?? new ProviderHttpError(500, "memory", "memory: injected failure");
57
+ },
47
58
  async query(q, _ctx) {
59
+ if (pendingFailure) {
60
+ const err = pendingFailure;
61
+ pendingFailure = void 0;
62
+ throw err;
63
+ }
48
64
  const matched = events.filter((e) => inRange(e, q));
49
65
  const countVisitors = (list) => new Set(list.map((e) => e.visitor ?? e.path + e.timestamp.toDateString())).size;
50
66
  if (q.granularity === "day") {
@@ -1 +1 @@
1
- {"version":3,"file":"memoryAdapter.js","names":[],"sources":["../../src/testing/memoryAdapter.ts"],"sourcesContent":["import type {\n\tAdapterContext,\n\tAnalyticsAdapter,\n\tAnalyticsCapabilities,\n\tAnalyticsQuery,\n\tAnalyticsResult,\n\tDimensionKey,\n\tMetricKey,\n} from '../core/contract'\n\ninterface MemoryEvent {\n\tpath: string\n\ttimestamp: Date\n\tvisitor?: string\n}\n\nconst metrics: ReadonlySet<MetricKey> = new Set([\n\t'pageviews',\n\t'visitors',\n\t'visits',\n\t'sessions',\n\t'bounceRate',\n\t'avgDuration',\n])\nconst dimensions: ReadonlySet<DimensionKey> = new Set(['page', 'referrer', 'country', 'device'])\n\nconst capabilities: AnalyticsCapabilities = {\n\tperPageQuery: true,\n\trealtime: true,\n\trealtimeWindowMinutes: 5,\n\tcomparison: true,\n\tminGranularity: 'minute',\n\tmaxLookbackDays: null,\n\tmetrics,\n\tdimensions,\n\tbatchPageReport: true,\n\trateLimit: null,\n\trecommendedTtl: { realtime: 300, aggregate: 3600 },\n}\n\nexport interface MemoryAnalyticsAdapter extends AnalyticsAdapter {\n\trecord(event: MemoryEvent): void\n\treset(): void\n}\n\nexport function memoryAdapter(): MemoryAnalyticsAdapter {\n\tconst events: MemoryEvent[] = []\n\n\tconst inRange = (e: MemoryEvent, q: AnalyticsQuery): boolean => {\n\t\tif (q.path && e.path !== q.path) return false\n\t\treturn e.timestamp >= q.dateRange.start && e.timestamp <= q.dateRange.end\n\t}\n\n\treturn {\n\t\tid: 'memory',\n\t\tlabel: 'In-memory (testing)',\n\t\tcapabilities,\n\t\tisConfigured: () => true,\n\t\trecord: (event) => {\n\t\t\tevents.push(event)\n\t\t},\n\t\treset: () => {\n\t\t\tevents.length = 0\n\t\t},\n\t\tasync query(q: AnalyticsQuery, _ctx: AdapterContext): Promise<AnalyticsResult> {\n\t\t\tconst matched = events.filter((e) => inRange(e, q))\n\t\t\tconst countVisitors = (list: MemoryEvent[]): number =>\n\t\t\t\tnew Set(list.map((e) => e.visitor ?? e.path + e.timestamp.toDateString())).size\n\t\t\tif (q.granularity === 'day') {\n\t\t\t\tconst byDay = new Map<string, MemoryEvent[]>()\n\t\t\t\tfor (const e of matched) {\n\t\t\t\t\tconst day = new Date(\n\t\t\t\t\t\tDate.UTC(\n\t\t\t\t\t\t\te.timestamp.getUTCFullYear(),\n\t\t\t\t\t\t\te.timestamp.getUTCMonth(),\n\t\t\t\t\t\t\te.timestamp.getUTCDate()\n\t\t\t\t\t\t)\n\t\t\t\t\t).toISOString()\n\t\t\t\t\tconst list = byDay.get(day) ?? []\n\t\t\t\t\tlist.push(e)\n\t\t\t\t\tbyDay.set(day, list)\n\t\t\t\t}\n\t\t\t\tconst rows = [...byDay.entries()]\n\t\t\t\t\t.sort(([a], [b]) => a.localeCompare(b))\n\t\t\t\t\t.map(([day, list]) => ({\n\t\t\t\t\t\ttimestamp: day,\n\t\t\t\t\t\tmetrics: { pageviews: list.length, visitors: countVisitors(list) },\n\t\t\t\t\t}))\n\t\t\t\treturn {\n\t\t\t\t\trows,\n\t\t\t\t\ttotals: { pageviews: matched.length, visitors: countVisitors(matched) },\n\t\t\t\t\tmeta: { provider: 'memory', fetchedAt: q.dateRange.end.toISOString() },\n\t\t\t\t}\n\t\t\t}\n\t\t\tconst pageviews = matched.length\n\t\t\tconst visitors = countVisitors(matched)\n\t\t\treturn {\n\t\t\t\trows: [{ metrics: { pageviews, visitors } }],\n\t\t\t\ttotals: { pageviews, visitors },\n\t\t\t\tmeta: { provider: 'memory', fetchedAt: q.dateRange.end.toISOString() },\n\t\t\t}\n\t\t},\n\t}\n}\n"],"mappings":";AA0BA,MAAM,eAAsC;CAC3C,cAAc;CACd,UAAU;CACV,uBAAuB;CACvB,YAAY;CACZ,gBAAgB;CAChB,iBAAiB;CACjB,SAAA,IAjB2C,IAAI;EAC/C;EACA;EACA;EACA;EACA;EACA;CACD,CAUO;CACN,YAAA,IAViD,IAAI;EAAC;EAAQ;EAAY;EAAW;CAAQ,CAUpF;CACT,iBAAiB;CACjB,WAAW;CACX,gBAAgB;EAAE,UAAU;EAAK,WAAW;CAAK;AAClD;AAOA,SAAgB,gBAAwC;CACvD,MAAM,SAAwB,CAAC;CAE/B,MAAM,WAAW,GAAgB,MAA+B;EAC/D,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,OAAO;EACxC,OAAO,EAAE,aAAa,EAAE,UAAU,SAAS,EAAE,aAAa,EAAE,UAAU;CACvE;CAEA,OAAO;EACN,IAAI;EACJ,OAAO;EACP;EACA,oBAAoB;EACpB,SAAS,UAAU;GAClB,OAAO,KAAK,KAAK;EAClB;EACA,aAAa;GACZ,OAAO,SAAS;EACjB;EACA,MAAM,MAAM,GAAmB,MAAgD;GAC9E,MAAM,UAAU,OAAO,QAAQ,MAAM,QAAQ,GAAG,CAAC,CAAC;GAClD,MAAM,iBAAiB,SACtB,IAAI,IAAI,KAAK,KAAK,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,UAAU,aAAa,CAAC,CAAC,EAAE;GAC5E,IAAI,EAAE,gBAAgB,OAAO;IAC5B,MAAM,wBAAQ,IAAI,IAA2B;IAC7C,KAAK,MAAM,KAAK,SAAS;KACxB,MAAM,MAAM,IAAI,KACf,KAAK,IACJ,EAAE,UAAU,eAAe,GAC3B,EAAE,UAAU,YAAY,GACxB,EAAE,UAAU,WAAW,CACxB,CACD,EAAE,YAAY;KACd,MAAM,OAAO,MAAM,IAAI,GAAG,KAAK,CAAC;KAChC,KAAK,KAAK,CAAC;KACX,MAAM,IAAI,KAAK,IAAI;IACpB;IAOA,OAAO;KACN,MAPY,CAAC,GAAG,MAAM,QAAQ,CAAC,EAC9B,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC,EACrC,KAAK,CAAC,KAAK,WAAW;MACtB,WAAW;MACX,SAAS;OAAE,WAAW,KAAK;OAAQ,UAAU,cAAc,IAAI;MAAE;KAClE,EAEG;KACH,QAAQ;MAAE,WAAW,QAAQ;MAAQ,UAAU,cAAc,OAAO;KAAE;KACtE,MAAM;MAAE,UAAU;MAAU,WAAW,EAAE,UAAU,IAAI,YAAY;KAAE;IACtE;GACD;GACA,MAAM,YAAY,QAAQ;GAC1B,MAAM,WAAW,cAAc,OAAO;GACtC,OAAO;IACN,MAAM,CAAC,EAAE,SAAS;KAAE;KAAW;IAAS,EAAE,CAAC;IAC3C,QAAQ;KAAE;KAAW;IAAS;IAC9B,MAAM;KAAE,UAAU;KAAU,WAAW,EAAE,UAAU,IAAI,YAAY;IAAE;GACtE;EACD;CACD;AACD"}
1
+ {"version":3,"file":"memoryAdapter.js","names":[],"sources":["../../src/testing/memoryAdapter.ts"],"sourcesContent":["import { ProviderHttpError } from '../adapters/http/fetchJson'\nimport type {\n\tAdapterContext,\n\tAnalyticsAdapter,\n\tAnalyticsCapabilities,\n\tAnalyticsQuery,\n\tAnalyticsResult,\n\tDimensionKey,\n\tMetricKey,\n} from '../core/contract'\n\ninterface MemoryEvent {\n\tpath: string\n\ttimestamp: Date\n\tvisitor?: string\n}\n\nconst metrics: ReadonlySet<MetricKey> = new Set([\n\t'pageviews',\n\t'visitors',\n\t'visits',\n\t'sessions',\n\t'bounceRate',\n\t'avgDuration',\n])\nconst dimensions: ReadonlySet<DimensionKey> = new Set(['page', 'referrer', 'country', 'device'])\n\nconst capabilities: AnalyticsCapabilities = {\n\tperPageQuery: true,\n\trealtime: true,\n\trealtimeWindowMinutes: 5,\n\tminGranularity: 'minute',\n\tmaxLookbackDays: null,\n\tmetrics,\n\tdimensions,\n\tfilters: new Set(['page']),\n\tfilterOperators: new Set(['eq']),\n\tbatchPageReport: true,\n\trateLimit: null,\n\trecommendedTtl: { realtime: 300, aggregate: 3600 },\n}\n\nexport interface MemoryAnalyticsAdapter extends AnalyticsAdapter {\n\trecord(event: MemoryEvent): void\n\treset(): void\n\t/** Test seam for engine resilience: the next query() call rejects with err, then resets. */\n\tfailNext(err?: Error): void\n}\n\nexport function memoryAdapter(): MemoryAnalyticsAdapter {\n\tconst events: MemoryEvent[] = []\n\tlet pendingFailure: Error | undefined\n\n\t// Only page has a backing MemoryEvent field; other declared dimensions drop as unsupported.\n\tconst matchesFilters = (e: MemoryEvent, q: AnalyticsQuery): boolean =>\n\t\t(q.filters ?? []).every((filter) => {\n\t\t\tif (filter.dimension !== 'page' || filter.operator !== 'eq') {\n\t\t\t\treturn true\n\t\t\t}\n\t\t\treturn e.path === filter.value\n\t\t})\n\n\tconst inRange = (e: MemoryEvent, q: AnalyticsQuery): boolean => {\n\t\tif (q.path && e.path !== q.path) return false\n\t\tif (!matchesFilters(e, q)) return false\n\t\treturn e.timestamp >= q.dateRange.start && e.timestamp <= q.dateRange.end\n\t}\n\n\treturn {\n\t\tid: 'memory',\n\t\tlabel: 'In-memory (testing)',\n\t\tcapabilities,\n\t\tisConfigured: () => true,\n\t\trecord: (event) => {\n\t\t\tevents.push(event)\n\t\t},\n\t\treset: () => {\n\t\t\tevents.length = 0\n\t\t},\n\t\tfailNext: (err) => {\n\t\t\tpendingFailure = err ?? new ProviderHttpError(500, 'memory', 'memory: injected failure')\n\t\t},\n\t\tasync query(q: AnalyticsQuery, _ctx: AdapterContext): Promise<AnalyticsResult> {\n\t\t\tif (pendingFailure) {\n\t\t\t\tconst err = pendingFailure\n\t\t\t\tpendingFailure = undefined\n\t\t\t\tthrow err\n\t\t\t}\n\t\t\tconst matched = events.filter((e) => inRange(e, q))\n\t\t\tconst countVisitors = (list: MemoryEvent[]): number =>\n\t\t\t\tnew Set(list.map((e) => e.visitor ?? e.path + e.timestamp.toDateString())).size\n\t\t\tif (q.granularity === 'day') {\n\t\t\t\tconst byDay = new Map<string, MemoryEvent[]>()\n\t\t\t\tfor (const e of matched) {\n\t\t\t\t\tconst day = new Date(\n\t\t\t\t\t\tDate.UTC(\n\t\t\t\t\t\t\te.timestamp.getUTCFullYear(),\n\t\t\t\t\t\t\te.timestamp.getUTCMonth(),\n\t\t\t\t\t\t\te.timestamp.getUTCDate()\n\t\t\t\t\t\t)\n\t\t\t\t\t).toISOString()\n\t\t\t\t\tconst list = byDay.get(day) ?? []\n\t\t\t\t\tlist.push(e)\n\t\t\t\t\tbyDay.set(day, list)\n\t\t\t\t}\n\t\t\t\tconst rows = [...byDay.entries()]\n\t\t\t\t\t.sort(([a], [b]) => a.localeCompare(b))\n\t\t\t\t\t.map(([day, list]) => ({\n\t\t\t\t\t\ttimestamp: day,\n\t\t\t\t\t\tmetrics: { pageviews: list.length, visitors: countVisitors(list) },\n\t\t\t\t\t}))\n\t\t\t\treturn {\n\t\t\t\t\trows,\n\t\t\t\t\ttotals: { pageviews: matched.length, visitors: countVisitors(matched) },\n\t\t\t\t\tmeta: { provider: 'memory', fetchedAt: q.dateRange.end.toISOString() },\n\t\t\t\t}\n\t\t\t}\n\t\t\tconst pageviews = matched.length\n\t\t\tconst visitors = countVisitors(matched)\n\t\t\treturn {\n\t\t\t\trows: [{ metrics: { pageviews, visitors } }],\n\t\t\t\ttotals: { pageviews, visitors },\n\t\t\t\tmeta: { provider: 'memory', fetchedAt: q.dateRange.end.toISOString() },\n\t\t\t}\n\t\t},\n\t}\n}\n"],"mappings":";;AA2BA,MAAM,eAAsC;CAC3C,cAAc;CACd,UAAU;CACV,uBAAuB;CACvB,gBAAgB;CAChB,iBAAiB;CACjB,SAAA,IAhB2C,IAAI;EAC/C;EACA;EACA;EACA;EACA;EACA;CACD,CASO;CACN,YAAA,IATiD,IAAI;EAAC;EAAQ;EAAY;EAAW;CAAQ,CASpF;CACT,SAAS,IAAI,IAAI,CAAC,MAAM,CAAC;CACzB,iBAAiB,IAAI,IAAI,CAAC,IAAI,CAAC;CAC/B,iBAAiB;CACjB,WAAW;CACX,gBAAgB;EAAE,UAAU;EAAK,WAAW;CAAK;AAClD;AASA,SAAgB,gBAAwC;CACvD,MAAM,SAAwB,CAAC;CAC/B,IAAI;CAGJ,MAAM,kBAAkB,GAAgB,OACtC,EAAE,WAAW,CAAC,GAAG,OAAO,WAAW;EACnC,IAAI,OAAO,cAAc,UAAU,OAAO,aAAa,MACtD,OAAO;EAER,OAAO,EAAE,SAAS,OAAO;CAC1B,CAAC;CAEF,MAAM,WAAW,GAAgB,MAA+B;EAC/D,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,OAAO;EACxC,IAAI,CAAC,eAAe,GAAG,CAAC,GAAG,OAAO;EAClC,OAAO,EAAE,aAAa,EAAE,UAAU,SAAS,EAAE,aAAa,EAAE,UAAU;CACvE;CAEA,OAAO;EACN,IAAI;EACJ,OAAO;EACP;EACA,oBAAoB;EACpB,SAAS,UAAU;GAClB,OAAO,KAAK,KAAK;EAClB;EACA,aAAa;GACZ,OAAO,SAAS;EACjB;EACA,WAAW,QAAQ;GAClB,iBAAiB,OAAO,IAAI,kBAAkB,KAAK,UAAU,0BAA0B;EACxF;EACA,MAAM,MAAM,GAAmB,MAAgD;GAC9E,IAAI,gBAAgB;IACnB,MAAM,MAAM;IACZ,iBAAiB,KAAA;IACjB,MAAM;GACP;GACA,MAAM,UAAU,OAAO,QAAQ,MAAM,QAAQ,GAAG,CAAC,CAAC;GAClD,MAAM,iBAAiB,SACtB,IAAI,IAAI,KAAK,KAAK,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,UAAU,aAAa,CAAC,CAAC,EAAE;GAC5E,IAAI,EAAE,gBAAgB,OAAO;IAC5B,MAAM,wBAAQ,IAAI,IAA2B;IAC7C,KAAK,MAAM,KAAK,SAAS;KACxB,MAAM,MAAM,IAAI,KACf,KAAK,IACJ,EAAE,UAAU,eAAe,GAC3B,EAAE,UAAU,YAAY,GACxB,EAAE,UAAU,WAAW,CACxB,CACD,EAAE,YAAY;KACd,MAAM,OAAO,MAAM,IAAI,GAAG,KAAK,CAAC;KAChC,KAAK,KAAK,CAAC;KACX,MAAM,IAAI,KAAK,IAAI;IACpB;IAOA,OAAO;KACN,MAPY,CAAC,GAAG,MAAM,QAAQ,CAAC,EAC9B,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC,EACrC,KAAK,CAAC,KAAK,WAAW;MACtB,WAAW;MACX,SAAS;OAAE,WAAW,KAAK;OAAQ,UAAU,cAAc,IAAI;MAAE;KAClE,EAEG;KACH,QAAQ;MAAE,WAAW,QAAQ;MAAQ,UAAU,cAAc,OAAO;KAAE;KACtE,MAAM;MAAE,UAAU;MAAU,WAAW,EAAE,UAAU,IAAI,YAAY;KAAE;IACtE;GACD;GACA,MAAM,YAAY,QAAQ;GAC1B,MAAM,WAAW,cAAc,OAAO;GACtC,OAAO;IACN,MAAM,CAAC,EAAE,SAAS;KAAE;KAAW;IAAS,EAAE,CAAC;IAC3C,QAAQ;KAAE;KAAW;IAAS;IAC9B,MAAM;KAAE,UAAU;KAAU,WAAW,EAAE,UAAU,IAAI,YAAY;IAAE;GACtE;EACD;CACD;AACD"}
@@ -45,22 +45,22 @@ const sameLocalDay = (date, ymd, tz) => {
45
45
  * offsets, so the candidate that still falls on `ymd` (the transition instant, local
46
46
  * 01:00) is taken instead of the refined one that fell back onto the previous day.
47
47
  */
48
- const zonedMidnight = (ymd, tz) => {
48
+ const startOfCalendarDayInTz = (ymd, tz = "UTC") => {
49
49
  const asUtc = Date.UTC(ymd.year, ymd.month - 1, ymd.day);
50
50
  const guess = new Date(asUtc - offsetMs(new Date(asUtc), tz));
51
51
  const refined = new Date(asUtc - offsetMs(guess, tz));
52
52
  if (sameLocalDay(refined, ymd, tz)) return refined;
53
53
  if (sameLocalDay(guess, ymd, tz)) return guess;
54
- return zonedMidnight(zonedParts(refined.getTime() > guess.getTime() ? refined : guess, tz), tz);
54
+ return startOfCalendarDayInTz(zonedParts(refined.getTime() > guess.getTime() ? refined : guess, tz), tz);
55
55
  };
56
56
  /** Start of `date`'s local day in `tz`. */
57
57
  const startOfDayInTz = (date, tz = "UTC") => {
58
- return zonedMidnight(zonedParts(date, tz), tz);
58
+ return startOfCalendarDayInTz(zonedParts(date, tz), tz);
59
59
  };
60
60
  /** Start of `date`'s local month in `tz`. */
61
61
  const startOfMonthInTz = (date, tz = "UTC") => {
62
62
  const p = zonedParts(date, tz);
63
- return zonedMidnight({
63
+ return startOfCalendarDayInTz({
64
64
  year: p.year,
65
65
  month: p.month,
66
66
  day: 1
@@ -68,7 +68,7 @@ const startOfMonthInTz = (date, tz = "UTC") => {
68
68
  };
69
69
  /** Start of `date`'s local year in `tz`. */
70
70
  const startOfYearInTz = (date, tz = "UTC") => {
71
- return zonedMidnight({
71
+ return startOfCalendarDayInTz({
72
72
  year: zonedParts(date, tz).year,
73
73
  month: 1,
74
74
  day: 1
@@ -95,6 +95,17 @@ const startOfWeekInTz = (date, tz = "UTC") => {
95
95
  };
96
96
  /** ISO string of `date`'s local day start in `tz`; the canonical day-bucket key. */
97
97
  const zonedDayIso = (date, tz = "UTC") => startOfDayInTz(date, tz).toISOString();
98
+ /**
99
+ * `date`'s local calendar date in `tz` as `YYYY-MM-DD`, the form day-granular provider APIs
100
+ * take. Not `zonedDayIso(...).slice(0, 10)`: that returns the UTC spelling of the local day
101
+ * start, which names the previous calendar day for every zone east of UTC.
102
+ */
103
+ const zonedCalendarDay = (date, tz = "UTC") => {
104
+ const p = zonedParts(date, tz);
105
+ const month = String(p.month).padStart(2, "0");
106
+ const day = String(p.day).padStart(2, "0");
107
+ return `${String(p.year).padStart(4, "0")}-${month}-${day}`;
108
+ };
98
109
  /** True when `tz` is a resolvable IANA identifier. */
99
110
  const isValidTimeZone = (tz) => {
100
111
  try {
@@ -105,6 +116,6 @@ const isValidTimeZone = (tz) => {
105
116
  }
106
117
  };
107
118
  //#endregion
108
- export { addDaysInTz, isValidTimeZone, startOfDayInTz, startOfMonthInTz, startOfWeekInTz, startOfYearInTz, zonedDayIso };
119
+ export { addDaysInTz, isValidTimeZone, startOfCalendarDayInTz, startOfDayInTz, startOfMonthInTz, startOfWeekInTz, startOfYearInTz, zonedCalendarDay, zonedDayIso };
109
120
 
110
121
  //# sourceMappingURL=tz.js.map