@10x-media/analytics 0.1.0-beta.0 → 0.1.0-beta.1

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 (262) hide show
  1. package/CHANGELOG.md +71 -0
  2. package/README.md +37 -357
  3. package/dist/adapters/ga4/ga4.d.ts +20 -0
  4. package/dist/adapters/ga4/ga4.js +177 -0
  5. package/dist/{fetchJson-DZb2_Puj.js → adapters/http/fetchJson.js} +2 -2
  6. package/dist/adapters/http/fetchJson.js.map +1 -0
  7. package/dist/adapters/plausible/plausible.d.ts +15 -0
  8. package/dist/adapters/plausible/plausible.js +143 -0
  9. package/dist/adapters/posthog/posthog.d.ts +23 -0
  10. package/dist/adapters/posthog/posthog.js +121 -0
  11. package/dist/adapters/posthog/posthog.js.map +1 -0
  12. package/dist/{series-zytbzPoc.js → adapters/series.js} +2 -2
  13. package/dist/adapters/series.js.map +1 -0
  14. package/dist/adapters/umami/umami.d.ts +18 -0
  15. package/dist/adapters/umami/umami.js +139 -0
  16. package/dist/binding/resolvePath.js +61 -0
  17. package/dist/binding/resolvePath.js.map +1 -0
  18. package/dist/binding/types.d.ts +53 -0
  19. package/dist/charts/BarList.d.ts +20 -0
  20. package/dist/charts/BarList.js +73 -0
  21. package/dist/charts/BarList.js.map +1 -0
  22. package/dist/charts/TrendChart.d.ts +25 -0
  23. package/dist/charts/TrendChart.js +186 -0
  24. package/dist/charts/TrendChart.js.map +1 -0
  25. package/dist/charts/bars.d.ts +9 -0
  26. package/dist/charts/bars.js +19 -0
  27. package/dist/charts/bars.js.map +1 -0
  28. package/dist/charts/bucket.js +79 -0
  29. package/dist/charts/bucket.js.map +1 -0
  30. package/dist/charts/spline.js +84 -0
  31. package/dist/charts/spline.js.map +1 -0
  32. package/dist/charts/styles.js +42 -0
  33. package/dist/charts/styles.js.map +1 -0
  34. package/dist/core/cacheKey.js +31 -0
  35. package/dist/core/cacheKey.js.map +1 -0
  36. package/dist/core/capabilities.d.ts +12 -0
  37. package/dist/core/capabilities.js +12 -0
  38. package/dist/core/capabilities.js.map +1 -0
  39. package/dist/{contract-CWZPKWuR.d.ts → core/contract.d.ts} +30 -4
  40. package/dist/core/contract.js +10 -0
  41. package/dist/core/contract.js.map +1 -0
  42. package/dist/core/granularity.js +17 -0
  43. package/dist/core/granularity.js.map +1 -0
  44. package/dist/core/options.d.ts +115 -0
  45. package/dist/core/options.js +107 -0
  46. package/dist/core/options.js.map +1 -0
  47. package/dist/core/registry.js +24 -0
  48. package/dist/core/registry.js.map +1 -0
  49. package/dist/core/scopedRead.js +57 -0
  50. package/dist/core/scopedRead.js.map +1 -0
  51. package/dist/exports/adapters/ga4.d.ts +2 -20
  52. package/dist/exports/adapters/ga4.js +1 -176
  53. package/dist/exports/adapters/native.d.ts +2 -22
  54. package/dist/exports/adapters/native.js +1 -848
  55. package/dist/exports/adapters/plausible.d.ts +2 -15
  56. package/dist/exports/adapters/plausible.js +1 -142
  57. package/dist/exports/adapters/posthog.d.ts +2 -17
  58. package/dist/exports/adapters/posthog.js +1 -118
  59. package/dist/exports/adapters/umami.d.ts +2 -18
  60. package/dist/exports/adapters/umami.js +1 -138
  61. package/dist/exports/client.d.ts +5 -77
  62. package/dist/exports/client.js +4 -386
  63. package/dist/exports/geo.d.ts +4 -19
  64. package/dist/exports/geo.js +3 -1
  65. package/dist/exports/i18n.d.ts +3 -63
  66. package/dist/exports/i18n.js +2 -2
  67. package/dist/exports/next.d.ts +2 -0
  68. package/dist/exports/next.js +2 -0
  69. package/dist/exports/rsc.d.ts +13 -120
  70. package/dist/exports/rsc.js +10 -597
  71. package/dist/exports/types.d.ts +6 -4
  72. package/dist/exports/types.js +2 -1
  73. package/dist/fields/AnalyticsStatField.d.ts +31 -0
  74. package/dist/fields/AnalyticsStatField.js +93 -0
  75. package/dist/fields/AnalyticsStatField.js.map +1 -0
  76. package/dist/fields/dateRange/field.js +55 -0
  77. package/dist/fields/dateRange/field.js.map +1 -0
  78. package/dist/fields/dateRange/styles.js +23 -0
  79. package/dist/fields/dateRange/styles.js.map +1 -0
  80. package/dist/fields/dateRange/types.d.ts +11 -0
  81. package/dist/fields/dateRange/ui.d.ts +9 -0
  82. package/dist/fields/dateRange/ui.js +373 -0
  83. package/dist/fields/dateRange/ui.js.map +1 -0
  84. package/dist/fields/factories.d.ts +52 -0
  85. package/dist/fields/factories.js +65 -0
  86. package/dist/fields/factories.js.map +1 -0
  87. package/dist/fields/format.d.ts +7 -0
  88. package/dist/fields/format.js +22 -0
  89. package/dist/fields/format.js.map +1 -0
  90. package/dist/fields/readForDocument.js +107 -0
  91. package/dist/fields/readForDocument.js.map +1 -0
  92. package/dist/index.d.ts +18 -3
  93. package/dist/index.js +55 -1025
  94. package/dist/index.js.map +1 -1
  95. package/dist/native/collections/events.js +101 -0
  96. package/dist/native/collections/events.js.map +1 -0
  97. package/dist/native/collections/rollups.js +115 -0
  98. package/dist/native/collections/rollups.js.map +1 -0
  99. package/dist/native/collections/seen.js +47 -0
  100. package/dist/native/collections/seen.js.map +1 -0
  101. package/dist/native/geo/composeGeoResolvers.d.ts +7 -0
  102. package/dist/native/geo/composeGeoResolvers.js +14 -0
  103. package/dist/native/geo/composeGeoResolvers.js.map +1 -0
  104. package/dist/{geoResolver-CasIa4T9.d.ts → native/geo/geoResolver.d.ts} +2 -2
  105. package/dist/native/geo/geoResolver.js +11 -0
  106. package/dist/native/geo/geoResolver.js.map +1 -0
  107. package/dist/native/geo/maxmindResolver.d.ts +16 -0
  108. package/dist/native/geo/maxmindResolver.js +55 -0
  109. package/dist/native/geo/maxmindResolver.js.map +1 -0
  110. package/dist/native/ingest/device.js +15 -0
  111. package/dist/native/ingest/device.js.map +1 -0
  112. package/dist/native/ingest/endpoint.js +27 -0
  113. package/dist/native/ingest/endpoint.js.map +1 -0
  114. package/dist/native/ingest/flushBatch.js +69 -0
  115. package/dist/native/ingest/flushBatch.js.map +1 -0
  116. package/dist/native/ingest/normalizeEvent.js +38 -0
  117. package/dist/native/ingest/normalizeEvent.js.map +1 -0
  118. package/dist/native/ingest/salt.js +14 -0
  119. package/dist/native/ingest/salt.js.map +1 -0
  120. package/dist/native/ingest/source.js +22 -0
  121. package/dist/native/ingest/source.js.map +1 -0
  122. package/dist/native/ingest/visitorHash.js +12 -0
  123. package/dist/native/ingest/visitorHash.js.map +1 -0
  124. package/dist/native/ingest/writeBuffer.js +55 -0
  125. package/dist/native/ingest/writeBuffer.js.map +1 -0
  126. package/dist/native/ingest/writeEvent.js +13 -0
  127. package/dist/native/ingest/writeEvent.js.map +1 -0
  128. package/dist/native/nativeAdapter.d.ts +22 -0
  129. package/dist/native/nativeAdapter.js +213 -0
  130. package/dist/native/nativeAdapter.js.map +1 -0
  131. package/dist/native/realtime/buildRealtime.js +53 -0
  132. package/dist/native/realtime/buildRealtime.js.map +1 -0
  133. package/dist/native/retention/pruneTask.js +29 -0
  134. package/dist/native/retention/pruneTask.js.map +1 -0
  135. package/dist/native/rollupAcc.js +50 -0
  136. package/dist/native/rollupAcc.js.map +1 -0
  137. package/dist/native/rollups/applyDistinctDeltas.js +9 -0
  138. package/dist/native/rollups/applyDistinctDeltas.js.map +1 -0
  139. package/dist/native/rollups/bumpRollup.js +52 -0
  140. package/dist/native/rollups/bumpRollup.js.map +1 -0
  141. package/dist/native/rollups/deltas.js +31 -0
  142. package/dist/native/rollups/deltas.js.map +1 -0
  143. package/dist/native/rollups/insertIfNew.js +19 -0
  144. package/dist/native/rollups/insertIfNew.js.map +1 -0
  145. package/dist/next/posthogProxyRewrites.d.ts +36 -0
  146. package/dist/next/posthogProxyRewrites.js +50 -0
  147. package/dist/next/posthogProxyRewrites.js.map +1 -0
  148. package/dist/plugin/realtimeEndpoint.js +36 -0
  149. package/dist/plugin/realtimeEndpoint.js.map +1 -0
  150. package/dist/plugin/registerTranslations.js +19 -0
  151. package/dist/plugin/registerTranslations.js.map +1 -0
  152. package/dist/plugin/runtime.js +20 -0
  153. package/dist/plugin/runtime.js.map +1 -0
  154. package/dist/plugin/warmTask.js +165 -0
  155. package/dist/plugin/warmTask.js.map +1 -0
  156. package/dist/providers/collection.js +159 -0
  157. package/dist/providers/collection.js.map +1 -0
  158. package/dist/providers/factory.js +62 -0
  159. package/dist/providers/factory.js.map +1 -0
  160. package/dist/providers/resolver.js +67 -0
  161. package/dist/providers/resolver.js.map +1 -0
  162. package/dist/providers/secrets.js +27 -0
  163. package/dist/providers/secrets.js.map +1 -0
  164. package/dist/surfacing/cacheStore.js +26 -0
  165. package/dist/surfacing/cacheStore.js.map +1 -0
  166. package/dist/surfacing/coalesce.js +15 -0
  167. package/dist/surfacing/coalesce.js.map +1 -0
  168. package/dist/surfacing/engine.js +63 -0
  169. package/dist/surfacing/engine.js.map +1 -0
  170. package/dist/surfacing/queue.js +44 -0
  171. package/dist/surfacing/queue.js.map +1 -0
  172. package/dist/sync/collection.js +65 -0
  173. package/dist/sync/collection.js.map +1 -0
  174. package/dist/sync/syncTask.js +123 -0
  175. package/dist/sync/syncTask.js.map +1 -0
  176. package/dist/testing/memoryAdapter.d.ts +1 -1
  177. package/dist/timeframe/presets.d.ts +6 -0
  178. package/dist/timeframe/presets.js +63 -0
  179. package/dist/timeframe/presets.js.map +1 -0
  180. package/dist/{translations-keiKtSjF.js → translations/en.js} +25 -23
  181. package/dist/translations/en.js.map +1 -0
  182. package/dist/translations/index.d.ts +14 -0
  183. package/dist/translations/index.js +26 -0
  184. package/dist/translations/index.js.map +1 -0
  185. package/dist/translations/keys.d.ts +78 -0
  186. package/dist/{keys-DEqL4LOT.js → translations/keys.js} +24 -3
  187. package/dist/translations/keys.js.map +1 -0
  188. package/dist/translations/metricKeys.js +30 -0
  189. package/dist/translations/metricKeys.js.map +1 -0
  190. package/dist/translations/server.js +13 -0
  191. package/dist/translations/server.js.map +1 -0
  192. package/dist/translations/useTranslation.js +12 -0
  193. package/dist/translations/useTranslation.js.map +1 -0
  194. package/dist/widgets/AnalyticsBreakdownWidget.d.ts +7 -0
  195. package/dist/widgets/AnalyticsBreakdownWidget.js +85 -0
  196. package/dist/widgets/AnalyticsBreakdownWidget.js.map +1 -0
  197. package/dist/widgets/AnalyticsMetricWidget.d.ts +7 -0
  198. package/dist/widgets/AnalyticsMetricWidget.js +81 -0
  199. package/dist/widgets/AnalyticsMetricWidget.js.map +1 -0
  200. package/dist/widgets/AnalyticsRealtimeWidget.d.ts +7 -0
  201. package/dist/widgets/AnalyticsRealtimeWidget.js +64 -0
  202. package/dist/widgets/AnalyticsRealtimeWidget.js.map +1 -0
  203. package/dist/widgets/AnalyticsTrendWidget.d.ts +7 -0
  204. package/dist/widgets/AnalyticsTrendWidget.js +91 -0
  205. package/dist/widgets/AnalyticsTrendWidget.js.map +1 -0
  206. package/dist/widgets/RealtimeCounter.d.ts +19 -0
  207. package/dist/widgets/RealtimeCounter.js +76 -0
  208. package/dist/widgets/RealtimeCounter.js.map +1 -0
  209. package/dist/widgets/breakdownTypes.js +29 -0
  210. package/dist/widgets/breakdownTypes.js.map +1 -0
  211. package/dist/widgets/cardChrome.js +22 -0
  212. package/dist/widgets/cardChrome.js.map +1 -0
  213. package/dist/widgets/customWidget.d.ts +20 -0
  214. package/dist/widgets/customWidget.js +30 -0
  215. package/dist/widgets/customWidget.js.map +1 -0
  216. package/dist/widgets/defaults.d.ts +12 -0
  217. package/dist/widgets/defaults.js +72 -0
  218. package/dist/widgets/defaults.js.map +1 -0
  219. package/dist/widgets/range.js +28 -0
  220. package/dist/widgets/range.js.map +1 -0
  221. package/dist/widgets/readForWidget.d.ts +27 -0
  222. package/dist/widgets/readForWidget.js +57 -0
  223. package/dist/widgets/readForWidget.js.map +1 -0
  224. package/dist/widgets/readForWidgetBreakdown.d.ts +38 -0
  225. package/dist/widgets/readForWidgetBreakdown.js +75 -0
  226. package/dist/widgets/readForWidgetBreakdown.js.map +1 -0
  227. package/dist/{readForWidgetRealtime-D1BD37ST.d.ts → widgets/readForWidgetRealtime.d.ts} +5 -3
  228. package/dist/widgets/readForWidgetRealtime.js +63 -0
  229. package/dist/widgets/readForWidgetRealtime.js.map +1 -0
  230. package/dist/widgets/readForWidgetSeries.d.ts +38 -0
  231. package/dist/widgets/readForWidgetSeries.js +97 -0
  232. package/dist/widgets/readForWidgetSeries.js.map +1 -0
  233. package/dist/widgets/realtimePoll.js +26 -0
  234. package/dist/widgets/realtimePoll.js.map +1 -0
  235. package/dist/widgets/registerWidgets.js +249 -0
  236. package/dist/widgets/registerWidgets.js.map +1 -0
  237. package/dist/widgets/types.js +13 -0
  238. package/dist/widgets/types.js.map +1 -0
  239. package/package.json +16 -2
  240. package/dist/RealtimeCounter-BJrjMPSa.js +0 -473
  241. package/dist/RealtimeCounter-BJrjMPSa.js.map +0 -1
  242. package/dist/dist-B6HruP5v.js +0 -4731
  243. package/dist/dist-B6HruP5v.js.map +0 -1
  244. package/dist/exports/adapters/native.js.map +0 -1
  245. package/dist/exports/adapters/posthog.js.map +0 -1
  246. package/dist/exports/client.js.map +0 -1
  247. package/dist/exports/rsc.js.map +0 -1
  248. package/dist/fetchJson-DZb2_Puj.js.map +0 -1
  249. package/dist/index-CZdCT0WJ.d.ts +0 -98
  250. package/dist/keys-DEqL4LOT.js.map +0 -1
  251. package/dist/lib-CE5x1zLQ.js +0 -1058
  252. package/dist/lib-CE5x1zLQ.js.map +0 -1
  253. package/dist/maxmindResolver-CXYXXdul.js +0 -99
  254. package/dist/maxmindResolver-CXYXXdul.js.map +0 -1
  255. package/dist/presets-CBfq_uJX.d.ts +0 -38
  256. package/dist/series-zytbzPoc.js.map +0 -1
  257. package/dist/server-Cuvhgz-S.js +0 -492
  258. package/dist/server-Cuvhgz-S.js.map +0 -1
  259. package/dist/translations-keiKtSjF.js.map +0 -1
  260. /package/dist/{exports/adapters → adapters/ga4}/ga4.js.map +0 -0
  261. /package/dist/{exports/adapters → adapters/plausible}/plausible.js.map +0 -0
  262. /package/dist/{exports/adapters → adapters/umami}/umami.js.map +0 -0
@@ -0,0 +1 @@
1
+ {"version":3,"file":"options.js","names":[],"sources":["../../src/core/options.ts"],"sourcesContent":["import type { CollectionConfig, CollectionSlug, Payload, PayloadRequest } from 'payload'\nimport type { AnalyticsBinding, ResolvedBinding } from '../binding/types'\nimport { PROVIDERS_SLUG } from '../providers/collection'\nimport type { TranslationsOption } from '../translations'\nimport type { CustomWidgetDef } from '../widgets/customWidget'\nimport type { AnalyticsAdapter } from './contract'\n\nconst DEFAULT_WARM_CRON = '*/30 * * * *'\nconst DEFAULT_SYNC_CRON = '0 */6 * * *'\nconst DEFAULT_SYNC_COLLECTION = 'analytics-daily'\nconst DEFAULT_SYNC_LOOKBACK = 3\nconst DEFAULT_SCOPE_FIELD = 'scope'\n\n/**\n * Maps a request to its analytics boundary (tenant id, site key). Null means the\n * whole install, which is the default single-site behavior. With a multi-tenant\n * plugin, return the request's tenant id here.\n */\nexport type ScopeResolver = (args: {\n\treq: PayloadRequest\n}) => string | null | Promise<string | null>\n\n/**\n * Escape hatch replacing the provider-collection lookup: return the runtime\n * adapters for a scope yourself (any store, any shape). Results are layered onto\n * the static config adapters exactly like collection-resolved ones, but are not\n * cached; memoize inside the function if lookups are expensive.\n */\nexport type ProvidersResolve = (args: {\n\tpayload: Payload\n\treq?: PayloadRequest\n\tscope: string | null\n}) => AnalyticsAdapter[] | Promise<AnalyticsAdapter[]>\n\nexport type ProvidersCollectionOptions = {\n\tslug?: string\n\t/**\n\t * Field matched against the resolved scope when looking up a scope's providers.\n\t * Point it at a tenant plugin's field (e.g. 'tenant') when that plugin manages\n\t * scoping for the collection.\n\t */\n\tscopeField?: string\n\toverrides?: (collection: CollectionConfig) => CollectionConfig\n\taccess?: Partial<CollectionConfig['access']>\n}\n\nexport type ProvidersOptions = {\n\t/** Opt-in admin collection storing runtime provider configurations. */\n\tcollection?: boolean | ProvidersCollectionOptions\n\tresolve?: ProvidersResolve\n}\n\n/** Access checker for cross-scope (platform) analytics reads. */\nexport type PlatformReadAccess = (args: { req: PayloadRequest }) => boolean | Promise<boolean>\n\nexport type AnalyticsAccessOptions = {\n\t/**\n\t * Gates cross-scope reads: explicit `scope: '*'` reads, and scoped reads through\n\t * a platform adapter that cannot filter by scope. Defaults to any authenticated\n\t * admin-panel user.\n\t */\n\tplatformRead?: PlatformReadAccess\n}\n\nexport type AnalyticsPluginOptions = {\n\tdisabled?: boolean\n\t/**\n\t * Per-locale overrides for this plugin's UI strings, keyed by the typed\n\t * translation keys exported from `@10x-media/analytics/i18n`. Values win over\n\t * the built-in locales key-by-key; locales the plugin does not ship are added\n\t * whole. App-level `i18n.translations` still wins over both.\n\t */\n\ttranslations?: TranslationsOption\n\tadapters?: AnalyticsAdapter[]\n\tdefaultAdapter?: string\n\tscopeResolver?: ScopeResolver\n\tproviders?: ProvidersOptions\n\t/**\n\t * Id of one config adapter shared by every scope (the platform's own analytics,\n\t * e.g. a PostHog project capturing all tenants). Included in each scope's\n\t * registry like any config adapter; reads through it are scope-filtered only\n\t * when the adapter supports scoped queries, otherwise they are cross-scope and\n\t * require `access.platformRead`.\n\t */\n\tplatformAdapter?: string\n\taccess?: AnalyticsAccessOptions\n\t/**\n\t * Per-collection bindings, keyed by collection slug. With generated types\n\t * augmented, each slug's resolvers receive that collection's typed document.\n\t */\n\tcollections?: { [TSlug in CollectionSlug]?: AnalyticsBinding<TSlug> }\n\tcache?: { ttl?: { aggregate?: number; realtime?: number }; warm?: boolean | { cron?: string } }\n\twidgets?:\n\t\t| boolean\n\t\t| {\n\t\t\t\tdisabled?: string[]\n\t\t\t\tregister?: CustomWidgetDef[]\n\t\t\t\t/**\n\t\t\t\t * Marks the free-text widget config fields (each widget's Title) as\n\t\t\t\t * `localized`. Off by default; takes effect only when the Payload config\n\t\t\t\t * enables localization (Payload strips the flag otherwise).\n\t\t\t\t */\n\t\t\t\tlocalizeText?: boolean\n\t\t }\n\t/**\n\t * Opt-in sync tier: a cron job that persists each provider's daily metrics into a\n\t * queryable collection. Reads go through the surfacing cache, so persisted rows reflect\n\t * cached values up to `cache.ttl.aggregate` old; keep that TTL below the sync interval\n\t * for the freshest data.\n\t */\n\tsync?:\n\t\t| boolean\n\t\t| { collectionSlug?: CollectionSlug; cron?: string; lookbackDays?: number; adapters?: string[] }\n}\n\nexport interface ResolvedOptions {\n\tadapters: AnalyticsAdapter[]\n\tdefaultAdapter?: string\n\tscopeResolver: ScopeResolver\n\t/** True when the app configured a scopeResolver (scoped install). */\n\tscoped: boolean\n\tplatformAdapter?: string\n\taccess: { platformRead: PlatformReadAccess }\n\tproviders: {\n\t\tcollection: {\n\t\t\tenabled: boolean\n\t\t\tslug: string\n\t\t\tscopeField: string\n\t\t\toverrides?: (collection: CollectionConfig) => CollectionConfig\n\t\t\taccess?: Partial<CollectionConfig['access']>\n\t\t}\n\t\tresolve?: ProvidersResolve\n\t}\n\tbindings: Record<string, ResolvedBinding>\n\tcache: { ttl: { aggregate: number; realtime: number }; warm: { enabled: boolean; cron: string } }\n\twidgets: {\n\t\tenabled: boolean\n\t\tdisabled: string[]\n\t\tregister: CustomWidgetDef[]\n\t\tlocalizeText: boolean\n\t}\n\tsync: {\n\t\tenabled: boolean\n\t\tcollectionSlug: string\n\t\tcron: string\n\t\tlookbackDays: number\n\t\tadapters?: string[]\n\t}\n}\n\nconst resolveBindings = (\n\tcollections: AnalyticsPluginOptions['collections']\n): Record<string, ResolvedBinding> => {\n\tconst out: Record<string, ResolvedBinding> = {}\n\tfor (const [slug, binding] of Object.entries(collections ?? {})) {\n\t\tif (!binding) continue\n\t\tif (!binding.path && !binding.pathField) {\n\t\t\tthrow new Error(`analytics: binding for \"${slug}\" needs a path resolver or a pathField`)\n\t\t}\n\t\t// Erases the per-slug doc generic; safe because the runtime only ever hands\n\t\t// a binding documents from its own collection.\n\t\tout[slug] = binding as ResolvedBinding\n\t}\n\treturn out\n}\n\nexport function resolveOptions(options: AnalyticsPluginOptions): ResolvedOptions {\n\tif (!options.adapters || options.adapters.length === 0) {\n\t\tthrow new Error('analytics: at least one adapter is required')\n\t}\n\tif (\n\t\toptions.platformAdapter !== undefined &&\n\t\t!options.adapters.some((a) => a.id === options.platformAdapter)\n\t) {\n\t\tthrow new Error(`analytics: unknown platform adapter \"${options.platformAdapter}\"`)\n\t}\n\tconst widgets =\n\t\toptions.widgets === false\n\t\t\t? {\n\t\t\t\t\tenabled: false,\n\t\t\t\t\tdisabled: [] as string[],\n\t\t\t\t\tregister: [] as CustomWidgetDef[],\n\t\t\t\t\tlocalizeText: false,\n\t\t\t\t}\n\t\t\t: options.widgets === undefined || options.widgets === true\n\t\t\t\t? {\n\t\t\t\t\t\tenabled: true,\n\t\t\t\t\t\tdisabled: [] as string[],\n\t\t\t\t\t\tregister: [] as CustomWidgetDef[],\n\t\t\t\t\t\tlocalizeText: false,\n\t\t\t\t\t}\n\t\t\t\t: {\n\t\t\t\t\t\tenabled: true,\n\t\t\t\t\t\tdisabled: options.widgets.disabled ?? [],\n\t\t\t\t\t\tregister: options.widgets.register ?? [],\n\t\t\t\t\t\tlocalizeText: options.widgets.localizeText ?? false,\n\t\t\t\t\t}\n\tconst warmOpt = options.cache?.warm\n\tconst warm =\n\t\twarmOpt === true\n\t\t\t? { enabled: true, cron: DEFAULT_WARM_CRON }\n\t\t\t: warmOpt && typeof warmOpt === 'object'\n\t\t\t\t? { enabled: true, cron: warmOpt.cron ?? DEFAULT_WARM_CRON }\n\t\t\t\t: { enabled: false, cron: DEFAULT_WARM_CRON }\n\tconst collectionOpt = options.providers?.collection\n\tconst providers = {\n\t\tcollection:\n\t\t\tcollectionOpt === true\n\t\t\t\t? { enabled: true, slug: PROVIDERS_SLUG, scopeField: DEFAULT_SCOPE_FIELD }\n\t\t\t\t: collectionOpt && typeof collectionOpt === 'object'\n\t\t\t\t\t? {\n\t\t\t\t\t\t\tenabled: true,\n\t\t\t\t\t\t\tslug: collectionOpt.slug ?? PROVIDERS_SLUG,\n\t\t\t\t\t\t\tscopeField: collectionOpt.scopeField ?? DEFAULT_SCOPE_FIELD,\n\t\t\t\t\t\t\toverrides: collectionOpt.overrides,\n\t\t\t\t\t\t\taccess: collectionOpt.access,\n\t\t\t\t\t\t}\n\t\t\t\t\t: { enabled: false, slug: PROVIDERS_SLUG, scopeField: DEFAULT_SCOPE_FIELD },\n\t\tresolve: options.providers?.resolve,\n\t}\n\tconst syncOpt = options.sync\n\tconst sync =\n\t\tsyncOpt === true\n\t\t\t? {\n\t\t\t\t\tenabled: true,\n\t\t\t\t\tcollectionSlug: DEFAULT_SYNC_COLLECTION,\n\t\t\t\t\tcron: DEFAULT_SYNC_CRON,\n\t\t\t\t\tlookbackDays: DEFAULT_SYNC_LOOKBACK,\n\t\t\t\t}\n\t\t\t: syncOpt && typeof syncOpt === 'object'\n\t\t\t\t? {\n\t\t\t\t\t\tenabled: true,\n\t\t\t\t\t\tcollectionSlug: syncOpt.collectionSlug ?? DEFAULT_SYNC_COLLECTION,\n\t\t\t\t\t\tcron: syncOpt.cron ?? DEFAULT_SYNC_CRON,\n\t\t\t\t\t\tlookbackDays: syncOpt.lookbackDays ?? DEFAULT_SYNC_LOOKBACK,\n\t\t\t\t\t\tadapters: syncOpt.adapters,\n\t\t\t\t\t}\n\t\t\t\t: {\n\t\t\t\t\t\tenabled: false,\n\t\t\t\t\t\tcollectionSlug: DEFAULT_SYNC_COLLECTION,\n\t\t\t\t\t\tcron: DEFAULT_SYNC_CRON,\n\t\t\t\t\t\tlookbackDays: DEFAULT_SYNC_LOOKBACK,\n\t\t\t\t\t}\n\treturn {\n\t\tadapters: options.adapters,\n\t\tdefaultAdapter: options.defaultAdapter,\n\t\tscopeResolver: options.scopeResolver ?? (() => null),\n\t\tscoped: options.scopeResolver !== undefined,\n\t\tplatformAdapter: options.platformAdapter,\n\t\taccess: { platformRead: options.access?.platformRead ?? (({ req }) => Boolean(req.user)) },\n\t\tproviders,\n\t\tbindings: resolveBindings(options.collections),\n\t\tcache: {\n\t\t\tttl: {\n\t\t\t\taggregate: options.cache?.ttl?.aggregate ?? 3600,\n\t\t\t\trealtime: options.cache?.ttl?.realtime ?? 300,\n\t\t\t},\n\t\t\twarm,\n\t\t},\n\t\twidgets,\n\t\tsync,\n\t}\n}\n"],"mappings":";;AAOA,MAAM,oBAAoB;AAC1B,MAAM,oBAAoB;AAC1B,MAAM,0BAA0B;AAChC,MAAM,wBAAwB;AAC9B,MAAM,sBAAsB;AA2I5B,MAAM,mBACL,gBACqC;CACrC,MAAM,MAAuC,CAAC;CAC9C,KAAK,MAAM,CAAC,MAAM,YAAY,OAAO,QAAQ,eAAe,CAAC,CAAC,GAAG;EAChE,IAAI,CAAC,SAAS;EACd,IAAI,CAAC,QAAQ,QAAQ,CAAC,QAAQ,WAC7B,MAAM,IAAI,MAAM,2BAA2B,KAAK,uCAAuC;EAIxF,IAAI,QAAQ;CACb;CACA,OAAO;AACR;AAEA,SAAgB,eAAe,SAAkD;CAChF,IAAI,CAAC,QAAQ,YAAY,QAAQ,SAAS,WAAW,GACpD,MAAM,IAAI,MAAM,6CAA6C;CAE9D,IACC,QAAQ,oBAAoB,KAAA,KAC5B,CAAC,QAAQ,SAAS,MAAM,MAAM,EAAE,OAAO,QAAQ,eAAe,GAE9D,MAAM,IAAI,MAAM,wCAAwC,QAAQ,gBAAgB,EAAE;CAEnF,MAAM,UACL,QAAQ,YAAY,QACjB;EACA,SAAS;EACT,UAAU,CAAC;EACX,UAAU,CAAC;EACX,cAAc;CACf,IACC,QAAQ,YAAY,KAAA,KAAa,QAAQ,YAAY,OACpD;EACA,SAAS;EACT,UAAU,CAAC;EACX,UAAU,CAAC;EACX,cAAc;CACf,IACC;EACA,SAAS;EACT,UAAU,QAAQ,QAAQ,YAAY,CAAC;EACvC,UAAU,QAAQ,QAAQ,YAAY,CAAC;EACvC,cAAc,QAAQ,QAAQ,gBAAgB;CAC/C;CACJ,MAAM,UAAU,QAAQ,OAAO;CAC/B,MAAM,OACL,YAAY,OACT;EAAE,SAAS;EAAM,MAAM;CAAkB,IACzC,WAAW,OAAO,YAAY,WAC7B;EAAE,SAAS;EAAM,MAAM,QAAQ,QAAQ;CAAkB,IACzD;EAAE,SAAS;EAAO,MAAM;CAAkB;CAC/C,MAAM,gBAAgB,QAAQ,WAAW;CACzC,MAAM,YAAY;EACjB,YACC,kBAAkB,OACf;GAAE,SAAS;GAAM,MAAM;GAAgB,YAAY;EAAoB,IACvE,iBAAiB,OAAO,kBAAkB,WACzC;GACA,SAAS;GACT,MAAM,cAAc,QAAA;GACpB,YAAY,cAAc,cAAc;GACxC,WAAW,cAAc;GACzB,QAAQ,cAAc;EACvB,IACC;GAAE,SAAS;GAAO,MAAM;GAAgB,YAAY;EAAoB;EAC7E,SAAS,QAAQ,WAAW;CAC7B;CACA,MAAM,UAAU,QAAQ;CACxB,MAAM,OACL,YAAY,OACT;EACA,SAAS;EACT,gBAAgB;EAChB,MAAM;EACN,cAAc;CACf,IACC,WAAW,OAAO,YAAY,WAC7B;EACA,SAAS;EACT,gBAAgB,QAAQ,kBAAkB;EAC1C,MAAM,QAAQ,QAAQ;EACtB,cAAc,QAAQ,gBAAgB;EACtC,UAAU,QAAQ;CACnB,IACC;EACA,SAAS;EACT,gBAAgB;EAChB,MAAM;EACN,cAAc;CACf;CACJ,OAAO;EACN,UAAU,QAAQ;EAClB,gBAAgB,QAAQ;EACxB,eAAe,QAAQ,wBAAwB;EAC/C,QAAQ,QAAQ,kBAAkB,KAAA;EAClC,iBAAiB,QAAQ;EACzB,QAAQ,EAAE,cAAc,QAAQ,QAAQ,kBAAkB,EAAE,UAAU,QAAQ,IAAI,IAAI,GAAG;EACzF;EACA,UAAU,gBAAgB,QAAQ,WAAW;EAC7C,OAAO;GACN,KAAK;IACJ,WAAW,QAAQ,OAAO,KAAK,aAAa;IAC5C,UAAU,QAAQ,OAAO,KAAK,YAAY;GAC3C;GACA;EACD;EACA;EACA;CACD;AACD"}
@@ -0,0 +1,24 @@
1
+ //#region src/core/registry.ts
2
+ /** Wrap a config-time registry as a resolver: every scope sees the same adapters. */
3
+ const staticRegistryResolver = (registry) => () => Promise.resolve(registry);
4
+ function createRegistry(adapters, defaultId) {
5
+ if (adapters.length === 0) throw new Error("analytics: at least one adapter is required");
6
+ const first = adapters[0];
7
+ const byId = new Map(adapters.map((a) => [a.id, a]));
8
+ if (defaultId !== void 0 && !byId.has(defaultId)) throw new Error(`analytics: unknown default adapter "${defaultId}"`);
9
+ const fallback = defaultId ?? first.id;
10
+ return {
11
+ get(id) {
12
+ const a = byId.get(id);
13
+ if (!a) throw new Error(`analytics: unknown adapter "${id}"`);
14
+ return a;
15
+ },
16
+ default: () => byId.get(fallback) ?? first,
17
+ all: () => adapters,
18
+ isMultiProvider: () => adapters.length > 1
19
+ };
20
+ }
21
+ //#endregion
22
+ export { createRegistry, staticRegistryResolver };
23
+
24
+ //# sourceMappingURL=registry.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"registry.js","names":[],"sources":["../../src/core/registry.ts"],"sourcesContent":["import type { Payload, PayloadRequest } from 'payload'\nimport type { AnalyticsAdapter } from './contract'\n\nexport interface AdapterRegistry {\n\tget(id: string): AnalyticsAdapter\n\tdefault(): AnalyticsAdapter\n\tall(): AnalyticsAdapter[]\n\tisMultiProvider(): boolean\n}\n\nexport type ResolveRegistryArgs = {\n\tpayload: Payload\n\treq?: PayloadRequest\n\t/** The analytics boundary to resolve adapters for; null is the whole install. */\n\tscope: string | null\n}\n\n/**\n * The seam every read path resolves its adapters through. The static config\n * registry is the base for all scopes; runtime provider sources (collection,\n * `providers.resolve`) layer per-scope adapters on top of it.\n */\nexport type RegistryResolver = (args: ResolveRegistryArgs) => Promise<AdapterRegistry>\n\n/** Wrap a config-time registry as a resolver: every scope sees the same adapters. */\nexport const staticRegistryResolver =\n\t(registry: AdapterRegistry): RegistryResolver =>\n\t() =>\n\t\tPromise.resolve(registry)\n\nexport function createRegistry(adapters: AnalyticsAdapter[], defaultId?: string): AdapterRegistry {\n\tif (adapters.length === 0) throw new Error('analytics: at least one adapter is required')\n\tconst first = adapters[0] as AnalyticsAdapter\n\tconst byId = new Map(adapters.map((a) => [a.id, a]))\n\tif (defaultId !== undefined && !byId.has(defaultId)) {\n\t\tthrow new Error(`analytics: unknown default adapter \"${defaultId}\"`)\n\t}\n\tconst fallback = defaultId ?? first.id\n\treturn {\n\t\tget(id) {\n\t\t\tconst a = byId.get(id)\n\t\t\tif (!a) throw new Error(`analytics: unknown adapter \"${id}\"`)\n\t\t\treturn a\n\t\t},\n\t\tdefault: () => byId.get(fallback) ?? first,\n\t\tall: () => adapters,\n\t\tisMultiProvider: () => adapters.length > 1,\n\t}\n}\n"],"mappings":";;AAyBA,MAAa,0BACX,mBAEA,QAAQ,QAAQ,QAAQ;AAE1B,SAAgB,eAAe,UAA8B,WAAqC;CACjG,IAAI,SAAS,WAAW,GAAG,MAAM,IAAI,MAAM,6CAA6C;CACxF,MAAM,QAAQ,SAAS;CACvB,MAAM,OAAO,IAAI,IAAI,SAAS,KAAK,MAAM,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC;CACnD,IAAI,cAAc,KAAA,KAAa,CAAC,KAAK,IAAI,SAAS,GACjD,MAAM,IAAI,MAAM,uCAAuC,UAAU,EAAE;CAEpE,MAAM,WAAW,aAAa,MAAM;CACpC,OAAO;EACN,IAAI,IAAI;GACP,MAAM,IAAI,KAAK,IAAI,EAAE;GACrB,IAAI,CAAC,GAAG,MAAM,IAAI,MAAM,+BAA+B,GAAG,EAAE;GAC5D,OAAO;EACR;EACA,eAAe,KAAK,IAAI,QAAQ,KAAK;EACrC,WAAW;EACX,uBAAuB,SAAS,SAAS;CAC1C;AACD"}
@@ -0,0 +1,57 @@
1
+ import { platformReadFor, resolveRegistryFor, resolveScopeFor } from "../plugin/runtime.js";
2
+ import "./contract.js";
3
+ //#region src/core/scopedRead.ts
4
+ /**
5
+ * Resolve one read's scope and adapter: explicit scope wins over the request's
6
+ * resolved scope, the registry is resolved per scope, then the adapter is picked
7
+ * by id (or the registry default). Cross-scope reads fail closed behind
8
+ * `platformRead`: an explicit `'*'` scope always, and a scoped read through the
9
+ * platform adapter when it cannot narrow the query to one scope. Any resolution
10
+ * failure (unknown adapter id, a throwing scopeResolver or provider lookup)
11
+ * degrades to `{ ok: false }` so read paths render their unavailable state
12
+ * instead of throwing.
13
+ */
14
+ const resolveReadContext = async (args) => {
15
+ const { runtime, req, adapterId } = args;
16
+ try {
17
+ const scope = args.scope !== void 0 ? args.scope : await resolveScopeFor(runtime, req);
18
+ const registryScope = scope === "*" ? null : scope;
19
+ const registry = await resolveRegistryFor(runtime, {
20
+ payload: req.payload,
21
+ req,
22
+ scope: registryScope
23
+ });
24
+ const adapter = adapterId ? registry.get(adapterId) : registry.default();
25
+ if (scope === "*") {
26
+ if (!await platformReadFor(runtime, req)) return { ok: false };
27
+ return {
28
+ ok: true,
29
+ adapter,
30
+ scope: null,
31
+ queryScope: void 0
32
+ };
33
+ }
34
+ if (scope !== null && adapter.id === runtime.platformAdapterId && !adapter.capabilities.scopedQueries) {
35
+ if (!await platformReadFor(runtime, req)) return { ok: false };
36
+ return {
37
+ ok: true,
38
+ adapter,
39
+ scope,
40
+ queryScope: void 0
41
+ };
42
+ }
43
+ return {
44
+ ok: true,
45
+ adapter,
46
+ scope,
47
+ queryScope: scope ?? void 0
48
+ };
49
+ } catch (err) {
50
+ req.payload.logger?.warn(`analytics: read context resolution failed: ${String(err)}`);
51
+ return { ok: false };
52
+ }
53
+ };
54
+ //#endregion
55
+ export { resolveReadContext };
56
+
57
+ //# sourceMappingURL=scopedRead.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"scopedRead.js","names":[],"sources":["../../src/core/scopedRead.ts"],"sourcesContent":["import type { PayloadRequest } from 'payload'\nimport {\n\ttype AnalyticsRuntime,\n\tplatformReadFor,\n\tresolveRegistryFor,\n\tresolveScopeFor,\n} from '../plugin/runtime'\nimport { type AnalyticsAdapter, PLATFORM_SCOPE } from './contract'\n\nexport type ReadContext =\n\t| {\n\t\t\tok: true\n\t\t\tadapter: AnalyticsAdapter\n\t\t\tscope: string | null\n\t\t\t/** The scope to stamp on the adapter query; undefined for install-wide reads. */\n\t\t\tqueryScope?: string\n\t }\n\t| { ok: false }\n\nexport interface ResolveReadContextArgs {\n\truntime: AnalyticsRuntime\n\treq: PayloadRequest\n\tadapterId?: string\n\t/** Explicit scope override; undefined resolves via the plugin's scopeResolver. */\n\tscope?: string | null\n}\n\n/**\n * Resolve one read's scope and adapter: explicit scope wins over the request's\n * resolved scope, the registry is resolved per scope, then the adapter is picked\n * by id (or the registry default). Cross-scope reads fail closed behind\n * `platformRead`: an explicit `'*'` scope always, and a scoped read through the\n * platform adapter when it cannot narrow the query to one scope. Any resolution\n * failure (unknown adapter id, a throwing scopeResolver or provider lookup)\n * degrades to `{ ok: false }` so read paths render their unavailable state\n * instead of throwing.\n */\nexport const resolveReadContext = async (args: ResolveReadContextArgs): Promise<ReadContext> => {\n\tconst { runtime, req, adapterId } = args\n\ttry {\n\t\tconst scope = args.scope !== undefined ? args.scope : await resolveScopeFor(runtime, req)\n\t\tconst registryScope = scope === PLATFORM_SCOPE ? null : scope\n\t\tconst registry = await resolveRegistryFor(runtime, {\n\t\t\tpayload: req.payload,\n\t\t\treq,\n\t\t\tscope: registryScope,\n\t\t})\n\t\tconst adapter = adapterId ? registry.get(adapterId) : registry.default()\n\t\tif (scope === PLATFORM_SCOPE) {\n\t\t\tif (!(await platformReadFor(runtime, req))) {\n\t\t\t\treturn { ok: false }\n\t\t\t}\n\t\t\treturn { ok: true, adapter, scope: null, queryScope: undefined }\n\t\t}\n\t\tif (\n\t\t\tscope !== null &&\n\t\t\tadapter.id === runtime.platformAdapterId &&\n\t\t\t!adapter.capabilities.scopedQueries\n\t\t) {\n\t\t\tif (!(await platformReadFor(runtime, req))) {\n\t\t\t\treturn { ok: false }\n\t\t\t}\n\t\t\treturn { ok: true, adapter, scope, queryScope: undefined }\n\t\t}\n\t\treturn { ok: true, adapter, scope, queryScope: scope ?? undefined }\n\t} catch (err) {\n\t\treq.payload.logger?.warn(`analytics: read context resolution failed: ${String(err)}`)\n\t\treturn { ok: false }\n\t}\n}\n"],"mappings":";;;;;;;;;;;;;AAqCA,MAAa,qBAAqB,OAAO,SAAuD;CAC/F,MAAM,EAAE,SAAS,KAAK,cAAc;CACpC,IAAI;EACH,MAAM,QAAQ,KAAK,UAAU,KAAA,IAAY,KAAK,QAAQ,MAAM,gBAAgB,SAAS,GAAG;EACxF,MAAM,gBAAgB,UAAA,MAA2B,OAAO;EACxD,MAAM,WAAW,MAAM,mBAAmB,SAAS;GAClD,SAAS,IAAI;GACb;GACA,OAAO;EACR,CAAC;EACD,MAAM,UAAU,YAAY,SAAS,IAAI,SAAS,IAAI,SAAS,QAAQ;EACvE,IAAI,UAAA,KAA0B;GAC7B,IAAI,CAAE,MAAM,gBAAgB,SAAS,GAAG,GACvC,OAAO,EAAE,IAAI,MAAM;GAEpB,OAAO;IAAE,IAAI;IAAM;IAAS,OAAO;IAAM,YAAY,KAAA;GAAU;EAChE;EACA,IACC,UAAU,QACV,QAAQ,OAAO,QAAQ,qBACvB,CAAC,QAAQ,aAAa,eACrB;GACD,IAAI,CAAE,MAAM,gBAAgB,SAAS,GAAG,GACvC,OAAO,EAAE,IAAI,MAAM;GAEpB,OAAO;IAAE,IAAI;IAAM;IAAS;IAAO,YAAY,KAAA;GAAU;EAC1D;EACA,OAAO;GAAE,IAAI;GAAM;GAAS;GAAO,YAAY,SAAS,KAAA;EAAU;CACnE,SAAS,KAAK;EACb,IAAI,QAAQ,QAAQ,KAAK,8CAA8C,OAAO,GAAG,GAAG;EACpF,OAAO,EAAE,IAAI,MAAM;CACpB;AACD"}
@@ -1,20 +1,2 @@
1
- import { n as AnalyticsAdapter } from "../../contract-CWZPKWuR.js";
2
-
3
- //#region src/adapters/ga4/ga4.d.ts
4
- interface Ga4Config {
5
- /** GA4 property id (numeric), e.g. '123456789'. */
6
- propertyId: string;
7
- /** Service-account credentials. */
8
- credentials: {
9
- client_email: string;
10
- private_key: string;
11
- };
12
- /** GCP project id; inferred from the credentials when omitted. */
13
- projectId?: string;
14
- /** Maximum days of historical data. Defaults to 425 (GA4's rolling-window limit). Pass null to disable clamping. */
15
- maxLookbackDays?: number | null;
16
- }
17
- declare function ga4(config: Ga4Config): AnalyticsAdapter;
18
- //#endregion
19
- export { type Ga4Config, ga4 };
20
- //# sourceMappingURL=ga4.d.ts.map
1
+ import { Ga4Config, ga4 } from "../../adapters/ga4/ga4.js";
2
+ export { type Ga4Config, ga4 };
@@ -1,177 +1,2 @@
1
- import { t as dayIso } from "../../series-zytbzPoc.js";
2
- //#region src/adapters/ga4/ga4.ts
3
- const METRIC_MAP = {
4
- pageviews: "screenPageViews",
5
- visitors: "totalUsers",
6
- visits: "sessions",
7
- sessions: "sessions",
8
- bounceRate: "bounceRate",
9
- avgDuration: "averageSessionDuration",
10
- events: "eventCount",
11
- conversions: "keyEvents",
12
- revenue: "totalRevenue"
13
- };
14
- const DIMENSION_MAP = {
15
- page: "pagePath",
16
- referrer: "pageReferrer",
17
- source: "sessionSource",
18
- medium: "sessionMedium",
19
- campaign: "sessionCampaignName",
20
- utmSource: "sessionSource",
21
- utmMedium: "sessionMedium",
22
- utmCampaign: "sessionCampaignName",
23
- device: "deviceCategory",
24
- browser: "browser",
25
- os: "operatingSystem",
26
- country: "countryId",
27
- region: "region",
28
- city: "city",
29
- language: "language",
30
- event: "eventName"
31
- };
32
- const ga4Metrics = new Set(Object.keys(METRIC_MAP));
33
- const ga4Dimensions = new Set(Object.keys(DIMENSION_MAP));
34
- const toContractValue = (metric, raw) => {
35
- if (metric === "avgDuration") return Math.round(raw * 1e3);
36
- if (metric === "bounceRate") return Math.round(raw * 100);
37
- return raw;
38
- };
39
- function ga4(config) {
40
- const capabilities = {
41
- perPageQuery: true,
42
- realtime: false,
43
- comparison: false,
44
- minGranularity: "day",
45
- maxLookbackDays: config.maxLookbackDays !== void 0 ? config.maxLookbackDays : 425,
46
- metrics: ga4Metrics,
47
- dimensions: ga4Dimensions,
48
- batchPageReport: true,
49
- rateLimit: {
50
- maxConcurrent: 10,
51
- quotaModel: "tokens",
52
- readsCountAsUsage: true
53
- },
54
- recommendedTtl: {
55
- realtime: 300,
56
- aggregate: 21600
57
- }
58
- };
59
- let clientPromise;
60
- const getClient = () => {
61
- if (!clientPromise) clientPromise = (async () => {
62
- let mod;
63
- try {
64
- mod = await import("@google-analytics/data");
65
- } catch {
66
- throw new Error("@10x-media/analytics: the GA4 adapter requires the optional peer dependency \"@google-analytics/data\". Install it with: pnpm add @google-analytics/data");
67
- }
68
- return new mod.BetaAnalyticsDataClient({
69
- credentials: config.credentials,
70
- projectId: config.projectId
71
- });
72
- })();
73
- return clientPromise;
74
- };
75
- return {
76
- id: "ga4",
77
- label: "Google Analytics 4",
78
- capabilities,
79
- isConfigured: () => Boolean(config.propertyId && config.credentials?.client_email && config.credentials?.private_key),
80
- async query(q, _ctx) {
81
- const fetchedAt = q.dateRange.end.toISOString();
82
- const wanted = q.metrics.filter((m) => METRIC_MAP[m]);
83
- const providerMetrics = [...new Set(wanted.map((m) => METRIC_MAP[m]))];
84
- const dims = (q.dimensions ?? []).filter((d) => DIMENSION_MAP[d]);
85
- const providerDims = [...new Set(dims.map((d) => DIMENSION_MAP[d]))];
86
- const readRow = (row) => {
87
- const out = {};
88
- for (const m of wanted) {
89
- const idx = providerMetrics.indexOf(METRIC_MAP[m]);
90
- out[m] = toContractValue(m, Number(row.metricValues?.[idx]?.value ?? 0));
91
- }
92
- return out;
93
- };
94
- const baseRequest = {
95
- property: `properties/${config.propertyId}`,
96
- dateRanges: [{
97
- startDate: q.dateRange.start.toISOString().slice(0, 10),
98
- endDate: q.dateRange.end.toISOString().slice(0, 10)
99
- }],
100
- metrics: providerMetrics.map((name) => ({ name })),
101
- ...q.path ? { dimensionFilter: { filter: {
102
- fieldName: "pagePath",
103
- stringFilter: {
104
- matchType: "EXACT",
105
- value: q.path
106
- }
107
- } } } : {}
108
- };
109
- const client = await getClient();
110
- if (q.granularity === "day" && !dims.length) {
111
- const [response] = await client.runReport({
112
- ...baseRequest,
113
- dimensions: [{ name: "date" }],
114
- metricAggregations: ["TOTAL"],
115
- orderBys: [{ dimension: { dimensionName: "date" } }]
116
- });
117
- const rows = [];
118
- for (const row of response.rows ?? []) {
119
- const ymd = row.dimensionValues?.[0]?.value ?? "";
120
- const ts = dayIso(`${ymd.slice(0, 4)}-${ymd.slice(4, 6)}-${ymd.slice(6, 8)}`);
121
- if (ts) rows.push({
122
- timestamp: ts,
123
- metrics: readRow(row)
124
- });
125
- }
126
- const totalsRow = response.totals?.[0];
127
- return {
128
- rows,
129
- totals: totalsRow ? readRow(totalsRow) : {},
130
- meta: {
131
- provider: "ga4",
132
- fetchedAt
133
- }
134
- };
135
- }
136
- const [response] = await client.runReport({
137
- ...baseRequest,
138
- ...providerDims.length ? { dimensions: providerDims.map((name) => ({ name })) } : {},
139
- ...q.limit ? { limit: q.limit } : {}
140
- });
141
- if (!dims.length) {
142
- const row = response.rows?.[0];
143
- const totals = row ? readRow(row) : {};
144
- return {
145
- rows: [{ metrics: totals }],
146
- totals,
147
- meta: {
148
- provider: "ga4",
149
- fetchedAt
150
- }
151
- };
152
- }
153
- return {
154
- rows: (response.rows ?? []).map((row) => {
155
- const dimValues = {};
156
- for (const d of dims) {
157
- const idx = providerDims.indexOf(DIMENSION_MAP[d]);
158
- dimValues[d] = row.dimensionValues?.[idx]?.value ?? "";
159
- }
160
- return {
161
- dimensions: dimValues,
162
- metrics: readRow(row)
163
- };
164
- }),
165
- totals: void 0,
166
- meta: {
167
- provider: "ga4",
168
- fetchedAt
169
- }
170
- };
171
- }
172
- };
173
- }
174
- //#endregion
1
+ import { ga4 } from "../../adapters/ga4/ga4.js";
175
2
  export { ga4 };
176
-
177
- //# sourceMappingURL=ga4.js.map
@@ -1,22 +1,2 @@
1
- import { n as AnalyticsAdapter } from "../../contract-CWZPKWuR.js";
2
- import { n as GeoResolver } from "../../geoResolver-CasIa4T9.js";
3
-
4
- //#region src/native/nativeAdapter.d.ts
5
- interface NativeOptions {
6
- geoResolver?: GeoResolver;
7
- geoDbPath?: string;
8
- ingestPath?: string;
9
- retentionDays?: number;
10
- /** Opt-in in-process write batching. `true` uses defaults (maxSize 50, maxAgeMs 2000). */
11
- buffer?: boolean | {
12
- maxSize?: number;
13
- maxAgeMs?: number;
14
- };
15
- }
16
- type NativeAdapter = AnalyticsAdapter & {
17
- flush: () => Promise<void>;
18
- };
19
- declare function native(options?: NativeOptions): NativeAdapter;
20
- //#endregion
21
- export { type NativeOptions, native };
22
- //# sourceMappingURL=native.d.ts.map
1
+ import { NativeOptions, native } from "../../native/nativeAdapter.js";
2
+ export { type NativeOptions, native };