@10x-media/analytics 0.1.0-beta.5 → 1.0.0-beta.11
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +277 -0
- package/README.md +15 -4
- package/dist/adapters/ga4/disableKey.d.ts +9 -0
- package/dist/adapters/ga4/disableKey.js +21 -0
- package/dist/adapters/ga4/disableKey.js.map +1 -0
- package/dist/adapters/ga4/eventName.d.ts +15 -0
- package/dist/adapters/ga4/eventName.js +19 -0
- package/dist/adapters/ga4/eventName.js.map +1 -0
- package/dist/adapters/ga4/ga4.d.ts +5 -0
- package/dist/adapters/ga4/ga4.js +186 -58
- package/dist/adapters/ga4/ga4.js.map +1 -1
- package/dist/adapters/ga4/measurementId.js +15 -0
- package/dist/adapters/ga4/measurementId.js.map +1 -0
- package/dist/adapters/goalRead.js +126 -0
- package/dist/adapters/goalRead.js.map +1 -0
- package/dist/adapters/http/fetchJson.js +1 -1
- package/dist/adapters/plausible/plausible.d.ts +25 -0
- package/dist/adapters/plausible/plausible.js +159 -38
- package/dist/adapters/plausible/plausible.js.map +1 -1
- package/dist/adapters/posthog/posthog.d.ts +10 -1
- package/dist/adapters/posthog/posthog.js +130 -21
- package/dist/adapters/posthog/posthog.js.map +1 -1
- package/dist/adapters/series.js +11 -1
- package/dist/adapters/series.js.map +1 -1
- package/dist/adapters/umami/umami.d.ts +13 -1
- package/dist/adapters/umami/umami.js +278 -26
- package/dist/adapters/umami/umami.js.map +1 -1
- package/dist/binding/resolvePath.js +18 -2
- package/dist/binding/resolvePath.js.map +1 -1
- package/dist/capture/getTrackerConfig.d.ts +20 -0
- package/dist/capture/getTrackerConfig.js +31 -0
- package/dist/capture/getTrackerConfig.js.map +1 -0
- package/dist/capture/mountPath.js +14 -0
- package/dist/capture/mountPath.js.map +1 -0
- package/dist/capture/proxyEndpoint.js +127 -0
- package/dist/capture/proxyEndpoint.js.map +1 -0
- package/dist/capture/proxyRoutes.js +108 -0
- package/dist/capture/proxyRoutes.js.map +1 -0
- package/dist/capture/requestBody.js +68 -0
- package/dist/capture/requestBody.js.map +1 -0
- package/dist/capture/slots.d.ts +8 -0
- package/dist/capture/slots.js +54 -0
- package/dist/capture/slots.js.map +1 -0
- package/dist/capture/trackerConfig.d.ts +33 -0
- package/dist/capture/trackerConfig.js +95 -0
- package/dist/capture/trackerConfig.js.map +1 -0
- package/dist/capture/trackerEndpoint.js +35 -0
- package/dist/capture/trackerEndpoint.js.map +1 -0
- package/dist/charts/BarList.d.ts +16 -1
- package/dist/charts/BarList.js +41 -19
- package/dist/charts/BarList.js.map +1 -1
- package/dist/charts/TrendChart.d.ts +16 -3
- package/dist/charts/TrendChart.js +172 -106
- package/dist/charts/TrendChart.js.map +1 -1
- package/dist/charts/bars.d.ts +4 -0
- package/dist/charts/bars.js +3 -1
- package/dist/charts/bars.js.map +1 -1
- package/dist/charts/bucket.js +10 -1
- package/dist/charts/bucket.js.map +1 -1
- package/dist/charts/spline.js +2 -2
- package/dist/charts/spline.js.map +1 -1
- package/dist/charts/styles.js +18 -1
- package/dist/charts/styles.js.map +1 -1
- package/dist/core/cacheKey.js +26 -3
- package/dist/core/cacheKey.js.map +1 -1
- package/dist/core/capabilities.d.ts +5 -1
- package/dist/core/capabilities.js +11 -2
- package/dist/core/capabilities.js.map +1 -1
- package/dist/core/capture.d.ts +49 -0
- package/dist/core/contract.d.ts +74 -5
- package/dist/core/contract.js +30 -1
- package/dist/core/contract.js.map +1 -1
- package/dist/core/granularity.js +1 -1
- package/dist/core/options.d.ts +164 -6
- package/dist/core/options.js +126 -3
- package/dist/core/options.js.map +1 -1
- package/dist/core/registry.d.ts +1 -0
- package/dist/core/scopeList.js +32 -0
- package/dist/core/scopeList.js.map +1 -0
- package/dist/core/scopedRead.js +101 -30
- package/dist/core/scopedRead.js.map +1 -1
- package/dist/core/serverEvent.d.ts +60 -0
- package/dist/core/serverEvent.js +12 -0
- package/dist/core/serverEvent.js.map +1 -0
- package/dist/exports/adapters/ga4.d.ts +2 -1
- package/dist/exports/adapters/ga4.js +2 -1
- package/dist/exports/adapters/native.d.ts +3 -1
- package/dist/exports/adapters/native.js +2 -1
- package/dist/exports/client.d.ts +13 -3
- package/dist/exports/client.js +10 -1
- package/dist/exports/geo.d.ts +2 -2
- package/dist/exports/next.d.ts +2 -1
- package/dist/exports/next.js +2 -1
- package/dist/exports/react.d.ts +4 -0
- package/dist/exports/react.js +5 -0
- package/dist/exports/rsc.d.ts +11 -3
- package/dist/exports/rsc.js +7 -2
- package/dist/exports/tracker.d.ts +21 -0
- package/dist/exports/tracker.js +15 -0
- package/dist/exports/types.d.ts +16 -3
- package/dist/exports/types.js +4 -2
- package/dist/fields/AnalyticsPanelClient.js +2 -2
- package/dist/fields/AnalyticsPanelField.js +1 -1
- package/dist/fields/AnalyticsStatField.js +2 -2
- package/dist/fields/config/FilterDimensionSelectField.d.ts +14 -0
- package/dist/fields/config/FilterDimensionSelectField.js +77 -0
- package/dist/fields/config/FilterDimensionSelectField.js.map +1 -0
- package/dist/fields/config/FilterOperatorSelectField.d.ts +14 -0
- package/dist/fields/config/FilterOperatorSelectField.js +75 -0
- package/dist/fields/config/FilterOperatorSelectField.js.map +1 -0
- package/dist/fields/config/MetricSelectField.js +3 -3
- package/dist/fields/config/MetricSelectField.js.map +1 -1
- package/dist/fields/config/SourceSelectField.js +3 -3
- package/dist/fields/config/SourceSelectField.js.map +1 -1
- package/dist/fields/config/fetchSources.d.ts +5 -1
- package/dist/fields/config/fetchSources.js +7 -3
- package/dist/fields/config/fetchSources.js.map +1 -1
- package/dist/fields/config/narrow.js +2 -0
- package/dist/fields/config/narrow.js.map +1 -1
- package/dist/fields/config/sourcesState.js +19 -3
- package/dist/fields/config/sourcesState.js.map +1 -1
- package/dist/fields/config/useAnalyticsSources.d.ts +8 -3
- package/dist/fields/config/useAnalyticsSources.js +9 -6
- package/dist/fields/config/useAnalyticsSources.js.map +1 -1
- package/dist/fields/config/useFilterCapabilities.d.ts +28 -0
- package/dist/fields/config/useFilterCapabilities.js +52 -0
- package/dist/fields/config/useFilterCapabilities.js.map +1 -0
- package/dist/fields/readForDocument.d.ts +5 -0
- package/dist/fields/readForDocument.js +22 -10
- package/dist/fields/readForDocument.js.map +1 -1
- package/dist/goals/GoalSelectField.d.ts +7 -0
- package/dist/goals/GoalSelectField.js +77 -0
- package/dist/goals/GoalSelectField.js.map +1 -0
- package/dist/goals/collection.js +254 -0
- package/dist/goals/collection.js.map +1 -0
- package/dist/goals/currency.js +14 -0
- package/dist/goals/currency.js.map +1 -0
- package/dist/goals/fetchGoals.d.ts +18 -0
- package/dist/goals/fetchGoals.js +33 -0
- package/dist/goals/fetchGoals.js.map +1 -0
- package/dist/goals/goalField.d.ts +31 -0
- package/dist/goals/goalField.js +56 -0
- package/dist/goals/goalField.js.map +1 -0
- package/dist/goals/goalsEndpoint.d.ts +1 -0
- package/dist/goals/goalsEndpoint.js +58 -0
- package/dist/goals/goalsEndpoint.js.map +1 -0
- package/dist/goals/match.js +64 -0
- package/dist/goals/match.js.map +1 -0
- package/dist/goals/resolver.d.ts +8 -0
- package/dist/goals/resolver.js +147 -0
- package/dist/goals/resolver.js.map +1 -0
- package/dist/goals/trackGoalAction.d.ts +76 -0
- package/dist/goals/trackGoalAction.js +158 -0
- package/dist/goals/trackGoalAction.js.map +1 -0
- package/dist/goals/types.d.ts +33 -0
- package/dist/goals/types.js +7 -0
- package/dist/goals/types.js.map +1 -0
- package/dist/goals/useAnalyticsGoals.d.ts +20 -0
- package/dist/goals/useAnalyticsGoals.js +67 -0
- package/dist/goals/useAnalyticsGoals.js.map +1 -0
- package/dist/index.d.ts +14 -3
- package/dist/index.js +174 -19
- package/dist/index.js.map +1 -1
- package/dist/native/collections/events.js +65 -1
- package/dist/native/collections/events.js.map +1 -1
- package/dist/native/collections/rollups.js +39 -3
- package/dist/native/collections/rollups.js.map +1 -1
- package/dist/native/eventScan.js +25 -0
- package/dist/native/eventScan.js.map +1 -0
- package/dist/native/geo/composeGeoResolvers.js +2 -2
- package/dist/native/geo/composeGeoResolvers.js.map +1 -1
- package/dist/native/geo/geoResolver.d.ts +9 -2
- package/dist/native/geo/geoResolver.js.map +1 -1
- package/dist/native/geo/maxmindResolver.js +3 -5
- package/dist/native/geo/maxmindResolver.js.map +1 -1
- package/dist/native/ingest/bots.d.ts +11 -0
- package/dist/native/ingest/bots.js +71 -0
- package/dist/native/ingest/bots.js.map +1 -0
- package/dist/native/ingest/browser.js +47 -0
- package/dist/native/ingest/browser.js.map +1 -0
- package/dist/native/ingest/clientIp.js +20 -0
- package/dist/native/ingest/clientIp.js.map +1 -0
- package/dist/native/ingest/device.js +11 -3
- package/dist/native/ingest/device.js.map +1 -1
- package/dist/native/ingest/endpoint.d.ts +1 -0
- package/dist/native/ingest/endpoint.js +107 -21
- package/dist/native/ingest/endpoint.js.map +1 -1
- package/dist/native/ingest/flushBatch.js +29 -38
- package/dist/native/ingest/flushBatch.js.map +1 -1
- package/dist/native/ingest/language.js +14 -0
- package/dist/native/ingest/language.js.map +1 -0
- package/dist/native/ingest/normalizeEvent.d.ts +30 -0
- package/dist/native/ingest/normalizeEvent.js +115 -16
- package/dist/native/ingest/normalizeEvent.js.map +1 -1
- package/dist/native/ingest/referrer.js +48 -0
- package/dist/native/ingest/referrer.js.map +1 -0
- package/dist/native/ingest/requestHost.js +57 -0
- package/dist/native/ingest/requestHost.js.map +1 -0
- package/dist/native/ingest/resolveHostname.d.ts +29 -0
- package/dist/native/ingest/resolveHostname.js +52 -0
- package/dist/native/ingest/resolveHostname.js.map +1 -0
- package/dist/native/ingest/salt.js +27 -2
- package/dist/native/ingest/salt.js.map +1 -1
- package/dist/native/ingest/serverTrack.d.ts +20 -0
- package/dist/native/ingest/serverTrack.js +109 -0
- package/dist/native/ingest/serverTrack.js.map +1 -0
- package/dist/native/ingest/source.d.ts +11 -0
- package/dist/native/ingest/source.js +264 -16
- package/dist/native/ingest/source.js.map +1 -1
- package/dist/native/ingest/utm.js +33 -0
- package/dist/native/ingest/utm.js.map +1 -0
- package/dist/native/ingest/validate.js +26 -0
- package/dist/native/ingest/validate.js.map +1 -0
- package/dist/native/nativeAdapter.d.ts +37 -1
- package/dist/native/nativeAdapter.js +175 -22
- package/dist/native/nativeAdapter.js.map +1 -1
- package/dist/native/query/eventAgg.js +175 -0
- package/dist/native/query/eventAgg.js.map +1 -0
- package/dist/native/retention/pruneTask.js +53 -13
- package/dist/native/retention/pruneTask.js.map +1 -1
- package/dist/native/rollupAcc.js +12 -1
- package/dist/native/rollupAcc.js.map +1 -1
- package/dist/native/rollups/bucketKey.js +15 -0
- package/dist/native/rollups/bucketKey.js.map +1 -0
- package/dist/native/rollups/bumpRollups.js +116 -0
- package/dist/native/rollups/bumpRollups.js.map +1 -0
- package/dist/native/rollups/deltas.js +86 -11
- package/dist/native/rollups/deltas.js.map +1 -1
- package/dist/native/rollups/insertManyIfNew.js +93 -0
- package/dist/native/rollups/insertManyIfNew.js.map +1 -0
- package/dist/next/captureRewrites.d.ts +42 -0
- package/dist/next/captureRewrites.js +57 -0
- package/dist/next/captureRewrites.js.map +1 -0
- package/dist/next/posthogProxyRewrites.d.ts +5 -0
- package/dist/next/posthogProxyRewrites.js +16 -21
- package/dist/next/posthogProxyRewrites.js.map +1 -1
- package/dist/plugin/documentEndpoint.js +71 -24
- package/dist/plugin/documentEndpoint.js.map +1 -1
- package/dist/plugin/errors.d.ts +31 -0
- package/dist/plugin/errors.js +79 -0
- package/dist/plugin/errors.js.map +1 -0
- package/dist/plugin/goalHint.d.ts +1 -0
- package/dist/plugin/goalHint.js +24 -0
- package/dist/plugin/goalHint.js.map +1 -0
- package/dist/plugin/paths.js +17 -1
- package/dist/plugin/paths.js.map +1 -1
- package/dist/plugin/queryEndpoint.js +124 -0
- package/dist/plugin/queryEndpoint.js.map +1 -0
- package/dist/plugin/readContextForRequest.js +73 -0
- package/dist/plugin/readContextForRequest.js.map +1 -0
- package/dist/plugin/realtimeEndpoint.js +37 -16
- package/dist/plugin/realtimeEndpoint.js.map +1 -1
- package/dist/plugin/refreshEndpoint.js +113 -0
- package/dist/plugin/refreshEndpoint.js.map +1 -0
- package/dist/plugin/runtime.d.ts +1 -0
- package/dist/plugin/runtime.js +33 -1
- package/dist/plugin/runtime.js.map +1 -1
- package/dist/plugin/scopeChange.js +22 -0
- package/dist/plugin/scopeChange.js.map +1 -0
- package/dist/plugin/scopeFieldBoot.js +22 -0
- package/dist/plugin/scopeFieldBoot.js.map +1 -0
- package/dist/plugin/sourcesEndpoint.js +16 -41
- package/dist/plugin/sourcesEndpoint.js.map +1 -1
- package/dist/plugin/warmTask.js +0 -0
- package/dist/plugin/warmTask.js.map +1 -1
- package/dist/providers/collection.js +89 -29
- package/dist/providers/collection.js.map +1 -1
- package/dist/providers/factory.js +11 -3
- package/dist/providers/factory.js.map +1 -1
- package/dist/providers/resolver.js.map +1 -1
- package/dist/query/dates.js +64 -0
- package/dist/query/dates.js.map +1 -0
- package/dist/query/errors.d.ts +14 -0
- package/dist/query/fetchQuery.d.ts +79 -0
- package/dist/query/fetchQuery.js +117 -0
- package/dist/query/fetchQuery.js.map +1 -0
- package/dist/query/parse.d.ts +22 -0
- package/dist/query/parse.js +168 -0
- package/dist/query/parse.js.map +1 -0
- package/dist/query/response.d.ts +39 -0
- package/dist/query/response.js +11 -0
- package/dist/query/response.js.map +1 -0
- package/dist/react/AnalyticsProvider.d.ts +50 -0
- package/dist/react/AnalyticsProvider.js +67 -0
- package/dist/react/AnalyticsProvider.js.map +1 -0
- package/dist/react/TrackerBoot.d.ts +22 -0
- package/dist/react/TrackerBoot.js +30 -0
- package/dist/react/TrackerBoot.js.map +1 -0
- package/dist/react/useAnalytics.d.ts +20 -0
- package/dist/react/useAnalytics.js +52 -0
- package/dist/react/useAnalytics.js.map +1 -0
- package/dist/rsc/AnalyticsScripts.d.ts +30 -0
- package/dist/rsc/AnalyticsScripts.js +41 -0
- package/dist/rsc/AnalyticsScripts.js.map +1 -0
- package/dist/surfacing/cacheStore.d.ts +1 -0
- package/dist/surfacing/cacheStore.js +18 -2
- package/dist/surfacing/cacheStore.js.map +1 -1
- package/dist/surfacing/engine.d.ts +1 -0
- package/dist/surfacing/engine.js +47 -6
- package/dist/surfacing/engine.js.map +1 -1
- package/dist/surfacing/epoch.d.ts +1 -0
- package/dist/surfacing/epoch.js +72 -0
- package/dist/surfacing/epoch.js.map +1 -0
- package/dist/surfacing/queue.js +22 -6
- package/dist/surfacing/queue.js.map +1 -1
- package/dist/surfacing/rateLimiter.js +130 -0
- package/dist/surfacing/rateLimiter.js.map +1 -0
- package/dist/surfacing/retryPolicy.js +15 -0
- package/dist/surfacing/retryPolicy.js.map +1 -0
- package/dist/sync/collection.js +23 -7
- package/dist/sync/collection.js.map +1 -1
- package/dist/sync/syncTask.js +68 -33
- package/dist/sync/syncTask.js.map +1 -1
- package/dist/testing/memoryAdapter.d.ts +2 -0
- package/dist/testing/memoryAdapter.js +17 -1
- package/dist/testing/memoryAdapter.js.map +1 -1
- package/dist/timeframe/tz.js +17 -6
- package/dist/timeframe/tz.js.map +1 -1
- package/dist/tracker/autoCapture.d.ts +48 -0
- package/dist/tracker/autoCapture.js +129 -0
- package/dist/tracker/autoCapture.js.map +1 -0
- package/dist/tracker/consent.d.ts +24 -0
- package/dist/tracker/consent.js +48 -0
- package/dist/tracker/consent.js.map +1 -0
- package/dist/tracker/createTracker.d.ts +18 -0
- package/dist/tracker/createTracker.js +215 -0
- package/dist/tracker/createTracker.js.map +1 -0
- package/dist/tracker/exclusion.d.ts +28 -0
- package/dist/tracker/exclusion.js +50 -0
- package/dist/tracker/exclusion.js.map +1 -0
- package/dist/tracker/initTracker.d.ts +22 -0
- package/dist/tracker/initTracker.js +33 -0
- package/dist/tracker/initTracker.js.map +1 -0
- package/dist/tracker/loadScript.d.ts +14 -0
- package/dist/tracker/loadScript.js +41 -0
- package/dist/tracker/loadScript.js.map +1 -0
- package/dist/tracker/pageTracking.d.ts +17 -0
- package/dist/tracker/pageTracking.js +38 -0
- package/dist/tracker/pageTracking.js.map +1 -0
- package/dist/tracker/registry.d.ts +27 -0
- package/dist/tracker/registry.js +73 -0
- package/dist/tracker/registry.js.map +1 -0
- package/dist/tracker/sinks/ga4.d.ts +29 -0
- package/dist/tracker/sinks/ga4.js +30 -0
- package/dist/tracker/sinks/ga4.js.map +1 -0
- package/dist/tracker/sinks/native.d.ts +22 -0
- package/dist/tracker/sinks/native.js +56 -0
- package/dist/tracker/sinks/native.js.map +1 -0
- package/dist/tracker/sinks/plausible.d.ts +20 -0
- package/dist/tracker/sinks/plausible.js +32 -0
- package/dist/tracker/sinks/plausible.js.map +1 -0
- package/dist/tracker/sinks/posthog.d.ts +18 -0
- package/dist/tracker/sinks/posthog.js +30 -0
- package/dist/tracker/sinks/posthog.js.map +1 -0
- package/dist/tracker/sinks/umami.d.ts +18 -0
- package/dist/tracker/sinks/umami.js +23 -0
- package/dist/tracker/sinks/umami.js.map +1 -0
- package/dist/tracker/sinks/vendor.d.ts +14 -0
- package/dist/tracker/sinks/vendor.js +81 -0
- package/dist/tracker/sinks/vendor.js.map +1 -0
- package/dist/tracker/transport.js +28 -0
- package/dist/tracker/transport.js.map +1 -0
- package/dist/tracker/types.d.ts +91 -0
- package/dist/translations/ar.js +221 -0
- package/dist/translations/ar.js.map +1 -0
- package/dist/translations/de.js +145 -1
- package/dist/translations/de.js.map +1 -1
- package/dist/translations/en.js +145 -1
- package/dist/translations/en.js.map +1 -1
- package/dist/translations/es.js +221 -0
- package/dist/translations/es.js.map +1 -0
- package/dist/translations/fr.js +221 -0
- package/dist/translations/fr.js.map +1 -0
- package/dist/translations/id.js +221 -0
- package/dist/translations/id.js.map +1 -0
- package/dist/translations/index.d.ts +10 -1
- package/dist/translations/index.js +19 -1
- package/dist/translations/index.js.map +1 -1
- package/dist/translations/keys.d.ts +144 -0
- package/dist/translations/keys.js +145 -1
- package/dist/translations/keys.js.map +1 -1
- package/dist/translations/ko.js +221 -0
- package/dist/translations/ko.js.map +1 -0
- package/dist/translations/metricKeys.js +8 -2
- package/dist/translations/metricKeys.js.map +1 -1
- package/dist/translations/pt.js +221 -0
- package/dist/translations/pt.js.map +1 -0
- package/dist/translations/ru.js +221 -0
- package/dist/translations/ru.js.map +1 -0
- package/dist/translations/server.js.map +1 -1
- package/dist/translations/uk.js +221 -0
- package/dist/translations/uk.js.map +1 -0
- package/dist/translations/zh.js +221 -0
- package/dist/translations/zh.js.map +1 -0
- package/dist/view/AnalyticsNavLink.d.ts +19 -0
- package/dist/view/AnalyticsNavLink.js +40 -0
- package/dist/view/AnalyticsNavLink.js.map +1 -0
- package/dist/view/AnalyticsView.d.ts +23 -0
- package/dist/view/AnalyticsView.js +45 -0
- package/dist/view/AnalyticsView.js.map +1 -0
- package/dist/view/AnalyticsViewClient.d.ts +15 -0
- package/dist/view/AnalyticsViewClient.js +244 -0
- package/dist/view/AnalyticsViewClient.js.map +1 -0
- package/dist/view/authRedirect.js +32 -0
- package/dist/view/authRedirect.js.map +1 -0
- package/dist/view/conversionRate.js +18 -0
- package/dist/view/conversionRate.js.map +1 -0
- package/dist/view/dayRange.js +68 -0
- package/dist/view/dayRange.js.map +1 -0
- package/dist/view/gating.d.ts +1 -0
- package/dist/view/gating.js +142 -0
- package/dist/view/gating.js.map +1 -0
- package/dist/view/labels.js +76 -0
- package/dist/view/labels.js.map +1 -0
- package/dist/view/registerView.js +48 -0
- package/dist/view/registerView.js.map +1 -0
- package/dist/view/sections/Breakdowns.js +198 -0
- package/dist/view/sections/Breakdowns.js.map +1 -0
- package/dist/view/sections/EmptyStates.js +92 -0
- package/dist/view/sections/EmptyStates.js.map +1 -0
- package/dist/view/sections/FilterChips.js +46 -0
- package/dist/view/sections/FilterChips.js.map +1 -0
- package/dist/view/sections/GoalsPanel.js +82 -0
- package/dist/view/sections/GoalsPanel.js.map +1 -0
- package/dist/view/sections/OverviewCards.js +65 -0
- package/dist/view/sections/OverviewCards.js.map +1 -0
- package/dist/view/sections/RealtimeStrip.js +80 -0
- package/dist/view/sections/RealtimeStrip.js.map +1 -0
- package/dist/view/sections/Toolbar.js +207 -0
- package/dist/view/sections/Toolbar.js.map +1 -0
- package/dist/view/sections/Trend.js +125 -0
- package/dist/view/sections/Trend.js.map +1 -0
- package/dist/view/sections/styles.js +76 -0
- package/dist/view/sections/styles.js.map +1 -0
- package/dist/view/state.js +211 -0
- package/dist/view/state.js.map +1 -0
- package/dist/view/useViewQueries.js +153 -0
- package/dist/view/useViewQueries.js.map +1 -0
- package/dist/view/viewProps.d.ts +40 -0
- package/dist/view/viewProps.js +90 -0
- package/dist/view/viewProps.js.map +1 -0
- package/dist/widgets/AnalyticsBreakdownWidget.d.ts +2 -1
- package/dist/widgets/AnalyticsBreakdownWidget.js +78 -11
- package/dist/widgets/AnalyticsBreakdownWidget.js.map +1 -1
- package/dist/widgets/AnalyticsGoalsWidget.d.ts +14 -0
- package/dist/widgets/AnalyticsGoalsWidget.js +196 -0
- package/dist/widgets/AnalyticsGoalsWidget.js.map +1 -0
- package/dist/widgets/AnalyticsMetricWidget.d.ts +2 -1
- package/dist/widgets/AnalyticsMetricWidget.js +63 -13
- package/dist/widgets/AnalyticsMetricWidget.js.map +1 -1
- package/dist/widgets/AnalyticsRealtimeWidget.d.ts +2 -1
- package/dist/widgets/AnalyticsRealtimeWidget.js +44 -22
- package/dist/widgets/AnalyticsRealtimeWidget.js.map +1 -1
- package/dist/widgets/AnalyticsTrendWidget.d.ts +2 -1
- package/dist/widgets/AnalyticsTrendWidget.js +79 -16
- package/dist/widgets/AnalyticsTrendWidget.js.map +1 -1
- package/dist/widgets/RealtimeCounter.d.ts +4 -0
- package/dist/widgets/RealtimeCounter.js +18 -4
- package/dist/widgets/RealtimeCounter.js.map +1 -1
- package/dist/widgets/WidgetViewLink.js +17 -0
- package/dist/widgets/WidgetViewLink.js.map +1 -0
- package/dist/widgets/breakdownTypes.js +38 -0
- package/dist/widgets/breakdownTypes.js.map +1 -1
- package/dist/widgets/cardChrome.js +31 -7
- package/dist/widgets/cardChrome.js.map +1 -1
- package/dist/widgets/comparison.js +15 -1
- package/dist/widgets/comparison.js.map +1 -1
- package/dist/widgets/defaults.d.ts +6 -2
- package/dist/widgets/defaults.js +78 -23
- package/dist/widgets/defaults.js.map +1 -1
- package/dist/widgets/filterCaption.js +27 -0
- package/dist/widgets/filterCaption.js.map +1 -0
- package/dist/widgets/filterField.d.ts +19 -0
- package/dist/widgets/filterField.js +75 -0
- package/dist/widgets/filterField.js.map +1 -0
- package/dist/widgets/prepareWidgetRead.d.ts +7 -0
- package/dist/widgets/prepareWidgetRead.js +74 -0
- package/dist/widgets/prepareWidgetRead.js.map +1 -0
- package/dist/widgets/range.js +43 -12
- package/dist/widgets/range.js.map +1 -1
- package/dist/widgets/readForWidget.d.ts +26 -3
- package/dist/widgets/readForWidget.js +48 -44
- package/dist/widgets/readForWidget.js.map +1 -1
- package/dist/widgets/readForWidgetBreakdown.d.ts +34 -2
- package/dist/widgets/readForWidgetBreakdown.js +53 -49
- package/dist/widgets/readForWidgetBreakdown.js.map +1 -1
- package/dist/widgets/readForWidgetGoals.d.ts +67 -0
- package/dist/widgets/readForWidgetGoals.js +140 -0
- package/dist/widgets/readForWidgetGoals.js.map +1 -0
- package/dist/widgets/readForWidgetRealtime.d.ts +8 -0
- package/dist/widgets/readForWidgetRealtime.js +23 -21
- package/dist/widgets/readForWidgetRealtime.js.map +1 -1
- package/dist/widgets/readForWidgetSeries.d.ts +26 -2
- package/dist/widgets/readForWidgetSeries.js +78 -53
- package/dist/widgets/readForWidgetSeries.js.map +1 -1
- package/dist/widgets/readMeta.js +18 -0
- package/dist/widgets/readMeta.js.map +1 -0
- package/dist/widgets/realtimePoll.js +13 -1
- package/dist/widgets/realtimePoll.js.map +1 -1
- package/dist/widgets/registerWidgets.js +62 -10
- package/dist/widgets/registerWidgets.js.map +1 -1
- package/dist/widgets/types.d.ts +15 -0
- package/dist/widgets/types.js +16 -2
- package/dist/widgets/types.js.map +1 -1
- package/dist/widgets/viewLink.d.ts +22 -0
- package/dist/widgets/viewLink.js +86 -0
- package/dist/widgets/viewLink.js.map +1 -0
- package/package.json +27 -7
- package/dist/native/rollups/applyDistinctDeltas.js +0 -9
- package/dist/native/rollups/applyDistinctDeltas.js.map +0 -1
- package/dist/native/rollups/bumpRollup.js +0 -68
- package/dist/native/rollups/bumpRollup.js.map +0 -1
- package/dist/native/rollups/insertIfNew.js +0 -19
- package/dist/native/rollups/insertIfNew.js.map +0 -1
|
@@ -1,12 +1,18 @@
|
|
|
1
|
+
import "../plugin/paths.js";
|
|
2
|
+
import { seenCollection } from "./collections/seen.js";
|
|
3
|
+
import { ROLLUPS_SLUG, rollupsCollection } from "./collections/rollups.js";
|
|
4
|
+
import { EVENTS_SLUG, eventsCollection } from "./collections/events.js";
|
|
5
|
+
import { flushBatch } from "./ingest/flushBatch.js";
|
|
6
|
+
import { makeServerTrack } from "./ingest/serverTrack.js";
|
|
1
7
|
import { composeGeoResolvers } from "./geo/composeGeoResolvers.js";
|
|
2
8
|
import { platformHeaderResolver } from "./geo/geoResolver.js";
|
|
3
9
|
import { maxmindResolver } from "./geo/maxmindResolver.js";
|
|
4
|
-
import {
|
|
5
|
-
import {
|
|
6
|
-
import {
|
|
7
|
-
import { flushBatch } from "./ingest/flushBatch.js";
|
|
10
|
+
import { resolveBotFilter } from "./ingest/bots.js";
|
|
11
|
+
import { EVENT_SCAN_LIMIT, eventScanMeta } from "./eventScan.js";
|
|
12
|
+
import { hostnameSet, resolveEventHostname, resolveHostnameOption } from "./ingest/resolveHostname.js";
|
|
8
13
|
import { makeIngestHandler } from "./ingest/endpoint.js";
|
|
9
14
|
import { createWriteBuffer } from "./ingest/writeBuffer.js";
|
|
15
|
+
import { aggregateEvents, filtersToWhere } from "./query/eventAgg.js";
|
|
10
16
|
import { buildRealtime } from "./realtime/buildRealtime.js";
|
|
11
17
|
import { pruneEventsTask } from "./retention/pruneTask.js";
|
|
12
18
|
import { add, emptyAcc, selectMetrics, seriesFromRollups } from "./rollupAcc.js";
|
|
@@ -16,24 +22,48 @@ const metrics = new Set([
|
|
|
16
22
|
"visitors",
|
|
17
23
|
"sessions",
|
|
18
24
|
"events",
|
|
19
|
-
"avgDuration"
|
|
25
|
+
"avgDuration",
|
|
26
|
+
"conversions",
|
|
27
|
+
"revenue",
|
|
28
|
+
"scrollDepth"
|
|
20
29
|
]);
|
|
30
|
+
/**
|
|
31
|
+
* Everything the tracker can know about a hit. `source` is the visit's named origin (its
|
|
32
|
+
* `utm_source`, else the referrer host, else `direct`), `channel` the acquisition channel that
|
|
33
|
+
* origin classifies into (`organic-search`, `paid-social`, ...) and `referrer` the host it came
|
|
34
|
+
* from, so a report can ask how much of the month was paid search without reading a list of
|
|
35
|
+
* hostnames.
|
|
36
|
+
*/
|
|
21
37
|
const dimensions = new Set([
|
|
22
38
|
"page",
|
|
23
|
-
"
|
|
39
|
+
"referrer",
|
|
24
40
|
"source",
|
|
25
|
-
"
|
|
41
|
+
"channel",
|
|
42
|
+
"utmSource",
|
|
43
|
+
"utmMedium",
|
|
44
|
+
"utmCampaign",
|
|
45
|
+
"utmContent",
|
|
46
|
+
"utmTerm",
|
|
47
|
+
"device",
|
|
48
|
+
"browser",
|
|
49
|
+
"os",
|
|
50
|
+
"country",
|
|
51
|
+
"region",
|
|
52
|
+
"city",
|
|
53
|
+
"language",
|
|
54
|
+
"event",
|
|
55
|
+
"goal"
|
|
26
56
|
]);
|
|
27
|
-
const REALTIME_EVENT_LIMIT = 5e4;
|
|
28
57
|
const baseCapabilities = {
|
|
29
58
|
perPageQuery: true,
|
|
30
59
|
realtime: true,
|
|
31
60
|
realtimeWindowMinutes: 60,
|
|
32
|
-
|
|
33
|
-
minGranularity: "day",
|
|
61
|
+
minGranularity: "hour",
|
|
34
62
|
maxLookbackDays: null,
|
|
35
63
|
metrics,
|
|
36
64
|
dimensions,
|
|
65
|
+
filters: new Set([...dimensions].filter((dimension) => dimension !== "goal")),
|
|
66
|
+
filterOperators: new Set(["eq", "contains"]),
|
|
37
67
|
batchPageReport: true,
|
|
38
68
|
rateLimit: null,
|
|
39
69
|
recommendedTtl: {
|
|
@@ -41,7 +71,83 @@ const baseCapabilities = {
|
|
|
41
71
|
aggregate: 300
|
|
42
72
|
}
|
|
43
73
|
};
|
|
74
|
+
const DAY_MS = 864e5;
|
|
75
|
+
const nativeCapture = {
|
|
76
|
+
proxy: { routes: [] },
|
|
77
|
+
snippet: () => ({ scripts: [] }),
|
|
78
|
+
client: { kind: "native" }
|
|
79
|
+
};
|
|
80
|
+
/**
|
|
81
|
+
* Filtered/hour-granularity reads bypass the day-bucketed rollups and aggregate raw
|
|
82
|
+
* events directly, under the same hard cap as `realtime()`. `retentionDays` clamps how
|
|
83
|
+
* far back the read can reach when it would otherwise ask for events the prune task has
|
|
84
|
+
* already deleted (or will delete before they're queryable).
|
|
85
|
+
*/
|
|
86
|
+
async function queryEvents(payload, q, ctx) {
|
|
87
|
+
const fetchedAt = q.dateRange.end.toISOString();
|
|
88
|
+
let start = q.dateRange.start;
|
|
89
|
+
let clamped = false;
|
|
90
|
+
if (ctx.retentionDays && ctx.retentionDays > 0) {
|
|
91
|
+
const floor = /* @__PURE__ */ new Date(Date.now() - ctx.retentionDays * DAY_MS);
|
|
92
|
+
if (start < floor) {
|
|
93
|
+
start = floor;
|
|
94
|
+
clamped = true;
|
|
95
|
+
}
|
|
96
|
+
}
|
|
97
|
+
const baseWhere = {
|
|
98
|
+
timestamp: {
|
|
99
|
+
greater_than_equal: start.toISOString(),
|
|
100
|
+
less_than_equal: q.dateRange.end.toISOString()
|
|
101
|
+
},
|
|
102
|
+
...q.hostname ? { hostname: { equals: q.hostname } } : {},
|
|
103
|
+
...q.path ? { path: { equals: q.path } } : {},
|
|
104
|
+
...ctx.scopeWhere(q)
|
|
105
|
+
};
|
|
106
|
+
const filterWhere = filtersToWhere(q.filters ?? []);
|
|
107
|
+
const where = Object.keys(filterWhere).length > 0 ? { and: [baseWhere, filterWhere] } : baseWhere;
|
|
108
|
+
const { docs } = await payload.find({
|
|
109
|
+
collection: EVENTS_SLUG,
|
|
110
|
+
where,
|
|
111
|
+
limit: EVENT_SCAN_LIMIT,
|
|
112
|
+
pagination: false,
|
|
113
|
+
depth: 0,
|
|
114
|
+
sort: "-timestamp"
|
|
115
|
+
});
|
|
116
|
+
const events = docs;
|
|
117
|
+
const dim = q.dimensions?.find((d) => dimensions.has(d));
|
|
118
|
+
const granularity = q.granularity === "hour" || q.granularity === "day" ? q.granularity : void 0;
|
|
119
|
+
const { rows, totals } = aggregateEvents(events, {
|
|
120
|
+
metrics: q.metrics,
|
|
121
|
+
dimension: dim,
|
|
122
|
+
granularity,
|
|
123
|
+
timezone: q.timezone,
|
|
124
|
+
order: q.order,
|
|
125
|
+
limit: q.limit
|
|
126
|
+
});
|
|
127
|
+
return {
|
|
128
|
+
rows,
|
|
129
|
+
totals,
|
|
130
|
+
meta: eventScanMeta({
|
|
131
|
+
fetchedAt,
|
|
132
|
+
eventCount: events.length,
|
|
133
|
+
clamped
|
|
134
|
+
})
|
|
135
|
+
};
|
|
136
|
+
}
|
|
137
|
+
/** Config-time window validation, so a nonsense window fails the boot rather than the sweep. */
|
|
138
|
+
const retentionWindow = (value, option) => {
|
|
139
|
+
if (value === void 0) return;
|
|
140
|
+
if (!Number.isInteger(value) || value <= 0) throw new Error(`analytics: ${option} must be a whole number of days above zero, got ${String(value)}`);
|
|
141
|
+
return value;
|
|
142
|
+
};
|
|
44
143
|
function native(options = {}) {
|
|
144
|
+
const hostname = resolveHostnameOption(options.hostname);
|
|
145
|
+
const filterBots = resolveBotFilter(options.filterBots);
|
|
146
|
+
const rollupRetentionDays = retentionWindow(options.rollupRetentionDays, "rollupRetentionDays");
|
|
147
|
+
const retentionDays = retentionWindow(options.retentionDays !== void 0 && options.retentionDays <= 0 ? void 0 : options.retentionDays, "retentionDays");
|
|
148
|
+
if (rollupRetentionDays !== void 0 && retentionDays === void 0) throw new Error("analytics: rollupRetentionDays requires retentionDays, since pruning rollups while keeping raw events forever would make an unfiltered long window answer less than the same window filtered");
|
|
149
|
+
if (rollupRetentionDays !== void 0 && retentionDays !== void 0 && rollupRetentionDays < retentionDays) throw new Error(`analytics: rollupRetentionDays (${rollupRetentionDays}) must not be shorter than retentionDays (${retentionDays}), since windows beyond retentionDays are answered from rollups`);
|
|
150
|
+
const platformHostnames = hostnameSet(options.platformHostnames, "platformHostnames");
|
|
45
151
|
const geoResolver = options.geoResolver ?? (options.geoDbPath ? composeGeoResolvers(platformHeaderResolver, maxmindResolver({ dbPath: options.geoDbPath })) : platformHeaderResolver);
|
|
46
152
|
const capabilities = { ...baseCapabilities };
|
|
47
153
|
let payloadRef = null;
|
|
@@ -57,10 +163,31 @@ function native(options = {}) {
|
|
|
57
163
|
});
|
|
58
164
|
return docs;
|
|
59
165
|
};
|
|
166
|
+
let resolvers = {};
|
|
167
|
+
let attribution = {};
|
|
168
|
+
const ingest = {
|
|
169
|
+
path: options.ingestPath ?? "/analytics/ingest",
|
|
170
|
+
track: makeServerTrack({
|
|
171
|
+
getPayload: () => payloadRef,
|
|
172
|
+
geoResolver,
|
|
173
|
+
getBuffer: () => buffer,
|
|
174
|
+
getResolvers: () => resolvers,
|
|
175
|
+
getAttribution: () => attribution
|
|
176
|
+
}),
|
|
177
|
+
hostname: (args) => resolveEventHostname({
|
|
178
|
+
option: hostname,
|
|
179
|
+
claimed: args.claimed,
|
|
180
|
+
req: args.req,
|
|
181
|
+
scope: args.scope ?? null,
|
|
182
|
+
trustedProxyHops: attribution.trustedProxyHops
|
|
183
|
+
})
|
|
184
|
+
};
|
|
60
185
|
return {
|
|
61
186
|
id: "native",
|
|
62
187
|
label: "Native (Payload)",
|
|
63
188
|
capabilities,
|
|
189
|
+
capture: nativeCapture,
|
|
190
|
+
ingest,
|
|
64
191
|
isConfigured: () => true,
|
|
65
192
|
flush: () => buffer?.flush() ?? Promise.resolve(),
|
|
66
193
|
register(config, context) {
|
|
@@ -72,17 +199,33 @@ function native(options = {}) {
|
|
|
72
199
|
rollupsCollection(scoped),
|
|
73
200
|
seenCollection()
|
|
74
201
|
];
|
|
202
|
+
resolvers = {
|
|
203
|
+
scope: scoped ? context?.resolveScope : void 0,
|
|
204
|
+
timezone: context?.resolveTimezone,
|
|
205
|
+
goals: context?.resolveGoals
|
|
206
|
+
};
|
|
207
|
+
attribution = {
|
|
208
|
+
trustedProxyHops: context?.trustedProxyHops,
|
|
209
|
+
hostname,
|
|
210
|
+
platformHostnames
|
|
211
|
+
};
|
|
75
212
|
config.endpoints = [...config.endpoints ?? [], {
|
|
76
213
|
method: "post",
|
|
77
|
-
path:
|
|
78
|
-
handler: makeIngestHandler(
|
|
79
|
-
|
|
80
|
-
|
|
214
|
+
path: ingest.path,
|
|
215
|
+
handler: makeIngestHandler({
|
|
216
|
+
geoResolver,
|
|
217
|
+
getBuffer: () => buffer,
|
|
218
|
+
resolvers,
|
|
219
|
+
attribution,
|
|
220
|
+
filterBots
|
|
81
221
|
})
|
|
82
222
|
}];
|
|
83
|
-
if (
|
|
223
|
+
if (retentionDays !== void 0 || rollupRetentionDays !== void 0) config.jobs = {
|
|
84
224
|
...config.jobs,
|
|
85
|
-
tasks: [...config.jobs?.tasks ?? [], pruneEventsTask(
|
|
225
|
+
tasks: [...config.jobs?.tasks ?? [], pruneEventsTask({
|
|
226
|
+
retentionDays,
|
|
227
|
+
rollupRetentionDays
|
|
228
|
+
})]
|
|
86
229
|
};
|
|
87
230
|
const prevOnInit = config.onInit;
|
|
88
231
|
config.onInit = async (p) => {
|
|
@@ -106,6 +249,10 @@ function native(options = {}) {
|
|
|
106
249
|
},
|
|
107
250
|
async query(q) {
|
|
108
251
|
if (!payloadRef) throw new Error("analytics: native adapter queried before init");
|
|
252
|
+
if (q.filters && q.filters.length > 0 || q.granularity === "hour") return queryEvents(payloadRef, q, {
|
|
253
|
+
retentionDays,
|
|
254
|
+
scopeWhere
|
|
255
|
+
});
|
|
109
256
|
const fetchedAt = q.dateRange.end.toISOString();
|
|
110
257
|
const periodWhere = {
|
|
111
258
|
greater_than_equal: q.dateRange.start.toISOString(),
|
|
@@ -117,6 +264,7 @@ function native(options = {}) {
|
|
|
117
264
|
granularity: { equals: "day" },
|
|
118
265
|
dimension: { equals: "" },
|
|
119
266
|
path: { equals: totalsPath },
|
|
267
|
+
hostname: { equals: q.hostname ?? "" },
|
|
120
268
|
period: periodWhere,
|
|
121
269
|
...scopeWhere(q)
|
|
122
270
|
});
|
|
@@ -145,12 +293,14 @@ function native(options = {}) {
|
|
|
145
293
|
granularity: { equals: "day" },
|
|
146
294
|
dimension: { equals: "" },
|
|
147
295
|
path: { not_equals: "" },
|
|
296
|
+
hostname: { equals: q.hostname ?? "" },
|
|
148
297
|
period: periodWhere,
|
|
149
298
|
...scopeWhere(q)
|
|
150
299
|
} : {
|
|
151
300
|
granularity: { equals: "day" },
|
|
152
301
|
dimension: { equals: dim },
|
|
153
302
|
path: { equals: "" },
|
|
303
|
+
hostname: { equals: q.hostname ?? "" },
|
|
154
304
|
period: periodWhere,
|
|
155
305
|
...scopeWhere(q)
|
|
156
306
|
};
|
|
@@ -191,21 +341,24 @@ function native(options = {}) {
|
|
|
191
341
|
greater_than_equal: q.dateRange.start.toISOString(),
|
|
192
342
|
less_than_equal: q.dateRange.end.toISOString()
|
|
193
343
|
},
|
|
344
|
+
...q.hostname ? { hostname: { equals: q.hostname } } : {},
|
|
345
|
+
...q.path ? { path: { equals: q.path } } : {},
|
|
194
346
|
...scopeWhere(q)
|
|
195
347
|
},
|
|
196
|
-
limit:
|
|
348
|
+
limit: EVENT_SCAN_LIMIT,
|
|
197
349
|
pagination: false,
|
|
198
350
|
depth: 0,
|
|
199
351
|
sort: "-timestamp"
|
|
200
352
|
});
|
|
201
|
-
const
|
|
353
|
+
const events = docs;
|
|
354
|
+
const { rows, totals } = buildRealtime(events, q.dateRange, q.metrics);
|
|
202
355
|
return {
|
|
203
356
|
rows,
|
|
204
357
|
totals,
|
|
205
|
-
meta: {
|
|
206
|
-
|
|
207
|
-
|
|
208
|
-
}
|
|
358
|
+
meta: eventScanMeta({
|
|
359
|
+
fetchedAt,
|
|
360
|
+
eventCount: events.length
|
|
361
|
+
})
|
|
209
362
|
};
|
|
210
363
|
}
|
|
211
364
|
};
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"nativeAdapter.js","names":["events"],"sources":["../../src/native/nativeAdapter.ts"],"sourcesContent":["import type { Config, Payload } from 'payload'\nimport type {\n\tAdapterContext,\n\tAnalyticsAdapter,\n\tAnalyticsCapabilities,\n\tAnalyticsQuery,\n\tAnalyticsResult,\n\tAnalyticsRow,\n\tDimensionKey,\n\tMetricKey,\n} from '../core/contract'\nimport { EVENTS_SLUG, eventsCollection } from './collections/events'\nimport { ROLLUPS_SLUG, rollupsCollection } from './collections/rollups'\nimport { seenCollection } from './collections/seen'\nimport { composeGeoResolvers } from './geo/composeGeoResolvers'\nimport { type GeoResolver, platformHeaderResolver } from './geo/geoResolver'\nimport { maxmindResolver } from './geo/maxmindResolver'\nimport { makeIngestHandler } from './ingest/endpoint'\nimport { flushBatch } from './ingest/flushBatch'\nimport type { StoredEvent } from './ingest/normalizeEvent'\nimport { createWriteBuffer, type WriteBuffer } from './ingest/writeBuffer'\nimport { buildRealtime, type RealtimeEvent } from './realtime/buildRealtime'\nimport { pruneEventsTask } from './retention/pruneTask'\nimport {\n\ttype Acc,\n\tadd,\n\temptyAcc,\n\ttype RollupDoc,\n\tselectMetrics,\n\tseriesFromRollups,\n} from './rollupAcc'\n\nexport interface NativeOptions {\n\tgeoResolver?: GeoResolver\n\tgeoDbPath?: string\n\tingestPath?: string\n\tretentionDays?: number\n\t/** Opt-in in-process write batching. `true` uses defaults (maxSize 50, maxAgeMs 2000). */\n\tbuffer?: boolean | { maxSize?: number; maxAgeMs?: number }\n}\n\nexport type NativeAdapter = AnalyticsAdapter & { flush: () => Promise<void> }\n\nconst metrics: ReadonlySet<MetricKey> = new Set([\n\t'pageviews',\n\t'visitors',\n\t'sessions',\n\t'events',\n\t'avgDuration',\n])\nconst dimensions: ReadonlySet<DimensionKey> = new Set(['page', 'country', 'source', 'device'])\n\nconst REALTIME_EVENT_LIMIT = 50_000\n\nconst baseCapabilities: AnalyticsCapabilities = {\n\tperPageQuery: true,\n\trealtime: true,\n\trealtimeWindowMinutes: 60,\n\tcomparison: true,\n\tminGranularity: 'day',\n\tmaxLookbackDays: null,\n\tmetrics,\n\tdimensions,\n\tbatchPageReport: true,\n\trateLimit: null,\n\trecommendedTtl: { realtime: 10, aggregate: 300 },\n}\n\nexport function native(options: NativeOptions = {}): NativeAdapter {\n\tconst geoResolver =\n\t\toptions.geoResolver ??\n\t\t(options.geoDbPath\n\t\t\t? composeGeoResolvers(platformHeaderResolver, maxmindResolver({ dbPath: options.geoDbPath }))\n\t\t\t: platformHeaderResolver)\n\t// Per-instance copy: register() flips scopedQueries when the install is scoped.\n\tconst capabilities: AnalyticsCapabilities = { ...baseCapabilities }\n\tlet payloadRef: Payload | null = null\n\tlet buffer: WriteBuffer<StoredEvent> | null = null\n\tlet scoped = false\n\n\tconst scopeWhere = (q: AnalyticsQuery): Record<string, unknown> =>\n\t\tscoped && q.scope !== undefined ? { scope: { equals: q.scope } } : {}\n\n\tconst readRollups = async (\n\t\tpayload: Payload,\n\t\twhere: Record<string, unknown>\n\t): Promise<RollupDoc[]> => {\n\t\tconst { docs } = await payload.find({\n\t\t\tcollection: ROLLUPS_SLUG as never,\n\t\t\twhere: where as never,\n\t\t\tlimit: 100_000,\n\t\t\tpagination: false,\n\t\t})\n\t\treturn docs as unknown as RollupDoc[]\n\t}\n\n\treturn {\n\t\tid: 'native',\n\t\tlabel: 'Native (Payload)',\n\t\tcapabilities,\n\t\tisConfigured: () => true,\n\t\tflush: () => buffer?.flush() ?? Promise.resolve(),\n\t\tregister(config: Config, context) {\n\t\t\tscoped = context?.scoped ?? false\n\t\t\tif (scoped) {\n\t\t\t\tcapabilities.scopedQueries = true\n\t\t\t}\n\t\t\tconfig.collections = [\n\t\t\t\t...(config.collections ?? []),\n\t\t\t\teventsCollection(scoped),\n\t\t\t\trollupsCollection(scoped),\n\t\t\t\tseenCollection(),\n\t\t\t]\n\t\t\tconfig.endpoints = [\n\t\t\t\t...(config.endpoints ?? []),\n\t\t\t\t{\n\t\t\t\t\tmethod: 'post',\n\t\t\t\t\tpath: options.ingestPath ?? '/analytics/ingest',\n\t\t\t\t\thandler: makeIngestHandler(geoResolver, () => buffer, {\n\t\t\t\t\t\tscope: scoped ? context?.resolveScope : undefined,\n\t\t\t\t\t\ttimezone: context?.resolveTimezone,\n\t\t\t\t\t}),\n\t\t\t\t},\n\t\t\t]\n\t\t\tif (options.retentionDays && options.retentionDays > 0) {\n\t\t\t\tconfig.jobs = {\n\t\t\t\t\t...config.jobs,\n\t\t\t\t\ttasks: [...(config.jobs?.tasks ?? []), pruneEventsTask(options.retentionDays)],\n\t\t\t\t}\n\t\t\t}\n\t\t\tconst prevOnInit = config.onInit\n\t\t\t// payloadRef is set before the app's own onInit so consumer init code can\n\t\t\t// already query the native adapter.\n\t\t\tconfig.onInit = async (p) => {\n\t\t\t\tpayloadRef = p\n\t\t\t\tif (options.buffer) {\n\t\t\t\t\tconst cfg = options.buffer === true ? {} : options.buffer\n\t\t\t\t\tbuffer = createWriteBuffer<StoredEvent>({\n\t\t\t\t\t\tmaxSize: cfg.maxSize ?? 50,\n\t\t\t\t\t\tmaxAgeMs: cfg.maxAgeMs ?? 2000,\n\t\t\t\t\t\tonFlush: (batch) => flushBatch(p, batch),\n\t\t\t\t\t\tonError: (error) => {\n\t\t\t\t\t\t\tp.logger.error({ err: error, msg: 'analytics: write buffer flush failed' })\n\t\t\t\t\t\t},\n\t\t\t\t\t})\n\t\t\t\t}\n\t\t\t\tawait prevOnInit?.(p)\n\t\t\t}\n\t\t},\n\t\tasync query(q: AnalyticsQuery): Promise<AnalyticsResult> {\n\t\t\tif (!payloadRef) {\n\t\t\t\tthrow new Error('analytics: native adapter queried before init')\n\t\t\t}\n\t\t\tconst fetchedAt = q.dateRange.end.toISOString()\n\t\t\tconst periodWhere = {\n\t\t\t\tgreater_than_equal: q.dateRange.start.toISOString(),\n\t\t\t\tless_than_equal: q.dateRange.end.toISOString(),\n\t\t\t}\n\t\t\tconst dim = q.dimensions?.find((d) => dimensions.has(d))\n\n\t\t\t// Distinct metrics (visitors/sessions) must not be summed across breakdown rows.\n\t\t\t// Totals always come from the non-dimensioned aggregate row. A dimensioned query\n\t\t\t// reports site-wide totals (path=''), a plain query uses the path-scoped row.\n\t\t\tconst totalsPath = dim ? '' : (q.path ?? '')\n\t\t\tconst totalsDocs = await readRollups(payloadRef, {\n\t\t\t\tgranularity: { equals: 'day' },\n\t\t\t\tdimension: { equals: '' },\n\t\t\t\tpath: { equals: totalsPath },\n\t\t\t\tperiod: periodWhere,\n\t\t\t\t...scopeWhere(q),\n\t\t\t})\n\t\t\tconst totalsAcc = emptyAcc()\n\t\t\tfor (const d of totalsDocs) {\n\t\t\t\tadd(totalsAcc, d)\n\t\t\t}\n\t\t\tconst totals = selectMetrics(totalsAcc, q.metrics)\n\n\t\t\tif (!dim) {\n\t\t\t\tif (q.granularity === 'day') {\n\t\t\t\t\treturn {\n\t\t\t\t\t\trows: seriesFromRollups(totalsDocs, q.metrics, q.timezone),\n\t\t\t\t\t\ttotals,\n\t\t\t\t\t\tmeta: { provider: 'native', fetchedAt },\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t\treturn { rows: [{ metrics: totals }], totals, meta: { provider: 'native', fetchedAt } }\n\t\t\t}\n\n\t\t\tconst breakdownWhere =\n\t\t\t\tdim === 'page'\n\t\t\t\t\t? {\n\t\t\t\t\t\t\tgranularity: { equals: 'day' },\n\t\t\t\t\t\t\tdimension: { equals: '' },\n\t\t\t\t\t\t\tpath: { not_equals: '' },\n\t\t\t\t\t\t\tperiod: periodWhere,\n\t\t\t\t\t\t\t...scopeWhere(q),\n\t\t\t\t\t\t}\n\t\t\t\t\t: {\n\t\t\t\t\t\t\tgranularity: { equals: 'day' },\n\t\t\t\t\t\t\tdimension: { equals: dim },\n\t\t\t\t\t\t\tpath: { equals: '' },\n\t\t\t\t\t\t\tperiod: periodWhere,\n\t\t\t\t\t\t\t...scopeWhere(q),\n\t\t\t\t\t\t}\n\t\t\tconst groups = new Map<string, Acc>()\n\t\t\tfor (const d of await readRollups(payloadRef, breakdownWhere)) {\n\t\t\t\tconst value = dim === 'page' ? d.path : d.dimvalue\n\t\t\t\tlet acc = groups.get(value)\n\t\t\t\tif (!acc) {\n\t\t\t\t\tacc = emptyAcc()\n\t\t\t\t\tgroups.set(value, acc)\n\t\t\t\t}\n\t\t\t\tadd(acc, d)\n\t\t\t}\n\t\t\tlet rows: AnalyticsRow[] = [...groups].map(([value, acc]) => ({\n\t\t\t\tdimensions: { [dim]: value } as Partial<Record<DimensionKey, string>>,\n\t\t\t\tmetrics: selectMetrics(acc, q.metrics),\n\t\t\t}))\n\t\t\tconst sortMetric = q.order?.metric ?? 'pageviews'\n\t\t\tconst direction = (q.order?.direction ?? 'desc') === 'asc' ? 1 : -1\n\t\t\trows.sort((a, b) => ((a.metrics[sortMetric] ?? 0) - (b.metrics[sortMetric] ?? 0)) * direction)\n\t\t\tif (q.limit) {\n\t\t\t\trows = rows.slice(0, q.limit)\n\t\t\t}\n\t\t\treturn { rows, totals, meta: { provider: 'native', fetchedAt } }\n\t\t},\n\t\tasync realtime(q: AnalyticsQuery, _ctx: AdapterContext): Promise<AnalyticsResult> {\n\t\t\tif (!payloadRef) {\n\t\t\t\tthrow new Error('analytics: native adapter queried before init')\n\t\t\t}\n\t\t\tconst fetchedAt = q.dateRange.end.toISOString()\n\t\t\tconst { docs } = await payloadRef.find({\n\t\t\t\tcollection: EVENTS_SLUG as never,\n\t\t\t\twhere: {\n\t\t\t\t\ttimestamp: {\n\t\t\t\t\t\tgreater_than_equal: q.dateRange.start.toISOString(),\n\t\t\t\t\t\tless_than_equal: q.dateRange.end.toISOString(),\n\t\t\t\t\t},\n\t\t\t\t\t...scopeWhere(q),\n\t\t\t\t} as never,\n\t\t\t\t// Newest-first under a hard cap: if a very busy site has more events than the\n\t\t\t\t// cap in the window, keep the most recent activity rather than the oldest.\n\t\t\t\t// Unbounded accuracy via DB-side aggregation is deferred to the hardening spec.\n\t\t\t\tlimit: REALTIME_EVENT_LIMIT,\n\t\t\t\tpagination: false,\n\t\t\t\tdepth: 0,\n\t\t\t\tsort: '-timestamp',\n\t\t\t})\n\t\t\tconst events = docs as unknown as RealtimeEvent[]\n\t\t\tconst { rows, totals } = buildRealtime(events, q.dateRange, q.metrics)\n\t\t\treturn { rows, totals, meta: { provider: 'native', fetchedAt } }\n\t\t},\n\t}\n}\n"],"mappings":"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"}
|
|
1
|
+
{"version":3,"file":"nativeAdapter.js","names":[],"sources":["../../src/native/nativeAdapter.ts"],"sourcesContent":["import type { Config, Payload } from 'payload'\nimport type { CaptureSupport } from '../core/capture'\nimport type {\n\tAdapterContext,\n\tAnalyticsAdapter,\n\tAnalyticsCapabilities,\n\tAnalyticsQuery,\n\tAnalyticsResult,\n\tAnalyticsRow,\n\tDimensionKey,\n\tMetricKey,\n} from '../core/contract'\nimport type { IngestHostnameResolver } from '../core/serverEvent'\nimport { INGEST_PATH } from '../plugin/paths'\nimport { EVENTS_SLUG, eventsCollection } from './collections/events'\nimport { ROLLUPS_SLUG, rollupsCollection } from './collections/rollups'\nimport { seenCollection } from './collections/seen'\nimport { EVENT_SCAN_LIMIT, eventScanMeta } from './eventScan'\nimport { composeGeoResolvers } from './geo/composeGeoResolvers'\nimport { type GeoResolver, platformHeaderResolver } from './geo/geoResolver'\nimport { maxmindResolver } from './geo/maxmindResolver'\nimport { type BotFilter, resolveBotFilter } from './ingest/bots'\nimport { type IngestAttribution, type IngestResolvers, makeIngestHandler } from './ingest/endpoint'\nimport { flushBatch } from './ingest/flushBatch'\nimport type { StoredEvent } from './ingest/normalizeEvent'\nimport {\n\ttype HostnameOption,\n\thostnameSet,\n\tresolveEventHostname,\n\tresolveHostnameOption,\n} from './ingest/resolveHostname'\nimport { makeServerTrack } from './ingest/serverTrack'\nimport { createWriteBuffer, type WriteBuffer } from './ingest/writeBuffer'\nimport { aggregateEvents, type EventLike, filtersToWhere } from './query/eventAgg'\nimport { buildRealtime, type RealtimeEvent } from './realtime/buildRealtime'\nimport { pruneEventsTask } from './retention/pruneTask'\nimport {\n\ttype Acc,\n\tadd,\n\temptyAcc,\n\ttype RollupDoc,\n\tselectMetrics,\n\tseriesFromRollups,\n} from './rollupAcc'\n\nexport type { EventHostnameResolver, HostnameOption } from './ingest/resolveHostname'\n\nexport interface NativeOptions {\n\tgeoResolver?: GeoResolver\n\tgeoDbPath?: string\n\tingestPath?: string\n\t/**\n\t * Events and seen-ledger rows older than this many days are deleted by the nightly task.\n\t * Zero or less means keep everything; anything else must be a whole number of days, so a\n\t * window the sweep could not turn into a cutoff fails the boot.\n\t */\n\tretentionDays?: number\n\t/**\n\t * Rollup rows older than this many days are deleted by the nightly task. Off by default,\n\t * since rollups are the long-term store. It requires `retentionDays` and cannot be shorter\n\t * than it: a window reaching past raw-event retention is answered from rollups, so a shorter\n\t * rollup window would make a long window report less than a short one.\n\t */\n\trollupRetentionDays?: number\n\t/** Opt-in in-process write batching. `true` uses defaults (maxSize 50, maxAgeMs 2000). */\n\tbuffer?: boolean | { maxSize?: number; maxAgeMs?: number }\n\t/**\n\t * Where an event's hostname comes from. `'request'` (the default) stores the host the\n\t * request carried and ignores the body's claim, so a scripted client cannot mint hostname\n\t * buckets. A list stores the request host only when it is one of those, for an install\n\t * behind no host validation at all. A resolver decides per event, and returning null drops\n\t * it. A dropped event is answered exactly like an accepted one.\n\t */\n\thostname?: HostnameOption\n\t/**\n\t * Hostnames that keep ingesting on a scoped install even when the request resolves no\n\t * scope: the platform's own domains, which are infrastructure rather than tenants. Their\n\t * events are stored under the null scope. Tenant domains need no entry here, since the\n\t * install's own `scopeResolver` already answers for them.\n\t */\n\tplatformHostnames?: string[]\n\t/**\n\t * Whether crawlers, monitors and headless clients are dropped at ingest, by their user\n\t * agent. On by default. A function decides for itself and receives the raw agent; `false`\n\t * counts every beacon. A dropped bot is answered exactly like an accepted event, and\n\t * `trackServerEvent` is trusted host code that is never filtered.\n\t */\n\tfilterBots?: boolean | BotFilter\n}\n\nexport type NativeAdapter = AnalyticsAdapter & { flush: () => Promise<void> }\n\nconst metrics: ReadonlySet<MetricKey> = new Set([\n\t'pageviews',\n\t'visitors',\n\t'sessions',\n\t'events',\n\t'avgDuration',\n\t'conversions',\n\t'revenue',\n\t'scrollDepth',\n])\n/**\n * Everything the tracker can know about a hit. `source` is the visit's named origin (its\n * `utm_source`, else the referrer host, else `direct`), `channel` the acquisition channel that\n * origin classifies into (`organic-search`, `paid-social`, ...) and `referrer` the host it came\n * from, so a report can ask how much of the month was paid search without reading a list of\n * hostnames.\n */\nconst dimensions: ReadonlySet<DimensionKey> = new Set([\n\t'page',\n\t'referrer',\n\t'source',\n\t'channel',\n\t'utmSource',\n\t'utmMedium',\n\t'utmCampaign',\n\t'utmContent',\n\t'utmTerm',\n\t'device',\n\t'browser',\n\t'os',\n\t'country',\n\t'region',\n\t'city',\n\t'language',\n\t'event',\n\t'goal',\n])\n\nconst baseCapabilities: AnalyticsCapabilities = {\n\tperPageQuery: true,\n\trealtime: true,\n\trealtimeWindowMinutes: 60,\n\tminGranularity: 'hour',\n\tmaxLookbackDays: null,\n\tmetrics,\n\tdimensions,\n\t// Every dimension except `goal`, whose completions live in a json column rather than a\n\t// field a `where` can compare.\n\tfilters: new Set([...dimensions].filter((dimension) => dimension !== 'goal')),\n\t// No `matches`: every regex flavor the providers offer differs, and the two database\n\t// adapters have no portable one to match them with.\n\tfilterOperators: new Set(['eq', 'contains']),\n\tbatchPageReport: true,\n\trateLimit: null,\n\trecommendedTtl: { realtime: 10, aggregate: 300 },\n}\n\nconst DAY_MS = 86_400_000\n\n// The tracker itself is the client (an RSC renders TrackerBoot), so there is nothing to\n// proxy or inject; the ingest path is carried by the tracker config resolver instead.\nconst nativeCapture: CaptureSupport = {\n\tproxy: { routes: [] },\n\tsnippet: () => ({ scripts: [] }),\n\tclient: { kind: 'native' },\n}\n\ninterface QueryEventsContext {\n\tretentionDays?: number\n\tscopeWhere: (q: AnalyticsQuery) => Record<string, unknown>\n}\n\n/**\n * Filtered/hour-granularity reads bypass the day-bucketed rollups and aggregate raw\n * events directly, under the same hard cap as `realtime()`. `retentionDays` clamps how\n * far back the read can reach when it would otherwise ask for events the prune task has\n * already deleted (or will delete before they're queryable).\n */\nasync function queryEvents(\n\tpayload: Payload,\n\tq: AnalyticsQuery,\n\tctx: QueryEventsContext\n): Promise<AnalyticsResult> {\n\tconst fetchedAt = q.dateRange.end.toISOString()\n\tlet start = q.dateRange.start\n\tlet clamped = false\n\tif (ctx.retentionDays && ctx.retentionDays > 0) {\n\t\tconst floor = new Date(Date.now() - ctx.retentionDays * DAY_MS)\n\t\tif (start < floor) {\n\t\t\tstart = floor\n\t\t\tclamped = true\n\t\t}\n\t}\n\tconst baseWhere: Record<string, unknown> = {\n\t\ttimestamp: {\n\t\t\tgreater_than_equal: start.toISOString(),\n\t\t\tless_than_equal: q.dateRange.end.toISOString(),\n\t\t},\n\t\t...(q.hostname ? { hostname: { equals: q.hostname } } : {}),\n\t\t...(q.path ? { path: { equals: q.path } } : {}),\n\t\t...ctx.scopeWhere(q),\n\t}\n\t// filtersToWhere can also key off 'path' (a page filter); AND rather than spread so\n\t// q.path and a page filter both constrain the query instead of one overwriting the other.\n\tconst filterWhere = filtersToWhere(q.filters ?? [])\n\tconst where: Record<string, unknown> =\n\t\tObject.keys(filterWhere).length > 0 ? { and: [baseWhere, filterWhere] } : baseWhere\n\tconst { docs } = await payload.find({\n\t\tcollection: EVENTS_SLUG as never,\n\t\twhere: where as never,\n\t\t// Newest-first under a hard cap, same tradeoff as realtime(): a very busy site\n\t\t// with more events than the cap in range keeps its most recent activity.\n\t\tlimit: EVENT_SCAN_LIMIT,\n\t\tpagination: false,\n\t\tdepth: 0,\n\t\tsort: '-timestamp',\n\t})\n\t// The events collection is registered at runtime, so `payload.find` hands back\n\t// `JsonObject & TypeWithID`: a field-by-field mapping would read `any` per column and\n\t// duplicate the ingest schema without adding a check. This is the one typed boundary.\n\tconst events = docs as unknown as EventLike[]\n\tconst dim = q.dimensions?.find((d) => dimensions.has(d))\n\tconst granularity =\n\t\tq.granularity === 'hour' || q.granularity === 'day' ? q.granularity : undefined\n\tconst { rows, totals } = aggregateEvents(events, {\n\t\tmetrics: q.metrics,\n\t\tdimension: dim,\n\t\tgranularity,\n\t\ttimezone: q.timezone,\n\t\torder: q.order,\n\t\tlimit: q.limit,\n\t})\n\treturn { rows, totals, meta: eventScanMeta({ fetchedAt, eventCount: events.length, clamped }) }\n}\n\n/** Config-time window validation, so a nonsense window fails the boot rather than the sweep. */\nconst retentionWindow = (value: number | undefined, option: string): number | undefined => {\n\tif (value === undefined) {\n\t\treturn undefined\n\t}\n\tif (!Number.isInteger(value) || value <= 0) {\n\t\tthrow new Error(\n\t\t\t`analytics: ${option} must be a whole number of days above zero, got ${String(value)}`\n\t\t)\n\t}\n\treturn value\n}\n\nexport function native(options: NativeOptions = {}): NativeAdapter {\n\t// Validated here so a bad list fails the boot rather than dropping every event at runtime.\n\tconst hostname = resolveHostnameOption(options.hostname)\n\tconst filterBots = resolveBotFilter(options.filterBots)\n\tconst rollupRetentionDays = retentionWindow(options.rollupRetentionDays, 'rollupRetentionDays')\n\t// Zero and below have always meant \"keep everything\", so they stay a no-op rather than a throw.\n\t// Anything above zero goes through the same check as the rollup window, so a window the sweep\n\t// could not build a cutoff from fails the boot instead of the first nightly run.\n\tconst retentionDays = retentionWindow(\n\t\toptions.retentionDays !== undefined && options.retentionDays <= 0\n\t\t\t? undefined\n\t\t\t: options.retentionDays,\n\t\t'retentionDays'\n\t)\n\tif (rollupRetentionDays !== undefined && retentionDays === undefined) {\n\t\tthrow new Error(\n\t\t\t'analytics: rollupRetentionDays requires retentionDays, since pruning rollups while keeping raw events forever would make an unfiltered long window answer less than the same window filtered'\n\t\t)\n\t}\n\tif (\n\t\trollupRetentionDays !== undefined &&\n\t\tretentionDays !== undefined &&\n\t\trollupRetentionDays < retentionDays\n\t) {\n\t\tthrow new Error(\n\t\t\t`analytics: rollupRetentionDays (${rollupRetentionDays}) must not be shorter than retentionDays (${retentionDays}), since windows beyond retentionDays are answered from rollups`\n\t\t)\n\t}\n\tconst platformHostnames = hostnameSet(options.platformHostnames, 'platformHostnames')\n\tconst geoResolver =\n\t\toptions.geoResolver ??\n\t\t(options.geoDbPath\n\t\t\t? composeGeoResolvers(platformHeaderResolver, maxmindResolver({ dbPath: options.geoDbPath }))\n\t\t\t: platformHeaderResolver)\n\t// Per-instance copy: register() flips scopedQueries when the install is scoped.\n\tconst capabilities: AnalyticsCapabilities = { ...baseCapabilities }\n\tlet payloadRef: Payload | null = null\n\tlet buffer: WriteBuffer<StoredEvent> | null = null\n\tlet scoped = false\n\n\tconst scopeWhere = (q: AnalyticsQuery): Record<string, unknown> =>\n\t\tscoped && q.scope !== undefined ? { scope: { equals: q.scope } } : {}\n\n\tconst readRollups = async (\n\t\tpayload: Payload,\n\t\twhere: Record<string, unknown>\n\t): Promise<RollupDoc[]> => {\n\t\tconst { docs } = await payload.find({\n\t\t\tcollection: ROLLUPS_SLUG as never,\n\t\t\twhere: where as never,\n\t\t\tlimit: 100_000,\n\t\t\tpagination: false,\n\t\t})\n\t\treturn docs as unknown as RollupDoc[]\n\t}\n\n\t// The plugin's resolvers arrive in register(); server tracking reads them late so it\n\t// resolves the same scope, timezone and goals the endpoint does.\n\tlet resolvers: IngestResolvers = {}\n\tlet attribution: IngestAttribution = {}\n\n\tconst ingest = {\n\t\tpath: options.ingestPath ?? INGEST_PATH,\n\t\ttrack: makeServerTrack({\n\t\t\tgetPayload: () => payloadRef,\n\t\t\tgeoResolver,\n\t\t\tgetBuffer: () => buffer,\n\t\t\tgetResolvers: () => resolvers,\n\t\t\tgetAttribution: () => attribution,\n\t\t}),\n\t\t// The endpoint's own hostname policy, minus the scoped-install drop rule: a caller on\n\t\t// this seam already knows the boundary its event belongs to.\n\t\thostname: (args: Parameters<IngestHostnameResolver>[0]) =>\n\t\t\tresolveEventHostname({\n\t\t\t\toption: hostname,\n\t\t\t\tclaimed: args.claimed,\n\t\t\t\treq: args.req,\n\t\t\t\tscope: args.scope ?? null,\n\t\t\t\ttrustedProxyHops: attribution.trustedProxyHops,\n\t\t\t}),\n\t}\n\n\treturn {\n\t\tid: 'native',\n\t\tlabel: 'Native (Payload)',\n\t\tcapabilities,\n\t\tcapture: nativeCapture,\n\t\tingest,\n\t\tisConfigured: () => true,\n\t\tflush: () => buffer?.flush() ?? Promise.resolve(),\n\t\tregister(config: Config, context) {\n\t\t\tscoped = context?.scoped ?? false\n\t\t\tif (scoped) {\n\t\t\t\tcapabilities.scopedQueries = true\n\t\t\t}\n\t\t\tconfig.collections = [\n\t\t\t\t...(config.collections ?? []),\n\t\t\t\teventsCollection(scoped),\n\t\t\t\trollupsCollection(scoped),\n\t\t\t\tseenCollection(),\n\t\t\t]\n\t\t\tresolvers = {\n\t\t\t\tscope: scoped ? context?.resolveScope : undefined,\n\t\t\t\ttimezone: context?.resolveTimezone,\n\t\t\t\tgoals: context?.resolveGoals,\n\t\t\t}\n\t\t\tattribution = {\n\t\t\t\ttrustedProxyHops: context?.trustedProxyHops,\n\t\t\t\thostname,\n\t\t\t\tplatformHostnames,\n\t\t\t}\n\t\t\tconfig.endpoints = [\n\t\t\t\t...(config.endpoints ?? []),\n\t\t\t\t{\n\t\t\t\t\tmethod: 'post',\n\t\t\t\t\tpath: ingest.path,\n\t\t\t\t\thandler: makeIngestHandler({\n\t\t\t\t\t\tgeoResolver,\n\t\t\t\t\t\tgetBuffer: () => buffer,\n\t\t\t\t\t\tresolvers,\n\t\t\t\t\t\tattribution,\n\t\t\t\t\t\tfilterBots,\n\t\t\t\t\t}),\n\t\t\t\t},\n\t\t\t]\n\t\t\t// Only with a window: payload derives jobs.enabled from the task count, so registering\n\t\t\t// unconditionally would add the jobs collection and stats global (a migration on\n\t\t\t// migrate-mode Postgres) to installs that asked for neither jobs nor retention.\n\t\t\tif (retentionDays !== undefined || rollupRetentionDays !== undefined) {\n\t\t\t\tconfig.jobs = {\n\t\t\t\t\t...config.jobs,\n\t\t\t\t\ttasks: [\n\t\t\t\t\t\t...(config.jobs?.tasks ?? []),\n\t\t\t\t\t\tpruneEventsTask({ retentionDays, rollupRetentionDays }),\n\t\t\t\t\t],\n\t\t\t\t}\n\t\t\t}\n\t\t\tconst prevOnInit = config.onInit\n\t\t\t// payloadRef is set before the app's own onInit so consumer init code can\n\t\t\t// already query the native adapter.\n\t\t\tconfig.onInit = async (p) => {\n\t\t\t\tpayloadRef = p\n\t\t\t\tif (options.buffer) {\n\t\t\t\t\tconst cfg = options.buffer === true ? {} : options.buffer\n\t\t\t\t\tbuffer = createWriteBuffer<StoredEvent>({\n\t\t\t\t\t\tmaxSize: cfg.maxSize ?? 50,\n\t\t\t\t\t\tmaxAgeMs: cfg.maxAgeMs ?? 2000,\n\t\t\t\t\t\tonFlush: (batch) => flushBatch(p, batch),\n\t\t\t\t\t\tonError: (error) => {\n\t\t\t\t\t\t\tp.logger.error({ err: error, msg: 'analytics: write buffer flush failed' })\n\t\t\t\t\t\t},\n\t\t\t\t\t})\n\t\t\t\t}\n\t\t\t\tawait prevOnInit?.(p)\n\t\t\t}\n\t\t},\n\t\tasync query(q: AnalyticsQuery): Promise<AnalyticsResult> {\n\t\t\tif (!payloadRef) {\n\t\t\t\tthrow new Error('analytics: native adapter queried before init')\n\t\t\t}\n\t\t\tif ((q.filters && q.filters.length > 0) || q.granularity === 'hour') {\n\t\t\t\treturn queryEvents(payloadRef, q, { retentionDays, scopeWhere })\n\t\t\t}\n\t\t\tconst fetchedAt = q.dateRange.end.toISOString()\n\t\t\tconst periodWhere = {\n\t\t\t\tgreater_than_equal: q.dateRange.start.toISOString(),\n\t\t\t\tless_than_equal: q.dateRange.end.toISOString(),\n\t\t\t}\n\t\t\tconst dim = q.dimensions?.find((d) => dimensions.has(d))\n\n\t\t\t// Distinct metrics (visitors/sessions) must not be summed across breakdown rows.\n\t\t\t// Totals always come from the non-dimensioned aggregate row. A dimensioned query\n\t\t\t// reports site-wide totals (path=''), a plain query uses the path-scoped row.\n\t\t\tconst totalsPath = dim ? '' : (q.path ?? '')\n\t\t\tconst totalsDocs = await readRollups(payloadRef, {\n\t\t\t\tgranularity: { equals: 'day' },\n\t\t\t\tdimension: { equals: '' },\n\t\t\t\tpath: { equals: totalsPath },\n\t\t\t\thostname: { equals: q.hostname ?? '' },\n\t\t\t\tperiod: periodWhere,\n\t\t\t\t...scopeWhere(q),\n\t\t\t})\n\t\t\tconst totalsAcc = emptyAcc()\n\t\t\tfor (const d of totalsDocs) {\n\t\t\t\tadd(totalsAcc, d)\n\t\t\t}\n\t\t\tconst totals = selectMetrics(totalsAcc, q.metrics)\n\n\t\t\tif (!dim) {\n\t\t\t\tif (q.granularity === 'day') {\n\t\t\t\t\treturn {\n\t\t\t\t\t\trows: seriesFromRollups(totalsDocs, q.metrics, q.timezone),\n\t\t\t\t\t\ttotals,\n\t\t\t\t\t\tmeta: { provider: 'native', fetchedAt },\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t\treturn { rows: [{ metrics: totals }], totals, meta: { provider: 'native', fetchedAt } }\n\t\t\t}\n\n\t\t\tconst breakdownWhere =\n\t\t\t\tdim === 'page'\n\t\t\t\t\t? {\n\t\t\t\t\t\t\tgranularity: { equals: 'day' },\n\t\t\t\t\t\t\tdimension: { equals: '' },\n\t\t\t\t\t\t\tpath: { not_equals: '' },\n\t\t\t\t\t\t\thostname: { equals: q.hostname ?? '' },\n\t\t\t\t\t\t\tperiod: periodWhere,\n\t\t\t\t\t\t\t...scopeWhere(q),\n\t\t\t\t\t\t}\n\t\t\t\t\t: {\n\t\t\t\t\t\t\tgranularity: { equals: 'day' },\n\t\t\t\t\t\t\tdimension: { equals: dim },\n\t\t\t\t\t\t\tpath: { equals: '' },\n\t\t\t\t\t\t\thostname: { equals: q.hostname ?? '' },\n\t\t\t\t\t\t\tperiod: periodWhere,\n\t\t\t\t\t\t\t...scopeWhere(q),\n\t\t\t\t\t\t}\n\t\t\tconst groups = new Map<string, Acc>()\n\t\t\tfor (const d of await readRollups(payloadRef, breakdownWhere)) {\n\t\t\t\tconst value = dim === 'page' ? d.path : d.dimvalue\n\t\t\t\tlet acc = groups.get(value)\n\t\t\t\tif (!acc) {\n\t\t\t\t\tacc = emptyAcc()\n\t\t\t\t\tgroups.set(value, acc)\n\t\t\t\t}\n\t\t\t\tadd(acc, d)\n\t\t\t}\n\t\t\tlet rows: AnalyticsRow[] = [...groups].map(([value, acc]) => ({\n\t\t\t\tdimensions: { [dim]: value } as Partial<Record<DimensionKey, string>>,\n\t\t\t\tmetrics: selectMetrics(acc, q.metrics),\n\t\t\t}))\n\t\t\tconst sortMetric = q.order?.metric ?? 'pageviews'\n\t\t\tconst direction = (q.order?.direction ?? 'desc') === 'asc' ? 1 : -1\n\t\t\trows.sort((a, b) => ((a.metrics[sortMetric] ?? 0) - (b.metrics[sortMetric] ?? 0)) * direction)\n\t\t\tif (q.limit) {\n\t\t\t\trows = rows.slice(0, q.limit)\n\t\t\t}\n\t\t\treturn { rows, totals, meta: { provider: 'native', fetchedAt } }\n\t\t},\n\t\tasync realtime(q: AnalyticsQuery, _ctx: AdapterContext): Promise<AnalyticsResult> {\n\t\t\tif (!payloadRef) {\n\t\t\t\tthrow new Error('analytics: native adapter queried before init')\n\t\t\t}\n\t\t\tconst fetchedAt = q.dateRange.end.toISOString()\n\t\t\tconst { docs } = await payloadRef.find({\n\t\t\t\tcollection: EVENTS_SLUG as never,\n\t\t\t\twhere: {\n\t\t\t\t\ttimestamp: {\n\t\t\t\t\t\tgreater_than_equal: q.dateRange.start.toISOString(),\n\t\t\t\t\t\tless_than_equal: q.dateRange.end.toISOString(),\n\t\t\t\t\t},\n\t\t\t\t\t...(q.hostname ? { hostname: { equals: q.hostname } } : {}),\n\t\t\t\t\t...(q.path ? { path: { equals: q.path } } : {}),\n\t\t\t\t\t...scopeWhere(q),\n\t\t\t\t} as never,\n\t\t\t\t// Newest-first under a hard cap: if a very busy site has more events than the\n\t\t\t\t// cap in the window, keep the most recent activity rather than the oldest.\n\t\t\t\t// Unbounded accuracy via DB-side aggregation is deferred to the hardening spec.\n\t\t\t\tlimit: EVENT_SCAN_LIMIT,\n\t\t\t\tpagination: false,\n\t\t\t\tdepth: 0,\n\t\t\t\tsort: '-timestamp',\n\t\t\t})\n\t\t\tconst events = docs as unknown as RealtimeEvent[]\n\t\t\tconst { rows, totals } = buildRealtime(events, q.dateRange, q.metrics)\n\t\t\treturn { rows, totals, meta: eventScanMeta({ fetchedAt, eventCount: events.length }) }\n\t\t},\n\t}\n}\n"],"mappings":"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"}
|
|
@@ -0,0 +1,175 @@
|
|
|
1
|
+
import { startOfDayInTz } from "../../timeframe/tz.js";
|
|
2
|
+
//#region src/native/query/eventAgg.ts
|
|
3
|
+
const HOUR_MS = 36e5;
|
|
4
|
+
/**
|
|
5
|
+
* Dimensions native can filter/group on directly against the events collection. `referrer`
|
|
6
|
+
* reads the host derived at ingest rather than the raw referrer, since a `where` cannot
|
|
7
|
+
* reduce a URL to its host; it is the same field the rollup bucket is keyed by.
|
|
8
|
+
*/
|
|
9
|
+
const EVENT_FIELD = {
|
|
10
|
+
page: "path",
|
|
11
|
+
country: "country",
|
|
12
|
+
region: "region",
|
|
13
|
+
city: "city",
|
|
14
|
+
device: "device",
|
|
15
|
+
browser: "browser",
|
|
16
|
+
os: "os",
|
|
17
|
+
language: "language",
|
|
18
|
+
source: "source",
|
|
19
|
+
channel: "channel",
|
|
20
|
+
referrer: "referrerHost",
|
|
21
|
+
utmSource: "utmSource",
|
|
22
|
+
utmMedium: "utmMedium",
|
|
23
|
+
utmCampaign: "utmCampaign",
|
|
24
|
+
utmContent: "utmContent",
|
|
25
|
+
utmTerm: "utmTerm",
|
|
26
|
+
event: "name"
|
|
27
|
+
};
|
|
28
|
+
const FILTER_OPERATOR = {
|
|
29
|
+
eq: "equals",
|
|
30
|
+
contains: "contains"
|
|
31
|
+
};
|
|
32
|
+
/**
|
|
33
|
+
* Payload where fragment for supported filters; unsupported dimensions/operators are
|
|
34
|
+
* dropped. Capability gating (`filters`/`filterOperators`) is the real contract upstream,
|
|
35
|
+
* this is just the safety net so a stray unsupported filter never throws.
|
|
36
|
+
* `contains` is case-insensitive on both DBs; on Postgres its value is a raw ILIKE
|
|
37
|
+
* pattern (`%`/`_` act as wildcards), while Mongo regex-escapes the value first.
|
|
38
|
+
* One fragment per filter under `and`, not merged by key: two filters on the same field
|
|
39
|
+
* (e.g. two `eq` values) must both constrain the query rather than the later one silently
|
|
40
|
+
* overwriting the earlier one.
|
|
41
|
+
*/
|
|
42
|
+
const filtersToWhere = (filters) => {
|
|
43
|
+
const fragments = [];
|
|
44
|
+
for (const filter of filters) {
|
|
45
|
+
const field = EVENT_FIELD[filter.dimension];
|
|
46
|
+
if (!field || filter.operator === "matches") continue;
|
|
47
|
+
const op = FILTER_OPERATOR[filter.operator];
|
|
48
|
+
if (!op) continue;
|
|
49
|
+
fragments.push({ [field]: { [op]: filter.value } });
|
|
50
|
+
}
|
|
51
|
+
return fragments.length > 0 ? { and: fragments } : {};
|
|
52
|
+
};
|
|
53
|
+
const emptyBucket = () => ({
|
|
54
|
+
pageviews: 0,
|
|
55
|
+
events: 0,
|
|
56
|
+
durationMs: 0,
|
|
57
|
+
visitors: /* @__PURE__ */ new Set(),
|
|
58
|
+
sessions: /* @__PURE__ */ new Set(),
|
|
59
|
+
conversions: 0,
|
|
60
|
+
revenue: 0,
|
|
61
|
+
scrollDepthSum: 0,
|
|
62
|
+
scrollSamples: 0
|
|
63
|
+
});
|
|
64
|
+
/**
|
|
65
|
+
* `completions` narrows what the event contributes to conversions/revenue: a goal breakdown
|
|
66
|
+
* row counts only its own goal, every other bucket counts all of them. Mirrors how
|
|
67
|
+
* computeRollupDeltas fills a `goal` bucket versus a site or page bucket.
|
|
68
|
+
*/
|
|
69
|
+
const addEvent = (bucket, event, completions = event.goals ?? []) => {
|
|
70
|
+
if (event.type === "pageview") {
|
|
71
|
+
bucket.pageviews++;
|
|
72
|
+
bucket.durationMs += event.durationMs ?? 0;
|
|
73
|
+
} else bucket.events++;
|
|
74
|
+
if (typeof event.scrollDepth === "number") {
|
|
75
|
+
bucket.scrollDepthSum += event.scrollDepth;
|
|
76
|
+
bucket.scrollSamples++;
|
|
77
|
+
}
|
|
78
|
+
bucket.conversions += completions.length;
|
|
79
|
+
for (const completion of completions) bucket.revenue += completion.value;
|
|
80
|
+
bucket.visitors.add(event.visitorHash);
|
|
81
|
+
bucket.sessions.add(event.sessionId);
|
|
82
|
+
};
|
|
83
|
+
const selectMetrics = (bucket, wanted) => {
|
|
84
|
+
const out = {};
|
|
85
|
+
if (wanted.includes("pageviews")) out.pageviews = bucket.pageviews;
|
|
86
|
+
if (wanted.includes("events")) out.events = bucket.events;
|
|
87
|
+
if (wanted.includes("visitors")) out.visitors = bucket.visitors.size;
|
|
88
|
+
if (wanted.includes("sessions")) out.sessions = bucket.sessions.size;
|
|
89
|
+
if (wanted.includes("conversions")) out.conversions = bucket.conversions;
|
|
90
|
+
if (wanted.includes("revenue")) out.revenue = bucket.revenue;
|
|
91
|
+
if (wanted.includes("avgDuration")) out.avgDuration = bucket.pageviews > 0 ? Math.round(bucket.durationMs / bucket.pageviews) : 0;
|
|
92
|
+
if (wanted.includes("scrollDepth")) out.scrollDepth = bucket.scrollSamples > 0 ? Math.round(bucket.scrollDepthSum / bucket.scrollSamples) : 0;
|
|
93
|
+
return out;
|
|
94
|
+
};
|
|
95
|
+
/**
|
|
96
|
+
* Hour buckets are UTC-hour floors regardless of `timezone`; sub-day bucketing ignoring
|
|
97
|
+
* the reporting timezone is a documented v1 limitation. Day buckets floor in `timezone`
|
|
98
|
+
* to stay aligned with native rollup day boundaries.
|
|
99
|
+
*/
|
|
100
|
+
const bucketKeyFor = (event, granularity, timezone) => {
|
|
101
|
+
const ts = new Date(event.timestamp);
|
|
102
|
+
if (granularity === "hour") return (/* @__PURE__ */ new Date(Math.floor(ts.getTime() / HOUR_MS) * HOUR_MS)).toISOString();
|
|
103
|
+
return startOfDayInTz(ts, timezone).toISOString();
|
|
104
|
+
};
|
|
105
|
+
/**
|
|
106
|
+
* Aggregate raw events into totals, plus one of: dimension breakdown rows or hour/day
|
|
107
|
+
* series rows (dimension wins if both are requested). Totals always cover every event
|
|
108
|
+
* passed in, independent of which rows a breakdown or series produces.
|
|
109
|
+
*/
|
|
110
|
+
const aggregateEvents = (events, { metrics, dimension, granularity, timezone = "UTC", order, limit }) => {
|
|
111
|
+
const totalsBucket = emptyBucket();
|
|
112
|
+
for (const event of events) addEvent(totalsBucket, event);
|
|
113
|
+
const totals = selectMetrics(totalsBucket, metrics);
|
|
114
|
+
const field = dimension ? EVENT_FIELD[dimension] : void 0;
|
|
115
|
+
if (dimension && (field || dimension === "goal")) {
|
|
116
|
+
const groups = /* @__PURE__ */ new Map();
|
|
117
|
+
const bucketFor = (value) => {
|
|
118
|
+
let bucket = groups.get(value);
|
|
119
|
+
if (!bucket) {
|
|
120
|
+
bucket = emptyBucket();
|
|
121
|
+
groups.set(value, bucket);
|
|
122
|
+
}
|
|
123
|
+
return bucket;
|
|
124
|
+
};
|
|
125
|
+
for (const event of events) {
|
|
126
|
+
if (dimension === "goal") {
|
|
127
|
+
for (const completion of event.goals ?? []) addEvent(bucketFor(completion.slug), event, [completion]);
|
|
128
|
+
continue;
|
|
129
|
+
}
|
|
130
|
+
if (!field || field === "name" && event.type !== "event") continue;
|
|
131
|
+
const value = event[field];
|
|
132
|
+
if (!value) continue;
|
|
133
|
+
addEvent(bucketFor(value), event);
|
|
134
|
+
}
|
|
135
|
+
let rows = [...groups].map(([value, bucket]) => ({
|
|
136
|
+
dimensions: { [dimension]: value },
|
|
137
|
+
metrics: selectMetrics(bucket, metrics)
|
|
138
|
+
}));
|
|
139
|
+
const sortMetric = order?.metric ?? "pageviews";
|
|
140
|
+
const direction = (order?.direction ?? "desc") === "asc" ? 1 : -1;
|
|
141
|
+
rows.sort((a, b) => ((a.metrics[sortMetric] ?? 0) - (b.metrics[sortMetric] ?? 0)) * direction);
|
|
142
|
+
if (limit) rows = rows.slice(0, limit);
|
|
143
|
+
return {
|
|
144
|
+
rows,
|
|
145
|
+
totals
|
|
146
|
+
};
|
|
147
|
+
}
|
|
148
|
+
if (granularity) {
|
|
149
|
+
const buckets = /* @__PURE__ */ new Map();
|
|
150
|
+
for (const event of events) {
|
|
151
|
+
const key = bucketKeyFor(event, granularity, timezone);
|
|
152
|
+
let bucket = buckets.get(key);
|
|
153
|
+
if (!bucket) {
|
|
154
|
+
bucket = emptyBucket();
|
|
155
|
+
buckets.set(key, bucket);
|
|
156
|
+
}
|
|
157
|
+
addEvent(bucket, event);
|
|
158
|
+
}
|
|
159
|
+
return {
|
|
160
|
+
rows: [...buckets.entries()].sort(([a], [b]) => a < b ? -1 : a > b ? 1 : 0).map(([timestamp, bucket]) => ({
|
|
161
|
+
timestamp,
|
|
162
|
+
metrics: selectMetrics(bucket, metrics)
|
|
163
|
+
})),
|
|
164
|
+
totals
|
|
165
|
+
};
|
|
166
|
+
}
|
|
167
|
+
return {
|
|
168
|
+
rows: [{ metrics: totals }],
|
|
169
|
+
totals
|
|
170
|
+
};
|
|
171
|
+
};
|
|
172
|
+
//#endregion
|
|
173
|
+
export { aggregateEvents, filtersToWhere };
|
|
174
|
+
|
|
175
|
+
//# sourceMappingURL=eventAgg.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"eventAgg.js","names":[],"sources":["../../../src/native/query/eventAgg.ts"],"sourcesContent":["import type { AnalyticsFilter, AnalyticsRow, DimensionKey, MetricKey } from '../../core/contract'\nimport { DEFAULT_TIMEZONE, startOfDayInTz } from '../../timeframe/tz'\n\n/**\n * Raw event shape aggregateEvents/filtersToWhere operate on; matches StoredEvent as read back\n * from the events collection (timestamp comes back as an ISO string). Every column the ingest\n * may leave unset is `| null` as well as optional: Postgres reads an unwritten column back as\n * null, Mongo leaves the key off entirely, and both spellings mean \"not recorded\".\n */\nexport interface EventLike {\n\ttimestamp: string | Date\n\ttype: 'pageview' | 'event' | 'goal'\n\tname?: string | null\n\tpath: string\n\tdevice?: string | null\n\tbrowser?: string | null\n\tos?: string | null\n\tsource?: string | null\n\tchannel?: string | null\n\t/** The referrer host derived at ingest; the raw referrer is never grouped or filtered on. */\n\treferrerHost?: string | null\n\tcountry?: string | null\n\tregion?: string | null\n\tcity?: string | null\n\tlanguage?: string | null\n\tutmSource?: string | null\n\tutmMedium?: string | null\n\tutmCampaign?: string | null\n\tutmContent?: string | null\n\tutmTerm?: string | null\n\tvisitorHash: string\n\tsessionId: string\n\tdurationMs?: number | null\n\tscrollDepth?: number | null\n\t/** Goal completions stamped at ingest; the source of conversions/revenue on this path. */\n\tgoals?: Array<{ slug: string; value: number }>\n}\n\nconst HOUR_MS = 3_600_000\n\ntype EventStringField =\n\t| 'path'\n\t| 'country'\n\t| 'region'\n\t| 'city'\n\t| 'device'\n\t| 'browser'\n\t| 'os'\n\t| 'language'\n\t| 'source'\n\t| 'channel'\n\t| 'referrerHost'\n\t| 'utmSource'\n\t| 'utmMedium'\n\t| 'utmCampaign'\n\t| 'utmContent'\n\t| 'utmTerm'\n\t| 'name'\n\n/**\n * Dimensions native can filter/group on directly against the events collection. `referrer`\n * reads the host derived at ingest rather than the raw referrer, since a `where` cannot\n * reduce a URL to its host; it is the same field the rollup bucket is keyed by.\n */\nconst EVENT_FIELD: Partial<Record<DimensionKey, EventStringField>> = {\n\tpage: 'path',\n\tcountry: 'country',\n\tregion: 'region',\n\tcity: 'city',\n\tdevice: 'device',\n\tbrowser: 'browser',\n\tos: 'os',\n\tlanguage: 'language',\n\tsource: 'source',\n\tchannel: 'channel',\n\treferrer: 'referrerHost',\n\tutmSource: 'utmSource',\n\tutmMedium: 'utmMedium',\n\tutmCampaign: 'utmCampaign',\n\tutmContent: 'utmContent',\n\tutmTerm: 'utmTerm',\n\tevent: 'name',\n}\n\nconst FILTER_OPERATOR: Record<'eq' | 'contains', string> = { eq: 'equals', contains: 'contains' }\n\n/**\n * Payload where fragment for supported filters; unsupported dimensions/operators are\n * dropped. Capability gating (`filters`/`filterOperators`) is the real contract upstream,\n * this is just the safety net so a stray unsupported filter never throws.\n * `contains` is case-insensitive on both DBs; on Postgres its value is a raw ILIKE\n * pattern (`%`/`_` act as wildcards), while Mongo regex-escapes the value first.\n * One fragment per filter under `and`, not merged by key: two filters on the same field\n * (e.g. two `eq` values) must both constrain the query rather than the later one silently\n * overwriting the earlier one.\n */\nexport const filtersToWhere = (filters: AnalyticsFilter[]): Record<string, unknown> => {\n\tconst fragments: Record<string, unknown>[] = []\n\tfor (const filter of filters) {\n\t\tconst field = EVENT_FIELD[filter.dimension]\n\t\tif (!field || filter.operator === 'matches') {\n\t\t\tcontinue\n\t\t}\n\t\tconst op = FILTER_OPERATOR[filter.operator]\n\t\tif (!op) {\n\t\t\tcontinue\n\t\t}\n\t\tfragments.push({ [field]: { [op]: filter.value } })\n\t}\n\treturn fragments.length > 0 ? { and: fragments } : {}\n}\n\ninterface Bucket {\n\tpageviews: number\n\tevents: number\n\tdurationMs: number\n\tvisitors: Set<string>\n\tsessions: Set<string>\n\tconversions: number\n\trevenue: number\n\tscrollDepthSum: number\n\tscrollSamples: number\n}\n\nconst emptyBucket = (): Bucket => ({\n\tpageviews: 0,\n\tevents: 0,\n\tdurationMs: 0,\n\tvisitors: new Set(),\n\tsessions: new Set(),\n\tconversions: 0,\n\trevenue: 0,\n\tscrollDepthSum: 0,\n\tscrollSamples: 0,\n})\n\n/**\n * `completions` narrows what the event contributes to conversions/revenue: a goal breakdown\n * row counts only its own goal, every other bucket counts all of them. Mirrors how\n * computeRollupDeltas fills a `goal` bucket versus a site or page bucket.\n */\nconst addEvent = (bucket: Bucket, event: EventLike, completions = event.goals ?? []): void => {\n\tif (event.type === 'pageview') {\n\t\tbucket.pageviews++\n\t\tbucket.durationMs += event.durationMs ?? 0\n\t} else {\n\t\tbucket.events++\n\t}\n\t// A reported 0 is a sample; a missing depth is not, however the driver spells \"missing\".\n\tif (typeof event.scrollDepth === 'number') {\n\t\tbucket.scrollDepthSum += event.scrollDepth\n\t\tbucket.scrollSamples++\n\t}\n\tbucket.conversions += completions.length\n\tfor (const completion of completions) {\n\t\tbucket.revenue += completion.value\n\t}\n\tbucket.visitors.add(event.visitorHash)\n\tbucket.sessions.add(event.sessionId)\n}\n\nconst selectMetrics = (bucket: Bucket, wanted: MetricKey[]): Partial<Record<MetricKey, number>> => {\n\tconst out: Partial<Record<MetricKey, number>> = {}\n\tif (wanted.includes('pageviews')) out.pageviews = bucket.pageviews\n\tif (wanted.includes('events')) out.events = bucket.events\n\tif (wanted.includes('visitors')) out.visitors = bucket.visitors.size\n\tif (wanted.includes('sessions')) out.sessions = bucket.sessions.size\n\tif (wanted.includes('conversions')) out.conversions = bucket.conversions\n\tif (wanted.includes('revenue')) out.revenue = bucket.revenue\n\tif (wanted.includes('avgDuration')) {\n\t\tout.avgDuration = bucket.pageviews > 0 ? Math.round(bucket.durationMs / bucket.pageviews) : 0\n\t}\n\tif (wanted.includes('scrollDepth')) {\n\t\tout.scrollDepth =\n\t\t\tbucket.scrollSamples > 0 ? Math.round(bucket.scrollDepthSum / bucket.scrollSamples) : 0\n\t}\n\treturn out\n}\n\nexport interface AggregateEventsArgs {\n\tmetrics: MetricKey[]\n\tdimension?: DimensionKey\n\tgranularity?: 'hour' | 'day'\n\ttimezone?: string\n\t/** Sort for dimension breakdown rows; defaults to pageviews desc, same as the rollup path. */\n\torder?: { metric: MetricKey; direction: 'asc' | 'desc' }\n\t/** Row cap for dimension breakdown rows, applied after sorting. */\n\tlimit?: number\n}\n\nexport interface AggregateEventsResult {\n\trows: AnalyticsRow[]\n\ttotals: Partial<Record<MetricKey, number>>\n}\n\n/**\n * Hour buckets are UTC-hour floors regardless of `timezone`; sub-day bucketing ignoring\n * the reporting timezone is a documented v1 limitation. Day buckets floor in `timezone`\n * to stay aligned with native rollup day boundaries.\n */\nconst bucketKeyFor = (event: EventLike, granularity: 'hour' | 'day', timezone: string): string => {\n\tconst ts = new Date(event.timestamp)\n\tif (granularity === 'hour') {\n\t\treturn new Date(Math.floor(ts.getTime() / HOUR_MS) * HOUR_MS).toISOString()\n\t}\n\treturn startOfDayInTz(ts, timezone).toISOString()\n}\n\n/**\n * Aggregate raw events into totals, plus one of: dimension breakdown rows or hour/day\n * series rows (dimension wins if both are requested). Totals always cover every event\n * passed in, independent of which rows a breakdown or series produces.\n */\nexport const aggregateEvents = (\n\tevents: EventLike[],\n\t{\n\t\tmetrics,\n\t\tdimension,\n\t\tgranularity,\n\t\ttimezone = DEFAULT_TIMEZONE,\n\t\torder,\n\t\tlimit,\n\t}: AggregateEventsArgs\n): AggregateEventsResult => {\n\tconst totalsBucket = emptyBucket()\n\tfor (const event of events) {\n\t\taddEvent(totalsBucket, event)\n\t}\n\tconst totals = selectMetrics(totalsBucket, metrics)\n\n\tconst field = dimension ? EVENT_FIELD[dimension] : undefined\n\tif (dimension && (field || dimension === 'goal')) {\n\t\tconst groups = new Map<string, Bucket>()\n\t\tconst bucketFor = (value: string): Bucket => {\n\t\t\tlet bucket = groups.get(value)\n\t\t\tif (!bucket) {\n\t\t\t\tbucket = emptyBucket()\n\t\t\t\tgroups.set(value, bucket)\n\t\t\t}\n\t\t\treturn bucket\n\t\t}\n\t\tfor (const event of events) {\n\t\t\tif (dimension === 'goal') {\n\t\t\t\tfor (const completion of event.goals ?? []) {\n\t\t\t\t\taddEvent(bucketFor(completion.slug), event, [completion])\n\t\t\t\t}\n\t\t\t\tcontinue\n\t\t\t}\n\t\t\t// The event dimension reports named custom events only: a goal event's name is a\n\t\t\t// goal slug and belongs to the goal dimension instead.\n\t\t\tif (!field || (field === 'name' && event.type !== 'event')) {\n\t\t\t\tcontinue\n\t\t\t}\n\t\t\tconst value = event[field]\n\t\t\tif (!value) {\n\t\t\t\tcontinue\n\t\t\t}\n\t\t\taddEvent(bucketFor(value), event)\n\t\t}\n\t\tlet rows: AnalyticsRow[] = [...groups].map(([value, bucket]) => ({\n\t\t\tdimensions: { [dimension]: value } as Partial<Record<DimensionKey, string>>,\n\t\t\tmetrics: selectMetrics(bucket, metrics),\n\t\t}))\n\t\tconst sortMetric = order?.metric ?? 'pageviews'\n\t\tconst direction = (order?.direction ?? 'desc') === 'asc' ? 1 : -1\n\t\trows.sort((a, b) => ((a.metrics[sortMetric] ?? 0) - (b.metrics[sortMetric] ?? 0)) * direction)\n\t\tif (limit) {\n\t\t\trows = rows.slice(0, limit)\n\t\t}\n\t\treturn { rows, totals }\n\t}\n\n\tif (granularity) {\n\t\tconst buckets = new Map<string, Bucket>()\n\t\tfor (const event of events) {\n\t\t\tconst key = bucketKeyFor(event, granularity, timezone)\n\t\t\tlet bucket = buckets.get(key)\n\t\t\tif (!bucket) {\n\t\t\t\tbucket = emptyBucket()\n\t\t\t\tbuckets.set(key, bucket)\n\t\t\t}\n\t\t\taddEvent(bucket, event)\n\t\t}\n\t\tconst rows: AnalyticsRow[] = [...buckets.entries()]\n\t\t\t.sort(([a], [b]) => (a < b ? -1 : a > b ? 1 : 0))\n\t\t\t.map(([timestamp, bucket]) => ({ timestamp, metrics: selectMetrics(bucket, metrics) }))\n\t\treturn { rows, totals }\n\t}\n\n\treturn { rows: [{ metrics: totals }], totals }\n}\n"],"mappings":"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"}
|