@10x-media/analytics 1.0.0-beta.6 → 1.0.0-beta.8
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 +73 -0
- package/README.md +13 -3
- package/dist/adapters/ga4/ga4.js +3 -2
- package/dist/adapters/ga4/ga4.js.map +1 -1
- package/dist/adapters/http/fetchJson.js +1 -1
- package/dist/adapters/plausible/plausible.d.ts +10 -0
- package/dist/adapters/plausible/plausible.js +42 -1
- package/dist/adapters/plausible/plausible.js.map +1 -1
- package/dist/adapters/posthog/posthog.d.ts +10 -1
- package/dist/adapters/posthog/posthog.js +47 -0
- package/dist/adapters/posthog/posthog.js.map +1 -1
- package/dist/adapters/umami/umami.d.ts +5 -1
- package/dist/adapters/umami/umami.js +26 -0
- package/dist/adapters/umami/umami.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 +123 -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 +15 -1
- package/dist/charts/BarList.js +34 -18
- 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 +2 -0
- package/dist/charts/bars.js +2 -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 +13 -1
- package/dist/core/cacheKey.js.map +1 -1
- package/dist/core/capture.d.ts +49 -0
- package/dist/core/contract.d.ts +35 -4
- package/dist/core/contract.js +29 -1
- package/dist/core/contract.js.map +1 -1
- package/dist/core/granularity.js +1 -1
- package/dist/core/options.d.ts +148 -4
- package/dist/core/options.js +121 -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 +45 -28
- package/dist/core/scopedRead.js.map +1 -1
- package/dist/core/serverEvent.d.ts +42 -0
- package/dist/core/serverEvent.js +12 -0
- package/dist/core/serverEvent.js.map +1 -0
- package/dist/exports/client.d.ts +8 -2
- package/dist/exports/client.js +6 -1
- 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 +8 -1
- package/dist/exports/rsc.js +7 -2
- package/dist/exports/tracker.d.ts +18 -0
- package/dist/exports/tracker.js +12 -0
- package/dist/exports/types.d.ts +14 -3
- package/dist/exports/types.js +2 -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/MetricSelectField.js +2 -2
- package/dist/fields/config/MetricSelectField.js.map +1 -1
- package/dist/fields/config/SourceSelectField.js +2 -2
- package/dist/fields/config/SourceSelectField.js.map +1 -1
- package/dist/fields/config/fetchSources.d.ts +5 -1
- package/dist/fields/config/narrow.js +2 -0
- package/dist/fields/config/narrow.js.map +1 -1
- package/dist/fields/readForDocument.d.ts +5 -0
- package/dist/fields/readForDocument.js +6 -6
- 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 +250 -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 +29 -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 +55 -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 +74 -0
- package/dist/goals/trackGoalAction.js +139 -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 +11 -3
- package/dist/index.js +104 -17
- package/dist/index.js.map +1 -1
- package/dist/native/collections/events.js +21 -1
- package/dist/native/collections/events.js.map +1 -1
- package/dist/native/collections/rollups.js +24 -0
- package/dist/native/collections/rollups.js.map +1 -1
- package/dist/native/geo/maxmindResolver.js +2 -4
- package/dist/native/geo/maxmindResolver.js.map +1 -1
- package/dist/native/ingest/clientIp.js +15 -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 +25 -4
- package/dist/native/ingest/endpoint.js.map +1 -1
- package/dist/native/ingest/flushBatch.js +4 -13
- package/dist/native/ingest/flushBatch.js.map +1 -1
- package/dist/native/ingest/normalizeEvent.d.ts +20 -0
- package/dist/native/ingest/normalizeEvent.js +78 -10
- package/dist/native/ingest/normalizeEvent.js.map +1 -1
- package/dist/native/ingest/serverTrack.d.ts +20 -0
- package/dist/native/ingest/serverTrack.js +99 -0
- package/dist/native/ingest/serverTrack.js.map +1 -0
- package/dist/native/ingest/validate.js +27 -0
- package/dist/native/ingest/validate.js.map +1 -0
- package/dist/native/nativeAdapter.d.ts +1 -1
- package/dist/native/nativeAdapter.js +38 -11
- package/dist/native/nativeAdapter.js.map +1 -1
- package/dist/native/query/eventAgg.js +39 -13
- package/dist/native/query/eventAgg.js.map +1 -1
- package/dist/native/retention/pruneTask.js +1 -1
- package/dist/native/rollupAcc.js +12 -1
- package/dist/native/rollupAcc.js.map +1 -1
- package/dist/native/rollups/bumpRollup.js +5 -1
- package/dist/native/rollups/bumpRollup.js.map +1 -1
- package/dist/native/rollups/deltas.js +28 -6
- package/dist/native/rollups/deltas.js.map +1 -1
- package/dist/native/rollups/insertIfNew.js +36 -2
- package/dist/native/rollups/insertIfNew.js.map +1 -1
- package/dist/next/captureRewrites.d.ts +41 -0
- package/dist/next/captureRewrites.js +56 -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 +28 -10
- package/dist/plugin/documentEndpoint.js.map +1 -1
- package/dist/plugin/paths.js +15 -1
- package/dist/plugin/paths.js.map +1 -1
- package/dist/plugin/queryEndpoint.js +113 -0
- package/dist/plugin/queryEndpoint.js.map +1 -0
- package/dist/plugin/readContextForRequest.js +71 -0
- package/dist/plugin/readContextForRequest.js.map +1 -0
- package/dist/plugin/realtimeEndpoint.js +6 -3
- package/dist/plugin/realtimeEndpoint.js.map +1 -1
- package/dist/plugin/runtime.d.ts +1 -0
- package/dist/plugin/runtime.js +31 -1
- package/dist/plugin/runtime.js.map +1 -1
- package/dist/plugin/scopeFieldBoot.js +22 -0
- package/dist/plugin/scopeFieldBoot.js.map +1 -0
- package/dist/plugin/sourcesEndpoint.js +13 -39
- 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 +71 -25
- package/dist/providers/collection.js.map +1 -1
- package/dist/providers/factory.js +8 -2
- 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 +17 -0
- package/dist/query/errors.js +10 -0
- package/dist/query/errors.js.map +1 -0
- package/dist/query/fetchQuery.d.ts +59 -0
- package/dist/query/fetchQuery.js +110 -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 +36 -0
- package/dist/react/AnalyticsProvider.d.ts +43 -0
- package/dist/react/AnalyticsProvider.js +66 -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 +17 -0
- package/dist/react/useAnalytics.js +36 -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 +44 -4
- package/dist/surfacing/engine.js.map +1 -1
- 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/syncTask.js +60 -33
- package/dist/sync/syncTask.js.map +1 -1
- package/dist/testing/memoryAdapter.d.ts +2 -0
- package/dist/testing/memoryAdapter.js +10 -0
- 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 +163 -0
- package/dist/tracker/createTracker.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/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 +14 -0
- package/dist/tracker/sinks/plausible.js +25 -0
- package/dist/tracker/sinks/plausible.js.map +1 -0
- package/dist/tracker/sinks/posthog.d.ts +14 -0
- package/dist/tracker/sinks/posthog.js +18 -0
- package/dist/tracker/sinks/posthog.js.map +1 -0
- package/dist/tracker/sinks/umami.d.ts +13 -0
- package/dist/tracker/sinks/umami.js +17 -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 +66 -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 +66 -0
- package/dist/translations/ar.js +104 -1
- package/dist/translations/ar.js.map +1 -1
- package/dist/translations/de.js +104 -1
- package/dist/translations/de.js.map +1 -1
- package/dist/translations/en.js +104 -1
- package/dist/translations/en.js.map +1 -1
- package/dist/translations/es.js +104 -1
- package/dist/translations/es.js.map +1 -1
- package/dist/translations/fr.js +104 -1
- package/dist/translations/fr.js.map +1 -1
- package/dist/translations/id.js +104 -1
- package/dist/translations/id.js.map +1 -1
- package/dist/translations/keys.d.ts +103 -0
- package/dist/translations/keys.js +104 -1
- package/dist/translations/keys.js.map +1 -1
- package/dist/translations/ko.js +104 -1
- package/dist/translations/ko.js.map +1 -1
- package/dist/translations/metricKeys.js +1 -1
- package/dist/translations/metricKeys.js.map +1 -1
- package/dist/translations/pt.js +104 -1
- package/dist/translations/pt.js.map +1 -1
- package/dist/translations/ru.js +104 -1
- package/dist/translations/ru.js.map +1 -1
- package/dist/translations/uk.js +104 -1
- package/dist/translations/uk.js.map +1 -1
- package/dist/translations/zh.js +104 -1
- package/dist/translations/zh.js.map +1 -1
- 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 +189 -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 +105 -0
- package/dist/view/gating.js.map +1 -0
- package/dist/view/labels.js +44 -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 +157 -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 +41 -0
- package/dist/view/sections/FilterChips.js.map +1 -0
- package/dist/view/sections/GoalsPanel.js +81 -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 +77 -0
- package/dist/view/sections/RealtimeStrip.js.map +1 -0
- package/dist/view/sections/Toolbar.js +179 -0
- package/dist/view/sections/Toolbar.js.map +1 -0
- package/dist/view/sections/Trend.js +119 -0
- package/dist/view/sections/Trend.js.map +1 -0
- package/dist/view/sections/styles.js +74 -0
- package/dist/view/sections/styles.js.map +1 -0
- package/dist/view/state.js +206 -0
- package/dist/view/state.js.map +1 -0
- package/dist/view/useViewQueries.js +150 -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 +22 -4
- package/dist/widgets/AnalyticsBreakdownWidget.js.map +1 -1
- package/dist/widgets/AnalyticsGoalsWidget.d.ts +14 -0
- package/dist/widgets/AnalyticsGoalsWidget.js +188 -0
- package/dist/widgets/AnalyticsGoalsWidget.js.map +1 -0
- package/dist/widgets/AnalyticsMetricWidget.d.ts +2 -1
- package/dist/widgets/AnalyticsMetricWidget.js +35 -12
- package/dist/widgets/AnalyticsMetricWidget.js.map +1 -1
- package/dist/widgets/AnalyticsRealtimeWidget.d.ts +2 -1
- package/dist/widgets/AnalyticsRealtimeWidget.js +42 -22
- package/dist/widgets/AnalyticsRealtimeWidget.js.map +1 -1
- package/dist/widgets/AnalyticsTrendWidget.d.ts +2 -1
- package/dist/widgets/AnalyticsTrendWidget.js +51 -15
- package/dist/widgets/AnalyticsTrendWidget.js.map +1 -1
- package/dist/widgets/WidgetViewLink.js +17 -0
- package/dist/widgets/WidgetViewLink.js.map +1 -0
- package/dist/widgets/breakdownTypes.js +32 -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/range.js +43 -12
- package/dist/widgets/range.js.map +1 -1
- package/dist/widgets/readForWidget.d.ts +12 -0
- package/dist/widgets/readForWidget.js +30 -19
- package/dist/widgets/readForWidget.js.map +1 -1
- package/dist/widgets/readForWidgetBreakdown.d.ts +15 -0
- package/dist/widgets/readForWidgetBreakdown.js +32 -20
- package/dist/widgets/readForWidgetBreakdown.js.map +1 -1
- package/dist/widgets/readForWidgetGoals.d.ts +57 -0
- package/dist/widgets/readForWidgetGoals.js +126 -0
- package/dist/widgets/readForWidgetGoals.js.map +1 -0
- package/dist/widgets/readForWidgetRealtime.js +1 -1
- package/dist/widgets/readForWidgetSeries.d.ts +13 -0
- package/dist/widgets/readForWidgetSeries.js +56 -28
- package/dist/widgets/readForWidgetSeries.js.map +1 -1
- package/dist/widgets/registerWidgets.js +58 -9
- package/dist/widgets/registerWidgets.js.map +1 -1
- 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 +83 -0
- package/dist/widgets/viewLink.js.map +1 -0
- package/package.json +25 -5
package/dist/index.d.ts
CHANGED
|
@@ -1,9 +1,17 @@
|
|
|
1
|
+
import { Goal, GoalMatch, TrackerGoal } from "./goals/types.js";
|
|
2
|
+
import { AnalyticsTrackError, ServerEventInput, ServerTrack, ServerTrackOptions } from "./core/serverEvent.js";
|
|
1
3
|
import { PLATFORM_SCOPE } from "./core/contract.js";
|
|
4
|
+
import { GoalsResponse, WireGoal } from "./goals/fetchGoals.js";
|
|
5
|
+
import { QueryError, QueryErrorCode } from "./query/errors.js";
|
|
6
|
+
import { QueryErrorResponse, QueryResponse, QuerySourceRef, SerializedAnalyticsQuery } from "./query/response.js";
|
|
2
7
|
import { AnalyticsBinding, BindingContext, HostnameResolver, PathResolver } from "./binding/types.js";
|
|
3
8
|
import { TimeframePreset } from "./timeframe/presets.js";
|
|
4
|
-
import { AnalyticsFieldsOptions, AnalyticsMetricLabel, AnalyticsMetricLabels, AnalyticsStatOptions, AnalyticsStatRowOptions, AnalyticsTabOptions, analyticsFields, analyticsStat, analyticsStatRow, analyticsTab, analyticsTabsField } from "./fields/factories.js";
|
|
5
9
|
import { CustomWidgetDef } from "./widgets/customWidget.js";
|
|
6
|
-
import { AnalyticsAccessOptions, AnalyticsPluginOptions, PlatformReadAccess, ProvidersCollectionOptions, ProvidersOptions, ProvidersResolve, ScopeResolver, TimezoneResolver } from "./core/options.js";
|
|
10
|
+
import { AnalyticsAccessOptions, AnalyticsCaptureOptions, AnalyticsGoalsCollectionOptions, AnalyticsGoalsOptions, AnalyticsPluginOptions, AnalyticsReadAccess, AnalyticsViewAccess, AnalyticsViewOptions, AutoCaptureOptions, CaptureConsentOption, ConsentMode, ConsentResolver, PlatformReadAccess, ProvidersCollectionOptions, ProvidersOptions, ProvidersResolve, ScopeResolver, ScopesResolver, TimezoneResolver } from "./core/options.js";
|
|
11
|
+
import { AnalyticsFieldsOptions, AnalyticsMetricLabel, AnalyticsMetricLabels, AnalyticsStatOptions, AnalyticsStatRowOptions, AnalyticsTabOptions, analyticsFields, analyticsStat, analyticsStatRow, analyticsTab, analyticsTabsField } from "./fields/factories.js";
|
|
12
|
+
import { GoalFieldOptions, goalField, goalSlug } from "./goals/goalField.js";
|
|
13
|
+
import { GOAL_ACTION_TYPE, GoalActionDefinition, GoalActionRunArgs, TrackGoalActionOptions, trackGoalAction } from "./goals/trackGoalAction.js";
|
|
14
|
+
import { trackServerEvent } from "./native/ingest/serverTrack.js";
|
|
7
15
|
import { analyticsDefaultWidgets } from "./widgets/defaults.js";
|
|
8
16
|
|
|
9
17
|
//#region src/index.d.ts
|
|
@@ -14,5 +22,5 @@ declare module 'payload' {
|
|
|
14
22
|
}
|
|
15
23
|
declare const analytics: (options: AnalyticsPluginOptions) => import("payload").Plugin;
|
|
16
24
|
//#endregion
|
|
17
|
-
export { type AnalyticsAccessOptions, type AnalyticsBinding, type AnalyticsFieldsOptions, type AnalyticsMetricLabel, type AnalyticsMetricLabels, type AnalyticsPluginOptions, type AnalyticsStatOptions, type AnalyticsStatRowOptions, type AnalyticsTabOptions, type BindingContext, type CustomWidgetDef, type HostnameResolver, PLATFORM_SCOPE, type PathResolver, type PlatformReadAccess, type AnalyticsPluginOptions as PluginOptions, type ProvidersCollectionOptions, type ProvidersOptions, type ProvidersResolve, type ScopeResolver, type TimeframePreset, type TimezoneResolver, analytics, analyticsDefaultWidgets, analyticsFields, analyticsStat, analyticsStatRow, analyticsTab, analyticsTabsField };
|
|
25
|
+
export { type AnalyticsAccessOptions, type AnalyticsBinding, type AnalyticsCaptureOptions, type AnalyticsFieldsOptions, type AnalyticsGoalsCollectionOptions, type AnalyticsGoalsOptions, type AnalyticsMetricLabel, type AnalyticsMetricLabels, type AnalyticsPluginOptions, type AnalyticsReadAccess, type AnalyticsStatOptions, type AnalyticsStatRowOptions, type AnalyticsTabOptions, AnalyticsTrackError, type AnalyticsViewAccess, type AnalyticsViewOptions, type AutoCaptureOptions, type BindingContext, type CaptureConsentOption, type ConsentMode, type ConsentResolver, type CustomWidgetDef, GOAL_ACTION_TYPE, type Goal, type GoalActionDefinition, type GoalActionRunArgs, type GoalFieldOptions, type GoalMatch, type GoalsResponse, type HostnameResolver, PLATFORM_SCOPE, type PathResolver, type PlatformReadAccess, type AnalyticsPluginOptions as PluginOptions, type ProvidersCollectionOptions, type ProvidersOptions, type ProvidersResolve, type QueryError, type QueryErrorCode, type QueryErrorResponse, type QueryResponse, type QuerySourceRef, type ScopeResolver, type ScopesResolver, type SerializedAnalyticsQuery, type ServerEventInput, type ServerTrack, type ServerTrackOptions, type TimeframePreset, type TimezoneResolver, type TrackGoalActionOptions, type TrackerGoal, type WireGoal, analytics, analyticsDefaultWidgets, analyticsFields, analyticsStat, analyticsStatRow, analyticsTab, analyticsTabsField, goalField, goalSlug, trackGoalAction, trackServerEvent };
|
|
18
26
|
//# sourceMappingURL=index.d.ts.map
|
package/dist/index.js
CHANGED
|
@@ -1,23 +1,35 @@
|
|
|
1
|
+
import { DOCUMENT_PATH, GOALS_PATH, QUERY_PATH, REALTIME_PATH, SOURCES_PATH } from "./plugin/paths.js";
|
|
2
|
+
import { PLATFORM_SCOPE } from "./core/contract.js";
|
|
3
|
+
import { isValidTimeZone } from "./timeframe/tz.js";
|
|
4
|
+
import { setRuntime } from "./plugin/runtime.js";
|
|
5
|
+
import { proxyEndpoints } from "./capture/proxyEndpoint.js";
|
|
6
|
+
import { configGoalsResolver, createGoalsResolver } from "./goals/resolver.js";
|
|
7
|
+
import { buildGoalsCollection } from "./goals/collection.js";
|
|
1
8
|
import { buildProvidersCollection } from "./providers/collection.js";
|
|
2
9
|
import { resolveOptions } from "./core/options.js";
|
|
10
|
+
import { trackerEndpoint } from "./capture/trackerEndpoint.js";
|
|
3
11
|
import { createRegistry, staticRegistryResolver } from "./core/registry.js";
|
|
4
|
-
import {
|
|
5
|
-
import {
|
|
6
|
-
import {
|
|
7
|
-
import { DOCUMENT_PATH, REALTIME_PATH, SOURCES_PATH } from "./plugin/paths.js";
|
|
12
|
+
import { makeGoalsHandler } from "./goals/goalsEndpoint.js";
|
|
13
|
+
import { AnalyticsTrackError } from "./core/serverEvent.js";
|
|
14
|
+
import { trackServerEvent } from "./native/ingest/serverTrack.js";
|
|
8
15
|
import { makeDocumentHandler } from "./plugin/documentEndpoint.js";
|
|
9
16
|
import { isModuleNotFoundError } from "./plugin/peerImportError.js";
|
|
17
|
+
import { makeQueryHandler } from "./plugin/queryEndpoint.js";
|
|
10
18
|
import { kvCacheStore } from "./surfacing/cacheStore.js";
|
|
11
19
|
import { makeRealtimeHandler } from "./plugin/realtimeEndpoint.js";
|
|
12
20
|
import { registerTranslations } from "./plugin/registerTranslations.js";
|
|
21
|
+
import { validateScopeField } from "./plugin/scopeFieldBoot.js";
|
|
13
22
|
import { makeSourcesHandler } from "./plugin/sourcesEndpoint.js";
|
|
14
23
|
import { warmTask } from "./plugin/warmTask.js";
|
|
15
24
|
import { collectionProvidersSource, combineRegistries, createScopedRegistryResolver } from "./providers/resolver.js";
|
|
16
25
|
import { createEngine } from "./surfacing/engine.js";
|
|
17
26
|
import { syncCollection } from "./sync/collection.js";
|
|
18
27
|
import { syncTask } from "./sync/syncTask.js";
|
|
28
|
+
import { registerView } from "./view/registerView.js";
|
|
19
29
|
import { registerWidgets } from "./widgets/registerWidgets.js";
|
|
20
30
|
import { analyticsFields, analyticsStat, analyticsStatRow, analyticsTab, analyticsTabsField } from "./fields/factories.js";
|
|
31
|
+
import { goalField, goalSlug } from "./goals/goalField.js";
|
|
32
|
+
import { GOAL_ACTION_TYPE, trackGoalAction } from "./goals/trackGoalAction.js";
|
|
21
33
|
import { analyticsDefaultWidgets } from "./widgets/defaults.js";
|
|
22
34
|
import { definePlugin } from "payload";
|
|
23
35
|
//#region src/index.ts
|
|
@@ -26,6 +38,7 @@ const analytics = definePlugin({
|
|
|
26
38
|
plugin: async ({ config, plugins: _plugins, ...options }) => {
|
|
27
39
|
if (options.disabled === true) return config;
|
|
28
40
|
const resolved = resolveOptions(options);
|
|
41
|
+
const providersEnabled = resolved.providers.collection.enabled || Boolean(resolved.providers.resolve);
|
|
29
42
|
const defaultLayout = config.admin?.dashboard?.defaultLayout;
|
|
30
43
|
registerTranslations(config, options.translations);
|
|
31
44
|
const registry = createRegistry(resolved.adapters, resolved.defaultAdapter);
|
|
@@ -75,6 +88,22 @@ const analytics = definePlugin({
|
|
|
75
88
|
});
|
|
76
89
|
config.collections = [...config.collections ?? [], withEncryptedQueryRewrite(providersCollection)];
|
|
77
90
|
}
|
|
91
|
+
const goalsResolver = resolved.goalsCollection.enabled ? createGoalsResolver({
|
|
92
|
+
slug: resolved.goalsCollection.slug,
|
|
93
|
+
scopeField: resolved.goalsCollection.scopeField,
|
|
94
|
+
scoped: resolved.scoped,
|
|
95
|
+
config: resolved.goals
|
|
96
|
+
}) : configGoalsResolver(resolved.goals);
|
|
97
|
+
if (resolved.goalsCollection.enabled) config.collections = [...config.collections ?? [], buildGoalsCollection({
|
|
98
|
+
slug: resolved.goalsCollection.slug,
|
|
99
|
+
access: resolved.goalsCollection.access,
|
|
100
|
+
overrides: resolved.goalsCollection.overrides,
|
|
101
|
+
onChange: () => goalsResolver.invalidate(),
|
|
102
|
+
scoped: resolved.scoped,
|
|
103
|
+
scopeField: resolved.goalsCollection.scopeField,
|
|
104
|
+
resolveScope,
|
|
105
|
+
platformRead: resolved.access.platformRead
|
|
106
|
+
})];
|
|
78
107
|
const resolveTimezone = async (req, scope) => {
|
|
79
108
|
const opt = resolved.reportingTimezone;
|
|
80
109
|
if (opt === void 0) return "UTC";
|
|
@@ -92,9 +121,10 @@ const analytics = definePlugin({
|
|
|
92
121
|
for (const adapter of resolved.adapters) adapter.register?.(config, {
|
|
93
122
|
scoped: resolved.scoped,
|
|
94
123
|
resolveScope,
|
|
95
|
-
resolveTimezone
|
|
124
|
+
resolveTimezone,
|
|
125
|
+
resolveGoals: goalsResolver.resolve
|
|
96
126
|
});
|
|
97
|
-
if (resolved.adapters.some((a) => a.capabilities.realtime && typeof a.realtime === "function")) config.endpoints = [...config.endpoints ?? [], {
|
|
127
|
+
if (resolved.adapters.some((a) => a.capabilities.realtime && typeof a.realtime === "function") || providersEnabled) config.endpoints = [...config.endpoints ?? [], {
|
|
98
128
|
method: "get",
|
|
99
129
|
path: REALTIME_PATH,
|
|
100
130
|
handler: makeRealtimeHandler()
|
|
@@ -104,25 +134,54 @@ const analytics = definePlugin({
|
|
|
104
134
|
path: DOCUMENT_PATH,
|
|
105
135
|
handler: makeDocumentHandler()
|
|
106
136
|
}];
|
|
107
|
-
config.endpoints = [
|
|
108
|
-
|
|
109
|
-
|
|
110
|
-
|
|
111
|
-
|
|
137
|
+
config.endpoints = [
|
|
138
|
+
...config.endpoints ?? [],
|
|
139
|
+
{
|
|
140
|
+
method: "get",
|
|
141
|
+
path: SOURCES_PATH,
|
|
142
|
+
handler: makeSourcesHandler()
|
|
143
|
+
},
|
|
144
|
+
{
|
|
145
|
+
method: "get",
|
|
146
|
+
path: GOALS_PATH,
|
|
147
|
+
handler: makeGoalsHandler()
|
|
148
|
+
},
|
|
149
|
+
{
|
|
150
|
+
method: "get",
|
|
151
|
+
path: QUERY_PATH,
|
|
152
|
+
handler: makeQueryHandler()
|
|
153
|
+
}
|
|
154
|
+
];
|
|
155
|
+
if (resolved.adapters.some((a) => a.capture) || providersEnabled) config.endpoints = [
|
|
156
|
+
...config.endpoints,
|
|
157
|
+
...proxyEndpoints(),
|
|
158
|
+
trackerEndpoint()
|
|
159
|
+
];
|
|
112
160
|
if (resolved.widgets.enabled) {
|
|
113
|
-
const multiProvider = registry.isMultiProvider() ||
|
|
161
|
+
const multiProvider = registry.isMultiProvider() || providersEnabled;
|
|
114
162
|
registerWidgets(config, {
|
|
115
163
|
adapters: resolved.adapters,
|
|
116
164
|
multiProvider,
|
|
165
|
+
providersEnabled,
|
|
117
166
|
disabled: resolved.widgets.disabled,
|
|
118
167
|
register: resolved.widgets.register,
|
|
119
168
|
localizeText: resolved.widgets.localizeText,
|
|
120
|
-
defaultId: resolved.defaultAdapter
|
|
169
|
+
defaultId: resolved.defaultAdapter,
|
|
170
|
+
comparison: resolved.widgets.comparison,
|
|
171
|
+
view: resolved.view === false ? false : {
|
|
172
|
+
path: resolved.view.path,
|
|
173
|
+
defaultRange: resolved.view.defaultRange,
|
|
174
|
+
defaultMetric: resolved.view.defaultMetric
|
|
175
|
+
}
|
|
121
176
|
});
|
|
122
177
|
}
|
|
178
|
+
registerView(config, {
|
|
179
|
+
view: resolved.view,
|
|
180
|
+
pluginOptions: options
|
|
181
|
+
});
|
|
123
182
|
if (resolved.cache.warm.enabled) config.jobs = {
|
|
124
183
|
...config.jobs,
|
|
125
|
-
tasks: [...config.jobs?.tasks ?? [], warmTask(resolved.cache.warm.cron, defaultLayout)]
|
|
184
|
+
tasks: [...config.jobs?.tasks ?? [], warmTask(resolved.cache.warm.cron, defaultLayout, resolved.scopes)]
|
|
126
185
|
};
|
|
127
186
|
if (resolved.sync.enabled) {
|
|
128
187
|
config.collections = [...config.collections ?? [], syncCollection(resolved.sync.collectionSlug, resolved.sync.hidden, {
|
|
@@ -137,12 +196,23 @@ const analytics = definePlugin({
|
|
|
137
196
|
cron: resolved.sync.cron,
|
|
138
197
|
lookbackDays: resolved.sync.lookbackDays,
|
|
139
198
|
collectionSlug: resolved.sync.collectionSlug,
|
|
140
|
-
adapterIds: resolved.sync.adapters
|
|
199
|
+
adapterIds: resolved.sync.adapters,
|
|
200
|
+
scopes: resolved.scopes
|
|
141
201
|
})]
|
|
142
202
|
};
|
|
143
203
|
}
|
|
144
204
|
const prevOnInit = config.onInit;
|
|
145
205
|
config.onInit = async (payload) => {
|
|
206
|
+
if (resolved.scoped && resolved.goalsCollection.enabled) validateScopeField(payload, {
|
|
207
|
+
option: "goals.collection.scopeField",
|
|
208
|
+
slug: resolved.goalsCollection.slug,
|
|
209
|
+
scopeField: resolved.goalsCollection.scopeField
|
|
210
|
+
});
|
|
211
|
+
if (resolved.scoped && resolved.providers.collection.enabled) validateScopeField(payload, {
|
|
212
|
+
option: "providers.collection.scopeField",
|
|
213
|
+
slug: resolved.providers.collection.slug,
|
|
214
|
+
scopeField: resolved.providers.collection.scopeField
|
|
215
|
+
});
|
|
146
216
|
if (resolved.providers.collection.enabled) {
|
|
147
217
|
const { validateEncryptedBoot } = await import("@10x-media/fields/encrypted");
|
|
148
218
|
await validateEncryptedBoot(payload, resolved.providers.collection.encryption?.keys);
|
|
@@ -150,7 +220,11 @@ const analytics = definePlugin({
|
|
|
150
220
|
const engine = createEngine({
|
|
151
221
|
store: kvCacheStore(payload.kv),
|
|
152
222
|
queue: { concurrency: 4 },
|
|
153
|
-
ttl: resolved.cache.ttl
|
|
223
|
+
ttl: resolved.cache.ttl,
|
|
224
|
+
timeoutMs: resolved.cache.timeoutMs,
|
|
225
|
+
onError: (err, adapterId) => {
|
|
226
|
+
payload.logger?.warn(`analytics: read failed for adapter "${adapterId}": ${String(err)}`);
|
|
227
|
+
}
|
|
154
228
|
});
|
|
155
229
|
setRuntime(payload, {
|
|
156
230
|
registry,
|
|
@@ -158,8 +232,21 @@ const analytics = definePlugin({
|
|
|
158
232
|
resolveScope,
|
|
159
233
|
resolveTimezone,
|
|
160
234
|
platformAdapterId: resolved.platformAdapter,
|
|
235
|
+
captureSlots: resolved.capture.slots,
|
|
236
|
+
capturePaths: resolved.capture.paths,
|
|
237
|
+
captureProxy: resolved.capture.proxy,
|
|
238
|
+
consentFor: resolved.capture.consent,
|
|
239
|
+
autoCapture: resolved.capture.autoCapture,
|
|
240
|
+
goals: resolved.goals,
|
|
241
|
+
resolveGoals: goalsResolver.resolve,
|
|
242
|
+
resolveGoalsDetailed: goalsResolver.resolveDetailed,
|
|
243
|
+
...resolved.goalsCollection.enabled ? { goalsCollectionSlug: resolved.goalsCollection.slug } : {},
|
|
244
|
+
ingestPath: resolved.adapters.find((a) => a.ingest)?.ingest?.path,
|
|
245
|
+
track: (event, opts) => trackServerEvent(payload, event, opts),
|
|
246
|
+
scoped: resolved.scoped,
|
|
161
247
|
configAdapterIds: new Set(resolved.adapters.map((a) => a.id)),
|
|
162
248
|
platformRead: resolved.access.platformRead,
|
|
249
|
+
readAccess: resolved.access.read,
|
|
163
250
|
bindings: resolved.bindings,
|
|
164
251
|
engine,
|
|
165
252
|
ttl: resolved.cache.ttl,
|
|
@@ -171,6 +258,6 @@ const analytics = definePlugin({
|
|
|
171
258
|
}
|
|
172
259
|
});
|
|
173
260
|
//#endregion
|
|
174
|
-
export { PLATFORM_SCOPE, analytics, analyticsDefaultWidgets, analyticsFields, analyticsStat, analyticsStatRow, analyticsTab, analyticsTabsField };
|
|
261
|
+
export { AnalyticsTrackError, GOAL_ACTION_TYPE, PLATFORM_SCOPE, analytics, analyticsDefaultWidgets, analyticsFields, analyticsStat, analyticsStatRow, analyticsTab, analyticsTabsField, goalField, goalSlug, trackGoalAction, trackServerEvent };
|
|
175
262
|
|
|
176
263
|
//# sourceMappingURL=index.js.map
|
package/dist/index.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.js","names":[],"sources":["../src/index.ts"],"sourcesContent":["import { type Config, definePlugin, type PayloadRequest } from 'payload'\n\nimport { type AnalyticsPluginOptions, resolveOptions } from './core/options'\nimport { createRegistry, staticRegistryResolver } from './core/registry'\nimport { DOCUMENT_PATH, makeDocumentHandler } from './plugin/documentEndpoint'\nimport { isModuleNotFoundError } from './plugin/peerImportError'\nimport { makeRealtimeHandler, REALTIME_PATH } from './plugin/realtimeEndpoint'\nimport { registerTranslations } from './plugin/registerTranslations'\nimport { setRuntime } from './plugin/runtime'\nimport { makeSourcesHandler, SOURCES_PATH } from './plugin/sourcesEndpoint'\nimport { warmTask } from './plugin/warmTask'\nimport type { BuildSecretField } from './providers/collection'\nimport { buildProvidersCollection } from './providers/collection'\nimport {\n\tcollectionProvidersSource,\n\tcombineRegistries,\n\tcreateScopedRegistryResolver,\n} from './providers/resolver'\nimport { kvCacheStore } from './surfacing/cacheStore'\nimport { createEngine } from './surfacing/engine'\nimport { syncCollection } from './sync/collection'\nimport { syncTask } from './sync/syncTask'\nimport { DEFAULT_TIMEZONE, isValidTimeZone } from './timeframe/tz'\nimport { registerWidgets } from './widgets/registerWidgets'\n\ndeclare module 'payload' {\n\tinterface RegisteredPlugins {\n\t\t'@10x-media/analytics': AnalyticsPluginOptions\n\t}\n}\n\nexport const analytics = definePlugin<AnalyticsPluginOptions>({\n\tslug: '@10x-media/analytics',\n\tplugin: async ({ config, plugins: _plugins, ...options }): Promise<Config> => {\n\t\tif (options.disabled === true) {\n\t\t\treturn config\n\t\t}\n\t\tconst resolved = resolveOptions(options)\n\t\tconst defaultLayout = config.admin?.dashboard?.defaultLayout\n\t\tregisterTranslations(config, options.translations)\n\t\tconst registry = createRegistry(resolved.adapters, resolved.defaultAdapter)\n\t\tconst registryBase = { adapters: resolved.adapters, defaultId: resolved.defaultAdapter }\n\t\tlet resolveRegistry = staticRegistryResolver(registry)\n\t\tlet invalidateProviders = () => {}\n\t\tconst providersResolve = resolved.providers.resolve\n\t\tif (providersResolve) {\n\t\t\tresolveRegistry = async (args) =>\n\t\t\t\tcombineRegistries(\n\t\t\t\t\tregistryBase,\n\t\t\t\t\tawait providersResolve({ payload: args.payload, req: args.req, scope: args.scope })\n\t\t\t\t)\n\t\t} else if (resolved.providers.collection.enabled) {\n\t\t\tconst scoped = createScopedRegistryResolver({\n\t\t\t\tbase: registryBase,\n\t\t\t\tsource: collectionProvidersSource(\n\t\t\t\t\tresolved.providers.collection.slug,\n\t\t\t\t\tresolved.providers.collection.scopeField\n\t\t\t\t),\n\t\t\t})\n\t\t\tresolveRegistry = scoped.resolver\n\t\t\tinvalidateProviders = scoped.invalidate\n\t\t}\n\t\tconst resolveScope = async (req: PayloadRequest) => resolved.scopeResolver({ req })\n\t\tif (resolved.providers.collection.enabled) {\n\t\t\tconst { encryptedField, withEncryptedQueryRewrite } = await import(\n\t\t\t\t'@10x-media/fields/encrypted'\n\t\t\t).catch((err: unknown) => {\n\t\t\t\tif (isModuleNotFoundError(err)) {\n\t\t\t\t\tthrow new Error(\n\t\t\t\t\t\t'analytics: providers.collection requires @10x-media/fields (peer). Install it: pnpm add @10x-media/fields'\n\t\t\t\t\t)\n\t\t\t\t}\n\t\t\t\tthrow err\n\t\t\t})\n\t\t\tconst encryption = resolved.providers.collection.encryption\n\t\t\tconst buildSecret: BuildSecretField = (source) =>\n\t\t\t\tencryptedField(source, {\n\t\t\t\t\tprotection: 'writeOnly',\n\t\t\t\t\taadScope: '10x-analytics:providers',\n\t\t\t\t\t...(source.type === 'text' ? { hint: { suffix: 4 } } : {}),\n\t\t\t\t\t...(encryption?.keys ? { keys: encryption.keys } : {}),\n\t\t\t\t})\n\t\t\tconst providersCollection = buildProvidersCollection({\n\t\t\t\tslug: resolved.providers.collection.slug,\n\t\t\t\taccess: resolved.providers.collection.access,\n\t\t\t\toverrides: resolved.providers.collection.overrides,\n\t\t\t\tonChange: () => invalidateProviders(),\n\t\t\t\tscoped: resolved.scoped,\n\t\t\t\tscopeField: resolved.providers.collection.scopeField,\n\t\t\t\tresolveScope,\n\t\t\t\tplatformRead: resolved.access.platformRead,\n\t\t\t\tbuildSecret,\n\t\t\t})\n\t\t\t// Always wrap, even though a consumer's own @10x-media/fields plugin (if\n\t\t\t// registered) may wrap this collection again later: double application is\n\t\t\t// inert here (writeOnly forbids queryable, so there are no blind-index\n\t\t\t// markers to rewrite and the response strip is an idempotent delete),\n\t\t\t// while skipping would leak ciphertext whenever fields() runs before this\n\t\t\t// collection exists (e.g. an earlier plugin `order`).\n\t\t\tconfig.collections = [\n\t\t\t\t...(config.collections ?? []),\n\t\t\t\twithEncryptedQueryRewrite(providersCollection),\n\t\t\t]\n\t\t}\n\t\tconst resolveTimezone = async (req: PayloadRequest, scope?: string | null): Promise<string> => {\n\t\t\tconst opt = resolved.reportingTimezone\n\t\t\tif (opt === undefined) {\n\t\t\t\treturn DEFAULT_TIMEZONE\n\t\t\t}\n\t\t\ttry {\n\t\t\t\tconst tz =\n\t\t\t\t\ttypeof opt === 'string'\n\t\t\t\t\t\t? opt\n\t\t\t\t\t\t: await opt({ req, scope: scope !== undefined ? scope : await resolveScope(req) })\n\t\t\t\treturn tz && isValidTimeZone(tz) ? tz : DEFAULT_TIMEZONE\n\t\t\t} catch (err) {\n\t\t\t\treq.payload?.logger?.warn?.(\n\t\t\t\t\t`analytics: reportingTimezone resolution failed, falling back to UTC: ${String(err)}`\n\t\t\t\t)\n\t\t\t\treturn DEFAULT_TIMEZONE\n\t\t\t}\n\t\t}\n\t\tfor (const adapter of resolved.adapters) {\n\t\t\tadapter.register?.(config, { scoped: resolved.scoped, resolveScope, resolveTimezone })\n\t\t}\n\t\tif (\n\t\t\tresolved.adapters.some((a) => a.capabilities.realtime && typeof a.realtime === 'function')\n\t\t) {\n\t\t\tconfig.endpoints = [\n\t\t\t\t...(config.endpoints ?? []),\n\t\t\t\t{ method: 'get', path: REALTIME_PATH, handler: makeRealtimeHandler() },\n\t\t\t]\n\t\t}\n\t\tif (Object.keys(resolved.bindings).length > 0) {\n\t\t\tconfig.endpoints = [\n\t\t\t\t...(config.endpoints ?? []),\n\t\t\t\t{ method: 'get', path: DOCUMENT_PATH, handler: makeDocumentHandler() },\n\t\t\t]\n\t\t}\n\t\tconfig.endpoints = [\n\t\t\t...(config.endpoints ?? []),\n\t\t\t{ method: 'get', path: SOURCES_PATH, handler: makeSourcesHandler() },\n\t\t]\n\t\tif (resolved.widgets.enabled) {\n\t\t\tconst multiProvider =\n\t\t\t\tregistry.isMultiProvider() ||\n\t\t\t\tresolved.providers.collection.enabled ||\n\t\t\t\tBoolean(resolved.providers.resolve)\n\t\t\tregisterWidgets(config, {\n\t\t\t\tadapters: resolved.adapters,\n\t\t\t\tmultiProvider,\n\t\t\t\tdisabled: resolved.widgets.disabled,\n\t\t\t\tregister: resolved.widgets.register,\n\t\t\t\tlocalizeText: resolved.widgets.localizeText,\n\t\t\t\tdefaultId: resolved.defaultAdapter,\n\t\t\t})\n\t\t}\n\t\tif (resolved.cache.warm.enabled) {\n\t\t\tconfig.jobs = {\n\t\t\t\t...config.jobs,\n\t\t\t\ttasks: [...(config.jobs?.tasks ?? []), warmTask(resolved.cache.warm.cron, defaultLayout)],\n\t\t\t}\n\t\t}\n\t\tif (resolved.sync.enabled) {\n\t\t\tconfig.collections = [\n\t\t\t\t...(config.collections ?? []),\n\t\t\t\tsyncCollection(resolved.sync.collectionSlug, resolved.sync.hidden, {\n\t\t\t\t\tscoped: resolved.scoped,\n\t\t\t\t\tscopeField: 'scope',\n\t\t\t\t\tresolveScope,\n\t\t\t\t\tplatformRead: resolved.access.platformRead,\n\t\t\t\t}),\n\t\t\t]\n\t\t\tconfig.jobs = {\n\t\t\t\t...config.jobs,\n\t\t\t\ttasks: [\n\t\t\t\t\t...(config.jobs?.tasks ?? []),\n\t\t\t\t\tsyncTask({\n\t\t\t\t\t\tcron: resolved.sync.cron,\n\t\t\t\t\t\tlookbackDays: resolved.sync.lookbackDays,\n\t\t\t\t\t\tcollectionSlug: resolved.sync.collectionSlug,\n\t\t\t\t\t\tadapterIds: resolved.sync.adapters,\n\t\t\t\t\t}),\n\t\t\t\t],\n\t\t\t}\n\t\t}\n\t\tconst prevOnInit = config.onInit\n\t\t// The runtime is installed before the app's own onInit runs so consumer init code\n\t\t// (seeding, cache warming, sync passes) can already read through the plugin.\n\t\tconfig.onInit = async (payload) => {\n\t\t\tif (resolved.providers.collection.enabled) {\n\t\t\t\tconst { validateEncryptedBoot } = await import('@10x-media/fields/encrypted')\n\t\t\t\tawait validateEncryptedBoot(payload, resolved.providers.collection.encryption?.keys)\n\t\t\t}\n\t\t\tconst engine = createEngine({\n\t\t\t\tstore: kvCacheStore(payload.kv),\n\t\t\t\tqueue: { concurrency: 4 },\n\t\t\t\tttl: resolved.cache.ttl,\n\t\t\t})\n\t\t\tsetRuntime(payload, {\n\t\t\t\tregistry,\n\t\t\t\tresolveRegistry,\n\t\t\t\tresolveScope,\n\t\t\t\tresolveTimezone,\n\t\t\t\tplatformAdapterId: resolved.platformAdapter,\n\t\t\t\tconfigAdapterIds: new Set(resolved.adapters.map((a) => a.id)),\n\t\t\t\tplatformRead: resolved.access.platformRead,\n\t\t\t\tbindings: resolved.bindings,\n\t\t\t\tengine,\n\t\t\t\tttl: resolved.cache.ttl,\n\t\t\t\tcomparison: resolved.widgets.comparison,\n\t\t\t})\n\t\t\tawait prevOnInit?.(payload)\n\t\t}\n\t\treturn config\n\t},\n})\n\nexport type {\n\tAnalyticsBinding,\n\tBindingContext,\n\tHostnameResolver,\n\tPathResolver,\n} from './binding/types'\nexport { PLATFORM_SCOPE } from './core/contract'\nexport type {\n\tAnalyticsAccessOptions,\n\tAnalyticsPluginOptions,\n\tAnalyticsPluginOptions as PluginOptions,\n\tPlatformReadAccess,\n\tProvidersCollectionOptions,\n\tProvidersOptions,\n\tProvidersResolve,\n\tScopeResolver,\n\tTimezoneResolver,\n} from './core/options'\nexport type {\n\tAnalyticsFieldsOptions,\n\tAnalyticsMetricLabel,\n\tAnalyticsMetricLabels,\n\tAnalyticsStatOptions,\n\tAnalyticsStatRowOptions,\n\tAnalyticsTabOptions,\n} from './fields/factories'\nexport {\n\tanalyticsFields,\n\tanalyticsStat,\n\tanalyticsStatRow,\n\tanalyticsTab,\n\tanalyticsTabsField,\n} from './fields/factories'\nexport type { TimeframePreset } from './timeframe/presets'\nexport type { CustomWidgetDef } from './widgets/customWidget'\nexport { analyticsDefaultWidgets } from './widgets/defaults'\n"],"mappings":"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"}
|
|
1
|
+
{"version":3,"file":"index.js","names":[],"sources":["../src/index.ts"],"sourcesContent":["import { type Config, definePlugin, type PayloadRequest } from 'payload'\n\nimport { proxyEndpoints } from './capture/proxyEndpoint'\nimport { trackerEndpoint } from './capture/trackerEndpoint'\nimport { type AnalyticsPluginOptions, resolveOptions } from './core/options'\nimport { createRegistry, staticRegistryResolver } from './core/registry'\nimport { buildGoalsCollection } from './goals/collection'\nimport { GOALS_PATH, makeGoalsHandler } from './goals/goalsEndpoint'\nimport { configGoalsResolver, createGoalsResolver } from './goals/resolver'\nimport { trackServerEvent } from './native/ingest/serverTrack'\nimport { DOCUMENT_PATH, makeDocumentHandler } from './plugin/documentEndpoint'\nimport { isModuleNotFoundError } from './plugin/peerImportError'\nimport { makeQueryHandler, QUERY_PATH } from './plugin/queryEndpoint'\nimport { makeRealtimeHandler, REALTIME_PATH } from './plugin/realtimeEndpoint'\nimport { registerTranslations } from './plugin/registerTranslations'\nimport { setRuntime } from './plugin/runtime'\nimport { validateScopeField } from './plugin/scopeFieldBoot'\nimport { makeSourcesHandler, SOURCES_PATH } from './plugin/sourcesEndpoint'\nimport { warmTask } from './plugin/warmTask'\nimport type { BuildSecretField } from './providers/collection'\nimport { buildProvidersCollection } from './providers/collection'\nimport {\n\tcollectionProvidersSource,\n\tcombineRegistries,\n\tcreateScopedRegistryResolver,\n} from './providers/resolver'\nimport { kvCacheStore } from './surfacing/cacheStore'\nimport { createEngine } from './surfacing/engine'\nimport { syncCollection } from './sync/collection'\nimport { syncTask } from './sync/syncTask'\nimport { DEFAULT_TIMEZONE, isValidTimeZone } from './timeframe/tz'\nimport { registerView } from './view/registerView'\nimport { registerWidgets } from './widgets/registerWidgets'\n\ndeclare module 'payload' {\n\tinterface RegisteredPlugins {\n\t\t'@10x-media/analytics': AnalyticsPluginOptions\n\t}\n}\n\nexport const analytics = definePlugin<AnalyticsPluginOptions>({\n\tslug: '@10x-media/analytics',\n\tplugin: async ({ config, plugins: _plugins, ...options }): Promise<Config> => {\n\t\tif (options.disabled === true) {\n\t\t\treturn config\n\t\t}\n\t\tconst resolved = resolveOptions(options)\n\t\t// A tenant's own runtime adapter (providers.collection or providers.resolve) has\n\t\t// capabilities unknown at config time, so it opens the widget/endpoint gates that\n\t\t// otherwise key off the config-adapter capability union.\n\t\tconst providersEnabled =\n\t\t\tresolved.providers.collection.enabled || Boolean(resolved.providers.resolve)\n\t\tconst defaultLayout = config.admin?.dashboard?.defaultLayout\n\t\tregisterTranslations(config, options.translations)\n\t\tconst registry = createRegistry(resolved.adapters, resolved.defaultAdapter)\n\t\tconst registryBase = { adapters: resolved.adapters, defaultId: resolved.defaultAdapter }\n\t\tlet resolveRegistry = staticRegistryResolver(registry)\n\t\tlet invalidateProviders = () => {}\n\t\tconst providersResolve = resolved.providers.resolve\n\t\tif (providersResolve) {\n\t\t\tresolveRegistry = async (args) =>\n\t\t\t\tcombineRegistries(\n\t\t\t\t\tregistryBase,\n\t\t\t\t\tawait providersResolve({ payload: args.payload, req: args.req, scope: args.scope })\n\t\t\t\t)\n\t\t} else if (resolved.providers.collection.enabled) {\n\t\t\tconst scoped = createScopedRegistryResolver({\n\t\t\t\tbase: registryBase,\n\t\t\t\tsource: collectionProvidersSource(\n\t\t\t\t\tresolved.providers.collection.slug,\n\t\t\t\t\tresolved.providers.collection.scopeField\n\t\t\t\t),\n\t\t\t})\n\t\t\tresolveRegistry = scoped.resolver\n\t\t\tinvalidateProviders = scoped.invalidate\n\t\t}\n\t\tconst resolveScope = async (req: PayloadRequest) => resolved.scopeResolver({ req })\n\t\tif (resolved.providers.collection.enabled) {\n\t\t\tconst { encryptedField, withEncryptedQueryRewrite } = await import(\n\t\t\t\t'@10x-media/fields/encrypted'\n\t\t\t).catch((err: unknown) => {\n\t\t\t\tif (isModuleNotFoundError(err)) {\n\t\t\t\t\tthrow new Error(\n\t\t\t\t\t\t'analytics: providers.collection requires @10x-media/fields (peer). Install it: pnpm add @10x-media/fields'\n\t\t\t\t\t)\n\t\t\t\t}\n\t\t\t\tthrow err\n\t\t\t})\n\t\t\tconst encryption = resolved.providers.collection.encryption\n\t\t\tconst buildSecret: BuildSecretField = (source) =>\n\t\t\t\tencryptedField(source, {\n\t\t\t\t\tprotection: 'writeOnly',\n\t\t\t\t\taadScope: '10x-analytics:providers',\n\t\t\t\t\t...(source.type === 'text' ? { hint: { suffix: 4 } } : {}),\n\t\t\t\t\t...(encryption?.keys ? { keys: encryption.keys } : {}),\n\t\t\t\t})\n\t\t\tconst providersCollection = buildProvidersCollection({\n\t\t\t\tslug: resolved.providers.collection.slug,\n\t\t\t\taccess: resolved.providers.collection.access,\n\t\t\t\toverrides: resolved.providers.collection.overrides,\n\t\t\t\tonChange: () => invalidateProviders(),\n\t\t\t\tscoped: resolved.scoped,\n\t\t\t\tscopeField: resolved.providers.collection.scopeField,\n\t\t\t\tresolveScope,\n\t\t\t\tplatformRead: resolved.access.platformRead,\n\t\t\t\tbuildSecret,\n\t\t\t})\n\t\t\t// Always wrap, even though a consumer's own @10x-media/fields plugin (if\n\t\t\t// registered) may wrap this collection again later: double application is\n\t\t\t// inert here (writeOnly forbids queryable, so there are no blind-index\n\t\t\t// markers to rewrite and the response strip is an idempotent delete),\n\t\t\t// while skipping would leak ciphertext whenever fields() runs before this\n\t\t\t// collection exists (e.g. an earlier plugin `order`).\n\t\t\tconfig.collections = [\n\t\t\t\t...(config.collections ?? []),\n\t\t\t\twithEncryptedQueryRewrite(providersCollection),\n\t\t\t]\n\t\t}\n\t\t// Config goals are install-wide; the collection resolves per scope and merges over\n\t\t// them behind the same signature, so ingest and the tracker config read one source.\n\t\tconst goalsResolver = resolved.goalsCollection.enabled\n\t\t\t? createGoalsResolver({\n\t\t\t\t\tslug: resolved.goalsCollection.slug,\n\t\t\t\t\tscopeField: resolved.goalsCollection.scopeField,\n\t\t\t\t\tscoped: resolved.scoped,\n\t\t\t\t\tconfig: resolved.goals,\n\t\t\t\t})\n\t\t\t: configGoalsResolver(resolved.goals)\n\t\tif (resolved.goalsCollection.enabled) {\n\t\t\tconfig.collections = [\n\t\t\t\t...(config.collections ?? []),\n\t\t\t\tbuildGoalsCollection({\n\t\t\t\t\tslug: resolved.goalsCollection.slug,\n\t\t\t\t\taccess: resolved.goalsCollection.access,\n\t\t\t\t\toverrides: resolved.goalsCollection.overrides,\n\t\t\t\t\tonChange: () => goalsResolver.invalidate(),\n\t\t\t\t\tscoped: resolved.scoped,\n\t\t\t\t\tscopeField: resolved.goalsCollection.scopeField,\n\t\t\t\t\tresolveScope,\n\t\t\t\t\tplatformRead: resolved.access.platformRead,\n\t\t\t\t}),\n\t\t\t]\n\t\t}\n\t\tconst resolveTimezone = async (req: PayloadRequest, scope?: string | null): Promise<string> => {\n\t\t\tconst opt = resolved.reportingTimezone\n\t\t\tif (opt === undefined) {\n\t\t\t\treturn DEFAULT_TIMEZONE\n\t\t\t}\n\t\t\ttry {\n\t\t\t\tconst tz =\n\t\t\t\t\ttypeof opt === 'string'\n\t\t\t\t\t\t? opt\n\t\t\t\t\t\t: await opt({ req, scope: scope !== undefined ? scope : await resolveScope(req) })\n\t\t\t\treturn tz && isValidTimeZone(tz) ? tz : DEFAULT_TIMEZONE\n\t\t\t} catch (err) {\n\t\t\t\treq.payload?.logger?.warn?.(\n\t\t\t\t\t`analytics: reportingTimezone resolution failed, falling back to UTC: ${String(err)}`\n\t\t\t\t)\n\t\t\t\treturn DEFAULT_TIMEZONE\n\t\t\t}\n\t\t}\n\t\tfor (const adapter of resolved.adapters) {\n\t\t\tadapter.register?.(config, {\n\t\t\t\tscoped: resolved.scoped,\n\t\t\t\tresolveScope,\n\t\t\t\tresolveTimezone,\n\t\t\t\tresolveGoals: goalsResolver.resolve,\n\t\t\t})\n\t\t}\n\t\tif (\n\t\t\tresolved.adapters.some((a) => a.capabilities.realtime && typeof a.realtime === 'function') ||\n\t\t\tprovidersEnabled\n\t\t) {\n\t\t\tconfig.endpoints = [\n\t\t\t\t...(config.endpoints ?? []),\n\t\t\t\t{ method: 'get', path: REALTIME_PATH, handler: makeRealtimeHandler() },\n\t\t\t]\n\t\t}\n\t\tif (Object.keys(resolved.bindings).length > 0) {\n\t\t\tconfig.endpoints = [\n\t\t\t\t...(config.endpoints ?? []),\n\t\t\t\t{ method: 'get', path: DOCUMENT_PATH, handler: makeDocumentHandler() },\n\t\t\t]\n\t\t}\n\t\tconfig.endpoints = [\n\t\t\t...(config.endpoints ?? []),\n\t\t\t{ method: 'get', path: SOURCES_PATH, handler: makeSourcesHandler() },\n\t\t\t{ method: 'get', path: GOALS_PATH, handler: makeGoalsHandler() },\n\t\t\t{ method: 'get', path: QUERY_PATH, handler: makeQueryHandler() },\n\t\t]\n\t\t// A runtime provider's capture support is unknown at config time, so providers\n\t\t// alone are enough to mount the proxy; every slot is still resolved per request.\n\t\tif (resolved.adapters.some((a) => a.capture) || providersEnabled) {\n\t\t\tconfig.endpoints = [...config.endpoints, ...proxyEndpoints(), trackerEndpoint()]\n\t\t}\n\t\tif (resolved.widgets.enabled) {\n\t\t\tconst multiProvider = registry.isMultiProvider() || providersEnabled\n\t\t\tregisterWidgets(config, {\n\t\t\t\tadapters: resolved.adapters,\n\t\t\t\tmultiProvider,\n\t\t\t\tprovidersEnabled,\n\t\t\t\tdisabled: resolved.widgets.disabled,\n\t\t\t\tregister: resolved.widgets.register,\n\t\t\t\tlocalizeText: resolved.widgets.localizeText,\n\t\t\t\tdefaultId: resolved.defaultAdapter,\n\t\t\t\tcomparison: resolved.widgets.comparison,\n\t\t\t\tview:\n\t\t\t\t\tresolved.view === false\n\t\t\t\t\t\t? false\n\t\t\t\t\t\t: {\n\t\t\t\t\t\t\t\tpath: resolved.view.path,\n\t\t\t\t\t\t\t\tdefaultRange: resolved.view.defaultRange,\n\t\t\t\t\t\t\t\tdefaultMetric: resolved.view.defaultMetric,\n\t\t\t\t\t\t\t},\n\t\t\t})\n\t\t}\n\t\tregisterView(config, { view: resolved.view, pluginOptions: options })\n\t\tif (resolved.cache.warm.enabled) {\n\t\t\tconfig.jobs = {\n\t\t\t\t...config.jobs,\n\t\t\t\ttasks: [\n\t\t\t\t\t...(config.jobs?.tasks ?? []),\n\t\t\t\t\twarmTask(resolved.cache.warm.cron, defaultLayout, resolved.scopes),\n\t\t\t\t],\n\t\t\t}\n\t\t}\n\t\tif (resolved.sync.enabled) {\n\t\t\tconfig.collections = [\n\t\t\t\t...(config.collections ?? []),\n\t\t\t\tsyncCollection(resolved.sync.collectionSlug, resolved.sync.hidden, {\n\t\t\t\t\tscoped: resolved.scoped,\n\t\t\t\t\tscopeField: 'scope',\n\t\t\t\t\tresolveScope,\n\t\t\t\t\tplatformRead: resolved.access.platformRead,\n\t\t\t\t}),\n\t\t\t]\n\t\t\tconfig.jobs = {\n\t\t\t\t...config.jobs,\n\t\t\t\ttasks: [\n\t\t\t\t\t...(config.jobs?.tasks ?? []),\n\t\t\t\t\tsyncTask({\n\t\t\t\t\t\tcron: resolved.sync.cron,\n\t\t\t\t\t\tlookbackDays: resolved.sync.lookbackDays,\n\t\t\t\t\t\tcollectionSlug: resolved.sync.collectionSlug,\n\t\t\t\t\t\tadapterIds: resolved.sync.adapters,\n\t\t\t\t\t\tscopes: resolved.scopes,\n\t\t\t\t\t}),\n\t\t\t\t],\n\t\t\t}\n\t\t}\n\t\tconst prevOnInit = config.onInit\n\t\t// The runtime is installed before the app's own onInit runs so consumer init code\n\t\t// (seeding, cache warming, sync passes) can already read through the plugin.\n\t\tconfig.onInit = async (payload) => {\n\t\t\t// Host-owned scope fields only exist once every plugin has run, so the collections\n\t\t\t// are checked against the assembled config rather than at config time.\n\t\t\tif (resolved.scoped && resolved.goalsCollection.enabled) {\n\t\t\t\tvalidateScopeField(payload, {\n\t\t\t\t\toption: 'goals.collection.scopeField',\n\t\t\t\t\tslug: resolved.goalsCollection.slug,\n\t\t\t\t\tscopeField: resolved.goalsCollection.scopeField,\n\t\t\t\t})\n\t\t\t}\n\t\t\tif (resolved.scoped && resolved.providers.collection.enabled) {\n\t\t\t\tvalidateScopeField(payload, {\n\t\t\t\t\toption: 'providers.collection.scopeField',\n\t\t\t\t\tslug: resolved.providers.collection.slug,\n\t\t\t\t\tscopeField: resolved.providers.collection.scopeField,\n\t\t\t\t})\n\t\t\t}\n\t\t\tif (resolved.providers.collection.enabled) {\n\t\t\t\tconst { validateEncryptedBoot } = await import('@10x-media/fields/encrypted')\n\t\t\t\tawait validateEncryptedBoot(payload, resolved.providers.collection.encryption?.keys)\n\t\t\t}\n\t\t\tconst engine = createEngine({\n\t\t\t\tstore: kvCacheStore(payload.kv),\n\t\t\t\tqueue: { concurrency: 4 },\n\t\t\t\tttl: resolved.cache.ttl,\n\t\t\t\ttimeoutMs: resolved.cache.timeoutMs,\n\t\t\t\tonError: (err, adapterId) => {\n\t\t\t\t\tpayload.logger?.warn(`analytics: read failed for adapter \"${adapterId}\": ${String(err)}`)\n\t\t\t\t},\n\t\t\t})\n\t\t\tsetRuntime(payload, {\n\t\t\t\tregistry,\n\t\t\t\tresolveRegistry,\n\t\t\t\tresolveScope,\n\t\t\t\tresolveTimezone,\n\t\t\t\tplatformAdapterId: resolved.platformAdapter,\n\t\t\t\tcaptureSlots: resolved.capture.slots,\n\t\t\t\tcapturePaths: resolved.capture.paths,\n\t\t\t\tcaptureProxy: resolved.capture.proxy,\n\t\t\t\tconsentFor: resolved.capture.consent,\n\t\t\t\tautoCapture: resolved.capture.autoCapture,\n\t\t\t\tgoals: resolved.goals,\n\t\t\t\tresolveGoals: goalsResolver.resolve,\n\t\t\t\tresolveGoalsDetailed: goalsResolver.resolveDetailed,\n\t\t\t\t...(resolved.goalsCollection.enabled\n\t\t\t\t\t? { goalsCollectionSlug: resolved.goalsCollection.slug }\n\t\t\t\t\t: {}),\n\t\t\t\tingestPath: resolved.adapters.find((a) => a.ingest)?.ingest?.path,\n\t\t\t\ttrack: (event, opts) => trackServerEvent(payload, event, opts),\n\t\t\t\tscoped: resolved.scoped,\n\t\t\t\tconfigAdapterIds: new Set(resolved.adapters.map((a) => a.id)),\n\t\t\t\tplatformRead: resolved.access.platformRead,\n\t\t\t\treadAccess: resolved.access.read,\n\t\t\t\tbindings: resolved.bindings,\n\t\t\t\tengine,\n\t\t\t\tttl: resolved.cache.ttl,\n\t\t\t\tcomparison: resolved.widgets.comparison,\n\t\t\t})\n\t\t\tawait prevOnInit?.(payload)\n\t\t}\n\t\treturn config\n\t},\n})\n\nexport type {\n\tAnalyticsBinding,\n\tBindingContext,\n\tHostnameResolver,\n\tPathResolver,\n} from './binding/types'\nexport { PLATFORM_SCOPE } from './core/contract'\nexport type {\n\tAnalyticsAccessOptions,\n\tAnalyticsCaptureOptions,\n\tAnalyticsGoalsCollectionOptions,\n\tAnalyticsGoalsOptions,\n\tAnalyticsPluginOptions,\n\tAnalyticsPluginOptions as PluginOptions,\n\tAnalyticsReadAccess,\n\tAnalyticsViewAccess,\n\tAnalyticsViewOptions,\n\tAutoCaptureOptions,\n\tCaptureConsentOption,\n\tConsentMode,\n\tConsentResolver,\n\tPlatformReadAccess,\n\tProvidersCollectionOptions,\n\tProvidersOptions,\n\tProvidersResolve,\n\tScopeResolver,\n\tScopesResolver,\n\tTimezoneResolver,\n} from './core/options'\nexport type { ServerEventInput, ServerTrack, ServerTrackOptions } from './core/serverEvent'\nexport { AnalyticsTrackError } from './core/serverEvent'\nexport type {\n\tAnalyticsFieldsOptions,\n\tAnalyticsMetricLabel,\n\tAnalyticsMetricLabels,\n\tAnalyticsStatOptions,\n\tAnalyticsStatRowOptions,\n\tAnalyticsTabOptions,\n} from './fields/factories'\nexport {\n\tanalyticsFields,\n\tanalyticsStat,\n\tanalyticsStatRow,\n\tanalyticsTab,\n\tanalyticsTabsField,\n} from './fields/factories'\nexport type { GoalFieldOptions } from './goals/goalField'\nexport { goalField, goalSlug } from './goals/goalField'\nexport type { GoalsResponse, WireGoal } from './goals/goalsEndpoint'\nexport type {\n\tGoalActionDefinition,\n\tGoalActionRunArgs,\n\tTrackGoalActionOptions,\n} from './goals/trackGoalAction'\nexport { GOAL_ACTION_TYPE, trackGoalAction } from './goals/trackGoalAction'\nexport type { Goal, GoalMatch, TrackerGoal } from './goals/types'\nexport { trackServerEvent } from './native/ingest/serverTrack'\nexport type { QueryError, QueryErrorCode } from './query/errors'\nexport type {\n\tQueryErrorResponse,\n\tQueryResponse,\n\tQuerySourceRef,\n\tSerializedAnalyticsQuery,\n} from './query/response'\nexport type { TimeframePreset } from './timeframe/presets'\nexport type { CustomWidgetDef } from './widgets/customWidget'\nexport { analyticsDefaultWidgets } from './widgets/defaults'\n"],"mappings":"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"}
|
|
@@ -25,7 +25,11 @@ const eventsCollection = (scoped = false) => ({
|
|
|
25
25
|
name: "type",
|
|
26
26
|
type: "select",
|
|
27
27
|
required: true,
|
|
28
|
-
options: [
|
|
28
|
+
options: [
|
|
29
|
+
"pageview",
|
|
30
|
+
"event",
|
|
31
|
+
"goal"
|
|
32
|
+
],
|
|
29
33
|
index: true
|
|
30
34
|
},
|
|
31
35
|
{
|
|
@@ -87,6 +91,22 @@ const eventsCollection = (scoped = false) => ({
|
|
|
87
91
|
name: "props",
|
|
88
92
|
type: "json"
|
|
89
93
|
},
|
|
94
|
+
{
|
|
95
|
+
name: "value",
|
|
96
|
+
type: "number"
|
|
97
|
+
},
|
|
98
|
+
{
|
|
99
|
+
name: "currency",
|
|
100
|
+
type: "text"
|
|
101
|
+
},
|
|
102
|
+
{
|
|
103
|
+
name: "scrollDepth",
|
|
104
|
+
type: "number"
|
|
105
|
+
},
|
|
106
|
+
{
|
|
107
|
+
name: "goals",
|
|
108
|
+
type: "json"
|
|
109
|
+
},
|
|
90
110
|
...scoped ? [{
|
|
91
111
|
name: "scope",
|
|
92
112
|
type: "text",
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"events.js","names":[],"sources":["../../../src/native/collections/events.ts"],"sourcesContent":["import type { CollectionConfig, Field } from 'payload'\n\nexport const EVENTS_SLUG = 'analytics-events'\n\n/**\n * The scope column exists only for scoped installs (a configured scopeResolver);\n * enabling scope on an existing native install therefore needs a migration adding\n * the column to events and rollups.\n */\nexport const eventsCollection = (scoped = false): CollectionConfig => ({\n\tslug: EVENTS_SLUG,\n\tadmin: { hidden: true },\n\taccess: { read: () => false, create: () => true, update: () => false, delete: () => false },\n\tfields: [\n\t\t{ name: 'timestamp', type: 'date', required: true, index: true },\n\t\t{
|
|
1
|
+
{"version":3,"file":"events.js","names":[],"sources":["../../../src/native/collections/events.ts"],"sourcesContent":["import type { CollectionConfig, Field } from 'payload'\n\nexport const EVENTS_SLUG = 'analytics-events'\n\n/**\n * The scope column exists only for scoped installs (a configured scopeResolver);\n * enabling scope on an existing native install therefore needs a migration adding\n * the column to events and rollups.\n */\nexport const eventsCollection = (scoped = false): CollectionConfig => ({\n\tslug: EVENTS_SLUG,\n\tadmin: { hidden: true },\n\taccess: { read: () => false, create: () => true, update: () => false, delete: () => false },\n\tfields: [\n\t\t{ name: 'timestamp', type: 'date', required: true, index: true },\n\t\t{\n\t\t\tname: 'type',\n\t\t\ttype: 'select',\n\t\t\trequired: true,\n\t\t\toptions: ['pageview', 'event', 'goal'],\n\t\t\tindex: true,\n\t\t},\n\t\t{ name: 'name', type: 'text' },\n\t\t{ name: 'path', type: 'text', required: true, index: true },\n\t\t{ name: 'hostname', type: 'text', required: true },\n\t\t{ name: 'referrer', type: 'text' },\n\t\t{ name: 'device', type: 'text' },\n\t\t{ name: 'source', type: 'text' },\n\t\t{ name: 'country', type: 'text' },\n\t\t{ name: 'region', type: 'text' },\n\t\t{ name: 'city', type: 'text' },\n\t\t{ name: 'visitorHash', type: 'text', required: true, index: true },\n\t\t{ name: 'sessionId', type: 'text', required: true, index: true },\n\t\t{ name: 'durationMs', type: 'number' },\n\t\t{ name: 'props', type: 'json' },\n\t\t{ name: 'value', type: 'number' },\n\t\t{ name: 'currency', type: 'text' },\n\t\t{ name: 'scrollDepth', type: 'number' },\n\t\t// The completions matched at ingest, so a raw-event read (filtered or hourly) reports\n\t\t// the same conversions the rollups hold instead of re-matching against goals that may\n\t\t// since have changed.\n\t\t{ name: 'goals', type: 'json' },\n\t\t...(scoped ? [{ name: 'scope', type: 'text', index: true } satisfies Field] : []),\n\t],\n\tindexes: [{ fields: ['path', 'timestamp'] }, { fields: ['type', 'timestamp'] }],\n})\n"],"mappings":";AAEA,MAAa,cAAc;;;;;;AAO3B,MAAa,oBAAoB,SAAS,WAA6B;CACtE,MAAM;CACN,OAAO,EAAE,QAAQ,KAAK;CACtB,QAAQ;EAAE,YAAY;EAAO,cAAc;EAAM,cAAc;EAAO,cAAc;CAAM;CAC1F,QAAQ;EACP;GAAE,MAAM;GAAa,MAAM;GAAQ,UAAU;GAAM,OAAO;EAAK;EAC/D;GACC,MAAM;GACN,MAAM;GACN,UAAU;GACV,SAAS;IAAC;IAAY;IAAS;GAAM;GACrC,OAAO;EACR;EACA;GAAE,MAAM;GAAQ,MAAM;EAAO;EAC7B;GAAE,MAAM;GAAQ,MAAM;GAAQ,UAAU;GAAM,OAAO;EAAK;EAC1D;GAAE,MAAM;GAAY,MAAM;GAAQ,UAAU;EAAK;EACjD;GAAE,MAAM;GAAY,MAAM;EAAO;EACjC;GAAE,MAAM;GAAU,MAAM;EAAO;EAC/B;GAAE,MAAM;GAAU,MAAM;EAAO;EAC/B;GAAE,MAAM;GAAW,MAAM;EAAO;EAChC;GAAE,MAAM;GAAU,MAAM;EAAO;EAC/B;GAAE,MAAM;GAAQ,MAAM;EAAO;EAC7B;GAAE,MAAM;GAAe,MAAM;GAAQ,UAAU;GAAM,OAAO;EAAK;EACjE;GAAE,MAAM;GAAa,MAAM;GAAQ,UAAU;GAAM,OAAO;EAAK;EAC/D;GAAE,MAAM;GAAc,MAAM;EAAS;EACrC;GAAE,MAAM;GAAS,MAAM;EAAO;EAC9B;GAAE,MAAM;GAAS,MAAM;EAAS;EAChC;GAAE,MAAM;GAAY,MAAM;EAAO;EACjC;GAAE,MAAM;GAAe,MAAM;EAAS;EAItC;GAAE,MAAM;GAAS,MAAM;EAAO;EAC9B,GAAI,SAAS,CAAC;GAAE,MAAM;GAAS,MAAM;GAAQ,OAAO;EAAK,CAAiB,IAAI,CAAC;CAChF;CACA,SAAS,CAAC,EAAE,QAAQ,CAAC,QAAQ,WAAW,EAAE,GAAG,EAAE,QAAQ,CAAC,QAAQ,WAAW,EAAE,CAAC;AAC/E"}
|
|
@@ -96,6 +96,30 @@ const rollupsCollection = (scoped = false) => ({
|
|
|
96
96
|
type: "number",
|
|
97
97
|
required: true,
|
|
98
98
|
defaultValue: 0
|
|
99
|
+
},
|
|
100
|
+
{
|
|
101
|
+
name: "conversions",
|
|
102
|
+
type: "number",
|
|
103
|
+
required: true,
|
|
104
|
+
defaultValue: 0
|
|
105
|
+
},
|
|
106
|
+
{
|
|
107
|
+
name: "revenue",
|
|
108
|
+
type: "number",
|
|
109
|
+
required: true,
|
|
110
|
+
defaultValue: 0
|
|
111
|
+
},
|
|
112
|
+
{
|
|
113
|
+
name: "scrollDepthSum",
|
|
114
|
+
type: "number",
|
|
115
|
+
required: true,
|
|
116
|
+
defaultValue: 0
|
|
117
|
+
},
|
|
118
|
+
{
|
|
119
|
+
name: "scrollSamples",
|
|
120
|
+
type: "number",
|
|
121
|
+
required: true,
|
|
122
|
+
defaultValue: 0
|
|
99
123
|
}
|
|
100
124
|
],
|
|
101
125
|
indexes: [scoped ? {
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"rollups.js","names":[],"sources":["../../../src/native/collections/rollups.ts"],"sourcesContent":["import type { CollectionConfig, Field } from 'payload'\n\nexport const ROLLUPS_SLUG = 'analytics-rollups'\n\n/**\n * `hostname` ('' = the hostname-less family) is part of the unique bucket on every\n * native install: unfiltered reads hit the '' family and hostname-scoped reads hit the\n * exact-hostname family, both kept per-bucket exact by dual emission in computeRollupDeltas.\n * Scoped installs add a further required scope key ('' = the null scope) to every rollup\n * row and to the unique bucket index, so each scope accumulates its own buckets.\n * Existing native installs need a migration for the new hostname column (and, if\n * enabling scope, the scope column too).\n */\nexport const rollupsCollection = (scoped = false): CollectionConfig => ({\n\tslug: ROLLUPS_SLUG,\n\tadmin: { hidden: true },\n\taccess: { read: () => false, create: () => true, update: () => true, delete: () => true },\n\tfields: [\n\t\t{ name: 'granularity', type: 'text', required: true },\n\t\t{ name: 'period', type: 'date', required: true, index: true },\n\t\t{ name: 'path', type: 'text', required: true, index: true },\n\t\t{ name: 'dimension', type: 'text', required: true, defaultValue: '' },\n\t\t{ name: 'dimvalue', type: 'text', required: true, defaultValue: '' },\n\t\t{ name: 'hostname', type: 'text', required: true, defaultValue: '' },\n\t\t...(scoped\n\t\t\t? [\n\t\t\t\t\t{\n\t\t\t\t\t\tname: 'scope',\n\t\t\t\t\t\ttype: 'text',\n\t\t\t\t\t\trequired: true,\n\t\t\t\t\t\tdefaultValue: '',\n\t\t\t\t\t\tindex: true,\n\t\t\t\t\t} satisfies Field,\n\t\t\t\t]\n\t\t\t: []),\n\t\t{ name: 'pageviews', type: 'number', required: true, defaultValue: 0 },\n\t\t{ name: 'events', type: 'number', required: true, defaultValue: 0 },\n\t\t{ name: 'durationMs', type: 'number', required: true, defaultValue: 0 },\n\t\t{ name: 'visitors', type: 'number', required: true, defaultValue: 0 },\n\t\t{ name: 'sessions', type: 'number', required: true, defaultValue: 0 },\n\t\t{ name: 'samples', type: 'number', required: true, defaultValue: 0 },\n\t],\n\tindexes: [\n\t\tscoped\n\t\t\t? {\n\t\t\t\t\tfields: ['granularity', 'period', 'path', 'dimension', 'dimvalue', 'hostname', 'scope'],\n\t\t\t\t\tunique: true,\n\t\t\t\t}\n\t\t\t: {\n\t\t\t\t\tfields: ['granularity', 'period', 'path', 'dimension', 'dimvalue', 'hostname'],\n\t\t\t\t\tunique: true,\n\t\t\t\t},\n\t],\n})\n"],"mappings":";AAEA,MAAa,eAAe;;;;;;;;;;AAW5B,MAAa,qBAAqB,SAAS,WAA6B;CACvE,MAAM;CACN,OAAO,EAAE,QAAQ,KAAK;CACtB,QAAQ;EAAE,YAAY;EAAO,cAAc;EAAM,cAAc;EAAM,cAAc;CAAK;CACxF,QAAQ;EACP;GAAE,MAAM;GAAe,MAAM;GAAQ,UAAU;EAAK;EACpD;GAAE,MAAM;GAAU,MAAM;GAAQ,UAAU;GAAM,OAAO;EAAK;EAC5D;GAAE,MAAM;GAAQ,MAAM;GAAQ,UAAU;GAAM,OAAO;EAAK;EAC1D;GAAE,MAAM;GAAa,MAAM;GAAQ,UAAU;GAAM,cAAc;EAAG;EACpE;GAAE,MAAM;GAAY,MAAM;GAAQ,UAAU;GAAM,cAAc;EAAG;EACnE;GAAE,MAAM;GAAY,MAAM;GAAQ,UAAU;GAAM,cAAc;EAAG;EACnE,GAAI,SACD,CACA;GACC,MAAM;GACN,MAAM;GACN,UAAU;GACV,cAAc;GACd,OAAO;EACR,CACD,IACC,CAAC;EACJ;GAAE,MAAM;GAAa,MAAM;GAAU,UAAU;GAAM,cAAc;EAAE;EACrE;GAAE,MAAM;GAAU,MAAM;GAAU,UAAU;GAAM,cAAc;EAAE;EAClE;GAAE,MAAM;GAAc,MAAM;GAAU,UAAU;GAAM,cAAc;EAAE;EACtE;GAAE,MAAM;GAAY,MAAM;GAAU,UAAU;GAAM,cAAc;EAAE;EACpE;GAAE,MAAM;GAAY,MAAM;GAAU,UAAU;GAAM,cAAc;EAAE;EACpE;GAAE,MAAM;GAAW,MAAM;GAAU,UAAU;GAAM,cAAc;EAAE;
|
|
1
|
+
{"version":3,"file":"rollups.js","names":[],"sources":["../../../src/native/collections/rollups.ts"],"sourcesContent":["import type { CollectionConfig, Field } from 'payload'\n\nexport const ROLLUPS_SLUG = 'analytics-rollups'\n\n/**\n * `hostname` ('' = the hostname-less family) is part of the unique bucket on every\n * native install: unfiltered reads hit the '' family and hostname-scoped reads hit the\n * exact-hostname family, both kept per-bucket exact by dual emission in computeRollupDeltas.\n * Scoped installs add a further required scope key ('' = the null scope) to every rollup\n * row and to the unique bucket index, so each scope accumulates its own buckets.\n * Existing native installs need a migration for the new hostname column (and, if\n * enabling scope, the scope column too).\n */\nexport const rollupsCollection = (scoped = false): CollectionConfig => ({\n\tslug: ROLLUPS_SLUG,\n\tadmin: { hidden: true },\n\taccess: { read: () => false, create: () => true, update: () => true, delete: () => true },\n\tfields: [\n\t\t{ name: 'granularity', type: 'text', required: true },\n\t\t{ name: 'period', type: 'date', required: true, index: true },\n\t\t{ name: 'path', type: 'text', required: true, index: true },\n\t\t{ name: 'dimension', type: 'text', required: true, defaultValue: '' },\n\t\t{ name: 'dimvalue', type: 'text', required: true, defaultValue: '' },\n\t\t{ name: 'hostname', type: 'text', required: true, defaultValue: '' },\n\t\t...(scoped\n\t\t\t? [\n\t\t\t\t\t{\n\t\t\t\t\t\tname: 'scope',\n\t\t\t\t\t\ttype: 'text',\n\t\t\t\t\t\trequired: true,\n\t\t\t\t\t\tdefaultValue: '',\n\t\t\t\t\t\tindex: true,\n\t\t\t\t\t} satisfies Field,\n\t\t\t\t]\n\t\t\t: []),\n\t\t{ name: 'pageviews', type: 'number', required: true, defaultValue: 0 },\n\t\t{ name: 'events', type: 'number', required: true, defaultValue: 0 },\n\t\t{ name: 'durationMs', type: 'number', required: true, defaultValue: 0 },\n\t\t{ name: 'visitors', type: 'number', required: true, defaultValue: 0 },\n\t\t{ name: 'sessions', type: 'number', required: true, defaultValue: 0 },\n\t\t{ name: 'samples', type: 'number', required: true, defaultValue: 0 },\n\t\t{ name: 'conversions', type: 'number', required: true, defaultValue: 0 },\n\t\t// Revenue is stored in the event's own currency and never converted, so a bucket\n\t\t// spanning several currencies sums figures that are not comparable.\n\t\t{ name: 'revenue', type: 'number', required: true, defaultValue: 0 },\n\t\t{ name: 'scrollDepthSum', type: 'number', required: true, defaultValue: 0 },\n\t\t{ name: 'scrollSamples', type: 'number', required: true, defaultValue: 0 },\n\t],\n\tindexes: [\n\t\tscoped\n\t\t\t? {\n\t\t\t\t\tfields: ['granularity', 'period', 'path', 'dimension', 'dimvalue', 'hostname', 'scope'],\n\t\t\t\t\tunique: true,\n\t\t\t\t}\n\t\t\t: {\n\t\t\t\t\tfields: ['granularity', 'period', 'path', 'dimension', 'dimvalue', 'hostname'],\n\t\t\t\t\tunique: true,\n\t\t\t\t},\n\t],\n})\n"],"mappings":";AAEA,MAAa,eAAe;;;;;;;;;;AAW5B,MAAa,qBAAqB,SAAS,WAA6B;CACvE,MAAM;CACN,OAAO,EAAE,QAAQ,KAAK;CACtB,QAAQ;EAAE,YAAY;EAAO,cAAc;EAAM,cAAc;EAAM,cAAc;CAAK;CACxF,QAAQ;EACP;GAAE,MAAM;GAAe,MAAM;GAAQ,UAAU;EAAK;EACpD;GAAE,MAAM;GAAU,MAAM;GAAQ,UAAU;GAAM,OAAO;EAAK;EAC5D;GAAE,MAAM;GAAQ,MAAM;GAAQ,UAAU;GAAM,OAAO;EAAK;EAC1D;GAAE,MAAM;GAAa,MAAM;GAAQ,UAAU;GAAM,cAAc;EAAG;EACpE;GAAE,MAAM;GAAY,MAAM;GAAQ,UAAU;GAAM,cAAc;EAAG;EACnE;GAAE,MAAM;GAAY,MAAM;GAAQ,UAAU;GAAM,cAAc;EAAG;EACnE,GAAI,SACD,CACA;GACC,MAAM;GACN,MAAM;GACN,UAAU;GACV,cAAc;GACd,OAAO;EACR,CACD,IACC,CAAC;EACJ;GAAE,MAAM;GAAa,MAAM;GAAU,UAAU;GAAM,cAAc;EAAE;EACrE;GAAE,MAAM;GAAU,MAAM;GAAU,UAAU;GAAM,cAAc;EAAE;EAClE;GAAE,MAAM;GAAc,MAAM;GAAU,UAAU;GAAM,cAAc;EAAE;EACtE;GAAE,MAAM;GAAY,MAAM;GAAU,UAAU;GAAM,cAAc;EAAE;EACpE;GAAE,MAAM;GAAY,MAAM;GAAU,UAAU;GAAM,cAAc;EAAE;EACpE;GAAE,MAAM;GAAW,MAAM;GAAU,UAAU;GAAM,cAAc;EAAE;EACnE;GAAE,MAAM;GAAe,MAAM;GAAU,UAAU;GAAM,cAAc;EAAE;EAGvE;GAAE,MAAM;GAAW,MAAM;GAAU,UAAU;GAAM,cAAc;EAAE;EACnE;GAAE,MAAM;GAAkB,MAAM;GAAU,UAAU;GAAM,cAAc;EAAE;EAC1E;GAAE,MAAM;GAAiB,MAAM;GAAU,UAAU;GAAM,cAAc;EAAE;CAC1E;CACA,SAAS,CACR,SACG;EACA,QAAQ;GAAC;GAAe;GAAU;GAAQ;GAAa;GAAY;GAAY;EAAO;EACtF,QAAQ;CACT,IACC;EACA,QAAQ;GAAC;GAAe;GAAU;GAAQ;GAAa;GAAY;EAAU;EAC7E,QAAQ;CACT,CACH;AACD"}
|
|
@@ -1,7 +1,5 @@
|
|
|
1
|
+
import { clientIpFromHeaders } from "../ingest/clientIp.js";
|
|
1
2
|
//#region src/native/geo/maxmindResolver.ts
|
|
2
|
-
const clientIp = (headers) => {
|
|
3
|
-
return headers.get("x-forwarded-for")?.split(",")[0]?.trim() || headers.get("x-real-ip") || null;
|
|
4
|
-
};
|
|
5
3
|
/**
|
|
6
4
|
* Optional MaxMind GeoLite2 resolver. The mmdb and the maxmind lib are loaded
|
|
7
5
|
* lazily on first use. Any failure (lib not installed, file missing/unreadable,
|
|
@@ -26,7 +24,7 @@ function maxmindResolver(options) {
|
|
|
26
24
|
return readerPromise;
|
|
27
25
|
};
|
|
28
26
|
return async (headers) => {
|
|
29
|
-
const ip =
|
|
27
|
+
const ip = clientIpFromHeaders(headers);
|
|
30
28
|
if (!ip) return {};
|
|
31
29
|
let reader;
|
|
32
30
|
try {
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"maxmindResolver.js","names":[],"sources":["../../../src/native/geo/maxmindResolver.ts"],"sourcesContent":["import type { CityResponse, Reader } from 'maxmind'\nimport type { Geo, GeoResolver } from './geoResolver'\n\nexport interface MaxmindOptions {\n\tdbPath: string\n}\n\
|
|
1
|
+
{"version":3,"file":"maxmindResolver.js","names":[],"sources":["../../../src/native/geo/maxmindResolver.ts"],"sourcesContent":["import type { CityResponse, Reader } from 'maxmind'\nimport { clientIpFromHeaders } from '../ingest/clientIp'\nimport type { Geo, GeoResolver } from './geoResolver'\n\nexport interface MaxmindOptions {\n\tdbPath: string\n}\n\n/**\n * Optional MaxMind GeoLite2 resolver. The mmdb and the maxmind lib are loaded\n * lazily on first use. Any failure (lib not installed, file missing/unreadable,\n * lookup error) degrades to empty geo after a single warning, so a missing or\n * unconfigured database never breaks ingestion.\n */\nexport function maxmindResolver(options: MaxmindOptions): GeoResolver {\n\tlet readerPromise: Promise<Reader<CityResponse>> | undefined\n\tlet warned = false\n\n\tconst warn = (detail: unknown): null => {\n\t\tif (!warned) {\n\t\t\twarned = true\n\t\t\tconsole.warn(\n\t\t\t\t`[analytics] MaxMind geo unavailable for \"${options.dbPath}\"; geo will be empty.`,\n\t\t\t\tdetail instanceof Error ? detail.message : detail\n\t\t\t)\n\t\t}\n\t\treturn null\n\t}\n\n\tconst getReader = (): Promise<Reader<CityResponse>> => {\n\t\tif (!readerPromise) {\n\t\t\treaderPromise = (async () => {\n\t\t\t\tconst { open } = await import('maxmind')\n\t\t\t\treturn open<CityResponse>(options.dbPath)\n\t\t\t})()\n\t\t}\n\t\treturn readerPromise\n\t}\n\n\treturn async (headers: Headers): Promise<Geo> => {\n\t\tconst ip = clientIpFromHeaders(headers)\n\t\tif (!ip) {\n\t\t\treturn {}\n\t\t}\n\t\tlet reader: Reader<CityResponse> | null\n\t\ttry {\n\t\t\treader = await getReader()\n\t\t} catch (err) {\n\t\t\twarn(err)\n\t\t\treturn {}\n\t\t}\n\t\ttry {\n\t\t\tconst r = reader.get(ip)\n\t\t\tif (!r) {\n\t\t\t\treturn {}\n\t\t\t}\n\t\t\treturn {\n\t\t\t\tcountry: r.country?.iso_code ?? undefined,\n\t\t\t\tregion: r.subdivisions?.[0]?.iso_code ?? undefined,\n\t\t\t\tcity: r.city?.names.en ?? undefined,\n\t\t\t}\n\t\t} catch (err) {\n\t\t\twarn(err)\n\t\t\treturn {}\n\t\t}\n\t}\n}\n"],"mappings":";;;;;;;;AAcA,SAAgB,gBAAgB,SAAsC;CACrE,IAAI;CACJ,IAAI,SAAS;CAEb,MAAM,QAAQ,WAA0B;EACvC,IAAI,CAAC,QAAQ;GACZ,SAAS;GACT,QAAQ,KACP,4CAA4C,QAAQ,OAAO,wBAC3D,kBAAkB,QAAQ,OAAO,UAAU,MAC5C;EACD;EACA,OAAO;CACR;CAEA,MAAM,kBAAiD;EACtD,IAAI,CAAC,eACJ,iBAAiB,YAAY;GAC5B,MAAM,EAAE,SAAS,MAAM,OAAO;GAC9B,OAAO,KAAmB,QAAQ,MAAM;EACzC,GAAG;EAEJ,OAAO;CACR;CAEA,OAAO,OAAO,YAAmC;EAChD,MAAM,KAAK,oBAAoB,OAAO;EACtC,IAAI,CAAC,IACJ,OAAO,CAAC;EAET,IAAI;EACJ,IAAI;GACH,SAAS,MAAM,UAAU;EAC1B,SAAS,KAAK;GACb,KAAK,GAAG;GACR,OAAO,CAAC;EACT;EACA,IAAI;GACH,MAAM,IAAI,OAAO,IAAI,EAAE;GACvB,IAAI,CAAC,GACJ,OAAO,CAAC;GAET,OAAO;IACN,SAAS,EAAE,SAAS,YAAY,KAAA;IAChC,QAAQ,EAAE,eAAe,IAAI,YAAY,KAAA;IACzC,MAAM,EAAE,MAAM,MAAM,MAAM,KAAA;GAC3B;EACD,SAAS,KAAK;GACb,KAAK,GAAG;GACR,OAAO,CAAC;EACT;CACD;AACD"}
|
|
@@ -0,0 +1,15 @@
|
|
|
1
|
+
//#region src/native/ingest/clientIp.ts
|
|
2
|
+
/**
|
|
3
|
+
* The originating client IP a proxy chain reported: the first hop of
|
|
4
|
+
* `x-forwarded-for`, else `x-real-ip`. Null when the request carries neither, so
|
|
5
|
+
* callers can omit the value instead of forwarding a fabricated one.
|
|
6
|
+
*/
|
|
7
|
+
const clientIpFromHeaders = (headers) => {
|
|
8
|
+
const forwarded = headers.get("x-forwarded-for")?.split(",")[0]?.trim();
|
|
9
|
+
if (forwarded) return forwarded;
|
|
10
|
+
return headers.get("x-real-ip")?.trim() || null;
|
|
11
|
+
};
|
|
12
|
+
//#endregion
|
|
13
|
+
export { clientIpFromHeaders };
|
|
14
|
+
|
|
15
|
+
//# sourceMappingURL=clientIp.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"clientIp.js","names":[],"sources":["../../../src/native/ingest/clientIp.ts"],"sourcesContent":["/**\n * The originating client IP a proxy chain reported: the first hop of\n * `x-forwarded-for`, else `x-real-ip`. Null when the request carries neither, so\n * callers can omit the value instead of forwarding a fabricated one.\n */\nexport const clientIpFromHeaders = (headers: Headers): string | null => {\n\tconst forwarded = headers.get('x-forwarded-for')?.split(',')[0]?.trim()\n\tif (forwarded) {\n\t\treturn forwarded\n\t}\n\treturn headers.get('x-real-ip')?.trim() || null\n}\n"],"mappings":";;;;;;AAKA,MAAa,uBAAuB,YAAoC;CACvE,MAAM,YAAY,QAAQ,IAAI,iBAAiB,GAAG,MAAM,GAAG,EAAE,IAAI,KAAK;CACtE,IAAI,WACH,OAAO;CAER,OAAO,QAAQ,IAAI,WAAW,GAAG,KAAK,KAAK;AAC5C"}
|
|
@@ -1,15 +1,23 @@
|
|
|
1
1
|
//#region src/native/ingest/device.ts
|
|
2
2
|
/**
|
|
3
|
-
*
|
|
4
|
-
*
|
|
3
|
+
* The user agent server-side tracking stamps when the event has no browser request behind
|
|
4
|
+
* it. There is no device to report, so events carrying it abstain from the device breakdown
|
|
5
|
+
* rather than piling into `desktop` and skewing it.
|
|
6
|
+
*/
|
|
7
|
+
const SERVER_USER_AGENT = "analytics-server";
|
|
8
|
+
/**
|
|
9
|
+
* Coarse device class from a user-agent string, or undefined when the agent is not a device
|
|
10
|
+
* at all. Tablets are checked before phones because an Android tablet UA lacks the `Mobile`
|
|
11
|
+
* token an Android phone carries.
|
|
5
12
|
*/
|
|
6
13
|
const classifyDevice = (ua) => {
|
|
14
|
+
if (ua === "analytics-server") return;
|
|
7
15
|
const s = ua.toLowerCase();
|
|
8
16
|
if (/ipad|tablet|playbook|silk|kindle/.test(s) || /android/.test(s) && !/mobi/.test(s)) return "tablet";
|
|
9
17
|
if (/mobi|iphone|ipod|android|blackberry|iemobile|opera mini|windows phone/.test(s)) return "mobile";
|
|
10
18
|
return "desktop";
|
|
11
19
|
};
|
|
12
20
|
//#endregion
|
|
13
|
-
export { classifyDevice };
|
|
21
|
+
export { SERVER_USER_AGENT, classifyDevice };
|
|
14
22
|
|
|
15
23
|
//# sourceMappingURL=device.js.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"device.js","names":[],"sources":["../../../src/native/ingest/device.ts"],"sourcesContent":["export type DeviceType = 'desktop' | 'mobile' | 'tablet'\n\n/**\n * Coarse device class from a user-agent string. Tablets are checked before phones
|
|
1
|
+
{"version":3,"file":"device.js","names":[],"sources":["../../../src/native/ingest/device.ts"],"sourcesContent":["export type DeviceType = 'desktop' | 'mobile' | 'tablet'\n\n/**\n * The user agent server-side tracking stamps when the event has no browser request behind\n * it. There is no device to report, so events carrying it abstain from the device breakdown\n * rather than piling into `desktop` and skewing it.\n */\nexport const SERVER_USER_AGENT = 'analytics-server'\n\n/**\n * Coarse device class from a user-agent string, or undefined when the agent is not a device\n * at all. Tablets are checked before phones because an Android tablet UA lacks the `Mobile`\n * token an Android phone carries.\n */\nexport const classifyDevice = (ua: string): DeviceType | undefined => {\n\tif (ua === SERVER_USER_AGENT) {\n\t\treturn undefined\n\t}\n\tconst s = ua.toLowerCase()\n\tif (/ipad|tablet|playbook|silk|kindle/.test(s) || (/android/.test(s) && !/mobi/.test(s))) {\n\t\treturn 'tablet'\n\t}\n\tif (/mobi|iphone|ipod|android|blackberry|iemobile|opera mini|windows phone/.test(s)) {\n\t\treturn 'mobile'\n\t}\n\treturn 'desktop'\n}\n"],"mappings":";;;;;;AAOA,MAAa,oBAAoB;;;;;;AAOjC,MAAa,kBAAkB,OAAuC;CACrE,IAAI,OAAA,oBACH;CAED,MAAM,IAAI,GAAG,YAAY;CACzB,IAAI,mCAAmC,KAAK,CAAC,KAAM,UAAU,KAAK,CAAC,KAAK,CAAC,OAAO,KAAK,CAAC,GACrF,OAAO;CAER,IAAI,wEAAwE,KAAK,CAAC,GACjF,OAAO;CAER,OAAO;AACR"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
import { PayloadRequest } from "payload";
|
|
@@ -1,15 +1,35 @@
|
|
|
1
|
+
import { readCappedBody } from "../../capture/requestBody.js";
|
|
1
2
|
import { flushBatch } from "./flushBatch.js";
|
|
2
3
|
import { normalizeEvent } from "./normalizeEvent.js";
|
|
3
4
|
import { dailySalt } from "./salt.js";
|
|
5
|
+
import { validateRawEvent } from "./validate.js";
|
|
4
6
|
//#region src/native/ingest/endpoint.ts
|
|
7
|
+
/** One event, not a session replay: far above any legitimate payload, far below a DoS. */
|
|
8
|
+
const MAX_INGEST_BODY_BYTES = 64 * 1024;
|
|
9
|
+
/**
|
|
10
|
+
* Parses the buffered body, answering undefined for anything the validator could not judge:
|
|
11
|
+
* a garbage POST is a 400 like any other bad payload rather than a thrown parse error that
|
|
12
|
+
* escapes into Payload's routeError as a logged 500.
|
|
13
|
+
*/
|
|
14
|
+
const parseBody = (bytes) => {
|
|
15
|
+
try {
|
|
16
|
+
const parsed = JSON.parse(new TextDecoder().decode(bytes));
|
|
17
|
+
return typeof parsed === "object" && parsed !== null ? parsed : void 0;
|
|
18
|
+
} catch {
|
|
19
|
+
return;
|
|
20
|
+
}
|
|
21
|
+
};
|
|
5
22
|
const makeIngestHandler = (geoResolver, getBuffer = () => null, resolvers = {}) => async (req) => {
|
|
6
|
-
const { scope: resolveScope, timezone: resolveTimezone } = resolvers;
|
|
7
|
-
const
|
|
8
|
-
if (!
|
|
23
|
+
const { scope: resolveScope, timezone: resolveTimezone, goals: resolveGoals } = resolvers;
|
|
24
|
+
const read = await readCappedBody(req, MAX_INGEST_BODY_BYTES);
|
|
25
|
+
if (!read.ok) return Response.json({ error: read.reason === "too-large" ? "payload too large" : "invalid payload" }, { status: read.reason === "too-large" ? 413 : 400 });
|
|
26
|
+
const raw = parseBody(read.body);
|
|
27
|
+
if (!validateRawEvent(raw)) return Response.json({ error: "invalid payload" }, { status: 400 });
|
|
9
28
|
const now = /* @__PURE__ */ new Date();
|
|
10
29
|
const salt = await dailySalt(req.payload, now);
|
|
11
30
|
const scope = resolveScope ? await resolveScope(req) ?? "" : void 0;
|
|
12
31
|
const timezone = resolveTimezone ? await resolveTimezone(req, scope ?? null) : void 0;
|
|
32
|
+
const goals = resolveGoals ? await resolveGoals(req, scope ?? null) : void 0;
|
|
13
33
|
const event = await normalizeEvent({
|
|
14
34
|
raw,
|
|
15
35
|
headers: req.headers,
|
|
@@ -17,7 +37,8 @@ const makeIngestHandler = (geoResolver, getBuffer = () => null, resolvers = {})
|
|
|
17
37
|
salt,
|
|
18
38
|
now,
|
|
19
39
|
scope,
|
|
20
|
-
timezone
|
|
40
|
+
timezone,
|
|
41
|
+
goals
|
|
21
42
|
});
|
|
22
43
|
const buffer = getBuffer();
|
|
23
44
|
if (buffer) buffer.add(event);
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"endpoint.js","names":[],"sources":["../../../src/native/ingest/endpoint.ts"],"sourcesContent":["import type { PayloadHandler, PayloadRequest } from 'payload'\nimport type { GeoResolver } from '../geo/geoResolver'\nimport { flushBatch } from './flushBatch'\nimport { normalizeEvent, type RawEventInput, type StoredEvent } from './normalizeEvent'\nimport { dailySalt } from './salt'\nimport type { WriteBuffer } from './writeBuffer'\n\nexport interface IngestResolvers {\n\tscope?: (req: PayloadRequest) => Promise<string | null>\n\ttimezone?: (req: PayloadRequest, scope?: string | null) => Promise<string>\n}\n\nexport const makeIngestHandler =\n\t(\n\t\tgeoResolver: GeoResolver,\n\t\tgetBuffer: () => WriteBuffer<StoredEvent> | null = () => null,\n\t\tresolvers: IngestResolvers = {}\n\t): PayloadHandler =>\n\tasync (req) => {\n\t\tconst { scope: resolveScope, timezone: resolveTimezone } = resolvers\n\t\
|
|
1
|
+
{"version":3,"file":"endpoint.js","names":[],"sources":["../../../src/native/ingest/endpoint.ts"],"sourcesContent":["import type { PayloadHandler, PayloadRequest } from 'payload'\nimport { readCappedBody } from '../../capture/requestBody'\nimport type { Goal } from '../../goals/types'\nimport type { GeoResolver } from '../geo/geoResolver'\nimport { flushBatch } from './flushBatch'\nimport { normalizeEvent, type RawEventInput, type StoredEvent } from './normalizeEvent'\nimport { dailySalt } from './salt'\nimport { validateRawEvent } from './validate'\nimport type { WriteBuffer } from './writeBuffer'\n\nexport interface IngestResolvers {\n\tscope?: (req: PayloadRequest) => Promise<string | null>\n\ttimezone?: (req: PayloadRequest, scope?: string | null) => Promise<string>\n\tgoals?: (req: PayloadRequest, scope?: string | null) => Promise<Goal[]>\n}\n\n/** One event, not a session replay: far above any legitimate payload, far below a DoS. */\nexport const MAX_INGEST_BODY_BYTES = 64 * 1024\n\n/**\n * Parses the buffered body, answering undefined for anything the validator could not judge:\n * a garbage POST is a 400 like any other bad payload rather than a thrown parse error that\n * escapes into Payload's routeError as a logged 500.\n */\nconst parseBody = (bytes: ArrayBuffer): RawEventInput | undefined => {\n\ttry {\n\t\tconst parsed: unknown = JSON.parse(new TextDecoder().decode(bytes))\n\t\treturn typeof parsed === 'object' && parsed !== null ? (parsed as RawEventInput) : undefined\n\t} catch {\n\t\treturn undefined\n\t}\n}\n\nexport const makeIngestHandler =\n\t(\n\t\tgeoResolver: GeoResolver,\n\t\tgetBuffer: () => WriteBuffer<StoredEvent> | null = () => null,\n\t\tresolvers: IngestResolvers = {}\n\t): PayloadHandler =>\n\tasync (req) => {\n\t\tconst { scope: resolveScope, timezone: resolveTimezone, goals: resolveGoals } = resolvers\n\t\t// Read like the capture proxy does, and for the same reasons: this is a public,\n\t\t// unauthenticated path, so the body is capped before it is buffered and a body that\n\t\t// dies in transit (a beacon from an unloading tab) answers 400 rather than throwing.\n\t\tconst read = await readCappedBody(req, MAX_INGEST_BODY_BYTES)\n\t\tif (!read.ok) {\n\t\t\treturn Response.json(\n\t\t\t\t{ error: read.reason === 'too-large' ? 'payload too large' : 'invalid payload' },\n\t\t\t\t{ status: read.reason === 'too-large' ? 413 : 400 }\n\t\t\t)\n\t\t}\n\t\tconst raw = parseBody(read.body)\n\t\tif (!validateRawEvent(raw)) {\n\t\t\treturn Response.json({ error: 'invalid payload' }, { status: 400 })\n\t\t}\n\t\tconst now = new Date()\n\t\tconst salt = await dailySalt(req.payload, now)\n\t\tconst scope = resolveScope ? ((await resolveScope(req)) ?? '') : undefined\n\t\tconst timezone = resolveTimezone ? await resolveTimezone(req, scope ?? null) : undefined\n\t\t// Goals resolve under the same scope the event is stamped with, so a tenant's event\n\t\t// can only ever complete that tenant's goals.\n\t\tconst goals = resolveGoals ? await resolveGoals(req, scope ?? null) : undefined\n\t\tconst event = await normalizeEvent({\n\t\t\traw,\n\t\t\theaders: req.headers,\n\t\t\tgeoResolver,\n\t\t\tsalt,\n\t\t\tnow,\n\t\t\tscope,\n\t\t\ttimezone,\n\t\t\tgoals,\n\t\t})\n\t\tconst buffer = getBuffer()\n\t\tif (buffer) {\n\t\t\tbuffer.add(event)\n\t\t} else {\n\t\t\tawait flushBatch(req.payload, [event])\n\t\t}\n\t\treturn Response.json({ ok: true }, { status: 202 })\n\t}\n"],"mappings":";;;;;;;AAiBA,MAAa,wBAAwB,KAAK;;;;;;AAO1C,MAAM,aAAa,UAAkD;CACpE,IAAI;EACH,MAAM,SAAkB,KAAK,MAAM,IAAI,YAAY,EAAE,OAAO,KAAK,CAAC;EAClE,OAAO,OAAO,WAAW,YAAY,WAAW,OAAQ,SAA2B,KAAA;CACpF,QAAQ;EACP;CACD;AACD;AAEA,MAAa,qBAEX,aACA,kBAAyD,MACzD,YAA6B,CAAC,MAE/B,OAAO,QAAQ;CACd,MAAM,EAAE,OAAO,cAAc,UAAU,iBAAiB,OAAO,iBAAiB;CAIhF,MAAM,OAAO,MAAM,eAAe,KAAK,qBAAqB;CAC5D,IAAI,CAAC,KAAK,IACT,OAAO,SAAS,KACf,EAAE,OAAO,KAAK,WAAW,cAAc,sBAAsB,kBAAkB,GAC/E,EAAE,QAAQ,KAAK,WAAW,cAAc,MAAM,IAAI,CACnD;CAED,MAAM,MAAM,UAAU,KAAK,IAAI;CAC/B,IAAI,CAAC,iBAAiB,GAAG,GACxB,OAAO,SAAS,KAAK,EAAE,OAAO,kBAAkB,GAAG,EAAE,QAAQ,IAAI,CAAC;CAEnE,MAAM,sBAAM,IAAI,KAAK;CACrB,MAAM,OAAO,MAAM,UAAU,IAAI,SAAS,GAAG;CAC7C,MAAM,QAAQ,eAAiB,MAAM,aAAa,GAAG,KAAM,KAAM,KAAA;CACjE,MAAM,WAAW,kBAAkB,MAAM,gBAAgB,KAAK,SAAS,IAAI,IAAI,KAAA;CAG/E,MAAM,QAAQ,eAAe,MAAM,aAAa,KAAK,SAAS,IAAI,IAAI,KAAA;CACtE,MAAM,QAAQ,MAAM,eAAe;EAClC;EACA,SAAS,IAAI;EACb;EACA;EACA;EACA;EACA;EACA;CACD,CAAC;CACD,MAAM,SAAS,UAAU;CACzB,IAAI,QACH,OAAO,IAAI,KAAK;MAEhB,MAAM,WAAW,IAAI,SAAS,CAAC,KAAK,CAAC;CAEtC,OAAO,SAAS,KAAK,EAAE,IAAI,KAAK,GAAG,EAAE,QAAQ,IAAI,CAAC;AACnD"}
|