@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
|
@@ -0,0 +1,57 @@
|
|
|
1
|
+
/** Dot-separated labels, which is also every IPv4 literal. */
|
|
2
|
+
const DNS_NAME = /^[a-z0-9_-]+(\.[a-z0-9_-]+)*$/;
|
|
3
|
+
/** An IPv6 literal as a `Host` header spells it, minus the brackets: hex groups and colons. */
|
|
4
|
+
const IPV6 = /^[0-9a-f]{0,4}(:[0-9a-f]{0,4}){2,7}$/;
|
|
5
|
+
/**
|
|
6
|
+
* The one shape a hostname has anywhere in this plugin: config entries, `platformHostnames`,
|
|
7
|
+
* the host a request carried and a resolver's answer are all held to it. A host that can only
|
|
8
|
+
* be spelled one way can only open one rollup bucket family, and nothing prunes those, so a
|
|
9
|
+
* public endpoint that accepted several spellings of one name would hand a client an unbounded
|
|
10
|
+
* write.
|
|
11
|
+
*/
|
|
12
|
+
const isHostname = (value) => value.length > 0 && value.length <= 253 && (DNS_NAME.test(value) || IPV6.test(value));
|
|
13
|
+
/** `host[:port]`, or the bracketed IPv6 form a `Host` header uses, which loses its brackets. */
|
|
14
|
+
const stripPort = (value) => {
|
|
15
|
+
const bracketed = /^\[([^\]]*)\](?::\d+)?$/.exec(value);
|
|
16
|
+
if (bracketed) return bracketed[1] ?? "";
|
|
17
|
+
return /^([^:]*)(?::\d+)?$/.exec(value)?.[1] ?? value;
|
|
18
|
+
};
|
|
19
|
+
/**
|
|
20
|
+
* A hostname as it is stored and compared: lowercased, without port, brackets or trailing root
|
|
21
|
+
* dots. Null for anything that is not {@link isHostname} afterwards, so a caller drops it
|
|
22
|
+
* rather than opening a rollup bucket family for junk.
|
|
23
|
+
*/
|
|
24
|
+
const normalizeHostname = (value) => {
|
|
25
|
+
const raw = value?.trim().toLowerCase();
|
|
26
|
+
if (!raw) return null;
|
|
27
|
+
const host = stripPort(raw).replace(/\.+$/, "");
|
|
28
|
+
return isHostname(host) ? host : null;
|
|
29
|
+
};
|
|
30
|
+
/**
|
|
31
|
+
* The host the request itself carries: the `x-forwarded-host` entry `n` from the right where
|
|
32
|
+
* `n` proxy hops are trusted, which is the value the outermost trusted proxy wrote, else the
|
|
33
|
+
* `Host` header. Counting from the left would read the attacker-controlled end, since a proxy
|
|
34
|
+
* that appends rather than replaces keeps whatever the client sent ahead of its own value.
|
|
35
|
+
*
|
|
36
|
+
* `Host` is the fallback whenever the forwarded chain yields nothing usable, whether it is
|
|
37
|
+
* shorter than the trusted count or carries junk: the peer is still the trusted proxy, so
|
|
38
|
+
* `Host` is what that proxy sent.
|
|
39
|
+
*
|
|
40
|
+
* The `Origin` header is deliberately never read: a scripted client can pair a valid `Host`
|
|
41
|
+
* with any `Origin` it likes and mint unlimited hostnames inside one scope, which is the hole
|
|
42
|
+
* request attribution exists to close. A split deployment whose page host differs from its API
|
|
43
|
+
* host validates `Origin` itself, through the `hostname` resolver form.
|
|
44
|
+
*/
|
|
45
|
+
const requestHostname = (headers, opts) => {
|
|
46
|
+
const hops = opts.trustedProxyHops ?? 0;
|
|
47
|
+
if (hops >= 1) {
|
|
48
|
+
const chain = (headers.get("x-forwarded-host") ?? "").split(",").map((entry) => entry.trim()).filter(Boolean);
|
|
49
|
+
const forwarded = normalizeHostname(chain[chain.length - hops]);
|
|
50
|
+
if (forwarded) return forwarded;
|
|
51
|
+
}
|
|
52
|
+
return normalizeHostname(headers.get("host"));
|
|
53
|
+
};
|
|
54
|
+
//#endregion
|
|
55
|
+
export { isHostname, normalizeHostname, requestHostname };
|
|
56
|
+
|
|
57
|
+
//# sourceMappingURL=requestHost.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"requestHost.js","names":[],"sources":["../../../src/native/ingest/requestHost.ts"],"sourcesContent":["/** Longest legal DNS name, and the cap every stored hostname carries. */\nexport const MAX_HOSTNAME_LENGTH = 253\n\n/** Dot-separated labels, which is also every IPv4 literal. */\nconst DNS_NAME = /^[a-z0-9_-]+(\\.[a-z0-9_-]+)*$/\n\n/** An IPv6 literal as a `Host` header spells it, minus the brackets: hex groups and colons. */\nconst IPV6 = /^[0-9a-f]{0,4}(:[0-9a-f]{0,4}){2,7}$/\n\n/**\n * The one shape a hostname has anywhere in this plugin: config entries, `platformHostnames`,\n * the host a request carried and a resolver's answer are all held to it. A host that can only\n * be spelled one way can only open one rollup bucket family, and nothing prunes those, so a\n * public endpoint that accepted several spellings of one name would hand a client an unbounded\n * write.\n */\nexport const isHostname = (value: string): boolean =>\n\tvalue.length > 0 &&\n\tvalue.length <= MAX_HOSTNAME_LENGTH &&\n\t(DNS_NAME.test(value) || IPV6.test(value))\n\n/** `host[:port]`, or the bracketed IPv6 form a `Host` header uses, which loses its brackets. */\nconst stripPort = (value: string): string => {\n\tconst bracketed = /^\\[([^\\]]*)\\](?::\\d+)?$/.exec(value)\n\tif (bracketed) {\n\t\treturn bracketed[1] ?? ''\n\t}\n\tconst named = /^([^:]*)(?::\\d+)?$/.exec(value)\n\treturn named?.[1] ?? value\n}\n\n/**\n * A hostname as it is stored and compared: lowercased, without port, brackets or trailing root\n * dots. Null for anything that is not {@link isHostname} afterwards, so a caller drops it\n * rather than opening a rollup bucket family for junk.\n */\nexport const normalizeHostname = (value: string | null | undefined): string | null => {\n\tconst raw = value?.trim().toLowerCase()\n\tif (!raw) {\n\t\treturn null\n\t}\n\t// Every trailing dot rather than one: `example.com.` and `example.com..` name the same\n\t// host, and each extra spelling left standing would be its own bucket family.\n\tconst host = stripPort(raw).replace(/\\.+$/, '')\n\treturn isHostname(host) ? host : null\n}\n\nexport interface RequestHostnameOptions {\n\t/** Trusted proxies in front of the app; `x-forwarded-host` is only read at one or more. */\n\ttrustedProxyHops?: number\n}\n\n/**\n * The host the request itself carries: the `x-forwarded-host` entry `n` from the right where\n * `n` proxy hops are trusted, which is the value the outermost trusted proxy wrote, else the\n * `Host` header. Counting from the left would read the attacker-controlled end, since a proxy\n * that appends rather than replaces keeps whatever the client sent ahead of its own value.\n *\n * `Host` is the fallback whenever the forwarded chain yields nothing usable, whether it is\n * shorter than the trusted count or carries junk: the peer is still the trusted proxy, so\n * `Host` is what that proxy sent.\n *\n * The `Origin` header is deliberately never read: a scripted client can pair a valid `Host`\n * with any `Origin` it likes and mint unlimited hostnames inside one scope, which is the hole\n * request attribution exists to close. A split deployment whose page host differs from its API\n * host validates `Origin` itself, through the `hostname` resolver form.\n */\nexport const requestHostname = (headers: Headers, opts: RequestHostnameOptions): string | null => {\n\tconst hops = opts.trustedProxyHops ?? 0\n\tif (hops >= 1) {\n\t\tconst chain = (headers.get('x-forwarded-host') ?? '')\n\t\t\t.split(',')\n\t\t\t.map((entry) => entry.trim())\n\t\t\t.filter(Boolean)\n\t\tconst forwarded = normalizeHostname(chain[chain.length - hops])\n\t\tif (forwarded) {\n\t\t\treturn forwarded\n\t\t}\n\t}\n\treturn normalizeHostname(headers.get('host'))\n}\n"],"mappings":";AAIA,MAAM,WAAW;;AAGjB,MAAM,OAAO;;;;;;;;AASb,MAAa,cAAc,UAC1B,MAAM,SAAS,KACf,MAAM,UAAA,QACL,SAAS,KAAK,KAAK,KAAK,KAAK,KAAK,KAAK;;AAGzC,MAAM,aAAa,UAA0B;CAC5C,MAAM,YAAY,0BAA0B,KAAK,KAAK;CACtD,IAAI,WACH,OAAO,UAAU,MAAM;CAGxB,OADc,qBAAqB,KAAK,KAC7B,IAAI,MAAM;AACtB;;;;;;AAOA,MAAa,qBAAqB,UAAoD;CACrF,MAAM,MAAM,OAAO,KAAK,EAAE,YAAY;CACtC,IAAI,CAAC,KACJ,OAAO;CAIR,MAAM,OAAO,UAAU,GAAG,EAAE,QAAQ,QAAQ,EAAE;CAC9C,OAAO,WAAW,IAAI,IAAI,OAAO;AAClC;;;;;;;;;;;;;;;;AAsBA,MAAa,mBAAmB,SAAkB,SAAgD;CACjG,MAAM,OAAO,KAAK,oBAAoB;CACtC,IAAI,QAAQ,GAAG;EACd,MAAM,SAAS,QAAQ,IAAI,kBAAkB,KAAK,IAChD,MAAM,GAAG,EACT,KAAK,UAAU,MAAM,KAAK,CAAC,EAC3B,OAAO,OAAO;EAChB,MAAM,YAAY,kBAAkB,MAAM,MAAM,SAAS,KAAK;EAC9D,IAAI,WACH,OAAO;CAET;CACA,OAAO,kBAAkB,QAAQ,IAAI,MAAM,CAAC;AAC7C"}
|
|
@@ -0,0 +1,29 @@
|
|
|
1
|
+
import { PayloadRequest } from "payload";
|
|
2
|
+
|
|
3
|
+
//#region src/native/ingest/resolveHostname.d.ts
|
|
4
|
+
/**
|
|
5
|
+
* Decides the hostname an event is stored under, or null to drop it. `claimed` is what the
|
|
6
|
+
* body sent, which is never trusted on its own; `scope` is the scope the request already
|
|
7
|
+
* resolved to, so a split deployment can validate `Origin` against that tenant's own domains.
|
|
8
|
+
*
|
|
9
|
+
* The answer must be a hostname: it is normalized and then held to the same shape a request
|
|
10
|
+
* host is, and anything else (a slug, a tenant id, free text) drops the event rather than
|
|
11
|
+
* storing per-event text no rollup family can ever be pruned from.
|
|
12
|
+
*
|
|
13
|
+
* Distinct from the binding `HostnameResolver`, which names the hostname a document is read
|
|
14
|
+
* under rather than the one an event is written under.
|
|
15
|
+
*/
|
|
16
|
+
type EventHostnameResolver = (args: {
|
|
17
|
+
claimed: string | undefined;
|
|
18
|
+
req: PayloadRequest;
|
|
19
|
+
scope: string | null;
|
|
20
|
+
}) => string | null | Promise<string | null>;
|
|
21
|
+
/**
|
|
22
|
+
* `'request'` stores the host the request carried. A list stores the request host only when it
|
|
23
|
+
* is one of those, for a single-site install behind no host validation. A function decides for
|
|
24
|
+
* itself.
|
|
25
|
+
*/
|
|
26
|
+
type HostnameOption = 'request' | string[] | EventHostnameResolver;
|
|
27
|
+
//#endregion
|
|
28
|
+
export { EventHostnameResolver, HostnameOption };
|
|
29
|
+
//# sourceMappingURL=resolveHostname.d.ts.map
|
|
@@ -0,0 +1,52 @@
|
|
|
1
|
+
import { isHostname, normalizeHostname, requestHostname } from "./requestHost.js";
|
|
2
|
+
//#region src/native/ingest/resolveHostname.ts
|
|
3
|
+
/**
|
|
4
|
+
* Config-time list validation: entries are lowercased here, so the ingest compare is exact.
|
|
5
|
+
* The port is not stripped the way a request host's is, because an entry carrying one would
|
|
6
|
+
* otherwise be accepted and then silently never match what is stored.
|
|
7
|
+
*/
|
|
8
|
+
const hostnameSet = (values, option) => {
|
|
9
|
+
const hosts = /* @__PURE__ */ new Set();
|
|
10
|
+
for (const value of values ?? []) {
|
|
11
|
+
const host = typeof value === "string" ? value.trim().toLowerCase().replace(/\.+$/, "") : "";
|
|
12
|
+
if (!isHostname(host)) throw new Error(`analytics: ${option} entries must each be a bare hostname, got "${String(value)}"`);
|
|
13
|
+
hosts.add(host);
|
|
14
|
+
}
|
|
15
|
+
return hosts;
|
|
16
|
+
};
|
|
17
|
+
const resolveHostnameOption = (option) => {
|
|
18
|
+
if (option === void 0 || option === "request") return { kind: "request" };
|
|
19
|
+
if (typeof option === "function") return {
|
|
20
|
+
kind: "resolver",
|
|
21
|
+
resolve: option
|
|
22
|
+
};
|
|
23
|
+
if (!Array.isArray(option)) throw new Error(`analytics: hostname must be "request", a list of hostnames, or a resolver, got ${typeof option}`);
|
|
24
|
+
if (option.length === 0) throw new Error("analytics: hostname must name at least one hostname, or every event drops");
|
|
25
|
+
return {
|
|
26
|
+
kind: "list",
|
|
27
|
+
hosts: hostnameSet(option, "hostname")
|
|
28
|
+
};
|
|
29
|
+
};
|
|
30
|
+
/**
|
|
31
|
+
* The hostname to store for one event, or null to drop it. A resolver that throws drops the
|
|
32
|
+
* event too: ingest is a public path, so a broken lookup loses the event rather than the
|
|
33
|
+
* response.
|
|
34
|
+
*/
|
|
35
|
+
const resolveEventHostname = async ({ option, claimed, req, scope, trustedProxyHops }) => {
|
|
36
|
+
const host = requestHostname(req.headers, { trustedProxyHops });
|
|
37
|
+
if (option.kind === "request") return host;
|
|
38
|
+
if (option.kind === "list") return host && option.hosts.has(host) ? host : null;
|
|
39
|
+
try {
|
|
40
|
+
return normalizeHostname(await option.resolve({
|
|
41
|
+
claimed,
|
|
42
|
+
req,
|
|
43
|
+
scope
|
|
44
|
+
}));
|
|
45
|
+
} catch {
|
|
46
|
+
return null;
|
|
47
|
+
}
|
|
48
|
+
};
|
|
49
|
+
//#endregion
|
|
50
|
+
export { hostnameSet, resolveEventHostname, resolveHostnameOption };
|
|
51
|
+
|
|
52
|
+
//# sourceMappingURL=resolveHostname.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"resolveHostname.js","names":[],"sources":["../../../src/native/ingest/resolveHostname.ts"],"sourcesContent":["import type { PayloadRequest } from 'payload'\nimport { isHostname, normalizeHostname, requestHostname } from './requestHost'\n\n/**\n * Decides the hostname an event is stored under, or null to drop it. `claimed` is what the\n * body sent, which is never trusted on its own; `scope` is the scope the request already\n * resolved to, so a split deployment can validate `Origin` against that tenant's own domains.\n *\n * The answer must be a hostname: it is normalized and then held to the same shape a request\n * host is, and anything else (a slug, a tenant id, free text) drops the event rather than\n * storing per-event text no rollup family can ever be pruned from.\n *\n * Distinct from the binding `HostnameResolver`, which names the hostname a document is read\n * under rather than the one an event is written under.\n */\nexport type EventHostnameResolver = (args: {\n\tclaimed: string | undefined\n\treq: PayloadRequest\n\tscope: string | null\n}) => string | null | Promise<string | null>\n\n/**\n * `'request'` stores the host the request carried. A list stores the request host only when it\n * is one of those, for a single-site install behind no host validation. A function decides for\n * itself.\n */\nexport type HostnameOption = 'request' | string[] | EventHostnameResolver\n\nexport type ResolvedHostnameOption =\n\t| { kind: 'request' }\n\t| { kind: 'list'; hosts: ReadonlySet<string> }\n\t| { kind: 'resolver'; resolve: EventHostnameResolver }\n\n/**\n * Config-time list validation: entries are lowercased here, so the ingest compare is exact.\n * The port is not stripped the way a request host's is, because an entry carrying one would\n * otherwise be accepted and then silently never match what is stored.\n */\nexport const hostnameSet = (values: string[] | undefined, option: string): ReadonlySet<string> => {\n\tconst hosts = new Set<string>()\n\tfor (const value of values ?? []) {\n\t\tconst host = typeof value === 'string' ? value.trim().toLowerCase().replace(/\\.+$/, '') : ''\n\t\tif (!isHostname(host)) {\n\t\t\tthrow new Error(\n\t\t\t\t`analytics: ${option} entries must each be a bare hostname, got \"${String(value)}\"`\n\t\t\t)\n\t\t}\n\t\thosts.add(host)\n\t}\n\treturn hosts\n}\n\nexport const resolveHostnameOption = (\n\toption: HostnameOption | undefined\n): ResolvedHostnameOption => {\n\tif (option === undefined || option === 'request') {\n\t\treturn { kind: 'request' }\n\t}\n\tif (typeof option === 'function') {\n\t\treturn { kind: 'resolver', resolve: option }\n\t}\n\tif (!Array.isArray(option)) {\n\t\tthrow new Error(\n\t\t\t`analytics: hostname must be \"request\", a list of hostnames, or a resolver, got ${typeof option}`\n\t\t)\n\t}\n\tif (option.length === 0) {\n\t\tthrow new Error('analytics: hostname must name at least one hostname, or every event drops')\n\t}\n\treturn { kind: 'list', hosts: hostnameSet(option, 'hostname') }\n}\n\nexport interface ResolveEventHostnameArgs {\n\toption: ResolvedHostnameOption\n\tclaimed: string | undefined\n\treq: PayloadRequest\n\tscope: string | null\n\ttrustedProxyHops?: number\n}\n\n/**\n * The hostname to store for one event, or null to drop it. A resolver that throws drops the\n * event too: ingest is a public path, so a broken lookup loses the event rather than the\n * response.\n */\nexport const resolveEventHostname = async ({\n\toption,\n\tclaimed,\n\treq,\n\tscope,\n\ttrustedProxyHops,\n}: ResolveEventHostnameArgs): Promise<string | null> => {\n\tconst host = requestHostname(req.headers, { trustedProxyHops })\n\tif (option.kind === 'request') {\n\t\treturn host\n\t}\n\tif (option.kind === 'list') {\n\t\treturn host && option.hosts.has(host) ? host : null\n\t}\n\ttry {\n\t\treturn normalizeHostname(await option.resolve({ claimed, req, scope }))\n\t} catch {\n\t\treturn null\n\t}\n}\n"],"mappings":";;;;;;;AAsCA,MAAa,eAAe,QAA8B,WAAwC;CACjG,MAAM,wBAAQ,IAAI,IAAY;CAC9B,KAAK,MAAM,SAAS,UAAU,CAAC,GAAG;EACjC,MAAM,OAAO,OAAO,UAAU,WAAW,MAAM,KAAK,EAAE,YAAY,EAAE,QAAQ,QAAQ,EAAE,IAAI;EAC1F,IAAI,CAAC,WAAW,IAAI,GACnB,MAAM,IAAI,MACT,cAAc,OAAO,8CAA8C,OAAO,KAAK,EAAE,EAClF;EAED,MAAM,IAAI,IAAI;CACf;CACA,OAAO;AACR;AAEA,MAAa,yBACZ,WAC4B;CAC5B,IAAI,WAAW,KAAA,KAAa,WAAW,WACtC,OAAO,EAAE,MAAM,UAAU;CAE1B,IAAI,OAAO,WAAW,YACrB,OAAO;EAAE,MAAM;EAAY,SAAS;CAAO;CAE5C,IAAI,CAAC,MAAM,QAAQ,MAAM,GACxB,MAAM,IAAI,MACT,kFAAkF,OAAO,QAC1F;CAED,IAAI,OAAO,WAAW,GACrB,MAAM,IAAI,MAAM,2EAA2E;CAE5F,OAAO;EAAE,MAAM;EAAQ,OAAO,YAAY,QAAQ,UAAU;CAAE;AAC/D;;;;;;AAeA,MAAa,uBAAuB,OAAO,EAC1C,QACA,SACA,KACA,OACA,uBACuD;CACvD,MAAM,OAAO,gBAAgB,IAAI,SAAS,EAAE,iBAAiB,CAAC;CAC9D,IAAI,OAAO,SAAS,WACnB,OAAO;CAER,IAAI,OAAO,SAAS,QACnB,OAAO,QAAQ,OAAO,MAAM,IAAI,IAAI,IAAI,OAAO;CAEhD,IAAI;EACH,OAAO,kBAAkB,MAAM,OAAO,QAAQ;GAAE;GAAS;GAAK;EAAM,CAAC,CAAC;CACvE,QAAQ;EACP,OAAO;CACR;AACD"}
|
|
@@ -1,14 +1,39 @@
|
|
|
1
1
|
import { randomBytes } from "node:crypto";
|
|
2
2
|
//#region src/native/ingest/salt.ts
|
|
3
|
+
const DAY_MS = 864e5;
|
|
4
|
+
/**
|
|
5
|
+
* The KV key a day's visitor salt lives under. Keyed by UTC day so the salt rotates at
|
|
6
|
+
* midnight; payload.kv has no TTL, so old days are deleted by this name.
|
|
7
|
+
*/
|
|
8
|
+
const saltKey = (day) => `analytics:salt:${day.toISOString().slice(0, 10)}`;
|
|
9
|
+
/**
|
|
10
|
+
* An event arriving just before midnight is still hashed with yesterday's salt, so the sweep
|
|
11
|
+
* starts two days back. A week is what one ingest can reach without a listing; the nightly
|
|
12
|
+
* task covers a wider window when an install runs it.
|
|
13
|
+
*/
|
|
14
|
+
const SWEEP_FIRST_DAY = 2;
|
|
15
|
+
const SWEEP_LAST_DAY = 8;
|
|
16
|
+
/**
|
|
17
|
+
* Deletes the salts a new day has made unreadable, without waiting on them: the salts must not
|
|
18
|
+
* accumulate forever on an install that runs no jobs, and no visitor hash depends on this
|
|
19
|
+
* finishing. Keys go by computed name, so a day already gone is a no-op on every kv adapter.
|
|
20
|
+
*/
|
|
21
|
+
const sweepOldSalts = (payload, now) => {
|
|
22
|
+
for (let day = SWEEP_FIRST_DAY; day <= SWEEP_LAST_DAY; day++) {
|
|
23
|
+
const stale = saltKey(/* @__PURE__ */ new Date(now.getTime() - day * DAY_MS));
|
|
24
|
+
Promise.resolve().then(() => payload.kv.delete(stale)).catch(() => void 0);
|
|
25
|
+
}
|
|
26
|
+
};
|
|
3
27
|
async function dailySalt(payload, now) {
|
|
4
|
-
const key =
|
|
28
|
+
const key = saltKey(now);
|
|
5
29
|
const existing = await payload.kv.get(key);
|
|
6
30
|
if (existing) return existing.salt;
|
|
7
31
|
const salt = randomBytes(16).toString("hex");
|
|
8
32
|
await payload.kv.set(key, { salt });
|
|
33
|
+
sweepOldSalts(payload, now);
|
|
9
34
|
return salt;
|
|
10
35
|
}
|
|
11
36
|
//#endregion
|
|
12
|
-
export { dailySalt };
|
|
37
|
+
export { dailySalt, saltKey };
|
|
13
38
|
|
|
14
39
|
//# sourceMappingURL=salt.js.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"salt.js","names":[],"sources":["../../../src/native/ingest/salt.ts"],"sourcesContent":["import { randomBytes } from 'node:crypto'\nimport type { Payload } from 'payload'\n\n
|
|
1
|
+
{"version":3,"file":"salt.js","names":[],"sources":["../../../src/native/ingest/salt.ts"],"sourcesContent":["import { randomBytes } from 'node:crypto'\nimport type { Payload } from 'payload'\n\nconst DAY_MS = 86_400_000\n\n/**\n * The KV key a day's visitor salt lives under. Keyed by UTC day so the salt rotates at\n * midnight; payload.kv has no TTL, so old days are deleted by this name.\n */\nexport const saltKey = (day: Date): string => `analytics:salt:${day.toISOString().slice(0, 10)}`\n\n/**\n * An event arriving just before midnight is still hashed with yesterday's salt, so the sweep\n * starts two days back. A week is what one ingest can reach without a listing; the nightly\n * task covers a wider window when an install runs it.\n */\nconst SWEEP_FIRST_DAY = 2\nconst SWEEP_LAST_DAY = 8\n\n/**\n * Deletes the salts a new day has made unreadable, without waiting on them: the salts must not\n * accumulate forever on an install that runs no jobs, and no visitor hash depends on this\n * finishing. Keys go by computed name, so a day already gone is a no-op on every kv adapter.\n */\nconst sweepOldSalts = (payload: Payload, now: Date): void => {\n\tfor (let day = SWEEP_FIRST_DAY; day <= SWEEP_LAST_DAY; day++) {\n\t\tconst stale = saltKey(new Date(now.getTime() - day * DAY_MS))\n\t\t// The call itself is inside the thenable, so a kv adapter that throws synchronously\n\t\t// fails the sweep rather than the ingest that triggered it.\n\t\tvoid Promise.resolve()\n\t\t\t.then(() => payload.kv.delete(stale))\n\t\t\t.catch(() => undefined)\n\t}\n}\n\nexport async function dailySalt(payload: Payload, now: Date): Promise<string> {\n\tconst key = saltKey(now)\n\tconst existing = await payload.kv.get<{ salt: string }>(key)\n\tif (existing) {\n\t\treturn existing.salt\n\t}\n\tconst salt = randomBytes(16).toString('hex')\n\tawait payload.kv.set(key, { salt })\n\tsweepOldSalts(payload, now)\n\treturn salt\n}\n"],"mappings":";;AAGA,MAAM,SAAS;;;;;AAMf,MAAa,WAAW,QAAsB,kBAAkB,IAAI,YAAY,EAAE,MAAM,GAAG,EAAE;;;;;;AAO7F,MAAM,kBAAkB;AACxB,MAAM,iBAAiB;;;;;;AAOvB,MAAM,iBAAiB,SAAkB,QAAoB;CAC5D,KAAK,IAAI,MAAM,iBAAiB,OAAO,gBAAgB,OAAO;EAC7D,MAAM,QAAQ,wBAAQ,IAAI,KAAK,IAAI,QAAQ,IAAI,MAAM,MAAM,CAAC;EAG5D,QAAa,QAAQ,EACnB,WAAW,QAAQ,GAAG,OAAO,KAAK,CAAC,EACnC,YAAY,KAAA,CAAS;CACxB;AACD;AAEA,eAAsB,UAAU,SAAkB,KAA4B;CAC7E,MAAM,MAAM,QAAQ,GAAG;CACvB,MAAM,WAAW,MAAM,QAAQ,GAAG,IAAsB,GAAG;CAC3D,IAAI,UACH,OAAO,SAAS;CAEjB,MAAM,OAAO,YAAY,EAAE,EAAE,SAAS,KAAK;CAC3C,MAAM,QAAQ,GAAG,IAAI,KAAK,EAAE,KAAK,CAAC;CAClC,cAAc,SAAS,GAAG;CAC1B,OAAO;AACR"}
|
|
@@ -0,0 +1,20 @@
|
|
|
1
|
+
import { ServerEventInput, ServerTrackOptions } from "../../core/serverEvent.js";
|
|
2
|
+
import { Payload } from "payload";
|
|
3
|
+
|
|
4
|
+
//#region src/native/ingest/serverTrack.d.ts
|
|
5
|
+
/**
|
|
6
|
+
* Records an analytics event from server code: a webhook, a job, a server action. The event
|
|
7
|
+
* goes through the same normalization, sanitization and goal matching a browser event does.
|
|
8
|
+
* Pass `opts.req` whenever there is a request behind the event, so it inherits that request's
|
|
9
|
+
* attribution, scope and reporting timezone.
|
|
10
|
+
*
|
|
11
|
+
* `event.scope` overrides the request's scope; it is ignored on an unscoped install and is
|
|
12
|
+
* never checked against the scopes that exist, so the caller owns what it stamps.
|
|
13
|
+
*
|
|
14
|
+
* Needs the native adapter: a provider slot (Plausible, GA4) has no server ingestion seam
|
|
15
|
+
* here yet, so an install without the native adapter throws rather than dropping the event.
|
|
16
|
+
*/
|
|
17
|
+
declare const trackServerEvent: (payload: Payload, event: ServerEventInput, opts?: ServerTrackOptions) => Promise<void>;
|
|
18
|
+
//#endregion
|
|
19
|
+
export { trackServerEvent };
|
|
20
|
+
//# sourceMappingURL=serverTrack.d.ts.map
|
|
@@ -0,0 +1,109 @@
|
|
|
1
|
+
import { getRuntime } from "../../plugin/runtime.js";
|
|
2
|
+
import { AnalyticsTrackError } from "../../core/serverEvent.js";
|
|
3
|
+
import { SERVER_USER_AGENT } from "./device.js";
|
|
4
|
+
import { flushBatch } from "./flushBatch.js";
|
|
5
|
+
import { normalizeEvent } from "./normalizeEvent.js";
|
|
6
|
+
import { dailySalt } from "./salt.js";
|
|
7
|
+
import { rawEventError } from "./validate.js";
|
|
8
|
+
import { createLocalReq } from "payload";
|
|
9
|
+
//#region src/native/ingest/serverTrack.ts
|
|
10
|
+
/**
|
|
11
|
+
* The originating request's own headers, so a server event attributes exactly like the
|
|
12
|
+
* browser event it stands in for: the platform's geo headers reach the geo resolver and the
|
|
13
|
+
* visitor hashes to the same person. Explicit `ip` / `userAgent` overlay them.
|
|
14
|
+
*
|
|
15
|
+
* With no request and no user agent the synthetic server agent stands in, which hashes every
|
|
16
|
+
* such event in a day to one visitor per site and reports no device at all.
|
|
17
|
+
*/
|
|
18
|
+
const attributionHeaders = (event, req) => {
|
|
19
|
+
const headers = new Headers(req?.headers);
|
|
20
|
+
if (event.ip) headers.set("x-forwarded-for", event.ip);
|
|
21
|
+
if (event.userAgent) headers.set("user-agent", event.userAgent);
|
|
22
|
+
if (!headers.get("user-agent")) headers.set("user-agent", SERVER_USER_AGENT);
|
|
23
|
+
return headers;
|
|
24
|
+
};
|
|
25
|
+
const resolveScope = async (event, opts, resolvers) => {
|
|
26
|
+
if (!resolvers.scope) return;
|
|
27
|
+
if (event.scope !== void 0) return event.scope ?? "";
|
|
28
|
+
if (!opts?.req) return "";
|
|
29
|
+
return await resolvers.scope(opts.req) ?? "";
|
|
30
|
+
};
|
|
31
|
+
/**
|
|
32
|
+
* The native adapter's server-side ingestion, exposed as `adapter.ingest.track`. Same
|
|
33
|
+
* normalization, goal matching and write path the HTTP endpoint uses; only attribution and
|
|
34
|
+
* scope resolution differ, since there may be no request behind the event at all.
|
|
35
|
+
*/
|
|
36
|
+
const makeServerTrack = (deps) => async (event, opts) => {
|
|
37
|
+
const payload = deps.getPayload();
|
|
38
|
+
if (!payload) throw new AnalyticsTrackError("analytics: trackServerEvent called before init");
|
|
39
|
+
const invalid = rawEventError(event, { requireHostname: true });
|
|
40
|
+
if (invalid) throw new AnalyticsTrackError(`analytics: trackServerEvent needs a valid "${invalid}"`);
|
|
41
|
+
const resolvers = deps.getResolvers();
|
|
42
|
+
const scope = await resolveScope(event, opts, resolvers);
|
|
43
|
+
let local;
|
|
44
|
+
const requestFor = async () => {
|
|
45
|
+
if (opts?.req) return opts.req;
|
|
46
|
+
local ??= await createLocalReq({}, payload);
|
|
47
|
+
return local;
|
|
48
|
+
};
|
|
49
|
+
const timezone = event.timezone ?? (resolvers.timezone ? await resolvers.timezone(await requestFor(), scope ?? null) : void 0);
|
|
50
|
+
const goals = resolvers.goals ? await resolvers.goals(await requestFor(), scope ?? null) : void 0;
|
|
51
|
+
const now = event.now ?? /* @__PURE__ */ new Date();
|
|
52
|
+
const stored = await normalizeEvent({
|
|
53
|
+
raw: {
|
|
54
|
+
type: event.type,
|
|
55
|
+
name: event.name,
|
|
56
|
+
path: event.path,
|
|
57
|
+
referrer: event.referrer,
|
|
58
|
+
query: event.query,
|
|
59
|
+
props: event.props,
|
|
60
|
+
value: event.value,
|
|
61
|
+
currency: event.currency
|
|
62
|
+
},
|
|
63
|
+
hostname: event.hostname,
|
|
64
|
+
headers: attributionHeaders(event, opts?.req),
|
|
65
|
+
geoResolver: deps.geoResolver,
|
|
66
|
+
salt: await dailySalt(payload, now),
|
|
67
|
+
now,
|
|
68
|
+
scope,
|
|
69
|
+
timezone,
|
|
70
|
+
goals,
|
|
71
|
+
trustedProxyHops: deps.getAttribution().trustedProxyHops
|
|
72
|
+
});
|
|
73
|
+
const buffer = deps.getBuffer();
|
|
74
|
+
if (!buffer) {
|
|
75
|
+
await flushBatch(payload, [stored]);
|
|
76
|
+
return;
|
|
77
|
+
}
|
|
78
|
+
buffer.add(stored);
|
|
79
|
+
if (opts?.flush) await buffer.flush();
|
|
80
|
+
};
|
|
81
|
+
/**
|
|
82
|
+
* The adapter {@link trackServerEvent} writes through: the first registered one with a server
|
|
83
|
+
* ingestion seam. Every caller that needs a second seam beside `track` (the hostname policy a
|
|
84
|
+
* goal action applies) reads it off this same adapter, so an event cannot be judged by one
|
|
85
|
+
* adapter and written by another. The registry here is the static config one, so a per-tenant
|
|
86
|
+
* runtime provider never supplies either seam.
|
|
87
|
+
*/
|
|
88
|
+
const ingestAdapter = (payload) => getRuntime(payload)?.registry.all().find((adapter) => adapter.ingest?.track);
|
|
89
|
+
/**
|
|
90
|
+
* Records an analytics event from server code: a webhook, a job, a server action. The event
|
|
91
|
+
* goes through the same normalization, sanitization and goal matching a browser event does.
|
|
92
|
+
* Pass `opts.req` whenever there is a request behind the event, so it inherits that request's
|
|
93
|
+
* attribution, scope and reporting timezone.
|
|
94
|
+
*
|
|
95
|
+
* `event.scope` overrides the request's scope; it is ignored on an unscoped install and is
|
|
96
|
+
* never checked against the scopes that exist, so the caller owns what it stamps.
|
|
97
|
+
*
|
|
98
|
+
* Needs the native adapter: a provider slot (Plausible, GA4) has no server ingestion seam
|
|
99
|
+
* here yet, so an install without the native adapter throws rather than dropping the event.
|
|
100
|
+
*/
|
|
101
|
+
const trackServerEvent = async (payload, event, opts) => {
|
|
102
|
+
const track = ingestAdapter(payload)?.ingest?.track;
|
|
103
|
+
if (!track) throw new AnalyticsTrackError("analytics: trackServerEvent needs the native adapter; provider-slot server tracking is not supported yet");
|
|
104
|
+
await track(event, opts);
|
|
105
|
+
};
|
|
106
|
+
//#endregion
|
|
107
|
+
export { ingestAdapter, makeServerTrack, trackServerEvent };
|
|
108
|
+
|
|
109
|
+
//# sourceMappingURL=serverTrack.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"serverTrack.js","names":[],"sources":["../../../src/native/ingest/serverTrack.ts"],"sourcesContent":["import { createLocalReq, type Payload, type PayloadRequest } from 'payload'\nimport type { AnalyticsAdapter } from '../../core/contract'\nimport {\n\tAnalyticsTrackError,\n\ttype ServerEventInput,\n\ttype ServerTrack,\n\ttype ServerTrackOptions,\n} from '../../core/serverEvent'\nimport { getRuntime } from '../../plugin/runtime'\nimport type { GeoResolver } from '../geo/geoResolver'\nimport { SERVER_USER_AGENT } from './device'\nimport type { IngestAttribution, IngestResolvers } from './endpoint'\nimport { flushBatch } from './flushBatch'\nimport { normalizeEvent, type StoredEvent } from './normalizeEvent'\nimport { dailySalt } from './salt'\nimport { rawEventError } from './validate'\nimport type { WriteBuffer } from './writeBuffer'\n\nexport interface ServerTrackDeps {\n\t/** Null until the adapter's onInit has run. */\n\tgetPayload: () => Payload | null\n\tgeoResolver: GeoResolver\n\tgetBuffer: () => WriteBuffer<StoredEvent> | null\n\t/** Read late: the register context that carries them arrives after the adapter is built. */\n\tgetResolvers: () => IngestResolvers\n\t/** Read late for the same reason: the plugin option arrives with the register context. */\n\tgetAttribution: () => IngestAttribution\n}\n\n/**\n * The originating request's own headers, so a server event attributes exactly like the\n * browser event it stands in for: the platform's geo headers reach the geo resolver and the\n * visitor hashes to the same person. Explicit `ip` / `userAgent` overlay them.\n *\n * With no request and no user agent the synthetic server agent stands in, which hashes every\n * such event in a day to one visitor per site and reports no device at all.\n */\nconst attributionHeaders = (event: ServerEventInput, req?: PayloadRequest): Headers => {\n\tconst headers = new Headers(req?.headers)\n\tif (event.ip) {\n\t\theaders.set('x-forwarded-for', event.ip)\n\t}\n\tif (event.userAgent) {\n\t\theaders.set('user-agent', event.userAgent)\n\t}\n\tif (!headers.get('user-agent')) {\n\t\theaders.set('user-agent', SERVER_USER_AGENT)\n\t}\n\treturn headers\n}\n\nconst resolveScope = async (\n\tevent: ServerEventInput,\n\topts: ServerTrackOptions | undefined,\n\tresolvers: IngestResolvers\n): Promise<string | undefined> => {\n\t// An unscoped install has no scope resolver and no scope field on its rows, so a scope\n\t// declared by the caller is ignored exactly as the endpoint ignores one on the wire.\n\tif (!resolvers.scope) {\n\t\treturn undefined\n\t}\n\tif (event.scope !== undefined) {\n\t\treturn event.scope ?? ''\n\t}\n\tif (!opts?.req) {\n\t\treturn ''\n\t}\n\treturn (await resolvers.scope(opts.req)) ?? ''\n}\n\n/**\n * The native adapter's server-side ingestion, exposed as `adapter.ingest.track`. Same\n * normalization, goal matching and write path the HTTP endpoint uses; only attribution and\n * scope resolution differ, since there may be no request behind the event at all.\n */\nexport const makeServerTrack =\n\t(deps: ServerTrackDeps): ServerTrack =>\n\tasync (event, opts) => {\n\t\tconst payload = deps.getPayload()\n\t\tif (!payload) {\n\t\t\tthrow new AnalyticsTrackError('analytics: trackServerEvent called before init')\n\t\t}\n\t\t// Trusted server code: it supplies its own hostname, so the resolver the HTTP endpoint\n\t\t// runs is bypassed and the hostname stays required here.\n\t\tconst invalid = rawEventError(event, { requireHostname: true })\n\t\tif (invalid) {\n\t\t\tthrow new AnalyticsTrackError(`analytics: trackServerEvent needs a valid \"${invalid}\"`)\n\t\t}\n\t\tconst resolvers = deps.getResolvers()\n\t\tconst scope = await resolveScope(event, opts, resolvers)\n\t\t// createLocalReq mutates the request it is given, so a caller's own req is passed\n\t\t// through untouched and a fresh one is built only when a resolver needs it.\n\t\tlet local: PayloadRequest | undefined\n\t\tconst requestFor = async (): Promise<PayloadRequest> => {\n\t\t\tif (opts?.req) {\n\t\t\t\treturn opts.req\n\t\t\t}\n\t\t\tlocal ??= await createLocalReq({}, payload)\n\t\t\treturn local\n\t\t}\n\t\tconst timezone =\n\t\t\tevent.timezone ??\n\t\t\t(resolvers.timezone ? await resolvers.timezone(await requestFor(), scope ?? null) : undefined)\n\t\t// Goals resolve under the scope the event is stamped with, so a tenant's server event\n\t\t// can only ever complete that tenant's goals.\n\t\tconst goals = resolvers.goals\n\t\t\t? await resolvers.goals(await requestFor(), scope ?? null)\n\t\t\t: undefined\n\t\tconst now = event.now ?? new Date()\n\t\tconst stored = await normalizeEvent({\n\t\t\traw: {\n\t\t\t\ttype: event.type,\n\t\t\t\tname: event.name,\n\t\t\t\tpath: event.path,\n\t\t\t\treferrer: event.referrer,\n\t\t\t\tquery: event.query,\n\t\t\t\tprops: event.props,\n\t\t\t\tvalue: event.value,\n\t\t\t\tcurrency: event.currency,\n\t\t\t},\n\t\t\thostname: event.hostname,\n\t\t\theaders: attributionHeaders(event, opts?.req),\n\t\t\tgeoResolver: deps.geoResolver,\n\t\t\tsalt: await dailySalt(payload, now),\n\t\t\tnow,\n\t\t\tscope,\n\t\t\ttimezone,\n\t\t\tgoals,\n\t\t\ttrustedProxyHops: deps.getAttribution().trustedProxyHops,\n\t\t})\n\t\tconst buffer = deps.getBuffer()\n\t\tif (!buffer) {\n\t\t\tawait flushBatch(payload, [stored])\n\t\t\treturn\n\t\t}\n\t\tbuffer.add(stored)\n\t\tif (opts?.flush) {\n\t\t\tawait buffer.flush()\n\t\t}\n\t}\n\n/**\n * The adapter {@link trackServerEvent} writes through: the first registered one with a server\n * ingestion seam. Every caller that needs a second seam beside `track` (the hostname policy a\n * goal action applies) reads it off this same adapter, so an event cannot be judged by one\n * adapter and written by another. The registry here is the static config one, so a per-tenant\n * runtime provider never supplies either seam.\n */\nexport const ingestAdapter = (payload: Payload): AnalyticsAdapter | undefined =>\n\tgetRuntime(payload)\n\t\t?.registry.all()\n\t\t.find((adapter) => adapter.ingest?.track)\n\n/**\n * Records an analytics event from server code: a webhook, a job, a server action. The event\n * goes through the same normalization, sanitization and goal matching a browser event does.\n * Pass `opts.req` whenever there is a request behind the event, so it inherits that request's\n * attribution, scope and reporting timezone.\n *\n * `event.scope` overrides the request's scope; it is ignored on an unscoped install and is\n * never checked against the scopes that exist, so the caller owns what it stamps.\n *\n * Needs the native adapter: a provider slot (Plausible, GA4) has no server ingestion seam\n * here yet, so an install without the native adapter throws rather than dropping the event.\n */\nexport const trackServerEvent = async (\n\tpayload: Payload,\n\tevent: ServerEventInput,\n\topts?: ServerTrackOptions\n): Promise<void> => {\n\tconst track = ingestAdapter(payload)?.ingest?.track\n\tif (!track) {\n\t\tthrow new AnalyticsTrackError(\n\t\t\t'analytics: trackServerEvent needs the native adapter; provider-slot server tracking is not supported yet'\n\t\t)\n\t}\n\tawait track(event, opts)\n}\n"],"mappings":";;;;;;;;;;;;;;;;;AAqCA,MAAM,sBAAsB,OAAyB,QAAkC;CACtF,MAAM,UAAU,IAAI,QAAQ,KAAK,OAAO;CACxC,IAAI,MAAM,IACT,QAAQ,IAAI,mBAAmB,MAAM,EAAE;CAExC,IAAI,MAAM,WACT,QAAQ,IAAI,cAAc,MAAM,SAAS;CAE1C,IAAI,CAAC,QAAQ,IAAI,YAAY,GAC5B,QAAQ,IAAI,cAAc,iBAAiB;CAE5C,OAAO;AACR;AAEA,MAAM,eAAe,OACpB,OACA,MACA,cACiC;CAGjC,IAAI,CAAC,UAAU,OACd;CAED,IAAI,MAAM,UAAU,KAAA,GACnB,OAAO,MAAM,SAAS;CAEvB,IAAI,CAAC,MAAM,KACV,OAAO;CAER,OAAQ,MAAM,UAAU,MAAM,KAAK,GAAG,KAAM;AAC7C;;;;;;AAOA,MAAa,mBACX,SACD,OAAO,OAAO,SAAS;CACtB,MAAM,UAAU,KAAK,WAAW;CAChC,IAAI,CAAC,SACJ,MAAM,IAAI,oBAAoB,gDAAgD;CAI/E,MAAM,UAAU,cAAc,OAAO,EAAE,iBAAiB,KAAK,CAAC;CAC9D,IAAI,SACH,MAAM,IAAI,oBAAoB,8CAA8C,QAAQ,EAAE;CAEvF,MAAM,YAAY,KAAK,aAAa;CACpC,MAAM,QAAQ,MAAM,aAAa,OAAO,MAAM,SAAS;CAGvD,IAAI;CACJ,MAAM,aAAa,YAAqC;EACvD,IAAI,MAAM,KACT,OAAO,KAAK;EAEb,UAAU,MAAM,eAAe,CAAC,GAAG,OAAO;EAC1C,OAAO;CACR;CACA,MAAM,WACL,MAAM,aACL,UAAU,WAAW,MAAM,UAAU,SAAS,MAAM,WAAW,GAAG,SAAS,IAAI,IAAI,KAAA;CAGrF,MAAM,QAAQ,UAAU,QACrB,MAAM,UAAU,MAAM,MAAM,WAAW,GAAG,SAAS,IAAI,IACvD,KAAA;CACH,MAAM,MAAM,MAAM,uBAAO,IAAI,KAAK;CAClC,MAAM,SAAS,MAAM,eAAe;EACnC,KAAK;GACJ,MAAM,MAAM;GACZ,MAAM,MAAM;GACZ,MAAM,MAAM;GACZ,UAAU,MAAM;GAChB,OAAO,MAAM;GACb,OAAO,MAAM;GACb,OAAO,MAAM;GACb,UAAU,MAAM;EACjB;EACA,UAAU,MAAM;EAChB,SAAS,mBAAmB,OAAO,MAAM,GAAG;EAC5C,aAAa,KAAK;EAClB,MAAM,MAAM,UAAU,SAAS,GAAG;EAClC;EACA;EACA;EACA;EACA,kBAAkB,KAAK,eAAe,EAAE;CACzC,CAAC;CACD,MAAM,SAAS,KAAK,UAAU;CAC9B,IAAI,CAAC,QAAQ;EACZ,MAAM,WAAW,SAAS,CAAC,MAAM,CAAC;EAClC;CACD;CACA,OAAO,IAAI,MAAM;CACjB,IAAI,MAAM,OACT,MAAM,OAAO,MAAM;AAErB;;;;;;;;AASD,MAAa,iBAAiB,YAC7B,WAAW,OAAO,GACf,SAAS,IAAI,EACd,MAAM,YAAY,QAAQ,QAAQ,KAAK;;;;;;;;;;;;;AAc1C,MAAa,mBAAmB,OAC/B,SACA,OACA,SACmB;CACnB,MAAM,QAAQ,cAAc,OAAO,GAAG,QAAQ;CAC9C,IAAI,CAAC,OACJ,MAAM,IAAI,oBACT,0GACD;CAED,MAAM,MAAM,OAAO,IAAI;AACxB"}
|
|
@@ -0,0 +1,11 @@
|
|
|
1
|
+
//#region src/native/ingest/source.d.ts
|
|
2
|
+
/**
|
|
3
|
+
* Every acquisition channel the `channel` dimension can hold, lowercase as they are stored.
|
|
4
|
+
* Paid is split per platform rather than pooled, because that is the split every vendor
|
|
5
|
+
* reports and the one a budget question is actually asked in.
|
|
6
|
+
*/
|
|
7
|
+
declare const TRAFFIC_CHANNELS: readonly ["direct", "organic-search", "paid-search", "organic-social", "paid-social", "organic-video", "paid-video", "email", "affiliate", "display", "referral", "paid-other"];
|
|
8
|
+
type TrafficChannel = (typeof TRAFFIC_CHANNELS)[number];
|
|
9
|
+
//#endregion
|
|
10
|
+
export { TRAFFIC_CHANNELS, TrafficChannel };
|
|
11
|
+
//# sourceMappingURL=source.d.ts.map
|